@effect-dynamodb/schema 1.9.0

package/dist/KeyComposer.js

@@ -0,0 +1,516 @@
+/**
+ * KeyComposer — Composite key composition for DynamoDB keys.
+ *
+ * v2 uses attribute-list composition (composite: ["userId"]) instead of
+ * template strings ("USER#${userId}"). The DynamoSchema module handles
+ * the key format; KeyComposer extracts attribute values and delegates.
+ */
+import { DateTime } from "effect";
+import { applyCasing, composeClusteredSortKey, composeCollectionKey, composeIsolatedSortKey, composeKey, } from "./DynamoSchema.js";
+/** Normalize a GsiConfig (entity input) to an IndexDefinition (internal format). */
+export const normalizeGsiConfig = (config) => {
+    // Detect old format and give helpful migration error
+    if ("index" in config && typeof config.index === "object") {
+        throw new Error(`[EDD-9003] GsiConfig uses old format with "index" property. ` +
+            `Migrate to: { name: "gsi1", pk: { field: "gsi1pk", composite: [...] }, sk: { field: "gsi1sk", composite: [...] } }`);
+    }
+    if (!config.name || !config.pk || !config.sk) {
+        throw new Error(`[EDD-9003] Invalid GsiConfig: requires name, pk: { field, composite }, sk: { field, composite }`);
+    }
+    return {
+        index: config.name,
+        collection: config.collection,
+        type: config.type ?? "isolated",
+        pk: { field: config.pk.field, composite: [...config.pk.composite] },
+        sk: { field: config.sk.field, composite: [...config.sk.composite] },
+        indexPolicy: config.indexPolicy,
+    };
+};
+/**
+ * Extract composite attribute values from an entity record.
+ *
+ * Given composite: ["tenantId", "email"] and record: { tenantId: "t-1", email: "a@b.com" }
+ * Returns: ["t-1", "a@b.com"]
+ */
+export const extractComposites = (composite, record) => composite.map((attr) => {
+    const value = record[attr];
+    if (value === undefined || value === null) {
+        throw new Error(`Missing composite attribute "${attr}" in record`);
+    }
+    return serializeValue(value);
+});
+/**
+ * Non-throwing variant of extractComposites. Returns undefined when any
+ * composite attribute is missing or null. Used for sparse GSI support —
+ * if a GSI's composites aren't all present, the index is simply skipped.
+ */
+export const tryExtractComposites = (composite, record) => {
+    const values = [];
+    for (const attr of composite) {
+        const value = record[attr];
+        if (value === undefined || value === null)
+            return undefined;
+        values.push(serializeValue(value));
+    }
+    return values;
+};
+/**
+ * Serialize a value for use in a composite key.
+ *
+ * Numeric values are zero-padded for correct lexicographic sort order:
+ * - number → 16-digit zero-padded string (covers Number.MAX_SAFE_INTEGER)
+ * - bigint → 38-digit zero-padded string (covers DynamoDB's max precision)
+ *
+ * DateTime values are formatted as ISO strings for correct sort order:
+ * - DateTime.Zoned → ISO string with offset (preserves timezone info)
+ * - DateTime.Utc → ISO string
+ * - Date → ISO string
+ */
+export const serializeValue = (value) => {
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number")
+        return String(value).padStart(16, "0");
+    if (typeof value === "bigint")
+        return String(value).padStart(38, "0");
+    if (typeof value === "boolean")
+        return value ? "true" : "false";
+    // DateTime types → ISO string (Zoned normalized to UTC for sort order)
+    if (typeof value === "object" && value !== null && DateTime.isDateTime(value)) {
+        return DateTime.formatIso(value);
+    }
+    // Native Date
+    if (value instanceof Date)
+        return value.toISOString();
+    return String(value);
+};
+/**
+ * Compose a partition key for an entity index.
+ *
+ * For non-collection indexes: `$schema#v<version>#entityType#attr1#attr2`
+ * For collection indexes: `$schema#v<version>#collectionName#attr1#attr2`
+ */
+export const composePk = (schema, entityType, index, record) => {
+    const composites = extractComposites(index.pk.composite, record);
+    const names = [...index.pk.composite];
+    const collection = index.collection;
+    if (collection !== undefined) {
+        // Collection index — PK uses collection name
+        const collectionName = Array.isArray(collection) ? collection[0] : collection;
+        return composeCollectionKey(schema, collectionName, composites, { casing: index.casing, names });
+    }
+    // Regular entity index — PK uses entity type
+    return composeKey(schema, entityType, composites, { casing: index.casing, names });
+};
+/**
+ * Compose a sort key for an entity index.
+ *
+ * For isolated indexes: `$schema#v<version>#entityType_version#attr1#attr2`
+ * For clustered indexes: `$schema#v<version>#collectionName#entityType_version#attr1#attr2`
+ * For non-collection indexes: `$schema#v<version>#entityType#attr1#attr2`
+ */
+export const composeSk = (schema, entityType, entityVersion, index, record) => {
+    const composites = extractComposites(index.sk.composite, record);
+    const names = [...index.sk.composite];
+    const collection = index.collection;
+    const collectionType = index.type ?? "isolated";
+    if (collection !== undefined) {
+        if (collectionType === "clustered") {
+            // For sub-collections (collection: ["parent", "child"]) the FULL hierarchy
+            // is written into the SK so a begins_with query at any level matches.
+            return composeClusteredSortKey(schema, collection, entityType, entityVersion, composites, {
+                casing: index.casing,
+                names,
+            });
+        }
+        // Isolated
+        return composeIsolatedSortKey(schema, entityType, entityVersion, composites, {
+            casing: index.casing,
+            names,
+        });
+    }
+    // Non-collection — simple entity key
+    return composeKey(schema, entityType, composites, { casing: index.casing, names });
+};
+/**
+ * Compose all key attributes for a single index.
+ * Returns a record mapping field names to composed key values.
+ */
+export const composeIndexKeys = (schema, entityType, entityVersion, index, record) => ({
+    [index.pk.field]: composePk(schema, entityType, index, record),
+    [index.sk.field]: composeSk(schema, entityType, entityVersion, index, record),
+});
+/**
+ * Non-throwing variant of composeIndexKeys. Returns undefined if any composite
+ * attribute is missing. Used for sparse GSI support.
+ */
+export const tryComposeIndexKeys = (schema, entityType, entityVersion, index, record) => {
+    if (tryExtractComposites(index.pk.composite, record) === undefined)
+        return undefined;
+    if (tryExtractComposites(index.sk.composite, record) === undefined)
+        return undefined;
+    return composeIndexKeys(schema, entityType, entityVersion, index, record);
+};
+/**
+ * Compose keys for all indexes of an entity.
+ * Returns a flat record of all key field -> value mappings.
+ */
+export const composeAllKeys = (schema, entityType, entityVersion, indexes, record) => {
+    const result = {};
+    for (const [indexName, index] of Object.entries(indexes)) {
+        if (indexName === "primary") {
+            // Primary index always required — throws on missing composites
+            Object.assign(result, composeIndexKeys(schema, entityType, entityVersion, index, record));
+        }
+        else {
+            // GSI — sparse-aware: skip if any composite is missing
+            const keys = tryComposeIndexKeys(schema, entityType, entityVersion, index, record);
+            if (keys !== undefined)
+                Object.assign(result, keys);
+        }
+    }
+    return result;
+};
+/**
+ * Compose a partition key from the leading prefix
+ * `[pk_0, ..., pk_(stopBefore-1)]` of an index's PK composites. Used by v3's
+ * structural composition rule when a trailing PK composite is absent and the
+ * half's `indexPolicy.pk` is `"preserve"` (or absent — defaults to preserve).
+ *
+ * `stopBefore === 0` produces the bare entity/collection prefix with no
+ * composite values.
+ */
+const composePkPrefixUpTo = (schema, entityType, index, record, stopBefore) => {
+    const slice = index.pk.composite.slice(0, stopBefore);
+    const composites = extractComposites(slice, record);
+    const collection = index.collection;
+    if (collection !== undefined) {
+        const collectionName = Array.isArray(collection) ? collection[0] : collection;
+        return composeCollectionKey(schema, collectionName, composites, {
+            casing: index.casing,
+            names: [...slice],
+        });
+    }
+    return composeKey(schema, entityType, composites, {
+        casing: index.casing,
+        names: [...slice],
+    });
+};
+/**
+ * Compose a sort key from the leading prefix `[sk_0, ..., sk_(stopBefore-1)]`
+ * of an index's SK composites. Used by v3's structural composition rule when a
+ * trailing SK composite is absent and the half's `indexPolicy.sk` is
+ * `"preserve"` (or absent — defaults to preserve), or when a hole pattern is
+ * encountered under `"sparse"`.
+ *
+ * `stopBefore === 0` produces the bare entity/collection prefix with no
+ * composite values (the item still belongs to the GSI but at the broadest
+ * scope — `begins_with(sk, "<prefix>")` matches it).
+ *
+ * See `DESIGN.md §7 Policy-Aware GSI Composition`.
+ */
+export const composeSkPrefixUpTo = (schema, entityType, entityVersion, index, record, stopBefore) => {
+    const slice = index.sk.composite.slice(0, stopBefore);
+    const composites = extractComposites(slice, record);
+    const collection = index.collection;
+    const collectionType = index.type ?? "isolated";
+    if (collection !== undefined) {
+        if (collectionType === "clustered") {
+            return composeClusteredSortKey(schema, collection, entityType, entityVersion, composites, {
+                casing: index.casing,
+                names: [...slice],
+            });
+        }
+        return composeIsolatedSortKey(schema, entityType, entityVersion, composites, {
+            casing: index.casing,
+            names: [...slice],
+        });
+    }
+    return composeKey(schema, entityType, composites, {
+        casing: index.casing,
+        names: [...slice],
+    });
+};
+/**
+ * Apply v1.7.1's structural composition rule to a single half that the
+ * skip-predicate gate (v1.7.3) decided not to skip.
+ *
+ * The caller is responsible for the per-half evaluation gate — `classifyHalf`
+ * is only called once the gate has decided this half should be evaluated
+ * (the half has no composites; OR a composite is in `removedSet`; OR a
+ * composite is in `updatePayload` or `keyRecord`).
+ *
+ * Walks the composite list left-to-right, finds the longest leading prefix of
+ * present values in `record`, and classifies the result:
+ *
+ * - **Compose succeeded** (non-empty leading prefix AND no hole — i.e. all
+ *   absent composites are at trailing positions only): SET.
+ * - **Compose failed** (empty leading prefix OR hole pattern): outcome
+ *   depends on `policy` and whether any composite of this half is in
+ *   `removedSet`:
+ *   - `'sparse'` → drop.
+ *   - `'preserve'` AND any composite in `removedSet` → drop (cascade
+ *     override under preserve — the consumer's explicit signal trumps
+ *     stale-data preservation).
+ *   - `'preserve'` AND no composite in `removedSet` → noop (preserve
+ *     preservation; stored key may be stale).
+ *
+ * Hole patterns collapse into can't-compose — silent partial composition
+ * (truncate-and-discard-trailing) is a worse failure mode than dropping the
+ * half because it would lie about the data shape to readers. The previous
+ * v1.7.0 sparse-truncate-on-hole behavior is gone.
+ */
+const classifyHalf = (composites, record, policy, halfHasRemoved) => {
+    // No composites at all (e.g. sk.composite = []) — emit a SET of length 0
+    // (the bare entity prefix). Policy is irrelevant; this is the standard
+    // "primary key with empty SK composite" shape.
+    if (composites.length === 0) {
+        return { kind: "set", length: 0 };
+    }
+    let leadingLen = 0;
+    while (leadingLen < composites.length) {
+        const v = record[composites[leadingLen]];
+        if (v === undefined || v === null)
+            break;
+        leadingLen++;
+    }
+    // All present → SET full length.
+    if (leadingLen === composites.length) {
+        return { kind: "set", length: leadingLen };
+    }
+    // Some absent. Check for hole (a present composite after the absent run).
+    let hasHole = false;
+    for (let j = leadingLen + 1; j < composites.length; j++) {
+        const v = record[composites[j]];
+        if (v !== undefined && v !== null) {
+            hasHole = true;
+            break;
+        }
+    }
+    // Compose-can-succeed iff non-empty leading prefix AND no hole.
+    // (Trailing-absent without a hole is a clean truncation.)
+    if (!hasHole && leadingLen > 0) {
+        return { kind: "set", length: leadingLen };
+    }
+    // Compose failed (empty leading prefix OR hole pattern). Per-half outcome:
+    if (policy === "sparse")
+        return { kind: "drop" };
+    // preserve — cascade override under removedSet, otherwise noop.
+    return halfHasRemoved ? { kind: "drop" } : { kind: "noop" };
+};
+/**
+ * Resolve the per-half policy for an index. Defaults each half to `"preserve"`
+ * when omitted (or when `indexPolicy` is omitted entirely).
+ */
+const resolveIndexPolicy = (policy) => ({
+    pk: policy?.pk ?? "preserve",
+    sk: policy?.sk ?? "preserve",
+});
+/**
+ * Policy-aware GSI key composition for `Entity.update` and time-series
+ * `.append` — v1.7.1 per-half structural composition with per-half evaluation
+ * gate and per-half cascade.
+ *
+ * **Per-half evaluation gate (reframed in v1.7.3 as a skip-predicate).** Each
+ * half (PK and SK) is independently asked one question: *can this half be
+ * safely skipped?* The gate exists for exactly one reason — multi-writer
+ * protection: prevent writer A from clobbering keys for halves it doesn't
+ * own when writer B does own them. The skip-predicate states that purpose
+ * directly: skip iff multi-writer protection actually applies (the half has
+ * composites, no composite was explicitly removed, and every composite is
+ * absent from BOTH `updatePayload` AND `keyRecord` — so this writer is
+ * genuinely not claiming ownership of this half on this call). If the half
+ * cannot be safely skipped, it is evaluated by the structural rule.
+ *
+ * Pre-v1.7.3 the predicate was inverted ("list cases for which to evaluate"
+ * as a chain of `||` clauses) and had to enumerate every shape: payload
+ * membership (v1.7.0), `removedSet` membership (v1.7.1), `keyRecord`
+ * membership (v1.7.2). Each missed shape required another tactical patch:
+ * v1.7.1 missed the multi-writer leak (#41), v1.7.2 missed the
+ * PK-composites-only case (#43), v1.7.2 then missed the empty-composite-half
+ * case (#46) because every `.some(...)` clause trivially returned `false`
+ * for an empty composite array. The skip-predicate closes the entire class
+ * of degenerate-case bugs structurally.
+ *
+ * **Two-way payload classification.**
+ * - **present** (`attr: <value>` in payload, or inherited from `keyRecord`)
+ *   — value is used in composition.
+ * - **absent** (key omitted, or `attr: null`, or `attr: undefined`) — the
+ *   structural rule treats all three identically.
+ *
+ * **Per-half outcome (v1.7.1 unified rule).** For each touched half:
+ * 1. Run the structural rule (longest leading prefix of present values in
+ *    the merged record).
+ * 2. If the prefix is non-empty AND there's no hole → SET (full or truncated).
+ * 3. Otherwise (empty leading prefix OR hole pattern):
+ *    - `'sparse'` → REMOVE this half's key.
+ *    - `'preserve'` AND any composite of this half is in `removedSet` →
+ *      REMOVE (cascade override under preserve).
+ *    - `'preserve'` AND no composite in `removedSet` → noop (stored key
+ *      retained, may be stale until next write touches the half).
+ *
+ * **Per-half roll-up (v1.7.1).** Each half's outcome applies to its own key
+ * attribute only. PK dropping doesn't drop SK; SK dropping doesn't drop PK.
+ * The item may be invisible in the GSI during a single-half-dropped period
+ * (DDB projection rule needs both keys for query visibility), but the
+ * surviving half's value persists for rejoin without other writers re-firing.
+ * The v1.7.0 GSI-wide cascade is gone.
+ *
+ * **`Entity.remove([attr])` cascade (v1.7.1: per-half).** Composites in
+ * `removedSet` contribute to the merged record as "absent" (same as
+ * undefined-in-payload) AND make their containing half "touched" for the
+ * evaluation gate AND trigger the cascade override under preserve. The
+ * cascade no longer drops both halves of every GSI containing the cleared
+ * attribute — only the half(s) whose composite list contains it.
+ *
+ * See `DESIGN.md §7 Policy-Aware GSI Composition` for the full decision
+ * table and worked multi-writer examples.
+ */
+export const composeGsiKeysForUpdatePolicyAware = (schema, entityType, entityVersion, indexes, updatePayload, keyRecord, options) => {
+    const sets = {};
+    const removes = [];
+    const removedSet = options?.removedSet;
+    for (const [indexName, index] of Object.entries(indexes)) {
+        if (indexName === "primary")
+            continue;
+        const pkComposites = index.pk.composite;
+        const skComposites = index.sk.composite;
+        // Per-half evaluation gate (reframed in v1.7.3 as a skip-predicate —
+        // closes #46 and the class of degenerate-case bugs that v1.7.0–v1.7.2
+        // were chasing as separate `||` arms). The gate's only purpose is
+        // multi-writer protection — preventing writer A from clobbering keys
+        // for halves it doesn't own when writer B does own them. The skip
+        // predicate states that purpose directly: skip iff
+        //
+        //   - the half has composites (otherwise the value is a constant
+        //     entity/collection prefix — nothing to multi-writer-clobber, so
+        //     skipping would just leave a missing key forever — closes #46),
+        //   - AND no composite of this half was explicitly removed (cascade
+        //     intent must always evaluate),
+        //   - AND every composite is absent from BOTH `updatePayload` AND
+        //     `keyRecord` (so this writer is genuinely not claiming ownership
+        //     of this half on this call — preserves the v1.7.1 multi-writer
+        //     fix #41 and the v1.7.2 PK-composites-only fix #43, since
+        //     entity-PK composites are always present in `keyRecord`).
+        //
+        // The negation `!shouldSkip` is observably equivalent to the previous
+        // touched-predicate `||`-chain extended with `composites.length === 0`:
+        // every fix the touched-predicate accumulated falls out of one of the
+        // skip-predicate's three structural conditions. See `DESIGN.md §7`.
+        const pkHasRemoved = removedSet !== undefined && pkComposites.some((attr) => removedSet.has(attr));
+        const skHasRemoved = removedSet !== undefined && skComposites.some((attr) => removedSet.has(attr));
+        const skipPk = pkComposites.length > 0 &&
+            !pkHasRemoved &&
+            pkComposites.every((attr) => !(attr in updatePayload) && !(attr in keyRecord));
+        const skipSk = skComposites.length > 0 &&
+            !skHasRemoved &&
+            skComposites.every((attr) => !(attr in updatePayload) && !(attr in keyRecord));
+        if (skipPk && skipSk)
+            continue;
+        // Build merged record for value extraction. Two-way classification: any
+        // payload value that is `null` or `undefined` is treated as absent. Any
+        // composite in `removedSet` is also treated as absent (the cascade
+        // signal). `keyRecord` provides values for composites the consumer did
+        // not touch (typically the entity's primary-key composites pulled
+        // through to GSI composites that share the names).
+        const merged = { ...keyRecord };
+        for (const [k, v] of Object.entries(updatePayload)) {
+            if (v === null || v === undefined) {
+                delete merged[k];
+                continue;
+            }
+            merged[k] = v;
+        }
+        if (removedSet !== undefined) {
+            for (const attr of removedSet) {
+                delete merged[attr];
+            }
+        }
+        const policy = resolveIndexPolicy(index.indexPolicy);
+        if (!skipPk) {
+            const pkOutcome = classifyHalf(pkComposites, merged, policy.pk, pkHasRemoved);
+            if (pkOutcome.kind === "drop") {
+                removes.push(index.pk.field);
+            }
+            else if (pkOutcome.kind === "set") {
+                sets[index.pk.field] =
+                    pkOutcome.length === pkComposites.length
+                        ? composePk(schema, entityType, index, merged)
+                        : composePkPrefixUpTo(schema, entityType, index, merged, pkOutcome.length);
+            }
+            // noop — emit nothing for this half.
+        }
+        if (!skipSk) {
+            const skOutcome = classifyHalf(skComposites, merged, policy.sk, skHasRemoved);
+            if (skOutcome.kind === "drop") {
+                removes.push(index.sk.field);
+            }
+            else if (skOutcome.kind === "set") {
+                sets[index.sk.field] =
+                    skOutcome.length === skComposites.length
+                        ? composeSk(schema, entityType, entityVersion, index, merged)
+                        : composeSkPrefixUpTo(schema, entityType, entityVersion, index, merged, skOutcome.length);
+            }
+            // noop — emit nothing for this half.
+        }
+    }
+    return { sets, removes };
+};
+/**
+ * Compose a partial sort key prefix for query operations.
+ * Used when not all SK composite attributes are provided.
+ *
+ * For example, if SK composite is ["department", "hireDate"] and only "department"
+ * is provided, this generates a begins_with prefix.
+ */
+export const composeSortKeyPrefix = (schema, entityType, entityVersion, index, record) => {
+    // Collect available composites and their names (stop at first missing)
+    const available = [];
+    const names = [];
+    for (const attr of index.sk.composite) {
+        const value = record[attr];
+        if (value === undefined || value === null)
+            break;
+        available.push(serializeValue(value));
+        names.push(attr);
+    }
+    const collection = index.collection;
+    const collectionType = index.type ?? "isolated";
+    if (collection !== undefined) {
+        if (collectionType === "clustered") {
+            // For sub-collections, pass the full hierarchy so the SK prefix matches
+            // the same hierarchy written by composeSk during put.
+            return composeClusteredSortKey(schema, collection, entityType, entityVersion, available, {
+                casing: index.casing,
+                names,
+            });
+        }
+        return composeIsolatedSortKey(schema, entityType, entityVersion, available, {
+            casing: index.casing,
+            names,
+        });
+    }
+    return composeKey(schema, entityType, available, { casing: index.casing, names });
+};
+// ---------------------------------------------------------------------------
+// Time-series key helpers (used by `Entity.append()` / `.history()`).
+// Event item SK format: `<currentSk>#e#<serialised-orderBy-value>`.
+// Casing is applied to both the `#e#` infix and the value for consistency with
+// the rest of the SK — matches how every other composite segment is cased.
+// ---------------------------------------------------------------------------
+const EVENT_SK_INFIX = "e";
+/**
+ * Compose an event-item sort key by decorating the current-item SK.
+ *
+ * Given `currentSk = "$app#v1#telemetry_1"` and `orderByValue = 42`, returns
+ * `"$app#v1#telemetry_1#e#0000000000000042"` (with default lowercase casing).
+ */
+export const composeEventSk = (currentSk, orderByValue, casing = "lowercase") => `${currentSk}#${applyCasing(EVENT_SK_INFIX, casing)}#${applyCasing(serializeValue(orderByValue), casing)}`;
+/**
+ * Compose the prefix used to scope `.history()` queries to event items only.
+ *
+ * Given `currentSk = "$app#v1#telemetry_1"`, returns
+ * `"$app#v1#telemetry_1#e#"`.
+ */
+export const composeEventSkPrefix = (currentSk, casing = "lowercase") => `${currentSk}#${applyCasing(EVENT_SK_INFIX, casing)}#`;
+//# sourceMappingURL=KeyComposer.js.map

