@teamflojo/floimg 0.1.0

package/dist/core/types.d.ts

@@ -0,0 +1,392 @@
+/**
+ * Core types for floimg
+ */
+export type MimeType = "image/svg+xml" | "image/png" | "image/jpeg" | "image/webp" | "image/avif";
+/**
+ * Represents an image as a buffer with metadata
+ */
+export interface ImageBlob {
+    /** Raw image bytes */
+    bytes: Buffer;
+    /** MIME type of the image */
+    mime: MimeType;
+    /** Image width in pixels (if known) */
+    width?: number;
+    /** Image height in pixels (if known) */
+    height?: number;
+    /** Additional metadata about the image */
+    metadata?: Record<string, unknown>;
+    /** Source identifier (e.g., "svg:gradient", "ai:openai") */
+    source?: string;
+}
+/**
+ * Result from uploading an image to storage
+ */
+export interface UploadResult {
+    /** Storage key/path where the image was uploaded */
+    key: string;
+    /** Public URL to access the image (if available) */
+    url?: string;
+    /** ETag or version identifier from the storage provider */
+    etag?: string;
+    /** Additional metadata from the upload operation */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Configuration for floimg client
+ */
+export interface FloimgConfig {
+    /** Directory for caching generated images */
+    cacheDir?: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Image generator configuration */
+    generators?: {
+        default?: string;
+        [generatorName: string]: unknown;
+    };
+    /** Transform provider configuration */
+    transform?: {
+        default?: string;
+        [providerName: string]: unknown;
+    };
+    /** Save provider configuration (filesystem, S3, R2, etc.) */
+    save?: {
+        default?: string;
+        fs?: {
+            baseDir?: string;
+            chmod?: number;
+        };
+        s3?: {
+            bucket?: string;
+            region?: string;
+            endpoint?: string;
+            credentials?: {
+                accessKeyId: string;
+                secretAccessKey: string;
+            };
+        };
+        r2?: {
+            accountId: string;
+            accessKeyId: string;
+            secretAccessKey: string;
+        };
+        [providerName: string]: unknown;
+    };
+    ai?: {
+        default?: string;
+        openai?: {
+            apiKey: string;
+        };
+        [providerName: string]: unknown;
+    };
+}
+/**
+ * JSON Schema-compatible type for a single parameter
+ */
+export interface ParameterSchema {
+    /** Parameter data type */
+    type: "string" | "number" | "boolean" | "object" | "array";
+    /** Human-readable title for UI display */
+    title?: string;
+    /** Description of what the parameter does */
+    description?: string;
+    /** Default value */
+    default?: unknown;
+    /** Allowed values (for string enums) */
+    enum?: string[];
+    /** Minimum value (for numbers) */
+    minimum?: number;
+    /** Maximum value (for numbers) */
+    maximum?: number;
+    /** For object types: nested property schemas */
+    properties?: Record<string, ParameterSchema>;
+    /** For array types: schema of array items */
+    items?: ParameterSchema;
+}
+/**
+ * Schema for an image generator
+ */
+export interface GeneratorSchema {
+    /** Generator identifier (matches ImageGenerator.name) */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Category for UI grouping (e.g., 'Basic', 'AI', 'Utility') */
+    category?: string;
+    /** Parameter definitions */
+    parameters: Record<string, ParameterSchema>;
+    /** Names of required parameters */
+    requiredParameters?: string[];
+}
+/**
+ * Schema for a transform operation
+ */
+export interface TransformOperationSchema {
+    /** Operation name (e.g., 'resize', 'blur') */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Category for UI grouping (e.g., 'Size', 'Filters', 'Text') */
+    category?: string;
+    /** Parameter definitions */
+    parameters: Record<string, ParameterSchema>;
+    /** Names of required parameters */
+    requiredParameters?: string[];
+}
+/**
+ * Schema for a save provider
+ */
+export interface SaveProviderSchema {
+    /** Provider name (e.g., 'fs', 's3') */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** URL protocols this provider handles (e.g., ['s3://', 'r2://']) */
+    protocols?: string[];
+}
+/**
+ * Complete capabilities of a floimg client
+ */
+export interface ClientCapabilities {
+    /** Available image generators */
+    generators: GeneratorSchema[];
+    /** Available transform operations */
+    transforms: TransformOperationSchema[];
+    /** Available save providers */
+    saveProviders: SaveProviderSchema[];
+}
+/**
+ * Image generator interface - unified for all generation types
+ * (SVG, AI, procedural, etc.)
+ */
+export interface ImageGenerator {
+    /** Generator name (e.g., 'shapes', 'openai', 'trianglify') */
+    name: string;
+    /** Schema describing this generator's parameters */
+    schema: GeneratorSchema;
+    /** Generate an image from parameters */
+    generate(params: Record<string, unknown>): Promise<ImageBlob>;
+}
+export type SvgProvider = ImageGenerator;
+export type AiProvider = ImageGenerator;
+/**
+ * Image transformation provider interface
+ */
+export interface TransformProvider {
+    /** Provider name */
+    name: string;
+    /** Schemas for all operations this provider supports */
+    operationSchemas: Record<string, TransformOperationSchema>;
+    /** Convert image to a different format */
+    convert(input: ImageBlob, to: MimeType): Promise<ImageBlob>;
+    /** Resize an image (optional) */
+    resize?(input: ImageBlob, opts: {
+        width?: number;
+        height?: number;
+        fit?: "cover" | "contain" | "fill";
+    }): Promise<ImageBlob>;
+    /** Composite multiple images together (optional) */
+    composite?(base: ImageBlob, overlays: Array<{
+        blob: ImageBlob;
+        left: number;
+        top: number;
+    }>): Promise<ImageBlob>;
+    /** Optimize SVG file size (optional) */
+    optimizeSvg?(svg: ImageBlob): Promise<ImageBlob>;
+    /** Apply Gaussian blur */
+    blur?(input: ImageBlob, sigma?: number): Promise<ImageBlob>;
+    /** Sharpen the image */
+    sharpen?(input: ImageBlob, opts?: Record<string, unknown>): Promise<ImageBlob>;
+    /** Convert to grayscale */
+    grayscale?(input: ImageBlob): Promise<ImageBlob>;
+    /** Negate/invert colors */
+    negate?(input: ImageBlob): Promise<ImageBlob>;
+    /** Auto-enhance contrast */
+    normalize?(input: ImageBlob): Promise<ImageBlob>;
+    /** Apply threshold (pure B&W) */
+    threshold?(input: ImageBlob, value?: number): Promise<ImageBlob>;
+    /** Adjust brightness, saturation, hue, lightness */
+    modulate?(input: ImageBlob, opts: {
+        brightness?: number;
+        saturation?: number;
+        hue?: number;
+        lightness?: number;
+    }): Promise<ImageBlob>;
+    /** Apply color tint overlay */
+    tint?(input: ImageBlob, color: string | {
+        r: number;
+        g: number;
+        b: number;
+    }): Promise<ImageBlob>;
+    /** Add borders to image */
+    extend?(input: ImageBlob, opts: {
+        top: number;
+        bottom: number;
+        left: number;
+        right: number;
+        background?: string | {
+            r: number;
+            g: number;
+            b: number;
+            alpha?: number;
+        };
+    }): Promise<ImageBlob>;
+    /** Extract a region from image */
+    extract?(input: ImageBlob, region: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    }): Promise<ImageBlob>;
+    /** Round corners of image */
+    roundCorners?(input: ImageBlob, radius: number): Promise<ImageBlob>;
+    /** Add text to image */
+    addText?(input: ImageBlob, options: Record<string, unknown>): Promise<ImageBlob>;
+    /** Add caption bar to image */
+    addCaption?(input: ImageBlob, options: Record<string, unknown>): Promise<ImageBlob>;
+    /** Apply preset filter */
+    preset?(input: ImageBlob, presetName: string): Promise<ImageBlob>;
+}
+/**
+ * Cloud storage provider interface
+ */
+export interface StoreProvider {
+    /** Provider name */
+    name: string;
+    /** Upload an image to storage */
+    put(input: {
+        key: string;
+        blob: ImageBlob;
+        headers?: Record<string, string>;
+    }): Promise<UploadResult>;
+    /** Get public URL for a stored image (optional) */
+    getUrl?(key: string): Promise<string>;
+}
+/**
+ * Input for generate operation
+ */
+export interface GenerateInput {
+    /** Generator name (e.g., 'shapes', 'openai', 'trianglify') */
+    generator: string;
+    /** Generator-specific parameters */
+    params?: Record<string, unknown>;
+}
+/**
+ * Input for transform operation
+ */
+export interface TransformInput {
+    /** Image blob to transform */
+    blob: ImageBlob;
+    /** Operation to perform */
+    op: "convert" | "resize" | "composite" | "optimizeSvg" | "blur" | "sharpen" | "grayscale" | "negate" | "normalize" | "threshold" | "modulate" | "tint" | "extend" | "extract" | "roundCorners" | "addText" | "addCaption" | "preset";
+    /** Target MIME type (for convert operation) */
+    to?: MimeType;
+    /** Additional operation parameters */
+    params?: Record<string, unknown>;
+}
+/**
+ * Input for save operation (supports filesystem and cloud)
+ */
+export interface SaveInput {
+    /** Destination path or key */
+    path: string;
+    /** Save provider name (auto-detected if not specified) */
+    provider?: string;
+    /** Overwrite existing file (default: true) */
+    overwrite?: boolean;
+    /** File permissions for filesystem (default: 0o644) */
+    chmod?: number;
+    /** Custom headers for cloud uploads */
+    headers?: Record<string, string>;
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result from saving an image
+ */
+export interface SaveResult {
+    /** Provider used ('fs', 's3', 'r2', etc.) */
+    provider: string;
+    /** Location where saved (file path or URL) */
+    location: string;
+    /** File size in bytes */
+    size: number;
+    /** MIME type */
+    mime: MimeType;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Save provider interface (unified for filesystem and cloud)
+ */
+export interface SaveProvider {
+    /** Provider name */
+    name: string;
+    /** Save an image */
+    save(input: {
+        blob: ImageBlob;
+        path: string;
+        [key: string]: unknown;
+    }): Promise<SaveResult>;
+}
+/**
+ * Input for upload operation
+ * @deprecated Use save() instead
+ */
+export interface UploadInput {
+    /** Image blob to upload */
+    blob: ImageBlob;
+    /** Storage key/path */
+    key: string;
+    /** Storage provider name (uses default if not specified) */
+    provider?: string;
+    /** Custom headers to send with upload */
+    headers?: Record<string, string>;
+}
+/**
+ * Pipeline step definitions
+ */
+export type PipelineStep = {
+    kind: "generate";
+    generator: string;
+    params?: Record<string, unknown>;
+    out: string;
+} | {
+    kind: "transform";
+    op: "convert" | "resize" | "composite" | "optimizeSvg" | "blur" | "sharpen" | "grayscale" | "negate" | "normalize" | "threshold" | "modulate" | "tint" | "extend" | "extract" | "roundCorners" | "addText" | "addCaption" | "preset";
+    in: string;
+    params: Record<string, unknown>;
+    out: string;
+} | {
+    kind: "save";
+    provider?: string;
+    in: string;
+    destination: string;
+    out?: string;
+};
+/**
+ * Pipeline definition
+ */
+export interface Pipeline {
+    /** Pipeline name */
+    name?: string;
+    /** Steps to execute */
+    steps: PipelineStep[];
+    /** Maximum concurrent steps */
+    concurrency?: number;
+    /** Output directory for intermediate files */
+    outDir?: string;
+}
+/**
+ * Result from running a pipeline
+ */
+export interface PipelineResult {
+    /** Step that was executed */
+    step: PipelineStep;
+    /** Output variable name */
+    out: string;
+    /** Result value (ImageBlob or SaveResult) */
+    value: ImageBlob | SaveResult;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core types for floimg
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import { Floimg } from "./core/client.js";
+import type { FloimgConfig } from "./core/types.js";
+export type { FloimgConfig, ImageBlob, MimeType, ImageGenerator, TransformProvider, StoreProvider, GenerateInput, TransformInput, UploadInput, UploadResult, Pipeline, PipelineStep, PipelineResult, ParameterSchema, GeneratorSchema, TransformOperationSchema, SaveProviderSchema, ClientCapabilities, SvgProvider, AiProvider, } from "./core/types.js";
+export { FloimgError, ProviderNotFoundError, ConfigurationError, TransformError, UploadError, GenerationError, } from "./core/errors.js";
+export { ShapesProvider } from "./providers/svg/index.js";
+export { OpenAIGenerator } from "./providers/ai/index.js";
+export type { OpenAIConfig, OpenAIGenerateParams } from "./providers/ai/index.js";
+export { SharpTransformProvider } from "./providers/transform/index.js";
+export { default as FsSaveProvider } from "./providers/save/FsSaveProvider.js";
+export { default as S3SaveProvider } from "./providers/save/S3SaveProvider.js";
+export type { S3SaveProviderConfig } from "./providers/save/S3SaveProvider.js";
+/**
+ * Create a floimg client with automatic provider registration
+ */
+export declare function createClient(config?: FloimgConfig): Floimg;
+export { Floimg };
+export default createClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAM1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,YAAY,EACV,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,cAAc,EACd,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,cAAc,EAEd,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAElB,WAAW,EACX,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC/E,YAAY,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,YAAiB,GAAG,MAAM,CA+B9D;AAGD,OAAO,EAAE,MAAM,EAAE,CAAC;AAGlB,eAAe,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,49 @@
+import { Floimg } from "./core/client.js";
+import { ShapesProvider } from "./providers/svg/index.js";
+import { OpenAIGenerator } from "./providers/ai/index.js";
+import { SharpTransformProvider } from "./providers/transform/index.js";
+import FsSaveProvider from "./providers/save/FsSaveProvider.js";
+import S3SaveProvider from "./providers/save/S3SaveProvider.js";
+// Export errors
+export { FloimgError, ProviderNotFoundError, ConfigurationError, TransformError, UploadError, GenerationError, } from "./core/errors.js";
+// Export generators and providers
+export { ShapesProvider } from "./providers/svg/index.js";
+export { OpenAIGenerator } from "./providers/ai/index.js";
+export { SharpTransformProvider } from "./providers/transform/index.js";
+// Export save providers
+export { default as FsSaveProvider } from "./providers/save/FsSaveProvider.js";
+export { default as S3SaveProvider } from "./providers/save/S3SaveProvider.js";
+/**
+ * Create a floimg client with automatic provider registration
+ */
+export function createClient(config = {}) {
+    const client = new Floimg(config);
+    // Register built-in generators
+    client.registerGenerator(new ShapesProvider());
+    // Register AI generators if configured
+    if (config.ai?.openai) {
+        const openaiConfig = config.ai.openai;
+        client.registerGenerator(new OpenAIGenerator(openaiConfig));
+    }
+    // Register built-in transform providers
+    client.registerTransformProvider(new SharpTransformProvider());
+    // Register save providers
+    // Always register filesystem provider (default, zero-config)
+    const fsConfig = config.save?.fs || {};
+    client.registerSaveProvider(new FsSaveProvider(fsConfig));
+    // Register S3 save provider if configured with required fields
+    if (config.save?.s3?.bucket && config.save?.s3?.region) {
+        client.registerSaveProvider(new S3SaveProvider({
+            bucket: config.save.s3.bucket,
+            region: config.save.s3.region,
+            endpoint: config.save.s3.endpoint,
+            credentials: config.save.s3.credentials,
+        }));
+    }
+    return client;
+}
+// Export the client class
+export { Floimg };
+// Default export
+export default createClient;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,cAAc,MAAM,oCAAoC,CAAC;AAChE,OAAO,cAAc,MAAM,oCAAoC,CAAC;AA6BhE,gBAAgB;AAChB,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,kCAAkC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE,wBAAwB;AACxB,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAG/E;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,SAAuB,EAAE;IACpD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;IAElC,+BAA+B;IAC/B,MAAM,CAAC,iBAAiB,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC;IAE/C,uCAAuC;IACvC,IAAI,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC,MAAa,CAAC;QAC7C,MAAM,CAAC,iBAAiB,CAAC,IAAI,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,wCAAwC;IACxC,MAAM,CAAC,yBAAyB,CAAC,IAAI,sBAAsB,EAAE,CAAC,CAAC;IAE/D,0BAA0B;IAC1B,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC;IACvC,MAAM,CAAC,oBAAoB,CAAC,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE1D,+DAA+D;IAC/D,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;QACvD,MAAM,CAAC,oBAAoB,CAAC,IAAI,cAAc,CAAC;YAC7C,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM;YAC7B,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM;YAC7B,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ;YACjC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW;SACxC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0BAA0B;AAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,iBAAiB;AACjB,eAAe,YAAY,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":""}