@alchemy.run/modal 0.0.0 → 2.0.0-beta.87

package/lib/internal/TcpConnect.js.map

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

package/lib/internal/Transport.d.ts

@@ -0,0 +1,13 @@
+import type * as HttpClient from "effect/http/HttpClient";
+import * as Layer from "effect/Layer";
+/** Whether this code runs on workerd (a Cloudflare Worker or Durable Object). */
+export declare const isWorkerd: () => boolean;
+/**
+ * How Modal calls leave this runtime: `fetch`, and on a Cloudflare Worker,
+ * distilled's `cloudflare:sockets` gRPC transport. `api.modal.com` is behind
+ * Cloudflare, and a Worker's `fetch` to it takes Cloudflare's internal
+ * Worker-to-site path, which resets Modal's gRPC upstream (`grpc-status: 14`).
+ * Other HTTP calls (blob uploads, the user's own endpoints) keep `fetch`.
+ */
+export declare const ModalTransport: Layer.Layer<HttpClient.HttpClient>;
+//# sourceMappingURL=Transport.d.ts.map

package/lib/internal/Transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transport.d.ts","sources":["../../src/internal/Transport.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,UAAU,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,iFAAiF;AACjF,eAAO,MAAM,SAAS,QAAO,OACqD,CAAC;AAEnF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAM7D,CAAC"}

package/lib/internal/Transport.js

@@ -0,0 +1,16 @@
+import { GrpcTransport } from "@distilled.cloud/core/grpc-transport";
+import * as CloudflareSockets from "@distilled.cloud/core/grpc-transport-cloudflare-sockets";
+import * as Effect from "effect/Effect";
+import * as FetchHttpClient from "effect/http/FetchHttpClient";
+import * as Layer from "effect/Layer";
+/** Whether this code runs on workerd (a Cloudflare Worker or Durable Object). */
+export const isWorkerd = () => typeof navigator !== "undefined" && navigator.userAgent === "Cloudflare-Workers";
+/**
+ * How Modal calls leave this runtime: `fetch`, and on a Cloudflare Worker,
+ * distilled's `cloudflare:sockets` gRPC transport. `api.modal.com` is behind
+ * Cloudflare, and a Worker's `fetch` to it takes Cloudflare's internal
+ * Worker-to-site path, which resets Modal's gRPC upstream (`grpc-status: 14`).
+ * Other HTTP calls (blob uploads, the user's own endpoints) keep `fetch`.
+ */
+export const ModalTransport = Layer.mergeAll(FetchHttpClient.layer, Layer.effect(GrpcTransport, Effect.sync(() => (isWorkerd() ? CloudflareSockets.client : undefined))));
+//# sourceMappingURL=Transport.js.map

package/lib/internal/Transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transport.js","sources":["../../src/internal/Transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,KAAK,iBAAiB,MAAM,yDAAyD,CAAC;AAC7F,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,eAAe,MAAM,6BAA6B,CAAC;AAE/D,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,iFAAiF;AACjF,MAAM,CAAC,MAAM,SAAS,GAAG,GAAY,EAAE,CACrC,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,SAAS,KAAK,oBAAoB,CAAC;AAEnF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAuC,KAAK,CAAC,QAAQ,CAC9E,eAAe,CAAC,KAAK,EACrB,KAAK,CAAC,MAAM,CACV,aAAa,EACb,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CACxE,CACF,CAAC"}

package/lib/internal.d.ts

