@capsara/sdk 1.0.1

package/dist/errors/audit-error.js.map

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

package/dist/errors/auth-error.d.ts

@@ -0,0 +1,38 @@
+/** Errors from authentication operations (login, register, refresh). */
+import { CapsaraError, type ApiErrorResponse, type AxiosLikeError } from './capsara-error.js';
+export declare class CapsaraAuthError extends CapsaraError {
+    constructor(message: string, code: string, statusCode: number, details?: Record<string, unknown>, response?: ApiErrorResponse);
+    /**
+     * Refresh token is required but not provided
+     * HTTP 401 - REFRESH_TOKEN_REQUIRED
+     */
+    static refreshTokenRequired(): CapsaraAuthError;
+    /**
+     * Invalid credentials (email/password don't match)
+     * HTTP 401 - INVALID_CREDENTIALS
+     */
+    static invalidCredentials(): CapsaraAuthError;
+    /**
+     * Refresh token is invalid or expired
+     * HTTP 401 - INVALID_REFRESH_TOKEN
+     */
+    static invalidRefreshToken(): CapsaraAuthError;
+    /**
+     * Access token is invalid or expired
+     * HTTP 401 - UNAUTHORIZED
+     */
+    static unauthorized(message?: string): CapsaraAuthError;
+    /**
+     * Feature not implemented yet
+     * HTTP 405 - NOT_IMPLEMENTED
+     */
+    static notImplemented(feature: string): CapsaraAuthError;
+    /**
+     * Invalid request body
+     * HTTP 400 - VALIDATION_ERROR
+     */
+    static validationError(message: string, details?: Record<string, unknown>): CapsaraAuthError;
+    /** Maps an API error response to the appropriate factory method. */
+    static fromApiError(error: AxiosLikeError): CapsaraAuthError;
+}
+//# sourceMappingURL=auth-error.d.ts.map

package/dist/errors/auth-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-error.d.ts","sourceRoot":"","sources":["../../src/errors/auth-error.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE9F,qBAAa,gBAAiB,SAAQ,YAAY;gBAE9C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,CAAC,EAAE,gBAAgB;IAM7B;;;OAGG;IACH,MAAM,CAAC,oBAAoB,IAAI,gBAAgB;IAQ/C;;;OAGG;IACH,MAAM,CAAC,kBAAkB,IAAI,gBAAgB;IAQ7C;;;OAGG;IACH,MAAM,CAAC,mBAAmB,IAAI,gBAAgB;IAQ9C;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,SAAmD,GAAG,gBAAgB;IAQjG;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB;IASxD;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;IAS5F,oEAAoE;IACpE,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB;CAsD7D"}

package/dist/errors/auth-error.js

