@sixb/core 0.1.8 → 0.1.10

package/dist/{chunk-w9tg6yyb.js → chunk-b0ec55a1.js}

@@ -1,35 +1,35 @@
 // @bun
 import {
-  createPrimitiveExecutionRecord,
-  ensureExecutionRecord,
-  executionRecordInputFromRuntime
-} from "./chunk-k522z7v6.js";
+  createSixbError2,
+  toSixbFailure2
+} from "./chunk-f4w3yp4f.js";
 import {
-  PIPELINE_RUN_FAILURE_CODES
-} from "./chunk-sbzzr4kx.js";
+  reportRunFailure2
+} from "./chunk-7apz6hg4.js";
 import {
-  PipelineRunError
-} from "./chunk-4jjp5k14.js";
+  resolveExecutionScopeAuthorization,
+  assertAuthorized2
+} from "./chunk-dz5h08xv.js";
 import {
-  reportRunFailure
-} from "./chunk-jq43kdvk.js";
+  PIPELINE_RUN_FAILURE_CODES2
+} from "./chunk-p6a4npdx.js";
 import {
-  assertAuthorized,
-  resolveExecutionScopeAuthorization
-} from "./chunk-p1x242ad.js";
+  PipelineRunError2
+} from "./chunk-mmagke4x.js";
 import {
-  createSixbError,
-  toSixbFailure
-} from "./chunk-2xns679x.js";
+  executionRecordInputFromRuntime,
+  ensureExecutionRecord2,
+  createPrimitiveExecutionRecord
+} from "./chunk-17kfctj6.js";
 
 // src/pipelines/errors.ts
