@wildo-ai/saas-backend-lib 1.0.1

package/dist/esm/files/utils/file-field-schema-path.backend.utils.js

@@ -0,0 +1,251 @@
+import { getFileMetadata, getZodDefArrayProperty, getZodDefProperty, getZodDefStringProperty, getZodObjectShape, isFileSchema, isZodArray, isZodObject, unwrapSchema, } from '@wildo-ai/zod-decorators';
+export class IncompatibleFileFieldSchemaPathError extends Error {
+    fieldName;
+    existingMetadata;
+    conflictingMetadata;
+    constructor(fieldName, existingMetadata, conflictingMetadata) {
+        super(`Incompatible z_file() metadata detected for canonical file field path "${fieldName}".`);
+        this.fieldName = fieldName;
+        this.existingMetadata = existingMetadata;
+        this.conflictingMetadata = conflictingMetadata;
+        this.name = 'IncompatibleFileFieldSchemaPathError';
+    }
+}
+export class UnsupportedPlainUnionFileFieldSchemaError extends Error {
+    fieldName;
+    constructor(fieldName) {
+        super(`Unsupported z.union() file field schema detected at "${fieldName}". File fields inside non-discriminated unions must use z.discriminatedUnion().`);
+        this.fieldName = fieldName;
+        this.name = 'UnsupportedPlainUnionFileFieldSchemaError';
+    }
+}
+function getDiscriminatedUnionObjectOptions(schema) {
+    if (getZodDefStringProperty(schema, 'discriminator') === undefined) {
+        return [];
+    }
+    const options = getZodDefArrayProperty(schema, 'options');
+    if (!options?.length) {
+        return [];
+    }
+    return options.filter((option) => isZodObject(option));
+}
+function getPlainUnionObjectOptions(schema) {
+    if (getZodDefStringProperty(schema, 'discriminator') !== undefined) {
+        return [];
+    }
+    const options = getZodDefArrayProperty(schema, 'options');
+    if (!options?.length) {
+        return [];
+    }
+    return options.filter((option) => isZodObject(option));
+}
+function normalizeMetadataForComparison(value) {
+    if (Array.isArray(value)) {
+        return value.map(normalizeMetadataForComparison);
+    }
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, childValue]) => [key, normalizeMetadataForComparison(childValue)]));
+    }
+    return value;
+}
+function areFileMetadataCompatible(left, right) {
+    return JSON.stringify(normalizeMetadataForComparison(left))
+        === JSON.stringify(normalizeMetadataForComparison(right));
+}
+function mergeCompatibleFileFieldMetadata(groups) {
+    const merged = new Map();
+    for (const group of groups) {
+        for (const entry of group) {
+            const existing = merged.get(entry.fieldName);
+            if (!existing) {
+                merged.set(entry.fieldName, entry);
+                continue;
+            }
+            if (!areFileMetadataCompatible(existing.fileMetadata, entry.fileMetadata)) {
+                throw new IncompatibleFileFieldSchemaPathError(entry.fieldName, existing.fileMetadata, entry.fileMetadata);
+            }
+        }
+    }
+    return Array.from(merged.values()).sort((left, right) => left.fieldName.localeCompare(right.fieldName));
+}
+export function collectFileFieldSchemaMetadata(schema, pathPrefix = '') {
+    if (!schema) {
+        return [];
+    }
+    const unwrappedSchema = unwrapSchema(schema);
+    if (isFileSchema(unwrappedSchema)) {
+        const fileMetadata = getFileMetadata(unwrappedSchema);
+        if (!fileMetadata?.isFile || !pathPrefix) {
+            return [];
+        }
+        return [
+            {
+                fieldName: pathPrefix,
+                fileMetadata,
+            },
+        ];
+    }
+    if (isZodArray(unwrappedSchema)) {
+        const elementSchema = getZodDefProperty(unwrappedSchema, 'element');
+        return collectFileFieldSchemaMetadata(elementSchema, pathPrefix);
+    }
+    if (isZodObject(unwrappedSchema)) {
+        const shape = getZodObjectShape(unwrappedSchema);
+        return Object.entries(shape).flatMap(([fieldName, fieldSchema]) => {
+            const nextPath = pathPrefix ? `${pathPrefix}.${fieldName}` : fieldName;
+            return collectFileFieldSchemaMetadata(fieldSchema, nextPath);
+        });
+    }
+    const unionOptions = getDiscriminatedUnionObjectOptions(unwrappedSchema);
+    if (unionOptions.length > 0) {
+        return mergeCompatibleFileFieldMetadata(unionOptions.map((option) => collectFileFieldSchemaMetadata(option, pathPrefix)));
+    }
+    const plainUnionOptions = getPlainUnionObjectOptions(unwrappedSchema);
+    if (plainUnionOptions.length > 0) {
+        const plainUnionMetadata = plainUnionOptions.map((option) => collectFileFieldSchemaMetadata(option, pathPrefix));
+        if (plainUnionMetadata.some((entries) => entries.length > 0)) {
+            throw new UnsupportedPlainUnionFileFieldSchemaError(pathPrefix || '<root>');
+        }
+    }
+    return [];
+}
+export function getFileFieldSchemaMetadataByPath(schema, fieldName) {
+    return collectFileFieldSchemaMetadata(schema).find((entry) => entry.fieldName === fieldName);
+}
+function getOwnerStableId(owner) {
+    if (!owner || typeof owner !== 'object') {
+        return undefined;
+    }
+    const candidateId = owner.id ?? owner._id;
+    return typeof candidateId === 'string' && candidateId.trim() !== ''
+        ? candidateId
+        : undefined;
+}
+export function enumerateFileFieldValueOccurrences(data, canonicalFieldPath) {
+    if (!canonicalFieldPath.trim()) {
+        return [];
+    }
+    const tokens = canonicalFieldPath.split('.').filter(Boolean);
+    if (tokens.length === 0) {
+        return [];
+    }
+    const occurrences = [];
+    const visit = (current, tokenIndex, runtimePath) => {
+        if (current === null || current === undefined) {
+            return;
+        }
+        if (Array.isArray(current)) {
+            current.forEach((item, index) => {
+                const nextRuntimePath = runtimePath ? `${runtimePath}[${index}]` : `[${index}]`;
+                visit(item, tokenIndex, nextRuntimePath);
+            });
+            return;
+        }
+        if (typeof current !== 'object') {
+            return;
+        }
+        const token = tokens[tokenIndex];
+        const nextValue = current[token];
+        const nextRuntimePath = runtimePath ? `${runtimePath}.${token}` : token;
+        if (tokenIndex === tokens.length - 1) {
+            if (nextValue !== null && nextValue !== undefined) {
+                occurrences.push({
+                    canonicalFieldPath,
+                    runtimeFieldPath: nextRuntimePath,
+                    ownerRuntimePath: runtimePath || undefined,
+                    ownerStableId: getOwnerStableId(current),
+                    value: nextValue,
+                });
+            }
+            return;
+        }
+        visit(nextValue, tokenIndex + 1, nextRuntimePath);
+    };
+    visit(data, 0, '');
+    return occurrences;
+}
+export function hasExplicitCanonicalFieldMutation(patchData, canonicalFieldPath) {
+    if (!patchData
+        || typeof patchData !== 'object'
+        || !canonicalFieldPath.trim()) {
+        return false;
+    }
+    const tokens = canonicalFieldPath.split('.').filter(Boolean);
+    if (tokens.length === 0) {
+        return false;
+    }
+    const visit = (current, tokenIndex) => {
+        if (Array.isArray(current)) {
+            return true;
+        }
+        if (!current || typeof current !== 'object') {
+            return true;
+        }
+        const token = tokens[tokenIndex];
+        if (!Object.prototype.hasOwnProperty.call(current, token)) {
+            return false;
+        }
+        if (tokenIndex === tokens.length - 1) {
+            return true;
+        }
+        return visit(current[token], tokenIndex + 1);
+    };
+    return visit(patchData, 0);
+}
+export function mergeEffectiveResourceState(existingResource, patchData) {
+    if (patchData === undefined) {
+        return existingResource;
+    }
+    if (patchData === null || existingResource === null) {
+        return patchData;
+    }
+    if (Array.isArray(patchData)) {
+        return patchData;
+    }
+    if (typeof patchData !== 'object') {
+        return patchData;
+    }
+    if (Array.isArray(existingResource) || typeof existingResource !== 'object') {
+        return patchData;
+    }
+    const existingRecord = existingResource;
+    const patchRecord = patchData;
+    const mergedEntries = new Map(Object.entries(existingRecord));
+    for (const [key, value] of Object.entries(patchRecord)) {
+        mergedEntries.set(key, mergeEffectiveResourceState(existingRecord[key], value));
+    }
+    return Object.fromEntries(mergedEntries);
+}
+export function setValueAtRuntimePath(target, runtimePath, value) {
+    const normalizedSegments = runtimePath
+        .replace(/\[(\d+)\]/g, '.$1')
+        .split('.')
+        .filter(Boolean);
+    if (normalizedSegments.length === 0) {
+        return;
+    }
+    let current = target;
+    for (let index = 0; index < normalizedSegments.length - 1; index += 1) {
+        const segment = normalizedSegments[index];
+        if (Array.isArray(current)) {
+            current = current[Number(segment)];
+            continue;
+        }
+        if (!current || typeof current !== 'object') {
+            return;
+        }
+        current = current[segment];
+    }
+    const finalSegment = normalizedSegments[normalizedSegments.length - 1];
+    if (Array.isArray(current)) {
+        current[Number(finalSegment)] = value;
+        return;
+    }
+    if (!current || typeof current !== 'object') {
+        return;
+    }
+    current[finalSegment] = value;
+}
+//# sourceMappingURL=file-field-schema-path.backend.utils.js.map

