captify 0.1.15

package/dist/files/services/file-upload/constants.d.ts

@@ -0,0 +1,205 @@
+export declare const FILE_UPLOAD_ERROR_MESSAGES: {
+    readonly INVALID_FILE_TYPE: "File type not allowed";
+    readonly FILE_TOO_LARGE: "File exceeds maximum size limit";
+    readonly MISSING_TENANT_ID: "Tenant ID is required";
+    readonly MISSING_ENTITY: "Entity type is required";
+    readonly INVALID_FILE_NAME: "Invalid file name";
+    readonly UPLOAD_FAILED: "Failed to generate upload URL";
+    readonly MULTIPART_INIT_FAILED: "Failed to initiate multipart upload";
+    readonly MULTIPART_COMPLETE_FAILED: "Failed to complete multipart upload";
+};
+/**
+ * S3 Key Template System
+ *
+ * Provides a flexible way to define S3 key patterns for different entity types.
+ * Templates support placeholders that are replaced at runtime with actual values.
+ *
+ * Available placeholders:
+ * - {tenantId} - The tenant identifier
+ * - {entity} - The entity type (e.g., "documents", "clearance-forms")
+ * - {userId} - The user identifier (optional)
+ * - {year} - Current UTC year (4 digits)
+ * - {month} - Current UTC month (2 digits, zero-padded)
+ * - {day} - Current UTC day (2 digits, zero-padded)
+ * - {fileId} - Unique file identifier (UUID)
+ * - {fileName} - Sanitized original file name
+ *
+ * @example
+ * // Default template
+ * "tenants/{tenantId}/{entity}/{year}/{month}/{day}/{fileId}-{fileName}"
+ * // Result: "tenants/tenant-123/documents/2025/01/15/abc-123-report.pdf"
+ *
+ * @example
+ * // User-specific template
+ * "tenants/{tenantId}/users/{userId}/{entity}/{fileId}-{fileName}"
+ * // Result: "tenants/tenant-123/users/user-456/avatars/abc-123-profile.jpg"
+ */
+/**
+ * Template placeholder types
+ */
+export type S3KeyPlaceholder = "tenantId" | "entity" | "userId" | "year" | "month" | "day" | "fileId" | "fileName";
+/**
+ * Context values for S3 key generation
+ */
+export interface S3KeyContext {
+    tenantId: string;
+    entity: string;
+    fileId: string;
+    fileName: string;
+    userId?: string;
+}
+/**
+ * S3 key template configuration for an entity
+ */
+export interface S3KeyTemplateConfig {
+    /** The template pattern with placeholders */
+    template: string;
+    /** Optional description of the template usage */
+    description?: string;
+    /** Whether to include date partitioning (default: true) */
+    includeDatePartition?: boolean;
+}
+/**
+ * Default S3 key template with date partitioning
+ * Format: tenants/{tenantId}/{entity}/{year}/{month}/{day}/{fileId}-{fileName}
+ */
+export declare const DEFAULT_S3_KEY_TEMPLATE = "tenants/{tenantId}/{entity}/{year}/{month}/{day}/{fileId}-{fileName}";
+/**
+ * Simple S3 key template without date partitioning
+ * Used as fallback when includeDatePartition is false for entities with date templates
+ * Format: tenants/{tenantId}/{entity}/{fileId}-{fileName}
+ */
+export declare const S3_KEY_TEMPLATE = "tenants/{tenantId}/{entity}/{fileId}-{fileName}";
+/**
+ * Simple S3 key template with user path (no date partitioning)
+ * Used for user-specific entities when includeDatePartition is false
+ * Format: tenants/{tenantId}/users/{userId}/{entity}/{fileId}-{fileName}
+ */
+export declare const USER_S3_KEY_TEMPLATE = "tenants/{tenantId}/users/{userId}/{entity}/{fileId}-{fileName}";
+/**
+ * Entity-specific S3 key templates
+ *
+ * Define custom templates for specific entity types.
+ * If an entity is not listed here, the default template will be used.
+ */
+export declare const S3_KEY_TEMPLATES: Record<string, S3KeyTemplateConfig>;
+/**
+ * Get the S3 key template configuration for an entity
+ *
+ * @param entity - The entity type
+ * @returns The template configuration, or default if not found
+ */
+export declare function getS3KeyTemplate(entity: string): S3KeyTemplateConfig;
+/**
+ * Get current date parts for S3 key generation
+ */
+export declare function getDateParts(): {
+    year: string;
+    month: string;
+    day: string;
+};
+/**
+ * Build an S3 key from a template and context
+ *
+ * @param template - The template string with placeholders
+ * @param context - The context values to substitute
+ * @returns The generated S3 key
+ *
+ * @example
+ * ```typescript
+ * const key = buildS3KeyFromTemplate(
+ *   "tenants/{tenantId}/{entity}/{year}/{month}/{day}/{fileId}-{fileName}",
+ *   {
+ *     tenantId: "tenant-123",
+ *     entity: "documents",
+ *     fileId: "abc-123",
+ *     fileName: "report.pdf"
+ *   }
+ * );
+ * // Result: "tenants/tenant-123/documents/2025/01/15/abc-123-report.pdf"
+ * ```
+ */
+export declare function buildS3KeyFromTemplate(template: string, context: S3KeyContext): string;
+/**
+ * Generate an S3 key for the given entity and context
+ *
+ * This is the main entry point for S3 key generation.
+ * It automatically selects the appropriate template based on entity type.
+ *
+ * @param context - The context values for key generation
+ * @returns The generated S3 key
+ *
+ * @example
+ * ```typescript
+ * // Clearance forms (tenant and user-based path)
+ * const key = generateS3KeyFromTemplate({
+ *   tenantId: "tenant-123",
+ *   entity: "clearance-forms",
+ *   fileId: "abc-123",
+ *   fileName: "form-2875.pdf",
+ *   userId: "user-456"
+ * });
+ * // Result: "tenants/tenant-123/users/user-456/clearance-forms/abc-123-form-2875.pdf"
+ *
+ * // Documents (tenant-based path with date partitioning)
+ * const key = generateS3KeyFromTemplate({
+ *   tenantId: "tenant-123",
+ *   entity: "documents",
+ *   fileId: "abc-123",
+ *   fileName: "report.pdf"
+ * });
+ * // Result: "tenants/tenant-123/documents/2025/01/15/abc-123-report.pdf"
+ * ```
+ */
+export declare function generateS3KeyFromTemplate(context: S3KeyContext): string;
+/**
+ * Parse an S3 key to extract context values
+ *
+ * Attempts to extract tenant ID, user ID, entity, and file ID from an S3 key.
+ * Works best with keys generated using the standard templates.
+ *
+ * Supported formats:
+ * - tenants/{tenantId}/{entity}/.../{fileId}-{fileName}
+ * - users/{userId}/{entity}/{fileId}-{fileName}
+ * - tenants/{tenantId}/users/{userId}/{entity}/{fileId}-{fileName}
+ *
+ * @param key - The S3 key to parse
+ * @returns Partial context extracted from the key
+ *
+ * @example
+ * ```typescript
+ * // Tenant-based key with UUID fileId
+ * const context = parseS3Key("tenants/tenant-123/documents/2025/01/15/550e8400-e29b-41d4-a716-446655440000-report.pdf");
+ * // Result: { tenantId: "tenant-123", entity: "documents", fileId: "550e8400-e29b-41d4-a716-446655440000", fileName: "report.pdf" }
+ *
+ * // User-based key (clearance-forms)
+ * const context = parseS3Key("users/user-456/clearance-forms/550e8400-e29b-41d4-a716-446655440000-form-2875.pdf");
+ * // Result: { userId: "user-456", entity: "clearance-forms", fileId: "550e8400-e29b-41d4-a716-446655440000", fileName: "form-2875.pdf" }
+ * ```
+ */
+export declare function parseS3Key(key: string): Partial<S3KeyContext>;
+/**
+ * Validate that an S3 key belongs to a specific tenant
+ *
+ * @param key - The S3 key to validate
+ * @param tenantId - The expected tenant ID
+ * @returns True if the key belongs to the tenant
+ */
+export declare function validateS3KeyTenant(key: string, tenantId: string): boolean;
+/**
+ * Validate that an S3 key belongs to a specific entity type
+ *
+ * @param key - The S3 key to validate
+ * @param entity - The expected entity type
+ * @returns True if the key belongs to the entity
+ */
+export declare function validateS3KeyEntity(key: string, entity: string): boolean;
+/**
+ * Validate that an S3 key belongs to a specific user
+ *
+ * @param key - The S3 key to validate
+ * @param userId - The expected user ID
+ * @returns True if the key belongs to the user
+ */
+export declare function validateS3KeyUser(key: string, userId: string): boolean;
+//# sourceMappingURL=constants.d.ts.map

