@boxd-sh/convex 0.1.0

package/dist/component/_generated/dataModel.js

@@ -0,0 +1,11 @@
+/* eslint-disable */
+/**
+ * Generated data model types.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+import schema from "../schema.js";
+//# sourceMappingURL=dataModel.js.map

package/dist/component/_generated/dataModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataModel.js","sourceRoot":"","sources":["../../../src/component/_generated/dataModel.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;;;;;GAOG;AASH,OAAO,MAAM,MAAM,cAAc,CAAC"}

package/dist/component/_generated/server.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Generated utilities for implementing server-side Convex query and mutation functions.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+import type { ActionBuilder, HttpActionBuilder, MutationBuilder, QueryBuilder, GenericActionCtx, GenericMutationCtx, GenericQueryCtx, GenericDatabaseReader, GenericDatabaseWriter } from "convex/server";
+import type { DataModel } from "./dataModel.js";
+/**
+ * Typesafe environment variables.
+ *
+ * This includes platform-provided env vars and any variables declared in
+ * `convex.config.ts`.
+ */
+type Env = {
+    readonly CONVEX_CLOUD_URL: string;
+    readonly CONVEX_SITE_URL: string;
+    readonly BOXD_API_KEY: string;
+    readonly BOXD_BASE_URL: string | undefined;
+};
+/**
+ * Define a query in this Convex app's public API.
+ *
+ * This function will be allowed to read your Convex database and will be accessible from the client.
+ *
+ * @param func - The query function. It receives a {@link QueryCtx} as its first argument.
+ * @returns The wrapped query. Include this as an `export` to name it and make it accessible.
+ */
+export declare const query: QueryBuilder<DataModel, "public">;
+/**
+ * Define a query that is only accessible from other Convex functions (but not from the client).
+ *
+ * This function will be allowed to read from your Convex database. It will not be accessible from the client.
+ *
+ * @param func - The query function. It receives a {@link QueryCtx} as its first argument.
+ * @returns The wrapped query. Include this as an `export` to name it and make it accessible.
+ */
+export declare const internalQuery: QueryBuilder<DataModel, "internal">;
+/**
+ * Define a mutation in this Convex app's public API.
+ *
+ * This function will be allowed to modify your Convex database and will be accessible from the client.
+ *
+ * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.
+ * @returns The wrapped mutation. Include this as an `export` to name it and make it accessible.
+ */
+export declare const mutation: MutationBuilder<DataModel, "public">;
+/**
+ * Define a mutation that is only accessible from other Convex functions (but not from the client).
+ *
+ * This function will be allowed to modify your Convex database. It will not be accessible from the client.
+ *
+ * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.
+ * @returns The wrapped mutation. Include this as an `export` to name it and make it accessible.
+ */
+export declare const internalMutation: MutationBuilder<DataModel, "internal">;
+/**
+ * Define an action in this Convex app's public API.
+ *
+ * An action is a function which can execute any JavaScript code, including non-deterministic
+ * code and code with side-effects, like calling third-party services.
+ * They can be run in Convex's JavaScript environment or in Node.js using the "use node" directive.
+ * They can interact with the database indirectly by calling queries and mutations using the {@link ActionCtx}.
+ *
+ * @param func - The action. It receives an {@link ActionCtx} as its first argument.
+ * @returns The wrapped action. Include this as an `export` to name it and make it accessible.
+ */
+export declare const action: ActionBuilder<DataModel, "public">;
+/**
+ * Define an action that is only accessible from other Convex functions (but not from the client).
+ *
+ * @param func - The function. It receives an {@link ActionCtx} as its first argument.
+ * @returns The wrapped function. Include this as an `export` to name it and make it accessible.
+ */
+export declare const internalAction: ActionBuilder<DataModel, "internal">;
+/**
+ * Define an HTTP action.
+ *
+ * The wrapped function will be used to respond to HTTP requests received
+ * by a Convex deployment if the requests matches the path and method where
+ * this action is routed. Be sure to route your httpAction in `convex/http.js`.
+ *
+ * @param func - The function. It receives an {@link ActionCtx} as its first argument
+ * and a Fetch API `Request` object as its second.
+ * @returns The wrapped function. Import this function from `convex/http.js` and route it to hook it up.
+ */
+export declare const httpAction: HttpActionBuilder;
+export declare const env: Env;
+/**
+ * A set of services for use within Convex query functions.
+ *
+ * The query context is passed as the first argument to any Convex query
+ * function run on the server.
+ *
+ * If you're using code generation, use the `QueryCtx` type in `convex/_generated/server.d.ts` instead.
+ */
+export type QueryCtx = GenericQueryCtx<DataModel>;
+/**
+ * A set of services for use within Convex mutation functions.
+ *
+ * The mutation context is passed as the first argument to any Convex mutation
+ * function run on the server.
+ *
+ * If you're using code generation, use the `MutationCtx` type in `convex/_generated/server.d.ts` instead.
+ */
+export type MutationCtx = GenericMutationCtx<DataModel>;
+/**
+ * A set of services for use within Convex action functions.
+ *
+ * The action context is passed as the first argument to any Convex action
+ * function run on the server.
+ */
+export type ActionCtx = GenericActionCtx<DataModel>;
+/**
+ * An interface to read from the database within Convex query functions.
+ *
+ * The two entry points are {@link DatabaseReader.get}, which fetches a single
+ * document by its {@link Id}, or {@link DatabaseReader.query}, which starts
+ * building a query.
+ */
+export type DatabaseReader = GenericDatabaseReader<DataModel>;
+/**
+ * An interface to read from and write to the database within Convex mutation
+ * functions.
+ *
+ * Convex guarantees that all writes within a single mutation are
+ * executed atomically, so you never have to worry about partial writes leaving
+ * your data in an inconsistent state. See [the Convex Guide](https://docs.convex.dev/understanding/convex-fundamentals/functions#atomicity-and-optimistic-concurrency-control)
+ * for the guarantees Convex provides your functions.
+ */
+export type DatabaseWriter = GenericDatabaseWriter<DataModel>;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/component/_generated/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/component/_generated/server.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,eAAe,CAAC;AAUvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;GAKG;AACH,KAAK,GAAG,GAAG;IACT,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,EAAE,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAgB,CAAC;AAErE;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,YAAY,CAAC,SAAS,EAAE,UAAU,CACxC,CAAC;AAEvB;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAmB,CAAC;AAE9E;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAAe,CAAC,SAAS,EAAE,UAAU,CAC3C,CAAC;AAE1B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAiB,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,SAAS,EAAE,UAAU,CACzC,CAAC;AAExB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,iBAAqC,CAAC;AAC/D,eAAO,MAAM,GAAG,EAAE,GACJ,CAAC;AAEf;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;AAExD;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;AAE9D;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC"}

