@distilled.cloud/digitalocean 0.0.0 → 1.0.0-rc.11

package/lib/services/index.d.ts

@@ -0,0 +1,2 @@
+export * as digitalocean from "./digitalocean.ts";
+//# sourceMappingURL=index.d.ts.map

package/lib/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC"}

package/lib/services/index.js

@@ -0,0 +1,3 @@
+// AUTO-GENERATED by scripts/generate.ts. Do not edit.
+export * as digitalocean from "./digitalocean.js";
+//# sourceMappingURL=index.js.map

package/lib/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAC"}

package/lib/traits.d.ts

@@ -0,0 +1,11 @@
+/**
+ * DigitalOcean SDK trait surface — hand-written.
+ *
+ * Re-exports the generic protocol traits from core (so generated operations
+ * import everything from one place). DigitalOcean has no envelope of its
+ * own; the REST-protocol traits (SensitiveValue / RawResponse) come from
+ * `core/protocol-rest`.
+ */
+export { Body, Header, Query, Label, Http, ResponseCode, HttpBody, FormDataFile, KeyDictionary, UnionCases, applyErrorMatchers, getErrorMatchers, type HttpTrait, type ErrorMatcher, bodySymbol, headerSymbol, querySymbol, labelSymbol, httpSymbol, responseCodeSymbol, httpBodySymbol, formDataFileSymbol, keyDictionarySymbol, unionCasesSymbol, errorMatchersSymbol, } from "@distilled.cloud/core/trait";
+export { SensitiveValue, RawResponse, RawResponseRoot, sensitiveValueSymbol, rawResponseSymbol, rawResponseRootSymbol, } from "@distilled.cloud/core/protocol-rest";
+//# sourceMappingURL=traits.d.ts.map

package/lib/traits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["../src/traits.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,IAAI,EACJ,MAAM,EACN,KAAK,EACL,KAAK,EACL,IAAI,EACJ,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,cAAc,EACd,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,qCAAqC,CAAC"}

package/lib/traits.js

@@ -0,0 +1,11 @@
+/**
+ * DigitalOcean SDK trait surface — hand-written.
+ *
+ * Re-exports the generic protocol traits from core (so generated operations
+ * import everything from one place). DigitalOcean has no envelope of its
+ * own; the REST-protocol traits (SensitiveValue / RawResponse) come from
+ * `core/protocol-rest`.
+ */
+export { Body, Header, Query, Label, Http, ResponseCode, HttpBody, FormDataFile, KeyDictionary, UnionCases, applyErrorMatchers, getErrorMatchers, bodySymbol, headerSymbol, querySymbol, labelSymbol, httpSymbol, responseCodeSymbol, httpBodySymbol, formDataFileSymbol, keyDictionarySymbol, unionCasesSymbol, errorMatchersSymbol, } from "@distilled.cloud/core/trait";
+export { SensitiveValue, RawResponse, RawResponseRoot, sensitiveValueSymbol, rawResponseSymbol, rawResponseRootSymbol, } from "@distilled.cloud/core/protocol-rest";
+//# sourceMappingURL=traits.js.map

package/lib/traits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.js","sourceRoot":"","sources":["../src/traits.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,IAAI,EACJ,MAAM,EACN,KAAK,EACL,KAAK,EACL,IAAI,EACJ,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAGhB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,cAAc,EACd,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,qCAAqC,CAAC"}

package/package.json

