@exabugs/dynamodb-client 0.1.0

package/dist/client/Database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.js","sourceRoot":"","sources":["../../src/client/Database.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAA0B,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGrE;;;;;;GAMG;AACH,MAAM,OAAO,QAAQ;IAET;IACA;IACA;IACA;IACA;IACA;IANV,YACU,SAAiB,EACjB,aAAqB,EACrB,UAA8B,EAC9B,YAAsC,EACtC,cAAyC,EACzC,eAAgD;QALhD,cAAS,GAAT,SAAS,CAAQ;QACjB,kBAAa,GAAb,aAAa,CAAQ;QACrB,eAAU,GAAV,UAAU,CAAoB;QAC9B,iBAAY,GAAZ,YAAY,CAA0B;QACtC,mBAAc,GAAd,cAAc,CAA2B;QACzC,oBAAe,GAAf,eAAe,CAAiC;IACvD,CAAC;IAEJ,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,UAAU,CAER,IAAY;QACZ,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,IAAI,UAAU,CACnB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,aAAa,EAClB,IAAI,EACJ,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,eAAe,CACrB,CAAC;IACJ,CAAC;CACF"}

package/dist/client/DynamoClient.d.ts

@@ -0,0 +1,43 @@
+import type { AuthHeadersGetter } from './Collection.js';
+import { Database } from './Database.js';
+/**
+ * クライアントオプション
+ *
+ * @template TAuthOptions - 認証オプションの型
+ */
+export interface ClientOptions<TAuthOptions = unknown> {
+    /** 認証設定 */
+    auth?: TAuthOptions;
+    /** 自動接続（デフォルト: false） */
+    autoConnect?: boolean;
+    /** タイムアウト（ミリ秒、デフォルト: 30000） */
+    timeout?: number;
+}
+/**
+ * DynamoDBクライアント
+ *
+ * Lambda Function URL経由でDynamoDBにアクセスするHTTPクライアント。
+ * MongoDB風のシンプルなAPIを提供します。
+ *
+ * @template TAuthOptions - 認証オプションの型
+ */
+export declare class DynamoClient<TAuthOptions = unknown> {
+    private endpoint;
+    private options?;
+    private authToken?;
+    private connected;
+    private getAuthHeaders;
+    /**
+     * DynamoClientを作成
+     *
+     * @param endpoint - Lambda Function URL
+     * @param options - クライアントオプション
+     * @param getAuthHeaders - 認証ヘッダー取得関数
+     */
+    constructor(endpoint: string, options: ClientOptions<TAuthOptions> | undefined, getAuthHeaders: AuthHeadersGetter<TAuthOptions>);
+    connect(): Promise<void>;
+    db(name: string): Database<TAuthOptions>;
+    close(): Promise<void>;
+    isConnected(): boolean;
+}
+//# sourceMappingURL=DynamoClient.d.ts.map

package/dist/client/DynamoClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamoClient.d.ts","sourceRoot":"","sources":["../../src/client/DynamoClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,YAAY,GAAG,OAAO;IACnD,WAAW;IACX,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,yBAAyB;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,qBAAa,YAAY,CAAC,YAAY,GAAG,OAAO;IAC9C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAC,CAA8B;IAC9C,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,cAAc,CAAkC;IAExD;;;;;;OAMG;gBAED,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,SAAS,EAChD,cAAc,EAAE,iBAAiB,CAAC,YAAY,CAAC;IAiB3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC;IAsBlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,WAAW,IAAI,OAAO;CAGvB"}

package/dist/client/DynamoClient.js