@@ -0,0 +1,87 @@
+/** Errors from authentication operations (login, register, refresh). */
+import { CapsaraError } from './capsara-error.js';
+export class CapsaraAuthError extends CapsaraError {
+    constructor(message, code, statusCode, details, response) {
+        super(message, code, statusCode, details, response);
+        this.name = 'CapsaraAuthError';
+    }
+    /**
+     * Refresh token is required but not provided
+     * HTTP 401 - REFRESH_TOKEN_REQUIRED
+     */
+    static refreshTokenRequired() {
+        return new CapsaraAuthError('Refresh token is required', 'REFRESH_TOKEN_REQUIRED', 401);
+    }
+    /**
+     * Invalid credentials (email/password don't match)
+     * HTTP 401 - INVALID_CREDENTIALS
+     */
+    static invalidCredentials() {
+        return new CapsaraAuthError('Invalid email or password', 'INVALID_CREDENTIALS', 401);
+    }
+    /**
+     * Refresh token is invalid or expired
+     * HTTP 401 - INVALID_REFRESH_TOKEN
+     */
+    static invalidRefreshToken() {
+        return new CapsaraAuthError('Refresh token is invalid or expired', 'INVALID_REFRESH_TOKEN', 401);
+    }
+    /**
+     * Access token is invalid or expired
+     * HTTP 401 - UNAUTHORIZED
+     */
+    static unauthorized(message = 'Unauthorized - invalid or expired access token') {
+        return new CapsaraAuthError(message, 'UNAUTHORIZED', 401);
+    }
+    /**
+     * Feature not implemented yet
+     * HTTP 405 - NOT_IMPLEMENTED
+     */
+    static notImplemented(feature) {
+        return new CapsaraAuthError(`${feature} endpoint not yet implemented`, 'NOT_IMPLEMENTED', 405, { feature });
+    }
+    /**
+     * Invalid request body
+     * HTTP 400 - VALIDATION_ERROR
+     */
+    static validationError(message, details) {
+        return new CapsaraAuthError(message, 'VALIDATION_ERROR', 400, details);
+    }
+    /** Maps an API error response to the appropriate factory method. */
+    static fromApiError(error) {
+        // Handle axios errors
+        if (error.response) {
+            const status = error.response.status;
+            const data = error.response.data;
+            const errorCode = data?.error?.code;
+            const errorMessage = data?.error?.message ?? data?.message ?? error.message ?? 'Unknown error';
+            const errorDetails = data?.error?.details ?? data?.details;
+            // Map known error codes to factory methods
+            switch (errorCode) {
+                case 'REFRESH_TOKEN_REQUIRED':
+                    return CapsaraAuthError.refreshTokenRequired();
+                case 'INVALID_CREDENTIALS':
+                    return CapsaraAuthError.invalidCredentials();
+                case 'INVALID_REFRESH_TOKEN':
+                    return CapsaraAuthError.invalidRefreshToken();
+                case 'UNAUTHORIZED':
+                    return CapsaraAuthError.unauthorized(errorMessage);
+                case 'NOT_IMPLEMENTED':
+                    return CapsaraAuthError.notImplemented(errorDetails?.feature ?? 'Feature');
+                case 'VALIDATION_ERROR':
+                    return CapsaraAuthError.validationError(errorMessage, errorDetails);
+                default:
+                    // Generic auth error with status code
+                    return new CapsaraAuthError(errorMessage, errorCode ?? 'AUTH_ERROR', status, errorDetails);
+            }
+        }
+        // Handle non-axios errors
+        if (error instanceof CapsaraAuthError) {
+            return error;
+        }
+        // Generic error fallback
+        const errorMessage = error.message ?? 'Unknown authentication error';
+        return new CapsaraAuthError(errorMessage, 'AUTH_ERROR', 500, { originalError: errorMessage });
+    }
+}
+//# sourceMappingURL=auth-error.js.map

package/dist/errors/auth-error.js.map

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

package/dist/errors/capsa-error.d.ts

