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

package/lib/Railway/Up.js

@@ -0,0 +1,77 @@
+/**
+ * Railway CLI `up` equivalent: POST a gzipped Docker context to
+ * backboard `/project/:id/environment/:id/up`. Railway builds the
+ * generated Dockerfile; Alchemy never pushes an image.
+ */
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+import * as HttpClientRequest from "effect/unstable/http/HttpClientRequest";
+import { RailwayEnvironment } from "./Environment.js";
+export class DeployUploadFailed extends Data.TaggedError("Railway.DeployUploadFailed") {
+}
+const parseUpResponse = (value) => {
+    if (value === null || typeof value !== "object")
+        return undefined;
+    const rec = value;
+    if (typeof rec.deploymentId !== "string" || rec.deploymentId.length === 0) {
+        return undefined;
+    }
+    return {
+        deploymentId: rec.deploymentId,
+        url: typeof rec.url === "string" ? rec.url : "",
+        logsUrl: typeof rec.logsUrl === "string" ? rec.logsUrl : "",
+        deploymentDomain: typeof rec.deploymentDomain === "string" ? rec.deploymentDomain : "",
+    };
+};
+const uploadUrl = (input) => {
+    const base = input.apiBaseUrl.replace(/\/+$/, "");
+    const url = new URL(`${base}/project/${input.projectId}/environment/${input.environmentId}/up`);
+    url.searchParams.set("serviceId", input.serviceId);
+    if (input.message !== undefined && input.message.length > 0) {
+        url.searchParams.set("message", input.message);
+    }
+    return url.toString();
+};
+/**
+ * Upload a gzipped tar of a generated Docker context. Railway builds
+ * and deploys it. Same contract as `railway up`.
+ */
+export const uploadDeployTarball = Effect.fn(function* (input) {
+    const env = yield* yield* RailwayEnvironment;
+    const http = yield* HttpClient.HttpClient;
+    const token = Redacted.value(env.token);
+    const url = uploadUrl({
+        apiBaseUrl: env.apiBaseUrl,
+        projectId: input.projectId,
+        environmentId: input.environmentId,
+        serviceId: input.serviceId,
+        message: input.message,
+    });
+    let request = HttpClientRequest.post(url).pipe(HttpClientRequest.bodyUint8Array(input.tarball, "application/gzip"));
+    request =
+        env.tokenKind === "project"
+            ? request.pipe(HttpClientRequest.setHeader("Project-Access-Token", token))
+            : request.pipe(HttpClientRequest.bearerToken(token));
+    const response = yield* http.execute(request);
+    if (response.status !== 200) {
+        const body = yield* response.text.pipe(Effect.orElseSucceed(() => ""));
+        return yield* new DeployUploadFailed({
+            status: response.status,
+            message: body.length > 0
+                ? body
+                : `Failed to upload code with status ${String(response.status)}`,
+        });
+    }
+    const json = yield* response.json;
+    const parsed = parseUpResponse(json);
+    if (parsed === undefined) {
+        return yield* new DeployUploadFailed({
+            status: response.status,
+            message: "Railway /up did not return a deploymentId",
+        });
+    }
+    return parsed;
+});
+//# sourceMappingURL=Up.js.map

package/lib/Railway/Up.js.map

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

package/lib/Railway/Usage.d.ts

