graphddb 0.2.4 → 0.3.0

package/dist/index.js

@@ -16,6 +16,7 @@ import {
   buildBridgeBundle,
   buildContexts,
   buildContracts,
+  buildMaintenanceGraph,
   buildManifest,
   buildOperations,
   buildProjection,
@@ -56,6 +57,7 @@ import {
   getEntityWrites,
   getImplicitKeyFields,
   hydrate,
+  identity,
   isCommandModelContract,
   isCommandPlan,
   isContractComposeNode,
@@ -66,6 +68,7 @@ import {
   isEdgeWritesDefinition,
   isEntityWritesDefinition,
   isLifecycleContract,
+  isMaintainTrigger,
   isMutationFragment,
   isMutationInputRef,
   isPlannedCommandMethod,
@@ -73,11 +76,13 @@ import {
   isSelectBuilder,
   isTransactionRef,
   lifecyclePhaseForIntent,
+  maintainTrigger,
   mapWithConcurrency,
   mintContractKeyFieldRef,
   mintContractParamRef,
   mutation,
   plan,
+  preview,
   publicCommandModel,
   publicQueryModel,
   query,
@@ -86,11 +91,11 @@ import {
   validateDepth,
   when,
   wholeKeysSentinel
-} from "./chunk-IQEOJVHI.js";
+} from "./chunk-QEOFIXTN.js";
 import {
   CdcEmulator,
   createCdcEmulator
-} from "./chunk-LNESVUTO.js";
+} from "./chunk-QQNP43JL.js";
 import {
   BATCH_GET_MAX_KEYS,
   BATCH_WRITE_MAX_ITEMS,
@@ -139,7 +144,7 @@ import {
   resolveKey,
   resolveModelClass,
   serializeFieldValue
-} from "./chunk-GCPEUPAA.js";
+} from "./chunk-6AIAHP3A.js";
 
 // src/metadata/prefix.ts
 function derivePrefix(customPrefix, className) {
@@ -189,6 +194,7 @@ function validateGsiAmbiguity(primaryKey, gsiDefinitions) {
 var pendingFields = [];
 var pendingEmbedded = [];
 var pendingRelations = [];
+var pendingAggregates = [];
 function collectField(field2) {
   pendingFields.push(field2);
 }
@@ -198,6 +204,9 @@ function collectEmbedded(embedded2) {
 function collectRelation(relation) {
   pendingRelations.push(relation);
 }
+function collectAggregate(aggregate2) {
+  pendingAggregates.push(aggregate2);
+}
 function drainFields() {
   const result = pendingFields;
   pendingFields = [];
@@ -213,6 +222,11 @@ function drainRelations() {
   pendingRelations = [];
   return result;
 }
+function drainAggregates() {
+  const result = pendingAggregates;
+  pendingAggregates = [];
+  return result;
+}
 
 // src/decorators/model.ts
 function model(options) {
@@ -220,6 +234,7 @@ function model(options) {
     const fields = drainFields();
     const embeddedFields = drainEmbedded();
     const relations = drainRelations();
+    const aggregates = drainAggregates();
     const prefix = derivePrefix(options.prefix, context.name);
     MetadataRegistry.register(target, {
       tableName: options.table,
@@ -228,6 +243,7 @@ function model(options) {
       primaryKey: null,
       gsiDefinitions: [],
       relations,
+      aggregates,
       embeddedFields
     });
   };
@@ -322,7 +338,7 @@ function hasMany(targetFactory, keyBinding, options) {
     });
   };
 }
-function belongsTo(targetFactory, keyBinding) {
+function belongsTo(targetFactory, keyBinding, options) {
   return function(_value, context) {
     const propertyName = String(context.name);
     assertRelationPropertyNameAllowed(propertyName);
@@ -330,7 +346,8 @@ function belongsTo(targetFactory, keyBinding) {
       type: "belongsTo",
       propertyName,
       targetFactory,
-      keyBinding
+      keyBinding,
+      options
     });
   };
 }
@@ -347,6 +364,29 @@ function hasOne(targetFactory, keyBinding) {
   };
 }
 
+// src/decorators/aggregate.ts
+function aggregate(targetFactory, keyBinding, options) {
+  return function(_value, context) {
+    collectAggregate({
+      propertyName: String(context.name),
+      targetFactory,
+      keyBinding,
+      options
+    });
+  };
+}
+function count() {
+  return { op: "count" };
+}
+function max(field2) {
+  if (typeof field2 !== "string" || field2.length === 0) {
+    throw new Error(
+      `max(...) requires a non-empty source field name to aggregate (e.g. max('createdAt')), but received ${JSON.stringify(field2)}.`
+    );
+  }
+  return { op: "max", field: field2 };
+}
+
 // src/operations/declarative-transaction.ts
 var PLACEHOLDER_RE = /\{[^{}]+\}/g;
 function resolveTemplate(template, params, element) {
@@ -484,6 +524,79 @@ function entityByName(manifest, name) {
 function physicalTableName(manifest, logical) {
   return manifest.tables[logical]?.physicalName ?? logical;
 }
+function applyMaintainTransform(op, args, value) {
+  if (op === "identity") return value;
+  if (op === "preview") {
+    const n = args[0];
+    if (typeof n !== "number" || !Number.isInteger(n) || n <= 0) {
+      throw new Error(
+        `declarative transaction: a maintenance \`preview\` projection has a non-positive-integer length bound (${JSON.stringify(n)}).`
+      );
+    }
+    if (value === null || value === void 0) return value;
+    return String(value).slice(0, n);
+  }
+  throw new Error(
+    `declarative transaction: unknown maintenance projection op '${String(op)}' (expected 'identity' / 'preview').`
+  );
+}
+function buildMaintainProjection(maintain, params, element) {
+  const out = {};
+  for (const [attr, transform] of Object.entries(maintain.projection)) {
+    const value = resolveValue(`{${transform.inputField}}`, params, element);
+    out[attr] = applyMaintainTransform(transform.op, transform.args, value);
+  }
+  return out;
+}
+function buildMaintainUpdateItem(spec, maintain, table, key2, params, element) {
+  const update = { TableName: table, Key: key2 };
+  if (maintain.kind === "counter") {
+    const counter = maintain.counter;
+    if (counter === void 0) {
+      throw new Error(
+        `declarative transaction: a 'counter' maintenance write on '${spec.entity}' has no \`counter\` payload.`
+      );
+    }
+    update.UpdateExpression = "ADD #a0 :a0";
+    update.ExpressionAttributeNames = { "#a0": counter.attribute };
+    update.ExpressionAttributeValues = {
+      ":a0": typeof counter.delta === "string" ? Number(counter.delta) : counter.delta
+    };
+    return { Update: update };
+  }
+  const projection = buildMaintainProjection(maintain, params, element);
+  if (maintain.kind === "collection") {
+    const field2 = maintain.collection?.field;
+    if (field2 === void 0) {
+      throw new Error(
+        `declarative transaction: a 'collection' maintenance write on '${spec.entity}' has no \`collection.field\`.`
+      );
+    }
+    update.UpdateExpression = "SET #c = list_append(if_not_exists(#c, :empty), :item)";
+    update.ExpressionAttributeNames = { "#c": field2 };
+    update.ExpressionAttributeValues = { ":empty": [], ":item": [projection] };
+  } else {
+    const names = {};
+    const values = {};
+    const sets = [];
+    let i = 0;
+    for (const [attr, value] of Object.entries(projection)) {
+      names[`#m${i}`] = attr;
+      values[`:m${i}`] = value;
+      sets.push(`#m${i} = :m${i}`);
+      i++;
+    }
+    if (sets.length === 0) {
+      throw new Error(
+        `declarative transaction: a 'snapshot' maintenance write on '${spec.entity}' has an empty projection.`
+      );
+    }
+    update.UpdateExpression = `SET ${sets.join(", ")}`;
+    update.ExpressionAttributeNames = names;
+    update.ExpressionAttributeValues = values;
+  }
+  return { Update: update };
+}
 function buildTransactItem(spec, manifest, params, element) {
   const literal2 = spec.literalKey === true;
   const entity = literal2 ? void 0 : entityByName(manifest, spec.entity);
@@ -511,6 +624,9 @@ function buildTransactItem(spec, manifest, params, element) {
     applyCondition(spec.condition, check, params, element);
     return { ConditionCheck: check };
   }
+  if (spec.maintain !== void 0) {
+    return buildMaintainUpdateItem(spec, spec.maintain, table, key2, params, element);
+  }
   const changes = resolveRecord(spec.changes, params, element);
   const adds = resolveRecord(spec.add, params, element);
   const names = {};
@@ -600,8 +716,8 @@ async function executeDeclarativeTransaction(spec, manifest, params) {
     expanded.map((e) => e.item),
     {
       modelBySignature,
-      limitError: (count) => new Error(
-        `declarative transaction: expanded to ${count} items, exceeds the DynamoDB TransactWriteItems limit of ${MAX_TRANSACT_ITEMS}.`
+      limitError: (count2) => new Error(
+        `declarative transaction: expanded to ${count2} items, exceeds the DynamoDB TransactWriteItems limit of ${MAX_TRANSACT_ITEMS}.`
       )
     }
   );
@@ -1063,6 +1179,7 @@ export {
   SPEC_VERSION,
   TableMapping,
   TransactionContext,
+  aggregate,
   assertBundleSerializable,
   assertContractBoundaries,
   assertContractN1Safe,
@@ -1077,6 +1194,7 @@ export {
   buildContexts,
   buildContracts,
   buildDeleteInput,
+  buildMaintenanceGraph,
   buildManifest,
   buildOperations,
   buildProjection,
@@ -1094,6 +1212,7 @@ export {
   compileSingleFragmentPlan,
   cond,
   contractOfMethodSpec,
+  count,
   createCdcEmulator,
   createDefaultLinter,
   datetime,
@@ -1146,6 +1265,7 @@ export {
   hasMany,
   hasOne,
   hydrate,
+  identity,
   isColumn,
   isCommandModelContract,
   isCommandPlan,
@@ -1158,6 +1278,7 @@ export {
   isEntityWritesDefinition,
   isKeySegment,
   isLifecycleContract,
+  isMaintainTrigger,
   isMutationFragment,
   isMutationInputRef,
   isParam,
@@ -1172,7 +1293,9 @@ export {
   lifecyclePhaseForIntent,
   list,
   literal,
+  maintainTrigger,
   map,
+  max,
   mintContractKeyFieldRef,
   mintContractParamRef,
   missingGsiRule,
@@ -1183,6 +1306,7 @@ export {
   numberSet,
   param,
   plan,
+  preview,
   publicCommandModel,
   publicQueryModel,
   query,

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { E as Executor, D as DynamoDBOperation, R as ReadExecOptions, a as ExecutorResult, B as BatchGetExecInput, P as PutInput, W as WriteExecOptions, b as WriteResult, U as UpdateInput, c as DeleteInput, d as BatchWriteExecItem, e as BatchExecOptions, T as TransactWriteExecItem, M as ModelStatic, f as DDBModel, C as ChangeEvent } from '../types-BEeQ_nSd.js';
+import { E as Executor, D as DynamoDBOperation, R as ReadExecOptions, a as ExecutorResult, B as BatchGetExecInput, P as PutInput, W as WriteExecOptions, b as WriteResult, U as UpdateInput, c as DeleteInput, d as BatchWriteExecItem, e as BatchExecOptions, T as TransactWriteExecItem, M as ModelStatic, f as DDBModel, C as ChangeEvent } from '../types-xJRn5qkv.js';
 import '@aws-sdk/client-dynamodb';
 
 /**

package/dist/testing/index.js

@@ -1,12 +1,12 @@
 import {
   createCdcEmulator
-} from "../chunk-LNESVUTO.js";
+} from "../chunk-QQNP43JL.js";
 import {
   ClientManager,
   MetadataRegistry,
   TableMapping,
   resolveModelClass
-} from "../chunk-GCPEUPAA.js";
+} from "../chunk-6AIAHP3A.js";
 
 // src/memory/memory-store.ts
 function deepClone(value) {