@uploadista/core 0.0.2

package/dist/flow/plugins/types/optimize-node.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+/**
+ * Zod schema for validating image optimization parameters.
+ * Defines the structure and validation rules for image optimization requests.
+ */
+export declare const optimizeParamsSchema: z.ZodObject<{
+    quality: z.ZodNumber;
+    format: z.ZodEnum<{
+        avif: "avif";
+        jpeg: "jpeg";
+        png: "png";
+        webp: "webp";
+    }>;
+}, z.core.$strip>;
+/**
+ * Parameters for the image optimization node.
+ * Controls quality and format settings for image optimization.
+ */
+export type OptimizeParams = z.infer<typeof optimizeParamsSchema>;
+//# sourceMappingURL=optimize-node.d.ts.map

package/dist/flow/plugins/types/optimize-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize-node.d.ts","sourceRoot":"","sources":["../../../../src/flow/plugins/types/optimize-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;iBAK/B,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/flow/plugins/types/optimize-node.js

@@ -0,0 +1,11 @@
+import { z } from "zod";
+/**
+ * Zod schema for validating image optimization parameters.
+ * Defines the structure and validation rules for image optimization requests.
+ */
+export const optimizeParamsSchema = z.object({
+    /** Image quality as a percentage (0-100) */
+    quality: z.number().min(0).max(100),
+    /** Output image format */
+    format: z.enum(["jpeg", "webp", "png", "avif"]),
+});