@@ -0,0 +1,64 @@
+/** Errors from capsa operations (create, get, delete, file operations). */
+import { CapsaraError, type ApiErrorResponse, type AxiosLikeError, type StoredErrorResponse } from './capsara-error.js';
+export declare class CapsaraCapsaError extends CapsaraError {
+    readonly response?: StoredErrorResponse;
+    constructor(message: string, code: string, statusCode: number, details?: Record<string, unknown>, response?: ApiErrorResponse);
+    /**
+     * Capsa not found or access denied
+     * HTTP 404 - CAPSA_NOT_FOUND
+     */
+    static capsaNotFound(capsaId?: string): CapsaraCapsaError;
+    /**
+     * File not found in capsa
+     * HTTP 404 - FILE_NOT_FOUND
+     */
+    static fileNotFound(fileId?: string): CapsaraCapsaError;
+    /**
+     * Access denied to capsa
+     * HTTP 403 - ACCESS_DENIED
+     */
+    static accessDenied(details?: Record<string, unknown>): CapsaraCapsaError;
+    /**
+     * Creator mismatch - authenticated party doesn't match creator in metadata
+     * HTTP 403 - CREATOR_MISMATCH
+     */
+    static creatorMismatch(authenticated: string, claimed: string): CapsaraCapsaError;
+    /**
+     * Capsa is deleted and cannot be accessed
+     * HTTP 403 - CAPSA_DELETED
+     */
+    static capsaDeleted(details?: Record<string, unknown>): CapsaraCapsaError;
+    /**
+     * Invalid content type - must be multipart/form-data
+     * HTTP 400 - INVALID_CONTENT_TYPE
+     */
+    static invalidContentType(): CapsaraCapsaError;
+    /**
+     * Missing required parameters
+     * HTTP 400 - MISSING_PARAMS
+     */
+    static missingParams(params?: string[]): CapsaraCapsaError;
+    /**
+     * Missing capsa ID
+     * HTTP 400 - MISSING_ID
+     */
+    static missingId(): CapsaraCapsaError;
+    /**
+     * Invalid expiration time for download URL
+     * HTTP 400 - INVALID_EXPIRATION
+     */
+    static invalidExpiration(): CapsaraCapsaError;
+    /**
+     * Multipart upload error (file size, count, etc.)
+     * HTTP 400/413 - MULTIPART_ERROR
+     */
+    static multipartError(message: string, statusCode?: number, details?: Record<string, unknown>): CapsaraCapsaError;
+    /**
+     * File download failed with context
+     * Used to wrap errors with capsaId and fileId context
+     */
+    static downloadFailed(capsaId: string, fileId: string, cause: unknown): CapsaraCapsaError;
+    /** Maps an API error response to the appropriate factory method. */
+    static fromApiError(error: AxiosLikeError): CapsaraCapsaError;
+}
+//# sourceMappingURL=capsa-error.d.ts.map

package/dist/errors/capsa-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capsa-error.d.ts","sourceRoot":"","sources":["../../src/errors/capsa-error.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAExH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,SAAwB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;gBAGrD,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,CAAC,EAAE,gBAAgB;IAM7B;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAWzD;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB;IASvD;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB;IASzE;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB;IASjF;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB;IASzE;;;OAGG;IACH,MAAM,CAAC,kBAAkB,IAAI,iBAAiB;IAQ9C;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,iBAAiB;IAW1D;;;OAGG;IACH,MAAM,CAAC,SAAS,IAAI,iBAAiB;IAQrC;;;OAGG;IACH,MAAM,CAAC,iBAAiB,IAAI,iBAAiB;IAQ7C;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,SAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB;IAS9G;;;OAGG;IACH,MAAM,CAAC,cAAc,CACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,iBAAiB;IAepB,oEAAoE;IACpE,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB;CAgG9D"}

package/dist/errors/capsa-error.js

