alchemy 2.0.0-beta.74 → 2.0.0-beta.76

package/lib/Railway/DeleteObjectHttp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeleteObjectHttp.js","sourceRoot":"","sources":["../../src/Railway/DeleteObjectHttp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAC1C,YAAY,EACZ,oBAAoB,CAAC;IACnB,GAAG,EAAE,sBAAsB;IAC3B,SAAS,EAAE,EAAE,CAAC,YAAY;CAC3B,CAAC,CACH,CAAC"}

package/lib/Railway/Environment.d.ts

@@ -0,0 +1,64 @@
+import type { Config } from "@distilled.cloud/railway";
+import { Credentials } from "@distilled.cloud/railway";
+import * as railway from "@distilled.cloud/railway";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+declare const RailwayWorkspaceNotFound_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: "Railway.WorkspaceNotFound";
+} & Readonly<A>;
+export declare class RailwayWorkspaceNotFound extends RailwayWorkspaceNotFound_base<{
+    message: string;
+}> {
+}
+/**
+ * Default Railway workspace for the current token
+ * (`me.workspace ?? me.workspaces[0]`). Not a resource — the Environment
+ * *resource* is a project-scoped deploy environment.
+ */
+export type RailwayWorkspace = {
+    readonly id: string;
+    readonly name: string;
+};
+/**
+ * Fully-resolved Railway environment for a stack.
+ *
+ * `{ token, tokenKind, apiBaseUrl }` comes from distilled `Credentials`.
+ * `workspaceId` is the current token's default workspace
+ * (`me.workspace ?? me.workspaces[0]`), cached for the process. Resolve
+ * it inside lifecycle operations with `RailwayEnvironment.current`.
+ */
+export type RailwayEnvironmentShape = Config & {
+    readonly workspaceId: string;
+};
+declare const RailwayEnvironment_base: Context.ServiceClass<RailwayEnvironment, "Railway::Environment", Effect.Effect<RailwayEnvironmentShape, never, never>>;
+export declare class RailwayEnvironment extends RailwayEnvironment_base {
+    static current: Effect.Effect<RailwayEnvironmentShape, never, RailwayEnvironment>;
+    readonly kind: "Environment";
+}
+/**
+ * Discover the current token's default workspace.
+ *
+ * Personal account tokens answer `me.workspace ?? me.workspaces[0]`.
+ * Workspace/team tokens reject `me` with {@link RailwayForbidden}
+ * (`Not Authorized`); fall back to `apiToken.workspaces[0]`.
+ */
+export declare const resolveWorkspace: () => Effect.Effect<{
+    id: string;
+    name: string;
+}, railway.BadGateway | railway.BadRequest | railway.Conflict | railway.Forbidden | railway.GatewayTimeout | import("effect/unstable/http/HttpClientError").HttpClientError | railway.InternalServerError | railway.Locked | railway.NotFound | railway.RailwayForbidden | railway.RailwayInternalError | railway.RailwayNotFound | railway.RailwayParseError | railway.RailwayPlanLimitExceeded | railway.RailwayRateLimited | railway.RailwayServiceDomainCreateFailed | railway.RailwayUnauthenticated | railway.RailwayValidationError | RailwayWorkspaceNotFound | railway.ServiceUnavailable | railway.TooManyRequests | railway.Unauthorized | railway.UnknownRailwayError | railway.UnprocessableEntity, railway.RailwayOpContext>;
+/**
+ * Current token workspace id (`me.workspace ?? me.workspaces[0]`).
+ */
+export declare const resolveWorkspaceId: () => Effect.Effect<string, railway.BadGateway | railway.BadRequest | railway.Conflict | railway.Forbidden | railway.GatewayTimeout | import("effect/unstable/http/HttpClientError").HttpClientError | railway.InternalServerError | railway.Locked | railway.NotFound | railway.RailwayForbidden | railway.RailwayInternalError | railway.RailwayNotFound | railway.RailwayParseError | railway.RailwayPlanLimitExceeded | railway.RailwayRateLimited | railway.RailwayServiceDomainCreateFailed | railway.RailwayUnauthenticated | railway.RailwayValidationError | RailwayWorkspaceNotFound | railway.ServiceUnavailable | railway.TooManyRequests | railway.Unauthorized | railway.UnknownRailwayError | railway.UnprocessableEntity, railway.RailwayOpContext>;
+/**
+ * Build a `RailwayEnvironment` layer from the distilled `Credentials`
+ * service. Provide this after `Credentials.fromAuthProvider()`.
+ *
+ * `workspaceId` is resolved from `me` and cached so Project.list /
+ * Catalog do not re-hit `me` on every call.
+ */
+export declare const fromCredentials: () => Layer.Layer<RailwayEnvironment, never, Credentials | HttpClient.HttpClient>;
+export {};
+//# sourceMappingURL=Environment.d.ts.map

