captify 0.1.18 → 1.1.0

package/dist/shared/services/dynamodb/types/table-schema.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-schema.types.js","sourceRoot":"","sources":["../../../../../lib/shared/services/dynamodb/types/table-schema.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6FH;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAmC,MAAe;IACjF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/shared/services/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./cloudwatch";
 export * from "./dynamodb";
+export * from "./kendra";
 export * from "./logger";
 export * from "./s3";
 export * from "./services.constants";

package/dist/shared/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/shared/services/index.ts"],"names":[],"mappings":"AAOA,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/shared/services/index.ts"],"names":[],"mappings":"AAOA,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC"}

package/dist/shared/services/index.js

@@ -7,6 +7,7 @@
 // Note: Ontology services in ../../ontology/services
 export * from "./cloudwatch";
 export * from "./dynamodb";
+export * from "./kendra";
 export * from "./logger";
 export * from "./s3";
 export * from "./services.constants";

package/dist/shared/services/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/shared/services/index.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,6CAA6C;AAC7C,uDAAuD;AACvD,qDAAqD;AACrD,8CAA8C;AAC9C,6CAA6C;AAC7C,qDAAqD;AACrD,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/shared/services/index.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,6CAA6C;AAC7C,uDAAuD;AACvD,qDAAqD;AACrD,8CAA8C;AAC9C,6CAA6C;AAC7C,qDAAqD;AACrD,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC"}

package/dist/shared/services/kendra/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./kendra.constants";
+export * from "./kendra.errors";
+export * from "./kendra.interfaces";
+export * from "./kendra.service";
+export * from "./kendra.singleton";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/services/kendra/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../lib/shared/services/kendra/index.ts"],"names":[],"mappings":"AAAA,cAAc,+CAA+C,CAAC;AAC9D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+CAA+C,CAAC"}

package/dist/shared/services/kendra/index.js

@@ -0,0 +1,6 @@
+export * from "./kendra.constants";
+export * from "./kendra.errors";
+export * from "./kendra.interfaces";
+export * from "./kendra.service";
+export * from "./kendra.singleton";
+//# sourceMappingURL=index.js.map

package/dist/shared/services/kendra/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/shared/services/kendra/index.ts"],"names":[],"mappings":"AAAA,cAAc,+CAA+C,CAAC;AAC9D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+CAA+C,CAAC"}

package/dist/shared/services/kendra/kendra.constants.d.ts

