@exabugs/dynamodb-client 0.4.0 → 0.5.0

package/dist/scripts/utils/awsUtils.js

@@ -0,0 +1,31 @@
+/**
+ * AWS関連ユーティリティ
+ *
+ * AWS CLIやAWSサービスとの連携処理
+ */
+/**
+ * Records Lambda Function URLを取得
+ *
+ * @param env - 環境名
+ * @param region - AWSリージョン
+ * @returns Function URL
+ * @throws {Error} Function URLの取得に失敗した場合
+ */
+export async function getRecordsApiUrl(env, region) {
+    // 環境変数から取得を試行
+    const envUrl = process.env.RECORDS_API_URL;
+    if (envUrl) {
+        return envUrl;
+    }
+    // AWS CLIで取得
+    const { execSync } = await import('child_process');
+    const functionName = `ainews-${env}-records`;
+    try {
+        const output = execSync(`aws lambda get-function-url-config --function-name ${functionName} --region ${region} --query 'FunctionUrl' --output text`, { encoding: 'utf-8' });
+        return output.trim();
+    }
+    catch {
+        throw new Error(`Failed to get Function URL for ${functionName}`);
+    }
+}
+//# sourceMappingURL=awsUtils.js.map

package/dist/scripts/utils/awsUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"awsUtils.js","sourceRoot":"","sources":["../../../src/scripts/utils/awsUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,MAAc;IAChE,cAAc;IACd,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,aAAa;IACb,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,CAAC;IAE7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CACrB,sDAAsD,YAAY,aAAa,MAAM,sCAAsC,EAC3H,EAAE,QAAQ,EAAE,OAAO,EAAE,CACtB,CAAC;QACF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,kCAAkC,YAAY,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

package/dist/scripts/utils/cliParser.d.ts

@@ -0,0 +1,30 @@
+/**
+ * コマンドライン引数解析ユーティリティ
+ *
+ * スクリプトのコマンドライン引数を解析する
+ */
+/**
+ * 修復スクリプトの設定
+ */
+export interface RepairScriptConfig {
+    resource: string;
+    recordId?: string;
+    dryRun: boolean;
+    repair: boolean;
+}
+/**
+ * コマンドライン引数を解析する
+ *
+ * @param args - process.argv.slice(2)の結果
+ * @returns 解析された設定
+ * @throws {Error} 必須引数が不足している場合
+ */
+export declare function parseRepairScriptArgs(args: string[]): RepairScriptConfig;
+/**
+ * スクリプト設定を表示する
+ *
+ * @param config - スクリプト設定
+ * @param apiUrl - Records API URL
+ */
+export declare function displayScriptConfig(config: RepairScriptConfig, apiUrl: string): void;
+//# sourceMappingURL=cliParser.d.ts.map

package/dist/scripts/utils/cliParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliParser.d.ts","sourceRoot":"","sources":["../../../src/scripts/utils/cliParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAqBxE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAQpF"}

package/dist/scripts/utils/cliParser.js

@@ -0,0 +1,44 @@
+/**
+ * コマンドライン引数解析ユーティリティ
+ *
+ * スクリプトのコマンドライン引数を解析する
+ */
+/**
+ * コマンドライン引数を解析する
+ *
+ * @param args - process.argv.slice(2)の結果
+ * @returns 解析された設定
+ * @throws {Error} 必須引数が不足している場合
+ */
+export function parseRepairScriptArgs(args) {
+    const resourceIndex = args.indexOf('--resource');
+    const idIndex = args.indexOf('--id');
+    const dryRun = args.includes('--dry-run');
+    const repair = args.includes('--repair');
+    if (resourceIndex === -1 || !args[resourceIndex + 1]) {
+        throw new Error('Usage: pnpm --filter @exabugs/dynamodb-client tsx scripts/repair-shadows.ts --resource <resource> [--id <id>] [--dry-run|--repair]');
+    }
+    const resource = args[resourceIndex + 1];
+    const recordId = idIndex !== -1 ? args[idIndex + 1] : undefined;
+    return {
+        resource,
+        recordId,
+        dryRun,
+        repair,
+    };
+}
+/**
+ * スクリプト設定を表示する
+ *
+ * @param config - スクリプト設定
+ * @param apiUrl - Records API URL
+ */
+export function displayScriptConfig(config, apiUrl) {
+    console.log(`Records API: ${apiUrl}`);
+    console.log(`Resource: ${config.resource}`);
+    console.log(`Mode: ${config.dryRun ? 'DRY RUN' : config.repair ? 'REPAIR' : 'DRY RUN (default)'}`);
+    if (config.recordId) {
+        console.log(`Target Record ID: ${config.recordId}`);
+    }
+}
+//# sourceMappingURL=cliParser.js.map

package/dist/scripts/utils/cliParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliParser.js","sourceRoot":"","sources":["../../../src/scripts/utils/cliParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAc;IAClD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAEzC,IAAI,aAAa,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,oIAAoI,CACrI,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEhE,OAAO;QACL,QAAQ;QACR,QAAQ;QACR,MAAM;QACN,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA0B,EAAE,MAAc;IAC5E,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAEnG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/scripts/utils/clientFactory.d.ts

@@ -0,0 +1,22 @@
+/**
+ * DynamoClientファクトリー
+ *
+ * DynamoClientの初期化処理
+ */
+import { DynamoClient, type Collection } from '../../client/index.iam.js';
+/**
+ * DynamoClient（IAM認証）を作成・初期化する
+ *
+ * @param apiUrl - Records API URL
+ * @param region - AWSリージョン
+ * @param resource - リソース名
+ * @returns 初期化されたコレクション
+ */
+export declare function createDynamoClientCollection(apiUrl: string, region: string, resource: string): Promise<{
+    client: DynamoClient;
+    collection: Collection<{
+        id: string;
+        [key: string]: unknown;
+    }>;
+}>;
+//# sourceMappingURL=clientFactory.d.ts.map

package/dist/scripts/utils/clientFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientFactory.d.ts","sourceRoot":"","sources":["../../../src/scripts/utils/clientFactory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE1E;;;;;;;GAOG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IACT,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;CAChE,CAAC,CAmBD"}

package/dist/scripts/utils/clientFactory.js

@@ -0,0 +1,31 @@
+/**
+ * DynamoClientファクトリー
+ *
+ * DynamoClientの初期化処理
+ */
+import { DynamoClient } from '../../client/index.iam.js';
+/**
+ * DynamoClient（IAM認証）を作成・初期化する
+ *
+ * @param apiUrl - Records API URL
+ * @param region - AWSリージョン
+ * @param resource - リソース名
+ * @returns 初期化されたコレクション
+ */
+export async function createDynamoClientCollection(apiUrl, region, resource) {
+    console.log(`\nCreating DynamoClient with IAM auth...`);
+    console.log(`Region: ${region}`);
+    console.log(`Endpoint: ${apiUrl}`);
+    const client = new DynamoClient(apiUrl, {
+        auth: {
+            region: region,
+        },
+        autoConnect: true,
+    });
+    console.log(`Client connected: ${client.isConnected()}\n`);
+    const collection = client
+        .db()
+        .collection(resource);
+    return { client, collection: collection };
+}
+//# sourceMappingURL=clientFactory.js.map

package/dist/scripts/utils/clientFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientFactory.js","sourceRoot":"","sources":["../../../src/scripts/utils/clientFactory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAmB,MAAM,2BAA2B,CAAC;AAE1E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,MAAc,EACd,MAAc,EACd,QAAgB;IAKhB,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;IAEnC,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,EAAE;QACtC,IAAI,EAAE;YACJ,MAAM,EAAE,MAAM;SACf;QACD,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAE3D,MAAM,UAAU,GAAG,MAAM;SACtB,EAAE,EAAE;SACJ,UAAU,CAAyC,QAAQ,CAAC,CAAC;IAEhE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAiB,EAAE,CAAC;AACnD,CAAC"}

package/dist/scripts/utils/repairUtils.d.ts

@@ -0,0 +1,58 @@
+/**
+ * シャドーレコード修復ユーティリティ
+ *
+ * 修復処理で使用する共通ロジック
+ */
+import type { Collection } from '../../client/index.iam.js';
+/**
+ * 修復統計情報
+ */
+export interface RepairStats {
+    scanned: number;
+    needsRepair: number;
+    repaired: number;
+    failed: number;
+    errors: Array<{
+        id: string;
+        error: string;
+    }>;
+}
+/**
+ * シャドー整合性チェック結果
+ */
+export interface ShadowIntegrityResult {
+    needsRepair: boolean;
+    missingShadows: number;
+    extraShadows: number;
+}
+/**
+ * 本体レコードのシャドーキーと実際のシャドーレコードを比較
+ *
+ * 注: Records Lambdaは__shadowKeysをHTTPレスポンスから除外するため、
+ * このスクリプトでは__shadowKeysの有無を確認できません。
+ * そのため、すべてのレコードを修復対象とします。
+ */
+export declare function checkShadowIntegrity(): Promise<ShadowIntegrityResult>;
+/**
+ * DynamoClient（IAM認証）を使用してシャドーを再生成
+ *
+ * @param collection - DynamoClientのコレクション
+ * @param recordId - レコードID
+ */
+export declare function repairRecordViaDynamoClient<TAuthOptions = unknown>(collection: Collection<{
+    id: string;
+    [key: string]: unknown;
+}, TAuthOptions>, recordId: string): Promise<void>;
+/**
+ * 修復統計情報を表示する
+ *
+ * @param stats - 修復統計情報
+ */
+export declare function displayRepairSummary(stats: RepairStats): void;
+/**
+ * レート制限を避けるための待機
+ *
+ * @param ms - 待機時間（ミリ秒）
+ */
+export declare function waitForRateLimit(ms?: number): Promise<void>;
+//# sourceMappingURL=repairUtils.d.ts.map

package/dist/scripts/utils/repairUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repairUtils.d.ts","sourceRoot":"","sources":["../../../src/scripts/utils/repairUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAO3E;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAAC,YAAY,GAAG,OAAO,EACtE,UAAU,EAAE,UAAU,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAAE,YAAY,CAAC,EAC5E,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAa7D;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,GAAE,MAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtE"}

package/dist/scripts/utils/repairUtils.js

@@ -0,0 +1,52 @@
+/**
+ * 本体レコードのシャドーキーと実際のシャドーレコードを比較
+ *
+ * 注: Records Lambdaは__shadowKeysをHTTPレスポンスから除外するため、
+ * このスクリプトでは__shadowKeysの有無を確認できません。
+ * そのため、すべてのレコードを修復対象とします。
+ */
+export async function checkShadowIntegrity() {
+    // Records Lambdaは__shadowKeysを除外するため、常に修復対象とする
+    return {
+        needsRepair: true,
+        missingShadows: 0,
+        extraShadows: 0,
+    };
+}
+/**
+ * DynamoClient（IAM認証）を使用してシャドーを再生成
+ *
+ * @param collection - DynamoClientのコレクション
+ * @param recordId - レコードID
+ */
+export async function repairRecordViaDynamoClient(collection, recordId) {
+    // updateOneを呼び出すと、Records Lambdaと同じロジックでシャドーレコードが再生成される
+    await collection.updateOne({ id: recordId }, { set: { updatedAt: new Date().toISOString() } });
+}
+/**
+ * 修復統計情報を表示する
+ *
+ * @param stats - 修復統計情報
+ */
+export function displayRepairSummary(stats) {
+    console.log('\n=== Repair Summary ===');
+    console.log(`Scanned: ${stats.scanned}`);
+    console.log(`Needs repair: ${stats.needsRepair}`);
+    console.log(`Repaired: ${stats.repaired}`);
+    console.log(`Failed: ${stats.failed}`);
+    if (stats.errors.length > 0) {
+        console.log('\nErrors:');
+        stats.errors.forEach(({ id, error }) => {
+            console.log(`  - ${id}: ${error}`);
+        });
+    }
+}
+/**
+ * レート制限を避けるための待機
+ *
+ * @param ms - 待機時間（ミリ秒）
+ */
+export async function waitForRateLimit(ms = 100) {
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=repairUtils.js.map

package/dist/scripts/utils/repairUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repairUtils.js","sourceRoot":"","sources":["../../../src/scripts/utils/repairUtils.ts"],"names":[],"mappings":"AA2BA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,+CAA+C;IAC/C,OAAO;QACL,WAAW,EAAE,IAAI;QACjB,cAAc,EAAE,CAAC;QACjB,YAAY,EAAE,CAAC;KAChB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,UAA4E,EAC5E,QAAgB;IAEhB,wDAAwD;IACxD,MAAM,UAAU,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;AACjG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAkB;IACrD,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAEvC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;YACrC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,KAAK,EAAE,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAa,GAAG;IACrD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC"}