alchemy 2.0.0-beta.65 → 2.0.0-beta.66

package/lib/Cloudflare/Workers/WorkerProvider.d.ts

@@ -1,9 +1,12 @@
+import * as Config from "effect/Config";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
 import * as Path from "effect/Path";
 import * as Artifacts from "../../Artifacts.ts";
 import * as Provider from "../../Provider.ts";
 import { Stack } from "../../Stack.ts";
 import { CloudflareEnvironment } from "../CloudflareEnvironment.ts";
-import { Worker } from "./Worker.ts";
+import { Worker, type WorkerProps, type WorkerVersionAffinity } from "./Worker.ts";
 declare const DurableObjectTransferRequired_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: "DurableObjectTransferRequired";
 } & Readonly<A>;
@@ -60,21 +63,193 @@ export declare class AmbiguousDurableObjectTransfer extends AmbiguousDurableObje
  * @internal
  */
 export declare const resolveNamespaceName: (namespace: unknown) => string | undefined;
+declare const WorkerVersionConfigError_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: "WorkerVersionConfigError";
+} & Readonly<A>;
+/**
+ * A Worker's `version` configuration is invalid — a prop that can't be
+ * combined with `version.parent` (script-level settings belong to the
+ * parent), a locally-hosted Durable Object / Workflow class on a version
+ * worker, an out-of-range `traffic`, or a gradual rollout that requires
+ * changes the versions API can't carry (assets, DO migrations).
+ */
+export declare class WorkerVersionConfigError extends WorkerVersionConfigError_base<{
+    message: string;
+}> {
+}
+/**
+ * Resolve the parent script *name* from a resolved `version.parent` prop or
+ * persisted props. The engine resolves a passed {@link Worker} (or
+ * `Worker.ref(...)`) to its Attributes object — possibly stables-only during
+ * planning, but `workerName` is always a stable — so the value is either the
+ * script name string, that attributes object, or `undefined`.
+ *
+ * @internal
+ */
+export declare const resolveVersionParentName: (version: WorkerProps["version"]) => string | undefined;
+/**
+ * `version.affinity` normalized to a single key source plus the optional
+ * IP fallback.
+ *
+ * @internal exported for unit testing.
+ */
+export interface ResolvedVersionAffinity {
+    source: {
+        kind: "cookie" | "header";
+        name: string;
+    } | {
+        kind: "ip";
+    } | {
+        kind: "key";
+        expression: string;
+    };
+    ipFallback: boolean;
+}
+/**
+ * Validate `version.affinity` and normalize it to its key source: exactly
+ * one of `cookie` / `header` / `key`, or `ip: true` alone; `ip` combines
+ * with `cookie` / `header` as the absent-source fallback.
+ *
+ * @internal exported for unit testing.
+ */
+export declare const resolveVersionAffinity: (affinity: WorkerVersionAffinity) => Effect.Effect<ResolvedVersionAffinity, WorkerVersionConfigError>;
+/** A hostname a Worker serves on within one zone. */
+interface AffinityZoneHost {
+    host: string;
+    /** `true` when `host` came from a route pattern containing `*`. */
+    wildcard: boolean;
+}
+/**
+ * The `http.host` clause scoping a zone's affinity rules to the Worker's
+ * own hostnames, so unrelated zone traffic — and other Workers' rollouts
+ * on the same zone — never get this Worker's version key.
+ *
+ * @internal exported for unit testing.
+ */
+export declare const affinityHostExpression: (hosts: readonly AffinityZoneHost[]) => string;
+interface AffinityRuleSpec {
+    description: string;
+    expression: string;
+    /** Rules-language expression producing the header value. */
+    value: string;
+}
+/**
+ * The transform rules pinning one zone's traffic: a primary rule filling
+ * the version-key header from the configured source, plus — for
+ * `cookie`/`header` sources with `ip: true` — a fallback rule keying
+ * requests that lack the source by client IP.
+ *
+ * @internal exported for unit testing.
+ */
+export declare const buildAffinityZoneRules: (scriptName: string, affinity: ResolvedVersionAffinity, hosts: readonly AffinityZoneHost[]) => AffinityRuleSpec[];
+declare const WorkerDomainConfigError_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: "WorkerDomainConfigError";
+} & Readonly<A>;
 /**
- * Normalize a Worker's persisted `domains` state to `https://<hostname>`
- * strings. Alchemy <= beta.44 stored each custom domain as a
- * `{ id, hostname, zoneId }` object; beta.45+ stores `https://<hostname>`
- * strings and the diff path calls string methods on each entry. Older state is
- * coerced back to strings so `.endsWith` does not throw `u.endsWith is not a
- * function` (#546). Entries that are neither a string nor an object with a
- * string `hostname` are dropped rather than turned into a bogus `https://`
- * value that would skew the diff.
+ * A Worker's `domain` configuration is invalid — a hostname appears in more
+ * than one role (name/aliases/redirects), or a redirect targets itself.
+ */
+export declare class WorkerDomainConfigError extends WorkerDomainConfigError_base<{
+    message: string;
+}> {
+}
+/**
+ * The resolved shape of `WorkerProps.workersDev`: `enabled` drives the
+ * stable `<name>.<account>.workers.dev` URL, `previewsEnabled` the
+ * per-version preview URLs. The two toggles are independent on the
+ * Cloudflare API.
+ *
+ * @internal exported for unit testing.
+ */
+export interface ResolvedWorkersDev {
+    enabled: boolean;
+    previewsEnabled: boolean;
+}
+/**
+ * Resolve the `workersDev` prop to its full shape. `true` / omitted means
+ * "default workers.dev behavior" (stable URL + version previews), `false`
+ * disables both, and the object form fills unset toggles with `true`.
+ *
+ * @internal exported for unit testing.
+ */
+export declare const resolveWorkersDev: (workersDev: WorkerProps["workersDev"]) => ResolvedWorkersDev;
+/**
+ * The resolved shape of `WorkerProps.domain`: the canonical hostname plus
+ * alias and redirect hostname lists, all punycode-normalized and
+ * de-duplicated.
+ *
+ * @internal exported for unit testing.
+ */
+export interface ResolvedWorkerDomain {
+    name: string;
+    aliases: string[];
+    redirects: string[];
+}
+/**
+ * Resolve the `domain` prop to its full shape — a bare string is shorthand
+ * for `{ name }`. Hostnames are punycode-normalized and de-duplicated;
+ * a hostname may only play one role, so aliases/redirects that repeat the
+ * canonical name (or each other) fail with a typed error.
+ *
+ * @internal exported for unit testing.
+ */
+export declare const resolveWorkerDomain: (domain: WorkerProps["domain"] | string[]) => Effect.Effect<ResolvedWorkerDomain | undefined, WorkerDomainConfigError>;
+/**
+ * The *custom domain* hostnames recorded in a Worker's persisted legacy
+ * `domains` state — minus the workers.dev (stable or preview) and local-dev
+ * entries that shared the list in older formats.
+ *
+ * @internal exported for unit testing.
+ */
+export declare const stateCustomDomains: (domains: readonly unknown[] | undefined) => string[];
+/**
+ * The Worker's persisted domain configuration: the `domain` attribute for
+ * state written by the current format, else re-derived from the legacy
+ * `domains` list (first custom hostname = canonical name, rest = aliases;
+ * legacy state had no redirects).
+ *
+ * @internal exported for unit testing.
+ */
+export declare const stateWorkerDomain: (output: object | undefined) => ResolvedWorkerDomain | undefined;
+/**
+ * Normalize a Worker's persisted *legacy* `domains` state to bare
+ * hostnames. Alchemy <= beta.44 stored each custom domain as a
+ * `{ id, hostname, zoneId }` object; beta.45+ stored `https://<hostname>`
+ * URL strings (with the workers.dev URL mixed in); current state stores the
+ * `domain` config object instead of a `domains` list. All legacy
+ * generations coerce to hostnames so the diff never throws on older state
+ * (#546). Entries that fit no generation are dropped rather than turned
+ * into a bogus hostname that would skew the diff.
  *
  * @internal exported for unit testing.
  */
 export declare const normalizeStateDomains: (domains: readonly unknown[] | undefined) => string[];
