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

package/lib/ReadAppHttp.js

@@ -0,0 +1,106 @@
+import * as app from "@distilled.cloud/modal/app";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { makeModalBinding } from "./BindingHttp.js";
+import { operations, stringMap, timestampOf } from "./internal.js";
+import { ReadApp } from "./ReadApp.js";
+const STREAM = {
+    stdout: "FILE_DESCRIPTOR_STDOUT",
+    stderr: "FILE_DESCRIPTOR_STDERR",
+    info: "FILE_DESCRIPTOR_INFO",
+};
+const streamOf = (fd) => fd === STREAM.stdout
+    ? "stdout"
+    : fd === STREAM.stderr
+        ? "stderr"
+        : fd === STREAM.info
+            ? "info"
+            : undefined;
+const filterOf = (filter) => ({
+    functionId: filter.functionId,
+    functionCallId: filter.functionCallId,
+    taskId: filter.containerId,
+    sandboxId: filter.sandboxId,
+    searchText: filter.search,
+    source: filter.stream ? STREAM[filter.stream] : undefined,
+});
+/** The operations the client calls, resolved by `ModalBindings.withCredentials`. */
+const ReadAppOps = operations({
+    fetchLogs: app.appFetchLogs,
+    getLogs: app.appGetLogs,
+    countLogs: app.appCountLogs,
+    info: app.appGetInfo,
+    lifecycle: app.appGetLifecycle,
+    layout: app.appGetLayout,
+    deployments: app.appDeploymentHistory,
+});
+/**
+ * {@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 const ReadAppHttp = Layer.effect(ReadApp, makeModalBinding({
+    tag: "Modal.ReadApp",
+    operations: ReadAppOps,
+    role: "viewer",
+    make: Effect.fn(function* (target, ops) {
+        const appId = yield* target.appId;
+        return {
+            logs: (query) => Effect.flatMap(appId, (id) => ops.fetchLogs({
+                appId: id,
+                since: timestampOf(query.since),
+                until: timestampOf(query.until ?? Date.now()),
+                limit: query.limit,
+                ...filterOf(query),
+            })).pipe(Effect.map((response) => (response.batches ?? []).flatMap((batch) => (batch.items ?? []).map((line) => ({
+                data: line.data ?? "",
+                timestamp: line.timestamp,
+                stream: streamOf(line.fileDescriptor),
+                functionId: batch.functionId,
+                functionCallId: line.functionCallId,
+                containerId: line.containerId ?? batch.taskId,
+                sandboxId: batch.sandboxId,
+            }))))),
+            tail: (query = {}) => Effect.flatMap(appId, (id) => ops.getLogs({
+                appId: id,
+                timeout: query.timeout ?? 10,
+                lastEntryId: query.cursor,
+                functionId: query.functionId,
+                functionCallId: query.functionCallId,
+                taskId: query.containerId,
+                sandboxId: query.sandboxId,
+                searchText: query.search,
+                fileDescriptor: query.stream ? STREAM[query.stream] : undefined,
+            })).pipe(Effect.map(({ items }) => ({
+                lines: items.flatMap((batch) => (batch.items ?? []).map((line) => ({
+                    data: line.data ?? "",
+                    timestamp: line.timestamp,
+                    stream: streamOf(line.fileDescriptor),
+                    functionId: batch.functionId,
+                    functionCallId: line.functionCallId,
+                    containerId: line.containerId ?? batch.taskId,
+                    sandboxId: batch.sandboxId,
+                }))),
+                cursor: items.findLast((batch) => batch.entryId)?.entryId ?? query.cursor,
+            }))),
+            logCount: (query) => Effect.flatMap(appId, (id) => ops.countLogs({
+                appId: id,
+                since: timestampOf(query.since),
+                until: timestampOf(query.until ?? Date.now()),
+                bucketSecs: query.bucketSecs,
+                ...filterOf(query),
+            })),
+            info: () => Effect.flatMap(appId, (id) => ops.info({ appId: id })),
+            lifecycle: () => Effect.flatMap(appId, (id) => ops.lifecycle({ appId: id })).pipe(Effect.map((response) => response.lifecycle)),
+            layout: () => Effect.flatMap(appId, (id) => ops.layout({ appId: id })).pipe(Effect.map(({ appLayout }) => ({
+                functionIds: stringMap(appLayout?.functionIds),
+                classIds: stringMap(appLayout?.classIds),
+            }))),
+            deployments: () => Effect.flatMap(appId, (id) => ops.deployments({ appId: id })),
+        };
+    }),
+}));
+//# sourceMappingURL=ReadAppHttp.js.map

package/lib/ReadAppHttp.js.map

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

package/lib/ReadDict.d.ts

@@ -0,0 +1,39 @@
+import * as Binding from "alchemy/Binding";
+import type * as Effect from "effect/Effect";
+import type { Dict } from "./Dict.ts";
+import type { ReadDictClient } from "./DictClient.ts";
+export type { ReadDictClient } from "./DictClient.ts";
+/**
+ * Read a Modal Dict from any runtime: get, contains, len and entries. Keys and values are JSON.
+ *
+ * ### Bind a dict
+ * **Example:** From a Cloudflare Worker
+ * ```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 { Results } from "./Storage.ts";
+ *
+ * export default class Api extends Cloudflare.Worker<Api>()(
+ *   "Api",
+ *   { main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     const dict = yield* Modal.ReadDict(Results);
+ *     return {
+ *       fetch: Effect.gen(function* () {
+ *         const last = yield* dict.get("last-run");
+ *         return yield* HttpServerResponse.json(last ?? null);
+ *       }).pipe(Effect.orDie),
+ *     };
+ *   }).pipe(Effect.provide(Modal.ReadDictHttp)),
+ * ) {}
+ * ```
+ *
+ * @binding
+ * @product Dict
+ */
+export interface ReadDict extends Binding.Service<ReadDict, "Modal.ReadDict", (dict: Dict) => Effect.Effect<ReadDictClient>> {
+}
+export declare const ReadDict: ReadDict;
+//# sourceMappingURL=ReadDict.d.ts.map

