@capsara/sdk 1.0.1

package/dist/internal/services/limits-service.js

@@ -0,0 +1,73 @@
+/** System limits management with caching. */
+import axios from 'axios';
+import { createAxiosConfig, configureRetryInterceptor, DEFAULT_TIMEOUT_CONFIG, } from '../config/http-client.js';
+/**
+ * Hardcoded fallback limits (used if API fetch fails)
+ * These MUST match the server's FileConstraints in vault.api/src/types/upload.types.ts
+ */
+const FALLBACK_LIMITS = {
+    maxFileSize: 50 * 1024 * 1024, // 50MB
+    maxFilesPerCapsa: 500, // Matches server's MAX_FILES_PER_CAPSA
+    maxTotalSize: 500 * 1024 * 1024, // 500MB
+};
+export class LimitsManager {
+    axiosInstance;
+    cachedLimits = null;
+    cacheTTL = 7 * 24 * 60 * 60 * 1000; // 7 days in milliseconds
+    constructor(baseUrl, timeout, retry) {
+        const timeoutConfig = {
+            ...DEFAULT_TIMEOUT_CONFIG,
+            ...timeout,
+        };
+        const axiosConfig = createAxiosConfig(baseUrl, timeoutConfig.apiTimeout, timeoutConfig);
+        this.axiosInstance = axios.create(axiosConfig);
+        configureRetryInterceptor(this.axiosInstance, retry);
+    }
+    /**
+     * Fetch system limits from API
+     * @returns System limits
+     */
+    async fetchLimits() {
+        try {
+            const response = await this.axiosInstance.get('/api/limits');
+            return response.data;
+        }
+        catch {
+            // API is down or /limits endpoint doesn't exist - use fallback
+            return FALLBACK_LIMITS;
+        }
+    }
+    /**
+     * Get system limits (from cache or fetch from API)
+     * @returns System limits
+     */
+    async getLimits() {
+        if (this.cachedLimits) {
+            const age = Date.now() - this.cachedLimits.cachedAt;
+            if (age < this.cacheTTL) {
+                return this.cachedLimits.limits;
+            }
+            this.cachedLimits = null;
+        }
+        const limits = await this.fetchLimits();
+        this.cachedLimits = {
+            limits,
+            cachedAt: Date.now(),
+        };
+        return limits;
+    }
+    /**
+     * Clear the limits cache (useful for testing or forcing refresh)
+     */
+    clearCache() {
+        this.cachedLimits = null;
+    }
+    /**
+     * Get fallback limits (for reference)
+     * @returns Hardcoded fallback limits
+     */
+    static getFallbackLimits() {
+        return { ...FALLBACK_LIMITS };
+    }
+}
+//# sourceMappingURL=limits-service.js.map

package/dist/internal/services/limits-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits-service.js","sourceRoot":"","sources":["../../../src/internal/services/limits-service.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,OAAO,KAAwB,MAAM,OAAO,CAAC;AAE7C,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,GAEvB,MAAM,0BAA0B,CAAC;AAQlC;;;GAGG;AACH,MAAM,eAAe,GAAiB;IACpC,WAAW,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO;IACtC,gBAAgB,EAAE,GAAG,EAAE,uCAAuC;IAC9D,YAAY,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,QAAQ;CAC1C,CAAC;AAEF,MAAM,OAAO,aAAa;IAChB,aAAa,CAAgB;IAC7B,YAAY,GAAwB,IAAI,CAAC;IAChC,QAAQ,GAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,yBAAyB;IAEtF,YAAY,OAAe,EAAE,OAAoC,EAAE,KAAmB;QACpF,MAAM,aAAa,GAAG;YACpB,GAAG,sBAAsB;YACzB,GAAG,OAAO;SACX,CAAC;QAEF,MAAM,WAAW,GAAG,iBAAiB,CACnC,OAAO,EACP,aAAa,CAAC,UAAU,EACxB,aAAa,CACd,CAAC;QACF,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAE/C,yBAAyB,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,WAAW;QACvB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAe,aAAa,CAAC,CAAC;YAC3E,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;YAC/D,OAAO,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC;YAEpD,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACxB,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;YAClC,CAAC;YAED,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAExC,IAAI,CAAC,YAAY,GAAG;YAClB,MAAM;YACN,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;SACrB,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,iBAAiB;QACtB,OAAO,EAAE,GAAG,eAAe,EAAE,CAAC;IAChC,CAAC;CACF"}

