qstd 0.2.27 → 0.2.28

package/README.md

@@ -20,6 +20,58 @@ A single npm package providing:
 pnpm add qstd
 ```
 
+## Prerequisites
+
+### TypeScript Configuration (Required)
+
+To use subpath imports like `qstd/server`, `qstd/client`, or `qstd/react`, your `tsconfig.json` **must** use a modern module resolution strategy:
+
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "bundler"
+  }
+}
+```
+
+**Valid options:** `"bundler"`, `"node16"`, or `"nodenext"`
+
+#### Why is this required?
+
+This package uses the **`exports`** field in `package.json` to define subpath exports:
+
+```json
+{
+  "exports": {
+    "./react": { "types": "...", "import": "..." },
+    "./client": { "types": "...", "import": "..." },
+    "./server": { "types": "...", "import": "..." },
+    "./preset": { "types": "...", "import": "..." }
+  }
+}
+```
+
+The `exports` field is the modern Node.js way to define multiple entry points for a package. It allows a single package to expose different modules at different paths (e.g., `qstd/server` vs `qstd/client`) with proper type definitions for each.
+
+**The problem:** The older `"moduleResolution": "node"` (also called "node10") setting predates the `exports` field and does not understand it. TypeScript will fail to resolve the types:
+
+```
+Cannot find module 'qstd/server' or its corresponding type declarations.
+  There are types at '.../node_modules/qstd/dist/server/index.d.ts', but this result 
+  could not be resolved under your current 'moduleResolution' setting.
+```
+
+**The fix:** Use `"moduleResolution": "bundler"` which understands the `exports` field. This is the recommended setting for projects using modern bundlers like Vite, esbuild, or webpack 5+.
+
+#### Quick Reference
+
+| moduleResolution | Supports `exports` | Use Case |
+|-----------------|-------------------|----------|
+| `"node"` / `"node10"` | ❌ No | Legacy projects |
+| `"node16"` | ✅ Yes | Node.js 16+ with ESM |
+| `"nodenext"` | ✅ Yes | Latest Node.js features |
+| `"bundler"` | ✅ Yes | **Recommended** for bundled apps |
+
 ## Usage
 
 ### React (Block + Hooks)

package/dist/server/aws/ddb/domain.d.ts

