@effect-dynamodb/schema 1.9.0

package/dist/Errors.d.ts

@@ -0,0 +1,387 @@
+import { type Option } from "effect";
+declare const DynamoError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "DynamoError";
+} & Readonly<A>;
+/** Wraps AWS SDK errors from DynamoDB operations */
+export declare class DynamoError extends DynamoError_base<{
+    readonly operation: string;
+    readonly cause: unknown;
+}> {
+}
+declare const ThrottlingError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ThrottlingError";
+} & Readonly<A>;
+/** DynamoDB throttling — request rate too high */
+export declare class ThrottlingError extends ThrottlingError_base<{
+    readonly operation: string;
+    readonly cause: unknown;
+}> {
+}
+declare const DynamoValidationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "DynamoValidationError";
+} & Readonly<A>;
+/** DynamoDB validation error — malformed request */
+export declare class DynamoValidationError extends DynamoValidationError_base<{
+    readonly operation: string;
+    readonly cause: unknown;
+}> {
+}
+declare const InternalServerError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "InternalServerError";
+} & Readonly<A>;
+/** DynamoDB internal server error — transient failure */
+export declare class InternalServerError extends InternalServerError_base<{
+    readonly operation: string;
+    readonly cause: unknown;
+}> {
+}
+declare const ResourceNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ResourceNotFoundError";
+} & Readonly<A>;
+/** DynamoDB resource not found — table doesn't exist */
+export declare class ResourceNotFoundError extends ResourceNotFoundError_base<{
+    readonly operation: string;
+    readonly cause: unknown;
+}> {
+}
+declare const ItemNotFound_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ItemNotFound";
+} & Readonly<A>;
+/** GetItem returned no item for the given key */
+export declare class ItemNotFound extends ItemNotFound_base<{
+    readonly entityType: string;
+    readonly key: Record<string, unknown>;
+}> {
+}
+declare const ConditionalCheckFailed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ConditionalCheckFailed";
+} & Readonly<A>;
+/**
+ * PutItem/DeleteItem/UpdateItem conditional check failed.
+ *
+ * On `Entity.append()` (time-series), this is surfaced when a user-supplied
+ * `condition` rejected the write while the CAS predicate held. In that case
+ * `current` is `Option.some(<decoded post-state>)` carrying the live current
+ * item snapshot read via the follow-up GetItem. For non-append paths and for
+ * append calls that opted out via `.skipFollowUp()`, `current` is omitted /
+ * `Option.none()` (no follow-up GetItem was issued).
+ *
+ * On the `.skipFollowUp()` path of `.append()`, user-condition failures cannot
+ * be distinguished from CAS failures, so they are reported as
+ * {@link StaleAppend} instead — see that error's docs.
+ */
+export declare class ConditionalCheckFailed extends ConditionalCheckFailed_base<{
+    readonly entityType: string;
+    readonly key: Record<string, unknown>;
+    readonly current?: Option.Option<unknown>;
+}> {
+}
+declare const StaleAppend_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "StaleAppend";
+} & Readonly<A>;
+/**
+ * `Entity.append()` was rejected because the CAS predicate
+ * (`attribute_not_exists(pk) OR <orderBy> < :newOrderBy`) did not hold —
+ * i.e. another writer has already advanced the current item past
+ * `attemptedOrderBy`. This is an EXPECTED outcome under newer-wins
+ * concurrency; callers typically `Effect.catchTag("StaleAppend", ...)` and
+ * treat it as a no-op.
+ *
+ * `current` carries the winning state when the follow-up GetItem ran:
+ * - `Option.some(<raw decoded item>)` on the default path.
+ * - `Option.none()` when the caller opted out via `.skipFollowUp()`.
+ *
+ * The value is typed as `unknown` because `StaleAppend` has no model
+ * generic; callers that need a typed value can decode it with the entity's
+ * record schema themselves.
+ *
+ * NOTE on the `skipFollowUp` path: a user-supplied `.condition()` failure
+ * also raises `StaleAppend` (not {@link ConditionalCheckFailed}) because no
+ * follow-up GetItem ran, so the two cancellation modes are
+ * indistinguishable. If you need the disambiguation, do not call
+ * `.skipFollowUp()`.
+ */
+export declare class StaleAppend extends StaleAppend_base<{
+    readonly entityType: string;
+    readonly orderByField: string;
+    readonly attemptedOrderBy: unknown;
+    readonly current: Option.Option<unknown>;
+}> {
+}
+declare const ValidationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ValidationError";
+} & Readonly<A>;
+/** Schema decode/encode validation failed */
+export declare class ValidationError extends ValidationError_base<{
+    readonly entityType: string;
+    readonly operation: string;
+    readonly cause: unknown;
+}> {
+}
+declare const TransactionCancelled_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "TransactionCancelled";
+} & Readonly<A>;
+/** TransactWriteItems or TransactGetItems cancelled by DynamoDB */
+export declare class TransactionCancelled extends TransactionCancelled_base<{
+    readonly operation: string;
+    readonly reasons: ReadonlyArray<{
+        readonly code?: string | undefined;
+        readonly message?: string | undefined;
+    }>;
+    readonly cause: unknown;
+}> {
+}
+declare const UniqueConstraintViolation_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "UniqueConstraintViolation";
+} & Readonly<A>;
+/** Unique constraint violation — field value already exists */
+export declare class UniqueConstraintViolation extends UniqueConstraintViolation_base<{
+    readonly entityType: string;
+    readonly constraint: string;
+    readonly fields: Record<string, string>;
+}> {
+}
+declare const OptimisticLockError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "OptimisticLockError";
+} & Readonly<A>;
+/** Optimistic concurrency conflict — item was modified since last read */
+export declare class OptimisticLockError extends OptimisticLockError_base<{
+    readonly entityType: string;
+    readonly key: Record<string, unknown>;
+    readonly expectedVersion: number;
+    readonly actualVersion: number;
+}> {
+}
+/** @internal Shape of AWS SDK TransactionCanceledException */
+export interface AwsTransactionCancelled {
+    readonly name: "TransactionCanceledException";
+    readonly CancellationReasons?: ReadonlyArray<{
+        readonly Code?: string;
+        readonly Message?: string;
+    }>;
+}
+/** @internal Shape of AWS SDK ConditionalCheckFailedException */
+export interface AwsConditionalCheckFailed {
+    readonly name: "ConditionalCheckFailedException";
+}
+/** @internal */
+export declare const isAwsTransactionCancelled: (cause: unknown) => cause is AwsTransactionCancelled;
+/** @internal */
+export declare const isAwsConditionalCheckFailed: (cause: unknown) => cause is AwsConditionalCheckFailed;
+/** @internal */
+export declare const isAwsThrottling: (cause: unknown) => boolean;
+/** @internal */
+export declare const isAwsValidationError: (cause: unknown) => boolean;
+/** @internal */
+export declare const isAwsInternalServerError: (cause: unknown) => boolean;
+/** @internal */
+export declare const isAwsResourceNotFound: (cause: unknown) => boolean;
+declare const TransactionOverflow_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "TransactionOverflow";
+} & Readonly<A>;
+/** Entity-level transactWriteItems would exceed DynamoDB's 100-item limit */
+export declare class TransactionOverflow extends TransactionOverflow_base<{
+    readonly entityType: string;
+    readonly operation: string;
+    readonly itemCount: number;
+    readonly limit: number;
+}> {
+}
+declare const RefNotFound_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "RefNotFound";
+} & Readonly<A>;
+/** Referenced entity not found during ref hydration */
+export declare class RefNotFound extends RefNotFound_base<{
+    readonly entity: string;
+    readonly field: string;
+    readonly refEntity: string;
+    readonly refId: string;
+}> {
+}
+declare const ItemDeleted_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ItemDeleted";
+} & Readonly<A>;
+/** Item is soft-deleted and cannot be modified without restore */
+export declare class ItemDeleted extends ItemDeleted_base<{
+    readonly entityType: string;
+    readonly key: Record<string, unknown>;
+    readonly deletedAt: string;
+}> {
+}
+declare const ItemNotDeleted_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ItemNotDeleted";
+} & Readonly<A>;
+/** Item is not soft-deleted — restore requires a deleted item */
+export declare class ItemNotDeleted extends ItemNotDeleted_base<{
+    readonly entityType: string;
+    readonly key: Record<string, unknown>;
+}> {
+}
+declare const AggregateAssemblyError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "AggregateAssemblyError";
+} & Readonly<A>;
+/** Aggregate assembly failed — missing items, structural violations, or decode errors */
+export declare class AggregateAssemblyError extends AggregateAssemblyError_base<{
+    readonly aggregate: string;
+    readonly reason: string;
+    readonly key: Record<string, unknown>;
+}> {
+}
+declare const AggregateDecompositionError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "AggregateDecompositionError";
+} & Readonly<A>;
+/** Aggregate decomposition failed — schema validation or structural error during write path */
+export declare class AggregateDecompositionError extends AggregateDecompositionError_base<{
+    readonly aggregate: string;
+    readonly member: string;
+    readonly reason: string;
+}> {
+}
+declare const AggregateTransactionOverflow_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "AggregateTransactionOverflow";
+} & Readonly<A>;
+/** Sub-aggregate exceeds DynamoDB's 100-item transaction limit */
+export declare class AggregateTransactionOverflow extends AggregateTransactionOverflow_base<{
+    readonly aggregate: string;
+    readonly subgraph: string;
+    readonly itemCount: number;
+    readonly limit: number;
+}> {
+}
+declare const CascadePartialFailure_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "CascadePartialFailure";
+} & Readonly<A>;
+/** Cascade update partially failed (eventual mode) */
+export declare class CascadePartialFailure extends CascadePartialFailure_base<{
+    readonly sourceEntity: string;
+    readonly sourceId: string;
+    readonly succeeded: number;
+    readonly failed: number;
+    readonly errors: ReadonlyArray<unknown>;
+}> {
+}
+declare const VersionConflict_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "VersionConflict";
+} & Readonly<A>;
+/** Optimistic concurrency conflict — stream version did not match */
+export declare class VersionConflict extends VersionConflict_base<{
+    readonly streamName: string;
+    readonly streamId: string;
+    readonly expectedVersion: number;
+}> {
+}
+declare const CompositeKeyHoleError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "CompositeKeyHoleError";
+} & Readonly<A>;
+/**
+ * EDD-9024 — DEPRECATED in v1.7.1.
+ *
+ * @deprecated Since v1.7.1, this error is no longer thrown at runtime. It is
+ *   kept as an exported class for back-compat with consumers who type-imported
+ *   it (e.g. inside `Effect.catchTag("CompositeKeyHoleError", ...)` blocks).
+ *   No code path constructs or throws this error anymore.
+ *
+ * **Why deprecated.** v1.7.0's "throw under preserve on hole pattern" was a
+ * defensive runtime safety net for a case the type system already catches:
+ * required composites can't be omitted under `exactOptionalPropertyTypes`
+ * since v1.7.0 reverted the v1.6 NullishOr widening. The only remaining
+ * runtime "hole" shape is "optional leading composite absent + present
+ * trailing composite," which is a normal write the consumer expressly chose.
+ *
+ * **What replaces it.** Hole patterns now collapse into the unified per-half
+ * can't-compose rule:
+ * - `'sparse'` half → REMOVE that half's key (drops the half).
+ * - `'preserve'` half + composite of the half is in `Entity.remove([...])`
+ *   → REMOVE that half's key (cascade override fires).
+ * - `'preserve'` half + no composite in `Entity.remove([...])` → noop (the
+ *   stored key is left untouched; may be stale until the next write that
+ *   touches the half supplies enough composites to recompose, or an
+ *   `Entity.remove` cascade fires).
+ *
+ * See `DESIGN.md §7 Policy-Aware GSI Composition` (v1.7.1 unified rule).
+ *
+ * **Migration.** Remove any `Effect.catchTag("CompositeKeyHoleError", ...)`
+ * handlers — the throw site is gone and the catch is dead code. If you were
+ * relying on the throw to detect bad payloads, switch to declaring the
+ * relevant GSI half as `'sparse'` (the consumer-side semantic that always
+ * matches the throw's intent — drop the index entry on can't-compose) or
+ * supply the surviving composites via `set` in the same update.
+ */
+export declare class CompositeKeyHoleError extends CompositeKeyHoleError_base<{
+    readonly entityType: string;
+    readonly indexName: string;
+    readonly clearedComposite: string;
+    readonly trailingComposite: string;
+    readonly clearedPosition: number;
+    readonly trailingPosition: number;
+    /** Which GSI key attribute the hole is in — `"pk"` (gsiNpk) or `"sk"` (gsiNsk). */
+    readonly key: "pk" | "sk";
+    /** Human-readable description, prefixed with `EDD-9024`. */
+    readonly message: string;
+}> {
+}
+/**
+ * Build a {@link CompositeKeyHoleError} with a formatted message.
+ *
+ * @deprecated Since v1.7.1 this builder is unused — no code path raises EDD-9024
+ *   at runtime. Kept exported only for back-compat with consumers who imported
+ *   the helper. See {@link CompositeKeyHoleError} for the migration path.
+ */
+export declare const makeCompositeKeyHoleError: (params: {
+    readonly entityType: string;
+    readonly indexName: string;
+    readonly clearedComposite: string;
+    readonly trailingComposite: string;
+    readonly clearedPosition: number;
+    readonly trailingPosition: number;
+    readonly key: "pk" | "sk";
+}) => CompositeKeyHoleError;
+declare const CompositeNullableError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "CompositeNullableError";
+} & Readonly<A>;
+/**
+ * EDD-9025 — A composite attribute on `primaryKey`, `indexes`, or a `unique`
+ * constraint has a Schema whose type union includes `null`. Composites
+ * participate in string composition (`acc#X#alert#Y`); `null` is not a
+ * meaningful slot value — only present-with-value or absent. Allowing
+ * `Schema.NullOr` / `Schema.NullishOr` / `Schema.Union([..., Schema.Null])`
+ * on a composite would let `set({ composite: null })` typecheck, then either
+ * blow up at runtime or silently produce a key with the literal string
+ * `"null"` as a slot.
+ *
+ * Raised at `Entity.make()` time. The error names the entity, the
+ * surface where the composite is declared (primary key / a GSI / a unique
+ * constraint), the offending composite attribute, and the resolved Schema
+ * path that contains `null`.
+ *
+ * Resolution: declare the attribute as `Schema.optional(...)` (which
+ * produces `T | undefined` without `null`). Sparse-pattern usage is fully
+ * supported under v3's two-way payload classification — `undefined` is
+ * "absent" for GSI composition purposes.
+ *
+ * See `DESIGN.md §7 Policy-Aware GSI Composition` (EDD-9025 footgun gate).
+ */
+export declare class CompositeNullableError extends CompositeNullableError_base<{
+    readonly entityType: string;
+    /** "primaryKey" | "index:<name>" | "unique:<name>" */
+    readonly surface: string;
+    readonly compositeAttribute: string;
+    /** Resolved schema path that revealed the `null` branch. */
+    readonly schemaPath: string;
+    /** Human-readable description, prefixed with `EDD-9025`. */
+    readonly message: string;
+}> {
+}
+/**
+ * Build a {@link CompositeNullableError} with a formatted message. Centralises
+ * the message format so call sites (Entity.make validation paths) stay
+ * consistent.
+ */
+export declare const makeCompositeNullableError: (params: {
+    readonly entityType: string;
+    readonly surface: string;
+    readonly compositeAttribute: string;
+    readonly schemaPath: string;
+}) => CompositeNullableError;
+export {};
+//# sourceMappingURL=Errors.d.ts.map

