@sixb/core 0.1.9 → 0.1.10

package/src/workflows/run-dispatch.ts

@@ -57,6 +57,8 @@ interface DispatchWorkflowRunInput {
   readonly source?: WorkflowRunSource
   readonly metadata?: Readonly<Record<string, string>>
   readonly queueJobId?: string
+  /** Automatic callers own publication retries; validate provenance before any replay effect. */
+  readonly validateExistingRun?: (run: WorkflowRunRecord) => Promise<void>
   readonly createExecution: (executionId: string, runId: string) => Promise<CreateExecutionInput>
 }
 
@@ -88,7 +90,7 @@ export class WorkflowRunDispatcher implements WorkflowRunDispatchPort {
       throw new WorkflowValidationError(`[Sixb] Unknown workflow '${input.workflowId}'`)
     }
 
-    const result = await dispatchWorkflowRun({
+    return dispatchWorkflowRun({
       errorReporterHost: this.dependencies,
       projectId: this.dependencies.id,
       workflow,
@@ -106,6 +108,7 @@ export class WorkflowRunDispatcher implements WorkflowRunDispatchPort {
       },
       metadata: input.metadata,
       queueJobId: input.runId,
+      validateExistingRun: (run) => assertAutomaticExecutionIdentity(this.dependencies, input, run),
       createExecution: async (executionId, runId) =>
         createPrimitiveExecutionRecord({
           id: executionId,
@@ -118,10 +121,6 @@ export class WorkflowRunDispatcher implements WorkflowRunDispatchPort {
           },
         }),
     })
-    if (!result.created) {
-      await assertAutomaticExecutionIdentity(this.dependencies, input, result.runId)
-    }
-    return result
   }
 }
 
@@ -131,7 +130,15 @@ export async function dispatchWorkflowRun(
 ): Promise<WorkflowRunRequestResult> {
   const request = prepareWorkflowRun(input)
   const persisted = await persistWorkflowRun(input, request)
-  if (!persisted.created) return existingWorkflowRunResult(persisted.run)
+  if (!persisted.created) {
+    await input.validateExistingRun?.(persisted.run)
+    if (input.validateExistingRun && persisted.run.status === "queued") {
+      // A queued run is also the recoverable intent when publication never completed.
+      // Reuse the provider job identity, including after a successful but unacknowledged enqueue.
+      await enqueueWorkflowRun(input, persisted.run)
+    }
+    return existingWorkflowRunResult(persisted.run)
+  }
   return publishWorkflowRun(input, persisted)
 }
 
@@ -213,20 +220,11 @@ async function publishWorkflowRun(
 ): Promise<WorkflowRunRequestResult> {
   let job: Awaited<ReturnType<Queues["workflows"]["enqueue"]>>[number] | undefined
   try {
-    const jobs = await input.queue.enqueue({
-      projectId: input.projectId,
-      jobs: [
-        {
-          ...(input.queueJobId === undefined ? {} : { id: input.queueJobId }),
-          type: "workflow.run.requested",
-          payload: { runId: persisted.run.id },
-          ...(input.metadata === undefined ? {} : { metadata: input.metadata }),
-        },
-      ],
-    })
-    job = jobs[0]
+    job = await enqueueWorkflowRun(input, persisted.run)
   } catch (error) {
-    await failWorkflowRunPublication(input, persisted.run, error)
+    // Automatic dispatch retries the same run. Do not turn an uncertain enqueue into
+    // a terminal business failure: the queue may have accepted it before losing the reply.
+    if (!input.validateExistingRun) await failWorkflowRunPublication(input, persisted.run, error)
     throw error
   }
 
@@ -258,6 +256,27 @@ async function publishWorkflowRun(
   }
 }
 