@@ -1,14 +1,85 @@
 {
   "name": "@distilled.cloud/digitalocean",
-  "version": "0.0.0",
-  "description": "Placeholder package for an upcoming distilled SDK.",
-  "license": "Apache-2.0",
+  "version": "1.0.0-rc.11",
   "repository": {
     "type": "git",
     "url": "https://github.com/alchemy-run/distilled",
     "directory": "packages/digitalocean"
   },
-  "publishConfig": {
-    "access": "public"
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "lib",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "bun": "./src/index.ts",
+      "worker": "./src/index.ts",
+      "default": "./lib/index.js"
+    },
+    "./Credentials": {
+      "types": "./lib/credentials.d.ts",
+      "bun": "./src/credentials.ts",
+      "worker": "./src/credentials.ts",
+      "default": "./lib/credentials.js"
+    },
+    "./Errors": {
+      "types": "./lib/errors.d.ts",
+      "bun": "./src/errors.ts",
+      "worker": "./src/errors.ts",
+      "default": "./lib/errors.js"
+    },
+    "./Traits": {
+      "types": "./lib/traits.d.ts",
+      "bun": "./src/traits.ts",
+      "worker": "./src/traits.ts",
+      "default": "./lib/traits.js"
+    },
+    "./Pagination": {
+      "types": "./lib/pagination.d.ts",
+      "bun": "./src/pagination.ts",
+      "worker": "./src/pagination.ts",
+      "default": "./lib/pagination.js"
+    },
+    "./Protocol": {
+      "types": "./lib/protocol.d.ts",
+      "bun": "./src/protocol.ts",
+      "worker": "./src/protocol.ts",
+      "default": "./lib/protocol.js"
+    },
+    "./Retry": {
+      "types": "./lib/retry.d.ts",
+      "bun": "./src/retry.ts",
+      "worker": "./src/retry.ts",
+      "default": "./lib/retry.js"
+    },
+    "./*": {
+      "types": "./lib/services/*.d.ts",
+      "bun": "./src/services/*.ts",
+      "worker": "./src/services/*.ts",
+      "default": "./lib/services/*.js"
+    }
+  },
+  "dependencies": {
+    "@distilled.cloud/core": "1.0.0-rc.11"
+  },
+  "devDependencies": {
+    "@types/bun": "1.3.14",
+    "@types/node": "26.2.0",
+    "@effect/platform-bun": ">=4.0.0-rc.115 || >=4.0.0"
+  },
+  "peerDependencies": {
+    "effect": ">=4.0.0-rc.115 || >=4.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "convert": "bun scripts/convert.ts",
+    "generate": "bun scripts/convert.ts && bun scripts/generate.ts",
+    "typecheck": "tsc -p tsconfig.json",
+    "specs:fetch": "git submodule update --force --init --depth=1 specs/spec-mirror-digitalocean",
+    "specs:update": "git submodule update --remote --force --depth=1 specs/spec-mirror-digitalocean"
   }
-}
+}

package/src/credentials.ts

@@ -0,0 +1,62 @@
+/**
+ * DigitalOcean credentials — hand-written.
+ *
+ * The `Credentials` service holds an *effect* that resolves the current
+ * credentials on every request (the protocol layer resolves it per request
+ * on the calling fiber). A Personal Access Token is sent as
+ * `Authorization: Bearer <apiKey>`.
+ */
+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";
+
+export const DEFAULT_API_BASE_URL = "https://api.digitalocean.com";
+
+export interface Config {
+  readonly apiKey: Redacted.Redacted<string>;
+  readonly apiBaseUrl: string;
+}
+
+export class Credentials extends Context.Service<
+  Credentials,
+  Effect.Effect<Config>
+>()("DigitalOceanCredentials") {}
+
+/** Layer from a plain API token + optional base URL. */
+export const fromApiKey = (config: {
+  readonly apiKey: string;
+  readonly apiBaseUrl?: string;
+}): Layer.Layer<Credentials> =>
+  Layer.succeed(
+    Credentials,
+    Effect.succeed({
+      apiKey: Redacted.make(config.apiKey),
+      apiBaseUrl: config.apiBaseUrl ?? DEFAULT_API_BASE_URL,
+    }),
+  );
+
+/**
+ * Reads DIGITALOCEAN_ACCESS_TOKEN or DIGITALOCEAN_API_KEY (required) and
+ * DIGITALOCEAN_API_BASE_URL (optional). `doctl` uses DIGITALOCEAN_ACCESS_TOKEN.
+ */
+export const CredentialsFromEnv: Layer.Layer<Credentials> = Layer.succeed(
+  Credentials,
+  Effect.gen(function* () {
+    const apiKey =
+      process.env.DIGITALOCEAN_ACCESS_TOKEN ?? process.env.DIGITALOCEAN_API_KEY;
+
+    if (!apiKey) {
+      return yield* new ConfigError({
+        message:
+          "DIGITALOCEAN_ACCESS_TOKEN or DIGITALOCEAN_API_KEY environment variable is required",
+      });
+    }
+
+    return {
+      apiKey: Redacted.make(apiKey),
+      apiBaseUrl: process.env.DIGITALOCEAN_API_BASE_URL ?? DEFAULT_API_BASE_URL,
+    };
+  }).pipe(Effect.orDie),
+);

package/src/errors.ts