@@ -0,0 +1,257 @@
+import { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
+import * as _t from "./types";
+export type Client = ReturnType<typeof create>;
+export declare const create: (props?: {
+    credentials?: _t.Credentials;
+    tableName: string;
+}) => {
+    client: DynamoDBDocumentClient;
+    tableName: string | undefined;
+};
+/**
+ * Query or Scan DynamoDB with type-safe filters and modern API
+ * @param ddb - DynamoDB client
+ * @param props - Query/Scan properties
+ * @returns Items array by default; use `first` and `raw` flags to customize
+ *
+ * @example
+ * // Get items array (default)
+ * const items = await find<User>(doc, {
+ *   tableName: 'users',
+ *   pk: { value: 'user#123' }
+ * });
+ * // items: User[]
+ *
+ * @example
+ * // Get first item
+ * const user = await find<User>(doc, {
+ *   tableName: 'users',
+ *   pk: { value: 'user#123' },
+ *   first: true,
+ * }); // user: User | undefined
+ *
+ * @example
+ * // Get full response with metadata
+ * const result = await find<User>(doc, {
+ *   tableName: 'users',
+ *   pk: { value: 'user#123' },
+ *   raw: true,
+ * }); // result: RawResponse<User>
+ *
+ * @example
+ * // Type-safe filters with modern API
+ * const active = await find<User>(doc, {
+ *   tableName: 'users',
+ *   pk: { value: 'org#456' },
+ *   sk: { op: 'begins_with', value: 'user#' },
+ *   filters: [
+ *     { key: 'status', op: '=', value: 'active' },
+ *     { key: 'score', op: '>', value: 80 },
+ *     { key: 'email', op: 'attribute_exists' }
+ *   ],
+ *   sort: 'desc',
+ *   strong: true,
+ * }); // active: User[]
+ *
+ * @example
+ * // Scan mode - no pk/sk required, can filter on any attribute
+ * const allActive = await find<User>(doc, {
+ *   tableName: 'users',
+ *   scan: true,
+ *   filters: [
+ *     { key: 'pk', op: 'begins_with', value: 'user#' },
+ *     { key: 'status', op: '=', value: 'active' },
+ *   ],
+ *   recursive: true,
+ *   maxItems: 1000,
+ * }); // allActive: User[]
+ */
+export declare function find<T extends object = Record<string, unknown>>(ddb: Client, props: _t.FindProps<T> & {
+    first: true;
+    raw: true;
+}): Promise<{
+    item: T | undefined;
+    count: number;
+    scannedCount: number;
+}>;
+export declare function find<T extends object = Record<string, unknown>>(ddb: Client, props: _t.FindProps<T> & {
+    raw: true;
+}): Promise<_t.RawResponse<T>>;
+export declare function find<T extends object = Record<string, unknown>>(ddb: Client, props: _t.FindProps<T> & {
+    /** Return the first item from the items array */ first: true;
+}): Promise<T | undefined>;
+export declare function find<T extends object = Record<string, unknown>>(ddb: Client, props: _t.FindProps<T>): Promise<T[]>;
+export declare const remove: (ddb: Client, props: {
+    key: _t.Key;
+    tableName?: string;
+}) => Promise<import("@aws-sdk/lib-dynamodb").DeleteCommandOutput>;
+/** * Create or overwrite an item
+ * @param ddb
+ * @param item
+ * @param opts
+ * @returns
+ */
+export declare const save: <T extends object>(ddb: Client, props: {
+    tableName?: string;
+    item: T;
+}) => Promise<import("@aws-sdk/lib-dynamodb").PutCommandOutput>;
+/**
+ * Batch get multiple items from DynamoDB
+ *
+ * ## Limits
+ * - Max items per request: 100
+ * - Max request size: 16MB
+ * - Read capacity: 0.5 RCU per item (eventually consistent), 1 RCU (strongly consistent)
+ *
+ * @example
+ * const result = await batchGet(ddb, {
+ * tableName: 'users',
+ * keys: [{ pk: 'user#1', sk: 'profile' }, { pk: 'user#2', sk: 'profile' }]
+ * });
+ * console.log(`Retrieved: ${result.count}, Missing: ${result.missing}`);
+ * const users = result.items;
+ */
+export declare function batchGet<T extends Record<string, unknown>>(ddb: Client, props: {
+    tableName: string;
+    keys: {
+        pk: string;
+        sk?: string;
+    }[];
+    maxRetries?: number;
+    strong?: boolean;
+}): Promise<_t.BatchGetResult<T>>;
+/**
+ * Batch write (put) multiple items to DynamoDB
+ *
+ * ## Operation Mode
+ * - **Without conditions**: Uses BatchWriteCommand (cheaper, faster)
+ * - Max items: 25 per request
+ * - Max size: 16MB per request
+ * - Cost: 1 WCU per item
+ * - Not atomic
+ *
+ * - **With conditions**: Auto-switches to TransactWriteCommand (atomic, safer)
+ * - Max items: 100 per request (4x better!)
+ * - Max size: 4MB per request
+ * - Cost: 2 WCU per item (2x more expensive)
+ * - Atomic: all succeed or all fail
+ *
+ * @example
+ * // Simple usage
+ * const result = await batchWrite(ddb, {
+ *   tableName: 'users',
+ *   items: [
+ *     { item: { pk: 'user#1', sk: 'profile', name: 'Alice' } },
+ *     { item: { pk: 'user#2', sk: 'profile', name: 'Bob' } }
+ *   ]
+ * });
+ * console.log(`Processed: ${result.processed}, Failed: ${result.failed}`);
+ *
+ * @example
+ * // With transform - avoid manual mapping
+ * const result = await batchWrite(ddb, {
+ *   tableName: 'users',
+ *   items: users,
+ *   transform: (user) => ({ item: user })
+ * });
+ *
+ * @example
+ * // With conditions (auto-switches to transact)
+ * const result = await batchWrite(ddb, {
+ *   tableName: 'users',
+ *   items: [
+ *     { item: user1, cond: 'attribute_not_exists(pk)' },
+ *     { item: user2, cond: 'version = :v1' }
+ *   ]
+ * });
+ */
+export declare function batchWrite<T extends Record<string, unknown>>(ddb: Client, props: {
+    tableName: string;
+    items: {
+        item: T;
+        cond?: string;
+    }[];
+    maxRetries?: number;
+}): Promise<_t.BatchWriteResult>;
+export declare function batchWrite<T extends Record<string, unknown>, I>(ddb: Client, props: {
+    tableName: string;
+    items: I[];
+    transform: (item: I) => {
+        item: T;
+        cond?: string;
+    };
+    maxRetries?: number;
+}): Promise<_t.BatchWriteResult>;
+/**
+ * Batch delete multiple items from DynamoDB
+ *
+ * ## Operation Mode
+ * - **Without conditions**: Uses BatchWriteCommand (cheaper, faster)
+ * - Max items: 25 per request
+ * - Max size: 16MB per request
+ * - Cost: 1 WCU per item
+ * - Not atomic
+ *
+ * - **With conditions**: Auto-switches to TransactWriteCommand (atomic, safer)
+ * - Max items: 100 per request (4x better!)
+ * - Max size: 4MB per request
+ * - Cost: 2 WCU per item (2x more expensive)
+ * - Atomic: all succeed or all fail
+ *
+ * @example
+ * const result = await batchDelete(ddb, {
+ * tableName: 'users',
+ * keys: [
+ * { key: { pk: 'user#1', sk: 'profile' } },
+ * { key: { pk: 'user#2', sk: 'profile' } }
+ * ]
+ * });
+ *
+ * console.log(`Deleted: ${result.processed}, Failed: ${result.failed}`);
+ *
+ * @example
+ * // With transform - avoid manual mapping
+ * const result = await batchDelete(ddb, {
+ * tableName: 'users',
+ * keys: [{ pk: 'user#1', sk: 'profile' }, { pk: 'user#2', sk: 'profile' }],
+ * transform: (key) => ({ key })
+ * });
+ *
+ * @example
+ * // With conditions (auto-switches to transact)
+ * const result = await batchDelete(ddb, {
+ * tableName: 'users',
+ * keys: [
+ * { key: { pk: 'user#1', sk: 'profile' }, cond: 'attribute_exists(pk)' },
+ * { key: { pk: 'user#2', sk: 'profile' }, cond: 'version = :v1' }
+ * ]
+ * });
+ */
+export declare function batchDelete(ddb: Client, props: {
+    tableName: string;
+    keys: Array<{
+        key: _t.Key;
+        cond?: string;
+    }>;
+    maxRetries?: number;
+}): Promise<_t.BatchDeleteResult>;
+export declare function batchDelete<I>(ddb: Client, props: {
+    tableName: string;
+    keys: I[];
+    transform: (item: I) => {
+        key: _t.Key;
+        cond?: string;
+    };
+    maxRetries?: number;
+}): Promise<_t.BatchDeleteResult>;
+export declare const deleteTable: (ddb: Client, tableName: string) => Promise<import("@aws-sdk/client-dynamodb").DeleteTableCommandOutput>;
+/**
+ * Check if a dynamodb table exists.
+ * @param doc
+ * @param TableName
+ * @returns
+ */
+export declare const tableExists: (ddb: Client, props: {
+    tableName: string;
+}) => Promise<boolean>;
+//# sourceMappingURL=domain.d.ts.map

package/dist/server/aws/ddb/domain.d.ts.map

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

package/dist/server/aws/ddb/fns.d.ts

@@ -0,0 +1,25 @@
+import type { NativeAttributeValue } from "@aws-sdk/lib-dynamodb";
+import * as _t from "./types";
+export declare const validateFindProps: <T extends object = Record<string, unknown>>(props: _t.FindProps<T> & {
+    first?: boolean;
+    raw?: boolean;
+}) => void;
+export declare const buildKeyConditionExpression: (pk: {
+    key?: string;
+    value: string;
+}, sk: _t.SkCond | undefined, names: Record<string, string>, values: Record<string, NativeAttributeValue>) => string;
+export declare const buildFilterExpression: <T extends object>(filters: ReadonlyArray<_t.FilterClause<T>>, names: Record<string, string>, values: Record<string, NativeAttributeValue>) => string | undefined;
+export declare const buildProjectionExpression: <T>(projection: (keyof T)[], names: Record<string, string>) => string;
+/**
+ * Sleep for exponential backoff
+ */
+export declare const sleep: (ms: number) => Promise<unknown>;
+/**
+ * Calculate backoff delay for retries
+ */
+export declare const backoffDelay: (attempt: number) => number;
+/**
+ * Chunk an array into smaller arrays of specified size
+ */
+export declare const chunk: <T>(arr: T[], size: number) => T[][];
+//# sourceMappingURL=fns.d.ts.map

package/dist/server/aws/ddb/fns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fns.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/ddb/fns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1E,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,SA6B5D,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,IAAI;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EACnC,IAAI,EAAE,CAAC,MAAM,GAAG,SAAS,EACzB,OAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,QAAQ,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,WAoD7C,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,MAAM,EACpD,SAAS,aAAa,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAC1C,OAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,QAAQ,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,uBAoE7C,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,CAAC,EACzC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,EACvB,OAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,WAQ9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,qBACmB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,MAE9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,MAAM,KAAG,CAAC,EAAE,EAIpD,CAAC"}

package/dist/server/aws/ddb/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./domain";
+export * from "./literals";
+export type { Key } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/aws/ddb/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/ddb/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC"}

package/dist/server/aws/ddb/literals.d.ts

@@ -0,0 +1,30 @@
+/**
+ * these 2 lsis should solve all future lsis. Lsi can be a
+ * generic type that has different sk based on the pk.
+ * E.g. pkUser can store username in lsi and pkDocument
+ * can store id. By lsi being a generic field, can serve
+ * the role of multiple lsis.
+ */
+export declare const lsi: {
+    readonly name: "lsi";
+    readonly sk: "lsi";
+};
+export declare const lsi2: {
+    readonly name: "lsi2";
+    readonly sk: "lsi2";
+};
+export declare const lsiUsername: {
+    readonly name: "username-lsi";
+    readonly sk: "username";
+};
+export declare const lsiNormalized: {
+    /** use in index_name */
+    readonly name: "normalized-lsi";
+    readonly sk: "normalized";
+};
+export declare const lsiPhash: {
+    /** use in index_name */
+    readonly name: "phash-lsi";
+    readonly sk: "phash";
+};
+//# sourceMappingURL=literals.d.ts.map

package/dist/server/aws/ddb/literals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"literals.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/ddb/literals.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,GAAG;;;CAAsC,CAAC;AACvD,eAAO,MAAM,IAAI;;;CAAwC,CAAC;AAE1D,eAAO,MAAM,WAAW;;;CAGd,CAAC;AAGX,eAAO,MAAM,aAAa;IACxB,wBAAwB;;;CAGhB,CAAC;AAGX,eAAO,MAAM,QAAQ;IACnB,wBAAwB;;;CAGhB,CAAC"}

