@solarisdk/runloop-compat 0.0.0-stage → 0.1.0

package/dist/blueprint-types.d.ts

@@ -0,0 +1,522 @@
+import type * as Shared from './shared-types.js';
+import type { CursorIDPageParams } from './types.js';
+export type BlueprintsCursorIDPageParams = CursorIDPageParams;
+export interface BlueprintBuildLog {
+    /**
+     * Log line severity level.
+     */
+    level: string;
+    /**
+     * Log line message.
+     */
+    message: string;
+    /**
+     * Time of log (Unix timestamp milliseconds).
+     */
+    timestamp_ms: number;
+}
+export interface BlueprintBuildLogsListView {
+    /**
+     * ID of the Blueprint.
+     */
+    blueprint_id: string;
+    /**
+     * List of logs generated during Blueprint build.
+     */
+    logs: Array<BlueprintBuildLog>;
+}
+export interface BlueprintBuildParameters {
+    /**
+     * Name of the Blueprint.
+     */
+    name: string;
+    /**
+     * (Optional) ID of previously built blueprint to use as a base blueprint for this
+     * build.
+     */
+    base_blueprint_id?: string | null;
+    /**
+     * (Optional) Name of previously built blueprint to use as a base blueprint for
+     * this build. When set, this will load the latest successfully built Blueprint
+     * with the given name. Only one of (base_blueprint_id, base_blueprint_name) should
+     * be specified.
+     */
+    base_blueprint_name?: string | null;
+    /**
+     * (Optional) Arbitrary Docker build args to pass during build.
+     */
+    build_args?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * A build context backed by an Object.
+     */
+    build_context?: BlueprintBuildParameters.BuildContext | null;
+    /**
+     * A list of code mounts to be included in the Blueprint.
+     */
+    code_mounts?: Array<Shared.CodeMountParameters> | null;
+    /**
+     * Dockerfile contents to be used to build the Blueprint.
+     */
+    dockerfile?: string | null;
+    /**
+     * (Optional) Map of paths and file contents to write before setup..
+     */
+    file_mounts?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * LaunchParameters enable you to customize the resources available to your Devbox
+     * as well as the environment set up that should be completed before the Devbox is
+     * marked as 'running'.
+     */
+    launch_parameters?: Shared.LaunchParameters | null;
+    /**
+     * (Optional) User defined metadata for the Blueprint.
+     */
+    metadata?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * (Optional) ID of the network policy to apply during blueprint build. This
+     * restricts network access during the build process. This does not affect devboxes
+     * created from this blueprint; if you want devboxes created from this blueprint to
+     * inherit the network policy, set the network_policy_id on the blueprint launch
+     * parameters.
+     */
+    network_policy_id?: string | null;
+    /**
+     * (Optional) Map of mount IDs/environment variable names to secret names. Secrets
+     * will be available to commands during the build. Secrets are NOT stored in the
+     * blueprint image. Example: {"DB_PASS": "DATABASE_PASSWORD"} makes the secret
+     * 'DATABASE_PASSWORD' available as environment variable 'DB_PASS'.
+     */
+    secrets?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * (Optional) List of containerized services to include in the Blueprint. These
+     * services will be pre-pulled during the build phase for optimized startup
+     * performance.
+     */
+    services?: Array<BlueprintBuildParameters.Service> | null;
+    /**
+     * A list of commands to run to set up your system.
+     */
+    system_setup_commands?: Array<string> | null;
+}
+export declare namespace BlueprintBuildParameters {
+    /**
+     * A build context backed by an Object.
+     */
+    export interface BuildContext {
+        /**
+         * The ID of an object, whose contents are to be used as a build context.
+         */
+        object_id: string;
+        type: 'object';
+    }
+    export interface Service {
+        /**
+         * The image of the container service.
+         */
+        image: string;
+        /**
+         * The name of the container service.
+         */
+        name: string;
+        /**
+         * The credentials of the container service.
+         */
+        credentials?: Service.Credentials | null;
+        /**
+         * The environment variables of the container service.
+         */
+        env?: {
+            [key: string]: string;
+        } | null;
+        /**
+         * Additional Docker container create options.
+         */
+        options?: string | null;
+        /**
+         * The port mappings of the container service. Port mappings are in the format of
+         * <host_port>:<container_port>.
+         */
+        port_mappings?: Array<string> | null;
+    }
+    namespace Service {
+        /**
+         * The credentials of the container service.
+         */
+        interface Credentials {
+            /**
+             * The password of the container service.
+             */
+            password: string;
+            /**
+             * The username of the container service.
+             */
+            username: string;
+        }
+    }
+    export {};
+}
+export interface BlueprintListView {
+    /**
+     * List of blueprints matching filter.
+     */
+    blueprints: Array<BlueprintView>;
+    has_more: boolean;
+    total_count?: number | null;
+}
+export interface BlueprintPreviewView {
+    /**
+     * The Dockerfile contents that will built.
+     */
+    dockerfile: string;
+}
+/**
+ * Blueprints are ways to create customized starting points for Devboxes. They
+ * allow you to define custom starting points for Devboxes such that environment
+ * set up can be cached to improve Devbox boot times.
+ *
+ * @category Blueprint Types
+ */
+export interface BlueprintView {
+    /**
+     * The id of the Blueprint.
+     */
+    id: string;
+    /**
+     * Creation time of the Blueprint (Unix timestamp milliseconds).
+     */
+    create_time_ms: number;
+    /**
+     * The name of the Blueprint.
+     */
+    name: string;
+    /**
+     * The parameters used to create Blueprint.
+     */
+    parameters: BlueprintBuildParameters;
+    /**
+     * The state of the Blueprint.
+     */
+    state: 'created' | 'deleted';
+    /**
+     * The status of the Blueprint build.
+     */
+    status: 'queued' | 'provisioning' | 'building' | 'awaiting_upload' | 'failed' | 'build_complete';
+    /**
+     * The ID of the base Blueprint.
+     */
+    base_blueprint_id?: string | null;
+    /**
+     * Build completion time of the Blueprint (Unix timestamp milliseconds).
+     */
+    build_finish_time_ms?: number | null;
+    /**
+     * List of ContainerizedServices available in the Blueprint. Services can be
+     * explicitly started when creating a Devbox.
+     */
+    containerized_services?: Array<BlueprintView.ContainerizedService> | null;
+    /**
+     * Capabilities that will be available on Devbox.
+     */
+    devbox_capabilities?: Array<'unknown' | 'docker_in_docker'> | null;
+    /**
+     * The cause of the failure of the Blueprint build.
+     *
+     * out_of_memory: The build has run out of memory. Contact support if this is
+     * unexpected. out_of_disk: The build has run out of disk. Contact support if this
+     * is unexpected. build_failed: The build has failed. Use the dashboard to look at
+     * Blueprint build logs for more info.
+     */
+    failure_reason?: 'out_of_memory' | 'out_of_disk' | 'build_failed' | null;
+    /**
+     * Whether this Blueprint is publicly accessible to all users.
+     */
+    is_public?: boolean;
+    /**
+     * User defined metadata associated with the blueprint.
+     */
+    metadata?: {
+        [key: string]: string;
+    } | null;
+}
+export declare namespace BlueprintView {
+    export interface ContainerizedService {
+        /**
+         * The image of the container service.
+         */
+        image: string;
+        /**
+         * The name of the container service.
+         */
+        name: string;
+        /**
+         * The credentials of the container service.
+         */
+        credentials?: ContainerizedService.Credentials | null;
+        /**
+         * The environment variables of the container service.
+         */
+        env?: {
+            [key: string]: string;
+        } | null;
+        /**
+         * Additional Docker container create options.
+         */
+        options?: string | null;
+        /**
+         * The port mappings of the container service. Port mappings are in the format of
+         * <host_port>:<container_port>.
+         */
+        port_mappings?: Array<string> | null;
+    }
+    namespace ContainerizedService {
+        /**
+         * The credentials of the container service.
+         */
+        interface Credentials {
+            /**
+             * The password of the container service.
+             */
+            password: string;
+            /**
+             * The username of the container service.
+             */
+            username: string;
+        }
+    }
+    export {};
+}
+export type BlueprintDeleteResponse = unknown;
+/**
+ * Parameters for creating a new Blueprint.
+ *
+ * @category Blueprint Types
+ */
+export interface BlueprintCreateParams {
+    /**
+     * Name of the Blueprint.
+     */
+    name: string;
+    /**
+     * (Optional) ID of previously built blueprint to use as a base blueprint for this
+     * build.
+     */
+    base_blueprint_id?: string | null;
+    /**
+     * (Optional) Name of previously built blueprint to use as a base blueprint for
+     * this build. When set, this will load the latest successfully built Blueprint
+     * with the given name. Only one of (base_blueprint_id, base_blueprint_name) should
+     * be specified.
+     */
+    base_blueprint_name?: string | null;
+    /**
+     * (Optional) Arbitrary Docker build args to pass during build.
+     */
+    build_args?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * A build context backed by an Object.
+     */
+    build_context?: BlueprintCreateParams.BuildContext | null;
+    /**
+     * A list of code mounts to be included in the Blueprint.
+     */
+    code_mounts?: Array<Shared.CodeMountParameters> | null;
+    /**
+     * Dockerfile contents to be used to build the Blueprint.
+     */
+    dockerfile?: string | null;
+    /**
+     * (Optional) Map of paths and file contents to write before setup.
+     */
+    file_mounts?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * LaunchParameters enable you to customize the resources available to your Devbox
+     * as well as the environment set up that should be completed before the Devbox is
+     * marked as 'running'.
+     */
+    launch_parameters?: Shared.LaunchParameters | null;
+    /**
+     * (Optional) User defined metadata for the Blueprint.
+     */
+    metadata?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * (Optional) ID of the network policy to apply during blueprint build. This
+     * restricts network access during the build process. This does not affect devboxes
+     * created from this blueprint; if you want devboxes created from this blueprint to
+     * inherit the network policy, set the network_policy_id on the blueprint launch
+     * parameters.
+     */
+    network_policy_id?: string | null;
+    /**
+     * (Optional) Map of mount IDs/environment variable names to secret names. Secrets
+     * will be available to commands during the build. Secrets are NOT stored in the
+     * blueprint image. Example: {"DB_PASS": "DATABASE_PASSWORD"} makes the secret
+     * 'DATABASE_PASSWORD' available as environment variable 'DB_PASS'.
+     */
+    secrets?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * (Optional) List of containerized services to include in the Blueprint. These
+     * services will be pre-pulled during the build phase for optimized startup
+     * performance.
+     */
+    services?: Array<BlueprintCreateParams.Service> | null;
+    /**
+     * A list of commands to run to set up your system.
+     */
+    system_setup_commands?: Array<string> | null;
+}
+export declare namespace BlueprintCreateParams {
+    /**
+     * A build context backed by an Object.
+     */
+    export interface BuildContext {
+        /**
+         * The ID of an object, whose contents are to be used as a build context.
+         */
+        object_id: string;
+        type: 'object';
+    }
+    export interface Service {
+        /**
+         * The image of the container service.
+         */
+        image: string;
+        /**
+         * The name of the container service.
+         */
+        name: string;
+        /**
+         * The credentials of the container service.
+         */
+        credentials?: Service.Credentials | null;
+        /**
+         * The environment variables of the container service.
+         */
+        env?: {
+            [key: string]: string;
+        } | null;
+        /**
+         * Additional Docker container create options.
+         */
+        options?: string | null;
+        /**
+         * The port mappings of the container service. Port mappings are in the format of
+         * <host_port>:<container_port>.
+         */
+        port_mappings?: Array<string> | null;
+    }
+    namespace Service {
+        /**
+         * The credentials of the container service.
+         */
+        interface Credentials {
+            /**
+             * The password of the container service.
+             */
+            password: string;
+            /**
+             * The username of the container service.
+             */
+            username: string;
+        }
+    }
+    export {};
+}
+export interface BlueprintListParams extends BlueprintsCursorIDPageParams {
+    /**
+     * If true (default), includes total_count in the response. Set to false to skip
+     * the count query for better performance on large datasets.
+     */
+    include_total_count?: boolean;
+    /**
+     * Filter by name
+     */
+    name?: string;
+    /**
+     * Filter by build status (queued, provisioning, building, failed, build_complete)
+     */
+    status?: string;
+}
+export interface BlueprintListPublicParams extends BlueprintsCursorIDPageParams {
+    /**
+     * If true (default), includes total_count in the response. Set to false to skip
+     * the count query for better performance on large datasets.
+     */
+    include_total_count?: boolean;
+    /**
+     * Filter by name
+     */
+    name?: string;
+    /**
+     * Filter by build status (queued, provisioning, building, failed, build_complete)
+     */
+    status?: string;
+}
+export interface DevboxLogsListView {
+    /**
+     * List of logs for the given devbox.
+     */
+    logs: Array<DevboxLogsListView.Log>;
+}
+export declare namespace DevboxLogsListView {
+    interface Log {
+        /**
+         * Log line severity level.
+         */
+        level: string;
+        /**
+         * The source of the log.
+         */
+        source: 'setup_commands' | 'entrypoint' | 'exec' | 'files' | 'stats' | 'kmsg';
+        /**
+         * Time of log (Unix timestamp milliseconds).
+         */
+        timestamp_ms: number;
+        /**
+         * The Command Executed
+         */
+        cmd?: string | null;
+        /**
+         * Identifier of the associated command the log is sourced from.
+         */
+        cmd_id?: string | null;
+        /**
+         * The Exit Code of the command
+         */
+        exit_code?: number | null;
+        /**
+         * Log line message.
+         */
+        message?: string | null;
+        /**
+         * The Shell name the cmd executed in.
+         */
+        shell_name?: string | null;
+    }
+}
+export interface LogListParams {
+    /**
+     * ID of execution to filter logs by.
+     */
+    execution_id?: string;
+    /**
+     * Shell Name to filter logs by.
+     */
+    shell_name?: string;
+}
+//# sourceMappingURL=blueprint-types.d.ts.map

