@powerhousedao/reactor 6.2.2-dev.9 → 6.2.2-staging.0

package/dist/projection-entry.js

@@ -1,8 +1,8 @@
-import { S as CollectionMembershipCache, _ as KyselyWriteCache, d as KyselyKeyframeStore, f as DocumentModelRegistry, g as EventBus, n as REACTOR_SCHEMA, o as instrumentPgPool, s as KyselyOperationStore, v as KyselyOperationIndex, y as DocumentMetaCache } from "./drive-container-types-DpJp2AmE.js";
+import { _ as DocumentMetaCache, c as KyselyKeyframeStore, g as KyselyOperationIndex, h as KyselyWriteCache, l as DocumentModelRegistry, m as EventBus, n as REACTOR_SCHEMA, o as instrumentPgPool, s as KyselyOperationStore, v as CollectionMembershipCache } from "./drive-container-types-yZrksiJR.js";
 import { n as ReactorEventTypes } from "./types-DMKLa0Ok.js";
-import { a as ReadModelCoordinator, i as KyselyDocumentView, n as ConsistencyTracker, t as KyselyDocumentIndexer } from "./document-indexer-FGJmRAdX.js";
+import { i as KyselyDocumentView, n as ConsistencyTracker, s as ReadModelCoordinator, t as KyselyDocumentIndexer } from "./document-indexer-C5Gsa1B3.js";
 import { n as errorToInfo, t as createForwardingLogger } from "./forwarding-logger-BBkMSxuJ.js";
-import { n as defaultLoadFactory } from "./build-worker-executor--nhFRF47.js";
+import { n as defaultLoadFactory } from "./build-worker-executor-DnU3ZU4H.js";
 import { ConsoleLogger } from "document-model";
 import { isMainThread, parentPort } from "node:worker_threads";
 //#region src/projection/projection-worker/build-projection-stack.ts