package/dist/files/services/file-upload/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../lib/files/services/file-upload/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B;;;;;;;;;CAS7B,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,OAAO,GACP,KAAK,GACL,QAAQ,GACR,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,yEACoC,CAAC;AAEzE;;;;GAIG;AACH,eAAO,MAAM,eAAe,oDAAoD,CAAC;AAEjF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,mEACiC,CAAC;AAEnE;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CA0ChE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAapE;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAO3E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CA4BtF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAGvE;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA8C7D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG1E;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAGxE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAGtE"}

package/dist/files/services/file-upload/constants.js

@@ -0,0 +1,273 @@
+export const FILE_UPLOAD_ERROR_MESSAGES = {
+    INVALID_FILE_TYPE: "File type not allowed",
+    FILE_TOO_LARGE: "File exceeds maximum size limit",
+    MISSING_TENANT_ID: "Tenant ID is required",
+    MISSING_ENTITY: "Entity type is required",
+    INVALID_FILE_NAME: "Invalid file name",
+    UPLOAD_FAILED: "Failed to generate upload URL",
+    MULTIPART_INIT_FAILED: "Failed to initiate multipart upload",
+    MULTIPART_COMPLETE_FAILED: "Failed to complete multipart upload",
+};
+/**
+ * Default S3 key template with date partitioning
+ * Format: tenants/{tenantId}/{entity}/{year}/{month}/{day}/{fileId}-{fileName}
+ */
+export const DEFAULT_S3_KEY_TEMPLATE = "tenants/{tenantId}/{entity}/{year}/{month}/{day}/{fileId}-{fileName}";
+/**
+ * Simple S3 key template without date partitioning
+ * Used as fallback when includeDatePartition is false for entities with date templates
+ * Format: tenants/{tenantId}/{entity}/{fileId}-{fileName}
+ */
+export const S3_KEY_TEMPLATE = "tenants/{tenantId}/{entity}/{fileId}-{fileName}";
+/**
+ * Simple S3 key template with user path (no date partitioning)
+ * Used for user-specific entities when includeDatePartition is false
+ * Format: tenants/{tenantId}/users/{userId}/{entity}/{fileId}-{fileName}
+ */
+export const USER_S3_KEY_TEMPLATE = "tenants/{tenantId}/users/{userId}/{entity}/{fileId}-{fileName}";
+/**
+ * Entity-specific S3 key templates
+ *
+ * Define custom templates for specific entity types.
+ * If an entity is not listed here, the default template will be used.
+ */
+export const S3_KEY_TEMPLATES = {
+    // Chat attachments - organized by tenant and entity with date partitioning
+    "chat-attachments": {
+        template: "tenants/{tenantId}/{entity}/{year}/{month}/{day}/{fileId}-{fileName}",
+        description: "Chat message attachments with date-based organization",
+        includeDatePartition: true,
+    },
+    // Clearance forms - organized by tenant without date partitioning for easier retrieval
+    "clearance-forms": {
+        template: "tenants/{tenantId}/users/{userId}/{entity}/{fileId}-{fileName}",
+        description: "Security clearance forms (Form 2875) for user registration",
+        includeDatePartition: false,
+    },
+    // User avatars - user-specific path without date partitioning
+    avatars: {
+        template: "tenants/{tenantId}/users/{userId}/{entity}/{fileId}-{fileName}",
+        description: "User profile avatars",
+        includeDatePartition: false,
+    },
+    // Documents - general document storage with date partitioning
+    documents: {
+        template: "tenants/{tenantId}/{entity}/{year}/{month}/{day}/{fileId}-{fileName}",
+        description: "General document storage",
+        includeDatePartition: true,
+    },
+    // Exports - export files organized by date
+    exports: {
+        template: "tenants/{tenantId}/{entity}/{year}/{month}/{day}/{fileId}-{fileName}",
+        description: "Data export files",
+        includeDatePartition: true,
+    },
+    // Temporary uploads - short-lived files
+    temp: {
+        template: "tenants/{tenantId}/temp/{fileId}-{fileName}",
+        description: "Temporary uploads for processing",
+        includeDatePartition: false,
+    },
+};
+/**
+ * Get the S3 key template configuration for an entity
+ *
+ * @param entity - The entity type
+ * @returns The template configuration, or default if not found
+ */
+export function getS3KeyTemplate(entity) {
+    const config = S3_KEY_TEMPLATES[entity];
+    if (config) {
+        return config;
+    }
+    // Return default template configuration
+    return {
+        template: DEFAULT_S3_KEY_TEMPLATE,
+        description: "Default template with date partitioning",
+        includeDatePartition: true,
+    };
+}
+/**
+ * Get current date parts for S3 key generation
+ */
+export function getDateParts() {
+    const now = new Date();
+    return {
+        year: String(now.getUTCFullYear()),
+        month: String(now.getUTCMonth() + 1).padStart(2, "0"),
+        day: String(now.getUTCDate()).padStart(2, "0"),
+    };
+}
+/**
+ * Build an S3 key from a template and context
+ *
+ * @param template - The template string with placeholders
+ * @param context - The context values to substitute
+ * @returns The generated S3 key
+ *
+ * @example
+ * ```typescript
+ * const key = buildS3KeyFromTemplate(
+ *   "tenants/{tenantId}/{entity}/{year}/{month}/{day}/{fileId}-{fileName}",
+ *   {
+ *     tenantId: "tenant-123",
+ *     entity: "documents",
+ *     fileId: "abc-123",
+ *     fileName: "report.pdf"
+ *   }
+ * );
+ * // Result: "tenants/tenant-123/documents/2025/01/15/abc-123-report.pdf"
+ * ```
+ */
+export function buildS3KeyFromTemplate(template, context) {
+    const dateParts = getDateParts();
+    const replacements = Object.assign({ tenantId: context.tenantId, entity: context.entity, fileId: context.fileId, fileName: context.fileName, year: dateParts.year, month: dateParts.month, day: dateParts.day }, (context.userId ? { userId: context.userId } : {}));
+    let result = template;
+    for (const [key, value] of Object.entries(replacements)) {
+        result = result.replace(new RegExp(`\\{${key}\\}`, "g"), value);
+    }
+    // Check for any remaining placeholders (missing context values)
+    const remainingPlaceholders = result.match(/\{(\w+)\}/g);
+    if (remainingPlaceholders) {
+        const missing = remainingPlaceholders.map((p) => p.slice(1, -1));
+        throw new Error(`Missing S3 key context values: ${missing.join(", ")}`);
+    }
+    return result;
+}
+/**
+ * Generate an S3 key for the given entity and context
+ *
+ * This is the main entry point for S3 key generation.
+ * It automatically selects the appropriate template based on entity type.
+ *
+ * @param context - The context values for key generation
+ * @returns The generated S3 key
+ *
+ * @example
+ * ```typescript
+ * // Clearance forms (tenant and user-based path)
+ * const key = generateS3KeyFromTemplate({
+ *   tenantId: "tenant-123",
+ *   entity: "clearance-forms",
+ *   fileId: "abc-123",
+ *   fileName: "form-2875.pdf",
+ *   userId: "user-456"
+ * });
+ * // Result: "tenants/tenant-123/users/user-456/clearance-forms/abc-123-form-2875.pdf"
+ *
+ * // Documents (tenant-based path with date partitioning)
+ * const key = generateS3KeyFromTemplate({
+ *   tenantId: "tenant-123",
+ *   entity: "documents",
+ *   fileId: "abc-123",
+ *   fileName: "report.pdf"
+ * });
+ * // Result: "tenants/tenant-123/documents/2025/01/15/abc-123-report.pdf"
+ * ```
+ */
+export function generateS3KeyFromTemplate(context) {
+    const templateConfig = getS3KeyTemplate(context.entity);
+    return buildS3KeyFromTemplate(templateConfig.template, context);
+}
+/**
+ * Parse an S3 key to extract context values
+ *
+ * Attempts to extract tenant ID, user ID, entity, and file ID from an S3 key.
+ * Works best with keys generated using the standard templates.
+ *
+ * Supported formats:
+ * - tenants/{tenantId}/{entity}/.../{fileId}-{fileName}
+ * - users/{userId}/{entity}/{fileId}-{fileName}
+ * - tenants/{tenantId}/users/{userId}/{entity}/{fileId}-{fileName}
+ *
+ * @param key - The S3 key to parse
+ * @returns Partial context extracted from the key
+ *
+ * @example
+ * ```typescript
+ * // Tenant-based key with UUID fileId
+ * const context = parseS3Key("tenants/tenant-123/documents/2025/01/15/550e8400-e29b-41d4-a716-446655440000-report.pdf");
+ * // Result: { tenantId: "tenant-123", entity: "documents", fileId: "550e8400-e29b-41d4-a716-446655440000", fileName: "report.pdf" }
+ *
+ * // User-based key (clearance-forms)
+ * const context = parseS3Key("users/user-456/clearance-forms/550e8400-e29b-41d4-a716-446655440000-form-2875.pdf");
+ * // Result: { userId: "user-456", entity: "clearance-forms", fileId: "550e8400-e29b-41d4-a716-446655440000", fileName: "form-2875.pdf" }
+ * ```
+ */
+export function parseS3Key(key) {
+    const parts = key.split("/");
+    const result = {};
+    // Extract fileId and fileName from the last segment
+    // Format: {fileId}-{fileName} where fileId is a UUID (36 chars: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)
+    const lastSegment = parts[parts.length - 1];
+    const UUID_LENGTH = 36;
+    // Check if the segment starts with a UUID pattern (has dash at position 36)
+    if (lastSegment.length > UUID_LENGTH && lastSegment[UUID_LENGTH] === "-") {
+        result.fileId = lastSegment.substring(0, UUID_LENGTH);
+        result.fileName = lastSegment.substring(UUID_LENGTH + 1);
+    }
+    else {
+        // Fallback for non-UUID fileIds: find the first dash to split fileId from fileName
+        // This handles cases like "short-id-my-file.pdf" → fileId: "short", fileName: "id-my-file.pdf"
+        // Matches the pattern used elsewhere: split("-")[0] for fileId
+        const lastDotIndex = lastSegment.lastIndexOf(".");
+        const searchEnd = lastDotIndex > 0 ? lastDotIndex : lastSegment.length;
+        const firstDashIndex = lastSegment.indexOf("-");
+        if (firstDashIndex > 0 && firstDashIndex < searchEnd) {
+            result.fileId = lastSegment.substring(0, firstDashIndex);
+            result.fileName = lastSegment.substring(firstDashIndex + 1);
+        }
+    }
+    // Format: tenants/{tenantId}/{entity}/...
+    if (parts[0] === "tenants" && parts.length >= 3) {
+        result.tenantId = parts[1];
+        // Check for nested users path: tenants/{tenantId}/users/{userId}/{entity}/...
+        if (parts[2] === "users" && parts.length >= 5) {
+            result.userId = parts[3];
+            result.entity = parts[4];
+        }
+        else {
+            result.entity = parts[2];
+        }
+    }
+    // Format: users/{userId}/{entity}/...
+    else if (parts[0] === "users" && parts.length >= 3) {
+        result.userId = parts[1];
+        result.entity = parts[2];
+    }
+    return result;
+}
+/**
+ * Validate that an S3 key belongs to a specific tenant
+ *
+ * @param key - The S3 key to validate
+ * @param tenantId - The expected tenant ID
+ * @returns True if the key belongs to the tenant
+ */
+export function validateS3KeyTenant(key, tenantId) {
+    const parsed = parseS3Key(key);
+    return parsed.tenantId === tenantId;
+}
+/**
+ * Validate that an S3 key belongs to a specific entity type
+ *
+ * @param key - The S3 key to validate
+ * @param entity - The expected entity type
+ * @returns True if the key belongs to the entity
+ */
+export function validateS3KeyEntity(key, entity) {
+    const parsed = parseS3Key(key);
+    return parsed.entity === entity;
+}
+/**
+ * Validate that an S3 key belongs to a specific user
+ *
+ * @param key - The S3 key to validate
+ * @param userId - The expected user ID
+ * @returns True if the key belongs to the user
+ */
+export function validateS3KeyUser(key, userId) {
+    const parsed = parseS3Key(key);
+    return parsed.userId === userId;
+}
+//# sourceMappingURL=constants.js.map