package/dist/component/_generated/server.js

@@ -0,0 +1,80 @@
+/* eslint-disable */
+/**
+ * Generated utilities for implementing server-side Convex query and mutation functions.
+ *
+ * THIS CODE IS AUTOMATICALLY GENERATED.
+ *
+ * To regenerate, run `npx convex dev`.
+ * @module
+ */
+import { actionGeneric, httpActionGeneric, queryGeneric, mutationGeneric, internalActionGeneric, internalMutationGeneric, internalQueryGeneric, } from "convex/server";
+/**
+ * Define a query in this Convex app's public API.
+ *
+ * This function will be allowed to read your Convex database and will be accessible from the client.
+ *
+ * @param func - The query function. It receives a {@link QueryCtx} as its first argument.
+ * @returns The wrapped query. Include this as an `export` to name it and make it accessible.
+ */
+export const query = queryGeneric;
+/**
+ * Define a query that is only accessible from other Convex functions (but not from the client).
+ *
+ * This function will be allowed to read from your Convex database. It will not be accessible from the client.
+ *
+ * @param func - The query function. It receives a {@link QueryCtx} as its first argument.
+ * @returns The wrapped query. Include this as an `export` to name it and make it accessible.
+ */
+export const internalQuery = internalQueryGeneric;
+/**
+ * Define a mutation in this Convex app's public API.
+ *
+ * This function will be allowed to modify your Convex database and will be accessible from the client.
+ *
+ * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.
+ * @returns The wrapped mutation. Include this as an `export` to name it and make it accessible.
+ */
+export const mutation = mutationGeneric;
+/**
+ * Define a mutation that is only accessible from other Convex functions (but not from the client).
+ *
+ * This function will be allowed to modify your Convex database. It will not be accessible from the client.
+ *
+ * @param func - The mutation function. It receives a {@link MutationCtx} as its first argument.
+ * @returns The wrapped mutation. Include this as an `export` to name it and make it accessible.
+ */
+export const internalMutation = internalMutationGeneric;
+/**
+ * Define an action in this Convex app's public API.
+ *
+ * An action is a function which can execute any JavaScript code, including non-deterministic
+ * code and code with side-effects, like calling third-party services.
+ * They can be run in Convex's JavaScript environment or in Node.js using the "use node" directive.
+ * They can interact with the database indirectly by calling queries and mutations using the {@link ActionCtx}.
+ *
+ * @param func - The action. It receives an {@link ActionCtx} as its first argument.
+ * @returns The wrapped action. Include this as an `export` to name it and make it accessible.
+ */
+export const action = actionGeneric;
+/**
+ * Define an action that is only accessible from other Convex functions (but not from the client).
+ *
+ * @param func - The function. It receives an {@link ActionCtx} as its first argument.
+ * @returns The wrapped function. Include this as an `export` to name it and make it accessible.
+ */
+export const internalAction = internalActionGeneric;
+/**
+ * Define an HTTP action.
+ *
+ * The wrapped function will be used to respond to HTTP requests received
+ * by a Convex deployment if the requests matches the path and method where
+ * this action is routed. Be sure to route your httpAction in `convex/http.js`.
+ *
+ * @param func - The function. It receives an {@link ActionCtx} as its first argument
+ * and a Fetch API `Request` object as its second.
+ * @returns The wrapped function. Import this function from `convex/http.js` and route it to hook it up.
+ */
+export const httpAction = httpActionGeneric;
+export const env = globalThis
+    .process.env;
+//# sourceMappingURL=server.js.map