package/dist/internal/services/upload-service.d.ts

@@ -0,0 +1,61 @@
+/** Capsa upload service with batching and retry logic. */
+import { type HttpTimeoutConfig } from '../config/http-client.js';
+import type { RetryConfig, RetryLogger } from '../config/retry-interceptor.js';
+import type { CapsaBuilder } from '../../builder/capsa-builder.js';
+import type { KeyManager } from './key-service.js';
+export interface UploadServiceOptions {
+    baseUrl: string;
+    keyManager: KeyManager;
+    getToken: () => string | null;
+    timeoutConfig: HttpTimeoutConfig;
+    retryConfig: Required<RetryConfig>;
+    logger: RetryLogger;
+    maxBatchSize: number;
+    userAgent?: string;
+}
+export interface SendResult {
+    batchId: string;
+    successful: number;
+    failed: number;
+    partialSuccess?: boolean;
+    created: Array<{
+        packageId: string;
+        index: number;
+    }>;
+    errors?: Array<{
+        index: number;
+        packageId: string;
+        error: string;
+    }>;
+}
+export declare class UploadService {
+    private baseUrl;
+    private keyManager;
+    private getToken;
+    private timeoutConfig;
+    private retryConfig;
+    private logger;
+    private maxBatchSize;
+    private userAgent;
+    constructor(options: UploadServiceOptions);
+    /**
+     * Send capsas with automatic batch splitting
+     * @param builders - Array of CapsaBuilder instances
+     * @param creatorId - Creator party ID
+     * @returns Send result
+     */
+    sendCapsas(builders: CapsaBuilder[], creatorId: string): Promise<SendResult>;
+    /**
+     * Send capsas in balanced batches
+     */
+    private sendInBalancedBatches;
+    /**
+     * Send multipart request with retry logic
+     */
+    private sendWithRetry;
+    /**
+     * Calculate retry delay
+     */
+    private calculateRetryDelay;
+}
+//# sourceMappingURL=upload-service.d.ts.map

package/dist/internal/services/upload-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-service.d.ts","sourceRoot":"","sources":["../../../src/internal/services/upload-service.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAK1D,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,iBAAiB,CAAC;IACjC,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,oBAAoB;IAWzC;;;;;OAKG;IACG,UAAU,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAuBlF;;OAEG;YACW,qBAAqB;IAwJnC;;OAEG;YACW,aAAa;IAsF3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAe5B"}

package/dist/internal/services/upload-service.js