@@ -0,0 +1,62 @@
+import { Database } from './Database.js';
+/**
+ * DynamoDBクライアント
+ *
+ * Lambda Function URL経由でDynamoDBにアクセスするHTTPクライアント。
+ * MongoDB風のシンプルなAPIを提供します。
+ *
+ * @template TAuthOptions - 認証オプションの型
+ */
+export class DynamoClient {
+    endpoint;
+    options;
+    authToken;
+    connected = false;
+    getAuthHeaders;
+    /**
+     * DynamoClientを作成
+     *
+     * @param endpoint - Lambda Function URL
+     * @param options - クライアントオプション
+     * @param getAuthHeaders - 認証ヘッダー取得関数
+     */
+    constructor(endpoint, options, getAuthHeaders) {
+        if (!endpoint || endpoint.trim() === '') {
+            throw new Error('Endpoint cannot be empty');
+        }
+        this.endpoint = endpoint;
+        this.options = options;
+        this.getAuthHeaders = getAuthHeaders;
+        if (options?.autoConnect) {
+            this.connect().catch((err) => {
+                console.error('Auto-connect failed:', err);
+            });
+        }
+    }
+    async connect() {
+        // Cognito認証の場合、トークンを取得（getToken関数が存在する場合）
+        const auth = this.options?.auth;
+        if (auth?.getToken) {
+            this.authToken = await auth.getToken();
+        }
+        this.connected = true;
+    }
+    db(name) {
+        if (!this.connected) {
+            throw new Error('Client is not connected. Please call await client.connect() before using the client. ' +
+                'Alternatively, set { autoConnect: true } in the client options.');
+        }
+        if (!name || name.trim() === '') {
+            throw new Error('Database name cannot be empty');
+        }
+        return new Database(this.endpoint, name, this.authToken, this.options?.auth, this.options, this.getAuthHeaders);
+    }
+    async close() {
+        this.authToken = undefined;
+        this.connected = false;
+    }
+    isConnected() {
+        return this.connected;
+    }
+}
+//# sourceMappingURL=DynamoClient.js.map

package/dist/client/DynamoClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamoClient.js","sourceRoot":"","sources":["../../src/client/DynamoClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAgBzC;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IACf,QAAQ,CAAS;IACjB,OAAO,CAA+B;IACtC,SAAS,CAAU;IACnB,SAAS,GAAY,KAAK,CAAC;IAC3B,cAAc,CAAkC;IAExD;;;;;;OAMG;IACH,YACE,QAAgB,EAChB,OAAgD,EAChD,cAA+C;QAE/C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QAErC,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC3B,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;YAC7C,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,0CAA0C;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,IAAwD,CAAC;QACpF,IAAI,IAAI,EAAE,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,EAAE,CAAC,IAAY;QACb,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,uFAAuF;gBACrF,iEAAiE,CACpE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,IAAI,QAAQ,CACjB,IAAI,CAAC,QAAQ,EACb,IAAI,EACJ,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,OAAO,EAAE,IAAI,EAClB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,cAAc,CACpB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF"}

package/dist/client/FindCursor.d.ts

