effect-dynamodb 0.1.0

package/dist/_EntityCombinators.d.ts

@@ -0,0 +1,155 @@
+/**
+ * @internal Entity operation combinators — terminal functions and update combinators.
+ *
+ * Extracted from Entity.ts for decomposition. Not part of the public API.
+ */
+import type { AttributeValue } from "@aws-sdk/client-dynamodb";
+import { type Effect } from "effect";
+import { type CascadeTarget, type EntityDelete, type EntityGet, type EntityOp, type EntityPut, type EntityUpdate, type ReturnValuesMode } from "./_EntityOps.js";
+import type { CascadePartialFailure } from "./Errors.js";
+import type { ConditionInput } from "./Expression.js";
+/** Helper: extract Rec phantom type */
+type ExtractRec<T> = T extends EntityOp<any, infer Rec, any, any> ? Rec : never;
+/** Helper: extract E type */
+type ExtractE<T> = T extends EntityOp<any, any, infer E, any> ? E : never;
+/** Helper: extract R type */
+type ExtractR<T> = T extends EntityOp<any, any, any, infer R> ? R : never;
+/** Decode through model schema (default for yield*). Returns clean model class instance. */
+export declare const asModel: <Self extends EntityOp<any, any, any, any>>(self: Self) => Effect.Effect<Self extends EntityOp<infer A, any, any, any> ? A : never, ExtractE<Self>, ExtractR<Self>>;
+/** Decode through record schema (model + system fields). */
+export declare const asRecord: <Self extends EntityOp<any, any, any, any>>(self: Self) => Effect.Effect<ExtractRec<Self>, ExtractE<Self>, ExtractR<Self>>;
+/** Decode through item schema (model + system + keys + `__edd_e__`). Returns `Record<string, unknown>`. */
+export declare const asItem: <Self extends EntityOp<any, any, any, any>>(self: Self) => Effect.Effect<globalThis.Record<string, unknown>, ExtractE<Self>, ExtractR<Self>>;
+/** Return raw marshalled DynamoDB format (`Record<string, AttributeValue>`). No decode. */
+export declare const asNative: <Self extends EntityOp<any, any, any, any>>(self: Self) => Effect.Effect<globalThis.Record<string, AttributeValue>, ExtractE<Self>, ExtractR<Self>>;
+/**
+ * Set the fields to update.
+ *
+ * When updating GSI composite fields, the consumer is responsible for providing ALL
+ * composites for that GSI (fetch-merge pattern). If only some composites are provided,
+ * `extractComposites` in KeyComposer will throw during GSI key recomposition.
+ *
+ * When using `Entity.remove()` on a GSI composite attribute, the corresponding GSI
+ * key fields (pk/sk) are automatically removed so the item drops out of the sparse index.
+ */
+export declare const set: {
+    <Updates extends globalThis.Record<string, unknown>>(updates: Updates): <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E, R>) => EntityUpdate<A, Rec, U, E, R>;
+    <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E, R>, updates: NoInfer<U>): EntityUpdate<A, Rec, U, E, R>;
+};
+/** Set the expected version for optimistic locking. */
+export declare const expectedVersion: {
+    (version: number): <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E, R>) => EntityUpdate<A, Rec, U, E, R>;
+    <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E, R>, version: number): EntityUpdate<A, Rec, U, E, R>;
+};
+/**
+ * Enable consistent reads on an EntityGet operation.
+ * Call with no arguments to enable (defaults to true).
+ */
+export declare const consistentRead: {
+    (): <A, Rec, E, R>(self: EntityGet<A, Rec, E, R>) => EntityGet<A, Rec, E, R>;
+    <A, Rec, E, R>(self: EntityGet<A, Rec, E, R>): EntityGet<A, Rec, E, R>;
+};
+/**
+ * Select specific attributes to return (ProjectionExpression) on an EntityGet.
+ * When projection is active, the result is a raw `Record<string, unknown>`
+ * instead of a decoded schema instance, since projected items may be partial.
+ */
+export declare const project: {
+    (attributes: ReadonlyArray<string>): <A, Rec, E, R>(self: EntityGet<A, Rec, E, R>) => EntityGet<globalThis.Record<string, unknown>, globalThis.Record<string, unknown>, E, R>;
+    <A, Rec, E, R>(self: EntityGet<A, Rec, E, R>, attributes: ReadonlyArray<string>): EntityGet<globalThis.Record<string, unknown>, globalThis.Record<string, unknown>, E, R>;
+};
+/** @internal Helper type for condition-compatible operations */
+type ConditionTarget = EntityPut<any, any, any, any> | EntityUpdate<any, any, any, any, any> | EntityDelete<any, any>;
+/**
+ * Add a condition expression to a put, update, or delete operation.
+ * The condition is evaluated server-side by DynamoDB. If it fails,
+ * the operation returns a `ConditionalCheckFailed` error.
+ *
+ * For updates, the user condition is ANDed with any optimistic lock condition.
+ */
+export declare const condition: {
+    (cond: ConditionInput): <T extends ConditionTarget>(self: T) => T;
+    <T extends ConditionTarget>(self: T, cond: ConditionInput): T;
+};
+/** @internal Helper type for returnValues-compatible operations */
+type ReturnValuesTarget = EntityUpdate<any, any, any, any, any> | EntityDelete<any, any>;
+/**
+ * Set the DynamoDB `ReturnValues` mode on an update or delete operation.
+ *
+ * Modes:
+ * - `"none"` — return nothing (default for delete)
+ * - `"allOld"` — return the item as it was before the operation
+ * - `"allNew"` — return the item as it is after the operation (default for update)
+ * - `"updatedOld"` — return only the updated attributes, with old values
+ * - `"updatedNew"` — return only the updated attributes, with new values
+ *
+ * For deletes, only `"none"` and `"allOld"` are valid DynamoDB modes.
+ */
+export declare const returnValues: {
+    (mode: ReturnValuesMode): <T extends ReturnValuesTarget>(self: T) => T;
+    <T extends ReturnValuesTarget>(self: T, mode: ReturnValuesMode): T;
+};
+/**
+ * Remove one or more attributes from the item.
+ * Produces a DynamoDB `REMOVE` clause.
+ */
+export declare const remove: {
+    (fields: ReadonlyArray<string>): <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E, R>) => EntityUpdate<A, Rec, U, E, R>;
+    <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E, R>, fields: ReadonlyArray<string>): EntityUpdate<A, Rec, U, E, R>;
+};
+/**
+ * Atomically add numeric values to attributes.
+ * Produces a DynamoDB `ADD` clause. If the attribute doesn't exist,
+ * it is initialized to the provided value.
+ */
+export declare const add: {
+    (values: globalThis.Record<string, number>): <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E, R>) => EntityUpdate<A, Rec, U, E, R>;
+    <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E, R>, values: globalThis.Record<string, number>): EntityUpdate<A, Rec, U, E, R>;
+};
+/**
+ * Subtract numeric values from attributes.
+ * Synthesizes `SET #field = #field - :val` (DynamoDB has no native SUBTRACT).
+ */
+export declare const subtract: {
+    (values: globalThis.Record<string, number>): <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E, R>) => EntityUpdate<A, Rec, U, E, R>;
+    <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E, R>, values: globalThis.Record<string, number>): EntityUpdate<A, Rec, U, E, R>;
+};
+/**
+ * Append elements to list attributes.
+ * Synthesizes `SET #field = list_append(#field, :val)`.
+ */
+export declare const append: {
+    (values: globalThis.Record<string, ReadonlyArray<unknown>>): <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E, R>) => EntityUpdate<A, Rec, U, E, R>;
+    <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E, R>, values: globalThis.Record<string, ReadonlyArray<unknown>>): EntityUpdate<A, Rec, U, E, R>;
+};
+/**
+ * Delete elements from a set attribute.
+ * Produces a DynamoDB `DELETE` clause.
+ * The value should be a set (e.g., `{ tags: new Set(["old"]) }`).
+ */
+export declare const deleteFromSet: {
+    (values: globalThis.Record<string, unknown>): <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E, R>) => EntityUpdate<A, Rec, U, E, R>;
+    <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E, R>, values: globalThis.Record<string, unknown>): EntityUpdate<A, Rec, U, E, R>;
+};
+/**
+ * Configure cascade updates to propagate source entity changes to target entities
+ * that embed it via `DynamoModel.ref`. After the source update completes, all matching
+ * target items are queried via their cascade GSI and updated with the new domain data.
+ *
+ * Default mode is "eventual" (batch updates, no item limit).
+ * Use `mode: "transactional"` for atomic cascade (max 100 items).
+ */
+export declare const cascade: {
+    (config: {
+        readonly targets: ReadonlyArray<CascadeTarget>;
+        readonly filter?: globalThis.Record<string, unknown> | undefined;
+        readonly mode?: "eventual" | "transactional" | undefined;
+    }): <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E | CascadePartialFailure, R>) => EntityUpdate<A, Rec, U, E | CascadePartialFailure, R>;
+    <A, Rec, U, E, R>(self: EntityUpdate<A, Rec, U, E, R>, config: {
+        readonly targets: ReadonlyArray<CascadeTarget>;
+        readonly filter?: globalThis.Record<string, unknown> | undefined;
+        readonly mode?: "eventual" | "transactional" | undefined;
+    }): EntityUpdate<A, Rec, U, E | CascadePartialFailure, R>;
+};
+export {};
+//# sourceMappingURL=_EntityCombinators.d.ts.map