@@ -0,0 +1,172 @@
+/** Errors from capsa operations (create, get, delete, file operations). */
+import { CapsaraError } from './capsara-error.js';
+export class CapsaraCapsaError extends CapsaraError {
+    constructor(message, code, statusCode, details, response) {
+        super(message, code, statusCode, details, response);
+        this.name = 'CapsaraCapsaError';
+    }
+    /**
+     * Capsa not found or access denied
+     * HTTP 404 - CAPSA_NOT_FOUND
+     */
+    static capsaNotFound(capsaId) {
+        return new CapsaraCapsaError(capsaId
+            ? `Capsa with ID ${capsaId} not found or access denied`
+            : 'Capsa not found or access denied', 'CAPSA_NOT_FOUND', 404, capsaId ? { capsaId } : undefined);
+    }
+    /**
+     * File not found in capsa
+     * HTTP 404 - FILE_NOT_FOUND
+     */
+    static fileNotFound(fileId) {
+        return new CapsaraCapsaError('File not found in capsa', 'FILE_NOT_FOUND', 404, fileId ? { fileId } : undefined);
+    }
+    /**
+     * Access denied to capsa
+     * HTTP 403 - ACCESS_DENIED
+     */
+    static accessDenied(details) {
+        return new CapsaraCapsaError('You do not have access to this capsa', 'ACCESS_DENIED', 403, details);
+    }
+    /**
+     * Creator mismatch - authenticated party doesn't match creator in metadata
+     * HTTP 403 - CREATOR_MISMATCH
+     */
+    static creatorMismatch(authenticated, claimed) {
+        return new CapsaraCapsaError('Authenticated party does not match creator in metadata', 'CREATOR_MISMATCH', 403, { authenticated, claimed });
+    }
+    /**
+     * Capsa is deleted and cannot be accessed
+     * HTTP 403 - CAPSA_DELETED
+     */
+    static capsaDeleted(details) {
+        return new CapsaraCapsaError('Cannot download files from deleted capsa', 'CAPSA_DELETED', 403, details);
+    }
+    /**
+     * Invalid content type - must be multipart/form-data
+     * HTTP 400 - INVALID_CONTENT_TYPE
+     */
+    static invalidContentType() {
+        return new CapsaraCapsaError('Request must be multipart/form-data with metadata and capsa_0..N fields', 'INVALID_CONTENT_TYPE', 400);
+    }
+    /**
+     * Missing required parameters
+     * HTTP 400 - MISSING_PARAMS
+     */
+    static missingParams(params) {
+        return new CapsaraCapsaError(params
+            ? `Missing required parameters: ${params.join(', ')}`
+            : 'Missing required parameters', 'MISSING_PARAMS', 400, params ? { missingParams: params } : undefined);
+    }
+    /**
+     * Missing capsa ID
+     * HTTP 400 - MISSING_ID
+     */
+    static missingId() {
+        return new CapsaraCapsaError('Capsa ID is required', 'MISSING_ID', 400);
+    }
+    /**
+     * Invalid expiration time for download URL
+     * HTTP 400 - INVALID_EXPIRATION
+     */
+    static invalidExpiration() {
+        return new CapsaraCapsaError('URL expiration must be between 1 and 1440 minutes (24 hours)', 'INVALID_EXPIRATION', 400);
+    }
+    /**
+     * Multipart upload error (file size, count, etc.)
+     * HTTP 400/413 - MULTIPART_ERROR
+     */
+    static multipartError(message, statusCode = 400, details) {
+        return new CapsaraCapsaError(message, 'MULTIPART_ERROR', statusCode, details);
+    }
+    /**
+     * File download failed with context
+     * Used to wrap errors with capsaId and fileId context
+     */
+    static downloadFailed(capsaId, fileId, cause) {
+        const causeMessage = cause instanceof Error ? cause.message : String(cause);
+        const error = new CapsaraCapsaError(`Failed to download file ${fileId} from capsa ${capsaId}: ${causeMessage}`, 'DOWNLOAD_FAILED', 0, // Status 0 indicates client-side error
+        { capsaId, fileId, originalError: causeMessage });
+        // Preserve the original error as cause for stack trace
+        if (cause instanceof Error) {
+            error.cause = cause;
+        }
+        return error;
+    }
+    /** Maps an API error response to the appropriate factory method. */
+    static fromApiError(error) {
+        // Handle axios errors
+        if (error.response) {
+            const status = error.response.status;
+            const data = error.response.data;
+            const errorCode = data?.error?.code;
+            const errorMessage = data?.error?.message ?? data?.message ?? error.message ?? 'Unknown error';
+            const errorDetails = data?.error?.details ?? data?.details;
+            const response = error.response;
+            // Map known error codes to factory methods and attach response
+            let capsaError;
+            switch (errorCode) {
+                // Support both old ENVELOPE_* and new CAPSA_* error codes from API
+                case 'ENVELOPE_NOT_FOUND':
+                case 'CAPSA_NOT_FOUND':
+                    capsaError = CapsaraCapsaError.capsaNotFound((errorDetails?.capsaId ?? errorDetails?.envelopeId));
+                    break;
+                case 'FILE_NOT_FOUND':
+                    capsaError = CapsaraCapsaError.fileNotFound(errorDetails?.fileId);
+                    break;
+                case 'ACCESS_DENIED':
+                    capsaError = CapsaraCapsaError.accessDenied(errorDetails);
+                    break;
+                case 'CREATOR_MISMATCH':
+                    capsaError = CapsaraCapsaError.creatorMismatch(errorDetails?.authenticated ?? '', errorDetails?.claimed ?? '');
+                    break;
+                case 'ENVELOPE_DELETED':
+                case 'CAPSA_DELETED':
+                    capsaError = CapsaraCapsaError.capsaDeleted(errorDetails);
+                    break;
+                case 'INVALID_CONTENT_TYPE':
+                    capsaError = CapsaraCapsaError.invalidContentType();
+                    break;
+                case 'MISSING_PARAMS':
+                    capsaError = CapsaraCapsaError.missingParams(errorDetails?.missingParams);
+                    break;
+                case 'MISSING_ID':
+                    capsaError = CapsaraCapsaError.missingId();
+                    break;
+                case 'INVALID_EXPIRATION':
+                    capsaError = CapsaraCapsaError.invalidExpiration();
+                    break;
+                case 'MULTIPART_ERROR':
+                    capsaError = CapsaraCapsaError.multipartError(errorMessage, status, errorDetails);
+                    break;
+                default:
+                    // Generic capsa error with status code
+                    return new CapsaraCapsaError(errorMessage, errorCode ?? 'CAPSA_ERROR', status, errorDetails, response);
+            }
+            // Attach response to error created by factory method
+            if (response) {
+                Object.defineProperty(capsaError, 'response', {
+                    value: {
+                        status: response.status,
+                        statusText: response.statusText,
+                        headers: response.headers,
+                        data: response.data,
+                    },
+                    writable: false,
+                    enumerable: true,
+                    configurable: true,
+                });
+            }
+            return capsaError;
+        }
+        // Handle non-axios errors
+        if (error instanceof CapsaraCapsaError) {
+            return error;
+        }
+        // Generic error fallback (client-side errors, not API errors)
+        // Use status code 0 to distinguish from actual HTTP 500 errors
+        const errorMessage = error.message ?? 'Unknown capsa error';
+        return new CapsaraCapsaError(errorMessage, 'CAPSA_ERROR', 0, { originalError: errorMessage });
+    }
+}
+//# sourceMappingURL=capsa-error.js.map