@@ -0,0 +1,174 @@
+import type { Filter, FindOptions } from '../types.js';
+import type { AuthHeadersGetter } from './Collection.js';
+import type { ClientOptions } from './DynamoClient.js';
+/**
+ * FindCursor
+ *
+ * MongoDB風のカーソルAPIを提供します。
+ * メソッドチェーンでソート、制限、スキップを設定し、
+ * toArray()で結果を取得します。
+ *
+ * @template TSchema - ドキュメント型
+ *
+ * @example
+ * ```typescript
+ * const results = await products
+ *   .find({ status: 'active', price: { gte: 1000 } })
+ *   .sort({ price: 'desc', createdAt: 'asc' })
+ *   .limit(10)
+ *   .skip(20)
+ *   .toArray();
+ * ```
+ */
+export declare class FindCursor<TSchema extends {
+    id: string;
+    [key: string]: unknown;
+} = {
+    id: string;
+    [key: string]: unknown;
+}, TAuthOptions = unknown> {
+    private endpoint;
+    private databaseName;
+    private collectionName;
+    private filter;
+    private authToken?;
+    private authOptions?;
+    private clientOptions?;
+    private getAuthHeaders?;
+    private options;
+    private executed;
+    private results;
+    private pageInfo?;
+    /**
+     * FindCursorを作成
+     *
+     * @param endpoint - Lambda Function URL
+     * @param databaseName - データベース名
+     * @param collectionName - コレクション名
+     * @param filter - フィルタ条件
+     * @param options - 検索オプション
+     * @param authToken - 認証トークン
+     * @param authOptions - 認証オプション
+     * @param clientOptions - クライアントオプション
+     * @param getAuthHeaders - 認証ヘッダー取得関数
+     */
+    constructor(endpoint: string, databaseName: string, collectionName: string, filter: Filter<TSchema>, options?: FindOptions, authToken?: string | undefined, authOptions?: TAuthOptions | undefined, clientOptions?: ClientOptions | undefined, getAuthHeaders?: AuthHeadersGetter<TAuthOptions> | undefined);
+    /**
+     * ソート条件を設定
+     *
+     * 複数のフィールドでソートする場合、オブジェクトのキー順序でソート優先度が決まります。
+     * 1または'asc'で昇順、-1または'desc'で降順を指定します。
+     *
+     * @param sort - ソート条件（例: { price: 'desc', createdAt: 'asc' }）
+     * @returns this（メソッドチェーン用）
+     *
+     * @example
+     * ```typescript
+     * // 価格の降順でソート
+     * cursor.sort({ price: 'desc' });
+     *
+     * // 複数フィールドでソート
+     * cursor.sort({ priority: 'desc', createdAt: 'asc' });
+     *
+     * // 数値形式でも指定可能
+     * cursor.sort({ price: -1, createdAt: 1 });
+     * ```
+     */
+    sort(sort: Record<string, 1 | -1 | 'asc' | 'desc'>): this;
+    /**
+     * 取得件数を制限
+     *
+     * 返されるドキュメントの最大数を設定します。
+     * ページネーション実装時にskip()と組み合わせて使用します。
+     *
+     * @param limit - 取得件数（正の整数）
+     * @returns this（メソッドチェーン用）
+     *
+     * @example
+     * ```typescript
+     * // 最初の10件を取得
+     * cursor.limit(10);
+     *
+     * // ページネーション（2ページ目、1ページ10件）
+     * cursor.skip(10).limit(10);
+     * ```
+     */
+    limit(limit: number): this;
+    /**
+     * スキップする件数を設定
+     *
+     * 指定した件数のドキュメントをスキップします。
+     * ページネーション実装時にlimit()と組み合わせて使用します。
+     *
+     * @param skip - スキップする件数（0以上の整数）
+     * @returns this（メソッドチェーン用）
+     *
+     * @example
+     * ```typescript
+     * // 最初の20件をスキップ
+     * cursor.skip(20);
+     *
+     * // ページネーション（3ページ目、1ページ10件）
+     * cursor.skip(20).limit(10);
+     * ```
+     */
+    skip(skip: number): this;
+    /**
+     * クエリを実行（内部使用）
+     *
+     * Lambda Function URLにHTTPリクエストを送信し、結果を取得します。
+     * 一度実行されたクエリは再実行されません（結果がキャッシュされます）。
+     */
+    private execute;
+    /**
+     * 配列として取得
+     *
+     * クエリを実行し、結果をドキュメントの配列として返します。
+     * このメソッドを呼び出すまで、実際のHTTPリクエストは送信されません。
+     *
+     * @returns ドキュメントの配列
+     *
+     * @example
+     * ```typescript
+     * const results = await products
+     *   .find({ status: 'active' })
+     *   .sort({ price: 'desc' })
+     *   .limit(10)
+     *   .toArray();
+     *
+     * console.log(`Found ${results.length} products`);
+     * results.forEach(product => {
+     *   console.log(product.name, product.price);
+     * });
+     * ```
+     */
+    toArray(): Promise<TSchema[]>;
+    /**
+     * ページネーション情報を取得
+     *
+     * クエリを実行し、ページネーション情報を返します。
+     * 無限スクロールやカーソルベースのページネーションに使用します。
+     *
+     * @returns ページネーション情報
+     *
+     * @example
+     * ```typescript
+     * const cursor = products
+     *   .find({ status: 'active' })
+     *   .sort({ price: 'desc' })
+     *   .limit(10);
+     *
+     * const results = await cursor.toArray();
+     * const pageInfo = await cursor.getPageInfo();
+     *
+     * console.log(`Has next page: ${pageInfo.hasNextPage}`);
+     * console.log(`Next token: ${pageInfo.nextToken}`);
+     * ```
+     */
+    getPageInfo(): Promise<{
+        hasNextPage: boolean;
+        hasPreviousPage: boolean;
+        nextToken?: string;
+    }>;
+}
+//# sourceMappingURL=FindCursor.d.ts.map