@@ -0,0 +1,71 @@
+import type { Credentials } from "@distilled.cloud/modal/Credentials";
+import * as environment from "@distilled.cloud/modal/environment";
+import type { ListPagination } from "@distilled.cloud/modal/volume";
+import * as Effect from "effect/Effect";
+import type * as HttpClient from "effect/http/HttpClient";
+/**
+ * Modal object names: letters, digits, `-`, `.` and `_`, shorter than 64
+ * characters. Names are unique per environment and kind.
+ */
+export declare const objectName: (id: string, name: string | undefined, maxLength?: number) => Effect.Effect<string, never, import("alchemy/ResourceContext").ResourceContext | import("alchemy/Stack").Stack | import("alchemy/Stage").Stage>;
+/**
+ * The environment a Modal call targets. Modal resolves an empty name to the
+ * workspace's default environment, so `undefined` stays `""` on the wire and
+ * `undefined` in attributes.
+ */
+export declare const environmentOf: (name: string | undefined) => string;
+/** Seconds of a duration given as seconds or a `"10 minutes"`-style string. */
+export declare const seconds: (value: number | string | undefined) => number | undefined;
+/**
+ * Every item of a Modal `List*` call. Modal pages by creation time: each
+ * request takes `maxObjects` and `createdBefore`, the creation time of the
+ * oldest item seen so far.
+ */
+export declare const listAll: <T, E, R>(fetch: (pagination: ListPagination) => Effect.Effect<ReadonlyArray<T>, E, R>, createdAt: (item: T) => number | undefined, pageSize?: number) => Effect.Effect<T[], E, R>;
+/**
+ * The names of every environment in the workspace, for `list` operations that
+ * enumerate objects across environments.
+ */
+export declare const environmentNames: Effect.Effect<string[], environment.ModalOpError, environment.ModalOpContext>;
+/** A wire `map<string, string>` without the absent entries proto3 JSON allows. */
+export declare const stringMap: (map: Readonly<Record<string, string | undefined>> | undefined) => Record<string, string>;
+/**
+ * Whether a name was generated by `createPhysicalName` (it ends in a
+ * 16-character base32 instance suffix, or an 8-character truncation hash plus
+ * the suffix). Modal objects other than Apps and Sandboxes have no tags, so
+ * `list` (and `alchemy nuke`) only enumerate objects with generated names
+ * and the objects runtimes created (`isRuntimeName`); objects given an
+ * explicit `name` are never swept.
+ */
+export declare const isGeneratedName: (name: string | undefined) => boolean;
+/**
+ * An environment by name, or a `Modal.Environment` (yielded: `yield* Agents`)
+ * whose name is used.
+ */
+export type EnvironmentInput = string | {
+    readonly name: string;
+};
+/** The environment name an {@link EnvironmentInput} resolved to. */
+export declare const envNameOf: (value: unknown) => string | undefined;
+/** A protobuf `Timestamp` (RFC 3339) for a `Date`, ISO string or epoch milliseconds. */
+export declare const timestampOf: (value: Date | string | number) => string;
+/**
+ * Resolve a record of distilled operations into their call functions, like
+ * `Effect.all` over Effects. An operation is yieldable (`yield* op` captures
+ * the current context and returns a requirement-free call) but isn't an
+ * Effect value at runtime, so `Effect.all({ put: queue.putQueue })` fails.
+ *
+ * @example
+ * ```ts
+ * const QueueOps = operations({ put: queue.putQueue, get: queue.getQueue });
+ * const { put } = yield* ModalBindings.withCredentials(QueueOps);
+ * ```
+ */
+export declare const operations: <const Ops extends Record<string, Effect.Effect<unknown, never, OperationServices>>>(ops: Ops) => Effect.Effect<{ readonly [K in keyof Ops]: Effect.Success<Ops[K]>; }, never, OperationServices>;
+/** The error of a resolved distilled call (or any function returning an Effect). */
+export type ErrorOf<F> = F extends (...args: any[]) => Effect.Effect<any, infer E, any> ? E : never;
+/** The error of operation `K` of a resolved operations record. */
+export type OpError<Ops, K extends keyof Ops> = ErrorOf<Ops[K]>;
+/** What a distilled Modal operation needs to run: credentials and an HTTP client. */
+export type OperationServices = Credentials | HttpClient.HttpClient;
+//# sourceMappingURL=internal.d.ts.map