package/dist/errors/capsa-error.js.map

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

package/dist/errors/capsara-error.d.ts

@@ -0,0 +1,52 @@
+/** API error response structure from Axios. */
+export interface ApiErrorResponse {
+    status: number;
+    statusText?: string;
+    headers?: Record<string, string>;
+    data?: {
+        error?: {
+            code?: string;
+            message?: string;
+            details?: Record<string, unknown>;
+        };
+        message?: string;
+        details?: Record<string, unknown>;
+    };
+}
+/** Axios-like error structure. */
+export interface AxiosLikeError {
+    response?: ApiErrorResponse;
+    request?: unknown;
+    message?: string;
+}
+/** Stored response for debugging (subset of ApiErrorResponse). */
+export interface StoredErrorResponse {
+    status: number;
+    statusText?: string;
+    headers?: Record<string, string>;
+    data?: unknown;
+}
+/** Base error class for all Capsara SDK errors. */
+export declare class CapsaraError extends Error {
+    /** Error code from API response */
+    readonly code: string;
+    /** HTTP status code */
+    readonly statusCode: number;
+    /** Additional error details */
+    readonly details?: Record<string, unknown>;
+    /** Full server response (for debugging) */
+    readonly response?: StoredErrorResponse;
+    constructor(message: string, code: string, statusCode: number, details?: Record<string, unknown>, response?: ApiErrorResponse);
+    /** Maps an API error response to a CapsaraError. */
+    static fromApiError(error: AxiosLikeError): CapsaraError;
+    /** Converts this error to a JSON-serializable object. */
+    toJSON(): {
+        response?: StoredErrorResponse | undefined;
+        name: string;
+        message: string;
+        code: string;
+        statusCode: number;
+        details: Record<string, unknown> | undefined;
+    };
+}
+//# sourceMappingURL=capsara-error.d.ts.map

