captify 0.1.15

package/dist/files/services/constants.d.ts

@@ -0,0 +1,130 @@
+/** S3 key prefix pattern for tenant-scoped files */
+export declare const TENANT_PREFIX_TEMPLATE = "tenants/{tenantId}/";
+/** Default delimiter for S3 folder grouping */
+export declare const DEFAULT_DELIMITER = "/";
+/** Default maximum keys to return per request */
+export declare const DEFAULT_MAX_KEYS = 100;
+/** Maximum allowed keys per request */
+export declare const MAX_ALLOWED_KEYS = 1000;
+/** Metadata key for original filename */
+export declare const METADATA_ORIGINAL_FILENAME = "original-filename";
+/**
+ * File List Service Error and Log Messages
+ */
+export declare const FILE_LIST_MESSAGES: {
+    readonly INVALID_TENANT_ID: "Tenant ID is required and must be a non-empty string";
+    readonly INVALID_PREFIX: "Prefix must be a string";
+    readonly INVALID_MAX_KEYS: "Max keys must be between 1 and 1000";
+    readonly METADATA_FETCH_FAILED: "Failed to fetch metadata for file";
+    readonly LISTING_FILES: "Listing files";
+    readonly LISTING_COMPLETE: "File listing complete";
+    readonly FETCHING_METADATA: "Fetching metadata for files";
+    readonly TRANSFORMING_RESULTS: "Transforming S3 results";
+};
+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
+ */
+/**
+ * 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
+ * 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)
+ * 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
+ */
+export declare const S3_KEY_TEMPLATES: Record<string, S3KeyTemplateConfig>;
+/**
+ * Get the S3 key template configuration for an entity
+ */
+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
+ */
+export declare function buildS3KeyFromTemplate(template: string, context: S3KeyContext): string;
+/**
+ * Generate an S3 key for the given entity and context
+ */
+export declare function generateS3KeyFromTemplate(context: S3KeyContext): string;
+/**
+ * Parse an S3 key to extract context values
+ */
+export declare function parseS3Key(key: string): Partial<S3KeyContext>;
+/**
+ * Validate that an S3 key belongs to a specific tenant
+ */
+export declare function validateS3KeyTenant(key: string, tenantId: string): boolean;
+/**
+ * Validate that an S3 key belongs to a specific entity type
+ */
+export declare function validateS3KeyEntity(key: string, entity: string): boolean;
+/**
+ * Validate that an S3 key belongs to a specific user
+ */
+export declare function validateS3KeyUser(key: string, userId: string): boolean;
+//# sourceMappingURL=constants.d.ts.map

package/dist/files/services/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../lib/files/services/constants.ts"],"names":[],"mappings":"AAIA,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAE5D,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,yCAAyC;AACzC,eAAO,MAAM,0BAA0B,sBAAsB,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;CAYrB,CAAC;AAMX,eAAO,MAAM,0BAA0B;;;;;;;;;CAS7B,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;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;;;GAGG;AACH,eAAO,MAAM,eAAe,oDAAoD,CAAC;AAEjF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,mEACiC,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CA+BhE,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAUpE;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAO3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CA2BtF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAGvE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAmC7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAGxE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAGtE"}

package/dist/files/services/constants.js

