@machine0/sdk 0.2.0 → 0.2.1

package/README.md

@@ -58,6 +58,7 @@ Notes:
 - Lifecycle mutations (`start`, `stop`, `reboot`, `suspend`, `destroy`) are asynchronous on the server — they return `{success: true}` immediately and the machine transitions through states (`STARTING`, `STOPPING`, …). Poll `get()` to observe progress.
 - `machines.create` responds before the image join exists, so the created machine lacks `image`/`distribution` — call `get()` if you need them right away.
 - `sshKeys.create({type: "MANAGED", name})` returns the plaintext `privateKey` — store it. (Managed keys are retrievable later through the CLI's `machine0 keys get <name> --download`; this SDK deliberately never requests the private key after creation.)
+- `get()`, `getByName()` and `update()` return the machine's creation-time environment variables as `env` (`{}` when it has none, `null` if they could not be read) — with their values, so don't log whole responses. `list()` never includes them.
 - All date fields are ISO-8601 strings.
 
 ## Options

package/dist/types.d.ts

@@ -112,6 +112,14 @@ export interface MachineDetail {
     statusExplanation: string | null;
     /** See {@link Machine.orderExpiresAt}. */
     orderExpiresAt: string | null;
+    /**
+     * The environment variables the machine was created with
+     * ({@link MachineCreateInput.env}) — its own variables only, not those it
+     * inherits from a profile. `{}` when it was created without any; `null` when
+     * they are stored but could not be read. Treat the values as secrets: don't
+     * log a whole `MachineDetail`.
+     */
+    env: Record<string, string> | null;
 }
 export interface DiskMount {
     diskName: string;
@@ -268,7 +276,7 @@ export interface SshKeyCreatedManaged extends SshKeyWithFile {
 }
 export declare const MACHINE_KEYS: readonly ["id", "name", "url", "status", "ip", "size", "region", "provider", "createdAt", "firstStartedAt", "destroyedAt", "image", "distribution", "ageMinutes", "totalCost", "pricePerHour", "metricsEnabled", "onIdle", "idleTimeoutMinutes", "orderExpiresAt"];
 export declare const MACHINE_CREATED_KEYS: readonly ["id", "name", "url", "status", "ip", "size", "region", "provider", "createdAt", "firstStartedAt", "destroyedAt", "ageMinutes", "totalCost", "pricePerHour", "metricsEnabled", "onIdle", "idleTimeoutMinutes", "orderExpiresAt", "envApplied"];
-export declare const MACHINE_DETAIL_KEYS: readonly ["id", "name", "url", "status", "ip", "size", "vcpu", "ram", "disk", "region", "provider", "createdAt", "firstStartedAt", "image", "imageVersion", "defaultSSHUsername", "sshClientInitialCommand", "metricsEnabled", "onIdle", "idleTimeoutMinutes", "distribution", "key", "ageMinutes", "totalCost", "pricePerHour", "mountPaths", "statusExplanation", "orderExpiresAt"];
+export declare const MACHINE_DETAIL_KEYS: readonly ["id", "name", "url", "status", "ip", "size", "vcpu", "ram", "disk", "region", "provider", "createdAt", "firstStartedAt", "image", "imageVersion", "defaultSSHUsername", "sshClientInitialCommand", "metricsEnabled", "onIdle", "idleTimeoutMinutes", "distribution", "key", "ageMinutes", "totalCost", "pricePerHour", "mountPaths", "statusExplanation", "orderExpiresAt", "env"];
 export declare const IMAGE_KEYS: readonly ["id", "name", "description", "distribution", "type", "status", "provider", "sizeGb", "minDiskGb", "regions", "gpuOnly", "gitRepo", "gitBranch", "flakeDir", "nixProfile", "createdAt", "updatedAt", "ageMinutes", "totalCost", "pricePerHour"];
 export declare const IMAGE_LIST_KEYS: readonly ["id", "name", "description", "distribution", "type", "status", "provider", "sizeGb", "minDiskGb", "regions", "gpuOnly", "gitRepo", "gitBranch", "flakeDir", "nixProfile", "createdAt", "updatedAt", "ageMinutes", "totalCost", "pricePerHour", "latestVersionError"];
 export declare const IMAGE_DETAIL_KEYS: readonly ["id", "name", "description", "distribution", "type", "status", "provider", "sizeGb", "minDiskGb", "regions", "gpuOnly", "gitRepo", "gitBranch", "flakeDir", "nixProfile", "createdAt", "updatedAt", "ageMinutes", "totalCost", "pricePerHour", "versionSnapshotStorageCost"];

package/dist/types.js

@@ -89,6 +89,7 @@ export const MACHINE_DETAIL_KEYS = [
     "mountPaths",
     "statusExplanation",
     "orderExpiresAt",
+    "env",
 ];
 // The shared Image keys — valid against BOTH images.list rows and images.get
 // (kept stable for existing consumers indexing either shape).

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.2.0";
+export declare const SDK_VERSION = "0.2.1";

package/dist/version.js

@@ -1,4 +1,4 @@
 // Must match the "version" field in package.json — version.test.ts enforces
 // the sync, and the deploy-sdk workflow compares this constant (imported from
 // the built dist under plain Node) against package.json before publishing.
-export const SDK_VERSION = "0.2.0";
+export const SDK_VERSION = "0.2.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@machine0/sdk",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Typed Node.js/TypeScript SDK for the machine0 API. Zero dependencies, fetch-based.",
   "homepage": "https://machine0.io",
   "author": "Barnaby Malet <barnaby@machine0.io>",