@exabugs/dynamodb-client 0.1.0

package/dist/server/utils/validation.js

@@ -0,0 +1,54 @@
+/**
+ * 入力検証ユーティリティ
+ */
+import { InvalidFilterError } from '../../index.js';
+import { getDefaultSort, isValidShadowField } from '../shadow/index.js';
+/**
+ * getList/getManyReferenceのソートフィールドを検証する
+ *
+ * @param config - シャドー設定
+ * @param resource - リソース名
+ * @param sort - ソート条件
+ * @throws {InvalidFilterError} ソートフィールドが無効な場合
+ */
+export function validateSortField(config, resource, sort) {
+    if (!sort) {
+        return;
+    }
+    const { field } = sort;
+    // idフィールドは常に有効（本体レコードとして存在）
+    if (field === 'id') {
+        return;
+    }
+    // シャドーフィールドとして有効かチェック
+    if (!isValidShadowField(config, resource, field)) {
+        throw new InvalidFilterError(`Invalid sort field: ${field}`, { field, resource });
+    }
+}
+/**
+ * ページネーションパラメータを正規化する
+ *
+ * @param pagination - ページネーション条件
+ * @returns 正規化されたページネーション条件
+ */
+export function normalizePagination(pagination) {
+    const perPage = Math.min(pagination?.perPage || 50, 50); // 最大50件
+    const nextToken = pagination?.nextToken;
+    return { perPage, nextToken };
+}
+/**
+ * ソート条件を正規化する（デフォルト値を適用）
+ *
+ * @param config - シャドー設定
+ * @param resource - リソース名
+ * @param sort - ソート条件
+ * @returns 正規化されたソート条件
+ */
+export function normalizeSort(config, resource, sort) {
+    if (sort) {
+        return sort;
+    }
+    // デフォルトソートを取得
+    return getDefaultSort(config, resource);
+}
+//# sourceMappingURL=validation.js.map

package/dist/server/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/server/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAIxE;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAoB,EACpB,QAAgB,EAChB,IAA+C;IAE/C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;IACT,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAEvB,4BAA4B;IAC5B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO;IACT,CAAC;IAED,sBAAsB;IACtB,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,kBAAkB,CAAC,uBAAuB,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACpF,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAA6E;IAE7E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ;IACjE,MAAM,SAAS,GAAG,UAAU,EAAE,SAAS,CAAC;IAExC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAoB,EACpB,QAAgB,EAChB,IAA+C;IAE/C,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc;IACd,OAAO,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC"}

package/dist/shadows/config.d.ts

