@teamflojo/floimg 0.1.0

package/dist/core/errors.js

@@ -0,0 +1,75 @@
+/**
+ * Base error class for floimg errors
+ */
+export class FloimgError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "FloimgError";
+    }
+}
+/**
+ * Error thrown when a provider is not found
+ */
+export class ProviderNotFoundError extends FloimgError {
+    constructor(providerType, providerName) {
+        let message = `Provider "${providerName}" not found for type "${providerType}"`;
+        // Add helpful hints for common cases
+        if (providerType === "save" && (providerName === "s3" || providerName === "r2" || providerName === "tigris")) {
+            message += `\n\nTo enable S3-compatible storage, create a floimg.config.ts file:\n\n` +
+                `export default {\n` +
+                `  save: {\n` +
+                `    s3: {\n` +
+                `      bucket: 'my-bucket',\n` +
+                `      region: 'us-east-1',\n` +
+                `      credentials: {\n` +
+                `        accessKeyId: process.env.AWS_ACCESS_KEY_ID,\n` +
+                `        secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,\n` +
+                `      },\n` +
+                `    },\n` +
+                `  },\n` +
+                `};\n\n` +
+                `See floimg.config.example.ts for more options.`;
+        }
+        super(message, "PROVIDER_NOT_FOUND");
+        this.name = "ProviderNotFoundError";
+    }
+}
+/**
+ * Error thrown when provider configuration is invalid
+ */
+export class ConfigurationError extends FloimgError {
+    constructor(message) {
+        super(message, "CONFIGURATION_ERROR");
+        this.name = "ConfigurationError";
+    }
+}
+/**
+ * Error thrown when an image transformation fails
+ */
+export class TransformError extends FloimgError {
+    constructor(message) {
+        super(message, "TRANSFORM_ERROR");
+        this.name = "TransformError";
+    }
+}
+/**
+ * Error thrown when an upload operation fails
+ */
+export class UploadError extends FloimgError {
+    constructor(message) {
+        super(message, "UPLOAD_ERROR");
+        this.name = "UploadError";
+    }
+}
+/**
+ * Error thrown when image generation fails
+ */
+export class GenerationError extends FloimgError {
+    constructor(message) {
+        super(message, "GENERATION_ERROR");
+        this.name = "GenerationError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACA;IAApC,YAAY,OAAe,EAAS,IAAa;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QADmB,SAAI,GAAJ,IAAI,CAAS;QAE/C,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IACpD,YAAY,YAAoB,EAAE,YAAoB;QACpD,IAAI,OAAO,GAAG,aAAa,YAAY,yBAAyB,YAAY,GAAG,CAAC;QAEhF,qCAAqC;QACrC,IAAI,YAAY,KAAK,MAAM,IAAI,CAAC,YAAY,KAAK,IAAI,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,KAAK,QAAQ,CAAC,EAAE,CAAC;YAC7G,OAAO,IAAI,0EAA0E;gBACnF,oBAAoB;gBACpB,aAAa;gBACb,aAAa;gBACb,8BAA8B;gBAC9B,8BAA8B;gBAC9B,wBAAwB;gBACxB,uDAAuD;gBACvD,+DAA+D;gBAC/D,YAAY;gBACZ,UAAU;gBACV,QAAQ;gBACR,QAAQ;gBACR,gDAAgD,CAAC;QACrD,CAAC;QAED,KAAK,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/core/logger.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Simple logger for imgflo
+ */
+export declare class Logger {
+    private verbose;
+    constructor(verbose?: boolean);
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    debug(message: string, ...args: unknown[]): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,MAAM;IACL,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE,OAAe;IAE5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAKjD"}

package/dist/core/logger.js

@@ -0,0 +1,26 @@
+/**
+ * Simple logger for imgflo
+ */
+export class Logger {
+    verbose;
+    constructor(verbose = false) {
+        this.verbose = verbose;
+    }
+    info(message, ...args) {
+        if (this.verbose) {
+            console.log(`[imgflo] ${message}`, ...args);
+        }
+    }
+    warn(message, ...args) {
+        console.warn(`[imgflo] ${message}`, ...args);
+    }
+    error(message, ...args) {
+        console.error(`[imgflo] ${message}`, ...args);
+    }
+    debug(message, ...args) {
+        if (this.verbose) {
+            console.debug(`[imgflo] ${message}`, ...args);
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,MAAM;IACG;IAApB,YAAoB,UAAmB,KAAK;QAAxB,YAAO,GAAP,OAAO,CAAiB;IAAG,CAAC;IAEhD,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,IAAI,CAAC,YAAY,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,OAAO,CAAC,KAAK,CAAC,YAAY,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,YAAY,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF"}

package/dist/core/pipeline-runner.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Pipeline execution engine with parallel step support
+ *
+ * This module provides dependency analysis and parallel execution for imgflo pipelines.
+ * Steps are grouped into "waves" based on their dependencies, and each wave is executed
+ * concurrently (bounded by the pipeline's concurrency setting).
+ */
+import type { PipelineStep } from "./types.js";
+/**
+ * Represents a step with its dependency information
+ */
+export interface StepNode {
+    /** Original index in the pipeline steps array */
+    index: number;
+    /** The pipeline step */
+    step: PipelineStep;
+    /** Variable names this step depends on (inputs) */
+    dependencies: Set<string>;
+    /** Variable names this step produces (outputs) */
+    outputs: string[];
+}
+/**
+ * A group of steps that can be executed in parallel
+ */
+export interface ExecutionWave {
+    /** Steps that can run concurrently */
+    steps: StepNode[];
+}
+/**
+ * Build a dependency graph from pipeline steps
+ *
+ * Analyzes each step to determine:
+ * - What variables it depends on (from `in` field)
+ * - What variables it produces (from `out` field)
+ *
+ * @param steps - Array of pipeline steps
+ * @returns Array of step nodes with dependency information
+ */
+export declare function buildDependencyGraph(steps: PipelineStep[]): StepNode[];
+/**
+ * Compute execution waves from the dependency graph
+ *
+ * Groups steps into "waves" where:
+ * - All steps in a wave have their dependencies satisfied
+ * - All steps in a wave can run in parallel
+ * - Waves are executed sequentially
+ *
+ * @param nodes - Step nodes with dependency information
+ * @returns Array of execution waves
+ * @throws Error if circular dependency is detected
+ */
+export declare function computeExecutionWaves(nodes: StepNode[]): ExecutionWave[];
+/**
+ * Execute tasks with bounded concurrency
+ *
+ * Runs tasks in parallel but limits the number of concurrent executions.
+ * If concurrency is Infinity, all tasks run in parallel.
+ *
+ * @param tasks - Array of async task functions
+ * @param concurrency - Maximum number of concurrent tasks
+ * @returns Array of results in the same order as tasks
+ */
+export declare function executeWithConcurrency<T>(tasks: (() => Promise<T>)[], concurrency: number): Promise<T[]>;
+//# sourceMappingURL=pipeline-runner.d.ts.map

package/dist/core/pipeline-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-runner.d.ts","sourceRoot":"","sources":["../../src/core/pipeline-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,IAAI,EAAE,YAAY,CAAC;IACnB,mDAAmD;IACnD,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,kDAAkD;IAClD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,QAAQ,EAAE,CAuBtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,aAAa,EAAE,CAwCxE;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAC3B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,EAAE,CAAC,CAgBd"}

package/dist/core/pipeline-runner.js

@@ -0,0 +1,109 @@
+/**
+ * Pipeline execution engine with parallel step support
+ *
+ * This module provides dependency analysis and parallel execution for imgflo pipelines.
+ * Steps are grouped into "waves" based on their dependencies, and each wave is executed
+ * concurrently (bounded by the pipeline's concurrency setting).
+ */
+/**
+ * Build a dependency graph from pipeline steps
+ *
+ * Analyzes each step to determine:
+ * - What variables it depends on (from `in` field)
+ * - What variables it produces (from `out` field)
+ *
+ * @param steps - Array of pipeline steps
+ * @returns Array of step nodes with dependency information
+ */
+export function buildDependencyGraph(steps) {
+    return steps.map((step, index) => {
+        const dependencies = new Set();
+        const outputs = [];
+        if (step.kind === "generate") {
+            // Generate steps have no inputs, only output
+            outputs.push(step.out);
+        }
+        else if (step.kind === "transform") {
+            // Transform steps depend on their input variable
+            dependencies.add(step.in);
+            outputs.push(step.out);
+        }
+        else if (step.kind === "save") {
+            // Save steps depend on their input variable
+            dependencies.add(step.in);
+            // Save steps may optionally produce an output
+            if (step.out) {
+                outputs.push(step.out);
+            }
+        }
+        return { index, step, dependencies, outputs };
+    });
+}
+/**
+ * Compute execution waves from the dependency graph
+ *
+ * Groups steps into "waves" where:
+ * - All steps in a wave have their dependencies satisfied
+ * - All steps in a wave can run in parallel
+ * - Waves are executed sequentially
+ *
+ * @param nodes - Step nodes with dependency information
+ * @returns Array of execution waves
+ * @throws Error if circular dependency is detected
+ */
+export function computeExecutionWaves(nodes) {
+    const waves = [];
+    const completed = new Set(); // Variables that have been produced
+    const remaining = new Set(nodes);
+    while (remaining.size > 0) {
+        const wave = [];
+        for (const node of remaining) {
+            // Check if all dependencies are satisfied
+            const satisfied = [...node.dependencies].every((dep) => completed.has(dep));
+            if (satisfied) {
+                wave.push(node);
+            }
+        }
+        if (wave.length === 0) {
+            // No progress can be made - circular dependency or missing input
+            const unsatisfied = [...remaining].map((n) => ({
+                step: n.step.kind,
+                needs: [...n.dependencies].filter((d) => !completed.has(d)),
+            }));
+            throw new Error(`Circular dependency or missing input detected in pipeline. ` +
+                `Unsatisfied steps: ${JSON.stringify(unsatisfied)}`);
+        }
+        // Remove wave nodes from remaining, add their outputs to completed
+        for (const node of wave) {
+            remaining.delete(node);
+            node.outputs.forEach((out) => completed.add(out));
+        }
+        waves.push({ steps: wave });
+    }
+    return waves;
+}
+/**
+ * Execute tasks with bounded concurrency
+ *
+ * Runs tasks in parallel but limits the number of concurrent executions.
+ * If concurrency is Infinity, all tasks run in parallel.
+ *
+ * @param tasks - Array of async task functions
+ * @param concurrency - Maximum number of concurrent tasks
+ * @returns Array of results in the same order as tasks
+ */
+export async function executeWithConcurrency(tasks, concurrency) {
+    if (concurrency === Infinity || concurrency >= tasks.length) {
+        // Run all tasks in parallel
+        return Promise.all(tasks.map((fn) => fn()));
+    }
+    // Run tasks in batches
+    const results = [];
+    for (let i = 0; i < tasks.length; i += concurrency) {
+        const batch = tasks.slice(i, i + concurrency);
+        const batchResults = await Promise.all(batch.map((fn) => fn()));
+        results.push(...batchResults);
+    }
+    return results;
+}
+//# sourceMappingURL=pipeline-runner.js.map

package/dist/core/pipeline-runner.js.map

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