@happyvertical/smrt-tenancy 0.30.0

package/dist/svelte/playground.d.ts

@@ -0,0 +1,70 @@
+declare const _default: {
+    packageName: string;
+    displayName: string;
+    description: string | undefined;
+    moduleMeta: import("@happyvertical/smrt-types").SmrtModuleMeta;
+    entries: ({
+        id: string;
+        title: string;
+        description: string;
+        loadComponent: () => Promise<typeof import("./components/TenantCard.svelte")>;
+        order: number;
+        props: {
+            tenant: {
+                id: string;
+                name: string;
+                slug: string;
+                status: string;
+            };
+            memberCount: number;
+            selected: boolean;
+            actions: boolean;
+            onclick: () => void;
+            onedit: () => void;
+            ondelete: () => void;
+            memberships?: undefined;
+            tenants?: undefined;
+            currentTenantId?: undefined;
+            onchange?: undefined;
+        };
+        modes: {
+            mock: {
+                label: string;
+            };
+        };
+    } | {
+        id: string;
+        title: string;
+        description: string;
+        loadComponent: () => Promise<typeof import("./components/TenantSwitcher.svelte")>;
+        order: number;
+        props: {
+            memberships: {
+                id: string;
+                tenantId: string;
+            }[];
+            tenants: Map<string, {
+                id: string;
+                name: string;
+                slug: string;
+                status: string;
+            }>;
+            currentTenantId: string;
+            onchange: () => void;
+            tenant?: undefined;
+            memberCount?: undefined;
+            selected?: undefined;
+            actions?: undefined;
+            onclick?: undefined;
+            onedit?: undefined;
+            ondelete?: undefined;
+        };
+        modes: {
+            mock: {
+                label: string;
+            };
+        };
+    })[];
+};
+export default _default;
+//# sourceMappingURL=playground.d.ts.map

package/dist/svelte/playground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../../src/svelte/playground.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,wBAgDE"}

package/dist/svelte/playground.js

@@ -0,0 +1,75 @@
+import { TENANCY_MODULE_META } from '../ui.js';
+const noop = () => { };
+const sampleTenants = [
+    {
+        id: 'tenant-riverstone',
+        name: 'Riverstone Newsroom',
+        slug: 'riverstone-newsroom',
+        status: 'active',
+    },
+    {
+        id: 'tenant-harbor',
+        name: 'Harbor Labs',
+        slug: 'harbor-labs',
+        status: 'suspended',
+    },
+];
+const sampleMemberships = [
+    {
+        id: 'membership-riverstone',
+        tenantId: 'tenant-riverstone',
+    },
+    {
+        id: 'membership-harbor',
+        tenantId: 'tenant-harbor',
+    },
+];
+const loadTenantCard = () => import('./components/TenantCard.svelte');
+const loadTenantSwitcher = () => import('./components/TenantSwitcher.svelte');
+export default {
+    packageName: '@happyvertical/smrt-tenancy',
+    displayName: TENANCY_MODULE_META.displayName,
+    description: TENANCY_MODULE_META.description,
+    moduleMeta: TENANCY_MODULE_META,
+    entries: [
+        {
+            id: 'tenant-card',
+            title: 'Tenant Card',
+            description: 'Tenant identity and status card with optional membership count and actions.',
+            loadComponent: loadTenantCard,
+            order: 1,
+            props: {
+                tenant: sampleTenants[0],
+                memberCount: 18,
+                selected: true,
+                actions: true,
+                onclick: noop,
+                onedit: noop,
+                ondelete: noop,
+            },
+            modes: {
+                mock: {
+                    label: 'Mock',
+                },
+            },
+        },
+        {
+            id: 'tenant-switcher',
+            title: 'Tenant Switcher',
+            description: 'Membership-aware tenant selector used for multi-tenant application shells.',
+            loadComponent: loadTenantSwitcher,
+            order: 2,
+            props: {
+                memberships: sampleMemberships,
+                tenants: new Map(sampleTenants.map((tenant) => [tenant.id, tenant])),
+                currentTenantId: 'tenant-riverstone',
+                onchange: noop,
+            },
+            modes: {
+                mock: {
+                    label: 'Mock',
+                },
+            },
+        },
+    ],
+};

package/dist/testing.d.ts