package/dist/Errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.d.ts","sourceRoot":"","sources":["../src/Errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAA;;;;AAE1C,oDAAoD;AACpD,qBAAa,WAAY,SAAQ,iBAAgC;IAC/D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;CAAG;;;;AAEL,kDAAkD;AAClD,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;CAAG;;;;AAEL,oDAAoD;AACpD,qBAAa,qBAAsB,SAAQ,2BAA0C;IACnF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;CAAG;;;;AAEL,yDAAyD;AACzD,qBAAa,mBAAoB,SAAQ,yBAAwC;IAC/E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;CAAG;;;;AAEL,wDAAwD;AACxD,qBAAa,qBAAsB,SAAQ,2BAA0C;IACnF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;CAAG;;;;AAEL,iDAAiD;AACjD,qBAAa,YAAa,SAAQ,kBAAiC;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACtC,CAAC;CAAG;;;;AAEL;;;;;;;;;;;;;GAaG;AACH,qBAAa,sBAAuB,SAAQ,4BAA2C;IACrF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;CAC1C,CAAC;CAAG;;;;AAEL;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAY,SAAQ,iBAAgC;IAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;CACzC,CAAC;CAAG;;;;AAEL,6CAA6C;AAC7C,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;CAAG;;;;AAEL,mEAAmE;AACnE,qBAAa,oBAAqB,SAAQ,0BAAyC;IACjF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACtC,CAAC,CAAA;IACF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;CAAG;;;;AAEL,+DAA+D;AAC/D,qBAAa,yBAA0B,SAAQ,+BAA8C;IAC3F,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC,CAAC;CAAG;;;;AAEL,0EAA0E;AAC1E,qBAAa,mBAAoB,SAAQ,yBAAwC;IAC/E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B,CAAC;CAAG;AAML,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAA;IAC7C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,aAAa,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAC1B,CAAC,CAAA;CACH;AAED,iEAAiE;AACjE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,iCAAiC,CAAA;CACjD;AAED,gBAAgB;AAChB,eAAO,MAAM,yBAAyB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,uBAIE,CAAA;AAEtE,gBAAgB;AAChB,eAAO,MAAM,2BAA2B,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,yBAIG,CAAA;AAEzE,gBAAgB;AAChB,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,OAKiC,CAAA;AAElF,gBAAgB;AAChB,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,OAIM,CAAA;AAE5D,gBAAgB;AAChB,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,OAIE,CAAA;AAE5D,gBAAgB;AAChB,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,OAIW,CAAA;;;;AAElE,6EAA6E;AAC7E,qBAAa,mBAAoB,SAAQ,yBAAwC;IAC/E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB,CAAC;CAAG;;;;AAEL,uDAAuD;AACvD,qBAAa,WAAY,SAAQ,iBAAgC;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB,CAAC;CAAG;;;;AAEL,kEAAkE;AAClE,qBAAa,WAAY,SAAQ,iBAAgC;IAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B,CAAC;CAAG;;;;AAEL,iEAAiE;AACjE,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACtC,CAAC;CAAG;;;;AAEL,yFAAyF;AACzF,qBAAa,sBAAuB,SAAQ,4BAA2C;IACrF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACtC,CAAC;CAAG;;;;AAEL,+FAA+F;AAC/F,qBAAa,2BAA4B,SAAQ,iCAAgD;IAC/F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB,CAAC;CAAG;;;;AAEL,kEAAkE;AAClE,qBAAa,4BAA6B,SAAQ,kCAAiD;IACjG,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB,CAAC;CAAG;;;;AAEL,sDAAsD;AACtD,qBAAa,qBAAsB,SAAQ,2BAA0C;IACnF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;CACxC,CAAC;CAAG;;;;AAEL,qEAAqE;AACrE,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CACjC,CAAC;CAAG;;;;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,qBAAsB,SAAQ,2BAA0C;IACnF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,mFAAmF;IACnF,QAAQ,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAAA;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAC;CAAG;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,QAAQ;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAAA;CAC1B,KAAG,qBASA,CAAA;;;;AAEJ;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,sBAAuB,SAAQ,4BAA2C;IACrF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAC;CAAG;AAEL;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B,KAAG,sBASA,CAAA"}

