graphddb 0.2.1 → 0.2.2

package/dist/{chunk-SBNP62H7.js → chunk-27XBTYVK.js}

@@ -1,7 +1,7 @@
 import {
   ChangeCaptureRegistry,
   resolveModelClass
-} from "./chunk-PWV7JDMR.js";
+} from "./chunk-3MI43FHU.js";
 
 // src/cdc/prng.ts
 var SeededRandom = class {

package/dist/{chunk-PWV7JDMR.js → chunk-3MI43FHU.js}

@@ -1345,6 +1345,29 @@ function resolveSegmentedKey(segmented, values, context = "key") {
   };
 }
 
+// src/operations/gsi-derive.ts
+function deriveGsiKey(gsi2, available, context) {
+  const gsiInput = {};
+  for (const fieldName of gsi2.inputFieldNames) {
+    gsiInput[fieldName] = available[fieldName];
+  }
+  const { pk, sk } = resolveSegmentedKey(gsi2.segmented, gsiInput, context);
+  return {
+    pkAttr: `${gsi2.indexName}PK`,
+    pk,
+    skAttr: `${gsi2.indexName}SK`,
+    sk: sk ?? ""
+  };
+}
+function affectedGsis(meta, changedFields) {
+  return meta.gsiDefinitions.filter(
+    (gsi2) => gsi2.inputFieldNames.some((f) => changedFields.has(f))
+  );
+}
+function missingGsiFields(gsi2, available) {
+  return gsi2.inputFieldNames.filter((f) => available[f] === void 0);
+}
+
 // src/capture/registry.ts
 var ChangeCaptureRegistryImpl = class {
   subscribers = /* @__PURE__ */ new Set();
@@ -1450,18 +1473,18 @@ function buildPutInput(modelClass, item, options) {
       dynamoItem[emb.propertyName] = value;
     }
   }
