@sudobility/entity_service 1.0.1

package/dist/index.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * @fileoverview Entity Service Library
+ * @description Shared backend library for multi-tenant entity/organization management
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createEntityHelpers,
+ *   createEntityContextMiddleware,
+ *   entities,
+ *   entityMembers,
+ *   entityInvitations,
+ * } from '@shapeshyft/entity-service';
+ *
+ * // Create helpers with your database config
+ * const helpers = createEntityHelpers({
+ *   db: drizzleDb,
+ *   entitiesTable: mySchema.entities,
+ *   membersTable: mySchema.entityMembers,
+ *   invitationsTable: mySchema.entityInvitations,
+ *   usersTable: mySchema.users,
+ * });
+ *
+ * // Use in your routes
+ * const entity = await helpers.entity.getOrCreatePersonalEntity(userId, email);
+ * const members = await helpers.members.getMembers(entityId);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_PERMISSIONS = exports.InvitationStatus = exports.EntityRole = exports.EntityType = exports.rollbackEntityMigration = exports.runEntityMigration = exports.calculateInvitationExpiry = exports.validateSlug = exports.normalizeSlug = exports.generateInvitationToken = exports.generateEntitySlug = exports.createEntityHelpers = exports.createRequireRoleMiddleware = exports.createRequirePermissionMiddleware = exports.createEntityContextMiddleware = exports.PermissionHelper = exports.InvitationHelper = exports.EntityMemberHelper = exports.EntityHelper = exports.initEntityTables = exports.entityInvitations = exports.entityMembers = exports.entities = exports.createEntityInvitationsTablePublic = exports.createEntityInvitationsTable = exports.createEntityMembersTablePublic = exports.createEntityMembersTable = exports.createEntitiesTablePublic = exports.createEntitiesTable = void 0;
+// Schema exports
+var entities_1 = require("./schema/entities");
+// Table factory functions
+Object.defineProperty(exports, "createEntitiesTable", { enumerable: true, get: function () { return entities_1.createEntitiesTable; } });
+Object.defineProperty(exports, "createEntitiesTablePublic", { enumerable: true, get: function () { return entities_1.createEntitiesTablePublic; } });
+Object.defineProperty(exports, "createEntityMembersTable", { enumerable: true, get: function () { return entities_1.createEntityMembersTable; } });
+Object.defineProperty(exports, "createEntityMembersTablePublic", { enumerable: true, get: function () { return entities_1.createEntityMembersTablePublic; } });
+Object.defineProperty(exports, "createEntityInvitationsTable", { enumerable: true, get: function () { return entities_1.createEntityInvitationsTable; } });
+Object.defineProperty(exports, "createEntityInvitationsTablePublic", { enumerable: true, get: function () { return entities_1.createEntityInvitationsTablePublic; } });
+// Default tables (public schema)
+Object.defineProperty(exports, "entities", { enumerable: true, get: function () { return entities_1.entities; } });
+Object.defineProperty(exports, "entityMembers", { enumerable: true, get: function () { return entities_1.entityMembers; } });
+Object.defineProperty(exports, "entityInvitations", { enumerable: true, get: function () { return entities_1.entityInvitations; } });
+// Initialization
+Object.defineProperty(exports, "initEntityTables", { enumerable: true, get: function () { return entities_1.initEntityTables; } });
+// Helper exports
+var helpers_1 = require("./helpers");
+Object.defineProperty(exports, "EntityHelper", { enumerable: true, get: function () { return helpers_1.EntityHelper; } });
+Object.defineProperty(exports, "EntityMemberHelper", { enumerable: true, get: function () { return helpers_1.EntityMemberHelper; } });
+Object.defineProperty(exports, "InvitationHelper", { enumerable: true, get: function () { return helpers_1.InvitationHelper; } });
+Object.defineProperty(exports, "PermissionHelper", { enumerable: true, get: function () { return helpers_1.PermissionHelper; } });
+// Middleware exports
+var middleware_1 = require("./middleware");
+Object.defineProperty(exports, "createEntityContextMiddleware", { enumerable: true, get: function () { return middleware_1.createEntityContextMiddleware; } });
+Object.defineProperty(exports, "createRequirePermissionMiddleware", { enumerable: true, get: function () { return middleware_1.createRequirePermissionMiddleware; } });
+Object.defineProperty(exports, "createRequireRoleMiddleware", { enumerable: true, get: function () { return middleware_1.createRequireRoleMiddleware; } });
+Object.defineProperty(exports, "createEntityHelpers", { enumerable: true, get: function () { return middleware_1.createEntityHelpers; } });
+// Utility exports
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "generateEntitySlug", { enumerable: true, get: function () { return utils_1.generateEntitySlug; } });
+Object.defineProperty(exports, "generateInvitationToken", { enumerable: true, get: function () { return utils_1.generateInvitationToken; } });
+Object.defineProperty(exports, "normalizeSlug", { enumerable: true, get: function () { return utils_1.normalizeSlug; } });
+Object.defineProperty(exports, "validateSlug", { enumerable: true, get: function () { return utils_1.validateSlug; } });
+Object.defineProperty(exports, "calculateInvitationExpiry", { enumerable: true, get: function () { return utils_1.calculateInvitationExpiry; } });
+// Migration exports
+var migrations_1 = require("./migrations");
+Object.defineProperty(exports, "runEntityMigration", { enumerable: true, get: function () { return migrations_1.runEntityMigration; } });
+Object.defineProperty(exports, "rollbackEntityMigration", { enumerable: true, get: function () { return migrations_1.rollbackEntityMigration; } });
+// Type exports (re-exported from @sudobility/types)
+var types_1 = require("./types");
+Object.defineProperty(exports, "EntityType", { enumerable: true, get: function () { return types_1.EntityType; } });
+Object.defineProperty(exports, "EntityRole", { enumerable: true, get: function () { return types_1.EntityRole; } });
+Object.defineProperty(exports, "InvitationStatus", { enumerable: true, get: function () { return types_1.InvitationStatus; } });
+Object.defineProperty(exports, "ROLE_PERMISSIONS", { enumerable: true, get: function () { return types_1.ROLE_PERMISSIONS; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;AAEH,iBAAiB;AACjB,8CAqB2B;AApBzB,0BAA0B;AAC1B,+GAAA,mBAAmB,OAAA;AACnB,qHAAA,yBAAyB,OAAA;AACzB,oHAAA,wBAAwB,OAAA;AACxB,0HAAA,8BAA8B,OAAA;AAC9B,wHAAA,4BAA4B,OAAA;AAC5B,8HAAA,kCAAkC,OAAA;AAClC,iCAAiC;AACjC,oGAAA,QAAQ,OAAA;AACR,yGAAA,aAAa,OAAA;AACb,6GAAA,iBAAiB,OAAA;AAQjB,iBAAiB;AACjB,4GAAA,gBAAgB,OAAA;AAGlB,iBAAiB;AACjB,qCAKmB;AAJjB,uGAAA,YAAY,OAAA;AACZ,6GAAA,kBAAkB,OAAA;AAClB,2GAAA,gBAAgB,OAAA;AAChB,2GAAA,gBAAgB,OAAA;AAGlB,qBAAqB;AACrB,2CAOsB;AANpB,2HAAA,6BAA6B,OAAA;AAC7B,+HAAA,iCAAiC,OAAA;AACjC,yHAAA,2BAA2B,OAAA;AAC3B,iHAAA,mBAAmB,OAAA;AAKrB,kBAAkB;AAClB,iCAMiB;AALf,2GAAA,kBAAkB,OAAA;AAClB,gHAAA,uBAAuB,OAAA;AACvB,sGAAA,aAAa,OAAA;AACb,qGAAA,YAAY,OAAA;AACZ,kHAAA,yBAAyB,OAAA;AAG3B,oBAAoB;AACpB,2CAIsB;AAHpB,gHAAA,kBAAkB,OAAA;AAClB,qHAAA,uBAAuB,OAAA;AAIzB,oDAAoD;AACpD,iCAeiB;AAdf,mGAAA,UAAU,OAAA;AACV,mGAAA,UAAU,OAAA;AACV,yGAAA,gBAAgB,OAAA;AAChB,yGAAA,gBAAgB,OAAA"}

package/dist/middleware/hono.cjs

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * @fileoverview Hono Middleware for Entity Context
+ * @description Middleware to inject entity context into Hono request handlers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEntityContextMiddleware = createEntityContextMiddleware;
+exports.createRequirePermissionMiddleware = createRequirePermissionMiddleware;
+exports.createRequireRoleMiddleware = createRequireRoleMiddleware;
+exports.createEntityHelpers = createEntityHelpers;
+const EntityHelper_1 = require("../helpers/EntityHelper");
+const EntityMemberHelper_1 = require("../helpers/EntityMemberHelper");
+const InvitationHelper_1 = require("../helpers/InvitationHelper");
+const PermissionHelper_1 = require("../helpers/PermissionHelper");
+const types_1 = require("../types");
+/**
+ * Create middleware that injects entity context into the request.
+ *
+ * Usage:
+ * ```typescript
+ * const entityContext = createEntityContextMiddleware(config, {
+ *   getUserId: (c) => c.get('userId'),
+ *   entitySlugParam: 'entitySlug',
+ * });
+ *
+ * app.use('/api/v1/entities/:entitySlug/*', entityContext);
+ *
+ * app.get('/api/v1/entities/:entitySlug/projects', (c) => {
+ *   const { entity, userRole, permissions } = c.get('entityContext');
+ *   // ...
+ * });
+ * ```
+ */
+function createEntityContextMiddleware(config, options) {
+    const entityHelper = new EntityHelper_1.EntityHelper(config);
+    const permissionHelper = new PermissionHelper_1.PermissionHelper(config);
+    const slugParam = options.entitySlugParam ?? 'entitySlug';
+    return async (c, next) => {
+        const entitySlug = c.req.param(slugParam);
+        if (!entitySlug) {
+            return c.json({ error: 'Entity slug is required' }, 400);
+        }
+        const userId = options.getUserId(c);
+        if (!userId && !options.allowUnauthenticated) {
+            return c.json({ error: 'Authentication required' }, 401);
+        }
+        // Get entity by slug
+        const entity = await entityHelper.getEntityBySlug(entitySlug);
+        if (!entity) {
+            return c.json({ error: 'Entity not found' }, 404);
+        }
+        // If unauthenticated access is allowed and no user, continue without role
+        if (!userId && options.allowUnauthenticated) {
+            c.set('entity', entity);
+            await next();
+            return;
+        }
+        // Get user's role and permissions
+        const userRole = await permissionHelper.getUserRole(entity.id, userId);
+        if (!userRole) {
+            return c.json({ error: 'Access denied' }, 403);
+        }
+        const permissions = permissionHelper.getPermissionsForRole(userRole);
+        // Set entity context
+        const entityContext = {
+            entity,
+            userRole,
+            permissions,
+        };
+        c.set('entityContext', entityContext);
+        c.set('entity', entity);
+        c.set('userRole', userRole);
+        c.set('permissions', permissions);
+        await next();
+    };
+}
+/**
+ * Create middleware that requires a specific permission.
+ *
+ * Usage:
+ * ```typescript
+ * const requireAdmin = createRequirePermissionMiddleware('canManageMembers');
+ *
+ * app.post('/api/v1/entities/:entitySlug/members', requireAdmin, (c) => {
+ *   // Only admins can reach here
+ * });
+ * ```
+ */
+function createRequirePermissionMiddleware(permission) {
+    return async (c, next) => {
+        const permissions = c.get('permissions');
+        if (!permissions) {
+            return c.json({ error: 'Entity context not found' }, 500);
+        }
+        if (!permissions[permission]) {
+            return c.json({ error: 'Insufficient permissions' }, 403);
+        }
+        await next();
+    };
+}
+/**
+ * Create middleware that requires a minimum role.
+ *
+ * Usage:
+ * ```typescript
+ * const requireManager = createRequireRoleMiddleware(EntityRole.MANAGER);
+ *
+ * app.post('/api/v1/entities/:entitySlug/projects', requireManager, (c) => {
+ *   // Only managers and admins can reach here
+ * });
+ * ```
+ */
+function createRequireRoleMiddleware(minimumRole) {
+    const roleHierarchy = {
+        [types_1.EntityRole.VIEWER]: 0,
+        [types_1.EntityRole.MANAGER]: 1,
+        [types_1.EntityRole.ADMIN]: 2,
+    };
+    return async (c, next) => {
+        const userRole = c.get('userRole');
+        if (!userRole) {
+            return c.json({ error: 'Entity context not found' }, 500);
+        }
+        if (roleHierarchy[userRole] < roleHierarchy[minimumRole]) {
+            return c.json({ error: 'Insufficient role' }, 403);
+        }
+        await next();
+    };
+}
+/**
+ * Create all entity helpers with shared config.
+ *
+ * Usage:
+ * ```typescript
+ * const helpers = createEntityHelpers(config);
+ * const entity = await helpers.entity.getEntity(entityId);
+ * const members = await helpers.members.getMembers(entityId);
+ * ```
+ */
+function createEntityHelpers(config) {
+    return {
+        entity: new EntityHelper_1.EntityHelper(config),
+        members: new EntityMemberHelper_1.EntityMemberHelper(config),
+        invitations: new InvitationHelper_1.InvitationHelper(config),
+        permissions: new PermissionHelper_1.PermissionHelper(config),
+    };
+}
+//# sourceMappingURL=hono.js.map

package/dist/middleware/hono.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @fileoverview Hono Middleware for Entity Context
+ * @description Middleware to inject entity context into Hono request handlers
+ */
+import type { Context, MiddlewareHandler } from 'hono';
+import { EntityHelper } from '../helpers/EntityHelper';
+import { EntityMemberHelper } from '../helpers/EntityMemberHelper';
+import { InvitationHelper } from '../helpers/InvitationHelper';
+import { PermissionHelper } from '../helpers/PermissionHelper';
+import { EntityRole, type Entity, type EntityPermissions, type InvitationHelperConfig } from '../types';
+/**
+ * Entity context available in Hono handlers.
+ */
+export interface EntityContext {
+    entity: Entity;
+    userRole: EntityRole;
+    permissions: EntityPermissions;
+}
+/**
+ * Options for entity context middleware.
+ */
+export interface EntityContextMiddlewareOptions {
+    /** Function to get the user ID from the request context */
+    getUserId: (c: Context) => string | null;
+    /** Parameter name for entity slug in URL (default: 'entitySlug') */
+    entitySlugParam?: string;
+    /** Whether to allow unauthenticated access (default: false) */
+    allowUnauthenticated?: boolean;
+}
+/**
+ * Create middleware that injects entity context into the request.
+ *
+ * Usage:
+ * ```typescript
+ * const entityContext = createEntityContextMiddleware(config, {
+ *   getUserId: (c) => c.get('userId'),
+ *   entitySlugParam: 'entitySlug',
+ * });
+ *
+ * app.use('/api/v1/entities/:entitySlug/*', entityContext);
+ *
+ * app.get('/api/v1/entities/:entitySlug/projects', (c) => {
+ *   const { entity, userRole, permissions } = c.get('entityContext');
+ *   // ...
+ * });
+ * ```
+ */
+export declare function createEntityContextMiddleware(config: InvitationHelperConfig, options: EntityContextMiddlewareOptions): MiddlewareHandler;
+/**
+ * Create middleware that requires a specific permission.
+ *
+ * Usage:
+ * ```typescript
+ * const requireAdmin = createRequirePermissionMiddleware('canManageMembers');
+ *
+ * app.post('/api/v1/entities/:entitySlug/members', requireAdmin, (c) => {
+ *   // Only admins can reach here
+ * });
+ * ```
+ */
+export declare function createRequirePermissionMiddleware(permission: keyof EntityPermissions): MiddlewareHandler;
+/**
+ * Create middleware that requires a minimum role.
+ *
+ * Usage:
+ * ```typescript
+ * const requireManager = createRequireRoleMiddleware(EntityRole.MANAGER);
+ *
+ * app.post('/api/v1/entities/:entitySlug/projects', requireManager, (c) => {
+ *   // Only managers and admins can reach here
+ * });
+ * ```
+ */
+export declare function createRequireRoleMiddleware(minimumRole: EntityRole): MiddlewareHandler;
+/**
+ * Create all entity helpers with shared config.
+ *
+ * Usage:
+ * ```typescript
+ * const helpers = createEntityHelpers(config);
+ * const entity = await helpers.entity.getEntity(entityId);
+ * const members = await helpers.members.getMembers(entityId);
+ * ```
+ */
+export declare function createEntityHelpers(config: InvitationHelperConfig): {
+    entity: EntityHelper;
+    members: EntityMemberHelper;
+    invitations: InvitationHelper;
+    permissions: PermissionHelper;
+};
+/**
+ * Type augmentation for Hono context.
+ */
+declare module 'hono' {
+    interface ContextVariableMap {
+        entityContext: EntityContext;
+        entity: Entity;
+        userRole: EntityRole;
+        permissions: EntityPermissions;
+    }
+}
+//# sourceMappingURL=hono.d.ts.map

package/dist/middleware/hono.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../../src/middleware/hono.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EACL,UAAU,EACV,KAAK,MAAM,EACX,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC5B,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,CAAC;IACrB,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,2DAA2D;IAC3D,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;IACzC,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,8BAA8B,GACtC,iBAAiB,CAuDnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,MAAM,iBAAiB,GAClC,iBAAiB,CAcnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,UAAU,GACtB,iBAAiB,CAoBnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,sBAAsB;;;;;EAOjE;AAED;;GAEG;AACH,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,kBAAkB;QAC1B,aAAa,EAAE,aAAa,CAAC;QAC7B,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,UAAU,CAAC;QACrB,WAAW,EAAE,iBAAiB,CAAC;KAChC;CACF"}

package/dist/middleware/hono.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * @fileoverview Hono Middleware for Entity Context
+ * @description Middleware to inject entity context into Hono request handlers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEntityContextMiddleware = createEntityContextMiddleware;
+exports.createRequirePermissionMiddleware = createRequirePermissionMiddleware;
+exports.createRequireRoleMiddleware = createRequireRoleMiddleware;
+exports.createEntityHelpers = createEntityHelpers;
+const EntityHelper_1 = require("../helpers/EntityHelper");
+const EntityMemberHelper_1 = require("../helpers/EntityMemberHelper");
+const InvitationHelper_1 = require("../helpers/InvitationHelper");
+const PermissionHelper_1 = require("../helpers/PermissionHelper");
+const types_1 = require("../types");
+/**
+ * Create middleware that injects entity context into the request.
+ *
+ * Usage:
+ * ```typescript
+ * const entityContext = createEntityContextMiddleware(config, {
+ *   getUserId: (c) => c.get('userId'),
+ *   entitySlugParam: 'entitySlug',
+ * });
+ *
+ * app.use('/api/v1/entities/:entitySlug/*', entityContext);
+ *
+ * app.get('/api/v1/entities/:entitySlug/projects', (c) => {
+ *   const { entity, userRole, permissions } = c.get('entityContext');
+ *   // ...
+ * });
+ * ```
+ */
+function createEntityContextMiddleware(config, options) {
+    const entityHelper = new EntityHelper_1.EntityHelper(config);
+    const permissionHelper = new PermissionHelper_1.PermissionHelper(config);
+    const slugParam = options.entitySlugParam ?? 'entitySlug';
+    return async (c, next) => {
+        const entitySlug = c.req.param(slugParam);
+        if (!entitySlug) {
+            return c.json({ error: 'Entity slug is required' }, 400);
+        }
+        const userId = options.getUserId(c);
+        if (!userId && !options.allowUnauthenticated) {
+            return c.json({ error: 'Authentication required' }, 401);
+        }
+        // Get entity by slug
+        const entity = await entityHelper.getEntityBySlug(entitySlug);
+        if (!entity) {
+            return c.json({ error: 'Entity not found' }, 404);
+        }
+        // If unauthenticated access is allowed and no user, continue without role
+        if (!userId && options.allowUnauthenticated) {
+            c.set('entity', entity);
+            await next();
+            return;
+        }
+        // Get user's role and permissions
+        const userRole = await permissionHelper.getUserRole(entity.id, userId);
+        if (!userRole) {
+            return c.json({ error: 'Access denied' }, 403);
+        }
+        const permissions = permissionHelper.getPermissionsForRole(userRole);
+        // Set entity context
+        const entityContext = {
+            entity,
+            userRole,
+            permissions,
+        };
+        c.set('entityContext', entityContext);
+        c.set('entity', entity);
+        c.set('userRole', userRole);
+        c.set('permissions', permissions);
+        await next();
+    };
+}
+/**
+ * Create middleware that requires a specific permission.
+ *
+ * Usage:
+ * ```typescript
+ * const requireAdmin = createRequirePermissionMiddleware('canManageMembers');
+ *
+ * app.post('/api/v1/entities/:entitySlug/members', requireAdmin, (c) => {
+ *   // Only admins can reach here
+ * });
+ * ```
+ */
+function createRequirePermissionMiddleware(permission) {
+    return async (c, next) => {
+        const permissions = c.get('permissions');
+        if (!permissions) {
+            return c.json({ error: 'Entity context not found' }, 500);
+        }
+        if (!permissions[permission]) {
+            return c.json({ error: 'Insufficient permissions' }, 403);
+        }
+        await next();
+    };
+}
+/**
+ * Create middleware that requires a minimum role.
+ *
+ * Usage:
+ * ```typescript
+ * const requireManager = createRequireRoleMiddleware(EntityRole.MANAGER);
+ *
+ * app.post('/api/v1/entities/:entitySlug/projects', requireManager, (c) => {
+ *   // Only managers and admins can reach here
+ * });
+ * ```
+ */
+function createRequireRoleMiddleware(minimumRole) {
+    const roleHierarchy = {
+        [types_1.EntityRole.VIEWER]: 0,
+        [types_1.EntityRole.MANAGER]: 1,
+        [types_1.EntityRole.ADMIN]: 2,
+    };
+    return async (c, next) => {
+        const userRole = c.get('userRole');
+        if (!userRole) {
+            return c.json({ error: 'Entity context not found' }, 500);
+        }
+        if (roleHierarchy[userRole] < roleHierarchy[minimumRole]) {
+            return c.json({ error: 'Insufficient role' }, 403);
+        }
+        await next();
+    };
+}
+/**
+ * Create all entity helpers with shared config.
+ *
+ * Usage:
+ * ```typescript
+ * const helpers = createEntityHelpers(config);
+ * const entity = await helpers.entity.getEntity(entityId);
+ * const members = await helpers.members.getMembers(entityId);
+ * ```
+ */
+function createEntityHelpers(config) {
+    return {
+        entity: new EntityHelper_1.EntityHelper(config),
+        members: new EntityMemberHelper_1.EntityMemberHelper(config),
+        invitations: new InvitationHelper_1.InvitationHelper(config),
+        permissions: new PermissionHelper_1.PermissionHelper(config),
+    };
+}
+//# sourceMappingURL=hono.js.map

package/dist/middleware/hono.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.js","sourceRoot":"","sources":["../../src/middleware/hono.ts"],"names":[],"mappings":"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"}

package/dist/middleware/index.cjs

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * @fileoverview Middleware Exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEntityHelpers = exports.createRequireRoleMiddleware = exports.createRequirePermissionMiddleware = exports.createEntityContextMiddleware = void 0;
+var hono_1 = require("./hono");
+Object.defineProperty(exports, "createEntityContextMiddleware", { enumerable: true, get: function () { return hono_1.createEntityContextMiddleware; } });
+Object.defineProperty(exports, "createRequirePermissionMiddleware", { enumerable: true, get: function () { return hono_1.createRequirePermissionMiddleware; } });
+Object.defineProperty(exports, "createRequireRoleMiddleware", { enumerable: true, get: function () { return hono_1.createRequireRoleMiddleware; } });
+Object.defineProperty(exports, "createEntityHelpers", { enumerable: true, get: function () { return hono_1.createEntityHelpers; } });
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Middleware Exports
+ */
+export { createEntityContextMiddleware, createRequirePermissionMiddleware, createRequireRoleMiddleware, createEntityHelpers, type EntityContext, type EntityContextMiddlewareOptions, } from './hono';
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,EACjC,2BAA2B,EAC3B,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,8BAA8B,GACpC,MAAM,QAAQ,CAAC"}

package/dist/middleware/index.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * @fileoverview Middleware Exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEntityHelpers = exports.createRequireRoleMiddleware = exports.createRequirePermissionMiddleware = exports.createEntityContextMiddleware = void 0;
+var hono_1 = require("./hono");
+Object.defineProperty(exports, "createEntityContextMiddleware", { enumerable: true, get: function () { return hono_1.createEntityContextMiddleware; } });
+Object.defineProperty(exports, "createRequirePermissionMiddleware", { enumerable: true, get: function () { return hono_1.createRequirePermissionMiddleware; } });
+Object.defineProperty(exports, "createRequireRoleMiddleware", { enumerable: true, get: function () { return hono_1.createRequireRoleMiddleware; } });
+Object.defineProperty(exports, "createEntityHelpers", { enumerable: true, get: function () { return hono_1.createEntityHelpers; } });
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,+BAOgB;AANd,qHAAA,6BAA6B,OAAA;AAC7B,yHAAA,iCAAiC,OAAA;AACjC,mHAAA,2BAA2B,OAAA;AAC3B,2GAAA,mBAAmB,OAAA"}