dyna-record 0.4.10 → 0.5.0

package/dist/src/operations/utils/flattenObjectForUpdate.d.ts

@@ -0,0 +1,19 @@
+import type { ObjectSchema } from "../../decorators/attributes/types";
+import type { DocumentPathOperation } from "./types";
+/**
+ * Flattens a partial object value into document path operations for DynamoDB
+ * update expressions.
+ *
+ * For each field in the partial value:
+ * - `undefined` → skip (not being updated)
+ * - `null` → REMOVE operation
+ * - Nested object (`fieldDef.type === "object"`) → recurse, prepending parent path
+ * - Everything else (primitives, arrays, dates, enums) → serialize and SET
+ *
+ * @param parentPath Path segments leading to this object (e.g. ["address"] or ["address", "geo"])
+ * @param schema The ObjectSchema describing the object shape
+ * @param partialValue The partial object value to flatten
+ * @returns Array of DocumentPathOperation for use in expressionBuilder
+ */
+export declare function flattenObjectForUpdate(parentPath: string[], schema: ObjectSchema, partialValue: Record<string, unknown>): DocumentPathOperation[];
+//# sourceMappingURL=flattenObjectForUpdate.d.ts.map

package/dist/src/operations/utils/flattenObjectForUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattenObjectForUpdate.d.ts","sourceRoot":"","sources":["../../../../src/operations/utils/flattenObjectForUpdate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,mCAAmC,CAAC;AAEhF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,qBAAqB,EAAE,CAmCzB"}

package/dist/src/operations/utils/flattenObjectForUpdate.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flattenObjectForUpdate = flattenObjectForUpdate;
+const serializers_1 = require("../../decorators/attributes/serializers");
+/**
+ * Flattens a partial object value into document path operations for DynamoDB
+ * update expressions.
+ *
+ * For each field in the partial value:
+ * - `undefined` → skip (not being updated)
+ * - `null` → REMOVE operation
+ * - Nested object (`fieldDef.type === "object"`) → recurse, prepending parent path
+ * - Everything else (primitives, arrays, dates, enums) → serialize and SET
+ *
+ * @param parentPath Path segments leading to this object (e.g. ["address"] or ["address", "geo"])
+ * @param schema The ObjectSchema describing the object shape
+ * @param partialValue The partial object value to flatten
+ * @returns Array of DocumentPathOperation for use in expressionBuilder
+ */
+function flattenObjectForUpdate(parentPath, schema, partialValue) {
+    const ops = [];
+    for (const [key, val] of Object.entries(partialValue)) {
+        const fieldDef = schema[key];
+        if (fieldDef === undefined)
+            continue;
+        const fieldPath = [...parentPath, key];
+        if (val === undefined) {
+            continue;
+        }
+        if (val === null) {
+            ops.push({ type: "remove", path: fieldPath });
+            continue;
+        }
+        if (fieldDef.type === "object") {
+            // Recurse into nested objects
+            const nestedOps = flattenObjectForUpdate(fieldPath, fieldDef.fields, val);
+            ops.push(...nestedOps);
+            continue;
+        }
+        // Primitives, arrays, dates, enums → serialize and SET
+        const serialized = (0, serializers_1.convertFieldToTableItem)(fieldDef, val);
+        ops.push({ type: "set", path: fieldPath, value: serialized });
+    }
+    return ops;
+}

package/dist/src/operations/utils/index.d.ts

@@ -1,4 +1,6 @@
 export * from "./expressionBuilder";
+export * from "./flattenObjectForUpdate";
+export * from "./mergePartialObjectAttributes";
 export * from "./types";
 export * from "./utils";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/operations/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/operations/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/operations/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/src/operations/utils/index.js