package/lib/ReadDict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadDict.d.ts","sources":["../src/ReadDict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,QAAS,SAAQ,OAAO,CAAC,OAAO,CAC/C,QAAQ,EACR,gBAAgB,EAChB,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAC9C;CAAG;AAEJ,eAAO,MAAM,QAAQ,UAA8C,CAAC"}

package/lib/ReadDict.js

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

package/lib/ReadDict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadDict.js","sources":["../src/ReadDict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AA2C3C,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAW,gBAAgB,CAAC,CAAC"}

package/lib/ReadDictHttp.d.ts

@@ -0,0 +1,12 @@
+import * as Layer from "effect/Layer";
+import { ReadDict } from "./ReadDict.ts";
+/**
+ * {@link ReadDict} over Modal's API. Grants the host's identity (a scoped
+ * `Modal.ServiceUser`) the `viewer` role on the dict's environment.
+ *
+ * @layer
+ * @product Dict
+ * @provides Modal.ReadDict
+ */
+export declare const ReadDictHttp: Layer.Layer<ReadDict, never, never>;
+//# sourceMappingURL=ReadDictHttp.d.ts.map

package/lib/ReadDictHttp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadDictHttp.d.ts","sources":["../src/ReadDictHttp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,qCAWxB,CAAC"}

package/lib/ReadDictHttp.js

@@ -0,0 +1,23 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { makeModalBinding } from "./BindingHttp.js";
+import { DictOps, makeReadDictClient } from "./DictClient.js";
+import { ReadDict } from "./ReadDict.js";
+/**
+ * {@link ReadDict} over Modal's API. Grants the host's identity (a scoped
+ * `Modal.ServiceUser`) the `viewer` role on the dict's environment.
+ *
+ * @layer
+ * @product Dict
+ * @provides Modal.ReadDict
+ */
+export const ReadDictHttp = Layer.effect(ReadDict, makeModalBinding({
+    tag: "Modal.ReadDict",
+    operations: DictOps,
+    role: "viewer",
+    make: Effect.fn(function* (dict, ops) {
+        const dictId = yield* dict.dictId;
+        return makeReadDictClient(dictId, ops);
+    }),
+}));
+//# sourceMappingURL=ReadDictHttp.js.map

