@exabugs/dynamodb-client 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2024-11-29
+
+### Added
+
+- Initial release of @exabugs/dynamodb-client
+- MongoDB-like API for DynamoDB Single-Table Design
+- Shadow Records for efficient sorting and querying
+- Multiple authentication methods:
+  - IAM authentication for server-side
+  - Cognito authentication for web applications
+  - Token authentication for custom scenarios
+- Lambda function implementation with Function URL support
+- react-admin integration for admin UIs
+- Terraform modules for infrastructure deployment
+- Comprehensive TypeScript support
+- Full test coverage with Vitest
+
+### Features
+
+- **Client SDK**: DynamoDB operations with MongoDB-like API
+  - `insertOne`, `insertMany`
+  - `findOne`, `find` with cursor support
+  - `updateOne`, `updateMany`
+  - `deleteOne`, `deleteMany`
+- **Server Implementation**: Lambda handler for serverless deployments
+- **Shadow Records**: Automatic generation and management for sorting
+- **Advanced Filtering**: 7 operators (eq, lt, lte, gt, gte, starts, ends)
+- **Bulk Operations**: Automatic chunking for large datasets
+- **TTL Support**: Automatic data expiration
+
+[Unreleased]: https://github.com/exabugs/dynamodb-client/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/exabugs/dynamodb-client/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 exabugs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,283 @@
+# DynamoDB Client SDK
+
+[![CI](https://github.com/exabugs/dynamodb-client/actions/workflows/ci.yml/badge.svg)](https://github.com/exabugs/dynamodb-client/actions/workflows/ci.yml)
+[![npm version](https://badge.fury.io/js/@exabugs%2Fdynamodb-client.svg)](https://www.npmjs.com/package/@exabugs/dynamodb-client)
+
+DynamoDB Single-Table Client SDK with MongoDB-like API, Shadow Records, and Lambda implementation for serverless applications.
+
+## Features
+
+- 🚀 MongoDB-like API for DynamoDB
+- 📦 Single-Table Design with Shadow Records
+- 🔐 Multiple authentication methods (IAM, Cognito, Token)
+- ⚡ Lambda function implementation included
+- 🎨 react-admin integration
+- 📝 TypeScript support
+- 🏗️ Terraform modules for deployment
+
+## Installation
+
+### From GitHub Packages (Private Repository)
+
+1. Create a Personal Access Token with `read:packages` scope
+2. Configure `.npmrc`:
+
+```bash
+@exabugs:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN
+```
+
+3. Install the package:
+
+```bash
+npm install @exabugs/dynamodb-client
+```
+
+For detailed instructions, see [Private Package Usage Guide](docs/PRIVATE_PACKAGE_USAGE.md).
+
+### From npm (Public - Coming Soon)
+
+```bash
+npm install @exabugs/dynamodb-client
+```
+
+## Quick Start
+
+### Client Usage (IAM Authentication)
+
+```typescript
+import { DynamoClient } from '@exabugs/dynamodb-client/client/iam';
+
+const client = new DynamoClient(FUNCTION_URL, {
+  region: 'ap-northeast-1',
+});
+
+const db = client.db();
+const collection = db.collection('articles');
+
+// Create
+await collection.insertOne({ title: 'Hello World', content: '...' });
+
+// Read
+const article = await collection.findOne({ title: 'Hello World' });
+
+// Update
+await collection.updateOne({ id: article.id }, { $set: { status: 'published' } });
+
+// Delete
+await collection.deleteOne({ id: article.id });
+```
+
+### Server Usage (Lambda Function)
+
+```typescript
+import { createHandler } from '@exabugs/dynamodb-client/server/handler';
+
+export const handler = createHandler({
+  tableName: process.env.TABLE_NAME!,
+  region: process.env.AWS_REGION!,
+});
+```
+
+## Requirements
+
+- Node.js >= 18.0.0
+- AWS Account (for DynamoDB and Lambda)
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Build
+npm run build
+
+# Lint
+npm run lint
+
+# Format
+npm run format
+```
+
+### 主要コマンド
+
+```bash
+# ヘルプを表示
+make help
+
+# 開発
+make install    # 依存関係のインストール
+make build      # 全パッケージとLambda関数のビルド
+make test       # 全パッケージのテスト実行
+make lint       # Lint実行
+make format     # フォーマット実行
+make clean      # ビルド成果物の削除
+
+# デプロイ
+make deploy-dev    # dev環境にデプロイ
+make deploy-stg    # stg環境にデプロイ
+make deploy-prd    # prd環境にデプロイ
+
+# インフラ操作
+make infra-plan ENV=dev     # Terraformプランを表示
+make infra-apply ENV=dev    # Terraformを適用
+make infra-status           # Terraform状態を表示
+
+# Lambda操作
+make invoke-fetch ENV=dev      # Fetch Lambdaを実行
+make logs-fetch ENV=dev        # Fetch Lambdaのログを表示
+make logs-records ENV=dev      # Records Lambdaのログを表示
+
+# その他
+make shadow-config    # shadow.config.jsonを再生成
+```
+
+### 個別Makefileの使用
+
+各Lambda関数には個別のMakefileも用意されています：
+
+```bash
+# Fetch Lambda
+cd functions/fetch
+make help
+make build
+make deploy ENV=dev
+make invoke
+make logs
+
+# Terraform
+cd infra
+make help
+make plan ENV=dev
+make apply ENV=dev
+make status
+```
+
+詳細は[Makefile運用ガイドライン](.kiro/steering/makefile-operations.md)を参照してください。
+
+## Records Lambda
+
+Records Lambdaは`@exabugs/dynamodb-client`ライブラリに統合されています。
+
+詳細は[packages/core/README.md](packages/core/README.md)を参照してください。
+
+## ワークスペース構成
+
+```
+.
+├── apps/           # アプリケーション (Admin UI, Mobile App)
+├── functions/      # Lambda関数 (Fetch, Pipeline, Maintenance)
+├── packages/       # 共有ライブラリ (core, shadows, graphql-types)
+│   └── core/       # Records Lambda（サーバー実装）を含む
+└── infra/          # Terraform設定
+```
+
+**注**: Records Lambdaは`packages/core/`に統合されています。
+
+## Admin UI 開発・デプロイ
+
+### ローカル開発
+
+```bash
+# 開発サーバー起動
+pnpm --filter @ainews/admin dev
+
+# ブラウザで http://localhost:3000 にアクセス
+```
+
+### 環境変数設定
+
+`apps/admin/.env`ファイルを作成：
+
+```bash
+# Records Lambda Function URL
+VITE_RECORDS_API_URL=https://xxxxx.lambda-url.us-east-1.on.aws/
+
+# Cognito User Pool設定
+VITE_COGNITO_USER_POOL_ID=us-east-1_xxxxxxxxx
+VITE_COGNITO_USER_POOL_CLIENT_ID=xxxxxxxxxxxxxxxxxxxxxxxxxx
+VITE_COGNITO_DOMAIN=ainews-dev-auth.auth.us-east-1.amazoncognito.com
+VITE_COGNITO_REGION=us-east-1
+
+# 開発環境で認証を無効化する場合のみ（本番環境では必ずfalse）
+VITE_DISABLE_AUTH=false
+```
+
+### 重要な設定
+
+**必須**: Admin UIは**BrowserRouter**を使用します。HashRouterは使用しないでください。
+
+理由：
+
+- Cognito Hosted UIの認証コールバックがクエリパラメータ（`?code=xxx`）を使用
+- HashRouter（`#/`）ではクエリパラメータが正しく処理されない
+
+### 本番デプロイ（CloudFront）
+
+CloudFront経由で配信する場合、以下の設定が必要です：
+
+1. **エラーページ設定**: 404/403エラーを`/index.html`にリダイレクト（SPA対応）
+2. **キャッシュ設定**:
+   - `index.html`: キャッシュしない（TTL=0）
+   - 静的アセット（JS/CSS/画像）: 長期キャッシュ（TTL=7日〜1年）
+3. **Cognitoコールバック URL**: 本番ドメインを追加
+
+詳細は[設計書](.kiro/specs/ainews-pipeline/design.md)の「Admin UI 重要な設定」セクションを参照してください。
+
+### トラブルシューティング
+
+#### CORSエラーが発生する場合
+
+1. **Lambda関数を最新版にデプロイ**:
+
+   ```bash
+   cd functions/records
+   pnpm build
+   cd ../../infra
+   terraform apply -var-file=envs/dev.tfvars
+   ```
+
+2. **ブラウザのキャッシュをクリア**: Cmd+Shift+R (Mac) または Ctrl+Shift+R (Windows/Linux)
+
+3. **Lambda Function URLのCORS設定を確認**: `infra/modules/api/lambda-records/main.tf`
+
+**重要**: Lambda Function URLのCORS設定を使用するため、Lambda関数のハンドラーではCORSヘッダーを設定しません。
+
+#### Cognito Hosted UIでログインできない場合
+
+1. **開発サーバーのポートを確認**: `http://localhost:3000` で起動していることを確認
+   - Vite設定で `strictPort: true` が設定されているため、ポート3000が使用中の場合はエラーになります
+   - 他のプロセスがポート3000を使用していないか確認してください
+
+2. **Cognitoのコールバック/ログアウトURLを確認**: `infra/envs/dev.tfvars`
+
+   ```hcl
+   admin_callback_urls = [
+     "http://localhost:3000",
+     "http://localhost:3000/callback",
+     ...
+   ]
+   ```
+
+3. **ブラウザのローカルストレージをクリア**: 古いセッション情報が残っている可能性があります
+
+## ドキュメント
+
+詳細な設計・要件については以下を参照してください：
+
+- [要件定義書](.kiro/specs/ainews-pipeline/requirements.md)
+- [設計書](.kiro/specs/ainews-pipeline/design.md)
+- [実装タスクリスト](.kiro/specs/ainews-pipeline/tasks.md)
+
+## ライセンス
+
+MIT License - 詳細は [LICENSE](LICENSE) ファイルを参照してください。
+
+Copyright (c) 2024 exabugs

package/dist/client/Collection.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Collection（共通実装）
+ *
+ * 認証ハンドラーは外部から注入されます。
+ */
+import type { DeleteResult, Filter, FindOptions, InsertManyResult, InsertOneResult, UpdateOperators, UpdateResult } from '../types.js';
+import type { ClientOptions } from './DynamoClient.js';
+import { FindCursor } from './FindCursor.js';
+/**
+ * 認証ハンドラー関数の型
+ */
+export type AuthHeadersGetter<TAuthOptions = unknown> = (endpoint: string, body: string, authOptions?: TAuthOptions) => Promise<Record<string, string>>;
+/**
+ * コレクションのドキュメント型の基本インターフェース
+ */
+export interface DocumentBase {
+    id: string;
+    [key: string]: unknown;
+}
+/**
+ * コレクション
+ *
+ * MongoDB風のCRUD操作を提供します。
+ * 型安全なフィルタとクエリAPIでDynamoDBを操作できます。
+ *
+ * @template TSchema - コレクションのドキュメント型
+ * @template TAuthOptions - 認証オプションの型
+ */
+export declare class Collection<TSchema extends DocumentBase = DocumentBase, TAuthOptions = unknown> {
+    private endpoint;
+    private databaseName;
+    private collectionName;
+    private authToken;
+    private authOptions;
+    private clientOptions;
+    private getAuthHeaders;
+    constructor(endpoint: string, databaseName: string, collectionName: string, authToken: string | undefined, authOptions: TAuthOptions | undefined, clientOptions: ClientOptions | undefined, getAuthHeaders: AuthHeadersGetter<TAuthOptions>);
+    getName(): string;
+    getEndpoint(): string;
+    getDatabaseName(): string;
+    getAuthToken(): string | undefined;
+    getAuthOptions(): TAuthOptions | undefined;
+    /**
+     * HTTPリクエストを送信（内部使用）
+     */
+    private request;
+    find(filter?: Filter<TSchema>, options?: FindOptions): FindCursor<TSchema, TAuthOptions>;
+    findOne(filter: Filter<TSchema>): Promise<TSchema | null>;
+    findMany(ids: string[]): Promise<TSchema[]>;
+    insertOne(document: TSchema): Promise<InsertOneResult>;
+    insertMany(documents: TSchema[]): Promise<InsertManyResult>;
+    updateOne(filter: Filter<TSchema>, update: UpdateOperators<TSchema>): Promise<UpdateResult>;
+    updateMany(filter: Filter<TSchema>, update: UpdateOperators<TSchema>): Promise<UpdateResult>;
+    deleteOne(filter: Filter<TSchema>): Promise<DeleteResult>;
+    deleteMany(filter: Filter<TSchema>): Promise<DeleteResult>;
+}
+//# sourceMappingURL=Collection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Collection.d.ts","sourceRoot":"","sources":["../../src/client/Collection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACV,YAAY,EACZ,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,YAAY,GAAG,OAAO,IAAI,CACtD,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,YAAY,KACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,qBAAa,UAAU,CAAC,OAAO,SAAS,YAAY,GAAG,YAAY,EAAE,YAAY,GAAG,OAAO;IAEvF,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,cAAc;gBANd,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,WAAW,EAAE,YAAY,GAAG,SAAS,EACrC,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,cAAc,EAAE,iBAAiB,CAAC,YAAY,CAAC;IAGzD,OAAO,IAAI,MAAM;IAIjB,WAAW,IAAI,MAAM;IAIrB,eAAe,IAAI,MAAM;IAIzB,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC,cAAc,IAAI,YAAY,GAAG,SAAS;IAI1C;;OAEG;YACW,OAAO;IAwDrB,IAAI,CAAC,MAAM,GAAE,MAAM,CAAC,OAAO,CAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC;IActF,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAUzD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAU3C,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAStD,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmB3D,SAAS,CACb,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EACvB,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,GAC/B,OAAO,CAAC,YAAY,CAAC;IAelB,UAAU,CACd,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EACvB,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,GAC/B,OAAO,CAAC,YAAY,CAAC;IAkBlB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IASzD,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;CAUjE"}

package/dist/client/Collection.js

@@ -0,0 +1,174 @@
+import { FindCursor } from './FindCursor.js';
+/**
+ * コレクション
+ *
+ * MongoDB風のCRUD操作を提供します。
+ * 型安全なフィルタとクエリAPIでDynamoDBを操作できます。
+ *
+ * @template TSchema - コレクションのドキュメント型
+ * @template TAuthOptions - 認証オプションの型
+ */
+export class Collection {
+    endpoint;
+    databaseName;
+    collectionName;
+    authToken;
+    authOptions;
+    clientOptions;
+    getAuthHeaders;
+    constructor(endpoint, databaseName, collectionName, authToken, authOptions, clientOptions, getAuthHeaders) {
+        this.endpoint = endpoint;
+        this.databaseName = databaseName;
+        this.collectionName = collectionName;
+        this.authToken = authToken;
+        this.authOptions = authOptions;
+        this.clientOptions = clientOptions;
+        this.getAuthHeaders = getAuthHeaders;
+    }
+    getName() {
+        return this.collectionName;
+    }
+    getEndpoint() {
+        return this.endpoint;
+    }
+    getDatabaseName() {
+        return this.databaseName;
+    }
+    getAuthToken() {
+        return this.authToken;
+    }
+    getAuthOptions() {
+        return this.authOptions;
+    }
+    /**
+     * HTTPリクエストを送信（内部使用）
+     */
+    async request(operation, params) {
+        const requestBody = JSON.stringify({
+            operation,
+            database: this.databaseName,
+            collection: this.collectionName,
+            params,
+        });
+        let headers = {
+            'Content-Type': 'application/json',
+        };
+        // 認証ヘッダーを追加（注入された関数を使用）
+        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;
+        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());
+            return result.data;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error(`Request timeout after ${timeout}ms`);
+            }
+            throw error;
+        }
+    }
+    find(filter = {}, options) {
+        return new FindCursor(this.endpoint, this.databaseName, this.collectionName, filter, options, this.authToken, this.authOptions, this.clientOptions, this.getAuthHeaders);
+    }
+    async findOne(filter) {
+        const response = await this.request('findOne', { filter });
+        // Records Lambda は直接レコードを返す（{ document: ... } ではない）
+        // 空オブジェクトの場合はnullを返す
+        if (!response || (typeof response === 'object' && Object.keys(response).length === 0)) {
+            return null;
+        }
+        return response;
+    }
+    async findMany(ids) {
+        const response = await this.request('findMany', { filter: { id: { in: ids } } });
+        // Records Lambdaは配列を直接返す
+        if (Array.isArray(response)) {
+            return response;
+        }
+        const responseObj = response;
+        return responseObj.items || [];
+    }
+    async insertOne(document) {
+        const response = await this.request('insertOne', { document });
+        const result = response;
+        return {
+            acknowledged: true,
+            insertedId: result.insertedId,
+        };
+    }
+    async insertMany(documents) {
+        const response = await this.request('insertMany', { documents });
+        // Records Lambdaは統一形式 { count, successIds, failedIds, errors } を返す
+        // MongoDB互換形式に変換
+        const result = response;
+        return {
+            acknowledged: true,
+            insertedCount: result.count || 0,
+            insertedIds: result.successIds || {},
+            failedIds: result.failedIds,
+            errors: result.errors,
+        };
+    }
+    async updateOne(filter, update) {
+        const response = await this.request('updateOne', { filter, update });
+        const result = response;
+        return {
+            acknowledged: true,
+            matchedCount: result.matchedCount,
+            modifiedCount: result.modifiedCount,
+            upsertedId: result.upsertedId,
+        };
+    }
+    async updateMany(filter, update) {
+        const response = await this.request('updateMany', { filter, update });
+        // Records Lambdaは統一形式 { count, successIds, failedIds, errors } を返す
+        // MongoDB互換形式に変換
+        const result = response;
+        const successCount = Object.keys(result.successIds || {}).length;
+        const failedCount = Object.keys(result.failedIds || {}).length;
+        return {
+            acknowledged: true,
+            matchedCount: successCount + failedCount, // 成功 + 失敗の合計
+            modifiedCount: result.count || 0, // 実際に更新された件数
+        };
+    }
+    async deleteOne(filter) {
+        const response = await this.request('deleteOne', { filter });
+        const result = response;
+        return {
+            acknowledged: true,
+            deletedCount: result.deletedCount,
+        };
+    }
+    async deleteMany(filter) {
+        const response = await this.request('deleteMany', { filter });
+        // Records Lambdaは統一形式 { count, successIds, failedIds, errors } を返す
+        // MongoDB互換形式に変換
+        const result = response;
+        return {
+            acknowledged: true,
+            deletedCount: result.count || 0, // 実際に削除された件数
+        };
+    }
+}
+//# sourceMappingURL=Collection.js.map

package/dist/client/Collection.js.map

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

package/dist/client/Database.d.ts

@@ -0,0 +1,35 @@
+/**
+ * データベース（共通実装）
+ *
+ * 認証ハンドラーは外部から注入されます。
+ */
+import { type AuthHeadersGetter, Collection } from './Collection.js';
+import type { ClientOptions } from './DynamoClient.js';
+/**
+ * データベース
+ *
+ * コレクションへのアクセスを提供します。
+ *
+ * @template TAuthOptions - 認証オプションの型
+ */
+export declare class Database<TAuthOptions = unknown> {
+    private _endpoint;
+    private _databaseName;
+    private _authToken;
+    private _authOptions;
+    private _clientOptions;
+    private _getAuthHeaders;
+    constructor(_endpoint: string, _databaseName: string, _authToken: string | undefined, _authOptions: TAuthOptions | undefined, _clientOptions: ClientOptions | undefined, _getAuthHeaders: AuthHeadersGetter<TAuthOptions>);
+    getEndpoint(): string;
+    getDatabaseName(): string;
+    getAuthToken(): string | undefined;
+    getAuthOptions(): TAuthOptions | undefined;
+    collection<TSchema extends {
+        id: string;
+        [key: string]: unknown;
+    } = {
+        id: string;
+        [key: string]: unknown;
+    }>(name: string): Collection<TSchema, TAuthOptions>;
+}
+//# sourceMappingURL=Database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.ts","sourceRoot":"","sources":["../../src/client/Database.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;GAMG;AACH,qBAAa,QAAQ,CAAC,YAAY,GAAG,OAAO;IAExC,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,eAAe;gBALf,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,YAAY,EAAE,YAAY,GAAG,SAAS,EACtC,cAAc,EAAE,aAAa,GAAG,SAAS,EACzC,eAAe,EAAE,iBAAiB,CAAC,YAAY,CAAC;IAG1D,WAAW,IAAI,MAAM;IAIrB,eAAe,IAAI,MAAM;IAIzB,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC,cAAc,IAAI,YAAY,GAAG,SAAS;IAI1C,UAAU,CACR,OAAO,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EAC/F,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC;CAenD"}

package/dist/client/Database.js

@@ -0,0 +1,48 @@
+/**
+ * データベース（共通実装）
+ *
+ * 認証ハンドラーは外部から注入されます。
+ */
+import { Collection } from './Collection.js';
+/**
+ * データベース
+ *
+ * コレクションへのアクセスを提供します。
+ *
+ * @template TAuthOptions - 認証オプションの型
+ */
+export class Database {
+    _endpoint;
+    _databaseName;
+    _authToken;
+    _authOptions;
+    _clientOptions;
+    _getAuthHeaders;
+    constructor(_endpoint, _databaseName, _authToken, _authOptions, _clientOptions, _getAuthHeaders) {
+        this._endpoint = _endpoint;
+        this._databaseName = _databaseName;
+        this._authToken = _authToken;
+        this._authOptions = _authOptions;
+        this._clientOptions = _clientOptions;
+        this._getAuthHeaders = _getAuthHeaders;
+    }
+    getEndpoint() {
+        return this._endpoint;
+    }
+    getDatabaseName() {
+        return this._databaseName;
+    }
+    getAuthToken() {
+        return this._authToken;
+    }
+    getAuthOptions() {
+        return this._authOptions;
+    }
+    collection(name) {
+        if (!name || name.trim() === '') {
+            throw new Error('Collection name cannot be empty');
+        }
+        return new Collection(this._endpoint, this._databaseName, name, this._authToken, this._authOptions, this._clientOptions, this._getAuthHeaders);
+    }
+}
+//# sourceMappingURL=Database.js.map