graphddb 0.3.1 → 0.4.1

package/README.md

@@ -680,7 +680,7 @@ Relation traversal は、Entity 上に定義されたアクセスパスのみを
 | ドキュメント | 内容 |
 |----------|-------------|
 | [Specification](./docs/spec.md) | コア API: entity、structured keys/GSIs、query/filter、relation、batch/transaction、design rule、runtime の挙動。 |
-| [Design patterns](./docs/design-patterns.md) | DynamoDB の代表的な 10 設計パターン（RFC #118 §1）を graphddb の機能にマッピング: same-partition / embedded snapshot / edge / materialized view / sparse view / aggregate counter / versioned / reverse lookup / external projection。各パターンの用途・宣言方法（`pattern` / `defineView` / `defineVersioned` / `defineProjection` / `@aggregate`）・read & write 維持の挙動・Phase 別の対応状況。 |
+| [Design patterns](./docs/design-patterns.md) | DynamoDB の代表的な 10 設計パターン（RFC #118 §1）を graphddb の機能にマッピング: same-partition / embedded snapshot / edge / materialized view / sparse view / aggregate counter / versioned / reverse lookup / external projection。各パターンの用途・宣言方法（`pattern` / `@model({ kind })` + `@maintainedFrom` / `@hasOne`・`@hasMany` の versioned pattern / `@aggregate`）・read & write 維持の挙動・Phase 別の対応状況。 |
 | [CQRS contract layer](./docs/cqrs-contract.md) | public な Query/Command contract、cardinality matrix、N+1 安全性、contract をまたぐ合成、context 境界。 |
 | [Mutation → command derivation](./docs/mutation-command-derivation.md) | Command IF の背後にある内部的な write-plan 合成 DSL: モデルの write セマンティクス（`entityWrites`）、fragment 合成、atomic な `TransactWriteItems` の導出。 |
 | [Class hydration](./docs/class-hydration.md) | read 結果をホスト言語のオブジェクトにロードする opt-in な `options.hydrate` ファクトリ（Phase 1: `query` トップレベル; Phase 2–3 は今後）。 |

package/dist/{chunk-PNIZS37E.js → chunk-BROCT574.js}

@@ -6,9 +6,8 @@ import {
   buildDeleteInput,
   buildMaintenanceGraph,
   buildPutInput,
-  isProjectionDefinition,
   resolveModelClass
-} from "./chunk-YIXXTGZ6.js";
+} from "./chunk-CPTV3H2U.js";
 
 // src/cdc/prng.ts
 var SeededRandom = class {
@@ -550,10 +549,13 @@ var MaintenanceDrain = class {
         return m;
       }
     });
-    const views = opts.views ?? [];
-    const allClasses = [...classes, ...views.map((v) => v.viewClass)];
+    const explicitViews = opts.views;
+    const allClasses = [
+      ...classes,
+      ...(explicitViews ?? []).map((v) => v.viewClass)
+    ];
     const scoped = allClasses.length > 0 ? new Map(allClasses.map((c) => [c, MetadataRegistry.get(c)])) : void 0;
-    this.graph = buildMaintenanceGraph(scoped, views);
+    this.graph = buildMaintenanceGraph(scoped, explicitViews);
     for (const item of this.graph.items) {
       this.ownerByName.set(item.ownerEntity, item.ownerClass);
     }
@@ -790,114 +792,6 @@ function createMaintenanceDrainHandler(opts = {}) {
   return createMaintenanceDrain(opts).handler;
 }
 