package/dist/esm/files/utils/file-field-schema-path.backend.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-field-schema-path.backend.utils.js","sourceRoot":"","sources":["../../../../src/files/utils/file-field-schema-path.backend.utils.ts"],"names":[],"mappings":"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"}

package/dist/esm/files/utils/file-upload.utils.d.ts

@@ -0,0 +1,74 @@
+/**
+ * File Upload Utilities
+ *
+ * Shared utilities for file upload operations, including:
+ * - Temp directory management
+ * - Multer configuration
+ * - Filename generation and sanitization
+ * - Content-Disposition header setting
+ */
+import { Response } from 'express';
+import multer from 'multer';
+import type { LoggerService } from '../../monitoring/logger/services/logger.service.js';
+/**
+ * Get temp directory path from environment or use default
+ *
+ * @returns Temp directory path
+ */
+export declare function getTempDirectory(): string;
+/**
+ * Ensure temp directory exists, creating it if necessary
+ *
+ * @param tempDir - Temp directory path (defaults to getTempDirectory())
+ * @param logger - Optional logger for debug messages
+ */
+export declare function ensureTempDirectoryExists(tempDir?: string, logger?: LoggerService): void;
+/**
+ * Generate unique suffix for filenames to prevent collisions
+ *
+ * Format: {timestamp}-{randomNumber}
+ *
+ * @returns Unique suffix string
+ */
+export declare function generateUniqueFileSuffix(): string;
+/**
+ * Sanitize filename for use in temp file paths
+ *
+ * This is a simpler sanitization than sanitizeFilename() (which is for HTTP headers).
+ * For temp files, we only need to prevent path traversal and ensure safe characters.
+ *
+ * @param filename - Original filename
+ * @returns Sanitized filename safe for temp file paths
+ */
+export declare function sanitizeTempFilename(filename: string): string;
+/**
+ * Options for Multer upload configuration
+ */
+export interface MulterConfigOptions {
+    /** Temp directory path (defaults to getTempDirectory()) */
+    tempDir?: string;
+    /** Maximum file size in bytes (defaults to DEFAULT_MAX_FILE_SIZE) */
+    maxFileSize?: number;
+    /** Optional logger for debug messages */
+    logger?: LoggerService;
+}
+/**
+ * Create Multer upload configuration with disk storage
+ *
+ * Files are written to temp directory, then streamed to storage.
+ * This enables true streaming for large files without OOM risk.
+ *
+ * @param options - Configuration options
+ * @returns Configured Multer instance
+ */
+export declare function createMulterUploadConfig(options?: MulterConfigOptions): multer.Multer;
+/**
+ * Set Content-Disposition header for file downloads
+ *
+ * Sanitizes filename and encodes it properly for HTTP headers.
+ *
+ * @param res - Express response object
+ * @param filename - Filename to use in header
+ */
+export declare function setContentDispositionHeader(res: Response, filename: string): void;
+//# sourceMappingURL=file-upload.utils.d.ts.map

