@happyvertical/smrt-core 0.40.61 → 0.40.62

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\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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"}
+{"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  // MCP task support was added after `_smrt_jobs` had already shipped. Keep\n  // the task projection in the job row so a task can never outlive (or lose\n  // track of) the worker job that executes it. JSON is portable here because\n  // SMRT's adapters serialize JSON fields to text where necessary.\n  await addColumnIfMissing(db, '_smrt_jobs', 'task_id', 'TEXT', typeHint);\n  await addColumnIfMissing(db, '_smrt_jobs', 'task_owner_id', 'TEXT', typeHint);\n  await addColumnIfMissing(db, '_smrt_jobs', 'task_result', 'TEXT', typeHint);\n  await addColumnIfMissing(\n    db,\n    '_smrt_jobs',\n    'task_input_requests',\n    'TEXT',\n    typeHint,\n  );\n  await addColumnIfMissing(\n    db,\n    '_smrt_jobs',\n    'task_input_responses',\n    'TEXT',\n    typeHint,\n  );\n  await addUniqueIndexIfMissing(\n    db,\n    'idx_smrt_jobs_task_id',\n    '_smrt_jobs',\n    'task_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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-core",
-  "version": "0.40.61",
+  "version": "0.40.62",
   "description": "Core AI agent framework with standardized collections, object-relational mapping, and code generators",
   "author": "HappyVertical",
   "type": "module",
@@ -164,9 +164,9 @@
     "tsx": "^4.23.0",
     "typescript": "5.9.3",
     "yaml": "^2.9.0",
-    "@happyvertical/smrt-scanner": "0.40.61",
-    "@happyvertical/smrt-config": "0.40.61",
-    "@happyvertical/smrt-types": "0.40.61"
+    "@happyvertical/smrt-config": "0.40.62",
+    "@happyvertical/smrt-scanner": "0.40.62",
+    "@happyvertical/smrt-types": "0.40.62"
   },
   "peerDependencies": {
     "@huggingface/transformers": ">=3.0.0 <4.0.0",