-class PipelineError extends Error {
+class PipelineError2 extends Error {
   name = "PipelineError";
 }
 
 // src/pipelines/run-dispatch.ts
 import { randomUUID } from "crypto";
-class PipelineRunDispatcher {
+class PipelineRunDispatcher2 {
   dependencies;
   constructor(dependencies) {
     this.dependencies = dependencies;
@@ -38,7 +38,7 @@ class PipelineRunDispatcher {
     assertAutomaticDispatchInput(input);
     const pipeline = this.dependencies.definitions.pipelines.getById(input.pipelineId);
     if (!pipeline)
-      throw new PipelineError(`[Sixb] Unknown pipeline '${input.pipelineId}'`);
+      throw new PipelineError2(`[Sixb] Unknown pipeline '${input.pipelineId}'`);
     return dispatchPipelineRun({
       errorReporterHost: this.dependencies,
       projectId: this.dependencies.id,
@@ -63,7 +63,10 @@ class PipelineRunDispatcher {
 }
 async function dispatchPipelineRun(input) {
   const runId = createPipelineRunId(input.runId);
-  const persisted = await persistPipelineRun(input, runId);
+  let persisted = await persistPipelineRun(input, runId);
+  if (!persisted.publish && input.validateExistingRun && persisted.run.status === "queued") {
+    persisted = await reusePipelineRun(input, persisted.run);
+  }
   if (!persisted.publish)
     return existingPipelineRunResult(persisted.run);
   return publishPipelineRun(input, persisted);
@@ -95,7 +98,7 @@ async function persistPipelineRun(input, runId) {
       return { publish: true, run, execution, queuedAt, created: true };
     }, { isolation: "serializable" });
   } catch (error) {
-    if (!(error instanceof PipelineRunError))
+    if (!(error instanceof PipelineRunError2))
       throw error;
     const raced = await pipelineRuns.getById({ projectId: input.projectId, id: runId });
     if (!raced)
@@ -108,6 +111,15 @@ async function persistPipelineRun(input, runId) {
 async function reusePipelineRun(input, existing) {
   assertExistingRunMatchesRequest(existing, input);
   await input.validateExistingRun?.(existing, input.storage);
+  if (input.validateExistingRun && existing.status === "queued") {
+    const execution = await input.storage.executions.getById({
+      projectId: input.projectId,
+      id: existing.executionId
+    });
+    if (!execution)
+      throw new PipelineRunError2(`[Sixb] Execution '${existing.executionId}' was not found.`);
+    return { publish: true, run: existing, execution, queuedAt: existing.queuedAt, created: false };
+  }
   if (existing.status !== "failed" || existing.error?.code !== "queue.enqueue_failed" || !existing.error.retryable) {
     return { publish: false, run: existing };
   }
@@ -116,7 +128,7 @@ async function reusePipelineRun(input, existing) {
     id: existing.executionId
   });
   if (!execution) {
-    throw new PipelineRunError(`[Sixb] Execution '${existing.executionId}' for Pipeline run '${existing.id}' was not found.`);
+    throw new PipelineRunError2(`[Sixb] Execution '${existing.executionId}' for Pipeline run '${existing.id}' was not found.`);
   }
   const queuedAt = new Date;
   const run = await requirePipelineRunStorage(input.storage).queue({
@@ -141,6 +153,9 @@ async function publishPipelineRun(input, persisted) {
         }
       ]
     });
+    if (!job || job.id !== persisted.run.id) {
+      throw new PipelineRunError2(`[Sixb] Queue did not acknowledge Pipeline run '${persisted.run.id}'.`);
+    }
     return {
       pipelineId: persisted.run.pipelineId,
       runId: persisted.run.id,
@@ -149,6 +164,8 @@ async function publishPipelineRun(input, persisted) {
       created: persisted.created
     };
   } catch (error) {
+    if (input.validateExistingRun)
+      throw error;
     const failedAt = new Date;
     const failure = toEnqueueFailure(error, persisted.run, failedAt);
     const failed = await requirePipelineRunStorage(input.storage).finish({
@@ -158,7 +175,7 @@ async function publishPipelineRun(input, persisted) {
       finishedAt: failedAt,
       error: failure
     });
-    reportRunFailure(input.errorReporterHost, error, {
+    reportRunFailure2(input.errorReporterHost, error, {
       projectId: input.projectId,
       runKind: "pipeline",
       run: { runId: failed.id, pipelineId: failed.pipelineId },
@@ -169,7 +186,7 @@ async function publishPipelineRun(input, persisted) {
 }
 function assertExistingRunMatchesRequest(existing, input) {
   if (existing.pipelineId !== input.pipeline.id) {
-    throw new PipelineRunError(`[Sixb] Pipeline run '${existing.id}' already exists with a different request payload.`);
+    throw new PipelineRunError2(`[Sixb] Pipeline run '${existing.id}' already exists with a different request payload.`);
   }
 }
 function existingPipelineRunResult(existing) {
@@ -182,7 +199,7 @@ function existingPipelineRunResult(existing) {
 }
 function requirePipelineRunStorage(storage) {
   if (!storage.pipelineRuns) {
-    throw new PipelineError("[Sixb] Pipeline run storage is not configured.");
+    throw new PipelineError2("[Sixb] Pipeline run storage is not configured.");
   }
   return storage.pipelineRuns;
 }
@@ -190,7 +207,7 @@ function createPipelineRunId(runId) {
   if (runId === undefined)
     return `run_${randomUUID()}`;
   if (!runId.trim())
-    throw new PipelineError("[Sixb] Pipeline run id must not be empty");
+    throw new PipelineError2("[Sixb] Pipeline run id must not be empty");
   return runId;
 }
 function assertAutomaticDispatchInput(input) {
@@ -202,34 +219,34 @@ function assertAutomaticDispatchInput(input) {
 async function assertAutomaticExecutionIdentity(storage, projectId, input, run) {
   const execution = await storage.executions.getById({ projectId, id: run.executionId });
   if (!execution || execution.source.type !== input.source.type || execution.source.eventId !== input.source.eventId || execution.correlationId !== input.correlationId || execution.requestedBy !== undefined) {
-    throw new PipelineError(`[Sixb] Pipeline run '${run.id}' already exists with different automatic provenance.`);
+    throw new PipelineError2(`[Sixb] Pipeline run '${run.id}' already exists with different automatic provenance.`);
   }
 }
 function toEnqueueFailure(error, run, at) {
-  const enqueueError = createSixbError("queue.enqueue_failed", `[Sixb] Could not enqueue Pipeline run '${run.id}'.`, {
+  const enqueueError = createSixbError2("queue.enqueue_failed", `[Sixb] Could not enqueue Pipeline run '${run.id}'.`, {
     cause: error,
     details: { pipelineId: run.pipelineId, runId: run.id, phase: "enqueue" }
   });
-  return toSixbFailure(enqueueError, { allowedCodes: PIPELINE_RUN_FAILURE_CODES, at });
+  return toSixbFailure2(enqueueError, { allowedCodes: PIPELINE_RUN_FAILURE_CODES2, at });
 }
 function assertNonBlank(value, label) {
   if (!value.trim())
-    throw new PipelineError(`[Sixb] ${label} must not be empty.`);
+    throw new PipelineError2(`[Sixb] ${label} must not be empty.`);
 }
 
 // src/pipelines/request.ts
-async function requestPipelineRun(runtime, execution, pipeline, options = {}) {
+async function requestPipelineRun2(runtime, execution, pipeline, options = {}) {
   resolveExecutionScopeAuthorization(runtime.projectId, {
     execution,
     authorization: runtime.runtimeAuthorization
   });
-  assertAuthorized(runtime, { kind: "pipeline.run", pipelineId: pipeline.id });
+  assertAuthorized2(runtime, { kind: "pipeline.run", pipelineId: pipeline.id });
   if (!runtime.storage.pipelineRuns) {
-    throw new PipelineError("[Sixb] Pipeline run storage is not configured.");
+    throw new PipelineError2("[Sixb] Pipeline run storage is not configured.");
   }
   const queue = runtime.queues.pipelines;
   if (!queue) {
-    throw new PipelineError("[Sixb] Pipeline run queue is not configured.");
+    throw new PipelineError2("[Sixb] Pipeline run queue is not configured.");
   }
   return dispatchPipelineRun({
     errorReporterHost: runtime,
@@ -239,7 +256,7 @@ async function requestPipelineRun(runtime, execution, pipeline, options = {}) {
     queue,
     ...options,
     createExecution: async (executionId, runId) => {
-      const caller = await ensureExecutionRecord(runtime.storage.executions, executionRecordInputFromRuntime({
+      const caller = await ensureExecutionRecord2(runtime.storage.executions, executionRecordInputFromRuntime({
         execution,
         runtimeAuthorization: runtime.runtimeAuthorization
       }));
@@ -252,6 +269,6 @@ async function requestPipelineRun(runtime, execution, pipeline, options = {}) {
   });
 }
 
-export { PipelineError, PipelineRunDispatcher, requestPipelineRun };
+export { PipelineError2, PipelineRunDispatcher2, requestPipelineRun2 };
 
-//# debugId=BDF53A212CD6489564756E2164756E21
+//# debugId=5A812F362A35F07864756E2164756E21

package/dist/chunk-b0ec55a1.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["../src/pipelines/errors.ts", "../src/pipelines/run-dispatch.ts", "../src/pipelines/request.ts"],
+  "sourcesContent": [
+    "export class PipelineError extends Error {\n  readonly name = \"PipelineError\"\n}\n",
+    "import { randomUUID } from \"node:crypto\"\nimport { reportRunFailure } from \"../error-reporting/capability\"\nimport { createSixbError, toSixbFailure } from \"../errors/internal\"\nimport type { SixbFailure } from \"../errors/types\"\nimport type { RunDispatcher } from \"../execution/dispatch\"\nimport { createPrimitiveExecutionRecord } from \"../execution/durable\"\nimport type { Queues } from \"../queues\"\nimport type { SixbDefinitions } from \"../runtime/definitions\"\nimport type {\n  CreateExecutionInput,\n  PipelineRunFailureCode,\n  PipelineRunRecord,\n  Storage,\n} from \"../storage\"\nimport { PIPELINE_RUN_FAILURE_CODES, PipelineRunError } from \"../storage\"\nimport { PipelineError } from \"./errors\"\nimport type { PipelineRunRequestOptions, PipelineRunRequestResult } from \"./request\"\nimport type { PipelineDefinition } from \"./types\"\n\nexport type AutomaticPipelineExecutionSource =\n  | { readonly type: \"schedule\"; readonly eventId: string }\n  | { readonly type: \"event\"; readonly eventId: string }\n\nexport interface AutomaticPipelineRunDispatchInput extends PipelineRunRequestOptions {\n  readonly pipelineId: string\n  readonly runId: string\n  readonly source: AutomaticPipelineExecutionSource\n  readonly correlationId: string\n  readonly metadata?: Readonly<Record<string, string>>\n}\n\nexport type PipelineRunDispatchPort = RunDispatcher<\n  AutomaticPipelineRunDispatchInput,\n  PipelineRunRequestResult\n>\n\nexport interface PipelineRunDispatcherDependencies {\n  readonly id: string\n  readonly definitions: Pick<SixbDefinitions, \"pipelines\">\n  readonly storage: Storage\n  readonly queues: Pick<Queues, \"pipelines\">\n}\n\ninterface DispatchPipelineRunInput extends PipelineRunRequestOptions {\n  readonly errorReporterHost: object\n  readonly projectId: string\n  readonly pipeline: PipelineDefinition\n  readonly storage: Storage\n  readonly queue: Queues[\"pipelines\"]\n  readonly metadata?: Readonly<Record<string, string>>\n  readonly createExecution: (executionId: string, runId: string) => Promise<CreateExecutionInput>\n  readonly validateExistingRun?: (run: PipelineRunRecord, storage: Storage) => Promise<void>\n}\n\ntype PersistedPipelineRun =\n  | { readonly publish: false; readonly run: PipelineRunRecord }\n  | {\n      readonly publish: true\n      readonly run: PipelineRunRecord\n      readonly execution: CreateExecutionInput\n      readonly queuedAt: Date\n      readonly created: boolean\n    }\n\n/** Core-owned durable dispatch boundary used by automatic Pipeline triggers. */\nexport class PipelineRunDispatcher implements PipelineRunDispatchPort {\n  constructor(private readonly dependencies: PipelineRunDispatcherDependencies) {}\n\n  async dispatch(input: AutomaticPipelineRunDispatchInput): Promise<PipelineRunRequestResult> {\n    assertAutomaticDispatchInput(input)\n    const pipeline = this.dependencies.definitions.pipelines.getById(input.pipelineId)\n    if (!pipeline) throw new PipelineError(`[Sixb] Unknown pipeline '${input.pipelineId}'`)\n\n    return dispatchPipelineRun({\n      errorReporterHost: this.dependencies,\n      projectId: this.dependencies.id,\n      pipeline,\n      storage: this.dependencies.storage,\n      queue: this.dependencies.queues.pipelines,\n      runId: input.runId,\n      metadata: input.metadata,\n      validateExistingRun: (run, storage) =>\n        assertAutomaticExecutionIdentity(storage, this.dependencies.id, input, run),\n      createExecution: async (executionId, runId) =>\n        createPrimitiveExecutionRecord({\n          id: executionId,\n          primitive: { kind: \"pipeline\", id: pipeline.id, runId },\n          origin: {\n            type: \"automatic\",\n            projectId: this.dependencies.id,\n            source: input.source,\n            correlationId: input.correlationId,\n          },\n        }),\n    })\n  }\n}\n\n/** Persist a Pipeline execution and queued run before publishing its queue job. */\nexport async function dispatchPipelineRun(\n  input: DispatchPipelineRunInput\n): Promise<PipelineRunRequestResult> {\n  const runId = createPipelineRunId(input.runId)\n  let persisted = await persistPipelineRun(input, runId)\n  if (!persisted.publish && input.validateExistingRun && persisted.run.status === \"queued\") {\n    persisted = await reusePipelineRun(input, persisted.run)\n  }\n  if (!persisted.publish) return existingPipelineRunResult(persisted.run)\n  return publishPipelineRun(input, persisted)\n}\n\nasync function persistPipelineRun(\n  input: DispatchPipelineRunInput,\n  runId: string\n): Promise<PersistedPipelineRun> {\n  const pipelineRuns = requirePipelineRunStorage(input.storage)\n  const existing = await pipelineRuns.getById({ projectId: input.projectId, id: runId })\n  if (existing) return reusePipelineRun(input, existing)\n\n  const execution = await input.createExecution(`exec_${randomUUID()}`, runId)\n  const queuedAt = new Date()\n  try {\n    return await input.storage.transaction(\n      async (tx): Promise<PersistedPipelineRun> => {\n        const transactionalRuns = requirePipelineRunStorage(tx)\n        const raced = await transactionalRuns.getById({ projectId: input.projectId, id: runId })\n        if (raced) {\n          assertExistingRunMatchesRequest(raced, input)\n          await input.validateExistingRun?.(raced, tx)\n          return { publish: false, run: raced }\n        }\n\n        await tx.executions.create(execution)\n        const run = await transactionalRuns.queue({\n          projectId: input.projectId,\n          id: runId,\n          executionId: execution.id,\n          pipelineId: input.pipeline.id,\n          queuedAt,\n        })\n        return { publish: true, run, execution, queuedAt, created: true }\n      },\n      { isolation: \"serializable\" }\n    )\n  } catch (error) {\n    if (!(error instanceof PipelineRunError)) throw error\n    const raced = await pipelineRuns.getById({ projectId: input.projectId, id: runId })\n    if (!raced) throw error\n    assertExistingRunMatchesRequest(raced, input)\n    await input.validateExistingRun?.(raced, input.storage)\n    return { publish: false, run: raced }\n  }\n}\n\nasync function reusePipelineRun(\n  input: DispatchPipelineRunInput,\n  existing: PipelineRunRecord\n): Promise<PersistedPipelineRun> {\n  assertExistingRunMatchesRequest(existing, input)\n  await input.validateExistingRun?.(existing, input.storage)\n  if (input.validateExistingRun && existing.status === \"queued\") {\n    const execution = await input.storage.executions.getById({\n      projectId: input.projectId,\n      id: existing.executionId,\n    })\n    if (!execution)\n      throw new PipelineRunError(`[Sixb] Execution '${existing.executionId}' was not found.`)\n    return { publish: true, run: existing, execution, queuedAt: existing.queuedAt, created: false }\n  }\n  if (\n    existing.status !== \"failed\" ||\n    existing.error?.code !== \"queue.enqueue_failed\" ||\n    !existing.error.retryable\n  ) {\n    return { publish: false, run: existing }\n  }\n\n  const execution = await input.storage.executions.getById({\n    projectId: input.projectId,\n    id: existing.executionId,\n  })\n  if (!execution) {\n    throw new PipelineRunError(\n      `[Sixb] Execution '${existing.executionId}' for Pipeline run '${existing.id}' was not found.`\n    )\n  }\n\n  const queuedAt = new Date()\n  const run = await requirePipelineRunStorage(input.storage).queue({\n    projectId: input.projectId,\n    id: existing.id,\n    executionId: existing.executionId,\n    pipelineId: existing.pipelineId,\n    queuedAt,\n  })\n  return { publish: true, run, execution, queuedAt, created: false }\n}\n\nasync function publishPipelineRun(\n  input: DispatchPipelineRunInput,\n  persisted: Extract<PersistedPipelineRun, { readonly publish: true }>\n): Promise<PipelineRunRequestResult> {\n  try {\n    const [job] = await input.queue.enqueue({\n      projectId: input.projectId,\n      jobs: [\n        {\n          id: persisted.run.id,\n          type: \"pipeline.run.requested\",\n          payload: { runId: persisted.run.id },\n          ...(input.metadata === undefined ? {} : { metadata: input.metadata }),\n        },\n      ],\n    })\n    if (!job || job.id !== persisted.run.id) {\n      throw new PipelineRunError(\n        `[Sixb] Queue did not acknowledge Pipeline run '${persisted.run.id}'.`\n      )\n    }\n    return {\n      pipelineId: persisted.run.pipelineId,\n      runId: persisted.run.id,\n      queuedAt: persisted.queuedAt.toISOString(),\n      ...(job?.id ? { jobId: job.id } : {}),\n      created: persisted.created,\n    }\n  } catch (error) {\n    // Automatic consumers retain the batch and retry. Keep uncertain delivery queued:\n    // a lost reply does not prove that the queue rejected the job.\n    if (input.validateExistingRun) throw error\n    const failedAt = new Date()\n    const failure = toEnqueueFailure(error, persisted.run, failedAt)\n    const failed = await requirePipelineRunStorage(input.storage).finish({\n      projectId: input.projectId,\n      id: persisted.run.id,\n      status: \"failed\",\n      finishedAt: failedAt,\n      error: failure,\n    })\n    reportRunFailure(input.errorReporterHost, error, {\n      projectId: input.projectId,\n      runKind: \"pipeline\",\n      run: { runId: failed.id, pipelineId: failed.pipelineId },\n      failure,\n    })\n    throw error\n  }\n}\n\nfunction assertExistingRunMatchesRequest(\n  existing: PipelineRunRecord,\n  input: Pick<DispatchPipelineRunInput, \"pipeline\">\n): void {\n  if (existing.pipelineId !== input.pipeline.id) {\n    throw new PipelineRunError(\n      `[Sixb] Pipeline run '${existing.id}' already exists with a different request payload.`\n    )\n  }\n}\n\nfunction existingPipelineRunResult(existing: PipelineRunRecord): PipelineRunRequestResult {\n  return {\n    pipelineId: existing.pipelineId,\n    runId: existing.id,\n    queuedAt: existing.queuedAt.toISOString(),\n    created: false,\n  }\n}\n\nfunction requirePipelineRunStorage(storage: Storage): NonNullable<Storage[\"pipelineRuns\"]> {\n  if (!storage.pipelineRuns) {\n    throw new PipelineError(\"[Sixb] Pipeline run storage is not configured.\")\n  }\n  return storage.pipelineRuns\n}\n\nfunction createPipelineRunId(runId: string | undefined): string {\n  if (runId === undefined) return `run_${randomUUID()}`\n  if (!runId.trim()) throw new PipelineError(\"[Sixb] Pipeline run id must not be empty\")\n  return runId\n}\n\nfunction assertAutomaticDispatchInput(input: AutomaticPipelineRunDispatchInput): void {\n  assertNonBlank(input.pipelineId, \"Pipeline id\")\n  assertNonBlank(input.runId, \"Pipeline run id\")\n  assertNonBlank(input.source.eventId, \"Pipeline source event id\")\n  assertNonBlank(input.correlationId, \"Pipeline correlation id\")\n}\n\nasync function assertAutomaticExecutionIdentity(\n  storage: Storage,\n  projectId: string,\n  input: AutomaticPipelineRunDispatchInput,\n  run: PipelineRunRecord\n): Promise<void> {\n  const execution = await storage.executions.getById({ projectId, id: run.executionId })\n  if (\n    !execution ||\n    execution.source.type !== input.source.type ||\n    execution.source.eventId !== input.source.eventId ||\n    execution.correlationId !== input.correlationId ||\n    execution.requestedBy !== undefined\n  ) {\n    throw new PipelineError(\n      `[Sixb] Pipeline run '${run.id}' already exists with different automatic provenance.`\n    )\n  }\n}\n\nfunction toEnqueueFailure(\n  error: unknown,\n  run: PipelineRunRecord,\n  at: Date\n): SixbFailure<PipelineRunFailureCode> {\n  const enqueueError = createSixbError(\n    \"queue.enqueue_failed\",\n    `[Sixb] Could not enqueue Pipeline run '${run.id}'.`,\n    {\n      cause: error,\n      details: { pipelineId: run.pipelineId, runId: run.id, phase: \"enqueue\" },\n    }\n  )\n  return toSixbFailure(enqueueError, { allowedCodes: PIPELINE_RUN_FAILURE_CODES, at })\n}\n\nfunction assertNonBlank(value: string, label: string): void {\n  if (!value.trim()) throw new PipelineError(`[Sixb] ${label} must not be empty.`)\n}\n",
+    "import { assertAuthorized } from \"../authorization\"\nimport { resolveExecutionScopeAuthorization } from \"../execution/authorization\"\nimport {\n  createPrimitiveExecutionRecord,\n  ensureExecutionRecord,\n  executionRecordInputFromRuntime,\n} from \"../execution/durable\"\nimport type { ExecutionContext } from \"../execution/types\"\nimport type { SixbRuntimeContext } from \"../runtime/types\"\nimport { PipelineError } from \"./errors\"\nimport { dispatchPipelineRun } from \"./run-dispatch\"\nimport type { PipelineDefinition } from \"./types\"\n\nexport interface PipelineRunRequestOptions {\n  /** Stable identity used to make dispatch idempotent. */\n  readonly runId?: string\n}\n\nexport interface RequestPipelineRunInput extends PipelineRunRequestOptions {\n  readonly pipelineId: string\n}\n\nexport interface PipelineRunRequestResult {\n  readonly pipelineId: string\n  readonly runId: string\n  /** Durable time at which the run entered the queue. */\n  readonly queuedAt: string\n  readonly jobId?: string\n  readonly created: boolean\n}\n\n/**\n * Authorize and queue a pipeline run request.\n *\n * Operates on an already-resolved definition and the shared runtime context, so the HTTP route and\n * the runtime verb cannot drift apart.\n *\n * The immutable child execution and queued run are persisted before queue publication.\n */\nexport async function requestPipelineRun(\n  runtime: SixbRuntimeContext,\n  execution: ExecutionContext,\n  pipeline: PipelineDefinition,\n  options: PipelineRunRequestOptions = {}\n): Promise<PipelineRunRequestResult> {\n  resolveExecutionScopeAuthorization(runtime.projectId, {\n    execution,\n    authorization: runtime.runtimeAuthorization,\n  })\n  assertAuthorized(runtime, { kind: \"pipeline.run\", pipelineId: pipeline.id })\n  if (!runtime.storage.pipelineRuns) {\n    throw new PipelineError(\"[Sixb] Pipeline run storage is not configured.\")\n  }\n\n  const queue = runtime.queues.pipelines\n  if (!queue) {\n    throw new PipelineError(\"[Sixb] Pipeline run queue is not configured.\")\n  }\n\n  return dispatchPipelineRun({\n    errorReporterHost: runtime,\n    projectId: runtime.projectId,\n    pipeline,\n    storage: runtime.storage,\n    queue,\n    ...options,\n    createExecution: async (executionId, runId) => {\n      const caller = await ensureExecutionRecord(\n        runtime.storage.executions,\n        executionRecordInputFromRuntime({\n          execution,\n          runtimeAuthorization: runtime.runtimeAuthorization,\n        })\n      )\n      return createPrimitiveExecutionRecord({\n        id: executionId,\n        primitive: { kind: \"pipeline\", id: pipeline.id, runId },\n        origin: { type: \"execution\", parent: caller },\n      })\n    },\n  })\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "5A812F362A35F07864756E2164756E21",
+  "names": []
+}

package/dist/{chunk-ka3a2ft3.js → chunk-b19g04jk.js}

@@ -1,13 +1,13 @@
 // @bun
 import {
-  parseSixbFailure
-} from "./chunk-2xns679x.js";
+  parseSixbFailure2
+} from "./chunk-f4w3yp4f.js";
 import {
   isPlainRecord
-} from "./chunk-n6jxh8sw.js";
+} from "./chunk-wy0qdqfm.js";
 
 // src/storage/action-runs/types.ts
-var ACTION_RUN_PHASES = [
+var ACTION_RUN_PHASES2 = [
   "request",
   "enqueue",
   "validation",
@@ -17,7 +17,7 @@ var ACTION_RUN_PHASES = [
   "effects",
   "cancelled"
 ];
-var ACTION_RUN_FAILURE_CODES = [
+var ACTION_RUN_FAILURE_CODES2 = [
   "internal.unexpected",
   "runtime.cancelled",
   "queue.enqueue_failed",
@@ -25,15 +25,15 @@ var ACTION_RUN_FAILURE_CODES = [
 ];
 
 // src/storage/action-runs/failure.ts
-function serializeActionRunFailure(failure, expectedPhase) {
-  const parsed = expectedPhase === undefined ? parseActionRunFailure(failure) : parseActionRunFailure(failure, expectedPhase);
+function serializeActionRunFailure2(failure, expectedPhase) {
+  const parsed = expectedPhase === undefined ? parseActionRunFailure2(failure) : parseActionRunFailure2(failure, expectedPhase);
   return JSON.stringify(parsed);
 }
-function parseActionRunFailure(value, expectedPhase) {
+function parseActionRunFailure2(value, expectedPhase) {
   const candidate = parseStoredActionRunFailureValue(value);
-  const failure = parseSixbFailure(candidate, ACTION_RUN_FAILURE_CODES);
+  const failure = parseSixbFailure2(candidate, ACTION_RUN_FAILURE_CODES2);
   const details = failure.details;
-  if (!isPlainRecord(details) || typeof details.actionId !== "string" || typeof details.runId !== "string" || typeof details.phase !== "string" || !ACTION_RUN_PHASES.includes(details.phase)) {
+  if (!isPlainRecord(details) || typeof details.actionId !== "string" || typeof details.runId !== "string" || typeof details.phase !== "string" || !ACTION_RUN_PHASES2.includes(details.phase)) {
     throw new Error("[Sixb] Stored failure is invalid: Action details must contain actionId, runId, and a known phase.");
   }
   if (expectedPhase !== undefined && details.phase !== expectedPhase) {
@@ -54,6 +54,6 @@ function parseStoredActionRunFailureValue(value) {
   }
 }
 
-export { ACTION_RUN_PHASES, ACTION_RUN_FAILURE_CODES, serializeActionRunFailure, parseActionRunFailure };
+export { ACTION_RUN_PHASES2, ACTION_RUN_FAILURE_CODES2, serializeActionRunFailure2, parseActionRunFailure2 };
 
-//# debugId=C0AEB0A8D7FE678664756E2164756E21
+//# debugId=10E96C378A97739664756E2164756E21

package/dist/{chunk-ka3a2ft3.js.map → chunk-b19g04jk.js.map}

@@ -5,7 +5,7 @@
     "import type { ActionSubject } from \"../../actions\"\nimport type { SixbErrorCode, SixbFailure } from \"../../errors/types\"\nimport type { JsonValue } from \"../../json\"\n\nexport type ActionRunStatus = \"queued\" | \"running\" | \"succeeded\" | \"failed\" | \"cancelled\"\n\nexport const ACTION_RUN_PHASES = [\n  \"request\",\n  \"enqueue\",\n  \"validation\",\n  \"writeback\",\n  \"edits\",\n  \"commit\",\n  \"effects\",\n  \"cancelled\",\n] as const\n\nexport type ActionRunPhase = (typeof ACTION_RUN_PHASES)[number]\n\nexport type ActionRunParams = Readonly<Record<string, JsonValue>>\n\nexport type ActionRunPhaseStatus = \"succeeded\" | \"failed\"\n\n/** Error codes an action run or phase record can persist and expose. */\nexport const ACTION_RUN_FAILURE_CODES = [\n  \"internal.unexpected\",\n  \"runtime.cancelled\",\n  \"queue.enqueue_failed\",\n  \"action.phase_failed\",\n] as const satisfies readonly [SixbErrorCode, ...SixbErrorCode[]]\n\nexport type ActionRunFailureCode = (typeof ACTION_RUN_FAILURE_CODES)[number]\n\nexport interface ActionRunFailureDetails<TPhase extends ActionRunPhase = ActionRunPhase> {\n  readonly actionId: string\n  readonly runId: string\n  readonly phase: TPhase\n}\n\n/** Portable failure record with Action's required correlation details. */\nexport interface ActionRunFailure<TPhase extends ActionRunPhase = ActionRunPhase>\n  extends Omit<SixbFailure<ActionRunFailureCode>, \"details\"> {\n  readonly details: ActionRunFailureDetails<TPhase>\n}\n\nexport type ActionRunWritebackRecord =\n  | {\n      readonly status: \"succeeded\"\n      readonly completedAt: Date\n      readonly result: JsonValue\n      readonly error?: never\n    }\n  | {\n      readonly status: \"failed\"\n      readonly completedAt: Date\n      readonly result?: never\n      readonly error: ActionRunFailure<\"writeback\">\n    }\n\nexport type ActionRunEffectsRecord =\n  | {\n      readonly status: \"succeeded\"\n      readonly completedAt: Date\n      readonly error?: never\n    }\n  | {\n      readonly status: \"failed\"\n      readonly completedAt: Date\n      readonly error: ActionRunFailure<\"effects\">\n    }\n\nexport interface ActionRunRecord {\n  readonly id: string\n  readonly projectId: string\n  readonly executionId: string\n  readonly actionId: string\n  readonly subject: ActionSubject\n  readonly status: ActionRunStatus\n  readonly phase?: ActionRunPhase\n  readonly queuedAt: Date\n  readonly startedAt?: Date\n  readonly finishedAt?: Date\n  readonly params: ActionRunParams\n  readonly idempotencyKey: string\n  readonly writeback?: ActionRunWritebackRecord\n  readonly effects?: ActionRunEffectsRecord\n  readonly error?: ActionRunFailure\n}\n\nexport interface QueueActionRunInput {\n  readonly id: string\n  readonly projectId: string\n  readonly executionId: string\n  readonly actionId: string\n  readonly subject: ActionSubject\n  readonly params: ActionRunParams\n  readonly idempotencyKey: string\n  readonly queuedAt?: Date\n}\n\nexport interface StartActionRunInput {\n  readonly id: string\n  readonly projectId: string\n  readonly startedAt?: Date\n  readonly phase?: Extract<ActionRunPhase, \"validation\">\n}\n\nexport interface EnterActionRunPhaseInput {\n  readonly id: string\n  readonly projectId: string\n  readonly phase: Extract<\n    ActionRunPhase,\n    \"validation\" | \"writeback\" | \"edits\" | \"commit\" | \"effects\"\n  >\n}\n\nexport type RecordActionWritebackInput =\n  | {\n      readonly id: string\n      readonly projectId: string\n      readonly status: \"succeeded\"\n      readonly completedAt?: Date\n      readonly result: JsonValue\n    }\n  | {\n      readonly id: string\n      readonly projectId: string\n      readonly status: \"failed\"\n      readonly completedAt?: Date\n      readonly error: ActionRunFailure<\"writeback\">\n    }\n\nexport type RecordActionEffectsInput =\n  | {\n      readonly id: string\n      readonly projectId: string\n      readonly status: \"succeeded\"\n      readonly completedAt?: Date\n    }\n  | {\n      readonly id: string\n      readonly projectId: string\n      readonly status: \"failed\"\n      readonly completedAt?: Date\n      readonly error: ActionRunFailure<\"effects\">\n    }\n\nexport type FinishActionRunInput =\n  | {\n      readonly id: string\n      readonly projectId: string\n      readonly status: \"succeeded\"\n      readonly finishedAt?: Date\n      readonly phase?: ActionRunPhase\n    }\n  | {\n      readonly id: string\n      readonly projectId: string\n      readonly status: \"failed\" | \"cancelled\"\n      readonly finishedAt?: Date\n      readonly error: ActionRunFailure\n    }\n\nexport interface ListActionRunsInput {\n  readonly projectId: string\n  readonly actionId?: string\n  readonly actionIds?: readonly string[]\n  readonly subject?: ActionSubject\n  readonly objectTypeId?: string\n  readonly objectTypeIds?: readonly string[]\n  readonly primaryId?: string\n  readonly statuses?: readonly ActionRunStatus[]\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 ListActionRunsResult {\n  readonly runs: readonly ActionRunRecord[]\n  readonly hasMore: boolean\n  readonly total: number\n}\n\nexport interface LockActionMaterializationRunInput {\n  readonly projectId: string\n  readonly actionId: string\n  readonly runId: string\n}\n\nexport interface ActionRunStorage {\n  /** Transactional fence for Action identity and running state before a new ontology commit. */\n  lockForMaterialization(input: LockActionMaterializationRunInput): Promise<ActionRunRecord>\n  queue(input: QueueActionRunInput): Promise<ActionRunRecord>\n  start(input: StartActionRunInput): Promise<ActionRunRecord>\n  enterPhase(input: EnterActionRunPhaseInput): Promise<ActionRunRecord>\n  recordWriteback(input: RecordActionWritebackInput): Promise<ActionRunRecord>\n  recordEffects(input: RecordActionEffectsInput): Promise<ActionRunRecord>\n  finish(input: FinishActionRunInput): Promise<ActionRunRecord>\n  getById(params: { projectId: string; id: string }): Promise<ActionRunRecord | null>\n  list(input: ListActionRunsInput): Promise<ListActionRunsResult>\n}\n",
     "import { parseSixbFailure } from \"../../errors/internal\"\nimport { isPlainRecord } from \"../../json\"\nimport {\n  ACTION_RUN_FAILURE_CODES,\n  ACTION_RUN_PHASES,\n  type ActionRunFailure,\n  type ActionRunFailureDetails,\n  type ActionRunPhase,\n} from \"./types\"\n\n/** Serializes the canonical failure plus Action's typed lifecycle extension. */\nexport function serializeActionRunFailure<TPhase extends ActionRunPhase>(\n  failure: ActionRunFailure<TPhase>,\n  expectedPhase?: TPhase\n): string {\n  const parsed =\n    expectedPhase === undefined\n      ? parseActionRunFailure(failure)\n      : parseActionRunFailure(failure, expectedPhase)\n  return JSON.stringify(parsed)\n}\n\n/** Validates and detaches an Action failure read from a storage boundary. */\nexport function parseActionRunFailure<TPhase extends ActionRunPhase>(\n  value: unknown,\n  expectedPhase: TPhase\n): ActionRunFailure<TPhase>\nexport function parseActionRunFailure(value: unknown): ActionRunFailure\nexport function parseActionRunFailure(\n  value: unknown,\n  expectedPhase?: ActionRunPhase\n): ActionRunFailure {\n  const candidate = parseStoredActionRunFailureValue(value)\n  const failure = parseSixbFailure(candidate, ACTION_RUN_FAILURE_CODES)\n  const details = failure.details\n  if (\n    !isPlainRecord(details) ||\n    typeof details.actionId !== \"string\" ||\n    typeof details.runId !== \"string\" ||\n    typeof details.phase !== \"string\" ||\n    !(ACTION_RUN_PHASES as readonly string[]).includes(details.phase)\n  ) {\n    throw new Error(\n      \"[Sixb] Stored failure is invalid: Action details must contain actionId, runId, and a known phase.\"\n    )\n  }\n  if (expectedPhase !== undefined && details.phase !== expectedPhase) {\n    throw new Error(`[Sixb] Stored Action ${expectedPhase} failure has phase '${details.phase}'.`)\n  }\n\n  return {\n    ...failure,\n    details: details as unknown as ActionRunFailureDetails,\n  }\n}\n\nfunction parseStoredActionRunFailureValue(value: unknown): unknown {\n  if (typeof value !== \"string\") return value\n  try {\n    return JSON.parse(value) as unknown\n  } catch {\n    throw new Error(\"[Sixb] Stored failure is invalid: value is not valid JSON.\")\n  }\n}\n"
   ],
-  "mappings": ";;;;;;;;;AAMO,IAAM,oBAAoB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AASO,IAAM,2BAA2B;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;;;AClBO,SAAS,yBAAwD,CACtE,SACA,eACQ;AAAA,EACR,MAAM,SACJ,kBAAkB,YACd,sBAAsB,OAAO,IAC7B,sBAAsB,SAAS,aAAa;AAAA,EAClD,OAAO,KAAK,UAAU,MAAM;AAAA;AASvB,SAAS,qBAAqB,CACnC,OACA,eACkB;AAAA,EAClB,MAAM,YAAY,iCAAiC,KAAK;AAAA,EACxD,MAAM,UAAU,iBAAiB,WAAW,wBAAwB;AAAA,EACpE,MAAM,UAAU,QAAQ;AAAA,EACxB,IACE,CAAC,cAAc,OAAO,KACtB,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,UAAU,YACzB,OAAO,QAAQ,UAAU,YACzB,CAAE,kBAAwC,SAAS,QAAQ,KAAK,GAChE;AAAA,IACA,MAAM,IAAI,MACR,mGACF;AAAA,EACF;AAAA,EACA,IAAI,kBAAkB,aAAa,QAAQ,UAAU,eAAe;AAAA,IAClE,MAAM,IAAI,MAAM,wBAAwB,oCAAoC,QAAQ,SAAS;AAAA,EAC/F;AAAA,EAEA,OAAO;AAAA,OACF;AAAA,IACH;AAAA,EACF;AAAA;AAGF,SAAS,gCAAgC,CAAC,OAAyB;AAAA,EACjE,IAAI,OAAO,UAAU;AAAA,IAAU,OAAO;AAAA,EACtC,IAAI;AAAA,IACF,OAAO,KAAK,MAAM,KAAK;AAAA,IACvB,MAAM;AAAA,IACN,MAAM,IAAI,MAAM,4DAA4D;AAAA;AAAA;",
-  "debugId": "C0AEB0A8D7FE678664756E2164756E21",
+  "mappings": ";;;;;;;;;AAMO,IAAM,qBAAoB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AASO,IAAM,4BAA2B;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;;;AClBO,SAAS,0BAAwD,CACtE,SACA,eACQ;AAAA,EACR,MAAM,SACJ,kBAAkB,YACd,uBAAsB,OAAO,IAC7B,uBAAsB,SAAS,aAAa;AAAA,EAClD,OAAO,KAAK,UAAU,MAAM;AAAA;AASvB,SAAS,sBAAqB,CACnC,OACA,eACkB;AAAA,EAClB,MAAM,YAAY,iCAAiC,KAAK;AAAA,EACxD,MAAM,UAAU,kBAAiB,WAAW,yBAAwB;AAAA,EACpE,MAAM,UAAU,QAAQ;AAAA,EACxB,IACE,CAAC,cAAc,OAAO,KACtB,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,UAAU,YACzB,OAAO,QAAQ,UAAU,YACzB,CAAE,mBAAwC,SAAS,QAAQ,KAAK,GAChE;AAAA,IACA,MAAM,IAAI,MACR,mGACF;AAAA,EACF;AAAA,EACA,IAAI,kBAAkB,aAAa,QAAQ,UAAU,eAAe;AAAA,IAClE,MAAM,IAAI,MAAM,wBAAwB,oCAAoC,QAAQ,SAAS;AAAA,EAC/F;AAAA,EAEA,OAAO;AAAA,OACF;AAAA,IACH;AAAA,EACF;AAAA;AAGF,SAAS,gCAAgC,CAAC,OAAyB;AAAA,EACjE,IAAI,OAAO,UAAU;AAAA,IAAU,OAAO;AAAA,EACtC,IAAI;AAAA,IACF,OAAO,KAAK,MAAM,KAAK;AAAA,IACvB,MAAM;AAAA,IACN,MAAM,IAAI,MAAM,4DAA4D;AAAA;AAAA;",
+  "debugId": "10E96C378A97739664756E2164756E21",
   "names": []
 }

package/dist/{chunk-gbejpkex.js → chunk-bn138h9w.js}

@@ -1,53 +1,55 @@
 // @bun
 import {
-  isScheduleDefinition,
-  isScheduleReference
-} from "./chunk-5sz8ta9r.js";
+  isScheduleReference2,
+  isScheduleDefinition2
+} from "./chunk-e1c18xjx.js";
 import {
-  ConnectorError,
-  SyncValidationError,
+  ConnectorError2,
   createConnectorCodedError,
   getConnectorExecutionSourceResolver
-} from "./chunk-wtf06et8.js";
+} from "./chunk-v2vcg0w6.js";
 import {
-  isConnectorDefinition,
-  isOAuthConnectorAdapter
-} from "./chunk-8m5ejdpn.js";
+  isDatasetDefinition2
+} from "./chunk-860dwwy0.js";
 import {
-  isDatasetDefinition
-} from "./chunk-pc7ys28c.js";
+  SyncValidationError2
+} from "./chunk-5c7ga8zz.js";
+import {
+  isOAuthConnectorAdapter,
+  isConnectorDefinition
+} from "./chunk-9x8dybsb.js";
 
 // src/syncs/builders.ts
 function assertNonEmpty(value, field) {
   if (!value.trim()) {
-    throw new SyncValidationError(`Sync ${field} must not be empty.`);
+    throw new SyncValidationError2(`Sync ${field} must not be empty.`);
   }
 }
 function assertDataset(dataset, mode) {
   assertNonEmpty(dataset.id, "dataset id");
   if (mode === "merge" && dataset.primaryKey === undefined) {
-    throw new SyncValidationError(`Merge sync dataset '${dataset.id}' must define a primaryKey.`);
+    throw new SyncValidationError2(`Merge sync dataset '${dataset.id}' must define a primaryKey.`);
   }
 }
 function normalizeBatchSyncConfig(options) {
   const mode = options?.mode ?? "snapshot";
   if (mode !== "snapshot" && mode !== "append" && mode !== "merge") {
-    throw new SyncValidationError(`Invalid sync mode '${String(mode)}'. Expected 'snapshot', 'append', or 'merge'.`);
+    throw new SyncValidationError2(`Invalid sync mode '${String(mode)}'. Expected 'snapshot', 'append', or 'merge'.`);
   }
   return {
     kind: "batch",
     mode
   };
 }
-function defineSync(id, options) {
+function defineSync2(id, options) {
   assertNonEmpty(id, "id");
   const config = normalizeBatchSyncConfig(options);
   const triggers = [];
   function createBuilder() {
     const builder = {
       when(schedule) {
-        if (!isScheduleDefinition(schedule)) {
-          throw new SyncValidationError("Sync .when(...) only accepts schedules.");
+        if (!isScheduleDefinition2(schedule)) {
+          throw new SyncValidationError2("Sync .when(...) only accepts schedules.");
         }
         triggers.push({ type: "schedule", scheduleId: schedule.id });
         return builder;
@@ -84,28 +86,25 @@ function defineSync(id, options) {
   return createBuilder();
 }
 // src/syncs/sources.ts
-function resolveSyncConnectorSources(connector, definition) {
+function resolveSyncConnectorSources2(connector, definition) {
   return getConnectorExecutionSourceResolver(connector).list(definition);
 }
 // src/connectors/builders.ts
 function assertNonEmpty2(value, field) {
   if (!value.trim()) {
-    throw new ConnectorError(`Connector ${field} must not be empty.`);
+    throw new ConnectorError2(`Connector ${field} must not be empty.`);
   }
 }
-function defineConnector(id, adapter) {
+function defineConnector2(id, adapter) {
   assertNonEmpty2(id, "id");
   assertNonEmpty2(adapter.type, "type");
   if (typeof adapter.connect !== "function") {
-    throw new ConnectorError("Connector adapter connect must be a function.");
+    throw new ConnectorError2("Connector adapter connect must be a function.");
   }
   if (adapter.authentication !== undefined) {
     if (!isOAuthConnectorAdapter(adapter) || typeof adapter.authentication.authorizationUrl !== "function" || typeof adapter.authentication.exchangeCode !== "function" || typeof adapter.authentication.refresh !== "function" || typeof adapter.discoverAccounts !== "function") {
       throw createConnectorCodedError("connector.configuration_invalid", "OAuth connector adapters must define oauth2 authentication and implement authorizationUrl, exchangeCode, refresh, and discoverAccounts.");
     }
-    if (adapter.webhooks !== undefined) {
-      throw createConnectorCodedError("connector.configuration_invalid", "OAuth connector adapters cannot register webhooks until connection routing is defined.");
-    }
   }
   return {
     kind: "connector",
@@ -114,15 +113,15 @@ function defineConnector(id, adapter) {
   };
 }
 // src/syncs/types.ts
-function isSyncDefinition(value) {
+function isSyncDefinition2(value) {
   if (!isRecord(value)) {
     return false;
   }
-  return value.kind === "sync" && typeof value.id === "string" && isRecord(value.config) && value.config.kind === "batch" && (value.config.mode === "snapshot" || value.config.mode === "append" || value.config.mode === "merge") && Array.isArray(value.triggers) && value.triggers.every((reference) => isScheduleReference(reference)) && isConnectorDefinition(value.connector) && typeof value.read === "function" && isRecord(value.target) && value.target.kind === "dataset" && isDatasetDefinition(value.target.dataset);
+  return value.kind === "sync" && typeof value.id === "string" && isRecord(value.config) && value.config.kind === "batch" && (value.config.mode === "snapshot" || value.config.mode === "append" || value.config.mode === "merge") && Array.isArray(value.triggers) && value.triggers.every((reference) => isScheduleReference2(reference)) && isConnectorDefinition(value.connector) && typeof value.read === "function" && isRecord(value.target) && value.target.kind === "dataset" && isDatasetDefinition2(value.target.dataset);
 }
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-export { defineConnector, defineSync, resolveSyncConnectorSources, isSyncDefinition };
+export { defineConnector2, defineSync2, resolveSyncConnectorSources2, isSyncDefinition2 };
 
-//# debugId=B72DF63B00EA257C64756E2164756E21
+//# debugId=99DD47F6247AC4A364756E2164756E21

package/dist/{chunk-gbejpkex.js.map → chunk-bn138h9w.js.map}

@@ -4,10 +4,10 @@
   "sourcesContent": [
     "import type { AnyConnectorAdapter, ConnectorDefinition } from \"../connectors\"\nimport type { DatasetDefinition } from \"../datasets\"\nimport type { ScheduleDefinition, ScheduleReference } from \"../schedules\"\nimport { isScheduleDefinition } from \"../schedules\"\nimport { SyncValidationError } from \"./errors\"\nimport type {\n  BatchSyncConfig,\n  BatchSyncDefinitionConfig,\n  SyncBuilder,\n  SyncDefinition,\n  SyncMode,\n  SyncReadBuilder,\n  SyncTargetBuilder,\n} from \"./types\"\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (!value.trim()) {\n    throw new SyncValidationError(`Sync ${field} must not be empty.`)\n  }\n}\n\nfunction assertDataset(dataset: DatasetDefinition, mode: SyncMode): void {\n  assertNonEmpty(dataset.id, \"dataset id\")\n  if (mode === \"merge\" && dataset.primaryKey === undefined) {\n    throw new SyncValidationError(`Merge sync dataset '${dataset.id}' must define a primaryKey.`)\n  }\n}\n\nfunction normalizeBatchSyncConfig(options: BatchSyncConfig | undefined): BatchSyncDefinitionConfig {\n  const mode = options?.mode ?? \"snapshot\"\n\n  if (mode !== \"snapshot\" && mode !== \"append\" && mode !== \"merge\") {\n    throw new SyncValidationError(\n      `Invalid sync mode '${String(mode)}'. Expected 'snapshot', 'append', or 'merge'.`\n    )\n  }\n\n  return {\n    kind: \"batch\",\n    mode,\n  }\n}\n\ntype DefaultBatchSyncConfig = Omit<BatchSyncConfig, \"mode\"> & { readonly mode?: undefined }\n\n/**\n * Define a batch sync that reads from one connector and writes into one dataset.\n *\n * The returned definition is inert and safe to export from `syncs/` modules.\n * Supports `snapshot`, `append`, and keyed `merge` modes with optional triggers and checkpoints.\n */\nexport function defineSync<TId extends string>(\n  id: TId,\n  options?: DefaultBatchSyncConfig\n): SyncBuilder<TId, never, \"snapshot\">\nexport function defineSync<TId extends string, const TMode extends SyncMode>(\n  id: TId,\n  options: BatchSyncConfig<TMode> & { readonly mode: TMode }\n): SyncBuilder<TId, never, TMode>\nexport function defineSync<TId extends string>(\n  id: TId,\n  options: BatchSyncConfig\n): SyncBuilder<TId, never, SyncMode>\nexport function defineSync<TId extends string>(\n  id: TId,\n  options?: BatchSyncConfig\n): SyncBuilder<TId, never, SyncMode> {\n  assertNonEmpty(id, \"id\")\n\n  const config = normalizeBatchSyncConfig(options)\n  const triggers: ScheduleReference[] = []\n\n  function createBuilder<TCheckpoint>(): SyncBuilder<TId, TCheckpoint, SyncMode> {\n    const builder: SyncBuilder<TId, TCheckpoint, SyncMode> = {\n      when(schedule: ScheduleDefinition): SyncBuilder<TId, TCheckpoint, SyncMode> {\n        if (!isScheduleDefinition(schedule)) {\n          throw new SyncValidationError(\"Sync .when(...) only accepts schedules.\")\n        }\n        triggers.push({ type: \"schedule\", scheduleId: schedule.id })\n        return builder\n      },\n      checkpoint<TNextCheckpoint>(): SyncBuilder<TId, TNextCheckpoint, SyncMode> {\n        return createBuilder<TNextCheckpoint>()\n      },\n      from<TConnector extends ConnectorDefinition<string, AnyConnectorAdapter>>(\n        connector: TConnector\n      ): SyncReadBuilder<TId, TConnector, TCheckpoint, SyncMode> {\n        return {\n          read(handler): SyncTargetBuilder<TId, TConnector, TCheckpoint, SyncMode> {\n            return {\n              intoDataset(\n                dataset: DatasetDefinition\n              ): SyncDefinition<TId, TConnector, TCheckpoint, SyncMode> {\n                assertDataset(dataset, config.mode)\n\n                return {\n                  kind: \"sync\",\n                  id,\n                  config,\n                  triggers,\n                  connector,\n                  read: handler,\n                  target: {\n                    kind: \"dataset\",\n                    dataset,\n                  },\n                }\n              },\n            }\n          },\n        }\n      },\n    }\n\n    return builder\n  }\n\n  return createBuilder<never>()\n}\n",
     "import type { AnyConnectorAdapter, ConnectorDefinition, ConnectorRuntime } from \"../connectors\"\nimport {\n  type ConnectorExecutionSource,\n  type ConnectorExecutionSourceResolver,\n  getConnectorExecutionSourceResolver,\n} from \"../connectors/execution\"\n\n/** One connector client invocation contributing values to a Sync run. */\nexport type SyncConnectorSource<TAdapter extends AnyConnectorAdapter = AnyConnectorAdapter> =\n  ConnectorExecutionSource<TAdapter>\n\nexport type SyncConnectorSourceResolver = ConnectorExecutionSourceResolver\n\n/** Resolve the source invocations owned by one connector definition for a Sync execution. */\nexport function resolveSyncConnectorSources<TAdapter extends AnyConnectorAdapter>(\n  connector: ConnectorRuntime,\n  definition: ConnectorDefinition<string, TAdapter>\n): Promise<readonly SyncConnectorSource<TAdapter>[]> {\n  return getConnectorExecutionSourceResolver(connector).list(definition)\n}\n",
-    "import { ConnectorError, createConnectorCodedError } from \"./errors\"\nimport type {\n  AnyConnectorAdapter,\n  ConnectorAdapter,\n  ConnectorDefinition,\n  OAuthConnectorAdapter,\n} from \"./types\"\nimport { isOAuthConnectorAdapter } from \"./types\"\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (!value.trim()) {\n    throw new ConnectorError(`Connector ${field} must not be empty.`)\n  }\n}\n\n/**\n * Define a connector instance for an external system.\n *\n * The returned definition is inert and can be exported from a project-level\n * `connectors/` module. Use `await sixb.connector(definition)` at runtime to\n * resolve it to a connected client.\n */\nexport function defineConnector<TId extends string, TAdapter extends OAuthConnectorAdapter>(\n  id: TId,\n  adapter: TAdapter\n): ConnectorDefinition<TId, TAdapter>\nexport function defineConnector<TId extends string, TAdapter extends ConnectorAdapter>(\n  id: TId,\n  adapter: TAdapter\n): ConnectorDefinition<TId, TAdapter>\nexport function defineConnector<TId extends string, TAdapter extends AnyConnectorAdapter>(\n  id: TId,\n  adapter: TAdapter\n): ConnectorDefinition<TId, TAdapter> {\n  assertNonEmpty(id, \"id\")\n  assertNonEmpty(adapter.type, \"type\")\n\n  if (typeof adapter.connect !== \"function\") {\n    throw new ConnectorError(\"Connector adapter connect must be a function.\")\n  }\n\n  if (adapter.authentication !== undefined) {\n    if (\n      !isOAuthConnectorAdapter(adapter) ||\n      typeof adapter.authentication.authorizationUrl !== \"function\" ||\n      typeof adapter.authentication.exchangeCode !== \"function\" ||\n      typeof adapter.authentication.refresh !== \"function\" ||\n      typeof adapter.discoverAccounts !== \"function\"\n    ) {\n      throw createConnectorCodedError(\n        \"connector.configuration_invalid\",\n        \"OAuth connector adapters must define oauth2 authentication and implement authorizationUrl, exchangeCode, refresh, and discoverAccounts.\"\n      )\n    }\n    if (adapter.webhooks !== undefined) {\n      throw createConnectorCodedError(\n        \"connector.configuration_invalid\",\n        \"OAuth connector adapters cannot register webhooks until connection routing is defined.\"\n      )\n    }\n  }\n\n  return {\n    kind: \"connector\",\n    id,\n    adapter,\n  }\n}\n",
+    "import { ConnectorError, createConnectorCodedError } from \"./errors\"\nimport type {\n  AnyConnectorAdapter,\n  ConnectorAdapter,\n  ConnectorDefinition,\n  OAuthConnectorAdapter,\n} from \"./types\"\nimport { isOAuthConnectorAdapter } from \"./types\"\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (!value.trim()) {\n    throw new ConnectorError(`Connector ${field} must not be empty.`)\n  }\n}\n\n/**\n * Define a connector instance for an external system.\n *\n * The returned definition is inert and can be exported from a project-level\n * `connectors/` module. Use `await sixb.connector(definition)` at runtime to\n * resolve it to a connected client.\n */\nexport function defineConnector<TId extends string, TAdapter extends OAuthConnectorAdapter>(\n  id: TId,\n  adapter: TAdapter\n): ConnectorDefinition<TId, TAdapter>\nexport function defineConnector<TId extends string, TAdapter extends ConnectorAdapter>(\n  id: TId,\n  adapter: TAdapter\n): ConnectorDefinition<TId, TAdapter>\nexport function defineConnector<TId extends string, TAdapter extends AnyConnectorAdapter>(\n  id: TId,\n  adapter: TAdapter\n): ConnectorDefinition<TId, TAdapter> {\n  assertNonEmpty(id, \"id\")\n  assertNonEmpty(adapter.type, \"type\")\n\n  if (typeof adapter.connect !== \"function\") {\n    throw new ConnectorError(\"Connector adapter connect must be a function.\")\n  }\n\n  if (adapter.authentication !== undefined) {\n    if (\n      !isOAuthConnectorAdapter(adapter) ||\n      typeof adapter.authentication.authorizationUrl !== \"function\" ||\n      typeof adapter.authentication.exchangeCode !== \"function\" ||\n      typeof adapter.authentication.refresh !== \"function\" ||\n      typeof adapter.discoverAccounts !== \"function\"\n    ) {\n      throw createConnectorCodedError(\n        \"connector.configuration_invalid\",\n        \"OAuth connector adapters must define oauth2 authentication and implement authorizationUrl, exchangeCode, refresh, and discoverAccounts.\"\n      )\n    }\n  }\n\n  return {\n    kind: \"connector\",\n    id,\n    adapter,\n  }\n}\n",
     "import type { BlobStorage } from \"../blob-storage\"\nimport {\n  type AnyConnectorAdapter,\n  type ConnectorAdapter,\n  type ConnectorClient,\n  type ConnectorConnectionMetadata,\n  type ConnectorDefinition,\n  isConnectorDefinition,\n  type OAuthConnectorAdapter,\n} from \"../connectors\"\nimport type { DatasetDefinition, DatasetPrimaryKey, MergeChange } from \"../datasets\"\nimport { isDatasetDefinition } from \"../datasets\"\nimport type { Logger } from \"../logging\"\nimport type { ScheduleDefinition, ScheduleReference } from \"../schedules\"\nimport { isScheduleReference } from \"../schedules\"\n\n/** Blob operations available to sync read handlers. */\nexport type SyncBlobContext = Pick<BlobStorage, \"put\" | \"open\" | \"stat\">\n\n/** Non-secret connector connection metadata available to OAuth-backed Sync handlers. */\nexport type SyncConnectorConnection = ConnectorConnectionMetadata\n\ntype SyncConnectionContext<TAdapter extends AnyConnectorAdapter> =\n  TAdapter extends OAuthConnectorAdapter\n    ? { readonly connection: SyncConnectorConnection }\n    : { readonly connection?: undefined }\n\n/** Context passed to a sync read handler. */\nexport type SyncReadContext<\n  TCheckpoint = never,\n  TAdapter extends AnyConnectorAdapter = ConnectorAdapter,\n> = {\n  readonly projectId: string\n  readonly syncId: string\n  readonly signal: AbortSignal\n  readonly blobs: SyncBlobContext\n  readonly logger: Logger\n} & ([TCheckpoint] extends [never]\n  ? { readonly checkpoint?: undefined }\n  : {\n      readonly checkpoint?: TCheckpoint\n      setCheckpoint(next: TCheckpoint): void\n    }) &\n  SyncConnectionContext<TAdapter>\n\nexport type SyncMode = \"snapshot\" | \"append\" | \"merge\"\n\ntype MergeSyncChange = MergeChange<\n  Readonly<Record<string, unknown>>,\n  Readonly<Record<string, unknown>>\n>\n\n/** A sync read handler may return one item, a sync iterable, or an async iterable. */\nexport type SyncReadResult<TMode extends SyncMode = SyncMode> = TMode extends \"merge\"\n  ? MergeSyncChange | Iterable<MergeSyncChange> | AsyncIterable<MergeSyncChange>\n  : unknown | Iterable<unknown> | AsyncIterable<unknown>\n\n/** User-facing batch sync options accepted by `defineSync(...)`. */\nexport interface BatchSyncConfig<TMode extends SyncMode = SyncMode> {\n  readonly mode?: TMode\n}\n\n/** Normalized batch sync config stored on the final sync definition. */\nexport interface BatchSyncDefinitionConfig<TMode extends SyncMode = SyncMode> {\n  readonly kind: \"batch\"\n  readonly mode: TMode\n}\n\n/** V1 syncs always target a named raw dataset. */\nexport interface DatasetSyncTarget {\n  readonly kind: \"dataset\"\n  readonly dataset: DatasetDefinition\n}\n\n/**\n * Connector-scoped read handler used by batch sync definitions.\n *\n * This intentionally uses TypeScript's method-parameter bivariance behavior so syncs with\n * different checkpoint types can still be stored as general `SyncDefinition[]` values. The\n * builder still gives users precise `context.checkpoint` and `setCheckpoint(...)` types when\n * they author a sync.\n */\nexport type SyncReadHandler<\n  TAdapter extends AnyConnectorAdapter,\n  TCheckpoint = never,\n  TMode extends SyncMode = SyncMode,\n> = {\n  bivarianceHack(\n    client: ConnectorClient<TAdapter>,\n    context: SyncReadContext<TCheckpoint, TAdapter>\n  ): SyncReadResult<TMode> | Promise<SyncReadResult<TMode>>\n}[\"bivarianceHack\"]\n\n/**\n * Inert sync definition registered with Sixb.\n *\n * V1 supports batch syncs only. Definitions are declarative metadata and do not\n * start any background work on their own.\n */\nexport interface SyncDefinition<\n  TId extends string = string,\n  TConnector extends ConnectorDefinition<string, AnyConnectorAdapter> = ConnectorDefinition<\n    string,\n    AnyConnectorAdapter\n  >,\n  TCheckpoint = unknown,\n  TMode extends SyncMode = SyncMode,\n> {\n  readonly kind: \"sync\"\n  readonly id: TId\n  readonly config: BatchSyncDefinitionConfig<TMode>\n  readonly triggers: readonly ScheduleReference[]\n  readonly connector: TConnector\n  readonly read: SyncReadHandler<TConnector[\"adapter\"], TCheckpoint, TMode>\n  readonly target: DatasetSyncTarget\n}\n\nexport interface SyncTargetBuilder<\n  TId extends string = string,\n  TConnector extends ConnectorDefinition<string, AnyConnectorAdapter> = ConnectorDefinition<\n    string,\n    AnyConnectorAdapter\n  >,\n  TCheckpoint = never,\n  TMode extends SyncMode = SyncMode,\n> {\n  intoDataset<TDataset extends DatasetDefinition>(\n    dataset: TMode extends \"merge\"\n      ? TDataset & { readonly primaryKey: DatasetPrimaryKey }\n      : TDataset\n  ): SyncDefinition<TId, TConnector, TCheckpoint, TMode>\n}\n\nexport interface SyncReadBuilder<\n  TId extends string = string,\n  TConnector extends ConnectorDefinition<string, AnyConnectorAdapter> = ConnectorDefinition<\n    string,\n    AnyConnectorAdapter\n  >,\n  TCheckpoint = never,\n  TMode extends SyncMode = SyncMode,\n> {\n  read(\n    handler: SyncReadHandler<TConnector[\"adapter\"], TCheckpoint, TMode>\n  ): SyncTargetBuilder<TId, TConnector, TCheckpoint, TMode>\n}\n\nexport interface SyncBuilder<\n  TId extends string = string,\n  TCheckpoint = never,\n  TMode extends SyncMode = SyncMode,\n> {\n  when(schedule: ScheduleDefinition): SyncBuilder<TId, TCheckpoint, TMode>\n  checkpoint<TNextCheckpoint>(): SyncBuilder<TId, TNextCheckpoint, TMode>\n  from<TConnector extends ConnectorDefinition<string, AnyConnectorAdapter>>(\n    connector: TConnector\n  ): SyncReadBuilder<TId, TConnector, TCheckpoint, TMode>\n}\n\n/** Runtime type guard for values discovered from `syncs/` modules. */\nexport function isSyncDefinition(value: unknown): value is SyncDefinition {\n  if (!isRecord(value)) {\n    return false\n  }\n\n  return (\n    value.kind === \"sync\" &&\n    typeof value.id === \"string\" &&\n    isRecord(value.config) &&\n    value.config.kind === \"batch\" &&\n    (value.config.mode === \"snapshot\" ||\n      value.config.mode === \"append\" ||\n      value.config.mode === \"merge\") &&\n    Array.isArray(value.triggers) &&\n    (value.triggers as unknown[]).every((reference) => isScheduleReference(reference)) &&\n    isConnectorDefinition(value.connector) &&\n    typeof value.read === \"function\" &&\n    isRecord(value.target) &&\n    value.target.kind === \"dataset\" &&\n    isDatasetDefinition(value.target.dataset)\n  )\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "B72DF63B00EA257C64756E2164756E21",
+  "mappings": "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",
+  "debugId": "99DD47F6247AC4A364756E2164756E21",
   "names": []
 }