@unifiedcommerce/core 0.3.3 → 0.4.0

package/dist/interfaces/rest/schemas/inventory.js

@@ -9,6 +9,26 @@ export const CreateWarehouseBodySchema = z.object({
     address: z.record(z.string(), z.unknown()).optional(),
 }).openapi("CreateWarehouseRequest");
 // ─── Route Definitions ──────────────────────────────────────────────────────
+export const listInventoryLevelsRoute = createRoute({
+    method: "get",
+    path: "/levels",
+    tags: ["Inventory"],
+    summary: "List inventory levels",
+    description: "Lists all inventory levels, optionally filtered by warehouse or entity.",
+    request: {
+        query: z.object({
+            warehouseId: z.string().uuid().optional().openapi({ example: "uuid" }),
+            entityId: z.string().uuid().optional().openapi({ example: "uuid" }),
+        }),
+    },
+    responses: {
+        200: {
+            content: { "application/json": { schema: z.object({ data: z.array(z.record(z.string(), z.unknown())) }) } },
+            description: "Inventory levels",
+        },
+        ...errorResponses,
+    },
+});
 export const inventoryCheckRoute = createRoute({
     method: "get",
     path: "/check",

package/dist/modules/customers/service.d.ts

@@ -10,8 +10,10 @@ export declare class CustomerService {
     private readonly repo;
     constructor(deps: CustomerServiceDeps);
     private getOrCreateByUserId;
+    list(actor?: Actor | null, ctx?: TxContext): Promise<Result<Customer[]>>;
     getById(id: string, actor?: Actor | null, ctx?: TxContext): Promise<Result<Customer>>;
     getByUserId(userId: string, actor?: Actor | null, ctx?: TxContext): Promise<Result<Customer>>;
+    update(id: string, updates: Partial<Omit<Customer, "id" | "userId" | "createdAt" | "updatedAt">>, actor?: Actor | null, ctx?: TxContext): Promise<Result<Customer>>;
     updateByUserId(userId: string, updates: Partial<Omit<Customer, "id" | "userId" | "createdAt" | "updatedAt">>, actor?: Actor | null, ctx?: TxContext): Promise<Result<Customer>>;
     getAddresses(userId: string, actor?: Actor | null, ctx?: TxContext): Promise<Result<CustomerAddress[]>>;
     addAddress(userId: string, input: Omit<CustomerAddressInsert, "id" | "customerId">, actor?: Actor | null, ctx?: TxContext): Promise<Result<CustomerAddress>>;

package/dist/modules/customers/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/customers/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,KAAK,EACV,mBAAmB,EACnB,QAAQ,EACR,eAAe,EACf,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAE/B,UAAU,mBAAmB;IAC3B,UAAU,EAAE,mBAAmB,CAAC;CACjC;AAED,qBAAa,eAAe;IAGd,OAAO,CAAC,IAAI;IAFxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;gBAEvB,IAAI,EAAE,mBAAmB;YAI/B,mBAAmB;IAsB3B,OAAO,CACX,EAAE,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAOtB,WAAW,CACf,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAMtB,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,CACd,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC,CAC5D,EACD,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAYtB,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;IAU/B,UAAU,CACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,GAAG,YAAY,CAAC,EACvD,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IA4B7B,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAiBlB,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAYhD"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/customers/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,KAAK,EACV,mBAAmB,EACnB,QAAQ,EACR,eAAe,EACf,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAE/B,UAAU,mBAAmB;IAC3B,UAAU,EAAE,mBAAmB,CAAC;CACjC;AAED,qBAAa,eAAe;IAGd,OAAO,CAAC,IAAI;IAFxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;gBAEvB,IAAI,EAAE,mBAAmB;YAI/B,mBAAmB;IAsB3B,IAAI,CACR,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAMxB,OAAO,CACX,EAAE,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAOtB,WAAW,CACf,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAMtB,MAAM,CACV,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CACd,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC,CAC5D,EACD,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAStB,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,CACd,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC,CAC5D,EACD,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAYtB,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;IAU/B,UAAU,CACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,GAAG,YAAY,CAAC,EACvD,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IA4B7B,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAiBlB,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAYhD"}

package/dist/modules/customers/service.js

@@ -20,6 +20,11 @@ export class CustomerService {
         }, ctx);
         return customer;
     }