package/dist/errors/capsara-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capsara-error.d.ts","sourceRoot":"","sources":["../../src/errors/capsara-error.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE;YACN,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACnC,CAAC;QACF,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH;AAED,kCAAkC;AAClC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,kEAAkE;AAClE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,mDAAmD;AACnD,qBAAa,YAAa,SAAQ,KAAK;IACrC,mCAAmC;IACnC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,uBAAuB;IACvB,SAAgB,UAAU,EAAE,MAAM,CAAC;IAEnC,+BAA+B;IAC/B,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElD,2CAA2C;IAC3C,SAAgB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;gBAG7C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,CAAC,EAAE,gBAAgB;IAgD7B,oDAAoD;IACpD,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY;IAqCxD,yDAAyD;IACzD,MAAM;;;;;;;;CAUP"}

package/dist/errors/capsara-error.js

@@ -0,0 +1,83 @@
+/** Base error class for all Capsara SDK errors. */
+export class CapsaraError extends Error {
+    /** Error code from API response */
+    code;
+    /** HTTP status code */
+    statusCode;
+    /** Additional error details */
+    details;
+    /** Full server response (for debugging) */
+    response;
+    constructor(message, code, statusCode, details, response) {
+        super(message);
+        this.name = 'CapsaraError';
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+        // Store sanitized response for debugging (filter sensitive headers, truncate data)
+        if (response) {
+            const SAFE_HEADERS = ['content-type', 'x-request-id', 'retry-after'];
+            let filteredHeaders;
+            if (response.headers) {
+                filteredHeaders = {};
+                for (const key of Object.keys(response.headers)) {
+                    if (SAFE_HEADERS.includes(key.toLowerCase())) {
+                        filteredHeaders[key] = response.headers[key];
+                    }
+                }
+            }
+            // Truncate response data to prevent unbounded memory from large error bodies
+            const MAX_DATA_SIZE = 1024;
+            let truncatedData = response.data;
+            if (response.data) {
+                const serialized = JSON.stringify(response.data);
+                if (serialized.length > MAX_DATA_SIZE) {
+                    truncatedData = serialized.slice(0, MAX_DATA_SIZE) + '...[truncated]';
+                }
+            }
+            this.response = {
+                status: response.status,
+                statusText: response.statusText,
+                headers: filteredHeaders,
+                data: truncatedData,
+            };
+        }
+        // Maintains proper stack trace for where error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        // Set the prototype explicitly to support instanceof checks
+        Object.setPrototypeOf(this, CapsaraError.prototype);
+    }
+    /** Maps an API error response to a CapsaraError. */
+    static fromApiError(error) {
+        // Handle axios error structure
+        if (error.response) {
+            const { data, status } = error.response;
+            const errorCode = data?.error?.code ?? 'UNKNOWN_ERROR';
+            const errorMessage = data?.error?.message ?? error.message ?? 'An unknown error occurred';
+            const errorDetails = data?.error?.details;
+            return new CapsaraError(errorMessage, errorCode, status, errorDetails, error.response // Pass full response for debugging
+            );
+        }
+        // Handle network errors or other errors
+        if (error.request) {
+            return new CapsaraError('Network error: Unable to reach the API', 'NETWORK_ERROR', 0, { originalError: error.message ?? 'Unknown network error' });
+        }
+        // Generic error
+        const errorMessage = error.message ?? 'An error occurred';
+        return new CapsaraError(errorMessage, 'UNKNOWN_ERROR', 500, { originalError: errorMessage });
+    }
+    /** Converts this error to a JSON-serializable object. */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            statusCode: this.statusCode,
+            details: this.details,
+            ...(this.response && { response: this.response }),
+        };
+    }
+}
+//# sourceMappingURL=capsara-error.js.map

