@distilled.cloud/vercel 0.0.0 → 1.0.0-rc.5

package/lib/credentials.d.ts

@@ -0,0 +1,21 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+/** Vercel's REST API root. */
+export declare const DEFAULT_API_BASE_URL = "https://api.vercel.com";
+export interface Config {
+    readonly token: Redacted.Redacted<string>;
+    readonly apiBaseUrl: string;
+}
+declare const Credentials_base: Context.ServiceClass<Credentials, "VercelCredentials", Effect.Effect<Config, never, never>>;
+export declare class Credentials extends Credentials_base {
+}
+export declare const CredentialsFromEnv: Layer.Layer<Credentials, never, never>;
+/** Convenience layer from a plain token + optional base URL. */
+export declare const credentials: (config: {
+    readonly token: string;
+    readonly apiBaseUrl?: string;
+}) => Layer.Layer<Credentials>;
+export {};
+//# sourceMappingURL=credentials.d.ts.map

package/lib/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAG5C,8BAA8B;AAC9B,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAE7D,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;;AAED,qBAAa,WAAY,SAAQ,gBAGT;CAAG;AAU3B,eAAO,MAAM,kBAAkB,wCAe9B,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,WAAW,WAAY;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,KAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAOxB,CAAC"}

package/lib/credentials.js

@@ -0,0 +1,40 @@
+/**
+ * Vercel credentials — hand-written.
+ *
+ * The `Credentials` service resolves `{ token, apiBaseUrl }` per request; the
+ * protocol layer formats the `Authorization: Bearer <token>` header from it.
+ * The token is a Vercel access token — personal, team, or an OAuth
+ * integration's — the REST API accepts all of them as bearer tokens.
+ *
+ * Vercel scopes most requests to a team via the `teamId`/`slug` QUERY
+ * parameters, which the spec declares per operation; they stay ordinary input
+ * fields rather than credential state, because a single token routinely spans
+ * several teams.
+ */
+import * as EffectConfig from "effect/Config";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import { ConfigError } from "@distilled.cloud/core/errors";
+/** Vercel's REST API root. */
+export const DEFAULT_API_BASE_URL = "https://api.vercel.com";
+export class Credentials extends Context.Service()("VercelCredentials") {
+}
+const envConfig = EffectConfig.all({
+    // `VERCEL_TOKEN` is what the Vercel CLI and the official SDK read.
+    token: EffectConfig.string("VERCEL_TOKEN"),
+    apiBaseUrl: EffectConfig.string("VERCEL_API_URL").pipe(EffectConfig.withDefault(DEFAULT_API_BASE_URL)),
+});
+export const CredentialsFromEnv = Layer.succeed(Credentials, envConfig.pipe(Effect.mapError(() => new ConfigError({
+    message: "VERCEL_TOKEN environment variable is required",
+})), Effect.map(({ token, apiBaseUrl }) => ({
+    token: Redacted.make(token),
+    apiBaseUrl,
+})), Effect.orDie));
+/** Convenience layer from a plain token + optional base URL. */
+export const credentials = (config) => Layer.succeed(Credentials, Effect.succeed({
+    token: Redacted.make(config.token),
+    apiBaseUrl: config.apiBaseUrl ?? DEFAULT_API_BASE_URL,
+}));
+//# sourceMappingURL=credentials.js.map

package/lib/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,YAAY,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,8BAA8B;AAC9B,MAAM,CAAC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAO7D,MAAM,OAAO,WAAY,SAAQ,OAAO,CAAC,OAAO,EAG7C,CAAC,mBAAmB,CAAC;CAAG;AAE3B,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC;IACjC,mEAAmE;IACnE,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,cAAc,CAAC;IAC1C,UAAU,EAAE,YAAY,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CACpD,YAAY,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAC/C;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAC7C,WAAW,EACX,SAAS,CAAC,IAAI,CACZ,MAAM,CAAC,QAAQ,CACb,GAAG,EAAE,CACH,IAAI,WAAW,CAAC;IACd,OAAO,EAAE,+CAA+C;CACzD,CAAC,CACL,EACD,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IACrC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;IAC3B,UAAU;CACX,CAAC,CAAC,EACH,MAAM,CAAC,KAAK,CACb,CACF,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAG3B,EAA4B,EAAE,CAC7B,KAAK,CAAC,OAAO,CACX,WAAW,EACX,MAAM,CAAC,OAAO,CAAC;IACb,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,oBAAoB;CACtD,CAAC,CACH,CAAC"}