package/dist/_EntityCombinators.d.ts.map

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

package/dist/_EntityCombinators.js

@@ -0,0 +1,158 @@
+/**
+ * @internal Entity operation combinators — terminal functions and update combinators.
+ *
+ * Extracted from Entity.ts for decomposition. Not part of the public API.
+ */
+import { Function as Fn } from "effect";
+import { EntityDeleteImpl, EntityDeleteTypeId, EntityGetImpl, EntityOpTypeId, EntityPutImpl, EntityUpdateImpl, EntityUpdateTypeId, } from "./_EntityOps.js";
+/** Decode through model schema (default for yield*). Returns clean model class instance. */
+export const asModel = (self) => self._run("model");
+/** Decode through record schema (model + system fields). */
+export const asRecord = (self) => self._run("record");
+/** Decode through item schema (model + system + keys + `__edd_e__`). Returns `Record<string, unknown>`. */
+export const asItem = (self) => self._run("item");
+/** Return raw marshalled DynamoDB format (`Record<string, AttributeValue>`). No decode. */
+export const asNative = (self) => self._run("native");
+// ---------------------------------------------------------------------------
+// Update combinators — dual functions for pipe composition
+//
+// Cast rationale: Each combinator creates a new EntityUpdateImpl with updated
+// state while preserving the phantom type parameters (A, Rec, U, E, R).
+// The `_builder as any` is needed because the builder function's generic
+// signature doesn't survive reconstruction — the runtime behavior is identical.
+// The `as any` on the return bridges from the impl class to the interface type.
+// ---------------------------------------------------------------------------
+/**
+ * Set the fields to update.
+ *
+ * When updating GSI composite fields, the consumer is responsible for providing ALL
+ * composites for that GSI (fetch-merge pattern). If only some composites are provided,
+ * `extractComposites` in KeyComposer will throw during GSI key recomposition.
+ *
+ * When using `Entity.remove()` on a GSI composite attribute, the corresponding GSI
+ * key fields (pk/sk) are automatically removed so the item drops out of the sparse index.
+ */
+export const set = Fn.dual(2, (self, updates) => {
+    return new EntityUpdateImpl(self._builder, { ...self._updateState, updates }, self._entity, self._key);
+});
+/** Set the expected version for optimistic locking. */
+export const expectedVersion = Fn.dual(2, (self, version) => {
+    return new EntityUpdateImpl(self._builder, { ...self._updateState, expectedVersion: version }, self._entity, self._key);
+});
+/**
+ * Enable consistent reads on an EntityGet operation.
+ * Call with no arguments to enable (defaults to true).
+ */
+export const consistentRead = Fn.dual((args) => args.length >= 1 &&
+    typeof args[0] === "object" &&
+    args[0] !== null &&
+    EntityOpTypeId in args[0], (self) => {
+    const impl = self;
+    return new EntityGetImpl(impl._builder, impl._entity, impl._key, true);
+});
+/**
+ * Select specific attributes to return (ProjectionExpression) on an EntityGet.
+ * When projection is active, the result is a raw `Record<string, unknown>`
+ * instead of a decoded schema instance, since projected items may be partial.
+ */
+export const project = Fn.dual(2, (self, attributes) => {
+    const impl = self;
+    return new EntityGetImpl(impl._builder, impl._entity, impl._key, impl._consistentRead, attributes);
+});
+/**
+ * Add a condition expression to a put, update, or delete operation.
+ * The condition is evaluated server-side by DynamoDB. If it fails,
+ * the operation returns a `ConditionalCheckFailed` error.
+ *
+ * For updates, the user condition is ANDed with any optimistic lock condition.
+ */
+export const condition = Fn.dual(2, (self, cond) => {
+    if (EntityDeleteTypeId in self) {
+        // EntityDelete
+        const impl = self;
+        return new EntityDeleteImpl(impl._builder, impl._entity, impl._key, cond, impl._returnValues);
+    }
+    if (EntityUpdateTypeId in self) {
+        // EntityUpdate
+        const impl = self;
+        return new EntityUpdateImpl(impl._builder, { ...impl._updateState, condition: cond }, impl._entity, impl._key);
+    }
+    // EntityPut
+    const impl = self;
+    return new EntityPutImpl(impl._builder, impl._entity, impl._input, cond);
+});
+/**
+ * Set the DynamoDB `ReturnValues` mode on an update or delete operation.
+ *
+ * Modes:
+ * - `"none"` — return nothing (default for delete)
+ * - `"allOld"` — return the item as it was before the operation
+ * - `"allNew"` — return the item as it is after the operation (default for update)
+ * - `"updatedOld"` — return only the updated attributes, with old values
+ * - `"updatedNew"` — return only the updated attributes, with new values
+ *
+ * For deletes, only `"none"` and `"allOld"` are valid DynamoDB modes.
+ */
+export const returnValues = Fn.dual(2, (self, mode) => {
+    if (EntityDeleteTypeId in self) {
+        const impl = self;
+        return new EntityDeleteImpl(impl._builder, impl._entity, impl._key, impl._condition, mode);
+    }
+    // EntityUpdate
+    const impl = self;
+    return new EntityUpdateImpl(impl._builder, { ...impl._updateState, returnValues: mode }, impl._entity, impl._key);
+});
+/**
+ * Remove one or more attributes from the item.
+ * Produces a DynamoDB `REMOVE` clause.
+ */
+export const remove = Fn.dual(2, (self, fields) => {
+    const existing = self._updateState.remove ?? [];
+    return new EntityUpdateImpl(self._builder, { ...self._updateState, remove: [...existing, ...fields] }, self._entity, self._key);
+});
+/**
+ * Atomically add numeric values to attributes.
+ * Produces a DynamoDB `ADD` clause. If the attribute doesn't exist,
+ * it is initialized to the provided value.
+ */
+export const add = Fn.dual(2, (self, values) => {
+    const existing = self._updateState.add ?? {};
+    return new EntityUpdateImpl(self._builder, { ...self._updateState, add: { ...existing, ...values } }, self._entity, self._key);
+});
+/**
+ * Subtract numeric values from attributes.
+ * Synthesizes `SET #field = #field - :val` (DynamoDB has no native SUBTRACT).
+ */
+export const subtract = Fn.dual(2, (self, values) => {
+    const existing = self._updateState.subtract ?? {};
+    return new EntityUpdateImpl(self._builder, { ...self._updateState, subtract: { ...existing, ...values } }, self._entity, self._key);
+});
+/**
+ * Append elements to list attributes.
+ * Synthesizes `SET #field = list_append(#field, :val)`.
+ */
+export const append = Fn.dual(2, (self, values) => {
+    const existing = self._updateState.append ?? {};
+    return new EntityUpdateImpl(self._builder, { ...self._updateState, append: { ...existing, ...values } }, self._entity, self._key);
+});
+/**
+ * Delete elements from a set attribute.
+ * Produces a DynamoDB `DELETE` clause.
+ * The value should be a set (e.g., `{ tags: new Set(["old"]) }`).
+ */
+export const deleteFromSet = Fn.dual(2, (self, values) => {
+    const existing = self._updateState.deleteFromSet ?? {};
+    return new EntityUpdateImpl(self._builder, { ...self._updateState, deleteFromSet: { ...existing, ...values } }, self._entity, self._key);
+});
+/**
+ * Configure cascade updates to propagate source entity changes to target entities
+ * that embed it via `DynamoModel.ref`. After the source update completes, all matching
+ * target items are queried via their cascade GSI and updated with the new domain data.
+ *
+ * Default mode is "eventual" (batch updates, no item limit).
+ * Use `mode: "transactional"` for atomic cascade (max 100 items).
+ */
+export const cascade = Fn.dual(2, (self, config) => {
+    return new EntityUpdateImpl(self._builder, { ...self._updateState, cascade: config }, self._entity, self._key);
+});
+//# sourceMappingURL=_EntityCombinators.js.map

