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

package/lib/Queue.d.ts

@@ -0,0 +1,147 @@
+import * as queue from "@distilled.cloud/modal/queue";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Effect from "effect/Effect";
+import { type EnvironmentInput } from "./internal.ts";
+import type { Providers } from "./Providers.ts";
+declare const QueueUnexpectedResponse_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Modal.QueueUnexpectedResponse";
+} & Readonly<A>;
+export declare class QueueUnexpectedResponse extends QueueUnexpectedResponse_base<{
+    readonly message: string;
+}> {
+}
+export interface QueueProps {
+    /**
+     * Queue name, unique per environment. If omitted, a unique name is
+     * generated from the stack, stage and logical ID. Changing it replaces the
+     * queue (Modal can't rename queues).
+     */
+    name?: string;
+    /**
+     * Environment the queue lives in. Changing it replaces the queue.
+     * @default the workspace's default environment
+     */
+    environment?: EnvironmentInput;
+}
+export interface QueueAttributes {
+    /** Queue ID (`qu-…`). */
+    queueId: string;
+    /** Queue name. */
+    name: string;
+    /** Environment name, or `undefined` for the workspace default. */
+    environment: string | undefined;
+}
+/**
+ * A Modal Queue: a distributed FIFO queue shared by every container, Sandbox
+ * and client in the workspace, with optional named partitions. Items expire
+ * 24 hours after they are put (partitions can set their own TTL).
+ *
+ * Bind it with {@link WriteQueue} to put items, {@link ReadQueue} to take
+ * them, or {@link ReadWriteQueue} for both, from a Worker, Lambda or any
+ * other runtime. Values travel as bytes: the bindings encode them as JSON by
+ * default.
+ *
+ * Modal queues have no tags. Ownership is inferred from Alchemy state: a
+ * queue found under an explicit `name` without prior state is reported as
+ * unowned.
+ *
+ * ### Creating a Queue
+ * **Example:** A queue with a generated name
+ * ```typescript
+ * import * as Modal from "@alchemy.run/modal";
+ *
+ * export const Jobs = Modal.Queue("Jobs", {});
+ * ```
+ *
+ * **Example:** A named queue in an environment
+ * ```typescript
+ * import * as Modal from "@alchemy.run/modal";
+ *
+ * export const Agents = Modal.Environment("Agents", {});
+ * export const Tasks = Modal.Queue("Tasks", { name: "tasks", environment: Agents });
+ * ```
+ *
+ * ### Producing from a Worker
+ * **Example:** Bind write access and put a job
+ * ```typescript
+ * import * as Cloudflare from "@alchemy.run/cloudflare";
+ * import * as Modal from "@alchemy.run/modal";
+ * import * as Effect from "effect/Effect";
+ * import * as HttpServerResponse from "effect/http/HttpServerResponse";
+ * import { Jobs } from "./Storage.ts";
+ *
+ * export default class Api extends Cloudflare.Worker<Api>()(
+ *   "Api",
+ *   { main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     const jobs = yield* Modal.WriteQueue(Jobs);
+ *     return {
+ *       fetch: Effect.gen(function* () {
+ *         yield* jobs.put({ repo: "alchemy-run/alchemy", command: "pnpm test" });
+ *         return HttpServerResponse.text("queued");
+ *       }).pipe(Effect.orDie),
+ *     };
+ *   }).pipe(Effect.provide(Modal.WriteQueueHttp)),
+ * ) {}
+ * ```
+ *
+ * ### Looking up an existing queue
+ * `Queue.lookup` references a queue 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 queue
+ * ```typescript
+ * const jobs = Modal.Queue.lookup({ name: "jobs" });
+ * ```
+ *
+ * @resource
+ * @product Queue
+ */
+export declare const Queue: import("alchemy/Resource").ResourceConstructor<Queue, Providers> & Effect.Effect<import("alchemy/Resource").ResourceConstructor<Queue, never>, never, never> & {
+    Self: import("alchemy/Self").Self<Queue>;
+    Provider: Provider.Provider<Queue>;
+    Aliases: readonly string[] | undefined;
+    ref(id: string, options?: {
+        stage?: string;
+        stack?: string;
+    }): Effect.Effect<Queue, never, never>;
+} & {
+    lookup(props: {
+        name: import("alchemy/Input").Input<string>;
+        environment?: import("alchemy/Input").Input<string | undefined>;
+    }): Queue;
+} & ((id: string, props: import("./internal/Declared.ts").DeclaredProps<QueueProps>) => Effect.Effect<Queue, never, Providers>);
+export type Queue = Resource<"Modal.Queue", QueueProps, QueueAttributes, never, Providers, QueueLookup>;
+/**
+ * Props for {@link Queue.lookup}: find a queue this stack
+ * doesn't manage by its name.
+ */
+export interface QueueLookup {
+    /** Queue name. */
+    name: string;
+    /**
+     * Modal environment the object lives in.
+     * @default the workspace's default environment
+     */
+    environment?: string;
+}
+/** A queue by name, or `undefined` when missing. */
+export declare const lookupQueue: (getOrCreate: (input: queue.QueueGetOrCreateRequest) => Effect.Effect<queue.QueueGetOrCreateResponse, queue.QueueGetOrCreateError, never>, name: string, env: string | undefined) => Effect.Effect<{
+    queueId: string;
+    name: string;
+    environment: string | undefined;
+} | undefined, queue.EnvironmentNotFound | queue.QueueAlreadyExists | queue.ModalOpError, never>;
+/**
+ * Get a queue by name, creating it when missing: the one implementation behind
+ * {@link Queue}'s reconcile and the runtime {@link CreateQueue} client.
+ */
+export declare const ensureQueue: (getOrCreate: (input: queue.QueueGetOrCreateRequest) => Effect.Effect<queue.QueueGetOrCreateResponse, queue.QueueGetOrCreateError, never>, name: string, env: string | undefined) => Effect.Effect<{
+    queueId: string;
+    name: string;
+    environment: string | undefined;
+}, QueueUnexpectedResponse | queue.QueueGetOrCreateError, never>;
+export declare const QueueProvider: () => import("effect/Layer").Layer<Provider.Provider<Queue>, never, import("alchemy/Stack").Stack | import("alchemy/Stage").Stage | queue.ModalOpContext>;
+export {};
+//# sourceMappingURL=Queue.d.ts.map