@@ -0,0 +1,46 @@
+export declare const KENDRA_ERROR_CODES: {
+    readonly ACCESS_DENIED: "AccessDeniedException";
+    readonly UNAUTHORIZED: "UnauthorizedOperationException";
+    readonly RESOURCE_NOT_FOUND: "ResourceNotFoundException";
+    readonly RESOURCE_UNAVAILABLE: "ResourceUnavailableException";
+    readonly RESOURCE_IN_USE: "ResourceInUseException";
+    readonly VALIDATION_EXCEPTION: "ValidationException";
+    readonly INVALID_REQUEST: "InvalidRequestException";
+    readonly THROTTLING: "ThrottlingException";
+    readonly SERVICE_QUOTA_EXCEEDED: "ServiceQuotaExceededException";
+    readonly INTERNAL_SERVER: "InternalServerException";
+    readonly CONFLICT: "ConflictException";
+};
+export declare const KENDRA_FATAL_ERROR_CODES: readonly ["AccessDeniedException", "UnauthorizedOperationException", "ResourceNotFoundException", "ValidationException", "InvalidRequestException", "ConflictException"];
+export declare const KENDRA_RETRYABLE_ERROR_CODES: readonly ["ThrottlingException", "ServiceQuotaExceededException", "InternalServerException", "ResourceUnavailableException"];
+export declare const KENDRA_ERROR_MESSAGES: {
+    readonly OPERATION_FAILED: "Document search operation failed. Please try again.";
+    readonly INDEX_ID_REQUIRED: "Kendra index ID is required";
+    readonly REGION_REQUIRED: "AWS region is required";
+    readonly QUERY_REQUIRED: "Search query is required";
+    readonly QUERY_TOO_LONG: "Search query exceeds maximum length";
+    readonly INVALID_PAGE_SIZE: "Page size must be between 1 and 100";
+    readonly ACCESS_KEY_ID_REQUIRED: "AWS access key ID is required";
+    readonly SECRET_ACCESS_KEY_REQUIRED: "AWS secret access key is required";
+    readonly ACCESS_DENIED: "Access denied. You don't have permission to search this index.";
+    readonly UNAUTHORIZED: "Unauthorized operation. Please verify your credentials.";
+    readonly RESOURCE_NOT_FOUND: "Search index not found.";
+    readonly RESOURCE_UNAVAILABLE: "Search service is temporarily unavailable. Please try again.";
+    readonly RESOURCE_IN_USE: "Search index is currently being modified. Please try again later.";
+    readonly VALIDATION_EXCEPTION: "Invalid search parameters.";
+    readonly INVALID_REQUEST: "Invalid search request.";
+    readonly THROTTLING: "Too many search requests. Please wait a moment and try again.";
+    readonly SERVICE_QUOTA_EXCEEDED: "Search quota exceeded. Please try again later.";
+    readonly INTERNAL_SERVER: "Search service error. Please try again.";
+    readonly CONFLICT: "Conflicting operation in progress. Please try again.";
+    readonly UNKNOWN_ERROR: "An unexpected search error occurred. Please try again or contact support.";
+};
+export declare const KENDRA_DEFAULTS: {
+    /** Default number of results per page */
+    readonly PAGE_SIZE: 10;
+    /** Maximum results per page */
+    readonly MAX_PAGE_SIZE: 100;
+    /** Maximum query length */
+    readonly MAX_QUERY_LENGTH: 1000;
+};
+//# sourceMappingURL=kendra.constants.d.ts.map

package/dist/shared/services/kendra/kendra.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kendra.constants.d.ts","sourceRoot":"","sources":["../../../../lib/shared/services/kendra/kendra.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;;;;;;;;;;;CAqBrB,CAAC;AAEX,eAAO,MAAM,wBAAwB,0KAO3B,CAAC;AAEX,eAAO,MAAM,4BAA4B,8HAK/B,CAAC;AAEX,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;CAuBxB,CAAC;AAEX,eAAO,MAAM,eAAe;IAC1B,yCAAyC;;IAEzC,+BAA+B;;IAE/B,2BAA2B;;CAEnB,CAAC"}

package/dist/shared/services/kendra/kendra.constants.js