package/dist/Errors.js

@@ -0,0 +1,218 @@
+import { Data } from "effect";
+/** Wraps AWS SDK errors from DynamoDB operations */
+export class DynamoError extends Data.TaggedError("DynamoError") {
+}
+/** DynamoDB throttling — request rate too high */
+export class ThrottlingError extends Data.TaggedError("ThrottlingError") {
+}
+/** DynamoDB validation error — malformed request */
+export class DynamoValidationError extends Data.TaggedError("DynamoValidationError") {
+}
+/** DynamoDB internal server error — transient failure */
+export class InternalServerError extends Data.TaggedError("InternalServerError") {
+}
+/** DynamoDB resource not found — table doesn't exist */
+export class ResourceNotFoundError extends Data.TaggedError("ResourceNotFoundError") {
+}
+/** GetItem returned no item for the given key */
+export class ItemNotFound extends Data.TaggedError("ItemNotFound") {
+}
+/**
+ * PutItem/DeleteItem/UpdateItem conditional check failed.
+ *
+ * On `Entity.append()` (time-series), this is surfaced when a user-supplied
+ * `condition` rejected the write while the CAS predicate held. In that case
+ * `current` is `Option.some(<decoded post-state>)` carrying the live current
+ * item snapshot read via the follow-up GetItem. For non-append paths and for
+ * append calls that opted out via `.skipFollowUp()`, `current` is omitted /
+ * `Option.none()` (no follow-up GetItem was issued).
+ *
+ * On the `.skipFollowUp()` path of `.append()`, user-condition failures cannot
+ * be distinguished from CAS failures, so they are reported as
+ * {@link StaleAppend} instead — see that error's docs.
+ */
+export class ConditionalCheckFailed extends Data.TaggedError("ConditionalCheckFailed") {
+}
+/**
+ * `Entity.append()` was rejected because the CAS predicate
+ * (`attribute_not_exists(pk) OR <orderBy> < :newOrderBy`) did not hold —
+ * i.e. another writer has already advanced the current item past
+ * `attemptedOrderBy`. This is an EXPECTED outcome under newer-wins
+ * concurrency; callers typically `Effect.catchTag("StaleAppend", ...)` and
+ * treat it as a no-op.
+ *
+ * `current` carries the winning state when the follow-up GetItem ran:
+ * - `Option.some(<raw decoded item>)` on the default path.
+ * - `Option.none()` when the caller opted out via `.skipFollowUp()`.
+ *
+ * The value is typed as `unknown` because `StaleAppend` has no model
+ * generic; callers that need a typed value can decode it with the entity's
+ * record schema themselves.
+ *
+ * NOTE on the `skipFollowUp` path: a user-supplied `.condition()` failure
+ * also raises `StaleAppend` (not {@link ConditionalCheckFailed}) because no
+ * follow-up GetItem ran, so the two cancellation modes are
+ * indistinguishable. If you need the disambiguation, do not call
+ * `.skipFollowUp()`.
+ */
+export class StaleAppend extends Data.TaggedError("StaleAppend") {
+}
+/** Schema decode/encode validation failed */
+export class ValidationError extends Data.TaggedError("ValidationError") {
+}
+/** TransactWriteItems or TransactGetItems cancelled by DynamoDB */
+export class TransactionCancelled extends Data.TaggedError("TransactionCancelled") {
+}
+/** Unique constraint violation — field value already exists */
+export class UniqueConstraintViolation extends Data.TaggedError("UniqueConstraintViolation") {
+}
+/** Optimistic concurrency conflict — item was modified since last read */
+export class OptimisticLockError extends Data.TaggedError("OptimisticLockError") {
+}
+/** @internal */
+export const isAwsTransactionCancelled = (cause) => cause != null &&
+    typeof cause === "object" &&
+    "name" in cause &&
+    cause.name === "TransactionCanceledException";
+/** @internal */
+export const isAwsConditionalCheckFailed = (cause) => cause != null &&
+    typeof cause === "object" &&
+    "name" in cause &&
+    cause.name === "ConditionalCheckFailedException";
+/** @internal */
+export const isAwsThrottling = (cause) => cause != null &&
+    typeof cause === "object" &&
+    "name" in cause &&
+    (cause.name === "ThrottlingException" ||
+        cause.name === "ProvisionedThroughputExceededException");
+/** @internal */
+export const isAwsValidationError = (cause) => cause != null &&
+    typeof cause === "object" &&
+    "name" in cause &&
+    cause.name === "ValidationException";
+/** @internal */
+export const isAwsInternalServerError = (cause) => cause != null &&
+    typeof cause === "object" &&
+    "name" in cause &&
+    cause.name === "InternalServerError";
+/** @internal */
+export const isAwsResourceNotFound = (cause) => cause != null &&
+    typeof cause === "object" &&
+    "name" in cause &&
+    cause.name === "ResourceNotFoundException";
+/** Entity-level transactWriteItems would exceed DynamoDB's 100-item limit */
+export class TransactionOverflow extends Data.TaggedError("TransactionOverflow") {
+}
+/** Referenced entity not found during ref hydration */
+export class RefNotFound extends Data.TaggedError("RefNotFound") {
+}
+/** Item is soft-deleted and cannot be modified without restore */
+export class ItemDeleted extends Data.TaggedError("ItemDeleted") {
+}
+/** Item is not soft-deleted — restore requires a deleted item */
+export class ItemNotDeleted extends Data.TaggedError("ItemNotDeleted") {
+}
+/** Aggregate assembly failed — missing items, structural violations, or decode errors */
+export class AggregateAssemblyError extends Data.TaggedError("AggregateAssemblyError") {
+}
+/** Aggregate decomposition failed — schema validation or structural error during write path */
+export class AggregateDecompositionError extends Data.TaggedError("AggregateDecompositionError") {
+}
+/** Sub-aggregate exceeds DynamoDB's 100-item transaction limit */
+export class AggregateTransactionOverflow extends Data.TaggedError("AggregateTransactionOverflow") {
+}
+/** Cascade update partially failed (eventual mode) */
+export class CascadePartialFailure extends Data.TaggedError("CascadePartialFailure") {
+}
+/** Optimistic concurrency conflict — stream version did not match */
+export class VersionConflict extends Data.TaggedError("VersionConflict") {
+}
+/**
+ * EDD-9024 — DEPRECATED in v1.7.1.
+ *
+ * @deprecated Since v1.7.1, this error is no longer thrown at runtime. It is
+ *   kept as an exported class for back-compat with consumers who type-imported
+ *   it (e.g. inside `Effect.catchTag("CompositeKeyHoleError", ...)` blocks).
+ *   No code path constructs or throws this error anymore.
+ *
+ * **Why deprecated.** v1.7.0's "throw under preserve on hole pattern" was a
+ * defensive runtime safety net for a case the type system already catches:
+ * required composites can't be omitted under `exactOptionalPropertyTypes`
+ * since v1.7.0 reverted the v1.6 NullishOr widening. The only remaining
+ * runtime "hole" shape is "optional leading composite absent + present
+ * trailing composite," which is a normal write the consumer expressly chose.
+ *
+ * **What replaces it.** Hole patterns now collapse into the unified per-half
+ * can't-compose rule:
+ * - `'sparse'` half → REMOVE that half's key (drops the half).
+ * - `'preserve'` half + composite of the half is in `Entity.remove([...])`
+ *   → REMOVE that half's key (cascade override fires).
+ * - `'preserve'` half + no composite in `Entity.remove([...])` → noop (the
+ *   stored key is left untouched; may be stale until the next write that
+ *   touches the half supplies enough composites to recompose, or an
+ *   `Entity.remove` cascade fires).
+ *
+ * See `DESIGN.md §7 Policy-Aware GSI Composition` (v1.7.1 unified rule).
+ *
+ * **Migration.** Remove any `Effect.catchTag("CompositeKeyHoleError", ...)`
+ * handlers — the throw site is gone and the catch is dead code. If you were
+ * relying on the throw to detect bad payloads, switch to declaring the
+ * relevant GSI half as `'sparse'` (the consumer-side semantic that always
+ * matches the throw's intent — drop the index entry on can't-compose) or
+ * supply the surviving composites via `set` in the same update.
+ */
+export class CompositeKeyHoleError extends Data.TaggedError("CompositeKeyHoleError") {
+}
+/**
+ * Build a {@link CompositeKeyHoleError} with a formatted message.
+ *
+ * @deprecated Since v1.7.1 this builder is unused — no code path raises EDD-9024
+ *   at runtime. Kept exported only for back-compat with consumers who imported
+ *   the helper. See {@link CompositeKeyHoleError} for the migration path.
+ */
+export const makeCompositeKeyHoleError = (params) => new CompositeKeyHoleError({
+    ...params,
+    message: `[EDD-9024 — DEPRECATED] Composite key hole on GSI "${params.indexName}" of entity "${params.entityType}": ` +
+        `composite "${params.clearedComposite}" at ${params.key} position ${params.clearedPosition} is absent, ` +
+        `but composite "${params.trailingComposite}" at ${params.key} position ${params.trailingPosition} is still present. ` +
+        `Since v1.7.1 this error is no longer thrown — hole patterns collapse into the unified per-half can't-compose rule ` +
+        `(REMOVE the half under 'sparse' or removedSet cascade; noop under 'preserve' without removedSet).`,
+});
+/**
+ * EDD-9025 — A composite attribute on `primaryKey`, `indexes`, or a `unique`
+ * constraint has a Schema whose type union includes `null`. Composites
+ * participate in string composition (`acc#X#alert#Y`); `null` is not a
+ * meaningful slot value — only present-with-value or absent. Allowing
+ * `Schema.NullOr` / `Schema.NullishOr` / `Schema.Union([..., Schema.Null])`
+ * on a composite would let `set({ composite: null })` typecheck, then either
+ * blow up at runtime or silently produce a key with the literal string
+ * `"null"` as a slot.
+ *
+ * Raised at `Entity.make()` time. The error names the entity, the
+ * surface where the composite is declared (primary key / a GSI / a unique
+ * constraint), the offending composite attribute, and the resolved Schema
+ * path that contains `null`.
+ *
+ * Resolution: declare the attribute as `Schema.optional(...)` (which
+ * produces `T | undefined` without `null`). Sparse-pattern usage is fully
+ * supported under v3's two-way payload classification — `undefined` is
+ * "absent" for GSI composition purposes.
+ *
+ * See `DESIGN.md §7 Policy-Aware GSI Composition` (EDD-9025 footgun gate).
+ */
+export class CompositeNullableError extends Data.TaggedError("CompositeNullableError") {
+}
+/**
+ * Build a {@link CompositeNullableError} with a formatted message. Centralises
+ * the message format so call sites (Entity.make validation paths) stay
+ * consistent.
+ */
+export const makeCompositeNullableError = (params) => new CompositeNullableError({
+    ...params,
+    message: `[EDD-9025] Entity "${params.entityType}": composite attribute "${params.compositeAttribute}" ` +
+        `on ${params.surface} resolves to a Schema that includes \`null\` (${params.schemaPath}). ` +
+        `Composites participate in string composition and cannot be null — only present-with-value or absent. ` +
+        `Replace the nullable wrapper with \`Schema.optional(...)\` (T | undefined) to express the sparse ` +
+        `pattern, or supply a non-nullable schema for "${params.compositeAttribute}".`,
+});
+//# sourceMappingURL=Errors.js.map

package/dist/Errors.js.map

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