package/lib/Queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.d.ts","sources":["../src/Queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,8BAA8B,CAAC;AAGtD,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EACL,KAAK,gBAAgB,EAOtB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;;;;AAGhD,qBAAa,uBAAwB,SAAQ,6BAAkD;IAC7F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;AAEL,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;+HAAsD,CAAC;AAEzE,MAAM,MAAM,KAAK,GAAG,QAAQ,CAC1B,aAAa,EACb,UAAU,EACV,eAAe,EACf,KAAK,EACL,SAAS,EACT,WAAW,CACZ,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,oDAAoD;AACpD,eAAO,MAAM,WAAW;;;;gGAYtB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;gEAgBtB,CAAC;AAEH,eAAO,MAAM,aAAa,2JAiFvB,CAAC"}

package/lib/Queue.js

@@ -0,0 +1,177 @@
+import * as queue from "@distilled.cloud/modal/queue";
+import { Unowned } from "alchemy/AdoptPolicy";
+import { 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 { envNameOf, environmentNames, environmentOf, isGeneratedName, listAll, objectName, } from "./internal.js";
+import { declarable } from "./internal/Declared.js";
+import { isRuntimeName } from "./RuntimeOwner.js";
+export class QueueUnexpectedResponse extends Data.TaggedError("Modal.QueueUnexpectedResponse") {
+}
+/**
+ * A Modal Queue: a distributed FIFO queue shared by every container, Sandbox
+ * and client in the workspace, with optional named partitions. Items expire
+ * 24 hours after they are put (partitions can set their own TTL).
+ *
+ * Bind it with {@link WriteQueue} to put items, {@link ReadQueue} to take
+ * them, or {@link ReadWriteQueue} for both, from a Worker, Lambda or any
+ * other runtime. Values travel as bytes: the bindings encode them as JSON by
+ * default.
+ *
+ * Modal queues have no tags. Ownership is inferred from Alchemy state: a
+ * queue found under an explicit `name` without prior state is reported as
+ * unowned.
+ *
+ * ### Creating a Queue
+ * **Example:** A queue with a generated name
+ * ```typescript
+ * import * as Modal from "@alchemy.run/modal";
+ *
+ * export const Jobs = Modal.Queue("Jobs", {});
+ * ```
+ *
+ * **Example:** A named queue in an environment
+ * ```typescript
+ * import * as Modal from "@alchemy.run/modal";
+ *
+ * export const Agents = Modal.Environment("Agents", {});
+ * export const Tasks = Modal.Queue("Tasks", { name: "tasks", environment: Agents });
+ * ```
+ *
+ * ### Producing from a Worker
+ * **Example:** Bind write access and put a job
+ * ```typescript
+ * import * as Cloudflare from "@alchemy.run/cloudflare";
+ * import * as Modal from "@alchemy.run/modal";
+ * import * as Effect from "effect/Effect";
+ * import * as HttpServerResponse from "effect/http/HttpServerResponse";
+ * import { Jobs } from "./Storage.ts";
+ *
+ * export default class Api extends Cloudflare.Worker<Api>()(
+ *   "Api",
+ *   { main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     const jobs = yield* Modal.WriteQueue(Jobs);
+ *     return {
+ *       fetch: Effect.gen(function* () {
+ *         yield* jobs.put({ repo: "alchemy-run/alchemy", command: "pnpm test" });
+ *         return HttpServerResponse.text("queued");
+ *       }).pipe(Effect.orDie),
+ *     };
+ *   }).pipe(Effect.provide(Modal.WriteQueueHttp)),
+ * ) {}
+ * ```
+ *
+ * ### Looking up an existing queue
+ * `Queue.lookup` references a queue 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 queue
+ * ```typescript
+ * const jobs = Modal.Queue.lookup({ name: "jobs" });
+ * ```
+ *
+ * @resource
+ * @product Queue
+ */
+export const Queue = declarable()(Resource("Modal.Queue"));
+/** A queue by name, or `undefined` when missing. */
+export const lookupQueue = Effect.fn(function* (getOrCreate, name, env) {
+    const found = yield* getOrCreate({
+        deploymentName: name,
+        environmentName: environmentOf(env),
+        objectCreationType: "OBJECT_CREATION_TYPE_UNSPECIFIED",
+    }).pipe(Effect.catchTag("QueueNotFound", () => Effect.undefined));
+    if (!found?.queueId)
+        return undefined;
+    return { queueId: found.queueId, name, environment: env };
+});
+/**
+ * Get a queue by name, creating it when missing: the one implementation behind
+ * {@link Queue}'s reconcile and the runtime {@link CreateQueue} client.
+ */
+export const ensureQueue = Effect.fn(function* (getOrCreate, name, env) {
+    const created = yield* getOrCreate({
+        deploymentName: name,
+        environmentName: environmentOf(env),
+        objectCreationType: "OBJECT_CREATION_TYPE_CREATE_IF_MISSING",
+    });
+    if (!created.queueId) {
+        return yield* new QueueUnexpectedResponse({
+            message: `Modal returned no id for queue ${name}`,
+        });
+    }
+    return { queueId: created.queueId, name, environment: env };
+});
+export const QueueProvider = () => Provider.effect(Queue, Effect.gen(function* () {
+    const observe = Effect.fn(function* (queueId, name, env) {
+        if (queueId !== undefined) {
+            const byId = yield* queue
+                .queueGetById({ queueId })
+                .pipe(Effect.catchTag("QueueNotFound", () => Effect.undefined));
+            if (byId?.queueId) {
+                return {
+                    queueId: byId.queueId,
+                    name: byId.metadata?.name ?? name,
+                    environment: env,
+                };
+            }
+        }
+        return yield* lookupQueue(yield* queue.queueGetOrCreate, name, env);
+    });
+    return {
+        stables: ["queueId", "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" };
+            const name = yield* objectName(id, news.name);
+            if (output !== undefined && name !== output.name)
+                return { action: "replace" };
+            return undefined;
+        }),
+        lookup: Effect.fn(function* ({ name, environment }) {
+            return yield* observe(undefined, name, environment);
+        }),
+        read: Effect.fn(function* ({ id, olds, output }) {
+            const name = output?.name ?? (yield* objectName(id, olds?.name));
+            const observed = yield* observe(output?.queueId, name, envNameOf(olds?.environment));
+            if (!observed)
+                return undefined;
+            return output !== undefined || olds?.name === undefined ? observed : Unowned(observed);
+        }),
+        reconcile: Effect.fn(function* ({ id, news, output, session }) {
+            const name = output?.name ?? (yield* objectName(id, news.name));
+            const current = yield* observe(output?.queueId, name, envNameOf(news.environment));
+            if (current)
+                return current;
+            yield* session.note(`Creating queue ${name}...`);
+            return yield* ensureQueue(yield* queue.queueGetOrCreate, name, envNameOf(news.environment));
+        }),
+        delete: Effect.fn(function* ({ output }) {
+            yield* queue
+                .deleteQueue({ queueId: output.queueId })
+                .pipe(Effect.catchTag("QueueNotFound", () => Effect.void));
+        }),
+        list: Effect.fn(function* () {
+            const envs = yield* environmentNames;
+            const all = [];
+            for (const env of envs) {
+                const items = yield* listAll((pagination) => queue
+                    .listQueue({ environmentName: env, pagination })
+                    .pipe(Effect.map((response) => response.queues ?? [])), (item) => item.createdAt);
+                for (const item of items) {
+                    if (!item.queueId || !(isGeneratedName(item.name) || isRuntimeName(item.name)))
+                        continue;
+                    all.push({ queueId: item.queueId, name: item.name ?? "", environment: env });
+                }
+            }
+            return all;
+        }),
+    };
+}));
+//# sourceMappingURL=Queue.js.map

