@soederpop/luca 0.1.2 → 0.2.1

package/dist/node/features/docker.d.ts

@@ -0,0 +1,485 @@
+import { z } from 'zod';
+import { Feature } from '../feature.js';
+export declare const DockerContainerSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    image: z.ZodString;
+    status: z.ZodString;
+    ports: z.ZodArray<z.ZodString>;
+    created: z.ZodString;
+}, z.core.$strip>;
+export type DockerContainer = z.infer<typeof DockerContainerSchema>;
+export declare const DockerImageSchema: z.ZodObject<{
+    id: z.ZodString;
+    repository: z.ZodString;
+    tag: z.ZodString;
+    size: z.ZodString;
+    created: z.ZodString;
+}, z.core.$strip>;
+export type DockerImage = z.infer<typeof DockerImageSchema>;
+export declare const DockerStateSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    containers: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        image: z.ZodString;
+        status: z.ZodString;
+        ports: z.ZodArray<z.ZodString>;
+        created: z.ZodString;
+    }, z.core.$strip>>;
+    images: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        repository: z.ZodString;
+        tag: z.ZodString;
+        size: z.ZodString;
+        created: z.ZodString;
+    }, z.core.$strip>>;
+    isDockerAvailable: z.ZodBoolean;
+    lastError: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type DockerState = z.infer<typeof DockerStateSchema>;
+export declare const DockerOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    cached: z.ZodOptional<z.ZodBoolean>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+    dockerPath: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    autoRefresh: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type DockerOptions = z.infer<typeof DockerOptionsSchema>;
+/** Shell-like interface for executing commands against a Docker container */
+export interface DockerShell {
+    /** The ID of the container being targeted */
+    readonly containerId: string;
+    /** The result of the most recently executed command, or null if no command has been run */
+    readonly last: {
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    } | null;
+    /** Execute a command string in the container via sh -c */
+    run(command: string): Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+    /** Destroy the shell container (only needed when volumes created a new container) */
+    destroy(): Promise<void>;
+}
+/**
+ * Docker CLI interface feature for managing containers, images, and executing Docker commands.
+ *
+ * Provides comprehensive Docker operations including:
+ * - Container management (list, start, stop, create, remove)
+ * - Image management (list, pull, build, remove)
+ * - Command execution inside containers
+ * - Docker system information
+ *
+ * @extends Feature
+ * @example
+ * ```typescript
+ * const docker = container.feature('docker', { enable: true })
+ * await docker.checkDockerAvailability()
+ * const containers = await docker.listContainers({ all: true })
+ * ```
+ */
+export declare class Docker extends Feature<DockerState, DockerOptions> {
+    static shortcut: "features.docker";
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        containers: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            image: z.ZodString;
+            status: z.ZodString;
+            ports: z.ZodArray<z.ZodString>;
+            created: z.ZodString;
+        }, z.core.$strip>>;
+        images: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            repository: z.ZodString;
+            tag: z.ZodString;
+            size: z.ZodString;
+            created: z.ZodString;
+        }, z.core.$strip>>;
+        isDockerAvailable: z.ZodBoolean;
+        lastError: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        enable: z.ZodOptional<z.ZodBoolean>;
+        dockerPath: z.ZodOptional<z.ZodString>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        autoRefresh: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    get initialState(): DockerState;
+    /**
+     * Get the proc feature for executing shell commands
+     */
+    private _resolvedDockerPath;
+    get proc(): import("./proc.js").ChildProcess;
+    /** Resolve the docker binary path via `which`, caching the result. Options take precedence. */
+    get dockerPath(): string;
+    /**
+     * Check if Docker is available and working.
+     *
+     * @returns Promise resolving to true if Docker CLI is accessible, false otherwise
+     * @example
+     * ```typescript
+     * const available = await docker.checkDockerAvailability()
+     * if (!available) console.log('Docker is not installed or not running')
+     * ```
+     */
+    checkDockerAvailability(): Promise<boolean>;
+    /**
+     * Execute a Docker command and return the result.
+     *
+     * @param args - Array of CLI arguments to pass to the docker binary
+     * @returns Promise resolving to an object with stdout, stderr, and exitCode
+     * @throws Error if Docker is not available
+     */
+    private executeDockerCommand;
+    /**
+     * List all containers (running and stopped).
+     *
+     * @param options - Listing options
+     * @param options.all - Include stopped containers (default: false)
+     * @returns Promise resolving to an array of DockerContainer objects
+     * @throws Error if the docker ps command fails
+     * @example
+     * ```typescript
+     * const running = await docker.listContainers()
+     * const all = await docker.listContainers({ all: true })
+     * ```
+     */
+    listContainers(options?: {
+        all?: boolean;
+    }): Promise<DockerContainer[]>;
+    /**
+     * List all images available locally.
+     *
+     * @returns Promise resolving to an array of DockerImage objects
+     * @throws Error if the docker images command fails
+     * @example
+     * ```typescript
+     * const images = await docker.listImages()
+     * console.log(images.map(i => `${i.repository}:${i.tag}`))
+     * ```
+     */
+    listImages(): Promise<DockerImage[]>;
+    /**
+     * Start a stopped container.
+     *
+     * @param containerIdOrName - Container ID or name to start
+     * @returns Promise that resolves when the container is started
+     * @throws Error if the container cannot be started
+     * @example
+     * ```typescript
+     * await docker.startContainer('my-app')
+     * ```
+     */
+    startContainer(containerIdOrName: string): Promise<void>;
+    /**
+     * Stop a running container.
+     *
+     * @param containerIdOrName - Container ID or name to stop
+     * @param timeout - Seconds to wait before killing the container
+     * @returns Promise that resolves when the container is stopped
+     * @throws Error if the container cannot be stopped
+     * @example
+     * ```typescript
+     * await docker.stopContainer('my-app')
+     * await docker.stopContainer('my-app', 30) // wait up to 30s
+     * ```
+     */
+    stopContainer(containerIdOrName: string, timeout?: number): Promise<void>;
+    /**
+     * Remove a container.
+     *
+     * @param containerIdOrName - Container ID or name to remove
+     * @param options - Removal options
+     * @param options.force - Force removal of a running container
+     * @returns Promise that resolves when the container is removed
+     * @throws Error if the container cannot be removed
+     * @example
+     * ```typescript
+     * await docker.removeContainer('old-container')
+     * await docker.removeContainer('stubborn-container', { force: true })
+     * ```
+     */
+    removeContainer(containerIdOrName: string, options?: {
+        force?: boolean;
+    }): Promise<void>;
+    /**
+     * Create and run a new container from the given image.
+     *
+     * @param image - Docker image to run (e.g. 'nginx:latest')
+     * @param options - Container run options
+     * @param options.name - Assign a name to the container
+     * @param options.ports - Port mappings in 'host:container' format (e.g. ['8080:80'])
+     * @param options.volumes - Volume mounts in 'host:container' format (e.g. ['./data:/app/data'])
+     * @param options.environment - Environment variables as key-value pairs
+     * @param options.detach - Run the container in the background
+     * @param options.interactive - Keep STDIN open
+     * @param options.tty - Allocate a pseudo-TTY
+     * @param options.command - Command and arguments to run inside the container
+     * @param options.workdir - Working directory inside the container
+     * @param options.user - Username or UID to run as
+     * @param options.entrypoint - Override the default entrypoint
+     * @param options.network - Connect the container to a network
+     * @param options.restart - Restart policy (e.g. 'always', 'on-failure')
+     * @returns Promise resolving to the container ID
+     * @throws Error if the container cannot be started
+     * @example
+     * ```typescript
+     * const containerId = await docker.runContainer('nginx:latest', {
+     *   name: 'web',
+     *   ports: ['8080:80'],
+     *   detach: true,
+     *   environment: { NODE_ENV: 'production' }
+     * })
+     * ```
+     */
+    runContainer(image: string, options?: {
+        /** Assign a name to the container */
+        name?: string;
+        /** Port mappings in 'host:container' format */
+        ports?: string[];
+        /** Volume mounts in 'host:container' format */
+        volumes?: string[];
+        /** Environment variables as key-value pairs */
+        environment?: Record<string, string>;
+        /** Run the container in the background */
+        detach?: boolean;
+        /** Keep STDIN open */
+        interactive?: boolean;
+        /** Allocate a pseudo-TTY */
+        tty?: boolean;
+        /** Command and arguments to run inside the container */
+        command?: string[];
+        /** Working directory inside the container */
+        workdir?: string;
+        /** Username or UID to run as */
+        user?: string;
+        /** Override the default entrypoint */
+        entrypoint?: string;
+        /** Connect the container to a network */
+        network?: string;
+        /** Restart policy (e.g. 'always', 'on-failure') */
+        restart?: string;
+    }): Promise<string>;
+    /**
+     * Execute a command inside a running container.
+     *
+     * When volumes are specified, uses `docker run --rm` with the container's image
+     * instead of `docker exec`, since exec does not support volume mounts.
+     *
+     * @param containerIdOrName - Container ID or name to execute in
+     * @param command - Command and arguments array (e.g. ['ls', '-la'])
+     * @param options - Execution options
+     * @param options.interactive - Keep STDIN open
+     * @param options.tty - Allocate a pseudo-TTY
+     * @param options.user - Username or UID to run as
+     * @param options.workdir - Working directory inside the container
+     * @param options.detach - Run the command in the background
+     * @param options.environment - Environment variables as key-value pairs
+     * @param options.volumes - Volume mounts; triggers a docker run --rm fallback
+     * @returns Promise resolving to an object with stdout, stderr, and exitCode
+     * @example
+     * ```typescript
+     * const result = await docker.execCommand('my-app', ['ls', '-la', '/app'])
+     * console.log(result.stdout)
+     * ```
+     */
+    execCommand(containerIdOrName: string, command: string[], options?: {
+        /** Keep STDIN open */
+        interactive?: boolean;
+        /** Allocate a pseudo-TTY */
+        tty?: boolean;
+        /** Username or UID to run as */
+        user?: string;
+        /** Working directory inside the container */
+        workdir?: string;
+        /** Run the command in the background */
+        detach?: boolean;
+        /** Environment variables as key-value pairs */
+        environment?: Record<string, string>;
+        /** Volume mounts; triggers a docker run --rm fallback */
+        volumes?: string[];
+    }): Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+    /**
+     * Look up the image name for a running container via docker inspect.
+     *
+     * @param containerIdOrName - Container ID or name to inspect
+     * @returns Promise resolving to the image name string
+     * @throws Error if the container cannot be inspected
+     */
+    private getContainerImage;
+    /**
+     * Create a shell-like wrapper for executing multiple commands against a container.
+     *
+     * When volume mounts are specified, a new long-running container is created from
+     * the same image with the mounts applied (since docker exec does not support volumes).
+     * Call `destroy()` when finished to clean up the helper container.
+     *
+     * Returns an object with:
+     * - `run(command)` — execute a shell command string via `sh -c`
+     * - `last` — getter for the most recent command result
+     * - `destroy()` — stop the helper container (no-op when no volumes were needed)
+     */
+    createShell(containerIdOrName: string, options?: {
+        volumes?: string[];
+        workdir?: string;
+        user?: string;
+        environment?: Record<string, string>;
+    }): Promise<DockerShell>;
+    /**
+     * Pull an image from a registry.
+     *
+     * @param image - Full image reference (e.g. 'nginx:latest', 'ghcr.io/org/repo:tag')
+     * @returns Promise that resolves when the pull is complete
+     * @throws Error if the pull fails
+     * @example
+     * ```typescript
+     * await docker.pullImage('node:20-alpine')
+     * ```
+     */
+    pullImage(image: string): Promise<void>;
+    /**
+     * Remove an image from the local store.
+     *
+     * @param imageIdOrName - Image ID, repository, or repository:tag to remove
+     * @param options - Removal options
+     * @param options.force - Force removal even if the image is in use
+     * @returns Promise that resolves when the image is removed
+     * @throws Error if the image cannot be removed
+     * @example
+     * ```typescript
+     * await docker.removeImage('nginx:latest')
+     * await docker.removeImage('old-image', { force: true })
+     * ```
+     */
+    removeImage(imageIdOrName: string, options?: {
+        force?: boolean;
+    }): Promise<void>;
+    /**
+     * Build an image from a Dockerfile.
+     *
+     * @param contextPath - Path to the build context directory
+     * @param options - Build options
+     * @param options.tag - Tag the resulting image (e.g. 'my-app:latest')
+     * @param options.dockerfile - Path to an alternate Dockerfile
+     * @param options.buildArgs - Build-time variables as key-value pairs
+     * @param options.target - Target build stage in a multi-stage Dockerfile
+     * @param options.nocache - Do not use cache when building the image
+     * @returns Promise that resolves when the build is complete
+     * @throws Error if the build fails
+     * @example
+     * ```typescript
+     * await docker.buildImage('./project', {
+     *   tag: 'my-app:latest',
+     *   buildArgs: { NODE_ENV: 'production' }
+     * })
+     * ```
+     */
+    buildImage(contextPath: string, options?: {
+        /** Tag the resulting image (e.g. 'my-app:latest') */
+        tag?: string;
+        /** Path to an alternate Dockerfile */
+        dockerfile?: string;
+        /** Build-time variables as key-value pairs */
+        buildArgs?: Record<string, string>;
+        /** Target build stage in a multi-stage Dockerfile */
+        target?: string;
+        /** Do not use cache when building the image */
+        nocache?: boolean;
+    }): Promise<void>;
+    /**
+     * Get container logs.
+     *
+     * @param containerIdOrName - Container ID or name to fetch logs from
+     * @param options - Log retrieval options
+     * @param options.follow - Follow log output (stream)
+     * @param options.tail - Number of lines to show from the end of the logs
+     * @param options.since - Show logs since a timestamp or relative time (e.g. '10m', '2024-01-01T00:00:00')
+     * @param options.timestamps - Prepend a timestamp to each log line
+     * @returns Promise resolving to the log output string
+     * @throws Error if logs cannot be retrieved
+     * @example
+     * ```typescript
+     * const logs = await docker.getLogs('my-app', { tail: 100, timestamps: true })
+     * console.log(logs)
+     * ```
+     */
+    getLogs(containerIdOrName: string, options?: {
+        /** Follow log output (stream) */
+        follow?: boolean;
+        /** Number of lines to show from the end of the logs */
+        tail?: number;
+        /** Show logs since a timestamp or relative time */
+        since?: string;
+        /** Prepend a timestamp to each log line */
+        timestamps?: boolean;
+    }): Promise<string>;
+    /**
+     * Get Docker system information (engine version, storage driver, OS, etc.).
+     *
+     * @returns Promise resolving to the parsed JSON system info object
+     * @throws Error if the system info command fails
+     * @example
+     * ```typescript
+     * const info = await docker.getSystemInfo()
+     * console.log(info.ServerVersion)
+     * ```
+     */
+    getSystemInfo(): Promise<any>;
+    /**
+     * Prune unused Docker resources.
+     *
+     * When no specific resource type is selected, falls back to `docker system prune`.
+     *
+     * @param options - Pruning options
+     * @param options.containers - Prune stopped containers
+     * @param options.images - Prune dangling images
+     * @param options.volumes - Prune unused volumes
+     * @param options.networks - Prune unused networks
+     * @param options.all - Prune all resource types (containers, images, volumes, networks)
+     * @param options.force - Skip confirmation prompts for image pruning
+     * @returns Promise that resolves when pruning is complete
+     * @example
+     * ```typescript
+     * await docker.prune({ all: true })
+     * await docker.prune({ containers: true, images: true })
+     * ```
+     */
+    prune(options?: {
+        /** Prune stopped containers */
+        containers?: boolean;
+        /** Prune dangling images */
+        images?: boolean;
+        /** Prune unused volumes */
+        volumes?: boolean;
+        /** Prune unused networks */
+        networks?: boolean;
+        /** Prune all resource types */
+        all?: boolean;
+        /** Skip confirmation prompts for image pruning */
+        force?: boolean;
+    }): Promise<void>;
+    /**
+     * Initialize the Docker feature by checking availability and optionally refreshing state.
+     *
+     * @param options - Enable options passed to the base Feature
+     * @returns Promise resolving to this Docker instance
+     */
+    enable(options?: any): Promise<this>;
+}
+export default Docker;
+//# sourceMappingURL=docker.d.ts.map