package/lib/Railway/Environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Environment.d.ts","sourceRoot":"","sources":["../../src/Railway/Environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,UAAU,MAAM,iCAAiC,CAAC;;;;AAE9D,qBAAa,wBAAyB,SAAQ,8BAE5C;IACA,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;CAAG;AAEL;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;;AAEF,qBAAa,kBAAmB,SAAQ,uBAGb;IACzB,MAAM,CAAC,OAAO,oEAAwC;IACtD,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;CACxC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;;0sBA0B3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB,quBAG7B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,mFAyBzB,CAAC"}

package/lib/Railway/Environment.js

@@ -0,0 +1,63 @@
+import { Credentials } from "@distilled.cloud/railway";
+import * as railway from "@distilled.cloud/railway";
+import * as Context from "effect/Context";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+export class RailwayWorkspaceNotFound extends Data.TaggedError("Railway.WorkspaceNotFound") {
+}
+export class RailwayEnvironment extends Context.Service()("Railway::Environment") {
+    static current = RailwayEnvironment.use((env) => env);
+    kind = "Environment";
+}
+/**
+ * Discover the current token's default workspace.
+ *
+ * Personal account tokens answer `me.workspace ?? me.workspaces[0]`.
+ * Workspace/team tokens reject `me` with {@link RailwayForbidden}
+ * (`Not Authorized`); fall back to `apiToken.workspaces[0]`.
+ */
+export const resolveWorkspace = Effect.fn(function* () {
+    const fromMe = yield* railway.me({}).pipe(Effect.map((me) => me.workspace ?? me.workspaces[0]), Effect.catchTag(["RailwayForbidden", "RailwayUnauthenticated"], () => Effect.succeed(undefined)));
+    if (fromMe !== undefined && fromMe.id.length > 0) {
+        return {
+            id: fromMe.id,
+            name: fromMe.name,
+        };
+    }
+    const token = yield* railway.apiToken({});
+    const workspace = token.workspaces[0];
+    if (workspace === undefined || workspace.id.length === 0) {
+        return yield* new RailwayWorkspaceNotFound({
+            message: "Railway current token did not include a workspace. Check RAILWAY_API_TOKEN is an account or workspace token.",
+        });
+    }
+    return {
+        id: workspace.id,
+        name: workspace.name,
+    };
+});
+/**
+ * Current token workspace id (`me.workspace ?? me.workspaces[0]`).
+ */
+export const resolveWorkspaceId = Effect.fn(function* () {
+    const workspace = yield* resolveWorkspace();
+    return workspace.id;
+});
+/**
+ * Build a `RailwayEnvironment` layer from the distilled `Credentials`
+ * service. Provide this after `Credentials.fromAuthProvider()`.
+ *
+ * `workspaceId` is resolved from `me` and cached so Project.list /
+ * Catalog do not re-hit `me` on every call.
+ */
+export const fromCredentials = () => Layer.effect(RailwayEnvironment, Effect.gen(function* () {
+    const creds = yield* Credentials;
+    const http = yield* HttpClient.HttpClient;
+    return yield* creds.pipe(Effect.flatMap((resolved) => resolveWorkspaceId().pipe(Effect.provide(Layer.mergeAll(Layer.succeed(Credentials, creds), Layer.succeed(HttpClient.HttpClient, http))), Effect.map((workspaceId) => ({
+        ...resolved,
+        workspaceId,
+    })))), Effect.orDie, Effect.cached);
+}));
+//# sourceMappingURL=Environment.js.map

package/lib/Railway/Environment.js.map

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

package/lib/Railway/Function.d.ts

