@node-tenant/tenant-core

Core engine for the @node-tenant/tenant multi-tenant platform.

🌐 Website: node-tenant.com

What's included

• TenantManager — full tenant lifecycle management
• TenantContextManager — AsyncLocalStorage-based tenant context
• TenantEventEmitter — typed event system
• PermissionEngine — read/write/admin/owner hierarchy
• Built-in resolvers: subdomainResolver, domainResolver, headerResolver, pathResolver, chainResolvers
• All TypeScript interfaces: Tenant, Organization, ResourceShare, StorageAdapter, DatabaseAdapter, TenantPlugin, etc.

Install

pnpm add @node-tenant/tenant-core

Quick usage

import { TenantManager } from '@node-tenant/tenant-core';
import { createPrismaStorage } from '@node-tenant/tenant-storage-prisma';

const manager = new TenantManager({ storage: createPrismaStorage(prisma) });

// Create
const tenant = await manager.createTenant({ name: 'Acme', slug: 'acme', strategy: 'tenantId', status: 'active', config: {} });

// Run code in tenant context
await manager.runAsTenant('acme', async () => {
  const ctx = manager.currentOrThrow(); // { id, slug, strategy, config }
});

See the root README for full documentation.