package/lib/Queue.js.map

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

package/lib/QueueClient.d.ts

@@ -0,0 +1,64 @@
+import * as queue from "@distilled.cloud/modal/queue";
+import type { RuntimeContext } from "alchemy/RuntimeContext";
+import * as Effect from "effect/Effect";
+import { type ModalValueNotJson } from "./BindingHttp.ts";
+import { type OpError } from "./internal.ts";
+/** The queue operations the clients call, resolved by `ModalBindings.withCredentials`. */
+export declare const QueueOps: Effect.Effect<{
+    readonly clearQueue: (input: queue.ClearQueueRequest) => Effect.Effect<queue.ClearQueueResponse, queue.ClearQueueError, never>;
+    readonly getQueue: (input: queue.GetQueueRequest) => Effect.Effect<queue.GetQueueResponse, queue.ModalOpError, never>;
+    readonly putQueue: (input: queue.PutQueueRequest) => Effect.Effect<queue.PutQueueResponse, queue.PutQueueError, never>;
+    readonly queueLen: (input: queue.QueueLenRequest) => Effect.Effect<queue.QueueLenResponse, queue.QueueLenError, never>;
+    readonly queueNextItems: (input: queue.QueueNextItemsRequest) => Effect.Effect<queue.QueueNextItemsResponse, queue.QueueNextItemsError, never>;
+}, never, import("./internal.ts").OperationServices>;
+export type QueueOps = Effect.Success<typeof QueueOps>;
+/** A queue call's error: the operation's typed errors, and items that aren't JSON. */
+export type QueueError<K extends keyof QueueOps> = OpError<QueueOps, K> | ModalValueNotJson;
+/** Which partition of a queue a call uses; omitted means the default partition. */
+export interface QueuePartitionOptions {
+    readonly partition?: string;
+}
+/**
+ * Take items from one queue. Items are JSON (the bytes of `JSON.stringify`),
+ * so Python consumers read them with `json.loads`.
+ */
+export interface ReadQueueClient {
+    readonly queueId: Effect.Effect<string>;
+    /**
+     * Remove and return up to `count` items, waiting up to `timeout` for the
+     * first one (an empty array when none arrived).
+     */
+    take<A = unknown>(options?: QueuePartitionOptions & {
+        readonly count?: number;
+        readonly timeout?: number | string;
+    }): Effect.Effect<ReadonlyArray<A>, QueueError<"getQueue">, RuntimeContext>;
+    /** Items currently in the queue, without removing them. */
+    peek<A = unknown>(options?: QueuePartitionOptions): Effect.Effect<ReadonlyArray<A>, QueueError<"queueNextItems">, RuntimeContext>;
+    /** Number of items in a partition (or, with `total`, in every partition). */
+    len(options?: QueuePartitionOptions & {
+        readonly total?: boolean;
+    }): Effect.Effect<number, OpError<QueueOps, "queueLen">, RuntimeContext>;
+}
+/** Put items into one queue. */
+export interface WriteQueueClient {
+    readonly queueId: Effect.Effect<string>;
+    /** Append one item. */
+    put(value: unknown, options?: QueuePartitionOptions & {
+        readonly partitionTtl?: number | string;
+    }): Effect.Effect<void, OpError<QueueOps, "putQueue">, RuntimeContext>;
+    /** Append many items in order. */
+    putMany(values: Iterable<unknown>, options?: QueuePartitionOptions & {
+        readonly partitionTtl?: number | string;
+    }): Effect.Effect<void, OpError<QueueOps, "putQueue">, RuntimeContext>;
+    /** Remove every item of a partition (or of all partitions). */
+    clear(options?: QueuePartitionOptions & {
+        readonly all?: boolean;
+    }): Effect.Effect<void, OpError<QueueOps, "clearQueue">, RuntimeContext>;
+}
+/** Put and take items. */
+export interface ReadWriteQueueClient extends ReadQueueClient, WriteQueueClient {
+}
+export declare const makeReadQueueClient: (queueId: Effect.Effect<string>, ops: QueueOps) => ReadQueueClient;
+export declare const makeWriteQueueClient: (queueId: Effect.Effect<string>, ops: QueueOps) => WriteQueueClient;
+export declare const makeReadWriteQueueClient: (queueId: Effect.Effect<string>, ops: QueueOps) => ReadWriteQueueClient;
+//# sourceMappingURL=QueueClient.d.ts.map

