@uploadista/core 0.0.18-beta.2 → 0.0.18-beta.3

package/dist/{index-D5ALjvAb.d.cts → index-uOAh_6qk.d.cts}

@@ -1049,6 +1049,143 @@ type FlowConfig<TFlowInputSchema extends z.ZodSchema<any>, TFlowOutputSchema ext
     }) => Effect.Effect<TOutput, UploadistaError, never> | Promise<TOutput>;
   };
 };
+/**
+ * Context provided to file naming functions and templates.
+ *
+ * Contains all relevant information about the current file, node, and flow
+ * execution that can be used to generate dynamic file names.
+ *
+ * @property baseName - Filename without extension (e.g., "photo" from "photo.jpg")
+ * @property extension - File extension without dot (e.g., "jpg")
+ * @property fileName - Full original filename (e.g., "photo.jpg")
+ * @property nodeType - Type of processing node (e.g., "resize", "optimize")
+ * @property nodeId - Specific node instance ID
+ * @property flowId - Flow identifier
+ * @property jobId - Execution job ID
+ * @property timestamp - ISO 8601 timestamp of processing
+ * @property width - Output width (image/video nodes only)
+ * @property height - Output height (image/video nodes only)
+ * @property format - Output format (e.g., "webp", "mp4")
+ * @property quality - Quality setting (e.g., 80)
+ *
+ * @example
+ * ```typescript
+ * // Available in templates as {{variable}}
+ * const pattern = "{{baseName}}-{{width}}x{{height}}.{{extension}}";
+ * // Result: "photo-800x600.jpg"
+ * ```
+ */
+type NamingContext = {
+  /** Filename without extension */
+  baseName: string;
+  /** File extension without dot */
+  extension: string;
+  /** Full original filename */
+  fileName: string;
+  /** Type of processing node */
+  nodeType: string;
+  /** Specific node instance ID */
+  nodeId: string;
+  /** Flow identifier */
+  flowId: string;
+  /** Execution job ID */
+  jobId: string;
+  /** ISO 8601 timestamp of processing */
+  timestamp: string;
+  /** Output width (image/video nodes) */
+  width?: number;
+  /** Output height (image/video nodes) */
+  height?: number;
+  /** Output format */
+  format?: string;
+  /** Quality setting */
+  quality?: number;
+  /** Page number (document nodes) */
+  pageNumber?: number;
+  /** Additional custom variables */
+  [key: string]: string | number | undefined;
+};
+/**
+ * Function type for custom file naming logic.
+ *
+ * @param file - The UploadFile being processed
+ * @param context - Naming context with all available variables
+ * @returns The new filename (including extension)
+ *
+ * @example
+ * ```typescript
+ * const customRename: FileNamingFunction = (file, ctx) =>
+ *   `${ctx.flowId}-${ctx.baseName}-${ctx.timestamp}.${ctx.extension}`;
+ * ```
+ */
+type FileNamingFunction = (file: UploadFile, context: NamingContext) => string;
+/**
+ * Function type for generating auto-naming suffixes.
+ *
+ * Each node type can define its own auto suffix generator that creates
+ * a descriptive suffix based on the processing parameters.
+ *
+ * @param context - Naming context with all available variables
+ * @returns The suffix to append (without leading dash)
+ *
+ * @example
+ * ```typescript
+ * // Resize node auto suffix
+ * const resizeAutoSuffix: AutoNamingSuffixGenerator = (ctx) =>
+ *   `${ctx.width}x${ctx.height}`;
+ * // Result: "photo-800x600.jpg"
+ *
+ * // Optimize node auto suffix
+ * const optimizeAutoSuffix: AutoNamingSuffixGenerator = (ctx) =>
+ *   ctx.format ?? 'optimized';
+ * // Result: "photo-webp.webp"
+ * ```
+ */
+type AutoNamingSuffixGenerator = (context: NamingContext) => string;
+/**
+ * Configuration for file naming behavior on a node.
+ *
+ * Supports three modes:
+ * - `undefined` or no config: Preserve original filename (backward compatible)
+ * - `mode: 'auto'`: Generate smart suffix based on node type
+ * - `mode: 'custom'`: Use template pattern or rename function
+ *
+ * @property mode - Naming mode: 'auto' for smart suffixes, 'custom' for templates/functions
+ * @property pattern - Mustache-style template string (for custom mode)
+ * @property rename - Custom function for full control (for custom mode, SDK only)
+ * @property autoSuffix - Generator function for auto mode suffix
+ *
+ * @example
+ * ```typescript
+ * // Auto mode with smart suffix
+ * const autoNaming: FileNamingConfig = {
+ *   mode: 'auto',
+ *   autoSuffix: (ctx) => `${ctx.width}x${ctx.height}`
+ * };
+ *
+ * // Custom mode with template
+ * const templateNaming: FileNamingConfig = {
+ *   mode: 'custom',
+ *   pattern: '{{baseName}}-{{nodeType}}.{{extension}}'
+ * };
+ *
+ * // Custom mode with function
+ * const functionNaming: FileNamingConfig = {
+ *   mode: 'custom',
+ *   rename: (file, ctx) => `processed-${ctx.fileName}`
+ * };
+ * ```
+ */
+type FileNamingConfig = {
+  /** Naming mode: 'auto' for smart suffixes, 'custom' for templates/functions */
+  mode: "auto" | "custom";
+  /** Mustache-style template string (for custom mode) */
+  pattern?: string;
+  /** Custom function for full control (for custom mode, SDK only) */
+  rename?: FileNamingFunction;
+  /** Generator function for auto mode suffix */
+  autoSuffix?: AutoNamingSuffixGenerator;
+};
 //#endregion
 //#region src/flow/edge.d.ts
 /**
@@ -3235,7 +3372,7 @@ declare function createUploadServer(): Effect.Effect<{
   getCapabilities: (storageId: string, clientId: string | null) => Effect.Effect<DataStoreCapabilities, UploadistaError, never>;
   subscribeToUploadEvents: (uploadId: string, connection: WebSocketConnection) => Effect.Effect<void, UploadistaError, never>;
   unsubscribeFromUploadEvents: (uploadId: string) => Effect.Effect<void, UploadistaError, never>;
-}, never, GenerateId | UploadFileDataStores | UploadFileKVStore | UploadEventEmitter>;
+}, never, UploadFileDataStores | UploadFileKVStore | UploadEventEmitter | GenerateId>;
 /**
  * Pre-built UploadServer Effect Layer.
  *
@@ -3266,7 +3403,7 @@ declare function createUploadServer(): Effect.Effect<{
  * }).pipe(Effect.provide(fullUploadSystem));
  * ```
  */