package/lib/errors.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Vercel-specific error types.
+ *
+ * Re-exports the common HTTP errors from core and adds the two statuses
+ * Vercel uses that core's shared map has no entry for, plus the
+ * unknown-error and parse-error wrappers.
+ */
+export { BadGateway, BadRequest, Conflict, ConfigError, Forbidden, GatewayTimeout, InternalServerError, Locked, NotFound, ServiceUnavailable, TooManyRequests, Unauthorized, UnprocessableEntity, HTTP_STATUS_MAP, DEFAULT_ERRORS, API_ERRORS, } from "@distilled.cloud/core/errors";
+import type { DefaultErrors as CoreDefaultErrors } from "@distilled.cloud/core/errors";
+import * as Schema from "effect/Schema";
+declare const PaymentRequired_base: Schema.Class<PaymentRequired, Schema.TaggedStruct<"PaymentRequired", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        QuotaError: true;
+    };
+});
+/**
+ * HTTP 402 — the account cannot be billed for the request: a missing payment
+ * method, an unpaid invoice, or a spend cap the team has already hit (Vercel
+ * pauses the account at the cap until an owner disables it). Declared on the
+ * ~95 operations that provision billable resources; the rest reach it through
+ * the protocol's status map.
+ */
+export declare class PaymentRequired extends PaymentRequired_base {
+}
+declare const Gone_base: Schema.Class<Gone, Schema.TaggedStruct<"Gone", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        NotFoundError: true;
+    };
+});
+/**
+ * HTTP 410 — Vercel's "Invalid API version": the versioned path segment
+ * (`/v5/domains`, `/v9/projects`) is no longer served. The spec declares it on
+ * nearly every operation as boilerplate, so it rides the common error channel
+ * instead of every generated operation's error list — a 410 means the SDK's
+ * pinned path version was retired and needs a regeneration, not something a
+ * caller can branch on per operation.
+ */
+export declare class Gone extends Gone_base {
+}
+declare const UnknownVercelError_base: Schema.Class<UnknownVercelError, Schema.TaggedStruct<"UnknownVercelError", {
+    readonly code: Schema.optional<Schema.String>;
+    readonly message: Schema.optional<Schema.String>;
+    readonly body: Schema.Unknown;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        ServerError: true;
+    };
+});
+/**
+ * Unknown Vercel error — returned when a failed response's HTTP status has no
+ * mapped error class. Carries the raw body for later cataloging.
+ */
+export declare class UnknownVercelError extends UnknownVercelError_base {
+}
+declare const VercelParseError_base: Schema.Class<VercelParseError, Schema.TaggedStruct<"VercelParseError", {
+    readonly body: Schema.Unknown;
+    readonly cause: Schema.Unknown;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        ParseError: true;
+    };
+});
+/** Schema parse error wrapper. */
+export declare class VercelParseError extends VercelParseError_base {
+}
+/**
+ * Errors any Vercel operation may surface in addition to the per-operation
+ * typed status errors.
+ */
+export type ClientErrors = UnknownVercelError | VercelParseError | PaymentRequired | Gone;
+/**
+ * Default Vercel operation errors: the shared HTTP status errors from core
+ * plus the client-level fallback/decode errors.
+ */
+export type DefaultErrors = CoreDefaultErrors | ClientErrors;
+//# sourceMappingURL=errors.d.ts.map

package/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,MAAM,EACN,QAAQ,EACR,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,UAAU,GACX,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEvF,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;;;;;;;;AAGxC;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,oBAKN;CAAG;;;;;;;;AAElC;;;;;;;GAOG;AACH,qBAAa,IAAK,SAAQ,SAES;CAAG;;;;;;;;;;AAEtC;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,uBAOR;CAAG;;;;;;;;;AAEnC,kCAAkC;AAClC,qBAAa,gBAAiB,SAAQ,qBAMP;CAAG;AAElC;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,IAAI,CAAC;AAET;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,YAAY,CAAC"}

package/lib/errors.js