-// src/cdc/projection-sink.ts
-var EVENT_FOR_CHANGE = {
-  INSERT: "created",
-  MODIFY: "updated",
-  REMOVE: "removed"
-};
-var InMemoryProjectionSink = class {
-  /** The current sink contents, keyed by the idempotency key. */
-  records = /* @__PURE__ */ new Map();
-  /** Total upsert CALLS (including redelivered ones) — distinguishes calls from records. */
-  upserts = 0;
-  upsert(key, record) {
-    this.records.set(key, record);
-    this.upserts += 1;
-  }
-  delete(key) {
-    this.records.delete(key);
-  }
-  /** The number of distinct sink records (the converged projection size). */
-  size() {
-    return this.records.size;
-  }
-  /** The total upsert calls (≥ size when redelivery occurred). */
-  upsertCount() {
-    return this.upserts;
-  }
-  /** Reset the sink (test). */
-  reset() {
-    this.records.clear();
-    this.upserts = 0;
-  }
-};
-var ProjectionSinkDrain = class {
-  sink;
-  /** Source-entity CLASS name (the `event.model` the capture seam records) → projections. */
-  bySource = /* @__PURE__ */ new Map();
-  /** Per-(shard,seq) de-dup within one handler invocation (at-least-once). */
-  applied = /* @__PURE__ */ new Set();
-  constructor(opts) {
-    this.sink = opts.sink;
-    for (const proj of opts.projections) {
-      if (!isProjectionDefinition(proj)) {
-        throw new Error(
-          "ProjectionSinkDrain: a non-projection definition was supplied. Build projections with defineProjection(...)."
-        );
-      }
-      const sourceName = proj.sourceClass.name;
-      const bucket = this.bySource.get(sourceName);
-      if (bucket) bucket.push(proj);
-      else this.bySource.set(sourceName, [proj]);
-    }
-  }
-  /** The CDC {@link ChangeHandler} to subscribe to an emulator / Streams source. */
-  handler = async (batch) => {
-    const failures = [];
-    for (const event of batch.records) {
-      try {
-        await this.applyOne(event);
-      } catch (e) {
-        failures.push(event.sequenceNumber);
-        if (process.env.GRAPHDDB_PROJECTION_DEBUG) {
-          console.error("PROJECTION SINK ERROR", event.keys.pk, e);
-        }
-      }
-    }
-    return failures.length > 0 ? { batchItemFailures: failures } : {};
-  };
-  /** Project one source event into the sink for every matching projection. */
-  async applyOne(event) {
-    const sourceName = event.model;
-    if (sourceName === void 0) return;
-    const projections = this.bySource.get(sourceName);
-    if (projections === void 0 || projections.length === 0) return;
-    const lifecycleEvent = EVENT_FOR_CHANGE[event.eventName];
-    const image = event.eventName === "REMOVE" ? event.oldImage : event.newImage;
-    if (image === void 0) return;
-    const eventId = `${event.shardId}#${event.sequenceNumber}`;
-    if (this.applied.has(eventId)) return;
-    for (const proj of projections) {
-      if (!proj.on.includes(lifecycleEvent)) continue;
-      const key = image[proj.idempotencyKey];
-      if (key === void 0 || key === null) {
-        throw new Error(
-          `defineProjection '${proj.name}': source event carries no idempotency key attribute '${proj.idempotencyKey}'. Every projected source row must carry it (it folds at-least-once delivery to one sink upsert).`
-        );
-      }
-      const keyStr = String(key);
-      if (lifecycleEvent === "removed") {
-        await this.sink.delete?.(keyStr);
-        continue;
-      }
-      const record = Object.keys(proj.project).length === 0 ? image : projectFrom(proj.project, image);
-      await this.sink.upsert(keyStr, record);
-    }
-    this.applied.add(eventId);
-  }
-  /** Clear the per-delivery de-dup set (test reset). */
-  reset() {
-    this.applied = /* @__PURE__ */ new Set();
-  }
-};
-function createProjectionSinkDrain(opts) {
-  return new ProjectionSinkDrain(opts);
-}
-function createProjectionSinkHandler(opts) {
-  return createProjectionSinkDrain(opts).handler;
-}
-
 export {
   CdcEmulator,
   createCdcEmulator,
@@ -908,9 +802,5 @@ export {
   MAINT_OUTBOX_PK_PREFIX,
   MaintenanceDrain,
   createMaintenanceDrain,
-  createMaintenanceDrainHandler,
-  InMemoryProjectionSink,
-  ProjectionSinkDrain,
-  createProjectionSinkDrain,
-  createProjectionSinkHandler
+  createMaintenanceDrainHandler
 };