@happyvertical/smrt-core 0.40.30 → 0.40.32

package/dist/manifest.json

@@ -1,8 +1,8 @@
 {
   "version": "1.0.0",
-  "timestamp": 1785184267949,
+  "timestamp": 1785316042517,
   "packageName": "@happyvertical/smrt-core",
-  "packageVersion": "0.40.30",
+  "packageVersion": "0.40.32",
   "objects": {
     "@happyvertical/smrt-core:SmrtClass": {
       "name": "smrtclass",

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prebuild/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAI5D,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACvC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAyUD;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAkBf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prebuild/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAQ5D,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACvC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAkCf;AA8VD;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/prebuild/index.js

@@ -1,5 +1,5 @@
 import { selectWebCollectionEntries } from "../vite-plugin/web-collections.js";
-import { selectApiClientEntries } from "../vite-plugin/api-client-entries.js";
+import { renderApiClientCrudType, renderApiClientCustomMethodParameters, selectApiClientEntries } from "../vite-plugin/api-client-entries.js";
 import * as fs from "node:fs";
 import * as path from "node:path";
 //#region src/prebuild/index.ts
@@ -127,8 +127,14 @@ declare module '@smrt/client' {
   }
 
   export interface ApiClient {
-${selectApiClientEntries(manifest).map(({ clientKey, dataInterfaceName }) => {
-		return `    ${clientKey}: CrudOperations<${dataInterfaceName}>;`;
+${selectApiClientEntries(manifest).map(({ clientKey, dataInterfaceName, crudMethods, customMethods }) => {
+		const crudType = renderApiClientCrudType(dataInterfaceName, crudMethods, customMethods.map(({ name }) => name));
+		const customSignatures = customMethods.map((method) => `      ${method.name}(${renderApiClientCustomMethodParameters(method, mapFieldTypeToTypeScript)}): Promise<any>;`).join("\n");
+		if (customSignatures) {
+			const intersection = crudType ? `${crudType} & ` : "";
+			return `    ${JSON.stringify(clientKey)}: ${intersection}{\n${customSignatures}\n    };`;
+		}
+		return `    ${JSON.stringify(clientKey)}: ${crudType ?? "Record<string, never>"};`;
 	}).join("\n")}
   }
 
@@ -240,7 +246,7 @@ declare module '@smrt/web' {
   }
 
   export interface SmrtWebCollectionDefinitions {
-${selectWebCollectionEntries(manifest).map(({ collection, obj }) => `    ${collection}: SmrtWebCollectionDefinition<import('./smrt-objects').${obj.className}Data>;`).join("\n")}
+${selectWebCollectionEntries(manifest).map(({ collection, obj }) => `    ${JSON.stringify(collection)}: SmrtWebCollectionDefinition<import('./smrt-objects').${obj.className}Data>;`).join("\n")}
   }
 
   export const collectionDefinitions: SmrtWebCollectionDefinitions;

package/dist/prebuild/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/prebuild/index.ts"],"sourcesContent":["/**\n * Pre-build utilities for generating TypeScript declarations\n * Solves virtual module resolution by creating physical .d.ts files\n */\n\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport type { SmartObjectManifest } from '../scanner/types';\nimport { selectApiClientEntries } from '../vite-plugin/api-client-entries.js';\nimport { selectWebCollectionEntries } from '../vite-plugin/web-collections.js';\n\nexport interface PrebuildOptions {\n  /** Path to manifest file or manifest object */\n  manifest: string | SmartObjectManifest;\n  /** Output directory for generated types */\n  outDir: string;\n  /** Include virtual module declarations */\n  includeVirtualModules?: boolean;\n  /** Include object type definitions */\n  includeObjectTypes?: boolean;\n  /** Project root path for resolving relative paths */\n  projectRoot?: string;\n}\n\n/**\n * Generate TypeScript declaration files from SMRT manifest\n */\nexport async function generateDeclarations(\n  options: PrebuildOptions,\n): Promise<void> {\n  const {\n    manifest: manifestInput,\n    outDir,\n    includeVirtualModules = true,\n    includeObjectTypes = true,\n    projectRoot = process.cwd(),\n  } = options;\n\n  // Load manifest\n  const manifest: SmartObjectManifest =\n    typeof manifestInput === 'string'\n      ? JSON.parse(fs.readFileSync(manifestInput, 'utf-8'))\n      : manifestInput;\n\n  // Ensure output directory exists\n  const fullOutDir = path.isAbsolute(outDir)\n    ? outDir\n    : path.join(projectRoot, outDir);\n  fs.mkdirSync(fullOutDir, { recursive: true });\n\n  console.log(`[smrt:prebuild] Generating declarations to ${fullOutDir}`);\n\n  if (includeObjectTypes) {\n    await generateObjectTypeDeclarations(manifest, fullOutDir);\n  }\n\n  if (includeVirtualModules) {\n    await generateVirtualModuleDeclarations(manifest, fullOutDir);\n  }\n\n  console.log(\n    `[smrt:prebuild] Generated declarations for ${Object.keys(manifest.objects).length} SMRT objects`,\n  );\n}\n\n/**\n * Generate TypeScript interfaces for SMRT objects\n */\nasync function generateObjectTypeDeclarations(\n  manifest: SmartObjectManifest,\n  outDir: string,\n): Promise<void> {\n  const interfaces: string[] = [];\n\n  // Generate interfaces for each discovered SMRT object\n  for (const [_objectName, objectMeta] of Object.entries(manifest.objects)) {\n    const fields = objectMeta.fields || {};\n    const propertyLines: string[] = [];\n\n    // Add standard SmrtObject properties\n    propertyLines.push('  id?: string;');\n    propertyLines.push('  created_at?: string;');\n    propertyLines.push('  updated_at?: string;');\n\n    // Add object-specific properties\n    for (const [fieldName, fieldDef] of Object.entries(fields)) {\n      const type = mapFieldTypeToTypeScript(fieldDef.type);\n      const optional = !fieldDef.required ? '?' : '';\n      propertyLines.push(`  ${fieldName}${optional}: ${type};`);\n    }\n\n    const interfaceDef = `export interface ${objectMeta.className}Data {\n${propertyLines.join('\\n')}\n}`;\n    interfaces.push(interfaceDef);\n  }\n\n  // Write object types file\n  const objectTypesContent = `/**\n * Auto-generated TypeScript interfaces for SMRT objects\n * Generated at build time from @smrt() decorated classes\n *\n * DO NOT EDIT THIS FILE MANUALLY\n */\n\n${interfaces.join('\\n\\n')}\n`;\n\n  fs.writeFileSync(path.join(outDir, 'smrt-objects.d.ts'), objectTypesContent);\n}\n\n/**\n * Generate virtual module declarations\n */\nasync function generateVirtualModuleDeclarations(\n  manifest: SmartObjectManifest,\n  outDir: string,\n): Promise<void> {\n  // Generate manifest module declaration\n  const manifestDeclaration = `/**\n * Auto-generated manifest module declaration\n */\ndeclare module '@smrt/manifest' {\n  export interface SmrtObjectField {\n    type: string;\n    required?: boolean;\n    default?: any;\n  }\n\n  export interface SmrtObjectMethod {\n    name: string;\n    parameters: Array<{\n      name: string;\n      type: string;\n      optional?: boolean;\n      default?: any;\n    }>;\n    returnType: string;\n    async: boolean;\n    isStatic: boolean;\n    isPublic: boolean;\n  }\n\n  export interface SmrtObjectDefinition {\n    name: string;\n    className: string;\n    collection: string;\n    filePath: string;\n    fields: Record<string, SmrtObjectField>;\n    methods: Record<string, SmrtObjectMethod>;\n    decoratorConfig: any;\n    extends?: string;\n  }\n\n  export interface SmrtManifest {\n    version: string;\n    timestamp: number;\n    objects: Record<string, SmrtObjectDefinition>;\n  }\n\n  export const manifest: SmrtManifest;\n  export default manifest;\n}`;\n\n  // Generate client module declaration\n  const apiClientInterface = selectApiClientEntries(manifest)\n    .map(({ clientKey, dataInterfaceName }) => {\n      return `    ${clientKey}: CrudOperations<${dataInterfaceName}>;`;\n    })\n    .join('\\n');\n\n  // Wire-shape policy (#1797): the server returns BARE JSON — a bare array for\n  // list/search, a bare object for get/create/update — with snake_case field\n  // names (created_at, updated_at). These declarations match that shape (no\n  // envelope, no camelCase) and are byte-identical to the vite-plugin client\n  // declaration. Fetchers reject on non-2xx with a SmrtClientError (#1796).\n  const clientDeclaration = `/**\n * Auto-generated API client module declaration\n */\ndeclare module '@smrt/client' {\n  /** Shape of a JSON error body carried by a rejected request (SmrtClientError.body). */\n  export interface ApiError {\n    error?: string;\n    message?: string;\n  }\n\n  /** Typed error thrown by every fetcher on a non-2xx response (#1796). */\n  export interface SmrtClientError extends Error {\n    name: 'SmrtClientError';\n    status: number;\n    body?: ApiError | string;\n  }\n\n  export interface CrudOperations<T = any> {\n    list(params?: Record<string, any>): Promise<T[]>;\n    get(id: string): Promise<T>;\n    create(data: Partial<T>): Promise<T>;\n    update(id: string, data: Partial<T>): Promise<T>;\n    delete(id: string): Promise<boolean>;\n    search(query: string): Promise<T[]>;\n  }\n\n  export interface ApiClient {\n${apiClientInterface}\n  }\n\n  export function createClient(basePath?: string): ApiClient;\n  export default createClient;\n}`;\n\n  // Generate routes module declaration\n  const routesDeclaration = `/**\n * Auto-generated routes module declaration\n */\ndeclare module '@smrt/routes' {\n  export interface RouteApp {\n    get(path: string, handler: (req: any, res: any) => void): void;\n    post(path: string, handler: (req: any, res: any) => void): void;\n    put(path: string, handler: (req: any, res: any) => void): void;\n    delete(path: string, handler: (req: any, res: any) => void): void;\n  }\n\n  export function setupRoutes(app: RouteApp): void;\n  export default setupRoutes;\n}`;\n\n  // Generate MCP module declaration\n  const mcpDeclaration = `/**\n * Auto-generated MCP module declaration\n */\ndeclare module '@smrt/mcp' {\n  export interface McpTool {\n    name: string;\n    description: string;\n    inputSchema: {\n      type: string;\n      properties: Record<string, any>;\n      required?: string[];\n    };\n  }\n\n  export const tools: McpTool[];\n  export function createMCPServer(): {\n    name: string;\n    version: string;\n    tools: McpTool[]\n  };\n  export default createMCPServer;\n}`;\n\n  // Generate types module declaration with object imports\n  const objectImports = Object.values(manifest.objects)\n    .map(\n      (obj) =>\n        `  export type ${obj.className}Data = import('./smrt-objects').${obj.className}Data;`,\n    )\n    .join('\\n');\n\n  const typesDeclaration = `/**\n * Auto-generated types module declaration\n */\ndeclare module '@smrt/types' {\n${objectImports}\n\n  export interface Request {\n    params: Record<string, string>;\n    query: Record<string, any>;\n    json(): Promise<any>;\n  }\n\n  export interface Response {\n    json(data: any, init?: { status?: number }): Response;\n    status(code: number): Response;\n  }\n}`;\n\n  // Generate web collection-definition module declaration (#1761). Selection\n  // shares selectWebCollectionEntries with the vite-plugin runtime module and\n  // its virt-web d.ts, so this `tsc`-only consumer declaration cannot drift\n  // from the emitted values.\n  const webCollectionEntries = selectWebCollectionEntries(manifest)\n    .map(\n      ({ collection, obj }) =>\n        `    ${collection}: SmrtWebCollectionDefinition<import('./smrt-objects').${obj.className}Data>;`,\n    )\n    .join('\\n');\n\n  const webDeclaration = `/**\n * Auto-generated web collection-definition module declaration (#1761)\n */\ndeclare module '@smrt/web' {\n  export interface SmrtWebFieldDefinition {\n    type: string;\n    required?: boolean;\n    default?: unknown;\n  }\n\n  export type SmrtWebRelationshipKind =\n    | 'foreignKey'\n    | 'crossPackageRef'\n    | 'oneToMany'\n    | 'manyToMany';\n\n  /**\n   * A manifest-derived edge to a sibling REST collection. Mutating this\n   * collection invalidates the caches of the collections named by these edges\n   * (#1761 relationship-derived invalidation).\n   */\n  export interface SmrtWebRelationship {\n    field: string;\n    kind: SmrtWebRelationshipKind;\n    relatedCollection: string;\n  }\n\n  /** A WebMCP/MCP tool descriptor for one collection action (#1812). */\n  export interface WebToolDescriptor {\n    action: string;\n    name: string;\n    description: string;\n    inputSchema: Record<string, unknown>;\n    readOnly: boolean;\n  }\n\n  export interface SmrtWebCollectionDefinition<TData = Record<string, unknown>> {\n    name: string;\n    className: string;\n    endpoint: string;\n    idField: string;\n    actions: string[];\n    fields: Record<string, SmrtWebFieldDefinition>;\n    /** Manifest-derived relationship edges to sibling REST collections. */\n    relationships: SmrtWebRelationship[];\n    /** WebMCP/MCP tool descriptors for the exposed actions (#1812). */\n    toolDescriptors: WebToolDescriptor[];\n    /** Phantom row-type carrier for inference — never present at runtime. */\n    _row?: TData;\n  }\n\n  export interface SmrtWebCollectionDefinitions {\n${webCollectionEntries}\n  }\n\n  export const collectionDefinitions: SmrtWebCollectionDefinitions;\n  export function getCollectionDefinition<\n    K extends keyof SmrtWebCollectionDefinitions,\n  >(name: K): SmrtWebCollectionDefinitions[K];\n  /**\n   * Build-time web-collection shape digest (#1764). A deterministic,\n   * replica-stable hash of the emitted collection definitions; a change means\n   * old persisted client rows may mis-hydrate. Consumers fold it into the\n   * durable persistence namespace and the version-awareness updateAvailable\n   * contract signal.\n   */\n  export const manifestHash: string;\n  export default collectionDefinitions;\n}`;\n\n  // Write all virtual module declarations\n  fs.writeFileSync(\n    path.join(outDir, 'smrt-manifest.d.ts'),\n    manifestDeclaration,\n  );\n  fs.writeFileSync(path.join(outDir, 'smrt-client.d.ts'), clientDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-routes.d.ts'), routesDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-mcp.d.ts'), mcpDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-types.d.ts'), typesDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-web.d.ts'), webDeclaration);\n}\n\n/**\n * Map SMRT field types to TypeScript types\n */\nfunction mapFieldTypeToTypeScript(smrtType: string): string {\n  switch (smrtType) {\n    case 'text':\n      return 'string';\n    case 'decimal':\n    case 'integer':\n      return 'number';\n    case 'boolean':\n      return 'boolean';\n    case 'datetime':\n      return 'string | Date';\n    case 'json':\n      return 'any';\n    case 'foreignKey':\n      return 'string';\n    default:\n      return 'any';\n  }\n}\n\n/**\n * CLI command for generating declarations\n */\nexport async function generateDeclarationsFromCLI(\n  args: string[],\n): Promise<void> {\n  const manifestPath = args[0];\n  const outDir = args[1] || 'src/types/generated';\n\n  if (!manifestPath) {\n    console.error('Usage: generate-declarations <manifest-path> [output-dir]');\n    process.exit(1);\n  }\n\n  if (!fs.existsSync(manifestPath)) {\n    console.error(`Manifest file not found: ${manifestPath}`);\n    process.exit(1);\n  }\n\n  await generateDeclarations({\n    manifest: manifestPath,\n    outDir,\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/prebuild/index.ts"],"sourcesContent":["/**\n * Pre-build utilities for generating TypeScript declarations\n * Solves virtual module resolution by creating physical .d.ts files\n */\n\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport type { SmartObjectManifest } from '../scanner/types';\nimport {\n  renderApiClientCrudType,\n  renderApiClientCustomMethodParameters,\n  selectApiClientEntries,\n} from '../vite-plugin/api-client-entries.js';\nimport { selectWebCollectionEntries } from '../vite-plugin/web-collections.js';\n\nexport interface PrebuildOptions {\n  /** Path to manifest file or manifest object */\n  manifest: string | SmartObjectManifest;\n  /** Output directory for generated types */\n  outDir: string;\n  /** Include virtual module declarations */\n  includeVirtualModules?: boolean;\n  /** Include object type definitions */\n  includeObjectTypes?: boolean;\n  /** Project root path for resolving relative paths */\n  projectRoot?: string;\n}\n\n/**\n * Generate TypeScript declaration files from SMRT manifest\n */\nexport async function generateDeclarations(\n  options: PrebuildOptions,\n): Promise<void> {\n  const {\n    manifest: manifestInput,\n    outDir,\n    includeVirtualModules = true,\n    includeObjectTypes = true,\n    projectRoot = process.cwd(),\n  } = options;\n\n  // Load manifest\n  const manifest: SmartObjectManifest =\n    typeof manifestInput === 'string'\n      ? JSON.parse(fs.readFileSync(manifestInput, 'utf-8'))\n      : manifestInput;\n\n  // Ensure output directory exists\n  const fullOutDir = path.isAbsolute(outDir)\n    ? outDir\n    : path.join(projectRoot, outDir);\n  fs.mkdirSync(fullOutDir, { recursive: true });\n\n  console.log(`[smrt:prebuild] Generating declarations to ${fullOutDir}`);\n\n  if (includeObjectTypes) {\n    await generateObjectTypeDeclarations(manifest, fullOutDir);\n  }\n\n  if (includeVirtualModules) {\n    await generateVirtualModuleDeclarations(manifest, fullOutDir);\n  }\n\n  console.log(\n    `[smrt:prebuild] Generated declarations for ${Object.keys(manifest.objects).length} SMRT objects`,\n  );\n}\n\n/**\n * Generate TypeScript interfaces for SMRT objects\n */\nasync function generateObjectTypeDeclarations(\n  manifest: SmartObjectManifest,\n  outDir: string,\n): Promise<void> {\n  const interfaces: string[] = [];\n\n  // Generate interfaces for each discovered SMRT object\n  for (const [_objectName, objectMeta] of Object.entries(manifest.objects)) {\n    const fields = objectMeta.fields || {};\n    const propertyLines: string[] = [];\n\n    // Add standard SmrtObject properties\n    propertyLines.push('  id?: string;');\n    propertyLines.push('  created_at?: string;');\n    propertyLines.push('  updated_at?: string;');\n\n    // Add object-specific properties\n    for (const [fieldName, fieldDef] of Object.entries(fields)) {\n      const type = mapFieldTypeToTypeScript(fieldDef.type);\n      const optional = !fieldDef.required ? '?' : '';\n      propertyLines.push(`  ${fieldName}${optional}: ${type};`);\n    }\n\n    const interfaceDef = `export interface ${objectMeta.className}Data {\n${propertyLines.join('\\n')}\n}`;\n    interfaces.push(interfaceDef);\n  }\n\n  // Write object types file\n  const objectTypesContent = `/**\n * Auto-generated TypeScript interfaces for SMRT objects\n * Generated at build time from @smrt() decorated classes\n *\n * DO NOT EDIT THIS FILE MANUALLY\n */\n\n${interfaces.join('\\n\\n')}\n`;\n\n  fs.writeFileSync(path.join(outDir, 'smrt-objects.d.ts'), objectTypesContent);\n}\n\n/**\n * Generate virtual module declarations\n */\nasync function generateVirtualModuleDeclarations(\n  manifest: SmartObjectManifest,\n  outDir: string,\n): Promise<void> {\n  // Generate manifest module declaration\n  const manifestDeclaration = `/**\n * Auto-generated manifest module declaration\n */\ndeclare module '@smrt/manifest' {\n  export interface SmrtObjectField {\n    type: string;\n    required?: boolean;\n    default?: any;\n  }\n\n  export interface SmrtObjectMethod {\n    name: string;\n    parameters: Array<{\n      name: string;\n      type: string;\n      optional?: boolean;\n      default?: any;\n    }>;\n    returnType: string;\n    async: boolean;\n    isStatic: boolean;\n    isPublic: boolean;\n  }\n\n  export interface SmrtObjectDefinition {\n    name: string;\n    className: string;\n    collection: string;\n    filePath: string;\n    fields: Record<string, SmrtObjectField>;\n    methods: Record<string, SmrtObjectMethod>;\n    decoratorConfig: any;\n    extends?: string;\n  }\n\n  export interface SmrtManifest {\n    version: string;\n    timestamp: number;\n    objects: Record<string, SmrtObjectDefinition>;\n  }\n\n  export const manifest: SmrtManifest;\n  export default manifest;\n}`;\n\n  // Generate client module declaration\n  const apiClientInterface = selectApiClientEntries(manifest)\n    .map(({ clientKey, dataInterfaceName, crudMethods, customMethods }) => {\n      const overriddenMethods = customMethods.map(({ name }) => name);\n      const crudType = renderApiClientCrudType(\n        dataInterfaceName,\n        crudMethods,\n        overriddenMethods,\n      );\n      const customSignatures = customMethods\n        .map(\n          (method) =>\n            `      ${method.name}(${renderApiClientCustomMethodParameters(\n              method,\n              mapFieldTypeToTypeScript,\n            )}): Promise<any>;`,\n        )\n        .join('\\n');\n\n      if (customSignatures) {\n        const intersection = crudType ? `${crudType} & ` : '';\n        return `    ${JSON.stringify(clientKey)}: ${intersection}{\\n${customSignatures}\\n    };`;\n      }\n\n      return `    ${JSON.stringify(clientKey)}: ${crudType ?? 'Record<string, never>'};`;\n    })\n    .join('\\n');\n\n  // Wire-shape policy (#1797): the server returns BARE JSON — a bare array for\n  // list/search, a bare object for get/create/update — with snake_case field\n  // names (created_at, updated_at). These physical declarations share client\n  // entry selection and method-signature rendering with the Vite declaration.\n  // Fetchers reject on non-2xx with a SmrtClientError (#1796).\n  const clientDeclaration = `/**\n * Auto-generated API client module declaration\n */\ndeclare module '@smrt/client' {\n  /** Shape of a JSON error body carried by a rejected request (SmrtClientError.body). */\n  export interface ApiError {\n    error?: string;\n    message?: string;\n  }\n\n  /** Typed error thrown by every fetcher on a non-2xx response (#1796). */\n  export interface SmrtClientError extends Error {\n    name: 'SmrtClientError';\n    status: number;\n    body?: ApiError | string;\n  }\n\n  export interface CrudOperations<T = any> {\n    list(params?: Record<string, any>): Promise<T[]>;\n    get(id: string): Promise<T>;\n    create(data: Partial<T>): Promise<T>;\n    update(id: string, data: Partial<T>): Promise<T>;\n    delete(id: string): Promise<boolean>;\n    search(query: string): Promise<T[]>;\n  }\n\n  export interface ApiClient {\n${apiClientInterface}\n  }\n\n  export function createClient(basePath?: string): ApiClient;\n  export default createClient;\n}`;\n\n  // Generate routes module declaration\n  const routesDeclaration = `/**\n * Auto-generated routes module declaration\n */\ndeclare module '@smrt/routes' {\n  export interface RouteApp {\n    get(path: string, handler: (req: any, res: any) => void): void;\n    post(path: string, handler: (req: any, res: any) => void): void;\n    put(path: string, handler: (req: any, res: any) => void): void;\n    delete(path: string, handler: (req: any, res: any) => void): void;\n  }\n\n  export function setupRoutes(app: RouteApp): void;\n  export default setupRoutes;\n}`;\n\n  // Generate MCP module declaration\n  const mcpDeclaration = `/**\n * Auto-generated MCP module declaration\n */\ndeclare module '@smrt/mcp' {\n  export interface McpTool {\n    name: string;\n    description: string;\n    inputSchema: {\n      type: string;\n      properties: Record<string, any>;\n      required?: string[];\n    };\n  }\n\n  export const tools: McpTool[];\n  export function createMCPServer(): {\n    name: string;\n    version: string;\n    tools: McpTool[]\n  };\n  export default createMCPServer;\n}`;\n\n  // Generate types module declaration with object imports\n  const objectImports = Object.values(manifest.objects)\n    .map(\n      (obj) =>\n        `  export type ${obj.className}Data = import('./smrt-objects').${obj.className}Data;`,\n    )\n    .join('\\n');\n\n  const typesDeclaration = `/**\n * Auto-generated types module declaration\n */\ndeclare module '@smrt/types' {\n${objectImports}\n\n  export interface Request {\n    params: Record<string, string>;\n    query: Record<string, any>;\n    json(): Promise<any>;\n  }\n\n  export interface Response {\n    json(data: any, init?: { status?: number }): Response;\n    status(code: number): Response;\n  }\n}`;\n\n  // Generate web collection-definition module declaration (#1761). Selection\n  // shares selectWebCollectionEntries with the vite-plugin runtime module and\n  // its virt-web d.ts, so this `tsc`-only consumer declaration cannot drift\n  // from the emitted values.\n  const webCollectionEntries = selectWebCollectionEntries(manifest)\n    .map(\n      ({ collection, obj }) =>\n        `    ${JSON.stringify(collection)}: SmrtWebCollectionDefinition<import('./smrt-objects').${obj.className}Data>;`,\n    )\n    .join('\\n');\n\n  const webDeclaration = `/**\n * Auto-generated web collection-definition module declaration (#1761)\n */\ndeclare module '@smrt/web' {\n  export interface SmrtWebFieldDefinition {\n    type: string;\n    required?: boolean;\n    default?: unknown;\n  }\n\n  export type SmrtWebRelationshipKind =\n    | 'foreignKey'\n    | 'crossPackageRef'\n    | 'oneToMany'\n    | 'manyToMany';\n\n  /**\n   * A manifest-derived edge to a sibling REST collection. Mutating this\n   * collection invalidates the caches of the collections named by these edges\n   * (#1761 relationship-derived invalidation).\n   */\n  export interface SmrtWebRelationship {\n    field: string;\n    kind: SmrtWebRelationshipKind;\n    relatedCollection: string;\n  }\n\n  /** A WebMCP/MCP tool descriptor for one collection action (#1812). */\n  export interface WebToolDescriptor {\n    action: string;\n    name: string;\n    description: string;\n    inputSchema: Record<string, unknown>;\n    readOnly: boolean;\n  }\n\n  export interface SmrtWebCollectionDefinition<TData = Record<string, unknown>> {\n    name: string;\n    className: string;\n    endpoint: string;\n    idField: string;\n    actions: string[];\n    fields: Record<string, SmrtWebFieldDefinition>;\n    /** Manifest-derived relationship edges to sibling REST collections. */\n    relationships: SmrtWebRelationship[];\n    /** WebMCP/MCP tool descriptors for the exposed actions (#1812). */\n    toolDescriptors: WebToolDescriptor[];\n    /** Phantom row-type carrier for inference — never present at runtime. */\n    _row?: TData;\n  }\n\n  export interface SmrtWebCollectionDefinitions {\n${webCollectionEntries}\n  }\n\n  export const collectionDefinitions: SmrtWebCollectionDefinitions;\n  export function getCollectionDefinition<\n    K extends keyof SmrtWebCollectionDefinitions,\n  >(name: K): SmrtWebCollectionDefinitions[K];\n  /**\n   * Build-time web-collection shape digest (#1764). A deterministic,\n   * replica-stable hash of the emitted collection definitions; a change means\n   * old persisted client rows may mis-hydrate. Consumers fold it into the\n   * durable persistence namespace and the version-awareness updateAvailable\n   * contract signal.\n   */\n  export const manifestHash: string;\n  export default collectionDefinitions;\n}`;\n\n  // Write all virtual module declarations\n  fs.writeFileSync(\n    path.join(outDir, 'smrt-manifest.d.ts'),\n    manifestDeclaration,\n  );\n  fs.writeFileSync(path.join(outDir, 'smrt-client.d.ts'), clientDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-routes.d.ts'), routesDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-mcp.d.ts'), mcpDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-types.d.ts'), typesDeclaration);\n  fs.writeFileSync(path.join(outDir, 'smrt-web.d.ts'), webDeclaration);\n}\n\n/**\n * Map SMRT field types to TypeScript types\n */\nfunction mapFieldTypeToTypeScript(smrtType: string): string {\n  switch (smrtType) {\n    case 'text':\n      return 'string';\n    case 'decimal':\n    case 'integer':\n      return 'number';\n    case 'boolean':\n      return 'boolean';\n    case 'datetime':\n      return 'string | Date';\n    case 'json':\n      return 'any';\n    case 'foreignKey':\n      return 'string';\n    default:\n      return 'any';\n  }\n}\n\n/**\n * CLI command for generating declarations\n */\nexport async function generateDeclarationsFromCLI(\n  args: string[],\n): Promise<void> {\n  const manifestPath = args[0];\n  const outDir = args[1] || 'src/types/generated';\n\n  if (!manifestPath) {\n    console.error('Usage: generate-declarations <manifest-path> [output-dir]');\n    process.exit(1);\n  }\n\n  if (!fs.existsSync(manifestPath)) {\n    console.error(`Manifest file not found: ${manifestPath}`);\n    process.exit(1);\n  }\n\n  await generateDeclarations({\n    manifest: manifestPath,\n    outDir,\n  });\n}\n"],"mappings":"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"}

package/dist/smrt-knowledge.json

@@ -1,13 +1,13 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-07-27T20:31:05.220Z",
+  "generatedAt": "2026-07-29T09:07:20.134Z",
   "packageName": "@happyvertical/smrt-core",
-  "packageVersion": "0.40.30",
+  "packageVersion": "0.40.32",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "27307a21ff0503c0589fb7f431984423138d028f0abd81824716b75e0738b505",
-    "packageJson": "711006e436ca2af9d3b0a2f83198d977976e744f5948b0e82afbe3f5ca38a532",
+    "manifest": "067b1ae83c5ce6e57e3187d246bf1c305f87396c6cbe5ac97558be3be921cd73",
+    "packageJson": "0dbefcf5a26b9150c323c63b171017d49391710c93b99674517e360036a88ce9",
     "agents": "aaa49a751f2ad8c46ae7bbdb0e1f006037246830f14fea8ac4be150b8e7463ca",
     "moduleDoc:agents/change-feed.md": "5278797d6c049ea21071b011182a9fcd79d17f9d74e0f90a93caa4c05c25294f",
     "moduleDoc:agents/change-signals.md": "d9cb6a5541728ffea46607a6b1d4fa61d4621849f2b4ea86a0645fbb0af892e9",

package/dist/system/compatibility.d.ts

@@ -18,6 +18,18 @@ export interface PostgresSystemTimestampMigrationConfirmation {
      */
     legacyTimezone: 'UTC';
 }
+export interface PostgresSystemTimestampMigrationPlan {
+    kind: 'column' | 'change-feed-function';
+    tableName: string;
+    columnName?: string;
+    sql: string;
+}
+/**
+ * Read-only plan for the framework-owned timestamp conversion. This is kept
+ * separate from the atomic mutator so CLI dry-runs can report every ALTER
+ * without bootstrapping or changing framework tables.
+ */
+export declare function planPostgresSystemTimestampMigrations(db: DatabaseInterface, confirmation: PostgresSystemTimestampMigrationConfirmation, typeHint?: string): Promise<PostgresSystemTimestampMigrationPlan[]>;
 /**
  * Fail closed when framework-owned PostgreSQL tables still contain legacy
  * timezone-naive timestamps. Call this before recording the current system

package/dist/system/compatibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../src/system/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AA6BtD,wBAAsB,WAAW,CAC/B,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAgBlB;AA+BD,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,iBAAiB,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU,CAAC,OAAO,YAAY,CAAC,CAMjC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,4CAA4C;IAC3D;;;OAGG;IACH,cAAc,EAAE,KAAK,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,qCAAqC,CACzD,EAAE,EAAE,iBAAiB,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,wBAAsB,+BAA+B,CACnD,EAAE,EAAE,iBAAiB,EACrB,YAAY,EAAE,4CAA4C,EAC1D,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAyUD,wBAAsB,sCAAsC,CAC1D,EAAE,EAAE,iBAAiB,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED,wBAAsB,mDAAmD,CACvE,EAAE,EAAE,iBAAiB,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,wBAAsB,kCAAkC,CACtD,EAAE,EAAE,iBAAiB,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,uCAAuC,CAC3D,EAAE,EAAE,iBAAiB,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED,wBAAsB,oCAAoC,CACxD,EAAE,EAAE,iBAAiB,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAKf"}
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../src/system/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AA6BtD,wBAAsB,WAAW,CAC/B,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAgBlB;AA+BD,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,iBAAiB,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU,CAAC,OAAO,YAAY,CAAC,CAMjC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,4CAA4C;IAC3D;;;OAGG;IACH,cAAc,EAAE,KAAK,CAAC;CACvB;AAED,MAAM,WAAW,oCAAoC;IACnD,IAAI,EAAE,QAAQ,GAAG,sBAAsB,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAMD;;;;GAIG;AACH,wBAAsB,qCAAqC,CACzD,EAAE,EAAE,iBAAiB,EACrB,YAAY,EAAE,4CAA4C,EAC1D,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,oCAAoC,EAAE,CAAC,CA8DjD;AAED;;;;GAIG;AACH,wBAAsB,qCAAqC,CACzD,EAAE,EAAE,iBAAiB,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,wBAAsB,+BAA+B,CACnD,EAAE,EAAE,iBAAiB,EACrB,YAAY,EAAE,4CAA4C,EAC1D,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAyUD,wBAAsB,sCAAsC,CAC1D,EAAE,EAAE,iBAAiB,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED,wBAAsB,mDAAmD,CACvE,EAAE,EAAE,iBAAiB,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,wBAAsB,kCAAkC,CACtD,EAAE,EAAE,iBAAiB,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,uCAAuC,CAC3D,EAAE,EAAE,iBAAiB,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED,wBAAsB,oCAAoC,CACxD,EAAE,EAAE,iBAAiB,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/system/compatibility.js

@@ -34,6 +34,55 @@ function getDatabaseEngine(db, typeHint) {
 	const dbWithConfig = db;
 	return detectEngine(getDatabaseUrl(db), typeHint || dbWithConfig.type || dbWithConfig.config?.type);
 }
+function quotePostgresIdentifier(identifier) {
+	return `"${identifier.replaceAll("\"", "\"\"")}"`;
+}
+/**
+* Read-only plan for the framework-owned timestamp conversion. This is kept
+* separate from the atomic mutator so CLI dry-runs can report every ALTER
+* without bootstrapping or changing framework tables.
+*/
+async function planPostgresSystemTimestampMigrations(db, confirmation, typeHint) {
+	if (getDatabaseEngine(db, typeHint) !== "postgres") return [];
+	if (confirmation.legacyTimezone !== "UTC") throw new Error("Legacy SMRT system timestamp migration requires an explicit UTC provenance confirmation");
+	const session = getQueryRows(await db.query(`
+      SELECT
+        current_setting('TimeZone') AS timezone,
+        to_regprocedure('${LEGACY_POSTGRES_CHANGE_FEED_APPEND_FUNCTION_IDENTITY}')
+          IS NOT NULL AS legacy_change_feed_function_exists
+    `))[0] ?? {};
+	const timezone = String(session.timezone ?? "").toUpperCase();
+	if (![
+		"UTC",
+		"ETC/UTC",
+		"GMT"
+	].includes(timezone)) throw new Error(`Refusing to preview legacy SMRT timestamp migration outside a UTC PostgreSQL session (current TimeZone: ${String(session.timezone ?? "unknown")})`);
+	const plans = getQueryRows(await db.query(`
+      SELECT table_name, column_name
+      FROM information_schema.columns
+      WHERE table_schema = current_schema()
+        AND table_name LIKE '\\_smrt\\_%' ESCAPE '\\'
+        AND data_type = 'timestamp without time zone'
+      ORDER BY table_name, ordinal_position
+    `)).map((row) => {
+		const tableName = String(row.table_name);
+		const columnName = String(row.column_name);
+		const table = quotePostgresIdentifier(tableName);
+		const column = quotePostgresIdentifier(columnName);
+		return {
+			kind: "column",
+			tableName,
+			columnName,
+			sql: `ALTER TABLE ${table} ALTER COLUMN ${column} TYPE TIMESTAMPTZ USING ${column} AT TIME ZONE 'UTC'`
+		};
+	});
+	if (session.legacy_change_feed_function_exists === true || session.legacy_change_feed_function_exists === "t" || session.legacy_change_feed_function_exists === "true" || session.legacy_change_feed_function_exists === 1) plans.push({
+		kind: "change-feed-function",
+		tableName: "_smrt_changes",
+		sql: `DROP FUNCTION IF EXISTS ${LEGACY_POSTGRES_CHANGE_FEED_APPEND_FUNCTION_IDENTITY};\n${CREATE_POSTGRES_CHANGE_FEED_APPEND_FUNCTION.trim()}`
+	});
+	return plans;
+}
 /**
 * Fail closed when framework-owned PostgreSQL tables still contain legacy
 * timezone-naive timestamps. Call this before recording the current system
@@ -83,7 +132,7 @@ async function migratePostgresSystemTimestamps(db, confirmation, typeHint) {
           target.column_name
         );
       END LOOP;
-      IF to_regclass('_smrt_changes') IS NOT NULL THEN
+      IF to_regprocedure('${LEGACY_POSTGRES_CHANGE_FEED_APPEND_FUNCTION_IDENTITY}') IS NOT NULL THEN
         DROP FUNCTION IF EXISTS ${LEGACY_POSTGRES_CHANGE_FEED_APPEND_FUNCTION_IDENTITY};
         EXECUTE $smrt_change_feed_ddl$
 ${CREATE_POSTGRES_CHANGE_FEED_APPEND_FUNCTION.trim()}
@@ -291,6 +340,6 @@ async function ensureLegacySystemTableCompatibility(db, typeHint) {
 	await ensureJobEventsSystemTableCompatibility(db, typeHint);
 }
 //#endregion
-export { assertPostgresSystemTimestampsCurrent, ensureDispatchSubscriptionsSystemTableCompatibility, ensureDispatchSystemTableCompatibility, ensureJobEventsSystemTableCompatibility, ensureJobsSystemTableCompatibility, ensureLegacySystemTableCompatibility, getDatabaseEngine, migratePostgresSystemTimestamps, tableExists };
+export { assertPostgresSystemTimestampsCurrent, ensureDispatchSubscriptionsSystemTableCompatibility, ensureDispatchSystemTableCompatibility, ensureJobEventsSystemTableCompatibility, ensureJobsSystemTableCompatibility, ensureLegacySystemTableCompatibility, getDatabaseEngine, migratePostgresSystemTimestamps, planPostgresSystemTimestampMigrations, tableExists };
 
 //# sourceMappingURL=compatibility.js.map

package/dist/system/compatibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"compatibility.js","names":[],"sources":["../../src/system/compatibility.ts"],"sourcesContent":["import type { DatabaseInterface } from '@happyvertical/sql';\nimport { detectEngine } from '../schema/ddl/index.js';\nimport {\n  CREATE_POSTGRES_CHANGE_FEED_APPEND_FUNCTION,\n  LEGACY_POSTGRES_CHANGE_FEED_APPEND_FUNCTION_IDENTITY,\n} from './schema.js';\n\ntype DatabaseWithConfig = DatabaseInterface & {\n  config?: {\n    type?: string;\n    url?: string;\n  };\n  type?: string;\n};\n\nfunction getQueryRows(result: unknown): Record<string, unknown>[] {\n  if (Array.isArray(result)) {\n    return result as Record<string, unknown>[];\n  }\n\n  if (result && typeof result === 'object' && 'rows' in result) {\n    const rows = (result as { rows?: unknown }).rows;\n    if (Array.isArray(rows)) {\n      return rows as Record<string, unknown>[];\n    }\n  }\n\n  return [];\n}\n\nexport async function tableExists(\n  db: DatabaseInterface,\n  tableName: string,\n  typeHint?: string,\n): Promise<boolean> {\n  try {\n    const engine = getDatabaseEngine(db, typeHint);\n    if (engine === 'postgres') {\n      const result = await db.query(\n        'SELECT 1 FROM information_schema.tables WHERE table_schema = current_schema() AND table_name = $1 LIMIT 1',\n        tableName,\n      );\n      return getQueryRows(result).length > 0;\n    }\n\n    await db.query(`SELECT 1 FROM ${tableName} LIMIT 1`);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function columnExists(\n  db: DatabaseInterface,\n  tableName: string,\n  columnName: string,\n  typeHint?: string,\n): Promise<boolean> {\n  try {\n    const engine = getDatabaseEngine(db, typeHint);\n    if (engine === 'postgres') {\n      const result = await db.query(\n        'SELECT 1 FROM information_schema.columns WHERE table_schema = current_schema() AND table_name = $1 AND column_name = $2 LIMIT 1',\n        tableName,\n        columnName,\n      );\n      return getQueryRows(result).length > 0;\n    }\n\n    const result = await db.query(`PRAGMA table_info(${tableName})`);\n    return getQueryRows(result).some((row) => row.name === columnName);\n  } catch {\n    return false;\n  }\n}\n\nfunction getDatabaseUrl(db: DatabaseInterface): string {\n  const dbWithConfig = db as DatabaseWithConfig;\n  return db.url || dbWithConfig.config?.url || '';\n}\n\nexport function getDatabaseEngine(\n  db: DatabaseInterface,\n  typeHint?: string,\n): ReturnType<typeof detectEngine> {\n  const dbWithConfig = db as DatabaseWithConfig;\n  return detectEngine(\n    getDatabaseUrl(db),\n    typeHint || dbWithConfig.type || dbWithConfig.config?.type,\n  );\n}\n\n/**\n * Upgrade framework-owned PostgreSQL timestamp columns to instant-safe storage.\n *\n * Legacy SMRT and system writers serialized instants as UTC wall times. The\n * conversion is intentionally fail-closed unless the migration session is UTC:\n * operators must first confirm that historical database-default/raw writers\n * also used UTC. A deployment with non-UTC legacy writers needs an explicit,\n * provenance-aware data migration rather than a guessed offset.\n */\nexport interface PostgresSystemTimestampMigrationConfirmation {\n  /**\n   * Explicitly confirmed timezone used by every historical writer of legacy\n   * timezone-naive system timestamps. Only UTC is supported by this helper.\n   */\n  legacyTimezone: 'UTC';\n}\n\n/**\n * Fail closed when framework-owned PostgreSQL tables still contain legacy\n * timezone-naive timestamps. Call this before recording the current system\n * schema version so a partial installation cannot be stamped as upgraded.\n */\nexport async function assertPostgresSystemTimestampsCurrent(\n  db: DatabaseInterface,\n  typeHint?: string,\n): Promise<void> {\n  if (getDatabaseEngine(db, typeHint) !== 'postgres') return;\n\n  const rows = getQueryRows(\n    await db.query(`\n      SELECT table_name, column_name\n      FROM information_schema.columns\n      WHERE table_schema = current_schema()\n        AND table_name LIKE '\\\\_smrt\\\\_%' ESCAPE '\\\\'\n        AND data_type = 'timestamp without time zone'\n      ORDER BY table_name, ordinal_position\n    `),\n  );\n  if (rows.length === 0) return;\n\n  const columns = rows\n    .map((row) => `${String(row.table_name)}.${String(row.column_name)}`)\n    .join(', ');\n  throw new Error(\n    `Legacy SMRT system timestamps remain (${columns}); run the explicit audited migratePostgresSystemTimestamps() migration before bootstrap`,\n  );\n}\n\nexport async function migratePostgresSystemTimestamps(\n  db: DatabaseInterface,\n  confirmation: PostgresSystemTimestampMigrationConfirmation,\n  typeHint?: string,\n): Promise<void> {\n  if (getDatabaseEngine(db, typeHint) !== 'postgres') return;\n  if (confirmation.legacyTimezone !== 'UTC') {\n    throw new Error(\n      'Legacy SMRT system timestamp migration requires an explicit UTC provenance confirmation',\n    );\n  }\n\n  // One server-side statement makes the catalog change atomic and holds the\n  // same transaction-scoped lock used by system bootstrap. Any failing column\n  // rolls back every preceding ALTER in the block.\n  await db.query(`\n    DO $smrt_migrate_system_timestamps$\n    DECLARE\n      target RECORD;\n    BEGIN\n      PERFORM pg_advisory_xact_lock(\n        hashtext('smrt'),\n        hashtext('system-tables')\n      );\n      IF upper(current_setting('TimeZone')) NOT IN ('UTC', 'ETC/UTC', 'GMT') THEN\n        RAISE EXCEPTION 'Refusing to reinterpret legacy SMRT timestamps outside a UTC PostgreSQL session; confirm historical writers used UTC and SET TIME ZONE UTC';\n      END IF;\n      FOR target IN\n        SELECT table_name, column_name\n        FROM information_schema.columns\n        WHERE table_schema = current_schema()\n          AND table_name LIKE '\\\\_smrt\\\\_%' ESCAPE '\\\\'\n          AND data_type = 'timestamp without time zone'\n        ORDER BY table_name, ordinal_position\n      LOOP\n        EXECUTE format(\n          'ALTER TABLE %I ALTER COLUMN %I TYPE TIMESTAMPTZ USING %I AT TIME ZONE ''UTC''',\n          target.table_name,\n          target.column_name,\n          target.column_name\n        );\n      END LOOP;\n      IF to_regclass('_smrt_changes') IS NOT NULL THEN\n        DROP FUNCTION IF EXISTS ${LEGACY_POSTGRES_CHANGE_FEED_APPEND_FUNCTION_IDENTITY};\n        EXECUTE $smrt_change_feed_ddl$\n${CREATE_POSTGRES_CHANGE_FEED_APPEND_FUNCTION.trim()}\n$smrt_change_feed_ddl$;\n      END IF;\n    END;\n    $smrt_migrate_system_timestamps$;\n  `);\n}\n\nfunction isDuplicateColumnError(error: unknown): boolean {\n  const message =\n    error && typeof error === 'object'\n      ? String((error as { message?: unknown }).message || error)\n      : String(error);\n\n  return (\n    /column .*already exists/i.test(message) ||\n    /duplicate column name/i.test(message)\n  );\n}\n\nfunction collectErrorDetails(\n  error: unknown,\n  seen = new Set<unknown>(),\n): {\n  codes: Set<string>;\n  messages: string[];\n} {\n  const codes = new Set<string>();\n  const messages: string[] = [];\n\n  if (!error || seen.has(error)) {\n    return { codes, messages };\n  }\n\n  seen.add(error);\n\n  if (typeof error === 'object') {\n    const errorRecord = error as Record<string, unknown>;\n\n    if (typeof errorRecord.code === 'string') {\n      codes.add(errorRecord.code);\n    }\n\n    for (const messageKey of ['message', 'detail']) {\n      if (typeof errorRecord[messageKey] === 'string') {\n        messages.push(errorRecord[messageKey]);\n      }\n    }\n\n    for (const nestedKey of ['cause', 'context', 'originalError']) {\n      const nested = collectErrorDetails(errorRecord[nestedKey], seen);\n      for (const code of nested.codes) {\n        codes.add(code);\n      }\n      messages.push(...nested.messages);\n    }\n  } else {\n    messages.push(String(error));\n  }\n\n  return { codes, messages };\n}\n\nfunction isDuplicateIndexRaceError(error: unknown, indexName: string): boolean {\n  const { codes, messages } = collectErrorDetails(error);\n  const message = messages.join('\\n').toLowerCase();\n  const normalizedIndexName = indexName.toLowerCase();\n  const hasDuplicateCode =\n    codes.has('23505') || /\\bcode\\s*=\\s*23505\\b/.test(message);\n  const hasRelationExistsCode =\n    codes.has('42P07') || /\\bcode\\s*=\\s*42p07\\b/i.test(message);\n\n  if (!message.includes(normalizedIndexName)) {\n    return false;\n  }\n\n  if (hasDuplicateCode && message.includes('pg_class_relname_nsp_index')) {\n    return true;\n  }\n\n  if (hasRelationExistsCode && /relation .*already exists/i.test(message)) {\n    return true;\n  }\n\n  return false;\n}\n\nasync function addColumnIfMissing(\n  db: DatabaseInterface,\n  tableName: string,\n  columnName: string,\n  definition: string,\n  typeHint?: string,\n): Promise<void> {\n  const engine = getDatabaseEngine(db, typeHint);\n\n  if (engine === 'postgres') {\n    if (await columnExists(db, tableName, columnName, typeHint)) {\n      return;\n    }\n\n    await db.query(\n      `ALTER TABLE ${tableName} ADD COLUMN IF NOT EXISTS ${columnName} ${definition}`,\n    );\n    return;\n  }\n\n  if (await columnExists(db, tableName, columnName, typeHint)) {\n    return;\n  }\n\n  try {\n    await db.query(\n      `ALTER TABLE ${tableName} ADD COLUMN ${columnName} ${definition}`,\n    );\n  } catch (error) {\n    if (isDuplicateColumnError(error)) {\n      return;\n    }\n\n    throw error;\n  }\n}\n\nasync function indexExists(\n  db: DatabaseInterface,\n  indexName: string,\n  typeHint?: string,\n): Promise<boolean> {\n  try {\n    const engine = getDatabaseEngine(db, typeHint);\n    if (engine === 'postgres') {\n      const result = await db.query(\n        'SELECT 1 FROM pg_indexes WHERE schemaname = current_schema() AND indexname = $1 LIMIT 1',\n        indexName,\n      );\n      return getQueryRows(result).length > 0;\n    }\n\n    const result = await db.query(\n      `SELECT 1 FROM sqlite_master WHERE type = 'index' AND name = ? LIMIT 1`,\n      indexName,\n    );\n    return getQueryRows(result).length > 0;\n  } catch {\n    return false;\n  }\n}\n\nasync function addIndexIfMissing(\n  db: DatabaseInterface,\n  indexName: string,\n  tableName: string,\n  columnName: string,\n  typeHint?: string,\n): Promise<void> {\n  if (await indexExists(db, indexName, typeHint)) {\n    return;\n  }\n\n  try {\n    await db.query(\n      `CREATE INDEX IF NOT EXISTS ${indexName} ON ${tableName}(${columnName})`,\n    );\n  } catch (error) {\n    if (isDuplicateIndexRaceError(error, indexName)) {\n      if (await indexExists(db, indexName, typeHint)) {\n        return;\n      }\n    }\n\n    throw error;\n  }\n}\n\nasync function addUniqueIndexIfMissing(\n  db: DatabaseInterface,\n  indexName: string,\n  tableName: string,\n  columns: string,\n  typeHint?: string,\n): Promise<void> {\n  if (await indexExists(db, indexName, typeHint)) {\n    return;\n  }\n\n  try {\n    await db.query(\n      `CREATE UNIQUE INDEX IF NOT EXISTS ${indexName} ON ${tableName}(${columns})`,\n    );\n  } catch (error) {\n    if (isDuplicateIndexRaceError(error, indexName)) {\n      if (await indexExists(db, indexName, typeHint)) {\n        return;\n      }\n    }\n\n    throw error;\n  }\n}\n\n/**\n * Migrate the legacy `UNIQUE(signal_type, subscriber)` subscription identity to\n * the tenant-scoped `UNIQUE(tenant_id, signal_type, subscriber)` (S5 #1398).\n *\n * The old identity let any tenant overwrite/delete/enable another tenant's\n * subscription because the natural key ignored the tenant. This:\n *   1. Creates the tenant-scoped unique index used by upsert conflict handling.\n *   2. Drops the legacy 2-column unique constraint:\n *      - **SQLite**: inline `UNIQUE(...)` constraints can't be dropped in place,\n *        so the table is rebuilt without it (data preserved). The legacy\n *        constraint surfaces as an auto-created `sqlite_autoindex_*` index.\n *      - **Postgres**: the inline constraint is dropped by its conventional\n *        name if present.\n *\n * Additive and idempotent: re-running is a no-op once migrated.\n */\nasync function migrateDispatchSubscriptionsIdentity(\n  db: DatabaseInterface,\n  typeHint?: string,\n): Promise<void> {\n  const engine = getDatabaseEngine(db, typeHint);\n\n  // 1. Tenant-scoped unique index (used by upsert's ON CONFLICT target).\n  await addUniqueIndexIfMissing(\n    db,\n    'uq_smrt_dispatch_subs_tenant_signal_subscriber',\n    '_smrt_dispatch_subscriptions',\n    'tenant_id, signal_type, subscriber',\n    typeHint,\n  );\n\n  // 2. Drop the legacy (signal_type, subscriber) uniqueness.\n  if (engine === 'postgres') {\n    // Inline table-level UNIQUE constraints get a conventional name. Drop it if\n    // present; ignore if it was never created under that name.\n    try {\n      await db.query(\n        'ALTER TABLE _smrt_dispatch_subscriptions DROP CONSTRAINT IF EXISTS _smrt_dispatch_subscriptions_signal_type_subscriber_key',\n      );\n    } catch {\n      // Best-effort: a differently-named legacy constraint is left in place; the\n      // tenant-scoped index above still enforces correct per-tenant identity.\n    }\n    return;\n  }\n\n  // SQLite: detect a legacy auto-index over exactly (signal_type, subscriber)\n  // and, if found, rebuild the table without the inline UNIQUE.\n  if (engine !== 'sqlite') {\n    return;\n  }\n\n  let legacyAutoIndex: string | null = null;\n  try {\n    const result = await db.query(\n      `SELECT name FROM sqlite_master\n         WHERE type = 'index'\n           AND tbl_name = '_smrt_dispatch_subscriptions'\n           AND name LIKE 'sqlite_autoindex_%'`,\n    );\n    for (const row of getQueryRows(result)) {\n      const indexName = String(row.name);\n      const info = await db.query(`PRAGMA index_info(${indexName})`);\n      const cols = getQueryRows(info)\n        .map((r) => String(r.name))\n        .sort();\n      if (\n        cols.length === 2 &&\n        cols[0] === 'signal_type' &&\n        cols[1] === 'subscriber'\n      ) {\n        legacyAutoIndex = indexName;\n        break;\n      }\n    }\n  } catch {\n    // Unable to introspect → assume no legacy constraint (fresh tables created\n    // from the new schema have none).\n    legacyAutoIndex = null;\n  }\n\n  if (!legacyAutoIndex) {\n    return;\n  }\n\n  // Rebuild the table without the inline UNIQUE(signal_type, subscriber).\n  // System table is small; this runs once per legacy database.\n  await db.query('PRAGMA foreign_keys=OFF');\n  try {\n    await db.query(`\n      CREATE TABLE _smrt_dispatch_subscriptions_new (\n        id TEXT PRIMARY KEY,\n        signal_type TEXT NOT NULL,\n        subscriber TEXT NOT NULL,\n        handler TEXT NOT NULL DEFAULT 'handleDispatch',\n        delivery TEXT NOT NULL DEFAULT 'compete',\n        enabled INTEGER DEFAULT 1,\n        tenant_id TEXT,\n        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n      )\n    `);\n    await db.query(`\n      INSERT INTO _smrt_dispatch_subscriptions_new\n        (id, signal_type, subscriber, handler, delivery, enabled, tenant_id, created_at, updated_at)\n      SELECT id, signal_type, subscriber, handler, delivery, enabled, tenant_id, created_at, updated_at\n        FROM _smrt_dispatch_subscriptions\n    `);\n    await db.query('DROP TABLE _smrt_dispatch_subscriptions');\n    await db.query(\n      'ALTER TABLE _smrt_dispatch_subscriptions_new RENAME TO _smrt_dispatch_subscriptions',\n    );\n    // Recreate the secondary indexes (the rebuild dropped them) plus the\n    // tenant-scoped unique index.\n    await db.query(\n      'CREATE UNIQUE INDEX IF NOT EXISTS uq_smrt_dispatch_subs_tenant_signal_subscriber ON _smrt_dispatch_subscriptions(tenant_id, signal_type, subscriber)',\n    );\n    await db.query(\n      'CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_subscriber ON _smrt_dispatch_subscriptions(subscriber)',\n    );\n    await db.query(\n      'CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_tenant_id ON _smrt_dispatch_subscriptions(tenant_id)',\n    );\n    await db.query(\n      'CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_signal_type ON _smrt_dispatch_subscriptions(signal_type)',\n    );\n    await db.query(\n      'CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_enabled ON _smrt_dispatch_subscriptions(enabled)',\n    );\n  } finally {\n    await db.query('PRAGMA foreign_keys=ON');\n  }\n}\n\nexport async function ensureDispatchSystemTableCompatibility(\n  db: DatabaseInterface,\n  typeHint?: string,\n): Promise<void> {\n  if (!(await tableExists(db, '_smrt_dispatch', typeHint))) {\n    return;\n  }\n\n  await addColumnIfMissing(\n    db,\n    '_smrt_dispatch',\n    'target_subscriber',\n    'TEXT',\n    typeHint,\n  );\n  await addColumnIfMissing(\n    db,\n    '_smrt_dispatch',\n    'correlation_id',\n    'TEXT',\n    typeHint,\n  );\n  // Tenant isolation (S5 #1398): dispatches are scoped to the emitting\n  // tenant context so a subscriber in tenant A cannot snoop/claim tenant B's\n  // dispatches. Nullable so non-tenant (global) dispatches keep tenant_id NULL.\n  await addColumnIfMissing(db, '_smrt_dispatch', 'tenant_id', 'TEXT', typeHint);\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_dispatch_target',\n    '_smrt_dispatch',\n    'target_subscriber',\n    typeHint,\n  );\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_dispatch_correlation',\n    '_smrt_dispatch',\n    'correlation_id',\n    typeHint,\n  );\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_dispatch_tenant_id',\n    '_smrt_dispatch',\n    'tenant_id',\n    typeHint,\n  );\n}\n\nexport async function ensureDispatchSubscriptionsSystemTableCompatibility(\n  db: DatabaseInterface,\n  typeHint?: string,\n): Promise<void> {\n  if (!(await tableExists(db, '_smrt_dispatch_subscriptions', typeHint))) {\n    return;\n  }\n\n  await addColumnIfMissing(\n    db,\n    '_smrt_dispatch_subscriptions',\n    'delivery',\n    \"TEXT NOT NULL DEFAULT 'compete'\",\n    typeHint,\n  );\n  // Tenant isolation (S5 #1398): records the tenant context a subscription was\n  // registered in. Nullable so global/non-tenant subscriptions keep it NULL.\n  await addColumnIfMissing(\n    db,\n    '_smrt_dispatch_subscriptions',\n    'tenant_id',\n    'TEXT',\n    typeHint,\n  );\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_dispatch_subs_tenant_id',\n    '_smrt_dispatch_subscriptions',\n    'tenant_id',\n    typeHint,\n  );\n  // Migrate the subscription natural key to (tenant_id, signal_type, subscriber)\n  // so tenants can't clobber each other's subscriptions (S5 #1398).\n  await migrateDispatchSubscriptionsIdentity(db, typeHint);\n}\n\nexport async function ensureJobsSystemTableCompatibility(\n  db: DatabaseInterface,\n  typeHint?: string,\n): Promise<void> {\n  if (!(await tableExists(db, '_smrt_jobs', typeHint))) {\n    return;\n  }\n\n  await addColumnIfMissing(db, '_smrt_jobs', 'tenant_id', 'TEXT', typeHint);\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_jobs_tenant_id',\n    '_smrt_jobs',\n    'tenant_id',\n    typeHint,\n  );\n}\n\nexport async function ensureJobEventsSystemTableCompatibility(\n  db: DatabaseInterface,\n  typeHint?: string,\n): Promise<void> {\n  if (!(await tableExists(db, '_smrt_job_events', typeHint))) {\n    return;\n  }\n\n  await addColumnIfMissing(\n    db,\n    '_smrt_job_events',\n    'tenant_id',\n    'TEXT',\n    typeHint,\n  );\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_job_events_tenant_id',\n    '_smrt_job_events',\n    'tenant_id',\n    typeHint,\n  );\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_job_events_job_id',\n    '_smrt_job_events',\n    'job_id',\n    typeHint,\n  );\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_job_events_type',\n    '_smrt_job_events',\n    'type',\n    typeHint,\n  );\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_job_events_created_at',\n    '_smrt_job_events',\n    'created_at',\n    typeHint,\n  );\n}\n\nexport async function ensureLegacySystemTableCompatibility(\n  db: DatabaseInterface,\n  typeHint?: string,\n): Promise<void> {\n  await ensureDispatchSystemTableCompatibility(db, typeHint);\n  await ensureDispatchSubscriptionsSystemTableCompatibility(db, typeHint);\n  await ensureJobsSystemTableCompatibility(db, typeHint);\n  await ensureJobEventsSystemTableCompatibility(db, typeHint);\n}\n"],"mappings":";;;AAeA,SAAS,aAAa,QAA4C;CAChE,IAAI,MAAM,QAAQ,MAAM,GACtB,OAAO;CAGT,IAAI,UAAU,OAAO,WAAW,YAAY,UAAU,QAAQ;EAC5D,MAAM,OAAQ,OAA8B;EAC5C,IAAI,MAAM,QAAQ,IAAI,GACpB,OAAO;CAEX;CAEA,OAAO,CAAC;AACV;AAEA,eAAsB,YACpB,IACA,WACA,UACkB;CAClB,IAAI;EAEF,IADe,kBAAkB,IAAI,QACjC,MAAW,YAKb,OAAO,aAAa,MAJC,GAAG,MACtB,6GACA,SACF,CAC0B,CAAC,CAAC,SAAS;EAGvC,MAAM,GAAG,MAAM,iBAAiB,UAAU,SAAS;EACnD,OAAO;CACT,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAe,aACb,IACA,WACA,YACA,UACkB;CAClB,IAAI;EAEF,IADe,kBAAkB,IAAI,QACjC,MAAW,YAMb,OAAO,aAAa,MALC,GAAG,MACtB,mIACA,WACA,UACF,CAC0B,CAAC,CAAC,SAAS;EAIvC,OAAO,aAAa,MADC,GAAG,MAAM,qBAAqB,UAAU,EAAE,CACrC,CAAC,CAAC,MAAM,QAAQ,IAAI,SAAS,UAAU;CACnE,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,eAAe,IAA+B;CACrD,MAAM,eAAe;CACrB,OAAO,GAAG,OAAO,aAAa,QAAQ,OAAO;AAC/C;AAEA,SAAgB,kBACd,IACA,UACiC;CACjC,MAAM,eAAe;CACrB,OAAO,aACL,eAAe,EAAE,GACjB,YAAY,aAAa,QAAQ,aAAa,QAAQ,IACxD;AACF;;;;;;AAwBA,eAAsB,sCACpB,IACA,UACe;CACf,IAAI,kBAAkB,IAAI,QAAQ,MAAM,YAAY;CAEpD,MAAM,OAAO,aACX,MAAM,GAAG,MAAM;;;;;;;KAOd,CACH;CACA,IAAI,KAAK,WAAW,GAAG;CAEvB,MAAM,UAAU,KACb,KAAK,QAAQ,GAAG,OAAO,IAAI,UAAU,EAAE,GAAG,OAAO,IAAI,WAAW,GAAG,CAAC,CACpE,KAAK,IAAI;CACZ,MAAM,IAAI,MACR,yCAAyC,QAAQ,yFACnD;AACF;AAEA,eAAsB,gCACpB,IACA,cACA,UACe;CACf,IAAI,kBAAkB,IAAI,QAAQ,MAAM,YAAY;CACpD,IAAI,aAAa,mBAAmB,OAClC,MAAM,IAAI,MACR,yFACF;CAMF,MAAM,GAAG,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCA4BiB,qDAAqD;;EAErF,4CAA4C,KAAK,EAAE;;;;;GAKlD;AACH;AAEA,SAAS,uBAAuB,OAAyB;CACvD,MAAM,UACJ,SAAS,OAAO,UAAU,WACtB,OAAQ,MAAgC,WAAW,KAAK,IACxD,OAAO,KAAK;CAElB,OACE,2BAA2B,KAAK,OAAO,KACvC,yBAAyB,KAAK,OAAO;AAEzC;AAEA,SAAS,oBACP,OACA,uBAAO,IAAI,IAAa,GAIxB;CACA,MAAM,wBAAQ,IAAI,IAAY;CAC9B,MAAM,WAAqB,CAAC;CAE5B,IAAI,CAAC,SAAS,KAAK,IAAI,KAAK,GAC1B,OAAO;EAAE;EAAO;CAAS;CAG3B,KAAK,IAAI,KAAK;CAEd,IAAI,OAAO,UAAU,UAAU;EAC7B,MAAM,cAAc;EAEpB,IAAI,OAAO,YAAY,SAAS,UAC9B,MAAM,IAAI,YAAY,IAAI;EAG5B,KAAK,MAAM,cAAc,CAAC,WAAW,QAAQ,GAC3C,IAAI,OAAO,YAAY,gBAAgB,UACrC,SAAS,KAAK,YAAY,WAAW;EAIzC,KAAK,MAAM,aAAa;GAAC;GAAS;GAAW;EAAe,GAAG;GAC7D,MAAM,SAAS,oBAAoB,YAAY,YAAY,IAAI;GAC/D,KAAK,MAAM,QAAQ,OAAO,OACxB,MAAM,IAAI,IAAI;GAEhB,SAAS,KAAK,GAAG,OAAO,QAAQ;EAClC;CACF,OACE,SAAS,KAAK,OAAO,KAAK,CAAC;CAG7B,OAAO;EAAE;EAAO;CAAS;AAC3B;AAEA,SAAS,0BAA0B,OAAgB,WAA4B;CAC7E,MAAM,EAAE,OAAO,aAAa,oBAAoB,KAAK;CACrD,MAAM,UAAU,SAAS,KAAK,IAAI,CAAC,CAAC,YAAY;CAChD,MAAM,sBAAsB,UAAU,YAAY;CAClD,MAAM,mBACJ,MAAM,IAAI,OAAO,KAAK,uBAAuB,KAAK,OAAO;CAC3D,MAAM,wBACJ,MAAM,IAAI,OAAO,KAAK,wBAAwB,KAAK,OAAO;CAE5D,IAAI,CAAC,QAAQ,SAAS,mBAAmB,GACvC,OAAO;CAGT,IAAI,oBAAoB,QAAQ,SAAS,4BAA4B,GACnE,OAAO;CAGT,IAAI,yBAAyB,6BAA6B,KAAK,OAAO,GACpE,OAAO;CAGT,OAAO;AACT;AAEA,eAAe,mBACb,IACA,WACA,YACA,YACA,UACe;CAGf,IAFe,kBAAkB,IAAI,QAEjC,MAAW,YAAY;EACzB,IAAI,MAAM,aAAa,IAAI,WAAW,YAAY,QAAQ,GACxD;EAGF,MAAM,GAAG,MACP,eAAe,UAAU,4BAA4B,WAAW,GAAG,YACrE;EACA;CACF;CAEA,IAAI,MAAM,aAAa,IAAI,WAAW,YAAY,QAAQ,GACxD;CAGF,IAAI;EACF,MAAM,GAAG,MACP,eAAe,UAAU,cAAc,WAAW,GAAG,YACvD;CACF,SAAS,OAAO;EACd,IAAI,uBAAuB,KAAK,GAC9B;EAGF,MAAM;CACR;AACF;AAEA,eAAe,YACb,IACA,WACA,UACkB;CAClB,IAAI;EAEF,IADe,kBAAkB,IAAI,QACjC,MAAW,YAKb,OAAO,aAAa,MAJC,GAAG,MACtB,2FACA,SACF,CAC0B,CAAC,CAAC,SAAS;EAOvC,OAAO,aAAa,MAJC,GAAG,MACtB,yEACA,SACF,CAC0B,CAAC,CAAC,SAAS;CACvC,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAe,kBACb,IACA,WACA,WACA,YACA,UACe;CACf,IAAI,MAAM,YAAY,IAAI,WAAW,QAAQ,GAC3C;CAGF,IAAI;EACF,MAAM,GAAG,MACP,8BAA8B,UAAU,MAAM,UAAU,GAAG,WAAW,EACxE;CACF,SAAS,OAAO;EACd,IAAI,0BAA0B,OAAO,SAAS;OACxC,MAAM,YAAY,IAAI,WAAW,QAAQ,GAC3C;EAAA;EAIJ,MAAM;CACR;AACF;AAEA,eAAe,wBACb,IACA,WACA,WACA,SACA,UACe;CACf,IAAI,MAAM,YAAY,IAAI,WAAW,QAAQ,GAC3C;CAGF,IAAI;EACF,MAAM,GAAG,MACP,qCAAqC,UAAU,MAAM,UAAU,GAAG,QAAQ,EAC5E;CACF,SAAS,OAAO;EACd,IAAI,0BAA0B,OAAO,SAAS;OACxC,MAAM,YAAY,IAAI,WAAW,QAAQ,GAC3C;EAAA;EAIJ,MAAM;CACR;AACF;;;;;;;;;;;;;;;;;AAkBA,eAAe,qCACb,IACA,UACe;CACf,MAAM,SAAS,kBAAkB,IAAI,QAAQ;CAG7C,MAAM,wBACJ,IACA,kDACA,gCACA,sCACA,QACF;CAGA,IAAI,WAAW,YAAY;EAGzB,IAAI;GACF,MAAM,GAAG,MACP,4HACF;EACF,QAAQ,CAGR;EACA;CACF;CAIA,IAAI,WAAW,UACb;CAGF,IAAI,kBAAiC;CACrC,IAAI;EACF,MAAM,SAAS,MAAM,GAAG,MACtB;;;8CAIF;EACA,KAAK,MAAM,OAAO,aAAa,MAAM,GAAG;GACtC,MAAM,YAAY,OAAO,IAAI,IAAI;GAEjC,MAAM,OAAO,aAAa,MADP,GAAG,MAAM,qBAAqB,UAAU,EAAE,CAC/B,CAAC,CAC5B,KAAK,MAAM,OAAO,EAAE,IAAI,CAAC,CAAC,CAC1B,KAAK;GACR,IACE,KAAK,WAAW,KAChB,KAAK,OAAO,iBACZ,KAAK,OAAO,cACZ;IACA,kBAAkB;IAClB;GACF;EACF;CACF,QAAQ;EAGN,kBAAkB;CACpB;CAEA,IAAI,CAAC,iBACH;CAKF,MAAM,GAAG,MAAM,yBAAyB;CACxC,IAAI;EACF,MAAM,GAAG,MAAM;;;;;;;;;;;;KAYd;EACD,MAAM,GAAG,MAAM;;;;;KAKd;EACD,MAAM,GAAG,MAAM,yCAAyC;EACxD,MAAM,GAAG,MACP,qFACF;EAGA,MAAM,GAAG,MACP,sJACF;EACA,MAAM,GAAG,MACP,0GACF;EACA,MAAM,GAAG,MACP,wGACF;EACA,MAAM,GAAG,MACP,4GACF;EACA,MAAM,GAAG,MACP,oGACF;CACF,UAAU;EACR,MAAM,GAAG,MAAM,wBAAwB;CACzC;AACF;AAEA,eAAsB,uCACpB,IACA,UACe;CACf,IAAI,CAAE,MAAM,YAAY,IAAI,kBAAkB,QAAQ,GACpD;CAGF,MAAM,mBACJ,IACA,kBACA,qBACA,QACA,QACF;CACA,MAAM,mBACJ,IACA,kBACA,kBACA,QACA,QACF;CAIA,MAAM,mBAAmB,IAAI,kBAAkB,aAAa,QAAQ,QAAQ;CAC5E,MAAM,kBACJ,IACA,4BACA,kBACA,qBACA,QACF;CACA,MAAM,kBACJ,IACA,iCACA,kBACA,kBACA,QACF;CACA,MAAM,kBACJ,IACA,+BACA,kBACA,aACA,QACF;AACF;AAEA,eAAsB,oDACpB,IACA,UACe;CACf,IAAI,CAAE,MAAM,YAAY,IAAI,gCAAgC,QAAQ,GAClE;CAGF,MAAM,mBACJ,IACA,gCACA,YACA,mCACA,QACF;CAGA,MAAM,mBACJ,IACA,gCACA,aACA,QACA,QACF;CACA,MAAM,kBACJ,IACA,oCACA,gCACA,aACA,QACF;CAGA,MAAM,qCAAqC,IAAI,QAAQ;AACzD;AAEA,eAAsB,mCACpB,IACA,UACe;CACf,IAAI,CAAE,MAAM,YAAY,IAAI,cAAc,QAAQ,GAChD;CAGF,MAAM,mBAAmB,IAAI,cAAc,aAAa,QAAQ,QAAQ;CACxE,MAAM,kBACJ,IACA,2BACA,cACA,aACA,QACF;AACF;AAEA,eAAsB,wCACpB,IACA,UACe;CACf,IAAI,CAAE,MAAM,YAAY,IAAI,oBAAoB,QAAQ,GACtD;CAGF,MAAM,mBACJ,IACA,oBACA,aACA,QACA,QACF;CACA,MAAM,kBACJ,IACA,iCACA,oBACA,aACA,QACF;CACA,MAAM,kBACJ,IACA,8BACA,oBACA,UACA,QACF;CACA,MAAM,kBACJ,IACA,4BACA,oBACA,QACA,QACF;CACA,MAAM,kBACJ,IACA,kCACA,oBACA,cACA,QACF;AACF;AAEA,eAAsB,qCACpB,IACA,UACe;CACf,MAAM,uCAAuC,IAAI,QAAQ;CACzD,MAAM,oDAAoD,IAAI,QAAQ;CACtE,MAAM,mCAAmC,IAAI,QAAQ;CACrD,MAAM,wCAAwC,IAAI,QAAQ;AAC5D"}
+{"version":3,"file":"compatibility.js","names":[],"sources":["../../src/system/compatibility.ts"],"sourcesContent":["import type { DatabaseInterface } from '@happyvertical/sql';\nimport { detectEngine } from '../schema/ddl/index.js';\nimport {\n  CREATE_POSTGRES_CHANGE_FEED_APPEND_FUNCTION,\n  LEGACY_POSTGRES_CHANGE_FEED_APPEND_FUNCTION_IDENTITY,\n} from './schema.js';\n\ntype DatabaseWithConfig = DatabaseInterface & {\n  config?: {\n    type?: string;\n    url?: string;\n  };\n  type?: string;\n};\n\nfunction getQueryRows(result: unknown): Record<string, unknown>[] {\n  if (Array.isArray(result)) {\n    return result as Record<string, unknown>[];\n  }\n\n  if (result && typeof result === 'object' && 'rows' in result) {\n    const rows = (result as { rows?: unknown }).rows;\n    if (Array.isArray(rows)) {\n      return rows as Record<string, unknown>[];\n    }\n  }\n\n  return [];\n}\n\nexport async function tableExists(\n  db: DatabaseInterface,\n  tableName: string,\n  typeHint?: string,\n): Promise<boolean> {\n  try {\n    const engine = getDatabaseEngine(db, typeHint);\n    if (engine === 'postgres') {\n      const result = await db.query(\n        'SELECT 1 FROM information_schema.tables WHERE table_schema = current_schema() AND table_name = $1 LIMIT 1',\n        tableName,\n      );\n      return getQueryRows(result).length > 0;\n    }\n\n    await db.query(`SELECT 1 FROM ${tableName} LIMIT 1`);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function columnExists(\n  db: DatabaseInterface,\n  tableName: string,\n  columnName: string,\n  typeHint?: string,\n): Promise<boolean> {\n  try {\n    const engine = getDatabaseEngine(db, typeHint);\n    if (engine === 'postgres') {\n      const result = await db.query(\n        'SELECT 1 FROM information_schema.columns WHERE table_schema = current_schema() AND table_name = $1 AND column_name = $2 LIMIT 1',\n        tableName,\n        columnName,\n      );\n      return getQueryRows(result).length > 0;\n    }\n\n    const result = await db.query(`PRAGMA table_info(${tableName})`);\n    return getQueryRows(result).some((row) => row.name === columnName);\n  } catch {\n    return false;\n  }\n}\n\nfunction getDatabaseUrl(db: DatabaseInterface): string {\n  const dbWithConfig = db as DatabaseWithConfig;\n  return db.url || dbWithConfig.config?.url || '';\n}\n\nexport function getDatabaseEngine(\n  db: DatabaseInterface,\n  typeHint?: string,\n): ReturnType<typeof detectEngine> {\n  const dbWithConfig = db as DatabaseWithConfig;\n  return detectEngine(\n    getDatabaseUrl(db),\n    typeHint || dbWithConfig.type || dbWithConfig.config?.type,\n  );\n}\n\n/**\n * Upgrade framework-owned PostgreSQL timestamp columns to instant-safe storage.\n *\n * Legacy SMRT and system writers serialized instants as UTC wall times. The\n * conversion is intentionally fail-closed unless the migration session is UTC:\n * operators must first confirm that historical database-default/raw writers\n * also used UTC. A deployment with non-UTC legacy writers needs an explicit,\n * provenance-aware data migration rather than a guessed offset.\n */\nexport interface PostgresSystemTimestampMigrationConfirmation {\n  /**\n   * Explicitly confirmed timezone used by every historical writer of legacy\n   * timezone-naive system timestamps. Only UTC is supported by this helper.\n   */\n  legacyTimezone: 'UTC';\n}\n\nexport interface PostgresSystemTimestampMigrationPlan {\n  kind: 'column' | 'change-feed-function';\n  tableName: string;\n  columnName?: string;\n  sql: string;\n}\n\nfunction quotePostgresIdentifier(identifier: string): string {\n  return `\"${identifier.replaceAll('\"', '\"\"')}\"`;\n}\n\n/**\n * Read-only plan for the framework-owned timestamp conversion. This is kept\n * separate from the atomic mutator so CLI dry-runs can report every ALTER\n * without bootstrapping or changing framework tables.\n */\nexport async function planPostgresSystemTimestampMigrations(\n  db: DatabaseInterface,\n  confirmation: PostgresSystemTimestampMigrationConfirmation,\n  typeHint?: string,\n): Promise<PostgresSystemTimestampMigrationPlan[]> {\n  if (getDatabaseEngine(db, typeHint) !== 'postgres') return [];\n  if (confirmation.legacyTimezone !== 'UTC') {\n    throw new Error(\n      'Legacy SMRT system timestamp migration requires an explicit UTC provenance confirmation',\n    );\n  }\n\n  const sessionRows = getQueryRows(\n    await db.query(`\n      SELECT\n        current_setting('TimeZone') AS timezone,\n        to_regprocedure('${LEGACY_POSTGRES_CHANGE_FEED_APPEND_FUNCTION_IDENTITY}')\n          IS NOT NULL AS legacy_change_feed_function_exists\n    `),\n  );\n  const session = sessionRows[0] ?? {};\n  const timezone = String(session.timezone ?? '').toUpperCase();\n  if (!['UTC', 'ETC/UTC', 'GMT'].includes(timezone)) {\n    throw new Error(\n      `Refusing to preview legacy SMRT timestamp migration outside a UTC PostgreSQL session (current TimeZone: ${String(session.timezone ?? 'unknown')})`,\n    );\n  }\n\n  const rows = getQueryRows(\n    await db.query(`\n      SELECT table_name, column_name\n      FROM information_schema.columns\n      WHERE table_schema = current_schema()\n        AND table_name LIKE '\\\\_smrt\\\\_%' ESCAPE '\\\\'\n        AND data_type = 'timestamp without time zone'\n      ORDER BY table_name, ordinal_position\n    `),\n  );\n\n  const plans: PostgresSystemTimestampMigrationPlan[] = rows.map((row) => {\n    const tableName = String(row.table_name);\n    const columnName = String(row.column_name);\n    const table = quotePostgresIdentifier(tableName);\n    const column = quotePostgresIdentifier(columnName);\n    return {\n      kind: 'column',\n      tableName,\n      columnName,\n      sql: `ALTER TABLE ${table} ALTER COLUMN ${column} TYPE TIMESTAMPTZ USING ${column} AT TIME ZONE 'UTC'`,\n    };\n  });\n\n  if (\n    session.legacy_change_feed_function_exists === true ||\n    session.legacy_change_feed_function_exists === 't' ||\n    session.legacy_change_feed_function_exists === 'true' ||\n    session.legacy_change_feed_function_exists === 1\n  ) {\n    plans.push({\n      kind: 'change-feed-function',\n      tableName: '_smrt_changes',\n      sql: `DROP FUNCTION IF EXISTS ${LEGACY_POSTGRES_CHANGE_FEED_APPEND_FUNCTION_IDENTITY};\\n${CREATE_POSTGRES_CHANGE_FEED_APPEND_FUNCTION.trim()}`,\n    });\n  }\n\n  return plans;\n}\n\n/**\n * Fail closed when framework-owned PostgreSQL tables still contain legacy\n * timezone-naive timestamps. Call this before recording the current system\n * schema version so a partial installation cannot be stamped as upgraded.\n */\nexport async function assertPostgresSystemTimestampsCurrent(\n  db: DatabaseInterface,\n  typeHint?: string,\n): Promise<void> {\n  if (getDatabaseEngine(db, typeHint) !== 'postgres') return;\n\n  const rows = getQueryRows(\n    await db.query(`\n      SELECT table_name, column_name\n      FROM information_schema.columns\n      WHERE table_schema = current_schema()\n        AND table_name LIKE '\\\\_smrt\\\\_%' ESCAPE '\\\\'\n        AND data_type = 'timestamp without time zone'\n      ORDER BY table_name, ordinal_position\n    `),\n  );\n  if (rows.length === 0) return;\n\n  const columns = rows\n    .map((row) => `${String(row.table_name)}.${String(row.column_name)}`)\n    .join(', ');\n  throw new Error(\n    `Legacy SMRT system timestamps remain (${columns}); run the explicit audited migratePostgresSystemTimestamps() migration before bootstrap`,\n  );\n}\n\nexport async function migratePostgresSystemTimestamps(\n  db: DatabaseInterface,\n  confirmation: PostgresSystemTimestampMigrationConfirmation,\n  typeHint?: string,\n): Promise<void> {\n  if (getDatabaseEngine(db, typeHint) !== 'postgres') return;\n  if (confirmation.legacyTimezone !== 'UTC') {\n    throw new Error(\n      'Legacy SMRT system timestamp migration requires an explicit UTC provenance confirmation',\n    );\n  }\n\n  // One server-side statement makes the catalog change atomic and holds the\n  // same transaction-scoped lock used by system bootstrap. Any failing column\n  // rolls back every preceding ALTER in the block.\n  await db.query(`\n    DO $smrt_migrate_system_timestamps$\n    DECLARE\n      target RECORD;\n    BEGIN\n      PERFORM pg_advisory_xact_lock(\n        hashtext('smrt'),\n        hashtext('system-tables')\n      );\n      IF upper(current_setting('TimeZone')) NOT IN ('UTC', 'ETC/UTC', 'GMT') THEN\n        RAISE EXCEPTION 'Refusing to reinterpret legacy SMRT timestamps outside a UTC PostgreSQL session; confirm historical writers used UTC and SET TIME ZONE UTC';\n      END IF;\n      FOR target IN\n        SELECT table_name, column_name\n        FROM information_schema.columns\n        WHERE table_schema = current_schema()\n          AND table_name LIKE '\\\\_smrt\\\\_%' ESCAPE '\\\\'\n          AND data_type = 'timestamp without time zone'\n        ORDER BY table_name, ordinal_position\n      LOOP\n        EXECUTE format(\n          'ALTER TABLE %I ALTER COLUMN %I TYPE TIMESTAMPTZ USING %I AT TIME ZONE ''UTC''',\n          target.table_name,\n          target.column_name,\n          target.column_name\n        );\n      END LOOP;\n      IF to_regprocedure('${LEGACY_POSTGRES_CHANGE_FEED_APPEND_FUNCTION_IDENTITY}') IS NOT NULL THEN\n        DROP FUNCTION IF EXISTS ${LEGACY_POSTGRES_CHANGE_FEED_APPEND_FUNCTION_IDENTITY};\n        EXECUTE $smrt_change_feed_ddl$\n${CREATE_POSTGRES_CHANGE_FEED_APPEND_FUNCTION.trim()}\n$smrt_change_feed_ddl$;\n      END IF;\n    END;\n    $smrt_migrate_system_timestamps$;\n  `);\n}\n\nfunction isDuplicateColumnError(error: unknown): boolean {\n  const message =\n    error && typeof error === 'object'\n      ? String((error as { message?: unknown }).message || error)\n      : String(error);\n\n  return (\n    /column .*already exists/i.test(message) ||\n    /duplicate column name/i.test(message)\n  );\n}\n\nfunction collectErrorDetails(\n  error: unknown,\n  seen = new Set<unknown>(),\n): {\n  codes: Set<string>;\n  messages: string[];\n} {\n  const codes = new Set<string>();\n  const messages: string[] = [];\n\n  if (!error || seen.has(error)) {\n    return { codes, messages };\n  }\n\n  seen.add(error);\n\n  if (typeof error === 'object') {\n    const errorRecord = error as Record<string, unknown>;\n\n    if (typeof errorRecord.code === 'string') {\n      codes.add(errorRecord.code);\n    }\n\n    for (const messageKey of ['message', 'detail']) {\n      if (typeof errorRecord[messageKey] === 'string') {\n        messages.push(errorRecord[messageKey]);\n      }\n    }\n\n    for (const nestedKey of ['cause', 'context', 'originalError']) {\n      const nested = collectErrorDetails(errorRecord[nestedKey], seen);\n      for (const code of nested.codes) {\n        codes.add(code);\n      }\n      messages.push(...nested.messages);\n    }\n  } else {\n    messages.push(String(error));\n  }\n\n  return { codes, messages };\n}\n\nfunction isDuplicateIndexRaceError(error: unknown, indexName: string): boolean {\n  const { codes, messages } = collectErrorDetails(error);\n  const message = messages.join('\\n').toLowerCase();\n  const normalizedIndexName = indexName.toLowerCase();\n  const hasDuplicateCode =\n    codes.has('23505') || /\\bcode\\s*=\\s*23505\\b/.test(message);\n  const hasRelationExistsCode =\n    codes.has('42P07') || /\\bcode\\s*=\\s*42p07\\b/i.test(message);\n\n  if (!message.includes(normalizedIndexName)) {\n    return false;\n  }\n\n  if (hasDuplicateCode && message.includes('pg_class_relname_nsp_index')) {\n    return true;\n  }\n\n  if (hasRelationExistsCode && /relation .*already exists/i.test(message)) {\n    return true;\n  }\n\n  return false;\n}\n\nasync function addColumnIfMissing(\n  db: DatabaseInterface,\n  tableName: string,\n  columnName: string,\n  definition: string,\n  typeHint?: string,\n): Promise<void> {\n  const engine = getDatabaseEngine(db, typeHint);\n\n  if (engine === 'postgres') {\n    if (await columnExists(db, tableName, columnName, typeHint)) {\n      return;\n    }\n\n    await db.query(\n      `ALTER TABLE ${tableName} ADD COLUMN IF NOT EXISTS ${columnName} ${definition}`,\n    );\n    return;\n  }\n\n  if (await columnExists(db, tableName, columnName, typeHint)) {\n    return;\n  }\n\n  try {\n    await db.query(\n      `ALTER TABLE ${tableName} ADD COLUMN ${columnName} ${definition}`,\n    );\n  } catch (error) {\n    if (isDuplicateColumnError(error)) {\n      return;\n    }\n\n    throw error;\n  }\n}\n\nasync function indexExists(\n  db: DatabaseInterface,\n  indexName: string,\n  typeHint?: string,\n): Promise<boolean> {\n  try {\n    const engine = getDatabaseEngine(db, typeHint);\n    if (engine === 'postgres') {\n      const result = await db.query(\n        'SELECT 1 FROM pg_indexes WHERE schemaname = current_schema() AND indexname = $1 LIMIT 1',\n        indexName,\n      );\n      return getQueryRows(result).length > 0;\n    }\n\n    const result = await db.query(\n      `SELECT 1 FROM sqlite_master WHERE type = 'index' AND name = ? LIMIT 1`,\n      indexName,\n    );\n    return getQueryRows(result).length > 0;\n  } catch {\n    return false;\n  }\n}\n\nasync function addIndexIfMissing(\n  db: DatabaseInterface,\n  indexName: string,\n  tableName: string,\n  columnName: string,\n  typeHint?: string,\n): Promise<void> {\n  if (await indexExists(db, indexName, typeHint)) {\n    return;\n  }\n\n  try {\n    await db.query(\n      `CREATE INDEX IF NOT EXISTS ${indexName} ON ${tableName}(${columnName})`,\n    );\n  } catch (error) {\n    if (isDuplicateIndexRaceError(error, indexName)) {\n      if (await indexExists(db, indexName, typeHint)) {\n        return;\n      }\n    }\n\n    throw error;\n  }\n}\n\nasync function addUniqueIndexIfMissing(\n  db: DatabaseInterface,\n  indexName: string,\n  tableName: string,\n  columns: string,\n  typeHint?: string,\n): Promise<void> {\n  if (await indexExists(db, indexName, typeHint)) {\n    return;\n  }\n\n  try {\n    await db.query(\n      `CREATE UNIQUE INDEX IF NOT EXISTS ${indexName} ON ${tableName}(${columns})`,\n    );\n  } catch (error) {\n    if (isDuplicateIndexRaceError(error, indexName)) {\n      if (await indexExists(db, indexName, typeHint)) {\n        return;\n      }\n    }\n\n    throw error;\n  }\n}\n\n/**\n * Migrate the legacy `UNIQUE(signal_type, subscriber)` subscription identity to\n * the tenant-scoped `UNIQUE(tenant_id, signal_type, subscriber)` (S5 #1398).\n *\n * The old identity let any tenant overwrite/delete/enable another tenant's\n * subscription because the natural key ignored the tenant. This:\n *   1. Creates the tenant-scoped unique index used by upsert conflict handling.\n *   2. Drops the legacy 2-column unique constraint:\n *      - **SQLite**: inline `UNIQUE(...)` constraints can't be dropped in place,\n *        so the table is rebuilt without it (data preserved). The legacy\n *        constraint surfaces as an auto-created `sqlite_autoindex_*` index.\n *      - **Postgres**: the inline constraint is dropped by its conventional\n *        name if present.\n *\n * Additive and idempotent: re-running is a no-op once migrated.\n */\nasync function migrateDispatchSubscriptionsIdentity(\n  db: DatabaseInterface,\n  typeHint?: string,\n): Promise<void> {\n  const engine = getDatabaseEngine(db, typeHint);\n\n  // 1. Tenant-scoped unique index (used by upsert's ON CONFLICT target).\n  await addUniqueIndexIfMissing(\n    db,\n    'uq_smrt_dispatch_subs_tenant_signal_subscriber',\n    '_smrt_dispatch_subscriptions',\n    'tenant_id, signal_type, subscriber',\n    typeHint,\n  );\n\n  // 2. Drop the legacy (signal_type, subscriber) uniqueness.\n  if (engine === 'postgres') {\n    // Inline table-level UNIQUE constraints get a conventional name. Drop it if\n    // present; ignore if it was never created under that name.\n    try {\n      await db.query(\n        'ALTER TABLE _smrt_dispatch_subscriptions DROP CONSTRAINT IF EXISTS _smrt_dispatch_subscriptions_signal_type_subscriber_key',\n      );\n    } catch {\n      // Best-effort: a differently-named legacy constraint is left in place; the\n      // tenant-scoped index above still enforces correct per-tenant identity.\n    }\n    return;\n  }\n\n  // SQLite: detect a legacy auto-index over exactly (signal_type, subscriber)\n  // and, if found, rebuild the table without the inline UNIQUE.\n  if (engine !== 'sqlite') {\n    return;\n  }\n\n  let legacyAutoIndex: string | null = null;\n  try {\n    const result = await db.query(\n      `SELECT name FROM sqlite_master\n         WHERE type = 'index'\n           AND tbl_name = '_smrt_dispatch_subscriptions'\n           AND name LIKE 'sqlite_autoindex_%'`,\n    );\n    for (const row of getQueryRows(result)) {\n      const indexName = String(row.name);\n      const info = await db.query(`PRAGMA index_info(${indexName})`);\n      const cols = getQueryRows(info)\n        .map((r) => String(r.name))\n        .sort();\n      if (\n        cols.length === 2 &&\n        cols[0] === 'signal_type' &&\n        cols[1] === 'subscriber'\n      ) {\n        legacyAutoIndex = indexName;\n        break;\n      }\n    }\n  } catch {\n    // Unable to introspect → assume no legacy constraint (fresh tables created\n    // from the new schema have none).\n    legacyAutoIndex = null;\n  }\n\n  if (!legacyAutoIndex) {\n    return;\n  }\n\n  // Rebuild the table without the inline UNIQUE(signal_type, subscriber).\n  // System table is small; this runs once per legacy database.\n  await db.query('PRAGMA foreign_keys=OFF');\n  try {\n    await db.query(`\n      CREATE TABLE _smrt_dispatch_subscriptions_new (\n        id TEXT PRIMARY KEY,\n        signal_type TEXT NOT NULL,\n        subscriber TEXT NOT NULL,\n        handler TEXT NOT NULL DEFAULT 'handleDispatch',\n        delivery TEXT NOT NULL DEFAULT 'compete',\n        enabled INTEGER DEFAULT 1,\n        tenant_id TEXT,\n        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n        updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n      )\n    `);\n    await db.query(`\n      INSERT INTO _smrt_dispatch_subscriptions_new\n        (id, signal_type, subscriber, handler, delivery, enabled, tenant_id, created_at, updated_at)\n      SELECT id, signal_type, subscriber, handler, delivery, enabled, tenant_id, created_at, updated_at\n        FROM _smrt_dispatch_subscriptions\n    `);\n    await db.query('DROP TABLE _smrt_dispatch_subscriptions');\n    await db.query(\n      'ALTER TABLE _smrt_dispatch_subscriptions_new RENAME TO _smrt_dispatch_subscriptions',\n    );\n    // Recreate the secondary indexes (the rebuild dropped them) plus the\n    // tenant-scoped unique index.\n    await db.query(\n      'CREATE UNIQUE INDEX IF NOT EXISTS uq_smrt_dispatch_subs_tenant_signal_subscriber ON _smrt_dispatch_subscriptions(tenant_id, signal_type, subscriber)',\n    );\n    await db.query(\n      'CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_subscriber ON _smrt_dispatch_subscriptions(subscriber)',\n    );\n    await db.query(\n      'CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_tenant_id ON _smrt_dispatch_subscriptions(tenant_id)',\n    );\n    await db.query(\n      'CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_signal_type ON _smrt_dispatch_subscriptions(signal_type)',\n    );\n    await db.query(\n      'CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_enabled ON _smrt_dispatch_subscriptions(enabled)',\n    );\n  } finally {\n    await db.query('PRAGMA foreign_keys=ON');\n  }\n}\n\nexport async function ensureDispatchSystemTableCompatibility(\n  db: DatabaseInterface,\n  typeHint?: string,\n): Promise<void> {\n  if (!(await tableExists(db, '_smrt_dispatch', typeHint))) {\n    return;\n  }\n\n  await addColumnIfMissing(\n    db,\n    '_smrt_dispatch',\n    'target_subscriber',\n    'TEXT',\n    typeHint,\n  );\n  await addColumnIfMissing(\n    db,\n    '_smrt_dispatch',\n    'correlation_id',\n    'TEXT',\n    typeHint,\n  );\n  // Tenant isolation (S5 #1398): dispatches are scoped to the emitting\n  // tenant context so a subscriber in tenant A cannot snoop/claim tenant B's\n  // dispatches. Nullable so non-tenant (global) dispatches keep tenant_id NULL.\n  await addColumnIfMissing(db, '_smrt_dispatch', 'tenant_id', 'TEXT', typeHint);\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_dispatch_target',\n    '_smrt_dispatch',\n    'target_subscriber',\n    typeHint,\n  );\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_dispatch_correlation',\n    '_smrt_dispatch',\n    'correlation_id',\n    typeHint,\n  );\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_dispatch_tenant_id',\n    '_smrt_dispatch',\n    'tenant_id',\n    typeHint,\n  );\n}\n\nexport async function ensureDispatchSubscriptionsSystemTableCompatibility(\n  db: DatabaseInterface,\n  typeHint?: string,\n): Promise<void> {\n  if (!(await tableExists(db, '_smrt_dispatch_subscriptions', typeHint))) {\n    return;\n  }\n\n  await addColumnIfMissing(\n    db,\n    '_smrt_dispatch_subscriptions',\n    'delivery',\n    \"TEXT NOT NULL DEFAULT 'compete'\",\n    typeHint,\n  );\n  // Tenant isolation (S5 #1398): records the tenant context a subscription was\n  // registered in. Nullable so global/non-tenant subscriptions keep it NULL.\n  await addColumnIfMissing(\n    db,\n    '_smrt_dispatch_subscriptions',\n    'tenant_id',\n    'TEXT',\n    typeHint,\n  );\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_dispatch_subs_tenant_id',\n    '_smrt_dispatch_subscriptions',\n    'tenant_id',\n    typeHint,\n  );\n  // Migrate the subscription natural key to (tenant_id, signal_type, subscriber)\n  // so tenants can't clobber each other's subscriptions (S5 #1398).\n  await migrateDispatchSubscriptionsIdentity(db, typeHint);\n}\n\nexport async function ensureJobsSystemTableCompatibility(\n  db: DatabaseInterface,\n  typeHint?: string,\n): Promise<void> {\n  if (!(await tableExists(db, '_smrt_jobs', typeHint))) {\n    return;\n  }\n\n  await addColumnIfMissing(db, '_smrt_jobs', 'tenant_id', 'TEXT', typeHint);\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_jobs_tenant_id',\n    '_smrt_jobs',\n    'tenant_id',\n    typeHint,\n  );\n}\n\nexport async function ensureJobEventsSystemTableCompatibility(\n  db: DatabaseInterface,\n  typeHint?: string,\n): Promise<void> {\n  if (!(await tableExists(db, '_smrt_job_events', typeHint))) {\n    return;\n  }\n\n  await addColumnIfMissing(\n    db,\n    '_smrt_job_events',\n    'tenant_id',\n    'TEXT',\n    typeHint,\n  );\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_job_events_tenant_id',\n    '_smrt_job_events',\n    'tenant_id',\n    typeHint,\n  );\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_job_events_job_id',\n    '_smrt_job_events',\n    'job_id',\n    typeHint,\n  );\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_job_events_type',\n    '_smrt_job_events',\n    'type',\n    typeHint,\n  );\n  await addIndexIfMissing(\n    db,\n    'idx_smrt_job_events_created_at',\n    '_smrt_job_events',\n    'created_at',\n    typeHint,\n  );\n}\n\nexport async function ensureLegacySystemTableCompatibility(\n  db: DatabaseInterface,\n  typeHint?: string,\n): Promise<void> {\n  await ensureDispatchSystemTableCompatibility(db, typeHint);\n  await ensureDispatchSubscriptionsSystemTableCompatibility(db, typeHint);\n  await ensureJobsSystemTableCompatibility(db, typeHint);\n  await ensureJobEventsSystemTableCompatibility(db, typeHint);\n}\n"],"mappings":"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"}

package/dist/system/index.js

@@ -1,2 +1,2 @@
-import { assertPostgresSystemTimestampsCurrent, ensureDispatchSubscriptionsSystemTableCompatibility, ensureDispatchSystemTableCompatibility, ensureJobEventsSystemTableCompatibility, ensureJobsSystemTableCompatibility, ensureLegacySystemTableCompatibility, getDatabaseEngine, migratePostgresSystemTimestamps, tableExists } from "./compatibility.js";
-export { assertPostgresSystemTimestampsCurrent, ensureDispatchSubscriptionsSystemTableCompatibility, ensureDispatchSystemTableCompatibility, ensureJobEventsSystemTableCompatibility, ensureJobsSystemTableCompatibility, ensureLegacySystemTableCompatibility, getDatabaseEngine, migratePostgresSystemTimestamps, tableExists };
+import { assertPostgresSystemTimestampsCurrent, ensureDispatchSubscriptionsSystemTableCompatibility, ensureDispatchSystemTableCompatibility, ensureJobEventsSystemTableCompatibility, ensureJobsSystemTableCompatibility, ensureLegacySystemTableCompatibility, getDatabaseEngine, migratePostgresSystemTimestamps, planPostgresSystemTimestampMigrations, tableExists } from "./compatibility.js";
+export { assertPostgresSystemTimestampsCurrent, ensureDispatchSubscriptionsSystemTableCompatibility, ensureDispatchSystemTableCompatibility, ensureJobEventsSystemTableCompatibility, ensureJobsSystemTableCompatibility, ensureLegacySystemTableCompatibility, getDatabaseEngine, migratePostgresSystemTimestamps, planPostgresSystemTimestampMigrations, tableExists };

package/dist/vite-plugin/api-client-entries.d.ts

@@ -1,4 +1,5 @@
 import { SmartObjectDefinition, SmartObjectManifest } from '../scanner/types.js';
+export type ApiClientCrudMethod = 'list' | 'get' | 'create' | 'update' | 'delete' | 'search';
 export interface ApiClientEntry {
     /** Original key in manifest.objects. */
     objectName: string;
@@ -8,7 +9,23 @@ export interface ApiClientEntry {
     clientKey: string;
     /** Row-payload interface used by CRUD methods for this entry. */
     dataInterfaceName: string;
+    /** Standard client operations whose server routes are actually emitted. */
+    crudMethods: ApiClientCrudMethod[];
+    /** Custom methods whose routes are actually emitted by the server. */
+    customMethods: Array<{
+        name: string;
+        scope: 'item' | 'collection';
+        pathParamNames: string[];
+        parameters: Array<{
+            name: string;
+            type: string;
+            optional?: boolean;
+            default?: unknown;
+        }>;
+    }>;
 }
+export declare function renderApiClientCrudType(dataInterfaceName: string, crudMethods: ApiClientCrudMethod[], overriddenMethods?: string[]): string | undefined;
+export declare function renderApiClientCustomMethodParameters(method: ApiClientEntry['customMethods'][number], mapType: (type: string) => string): string;
 /**
  * Select every generated client entry with deterministic endpoint keys and row
  * payload types. Exactly one entry owns each canonical collection key; other

package/dist/vite-plugin/api-client-entries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-client-entries.d.ts","sourceRoot":"","sources":["../../src/vite-plugin/api-client-entries.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,GAAG,EAAE,qBAAqB,CAAC;IAC3B,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAuKD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,GAC5B,cAAc,EAAE,CAmElB"}
+{"version":3,"file":"api-client-entries.d.ts","sourceRoot":"","sources":["../../src/vite-plugin/api-client-entries.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAQ7B,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,KAAK,GACL,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,GAAG,EAAE,qBAAqB,CAAC;IAC3B,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,sEAAsE;IACtE,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;QAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,UAAU,EAAE,KAAK,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AAED,wBAAgB,uBAAuB,CACrC,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,mBAAmB,EAAE,EAClC,iBAAiB,GAAE,MAAM,EAAO,GAC/B,MAAM,GAAG,SAAS,CAepB;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAC/C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAChC,MAAM,CAoCR;AAoTD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,GAC5B,cAAc,EAAE,CAwElB"}