@molecule/api-code-sandbox-docker 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Docker sandbox provider configuration.
+ *
+ * @module
+ */
+/**
+ * Configuration for docker.
+ */
+export interface DockerConfig {
+    /**
+     * Docker unix-socket path. Defaults to `/var/run/docker.sock` (or the
+     * `DOCKER_SOCKET_PATH` env var). This is the default transport; it is ignored
+     * when a TCP endpoint is selected via `host`/`port` or a `tcp://` `DOCKER_HOST`.
+     */
+    socketPath?: string;
+    /**
+     * Connect to a remote/TCP Docker daemon at this host instead of the unix
+     * socket. When set, the provider issues all Docker Engine API calls over
+     * plain TCP to `host:port` (`port` defaults to 2375) and `socketPath` is
+     * ignored. Also honored via `DOCKER_HOST` (`tcp://host:port`). Plain
+     * (unencrypted) TCP only — for a TLS-protected daemon (2376) front it with a
+     * local socket proxy and point `socketPath` at that.
+     */
+    host?: string;
+    /** TCP port for `host` (default 2375). Ignored unless `host` (or a `tcp://` `DOCKER_HOST`) selects a TCP endpoint. */
+    port?: number;
+    /** Base image for sandbox containers. Defaults to node:22-slim. Must already be present on the host — the provider never pulls images. */
+    baseImage?: string;
+    /** Default CPU allocation (cores). */
+    defaultCpu?: number;
+    /** Default memory allocation (MB). */
+    defaultMemoryMB?: number;
+    /**
+     * Docker network the sandbox containers attach to (sets each container's
+     * `NetworkMode`). Overrides the `SANDBOX_DOCKER_NETWORK` env var. Defaults to
+     * the ICC-off isolated `molecule-sandbox` network, auto-created on first use so
+     * tenants are L2-isolated by default. Setting it to the shared `bridge` gives NO
+     * cross-tenant isolation and is refused in production. [C1-1]
+     */
+    network?: string;
+    /** Container label prefix for identification. */
+    labelPrefix?: string;
+    /** Preview URL template. Use {port} placeholder. */
+    previewUrlTemplate?: string;
+}
+/**
+ * Container Info interface.
+ */
+export interface ContainerInfo {
+    id: string;
+    name: string;
+    status: string;
+    ports: Array<{
+        host: number;
+        container: number;
+    }>;
+}
+/**
+ * Environment variables the Docker sandbox provider reads.
+ */
+export interface ProcessEnv {
+    /** Unix-socket path for the Docker daemon (default `/var/run/docker.sock`). Overridden by `config.socketPath`. */
+    DOCKER_SOCKET_PATH?: string;
+    /** Docker daemon endpoint, docker-client style: `tcp://host:port` or `unix:///path/to/docker.sock`. Overridden by `config.host`/`config.socketPath`. */
+    DOCKER_HOST?: string;
+    /** Docker network sandbox containers attach to (default `molecule-sandbox`, ICC-off). Overridden by `config.network`. [C1-1] */
+    SANDBOX_DOCKER_NETWORK?: string;
+}
+//# 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":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sHAAsH;IACtH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0IAA0I;IAC1I,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kHAAkH;IAClH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,wJAAwJ;IACxJ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gIAAgI;IAChI,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Docker sandbox provider configuration.
+ *
+ * @module
+ */
+export {};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@molecule/api-code-sandbox-docker",
+  "version": "1.0.0",
+  "description": "Docker-based code sandbox container provider",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "molecule",
+    "sandbox",
+    "docker",
+    "container",
+    "code-execution"
+  ],
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@molecule/api-bond": "1.0.0",
+    "@molecule/api-code-sandbox": "1.0.0",
+    "@types/node": "26.1.2",
+    "typescript": "6.0.3",
+    "vitest": "4.1.10"
+  },
+  "peerDependencies": {
+    "@molecule/api-bond": "^1.0.0",
+    "@molecule/api-code-sandbox": "^1.0.0",
+    "@molecule/api-i18n": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@molecule/api-code-sandbox": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/molecule-dev/molecule.git",
+    "directory": "packages/api/bonds/code-sandbox/docker"
+  },
+  "homepage": "https://github.com/molecule-dev/molecule/tree/main/packages/api/bonds/code-sandbox/docker",
+  "bugs": "https://github.com/molecule-dev/molecule/issues",
+  "publishConfig": {
+    "access": "public"
+  }
+}