@@ -0,0 +1,64 @@
+export const KENDRA_ERROR_CODES = {
+    // Access errors
+    ACCESS_DENIED: "AccessDeniedException",
+    UNAUTHORIZED: "UnauthorizedOperationException",
+    // Resource errors
+    RESOURCE_NOT_FOUND: "ResourceNotFoundException",
+    RESOURCE_UNAVAILABLE: "ResourceUnavailableException",
+    RESOURCE_IN_USE: "ResourceInUseException",
+    // Validation errors
+    VALIDATION_EXCEPTION: "ValidationException",
+    INVALID_REQUEST: "InvalidRequestException",
+    // Rate limiting errors
+    THROTTLING: "ThrottlingException",
+    SERVICE_QUOTA_EXCEEDED: "ServiceQuotaExceededException",
+    // Service errors
+    INTERNAL_SERVER: "InternalServerException",
+    CONFLICT: "ConflictException",
+};
+export const KENDRA_FATAL_ERROR_CODES = [
+    KENDRA_ERROR_CODES.ACCESS_DENIED,
+    KENDRA_ERROR_CODES.UNAUTHORIZED,
+    KENDRA_ERROR_CODES.RESOURCE_NOT_FOUND,
+    KENDRA_ERROR_CODES.VALIDATION_EXCEPTION,
+    KENDRA_ERROR_CODES.INVALID_REQUEST,
+    KENDRA_ERROR_CODES.CONFLICT,
+];
+export const KENDRA_RETRYABLE_ERROR_CODES = [
+    KENDRA_ERROR_CODES.THROTTLING,
+    KENDRA_ERROR_CODES.SERVICE_QUOTA_EXCEEDED,
+    KENDRA_ERROR_CODES.INTERNAL_SERVER,
+    KENDRA_ERROR_CODES.RESOURCE_UNAVAILABLE,
+];
+export const KENDRA_ERROR_MESSAGES = {
+    OPERATION_FAILED: "Document search operation failed. Please try again.",
+    INDEX_ID_REQUIRED: "Kendra index ID is required",
+    REGION_REQUIRED: "AWS region is required",
+    QUERY_REQUIRED: "Search query is required",
+    QUERY_TOO_LONG: "Search query exceeds maximum length",
+    INVALID_PAGE_SIZE: "Page size must be between 1 and 100",
+    ACCESS_KEY_ID_REQUIRED: "AWS access key ID is required",
+    SECRET_ACCESS_KEY_REQUIRED: "AWS secret access key is required",
+    // User-friendly error messages for AWS Kendra errors
+    ACCESS_DENIED: "Access denied. You don't have permission to search this index.",
+    UNAUTHORIZED: "Unauthorized operation. Please verify your credentials.",
+    RESOURCE_NOT_FOUND: "Search index not found.",
+    RESOURCE_UNAVAILABLE: "Search service is temporarily unavailable. Please try again.",
+    RESOURCE_IN_USE: "Search index is currently being modified. Please try again later.",
+    VALIDATION_EXCEPTION: "Invalid search parameters.",
+    INVALID_REQUEST: "Invalid search request.",
+    THROTTLING: "Too many search requests. Please wait a moment and try again.",
+    SERVICE_QUOTA_EXCEEDED: "Search quota exceeded. Please try again later.",
+    INTERNAL_SERVER: "Search service error. Please try again.",
+    CONFLICT: "Conflicting operation in progress. Please try again.",
+    UNKNOWN_ERROR: "An unexpected search error occurred. Please try again or contact support.",
+};
+export const KENDRA_DEFAULTS = {
+    /** Default number of results per page */
+    PAGE_SIZE: 10,
+    /** Maximum results per page */
+    MAX_PAGE_SIZE: 100,
+    /** Maximum query length */
+    MAX_QUERY_LENGTH: 1000,
+};
+//# sourceMappingURL=kendra.constants.js.map

package/dist/shared/services/kendra/kendra.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kendra.constants.js","sourceRoot":"","sources":["../../../../lib/shared/services/kendra/kendra.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,gBAAgB;IAChB,aAAa,EAAE,uBAAuB;IACtC,YAAY,EAAE,gCAAgC;IAE9C,kBAAkB;IAClB,kBAAkB,EAAE,2BAA2B;IAC/C,oBAAoB,EAAE,8BAA8B;IACpD,eAAe,EAAE,wBAAwB;IAEzC,oBAAoB;IACpB,oBAAoB,EAAE,qBAAqB;IAC3C,eAAe,EAAE,yBAAyB;IAE1C,uBAAuB;IACvB,UAAU,EAAE,qBAAqB;IACjC,sBAAsB,EAAE,+BAA+B;IAEvD,iBAAiB;IACjB,eAAe,EAAE,yBAAyB;IAC1C,QAAQ,EAAE,mBAAmB;CACrB,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,kBAAkB,CAAC,aAAa;IAChC,kBAAkB,CAAC,YAAY;IAC/B,kBAAkB,CAAC,kBAAkB;IACrC,kBAAkB,CAAC,oBAAoB;IACvC,kBAAkB,CAAC,eAAe;IAClC,kBAAkB,CAAC,QAAQ;CACnB,CAAC;AAEX,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,kBAAkB,CAAC,UAAU;IAC7B,kBAAkB,CAAC,sBAAsB;IACzC,kBAAkB,CAAC,eAAe;IAClC,kBAAkB,CAAC,oBAAoB;CAC/B,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,gBAAgB,EAAE,qDAAqD;IACvE,iBAAiB,EAAE,6BAA6B;IAChD,eAAe,EAAE,wBAAwB;IACzC,cAAc,EAAE,0BAA0B;IAC1C,cAAc,EAAE,qCAAqC;IACrD,iBAAiB,EAAE,qCAAqC;IACxD,sBAAsB,EAAE,+BAA+B;IACvD,0BAA0B,EAAE,mCAAmC;IAE/D,qDAAqD;IACrD,aAAa,EAAE,gEAAgE;IAC/E,YAAY,EAAE,yDAAyD;IACvE,kBAAkB,EAAE,yBAAyB;IAC7C,oBAAoB,EAAE,8DAA8D;IACpF,eAAe,EAAE,mEAAmE;IACpF,oBAAoB,EAAE,4BAA4B;IAClD,eAAe,EAAE,yBAAyB;IAC1C,UAAU,EAAE,+DAA+D;IAC3E,sBAAsB,EAAE,gDAAgD;IACxE,eAAe,EAAE,yCAAyC;IAC1D,QAAQ,EAAE,sDAAsD;IAChE,aAAa,EAAE,2EAA2E;CAClF,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,yCAAyC;IACzC,SAAS,EAAE,EAAE;IACb,+BAA+B;IAC/B,aAAa,EAAE,GAAG;IAClB,2BAA2B;IAC3B,gBAAgB,EAAE,IAAI;CACd,CAAC"}