package/dist/component/_generated/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/component/_generated/server.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB;;;;;;;GAOG;AAaH,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAgBvB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAsC,YAAY,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GACxB,oBAAoB,CAAC;AAEvB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAyC,eAAe,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAC3B,uBAAuB,CAAC;AAE1B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,MAAM,GAAuC,aAAa,CAAC;AAExE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GACzB,qBAAqB,CAAC;AAExB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAsB,iBAAiB,CAAC;AAC/D,MAAM,CAAC,MAAM,GAAG,GAAS,UAAmD;KACzE,OAAO,CAAC,GAAG,CAAC"}

package/dist/component/boxd.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Connects component actions to boxd.
+ *
+ * The component runs in Convex's default JavaScript runtime, so it uses the
+ * SDK's `@boxd-sh/sdk/web` entry: grpc-web over `fetch`, no Node built-ins.
+ *
+ * The API key comes from the component's own env (`BOXD_API_KEY`, bound by
+ * the app in `app.use`), so it never travels as a function argument. The SDK
+ * could exchange the key for a session token itself, but it would do so once
+ * per action: an SDK client lives only as long as the action. boxd
+ * rate-limits the exchange per source IP, and Convex deployments share their
+ * egress IPs. So the component exchanges the key once, caches the token in
+ * its `sessions` table, and hands the SDK the token.
+ */
+import { Boxd } from "@boxd-sh/sdk/web";
+import { type ActionCtx } from "./_generated/server.js";
+/** boxd production. `BOXD_BASE_URL` points the component anywhere else. */
+export declare const DEFAULT_BASE_URL = "https://boxd.sh:9443";
+/**
+ * The console origin that serves the key exchange: `https://app.<zone>` for a
+ * cluster zone, or the endpoint's own origin for a local, IP or `app.` host.
+ * Mirrors `consoleBaseUrl` in `@boxd-sh/sdk`, which the SDK doesn't export.
+ */
+export declare function exchangeUrl(baseURL: string): string;
+/**
+ * Run `operation` with an authenticated SDK client, and turn whatever it
+ * throws into a coded `ConvexError`.
+ *
+ * A cached token can be revoked before it expires. If boxd rejects a cached
+ * token, the token is dropped, the key is exchanged again, and `operation`
+ * runs once more. That retry is safe for every operation, including create:
+ * boxd refuses an unauthenticated request before it does anything.
+ */
+export declare function withBoxd<T>(ctx: ActionCtx, operation: (boxd: Boxd) => Promise<T>): Promise<T>;
+//# sourceMappingURL=boxd.d.ts.map