package/dist/KeyComposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyComposer.js","sourceRoot":"","sources":["../src/KeyComposer.ts"],"names":[],"mappings":"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"}

package/dist/Projection.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Projection — Select specific attributes in get/query operations.
+ *
+ * Projections reduce read capacity and network transfer by fetching only
+ * the requested attributes. The result is a partial record (not decoded
+ * through the full entity schema, since projected items may not match).
+ *
+ * Usage:
+ * - projection(["name", "email"]) → { expression, names }
+ * - Pass to get/query operations via ProjectionExpression + ExpressionAttributeNames
+ */
+export interface ProjectionResult {
+    readonly expression: string;
+    readonly names: Record<string, string>;
+}
+/**
+ * Build a ProjectionExpression from a list of attribute names.
+ * Uses ExpressionAttributeNames to safely handle reserved words.
+ *
+ * @example
+ * ```ts
+ * const proj = Projection.projection(["name", "email", "status"])
+ * // proj.expression === "#proj_name, #proj_email, #proj_status"
+ * // proj.names === { "#proj_name": "name", "#proj_email": "email", "#proj_status": "status" }
+ * ```
+ */
+export declare const projection: (attributes: ReadonlyArray<string>) => ProjectionResult;
+//# sourceMappingURL=Projection.d.ts.map