package/dist/shared/services/kendra/kendra.errors.d.ts

@@ -0,0 +1,12 @@
+import { AWS_ERROR_KIND } from "../services.constants";
+import { BaseAwsError } from "../services.errors";
+export declare class KendraError extends BaseAwsError {
+    constructor(message: string, kind: (typeof AWS_ERROR_KIND)[keyof typeof AWS_ERROR_KIND], opts?: {
+        cause?: unknown;
+        code?: string;
+        timestamp?: Date;
+    });
+}
+export declare function classifyKendraError(err: unknown): KendraError;
+export declare function isKendraError(err: unknown): err is KendraError;
+//# sourceMappingURL=kendra.errors.d.ts.map

package/dist/shared/services/kendra/kendra.errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kendra.errors.d.ts","sourceRoot":"","sources":["../../../../lib/shared/services/kendra/kendra.errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAMrE,qBAAa,WAAY,SAAQ,YAAY;gBAEzC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,EAC1D,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB;CAMJ;AAuBD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CAoB7D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAE9D"}

package/dist/shared/services/kendra/kendra.errors.js

@@ -0,0 +1,44 @@
+import { AWS_ERROR_KIND } from "../services.constants";
+import { BaseAwsError } from "../services.errors";
+import { KENDRA_ERROR_MESSAGES, KENDRA_RETRYABLE_ERROR_CODES, } from "./kendra.constants";
+export class KendraError extends BaseAwsError {
+    constructor(message, kind, opts) {
+        super(message, kind, opts);
+        this.name = "KendraError";
+        Object.setPrototypeOf(this, KendraError.prototype);
+    }
+}
+const KENDRA_ERROR_CODE_MAP = {
+    AccessDeniedException: KENDRA_ERROR_MESSAGES.ACCESS_DENIED,
+    UnauthorizedOperationException: KENDRA_ERROR_MESSAGES.UNAUTHORIZED,
+    ResourceNotFoundException: KENDRA_ERROR_MESSAGES.RESOURCE_NOT_FOUND,
+    ResourceUnavailableException: KENDRA_ERROR_MESSAGES.RESOURCE_UNAVAILABLE,
+    ResourceInUseException: KENDRA_ERROR_MESSAGES.RESOURCE_IN_USE,
+    ValidationException: KENDRA_ERROR_MESSAGES.VALIDATION_EXCEPTION,
+    InvalidRequestException: KENDRA_ERROR_MESSAGES.INVALID_REQUEST,
+    ThrottlingException: KENDRA_ERROR_MESSAGES.THROTTLING,
+    ServiceQuotaExceededException: KENDRA_ERROR_MESSAGES.SERVICE_QUOTA_EXCEEDED,
+    InternalServerException: KENDRA_ERROR_MESSAGES.INTERNAL_SERVER,
+    ConflictException: KENDRA_ERROR_MESSAGES.CONFLICT,
+};
+export function classifyKendraError(err) {
+    var _a;
+    const kendraErr = err;
+    const code = (kendraErr === null || kendraErr === void 0 ? void 0 : kendraErr.name) || (kendraErr === null || kendraErr === void 0 ? void 0 : kendraErr.code);
+    // Map error codes to user-friendly messages (never use raw error.message)
+    const message = code
+        ? ((_a = KENDRA_ERROR_CODE_MAP[code]) !== null && _a !== void 0 ? _a : KENDRA_ERROR_MESSAGES.UNKNOWN_ERROR)
+        : KENDRA_ERROR_MESSAGES.UNKNOWN_ERROR;
+    const isRetryable = code &&
+        KENDRA_RETRYABLE_ERROR_CODES.includes(code);
+    const kind = isRetryable ? AWS_ERROR_KIND.TRANSIENT : AWS_ERROR_KIND.FATAL;
+    return new KendraError(message, kind, {
+        cause: err,
+        code,
+        timestamp: new Date(),
+    });
+}
+export function isKendraError(err) {
+    return err instanceof KendraError;
+}
+//# sourceMappingURL=kendra.errors.js.map