@@ -0,0 +1,248 @@
+import type { EstimatedUsageResultItem, MetricMeasurement, MetricTag, UsageResultItem } from "@distilled.cloud/railway";
+import * as railway from "@distilled.cloud/railway";
+import * as Effect from "effect/Effect";
+import * as Provider from "../Provider.ts";
+import { Resource } from "../Resource.ts";
+import { RailwayEnvironment } from "./Environment.ts";
+import type { Providers } from "./Providers.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>;
+export type { EstimatedUsageResultItem, MetricMeasurement, MetricTag, UsageResultItem, };
+/**
+ * Workspace identity a usage limit applies to. Accepts a
+ * `Railway.Project` (`workspaceId`), `{ workspaceId }`, or `{ id }`.
+ */
+export type UsageLimitWorkspace = {
+    readonly workspaceId?: string;
+    readonly id?: string;
+};
+/**
+ * Project whose workspace a usage limit applies to. Accepts a
+ * `Railway.Project` or a `{ workspaceId, projectId? }` stub.
+ */
+export type UsageLimitProject = {
+    readonly workspaceId: string;
+    readonly projectId?: string;
+};
+/**
+ * Dollar cap passed to `usageLimitSet`. A number is the soft limit.
+ */
+export type UsageLimitAmount = {
+    readonly softLimitDollars: number;
+    readonly hardLimitDollars?: number;
+};
+export interface UsageQuery {
+    /**
+     * Project to query. Accepts a project id, a `Railway.Project`, or a
+     * `{ projectId }` stub. Omit for workspace-wide usage.
+     */
+    project?: string | {
+        readonly projectId: string;
+    };
+    /**
+     * Workspace to query. Accepts a workspace id, `{ workspaceId }` /
+     * `{ id }`, or a `Railway.Project`. Defaults to the current token
+     * workspace.
+     */
+    workspace?: string | UsageLimitWorkspace;
+    /**
+     * Measurements to aggregate (`CPU_USAGE`, `MEMORY_USAGE_GB`, …).
+     */
+    measurements: ReadonlyArray<MetricMeasurement>;
+    /**
+     * Inclusive start of the window (RFC3339). Omit for the current
+     * billing period of the project owner.
+     */
+    startDate?: string;
+    /**
+     * Inclusive end of the window (RFC3339). Omit for now.
+     */
+    endDate?: string;
+    /**
+     * Tags to group by (`PROJECT_ID`, `SERVICE_ID`, …). Default is the
+     * whole project / workspace.
+     */
+    groupBy?: ReadonlyArray<MetricTag>;
+    /**
+     * Include deleted projects in the aggregation.
+     *
+     * @default false
+     */
+    includeDeleted?: boolean;
+}
+export interface EstimatedUsageQuery {
+    /**
+     * Project to estimate. Accepts a project id, a `Railway.Project`, or a
+     * `{ projectId }` stub. Omit for workspace-wide estimates.
+     */
+    project?: string | {
+        readonly projectId: string;
+    };
+    /**
+     * Workspace to estimate. Defaults to the current token workspace.
+     */
+    workspace?: string | UsageLimitWorkspace;
+    /**
+     * Measurements to estimate (`CPU_USAGE`, `MEMORY_USAGE_GB`, …).
+     */
+    measurements: ReadonlyArray<MetricMeasurement>;
+    /**
+     * Include deleted projects in the estimate.
+     *
+     * @default false
+     */
+    includeDeleted?: boolean;
+}
+export interface UsageLimitProps {
+    /**
+     * Workspace whose customer this limit applies to. Accepts a
+     * `Railway.Project`, `{ workspaceId }`, or `{ id }`. Defaults to the
+     * current token's workspace. Changing it to a different workspace
+     * replaces the limit.
+     */
+    workspace?: Ref<UsageLimitWorkspace>;
+    /**
+     * Project whose workspace this limit applies to. Alternative to
+     * `workspace`. Changing it to a project in a different workspace
+     * replaces the limit.
+     */
+    project?: Ref<UsageLimitProject>;
+    /**
+     * Dollar cap. A number is `softLimitDollars`. Pass
+     * `{ softLimitDollars, hardLimitDollars }` for both. Updates in place
+     * via `usageLimitSet`.
+     */
+    limit: number | UsageLimitAmount;
+}
+export type UsageLimit = Resource<"Railway.UsageLimit", UsageLimitProps, {
+    /** Railway usage-limit id. */
+    usageLimitId: string;
+    /** Stripe / Railway customer id the cap is set on. */
+    customerId: string;
+    /** Workspace the customer belongs to. */
+    workspaceId: string;
+    /** Project used to resolve the workspace, if one was passed. */
+    projectId: string | undefined;
+    /** Soft dollar cap (`usageLimitSet.softLimitDollars`). */
+    softLimitDollars: number;
+    /** Hard dollar cap, if set. */
+    hardLimitDollars: number | undefined;
+    /** Whether current spend is over the soft cap. */
+    isOverLimit: boolean;
+}, never, Providers>;
+/**
+ * Billing usage for a project, workspace, or the current user.
+ *
+ * Pass `measurements`. Omit `startDate` / `endDate` for the current
+ * billing period. Omit `project` for the current workspace.
+ *
+ * @example Current workspace CPU
+ * ```typescript
+ * const rows = yield* Railway.usage({
+ *   measurements: ["CPU_USAGE"],
+ * });
+ * ```
+ *
+ * @example Project window
+ * ```typescript
+ * const rows = yield* Railway.usage({
+ *   project: site,
+ *   measurements: ["CPU_USAGE", "MEMORY_USAGE_GB"],
+ *   startDate: "2026-01-01T00:00:00.000Z",
+ *   endDate: "2026-01-31T23:59:59.000Z",
+ * });
+ * ```
+ */
+export declare const usage: (query: UsageQuery) => Effect.Effect<railway.UsageResultList, import("./Environment.ts").RailwayWorkspaceNotFound | railway.RailwayOpError, railway.RailwayOpContext>;
+/** Catalog helper. Alias of {@link usage}. */
+export declare const Usage: (query: UsageQuery) => Effect.Effect<railway.UsageResultList, import("./Environment.ts").RailwayWorkspaceNotFound | railway.RailwayOpError, railway.RailwayOpContext>;
+/**
+ * Estimated total cost at the end of the current billing cycle.
+ *
+ * @example Workspace estimate
+ * ```typescript
+ * const rows = yield* Railway.estimatedUsage({
+ *   measurements: ["CPU_USAGE"],
+ * });
+ * ```
+ */
+export declare const estimatedUsage: (query: EstimatedUsageQuery) => Effect.Effect<railway.EstimatedUsageResultList, import("./Environment.ts").RailwayWorkspaceNotFound | railway.RailwayOpError, railway.RailwayOpContext>;
+declare const UsageLimitResource: import("../Resource.ts").ResourceClass<UsageLimit>;
+/**
+ * A Railway.UsageLimit is a soft/hard dollar cap on a workspace
+ * customer. One limit per customer. `usageLimitRemove` is idempotent.
+ *
+ * @see https://docs.railway.com/reference/pricing
+ *
+ * ### Query usage
+ * {@link usage} is a catalog helper — not a resource. It returns
+ * aggregated rows for the current workspace (or a project).
+ *
+ * **Example:** Workspace usage
+ * ```typescript
+ * const rows = yield* Railway.usage({
+ *   measurements: ["CPU_USAGE", "MEMORY_USAGE_GB"],
+ * });
+ * ```
+ *
+ * ### Set a limit
+ * Omit `workspace` / `project` to cap the current token workspace. A
+ * number is the soft dollar cap.
+ *
+ * **Example:** Soft cap
+ * ```typescript
+ * const cap = yield* Railway.UsageLimit("SpendCap", {
+ *   limit: 50,
+ * });
+ * ```
+ *
+ * **Example:** Soft and hard
+ * ```typescript
+ * const cap = yield* Railway.UsageLimit("SpendCap", {
+ *   project: site,
+ *   limit: { softLimitDollars: 50, hardLimitDollars: 100 },
+ * });
+ * ```
+ *
+ * :::caution[Changing `workspace` or `project` to another workspace replaces the limit]
+ * The cap is removed from the old customer, then set on the new one.
+ * :::
+ *
+ * ### Module-scope declarations
+ * Resource-valued props accept the resource or an Effect producing it.
+ *
+ * **Example:** Module-scope limit
+ * ```typescript
+ * // src/billing.ts
+ * import * as Railway from "alchemy/Railway";
+ *
+ * export const Site = Railway.Project("Site");
+ * export const SpendCap = Railway.UsageLimit("SpendCap", {
+ *   project: Site,
+ *   limit: 50,
+ * });
+ * ```
+ *
+ * @resource
+ */
+export declare const UsageLimit: typeof UsageLimitResource;
+declare const UsageLimitNotCreated_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.UsageLimitNotCreated";
+} & Readonly<A>;
+export declare class UsageLimitNotCreated extends UsageLimitNotCreated_base<{
+    customerId: string;
+    workspaceId: string;
+}> {
+}
+declare const UsageLimitWorkspaceNotFound_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.UsageLimitWorkspaceNotFound";
+} & Readonly<A>;
+export declare class UsageLimitWorkspaceNotFound extends UsageLimitWorkspaceNotFound_base<{
+    workspaceId: string;
+}> {
+}
+export declare const UsageLimitProvider: () => import("effect/Layer").Layer<Provider.Provider<UsageLimit>, never, RailwayEnvironment | railway.RailwayOpContext>;
+//# sourceMappingURL=Usage.d.ts.map

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

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