-declare const uploadServer: Layer.Layer<UploadServer, never, GenerateId | UploadFileDataStores | UploadFileKVStore | UploadEventEmitter>;
+declare const uploadServer: Layer.Layer<UploadServer, never, UploadFileDataStores | UploadFileKVStore | UploadEventEmitter | GenerateId>;
 //#endregion
 //#region src/upload/upload-strategy-negotiator.d.ts
 /**
@@ -3821,8 +3958,8 @@ declare function createFlowServer(): Effect.Effect<{
   cancelFlow: (jobId: string, clientId: string | null) => Effect.Effect<FlowJob, UploadistaError, never>;
   subscribeToFlowEvents: (jobId: string, connection: WebSocketConnection) => Effect.Effect<void, UploadistaError, never>;
   unsubscribeFromFlowEvents: (jobId: string) => Effect.Effect<void, UploadistaError, never>;
-}, never, UploadServer | FlowJobKVStore | FlowEventEmitter | FlowProvider>;
-declare const flowServer: Layer.Layer<FlowServer, never, UploadServer | FlowJobKVStore | FlowEventEmitter | FlowProvider>;
+}, never, UploadServer | FlowEventEmitter | FlowJobKVStore | FlowProvider>;
+declare const flowServer: Layer.Layer<FlowServer, never, UploadServer | FlowEventEmitter | FlowJobKVStore | FlowProvider>;
 type FlowServerLayer = typeof flowServer;
 //#endregion
 //#region src/flow/nodes/input-node.d.ts
@@ -3952,6 +4089,195 @@ declare function createInputNode(id: string, params?: InputNodeParams, options?:
   type: NodeType.input;
 }, UploadistaError, UploadServer>;
 //#endregion
+//#region src/flow/types/flow-file.d.ts
+/**
+ * Conditional execution rules for flow nodes.
+ *
+ * Conditions allow nodes to execute conditionally based on file properties or metadata.
+ * They are evaluated before node execution and can skip nodes that don't match.
+ *
+ * @module flow/types/flow-file
+ * @see {@link FlowNode} for how conditions are used in nodes
+ *
+ * @example
+ * ```typescript
+ * // Only process images larger than 1MB
+ * const condition: FlowCondition = {
+ *   field: "size",
+ *   operator: "greaterThan",
+ *   value: 1024 * 1024
+ * };
+ *
+ * // Only process JPEG images
+ * const jpegCondition: FlowCondition = {
+ *   field: "mimeType",
+ *   operator: "startsWith",
+ *   value: "image/jpeg"
+ * };
+ * ```
+ */
+/**
+ * Represents a conditional rule for node execution.
+ *
+ * @property field - The file property to check
+ * @property operator - The comparison operator to apply
+ * @property value - The value to compare against
+ *
+ * @remarks
+ * - Fields can check file metadata (mimeType, size) or image properties (width, height)
+ * - String operators (contains, startsWith) work with string values
+ * - Numeric operators (greaterThan, lessThan) work with numeric values
+ * - The extension field checks the file extension without the dot
+ */
+type FlowCondition = {
+  field: "mimeType" | "size" | "width" | "height" | "extension";
+  operator: "equals" | "notEquals" | "greaterThan" | "lessThan" | "contains" | "startsWith";
+  value: string | number;
+};
+//#endregion
+//#region src/flow/types/type-utils.d.ts
+/**
+ * Extracts the service type from an Effect Layer.
+ *
+ * Given a Layer that provides a service, this type utility extracts
+ * the service type from the Layer's type signature.
+ *
+ * @template T - The Layer type to extract from
+ * @returns The service type provided by the layer, or never if T is not a Layer
+ *
+ * @example
+ * ```typescript
+ * type MyLayer = Layer.Layer<ServiceA, never, never>;
+ * type Service = ExtractLayerService<MyLayer>;
+ * // Service = ServiceA
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { ImagePluginLayer } from '@uploadista/core';
+ *
+ * type ImageService = ExtractLayerService<ImagePluginLayer>;
+ * // ImageService = ImagePlugin
+ * ```
+ */
+type ExtractLayerService<T, TError$1 = never, TRequirements = never> = T extends Layer.Layer<infer S, TError$1, TRequirements> ? S : never;
+/**
+ * Extracts all service types from a tuple of layers and returns them as a union.
+ *
+ * This type recursively processes a tuple of Layer types and extracts all
+ * the services they provide, combining them into a single union type.
+ *
+ * @template T - A readonly tuple of Layer types
+ * @returns A union of all service types provided by the layers, or never for empty tuples
+ *
+ * @example
+ * ```typescript
+ * type Layers = [
+ *   Layer.Layer<ServiceA, never, never>,
+ *   Layer.Layer<ServiceB, never, never>,
+ *   Layer.Layer<ServiceC, never, never>
+ * ];
+ * type Services = ExtractLayerServices<Layers>;
+ * // Services = ServiceA | ServiceB | ServiceC
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { ImagePluginLayer, ZipPluginLayer } from '@uploadista/core';
+ *
+ * type PluginLayers = [ImagePluginLayer, ZipPluginLayer];
+ * type AllServices = ExtractLayerServices<PluginLayers>;
+ * // AllServices = ImagePlugin | ZipPlugin
+ * ```
+ *
+ * @example
+ * ```typescript
+ * type EmptyLayers = [];
+ * type NoServices = ExtractLayerServices<EmptyLayers>;
+ * // NoServices = never
+ * ```
+ */
+type ExtractLayerServices<T extends readonly Layer.Layer<any, any, any>[]> = T extends readonly [] ? never : { [K in keyof T]: T[K] extends Layer.Layer<infer S, any, any> ? S : never }[number];
+/**
+ * Unwraps an Effect type to extract its success value type.
+ *
+ * If the input type is an Effect, this extracts the success type (first type parameter).
+ * If the input is not an Effect, it returns the type unchanged.
+ *
+ * @template T - The type to resolve, potentially an Effect
+ * @returns The success type if T is an Effect, otherwise T
+ *
+ * @example
+ * ```typescript
+ * type MyEffect = Effect.Effect<string, Error, never>;
+ * type Result = ResolveEffect<MyEffect>;
+ * // Result = string
+ * ```
+ *
+ * @example
+ * ```typescript
+ * type NonEffect = { data: string };
+ * type Result = ResolveEffect<NonEffect>;
+ * // Result = { data: string }
+ * ```
+ */
+type ResolveEffect<T> = T extends Effect.Effect<infer S, any, any> ? S : T;
+/**
+ * Extracts the error type from an Effect.
+ *
+ * Given an Effect type, this utility extracts the error type
+ * (second type parameter) from the Effect's type signature.
+ *
+ * @template T - The Effect type to extract from
+ * @returns The error type of the Effect, or never if T is not an Effect
+ *
+ * @example
+ * ```typescript
+ * type MyEffect = Effect.Effect<string, ValidationError, never>;
+ * type ErrorType = ExtractEffectError<MyEffect>;
+ * // ErrorType = ValidationError
+ * ```
+ *
+ * @example
+ * ```typescript
+ * type SafeEffect = Effect.Effect<number, never, SomeService>;
+ * type ErrorType = ExtractEffectError<SafeEffect>;
+ * // ErrorType = never (no errors possible)
+ * ```
+ */
+type ExtractEffectError<T> = T extends Effect.Effect<any, infer E, any> ? E : never;
+/**
+ * Extracts the requirements (context) type from an Effect.
+ *
+ * Given an Effect type, this utility extracts the requirements type
+ * (third type parameter) from the Effect's type signature. This represents
+ * the services that must be provided for the Effect to run.
+ *
+ * @template T - The Effect type to extract from
+ * @returns The requirements type of the Effect, or never if T is not an Effect
+ *
+ * @example
+ * ```typescript
+ * type MyEffect = Effect.Effect<string, Error, Database | Logger>;
+ * type Requirements = ExtractEffectRequirements<MyEffect>;
+ * // Requirements = Database | Logger
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { ImagePlugin, ZipPlugin } from '@uploadista/core';
+ *
+ * type ProcessEffect = Effect.Effect<
+ *   ProcessedImage,
+ *   ProcessError,
+ *   ImagePlugin | ZipPlugin
+ * >;
+ * type Needed = ExtractEffectRequirements<ProcessEffect>;
+ * // Needed = ImagePlugin | ZipPlugin
+ * ```
+ */
+type ExtractEffectRequirements<T> = T extends Effect.Effect<any, any, infer R> ? R : never;
+//#endregion
 //#region src/flow/nodes/transform-node.d.ts
 /**
  * Configuration object for creating a transform node.
@@ -3971,6 +4297,24 @@ interface TransformNodeConfig {
    * Defaults to false.
    */
   keepOutput?: boolean;