package/lib/ReadDictHttp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadDictHttp.js","sources":["../src/ReadDictHttp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CACtC,QAAQ,EACR,gBAAgB,CAAC;IACf,GAAG,EAAE,gBAAgB;IACrB,UAAU,EAAE,OAAO;IACnB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAU,EAAE,GAAG;QACxC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QAClC,OAAO,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC,CAAC;CACH,CAAC,CACH,CAAC"}

package/lib/ReadFunction.d.ts

@@ -0,0 +1,73 @@
+import type * as functions from "@distilled.cloud/modal/functions";
+import * as Binding from "alchemy/Binding";
+import type { RuntimeContext } from "alchemy/RuntimeContext";
+import type * as Effect from "effect/Effect";
+import type { FunctionLookupError } from "./FunctionTarget.ts";
+import type { OpError } from "./internal.ts";
+import type { FunctionTarget } from "./InvokeFunction.ts";
+import type { ReadFunctionOps } from "./ReadFunctionHttp.ts";
+import type { Server } from "./Server.ts";
+/** A time range: `Date`s, ISO strings, or epoch milliseconds. */
+export interface TimeRange {
+    readonly since: Date | string | number;
+    readonly until?: Date | string | number;
+}
+/** Observe a function: load, call counts and metrics. */
+export interface FunctionReader {
+    /** Inputs waiting and running, and the containers serving them, right now. */
+    stats(): Effect.Effect<{
+        readonly backlog: number;
+        readonly runningInputs: number;
+        readonly containers: number;
+        readonly inputHeadroom: number;
+    }, FunctionLookupError | OpError<ReadFunctionOps, "currentStats">, RuntimeContext>;
+    /** Input outcomes, latency percentiles and container counts over a time range. */
+    timeRangeStats(range: TimeRange & {
+        readonly containerId?: string;
+    }): Effect.Effect<functions.FunctionGetTimeRangeStatsResponse, FunctionLookupError | OpError<ReadFunctionOps, "timeRangeStats">, RuntimeContext>;
+    /** Metric series (`containers`, `calls`) over a time range. */
+    metrics(range: TimeRange & {
+        /** Seconds per bucket. @default 3600 */
+        readonly bucketSecs?: number;
+        readonly groups?: ReadonlyArray<string>;
+    }): Effect.Effect<functions.FunctionGetMetricsResponse, FunctionLookupError | OpError<ReadFunctionOps, "metrics">, RuntimeContext>;
+    /** Calls started per time bucket. */
+    callCount(range: TimeRange & {
+        /** Seconds per bucket. @default 3600 */
+        readonly bucketSecs?: number;
+    }): Effect.Effect<functions.FunctionCallCountResponse, FunctionLookupError | OpError<ReadFunctionOps, "callCount">, RuntimeContext>;
+    /** The inputs of one call, by outcome. */
+    callInfo(call: {
+        readonly functionCallId: string;
+    }): Effect.Effect<functions.FunctionCallGetInfoResponse, FunctionLookupError | OpError<ReadFunctionOps, "callInfo">, RuntimeContext>;
+    /** The autoscaler settings in effect. */
+    autoscaler(): Effect.Effect<functions.AutoscalerSettings | undefined, FunctionLookupError | OpError<ReadFunctionOps, "schedulingParams">, RuntimeContext>;
+}
+/**
+ * Read a Modal Function's (or Server's) live state from any runtime:
+ * backlog and running inputs, call counts, outcome counts, latency
+ * percentiles and metric series. Bind a resource of the Stack, or a function
+ * deployed with `modal deploy` by name.
+ *
+ * ### Watch the backlog
+ * **Example:** Shed load when the queue is long
+ * ```typescript
+ * const embed = yield* Modal.ReadFunction(Embed);
+ * const { backlog } = yield* embed.stats();
+ * if (backlog > 100) return HttpServerResponse.text("busy", { status: 503 });
+ * ```
+ *
+ * ### History
+ * **Example:** Failures in the last hour
+ * ```typescript
+ * const stats = yield* embed.timeRangeStats({ since: new Date(Date.now() - 3_600_000) });
+ * yield* Effect.log(`${stats.inputFailureCount} failed of ${stats.inputSuccessCount}`);
+ * ```
+ *
+ * @binding
+ * @product Function
+ */
+export interface ReadFunction extends Binding.Service<ReadFunction, "Modal.ReadFunction", (target: FunctionTarget | Server) => Effect.Effect<FunctionReader>> {
+}
+export declare const ReadFunction: ReadFunction;
+//# sourceMappingURL=ReadFunction.d.ts.map

