gigadrive 2.12.0 → 2.14.0

package/dist/index.mjs

@@ -9,7 +9,7 @@ import { Effect as Effect29, Layer, LogLevel, Logger } from "effect";
 // package.json
 var package_default = {
   name: "gigadrive",
-  version: "2.12.0",
+  version: "2.14.0",
   repository: {
     type: "git",
     url: "https://github.com/Gigadrive/sdk.git",
@@ -3089,6 +3089,26 @@ var formatImageTable = (images) => formatTable([
   ["NAME", "STATUS", "SOURCE", "ID"],
   ...images.map((image) => [image.name, image.status, imageSource(image), image.id])
 ]);
+var formatWebhookTable = (webhooks) => formatTable([
+  ["URL", "EVENTS", "STATUS", "ID"],
+  ...webhooks.map((webhook) => [
+    webhook.url,
+    webhook.events.join(","),
+    webhook.enabled ? "enabled" : "disabled",
+    webhook.id
+  ])
+]);
+var formatDeliveryTable = (deliveries) => formatTable([
+  ["CREATED", "EVENT", "STATUS", "ATTEMPTS", "RESPONSE", "MICROVM"],
+  ...deliveries.map((delivery) => [
+    delivery.createdAt,
+    delivery.eventType,
+    delivery.status,
+    String(delivery.attempts),
+    delivery.lastStatusCode === null ? delivery.lastError ?? "-" : String(delivery.lastStatusCode),
+    delivery.microvmId
+  ])
+]);
 var formatBytes = (bytes) => {
   if (bytes < 1024) return `${bytes} B`;
   const units = ["KiB", "MiB", "GiB", "TiB"];
@@ -3508,6 +3528,36 @@ var getCommand = Command12.make(
     for (const line of describeMicroVm(vm)) yield* Console12.log(line);
   }).pipe(reportErrors2("get the microVM"))
 ).pipe(Command12.withDescription("Show a microVM"));
+var formatGigabytes = (bytes) => `${(bytes / 1e9).toFixed(1)} GB`;
+var describeMicroVmMetrics = (metrics) => {
+  const latest = metrics.cpu.at(-1);
+  const peak = metrics.cpu.reduce((max, point) => Math.max(max, point.cpuPercent), 0);
+  return [
+    `CPU (last ${metrics.windowMinutes} min, ${metrics.vcpus} vCPU): ${latest ? `${latest.cpuPercent}% at ${latest.time}, peak ${peak}%` : "no samples"}`,
+    metrics.current ? `Memory: ${formatGigabytes(metrics.current.memoryUsedBytes)} of ${formatGigabytes(metrics.current.memoryTotalBytes)}` : "Memory: unavailable (not running, or no answer)",
+    metrics.current ? `Disk:   ${formatGigabytes(metrics.current.diskUsedBytes)} of ${formatGigabytes(metrics.current.diskTotalBytes)}` : "Disk:   unavailable (not running, or no answer)"
+  ];
+};
+var metricsCommand = Command12.make(
+  "metrics",
+  {
+    microvmId: microvmIdArg,
+    window: Options7.integer("window").pipe(
+      Options7.withDescription("Minutes of CPU history, 1 to 1440 (default: 15)"),
+      Options7.optional
+    ),
+    json: jsonOption2
+  },
+  ({ microvmId, window, json }) => Effect22.gen(function* () {
+    const apiClient = yield* ApiClientService;
+    const windowMinutes = Option14.getOrUndefined(window);
+    const metrics = yield* apiClient.request(
+      (client) => client.microvms.getMetrics(microvmId, windowMinutes === void 0 ? {} : { windowMinutes })
+    );
+    if (json) return yield* Console12.log(JSON.stringify(metrics, null, 2));
+    for (const line of describeMicroVmMetrics(metrics)) yield* Console12.log(line);
+  }).pipe(reportErrors2("read the microVM metrics"))
+).pipe(Command12.withDescription("Show a microVM's CPU, memory and disk use"));
 var execInMicroVm = (flags, io = nodeSessionIo()) => Effect22.gen(function* () {
   const env = yield* keyValues("--env", flags.env);
   const timeout = yield* optionalDuration("--timeout", flags.timeout);
@@ -3905,10 +3955,126 @@ var imagesCommand = Command12.make("images", {}, () => Effect22.void).pipe(
   Command12.withDescription("Built-in and custom microVM images"),
   Command12.withSubcommands([imagesListCommand, imagesCreateCommand, imagesRemoveCommand])
 );
+var WEBHOOK_EVENTS = [
+  "microvm.created",
+  "microvm.running",
+  "microvm.paused",
+  "microvm.stopped",
+  "microvm.failed"
+];
+var webhookIdArg = Args5.text({ name: "webhook-id" }).pipe(Args5.withDescription("The webhook ID"));
+var webhooksListCommand = Command12.make(
+  "ls",
+  { app: appOption6, json: jsonOption2 },
+  ({ app, json }) => Effect22.gen(function* () {
+    const apiClient = yield* ApiClientService;
+    const applicationId = yield* resolveApplicationId(app);
+    const webhooks = yield* apiClient.request((client) => client.microvms.webhooks.list({ applicationId }));
+    if (json) return yield* Console12.log(JSON.stringify(webhooks, null, 2));
+    if (webhooks.length === 0)
+      return yield* Console12.log('No webhooks yet. Add one with "gigadrive microvms webhooks add".');
+    for (const line of formatWebhookTable(webhooks)) yield* Console12.log(line);
+  }).pipe(reportErrors2("list webhooks"))
+).pipe(Command12.withDescription("List the application's microVM webhooks"));
+var addWebhook = (flags) => Effect22.gen(function* () {
+  const apiClient = yield* ApiClientService;
+  const unknown = flags.events.find((event) => !WEBHOOK_EVENTS.includes(event));
+  if (unknown !== void 0) {
+    return yield* new InvalidMicroVmOptionsError({
+      message: `${unknown} is not a microVM event. Use ${WEBHOOK_EVENTS.join(", ")}.`
+    });
+  }
+  const events = flags.events.length > 0 ? [...new Set(flags.events)] : WEBHOOK_EVENTS;
+  const applicationId = yield* resolveApplicationId(flags.app);
+  const webhook = yield* apiClient.request(
+    (client) => client.microvms.webhooks.create({
+      url: flags.url,
+      events,
+      ...Option14.isSome(flags.description) ? { description: flags.description.value } : {},
+      ...applicationId ? { applicationId } : {}
+    })
+  );
+  if (flags.json) {
+    yield* Console12.log(JSON.stringify(webhook, null, 2));
+  } else {
+    yield* Console12.log(`Added webhook ${webhook.id} for ${webhook.events.join(", ")}.`);
+    yield* Console12.log(`Signing secret (shown only now): ${webhook.secret}`);
+  }
+  return webhook;
+});
+var webhooksAddCommand = Command12.make(
+  "add",
+  {
+    url: Args5.text({ name: "url" }).pipe(Args5.withDescription("HTTPS URL on a public host")),
+    events: Options7.text("event").pipe(
+      Options7.withDescription(`Event to send (repeatable; default: all of ${WEBHOOK_EVENTS.join(", ")})`),
+      Options7.repeated
+    ),
+    description: Options7.text("description").pipe(Options7.withDescription("A note for yourself"), Options7.optional),
+    app: appOption6,
+    json: jsonOption2
+  },
+  (flags) => addWebhook(flags).pipe(Effect22.asVoid, reportErrors2("add the webhook"))
+).pipe(Command12.withDescription("Add an endpoint for microVM lifecycle events and print its signing secret"));
+var webhooksEnableCommand = (enabled) => Command12.make(
+  enabled ? "enable" : "disable",
+  { webhookId: webhookIdArg },
+  ({ webhookId }) => Effect22.gen(function* () {
+    const apiClient = yield* ApiClientService;
+    const webhook = yield* apiClient.request((client) => client.microvms.webhooks.update(webhookId, { enabled }));
+    yield* Console12.log(`${webhook.url} is ${webhook.enabled ? "enabled" : "disabled"}.`);
+  }).pipe(reportErrors2(enabled ? "enable the webhook" : "disable the webhook"))
+).pipe(
+  Command12.withDescription(
+    enabled ? "Send events to a webhook again" : "Stop sending events to a webhook; waiting retries are held"
+  )
+);
+var webhooksSecretCommand = Command12.make(
+  "rotate-secret",
+  { webhookId: webhookIdArg },
+  ({ webhookId }) => Effect22.gen(function* () {
+    const apiClient = yield* ApiClientService;
+    const webhook = yield* apiClient.request((client) => client.microvms.webhooks.rotateSecret(webhookId));
+    yield* Console12.log(`New signing secret (shown only now): ${webhook.secret}`);
+  }).pipe(reportErrors2("replace the signing secret"))
+).pipe(Command12.withDescription("Replace the signing secret; the old one stops signing at once"));
+var webhooksDeliveriesCommand = Command12.make(
+  "deliveries",
+  { webhookId: webhookIdArg, json: jsonOption2 },
+  ({ webhookId, json }) => Effect22.gen(function* () {
+    const apiClient = yield* ApiClientService;
+    const deliveries = yield* apiClient.request((client) => client.microvms.webhooks.listDeliveries(webhookId));
+    if (json) return yield* Console12.log(JSON.stringify(deliveries, null, 2));
+    if (deliveries.length === 0) return yield* Console12.log("Nothing has been sent yet.");
+    for (const line of formatDeliveryTable(deliveries)) yield* Console12.log(line);
+  }).pipe(reportErrors2("list the deliveries"))
+).pipe(Command12.withDescription("Show a webhook's 50 most recent deliveries"));
+var webhooksRemoveCommand = Command12.make(
+  "rm",
+  { webhookId: webhookIdArg },
+  ({ webhookId }) => Effect22.gen(function* () {
+    const apiClient = yield* ApiClientService;
+    yield* apiClient.request((client) => client.microvms.webhooks.delete(webhookId));
+    yield* Console12.log(`Deleted webhook ${webhookId}.`);
+  }).pipe(reportErrors2("delete the webhook"))
+).pipe(Command12.withDescription("Delete a webhook"));
+var webhooksCommand = Command12.make("webhooks", {}, () => Effect22.void).pipe(
+  Command12.withDescription("Signed HTTPS requests when a microVM is created, starts, pauses, stops or fails"),
+  Command12.withSubcommands([
+    webhooksListCommand,
+    webhooksAddCommand,
+    webhooksEnableCommand(true),
+    webhooksEnableCommand(false),
+    webhooksSecretCommand,
+    webhooksDeliveriesCommand,
+    webhooksRemoveCommand
+  ])
+);
 var SUBCOMMANDS = [
   createCommand,
   listCommand2,
   getCommand,
+  metricsCommand,
   execCommand,
   shellCommand,
   copyCommand,
@@ -3916,7 +4082,8 @@ var SUBCOMMANDS = [
   removeCommand2,
   extendCommand,
   networkCommand,
-  imagesCommand
+  imagesCommand,
+  webhooksCommand
 ];
 var microvmsCommand = Command12.make("microvms", {}, () => Effect22.void).pipe(
   Command12.withDescription("Isolated Linux machines for running code: create, exec, shell, cp, stop"),