package/dist/errors/capsara-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capsara-error.js","sourceRoot":"","sources":["../../src/errors/capsara-error.ts"],"names":[],"mappings":"AA+BA,mDAAmD;AACnD,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,mCAAmC;IACnB,IAAI,CAAS;IAE7B,uBAAuB;IACP,UAAU,CAAS;IAEnC,+BAA+B;IACf,OAAO,CAA2B;IAElD,2CAA2C;IAC3B,QAAQ,CAAuB;IAE/C,YACE,OAAe,EACf,IAAY,EACZ,UAAkB,EAClB,OAAiC,EACjC,QAA2B;QAE3B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,mFAAmF;QACnF,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,CAAC,cAAc,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;YACrE,IAAI,eAAmD,CAAC;YACxD,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,eAAe,GAAG,EAAE,CAAC;gBACrB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBAChD,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;wBAC7C,eAAe,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAE,CAAC;oBAChD,CAAC;gBACH,CAAC;YACH,CAAC;YAED,6EAA6E;YAC7E,MAAM,aAAa,GAAG,IAAI,CAAC;YAC3B,IAAI,aAAa,GAAY,QAAQ,CAAC,IAAI,CAAC;YAC3C,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAClB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACjD,IAAI,UAAU,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;oBACtC,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,GAAG,gBAAgB,CAAC;gBACxE,CAAC;YACH,CAAC;YAED,IAAI,CAAC,QAAQ,GAAG;gBACd,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,OAAO,EAAE,eAAe;gBACxB,IAAI,EAAE,aAAa;aACpB,CAAC;QACJ,CAAC;QAED,iFAAiF;QACjF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;QAED,4DAA4D;QAC5D,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;IAED,oDAAoD;IACpD,MAAM,CAAC,YAAY,CAAC,KAAqB;QACvC,+BAA+B;QAC/B,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;YACxC,MAAM,SAAS,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,eAAe,CAAC;YACvD,MAAM,YAAY,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,OAAO,IAAI,2BAA2B,CAAC;YAC1F,MAAM,YAAY,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC;YAE1C,OAAO,IAAI,YAAY,CACrB,YAAY,EACZ,SAAS,EACT,MAAM,EACN,YAAY,EACZ,KAAK,CAAC,QAAQ,CAAC,mCAAmC;aACnD,CAAC;QACJ,CAAC;QAED,wCAAwC;QACxC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,IAAI,YAAY,CACrB,wCAAwC,EACxC,eAAe,EACf,CAAC,EACD,EAAE,aAAa,EAAE,KAAK,CAAC,OAAO,IAAI,uBAAuB,EAAE,CAC5D,CAAC;QACJ,CAAC;QAED,gBAAgB;QAChB,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,IAAI,mBAAmB,CAAC;QAC1D,OAAO,IAAI,YAAY,CACrB,YAAY,EACZ,eAAe,EACf,GAAG,EACH,EAAE,aAAa,EAAE,YAAY,EAAE,CAChC,CAAC;IACJ,CAAC;IAED,yDAAyD;IACzD,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;SAClD,CAAC;IACJ,CAAC;CACF"}

package/dist/errors/index.d.ts