package/lib/ReadFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadFunction.d.ts","sources":["../src/ReadFunction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,SAAS,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;CACzC;AAED,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,KAAK,IAAI,MAAM,CAAC,MAAM,CACpB;QACE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;KAChC,EACD,mBAAmB,GAAG,OAAO,CAAC,eAAe,EAAE,cAAc,CAAC,EAC9D,cAAc,CACf,CAAC;IACF,kFAAkF;IAClF,cAAc,CACZ,KAAK,EAAE,SAAS,GAAG;QAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD,MAAM,CAAC,MAAM,CACd,SAAS,CAAC,iCAAiC,EAC3C,mBAAmB,GAAG,OAAO,CAAC,eAAe,EAAE,gBAAgB,CAAC,EAChE,cAAc,CACf,CAAC;IACF,+DAA+D;IAC/D,OAAO,CACL,KAAK,EAAE,SAAS,GAAG;QACjB,wCAAwC;QACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;KACzC,GACA,MAAM,CAAC,MAAM,CACd,SAAS,CAAC,0BAA0B,EACpC,mBAAmB,GAAG,OAAO,CAAC,eAAe,EAAE,SAAS,CAAC,EACzD,cAAc,CACf,CAAC;IACF,qCAAqC;IACrC,SAAS,CACP,KAAK,EAAE,SAAS,GAAG;QACjB,wCAAwC;QACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;KAC9B,GACA,MAAM,CAAC,MAAM,CACd,SAAS,CAAC,yBAAyB,EACnC,mBAAmB,GAAG,OAAO,CAAC,eAAe,EAAE,WAAW,CAAC,EAC3D,cAAc,CACf,CAAC;IACF,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;KACjC,GAAG,MAAM,CAAC,MAAM,CACf,SAAS,CAAC,2BAA2B,EACrC,mBAAmB,GAAG,OAAO,CAAC,eAAe,EAAE,UAAU,CAAC,EAC1D,cAAc,CACf,CAAC;IACF,yCAAyC;IACzC,UAAU,IAAI,MAAM,CAAC,MAAM,CACzB,SAAS,CAAC,kBAAkB,GAAG,SAAS,EACxC,mBAAmB,GAAG,OAAO,CAAC,eAAe,EAAE,kBAAkB,CAAC,EAClE,cAAc,CACf,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,YAAa,SAAQ,OAAO,CAAC,OAAO,CACnD,YAAY,EACZ,oBAAoB,EACpB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CACnE;CAAG;AAEJ,eAAO,MAAM,YAAY,cAAsD,CAAC"}

package/lib/ReadFunction.js

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

package/lib/ReadFunction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadFunction.js","sources":["../src/ReadFunction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAyG3C,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAe,oBAAoB,CAAC,CAAC"}

package/lib/ReadFunctionHttp.d.ts