package/dist/server/aws/ddb/types.d.ts

@@ -0,0 +1,216 @@
+import type { NativeAttributeValue } from "@aws-sdk/lib-dynamodb";
+import type { DynamoDBClient, DynamoDBClientConfig } from "@aws-sdk/client-dynamodb";
+export type TableClient = DynamoDBClient;
+export type Credentials = DynamoDBClientConfig["credentials"];
+export type Key = {
+    pk: Pk;
+    sk: Sk;
+};
+export type StrWithAutocomplete<T> = T | (string & Record<never, never>);
+export type Pk = StrWithAutocomplete<"pk" | "gsi-pk" | "gsi2-pk" | "gsi-2-pk">;
+export type Sk = StrWithAutocomplete<"sk" | "gsi-sk" | "gsi2-sk" | "gsi-2-sk">;
+export type RawResponse<T> = {
+    lastEvaluatedKey?: Record<string, unknown> | undefined;
+    scannedCount: number;
+    count: number;
+    items: T[];
+};
+type RecursiveFn<T> = (page: RawResponse<T>, pageCount: number, totalItems: number) => boolean;
+export type SkCond = {
+    key?: Sk;
+    op: "=" | ">=" | ">" | "<=" | "<";
+    value: string;
+} | {
+    key?: Sk;
+    op: "begins_with";
+    value: string;
+} | {
+    key?: Sk;
+    op: "between";
+    value: [string, string];
+} | {
+    key?: Sk;
+    value: string;
+    valueBeginsWith?: never;
+} | {
+    key?: Sk;
+    valueBeginsWith: string;
+    value?: never;
+};
+type StrKey<T> = Extract<keyof T, string>;
+type Comparable = string | number | bigint;
+type AllowsOrder<V> = V extends Comparable ? true : false;
+type AllowsBeginsWith<V> = V extends string ? true : false;
+type AllowsContains<V> = V extends string ? true : V extends ReadonlyArray<unknown> | Array<unknown> | ReadonlySet<unknown> | Set<unknown> ? true : false;
+type AllowsBetween<V> = V extends Comparable ? true : false;
+type AllowsIn<V> = V extends Comparable ? true : false;
+type EqNeClause<T, K extends StrKey<T>> = {
+    key: K;
+    op: "=" | "<>";
+    value: T[K];
+};
+type OrdClause<T, K extends StrKey<T>> = AllowsOrder<T[K]> extends true ? {
+    key: K;
+    op: ">" | ">=" | "<" | "<=";
+    value: Extract<T[K], Comparable>;
+} : never;
+type BeginsWithClause<T, K extends StrKey<T>> = AllowsBeginsWith<T[K]> extends true ? {
+    key: K;
+    op: "begins_with";
+    value: Extract<T[K], string>;
+} : never;
+type ContainsClause<T, K extends StrKey<T>> = AllowsContains<T[K]> extends true ? T[K] extends string ? {
+    key: K;
+    op: "contains";
+    value: string;
+} : T[K] extends ReadonlyArray<infer U> | Array<infer U> | ReadonlySet<infer U> | Set<infer U> ? {
+    key: K;
+    op: "contains";
+    value: U;
+} : never : never;
+type BetweenClause<T, K extends StrKey<T>> = AllowsBetween<T[K]> extends true ? {
+    key: K;
+    op: "between";
+    value: readonly [Extract<T[K], Comparable>, Extract<T[K], Comparable>];
+} : never;
+type InClause<T, K extends StrKey<T>> = AllowsIn<T[K]> extends true ? {
+    key: K;
+    op: "in";
+    value: ReadonlyArray<Extract<T[K], Comparable>>;
+} : never;
+type ExistsClause<T, K extends StrKey<T>> = {
+    key: K;
+    op: "attribute_exists" | "attribute_not_exists";
+};
+type FilterClauseForKey<T, K extends StrKey<T>> = EqNeClause<T, K> | OrdClause<T, K> | BeginsWithClause<T, K> | ContainsClause<T, K> | BetweenClause<T, K> | InClause<T, K> | ExistsClause<T, K>;
+/** One clause type that's keyed & value-typed from T */
+export type FilterClause<T extends object> = {
+    [K in StrKey<T>]: FilterClauseForKey<T, K>;
+}[StrKey<T>];
+/** Shared props between Query and Scan operations */
+type BaseFindProps<T extends object = Record<string, unknown>> = {
+    /** Table name override (optional, defaults to main table) */
+    tableName?: string;
+    /**
+     * Type-safe filter clauses for post-query/scan filtering (optional)
+     * Array of filter clauses, all combined with AND logic
+     *
+     * Examples:
+     * ```ts
+     * // Equality check
+     * filters: [{ key: 'status', op: '=', value: 'active' }]
+     *
+     * // Multiple filters (AND logic)
+     * filters: [
+     *   { key: 'status', op: '=', value: 'active' },
+     *   { key: 'age', op: '>=', value: 18 },
+     *   { key: 'score', op: '>', value: 80 }
+     * ]
+     *
+     * // Existence checks
+     * filters: [
+     *   { key: 'email', op: 'attribute_exists' },
+     *   { key: 'deletedAt', op: 'attribute_not_exists' }
+     * ]
+     *
+     * // String operations
+     * filters: [
+     *   { key: 'name', op: 'begins_with', value: 'John' },
+     *   { key: 'description', op: 'contains', value: 'urgent' }
+     * ]
+     *
+     * // Range and list operations
+     * filters: [
+     *   { key: 'age', op: 'between', value: [18, 65] },
+     *   { key: 'status', op: 'in', value: ['active', 'pending', 'approved'] }
+     * ]
+     * ```
+     */
+    filters?: ReadonlyArray<FilterClause<T>>;
+    /** Limit number of items returned per page (optional) */
+    limit?: number;
+    /** Pagination token from previous query/scan (optional) */
+    startKey?: Record<string, NativeAttributeValue>;
+    /** Fetch all pages recursively; pass function to control continuation (optional) */
+    recursive?: boolean | RecursiveFn<T>;
+    /** Maximum items to fetch when using recursive (optional) */
+    maxItems?: number;
+    /** Maximum pages to fetch when using recursive (optional) */
+    maxPages?: number;
+    /** Use consistent reads (slower but guaranteed up-to-date, only works on tables not indexes) */
+    strong?: boolean;
+    /** Projection: specific attributes to retrieve (reduces data transfer) */
+    projection?: (keyof T)[];
+    debug?: boolean;
+};
+/** Query-specific props (default, scan is undefined or false) */
+type QueryFindProps<T extends object = Record<string, unknown>> = BaseFindProps<T> & {
+    /** Use Scan instead of Query (default: false) */
+    scan?: false | undefined;
+    /** Primary key condition (required for Query) */
+    pk: {
+        key?: string;
+        value: string;
+    };
+    /** Sort key condition (optional) */
+    sk?: SkCond;
+    /** Global secondary index name (optional) */
+    indexName?: string;
+    /** Sort order: ascending or descending (default: asc). Only available for Query. */
+    sort?: "asc" | "desc";
+};
+/** Scan-specific props (scan: true) */
+type ScanFindProps<T extends object = Record<string, unknown>> = BaseFindProps<T> & {
+    /** Use Scan instead of Query - scans entire table with optional filters */
+    scan: true;
+    /** pk is not allowed in scan mode - use filters instead */
+    pk?: never;
+    /** sk is not allowed in scan mode - use filters instead */
+    sk?: never;
+    /** Index to scan (optional, rarely needed for scans) */
+    indexName?: string;
+    /** sort is not available for Scan - DynamoDB returns items in storage order */
+    sort?: never;
+};
+/**
+ * Find props - discriminated union between Query and Scan modes
+ *
+ * @example
+ * // Query mode (default) - pk required
+ * const items = await find<User>(doc, {
+ *   tableName: 'users',
+ *   pk: { value: 'user#123' },
+ *   sk: { op: 'begins_with', value: 'profile#' },
+ *   sort: 'desc',
+ * });
+ *
+ * @example
+ * // Scan mode - no pk/sk, can filter on any attribute
+ * const items = await find<User>(doc, {
+ *   tableName: 'users',
+ *   scan: true,
+ *   filters: [
+ *     { key: 'pk', op: 'begins_with', value: 'user#' },
+ *     { key: 'status', op: '=', value: 'active' },
+ *   ],
+ * });
+ */
+export type FindProps<T extends object = Record<string, unknown>> = QueryFindProps<T> | ScanFindProps<T>;
+export type BatchGetResult<T> = {
+    items: T[];
+    count: number;
+    missing: number;
+    consumedCapacity?: number | undefined;
+};
+export type BatchWriteResult = {
+    processed: number;
+    failed: number;
+    consumedCapacity?: number | undefined;
+};
+export type BatchDeleteResult = {
+    processed: number;
+    failed: number;
+    consumedCapacity?: number | undefined;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/server/aws/ddb/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/ddb/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,WAAW,GAAG,cAAc,CAAC;AACzC,MAAM,MAAM,WAAW,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;AAE9D,MAAM,MAAM,GAAG,GAAG;IAAE,EAAE,EAAE,EAAE,CAAC;IAAC,EAAE,EAAE,EAAE,CAAA;CAAE,CAAC;AAIrC,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AACzE,MAAM,MAAM,EAAE,GAAG,mBAAmB,CAAC,IAAI,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC,CAAC;AAC/E,MAAM,MAAM,EAAE,GAAG,mBAAmB,CAAC,IAAI,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC,CAAC;AAE/E,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,EAAE,CAAC;CACZ,CAAC;AACF,KAAK,WAAW,CAAC,CAAC,IAAI,CACpB,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACpB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,KACf,OAAO,CAAC;AAEb,MAAM,MAAM,MAAM,GAEd;IAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IAAC,EAAE,EAAE,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IAAC,EAAE,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IAAC,EAAE,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAEpD;IAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,GACpD;IAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAMzD,KAAK,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAC1C,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,GAAG,IAAI,GAAG,KAAK,CAAC;AAC1D,KAAK,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;AAC3D,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACrC,IAAI,GAEN,CAAC,SACK,aAAa,CAAC,OAAO,CAAC,GACtB,KAAK,CAAC,OAAO,CAAC,GACd,WAAW,CAAC,OAAO,CAAC,GACpB,GAAG,CAAC,OAAO,CAAC,GAChB,IAAI,GACJ,KAAK,CAAC;AACV,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,GAAG,IAAI,GAAG,KAAK,CAAC;AAC5D,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,GAAG,IAAI,GAAG,KAAK,CAAC;AAEvD,KAAK,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,IAAI;IACxC,GAAG,EAAE,CAAC,CAAC;IACP,EAAE,EAAE,GAAG,GAAG,IAAI,CAAC;IACf,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;CACb,CAAC;AAEF,KAAK,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GACnE;IACE,GAAG,EAAE,CAAC,CAAC;IACP,EAAE,EAAE,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;CAClC,GACD,KAAK,CAAC;AAEV,KAAK,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAC9D,CAAC,CAAC,CAAC,CAAC,CACL,SAAS,IAAI,GACV;IACE,GAAG,EAAE,CAAC,CAAC;IACP,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;CAC9B,GACD,KAAK,CAAC;AAEV,KAAK,cAAc,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAC3E,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACjB;IACE,GAAG,EAAE,CAAC,CAAC;IACP,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,GACD,CAAC,CAAC,CAAC,CAAC,SACA,aAAa,CAAC,MAAM,CAAC,CAAC,GACtB,KAAK,CAAC,MAAM,CAAC,CAAC,GACd,WAAW,CAAC,MAAM,CAAC,CAAC,GACpB,GAAG,CAAC,MAAM,CAAC,CAAC,GAChB;IACE,GAAG,EAAE,CAAC,CAAC;IACP,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,CAAC,CAAC;CACV,GACD,KAAK,GACP,KAAK,CAAC;AAEV,KAAK,aAAa,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GACzE;IACE,GAAG,EAAE,CAAC,CAAC;IACP,EAAE,EAAE,SAAS,CAAC;IACd,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;CACxE,GACD,KAAK,CAAC;AAEV,KAAK,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAC/D;IACE,GAAG,EAAE,CAAC,CAAC;IACP,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;CACjD,GACD,KAAK,CAAC;AAEV,KAAK,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,IAAI;IAC1C,GAAG,EAAE,CAAC,CAAC;IACP,EAAE,EAAE,kBAAkB,GAAG,sBAAsB,CAAC;CACjD,CAAC;AAEF,KAAK,kBAAkB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,IAC1C,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAChB,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GACf,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GACtB,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,GACpB,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GACd,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEvB,wDAAwD;AACxD,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI;KAC1C,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;CAC3C,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AA6Cb,qDAAqD;AACrD,KAAK,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IAC/D,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAChD,oFAAoF;IACpF,SAAS,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IACrC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gGAAgG;IAChG,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,iEAAiE;AACjE,KAAK,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAC5D,aAAa,CAAC,CAAC,CAAC,GAAG;IACjB,iDAAiD;IACjD,IAAI,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,iDAAiD;IACjD,EAAE,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,oCAAoC;IACpC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACvB,CAAC;AAEJ,uCAAuC;AACvC,KAAK,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAC3D,aAAa,CAAC,CAAC,CAAC,GAAG;IACjB,2EAA2E;IAC3E,IAAI,EAAE,IAAI,CAAC;IACX,2DAA2D;IAC3D,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,2DAA2D;IAC3D,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,KAAK,CAAC;CACd,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAC5D,cAAc,CAAC,CAAC,CAAC,GACjB,aAAa,CAAC,CAAC,CAAC,CAAC;AAMrB,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC,CAAC;AACF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC,CAAC"}