package/dist/files/services/file-upload/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../lib/files/services/file-upload/constants.ts"],"names":[],"mappings":"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"}

package/dist/files/services/file-upload/file-upload.service.d.ts

@@ -0,0 +1,43 @@
+import { AbortMultipartUploadParams, CompletedUploadResponse, CompleteMultipartUploadParams, FileUploadConfig, FileUploadServiceDeps, GetPartUploadUrlParams, GetUploadUrlParams, InitiateMultipartUploadParams, MultipartUploadInitResponse, PartUploadUrlResponse, UploadUrlResponse } from "./interfaces";
+import { Logger } from "../../../services/logger";
+import { BaseAwsService } from "../../../services/shared/services";
+export declare class FileUploadService extends BaseAwsService {
+    private readonly config;
+    private readonly uploadParamsSchema;
+    constructor(deps: FileUploadServiceDeps);
+    /**
+     * Get a presigned URL for uploading a small file (≤5MB)
+     * For larger files, use initiateMultipartUpload instead
+     *
+     * Supports two modes:
+     * 1. Tenant-scoped (default): files stored under tenants/{tenantId}/{entity}/...
+     * 2. Bucket-aware: when bucketName is provided, files stored directly in the specified bucket
+     */
+    getUploadUrl(params: GetUploadUrlParams): Promise<UploadUrlResponse>;
+    /**
+     * Initiate a multipart upload for large files (>5MB)
+     * Returns uploadId and part information for client-side chunked upload
+     *
+     * Supports two modes:
+     * 1. Tenant-scoped (default): files stored under tenants/{tenantId}/{entity}/...
+     * 2. Bucket-aware: when bucketName is provided, files stored directly in the specified bucket
+     */
+    initiateMultipartUpload(params: InitiateMultipartUploadParams): Promise<MultipartUploadInitResponse>;
+    /**
+     * Get a presigned URL for uploading a specific part of a multipart upload
+     */
+    getPartUploadUrl(params: GetPartUploadUrlParams): Promise<PartUploadUrlResponse>;
+    /**
+     * Complete a multipart upload after all parts have been uploaded
+     */
+    completeMultipartUpload(params: CompleteMultipartUploadParams, fileSize: number, contentType: string): Promise<CompletedUploadResponse>;
+    /**
+     * Abort a multipart upload (cleanup on failure/cancellation)
+     */
+    abortMultipartUpload(params: AbortMultipartUploadParams): Promise<void>;
+}
+export declare function getFileUploadService(deps?: {
+    config?: FileUploadConfig;
+    logger?: Logger;
+}): FileUploadService;
+//# sourceMappingURL=file-upload.service.d.ts.map

package/dist/files/services/file-upload/file-upload.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-upload.service.d.ts","sourceRoot":"","sources":["../../../../lib/files/services/file-upload/file-upload.service.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,6BAA6B,EAC7B,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,6BAA6B,EAC7B,2BAA2B,EAC3B,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,6CAA6C,CAAC;AAarD,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAG9D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,qBAAa,iBAAkB,SAAQ,cAAc;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA8C;gBAErE,IAAI,EAAE,qBAAqB;IAevC;;;;;;;OAOG;IACG,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoE1E;;;;;;;OAOG;IACG,uBAAuB,CAC3B,MAAM,EAAE,6BAA6B,GACpC,OAAO,CAAC,2BAA2B,CAAC;IA8EvC;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA+BtF;;OAEG;IACG,uBAAuB,CAC3B,MAAM,EAAE,6BAA6B,EACrC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,uBAAuB,CAAC;IA8CnC;;OAEG;IACG,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;CAqB9E;AAKD,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE;IAC1C,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,iBAAiB,CA6BpB"}