@@ -0,0 +1,25 @@
+import * as functions from "@distilled.cloud/modal/functions";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { ReadFunction } from "./ReadFunction.ts";
+/** The operations the client calls, resolved by `ModalBindings.withCredentials`. */
+declare const ReadFunctionOps: Effect.Effect<{
+    readonly currentStats: (input: functions.FunctionGetCurrentStatsRequest) => Effect.Effect<functions.FunctionGetCurrentStatsResponse, functions.FunctionGetCurrentStatsError, never>;
+    readonly timeRangeStats: (input: functions.FunctionGetTimeRangeStatsRequest) => Effect.Effect<functions.FunctionGetTimeRangeStatsResponse, functions.FunctionGetTimeRangeStatsError, never>;
+    readonly metrics: (input: functions.FunctionGetMetricsRequest) => Effect.Effect<functions.FunctionGetMetricsResponse, functions.ModalOpError, never>;
+    readonly callCount: (input: functions.FunctionCallCountRequest) => Effect.Effect<functions.FunctionCallCountResponse, functions.ModalOpError, never>;
+    readonly callInfo: (input: functions.FunctionCallGetInfoRequest) => Effect.Effect<functions.FunctionCallGetInfoResponse, functions.FunctionCallGetInfoError, never>;
+    readonly schedulingParams: (input: functions.FunctionGetSchedulingParamsRequest) => Effect.Effect<functions.FunctionGetSchedulingParamsResponse, functions.FunctionGetSchedulingParamsError, never>;
+}, never, import("./internal.ts").OperationServices>;
+export type ReadFunctionOps = Effect.Success<typeof ReadFunctionOps>;
+/**
+ * {@link ReadFunction} over Modal's API. Grants the host's identity (a scoped
+ * `Modal.ServiceUser`) the `viewer` role on the function's environment.
+ *
+ * @layer
+ * @product Function
+ * @provides Modal.ReadFunction
+ */
+export declare const ReadFunctionHttp: Layer.Layer<ReadFunction, never, never>;
+export {};
+//# sourceMappingURL=ReadFunctionHttp.d.ts.map

package/lib/ReadFunctionHttp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadFunctionHttp.d.ts","sources":["../src/ReadFunctionHttp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,EAAE,YAAY,EAAuB,MAAM,mBAAmB,CAAC;AAMtE,oFAAoF;AACpF,QAAA,MAAM,eAAe;;;;;;;oDAOnB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,eAAe,CAAC,CAAC;AAErE;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,yCA0D5B,CAAC"}

package/lib/ReadFunctionHttp.js