@@ -0,0 +1,54 @@
+import type { ResourceShadowConfig, ShadowConfig, ShadowFieldConfig } from './types.js';
+/**
+ * shadow.config.jsonファイルから読み込む
+ *
+ * @param configPath - 設定ファイルのパス（デフォルト: './shadow.config.json'）
+ * @returns パースされたシャドー設定
+ * @throws 設定ファイルが存在しない、または不正な形式の場合
+ */
+export declare function loadShadowConfig(configPath?: string): Promise<ShadowConfig>;
+/**
+ * 特定のリソースのシャドー設定を取得する
+ *
+ * @param config - シャドー設定全体
+ * @param resourceName - リソース名（例: 'articles', 'tasks'）
+ * @returns リソースのシャドー設定
+ * @throws リソースが設定に存在しない場合
+ */
+export declare function getResourceConfig(config: ShadowConfig, resourceName: string): ResourceShadowConfig;
+/**
+ * リソースの全シャドーフィールドを取得する
+ *
+ * @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';
+};
+/**
+ * 設定ファイルから環境変数経由でパスを取得する
+ *
+ * @param envVar - 環境変数名（デフォルト: 'SHADOW_CONFIG_PATH'）
+ * @returns 設定ファイルのパス
+ */
+export declare function getConfigPathFromEnv(envVar?: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/shadows/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/shadows/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAExF;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,GAAE,MAA+B,GAC1C,OAAO,CAAC,YAAY,CAAC,CAuBvB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,MAAM,GACnB,oBAAoB,CAQtB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAGnC;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,CAG1C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,MAA6B,GAAG,MAAM,CAElF"}

package/dist/shadows/config.js

@@ -0,0 +1,95 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+/**
+ * shadow.config.jsonファイルから読み込む
+ *
+ * @param configPath - 設定ファイルのパス（デフォルト: './shadow.config.json'）
+ * @returns パースされたシャドー設定
+ * @throws 設定ファイルが存在しない、または不正な形式の場合
+ */
+export async function loadShadowConfig(configPath = './shadow.config.json') {
+    try {
+        // ファイルシステムから読み込む
+        const absolutePath = resolve(configPath);
+        const content = await readFile(absolutePath, 'utf-8');
+        const config = JSON.parse(content);
+        // 基本的なバリデーション
+        if (!config.$schemaVersion) {
+            throw new Error('Missing $schemaVersion in shadow.config.json');
+        }
+        if (!config.resources || typeof config.resources !== 'object') {
+            throw new Error('Missing or invalid resources in shadow.config.json');
+        }
+        return config;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to load shadow config: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * 特定のリソースのシャドー設定を取得する
+ *
+ * @param config - シャドー設定全体
+ * @param resourceName - リソース名（例: 'articles', 'tasks'）
+ * @returns リソースのシャドー設定
+ * @throws リソースが設定に存在しない場合
+ */
+export function getResourceConfig(config, resourceName) {
+    const resourceConfig = config.resources[resourceName];
+    if (!resourceConfig) {
+        throw new Error(`Resource '${resourceName}' not found in shadow config`);
+    }
+    return resourceConfig;
+}
+/**
+ * リソースの全シャドーフィールドを取得する
+ *
+ * @param config - シャドー設定全体
+ * @param resourceName - リソース名
+ * @returns 全シャドーフィールドの設定
+ */
+export function getAllShadowFields(config, resourceName) {
+    const resourceConfig = getResourceConfig(config, resourceName);
+    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 = getResourceConfig(config, resourceName);
+    return resourceConfig.sortDefaults;
+}
+/**
+ * 設定ファイルから環境変数経由でパスを取得する
+ *
+ * @param envVar - 環境変数名（デフォルト: 'SHADOW_CONFIG_PATH'）
+ * @returns 設定ファイルのパス
+ */
+export function getConfigPathFromEnv(envVar = 'SHADOW_CONFIG_PATH') {
+    return process.env[envVar] || './shadow.config.json';
+}
+//# sourceMappingURL=config.js.map

package/dist/shadows/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/shadows/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,aAAqB,sBAAsB;IAE3C,IAAI,CAAC;QACH,iBAAiB;QACjB,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC;QAEnD,cAAc;QACd,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAoB,EACpB,YAAoB;IAEpB,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAEtD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,aAAa,YAAY,8BAA8B,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAoB,EACpB,YAAoB;IAEpB,MAAM,cAAc,GAAG,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC/D,OAAO,cAAc,CAAC,OAAO,CAAC;AAChC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAoB,EACpB,YAAoB,EACpB,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC3D,OAAO,SAAS,IAAI,SAAS,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAoB,EACpB,YAAoB;IAEpB,MAAM,cAAc,GAAG,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC/D,OAAO,cAAc,CAAC,YAAY,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB,oBAAoB;IACxE,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,sBAAsB,CAAC;AACvD,CAAC"}

package/dist/shadows/differ.d.ts

@@ -0,0 +1,42 @@
+import type { ShadowDiff } from './types.js';
+/**
+ * 旧シャドーキーと新シャドーキーの差分を計算する
+ *
+ * この関数は、レコード更新時に既存のシャドーレコードと新しく生成すべき
+ * シャドーレコードを比較し、削除すべきものと追加すべきものを特定します。
+ *
+ * @param oldShadowKeys - 既存のシャドーSKの配列
+ * @param newShadowKeys - 新しく生成されたシャドーSKの配列
+ * @returns 削除すべきSKと追加すべきSKのリスト
+ *
+ * @example
+ * const oldKeys = [
+ *   'name#Old#Name#id#01HZXY123',
+ *   'priority#00000000000000000010#id#01HZXY123'
+ * ];
+ * const newKeys = [
+ *   'name#New#Name#id#01HZXY123',
+ *   'priority#00000000000000000010#id#01HZXY123'
+ * ];
+ * const diff = calculateShadowDiff(oldKeys, newKeys);
+ * // => {
+ * //   toDelete: ['name#Old#Name#id#01HZXY123'],
+ * //   toAdd: ['name#New#Name#id#01HZXY123']
+ * // }
+ */
+export declare function calculateShadowDiff(oldShadowKeys: string[], newShadowKeys: string[]): ShadowDiff;
+/**
+ * シャドー差分が空かどうかを判定する
+ *
+ * @param diff - シャドー差分オブジェクト
+ * @returns 差分が空の場合true
+ */
+export declare function isDiffEmpty(diff: ShadowDiff): boolean;
+/**
+ * 複数のシャドー差分をマージする
+ *
+ * @param diffs - マージするシャドー差分の配列
+ * @returns マージされたシャドー差分
+ */
+export declare function mergeShadowDiffs(diffs: ShadowDiff[]): ShadowDiff;
+//# sourceMappingURL=differ.d.ts.map

package/dist/shadows/differ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"differ.d.ts","sourceRoot":"","sources":["../../src/shadows/differ.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,UAAU,CAehG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,CAahE"}

package/dist/shadows/differ.js

@@ -0,0 +1,66 @@
+/**
+ * 旧シャドーキーと新シャドーキーの差分を計算する
+ *
+ * この関数は、レコード更新時に既存のシャドーレコードと新しく生成すべき
+ * シャドーレコードを比較し、削除すべきものと追加すべきものを特定します。
+ *
+ * @param oldShadowKeys - 既存のシャドーSKの配列
+ * @param newShadowKeys - 新しく生成されたシャドーSKの配列
+ * @returns 削除すべきSKと追加すべきSKのリスト
+ *
+ * @example
+ * const oldKeys = [
+ *   'name#Old#Name#id#01HZXY123',
+ *   'priority#00000000000000000010#id#01HZXY123'
+ * ];
+ * const newKeys = [
+ *   'name#New#Name#id#01HZXY123',
+ *   'priority#00000000000000000010#id#01HZXY123'
+ * ];
+ * const diff = calculateShadowDiff(oldKeys, newKeys);
+ * // => {
+ * //   toDelete: ['name#Old#Name#id#01HZXY123'],
+ * //   toAdd: ['name#New#Name#id#01HZXY123']
+ * // }
+ */
+export function calculateShadowDiff(oldShadowKeys, newShadowKeys) {
+    // Set を使用して効率的な差分計算を行う
+    const oldSet = new Set(oldShadowKeys);
+    const newSet = new Set(newShadowKeys);
+    // 削除すべきキー: 旧キーに存在するが新キーに存在しない
+    const toDelete = oldShadowKeys.filter((key) => !newSet.has(key));
+    // 追加すべきキー: 新キーに存在するが旧キーに存在しない
+    const toAdd = newShadowKeys.filter((key) => !oldSet.has(key));
+    return {
+        toDelete,
+        toAdd,
+    };
+}
+/**
+ * シャドー差分が空かどうかを判定する
+ *
+ * @param diff - シャドー差分オブジェクト
+ * @returns 差分が空の場合true
+ */
+export function isDiffEmpty(diff) {
+    return diff.toDelete.length === 0 && diff.toAdd.length === 0;
+}
+/**
+ * 複数のシャドー差分をマージする
+ *
+ * @param diffs - マージするシャドー差分の配列
+ * @returns マージされたシャドー差分
+ */
+export function mergeShadowDiffs(diffs) {
+    const allToDelete = new Set();
+    const allToAdd = new Set();
+    for (const diff of diffs) {
+        diff.toDelete.forEach((key) => allToDelete.add(key));
+        diff.toAdd.forEach((key) => allToAdd.add(key));
+    }
+    return {
+        toDelete: Array.from(allToDelete),
+        toAdd: Array.from(allToAdd),
+    };
+}
+//# sourceMappingURL=differ.js.map

package/dist/shadows/differ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"differ.js","sourceRoot":"","sources":["../../src/shadows/differ.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,mBAAmB,CAAC,aAAuB,EAAE,aAAuB;IAClF,uBAAuB;IACvB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IAEtC,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAEjE,8BAA8B;IAC9B,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAE9D,OAAO;QACL,QAAQ;QACR,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAgB;IAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAClD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;QACjC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/shadows/generator.d.ts

@@ -0,0 +1,63 @@
+import type { ShadowFieldType } from './types.js';
+/**
+ * 文字列値をエスケープする
+ * ルール: # → ##, スペース → #
+ *
+ * @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;
+/**
+ * フィールド値を型に応じてフォーマットする
+ *
+ * @param type - フィールドの型
+ * @param value - フォーマットする値（null/undefinedも許容）
+ * @returns フォーマットされた文字列
+ */
+export declare function formatFieldValue(type: ShadowFieldType, value: string | number | Date | 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;
+//# sourceMappingURL=generator.d.ts.map

package/dist/shadows/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/shadows/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;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;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,GAC/C,MAAM,CAeR;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"}

package/dist/shadows/generator.js

@@ -0,0 +1,107 @@
+/**
+ * 文字列値をエスケープする
+ * ルール: # → ##, スペース → #
+ *
+ * @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();
+}
+/**
+ * フィールド値を型に応じてフォーマットする
+ *
+ * @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);
+        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}`;
+}
+//# sourceMappingURL=generator.js.map

package/dist/shadows/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/shadows/generator.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,aAAa;SACjC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,cAAc;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAgC;IAC3D,yBAAyB;IACzB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,8BAA8B;IAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAElD,OAAO,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAuC;IACpE,yBAAyB;IACzB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAEjE,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAqB,EACrB,KAAgD;IAEhD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,kCAAkC;YAClC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC1C,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,OAAO,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACrC,KAAK,QAAQ;YACX,OAAO,YAAY,CAAC,KAAkC,CAAC,CAAC;QAC1D,KAAK,UAAU;YACb,OAAO,cAAc,CAAC,KAAyC,CAAC,CAAC;QACnE;YACE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAiB,EACjB,KAA6B,EAC7B,QAAgB,EAChB,OAAwB,QAAQ;IAEhC,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrD,OAAO,GAAG,SAAS,IAAI,cAAc,OAAO,QAAQ,EAAE,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,OAAO,MAAM,QAAQ,EAAE,CAAC;AAC1B,CAAC"}

package/dist/shadows/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @exabugs/dynamodb-client/shadows - シャドー管理ライブラリ
+ *
+ * DynamoDB Single-Table設計における動的シャドーレコード管理を提供します。
+ *
+ * 主な機能:
+ * - シャドーSK生成（string/number/datetime対応）
+ * - シャドー差分計算（旧影と新影の比較）
+ * - shadow.config.json読み込みと検証
+ */
+export type { ShadowFieldType, ShadowFieldConfig, ResourceShadowConfig, ShadowConfig, ShadowDiff, } from './types.js';
+export { escapeString, formatNumber, formatDatetime, formatFieldValue, generateShadowSK, generateMainRecordSK, } from './generator.js';
+export { calculateShadowDiff, isDiffEmpty, mergeShadowDiffs } from './differ.js';
+export { loadShadowConfig, getResourceConfig, getAllShadowFields, isValidShadowField, getDefaultSort, getConfigPathFromEnv, } from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shadows/index.d.ts.map

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

package/dist/shadows/index.js

@@ -0,0 +1,17 @@
+/**
+ * @exabugs/dynamodb-client/shadows - シャドー管理ライブラリ
+ *
+ * DynamoDB Single-Table設計における動的シャドーレコード管理を提供します。
+ *
+ * 主な機能:
+ * - シャドーSK生成（string/number/datetime対応）
+ * - シャドー差分計算（旧影と新影の比較）
+ * - shadow.config.json読み込みと検証
+ */
+// ジェネレーター関数のエクスポート
+export { escapeString, formatNumber, formatDatetime, formatFieldValue, generateShadowSK, generateMainRecordSK, } from './generator.js';
+// 差分計算関数のエクスポート
+export { calculateShadowDiff, isDiffEmpty, mergeShadowDiffs } from './differ.js';
+// 設定管理関数のエクスポート
+export { loadShadowConfig, getResourceConfig, getAllShadowFields, isValidShadowField, getDefaultSort, getConfigPathFromEnv, } from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/shadows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shadows/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,mBAAmB;AACnB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,gBAAgB;AAChB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjF,gBAAgB;AAChB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/shadows/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * シャドーフィールドの型定義
+ */
+export type ShadowFieldType = 'string' | 'number' | 'datetime';
+/**
+ * シャドー設定のフィールド定義
+ */
+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/shadows/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shadows/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/D;;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/shadows/types.js

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

package/dist/shadows/types.js.map

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