captify 0.1.18 → 0.1.19

package/dist/search/services/migration.service.js

@@ -0,0 +1,414 @@
+/**
+ * Index Migration Service
+ *
+ * Handles schema migrations for OpenSearch indices with zero-downtime support.
+ * Compares deployed index versions against INDEX_DEFINITIONS and performs
+ * reindex operations when needed.
+ */
+import { BaseAwsService } from "../../shared/services/base-aws-service";
+import { INDEX_DEFINITIONS, MIGRATION_CONFIG, MIGRATION_ERROR_MESSAGES, } from "../search.constants";
+import { getOpenSearchService } from "./opensearch.singleton";
+/**
+ * Parse version string into major and minor components
+ */
+function parseVersion(version) {
+    const match = version.match(/^(\d+)\.(\d+)$/);
+    if (!match) {
+        return null;
+    }
+    return {
+        major: parseInt(match[1], 10),
+        minor: parseInt(match[2], 10),
+    };
+}
+/**
+ * Compare two version strings
+ * Returns: -1 if a < b, 0 if a == b, 1 if a > b
+ */
+function compareVersions(a, b) {
+    const parsedA = parseVersion(a);
+    const parsedB = parseVersion(b);
+    if (!parsedA || !parsedB) {
+        return a.localeCompare(b);
+    }
+    if (parsedA.major !== parsedB.major) {
+        return parsedA.major < parsedB.major ? -1 : 1;
+    }
+    if (parsedA.minor !== parsedB.minor) {
+        return parsedA.minor < parsedB.minor ? -1 : 1;
+    }
+    return 0;
+}
+/**
+ * Check if version change is a major (breaking) change
+ */
+function isMajorVersionChange(currentVersion, targetVersion) {
+    const current = parseVersion(currentVersion);
+    const target = parseVersion(targetVersion);
+    if (!current || !target) {
+        return true; // Treat unparseable versions as major changes
+    }
+    return current.major !== target.major;
+}
+/**
+ * Service for managing OpenSearch index schema migrations.
+ *
+ * Features:
+ * - Version comparison between deployed and defined schemas
+ * - Zero-downtime migrations via reindex + alias swap
+ * - Support for both minor (additive) and major (breaking) changes
+ * - Progress tracking and error handling
+ */
+export class MigrationService extends BaseAwsService {
+    constructor(deps = {}) {
+        super({ logger: deps.logger, serviceName: "MigrationService" });
+    }
+    /**
+     * Get migration status for a single index
+     */
+    async getIndexMigrationStatus(indexName, userCredentials) {
+        const definition = INDEX_DEFINITIONS.find((def) => def.name === indexName);
+        if (!definition) {
+            return {
+                indexName,
+                currentVersion: null,
+                targetVersion: "unknown",
+                status: "not_exists",
+                isMajorChange: false,
+                message: `Index ${indexName} is not defined in INDEX_DEFINITIONS`,
+            };
+        }
+        const opensearchService = getOpenSearchService();
+        const exists = await opensearchService.indexExists(indexName, userCredentials);
+        if (!exists) {
+            return {
+                indexName,
+                currentVersion: null,
+                targetVersion: definition.version,
+                status: "not_exists",
+                isMajorChange: false,
+                message: `Index ${indexName} does not exist`,
+            };
+        }
+        const currentVersion = await opensearchService.getIndexVersion(indexName, userCredentials);
+        // Legacy index without version metadata
+        if (currentVersion === null) {
+            return {
+                indexName,
+                currentVersion: MIGRATION_CONFIG.LEGACY_VERSION,
+                targetVersion: definition.version,
+                status: "unknown_version",
+                isMajorChange: true,
+                message: `Index ${indexName} has no version metadata (legacy index), assuming ${MIGRATION_CONFIG.LEGACY_VERSION}`,
+            };
+        }
+        // Compare versions
+        const comparison = compareVersions(currentVersion, definition.version);
+        if (comparison === 0) {
+            return {
+                indexName,
+                currentVersion,
+                targetVersion: definition.version,
+                status: "up_to_date",
+                isMajorChange: false,
+                message: `Index ${indexName} is up-to-date (v${currentVersion})`,
+            };
+        }
+        if (comparison > 0) {
+            // Current version is newer than target (shouldn't happen normally)
+            return {
+                indexName,
+                currentVersion,
+                targetVersion: definition.version,
+                status: "up_to_date",
+                isMajorChange: false,
+                message: `Index ${indexName} has newer version (v${currentVersion}) than target (v${definition.version})`,
+            };
+        }
+        // Needs migration
+        const isMajor = isMajorVersionChange(currentVersion, definition.version);
+        return {
+            indexName,
+            currentVersion,
+            targetVersion: definition.version,
+            status: "needs_migration",
+            isMajorChange: isMajor,
+            message: `Index ${indexName} needs migration from v${currentVersion} to v${definition.version}${isMajor ? " (major change)" : ""}`,
+        };
+    }
+    /**
+     * Get migration plan for all indices
+     */
+    async getMigrationPlan(userCredentials) {
+        const indices = [];
+        for (const definition of INDEX_DEFINITIONS) {
+            const status = await this.getIndexMigrationStatus(definition.name, userCredentials);
+            indices.push(status);
+        }
+        const migrationCount = indices.filter((i) => i.status === "needs_migration").length;
+        const missingCount = indices.filter((i) => i.status === "not_exists").length;
+        const unknownCount = indices.filter((i) => i.status === "unknown_version").length;
+        let status;
+        if (migrationCount > 0 || unknownCount > 0) {
+            status = "migrations_needed";
+        }
+        else if (missingCount > 0) {
+            status = "indices_missing";
+        }
+        else {
+            status = "all_up_to_date";
+        }
+        return {
+            status,
+            indices,
+            migrationCount: migrationCount + unknownCount,
+            missingCount,
+            generatedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Migrate a single index
+     * Uses reindex operation to copy data from old to new index with updated schema
+     */
+    async migrateIndex(indexName, userCredentials) {
+        const startTime = Date.now();
+        const definition = INDEX_DEFINITIONS.find((def) => def.name === indexName);
+        if (!definition) {
+            return {
+                indexName,
+                status: "failed",
+                fromVersion: null,
+                toVersion: "unknown",
+                error: MIGRATION_ERROR_MESSAGES.INDEX_NOT_FOUND,
+            };
+        }
+        const opensearchService = getOpenSearchService();
+        // Get current status
+        const status = await this.getIndexMigrationStatus(indexName, userCredentials);
+        if (status.status === "up_to_date") {
+            return {
+                indexName,
+                status: "skipped",
+                fromVersion: status.currentVersion,
+                toVersion: definition.version,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        if (status.status === "not_exists") {
+            // Index doesn't exist - create it fresh with version
+            try {
+                await opensearchService.createIndexWithVersion(indexName, definition.mappings, definition.version, userCredentials, definition.settings);
+                this.logger.info("Created new index with version", {
+                    indexName,
+                    version: definition.version,
+                });
+                return {
+                    indexName,
+                    status: "completed",
+                    fromVersion: null,
+                    toVersion: definition.version,
+                    documentsCount: 0,
+                    durationMs: Date.now() - startTime,
+                };
+            }
+            catch (error) {
+                this.logger.error("Failed to create index", {
+                    indexName,
+                    error: error instanceof Error ? error.message : String(error),
+                    stack: error instanceof Error ? error.stack : undefined,
+                });
+                return {
+                    indexName,
+                    status: "failed",
+                    fromVersion: null,
+                    toVersion: definition.version,
+                    error: MIGRATION_ERROR_MESSAGES.INDEX_CREATION_FAILED,
+                    durationMs: Date.now() - startTime,
+                };
+            }
+        }
+        // Need to migrate - use reindex strategy
+        const tempIndexName = `${indexName}${MIGRATION_CONFIG.TEMP_INDEX_SUFFIX}`;
+        try {
+            this.logger.info("Starting index migration", {
+                indexName,
+                fromVersion: status.currentVersion,
+                toVersion: definition.version,
+            });
+            // 1. Create new temp index with new schema and version
+            const tempExists = await opensearchService.indexExists(tempIndexName, userCredentials);
+            if (tempExists) {
+                this.logger.warn("Temp migration index already exists, deleting it", { tempIndexName });
+                await opensearchService.deleteIndexUnsafe(tempIndexName, userCredentials);
+            }
+            await opensearchService.createIndexWithVersion(tempIndexName, definition.mappings, definition.version, userCredentials, definition.settings);
+            // 2. Reindex data from old to temp
+            const taskId = await opensearchService.reindex(indexName, tempIndexName, userCredentials);
+            // 3. Wait for reindex to complete
+            const reindexResult = await this.waitForReindex(taskId, userCredentials);
+            if (reindexResult.error) {
+                throw new Error(`${MIGRATION_ERROR_MESSAGES.REINDEX_FAILED}: ${reindexResult.error}`);
+            }
+            // 4. Delete old index
+            await opensearchService.deleteIndexUnsafe(indexName, userCredentials);
+            // 5. Create new index with correct name and schema
+            await opensearchService.createIndexWithVersion(indexName, definition.mappings, definition.version, userCredentials, definition.settings);
+            // 6. Reindex from temp to final
+            const finalTaskId = await opensearchService.reindex(tempIndexName, indexName, userCredentials);
+            const finalResult = await this.waitForReindex(finalTaskId, userCredentials);
+            if (finalResult.error) {
+                throw new Error(`${MIGRATION_ERROR_MESSAGES.REINDEX_FAILED}: ${finalResult.error}`);
+            }
+            // 7. Delete temp index
+            await opensearchService.deleteIndexUnsafe(tempIndexName, userCredentials);
+            const documentsCount = await opensearchService.getDocumentCount(indexName, userCredentials);
+            this.logger.info("Index migration completed", {
+                indexName,
+                fromVersion: status.currentVersion,
+                toVersion: definition.version,
+                documentsCount,
+                durationMs: Date.now() - startTime,
+            });
+            return {
+                indexName,
+                status: "completed",
+                fromVersion: status.currentVersion,
+                toVersion: definition.version,
+                documentsCount,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            this.logger.error("Index migration failed", {
+                indexName,
+                fromVersion: status.currentVersion,
+                toVersion: definition.version,
+                error: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error ? error.stack : undefined,
+            });
+            // IMPORTANT: Do NOT delete temp index on failure - it may contain the only copy of data
+            // if the original index was already deleted during migration.
+            // Log recovery instructions instead.
+            try {
+                const tempExists = await opensearchService.indexExists(tempIndexName, userCredentials);
+                if (tempExists) {
+                    this.logger.warn("Temp index preserved for manual recovery", {
+                        tempIndexName,
+                        originalIndex: indexName,
+                        recovery: `To recover: 1) Check if ${indexName} exists, 2) If not, reindex from ${tempIndexName} to ${indexName}, 3) Delete ${tempIndexName} after verification`,
+                    });
+                }
+            }
+            catch (checkError) {
+                this.logger.warn("Failed to check temp index status after migration failure", {
+                    tempIndexName,
+                    error: checkError instanceof Error ? checkError.message : String(checkError),
+                });
+            }
+            return {
+                indexName,
+                status: "failed",
+                fromVersion: status.currentVersion,
+                toVersion: definition.version,
+                error: MIGRATION_ERROR_MESSAGES.MIGRATION_FAILED,
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    /**
+     * Wait for reindex task to complete
+     */
+    async waitForReindex(taskId, userCredentials) {
+        const opensearchService = getOpenSearchService();
+        const startTime = Date.now();
+        while (Date.now() - startTime < MIGRATION_CONFIG.REINDEX_TIMEOUT_MS) {
+            const status = await opensearchService.getTaskStatus(taskId, userCredentials);
+            if (status.completed) {
+                return status;
+            }
+            this.logger.debug("Reindex in progress", {
+                taskId,
+                processed: status.processed,
+                total: status.total,
+            });
+            await this.sleep(MIGRATION_CONFIG.REINDEX_POLL_INTERVAL_MS);
+        }
+        return {
+            completed: false,
+            total: 0,
+            processed: 0,
+            error: MIGRATION_ERROR_MESSAGES.REINDEX_TIMEOUT,
+        };
+    }
+    /**
+     * Migrate all indices that need migration
+     */
+    async migrateAll(userCredentials) {
+        const startTime = Date.now();
+        const results = [];
+        const plan = await this.getMigrationPlan(userCredentials);
+        this.logger.info("Starting migration for all indices", {
+            totalIndices: plan.indices.length,
+            needsMigration: plan.migrationCount,
+            missing: plan.missingCount,
+        });
+        for (const indexStatus of plan.indices) {
+            // Only migrate indices that need it or don't exist
+            if (indexStatus.status === "needs_migration" ||
+                indexStatus.status === "not_exists" ||
+                indexStatus.status === "unknown_version") {
+                const result = await this.migrateIndex(indexStatus.indexName, userCredentials);
+                results.push(result);
+            }
+            else {
+                results.push({
+                    indexName: indexStatus.indexName,
+                    status: "skipped",
+                    fromVersion: indexStatus.currentVersion,
+                    toVersion: indexStatus.targetVersion,
+                });
+            }
+        }
+        const successCount = results.filter((r) => r.status === "completed").length;
+        const failedCount = results.filter((r) => r.status === "failed").length;
+        const skippedCount = results.filter((r) => r.status === "skipped").length;
+        let status;
+        if (failedCount === 0) {
+            status = "completed";
+        }
+        else if (successCount > 0) {
+            status = "partial";
+        }
+        else {
+            status = "failed";
+        }
+        const result = {
+            status,
+            results,
+            totalDurationMs: Date.now() - startTime,
+            successCount,
+            failedCount,
+            skippedCount,
+            completedAt: new Date().toISOString(),
+        };
+        this.logger.info("Migration completed", {
+            status: result.status,
+            successCount,
+            failedCount,
+            skippedCount,
+            durationMs: result.totalDurationMs,
+        });
+        return result;
+    }
+}
+// ============================================================================
+// Singleton
+// ============================================================================
+let migrationServiceInstance = null;
+export function getMigrationService(logger) {
+    if (!migrationServiceInstance) {
+        migrationServiceInstance = new MigrationService({ logger });
+    }
+    return migrationServiceInstance;
+}
+//# sourceMappingURL=migration.service.js.map

package/dist/search/services/migration.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.service.js","sourceRoot":"","sources":["../../../lib/search/services/migration.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAUvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAElF;;GAEG;AACH,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,CAAS,EAAE,CAAS;IAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAEhC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,cAAsB,EAAE,aAAqB;IACzE,MAAM,OAAO,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;IAE3C,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,CAAC,8CAA8C;IAC7D,CAAC;IAED,OAAO,OAAO,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC;AACxC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IAClD,YAAY,OAA6B,EAAE;QACzC,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,uBAAuB,CAC3B,SAAiB,EACjB,eAAmC;QAEnC,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QAC3E,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;gBACL,SAAS;gBACT,cAAc,EAAE,IAAI;gBACpB,aAAa,EAAE,SAAS;gBACxB,MAAM,EAAE,YAAY;gBACpB,aAAa,EAAE,KAAK;gBACpB,OAAO,EAAE,SAAS,SAAS,sCAAsC;aAClE,CAAC;QACJ,CAAC;QAED,MAAM,iBAAiB,GAAG,oBAAoB,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAE/E,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,SAAS;gBACT,cAAc,EAAE,IAAI;gBACpB,aAAa,EAAE,UAAU,CAAC,OAAO;gBACjC,MAAM,EAAE,YAAY;gBACpB,aAAa,EAAE,KAAK;gBACpB,OAAO,EAAE,SAAS,SAAS,iBAAiB;aAC7C,CAAC;QACJ,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,iBAAiB,CAAC,eAAe,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAE3F,wCAAwC;QACxC,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;YAC5B,OAAO;gBACL,SAAS;gBACT,cAAc,EAAE,gBAAgB,CAAC,cAAc;gBAC/C,aAAa,EAAE,UAAU,CAAC,OAAO;gBACjC,MAAM,EAAE,iBAAiB;gBACzB,aAAa,EAAE,IAAI;gBACnB,OAAO,EAAE,SAAS,SAAS,qDAAqD,gBAAgB,CAAC,cAAc,EAAE;aAClH,CAAC;QACJ,CAAC;QAED,mBAAmB;QACnB,MAAM,UAAU,GAAG,eAAe,CAAC,cAAc,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;QAEvE,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO;gBACL,SAAS;gBACT,cAAc;gBACd,aAAa,EAAE,UAAU,CAAC,OAAO;gBACjC,MAAM,EAAE,YAAY;gBACpB,aAAa,EAAE,KAAK;gBACpB,OAAO,EAAE,SAAS,SAAS,oBAAoB,cAAc,GAAG;aACjE,CAAC;QACJ,CAAC;QAED,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,mEAAmE;YACnE,OAAO;gBACL,SAAS;gBACT,cAAc;gBACd,aAAa,EAAE,UAAU,CAAC,OAAO;gBACjC,MAAM,EAAE,YAAY;gBACpB,aAAa,EAAE,KAAK;gBACpB,OAAO,EAAE,SAAS,SAAS,wBAAwB,cAAc,mBAAmB,UAAU,CAAC,OAAO,GAAG;aAC1G,CAAC;QACJ,CAAC;QAED,kBAAkB;QAClB,MAAM,OAAO,GAAG,oBAAoB,CAAC,cAAc,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;QACzE,OAAO;YACL,SAAS;YACT,cAAc;YACd,aAAa,EAAE,UAAU,CAAC,OAAO;YACjC,MAAM,EAAE,iBAAiB;YACzB,aAAa,EAAE,OAAO;YACtB,OAAO,EAAE,SAAS,SAAS,0BAA0B,cAAc,QAAQ,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE;SACnI,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,eAAmC;QACxD,MAAM,OAAO,GAA2B,EAAE,CAAC;QAE3C,KAAK,MAAM,UAAU,IAAI,iBAAiB,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,UAAU,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;YACpF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAED,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,iBAAiB,CAAC,CAAC,MAAM,CAAC;QACpF,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC,MAAM,CAAC;QAC7E,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,iBAAiB,CAAC,CAAC,MAAM,CAAC;QAElF,IAAI,MAA+B,CAAC;QACpC,IAAI,cAAc,GAAG,CAAC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YAC3C,MAAM,GAAG,mBAAmB,CAAC;QAC/B,CAAC;aAAM,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,GAAG,iBAAiB,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,gBAAgB,CAAC;QAC5B,CAAC;QAED,OAAO;YACL,MAAM;YACN,OAAO;YACP,cAAc,EAAE,cAAc,GAAG,YAAY;YAC7C,YAAY;YACZ,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAChB,SAAiB,EACjB,eAAmC;QAEnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QAC3E,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;gBACL,SAAS;gBACT,MAAM,EAAE,QAAQ;gBAChB,WAAW,EAAE,IAAI;gBACjB,SAAS,EAAE,SAAS;gBACpB,KAAK,EAAE,wBAAwB,CAAC,eAAe;aAChD,CAAC;QACJ,CAAC;QAED,MAAM,iBAAiB,GAAG,oBAAoB,EAAE,CAAC;QAEjD,qBAAqB;QACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAE9E,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YACnC,OAAO;gBACL,SAAS;gBACT,MAAM,EAAE,SAAS;gBACjB,WAAW,EAAE,MAAM,CAAC,cAAc;gBAClC,SAAS,EAAE,UAAU,CAAC,OAAO;gBAC7B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACnC,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YACnC,qDAAqD;YACrD,IAAI,CAAC;gBACH,MAAM,iBAAiB,CAAC,sBAAsB,CAC5C,SAAS,EACT,UAAU,CAAC,QAAQ,EACnB,UAAU,CAAC,OAAO,EAClB,eAAe,EACf,UAAU,CAAC,QAAQ,CACpB,CAAC;gBAEF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE;oBACjD,SAAS;oBACT,OAAO,EAAE,UAAU,CAAC,OAAO;iBAC5B,CAAC,CAAC;gBAEH,OAAO;oBACL,SAAS;oBACT,MAAM,EAAE,WAAW;oBACnB,WAAW,EAAE,IAAI;oBACjB,SAAS,EAAE,UAAU,CAAC,OAAO;oBAC7B,cAAc,EAAE,CAAC;oBACjB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;iBACnC,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE;oBAC1C,SAAS;oBACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;oBAC7D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;iBACxD,CAAC,CAAC;gBACH,OAAO;oBACL,SAAS;oBACT,MAAM,EAAE,QAAQ;oBAChB,WAAW,EAAE,IAAI;oBACjB,SAAS,EAAE,UAAU,CAAC,OAAO;oBAC7B,KAAK,EAAE,wBAAwB,CAAC,qBAAqB;oBACrD,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;iBACnC,CAAC;YACJ,CAAC;QACH,CAAC;QAED,yCAAyC;QACzC,MAAM,aAAa,GAAG,GAAG,SAAS,GAAG,gBAAgB,CAAC,iBAAiB,EAAE,CAAC;QAE1E,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;gBAC3C,SAAS;gBACT,WAAW,EAAE,MAAM,CAAC,cAAc;gBAClC,SAAS,EAAE,UAAU,CAAC,OAAO;aAC9B,CAAC,CAAC;YAEH,uDAAuD;YACvD,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;YACvF,IAAI,UAAU,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kDAAkD,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;gBACxF,MAAM,iBAAiB,CAAC,iBAAiB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;YAC5E,CAAC;YAED,MAAM,iBAAiB,CAAC,sBAAsB,CAC5C,aAAa,EACb,UAAU,CAAC,QAAQ,EACnB,UAAU,CAAC,OAAO,EAClB,eAAe,EACf,UAAU,CAAC,QAAQ,CACpB,CAAC;YAEF,mCAAmC;YACnC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;YAE1F,kCAAkC;YAClC,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;YACzE,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,GAAG,wBAAwB,CAAC,cAAc,KAAK,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC;YACxF,CAAC;YAED,sBAAsB;YACtB,MAAM,iBAAiB,CAAC,iBAAiB,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;YAEtE,mDAAmD;YACnD,MAAM,iBAAiB,CAAC,sBAAsB,CAC5C,SAAS,EACT,UAAU,CAAC,QAAQ,EACnB,UAAU,CAAC,OAAO,EAClB,eAAe,EACf,UAAU,CAAC,QAAQ,CACpB,CAAC;YAEF,gCAAgC;YAChC,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,OAAO,CACjD,aAAa,EACb,SAAS,EACT,eAAe,CAChB,CAAC;YACF,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;YAC5E,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,GAAG,wBAAwB,CAAC,cAAc,KAAK,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;YACtF,CAAC;YAED,uBAAuB;YACvB,MAAM,iBAAiB,CAAC,iBAAiB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;YAE1E,MAAM,cAAc,GAAG,MAAM,iBAAiB,CAAC,gBAAgB,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;YAE5F,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;gBAC5C,SAAS;gBACT,WAAW,EAAE,MAAM,CAAC,cAAc;gBAClC,SAAS,EAAE,UAAU,CAAC,OAAO;gBAC7B,cAAc;gBACd,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACnC,CAAC,CAAC;YAEH,OAAO;gBACL,SAAS;gBACT,MAAM,EAAE,WAAW;gBACnB,WAAW,EAAE,MAAM,CAAC,cAAc;gBAClC,SAAS,EAAE,UAAU,CAAC,OAAO;gBAC7B,cAAc;gBACd,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACnC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE;gBAC1C,SAAS;gBACT,WAAW,EAAE,MAAM,CAAC,cAAc;gBAClC,SAAS,EAAE,UAAU,CAAC,OAAO;gBAC7B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACxD,CAAC,CAAC;YAEH,wFAAwF;YACxF,8DAA8D;YAC9D,qCAAqC;YACrC,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;gBACvF,IAAI,UAAU,EAAE,CAAC;oBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE;wBAC3D,aAAa;wBACb,aAAa,EAAE,SAAS;wBACxB,QAAQ,EAAE,2BAA2B,SAAS,oCAAoC,aAAa,OAAO,SAAS,eAAe,aAAa,qBAAqB;qBACjK,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,OAAO,UAAU,EAAE,CAAC;gBACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2DAA2D,EAAE;oBAC5E,aAAa;oBACb,KAAK,EAAE,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;iBAC7E,CAAC,CAAC;YACL,CAAC;YAED,OAAO;gBACL,SAAS;gBACT,MAAM,EAAE,QAAQ;gBAChB,WAAW,EAAE,MAAM,CAAC,cAAc;gBAClC,SAAS,EAAE,UAAU,CAAC,OAAO;gBAC7B,KAAK,EAAE,wBAAwB,CAAC,gBAAgB;gBAChD,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACnC,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAC1B,MAAc,EACd,eAAmC;QAEnC,MAAM,iBAAiB,GAAG,oBAAoB,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,gBAAgB,CAAC,kBAAkB,EAAE,CAAC;YACpE,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,aAAa,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;YAE9E,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE;gBACvC,MAAM;gBACN,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC,CAAC;YAEH,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,CAAC;YACR,SAAS,EAAE,CAAC;YACZ,KAAK,EAAE,wBAAwB,CAAC,eAAe;SAChD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,eAAmC;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,OAAO,GAA2B,EAAE,CAAC;QAE3C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;QAE1D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;YACrD,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YACjC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,OAAO,EAAE,IAAI,CAAC,YAAY;SAC3B,CAAC,CAAC;QAEH,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,mDAAmD;YACnD,IACE,WAAW,CAAC,MAAM,KAAK,iBAAiB;gBACxC,WAAW,CAAC,MAAM,KAAK,YAAY;gBACnC,WAAW,CAAC,MAAM,KAAK,iBAAiB,EACxC,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;gBAC/E,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC;oBACX,SAAS,EAAE,WAAW,CAAC,SAAS;oBAChC,MAAM,EAAE,SAAS;oBACjB,WAAW,EAAE,WAAW,CAAC,cAAc;oBACvC,SAAS,EAAE,WAAW,CAAC,aAAa;iBACrC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;QAC5E,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;QACxE,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;QAE1E,IAAI,MAAiC,CAAC;QACtC,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,GAAG,WAAW,CAAC;QACvB,CAAC;aAAM,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,QAAQ,CAAC;QACpB,CAAC;QAED,MAAM,MAAM,GAAoB;YAC9B,MAAM;YACN,OAAO;YACP,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YACvC,YAAY;YACZ,WAAW;YACX,YAAY;YACZ,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE;YACtC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,YAAY;YACZ,WAAW;YACX,YAAY;YACZ,UAAU,EAAE,MAAM,CAAC,eAAe;SACnC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,IAAI,wBAAwB,GAA4B,IAAI,CAAC;AAE7D,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAC9B,wBAAwB,GAAG,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,wBAAwB,CAAC;AAClC,CAAC"}

package/dist/search/services/opensearch.service.d.ts

@@ -0,0 +1,231 @@
+/**
+ * OpenSearch Service
+ *
+ * Client wrapper for OpenSearch operations with support for multi-index search,
+ * user-specific credential management, and automatic retry with exponential backoff.
+ */
+import { Client as OpenSearchClient } from "@opensearch-project/opensearch";
+import { BaseAwsService } from "../../shared/services/base-aws-service";
+import type { Logger } from "../../shared/services/logger";
+import type { UserAwsCredentials } from "../../shared/services/services.interfaces";
+import type { CreateResult, HealthCheckResult, OpenSearchConfig, OpenSearchResponse, SearchOptions } from "../search.interfaces";
+/**
+ * OpenSearch service for search operations.
+ *
+ * Features:
+ * - Multi-index search support
+ * - AWS IAM authentication via SigV4
+ * - User-specific credential support for governance compliance
+ * - Basic auth for local development
+ * - Automatic retry with exponential backoff
+ * - Connection health checking
+ *
+ * @example Basic search with user credentials
+ * ```typescript
+ * const service = OpenSearchServiceSingleton.getInstance();
+ *
+ * const results = await service.search({
+ *   indices: ['captify-search-documents', 'captify-search-users'],
+ *   query: {
+ *     multi_match: {
+ *       query: 'test search',
+ *       fields: ['title', 'content', 'name']
+ *     }
+ *   },
+ *   size: 10,
+ *   userCredentials,
+ * });
+ * ```
+ */
+export declare class OpenSearchService extends BaseAwsService {
+    private readonly client;
+    private readonly config;
+    private readonly userClients;
+    private cleanupInterval;
+    private constructor();
+    /**
+     * Start periodic cleanup of stale user clients
+     */
+    private startCleanupInterval;
+    /**
+     * Cleanup stale user clients (called periodically)
+     */
+    private cleanupStaleClients;
+    /**
+     * Evict least recently used clients when cache exceeds max size
+     */
+    private evictLruClients;
+    /**
+     * Create OpenSearch client for service account (default client)
+     * Uses AWS SigV4 signing for authentication
+     */
+    private createServiceClient;
+    /**
+     * Create OpenSearch client with user credentials for governance
+     */
+    private createUserClient;
+    /**
+     * Get OpenSearch client for operation
+     * If userCredentials are provided, returns a cached client or creates a new one
+     * Otherwise, returns the default service account client
+     */
+    private getClientForOperation;
+    /**
+     * Create OpenSearch service with configuration
+     */
+    static create(config: Partial<OpenSearchConfig>, logger?: Logger): OpenSearchService;
+    /**
+     * Load configuration from environment variables
+     */
+    static loadEnvConfig(): Partial<OpenSearchConfig>;
+    /**
+     * Execute a search query
+     */
+    search<T = Record<string, unknown>>(options: SearchOptions): Promise<OpenSearchResponse<T>>;
+    /**
+     * Execute a multi-search query
+     */
+    msearch<T = Record<string, unknown>>(searches: Array<{
+        index: string | string[];
+        body: Record<string, unknown>;
+    }>, userCredentials?: UserAwsCredentials): Promise<Array<OpenSearchResponse<T>>>;
+    /**
+     * Check cluster health
+     */
+    healthCheck(userCredentials?: UserAwsCredentials): Promise<HealthCheckResult>;
+    /**
+     * Check if the service is available
+     */
+    isAvailable(userCredentials?: UserAwsCredentials): Promise<boolean>;
+    /**
+     * Bulk index multiple documents in a single API call.
+     * Much more efficient than individual index calls for batch operations.
+     *
+     * @param indexName - The index to write to
+     * @param documents - Array of documents with id and body
+     * @param userCredentials - Optional user credentials for governance
+     * @returns Bulk operation result with success/error counts
+     */
+    bulkIndex(indexName: string, documents: Array<{
+        id: string;
+        body: Record<string, unknown>;
+    }>, userCredentials?: UserAwsCredentials): Promise<{
+        indexed: number;
+        errors: number;
+        errorIds: string[];
+    }>;
+    /**
+     * Get index information
+     */
+    getIndices(pattern?: string, userCredentials?: UserAwsCredentials): Promise<string[]>;
+    /**
+     * Get underlying client for advanced operations
+     */
+    getClient(userCredentials?: UserAwsCredentials): OpenSearchClient;
+    /**
+     * List all indices with details
+     */
+    listIndices(userCredentials?: UserAwsCredentials): Promise<Array<{
+        index: string;
+        health: string;
+        status: string;
+        docsCount: string;
+    }>>;
+    /**
+     * Check if an index exists
+     * @throws SearchError if unable to check index existence (network error, auth error, etc.)
+     */
+    indexExists(indexName: string, userCredentials?: UserAwsCredentials): Promise<boolean>;
+    /**
+     * Create an index with mappings and optional settings
+     */
+    createIndex(indexName: string, mappings: Record<string, unknown>, userCredentials?: UserAwsCredentials, settings?: Record<string, unknown>): Promise<void>;
+    /**
+     * Delete an index
+     * Only allows deletion of captify-managed search indices for safety
+     */
+    deleteIndex(indexName: string, userCredentials?: UserAwsCredentials): Promise<void>;
+    /**
+     * Get index settings including custom metadata
+     */
+    getIndexSettings(indexName: string, userCredentials?: UserAwsCredentials): Promise<Record<string, unknown> | null>;
+    /**
+     * Get index mappings including _meta
+     */
+    getIndexMappings(indexName: string, userCredentials?: UserAwsCredentials): Promise<Record<string, unknown> | null>;
+    /**
+     * Get the schema version of an index from its metadata
+     * Returns null if index doesn't exist or has no version (legacy index)
+     * Version is stored in mappings._meta.schema_version
+     */
+    getIndexVersion(indexName: string, userCredentials?: UserAwsCredentials): Promise<string | null>;
+    /**
+     * Create an index with mappings, settings, and version metadata
+     * Version metadata is stored in mappings._meta (OpenSearch standard for custom metadata)
+     */
+    createIndexWithVersion(indexName: string, mappings: Record<string, unknown>, version: string, userCredentials?: UserAwsCredentials, settings?: Record<string, unknown>): Promise<void>;
+    /**
+     * Create all indices defined in INDEX_DEFINITIONS
+     * Skips indices that already exist, creates new ones with version metadata
+     */
+    createAllIndices(userCredentials?: UserAwsCredentials): Promise<{
+        results: CreateResult[];
+    }>;
+    /**
+     * Reindex documents from source to destination index
+     * Returns the task ID for async monitoring
+     */
+    reindex(sourceIndex: string, destIndex: string, userCredentials?: UserAwsCredentials): Promise<string>;
+    /**
+     * Get reindex task status
+     */
+    getTaskStatus(taskId: string, userCredentials?: UserAwsCredentials): Promise<{
+        completed: boolean;
+        total: number;
+        processed: number;
+        error?: string;
+    }>;
+    /**
+     * Update index aliases (for zero-downtime migration)
+     */
+    updateAlias(aliasName: string, removeIndex: string | null, addIndex: string, userCredentials?: UserAwsCredentials): Promise<void>;
+    /**
+     * Get document count for an index
+     */
+    getDocumentCount(indexName: string, userCredentials?: UserAwsCredentials): Promise<number>;
+    /**
+     * Update documents matching a query using OpenSearch's update_by_query API.
+     * Useful for cascading updates to denormalized data (e.g., session titles in messages).
+     *
+     * @param indexName The index to update documents in
+     * @param query OpenSearch query DSL to match documents
+     * @param script Painless script to apply updates
+     * @param userCredentials Optional user credentials for governance compliance
+     * @returns Number of documents updated
+     * @throws SearchError if the operation fails
+     *
+     * @example
+     * ```typescript
+     * // Update sessionTitle for all messages in a session
+     * const updated = await opensearch.updateByQuery(
+     *   'captify-search-messages',
+     *   { term: { sessionId: 'session-123' } },
+     *   { source: 'ctx._source.sessionTitle = params.title', params: { title: 'New Title' } },
+     *   userCredentials
+     * );
+     * ```
+     */
+    updateByQuery(indexName: string, query: Record<string, unknown>, script: {
+        source: string;
+        params?: Record<string, unknown>;
+    }, userCredentials?: UserAwsCredentials): Promise<number>;
+    /**
+     * Delete an index by name (internal use, bypasses safety check for migration temp indices)
+     */
+    deleteIndexUnsafe(indexName: string, userCredentials?: UserAwsCredentials): Promise<void>;
+    /**
+     * Close the service and all cached user clients
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=opensearch.service.d.ts.map

package/dist/search/services/opensearch.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opensearch.service.d.ts","sourceRoot":"","sources":["../../../lib/search/services/opensearch.service.ts"],"names":[],"mappings":"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"}