graphddb 0.7.10 → 0.8.1

package/dist/{chunk-DFUKGU2Q.js → chunk-HNY2EJPV.js}

@@ -1,11 +1,149 @@
 import {
   MetadataRegistry,
   attachHiddenKey
-} from "./chunk-3ZU2VW3L.js";
+} from "./chunk-L2NEDS7U.js";
 import {
   resolveKey,
   segmentFieldNames
-} from "./chunk-PDUVTYC5.js";
+} from "./chunk-XTWXMOHD.js";
+
+// src/define/entity-writes.ts
+var MAINTAIN_TRIGGER_RE = /^[^.\s$[\]*]+\.(?:created|updated|removed)$/;
+function isMaintainTrigger(value) {
+  return typeof value === "string" && MAINTAIN_TRIGGER_RE.test(value);
+}
+function makeProjectionTransform(path, op, args) {
+  if (op === "preview") {
+    const [n] = args;
+    if (typeof n !== "number" || !Number.isInteger(n) || n <= 0) {
+      throw new Error(
+        `transform: the \`preview\` op requires a positive integer length bound (e.g. \`preview('$.body', 200)\`), but received ${JSON.stringify(n)}.`
+      );
+    }
+    return { kind: "transform", path, op, args: [n] };
+  }
+  if (op === "identity") {
+    if (args.length > 0) {
+      throw new Error(
+        `transform: the \`identity\` op takes no arguments, but received ${JSON.stringify(args)}.`
+      );
+    }
+    return { kind: "transform", path, op, args: [] };
+  }
+  throw new Error(
+    `transform: unknown projection op ${JSON.stringify(op)} (expected \`identity\` or \`preview\`).`
+  );
+}
+function pathOf(value) {
+  return typeof value === "string" ? value : value.path;
+}
+function preview(path, n) {
+  return makeProjectionTransform(pathOf(path), "preview", [n]);
+}
+function identity(path) {
+  return makeProjectionTransform(pathOf(path), "identity", []);
+}
+var LIFECYCLE_CONTRACT_MARKER = /* @__PURE__ */ Symbol(
+  "graphddb:lifecycleContract"
+);
+function isLifecycleContract(value) {
+  return typeof value === "object" && value !== null && value[LIFECYCLE_CONTRACT_MARKER] === true;
+}
+var ENTITY_WRITES_MARKER = /* @__PURE__ */ Symbol("graphddb:entityWrites");
+function isEntityWritesDefinition(value) {
+  return typeof value === "object" && value !== null && value[ENTITY_WRITES_MARKER] === true;
+}
+function freezeEffects(effects) {
+  const out = {};
+  if (effects.requires !== void 0) out.requires = effects.requires;
+  if (effects.unique !== void 0) out.unique = effects.unique;
+  if (effects.edges !== void 0) out.edges = effects.edges;
+  if (effects.derive !== void 0) out.derive = effects.derive;
+  if (effects.emits !== void 0) out.emits = effects.emits;
+  if (effects.idempotency !== void 0) out.idempotency = effects.idempotency;
+  return out;
+}
+var recorder = {
+  lifecycle(effects = {}) {
+    return {
+      [LIFECYCLE_CONTRACT_MARKER]: true,
+      effects: freezeEffects(effects)
+    };
+  },
+  exists(targetFactory, keys) {
+    return { kind: "requires", targetFactory, keys };
+  },
+  unique(spec) {
+    return { kind: "unique", name: spec.name, scope: spec.scope, fields: spec.fields };
+  },
+  putEdge(targetFactory, relationProperty) {
+    return { kind: "putEdge", targetFactory, relationProperty };
+  },
+  deleteEdge(targetFactory, relationProperty) {
+    return { kind: "deleteEdge", targetFactory, relationProperty };
+  },
+  dualEdge(forward, inverse) {
+    return {
+      kind: "putEdge",
+      targetFactory: forward.target,
+      relationProperty: forward.relationProperty,
+      inverse: {
+        adjacencyFactory: inverse.adjacency,
+        targetFactory: inverse.target,
+        relationProperty: inverse.relationProperty
+      }
+    };
+  },
+  increment(targetFactory, keys, attribute, amount) {
+    return { kind: "derive", targetFactory, keys, attribute, amount };
+  },
+  transform(path, op, ...args) {
+    return makeProjectionTransform(path, op, args);
+  },
+  event(name, payload) {
+    return { kind: "event", name, payload };
+  },
+  idempotentBy(token) {
+    return { kind: "idempotency", token };
+  }
+};
+function entityWrites(builder) {
+  const shape = builder(recorder);
+  for (const phase of ["create", "update", "remove"]) {
+    const contract = shape[phase];
+    if (contract !== void 0 && !isLifecycleContract(contract)) {
+      throw new Error(
+        `entityWrites: the '${phase}' lifecycle must be built with \`w.lifecycle({...})\` (it carries the \xA72 effect arrays), but received ${JSON.stringify(contract)}.`
+      );
+    }
+  }
+  if (shape.create === void 0 && shape.update === void 0 && shape.remove === void 0) {
+    throw new Error(
+      "entityWrites(...) must declare at least one lifecycle (`create` / `update` / `remove`); an empty save contract declares nothing."
+    );
+  }
+  return {
+    [ENTITY_WRITES_MARKER]: true,
+    ...shape.create !== void 0 ? { create: shape.create } : {},
+    ...shape.update !== void 0 ? { update: shape.update } : {},
+    ...shape.remove !== void 0 ? { remove: shape.remove } : {}
+  };
+}
+function getEntityWrites(modelClass) {
+  for (const name of Object.getOwnPropertyNames(modelClass)) {
+    let value;
+    try {
+      value = modelClass[name];
+    } catch {
+      continue;
+    }
+    if (isEntityWritesDefinition(value)) return value;
+  }
+  return void 0;
+}
+function lifecyclePhaseForIntent(intent) {
+  return intent === "upsert" ? "create" : intent;
+}
 
 // src/types/select-builder.ts
 var SELECT_BUILDER = /* @__PURE__ */ Symbol.for("graphddb.selectBuilder");
