@exabugs/dynamodb-client 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,165 @@
+/**
+ * フィルタ演算子（$プレフィックスなし）
+ *
+ * MongoDB風のクエリ演算子を提供します。
+ * すべての演算子は$プレフィックスなしで使用します。
+ */
+export interface FilterOperators<T> {
+    /** 等しい */
+    eq?: T;
+    /** 等しくない */
+    ne?: T;
+    /** より大きい */
+    gt?: T;
+    /** 以上 */
+    gte?: T;
+    /** より小さい */
+    lt?: T;
+    /** 以下 */
+    lte?: T;
+    /** いずれかに一致 */
+    in?: T[];
+    /** いずれにも一致しない */
+    nin?: T[];
+    /** フィールドの存在チェック */
+    exists?: boolean;
+    /** 正規表現マッチ */
+    regex?: string | RegExp;
+}
+/**
+ * フィルタ定義
+ *
+ * 型安全なフィルタ条件を定義します。
+ * 各フィールドに対して直接値を指定するか、FilterOperatorsを使用できます。
+ *
+ * @example
+ * ```typescript
+ * // 直接値を指定
+ * const filter: Filter<Product> = { status: 'active' };
+ *
+ * // 演算子を使用
+ * const filter: Filter<Product> = {
+ *   price: { gte: 1000, lte: 5000 },
+ *   status: { in: ['active', 'pending'] }
+ * };
+ *
+ * // 論理演算子を使用
+ * const filter: Filter<Product> = {
+ *   or: [
+ *     { status: 'active' },
+ *     { priority: { gte: 5 } }
+ *   ]
+ * };
+ * ```
+ */
+export type Filter<T> = {
+    [P in keyof T]?: T[P] | FilterOperators<T[P]>;
+} & {
+    /** AND条件（すべての条件を満たす） */
+    and?: Filter<T>[];
+    /** OR条件（いずれかの条件を満たす） */
+    or?: Filter<T>[];
+};
+/**
+ * 更新演算子（$プレフィックスなし）
+ *
+ * MongoDB風の更新演算子を提供します。
+ * すべての演算子は$プレフィックスなしで使用します。
+ *
+ * @example
+ * ```typescript
+ * // フィールドを設定
+ * const update: UpdateOperators<Product> = {
+ *   set: { status: 'published', updatedAt: new Date().toISOString() }
+ * };
+ *
+ * // フィールドを削除
+ * const update: UpdateOperators<Product> = {
+ *   unset: ['description', 'tags']
+ * };
+ *
+ * // 数値をインクリメント
+ * const update: UpdateOperators<Product> = {
+ *   inc: { stock: -1, viewCount: 1 }
+ * };
+ *
+ * // 複数の演算子を組み合わせ
+ * const update: UpdateOperators<Product> = {
+ *   set: { status: 'published' },
+ *   inc: { viewCount: 1 },
+ *   unset: ['draft']
+ * };
+ * ```
+ */
+export interface UpdateOperators<T> {
+    /** フィールドを設定 */
+    set?: Partial<T>;
+    /** フィールドを削除 */
+    unset?: (keyof T)[];
+    /** 数値をインクリメント（負の値でデクリメント） */
+    inc?: Partial<Record<keyof T, number>>;
+}
+/**
+ * 検索オプション
+ */
+export interface FindOptions {
+    /** ソート条件 */
+    sort?: Record<string, 1 | -1 | 'asc' | 'desc'>;
+    /** 取得件数の制限 */
+    limit?: number;
+    /** スキップする件数 */
+    skip?: number;
+    /** ページネーショントークン（カーソルベースのページネーション用） */
+    nextToken?: string;
+}
+/**
+ * 挿入結果
+ */
+export interface InsertOneResult {
+    /** 操作が確認されたか */
+    acknowledged: boolean;
+    /** 挿入されたドキュメントのID */
+    insertedId: string;
+}
+/**
+ * 複数挿入結果
+ */
+export interface InsertManyResult {
+    /** 操作が確認されたか */
+    acknowledged: boolean;
+    /** 挿入されたドキュメントの数 */
+    insertedCount: number;
+    /** 挿入されたドキュメントのIDマップ */
+    insertedIds: Record<number, string>;
+    /** 失敗したドキュメントのIDリスト */
+    failedIds?: string[];
+    /** エラー情報 */
+    errors?: Array<{
+        id: string;
+        code: string;
+        message: string;
+    }>;
+}
+/**
+ * 更新結果
+ */
+export interface UpdateResult {
+    /** 操作が確認されたか */
+    acknowledged: boolean;
+    /** マッチしたドキュメントの数 */
+    matchedCount: number;
+    /** 変更されたドキュメントの数 */
+    modifiedCount: number;
+    /** アップサートされたドキュメントのID（存在する場合） */
+    upsertedId?: string;
+}
+/**
+ * 削除結果
+ */
+export interface DeleteResult {
+    /** 操作が確認されたか */
+    acknowledged: boolean;
+    /** 削除されたドキュメントの数 */
+    deletedCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,UAAU;IACV,EAAE,CAAC,EAAE,CAAC,CAAC;IACP,YAAY;IACZ,EAAE,CAAC,EAAE,CAAC,CAAC;IACP,YAAY;IACZ,EAAE,CAAC,EAAE,CAAC,CAAC;IACP,SAAS;IACT,GAAG,CAAC,EAAE,CAAC,CAAC;IACR,YAAY;IACZ,EAAE,CAAC,EAAE,CAAC,CAAC;IACP,SAAS;IACT,GAAG,CAAC,EAAE,CAAC,CAAC;IACR,cAAc;IACd,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACT,iBAAiB;IACjB,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;IACV,mBAAmB;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,cAAc;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;KACrB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9C,GAAG;IACF,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAClB,wBAAwB;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,eAAe;IACf,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACjB,eAAe;IACf,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACpB,6BAA6B;IAC7B,GAAG,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC;IAC/C,cAAc;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY;IACZ,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/ulid.d.ts

@@ -0,0 +1,46 @@
+/**
+ * ULID（Universally Unique Lexicographically Sortable Identifier）を生成する
+ *
+ * ULIDは以下の特徴を持つ:
+ * - 26文字の大文字英数字（Crockford's Base32）
+ * - タイムスタンプベースで辞書順ソート可能
+ * - UUIDと互換性のある128ビット
+ * - 単調増加（同一ミリ秒内でもランダム部分が増加）
+ *
+ * @returns 新しいULID文字列（例: "01HZXY123456789ABCDEFGHIJK"）
+ *
+ * @example
+ * ```typescript
+ * const id = ulid();
+ * console.log(id); // "01HZXY123456789ABCDEFGHIJK"
+ * ```
+ */
+export declare function ulid(): string;
+/**
+ * 指定されたタイムスタンプでULIDを生成する
+ *
+ * @param seedTime - Unix タイムスタンプ（ミリ秒）
+ * @returns 指定されたタイムスタンプを持つULID文字列
+ *
+ * @example
+ * ```typescript
+ * const timestamp = Date.now();
+ * const id = ulidWithTime(timestamp);
+ * ```
+ */
+export declare function ulidWithTime(seedTime: number): string;
+/**
+ * ULIDからタイムスタンプを抽出する
+ *
+ * @param id - ULID文字列
+ * @returns Unix タイムスタンプ（ミリ秒）
+ *
+ * @example
+ * ```typescript
+ * const id = ulid();
+ * const timestamp = decodeTime(id);
+ * console.log(new Date(timestamp));
+ * ```
+ */
+export declare function decodeTime(id: string): number;
+//# sourceMappingURL=ulid.d.ts.map

package/dist/ulid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ulid.d.ts","sourceRoot":"","sources":["../src/ulid.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAkB7C"}

package/dist/ulid.js

@@ -0,0 +1,66 @@
+import { ulid as generateUlid } from 'ulid';
+/**
+ * ULID（Universally Unique Lexicographically Sortable Identifier）を生成する
+ *
+ * ULIDは以下の特徴を持つ:
+ * - 26文字の大文字英数字（Crockford's Base32）
+ * - タイムスタンプベースで辞書順ソート可能
+ * - UUIDと互換性のある128ビット
+ * - 単調増加（同一ミリ秒内でもランダム部分が増加）
+ *
+ * @returns 新しいULID文字列（例: "01HZXY123456789ABCDEFGHIJK"）
+ *
+ * @example
+ * ```typescript
+ * const id = ulid();
+ * console.log(id); // "01HZXY123456789ABCDEFGHIJK"
+ * ```
+ */
+export function ulid() {
+    return generateUlid();
+}
+/**
+ * 指定されたタイムスタンプでULIDを生成する
+ *
+ * @param seedTime - Unix タイムスタンプ（ミリ秒）
+ * @returns 指定されたタイムスタンプを持つULID文字列
+ *
+ * @example
+ * ```typescript
+ * const timestamp = Date.now();
+ * const id = ulidWithTime(timestamp);
+ * ```
+ */
+export function ulidWithTime(seedTime) {
+    return generateUlid(seedTime);
+}
+/**
+ * ULIDからタイムスタンプを抽出する
+ *
+ * @param id - ULID文字列
+ * @returns Unix タイムスタンプ（ミリ秒）
+ *
+ * @example
+ * ```typescript
+ * const id = ulid();
+ * const timestamp = decodeTime(id);
+ * console.log(new Date(timestamp));
+ * ```
+ */
+export function decodeTime(id) {
+    // ULIDの最初の10文字がタイムスタンプ部分（48ビット）
+    const timeChars = id.substring(0, 10);
+    // Crockford's Base32デコード
+    const ENCODING = '0123456789ABCDEFGHJKMNPQRSTVWXYZ';
+    let time = 0;
+    for (let i = 0; i < timeChars.length; i++) {
+        const char = timeChars[i];
+        const value = ENCODING.indexOf(char);
+        if (value === -1) {
+            throw new Error(`Invalid ULID character: ${char}`);
+        }
+        time = time * 32 + value;
+    }
+    return time;
+}
+//# sourceMappingURL=ulid.js.map

package/dist/ulid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ulid.js","sourceRoot":"","sources":["../src/ulid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,MAAM,CAAC;AAE5C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,IAAI;IAClB,OAAO,YAAY,EAAE,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,gCAAgC;IAChC,MAAM,SAAS,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtC,yBAAyB;IACzB,MAAM,QAAQ,GAAG,kCAAkC,CAAC;IACpD,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,GAAG,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,136 @@
+{
+  "name": "@exabugs/dynamodb-client",
+  "version": "0.1.0",
+  "description": "DynamoDB Single-Table Client SDK with MongoDB-like API, Shadow Records, and Lambda implementation for serverless applications",
+  "author": "exabugs",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "keywords": [
+    "dynamodb",
+    "single-table",
+    "mongodb",
+    "lambda",
+    "aws",
+    "client",
+    "sdk",
+    "react-admin",
+    "shadow-records",
+    "serverless",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/exabugs/dynamodb-client.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bugs": {
+    "url": "https://github.com/exabugs/dynamodb-client/issues"
+  },
+  "homepage": "https://github.com/exabugs/dynamodb-client#readme",
+  "files": [
+    "dist",
+    "terraform",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./client": {
+      "import": "./dist/client/index.js",
+      "types": "./dist/client/index.d.ts"
+    },
+    "./client/iam": {
+      "import": "./dist/client/index.iam.js",
+      "types": "./dist/client/index.iam.d.ts"
+    },
+    "./client/cognito": {
+      "import": "./dist/client/index.cognito.js",
+      "types": "./dist/client/index.cognito.d.ts"
+    },
+    "./client/token": {
+      "import": "./dist/client/index.token.js",
+      "types": "./dist/client/index.token.d.ts"
+    },
+    "./server": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./server/handler": {
+      "import": "./dist/server/handler.cjs",
+      "types": "./dist/server/handler.d.ts"
+    },
+    "./types": {
+      "import": "./dist/server/types.js",
+      "types": "./dist/server/types.d.ts"
+    },
+    "./shadows": {
+      "import": "./dist/shadows/index.js",
+      "types": "./dist/shadows/index.d.ts"
+    },
+    "./integrations/react-admin": {
+      "import": "./dist/integrations/react-admin/index.js",
+      "types": "./dist/integrations/react-admin/index.d.ts"
+    },
+    "./terraform": "./terraform/main.tf"
+  },
+  "peerDependencies": {
+    "react-admin": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react-admin": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc && node esbuild.config.js",
+    "build:client": "tsc",
+    "build:lambda": "node esbuild.config.js",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext ts --max-warnings 10",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "test:unit": "vitest run --exclude='**/*integration*.test.ts'",
+    "prepublishOnly": "npm run build && npm run test:unit"
+  },
+  "dependencies": {
+    "@aws-crypto/sha256-js": "5.2.0",
+    "@aws-sdk/client-dynamodb": "3.929.0",
+    "@aws-sdk/credential-provider-node": "3.929.0",
+    "@aws-sdk/lib-dynamodb": "3.929.0",
+    "@smithy/protocol-http": "5.3.5",
+    "@smithy/signature-v4": "5.3.5",
+    "@smithy/util-utf8": "4.2.0",
+    "aws-jwt-verify": "5.1.1",
+    "ulid": "3.0.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@trivago/prettier-plugin-sort-imports": "^4.0.0",
+    "@types/aws-lambda": "^8.10.0",
+    "@types/node": "^22.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "esbuild": "^0.20.0",
+    "eslint": "^9.0.0",
+    "globals": "^15.0.0",
+    "prettier": "^3.0.0",
+    "react-admin": "^5.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/terraform/README.md

@@ -0,0 +1,222 @@
+# Records Lambda Terraformモジュール
+
+DynamoDB Single-Table設計向けのRecords Lambda関数をデプロイするTerraformモジュールです。
+
+## 概要
+
+このモジュールは、以下のリソースをデプロイします：
+
+- AWS Lambda関数（Records Lambda）
+- Lambda Function URL（認証付き）
+- IAMロールとポリシー
+- CloudWatch Logsロググループ
+
+## 使用方法
+
+### 基本的な使用例
+
+```hcl
+module "lambda_records" {
+  source = "github.com/exabugs/dynamodb-client//terraform"
+
+  project_name = "my-project"
+  environment  = "dev"
+  region       = "us-east-1"
+
+  # DynamoDB設定
+  dynamodb_table_name = module.dynamodb.table_name
+  dynamodb_table_arn  = module.dynamodb.table_arn
+
+  # Cognito設定
+  cognito_user_pool_id = module.cognito.user_pool_id
+
+  # シャドウ設定（base64エンコード）
+  shadow_config = base64encode(file("${path.root}/../config/shadow.config.json"))
+
+  # ログ設定
+  log_retention_days = 7
+  log_level          = "info"
+}
+```
+
+### ローカル開発時
+
+```hcl
+module "lambda_records" {
+  source = "./terraform"  # 相対パス
+
+  project_name = "my-project"
+  environment  = "dev"
+  region       = "us-east-1"
+
+  # DynamoDB設定
+  dynamodb_table_name = module.dynamodb.table_name
+  dynamodb_table_arn  = module.dynamodb.table_arn
+
+  # Cognito設定
+  cognito_user_pool_id = module.cognito.user_pool_id
+
+  # シャドウ設定（base64エンコード）
+  shadow_config = base64encode(file("${path.root}/../config/shadow.config.json"))
+}
+```
+
+## 入力変数
+
+### 必須変数
+
+| 変数名                 | 型     | 説明                             |
+| ---------------------- | ------ | -------------------------------- |
+| `project_name`         | string | プロジェクト名                   |
+| `environment`          | string | 環境（dev/stg/prd）              |
+| `region`               | string | AWSリージョン                    |
+| `dynamodb_table_name`  | string | DynamoDBテーブル名               |
+| `dynamodb_table_arn`   | string | DynamoDBテーブルARN              |
+| `cognito_user_pool_id` | string | Cognito User Pool ID（認証用）   |
+| `shadow_config`        | string | シャドウ設定（base64エンコード） |
+
+### オプション変数
+
+| 変数名               | 型     | デフォルト値 | 説明                                |
+| -------------------- | ------ | ------------ | ----------------------------------- |
+| `log_retention_days` | number | 7            | CloudWatch Logsの保持期間（日）     |
+| `log_level`          | string | "info"       | ログレベル（debug/info/warn/error） |
+| `lambda_timeout`     | number | 900          | Lambda関数のタイムアウト（秒）      |
+| `lambda_memory`      | number | 512          | Lambda関数のメモリサイズ（MB）      |
+
+## 出力
+
+| 出力名           | 説明                             |
+| ---------------- | -------------------------------- |
+| `function_name`  | Lambda関数名                     |
+| `function_arn`   | Lambda関数ARN                    |
+| `function_url`   | Lambda Function URL              |
+| `log_group_name` | CloudWatch Logsロググループ名    |
+| `role_arn`       | Lambda実行ロールARN              |
+| `shadow_config`  | シャドウ設定（base64エンコード） |
+
+## 要件
+
+- **Terraform**: >= 1.5.0
+- **AWS Provider**: >= 5.0.0
+- **DynamoDBテーブル**: Single-Table設計のテーブルが必要
+- **Cognito User Pool**: 認証用のUser Poolが必要
+
+## シャドウ設定
+
+シャドウ設定は、DynamoDBのソート可能フィールドを定義するJSON設定ファイルです。
+
+### 設定例
+
+```json
+{
+  "$schemaVersion": "1.0",
+  "resources": {
+    "articles": {
+      "sortDefaults": {
+        "field": "updatedAt",
+        "order": "DESC"
+      },
+      "shadows": {
+        "name": { "type": "string" },
+        "status": { "type": "string" },
+        "createdAt": { "type": "datetime" },
+        "updatedAt": { "type": "datetime" }
+      }
+    }
+  }
+}
+```
+
+### Base64エンコード
+
+Terraformでは、シャドウ設定をbase64エンコードして渡します：
+
+```hcl
+shadow_config = base64encode(file("${path.root}/../config/shadow.config.json"))
+```
+
+## IAMポリシー
+
+このモジュールは、最小権限の原則に従ったIAMポリシーを作成します：
+
+### Records Lambda IAMロール
+
+- **DynamoDB**: 特定テーブルへの読み書き
+  - GetItem, PutItem, UpdateItem, DeleteItem, Query, Scan, BatchGetItem, TransactWriteItems
+- **CloudWatch Logs**: ログ出力（AWSマネージドポリシー）
+- **X-Ray**: トレーシング（AWSマネージドポリシー）
+
+## デプロイ
+
+### 初回デプロイ
+
+```bash
+cd infra
+terraform init
+terraform plan -var-file=envs/dev.tfvars
+terraform apply -var-file=envs/dev.tfvars
+```
+
+### 更新デプロイ
+
+```bash
+cd infra
+terraform plan -var-file=envs/dev.tfvars
+terraform apply -var-file=envs/dev.tfvars
+```
+
+### Makefileを使用（推奨）
+
+```bash
+cd infra
+make plan ENV=dev
+make apply ENV=dev
+```
+
+## トラブルシューティング
+
+### Lambda関数が更新されない
+
+Lambda関数のソースコードを変更した場合、ビルドしてからデプロイしてください：
+
+```bash
+# ビルド
+make build
+
+# デプロイ
+cd infra
+make apply ENV=dev
+```
+
+### シャドウ設定が反映されない
+
+シャドウ設定を変更した場合、Lambda関数が自動的に再デプロイされます：
+
+```bash
+cd infra
+make plan ENV=dev  # 差分を確認
+make apply ENV=dev # 適用
+```
+
+### ログが表示されない
+
+CloudWatch Logsを確認してください：
+
+```bash
+# ログを表示
+make logs-records ENV=dev
+
+# または直接AWS CLIで
+aws logs tail /aws/lambda/my-project-dev-records --follow
+```
+
+## 関連ドキュメント
+
+- [パッケージREADME](../README.md) - クライアントライブラリの使用方法
+- [使用ガイド](../CLIENT_USAGE.md) - 認証方式別の詳細な使用方法
+- [アーキテクチャ](../ARCHITECTURE.md) - 内部設計とコンポーネント構成
+
+## ライセンス
+
+MIT