@exabugs/dynamodb-client 0.3.7 → 0.4.0

package/dist/server/operations/find/shadowQuery.js

@@ -0,0 +1,283 @@
+/**
+ * シャドウレコードクエリの実装
+ *
+ * sort.field != 'id'の場合の通常のシャドウレコードクエリを担当します。
+ */
+import { QueryCommand, BatchGetCommand } from '@aws-sdk/lib-dynamodb';
+import { createLogger } from '../../../shared/index.js';
+import { getDBClient, getTableName, executeDynamoDBOperation, extractCleanRecord } from '../../utils/dynamodb.js';
+import { encodeNextToken, decodeNextToken } from '../../utils/pagination.js';
+import { findOptimizableFilter, matchesAllFilters } from './utils.js';
+const logger = createLogger({
+    service: 'shadow-query',
+    level: process.env.LOG_LEVEL || 'info',
+});
+/**
+ * シャドウレコードクエリを実行する
+ *
+ * @param resource - リソース名
+ * @param normalizedParams - 正規化されたパラメータ
+ * @param requestId - リクエストID
+ * @returns クエリ実行結果
+ */
+export async function executeShadowQuery(resource, normalizedParams, requestId) {
+    const { sort, pagination, parsedFilters } = normalizedParams;
+    const { perPage, nextToken } = pagination;
+    logger.debug('Executing shadow query', {
+        requestId,
+        resource,
+        sortField: sort.field,
+        hasFilters: parsedFilters.length > 0,
+    });
+    // Query最適化: ソートフィールドと一致するフィルター条件を検出
+    const optimizableFilter = findOptimizableFilter(sort.field, parsedFilters);
+    // シャドウクエリを実行
+    const shadowRecords = await executeShadowRecordQuery(resource, sort, perPage, nextToken, optimizableFilter, requestId);
+    // シャドウレコードから本体レコードのIDを抽出
+    const recordIds = extractRecordIds(shadowRecords.Items || []);
+    if (recordIds.length === 0) {
+        return {
+            items: [],
+            pageInfo: {
+                hasNextPage: false,
+                hasPreviousPage: false,
+            },
+        };
+    }
+    // 本体レコードを取得
+    const mainRecords = await fetchMainRecords(resource, recordIds, requestId);
+    // IDでマッピングを作成（順序を保持するため）
+    const recordMap = new Map(mainRecords.map((item) => {
+        const data = item.data;
+        return [data.id, extractCleanRecord(item)];
+    }));
+    // シャドーの順序でレコードを並べる（重複を除去）
+    const seenIds = new Set();
+    let items = recordIds
+        .filter((id) => {
+        if (seenIds.has(id)) {
+            return false; // 既に処理済みのIDはスキップ
+        }
+        seenIds.add(id);
+        return true;
+    })
+        .map((id) => recordMap.get(id))
+        .filter((record) => record !== undefined);
+    // フィルター条件を適用（メモリ内フィルタリング）
+    if (parsedFilters.length > 0) {
+        items = items.filter((record) => matchesAllFilters(record, parsedFilters));
+    }
+    // ページネーション情報を生成
+    const hasNextPage = (shadowRecords.Items?.length || 0) < perPage
+        ? false
+        : shadowRecords.LastEvaluatedKey !== undefined;
+    const nextTokenValue = hasNextPage && shadowRecords.LastEvaluatedKey
+        ? encodeNextToken(shadowRecords.LastEvaluatedKey.PK, shadowRecords.LastEvaluatedKey.SK)
+        : undefined;
+    logger.info('Shadow query succeeded', {
+        requestId,
+        resource,
+        sortField: sort.field,
+        shadowCount: shadowRecords.Items?.length || 0,
+        mainCount: items.length,
+        hasNextPage,
+    });
+    return {
+        items,
+        pageInfo: {
+            hasNextPage,
+            hasPreviousPage: !!nextToken,
+        },
+        ...(nextTokenValue && { nextToken: nextTokenValue }),
+    };
+}
+/**
+ * シャドウレコードクエリを実行する
+ *
+ * @param resource - リソース名
+ * @param sort - ソート条件
+ * @param perPage - ページサイズ
+ * @param nextToken - 次ページトークン
+ * @param optimizableFilter - 最適化可能なフィルター
+ * @param requestId - リクエストID
+ * @returns DynamoDBクエリ結果
+ */
+async function executeShadowRecordQuery(resource, sort, perPage, nextToken, optimizableFilter, _requestId) {
+    const dbClient = getDBClient();
+    const tableName = getTableName();
+    // ExclusiveStartKeyの設定
+    let exclusiveStartKey;
+    if (nextToken) {
+        const decoded = decodeNextToken(nextToken);
+        exclusiveStartKey = {
+            PK: decoded.PK,
+            SK: decoded.SK,
+        };
+    }
+    // KeyConditionExpressionを構築
+    const { keyConditionExpression, expressionAttributeValues } = buildKeyCondition(resource, sort.field, optimizableFilter);
+    return await executeDynamoDBOperation(() => dbClient.send(new QueryCommand({
+        TableName: tableName,
+        KeyConditionExpression: keyConditionExpression,
+        ExpressionAttributeValues: expressionAttributeValues,
+        ScanIndexForward: sort.order === 'ASC',
+        Limit: perPage,
+        ExclusiveStartKey: exclusiveStartKey,
+        ConsistentRead: true,
+    })), 'Query');
+}
+/**
+ * KeyConditionExpressionを構築する
+ *
+ * @param resource - リソース名
+ * @param sortField - ソートフィールド
+ * @param optimizableFilter - 最適化可能なフィルター
+ * @returns KeyConditionExpressionと属性値
+ */
+function buildKeyCondition(resource, sortField, optimizableFilter) {
+    const expressionAttributeValues = {
+        ':pk': resource,
+    };
+    if (!optimizableFilter) {
+        // 最適化なし: プレフィックスマッチ
+        return {
+            keyConditionExpression: 'PK = :pk AND begins_with(SK, :skPrefix)',
+            expressionAttributeValues: {
+                ...expressionAttributeValues,
+                ':skPrefix': `${sortField}#`,
+            },
+        };
+    }
+    // 最適化あり: フィルター条件をKeyConditionExpressionに含める
+    const { operator, type } = optimizableFilter.parsed;
+    const value = optimizableFilter.value;
+    // 値をシャドーSK形式にエンコード
+    const encodedValue = encodeValueForShadowSK(value, type);
+    const skValue = `${sortField}#${encodedValue}`;
+    switch (operator) {
+        case 'eq':
+            return {
+                keyConditionExpression: 'PK = :pk AND begins_with(SK, :skValue)',
+                expressionAttributeValues: {
+                    ...expressionAttributeValues,
+                    ':skValue': `${skValue}#id#`,
+                },
+            };
+        case 'gt':
+            return {
+                keyConditionExpression: 'PK = :pk AND SK > :skValue',
+                expressionAttributeValues: {
+                    ...expressionAttributeValues,
+                    ':skValue': `${skValue}#id#~`,
+                },
+            };
+        case 'gte':
+            return {
+                keyConditionExpression: 'PK = :pk AND SK >= :skValue',
+                expressionAttributeValues: {
+                    ...expressionAttributeValues,
+                    ':skValue': `${skValue}#id#`,
+                },
+            };
+        case 'lt':
+            return {
+                keyConditionExpression: 'PK = :pk AND begins_with(SK, :skPrefix) AND SK < :skValue',
+                expressionAttributeValues: {
+                    ...expressionAttributeValues,
+                    ':skPrefix': `${sortField}#`,
+                    ':skValue': `${skValue}#id#`,
+                },
+            };
+        case 'lte':
+            return {
+                keyConditionExpression: 'PK = :pk AND begins_with(SK, :skPrefix) AND SK <= :skValue',
+                expressionAttributeValues: {
+                    ...expressionAttributeValues,
+                    ':skPrefix': `${sortField}#`,
+                    ':skValue': `${skValue}#id#~`,
+                },
+            };
+        default:
+            // 未対応の演算子の場合はプレフィックスマッチにフォールバック
+            return {
+                keyConditionExpression: 'PK = :pk AND begins_with(SK, :skPrefix)',
+                expressionAttributeValues: {
+                    ...expressionAttributeValues,
+                    ':skPrefix': `${sortField}#`,
+                },
+            };
+    }
+}
+/**
+ * 値をシャドーSK形式にエンコードする
+ *
+ * @param value - エンコードする値
+ * @param type - 値の型
+ * @returns エンコードされた値
+ */
+function encodeValueForShadowSK(value, type) {
+    if (type === 'number') {
+        return String(value).padStart(20, '0');
+    }
+    else if (type === 'date') {
+        return new Date(String(value)).toISOString();
+    }
+    else if (type === 'boolean') {
+        return String(value);
+    }
+    else {
+        // string型: エスケープ処理（# → ##、スペース → #）
+        return String(value).replace(/#/g, '##').replace(/ /g, '#');
+    }
+}
+/**
+ * シャドウレコードから本体レコードのIDを抽出する
+ *
+ * @param shadowRecords - シャドウレコードの配列
+ * @returns レコードIDの配列
+ */
+function extractRecordIds(shadowRecords) {
+    return shadowRecords
+        .map((record) => {
+        const sk = record.SK;
+        // SK形式: {field}#{value}#id#{recordId}
+        const parts = sk.split('#id#');
+        return parts.length > 1 ? parts[1] : null;
+    })
+        .filter((id) => id !== null);
+}
+/**
+ * 本体レコードを取得する
+ *
+ * @param resource - リソース名
+ * @param recordIds - レコードIDの配列
+ * @param requestId - リクエストID
+ * @returns 本体レコードの配列
+ */
+async function fetchMainRecords(resource, recordIds, requestId) {
+    const dbClient = getDBClient();
+    const tableName = getTableName();
+    // 重複を除去
+    const uniqueRecordIds = Array.from(new Set(recordIds));
+    // 本体レコードをBatchGetItemで取得
+    const batchGetResult = await executeDynamoDBOperation(() => dbClient.send(new BatchGetCommand({
+        RequestItems: {
+            [tableName]: {
+                Keys: uniqueRecordIds.map((id) => ({
+                    PK: resource,
+                    SK: `id#${id}`,
+                })),
+                ConsistentRead: true,
+            },
+        },
+    })), 'BatchGetItem');
+    const mainRecords = batchGetResult.Responses?.[tableName] || [];
+    logger.debug('Main records fetched', {
+        requestId,
+        resource,
+        requestedCount: uniqueRecordIds.length,
+        fetchedCount: mainRecords.length,
+    });
+    return mainRecords;
+}
+//# sourceMappingURL=shadowQuery.js.map

package/dist/server/operations/find/shadowQuery.js.map

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

package/dist/server/operations/find/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Find操作の型定義
+ */
+import type { FindParams, FindResult } from '../../types.js';
+/**
+ * 解析済みフィルター条件
+ */
+export interface ParsedFilter {
+    parsed: ParsedFilterField;
+    value: unknown;
+}
+/**
+ * フィルターフィールドの解析結果
+ */
+export interface ParsedFilterField {
+    field: string;
+    operator: string;
+    type?: string;
+}
+/**
+ * 最適化可能なフィルター条件
+ */
+export interface OptimizableFilter {
+    parsed: ParsedFilterField;
+    value: unknown;
+}
+/**
+ * 正規化されたFind操作のパラメータ
+ */
+export interface NormalizedFindParams {
+    sort: {
+        field: string;
+        order: 'ASC' | 'DESC';
+    };
+    pagination: {
+        perPage: number;
+        nextToken?: string;
+    };
+    parsedFilters: ParsedFilter[];
+}
+/**
+ * Find操作のコンテキスト
+ */
+export interface FindContext {
+    resource: string;
+    params: FindParams;
+    requestId: string;
+    shadowConfig: any;
+    sort: {
+        field: string;
+        order: 'ASC' | 'DESC';
+    };
+    pagination: {
+        perPage: number;
+        nextToken?: string;
+    };
+    parsedFilters: ParsedFilter[];
+}
+/**
+ * クエリ実行結果
+ */
+export interface QueryExecutionResult {
+    items: any[];
+    pageInfo: {
+        hasNextPage: boolean;
+        hasPreviousPage: boolean;
+    };
+    nextToken?: string;
+}
+export type { FindParams, FindResult };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/operations/find/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;KACvB,CAAC;IACF,UAAU,EAAE;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,GAAG,CAAC;IAClB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;KACvB,CAAC;IACF,UAAU,EAAE;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,GAAG,EAAE,CAAC;IACb,QAAQ,EAAE;QACR,WAAW,EAAE,OAAO,CAAC;QACrB,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC"}

package/dist/server/operations/find/types.js

@@ -0,0 +1,5 @@
+/**
+ * Find操作の型定義
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/operations/find/types.js.map

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

package/dist/server/operations/find/utils.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Find操作のユーティリティ関数
+ */
+import type { FindParams } from '../../types.js';
+import type { ParsedFilter, OptimizableFilter, NormalizedFindParams } from './types.js';
+/**
+ * Find操作の設定を初期化する
+ *
+ * @returns シャドウ設定
+ */
+export declare function initializeFindConfig(): import("../../index.js").ShadowConfig;
+/**
+ * Find操作のパラメータを正規化する
+ *
+ * @param config - シャドウ設定
+ * @param resource - リソース名
+ * @param params - Find操作のパラメータ
+ * @returns 正規化されたパラメータ
+ */
+export declare function normalizeFindParams(config: any, resource: string, params: FindParams): NormalizedFindParams;
+/**
+ * 最適化可能なフィルター条件を検索する
+ *
+ * @param sortField - ソートフィールド
+ * @param parsedFilters - 解析済みフィルター条件
+ * @returns 最適化可能なフィルター条件（見つからない場合はundefined）
+ */
+export declare function findOptimizableFilter(sortField: string, parsedFilters: ParsedFilter[]): OptimizableFilter | undefined;
+/**
+ * すべてのフィルター条件にマッチするかチェックする
+ *
+ * @param record - レコード
+ * @param parsedFilters - 解析済みフィルター条件
+ * @returns マッチする場合true
+ */
+export declare function matchesAllFilters(record: Record<string, unknown>, parsedFilters: ParsedFilter[]): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/server/operations/find/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/server/operations/find/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAYxF;;;;GAIG;AACH,wBAAgB,oBAAoB,0CAEnC;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,GAAG,EACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,GACjB,oBAAoB,CAetB;AAoCD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,YAAY,EAAE,GAC5B,iBAAiB,GAAG,SAAS,CAI/B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,aAAa,EAAE,YAAY,EAAE,GAC5B,OAAO,CA6BT"}

package/dist/server/operations/find/utils.js

@@ -0,0 +1,117 @@
+/**
+ * Find操作のユーティリティ関数
+ */
+import { getShadowConfig } from '../../shadow/index.js';
+import { createLogger } from '../../../shared/index.js';
+import { parseFilterField } from '../../utils/filter.js';
+import { ConfigError } from '../../../shared/errors/index.js';
+import { normalizeSort as originalNormalizeSort, normalizePagination as originalNormalizePagination } from '../../utils/validation.js';
+const logger = createLogger({
+    service: 'find-utils',
+    level: process.env.LOG_LEVEL || 'info',
+});
+/**
+ * Find操作の設定を初期化する
+ *
+ * @returns シャドウ設定
+ */
+export function initializeFindConfig() {
+    return getShadowConfig();
+}
+/**
+ * Find操作のパラメータを正規化する
+ *
+ * @param config - シャドウ設定
+ * @param resource - リソース名
+ * @param params - Find操作のパラメータ
+ * @returns 正規化されたパラメータ
+ */
+export function normalizeFindParams(config, resource, params) {
+    // ソート条件を正規化
+    const sort = originalNormalizeSort(config, resource, params.sort);
+    // ページネーション条件を正規化
+    const pagination = originalNormalizePagination(params.pagination);
+    // フィルター条件を解析
+    const parsedFilters = parseFilters(params.filter);
+    return {
+        sort,
+        pagination,
+        parsedFilters,
+    };
+}
+/**
+ * フィルター条件を解析する
+ *
+ * @param filter - フィルター条件
+ * @returns 解析済みフィルター条件の配列
+ */
+function parseFilters(filter) {
+    const parsedFilters = [];
+    if (!filter || Object.keys(filter).length === 0) {
+        return parsedFilters;
+    }
+    for (const [fieldKey, value] of Object.entries(filter)) {
+        try {
+            const parsed = parseFilterField(fieldKey);
+            parsedFilters.push({ parsed, value });
+        }
+        catch (error) {
+            logger.error('Invalid filter field syntax', {
+                fieldKey,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw new ConfigError(`Invalid filter field syntax: ${fieldKey}`, {
+                field: fieldKey,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return parsedFilters;
+}
+/**
+ * 最適化可能なフィルター条件を検索する
+ *
+ * @param sortField - ソートフィールド
+ * @param parsedFilters - 解析済みフィルター条件
+ * @returns 最適化可能なフィルター条件（見つからない場合はundefined）
+ */
+export function findOptimizableFilter(sortField, parsedFilters) {
+    return parsedFilters.find((filter) => filter.parsed.field === sortField);
+}
+/**
+ * すべてのフィルター条件にマッチするかチェックする
+ *
+ * @param record - レコード
+ * @param parsedFilters - 解析済みフィルター条件
+ * @returns マッチする場合true
+ */
+export function matchesAllFilters(record, parsedFilters) {
+    return parsedFilters.every((filter) => {
+        const { field, operator } = filter.parsed;
+        const recordValue = record[field];
+        const filterValue = filter.value;
+        switch (operator) {
+            case 'eq':
+                return recordValue === filterValue;
+            case 'ne':
+                return recordValue !== filterValue;
+            case 'gt':
+                return recordValue != null && recordValue > filterValue;
+            case 'gte':
+                return recordValue != null && recordValue >= filterValue;
+            case 'lt':
+                return recordValue != null && recordValue < filterValue;
+            case 'lte':
+                return recordValue != null && recordValue <= filterValue;
+            case 'in':
+                return Array.isArray(filterValue) && filterValue.includes(recordValue);
+            case 'nin':
+                return Array.isArray(filterValue) && !filterValue.includes(recordValue);
+            case 'starts':
+                return typeof recordValue === 'string' && typeof filterValue === 'string' && recordValue.startsWith(filterValue);
+            default:
+                return true;
+        }
+    });
+}
+//# sourceMappingURL=utils.js.map

package/dist/server/operations/find/utils.js.map

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

package/dist/server/operations/find.d.ts

@@ -1,18 +1,8 @@
-import type { FindParams, FindResult } from '../types.js';
 /**
- * find 操作を実行する
+ * find 操作
+ * リスト取得（フィルター・ソート・ページネーション対応）
  *
- * 処理フロー:
- * 1. シャドー設定を読み込み、ソートフィールドを検証
- * 2. シャドーレコードをQueryで取得（ソート済み）
- * 3. 本体レコードをBatchGetItemで取得
- * 4. フィルター条件を適用
- * 5. ページネーション情報を生成してレスポンスを返す
- *
- * @param resource - リソース名
- * @param params - findパラメータ
- * @param requestId - リクエストID
- * @returns リストデータ
+ * 要件: 4.3, 5.4, 5.5, 12.1-12.12
  */
-export declare function handleFind(resource: string, params: FindParams, requestId: string): Promise<FindResult>;
+export { handleFind } from './find/handler.js';
 //# sourceMappingURL=find.d.ts.map

package/dist/server/operations/find.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/server/operations/find.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAkB1D;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAwarB"}
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/server/operations/find.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}