@@ -24,7 +24,7 @@ async function loadModelManifest(entries, loadFactory, registry, logger) {
 }
 function instantiateReadModel(kind, database, operationStore, operationIndex, writeCache) {
 	switch (kind) {
-		case "document-view": return new KyselyDocumentView(database, operationStore, operationIndex, writeCache, new ConsistencyTracker());
+		case "document-view": return new KyselyDocumentView(database, operationStore, operationIndex, writeCache, new ConsistencyTracker(), false);
 		case "document-indexer": return new KyselyDocumentIndexer(database, operationIndex, writeCache, new ConsistencyTracker());
 		default: {
 			const exhaustive = kind;

package/dist/projection-entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"projection-entry.js","names":[],"sources":["../src/projection/projection-worker/build-projection-stack.ts","../src/projection/projection-worker/run-projection-worker.ts","../src/projection/projection-worker/projection-entry.ts"],"sourcesContent":["/**\n * In-worker projection stack builder.\n *\n * Mirrors {@link buildWorkerExecutor} but for the projection-side\n * read models. The worker owns one full copy of the storage stack — read\n * cache, operation index, document-meta cache — bound to its own\n * pg.Pool/Kysely, plus an in-process `ReadModelCoordinator` that\n * subscribes to a local `EventBus`.\n *\n * The host relays JOB_WRITE_READY into the local bus by calling\n * `relayWriteReady`, and forwards the local bus's JOB_READ_READY plus\n * READMODEL_* events back to the host bus via the IPC bridge.\n */\n\nimport type { DocumentModelModule } from \"@powerhousedao/shared/document-model\";\nimport type { ILogger } from \"document-model\";\nimport type { Kysely } from \"kysely\";\nimport { CollectionMembershipCache } from \"../../cache/collection-membership-cache.js\";\nimport { DocumentMetaCache } from \"../../cache/document-meta-cache.js\";\nimport { KyselyOperationIndex } from \"../../cache/kysely-operation-index.js\";\nimport { KyselyWriteCache } from \"../../cache/kysely-write-cache.js\";\nimport type { WriteCacheConfig } from \"../../cache/write-cache-types.js\";\nimport type { Database } from \"../../core/types.js\";\nimport { EventBus } from \"../../events/event-bus.js\";\nimport {\n  ReactorEventTypes,\n  type JobReadReadyEvent,\n  type JobWriteReadyEvent,\n  type ReadModelBatchCompletedEvent,\n  type ReadModelIndexedEvent,\n  type Unsubscribe,\n} from \"../../events/types.js\";\nimport {\n  defaultLoadFactory,\n  type BuildWorkerExecutorOptions,\n} from \"../../executor/worker/build-worker-executor.js\";\nimport type {\n  FactorySpec,\n  ModelManifestEntry,\n} from \"../../executor/worker/protocol.js\";\nimport { ReadModelCoordinator } from \"../../read-models/coordinator.js\";\nimport { KyselyDocumentView } from \"../../read-models/document-view.js\";\nimport type { IReadModel } from \"../../read-models/interfaces.js\";\nimport { DocumentModelRegistry } from \"../../registry/implementation.js\";\nimport { ConsistencyTracker } from \"../../shared/consistency-tracker.js\";\nimport {\n  KyselyDocumentIndexer,\n  type IndexerDatabase,\n} from \"../../storage/kysely/document-indexer.js\";\nimport { KyselyKeyframeStore } from \"../../storage/kysely/keyframe-store.js\";\nimport { KyselyOperationStore } from \"../../storage/kysely/store.js\";\nimport type { Database as StorageDatabase } from \"../../storage/kysely/types.js\";\nimport { REACTOR_SCHEMA } from \"../../storage/migrations/migrator.js\";\nimport type {\n  BuiltInReadModelKind,\n  ProjectionInitMessage,\n} from \"../protocol.js\";\n\nexport type ProjectionStackEvents = {\n  onReadReady: (event: JobReadReadyEvent) => void;\n  onReadModelIndexed: (event: ReadModelIndexedEvent) => void;\n  onBatchCompleted: (event: ReadModelBatchCompletedEvent) => void;\n};\n\nexport type ProjectionStack = {\n  registry: DocumentModelRegistry;\n  coordinator: ReadModelCoordinator;\n  eventBus: EventBus;\n  relayWriteReady(event: JobWriteReadyEvent): Promise<void>;\n  getChainDepth(): number;\n  drain(): Promise<void>;\n  shutdown(): Promise<void>;\n};\n\nexport type BuildProjectionStackOptions = {\n  init: ProjectionInitMessage;\n  database: Kysely<Database>;\n  logger: ILogger;\n  events: ProjectionStackEvents;\n  loadFactory?: BuildWorkerExecutorOptions[\"loadFactory\"];\n  driveContainerTypes?: ReadonlySet<string>;\n};\n\nasync function loadModelManifest(\n  entries: ModelManifestEntry[],\n  loadFactory: (spec: FactorySpec) => Promise<unknown>,\n  registry: DocumentModelRegistry,\n  logger: ILogger,\n): Promise<void> {\n  for (const entry of entries) {\n    let module: DocumentModelModule;\n    try {\n      module = (await loadFactory(entry.spec)) as DocumentModelModule;\n    } catch (error) {\n      logger.error(\n        \"projection worker failed to load document model: @entry @error\",\n        entry,\n        error,\n      );\n      throw error;\n    }\n    const [result] = registry.registerModules(module);\n    if (result.status === \"error\") {\n      logger.error(\n        \"projection worker failed to register document model: @entry @error\",\n        entry,\n        result.error,\n      );\n      throw result.error;\n    }\n  }\n}\n\nfunction instantiateReadModel(\n  kind: BuiltInReadModelKind,\n  database: Kysely<Database>,\n  operationStore: KyselyOperationStore,\n  operationIndex: KyselyOperationIndex,\n  writeCache: KyselyWriteCache,\n): IReadModel {\n  switch (kind) {\n    case \"document-view\": {\n      return new KyselyDocumentView(\n        // @ts-expect-error - Database superset\n        database,\n        operationStore,\n        operationIndex,\n        writeCache,\n        new ConsistencyTracker(),\n      );\n    }\n    case \"document-indexer\": {\n      return new KyselyDocumentIndexer(\n        database as unknown as Kysely<IndexerDatabase>,\n        operationIndex,\n        writeCache,\n        new ConsistencyTracker(),\n      );\n    }\n    default: {\n      const exhaustive: never = kind;\n      throw new Error(\n        `unknown built-in read model kind: ${String(exhaustive)}`,\n      );\n    }\n  }\n}\n\nasync function initReadModels(\n  models: IReadModel[],\n  logger: ILogger,\n): Promise<void> {\n  for (const model of models) {\n    const maybeInit = model as IReadModel & { init?: () => Promise<void> };\n    if (typeof maybeInit.init !== \"function\") {\n      continue;\n    }\n    try {\n      await maybeInit.init();\n    } catch (error) {\n      logger.error(\n        \"projection worker read model init failed: @name @error\",\n        model.name,\n        error,\n      );\n      throw error;\n    }\n  }\n}\n\nexport async function buildProjectionStack(\n  options: BuildProjectionStackOptions,\n): Promise<ProjectionStack> {\n  const { init, database: baseDatabase, logger, events } = options;\n  const loadFactory = options.loadFactory ?? defaultLoadFactory;\n\n  const registry = new DocumentModelRegistry();\n  await loadModelManifest(init.models, loadFactory, registry, logger);\n\n  const database = baseDatabase.withSchema(REACTOR_SCHEMA);\n  const operationStore = new KyselyOperationStore(\n    database as unknown as Kysely<StorageDatabase>,\n  );\n  const keyframeStore = new KyselyKeyframeStore(\n    database as unknown as Kysely<StorageDatabase>,\n  );\n\n  const cacheConfig: WriteCacheConfig = {\n    maxDocuments: 100,\n    ringBufferSize: 10,\n    keyframeInterval: 10,\n  };\n  const writeCache = new KyselyWriteCache(\n    keyframeStore,\n    operationStore,\n    registry,\n    cacheConfig,\n  );\n  await writeCache.startup();\n\n  const operationIndex = new KyselyOperationIndex(\n    database as unknown as Kysely<StorageDatabase>,\n  );\n\n  const documentMetaCache = new DocumentMetaCache(operationStore, {\n    maxDocuments: 1000,\n  });\n  await documentMetaCache.startup();\n\n  const collectionMembershipCache = new CollectionMembershipCache(\n    operationIndex,\n  );\n  void collectionMembershipCache;\n  void documentMetaCache;\n\n  const preReady = init.preReadyKinds.map((kind) =>\n    instantiateReadModel(\n      kind,\n      database,\n      operationStore,\n      operationIndex,\n      writeCache,\n    ),\n  );\n  const postReady = init.postReadyKinds.map((kind) =>\n    instantiateReadModel(\n      kind,\n      database,\n      operationStore,\n      operationIndex,\n      writeCache,\n    ),\n  );\n\n  await initReadModels([...preReady, ...postReady], logger);\n\n  const eventBus = new EventBus();\n  const subscriptions: Unsubscribe[] = [];\n\n  subscriptions.push(\n    eventBus.subscribe(\n      ReactorEventTypes.JOB_READ_READY,\n      (_t: number, event: JobReadReadyEvent) => {\n        events.onReadReady(event);\n      },\n    ),\n  );\n  subscriptions.push(\n    eventBus.subscribe(\n      ReactorEventTypes.READMODEL_INDEXED,\n      (_t: number, event: ReadModelIndexedEvent) => {\n        events.onReadModelIndexed(event);\n      },\n    ),\n  );\n  subscriptions.push(\n    eventBus.subscribe(\n      ReactorEventTypes.READMODEL_BATCH_COMPLETED,\n      (_t: number, event: ReadModelBatchCompletedEvent) => {\n        events.onBatchCompleted(event);\n      },\n    ),\n  );\n\n  const coordinator = new ReadModelCoordinator(eventBus, preReady, postReady);\n  coordinator.start();\n\n  return {\n    registry,\n    coordinator,\n    eventBus,\n    async relayWriteReady(event: JobWriteReadyEvent): Promise<void> {\n      await eventBus.emit(ReactorEventTypes.JOB_WRITE_READY, event);\n    },\n    getChainDepth(): number {\n      return coordinator.getChainDepth();\n    },\n    async drain(): Promise<void> {\n      await coordinator.drain();\n    },\n    shutdown(): Promise<void> {\n      coordinator.stop();\n      for (const unsub of subscriptions) {\n        unsub();\n      }\n      return Promise.resolve();\n    },\n  };\n}\n","import { ConsoleLogger } from \"document-model\";\nimport type { Kysely } from \"kysely\";\nimport type { MessagePort } from \"node:worker_threads\";\nimport type { Database } from \"../../core/types.js\";\nimport { createForwardingLogger } from \"../../executor/worker/forwarding-logger.js\";\nimport type { DbConfig } from \"../../executor/worker/protocol.js\";\nimport { errorToInfo } from \"../../executor/worker/sanitize.js\";\nimport type {\n  JobReadReadyEvent,\n  JobWriteReadyEvent,\n  ReadModelBatchCompletedEvent,\n  ReadModelIndexedEvent,\n} from \"../../events/types.js\";\nimport {\n  instrumentPgPool,\n  type PoolInstrumentation,\n} from \"../../storage/pool-instrumentation.js\";\nimport type {\n  ProjectionInitMessage,\n  ProjectionParentMessage,\n  ProjectionWorkerMessage,\n} from \"../protocol.js\";\nimport {\n  buildProjectionStack,\n  type ProjectionStack,\n} from \"./build-projection-stack.js\";\n\nconst POOL_SAMPLE_INTERVAL_MS = 1_000;\n\n/**\n * Closeable handle around the worker's Postgres pool. Decoupled from the\n * default factory so tests can swap in PGlite via `RunProjectionWorkerOverrides`.\n *\n * When the worker owns a real pg.Pool, the handle exposes a\n * {@link PoolInstrumentation} so the run loop can forward acquire-wait\n * samples to the host. Tests that swap in PGlite leave this undefined.\n */\nexport type ProjectionWorkerDatabaseHandle = {\n  kysely: Kysely<Database>;\n  poolInstrumentation?: PoolInstrumentation;\n  shutdown(): Promise<void>;\n};\n\nexport type RunProjectionWorkerOverrides = {\n  createDatabase?: (\n    config: DbConfig,\n    shardId: string,\n  ) => Promise<ProjectionWorkerDatabaseHandle>;\n  loadFactory?: Parameters<typeof buildProjectionStack>[0][\"loadFactory\"];\n  beforeBuildStack?: (db: Kysely<Database>) => Promise<void>;\n};\n\nasync function defaultCreateDatabase(\n  config: DbConfig,\n  shardId: string,\n): Promise<ProjectionWorkerDatabaseHandle> {\n  const { Kysely, PostgresDialect } = await import(\"kysely\");\n  const pgModule = await import(\"pg\");\n  const Pool = pgModule.default.Pool;\n  const pool = new Pool({\n    host: config.host,\n    port: config.port,\n    database: config.database,\n    user: config.user,\n    password: config.password,\n    ssl: config.ssl ? { rejectUnauthorized: false } : undefined,\n    application_name: config.applicationName ?? shardId,\n    max: config.poolSize,\n    connectionTimeoutMillis: config.connectionTimeoutMillis,\n    idleTimeoutMillis: config.idleTimeoutMillis,\n  });\n  const poolInstrumentation = instrumentPgPool(pool, shardId);\n  const kysely = new Kysely<Database>({\n    dialect: new PostgresDialect({ pool }),\n  });\n  return {\n    kysely,\n    poolInstrumentation,\n    async shutdown(): Promise<void> {\n      try {\n        await kysely.destroy();\n      } catch {\n        // best-effort\n      }\n      try {\n        await pool.end();\n      } catch {\n        // best-effort\n      }\n    },\n  };\n}\n\n/**\n * Drives the projection worker's message loop. Owns lifecycle of the\n * database handle and the projection stack. The default factory builds a\n * real Postgres pool; tests inject overrides for an in-process PGlite path.\n */\nexport function runProjectionWorker(\n  parentPort: MessagePort,\n  overrides: RunProjectionWorkerOverrides = {},\n): void {\n  let shardId = \"\";\n  let initCompleted = false;\n  let stack: ProjectionStack | null = null;\n  let database: ProjectionWorkerDatabaseHandle | null = null;\n  let depthTimer: NodeJS.Timeout | null = null;\n  let lastReportedDepth = -1;\n  let poolSampleTimer: NodeJS.Timeout | null = null;\n  let pendingPoolSamples: number[] = [];\n  let detachPoolListener: (() => void) | null = null;\n\n  function post(msg: ProjectionWorkerMessage): void {\n    parentPort.postMessage(msg);\n  }\n\n  function startPoolReporter(instrumentation: PoolInstrumentation): void {\n    detachPoolListener = instrumentation.onAcquire((durationMs) => {\n      pendingPoolSamples.push(durationMs);\n    });\n    poolSampleTimer = setInterval(() => {\n      if (pendingPoolSamples.length === 0) {\n        return;\n      }\n      const durations = pendingPoolSamples;\n      pendingPoolSamples = [];\n      const stats = instrumentation.getStats();\n      post({\n        type: \"pool-acquire-samples\",\n        shardId,\n        poolName: instrumentation.name,\n        timestamp: Date.now(),\n        durations,\n        size: stats.size,\n        idle: stats.idle,\n        waiting: stats.waiting,\n      });\n    }, POOL_SAMPLE_INTERVAL_MS);\n    poolSampleTimer.unref();\n  }\n\n  function stopPoolReporter(): void {\n    if (detachPoolListener) {\n      detachPoolListener();\n      detachPoolListener = null;\n    }\n    if (poolSampleTimer) {\n      clearInterval(poolSampleTimer);\n      poolSampleTimer = null;\n    }\n    pendingPoolSamples = [];\n  }\n\n  const logger = createForwardingLogger((msg) => post({ ...msg, shardId }));\n\n  process.on(\"uncaughtException\", (err: unknown) => {\n    try {\n      post({\n        type: \"log\",\n        shardId,\n        level: \"error\",\n        message: \"projection worker uncaughtException\",\n        args: [errorToInfo(err)],\n        timestamp: Date.now(),\n      });\n    } catch {\n      // nothing left to do\n    }\n    throw err;\n  });\n\n  process.on(\"unhandledRejection\", (reason: unknown) => {\n    try {\n      post({\n        type: \"log\",\n        shardId,\n        level: \"error\",\n        message: \"projection worker unhandledRejection\",\n        args: [errorToInfo(reason)],\n        timestamp: Date.now(),\n      });\n    } catch {\n      // nothing left to do\n    }\n  });\n\n  function startDepthReporter(intervalMs: number): void {\n    if (intervalMs <= 0) {\n      return;\n    }\n    depthTimer = setInterval(() => {\n      if (!stack) {\n        return;\n      }\n      const depth = stack.getChainDepth();\n      if (depth === lastReportedDepth) {\n        return;\n      }\n      lastReportedDepth = depth;\n      post({\n        type: \"chain-depth\",\n        shardId,\n        depth,\n        timestamp: Date.now(),\n      });\n    }, intervalMs);\n    depthTimer.unref();\n  }\n\n  function stopDepthReporter(): void {\n    if (depthTimer) {\n      clearInterval(depthTimer);\n      depthTimer = null;\n    }\n  }\n\n  async function handleInit(msg: ProjectionInitMessage): Promise<void> {\n    shardId = msg.shardId;\n    const createDb = overrides.createDatabase ?? defaultCreateDatabase;\n    database = await createDb(msg.db, msg.shardId);\n    if (overrides.beforeBuildStack) {\n      await overrides.beforeBuildStack(database.kysely);\n    }\n    stack = await buildProjectionStack({\n      init: msg,\n      database: database.kysely,\n      logger: new ConsoleLogger([`projection-shard:${msg.shardId}`]),\n      loadFactory: overrides.loadFactory,\n      events: {\n        onReadReady: (event: JobReadReadyEvent) => {\n          post({\n            type: \"read-ready\",\n            shardId,\n            jobId: event.jobId,\n            operations: event.operations,\n          });\n        },\n        onReadModelIndexed: (event: ReadModelIndexedEvent) => {\n          post({\n            type: \"readmodel-indexed\",\n            shardId,\n            jobId: event.jobId,\n            readModelName: event.readModelName,\n            stage: event.stage,\n            durationMs: event.durationMs,\n            operationCount: event.operationCount,\n            success: event.success,\n          });\n        },\n        onBatchCompleted: (event: ReadModelBatchCompletedEvent) => {\n          post({\n            type: \"readmodel-batch-completed\",\n            shardId,\n            jobId: event.jobId,\n            batchSize: event.batchSize,\n            chainWaitDurationMs: event.chainWaitDurationMs,\n            preReadyDurationMs: event.preReadyDurationMs,\n            emitDurationMs: event.emitDurationMs,\n            postReadyDurationMs: event.postReadyDurationMs,\n          });\n        },\n      },\n    });\n    initCompleted = true;\n    startDepthReporter(msg.chainDepthReportIntervalMs);\n    if (database.poolInstrumentation) {\n      startPoolReporter(database.poolInstrumentation);\n    }\n    logger.info(\"projection worker initialized: @shardId\", msg.shardId);\n    post({ type: \"ready\", correlationId: msg.correlationId, shardId });\n  }\n\n  async function handleWriteReady(\n    msg: Extract<ProjectionParentMessage, { type: \"write-ready\" }>,\n  ): Promise<void> {\n    if (!stack) {\n      logger.warn(\n        \"write-ready received before init on shard @shardId\",\n        shardId,\n      );\n      return;\n    }\n    const event: JobWriteReadyEvent = {\n      jobId: msg.jobId,\n      operations: msg.operations,\n      jobMeta: msg.jobMeta,\n      collectionMemberships: msg.collectionMemberships,\n    };\n    await stack.relayWriteReady(event);\n  }\n\n  async function handleDrain(correlationId: string): Promise<void> {\n    if (stack) {\n      await stack.drain();\n    }\n    post({ type: \"drained\", correlationId, shardId });\n  }\n\n  async function shutdownStack(): Promise<void> {\n    stopDepthReporter();\n    stopPoolReporter();\n    if (stack) {\n      try {\n        await stack.drain();\n      } catch (error) {\n        logger.warn(\n          \"projection worker drain failed during shutdown: @error\",\n          error,\n        );\n      }\n      try {\n        await stack.shutdown();\n      } catch (error) {\n        logger.warn(\"projection worker stack shutdown failed: @error\", error);\n      }\n      stack = null;\n    }\n    if (database) {\n      await database.shutdown();\n      database = null;\n    }\n  }\n\n  function handleParentMessage(msg: ProjectionParentMessage): void {\n    switch (msg.type) {\n      case \"init\": {\n        handleInit(msg).catch((err: unknown) => {\n          post({\n            type: \"log\",\n            shardId,\n            level: \"error\",\n            message: \"projection worker init failed\",\n            args: [errorToInfo(err)],\n            timestamp: Date.now(),\n          });\n        });\n        break;\n      }\n      case \"write-ready\": {\n        if (!initCompleted) {\n          logger.warn(\n            \"write-ready received before init on shard @shardId\",\n            shardId,\n          );\n          break;\n        }\n        handleWriteReady(msg).catch((err: unknown) => {\n          post({\n            type: \"log\",\n            shardId,\n            level: \"error\",\n            message: \"projection worker write-ready failed\",\n            args: [errorToInfo(err)],\n            timestamp: Date.now(),\n          });\n        });\n        break;\n      }\n      case \"drain\": {\n        handleDrain(msg.correlationId).catch((err: unknown) => {\n          post({\n            type: \"log\",\n            shardId,\n            level: \"error\",\n            message: \"projection worker drain failed\",\n            args: [errorToInfo(err)],\n            timestamp: Date.now(),\n          });\n        });\n        break;\n      }\n      case \"shutdown\": {\n        logger.info(\"projection worker shutting down: @shardId\", shardId);\n        void shutdownStack().finally(() => {\n          post({\n            type: \"log\",\n            shardId,\n            level: \"info\",\n            message: \"projection worker shutdown\",\n            args: [],\n            timestamp: Date.now(),\n          });\n          process.exit(0);\n        });\n        break;\n      }\n      default: {\n        const exhaustive: never = msg;\n        void exhaustive;\n        break;\n      }\n    }\n  }\n\n  parentPort.on(\"message\", handleParentMessage);\n\n  const harness = {\n    handleParentMessage,\n    get initCompleted(): boolean {\n      return initCompleted;\n    },\n    get shardId(): string {\n      return shardId;\n    },\n  };\n  (\n    parentPort as unknown as { __reactorProjectionWorkerHarness?: unknown }\n  ).__reactorProjectionWorkerHarness = harness;\n}\n","import { isMainThread, parentPort } from \"node:worker_threads\";\nimport { runProjectionWorker } from \"./run-projection-worker.js\";\n\nif (isMainThread || parentPort === null) {\n  throw new Error(\"projection-worker entry.ts must be run as a worker thread\");\n}\n\nrunProjectionWorker(parentPort);\n"],"mappings":"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"}
+{"version":3,"file":"projection-entry.js","names":[],"sources":["../src/projection/projection-worker/build-projection-stack.ts","../src/projection/projection-worker/run-projection-worker.ts","../src/projection/projection-worker/projection-entry.ts"],"sourcesContent":["/**\n * In-worker projection stack builder.\n *\n * Mirrors {@link buildWorkerExecutor} but for the projection-side\n * read models. The worker owns one full copy of the storage stack — read\n * cache, operation index, document-meta cache — bound to its own\n * pg.Pool/Kysely, plus an in-process `ReadModelCoordinator` that\n * subscribes to a local `EventBus`.\n *\n * The host relays JOB_WRITE_READY into the local bus by calling\n * `relayWriteReady`, and forwards the local bus's JOB_READ_READY plus\n * READMODEL_* events back to the host bus via the IPC bridge.\n */\n\nimport type { DocumentModelModule } from \"@powerhousedao/shared/document-model\";\nimport type { ILogger } from \"document-model\";\nimport type { Kysely } from \"kysely\";\nimport { CollectionMembershipCache } from \"../../cache/collection-membership-cache.js\";\nimport { DocumentMetaCache } from \"../../cache/document-meta-cache.js\";\nimport { KyselyOperationIndex } from \"../../cache/kysely-operation-index.js\";\nimport { KyselyWriteCache } from \"../../cache/kysely-write-cache.js\";\nimport type { WriteCacheConfig } from \"../../cache/write-cache-types.js\";\nimport type { Database } from \"../../core/types.js\";\nimport { EventBus } from \"../../events/event-bus.js\";\nimport {\n  ReactorEventTypes,\n  type JobReadReadyEvent,\n  type JobWriteReadyEvent,\n  type ReadModelBatchCompletedEvent,\n  type ReadModelIndexedEvent,\n  type Unsubscribe,\n} from \"../../events/types.js\";\nimport {\n  defaultLoadFactory,\n  type BuildWorkerExecutorOptions,\n} from \"../../executor/worker/build-worker-executor.js\";\nimport type {\n  FactorySpec,\n  ModelManifestEntry,\n} from \"../../executor/worker/protocol.js\";\nimport { ReadModelCoordinator } from \"../../read-models/coordinator.js\";\nimport { KyselyDocumentView } from \"../../read-models/document-view.js\";\nimport type { IReadModel } from \"../../read-models/interfaces.js\";\nimport { DocumentModelRegistry } from \"../../registry/implementation.js\";\nimport { ConsistencyTracker } from \"../../shared/consistency-tracker.js\";\nimport {\n  KyselyDocumentIndexer,\n  type IndexerDatabase,\n} from \"../../storage/kysely/document-indexer.js\";\nimport { KyselyKeyframeStore } from \"../../storage/kysely/keyframe-store.js\";\nimport { KyselyOperationStore } from \"../../storage/kysely/store.js\";\nimport type { Database as StorageDatabase } from \"../../storage/kysely/types.js\";\nimport { REACTOR_SCHEMA } from \"../../storage/migrations/migrator.js\";\nimport type {\n  BuiltInReadModelKind,\n  ProjectionInitMessage,\n} from \"../protocol.js\";\n\nexport type ProjectionStackEvents = {\n  onReadReady: (event: JobReadReadyEvent) => void;\n  onReadModelIndexed: (event: ReadModelIndexedEvent) => void;\n  onBatchCompleted: (event: ReadModelBatchCompletedEvent) => void;\n};\n\nexport type ProjectionStack = {\n  registry: DocumentModelRegistry;\n  coordinator: ReadModelCoordinator;\n  eventBus: EventBus;\n  relayWriteReady(event: JobWriteReadyEvent): Promise<void>;\n  getChainDepth(): number;\n  drain(): Promise<void>;\n  shutdown(): Promise<void>;\n};\n\nexport type BuildProjectionStackOptions = {\n  init: ProjectionInitMessage;\n  database: Kysely<Database>;\n  logger: ILogger;\n  events: ProjectionStackEvents;\n  loadFactory?: BuildWorkerExecutorOptions[\"loadFactory\"];\n  driveContainerTypes?: ReadonlySet<string>;\n};\n\nasync function loadModelManifest(\n  entries: ModelManifestEntry[],\n  loadFactory: (spec: FactorySpec) => Promise<unknown>,\n  registry: DocumentModelRegistry,\n  logger: ILogger,\n): Promise<void> {\n  for (const entry of entries) {\n    let module: DocumentModelModule;\n    try {\n      module = (await loadFactory(entry.spec)) as DocumentModelModule;\n    } catch (error) {\n      logger.error(\n        \"projection worker failed to load document model: @entry @error\",\n        entry,\n        error,\n      );\n      throw error;\n    }\n    const [result] = registry.registerModules(module);\n    if (result.status === \"error\") {\n      logger.error(\n        \"projection worker failed to register document model: @entry @error\",\n        entry,\n        result.error,\n      );\n      throw result.error;\n    }\n  }\n}\n\nfunction instantiateReadModel(\n  kind: BuiltInReadModelKind,\n  database: Kysely<Database>,\n  operationStore: KyselyOperationStore,\n  operationIndex: KyselyOperationIndex,\n  writeCache: KyselyWriteCache,\n): IReadModel {\n  switch (kind) {\n    case \"document-view\": {\n      return new KyselyDocumentView(\n        // @ts-expect-error - Database superset\n        database,\n        operationStore,\n        operationIndex,\n        writeCache,\n        new ConsistencyTracker(),\n        // The init payload carries no feature flags, so this view keeps hiding a\n        // deleted document. Read-side only, so it cannot diverge state.\n        false,\n      );\n    }\n    case \"document-indexer\": {\n      return new KyselyDocumentIndexer(\n        database as unknown as Kysely<IndexerDatabase>,\n        operationIndex,\n        writeCache,\n        new ConsistencyTracker(),\n      );\n    }\n    default: {\n      const exhaustive: never = kind;\n      throw new Error(\n        `unknown built-in read model kind: ${String(exhaustive)}`,\n      );\n    }\n  }\n}\n\nasync function initReadModels(\n  models: IReadModel[],\n  logger: ILogger,\n): Promise<void> {\n  for (const model of models) {\n    const maybeInit = model as IReadModel & { init?: () => Promise<void> };\n    if (typeof maybeInit.init !== \"function\") {\n      continue;\n    }\n    try {\n      await maybeInit.init();\n    } catch (error) {\n      logger.error(\n        \"projection worker read model init failed: @name @error\",\n        model.name,\n        error,\n      );\n      throw error;\n    }\n  }\n}\n\nexport async function buildProjectionStack(\n  options: BuildProjectionStackOptions,\n): Promise<ProjectionStack> {\n  const { init, database: baseDatabase, logger, events } = options;\n  const loadFactory = options.loadFactory ?? defaultLoadFactory;\n\n  const registry = new DocumentModelRegistry();\n  await loadModelManifest(init.models, loadFactory, registry, logger);\n\n  const database = baseDatabase.withSchema(REACTOR_SCHEMA);\n  const operationStore = new KyselyOperationStore(\n    database as unknown as Kysely<StorageDatabase>,\n  );\n  const keyframeStore = new KyselyKeyframeStore(\n    database as unknown as Kysely<StorageDatabase>,\n  );\n\n  const cacheConfig: WriteCacheConfig = {\n    maxDocuments: 100,\n    ringBufferSize: 10,\n    keyframeInterval: 10,\n  };\n  const writeCache = new KyselyWriteCache(\n    keyframeStore,\n    operationStore,\n    registry,\n    cacheConfig,\n  );\n  await writeCache.startup();\n\n  const operationIndex = new KyselyOperationIndex(\n    database as unknown as Kysely<StorageDatabase>,\n  );\n\n  const documentMetaCache = new DocumentMetaCache(operationStore, {\n    maxDocuments: 1000,\n  });\n  await documentMetaCache.startup();\n\n  const collectionMembershipCache = new CollectionMembershipCache(\n    operationIndex,\n  );\n  void collectionMembershipCache;\n  void documentMetaCache;\n\n  const preReady = init.preReadyKinds.map((kind) =>\n    instantiateReadModel(\n      kind,\n      database,\n      operationStore,\n      operationIndex,\n      writeCache,\n    ),\n  );\n  const postReady = init.postReadyKinds.map((kind) =>\n    instantiateReadModel(\n      kind,\n      database,\n      operationStore,\n      operationIndex,\n      writeCache,\n    ),\n  );\n\n  await initReadModels([...preReady, ...postReady], logger);\n\n  const eventBus = new EventBus();\n  const subscriptions: Unsubscribe[] = [];\n\n  subscriptions.push(\n    eventBus.subscribe(\n      ReactorEventTypes.JOB_READ_READY,\n      (_t: number, event: JobReadReadyEvent) => {\n        events.onReadReady(event);\n      },\n    ),\n  );\n  subscriptions.push(\n    eventBus.subscribe(\n      ReactorEventTypes.READMODEL_INDEXED,\n      (_t: number, event: ReadModelIndexedEvent) => {\n        events.onReadModelIndexed(event);\n      },\n    ),\n  );\n  subscriptions.push(\n    eventBus.subscribe(\n      ReactorEventTypes.READMODEL_BATCH_COMPLETED,\n      (_t: number, event: ReadModelBatchCompletedEvent) => {\n        events.onBatchCompleted(event);\n      },\n    ),\n  );\n\n  const coordinator = new ReadModelCoordinator(eventBus, preReady, postReady);\n  coordinator.start();\n\n  return {\n    registry,\n    coordinator,\n    eventBus,\n    async relayWriteReady(event: JobWriteReadyEvent): Promise<void> {\n      await eventBus.emit(ReactorEventTypes.JOB_WRITE_READY, event);\n    },\n    getChainDepth(): number {\n      return coordinator.getChainDepth();\n    },\n    async drain(): Promise<void> {\n      await coordinator.drain();\n    },\n    shutdown(): Promise<void> {\n      coordinator.stop();\n      for (const unsub of subscriptions) {\n        unsub();\n      }\n      return Promise.resolve();\n    },\n  };\n}\n","import { ConsoleLogger } from \"document-model\";\nimport type { Kysely } from \"kysely\";\nimport type { MessagePort } from \"node:worker_threads\";\nimport type { Database } from \"../../core/types.js\";\nimport { createForwardingLogger } from \"../../executor/worker/forwarding-logger.js\";\nimport type { DbConfig } from \"../../executor/worker/protocol.js\";\nimport { errorToInfo } from \"../../executor/worker/sanitize.js\";\nimport type {\n  JobReadReadyEvent,\n  JobWriteReadyEvent,\n  ReadModelBatchCompletedEvent,\n  ReadModelIndexedEvent,\n} from \"../../events/types.js\";\nimport {\n  instrumentPgPool,\n  type PoolInstrumentation,\n} from \"../../storage/pool-instrumentation.js\";\nimport type {\n  ProjectionInitMessage,\n  ProjectionParentMessage,\n  ProjectionWorkerMessage,\n} from \"../protocol.js\";\nimport {\n  buildProjectionStack,\n  type ProjectionStack,\n} from \"./build-projection-stack.js\";\n\nconst POOL_SAMPLE_INTERVAL_MS = 1_000;\n\n/**\n * Closeable handle around the worker's Postgres pool. Decoupled from the\n * default factory so tests can swap in PGlite via `RunProjectionWorkerOverrides`.\n *\n * When the worker owns a real pg.Pool, the handle exposes a\n * {@link PoolInstrumentation} so the run loop can forward acquire-wait\n * samples to the host. Tests that swap in PGlite leave this undefined.\n */\nexport type ProjectionWorkerDatabaseHandle = {\n  kysely: Kysely<Database>;\n  poolInstrumentation?: PoolInstrumentation;\n  shutdown(): Promise<void>;\n};\n\nexport type RunProjectionWorkerOverrides = {\n  createDatabase?: (\n    config: DbConfig,\n    shardId: string,\n  ) => Promise<ProjectionWorkerDatabaseHandle>;\n  loadFactory?: Parameters<typeof buildProjectionStack>[0][\"loadFactory\"];\n  beforeBuildStack?: (db: Kysely<Database>) => Promise<void>;\n};\n\nasync function defaultCreateDatabase(\n  config: DbConfig,\n  shardId: string,\n): Promise<ProjectionWorkerDatabaseHandle> {\n  const { Kysely, PostgresDialect } = await import(\"kysely\");\n  const pgModule = await import(\"pg\");\n  const Pool = pgModule.default.Pool;\n  const pool = new Pool({\n    host: config.host,\n    port: config.port,\n    database: config.database,\n    user: config.user,\n    password: config.password,\n    ssl: config.ssl ? { rejectUnauthorized: false } : undefined,\n    application_name: config.applicationName ?? shardId,\n    max: config.poolSize,\n    connectionTimeoutMillis: config.connectionTimeoutMillis,\n    idleTimeoutMillis: config.idleTimeoutMillis,\n  });\n  const poolInstrumentation = instrumentPgPool(pool, shardId);\n  const kysely = new Kysely<Database>({\n    dialect: new PostgresDialect({ pool }),\n  });\n  return {\n    kysely,\n    poolInstrumentation,\n    async shutdown(): Promise<void> {\n      try {\n        await kysely.destroy();\n      } catch {\n        // best-effort\n      }\n      try {\n        await pool.end();\n      } catch {\n        // best-effort\n      }\n    },\n  };\n}\n\n/**\n * Drives the projection worker's message loop. Owns lifecycle of the\n * database handle and the projection stack. The default factory builds a\n * real Postgres pool; tests inject overrides for an in-process PGlite path.\n */\nexport function runProjectionWorker(\n  parentPort: MessagePort,\n  overrides: RunProjectionWorkerOverrides = {},\n): void {\n  let shardId = \"\";\n  let initCompleted = false;\n  let stack: ProjectionStack | null = null;\n  let database: ProjectionWorkerDatabaseHandle | null = null;\n  let depthTimer: NodeJS.Timeout | null = null;\n  let lastReportedDepth = -1;\n  let poolSampleTimer: NodeJS.Timeout | null = null;\n  let pendingPoolSamples: number[] = [];\n  let detachPoolListener: (() => void) | null = null;\n\n  function post(msg: ProjectionWorkerMessage): void {\n    parentPort.postMessage(msg);\n  }\n\n  function startPoolReporter(instrumentation: PoolInstrumentation): void {\n    detachPoolListener = instrumentation.onAcquire((durationMs) => {\n      pendingPoolSamples.push(durationMs);\n    });\n    poolSampleTimer = setInterval(() => {\n      if (pendingPoolSamples.length === 0) {\n        return;\n      }\n      const durations = pendingPoolSamples;\n      pendingPoolSamples = [];\n      const stats = instrumentation.getStats();\n      post({\n        type: \"pool-acquire-samples\",\n        shardId,\n        poolName: instrumentation.name,\n        timestamp: Date.now(),\n        durations,\n        size: stats.size,\n        idle: stats.idle,\n        waiting: stats.waiting,\n      });\n    }, POOL_SAMPLE_INTERVAL_MS);\n    poolSampleTimer.unref();\n  }\n\n  function stopPoolReporter(): void {\n    if (detachPoolListener) {\n      detachPoolListener();\n      detachPoolListener = null;\n    }\n    if (poolSampleTimer) {\n      clearInterval(poolSampleTimer);\n      poolSampleTimer = null;\n    }\n    pendingPoolSamples = [];\n  }\n\n  const logger = createForwardingLogger((msg) => post({ ...msg, shardId }));\n\n  process.on(\"uncaughtException\", (err: unknown) => {\n    try {\n      post({\n        type: \"log\",\n        shardId,\n        level: \"error\",\n        message: \"projection worker uncaughtException\",\n        args: [errorToInfo(err)],\n        timestamp: Date.now(),\n      });\n    } catch {\n      // nothing left to do\n    }\n    throw err;\n  });\n\n  process.on(\"unhandledRejection\", (reason: unknown) => {\n    try {\n      post({\n        type: \"log\",\n        shardId,\n        level: \"error\",\n        message: \"projection worker unhandledRejection\",\n        args: [errorToInfo(reason)],\n        timestamp: Date.now(),\n      });\n    } catch {\n      // nothing left to do\n    }\n  });\n\n  function startDepthReporter(intervalMs: number): void {\n    if (intervalMs <= 0) {\n      return;\n    }\n    depthTimer = setInterval(() => {\n      if (!stack) {\n        return;\n      }\n      const depth = stack.getChainDepth();\n      if (depth === lastReportedDepth) {\n        return;\n      }\n      lastReportedDepth = depth;\n      post({\n        type: \"chain-depth\",\n        shardId,\n        depth,\n        timestamp: Date.now(),\n      });\n    }, intervalMs);\n    depthTimer.unref();\n  }\n\n  function stopDepthReporter(): void {\n    if (depthTimer) {\n      clearInterval(depthTimer);\n      depthTimer = null;\n    }\n  }\n\n  async function handleInit(msg: ProjectionInitMessage): Promise<void> {\n    shardId = msg.shardId;\n    const createDb = overrides.createDatabase ?? defaultCreateDatabase;\n    database = await createDb(msg.db, msg.shardId);\n    if (overrides.beforeBuildStack) {\n      await overrides.beforeBuildStack(database.kysely);\n    }\n    stack = await buildProjectionStack({\n      init: msg,\n      database: database.kysely,\n      logger: new ConsoleLogger([`projection-shard:${msg.shardId}`]),\n      loadFactory: overrides.loadFactory,\n      events: {\n        onReadReady: (event: JobReadReadyEvent) => {\n          post({\n            type: \"read-ready\",\n            shardId,\n            jobId: event.jobId,\n            operations: event.operations,\n          });\n        },\n        onReadModelIndexed: (event: ReadModelIndexedEvent) => {\n          post({\n            type: \"readmodel-indexed\",\n            shardId,\n            jobId: event.jobId,\n            readModelName: event.readModelName,\n            stage: event.stage,\n            durationMs: event.durationMs,\n            operationCount: event.operationCount,\n            success: event.success,\n          });\n        },\n        onBatchCompleted: (event: ReadModelBatchCompletedEvent) => {\n          post({\n            type: \"readmodel-batch-completed\",\n            shardId,\n            jobId: event.jobId,\n            batchSize: event.batchSize,\n            chainWaitDurationMs: event.chainWaitDurationMs,\n            preReadyDurationMs: event.preReadyDurationMs,\n            emitDurationMs: event.emitDurationMs,\n            postReadyDurationMs: event.postReadyDurationMs,\n          });\n        },\n      },\n    });\n    initCompleted = true;\n    startDepthReporter(msg.chainDepthReportIntervalMs);\n    if (database.poolInstrumentation) {\n      startPoolReporter(database.poolInstrumentation);\n    }\n    logger.info(\"projection worker initialized: @shardId\", msg.shardId);\n    post({ type: \"ready\", correlationId: msg.correlationId, shardId });\n  }\n\n  async function handleWriteReady(\n    msg: Extract<ProjectionParentMessage, { type: \"write-ready\" }>,\n  ): Promise<void> {\n    if (!stack) {\n      logger.warn(\n        \"write-ready received before init on shard @shardId\",\n        shardId,\n      );\n      return;\n    }\n    const event: JobWriteReadyEvent = {\n      jobId: msg.jobId,\n      operations: msg.operations,\n      jobMeta: msg.jobMeta,\n      collectionMemberships: msg.collectionMemberships,\n    };\n    await stack.relayWriteReady(event);\n  }\n\n  async function handleDrain(correlationId: string): Promise<void> {\n    if (stack) {\n      await stack.drain();\n    }\n    post({ type: \"drained\", correlationId, shardId });\n  }\n\n  async function shutdownStack(): Promise<void> {\n    stopDepthReporter();\n    stopPoolReporter();\n    if (stack) {\n      try {\n        await stack.drain();\n      } catch (error) {\n        logger.warn(\n          \"projection worker drain failed during shutdown: @error\",\n          error,\n        );\n      }\n      try {\n        await stack.shutdown();\n      } catch (error) {\n        logger.warn(\"projection worker stack shutdown failed: @error\", error);\n      }\n      stack = null;\n    }\n    if (database) {\n      await database.shutdown();\n      database = null;\n    }\n  }\n\n  function handleParentMessage(msg: ProjectionParentMessage): void {\n    switch (msg.type) {\n      case \"init\": {\n        handleInit(msg).catch((err: unknown) => {\n          post({\n            type: \"log\",\n            shardId,\n            level: \"error\",\n            message: \"projection worker init failed\",\n            args: [errorToInfo(err)],\n            timestamp: Date.now(),\n          });\n        });\n        break;\n      }\n      case \"write-ready\": {\n        if (!initCompleted) {\n          logger.warn(\n            \"write-ready received before init on shard @shardId\",\n            shardId,\n          );\n          break;\n        }\n        handleWriteReady(msg).catch((err: unknown) => {\n          post({\n            type: \"log\",\n            shardId,\n            level: \"error\",\n            message: \"projection worker write-ready failed\",\n            args: [errorToInfo(err)],\n            timestamp: Date.now(),\n          });\n        });\n        break;\n      }\n      case \"drain\": {\n        handleDrain(msg.correlationId).catch((err: unknown) => {\n          post({\n            type: \"log\",\n            shardId,\n            level: \"error\",\n            message: \"projection worker drain failed\",\n            args: [errorToInfo(err)],\n            timestamp: Date.now(),\n          });\n        });\n        break;\n      }\n      case \"shutdown\": {\n        logger.info(\"projection worker shutting down: @shardId\", shardId);\n        void shutdownStack().finally(() => {\n          post({\n            type: \"log\",\n            shardId,\n            level: \"info\",\n            message: \"projection worker shutdown\",\n            args: [],\n            timestamp: Date.now(),\n          });\n          process.exit(0);\n        });\n        break;\n      }\n      default: {\n        const exhaustive: never = msg;\n        void exhaustive;\n        break;\n      }\n    }\n  }\n\n  parentPort.on(\"message\", handleParentMessage);\n\n  const harness = {\n    handleParentMessage,\n    get initCompleted(): boolean {\n      return initCompleted;\n    },\n    get shardId(): string {\n      return shardId;\n    },\n  };\n  (\n    parentPort as unknown as { __reactorProjectionWorkerHarness?: unknown }\n  ).__reactorProjectionWorkerHarness = harness;\n}\n","import { isMainThread, parentPort } from \"node:worker_threads\";\nimport { runProjectionWorker } from \"./run-projection-worker.js\";\n\nif (isMainThread || parentPort === null) {\n  throw new Error(\"projection-worker entry.ts must be run as a worker thread\");\n}\n\nrunProjectionWorker(parentPort);\n"],"mappings":"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"}

package/dist/{projection-shard-manager-BnQKFqQd.js → projection-shard-manager-D6KYcEZi.js}

@@ -18,6 +18,23 @@ function bucketFor(documentId, numWorkers) {
 	return (hash >>> 0) % numWorkers;
 }
 /**
+* Maps operations to the coordinates a consistency tracker is keyed by.
+* Same shape `BaseReadModel.updateConsistencyTracker` produces in-process.
+*/
+function toConsistencyCoordinates(operations) {
+	const coordinates = [];
+	for (let i = 0; i < operations.length; i++) {
+		const item = operations[i];
+		coordinates.push({
+			documentId: item.context.documentId,
+			scope: item.context.scope,
+			branch: item.context.branch,
+			operationIndex: item.operation.index
+		});
+	}
+	return coordinates;
+}
+/**
 * Host-side coordinator for N sharded projection workers.
 *
 * Implements {@link IReadModelCoordinator} so it slots into the same
@@ -40,14 +57,21 @@ var ProjectionShardManager = class {
 	shards = [];
 	initPromises = /* @__PURE__ */ new Map();
 	pendingDrains = /* @__PURE__ */ new Map();
+	trackersByReadModelName = /* @__PURE__ */ new Map();
 	hostSubscription;
 	isRunning = false;
 	started = false;
+	isShuttingDown = false;
 	constructor(config) {
 		if (config.shardCount < 1) throw new Error(`ProjectionShardManager: shardCount must be >= 1 (got ${config.shardCount})`);
 		this.config = config;
 		this.logger = childLogger(["reactor", "projection-shard-manager"]);
 		this.hostBus = config.hostBus;
+		const trackers = config.consistencyTrackers ?? {};
+		for (const kind of Object.keys(trackers)) {
+			const tracker = trackers[kind];
+			if (tracker) this.trackersByReadModelName.set(kind, tracker);
+		}
 	}
 	async startup() {
 		if (this.started) return;
@@ -66,6 +90,7 @@ var ProjectionShardManager = class {
 				lastDepth: 0,
 				lastDepthAt: 0,
 				poolInstrumentation: this.config.poolInstrumentations?.[i],
+				pendingCoordinates: /* @__PURE__ */ new Map(),
 				onMessage: (msg) => this.handleWorkerMessage(state, msg),
 				onError: (err) => this.handleTransportError(state, err),
 				onExit: (code) => this.handleTransportExit(state, code)
@@ -155,6 +180,7 @@ var ProjectionShardManager = class {
 		}));
 	}
 	async shutdown() {
+		this.isShuttingDown = true;
 		this.stop();
 		const graceMs = this.config.shutdownGraceMs ?? DEFAULT_SHUTDOWN_GRACE_MS;
 		const correlationId = randomUUID();
@@ -183,14 +209,29 @@ var ProjectionShardManager = class {
 		this.shards.length = 0;
 	}
 	routeWriteReady(event) {
-		if (event.operations.length === 0) return;
+		if (event.operations.length === 0) {
+			this.relayReadReady({
+				jobId: event.jobId,
+				operations: []
+			});
+			this.relayBatchCompleted({
+				jobId: event.jobId,
+				batchSize: 0,
+				chainWaitDurationMs: 0,
+				preReadyDurationMs: 0,
+				emitDurationMs: 0,
+				postReadyDurationMs: 0
+			});
+			return;
+		}
 		const documentId = event.operations[0].context.documentId;
 		const index = bucketFor(documentId, this.shards.length);
 		const shard = this.shards[index];
 		if (!shard.ready) {
-			this.logger.warn("dropping JOB_WRITE_READY: shard @index not ready", index);
+			this.dropWriteReady(shard, event, documentId);
 			return;
 		}
+		if (this.trackersByReadModelName.size > 0) shard.pendingCoordinates.set(event.jobId, toConsistencyCoordinates(event.operations));
 		shard.transport.postMessage({
 			type: "write-ready",
 			jobId: event.jobId,
@@ -199,6 +240,24 @@ var ProjectionShardManager = class {
 			collectionMemberships: event.collectionMemberships
 		});
 	}
+	/**
+	* A shard stops being ready only when it dies, and nothing respawns it, so
+	* this job's projection is genuinely lost. Buffering would grow without
+	* bound behind a shard that never comes back, so the batch is dropped —
+	* loudly, naming the job and document, and through `onShardFatal` so a host
+	* can restart rather than serve stale read models.
+	*
+	* JOB_FAILED is deliberately not emitted: every other emitter uses it for a
+	* job whose operations were *not* written (see
+	* `executor/job-result-handler.ts`), and these were written and are
+	* durable. Marking the job FAILED would invite the caller to re-submit a
+	* write that already landed.
+	*/
+	dropWriteReady(shard, event, documentId) {
+		const reason = /* @__PURE__ */ new Error(`projection shard ${shard.shardId} is not ready: JOB_WRITE_READY for job ${event.jobId} (document ${documentId}, ${event.operations.length} operation(s)) was dropped and will never be projected; the operations are written and durable, but this shard's read models are now behind`);
+		this.logger.error("dropping JOB_WRITE_READY for job @jobId on shard @shardId: @error", event.jobId, shard.shardId, reason);
+		this.config.onShardFatal?.(shard.shardId, reason);
+	}
 	handleWorkerMessage(shard, msg) {
 		switch (msg.type) {
 			case "ready":
@@ -211,6 +270,7 @@ var ProjectionShardManager = class {
 				});
 				return;
 			case "readmodel-indexed":
+				this.advanceConsistencyTrackers(shard, msg);
 				this.relayReadModelIndexed({
 					jobId: msg.jobId,
 					readModelName: msg.readModelName,
@@ -221,6 +281,7 @@ var ProjectionShardManager = class {
 				});
 				return;
 			case "readmodel-batch-completed":
+				shard.pendingCoordinates.delete(msg.jobId);
 				this.relayBatchCompleted({
 					jobId: msg.jobId,
 					batchSize: msg.batchSize,
@@ -246,6 +307,24 @@ var ProjectionShardManager = class {
 			default: return;
 		}
 	}
+	/**
+	* Advances the host's tracker for the read model the shard just indexed.
+	*
+	* The shard writes to the same tables the host reads, so once it reports a
+	* successful index the host's read path really is consistent to those
+	* coordinates. Gated on `success` for parity with
+	* `BaseReadModel.indexOperations`, which updates its tracker only after
+	* `commitOperations` returns. The worker posts this before its
+	* JOB_READ_READY, matching the in-process ordering.
+	*/
+	advanceConsistencyTrackers(shard, msg) {
+		if (!msg.success) return;
+		const tracker = this.trackersByReadModelName.get(msg.readModelName);
+		if (!tracker) return;
+		const coordinates = shard.pendingCoordinates.get(msg.jobId);
+		if (!coordinates || coordinates.length === 0) return;
+		tracker.update(coordinates);
+	}
 	handlePoolAcquireSamples(shard, msg) {
 		if (!shard.poolInstrumentation) return;
 		shard.poolInstrumentation.updateStats({
@@ -292,10 +371,16 @@ var ProjectionShardManager = class {
 	}
 	handleTransportError(shard, err) {
 		this.logger.error("projection shard transport error @shardId: @error", shard.shardId, err);
+		if (!this.isShuttingDown) this.config.onShardFatal?.(shard.shardId, err);
 	}
 	handleTransportExit(shard, code) {
-		if (shard.ready) this.logger.warn("projection shard exited unexpectedly @shardId code=@code", shard.shardId, code);
+		const wasReady = shard.ready;
 		shard.ready = false;
+		const abandoned = [...shard.pendingCoordinates.keys()];
+		shard.pendingCoordinates.clear();
+		if (!wasReady || this.isShuttingDown) return;
+		this.logger.error("projection shard exited unexpectedly @shardId code=@code, abandoning @count in-flight job(s): @jobIds", shard.shardId, code, abandoned.length, abandoned.join(", "));
+		this.config.onShardFatal?.(shard.shardId, /* @__PURE__ */ new Error(`projection shard ${shard.shardId} exited with code ${code}; ${abandoned.length} in-flight job(s) will never be projected` + (abandoned.length > 0 ? `: ${abandoned.join(", ")}` : "")));
 	}
 	relayReadReady(event) {
 		this.hostBus.emit(ReactorEventTypes.JOB_READ_READY, event).catch((err) => this.logger.error("host JOB_READ_READY emit failed for job @jobId: @error", event.jobId, err));
@@ -310,4 +395,4 @@ var ProjectionShardManager = class {
 //#endregion
 export { ProjectionShardManager };
 
-//# sourceMappingURL=projection-shard-manager-BnQKFqQd.js.map
+//# sourceMappingURL=projection-shard-manager-D6KYcEZi.js.map

package/dist/projection-shard-manager-D6KYcEZi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-shard-manager-D6KYcEZi.js","names":[],"sources":["../src/projection/projection-shard-manager.ts"],"sourcesContent":["import type { OperationWithContext } from \"@powerhousedao/shared/document-model\";\nimport { childLogger, type ILogger } from \"document-model\";\nimport { randomUUID } from \"node:crypto\";\nimport type { IEventBus } from \"../events/interfaces.js\";\nimport {\n  ReactorEventTypes,\n  type JobReadReadyEvent,\n  type JobWriteReadyEvent,\n  type ReadModelBatchCompletedEvent,\n  type ReadModelIndexedEvent,\n  type Unsubscribe,\n} from \"../events/types.js\";\nimport type {\n  IReadModel,\n  IReadModelCoordinator,\n} from \"../read-models/interfaces.js\";\nimport type { IConsistencyTracker } from \"../shared/consistency-tracker.js\";\nimport type { ConsistencyCoordinate } from \"../shared/types.js\";\nimport type { ForwardingPoolInstrumentation } from \"../storage/pool-instrumentation.js\";\nimport type {\n  BuiltInReadModelKind,\n  ChainDepthReport,\n  DbConfig,\n  ModelManifestEntry,\n  ProjectionDrainedMessage,\n  ProjectionInitMessage,\n  ProjectionParentMessage,\n  ProjectionPoolAcquireSamplesMessage,\n  ProjectionReadModelIndexedMessage,\n  ProjectionWorkerMessage,\n} from \"./protocol.js\";\nimport type { IProjectionTransport } from \"./transport.js\";\n\nconst DEFAULT_INIT_TIMEOUT_MS = 30_000;\nconst DEFAULT_SHUTDOWN_GRACE_MS = 5_000;\nconst DEFAULT_DRAIN_TIMEOUT_MS = 30_000;\nconst DEFAULT_CHAIN_DEPTH_REPORT_INTERVAL_MS = 250;\n\nconst FNV_OFFSET_BASIS = 0x811c9dc5;\nconst FNV_PRIME = 0x01000193;\n\nfunction bucketFor(documentId: string, numWorkers: number): number {\n  if (numWorkers < 1) {\n    throw new Error(`bucketFor: numWorkers must be >= 1 (got ${numWorkers})`);\n  }\n  let hash = FNV_OFFSET_BASIS;\n  for (let i = 0; i < documentId.length; i++) {\n    hash ^= documentId.charCodeAt(i);\n    hash = Math.imul(hash, FNV_PRIME);\n  }\n  return (hash >>> 0) % numWorkers;\n}\n\n/**\n * Maps operations to the coordinates a consistency tracker is keyed by.\n * Same shape `BaseReadModel.updateConsistencyTracker` produces in-process.\n */\nfunction toConsistencyCoordinates(\n  operations: OperationWithContext[],\n): ConsistencyCoordinate[] {\n  const coordinates: ConsistencyCoordinate[] = [];\n  for (let i = 0; i < operations.length; i++) {\n    const item = operations[i]!;\n    coordinates.push({\n      documentId: item.context.documentId,\n      scope: item.context.scope,\n      branch: item.context.branch,\n      operationIndex: item.operation.index,\n    });\n  }\n  return coordinates;\n}\n\n/**\n * Factory that builds one projection-worker transport. Mirrors\n * `WorkerFactory` from the executor pool: lets tests inject fake\n * transports without spawning real worker threads.\n */\nexport type ProjectionWorkerFactory = (\n  shardIndex: number,\n  shardId: string,\n) => IProjectionTransport;\n\nexport type ProjectionShardManagerConfig = {\n  shardCount: number;\n  db: DbConfig;\n  models: ModelManifestEntry[];\n  preReadyKinds: BuiltInReadModelKind[];\n  postReadyKinds: BuiltInReadModelKind[];\n  factory: ProjectionWorkerFactory;\n  logger: ILogger;\n  hostBus: IEventBus;\n  initTimeoutMs?: number;\n  shutdownGraceMs?: number;\n  drainTimeoutMs?: number;\n  chainDepthReportIntervalMs?: number;\n  /**\n   * Host-side forwarding instrumentations indexed by shard index. The\n   * manager routes each shard's `pool-acquire-samples` message to the\n   * matching forwarder so the host's OpenTelemetry instrumentation records\n   * acquire-wait latencies as if each shard's pg.Pool were local.\n   */\n  poolInstrumentations?: ForwardingPoolInstrumentation[];\n  /**\n   * The host's consistency trackers for the built-in read models the shards\n   * run, keyed by kind. The keys double as read-model names (see\n   * `DOCUMENT_VIEW_READ_MODEL` / `DOCUMENT_INDEXER_READ_MODEL` in\n   * `read-models/names.js`), which is how a relayed `readmodel-indexed`\n   * message is matched to a tracker.\n   *\n   * The host's copies of these read models are never fed an operation under\n   * sharding, so without this every read carrying a consistency token waits\n   * on a tracker that can never advance — `ConsistencyTracker.waitFor` arms\n   * no timer when `timeoutMs` is undefined, which is what every\n   * `document-view` call site passes. The worker committed those rows to the\n   * same tables the host reads from, so advancing here is exact, not a fudge.\n   */\n  consistencyTrackers?: Partial<\n    Record<BuiltInReadModelKind, IConsistencyTracker>\n  >;\n  /**\n   * Fired when a shard errors, when it exits after having been ready, and\n   * for every JOB_WRITE_READY dropped because its shard is not ready.\n   *\n   * There is no respawn path: once a shard stops being ready it never\n   * projects again, so buffering the dropped work would only grow without\n   * bound. A host that cares wires this to its shutdown path, so the process\n   * restarts and each read model catches up from `ViewState.lastOrdinal` in\n   * `BaseReadModel.init`. May fire repeatedly — handlers must be idempotent.\n   */\n  onShardFatal?: (shardId: string, reason: Error) => void;\n};\n\ntype ShardState = {\n  shardIndex: number;\n  shardId: string;\n  transport: IProjectionTransport;\n  ready: boolean;\n  lastDepth: number;\n  lastDepthAt: number;\n  poolInstrumentation?: ForwardingPoolInstrumentation;\n  /**\n   * Consistency coordinates of the jobs this shard is still projecting,\n   * keyed by jobId. Relayed `readmodel-indexed` messages carry only a count,\n   * so the host keeps the coordinates here to advance its trackers from\n   * them; the operations themselves are not retained. Empty unless\n   * `consistencyTrackers` is configured; entries live from dispatch to\n   * `readmodel-batch-completed`, and are dropped when the shard exits.\n   */\n  pendingCoordinates: Map<string, ConsistencyCoordinate[]>;\n  onMessage: (msg: ProjectionWorkerMessage) => void;\n  onError: (err: Error) => void;\n  onExit: (code: number) => void;\n};\n\ntype PendingDrain = {\n  resolve: () => void;\n  reject: (err: Error) => void;\n  remaining: Set<string>;\n  timer: NodeJS.Timeout;\n};\n\n/**\n * Host-side coordinator for N sharded projection workers.\n *\n * Implements {@link IReadModelCoordinator} so it slots into the same\n * `readModelCoordinator` field on the reactor module as the in-process\n * {@link ReadModelCoordinator}. The host subscribes to JOB_WRITE_READY\n * exactly once; events are routed to a single shard by\n * `bucketFor(documentId, shardCount)`. Each worker maintains the\n * per-queueKey serial chain locally and forwards JOB_READ_READY and\n * READMODEL_* events back to the host for the rest of the reactor (sync\n * manager, awaiters, observers) to consume on the host bus.\n *\n * @see Sharded projection workers sub-feature brief\n *   (Powerhouse board wiki id: eb26f01f-8f68-4918-a6f6-ac7a4679b533)\n */\nexport class ProjectionShardManager implements IReadModelCoordinator {\n  readonly readModels: IReadModel[] = [];\n\n  private readonly config: ProjectionShardManagerConfig;\n  private readonly logger: ILogger;\n  private readonly hostBus: IEventBus;\n  private readonly shards: ShardState[] = [];\n  private readonly initPromises = new Map<\n    string,\n    { resolve: () => void; reject: (err: Error) => void; timer: NodeJS.Timeout }\n  >();\n  private readonly pendingDrains = new Map<string, PendingDrain>();\n  private readonly trackersByReadModelName = new Map<\n    string,\n    IConsistencyTracker\n  >();\n  private hostSubscription?: Unsubscribe;\n  private isRunning = false;\n  private started = false;\n  private isShuttingDown = false;\n\n  constructor(config: ProjectionShardManagerConfig) {\n    if (config.shardCount < 1) {\n      throw new Error(\n        `ProjectionShardManager: shardCount must be >= 1 (got ${config.shardCount})`,\n      );\n    }\n    this.config = config;\n    this.logger = childLogger([\"reactor\", \"projection-shard-manager\"]);\n    this.hostBus = config.hostBus;\n    const trackers = config.consistencyTrackers ?? {};\n    for (const kind of Object.keys(trackers) as BuiltInReadModelKind[]) {\n      const tracker = trackers[kind];\n      if (tracker) {\n        this.trackersByReadModelName.set(kind, tracker);\n      }\n    }\n  }\n\n  async startup(): Promise<void> {\n    if (this.started) {\n      return;\n    }\n    this.started = true;\n    const initTimeoutMs = this.config.initTimeoutMs ?? DEFAULT_INIT_TIMEOUT_MS;\n    const reportIntervalMs =\n      this.config.chainDepthReportIntervalMs ??\n      DEFAULT_CHAIN_DEPTH_REPORT_INTERVAL_MS;\n\n    const initPromises: Promise<void>[] = [];\n    for (let i = 0; i < this.config.shardCount; i++) {\n      const shardId = `projection-shard-${i}`;\n      const transport = this.config.factory(i, shardId);\n      const state: ShardState = {\n        shardIndex: i,\n        shardId,\n        transport,\n        ready: false,\n        lastDepth: 0,\n        lastDepthAt: 0,\n        poolInstrumentation: this.config.poolInstrumentations?.[i],\n        pendingCoordinates: new Map(),\n        onMessage: (msg) => this.handleWorkerMessage(state, msg),\n        onError: (err) => this.handleTransportError(state, err),\n        onExit: (code) => this.handleTransportExit(state, code),\n      };\n      transport.on(\"message\", state.onMessage);\n      transport.on(\"error\", state.onError);\n      transport.on(\"exit\", state.onExit);\n      this.shards.push(state);\n\n      const correlationId = randomUUID();\n      const initPromise = new Promise<void>((resolve, reject) => {\n        const timer = setTimeout(() => {\n          this.initPromises.delete(correlationId);\n          reject(\n            new Error(\n              `projection shard ${shardId} did not become ready within ${initTimeoutMs}ms`,\n            ),\n          );\n        }, initTimeoutMs);\n        this.initPromises.set(correlationId, { resolve, reject, timer });\n      });\n\n      const init: ProjectionInitMessage = {\n        type: \"init\",\n        correlationId,\n        shardId,\n        shardIndex: i,\n        shardCount: this.config.shardCount,\n        db: this.config.db,\n        models: this.config.models,\n        preReadyKinds: this.config.preReadyKinds,\n        postReadyKinds: this.config.postReadyKinds,\n        chainDepthReportIntervalMs: reportIntervalMs,\n      };\n      transport.postMessage(init);\n      initPromises.push(initPromise);\n    }\n\n    await Promise.all(initPromises);\n    this.logger.info(\n      \"projection shard manager ready: @count shards\",\n      this.shards.length,\n    );\n  }\n\n  start(): void {\n    if (this.isRunning) {\n      return;\n    }\n    this.hostSubscription = this.hostBus.subscribe(\n      ReactorEventTypes.JOB_WRITE_READY,\n      (_t: number, event: JobWriteReadyEvent) => {\n        this.routeWriteReady(event);\n      },\n    );\n    this.isRunning = true;\n  }\n\n  stop(): void {\n    if (!this.isRunning) {\n      return;\n    }\n    if (this.hostSubscription) {\n      this.hostSubscription();\n      this.hostSubscription = undefined;\n    }\n    this.isRunning = false;\n  }\n\n  async drain(): Promise<void> {\n    if (this.shards.length === 0) {\n      return;\n    }\n    const drainTimeoutMs =\n      this.config.drainTimeoutMs ?? DEFAULT_DRAIN_TIMEOUT_MS;\n    const correlationId = randomUUID();\n    const remaining = new Set(this.shards.map((s) => s.shardId));\n    const promise = new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        this.pendingDrains.delete(correlationId);\n        reject(\n          new Error(\n            `projection shards did not drain within ${drainTimeoutMs}ms (remaining: ${[\n              ...remaining,\n            ].join(\", \")})`,\n          ),\n        );\n      }, drainTimeoutMs);\n      this.pendingDrains.set(correlationId, {\n        resolve,\n        reject,\n        remaining,\n        timer,\n      });\n    });\n    for (const shard of this.shards) {\n      shard.transport.postMessage({ type: \"drain\", correlationId });\n    }\n    await promise;\n  }\n\n  getChainDepth(): number {\n    let total = 0;\n    for (const shard of this.shards) {\n      total += shard.lastDepth;\n    }\n    return total;\n  }\n\n  getShardDepths(): ChainDepthReport[] {\n    return this.shards.map((shard) => ({\n      shardId: shard.shardId,\n      depth: shard.lastDepth,\n      timestamp: shard.lastDepthAt,\n    }));\n  }\n\n  async shutdown(): Promise<void> {\n    // Workers exit as a consequence of this call, so their `exit` events are\n    // expected from here on and must not be reported as fatal.\n    this.isShuttingDown = true;\n    this.stop();\n    const graceMs = this.config.shutdownGraceMs ?? DEFAULT_SHUTDOWN_GRACE_MS;\n    const correlationId = randomUUID();\n    for (const shard of this.shards) {\n      try {\n        const msg: ProjectionParentMessage = {\n          type: \"shutdown\",\n          correlationId,\n          graceMs,\n        };\n        shard.transport.postMessage(msg);\n      } catch (err) {\n        this.logger.warn(\n          \"projection shard postMessage(shutdown) failed for @shardId: @error\",\n          shard.shardId,\n          err,\n        );\n      }\n    }\n    const terminationDeadline = Date.now() + graceMs;\n    while (\n      this.shards.some((s) => s.ready) &&\n      Date.now() < terminationDeadline\n    ) {\n      await new Promise<void>((resolve) => setTimeout(resolve, 25));\n    }\n    for (const shard of this.shards) {\n      try {\n        await shard.transport.terminate();\n      } catch (err) {\n        this.logger.warn(\n          \"projection shard terminate failed for @shardId: @error\",\n          shard.shardId,\n          err,\n        );\n      }\n      shard.transport.off(\"message\", shard.onMessage);\n      shard.transport.off(\"error\", shard.onError);\n      shard.transport.off(\"exit\", shard.onExit);\n    }\n    this.shards.length = 0;\n  }\n\n  private routeWriteReady(event: JobWriteReadyEvent): void {\n    if (event.operations.length === 0) {\n      // No shard can be selected (there is no documentId) and no read model\n      // has work to do, but JOB_READ_READY is the job's terminal signal:\n      // InMemoryJobTracker and every JobAwaiter hang without it. Mirrors\n      // ReadModelCoordinator.emitEmptyReadReady.\n      this.relayReadReady({ jobId: event.jobId, operations: [] });\n      this.relayBatchCompleted({\n        jobId: event.jobId,\n        batchSize: 0,\n        chainWaitDurationMs: 0,\n        preReadyDurationMs: 0,\n        emitDurationMs: 0,\n        postReadyDurationMs: 0,\n      });\n      return;\n    }\n    const documentId = event.operations[0]!.context.documentId;\n    const index = bucketFor(documentId, this.shards.length);\n    const shard = this.shards[index]!;\n    if (!shard.ready) {\n      this.dropWriteReady(shard, event, documentId);\n      return;\n    }\n    if (this.trackersByReadModelName.size > 0) {\n      shard.pendingCoordinates.set(\n        event.jobId,\n        toConsistencyCoordinates(event.operations),\n      );\n    }\n    shard.transport.postMessage({\n      type: \"write-ready\",\n      jobId: event.jobId,\n      operations: event.operations,\n      jobMeta: event.jobMeta,\n      collectionMemberships: event.collectionMemberships,\n    });\n  }\n\n  /**\n   * A shard stops being ready only when it dies, and nothing respawns it, so\n   * this job's projection is genuinely lost. Buffering would grow without\n   * bound behind a shard that never comes back, so the batch is dropped —\n   * loudly, naming the job and document, and through `onShardFatal` so a host\n   * can restart rather than serve stale read models.\n   *\n   * JOB_FAILED is deliberately not emitted: every other emitter uses it for a\n   * job whose operations were *not* written (see\n   * `executor/job-result-handler.ts`), and these were written and are\n   * durable. Marking the job FAILED would invite the caller to re-submit a\n   * write that already landed.\n   */\n  private dropWriteReady(\n    shard: ShardState,\n    event: JobWriteReadyEvent,\n    documentId: string,\n  ): void {\n    const reason = new Error(\n      `projection shard ${shard.shardId} is not ready: JOB_WRITE_READY for job ${event.jobId} ` +\n        `(document ${documentId}, ${event.operations.length} operation(s)) was dropped and will ` +\n        `never be projected; the operations are written and durable, but this shard's read models ` +\n        `are now behind`,\n    );\n    this.logger.error(\n      \"dropping JOB_WRITE_READY for job @jobId on shard @shardId: @error\",\n      event.jobId,\n      shard.shardId,\n      reason,\n    );\n    this.config.onShardFatal?.(shard.shardId, reason);\n  }\n\n  private handleWorkerMessage(\n    shard: ShardState,\n    msg: ProjectionWorkerMessage,\n  ): void {\n    switch (msg.type) {\n      case \"ready\":\n        this.handleReady(shard, msg.correlationId);\n        return;\n      case \"read-ready\":\n        this.relayReadReady({\n          jobId: msg.jobId,\n          operations: msg.operations,\n        });\n        return;\n      case \"readmodel-indexed\":\n        this.advanceConsistencyTrackers(shard, msg);\n        this.relayReadModelIndexed({\n          jobId: msg.jobId,\n          readModelName: msg.readModelName,\n          stage: msg.stage,\n          durationMs: msg.durationMs,\n          operationCount: msg.operationCount,\n          success: msg.success,\n        });\n        return;\n      case \"readmodel-batch-completed\":\n        shard.pendingCoordinates.delete(msg.jobId);\n        this.relayBatchCompleted({\n          jobId: msg.jobId,\n          batchSize: msg.batchSize,\n          chainWaitDurationMs: msg.chainWaitDurationMs,\n          preReadyDurationMs: msg.preReadyDurationMs,\n          emitDurationMs: msg.emitDurationMs,\n          postReadyDurationMs: msg.postReadyDurationMs,\n        });\n        return;\n      case \"chain-depth\":\n        shard.lastDepth = msg.depth;\n        shard.lastDepthAt = msg.timestamp;\n        return;\n      case \"pool-acquire-samples\":\n        this.handlePoolAcquireSamples(shard, msg);\n        return;\n      case \"drained\":\n        this.handleDrained(msg);\n        return;\n      case \"log\":\n        this.handleLog(shard, msg);\n        return;\n      default: {\n        const exhaustive: never = msg;\n        void exhaustive;\n        return;\n      }\n    }\n  }\n\n  /**\n   * Advances the host's tracker for the read model the shard just indexed.\n   *\n   * The shard writes to the same tables the host reads, so once it reports a\n   * successful index the host's read path really is consistent to those\n   * coordinates. Gated on `success` for parity with\n   * `BaseReadModel.indexOperations`, which updates its tracker only after\n   * `commitOperations` returns. The worker posts this before its\n   * JOB_READ_READY, matching the in-process ordering.\n   */\n  private advanceConsistencyTrackers(\n    shard: ShardState,\n    msg: ProjectionReadModelIndexedMessage,\n  ): void {\n    if (!msg.success) {\n      return;\n    }\n    const tracker = this.trackersByReadModelName.get(msg.readModelName);\n    if (!tracker) {\n      return;\n    }\n    const coordinates = shard.pendingCoordinates.get(msg.jobId);\n    if (!coordinates || coordinates.length === 0) {\n      return;\n    }\n    tracker.update(coordinates);\n  }\n\n  private handlePoolAcquireSamples(\n    shard: ShardState,\n    msg: ProjectionPoolAcquireSamplesMessage,\n  ): void {\n    if (!shard.poolInstrumentation) {\n      return;\n    }\n    shard.poolInstrumentation.updateStats({\n      size: msg.size,\n      idle: msg.idle,\n      waiting: msg.waiting,\n    });\n    shard.poolInstrumentation.pushSamples(msg.durations);\n  }\n\n  private handleReady(shard: ShardState, correlationId: string): void {\n    shard.ready = true;\n    const pending = this.initPromises.get(correlationId);\n    if (!pending) {\n      return;\n    }\n    this.initPromises.delete(correlationId);\n    clearTimeout(pending.timer);\n    pending.resolve();\n  }\n\n  private handleDrained(msg: ProjectionDrainedMessage): void {\n    const pending = this.pendingDrains.get(msg.correlationId);\n    if (!pending) {\n      return;\n    }\n    pending.remaining.delete(msg.shardId);\n    if (pending.remaining.size === 0) {\n      this.pendingDrains.delete(msg.correlationId);\n      clearTimeout(pending.timer);\n      pending.resolve();\n    }\n  }\n\n  private handleLog(\n    shard: ShardState,\n    msg: Extract<ProjectionWorkerMessage, { type: \"log\" }>,\n  ): void {\n    switch (msg.level) {\n      case \"debug\":\n        this.logger.debug(msg.message, ...msg.args);\n        return;\n      case \"info\":\n        this.logger.info(msg.message, ...msg.args);\n        return;\n      case \"warn\":\n        this.logger.warn(msg.message, ...msg.args);\n        return;\n      case \"error\":\n        this.logger.error(msg.message, ...msg.args);\n        return;\n      default: {\n        const exhaustive: never = msg.level;\n        void exhaustive;\n      }\n    }\n    void shard;\n  }\n\n  private handleTransportError(shard: ShardState, err: Error): void {\n    this.logger.error(\n      \"projection shard transport error @shardId: @error\",\n      shard.shardId,\n      err,\n    );\n    if (!this.isShuttingDown) {\n      this.config.onShardFatal?.(shard.shardId, err);\n    }\n  }\n\n  private handleTransportExit(shard: ShardState, code: number): void {\n    const wasReady = shard.ready;\n    shard.ready = false;\n    // Nothing respawns the shard, so every job it had in flight is lost with\n    // it. Release them rather than pin their operations for the process's\n    // remaining life.\n    const abandoned = [...shard.pendingCoordinates.keys()];\n    shard.pendingCoordinates.clear();\n    if (!wasReady || this.isShuttingDown) {\n      return;\n    }\n    this.logger.error(\n      \"projection shard exited unexpectedly @shardId code=@code, abandoning @count in-flight job(s): @jobIds\",\n      shard.shardId,\n      code,\n      abandoned.length,\n      abandoned.join(\", \"),\n    );\n    this.config.onShardFatal?.(\n      shard.shardId,\n      new Error(\n        `projection shard ${shard.shardId} exited with code ${code}; ` +\n          `${abandoned.length} in-flight job(s) will never be projected` +\n          (abandoned.length > 0 ? `: ${abandoned.join(\", \")}` : \"\"),\n      ),\n    );\n  }\n\n  private relayReadReady(event: JobReadReadyEvent): void {\n    void this.hostBus\n      .emit(ReactorEventTypes.JOB_READ_READY, event)\n      .catch((err: unknown) =>\n        this.logger.error(\n          \"host JOB_READ_READY emit failed for job @jobId: @error\",\n          event.jobId,\n          err,\n        ),\n      );\n  }\n\n  private relayReadModelIndexed(event: ReadModelIndexedEvent): void {\n    void this.hostBus\n      .emit(ReactorEventTypes.READMODEL_INDEXED, event)\n      .catch((err: unknown) =>\n        this.logger.error(\n          \"host READMODEL_INDEXED emit failed for job @jobId: @error\",\n          event.jobId,\n          err,\n        ),\n      );\n  }\n\n  private relayBatchCompleted(event: ReadModelBatchCompletedEvent): void {\n    void this.hostBus\n      .emit(ReactorEventTypes.READMODEL_BATCH_COMPLETED, event)\n      .catch((err: unknown) =>\n        this.logger.error(\n          \"host READMODEL_BATCH_COMPLETED emit failed for job @jobId: @error\",\n          event.jobId,\n          err,\n        ),\n      );\n  }\n}\n"],"mappings":"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"}

package/dist/{worker-DBJOv8Gp.js → worker-HPysBfhx.js}

@@ -1,4 +1,4 @@
-import { M as __exportAll } from "./drive-container-types-DpJp2AmE.js";
+import { Q as __exportAll } from "./drive-container-types-yZrksiJR.js";
 import { n as errorToInfo, r as sanitizeArg, t as createForwardingLogger } from "./forwarding-logger-BBkMSxuJ.js";
 //#region src/executor/worker/index.ts
 var worker_exports = /* @__PURE__ */ __exportAll({
@@ -19,4 +19,4 @@ const workerEntryPath = resolveWorkerEntryPath();
 //#endregion
 export { worker_exports as n, workerEntryPath as t };
 
-//# sourceMappingURL=worker-DBJOv8Gp.js.map
+//# sourceMappingURL=worker-HPysBfhx.js.map

package/dist/{worker-DBJOv8Gp.js.map → worker-HPysBfhx.js.map}

@@ -1 +1 @@
-{"version":3,"file":"worker-DBJOv8Gp.js","names":[],"sources":["../src/executor/worker/index.ts"],"sourcesContent":["export { createForwardingLogger } from \"./forwarding-logger.js\";\nexport { errorToInfo, sanitizeArg } from \"./sanitize.js\";\n\nfunction resolveWorkerEntryPath(): string {\n  const url = new URL(\"./entry.js\", import.meta.url);\n  if (url.protocol !== \"file:\") {\n    return url.href;\n  }\n  let pathname = decodeURIComponent(url.pathname);\n  if (/^\\/[A-Za-z]:[/\\\\]/.test(pathname)) {\n    pathname = pathname.slice(1);\n  }\n  return pathname;\n}\n\n/** Absolute path to the worker entry script for use with `new Worker(workerEntryPath)`. */\nexport const workerEntryPath = resolveWorkerEntryPath();\n"],"mappings":";;;;;;;;;AAGA,SAAS,yBAAiC;CACxC,MAAM,MAAM,IAAI,IAAI,cAAc,OAAO,KAAK,IAAI;AAClD,KAAI,IAAI,aAAa,QACnB,QAAO,IAAI;CAEb,IAAI,WAAW,mBAAmB,IAAI,SAAS;AAC/C,KAAI,oBAAoB,KAAK,SAAS,CACpC,YAAW,SAAS,MAAM,EAAE;AAE9B,QAAO;;;AAIT,MAAa,kBAAkB,wBAAwB"}
+{"version":3,"file":"worker-HPysBfhx.js","names":[],"sources":["../src/executor/worker/index.ts"],"sourcesContent":["export { createForwardingLogger } from \"./forwarding-logger.js\";\nexport { errorToInfo, sanitizeArg } from \"./sanitize.js\";\n\nfunction resolveWorkerEntryPath(): string {\n  const url = new URL(\"./entry.js\", import.meta.url);\n  if (url.protocol !== \"file:\") {\n    return url.href;\n  }\n  let pathname = decodeURIComponent(url.pathname);\n  if (/^\\/[A-Za-z]:[/\\\\]/.test(pathname)) {\n    pathname = pathname.slice(1);\n  }\n  return pathname;\n}\n\n/** Absolute path to the worker entry script for use with `new Worker(workerEntryPath)`. */\nexport const workerEntryPath = resolveWorkerEntryPath();\n"],"mappings":";;;;;;;;;AAGA,SAAS,yBAAiC;CACxC,MAAM,MAAM,IAAI,IAAI,cAAc,OAAO,KAAK,IAAI;AAClD,KAAI,IAAI,aAAa,QACnB,QAAO,IAAI;CAEb,IAAI,WAAW,mBAAmB,IAAI,SAAS;AAC/C,KAAI,oBAAoB,KAAK,SAAS,CACpC,YAAW,SAAS,MAAM,EAAE;AAE9B,QAAO;;;AAIT,MAAa,kBAAkB,wBAAwB"}

package/dist/{worker-handle-B1w03nRA.js → worker-handle-CrERzl8s.js}

@@ -58,7 +58,8 @@ var WorkerHandle = class {
 			poolConfig: this.initPayload.poolConfig,
 			db: this.initPayload.db,
 			signatureVerifier: this.initPayload.signatureVerifier,
-			models: this.initPayload.models
+			models: this.initPayload.models,
+			executorConfig: this.initPayload.executorConfig
 		});
 		await ready;
 		this.phase = "ready";
@@ -380,4 +381,4 @@ var WorkerHandle = class {
 //#endregion
 export { WorkerHandle };
 
-//# sourceMappingURL=worker-handle-B1w03nRA.js.map
+//# sourceMappingURL=worker-handle-CrERzl8s.js.map

package/dist/worker-handle-CrERzl8s.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-handle-CrERzl8s.js","names":[],"sources":["../src/executor/worker/worker-handle.ts"],"sourcesContent":["/**\n * Parent-side IPC wrapper around a single executor worker.\n *\n * Implements {@link IExecutorWorker} on top of an injectable\n * {@link IWorkerTransport}. The handle owns one worker's lifecycle (init ->\n * ready -> execute/result rounds -> abort/shutdown -> terminate) and bounds\n * its in-flight slot to a single job — `SimpleJobExecutor` is single-threaded\n * inside the worker, and concurrent dispatches would race its caches.\n *\n * @see Executor Worker Pool Design wiki page\n *   (Powerhouse board wiki id: d400d711-f07e-4389-a226-4e9fdd4fa8ba)\n */\n\nimport type { ILogger } from \"document-model\";\nimport { randomUUID } from \"node:crypto\";\nimport type {\n  IExecutorWorker,\n  WorkerExecutionOutcome,\n  WorkerInFlightSnapshot,\n} from \"../interfaces.js\";\nimport type { Job } from \"../../queue/types.js\";\nimport type { JobExecutorConfig } from \"../types.js\";\nimport { fromErrorInfo } from \"./error-info.js\";\nimport {\n  WorkerAbortTimeoutError,\n  WorkerBusyError,\n  WorkerExitedError,\n  WorkerInitFailedError,\n  WorkerLoadModelFailedError,\n  WorkerShutdownTimeoutError,\n} from \"./errors.js\";\nimport type { ForwardingPoolInstrumentation } from \"../../storage/pool-instrumentation.js\";\nimport type {\n  DbConfig,\n  HeartbeatMessage,\n  LogMessage,\n  MetricsMessage,\n  ModelLoadFailedMessage,\n  ModelLoadedMessage,\n  ModelManifestEntry,\n  PoolAcquireSamplesMessage,\n  ResultMessage,\n  SignatureVerifierSpec,\n  WorkerMessage,\n  WorkerPoolConfig,\n} from \"./protocol.js\";\nimport type { IWorkerTransport, WorkerTransportListener } from \"./transport.js\";\n\nconst DEFAULT_ABORT_GRACE_MS = 5_000;\nconst DEFAULT_SHUTDOWN_GRACE_MS = 5_000;\n\n/**\n * Payload the parent ships in the `init` message (everything except the\n * envelope fields the handle fills in itself).\n */\nexport type WorkerInitPayload = {\n  poolConfig: WorkerPoolConfig;\n  db: DbConfig;\n  /** Omitted = the worker performs no executor-side signature verification. */\n  signatureVerifier?: SignatureVerifierSpec;\n  models: ModelManifestEntry[];\n  /** Omitted = the worker builds its executor with the built-in defaults. */\n  executorConfig?: JobExecutorConfig;\n};\n\nexport type WorkerHandleOptions = {\n  workerId: string;\n  index: number;\n  transport: IWorkerTransport;\n  initPayload: WorkerInitPayload;\n  logger: ILogger;\n  /** Grace period before an outstanding `abort` escalates to terminate. */\n  abortGraceMs?: number;\n  /** Default grace period applied to graceful `shutdown` when not overridden. */\n  defaultShutdownGraceMs?: number;\n  /**\n   * Forwarding instrumentation the host registers per worker. The handle\n   * pumps `pool-acquire-samples` messages into this object so the host's\n   * OpenTelemetry instrumentation records acquire-wait latencies as if the\n   * worker's pool were local.\n   */\n  poolInstrumentation?: ForwardingPoolInstrumentation;\n};\n\ntype PendingEntry =\n  | {\n      kind: \"init\";\n      resolve: () => void;\n      reject: (err: Error) => void;\n    }\n  | {\n      kind: \"execute\";\n      jobId: string;\n      resolve: (outcome: WorkerExecutionOutcome) => void;\n      reject: (err: Error) => void;\n    }\n  | {\n      kind: \"shutdown\";\n      resolve: () => void;\n      reject: (err: Error) => void;\n    }\n  | {\n      kind: \"load-model\";\n      documentType: string;\n      version: string;\n      resolve: () => void;\n      reject: (err: Error) => void;\n    };\n\ntype Phase = \"fresh\" | \"starting\" | \"ready\" | \"shutting-down\" | \"terminated\";\n\nexport class WorkerHandle implements IExecutorWorker {\n  readonly workerId: string;\n  readonly index: number;\n\n  private readonly transport: IWorkerTransport;\n  private readonly initPayload: WorkerInitPayload;\n  private readonly logger: ILogger;\n  private readonly abortGraceMs: number;\n  private readonly defaultShutdownGraceMs: number;\n  private readonly poolInstrumentation?: ForwardingPoolInstrumentation;\n\n  private readonly pending = new Map<string, PendingEntry>();\n  private inFlight: { correlationId: string; jobId: string } | null = null;\n  private phase: Phase = \"fresh\";\n  private lastExitError: Error | null = null;\n  private lastCorrelationId: string | null = null;\n  private abortTimer: NodeJS.Timeout | null = null;\n  private lastHeartbeatAt: number | null = null;\n  private lastMetrics: {\n    counters: Record<string, number>;\n    gauges: Record<string, number>;\n    timestamp: number;\n  } | null = null;\n\n  private readonly onMessage: WorkerTransportListener<\"message\">;\n  private readonly onError: WorkerTransportListener<\"error\">;\n  private readonly onExit: WorkerTransportListener<\"exit\">;\n\n  constructor(options: WorkerHandleOptions) {\n    this.workerId = options.workerId;\n    this.index = options.index;\n    this.transport = options.transport;\n    this.initPayload = options.initPayload;\n    this.logger = options.logger;\n    this.abortGraceMs = options.abortGraceMs ?? DEFAULT_ABORT_GRACE_MS;\n    this.defaultShutdownGraceMs =\n      options.defaultShutdownGraceMs ?? DEFAULT_SHUTDOWN_GRACE_MS;\n    this.poolInstrumentation = options.poolInstrumentation;\n\n    this.onMessage = (msg) => this.handleMessage(msg);\n    this.onError = (err) => this.handleTransportError(err);\n    this.onExit = (code) => this.handleExit(code);\n\n    this.transport.on(\"message\", this.onMessage);\n    this.transport.on(\"error\", this.onError);\n    this.transport.on(\"exit\", this.onExit);\n  }\n\n  public async start(): Promise<void> {\n    if (this.phase !== \"fresh\") {\n      throw new WorkerInitFailedError(\n        this.workerId,\n        `cannot start worker in phase ${this.phase}`,\n      );\n    }\n    this.phase = \"starting\";\n    const correlationId = this.nextCorrelationId();\n    const ready = new Promise<void>((resolve, reject) => {\n      this.pending.set(correlationId, {\n        kind: \"init\",\n        resolve,\n        reject,\n      });\n    });\n    this.transport.postMessage({\n      type: \"init\",\n      correlationId,\n      workerId: this.workerId,\n      poolConfig: this.initPayload.poolConfig,\n      db: this.initPayload.db,\n      signatureVerifier: this.initPayload.signatureVerifier,\n      models: this.initPayload.models,\n      executorConfig: this.initPayload.executorConfig,\n    });\n    await ready;\n    this.phase = \"ready\";\n  }\n\n  public execute(\n    job: Job,\n    signal?: AbortSignal,\n  ): Promise<WorkerExecutionOutcome> {\n    if (this.phase === \"terminated\") {\n      return Promise.reject(\n        this.lastExitError ??\n          new WorkerExitedError(this.workerId, -1, this.lastCorrelationId),\n      );\n    }\n    if (this.phase !== \"ready\") {\n      return Promise.reject(\n        new WorkerInitFailedError(\n          this.workerId,\n          `worker not ready (phase=${this.phase})`,\n        ),\n      );\n    }\n    if (this.inFlight !== null) {\n      return Promise.reject(new WorkerBusyError(this.workerId, job.id));\n    }\n\n    const correlationId = this.nextCorrelationId();\n    this.lastCorrelationId = correlationId;\n    this.inFlight = { correlationId, jobId: job.id };\n\n    let abortListener: (() => void) | null = null;\n    const detachSignal = () => {\n      if (signal && abortListener) {\n        signal.removeEventListener(\"abort\", abortListener);\n        abortListener = null;\n      }\n    };\n\n    const promise = new Promise<WorkerExecutionOutcome>((resolve, reject) => {\n      this.pending.set(correlationId, {\n        kind: \"execute\",\n        jobId: job.id,\n        resolve: (outcome) => {\n          detachSignal();\n          resolve(outcome);\n        },\n        reject: (err) => {\n          detachSignal();\n          reject(err);\n        },\n      });\n    });\n\n    if (signal) {\n      if (signal.aborted) {\n        this.abort(correlationId, \"aborted before dispatch\");\n      } else {\n        abortListener = () => this.abort(correlationId, \"caller signal\");\n        signal.addEventListener(\"abort\", abortListener, { once: true });\n      }\n    }\n\n    this.transport.postMessage({\n      type: \"execute\",\n      correlationId,\n      job,\n    });\n\n    return promise;\n  }\n\n  public abort(correlationId: string, reason?: string): void {\n    if (this.phase === \"terminated\") {\n      return;\n    }\n    if (!this.inFlight || this.inFlight.correlationId !== correlationId) {\n      return;\n    }\n    if (this.abortTimer) {\n      return;\n    }\n    this.transport.postMessage({\n      type: \"abort\",\n      correlationId: this.nextCorrelationId(),\n      targetCorrelationId: correlationId,\n      reason,\n    });\n    this.abortTimer = setTimeout(() => {\n      this.abortTimer = null;\n      const entry = this.pending.get(correlationId);\n      if (!entry || entry.kind !== \"execute\") {\n        return;\n      }\n      const err = new WorkerAbortTimeoutError(\n        this.workerId,\n        correlationId,\n        this.abortGraceMs,\n      );\n      this.failPending(correlationId, err);\n      this.inFlight = null;\n      void this.forceTerminate(err);\n    }, this.abortGraceMs);\n  }\n\n  public async shutdown(graceful: boolean, graceMs?: number): Promise<void> {\n    if (this.phase === \"terminated\") {\n      return;\n    }\n    if (!graceful) {\n      this.phase = \"shutting-down\";\n      await this.forceTerminate(null);\n      return;\n    }\n\n    const effectiveGrace = graceMs ?? this.defaultShutdownGraceMs;\n    this.phase = \"shutting-down\";\n    const correlationId = this.nextCorrelationId();\n    const drained = new Promise<void>((resolve, reject) => {\n      this.pending.set(correlationId, {\n        kind: \"shutdown\",\n        resolve,\n        reject,\n      });\n    });\n    this.transport.postMessage({\n      type: \"shutdown\",\n      correlationId,\n      graceMs: effectiveGrace,\n    });\n\n    let timer!: NodeJS.Timeout;\n    const timeout = new Promise<void>((_, reject) => {\n      timer = setTimeout(() => {\n        reject(new WorkerShutdownTimeoutError(this.workerId, effectiveGrace));\n      }, effectiveGrace);\n    });\n\n    try {\n      await Promise.race([drained, timeout]);\n    } catch (err) {\n      this.logger.warn(\n        `worker ${this.workerId} shutdown timed out after ${effectiveGrace}ms`,\n        err,\n      );\n    } finally {\n      clearTimeout(timer);\n    }\n\n    await this.forceTerminate(null);\n  }\n\n  public loadModel(\n    entry: ModelManifestEntry,\n    signal?: AbortSignal,\n  ): Promise<void> {\n    if (this.phase === \"terminated\") {\n      return Promise.reject(\n        this.lastExitError ??\n          new WorkerExitedError(this.workerId, -1, this.lastCorrelationId),\n      );\n    }\n    if (this.phase !== \"ready\") {\n      return Promise.reject(\n        new WorkerInitFailedError(\n          this.workerId,\n          `worker not ready (phase=${this.phase})`,\n        ),\n      );\n    }\n\n    const correlationId = this.nextCorrelationId();\n    let abortListener: (() => void) | null = null;\n    const detachSignal = () => {\n      if (signal && abortListener) {\n        signal.removeEventListener(\"abort\", abortListener);\n        abortListener = null;\n      }\n    };\n\n    const promise = new Promise<void>((resolve, reject) => {\n      this.pending.set(correlationId, {\n        kind: \"load-model\",\n        documentType: entry.documentType,\n        version: entry.version,\n        resolve: () => {\n          detachSignal();\n          resolve();\n        },\n        reject: (err) => {\n          detachSignal();\n          reject(err);\n        },\n      });\n    });\n\n    if (signal) {\n      if (signal.aborted) {\n        this.failPending(\n          correlationId,\n          new WorkerLoadModelFailedError(\n            this.workerId,\n            entry.documentType,\n            entry.version,\n            \"aborted before dispatch\",\n          ),\n        );\n        return promise;\n      }\n      abortListener = () => {\n        this.failPending(\n          correlationId,\n          new WorkerLoadModelFailedError(\n            this.workerId,\n            entry.documentType,\n            entry.version,\n            \"caller signal\",\n          ),\n        );\n      };\n      signal.addEventListener(\"abort\", abortListener, { once: true });\n    }\n\n    this.transport.postMessage({\n      type: \"load-model\",\n      correlationId,\n      model: entry,\n    });\n\n    return promise;\n  }\n\n  public isIdle(): boolean {\n    return this.inFlight === null && this.phase === \"ready\";\n  }\n\n  public getInFlight(): WorkerInFlightSnapshot | null {\n    if (!this.inFlight) {\n      return null;\n    }\n    return {\n      correlationId: this.inFlight.correlationId,\n      jobId: this.inFlight.jobId,\n    };\n  }\n\n  private nextCorrelationId(): string {\n    return randomUUID();\n  }\n\n  private handleMessage(msg: WorkerMessage): void {\n    switch (msg.type) {\n      case \"ready\":\n        this.handleReady(msg.correlationId);\n        return;\n      case \"result\":\n        this.handleResult(msg);\n        return;\n      case \"model-loaded\":\n        this.handleModelLoaded(msg);\n        return;\n      case \"model-load-failed\":\n        this.handleModelLoadFailed(msg);\n        return;\n      case \"log\":\n        this.handleLog(msg);\n        return;\n      case \"heartbeat\":\n        this.handleHeartbeat(msg);\n        return;\n      case \"metrics\":\n        this.handleMetrics(msg);\n        return;\n      case \"pool-acquire-samples\":\n        this.handlePoolAcquireSamples(msg);\n        return;\n      default: {\n        const exhaustive: never = msg;\n        void exhaustive;\n      }\n    }\n  }\n\n  private handlePoolAcquireSamples(msg: PoolAcquireSamplesMessage): void {\n    if (!this.poolInstrumentation) {\n      return;\n    }\n    this.poolInstrumentation.updateStats({\n      size: msg.size,\n      idle: msg.idle,\n      waiting: msg.waiting,\n    });\n    this.poolInstrumentation.pushSamples(msg.durations);\n  }\n\n  private handleReady(correlationId: string): void {\n    const entry = this.pending.get(correlationId);\n    if (!entry || entry.kind !== \"init\") {\n      return;\n    }\n    this.pending.delete(correlationId);\n    entry.resolve();\n  }\n\n  private handleResult(msg: ResultMessage): void {\n    const entry = this.pending.get(msg.correlationId);\n    if (!entry || entry.kind !== \"execute\") {\n      return;\n    }\n    this.pending.delete(msg.correlationId);\n    if (this.inFlight?.correlationId === msg.correlationId) {\n      this.inFlight = null;\n    }\n    if (this.abortTimer) {\n      clearTimeout(this.abortTimer);\n      this.abortTimer = null;\n    }\n\n    const outcome: WorkerExecutionOutcome = msg.error\n      ? {\n          result: {\n            ...msg.result,\n            success: false,\n            error: fromErrorInfo(msg.error),\n          },\n        }\n      : {\n          result: msg.result,\n          writeReady: msg.writeReady,\n        };\n    entry.resolve(outcome);\n\n    if (this.phase === \"shutting-down\") {\n      const shutdownEntry = [...this.pending.values()].find(\n        (e) => e.kind === \"shutdown\",\n      );\n      if (shutdownEntry) {\n        shutdownEntry.resolve();\n      }\n    }\n  }\n\n  private handleModelLoaded(msg: ModelLoadedMessage): void {\n    const entry = this.pending.get(msg.correlationId);\n    if (!entry || entry.kind !== \"load-model\") {\n      return;\n    }\n    this.pending.delete(msg.correlationId);\n    entry.resolve();\n  }\n\n  private handleModelLoadFailed(msg: ModelLoadFailedMessage): void {\n    const entry = this.pending.get(msg.correlationId);\n    if (!entry || entry.kind !== \"load-model\") {\n      return;\n    }\n    this.pending.delete(msg.correlationId);\n    entry.reject(\n      new WorkerLoadModelFailedError(\n        this.workerId,\n        msg.documentType,\n        msg.version,\n        msg.error.message,\n        { cause: fromErrorInfo(msg.error) },\n      ),\n    );\n  }\n\n  private handleLog(msg: LogMessage): void {\n    const args = msg.args;\n    switch (msg.level) {\n      case \"debug\":\n        this.logger.debug(msg.message, ...args);\n        return;\n      case \"info\":\n        this.logger.info(msg.message, ...args);\n        return;\n      case \"warn\":\n        this.logger.warn(msg.message, ...args);\n        return;\n      case \"error\":\n        this.logger.error(msg.message, ...args);\n        return;\n      default: {\n        const exhaustive: never = msg.level;\n        void exhaustive;\n      }\n    }\n  }\n\n  private handleHeartbeat(msg: HeartbeatMessage): void {\n    this.lastHeartbeatAt = msg.timestamp;\n  }\n\n  private handleMetrics(msg: MetricsMessage): void {\n    this.lastMetrics = {\n      counters: msg.counters,\n      gauges: msg.gauges,\n      timestamp: msg.timestamp,\n    };\n  }\n\n  private handleTransportError(err: Error): void {\n    this.logger.error(\n      `worker ${this.workerId} transport error: ${err.message}`,\n      err,\n    );\n  }\n\n  private handleExit(code: number): void {\n    if (this.phase === \"terminated\") {\n      return;\n    }\n    const wasGraceful = this.phase === \"shutting-down\" && code === 0;\n    this.phase = \"terminated\";\n    const err = wasGraceful\n      ? null\n      : new WorkerExitedError(this.workerId, code, this.lastCorrelationId);\n    this.lastExitError = err;\n    if (this.abortTimer) {\n      clearTimeout(this.abortTimer);\n      this.abortTimer = null;\n    }\n    this.detachTransportListeners();\n    this.drainPending(err);\n    this.inFlight = null;\n  }\n\n  private detachTransportListeners(): void {\n    this.transport.off(\"message\", this.onMessage);\n    this.transport.off(\"error\", this.onError);\n    this.transport.off(\"exit\", this.onExit);\n  }\n\n  private drainPending(err: Error | null): void {\n    for (const [, entry] of this.pending) {\n      if (err) {\n        entry.reject(err);\n      } else if (entry.kind === \"shutdown\") {\n        entry.resolve();\n      } else if (entry.kind === \"init\") {\n        entry.reject(new WorkerInitFailedError(this.workerId, \"worker exited\"));\n      } else if (entry.kind === \"load-model\") {\n        entry.reject(\n          new WorkerLoadModelFailedError(\n            this.workerId,\n            entry.documentType,\n            entry.version,\n            \"worker exited before responding\",\n          ),\n        );\n      } else {\n        entry.reject(\n          new WorkerExitedError(this.workerId, 0, this.lastCorrelationId),\n        );\n      }\n    }\n    this.pending.clear();\n  }\n\n  private failPending(correlationId: string, err: Error): void {\n    const entry = this.pending.get(correlationId);\n    if (!entry) {\n      return;\n    }\n    this.pending.delete(correlationId);\n    entry.reject(err);\n  }\n\n  private async forceTerminate(reason: Error | null): Promise<void> {\n    if (this.phase === \"terminated\") {\n      return;\n    }\n    try {\n      await this.transport.terminate();\n    } catch (err) {\n      this.logger.warn(\n        `worker ${this.workerId} terminate threw: ${(err as Error).message}`,\n      );\n    }\n    const phaseAfter = this.phase as Phase;\n    if (phaseAfter === \"terminated\") {\n      return;\n    }\n    this.phase = \"terminated\";\n    this.lastExitError = reason;\n    this.detachTransportListeners();\n    this.drainPending(reason);\n    this.inFlight = null;\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/reactor",
-  "version": "6.2.2-dev.9",
+  "version": "6.2.2-staging.0",
   "description": "Core Powerhouse reactor — stores documents, resolves conflicts, and reprocesses operation histories. Supports local, cloud, and decentralized storage backends.",
   "repository": {
     "url": "https://github.com/powerhouse-inc/powerhouse",
@@ -42,10 +42,11 @@
     "@electric-sql/pglite": "0.3.15",
     "pg": "8.18.0",
     "@sindresorhus/fnv1a": "3.1.0",
-    "@powerhousedao/shared": "6.2.2-dev.9",
-    "document-model": "6.2.2-dev.9"
+    "@powerhousedao/shared": "6.2.2-staging.0",
+    "document-model": "6.2.2-staging.0"
   },
   "devDependencies": {
+    "@powerhousedao/pglite-fs": "6.2.2-staging.0",
     "@types/pg": "8.16.0",
     "@vitest/coverage-v8": "4.1.1",
     "prettier": "3.8.1",
@@ -54,7 +55,7 @@
     "vitest": "4.1.1",
     "@types/bun": "1.3.8",
     "tsdown": "0.21.1",
-    "@powerhousedao/pglite-fs": "6.2.2-dev.9"
+    "zod": "4.3.6"
   },
   "homepage": "https://academy.vetra.io/academy/Reference/Reactor/WorkingWithTheReactor",
   "scripts": {
@@ -63,12 +64,28 @@
     "test:watch": "vitest --coverage",
     "lint": "eslint",
     "bench": "vitest bench --run",
-    "bench:sync": "node --import tsx bench/two-reactor-sync.bench.ts",
+    "bench:record": "tsx bench/records/run-record-all.ts",
+    "bench:auth": "vitest bench --run bench/auth-scope",
+    "bench:auth:record": "vitest bench --run bench/auth-scope --outputJson bench/results/auth-scope.json",
+    "bench:auth:compare": "vitest bench --run bench/auth-scope --compare bench/results/auth-scope.json",
+    "bench:events:record": "vitest bench --run bench/event-bus --outputJson bench/results/event-bus.json",
+    "bench:queue:record": "vitest bench --run bench/queue-perf --outputJson bench/results/queue-perf.json",
+    "bench:queue-only:record": "vitest bench --run bench/queue-only --outputJson bench/results/queue-only.json",
+    "bench:cache:record": "vitest bench --run bench/write-cache --outputJson bench/results/write-cache.json",
+    "bench:sync": "node --import tsx bench/two-reactor-sync.ts",
+    "bench:sync:record": "node --import tsx bench/two-reactor-sync.ts --record",
+    "bench:sync:smoke": "node --import tsx bench/two-reactor-sync.ts --smoke",
     "clean": "rimraf dist",
     "clean:node_modules": "rimraf node_modules",
     "claude": "pnpm build && pnpm test && pnpm exec prettier --write \"**/*.ts\" && pnpm lint",
     "migrate": "tsx src/storage/migrations/run-migrations.ts",
     "migrate:status": "tsx src/storage/migrations/run-migrations.ts status",
+    "preflight:auth": "tsx src/admin/run-stream-order-check.ts",
+    "bench:records": "tsx bench/records/run-records.ts",
+    "bench:records:verify": "tsx bench/records/run-records.ts verify",
+    "bench:records:from-vitest": "tsx bench/records/run-from-vitest.ts",
+    "bench:fix": "tsx bench/fix/run-fix.ts",
+    "bench:ui": "node bench/ui/serve.mjs",
     "docker:up": "docker compose up -d",
     "docker:down": "docker compose down"
   }