@@ -0,0 +1,258 @@
+/** Capsa upload service with batching and retry logic. */
+import * as http from 'http';
+import * as https from 'https';
+import { CapsasMultipartBuilder } from '../upload/multipart-builder.js';
+import { createAgentForProtocol } from '../config/http-client.js';
+import { SDK_VERSION, buildUserAgent } from '../version.js';
+export class UploadService {
+    baseUrl;
+    keyManager;
+    getToken;
+    timeoutConfig;
+    retryConfig;
+    logger;
+    maxBatchSize;
+    userAgent;
+    constructor(options) {
+        this.baseUrl = options.baseUrl;
+        this.keyManager = options.keyManager;
+        this.getToken = options.getToken;
+        this.timeoutConfig = options.timeoutConfig;
+        this.retryConfig = options.retryConfig;
+        this.logger = options.logger;
+        this.maxBatchSize = options.maxBatchSize;
+        this.userAgent = buildUserAgent(options.userAgent);
+    }
+    /**
+     * Send capsas with automatic batch splitting
+     * @param builders - Array of CapsaBuilder instances
+     * @param creatorId - Creator party ID
+     * @returns Send result
+     */
+    async sendCapsas(builders, creatorId) {
+        if (builders.length === 0) {
+            throw new Error('No capsas provided to send');
+        }
+        if (builders.length > 500) {
+            throw new Error('Send limited to 500 capsas per request');
+        }
+        // Validate no single capsa exceeds file limit
+        const MAX_FILES_PER_BATCH = 500;
+        for (let i = 0; i < builders.length; i++) {
+            const fileCount = builders[i].getFileCount();
+            if (fileCount > MAX_FILES_PER_BATCH) {
+                throw new Error(`Capsa at index ${i} has ${fileCount} files, exceeding the batch limit of ${MAX_FILES_PER_BATCH} files.`);
+            }
+        }
+        return this.sendInBalancedBatches(builders, creatorId);
+    }
+    /**
+     * Send capsas in balanced batches
+     */
+    async sendInBalancedBatches(builders, creatorId) {
+        const MAX_FILES_PER_BATCH = 500;
+        const totalFiles = builders.reduce((sum, builder) => sum + builder.getFileCount(), 0);
+        const chunks = [];
+        let currentChunk = [];
+        let currentChunkFileCount = 0;
+        for (const builder of builders) {
+            const builderFileCount = builder.getFileCount();
+            const wouldExceedCapsaLimit = currentChunk.length >= this.maxBatchSize;
+            const wouldExceedFileLimit = currentChunkFileCount + builderFileCount > MAX_FILES_PER_BATCH;
+            if (currentChunk.length > 0 && (wouldExceedCapsaLimit || wouldExceedFileLimit)) {
+                chunks.push(currentChunk);
+                currentChunk = [builder];
+                currentChunkFileCount = builderFileCount;
+            }
+            else {
+                currentChunk.push(builder);
+                currentChunkFileCount += builderFileCount;
+            }
+        }
+        if (currentChunk.length > 0) {
+            chunks.push(currentChunk);
+        }
+        if (this.retryConfig.enableLogging) {
+            const chunkSummary = chunks.map(chunk => {
+                const capsaCount = chunk.length;
+                const fileCount = chunk.reduce((sum, b) => sum + b.getFileCount(), 0);
+                return `${capsaCount}capsa/${fileCount}files`;
+            }).join(', ');
+            this.logger.log(`[Capsara SDK] Smart auto-split: ${builders.length} capsas (${totalFiles} files) → ` +
+                `${chunks.length} batches (${chunkSummary})`);
+        }
+        const results = [];
+        let currentOffset = 0;
+        for (let chunkIndex = 0; chunkIndex < chunks.length; chunkIndex++) {
+            const chunk = chunks[chunkIndex];
+            if (this.retryConfig.enableLogging) {
+                this.logger.log(`[Capsara SDK] Sending batch ${chunkIndex + 1}/${chunks.length} ` +
+                    `(${chunk.length} capsas, offset: ${currentOffset})`);
+            }
+            try {
+                const allPartyIds = new Set([creatorId]);
+                chunk.forEach(builder => {
+                    builder.getRecipientIds().forEach(id => allPartyIds.add(id));
+                });
+                const partyKeys = await this.keyManager.fetchPartyKeys(Array.from(allPartyIds));
+                const builtCapsas = await Promise.all(chunk.map(builder => builder.build(partyKeys)));
+                const multipartBuilder = new CapsasMultipartBuilder();
+                multipartBuilder.addMetadata(chunk.length, creatorId);
+                builtCapsas.forEach((builtCapsa, capsaIndex) => {
+                    multipartBuilder.addCapsaMetadata(builtCapsa.capsa, capsaIndex);
+                    builtCapsa.files.forEach((file) => {
+                        multipartBuilder.addFileBinary(file.data, file.metadata.fileId);
+                    });
+                });
+                const body = multipartBuilder.build();
+                const result = await this.sendWithRetry(body, multipartBuilder.getContentType());
+                const adjustedResult = {
+                    ...result,
+                    created: result.created.map(item => ({
+                        ...item,
+                        index: item.index + currentOffset,
+                    })),
+                    errors: result.errors?.map(item => ({
+                        ...item,
+                        index: item.index + currentOffset,
+                    })),
+                };
+                results.push(adjustedResult);
+                currentOffset += chunk.length;
+                if (this.retryConfig.enableLogging) {
+                    this.logger.log(`[Capsara SDK] Batch ${chunkIndex + 1}/${chunks.length} completed: ` +
+                        `${result.successful} succeeded, ${result.failed} failed`);
+                }
+            }
+            catch (error) {
+                const failedErrors = chunk.map((_, index) => ({
+                    index: currentOffset + index,
+                    packageId: '',
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                }));
+                results.push({
+                    batchId: '',
+                    successful: 0,
+                    failed: chunk.length,
+                    partialSuccess: false,
+                    created: [],
+                    errors: failedErrors,
+                });
+                currentOffset += chunk.length;
+                if (this.retryConfig.enableLogging) {
+                    this.logger.log(`[Capsara SDK] Batch ${chunkIndex + 1}/${chunks.length} failed: ` +
+                        `${error instanceof Error ? error.message : 'Unknown error'}`);
+                }
+            }
+        }
+        const allErrors = results.flatMap(r => r.errors || []);
+        const aggregated = {
+            batchId: results[0]?.batchId || `batch_${Date.now()}`,
+            successful: results.reduce((sum, r) => sum + r.successful, 0),
+            failed: results.reduce((sum, r) => sum + r.failed, 0),
+            partialSuccess: results.some(r => r.partialSuccess) ||
+                (results.some(r => r.successful > 0) && results.some(r => r.failed > 0)),
+            created: results.flatMap(r => r.created),
+        };
+        if (allErrors.length > 0) {
+            aggregated.errors = allErrors;
+        }
+        if (this.retryConfig.enableLogging) {
+            this.logger.log(`[Capsara SDK] All batches completed: ` +
+                `${aggregated.successful}/${builders.length} succeeded, ` +
+                `${aggregated.failed}/${builders.length} failed`);
+        }
+        return aggregated;
+    }
+    /**
+     * Send multipart request with retry logic
+     */
+    async sendWithRetry(body, contentType, retryCount = 0) {
+        return new Promise((resolve, reject) => {
+            const url = new URL(`${this.baseUrl}/api/capsas`);
+            const token = this.getToken();
+            const agent = createAgentForProtocol(url.protocol, this.timeoutConfig.uploadTimeout, this.timeoutConfig);
+            const options = {
+                hostname: url.hostname,
+                port: url.port || (url.protocol === 'https:' ? 443 : 80),
+                path: url.pathname,
+                method: 'POST',
+                headers: {
+                    'Content-Type': contentType,
+                    'Content-Length': body.length.toString(),
+                    Authorization: token ? `Bearer ${token}` : '',
+                    'User-Agent': this.userAgent,
+                    'X-SDK-Version': SDK_VERSION,
+                },
+                timeout: this.timeoutConfig.uploadTimeout,
+                agent,
+            };
+            const requester = url.protocol === 'https:' ? https : http;
+            const req = requester.request(options, (res) => {
+                let responseData = '';
+                res.on('data', (chunk) => {
+                    responseData += chunk.toString('utf-8');
+                });
+                res.on('end', () => {
+                    if (res.statusCode && ((res.statusCode >= 200 && res.statusCode < 300) || res.statusCode === 207)) {
+                        try {
+                            const response = JSON.parse(responseData);
+                            resolve(response);
+                        }
+                        catch (error) {
+                            reject(new Error(`Failed to parse response: ${error instanceof Error ? error.message : 'Unknown'}`));
+                        }
+                    }
+                    else {
+                        const isRetryable = res.statusCode === 503 || res.statusCode === 429;
+                        if (isRetryable && retryCount < this.retryConfig.maxRetries) {
+                            const retryDelay = this.calculateRetryDelay(responseData, retryCount, res.statusCode);
+                            if (this.retryConfig.enableLogging) {
+                                this.logger.log(`[Capsara SDK] Retry attempt ${retryCount + 1}/${this.retryConfig.maxRetries} ` +
+                                    `for ${res.statusCode} error - waiting ${Math.floor(retryDelay)}ms`);
+                            }
+                            globalThis.setTimeout(() => {
+                                this.sendWithRetry(body, contentType, retryCount + 1)
+                                    .then(resolve)
+                                    .catch(reject);
+                            }, retryDelay);
+                        }
+                        else {
+                            reject(new Error(`Send failed with status ${res.statusCode}: ${responseData}`));
+                        }
+                    }
+                });
+            });
+            req.on('error', reject);
+            req.on('timeout', () => {
+                req.destroy();
+                reject(new Error(`Upload timeout after ${this.timeoutConfig.uploadTimeout / 1000} seconds`));
+            });
+            // Write body in chunks
+            const chunkSize = 64 * 1024;
+            for (let i = 0; i < body.length; i += chunkSize) {
+                req.write(body.subarray(i, Math.min(i + chunkSize, body.length)));
+            }
+            req.end();
+        });
+    }
+    /**
+     * Calculate retry delay
+     */
+    calculateRetryDelay(responseData, retryCount, _statusCode) {
+        try {
+            const errorResponse = JSON.parse(responseData);
+            const serverDelay = errorResponse?.error?.retryAfter;
+            if (typeof serverDelay === 'number') {
+                return Math.min(serverDelay * 1000, this.retryConfig.maxDelay);
+            }
+        }
+        catch {
+            // Parse failed, use exponential backoff
+        }
+        const exponentialDelay = this.retryConfig.baseDelay * Math.pow(2, retryCount);
+        const jitter = Math.random() * 0.3 * exponentialDelay;
+        return Math.min(exponentialDelay + jitter, this.retryConfig.maxDelay);
+    }
+}
+//# sourceMappingURL=upload-service.js.map