package/dist/component/boxd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boxd.d.ts","sourceRoot":"","sources":["../../src/component/boxd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,OAAO,EAAO,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAG7D,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AASvD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgBnD;AAsGD;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,GAAG,EAAE,SAAS,EACd,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GACpC,OAAO,CAAC,CAAC,CAAC,CAsBZ"}

package/dist/component/boxd.js

@@ -0,0 +1,144 @@
+/**
+ * Connects component actions to boxd.
+ *
+ * The component runs in Convex's default JavaScript runtime, so it uses the
+ * SDK's `@boxd-sh/sdk/web` entry: grpc-web over `fetch`, no Node built-ins.
+ *
+ * The API key comes from the component's own env (`BOXD_API_KEY`, bound by
+ * the app in `app.use`), so it never travels as a function argument. The SDK
+ * could exchange the key for a session token itself, but it would do so once
+ * per action: an SDK client lives only as long as the action. boxd
+ * rate-limits the exchange per source IP, and Convex deployments share their
+ * egress IPs. So the component exchanges the key once, caches the token in
+ * its `sessions` table, and hands the SDK the token.
+ */
+import { Boxd } from "@boxd-sh/sdk/web";
+import { internal } from "./_generated/api.js";
+import { env } from "./_generated/server.js";
+import { boxdError, toConvexError } from "./errors.js";
+/** boxd production. `BOXD_BASE_URL` points the component anywhere else. */
+export const DEFAULT_BASE_URL = "https://boxd.sh:9443";
+const EXCHANGE_PATH = "/api/v1/auth/token";
+/** Exchange again this long before the cached token expires. */
+const REFRESH_SKEW_MS = 5 * 60_000;
+/**
+ * The console origin that serves the key exchange: `https://app.<zone>` for a
+ * cluster zone, or the endpoint's own origin for a local, IP or `app.` host.
+ * Mirrors `consoleBaseUrl` in `@boxd-sh/sdk`, which the SDK doesn't export.
+ */
+export function exchangeUrl(baseURL) {
+    const trimmed = baseURL.trim().replace(/\/+$/, "");
+    const scheme = /^https?:\/\//.exec(trimmed)?.[0];
+    const local = /^(localhost|127\.)/.test(trimmed.slice(scheme?.length ?? 0));
+    // No scheme: pick the one the SDK would dial, plain HTTP for a local host.
+    const url = new URL(scheme ? trimmed : `${local ? "http" : "https"}://${trimmed}`);
+    const host = url.hostname;
+    const sameOrigin = host === "localhost" ||
+        host.startsWith("[") ||
+        /^\d{1,3}(\.\d{1,3}){3}$/.test(host) ||
+        host.startsWith("app.");
+    const origin = sameOrigin ? url.origin : `https://app.${host}`;
+    return `${origin}${EXCHANGE_PATH}`;
+}
+async function sha256Hex(text) {
+    const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(text));
+    return Array.from(new Uint8Array(digest), (b) => b.toString(16).padStart(2, "0")).join("");
+}
+async function exchange(apiKey, baseURL) {
+    const url = exchangeUrl(baseURL);
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({ api_key: apiKey }),
+        });
+    }
+    catch (error) {
+        throw boxdError("UNAVAILABLE", `could not reach ${url} to exchange BOXD_API_KEY: ${String(error)}`);
+    }
+    if (response.status === 401) {
+        throw boxdError("UNAUTHENTICATED", "boxd rejected BOXD_API_KEY: it is invalid, expired or revoked. " +
+            "Create a new key with `boxd auth keys create <name>` and set it with " +
+            "`npx convex env set BOXD_API_KEY <key>`.");
+    }
+    if (response.status === 429) {
+        throw boxdError("RATE_LIMITED", "boxd rate-limited the API key exchange. Retry after a minute.");
+    }
+    if (!response.ok) {
+        const detail = await response.text().catch(() => "");
+        throw boxdError(response.status >= 500 ? "UNAVAILABLE" : "BOXD_ERROR", `boxd API key exchange failed with ${response.status}: ${detail.slice(0, 500)}`);
+    }
+    const body = (await response.json());
+    if (typeof body.token !== "string" || typeof body.expires_at !== "number") {
+        throw boxdError("BOXD_ERROR", "boxd API key exchange returned a malformed response");
+    }
+    return { token: body.token, expiresAt: body.expires_at * 1000 };
+}
+function config() {
+    // Read inside the handler: component env only exists at runtime.
+    const apiKey = env.BOXD_API_KEY?.trim();
+    if (!apiKey) {
+        throw boxdError("UNAUTHENTICATED", "BOXD_API_KEY is empty. Set it with `npx convex env set BOXD_API_KEY <key>` " +
+            "and bind it in convex.config.ts: " +
+            "`app.use(boxd, { env: { BOXD_API_KEY: app.env.BOXD_API_KEY } })`.");
+    }
+    const baseURL = env.BOXD_BASE_URL?.trim() || DEFAULT_BASE_URL;
+    return { apiKey, baseURL };
+}
+async function session(ctx, keyHash, apiKey, baseURL) {
+    const cached = await ctx.runQuery(internal.sessions.get, { keyHash });
+    if (cached && cached.expiresAt - REFRESH_SKEW_MS > Date.now()) {
+        return { session: cached, cached: true };
+    }
+    let fresh;
+    try {
+        fresh = await exchange(apiKey, baseURL);
+    }
+    catch (error) {
+        // Many actions can reach the refresh margin at once, and boxd
+        // rate-limits the exchange. A token that has not expired yet still
+        // works, so fall back to it rather than fail the call.
+        if (cached && cached.expiresAt > Date.now()) {
+            return { session: cached, cached: true };
+        }
+        throw error;
+    }
+    await ctx.runMutation(internal.sessions.put, { keyHash, ...fresh });
+    return { session: fresh, cached: false };
+}
+/**
+ * Run `operation` with an authenticated SDK client, and turn whatever it
+ * throws into a coded `ConvexError`.
+ *
+ * A cached token can be revoked before it expires. If boxd rejects a cached
+ * token, the token is dropped, the key is exchanged again, and `operation`
+ * runs once more. That retry is safe for every operation, including create:
+ * boxd refuses an unauthenticated request before it does anything.
+ */
+export async function withBoxd(ctx, operation) {
+    const { apiKey, baseURL } = config();
+    const keyHash = await sha256Hex(`${baseURL}\n${apiKey}`);
+    const first = await session(ctx, keyHash, apiKey, baseURL);
+    try {
+        return await operation(new Boxd({ token: first.session.token, baseURL }));
+    }
+    catch (error) {
+        const converted = toConvexError(error);
+        if (!first.cached || converted.data.code !== "UNAUTHENTICATED") {
+            throw converted;
+        }
+        await ctx.runMutation(internal.sessions.drop, {
+            keyHash,
+            token: first.session.token,
+        });
+    }
+    const retry = await session(ctx, keyHash, apiKey, baseURL);
+    try {
+        return await operation(new Boxd({ token: retry.session.token, baseURL }));
+    }
+    catch (error) {
+        throw toConvexError(error);
+    }
+}
+//# sourceMappingURL=boxd.js.map