@@ -226,150 +364,98 @@ function deserializeValue(value, fieldMeta) {
   return value;
 }
 
-// src/define/entity-writes.ts
-var MAINTAIN_TRIGGER_RE = /^[^.\s$[\]*]+\.(?:created|updated|removed)$/;
-function maintainTrigger(value) {
-  if (typeof value !== "string" || !MAINTAIN_TRIGGER_RE.test(value)) {
-    throw new Error(
-      `maintainTrigger: a maintenance trigger must be an \`Entity.event\` string where event is one of \`created\` / \`updated\` / \`removed\` (e.g. \`"Post.created"\`), but received ${JSON.stringify(value)}.`
-    );
+// src/cdc/from-change.ts
+function buildFullSelect(metadata) {
+  const select = {};
+  for (const field of metadata.fields) {
+    select[field.propertyName] = true;
   }
-  return value;
-}
-function isMaintainTrigger(value) {
-  return typeof value === "string" && MAINTAIN_TRIGGER_RE.test(value);
+  return select;
 }
-function makeProjectionTransform(path, op, args) {
-  if (op === "preview") {
-    const [n] = args;
-    if (typeof n !== "number" || !Number.isInteger(n) || n <= 0) {
-      throw new Error(
-        `transform: the \`preview\` op requires a positive integer length bound (e.g. \`preview('$.body', 200)\`), but received ${JSON.stringify(n)}.`
-      );
-    }
-    return { kind: "transform", path, op, args: [n] };
+function eventOwnedBy(event, metadata, modelName) {
+  if (event.model !== void 0) {
+    return event.model === modelName;
   }
-  if (op === "identity") {
-    if (args.length > 0) {
-      throw new Error(
-        `transform: the \`identity\` op takes no arguments, but received ${JSON.stringify(args)}.`
-      );
+  return metadata.prefix.length > 0 && event.keys.pk.startsWith(metadata.prefix);
+}
+function hydrateImage(image, select, metadata, modelClass) {
+  if (image === void 0) return null;
+  const [hydrated] = hydrate([image], select, metadata);
+  const instance = new modelClass();
+  Object.assign(instance, hydrated);
+  for (const emb of metadata.embeddedFields) {
+    const rawEmb = image[emb.propertyName];
+    if (rawEmb !== void 0 && rawEmb !== null) {
+      instance[emb.propertyName] = rawEmb;
     }
-    return { kind: "transform", path, op, args: [] };
   }
-  throw new Error(
-    `transform: unknown projection op ${JSON.stringify(op)} (expected \`identity\` or \`preview\`).`
-  );
-}
-function pathOf(value) {
-  return typeof value === "string" ? value : value.path;
-}
-function preview(path, n) {
-  return makeProjectionTransform(pathOf(path), "preview", [n]);
-}
-function identity(path) {
-  return makeProjectionTransform(pathOf(path), "identity", []);
-}
-var LIFECYCLE_CONTRACT_MARKER = /* @__PURE__ */ Symbol(
-  "graphddb:lifecycleContract"
-);
-function isLifecycleContract(value) {
-  return typeof value === "object" && value !== null && value[LIFECYCLE_CONTRACT_MARKER] === true;
-}
-var ENTITY_WRITES_MARKER = /* @__PURE__ */ Symbol("graphddb:entityWrites");
-function isEntityWritesDefinition(value) {
-  return typeof value === "object" && value !== null && value[ENTITY_WRITES_MARKER] === true;
+  return instance;
 }
-function freezeEffects(effects) {
-  const out = {};
-  if (effects.requires !== void 0) out.requires = effects.requires;
-  if (effects.unique !== void 0) out.unique = effects.unique;
-  if (effects.edges !== void 0) out.edges = effects.edges;
-  if (effects.derive !== void 0) out.derive = effects.derive;
-  if (effects.emits !== void 0) out.emits = effects.emits;
-  if (effects.idempotency !== void 0) out.idempotency = effects.idempotency;
-  return out;
+function parseChange(event, metadata, modelName, modelClass) {
+  if (!eventOwnedBy(event, metadata, modelName)) {
+    return [null, null];
+  }
+  const select = buildFullSelect(metadata);
+  const oldRecord = hydrateImage(event.oldImage, select, metadata, modelClass);
+  const newRecord = hydrateImage(event.newImage, select, metadata, modelClass);
+  return [oldRecord, newRecord];
 }
-var recorder = {
-  lifecycle(effects = {}) {
-    return {
-      [LIFECYCLE_CONTRACT_MARKER]: true,
-      effects: freezeEffects(effects)
-    };
-  },
-  exists(targetFactory, keys) {
-    return { kind: "requires", targetFactory, keys };
-  },
-  unique(spec) {
-    return { kind: "unique", name: spec.name, scope: spec.scope, fields: spec.fields };
-  },
-  putEdge(targetFactory, relationProperty) {
-    return { kind: "putEdge", targetFactory, relationProperty };
-  },
-  deleteEdge(targetFactory, relationProperty) {
-    return { kind: "deleteEdge", targetFactory, relationProperty };
-  },
-  dualEdge(forward, inverse) {
-    return {
-      kind: "putEdge",
-      targetFactory: forward.target,
-      relationProperty: forward.relationProperty,
-      inverse: {
-        adjacencyFactory: inverse.adjacency,
-        targetFactory: inverse.target,
-        relationProperty: inverse.relationProperty
-      }
-    };
-  },
-  increment(targetFactory, keys, attribute, amount) {
-    return { kind: "derive", targetFactory, keys, attribute, amount };
-  },
-  transform(path, op, ...args) {
-    return makeProjectionTransform(path, op, args);
-  },
-  event(name, payload) {
-    return { kind: "event", name, payload };
-  },
-  idempotentBy(token) {
-    return { kind: "idempotency", token };
+
+// src/cdc/subscribe.ts
+function resolveRoutableModels(handlers) {
+  const byName = /* @__PURE__ */ new Map();
+  for (const [cls, meta] of MetadataRegistry.getAll()) {
+    byName.set(cls.name, { cls, meta });
   }
-};
-function entityWrites(builder) {
-  const shape = builder(recorder);
-  for (const phase of ["create", "update", "remove"]) {
-    const contract = shape[phase];
-    if (contract !== void 0 && !isLifecycleContract(contract)) {
+  const routable = /* @__PURE__ */ new Map();
+  for (const modelName of Object.keys(handlers)) {
+    const entry = byName.get(modelName);
+    if (!entry) {
       throw new Error(
-        `entityWrites: the '${phase}' lifecycle must be built with \`w.lifecycle({...})\` (it carries the \xA72 effect arrays), but received ${JSON.stringify(contract)}.`
+        `DDBModel.subscribe: no model named '${modelName}' is registered. Did you import the model module (so its @model decorator ran) and spell the handler key exactly as the class name?`
       );
     }
+    if (!entry.meta.cdcProjected) {
+      throw new Error(
+        `DDBModel.subscribe: model '${modelName}' is not @cdcProjected, so its change events cannot be parsed. Add @cdcProjected() to the model, or remove its handler.`
+      );
+    }
+    routable.set(modelName, {
+      modelClass: entry.cls,
+      metadata: entry.meta,
+      modelName
+    });
   }
-  if (shape.create === void 0 && shape.update === void 0 && shape.remove === void 0) {
-    throw new Error(
-      "entityWrites(...) must declare at least one lifecycle (`create` / `update` / `remove`); an empty save contract declares nothing."
+  return routable;
+}
+async function dispatchEvent(event, routable, handlers) {
+  for (const { modelClass, metadata, modelName } of routable.values()) {
+    const [oldRecord, newRecord] = parseChange(
+      event,
+      metadata,
+      modelName,
+      modelClass
     );
+    if (oldRecord === null && newRecord === null) continue;
+    const handler = handlers[modelName];
+    await handler(oldRecord, newRecord);
+    return true;
   }
-  return {
-    [ENTITY_WRITES_MARKER]: true,
-    ...shape.create !== void 0 ? { create: shape.create } : {},
-    ...shape.update !== void 0 ? { update: shape.update } : {},
-    ...shape.remove !== void 0 ? { remove: shape.remove } : {}
-  };
+  return false;
 }
-function getEntityWrites(modelClass) {
-  for (const name of Object.getOwnPropertyNames(modelClass)) {
-    let value;
-    try {
-      value = modelClass[name];
-    } catch {
-      continue;
+function buildSubscribeHandler(handlers) {
+  const routable = resolveRoutableModels(handlers);
+  return async (batch) => {
+    const batchItemFailures = [];
+    for (const event of batch.records) {
+      try {
+        await dispatchEvent(event, routable, handlers);
+      } catch {
+        batchItemFailures.push(event.sequenceNumber);
+      }
     }
-    if (isEntityWritesDefinition(value)) return value;
-  }
-  return void 0;
-}
-function lifecyclePhaseForIntent(intent) {
-  return intent;
+    return { batchItemFailures };
+  };
 }
 
 // src/relation/maintenance-view-adapter.ts
@@ -1073,100 +1159,6 @@ function buildMaintenanceGraphImpl(registry, views) {
   };
 }
 
-// src/cdc/from-change.ts
-function buildFullSelect(metadata) {
-  const select = {};
-  for (const field of metadata.fields) {
-    select[field.propertyName] = true;
-  }
-  return select;
-}
-function eventOwnedBy(event, metadata, modelName) {
-  if (event.model !== void 0) {
-    return event.model === modelName;
-  }
-  return metadata.prefix.length > 0 && event.keys.pk.startsWith(metadata.prefix);
-}
-function hydrateImage(image, select, metadata, modelClass) {
-  if (image === void 0) return null;
-  const [hydrated] = hydrate([image], select, metadata);
-  const instance = new modelClass();
-  Object.assign(instance, hydrated);
-  for (const emb of metadata.embeddedFields) {
-    const rawEmb = image[emb.propertyName];
-    if (rawEmb !== void 0 && rawEmb !== null) {
-      instance[emb.propertyName] = rawEmb;
-    }
-  }
-  return instance;
-}
-function parseChange(event, metadata, modelName, modelClass) {
-  if (!eventOwnedBy(event, metadata, modelName)) {
-    return [null, null];
-  }
-  const select = buildFullSelect(metadata);
-  const oldRecord = hydrateImage(event.oldImage, select, metadata, modelClass);
-  const newRecord = hydrateImage(event.newImage, select, metadata, modelClass);
-  return [oldRecord, newRecord];
-}
-
-// src/cdc/subscribe.ts
-function resolveRoutableModels(handlers) {
-  const byName = /* @__PURE__ */ new Map();
-  for (const [cls, meta] of MetadataRegistry.getAll()) {
-    byName.set(cls.name, { cls, meta });
-  }
-  const routable = /* @__PURE__ */ new Map();
-  for (const modelName of Object.keys(handlers)) {
-    const entry = byName.get(modelName);
-    if (!entry) {
-      throw new Error(
-        `DDBModel.subscribe: no model named '${modelName}' is registered. Did you import the model module (so its @model decorator ran) and spell the handler key exactly as the class name?`
-      );
-    }
-    if (!entry.meta.cdcProjected) {
-      throw new Error(
-        `DDBModel.subscribe: model '${modelName}' is not @cdcProjected, so its change events cannot be parsed. Add @cdcProjected() to the model, or remove its handler.`
-      );
-    }
-    routable.set(modelName, {
-      modelClass: entry.cls,
-      metadata: entry.meta,
-      modelName
-    });
-  }
-  return routable;
-}
-async function dispatchEvent(event, routable, handlers) {
-  for (const { modelClass, metadata, modelName } of routable.values()) {
-    const [oldRecord, newRecord] = parseChange(
-      event,
-      metadata,
-      modelName,
-      modelClass
-    );
-    if (oldRecord === null && newRecord === null) continue;
-    const handler = handlers[modelName];
-    await handler(oldRecord, newRecord);
-    return true;
-  }
-  return false;
-}
-function buildSubscribeHandler(handlers) {
-  const routable = resolveRoutableModels(handlers);
-  return async (batch) => {
-    const batchItemFailures = [];
-    for (const event of batch.records) {
-      try {
-        await dispatchEvent(event, routable, handlers);
-      } catch {
-        batchItemFailures.push(event.sequenceNumber);
-      }
-    }
-    return { batchItemFailures };
-  };
-}
-
 export {
   SELECT_SPEC,
   isSelectBuilder,
@@ -1179,18 +1171,13 @@ export {
   validateInlineSnapshotSelect,
   getImplicitKeyFields,
   hydrate,
-  maintainTrigger,
-  isMaintainTrigger,
   preview,
   identity,
-  LIFECYCLE_CONTRACT_MARKER,
   isLifecycleContract,
-  ENTITY_WRITES_MARKER,
   isEntityWritesDefinition,
   entityWrites,
   getEntityWrites,
   lifecyclePhaseForIntent,
-  collectViewDefinitions,
   buildMaintenanceGraph,
   parseChange,
   buildSubscribeHandler