captify 0.1.15

package/dist/shared/utilities/file.js

@@ -0,0 +1,387 @@
+/**
+ * Formats a byte size into a human-readable string with appropriate units
+ * @param bytes - The file size in bytes (must be non-negative)
+ * @param decimals - Number of decimal places (default: 2)
+ * @returns A formatted string with size and unit (e.g., "1.50 MB", "256 KB")
+ * @throws {Error} If bytes is negative
+ *
+ * @example
+ * formatFileSize(0) // Returns "0 B"
+ * formatFileSize(1024) // Returns "1.00 KB"
+ * formatFileSize(1536) // Returns "1.50 KB"
+ * formatFileSize(1048576) // Returns "1.00 MB"
+ * formatFileSize(1048576, 0) // Returns "1 MB"
+ */
+export function formatFileSize(bytes, decimals = 2) {
+    if (bytes < 0) {
+        throw new Error("Bytes cannot be negative");
+    }
+    if (bytes === 0) {
+        return "0 B";
+    }
+    const sizes = ["B", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"];
+    const index = Math.min(sizes.length - 1, Math.floor(Math.log(bytes) / Math.log(1024)));
+    const value = (bytes / Math.pow(1024, index)).toFixed(decimals);
+    return `${value} ${sizes[index]}`;
+}
+/**
+ * Returns a human-readable label for a file type based on its media type
+ * @param mediaType - The MIME type of the file (e.g., "image/png", "application/pdf")
+ * @returns A user-friendly label for the file type
+ *
+ * @example
+ * getFileTypeLabel("image/png") // Returns "Image"
+ * getFileTypeLabel("video/mp4") // Returns "Video"
+ * getFileTypeLabel("application/pdf") // Returns "PDF"
+ * getFileTypeLabel("application/zip") // Returns "Archive"
+ */
+export function getFileTypeLabel(mediaType) {
+    const [type, subtype] = mediaType.split("/");
+    if (type === "image")
+        return "Image";
+    if (type === "video")
+        return "Video";
+    if (type === "audio")
+        return "Audio";
+    if (subtype === "pdf")
+        return "PDF";
+    if (/^application\/(x-)?(zip|tar|gzip|bzip2|xz|zstd|7z)/.test(mediaType)) {
+        return "Archive";
+    }
+    return "Document";
+}
+/**
+ * Sanitizes a filename to prevent security issues like XSS, path traversal, and invalid characters
+ * @param filename - The filename to sanitize
+ * @param maxLength - Maximum length (default: 255)
+ * @returns Sanitized filename
+ */
+export function sanitizeFilename(filename, maxLength = 255) {
+    if (!filename) {
+        return "unnamed";
+    }
+    // Remove path components (path traversal prevention)
+    let sanitized = filename.replace(/^.*[\\/]/, "");
+    // Remove control characters and other problematic characters
+    sanitized = sanitized.replace(/[\x00-\x1F\x7F<>:"|?*]/g, "");
+    // Trim whitespace
+    sanitized = sanitized.trim();
+    // Prevent leading dots (hidden files) and multiple consecutive dots
+    sanitized = sanitized.replace(/^\.+/, "").replace(/\.{2,}/g, ".");
+    // Truncate to max length while preserving extension if possible
+    if (sanitized.length > maxLength) {
+        const lastDotIndex = sanitized.lastIndexOf(".");
+        if (lastDotIndex > 0 && lastDotIndex > sanitized.length - 10) {
+            const extension = sanitized.substring(lastDotIndex);
+            const nameWithoutExt = sanitized.substring(0, lastDotIndex);
+            sanitized = nameWithoutExt.substring(0, maxLength - extension.length) + extension;
+        }
+        else {
+            sanitized = sanitized.substring(0, maxLength);
+        }
+    }
+    // Final fallback if sanitization resulted in empty string
+    return sanitized || "unnamed";
+}
+/**
+ * Sanitizes a filename for AWS Bedrock document attachments.
+ * Bedrock has strict requirements for document names:
+ * - Only alphanumeric characters, whitespace, hyphens, parentheses, and square brackets
+ * - No consecutive whitespace characters
+ * - NO PERIODS allowed (including file extensions)
+ *
+ * @param filename - The filename to sanitize
+ * @param maxLength - Maximum length (default: 255)
+ * @returns Bedrock-compatible document name (without extension)
+ *
+ * @example
+ * sanitizeFilenameForBedrock("report@2024.pdf") // Returns "report-2024"
+ * sanitizeFilenameForBedrock("my  file.pdf") // Returns "my file"
+ * sanitizeFilenameForBedrock("data#export!.xlsx") // Returns "data-export"
+ * sanitizeFilenameForBedrock("development guide.pdf") // Returns "development guide"
+ */
+export function sanitizeFilenameForBedrock(filename, maxLength = 255) {
+    if (!filename) {
+        return "unnamed";
+    }
+    // Remove path components (path traversal prevention)
+    let sanitized = filename.replace(/^.*[\\/]/, "");
+    // Remove extension - Bedrock document names cannot contain periods
+    const lastDotIndex = sanitized.lastIndexOf(".");
+    if (lastDotIndex > 0) {
+        sanitized = sanitized.substring(0, lastDotIndex);
+    }
+    // Replace disallowed characters with hyphens
+    // Allowed: alphanumeric, whitespace, hyphens, parentheses, square brackets
+    // NOT allowed: periods, underscores, special chars, etc.
+    sanitized = sanitized.replace(/[^a-zA-Z0-9\s\-()[\]]/g, "-");
+    // Replace multiple consecutive hyphens with single hyphen
+    sanitized = sanitized.replace(/-{2,}/g, "-");
+    // Replace multiple consecutive whitespace with single space
+    sanitized = sanitized.replace(/\s{2,}/g, " ");
+    // Remove leading/trailing hyphens and whitespace
+    sanitized = sanitized.replace(/^[\s-]+|[\s-]+$/g, "").trim();
+    // Truncate to max length
+    if (sanitized.length > maxLength) {
+        sanitized = sanitized.substring(0, maxLength);
+        // Clean up trailing hyphens/spaces after truncation
+        sanitized = sanitized.replace(/[\s-]+$/, "");
+    }
+    // Final fallback if sanitization resulted in empty string
+    return sanitized || "unnamed";
+}
+/**
+ * Sanitizes filenames in UI message file parts for Bedrock compatibility.
+ * Bedrock has strict filename requirements that need to be enforced before
+ * sending messages to the LLM.
+ *
+ * This function also handles duplicate filenames by appending a numeric suffix
+ * (e.g., "report", "report-2", "report-3") to ensure uniqueness across all
+ * messages in the conversation.
+ *
+ * @param messages - Array of UI messages that may contain file parts
+ * @returns Messages with sanitized and deduplicated filenames in file parts
+ *
+ * @example
+ * const sanitized = sanitizeMessagesForBedrock(messages);
+ * const modelMessages = convertToModelMessages(sanitized);
+ */
+export function sanitizeMessagesForBedrock(messages) {
+    const MAX_FILENAME_LENGTH = 255;
+    const MAX_SUFFIX_DIGITS = 6; // Conservatively reserve 6 digits (supports up to 999999 duplicates)
+    // Track all used filenames to prevent collisions
+    const usedFilenames = new Set();
+    // Track the last numeric suffix used for each (possibly truncated) base name
+    const baseNameMaxSuffix = new Map();
+    return messages.map((message) => {
+        if (!message.parts)
+            return message;
+        const sanitizedParts = message.parts.map((part) => {
+            var _a;
+            if (part.type === "file" && part.filename) {
+                const baseName = sanitizeFilenameForBedrock(part.filename);
+                // Find a unique filename by checking against all used names
+                let uniqueFilename;
+                if (!usedFilenames.has(baseName)) {
+                    // Base name is available
+                    uniqueFilename = baseName;
+                }
+                else {
+                    // Compute available space for baseName when suffix is appended
+                    // Reserve space for: "-" (1 char) + suffix digits (MAX_SUFFIX_DIGITS)
+                    const availableSpace = MAX_FILENAME_LENGTH - 1 - MAX_SUFFIX_DIGITS;
+                    // Truncate baseName if needed to ensure suffix fits within 255 chars
+                    let truncatedBase = baseName;
+                    if (truncatedBase.length > availableSpace) {
+                        truncatedBase = truncatedBase.substring(0, availableSpace);
+                        // Clean up trailing hyphens/spaces after truncation
+                        truncatedBase = truncatedBase.replace(/[\s-]+$/, "");
+                    }
+                    // Get next suffix starting from the last used suffix + 1
+                    let suffix = ((_a = baseNameMaxSuffix.get(truncatedBase)) !== null && _a !== void 0 ? _a : 0) + 1;
+                    let candidate = `${truncatedBase}-${suffix}`;
+                    // Loop until we find an unused candidate
+                    while (usedFilenames.has(candidate)) {
+                        suffix++;
+                        candidate = `${truncatedBase}-${suffix}`;
+                    }
+                    uniqueFilename = candidate;
+                    // Update the max suffix used for this truncated base name
+                    baseNameMaxSuffix.set(truncatedBase, suffix);
+                }
+                // Record the used filename
+                usedFilenames.add(uniqueFilename);
+                return Object.assign(Object.assign({}, part), { filename: uniqueFilename });
+            }
+            return part;
+        });
+        return Object.assign(Object.assign({}, message), { parts: sanitizedParts });
+    });
+}
+/**
+ * Calculate SHA-256 hash of file content.
+ *
+ * Uses the Web Crypto API to generate a unique identifier for file content.
+ * This can be used for deduplication, caching, or integrity verification.
+ *
+ * @param file - The file or blob to hash
+ * @returns A promise that resolves to a hex-encoded SHA-256 hash string
+ *
+ * @example
+ * ```typescript
+ * const file = new File(['hello'], 'test.txt');
+ * const hash = await getFileHash(file);
+ * console.log(hash); // '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824'
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Deduplication check
+ * const hash = await getFileHash(newFile);
+ * if (uploadedHashes.has(hash)) {
+ *   console.log('File already uploaded');
+ * }
+ * ```
+ */
+export async function getFileHash(file) {
+    const buffer = await file.arrayBuffer();
+    const hashBuffer = await crypto.subtle.digest("SHA-256", buffer);
+    const hashArray = Array.from(new Uint8Array(hashBuffer));
+    return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+/**
+ * Extracts the display filename from an S3 key.
+ * S3 keys typically have the format: {path}/{uuid}-{originalFilename}
+ * This function strips the UUID prefix to get the original filename.
+ *
+ * @param key - The S3 object key
+ * @param originalName - Optional original name from metadata (takes precedence if provided)
+ * @returns The display filename
+ *
+ * @example
+ * extractDisplayName("docs/550e8400-e29b-41d4-a716-446655440000-report.pdf")
+ * // Returns "report.pdf"
+ *
+ * @example
+ * extractDisplayName("docs/file.pdf", "My Report.pdf")
+ * // Returns "My Report.pdf"
+ */
+export function extractDisplayName(key, originalName) {
+    if (originalName) {
+        return originalName;
+    }
+    const keyFileName = key.split("/").pop() || key;
+    const uuidLength = 36; // UUID format: 8-4-4-4-12 = 36 chars
+    // Check if filename starts with UUID pattern (36 chars + dash)
+    if (keyFileName.length > uuidLength + 1 && keyFileName[uuidLength] === "-") {
+        return keyFileName.substring(uuidLength + 1);
+    }
+    return keyFileName;
+}
+/**
+ * Downloads a file with progress tracking using the Fetch API
+ * @param url - The URL to download from
+ * @param fileName - The filename for the downloaded file
+ * @param fileSize - Expected file size in bytes (for progress calculation)
+ * @param signal - AbortSignal for cancellation support
+ * @param onProgressUpdate - Callback for progress updates
+ */
+export async function downloadWithProgress(url, fileName, fileSize, signal, onProgressUpdate) {
+    var _a;
+    if (fileSize <= 0) {
+        throw new Error("Invalid file size: file size must be greater than 0.");
+    }
+    const response = await fetch(url, { signal });
+    if (!response.ok) {
+        throw new Error(`Download failed: ${response.status} ${response.statusText}`);
+    }
+    const reader = (_a = response.body) === null || _a === void 0 ? void 0 : _a.getReader();
+    if (!reader) {
+        throw new Error("Unable to read response body");
+    }
+    const chunks = [];
+    let receivedLength = 0;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        chunks.push(value);
+        receivedLength += value.length;
+        const rawPercentage = (receivedLength / fileSize) * 100;
+        const percentage = Math.min(100, rawPercentage);
+        onProgressUpdate(percentage, receivedLength);
+    }
+    // Create blob and trigger download
+    const blob = new Blob(chunks);
+    const blobUrl = window.URL.createObjectURL(blob);
+    const link = document.createElement("a");
+    link.href = blobUrl;
+    link.download = fileName;
+    link.style.display = "none";
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+    window.URL.revokeObjectURL(blobUrl);
+}
+/**
+ * Triggers a direct download by creating and clicking an anchor element
+ * Note: This only catches DOM manipulation errors. Browser download failures
+ * occur asynchronously and won't be caught by this function.
+ * @param url - The URL to download from
+ * @param fileName - The filename for the downloaded file
+ */
+export function triggerDirectDownload(url, fileName) {
+    try {
+        const link = document.createElement("a");
+        link.href = url;
+        link.download = fileName;
+        link.style.display = "none";
+        link.rel = "noopener noreferrer";
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        throw new Error(`Failed to trigger download: ${errorMessage}`);
+    }
+}
+/**
+ * Check if an error is an abort error (from AbortController)
+ * @param error - The error to check
+ * @returns True if the error is an abort error
+ */
+export function isAbortError(error) {
+    // DOMException with name 'AbortError' is the standard abort error
+    if (error instanceof DOMException && error.name === "AbortError") {
+        return true;
+    }
+    // Check error message for abort-related strings
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return (errorMessage.toLowerCase().includes("aborted") || errorMessage.toLowerCase().includes("abort"));
+}
+/**
+ * Check if an error is a CORS-related error
+ * @param error - The error to check
+ * @returns True if the error appears to be CORS-related
+ */
+export function isCorsError(error) {
+    // First check if this is an abort error - not a CORS error
+    if (isAbortError(error)) {
+        return false;
+    }
+    // TypeError can indicate CORS issues (e.g., "Failed to fetch")
+    if (error instanceof TypeError) {
+        return true;
+    }
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return (errorMessage.toLowerCase().includes("cors") || errorMessage.toLowerCase().includes("network"));
+}
+/**
+ * Maps download errors to user-friendly messages
+ * @param error - The error to map
+ * @returns A user-friendly error message
+ */
+export function mapDownloadErrorMessage(error) {
+    const message = error.message;
+    if (message.includes("403") || message.includes("Access denied")) {
+        return "You don't have permission to download this file.";
+    }
+    if (message.includes("404") || message.includes("not found")) {
+        return "File not found. It may have been deleted.";
+    }
+    if (message.includes("expired")) {
+        return "Download link expired. Please try again.";
+    }
+    if (message.includes("authenticated")) {
+        return "Please log in to download files.";
+    }
+    if (message.includes("tenant")) {
+        return "Access denied: File belongs to a different account.";
+    }
+    if (message.includes("aborted") || message.includes("AbortError")) {
+        return "Download was cancelled.";
+    }
+    return "Download failed. Please try again.";
+}
+//# sourceMappingURL=file.js.map

package/dist/shared/utilities/file.js.map

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

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

@@ -0,0 +1,15 @@
+export * from "./api";
+export * from "./cn";
+export * from "./date-utilities";
+export * from "./fetch";
+export * from "./file";
+export * from "./file-icons";
+export * from "./file-server-utilities";
+export * from "./invariant";
+export * from "./number";
+export * from "./phone";
+export * from "./storage-utilities";
+export * from "./string-utilities";
+export * from "./url";
+export * from "./promise";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/shared/utilities/index.ts"],"names":[],"mappings":"AACA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,yCAAyC,CAAC;AACxD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC"}

package/dist/shared/utilities/index.js

@@ -0,0 +1,16 @@
+// Export all utility functions here
+export * from "./api";
+export * from "./cn";
+export * from "./date-utilities";
+export * from "./fetch";
+export * from "./file";
+export * from "./file-icons";
+export * from "./file-server-utilities";
+export * from "./invariant";
+export * from "./number";
+export * from "./phone";
+export * from "./storage-utilities";
+export * from "./string-utilities";
+export * from "./url";
+export * from "./promise";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/shared/utilities/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,yCAAyC,CAAC;AACxD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC"}

package/dist/shared/utilities/invariant.d.ts

@@ -0,0 +1,2 @@
+export declare function invariant<T>(condition: T, message?: string): asserts condition is NonNullable<T>;
+//# sourceMappingURL=invariant.d.ts.map

package/dist/shared/utilities/invariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../../../lib/shared/utilities/invariant.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,CAAC,EACzB,SAAS,EAAE,CAAC,EACZ,OAAO,SAAwB,GAC9B,OAAO,CAAC,SAAS,IAAI,WAAW,CAAC,CAAC,CAAC,CAIrC"}

package/dist/shared/utilities/invariant.js

@@ -0,0 +1,6 @@
+export function invariant(condition, message = "Invariant violation") {
+    if (!condition) {
+        throw new Error(message);
+    }
+}
+//# sourceMappingURL=invariant.js.map

package/dist/shared/utilities/invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../../../lib/shared/utilities/invariant.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CACvB,SAAY,EACZ,OAAO,GAAG,qBAAqB;IAE/B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/shared/utilities/number.d.ts

@@ -0,0 +1,3 @@
+export declare const formatPrice: (price: number) => string;
+export declare const formatNumber: (num: number) => string;
+//# sourceMappingURL=number.d.ts.map

package/dist/shared/utilities/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../lib/shared/utilities/number.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,WAExC,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,WAEvC,CAAC"}

package/dist/shared/utilities/number.js

@@ -0,0 +1,7 @@
+export const formatPrice = (price) => {
+    return `$${price.toFixed(2)}`;
+};
+export const formatNumber = (num) => {
+    return new Intl.NumberFormat("en-US").format(num);
+};
+//# sourceMappingURL=number.js.map

package/dist/shared/utilities/number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../../../lib/shared/utilities/number.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,EAAE;IAC3C,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,EAAE;IAC1C,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACpD,CAAC,CAAC"}

package/dist/shared/utilities/phone.d.ts

@@ -0,0 +1,30 @@
+/**
+ * US phone number utilities for formatting and validation
+ */
+/** Expected length for US phone numbers (excluding country code) */
+export declare const US_PHONE_LENGTH = 10;
+/**
+ * Format US phone number for AWS Cognito (E.164 format)
+ * Adds +1 prefix for US numbers
+ *
+ * @param phone - 10-digit US phone number (cleaned or with formatting)
+ * @returns Formatted phone number with +1 country code
+ *
+ * @example
+ * formatUSPhoneForCognito("5551234567") // "+15551234567"
+ * formatUSPhoneForCognito("(555) 123-4567") // "+15551234567"
+ */
+export declare function formatUSPhoneForCognito(phone: string): string;
+/**
+ * Clean phone number by removing all non-digit characters
+ *
+ * @param phone - Phone number with potential formatting
+ * @returns Phone number with only digits
+ *
+ * @example
+ * cleanPhoneNumber("(555) 123-4567") // "5551234567"
+ * cleanPhoneNumber("555-123-4567") // "5551234567"
+ * cleanPhoneNumber("+1 555 123 4567") // "15551234567"
+ */
+export declare function cleanPhoneNumber(phone: string): string;
+//# sourceMappingURL=phone.d.ts.map

package/dist/shared/utilities/phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.d.ts","sourceRoot":"","sources":["../../../lib/shared/utilities/phone.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oEAAoE;AACpE,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/shared/utilities/phone.js

@@ -0,0 +1,35 @@
+/**
+ * US phone number utilities for formatting and validation
+ */
+/** Expected length for US phone numbers (excluding country code) */
+export const US_PHONE_LENGTH = 10;
+/**
+ * Format US phone number for AWS Cognito (E.164 format)
+ * Adds +1 prefix for US numbers
+ *
+ * @param phone - 10-digit US phone number (cleaned or with formatting)
+ * @returns Formatted phone number with +1 country code
+ *
+ * @example
+ * formatUSPhoneForCognito("5551234567") // "+15551234567"
+ * formatUSPhoneForCognito("(555) 123-4567") // "+15551234567"
+ */
+export function formatUSPhoneForCognito(phone) {
+    const cleaned = cleanPhoneNumber(phone);
+    return `+1${cleaned}`;
+}
+/**
+ * Clean phone number by removing all non-digit characters
+ *
+ * @param phone - Phone number with potential formatting
+ * @returns Phone number with only digits
+ *
+ * @example
+ * cleanPhoneNumber("(555) 123-4567") // "5551234567"
+ * cleanPhoneNumber("555-123-4567") // "5551234567"
+ * cleanPhoneNumber("+1 555 123 4567") // "15551234567"
+ */
+export function cleanPhoneNumber(phone) {
+    return phone.replace(/[^\d]/g, "");
+}
+//# sourceMappingURL=phone.js.map

package/dist/shared/utilities/phone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.js","sourceRoot":"","sources":["../../../lib/shared/utilities/phone.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oEAAoE;AACpE,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,KAAK,OAAO,EAAE,CAAC;AACxB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/dist/shared/utilities/promise.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Default concurrency limit for parallel promise execution.
+ * Set to 10 to balance throughput with resource usage and avoid
+ * overwhelming external services (e.g., S3 rate limits).
+ */
+export declare const DEFAULT_CONCURRENCY_LIMIT = 10;
+/**
+ * Execute an array of async operations with a concurrency limit.
+ *
+ * Unlike Promise.all which executes all promises simultaneously,
+ * this function limits the number of concurrent executions to prevent
+ * resource exhaustion and rate limiting issues.
+ *
+ * @param items - Array of items to process
+ * @param limit - Maximum number of concurrent operations (default to DEFAULT_CONCURRENCY_LIMIT when omitted or invalid)
+ * @param fn - Async function to execute for each item
+ * @returns Array of results in the same order as input items
+ *
+ * @example
+ * ```typescript
+ * const results = await promiseAllWithLimit(
+ *   files,
+ *   20,
+ *   async (file) => fetchMetadata(file)
+ * );
+ * ```
+ */
+export declare function promiseAllWithLimit<T, R>(items: T[], limit: number | undefined, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;
+//# sourceMappingURL=promise.d.ts.map

package/dist/shared/utilities/promise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.d.ts","sourceRoot":"","sources":["../../../lib/shared/utilities/promise.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAC5C,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,YAA4B,EACzC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,CAAC,EAAE,CAAC,CA0Bd"}

package/dist/shared/utilities/promise.js

@@ -0,0 +1,51 @@
+/**
+ * Default concurrency limit for parallel promise execution.
+ * Set to 10 to balance throughput with resource usage and avoid
+ * overwhelming external services (e.g., S3 rate limits).
+ */
+export const DEFAULT_CONCURRENCY_LIMIT = 10;
+/**
+ * Execute an array of async operations with a concurrency limit.
+ *
+ * Unlike Promise.all which executes all promises simultaneously,
+ * this function limits the number of concurrent executions to prevent
+ * resource exhaustion and rate limiting issues.
+ *
+ * @param items - Array of items to process
+ * @param limit - Maximum number of concurrent operations (default to DEFAULT_CONCURRENCY_LIMIT when omitted or invalid)
+ * @param fn - Async function to execute for each item
+ * @returns Array of results in the same order as input items
+ *
+ * @example
+ * ```typescript
+ * const results = await promiseAllWithLimit(
+ *   files,
+ *   20,
+ *   async (file) => fetchMetadata(file)
+ * );
+ * ```
+ */
+export async function promiseAllWithLimit(items, limit = DEFAULT_CONCURRENCY_LIMIT, fn) {
+    if (items.length === 0) {
+        return [];
+    }
+    const normalizedLimit = Number.isFinite(limit) ? limit : DEFAULT_CONCURRENCY_LIMIT;
+    const effectiveLimit = Math.max(1, Math.min(normalizedLimit, items.length));
+    const results = new Array(items.length);
+    let currentIndex = 0;
+    async function executeNext() {
+        while (currentIndex < items.length) {
+            const index = currentIndex++;
+            const item = items[index];
+            results[index] = await fn(item, index);
+        }
+    }
+    // Start `effectiveLimit` number of worker "threads"
+    const workers = [];
+    for (let i = 0; i < effectiveLimit; i++) {
+        workers.push(executeNext());
+    }
+    await Promise.all(workers);
+    return results;
+}
+//# sourceMappingURL=promise.js.map

package/dist/shared/utilities/promise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.js","sourceRoot":"","sources":["../../../lib/shared/utilities/promise.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAU,EACV,QAAgB,yBAAyB,EACzC,EAA0C;IAE1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,yBAAyB,CAAC;IACnF,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,UAAU,WAAW;QACxB,OAAO,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}