package/dist/shared/services/kendra/kendra.errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kendra.errors.js","sourceRoot":"","sources":["../../../../lib/shared/services/kendra/kendra.errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACrE,OAAO,EACL,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,+CAA+C,CAAC;AAEvD,MAAM,OAAO,WAAY,SAAQ,YAAY;IAC3C,YACE,OAAe,EACf,IAA0D,EAC1D,IAIC;QAED,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;CACF;AASD,MAAM,qBAAqB,GAA2B;IACpD,qBAAqB,EAAE,qBAAqB,CAAC,aAAa;IAC1D,8BAA8B,EAAE,qBAAqB,CAAC,YAAY;IAClE,yBAAyB,EAAE,qBAAqB,CAAC,kBAAkB;IACnE,4BAA4B,EAAE,qBAAqB,CAAC,oBAAoB;IACxE,sBAAsB,EAAE,qBAAqB,CAAC,eAAe;IAC7D,mBAAmB,EAAE,qBAAqB,CAAC,oBAAoB;IAC/D,uBAAuB,EAAE,qBAAqB,CAAC,eAAe;IAC9D,mBAAmB,EAAE,qBAAqB,CAAC,UAAU;IACrD,6BAA6B,EAAE,qBAAqB,CAAC,sBAAsB;IAC3E,uBAAuB,EAAE,qBAAqB,CAAC,eAAe;IAC9D,iBAAiB,EAAE,qBAAqB,CAAC,QAAQ;CAClD,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,GAAY;;IAC9C,MAAM,SAAS,GAAG,GAAuB,CAAC;IAE1C,MAAM,IAAI,GAAG,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,IAAI,MAAI,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,IAAI,CAAA,CAAC;IAEhD,0EAA0E;IAC1E,MAAM,OAAO,GAAG,IAAI;QAClB,CAAC,CAAC,CAAC,MAAA,qBAAqB,CAAC,IAAI,CAAC,mCAAI,qBAAqB,CAAC,aAAa,CAAC;QACtE,CAAC,CAAC,qBAAqB,CAAC,aAAa,CAAC;IAExC,MAAM,WAAW,GACf,IAAI;QACJ,4BAA4B,CAAC,QAAQ,CAAC,IAAqD,CAAC,CAAC;IAC/F,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC;IAE3E,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE;QACpC,KAAK,EAAE,GAAG;QACV,IAAI;QACJ,SAAS,EAAE,IAAI,IAAI,EAAE;KACtB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,GAAG,YAAY,WAAW,CAAC;AACpC,CAAC"}