package/dist/component/boxd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boxd.js","sourceRoot":"","sources":["../../src/component/boxd.ts"],"names":[],"mappings":"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"}

package/dist/component/convex.config.d.ts

@@ -0,0 +1,6 @@
+declare const _default: import("convex/server").ComponentDefinition<any, {
+    readonly BOXD_API_KEY: import("convex/values").VString<string, "required">;
+    readonly BOXD_BASE_URL: import("convex/values").VString<string | undefined, "optional">;
+}>;
+export default _default;
+//# sourceMappingURL=convex.config.d.ts.map

package/dist/component/convex.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convex.config.d.ts","sourceRoot":"","sources":["../../src/component/convex.config.ts"],"names":[],"mappings":";;;;AAGA,wBAKG"}

package/dist/component/convex.config.js

@@ -0,0 +1,9 @@
+import { defineComponent } from "convex/server";
+import { v } from "convex/values";
+export default defineComponent("boxd", {
+    env: {
+        BOXD_API_KEY: v.string(),
+        BOXD_BASE_URL: v.optional(v.string()),
+    },
+});
+//# sourceMappingURL=convex.config.js.map

package/dist/component/convex.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convex.config.js","sourceRoot":"","sources":["../../src/component/convex.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,eAAe,eAAe,CAAC,MAAM,EAAE;IACrC,GAAG,EAAE;QACH,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;QACxB,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACtC;CACF,CAAC,CAAC"}