+  /**
+   * Optional file naming configuration.
+   * - undefined: Preserve original filename (backward compatible)
+   * - mode: 'auto': Generate smart suffix based on node type
+   * - mode: 'custom': Use template pattern or rename function
+   */
+  naming?: FileNamingConfig;
+  /**
+   * Node type identifier used for auto-naming context.
+   * Defaults to "transform" if not specified.
+   */
+  nodeType?: string;
+  /**
+   * Additional variables to include in the naming context.
+   * These are merged with the base context (flowId, jobId, etc.)
+   * and can be used in templates.
+   */
+  namingVars?: Record<string, string | number | undefined>;
   /** Function that transforms file bytes */
   transform: (bytes: Uint8Array, file: UploadFile) => Effect.Effect<Uint8Array | {
     bytes: Uint8Array;
@@ -4035,6 +4379,9 @@ declare function createTransformNode({
   description,
   outputTypeId,
   keepOutput,
+  naming,
+  nodeType: nodeTypeId,
+  namingVars,
   transform
 }: TransformNodeConfig): Effect.Effect<FlowNodeData & {
   inputSchema: zod0.ZodType<UploadFile, unknown, zod_v4_core0.$ZodTypeInternals<UploadFile, unknown>>;
@@ -5786,195 +6133,6 @@ declare function isUploadOperation(data: InputData): data is Extract<InputData,
   operation: "init" | "url";
 }>;
 //#endregion
-//#region src/flow/types/flow-file.d.ts
-/**
- * Conditional execution rules for flow nodes.
- *
- * Conditions allow nodes to execute conditionally based on file properties or metadata.
- * They are evaluated before node execution and can skip nodes that don't match.
- *
- * @module flow/types/flow-file
- * @see {@link FlowNode} for how conditions are used in nodes
- *
- * @example
- * ```typescript
- * // Only process images larger than 1MB
- * const condition: FlowCondition = {
- *   field: "size",
- *   operator: "greaterThan",
- *   value: 1024 * 1024
- * };
- *
- * // Only process JPEG images
- * const jpegCondition: FlowCondition = {
- *   field: "mimeType",
- *   operator: "startsWith",
- *   value: "image/jpeg"
- * };
- * ```
- */
-/**
- * Represents a conditional rule for node execution.
- *
- * @property field - The file property to check
- * @property operator - The comparison operator to apply
- * @property value - The value to compare against
- *
- * @remarks
- * - Fields can check file metadata (mimeType, size) or image properties (width, height)
- * - String operators (contains, startsWith) work with string values
- * - Numeric operators (greaterThan, lessThan) work with numeric values
- * - The extension field checks the file extension without the dot
- */
-type FlowCondition = {
-  field: "mimeType" | "size" | "width" | "height" | "extension";
-  operator: "equals" | "notEquals" | "greaterThan" | "lessThan" | "contains" | "startsWith";
-  value: string | number;
-};
-//#endregion
-//#region src/flow/types/type-utils.d.ts
-/**
- * Extracts the service type from an Effect Layer.
- *
- * Given a Layer that provides a service, this type utility extracts
- * the service type from the Layer's type signature.
- *
- * @template T - The Layer type to extract from
- * @returns The service type provided by the layer, or never if T is not a Layer
- *
- * @example
- * ```typescript
- * type MyLayer = Layer.Layer<ServiceA, never, never>;
- * type Service = ExtractLayerService<MyLayer>;
- * // Service = ServiceA
- * ```
- *
- * @example
- * ```typescript
- * import { ImagePluginLayer } from '@uploadista/core';
- *
- * type ImageService = ExtractLayerService<ImagePluginLayer>;
- * // ImageService = ImagePlugin
- * ```
- */
-type ExtractLayerService<T, TError$1 = never, TRequirements = never> = T extends Layer.Layer<infer S, TError$1, TRequirements> ? S : never;
-/**
- * Extracts all service types from a tuple of layers and returns them as a union.
- *
- * This type recursively processes a tuple of Layer types and extracts all
- * the services they provide, combining them into a single union type.
- *
- * @template T - A readonly tuple of Layer types
- * @returns A union of all service types provided by the layers, or never for empty tuples
- *
- * @example
- * ```typescript
- * type Layers = [
- *   Layer.Layer<ServiceA, never, never>,
- *   Layer.Layer<ServiceB, never, never>,
- *   Layer.Layer<ServiceC, never, never>
- * ];
- * type Services = ExtractLayerServices<Layers>;
- * // Services = ServiceA | ServiceB | ServiceC
- * ```
- *
- * @example
- * ```typescript
- * import { ImagePluginLayer, ZipPluginLayer } from '@uploadista/core';
- *
- * type PluginLayers = [ImagePluginLayer, ZipPluginLayer];
- * type AllServices = ExtractLayerServices<PluginLayers>;
- * // AllServices = ImagePlugin | ZipPlugin
- * ```
- *
- * @example
- * ```typescript
- * type EmptyLayers = [];
- * type NoServices = ExtractLayerServices<EmptyLayers>;
- * // NoServices = never
- * ```
- */
-type ExtractLayerServices<T extends readonly Layer.Layer<any, any, any>[]> = T extends readonly [] ? never : { [K in keyof T]: T[K] extends Layer.Layer<infer S, any, any> ? S : never }[number];
-/**
- * Unwraps an Effect type to extract its success value type.
- *
- * If the input type is an Effect, this extracts the success type (first type parameter).
- * If the input is not an Effect, it returns the type unchanged.
- *
- * @template T - The type to resolve, potentially an Effect
- * @returns The success type if T is an Effect, otherwise T
- *
- * @example
- * ```typescript
- * type MyEffect = Effect.Effect<string, Error, never>;
- * type Result = ResolveEffect<MyEffect>;
- * // Result = string
- * ```
- *
- * @example
- * ```typescript
- * type NonEffect = { data: string };
- * type Result = ResolveEffect<NonEffect>;
- * // Result = { data: string }
- * ```
- */
-type ResolveEffect<T> = T extends Effect.Effect<infer S, any, any> ? S : T;
-/**
- * Extracts the error type from an Effect.
- *
- * Given an Effect type, this utility extracts the error type
- * (second type parameter) from the Effect's type signature.
- *
- * @template T - The Effect type to extract from
- * @returns The error type of the Effect, or never if T is not an Effect
- *
- * @example
- * ```typescript
- * type MyEffect = Effect.Effect<string, ValidationError, never>;
- * type ErrorType = ExtractEffectError<MyEffect>;
- * // ErrorType = ValidationError
- * ```
- *
- * @example
- * ```typescript
- * type SafeEffect = Effect.Effect<number, never, SomeService>;
- * type ErrorType = ExtractEffectError<SafeEffect>;
- * // ErrorType = never (no errors possible)
- * ```
- */
-type ExtractEffectError<T> = T extends Effect.Effect<any, infer E, any> ? E : never;
-/**
- * Extracts the requirements (context) type from an Effect.
- *
- * Given an Effect type, this utility extracts the requirements type
- * (third type parameter) from the Effect's type signature. This represents
- * the services that must be provided for the Effect to run.
- *
- * @template T - The Effect type to extract from
- * @returns The requirements type of the Effect, or never if T is not an Effect
- *
- * @example
- * ```typescript
- * type MyEffect = Effect.Effect<string, Error, Database | Logger>;
- * type Requirements = ExtractEffectRequirements<MyEffect>;
- * // Requirements = Database | Logger
- * ```
- *
- * @example
- * ```typescript
- * import { ImagePlugin, ZipPlugin } from '@uploadista/core';
- *
- * type ProcessEffect = Effect.Effect<
- *   ProcessedImage,
- *   ProcessError,
- *   ImagePlugin | ZipPlugin
- * >;
- * type Needed = ExtractEffectRequirements<ProcessEffect>;
- * // Needed = ImagePlugin | ZipPlugin
- * ```
- */
-type ExtractEffectRequirements<T> = T extends Effect.Effect<any, any, infer R> ? R : never;
-//#endregion
 //#region src/flow/typed-flow.d.ts
 /**
  * Defines a node that can be used in a typed flow.
@@ -6259,5 +6417,202 @@ type ResolvedUploadMetadata = {
 };
 declare function resolveUploadMetadata(metadata: FileMetadata): ResolvedUploadMetadata;
 //#endregion
-export { VideoPluginLayer as $, MiddlewareService as $n, isDataStore as $r, DocumentPlugin as $t, isInitOperation as A, FlowEventJobEnd as Ai, FlowServerOptions as An, OutputValidationResult as Ar, blurTransformSchema as At, Plugin as B, ConditionValue as Bi, NegotiatedStrategy as Bn, FlowExecutionResult as Br, textTransformSchema as Bt, filterOutputsByType as C, EventType as Ci, createInputNode as Cn, OcrOutput as Cr, SepiaTransform as Ct, hasOutputOfType as D, FlowEventFlowError as Di, FlowProviderShape as Dn, ocrOutputSchema as Dr, Transformation as Dt, getSingleOutputByType as E, FlowEventFlowEnd as Ei, FlowProvider as En, imageDescriptionOutputSchema as Er, TransformImageParams as Et, isUrlOperation as F, FlowEventNodeResponse as Fi, flowServer as Fn, InputValidationResult as Fr, logoTransformSchema as Ft, ZipPluginLayer as G, uploadFileSchema as Gi, UploadServerShape as Gn, DataStoreCapabilities as Gr, resizeParamsSchema as Gt, ZipInput as H, createFlowNode as Hi, UploadStrategyOptions as Hn, getFlowData as Hr, transformationSchema as Ht, RemoveBackgroundParams as I, FlowEventNodeResume as Ii, FlowJob as In, inputTypeRegistry as Ir, resizeTransformSchema as It, ScanResult as J, compareMimeTypes as Jn, UploadFileDataStore as Jr, ImageAiContext as Jt, ZipPluginShape as K, createUploadServer as Kn, DataStoreConfig as Kr, OptimizeParams as Kt, removeBackgroundParamsSchema as L, FlowEventNodeStart as Li, FlowJobStatus as Ln, validateFlowInput as Lr, rotateTransformSchema as Lt, isStorageOutput as M, FlowEventNodeEnd as Mi, FlowWaitUntil as Mn, validateFlowOutput as Mr, contrastTransformSchema as Mt, isUploadFile as N, FlowEventNodeError as Ni, WaitUntilCallback as Nn, InputTypeDefinition as Nr, flipTransformSchema as Nt, isFinalizeOperation as O, FlowEventFlowPause as Oi, FlowServer as On, OutputTypeDefinition as Or, TransformationType as Ot, isUploadOperation as P, FlowEventNodePause as Pi, createFlowServer as Pn, InputTypeRegistry as Pr, grayscaleTransformSchema as Pt, VideoPlugin as Q, MiddlewareNext as Qn, createDataStoreLayer as Qr, DocumentMetadata as Qt, DescribeImageParams as R, ConditionField as Ri, FlowJobTask as Rn, Flow as Rr, sepiaTransformSchema as Rt, createTypeGuard as S, waitingNodeExecution as Si, InputNodeParams as Sn, OCR_OUTPUT_TYPE_ID as Sr, RotateTransform as St, getOutputByNodeId as T, FlowEventFlowCancel as Ti, inputNodeParamsSchema as Tn, STREAMING_INPUT_TYPE_ID as Tr, TextTransform as Tt, ZipParams as U, getNodeData as Ui, UploadServer as Un, BufferedUploadFileDataStore as Ur, watermarkTransformSchema as Ut, PluginLayer as V, NodeType as Vi, UploadStrategyNegotiator as Vn, createFlowWithSchema as Vr, transformImageParamsSchema as Vt, ZipPlugin as W, UploadFile as Wi, UploadServerOptions as Wn, DataStore as Wr, ResizeParams as Wt, VirusScanPluginLayer as X, Middleware as Xn, UploadFileDataStoresShape as Xr, ImageAiPluginLayer as Xt, VirusScanPlugin as Y, detectMimeType as Yn, UploadFileDataStores as Yr, ImageAiPlugin as Yt, VirusScanPluginShape as Z, MiddlewareContext as Zn, UploadStrategy as Zr, ImageAiPluginShape as Zt, ExtractLayerService as _, NodeExecutionResult as _i, ParallelScheduler as _n, uploadEventSchema as _r, FlipTransform as _t, FlowInputMap as a, UploadFileKVStore as ai, DocumentAiContext as an, EventEmitter as ar, ResizeVideoParams as at, FlowCondition as b, TypedOutput as bi, createTransformNode as bn, IMAGE_DESCRIPTION_OUTPUT_TYPE_ID as br, OverlayPosition as bt, FlowRequirements as c, uploadFileKvStore as ci, DocumentAiPluginShape as cn, UploadEventEmitter as cr, extractFrameVideoParamsSchema as ct, TypedFlow as d, BuiltInTypedOutput as di, OcrResult as dn, uploadEventEmitter as dr, ImagePlugin as dt, BaseKvStore as ei, DocumentPluginLayer as en, MiddlewareServiceLive as er, VideoPluginShape as et, TypedFlowConfig as f, CustomTypedOutput as fi, OcrTaskType as fn, WebSocketConnection as fr, ImagePluginLayer as ft, ExtractEffectRequirements as g, NodeConnectionValidator as gi, ExecutionLevel as gn, UploadEventType as gr, ContrastTransform as gt, ExtractEffectError as h, FlowNodeData as hi, CredentialProviderShape as hn, UploadEvent as hr, BrightnessTransform as ht, runArgsSchema as i, TypedKvStore as ii, SplitPdfResult as in, BaseEventEmitterService as ir, transcodeVideoParamsSchema as it, isOcrOutput as j, FlowEventJobStart as ji, FlowServerShape as jn, outputTypeRegistry as jr, brightnessTransformSchema as jt, isImageDescriptionOutput as k, FlowEventFlowStart as ki, FlowServerLayer as kn, OutputTypeRegistry as kr, WatermarkTransform as kt, NodeDefinition as l, FlowEdge as li, OcrParams as ln, eventToMessageSerializer as lr, DescribeVideoMetadata as lt, createFlow as m, FlowNode as mi, CredentialProviderLayer as mn, webSocketMessageSchema as mr, BlurTransform as mt, resolveUploadMetadata as n, FlowJobKVStore as ni, MergePdfParams as nn, inputFileSchema as nr, trimVideoParamsSchema as nt, FlowOutputMap as o, flowJobKvStore as oi, DocumentAiPlugin as on, FlowEventEmitter as or, resizeVideoParamsSchema as ot, TypedFlowEdge as p, FlowConfig as pi, CredentialProvider as pn, WebSocketMessage as pr, ImagePluginShape as pt, ScanMetadata as q, uploadServer as qn, DataStoreWriteOptions as qr, optimizeParamsSchema as qt, RunArgs as r, KvStore as ri, SplitPdfParams as rn, BaseEventEmitter as rr, TranscodeVideoParams as rt, FlowPluginRequirements as s, jsonSerializer as si, DocumentAiPluginLayer as sn, TypedEventEmitter as sr, ExtractFrameVideoParams as st, ResolvedUploadMetadata as t, BaseKvStoreService as ti, DocumentPluginShape as tn, InputFile as tr, TrimVideoParams as tt, NodeDefinitionsRecord as u, createFlowEdge as ui, OcrResolution as un, flowEventEmitter as ur, describeVideoMetadataSchema as ut, ExtractLayerServices as v, NodeTypeMap as vi, ParallelSchedulerConfig as vn, EventBroadcaster as vr, GrayscaleTransform as vt, getFirstOutputByType as w, FlowEvent as wi, inputDataSchema as wn, STORAGE_OUTPUT_TYPE_ID as wr, SharpenTransform as wt, NarrowedTypedOutput as x, completeNodeExecution as xi, InputData as xn, ImageDescriptionOutput as xr, ResizeTransform as xt, ResolveEffect as y, TypeCompatibilityChecker as yi, TransformNodeConfig as yn, EventBroadcasterService as yr, LogoTransform as yt, describeImageParamsSchema as z, ConditionOperator as zi, FlowJobTaskStatus as zn, FlowData as zr, sharpenTransformSchema as zt };
-//# sourceMappingURL=index-D5ALjvAb.d.cts.map
+//#region src/flow/utils/file-naming.d.ts
+/**
+ * Extracts the base name (without extension) from a filename.
+ *
+ * @param fileName - The full filename
+ * @returns The filename without extension
+ *
+ * @example
+ * ```typescript
+ * getBaseName("photo.jpg") // "photo"
+ * getBaseName("document.tar.gz") // "document.tar"
+ * getBaseName("noextension") // "noextension"
+ * ```
+ */
+declare function getBaseName(fileName: string): string;
+/**
+ * Extracts the extension (without dot) from a filename.
+ *
+ * @param fileName - The full filename
+ * @returns The extension without leading dot, or empty string if none
+ *
+ * @example
+ * ```typescript
+ * getExtension("photo.jpg") // "jpg"
+ * getExtension("document.tar.gz") // "gz"
+ * getExtension("noextension") // ""
+ * ```
+ */
+declare function getExtension(fileName: string): string;
+/**
+ * Builds a naming context from file and flow execution information.
+ *
+ * @param file - The UploadFile being processed
+ * @param flowContext - Flow execution context (flowId, jobId, nodeId, nodeType)
+ * @param extraVars - Additional variables to include (width, height, format, etc.)
+ * @returns Complete naming context for template interpolation
+ *
+ * @example
+ * ```typescript
+ * const context = buildNamingContext(
+ *   uploadFile,
+ *   { flowId: "flow-1", jobId: "job-1", nodeId: "resize-1", nodeType: "resize" },
+ *   { width: 800, height: 600 }
+ * );
+ * // context.baseName = "photo"
+ * // context.extension = "jpg"
+ * // context.width = 800
+ * // context.height = 600
+ * ```
+ */
+declare function buildNamingContext(file: UploadFile, flowContext: {
+  flowId: string;
+  jobId: string;
+  nodeId: string;
+  nodeType: string;
+}, extraVars?: Record<string, string | number | undefined>): NamingContext;
+/**
+ * Interpolates a mustache-style template with the given context.
+ *
+ * Uses micromustache for fast, secure template rendering.
+ * Unknown variables are preserved as-is (e.g., {{unknown}} stays {{unknown}}).
+ *
+ * @param pattern - Mustache-style template string
+ * @param context - Variables to interpolate
+ * @returns Interpolated string
+ *
+ * @example
+ * ```typescript
+ * interpolateFileName(
+ *   "{{baseName}}-{{width}}x{{height}}.{{extension}}",
+ *   { baseName: "photo", width: 800, height: 600, extension: "jpg" }
+ * );
+ * // Returns: "photo-800x600.jpg"
+ * ```
+ */
+declare function interpolateFileName(pattern: string, context: NamingContext): string;
+/**
+ * Applies file naming configuration to generate a new filename.
+ *
+ * Handles three modes:
+ * - No config: Returns original filename (backward compatible)
+ * - Auto mode: Appends auto-generated suffix based on node type
+ * - Custom mode: Uses template pattern or rename function
+ *
+ * On any error, falls back to the original filename to prevent flow failures.
+ *
+ * @param file - The UploadFile being processed
+ * @param context - Naming context with all available variables
+ * @param config - Optional naming configuration
+ * @returns The new filename (or original on error/no config)
+ *
+ * @example
+ * ```typescript
+ * // Auto mode
+ * applyFileNaming(file, context, {
+ *   mode: 'auto',
+ *   autoSuffix: (ctx) => `${ctx.width}x${ctx.height}`
+ * });
+ * // Returns: "photo-800x600.jpg"
+ *
+ * // Custom mode with template
+ * applyFileNaming(file, context, {
+ *   mode: 'custom',
+ *   pattern: '{{baseName}}-processed.{{extension}}'
+ * });
+ * // Returns: "photo-processed.jpg"
+ *
+ * // Custom mode with function
+ * applyFileNaming(file, context, {
+ *   mode: 'custom',
+ *   rename: (file, ctx) => `${ctx.flowId}-${ctx.fileName}`
+ * });
+ * // Returns: "flow-1-photo.jpg"
+ * ```
+ */
+declare function applyFileNaming(file: UploadFile, context: NamingContext, config?: FileNamingConfig): string;
+/**
+ * Validates a template pattern for common issues.
+ *
+ * Checks for:
+ * - Balanced braces
+ * - Non-empty pattern
+ * - Valid variable names
+ *
+ * @param pattern - Template pattern to validate
+ * @returns Object with isValid flag and optional error message
+ *
+ * @example
+ * ```typescript
+ * validatePattern("{{baseName}}.{{extension}}");
+ * // { isValid: true }
+ *
+ * validatePattern("{{baseName");
+ * // { isValid: false, error: "Unbalanced braces: missing closing }}" }
+ * ```
+ */
+declare function validatePattern(pattern: string): {
+  isValid: boolean;
+  error?: string;
+};
+/**
+ * List of available template variables for documentation and UI.
+ */
+declare const AVAILABLE_TEMPLATE_VARIABLES: readonly [{
+  readonly name: "baseName";
+  readonly description: "Filename without extension";
+  readonly example: "photo";
+}, {
+  readonly name: "extension";
+  readonly description: "File extension without dot";
+  readonly example: "jpg";
+}, {
+  readonly name: "fileName";
+  readonly description: "Full original filename";
+  readonly example: "photo.jpg";
+}, {
+  readonly name: "nodeType";
+  readonly description: "Type of processing node";
+  readonly example: "resize";
+}, {
+  readonly name: "nodeId";
+  readonly description: "Specific node instance ID";
+  readonly example: "resize-1";
+}, {
+  readonly name: "flowId";
+  readonly description: "Flow identifier";
+  readonly example: "flow-abc";
+}, {
+  readonly name: "jobId";
+  readonly description: "Execution job ID";
+  readonly example: "job-123";
+}, {
+  readonly name: "timestamp";
+  readonly description: "ISO 8601 processing time";
+  readonly example: "2024-01-15T10:30:00Z";
+}, {
+  readonly name: "width";
+  readonly description: "Output width (image/video)";
+  readonly example: "800";
+}, {
+  readonly name: "height";
+  readonly description: "Output height (image/video)";
+  readonly example: "600";
+}, {
+  readonly name: "format";
+  readonly description: "Output format";
+  readonly example: "webp";
+}, {
+  readonly name: "quality";
+  readonly description: "Quality setting";
+  readonly example: "80";
+}, {
+  readonly name: "pageNumber";
+  readonly description: "Page number (documents)";
+  readonly example: "1";
+}];
+//#endregion
+export { VideoPlugin as $, createFlowNode as $i, createUploadServer as $n, DataStoreConfig as $r, DocumentMetadata as $t, isImageDescriptionOutput as A, TypeCompatibilityChecker as Ai, createInputNode as An, OcrOutput as Ar, WatermarkTransform as At, describeImageParamsSchema as B, FlowEventFlowStart as Bi, WaitUntilCallback as Bn, InputTypeDefinition as Br, sharpenTransformSchema as Bt, createTypeGuard as C, FlowConfig as Ci, ExtractEffectRequirements as Cn, UploadEventType as Cr, RotateTransform as Ct, getSingleOutputByType as D, NodeConnectionValidator as Di, FlowCondition as Dn, IMAGE_DESCRIPTION_OUTPUT_TYPE_ID as Dr, TransformImageParams as Dt, getOutputByNodeId as E, NamingContext as Ei, ResolveEffect as En, EventBroadcasterService as Er, TextTransform as Et, isUploadOperation as F, FlowEvent as Fi, FlowServer as Fn, OutputTypeDefinition as Fr, grayscaleTransformSchema as Ft, ZipPlugin as G, FlowEventNodePause as Gi, FlowJobTask as Gn, Flow as Gr, ResizeParams as Gt, PluginLayer as H, FlowEventJobStart as Hi, flowServer as Hn, InputValidationResult as Hr, transformImageParamsSchema as Ht, isUrlOperation as I, FlowEventFlowCancel as Ii, FlowServerLayer as In, OutputTypeRegistry as Ir, logoTransformSchema as It, ScanMetadata as J, FlowEventNodeStart as Ji, UploadStrategyNegotiator as Jn, createFlowWithSchema as Jr, optimizeParamsSchema as Jt, ZipPluginLayer as K, FlowEventNodeResponse as Ki, FlowJobTaskStatus as Kn, FlowData as Kr, resizeParamsSchema as Kt, RemoveBackgroundParams as L, FlowEventFlowEnd as Li, FlowServerOptions as Ln, OutputValidationResult as Lr, resizeTransformSchema as Lt, isOcrOutput as M, completeNodeExecution as Mi, inputNodeParamsSchema as Mn, STREAMING_INPUT_TYPE_ID as Mr, brightnessTransformSchema as Mt, isStorageOutput as N, waitingNodeExecution as Ni, FlowProvider as Nn, imageDescriptionOutputSchema as Nr, contrastTransformSchema as Nt, hasOutputOfType as O, NodeExecutionResult as Oi, InputData as On, ImageDescriptionOutput as Or, Transformation as Ot, isUploadFile as P, EventType as Pi, FlowProviderShape as Pn, ocrOutputSchema as Pr, flipTransformSchema as Pt, VirusScanPluginShape as Q, NodeType as Qi, UploadServerShape as Qn, DataStoreCapabilities as Qr, ImageAiPluginShape as Qt, removeBackgroundParamsSchema as R, FlowEventFlowError as Ri, FlowServerShape as Rn, outputTypeRegistry as Rr, rotateTransformSchema as Rt, NarrowedTypedOutput as S, FileNamingFunction as Si, ExtractEffectError as Sn, UploadEvent as Sr, ResizeTransform as St, getFirstOutputByType as T, FlowNodeData as Ti, ExtractLayerServices as Tn, EventBroadcaster as Tr, SharpenTransform as Tt, ZipInput as U, FlowEventNodeEnd as Ui, FlowJob as Un, inputTypeRegistry as Ur, transformationSchema as Ut, Plugin as V, FlowEventJobEnd as Vi, createFlowServer as Vn, InputTypeRegistry as Vr, textTransformSchema as Vt, ZipParams as W, FlowEventNodeError as Wi, FlowJobStatus as Wn, validateFlowInput as Wr, watermarkTransformSchema as Wt, VirusScanPlugin as X, ConditionOperator as Xi, UploadServer as Xn, BufferedUploadFileDataStore as Xr, ImageAiPlugin as Xt, ScanResult as Y, ConditionField as Yi, UploadStrategyOptions as Yn, getFlowData as Yr, ImageAiContext as Yt, VirusScanPluginLayer as Z, ConditionValue as Zi, UploadServerOptions as Zn, DataStore as Zr, ImageAiPluginLayer as Zt, NodeDefinitionsRecord as _, createFlowEdge as _i, ExecutionLevel as _n, flowEventEmitter as _r, ContrastTransform as _t, getExtension as a, createDataStoreLayer as ai, SplitPdfResult as an, MiddlewareNext as ar, transcodeVideoParamsSchema as at, TypedFlowEdge as b, CustomTypedOutput as bi, TransformNodeConfig as bn, WebSocketMessage as br, LogoTransform as bt, ResolvedUploadMetadata as c, BaseKvStoreService as ci, DocumentAiPluginLayer as cn, InputFile as cr, ExtractFrameVideoParams as ct, runArgsSchema as d, TypedKvStore as di, OcrResolution as dn, BaseEventEmitterService as dr, describeVideoMetadataSchema as dt, getNodeData as ea, DataStoreWriteOptions as ei, DocumentPlugin as en, uploadServer as er, VideoPluginLayer as et, FlowInputMap as f, UploadFileKVStore as fi, OcrResult as fn, EventEmitter as fr, ImagePlugin as ft, NodeDefinition as g, FlowEdge as gi, CredentialProviderShape as gn, eventToMessageSerializer as gr, BrightnessTransform as gt, FlowRequirements as h, uploadFileKvStore as hi, CredentialProviderLayer as hn, UploadEventEmitter as hr, BlurTransform as ht, getBaseName as i, UploadStrategy as ii, SplitPdfParams as in, MiddlewareContext as ir, TranscodeVideoParams as it, isInitOperation as j, TypedOutput as ji, inputDataSchema as jn, STORAGE_OUTPUT_TYPE_ID as jr, blurTransformSchema as jt, isFinalizeOperation as k, NodeTypeMap as ki, InputNodeParams as kn, OCR_OUTPUT_TYPE_ID as kr, TransformationType as kt, resolveUploadMetadata as l, FlowJobKVStore as li, DocumentAiPluginShape as ln, inputFileSchema as lr, extractFrameVideoParamsSchema as lt, FlowPluginRequirements as m, jsonSerializer as mi, CredentialProvider as mn, TypedEventEmitter as mr, ImagePluginShape as mt, applyFileNaming as n, uploadFileSchema as na, UploadFileDataStores as ni, DocumentPluginShape as nn, detectMimeType as nr, TrimVideoParams as nt, interpolateFileName as o, isDataStore as oi, DocumentAiContext as on, MiddlewareService as or, ResizeVideoParams as ot, FlowOutputMap as p, flowJobKvStore as pi, OcrTaskType as pn, FlowEventEmitter as pr, ImagePluginLayer as pt, ZipPluginShape as q, FlowEventNodeResume as qi, NegotiatedStrategy as qn, FlowExecutionResult as qr, OptimizeParams as qt, buildNamingContext as r, UploadFileDataStoresShape as ri, MergePdfParams as rn, Middleware as rr, trimVideoParamsSchema as rt, validatePattern as s, BaseKvStore as si, DocumentAiPlugin as sn, MiddlewareServiceLive as sr, resizeVideoParamsSchema as st, AVAILABLE_TEMPLATE_VARIABLES as t, UploadFile as ta, UploadFileDataStore as ti, DocumentPluginLayer as tn, compareMimeTypes as tr, VideoPluginShape as tt, RunArgs as u, KvStore as ui, OcrParams as un, BaseEventEmitter as ur, DescribeVideoMetadata as ut, TypedFlow as v, AutoNamingSuffixGenerator as vi, ParallelScheduler as vn, uploadEventEmitter as vr, FlipTransform as vt, filterOutputsByType as w, FlowNode as wi, ExtractLayerService as wn, uploadEventSchema as wr, SepiaTransform as wt, createFlow as x, FileNamingConfig as xi, createTransformNode as xn, webSocketMessageSchema as xr, OverlayPosition as xt, TypedFlowConfig as y, BuiltInTypedOutput as yi, ParallelSchedulerConfig as yn, WebSocketConnection as yr, GrayscaleTransform as yt, DescribeImageParams as z, FlowEventFlowPause as zi, FlowWaitUntil as zn, validateFlowOutput as zr, sepiaTransformSchema as zt };
+//# sourceMappingURL=index-uOAh_6qk.d.cts.map