package/dist/esm/files/utils/file-upload.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-upload.utils.d.ts","sourceRoot":"","sources":["../../../../src/files/utils/file-upload.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAQlG;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CASxF;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY7D;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAAC,MAAM,CAwBzF;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CASjF"}

package/dist/esm/files/utils/file-upload.utils.js

@@ -0,0 +1,116 @@
+/**
+ * File Upload Utilities
+ *
+ * Shared utilities for file upload operations, including:
+ * - Temp directory management
+ * - Multer configuration
+ * - Filename generation and sanitization
+ * - Content-Disposition header setting
+ */
+import multer from 'multer';
+import fs from 'fs';
+import { DEFAULT_MAX_FILE_SIZE, resolveConfiguredMaxFileSize, sanitizeFilename } from './file-validation.utils.js';
+/**
+ * Default temp directory path
+ */
+const DEFAULT_TEMP_DIR = '/tmp/wildo-uploads';
+/**
+ * Get temp directory path from environment or use default
+ *
+ * @returns Temp directory path
+ */
+export function getTempDirectory() {
+    return process.env.TEMP_DIR || DEFAULT_TEMP_DIR;
+}
+/**
+ * Ensure temp directory exists, creating it if necessary
+ *
+ * @param tempDir - Temp directory path (defaults to getTempDirectory())
+ * @param logger - Optional logger for debug messages
+ */
+export function ensureTempDirectoryExists(tempDir, logger) {
+    const dir = tempDir || getTempDirectory();
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+        if (logger) {
+            logger.debugByType('FileUploadUtils')('Created temp directory for file uploads', { tempDir: dir });
+        }
+    }
+}
+/**
+ * Generate unique suffix for filenames to prevent collisions
+ *
+ * Format: {timestamp}-{randomNumber}
+ *
+ * @returns Unique suffix string
+ */
+export function generateUniqueFileSuffix() {
+    return `${Date.now()}-${Math.round(Math.random() * 1E9)}`;
+}
+/**
+ * Sanitize filename for use in temp file paths
+ *
+ * This is a simpler sanitization than sanitizeFilename() (which is for HTTP headers).
+ * For temp files, we only need to prevent path traversal and ensure safe characters.
+ *
+ * @param filename - Original filename
+ * @returns Sanitized filename safe for temp file paths
+ */
+export function sanitizeTempFilename(filename) {
+    if (!filename || typeof filename !== 'string') {
+        return 'file';
+    }
+    // Replace path separators with underscore
+    // Replace special chars (except dots and hyphens) with underscore
+    const sanitized = filename
+        .replace(/[/\\]/g, '_') // Replace path separators
+        .replace(/[^\w.\-]/g, '_'); // Replace special chars (keep alphanumeric, dots, hyphens)
+    return sanitized || 'file';
+}
+/**
+ * Create Multer upload configuration with disk storage
+ *
+ * Files are written to temp directory, then streamed to storage.
+ * This enables true streaming for large files without OOM risk.
+ *
+ * @param options - Configuration options
+ * @returns Configured Multer instance
+ */
+export function createMulterUploadConfig(options = {}) {
+    const tempDir = options.tempDir || getTempDirectory();
+    const maxFileSize = resolveConfiguredMaxFileSize(options.maxFileSize ?? DEFAULT_MAX_FILE_SIZE);
+    // Ensure temp directory exists
+    ensureTempDirectoryExists(tempDir, options.logger);
+    return multer({
+        storage: multer.diskStorage({
+            destination: (req, file, cb) => {
+                cb(null, tempDir);
+            },
+            filename: (req, file, cb) => {
+                // Generate unique filename to prevent collisions
+                const uniqueSuffix = generateUniqueFileSuffix();
+                // Sanitize original filename to prevent path traversal
+                const sanitizedOriginalName = sanitizeTempFilename(file.originalname || 'file');
+                cb(null, `upload-${uniqueSuffix}-${sanitizedOriginalName}`);
+            }
+        }),
+        limits: {
+            fileSize: maxFileSize,
+        },
+    });
+}
+/**
+ * Set Content-Disposition header for file downloads
+ *
+ * Sanitizes filename and encodes it properly for HTTP headers.
+ *
+ * @param res - Express response object
+ * @param filename - Filename to use in header
+ */
+export function setContentDispositionHeader(res, filename) {
+    // Sanitize filename for HTTP headers (removes control chars, quotes, etc.)
+    const sanitized = sanitizeFilename(filename);
+    // Set Content-Disposition header with properly encoded filename
+    res.setHeader('Content-Disposition', `attachment; filename="${encodeURIComponent(sanitized)}"`);
+}
+//# sourceMappingURL=file-upload.utils.js.map