package/dist/internal/services/upload-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-service.js","sourceRoot":"","sources":["../../../src/internal/services/upload-service.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAA0B,MAAM,0BAA0B,CAAC;AAI1F,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAsB5D,MAAM,OAAO,aAAa;IAChB,OAAO,CAAS;IAChB,UAAU,CAAa;IACvB,QAAQ,CAAsB;IAC9B,aAAa,CAAoB;IACjC,WAAW,CAAwB;IACnC,MAAM,CAAc;IACpB,YAAY,CAAS;IACrB,SAAS,CAAS;IAE1B,YAAY,OAA6B;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,QAAwB,EAAE,SAAiB;QAC1D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,8CAA8C;QAC9C,MAAM,mBAAmB,GAAG,GAAG,CAAC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC,YAAY,EAAE,CAAC;YAC9C,IAAI,SAAS,GAAG,mBAAmB,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CACb,kBAAkB,CAAC,QAAQ,SAAS,wCAAwC,mBAAmB,SAAS,CACzG,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB,CAAC,QAAwB,EAAE,SAAiB;QAC7E,MAAM,mBAAmB,GAAG,GAAG,CAAC;QAChC,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC;QAEtF,MAAM,MAAM,GAAqB,EAAE,CAAC;QACpC,IAAI,YAAY,GAAmB,EAAE,CAAC;QACtC,IAAI,qBAAqB,GAAG,CAAC,CAAC;QAE9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YAChD,MAAM,qBAAqB,GAAG,YAAY,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,CAAC;YACvE,MAAM,oBAAoB,GAAG,qBAAqB,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;YAE5F,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,qBAAqB,IAAI,oBAAoB,CAAC,EAAE,CAAC;gBAC/E,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC1B,YAAY,GAAG,CAAC,OAAO,CAAC,CAAC;gBACzB,qBAAqB,GAAG,gBAAgB,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC3B,qBAAqB,IAAI,gBAAgB,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;YACnC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;gBACtC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;gBAChC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC;gBACtE,OAAO,GAAG,UAAU,SAAS,SAAS,OAAO,CAAC;YAChD,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,mCAAmC,QAAQ,CAAC,MAAM,YAAY,UAAU,YAAY;gBACpF,GAAG,MAAM,CAAC,MAAM,aAAa,YAAY,GAAG,CAC7C,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,IAAI,aAAa,GAAG,CAAC,CAAC;QAEtB,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;YAClE,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAE,CAAC;YAElC,IAAI,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;gBACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,+BAA+B,UAAU,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG;oBACjE,IAAI,KAAK,CAAC,MAAM,oBAAoB,aAAa,GAAG,CACrD,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,CAAC,SAAS,CAAC,CAAC,CAAC;gBACjD,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;oBACtB,OAAO,CAAC,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC/D,CAAC,CAAC,CAAC;gBAEH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;gBAEhF,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CACnC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAC/C,CAAC;gBAEF,MAAM,gBAAgB,GAAG,IAAI,sBAAsB,EAAE,CAAC;gBACtD,gBAAgB,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAEtD,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE;oBAC7C,gBAAgB,CAAC,gBAAgB,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;oBAEhE,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;wBAChC,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBAClE,CAAC,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;gBAEH,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,EAAE,CAAC;gBACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,gBAAgB,CAAC,cAAc,EAAE,CAAC,CAAC;gBAEjF,MAAM,cAAc,GAAe;oBACjC,GAAG,MAAM;oBACT,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBACnC,GAAG,IAAI;wBACP,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,aAAa;qBAClC,CAAC,CAAC;oBACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBAClC,GAAG,IAAI;wBACP,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,aAAa;qBAClC,CAAC,CAAC;iBACJ,CAAC;gBAEF,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBAC7B,aAAa,IAAI,KAAK,CAAC,MAAM,CAAC;gBAE9B,IAAI,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;oBACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,uBAAuB,UAAU,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,cAAc;wBACpE,GAAG,MAAM,CAAC,UAAU,eAAe,MAAM,CAAC,MAAM,SAAS,CAC1D,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;oBAC5C,KAAK,EAAE,aAAa,GAAG,KAAK;oBAC5B,SAAS,EAAE,EAAE;oBACb,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;iBAChE,CAAC,CAAC,CAAC;gBAEJ,OAAO,CAAC,IAAI,CAAC;oBACX,OAAO,EAAE,EAAE;oBACX,UAAU,EAAE,CAAC;oBACb,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,cAAc,EAAE,KAAK;oBACrB,OAAO,EAAE,EAAE;oBACX,MAAM,EAAE,YAAY;iBACrB,CAAC,CAAC;gBAEH,aAAa,IAAI,KAAK,CAAC,MAAM,CAAC;gBAE9B,IAAI,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;oBACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,uBAAuB,UAAU,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,WAAW;wBACjE,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAC9D,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,UAAU,GAAe;YAC7B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,SAAS,IAAI,CAAC,GAAG,EAAE,EAAE;YACrD,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;YAC7D,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACrD,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;gBACnC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACxF,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;SACzC,CAAC;QAEF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,UAAU,CAAC,MAAM,GAAG,SAAS,CAAC;QAChC,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,uCAAuC;gBACvC,GAAG,UAAU,CAAC,UAAU,IAAI,QAAQ,CAAC,MAAM,cAAc;gBACzD,GAAG,UAAU,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,SAAS,CACjD,CAAC;QACJ,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CACzB,IAAY,EACZ,WAAmB,EACnB,aAAqB,CAAC;QAEtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,aAAa,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAE9B,MAAM,KAAK,GAAG,sBAAsB,CAClC,GAAG,CAAC,QAAQ,EACZ,IAAI,CAAC,aAAa,CAAC,aAAa,EAChC,IAAI,CAAC,aAAa,CACnB,CAAC;YAEF,MAAM,OAAO,GAAwB;gBACnC,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxD,IAAI,EAAE,GAAG,CAAC,QAAQ;gBAClB,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,WAAW;oBAC3B,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;oBACxC,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE;oBAC7C,YAAY,EAAE,IAAI,CAAC,SAAS;oBAC5B,eAAe,EAAE,WAAW;iBAC7B;gBACD,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,aAAa;gBACzC,KAAK;aACN,CAAC;YAEF,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YAC3D,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC7C,IAAI,YAAY,GAAG,EAAE,CAAC;gBAEtB,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;oBAC/B,YAAY,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC1C,CAAC,CAAC,CAAC;gBAEH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;oBACjB,IAAI,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG,CAAC,EAAE,CAAC;wBAClG,IAAI,CAAC;4BACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAe,CAAC;4BACxD,OAAO,CAAC,QAAQ,CAAC,CAAC;wBACpB,CAAC;wBAAC,OAAO,KAAK,EAAE,CAAC;4BACf,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;wBACvG,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,MAAM,WAAW,GAAG,GAAG,CAAC,UAAU,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG,CAAC;wBACrE,IAAI,WAAW,IAAI,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;4BAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,YAAY,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;4BAEtF,IAAI,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;gCACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,+BAA+B,UAAU,GAAG,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,GAAG;oCAC/E,OAAO,GAAG,CAAC,UAAU,oBAAoB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CACpE,CAAC;4BACJ,CAAC;4BAED,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE;gCACzB,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,GAAG,CAAC,CAAC;qCAClD,IAAI,CAAC,OAAO,CAAC;qCACb,KAAK,CAAC,MAAM,CAAC,CAAC;4BACnB,CAAC,EAAE,UAAU,CAAC,CAAC;wBACjB,CAAC;6BAAM,CAAC;4BACN,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,UAAU,KAAK,YAAY,EAAE,CAAC,CAAC,CAAC;wBAClF,CAAC;oBACH,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACxB,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;gBACrB,GAAG,CAAC,OAAO,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,aAAa,CAAC,aAAa,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC;YAC/F,CAAC,CAAC,CAAC;YAEH,uBAAuB;YACvB,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,CAAC;YAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;gBAChD,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACpE,CAAC;YACD,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,YAAoB,EAAE,UAAkB,EAAE,WAA+B;QACnG,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAwC,CAAC;YACtF,MAAM,WAAW,GAAG,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC;YACrD,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;gBACpC,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,gBAAgB,CAAC;QACtD,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACxE,CAAC;CACF"}