@@ -0,0 +1,434 @@
+import * as railway from "@distilled.cloud/railway";
+import * as Effect from "effect/Effect";
+import type * as Redacted from "effect/Redacted";
+import * as FileSystem from "effect/FileSystem";
+import type { InputProps } from "../Input.ts";
+import { Platform, type Main, type MainRpc, type PlatformProps } from "../Platform.ts";
+import * as Provider from "../Provider.ts";
+import type { Resource } from "../Resource.ts";
+import type { ServerHost } from "../Server/Process.ts";
+import { Stack } from "../Stack.ts";
+import { type ServiceBinding } from "./MountVolume.ts";
+import { type Project } from "./Project.ts";
+import type { Providers } from "./Providers.ts";
+import { type RailwayBuildOptions, type RailwayHostRuntimeContext } from "./hosted.ts";
+export { FunctionBundleNotSingleFile } from "./hosted.ts";
+export type { InferEnv } from "./InferEnv.ts";
+/**
+ * A resource-valued prop: the resource itself, or an Effect that produces
+ * it (so `yield* Project(...)` and `Project(...)` both type-check).
+ */
+type Ref<T> = T | Effect.Effect<T, never, Providers>;
+/**
+ * Environment identity a Function is deployed into. Accepts a
+ * `Railway.Project` (its primary environment), a `Railway.Environment`,
+ * or an `{ environmentId }` stub.
+ */
+export type FunctionEnvironment = {
+    readonly environmentId: string;
+};
+/** Canvas Functions run on the Bun function runtime. */
+export declare const FUNCTION_RUNTIME_NAME: "bun";
+/** Start-command prefix the Bun function runtime uses to decode source. */
+export declare const FUNCTION_START_PREFIX = "./run.sh ";
+/**
+ * Canvas Functions are capped at 96KB (the encoded start command, which
+ * includes `./run.sh ` plus standard base64 of the TypeScript file).
+ */
+export declare const FUNCTION_MAX_BYTES: number;
+/**
+ * Railway function-runtime images (`ghcr.io/railwayapp/function-*`).
+ * Canvas Functions are ordinary Services whose `source.image` uses this
+ * prefix — the same check the Railway CLI uses.
+ */
+export declare const isFunctionImage: (image: string | null | undefined) => boolean;
+export interface FunctionProps<Env extends Record<string, any> = Record<string, any>> extends PlatformProps {
+    /**
+     * Parent Railway Project. Accepts a `Railway.Project` or an Effect
+     * that produces one. Changing the Project replaces the Function.
+     */
+    project: Ref<Project>;
+    /**
+     * Environment to deploy the function instance into. Accepts a
+     * `Railway.Project` (primary environment), a `Railway.Environment`, or
+     * `{ environmentId }`. Defaults to the project's primary environment.
+     * Changing it replaces the Function.
+     */
+    environment?: Ref<FunctionEnvironment>;
+    /**
+     * Service name. Unique per Project. If omitted, a unique name is
+     * generated from the stack, stage and logical ID. Changing it updates
+     * in place via `serviceUpdate`.
+     */
+    name?: string;
+    /**
+     * Module entrypoint bundled with rolldown into a **single file** and
+     * deployed as a canvas Function. Typically `import.meta.url`. No
+     * Docker. No registry — that is {@link Service}. Mutually exclusive
+     * with {@link source} / {@link path}.
+     */
+    main?: string;
+    /**
+     * Named export to load from {@link main}.
+     *
+     * @default "default"
+     */
+    handler?: string;
+    /**
+     * Bundler configuration for {@link main}: rolldown `input`/`output`
+     * overrides, plus `install` for packages Railway should `bun install`
+     * from the function's imports (`pg`).
+     */
+    build?: RailwayBuildOptions;
+    /**
+     * Inline TypeScript source (one file). Mutually preferred over
+     * {@link path}. Max 96KB once base64-encoded into the start command.
+     */
+    source?: string;
+    /**
+     * Path to a single TypeScript file (`railway functions new --path`).
+     * Read at plan/reconcile time. Distinct from Effect-native
+     * {@link main}, which bundles first, and from `Service({ main })`,
+     * which pushes a Docker image.
+     */
+    path?: string;
+    /**
+     * Cron expression (`cronSchedule`). Observed as `cronSchedule` /
+     * `nextCronRunAt`. `railway functions new --cron`.
+     */
+    cronSchedule?: string;
+    /**
+     * Create a generated `*.up.railway.app` domain (`--http`). Defaults
+     * to `true` when {@link cronSchedule} is omitted, `false` otherwise.
+     */
+    http?: boolean;
+    /**
+     * Sleep the application when idle (`--serverless` /
+     * `sleepApplication`). Updates in place.
+     */
+    sleepApplication?: boolean;
+    /**
+     * Region for the service instance (`us-west2`, `us-east4`, …). If
+     * omitted, Railway picks the default. Updates in place.
+     */
+    region?: string;
+    /**
+     * Port published on the generated service domain. Passed as
+     * `serviceDomainCreate.targetPort`. Omit to let Railway detect it.
+     */
+    port?: number;
+    /**
+     * Additional environment variables. Merged after binding-injected
+     * `env`. Upserted as service-scoped Railway variables with
+     * `skipDeploys: true`; this Function owns the subsequent deploy.
+     *
+     * On an async Function, {@link InferEnv} types the handler's second
+     * argument from these keys. Railway has no native bindings — every
+     * value is a `string` at runtime (`process.env`).
+     */
+    env?: Env;
+    /**
+     * Private-mesh RPC token. Minted by a child `Alchemy.Random`
+     * (`{logicalId}RpcToken`) and persisted in state. Set automatically.
+     */
+    rpcToken?: Redacted.Redacted<string>;
+}
+export type Function<Env extends Record<string, any> = Record<string, any>> = Resource<"Railway.Function", FunctionProps<Env>, {
+    /** Railway service id. */
+    serviceId: string;
+    /** Physical service name (unique per project). */
+    name: string;
+    /** Parent Railway project id. */
+    projectId: string;
+    /** Environment the instance is deployed in. */
+    environmentId: string;
+    /** Observed function-runtime image. */
+    image: string;
+    /** Function runtime name (`bun`). */
+    runtime: typeof FUNCTION_RUNTIME_NAME;
+    /** Observed cron schedule, if set. */
+    cronSchedule: string | undefined;
+    /** Observed `sleepApplication`. */
+    sleepApplication: boolean | undefined;
+    /** Observed region, if Railway reported one. */
+    region: string | undefined;
+    /** Port published on the generated service domain. */
+    port: number | undefined;
+    /**
+     * Internal DNS name on the default private mesh
+     * (`{name}.railway.internal`). Derived from the service name.
+     */
+    dnsName: string;
+    /**
+     * Shared token for private schemaless RPC. Value of the child
+     * `Alchemy.Random` resource. Packed onto callers by
+     * {@link bindFunction}; never send this to the public internet.
+     */
+    rpcToken: string;
+    /** Public `https://{domain}` URL (`*.up.railway.app`). */
+    url: string | undefined;
+    /** Generated Railway service domain hostname. */
+    domain: string | undefined;
+    /** Railway service domain id. */
+    domainId: string | undefined;
+    /** Latest deployment id, if one exists. */
+    deploymentId: string | undefined;
+    /** Latest deployment status (`SUCCESS`, `DEPLOYING`, …). */
+    deploymentStatus: string | undefined;
+    /** Next cron fire time, if scheduled. */
+    nextCronRunAt: string | undefined;
+    /** Content hash of the TypeScript source. */
+    code: {
+        hash: string;
+    };
+}, ServiceBinding, Providers>;
+export declare const isFunction: (value: unknown) => value is Function;
+export type FunctionServices = ServerHost;
+export type FunctionShape = Main<FunctionServices> & MainRpc<FunctionServices>;
+export type FunctionRuntimeContext = RailwayHostRuntimeContext;
+/**
+ * A Railway.Function is a **single TypeScript file** on Railway's Bun
+ * canvas runtime. No GitHub repo. No Docker. No registry. Alchemy
+ * queries `functionRuntime(bun)`, creates the Service with that image,
+ * and writes the source as `startCommand` (`./run.sh` + base64).
+ *
+ * There are two ways to define a Function. Prefer **async** (`main` +
+ * `export default { fetch }`, no Effect) — Effect-native canvas
+ * Functions pull the Effect runtime into the 96KB encoded start-command
+ * cap and fail {@link FunctionTooLarge} for anything non-trivial. Use
+ * {@link Service} when you need an Effect program or a real image.
+ *
+ * Distinct from Effect-native {@link Service} (`main`), which bundles
+ * with Rolldown and uploads a generated Dockerfile for Railway to
+ * build.
+ *
+ * @see https://docs.railway.com/reference/functions
+ *
+ * ### Async Functions
+ * You don't have to use Effect. Declare the Function with `main`
+ * pointing at a file and **no** `Effect.gen` implementation — Alchemy
+ * bundles that file as-is (no Effect runtime) and deploys it as a
+ * canvas Function. The handler is a plain `async fetch`. Use the `env`
+ * prop to declare variables, and {@link InferEnv} to type the second
+ * argument (Railway bindings are environment variables).
+ *
+ * **Example:** Defining an async Function in your stack
+ * ```typescript
+ * const db = yield* Railway.Postgres("Db", { project: site });
+ *
+ * export const Ping = Railway.Function("Ping", {
+ *   project: site,
+ *   main: "./src/ping.ts",
+ *   env: { DATABASE_URL: db.connectionUri },
+ * });
+ *
+ * export type PingEnv = Railway.InferEnv<typeof Ping>;
+ * ```
+ *
+ * **Example:** Writing the async handler
+ * ```typescript
+ * import type { PingEnv } from "../alchemy.run.ts";
+ *
+ * export default {
+ *   async fetch(_request: Request, env: PingEnv) {
+ *     return new Response(env.DATABASE_URL ? "ok" : "missing");
+ *   },
+ * };
+ * ```
+ *
+ * ### Effect-native Function
+ * A Function is a class. Props describe the canvas Function. The Effect
+ * is the program that runs in it. `main: import.meta.url` is the bundle
+ * entrypoint — Alchemy bundles this file into one JS file and deploys
+ * it. No `registry`. Stay tiny: the encoded start command maxes out at
+ * 96KB (`effect` plus handlers overflows it).
+ *
+ * **Example:** Class + Project + main
+ * ```typescript
+ * export default class Ping extends Railway.Function<Ping>()(
+ *   "Ping",
+ *   {
+ *     project: Site,
+ *     main: import.meta.url,
+ *   },
+ *   Effect.gen(function* () {
+ *     return {
+ *       fetch: Effect.succeed(HttpServerResponse.text("ok")),
+ *     };
+ *   }),
+ * ) {}
+ * ```
+ *
+ * :::caution[Changing `project` replaces the Function]
+ * The Function is created in the new Project. The old Function is deleted.
+ * :::
+ *
+ * ### Inline source
+ * Pass inline `source` (or `path` to a `.ts` file) instead of `main`
+ * when the Function is not an Effect class. Alchemy generates a
+ * `*.up.railway.app` domain unless `http: false` or a cron schedule is
+ * set.
+ *
+ * **Example:** Inline source
+ * ```typescript
+ * const site = yield* Railway.Project("Site");
+ * const ping = yield* Railway.Function("Ping", {
+ *   project: site,
+ *   source: `
+ *     Bun.serve({
+ *       hostname: "0.0.0.0",
+ *       port: Number(process.env.PORT ?? 3000),
+ *       fetch() { return new Response("ok"); },
+ *     });
+ *   `,
+ * });
+ * ```
+ *
+ * ### File path
+ * `path` is the CLI `--path` equivalent. The file is read at
+ * plan/reconcile. Content changes update in place.
+ *
+ * **Example:** Path
+ * ```typescript
+ * const ping = yield* Railway.Function("Ping", {
+ *   project: site,
+ *   path: "./fn.ts",
+ * });
+ * ```
+ *
+ * ### Cron
+ * `cronSchedule` runs the Function on a cron expression (`--cron`).
+ * HTTP domains are skipped unless `http: true` is set explicitly.
+ *
+ * **Example:** Cron schedule
+ * ```typescript
+ * const job = yield* Railway.Function("Cleanup", {
+ *   project: site,
+ *   source: `console.log("tick");`,
+ *   cronSchedule: "0 * * * *",
+ * });
+ * ```
+ *
+ * ### Serverless
+ * `sleepApplication` sleeps the Function when idle (`--serverless`).
+ *
+ * **Example:** Sleep when idle
+ * ```typescript
+ * const ping = yield* Railway.Function("Ping", {
+ *   project: site,
+ *   source: `console.log("hi");`,
+ *   http: false,
+ *   sleepApplication: true,
+ * });
+ * ```
+ *
+ * ### Schemaless RPC
+ * Return methods next to `fetch`. Call `enableRailwayRpc()` in init
+ * (canvas Functions are capped at 96KB; the dispatcher is opt-in).
+ * Another Function or Service binds this class and calls them over
+ * `{name}.railway.internal` with a shared token. Public
+ * `*.up.railway.app` requests to `/__rpc__/*` get 401.
+ *
+ * **Example:** Bind a Function
+ * ```typescript
+ * export default class Query extends Railway.Function<Query>()(
+ *   "Query",
+ *   { project: Site, main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     Railway.enableRailwayRpc();
+ *     return {
+ *       greet: (name: string) => Effect.succeed(`hello ${name}`),
+ *     };
+ *   }),
+ * ) {}
+ *
+ * export default class Api extends Railway.Service<Api>()(
+ *   "Api",
+ *   { project: Site, main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     const query = yield* Railway.bindFunction(Query);
+ *     return {
+ *       fetch: query
+ *         .greet("sam")
+ *         .pipe(Effect.map((greeting) => HttpServerResponse.text(greeting))),
+ *     };
+ *   }),
+ * ) {}
+ * ```
+ *
+ * ### Module-scope declarations
+ * Resource-valued props accept the resource or an Effect producing it.
+ *
+ * **Example:** Module-scope Function
+ * ```typescript
+ * // src/ping.ts
+ * import * as Railway from "alchemy/Railway";
+ *
+ * export const Site = Railway.Project("Site");
+ * export const Ping = Railway.Function("Ping", {
+ *   project: Site,
+ *   source: `console.log("hello");`,
+ *   http: false,
+ * });
+ * ```
+ *
+ * @resource
+ */
+export declare const Function: Platform<Function, FunctionServices, FunctionShape, FunctionRuntimeContext> & {
+    /**
+     * Async (no-impl) constructor — captures the `env` literal so
+     * {@link InferEnv} types the handler's second argument.
+     */
+    <const Env extends Record<string, any>, PropsReq = never>(id: string, props: InputProps<FunctionProps<Env>> | Effect.Effect<InputProps<FunctionProps<Env>>, never, PropsReq>): Effect.Effect<Function<Env>, never, Providers | PropsReq>;
+};
+declare const FunctionNotCreated_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: "Railway.FunctionNotCreated";
+} & Readonly<A>;
+export declare class FunctionNotCreated extends FunctionNotCreated_base<{
+    name: string;
+    projectId: string;
+}> {
+}
+declare const FunctionProjectRequired_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: "Railway.FunctionProjectRequired";
+} & Readonly<A>;
+export declare class FunctionProjectRequired extends FunctionProjectRequired_base<{
+    message: string;
+}> {
+}
+declare const FunctionSourceRequired_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: "Railway.FunctionSourceRequired";
+} & Readonly<A>;
+export declare class FunctionSourceRequired extends FunctionSourceRequired_base<{
+    message: string;
+}> {
+}
+declare const FunctionTooLarge_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: "Railway.FunctionTooLarge";
+} & Readonly<A>;
+export declare class FunctionTooLarge extends FunctionTooLarge_base<{
+    bytes: number;
+    maxBytes: number;
+}> {
+    get message(): string;
+}
+declare const FunctionRuntimeImageMissing_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: "Railway.FunctionRuntimeImageMissing";
+} & Readonly<A>;
+export declare class FunctionRuntimeImageMissing extends FunctionRuntimeImageMissing_base<{
+    message: string;
+}> {
+}
+declare const FunctionDeployFailed_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: "Railway.FunctionDeployFailed";
+} & Readonly<A>;
+export declare class FunctionDeployFailed extends FunctionDeployFailed_base<{
+    serviceId: string;
+    status: string;
+    deploymentId: string | undefined;
+    logs: string;
+}> {
+    get message(): string;
+}
+export declare const FunctionProvider: () => import("effect/Layer").Layer<Provider.Provider<Function<Record<string, any>>>, never, FileSystem.FileSystem | import("effect/Path").Path | import("./Environment.ts").RailwayEnvironment | Stack | import("../Stage.ts").Stage | railway.RailwayOpContext>;
+//# sourceMappingURL=Function.d.ts.map

package/lib/Railway/Function.d.ts.map

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