package/lib/QueueClient.d.ts.map

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

package/lib/QueueClient.js

@@ -0,0 +1,73 @@
+import * as queue from "@distilled.cloud/modal/queue";
+import * as Effect from "effect/Effect";
+import { decodeJson, encodeJson } from "./BindingHttp.js";
+import { operations, seconds } from "./internal.js";
+/** The queue operations the clients call, resolved by `ModalBindings.withCredentials`. */
+export const QueueOps = operations({
+    clearQueue: queue.clearQueue,
+    getQueue: queue.getQueue,
+    putQueue: queue.putQueue,
+    queueLen: queue.queueLen,
+    queueNextItems: queue.queueNextItems,
+});
+export const makeReadQueueClient = (queueId, ops) => ({
+    queueId,
+    take: (options = {}) => Effect.gen(function* () {
+        const id = yield* queueId;
+        const { values } = yield* ops.getQueue({
+            queueId: id,
+            partitionKey: options.partition,
+            nValues: options.count ?? 1,
+            timeout: seconds(options.timeout) ?? 0,
+        });
+        return yield* Effect.forEach(values ?? [], (value) => decodeJson(value));
+    }),
+    peek: (options = {}) => Effect.gen(function* () {
+        const id = yield* queueId;
+        const { items } = yield* ops.queueNextItems({
+            queueId: id,
+            partitionKey: options.partition,
+            itemPollTimeout: 0,
+        });
+        return yield* Effect.forEach(items ?? [], (item) => decodeJson(item.value ?? ""));
+    }),
+    len: (options = {}) => Effect.gen(function* () {
+        const id = yield* queueId;
+        const response = yield* ops.queueLen({
+            queueId: id,
+            partitionKey: options.partition,
+            total: options.total,
+        });
+        return response.len ?? 0;
+    }),
+});
+export const makeWriteQueueClient = (queueId, ops) => {
+    const putMany = (values, options = {}) => Effect.gen(function* () {
+        const id = yield* queueId;
+        const encoded = yield* Effect.forEach([...values], (value) => encodeJson(value));
+        yield* ops.putQueue({
+            queueId: id,
+            values: encoded,
+            partitionKey: options.partition,
+            partitionTtlSeconds: seconds(options.partitionTtl),
+        });
+    });
+    return {
+        queueId,
+        put: (value, options) => putMany([value], options),
+        putMany,
+        clear: (options = {}) => Effect.gen(function* () {
+            const id = yield* queueId;
+            yield* ops.clearQueue({
+                queueId: id,
+                partitionKey: options.partition,
+                allPartitions: options.all,
+            });
+        }),
+    };
+};
+export const makeReadWriteQueueClient = (queueId, ops) => ({
+    ...makeReadQueueClient(queueId, ops),
+    ...makeWriteQueueClient(queueId, ops),
+});
+//# sourceMappingURL=QueueClient.js.map