@@ -0,0 +1,199 @@
+// ============================================================================
+// File List Service Constants
+// ============================================================================
+/** S3 key prefix pattern for tenant-scoped files */
+export const TENANT_PREFIX_TEMPLATE = "tenants/{tenantId}/";
+/** Default delimiter for S3 folder grouping */
+export const DEFAULT_DELIMITER = "/";
+/** Default maximum keys to return per request */
+export const DEFAULT_MAX_KEYS = 100;
+/** Maximum allowed keys per request */
+export const MAX_ALLOWED_KEYS = 1000;
+/** Metadata key for original filename */
+export const METADATA_ORIGINAL_FILENAME = "original-filename";
+/**
+ * File List Service Error and Log Messages
+ */
+export const FILE_LIST_MESSAGES = {
+    // Error messages
+    INVALID_TENANT_ID: "Tenant ID is required and must be a non-empty string",
+    INVALID_PREFIX: "Prefix must be a string",
+    INVALID_MAX_KEYS: "Max keys must be between 1 and 1000",
+    METADATA_FETCH_FAILED: "Failed to fetch metadata for file",
+    // Log messages
+    LISTING_FILES: "Listing files",
+    LISTING_COMPLETE: "File listing complete",
+    FETCHING_METADATA: "Fetching metadata for files",
+    TRANSFORMING_RESULTS: "Transforming S3 results",
+};
+// ============================================================================
+// File Upload Service Constants
+// ============================================================================
+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
+ * 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)
+ * 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
+ */
+export const S3_KEY_TEMPLATES = {
+    "chat-attachments": {
+        template: "tenants/{tenantId}/{entity}/{year}/{month}/{day}/{fileId}-{fileName}",
+        description: "Chat message attachments with date-based organization",
+        includeDatePartition: true,
+    },
+    "clearance-forms": {
+        template: "tenants/{tenantId}/users/{userId}/{entity}/{fileId}-{fileName}",
+        description: "Security clearance forms (Form 2875) for user registration",
+        includeDatePartition: false,
+    },
+    avatars: {
+        template: "tenants/{tenantId}/users/{userId}/{entity}/{fileId}-{fileName}",
+        description: "User profile avatars",
+        includeDatePartition: false,
+    },
+    documents: {
+        template: "tenants/{tenantId}/{entity}/{year}/{month}/{day}/{fileId}-{fileName}",
+        description: "General document storage",
+        includeDatePartition: true,
+    },
+    exports: {
+        template: "tenants/{tenantId}/{entity}/{year}/{month}/{day}/{fileId}-{fileName}",
+        description: "Data export files",
+        includeDatePartition: true,
+    },
+    temp: {
+        template: "tenants/{tenantId}/temp/{fileId}-{fileName}",
+        description: "Temporary uploads for processing",
+        includeDatePartition: false,
+    },
+};
+/**
+ * Get the S3 key template configuration for an entity
+ */
+export function getS3KeyTemplate(entity) {
+    const config = S3_KEY_TEMPLATES[entity];
+    if (config) {
+        return config;
+    }
+    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
+ */
+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);
+    }
+    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
+ */
+export function generateS3KeyFromTemplate(context) {
+    const templateConfig = getS3KeyTemplate(context.entity);
+    return buildS3KeyFromTemplate(templateConfig.template, context);
+}
+/**
+ * Parse an S3 key to extract context values
+ */
+export function parseS3Key(key) {
+    const parts = key.split("/");
+    const result = {};
+    const lastSegment = parts[parts.length - 1];
+    const UUID_LENGTH = 36;
+    if (lastSegment.length > UUID_LENGTH && lastSegment[UUID_LENGTH] === "-") {
+        result.fileId = lastSegment.substring(0, UUID_LENGTH);
+        result.fileName = lastSegment.substring(UUID_LENGTH + 1);
+    }
+    else {
+        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);
+        }
+    }
+    if (parts[0] === "tenants" && parts.length >= 3) {
+        result.tenantId = parts[1];
+        if (parts[2] === "users" && parts.length >= 5) {
+            result.userId = parts[3];
+            result.entity = parts[4];
+        }
+        else {
+            result.entity = parts[2];
+        }
+    }
+    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
+ */
+export function validateS3KeyTenant(key, tenantId) {
+    const parsed = parseS3Key(key);
+    return parsed.tenantId === tenantId;
+}
+/**
+ * Validate that an S3 key belongs to a specific entity type
+ */
+export function validateS3KeyEntity(key, entity) {
+    const parsed = parseS3Key(key);
+    return parsed.entity === entity;
+}
+/**
+ * Validate that an S3 key belongs to a specific user
+ */
+export function validateS3KeyUser(key, userId) {
+    const parsed = parseS3Key(key);
+    return parsed.userId === userId;
+}
+//# sourceMappingURL=constants.js.map

package/dist/files/services/constants.js.map

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

package/dist/files/services/errors.d.ts

