@lostgradient/weft 0.15.0 → 0.16.0

package/README.md

@@ -1,6 +1,6 @@
 # Weft
 
-A Bun-native durable execution engine. Current release: `0.15.0`.
+A Bun-native durable execution engine. Current release: `0.16.0`.
 
 Install the library from npm as `@lostgradient/weft`:
 

package/dist/alerting/alert-manager.d.ts

@@ -40,5 +40,7 @@ export declare class AlertManager implements Disposable {
     tick(): void;
     /** Get current state of all alert rules (for debugging/testing). */
     get states(): readonly AlertState[];
+    /** Get the alert rules that are currently firing. */
+    get activeStates(): readonly AlertState[];
     [Symbol.dispose](): void;
 }

package/dist/alerting/alert-manager.js

@@ -155,6 +155,9 @@ export class AlertManager {
   get states() {
     return this.#states;
   }
+  get activeStates() {
+    return this.#states.filter((state) => state.status === "firing");
+  }
   [Symbol.dispose]() {
     if (this.#tickInterval !== null) {
       clearInterval(this.#tickInterval);

package/dist/cli/api.js

@@ -1,6 +1,7 @@
 import { createLiveOperationRegistry } from "../server/rest-bindings.js";
 import { findNearestCandidate } from "./command-suggestions.js";
 import snapshotData from "./generated/operation-catalog.snapshot.json";
+import { loadJsonInput } from "./json-input.js";
 import { sendJsonRpcRequest } from "./json-rpc-client.js";
 const snapshot = snapshotData, operationByName = new Map(snapshot.operations.map((operation) => [operation.name, operation]));
 export async function executeApi(command) {
@@ -107,25 +108,10 @@ function formatOperationDescription(operation) {
 `);
 }
 async function readInput(command) {
-  if (command.input !== void 0)
-    return parseInput(command.input);
-  if (command.inputFile !== void 0) {
-    if (command.inputFile === "-")
-      return parseInput(await Bun.stdin.text());
-    const file = Bun.file(command.inputFile);
-    if (!await file.exists())
-      return { ok: !1, output: usageError(`api: input file not found: ${command.inputFile}`) };
-    return parseInput(await file.text());
-  }
-  return { ok: !0, value: {} };
-}
-function parseInput(source) {
-  try {
-    return { ok: !0, value: JSON.parse(source) };
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    return { ok: !1, output: usageError(`api: invalid JSON input: ${message}`) };
-  }
+  const result = await loadJsonInput(command.input, command.inputFile);
+  if (!result.ok)
+    return { ok: !1, output: usageError(`api: ${result.error.message}`) };
+  return { ok: !0, value: result.value === void 0 ? {} : result.value };
 }
 function validateInput(operationName, input) {
   const operation = createLiveOperationRegistry().get(operationName);

package/dist/cli/console.d.ts

@@ -0,0 +1,12 @@
+import type { DashboardAssets, DashboardRouteTarget } from '../server/index.ts';
+export interface ConsoleMount {
+    dashboard: DashboardRouteTarget;
+    dashboardAssets: DashboardAssets;
+}
+export interface ConsoleModuleLoaderOptions {
+    cwd?: string;
+    resolveModule?: (specifier: string, cwd: string) => string;
+    importModule?: (url: string) => Promise<unknown>;
+}
+/** Resolve and load the optional console from the CLI user's environment. */
+export declare function loadConsoleMount(options?: ConsoleModuleLoaderOptions): Promise<ConsoleMount>;

package/dist/cli/console.js

@@ -0,0 +1,62 @@
+import { statSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+const CONSOLE_PACKAGE_NAME = "@lostgradient/weft-console";
+function defaultImportModule(url) {
+  return import(url);
+}
+function isDashboardRouteTarget(value) {
+  return typeof value === "function" || typeof value === "string" || value instanceof Response;
+}
+function isConsoleModule(value) {
+  return typeof value === "object" && value !== null;
+}
+function consoleError(message) {
+  return Error(`--console ${message}`);
+}
+function resolveConsoleEntry(cwd, resolveModule) {
+  try {
+    return resolveModule(CONSOLE_PACKAGE_NAME, cwd);
+  } catch {
+    throw consoleError(`requires ${CONSOLE_PACKAGE_NAME}. Install it in the CLI project: bun add ${CONSOLE_PACKAGE_NAME}`);
+  }
+}
+async function importConsoleModule(resolvedEntry, importModule) {
+  try {
+    const loaded = await importModule(pathToFileURL(resolvedEntry).href);
+    if (!isConsoleModule(loaded))
+      throw Error("module is not an object");
+    return loaded;
+  } catch {
+    throw consoleError(`could not load ${CONSOLE_PACKAGE_NAME}; reinstall or update it, then retry, or remove --console`);
+  }
+}
+function loadDashboard(module) {
+  if (typeof module.weftConsole !== "function")
+    throw consoleError(`${CONSOLE_PACKAGE_NAME} must export a weftConsole() function; update the package or remove --console`);
+  try {
+    const dashboard = module.weftConsole();
+    if (!isDashboardRouteTarget(dashboard))
+      throw Error("invalid dashboard route target");
+    return dashboard;
+  } catch {
+    throw consoleError(`${CONSOLE_PACKAGE_NAME} weftConsole() failed; reinstall or update it, then retry, or remove --console`);
+  }
+}
+function resolveConsoleAssets(resolvedEntry) {
+  const directory = join(dirname(fileURLToPath(pathToFileURL(resolvedEntry))), "assets");
+  try {
+    if (!statSync(directory).isDirectory())
+      throw Error("not a directory");
+  } catch {
+    throw consoleError(`${CONSOLE_PACKAGE_NAME} is missing its built assets; reinstall or update it, then retry, or remove --console`);
+  }
+  return { prefix: "/assets", directory };
+}
+export async function loadConsoleMount(options = {}) {
+  const cwd = options.cwd ?? process.cwd(), resolveModule = options.resolveModule ?? Bun.resolveSync, importModule = options.importModule ?? defaultImportModule, resolvedEntry = resolveConsoleEntry(cwd, resolveModule), module = await importConsoleModule(resolvedEntry, importModule);
+  return {
+    dashboard: loadDashboard(module),
+    dashboardAssets: resolveConsoleAssets(resolvedEntry)
+  };
+}

package/dist/cli/generated/operation-catalog.snapshot.json

@@ -98,6 +98,77 @@
         "type": "object"
       }
     },
+    {
+      "name": "weft.alerts.list",
+      "kind": "unary",
+      "summary": "List currently firing alerts",
+      "description": "List the alert rules that are currently firing, including their metric, threshold, current value, configured window, and firing timestamp. Read-only and limited to active in-memory alert state; resolved alerts are not returned.",
+      "tags": ["Observability"],
+      "destructive": false,
+      "access": {
+        "kind": "scoped",
+        "scopes": ["system:read"]
+      },
+      "transports": {
+        "http": true,
+        "jsonRpcHttp": true,
+        "jsonRpcWebSocket": true,
+        "jsonRpcStdio": true
+      },
+      "producibleFaults": [],
+      "inputSchema": {
+        "additionalProperties": false,
+        "properties": {},
+        "type": "object"
+      },
+      "outputSchema": {
+        "additionalProperties": false,
+        "properties": {
+          "items": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "currentValue": {
+                  "type": "number"
+                },
+                "firedAt": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "metric": {
+                  "enum": ["workflow.failure_rate", "activity.p99_duration", "storage.size"],
+                  "type": "string"
+                },
+                "threshold": {
+                  "type": "number"
+                },
+                "window": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                }
+              },
+              "required": ["metric", "threshold", "currentValue", "window", "firedAt"],
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "required": ["items"],
+        "type": "object"
+      }
+    },
     {
       "name": "weft.events.sse",
       "kind": "stream",

package/dist/cli/generated/operation-client.generated.d.ts

@@ -1,7 +1,7 @@
 import { type CatalogWeftClient, type WeftClientConnection } from '../operation-client-runtime.ts';
-export declare const CATALOG_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.drain", "weft.workers.list", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
+export declare const CATALOG_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.alerts.list", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.drain", "weft.workers.list", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
 export type CatalogOperationName = (typeof CATALOG_OPERATION_NAMES)[number];
-export declare const CLIENT_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.tasks.diagnostics.deadletters.clear", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.drain", "weft.workers.list", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
+export declare const CLIENT_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.alerts.list", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.tasks.diagnostics.deadletters.clear", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.drain", "weft.workers.list", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
 export type ClientOperationName = (typeof CLIENT_OPERATION_NAMES)[number];
 export declare const CLIENT_REST_OPERATION_BINDINGS: {
     readonly 'weft.tasks.diagnostics.deadletters.clear': {
@@ -93,6 +93,19 @@ export type ClientOperationTypes = {
         };
         readonly faults: 'InvalidParams' | 'NotFound';
     };
+    'weft.alerts.list': {
+        readonly input: {};
+        readonly output: {
+            readonly items: ReadonlyArray<{
+                readonly currentValue: number;
+                readonly firedAt: unknown;
+                readonly metric: 'workflow.failure_rate' | 'activity.p99_duration' | 'storage.size';
+                readonly threshold: number;
+                readonly window: unknown;
+            }>;
+        };
+        readonly faults: never;
+    };
     'weft.recover.all': {
         readonly input: {};
         readonly output: {

package/dist/cli/generated/operation-client.generated.js

@@ -5,6 +5,7 @@ import {
 export const CATALOG_OPERATION_NAMES = [
   "weft.activities.complete",
   "weft.activities.fail",
+  "weft.alerts.list",
   "weft.recover.all",
   "weft.retention.get",
   "weft.reviews.decision.submit",
@@ -65,6 +66,7 @@ export const CATALOG_OPERATION_NAMES = [
 ], CLIENT_OPERATION_NAMES = [
   "weft.activities.complete",
   "weft.activities.fail",
+  "weft.alerts.list",
   "weft.recover.all",
   "weft.retention.get",
   "weft.reviews.decision.submit",

package/dist/cli/help-text.d.ts

@@ -1,4 +1,4 @@
-export declare const HELP_TEXT = "\nweft - Bun-native durable execution engine\n\nUsage: weft [command] [options]\n\nCommands:\n  serve           Start the Weft server (default)\n  doctor          Run diagnostics on the Weft database\n  conformance     Run RemoteWorker protocol conformance checks\n  schedule        Manage recurring schedules\n  timeline        Inspect workflow timeline and replay history\n  version:check   Check workflow version compatibility\n  validate        Lint workflow definitions for design-time anti-patterns\n  codegen         Generate TypeScript declarations from a registry snapshot\n  api             Inspect and invoke catalog operations on a running server\n  server          Inspect a running server's health and operation surface\n  workflow        List, inspect, start, signal, and cancel workflows on a server\n  tail            Stream a workflow's events as Server-Sent Events\n  completions     Generate or install shell completion scripts\n  version         Print the installed Weft version\n\nVersion (leading token only; a subcommand owns its own option line):\n  weft version | weft --version | weft -v   Print the installed Weft version\n\nServe Options:\n  -p, --port <port>           Server port (default: 7233)\n  -d, --database <path>       Database file path (default: ./weft.db)\n  -s, --storage <backend>     Storage backend: sqlite, lmdb, memory (default: sqlite)\n  -w, --workflows <path>      Path to workflow module to register on startup\n  -h, --help                  Show this help message\n";
+export declare const HELP_TEXT = "\nweft - Bun-native durable execution engine\n\nUsage: weft [command] [options]\n\nCommands:\n  serve           Start the Weft server (default)\n  doctor          Run diagnostics on the Weft database\n  conformance     Run RemoteWorker protocol conformance checks\n  schedule        Manage recurring schedules\n  timeline        Inspect workflow timeline and replay history\n  version:check   Check workflow version compatibility\n  validate        Lint workflow definitions for design-time anti-patterns\n  codegen         Generate TypeScript declarations from a registry snapshot\n  api             Inspect and invoke catalog operations on a running server\n  server          Inspect a running server's health and operation surface\n  workflow        List, inspect, start, signal, and cancel workflows on a server\n  tail            Stream a workflow's events as Server-Sent Events\n  completions     Generate or install shell completion scripts\n  version         Print the installed Weft version\n\nVersion (leading token only; a subcommand owns its own option line):\n  weft version | weft --version | weft -v   Print the installed Weft version\n\nServe Options:\n  -p, --port <port>           Server port (default: 7233)\n  -d, --database <path>       Database file path (default: ./weft.db)\n  -s, --storage <backend>     Storage backend: sqlite, lmdb, memory (default: sqlite)\n  -w, --workflows <path>      Path to workflow module to register on startup\n      --console               Mount @lostgradient/weft-console\n  -h, --help                  Show this help message\n";
 export declare const API_HELP_TEXT = "\nweft api - Inspect and invoke catalog operations on a running server\n\nUsage:\n  weft api --list [options]\n  weft api --describe <operation-name> [options]\n  weft api <operation-name> [--input <json> | --input-file <path|->] [options]\n\nOptions:\n      --server <url>       Server URL (default: WEFT_ADDR, profile, run lockfile, or localhost)\n      --token <token>      Bearer token (default: WEFT_TOKEN)\n      --profile <name>     Profile from ~/.weft/config (default: WEFT_PROFILE or default_profile)\n      --input <json>       JSON object input for the operation\n      --input-file <path>  Read JSON object input from a file, or '-' for stdin\n      --list               List catalog operations\n      --describe <name>    Print one operation's schema and metadata\n      --yes                Confirm destructive operations without prompting\n  -j, --json               Emit machine-readable JSON output\n  -h, --help               Show this help message\n\nExit codes:\n  0   Success\n  1   Operation failed or destructive operation was not confirmed\n  2   Connection error\n  3   Usage or input validation error\n";
 export declare const CONFORMANCE_HELP_TEXT = "\nweft conformance - Run RemoteWorker protocol conformance checks\n\nUsage: weft conformance [options] -- <worker-command> [args...]\n\nThe worker command receives:\n  WEFT_WORKER_URL\n  WEFT_WORKER_QUEUE\n  WEFT_WORKER_ACTIVITIES\n  WEFT_WORKER_PROTOCOL_VERSION\n\nOptions:\n      --timeout <ms>       Per-check timeout in milliseconds (default: 15000)\n  -j, --json               Output results as JSON\n  -h, --help               Show this help message\n";
 export declare const DOCTOR_HELP_TEXT = "\nweft doctor - Run diagnostics on the Weft database\n\nUsage: weft doctor [options]\n\nOptions:\n  -d, --database <path>   Database file path (default: ./weft.db)\n  -j, --json              Output results as JSON\n  -h, --help              Show this help message\n";

package/dist/cli/help-text.js

@@ -27,6 +27,7 @@ Serve Options:
   -d, --database <path>       Database file path (default: ./weft.db)
   -s, --storage <backend>     Storage backend: sqlite, lmdb, memory (default: sqlite)
   -w, --workflows <path>      Path to workflow module to register on startup
+      --console               Mount @lostgradient/weft-console
   -h, --help                  Show this help message
 `, API_HELP_TEXT = `
 weft api - Inspect and invoke catalog operations on a running server

package/dist/cli/index.d.ts

@@ -4,6 +4,7 @@ export { executeApi } from './api.ts';
 export { executeCodegen } from './codegen.ts';
 export { executeCompletions } from './completions.ts';
 export { executeConformance } from './conformance.ts';
+export { loadConsoleMount } from './console.ts';
 export { executeDoctor } from './doctor.ts';
 export { createWeftClient } from './generated/operation-client.generated.ts';
 export type { CatalogOperationName, WeftClient } from './generated/operation-client.generated.ts';

package/dist/cli/index.js

@@ -4,6 +4,7 @@ export { executeApi } from "./api.js";
 export { executeCodegen } from "./codegen.js";
 export { executeCompletions } from "./completions.js";
 export { executeConformance } from "./conformance.js";
+export { loadConsoleMount } from "./console.js";
 export { executeDoctor } from "./doctor.js";
 export { createWeftClient } from "./generated/operation-client.generated.js";
 export {

package/dist/cli/json-input.d.ts

@@ -0,0 +1,20 @@
+export type JsonInputFailure = {
+    readonly kind: 'invalid-json';
+    readonly detail: string;
+    readonly message: string;
+} | {
+    readonly kind: 'missing-file';
+    readonly message: string;
+    readonly path: string;
+};
+export type JsonInputResult = {
+    readonly ok: true;
+    readonly value: unknown;
+} | {
+    readonly ok: false;
+    readonly error: JsonInputFailure;
+};
+/** Parse one inline JSON source without applying a command-specific error format. */
+export declare function parseJsonInput(source: string): JsonInputResult;
+/** Load JSON from inline input, a file, or stdin without applying caller policy. */
+export declare function loadJsonInput(input: string | undefined, inputFile: string | undefined, readStdin?: () => Promise<string>): Promise<JsonInputResult>;

package/dist/cli/json-input.js

@@ -0,0 +1,33 @@
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+export function parseJsonInput(source) {
+  try {
+    return { ok: !0, value: JSON.parse(source) };
+  } catch (error) {
+    const detail = errorMessage(error);
+    return {
+      ok: !1,
+      error: { kind: "invalid-json", detail, message: `invalid JSON input: ${detail}` }
+    };
+  }
+}
+export async function loadJsonInput(input, inputFile, readStdin = () => Bun.stdin.text()) {
+  if (input !== void 0)
+    return parseJsonInput(input);
+  if (inputFile === void 0)
+    return { ok: !0, value: void 0 };
+  if (inputFile === "-")
+    return parseJsonInput(await readStdin());
+  const file = Bun.file(inputFile);
+  if (!await file.exists())
+    return {
+      ok: !1,
+      error: {
+        kind: "missing-file",
+        message: `input file not found: ${inputFile}`,
+        path: inputFile
+      }
+    };
+  return parseJsonInput(await file.text());
+}

package/dist/cli/parse-arguments.js

@@ -75,6 +75,7 @@ function parseServeArguments(args) {
       database: { type: "string", short: "d", default: "./weft.db" },
       storage: { type: "string", short: "s", default: "sqlite" },
       help: { type: "boolean", short: "h", default: !1 },
+      console: { type: "boolean", default: !1 },
       workflows: { type: "string", short: "w" }
     },
     strict: !0,
@@ -89,6 +90,7 @@ function parseServeArguments(args) {
     database: values.database ?? "./weft.db",
     storage: parseStorageBackend(values.storage),
     help: values.help ?? !1,
+    console: values.console ?? !1,
     ...values.workflows ? { workflows: values.workflows } : {}
   };
 }

package/dist/cli/schedule.js

@@ -1,4 +1,5 @@
 import { registerOnRuntimeEngine, runtimeWorkflowEngine } from "../core/runtime-workflow-engine.js";
+import { parseJsonInput } from "./json-input.js";
 import { createStorage } from "./storage-factory.js";
 function formatScheduleCadence(schedule) {
   if (schedule.intervalMs !== void 0)
@@ -42,13 +43,6 @@ function getScheduleCreateValidationError(options) {
     return "Error: provide a <cronExpression> argument or an --every <duration> flag for schedule create";
   return null;
 }
-function parseScheduleInput(input) {
-  try {
-    return { ok: !0, value: JSON.parse(input) };
-  } catch (error) {
-    return { ok: !1, message: `Error: could not parse --input JSON: ${error instanceof Error ? error.message : String(error)}` };
-  }
-}
 async function registerScheduleWorkflows(engine, workflowsPath, loadRegistrationsFromModule) {
   const loaded = await loadRegistrationsFromModule(workflowsPath);
   for (const definition of Object.values(loaded.registrations))
@@ -59,9 +53,13 @@ async function executeScheduleCreate(options, engine, loadRegistrationsFromModul
   if (validationError !== null)
     return { stdout: "", stderr: validationError, exitCode: 1 };
   await registerScheduleWorkflows(engine, options.workflows, loadRegistrationsFromModule);
-  const parsedInput = parseScheduleInput(options.input);
+  const parsedInput = parseJsonInput(options.input);
   if (!parsedInput.ok)
-    return { stdout: "", stderr: parsedInput.message, exitCode: 1 };
+    return {
+      stdout: "",
+      stderr: parsedInput.error.kind === "invalid-json" ? `Error: could not parse --input JSON: ${parsedInput.error.detail}` : `Error: ${parsedInput.error.message}`,
+      exitCode: 1
+    };
   const spec = options.every !== void 0 ? { every: options.every } : options.cronExpression, handle = await engine.schedule(options.workflowType, parsedInput.value, spec, {
     ...options.id !== void 0 ? { id: options.id } : {},
     ...options.overlap !== void 0 ? { overlap: options.overlap } : {},

package/dist/cli/types.d.ts

@@ -10,6 +10,7 @@ export type CliCommand = {
     database: string;
     storage: StorageBackend;
     help: boolean;
+    console: boolean;
     workflows?: string;
 } | {
     command: 'version';

package/dist/cli/workflow-commands.js

@@ -1,7 +1,7 @@
+import { loadJsonInput } from "./json-input.js";
 import {
   confirmDestructive,
   formatTimestamp,
-  messageOf,
   ndjson,
   prettyJson,
   truncateToWidth
@@ -105,30 +105,10 @@ async function executeWorkflowEvents(command, connection) {
   }).join(`
 `), exitCode: 0 };
 }
-async function readInlineInput(input, inputFile) {
-  if (input !== void 0)
-    return parseJson(input);
-  if (inputFile !== void 0) {
-    if (inputFile === "-")
-      return parseJson(await Bun.stdin.text());
-    const file = Bun.file(inputFile);
-    if (!await file.exists())
-      return { ok: !1, message: `input file not found: ${inputFile}` };
-    return parseJson(await file.text());
-  }
-  return { ok: !0, value: void 0 };
-}
-function parseJson(source) {
-  try {
-    return { ok: !0, value: JSON.parse(source) };
-  } catch (error) {
-    return { ok: !1, message: `invalid JSON input: ${messageOf(error)}` };
-  }
-}
 async function executeWorkflowStart(command, connection) {
-  const parsed = await readInlineInput(command.input, command.inputFile);
+  const parsed = await loadJsonInput(command.input, command.inputFile);
   if (!parsed.ok)
-    return { stdout: "", stderr: `workflow start: ${parsed.message}`, exitCode: 3 };
+    return { stdout: "", stderr: `workflow start: ${parsed.error.message}`, exitCode: 3 };
   const result = await callCatalogOperation(connection, "weft.workflows.start", {
     type: command.workflowType,
     ...parsed.value === void 0 ? {} : { input: parsed.value },
@@ -169,9 +149,9 @@ async function executeWorkflowCancel(command, connection) {
   };
 }
 async function executeWorkflowSignal(command, connection) {
-  const parsed = await readInlineInput(command.input, command.inputFile);
+  const parsed = await loadJsonInput(command.input, command.inputFile);
   if (!parsed.ok)
-    return { stdout: "", stderr: `workflow signal: ${parsed.message}`, exitCode: 3 };
+    return { stdout: "", stderr: `workflow signal: ${parsed.error.message}`, exitCode: 3 };
   const result = await callCatalogOperation(connection, "weft.workflows.signal", {
     workflowId: command.workflowId,
     signalName: command.signalName,

package/dist/cli-main.js

@@ -21,6 +21,7 @@ import {
   executeWorkflow,
   findCliSubcommandName,
   HELP_TEXT,
+  loadConsoleMount,
   parseCliArguments,
   removeRunLockfile,
   SCHEDULE_HELP_TEXT,
@@ -53,7 +54,7 @@ if (parsedArguments.command === "version") {
     console.log(HELP_TEXT);
     process.exit(0);
   }
-  const storage = await createStorage(parsedArguments.storage, parsedArguments.database), engine = new Engine({ storage });
+  const consoleMount = parsedArguments.console ? await loadConsoleMount() : void 0, storage = await createStorage(parsedArguments.storage, parsedArguments.database), engine = new Engine({ storage });
   if (parsedArguments.workflows) {
     const { loadRegistrationsFromModule } = await import("./diagnostics/validate.js"), { registerModuleExports } = await import("./cli/serve-registrations.js"), loaded = await loadRegistrationsFromModule(parsedArguments.workflows);
     registerModuleExports(engine, loaded.registrations, loaded.activities);
@@ -61,7 +62,8 @@ if (parsedArguments.command === "version") {
     console.log("No --workflows module provided; starting in inspect-only mode.");
   const server = serve({
     engine,
-    port: Number(parsedArguments.port)
+    port: Number(parsedArguments.port),
+    ...consoleMount
   });
   await writeRunLockfile(server.url);
   console.log(`Weft API running at ${new URL("/api/v1", server.url).href}`);

package/dist/core/engine/index.d.ts

@@ -1,3 +1,4 @@
+import type { AlertState } from '../../alerting/types.ts';
 import { type Storage as WeftStorage } from '../../storage/interface.ts';
 import { type ActivityMetadata, type ActivityRegistrationOptions, type RegisteredActivityFunction } from '../activity-registry.ts';
 import type { StoredStreamChunk } from '../context.ts';
@@ -145,6 +146,8 @@ export declare class Engine<TWorkflows extends object = DefaultWorkflowRegistry,
     removeEventListener<K extends Extract<keyof WeftEventMap, string>>(type: K, listener: (event: WeftEventMap[K]) => void, options?: boolean | EventListenerOptions): void;
     removeEventListener(type: string, listener: EventListenerOrEventListenerObject | null, options?: boolean | EventListenerOptions): void;
     get state(): EngineStateNamespace;
+    /** Return the alert rules that are currently firing. */
+    getActiveAlerts(): readonly AlertState[];
     /**
      * Register a workflow by name or definition, or register an activity
      * definition. Definition overloads return this same engine with the

package/dist/core/engine/index.js

@@ -522,6 +522,9 @@ export class Engine extends EventTarget {
       workflow: (workflowType, key, options) => new AtomicState(storage, KEYS.stateWorkflow(workflowType, key), options)
     };
   }
+  getActiveAlerts() {
+    return getInternals(this).alertManager?.activeStates ?? [];
+  }
   async#handleStrategyMessage(message) {
     return handleStrategyMessageFromInternals(getInternals(this), message, this.#createInlineParkingCallbacks());
   }

package/dist/diagnostics/recommendations.js

@@ -1,3 +1,4 @@
+import { formatBytes } from "./format.js";
 import { THRESHOLDS } from "./types.js";
 function integrityFailureRule({ database }) {
   if (database.integrityOk)
@@ -95,15 +96,6 @@ export function generateRecommendations(report, thresholds) {
   };
   return RECOMMENDATION_RULES.flatMap((rule) => rule(context));
 }
-function formatBytes(bytes) {
-  if (bytes < 1024)
-    return `${bytes} B`;
-  if (bytes < 1048576)
-    return `${(bytes / 1024).toFixed(1)} KB`;
-  if (bytes < 1073741824)
-    return `${(bytes / 1048576).toFixed(1)} MB`;
-  return `${(bytes / 1073741824).toFixed(1)} GB`;
-}
 function formatDuration(milliseconds) {
   const seconds = Math.floor(milliseconds / 1000), minutes = Math.floor(seconds / 60), hours = Math.floor(minutes / 60), days = Math.floor(hours / 24);
   if (days > 0)

package/dist/http.js

@@ -1,2 +1,2 @@
-async function*R(F,G){if(F.body===null)return;let J=F.body.getReader(),Q=new TextDecoder,Z="",$=0,j=!1;try{while(!0){let{done:y,value:z}=await J.read();if(y){j=!0;break}if($+=z.byteLength,$>G.maximumBytes)throw G.sizeLimitError();Z+=Q.decode(z,{stream:!0});let A=Z.split(`
-`);Z=A.pop()??"";for(let g of A)yield g}if(Z+=Q.decode(),Z.length>0)yield Z}finally{if(!j)try{await J.cancel()}catch{}J.releaseLock()}}function N(F){let G=[];for(let J=0;J<F.length;J+=512)G.push(String.fromCharCode(...F.subarray(J,J+512)));return btoa(G.join(""))}function B(F){let G=atob(F),J=new Uint8Array(G.length);for(let Q=0;Q<G.length;Q+=1)J[Q]=G.charCodeAt(Q);return J}function q(F){return typeof F==="object"&&F!==null&&!Array.isArray(F)}async function _(F,G){return await F.get(G)!==null}async function*X(F,G,J){for await(let[Q]of F.scan(G,J))yield Q}async function H(F,G){let J=0;for await(let Q of X(F,G))J++;return J}async function L(F,G){let J=[];for await(let Q of X(F,G))J.push({type:"delete",key:Q});if(J.length===0)return 0;return await F.batch(J),J.length}async function U(F,G,J){let Q=[];for await(let Z of X(F,G,J))Q.push({type:"delete",key:Z});if(Q.length===0)return 0;return await F.batch(Q),Q.length}function C(F,G,J){if(!F.capabilities()[G])throw Error(`Feature "${J}" requires storage capability "${G}", but this storage backend does not provide it.`)}var D=1e4;class T extends Error{code="StorageBatchOperationLimitExceededError";cap=D;count;target;constructor(F,G){super(`${F} count ${G} exceeds MAX_BATCH_OPERATIONS (${D}).`);this.name="StorageBatchOperationLimitExceededError",this.target=F,this.count=G}}function M(F,G){if(G>D)throw new T(F,G)}function K(F){return F.length>0?F.slice(0,-1)+String.fromCharCode(F.charCodeAt(F.length-1)+1):"ÿ"}function e(F,G={}){if(G.gt!==void 0&&F<=G.gt)return!1;if(G.gte!==void 0&&F<G.gte)return!1;if(G.lt!==void 0&&F>=G.lt)return!1;if(G.lte!==void 0&&F>G.lte)return!1;return!0}function FF(F,G){if(F===null||G===null)return F===G;if(F.byteLength!==G.byteLength)return!1;for(let J=0;J<F.byteLength;J++)if(F[J]!==G[J])return!1;return!0}async function S(F,G){if(F.has)return F.has(G);return _(F,G)}function P(F,G,J){if(F.keys)return F.keys(G,J);return X(F,G,J)}async function O(F,G){if(F.count)return F.count(G);return H(F,G)}async function b(F,G){if(F.deletePrefix)return F.deletePrefix(G);return L(F,G)}async function v(F,G,J){if(M("conditionalBatch conditions",G.length),M("conditionalBatch operations",J.length),C(F,"conditionalBatch","storageConditionalBatch"),!F.conditionalBatch)throw Error("This storage backend reports conditionalBatch capability but does not implement the conditionalBatch() method.");return F.conditionalBatch(G,J)}function c(F){if(F===void 0)return;if(typeof F!=="number"||!Number.isInteger(F)||F<0)throw Error("deleteRange limit must be a finite non-negative integer");return F===0?0:F}function V(F){let G={},J=!1;for(let Z of["gt","gte","lt","lte"]){let $=F[Z];if($===void 0)continue;if(typeof $!=="string")throw Error("deleteRange bounds must be strings");G[Z]=$,J=!0}if(!J)throw Error("deleteRange requires at least one of gt/gte/lt/lte; use deletePrefix to delete a whole prefix");let Q=c(F.limit);if(Q!==void 0)G.limit=Q;return G}async function h(F,G,J){let Q=V(J);if(F.deleteRange)return F.deleteRange(G,Q);return U(F,G,Q)}function I(F,G){let J={key:F,open:!1};if(G.gte!==void 0&&G.gte>J.key)J.key=G.gte,J.open=!1;if(G.gt!==void 0&&G.gt>=J.key)J.key=G.gt,J.open=!0;return J}function u(F,G){let J={key:K(F),open:!0};if(G.lt!==void 0&&G.lt<=J.key)J.key=G.lt,J.open=!0;if(G.lte!==void 0&&G.lte<J.key)J.key=G.lte,J.open=!1;return J}function ZF(F,G){let J=I(F,G),Q=u(F,G);if(J.key>Q.key||J.key===Q.key&&(J.open||Q.open))return null;return{lower:J,upper:Q}}function E(F){return F.replaceAll(/:+$/g,"")}function k(F,G){let J=E(F),Q=E(G);if(J.length===0)return Q;if(Q.length===0)return J;return`${J}:${Q}`}class W{#G;#J;constructor(F,G){this.#G=F,this.#J=E(G)}#F(F){if(this.#J.length===0)return F;return F.length===0?`${this.#J}:`:`${this.#J}:${F}`}#Z(F){return F.map((G)=>{if(G.type==="put")return{type:"put",key:this.#F(G.key),value:G.value};return{type:"delete",key:this.#F(G.key)}})}#$(F){if(this.#J.length===0)return F;return F.slice(this.#J.length+1)}#M(F={}){let G={};if(F.limit!==void 0)G.limit=F.limit;if(F.reverse!==void 0)G.reverse=F.reverse;if(F.gt!==void 0)G.gt=this.#F(F.gt);if(F.gte!==void 0)G.gte=this.#F(F.gte);if(F.lt!==void 0)G.lt=this.#F(F.lt);if(F.lte!==void 0)G.lte=this.#F(F.lte);return G}#Q(F){let G={};if(F.limit!==void 0)G.limit=F.limit;if(F.gt!==void 0)G.gt=this.#F(F.gt);if(F.gte!==void 0)G.gte=this.#F(F.gte);if(F.lt!==void 0)G.lt=this.#F(F.lt);if(F.lte!==void 0)G.lte=this.#F(F.lte);return G}capabilities(){return this.#G.capabilities()}scoped(F){return new W(this.#G,k(this.#J,F))}async get(F){return this.#G.get(this.#F(F))}async put(F,G){await this.#G.put(this.#F(F),G)}async delete(F){await this.#G.delete(this.#F(F))}async*scan(F,G){for await(let[J,Q]of this.#G.scan(this.#F(F),this.#M(G)))yield[this.#$(J),Q]}async batch(F){M("batch operations",F.length),await this.#G.batch(this.#Z(F))}async conditionalBatch(F,G){return v(this.#G,F.map((J)=>({key:this.#F(J.key),expectedValue:J.expectedValue})),this.#Z(G))}async has(F){return S(this.#G,this.#F(F))}async deletePrefix(F){return b(this.#G,this.#F(F))}async deleteRange(F,G){let J=this.#Q(V(G));return h(this.#G,this.#F(F),J)}async*keys(F,G){for await(let J of P(this.#G,this.#F(F),this.#M(G)))yield this.#$(J)}async count(F){return O(this.#G,this.#F(F))}[Symbol.dispose](){this.#G[Symbol.dispose]()}}function m(F,G){return new W(F,G)}var w=67108864;function x(F){if(F.type==="put")return{type:"put",key:F.key,value:N(F.value)};return{type:"delete",key:F.key}}function f(F){return{key:F.key,expectedValue:F.expectedValue===null?null:N(F.expectedValue)}}function d(F){if(!q(F)||typeof F.key!=="string"||typeof F.value!=="string")throw Error("HTTPStorage scan response contained an invalid NDJSON entry.");return{key:F.key,value:F.value}}function l(F){if(!q(F)||typeof F.applied!=="boolean")throw Error('HTTPStorage conditional batch response must include a boolean "applied" field.');return F.applied}function Y(F,G,J){if(J!==void 0)F.searchParams.set(G,String(J))}function p(F){if(F.trim().length===0)return null;let G=d(JSON.parse(F));return[G.key,B(G.value)]}class a{#G;#J;#F;constructor(F){this.#G=F.baseUrl instanceof URL?F.baseUrl:new URL(F.baseUrl),this.#J={...F.headers},this.#F=F.remoteConditionalBatch??!1}capabilities(){return{persistence:"remote",readAfterWrite:"eventual",scanConsistency:"best-effort",atomicBatch:!0,conditionalBatch:this.#F,boundedRangeDelete:!1}}#Z(F){let G=this.#G.href.endsWith("/")?this.#G.href:`${this.#G.href}/`;return new URL(F.replace(/^\/+/,""),G)}#$(F){return this.#Z(`/v1/storage/${encodeURIComponent(F)}`)}#M(F,G){let J=this.#Z("/v1/storage");return J.searchParams.set("prefix",F),Y(J,"limit",G.limit),Y(J,"reverse",G.reverse),Y(J,"gt",G.gt),Y(J,"gte",G.gte),Y(J,"lt",G.lt),Y(J,"lte",G.lte),J}async#Q(F,G={},J=[]){let Q=new Headers(this.#J);for(let[$,j]of new Headers(G.headers).entries())Q.set($,j);let Z=await fetch(F,{...G,headers:Q});if(!Z.ok&&!J.includes(Z.status))throw Error(`HTTPStorage request failed: ${G.method??"GET"} ${F.pathname} returned ${String(Z.status)}.`);return Z}async get(F){let G=await this.#Q(this.#$(F),{method:"GET"},[404]);if(G.status===404)return null;return new Uint8Array(await G.arrayBuffer())}async put(F,G){await this.#Q(this.#$(F),{method:"PUT",headers:{"content-type":"application/octet-stream"},body:new Blob([G])})}async delete(F){await this.#Q(this.#$(F),{method:"DELETE"})}async*scan(F,G={}){let J=await this.#Q(this.#M(F,G),{method:"GET",headers:{accept:"application/x-ndjson"}});for await(let Q of R(J,{maximumBytes:w,sizeLimitError:()=>Error("HTTPStorage scan response exceeded the maximum allowed size.")})){let Z=p(Q);if(Z!==null)yield Z}}async batch(F){M("batch operations",F.length),await this.#Q(this.#Z("/v1/storage/-/batch"),{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({operations:F.map(x)})})}async conditionalBatch(F,G){M("conditionalBatch conditions",F.length),M("conditionalBatch operations",G.length);let J=await this.#Q(this.#Z("/v1/storage/-/conditional-batch"),{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({conditions:F.map(f),operations:G.map(x)})});return l(await J.json())}has(F){return _(this,F)}async*keys(F,G){yield*X(this,F,G)}count(F){return H(this,F)}deletePrefix(F){return L(this,F)}deleteRange(F,G){return U(this,F,V(G))}scoped(F){return m(this,F)}[Symbol.dispose](){}}export{a as HTTPStorage};
+async function*B(F,G){if(F.body===null)return;let J=F.body.getReader(),Q=new TextDecoder,Z="",$=0,j=!1;try{while(!0){let{done:y,value:z}=await J.read();if(y){j=!0;break}if($+=z.byteLength,$>G.maximumBytes)throw G.sizeLimitError();Z+=Q.decode(z,{stream:!0});let A=Z.split(`
+`);Z=A.pop()??"";for(let g of A)yield g}if(Z+=Q.decode(),Z.length>0)yield Z}finally{if(!j)try{await J.cancel()}catch{}J.releaseLock()}}function N(F){let G=[];for(let J=0;J<F.length;J+=512)G.push(String.fromCharCode(...F.subarray(J,J+512)));return btoa(G.join(""))}function R(F){let G=atob(F),J=new Uint8Array(G.length);for(let Q=0;Q<G.length;Q+=1)J[Q]=G.charCodeAt(Q);return J}function q(F){return typeof F==="object"&&F!==null&&!Array.isArray(F)}async function _(F,G){return await F.get(G)!==null}async function*X(F,G,J){for await(let[Q]of F.scan(G,J))yield Q}async function H(F,G){let J=0;for await(let Q of X(F,G))J++;return J}async function L(F,G){let J=[];for await(let Q of X(F,G))J.push({type:"delete",key:Q});if(J.length===0)return 0;return await F.batch(J),J.length}async function U(F,G,J){let Q=[];for await(let Z of X(F,G,J))Q.push({type:"delete",key:Z});if(Q.length===0)return 0;return await F.batch(Q),Q.length}function C(F,G,J){if(!F.capabilities()[G])throw Error(`Feature "${J}" requires storage capability "${G}", but this storage backend does not provide it.`)}var D=1e4;class T extends Error{code="StorageBatchOperationLimitExceededError";cap=D;count;target;constructor(F,G){super(`${F} count ${G} exceeds MAX_BATCH_OPERATIONS (${D}).`);this.name="StorageBatchOperationLimitExceededError",this.target=F,this.count=G}}function M(F,G){if(G>D)throw new T(F,G)}function K(F){return F.length>0?F.slice(0,-1)+String.fromCharCode(F.charCodeAt(F.length-1)+1):"ÿ"}function e(F,G={}){if(G.gt!==void 0&&F<=G.gt)return!1;if(G.gte!==void 0&&F<G.gte)return!1;if(G.lt!==void 0&&F>=G.lt)return!1;if(G.lte!==void 0&&F>G.lte)return!1;return!0}function FF(F,G){if(F===null||G===null)return F===G;if(F.byteLength!==G.byteLength)return!1;for(let J=0;J<F.byteLength;J++)if(F[J]!==G[J])return!1;return!0}async function S(F,G){if(F.has)return F.has(G);return _(F,G)}function O(F,G,J){if(F.keys)return F.keys(G,J);return X(F,G,J)}async function P(F,G){if(F.count)return F.count(G);return H(F,G)}async function b(F,G){if(F.deletePrefix)return F.deletePrefix(G);return L(F,G)}async function v(F,G,J){if(M("conditionalBatch conditions",G.length),M("conditionalBatch operations",J.length),C(F,"conditionalBatch","storageConditionalBatch"),!F.conditionalBatch)throw Error("This storage backend reports conditionalBatch capability but does not implement the conditionalBatch() method.");return F.conditionalBatch(G,J)}function c(F){if(F===void 0)return;if(typeof F!=="number"||!Number.isInteger(F)||F<0)throw Error("deleteRange limit must be a finite non-negative integer");return F===0?0:F}function V(F){let G={},J=!1;for(let Z of["gt","gte","lt","lte"]){let $=F[Z];if($===void 0)continue;if(typeof $!=="string")throw Error("deleteRange bounds must be strings");G[Z]=$,J=!0}if(!J)throw Error("deleteRange requires at least one of gt/gte/lt/lte; use deletePrefix to delete a whole prefix");let Q=c(F.limit);if(Q!==void 0)G.limit=Q;return G}async function h(F,G,J){let Q=V(J);if(F.deleteRange)return F.deleteRange(G,Q);return U(F,G,Q)}function I(F,G){let J={key:F,open:!1};if(G.gte!==void 0&&G.gte>J.key)J.key=G.gte,J.open=!1;if(G.gt!==void 0&&G.gt>=J.key)J.key=G.gt,J.open=!0;return J}function u(F,G){let J={key:K(F),open:!0};if(G.lt!==void 0&&G.lt<=J.key)J.key=G.lt,J.open=!0;if(G.lte!==void 0&&G.lte<J.key)J.key=G.lte,J.open=!1;return J}function ZF(F,G){let J=I(F,G),Q=u(F,G);if(J.key>Q.key||J.key===Q.key&&(J.open||Q.open))return null;return{lower:J,upper:Q}}function E(F){return F.replaceAll(/:+$/g,"")}function k(F,G){let J=E(F),Q=E(G);if(J.length===0)return Q;if(Q.length===0)return J;return`${J}:${Q}`}class W{#F;#J;constructor(F,G){this.#F=F,this.#J=E(G)}#G(F){if(this.#J.length===0)return F;return F.length===0?`${this.#J}:`:`${this.#J}:${F}`}#Z(F){return F.map((G)=>{if(G.type==="put")return{type:"put",key:this.#G(G.key),value:G.value};return{type:"delete",key:this.#G(G.key)}})}#$(F){if(this.#J.length===0)return F;return F.slice(this.#J.length+1)}#M(F){let G={};if(F.limit!==void 0)G.limit=F.limit;if(F.gt!==void 0)G.gt=this.#G(F.gt);if(F.gte!==void 0)G.gte=this.#G(F.gte);if(F.lt!==void 0)G.lt=this.#G(F.lt);if(F.lte!==void 0)G.lte=this.#G(F.lte);return G}#Q(F={}){let G=this.#M(F);if(F.reverse!==void 0)G.reverse=F.reverse;return G}#X(F){return this.#M(F)}capabilities(){return this.#F.capabilities()}scoped(F){return new W(this.#F,k(this.#J,F))}async get(F){return this.#F.get(this.#G(F))}async put(F,G){await this.#F.put(this.#G(F),G)}async delete(F){await this.#F.delete(this.#G(F))}async*scan(F,G){for await(let[J,Q]of this.#F.scan(this.#G(F),this.#Q(G)))yield[this.#$(J),Q]}async batch(F){M("batch operations",F.length),await this.#F.batch(this.#Z(F))}async conditionalBatch(F,G){return v(this.#F,F.map((J)=>({key:this.#G(J.key),expectedValue:J.expectedValue})),this.#Z(G))}async has(F){return S(this.#F,this.#G(F))}async deletePrefix(F){return b(this.#F,this.#G(F))}async deleteRange(F,G){let J=this.#X(V(G));return h(this.#F,this.#G(F),J)}async*keys(F,G){for await(let J of O(this.#F,this.#G(F),this.#Q(G)))yield this.#$(J)}async count(F){return P(this.#F,this.#G(F))}[Symbol.dispose](){this.#F[Symbol.dispose]()}}function m(F,G){return new W(F,G)}var w=67108864;function x(F){if(F.type==="put")return{type:"put",key:F.key,value:N(F.value)};return{type:"delete",key:F.key}}function f(F){return{key:F.key,expectedValue:F.expectedValue===null?null:N(F.expectedValue)}}function d(F){if(!q(F)||typeof F.key!=="string"||typeof F.value!=="string")throw Error("HTTPStorage scan response contained an invalid NDJSON entry.");return{key:F.key,value:F.value}}function l(F){if(!q(F)||typeof F.applied!=="boolean")throw Error('HTTPStorage conditional batch response must include a boolean "applied" field.');return F.applied}function Y(F,G,J){if(J!==void 0)F.searchParams.set(G,String(J))}function p(F){if(F.trim().length===0)return null;let G=d(JSON.parse(F));return[G.key,R(G.value)]}class s{#F;#J;#G;constructor(F){this.#F=F.baseUrl instanceof URL?F.baseUrl:new URL(F.baseUrl),this.#J={...F.headers},this.#G=F.remoteConditionalBatch??!1}capabilities(){return{persistence:"remote",readAfterWrite:"eventual",scanConsistency:"best-effort",atomicBatch:!0,conditionalBatch:this.#G,boundedRangeDelete:!1}}#Z(F){let G=this.#F.href.endsWith("/")?this.#F.href:`${this.#F.href}/`;return new URL(F.replace(/^\/+/,""),G)}#$(F){return this.#Z(`/v1/storage/${encodeURIComponent(F)}`)}#M(F,G){let J=this.#Z("/v1/storage");return J.searchParams.set("prefix",F),Y(J,"limit",G.limit),Y(J,"reverse",G.reverse),Y(J,"gt",G.gt),Y(J,"gte",G.gte),Y(J,"lt",G.lt),Y(J,"lte",G.lte),J}async#Q(F,G={},J=[]){let Q=new Headers(this.#J);for(let[$,j]of new Headers(G.headers).entries())Q.set($,j);let Z=await fetch(F,{...G,headers:Q});if(!Z.ok&&!J.includes(Z.status))throw Error(`HTTPStorage request failed: ${G.method??"GET"} ${F.pathname} returned ${String(Z.status)}.`);return Z}async get(F){let G=await this.#Q(this.#$(F),{method:"GET"},[404]);if(G.status===404)return null;return new Uint8Array(await G.arrayBuffer())}async put(F,G){await this.#Q(this.#$(F),{method:"PUT",headers:{"content-type":"application/octet-stream"},body:new Blob([G])})}async delete(F){await this.#Q(this.#$(F),{method:"DELETE"})}async*scan(F,G={}){let J=await this.#Q(this.#M(F,G),{method:"GET",headers:{accept:"application/x-ndjson"}});for await(let Q of B(J,{maximumBytes:w,sizeLimitError:()=>Error("HTTPStorage scan response exceeded the maximum allowed size.")})){let Z=p(Q);if(Z!==null)yield Z}}async batch(F){M("batch operations",F.length),await this.#Q(this.#Z("/v1/storage/-/batch"),{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({operations:F.map(x)})})}async conditionalBatch(F,G){M("conditionalBatch conditions",F.length),M("conditionalBatch operations",G.length);let J=await this.#Q(this.#Z("/v1/storage/-/conditional-batch"),{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({conditions:F.map(f),operations:G.map(x)})});return l(await J.json())}has(F){return _(this,F)}async*keys(F,G){yield*X(this,F,G)}count(F){return H(this,F)}deletePrefix(F){return L(this,F)}deleteRange(F,G){return U(this,F,V(G))}scoped(F){return m(this,F)}[Symbol.dispose](){}}export{s as HTTPStorage};