@@ -0,0 +1,8 @@
+/** Re-exports all SDK error classes and types. */
+export { CapsaraError } from './capsara-error.js';
+export { CapsaraAuditError } from './audit-error.js';
+export { CapsaraCapsaError } from './capsa-error.js';
+export { CapsaraAuthError } from './auth-error.js';
+export { CapsaraAccountError } from './account-error.js';
+export type { ApiErrorResponse, AxiosLikeError, StoredErrorResponse } from './capsara-error.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,7 @@
+/** Re-exports all SDK error classes and types. */
+export { CapsaraError } from './capsara-error.js';
+export { CapsaraAuditError } from './audit-error.js';
+export { CapsaraCapsaError } from './capsa-error.js';
+export { CapsaraAuthError } from './auth-error.js';
+export { CapsaraAccountError } from './account-error.js';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/** Capsara SDK entry point. */
+export { CapsaraClient, type CapsaraClientOptions } from './client/capsara-client.js';
+export { type DecryptedCapsa } from './internal/decryptor/capsa-decryptor.js';
+export { CapsaraError, CapsaraAuditError, CapsaraCapsaError, CapsaraAuthError, CapsaraAccountError, } from './errors/index.js';
+export { FileInput } from './types/index.js';
+export type { PartyKey, Capsa, RecipientConfig, SystemLimits, AuthCredentials, AuthResponse, CapsaListFilters, CapsaListResponse, CapsaSummary, CursorPagination, AuditEntry, AuditAction, GetAuditEntriesFilters, GetAuditEntriesResponse, CreateAuditEntryRequest, CreateAuditEntryResponse, } from './types/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEtF,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAE9E,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,YAAY,EACV,QAAQ,EACR,KAAK,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+/** Capsara SDK entry point. */
+export { CapsaraClient } from './client/capsara-client.js';
+export { CapsaraError, CapsaraAuditError, CapsaraCapsaError, CapsaraAuthError, CapsaraAccountError, } from './errors/index.js';
+export { FileInput } from './types/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,OAAO,EAAE,aAAa,EAA6B,MAAM,4BAA4B,CAAC;AAItF,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/internal/capsa-cache.d.ts

@@ -0,0 +1,49 @@
+/** Decrypted file metadata for download operations. */
+export interface CachedFileMetadata {
+    iv: string;
+    authTag: string;
+    compressed?: boolean;
+    encryptedFilename: string;
+    filenameIV: string;
+    filenameAuthTag: string;
+}
+/** Cached capsa entry with master key and file metadata. */
+export interface CachedCapsa {
+    /** Decrypted master key (zeroed on eviction). */
+    masterKey: Buffer;
+    files: Map<string, CachedFileMetadata>;
+    cachedAt: number;
+    expiresAt: number;
+}
+export interface CapsaCacheConfig {
+    /** Cache TTL in milliseconds (default: 5 minutes). */
+    ttl?: number;
+    /** Maximum number of cached capsas (default: 100). */
+    maxSize?: number;
+}
+/**
+ * Caches master keys after getCapsa() to avoid redundant RSA-4096 decryption
+ * on each file download.
+ */
+export declare class DecryptedCapsaCache {
+    private cache;
+    private config;
+    constructor(config?: CapsaCacheConfig);
+    set(capsaId: string, masterKey: Buffer, files: Array<{
+        fileId: string;
+    } & CachedFileMetadata>): void;
+    get(capsaId: string): CachedCapsa | null;
+    getMasterKey(capsaId: string): Buffer | null;
+    getFileMetadata(capsaId: string, fileId: string): CachedFileMetadata | null;
+    has(capsaId: string): boolean;
+    /** Zeroes master key and removes the entry. */
+    clear(capsaId: string): void;
+    /** Zeroes all master keys and clears the cache. */
+    clearAll(): void;
+    clearMasterKey(capsaId: string): void;
+    get size(): number;
+    prune(): void;
+    private evictOldest;
+}
+export declare function createCapsaCache(config?: CapsaCacheConfig): DecryptedCapsaCache;
+//# sourceMappingURL=capsa-cache.d.ts.map