@@ -0,0 +1,145 @@
+import { MinimalTenantContext, TenantContextData } from './context.js';
+/**
+ * Reset all tenancy state (for use in beforeEach/afterEach)
+ *
+ * This clears:
+ * - Registered interceptors
+ * - Tenant-scoped class registry
+ *
+ * @example
+ * ```typescript
+ * afterEach(() => {
+ *   resetTenancy();
+ * });
+ * ```
+ */
+export declare function resetTenancy(): void;
+/**
+ * Create a test tenant context and run code within it
+ *
+ * Convenience wrapper around withTenant() with sensible defaults for testing.
+ *
+ * @param context - Tenant context (can be minimal, just tenantId)
+ * @param fn - Async function to run in the context
+ *
+ * @example
+ * ```typescript
+ * await createTestTenantContext({ tenantId: 'test-tenant' }, async () => {
+ *   const product = await collection.create({ name: 'Test' });
+ *   expect(product.tenantId).toBe('test-tenant');
+ * });
+ * ```
+ */
+export declare function createTestTenantContext<T>(context: MinimalTenantContext | TenantContextData, fn: () => Promise<T>): Promise<T>;
+/**
+ * Create multiple tenant contexts for isolation testing
+ *
+ * @param tenantIds - Array of tenant IDs to create contexts for
+ * @param fn - Function that receives an object mapping tenant IDs to context runners
+ *
+ * @example
+ * ```typescript
+ * await testTenantIsolation(['tenant-a', 'tenant-b'], async (tenants) => {
+ *   // Create in tenant A
+ *   const docA = await tenants['tenant-a'](async () => {
+ *     return collection.create({ title: 'A doc' });
+ *   });
+ *
+ *   // Verify not visible in tenant B
+ *   await tenants['tenant-b'](async () => {
+ *     const found = await collection.get(docA.id);
+ *     expect(found).toBeNull();
+ *   });
+ * });
+ * ```
+ */
+export declare function testTenantIsolation<T>(tenantIds: string[], fn: (tenants: Record<string, <R>(runner: () => Promise<R>) => Promise<R>>) => Promise<T>): Promise<T>;
+/**
+ * Options for `setupTestTenancy()`.
+ *
+ * @see setupTestTenancy
+ */
+export interface SetupTestTenancyOptions {
+    /**
+     * Enable tenancy interceptors
+     * @default true
+     */
+    enableInterceptors?: boolean;
+    /**
+     * Raw query policy for tests
+     * @default 'throw'
+     */
+    rawQueryPolicy?: 'throw' | 'warn' | 'allow';
+}
+/**
+ * Set up tenancy for a test suite
+ *
+ * Call in beforeAll or at the start of tests to configure tenancy.
+ *
+ * @param options - Setup options
+ *
+ * @example
+ * ```typescript
+ * beforeAll(() => {
+ *   setupTestTenancy({ enableInterceptors: true });
+ * });
+ *
+ * afterAll(() => {
+ *   resetTenancy();
+ * });
+ * ```
+ */
+export declare function setupTestTenancy(options?: SetupTestTenancyOptions): void;
+/**
+ * Assert that executing `fn` throws a `TenantContextError`.
+ *
+ * Fails with a descriptive message if `fn` completes without throwing, or if
+ * it throws a different error type.  Optionally verifies that the error message
+ * contains a specific substring.
+ *
+ * Useful for testing that business-logic code correctly rejects calls that are
+ * made outside a tenant context.
+ *
+ * @param fn - Async function that should throw `TenantContextError`.
+ * @param messageContains - Optional substring the error message must include.
+ *
+ * @example
+ * ```typescript
+ * await assertTenantContextRequired(async () => {
+ *   // No withTenant() in scope
+ *   await documentCollection.list({});
+ * });
+ * ```
+ *
+ * @see assertTenantIsolationViolation
+ * @see TenantContextError
+ */
+export declare function assertTenantContextRequired(fn: () => Promise<unknown>, messageContains?: string): Promise<void>;
+/**
+ * Assert that executing `fn` throws a `TenantIsolationError`.
+ *
+ * Fails with a descriptive message if `fn` completes without throwing, or if
+ * it throws a different error type.  Optionally verifies that the error message
+ * contains a specific substring.
+ *
+ * Use this to verify that cross-tenant data access attempts are correctly
+ * blocked by the interceptor.
+ *
+ * @param fn - Async function that should throw `TenantIsolationError`.
+ * @param messageContains - Optional substring the error message must include.
+ *
+ * @example
+ * ```typescript
+ * await withTenant({ tenantId: 'tenant-a' }, async () => {
+ *   await assertTenantIsolationViolation(async () => {
+ *     // Attempt to filter by a different tenant
+ *     await collection.list({ where: { tenantId: 'tenant-b' } });
+ *   });
+ * });
+ * ```
+ *
+ * @see assertTenantContextRequired
+ * @see TenantIsolationError
+ */
+export declare function assertTenantIsolationViolation(fn: () => Promise<unknown>, messageContains?: string): Promise<void>;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EAEvB,MAAM,cAAc,CAAC;AAItB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,OAAO,EAAE,oBAAoB,GAAG,iBAAiB,EACjD,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,SAAS,EAAE,MAAM,EAAE,EACnB,EAAE,EAAE,CACF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KACjE,OAAO,CAAC,CAAC,CAAC,GACd,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,IAAI,CAU5E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,2BAA2B,CAC/C,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC1B,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,8BAA8B,CAClD,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC1B,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/testing.js