package/dist/flow/plugins/types/remove-background-node.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+/**
+ * Zod schema for validating remove background node parameters.
+ * Defines the structure and validation rules for background removal requests.
+ */
+export declare const removeBackgroundParamsSchema: z.ZodObject<{
+    serviceType: z.ZodOptional<z.ZodEnum<{
+        replicate: "replicate";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Parameters for the remove background node.
+ * Controls which AI service to use for background removal processing.
+ */
+export type RemoveBackgroundParams = z.infer<typeof removeBackgroundParamsSchema>;
+//# sourceMappingURL=remove-background-node.d.ts.map

package/dist/flow/plugins/types/remove-background-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-background-node.d.ts","sourceRoot":"","sources":["../../../../src/flow/plugins/types/remove-background-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;iBAGvC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAC1C,OAAO,4BAA4B,CACpC,CAAC"}

package/dist/flow/plugins/types/remove-background-node.js

@@ -0,0 +1,9 @@
+import { z } from "zod";
+/**
+ * Zod schema for validating remove background node parameters.
+ * Defines the structure and validation rules for background removal requests.
+ */
+export const removeBackgroundParamsSchema = z.object({
+    /** Optional service type to use for background removal (currently supports "replicate") */
+    serviceType: z.enum(["replicate"]).optional(),
+});

package/dist/flow/plugins/types/resize-node.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+/**
+ * Zod schema for validating image resize parameters.
+ * Defines the structure and validation rules for image resizing requests.
+ * Requires at least one dimension (width or height) to be specified.
+ */
+export declare const resizeParamsSchema: z.ZodObject<{
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    fit: z.ZodEnum<{
+        fill: "fill";
+        contain: "contain";
+        cover: "cover";
+    }>;
+}, z.core.$strip>;
+/**
+ * Parameters for the image resize node.
+ * Controls the target dimensions and fitting behavior for image resizing.
+ */
+export type ResizeParams = z.infer<typeof resizeParamsSchema>;
+//# sourceMappingURL=resize-node.d.ts.map

package/dist/flow/plugins/types/resize-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resize-node.d.ts","sourceRoot":"","sources":["../../../../src/flow/plugins/types/resize-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;iBAY5B,CAAC;AAEJ;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/flow/plugins/types/resize-node.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+/**
+ * Zod schema for validating image resize parameters.
+ * Defines the structure and validation rules for image resizing requests.
+ * Requires at least one dimension (width or height) to be specified.
+ */
+export const resizeParamsSchema = z
+    .object({
+    /** Target width in pixels (optional) */
+    width: z.number().positive().optional(),
+    /** Target height in pixels (optional) */
+    height: z.number().positive().optional(),
+    /** How the image should fit within the specified dimensions */
+    fit: z.enum(["contain", "cover", "fill"]),
+})
+    .refine((data) => data.width || data.height, "Either width or height must be specified for resize");

package/dist/flow/plugins/zip-plugin.d.ts

@@ -0,0 +1,62 @@
+import type { UploadistaError } from "@uploadista/core/errors";
+import { Context, type Effect } from "effect";
+import type { UploadFile } from "@/types";
+/**
+ * Parameters for creating a ZIP archive.
+ */
+export type ZipParams = {
+    /** Name of the ZIP file to create */
+    zipName: string;
+    /** Whether to include file metadata in the ZIP archive */
+    includeMetadata: boolean;
+};
+/**
+ * Input data structure for ZIP operations.
+ * Represents a single file to be included in the ZIP archive.
+ */
+export type ZipInput = {
+    /** Unique identifier for the file */
+    id: string;
+    /** Binary data of the file */
+    data: Uint8Array;
+    /** File metadata including name, size, type, etc. */
+    metadata: UploadFile["metadata"];
+};
+/**
+ * Shape definition for the ZIP Plugin interface.
+ * Defines the contract that all ZIP implementations must follow.
+ */
+export type ZipPluginShape = {
+    /**
+     * Creates a ZIP archive from multiple input files.
+     *
+     * @param inputs - Array of files to include in the ZIP archive
+     * @param options - Configuration options for the ZIP creation
+     * @returns An Effect that resolves to the ZIP file as a Uint8Array
+     * @throws {UploadistaError} When ZIP creation fails
+     */
+    zip: (inputs: ZipInput[], options: ZipParams) => Effect.Effect<Uint8Array, UploadistaError>;
+};
+declare const ZipPlugin_base: Context.TagClass<ZipPlugin, "ZipPlugin", ZipPluginShape>;
+/**
+ * Context tag for the ZIP Plugin.
+ *
+ * This tag provides a type-safe way to access ZIP functionality
+ * throughout the application using Effect's dependency injection system.
+ *
+ * @example
+ * ```typescript
+ * import { ZipPlugin } from "@uploadista/core/flow/plugins";
+ *
+ * // In your flow node
+ * const program = Effect.gen(function* () {
+ *   const zipPlugin = yield* ZipPlugin;
+ *   const zipData = yield* zipPlugin.zip(files, { zipName: "archive.zip", includeMetadata: true });
+ *   return zipData;
+ * });
+ * ```
+ */
+export declare class ZipPlugin extends ZipPlugin_base {
+}
+export {};
+//# sourceMappingURL=zip-plugin.d.ts.map

package/dist/flow/plugins/zip-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-plugin.d.ts","sourceRoot":"","sources":["../../../src/flow/plugins/zip-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,qDAAqD;IACrD,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;CAClC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;;;OAOG;IACH,GAAG,EAAE,CACH,MAAM,EAAE,QAAQ,EAAE,EAClB,OAAO,EAAE,SAAS,KACf,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;CAEjD,CAAC;;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAU,SAAQ,cAG5B;CAAG"}

package/dist/flow/plugins/zip-plugin.js

@@ -0,0 +1,21 @@
+import { Context } from "effect";
+/**
+ * Context tag for the ZIP Plugin.
+ *
+ * This tag provides a type-safe way to access ZIP functionality
+ * throughout the application using Effect's dependency injection system.
+ *
+ * @example
+ * ```typescript
+ * import { ZipPlugin } from "@uploadista/core/flow/plugins";
+ *
+ * // In your flow node
+ * const program = Effect.gen(function* () {
+ *   const zipPlugin = yield* ZipPlugin;
+ *   const zipData = yield* zipPlugin.zip(files, { zipName: "archive.zip", includeMetadata: true });
+ *   return zipData;
+ * });
+ * ```
+ */
+export class ZipPlugin extends Context.Tag("ZipPlugin")() {
+}

package/dist/flow/typed-flow.d.ts

@@ -0,0 +1,90 @@
+/**
+ * biome-ignore-all lint/suspicious/noExplicitAny: broadly-typed generics require runtime schema placeholders
+ */
+import { Effect } from "effect";
+import { z } from "zod";
+import type { UploadistaError as CoreUploadistaError } from "../errors";
+import { UploadistaError } from "../errors";
+import type { UploadServer } from "../upload";
+import type { FlowEvent } from "./event";
+import type { Flow, FlowExecutionResult } from "./flow";
+import { NodeType } from "./node";
+import type { FlowNode, TypeCompatibilityChecker } from "./types/flow-types";
+export type NodeDefinition<TNodeError = never, TNodeRequirements = never> = FlowNode<any, any, CoreUploadistaError> | Effect.Effect<FlowNode<any, any, CoreUploadistaError>, TNodeError, TNodeRequirements>;
+export type NodeDefinitionsRecord = Record<string, NodeDefinition<any, any>>;
+type NodeDefinitionError<T> = T extends Effect.Effect<FlowNode<any, any, CoreUploadistaError>, infer TError, any> ? TError : never;
+type NodeDefinitionRequirements<T> = T extends Effect.Effect<FlowNode<any, any, CoreUploadistaError>, any, infer TRequirements> ? TRequirements : never;
+type NodesErrorUnion<TNodes extends NodeDefinitionsRecord> = {
+    [K in keyof TNodes]: NodeDefinitionError<TNodes[K]>;
+}[keyof TNodes];
+type NodesRequirementsUnion<TNodes extends NodeDefinitionsRecord> = {
+    [K in keyof TNodes]: NodeDefinitionRequirements<TNodes[K]>;
+}[keyof TNodes];
+export type FlowRequirements<TNodes extends NodeDefinitionsRecord> = NodesRequirementsUnion<TNodes>;
+export type FlowPluginRequirements<TNodes extends NodeDefinitionsRecord> = Exclude<FlowRequirements<TNodes>, UploadServer>;
+type InferNode<T> = T extends FlowNode<any, any, CoreUploadistaError> ? T : T extends Effect.Effect<infer R, any, any> ? R extends FlowNode<any, any, CoreUploadistaError> ? R : never : never;
+type ExtractKeysByNodeType<TNodes extends NodeDefinitionsRecord, TType extends NodeType> = {
+    [K in keyof TNodes]: InferNode<TNodes[K]>["type"] extends TType ? K : never;
+}[keyof TNodes];
+type SchemaInfer<T> = T extends z.ZodTypeAny ? z.infer<T> : never;
+export type FlowInputMap<TNodes extends NodeDefinitionsRecord> = {
+    [K in Extract<ExtractKeysByNodeType<TNodes, NodeType.input>, string>]: SchemaInfer<InferNode<TNodes[K]>["inputSchema"]>;
+};
+export type FlowOutputMap<TNodes extends NodeDefinitionsRecord> = {
+    [K in Extract<ExtractKeysByNodeType<TNodes, NodeType.output>, string>]: SchemaInfer<InferNode<TNodes[K]>["outputSchema"]>;
+};
+type FlowInputUnion<TNodes extends NodeDefinitionsRecord> = {
+    [K in Extract<ExtractKeysByNodeType<TNodes, NodeType.input>, string>]: SchemaInfer<InferNode<TNodes[K]>["inputSchema"]>;
+}[Extract<ExtractKeysByNodeType<TNodes, NodeType.input>, string>];
+type FlowOutputUnion<TNodes extends NodeDefinitionsRecord> = {
+    [K in Extract<ExtractKeysByNodeType<TNodes, NodeType.output>, string>]: SchemaInfer<InferNode<TNodes[K]>["outputSchema"]>;
+}[Extract<ExtractKeysByNodeType<TNodes, NodeType.output>, string>];
+type NodeKey<TNodes extends NodeDefinitionsRecord> = Extract<keyof TNodes, string>;
+export type TypedFlowEdge<TNodes extends NodeDefinitionsRecord> = {
+    source: NodeKey<TNodes>;
+    target: NodeKey<TNodes>;
+    sourcePort?: string;
+    targetPort?: string;
+};
+export type TypedFlowConfig<TNodes extends NodeDefinitionsRecord> = {
+    flowId: string;
+    name: string;
+    nodes: TNodes;
+    edges: Array<TypedFlowEdge<TNodes>>;
+    typeChecker?: TypeCompatibilityChecker;
+    onEvent?: (event: FlowEvent) => Effect.Effect<{
+        eventId: string | null;
+    }, CoreUploadistaError>;
+    parallelExecution?: {
+        enabled?: boolean;
+        maxConcurrency?: number;
+    };
+    inputSchema?: z.ZodTypeAny;
+    outputSchema?: z.ZodTypeAny;
+};
+declare const typedFlowInputsSymbol: unique symbol;
+declare const typedFlowOutputsSymbol: unique symbol;
+declare const typedFlowPluginsSymbol: unique symbol;
+export type TypedFlow<TNodes extends NodeDefinitionsRecord, TInputSchema extends z.ZodTypeAny, TOutputSchema extends z.ZodTypeAny> = Flow<TInputSchema, TOutputSchema, FlowRequirements<TNodes>> & {
+    run: (args: {
+        inputs?: Partial<FlowInputMap<TNodes>>;
+        storageId: string;
+        jobId: string;
+    }) => Effect.Effect<FlowExecutionResult<FlowOutputMap<TNodes>>, CoreUploadistaError, FlowRequirements<TNodes>>;
+    resume: (args: {
+        jobId: string;
+        storageId: string;
+        nodeResults: Record<string, unknown>;
+        executionState: {
+            executionOrder: string[];
+            currentIndex: number;
+            inputs: Partial<FlowInputMap<TNodes>>;
+        };
+    }) => Effect.Effect<FlowExecutionResult<FlowOutputMap<TNodes>>, CoreUploadistaError, FlowRequirements<TNodes>>;
+    readonly [typedFlowInputsSymbol]?: FlowInputMap<TNodes>;
+    readonly [typedFlowOutputsSymbol]?: FlowOutputMap<TNodes>;
+    readonly [typedFlowPluginsSymbol]?: FlowPluginRequirements<TNodes>;
+};
+export declare function createFlow<TNodes extends NodeDefinitionsRecord>(config: TypedFlowConfig<TNodes>): Effect.Effect<TypedFlow<TNodes, z.ZodType<FlowInputUnion<TNodes>>, z.ZodType<FlowOutputUnion<TNodes>>>, NodesErrorUnion<TNodes> | UploadistaError, FlowRequirements<TNodes>>;
+export {};
+//# sourceMappingURL=typed-flow.d.ts.map

package/dist/flow/typed-flow.d.ts.map

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

package/dist/flow/typed-flow.js

@@ -0,0 +1,59 @@
+/**
+ * biome-ignore-all lint/suspicious/noExplicitAny: broadly-typed generics require runtime schema placeholders
+ */
+import { Effect } from "effect";
+import { z } from "zod";
+import { UploadistaError } from "../errors";
+import { createFlowWithSchema } from "./flow";
+import { NodeType } from "./node";
+const buildUnionSchema = (schemas, fallback) => {
+    if (schemas.length === 0) {
+        return fallback;
+    }
+    const [first, ...rest] = schemas;
+    return rest.reduce((acc, schema) => z.union([acc, schema]), first);
+};
+export function createFlow(config) {
+    return Effect.gen(function* () {
+        const nodeEntries = Object.entries(config.nodes);
+        const resolveNode = (node) => Effect.isEffect(node)
+            ? node
+            : Effect.succeed(node);
+        const resolvedEntries = yield* Effect.forEach(nodeEntries, ([key, node]) => Effect.flatMap(resolveNode(node), (resolvedNode) => {
+            if (resolvedNode.id !== key) {
+                return Effect.fail(UploadistaError.fromCode("FLOW_NODE_ERROR", {
+                    cause: new Error(`Node key ${key} does not match node id ${resolvedNode.id}`),
+                }));
+            }
+            return Effect.succeed([key, resolvedNode]);
+        }));
+        const resolvedRecord = Object.fromEntries(resolvedEntries);
+        const resolvedNodes = resolvedEntries.map(([, node]) => node);
+        const inputSchemas = resolvedEntries
+            .filter(([, node]) => node.type === NodeType.input)
+            .map(([, node]) => node.inputSchema);
+        const outputSchemas = resolvedEntries
+            .filter(([, node]) => node.type === NodeType.output)
+            .map(([, node]) => node.outputSchema);
+        const inputSchema = config.inputSchema ?? buildUnionSchema(inputSchemas, z.unknown());
+        const outputSchema = config.outputSchema ?? buildUnionSchema(outputSchemas, z.unknown());
+        const flowEdges = config.edges.map((edge) => ({
+            source: resolvedRecord[edge.source]?.id ?? edge.source,
+            target: resolvedRecord[edge.target]?.id ?? edge.target,
+            sourcePort: edge.sourcePort,
+            targetPort: edge.targetPort,
+        }));
+        const flow = yield* createFlowWithSchema({
+            flowId: config.flowId,
+            name: config.name,
+            nodes: resolvedNodes,
+            edges: flowEdges,
+            inputSchema,
+            outputSchema,
+            typeChecker: config.typeChecker,
+            onEvent: config.onEvent,
+            parallelExecution: config.parallelExecution,
+        });
+        return flow;
+    });
+}

package/dist/flow/types/flow-file.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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
+ */
+export type FlowCondition = {
+    field: "mimeType" | "size" | "width" | "height" | "extension";
+    operator: "equals" | "notEquals" | "greaterThan" | "lessThan" | "contains" | "startsWith";
+    value: string | number;
+};
+//# sourceMappingURL=flow-file.d.ts.map

package/dist/flow/types/flow-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-file.d.ts","sourceRoot":"","sources":["../../../src/flow/types/flow-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC9D,QAAQ,EACJ,QAAQ,GACR,WAAW,GACX,aAAa,GACb,UAAU,GACV,UAAU,GACV,YAAY,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB,CAAC"}

package/dist/flow/types/flow-file.js

@@ -0,0 +1,27 @@
+/**
+ * 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"
+ * };
+ * ```
+ */
+export {};

package/dist/flow/types/flow-job.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Flow job tracking and state management types.
+ *
+ * A FlowJob represents a single execution instance of a flow, tracking its progress,
+ * node results, and execution state. Jobs can be paused and resumed, making them
+ * suitable for long-running or interactive flows.
+ *
+ * @module flow/types/flow-job
+ * @see {@link FlowServer} for job management operations
+ */
+/**
+ * Status of an individual node within a flow job.
+ *
+ * Node tasks follow this lifecycle:
+ * started → pending → running → (completed | paused | failed)
+ */
+export type FlowJobTaskStatus = "started" | "pending" | "running" | "completed" | "paused" | "failed";
+/**
+ * Represents a single node's execution within a flow job.
+ *
+ * Tasks track individual node execution, storing results, errors, and retry information.
+ * They allow monitoring of which nodes have completed and accessing intermediate results.
+ *
+ * @property nodeId - Unique identifier of the node this task represents
+ * @property status - Current execution status of the node
+ * @property result - Output data from the node (if completed successfully)
+ * @property error - Error message if the node failed
+ * @property retryCount - Number of retry attempts made before success or final failure
+ * @property createdAt - When the task was created
+ * @property updatedAt - When the task was last updated
+ */
+export type FlowJobTask = {
+    nodeId: string;
+    status: FlowJobTaskStatus;
+    result?: unknown;
+    error?: string;
+    retryCount?: number;
+    createdAt: Date;
+    updatedAt: Date;
+};
+/**
+ * Represents a flow execution job with full state tracking.
+ *
+ * Jobs are created when a flow is executed and track the entire execution lifecycle.
+ * They store node results, handle paused states, and manage cleanup of intermediate files.
+ *
+ * @property id - Unique job identifier (UUID)
+ * @property flowId - The flow being executed
+ * @property storageId - Storage location for file outputs
+ * @property clientId - Client that initiated the job (for authorization)
+ * @property status - Overall job status
+ * @property createdAt - When the job was created
+ * @property updatedAt - When the job was last updated
+ * @property tasks - Array of node execution tasks
+ * @property error - Error message if the job failed
+ * @property endedAt - When the job completed or failed
+ * @property result - Final output from the flow (only set when completed)
+ * @property pausedAt - Node ID where execution is paused (if applicable)
+ * @property executionState - State needed to resume a paused flow
+ * @property intermediateFiles - File IDs to cleanup after completion
+ *
+ * @remarks
+ * - Jobs can be paused at nodes that return `{ type: "waiting" }`
+ * - Paused jobs store execution state and can be resumed with new data
+ * - Intermediate files from non-output nodes are automatically cleaned up
+ * - Tasks are updated as nodes progress through their lifecycle
+ *
+ * @example
+ * ```typescript
+ * // Create and monitor a job
+ * const job = yield* flowServer.runFlow({
+ *   flowId: "image-pipeline",
+ *   storageId: "storage-1",
+ *   inputs: { input: myFile }
+ * });
+ *
+ * // Poll for status
+ * const status = yield* flowServer.getJobStatus(job.id);
+ * if (status.status === "completed") {
+ *   console.log("Final result:", status.result);
+ * } else if (status.status === "paused") {
+ *   // Resume with additional data
+ *   yield* flowServer.continueFlow({
+ *     jobId: job.id,
+ *     nodeId: status.pausedAt,
+ *     newData: additionalChunk
+ *   });
+ * }
+ * ```
+ */
+export type FlowJob = {
+    id: string;
+    flowId: string;
+    storageId: string;
+    clientId: string | null;
+    status: FlowJobStatus;
+    createdAt: Date;
+    updatedAt: Date;
+    tasks: FlowJobTask[];
+    error?: string;
+    endedAt?: Date;
+    result?: unknown;
+    pausedAt?: string;
+    executionState?: {
+        executionOrder: string[];
+        currentIndex: number;
+        inputs: Record<string, unknown>;
+    };
+    intermediateFiles?: string[];
+};
+/**
+ * Overall status of a flow job.
+ *
+ * Job lifecycle: started → running → (completed | failed)
+ * Or with pauses: started → running → paused → running → (completed | failed)
+ */
+export type FlowJobStatus = "pending" | "running" | "completed" | "failed" | "started" | "paused";
+//# sourceMappingURL=flow-job.d.ts.map

package/dist/flow/types/flow-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-job.d.ts","sourceRoot":"","sources":["../../../src/flow/types/flow-job.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,QAAQ,CAAC;AAEb;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,CAAC;IAEf,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE;QACf,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IAEF,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,GACT,QAAQ,CAAC"}

package/dist/flow/types/flow-job.js

@@ -0,0 +1,11 @@
+/**
+ * Flow job tracking and state management types.
+ *
+ * A FlowJob represents a single execution instance of a flow, tracking its progress,
+ * node results, and execution state. Jobs can be paused and resumed, making them
+ * suitable for long-running or interactive flows.
+ *
+ * @module flow/types/flow-job
+ * @see {@link FlowServer} for job management operations
+ */
+export {};