+  const available = {};
+  for (const fieldName of meta.fields.map((f) => f.propertyName)) {
+    available[fieldName] = serialized[fieldName] ?? item[fieldName];
+  }
   for (const gsi2 of meta.gsiDefinitions) {
-    const gsiInput = {};
-    for (const fieldName of gsi2.inputFieldNames) {
-      gsiInput[fieldName] = serialized[fieldName] ?? item[fieldName];
-    }
-    const { pk: gsiPk, sk: gsiSk } = resolveSegmentedKey(
-      gsi2.segmented,
-      gsiInput,
+    const { pkAttr, pk: gsiPk, skAttr, sk: gsiSk } = deriveGsiKey(
+      gsi2,
+      available,
       `${modelClass.name} GSI '${gsi2.indexName}'`
     );
-    dynamoItem[`${gsi2.indexName}PK`] = gsiPk;
-    dynamoItem[`${gsi2.indexName}SK`] = gsiSk ?? "";
+    dynamoItem[pkAttr] = gsiPk;
+    dynamoItem[skAttr] = gsiSk;
   }
   const putInput = {
     TableName: tableName,
@@ -1621,6 +1644,64 @@ function resolveUpdateKey(modelClass, primaryKey, entity, fieldMap) {
   );
   return { pk, sk: sk ?? "" };
 }
+function buildGsiRederiveSets(modelClass, meta, entity, serializedChanges, fieldMap, names, values, options) {
+  const changedFields = new Set(Object.keys(serializedChanges));
+  const affected = affectedGsis(meta, changedFields);
+  if (affected.length === 0) return [];
+  const available = {};
+  for (const [fieldName, raw] of Object.entries(entity)) {
+    if (raw === void 0) continue;
+    const fm = fieldMap.get(fieldName);
+    available[fieldName] = fm ? serializeFieldValue(raw, fm) : raw;
+  }
+  Object.assign(available, serializedChanges);
+  const clauses = [];
+  let i = 0;
+  for (const gsi2 of affected) {
+    const missing = missingGsiFields(gsi2, available);
+    if (missing.length > 0) {
+      if (options?.rederive === "read-modify-write") continue;
+      const changed = gsi2.inputFieldNames.filter((f) => changedFields.has(f));
+      throw new Error(
+        `Cannot update '${modelClass.name}': updating ${fmtFields(changed)} affects index '${gsi2.indexName}' (also depends on ${fmtFields(missing)}); provide ${missing.length > 1 ? "them" : "it"}, or use { rederive: 'read-modify-write' }.`
+      );
+    }
+    const { pkAttr, pk, skAttr, sk } = deriveGsiKey(
+      gsi2,
+      available,
+      `${modelClass.name} GSI '${gsi2.indexName}'`
+    );
+    const pkN = `#gsi${i}pk`;
+    const pkV = `:gsi${i}pk`;
+    names[pkN] = pkAttr;
+    values[pkV] = pk;
+    clauses.push(`${pkN} = ${pkV}`);
+    const skN = `#gsi${i}sk`;
+    const skV = `:gsi${i}sk`;
+    names[skN] = skAttr;
+    values[skV] = sk;
+    clauses.push(`${skN} = ${skV}`);
+    i++;
+  }
+  return clauses;
+}
+function fmtFields(fields) {
+  return fields.map((f) => `'${f}'`).join(", ");
+}
+function appendSetClauses(expression, clauses) {
+  if (clauses.length === 0) return expression;
+  const extra = clauses.join(", ");
+  if (/(^|\s)SET\s/.test(expression)) {
+    const removeIdx = expression.indexOf(" REMOVE ");
+    if (removeIdx === -1) {
+      return `${expression}, ${extra}`;
+    }
+    const setPart = expression.slice(0, removeIdx);
+    const rest = expression.slice(removeIdx);
+    return `${setPart}, ${extra}${rest}`;
+  }
+  return `SET ${extra} ${expression}`.trimEnd();
+}
 function buildUpdateInput(modelClass, entity, changes, options) {
   const meta = MetadataRegistry.get(modelClass);
   if (!meta.primaryKey) {
@@ -1661,6 +1742,16 @@ function buildUpdateInput(modelClass, entity, changes, options) {
   const updateResult = buildUpdateExpression(serializedChanges, embeddedFieldNames);
   const names = { ...updateResult.names };
   const values = { ...updateResult.values };
+  const gsiSetClauses = buildGsiRederiveSets(
+    modelClass,
+    meta,
+    entity,
+    serializedChanges,
+    fieldMap,
+    names,
+    values,
+    options
+  );
   let conditionExpression;
   if (options?.condition) {
     const condResult = buildConditionExpression(options.condition);
@@ -1674,7 +1765,7 @@ function buildUpdateInput(modelClass, entity, changes, options) {
       PK: pk,
       SK: sk
     },
-    UpdateExpression: updateResult.expression,
+    UpdateExpression: appendSetClauses(updateResult.expression, gsiSetClauses),
     ExpressionAttributeNames: names
   };
   if (Object.keys(values).length > 0) {
@@ -1695,8 +1786,72 @@ function serializeChanges(modelClass, changes) {
   }
   return out;
 }
+function needsReadForRederive(meta, entity, serializedChanges, fieldMap) {
+  const changedFields = new Set(Object.keys(serializedChanges));
+  const affected = affectedGsis(meta, changedFields);
+  if (affected.length === 0) return false;
+  const available = {};
+  for (const [fieldName, raw] of Object.entries(entity)) {
+    if (raw === void 0) continue;
+    const fm = fieldMap.get(fieldName);
+    available[fieldName] = fm ? serializeFieldValue(raw, fm) : raw;
+  }
+  Object.assign(available, serializedChanges);
+  return affected.some((gsi2) => missingGsiFields(gsi2, available).length > 0);
+}
+async function rederiveByReadModifyWrite(modelClass, entity, changes, options, pk, sk, tableName) {
+  const result = await ClientManager.getExecutor().execute({
+    type: "GetItem",
+    tableName,
+    keyCondition: { PK: pk, SK: sk },
+    consistentRead: true
+  });
+  const current = result.items[0];
+  if (!current) {
+    throw new Error(
+      `Cannot read-modify-write update '${modelClass.name}': no item exists at PK=${pk}, SK=${sk}. The row must exist to re-derive its GSI keys.`
+    );
+  }
+  const enriched = { ...current, ...entity };
+  const guarded = {
+    ...options,
+    rederive: void 0,
+    condition: options?.condition ?? { attributeExists: "PK" }
+  };
+  return buildUpdateInput(modelClass, enriched, changes, guarded);
+}
 async function executeUpdate(modelClass, entity, changes, options) {
-  const updateInput = buildUpdateInput(modelClass, entity, changes, options);
+  let updateInput;
+  if (options?.rederive === "read-modify-write") {
+    const meta = MetadataRegistry.get(modelClass);
+    const fieldMap = new Map(meta.fields.map((f) => [f.propertyName, f]));
+    const serializedChanges = {};
+    for (const [fieldName, value] of Object.entries(changes)) {
+      const fm = fieldMap.get(fieldName);
+      serializedChanges[fieldName] = fm && value !== void 0 ? serializeFieldValue(value, fm) : value;
+    }
+    if (meta.primaryKey && needsReadForRederive(meta, entity, serializedChanges, fieldMap)) {
+      const { pk, sk } = resolveUpdateKey(
+        modelClass,
+        meta.primaryKey,
+        entity,
+        fieldMap
+      );
+      updateInput = await rederiveByReadModifyWrite(
+        modelClass,
+        entity,
+        changes,
+        options,
+        pk,
+        sk,
+        TableMapping.resolve(meta.tableName)
+      );
+    } else {
+      updateInput = buildUpdateInput(modelClass, entity, changes, options);
+    }
+  } else {
+    updateInput = buildUpdateInput(modelClass, entity, changes, options);
+  }
   const wantsOld = ChangeCaptureRegistry.wantsOldImage(modelClass);
   const result = await ClientManager.getExecutor().update(
     updateInput,

package/dist/{chunk-4B4MUPUJ.js → chunk-CXIAECRS.js}

@@ -32,7 +32,7 @@ import {
   serializeFieldValue,
   serializeRawCondition,
   skTemplate
-} from "./chunk-PWV7JDMR.js";
+} from "./chunk-3MI43FHU.js";
 
 // src/spec/types.ts
 var SPEC_VERSION = "1.0";
@@ -4683,12 +4683,51 @@ function buildWriteItem(instr, forEachSource, txName) {
       )
     };
   }
+  const changes = templateRecord2(instr.changes ?? {}, `${txName} update changes`);
+  injectTransactionGsiRederive(
+    metadata,
+    instr.key ?? {},
+    instr.changes ?? {},
+    changes,
+    `${txName} update on '${entity}'`
+  );
   return {
     ...base,
     keyCondition: keyConditionTemplate2(metadata, instr.key ?? {}, `${txName} update`),
-    changes: templateRecord2(instr.changes ?? {}, `${txName} update changes`)
+    changes
   };
 }
+function injectTransactionGsiRederive(metadata, keyStructure, changeStructure, changes, context) {
+  if (metadata.gsiDefinitions.length === 0) return;
+  const changedFields = new Set(Object.keys(changeStructure));
+  const nameByField = /* @__PURE__ */ new Map();
+  for (const [field, value] of Object.entries(keyStructure)) {
+    if (isTransactionRef(value)) nameByField.set(field, tokenName(value.token));
+  }
+  for (const [field, value] of Object.entries(changeStructure)) {
+    if (isTransactionRef(value)) nameByField.set(field, tokenName(value.token));
+  }
+  const available = new Set(nameByField.keys());
+  for (const gsi of metadata.gsiDefinitions) {
+    if (!gsi.inputFieldNames.some((f) => changedFields.has(f))) continue;
+    const missing = gsi.inputFieldNames.filter((f) => !available.has(f));
+    if (missing.length > 0) {
+      const changed = gsi.inputFieldNames.filter((f) => changedFields.has(f));
+      throw new Error(
+        `defineTransaction: ${context}: updating ${changed.map((f) => `'${f}'`).join(", ")} affects index '${gsi.indexName}' (also depends on ${missing.map((f) => `'${f}'`).join(", ")}); add ${missing.length > 1 ? "them" : "it"} to the update key or changes.`
+      );
+    }
+    const present = new Set(gsi.inputFieldNames);
+    const { pk, sk } = evaluateKey(
+      gsi.segmented,
+      "param",
+      present,
+      (f) => nameByField.get(f) ?? f
+    );
+    changes[`${gsi.indexName}PK`] = pk;
+    if (sk !== void 0) changes[`${gsi.indexName}SK`] = sk;
+  }
+}
 function buildTransactionSpec(txName, def) {
   const items = [];
   let hasForEach = false;

package/dist/cli.js

@@ -2,10 +2,10 @@
 import {
   buildBridgeBundle,
   normalizeSelectSpec
-} from "./chunk-4B4MUPUJ.js";
+} from "./chunk-CXIAECRS.js";
 import {
   MetadataRegistry
-} from "./chunk-PWV7JDMR.js";
+} from "./chunk-3MI43FHU.js";
 
 // src/cli.ts
 import { createRequire } from "module";

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as SelectableOf, f as PrimaryKeyOf, E as Executor, g as ExecutionPlanSpec, h as SegmentedKey, i as SelectBuilderSpec, R as RawCondition, j as TransactionSpec, k as Manifest, l as ExecutionPlan, m as ResolvedKey, D as DynamoDBOperation, a as ExecutorResult, B as BatchGetExecInput, P as PutInput, W as WriteExecOptions, b as WriteResult, U as UpdateInput, c as DeleteInput, d as BatchWriteExecItem, T as TransactWriteExecItem, n as CdcEmulatorOptions, o as ChangeHandler, p as Unsubscribe, F as FaultSpec, q as ConcurrentRecomputeRef, C as ChangeEvent, r as EventLog, s as ReplayOptions, t as ShardId, u as TransactionItemSpec, v as Param, w as ParamDescriptor, x as DefinitionMap, O as OperationDefinition, e as DDBModel, M as ModelStatic, y as WriteDefinitionOptions, z as PartialQueryKeyOf, A as StrictSelectSpec, G as EntityInput, H as UniqueQueryKeyOf, I as EntityRef, J as ConditionInput, Q as QueryModelContract, K as QueryMethodSpec, L as CommandModelContract, N as CommandMethodSpec, V as ContractSpec, X as QuerySpec, Y as CommandSpec, Z as ContextSpec, _ as OperationsDocument, $ as AnyOperationDefinition, a0 as BridgeBundle, a1 as ConditionSpec } from './types-DPJ4tPjX.js';
-export { a2 as BatchDeleteRequest, a3 as BatchGetRequest, a4 as BatchGetResult, a5 as BatchPutRequest, a6 as BatchResult, a7 as BatchWriteRequest, a8 as CONTRACT_RANGE_FANOUT_CONCURRENCY, a9 as CdcMode, aa as ChangeBatch, ab as ChangeEventName, ac as ClockMode, ad as Column, ae as ColumnMap, af as CommandContractMethodSpec, ag as CommandInputShape, ah as CommandMethod, ai as CommandPlan, aj as CommandResolutionTarget, ak as CommandResultKind, al as CommandSelectShape, am as CompiledFragment, an as ComposeSpec, ao as CondSlot, ap as ConditionCheckInput, aq as Connection, ar as ContractCallSignature, as as ContractCardinality, at as ContractCommandParams, au as ContractCommandResult, av as ContractComposeNode, aw as ContractFromRef, ax as ContractInputArity, ay as ContractItem, az as ContractKeyFieldRef, aA as ContractKeyInput, aB as ContractKeyRef, aC as ContractKeySpec, aD as ContractKind, aE as ContractMethodOp, aF as ContractParamRef, aG as ContractQueryParams, aH as ContractResolution, aI as DeleteOptions, aJ as DeriveEffect, aK as DerivedEdgeWrite, aL as DerivedUpdate, aM as DescriptorBinding, aN as ENTITY_WRITES_MARKER, aO as EdgeEffect, aP as EffectPath, aQ as EmitEffect, aR as EntityWritesDefinition, aS as EntityWritesShape, aT as ExecutableCommandContract, aU as ExecutableQueryContract, aV as FilterInput, aW as FilterSpec, aX as FragmentInput, aY as GsiDefinitionMarker, aZ as GsiOptions, a_ as IdempotencyEffect, a$ as InProcessWriteDescriptor, b0 as InputArity, b1 as KeyDefinitionMarker, b2 as KeySegment, b3 as KeySlot, b4 as KeyStructure, b5 as KeyedResult, b6 as LIFECYCLE_CONTRACT_MARKER, b7 as LifecycleContract, b8 as LifecycleEffects, b9 as LiteralParam, ba as ManifestEntity, bb as ManifestField, bc as ManifestFieldType, bd as ManifestGsi, be as ManifestKey, bf as ManifestRelation, bg as ManifestTable, bh as ModelRef, bi as MutateMode, bj as MutateOptions, bk as MutateParallelResult, bl as MutateTransactionResult, bm as MutationBody, bn as MutationDescriptorMap, bo as MutationFragment, bp as MutationInputProxy, bq as MutationInputRef, br as MutationIntent, bs as NumberParam, bt as OperationKind, bu as OperationSpec, bv as ParallelOpResult, bw as ParamKind, bx as ParamSpec, by as ParamStructure, bz as PlannedCommandMethod, bA as PutOptions, bB as QueryContractMethodSpec, bC as QueryEnvelopeResult, bD as QueryKeyOf, bE as QueryMethod, bF as QueryResult, bG as RangeConditionSpec, bH as ReadEnvelope, bI as ReadOperationType, bJ as ReadRouteDescriptor, bK as ReadRouteOptions, bL as ReadRouteResult, bM as RecordedCompose, bN as RelationBuilder, bO as RelationSelect, bP as RelationSpec, bQ as RequiresEffect, bR as Resolution, bS as SPEC_VERSION, bT as SegmentSpec, bU as SelectBuilder, bV as SelectOf, bW as StartingPosition, bX as StreamViewType, bY as StringParam, bZ as TransactionContext, b_ as TransactionItemType, b$ as UniqueEffect, c0 as Updatable, c1 as UpdateOptions, c2 as WhenSpec, c3 as WriteDescriptor, c4 as WriteEnvelope, c5 as WriteLifecyclePhase, c6 as WriteOperationType, c7 as WriteRecorder, c8 as WriteResultProjection, c9 as attachModelClass, ca as buildDeleteInput, cb as buildPutInput, cc as buildUpdateInput, cd as compileFragment, ce as compileMutationPlan, cf as compileSingleFragmentPlan, cg as cond, ch as contractOfMethodSpec, ci as definePlan, cj as entityWrites, ck as executeBatchGet, cl as executeBatchWrite, cm as executeCommandMethod, cn as executeDelete, co as executeKeyedBatchGet, cp as executePut, cq as executeQueryMethod, cr as executeRangeFanout, cs as executeTransaction, ct as executeUpdate, cu as from, cv as getEntityWrites, cw as gsi, cx as isColumn, cy as isCommandModelContract, cz as isCommandPlan, cA as isContractComposeNode, cB as isContractFromRef, cC as isContractKeyFieldRef, cD as isContractKeyRef, cE as isContractParamRef, cF as isEntityWritesDefinition, cG as isKeySegment, cH as isLifecycleContract, cI as isMutationFragment, cJ as isMutationInputRef, cK as isParam, cL as isPlannedCommandMethod, cM as isQueryModelContract, cN as k, cO as key, cP as lifecyclePhaseForIntent, cQ as mintContractKeyFieldRef, cR as mintContractParamRef, cS as mutation, cT as param, cU as publicCommandModel, cV as publicQueryModel, cW as query, cX as resolveLifecycle, cY as wholeKeysSentinel } from './types-DPJ4tPjX.js';
+import { S as SelectableOf, f as PrimaryKeyOf, E as Executor, g as ExecutionPlanSpec, h as SegmentedKey, i as SelectBuilderSpec, R as RawCondition, j as TransactionSpec, k as Manifest, l as ExecutionPlan, m as ResolvedKey, D as DynamoDBOperation, a as ExecutorResult, B as BatchGetExecInput, P as PutInput, W as WriteExecOptions, b as WriteResult, U as UpdateInput, c as DeleteInput, d as BatchWriteExecItem, T as TransactWriteExecItem, n as CdcEmulatorOptions, o as ChangeHandler, p as Unsubscribe, F as FaultSpec, q as ConcurrentRecomputeRef, C as ChangeEvent, r as EventLog, s as ReplayOptions, t as ShardId, u as TransactionItemSpec, v as Param, w as ParamDescriptor, x as DefinitionMap, O as OperationDefinition, e as DDBModel, M as ModelStatic, y as WriteDefinitionOptions, z as PartialQueryKeyOf, A as StrictSelectSpec, G as EntityInput, H as UniqueQueryKeyOf, I as EntityRef, J as ConditionInput, Q as QueryModelContract, K as QueryMethodSpec, L as CommandModelContract, N as CommandMethodSpec, V as ContractSpec, X as QuerySpec, Y as CommandSpec, Z as ContextSpec, _ as OperationsDocument, $ as AnyOperationDefinition, a0 as BridgeBundle, a1 as ConditionSpec } from './types-SKxZQbQO.js';
+export { a2 as BatchDeleteRequest, a3 as BatchGetRequest, a4 as BatchGetResult, a5 as BatchPutRequest, a6 as BatchResult, a7 as BatchWriteRequest, a8 as CONTRACT_RANGE_FANOUT_CONCURRENCY, a9 as CdcMode, aa as ChangeBatch, ab as ChangeEventName, ac as ClockMode, ad as Column, ae as ColumnMap, af as CommandContractMethodSpec, ag as CommandInputShape, ah as CommandMethod, ai as CommandPlan, aj as CommandResolutionTarget, ak as CommandResultKind, al as CommandSelectShape, am as CompiledFragment, an as ComposeSpec, ao as CondSlot, ap as ConditionCheckInput, aq as Connection, ar as ContractCallSignature, as as ContractCardinality, at as ContractCommandParams, au as ContractCommandResult, av as ContractComposeNode, aw as ContractFromRef, ax as ContractInputArity, ay as ContractItem, az as ContractKeyFieldRef, aA as ContractKeyInput, aB as ContractKeyRef, aC as ContractKeySpec, aD as ContractKind, aE as ContractMethodOp, aF as ContractParamRef, aG as ContractQueryParams, aH as ContractResolution, aI as DeleteOptions, aJ as DeriveEffect, aK as DerivedEdgeWrite, aL as DerivedUpdate, aM as DescriptorBinding, aN as ENTITY_WRITES_MARKER, aO as EdgeEffect, aP as EffectPath, aQ as EmitEffect, aR as EntityWritesDefinition, aS as EntityWritesShape, aT as ExecutableCommandContract, aU as ExecutableQueryContract, aV as FilterInput, aW as FilterSpec, aX as FragmentInput, aY as GsiDefinitionMarker, aZ as GsiOptions, a_ as IdempotencyEffect, a$ as InProcessWriteDescriptor, b0 as InputArity, b1 as KeyDefinitionMarker, b2 as KeySegment, b3 as KeySlot, b4 as KeyStructure, b5 as KeyedResult, b6 as LIFECYCLE_CONTRACT_MARKER, b7 as LifecycleContract, b8 as LifecycleEffects, b9 as LiteralParam, ba as ManifestEntity, bb as ManifestField, bc as ManifestFieldType, bd as ManifestGsi, be as ManifestKey, bf as ManifestRelation, bg as ManifestTable, bh as ModelRef, bi as MutateMode, bj as MutateOptions, bk as MutateParallelResult, bl as MutateTransactionResult, bm as MutationBody, bn as MutationDescriptorMap, bo as MutationFragment, bp as MutationInputProxy, bq as MutationInputRef, br as MutationIntent, bs as NumberParam, bt as OperationKind, bu as OperationSpec, bv as ParallelOpResult, bw as ParamKind, bx as ParamSpec, by as ParamStructure, bz as PlannedCommandMethod, bA as PutOptions, bB as QueryContractMethodSpec, bC as QueryEnvelopeResult, bD as QueryKeyOf, bE as QueryMethod, bF as QueryResult, bG as RangeConditionSpec, bH as ReadEnvelope, bI as ReadOperationType, bJ as ReadRouteDescriptor, bK as ReadRouteOptions, bL as ReadRouteResult, bM as RecordedCompose, bN as RelationBuilder, bO as RelationSelect, bP as RelationSpec, bQ as RequiresEffect, bR as Resolution, bS as SPEC_VERSION, bT as SegmentSpec, bU as SelectBuilder, bV as SelectOf, bW as StartingPosition, bX as StreamViewType, bY as StringParam, bZ as TransactionContext, b_ as TransactionItemType, b$ as UniqueEffect, c0 as Updatable, c1 as UpdateOptions, c2 as WhenSpec, c3 as WriteDescriptor, c4 as WriteEnvelope, c5 as WriteLifecyclePhase, c6 as WriteOperationType, c7 as WriteRecorder, c8 as WriteResultProjection, c9 as attachModelClass, ca as buildDeleteInput, cb as buildPutInput, cc as buildUpdateInput, cd as compileFragment, ce as compileMutationPlan, cf as compileSingleFragmentPlan, cg as cond, ch as contractOfMethodSpec, ci as definePlan, cj as entityWrites, ck as executeBatchGet, cl as executeBatchWrite, cm as executeCommandMethod, cn as executeDelete, co as executeKeyedBatchGet, cp as executePut, cq as executeQueryMethod, cr as executeRangeFanout, cs as executeTransaction, ct as executeUpdate, cu as from, cv as getEntityWrites, cw as gsi, cx as isColumn, cy as isCommandModelContract, cz as isCommandPlan, cA as isContractComposeNode, cB as isContractFromRef, cC as isContractKeyFieldRef, cD as isContractKeyRef, cE as isContractParamRef, cF as isEntityWritesDefinition, cG as isKeySegment, cH as isLifecycleContract, cI as isMutationFragment, cJ as isMutationInputRef, cK as isParam, cL as isPlannedCommandMethod, cM as isQueryModelContract, cN as k, cO as key, cP as lifecyclePhaseForIntent, cQ as mintContractKeyFieldRef, cR as mintContractParamRef, cS as mutation, cT as param, cU as publicCommandModel, cV as publicQueryModel, cW as query, cX as resolveLifecycle, cY as wholeKeysSentinel } from './types-SKxZQbQO.js';
 import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
 import { DynamoDBDocumentClient } from '@aws-sdk/lib-dynamodb';
 