@@ -0,0 +1,50 @@
+/**
+ * DigitalOcean-specific error types.
+ *
+ * Re-exports the common HTTP errors from core and adds the DigitalOcean
+ * fallback errors. Note the generated service module additionally defines
+ * its own per-status matcher classes (BadRequest/NotFound/…) for the
+ * statuses each operation declares — those share `_tag`s with the core
+ * classes here, so `catchTag` works against either.
+ */
+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";
+export type { DefaultErrors } from "@distilled.cloud/core/errors";
+
+import * as Schema from "effect/Schema";
+import * as Category from "@distilled.cloud/core/category";
+
+/** Unknown DigitalOcean error — returned when nothing else matches the failure. */
+export class UnknownDigitalOceanError extends Schema.TaggedError<UnknownDigitalOceanError>()(
+  "UnknownDigitalOceanError",
+  {
+    code: Schema.optional(Schema.String),
+    message: Schema.optional(Schema.String),
+    body: Schema.Unknown,
+  },
+).pipe(Category.withServerError) {}
+
+/** Schema parse error wrapper. */
+export class DigitalOceanParseError extends Schema.TaggedError<DigitalOceanParseError>()(
+  "DigitalOceanParseError",
+  {
+    body: Schema.Unknown,
+    cause: Schema.Unknown,
+  },
+).pipe(Category.withParseError) {}

package/src/index.ts

@@ -0,0 +1,42 @@
+/**
+ * @distilled.cloud/digitalocean — DigitalOcean SDK for Effect.
+ *
+ * `./services` is generated by `scripts/generate.ts` from the Smithy model
+ * in `.generated-specs` (written by `scripts/convert.ts` from the OpenAPI
+ * spec). Everything else in this folder is hand-written.
+ *
+ * @example
+ * ```ts
+ * import * as DigitalOcean from "@distilled.cloud/digitalocean";
+ *
+ * const account = yield* DigitalOcean.Services.digitalocean.accountGet({});
+ * ```
+ */
+export * from "./credentials.ts";
+export * from "./errors.ts";
+export * as T from "./traits.ts";
+export {
+  DigitalOceanProtocol,
+  type DigitalOceanOpError,
+  type DigitalOceanOpContext,
+} from "./protocol.ts";
+export { paginateCursor, paginatePageNumber } from "./pagination.ts";
+export * as Retry from "./retry.ts";
+export * as Services from "./services/index.ts";
+// Operations (and their request/response types) are importable off the package
+// root. The service-local typed error classes shadow the same-named shared
+// ones from ./errors.ts — the ops actually raise the service-local classes.
+//
+// The API also models a `Credentials` schema (a database connection's
+// user/password), which would collide with the `Credentials` service from
+// ./credentials.ts. That one stays at the root; the schema is reachable as
+// `Services.digitalocean.Credentials`.
+export * from "./services/digitalocean.ts";
+export { Credentials } from "./credentials.ts";
+export {
+  BadRequest,
+  Conflict,
+  Forbidden,
+  NotFound,
+  UnprocessableEntity,
+} from "./services/digitalocean.ts";

package/src/pagination.ts

@@ -0,0 +1,12 @@
+/**
+ * DigitalOcean pagination — hand-written.
+ *
+ * List operations that the converter stamps as paginated are either
+ * page-number mode (`page` in, `next_page` out) or cursor mode (`cursor`
+ * in, `pagination.cursor` out). Generated operations pass the matching
+ * core strategy to `API.makePaginated`.
+ */
+export {
+  paginateCursor,
+  paginatePageNumber,
+} from "@distilled.cloud/core/pagination";

package/src/protocol.ts

