@authhero/multi-tenancy 13.17.0 → 13.18.0

package/README.md

@@ -9,15 +9,19 @@ Multi-tenancy support for AuthHero with organization-based access control, per-t
 - ⚙️ **Settings Inheritance** - Inherit configuration from main tenant to child tenants
 - 🌐 **Subdomain Routing** - Automatic subdomain-to-tenant resolution
 - 🔄 **Tenant Lifecycle** - Automated provisioning and deprovisioning
-- 🪝 **Hooks Integration** - Seamless integration with AuthHero hooks system
-- 📡 **Resource Server Sync** - Automatically sync resource servers from main tenant to all child tenants
+- 🪝 **Composable Architecture** - Combine multi-tenancy features with the base AuthHero package
+- 📡 **Entity Sync** - Automatically sync resource servers, roles, and connections from control plane to all child tenants
 
 ## Installation
 
 ```bash
-pnpm add @authhero/multi-tenancy
+pnpm add authhero @authhero/multi-tenancy
 ```
 
+::: tip Peer Dependency
+`@authhero/multi-tenancy` requires `authhero` as a peer dependency. Both packages must be installed.
+:::
+
 ## Documentation
 
 📚 **Full documentation**: [https://authhero.net/packages/multi-tenancy/](https://authhero.net/packages/multi-tenancy/)
@@ -29,33 +33,64 @@ pnpm add @authhero/multi-tenancy
 ## Quick Start
 
 ```typescript
-import { Hono } from "hono";
-import { createAuthhero } from "authhero";
-import { setupMultiTenancy } from "@authhero/multi-tenancy";
-
-const multiTenancy = setupMultiTenancy({
-  accessControl: {
-    controlPlaneTenantId: "control_plane",
-    defaultPermissions: ["tenant:admin"],
+import { init, AuthHeroConfig, fetchAll } from "authhero";
+import {
+  createSyncHooks,
+  createTenantsOpenAPIRouter,
+  createProtectSyncedMiddleware,
+} from "@authhero/multi-tenancy";
+import createAdapters from "@authhero/kysely-adapter";
+
+const CONTROL_PLANE_TENANT_ID = "control_plane";
+const dataAdapter = createAdapters(db);
+
+// Create sync hooks for syncing entities from control plane to child tenants
+const { entityHooks, tenantHooks } = createSyncHooks({
+  controlPlaneTenantId: CONTROL_PLANE_TENANT_ID,
+  getChildTenantIds: async () => {
+    const allTenants = await fetchAll(
+      (params) => dataAdapter.tenants.list(params),
+      "tenants",
+      { cursorField: "id", pageSize: 100 }
+    );
+    return allTenants
+      .filter((t) => t.id !== CONTROL_PLANE_TENANT_ID)
+      .map((t) => t.id);
+  },
+  getAdapters: async () => dataAdapter,
+  getControlPlaneAdapters: async () => dataAdapter,
+  sync: {
+    resourceServers: true,
+    roles: true,
+    connections: true,
   },
 });
 
-const app = new Hono();
+// Create tenants router
+const tenantsRouter = createTenantsOpenAPIRouter(
+  {
+    accessControl: {
+      controlPlaneTenantId: CONTROL_PLANE_TENANT_ID,
+      requireOrganizationMatch: false,
+      defaultPermissions: ["tenant:admin"],
+    },
+  },
+  { tenants: tenantHooks }
+);
 
-// Apply middleware
-app.use("*", multiTenancy.middleware);
+// Initialize AuthHero with sync hooks and tenant routes
+const { app } = init({
+  dataAdapter,
+  entityHooks,
+  managementApiExtensions: [
+    { path: "/tenants", router: tenantsRouter },
+  ],
+});
 
-// Mount management routes
-app.route("/management", multiTenancy.app);
+// Add middleware to protect synced entities
+app.use("/api/v2/*", createProtectSyncedMiddleware());
 
-// Mount AuthHero with hooks
-app.route(
-  "/",
-  createAuthhero({
-    dataAdapter: env.data,
-    hooks: multiTenancy.hooks,
-  }),
-);
+export default app;
 ```
 
 ## Key Concepts

package/package.json

@@ -11,7 +11,7 @@
     "type": "git",
     "url": "https://github.com/markusahlstrand/authhero"
   },
-  "version": "13.17.0",
+  "version": "13.18.0",
   "description": "Multi-tenancy support for AuthHero with organization-based access control and per-tenant database isolation",
   "files": [
     "dist"