@@ -0,0 +1,50 @@
+/**
+ * Vercel-specific error types.
+ *
+ * Re-exports the common HTTP errors from core and adds the two statuses
+ * Vercel uses that core's shared map has no entry for, plus the
+ * unknown-error and parse-error wrappers.
+ */
+export { BadGateway, BadRequest, Conflict, ConfigError, Forbidden, GatewayTimeout, InternalServerError, Locked, NotFound, ServiceUnavailable, TooManyRequests, Unauthorized, UnprocessableEntity, HTTP_STATUS_MAP, DEFAULT_ERRORS, API_ERRORS, } from "@distilled.cloud/core/errors";
+import * as Schema from "effect/Schema";
+import * as Category from "@distilled.cloud/core/category";
+/**
+ * HTTP 402 — the account cannot be billed for the request: a missing payment
+ * method, an unpaid invoice, or a spend cap the team has already hit (Vercel
+ * pauses the account at the cap until an owner disables it). Declared on the
+ * ~95 operations that provision billable resources; the rest reach it through
+ * the protocol's status map.
+ */
+export class PaymentRequired extends Schema.TaggedError()("PaymentRequired", {
+    message: Schema.String,
+}).pipe(Category.withQuotaError) {
+}
+/**
+ * HTTP 410 — Vercel's "Invalid API version": the versioned path segment
+ * (`/v5/domains`, `/v9/projects`) is no longer served. The spec declares it on
+ * nearly every operation as boilerplate, so it rides the common error channel
+ * instead of every generated operation's error list — a 410 means the SDK's
+ * pinned path version was retired and needs a regeneration, not something a
+ * caller can branch on per operation.
+ */
+export class Gone extends Schema.TaggedError()("Gone", {
+    message: Schema.String,
+}).pipe(Category.withNotFoundError) {
+}
+/**
+ * Unknown Vercel error — returned when a failed response's HTTP status has no
+ * mapped error class. Carries the raw body for later cataloging.
+ */
+export class UnknownVercelError extends Schema.TaggedError()("UnknownVercelError", {
+    code: Schema.optional(Schema.String),
+    message: Schema.optional(Schema.String),
+    body: Schema.Unknown,
+}).pipe(Category.withServerError) {
+}
+/** Schema parse error wrapper. */
+export class VercelParseError extends Schema.TaggedError()("VercelParseError", {
+    body: Schema.Unknown,
+    cause: Schema.Unknown,
+}).pipe(Category.withParseError) {
+}
+//# sourceMappingURL=errors.js.map

package/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,UAAU,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,MAAM,EACN,QAAQ,EACR,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,UAAU,GACX,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,gCAAgC,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,OAAO,eAAgB,SAAQ,MAAM,CAAC,WAAW,EAAmB,CACxE,iBAAiB,EACjB;IACE,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CACF,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;CAAG;AAElC;;;;;;;GAOG;AACH,MAAM,OAAO,IAAK,SAAQ,MAAM,CAAC,WAAW,EAAQ,CAAC,MAAM,EAAE;IAC3D,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;CAAG;AAEtC;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,MAAM,CAAC,WAAW,EAAsB,CAC9E,oBAAoB,EACpB;IACE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC,OAAO;CACrB,CACF,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;CAAG;AAEnC,kCAAkC;AAClC,MAAM,OAAO,gBAAiB,SAAQ,MAAM,CAAC,WAAW,EAAoB,CAC1E,kBAAkB,EAClB;IACE,IAAI,EAAE,MAAM,CAAC,OAAO;IACpB,KAAK,EAAE,MAAM,CAAC,OAAO;CACtB,CACF,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;CAAG"}

package/lib/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @distilled.cloud/vercel — Vercel REST API SDK for Effect.
+ *
+ * `./services` is generated by `scripts/generate.ts` from the Smithy models in
+ * `.generated-specs` (written by `scripts/convert.ts` from the OpenAPI
+ * document `scripts/download-spec.ts` downloads into `specs/`). Everything
+ * else in this folder is hand-written.
+ */
+export * from "./credentials.ts";
+export * from "./errors.ts";
+export * as T from "./traits.ts";
+export { VercelProtocol, type VercelOpError, type VercelOpContext, } from "./protocol.ts";
+export * as Retry from "./retry.ts";
+export * as Services from "./services/index.ts";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC"}

package/lib/index.js