package/dist/Projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Projection.d.ts","sourceRoot":"","sources":["../src/Projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,GAAI,YAAY,aAAa,CAAC,MAAM,CAAC,KAAG,gBAkB9D,CAAA"}

package/dist/Projection.js

@@ -0,0 +1,39 @@
+/**
+ * Projection — Select specific attributes in get/query operations.
+ *
+ * Projections reduce read capacity and network transfer by fetching only
+ * the requested attributes. The result is a partial record (not decoded
+ * through the full entity schema, since projected items may not match).
+ *
+ * Usage:
+ * - projection(["name", "email"]) → { expression, names }
+ * - Pass to get/query operations via ProjectionExpression + ExpressionAttributeNames
+ */
+/**
+ * Build a ProjectionExpression from a list of attribute names.
+ * Uses ExpressionAttributeNames to safely handle reserved words.
+ *
+ * @example
+ * ```ts
+ * const proj = Projection.projection(["name", "email", "status"])
+ * // proj.expression === "#proj_name, #proj_email, #proj_status"
+ * // proj.names === { "#proj_name": "name", "#proj_email": "email", "#proj_status": "status" }
+ * ```
+ */
+export const projection = (attributes) => {
+    if (attributes.length === 0) {
+        return { expression: "", names: {} };
+    }
+    const names = {};
+    const parts = [];
+    for (const attr of attributes) {
+        const placeholder = `#proj_${attr}`;
+        names[placeholder] = attr;
+        parts.push(placeholder);
+    }
+    return {
+        expression: parts.join(", "),
+        names,
+    };
+};
+//# sourceMappingURL=Projection.js.map