package/lib/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,WAAW,MAAM,oCAAoC,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,UAAU,MAAM,wBAAwB,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,UAAU,OAAQ,MAAM,QAAQ,MAAM,GAAG,SAAS,wKACoC,CAAC;AAEpG;;;;GAIG;AACH,eAAO,MAAM,aAAa,SAAU,MAAM,GAAG,SAAS,KAAG,MAAoB,CAAC;AAE9E,+EAA+E;AAC/E,eAAO,MAAM,OAAO,UAAW,MAAM,GAAG,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,SAcrE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC5B,KAAK,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC5E,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,EAC1C,QAAQ,CAAC,EAAE,MAAM,KACd,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAgB1B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,+EAG3B,CAAC;AAEH,kFAAkF;AAClF,eAAO,MAAM,SAAS,QACf,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,KAC5D,MAAM,CAAC,MAAM,EAAE,MAAM,CAKrB,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,SAAU,MAAM,GAAG,SAAS,KAAG,OACR,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAElE,oEAAoE;AACpE,eAAO,MAAM,SAAS,UAAW,OAAO,KAAG,MAAM,GAAG,SAQnC,CAAC;AAElB,wFAAwF;AACxF,eAAO,MAAM,WAAW,UAAW,IAAI,GAAG,MAAM,GAAG,MAAM,KAAG,MACO,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,GACrB,KAAK,CAAC,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,OAE7E,GAAG,KACP,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAE,EAAE,KAAK,EAAE,iBAAiB,CAK5F,CAAC;AAEL,oFAAoF;AACpF,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEpG,kEAAkE;AAClE,MAAM,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,SAAS,MAAM,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhE,qFAAqF;AACrF,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC"}

package/lib/internal.js

@@ -0,0 +1,102 @@
+import * as environment from "@distilled.cloud/modal/environment";
+import { createPhysicalName } from "alchemy/PhysicalName";
+import * as Effect from "effect/Effect";
+/**
+ * Modal object names: letters, digits, `-`, `.` and `_`, shorter than 64
+ * characters. Names are unique per environment and kind.
+ */
+export const objectName = (id, name, maxLength = 63) => name !== undefined ? Effect.succeed(name) : createPhysicalName({ id, maxLength, delimiter: "-" });
+/**
+ * The environment a Modal call targets. Modal resolves an empty name to the
+ * workspace's default environment, so `undefined` stays `""` on the wire and
+ * `undefined` in attributes.
+ */
+export const environmentOf = (name) => name ?? "";
+/** Seconds of a duration given as seconds or a `"10 minutes"`-style string. */
+export const seconds = (value) => {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === "number")
+        return value;
+    const match = /^\s*(\d+(?:\.\d+)?)\s*(ms|millis|milliseconds?|s|secs?|seconds?|m|mins?|minutes?|h|hours?)\s*$/i.exec(value);
+    if (!match)
+        return Number(value);
+    const n = Number(match[1]);
+    const unit = match[2].toLowerCase();
+    if (unit.startsWith("ms") || unit.startsWith("milli"))
+        return n / 1000;
+    if (unit.startsWith("h"))
+        return n * 3600;
+    if (unit.startsWith("m"))
+        return n * 60;
+    return n;
+};
+/**
+ * Every item of a Modal `List*` call. Modal pages by creation time: each
+ * request takes `maxObjects` and `createdBefore`, the creation time of the
+ * oldest item seen so far.
+ */
+export const listAll = Effect.fn(function* (fetch, createdAt, pageSize = 100) {
+    const all = [];
+    let before;
+    for (let page = 0; page < 1_000; page++) {
+        const items = yield* fetch({ maxObjects: pageSize, createdBefore: before });
+        all.push(...items);
+        if (items.length < pageSize)
+            break;
+        const oldest = Math.min(...items.map((item) => createdAt(item) ?? Number.POSITIVE_INFINITY));
+        if (!Number.isFinite(oldest) || oldest === before)
+            break;
+        before = oldest;
+    }
+    return all;
+});
+/**
+ * The names of every environment in the workspace, for `list` operations that
+ * enumerate objects across environments.
+ */
+export const environmentNames = Effect.gen(function* () {
+    const response = yield* environment.listEnvironment({});
+    return (response.items ?? []).flatMap((item) => (item.name ? [item.name] : []));
+});
+/** A wire `map<string, string>` without the absent entries proto3 JSON allows. */
+export const stringMap = (map) => Object.fromEntries(Object.entries(map ?? {}).flatMap(([key, value]) => value === undefined ? [] : [[key, value]]));
+/**
+ * Whether a name was generated by `createPhysicalName` (it ends in a
+ * 16-character base32 instance suffix, or an 8-character truncation hash plus
+ * the suffix). Modal objects other than Apps and Sandboxes have no tags, so
+ * `list` (and `alchemy nuke`) only enumerate objects with generated names
+ * and the objects runtimes created (`isRuntimeName`); objects given an
+ * explicit `name` are never swept.
+ */
+export const isGeneratedName = (name) => name !== undefined && /-[a-z2-7]{16}$/.test(name);
+/** The environment name an {@link EnvironmentInput} resolved to. */
+export const envNameOf = (value) => typeof value === "string"
+    ? value || undefined
+    : typeof value === "object" &&
+        value !== null &&
+        "name" in value &&
+        typeof value.name === "string"
+        ? value.name
+        : undefined;
+/** A protobuf `Timestamp` (RFC 3339) for a `Date`, ISO string or epoch milliseconds. */
+export const timestampOf = (value) => typeof value === "string" ? value : new Date(value).toISOString();
+/**
+ * Resolve a record of distilled operations into their call functions, like
+ * `Effect.all` over Effects. An operation is yieldable (`yield* op` captures
+ * the current context and returns a requirement-free call) but isn't an
+ * Effect value at runtime, so `Effect.all({ put: queue.putQueue })` fails.
+ *
+ * @example
+ * ```ts
+ * const QueueOps = operations({ put: queue.putQueue, get: queue.getQueue });
+ * const { put } = yield* ModalBindings.withCredentials(QueueOps);
+ * ```
+ */
+export const operations = (ops) => Effect.gen(function* () {
+    const resolved = {};
+    for (const [key, op] of Object.entries(ops))
+        resolved[key] = yield* op;
+    return resolved;
+});
+//# sourceMappingURL=internal.js.map