package/dist/index.js

@@ -86,11 +86,11 @@ import {
   validateDepth,
   when,
   wholeKeysSentinel
-} from "./chunk-4B4MUPUJ.js";
+} from "./chunk-CXIAECRS.js";
 import {
   CdcEmulator,
   createCdcEmulator
-} from "./chunk-SBNP62H7.js";
+} from "./chunk-27XBTYVK.js";
 import {
   BATCH_GET_MAX_KEYS,
   BATCH_WRITE_MAX_ITEMS,
@@ -134,7 +134,7 @@ import {
   resolveKey,
   resolveModelClass,
   serializeFieldValue
-} from "./chunk-PWV7JDMR.js";
+} from "./chunk-3MI43FHU.js";
 
 // src/metadata/prefix.ts
 function derivePrefix(customPrefix, className) {

package/dist/testing/index.d.ts

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

package/dist/testing/index.js

@@ -1,12 +1,12 @@
 import {
   createCdcEmulator
-} from "../chunk-SBNP62H7.js";
+} from "../chunk-27XBTYVK.js";
 import {
   ClientManager,
   MetadataRegistry,
   TableMapping,
   resolveModelClass
-} from "../chunk-PWV7JDMR.js";
+} from "../chunk-3MI43FHU.js";
 
 // src/memory/memory-store.ts
 function deepClone(value) {

package/dist/{types-DPJ4tPjX.d.ts → types-SKxZQbQO.d.ts}

@@ -864,6 +864,21 @@ interface PutOptions<T = unknown> {
 }
 interface UpdateOptions<T = unknown> {
     condition?: WriteCondition<T>;
+    /**
+     * How to re-derive a GSI key whose composing fields are changed but **not all**
+     * available from `{ ...key, ...changes }` (issue #115).
+     *
+     * - **unset (default)** — refuse with an explicit error rather than let the
+     *   index silently rot. The error names the index, the changed field, and the
+     *   missing field(s). The happy path (all composing fields available) re-derives
+     *   in the SAME `UpdateExpression` and is unaffected by this option.
+     * - `'read-modify-write'` — read the current item, merge `{ ...item, ...changes }`,
+     *   re-derive every affected GSI key from the merged image, and write back under
+     *   an optimistic condition (the item must still exist / be unchanged). This costs
+     *   one extra read and is NOT atomic with the original update, but always re-derives
+     *   correctly.
+     */
+    rederive?: 'read-modify-write';
 }
 interface DeleteOptions<T = unknown> {
     condition?: WriteCondition<T>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphddb",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Graph data modeling on DynamoDB with adjacency list pattern",
   "type": "module",
   "main": "dist/index.js",