package/dist/blueprint-types.d.ts.map

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

package/dist/blueprint-types.js

@@ -0,0 +1,4 @@
+// Type definitions derived from @runloop/api-client 2.0.0 (https://github.com/runloopai/api-client-ts),
+// Copyright 2026 runloop, MIT licence. See NOTICE. Not affiliated with Runloop.
+export {};
+//# sourceMappingURL=blueprint-types.js.map

package/dist/blueprint-types.js.map

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

package/dist/blueprints.d.ts

@@ -0,0 +1,71 @@
+import type { BlueprintBuildLogsListView, BlueprintListView, BlueprintView } from "./blueprint-types.js";
+import type { Runloop, RequestOptions } from "./client.js";
+import type { DevboxCreateParams } from "./types.js";
+import type { Devbox } from "./sdk.js";
+export interface BlueprintCreateInput {
+    name: string;
+    dockerfile?: string | null;
+    system_setup_commands?: string[] | null;
+    file_mounts?: Record<string, string> | null;
+    base_blueprint_name?: string | null;
+    base_blueprint_id?: string | null;
+    build_args?: Record<string, string> | null;
+    /** A storage object from `sdk.storageObject.uploadFromDir`, or its `asBuildContext()` value. */
+    build_context?: {
+        type: "object";
+        object_id: string;
+    } | {
+        id: string;
+        asBuildContext(): {
+            type: "object";
+            object_id: string;
+        };
+    } | null;
+    launch_parameters?: DevboxCreateParams["launch_parameters"];
+    metadata?: Record<string, string> | null;
+    [k: string]: unknown;
+}
+export declare class Blueprints {
+    private readonly client;
+    constructor(client: Runloop);
+    /** A template name or id → the id/name `POST /sandboxes` takes: built-ins pass through, custom names resolve to the newest matching `tpl_` id. */
+    resolveTemplate(nameOrId: string): Promise<string>;
+    private listTemplates;
+    create(params: BlueprintCreateInput, _options?: RequestOptions): Promise<BlueprintView>;
+    /** Delete a template once its (unwanted) build has finished; a building template cannot be deleted. Best effort. */
+    private discardWhenDone;
+    retrieve(id: string, _options?: RequestOptions): Promise<BlueprintView>;
+    list(_params?: {
+        limit?: number;
+        name?: string;
+    }, _options?: RequestOptions): Promise<BlueprintListView>;
+    delete(id: string, _options?: RequestOptions): Promise<unknown>;
+    logs(id: string, _options?: RequestOptions): Promise<BlueprintBuildLogsListView>;
+    awaitBuildComplete(id: string, options?: RequestOptions): Promise<BlueprintView>;
+    createAndAwaitBuildComplete(params: BlueprintCreateInput, options?: RequestOptions): Promise<BlueprintView>;
+}
+/** Object-layer handle for a blueprint. */
+export declare class Blueprint {
+    private readonly client;
+    private readonly _id;
+    private readonly makeDevbox;
+    constructor(client: Runloop, _id: string, makeDevbox: (params: DevboxCreateParams) => Promise<Devbox>);
+    get id(): string;
+    getInfo(options?: RequestOptions): Promise<BlueprintView>;
+    logs(options?: RequestOptions): Promise<BlueprintBuildLogsListView>;
+    delete(options?: RequestOptions): Promise<unknown>;
+    createDevbox(params?: DevboxCreateParams): Promise<Devbox>;
+}
+export declare class BlueprintOps {
+    private readonly client;
+    private readonly makeDevbox;
+    constructor(client: Runloop, makeDevbox: (params: DevboxCreateParams) => Promise<Devbox>);
+    /** Build a blueprint and wait for it (deleted again if the build fails). */
+    create(params: BlueprintCreateInput, options?: RequestOptions): Promise<Blueprint>;
+    fromId(id: string): Blueprint;
+    list(params?: {
+        limit?: number;
+        name?: string;
+    }): Promise<Blueprint[]>;
+}
+//# sourceMappingURL=blueprints.d.ts.map

package/dist/blueprints.d.ts.map

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