@sudobility/entity_service

Shared backend library for multi-tenant entity/organization management with Drizzle ORM and Hono middleware.

Installation

bun add @sudobility/entity_service

Usage

import {
  createEntityHelpers,
  createEntitiesTable,
  createEntityMembersTable,
  createEntityContextMiddleware,
} from '@sudobility/entity_service';

// Setup helpers
const helpers = createEntityHelpers({
  db: drizzleDb,
  entitiesTable: schema.entities,
  membersTable: schema.entityMembers,
  invitationsTable: schema.entityInvitations,
  usersTable: schema.users,
});

// Entity operations
const entity = await helpers.entity.getOrCreatePersonalEntity(userId, email);
const org = await helpers.entity.createOrganizationEntity(userId, { displayName: 'My Org' });
const entities = await helpers.entity.getUserEntities(userId);

// Hono middleware
app.use('/api/v1/entities/:entitySlug/*', createEntityContextMiddleware(config, {
  getUserId: (c) => c.get('userId'),
}));

API

Schema Factories

Export	Description
`createEntitiesTable(pgSchema, prefix)`	Entities table definition
`createEntityMembersTable(pgSchema, prefix)`	Entity members table
`createEntityInvitationsTable(pgSchema, prefix)`	Invitations table

Helpers

Helper	Key Methods
`EntityHelper`	`getOrCreatePersonalEntity`, `createOrganizationEntity`, `getUserEntities`, CRUD
`EntityMemberHelper`	Member listing, role updates, removal
`InvitationHelper`	Create, accept, decline, cancel, renew invitations
`PermissionHelper`	Role-based permission checks (Owner > Manager > Member)

Middleware

Export	Description
`createEntityContextMiddleware`	Hono middleware injecting entity context, role, and permissions

Types

Re-exports from @sudobility/types: Entity, EntityMember, EntityInvitation, EntityType, EntityRole, EntityPermissions

Development

bun run build        # Build ESM-only
bun run verify       # All checks + build (use before commit)
bun test             # Run tests (vitest)
bun run typecheck    # TypeScript check
bun run lint         # ESLint
bun run clean        # Remove dist/

License

BUSL-1.1