@buildinternet/releases-sdk 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,78 @@
-# Temporary Holding Version
+# @buildinternet/releases-sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+TypeScript client for the [Releases](https://releases.sh) API at `api.releases.sh`. Request and response types come from [`@buildinternet/releases-api-types`](../api-types); the client calls only the operations in the public API surface ([`apps/api/src/api-surface.ts`](../../apps/api/src/api-surface.ts)). It runs anywhere `fetch` does: Node 18+, Bun, Deno, browsers and workers.
+
+## Usage
+
+```ts
+import { Releases, ReleasesError } from "@buildinternet/releases-sdk";
+
+const releases = new Releases({ apiKey: process.env.RELEASES_API_KEY });
+
+// Public reads work without a key, at a lower rate limit.
+const { releases: latest } = await releases.releases.latest({ org: "vercel", count: 10 });
+const hits = await releases.search({ q: "edge functions", mode: "hybrid" });
+const changelog = await releases.sources.changelog(
+  { org: "vercel", source: "next-js" },
+  { tokens: 2000 },
+);
+
+// Cursor pagination: pass `pagination.nextCursor` back as `cursor`.
+let page = await releases.orgs.releases("vercel", { limit: 50 });
+while (page.pagination.nextCursor) {
+  page = await releases.orgs.releases("vercel", { limit: 50, cursor: page.pagination.nextCursor });
+}
+
+try {
+  await releases.orgs.get("no-such-org");
+} catch (err) {
+  if (err instanceof ReleasesError && err.type === "not_found") {
+    // err.status, err.code, err.message, err.details
+  }
+}
+```
+
+### Publishing releases
+
+A publish token (minted for one source) or a `write` token can publish:
+
+```ts
+const publisher = new Releases({ apiKey: process.env.RELEASES_PUBLISH_TOKEN });
+await publisher.sources.publish(
+  { org: "acme", source: "acme-cli" },
+  {
+    mode: "upsert-content",
+    releases: [
+      { title: "v2.1.0", version: "2.1.0", content: "…", url: "https://acme.dev/changelog#v2.1.0" },
+    ],
+  },
+  { idempotencyKey: crypto.randomUUID() },
+);
+```
+
+### Account
+
+With a user key (`relu_`) or OAuth token: `me.follows`, `me.feed`, `me.webhooks`, `apiKeys`, and `workspaceWebhooks(workspaceId)`.
+
+Anything not wrapped yet is reachable through `request`, by its surface key:
+
+```ts
+const overview = await releases.request("GET /products/:slug/overview", {
+  params: { slug: "next-js" },
+});
+```
+
+## Options
+
+| Option    | Default                   | Notes                                       |
+| --------- | ------------------------- | ------------------------------------------- |
+| `apiKey`  | none                      | Sent as `Authorization: Bearer …`.          |
+| `baseUrl` | `https://api.releases.sh` | Use your own origin for staging or a fork.  |
+| `fetch`   | global `fetch`            | Inject for tests, proxies, or custom retry. |
+| `headers` | none                      | Sent with every request.                    |
+
+Every method also takes `{ signal, headers, idempotencyKey }` as its last argument.
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,219 @@
+import type { BatchReleasesBody, BatchReleasesResponse, CollectionDetail, CollectionListResponse, CollectionReleasesResponse, CreateUserApiKeyBody, CreateUserWebhookBody, CreateUserWebhookResponse, CreateWorkspaceWebhookBody, CreateWorkspaceWebhookResponse, CreatedUserApiKey, DomainLookupResponse, FollowMutationResponse, FollowTarget, FollowsListResponse, ListUserApiKeysResponse, OrgDetail, OrgListResponse, OrgOverviewResponse, OrgReleasesFeedResponse, PersonalizedFeedResponse, ProductDetail, ProductListResponse, ReleaseCoverageResponse, ReleaseDetailResponse, ReleaseLatestResponse, RevokeUserApiKeyResponse, RotateUserWebhookSecretResponse, SourceChangelogResponse, SourceDetail, SourceListResult, SourceReleasesResponse, StatsResponse, TestUserWebhookResponse, UnifiedSearchResponse, UpdateWebhookBody, UserWebhook, UserWebhookListResponse, WebhookDeliveriesResponse, WhatsChangedResponse, WorkspaceWebhook, WorkspaceWebhookListResponse } from "@buildinternet/releases-api-types";
+import { type ClientOptions, type RequestOptions } from "./transport.js";
+/** Entity kinds used by the `kind` filters. */
+export type Kind = "platform" | "sdk" | "mobile" | "desktop" | "docs" | "integration" | "tool";
+/** A source by slug or `src_…` ID, or by its org-scoped slug pair. */
+export type SourceRef = string | {
+    org: string;
+    source: string;
+};
+/** A product by slug or `prod_…` ID, or by its org-scoped slug pair. */
+export type ProductRef = string | {
+    org: string;
+    product: string;
+};
+export interface LatestReleasesQuery {
+    /** Number of releases to return. */
+    count?: number;
+    /** Source slug or ID. */
+    source?: string;
+    /** Org slug or ID. */
+    org?: string;
+    /** Comma-separated org slugs to leave out. */
+    exclude?: string;
+    /** ISO 8601 lower bound on `publishedAt`. */
+    since?: string;
+    /** ISO 8601 upper bound on `publishedAt`. */
+    until?: string;
+    /** Only releases with an AI-scored importance of at least this (1–5). */
+    minImportance?: number;
+    include_coverage?: boolean;
+    include_prereleases?: boolean;
+}
+export interface CursorQuery {
+    /** `pagination.nextCursor` from the previous page. */
+    cursor?: string;
+    limit?: number;
+}
+export interface OrgReleasesQuery extends CursorQuery {
+    source_type?: string;
+    kind?: Kind;
+    /** Product slug. */
+    product?: string;
+    q?: string;
+    since?: string;
+    until?: string;
+    include_coverage?: boolean;
+    include_prereleases?: boolean;
+}
+export interface OrgListQuery {
+    q?: string;
+    category?: string;
+    page?: number;
+    limit?: number;
+    featured?: boolean;
+    includeEmpty?: boolean;
+}
+export interface SearchQuery {
+    q: string;
+    limit?: number;
+    offset?: number;
+    mode?: "lexical" | "semantic" | "hybrid";
+    domain?: string;
+    product?: string;
+    category?: string;
+    collection?: string;
+    kind?: Kind;
+    since?: string;
+    until?: string;
+    include_coverage?: boolean;
+    include_content?: boolean;
+    include_empty?: boolean;
+}
+export interface ChangelogQuery {
+    /** Repo path of the file, from `files[].path`. Defaults to the root CHANGELOG. */
+    path?: string;
+    offset?: number;
+    /** Slice length in characters. */
+    limit?: number;
+    /** Slice to this many cl100k_base tokens instead of `limit` characters. */
+    tokens?: number;
+}
+export interface CollectionReleasesQuery extends CursorQuery {
+    /** Comma-separated org slugs. */
+    orgs?: string;
+    /** Comma-separated product slugs. */
+    products?: string;
+    source_type?: string;
+    include_prereleases?: boolean;
+}
+export interface WhatsChangedQuery {
+    package: string;
+    from: string;
+    to: string;
+    ecosystem?: "npm" | "pypi" | "github";
+}
+export interface DeliveriesQuery {
+    /** Only failed attempts. */
+    failed?: boolean;
+    /** 1–100, default 20. */
+    limit?: number;
+}
+/**
+ * Client for the Releases API.
+ *
+ * ```ts
+ * const releases = new Releases({ apiKey: process.env.RELEASES_API_KEY });
+ * const { releases: latest } = await releases.releases.latest({ org: "vercel", count: 10 });
+ * ```
+ */
+export declare class Releases {
+    #private;
+    constructor(options?: ClientOptions);
+    /** Send any public operation by its surface key, e.g. `"GET /orgs/:slug"`. */
+    request<T = unknown>(operation: string, call?: {
+        params?: Record<string, string>;
+        query?: object;
+        body?: unknown;
+    } & RequestOptions): Promise<T>;
+    /** Lexical, semantic, or hybrid search across orgs, sources, and releases. */
+    search(query: SearchQuery, opts?: RequestOptions): Promise<UnifiedSearchResponse>;
+    /** Registry totals; `days` sets the recent-activity window. */
+    stats(query?: {
+        days?: number;
+    }, opts?: RequestOptions): Promise<StatsResponse>;
+    /** Release notes between two versions of a package. */
+    whatsChanged(query: WhatsChangedQuery, opts?: RequestOptions): Promise<WhatsChangedResponse>;
+    readonly releases: {
+        latest: (query?: LatestReleasesQuery, opts?: RequestOptions) => Promise<ReleaseLatestResponse>;
+        get: (id: string, opts?: RequestOptions) => Promise<ReleaseDetailResponse>;
+        coverage: (id: string, opts?: RequestOptions) => Promise<ReleaseCoverageResponse>;
+    };
+    readonly orgs: {
+        list: (query?: OrgListQuery, opts?: RequestOptions) => Promise<OrgListResponse>;
+        get: (slug: string, opts?: RequestOptions) => Promise<OrgDetail>;
+        releases: (slug: string, query?: OrgReleasesQuery, opts?: RequestOptions) => Promise<OrgReleasesFeedResponse>;
+        products: (slug: string, query?: {
+            kind?: Kind;
+        }, opts?: RequestOptions) => Promise<ProductListResponse>;
+        overview: (slug: string, opts?: RequestOptions) => Promise<OrgOverviewResponse>;
+    };
+    readonly products: {
+        list: (query?: {
+            orgId?: string;
+            kind?: Kind;
+        }, opts?: RequestOptions) => Promise<ProductListResponse>;
+        get: (ref: ProductRef, opts?: RequestOptions) => Promise<ProductDetail>;
+    };
+    readonly sources: {
+        list: (query?: {
+            kind?: Kind;
+        }, opts?: RequestOptions) => Promise<SourceListResult>;
+        get: (ref: SourceRef, opts?: RequestOptions) => Promise<SourceDetail>;
+        releases: (ref: SourceRef, opts?: RequestOptions) => Promise<SourceReleasesResponse>;
+        /** The source's tracked CHANGELOG file, sliced; page with `nextOffset`. */
+        changelog: (ref: SourceRef, query?: ChangelogQuery, opts?: RequestOptions) => Promise<SourceChangelogResponse>;
+        /**
+         * Publish releases to a source. Needs a `write` token or a publish token
+         * bound to the source. Releases match on `url`; pass
+         * `mode: "upsert-content"` to overwrite content on a match.
+         */
+        publish: (ref: SourceRef, body: BatchReleasesBody, opts?: RequestOptions) => Promise<BatchReleasesResponse>;
+    };
+    readonly collections: {
+        list: (query?: {
+            featured?: boolean;
+        }, opts?: RequestOptions) => Promise<CollectionListResponse>;
+        get: (slug: string, opts?: RequestOptions) => Promise<CollectionDetail>;
+        releases: (slug: string, query?: CollectionReleasesQuery, opts?: RequestOptions) => Promise<CollectionReleasesResponse>;
+    };
+    readonly lookups: {
+        /** The org, products, and sources registered for a domain. */
+        byDomain: (domain: string, opts?: RequestOptions) => Promise<DomainLookupResponse>;
+    };
+    /** The signed-in caller's account. Needs a user key (`relu_`) or OAuth token. */
+    readonly me: {
+        follows: {
+            list: (opts?: RequestOptions) => Promise<FollowsListResponse>;
+            /** Following an org includes its products in the feed. Idempotent. */
+            add: (targetType: FollowTarget, targetId: string, opts?: RequestOptions) => Promise<FollowMutationResponse>;
+            remove: (targetType: FollowTarget, targetId: string, opts?: RequestOptions) => Promise<FollowMutationResponse>;
+        };
+        /** Releases from everything the caller follows, newest first. */
+        feed: (query?: CursorQuery, opts?: RequestOptions) => Promise<PersonalizedFeedResponse>;
+        webhooks: {
+            list: (query?: {
+                enabled?: boolean;
+            }, opts?: RequestOptions) => Promise<UserWebhookListResponse>;
+            /** The response carries the signing key; it is shown only once. */
+            create: (body: CreateUserWebhookBody, opts?: RequestOptions) => Promise<CreateUserWebhookResponse>;
+            get: (id: string, opts?: RequestOptions) => Promise<UserWebhook>;
+            update: (id: string, body: UpdateWebhookBody, opts?: RequestOptions) => Promise<UserWebhook>;
+            delete: (id: string, opts?: RequestOptions) => Promise<void>;
+            deliveries: (id: string, query?: DeliveriesQuery, opts?: RequestOptions) => Promise<WebhookDeliveriesResponse>;
+            rotateSecret: (id: string, opts?: RequestOptions) => Promise<RotateUserWebhookSecretResponse>;
+            test: (id: string, opts?: RequestOptions) => Promise<TestUserWebhookResponse>;
+        };
+    };
+    /** Self-serve `relu_` keys. Keys minted here are capped at `read` scope. */
+    readonly apiKeys: {
+        list: (opts?: RequestOptions) => Promise<ListUserApiKeysResponse>;
+        /** The response carries the full key; it is shown only once. */
+        create: (body: CreateUserApiKeyBody, opts?: RequestOptions) => Promise<CreatedUserApiKey>;
+        revoke: (id: string, opts?: RequestOptions) => Promise<RevokeUserApiKeyResponse>;
+    };
+    /** Webhooks owned by a workspace. Members can read and test; owners and admins manage. */
+    workspaceWebhooks(workspaceId: string): {
+        list: (query?: {
+            enabled?: boolean;
+        }, opts?: RequestOptions) => Promise<WorkspaceWebhookListResponse>;
+        create: (body: CreateWorkspaceWebhookBody, opts?: RequestOptions) => Promise<CreateWorkspaceWebhookResponse>;
+        get: (id: string, opts?: RequestOptions) => Promise<WorkspaceWebhook>;
+        update: (id: string, body: UpdateWebhookBody, opts?: RequestOptions) => Promise<WorkspaceWebhook>;
+        delete: (id: string, opts?: RequestOptions) => Promise<void>;
+        deliveries: (id: string, query?: DeliveriesQuery, opts?: RequestOptions) => Promise<WebhookDeliveriesResponse>;
+        rotateSecret: (id: string, opts?: RequestOptions) => Promise<RotateUserWebhookSecretResponse>;
+        test: (id: string, opts?: RequestOptions) => Promise<TestUserWebhookResponse>;
+    };
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,EAC1B,8BAA8B,EAC9B,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACvB,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,+BAA+B,EAC/B,uBAAuB,EACvB,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,gBAAgB,EAChB,4BAA4B,EAC7B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAa,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpF,+CAA+C;AAC/C,MAAM,MAAM,IAAI,GAAG,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;AAE/F,sEAAsE;AACtE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,wEAAwE;AACxE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;CACvC;AAED,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,qBAAa,QAAQ;;IAGnB,YAAY,OAAO,GAAE,aAAkB,EAEtC;IAiBD,8EAA8E;IAC9E,OAAO,CAAC,CAAC,GAAG,OAAO,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,cAAc,GAC1F,OAAO,CAAC,CAAC,CAAC,CAEZ;IAED,8EAA8E;IAC9E,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAEhF;IAED,+DAA+D;IAC/D,KAAK,CAAC,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAE9E;IAED,uDAAuD;IACvD,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAE3F;IAED,QAAQ,CAAC,QAAQ;QACf,MAAM,WAAW,mBAAmB,SAAS,cAAc,KAAG,OAAO,CAAC,qBAAqB,CAAC;QAE5F,GAAG,OAAO,MAAM,SAAS,cAAc,KAAG,OAAO,CAAC,qBAAqB,CAAC;QAExE,QAAQ,OAAO,MAAM,SAAS,cAAc,KAAG,OAAO,CAAC,uBAAuB,CAAC;MAE/E;IAEF,QAAQ,CAAC,IAAI;QACX,IAAI,WAAW,YAAY,SAAS,cAAc,KAAG,OAAO,CAAC,eAAe,CAAC;QAE7E,GAAG,SAAS,MAAM,SAAS,cAAc,KAAG,OAAO,CAAC,SAAS,CAAC;QAE9D,QAAQ,SACA,MAAM,UACJ,gBAAgB,SACjB,cAAc,KACpB,OAAO,CAAC,uBAAuB,CAAC;QAEnC,QAAQ,SACA,MAAM,UACJ;YAAE,IAAI,CAAC,EAAE,IAAI,CAAA;SAAE,SAChB,cAAc,KACpB,OAAO,CAAC,mBAAmB,CAAC;QAE/B,QAAQ,SAAS,MAAM,SAAS,cAAc,KAAG,OAAO,CAAC,mBAAmB,CAAC;MAE7E;IAEF,QAAQ,CAAC,QAAQ;QACf,IAAI,WACM;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,IAAI,CAAA;SAAE,SAChC,cAAc,KACpB,OAAO,CAAC,mBAAmB,CAAC;QAC/B,GAAG,QAAQ,UAAU,SAAS,cAAc,KAAG,OAAO,CAAC,aAAa,CAAC;MAOrE;IAEF,QAAQ,CAAC,OAAO;QACd,IAAI,WAAW;YAAE,IAAI,CAAC,EAAE,IAAI,CAAA;SAAE,SAAS,cAAc,KAAG,OAAO,CAAC,gBAAgB,CAAC;QAEjF,GAAG,QAAQ,SAAS,SAAS,cAAc,KAAG,OAAO,CAAC,YAAY,CAAC;QAEnE,QAAQ,QAAQ,SAAS,SAAS,cAAc,KAAG,OAAO,CAAC,sBAAsB,CAAC;QAOlF,2EAA2E;QAC3E,SAAS,QACF,SAAS,UACN,cAAc,SACf,cAAc,KACpB,OAAO,CAAC,uBAAuB,CAAC;QAOnC;;;;WAIG;QACH,OAAO,QACA,SAAS,QACR,iBAAiB,SAChB,cAAc,KACpB,OAAO,CAAC,qBAAqB,CAAC;MAOjC;IAEF,QAAQ,CAAC,WAAW;QAClB,IAAI,WACM;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE,SACvB,cAAc,KACpB,OAAO,CAAC,sBAAsB,CAAC;QAClC,GAAG,SAAS,MAAM,SAAS,cAAc,KAAG,OAAO,CAAC,gBAAgB,CAAC;QAErE,QAAQ,SACA,MAAM,UACJ,uBAAuB,SACxB,cAAc,KACpB,OAAO,CAAC,0BAA0B,CAAC;MAEtC;IAEF,QAAQ,CAAC,OAAO;QACd,8DAA8D;QAC9D,QAAQ,WAAW,MAAM,SAAS,cAAc,KAAG,OAAO,CAAC,oBAAoB,CAAC;MAEhF;IAEF,iFAAiF;IACjF,QAAQ,CAAC,EAAE;QACT,OAAO;YACL,IAAI,UAAU,cAAc,KAAG,OAAO,CAAC,mBAAmB,CAAC;YAE3D,sEAAsE;YACtE,GAAG,eACW,YAAY,YACd,MAAM,SACT,cAAc,KACpB,OAAO,CAAC,sBAAsB,CAAC;YAElC,MAAM,eACQ,YAAY,YACd,MAAM,SACT,cAAc,KACpB,OAAO,CAAC,sBAAsB,CAAC;;QAMpC,iEAAiE;QACjE,IAAI,WAAW,WAAW,SAAS,cAAc,KAAG,OAAO,CAAC,wBAAwB,CAAC;QAErF,QAAQ;YACN,IAAI,WACM;gBAAE,OAAO,CAAC,EAAE,OAAO,CAAA;aAAE,SACtB,cAAc,KACpB,OAAO,CAAC,uBAAuB,CAAC;YAEnC,mEAAmE;YACnE,MAAM,SACE,qBAAqB,SACpB,cAAc,KACpB,OAAO,CAAC,yBAAyB,CAAC;YAErC,GAAG,OAAO,MAAM,SAAS,cAAc,KAAG,OAAO,CAAC,WAAW,CAAC;YAE9D,MAAM,OAAO,MAAM,QAAQ,iBAAiB,SAAS,cAAc,KAAG,OAAO,CAAC,WAAW,CAAC;YAE1F,MAAM,OAAO,MAAM,SAAS,cAAc,KAAG,OAAO,CAAC,IAAI,CAAC;YAE1D,UAAU,OACJ,MAAM,UACF,eAAe,SAChB,cAAc,KACpB,OAAO,CAAC,yBAAyB,CAAC;YAErC,YAAY,OAAO,MAAM,SAAS,cAAc,KAAG,OAAO,CAAC,+BAA+B,CAAC;YAE3F,IAAI,OAAO,MAAM,SAAS,cAAc,KAAG,OAAO,CAAC,uBAAuB,CAAC;;MAG7E;IAEF,4EAA4E;IAC5E,QAAQ,CAAC,OAAO;QACd,IAAI,UAAU,cAAc,KAAG,OAAO,CAAC,uBAAuB,CAAC;QAE/D,gEAAgE;QAChE,MAAM,SAAS,oBAAoB,SAAS,cAAc,KAAG,OAAO,CAAC,iBAAiB,CAAC;QAEvF,MAAM,OAAO,MAAM,SAAS,cAAc,KAAG,OAAO,CAAC,wBAAwB,CAAC;MAE9E;IAEF,0FAA0F;IAC1F,iBAAiB,CAAC,WAAW,EAAE,MAAM;QAKjC,IAAI,WACM;YAAE,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE,SACtB,cAAc,KACpB,OAAO,CAAC,4BAA4B,CAAC;QAExC,MAAM,SACE,0BAA0B,SACzB,cAAc,KACpB,OAAO,CAAC,8BAA8B,CAAC;QAE1C,GAAG,OAAO,MAAM,SAAS,cAAc,KAAG,OAAO,CAAC,gBAAgB,CAAC;QAEnE,MAAM,OACA,MAAM,QACJ,iBAAiB,SAChB,cAAc,KACpB,OAAO,CAAC,gBAAgB,CAAC;QAM5B,MAAM,OAAO,MAAM,SAAS,cAAc,KAAG,OAAO,CAAC,IAAI,CAAC;QAE1D,UAAU,OACJ,MAAM,UACF,eAAe,SAChB,cAAc,KACpB,OAAO,CAAC,yBAAyB,CAAC;QAMrC,YAAY,OAAO,MAAM,SAAS,cAAc,KAAG,OAAO,CAAC,+BAA+B,CAAC;QAK3F,IAAI,OAAO,MAAM,SAAS,cAAc,KAAG,OAAO,CAAC,uBAAuB,CAAC;MAG9E;CACF"}

package/dist/client.js

@@ -0,0 +1,141 @@
+import { Transport } from "./transport.js";
+/**
+ * Client for the Releases API.
+ *
+ * ```ts
+ * const releases = new Releases({ apiKey: process.env.RELEASES_API_KEY });
+ * const { releases: latest } = await releases.releases.latest({ org: "vercel", count: 10 });
+ * ```
+ */
+export class Releases {
+    #t;
+    constructor(options = {}) {
+        this.#t = new Transport(options);
+    }
+    /** A bare-path operation for a slug/ID ref, its org-scoped twin for a slug pair. */
+    #source(ref, bare, scoped, call = {}) {
+        return typeof ref === "string"
+            ? this.#t.request(bare, { params: { slug: ref }, ...call })
+            : this.#t.request(scoped, {
+                params: { orgSlug: ref.org, sourceSlug: ref.source },
+                ...call,
+            });
+    }
+    /** Send any public operation by its surface key, e.g. `"GET /orgs/:slug"`. */
+    request(operation, call) {
+        return this.#t.request(operation, call);
+    }
+    /** Lexical, semantic, or hybrid search across orgs, sources, and releases. */
+    search(query, opts) {
+        return this.#t.request("GET /search", { query, ...opts });
+    }
+    /** Registry totals; `days` sets the recent-activity window. */
+    stats(query, opts) {
+        return this.#t.request("GET /stats", { query, ...opts });
+    }
+    /** Release notes between two versions of a package. */
+    whatsChanged(query, opts) {
+        return this.#t.request("GET /whats-changed", { query, ...opts });
+    }
+    releases = {
+        latest: (query, opts) => this.#t.request("GET /releases/latest", { query, ...opts }),
+        get: (id, opts) => this.#t.request("GET /releases/:id", { params: { id }, ...opts }),
+        coverage: (id, opts) => this.#t.request("GET /releases/:id/coverage", { params: { id }, ...opts }),
+    };
+    orgs = {
+        list: (query, opts) => this.#t.request("GET /orgs", { query, ...opts }),
+        get: (slug, opts) => this.#t.request("GET /orgs/:slug", { params: { slug }, ...opts }),
+        releases: (slug, query, opts) => this.#t.request("GET /orgs/:slug/releases", { params: { slug }, query, ...opts }),
+        products: (slug, query, opts) => this.#t.request("GET /orgs/:slug/products", { params: { slug }, query, ...opts }),
+        overview: (slug, opts) => this.#t.request("GET /orgs/:slug/overview", { params: { slug }, ...opts }),
+    };
+    products = {
+        list: (query, opts) => this.#t.request("GET /products", { query, ...opts }),
+        get: (ref, opts) => typeof ref === "string"
+            ? this.#t.request("GET /products/:identifier", { params: { identifier: ref }, ...opts })
+            : this.#t.request("GET /orgs/:orgSlug/products/:productSlug", {
+                params: { orgSlug: ref.org, productSlug: ref.product },
+                ...opts,
+            }),
+    };
+    sources = {
+        list: (query, opts) => this.#t.request("GET /sources", { query, ...opts }),
+        get: (ref, opts) => this.#source(ref, "GET /sources/:slug", "GET /orgs/:orgSlug/sources/:sourceSlug", opts),
+        releases: (ref, opts) => this.#source(ref, "GET /sources/:slug/releases", "GET /orgs/:orgSlug/sources/:sourceSlug/releases", opts),
+        /** The source's tracked CHANGELOG file, sliced; page with `nextOffset`. */
+        changelog: (ref, query, opts) => this.#source(ref, "GET /sources/:slug/changelog", "GET /orgs/:orgSlug/sources/:sourceSlug/changelog", { query, ...opts }),
+        /**
+         * Publish releases to a source. Needs a `write` token or a publish token
+         * bound to the source. Releases match on `url`; pass
+         * `mode: "upsert-content"` to overwrite content on a match.
+         */
+        publish: (ref, body, opts) => this.#source(ref, "POST /sources/:slug/releases/batch", "POST /orgs/:orgSlug/sources/:sourceSlug/releases/batch", { body, ...opts }),
+    };
+    collections = {
+        list: (query, opts) => this.#t.request("GET /collections", { query, ...opts }),
+        get: (slug, opts) => this.#t.request("GET /collections/:slug", { params: { slug }, ...opts }),
+        releases: (slug, query, opts) => this.#t.request("GET /collections/:slug/releases", { params: { slug }, query, ...opts }),
+    };
+    lookups = {
+        /** The org, products, and sources registered for a domain. */
+        byDomain: (domain, opts) => this.#t.request("GET /lookups/by-domain", { query: { domain }, ...opts }),
+    };
+    /** The signed-in caller's account. Needs a user key (`relu_`) or OAuth token. */
+    me = {
+        follows: {
+            list: (opts) => this.#t.request("GET /me/follows", opts),
+            /** Following an org includes its products in the feed. Idempotent. */
+            add: (targetType, targetId, opts) => this.#t.request("POST /me/follows", { body: { targetType, targetId }, ...opts }),
+            remove: (targetType, targetId, opts) => this.#t.request("DELETE /me/follows/:targetType/:targetId", {
+                params: { targetType, targetId },
+                ...opts,
+            }),
+        },
+        /** Releases from everything the caller follows, newest first. */
+        feed: (query, opts) => this.#t.request("GET /me/feed", { query, ...opts }),
+        webhooks: {
+            list: (query, opts) => this.#t.request("GET /me/webhooks", { query, ...opts }),
+            /** The response carries the signing key; it is shown only once. */
+            create: (body, opts) => this.#t.request("POST /me/webhooks", { body, ...opts }),
+            get: (id, opts) => this.#t.request("GET /me/webhooks/:id", { params: { id }, ...opts }),
+            update: (id, body, opts) => this.#t.request("PATCH /me/webhooks/:id", { params: { id }, body, ...opts }),
+            delete: (id, opts) => this.#t.request("DELETE /me/webhooks/:id", { params: { id }, ...opts }),
+            deliveries: (id, query, opts) => this.#t.request("GET /me/webhooks/:id/deliveries", { params: { id }, query, ...opts }),
+            rotateSecret: (id, opts) => this.#t.request("POST /me/webhooks/:id/rotate-secret", { params: { id }, ...opts }),
+            test: (id, opts) => this.#t.request("POST /me/webhooks/:id/test", { params: { id }, ...opts }),
+        },
+    };
+    /** Self-serve `relu_` keys. Keys minted here are capped at `read` scope. */
+    apiKeys = {
+        list: (opts) => this.#t.request("GET /api-keys", opts),
+        /** The response carries the full key; it is shown only once. */
+        create: (body, opts) => this.#t.request("POST /api-keys", { body, ...opts }),
+        revoke: (id, opts) => this.#t.request("DELETE /api-keys/:id", { params: { id }, ...opts }),
+    };
+    /** Webhooks owned by a workspace. Members can read and test; owners and admins manage. */
+    workspaceWebhooks(workspaceId) {
+        const t = this.#t;
+        const at = (id) => id === undefined ? { workspaceId } : { workspaceId, id };
+        return {
+            list: (query, opts) => t.request("GET /workspaces/:workspaceId/webhooks", { params: at(), query, ...opts }),
+            create: (body, opts) => t.request("POST /workspaces/:workspaceId/webhooks", { params: at(), body, ...opts }),
+            get: (id, opts) => t.request("GET /workspaces/:workspaceId/webhooks/:id", { params: at(id), ...opts }),
+            update: (id, body, opts) => t.request("PATCH /workspaces/:workspaceId/webhooks/:id", {
+                params: at(id),
+                body,
+                ...opts,
+            }),
+            delete: (id, opts) => t.request("DELETE /workspaces/:workspaceId/webhooks/:id", { params: at(id), ...opts }),
+            deliveries: (id, query, opts) => t.request("GET /workspaces/:workspaceId/webhooks/:id/deliveries", {
+                params: at(id),
+                query,
+                ...opts,
+            }),
+            rotateSecret: (id, opts) => t.request("POST /workspaces/:workspaceId/webhooks/:id/rotate-secret", {
+                params: at(id),
+                ...opts,
+            }),
+            test: (id, opts) => t.request("POST /workspaces/:workspaceId/webhooks/:id/test", { params: at(id), ...opts }),
+        };
+    }
+}