@@ -0,0 +1,11 @@
+import "./chunks/context-B5CKsmMi.js";
+import { a, b, e, l, s, t } from "./chunks/testing-C_tV23JW.js";
+export {
+  a as assertTenantContextRequired,
+  b as assertTenantIsolationViolation,
+  e as createTestTenantContext,
+  l as resetTenancy,
+  s as setupTestTenancy,
+  t as testTenantIsolation
+};
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/ui.d.ts

@@ -0,0 +1,21 @@
+import { ModuleUISlot, SmrtModuleMeta } from '@happyvertical/smrt-types';
+/**
+ * UI slot definitions for the tenancy module.
+ *
+ * Keyed by slot ID.  Each entry describes a named extension point where a
+ * host application can render a tenancy UI component (e.g., tenant card,
+ * tenant switcher).  Components are implemented in the `./svelte` subpath.
+ *
+ * @see TENANCY_MODULE_META
+ */
+export declare const TENANCY_UI_SLOTS: Record<string, ModuleUISlot>;
+/**
+ * Module metadata for `@happyvertical/smrt-tenancy`.
+ *
+ * Consumed by the SMRT module system to register this package's display name,
+ * description, data models, collections, and UI slots with the host application.
+ *
+ * @see TENANCY_UI_SLOTS
+ */
+export declare const TENANCY_MODULE_META: SmrtModuleMeta;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE9E;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAmBzD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,cAOjC,CAAC"}

package/dist/ui.js