package/dist/component/errors.d.ts

@@ -0,0 +1,25 @@
+import { ConvexError, type Infer } from "convex/values";
+export declare const errorCode: import("convex/values").VUnion<"INVALID_ARGUMENT" | "UNAUTHENTICATED" | "PERMISSION_DENIED" | "NOT_FOUND" | "CONFLICT" | "RATE_LIMITED" | "TIMEOUT" | "UNAVAILABLE" | "BOXD_ERROR", [import("convex/values").VLiteral<"INVALID_ARGUMENT", "required">, import("convex/values").VLiteral<"UNAUTHENTICATED", "required">, import("convex/values").VLiteral<"PERMISSION_DENIED", "required">, import("convex/values").VLiteral<"NOT_FOUND", "required">, import("convex/values").VLiteral<"CONFLICT", "required">, import("convex/values").VLiteral<"RATE_LIMITED", "required">, import("convex/values").VLiteral<"TIMEOUT", "required">, import("convex/values").VLiteral<"UNAVAILABLE", "required">, import("convex/values").VLiteral<"BOXD_ERROR", "required">], "required", never>;
+/** The `data` of every `ConvexError` this component throws. */
+export type BoxdErrorData = {
+    code: Infer<typeof errorCode>;
+    message: string;
+    /**
+     * Set when `create` or `fork` made a machine but it failed to become ready:
+     * the machine exists, and bills, until you destroy it.
+     */
+    machineId?: string;
+};
+export declare function boxdError(code: BoxdErrorData["code"], message: string): ConvexError<BoxdErrorData>;
+export declare function invalidArgument(message: string): ConvexError<BoxdErrorData>;
+/** A human-readable message for any thrown value, bounded for storage. */
+export declare function errorMessage(error: unknown): string;
+/**
+ * Map anything thrown while talking to boxd onto a `ConvexError` with a
+ * stable `code`, so the app can branch on `error.data.code` instead of
+ * parsing messages. A `ConvexError` passes through unchanged.
+ */
+export declare function toConvexError(error: unknown): ConvexError<BoxdErrorData>;
+/** True when `error` says the target no longer exists on boxd. */
+export declare function isNotFound(error: unknown): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/component/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/component/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAK,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAG3D,eAAO,MAAM,SAAS,qvBAUrB,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAgCF,wBAAgB,SAAS,CACvB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAC3B,OAAO,EAAE,MAAM,GACd,WAAW,CAAC,aAAa,CAAC,CAE5B;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC,aAAa,CAAC,CAE3E;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYnD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,aAAa,CAAC,CAYxE;AAED,kEAAkE;AAClE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAElD"}

package/dist/component/errors.js

