@exabugs/dynamodb-client 0.1.0

package/dist/server/shadow/generator.d.ts

@@ -0,0 +1,104 @@
+import type { ShadowFieldConfig, ShadowFieldType } from './types.js';
+/**
+ * シャドースキーマ（簡易版）
+ */
+export interface ShadowSchema {
+    /** リソース名 */
+    resource: string;
+    /** ソート可能なフィールド定義 */
+    sortableFields: Record<string, ShadowFieldConfig>;
+}
+/**
+ * シャドウレコード
+ */
+export interface ShadowRecord {
+    /** パーティションキー（リソース名） */
+    PK: string;
+    /** ソートキー（シャドウキー） */
+    SK: string;
+    /** レコードデータ（最小限の情報） */
+    data: {
+        /** レコードID */
+        id: string;
+    };
+}
+/**
+ * 文字列値をエスケープする
+ * ルール: # → ##, スペース → #
+ *
+ * @param value - エスケープする文字列
+ * @returns エスケープされた文字列
+ */
+export declare function escapeString(value: string): string;
+/**
+ * 数値を20桁のゼロ埋め文字列に変換する
+ *
+ * @param value - 変換する数値（null/undefinedも許容）
+ * @returns 20桁のゼロ埋め文字列
+ */
+export declare function formatNumber(value: number | null | undefined): string;
+/**
+ * 日時をUTC ISO 8601形式にフォーマットする
+ *
+ * @param value - 日時文字列またはDateオブジェクト（null/undefinedも許容）
+ * @returns UTC ISO 8601形式の文字列
+ */
+export declare function formatDatetime(value: string | Date | null | undefined): string;
+/**
+ * 真偽値を"0"または"1"に変換する
+ *
+ * @param value - 真偽値（null/undefinedも許容）
+ * @returns "0"（false）、"1"（true）、または空文字（null/undefined）
+ */
+export declare function formatBoolean(value: boolean | null | undefined): string;
+/**
+ * フィールド値を型に応じてフォーマットする
+ *
+ * @param type - フィールドの型
+ * @param value - フォーマットする値（null/undefinedも許容）
+ * @returns フォーマットされた文字列
+ */
+export declare function formatFieldValue(type: ShadowFieldType, value: string | number | Date | boolean | null | undefined): string;
+/**
+ * シャドーSKを生成する
+ * フォーマット: {fieldName}#{formattedValue}#id#{recordId}
+ *
+ * @param fieldName - フィールド名
+ * @param value - フィールド値
+ * @param recordId - レコードID（ULID）
+ * @param type - フィールドの型（デフォルト: 'string'）
+ * @returns 生成されたシャドーSK
+ *
+ * @example
+ * generateShadowSK('name', 'Tech News', '01HZXY123', 'string')
+ * // => 'name#Tech#News#id#01HZXY123'
+ *
+ * @example
+ * generateShadowSK('priority', 123, '01HZXY123', 'number')
+ * // => 'priority#00000000000000000123#id#01HZXY123'
+ *
+ * @example
+ * generateShadowSK('createdAt', '2025-11-12T10:00:00.000Z', '01HZXY123', 'datetime')
+ * // => 'createdAt#2025-11-12T10:00:00.000Z#id#01HZXY123'
+ */
+export declare function generateShadowSK(fieldName: string, value: string | number | Date, recordId: string, type?: ShadowFieldType): string;
+/**
+ * レコードIDからメインレコードのSKを生成する
+ * フォーマット: id#{recordId}
+ *
+ * @param recordId - レコードID（ULID）
+ * @returns メインレコードのSK
+ */
+export declare function generateMainRecordSK(recordId: string): string;
+/**
+ * レコードからシャドウレコードを生成する
+ *
+ * sortableFieldsに定義されたフィールドのみを処理します。
+ * 値がundefined/nullの場合は空文字として扱い、シャドウレコードを生成します。
+ *
+ * @param record - レコードオブジェクト（idフィールドを含む）
+ * @param schema - シャドウスキーマ定義
+ * @returns 生成されたシャドウレコードの配列
+ */
+export declare function generateShadowRecords(record: Record<string, unknown>, schema: ShadowSchema): ShadowRecord[];
+//# sourceMappingURL=generator.d.ts.map

package/dist/server/shadow/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/server/shadow/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,IAAI,EAAE;QACJ,aAAa;QACb,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAcrE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAa9E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAKvE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GACzD,MAAM,CAiBR;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,eAA0B,GAC/B,MAAM,CAGR;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,YAAY,GACnB,YAAY,EAAE,CAqBhB"}