package/lib/QueueClient.js.map

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

package/lib/ReadApp.d.ts

@@ -0,0 +1,85 @@
+import type * as app from "@distilled.cloud/modal/app";
+import * as Binding from "alchemy/Binding";
+import type { RuntimeContext } from "alchemy/RuntimeContext";
+import type * as Effect from "effect/Effect";
+import type { App } from "./App.ts";
+import type { OpError } from "./internal.ts";
+import type { ReadAppOps } from "./ReadAppHttp.ts";
+import type { TimeRange } from "./ReadFunction.ts";
+/** One log line. */
+export interface AppLogLine {
+    readonly data: string;
+    /** Epoch seconds. */
+    readonly timestamp: number | undefined;
+    readonly stream: "stdout" | "stderr" | "info" | undefined;
+    readonly functionId: string | undefined;
+    readonly functionCallId: string | undefined;
+    readonly containerId: string | undefined;
+    readonly sandboxId: string | undefined;
+}
+/** Filters for an App's logs. */
+export interface AppLogFilter {
+    readonly functionId?: string;
+    readonly functionCallId?: string;
+    readonly containerId?: string;
+    readonly sandboxId?: string;
+    readonly search?: string;
+    readonly stream?: "stdout" | "stderr" | "info";
+}
+/** Observe an App: logs, functions, and deployment history. */
+export interface AppReader {
+    /** Log lines in a time range, oldest first. */
+    logs(query: TimeRange & AppLogFilter & {
+        readonly limit?: number;
+    }): Effect.Effect<ReadonlyArray<AppLogLine>, OpError<ReadAppOps, "fetchLogs">, RuntimeContext>;
+    /**
+     * Follow the App's logs: lines after `cursor` (or the latest), waiting up
+     * to `timeout` for new ones. Pass the returned cursor to the next call.
+     */
+    tail(query?: AppLogFilter & {
+        readonly cursor?: string;
+        readonly timeout?: number;
+    }): Effect.Effect<{
+        readonly lines: ReadonlyArray<AppLogLine>;
+        readonly cursor: string | undefined;
+    }, OpError<ReadAppOps, "getLogs">, RuntimeContext>;
+    /** Log lines per time bucket. */
+    logCount(query: TimeRange & AppLogFilter & {
+        readonly bucketSecs?: number;
+    }): Effect.Effect<app.AppCountLogsResponse, OpError<ReadAppOps, "countLogs">, RuntimeContext>;
+    /** The App's metadata and a summary of each function. */
+    info(): Effect.Effect<app.AppGetInfoResponse, OpError<ReadAppOps, "info">, RuntimeContext>;
+    /** When the App was created, deployed and stopped, and by whom. */
+    lifecycle(): Effect.Effect<app.AppLifecycle | undefined, OpError<ReadAppOps, "lifecycle">, RuntimeContext>;
+    /** The functions and classes the App serves, by name. */
+    layout(): Effect.Effect<{
+        readonly functionIds: Record<string, string>;
+        readonly classIds: Record<string, string>;
+    }, OpError<ReadAppOps, "layout">, RuntimeContext>;
+    /** Every deployed version, and the version in production. */
+    deployments(): Effect.Effect<app.AppDeploymentHistoryResponse, OpError<ReadAppOps, "deployments">, RuntimeContext>;
+}
+/**
+ * Read a Modal App from any runtime: its logs (every function, server and
+ * sandbox in it), function summaries and deployment history.
+ *
+ * ### Logs
+ * **Example:** Errors from the last hour
+ * ```typescript
+ * const backend = yield* Modal.ReadApp(Backend);
+ * const lines = yield* backend.logs({ since: new Date(Date.now() - 3_600_000), stream: "stderr" });
+ * ```
+ *
+ * ### Deployments
+ * **Example:** The version in production
+ * ```typescript
+ * const { productionAppVersion } = yield* backend.deployments();
+ * ```
+ *
+ * @binding
+ * @product App
+ */
+export interface ReadApp extends Binding.Service<ReadApp, "Modal.ReadApp", (app: App) => Effect.Effect<AppReader>> {
+}
+export declare const ReadApp: ReadApp;
+//# sourceMappingURL=ReadApp.d.ts.map

