workerstack 0.1.0-beta.0

package/dist/api/registry.js

@@ -0,0 +1,236 @@
+import { getOpenAPIMeta } from '@orpc/openapi';
+const RESERVED_EXACT = new Set([
+    '/api/health',
+    '/api/readiness',
+    '/api/openapi.json',
+    '/api/realtime',
+    '/api/rpc',
+    '/api/auth',
+    '/api/files',
+]);
+const RESERVED_PREFIXES = ['/api/rpc/', '/api/auth/', '/api/files/'];
+function collisionForWorkerstackPath(path) {
+    if (RESERVED_EXACT.has(path))
+        return 'it is reserved by workerstack';
+    const prefix = RESERVED_PREFIXES.find((value) => path.startsWith(value));
+    return prefix ? `"${prefix}*" is reserved by workerstack` : undefined;
+}
+const HTTP_METHODS = new Set([
+    'GET',
+    'POST',
+    'PUT',
+    'PATCH',
+    'DELETE',
+    'HEAD',
+    'OPTIONS',
+]);
+export function normalizeApiPath(path, prefix) {
+    let cleanPath = path.startsWith('/') ? path : '/' + path;
+    if (prefix) {
+        let cleanPrefix = prefix.startsWith('/') ? prefix : '/' + prefix;
+        if (cleanPrefix.endsWith('/')) {
+            cleanPrefix = cleanPrefix.slice(0, -1);
+        }
+        if (cleanPath === cleanPrefix || cleanPath.startsWith(cleanPrefix + '/')) {
+            // Path already starts with prefix
+        }
+        else {
+            cleanPath = cleanPrefix + cleanPath;
+        }
+    }
+    return cleanPath.replace(/\/+/g, '/');
+}
+export function normalizeForeignOpenAPISpec(spec, options = {}) {
+    const prefix = options.prefix;
+    const source = options.source;
+    const cloned = JSON.parse(JSON.stringify(spec));
+    if (cloned.paths && typeof cloned.paths === 'object') {
+        const normalizedPaths = {};
+        for (const [routePath, pathItem] of Object.entries(cloned.paths)) {
+            const canonicalPath = normalizeApiPath(routePath, prefix);
+            normalizedPaths[canonicalPath] = pathItem;
+        }
+        cloned.paths = normalizedPaths;
+    }
+    if (source) {
+        cloned['x-workerstack-source'] = source;
+    }
+    return cloned;
+}
+export function mergeApiRoutersStrict(target, source, prefix = []) {
+    if (!source)
+        return { ...target };
+    const result = { ...target };
+    for (const [key, val] of Object.entries(source)) {
+        const currentPath = [...prefix, key];
+        const handle = currentPath.join('.');
+        const targetVal = result[key];
+        if (targetVal !== undefined) {
+            const isTargetNamespace = typeof targetVal === 'object' &&
+                targetVal !== null &&
+                !('~orpc' in targetVal);
+            const isSourceNamespace = typeof val === 'object' && val !== null && !('~orpc' in val);
+            if (isTargetNamespace && isSourceNamespace) {
+                result[key] = mergeApiRoutersStrict(targetVal, val, currentPath);
+            }
+            else {
+                throw new Error(`[workerstack] Router merge collision at handle "${handle}": duplicate procedure or namespace collision`);
+            }
+        }
+        else {
+            result[key] = val;
+        }
+    }
+    return result;
+}
+function normalizePathSegments(path) {
+    return path.split('/').filter(Boolean);
+}
+function isParamSegment(segment) {
+    return ((segment.startsWith('{') && segment.endsWith('}')) ||
+        segment.startsWith(':'));
+}
+function normalizePathForCollision(path) {
+    const segments = normalizePathSegments(path);
+    const normalized = segments.map((seg) => isParamSegment(seg) ? '{param}' : seg);
+    return '/' + normalized.join('/');
+}
+function walkNativeRouter(obj, pathSegments = []) {
+    const entries = [];
+    for (const [key, value] of Object.entries(obj)) {
+        if (!value || typeof value !== 'object')
+            continue;
+        const currentSegments = [...pathSegments, key];
+        if ('~orpc' in value) {
+            const meta = (getOpenAPIMeta(value) || {});
+            const handle = currentSegments.join('.');
+            const method = (meta.method || 'GET').toUpperCase();
+            const routePath = meta.path || '/' + currentSegments.join('/');
+            const operationId = typeof meta.operationId === 'string' ? meta.operationId : handle;
+            entries.push({
+                handle,
+                operationId,
+                method,
+                path: routePath,
+                source: 'native',
+            });
+        }
+        else {
+            entries.push(...walkNativeRouter(value, currentSegments));
+        }
+    }
+    return entries;
+}
+function extractForeignEntries(specs) {
+    const entries = [];
+    for (const item of specs) {
+        if (!item)
+            continue;
+        let specObj;
+        let source = 'foreign';
+        if ('spec' in item && typeof item.spec === 'object' && item.spec !== null) {
+            const entry = item;
+            source = entry.source || 'foreign';
+            specObj = normalizeForeignOpenAPISpec(entry.spec, {
+                prefix: entry.prefix,
+                source,
+            });
+        }
+        else {
+            const rawSpec = item;
+            source = rawSpec['x-workerstack-source'] || 'foreign';
+            specObj = normalizeForeignOpenAPISpec(rawSpec, { source });
+        }
+        if (!specObj || typeof specObj.paths !== 'object' || !specObj.paths)
+            continue;
+        const paths = specObj.paths;
+        for (const [routePath, pathItem] of Object.entries(paths)) {
+            if (!pathItem || typeof pathItem !== 'object')
+                continue;
+            for (const [methodKey, operation] of Object.entries(pathItem)) {
+                const uppercaseMethod = methodKey.toUpperCase();
+                if (!HTTP_METHODS.has(uppercaseMethod))
+                    continue;
+                if (!operation || typeof operation !== 'object')
+                    continue;
+                const op = operation;
+                const handle = `foreign:${source}:${uppercaseMethod}:${routePath}`;
+                const operationId = typeof op.operationId === 'string' ? op.operationId : handle;
+                entries.push({
+                    handle,
+                    operationId,
+                    method: uppercaseMethod,
+                    path: routePath,
+                    source,
+                });
+            }
+        }
+    }
+    return entries;
+}
+export async function buildApiRegistry(options = {}) {
+    const entries = [];
+    if (options.nativeRouter) {
+        entries.push(...walkNativeRouter(options.nativeRouter));
+    }
+    if (options.foreignSpecs) {
+        entries.push(...extractForeignEntries(options.foreignSpecs));
+    }
+    const errors = [];
+    for (const entry of entries) {
+        if (entry.source !== 'native')
+            continue;
+        if (options.reservedCoreHandles?.has(entry.handle))
+            continue;
+        const reason = collisionForWorkerstackPath(entry.path);
+        if (reason) {
+            errors.push(`Reserved route collision on ${entry.method} ${entry.path}: native handle "${entry.handle}" conflicts because ${reason}`);
+        }
+    }
+    // Check duplicate handles
+    const handleMap = new Map();
+    for (const entry of entries) {
+        const existing = handleMap.get(entry.handle);
+        if (existing) {
+            errors.push(`Duplicate handle "${entry.handle}": collision between ${existing.source} (${existing.method} ${existing.path}) and ${entry.source} (${entry.method} ${entry.path})`);
+        }
+        else {
+            handleMap.set(entry.handle, entry);
+        }
+    }
+    // Check duplicate operation IDs
+    const opIdMap = new Map();
+    for (const entry of entries) {
+        const existing = opIdMap.get(entry.operationId);
+        if (existing) {
+            errors.push(`Duplicate operation ID "${entry.operationId}": collision between ${existing.source} (${existing.handle}) and ${entry.source} (${entry.handle})`);
+        }
+        else {
+            opIdMap.set(entry.operationId, entry);
+        }
+    }
+    // Check method/path collisions (exact and parameter ambiguity)
+    const routePatternMap = new Map();
+    for (const entry of entries) {
+        const normalizedPath = normalizePathForCollision(entry.path);
+        const routeKey = `${entry.method} ${normalizedPath}`;
+        const existing = routePatternMap.get(routeKey);
+        if (existing) {
+            if (existing.path === entry.path) {
+                errors.push(`Exact method/path collision on ${entry.method} ${entry.path}: collision between ${existing.source} (${existing.handle}) and ${entry.source} (${entry.handle})`);
+            }
+            else {
+                errors.push(`Ambiguous parameter path collision on ${entry.method} (${existing.path} vs ${entry.path}): collision between ${existing.source} (${existing.handle}) and ${entry.source} (${entry.handle})`);
+            }
+        }
+        else {
+            routePatternMap.set(routeKey, entry);
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`[workerstack] Route registry validation failed (${errors.length} error(s)):\n` +
+            errors.join('\n'));
+    }
+    return { entries };
+}
+//# sourceMappingURL=registry.js.map