package/dist/node/features/docker.d.ts.map

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

package/dist/node/features/downloader.d.ts

@@ -0,0 +1,73 @@
+import { Feature } from '../feature.js';
+/**
+ * A feature that provides file downloading capabilities from URLs.
+ *
+ * The Downloader feature allows you to fetch files from remote URLs and save them
+ * to the local filesystem. It handles the network request, buffering, and file writing
+ * operations automatically.
+ *
+ * @example
+ * ```typescript
+ * // Enable the downloader feature
+ * const downloader = container.feature('downloader')
+ *
+ * // Download a file
+ * const localPath = await downloader.download(
+ *   'https://example.com/image.jpg',
+ *   'downloads/image.jpg'
+ * )
+ * console.log(`File saved to: ${localPath}`)
+ * ```
+ *
+ * @extends Feature
+ */
+export declare class Downloader extends Feature {
+    static shortcut: "features.downloader";
+    static stateSchema: import("zod").ZodObject<{
+        enabled: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$loose>;
+    static optionsSchema: import("zod").ZodObject<{
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        _cacheKey: import("zod").ZodOptional<import("zod").ZodString>;
+        cached: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        enable: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$strip>;
+    /**
+     * Downloads a file from a URL and saves it to the specified local path.
+     *
+     * This method fetches the file from the provided URL, converts it to a buffer,
+     * and writes it to the filesystem at the target path. The target path is resolved
+     * relative to the container's configured paths.
+     *
+     * @param {string} url - The URL to download the file from. Must be a valid HTTP/HTTPS URL.
+     * @param {string} targetPath - The local file path where the downloaded file should be saved.
+     *   This path will be resolved relative to the container's base path.
+     *
+     * @returns {Promise<string>} A promise that resolves to the absolute path of the saved file.
+     *
+     * @throws {Error} Throws an error if the URL is invalid or unreachable.
+     * @throws {Error} Throws an error if the target directory doesn't exist or is not writable.
+     * @throws {Error} Throws an error if the network request fails or times out.
+     * @throws {Error} Throws an error if there's insufficient disk space to save the file.
+     *
+     * @example
+     * ```typescript
+     * // Download an image file
+     * const imagePath = await downloader.download(
+     *   'https://example.com/photo.jpg',
+     *   'images/downloaded-photo.jpg'
+     * )
+     *
+     * // Download a document
+     * const docPath = await downloader.download(
+     *   'https://api.example.com/files/document.pdf',
+     *   'documents/report.pdf'
+     * )
+     * ```
+     *
+     * @since 1.0.0
+     */
+    download(url: string, targetPath: string): Promise<string>;
+}
+export default Downloader;
+//# sourceMappingURL=downloader.d.ts.map

package/dist/node/features/downloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloader.d.ts","sourceRoot":"","sources":["../../../src/node/features/downloader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAGvC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,UAAW,SAAQ,OAAO;IACrC,OAAgB,QAAQ,EAAG,qBAAqB,CAAS;IACzD,OAAgB,WAAW;;qCAAqB;IAChD,OAAgB,aAAa;;;;;qCAAuB;IAGpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAU/C;AAED,eAAe,UAAU,CAAA"}

package/dist/node/features/figlet-fonts.d.ts

@@ -0,0 +1,4 @@
+import figlet from "figlet/browser";
+export { figlet };
+export declare const fontNames: string[];
+//# sourceMappingURL=figlet-fonts.d.ts.map

package/dist/node/features/figlet-fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figlet-fonts.d.ts","sourceRoot":"","sources":["../../../src/node/features/figlet-fonts.ts"],"names":[],"mappings":"AA2SA,OAAO,MAAM,MAAM,gBAAgB,CAAC;AA2SpC,OAAO,EAAE,MAAM,EAAE,CAAC;AAClB,eAAO,MAAM,SAAS,EAAE,MAAM,EAA+qG,CAAC"}