@isol8/core 0.13.0-alpha.0

package/dist/runtime/adapters/bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.d.ts","sourceRoot":"","sources":["../../../src/runtime/adapters/bun.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,UAAU,EAAE,cAcxB,CAAC"}

package/dist/runtime/adapters/deno.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Deno runtime adapter — uses `deno` from the `isol8:deno` image.
+ *
+ * Uses `.mts` extension to avoid collision with Bun's `.ts`.
+ * Permissions are scoped: read/write to /sandbox, env access, and
+ * optionally net access (controlled by the engine's network mode).
+ */
+import type { RuntimeAdapter } from "../adapter";
+export declare const DenoAdapter: RuntimeAdapter;
+//# sourceMappingURL=deno.d.ts.map

package/dist/runtime/adapters/deno.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deno.d.ts","sourceRoot":"","sources":["../../../src/runtime/adapters/deno.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,WAAW,EAAE,cAsBzB,CAAC"}

package/dist/runtime/adapters/node.d.ts

@@ -0,0 +1,4 @@
+/** Node.js runtime adapter — uses `node` from the `isol8:node` image. */
+import type { RuntimeAdapter } from "../adapter";
+export declare const NodeAdapter: RuntimeAdapter;
+//# sourceMappingURL=node.d.ts.map

package/dist/runtime/adapters/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/runtime/adapters/node.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,WAAW,EAAE,cAczB,CAAC"}

package/dist/runtime/adapters/python.d.ts

@@ -0,0 +1,4 @@
+/** Python runtime adapter — uses `python3` from the `isol8:python` image. */
+import type { RuntimeAdapter } from "../adapter";
+export declare const PythonAdapter: RuntimeAdapter;
+//# sourceMappingURL=python.d.ts.map

package/dist/runtime/adapters/python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../../src/runtime/adapters/python.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,aAAa,EAAE,cAc3B,CAAC"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module runtime
+ *
+ * Barrel module that registers all built-in runtime adapters and re-exports
+ * the public API. Importing this module has the side effect of populating
+ * the {@link RuntimeRegistry} with Python, Node, Bun, and Deno adapters.
+ */
+export type { RuntimeAdapter } from "./adapter";
+export { RuntimeRegistry } from "./adapter";
+export { bashAdapter } from "./adapters/bash";
+export { BunAdapter } from "./adapters/bun";
+export { DenoAdapter } from "./adapters/deno";
+export { NodeAdapter } from "./adapters/node";
+export { PythonAdapter } from "./adapters/python";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,532 @@
+/**
+ * @module types
+ *
+ * Core type definitions for isol8. All public interfaces used by
+ * the library, CLI, server, and client are defined here.
+ */
+/**
+ * Supported code execution runtimes.
+ *
+ * - `"python"` — CPython 3.x
+ * - `"node"` — Node.js LTS
+ * - `"bun"` — Bun runtime
+ * - `"deno"` — Deno runtime
+ * - `"bash"` — Bash shell
+ */
+export type Runtime = "python" | "node" | "bun" | "deno" | "bash";
+/**
+ * Network access mode for isol8 containers.
+ *
+ * - `"none"` — All network access blocked (default, most secure).
+ * - `"host"` — Full host network access (use with caution).
+ * - `"filtered"` — HTTP/HTTPS traffic routed through a proxy that enforces
+ *   whitelist/blacklist regex rules on hostnames.
+ */
+export type NetworkMode = "none" | "host" | "filtered";
+/**
+ * A request to execute code inside isol8.
+ */
+export interface ExecutionRequest {
+    /**
+     * Source code to execute.
+     * Mutually exclusive with {@link codeUrl}.
+     */
+    code?: string;
+    /**
+     * Remote URL to fetch source code from before execution.
+     * Mutually exclusive with {@link code}.
+     */
+    codeUrl?: string;
+    /** Expected SHA-256 hash (hex) of the fetched source code. */
+    codeHash?: string;
+    /**
+     * Allow `http://` code URLs for this request.
+     * By default, only `https://` is allowed.
+     */
+    allowInsecureCodeUrl?: boolean;
+    /** Target runtime. Must match a registered {@link RuntimeAdapter}. */
+    runtime: Runtime;
+    /**
+     * Execution timeout in milliseconds. Overrides the default.
+     * The container is killed if this limit is exceeded.
+     */
+    timeoutMs?: number;
+    /**
+     * Additional environment variables injected into the container.
+     * Keys matching secret names will be masked in output.
+     */
+    env?: Record<string, string>;
+    /**
+     * Optional file extension to use for the script file (e.g. ".cjs", ".mjs").
+     * If not provided, defaults to the runtime adapter's default extension.
+     */
+    fileExtension?: string;
+    /**
+     * Data to pipe to the process via stdin.
+     * Written to a temporary file and piped into the command.
+     */
+    stdin?: string;
+    /**
+     * Files to inject into the container before execution.
+     * Keys are absolute paths inside the container, values are file contents.
+     */
+    files?: Record<string, string | Buffer>;
+    /**
+     * Absolute paths of files to retrieve from the container after execution.
+     * Retrieved files are included in {@link ExecutionResult.files} as base64 strings.
+     */
+    outputPaths?: string[];
+    /**
+     * Packages to install before execution via the runtime's package manager.
+     * e.g. `["numpy", "pandas"]` for Python or `["lodash"]` for Node.
+     */
+    installPackages?: string[];
+    /**
+     * Additional metadata to include in audit logs (userId, tenantId, etc.).
+     * Passed through to audit logs when audit logging is enabled.
+     */
+    metadata?: Record<string, string>;
+}
+/**
+ * The result of a code execution.
+ */
+export interface ExecutionResult {
+    /** Captured standard output (may be truncated). */
+    stdout: string;
+    /** Captured standard error. */
+    stderr: string;
+    /** Process exit code. `0` indicates success. */
+    exitCode: number;
+    /** Wall-clock execution time in milliseconds. */
+    durationMs: number;
+    /** `true` if stdout was truncated due to exceeding {@link Isol8Options.maxOutputSize}. */
+    truncated: boolean;
+    /** Unique identifier for this execution. */
+    executionId: string;
+    /** Runtime used for this execution. */
+    runtime: Runtime;
+    /** ISO 8601 timestamp of when execution started. */
+    timestamp: string;
+    /** Docker container ID (if available). */
+    containerId?: string;
+    /**
+     * Files retrieved from the container after execution.
+     * Keys are paths, values are base64-encoded file contents.
+     * Only populated when {@link ExecutionRequest.outputPaths} is specified.
+     */
+    files?: Record<string, string>;
+    /**
+     * Resource usage metrics collected during execution.
+     * Only populated when audit logging with trackResources is enabled.
+     */
+    resourceUsage?: {
+        /** CPU usage as percentage (0-100 * num_cores) */
+        cpuPercent: number;
+        /** Current memory usage in megabytes */
+        memoryMB: number;
+        /** Peak memory usage in megabytes (if tracked) */
+        peakMemoryMB?: number;
+        /** Bytes received during execution */
+        networkBytesIn: number;
+        /** Bytes sent during execution */
+        networkBytesOut: number;
+    };
+    /**
+     * Network request logs collected during execution.
+     * Only populated when `logNetwork` is enabled and network mode is "filtered".
+     */
+    networkLogs?: NetworkLogEntry[];
+} /**
+ * A chunk of streaming output from an execution.
+ *
+ * Yielded by {@link Isol8Engine.executeStream} as output arrives in real-time.
+ */
+export interface StreamEvent {
+    /** Event type: output chunk, process exit, or error. */
+    type: "stdout" | "stderr" | "exit" | "error";
+    /** Text content for stdout/stderr, exit code string for exit, error message for error. */
+    data: string;
+}
+/**
+ * Security events raised during execution (policy violations, alerts).
+ */
+export interface SecurityEvent {
+    type: string;
+    message: string;
+    details?: Record<string, unknown>;
+    timestamp: string;
+}
+/**
+ * A network request logged by the proxy in filtered network mode.
+ */
+export interface NetworkLogEntry {
+    /** ISO 8601 timestamp of when the request was made. */
+    timestamp: string;
+    /** HTTP method (GET, POST, CONNECT, etc.). */
+    method: string;
+    /** Target hostname. */
+    host: string;
+    /** Request path for HTTP requests, null for HTTPS CONNECT tunnels. */
+    path: string | null;
+    /** Whether the request was allowed through or blocked by the filter. */
+    action: "ALLOW" | "BLOCK";
+    /** Time taken to handle the request in milliseconds. */
+    durationMs: number;
+}
+/**
+ * Audit record for an execution. Stored in immutable append-only logs.
+ */
+export interface ExecutionAudit {
+    executionId: string;
+    userId: string;
+    timestamp: string;
+    runtime: Runtime;
+    codeHash: string;
+    containerId: string;
+    exitCode: number;
+    durationMs: number;
+    resourceUsage?: {
+        /** CPU usage as percentage (0-100 * num_cores) */
+        cpuPercent: number;
+        /** Current memory usage in megabytes */
+        memoryMB: number;
+        /** Peak memory usage in megabytes (if tracked) */
+        peakMemoryMB?: number;
+        /** Bytes received during execution */
+        networkBytesIn: number;
+        /** Bytes sent during execution */
+        networkBytesOut: number;
+    };
+    securityEvents?: SecurityEvent[];
+    networkLogs?: NetworkLogEntry[];
+    code?: string;
+    stdout?: string;
+    stderr?: string;
+    metadata?: Record<string, string>;
+}
+/**
+ * Isol8 lifecycle mode.
+ *
+ * - `"ephemeral"` — A new container is created and destroyed for each `execute()` call.
+ * - `"persistent"` — A single long-lived container is reused across `execute()` calls,
+ *   preserving filesystem state between runs.
+ */
+export type Isol8Mode = "ephemeral" | "persistent";
+/**
+ * Options for configuring an isol8 instance.
+ */
+export interface Isol8Options {
+    /** Lifecycle mode. @default "ephemeral" */
+    mode?: Isol8Mode;
+    /** Network access mode. @default "none" */
+    network?: NetworkMode;
+    /** Hostname-based network filtering rules (only used when `network` is `"filtered"`). */
+    networkFilter?: NetworkFilterConfig;
+    /** CPU limit as a fraction of one core (e.g. `0.5` = half a core). @default 1.0 */
+    cpuLimit?: number;
+    /** Memory limit string (e.g. `"512m"`, `"1g"`). @default "512m" */
+    memoryLimit?: string;
+    /** Maximum number of processes allowed inside the container. @default 64 */
+    pidsLimit?: number;
+    /** Mount the root filesystem as read-only. @default true */
+    readonlyRootFs?: boolean;
+    /** Maximum output size in bytes before truncation. @default 1048576 (1MB) */
+    maxOutputSize?: number;
+    /**
+     * Secret values to pass as environment variables. Their values are automatically
+     * masked (replaced with `***`) in stdout/stderr output.
+     */
+    secrets?: Record<string, string>;
+    /** Default execution timeout in milliseconds. @default 30000 */
+    timeoutMs?: number;
+    /** Override the Docker image (ignores runtime adapter image). */
+    image?: string;
+    /** Size of the `/sandbox` tmpfs mount (e.g. `"64m"`, `"256m"`). Packages installed with `--install` are stored here. @default "512m" */
+    sandboxSize?: string;
+    /** Size of the `/tmp` tmpfs mount (e.g. `"64m"`, `"128m"`). @default "256m" */
+    tmpSize?: string;
+    /** Enable debug logging. @default false */
+    debug?: boolean;
+    /**
+     * Keep the container running after execution for inspection/debugging.
+     * When true, the container is not cleaned up or returned to the pool.
+     * @default false
+     */
+    persist?: boolean;
+    /**
+     * Enable network request logging. Only works when network mode is "filtered".
+     * Logs are collected from the proxy and included in ExecutionResult.
+     * @default false
+     */
+    logNetwork?: boolean;
+    /** Security settings. */
+    security?: SecurityConfig;
+    /** Audit logging configuration. */
+    audit?: AuditConfig;
+    /** Remote code fetching policy. */
+    remoteCode?: RemoteCodePolicy;
+    /**
+     * Pool strategy for container reuse.
+     * - "secure": Clean container before returning (slower but ensures clean state)
+     * - "fast": Use dual-pool system - instant acquire, background cleanup (faster)
+     * @default "fast"
+     */
+    poolStrategy?: "secure" | "fast";
+    /**
+     * Pool size configuration.
+     * For "secure" mode: number of containers to keep warm
+     * For "fast" mode: { clean: number of ready containers, dirty: number being cleaned }
+     * @default 1 (for fast mode: { clean: 1, dirty: 1 })
+     */
+    poolSize?: number | {
+        clean: number;
+        dirty: number;
+    };
+    /**
+     * Runtime-specific dependencies used to resolve hashed custom image tags.
+     * When provided, isol8 will prefer `isol8:<runtime>-custom-<hash>` images
+     * derived from these dependency sets.
+     */
+    dependencies?: Isol8Dependencies;
+}
+/**
+ * Startup options for {@link Isol8Engine.start}.
+ */
+export interface StartOptions {
+    /**
+     * Pre-warm ephemeral container pools on startup.
+     *
+     * - `false` or omitted: no pre-warm (lazy behavior)
+     * - `true`: pre-warm all built-in runtimes
+     * - `{ runtimes: [...] }`: pre-warm only selected runtimes
+     */
+    prewarm?: boolean | {
+        runtimes?: Runtime[];
+    };
+}
+/**
+ * The core isol8 engine abstraction. Both {@link DockerIsol8} and {@link RemoteIsol8}
+ * implement this interface.
+ */
+export interface Isol8Engine {
+    /** Initialize the engine. Must be called before `execute()`. */
+    start(options?: StartOptions): Promise<void>;
+    /** Tear down the engine, stopping and removing any containers. */
+    stop(): Promise<void>;
+    /** Execute code and return the result. */
+    execute(req: ExecutionRequest): Promise<ExecutionResult>;
+    /**
+     * Upload a file into the container.
+     * Only available in persistent mode after at least one `execute()` call.
+     *
+     * @param path - Absolute path inside the container (e.g. `/sandbox/data.csv`).
+     * @param content - File contents as a string or Buffer.
+     */
+    putFile(path: string, content: Buffer | string): Promise<void>;
+    /**
+     * Download a file from the container.
+     * Only available in persistent mode.
+     *
+     * @param path - Absolute path inside the container.
+     * @returns File contents as a Buffer.
+     */
+    getFile(path: string): Promise<Buffer>;
+    /**
+     * Execute code and stream output chunks as they arrive.
+     *
+     * @param req - Execution request.
+     * @returns An async iterable of {@link StreamEvent} objects.
+     */
+    executeStream(req: ExecutionRequest): AsyncIterable<StreamEvent>;
+}
+/**
+ * Hostname-based network filter configuration for `"filtered"` network mode.
+ *
+ * Patterns are ECMAScript regular expressions matched against the hostname
+ * of outgoing HTTP/HTTPS requests.
+ *
+ * Evaluation order: blacklist is checked first — matching hosts are always denied.
+ * If a whitelist is provided, only matching hosts are permitted.
+ */
+export interface NetworkFilterConfig {
+    /** Regex patterns for allowed hostnames. If non-empty, only matching hosts are allowed. */
+    whitelist: string[];
+    /** Regex patterns for blocked hostnames. Matching hosts are always denied, even if whitelisted. */
+    blacklist: string[];
+}
+/** Policy for fetching remote source code. */
+export interface RemoteCodePolicy {
+    /** Enable URL-based source fetching. @default false */
+    enabled: boolean;
+    /** Allowed URL schemes. @default ["https"] */
+    allowedSchemes: string[];
+    /** Allowed hostname regex patterns. Empty means allow all (subject to blocklist). */
+    allowedHosts: string[];
+    /** Blocked hostname regex patterns. */
+    blockedHosts: string[];
+    /** Max fetched source size in bytes. @default 10485760 (10MB) */
+    maxCodeSize: number;
+    /** Fetch timeout in milliseconds. @default 30000 */
+    fetchTimeoutMs: number;
+    /** Require `ExecutionRequest.codeHash` for URL-based execution. @default false */
+    requireHash: boolean;
+    /** Cache support toggle for future use. @default true */
+    enableCache: boolean;
+    /** Cache TTL in seconds for future use. @default 3600 */
+    cacheTtl: number;
+}
+/** Configuration for default execution settings. */
+export interface Isol8Defaults {
+    /** Default timeout in milliseconds. @default 30000 */
+    timeoutMs: number;
+    /** Default memory limit. @default "512m" */
+    memoryLimit: string;
+    /** Default CPU limit (1.0 = one full core). @default 1.0 */
+    cpuLimit: number;
+    /** Default network mode. @default "none" */
+    network: NetworkMode;
+    /** Default size of the `/sandbox` tmpfs mount. @default "512m" */
+    sandboxSize: string;
+    /** Default size of the `/tmp` tmpfs mount. @default "256m" */
+    tmpSize: string;
+    /** Whether the root filesystem should be read-only. @default true */
+    readonlyRootFs: boolean;
+}
+/** Configuration for container cleanup and lifecycle. */
+export interface Isol8Cleanup {
+    /** Automatically prune idle persistent containers. @default true */
+    autoPrune: boolean;
+    /** Maximum idle time (ms) before pruning. One hour = 3600000. @default 3600000 */
+    maxContainerAgeMs: number;
+}
+/**
+ * Runtime-specific packages to bake into custom Docker images.
+ * Populated via `isol8.config.json` or CLI flags on `isol8 setup`.
+ */
+export interface Isol8Dependencies {
+    /** Python packages to install via pip. */
+    python?: string[];
+    /** Node.js packages to install globally via npm. */
+    node?: string[];
+    /** Bun packages to install globally. */
+    bun?: string[];
+    /** Deno module URLs to pre-cache. */
+    deno?: string[];
+    /** Bash packages to install via apk (Alpine). */
+    bash?: string[];
+}
+/**
+ * Security configuration for the execution environment.
+ */
+export interface SecurityConfig {
+    /**
+     * Seccomp profile mode.
+     * - "strict": Use the default strict profile (default).
+     * - "unconfined": Do not apply any seccomp profile.
+     * - "custom": Use the profile at `customProfilePath`.
+     */
+    seccomp?: "strict" | "unconfined" | "custom";
+    /** Path to a custom seccomp profile JSON file. Required if seccomp is "custom". */
+    customProfilePath?: string;
+}
+/** Configuration for audit logging. */
+export interface AuditConfig {
+    /** Enable audit logging. @default false */
+    enabled: boolean;
+    /** Destination for audit logs (filesystem, stdout) @default "filesystem" */
+    destination: "filesystem" | "stdout" | string;
+    /** Custom directory for audit log files @default undefined (uses ./.isol8_audit) */
+    logDir?: string;
+    /** Script to run after each log entry (receives file path as argument) @default undefined */
+    postLogScript?: string;
+    /** Track resource usage (CPU, memory, network) @default true */
+    trackResources: boolean;
+    /** Retention period for audit logs in days @default 90 */
+    retentionDays: number;
+    /** Whether to include the source code in audit logs @default false */
+    includeCode: boolean;
+    /** Whether to include output (stdout/stderr) in audit logs @default false */
+    includeOutput: boolean;
+}
+/**
+ * Top-level configuration schema for isol8.
+ *
+ * Loaded from `isol8.config.json` in the working directory or `~/.isol8/config.json`.
+ * Partial configs are deep-merged with built-in defaults.
+ *
+ * @see {@link loadConfig} for the loading/merge logic.
+ * @see `schema/isol8.config.schema.json` for the JSON Schema.
+ */
+export interface Isol8Config {
+    /** Maximum number of containers that can run concurrently. @default 10 */
+    maxConcurrent: number;
+    /** Default execution settings applied to all runs. */
+    defaults: Isol8Defaults;
+    /** Global network filtering rules for `"filtered"` mode. */
+    network: NetworkFilterConfig;
+    /** Container cleanup and lifecycle settings. */
+    cleanup: Isol8Cleanup;
+    /**
+     * Default ephemeral pool strategy used by `isol8 serve`.
+     * @default "fast"
+     */
+    poolStrategy: "secure" | "fast";
+    /**
+     * Default ephemeral pool size used by `isol8 serve`.
+     * @default { clean: 1, dirty: 1 }
+     */
+    poolSize: number | {
+        clean: number;
+        dirty: number;
+    };
+    /** Runtime-specific packages to bake into custom Docker images. */
+    dependencies: Isol8Dependencies;
+    /** Security settings. */
+    security: SecurityConfig;
+    /** Remote code fetching policy. */
+    remoteCode: RemoteCodePolicy;
+    /** Audit logging configuration. */
+    audit: AuditConfig;
+    /** Enable debug logging. @default false */
+    debug: boolean;
+}
+/**
+ * User configuration file schema (partial/optional version of Isol8Config).
+ * Used for generating the JSON Schema.
+ */
+export interface Isol8UserConfig {
+    /** JSON Schema URI for editor validation/completion. */
+    $schema?: string;
+    /** Enable debug logging. @default false */
+    debug?: boolean;
+    /** Maximum number of containers that can run concurrently. @default 10 */
+    maxConcurrent?: number;
+    /** Default execution settings applied to all runs. (Partial override allowed). */
+    defaults?: Partial<Isol8Defaults>;
+    /** Global network filtering rules for `"filtered"` mode. */
+    network?: Partial<NetworkFilterConfig>;
+    /** Container cleanup and lifecycle settings. (Partial override allowed). */
+    cleanup?: Partial<Isol8Cleanup>;
+    /**
+     * Default ephemeral pool strategy used by `isol8 serve`.
+     * @default "fast"
+     */
+    poolStrategy?: "secure" | "fast";
+    /**
+     * Default ephemeral pool size used by `isol8 serve`.
+     * @default { clean: 1, dirty: 1 }
+     */
+    poolSize?: number | {
+        clean: number;
+        dirty: number;
+    };
+    /** Runtime-specific packages to bake into custom Docker images. */
+    dependencies?: Isol8Dependencies;
+    /** Security settings. */
+    security?: SecurityConfig;
+    /** Remote code fetching policy. (Partial override allowed). */
+    remoteCode?: Partial<RemoteCodePolicy>;
+    /** Audit logging configuration. */
+    audit?: Partial<AuditConfig>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @module logger
+ *
+ * Centralized logging utility for isol8.
+ * Supports debug mode toggling and standardized log formatting.
+ */
+declare class Logger {
+    private debugMode;
+    /**
+     * Enable or disable debug logging.
+     */
+    setDebug(enabled: boolean): void;
+    /**
+     * Log a debug message. Only prints if debug mode is enabled.
+     */
+    debug(...args: unknown[]): void;
+    /**
+     * Log an info message. Always prints.
+     */
+    info(...args: unknown[]): void;
+    /**
+     * Log a warning message. Always prints.
+     */
+    warn(...args: unknown[]): void;
+    /**
+     * Log an error message. Always prints.
+     */
+    error(...args: unknown[]): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAM,MAAM;IACV,OAAO,CAAC,SAAS,CAAS;IAE1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO;IAIzB;;OAEG;IACH,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAMxB;;OAEG;IACH,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAIvB;;OAEG;IACH,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAIvB;;OAEG;IACH,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;CAGzB;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module version
+ *
+ * Exports the current version of isol8.
+ */
+/**
+ * Current version of isol8.
+ * @example
+ * ```typescript
+ * import { VERSION } from "isol8";
+ * console.log(`Using isol8 v${VERSION}`);
+ * ```
+ */
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,QAAsB,CAAC"}