package/dist/errors.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Every non-2xx response from the Releases API carries the envelope
+ * `{ error: { code, type, message, details? } }`. `type` is a fixed category
+ * tied to the HTTP status; `code` is specific and stable but open-ended, so
+ * branch defensively on codes you don't recognize.
+ */
+export declare class ReleasesError extends Error {
+    /** HTTP status, or 0 when the request never got a response. */
+    readonly status: number;
+    /** Specific machine code, e.g. `not_found`, `rate_limited`. */
+    readonly code: string;
+    /** Coarse category, e.g. `not_found`, `validation`, `auth`, `internal`. */
+    readonly type: string;
+    readonly details?: unknown;
+    readonly method: string;
+    readonly path: string;
+    constructor(init: {
+        status: number;
+        code: string;
+        type: string;
+        message: string;
+        details?: unknown;
+        method: string;
+        path: string;
+        cause?: unknown;
+    });
+}
+/** Build a `ReleasesError` from a failed response's status and parsed body. */
+export declare function errorFromResponse(status: number, statusText: string, body: unknown, method: string, path: string): ReleasesError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,EASA;CACF;AAeD,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,aAAa,CAaf"}

package/dist/errors.js

@@ -0,0 +1,50 @@
+/**
+ * Every non-2xx response from the Releases API carries the envelope
+ * `{ error: { code, type, message, details? } }`. `type` is a fixed category
+ * tied to the HTTP status; `code` is specific and stable but open-ended, so
+ * branch defensively on codes you don't recognize.
+ */
+export class ReleasesError extends Error {
+    /** HTTP status, or 0 when the request never got a response. */
+    status;
+    /** Specific machine code, e.g. `not_found`, `rate_limited`. */
+    code;
+    /** Coarse category, e.g. `not_found`, `validation`, `auth`, `internal`. */
+    type;
+    details;
+    method;
+    path;
+    constructor(init) {
+        super(init.message, init.cause === undefined ? undefined : { cause: init.cause });
+        this.name = "ReleasesError";
+        this.status = init.status;
+        this.code = init.code;
+        this.type = init.type;
+        this.details = init.details;
+        this.method = init.method;
+        this.path = init.path;
+    }
+}
+function isEnvelope(body) {
+    const error = body?.error;
+    return (typeof error === "object" &&
+        error !== null &&
+        typeof error.code === "string" &&
+        typeof error.type === "string" &&
+        typeof error.message === "string");
+}
+/** Build a `ReleasesError` from a failed response's status and parsed body. */
+export function errorFromResponse(status, statusText, body, method, path) {
+    if (isEnvelope(body)) {
+        const { code, type, message, details } = body.error;
+        return new ReleasesError({ status, code, type, message, details, method, path });
+    }
+    return new ReleasesError({
+        status,
+        code: "unknown_error",
+        type: status >= 500 ? "internal" : "unknown",
+        message: statusText || `HTTP ${status}`,
+        method,
+        path,
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { Releases } from "./client.js";
+export type { ChangelogQuery, CollectionReleasesQuery, CursorQuery, DeliveriesQuery, Kind, LatestReleasesQuery, OrgListQuery, OrgReleasesQuery, ProductRef, SearchQuery, SourceRef, WhatsChangedQuery, } from "./client.js";
+export { ReleasesError } from "./errors.js";
+export { DEFAULT_BASE_URL, type ClientOptions, type RequestOptions } from "./transport.js";
+export type * from "@buildinternet/releases-api-types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EACV,cAAc,EACd,uBAAuB,EACvB,WAAW,EACX,eAAe,EACf,IAAI,EACJ,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,SAAS,EACT,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE3F,mBAAmB,mCAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { Releases } from "./client.js";
+export { ReleasesError } from "./errors.js";
+export { DEFAULT_BASE_URL } from "./transport.js";

package/dist/transport.d.ts

@@ -0,0 +1,43 @@
+export declare const DEFAULT_BASE_URL = "https://api.releases.sh";
+export interface ClientOptions {
+    /**
+     * A `relu_` user key, a `relk_` API token, or a publish token. Optional:
+     * public reads work anonymously at a lower rate limit.
+     */
+    apiKey?: string;
+    /** API origin. Defaults to `https://api.releases.sh`. */
+    baseUrl?: string;
+    /** A `fetch` implementation. Defaults to the global `fetch`. */
+    fetch?: typeof fetch;
+    /** Headers sent with every request. */
+    headers?: Record<string, string>;
+}
+/** Per-call options accepted by every method. */
+export interface RequestOptions {
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+    /**
+     * Sent as `Idempotency-Key` on writes. Retrying with the same key replays
+     * the first response instead of repeating the write.
+     */
+    idempotencyKey?: string;
+}
+export type QueryValue = string | number | boolean | null | undefined;
+interface Call extends RequestOptions {
+    /** Values for the `:name` segments of the operation's path. */
+    params?: Record<string, string>;
+    query?: object;
+    body?: unknown;
+}
+/**
+ * Sends one operation. `operation` is the API surface key, `"GET /orgs/:slug"`:
+ * the same string `apps/api/src/api-surface.ts` lists, which a test checks so
+ * the SDK only calls public routes.
+ */
+export declare class Transport {
+    #private;
+    constructor(options?: ClientOptions);
+    request<T>(operation: string, call?: Call): Promise<T>;
+}
+export {};
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,4BAA4B,CAAC;AAE1D,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAEtE,UAAU,IAAK,SAAQ,cAAc;IACnC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,qBAAa,SAAS;;IAMpB,YAAY,OAAO,GAAE,aAAkB,EAKtC;IAEK,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,IAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAsC/D;CACF"}

package/dist/transport.js

@@ -0,0 +1,80 @@
+import { errorFromResponse, ReleasesError } from "./errors.js";
+export const DEFAULT_BASE_URL = "https://api.releases.sh";
+/**
+ * Sends one operation. `operation` is the API surface key, `"GET /orgs/:slug"`:
+ * the same string `apps/api/src/api-surface.ts` lists, which a test checks so
+ * the SDK only calls public routes.
+ */
+export class Transport {
+    #apiKey;
+    #baseUrl;
+    #fetch;
+    #headers;
+    constructor(options = {}) {
+        this.#apiKey = options.apiKey;
+        this.#baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.#fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.#headers = options.headers ?? {};
+    }
+    async request(operation, call = {}) {
+        const space = operation.indexOf(" ");
+        const method = operation.slice(0, space);
+        const path = buildPath(operation.slice(space + 1), call.params ?? {});
+        const url = `${this.#baseUrl}/v1${path}${buildQuery(call.query)}`;
+        const headers = { Accept: "application/json", ...this.#headers };
+        if (this.#apiKey)
+            headers.Authorization = `Bearer ${this.#apiKey}`;
+        if (call.body !== undefined)
+            headers["Content-Type"] = "application/json";
+        if (call.idempotencyKey)
+            headers["Idempotency-Key"] = call.idempotencyKey;
+        Object.assign(headers, call.headers);
+        let res;
+        try {
+            res = await this.#fetch(url, {
+                method,
+                headers,
+                body: call.body === undefined ? undefined : JSON.stringify(call.body),
+                signal: call.signal,
+            });
+        }
+        catch (cause) {
+            throw new ReleasesError({
+                status: 0,
+                code: "network_error",
+                type: "network",
+                message: `${method} ${path} failed: ${cause instanceof Error ? cause.message : String(cause)}`,
+                method,
+                path,
+                cause,
+            });
+        }
+        if (!res.ok) {
+            const body = await res.json().catch(() => null);
+            throw errorFromResponse(res.status, res.statusText, body, method, path);
+        }
+        if (res.status === 204)
+            return undefined;
+        return (await res.json());
+    }
+}
+function buildPath(pattern, params) {
+    return pattern.replace(/:(\w+)/g, (_, name) => {
+        const value = params[name];
+        if (value === undefined || value === "")
+            throw new TypeError(`Missing path parameter "${name}"`);
+        return encodeURIComponent(value);
+    });
+}
+function buildQuery(query) {
+    if (!query)
+        return "";
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === null)
+            continue;
+        search.set(key, String(value));
+    }
+    const qs = search.toString();
+    return qs ? `?${qs}` : "";
+}

package/package.json

@@ -1,6 +1,33 @@
 {
   "name": "@buildinternet/releases-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "TypeScript client for the Releases API (api.releases.sh).",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/buildinternet/releases.git",
+    "directory": "packages/sdk"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "bun ../../scripts/pack-dist.ts prepack ../core ../api-types",
+    "postpack": "bun ../../scripts/pack-dist.ts postpack"
+  },
+  "dependencies": {
+    "@buildinternet/releases-api-types": "0.59.0"
+  }
+}