@exabugs/dynamodb-client 0.2.2 → 0.3.2

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

@@ -1,114 +1,48 @@
 /**
- * サーバーサイドシャドウ設定管理
+ * サーバーサイドシャドウ設定管理（簡素化版）
  *
  * シャドー設定を環境変数から読み込み、グローバル変数にキャッシュします。
- * 設定はTerraformデプロイ時に環境変数として埋め込まれるため、
- * 実行時のI/Oが不要で、最も高速かつシンプルです。
+ * JSON設定ファイルは廃止され、環境変数のみで管理されます。
  *
  * キャッシュの動作:
- * - 初回呼び出し時: 環境変数からパースしてキャッシュ
+ * - 初回呼び出し時: 環境変数から読み込んでキャッシュ
  * - 2回目以降: キャッシュから即座に取得
  * - キャッシュ有効期間: Lambda実行環境が存在する間（通常15分〜数時間）
  *
  * 設定変更の反映:
- * - config/shadow.config.jsonを変更
- * - Terraformで再度apply（環境変数が更新される）
+ * - Terraformで環境変数を変更
  * - Lambda関数が自動的に再デプロイされ、新しい設定が反映される
  *
- * 要件: 8.7
+ * 要件: 2.9-2.11
  */
-import type { ShadowSchema } from './generator.js';
-import type { ShadowFieldConfig } from './types.js';
 /**
- * シャドー設定の全体構造
+ * シャドー設定（簡素化版）
  */
 export interface ShadowConfig {
-    /** スキーマバージョン */
-    $schemaVersion: string;
-    /** 生成日時 */
-    $generatedAt?: string;
-    /** 生成元ファイル */
-    $generatedFrom?: string;
-    /** データベース設定 */
-    database?: {
-        name: string;
-        timestamps?: {
-            createdAt: string;
-            updatedAt: string;
-        };
-    };
-    /** リソースごとの設定 */
-    resources: {
-        [resourceName: string]: {
-            /** ソート可能なフィールド定義 */
-            shadows: {
-                [fieldName: string]: {
-                    /** フィールドの型 */
-                    type: 'string' | 'number' | 'datetime' | 'boolean';
-                };
-            };
-            /** デフォルトソート設定 */
-            sortDefaults: {
-                field: string;
-                order: 'ASC' | 'DESC';
-            };
-            /** TTL設定（オプション） */
-            ttl?: {
-                days: number;
-            };
-        };
-    };
+    /** タイムスタンプフィールド名 */
+    createdAtField: string;
+    updatedAtField: string;
+    /** プリミティブ型の最大バイト数（array/objectは2倍） */
+    stringMaxBytes: number;
+    /** 数値のパディング桁数 */
+    numberPadding: number;
 }
 /**
- * シャドー設定を取得（キャッシュ付き）
+ * シャドー設定を取得（環境変数から）
  *
- * 環境変数SHADOW_CONFIGからbase64エンコードされたJSON文字列をデコードしてパースして取得。
- * 初回呼び出し時のみパース処理を行い、以降はキャッシュを使用。
+ * 環境変数から設定を読み込み、グローバル変数にキャッシュします。
+ * 初回呼び出し時のみ環境変数を読み込み、以降はキャッシュを使用。
  *
  * @returns シャドー設定
- * @throws 環境変数が未設定、または不正な形式の場合
+ * @throws 環境変数が不正な値の場合
  *
  * @example
  * ```typescript
  * const config = getShadowConfig();
- * const articleSchema = getResourceSchema(config, 'articles');
- * const shadows = generateShadowRecords(record, articleSchema);
+ * // => { createdAtField: 'createdAt', updatedAtField: 'updatedAt', stringMaxBytes: 100, numberPadding: 20 }
  * ```
  */
 export declare function getShadowConfig(): ShadowConfig;
-/**
- * 特定のリソースのシャドースキーマを取得する
- *
- * @param config - シャドー設定全体
- * @param resourceName - リソース名（例: 'articles', 'tasks'）
- * @returns シャドースキーマ
- * @throws リソースが設定に存在しない場合
- *
- * @example
- * ```typescript
- * const config = getShadowConfig();
- * const schema = getResourceSchema(config, 'articles');
- * // => { resource: 'articles', sortableFields: { name: { type: 'string' }, ... } }
- * ```
- */
-export declare function getResourceSchema(config: ShadowConfig, resourceName: string): ShadowSchema;
-/**
- * 設定ハッシュを取得
- *
- * レコード作成時にメタデータとして保存するために使用。
- * SHADOW_CONFIG環境変数（base64エンコードされたJSON）からSHA-256ハッシュを生成する。
- *
- * @returns 設定ハッシュ（SHA-256）
- */
-export declare function getShadowConfigHash(): string;
-/**
- * スキーマバージョンを取得
- *
- * レコード作成時にメタデータとして保存するために使用。
- *
- * @returns スキーマバージョン
- */
-export declare function getSchemaVersion(): string;
 /**
  * キャッシュをクリアする（テスト用）
  *
@@ -116,32 +50,4 @@ export declare function getSchemaVersion(): string;
  * テスト環境でのみ、テスト間でキャッシュをクリアするために使用。
  */
 export declare function clearShadowConfigCache(): void;
