gigadrive 2.14.0 → 2.16.0

package/dist/index.cjs

@@ -32,7 +32,7 @@ var import_effect31 = require("effect");
 // package.json
 var package_default = {
   name: "gigadrive",
-  version: "2.14.0",
+  version: "2.16.0",
   repository: {
     type: "git",
     url: "https://github.com/Gigadrive/sdk.git",
@@ -3073,6 +3073,7 @@ var describeMicroVm = (vm, now = Date.now()) => {
     `Size:        ${vm.vcpus} vCPU, ${formatMemory(vm.memoryMb)} memory, ${formatMemory(vm.diskMb)} disk`,
     `Region:      ${vm.region}`,
     `Network:     ${vm.network.egress === "deny" ? "outbound traffic blocked" : vm.network.allow && vm.network.allow.length > 0 ? `only ${vm.network.allow.join(", ")}` : "internet access"}`,
+    ...(vm.network.inject ?? []).map((rule) => `Injects:     ${rule.headers.join(", ")} for ${rule.domain}`),
     `Previews:    ${vm.network.previews === "private" ? "private (preview token required)" : "public"}`,
     `Application: ${vm.applicationId}`,
     `Created:     ${vm.createdAt}`
@@ -3108,6 +3109,17 @@ var formatWebhookTable = (webhooks) => formatTable([
     webhook.id
   ])
 ]);
+var formatVolumeTable = (volumes) => formatTable([
+  ["NAME", "SIZE", "STORED", "STATUS", "LAST SAVED", "ID"],
+  ...volumes.map((volume) => [
+    volume.name,
+    `${String(volume.sizeMb)} MiB`,
+    volume.storedBytes === null ? "-" : formatBytes(volume.storedBytes),
+    volume.attachedMicrovmId ? `${volume.status} (${volume.attachedMicrovmId})` : volume.status,
+    volume.lastSaveError ? `failed: ${volume.lastSaveError}` : volume.lastSavedAt ?? "never",
+    volume.id
+  ])
+]);
 var formatDeliveryTable = (deliveries) => formatTable([
   ["CREATED", "EVENT", "STATUS", "ATTEMPTS", "RESPONSE", "MICROVM"],
   ...deliveries.map((delivery) => [
@@ -3353,6 +3365,45 @@ var withClient = (run) => import_effect24.Effect.gen(function* () {
   return yield* import_effect24.Effect.tryPromise({ try: () => run(client), catch: toApiRequestError });
 });
 var signalOnInterrupt = (signal) => (command, exit) => import_effect24.Exit.isInterrupted(exit) ? import_effect24.Effect.tryPromise(() => command.kill(signal)).pipe(import_effect24.Effect.timeout("2 seconds"), import_effect24.Effect.ignore) : import_effect24.Effect.void;
+var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var parseVolumeFlags = (values) => import_effect24.Effect.gen(function* () {
+  if (values.length > 4) {
+    return yield* new InvalidMicroVmOptionsError({ message: "--volume takes at most 4 volumes." });
+  }
+  const volumes = [];
+  for (const value of values) {
+    const separator = value.indexOf(":");
+    const volumeId = separator > 0 ? value.slice(0, separator) : "";
+    const mountPath = separator > 0 ? value.slice(separator + 1) : "";
+    if (volumeId === "" || !mountPath.startsWith("/")) {
+      return yield* new InvalidMicroVmOptionsError({
+        message: `--volume must be VOLUME:PATH with an absolute path, such as cache:/cache (got ${value}).`
+      });
+    }
+    volumes.push({ volumeId, mountPath });
+  }
+  return volumes;
+});
+var parseInjectFlags = (values) => import_effect24.Effect.gen(function* () {
+  const rules = /* @__PURE__ */ new Map();
+  for (const value of values) {
+    const colon = value.indexOf(":");
+    const equals = value.indexOf("=", colon + 1);
+    const domain = colon > 0 ? value.slice(0, colon).trim().toLowerCase() : "";
+    const name = colon > 0 && equals > colon ? value.slice(colon + 1, equals).trim() : "";
+    if (domain === "" || name === "" || equals === value.length - 1) {
+      return yield* new InvalidMicroVmOptionsError({
+        // The entry is not echoed: it may hold the credential.
+        message: '--inject must be DOMAIN:HEADER=VALUE, such as "api.openai.com:Authorization=Bearer $OPENAI_API_KEY".'
+      });
+    }
+    rules.set(domain, { ...rules.get(domain), [name]: value.slice(equals + 1) });
+  }
+  if (rules.size > 8) {
+    return yield* new InvalidMicroVmOptionsError({ message: "--inject takes at most 8 domains." });
+  }
+  return [...rules].map(([domain, headers]) => ({ domain, headers }));
+});
 var checkEgressFlags = (denyEgress, allowEgress) => import_effect24.Effect.gen(function* () {
   if (denyEgress && allowEgress.length > 0) {
     return yield* new InvalidMicroVmOptionsError({
@@ -3383,6 +3434,14 @@ var createInput = (flags) => import_effect24.Effect.gen(function* () {
   if (badPort !== void 0) {
     return yield* new InvalidMicroVmOptionsError({ message: `--port must be between 1 and 65535 (got ${badPort}).` });
   }
+  const inject = yield* parseInjectFlags(flags.inject);
+  if (inject.length > 0 && flags.denyEgress) {
+    return yield* new InvalidMicroVmOptionsError({ message: "--inject cannot be combined with --deny-egress." });
+  }
+  const volumes = yield* parseVolumeFlags(flags.volumes);
+  if (volumes.length > 0 && flags.pauseOnTimeout) {
+    return yield* new InvalidMicroVmOptionsError({ message: "--volume cannot be combined with --pause-on-timeout." });
+  }
   const applicationId = yield* resolveApplicationId(flags.app);
   const input = {
     ...applicationId ? { applicationId } : {},
@@ -3399,11 +3458,13 @@ var createInput = (flags) => import_effect24.Effect.gen(function* () {
     ...flags.ports.length > 0 ? { ports: [...flags.ports] } : {},
     ...env ? { env } : {},
     ...metadata ? { metadata } : {},
-    ...flags.denyEgress || flags.privatePreviews || flags.allowEgress.length > 0 ? {
+    ...volumes.length > 0 ? { volumes } : {},
+    ...flags.denyEgress || flags.privatePreviews || flags.allowEgress.length > 0 || inject.length > 0 ? {
       network: {
         egress: flags.denyEgress ? "deny" : "allow",
         ...flags.privatePreviews ? { previews: "private" } : {},
-        ...flags.allowEgress.length > 0 ? { allow: flags.allowEgress.map((entry) => entry.trim()) } : {}
+        ...flags.allowEgress.length > 0 ? { allow: flags.allowEgress.map((entry) => entry.trim()) } : {},
+        ...inject.length > 0 ? { inject } : {}
       }
     } : {},
     ...import_effect24.Option.match(flags.region, { onNone: () => ({}), onSome: (region) => ({ region }) })
@@ -3412,7 +3473,26 @@ var createInput = (flags) => import_effect24.Effect.gen(function* () {
 });
 var createMicroVm = (flags) => import_effect24.Effect.gen(function* () {
   const apiClient = yield* ApiClientService;
-  const input = yield* createInput(flags);
+  const parsed = yield* createInput(flags);
+  const named = (parsed.volumes ?? []).filter((volume) => !UUID.test(volume.volumeId));
+  const known = named.length > 0 ? yield* apiClient.request(
+    (client) => client.microvms.volumes.list({ ...parsed.applicationId ? { applicationId: parsed.applicationId } : {} })
+  ) : [];
+  const volumes = [];
+  for (const volume of parsed.volumes ?? []) {
+    if (UUID.test(volume.volumeId)) {
+      volumes.push(volume);
+      continue;
+    }
+    const match = known.find((entry) => entry.name === volume.volumeId);
+    if (match === void 0) {
+      return yield* new InvalidMicroVmOptionsError({
+        message: `No volume is named ${volume.volumeId}. Create it with "gigadrive microvms volumes create ${volume.volumeId}".`
+      });
+    }
+    volumes.push({ volumeId: match.id, mountPath: volume.mountPath });
+  }
+  const input = volumes.length > 0 ? { ...parsed, volumes } : parsed;
   if (!flags.json) yield* import_effect24.Console.error(`Creating a microVM from ${input.image ?? "node22"}...`);
   const vm = yield* apiClient.request((client) => client.microvms.create(input));
   if (flags.json) {
@@ -3475,6 +3555,12 @@ var createCommand = import_cli12.Command.make(
       ),
       import_cli12.Options.repeated
     ),
+    inject: import_cli12.Options.text("inject").pipe(
+      import_cli12.Options.withDescription(
+        "Add a header to HTTPS requests to a domain, as DOMAIN:HEADER=VALUE (repeatable, up to 8 domains); the value never enters the microVM"
+      ),
+      import_cli12.Options.repeated
+    ),
     pauseOnTimeout: import_cli12.Options.boolean("pause-on-timeout").pipe(
       import_cli12.Options.withDescription("Pause the microVM when its timeout ends instead of stopping it")
     ),
@@ -3483,6 +3569,13 @@ var createCommand = import_cli12.Command.make(
         "Resume the paused microVM when a command, file call or public preview request reaches it"
       )
     ),
+    volumes: import_cli12.Options.text("volume").pipe(
+      import_cli12.Options.withAlias("v"),
+      import_cli12.Options.withDescription(
+        "Attach a volume as VOLUME:PATH, by ID or name, such as cache:/cache (repeatable, up to 4; saved when the microVM stops)"
+      ),
+      import_cli12.Options.repeated
+    ),
     region: import_cli12.Options.text("region").pipe(import_cli12.Options.withDescription("Region to place the microVM in"), import_cli12.Options.optional),
     json: jsonOption2
   },
@@ -3837,15 +3930,31 @@ var updateMicroVmNetwork = (microvmId, flags) => import_effect24.Effect.gen(func
     });
   }
   yield* checkEgressFlags(flags.denyEgress, flags.allowEgress);
+  const inject = yield* parseInjectFlags(flags.inject);
+  if (inject.length > 0 && flags.denyEgress) {
+    return yield* new InvalidMicroVmOptionsError({ message: "--inject cannot be combined with --deny-egress." });
+  }
+  if (flags.clearInject && (inject.length > 0 || flags.denyEgress)) {
+    return yield* new InvalidMicroVmOptionsError({
+      message: "--clear-inject cannot be combined with --inject or --deny-egress."
+    });
+  }
   const apiClient = yield* ApiClientService;
   const vm = yield* apiClient.request(
     (client) => client.microvms.updateNetwork(
       microvmId,
-      flags.denyEgress ? { egress: "deny" } : flags.allowEgress.length > 0 ? { egress: "allow", allow: flags.allowEgress.map((entry) => entry.trim()) } : { egress: "allow" }
+      flags.denyEgress ? { egress: "deny" } : {
+        egress: "allow",
+        ...flags.allowEgress.length > 0 ? { allow: flags.allowEgress.map((entry) => entry.trim()) } : {},
+        ...inject.length > 0 || flags.clearInject ? { inject } : {}
+      }
     )
   );
   const reach = vm.network.egress === "deny" ? "no outbound traffic" : vm.network.allow ? vm.network.allow.join(", ") : "the whole internet";
   yield* import_effect24.Console.log(`${vm.id} now reaches ${reach}.`);
+  for (const rule of vm.network.inject ?? []) {
+    yield* import_effect24.Console.log(`Adds ${rule.headers.join(", ")} to HTTPS requests to ${rule.domain}.`);
+  }
   return vm;
 });
 var networkCommand = import_cli12.Command.make(
@@ -3861,6 +3970,15 @@ var networkCommand = import_cli12.Command.make(
     ),
     allowAllEgress: import_cli12.Options.boolean("allow-all-egress").pipe(
       import_cli12.Options.withDescription("Reach the whole internet again (private networks stay blocked)")
+    ),
+    inject: import_cli12.Options.text("inject").pipe(
+      import_cli12.Options.withDescription(
+        "Add a header to HTTPS requests to a domain, as DOMAIN:HEADER=VALUE (repeatable, up to 8 domains); the value never enters the microVM"
+      ),
+      import_cli12.Options.repeated
+    ),
+    clearInject: import_cli12.Options.boolean("clear-inject").pipe(
+      import_cli12.Options.withDescription("Remove every header rule added with --inject")
     )
   },
   ({ microvmId, ...flags }) => updateMicroVmNetwork(microvmId, flags).pipe(import_effect24.Effect.asVoid, reportErrors2("update the microVM network"))
@@ -3965,6 +4083,90 @@ var imagesCommand = import_cli12.Command.make("images", {}, () => import_effect2
   import_cli12.Command.withDescription("Built-in and custom microVM images"),
   import_cli12.Command.withSubcommands([imagesListCommand, imagesCreateCommand, imagesRemoveCommand])
 );
+var volumeIdArg = import_cli12.Args.text({ name: "volume-id" }).pipe(import_cli12.Args.withDescription("The volume ID"));
+var volumesListCommand = import_cli12.Command.make(
+  "ls",
+  { app: appOption6, json: jsonOption2 },
+  ({ app, json }) => import_effect24.Effect.gen(function* () {
+    const apiClient = yield* ApiClientService;
+    const applicationId = yield* resolveApplicationId(app);
+    const volumes = yield* apiClient.request((client) => client.microvms.volumes.list({ applicationId }));
+    if (json) return yield* import_effect24.Console.log(JSON.stringify(volumes, null, 2));
+    if (volumes.length === 0)
+      return yield* import_effect24.Console.log('No volumes yet. Create one with "gigadrive microvms volumes create <name>".');
+    for (const line of formatVolumeTable(volumes)) yield* import_effect24.Console.log(line);
+  }).pipe(reportErrors2("list volumes"))
+).pipe(import_cli12.Command.withDescription("List the application's volumes"));
+var createVolume = (flags) => import_effect24.Effect.gen(function* () {
+  const apiClient = yield* ApiClientService;
+  const applicationId = yield* resolveApplicationId(flags.app);
+  const volume = yield* apiClient.request(
+    (client) => client.microvms.volumes.create({
+      name: flags.name,
+      ...import_effect24.Option.match(flags.size, { onNone: () => ({}), onSome: (sizeMb) => ({ sizeMb }) }),
+      ...applicationId ? { applicationId } : {}
+    })
+  );
+  if (flags.json) {
+    yield* import_effect24.Console.log(JSON.stringify(volume, null, 2));
+  } else {
+    yield* import_effect24.Console.log(`Created volume ${volume.name} (${String(volume.sizeMb)} MiB, ${volume.id}).`);
+    yield* import_effect24.Console.log(`Attach it: gigadrive microvms create --volume ${volume.name}:/data`);
+  }
+  return volume;
+});
+var volumesCreateCommand = import_cli12.Command.make(
+  "create",
+  {
+    name: import_cli12.Args.text({ name: "name" }).pipe(
+      import_cli12.Args.withDescription("Lowercase letters, digits and -, unique per application")
+    ),
+    size: import_cli12.Options.integer("size").pipe(
+      import_cli12.Options.withDescription("Size in MiB, 1024 to 51200 (default: 10240)"),
+      import_cli12.Options.optional
+    ),
+    app: appOption6,
+    json: jsonOption2
+  },
+  (flags) => createVolume(flags).pipe(import_effect24.Effect.asVoid, reportErrors2("create the volume"))
+).pipe(import_cli12.Command.withDescription("Create an empty volume"));
+var volumesRenameCommand = import_cli12.Command.make(
+  "rename",
+  { volumeId: volumeIdArg, name: import_cli12.Args.text({ name: "name" }).pipe(import_cli12.Args.withDescription("The new name")) },
+  ({ volumeId, name }) => import_effect24.Effect.gen(function* () {
+    const apiClient = yield* ApiClientService;
+    const volume = yield* apiClient.request((client) => client.microvms.volumes.rename(volumeId, name));
+    yield* import_effect24.Console.log(`Renamed the volume to ${volume.name}.`);
+  }).pipe(reportErrors2("rename the volume"))
+).pipe(import_cli12.Command.withDescription("Rename a volume"));
+var volumesSaveCommand = import_cli12.Command.make(
+  "save",
+  { microvmId: import_cli12.Args.text({ name: "microvm-id" }).pipe(import_cli12.Args.withDescription("A running microVM with volumes")) },
+  ({ microvmId }) => import_effect24.Effect.gen(function* () {
+    const apiClient = yield* ApiClientService;
+    yield* apiClient.request((client) => client.microvms.saveVolumes(microvmId));
+    yield* import_effect24.Console.log(`Saved the volumes of ${microvmId}.`);
+  }).pipe(reportErrors2("save the volumes"))
+).pipe(import_cli12.Command.withDescription("Save a running microVM's volumes without stopping it"));
+var volumesRemoveCommand = import_cli12.Command.make(
+  "rm",
+  { volumeId: volumeIdArg },
+  ({ volumeId }) => import_effect24.Effect.gen(function* () {
+    const apiClient = yield* ApiClientService;
+    yield* apiClient.request((client) => client.microvms.volumes.delete(volumeId));
+    yield* import_effect24.Console.log(`Deleted volume ${volumeId}.`);
+  }).pipe(reportErrors2("delete the volume"))
+).pipe(import_cli12.Command.withDescription("Delete a volume and its contents (it must not be attached)"));
+var volumesCommand = import_cli12.Command.make("volumes", {}, () => import_effect24.Effect.void).pipe(
+  import_cli12.Command.withDescription("Persistent filesystems that outlive the microVMs they are attached to"),
+  import_cli12.Command.withSubcommands([
+    volumesListCommand,
+    volumesCreateCommand,
+    volumesRenameCommand,
+    volumesSaveCommand,
+    volumesRemoveCommand
+  ])
+);
 var WEBHOOK_EVENTS = [
   "microvm.created",
   "microvm.running",
@@ -4093,6 +4295,7 @@ var SUBCOMMANDS = [
   extendCommand,
   networkCommand,
   imagesCommand,
+  volumesCommand,
   webhooksCommand
 ];
 var microvmsCommand = import_cli12.Command.make("microvms", {}, () => import_effect24.Effect.void).pipe(