@@ -0,0 +1,15 @@
+/**
+ * @distilled.cloud/vercel — Vercel REST API SDK for Effect.
+ *
+ * `./services` is generated by `scripts/generate.ts` from the Smithy models in
+ * `.generated-specs` (written by `scripts/convert.ts` from the OpenAPI
+ * document `scripts/download-spec.ts` downloads into `specs/`). Everything
+ * else in this folder is hand-written.
+ */
+export * from "./credentials.js";
+export * from "./errors.js";
+export * as T from "./traits.js";
+export { VercelProtocol, } from "./protocol.js";
+export * as Retry from "./retry.js";
+export * as Services from "./services/index.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EACL,cAAc,GAGf,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC"}

package/lib/protocol.d.ts

@@ -0,0 +1,18 @@
+import type * as Layer from "effect/Layer";
+import type * as HttpClient from "effect/unstable/http/HttpClient";
+import type * as HttpClientError from "effect/unstable/http/HttpClientError";
+import type * as API from "@distilled.cloud/core/api";
+import type { ConfigError } from "@distilled.cloud/core/errors";
+import { Credentials } from "./credentials.ts";
+import { type DefaultErrors } from "./errors.ts";
+/**
+ * Error channel shared by every generated Vercel operation. Generated service
+ * files annotate operations with `API.OperationMethod<I, O, VercelOpError,
+ * VercelOpContext>` explicitly so the compiler never infers these back out of
+ * the schema generics.
+ */
+export type VercelOpError = DefaultErrors | ConfigError | HttpClientError.HttpClientError;
+/** Context (requirements) shared by every generated Vercel operation. */
+export type VercelOpContext = Credentials | HttpClient.HttpClient;
+export declare const VercelProtocol: Layer.Layer<API.Protocol>;
+//# sourceMappingURL=protocol.d.ts.map

package/lib/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,KAAK,UAAU,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,KAAK,eAAe,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,KAAK,GAAG,MAAM,2BAA2B,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAMhE,OAAO,EAAE,WAAW,EAAe,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,WAAW,GACX,eAAe,CAAC,eAAe,CAAC;AAEpC,yEAAyE;AACzE,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC;AAkBlE,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAkCjD,CAAC"}

package/lib/protocol.js

@@ -0,0 +1,69 @@
+/**
+ * VercelProtocol — the shared bearer-REST protocol instantiated for Vercel.
+ *
+ * Vercel speaks plain JSON with no success envelope: a list endpoint returns
+ * its collection object (`{ projects: [...], pagination: {...} }`), a single
+ * resource returns the object itself. FAILURES are enveloped, and uniformly
+ * so — `{ "error": { "code": "forbidden", "message": "Not authorized" } }` —
+ * with `code` a machine-readable string that error matchers can key on.
+ *
+ * The API version is part of the PATH (`/v9/projects`, `/v5/domains`), not a
+ * header, so each generated operation carries the version it was generated
+ * from; a retired version answers 410 (see `Gone` in errors.ts).
+ */
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import { HTTP_STATUS_MAP } from "@distilled.cloud/core/errors";
+import { makeRestProtocol, } from "@distilled.cloud/core/protocol-rest";
+import { Credentials } from "./credentials.js";
+import { Gone, PaymentRequired, UnknownVercelError, } from "./errors.js";
+/**
+ * Vercel error bodies nest under `error`: `{ error: { code, message } }`.
+ * A handful of edge paths (proxy 502s, HTML error pages) answer without that
+ * envelope — those fall through to the protocol's `HTTP <status>` default.
+ */
+const errorEnvelope = (body) => {
+    if (body === null || typeof body !== "object")
+        return undefined;
+    const err = body.error;
+    if (err === null || typeof err !== "object")
+        return undefined;
+    const e = err;
+    return {
+        code: typeof e.code === "string" ? e.code : undefined,
+        message: typeof e.message === "string" ? e.message : undefined,
+    };
+};
+export const VercelProtocol = makeRestProtocol({
+    // Resolved on the CALLING fiber per request (the layer is memoized per
+    // process); the Credentials service holds an effect, so a token rotated
+    // between calls is picked up without rebuilding the layer.
+    credentials: Effect.gen(function* () {
+        const resolve = yield* Credentials;
+        return yield* resolve;
+    }),
+    baseUrl: (creds) => creds.apiBaseUrl,
+    headers: (creds) => ({
+        Authorization: `Bearer ${Redacted.value(creds.token)}`,
+    }),
+    errorEnvelope,
+    // Core's shared map plus the two statuses Vercel uses that it doesn't
+    // cover: 402 (billing) and 410 (retired path version). Both are declared
+    // so broadly in the spec that leaving them unmapped would funnel routine
+    // failures into UnknownVercelError.
+    statusMap: {
+        ...HTTP_STATUS_MAP,
+        402: PaymentRequired,
+        410: Gone,
+    },
+    unknownError: ({ code, message, body }) => new UnknownVercelError({
+        code: typeof code === "string"
+            ? code
+            : code !== undefined
+                ? String(code)
+                : undefined,
+        message,
+        body,
+    }),
+});
+//# sourceMappingURL=protocol.js.map