package/dist/esm/files/utils/file-upload.utils.js.map

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

package/dist/esm/files/utils/file-uploader.utils.d.ts

@@ -0,0 +1,15 @@
+import { FileUploaderEntityType } from '@wildo-ai/saas-models';
+import type { ExecutionContext } from '../../runtime/models/execution-context.backend.schemas.js';
+export interface FileUploaderPrincipal {
+    uploadedBy: string;
+    uploadedByEntityType: FileUploaderEntityType;
+}
+/**
+ * Derive the concrete uploader principal from the execution context.
+ *
+ * File ownership is intentionally stored as a lightweight raw id + entity type
+ * pair. We do not resolve related entities here; callers can hydrate richer
+ * display data separately when needed.
+ */
+export declare function resolveFileUploaderPrincipal(executionContext: ExecutionContext<any>): FileUploaderPrincipal | undefined;
+//# sourceMappingURL=file-uploader.utils.d.ts.map

package/dist/esm/files/utils/file-uploader.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-uploader.utils.d.ts","sourceRoot":"","sources":["../../../../src/files/utils/file-uploader.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qEAAqE,CAAC;AAE5G,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,sBAAsB,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,CAAC,GACtC,qBAAqB,GAAG,SAAS,CA2CnC"}

package/dist/esm/files/utils/file-uploader.utils.js