-/**
- * リソースの全シャドーフィールドを取得する
- *
- * @param config - シャドー設定全体
- * @param resourceName - リソース名
- * @returns 全シャドーフィールドの設定
- */
-export declare function getAllShadowFields(config: ShadowConfig, resourceName: string): Record<string, ShadowFieldConfig>;
-/**
- * 指定されたフィールドが有効なシャドーフィールドかどうかを検証する
- *
- * @param config - シャドー設定全体
- * @param resourceName - リソース名
- * @param fieldName - 検証するフィールド名
- * @returns フィールドが有効な場合true
- */
-export declare function isValidShadowField(config: ShadowConfig, resourceName: string, fieldName: string): boolean;
-/**
- * リソースのデフォルトソート設定を取得する
- *
- * @param config - シャドー設定全体
- * @param resourceName - リソース名
- * @returns デフォルトソート設定
- */
-export declare function getDefaultSort(config: ShadowConfig, resourceName: string): {
-    field: string;
-    order: 'ASC' | 'DESC';
-};
 //# sourceMappingURL=config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/server/shadow/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gBAAgB;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe;IACf,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE;YACX,SAAS,EAAE,MAAM,CAAC;YAClB,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC;KACH,CAAC;IACF,gBAAgB;IAChB,SAAS,EAAE;QACT,CAAC,YAAY,EAAE,MAAM,GAAG;YACtB,oBAAoB;YACpB,OAAO,EAAE;gBACP,CAAC,SAAS,EAAE,MAAM,GAAG;oBACnB,cAAc;oBACd,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;iBACpD,CAAC;aACH,CAAC;YACF,iBAAiB;YACjB,YAAY,EAAE;gBACZ,KAAK,EAAE,MAAM,CAAC;gBACd,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;aACvB,CAAC;YACF,mBAAmB;YACnB,GAAG,CAAC,EAAE;gBACJ,IAAI,EAAE,MAAM,CAAC;aACd,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAOD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,IAAI,YAAY,CA8B9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY,CAW1F;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAiB5C;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAQnC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAOT;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,MAAM,GACnB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,CAQ1C"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/server/shadow/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oBAAoB;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAOD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAmB9C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/server/shadow/config.js