@@ -0,0 +1,92 @@
+/**
+ * DigitalOceanProtocol — hand-written.
+ *
+ * DigitalOcean speaks plain bearer-authenticated JSON REST (no success
+ * envelope), so the whole protocol is one `makeRestProtocol` call from
+ * `core/protocol-rest`:
+ *
+ *   request:  credentials → `Authorization: Bearer <apiKey>` + base URL
+ *             (default https://api.digitalocean.com), resolved from the
+ *             calling fiber on every request. Generated operations carry
+ *             `/v2/...` routes.
+ *
+ *   response: 2xx JSON is the payload (sensitive members delivered as
+ *             `Redacted`); non-2xx `{ id, message, request_id? }` bodies
+ *             map to the operation's typed error classes by status, then
+ *             the shared HTTP-status classes, then
+ *             {@link UnknownDigitalOceanError}.
+ */
+import * as Effect from "effect/Effect";
+import type * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+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 {
+  makeRestProtocol,
+  type RestErrorEnvelope,
+} from "@distilled.cloud/core/protocol-rest";
+import type { API_ERRORS, ConfigError } from "@distilled.cloud/core/errors";
+import { Credentials, type Config } from "./credentials.ts";
+import { UnknownDigitalOceanError } from "./errors.ts";
+
+/**
+ * Error channel shared by every generated DigitalOcean operation. Generated
+ * service files annotate operations with `API.OperationMethod<I, O,
+ * DigitalOceanOpError, DigitalOceanOpContext>` explicitly so the compiler
+ * never infers these back out of the schema generics.
+ */
+export type DigitalOceanOpError =
+  | InstanceType<(typeof API_ERRORS)[number]>
+  | UnknownDigitalOceanError
+  | ConfigError
+  | HttpClientError.HttpClientError;
+
+/** Context (requirements) shared by every generated DigitalOcean operation. */
+export type DigitalOceanOpContext = Credentials | HttpClient.HttpClient;
+
+/**
+ * DigitalOcean error bodies are `{ id, message, request_id? }` — `id` is the
+ * machine-readable half (`not_found`, `forbidden`, …). A response that
+ * arrives without that envelope falls through to the protocol's `HTTP
+ * <status>` default.
+ */
+const errorEnvelope = (body: unknown): RestErrorEnvelope | undefined => {
+  if (body === null || typeof body !== "object") return undefined;
+  const b = body as Record<string, unknown>;
+  const code =
+    typeof b.id === "string"
+      ? b.id
+      : typeof b.code === "string"
+        ? b.code
+        : undefined;
+  const message = typeof b.message === "string" ? b.message : undefined;
+  if (code === undefined && message === undefined) return undefined;
+  return { code, message };
+};
+
+export const DigitalOceanProtocol: Layer.Layer<API.Protocol> =
+  makeRestProtocol<Config>({
+    // The Credentials service holds an effect — resolving it here (per
+    // request, on the calling fiber) picks up context-provided credentials.
+    credentials: Effect.gen(function* () {
+      const resolve = yield* Credentials;
+      return yield* resolve;
+    }),
+    baseUrl: (creds) => creds.apiBaseUrl,
+    headers: (creds) => ({
+      Authorization: `Bearer ${Redacted.value(creds.apiKey)}`,
+    }),
+    errorEnvelope,
+    unknownError: ({ code, message, body }) =>
+      new UnknownDigitalOceanError({
+        code:
+          typeof code === "string"
+            ? code
+            : code !== undefined
+              ? String(code)
+              : undefined,
+        message,
+        body,
+      }),
+  });

package/src/retry.ts

@@ -0,0 +1,56 @@
+/**
+ * DigitalOcean retry configuration.
+ *
+ * Defines the per-SDK `Retry` Context.Service tag that generated operations
+ * wire into `API.make`. Callers can install a blanket retry policy at the
+ * layer level and have every DigitalOcean API call below it pick it up:
+ *
+ * @example
+ * ```ts
+ * import * as DigitalOcean from "@distilled.cloud/digitalocean";
+ *
+ * myEffect.pipe(DigitalOcean.Retry.transient);
+ * Effect.provide(myEffect, Layer.succeed(DigitalOcean.Retry.Retry, customPolicy));
+ * ```
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import {
+  type Policy,
+  throttlingFactory,
+  transientFactory,
+} from "@distilled.cloud/core/retry";
+
+export {
+  type Options,
+  type Factory,
+  type Policy,
+  makeDefault,
+  jittered,
+  capped,
+  throttlingOptions,
+  transientOptions,
+  throttlingFactory,
+  transientFactory,
+} from "@distilled.cloud/core/retry";
+
+/** Context tag for configuring retry behavior of DigitalOcean API calls. */
+export class Retry extends Context.Service<Retry, Policy>()(
+  "DigitalOceanRetry",
+) {}
+
+/** Provides a custom retry policy to every DigitalOcean API call below it. */
+export const policy = (optionsOrFactory: Policy) =>
+  Effect.provide(Layer.succeed(Retry, optionsOrFactory));
+
+/** Disables all automatic retries. */
+export const none = Effect.provide(
+  Layer.succeed(Retry, { while: () => false }),
+);
+
+/** Apply the throttling retry policy (retries throttling errors indefinitely). */
+export const throttling = policy(throttlingFactory);
+
+/** Apply the transient retry policy (retries all transient errors indefinitely). */
+export const transient = policy(transientFactory);