+async function enqueueWorkflowRun(
+  input: DispatchWorkflowRunInput,
+  run: WorkflowRunRecord
+): Promise<Awaited<ReturnType<Queues["workflows"]["enqueue"]>>[number]> {
+  const [job] = await input.queue.enqueue({
+    projectId: input.projectId,
+    jobs: [
+      {
+        ...(input.queueJobId === undefined ? {} : { id: input.queueJobId }),
+        type: "workflow.run.requested",
+        payload: { runId: run.id },
+        ...(input.metadata === undefined ? {} : { metadata: input.metadata }),
+      },
+    ],
+  })
+  if (!job || (input.queueJobId !== undefined && job.id !== input.queueJobId)) {
+    throw new WorkflowRunError(`[Sixb] Queue did not acknowledge workflow run '${run.id}'.`)
+  }
+  return job
+}
+
 async function failWorkflowRunPublication(
   input: DispatchWorkflowRunInput,
   run: WorkflowRunRecord,
@@ -326,18 +345,12 @@ function assertAutomaticDispatchInput(input: AutomaticWorkflowRunDispatchInput):
 async function assertAutomaticExecutionIdentity(
   dependencies: WorkflowRunDispatcherDependencies,
   input: AutomaticWorkflowRunDispatchInput,
-  runId: string
+  run: WorkflowRunRecord
 ): Promise<void> {
-  const run = await dependencies.storage.workflowRuns?.getById({
+  const execution = await dependencies.storage.executions.getById({
     projectId: dependencies.id,
-    id: runId,
+    id: run.executionId,
   })
-  const execution = run
-    ? await dependencies.storage.executions.getById({
-        projectId: dependencies.id,
-        id: run.executionId,
-      })
-    : null
   if (
     !execution ||
     execution.source.type !== input.source.type ||
@@ -346,7 +359,7 @@ async function assertAutomaticExecutionIdentity(
     execution.requestedBy !== undefined
   ) {
     throw new WorkflowValidationError(
-      `[Sixb] Workflow run '${runId}' already exists with different automatic provenance.`
+      `[Sixb] Workflow run '${run.id}' already exists with different automatic provenance.`
     )
   }
 }

package/dist/chunk-0rdrecsb.js.map

@@ -1,11 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/broker/errors.ts", "../src/broker/in-memory.ts"],
-  "sourcesContent": [
-    "export class BrokerError extends Error {\n  readonly name: string = \"BrokerError\"\n\n  constructor(message: string, options?: ErrorOptions) {\n    super(`[Broker] ${message}`, options)\n  }\n}\n\n/**\n * Raised when retention has removed the cursor a consumer wants to resume\n * from. Transports use this provider-independent type to request a reset.\n */\nexport class BrokerCursorExpiredError extends BrokerError {\n  override readonly name = \"BrokerCursorExpiredError\"\n}\n",
-    "import { getInvalidJsonValueReason, type JsonValue } from \"../json\"\nimport { BrokerCursorExpiredError, BrokerError } from \"./errors\"\nimport type {\n  Broker,\n  BrokerPage,\n  BrokerRecord,\n  BrokerRecordInput,\n  BrokerStreamDefinition,\n} from \"./types\"\n\n// Payloads are validated by assertBrokerPayload above the call site, so we can\n// skip the redundant validity walk that cloneJsonValue performs.\nfunction cloneValidatedPayload(value: JsonValue): JsonValue {\n  return JSON.parse(JSON.stringify(value)) as JsonValue\n}\n\n// Records stored internally carry a numeric publishedAtMs alongside the public\n// ISO publishedAt string so retention sweeps can avoid Date.parse on every\n// record on every append/read.\ninterface StoredRecord extends BrokerRecord {\n  readonly publishedAtMs: number\n  readonly byteSize: number\n}\n\ninterface StoredStream {\n  definition: BrokerStreamDefinition\n  nextSequence: bigint\n  records: StoredRecord[]\n  retainedBytes: number\n}\n\ninterface Subscription {\n  readonly projectId: string\n  readonly streamId: string\n  readonly names?: readonly string[]\n  readonly keys?: readonly string[]\n  readonly handler: (records: readonly BrokerRecord[]) => void\n}\n\nexport class InMemoryBroker implements Broker {\n  readonly scope = \"process\" as const\n  private readonly streams = new Map<string, StoredStream>()\n  private readonly subscriptions = new Set<Subscription>()\n\n  async ensureStream(params: { projectId: string; stream: BrokerStreamDefinition }): Promise<void> {\n    assertProjectId(params.projectId)\n    assertStream(params.stream)\n    this.getOrCreateStream(params.projectId, params.stream)\n  }\n\n  async append(params: {\n    projectId: string\n    streamId: string\n    records: readonly BrokerRecordInput[]\n  }): Promise<readonly BrokerRecord[]> {\n    assertProjectId(params.projectId)\n    assertStreamId(params.streamId)\n\n    if (params.records.length === 0) {\n      return []\n    }\n\n    for (const record of params.records) {\n      assertBrokerPayload(record.payload)\n    }\n\n    const storedStream = this.getEnsuredStream(params.projectId, params.streamId)\n    const stored: StoredRecord[] = []\n\n    for (const record of params.records) {\n      const cursor = storedStream.nextSequence.toString()\n      storedStream.nextSequence += 1n\n      const publishedAtMs = Date.now()\n      const storedRecord = {\n        streamId: params.streamId,\n        cursor,\n        name: record.name,\n        key: record.key,\n        payload: cloneValidatedPayload(record.payload as JsonValue),\n        publishedAt: new Date(publishedAtMs).toISOString(),\n        publishedAtMs,\n      }\n      stored.push({\n        ...storedRecord,\n        byteSize: utf8Bytes(JSON.stringify(storedRecord)),\n      })\n    }\n\n    storedStream.records.push(...stored)\n    storedStream.retainedBytes += stored.reduce((total, record) => total + record.byteSize, 0)\n    this.applyRetention(storedStream)\n    const records = stored.map(toBrokerRecord)\n    this.notify(params.projectId, params.streamId, stored)\n    return records\n  }\n\n  async read(params: {\n    projectId: string\n    streamId: string\n    afterCursor?: string\n    limit?: number\n    names?: readonly string[]\n    keys?: readonly string[]\n  }): Promise<BrokerPage> {\n    assertProjectId(params.projectId)\n    assertStreamId(params.streamId)\n    assertCursor(params.afterCursor)\n\n    if (params.limit !== undefined && params.limit <= 0) {\n      return { records: [], cursor: params.afterCursor, hasMore: false }\n    }\n\n    const storedStream = this.streams.get(streamKey(params.projectId, params.streamId))\n    if (!storedStream) {\n      return { records: [], cursor: params.afterCursor, hasMore: false }\n    }\n\n    this.applyRetention(storedStream)\n    this.assertCursorInRetainedRange(storedStream, params.afterCursor)\n    return this.readForward(storedStream.records, {\n      afterCursor: params.afterCursor,\n      limit: params.limit,\n      names: params.names,\n      keys: params.keys,\n    })\n  }\n\n  async tail(params: {\n    projectId: string\n    streamId: string\n    beforeCursor?: string\n    limit?: number\n    names?: readonly string[]\n    keys?: readonly string[]\n  }): Promise<BrokerPage> {\n    assertProjectId(params.projectId)\n    assertStreamId(params.streamId)\n    assertCursor(params.beforeCursor)\n\n    if (params.limit !== undefined && params.limit <= 0) {\n      return { records: [], cursor: params.beforeCursor, hasMore: false }\n    }\n\n    const storedStream = this.streams.get(streamKey(params.projectId, params.streamId))\n    if (!storedStream) {\n      return { records: [], cursor: params.beforeCursor, hasMore: false }\n    }\n\n    this.applyRetention(storedStream)\n    this.assertTailCursorInRetainedRange(storedStream, params.beforeCursor)\n    return this.readBackward(storedStream.records, params)\n  }\n\n  async latestCursor(params: { projectId: string; streamId: string }): Promise<string | undefined> {\n    assertProjectId(params.projectId)\n    assertStreamId(params.streamId)\n\n    const storedStream = this.streams.get(streamKey(params.projectId, params.streamId))\n    if (!storedStream) {\n      return undefined\n    }\n\n    this.applyRetention(storedStream)\n    return storedStream.records.at(-1)?.cursor\n  }\n\n  async subscribe(\n    params: {\n      projectId: string\n      streamId: string\n      from?: \"latest\" | \"earliest\"\n      afterCursor?: string\n      names?: readonly string[]\n      keys?: readonly string[]\n    },\n    handler: (records: readonly BrokerRecord[]) => void\n  ): Promise<() => void> {\n    assertProjectId(params.projectId)\n    assertStreamId(params.streamId)\n    assertCursor(params.afterCursor)\n    const storedStream = this.getEnsuredStream(params.projectId, params.streamId)\n\n    // Retention may have trimmed past the caller's cursor. Reject that here rather than let\n    // `readForward` skip silently to the oldest retained record: a resuming subscriber would be\n    // fast-forwarded over the gap and would believe it had seen everything. `read` and `tail`\n    // already reject it, and so does the Redis provider, so this keeps the three consistent.\n    // Checked before the subscription is registered so a throw cannot leave one behind.\n    this.applyRetention(storedStream)\n    this.assertCursorInRetainedRange(storedStream, params.afterCursor)\n\n    const subscription: Subscription = {\n      projectId: params.projectId,\n      streamId: params.streamId,\n      names: params.names,\n      keys: params.keys,\n      handler,\n    }\n    this.subscriptions.add(subscription)\n\n    const startMode = params.afterCursor !== undefined ? undefined : (params.from ?? \"latest\")\n    if (params.afterCursor !== undefined || startMode === \"earliest\") {\n      const initial = this.readForward(storedStream.records, {\n        afterCursor: params.afterCursor,\n        names: params.names,\n        keys: params.keys,\n      }).records\n      this.deliver(subscription, initial)\n    }\n\n    return () => {\n      this.subscriptions.delete(subscription)\n    }\n  }\n\n  private getOrCreateStream(projectId: string, stream: BrokerStreamDefinition): StoredStream {\n    const key = streamKey(projectId, stream.id)\n    let storedStream = this.streams.get(key)\n    if (!storedStream) {\n      storedStream = {\n        definition: stream,\n        nextSequence: 1n,\n        records: [],\n        retainedBytes: 0,\n      }\n      this.streams.set(key, storedStream)\n    }\n    this.applyRetention(storedStream)\n    return storedStream\n  }\n\n  private getEnsuredStream(projectId: string, streamId: string): StoredStream {\n    const storedStream = this.streams.get(streamKey(projectId, streamId))\n    if (!storedStream) {\n      throw new BrokerError(\n        `stream '${streamId}' has not been ensured for project '${projectId}'. Call ensureStream() before append or subscribe.`\n      )\n    }\n    return storedStream\n  }\n\n  private applyRetention(storedStream: StoredStream): void {\n    const { retention } = storedStream.definition\n    if (!retention) {\n      return\n    }\n\n    let removeCount = 0\n    const records = storedStream.records\n\n    if (retention.maxAgeMs !== undefined) {\n      if (retention.maxAgeMs <= 0) {\n        removeCount = records.length\n      } else {\n        const oldestAllowed = Date.now() - retention.maxAgeMs\n        // Records are appended in chronological order, so we only need to find\n        // the first record that is still in range and slice off the prefix —\n        // avoids walking the entire retained set on every sweep.\n        let firstInRange = 0\n        while (\n          firstInRange < records.length &&\n          records[firstInRange].publishedAtMs < oldestAllowed\n        ) {\n          firstInRange += 1\n        }\n        removeCount = Math.max(removeCount, firstInRange)\n      }\n    }\n\n    if (retention.maxRecords !== undefined) {\n      if (retention.maxRecords <= 0) {\n        removeCount = records.length\n      } else if (records.length - removeCount > retention.maxRecords) {\n        removeCount = records.length - retention.maxRecords\n      }\n    }\n\n    if (retention.maxBytes !== undefined) {\n      if (retention.maxBytes <= 0) {\n        removeCount = records.length\n      } else {\n        let bytes = storedStream.retainedBytes\n        for (let index = 0; index < removeCount; index += 1) {\n          bytes -= records[index]!.byteSize\n        }\n        while (removeCount < records.length && bytes > retention.maxBytes) {\n          bytes -= records[removeCount]!.byteSize\n          removeCount += 1\n        }\n      }\n    }\n\n    if (removeCount > 0) {\n      for (let index = 0; index < removeCount; index += 1) {\n        storedStream.retainedBytes -= records[index]!.byteSize\n      }\n      storedStream.records = records.slice(removeCount)\n    }\n  }\n\n  private assertCursorInRetainedRange(\n    storedStream: StoredStream,\n    afterCursor: string | undefined\n  ): void {\n    if (afterCursor === undefined) {\n      return\n    }\n\n    const requestedNextSequence = BigInt(afterCursor) + 1n\n    const firstRecord = storedStream.records[0]\n    const firstAvailableSequence =\n      firstRecord === undefined ? storedStream.nextSequence : BigInt(firstRecord.cursor)\n\n    if (requestedNextSequence < firstAvailableSequence) {\n      throw new BrokerCursorExpiredError(\n        `afterCursor '${afterCursor}' is outside the retained range for stream '${storedStream.definition.id}'. ` +\n          `The next requested cursor sequence is '${requestedNextSequence}', but the earliest ` +\n          `available cursor sequence is '${firstAvailableSequence}'.`\n      )\n    }\n  }\n\n  private assertTailCursorInRetainedRange(\n    storedStream: StoredStream,\n    beforeCursor: string | undefined\n  ): void {\n    if (beforeCursor === undefined || storedStream.records.length === 0) {\n      return\n    }\n    const firstAvailableSequence = BigInt(storedStream.records[0]!.cursor)\n    if (BigInt(beforeCursor) < firstAvailableSequence) {\n      throw new BrokerCursorExpiredError(\n        `beforeCursor '${beforeCursor}' is outside the retained range for stream '${storedStream.definition.id}'. ` +\n          `The earliest available cursor sequence is '${firstAvailableSequence}'.`\n      )\n    }\n  }\n\n  private notify(projectId: string, streamId: string, records: readonly StoredRecord[]): void {\n    for (const subscription of this.subscriptions) {\n      if (subscription.projectId !== projectId || subscription.streamId !== streamId) {\n        continue\n      }\n      this.deliver(\n        subscription,\n        this.readForward(records, {\n          names: subscription.names,\n          keys: subscription.keys,\n        }).records\n      )\n    }\n  }\n\n  private deliver(subscription: Subscription, records: readonly BrokerRecord[]): void {\n    if (records.length === 0) {\n      return\n    }\n\n    try {\n      subscription.handler(records)\n    } catch {\n      // Broker subscriptions are live fan-out; handler failures should not break publishers.\n    }\n  }\n\n  private readForward(\n    records: readonly StoredRecord[],\n    filters: {\n      afterCursor?: string\n      limit?: number\n      names?: readonly string[]\n      keys?: readonly string[]\n    }\n  ): BrokerPage {\n    const names = filters.names && filters.names.length > 0 ? new Set(filters.names) : undefined\n    const keys = filters.keys && filters.keys.length > 0 ? new Set(filters.keys) : undefined\n    const afterCursor = filters.afterCursor ? BigInt(filters.afterCursor) : undefined\n    const result: BrokerRecord[] = []\n    let cursor = filters.afterCursor\n    let stoppedAt = records.length\n\n    for (let index = 0; index < records.length; index += 1) {\n      const record = records[index]!\n      if (afterCursor !== undefined && BigInt(record.cursor) <= afterCursor) {\n        continue\n      }\n      cursor = record.cursor\n      if (!matchesFilters(record, names, keys)) {\n        continue\n      }\n      result.push(toBrokerRecord(record))\n      if (filters.limit !== undefined && result.length >= filters.limit) {\n        stoppedAt = index + 1\n        break\n      }\n    }\n\n    return {\n      records: result,\n      cursor,\n      hasMore: records.slice(stoppedAt).some((record) => matchesFilters(record, names, keys)),\n    }\n  }\n\n  private readBackward(\n    records: readonly StoredRecord[],\n    filters: {\n      beforeCursor?: string\n      limit?: number\n      names?: readonly string[]\n      keys?: readonly string[]\n    }\n  ): BrokerPage {\n    const names = filters.names && filters.names.length > 0 ? new Set(filters.names) : undefined\n    const keys = filters.keys && filters.keys.length > 0 ? new Set(filters.keys) : undefined\n    const beforeCursor = filters.beforeCursor ? BigInt(filters.beforeCursor) : undefined\n    const reversed: BrokerRecord[] = []\n    let cursor = filters.beforeCursor\n    let stoppedAt = -1\n\n    for (let index = records.length - 1; index >= 0; index -= 1) {\n      const record = records[index]!\n      if (beforeCursor !== undefined && BigInt(record.cursor) >= beforeCursor) {\n        continue\n      }\n      cursor = record.cursor\n      if (!matchesFilters(record, names, keys)) {\n        continue\n      }\n      reversed.push(toBrokerRecord(record))\n      if (filters.limit !== undefined && reversed.length >= filters.limit) {\n        stoppedAt = index - 1\n        break\n      }\n    }\n\n    return {\n      records: reversed.reverse(),\n      cursor,\n      hasMore:\n        stoppedAt >= 0 &&\n        records.slice(0, stoppedAt + 1).some((record) => matchesFilters(record, names, keys)),\n    }\n  }\n}\n\nfunction matchesFilters(\n  record: BrokerRecord,\n  names: ReadonlySet<string> | undefined,\n  keys: ReadonlySet<string> | undefined\n): boolean {\n  return (\n    (!names || (!!record.name && names.has(record.name))) &&\n    (!keys || (!!record.key && keys.has(record.key)))\n  )\n}\n\nfunction streamKey(projectId: string, streamId: string): string {\n  return `${projectId}\\0${streamId}`\n}\n\nfunction toBrokerRecord(record: StoredRecord): BrokerRecord {\n  return {\n    streamId: record.streamId,\n    cursor: record.cursor,\n    name: record.name,\n    key: record.key,\n    payload: record.payload,\n    publishedAt: record.publishedAt,\n  }\n}\n\nfunction utf8Bytes(value: string): number {\n  return new TextEncoder().encode(value).byteLength\n}\n\nfunction assertProjectId(projectId: string): void {\n  if (projectId.trim().length === 0) {\n    throw new BrokerError(\"projectId must be a non-empty string\")\n  }\n}\n\nfunction assertStream(stream: BrokerStreamDefinition): void {\n  if (stream.id.trim().length === 0) {\n    throw new BrokerError(\"stream.id must be a non-empty string\")\n  }\n}\n\nfunction assertStreamId(streamId: string): void {\n  if (streamId.trim().length === 0) {\n    throw new BrokerError(\"streamId must be a non-empty string\")\n  }\n}\n\nfunction assertBrokerPayload(payload: unknown): void {\n  const reason = getInvalidJsonValueReason(payload, \"record.payload\")\n  if (reason) {\n    throw new BrokerError(`record.payload must be a JSON value; ${reason}`)\n  }\n}\n\nfunction assertCursor(cursor: string | undefined): void {\n  if (cursor === undefined) {\n    return\n  }\n\n  try {\n    if (BigInt(cursor) < 0n) {\n      throw new BrokerError(\"cursor must be non-negative\")\n    }\n  } catch (error) {\n    if (error instanceof BrokerError) {\n      throw error\n    }\n    throw new BrokerError(\"cursor must be a numeric in-memory broker cursor\", {\n      cause: error,\n    })\n  }\n}\n"
-  ],
-  "mappings": "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",
-  "debugId": "356153004EE6A88A64756E2164756E21",
-  "names": []
-}

package/dist/chunk-3f7veca0.js.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/connectors/types.ts"],
-  "sourcesContent": [
-    "import type { WebhookDefinition } from \"../webhooks/types\"\n\n/**\n * Runtime context passed to connector adapters when Sixb establishes a connection.\n *\n * Connectors can use this to scope logs, build cache keys, or attach cancellation\n * to long-running startup work.\n */\nexport interface ConnectorContext {\n  readonly projectId: string\n  readonly connectorId: string\n  readonly signal: AbortSignal\n}\n\n/**\n * Minimal contract for a Sixb connector adapter.\n *\n * Adapters are responsible for creating and optionally tearing down a client for an\n * external system. They should return the client shape that feels natural for that system.\n */\nexport interface ConnectorAdapter<TType extends string = string, TClient = unknown> {\n  readonly type: TType\n  readonly authentication?: never\n  readonly webhooks?: readonly WebhookDefinition<unknown, TClient>[]\n  connect(context: ConnectorContext): Promise<TClient> | TClient\n  disconnect?(client: TClient): Promise<void> | void\n}\n\n/** One OAuth token set normalized by an OAuth connector adapter. */\nexport interface ConnectorOAuthCredentials {\n  readonly accessToken: string\n  readonly refreshToken?: string\n  readonly tokenType?: string\n  readonly scopes?: readonly string[]\n  readonly expiresAt?: Date\n}\n\n/** Public, non-secret account information returned for framework-owned selection UI. */\nexport interface ConnectorAccountCandidate {\n  readonly id: string\n  readonly label: string\n  readonly description?: string\n  readonly avatarUrl?: string\n}\n\n/** V1 intentionally supports project-owned connector connections only. */\nexport interface ProjectConnectorConnectionOwner {\n  readonly type: \"project\"\n}\n\nexport type ConnectorConnectionOwner = ProjectConnectorConnectionOwner\n\n/** Stable application-defined lookup key for one connector connection. */\nexport interface ConnectorConnectionSelector {\n  readonly owner: ConnectorConnectionOwner\n  readonly slot: string\n}\n\n/** Stable, non-secret metadata shared by connector connection consumers. */\nexport interface ConnectorConnectionMetadata extends ConnectorConnectionSelector {\n  readonly id: string\n  readonly connectorId: string\n  readonly account: ConnectorAccountCandidate\n}\n\n/** Credential protection required when an OAuth connector uses durable connection storage. */\nexport interface ConnectorConnectionOptions {\n  /** Canonical base64url encoding of exactly 32 random bytes, shared by storage replicas. */\n  readonly encryptionKey: string\n}\n\nexport interface OAuthConnectorAuthorizationContext extends ConnectorContext {\n  readonly redirectUri: string\n}\n\nexport interface OAuthConnectorAuthorizationUrlInput {\n  readonly state: string\n  readonly codeChallenge: string\n  readonly codeChallengeMethod: \"S256\"\n}\n\nexport interface OAuthConnectorCodeExchangeInput {\n  readonly code: string\n  readonly codeVerifier: string\n}\n\nexport interface ConnectorConnectionClientContext extends ConnectorContext {\n  readonly connectionId: string\n  readonly account: ConnectorAccountCandidate\n  readonly tokenSource: ConnectorTokenSource\n}\n\n/** One delivered token, bound to the credential revision that produced it. */\nexport interface ConnectorAccessToken {\n  readonly accessToken: string\n  readonly tokenType?: string\n  /** Report this exact token as rejected so Sixb can refresh only its credential revision. */\n  invalidate(): void\n}\n\n/** Live credential source owned by Sixb. Adapters must resolve a token for each request. */\nexport interface ConnectorTokenSource {\n  get(): Promise<ConnectorAccessToken>\n}\n\n/**\n * OAuth-backed connector adapter. Sixb owns persistence, OAuth state, refresh coordination and UI;\n * the adapter owns provider protocol details and typed client creation.\n */\nexport interface ConnectorOAuth2Authentication {\n  readonly type: \"oauth2\"\n  authorizationUrl(\n    context: OAuthConnectorAuthorizationContext,\n    input: OAuthConnectorAuthorizationUrlInput\n  ): Promise<string | URL> | string | URL\n  exchangeCode(\n    context: OAuthConnectorAuthorizationContext,\n    input: OAuthConnectorCodeExchangeInput\n  ): Promise<ConnectorOAuthCredentials> | ConnectorOAuthCredentials\n  refresh(\n    context: ConnectorContext,\n    credentials: ConnectorOAuthCredentials\n  ): Promise<ConnectorOAuthCredentials> | ConnectorOAuthCredentials\n  /**\n   * Revokes the grant idempotently. An already revoked or invalid grant must resolve successfully\n   * so Sixb can converge after losing an earlier provider response.\n   */\n  revoke?(context: ConnectorContext, credentials: ConnectorOAuthCredentials): Promise<void> | void\n}\n\nexport interface OAuthConnectorAdapter<TType extends string = string, TClient = unknown> {\n  readonly type: TType\n  readonly authentication: ConnectorOAuth2Authentication\n  readonly webhooks?: undefined\n  discoverAccounts(\n    context: ConnectorContext,\n    credentials: ConnectorOAuthCredentials\n  ): Promise<readonly ConnectorAccountCandidate[]> | readonly ConnectorAccountCandidate[]\n  connect(context: ConnectorConnectionClientContext): Promise<TClient> | TClient\n}\n\nexport type AnyConnectorAdapter = ConnectorAdapter | OAuthConnectorAdapter\n\n/**\n * Inert connector definition registered with Sixb.\n *\n * Definitions are safe to export from `connectors/` modules. The runtime turns them into\n * live clients when `sixb.connector(...)` is called.\n */\nexport interface ConnectorDefinition<\n  TId extends string = string,\n  TAdapter extends AnyConnectorAdapter = AnyConnectorAdapter,\n> {\n  readonly kind: \"connector\"\n  readonly id: TId\n  readonly adapter: TAdapter\n}\n\nexport type StaticConnectorDefinition = ConnectorDefinition<string, ConnectorAdapter>\n\n/** Infer the connected client type returned by a connector adapter. */\nexport type ConnectorClient<TAdapter extends AnyConnectorAdapter> = Awaited<\n  ReturnType<TAdapter[\"connect\"]>\n>\n\nexport function isOAuthConnectorAdapter(\n  value: AnyConnectorAdapter\n): value is OAuthConnectorAdapter {\n  return \"authentication\" in value && value.authentication?.type === \"oauth2\"\n}\n\nexport function isOAuthConnectorDefinition(\n  value: ConnectorDefinition\n): value is ConnectorDefinition<string, OAuthConnectorAdapter> {\n  return isOAuthConnectorAdapter(value.adapter)\n}\n\nexport function isStaticConnectorDefinition(\n  value: ConnectorDefinition\n): value is StaticConnectorDefinition {\n  return !isOAuthConnectorDefinition(value)\n}\n\nexport function isConnectorDefinition(value: unknown): value is ConnectorDefinition {\n  if (!isRecord(value)) {\n    return false\n  }\n\n  const adapter = value.adapter\n  if (\n    value.kind === \"connector\" &&\n    typeof value.id === \"string\" &&\n    isRecord(adapter) &&\n    typeof adapter.type === \"string\" &&\n    typeof adapter.connect === \"function\"\n  ) {\n    if (adapter.authentication === undefined) return true\n    const authentication = adapter.authentication\n    if (!isRecord(authentication) || authentication.type !== \"oauth2\") return false\n    return (\n      typeof authentication.authorizationUrl === \"function\" &&\n      typeof authentication.exchangeCode === \"function\" &&\n      typeof authentication.refresh === \"function\" &&\n      typeof adapter.discoverAccounts === \"function\"\n    )\n  }\n\n  return false\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n}\n"
-  ],
-  "mappings": ";;AAqKO,SAAS,uBAAuB,CACrC,OACgC;AAAA,EAChC,OAAO,oBAAoB,SAAS,MAAM,gBAAgB,SAAS;AAAA;AAG9D,SAAS,2BAA0B,CACxC,OAC6D;AAAA,EAC7D,OAAO,wBAAwB,MAAM,OAAO;AAAA;AAGvC,SAAS,2BAA2B,CACzC,OACoC;AAAA,EACpC,OAAO,CAAC,4BAA2B,KAAK;AAAA;AAGnC,SAAS,qBAAqB,CAAC,OAA8C;AAAA,EAClF,IAAI,CAAC,SAAS,KAAK,GAAG;AAAA,IACpB,OAAO;AAAA,EACT;AAAA,EAEA,MAAM,UAAU,MAAM;AAAA,EACtB,IACE,MAAM,SAAS,eACf,OAAO,MAAM,OAAO,YACpB,SAAS,OAAO,KAChB,OAAO,QAAQ,SAAS,YACxB,OAAO,QAAQ,YAAY,YAC3B;AAAA,IACA,IAAI,QAAQ,mBAAmB;AAAA,MAAW,OAAO;AAAA,IACjD,MAAM,iBAAiB,QAAQ;AAAA,IAC/B,IAAI,CAAC,SAAS,cAAc,KAAK,eAAe,SAAS;AAAA,MAAU,OAAO;AAAA,IAC1E,OACE,OAAO,eAAe,qBAAqB,cAC3C,OAAO,eAAe,iBAAiB,cACvC,OAAO,eAAe,YAAY,cAClC,OAAO,QAAQ,qBAAqB;AAAA,EAExC;AAAA,EAEA,OAAO;AAAA;AAGT,SAAS,QAAQ,CAAC,OAAkD;AAAA,EAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAAA;",
-  "debugId": "30BD1F10D764311164756E2164756E21",
-  "names": []
-}

package/dist/chunk-3frsnm7x.js.map

@@ -1,11 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/projections/types.ts", "../src/storage/projection-runs/types.ts"],
-  "sourcesContent": [
-    "import type { SixbErrorCode } from \"../errors/types\"\n\n/** Error codes a projection run can persist and expose through its public contract. */\nexport const PROJECTION_RUN_FAILURE_CODES = [\n  \"internal.unexpected\",\n  \"runtime.cancelled\",\n  \"queue.enqueue_failed\",\n  \"projection.execution_failed\",\n] as const satisfies readonly [SixbErrorCode, ...SixbErrorCode[]]\n\nexport type ProjectionRunFailureCode = (typeof PROJECTION_RUN_FAILURE_CODES)[number]\n\n/**\n * Lowered, serializable definition interfaces for projection DSL.\n *\n * These are the runtime-inspectable data structures that projection builders\n * lower into. They use plain string ids (no tokens, no methods) so they can\n * be stored, serialized, and introspected by tooling.\n */\n\n/**\n * Describes how a foreign key column in a dataset resolves to a link target.\n *\n * The source can be either a projected source property or a raw dataset field.\n * Its value equals the target object's primary property value, creating an\n * implicit link between source and target.\n *\n * `targetObjectTypeId` declares the concrete target type for this projection.\n * It must be the same type or a subtype (via `extends`) of the link's declared\n * target at the ontology level. Validation of the subtype relationship happens\n * at Sixb startup (Increment 7), not at DSL build time.\n */\nexport interface ForeignKeyDescriptor {\n  readonly linkId: string\n  /** Object property holding the target id. Mutually exclusive with sourceField. */\n  readonly sourcePropertyId?: string\n  /** Dataset column holding the target id. Mutually exclusive with sourcePropertyId. */\n  readonly sourceField?: string\n  readonly targetObjectTypeId: string\n}\n\n/** Resolves competing source-projection and managed-edit values for projected properties. */\nexport type SourceEditConflictResolution =\n  | { readonly strategy: \"editsWin\" }\n  | { readonly strategy: \"mostRecent\"; readonly sourceTimestamp: string }\n\n/**\n * Lowered, serializable definition for projecting a dataset into object instances.\n *\n * Each row contributes one complete object root to an authoritative replacement snapshot, with\n * properties mapped from dataset columns to object type properties. Duplicate roots are rejected.\n * FK links are resolved from source property or dataset field values to target object primary\n * values.\n */\nexport interface ObjectProjectionDefinition {\n  readonly _tag: \"ObjectProjectionDefinition\"\n  readonly id: string\n  readonly objectTypeId: string\n  readonly datasetId: string\n  /** Maps object type property id -> dataset column name. */\n  readonly properties: Readonly<Record<string, string>>\n  /** Maps link id -> FK descriptor. Empty `{}` when no FK links are projected. */\n  readonly links: Readonly<Record<string, ForeignKeyDescriptor>>\n  /** Defaults to `editsWin` when omitted by a legacy lowered definition. */\n  readonly conflictResolution?: SourceEditConflictResolution\n}\n\n/**\n * Lowered, serializable definition for projecting a join dataset into link instances.\n *\n * Each row in the join dataset contributes one complete link root to an authoritative replacement\n * snapshot, identified by its source, link id, and target. Duplicate roots are rejected.\n */\nexport interface LinkProjectionDefinition {\n  readonly _tag: \"LinkProjectionDefinition\"\n  readonly id: string\n  readonly linkId: string\n  readonly sourceObjectTypeId: string\n  readonly targetObjectTypeId: string\n  readonly datasetId: string\n  /** Dataset column holding the source object's primary property value. */\n  readonly sourceField: string\n  /** Dataset column holding the target object's primary property value. */\n  readonly targetField: string\n}\n\n/** Dataset columns that produce one telemetry property value. */\nexport interface TelemetryProjectionPropertyMapping {\n  /** Dataset column holding the telemetry value. */\n  readonly valueField: string\n  /** Dataset column holding the telemetry unit, when the property requires one. */\n  readonly unitField?: string\n}\n\n/**\n * Lowered, serializable definition for projecting dataset rows into telemetry history.\n *\n * Each row shares one target object id and observation timestamp, then contributes up to one\n * telemetry point for every mapped property. A property-token projection is lowered to the same\n * shape with one entry, so execution and ownership have one canonical contract.\n */\nexport interface TelemetryProjectionDefinition {\n  readonly _tag: \"TelemetryProjectionDefinition\"\n  readonly id: string\n  readonly objectTypeId: string\n  readonly datasetId: string\n  /** Dataset column holding the target object's primary id. */\n  readonly objectIdField: string\n  /** Dataset column holding the telemetry observation timestamp. */\n  readonly atField: string\n  /** Maps telemetry property id -> value and optional unit dataset columns. */\n  readonly properties: Readonly<Record<string, TelemetryProjectionPropertyMapping>>\n}\n\n/** Union of all projection definition types. */\nexport type ProjectionDefinition =\n  | ObjectProjectionDefinition\n  | LinkProjectionDefinition\n  | TelemetryProjectionDefinition\n\nexport interface ProjectionOwnership {\n  readonly objects: readonly {\n    readonly objectTypeId: string\n    readonly existence: boolean\n    readonly propertyIds: readonly string[]\n  }[]\n  readonly links: readonly {\n    readonly sourceObjectTypeId: string\n    readonly linkId: string\n  }[]\n  readonly telemetry: readonly {\n    readonly objectTypeId: string\n    readonly propertyId: string\n  }[]\n}\n\n/** Canonical correlation between a projection kind and its materialization protocol. */\nexport type ProjectionProtocolIdentity =\n  | { readonly projectionKind: \"object\"; readonly protocol: \"replacement\" }\n  | { readonly projectionKind: \"link\"; readonly protocol: \"replacement\" }\n  | { readonly projectionKind: \"telemetry\"; readonly protocol: \"telemetry\" }\n\nexport type ProjectionKind = ProjectionProtocolIdentity[\"projectionKind\"]\n\nexport interface ObjectProjectionTarget {\n  readonly objectTypeId: string\n}\n\nexport interface LinkProjectionTarget {\n  readonly sourceObjectTypeId: string\n  readonly targetObjectTypeId: string\n}\n\nexport interface ProjectionTargetByKind {\n  readonly object: ObjectProjectionTarget\n  readonly link: LinkProjectionTarget\n  readonly telemetry: ObjectProjectionTarget\n}\n\n/** Object types affected by one projection, correlated with its projection kind. */\nexport type ProjectionTarget<TKind extends ProjectionKind = ProjectionKind> =\n  ProjectionTargetByKind[TKind]\n\n/**\n * Frozen semantic identity used to dispatch one registered projection.\n *\n * Dataset version metadata is attached only when a committed dataset event is routed. Keeping the\n * registry-owned fields together prevents the orchestrator from recomputing ontology semantics.\n */\nexport type ProjectionDispatchDescriptor = ProjectionDispatchDescriptorBase &\n  ProjectionProtocolIdentity\n\ninterface ProjectionDispatchDescriptorBase {\n  readonly projectionId: string\n  readonly datasetId: string\n  readonly ontologyRevision: string\n  readonly projectionRevision: string\n  readonly ownershipHash: string\n}\n\nexport interface ResolvedProjection<TDefinition extends ProjectionDefinition> {\n  readonly projectionId: string\n  readonly datasetId: string\n  readonly projectionRevision: string\n  readonly ownershipHash: string\n  readonly ownership: ProjectionOwnership\n  readonly definition: TDefinition\n}\n",
-    "import type { SixbFailure } from \"../../errors/types\"\nimport type {\n  PinnedDatasetVersion,\n  ProjectionExecution,\n  ProjectionMaterializationIdentity,\n  ProjectionRunTerminalDecision,\n} from \"../../materialization/model\"\nimport type {\n  LinkProjectionTarget,\n  ObjectProjectionTarget,\n  ProjectionKind,\n  ProjectionRunFailureCode,\n  ProjectionTarget,\n} from \"../../projections/types\"\n\nexport type { ProjectionRunFailureCode } from \"../../projections/types\"\nexport { PROJECTION_RUN_FAILURE_CODES } from \"../../projections/types\"\n\nexport type ProjectionRunStatus = \"queued\" | \"running\" | \"succeeded\" | \"failed\" | \"cancelled\"\n\nexport interface ProjectionRunProgress {\n  /** Physical immutable-version rows consumed, before normalization or semantic materialization. */\n  readonly sourceRowsRead: number\n  /** Physical rows intentionally skipped because a required mapped value was blank. */\n  readonly sourceRowsSkipped: number\n}\n\nconst progressKeyFlags: Record<keyof ProjectionRunProgress, true> = {\n  sourceRowsRead: true,\n  sourceRowsSkipped: true,\n}\n\nexport const PROJECTION_RUN_PROGRESS_KEYS = Object.keys(\n  progressKeyFlags\n) as readonly (keyof ProjectionRunProgress)[]\n\nexport function zeroProjectionRunProgress(): ProjectionRunProgress {\n  const progress = {} as Record<keyof ProjectionRunProgress, number>\n  for (const key of PROJECTION_RUN_PROGRESS_KEYS) progress[key] = 0\n  return progress\n}\n\nexport interface ProjectionTelemetryCheckpoint {\n  readonly fixedBatchSize: number\n  readonly nextBatchOrdinal: number\n  readonly nextRowOffset: number\n  readonly inputExhausted: boolean\n}\n\n/**\n * The object a telemetry batch is waiting for, and when this run first found it missing.\n *\n * A projection's dataset can legitimately be materialized before the objects it references, so\n * the run waits instead of failing. The wait needs a start, and the run has no other durable one:\n * `startedAt` is when the run began, which on a batched projection is long before the batch that\n * cannot commit, and `attempt` counts every reclaim including the ones an unreachable queue caused.\n *\n * Cleared by any committed batch, so a run that is making progress never carries a stale wait.\n */\nexport interface ProjectionMissingTarget {\n  readonly objectTypeId: string\n  readonly objectId: string\n  /** The batch that could not commit because of it. */\n  readonly batchOrdinal: number\n  readonly firstSeenAt: Date\n}\n\ninterface ProjectionRunRecordBase {\n  readonly id: string\n  readonly projectId: string\n  readonly executionId: string\n  readonly status: ProjectionRunStatus\n  readonly attempt: number\n  readonly progress: ProjectionRunProgress\n  readonly queuedAt: Date\n  readonly startedAt?: Date\n  readonly finishedAt?: Date\n  readonly error?: SixbFailure<ProjectionRunFailureCode>\n}\n\ntype ProjectionIdentity<TKind extends ProjectionKind> = Extract<\n  ProjectionMaterializationIdentity,\n  { readonly projectionKind: TKind }\n>\n\nexport type ObjectProjectionRunRecord = ProjectionRunRecordBase & {\n  readonly identity: ProjectionIdentity<\"object\">\n  readonly target: ObjectProjectionTarget\n  readonly telemetryCheckpoint?: never\n  readonly missingTarget?: never\n}\n\nexport type LinkProjectionRunRecord = ProjectionRunRecordBase & {\n  readonly identity: ProjectionIdentity<\"link\">\n  readonly target: LinkProjectionTarget\n  readonly telemetryCheckpoint?: never\n  readonly missingTarget?: never\n}\n\nexport type TelemetryProjectionRunRecord = ProjectionRunRecordBase & {\n  readonly identity: ProjectionIdentity<\"telemetry\">\n  readonly target: ObjectProjectionTarget\n  readonly telemetryCheckpoint: ProjectionTelemetryCheckpoint\n  /**\n   * Only telemetry carries this: `MaterializationObjectNotFoundError` is raised by telemetry\n   * validation alone, and only a batched protocol has a checkpoint to anchor the wait to.\n   */\n  readonly missingTarget?: ProjectionMissingTarget\n}\n\n/** Durable projection lifecycle state. The execution token is deliberately returned separately. */\nexport type ProjectionRunRecord =\n  | ObjectProjectionRunRecord\n  | LinkProjectionRunRecord\n  | TelemetryProjectionRunRecord\n\nexport function projectionRunObjectTypesVisible(\n  run: ProjectionRunRecord,\n  canView: (objectTypeId: string) => boolean\n): boolean {\n  const target: ProjectionTarget = run.target\n  if (\"sourceObjectTypeId\" in target) {\n    return canView(target.sourceObjectTypeId) && canView(target.targetObjectTypeId)\n  }\n  return canView(target.objectTypeId)\n}\n\ninterface ProjectionRunAdmissionBase {\n  readonly id: string\n  readonly projectId: string\n  readonly executionId: string\n  readonly queuedAt?: Date\n}\n\nexport type QueueProjectionRunInput =\n  | (ProjectionRunAdmissionBase & {\n      readonly identity: ProjectionIdentity<\"object\">\n      readonly target: ObjectProjectionRunRecord[\"target\"]\n      readonly fixedBatchSize?: never\n    })\n  | (ProjectionRunAdmissionBase & {\n      readonly identity: ProjectionIdentity<\"link\">\n      readonly target: LinkProjectionRunRecord[\"target\"]\n      readonly fixedBatchSize?: never\n    })\n  | (ProjectionRunAdmissionBase & {\n      readonly identity: ProjectionIdentity<\"telemetry\">\n      readonly target: TelemetryProjectionRunRecord[\"target\"]\n      readonly fixedBatchSize: number\n    })\n\nexport type StartOrReclaimProjectionRunInput = QueueProjectionRunInput extends infer TInput\n  ? TInput extends QueueProjectionRunInput\n    ? Omit<TInput, \"executionId\" | \"queuedAt\"> & { readonly startedAt?: Date }\n    : never\n  : never\n\nexport interface FailProjectionRunEnqueueInput {\n  readonly id: string\n  readonly projectId: string\n  readonly finishedAt?: Date\n  readonly error: SixbFailure<ProjectionRunFailureCode>\n}\n\nexport interface ProjectionRunClaim {\n  readonly run: ProjectionRunRecord\n  readonly execution: ProjectionExecution\n}\n\nexport interface LockProjectionRunForMaterializationInput {\n  readonly id: string\n  readonly projectId: string\n  readonly executionToken: string\n  readonly identity: ProjectionMaterializationIdentity\n}\n\nexport interface UpdateProjectionRunInput extends LockProjectionRunForMaterializationInput {\n  readonly progress: Partial<ProjectionRunProgress>\n}\n\nexport type FinishProjectionRunInput = ProjectionRunTerminalDecision &\n  LockProjectionRunForMaterializationInput & {\n    readonly finishedAt?: Date\n    readonly progress?: Partial<ProjectionRunProgress>\n  }\n\nexport interface AdvanceProjectionTelemetryCheckpointInput\n  extends LockProjectionRunForMaterializationInput {\n  /** Must equal the run's current nextBatchOrdinal. */\n  readonly batchOrdinal: number\n  /** Physical dataset rows consumed by this batch, including skipped rows. */\n  readonly batchRowCount: number\n  /** Physical rows intentionally skipped inside this batch. */\n  readonly batchRowsSkipped: number\n  /** True when this batch consumed the final row of the immutable dataset version. */\n  readonly inputExhausted: boolean\n}\n\nexport interface RecordProjectionMissingTargetInput\n  extends LockProjectionRunForMaterializationInput {\n  readonly missingTarget: ProjectionMissingTarget\n}\n\nexport interface ListProjectionRunsInput {\n  readonly projectId: string\n  readonly projectionId?: string\n  readonly projectionKind?: ProjectionKind\n  readonly datasetId?: string\n  readonly datasetVersionId?: string\n  /**\n   * Viewable object type ids. A run is included only if every target type is present. Omit for an\n   * unrestricted internal execution; an empty set matches no runs.\n   */\n  readonly objectTypeIds?: readonly string[]\n  readonly statuses?: readonly ProjectionRunStatus[]\n  readonly startedAfter?: Date\n  readonly startedBefore?: Date\n  readonly limit?: number\n  readonly offset?: number\n  readonly order?: \"asc\" | \"desc\"\n}\n\nexport interface ListProjectionRunsResult {\n  readonly runs: readonly ProjectionRunRecord[]\n  readonly hasMore: boolean\n  readonly total: number\n}\n\nexport interface ListLatestProjectionRunsInput {\n  readonly projectId: string\n  readonly projectionIds: readonly string[]\n}\n\nexport interface ListLatestProjectionRunsResult {\n  readonly runs: readonly ProjectionRunRecord[]\n}\n\nexport interface ProjectionRunStorage {\n  queue(input: QueueProjectionRunInput): Promise<ProjectionRunRecord>\n  startOrReclaim(input: StartOrReclaimProjectionRunInput): Promise<ProjectionRunClaim>\n  failEnqueue(input: FailProjectionRunEnqueueInput): Promise<ProjectionRunRecord>\n  /** Transactionally fences the current execution before ontology materialization writes. */\n  lockForMaterialization(\n    input: LockProjectionRunForMaterializationInput\n  ): Promise<ProjectionRunRecord>\n  /** Updates physical source progress only. */\n  update(input: UpdateProjectionRunInput): Promise<ProjectionRunRecord>\n  /**\n   * Advances telemetry progress atomically with the corresponding ontology commit.\n   *\n   * Clears any recorded missing target: a batch that commits is a batch that was not waiting.\n   */\n  advanceTelemetryCheckpoint(\n    input: AdvanceProjectionTelemetryCheckpointInput\n  ): Promise<TelemetryProjectionRunRecord>\n  /** Records the object a telemetry batch is waiting for, so the wait has a durable start. */\n  recordMissingTarget(\n    input: RecordProjectionMissingTargetInput\n  ): Promise<TelemetryProjectionRunRecord>\n  /** Telemetry success also records the worker's EOF observation atomically. */\n  finish(input: FinishProjectionRunInput): Promise<ProjectionRunRecord>\n  getById(params: { projectId: string; id: string }): Promise<ProjectionRunRecord | null>\n  list(input: ListProjectionRunsInput): Promise<ListProjectionRunsResult>\n  listLatestByProjectionIds(\n    input: ListLatestProjectionRunsInput\n  ): Promise<ListLatestProjectionRunsResult>\n}\n\nexport type {\n  LinkProjectionTarget,\n  ObjectProjectionTarget,\n  PinnedDatasetVersion,\n  ProjectionExecution,\n  ProjectionKind,\n  ProjectionMaterializationIdentity,\n  ProjectionTarget,\n}\n"
-  ],
-  "mappings": ";;AAGO,IAAM,gCAA+B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;;;ACmBA,IAAM,mBAA8D;AAAA,EAClE,gBAAgB;AAAA,EAChB,mBAAmB;AACrB;AAEO,IAAM,gCAA+B,OAAO,KACjD,gBACF;AAEO,SAAS,0BAAyB,GAA0B;AAAA,EACjE,MAAM,WAAW,CAAC;AAAA,EAClB,WAAW,OAAO;AAAA,IAA8B,SAAS,OAAO;AAAA,EAChE,OAAO;AAAA;AA6EF,SAAS,gCAA+B,CAC7C,KACA,SACS;AAAA,EACT,MAAM,SAA2B,IAAI;AAAA,EACrC,IAAI,wBAAwB,QAAQ;AAAA,IAClC,OAAO,QAAQ,OAAO,kBAAkB,KAAK,QAAQ,OAAO,kBAAkB;AAAA,EAChF;AAAA,EACA,OAAO,QAAQ,OAAO,YAAY;AAAA;",
-  "debugId": "6C744C0A44910E5264756E2164756E21",
-  "names": []
-}