@exabugs/dynamodb-client 0.1.0

package/dist/server/query/converter.js

@@ -0,0 +1,161 @@
+/**
+ * FilterをDynamoDB形式に変換する
+ *
+ * MongoDB風のFilter構文をDynamoDBのFilterExpression用の条件配列に変換します。
+ *
+ * @example
+ * ```typescript
+ * // 単純な等価条件
+ * const filter: Filter<Product> = { status: 'active' };
+ * const query = convertFilterToDynamo('products', filter);
+ * // => { pk: 'products', conditions: [{ field: 'status', operator: 'eq', value: 'active' }] }
+ *
+ * // 演算子を使用した条件
+ * const filter: Filter<Product> = {
+ *   price: { gte: 1000, lte: 5000 },
+ *   status: { in: ['active', 'pending'] }
+ * };
+ * const query = convertFilterToDynamo('products', filter);
+ * // => {
+ * //   pk: 'products',
+ * //   conditions: [
+ * //     { field: 'price', operator: 'gte', value: 1000 },
+ * //     { field: 'price', operator: 'lte', value: 5000 },
+ * //     { field: 'status', operator: 'in', value: ['active', 'pending'] }
+ * //   ]
+ * // }
+ *
+ * // OR条件
+ * const filter: Filter<Product> = {
+ *   or: [
+ *     { status: 'active' },
+ *     { priority: { gte: 5 } }
+ *   ]
+ * };
+ * const query = convertFilterToDynamo('products', filter);
+ * // => {
+ * //   pk: 'products',
+ * //   conditions: [
+ * //     { field: 'status', operator: 'eq', value: 'active' },
+ * //     { field: 'priority', operator: 'gte', value: 5 }
+ * //   ],
+ * //   logicalOperator: 'OR'
+ * // }
+ * ```
+ *
+ * @param collection - コレクション名（リソース名）
+ * @param filter - MongoDB風のフィルタ条件
+ * @returns DynamoDBクエリ
+ */
+export function convertFilterToDynamo(collection, filter) {
+    const conditions = [];
+    let logicalOperator = 'AND';
+    // フィルタが空の場合
+    if (!filter || Object.keys(filter).length === 0) {
+        return { pk: collection, conditions };
+    }
+    // 論理演算子の処理
+    if ('and' in filter && Array.isArray(filter.and)) {
+        // AND条件: 各フィルタを再帰的に変換して結合
+        for (const subFilter of filter.and) {
+            const subQuery = convertFilterToDynamo(collection, subFilter);
+            conditions.push(...subQuery.conditions);
+        }
+        logicalOperator = 'AND';
+    }
+    else if ('or' in filter && Array.isArray(filter.or)) {
+        // OR条件: 各フィルタを再帰的に変換して結合
+        for (const subFilter of filter.or) {
+            const subQuery = convertFilterToDynamo(collection, subFilter);
+            conditions.push(...subQuery.conditions);
+        }
+        logicalOperator = 'OR';
+    }
+    // 通常のフィールド条件を処理
+    for (const [key, value] of Object.entries(filter)) {
+        // 論理演算子はスキップ
+        if (key === 'and' || key === 'or') {
+            continue;
+        }
+        // 値がnullまたはundefinedの場合はスキップ
+        if (value === null || value === undefined) {
+            continue;
+        }
+        // FilterOperatorsオブジェクトかどうかをチェック
+        if (isFilterOperators(value)) {
+            // 演算子を使用した条件
+            for (const [op, opValue] of Object.entries(value)) {
+                if (opValue === undefined)
+                    continue;
+                const operator = mapOperatorToDynamo(op);
+                conditions.push({
+                    field: key,
+                    operator,
+                    value: opValue,
+                });
+            }
+        }
+        else {
+            // 直接値を指定した場合は等価条件として扱う
+            conditions.push({
+                field: key,
+                operator: 'eq',
+                value,
+            });
+        }
+    }
+    return {
+        pk: collection,
+        conditions,
+        ...(logicalOperator === 'OR' && { logicalOperator }),
+    };
+}
+/**
+ * 値がFilterOperatorsオブジェクトかどうかをチェックする
+ *
+ * @param value - チェック対象の値
+ * @returns FilterOperatorsオブジェクトの場合true
+ */
+function isFilterOperators(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const validOperators = ['eq', 'ne', 'gt', 'gte', 'lt', 'lte', 'in', 'nin', 'exists', 'regex'];
+    const keys = Object.keys(value);
+    // 少なくとも1つの有効な演算子キーを持つ場合はFilterOperatorsとみなす
+    return keys.some((key) => validOperators.includes(key));
+}
+/**
+ * MongoDB風の演算子をDynamoDB演算子にマッピングする
+ *
+ * @param operator - MongoDB風の演算子
+ * @returns DynamoDB演算子
+ */
+function mapOperatorToDynamo(operator) {
+    switch (operator) {
+        case 'eq':
+            return 'eq';
+        case 'ne':
+            return 'ne';
+        case 'gt':
+            return 'gt';
+        case 'gte':
+            return 'gte';
+        case 'lt':
+            return 'lt';
+        case 'lte':
+            return 'lte';
+        case 'in':
+            return 'in';
+        case 'nin':
+            return 'nin';
+        case 'exists':
+            return 'exists';
+        case 'regex':
+            // 正規表現は部分一致（contains）として扱う（簡易実装）
+            return 'contains';
+        default:
+            return 'eq';
+    }
+}
+//# sourceMappingURL=converter.js.map