+    async list(actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const customers = await this.repo.findAll(orgId, ctx);
+        return Ok(customers);
+    }
     async getById(id, actor, ctx) {
         const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
         const customer = await this.repo.findById(orgId, id, ctx);
@@ -32,6 +37,16 @@ export class CustomerService {
         const customer = await this.getOrCreateByUserId(orgId, userId, ctx);
         return Ok(customer);
     }
+    async update(id, updates, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const existing = await this.repo.findById(orgId, id, ctx);
+        if (!existing)
+            return Err(new CommerceNotFoundError("Customer not found."));
+        const updated = await this.repo.update(id, updates, ctx);
+        if (!updated)
+            return Err(new CommerceNotFoundError("Customer not found."));
+        return Ok(updated);
+    }
     async updateByUserId(userId, updates, actor, ctx) {
         const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
         const customer = await this.getOrCreateByUserId(orgId, userId, ctx);

package/dist/modules/inventory/service.d.ts

@@ -22,6 +22,10 @@ export declare class InventoryService {
     createWarehouse(input: Partial<Warehouse>, actor?: Actor | null, ctx?: TxContext): Promise<Result<Warehouse>>;
     listWarehouses(actor?: Actor | null, ctx?: TxContext): Promise<Result<Warehouse[]>>;
     getAvailable(entityId: string, variantId?: string, ctx?: TxContext): Promise<Result<number>>;
+    listLevels(params?: {
+        warehouseId?: string;
+        entityId?: string;
+    }, actor?: Actor | null, ctx?: TxContext): Promise<Result<InventoryLevel[]>>;
     checkMultiple(entityIds: string[], ctx?: TxContext): Promise<Result<Record<string, number>>>;
     getLevelsByEntityId(entityId: string, ctx?: TxContext): Promise<Result<InventoryLevel[]>>;
     reserve(input: InventoryReserveInput, actor?: Actor | null, ctx?: TxContext): Promise<Result<void>>;

package/dist/modules/inventory/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/inventory/service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/inventory/service.ts"],"names":[],"mappings":"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"}

package/dist/modules/inventory/service.js

@@ -56,6 +56,18 @@ export class InventoryService {
         const available = await this.repo.getAvailableQuantity(entityId, variantId, ctx);
         return Ok(available);
     }
+    async listLevels(params, actor, ctx) {
+        if (params?.entityId) {
+            const levels = await this.repo.findLevelsByEntityId(params.entityId, ctx);
+            return Ok(levels);
+        }
+        if (params?.warehouseId) {
+            const levels = await this.repo.findLevelsByWarehouseId(params.warehouseId, ctx);
+            return Ok(levels);
+        }
+        const levels = await this.repo.findAllLevels(ctx);
+        return Ok(levels);
+    }
     async checkMultiple(entityIds, ctx) {
         const data = await this.repo.getAvailableQuantities(entityIds, ctx);
         return Ok(data);

package/dist/runtime/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/runtime/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOzD,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtE,KAAK,SAAS,GAAG;IACf,SAAS,EAAE;QACT,IAAI,EAAE,YAAY,CAAC;QACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc;;;;;GA8TxD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/runtime/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOzD,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtE,KAAK,SAAS,GAAG;IACf,SAAS,EAAE;QACT,IAAI,EAAE,YAAY,CAAC;QACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc;;;;;GA4VxD"}

package/dist/runtime/server.js

@@ -207,6 +207,35 @@ export async function createServer(config) {
                 version: config.version ?? "0.0.1",
                 description: "Headless commerce engine REST API. Includes core and plugin endpoints.",
             },
+            tags: [
+                // ── Storefront ──
+                { name: "Catalog", description: "Products, categories, brands, variants, and option types" },
+                { name: "Search", description: "Full-text search and typeahead suggestions" },
+                { name: "Pricing", description: "Base prices, price modifiers, and customer group pricing" },
+                { name: "Carts", description: "Shopping cart lifecycle — create, add items, update quantities" },
+                { name: "Checkout", description: "Convert a cart into a paid order" },
+                { name: "Promotions", description: "Discount codes, validation, and usage tracking" },
+                // ── Admin ──
+                { name: "Orders", description: "Order management — list, detail, status transitions, fulfillments" },
+                { name: "Customers", description: "Customer profiles, addresses, groups, and order history" },
+                { name: "Inventory", description: "Stock levels, warehouse management, adjustments, and reservations" },
+                { name: "Media", description: "File uploads, entity attachments, and signed URLs" },
+                { name: "Payments", description: "Payment provider webhooks and event processing" },
+                // ── Operations ──
+                { name: "Webhooks", description: "Outbound webhook endpoint registration and management" },
+                { name: "Audit", description: "Immutable audit log — who changed what and when" },
+                { name: "Admin Jobs", description: "Background job queue — view failed jobs and retry" },
+            ],
+        });
+        // Serve enriched spec with x-tagGroups vendor extension (Scalar/Redocly sidebar grouping)
+        const tagGroups = [
+            { name: "Storefront", tags: ["Catalog", "Search", "Pricing", "Carts", "Checkout", "Promotions"] },
+            { name: "Admin", tags: ["Orders", "Customers", "Inventory", "Media", "Payments"] },
+            { name: "Operations", tags: ["Webhooks", "Audit", "Admin Jobs"] },
+        ];
+        app.get("/api/doc-ext", (c) => {
+            const spec = app.getOpenAPIDocument({ openapi: "3.0.0", info: { title: "UnifiedCommerce API", version: config.version ?? "0.0.1" } });
+            return c.json({ ...spec, "x-tagGroups": tagGroups });
         });
     }
     else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unifiedcommerce/core",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "type": "module",
   "exports": {
     ".": {
@@ -44,9 +44,9 @@
   },
   "dependencies": {
     "@better-auth/drizzle-adapter": "^1.3.8",
-    "@hono/swagger-ui": "^0.6.1",
     "@hono/zod-openapi": "^1.2.2",
     "@modelcontextprotocol/sdk": "^1.27.1",
+    "@scalar/hono-api-reference": "^0.10.5",
     "better-auth": "^1.3.8",
     "drizzle-orm": "^0.45.1",
     "drizzle-zod": "^0.8.3",

package/src/auth/setup.ts

@@ -10,80 +10,39 @@ import * as authSchema from "./auth-schema.js";
 type BetterAuthDbProvider = "pg" | "mysql" | "sqlite";
 
 function resolveAuthDbProvider(provider: string): BetterAuthDbProvider {
-  if (
-    provider === "postgres" ||
-    provider === "postgresql" ||
-    provider === "pg"
-  ) {
-    return "pg";
-  }
-  if (provider === "mysql") {
-    return "mysql";
-  }
-  if (provider === "sqlite") {
-    return "sqlite";
-  }
-  throw new Error(
-    `Unsupported auth database provider "${provider}". Expected one of: postgres, mysql, sqlite.`,
-  );
+  if (provider === "postgres" || provider === "postgresql" || provider === "pg") return "pg";
+  if (provider === "mysql") return "mysql";
+  if (provider === "sqlite") return "sqlite";
+  throw new Error(`Unsupported auth database provider "${provider}".`);
 }
 
 interface AuthEmailPayload {
-  user: {
-    email: string;
-    name: string | null;
-  };
+  user: { email: string; name: string | null };
   url: string;
 }
 
-/** Member shape returned by Better Auth's organization plugin */
-export interface OrgMember {
-  id: string;
-  userId: string;
-  organizationId: string;
-  role: string;
-  createdAt: string;
-}
-
-export interface AuthInstance {
-  handler(request: Request): Promise<Response>;
-  api: {
-    getSession(input: { headers: Headers }): Promise<unknown>;
-
-    // Organization plugin methods
-    getActiveMemberRole?: (input: { headers: Headers }) => Promise<{ role: string } | null>;
-    getFullOrganization?: (input: { query: { organizationId: string }; headers: Headers }) => Promise<{
-      id: string;
-      name: string;
-      members: OrgMember[];
-    } | null>;
-    listMembers?: (input: { query: { organizationId: string } }) => Promise<OrgMember[]>;
-
-    // API key plugin methods
-    verifyApiKey?: (input: {
-      body: { key: string; permissions?: Record<string, string[]> };
-    }) => Promise<{
-      valid: boolean;
-      error: { message: string; code: string } | null;
-      key: Record<string, unknown> | null;
-    }>;
-    createApiKey?: (input: {
-      body: {
-        configId?: string;
-        name?: string;
-        permissions?: Record<string, string[]>;
-        userId?: string;
-        organizationId?: string;
-      };
-      headers?: Headers;
-    }) => Promise<{ key: string; id: string }>;
+/**
+ * The auth type is inferred from `typeof betterAuth(...)` with all plugins enabled.
+ * This gives us the full API surface without manual interface maintenance.
+ *
+ * We use a type-level-only reference (never executed) to capture the complete type.
+ */
+type FullBetterAuth = ReturnType<typeof betterAuth<{
+  plugins: [
+    ReturnType<typeof organization>,
+    ReturnType<typeof bearer>,
+    ReturnType<typeof jwt>,
+    ReturnType<typeof twoFactor>,
+    ReturnType<typeof apiKey>,
+    ReturnType<typeof phoneNumber>,
+  ];
+}>>;
 
-    /** Allow access to other Better Auth API methods added by plugins */
-    [key: string]: unknown;
-  };
-  options?: Record<string, unknown>;
-  $context?: Promise<unknown>;
-}
+/**
+ * AuthInstance — inferred from Better Auth with all plugins.
+ * No manual type maintenance needed.
+ */
+export type AuthInstance = FullBetterAuth;
 
 export function createAuth(
   db: DatabaseAdapter,
@@ -98,8 +57,6 @@ export function createAuth(
     | ReturnType<typeof bearer>
   > = [
     organization({
-      // Better Auth's Role includes `authorize` and `statements` fields that
-      // our RoleDefinition doesn't have. Double-cast is required — upstream type gap.
       roles: (config.auth?.roles ?? {}) as unknown as Record<string, Role | undefined>,
     }),
     bearer(),
@@ -110,7 +67,6 @@ export function createAuth(
     plugins.push(twoFactor({ issuer: config.storeName ?? "UnifiedCommerce" }));
   }
 
-  // Configure API key plugin — one config per defined scope, or a single default config.
   const scopes = config.auth?.apiKeyScopes;
   if (scopes && Object.keys(scopes).length > 0) {
     const apiKeyConfigs = Object.entries(scopes).map(([scopeId, scope]) => ({
@@ -143,12 +99,8 @@ export function createAuth(
     }));
   }
 
-  // API key support can be attached via external plugin package in newer better-auth versions.
-
   try {
     const auth = betterAuth({
-      // Better Auth's drizzle adapter expects a plain object, not PgDatabase.
-      // Double-cast required — PgDatabase has no index signature.
       database: drizzleAdapter(db.db as unknown as Record<string, unknown>, {
         provider: resolveAuthDbProvider(db.provider),
         schema: authSchema,
@@ -180,7 +132,7 @@ export function createAuth(
         updateAge: 60 * 60 * 24,
         cookieCache: {
           enabled: true,
-          maxAge: 60 * 5,  // 5 minute cookie cache for performance
+          maxAge: 60 * 5,
         },
       },
       advanced: {
@@ -195,10 +147,9 @@ export function createAuth(
         },
       },
     });
-    // Better Auth's plugin-extended return type is structurally incompatible with
-    // our simplified AuthInstance interface (upstream generic union vs our narrowed shape).
-    // Double-cast is the accepted pattern — same approach used by PayloadCMS.
-    // @see https://github.com/better-auth/better-auth/discussions
+
+    // The runtime return matches FullBetterAuth structurally — plugins may differ
+    // at runtime (conditional) but the API surface is a superset.
     return auth as unknown as AuthInstance;
   } catch (error) {
     const message =

package/src/interfaces/rest/index.ts

@@ -1,5 +1,5 @@
 import { OpenAPIHono } from "@hono/zod-openapi";
-import { swaggerUI } from "@hono/swagger-ui";
+import { Scalar } from "@scalar/hono-api-reference";
 import { sql } from "drizzle-orm";
 import type { Kernel } from "../../runtime/kernel.js";
 import type { AppEnv } from "./utils.js";
@@ -16,6 +16,7 @@ import { promotionRoutes } from "./routes/promotions.js";
 import { searchRoutes } from "./routes/search.js";
 import { auditRoutes } from "./routes/audit.js";
 import { adminJobRoutes } from "./routes/admin-jobs.js";
+import { customerRoutes } from "./routes/customers.js";
 
 export function createRestRoutes(kernel: Kernel) {
   const router = new OpenAPIHono<AppEnv>({
@@ -61,13 +62,26 @@ export function createRestRoutes(kernel: Kernel) {
   router.route("/pricing", pricingRoutes(kernel));
   router.route("/promotions", promotionRoutes(kernel));
   router.route("/search", searchRoutes(kernel));
+  router.route("/customers", customerRoutes(kernel));
   router.route("/audit", auditRoutes(kernel));
   router.route("/admin", adminJobRoutes(kernel));
 
-  // Swagger UI — disabled in production unless config.exposeOpenApiSpec is true
+  // API Reference (Scalar) — disabled in production unless config.exposeOpenApiSpec is true
   const exposeSpec = kernel.config.exposeOpenApiSpec ?? (process.env.NODE_ENV !== "production");
   if (exposeSpec) {
-    router.get("/reference", swaggerUI({ url: "/api/doc" }));
+    router.get(
+      "/reference",
+      Scalar({
+        url: "/api/doc-ext",
+        theme: "kepler",
+        layout: "modern",
+        darkMode: true,
+        hideModels: true,
+        tagsSorter: "alpha",
+        defaultHttpClient: { targetKey: "js", clientKey: "fetch" },
+        metaData: { title: "UnifiedCommerce API Reference" },
+      }),
+    );
   }
 
   return router;

package/src/interfaces/rest/routes/customers.ts

@@ -0,0 +1,94 @@
+import { OpenAPIHono } from "@hono/zod-openapi";
+import type { Kernel } from "../../../runtime/kernel.js";
+import {
+  listCustomersRoute,
+  getCustomerRoute,
+  updateCustomerRoute,
+  getCustomerOrdersRoute,
+  getCustomerAddressesRoute,
+} from "../schemas/customers.js";
+import { type AppEnv, mapErrorToResponse, mapErrorToStatus, parsePagination } from "../utils.js";
+
+export function customerRoutes(kernel: Kernel) {
+  const router = new OpenAPIHono<AppEnv>();
+
+  // @ts-expect-error -- openapi handler union return type
+  router.openapi(listCustomersRoute, async (c) => {
+    const actor = c.get("actor");
+    const { page, limit } = parsePagination(c.req.query());
+
+    const result = await kernel.services.customers.list(actor);
+    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+
+    const all = result.value;
+    const total = all.length;
+    const start = (page - 1) * limit;
+    const paged = all.slice(start, start + limit);
+
+    return c.json({
+      data: paged,
+      meta: {
+        pagination: { page, limit, total, totalPages: Math.ceil(total / limit) },
+      },
+    });
+  });
+
+  // @ts-expect-error -- openapi handler union return type
+  router.openapi(getCustomerRoute, async (c) => {
+    const { id } = c.req.valid("param");
+    const actor = c.get("actor");
+    const result = await kernel.services.customers.getById(id, actor);
+    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    return c.json({ data: result.value });
+  });
+
+  // @ts-expect-error -- openapi handler union return type
+  router.openapi(updateCustomerRoute, async (c) => {
+    const { id } = c.req.valid("param");
+    const body = c.req.valid("json");
+    const actor = c.get("actor");
+    // Strip undefined values — exactOptionalPropertyTypes requires omission, not undefined
+    const updates: Record<string, unknown> = {};
+    for (const [k, v] of Object.entries(body)) {
+      if (v !== undefined) updates[k] = v;
+    }
+    const result = await kernel.services.customers.update(id, updates, actor);
+    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    return c.json({ data: result.value });
+  });
+
+  // @ts-expect-error -- openapi handler union return type
+  router.openapi(getCustomerOrdersRoute, async (c) => {
+    const { id } = c.req.valid("param");
+    const actor = c.get("actor");
+    const { page, limit } = parsePagination(c.req.query());
+    const status = c.req.query("status") || undefined;
+
+    const result = await kernel.services.orders.listByCustomer(
+      id,
+      { page, limit, ...(status ? { status } : {}) },
+      actor,
+    );
+    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    return c.json({ data: result.value.items, meta: { pagination: result.value.pagination } });
+  });
+
+  // @ts-expect-error -- openapi handler union return type
+  router.openapi(getCustomerAddressesRoute, async (c) => {
+    const { id } = c.req.valid("param");
+    const actor = c.get("actor");
+
+    // Get customer first, then use their userId for address lookup
+    const customerResult = await kernel.services.customers.getById(id, actor);
+    if (!customerResult.ok) return c.json(mapErrorToResponse(customerResult.error), mapErrorToStatus(customerResult.error));
+
+    const addressResult = await kernel.services.customers.getAddresses(
+      customerResult.value.userId,
+      actor,
+    );
+    if (!addressResult.ok) return c.json(mapErrorToResponse(addressResult.error), mapErrorToStatus(addressResult.error));
+    return c.json({ data: addressResult.value });
+  });
+
+  return router;
+}

package/src/interfaces/rest/routes/inventory.ts

@@ -7,12 +7,29 @@ import {
   createWarehouseRoute,
   inventoryCheckRoute,
   listWarehousesRoute,
+  listInventoryLevelsRoute,
 } from "../schemas/inventory.js";
 import { type AppEnv, mapErrorToResponse, mapErrorToStatus } from "../utils.js";
 
 export function inventoryRoutes(kernel: Kernel) {
   const router = new OpenAPIHono<AppEnv>();
 
+  // @ts-expect-error -- openapi handler union return type
+  router.openapi(listInventoryLevelsRoute, async (c) => {
+    const actor = c.get("actor");
+    const warehouseId = c.req.query("warehouseId");
+    const entityId = c.req.query("entityId");
+    const result = await kernel.services.inventory.listLevels(
+      {
+        ...(warehouseId ? { warehouseId } : {}),
+        ...(entityId ? { entityId } : {}),
+      },
+      actor,
+    );
+    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    return c.json({ data: result.value });
+  });
+
   // @ts-expect-error -- openapi handler union return type
   router.openapi(inventoryCheckRoute, async (c) => {
     const entityIds = (c.req.query("entityIds") ?? "")