package/lib/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sources":["../src/internal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,oCAAoC,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,EAAU,EAAE,IAAwB,EAAE,SAAS,GAAG,EAAE,EAAE,EAAE,CACjF,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;AAEpG;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAwB,EAAU,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;AAE9E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAkC,EAAsB,EAAE;IAChF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,KAAK,GACT,iGAAiG,CAAC,IAAI,CACpG,KAAK,CACN,CAAC;IACJ,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC;IACrC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IACxC,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAIY,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EACjD,KAA4E,EAC5E,SAA0C,EAC1C,QAAQ,GAAG,GAAG;IAEd,MAAM,GAAG,GAAQ,EAAE,CAAC;IACpB,IAAI,MAA0B,CAAC;IAC/B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QACnB,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ;YAAE,MAAM;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAC7F,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,KAAK,MAAM;YAAE,MAAM;QACzD,MAAM,GAAG,MAAM,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC,CAAC;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,GAA6D,EACrC,EAAE,CAC1B,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACjD,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAC1C,CACF,CAAC;AAEJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAwB,EAAW,EAAE,CACnE,IAAI,KAAK,SAAS,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAQpD,oEAAoE;AACpE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAsB,EAAE,CAC9D,OAAO,KAAK,KAAK,QAAQ;IACvB,CAAC,CAAC,KAAK,IAAI,SAAS;IACpB,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;QACvB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAChC,CAAC,CAAC,KAAK,CAAC,IAAI;QACZ,CAAC,CAAC,SAAS,CAAC;AAElB,wFAAwF;AACxF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAA6B,EAAU,EAAE,CACnE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAGxB,GAAQ,EACwF,EAAE,CAClG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;IACvE,OAAO,QAAiE,CAAC;AAC3E,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alchemy.run/modal",
-  "version": "0.0.0",
+  "version": "2.0.0-beta.87",
   "description": "Modal sandboxes, images, volumes, dicts, queues and secrets for Alchemy.",
   "keywords": [
     "agents",
@@ -11,12 +11,68 @@
     "modal",
     "sandbox"
   ],