package/dist/api/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/api/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import { getOpenAPIMeta } from '@orpc/openapi'\n\nconst RESERVED_EXACT = new Set([\n  '/api/health',\n  '/api/readiness',\n  '/api/openapi.json',\n  '/api/realtime',\n  '/api/rpc',\n  '/api/auth',\n  '/api/files',\n])\nconst RESERVED_PREFIXES = ['/api/rpc/', '/api/auth/', '/api/files/']\n\nfunction collisionForWorkerstackPath(path: string): string | undefined {\n  if (RESERVED_EXACT.has(path)) return 'it is reserved by workerstack'\n  const prefix = RESERVED_PREFIXES.find((value) => path.startsWith(value))\n  return prefix ? `\"${prefix}*\" is reserved by workerstack` : undefined\n}\n\nexport interface ApiRegistryEntry {\n  handle: string\n  operationId: string\n  method: string\n  path: string\n  source: string\n}\n\nexport interface ApiRegistry {\n  entries: ApiRegistryEntry[]\n}\n\nexport interface ForeignSpecEntry {\n  spec: Record<string, unknown>\n  prefix?: string\n  source?: string\n}\n\nexport interface BuildApiRegistryOptions {\n  nativeRouter?: Record<string, unknown>\n  foreignSpecs?: Array<Record<string, unknown> | ForeignSpecEntry>\n  /** Native procedures generated by Workerstack itself may own reserved paths. */\n  reservedCoreHandles?: ReadonlySet<string>\n}\n\nconst HTTP_METHODS = new Set([\n  'GET',\n  'POST',\n  'PUT',\n  'PATCH',\n  'DELETE',\n  'HEAD',\n  'OPTIONS',\n])\n\nexport function normalizeApiPath(path: string, prefix?: string): string {\n  let cleanPath = path.startsWith('/') ? path : '/' + path\n  if (prefix) {\n    let cleanPrefix = prefix.startsWith('/') ? prefix : '/' + prefix\n    if (cleanPrefix.endsWith('/')) {\n      cleanPrefix = cleanPrefix.slice(0, -1)\n    }\n    if (cleanPath === cleanPrefix || cleanPath.startsWith(cleanPrefix + '/')) {\n      // Path already starts with prefix\n    } else {\n      cleanPath = cleanPrefix + cleanPath\n    }\n  }\n  return cleanPath.replace(/\\/+/g, '/')\n}\n\nexport interface ForeignSpecOptions {\n  prefix?: string\n  source?: string\n}\n\nexport function normalizeForeignOpenAPISpec(\n  spec: Record<string, unknown>,\n  options: ForeignSpecOptions = {},\n): Record<string, unknown> {\n  const prefix = options.prefix\n  const source = options.source\n  const cloned: Record<string, unknown> = JSON.parse(JSON.stringify(spec))\n\n  if (cloned.paths && typeof cloned.paths === 'object') {\n    const normalizedPaths: Record<string, unknown> = {}\n    for (const [routePath, pathItem] of Object.entries(\n      cloned.paths as Record<string, unknown>,\n    )) {\n      const canonicalPath = normalizeApiPath(routePath, prefix)\n      normalizedPaths[canonicalPath] = pathItem\n    }\n    cloned.paths = normalizedPaths\n  }\n\n  if (source) {\n    cloned['x-workerstack-source'] = source\n  }\n\n  return cloned\n}\n\nexport function mergeApiRoutersStrict(\n  target: Record<string, unknown>,\n  source?: Record<string, unknown>,\n  prefix: string[] = [],\n): Record<string, unknown> {\n  if (!source) return { ...target }\n  const result: Record<string, unknown> = { ...target }\n\n  for (const [key, val] of Object.entries(source)) {\n    const currentPath = [...prefix, key]\n    const handle = currentPath.join('.')\n    const targetVal = result[key]\n\n    if (targetVal !== undefined) {\n      const isTargetNamespace =\n        typeof targetVal === 'object' &&\n        targetVal !== null &&\n        !('~orpc' in targetVal)\n\n      const isSourceNamespace =\n        typeof val === 'object' && val !== null && !('~orpc' in val)\n\n      if (isTargetNamespace && isSourceNamespace) {\n        result[key] = mergeApiRoutersStrict(\n          targetVal as Record<string, unknown>,\n          val as Record<string, unknown>,\n          currentPath,\n        )\n      } else {\n        throw new Error(\n          `[workerstack] Router merge collision at handle \"${handle}\": duplicate procedure or namespace collision`,\n        )\n      }\n    } else {\n      result[key] = val\n    }\n  }\n\n  return result\n}\n\nfunction normalizePathSegments(path: string): string[] {\n  return path.split('/').filter(Boolean)\n}\n\nfunction isParamSegment(segment: string): boolean {\n  return (\n    (segment.startsWith('{') && segment.endsWith('}')) ||\n    segment.startsWith(':')\n  )\n}\n\nfunction normalizePathForCollision(path: string): string {\n  const segments = normalizePathSegments(path)\n  const normalized = segments.map((seg) =>\n    isParamSegment(seg) ? '{param}' : seg,\n  )\n  return '/' + normalized.join('/')\n}\n\nfunction walkNativeRouter(\n  obj: Record<string, unknown>,\n  pathSegments: string[] = [],\n): ApiRegistryEntry[] {\n  const entries: ApiRegistryEntry[] = []\n\n  for (const [key, value] of Object.entries(obj)) {\n    if (!value || typeof value !== 'object') continue\n    const currentSegments = [...pathSegments, key]\n\n    if ('~orpc' in value) {\n      const meta = (getOpenAPIMeta(value as any) || {}) as Record<\n        string,\n        unknown\n      >\n      const handle = currentSegments.join('.')\n      const method = ((meta.method as string) || 'GET').toUpperCase()\n      const routePath = (meta.path as string) || '/' + currentSegments.join('/')\n      const operationId =\n        typeof meta.operationId === 'string' ? meta.operationId : handle\n\n      entries.push({\n        handle,\n        operationId,\n        method,\n        path: routePath,\n        source: 'native',\n      })\n    } else {\n      entries.push(\n        ...walkNativeRouter(value as Record<string, unknown>, currentSegments),\n      )\n    }\n  }\n\n  return entries\n}\n\nfunction extractForeignEntries(\n  specs: Array<Record<string, unknown> | ForeignSpecEntry>,\n): ApiRegistryEntry[] {\n  const entries: ApiRegistryEntry[] = []\n\n  for (const item of specs) {\n    if (!item) continue\n    let specObj: Record<string, unknown>\n    let source = 'foreign'\n\n    if ('spec' in item && typeof item.spec === 'object' && item.spec !== null) {\n      const entry = item as ForeignSpecEntry\n      source = entry.source || 'foreign'\n      specObj = normalizeForeignOpenAPISpec(entry.spec, {\n        prefix: entry.prefix,\n        source,\n      })\n    } else {\n      const rawSpec = item as Record<string, unknown>\n      source = (rawSpec['x-workerstack-source'] as string) || 'foreign'\n      specObj = normalizeForeignOpenAPISpec(rawSpec, { source })\n    }\n\n    if (!specObj || typeof specObj.paths !== 'object' || !specObj.paths)\n      continue\n    const paths = specObj.paths as Record<string, Record<string, unknown>>\n\n    for (const [routePath, pathItem] of Object.entries(paths)) {\n      if (!pathItem || typeof pathItem !== 'object') continue\n\n      for (const [methodKey, operation] of Object.entries(pathItem)) {\n        const uppercaseMethod = methodKey.toUpperCase()\n        if (!HTTP_METHODS.has(uppercaseMethod)) continue\n        if (!operation || typeof operation !== 'object') continue\n\n        const op = operation as Record<string, unknown>\n        const handle = `foreign:${source}:${uppercaseMethod}:${routePath}`\n        const operationId =\n          typeof op.operationId === 'string' ? op.operationId : handle\n\n        entries.push({\n          handle,\n          operationId,\n          method: uppercaseMethod,\n          path: routePath,\n          source,\n        })\n      }\n    }\n  }\n\n  return entries\n}\n\nexport async function buildApiRegistry(\n  options: BuildApiRegistryOptions = {},\n): Promise<ApiRegistry> {\n  const entries: ApiRegistryEntry[] = []\n\n  if (options.nativeRouter) {\n    entries.push(...walkNativeRouter(options.nativeRouter))\n  }\n\n  if (options.foreignSpecs) {\n    entries.push(...extractForeignEntries(options.foreignSpecs))\n  }\n\n  const errors: string[] = []\n\n  for (const entry of entries) {\n    if (entry.source !== 'native') continue\n    if (options.reservedCoreHandles?.has(entry.handle)) continue\n    const reason = collisionForWorkerstackPath(entry.path)\n    if (reason) {\n      errors.push(\n        `Reserved route collision on ${entry.method} ${entry.path}: native handle \"${entry.handle}\" conflicts because ${reason}`,\n      )\n    }\n  }\n\n  // Check duplicate handles\n  const handleMap = new Map<string, ApiRegistryEntry>()\n  for (const entry of entries) {\n    const existing = handleMap.get(entry.handle)\n    if (existing) {\n      errors.push(\n        `Duplicate handle \"${entry.handle}\": collision between ${existing.source} (${existing.method} ${existing.path}) and ${entry.source} (${entry.method} ${entry.path})`,\n      )\n    } else {\n      handleMap.set(entry.handle, entry)\n    }\n  }\n\n  // Check duplicate operation IDs\n  const opIdMap = new Map<string, ApiRegistryEntry>()\n  for (const entry of entries) {\n    const existing = opIdMap.get(entry.operationId)\n    if (existing) {\n      errors.push(\n        `Duplicate operation ID \"${entry.operationId}\": collision between ${existing.source} (${existing.handle}) and ${entry.source} (${entry.handle})`,\n      )\n    } else {\n      opIdMap.set(entry.operationId, entry)\n    }\n  }\n\n  // Check method/path collisions (exact and parameter ambiguity)\n  const routePatternMap = new Map<string, ApiRegistryEntry>()\n  for (const entry of entries) {\n    const normalizedPath = normalizePathForCollision(entry.path)\n    const routeKey = `${entry.method} ${normalizedPath}`\n\n    const existing = routePatternMap.get(routeKey)\n    if (existing) {\n      if (existing.path === entry.path) {\n        errors.push(\n          `Exact method/path collision on ${entry.method} ${entry.path}: collision between ${existing.source} (${existing.handle}) and ${entry.source} (${entry.handle})`,\n        )\n      } else {\n        errors.push(\n          `Ambiguous parameter path collision on ${entry.method} (${existing.path} vs ${entry.path}): collision between ${existing.source} (${existing.handle}) and ${entry.source} (${entry.handle})`,\n        )\n      }\n    } else {\n      routePatternMap.set(routeKey, entry)\n    }\n  }\n\n  if (errors.length > 0) {\n    throw new Error(\n      `[workerstack] Route registry validation failed (${errors.length} error(s)):\\n` +\n        errors.join('\\n'),\n    )\n  }\n\n  return { entries }\n}\n"]}

package/dist/api/router.d.ts

@@ -0,0 +1,15 @@
+import '@orpc/openapi/extensions/route';
+import type { AnyMiddleware } from '@orpc/server';
+import type { ReadinessReport } from '../readiness.js';
+export interface BuildApiRouterOptions {
+    crud: Record<string, unknown>;
+    storage: Record<string, unknown>;
+    realtime?: Record<string, unknown>;
+    custom?: Record<string, unknown>;
+    /** Applied to every procedure in the graph, outermost first. */
+    middleware?: AnyMiddleware[];
+    /** Deployment readiness probe. Always answers 200; read `status` in the body. */
+    readiness: () => Promise<ReadinessReport>;
+}
+export declare function buildApiRouter(options: BuildApiRouterOptions): Record<string, unknown>;
+//# sourceMappingURL=router.d.ts.map

package/dist/api/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/api/router.ts"],"names":[],"mappings":"AAAA,OAAO,gCAAgC,CAAA;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAIjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAMnD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,gEAAgE;IAChE,UAAU,CAAC,EAAE,aAAa,EAAE,CAAA;IAC5B,iFAAiF;IACjF,SAAS,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAA;CAC1C;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,2BAsC5D"}

package/dist/api/router.js

@@ -0,0 +1,32 @@
+import '@orpc/openapi/extensions/route';
+import * as v from 'valibot';
+import { readinessReportSchema } from '../readiness.js';
+import { createApiBuilder } from './builder.js';
+import { mergeApiRoutersStrict } from './registry.js';
+export function buildApiRouter(options) {
+    const builder = createApiBuilder();
+    const health = builder.public
+        .route({ method: 'GET', path: '/api/health', tags: ['system'] })
+        .output(v.strictObject({ status: v.literal('ok') }))
+        .handler(() => ({ status: 'ok' }));
+    const readiness = builder.public
+        .route({ method: 'GET', path: '/api/readiness', tags: ['system'] })
+        .output(readinessReportSchema)
+        .handler(() => options.readiness());
+    const merged = [
+        { health, readiness },
+        options.crud,
+        options.storage,
+        options.realtime,
+        options.custom,
+    ].reduce((router, addition) => mergeApiRoutersStrict(router, addition), {});
+    const middleware = options.middleware ?? [];
+    if (middleware.length === 0)
+        return merged;
+    // `.router()` applies the builder's middleware to every procedure inside, so
+    // one list covers CRUD, storage, realtime, health, readiness, and custom procedures
+    // instead of only the bases an application happens to declare.
+    const withMiddleware = middleware.reduce((acc, mw) => acc.use(mw), builder.public);
+    return withMiddleware.router(merged);
+}
+//# sourceMappingURL=router.js.map

package/dist/api/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/api/router.ts"],"names":[],"mappings":"AAAA,OAAO,gCAAgC,CAAA;AAGvC,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAI5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAalD,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,MAAM,OAAO,GAAG,gBAAgB,EAG7B,CAAA;IACH,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM;SAC1B,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;SAC/D,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SACnD,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAa,EAAE,CAAC,CAAC,CAAA;IAE7C,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM;SAC7B,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;SAClE,MAAM,CAAC,qBAAqB,CAAC;SAC7B,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IAErC,MAAM,MAAM,GAAG;QACb,EAAE,MAAM,EAAE,SAAS,EAAE;QACrB,OAAO,CAAC,IAAI;QACZ,OAAO,CAAC,OAAO;QACf,OAAO,CAAC,QAAQ;QAChB,OAAO,CAAC,MAAM;KACf,CAAC,MAAM,CACN,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC7D,EAAE,CACH,CAAA;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAA;IAC3C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAA;IAE1C,6EAA6E;IAC7E,oFAAoF;IACpF,+DAA+D;IAC/D,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CACtC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAW,CAAC,EACjC,OAAO,CAAC,MAAM,CACf,CAAA;IAED,OAAO,cAAc,CAAC,MAAM,CAAC,MAAe,CAA4B,CAAA;AAC1E,CAAC","sourcesContent":["import '@orpc/openapi/extensions/route'\nimport type { AnyMiddleware } from '@orpc/server'\n\nimport * as v from 'valibot'\n\nimport type { ReadinessReport } from '../readiness'\n\nimport { readinessReportSchema } from '../readiness'\nimport { createApiBuilder } from './builder'\nimport { mergeApiRoutersStrict } from './registry'\n\nexport interface BuildApiRouterOptions {\n  crud: Record<string, unknown>\n  storage: Record<string, unknown>\n  realtime?: Record<string, unknown>\n  custom?: Record<string, unknown>\n  /** Applied to every procedure in the graph, outermost first. */\n  middleware?: AnyMiddleware[]\n  /** Deployment readiness probe. Always answers 200; read `status` in the body. */\n  readiness: () => Promise<ReadinessReport>\n}\n\nexport function buildApiRouter(options: BuildApiRouterOptions) {\n  const builder = createApiBuilder<\n    Record<string, unknown>,\n    Record<string, unknown>\n  >()\n  const health = builder.public\n    .route({ method: 'GET', path: '/api/health', tags: ['system'] })\n    .output(v.strictObject({ status: v.literal('ok') }))\n    .handler(() => ({ status: 'ok' as const }))\n\n  const readiness = builder.public\n    .route({ method: 'GET', path: '/api/readiness', tags: ['system'] })\n    .output(readinessReportSchema)\n    .handler(() => options.readiness())\n\n  const merged = [\n    { health, readiness },\n    options.crud,\n    options.storage,\n    options.realtime,\n    options.custom,\n  ].reduce<Record<string, unknown>>(\n    (router, addition) => mergeApiRoutersStrict(router, addition),\n    {},\n  )\n\n  const middleware = options.middleware ?? []\n  if (middleware.length === 0) return merged\n\n  // `.router()` applies the builder's middleware to every procedure inside, so\n  // one list covers CRUD, storage, realtime, health, readiness, and custom procedures\n  // instead of only the bases an application happens to declare.\n  const withMiddleware = middleware.reduce(\n    (acc, mw) => acc.use(mw as never),\n    builder.public,\n  )\n\n  return withMiddleware.router(merged as never) as Record<string, unknown>\n}\n"]}