@@ -0,0 +1,63 @@
+import * as functions from "@distilled.cloud/modal/functions";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { makeFunctionBinding } from "./FunctionTarget.js";
+import { operations, timestampOf } from "./internal.js";
+import { ReadFunction } from "./ReadFunction.js";
+/** Bucket width when a query doesn't set one: Modal requires a positive one. */
+const DEFAULT_BUCKET_SECS = 3600;
+/** The operations the client calls, resolved by `ModalBindings.withCredentials`. */
+const ReadFunctionOps = operations({
+    currentStats: functions.functionGetCurrentStats,
+    timeRangeStats: functions.functionGetTimeRangeStats,
+    metrics: functions.functionGetMetrics,
+    callCount: functions.functionCallCount,
+    callInfo: functions.functionCallGetInfo,
+    schedulingParams: functions.functionGetSchedulingParams,
+});
+/**
+ * {@link ReadFunction} over Modal's API. Grants the host's identity (a scoped
+ * `Modal.ServiceUser`) the `viewer` role on the function's environment.
+ *
+ * @layer
+ * @product Function
+ * @provides Modal.ReadFunction
+ */
+export const ReadFunctionHttp = Layer.effect(ReadFunction, makeFunctionBinding({
+    tag: "Modal.ReadFunction",
+    operations: ReadFunctionOps,
+    role: "viewer",
+    make: ({ functionId }, ops, _target) => Effect.succeed({
+        stats: () => Effect.flatMap(functionId, (id) => ops.currentStats({ functionId: id })).pipe(Effect.map((stats) => ({
+            backlog: stats.backlog ?? 0,
+            runningInputs: stats.numRunningInputs ?? 0,
+            containers: stats.numTotalTasks ?? 0,
+            inputHeadroom: stats.inputHeadroom ?? 0,
+        }))),
+        timeRangeStats: (range) => Effect.flatMap(functionId, (id) => ops.timeRangeStats({
+            functionId: id,
+            since: timestampOf(range.since),
+            until: timestampOf(range.until ?? Date.now()),
+            containerId: range.containerId,
+        })),
+        metrics: (range) => Effect.flatMap(functionId, (id) => ops.metrics({
+            functionId: id,
+            since: timestampOf(range.since),
+            until: timestampOf(range.until ?? Date.now()),
+            bucketSecs: range.bucketSecs ?? DEFAULT_BUCKET_SECS,
+            groups: range.groups ? [...range.groups] : undefined,
+        })),
+        callCount: (range) => Effect.flatMap(functionId, (id) => ops.callCount({
+            functionId: id,
+            since: timestampOf(range.since),
+            until: timestampOf(range.until ?? Date.now()),
+            bucketSecs: range.bucketSecs ?? DEFAULT_BUCKET_SECS,
+        })),
+        callInfo: (call) => Effect.flatMap(functionId, (id) => ops.callInfo({
+            functionId: id,
+            functionCallId: call.functionCallId,
+        })),
+        autoscaler: () => Effect.flatMap(functionId, (id) => ops.schedulingParams({ functionId: id })).pipe(Effect.map((response) => response.autoscalerConfiguration?.settings)),
+    }),
+}));
+//# sourceMappingURL=ReadFunctionHttp.js.map

package/lib/ReadFunctionHttp.js.map

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

package/lib/ReadQueue.d.ts

@@ -0,0 +1,39 @@
+import * as Binding from "alchemy/Binding";
+import type * as Effect from "effect/Effect";
+import type { Queue } from "./Queue.ts";
+import type { ReadQueueClient } from "./QueueClient.ts";
+export type { ReadQueueClient } from "./QueueClient.ts";
+/**
+ * Take items from a Modal Queue from any runtime: take (removes), peek and len. Items are JSON.
+ *
+ * ### Bind a queue
+ * **Example:** From a Cloudflare Worker
+ * ```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 queue = yield* Modal.ReadQueue(Jobs);
+ *     return {
+ *       fetch: Effect.gen(function* () {
+ *         const [job] = yield* queue.take({ timeout: "5 seconds" });
+ *         return yield* HttpServerResponse.json(job ?? null);
+ *       }).pipe(Effect.orDie),
+ *     };
+ *   }).pipe(Effect.provide(Modal.ReadQueueHttp)),
+ * ) {}
+ * ```
+ *
+ * @binding
+ * @product Queue
+ */
+export interface ReadQueue extends Binding.Service<ReadQueue, "Modal.ReadQueue", (queue: Queue) => Effect.Effect<ReadQueueClient>> {
+}
+export declare const ReadQueue: ReadQueue;
+//# sourceMappingURL=ReadQueue.d.ts.map

package/lib/ReadQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadQueue.d.ts","sources":["../src/ReadQueue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,SAAU,SAAQ,OAAO,CAAC,OAAO,CAChD,SAAS,EACT,iBAAiB,EACjB,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CACjD;CAAG;AAEJ,eAAO,MAAM,SAAS,WAAgD,CAAC"}

package/lib/ReadQueue.js

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

package/lib/ReadQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadQueue.js","sources":["../src/ReadQueue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AA2C3C,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAY,iBAAiB,CAAC,CAAC"}

package/lib/ReadQueueHttp.d.ts

@@ -0,0 +1,12 @@
+import * as Layer from "effect/Layer";
+import { ReadQueue } from "./ReadQueue.ts";
+/**
+ * {@link ReadQueue} over Modal's API. Grants the host's identity (a scoped
+ * `Modal.ServiceUser`) the `contributor` role on the queue's environment.
+ *
+ * @layer
+ * @product Queue
+ * @provides Modal.ReadQueue
+ */
+export declare const ReadQueueHttp: Layer.Layer<ReadQueue, never, never>;
+//# sourceMappingURL=ReadQueueHttp.d.ts.map