+  "homepage": "https://alchemy.run",
+  "bugs": {
+    "url": "https://github.com/alchemy-run/alchemy/issues"
+  },
   "license": "Apache-2.0",
   "author": "Sam Goodwin <sam@alchemy.run>",
-  "homepage": "https://alchemy.run",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/alchemy-run/alchemy.git",
     "directory": "packages/modal"
+  },
+  "files": [
+    "lib",
+    "src"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "bun": "./src/index.ts",
+      "worker": "./src/index.ts",
+      "default": "./lib/index.js"
+    },
+    "./internal/*": null,
+    "./internal": null,
+    "./*": {
+      "types": "./lib/*.d.ts",
+      "bun": "./src/*.ts",
+      "worker": "./src/*.ts",
+      "default": "./lib/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@alchemy.run/docker": "2.0.0-beta.87",
+    "@distilled.cloud/core": "1.0.0-rc.20",
+    "@distilled.cloud/modal": "1.0.0-rc.20",
+    "rolldown": "1.2.16"
+  },
+  "devDependencies": {
+    "@effect/platform-node": "^4.1.4",
+    "@types/bun": "1.4.3",
+    "alchemy": "2.0.0-beta.87",
+    "effect": "^4.1.4",
+    "typescript": "^7.1.0-dev.20261105.1"
+  },
+  "peerDependencies": {
+    "@effect/platform-node": "^4.1.4",
+    "alchemy": "2.0.0-beta.87",
+    "effect": "^4.1.4"
+  },
+  "alchemy": {
+    "contributes": [
+      "@alchemy.run/modal/Contributions"
+    ]
+  },
+  "scripts": {
+    "build": "pnpm -r --filter \"{.}...\" run build:package",
+    "build:package": "node scripts/build.ts"
   }
-}
+}

package/src/App.ts

