@exabugs/dynamodb-client 0.1.0

package/dist/server/utils/filter.js

@@ -0,0 +1,270 @@
+/**
+ * DynamoDB フィルター式生成ユーティリティ
+ * FilterExpression の構築とシャドーレコード除外条件の生成
+ *
+ * 要件: 5.5, 7.1, 12.1-12.12
+ */
+/**
+ * フィルターフィールド名をパースする
+ *
+ * フォーマット: `フィールド名:オペレータ:型`
+ * - オペレータ省略時: eq（デフォルト）
+ * - 型省略時: string（デフォルト）
+ *
+ * 例:
+ * - "status" → { field: "status", operator: "eq", type: "string" }
+ * - "priority:gte" → { field: "priority", operator: "gte", type: "string" }
+ * - "priority:gte:number" → { field: "priority", operator: "gte", type: "number" }
+ *
+ * 要件: 12.1, 12.3, 12.4
+ *
+ * @param fieldKey - フィルターフィールド名
+ * @returns パース結果
+ * @throws Error - 構文エラーの場合
+ */
+export function parseFilterField(fieldKey) {
+    const parts = fieldKey.split(':');
+    if (parts.length === 1) {
+        // "status" → { field: "status", operator: "eq", type: "string" }
+        return { field: parts[0], operator: 'eq', type: 'string' };
+    }
+    if (parts.length === 2) {
+        // "priority:gte" → { field: "priority", operator: "gte", type: "string" }
+        const operator = parts[1];
+        if (!isValidOperator(operator)) {
+            throw new Error(`Invalid filter operator: ${parts[1]}`);
+        }
+        return { field: parts[0], operator, type: 'string' };
+    }
+    if (parts.length === 3) {
+        // "priority:gte:number" → { field: "priority", operator: "gte", type: "number" }
+        const operator = parts[1];
+        const type = parts[2];
+        if (!isValidOperator(operator)) {
+            throw new Error(`Invalid filter operator: ${parts[1]}`);
+        }
+        if (!isValidType(type)) {
+            throw new Error(`Invalid filter type: ${parts[2]}`);
+        }
+        return { field: parts[0], operator, type };
+    }
+    throw new Error(`Invalid filter field syntax: ${fieldKey}`);
+}
+/**
+ * 演算子が有効かチェックする
+ */
+function isValidOperator(operator) {
+    return ['eq', 'lt', 'lte', 'gt', 'gte', 'starts', 'ends'].includes(operator);
+}
+/**
+ * 型が有効かチェックする
+ */
+function isValidType(type) {
+    return ['string', 'number', 'date', 'boolean'].includes(type);
+}
+/**
+ * シャドーレコードを除外するフィルター式を生成する
+ *
+ * シャドーレコードの特徴:
+ * - SK に '#' が含まれる（例: "name#value#id#ULID"）
+ * - 本体レコードは "id#ULID" 形式で '#' が1つのみ
+ *
+ * 除外条件:
+ * - attribute_exists(data) AND NOT contains(SK, '#id#')
+ *
+ * @returns シャドー除外フィルター式
+ */
+export function createShadowExclusionFilter() {
+    return {
+        expression: 'attribute_exists(#data) AND NOT contains(#sk, :shadowMarker)',
+        names: {
+            '#data': 'data',
+            '#sk': 'SK',
+        },
+        values: {
+            ':shadowMarker': '#id#',
+        },
+    };
+}
+/**
+ * ユーザー指定のフィルター条件から FilterExpression を構築する
+ *
+ * 注意: この実装は基本的な等価比較のみをサポート
+ * より複雑な条件（範囲検索、部分一致など）は将来の拡張として実装可能
+ *
+ * @param filter - フィルター条件（キー: フィールド名、値: 期待値）
+ * @returns フィルター式の構築結果
+ */
+export function buildFilterExpression(filter) {
+    const entries = Object.entries(filter);
+    // フィルター条件が空の場合は null を返す
+    if (entries.length === 0) {
+        return null;
+    }
+    const expressions = [];
+    const names = {};
+    const values = {};
+    entries.forEach(([key, value], index) => {
+        const nameKey = `#field${index}`;
+        const valueKey = `:value${index}`;
+        // data.{field} = :value 形式の条件を生成
+        expressions.push(`#data.${nameKey} = ${valueKey}`);
+        names['#data'] = 'data';
+        names[nameKey] = key;
+        values[valueKey] = value;
+    });
+    return {
+        expression: expressions.join(' AND '),
+        names,
+        values,
+    };
+}
+/**
+ * 複数のフィルター式を AND 条件で結合する
+ *
+ * @param filters - 結合するフィルター式の配列
+ * @returns 結合されたフィルター式
+ */
+export function combineFilters(filters) {
+    // null を除外
+    const validFilters = filters.filter((f) => f !== null);
+    if (validFilters.length === 0) {
+        return null;
+    }
+    if (validFilters.length === 1) {
+        return validFilters[0];
+    }
+    // 式を AND で結合
+    const expression = validFilters.map((f) => `(${f.expression})`).join(' AND ');
+    // names と values をマージ
+    const names = {};
+    const values = {};
+    validFilters.forEach((f) => {
+        Object.assign(names, f.names);
+        Object.assign(values, f.values);
+    });
+    return {
+        expression,
+        names,
+        values,
+    };
+}
+/**
+ * フィルター式を DynamoDB Query/Scan パラメータに適用する
+ *
+ * @param params - DynamoDB Query/Scan パラメータ
+ * @param filter - フィルター式
+ * @returns フィルター式が適用されたパラメータ
+ */
+export function applyFilterExpression(params, filter) {
+    if (!filter) {
+        return params;
+    }
+    return {
+        ...params,
+        FilterExpression: filter.expression,
+        ExpressionAttributeNames: {
+            ...params.ExpressionAttributeNames,
+            ...filter.names,
+        },
+        ExpressionAttributeValues: {
+            ...params.ExpressionAttributeValues,
+            ...filter.values,
+        },
+    };
+}
+/**
+ * 型変換ヘルパー
+ *
+ * 要件: 12.5
+ *
+ * @param value - 変換する値
+ * @param type - 変換先の型
+ * @returns 変換後の値
+ */
+export function convertType(value, type) {
+    switch (type) {
+        case 'string':
+            return String(value);
+        case 'number':
+            return Number(value);
+        case 'date':
+            return new Date(String(value));
+        case 'boolean':
+            // 文字列 "true"/"false" または boolean値を処理
+            if (typeof value === 'boolean')
+                return value;
+            return String(value).toLowerCase() === 'true';
+        default:
+            return String(value);
+    }
+}
+/**
+ * レコードが単一のフィルター条件に一致するかチェックする
+ *
+ * 要件: 12.2, 12.6, 12.8, 12.9
+ *
+ * @param record - チェック対象レコード
+ * @param parsed - パース済みフィルター条件
+ * @param value - フィルター値
+ * @returns 一致する場合true
+ */
+export function matchesFilter(record, parsed, value) {
+    const fieldValue = record[parsed.field];
+    // フィールドが存在しない場合は不一致
+    if (fieldValue === undefined || fieldValue === null) {
+        return false;
+    }
+    // 型変換
+    const typedFieldValue = convertType(fieldValue, parsed.type);
+    const typedFilterValue = convertType(value, parsed.type);
+    // 演算子に応じた比較
+    switch (parsed.operator) {
+        case 'eq':
+            return typedFieldValue === typedFilterValue;
+        case 'lt':
+            return typedFieldValue < typedFilterValue;
+        case 'lte':
+            return typedFieldValue <= typedFilterValue;
+        case 'gt':
+            return typedFieldValue > typedFilterValue;
+        case 'gte':
+            return typedFieldValue >= typedFilterValue;
+        case 'starts':
+            return String(typedFieldValue).startsWith(String(typedFilterValue));
+        case 'ends':
+            return String(typedFieldValue).endsWith(String(typedFilterValue));
+        default:
+            return false;
+    }
+}
+/**
+ * レコードがすべてのフィルター条件に一致するかチェックする（AND条件）
+ *
+ * 要件: 12.9
+ *
+ * @param record - チェック対象レコード
+ * @param parsedFilters - パース済みフィルター条件の配列
+ * @returns すべての条件に一致する場合true
+ */
+export function matchesAllFilters(record, parsedFilters) {
+    return parsedFilters.every((f) => matchesFilter(record, f.parsed, f.value));
+}
+/**
+ * Query最適化が可能かチェックする
+ *
+ * ソートフィールドと一致し、Query可能な演算子を持つフィルター条件を検出する
+ *
+ * 要件: 12.7
+ *
+ * @param sortField - ソート対象フィールド
+ * @param parsedFilters - パース済みフィルター条件
+ * @returns 最適化可能なフィルター条件（なければnull）
+ */
+export function findOptimizableFilter(sortField, parsedFilters) {
+    // Query可能な演算子
+    const queryableOperators = ['eq', 'lt', 'lte', 'gt', 'gte', 'starts'];
+    // ソートフィールドと一致し、Query可能な演算子を持つフィルターを探す
+    return (parsedFilters.find((f) => f.parsed.field === sortField && queryableOperators.includes(f.parsed.operator)) || null);
+}
+//# sourceMappingURL=filter.js.map

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

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