package/dist/server/query/converter.js.map

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

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

@@ -0,0 +1,5 @@
+/**
+ * クエリ変換モジュール
+ */
+export { convertFilterToDynamo, type DynamoComparisonOperator, type DynamoCondition, type DynamoQuery, } from './converter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/query/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,qBAAqB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/server/query/index.js

@@ -0,0 +1,5 @@
+/**
+ * クエリ変換モジュール
+ */
+export { convertFilterToDynamo, } from './converter.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/query/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,qBAAqB,GAItB,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,147 @@
+/**
+ * サーバーサイドシャドウ設定管理
+ *
+ * シャドー設定を環境変数から読み込み、グローバル変数にキャッシュします。
+ * 設定はTerraformデプロイ時に環境変数として埋め込まれるため、
+ * 実行時のI/Oが不要で、最も高速かつシンプルです。
+ *
+ * キャッシュの動作:
+ * - 初回呼び出し時: 環境変数からパースしてキャッシュ
+ * - 2回目以降: キャッシュから即座に取得
+ * - キャッシュ有効期間: Lambda実行環境が存在する間（通常15分〜数時間）
+ *
+ * 設定変更の反映:
+ * - config/shadow.config.jsonを変更
+ * - Terraformで再度apply（環境変数が更新される）
+ * - Lambda関数が自動的に再デプロイされ、新しい設定が反映される
+ *
+ * 要件: 8.7
+ */
+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;
+            };
+        };
+    };
+}
+/**
+ * シャドー設定を取得（キャッシュ付き）
+ *
+ * 環境変数SHADOW_CONFIGからbase64エンコードされたJSON文字列をデコードしてパースして取得。
+ * 初回呼び出し時のみパース処理を行い、以降はキャッシュを使用。
+ *
+ * @returns シャドー設定
+ * @throws 環境変数が未設定、または不正な形式の場合
+ *
+ * @example
+ * ```typescript
+ * const config = getShadowConfig();
+ * const articleSchema = getResourceSchema(config, 'articles');
+ * const shadows = generateShadowRecords(record, articleSchema);
+ * ```
+ */
+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;
+/**
+ * キャッシュをクリアする（テスト用）
+ *
+ * 本番環境では使用しないこと。
+ * テスト環境でのみ、テスト間でキャッシュをクリアするために使用。
+ */
+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

@@ -0,0 +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"}

package/dist/server/shadow/config.js

@@ -0,0 +1,162 @@
+/**
+ * グローバル変数にキャッシュ（Lambda実行環境で再利用）
+ */
+let cachedShadowConfig = null;
+/**
+ * シャドー設定を取得（キャッシュ付き）
+ *
+ * 環境変数SHADOW_CONFIGからbase64エンコードされたJSON文字列をデコードしてパースして取得。
+ * 初回呼び出し時のみパース処理を行い、以降はキャッシュを使用。
+ *
+ * @returns シャドー設定
+ * @throws 環境変数が未設定、または不正な形式の場合
+ *
+ * @example
+ * ```typescript
+ * const config = getShadowConfig();
+ * const articleSchema = getResourceSchema(config, 'articles');
+ * const shadows = generateShadowRecords(record, articleSchema);
+ * ```
+ */
+export function getShadowConfig() {
+    if (!cachedShadowConfig) {
+        const configBase64 = process.env.SHADOW_CONFIG;
+        if (!configBase64) {
+            throw new Error('SHADOW_CONFIG environment variable is not set');
+        }
+        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;
+        }
+    }
+    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;
+}
+/**
+ * キャッシュをクリアする（テスト用）
+ *
+ * 本番環境では使用しないこと。
+ * テスト環境でのみ、テスト間でキャッシュをクリアするために使用。
+ */
+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

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

package/dist/server/shadow/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/server/shadow/differ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"differ.d.ts","sourceRoot":"","sources":["../../../src/server/shadow/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/server/shadow/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/server/shadow/differ.js.map

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