package/lib/ReadQueueHttp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadQueueHttp.d.ts","sources":["../src/ReadQueueHttp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,sCAWzB,CAAC"}

package/lib/ReadQueueHttp.js

@@ -0,0 +1,23 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { makeModalBinding } from "./BindingHttp.js";
+import { QueueOps, makeReadQueueClient } from "./QueueClient.js";
+import { ReadQueue } from "./ReadQueue.js";
+/**
+ * {@link ReadQueue} over Modal's API. Grants the host's identity (a scoped
+ * `Modal.ServiceUser`) the `contributor` role on the queue's environment.
+ *
+ * @layer
+ * @product Queue
+ * @provides Modal.ReadQueue
+ */
+export const ReadQueueHttp = Layer.effect(ReadQueue, makeModalBinding({
+    tag: "Modal.ReadQueue",
+    operations: QueueOps,
+    role: "contributor",
+    make: Effect.fn(function* (queue, ops) {
+        const queueId = yield* queue.queueId;
+        return makeReadQueueClient(queueId, ops);
+    }),
+}));
+//# sourceMappingURL=ReadQueueHttp.js.map

package/lib/ReadQueueHttp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadQueueHttp.js","sources":["../src/ReadQueueHttp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CACvC,SAAS,EACT,gBAAgB,CAAC;IACf,GAAG,EAAE,iBAAiB;IACtB,UAAU,EAAE,QAAQ;IACpB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAY,EAAE,GAAG;QAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QACrC,OAAO,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC,CAAC;CACH,CAAC,CACH,CAAC"}

package/lib/ReadServer.d.ts

@@ -0,0 +1,72 @@
+import type * as server from "@distilled.cloud/modal/server";
+import * as Binding from "alchemy/Binding";
+import type { RuntimeContext } from "alchemy/RuntimeContext";
+import type * as Effect from "effect/Effect";
+import type { FunctionLookupError } from "./FunctionTarget.ts";
+import type { OpError } from "./internal.ts";
+import type { TimeRange } from "./ReadFunction.ts";
+import type { ReadServerOps } from "./ReadServerHttp.ts";
+import type { Server } from "./Server.ts";
+/** One request a Server handled. */
+export interface ServerRequest {
+    readonly route: string | undefined;
+    readonly timestamp: string | undefined;
+    readonly containerId: string | undefined;
+    readonly durationSeconds: number | undefined;
+    readonly status: number | undefined;
+}
+/** A container serving a Server's requests. */
+export interface ServerContainer {
+    readonly containerId: string;
+    readonly host: string | undefined;
+    readonly port: number | undefined;
+}
+/** Observe a Server: requests, status codes, latency and containers. */
+export interface ServerReader {
+    /** Request counts by status code, latency percentiles and inference stats over a time range. */
+    stats(range: TimeRange & {
+        readonly containerId?: string;
+    }): Effect.Effect<server.ServerGetTimeRangeStatsResponse, FunctionLookupError | OpError<ReadServerOps, "stats">, RuntimeContext>;
+    /**
+     * Requests the Server handled: the most recent `limit` (newest first, last
+     * seven days), or those in a time range (oldest first).
+     */
+    requests(query: {
+        readonly limit: number;
+    } | TimeRange): Effect.Effect<ReadonlyArray<ServerRequest>, FunctionLookupError | OpError<ReadServerOps, "requests">, RuntimeContext>;
+    /** Requests per time bucket. */
+    requestCount(range: TimeRange & {
+        readonly bucketSecs?: number;
+    }): Effect.Effect<server.ServerCountRequestsResponse, FunctionLookupError | OpError<ReadServerOps, "requestCount">, RuntimeContext>;
+    /** Metric series (`containers`, `requests`) over a time range. */
+    metrics(range: TimeRange & {
+        readonly bucketSecs?: number;
+        readonly groups?: ReadonlyArray<string>;
+    }): Effect.Effect<server.ServerGetMetricsResponse, FunctionLookupError | OpError<ReadServerOps, "metrics">, RuntimeContext>;
+    /** Containers registered to serve requests right now. */
+    containers(): Effect.Effect<ReadonlyArray<ServerContainer>, FunctionLookupError | OpError<ReadServerOps, "containers">, RuntimeContext>;
+}
+/**
+ * Read a `Modal.Server`'s traffic from any runtime: request log, status
+ * codes, latency percentiles, metric series and live containers.
+ *
+ * ### Error rate
+ * **Example:** 5xx responses in the last ten minutes
+ * ```typescript
+ * const api = yield* Modal.ReadServer(Api);
+ * const stats = yield* api.stats({ since: new Date(Date.now() - 600_000) });
+ * ```
+ *
+ * ### Recent requests
+ * **Example:** The last 20 requests
+ * ```typescript
+ * const recent = yield* api.requests({ limit: 20 });
+ * ```
+ *
+ * @binding
+ * @product Server
+ */
+export interface ReadServer extends Binding.Service<ReadServer, "Modal.ReadServer", (server: Server) => Effect.Effect<ServerReader>> {
+}
+export declare const ReadServer: ReadServer;
+//# sourceMappingURL=ReadServer.d.ts.map