package/lib/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAK5C,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EACL,gBAAgB,GAEjB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAe,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EACL,IAAI,EACJ,eAAe,EACf,kBAAkB,GAEnB,MAAM,aAAa,CAAC;AAgBrB;;;;GAIG;AACH,MAAM,aAAa,GAAG,CAAC,IAAa,EAAiC,EAAE;IACrE,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChE,MAAM,GAAG,GAAI,IAAgC,CAAC,KAAK,CAAC;IACpD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACrD,OAAO,EAAE,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;KAC/D,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GACzB,gBAAgB,CAAS;IACvB,uEAAuE;IACvE,wEAAwE;IACxE,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC;QACnC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC;IACxB,CAAC,CAAC;IACF,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU;IACpC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACnB,aAAa,EAAE,UAAU,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;KACvD,CAAC;IACF,aAAa;IACb,sEAAsE;IACtE,yEAAyE;IACzE,yEAAyE;IACzE,oCAAoC;IACpC,SAAS,EAAE;QACT,GAAG,eAAe;QAClB,GAAG,EAAE,eAAe;QACpB,GAAG,EAAE,IAAI;KACV;IACD,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CACxC,IAAI,kBAAkB,CAAC;QACrB,IAAI,EACF,OAAO,IAAI,KAAK,QAAQ;YACtB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,IAAI,KAAK,SAAS;gBAClB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;gBACd,CAAC,CAAC,SAAS;QACjB,OAAO;QACP,IAAI;KACL,CAAC;CACL,CAAC,CAAC"}

package/lib/retry.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Vercel retry surface — a veneer over `@distilled.cloud/core/retry`.
+ *
+ * The `Retry` service tag is threaded into every generated operation via
+ * `API.make({ retry: Retry })`, so a caller-installed policy applies to all
+ * Vercel calls below it and core's `makeDefault` is the fallback when none is
+ * provided.
+ *
+ * Vercel answers a tripped rate limit with `429` plus `Retry-After`; the REST
+ * protocol stamps that onto the retryable error classes, and the default
+ * policy honors it ahead of its own backoff.
+ *
+ * @example
+ * ```ts
+ * import * as Vercel from "@distilled.cloud/vercel";
+ *
+ * myEffect.pipe(Vercel.Retry.transient);
+ * ```
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Retries from "@distilled.cloud/core/retry";
+export type Options = Retries.Options;
+export type Factory = Retries.Factory;
+export type Policy = Retries.Policy;
+declare const Retry_base: Context.ServiceClass<Retry, "VercelRetry", Retries.Policy>;
+/** Context tag for configuring retry behavior of Vercel API calls. */
+export declare class Retry extends Retry_base {
+}
+/** Provides a custom retry policy to every Vercel API call below it. */
+export declare const policy: {
+    (options: Options): <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+    (factory: Factory): <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+};
+/** Disables all automatic retries. */
+export declare const none: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+/**
+ * The default retry policy (core's): transient/throttling/retryable errors,
+ * capped exponential backoff with jitter, server `retryAfter` hints honored
+ * with precedence.
+ */
+export declare const makeDefault: Factory;
+export declare const jittered: <Error, Env>(self: import("effect/Schedule").Schedule<unknown, unknown, Error, Env>) => import("effect/Schedule").Schedule<unknown, unknown, Error, Env>;
+export declare const capped: (max: import("effect/Duration").Duration) => <Error, Env>(self: import("effect/Schedule").Schedule<unknown, unknown, Error, Env>) => import("effect/Schedule").Schedule<unknown, unknown, Error, Env>;
+/** Retry options that retry all throttling errors indefinitely. */
+export declare const throttlingOptions: Options;
+/** Retries all throttling errors indefinitely (honoring server hints). */
+export declare const throttling: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+/** Retry options that retry all transient errors indefinitely. */
+export declare const transientOptions: Options;
+/** Retries all transient errors indefinitely (honoring server hints). */
+export declare const transient: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+export {};
+//# sourceMappingURL=retry.d.ts.map