@@ -0,0 +1,75 @@
+import { ConvexError, v } from "convex/values";
+import { MAX_STORED_ERROR, truncate } from "./limits.js";
+export const errorCode = v.union(v.literal("INVALID_ARGUMENT"), v.literal("UNAUTHENTICATED"), v.literal("PERMISSION_DENIED"), v.literal("NOT_FOUND"), v.literal("CONFLICT"), v.literal("RATE_LIMITED"), v.literal("TIMEOUT"), v.literal("UNAVAILABLE"), v.literal("BOXD_ERROR"));
+// gRPC status codes, as carried on `BoxdError.grpcCode`.
+const GRPC_CODES = {
+    3: "INVALID_ARGUMENT",
+    4: "TIMEOUT",
+    5: "NOT_FOUND",
+    6: "CONFLICT",
+    7: "PERMISSION_DENIED",
+    8: "RATE_LIMITED",
+    9: "CONFLICT",
+    14: "UNAVAILABLE",
+    16: "UNAUTHENTICATED",
+};
+// The SDK's own error classes, for errors raised before anything reached the
+// wire (a missing credential, a failed key exchange, a dropped connection).
+// Matched by name and `grpcCode` rather than `instanceof`, so the modules
+// that only store and read rows never load the SDK.
+const SDK_CLASSES = {
+    AuthenticationError: "UNAUTHENTICATED",
+    PermissionDeniedError: "PERMISSION_DENIED",
+    NotFoundError: "NOT_FOUND",
+    ConflictError: "CONFLICT",
+    RateLimitError: "RATE_LIMITED",
+    APIConnectionError: "UNAVAILABLE",
+};
+// The SDK's client-side deadlines: "exec timed out after 5000ms", and
+// "machine x did not reach 'running' within 90000ms".
+const TIMEOUT_MESSAGE = /timed out|within \d+ms/i;
+export function boxdError(code, message) {
+    return new ConvexError({ code, message });
+}
+export function invalidArgument(message) {
+    return boxdError("INVALID_ARGUMENT", message);
+}
+/** A human-readable message for any thrown value, bounded for storage. */
+export function errorMessage(error) {
+    let message;
+    if (error instanceof ConvexError) {
+        const data = error.data;
+        message =
+            typeof data === "string" ? data : (data.message ?? String(error.data));
+    }
+    else if (error instanceof Error) {
+        message = error.message;
+    }
+    else {
+        message = String(error);
+    }
+    return truncate(message, MAX_STORED_ERROR);
+}
+/**
+ * Map anything thrown while talking to boxd onto a `ConvexError` with a
+ * stable `code`, so the app can branch on `error.data.code` instead of
+ * parsing messages. A `ConvexError` passes through unchanged.
+ */
+export function toConvexError(error) {
+    if (error instanceof ConvexError)
+        return error;
+    const message = errorMessage(error);
+    if (error instanceof Error) {
+        const { grpcCode } = error;
+        const code = (typeof grpcCode === "number" ? GRPC_CODES[grpcCode] : undefined) ??
+            SDK_CLASSES[error.name] ??
+            (TIMEOUT_MESSAGE.test(message) ? "TIMEOUT" : "BOXD_ERROR");
+        return boxdError(code, message);
+    }
+    return boxdError("BOXD_ERROR", message);
+}
+/** True when `error` says the target no longer exists on boxd. */
+export function isNotFound(error) {
+    return toConvexError(error).data.code === "NOT_FOUND";
+}
+//# sourceMappingURL=errors.js.map

package/dist/component/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/component/errors.ts"],"names":[],"mappings":"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"}

package/dist/component/exec.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Run a command in a machine. Each run is recorded in `executions`
+ * (running → completed or failed), so the app can render live status and
+ * history from a reactive query.
+ *
+ * The call returns when the command exits. For work that can outlast the 10
+ * minute action ceiling, start it in the background inside the machine
+ * (`nohup ... &`) and poll it with later runs.
+ */
+import type { Id } from "./_generated/dataModel.js";
+export declare const run: import("convex/server").RegisteredAction<"public", {
+    cwd?: string | undefined;
+    env?: Record<string, string> | undefined;
+    ownerId?: string | undefined;
+    timeoutMs?: number | undefined;
+    command: string | string[];
+    machineId: string;
+}, Promise<{
+    executionId: Id<"executions">;
+    exitCode: number;
+    success: boolean;
+    stdout: string;
+    stderr: string;
+}>>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/component/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/component/exec.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,2BAA2B,CAAC;AA+BpD,eAAO,MAAM,GAAG;;;;;;;;iBAwBC,EAAE,CAAC,YAAY,CAAC;cACnB,MAAM;aACP,OAAO;YACR,MAAM;YACN,MAAM;GA8DhB,CAAC"}