package/dist/Projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Projection.js","sourceRoot":"","sources":["../src/Projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,UAAiC,EAAoB,EAAE;IAChF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IACtC,CAAC;IAED,MAAM,KAAK,GAA2B,EAAE,CAAA;IACxC,MAAM,KAAK,GAAkB,EAAE,CAAA;IAE/B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,SAAS,IAAI,EAAE,CAAA;QACnC,KAAK,CAAC,WAAW,CAAC,GAAG,IAAI,CAAA;QACzB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IACzB,CAAC;IAED,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,KAAK;KACN,CAAA;AACH,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @effect-dynamodb/schema — Pure schema/relationship-derivation layer.
+ *
+ * This package contains the AWS-free core of effect-dynamodb: the domain-model
+ * annotation system (`DynamoModel`), the application namespace (`DynamoSchema`),
+ * composite key composition (`KeyComposer`), tagged errors, and the pure
+ * `Entity` / `Aggregate` definition builders with their derived `inputSchema` /
+ * `updateSchema` / `createSchema` codecs.
+ *
+ * It has ZERO dependency on the AWS SDK — neither at runtime nor in its emitted
+ * `.d.ts` surface — so consumers can import an entity/aggregate's derived schemas
+ * (e.g. for HttpApi payloads or validation) without pulling the AWS SDK into
+ * their dependency graph or type surface.
+ *
+ * The full `effect-dynamodb` package depends on and re-exports everything here,
+ * adding the AWS runtime (DynamoClient, CRUD operations, Batch/Transaction/
+ * Collection, Marshaller).
+ */
+export type { AggregateDefinition, BoundAggregate } from "./Aggregate.js";
+export * as Aggregate from "./Aggregate.js";
+export * as DynamoModel from "./DynamoModel.js";
+export type { Casing, DynamoSchema as DynamoSchemaType } from "./DynamoSchema.js";
+export * as DynamoSchema from "./DynamoSchema.js";
+export type { AnyRefValue, EntityDefinition, EntityDefinition as EntityType, } from "./Entity.js";
+export * as Entity from "./Entity.js";
+export { AggregateAssemblyError, AggregateDecompositionError, AggregateTransactionOverflow, CascadePartialFailure, CompositeKeyHoleError, CompositeNullableError, ConditionalCheckFailed, DynamoError, DynamoValidationError, InternalServerError, ItemDeleted, ItemNotDeleted, ItemNotFound, makeCompositeKeyHoleError, makeCompositeNullableError, OptimisticLockError, RefNotFound, ResourceNotFoundError, StaleAppend, ThrottlingError, TransactionCancelled, TransactionOverflow, UniqueConstraintViolation, ValidationError, VersionConflict, } from "./Errors.js";
+export type { AppendInputType, AppendSuccess, EntityInputType, EntityKeyType, EntityRecordType, EntityRefInputType, EntityRefUpdateType, EntityUpdateType, IndexPkComposites, IndexPkInput, IndexSkComposites, ModelType, PrimaryKeyComposites, RefErrors, SystemFieldsType, } from "./internal/EntityTypes.js";
+export type { GsiConfig, IndexDefinition, KeyPart } from "./KeyComposer.js";
+export * as KeyComposer from "./KeyComposer.js";
+export type { ProjectionResult } from "./Projection.js";
+export * as Projection from "./Projection.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACzE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,YAAY,EAAE,MAAM,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACjF,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,IAAI,UAAU,GAC/B,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,eAAe,EACf,aAAa,EACb,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,oBAAoB,EACpB,SAAS,EACT,gBAAgB,GACjB,MAAM,2BAA2B,CAAA;AAClC,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA"}