package/dist/shared/services/kendra/kendra.interfaces.d.ts

@@ -0,0 +1,184 @@
+import type { Logger } from "../logger";
+import type { UserAwsCredentials } from "..";
+import type { KendraClient, QueryResultType, ScoreConfidence } from "@aws-sdk/client-kendra";
+export interface KendraConfig {
+    region: string;
+    indexId: string;
+    /**
+     * Admin credentials for service operations
+     * Use when performing operations with service account (not user-specific)
+     */
+    credentials?: {
+        accessKeyId: string;
+        secretAccessKey: string;
+    };
+    endpoint?: string;
+}
+export interface KendraServiceDeps {
+    logger?: Logger;
+    kendraConfig: KendraConfig;
+    client?: KendraClient;
+}
+/**
+ * Parameters for querying documents in Kendra
+ */
+export interface KendraQueryParams {
+    /** The search query text */
+    queryText: string;
+    /** Maximum number of results to return (1-100) */
+    pageSize?: number;
+    /** Token for pagination */
+    pageNumber?: number;
+    /** Optional attribute filter for narrowing results */
+    attributeFilter?: KendraAttributeFilter;
+    /** Optional list of facets to return */
+    facetNames?: string[];
+    /** Optional sorting configuration */
+    sortingConfiguration?: {
+        documentAttributeKey: string;
+        sortOrder: "ASC" | "DESC";
+    };
+    /** User-specific AWS credentials for governance compliance */
+    userCredentials?: UserAwsCredentials;
+}
+/**
+ * Kendra attribute filter for narrowing search results
+ */
+export interface KendraAttributeFilter {
+    /** Filter on equals */
+    equalsTo?: {
+        key: string;
+        value: string | number | string[];
+    };
+    /** Filter on contains */
+    containsAll?: {
+        key: string;
+        value: string[];
+    };
+    /** Filter on contains any */
+    containsAny?: {
+        key: string;
+        value: string[];
+    };
+    /** Filter on greater than */
+    greaterThan?: {
+        key: string;
+        value: number;
+    };
+    /** Filter on less than */
+    lessThan?: {
+        key: string;
+        value: number;
+    };
+    /** Logical AND of filters */
+    andAllFilters?: KendraAttributeFilter[];
+    /** Logical OR of filters */
+    orAllFilters?: KendraAttributeFilter[];
+    /** Logical NOT of filter */
+    notFilter?: KendraAttributeFilter;
+}
+/**
+ * A single document result from Kendra query
+ */
+export interface KendraDocumentResult {
+    /** Unique document ID */
+    id: string;
+    /** Document title */
+    title?: string;
+    /** Document excerpt/snippet with highlights */
+    excerpt?: string;
+    /** Source URI of the document */
+    documentUri?: string;
+    /** Type of result (DOCUMENT, QUESTION_ANSWER, ANSWER) */
+    type?: QueryResultType;
+    /** Confidence score */
+    scoreConfidence?: ScoreConfidence;
+    /** Document attributes */
+    attributes?: Record<string, string | number | string[] | Date>;
+    /** Feedback token for relevance feedback */
+    feedbackToken?: string;
+}
+/**
+ * Facet result from Kendra query
+ */
+export interface KendraFacetResult {
+    /** Facet key */
+    documentAttributeKey?: string;
+    /** Facet values with counts */
+    values?: Array<{
+        value?: string;
+        count?: number;
+    }>;
+}
+/**
+ * Result of a Kendra query operation
+ */
+export interface KendraQueryResult {
+    /** Query ID for feedback */
+    queryId?: string;
+    /** List of document results */
+    documents: KendraDocumentResult[];
+    /** Total number of results */
+    totalNumberOfResults?: number;
+    /** Facet results */
+    facets?: KendraFacetResult[];
+    /** Featured results snippets */
+    featuredResultsItems?: KendraDocumentResult[];
+}
+/**
+ * Parameters for retrieving a specific document
+ */
+export interface KendraRetrieveParams {
+    /** The search query text */
+    queryText: string;
+    /** Maximum number of results to return */
+    pageSize?: number;
+    /** Page number for pagination */
+    pageNumber?: number;
+    /** Optional attribute filter */
+    attributeFilter?: KendraAttributeFilter;
+    /** User-specific AWS credentials for governance compliance */
+    userCredentials?: UserAwsCredentials;
+}
+/**
+ * A retrieved passage from a document
+ */
+export interface KendraRetrievedPassage {
+    /** Document ID */
+    documentId?: string;
+    /** Document title */
+    documentTitle?: string;
+    /** Document URI */
+    documentUri?: string;
+    /** Retrieved passage content */
+    content?: string;
+    /** Document attributes */
+    attributes?: Record<string, string | number | string[] | Date>;
+}
+/**
+ * Result of a retrieve operation
+ */
+export interface KendraRetrieveResult {
+    /** Query ID */
+    queryId?: string;
+    /** Retrieved passages */
+    passages: KendraRetrievedPassage[];
+}
+/**
+ * Parameters for submitting relevance feedback
+ */
+export interface KendraFeedbackParams {
+    /** Query ID from the original query */
+    queryId: string;
+    /** Feedback items for relevant documents */
+    relevantDocuments?: Array<{
+        resultId: string;
+    }>;
+    /** Feedback items for not relevant documents */
+    notRelevantDocuments?: Array<{
+        resultId: string;
+    }>;
+    /** User-specific AWS credentials for governance compliance */
+    userCredentials?: UserAwsCredentials;
+}
+//# sourceMappingURL=kendra.interfaces.d.ts.map