package/lib/ReadServer.d.ts.map

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

package/lib/ReadServer.js

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

package/lib/ReadServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadServer.js","sources":["../src/ReadServer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAgG3C,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAa,kBAAkB,CAAC,CAAC"}

package/lib/ReadServerHttp.d.ts

@@ -0,0 +1,25 @@
+import * as flash from "@distilled.cloud/modal/flash";
+import * as server from "@distilled.cloud/modal/server";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { ReadServer } from "./ReadServer.ts";
+/** The operations the client calls, resolved by `ModalBindings.withCredentials`. */
+declare const ReadServerOps: Effect.Effect<{
+    readonly stats: (input: server.ServerGetTimeRangeStatsRequest) => Effect.Effect<server.ServerGetTimeRangeStatsResponse, server.ServerGetTimeRangeStatsError, never>;
+    readonly requests: (input: server.FetchServerRequestRequest) => Effect.Effect<server.FetchServerRequestResponse, server.FetchServerRequestError, never>;
+    readonly requestCount: (input: server.ServerCountRequestsRequest) => Effect.Effect<server.ServerCountRequestsResponse, flash.ModalOpError, never>;
+    readonly metrics: (input: server.ServerGetMetricsRequest) => Effect.Effect<server.ServerGetMetricsResponse, flash.ModalOpError, never>;
+    readonly containers: (input: flash.ListFlashContainerRequest) => Effect.Effect<flash.ListFlashContainerResponse, flash.ModalOpError, never>;
+}, never, import("./internal.ts").OperationServices>;
+export type ReadServerOps = Effect.Success<typeof ReadServerOps>;
+/**
+ * {@link ReadServer} over Modal's API. Grants the host's identity (a scoped
+ * `Modal.ServiceUser`) the `viewer` role on the server's environment.
+ *
+ * @layer
+ * @product Server
+ * @provides Modal.ReadServer
+ */
+export declare const ReadServerHttp: Layer.Layer<ReadServer, never, never>;
+export {};
+//# sourceMappingURL=ReadServerHttp.d.ts.map

package/lib/ReadServerHttp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadServerHttp.d.ts","sources":["../src/ReadServerHttp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,8BAA8B,CAAC;AACtD,OAAO,KAAK,MAAM,MAAM,+BAA+B,CAAC;AACxD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAqB,MAAM,iBAAiB,CAAC;AAGhE,oFAAoF;AACpF,QAAA,MAAM,aAAa;;;;;;oDAMjB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,aAAa,CAAC,CAAC;AAEjE;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,uCAwE1B,CAAC"}