package/dist/server/shadow/generator.js

@@ -0,0 +1,148 @@
+/**
+ * 文字列値をエスケープする
+ * ルール: # → ##, スペース → #
+ *
+ * @param value - エスケープする文字列
+ * @returns エスケープされた文字列
+ */
+export function escapeString(value) {
+    return value
+        .replace(/#/g, '##') // # を ## に置換
+        .replace(/ /g, '#'); // スペースを # に置換
+}
+/**
+ * 数値を20桁のゼロ埋め文字列に変換する
+ *
+ * @param value - 変換する数値（null/undefinedも許容）
+ * @returns 20桁のゼロ埋め文字列
+ */
+export function formatNumber(value) {
+    // null/undefined は空文字を返す
+    if (value === null || value === undefined) {
+        return '';
+    }
+    if (!Number.isFinite(value)) {
+        throw new Error(`Invalid number value: ${value}`);
+    }
+    // 負の数値は0として扱う（または別のエラーハンドリング）
+    const normalized = Math.max(0, Math.floor(value));
+    return normalized.toString().padStart(20, '0');
+}
+/**
+ * 日時をUTC ISO 8601形式にフォーマットする
+ *
+ * @param value - 日時文字列またはDateオブジェクト（null/undefinedも許容）
+ * @returns UTC ISO 8601形式の文字列
+ */
+export function formatDatetime(value) {
+    // null/undefined は空文字を返す
+    if (value === null || value === undefined) {
+        return '';
+    }
+    const date = typeof value === 'string' ? new Date(value) : value;
+    if (isNaN(date.getTime())) {
+        throw new Error(`Invalid datetime value: ${value}`);
+    }
+    return date.toISOString();
+}
+/**
+ * 真偽値を"0"または"1"に変換する
+ *
+ * @param value - 真偽値（null/undefinedも許容）
+ * @returns "0"（false）、"1"（true）、または空文字（null/undefined）
+ */
+export function formatBoolean(value) {
+    if (value === null || value === undefined) {
+        return '';
+    }
+    return value ? '1' : '0';
+}
+/**
+ * フィールド値を型に応じてフォーマットする
+ *
+ * @param type - フィールドの型
+ * @param value - フォーマットする値（null/undefinedも許容）
+ * @returns フォーマットされた文字列
+ */
+export function formatFieldValue(type, value) {
+    switch (type) {
+        case 'string':
+            // 文字列型の場合、null/undefinedは空文字として扱う
+            if (value === null || value === undefined) {
+                return '';
+            }
+            return escapeString(String(value));
+        case 'number':
+            return formatNumber(value);
+        case 'datetime':
+            return formatDatetime(value);
+        case 'boolean':
+            return formatBoolean(value);
+        default:
+            throw new Error(`Unknown shadow field type: ${type}`);
+    }
+}
+/**
+ * シャドーSKを生成する
+ * フォーマット: {fieldName}#{formattedValue}#id#{recordId}
+ *
+ * @param fieldName - フィールド名
+ * @param value - フィールド値
+ * @param recordId - レコードID（ULID）
+ * @param type - フィールドの型（デフォルト: 'string'）
+ * @returns 生成されたシャドーSK
+ *
+ * @example
+ * generateShadowSK('name', 'Tech News', '01HZXY123', 'string')
+ * // => 'name#Tech#News#id#01HZXY123'
+ *
+ * @example
+ * generateShadowSK('priority', 123, '01HZXY123', 'number')
+ * // => 'priority#00000000000000000123#id#01HZXY123'
+ *
+ * @example
+ * generateShadowSK('createdAt', '2025-11-12T10:00:00.000Z', '01HZXY123', 'datetime')
+ * // => 'createdAt#2025-11-12T10:00:00.000Z#id#01HZXY123'
+ */
+export function generateShadowSK(fieldName, value, recordId, type = 'string') {
+    const formattedValue = formatFieldValue(type, value);
+    return `${fieldName}#${formattedValue}#id#${recordId}`;
+}
+/**
+ * レコードIDからメインレコードのSKを生成する
+ * フォーマット: id#{recordId}
+ *
+ * @param recordId - レコードID（ULID）
+ * @returns メインレコードのSK
+ */
+export function generateMainRecordSK(recordId) {
+    return `id#${recordId}`;
+}
+/**
+ * レコードからシャドウレコードを生成する
+ *
+ * sortableFieldsに定義されたフィールドのみを処理します。
+ * 値がundefined/nullの場合は空文字として扱い、シャドウレコードを生成します。
+ *
+ * @param record - レコードオブジェクト（idフィールドを含む）
+ * @param schema - シャドウスキーマ定義
+ * @returns 生成されたシャドウレコードの配列
+ */
+export function generateShadowRecords(record, schema) {
+    const shadows = [];
+    // sortableFieldsに定義されたフィールドのみ処理
+    for (const [fieldName, fieldDef] of Object.entries(schema.sortableFields)) {
+        const value = record[fieldName];
+        // 値を型に応じて正規化（undefined/nullは空文字として扱う）
+        const normalizedValue = formatFieldValue(fieldDef.type, value);
+        // シャドウキーを生成
+        const sk = `${fieldName}#${normalizedValue}#id#${record.id}`;
+        shadows.push({
+            PK: schema.resource,
+            SK: sk,
+            data: { id: record.id },
+        });
+    }
+    return shadows;
+}
+//# sourceMappingURL=generator.js.map

package/dist/server/shadow/generator.js.map

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

package/dist/server/shadow/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * シャドー管理モジュール
+ *
+ * DynamoDB Single-Table設計における動的シャドーレコード管理を提供します。
+ */
+export type { ShadowFieldType, ShadowFieldConfig, ResourceShadowConfig, ShadowConfig, ShadowDiff, } from './types.js';
+export type { ShadowSchema, ShadowRecord } from './generator.js';
+export { escapeString, formatNumber, formatDatetime, formatBoolean, formatFieldValue, generateShadowSK, generateMainRecordSK, generateShadowRecords, } from './generator.js';
+export { calculateShadowDiff, isDiffEmpty, mergeShadowDiffs } from './differ.js';
+export { getShadowConfig, getResourceSchema, getShadowConfigHash, getSchemaVersion, clearShadowConfigCache, getAllShadowFields, isValidShadowField, getDefaultSort, } from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/shadow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/shadow/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGjF,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/server/shadow/index.js

@@ -0,0 +1,11 @@
+/**
+ * シャドー管理モジュール
+ *
+ * DynamoDB Single-Table設計における動的シャドーレコード管理を提供します。
+ */
+export { escapeString, formatNumber, formatDatetime, formatBoolean, formatFieldValue, generateShadowSK, generateMainRecordSK, generateShadowRecords, } from './generator.js';
+// 差分計算関数のエクスポート
+export { calculateShadowDiff, isDiffEmpty, mergeShadowDiffs } from './differ.js';
+// 設定管理関数のエクスポート
+export { getShadowConfig, getResourceSchema, getShadowConfigHash, getSchemaVersion, clearShadowConfigCache, getAllShadowFields, isValidShadowField, getDefaultSort, } from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/server/shadow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/shadow/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,gBAAgB;AAChB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjF,gBAAgB;AAChB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/server/shadow/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * シャドーフィールドの型定義
+ */
+export type ShadowFieldType = 'string' | 'number' | 'datetime' | 'boolean';
+/**
+ * シャドー設定のフィールド定義
+ */
+export interface ShadowFieldConfig {
+    type: ShadowFieldType;
+}
+/**
+ * リソースごとのシャドー設定
+ */
+export interface ResourceShadowConfig {
+    sortDefaults: {
+        field: string;
+        order: 'ASC' | 'DESC';
+    };
+    shadows: {
+        [fieldName: string]: ShadowFieldConfig;
+    };
+    ttl?: {
+        days: number;
+    };
+}
+/**
+ * shadow.config.jsonの全体構造
+ */
+export interface ShadowConfig {
+    $schemaVersion: string;
+    resources: {
+        [resourceName: string]: ResourceShadowConfig;
+    };
+}
+/**
+ * シャドー差分計算の結果
+ */
+export interface ShadowDiff {
+    /** 削除すべきシャドーSKのリスト */
+    toDelete: string[];
+    /** 追加すべきシャドーSKのリスト */
+    toAdd: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/shadow/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/server/shadow/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;KACvB,CAAC;IACF,OAAO,EAAE;QACP,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAAC;KACxC,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE;QACT,CAAC,YAAY,EAAE,MAAM,GAAG,oBAAoB,CAAC;KAC9C,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,sBAAsB;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/server/shadow/types.js

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

package/dist/server/shadow/types.js.map

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

package/dist/server/types.d.ts

@@ -0,0 +1,295 @@
+/**
+ * Records Lambda API型定義
+ * Lambda Function URL (RPC スタイル) で使用される型定義
+ * MongoDB 風の操作インターフェース
+ */
+/**
+ * API操作タイプ（MongoDB 風）
+ */
+export type ApiOperation = 'find' | 'findOne' | 'findMany' | 'findManyReference' | 'insertOne' | 'updateOne' | 'updateMany' | 'deleteOne' | 'deleteMany' | 'insertMany';
+/**
+ * API リクエスト（共通）
+ */
+export interface ApiRequest<T = unknown> {
+    /** 操作名 */
+    op: ApiOperation;
+    /** リソース名（例: "articles", "tasks"） */
+    resource: string;
+    /** 操作パラメータ */
+    params: T;
+}
+/**
+ * find パラメータ
+ */
+export interface FindParams {
+    /** フィルター条件 */
+    filter?: Record<string, unknown>;
+    /** ソート条件 */
+    sort?: {
+        /** ソート対象フィールド名（シャドー名） */
+        field: string;
+        /** ソート順序（ASC: 昇順, DESC: 降順） */
+        order: 'ASC' | 'DESC';
+    };
+    /** ページネーション条件 */
+    pagination?: {
+        /** ページ番号（1始まり） */
+        page?: number;
+        /** 1ページあたりの件数（最大50件） */
+        perPage?: number;
+        /** 次ページトークン（Base64URL エンコード） */
+        nextToken?: string;
+    };
+}
+/**
+ * findOne パラメータ
+ */
+export interface FindOneParams {
+    /** 取得するレコードのID */
+    id: string;
+}
+/**
+ * findMany パラメータ
+ */
+export interface FindManyParams {
+    /** 取得するレコードのIDリスト */
+    ids: string[];
+}
+/**
+ * findManyReference パラメータ
+ */
+export interface FindManyReferenceParams {
+    /** 参照フィールド名（例: "userId"） */
+    target: string;
+    /** 参照先ID */
+    id: string;
+    /** フィルター条件 */
+    filter?: Record<string, unknown>;
+    /** ソート条件 */
+    sort?: {
+        field: string;
+        order: 'ASC' | 'DESC';
+    };
+    /** ページネーション条件 */
+    pagination?: {
+        page?: number;
+        perPage?: number;
+        nextToken?: string;
+    };
+}
+/**
+ * insertOne パラメータ
+ */
+export interface InsertOneParams {
+    /** 作成するレコードのデータ */
+    data: Record<string, unknown>;
+}
+/**
+ * updateOne パラメータ
+ */
+export interface UpdateOneParams {
+    /** 更新対象のレコードID */
+    id: string;
+    /** 更新データ（JSON Merge Patch形式） */
+    data: Record<string, unknown>;
+}
+/**
+ * updateMany パラメータ
+ */
+export interface UpdateManyParams {
+    /** 更新対象のレコードIDリスト */
+    ids: string[];
+    /** 更新データ（JSON Merge Patch形式） */
+    data: Record<string, unknown>;
+}
+/**
+ * deleteOne パラメータ
+ */
+export interface DeleteOneParams {
+    /** 削除対象のレコードID */
+    id: string;
+}
+/**
+ * deleteMany パラメータ
+ */
+export interface DeleteManyParams {
+    /** 削除対象のレコードIDリスト */
+    ids: string[];
+}
+/**
+ * insertMany パラメータ
+ */
+export interface InsertManyParams {
+    /** 作成するレコードのデータ配列 */
+    data: Record<string, unknown>[];
+}
+/**
+ * API 成功レスポンス
+ */
+export interface ApiSuccessResponse<T> {
+    /** 成功フラグ */
+    success: true;
+    /** レスポンスデータ */
+    data: T;
+}
+/**
+ * API エラーレスポンス
+ */
+export interface ApiErrorResponse {
+    /** 成功フラグ */
+    success: false;
+    /** エラー情報 */
+    error: {
+        /** エラーコード */
+        code: string;
+        /** エラーメッセージ */
+        message: string;
+        /** HTTPステータスコード */
+        statusCode: number;
+        /** 追加詳細情報（オプション） */
+        details?: unknown;
+    };
+}
+/**
+ * API レスポンス（共通）
+ */
+export type ApiResponse<T> = ApiSuccessResponse<T> | ApiErrorResponse;
+/**
+ * find レスポンスデータ
+ */
+export interface FindResult {
+    /** レコードリスト */
+    items: Record<string, unknown>[];
+    /** ページ情報 */
+    pageInfo: {
+        /** 次ページが存在するか */
+        hasNextPage: boolean;
+        /** 前ページが存在するか */
+        hasPreviousPage: boolean;
+    };
+    /** 次ページトークン（存在する場合） */
+    nextToken?: string;
+    /** 総件数（オプション、パフォーマンス影響あり） */
+    total?: number;
+}
+/**
+ * findOne レスポンスデータ
+ */
+export type FindOneResult = Record<string, unknown>;
+/**
+ * findMany レスポンスデータ
+ */
+export type FindManyResult = Record<string, unknown>[];
+/**
+ * findManyReference レスポンスデータ
+ */
+export interface FindManyReferenceResult {
+    /** レコードリスト */
+    items: Record<string, unknown>[];
+    /** ページ情報 */
+    pageInfo: {
+        hasNextPage: boolean;
+        hasPreviousPage: boolean;
+    };
+    /** 次ページトークン（存在する場合） */
+    nextToken?: string;
+    /** 総件数（オプション） */
+    total?: number;
+}
+/**
+ * insertOne レスポンスデータ
+ */
+export type InsertOneResult = Record<string, unknown>;
+/**
+ * updateOne レスポンスデータ
+ */
+export type UpdateOneResult = Record<string, unknown>;
+/**
+ * 操作エラー
+ * 部分失敗時の個別エラー情報
+ */
+export interface OperationError {
+    /** エラーが発生したレコードのID */
+    id: string;
+    /** エラーコード */
+    code: string;
+    /** エラーメッセージ */
+    message: string;
+}
+/**
+ * バルク操作の統一レスポンス形式（Records Lambda内部形式）
+ *
+ * Records Lambdaは統一された内部形式でレスポンスを返却します。
+ * この形式は情報を保持し、Collection.tsでMongoDB互換形式に変換されます。
+ */
+export interface BulkOperationResult {
+    /** 成功件数 */
+    count: number;
+    /** 成功したレコードのインデックスとID（{ 0: 'A', 2: 'C' }） */
+    successIds: Record<number, string>;
+    /** 失敗したレコードのインデックス（{ 1: 'B' }） */
+    failedIds: Record<number, string>;
+    /** エラー情報（インデックスをキーとする）（{ 1: { code: '...', message: '...' } }） */
+    errors: Record<number, OperationError>;
+}
+/**
+ * updateMany レスポンスデータ（Records Lambda内部形式）
+ */
+export interface UpdateManyResult extends BulkOperationResult {
+}
+/**
+ * deleteOne レスポンスデータ
+ */
+export interface DeleteOneResult {
+    /** 削除されたレコードのID */
+    id: string;
+}
+/**
+ * deleteMany レスポンスデータ（Records Lambda内部形式）
+ */
+export interface DeleteManyResult extends BulkOperationResult {
+}
+/**
+ * insertMany レスポンスデータ（Records Lambda内部形式）
+ */
+export interface InsertManyResult extends BulkOperationResult {
+}
+/**
+ * 操作ごとのパラメータ型マッピング
+ */
+export type ApiParamsMap = {
+    find: FindParams;
+    findOne: FindOneParams;
+    findMany: FindManyParams;
+    findManyReference: FindManyReferenceParams;
+    insertOne: InsertOneParams;
+    updateOne: UpdateOneParams;
+    updateMany: UpdateManyParams;
+    deleteOne: DeleteOneParams;
+    deleteMany: DeleteManyParams;
+    insertMany: InsertManyParams;
+};
+/**
+ * 操作ごとのレスポンスデータ型マッピング
+ */
+export type ApiDataMap = {
+    find: FindResult;
+    findOne: FindOneResult;
+    findMany: FindManyResult;
+    findManyReference: FindManyReferenceResult;
+    insertOne: InsertOneResult;
+    updateOne: UpdateOneResult;
+    updateMany: UpdateManyResult;
+    deleteOne: DeleteOneResult;
+    deleteMany: DeleteManyResult;
+    insertMany: InsertManyResult;
+};
+/**
+ * 型安全な API リクエスト
+ */
+export type TypedApiRequest<T extends ApiOperation> = ApiRequest<ApiParamsMap[T]>;
+/**
+ * 型安全な API レスポンス
+ */
+export type TypedApiResponse<T extends ApiOperation> = ApiResponse<ApiDataMap[T]>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/server/types.js

@@ -0,0 +1,7 @@
+/**
+ * Records Lambda API型定義
+ * Lambda Function URL (RPC スタイル) で使用される型定義
+ * MongoDB 風の操作インターフェース
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/types.js.map

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