package/lib/ReadApp.d.ts.map

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

package/lib/ReadApp.js

@@ -0,0 +1,3 @@
+import * as Binding from "alchemy/Binding";
+export const ReadApp = Binding.Service("Modal.ReadApp");
+//# sourceMappingURL=ReadApp.js.map

package/lib/ReadApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadApp.js","sources":["../src/ReadApp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAmG3C,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAU,eAAe,CAAC,CAAC"}

package/lib/ReadAppHttp.d.ts

@@ -0,0 +1,26 @@
+import * as app from "@distilled.cloud/modal/app";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { ReadApp } from "./ReadApp.ts";
+/** The operations the client calls, resolved by `ModalBindings.withCredentials`. */
+declare const ReadAppOps: Effect.Effect<{
+    readonly fetchLogs: (input: app.AppFetchLogsRequest) => Effect.Effect<app.AppFetchLogsResponse, app.AppFetchLogsError, never>;
+    readonly getLogs: import("@distilled.cloud/core/api").StreamingCall<app.AppGetLogsRequest, app.AppGetLogsStream, app.AppGetLogsError, never, app.TaskLogsBatch>;
+    readonly countLogs: (input: app.AppCountLogsRequest) => Effect.Effect<app.AppCountLogsResponse, app.AppCountLogsError, never>;
+    readonly info: (input: app.AppGetInfoRequest) => Effect.Effect<app.AppGetInfoResponse, app.AppGetInfoError, never>;
+    readonly lifecycle: (input: app.AppGetLifecycleRequest) => Effect.Effect<app.AppGetLifecycleResponse, app.AppGetLifecycleError, never>;
+    readonly layout: (input: app.AppGetLayoutRequest) => Effect.Effect<app.AppGetLayoutResponse, app.AppGetLayoutError, never>;
+    readonly deployments: (input: app.AppDeploymentHistoryRequest) => Effect.Effect<app.AppDeploymentHistoryResponse, app.AppDeploymentHistoryError, never>;
+}, never, import("./internal.ts").OperationServices>;
+export type ReadAppOps = Effect.Success<typeof ReadAppOps>;
+/**
+ * {@link ReadApp} over Modal's API. Grants the host's identity (a scoped
+ * `Modal.ServiceUser`) the `viewer` role on the App's environment.
+ *
+ * @layer
+ * @product App
+ * @provides Modal.ReadApp
+ */
+export declare const ReadAppHttp: Layer.Layer<ReadApp, never, never>;
+export {};
+//# sourceMappingURL=ReadAppHttp.d.ts.map

package/lib/ReadAppHttp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadAppHttp.d.ts","sources":["../src/ReadAppHttp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,4BAA4B,CAAC;AAClD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,EAAE,OAAO,EAAsD,MAAM,cAAc,CAAC;AA0B3F,oFAAoF;AACpF,QAAA,MAAM,UAAU;;;;;;;;oDAQd,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,UAAU,CAAC,CAAC;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,oCAwFvB,CAAC"}