@@ -0,0 +1,33 @@
+const TENANCY_UI_SLOTS = {
+  "tenant-card": {
+    id: "tenant-card",
+    label: "Tenant Card",
+    description: "Tenant information and management card",
+    icon: "building",
+    category: "display",
+    order: 1,
+    propsInterface: "TenantCardProps"
+  },
+  "tenant-switcher": {
+    id: "tenant-switcher",
+    label: "Tenant Switcher",
+    description: "Dropdown for switching between tenants",
+    icon: "switch",
+    category: "form",
+    order: 2,
+    propsInterface: "TenantSwitcherProps"
+  }
+};
+const TENANCY_MODULE_META = {
+  name: "@happyvertical/smrt-tenancy",
+  displayName: "Tenancy",
+  description: "Multi-tenancy framework with automatic tenant isolation",
+  uiSlots: TENANCY_UI_SLOTS,
+  models: ["Tenant", "TenantContext"],
+  collections: ["TenantCollection"]
+};
+export {
+  TENANCY_MODULE_META,
+  TENANCY_UI_SLOTS
+};
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sources":["../src/ui.ts"],"sourcesContent":["/**\n * Tenancy Module UI Slot Declarations\n *\n * This file defines the UI extension points for the tenancy module.\n * UI components are implemented in the ./svelte subpath.\n */\n\nimport type { ModuleUISlot, SmrtModuleMeta } from '@happyvertical/smrt-types';\n\n/**\n * UI slot definitions for the tenancy module.\n *\n * Keyed by slot ID.  Each entry describes a named extension point where a\n * host application can render a tenancy UI component (e.g., tenant card,\n * tenant switcher).  Components are implemented in the `./svelte` subpath.\n *\n * @see TENANCY_MODULE_META\n */\nexport const TENANCY_UI_SLOTS: Record<string, ModuleUISlot> = {\n  'tenant-card': {\n    id: 'tenant-card',\n    label: 'Tenant Card',\n    description: 'Tenant information and management card',\n    icon: 'building',\n    category: 'display',\n    order: 1,\n    propsInterface: 'TenantCardProps',\n  },\n  'tenant-switcher': {\n    id: 'tenant-switcher',\n    label: 'Tenant Switcher',\n    description: 'Dropdown for switching between tenants',\n    icon: 'switch',\n    category: 'form',\n    order: 2,\n    propsInterface: 'TenantSwitcherProps',\n  },\n};\n\n/**\n * Module metadata for `@happyvertical/smrt-tenancy`.\n *\n * Consumed by the SMRT module system to register this package's display name,\n * description, data models, collections, and UI slots with the host application.\n *\n * @see TENANCY_UI_SLOTS\n */\nexport const TENANCY_MODULE_META: SmrtModuleMeta = {\n  name: '@happyvertical/smrt-tenancy',\n  displayName: 'Tenancy',\n  description: 'Multi-tenancy framework with automatic tenant isolation',\n  uiSlots: TENANCY_UI_SLOTS,\n  models: ['Tenant', 'TenantContext'],\n  collections: ['TenantCollection'],\n};\n"],"names":[],"mappings":"AAkBO,MAAM,mBAAiD;AAAA,EAC5D,eAAe;AAAA,IACb,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,IACN,UAAU;AAAA,IACV,OAAO;AAAA,IACP,gBAAgB;AAAA,EAAA;AAAA,EAElB,mBAAmB;AAAA,IACjB,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,MAAM;AAAA,IACN,UAAU;AAAA,IACV,OAAO;AAAA,IACP,gBAAgB;AAAA,EAAA;AAEpB;AAUO,MAAM,sBAAsC;AAAA,EACjD,MAAM;AAAA,EACN,aAAa;AAAA,EACb,aAAa;AAAA,EACb,SAAS;AAAA,EACT,QAAQ,CAAC,UAAU,eAAe;AAAA,EAClC,aAAa,CAAC,kBAAkB;AAClC;"}

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@happyvertical/smrt-tenancy",
+  "version": "0.30.0",
+  "description": "Production-ready multi-tenancy framework for SMRT with automatic tenant isolation and enforcement",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "CLAUDE.md",
+    "AGENTS.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./adapters": {
+      "types": "./dist/adapters/index.d.ts",
+      "import": "./dist/adapters/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
+    },
+    "./ui": {
+      "types": "./dist/ui.d.ts",
+      "import": "./dist/ui.js"
+    },
+    "./manifest": "./dist/manifest.json",
+    "./manifest.json": "./dist/manifest.json",
+    "./playground": {
+      "types": "./dist/playground.d.ts",
+      "import": "./dist/playground.js"
+    },
+    "./svelte": {
+      "types": "./dist/svelte/index.d.ts",
+      "svelte": "./dist/svelte/index.js",
+      "import": "./dist/svelte/index.js"
+    }
+  },
+  "dependencies": {
+    "@happyvertical/logger": "^0.74.7",
+    "@happyvertical/sql": "^0.74.7",
+    "@happyvertical/utils": "^0.74.7",
+    "@happyvertical/smrt-core": "0.30.0",
+    "@happyvertical/smrt-types": "0.30.0",
+    "@happyvertical/smrt-ui": "0.30.0"
+  },
+  "peerDependencies": {
+    "svelte": "^5.46.4"
+  },
+  "peerDependenciesMeta": {
+    "svelte": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@sveltejs/package": "^2.5.7",
+    "@sveltejs/vite-plugin-svelte": "^6.2.4",
+    "@types/node": "25.0.9",
+    "svelte": "^5.46.4",
+    "svelte-check": "^4.3.5",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.17",
+    "@happyvertical/smrt-vitest": "0.30.0"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "multi-tenancy",
+    "tenancy",
+    "isolation",
+    "smrt"
+  ],
+  "author": "HappyVertical",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/smrt.git",
+    "directory": "packages/tenancy"
+  },
+  "scripts": {
+    "build": "vite build --mode library && svelte-package -i src/svelte -o dist/svelte --tsconfig tsconfig.svelte.json",
+    "build:watch": "vite build --mode library --watch",
+    "clean": "rm -rf dist",
+    "dev": "npm run build:watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "check": "pnpm exec svelte-check --tsconfig ./tsconfig.svelte.json",
+    "typecheck": "tsc --noEmit && node ../../scripts/svelte-check-a11y.mjs --tsconfig ./tsconfig.svelte.json",
+    "verify:pack": "node ../../scripts/verify-package-types-exports.js ."
+  }
+}