@@ -0,0 +1,262 @@
+import * as app from "@distilled.cloud/modal/app";
+import { Unowned } from "alchemy/AdoptPolicy";
+import { deepEqual, isResolved } from "alchemy/Diff";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Schedule from "effect/Schedule";
+import {
+  type EnvironmentInput,
+  envNameOf,
+  environmentNames,
+  environmentOf,
+  objectName,
+  stringMap,
+} from "./internal.ts";
+import { declarable } from "./internal/Declared.ts";
+import { createModalInternalTags, hasModalAlchemyTags, isAlchemyTagged } from "./internal/Tags.ts";
+import type { Providers } from "./Providers.ts";
+
+export class AppUnexpectedResponse extends Data.TaggedError("Modal.AppUnexpectedResponse")<{
+  readonly message: string;
+}> {}
+
+export interface AppProps {
+  /**
+   * App name, unique per environment. If omitted, a unique name is generated
+   * from the stack, stage and logical ID. Changing it replaces the app.
+   */
+  name?: string;
+  /**
+   * Environment the app lives in. Changing it replaces the app.
+   * @default the workspace's default environment
+   */
+  environment?: EnvironmentInput;
+  /**
+   * Key-value metadata on the app, shown in the Modal dashboard and usable
+   * for filtering. Alchemy adds its own `alchemy.*` ownership tags. Keys and values may
+   * contain only letters, digits, `.`, `_` and `-`, up to 63 characters.
+   */
+  tags?: Record<string, string>;
+}
+
+export interface AppAttributes {
+  /** App ID (`ap-…`). */
+  appId: string;
+  /** App name. */
+  name: string;
+  /** Environment name, or `undefined` for the workspace default. */
+  environment: string | undefined;
+  /** Tags on the app, including Alchemy's ownership tags. */
+  tags: Record<string, string>;
+}
+
+/**
+ * A Modal App: the named, persistent namespace that Functions, Servers,
+ * Sandboxes and Images run under. Each `Modal.Function` and `Modal.Server`
+ * of the Stack is published into its App, and stopping the App (destroying
+ * this resource) stops them and terminates its Sandboxes.
+ *
+ * An App deployed with Modal's Python client (`modal deploy`) can also be
+ * referenced by name from {@link InvokeFunction} and
+ * {@link FunctionAutoscaler}.
+ *
+ * ### Creating an App
+ * **Example:** An app for sandboxes
+ * ```typescript
+ * import * as Modal from "@alchemy.run/modal";
+ *
+ * export const Coder = Modal.App("Coder", {});
+ * ```
+ *
+ * **Example:** A named, tagged app in an environment
+ * ```typescript
+ * import * as Modal from "@alchemy.run/modal";
+import * as Schedule from "effect/Schedule";
+ *
+ * export const Agents = Modal.Environment("Agents", {});
+ * export const Coder = Modal.App("Coder", {
+ *   name: "coder",
+ *   environment: Agents,
+ *   tags: { team: "platform" },
+ * });
+ * ```
+ *
+ * ### Running sandboxes in it
+ * **Example:** Create sandboxes from a Worker
+ * ```typescript
+ * import * as Cloudflare from "@alchemy.run/cloudflare";
+ * import * as Modal from "@alchemy.run/modal";
+ * import * as Effect from "effect/Effect";
+import * as Schedule from "effect/Schedule";
+ * import * as HttpServerResponse from "effect/http/HttpServerResponse";
+ * import { Coder } from "./Coder.ts";
+ *
+ * export default class Api extends Cloudflare.Worker<Api>()(
+ *   "Api",
+ *   { main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     const sandboxes = yield* Modal.CreateSandbox(Coder);
+ *     return {
+ *       fetch: Effect.gen(function* () {
+ *         const sandbox = yield* sandboxes.create({ image: "node:22-slim" });
+ *         const result = yield* sandbox.exec(["node", "--version"]);
+ *         yield* sandbox.terminate();
+ *         return HttpServerResponse.text(result.stdout);
+ *       }).pipe(Effect.orDie),
+ *     };
+ *   }).pipe(Effect.provide(Modal.CreateSandboxHttp)),
+ * ) {}
+ * ```
+ *
+ * ### Looking up an existing App
+ * `App.lookup` references a App Alchemy doesn't manage (created with
+ * the Modal CLI or by another stack). It is read during plan/deploy, never
+ * created, updated or deleted.
+ *
+ * **Example:** Reference an existing App
+ * ```typescript
+ * const app = Modal.App.lookup({ name: "inference" });
+ * ```
+ *
+ * @resource
+ * @product App
+ */
+export const App = declarable<App>()(Resource<App>("Modal.App"));
+
+export type App = Resource<"Modal.App", AppProps, AppAttributes, never, Providers, AppLookup>;
+
+/**
+ * Props for {@link App.lookup}: find a App this stack
+ * doesn't manage by its name.
+ */
+export interface AppLookup {
+  /** App name. */
+  name: string;
+  /**
+   * Modal environment the object lives in.
+   * @default the workspace's default environment
+   */
+  environment?: string;
+}
+
+const isStopped = (state: string | undefined) =>
+  state === "APP_STATE_STOPPED" || state === "APP_STATE_STOPPING";
+
+export const AppProvider = () =>
+  Provider.effect(
+    App,
+    Effect.gen(function* () {
+      const observe = Effect.fn(function* (name: string, env: string | undefined) {
+        // Without a creation type, get-or-create only looks the app up
+        // (Modal no longer serves `AppLookup`).
+        const found = yield* app
+          .appGetOrCreate({ appName: name, environmentName: environmentOf(env) })
+          .pipe(Effect.catchTag("AppNotFound", () => Effect.undefined));
+        if (!found?.appId) return undefined;
+        const { tags } = yield* app
+          .appGetTags({ appId: found.appId })
+          .pipe(Effect.catchTag("AppNotFound", () => Effect.succeed({ tags: undefined })));
+        return {
+          appId: found.appId,
+          name,
+          environment: env,
+          tags: stringMap(tags),
+        } satisfies AppAttributes;
+      });
+
+      return {
+        stables: ["appId", "name", "environment"],
+        diff: Effect.fn(function* ({ id, news, olds, output }) {
+          if (!isResolved(news)) return undefined;
+          if (envNameOf(news.environment) !== envNameOf(olds?.environment))
+            return { action: "replace" } as const;
+          const name = yield* objectName(id, news.name);
+          if (output !== undefined && name !== output.name) return { action: "replace" } as const;
+          return undefined;
+        }),
+        lookup: Effect.fn(function* ({ name, environment }) {
+          return yield* observe(name, environment);
+        }),
+
+        read: Effect.fn(function* ({ id, olds, output }) {
+          const name = output?.name ?? (yield* objectName(id, olds?.name));
+          const observed = yield* observe(
+            name,
+            output?.environment ?? envNameOf(olds?.environment),
+          );
+          if (!observed) return undefined;
+          const ours = yield* hasModalAlchemyTags(id, observed.tags);
+          return ours ? observed : Unowned(observed);
+        }),
+        reconcile: Effect.fn(function* ({ id, news, output, session }) {
+          const name = output?.name ?? (yield* objectName(id, news.name));
+          // Observe + ensure: get-or-create is idempotent under races.
+          let current = yield* observe(name, envNameOf(news.environment));
+          if (!current) {
+            yield* session.note(`Creating app ${name}...`);
+            // Modal rate-limits App creation per workspace; wait it out.
+            const created = yield* app
+              .appGetOrCreate({
+                appName: name,
+                environmentName: environmentOf(envNameOf(news.environment)),
+                objectCreationType: "OBJECT_CREATION_TYPE_CREATE_IF_MISSING",
+              })
+              .pipe(
+                Effect.retry({
+                  while: (e) => e._tag === "TooManyRequests",
+                  schedule: Schedule.spaced("5 seconds"),
+                  times: 12,
+                }),
+              );
+            if (!created.appId) {
+              return yield* new AppUnexpectedResponse({
+                message: `Modal returned no id for app ${name}`,
+              });
+            }
+            current = {
+              appId: created.appId,
+              name,
+              environment: envNameOf(news.environment),
+              tags: {},
+            };
+          }
+          // Sync tags against the observed tags. Modal stores the map it is
+          // given; it has no per-key delete.
+          const desired = { ...news.tags, ...(yield* createModalInternalTags(id)) };
+          if (!deepEqual(current.tags, desired)) {
+            yield* app.appSetTags({ appId: current.appId, tags: desired });
+            current = { ...current, tags: desired };
+          }
+          return current;
+        }),
+        delete: Effect.fn(function* ({ output }) {
+          yield* app
+            .stopApp({ appId: output.appId, source: "APP_STOP_SOURCE_CLI" })
+            .pipe(Effect.catchTag("AppNotFound", () => Effect.void));
+        }),
+        list: Effect.fn(function* () {
+          const envs = yield* environmentNames;
+          const all: AppAttributes[] = [];
+          for (const env of envs) {
+            const { apps } = yield* app.listApp({ environmentName: env });
+            for (const item of apps ?? []) {
+              if (!item.appId || isStopped(item.state)) continue;
+              const { tags } = yield* app
+                .appGetTags({ appId: item.appId })
+                .pipe(Effect.catchTag("AppNotFound", () => Effect.succeed({ tags: undefined })));
+              if (!isAlchemyTagged(tags)) continue;
+              all.push({
+                appId: item.appId,
+                name: item.name ?? item.description ?? "",
+                environment: env,
+                tags: stringMap(tags),
+              });
+            }
+          }
+          return all;
+        }),
+      };
+    }),
+  );