package/dist/server/utils/pagination.d.ts

@@ -0,0 +1,27 @@
+/**
+ * nextToken のペイロード構造
+ */
+interface NextTokenPayload {
+    /** パーティションキー */
+    PK: string;
+    /** ソートキー */
+    SK: string;
+}
+/**
+ * DynamoDB LastEvaluatedKey を Base64URL エンコードされた nextToken に変換する
+ *
+ * @param pk - パーティションキー
+ * @param sk - ソートキー
+ * @returns Base64URL エンコードされた nextToken
+ */
+export declare function encodeNextToken(pk: string, sk: string): string;
+/**
+ * Base64URL エンコードされた nextToken を DynamoDB ExclusiveStartKey にデコードする
+ *
+ * @param token - Base64URL エンコードされた nextToken
+ * @returns デコードされた NextTokenPayload
+ * @throws {InvalidTokenError} トークンのデコードに失敗した場合
+ */
+export declare function decodeNextToken(token: string): NextTokenPayload;
+export {};
+//# sourceMappingURL=pagination.d.ts.map

package/dist/server/utils/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/server/utils/pagination.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,UAAU,gBAAgB;IACxB,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAW9D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CA4B/D"}

package/dist/server/utils/pagination.js

@@ -0,0 +1,56 @@
+/**
+ * ページネーションユーティリティ
+ * nextToken のエンコード/デコード（Base64URL形式）
+ *
+ * 要件: 5.5, 7.1
+ */
+import { InvalidTokenError } from '../../index.js';
+/**
+ * DynamoDB LastEvaluatedKey を Base64URL エンコードされた nextToken に変換する
+ *
+ * @param pk - パーティションキー
+ * @param sk - ソートキー
+ * @returns Base64URL エンコードされた nextToken
+ */
+export function encodeNextToken(pk, sk) {
+    const payload = { PK: pk, SK: sk };
+    const json = JSON.stringify(payload);
+    // Base64 エンコード
+    const base64 = Buffer.from(json, 'utf-8').toString('base64');
+    // Base64URL 形式に変換（URL セーフ）
+    const base64url = base64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=/g, '');
+    return base64url;
+}
+/**
+ * Base64URL エンコードされた nextToken を DynamoDB ExclusiveStartKey にデコードする
+ *
+ * @param token - Base64URL エンコードされた nextToken
+ * @returns デコードされた NextTokenPayload
+ * @throws {InvalidTokenError} トークンのデコードに失敗した場合
+ */
+export function decodeNextToken(token) {
+    try {
+        // Base64URL から Base64 に変換
+        let base64 = token.replace(/-/g, '+').replace(/_/g, '/');
+        // パディングを追加（必要に応じて）
+        while (base64.length % 4 !== 0) {
+            base64 += '=';
+        }
+        // Base64 デコード
+        const json = Buffer.from(base64, 'base64').toString('utf-8');
+        // JSON パース
+        const payload = JSON.parse(json);
+        // 必須フィールドの検証
+        if (!payload.PK || !payload.SK) {
+            throw new Error('Missing required fields in token payload');
+        }
+        return payload;
+    }
+    catch (error) {
+        throw new InvalidTokenError('Failed to decode nextToken', {
+            token,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+//# sourceMappingURL=pagination.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../src/server/utils/pagination.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAYnD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU,EAAE,EAAU;IACpD,MAAM,OAAO,GAAqB,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAErC,eAAe;IACf,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE7D,2BAA2B;IAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAEnF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,IAAI,CAAC;QACH,0BAA0B;QAC1B,IAAI,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAEzD,mBAAmB;QACnB,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,CAAC;QAChB,CAAC;QAED,cAAc;QACd,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE7D,WAAW;QACX,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAqB,CAAC;QAErD,aAAa;QACb,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,iBAAiB,CAAC,4BAA4B,EAAE;YACxD,KAAK;YACL,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/server/utils/timestamps.d.ts

@@ -0,0 +1,31 @@
+/**
+ * タイムスタンプフィールド設定
+ */
+export interface TimestampFields {
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * タイムスタンプフィールド設定を取得する
+ *
+ * shadow.config.json の database.timestamps から取得
+ * 設定がない場合はデフォルト値（createdAt, updatedAt）を使用
+ *
+ * @returns タイムスタンプフィールド設定、または null（無効化されている場合）
+ */
+export declare function getTimestampFields(): TimestampFields | null;
+/**
+ * レコードデータにタイムスタンプフィールドを追加する（作成時）
+ *
+ * @param data - レコードデータ
+ * @returns タイムスタンプが追加されたレコードデータ
+ */
+export declare function addCreateTimestamps(data: Record<string, unknown>): Record<string, unknown>;
+/**
+ * レコードデータにタイムスタンプフィールドを追加する（更新時）
+ *
+ * @param data - レコードデータ
+ * @returns タイムスタンプが追加されたレコードデータ
+ */
+export declare function addUpdateTimestamp(data: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=timestamps.d.ts.map

package/dist/server/utils/timestamps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamps.d.ts","sourceRoot":"","sources":["../../../src/server/utils/timestamps.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAmC3D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAe1F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczF"}

package/dist/server/utils/timestamps.js

@@ -0,0 +1,84 @@
+/**
+ * タイムスタンプフィールド管理ユーティリティ
+ *
+ * shadow.config.json のデータベース設定から
+ * タイムスタンプフィールド名を取得し、動的に設定する
+ */
+import { getShadowConfig } from '../../index.js';
+/**
+ * タイムスタンプフィールド設定を取得する
+ *
+ * shadow.config.json の database.timestamps から取得
+ * 設定がない場合はデフォルト値（createdAt, updatedAt）を使用
+ *
+ * @returns タイムスタンプフィールド設定、または null（無効化されている場合）
+ */
+export function getTimestampFields() {
+    const shadowConfig = getShadowConfig();
+    // database 設定が存在するか確認
+    if (!shadowConfig.database) {
+        // デフォルト値を返す
+        return {
+            createdAt: 'createdAt',
+            updatedAt: 'updatedAt',
+        };
+    }
+    const { timestamps } = shadowConfig.database;
+    // timestamps 設定がない場合はデフォルト値を返す
+    if (!timestamps) {
+        return {
+            createdAt: 'createdAt',
+            updatedAt: 'updatedAt',
+        };
+    }
+    // timestamps 設定がある場合はそれを使用
+    if (typeof timestamps === 'object') {
+        return {
+            createdAt: timestamps.createdAt,
+            updatedAt: timestamps.updatedAt,
+        };
+    }
+    // デフォルト値を返す
+    return {
+        createdAt: 'createdAt',
+        updatedAt: 'updatedAt',
+    };
+}
+/**
+ * レコードデータにタイムスタンプフィールドを追加する（作成時）
+ *
+ * @param data - レコードデータ
+ * @returns タイムスタンプが追加されたレコードデータ
+ */
+export function addCreateTimestamps(data) {
+    const timestampFields = getTimestampFields();
+    // タイムスタンプが無効化されている場合はそのまま返す
+    if (!timestampFields) {
+        return data;
+    }
+    const now = new Date().toISOString();
+    return {
+        ...data,
+        [timestampFields.createdAt]: now,
+        [timestampFields.updatedAt]: now,
+    };
+}
+/**
+ * レコードデータにタイムスタンプフィールドを追加する（更新時）
+ *
+ * @param data - レコードデータ
+ * @returns タイムスタンプが追加されたレコードデータ
+ */
+export function addUpdateTimestamp(data) {
+    const timestampFields = getTimestampFields();
+    // タイムスタンプが無効化されている場合はそのまま返す
+    if (!timestampFields) {
+        return data;
+    }
+    const now = new Date().toISOString();
+    return {
+        ...data,
+        [timestampFields.updatedAt]: now,
+    };
+}
+//# sourceMappingURL=timestamps.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timestamps.js","sourceRoot":"","sources":["../../../src/server/utils/timestamps.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAUjD;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IAEvC,sBAAsB;IACtB,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;QAC3B,YAAY;QACZ,OAAO;YACL,SAAS,EAAE,WAAW;YACtB,SAAS,EAAE,WAAW;SACvB,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC;IAE7C,+BAA+B;IAC/B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,SAAS,EAAE,WAAW;YACtB,SAAS,EAAE,WAAW;SACvB,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO;YACL,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,SAAS,EAAE,UAAU,CAAC,SAAS;SAChC,CAAC;IACJ,CAAC;IAED,YAAY;IACZ,OAAO;QACL,SAAS,EAAE,WAAW;QACtB,SAAS,EAAE,WAAW;KACvB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA6B;IAC/D,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;IAE7C,4BAA4B;IAC5B,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,OAAO;QACL,GAAG,IAAI;QACP,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,GAAG;QAChC,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,GAAG;KACjC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA6B;IAC9D,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;IAE7C,4BAA4B;IAC5B,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,OAAO;QACL,GAAG,IAAI;QACP,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,GAAG;KACjC,CAAC;AACJ,CAAC"}

package/dist/server/utils/ttl.d.ts

@@ -0,0 +1,17 @@
+/**
+ * TTLを計算する
+ *
+ * @param resource - リソース名
+ * @param createdAt - 作成日時（ISO 8601形式）
+ * @returns TTL（Unix timestamp、秒単位）、TTL不要の場合はundefined
+ */
+export declare function calculateTTL(resource: string, createdAt: string): number | undefined;
+/**
+ * レコードデータにTTLを追加する
+ *
+ * @param resource - リソース名
+ * @param recordData - レコードデータ
+ * @returns TTLが追加されたレコードデータ
+ */
+export declare function addTTL(resource: string, recordData: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=ttl.d.ts.map

package/dist/server/utils/ttl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.d.ts","sourceRoot":"","sources":["../../../src/server/utils/ttl.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA8BpF;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CACpB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB"}

package/dist/server/utils/ttl.js

@@ -0,0 +1,62 @@
+/**
+ * TTL（Time To Live）ユーティリティ
+ * DynamoDB TTL設定を管理
+ */
+import { createLogger, getShadowConfig } from '../../index.js';
+const logger = createLogger({ service: 'records-lambda' });
+/**
+ * TTLを計算する
+ *
+ * @param resource - リソース名
+ * @param createdAt - 作成日時（ISO 8601形式）
+ * @returns TTL（Unix timestamp、秒単位）、TTL不要の場合はundefined
+ */
+export function calculateTTL(resource, createdAt) {
+    // shadow.config.jsonからTTL設定を取得
+    const shadowConfig = getShadowConfig();
+    const resourceConfig = shadowConfig.resources[resource];
+    if (!resourceConfig?.ttl) {
+        // TTL設定がないリソースはundefinedを返す
+        return undefined;
+    }
+    const defaultDays = resourceConfig.ttl.days;
+    // 環境変数から上書き可能（後方互換性のため）
+    const envKey = `${resource.toUpperCase()}_TTL_DAYS`;
+    const ttlDays = parseInt(process.env[envKey] || String(defaultDays), 10);
+    // 作成日時からTTLを計算
+    const createdAtMs = new Date(createdAt).getTime();
+    const ttlMs = createdAtMs + ttlDays * 24 * 60 * 60 * 1000;
+    const ttl = Math.floor(ttlMs / 1000);
+    logger.debug('TTL calculated', {
+        resource,
+        ttlDays,
+        createdAt,
+        ttl,
+        ttlDate: new Date(ttl * 1000).toISOString(),
+    });
+    return ttl;
+}
+/**
+ * レコードデータにTTLを追加する
+ *
+ * @param resource - リソース名
+ * @param recordData - レコードデータ
+ * @returns TTLが追加されたレコードデータ
+ */
+export function addTTL(resource, recordData) {
+    const createdAt = recordData.createdAt;
+    if (!createdAt) {
+        logger.warn('createdAt not found, skipping TTL calculation', { resource });
+        return recordData;
+    }
+    const ttl = calculateTTL(resource, createdAt);
+    if (ttl === undefined) {
+        // TTL不要のリソース
+        return recordData;
+    }
+    return {
+        ...recordData,
+        ttl,
+    };
+}
+//# sourceMappingURL=ttl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.js","sourceRoot":"","sources":["../../../src/server/utils/ttl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,SAAiB;IAC9D,+BAA+B;IAC/B,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IACvC,MAAM,cAAc,GAAG,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAExD,IAAI,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC;QACzB,4BAA4B;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;IAE5C,wBAAwB;IACxB,MAAM,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IACpD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzE,eAAe;IACf,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IAClD,MAAM,KAAK,GAAG,WAAW,GAAG,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAErC,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE;QAC7B,QAAQ;QACR,OAAO;QACP,SAAS;QACT,GAAG;QACH,OAAO,EAAE,IAAI,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;KAC5C,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CACpB,QAAgB,EAChB,UAAmC;IAEnC,MAAM,SAAS,GAAG,UAAU,CAAC,SAAmB,CAAC;IACjD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,+CAA+C,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3E,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC9C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,aAAa;QACb,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO;QACL,GAAG,UAAU;QACb,GAAG;KACJ,CAAC;AACJ,CAAC"}

package/dist/server/utils/validation.d.ts

@@ -0,0 +1,40 @@
+import type { ShadowConfig } from '../shadow/index.js';
+import type { FindManyReferenceParams, FindParams } from '../types.js';
+/**
+ * getList/getManyReferenceのソートフィールドを検証する
+ *
+ * @param config - シャドー設定
+ * @param resource - リソース名
+ * @param sort - ソート条件
+ * @throws {InvalidFilterError} ソートフィールドが無効な場合
+ */
+export declare function validateSortField(config: ShadowConfig, resource: string, sort?: {
+    field: string;
+    order: 'ASC' | 'DESC';
+}): void;
+/**
+ * ページネーションパラメータを正規化する
+ *
+ * @param pagination - ページネーション条件
+ * @returns 正規化されたページネーション条件
+ */
+export declare function normalizePagination(pagination?: FindParams['pagination'] | FindManyReferenceParams['pagination']): {
+    perPage: number;
+    nextToken?: string;
+};
+/**
+ * ソート条件を正規化する（デフォルト値を適用）
+ *
+ * @param config - シャドー設定
+ * @param resource - リソース名
+ * @param sort - ソート条件
+ * @returns 正規化されたソート条件
+ */
+export declare function normalizeSort(config: ShadowConfig, resource: string, sort?: {
+    field: string;
+    order: 'ASC' | 'DESC';
+}): {
+    field: string;
+    order: 'ASC' | 'DESC';
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/server/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/server/utils/validation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvE;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,GAC9C,IAAI,CAgBN;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,CAAC,EAAE,UAAU,CAAC,YAAY,CAAC,GAAG,uBAAuB,CAAC,YAAY,CAAC,GAC5E;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAKzC;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,GAC9C;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,CAO1C"}