gigadrive 2.14.0 → 2.15.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.15.0",
   repository: {
     type: "git",
     url: "https://github.com/Gigadrive/sdk.git",
@@ -3108,6 +3108,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 +3364,25 @@ 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 checkEgressFlags = (denyEgress, allowEgress) => import_effect24.Effect.gen(function* () {
   if (denyEgress && allowEgress.length > 0) {
     return yield* new InvalidMicroVmOptionsError({
@@ -3383,6 +3413,10 @@ 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 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,6 +3433,7 @@ var createInput = (flags) => import_effect24.Effect.gen(function* () {
     ...flags.ports.length > 0 ? { ports: [...flags.ports] } : {},
     ...env ? { env } : {},
     ...metadata ? { metadata } : {},
+    ...volumes.length > 0 ? { volumes } : {},
     ...flags.denyEgress || flags.privatePreviews || flags.allowEgress.length > 0 ? {
       network: {
         egress: flags.denyEgress ? "deny" : "allow",
@@ -3412,7 +3447,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) {
@@ -3483,6 +3537,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
   },
@@ -3965,6 +4026,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 +4238,7 @@ var SUBCOMMANDS = [
   extendCommand,
   networkCommand,
   imagesCommand,
+  volumesCommand,
   webhooksCommand
 ];
 var microvmsCommand = import_cli12.Command.make("microvms", {}, () => import_effect24.Effect.void).pipe(