@@ -1,110 +1,57 @@
+/**
+ * サーバーサイドシャドウ設定管理（簡素化版）
+ *
+ * シャドー設定を環境変数から読み込み、グローバル変数にキャッシュします。
+ * JSON設定ファイルは廃止され、環境変数のみで管理されます。
+ *
+ * キャッシュの動作:
+ * - 初回呼び出し時: 環境変数から読み込んでキャッシュ
+ * - 2回目以降: キャッシュから即座に取得
+ * - キャッシュ有効期間: Lambda実行環境が存在する間（通常15分〜数時間）
+ *
+ * 設定変更の反映:
+ * - Terraformで環境変数を変更
+ * - Lambda関数が自動的に再デプロイされ、新しい設定が反映される
+ *
+ * 要件: 2.9-2.11
+ */
 /**
  * グローバル変数にキャッシュ（Lambda実行環境で再利用）
  */
 let cachedShadowConfig = null;
 /**
- * シャドー設定を取得（キャッシュ付き）
+ * シャドー設定を取得（環境変数から）
  *
- * 環境変数SHADOW_CONFIGからbase64エンコードされたJSON文字列をデコードしてパースして取得。
- * 初回呼び出し時のみパース処理を行い、以降はキャッシュを使用。
+ * 環境変数から設定を読み込み、グローバル変数にキャッシュします。
+ * 初回呼び出し時のみ環境変数を読み込み、以降はキャッシュを使用。
  *
  * @returns シャドー設定
- * @throws 環境変数が未設定、または不正な形式の場合
+ * @throws 環境変数が不正な値の場合
  *
  * @example
  * ```typescript
  * const config = getShadowConfig();
- * const articleSchema = getResourceSchema(config, 'articles');
- * const shadows = generateShadowRecords(record, articleSchema);
+ * // => { createdAtField: 'createdAt', updatedAtField: 'updatedAt', stringMaxBytes: 100, numberPadding: 20 }
  * ```
  */
 export function getShadowConfig() {
     if (!cachedShadowConfig) {
-        const configBase64 = process.env.SHADOW_CONFIG;
-        if (!configBase64) {
-            throw new Error('SHADOW_CONFIG environment variable is not set');
+        cachedShadowConfig = {
+            createdAtField: process.env.SHADOW_CREATED_AT_FIELD || 'createdAt',
+            updatedAtField: process.env.SHADOW_UPDATED_AT_FIELD || 'updatedAt',
+            stringMaxBytes: parseInt(process.env.SHADOW_STRING_MAX_BYTES || '100', 10),
+            numberPadding: parseInt(process.env.SHADOW_NUMBER_PADDING || '15', 10),
+        };
+        // バリデーション
+        if (cachedShadowConfig.stringMaxBytes <= 0) {
+            throw new Error('SHADOW_STRING_MAX_BYTES must be positive');
         }
-        try {
-            // Base64デコード
-            const configJson = Buffer.from(configBase64, 'base64').toString('utf-8');
-            cachedShadowConfig = JSON.parse(configJson);
-            // 基本的なバリデーション
-            if (!cachedShadowConfig.$schemaVersion) {
-                throw new Error('Missing $schemaVersion in shadow config');
-            }
-            if (!cachedShadowConfig.resources || typeof cachedShadowConfig.resources !== 'object') {
-                throw new Error('Missing or invalid resources in shadow config');
-            }
-        }
-        catch (error) {
-            if (error instanceof SyntaxError) {
-                throw new Error(`Invalid JSON in SHADOW_CONFIG environment variable: ${error.message}`);
-            }
-            throw error;
+        if (cachedShadowConfig.numberPadding <= 0 || cachedShadowConfig.numberPadding > 15) {
+            throw new Error('SHADOW_NUMBER_PADDING must be between 1 and 15');
         }
     }
     return cachedShadowConfig;
 }
-/**
- * 特定のリソースのシャドースキーマを取得する
- *
- * @param config - シャドー設定全体
- * @param resourceName - リソース名（例: 'articles', 'tasks'）
- * @returns シャドースキーマ
- * @throws リソースが設定に存在しない場合
- *
- * @example
- * ```typescript
- * const config = getShadowConfig();
- * const schema = getResourceSchema(config, 'articles');
- * // => { resource: 'articles', sortableFields: { name: { type: 'string' }, ... } }
- * ```
- */
-export function getResourceSchema(config, resourceName) {
-    const resourceConfig = config.resources[resourceName];
-    if (!resourceConfig) {
-        throw new Error(`Resource '${resourceName}' not found in shadow config`);
-    }
-    return {
-        resource: resourceName,
-        sortableFields: resourceConfig.shadows,
-    };
-}
-/**
- * 設定ハッシュを取得
- *
- * レコード作成時にメタデータとして保存するために使用。
- * SHADOW_CONFIG環境変数（base64エンコードされたJSON）からSHA-256ハッシュを生成する。
- *
- * @returns 設定ハッシュ（SHA-256）
- */
-export function getShadowConfigHash() {
-    // 設定をロード（キャッシュされていなければロードされる）
-    getShadowConfig();
-    // 環境変数 SHADOW_CONFIG は Terraform により base64 エンコードされた JSON として設定される
-    // この値をハッシュ化することで、設定の変更を検知できる
-    const configBase64 = process.env.SHADOW_CONFIG;
-    if (!configBase64) {
-        throw new Error('SHADOW_CONFIG environment variable is not set');
-    }
-    // Node.js の crypto モジュールを使用してハッシュを計算
-    // Lambda 環境では crypto は標準モジュール
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const crypto = require('crypto');
-    const hash = crypto.createHash('sha256').update(configBase64).digest('hex');
-    return hash;
-}
-/**
- * スキーマバージョンを取得
- *
- * レコード作成時にメタデータとして保存するために使用。
- *
- * @returns スキーマバージョン
- */
-export function getSchemaVersion() {
-    const config = getShadowConfig();
-    return config.$schemaVersion;
-}
 /**
  * キャッシュをクリアする（テスト用）
  *
@@ -114,49 +61,4 @@ export function getSchemaVersion() {
 export function clearShadowConfigCache() {
     cachedShadowConfig = null;
 }
-/**
- * リソースの全シャドーフィールドを取得する
- *
- * @param config - シャドー設定全体
- * @param resourceName - リソース名
- * @returns 全シャドーフィールドの設定
- */
-export function getAllShadowFields(config, resourceName) {
-    const resourceConfig = config.resources[resourceName];
-    if (!resourceConfig) {
-        throw new Error(`Resource '${resourceName}' not found in shadow config`);
-    }
-    return resourceConfig.shadows;
-}
-/**
- * 指定されたフィールドが有効なシャドーフィールドかどうかを検証する
- *
- * @param config - シャドー設定全体
- * @param resourceName - リソース名
- * @param fieldName - 検証するフィールド名
- * @returns フィールドが有効な場合true
- */
-export function isValidShadowField(config, resourceName, fieldName) {
-    try {
-        const allFields = getAllShadowFields(config, resourceName);
-        return fieldName in allFields;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * リソースのデフォルトソート設定を取得する
- *
- * @param config - シャドー設定全体
- * @param resourceName - リソース名
- * @returns デフォルトソート設定
- */
-export function getDefaultSort(config, resourceName) {
-    const resourceConfig = config.resources[resourceName];
-    if (!resourceConfig) {
-        throw new Error(`Resource '${resourceName}' not found in shadow config`);
-    }
-    return resourceConfig.sortDefaults;
-}
 //# sourceMappingURL=config.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/server/shadow/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/server/shadow/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAeH;;GAEG;AACH,IAAI,kBAAkB,GAAwB,IAAI,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,kBAAkB,GAAG;YACnB,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,WAAW;YAClE,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,WAAW;YAClE,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,KAAK,EAAE,EAAE,CAAC;YAC1E,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,IAAI,EAAE,EAAE,CAAC;SACvE,CAAC;QAEF,UAAU;QACV,IAAI,kBAAkB,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,kBAAkB,CAAC,aAAa,IAAI,CAAC,IAAI,kBAAkB,CAAC,aAAa,GAAG,EAAE,EAAE,CAAC;YACnF,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB;IACpC,kBAAkB,GAAG,IAAI,CAAC;AAC5B,CAAC"}

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

@@ -1,13 +1,5 @@
-import type { ShadowFieldConfig, ShadowFieldType } from './types.js';
-/**
- * シャドースキーマ（簡易版）
- */
-export interface ShadowSchema {
-    /** リソース名 */
-    resource: string;
-    /** ソート可能なフィールド定義 */
-    sortableFields: Record<string, ShadowFieldConfig>;
-}
+import type { ShadowFieldType } from './types.js';
+import type { ShadowConfig } from './config.js';
 /**
  * シャドウレコード
  */
@@ -22,6 +14,42 @@ export interface ShadowRecord {
         id: string;
     };
 }
+/**
+ * JSONオブジェクトのフィールドを正規化
+ *
+ * フィールドの順序を以下のルールで並び替えます：
+ * 1. id: 先頭
+ * 2. その他: アルファベット順
+ * 3. createdAt, updatedAt: 末尾
+ *
+ * @param value - 正規化する値
+ * @returns 正規化された値
+ *
+ * @example
+ * ```typescript
+ * normalizeJson({ updatedAt: '...', title: 'A', id: '1', author: 'B' })
+ * // => { id: '1', author: 'B', title: 'A', updatedAt: '...' }
+ * ```
+ */
+export declare function normalizeJson(value: unknown): unknown;
+/**
+ * 文字列を先頭Nバイトまで切り詰める（UTF-8）
+ *
+ * マルチバイト文字の境界を考慮して切り詰めます。
+ * 切り詰め位置がマルチバイト文字の途中の場合、前の文字境界まで戻ります。
+ *
+ * @param value - 切り詰める文字列
+ * @param maxBytes - 最大バイト数
+ * @returns 切り詰められた文字列
+ *
+ * @example
+ * ```typescript
+ * truncateString('Hello World', 5) // => 'Hello'
+ * truncateString('こんにちは世界', 9) // => 'こんに' (9バイト = 3文字)
+ * truncateString('Hello', 100) // => 'Hello' (そのまま)
+ * ```
+ */
+export declare function truncateString(value: string, maxBytes: number): string;
 /**
  * 文字列値をエスケープする
  * ルール: # → ##, スペース → #
@@ -31,12 +59,28 @@ export interface ShadowRecord {
  */
 export declare function escapeString(value: string): string;
 /**
- * 数値を20桁のゼロ埋め文字列に変換する
+ * 数値をオフセット方式でゼロパディング
  *
- * @param value - 変換する数値（null/undefinedも許容）
- * @returns 20桁のゼロ埋め文字列
+ * 負数を含む数値を文字列としてソート可能にするため、オフセットを加算します。
+ *
+ * 範囲: -10^padding ～ +10^padding
+ * オフセット: 10^padding
+ *
+ * 注意: padding は15以下を推奨（JavaScriptの安全な整数範囲: 2^53-1 ≈ 9×10^15）
+ *
+ * @param value - 変換する数値
+ * @param padding - パディング桁数（推奨: 15、デフォルト設定で使用）
+ * @returns ゼロパディングされた文字列
+ * @throws 数値が範囲外の場合
+ *
+ * @example
+ * ```typescript
+ * formatNumberWithOffset(-99999, 15) // => "0999999999900001"
+ * formatNumberWithOffset(0, 15)      // => "1000000000000000"
+ * formatNumberWithOffset(99999, 15)  // => "1000000000099999"
+ * ```
  */
-export declare function formatNumber(value: number | null | undefined): string;
+export declare function formatNumberWithOffset(value: number, padding: number): string;
 /**
  * 日時をUTC ISO 8601形式にフォーマットする
  *
@@ -52,36 +96,22 @@ export declare function formatDatetime(value: string | Date | null | undefined):
  */
 export declare function formatBoolean(value: boolean | null | undefined): string;
 /**
- * フィールド値を型に応じてフォーマットする
+ * フィールド値を型に応じてフォーマットする（更新版）
  *
  * @param type - フィールドの型
- * @param value - フォーマットする値（null/undefinedも許容）
+ * @param value - フォーマットする値
+ * @param config - シャドウ設定
  * @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'
+ * ```typescript
+ * const config = { stringMaxBytes: 100, numberPadding: 20, ... };
+ * formatFieldValue('string', 'Hello World', config) // => 'Hello#World'
+ * formatFieldValue('number', 123, config) // => '10000000000000000123'
+ * formatFieldValue('array', ['a', 'b'], config) // => '["a","b"]'
+ * ```
  */
-export declare function generateShadowSK(fieldName: string, value: string | number | Date, recordId: string, type?: ShadowFieldType): string;
+export declare function formatFieldValue(type: ShadowFieldType, value: unknown, config: ShadowConfig): string;
 /**
  * レコードIDからメインレコードのSKを生成する
  * フォーマット: id#{recordId}
@@ -91,14 +121,33 @@ export declare function generateShadowSK(fieldName: string, value: string | numb
  */
 export declare function generateMainRecordSK(recordId: string): string;
 /**
- * レコードからシャドウレコードを生成する
+ * レコードからシャドウレコードを自動生成する（更新版）
  *
- * sortableFieldsに定義されたフィールドのみを処理します。
- * 値がundefined/nullの場合は空文字として扱い、シャドウレコードを生成します。
+ * レコードに存在するすべてのフィールドを自動的にシャドウ化します。
+ * スキーマ定義は不要で、実行時に型を推論します。
  *
  * @param record - レコードオブジェクト（idフィールドを含む）
- * @param schema - シャドウスキーマ定義
+ * @param resourceName - リソース名
+ * @param config - シャドウ設定
  * @returns 生成されたシャドウレコードの配列
+ *
+ * @example
+ * ```typescript
+ * const record = {
+ *   id: '01HQXYZ...',
+ *   title: 'Article',
+ *   viewCount: 123,
+ *   tags: ['tech', 'aws'],
+ * };
+ * const config = getShadowConfig();
+ * const shadows = generateShadowRecords(record, 'articles', config);
+ * // => [
+ * //   { PK: 'articles', SK: 'id#01HQXYZ...#id#01HQXYZ...', data: { id: '01HQXYZ...' } },
+ * //   { PK: 'articles', SK: 'title#Article#id#01HQXYZ...', data: { id: '01HQXYZ...' } },
+ * //   { PK: 'articles', SK: 'viewCount#10000000000000000123#id#01HQXYZ...', data: { id: '01HQXYZ...' } },
+ * //   { PK: 'articles', SK: 'tags#["aws","tech"]#id#01HQXYZ...', data: { id: '01HQXYZ...' } },
+ * // ]
+ * ```
  */
-export declare function generateShadowRecords(record: Record<string, unknown>, schema: ShadowSchema): ShadowRecord[];
+export declare function generateShadowRecords(record: Record<string, unknown>, resourceName: string, config: ShadowConfig): ShadowRecord[];
 //# sourceMappingURL=generator.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/server/shadow/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD;;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;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA2BrD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgBtE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAiB7E;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;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,YAAY,GACnB,MAAM,CA4BR;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,YAAY,GACnB,YAAY,EAAE,CAmChB"}