package/lib/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,OAAO,MAAM,6BAA6B,CAAC;AAEvD,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;AACtC,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;AACtC,MAAM,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;;AAEpC,sEAAsE;AACtE,qBAAa,KAAM,SAAQ,UAA+C;CAAG;AAE7E,wEAAwE;AACxE,eAAO,MAAM,MAAM,EAAE;IACnB,CACE,OAAO,EAAE,OAAO,GACf,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACT,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5C,CACE,OAAO,EAAE,OAAO,GACf,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACT,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;CAEU,CAAC;AAEzD,sCAAsC;AACtC,eAAO,MAAM,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACzB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAEzC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,OAA6B,CAAC;AAExD,eAAO,MAAM,QAAQ,0JAAmB,CAAC;AACzC,eAAO,MAAM,MAAM,uMAAiB,CAAC;AAErC,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,EAAE,OAAmC,CAAC;AAEpE,0EAA0E;AAC1E,eAAO,MAAM,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAqC,CAAC;AAEhF,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,EAAE,OAAkC,CAAC;AAElE,yEAAyE;AACzE,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAoC,CAAC"}

package/lib/retry.js

@@ -0,0 +1,47 @@
+/**
+ * Vercel retry surface — a veneer over `@distilled.cloud/core/retry`.
+ *
+ * The `Retry` service tag is threaded into every generated operation via
+ * `API.make({ retry: Retry })`, so a caller-installed policy applies to all
+ * Vercel calls below it and core's `makeDefault` is the fallback when none is
+ * provided.
+ *
+ * Vercel answers a tripped rate limit with `429` plus `Retry-After`; the REST
+ * protocol stamps that onto the retryable error classes, and the default
+ * policy honors it ahead of its own backoff.
+ *
+ * @example
+ * ```ts
+ * import * as Vercel from "@distilled.cloud/vercel";
+ *
+ * myEffect.pipe(Vercel.Retry.transient);
+ * ```
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Retries from "@distilled.cloud/core/retry";
+/** Context tag for configuring retry behavior of Vercel API calls. */
+export class Retry extends Context.Service()("VercelRetry") {
+}
+/** Provides a custom retry policy to every Vercel API call below it. */
+export const policy = (optionsOrFactory) => Effect.provide(Layer.succeed(Retry, optionsOrFactory));
+/** Disables all automatic retries. */
+export const none = Effect.provide(Layer.succeed(Retry, { while: () => false }));
+/**
+ * The default retry policy (core's): transient/throttling/retryable errors,
+ * capped exponential backoff with jitter, server `retryAfter` hints honored
+ * with precedence.
+ */
+export const makeDefault = Retries.makeDefault;
+export const jittered = Retries.jittered;
+export const capped = Retries.capped;
+/** Retry options that retry all throttling errors indefinitely. */
+export const throttlingOptions = Retries.throttlingOptions;
+/** Retries all throttling errors indefinitely (honoring server hints). */
+export const throttling = policy(Retries.throttlingFactory);
+/** Retry options that retry all transient errors indefinitely. */
+export const transientOptions = Retries.transientOptions;
+/** Retries all transient errors indefinitely (honoring server hints). */
+export const transient = policy(Retries.transientFactory);
+//# sourceMappingURL=retry.js.map

package/lib/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,6BAA6B,CAAC;AAMvD,sEAAsE;AACtE,MAAM,OAAO,KAAM,SAAQ,OAAO,CAAC,OAAO,EAAiB,CAAC,aAAa,CAAC;CAAG;AAE7E,wEAAwE;AACxE,MAAM,CAAC,MAAM,MAAM,GAWf,CAAC,gBAAmC,EAAE,EAAE,CAC1C,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAEzD,sCAAsC;AACtC,MAAM,CAAC,MAAM,IAAI,GAE6B,MAAM,CAAC,OAAO,CAC1D,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,CAC7C,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAY,OAAO,CAAC,WAAW,CAAC;AAExD,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;AACzC,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;AAErC,mEAAmE;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAAY,OAAO,CAAC,iBAAiB,CAAC;AAEpE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,UAAU,GAEuB,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEhF,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAY,OAAO,CAAC,gBAAgB,CAAC;AAElE,yEAAyE;AACzE,MAAM,CAAC,MAAM,SAAS,GAEwB,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC"}