package/lib/Railway/Usage.js

@@ -0,0 +1,337 @@
+import * as railway from "@distilled.cloud/railway";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Schedule from "effect/Schedule";
+import { isResolved } from "../Diff.js";
+import * as Provider from "../Provider.js";
+import { Resource } from "../Resource.js";
+import { RailwayEnvironment, resolveWorkspace } from "./Environment.js";
+const projectIdOf = (value) => {
+    if (typeof value === "string" && value.length > 0)
+        return value;
+    if (value === null || typeof value !== "object")
+        return undefined;
+    const rec = value;
+    return typeof rec.projectId === "string" && rec.projectId.length > 0
+        ? rec.projectId
+        : undefined;
+};
+const workspaceIdOf = (value) => {
+    if (typeof value === "string" && value.length > 0)
+        return value;
+    if (value === null || typeof value !== "object")
+        return undefined;
+    const rec = value;
+    if (typeof rec.workspaceId === "string" && rec.workspaceId.length > 0) {
+        return rec.workspaceId;
+    }
+    if (typeof rec.id === "string" && rec.id.length > 0) {
+        return rec.id;
+    }
+    return undefined;
+};
+const parseLimit = (limit) => {
+    if (typeof limit === "number") {
+        return { softLimitDollars: limit };
+    }
+    return {
+        softLimitDollars: limit.softLimitDollars,
+        ...(limit.hardLimitDollars !== undefined
+            ? { hardLimitDollars: limit.hardLimitDollars }
+            : {}),
+    };
+};
+/**
+ * Billing usage for a project, workspace, or the current user.
+ *
+ * Pass `measurements`. Omit `startDate` / `endDate` for the current
+ * billing period. Omit `project` for the current workspace.
+ *
+ * @example Current workspace CPU
+ * ```typescript
+ * const rows = yield* Railway.usage({
+ *   measurements: ["CPU_USAGE"],
+ * });
+ * ```
+ *
+ * @example Project window
+ * ```typescript
+ * const rows = yield* Railway.usage({
+ *   project: site,
+ *   measurements: ["CPU_USAGE", "MEMORY_USAGE_GB"],
+ *   startDate: "2026-01-01T00:00:00.000Z",
+ *   endDate: "2026-01-31T23:59:59.000Z",
+ * });
+ * ```
+ */
+export const usage = Effect.fn(function* (query) {
+    const projectId = projectIdOf(query.project);
+    const workspaceId = workspaceIdOf(query.workspace) ?? (yield* resolveWorkspace()).id;
+    const rows = yield* railway.usage({
+        measurements: [...query.measurements],
+        workspaceId,
+        ...(projectId !== undefined ? { projectId } : {}),
+        ...(query.startDate !== undefined ? { startDate: query.startDate } : {}),
+        ...(query.endDate !== undefined ? { endDate: query.endDate } : {}),
+        ...(query.groupBy !== undefined ? { groupBy: [...query.groupBy] } : {}),
+        ...(query.includeDeleted !== undefined
+            ? { includeDeleted: query.includeDeleted }
+            : {}),
+    });
+    return rows ?? [];
+});
+/** Catalog helper. Alias of {@link usage}. */
+export const Usage = usage;
+/**
+ * Estimated total cost at the end of the current billing cycle.
+ *
+ * @example Workspace estimate
+ * ```typescript
+ * const rows = yield* Railway.estimatedUsage({
+ *   measurements: ["CPU_USAGE"],
+ * });
+ * ```
+ */
+export const estimatedUsage = Effect.fn(function* (query) {
+    const projectId = projectIdOf(query.project);
+    const workspaceId = workspaceIdOf(query.workspace) ?? (yield* resolveWorkspace()).id;
+    const rows = yield* railway.estimatedUsage({
+        measurements: [...query.measurements],
+        workspaceId,
+        ...(projectId !== undefined ? { projectId } : {}),
+        ...(query.includeDeleted !== undefined
+            ? { includeDeleted: query.includeDeleted }
+            : {}),
+    });
+    return rows ?? [];
+});
+const resolveUsageLimitProps = (props) => Effect.gen(function* () {
+    const resolved = Effect.isEffect(props) ? yield* props : props;
+    if (globalThis.__ALCHEMY_RUNTIME__)
+        return resolved;
+    const workspace = resolved.workspace === undefined
+        ? undefined
+        : Effect.isEffect(resolved.workspace)
+            ? yield* resolved.workspace
+            : resolved.workspace;
+    const project = resolved.project === undefined
+        ? undefined
+        : Effect.isEffect(resolved.project)
+            ? yield* resolved.project
+            : resolved.project;
+    return { ...resolved, workspace, project };
+});
+const UsageLimitResource = Resource("Railway.UsageLimit");
+/**
+ * A Railway.UsageLimit is a soft/hard dollar cap on a workspace
+ * customer. One limit per customer. `usageLimitRemove` is idempotent.
+ *
+ * @see https://docs.railway.com/reference/pricing
+ *
+ * ### Query usage
+ * {@link usage} is a catalog helper — not a resource. It returns
+ * aggregated rows for the current workspace (or a project).
+ *
+ * **Example:** Workspace usage
+ * ```typescript
+ * const rows = yield* Railway.usage({
+ *   measurements: ["CPU_USAGE", "MEMORY_USAGE_GB"],
+ * });
+ * ```
+ *
+ * ### Set a limit
+ * Omit `workspace` / `project` to cap the current token workspace. A
+ * number is the soft dollar cap.
+ *
+ * **Example:** Soft cap
+ * ```typescript
+ * const cap = yield* Railway.UsageLimit("SpendCap", {
+ *   limit: 50,
+ * });
+ * ```
+ *
+ * **Example:** Soft and hard
+ * ```typescript
+ * const cap = yield* Railway.UsageLimit("SpendCap", {
+ *   project: site,
+ *   limit: { softLimitDollars: 50, hardLimitDollars: 100 },
+ * });
+ * ```
+ *
+ * :::caution[Changing `workspace` or `project` to another workspace replaces the limit]
+ * The cap is removed from the old customer, then set on the new one.
+ * :::
+ *
+ * ### Module-scope declarations
+ * Resource-valued props accept the resource or an Effect producing it.
+ *
+ * **Example:** Module-scope limit
+ * ```typescript
+ * // src/billing.ts
+ * import * as Railway from "alchemy/Railway";
+ *
+ * export const Site = Railway.Project("Site");
+ * export const SpendCap = Railway.UsageLimit("SpendCap", {
+ *   project: Site,
+ *   limit: 50,
+ * });
+ * ```
+ *
+ * @resource
+ */
+export const UsageLimit = Object.assign((id, props) => UsageLimitResource(id, resolveUsageLimitProps(props)), UsageLimitResource);
+export class UsageLimitNotCreated extends Data.TaggedError("Railway.UsageLimitNotCreated") {
+}
+export class UsageLimitWorkspaceNotFound extends Data.TaggedError("Railway.UsageLimitWorkspaceNotFound") {
+}
+const currentWorkspaceId = Effect.fn(function* () {
+    const env = yield* yield* RailwayEnvironment;
+    return env.workspaceId;
+});
+const getWorkspace = (workspaceId) => railway
+    .workspace({ workspaceId })
+    .pipe(Effect.catchTag(["RailwayNotFound", "NotFound"], () => Effect.succeed(undefined)));
+const toAttrs = (limit, fallback) => ({
+    usageLimitId: limit.id,
+    customerId: limit.customerId || fallback.customerId,
+    workspaceId: fallback.workspaceId,
+    projectId: fallback.projectId,
+    softLimitDollars: limit.softLimit,
+    hardLimitDollars: limit.hardLimit ?? undefined,
+    isOverLimit: limit.isOverLimit,
+});
+const observe = Effect.fn(function* (workspaceId) {
+    const workspace = yield* getWorkspace(workspaceId);
+    if (workspace === undefined)
+        return undefined;
+    return {
+        workspace,
+        customerId: workspace.customer.id,
+        limit: workspace.customer.usageLimit ?? undefined,
+    };
+});
+const setLimit = (input) => railway.usageLimitSet({
+    input: {
+        customerId: input.customerId,
+        softLimitDollars: input.softLimitDollars,
+        ...(input.hardLimitDollars !== undefined
+            ? { hardLimitDollars: input.hardLimitDollars }
+            : {}),
+    },
+});
+const resolveScope = Effect.fn(function* (input) {
+    const projectId = projectIdOf(input.news?.project) ??
+        input.output?.projectId ??
+        projectIdOf(input.olds?.project);
+    const workspaceId = workspaceIdOf(input.news?.workspace) ??
+        workspaceIdOf(input.news?.project) ??
+        input.output?.workspaceId ??
+        workspaceIdOf(input.olds?.workspace) ??
+        workspaceIdOf(input.olds?.project) ??
+        (yield* currentWorkspaceId());
+    return { workspaceId, projectId };
+});
+const waitUntilGone = (workspaceId, usageLimitId) => observe(workspaceId).pipe(Effect.map((found) => {
+    if (found?.limit === undefined)
+        return true;
+    return found.limit.id !== usageLimitId;
+}), Effect.repeat({
+    schedule: Schedule.spaced("1 second"),
+    until: (gone) => gone,
+    times: 8,
+}));
+export const UsageLimitProvider = () => Provider.succeed(UsageLimit, {
+    stables: ["usageLimitId", "customerId", "workspaceId"],
+    diff: Effect.fn(function* ({ news, output }) {
+        if (news === undefined || !isResolved(news))
+            return undefined;
+        if (output === undefined)
+            return undefined;
+        const nextWorkspace = workspaceIdOf(news.workspace) ?? workspaceIdOf(news.project);
+        if (nextWorkspace !== undefined && nextWorkspace !== output.workspaceId) {
+            return { action: "replace" };
+        }
+        return undefined;
+    }),
+    read: Effect.fn(function* ({ olds, output }) {
+        const { workspaceId, projectId } = yield* resolveScope({
+            olds,
+            output,
+        });
+        const found = yield* observe(workspaceId);
+        if (found?.limit === undefined)
+            return undefined;
+        return toAttrs(found.limit, {
+            workspaceId,
+            customerId: found.customerId,
+            projectId,
+        });
+    }),
+    list: Effect.fn(function* () {
+        const workspaceId = yield* currentWorkspaceId();
+        const found = yield* observe(workspaceId);
+        if (found?.limit === undefined)
+            return [];
+        return [
+            toAttrs(found.limit, {
+                workspaceId,
+                customerId: found.customerId,
+            }),
+        ];
+    }),
+    reconcile: Effect.fn(function* ({ news, output }) {
+        const props = news ?? {};
+        const { workspaceId, projectId } = yield* resolveScope({
+            news: props,
+            output,
+        });
+        const desired = parseLimit(props.limit ?? output?.softLimitDollars ?? 0);
+        let found = yield* observe(workspaceId);
+        if (found === undefined) {
+            return yield* new UsageLimitWorkspaceNotFound({ workspaceId });
+        }
+        const observed = found.limit;
+        const hardChanged = desired.hardLimitDollars !== undefined
+            ? (observed?.hardLimit ?? undefined) !== desired.hardLimitDollars
+            : observed?.hardLimit != null;
+        const needsSet = observed === undefined ||
+            observed.softLimit !== desired.softLimitDollars ||
+            hardChanged;
+        if (needsSet) {
+            yield* setLimit({
+                customerId: found.customerId,
+                softLimitDollars: desired.softLimitDollars,
+                ...(desired.hardLimitDollars !== undefined
+                    ? { hardLimitDollars: desired.hardLimitDollars }
+                    : observed?.hardLimit != null
+                        ? { hardLimitDollars: null }
+                        : {}),
+            }).pipe(Effect.catchTag("RailwayValidationError", () => Effect.void));
+            found = yield* observe(workspaceId);
+        }
+        if (found?.limit === undefined) {
+            return yield* new UsageLimitNotCreated({
+                customerId: found?.customerId ?? output?.customerId ?? "",
+                workspaceId,
+            });
+        }
+        return toAttrs(found.limit, {
+            workspaceId,
+            customerId: found.customerId,
+            projectId,
+        });
+    }),
+    delete: Effect.fn(function* ({ output }) {
+        const customerId = output.customerId;
+        const workspaceId = output.workspaceId;
+        if (customerId.length === 0)
+            return;
+        yield* railway
+            .usageLimitRemove({ input: { customerId } })
+            .pipe(Effect.catchTag(["RailwayNotFound", "NotFound"], () => Effect.void));
+        if (workspaceId.length > 0 && output.usageLimitId.length > 0) {
+            yield* waitUntilGone(workspaceId, output.usageLimitId);
+        }
+    }),
+});
+//# sourceMappingURL=Usage.js.map