@@ -0,0 +1,51 @@
+/**
+ * File Services Error Classes
+ */
+export type FileListErrorKind = "VALIDATION_ERROR" | "S3_ERROR" | "METADATA_ERROR" | "PERMISSION_ERROR" | "PATH_TRAVERSAL" | "CROSS_TENANT_ACCESS";
+/**
+ * Base error class for File List Service operations
+ */
+export declare class FileListError extends Error {
+    readonly kind: FileListErrorKind;
+    readonly cause?: unknown | undefined;
+    readonly name: "FileListError";
+    constructor(kind: FileListErrorKind, message: string, cause?: unknown | undefined);
+}
+/**
+ * Validation error for invalid input parameters
+ */
+export declare class FileListValidationError extends FileListError {
+    constructor(message: string);
+}
+/**
+ * Error when S3 operations fail
+ */
+export declare class FileListS3Error extends FileListError {
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Error when metadata fetch fails (non-fatal, logged as warning)
+ */
+export declare class FileListMetadataError extends FileListError {
+    readonly key: string;
+    constructor(message: string, key: string, cause?: unknown);
+}
+/**
+ * Error when path traversal attack is detected
+ */
+export declare class FileListPathTraversalError extends FileListError {
+    constructor(message?: string);
+}
+/**
+ * Error when cross-tenant access is attempted
+ */
+export declare class FileListCrossTenantError extends FileListError {
+    constructor(message?: string);
+}
+/**
+ * Error when user doesn't have permission to access requested resources
+ */
+export declare class FileListPermissionError extends FileListError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/files/services/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../lib/files/services/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,iBAAiB,GACzB,kBAAkB,GAClB,UAAU,GACV,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,GAChB,qBAAqB,CAAC;AAE1B;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAIpB,IAAI,EAAE,iBAAiB;aAEvB,KAAK,CAAC,EAAE,OAAO;IALjC,QAAQ,CAAC,IAAI,EAAG,eAAe,CAAU;gBAGvB,IAAI,EAAE,iBAAiB,EACvC,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;aAGpC,GAAG,EAAE,MAAM;gBAD3B,OAAO,EAAE,MAAM,EACC,GAAG,EAAE,MAAM,EAC3B,KAAK,CAAC,EAAE,OAAO;CAKlB;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,aAAa;gBAC/C,OAAO,GAAE,MAAsD;CAI5E;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,OAAO,GAAE,MAA+C;CAIrE;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,OAAO,GAAE,MAAuE;CAI7F"}

package/dist/files/services/errors.js

@@ -0,0 +1,71 @@
+/**
+ * File Services Error Classes
+ */
+/**
+ * Base error class for File List Service operations
+ */
+export class FileListError extends Error {
+    constructor(kind, message, cause) {
+        super(message);
+        this.kind = kind;
+        this.cause = cause;
+        this.name = "FileListError";
+        Object.setPrototypeOf(this, FileListError.prototype);
+    }
+}
+/**
+ * Validation error for invalid input parameters
+ */
+export class FileListValidationError extends FileListError {
+    constructor(message) {
+        super("VALIDATION_ERROR", message);
+        Object.setPrototypeOf(this, FileListValidationError.prototype);
+    }
+}
+/**
+ * Error when S3 operations fail
+ */
+export class FileListS3Error extends FileListError {
+    constructor(message, cause) {
+        super("S3_ERROR", message, cause);
+        Object.setPrototypeOf(this, FileListS3Error.prototype);
+    }
+}
+/**
+ * Error when metadata fetch fails (non-fatal, logged as warning)
+ */
+export class FileListMetadataError extends FileListError {
+    constructor(message, key, cause) {
+        super("METADATA_ERROR", message, cause);
+        this.key = key;
+        Object.setPrototypeOf(this, FileListMetadataError.prototype);
+    }
+}
+/**
+ * Error when path traversal attack is detected
+ */
+export class FileListPathTraversalError extends FileListError {
+    constructor(message = "Invalid file path - path traversal detected") {
+        super("PATH_TRAVERSAL", message);
+        Object.setPrototypeOf(this, FileListPathTraversalError.prototype);
+    }
+}
+/**
+ * Error when cross-tenant access is attempted
+ */
+export class FileListCrossTenantError extends FileListError {
+    constructor(message = "File does not belong to your account") {
+        super("CROSS_TENANT_ACCESS", message);
+        Object.setPrototypeOf(this, FileListCrossTenantError.prototype);
+    }
+}
+/**
+ * Error when user doesn't have permission to access requested resources
+ */
+export class FileListPermissionError extends FileListError {
+    constructor(message = "You do not have permission to access the requested resources") {
+        super("PERMISSION_ERROR", message);
+        Object.setPrototypeOf(this, FileListPermissionError.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/files/services/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../lib/files/services/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAGtC,YACkB,IAAuB,EACvC,OAAe,EACC,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAmB;QAEvB,UAAK,GAAL,KAAK,CAAU;QALxB,SAAI,GAAG,eAAwB,CAAC;QAQvC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,aAAa;IACxD,YAAY,OAAe;QACzB,KAAK,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QACnC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChD,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAClC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,YACE,OAAe,EACC,GAAW,EAC3B,KAAe;QAEf,KAAK,CAAC,gBAAgB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAHxB,QAAG,GAAH,GAAG,CAAQ;QAI3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,aAAa;IAC3D,YAAY,UAAkB,6CAA6C;QACzE,KAAK,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,wBAAyB,SAAQ,aAAa;IACzD,YAAY,UAAkB,sCAAsC;QAClE,KAAK,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,aAAa;IACxD,YAAY,UAAkB,8DAA8D;QAC1F,KAAK,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;QACnC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/files/services/file-list/constants/file-list-messages.constants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * File List Service Error and Log Messages
+ */
+export declare const FILE_LIST_MESSAGES: {
+    readonly INVALID_TENANT_ID: "Tenant ID is required and must be a non-empty string";
+    readonly INVALID_PREFIX: "Prefix must be a string";
+    readonly INVALID_MAX_KEYS: "Max keys must be between 1 and 1000";
+    readonly METADATA_FETCH_FAILED: "Failed to fetch metadata for file";
+    readonly LISTING_FILES: "Listing files";
+    readonly LISTING_COMPLETE: "File listing complete";
+    readonly FETCHING_METADATA: "Fetching metadata for files";
+    readonly TRANSFORMING_RESULTS: "Transforming S3 results";
+};
+//# sourceMappingURL=file-list-messages.constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-list-messages.constants.d.ts","sourceRoot":"","sources":["../../../../../lib/files/services/file-list/constants/file-list-messages.constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;CAYrB,CAAC"}

package/dist/files/services/file-list/constants/file-list-messages.constants.js

@@ -0,0 +1,16 @@
+/**
+ * File List Service Error and Log Messages
+ */
+export const FILE_LIST_MESSAGES = {
+    // Error messages
+    INVALID_TENANT_ID: "Tenant ID is required and must be a non-empty string",
+    INVALID_PREFIX: "Prefix must be a string",
+    INVALID_MAX_KEYS: "Max keys must be between 1 and 1000",
+    METADATA_FETCH_FAILED: "Failed to fetch metadata for file",
+    // Log messages
+    LISTING_FILES: "Listing files",
+    LISTING_COMPLETE: "File listing complete",
+    FETCHING_METADATA: "Fetching metadata for files",
+    TRANSFORMING_RESULTS: "Transforming S3 results",
+};
+//# sourceMappingURL=file-list-messages.constants.js.map

package/dist/files/services/file-list/constants/file-list-messages.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-list-messages.constants.js","sourceRoot":"","sources":["../../../../../lib/files/services/file-list/constants/file-list-messages.constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,iBAAiB;IACjB,iBAAiB,EAAE,sDAAsD;IACzE,cAAc,EAAE,yBAAyB;IACzC,gBAAgB,EAAE,qCAAqC;IACvD,qBAAqB,EAAE,mCAAmC;IAE1D,eAAe;IACf,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,uBAAuB;IACzC,iBAAiB,EAAE,6BAA6B;IAChD,oBAAoB,EAAE,yBAAyB;CACvC,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * File List Service Constants
+ */
+/** S3 key prefix pattern for tenant-scoped files */
+export declare const TENANT_PREFIX_TEMPLATE = "tenants/{tenantId}/";
+/** Default delimiter for S3 folder grouping */
+export declare const DEFAULT_DELIMITER = "/";
+/** Default maximum keys to return per request */
+export declare const DEFAULT_MAX_KEYS = 100;
+/** Maximum allowed keys per request */
+export declare const MAX_ALLOWED_KEYS = 1000;
+/** Metadata key for original filename */
+export declare const METADATA_ORIGINAL_FILENAME = "original-filename";
+//# sourceMappingURL=file-list.constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-list.constants.d.ts","sourceRoot":"","sources":["../../../../../lib/files/services/file-list/constants/file-list.constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAE5D,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,yCAAyC;AACzC,eAAO,MAAM,0BAA0B,sBAAsB,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * File List Service Constants
+ */
+/** S3 key prefix pattern for tenant-scoped files */
+export const TENANT_PREFIX_TEMPLATE = "tenants/{tenantId}/";
+/** Default delimiter for S3 folder grouping */
+export const DEFAULT_DELIMITER = "/";
+/** Default maximum keys to return per request */
+export const DEFAULT_MAX_KEYS = 100;
+/** Maximum allowed keys per request */
+export const MAX_ALLOWED_KEYS = 1000;
+/** Metadata key for original filename */
+export const METADATA_ORIGINAL_FILENAME = "original-filename";
+//# sourceMappingURL=file-list.constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-list.constants.js","sourceRoot":"","sources":["../../../../../lib/files/services/file-list/constants/file-list.constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AAE5D,+CAA+C;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC,iDAAiD;AACjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC,uCAAuC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,yCAAyC;AACzC,MAAM,CAAC,MAAM,0BAA0B,GAAG,mBAAmB,CAAC"}

package/dist/files/services/file-list/constants/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./file-list.constants";
+export * from "./file-list-messages.constants";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../lib/files/services/file-list/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC"}

package/dist/files/services/file-list/constants/index.js

@@ -0,0 +1,3 @@
+export * from "./file-list.constants";
+export * from "./file-list-messages.constants";
+//# sourceMappingURL=index.js.map

package/dist/files/services/file-list/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../lib/files/services/file-list/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * File List Service Constants
+ */
+/** S3 key prefix pattern for tenant-scoped files */
+export declare const TENANT_PREFIX_TEMPLATE = "tenants/{tenantId}/";
+/** Default delimiter for S3 folder grouping */
+export declare const DEFAULT_DELIMITER = "/";
+/** Default maximum keys to return per request */
+export declare const DEFAULT_MAX_KEYS = 100;
+/** Maximum allowed keys per request */
+export declare const MAX_ALLOWED_KEYS = 1000;
+/** Metadata key for original filename */
+export declare const METADATA_ORIGINAL_FILENAME = "original-filename";
+/**
+ * File List Service Error and Log Messages
+ */
+export declare const FILE_LIST_MESSAGES: {
+    readonly INVALID_TENANT_ID: "Tenant ID is required and must be a non-empty string";
+    readonly INVALID_PREFIX: "Prefix must be a string";
+    readonly INVALID_MAX_KEYS: "Max keys must be between 1 and 1000";
+    readonly METADATA_FETCH_FAILED: "Failed to fetch metadata for file";
+    readonly LISTING_FILES: "Listing files";
+    readonly LISTING_COMPLETE: "File listing complete";
+    readonly FETCHING_METADATA: "Fetching metadata for files";
+    readonly TRANSFORMING_RESULTS: "Transforming S3 results";
+};
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../lib/files/services/file-list/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAE5D,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,yCAAyC;AACzC,eAAO,MAAM,0BAA0B,sBAAsB,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;CAYrB,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * File List Service Constants
+ */
+/** S3 key prefix pattern for tenant-scoped files */
+export const TENANT_PREFIX_TEMPLATE = "tenants/{tenantId}/";
+/** Default delimiter for S3 folder grouping */
+export const DEFAULT_DELIMITER = "/";
+/** Default maximum keys to return per request */
+export const DEFAULT_MAX_KEYS = 100;
+/** Maximum allowed keys per request */
+export const MAX_ALLOWED_KEYS = 1000;
+/** Metadata key for original filename */
+export const METADATA_ORIGINAL_FILENAME = "original-filename";
+/**
+ * File List Service Error and Log Messages
+ */
+export const FILE_LIST_MESSAGES = {
+    // Error messages
+    INVALID_TENANT_ID: "Tenant ID is required and must be a non-empty string",
+    INVALID_PREFIX: "Prefix must be a string",
+    INVALID_MAX_KEYS: "Max keys must be between 1 and 1000",
+    METADATA_FETCH_FAILED: "Failed to fetch metadata for file",
+    // Log messages
+    LISTING_FILES: "Listing files",
+    LISTING_COMPLETE: "File listing complete",
+    FETCHING_METADATA: "Fetching metadata for files",
+    TRANSFORMING_RESULTS: "Transforming S3 results",
+};
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../lib/files/services/file-list/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AAE5D,+CAA+C;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC,iDAAiD;AACjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC,uCAAuC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,yCAAyC;AACzC,MAAM,CAAC,MAAM,0BAA0B,GAAG,mBAAmB,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,iBAAiB;IACjB,iBAAiB,EAAE,sDAAsD;IACzE,cAAc,EAAE,yBAAyB;IACzC,gBAAgB,EAAE,qCAAqC;IACvD,qBAAqB,EAAE,mCAAmC;IAE1D,eAAe;IACf,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,uBAAuB;IACzC,iBAAiB,EAAE,6BAA6B;IAChD,oBAAoB,EAAE,yBAAyB;CACvC,CAAC"}