package/dist/client/FindCursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FindCursor.d.ts","sourceRoot":"","sources":["../../src/client/FindCursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,UAAU,CACrB,OAAO,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAC/F,YAAY,GAAG,OAAO;IAqBpB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,MAAM;IAEd,OAAO,CAAC,SAAS,CAAC;IAClB,OAAO,CAAC,WAAW,CAAC;IACpB,OAAO,CAAC,aAAa,CAAC;IACtB,OAAO,CAAC,cAAc,CAAC;IA3BzB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,QAAQ,CAAC,CAAyE;IAE1F;;;;;;;;;;;;OAYG;gBAEO,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EAC/B,OAAO,GAAE,WAAgB,EACjB,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,WAAW,CAAC,EAAE,YAAY,YAAA,EAC1B,aAAa,CAAC,EAAE,aAAa,YAAA,EAC7B,cAAc,CAAC,EAAE,iBAAiB,CAAC,YAAY,CAAC,YAAA;IAK1D;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC,GAAG,IAAI;IAKzD;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK1B;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB;;;;;OAKG;YACW,OAAO;IAuFrB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAOnC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,WAAW,IAAI,OAAO,CAAC;QAC3B,WAAW,EAAE,OAAO,CAAC;QACrB,eAAe,EAAE,OAAO,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CAWH"}

package/dist/client/FindCursor.js