@@ -0,0 +1,47 @@
+import { ExecutionContext_ExecutionType, FileUploaderEntityType, } from '@wildo-ai/saas-models';
+/**
+ * Derive the concrete uploader principal from the execution context.
+ *
+ * File ownership is intentionally stored as a lightweight raw id + entity type
+ * pair. We do not resolve related entities here; callers can hydrate richer
+ * display data separately when needed.
+ */
+export function resolveFileUploaderPrincipal(executionContext) {
+    const initiatorIds = executionContext.initiatorIds;
+    if (!initiatorIds) {
+        return undefined;
+    }
+    switch (executionContext.executionType) {
+        case ExecutionContext_ExecutionType.USER_REQUEST:
+            return initiatorIds.userId
+                ? {
+                    uploadedBy: initiatorIds.userId,
+                    uploadedByEntityType: FileUploaderEntityType.USER,
+                }
+                : undefined;
+        case ExecutionContext_ExecutionType.ANONYMOUS_SESSION:
+            return initiatorIds.anonymousUserId
+                ? {
+                    uploadedBy: initiatorIds.anonymousUserId,
+                    uploadedByEntityType: FileUploaderEntityType.ANONYMOUS_USER,
+                }
+                : undefined;
+        case ExecutionContext_ExecutionType.ORG_API_KEY:
+            return initiatorIds.organizationApiKeyId
+                ? {
+                    uploadedBy: initiatorIds.organizationApiKeyId,
+                    uploadedByEntityType: FileUploaderEntityType.ORGANIZATION_API_KEY,
+                }
+                : undefined;
+        case ExecutionContext_ExecutionType.APP_API_KEY:
+            return initiatorIds.applicationApiKeyId
+                ? {
+                    uploadedBy: initiatorIds.applicationApiKeyId,
+                    uploadedByEntityType: FileUploaderEntityType.APPLICATION_API_KEY,
+                }
+                : undefined;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=file-uploader.utils.js.map

package/dist/esm/files/utils/file-uploader.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-uploader.utils.js","sourceRoot":"","sources":["../../../../src/files/utils/file-uploader.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAS/B;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAC1C,gBAAuC;IAEvC,MAAM,YAAY,GAAG,gBAAgB,CAAC,YAAY,CAAC;IAEnD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,gBAAgB,CAAC,aAAa,EAAE,CAAC;QACvC,KAAK,8BAA8B,CAAC,YAAY;YAC9C,OAAO,YAAY,CAAC,MAAM;gBACxB,CAAC,CAAC;oBACE,UAAU,EAAE,YAAY,CAAC,MAAM;oBAC/B,oBAAoB,EAAE,sBAAsB,CAAC,IAAI;iBAClD;gBACH,CAAC,CAAC,SAAS,CAAC;QAEhB,KAAK,8BAA8B,CAAC,iBAAiB;YACnD,OAAO,YAAY,CAAC,eAAe;gBACjC,CAAC,CAAC;oBACE,UAAU,EAAE,YAAY,CAAC,eAAe;oBACxC,oBAAoB,EAAE,sBAAsB,CAAC,cAAc;iBAC5D;gBACH,CAAC,CAAC,SAAS,CAAC;QAEhB,KAAK,8BAA8B,CAAC,WAAW;YAC7C,OAAO,YAAY,CAAC,oBAAoB;gBACtC,CAAC,CAAC;oBACE,UAAU,EAAE,YAAY,CAAC,oBAAoB;oBAC7C,oBAAoB,EAAE,sBAAsB,CAAC,oBAAoB;iBAClE;gBACH,CAAC,CAAC,SAAS,CAAC;QAEhB,KAAK,8BAA8B,CAAC,WAAW;YAC7C,OAAO,YAAY,CAAC,mBAAmB;gBACrC,CAAC,CAAC;oBACE,UAAU,EAAE,YAAY,CAAC,mBAAmB;oBAC5C,oBAAoB,EAAE,sBAAsB,CAAC,mBAAmB;iBACjE;gBACH,CAAC,CAAC,SAAS,CAAC;QAEhB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/esm/files/utils/file-validation.utils.d.ts

@@ -0,0 +1,111 @@
+/**
+ * File Validation Utilities
+ *
+ * Centralized validation functions for file-related inputs.
+ * All validation functions throw WildoError_Backend with VALIDATION error type.
+ */
+import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
+import { ExecutionContext } from '../../runtime/models/execution-context.backend.schemas.js';
+/**
+ * Maximum file size: 100MB (default, can be overridden via app-configuration)
+ *
+ * This is the platform-wide default maximum file size.
+ * Individual file constraints can be more restrictive (see DEFAULT_FILE_CONSTRAINT in file-constraint.types.ts).
+ * Applications can override this via app-configuration.storage.maxFileSize.
+ */
+export declare const DEFAULT_MAX_FILE_SIZE: number;
+/**
+ * Resolve the effective max file size from app configuration.
+ *
+ * The runtime config is the source of truth when present, but file-entry points
+ * still need a defensive fallback for tests and early bootstrap seams that may
+ * not hydrate storage config.
+ */
+export declare function resolveConfiguredMaxFileSize(configuredMaxFileSize?: number | null): number;
+/**
+ * Validate fileId format (MongoDB ObjectId or UUID)
+ *
+ * Supports both:
+ * - MongoDB ObjectId: 24 hexadecimal characters
+ * - PostgreSQL UUID: 36 characters with dashes (8-4-4-4-12)
+ *
+ * @param fileId - The file ID to validate
+ * @param errorBuilder - Error builder service for creating errors
+ * @param executionContext - Optional execution context for error handling
+ * @param fieldName - Optional field name for error messages (defaults to 'fileId')
+ * @returns True if valid (never reached if validation fails - function throws)
+ * @throws WildoError_Backend if validation fails
+ *
+ * @note Returns `boolean` for consistency with `validateResourceId` pattern,
+ *       but return value is never used (function throws on error)
+ */
+export declare function validateFileId(fileId: unknown, errorBuilder: ErrorBuilderBackendService, executionContext?: ExecutionContext<any>, fieldName?: string): boolean;
+/**
+ * Validate appId format (alphanumeric + underscore/hyphen, no path separators)
+ *
+ * @param appId - The app ID to validate
+ * @param errorBuilder - Error builder service for creating errors
+ * @param executionContext - Optional execution context for error handling
+ * @param fieldName - Optional field name for error messages (defaults to 'appId')
+ * @returns True if valid, throws WildoError_Backend if invalid
+ * @throws WildoError_Backend if validation fails
+ */
+export declare function validateAppId(appId: unknown, errorBuilder: ErrorBuilderBackendService, executionContext?: ExecutionContext<any>, fieldName?: string): boolean;
+/**
+ * Validate resourceId format (MongoDB ObjectId)
+ * Reuses validateFileId logic since both are ObjectIds
+ */
+export declare function validateResourceId(resourceId: unknown, errorBuilder: ErrorBuilderBackendService, executionContext?: ExecutionContext<any>, fieldName?: string): boolean;
+/**
+ * Validate organizationId format (MongoDB ObjectId)
+ * Reuses validateFileId logic since both are ObjectIds
+ */
+export declare function validateOrganizationId(organizationId: unknown, errorBuilder: ErrorBuilderBackendService, executionContext?: ExecutionContext<any>, fieldName?: string): boolean;
+/**
+ * Validate resourceType (should be a valid ResourceType enum value)
+ * Note: This is a basic check - full validation requires ResourceRegistry
+ */
+export declare function validateResourceType(resourceType: unknown, errorBuilder: ErrorBuilderBackendService, executionContext?: ExecutionContext<any>, fieldName?: string): boolean;
+/**
+ * Validate fieldName (non-empty canonical dotted path)
+ */
+export declare function validateFieldName(fieldName: unknown, errorBuilder: ErrorBuilderBackendService, executionContext?: ExecutionContext<any>, fieldNameParam?: string): boolean;
+/**
+ * Validate contentType (MIME type format)
+ */
+export declare function validateContentType(contentType: unknown, errorBuilder: ErrorBuilderBackendService, executionContext?: ExecutionContext<any>, fieldName?: string): boolean;
+/**
+ * Validate contentLength (positive number <= maxFileSize)
+ */
+export declare function validateContentLength(contentLength: unknown, maxFileSize: number, errorBuilder: ErrorBuilderBackendService, executionContext?: ExecutionContext<any>, fieldName?: string): boolean;
+/**
+ * Validate size (positive number <= maxFileSize)
+ * Same as validateContentLength but with different field name
+ */
+export declare function validateSize(size: unknown, maxFileSize: number, errorBuilder: ErrorBuilderBackendService, executionContext?: ExecutionContext<any>, fieldName?: string): boolean;
+/**
+ * Validate uploadedBy (optional resource ID)
+ */
+export declare function validateUploadedBy(uploadedBy: unknown, errorBuilder: ErrorBuilderBackendService, executionContext?: ExecutionContext<any>, fieldName?: string): boolean;
+/**
+ * Validate uploadedByEntityType (optional enum value)
+ */
+export declare function validateUploadedByEntityType(uploadedByEntityType: unknown, errorBuilder: ErrorBuilderBackendService, executionContext?: ExecutionContext<any>, fieldName?: string): boolean;
+/**
+ * Sanitize filename for safe use in HTTP headers
+ *
+ * @param filename - The filename to sanitize
+ * @returns Sanitized filename safe for use in Content-Disposition header
+ */
+/**
+ * Sanitize filename for safe use in HTTP headers
+ *
+ * @param filename - The filename to sanitize
+ * @returns Sanitized filename safe for use in Content-Disposition header
+ */
+export declare function sanitizeFilename(filename: string): string;
+/**
+ * Validate stream is readable and not destroyed
+ */
+export declare function validateStream(stream: unknown, errorBuilder: ErrorBuilderBackendService, executionContext?: ExecutionContext<any>, fieldName?: string): boolean;
+//# sourceMappingURL=file-validation.utils.d.ts.map

package/dist/esm/files/utils/file-validation.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-validation.utils.d.ts","sourceRoot":"","sources":["../../../../src/files/utils/file-validation.utils.ts"],"names":[],"mappings":"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"}