package/dist/internal/types.d.ts

@@ -0,0 +1,74 @@
+/** Internal types used by services, builders, and crypto modules. */
+export interface KeychainEntry {
+    party: string;
+    encryptedKey: string;
+    iv: string;
+    fingerprint: string;
+    permissions: string[];
+    actingFor?: string[];
+    revoked?: boolean;
+}
+/** Matches API response. */
+export interface EncryptedFile {
+    fileId: string;
+    encryptedFilename: string;
+    filenameIV: string;
+    filenameAuthTag: string;
+    iv: string;
+    authTag: string;
+    mimetype: string;
+    size: number;
+    hash: string;
+    hashAlgorithm: string;
+    expiresAt?: string;
+    compressed?: boolean;
+    compressionAlgorithm?: 'gzip';
+    originalSize?: number;
+    /** One-way transform reference (URL or @partyId/id) */
+    transform?: string;
+}
+export interface FileEncryptionResult {
+    encryptedData: Buffer;
+    iv: string;
+    authTag: string;
+    hash: string;
+    size: number;
+    mimetype: string;
+    compressed?: boolean;
+    compressionAlgorithm?: 'gzip';
+    originalSize?: number;
+}
+export interface CapsaSignature {
+    algorithm: string;
+    protected: string;
+    payload: string;
+    signature: string;
+}
+/**
+ * Unencrypted metadata visible to server.
+ * Only non-sensitive operational data for routing, display, and search.
+ */
+export interface CapsaMetadata {
+    label?: string;
+    relatedPackages?: string[];
+    tags?: string[];
+    notes?: string;
+}
+export interface CapsaCreateOptions {
+    subject?: string;
+    body?: string;
+    structured?: Record<string, unknown>;
+    expiresAt?: string;
+}
+export interface AESEncryptionResult {
+    encryptedData: string;
+    iv: string;
+    authTag: string;
+}
+export interface MultipartPart {
+    name: string;
+    content: string | Buffer;
+    contentType?: string;
+    filename?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/internal/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/internal/types.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,4BAA4B;AAC5B,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/internal/types.js

@@ -0,0 +1,3 @@
+/** Internal types used by services, builders, and crypto modules. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/internal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/internal/types.ts"],"names":[],"mappings":"AAAA,qEAAqE"}

package/dist/internal/upload/multipart-builder.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Multipart form-data builder for capsa upload
+ * @file capsara.sdk/typescript/src/internal/upload/multipart-builder.ts
+ */
+import type { EncryptedFile } from '../types.js';
+/**
+ * Multipart form-data builder for capsa uploads (supports 1-500 capsas)
+ */
+export declare class CapsasMultipartBuilder {
+    private boundary;
+    private parts;
+    private metadataSet;
+    constructor();
+    /**
+     * Add capsa metadata (must be first)
+     * @param capsaCount - Number of capsas in request
+     * @param creator - Creator party ID
+     */
+    addMetadata(capsaCount: number, creator: string): this;
+    /**
+     * Add capsa metadata part with index
+     * @param capsa - Capsa object
+     * @param capsaIndex - Capsa index in request
+     */
+    addCapsaMetadata(capsa: unknown, capsaIndex: number): this;
+    /**
+     * Add file metadata part with capsa and file indexes
+     * @param fileMetadata - File metadata object with fileId
+     * @param capsaIndex - Capsa index
+     * @param fileIndex - File index within capsa
+     */
+    addFileMetadata(fileMetadata: EncryptedFile | (Record<string, unknown> & {
+        fileId?: string;
+    }), capsaIndex: number, fileIndex: number): this;
+    /**
+     * Add file binary part with file ID
+     * @param fileData - File data buffer
+     * @param fileId - File ID from metadata (should include .enc extension)
+     */
+    addFileBinary(fileData: Buffer, fileId: string): this;
+    /**
+     * Build the complete multipart body
+     * @returns Multipart body as Buffer
+     */
+    build(): Buffer;
+    /**
+     * Get the Content-Type header value
+     * @returns Content-Type with boundary
+     */
+    getContentType(): string;
+    /**
+     * Get the boundary string
+     * @returns Boundary string
+     */
+    getBoundary(): string;
+}
+//# sourceMappingURL=multipart-builder.d.ts.map

package/dist/internal/upload/multipart-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart-builder.d.ts","sourceRoot":"","sources":["../../../src/internal/upload/multipart-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhE;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,WAAW,CAAkB;;IAOrC;;;;OAIG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAetD;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAa1D;;;;;OAKG;IACH,eAAe,CACb,YAAY,EAAE,aAAa,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAC7E,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,IAAI;IAgBP;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAcrD;;;OAGG;IACH,KAAK,IAAI,MAAM;IA6Cf;;;OAGG;IACH,cAAc,IAAI,MAAM;IAIxB;;;OAGG;IACH,WAAW,IAAI,MAAM;CAGtB"}