@@ -0,0 +1,256 @@
+/**
+ * FindCursor
+ *
+ * MongoDB風のカーソルAPIを提供します。
+ * メソッドチェーンでソート、制限、スキップを設定し、
+ * toArray()で結果を取得します。
+ *
+ * @template TSchema - ドキュメント型
+ *
+ * @example
+ * ```typescript
+ * const results = await products
+ *   .find({ status: 'active', price: { gte: 1000 } })
+ *   .sort({ price: 'desc', createdAt: 'asc' })
+ *   .limit(10)
+ *   .skip(20)
+ *   .toArray();
+ * ```
+ */
+export class FindCursor {
+    endpoint;
+    databaseName;
+    collectionName;
+    filter;
+    authToken;
+    authOptions;
+    clientOptions;
+    getAuthHeaders;
+    options;
+    executed = false;
+    results = [];
+    pageInfo;
+    /**
+     * FindCursorを作成
+     *
+     * @param endpoint - Lambda Function URL
+     * @param databaseName - データベース名
+     * @param collectionName - コレクション名
+     * @param filter - フィルタ条件
+     * @param options - 検索オプション
+     * @param authToken - 認証トークン
+     * @param authOptions - 認証オプション
+     * @param clientOptions - クライアントオプション
+     * @param getAuthHeaders - 認証ヘッダー取得関数
+     */
+    constructor(endpoint, databaseName, collectionName, filter, options = {}, authToken, authOptions, clientOptions, getAuthHeaders) {
+        this.endpoint = endpoint;
+        this.databaseName = databaseName;
+        this.collectionName = collectionName;
+        this.filter = filter;
+        this.authToken = authToken;
+        this.authOptions = authOptions;
+        this.clientOptions = clientOptions;
+        this.getAuthHeaders = getAuthHeaders;
+        this.options = { ...options };
+    }
+    /**
+     * ソート条件を設定
+     *
+     * 複数のフィールドでソートする場合、オブジェクトのキー順序でソート優先度が決まります。
+     * 1または'asc'で昇順、-1または'desc'で降順を指定します。
+     *
+     * @param sort - ソート条件（例: { price: 'desc', createdAt: 'asc' }）
+     * @returns this（メソッドチェーン用）
+     *
+     * @example
+     * ```typescript
+     * // 価格の降順でソート
+     * cursor.sort({ price: 'desc' });
+     *
+     * // 複数フィールドでソート
+     * cursor.sort({ priority: 'desc', createdAt: 'asc' });
+     *
+     * // 数値形式でも指定可能
+     * cursor.sort({ price: -1, createdAt: 1 });
+     * ```
+     */
+    sort(sort) {
+        this.options = { ...this.options, sort };
+        return this;
+    }
+    /**
+     * 取得件数を制限
+     *
+     * 返されるドキュメントの最大数を設定します。
+     * ページネーション実装時にskip()と組み合わせて使用します。
+     *
+     * @param limit - 取得件数（正の整数）
+     * @returns this（メソッドチェーン用）
+     *
+     * @example
+     * ```typescript
+     * // 最初の10件を取得
+     * cursor.limit(10);
+     *
+     * // ページネーション（2ページ目、1ページ10件）
+     * cursor.skip(10).limit(10);
+     * ```
+     */
+    limit(limit) {
+        this.options = { ...this.options, limit };
+        return this;
+    }
+    /**
+     * スキップする件数を設定
+     *
+     * 指定した件数のドキュメントをスキップします。
+     * ページネーション実装時にlimit()と組み合わせて使用します。
+     *
+     * @param skip - スキップする件数（0以上の整数）
+     * @returns this（メソッドチェーン用）
+     *
+     * @example
+     * ```typescript
+     * // 最初の20件をスキップ
+     * cursor.skip(20);
+     *
+     * // ページネーション（3ページ目、1ページ10件）
+     * cursor.skip(20).limit(10);
+     * ```
+     */
+    skip(skip) {
+        this.options = { ...this.options, skip };
+        return this;
+    }
+    /**
+     * クエリを実行（内部使用）
+     *
+     * Lambda Function URLにHTTPリクエストを送信し、結果を取得します。
+     * 一度実行されたクエリは再実行されません（結果がキャッシュされます）。
+     */
+    async execute() {
+        if (this.executed) {
+            return;
+        }
+        const requestBody = JSON.stringify({
+            operation: 'find',
+            database: this.databaseName,
+            collection: this.collectionName,
+            params: {
+                filter: this.filter,
+                options: {
+                    ...this.options,
+                },
+            },
+        });
+        let headers = {
+            'Content-Type': 'application/json',
+        };
+        // 認証ヘッダーを追加（注入された関数を使用）
+        if (this.getAuthHeaders) {
+            const authHeaders = await this.getAuthHeaders(this.endpoint, requestBody, this.authOptions);
+            headers = { ...headers, ...authHeaders };
+        }
+        // 後方互換性: authTokenが直接指定されている場合（非推奨）
+        if (this.authToken && !this.authOptions) {
+            headers['Authorization'] = `Bearer ${this.authToken}`;
+        }
+        // タイムアウト設定
+        const controller = new AbortController();
+        const timeout = this.clientOptions?.timeout || 30000; // デフォルト30秒
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(this.endpoint, {
+                method: 'POST',
+                headers,
+                body: requestBody,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const error = (await response.json().catch(() => ({ message: response.statusText })));
+                throw new Error(`Request failed: ${error.message || response.statusText}`);
+            }
+            const result = (await response.json());
+            // Lambda からのレスポンス: { success: true, data: { items: [...], pageInfo: {...}, nextToken?: string } }
+            this.results = result.data?.items || result.data?.documents || [];
+            this.pageInfo = result.data?.pageInfo
+                ? {
+                    hasNextPage: result.data.pageInfo.hasNextPage,
+                    hasPreviousPage: result.data.pageInfo.hasPreviousPage,
+                    nextToken: result.data.nextToken, // nextTokenはpageInfoの外にある
+                }
+                : undefined;
+            this.executed = true;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            // タイムアウトエラーの場合
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error(`Request timeout after ${timeout}ms`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * 配列として取得
+     *
+     * クエリを実行し、結果をドキュメントの配列として返します。
+     * このメソッドを呼び出すまで、実際のHTTPリクエストは送信されません。
+     *
+     * @returns ドキュメントの配列
+     *
+     * @example
+     * ```typescript
+     * const results = await products
+     *   .find({ status: 'active' })
+     *   .sort({ price: 'desc' })
+     *   .limit(10)
+     *   .toArray();
+     *
+     * console.log(`Found ${results.length} products`);
+     * results.forEach(product => {
+     *   console.log(product.name, product.price);
+     * });
+     * ```
+     */
+    async toArray() {
+        if (!this.executed) {
+            await this.execute();
+        }
+        return this.results;
+    }
+    /**
+     * ページネーション情報を取得
+     *
+     * クエリを実行し、ページネーション情報を返します。
+     * 無限スクロールやカーソルベースのページネーションに使用します。
+     *
+     * @returns ページネーション情報
+     *
+     * @example
+     * ```typescript
+     * const cursor = products
+     *   .find({ status: 'active' })
+     *   .sort({ price: 'desc' })
+     *   .limit(10);
+     *
+     * const results = await cursor.toArray();
+     * const pageInfo = await cursor.getPageInfo();
+     *
+     * console.log(`Has next page: ${pageInfo.hasNextPage}`);
+     * console.log(`Next token: ${pageInfo.nextToken}`);
+     * ```
+     */
+    async getPageInfo() {
+        if (!this.executed) {
+            await this.execute();
+        }
+        return (this.pageInfo || {
+            hasNextPage: false,
+            hasPreviousPage: false,
+        });
+    }
+}
+//# sourceMappingURL=FindCursor.js.map

package/dist/client/FindCursor.js.map

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

package/dist/client/aws-sigv4.d.ts

@@ -0,0 +1,10 @@
+/**
+ * AWS SigV4 署名を生成してリクエストに追加
+ *
+ * @param url - リクエスト URL
+ * @param body - リクエストボディ
+ * @param region - AWS リージョン
+ * @returns 署名済みヘッダー
+ */
+export declare function signRequest(url: string, body: string, region: string): Promise<Record<string, string>>;
+//# sourceMappingURL=aws-sigv4.d.ts.map

package/dist/client/aws-sigv4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-sigv4.d.ts","sourceRoot":"","sources":["../../src/client/aws-sigv4.ts"],"names":[],"mappings":"AAWA;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAyCjC"}

package/dist/client/aws-sigv4.js

@@ -0,0 +1,54 @@
+/**
+ * AWS Signature Version 4 署名ユーティリティ
+ *
+ * IAM 認証で Lambda Function URL にリクエストを送信する際に使用します。
+ */
+import { Sha256 } from '@aws-crypto/sha256-js';
+import { HttpRequest } from '@smithy/protocol-http';
+import { SignatureV4 } from '@smithy/signature-v4';
+import { defaultProvider } from '@aws-sdk/credential-provider-node';
+/**
+ * AWS SigV4 署名を生成してリクエストに追加
+ *
+ * @param url - リクエスト URL
+ * @param body - リクエストボディ
+ * @param region - AWS リージョン
+ * @returns 署名済みヘッダー
+ */
+export async function signRequest(url, body, region) {
+    const parsedUrl = new URL(url);
+    // HttpRequest を作成
+    const request = new HttpRequest({
+        method: 'POST',
+        protocol: parsedUrl.protocol,
+        hostname: parsedUrl.hostname,
+        path: parsedUrl.pathname,
+        headers: {
+            'Content-Type': 'application/json',
+            host: parsedUrl.hostname,
+        },
+        body,
+    });
+    // SignatureV4 インスタンスを作成
+    const signer = new SignatureV4({
+        service: 'lambda',
+        region,
+        credentials: defaultProvider(),
+        sha256: Sha256,
+    });
+    // リクエストに署名
+    const signedRequest = await signer.sign(request);
+    // ヘッダーを抽出（ヘッダー名を正規化）
+    const headers = {};
+    for (const [key, value] of Object.entries(signedRequest.headers)) {
+        if (typeof value === 'string') {
+            // Authorization ヘッダーは大文字にする（fetch API の制限対策）
+            const headerName = key.toLowerCase() === 'authorization' ? 'Authorization' : key;
+            headers[headerName] = value;
+        }
+    }
+    // デバッグ: 署名済みヘッダーをログ出力
+    console.log('AWS SigV4 signed headers:', Object.keys(headers));
+    return headers;
+}
+//# sourceMappingURL=aws-sigv4.js.map

package/dist/client/aws-sigv4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-sigv4.js","sourceRoot":"","sources":["../../src/client/aws-sigv4.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,IAAY,EACZ,MAAc;IAEd,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAE/B,kBAAkB;IAClB,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;QAC9B,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,IAAI,EAAE,SAAS,CAAC,QAAQ;QACxB,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,IAAI,EAAE,SAAS,CAAC,QAAQ;SACzB;QACD,IAAI;KACL,CAAC,CAAC;IAEH,wBAAwB;IACxB,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC;QAC7B,OAAO,EAAE,QAAQ;QACjB,MAAM;QACN,WAAW,EAAE,eAAe,EAAE;QAC9B,MAAM,EAAE,MAAM;KACf,CAAC,CAAC;IAEH,WAAW;IACX,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEjD,qBAAqB;IACrB,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QACjE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,6CAA6C;YAC7C,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,KAAK,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC;YACjF,OAAO,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAE/D,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/client/index.cognito.d.ts

@@ -0,0 +1,34 @@
+/**
+ * DynamoDBクライアントSDK（Cognito認証用）
+ *
+ * Lambda Function URL経由でDynamoDBにアクセスするHTTPクライアント。
+ * Cognito認証（動的トークン取得）を使用します。
+ */
+import { type ClientOptions as BaseClientOptions, DynamoClient as BaseDynamoClient } from './DynamoClient.js';
+export { Database } from './Database.js';
+export { Collection } from './Collection.js';
+export { FindCursor } from './FindCursor.js';
+/**
+ * Cognito認証オプション
+ */
+export interface CognitoAuthOptions {
+    /** トークン取得関数（必須） */
+    getToken: () => Promise<string>;
+}
+/**
+ * クライアントオプション（Cognito認証用）
+ */
+export interface ClientOptions extends Omit<BaseClientOptions<CognitoAuthOptions>, 'auth'> {
+    /** Cognito認証設定（必須） */
+    auth: CognitoAuthOptions;
+}
+/**
+ * DynamoDBクライアント（Cognito認証用）
+ *
+ * Cognito認証を使用してLambda Function URLにアクセスします。
+ * トークンは動的に取得されます。
+ */
+export declare class DynamoClient extends BaseDynamoClient<CognitoAuthOptions> {
+    constructor(endpoint: string, options: ClientOptions);
+}
+//# sourceMappingURL=index.cognito.d.ts.map

package/dist/client/index.cognito.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cognito.d.ts","sourceRoot":"","sources":["../../src/client/index.cognito.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,KAAK,aAAa,IAAI,iBAAiB,EACvC,YAAY,IAAI,gBAAgB,EACjC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACxF,sBAAsB;IACtB,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,gBAAgB,CAAC,kBAAkB,CAAC;gBACxD,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa;CAWrD"}