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

package/lib/credentials.d.ts

@@ -0,0 +1,29 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+/**
+ * Discord HTTP API base URL. The trailing `/v10` is the API version the spec
+ * submodule describes — override via `DISCORD_API_URL` only to point at a
+ * proxy, not to change versions (the generated operations are v10-shaped).
+ */
+export declare const DEFAULT_API_BASE_URL = "https://discord.com/api/v10";
+/** Authorization header prefix — see the module doc. */
+export type TokenType = "Bot" | "Bearer";
+export interface Config {
+    readonly token: Redacted.Redacted<string>;
+    readonly tokenType: TokenType;
+    readonly apiBaseUrl: string;
+}
+declare const Credentials_base: Context.ServiceClass<Credentials, "DiscordCredentials", 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 token type / base URL. */
+export declare const credentials: (config: {
+    readonly token: string;
+    readonly tokenType?: TokenType;
+    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":"AAeA,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;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,gCAAgC,CAAC;AAElE,wDAAwD;AACxD,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEzC,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;;AAED,qBAAa,WAAY,SAAQ,gBAGR;CAAG;AAgB5B,eAAO,MAAM,kBAAkB,wCAqB9B,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,WAAW,WAAY;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,KAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAQxB,CAAC"}

package/lib/credentials.js

@@ -0,0 +1,53 @@
+/**
+ * Discord credentials — hand-written.
+ *
+ * The `Credentials` service resolves `{ token, tokenType, apiBaseUrl }` per
+ * request; the protocol layer formats the `Authorization: <tokenType> <token>`
+ * header from it.
+ *
+ * Discord authorizes HTTP API calls two ways, distinguished by the token
+ * prefix (https://discord.com/developers/docs/reference#authentication):
+ *   • `Bot <token>` — a bot token from the application's Bot page (the
+ *     default; what almost every server-side integration uses)
+ *   • `Bearer <token>` — an OAuth2 access token, for calls made on behalf of
+ *     a user (`/users/@me`, `/users/@me/guilds`, …)
+ */
+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";
+/**
+ * Discord HTTP API base URL. The trailing `/v10` is the API version the spec
+ * submodule describes — override via `DISCORD_API_URL` only to point at a
+ * proxy, not to change versions (the generated operations are v10-shaped).
+ */
+export const DEFAULT_API_BASE_URL = "https://discord.com/api/v10";
+export class Credentials extends Context.Service()("DiscordCredentials") {
+}
+const envConfig = EffectConfig.all({
+    // DISCORD_BOT_TOKEN is the spelling discord.js and most hosting platforms
+    // use; DISCORD_TOKEN is the fallback.
+    token: EffectConfig.string("DISCORD_BOT_TOKEN").pipe(EffectConfig.orElse(() => EffectConfig.string("DISCORD_TOKEN"))),
+    tokenType: EffectConfig.string("DISCORD_TOKEN_TYPE").pipe(EffectConfig.withDefault("Bot")),
+    apiBaseUrl: EffectConfig.string("DISCORD_API_URL").pipe(EffectConfig.withDefault(DEFAULT_API_BASE_URL)),
+});
+export const CredentialsFromEnv = Layer.succeed(Credentials, envConfig.pipe(Effect.mapError(() => new ConfigError({
+    message: "DISCORD_BOT_TOKEN (or DISCORD_TOKEN) environment variable is required",
+})), Effect.map(({ token, tokenType, apiBaseUrl }) => ({
+    token: Redacted.make(token),
+    // Anything but an explicit `Bearer` means a bot token — the OAuth2
+    // flavor is the opt-in.
+    tokenType: (tokenType.toLowerCase() === "bearer"
+        ? "Bearer"
+        : "Bot"),
+    apiBaseUrl,
+})), Effect.orDie));
+/** Convenience layer from a plain token + optional token type / base URL. */
+export const credentials = (config) => Layer.succeed(Credentials, Effect.succeed({
+    token: Redacted.make(config.token),
+    tokenType: config.tokenType ?? "Bot",
+    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;;;;;;;;;;;;;GAaG;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;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;AAWlE,MAAM,OAAO,WAAY,SAAQ,OAAO,CAAC,OAAO,EAG7C,CAAC,oBAAoB,CAAC;CAAG;AAE5B,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC;IACjC,0EAA0E;IAC1E,sCAAsC;IACtC,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAClD,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAChE;IACD,SAAS,EAAE,YAAY,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CACvD,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,CAChC;IACD,UAAU,EAAE,YAAY,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CACrD,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,EACL,uEAAuE;CAC1E,CAAC,CACL,EACD,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IAChD,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;IAC3B,mEAAmE;IACnE,wBAAwB;IACxB,SAAS,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,QAAQ;QAC9C,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,KAAK,CAAc;IACvB,UAAU;CACX,CAAC,CAAC,EACH,MAAM,CAAC,KAAK,CACb,CACF,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAI3B,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,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,KAAK;IACpC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,oBAAoB;CACtD,CAAC,CACH,CAAC"}

package/lib/errors.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Discord-specific error types.
+ *
+ * Re-exports the common HTTP errors from core and adds the Discord-specific
+ * 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 UnknownDiscordError_base: Schema.Class<UnknownDiscordError, Schema.TaggedStruct<"UnknownDiscordError", {
+    readonly code: Schema.optional<Schema.Number>;
+    readonly message: Schema.optional<Schema.String>;
+    readonly errors: Schema.optional<Schema.Unknown>;
+    readonly body: Schema.Unknown;
+}>, import("effect/Cause").YieldableError> & (new (...args: any[]) => {
+    "@distilled.cloud/error/categories": {
+        ServerError: true;
+    };
+});
+/**
+ * Unknown Discord error — returned when a failed response's HTTP status has
+ * no mapped error class. `code` is Discord's own JSON error code (e.g. 50001
+ * "Missing Access"), which is far more specific than the HTTP status and is
+ * the field worth branching on; `errors` carries the per-field validation
+ * detail Discord attaches to 400s. See
+ * https://discord.com/developers/docs/topics/opcodes-and-status-codes#json.
+ */
+export declare class UnknownDiscordError extends UnknownDiscordError_base {
+}
+declare const DiscordParseError_base: Schema.Class<DiscordParseError, Schema.TaggedStruct<"DiscordParseError", {
+    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 DiscordParseError extends DiscordParseError_base {
+}
+/**
+ * Errors any Discord operation may surface in addition to the shared HTTP
+ * status errors.
+ */
+export type ClientErrors = UnknownDiscordError | DiscordParseError;
+/**
+ * Default Discord 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;;;;;GAKG;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;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,wBAQT;CAAG;;;;;;;;;AAEnC,kCAAkC;AAClC,qBAAa,iBAAkB,SAAQ,sBAMR;CAAG;AAElC;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,YAAY,CAAC"}

package/lib/errors.js

@@ -0,0 +1,31 @@
+/**
+ * Discord-specific error types.
+ *
+ * Re-exports the common HTTP errors from core and adds the Discord-specific
+ * 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";
+/**
+ * Unknown Discord error — returned when a failed response's HTTP status has
+ * no mapped error class. `code` is Discord's own JSON error code (e.g. 50001
+ * "Missing Access"), which is far more specific than the HTTP status and is
+ * the field worth branching on; `errors` carries the per-field validation
+ * detail Discord attaches to 400s. See
+ * https://discord.com/developers/docs/topics/opcodes-and-status-codes#json.
+ */
+export class UnknownDiscordError extends Schema.TaggedError()("UnknownDiscordError", {
+    code: Schema.optional(Schema.Number),
+    message: Schema.optional(Schema.String),
+    errors: Schema.optional(Schema.Unknown),
+    body: Schema.Unknown,
+}).pipe(Category.withServerError) {
+}
+/** Schema parse error wrapper. */
+export class DiscordParseError extends Schema.TaggedError()("DiscordParseError", {
+    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;;;;;GAKG;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;;;;;;;GAOG;AACH,MAAM,OAAO,mBAAoB,SAAQ,MAAM,CAAC,WAAW,EAAuB,CAChF,qBAAqB,EACrB;IACE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC,OAAO;CACrB,CACF,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;CAAG;AAEnC,kCAAkC;AAClC,MAAM,OAAO,iBAAkB,SAAQ,MAAM,CAAC,WAAW,EAAqB,CAC5E,mBAAmB,EACnB;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,14 @@
+/**
+ * @distilled.cloud/discord — Discord HTTP API (v10) SDK for Effect.
+ *
+ * `./services` is generated by `scripts/generate.ts` from the Smithy model in
+ * `.generated-specs` (written by `scripts/convert.ts` from the Discord
+ * OpenAPI spec submodule). Everything else in this folder is hand-written.
+ */
+export * from "./credentials.ts";
+export * from "./errors.ts";
+export * as T from "./traits.ts";
+export { DiscordProtocol, type DiscordOpError, type DiscordOpContext, } 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;;;;;;GAMG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EACL,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC"}

package/lib/index.js

@@ -0,0 +1,14 @@
+/**
+ * @distilled.cloud/discord — Discord HTTP API (v10) SDK for Effect.
+ *
+ * `./services` is generated by `scripts/generate.ts` from the Smithy model in
+ * `.generated-specs` (written by `scripts/convert.ts` from the Discord
+ * OpenAPI spec submodule). Everything else in this folder is hand-written.
+ */
+export * from "./credentials.js";
+export * from "./errors.js";
+export * as T from "./traits.js";
+export { DiscordProtocol, } 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;;;;;;GAMG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EACL,eAAe,GAGhB,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 Discord operation. Generated
+ * service files annotate operations with `API.OperationMethod<I, O,
+ * DiscordOpError, DiscordOpContext>` explicitly so the compiler never infers
+ * these back out of the schema generics.
+ */
+export type DiscordOpError = DefaultErrors | ConfigError | HttpClientError.HttpClientError;
+/** Context (requirements) shared by every generated Discord operation. */
+export type DiscordOpContext = Credentials | HttpClient.HttpClient;
+export declare const DiscordProtocol: 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":"AAeA,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;AAKhE,OAAO,EAAE,WAAW,EAAe,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,WAAW,GACX,eAAe,CAAC,eAAe,CAAC;AAEpC,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,UAAU,CAAC,UAAU,CAAC;AA4CnE,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAqBlD,CAAC"}

package/lib/protocol.js

@@ -0,0 +1,81 @@
+/**
+ * DiscordProtocol — the shared bearer-REST protocol instantiated for Discord.
+ *
+ * Discord speaks plain JSON with no response envelope: successful responses
+ * are the resource (or a bare array) verbatim. Failures carry
+ * `{ code, message, errors? }` where `code` is Discord's own numeric JSON
+ * error code — the shared HTTP status map turns the status into the error
+ * class, and anything unmapped becomes {@link UnknownDiscordError} with the
+ * code and per-field `errors` detail preserved.
+ *
+ * Rate limits (429) arrive as `TooManyRequests` with `retryAfter` read from
+ * the `Retry-After` header, so the default retry policy honors Discord's
+ * bucket hints without extra configuration.
+ */
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import { makeRestProtocol, } from "@distilled.cloud/core/protocol-rest";
+import { Credentials } from "./credentials.js";
+import { UnknownDiscordError } from "./errors.js";
+/**
+ * Discord's error body is `{ code: <numeric JSON error code>, message }`.
+ * The OAuth2 token endpoints answer in the OAuth style instead
+ * (`{ error, error_description }`), so both spellings are read here.
+ */
+const errorEnvelope = (body) => {
+    if (body === null || typeof body !== "object")
+        return undefined;
+    const b = body;
+    const message = typeof b.message === "string"
+        ? b.message
+        : typeof b.error_description === "string"
+            ? b.error_description
+            : typeof b.error === "string"
+                ? b.error
+                : undefined;
+    const code = typeof b.code === "number" || typeof b.code === "string"
+        ? b.code
+        : undefined;
+    return { code, message };
+};
+/** Discord's `errors` object: per-field validation detail on 400s. */
+const errorDetails = (body) => {
+    if (body === null || typeof body !== "object")
+        return undefined;
+    return body.errors;
+};
+/**
+ * Discord's JSON error code as a number. The OAuth2 endpoints answer with a
+ * string `error` slug instead of a numeric `code` — those carry no numeric
+ * code at all, so anything unparseable is dropped rather than surfaced as
+ * NaN.
+ */
+const numericCode = (code) => {
+    if (typeof code === "number")
+        return Number.isFinite(code) ? code : undefined;
+    if (typeof code !== "string" || code.trim() === "")
+        return undefined;
+    const n = Number(code);
+    return Number.isFinite(n) ? n : undefined;
+};
+export const DiscordProtocol = makeRestProtocol({
+    // Resolved on the CALLING fiber per request (the layer is memoized per
+    // process); the Credentials service holds an effect so rotating tokens
+    // Just Work.
+    credentials: Effect.gen(function* () {
+        const resolve = yield* Credentials;
+        return yield* resolve;
+    }),
+    baseUrl: (creds) => creds.apiBaseUrl,
+    headers: (creds) => ({
+        Authorization: `${creds.tokenType} ${Redacted.value(creds.token)}`,
+    }),
+    errorEnvelope,
+    unknownError: ({ code, message, body }) => new UnknownDiscordError({
+        code: numericCode(code),
+        message,
+        errors: errorDetails(body),
+        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":"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"}

package/lib/retry.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Discord 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
+ * Discord calls below it and core's `makeDefault` is the fallback when none
+ * is provided. Discord rate limits aggressively per-bucket and answers 429s
+ * with a `Retry-After` header, which the default policy honors with
+ * precedence over its own backoff.
+ *
+ * @example
+ * ```ts
+ * import * as Discord from "@distilled.cloud/discord";
+ *
+ * myEffect.pipe(Discord.Retry.throttling);
+ * ```
+ */
+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, "DiscordRetry", Retries.Policy>;
+/** Context tag for configuring retry behavior of Discord API calls. */
+export declare class Retry extends Retry_base {
+}
+/** Provides a custom retry policy to every Discord 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;;;;;;;;;;;;;;;;GAgBG;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,uEAAuE;AACvE,qBAAa,KAAM,SAAQ,UAAgD;CAAG;AAE9E,yEAAyE;AACzE,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,45 @@
+/**
+ * Discord 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
+ * Discord calls below it and core's `makeDefault` is the fallback when none
+ * is provided. Discord rate limits aggressively per-bucket and answers 429s
+ * with a `Retry-After` header, which the default policy honors with
+ * precedence over its own backoff.
+ *
+ * @example
+ * ```ts
+ * import * as Discord from "@distilled.cloud/discord";
+ *
+ * myEffect.pipe(Discord.Retry.throttling);
+ * ```
+ */
+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 Discord API calls. */
+export class Retry extends Context.Service()("DiscordRetry") {
+}
+/** Provides a custom retry policy to every Discord 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;;;;;;;;;;;;;;;;GAgBG;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,uEAAuE;AACvE,MAAM,OAAO,KAAM,SAAQ,OAAO,CAAC,OAAO,EAAiB,CAAC,cAAc,CAAC;CAAG;AAE9E,yEAAyE;AACzE,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"}