-export declare const WorkerProvider: () => import("effect/Layer").Layer<Provider.Provider<Worker<any>>, never, import("../../AlchemyContext.ts").AlchemyContext | Artifacts.ArtifactStore | import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | CloudflareEnvironment | import("@distilled.cloud/cloudflare").Credentials | import("effect/FileSystem").FileSystem | import("effect/unstable/http/HttpClient").HttpClient | import("../LocalRuntime.ts").LocalRuntimeState | Path.Path | import("effect/Scope").Scope | Stack | import("../../Stage.ts").Stage | import("@distilled.cloud/cloudflare-runtime/proxy/WorkerProxy").WorkerProxy | import("@distilled.cloud/cloudflare-runtime").RuntimeServices>;
-export declare const LiveWorkerProvider: () => import("effect/Layer").Layer<Provider.Provider<Worker<any>>, never, import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | CloudflareEnvironment | import("@distilled.cloud/cloudflare").Credentials | import("effect/FileSystem").FileSystem | import("effect/unstable/http/HttpClient").HttpClient | Path.Path | import("effect/Scope").Scope | Stack | import("../../Stage.ts").Stage>;
+/**
+ * Custom domains Alchemy is responsible for on this Worker — either declared
+ * on props (`domain`) or already persisted as non-`workers.dev` URLs in state.
+ * Used by `read` to skip `listDomains` when the surface is unmanaged (#926).
+ *
+ * @internal exported for unit testing.
+ */
+export declare const shouldObserveWorkerDomains: (olds: Pick<WorkerProps, "domain"> | undefined, output: object | undefined) => boolean;
+/**
+ * Zone routes Alchemy is responsible for on this Worker. Used by `read` to
+ * skip account-wide zone/route fan-out when the surface is unmanaged (#926).
+ *
+ * @internal exported for unit testing.
+ */
+export declare const shouldObserveWorkerRoutes: (olds: Pick<WorkerProps, "routes"> | undefined, output: Pick<Worker["Attributes"], "routes"> | undefined) => boolean;
+/**
+ * Cron triggers Alchemy is responsible for on this Worker. Used by `read` to
+ * skip `getScriptSchedule` when the surface is unmanaged (#926). Effect-native
+ * `cron()` bindings persist into `output.crons` after the first reconcile, so
+ * subsequent reads still observe them.
+ *
+ * @internal exported for unit testing.
+ */
+export declare const shouldObserveWorkerCrons: (olds: Pick<WorkerProps, "crons"> | undefined, output: Pick<Worker["Attributes"], "crons"> | undefined) => boolean;
+export declare const WorkerProvider: () => Layer.Layer<Provider.Provider<Worker<any>>, Config.ConfigError | import("effect/PlatformError").PlatformError | import("@distilled.cloud/cloudflare-runtime").SystemError, import("../../AlchemyContext.ts").AlchemyContext | Artifacts.ArtifactStore | import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | CloudflareEnvironment | import("@distilled.cloud/cloudflare").Credentials | import("effect/FileSystem").FileSystem | import("effect/unstable/http/HttpClient").HttpClient | Path.Path | import("effect/Scope").Scope | Stack | import("../../Stage.ts").Stage>;
+export declare const LiveWorkerProvider: () => Layer.Layer<Provider.Provider<Worker<any>>, never, import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | CloudflareEnvironment | import("@distilled.cloud/cloudflare").Credentials | import("effect/FileSystem").FileSystem | import("effect/unstable/http/HttpClient").HttpClient | Path.Path | import("effect/Scope").Scope | Stack | import("../../Stage.ts").Stage>;
 /**
  * Pack Durable Object logical-id→class mappings into `alchemy:dos:` tags.
  *

package/lib/Cloudflare/Workers/WorkerProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkerProvider.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Workers/WorkerProvider.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAOpC,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAKhD,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAYpE,OAAO,EACL,MAAM,EAIP,MAAM,aAAa,CAAC;;;;AAYrB;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,6BAA8B,SAAQ,mCAEjD;IACA,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;IACA,IAAa,OAAO,WAQnB;CACF;;;;AAED;;;;;;;GAOG;AACH,qBAAa,8BAA+B,SAAQ,oCAElD;IACA,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;IACA,IAAa,OAAO,WAKnB;CACF;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,cACpB,OAAO,KACjB,MAAM,GAAG,SAIX,CAAC;AAkJF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,YACvB,SAAS,OAAO,EAAE,GAAG,SAAS,KACtC,MAAM,EAKL,CAAC;AA8IL,eAAO,MAAM,cAAc,kqBAIvB,CAAC;AAEL,eAAO,MAAM,kBAAkB,sZAk5E5B,CAAC;AAwLJ;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,aAAa,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,GACtE,MAAM,EAAE,CA0BV;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,0BA8BjE"}
+{"version":3,"file":"WorkerProvider.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Workers/WorkerProvider.ts"],"names":[],"mappings":"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"}