@@ -15,5 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./expressionBuilder"), exports);
+__exportStar(require("./flattenObjectForUpdate"), exports);
+__exportStar(require("./mergePartialObjectAttributes"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./utils"), exports);

package/dist/src/operations/utils/mergePartialObjectAttributes.d.ts

@@ -0,0 +1,8 @@
+import type { AttributeMetadataStorage } from "../../metadata";
+/**
+ * Deep merges partial ObjectAttribute updates into the target object.
+ * For ObjectAttribute fields: recursively merges using the schema, removing null fields.
+ * For regular fields: shallow assigns (existing behavior).
+ */
+export declare function mergePartialObjectAttributes(target: Record<string, unknown>, partial: Record<string, unknown>, entityAttrs: AttributeMetadataStorage): void;
+//# sourceMappingURL=mergePartialObjectAttributes.d.ts.map

package/dist/src/operations/utils/mergePartialObjectAttributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergePartialObjectAttributes.d.ts","sourceRoot":"","sources":["../../../../src/operations/utils/mergePartialObjectAttributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAG/D;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,WAAW,EAAE,wBAAwB,GACpC,IAAI,CAiBN"}

package/dist/src/operations/utils/mergePartialObjectAttributes.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergePartialObjectAttributes = mergePartialObjectAttributes;
+/**
+ * Deep merges partial ObjectAttribute updates into the target object.
+ * For ObjectAttribute fields: recursively merges using the schema, removing null fields.
+ * For regular fields: shallow assigns (existing behavior).
+ */
+function mergePartialObjectAttributes(target, partial, entityAttrs) {
+    for (const [key, val] of Object.entries(partial)) {
+        const attrMeta = entityAttrs[key];
+        if (attrMeta?.objectSchema !== undefined) {
+            // Deep merge for ObjectAttribute (objects are never nullable)
+            const existing = target[key] ?? {};
+            target[key] = deepMergeObject(existing, val, attrMeta.objectSchema);
+        }
+        else {
+            target[key] = val;
+        }
+    }
+}
+/**
+ * Recursively deep merges a partial object into an existing object using the schema
+ * to determine which fields are nested objects (and should be recursed) vs leaf values
+ * (which should be overwritten).
+ * - null values cause the key to be deleted
+ * - object-type fields per the schema are recursed
+ * - everything else (primitives, arrays, dates, enums) is overwritten
+ */
+function deepMergeObject(existing, partial, schema) {
+    const result = {};
+    // Copy existing keys, skipping those being nulled
+    for (const [key, val] of Object.entries(existing)) {
+        if (partial[key] !== null) {
+            result[key] = val;
+        }
+    }
+    // Apply updates in a single pass
+    for (const [key, val] of Object.entries(partial)) {
+        if (val === null || val === undefined) {
+            continue;
+        }
+        const fieldDef = schema[key];
+        if (fieldDef?.type === "object" && typeof existing[key] === "object") {
+            result[key] = deepMergeObject(existing[key] ?? {}, val, fieldDef.fields);
+        }
+        else {
+            result[key] = val;
+        }
+    }
+    return result;
+}

package/dist/src/operations/utils/types.d.ts

@@ -18,4 +18,20 @@ export interface UpdateRemoveExpression {
  * Represents either an update expression for setting new or modifying existing attributes of an item (UpdateSetExpression) or an update expression for removing attributes from an item (UpdateRemoveExpression) in DynamoDB.
  */
 export type UpdateExpression = UpdateSetExpression | UpdateRemoveExpression;
+/**
+ * Represents a single document path operation for partial ObjectAttribute updates.
+ * Used to build DynamoDB document path expressions like `SET #addr.#street = :addr_street`
+ * or `REMOVE #addr.#zip`.
+ */
+export type DocumentPathOperation = {
+    type: "set";
+    /** Path segments, e.g. ["address", "street"] or ["address", "geo", "lat"] */
+    path: string[];
+    /** The serialized value */
+    value: unknown;
+} | {
+    type: "remove";
+    /** Path segments, e.g. ["address", "zip"] */
+    path: string[];
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/src/operations/utils/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/operations/utils/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACtE,wBAAwB,EAAE,WAAW,CACnC,kBAAkB,CAAC,0BAA0B,CAAC,CAC/C,CAAC;IACF,yBAAyB,EAAE,WAAW,CACpC,kBAAkB,CAAC,2BAA2B,CAAC,CAChD,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACtE,wBAAwB,EAAE,WAAW,CACnC,kBAAkB,CAAC,0BAA0B,CAAC,CAC/C,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,GAAG,sBAAsB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/operations/utils/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACtE,wBAAwB,EAAE,WAAW,CACnC,kBAAkB,CAAC,0BAA0B,CAAC,CAC/C,CAAC;IACF,yBAAyB,EAAE,WAAW,CACpC,kBAAkB,CAAC,2BAA2B,CAAC,CAChD,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACtE,wBAAwB,EAAE,WAAW,CACnC,kBAAkB,CAAC,0BAA0B,CAAC,CAC/C,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,GAAG,sBAAsB,CAAC;AAE5E;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,6EAA6E;IAC7E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2BAA2B;IAC3B,KAAK,EAAE,OAAO,CAAC;CAChB,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dyna-record",
-  "version": "0.4.10",
+  "version": "0.5.0",
   "description": "Typescript Data Modeler and ORM for Dynamo",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",