@sixb/core 0.1.9 → 0.1.10

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

@@ -6,16 +6,18 @@ import {
 import {
   ConnectorError2,
   createConnectorCodedError,
-  getConnectorExecutionSourceResolver,
-  SyncValidationError2
-} from "./chunk-emyyk7dx.js";
+  getConnectorExecutionSourceResolver
+} from "./chunk-v2vcg0w6.js";
 import {
   isDatasetDefinition2
 } from "./chunk-860dwwy0.js";
+import {
+  SyncValidationError2
+} from "./chunk-5c7ga8zz.js";
 import {
   isOAuthConnectorAdapter,
   isConnectorDefinition
-} from "./chunk-3f7veca0.js";
+} from "./chunk-9x8dybsb.js";
 
 // src/syncs/builders.ts
 function assertNonEmpty(value, field) {
@@ -103,9 +105,6 @@ function defineConnector2(id, adapter) {
     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",
@@ -125,4 +124,4 @@ function isRecord(value) {
 }
 export { defineConnector2, defineSync2, resolveSyncConnectorSources2, isSyncDefinition2 };
 
-//# debugId=FBA7A5471B50E1A564756E2164756E21
+//# debugId=99DD47F6247AC4A364756E2164756E21

package/dist/{chunk-xfbydgzy.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": "FBA7A5471B50E1A564756E2164756E21",
+  "mappings": "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",
+  "debugId": "99DD47F6247AC4A364756E2164756E21",
   "names": []
 }

package/dist/{chunk-an5tt9y0.js → chunk-ftv470j8.js}

@@ -34,7 +34,7 @@ import {
   createCommitId2,
   createEventId2,
   materializationApplyPhase
-} from "./chunk-x57ycxq0.js";
+} from "./chunk-gqh45d2n.js";
 import {
   ProjectionValidationError2,
   validateProjectionsAtStartup,
@@ -3122,6 +3122,12 @@ function createProjectionEntryValidator(ontology, resolved) {
   const policy = createValidationPolicy(resolved);
   return (entry) => validateProjectionEntry(ontology, resolved, policy, entry);
 }
+function validateProjectionRootRef(resolved, root) {
+  const definition = resolved.definition;
+  const owned = definition._tag === "ObjectProjectionDefinition" ? root.kind === "object" && root.ref.objectTypeId === definition.objectTypeId : root.kind === "link" && root.ref.source.objectTypeId === definition.sourceObjectTypeId && root.ref.target.objectTypeId === definition.targetObjectTypeId && root.ref.linkId === definition.linkId;
+  if (!owned)
+    throw new MaterializationValidationError2("Projection root is outside its owned type or link scope.");
+}
 function createValidationPolicy(resolved) {
   const ownedProperties = new Map(resolved.ownership.objects.map((object) => [object.objectTypeId, new Set(object.propertyIds)]));
   const ownedLinks = new Set(resolved.ownership.links.map((link) => linkOwnershipKey(link.sourceObjectTypeId, link.linkId)));
@@ -3478,13 +3484,23 @@ async function stageProjectionMaterialization(context, input) {
     projectionRevision: input.projectionRevision,
     ownershipHash: input.ownershipHash,
     ontologyRevision: context.projectionRegistry.ontologyRevision,
-    createdAt: input.createdAt
+    createdAt: input.createdAt,
+    ...input.base ? { base: input.base } : {}
   });
   let rootCount = 0;
   let assertionCount = 0;
   async function* assertions() {
     for await (const rawEntry of input.entries) {
       throwIfAborted(input.signal);
+      if ("deleted" in rawEntry) {
+        if (!input.base || rawEntry.deleted !== true) {
+          throw new MaterializationValidationError2("Explicit root deletions require a pinned source base.");
+        }
+        const root = normalizeProjectionEntity(rawEntry.root);
+        validateProjectionRootRef(context.projectionRegistry.resolveSource(input.source.projectionId), root);
+        yield { root, stagingOrdinal: rootCount++ };
+        continue;
+      }
       const entry = input.validateEntry(normalizeProjectionSourceEntry2(rawEntry));
       const stagingOrdinal = rootCount;
       for (const assertion of entry.assertions) {
@@ -3505,7 +3521,8 @@ async function stageProjectionMaterialization(context, input) {
       source: input.source,
       materializationId: input.materializationId,
       execution: input.execution,
-      rows
+      rows: rows.filter((row) => ("assertion" in row)),
+      deletions: rows.filter((row) => !("assertion" in row))
     });
   }
   await context.storage.ontology.sources.markReady({
@@ -3557,6 +3574,7 @@ function prepareProjectionReplacement(context, raw) {
     datasetVersion,
     execution,
     entries: raw.input.entries,
+    ...raw.input.base ? { base: Object.freeze({ ...raw.input.base }) } : {},
     resolved,
     projectionKind,
     runIdentity,
@@ -3622,6 +3640,7 @@ async function prepareProjectionCandidate(context, command) {
     source: command.source
   });
   validateProjectionWatermark(active, command.datasetVersion);
+  assertDeltaBase(active, command);
   return {
     materializationId: context.materializationId(),
     createdAt: context.clock().toISOString(),
@@ -3643,6 +3662,7 @@ async function stageProjectionCandidate(context, command, candidate) {
     ownershipHash: command.resolved.ownershipHash,
     createdAt: candidate.createdAt,
     entries: command.entries,
+    ...command.base ? { base: command.base } : {},
     validateEntry: createProjectionEntryValidator(context.ontology, command.resolved)
   };
   const staged = await stageCandidateEntries(context, input, command.signal);
@@ -3666,6 +3686,14 @@ async function executeProjectionTransaction(context, storage, command, ready) {
   const replay = await replayCommitRecord(context, command.identity, command.scopeExecution.executionId, storage);
   if (replay)
     return projectionReplayResult(replay, command);
+  if (command.base) {
+    const active = await storage.ontology.sources.getActive({
+      projectId: context.projectId,
+      source: command.source
+    });
+    validateProjectionWatermark(active, command.datasetVersion);
+    assertDeltaBase(active, command);
+  }
   const origin = projectionOrigin(command);
   throwIfAborted(command.signal);
   const session = await storage.ontology.materializations.begin({
@@ -3783,6 +3811,11 @@ function validateProjectionWatermark(active, next) {
     return;
   assertPinnedDatasetWatermark2(active.datasetVersion, next, "Projection replacement");
 }
+function assertDeltaBase(active, command) {
+  if (command.base && (!active || active.materializationId !== command.base.materializationId || active.lastCommitId !== command.base.lastCommitId || active.projectionRevision !== command.runIdentity.projectionRevision || active.ontologyRevision !== command.runIdentity.ontologyRevision || active.ownershipHash !== command.runIdentity.ownershipHash)) {
+    throw new MaterializationConflictError2("source-materialization", "Projection delta no longer matches the active source or its definition.");
+  }
+}
 
 // src/materializer/telemetry/plan.ts
 async function planTelemetryAppend(context, storage, session, input, identity, origin, event) {
@@ -4292,6 +4325,10 @@ class OntologyMaterializer2 {
     commit: (command) => commitEdits(this.context, command)
   };
   projections = {
+    getActive: (source) => this.context.storage.ontology.sources.getActive({
+      projectId: this.context.projectId,
+      source
+    }),
     replace: (command) => replaceProjection(this.context, command),
     finishRun: (command) => finishProjectionRun(this.context, command)
   };
@@ -4304,6 +4341,7 @@ class OntologyMaterializer2 {
         commit: (input) => this.edits.commit({ scope, input })
       }),
       projections: Object.freeze({
+        getActive: (source) => this.projections.getActive(source),
         replace: (input) => this.projections.replace({ scope, input }),
         finishRun: (input) => this.projections.finishRun({ scope, input })
       }),
@@ -4328,4 +4366,4 @@ function createOntologyMaterializer2(input) {
 }
 export { computeOntologyRevision2, computeProjectionRevision2, computeProjectionOwnershipHash2, ProjectionRegistry2, createActionIdempotencyKey2, createRuntimeIdempotencyKey2, createProjectionIdempotencyKey2, createRuntimeTelemetryIdempotencyKey2, createProjectionTelemetryIdempotencyKey2, createCommitIdentity2, timestampCommitIdentity2, createTimedCommitIdentity2, createProjectionMaterializationId2, createLinkScopeFingerprint2, normalizeJsonProperties2, normalizeOntologyEditCommit2, normalizeProjectionExecution2, normalizeProjectionSourceEntry2, normalizeTelemetryAppend2, OntologyMaterializer2, createOntologyMaterializer2 };
 
-//# debugId=D5AC53F589D39D7164756E2164756E21
+//# debugId=45B690D58E462D3C64756E2164756E21