package/dist/shared/services/kendra/kendra.interfaces.d.ts.map

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

package/dist/shared/services/kendra/kendra.interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=kendra.interfaces.js.map

package/dist/shared/services/kendra/kendra.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kendra.interfaces.js","sourceRoot":"","sources":["../../../../lib/shared/services/kendra/kendra.interfaces.ts"],"names":[],"mappings":""}

package/dist/shared/services/kendra/kendra.service.d.ts

@@ -0,0 +1,143 @@
+import type { KendraConfig, KendraQueryParams, KendraQueryResult, KendraRetrieveParams, KendraRetrieveResult, KendraFeedbackParams } from "./kendra.interfaces";
+import type { BaseAwsError } from "../services.errors";
+import type { Logger } from "../logger";
+import { BaseAwsService } from "../base-aws-service";
+import { KendraClient } from "@aws-sdk/client-kendra";
+/**
+ * Kendra service for document search and retrieval.
+ *
+ * Features:
+ * - Full-text search with natural language queries
+ * - Document retrieval with passage extraction
+ * - Faceted search support
+ * - Relevance feedback for improving search results
+ * - Automatic retry with exponential backoff for transient errors
+ * - User credentials support for governance compliance
+ *
+ * @example Basic search
+ * ```typescript
+ * const service = KendraService.create({
+ *   region: 'us-east-1',
+ *   indexId: 'your-kendra-index-id',
+ *   credentials: {
+ *     accessKeyId: 'YOUR_ACCESS_KEY',
+ *     secretAccessKey: 'YOUR_SECRET_KEY'
+ *   }
+ * });
+ *
+ * const results = await service.query({
+ *   queryText: 'How do I configure authentication?',
+ *   pageSize: 10
+ * });
+ * ```
+ *
+ * @example Search with filters
+ * ```typescript
+ * const results = await service.query({
+ *   queryText: 'security best practices',
+ *   attributeFilter: {
+ *     equalsTo: { key: '_category', value: 'documentation' }
+ *   },
+ *   pageSize: 20
+ * });
+ * ```
+ */
+export declare class KendraService extends BaseAwsService {
+    private readonly client;
+    private readonly indexId;
+    private readonly config;
+    /** Cache for user-specific clients, keyed by credential fingerprint */
+    private readonly clientCache;
+    private cleanupTimer;
+    private constructor();
+    protected classifyError(err: unknown): BaseAwsError;
+    /**
+     * Generate a stable fingerprint for credential caching
+     */
+    private getCredentialFingerprint;
+    /**
+     * Start periodic cleanup of expired cached clients
+     */
+    private startCleanupTimer;
+    /**
+     * Clean up expired clients from the cache
+     */
+    private cleanupExpiredClients;
+    /**
+     * Evict least recently used clients when cache is full
+     */
+    private evictLRUClients;
+    /**
+     * Get Kendra client with user-specific credentials for governance compliance
+     * If userCredentials are provided, returns a cached client or creates a new one
+     * Otherwise, returns the default service account client
+     */
+    private getClientForOperation;
+    /**
+     * Creates a new Kendra service instance with the provided configuration.
+     *
+     * @param config - Configuration object for Kendra connection
+     * @param config.region - AWS region (e.g., 'us-east-1')
+     * @param config.indexId - Kendra index ID
+     * @param config.credentials - Optional AWS credentials
+     * @param config.endpoint - Optional custom endpoint
+     * @param logger - Optional logger instance
+     * @returns A new KendraService instance
+     */
+    static create(config: Partial<KendraConfig>, logger?: Logger): KendraService;
+    /**
+     * Load configuration from environment variables
+     */
+    static loadEnvConfig(): Partial<KendraConfig>;
+    /**
+     * Create service with an existing client
+     * @param client - Configured KendraClient instance
+     * @param indexId - Kendra index ID
+     * @param region - AWS region (required since client.config.region is async)
+     * @param logger - Optional logger instance
+     */
+    static createWithClient(client: KendraClient, indexId: string, region: string, logger?: Logger): KendraService;
+    /**
+     * Convert internal attribute filter to AWS SDK format
+     */
+    private buildAttributeFilter;
+    /**
+     * Parse a query result item to our interface
+     */
+    private parseQueryResultItem;
+    /**
+     * Parse a retrieve result item to our interface
+     */
+    private parseRetrieveResultItem;
+    /**
+     * Query documents in the Kendra index using natural language.
+     *
+     * @param params - Query parameters
+     * @returns Query results with documents and facets
+     */
+    query(params: KendraQueryParams): Promise<KendraQueryResult>;
+    /**
+     * Retrieve relevant passages from documents.
+     * This is optimized for RAG (Retrieval Augmented Generation) use cases.
+     *
+     * @param params - Retrieve parameters
+     * @returns Retrieved passages
+     */
+    retrieve(params: KendraRetrieveParams): Promise<KendraRetrieveResult>;
+    /**
+     * Submit relevance feedback to improve search results.
+     *
+     * @param params - Feedback parameters
+     */
+    submitFeedback(params: KendraFeedbackParams): Promise<void>;
+    /**
+     * Get the index ID this service is configured for
+     */
+    getIndexId(): string;
+    protected onMetric(name: string, dims: Record<string, unknown>): void;
+    /**
+     * Cleanup and destroy the Kendra client and all cached clients
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=kendra.service.d.ts.map

package/dist/shared/services/kendra/kendra.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kendra.service.d.ts","sourceRoot":"","sources":["../../../../lib/shared/services/kendra/kendra.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEZ,iBAAiB,EACjB,iBAAiB,EAGjB,oBAAoB,EACpB,oBAAoB,EAEpB,oBAAoB,EAErB,MAAM,gDAAgD,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAExE,OAAO,EACL,YAAY,EAOb,MAAM,wBAAwB,CAAC;AAwBhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IAEtC,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmC;IAC/D,OAAO,CAAC,YAAY,CAA+C;IAEnE,OAAO;IAUP,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY;IAInD;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAQhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAuB7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA4C7B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM;IA+B5D;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;IAgB7C;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAY9F;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkE5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA4B/B;;;;;OAKG;IACG,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiFlE;;;;;;OAMG;IACG,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAkD3E;;;;OAIG;IACG,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCjE;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIrE;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA2B/B"}