package/dist/_EntityCombinators.js.map

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

package/dist/_EntityConfig.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @internal Entity configuration types — system field and constraint config.
+ *
+ * Extracted from Entity.ts for decomposition. Not part of the public API.
+ */
+import type { Duration, Schema } from "effect";
+/**
+ * Per-timestamp field configuration.
+ *
+ * - `string` — override field name only (default DateString schema)
+ * - `Schema.Top` — override schema only (default field name)
+ * - `{ field?, schema? }` — override both field name and schema
+ */
+export type TimestampFieldConfig = string | Schema.Top | {
+    readonly field?: string | undefined;
+    readonly schema?: Schema.Top | undefined;
+};
+/**
+ * Timestamp configuration for automatic `createdAt` / `updatedAt` fields.
+ *
+ * - `true` — add `createdAt` and `updatedAt` with default names and ISO string storage
+ * - `{ created?, updated? }` — per-field configuration (string, schema, or object)
+ * - `false` / `undefined` — no timestamps
+ */
+export type TimestampsConfig = boolean | {
+    readonly created?: TimestampFieldConfig | undefined;
+    readonly updated?: TimestampFieldConfig | undefined;
+};
+/**
+ * Optimistic locking configuration via an auto-incrementing version field.
+ *
+ * - `true` — add a `version` field with default name
+ * - `{ field?, retain?, ttl? }` — override field name and retention behavior
+ * - `false` / `undefined` — no versioning
+ */
+export type VersionedConfig = boolean | {
+    readonly field?: string | undefined;
+    readonly retain?: boolean | undefined;
+    readonly ttl?: Duration.Duration | undefined;
+};
+/**
+ * Soft-delete configuration. When enabled, deletes mark items rather than removing them.
+ *
+ * - `true` — enable soft delete with defaults
+ * - `{ ttl?, preserveUnique? }` — configure TTL cleanup and unique constraint behavior
+ * - `false` / `undefined` — hard deletes
+ */
+export type SoftDeleteConfig = boolean | {
+    readonly ttl?: Duration.Duration | undefined;
+    readonly preserveUnique?: boolean | undefined;
+};
+/** An array of model field names that together form a unique constraint. */
+export type UniqueFieldsDef = ReadonlyArray<string>;
+/**
+ * A unique constraint definition — either a simple field list or an object
+ * with additional options like TTL for sentinel items.
+ */
+export type UniqueConstraintDef = UniqueFieldsDef | {
+    readonly fields: UniqueFieldsDef;
+    readonly ttl?: Duration.Duration | undefined;
+};
+/**
+ * Map of named unique constraints. Each key is the constraint name,
+ * each value defines which fields must be globally unique together.
+ *
+ * Enforced via DynamoDB transaction sentinel items.
+ */
+export type UniqueConfig = globalThis.Record<string, UniqueConstraintDef>;
+/**
+ * Per-ref cascade index configuration. Tells Entity.make() which physical GSI
+ * to use for auto-generated cascade indexes.
+ *
+ * The library fills in the PK/SK composites automatically from the resolved ref
+ * and primary key — the consumer only specifies physical GSI details.
+ */
+export interface CascadeIndexConfig {
+    /** Physical GSI name (e.g., "gsi3") */
+    readonly index: string;
+    /** PK field descriptor */
+    readonly pk: {
+        readonly field: string;
+    };
+    /** SK field descriptor */
+    readonly sk: {
+        readonly field: string;
+    };
+}
+/**
+ * A ref value in the `refs` config — an object with the entity and optional cascade index config.
+ *
+ * Simple:    `refs: { player: { entity: Players } }`
+ * Cascade:   `refs: { player: { entity: Players, cascade: { index: "gsi3", pk: { field: "gsi3pk" }, sk: { field: "gsi3sk" } } } }`
+ */
+export interface RefValue {
+    readonly entity: {
+        readonly _tag: "Entity";
+    };
+    readonly cascade?: CascadeIndexConfig;
+}
+//# sourceMappingURL=_EntityConfig.d.ts.map

package/dist/_EntityConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_EntityConfig.d.ts","sourceRoot":"","sources":["../src/_EntityConfig.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAM9C;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,MAAM,CAAC,GAAG,GACV;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,GAAG,SAAS,CAAA;CAAE,CAAA;AAErF;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP;IACE,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAA;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAA;CACpD,CAAA;AAEL;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GACvB,OAAO,GACP;IACE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,QAAQ,GAAG,SAAS,CAAA;CAC7C,CAAA;AAEL;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP;IACE,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,QAAQ,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC9C,CAAA;AAEL,4EAA4E;AAC5E,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;AAEnD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf;IAAE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,QAAQ,GAAG,SAAS,CAAA;CAAE,CAAA;AAEtF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;AAEzE;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACvC,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAA;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAA;CACtC"}

package/dist/_EntityConfig.js

@@ -0,0 +1,7 @@
+/**
+ * @internal Entity configuration types — system field and constraint config.
+ *
+ * Extracted from Entity.ts for decomposition. Not part of the public API.
+ */
+export {};
+//# sourceMappingURL=_EntityConfig.js.map

package/dist/_EntityConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_EntityConfig.js","sourceRoot":"","sources":["../src/_EntityConfig.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}