@rustrak/client 0.24.0 → 0.26.0

package/README.md

@@ -87,7 +87,7 @@ const resolved = await client.issues.update({
 - **Validated both ways**: requests and responses are checked against Zod schemas generated from the same spec; a mismatch is a typed error, not a crash
 - **No exceptions**: every method returns `Result<T, RustrakError>`, so failure is in the type, and the value survives the React server/client boundary
 - **Tree-shakeable**: ESM is published one module per file with `sideEffects: false`
-- **Retries**: exponential backoff on 408 and 5xx for idempotent methods (`GET`, `PUT`, `DELETE`)
+- **Retries**: exponential backoff on an unreachable server and on 408, 500, 502, 503 and 504, for idempotent methods (`GET`, `PUT`, `DELETE`). Not on a timeout or a 429: `isRetryable` says yes to both, but when to retry is the caller's call
 - **Redacted 5xx**: a server error never carries a server-supplied message, so internal detail cannot reach a UI
 
 ## Configuration
@@ -157,8 +157,8 @@ console.log(result.data);
 | `gone` | 410 | ✅ | ❌ | |
 | `payload_too_large` | 413 | ✅ | ❌ | Envelope ingestion only |
 | `rate_limited` | 429 | ✅ | ✅ | Optional `retryAfter` in seconds |
-| `client_error` | other 4xx | ✅ | ❌ | Catch-all, so no status is unrepresentable |
-| `server_error` | 5xx | ✅ | ✅ | **Message is always a fixed generic string** |
+| `client_error` | other 4xx | ✅ | 408 only | Catch-all, so no status is unrepresentable |
+| `server_error` | 5xx | ✅ | 500, 502, 503, 504 | **Message is always a fixed generic string** |
 | `network` | n/a | no | ✅ | DNS, refused connection, TLS, timeout |
 | `invalid_response` | n/a | no | ❌ | 2xx whose body failed its schema |
 | `invalid_request` | n/a | no | ❌ | Your input failed its schema; nothing was sent |
@@ -226,6 +226,19 @@ Every method, grouped as it hangs off the client (`client.issues.list(...)`).
 <!-- api:start -->
 <!-- Generated by `pnpm generate` from openapi.json. Do not edit by hand. -->
 
+### Access
+
+| Method | Endpoint | Description |
+|---|---|---|
+| `access.catalog()` | `GET /api/access/catalog` | Lists every resource a permission can name, with its module, scope and actions. |
+| `access.me()` | `GET /api/access/me` | Returns what the caller may do, on the instance and on each project. |
+| `roles.create({ body })` | `POST /api/roles` | Creates a role from permissions the caller holds themselves. |
+| `roles.delete({ path })` | `DELETE /api/roles/{id}` | Deletes a role nobody holds. |
+| `roles.list()` | `GET /api/roles` | Lists every role with its permissions and how often it is assigned. |
+| `roles.update({ path, body })` | `PUT /api/roles/{id}` | Replaces a role's name, description and permissions. |
+| `users.assignments({ path })` | `GET /api/users/{id}/assignments` | Lists the roles a user holds, on the instance and on each project. |
+| `users.setAssignments({ path, body })` | `PUT /api/users/{id}/assignments` | Replaces every role and personal permission a user holds. |
+
 ### Agents
 
 | Method | Endpoint | Description |
@@ -235,54 +248,53 @@ Every method, grouped as it hangs off the client (`client.issues.list(...)`).
 | `agents.duration({ path, query? })` | `GET /api/projects/{project_id}/agents/duration` | Time-bucketed avg/p95 duration for `agent`/`ai_client` spans. |
 | `agents.environments({ path })` | `GET /api/projects/{project_id}/agents/environments` | The options the environment filter offers, read from the data rather than hardcoded — an installation may name its environments anything. |
 | `agents.modelsCalls({ path, query? })` | `GET /api/projects/{project_id}/agents/models/calls` | Top models by LLM call count (`gen_ai.operation.type:ai_client`). |
-| `agents.modelsTable({ path, query? })` | `GET /api/projects/{project_id}/agents/models` |  |
+| `agents.modelsTable({ path, query? })` | `GET /api/projects/{project_id}/agents/models` | Lists the AI models a project's agents called, with requests, tokens and latency. |
 | `agents.modelsTokens({ path, query? })` | `GET /api/projects/{project_id}/agents/models/tokens` | Top models by total tokens used (`gen_ai.operation.type:ai_client`). |
 | `agents.runs({ path, query? })` | `GET /api/projects/{project_id}/agents/runs` | Time-bucketed count of agent-run spans (`gen_ai.operation.type:agent`). |
 | `agents.summary({ path, query? })` | `GET /api/projects/{project_id}/agents/summary` | Agent runs, LLM calls, tool calls, errors, tokens and latency over the selected window — the numbers the six charts cannot state outright. |
 | `agents.tools({ path, query? })` | `GET /api/projects/{project_id}/agents/tools` | Top tools by call count (`gen_ai.operation.type:tool`). |
-| `agents.toolsTable({ path, query? })` | `GET /api/projects/{project_id}/agents/tools/stats` |  |
+| `agents.toolsTable({ path, query? })` | `GET /api/projects/{project_id}/agents/tools/stats` | Lists the tools a project's agents called, with calls, errors and latency. |
 | `agents.traces({ path, query? })` | `GET /api/projects/{project_id}/agents/traces` | Paginated per-trace_id aggregate (duration, tokens, tool usage) across all AI spans sharing that trace, regardless of origin. |
 
 ### Alert Channels
 
 | Method | Endpoint | Description |
 |---|---|---|
-| `alertChannels.create({ body })` | `POST /api/integrations` |  |
-| `alertChannels.delete({ path })` | `DELETE /api/integrations/{id}` |  |
-| `alertChannels.get({ path })` | `GET /api/integrations/{id}` |  |
-| `alertChannels.list()` | `GET /api/integrations` |  |
+| `alertChannels.create({ body })` | `POST /api/integrations` | Creates a notification integration (webhook, Slack, email…). |
+| `alertChannels.delete({ path })` | `DELETE /api/integrations/{id}` | Deletes a notification integration. |
+| `alertChannels.get({ path })` | `GET /api/integrations/{id}` | Gets one notification integration. |
+| `alertChannels.list()` | `GET /api/integrations` | Lists the channels alerts can go through. |
 | `alertChannels.previewTemplate({ body })` | `POST /api/integrations/preview-template` | Renders a Custom Webhook template against a sample payload and hands back the body that would be sent. |
-| `alertChannels.test({ path, body })` | `POST /api/integrations/{id}/test` |  |
-| `alertChannels.update({ path, body })` | `PATCH /api/integrations/{id}` |  |
+| `alertChannels.test({ path, body })` | `POST /api/integrations/{id}/test` | Sends a test notification through an integration. |
+| `alertChannels.update({ path, body })` | `PATCH /api/integrations/{id}` | Updates a notification integration. |
 
 ### Alert Rules
 
 | Method | Endpoint | Description |
 |---|---|---|
-| `alertRules.create({ path, body })` | `POST /api/projects/{project_id}/alert-rules` |  |
-| `alertRules.delete({ path })` | `DELETE /api/projects/{project_id}/alert-rules/{rule_id}` |  |
-| `alertRules.get({ path })` | `GET /api/projects/{project_id}/alert-rules/{rule_id}` |  |
+| `alertRules.create({ path, body })` | `POST /api/projects/{project_id}/alert-rules` | Creates an alert rule in a project. |
+| `alertRules.delete({ path })` | `DELETE /api/projects/{project_id}/alert-rules/{rule_id}` | Deletes an alert rule. |
+| `alertRules.get({ path })` | `GET /api/projects/{project_id}/alert-rules/{rule_id}` | Gets one alert rule. |
 | `alertRules.historyByDay({ path, query? })` | `GET /api/projects/{project_id}/alert-history/daily` | Count a project's alert deliveries per day, by outcome. |
-| `alertRules.list({ path })` | `GET /api/projects/{project_id}/alert-rules` |  |
-| `alertRules.listHistory({ path, query? })` | `GET /api/projects/{project_id}/alert-history` |  |
-| `alertRules.update({ path, body })` | `PATCH /api/projects/{project_id}/alert-rules/{rule_id}` |  |
+| `alertRules.list({ path })` | `GET /api/projects/{project_id}/alert-rules` | Lists a project's alert rules. |
+| `alertRules.listHistory({ path, query? })` | `GET /api/projects/{project_id}/alert-history` | Lists the alerts a project sent, newest first. |
+| `alertRules.update({ path, body })` | `PATCH /api/projects/{project_id}/alert-rules/{rule_id}` | Updates an alert rule. |
 
 ### Auth
 
 | Method | Endpoint | Description |
 |---|---|---|
 | `auth.acceptInvitation({ body })` | `POST /auth/accept-invitation` | Accept a pending invitation: creates the user (with the invite's email + role) and logs in. |
-| `auth.changePassword({ body })` | `POST /auth/me/password` | Change the current user's password |
+| `auth.changePassword({ body })` | `POST /auth/me/password` | Change the current user's password. |
 | `auth.confirmSsoLink({ body })` | `POST /auth/sso/link` | Link the pending SSO identity to its account once the account's password is given, and sign in. |
 | `auth.getCurrentUser()` | `GET /auth/me` | Get current authenticated user |
 | `auth.getInvitation({ path })` | `GET /auth/invitation/{token}` | Returns the invitation's details if it is still acceptable (for the accept page). |
 | `auth.login({ body })` | `POST /auth/login` | Authenticate user and create session |
 | `auth.logout()` | `POST /auth/logout` | Clear session |
-| `auth.register({ body })` | `POST /auth/register` | Registration is invite-only — always rejected. |
 | `auth.ssoCallback({ query? })` | `GET /auth/sso/callback` | Validate the provider response, resolve or provision the local account, and establish the normal Rustrak session. |
 | `auth.ssoConfig()` | `GET /auth/sso/config` | Public, non-sensitive information used to render the login page. |
 | `auth.ssoLink()` | `GET /auth/sso/link` | The account an SSO login matched, shown while its owner confirms. |
-| `auth.ssoStart()` | `POST /auth/sso/start` | Create a one-time OIDC authorization request and retain its protections in the encrypted session cookie. |
+| `auth.ssoStart()` | `POST /auth/sso/start` | Create a one-time OIDC authorization request and retain its protections in the session. |
 | `auth.updateCurrentUser({ body })` | `PATCH /auth/me` | Update the current user's presentation preferences |
 
 ### Events
@@ -301,20 +313,20 @@ Every method, grouped as it hangs off the client (`client.issues.list(...)`).
 |---|---|---|
 | `github.callback({ query })` | `GET /api/github/callback` | GitHub sends the browser here after creating the app; the code trades for its credentials. |
 | `github.createIssue({ path, body })` | `POST /api/projects/{project_id}/issues/{issue_id}/github/issues` | Opens a GitHub issue and links it. |
-| `github.deleteProjectRepository({ path })` | `DELETE /api/projects/{project_id}/github` |  |
-| `github.disconnect()` | `DELETE /api/github` |  |
+| `github.deleteProjectRepository({ path })` | `DELETE /api/projects/{project_id}/github` | Unlinks a project from its GitHub repository. |
+| `github.disconnect()` | `DELETE /api/github` | Disconnects the GitHub App from this instance. |
 | `github.getMyLogin()` | `GET /api/github/me` | The GitHub username assignees sync through. |
-| `github.getProjectRepository({ path })` | `GET /api/projects/{project_id}/github` |  |
+| `github.getProjectRepository({ path })` | `GET /api/projects/{project_id}/github` | Gets the GitHub repository a project is linked to. |
 | `github.installed({ query })` | `GET /api/github/installed` | GitHub sends the browser here after the app is installed on an account. |
 | `github.issue({ path })` | `GET /api/projects/{project_id}/issues/{issue_id}/github` | The issue's links, the commits that may have caused it, and who owns its culprit file. |
 | `github.issueDraft({ path })` | `GET /api/projects/{project_id}/issues/{issue_id}/github/draft` | What creating a GitHub issue sends by default, with the templates applied, for the person to edit first. |
 | `github.linkIssue({ path, body })` | `POST /api/projects/{project_id}/issues/{issue_id}/github/links` | Links an existing GitHub issue or pull request. |
 | `github.manifest({ body })` | `POST /api/github/manifest` | What the dashboard posts to GitHub so GitHub creates an app already configured for this server. |
 | `github.putIssueTemplate({ body })` | `PUT /api/github/issue-template` | The labels, title prefix and body footer every GitHub issue starts with, before a project's own. |
-| `github.putMyLogin({ body })` | `PUT /api/github/me` |  |
-| `github.putProjectRepository({ path, body })` | `PUT /api/projects/{project_id}/github` |  |
+| `github.putMyLogin({ body })` | `PUT /api/github/me` | Sets or clears the caller's GitHub username, which assignees sync through. |
+| `github.putProjectRepository({ path, body })` | `PUT /api/projects/{project_id}/github` | Links a project to a GitHub repository. |
 | `github.repositories({ query })` | `GET /api/github/repositories` | The repositories a project can point at, for whoever may change that project's settings. |
-| `github.status()` | `GET /api/github` |  |
+| `github.status()` | `GET /api/github` | Shows whether a GitHub App is connected, and how. |
 | `github.syncCodeowners({ path })` | `POST /api/projects/{project_id}/github/codeowners` | Copies the repository's CODEOWNERS so ownership can be answered without asking GitHub each time. |
 | `github.unlinkIssue({ path })` | `DELETE /api/projects/{project_id}/issues/{issue_id}/github/links/{link_id}` |  |
 | `github.webhook({ body })` | `POST /api/github/webhook` | Public, and trusted only through the signature GitHub computes with the app's webhook secret. |
@@ -331,9 +343,11 @@ Every method, grouped as it hangs off the client (`client.issues.list(...)`).
 
 | Method | Endpoint | Description |
 |---|---|---|
-| `invitations.create({ body })` | `POST /api/invitations` | Create an invitation (admin only) |
-| `invitations.list()` | `GET /api/invitations` | List invitations (admin only) |
-| `invitations.revoke({ path })` | `DELETE /api/invitations/{token}` | Revoke a pending invitation (admin only) |
+| `invitations.create({ body })` | `POST /api/invitations` | Create an invitation (needs `invitations:create`) |
+| `invitations.emailStatus()` | `GET /api/invitations/email-status` | Whether invitation emails can be sent (needs `invitations:read`) |
+| `invitations.list()` | `GET /api/invitations` | List invitations (needs `invitations:read`) |
+| `invitations.resend({ path })` | `POST /api/invitations/{id}/resend` | Email the invite link again (needs `invitations:create`) |
+| `invitations.revoke({ path })` | `DELETE /api/invitations/{id}` | Revoke a pending invitation (needs `invitations:delete`) |
 
 ### Issues
 
@@ -341,8 +355,8 @@ Every method, grouped as it hangs off the client (`client.issues.list(...)`).
 |---|---|---|
 | `environments.list({ path })` | `GET /api/projects/{project_id}/environments` | Lists the environments a project's issues have been seen in, by name. |
 | `feedback.list({ path, query? })` | `GET /api/projects/{project_id}/feedback` | Lists user feedback with what each user submitted. |
-| `issues.bulkDelete({ path, body })` | `DELETE /api/projects/{project_id}/issues` | Bulk delete by ids or filter |
-| `issues.bulkUpdate({ path, body })` | `PUT /api/projects/{project_id}/issues` | Bulk mutate |
+| `issues.bulkDelete({ path, body })` | `DELETE /api/projects/{project_id}/issues` | Deletes many issues at once, selected by id or by filter. |
+| `issues.bulkUpdate({ path, body })` | `PUT /api/projects/{project_id}/issues` | Sets the status or priority of many issues at once, by id. |
 | `issues.createComment({ path, body })` | `POST /api/projects/{project_id}/issues/{issue_id}/comments` | Add a note. |
 | `issues.createUserReport({ path, body })` | `POST /api/projects/{project_id}/issues/{issue_id}/user-reports` | Attach user feedback to an issue. |
 | `issues.delete({ path })` | `DELETE /api/projects/{project_id}/issues/{issue_id}` | Hard-deletes an issue and all associated events |
@@ -371,21 +385,22 @@ Every method, grouped as it hangs off the client (`client.issues.list(...)`).
 
 | Method | Endpoint | Description |
 |---|---|---|
-| `members.list({ path })` | `GET /api/projects/{project_id}/members` |  |
-| `members.remove({ path })` | `DELETE /api/projects/{project_id}/members/{user_id}` |  |
-| `members.upsert({ path, body })` | `PUT /api/projects/{project_id}/members` |  |
+| `members.candidates({ path })` | `GET /api/projects/{project_id}/members/candidates` | Lists the people and the roles the caller can give on the project, so it takes neither `users:read` nor `roles:read` to manage its members. |
+| `members.list({ path })` | `GET /api/projects/{project_id}/members` | Lists everyone holding a role on the project, with those roles; personal permissions are not roles. |
+| `members.remove({ path })` | `DELETE /api/projects/{project_id}/members/{user_id}` | Removes the roles a user holds on this project; roles on all projects and personal permissions stay. |
+| `members.upsert({ path, body })` | `PUT /api/projects/{project_id}/members` | Sets the roles a user holds on the project. |
 
 ### Monitors
 
 | Method | Endpoint | Description |
 |---|---|---|
-| `monitors.create({ path, body })` | `POST /api/projects/{project_id}/monitors` |  |
-| `monitors.delete({ path })` | `DELETE /api/projects/{project_id}/monitors/{slug}` |  |
-| `monitors.get({ path })` | `GET /api/projects/{project_id}/monitors/{slug}` |  |
-| `monitors.list({ path })` | `GET /api/projects/{project_id}/monitors` |  |
-| `monitors.listCheckins({ path, query? })` | `GET /api/projects/{project_id}/monitors/{slug}/checkins` |  |
+| `monitors.create({ path, body })` | `POST /api/projects/{project_id}/monitors` | Creates a cron monitor in a project. |
+| `monitors.delete({ path })` | `DELETE /api/projects/{project_id}/monitors/{slug}` | Deletes a cron monitor and its check-ins. |
+| `monitors.get({ path })` | `GET /api/projects/{project_id}/monitors/{slug}` | Gets one cron monitor. |
+| `monitors.list({ path })` | `GET /api/projects/{project_id}/monitors` | Lists a project's cron monitors. |
+| `monitors.listCheckins({ path, query? })` | `GET /api/projects/{project_id}/monitors/{slug}/checkins` | Lists a cron monitor's check-ins, newest first. |
 | `monitors.stats({ path, query? })` | `GET /api/projects/{project_id}/monitor-stats` | Counts the check-ins of a project's monitors by status over a window, bucket by bucket. |
-| `monitors.update({ path, body })` | `PUT /api/projects/{project_id}/monitors/{slug}` |  |
+| `monitors.update({ path, body })` | `PUT /api/projects/{project_id}/monitors/{slug}` | Updates a cron monitor. |
 
 ### OAuth
 
@@ -404,7 +419,7 @@ Every method, grouped as it hangs off the client (`client.issues.list(...)`).
 | `projects.delete({ path })` | `DELETE /api/projects/{id}` | Delete a project |
 | `projects.get({ path })` | `GET /api/projects/{id}` | Get a project by ID |
 | `projects.getRateLimits()` | `GET /api/rate-limits` | What a project without limits of its own follows |
-| `projects.list({ query? })` | `GET /api/projects` | List projects with pagination |
+| `projects.list({ query? })` | `GET /api/projects` | List projects with pagination. |
 | `projects.update({ path, body })` | `PATCH /api/projects/{id}` | Update a project |
 
 ### Releases
@@ -415,7 +430,7 @@ Every method, grouped as it hangs off the client (`client.issues.list(...)`).
 | `releases.finalize({ path, body })` | `PUT /api/0/projects/{org_slug}/{project_slug}/releases/{version}/` | Generic partial update (`ref`, `url`, `dateReleased`). |
 | `releases.get({ path, query? })` | `GET /api/projects/{project_id}/releases/{release}` | Gets one release with its events, new issues, environments and session health. |
 | `releases.list({ path, query? })` | `GET /api/projects/{project_id}/releases` | Lists a project's releases, newest first, with the events, new issues, environments and session health of each. |
-| `releases.newIssues({ path, query? })` | `GET /api/projects/{project_id}/releases/{release}/new-issues` |  |
+| `releases.newIssues({ path, query? })` | `GET /api/projects/{project_id}/releases/{release}/new-issues` | Lists the issues first seen in a release. |
 
 ### Schedules
 
@@ -429,7 +444,7 @@ Every method, grouped as it hangs off the client (`client.issues.list(...)`).
 |---|---|---|
 | `sentry.getIssue({ path })` | `GET /api/0/issues/{issue_id}/` | One issue with its releases and its 24h and 30d series (Sentry's `GroupDetailsEndpoint`). |
 | `sentry.getLatestEvent({ path })` | `GET /api/0/issues/{issue_id}/events/latest/` | The issue's most recent event (Sentry's `GroupEventDetailsEndpoint`, `issues/endpoints/group_event_details.py`). |
-| `sentry.listIssues({ path, query? })` | `GET /api/0/projects/{org_slug}/{project_slug}/issues/` | A project's issues, filtered by `query`, sorted by `sort` and paginated by `cursor` (Sentry's `ProjectGroupIndexEndpoint`, `issues/endpoints/project_group_index.py`). |
+| `sentry.listIssues({ path, query? })` | `GET /api/0/projects/{org_slug}/{project_slug}/issues/` | Issues, filtered by `query`, sorted by `sort` and paginated by `cursor` (Sentry's `ProjectGroupIndexEndpoint`, `issues/endpoints/project_group_index.py`). |
 | `sentry.listOrganizations()` | `GET /api/0/organizations/` | The organizations the token belongs to (Sentry's `OrganizationIndexEndpoint`): always the one synthetic org. |
 | `sentry.listProjects({ query? })` | `GET /api/0/projects/` | The projects the token can see, newest first (Sentry's `ProjectIndexEndpoint`, `core/endpoints/project_index.py`). |
 | `sentry.listRepos({ path })` | `GET /api/0/organizations/{org_slug}/repos/` | The code repositories connected to the organization (Sentry's `OrganizationRepositoriesEndpoint`). |
@@ -441,16 +456,16 @@ Every method, grouped as it hangs off the client (`client.issues.list(...)`).
 
 | Method | Endpoint | Description |
 |---|---|---|
-| `sessions.getStats({ path, query? })` | `GET /api/projects/{project_id}/sessions/stats` |  |
-| `sessions.getSummary({ path, query? })` | `GET /api/projects/{project_id}/sessions/summary` |  |
-| `sessions.getTimeseries({ path, query? })` | `GET /api/projects/{project_id}/sessions/timeseries` |  |
+| `sessions.getStats({ path, query? })` | `GET /api/projects/{project_id}/sessions/stats` | Session counts by release, for release health. |
+| `sessions.getSummary({ path, query? })` | `GET /api/projects/{project_id}/sessions/summary` | Totals and crash-free rates for a project's sessions. |
+| `sessions.getTimeseries({ path, query? })` | `GET /api/projects/{project_id}/sessions/timeseries` | Session counts over time, bucketed for a chart. |
 
 ### Settings
 
 | Method | Endpoint | Description |
 |---|---|---|
 | `settings.getMcp()` | `GET /api/settings/mcp` | Whether the MCP endpoint at `/mcp` is on. |
-| `settings.updateMcp({ body })` | `PUT /api/settings/mcp` | Turns the MCP endpoint at `/mcp` on or off. |
+| `settings.updateMcp({ body })` | `PUT /api/settings/mcp` | Turns the MCP endpoint at `/mcp` on or off (needs `mcp:update`). |
 
 ### Source Maps
 
@@ -458,10 +473,10 @@ Every method, grouped as it hangs off the client (`client.issues.list(...)`).
 |---|---|---|
 | `debugFiles.assemble({ path, body })` | `POST /api/0/projects/{org_slug}/{project_slug}/files/difs/assemble/` | Assemble uploaded chunks into debug information files (ProGuard mappings, JVM source bundles). |
 | `debugFiles.upload({ path, body })` | `POST /api/0/projects/{org_slug}/{project_slug}/files/dsyms/` | Upload a zip of debug information files (the path `sentry-cli upload-proguard` takes). |
-| `sourceMaps.artifactBundleAssemble({ path, body })` | `POST /api/0/organizations/{org_slug}/artifactbundle/assemble/` |  |
-| `sourceMaps.chunkUpload({ path, body })` | `POST /api/0/organizations/{org_slug}/chunk-upload/` |  |
-| `sourceMaps.chunkUploadCapability({ path })` | `GET /api/0/organizations/{org_slug}/chunk-upload/` |  |
-| `sourceMaps.list({ path })` | `GET /api/0/projects/{org_slug}/{project_slug}/files/source-maps/` |  |
+| `sourceMaps.artifactBundleAssemble({ path, body })` | `POST /api/0/organizations/{org_slug}/artifactbundle/assemble/` | Assembles uploaded chunks into an artifact bundle (sentry-cli `sourcemaps upload`). |
+| `sourceMaps.chunkUpload({ path, body })` | `POST /api/0/organizations/{org_slug}/chunk-upload/` | Receives chunks of a source map or debug file upload from sentry-cli. |
+| `sourceMaps.chunkUploadCapability({ path })` | `GET /api/0/organizations/{org_slug}/chunk-upload/` | Describes how sentry-cli should upload chunks: size, concurrency and accepted kinds. |
+| `sourceMaps.list({ path })` | `GET /api/0/projects/{org_slug}/{project_slug}/files/source-maps/` | Lists a project's uploaded source map artifacts (sentry-cli). |
 | `sourceMaps.orgDetails({ path })` | `GET /api/0/organizations/{org_slug}/` | Always returns 200 with synthetic org data — sentry-cli validates this before uploading. |
 
 ### Spans
@@ -475,8 +490,8 @@ Every method, grouped as it hangs off the client (`client.issues.list(...)`).
 
 | Method | Endpoint | Description |
 |---|---|---|
-| `stats.getEventTimeseries({ path, query? })` | `GET /api/projects/{project_id}/events/stats` |  |
-| `stats.getSummary({ path, query? })` | `GET /api/projects/{project_id}/stats/summary` |  |
+| `stats.getEventTimeseries({ path, query? })` | `GET /api/projects/{project_id}/events/stats` | Counts a project's events over time, bucketed for a chart. |
+| `stats.getSummary({ path, query? })` | `GET /api/projects/{project_id}/stats/summary` | Headline figures for a project's overview: events, new and open issues. |
 
 ### Storage
 
@@ -489,35 +504,35 @@ Every method, grouped as it hangs off the client (`client.issues.list(...)`).
 | `storage.getCleanupStatus()` | `GET /api/storage/cleanup/status` | Progress of the running cleanup, or the outcome of the last one. |
 | `storage.getCompaction()` | `GET /api/storage/compaction` | Whether the database file shrinks when data is deleted, and the disk a one-off compaction needs. |
 | `storage.getProjects()` | `GET /api/storage/projects` | Per-project counts and estimated weight. |
-| `storage.getRetention()` | `GET /api/storage/retention` |  |
+| `storage.getRetention()` | `GET /api/storage/retention` | Gets the retention settings and the cleanup schedule. |
 | `storage.getSummary()` | `GET /api/storage/summary` | Row counts, DB size, and source-map weight. |
 | `storage.previewCleanup({ body })` | `POST /api/storage/cleanup/preview` | Dry-run count, mutates nothing. |
 | `storage.previewRetention({ body })` | `POST /api/storage/retention/preview` | What saving these settings would delete on the next cleanup, without saving or deleting anything. |
 | `storage.previewSourceMapGc()` | `POST /api/storage/source-maps/gc/preview` | Dry-run orphan count, deletes nothing. |
 | `storage.runRetention()` | `POST /api/storage/retention/run` | Enforces the saved retention now, without waiting for the schedule. |
-| `storage.updateRetention({ body })` | `PUT /api/storage/retention` |  |
+| `storage.updateRetention({ body })` | `PUT /api/storage/retention` | Updates the retention settings; the next cleanup is scheduled at once. |
 
 ### Team
 
 | Method | Endpoint | Description |
 |---|---|---|
-| `team.deleteUser({ path })` | `DELETE /api/team/{user_id}` | Remove a user from the instance (admin only) |
-| `team.list()` | `GET /api/team` | List all users (admin only) |
-| `team.updateRole({ path, body })` | `PATCH /api/team/{user_id}/role` | Change a user's global role (admin only) |
+| `team.deleteUser({ path })` | `DELETE /api/team/{user_id}` | Remove a user from the instance (needs `users:delete`) |
+| `team.list()` | `GET /api/team` | List all users (needs `users:read`) |
+| `team.updateRole({ path, body })` | `PATCH /api/team/{user_id}/role` | Change a user's global role (needs `users:update`) |
 
 ### Telemetry
 
 | Method | Endpoint | Description |
 |---|---|---|
-| `telemetry.preview()` | `GET /api/telemetry/preview` |  |
+| `telemetry.preview()` | `GET /api/telemetry/preview` | Shows the exact anonymous telemetry report this instance would send. |
 
 ### Tokens
 
 | Method | Endpoint | Description |
 |---|---|---|
-| `tokens.create({ body })` | `POST /api/tokens` | Create a new token (scoped to the acting user) |
+| `tokens.create({ body })` | `POST /api/tokens` | Create a new token (from a signed-in session only) |
 | `tokens.delete({ path })` | `DELETE /api/tokens/{id}` | Revoke a token |
-| `tokens.get({ path })` | `GET /api/tokens/{id}` | Reveal full token value |
+| `tokens.get({ path })` | `GET /api/tokens/{id}` | Token details, masked |
 | `tokens.list()` | `GET /api/tokens` | List tokens (masked) |
 
 ### Transactions

package/dist/client.cjs

@@ -1,3 +1,4 @@
+const require_binary_gen = require("./generated/binary.gen.cjs");
 const require_utils_gen = require("./generated/client/utils.gen.cjs");
 const require_client_gen = require("./generated/client/client.gen.cjs");
 const require_sdk_gen = require("./generated/sdk.gen.cjs");
@@ -5,7 +6,7 @@ const require_result = require("./result.cjs");
 const require_http = require("./utils/http.cjs");
 let zod = require("zod");
 // src/client.ts
-const BINARY = /* @__PURE__ */ new Set(["events.downloadAttachment"]);
+const BINARY_OPERATIONS = new Set(require_binary_gen.BINARY);
 /**
 * Main Rustrak API client. Every method returns a `Result`; nothing throws for
 * an expected failure.
@@ -48,7 +49,7 @@ function createApi(config) {
 			methods[method] = async (options = {}) => toResult(await resource[method]({
 				...options,
 				headers: options.headers instanceof Headers || Array.isArray(options.headers) ? Object.fromEntries(new Headers(options.headers)) : options.headers,
-				...BINARY.has(`${name}.${method}`) && { parseAs: "blob" },
+				...BINARY_OPERATIONS.has(`${name}.${method}`) && { parseAs: "blob" },
 				throwOnError: false
 			}));
 		}
@@ -66,7 +67,7 @@ function createApi(config) {
 */
 function toResult({ data, error, response }) {
 	if (error === void 0) return require_result.Ok(data);
-	if (require_http.isTransportFailure(error)) return require_result.Err(error.rustrakError);
+	if (error instanceof require_http.RustrakTransportFailure) return require_result.Err(error.rustrakError);
 	if (response && !response.ok) return require_result.Err(require_http.transformHttpError(response, error));
 	if (!response && error instanceof zod.ZodError) return require_result.Err({
 		kind: "invalid_request",

package/dist/client.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.cjs","names":["Rustrak","createClient","createConfig","createFetch","Ok","isTransportFailure","Err","transformHttpError","ZodError"],"sources":["../src/client.ts"],"sourcesContent":["import { ZodError } from 'zod';\nimport type { ClientConfig } from './config.js';\nimport type { RustrakError } from './errors.js';\nimport { createClient, createConfig } from './generated/client/index.js';\nimport { Rustrak } from './generated/sdk.gen.js';\nimport { Err, Ok, type Result } from './result.js';\nimport {\n  createFetch,\n  isTransportFailure,\n  transformHttpError,\n} from './utils/http.js';\n\n/**\n * Operations whose 2xx is a file, not JSON: read as a `Blob`. The spec leaves\n * the body untyped (zod has no binary type), so the type comes from here.\n */\ntype Binary = 'events.downloadAttachment';\nconst BINARY: ReadonlySet<string> = new Set<Binary>([\n  'events.downloadAttachment',\n]);\n\n/** What a caller may pass: the request's own parts, never client plumbing. */\ntype RequestKeys = 'path' | 'query' | 'body' | 'headers' | 'signal';\n\ntype Call<F, Bytes extends boolean> = F extends (options: infer O) => infer R\n  ? (\n      ...args: {} extends Pick<O, Extract<keyof O, RequestKeys>>\n        ? [options?: Pick<O, Extract<keyof O, RequestKeys>>]\n        : [options: Pick<O, Extract<keyof O, RequestKeys>>]\n    ) => Promise<\n      Result<Bytes extends true ? Blob : Data<Awaited<R>>, RustrakError>\n    >\n  : never;\n\n/** The success half of the generated `{ data, error }` union. */\ntype Data<R> =\n  Extract<R, { error: undefined }> extends { data: infer D } ? D : never;\n\ntype Resource<T, Name extends string> = {\n  readonly [M in keyof T]: Call<\n    T[M],\n    `${Name}.${M & string}` extends Binary ? true : false\n  >;\n};\n\n/**\n * Every operation in `openapi.json`, grouped by tag:\n * `client.issues.list({ path: { project_id } })`.\n *\n * Generated in `src/generated/`; this file only changes what a call returns.\n */\nexport type RustrakClient = {\n  readonly [R in keyof Rustrak]: Resource<Rustrak[R], R & string>;\n};\n\n/**\n * Main Rustrak API client. Every method returns a `Result`; nothing throws for\n * an expected failure.\n *\n * @example\n * ```typescript\n * const client = new RustrakClient({\n *   baseUrl: 'http://localhost:8080',\n *   token: 'your-api-token',\n * });\n *\n * const issues = await client.issues.list({ path: { project_id: 1 } });\n * if (issues.success) console.log(issues.data.items);\n * ```\n */\nexport const RustrakClient = class {\n  constructor(config: ClientConfig) {\n    // biome-ignore lint/correctness/noConstructorReturn: the instance is the generated SDK with every method wrapped\n    return Object.setPrototypeOf(createApi(config), new.target.prototype);\n  }\n} as unknown as new (\n  config: ClientConfig,\n) => RustrakClient;\n\nfunction createApi(config: ClientConfig): RustrakClient {\n  const sdk = new Rustrak({\n    client: createClient(\n      createConfig({\n        baseUrl: config.baseUrl,\n        credentials: 'include',\n        fetch: createFetch(config),\n        // Every 2xx in the spec is JSON or empty, except the files in\n        // `BINARY`. `auto` would hand back an HTML page or a stream as a\n        // success without validating it.\n        parseAs: 'json',\n        headers: {\n          // Without it a content-negotiating hop can answer with HTML.\n          Accept: 'application/json',\n          ...config.headers,\n          ...(config.token && { Authorization: `Bearer ${config.token}` }),\n        },\n      }),\n    ),\n  });\n\n  const api: Record<string, Record<string, unknown>> = {};\n  for (const name of Object.getOwnPropertyNames(Rustrak.prototype)) {\n    if (name === 'constructor') continue;\n    const resource = sdk[name as keyof Rustrak] as unknown as Record<\n      string,\n      (options: object) => Promise<Outcome>\n    >;\n    const methods: Record<string, unknown> = {};\n    for (const method of Object.getOwnPropertyNames(\n      Object.getPrototypeOf(resource),\n    )) {\n      if (method === 'constructor') continue;\n      methods[method] = async (options: { headers?: unknown } = {}) =>\n        toResult(\n          await resource[method]!({\n            ...options,\n            // A JSON write spreads these into an object, which keeps nothing\n            // of a `Headers` or an array of pairs.\n            headers:\n              options.headers instanceof Headers ||\n              Array.isArray(options.headers)\n                ? Object.fromEntries(new Headers(options.headers))\n                : options.headers,\n            ...(BINARY.has(`${name}.${method}`) && { parseAs: 'blob' }),\n            throwOnError: false,\n          }),\n        );\n    }\n    api[name] = methods;\n  }\n  return api as unknown as RustrakClient;\n}\n\ntype Outcome = {\n  data?: unknown;\n  error?: unknown;\n  response?: Response;\n};\n\n/**\n * The boundary: the generated client's `{ data, error, response }` becomes a\n * `Result`.\n *\n * Only failures this file recognises become an `Err`. Anything else, a\n * `TypeError` from a genuine bug, is rethrown so it crashes where it can be\n * debugged instead of being laundered into `{ success: false }`.\n */\nfunction toResult({\n  data,\n  error,\n  response,\n}: Outcome): Result<unknown, RustrakError> {\n  if (error === undefined) return Ok(data);\n  if (isTransportFailure(error)) return Err(error.rustrakError);\n  if (response && !response.ok) {\n    // `error` is the parsed body, or its text when it is not JSON.\n    return Err(transformHttpError(response, error));\n  }\n  if (!response && error instanceof ZodError) {\n    return Err({\n      kind: 'invalid_request',\n      message: 'The request input did not match the expected schema.',\n    });\n  }\n  if (response && error instanceof SyntaxError) {\n    return Err({\n      kind: 'invalid_response',\n      message: 'The server returned a body that is not valid JSON.',\n    });\n  }\n  if (response && error instanceof ZodError) {\n    // No Zod issues: they embed the offending response data.\n    return Err({\n      kind: 'invalid_response',\n      message: 'The server response did not match the expected schema.',\n    });\n  }\n  throw error;\n}\n"],"mappings":";;;;;;;AAiBA,MAAM,yBAA8B,IAAI,IAAY,CAClD,2BACF,CAAC;;;;;;;;;;;;;;;;AAmDD,MAAa,gBAAgB,MAAM;CACjC,YAAY,QAAsB;EAEhC,OAAO,OAAO,eAAe,UAAU,MAAM,GAAG,WAAW,SAAS;CACtE;AACF;AAIA,SAAS,UAAU,QAAqC;CACtD,MAAM,MAAM,IAAIA,gBAAAA,QAAQ,EACtB,QAAQC,mBAAAA,aACNC,kBAAAA,aAAa;EACX,SAAS,OAAO;EAChB,aAAa;EACb,OAAOC,aAAAA,YAAY,MAAM;EAIzB,SAAS;EACT,SAAS;GAEP,QAAQ;GACR,GAAG,OAAO;GACV,GAAI,OAAO,SAAS,EAAE,eAAe,UAAU,OAAO,QAAQ;EAChE;CACF,CAAC,CACH,EACF,CAAC;CAED,MAAM,MAA+C,CAAC;CACtD,KAAK,MAAM,QAAQ,OAAO,oBAAoBH,gBAAAA,QAAQ,SAAS,GAAG;EAChE,IAAI,SAAS,eAAe;EAC5B,MAAM,WAAW,IAAI;EAIrB,MAAM,UAAmC,CAAC;EAC1C,KAAK,MAAM,UAAU,OAAO,oBAC1B,OAAO,eAAe,QAAQ,CAChC,GAAG;GACD,IAAI,WAAW,eAAe;GAC9B,QAAQ,UAAU,OAAO,UAAiC,CAAC,MACzD,SACE,MAAM,SAAS,OAAO,CAAE;IACtB,GAAG;IAGH,SACE,QAAQ,mBAAmB,WAC3B,MAAM,QAAQ,QAAQ,OAAO,IACzB,OAAO,YAAY,IAAI,QAAQ,QAAQ,OAAO,CAAC,IAC/C,QAAQ;IACd,GAAI,OAAO,IAAI,GAAG,KAAK,GAAG,QAAQ,KAAK,EAAE,SAAS,OAAO;IACzD,cAAc;GAChB,CAAC,CACH;EACJ;EACA,IAAI,QAAQ;CACd;CACA,OAAO;AACT;;;;;;;;;AAgBA,SAAS,SAAS,EAChB,MACA,OACA,YACyC;CACzC,IAAI,UAAU,KAAA,GAAW,OAAOI,eAAAA,GAAG,IAAI;CACvC,IAAIC,aAAAA,mBAAmB,KAAK,GAAG,OAAOC,eAAAA,IAAI,MAAM,YAAY;CAC5D,IAAI,YAAY,CAAC,SAAS,IAExB,OAAOA,eAAAA,IAAIC,aAAAA,mBAAmB,UAAU,KAAK,CAAC;CAEhD,IAAI,CAAC,YAAY,iBAAiBC,IAAAA,UAChC,OAAOF,eAAAA,IAAI;EACT,MAAM;EACN,SAAS;CACX,CAAC;CAEH,IAAI,YAAY,iBAAiB,aAC/B,OAAOA,eAAAA,IAAI;EACT,MAAM;EACN,SAAS;CACX,CAAC;CAEH,IAAI,YAAY,iBAAiBE,IAAAA,UAE/B,OAAOF,eAAAA,IAAI;EACT,MAAM;EACN,SAAS;CACX,CAAC;CAEH,MAAM;AACR"}
+{"version":3,"file":"client.cjs","names":["BINARY","Rustrak","createClient","createConfig","createFetch","Ok","RustrakTransportFailure","Err","transformHttpError","ZodError"],"sources":["../src/client.ts"],"sourcesContent":["import { ZodError } from 'zod';\nimport type { ClientConfig } from './config.js';\nimport type { RustrakError } from './errors.js';\nimport { BINARY } from './generated/binary.gen.js';\nimport { createClient, createConfig } from './generated/client/index.js';\nimport { Rustrak } from './generated/sdk.gen.js';\nimport { Err, Ok, type Result } from './result.js';\nimport {\n  createFetch,\n  RustrakTransportFailure,\n  transformHttpError,\n} from './utils/http.js';\n\n/**\n * Operations whose 2xx is a file, read as a `Blob`. The spec leaves the body\n * untyped (zod has no binary type), so the type comes from this list.\n */\ntype Binary = (typeof BINARY)[number];\nconst BINARY_OPERATIONS: ReadonlySet<string> = new Set(BINARY);\n\n/** What a caller may pass: the request's own parts, never client plumbing. */\ntype RequestKeys = 'path' | 'query' | 'body' | 'headers' | 'signal';\n\ntype Call<F, Bytes extends boolean> = F extends (options: infer O) => infer R\n  ? (\n      ...args: {} extends Pick<O, Extract<keyof O, RequestKeys>>\n        ? [options?: Pick<O, Extract<keyof O, RequestKeys>>]\n        : [options: Pick<O, Extract<keyof O, RequestKeys>>]\n    ) => Promise<\n      Result<Bytes extends true ? Blob : Data<Awaited<R>>, RustrakError>\n    >\n  : never;\n\n/** The success half of the generated `{ data, error }` union. */\ntype Data<R> =\n  Extract<R, { error: undefined }> extends { data: infer D } ? D : never;\n\ntype Resource<T, Name extends string> = {\n  readonly [M in keyof T]: Call<\n    T[M],\n    `${Name}.${M & string}` extends Binary ? true : false\n  >;\n};\n\n/**\n * Every operation in `openapi.json`, grouped by tag:\n * `client.issues.list({ path: { project_id } })`.\n *\n * Generated in `src/generated/`; this file only changes what a call returns.\n */\nexport type RustrakClient = {\n  readonly [R in keyof Rustrak]: Resource<Rustrak[R], R & string>;\n};\n\n/**\n * Main Rustrak API client. Every method returns a `Result`; nothing throws for\n * an expected failure.\n *\n * @example\n * ```typescript\n * const client = new RustrakClient({\n *   baseUrl: 'http://localhost:8080',\n *   token: 'your-api-token',\n * });\n *\n * const issues = await client.issues.list({ path: { project_id: 1 } });\n * if (issues.success) console.log(issues.data.items);\n * ```\n */\nexport const RustrakClient = class {\n  constructor(config: ClientConfig) {\n    // biome-ignore lint/correctness/noConstructorReturn: the instance is the generated SDK with every method wrapped\n    return Object.setPrototypeOf(createApi(config), new.target.prototype);\n  }\n} as unknown as new (\n  config: ClientConfig,\n) => RustrakClient;\n\nfunction createApi(config: ClientConfig): RustrakClient {\n  const sdk = new Rustrak({\n    client: createClient(\n      createConfig({\n        baseUrl: config.baseUrl,\n        credentials: 'include',\n        fetch: createFetch(config),\n        // Every 2xx in the spec is JSON or empty, except the files in\n        // `BINARY`. `auto` would hand back an HTML page or a stream as a\n        // success without validating it.\n        parseAs: 'json',\n        headers: {\n          // Without it a content-negotiating hop can answer with HTML.\n          Accept: 'application/json',\n          ...config.headers,\n          ...(config.token && { Authorization: `Bearer ${config.token}` }),\n        },\n      }),\n    ),\n  });\n\n  const api: Record<string, Record<string, unknown>> = {};\n  for (const name of Object.getOwnPropertyNames(Rustrak.prototype)) {\n    if (name === 'constructor') continue;\n    const resource = sdk[name as keyof Rustrak] as unknown as Record<\n      string,\n      (options: object) => Promise<Outcome>\n    >;\n    const methods: Record<string, unknown> = {};\n    for (const method of Object.getOwnPropertyNames(\n      Object.getPrototypeOf(resource),\n    )) {\n      if (method === 'constructor') continue;\n      methods[method] = async (options: { headers?: unknown } = {}) =>\n        toResult(\n          await resource[method]!({\n            ...options,\n            // A JSON write spreads these into an object, which keeps nothing\n            // of a `Headers` or an array of pairs.\n            headers:\n              options.headers instanceof Headers ||\n              Array.isArray(options.headers)\n                ? Object.fromEntries(new Headers(options.headers))\n                : options.headers,\n            ...(BINARY_OPERATIONS.has(`${name}.${method}`) && {\n              parseAs: 'blob',\n            }),\n            throwOnError: false,\n          }),\n        );\n    }\n    api[name] = methods;\n  }\n  return api as unknown as RustrakClient;\n}\n\ntype Outcome = {\n  data?: unknown;\n  error?: unknown;\n  response?: Response;\n};\n\n/**\n * The boundary: the generated client's `{ data, error, response }` becomes a\n * `Result`.\n *\n * Only failures this file recognises become an `Err`. Anything else, a\n * `TypeError` from a genuine bug, is rethrown so it crashes where it can be\n * debugged instead of being laundered into `{ success: false }`.\n */\nfunction toResult({\n  data,\n  error,\n  response,\n}: Outcome): Result<unknown, RustrakError> {\n  if (error === undefined) return Ok(data);\n  if (error instanceof RustrakTransportFailure) return Err(error.rustrakError);\n  if (response && !response.ok) {\n    // `error` is the parsed body, or its text when it is not JSON.\n    return Err(transformHttpError(response, error));\n  }\n  if (!response && error instanceof ZodError) {\n    return Err({\n      kind: 'invalid_request',\n      message: 'The request input did not match the expected schema.',\n    });\n  }\n  if (response && error instanceof SyntaxError) {\n    return Err({\n      kind: 'invalid_response',\n      message: 'The server returned a body that is not valid JSON.',\n    });\n  }\n  if (response && error instanceof ZodError) {\n    // No Zod issues: they embed the offending response data.\n    return Err({\n      kind: 'invalid_response',\n      message: 'The server response did not match the expected schema.',\n    });\n  }\n  throw error;\n}\n"],"mappings":";;;;;;;;AAkBA,MAAM,oBAAyC,IAAI,IAAIA,mBAAAA,MAAM;;;;;;;;;;;;;;;;AAmD7D,MAAa,gBAAgB,MAAM;CACjC,YAAY,QAAsB;EAEhC,OAAO,OAAO,eAAe,UAAU,MAAM,GAAG,WAAW,SAAS;CACtE;AACF;AAIA,SAAS,UAAU,QAAqC;CACtD,MAAM,MAAM,IAAIC,gBAAAA,QAAQ,EACtB,QAAQC,mBAAAA,aACNC,kBAAAA,aAAa;EACX,SAAS,OAAO;EAChB,aAAa;EACb,OAAOC,aAAAA,YAAY,MAAM;EAIzB,SAAS;EACT,SAAS;GAEP,QAAQ;GACR,GAAG,OAAO;GACV,GAAI,OAAO,SAAS,EAAE,eAAe,UAAU,OAAO,QAAQ;EAChE;CACF,CAAC,CACH,EACF,CAAC;CAED,MAAM,MAA+C,CAAC;CACtD,KAAK,MAAM,QAAQ,OAAO,oBAAoBH,gBAAAA,QAAQ,SAAS,GAAG;EAChE,IAAI,SAAS,eAAe;EAC5B,MAAM,WAAW,IAAI;EAIrB,MAAM,UAAmC,CAAC;EAC1C,KAAK,MAAM,UAAU,OAAO,oBAC1B,OAAO,eAAe,QAAQ,CAChC,GAAG;GACD,IAAI,WAAW,eAAe;GAC9B,QAAQ,UAAU,OAAO,UAAiC,CAAC,MACzD,SACE,MAAM,SAAS,OAAO,CAAE;IACtB,GAAG;IAGH,SACE,QAAQ,mBAAmB,WAC3B,MAAM,QAAQ,QAAQ,OAAO,IACzB,OAAO,YAAY,IAAI,QAAQ,QAAQ,OAAO,CAAC,IAC/C,QAAQ;IACd,GAAI,kBAAkB,IAAI,GAAG,KAAK,GAAG,QAAQ,KAAK,EAChD,SAAS,OACX;IACA,cAAc;GAChB,CAAC,CACH;EACJ;EACA,IAAI,QAAQ;CACd;CACA,OAAO;AACT;;;;;;;;;AAgBA,SAAS,SAAS,EAChB,MACA,OACA,YACyC;CACzC,IAAI,UAAU,KAAA,GAAW,OAAOI,eAAAA,GAAG,IAAI;CACvC,IAAI,iBAAiBC,aAAAA,yBAAyB,OAAOC,eAAAA,IAAI,MAAM,YAAY;CAC3E,IAAI,YAAY,CAAC,SAAS,IAExB,OAAOA,eAAAA,IAAIC,aAAAA,mBAAmB,UAAU,KAAK,CAAC;CAEhD,IAAI,CAAC,YAAY,iBAAiBC,IAAAA,UAChC,OAAOF,eAAAA,IAAI;EACT,MAAM;EACN,SAAS;CACX,CAAC;CAEH,IAAI,YAAY,iBAAiB,aAC/B,OAAOA,eAAAA,IAAI;EACT,MAAM;EACN,SAAS;CACX,CAAC;CAEH,IAAI,YAAY,iBAAiBE,IAAAA,UAE/B,OAAOF,eAAAA,IAAI;EACT,MAAM;EACN,SAAS;CACX,CAAC;CAEH,MAAM;AACR"}

package/dist/client.d.cts

@@ -1,8 +1,9 @@
 import { ClientConfig } from "./config.cjs";
 import { RustrakError } from "./errors.cjs";
+import { BINARY } from "./generated/binary.gen.cjs";
 import { Rustrak } from "./generated/sdk.gen.cjs";
 import { Result } from "./result.cjs";
-type Binary = 'events.downloadAttachment';
+type Binary = (typeof BINARY)[number];
 type RequestKeys = 'path' | 'query' | 'body' | 'headers' | 'signal';
 type Call<F, Bytes extends boolean> = F extends ((options: infer O) => infer R) ? (...args: {} extends Pick<O, Extract<keyof O, RequestKeys>> ? [options?: Pick<O, Extract<keyof O, RequestKeys>>] : [options: Pick<O, Extract<keyof O, RequestKeys>>]) => Promise<Result<Bytes extends true ? Blob : Data<Awaited<R>>, RustrakError>> : never;
 type Data<R> = Extract<R, {

package/dist/client.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.cts","names":[],"sources":["../src/client.ts"],"mappings":";;;;KAgBK;KAMA;KAEA,KAAK,GAAG,yBAAyB,YAAW,eAAe,YAAY,SAEnE,iBAAiB,KAAK,GAAG,cAAc,GAAG,iBACxC,UAAU,KAAK,GAAG,cAAc,GAAG,kBACnC,SAAS,KAAK,GAAG,cAAc,GAAG,mBACpC,QACH,OAAO,qBAAqB,OAAO,KAAK,QAAQ,KAAK;KAKtD,KAAK,KACR,QAAQ;EAAK;;EAA8B,YAAY;IAAM;KAE1D,SAAS,GAAG,mCACL,WAAW,IAAI,KACvB,EAAE,OACC,QAAQ,qBAAqB;YAUxB,4BACA,WAAW,UAAU,SAAS,QAAQ,IAAI;qBAkBzC,oBAMX,QAAQ,iBACL"}
+{"version":3,"file":"client.d.cts","names":[],"sources":["../src/client.ts"],"mappings":";;;;;KAiBK,iBAAiB;KAIjB;KAEA,KAAK,GAAG,yBAAyB,YAAW,eAAe,YAAY,SAEnE,iBAAiB,KAAK,GAAG,cAAc,GAAG,iBACxC,UAAU,KAAK,GAAG,cAAc,GAAG,kBACnC,SAAS,KAAK,GAAG,cAAc,GAAG,mBACpC,QACH,OAAO,qBAAqB,OAAO,KAAK,QAAQ,KAAK;KAKtD,KAAK,KACR,QAAQ;EAAK;;EAA8B,YAAY;IAAM;KAE1D,SAAS,GAAG,mCACL,WAAW,IAAI,KACvB,EAAE,OACC,QAAQ,qBAAqB;YAUxB,4BACA,WAAW,UAAU,SAAS,QAAQ,IAAI;qBAkBzC,oBAMX,QAAQ,iBACL"}

package/dist/client.d.mts

@@ -1,8 +1,9 @@
 import { ClientConfig } from "./config.mjs";
 import { RustrakError } from "./errors.mjs";
+import { BINARY } from "./generated/binary.gen.mjs";
 import { Rustrak } from "./generated/sdk.gen.mjs";
 import { Result } from "./result.mjs";
-type Binary = 'events.downloadAttachment';
+type Binary = (typeof BINARY)[number];
 type RequestKeys = 'path' | 'query' | 'body' | 'headers' | 'signal';
 type Call<F, Bytes extends boolean> = F extends ((options: infer O) => infer R) ? (...args: {} extends Pick<O, Extract<keyof O, RequestKeys>> ? [options?: Pick<O, Extract<keyof O, RequestKeys>>] : [options: Pick<O, Extract<keyof O, RequestKeys>>]) => Promise<Result<Bytes extends true ? Blob : Data<Awaited<R>>, RustrakError>> : never;
 type Data<R> = Extract<R, {

package/dist/client.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.mts","names":[],"sources":["../src/client.ts"],"mappings":";;;;KAgBK;KAMA;KAEA,KAAK,GAAG,yBAAyB,YAAW,eAAe,YAAY,SAEnE,iBAAiB,KAAK,GAAG,cAAc,GAAG,iBACxC,UAAU,KAAK,GAAG,cAAc,GAAG,kBACnC,SAAS,KAAK,GAAG,cAAc,GAAG,mBACpC,QACH,OAAO,qBAAqB,OAAO,KAAK,QAAQ,KAAK;KAKtD,KAAK,KACR,QAAQ;EAAK;;EAA8B,YAAY;IAAM;KAE1D,SAAS,GAAG,mCACL,WAAW,IAAI,KACvB,EAAE,OACC,QAAQ,qBAAqB;YAUxB,4BACA,WAAW,UAAU,SAAS,QAAQ,IAAI;qBAkBzC,oBAMX,QAAQ,iBACL"}
+{"version":3,"file":"client.d.mts","names":[],"sources":["../src/client.ts"],"mappings":";;;;;KAiBK,iBAAiB;KAIjB;KAEA,KAAK,GAAG,yBAAyB,YAAW,eAAe,YAAY,SAEnE,iBAAiB,KAAK,GAAG,cAAc,GAAG,iBACxC,UAAU,KAAK,GAAG,cAAc,GAAG,kBACnC,SAAS,KAAK,GAAG,cAAc,GAAG,mBACpC,QACH,OAAO,qBAAqB,OAAO,KAAK,QAAQ,KAAK;KAKtD,KAAK,KACR,QAAQ;EAAK;;EAA8B,YAAY;IAAM;KAE1D,SAAS,GAAG,mCACL,WAAW,IAAI,KACvB,EAAE,OACC,QAAQ,qBAAqB;YAUxB,4BACA,WAAW,UAAU,SAAS,QAAQ,IAAI;qBAkBzC,oBAMX,QAAQ,iBACL"}

package/dist/client.mjs

@@ -1,11 +1,12 @@
+import { BINARY } from "./generated/binary.gen.mjs";
 import { createConfig } from "./generated/client/utils.gen.mjs";
 import { createClient } from "./generated/client/client.gen.mjs";
 import { Rustrak } from "./generated/sdk.gen.mjs";
 import { Err, Ok } from "./result.mjs";
-import { createFetch, isTransportFailure, transformHttpError } from "./utils/http.mjs";
+import { RustrakTransportFailure, createFetch, transformHttpError } from "./utils/http.mjs";
 import { ZodError } from "zod";
 // src/client.ts
-const BINARY = /* @__PURE__ */ new Set(["events.downloadAttachment"]);
+const BINARY_OPERATIONS = new Set(BINARY);
 /**
 * Main Rustrak API client. Every method returns a `Result`; nothing throws for
 * an expected failure.
@@ -48,7 +49,7 @@ function createApi(config) {
 			methods[method] = async (options = {}) => toResult(await resource[method]({
 				...options,
 				headers: options.headers instanceof Headers || Array.isArray(options.headers) ? Object.fromEntries(new Headers(options.headers)) : options.headers,
-				...BINARY.has(`${name}.${method}`) && { parseAs: "blob" },
+				...BINARY_OPERATIONS.has(`${name}.${method}`) && { parseAs: "blob" },
 				throwOnError: false
 			}));
 		}
@@ -66,7 +67,7 @@ function createApi(config) {
 */
 function toResult({ data, error, response }) {
 	if (error === void 0) return Ok(data);
-	if (isTransportFailure(error)) return Err(error.rustrakError);
+	if (error instanceof RustrakTransportFailure) return Err(error.rustrakError);
 	if (response && !response.ok) return Err(transformHttpError(response, error));
 	if (!response && error instanceof ZodError) return Err({
 		kind: "invalid_request",

package/dist/client.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import { ZodError } from 'zod';\nimport type { ClientConfig } from './config.js';\nimport type { RustrakError } from './errors.js';\nimport { createClient, createConfig } from './generated/client/index.js';\nimport { Rustrak } from './generated/sdk.gen.js';\nimport { Err, Ok, type Result } from './result.js';\nimport {\n  createFetch,\n  isTransportFailure,\n  transformHttpError,\n} from './utils/http.js';\n\n/**\n * Operations whose 2xx is a file, not JSON: read as a `Blob`. The spec leaves\n * the body untyped (zod has no binary type), so the type comes from here.\n */\ntype Binary = 'events.downloadAttachment';\nconst BINARY: ReadonlySet<string> = new Set<Binary>([\n  'events.downloadAttachment',\n]);\n\n/** What a caller may pass: the request's own parts, never client plumbing. */\ntype RequestKeys = 'path' | 'query' | 'body' | 'headers' | 'signal';\n\ntype Call<F, Bytes extends boolean> = F extends (options: infer O) => infer R\n  ? (\n      ...args: {} extends Pick<O, Extract<keyof O, RequestKeys>>\n        ? [options?: Pick<O, Extract<keyof O, RequestKeys>>]\n        : [options: Pick<O, Extract<keyof O, RequestKeys>>]\n    ) => Promise<\n      Result<Bytes extends true ? Blob : Data<Awaited<R>>, RustrakError>\n    >\n  : never;\n\n/** The success half of the generated `{ data, error }` union. */\ntype Data<R> =\n  Extract<R, { error: undefined }> extends { data: infer D } ? D : never;\n\ntype Resource<T, Name extends string> = {\n  readonly [M in keyof T]: Call<\n    T[M],\n    `${Name}.${M & string}` extends Binary ? true : false\n  >;\n};\n\n/**\n * Every operation in `openapi.json`, grouped by tag:\n * `client.issues.list({ path: { project_id } })`.\n *\n * Generated in `src/generated/`; this file only changes what a call returns.\n */\nexport type RustrakClient = {\n  readonly [R in keyof Rustrak]: Resource<Rustrak[R], R & string>;\n};\n\n/**\n * Main Rustrak API client. Every method returns a `Result`; nothing throws for\n * an expected failure.\n *\n * @example\n * ```typescript\n * const client = new RustrakClient({\n *   baseUrl: 'http://localhost:8080',\n *   token: 'your-api-token',\n * });\n *\n * const issues = await client.issues.list({ path: { project_id: 1 } });\n * if (issues.success) console.log(issues.data.items);\n * ```\n */\nexport const RustrakClient = class {\n  constructor(config: ClientConfig) {\n    // biome-ignore lint/correctness/noConstructorReturn: the instance is the generated SDK with every method wrapped\n    return Object.setPrototypeOf(createApi(config), new.target.prototype);\n  }\n} as unknown as new (\n  config: ClientConfig,\n) => RustrakClient;\n\nfunction createApi(config: ClientConfig): RustrakClient {\n  const sdk = new Rustrak({\n    client: createClient(\n      createConfig({\n        baseUrl: config.baseUrl,\n        credentials: 'include',\n        fetch: createFetch(config),\n        // Every 2xx in the spec is JSON or empty, except the files in\n        // `BINARY`. `auto` would hand back an HTML page or a stream as a\n        // success without validating it.\n        parseAs: 'json',\n        headers: {\n          // Without it a content-negotiating hop can answer with HTML.\n          Accept: 'application/json',\n          ...config.headers,\n          ...(config.token && { Authorization: `Bearer ${config.token}` }),\n        },\n      }),\n    ),\n  });\n\n  const api: Record<string, Record<string, unknown>> = {};\n  for (const name of Object.getOwnPropertyNames(Rustrak.prototype)) {\n    if (name === 'constructor') continue;\n    const resource = sdk[name as keyof Rustrak] as unknown as Record<\n      string,\n      (options: object) => Promise<Outcome>\n    >;\n    const methods: Record<string, unknown> = {};\n    for (const method of Object.getOwnPropertyNames(\n      Object.getPrototypeOf(resource),\n    )) {\n      if (method === 'constructor') continue;\n      methods[method] = async (options: { headers?: unknown } = {}) =>\n        toResult(\n          await resource[method]!({\n            ...options,\n            // A JSON write spreads these into an object, which keeps nothing\n            // of a `Headers` or an array of pairs.\n            headers:\n              options.headers instanceof Headers ||\n              Array.isArray(options.headers)\n                ? Object.fromEntries(new Headers(options.headers))\n                : options.headers,\n            ...(BINARY.has(`${name}.${method}`) && { parseAs: 'blob' }),\n            throwOnError: false,\n          }),\n        );\n    }\n    api[name] = methods;\n  }\n  return api as unknown as RustrakClient;\n}\n\ntype Outcome = {\n  data?: unknown;\n  error?: unknown;\n  response?: Response;\n};\n\n/**\n * The boundary: the generated client's `{ data, error, response }` becomes a\n * `Result`.\n *\n * Only failures this file recognises become an `Err`. Anything else, a\n * `TypeError` from a genuine bug, is rethrown so it crashes where it can be\n * debugged instead of being laundered into `{ success: false }`.\n */\nfunction toResult({\n  data,\n  error,\n  response,\n}: Outcome): Result<unknown, RustrakError> {\n  if (error === undefined) return Ok(data);\n  if (isTransportFailure(error)) return Err(error.rustrakError);\n  if (response && !response.ok) {\n    // `error` is the parsed body, or its text when it is not JSON.\n    return Err(transformHttpError(response, error));\n  }\n  if (!response && error instanceof ZodError) {\n    return Err({\n      kind: 'invalid_request',\n      message: 'The request input did not match the expected schema.',\n    });\n  }\n  if (response && error instanceof SyntaxError) {\n    return Err({\n      kind: 'invalid_response',\n      message: 'The server returned a body that is not valid JSON.',\n    });\n  }\n  if (response && error instanceof ZodError) {\n    // No Zod issues: they embed the offending response data.\n    return Err({\n      kind: 'invalid_response',\n      message: 'The server response did not match the expected schema.',\n    });\n  }\n  throw error;\n}\n"],"mappings":";;;;;;;AAiBA,MAAM,yBAA8B,IAAI,IAAY,CAClD,2BACF,CAAC;;;;;;;;;;;;;;;;AAmDD,MAAa,gBAAgB,MAAM;CACjC,YAAY,QAAsB;EAEhC,OAAO,OAAO,eAAe,UAAU,MAAM,GAAG,WAAW,SAAS;CACtE;AACF;AAIA,SAAS,UAAU,QAAqC;CACtD,MAAM,MAAM,IAAI,QAAQ,EACtB,QAAQ,aACN,aAAa;EACX,SAAS,OAAO;EAChB,aAAa;EACb,OAAO,YAAY,MAAM;EAIzB,SAAS;EACT,SAAS;GAEP,QAAQ;GACR,GAAG,OAAO;GACV,GAAI,OAAO,SAAS,EAAE,eAAe,UAAU,OAAO,QAAQ;EAChE;CACF,CAAC,CACH,EACF,CAAC;CAED,MAAM,MAA+C,CAAC;CACtD,KAAK,MAAM,QAAQ,OAAO,oBAAoB,QAAQ,SAAS,GAAG;EAChE,IAAI,SAAS,eAAe;EAC5B,MAAM,WAAW,IAAI;EAIrB,MAAM,UAAmC,CAAC;EAC1C,KAAK,MAAM,UAAU,OAAO,oBAC1B,OAAO,eAAe,QAAQ,CAChC,GAAG;GACD,IAAI,WAAW,eAAe;GAC9B,QAAQ,UAAU,OAAO,UAAiC,CAAC,MACzD,SACE,MAAM,SAAS,OAAO,CAAE;IACtB,GAAG;IAGH,SACE,QAAQ,mBAAmB,WAC3B,MAAM,QAAQ,QAAQ,OAAO,IACzB,OAAO,YAAY,IAAI,QAAQ,QAAQ,OAAO,CAAC,IAC/C,QAAQ;IACd,GAAI,OAAO,IAAI,GAAG,KAAK,GAAG,QAAQ,KAAK,EAAE,SAAS,OAAO;IACzD,cAAc;GAChB,CAAC,CACH;EACJ;EACA,IAAI,QAAQ;CACd;CACA,OAAO;AACT;;;;;;;;;AAgBA,SAAS,SAAS,EAChB,MACA,OACA,YACyC;CACzC,IAAI,UAAU,KAAA,GAAW,OAAO,GAAG,IAAI;CACvC,IAAI,mBAAmB,KAAK,GAAG,OAAO,IAAI,MAAM,YAAY;CAC5D,IAAI,YAAY,CAAC,SAAS,IAExB,OAAO,IAAI,mBAAmB,UAAU,KAAK,CAAC;CAEhD,IAAI,CAAC,YAAY,iBAAiB,UAChC,OAAO,IAAI;EACT,MAAM;EACN,SAAS;CACX,CAAC;CAEH,IAAI,YAAY,iBAAiB,aAC/B,OAAO,IAAI;EACT,MAAM;EACN,SAAS;CACX,CAAC;CAEH,IAAI,YAAY,iBAAiB,UAE/B,OAAO,IAAI;EACT,MAAM;EACN,SAAS;CACX,CAAC;CAEH,MAAM;AACR"}
+{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import { ZodError } from 'zod';\nimport type { ClientConfig } from './config.js';\nimport type { RustrakError } from './errors.js';\nimport { BINARY } from './generated/binary.gen.js';\nimport { createClient, createConfig } from './generated/client/index.js';\nimport { Rustrak } from './generated/sdk.gen.js';\nimport { Err, Ok, type Result } from './result.js';\nimport {\n  createFetch,\n  RustrakTransportFailure,\n  transformHttpError,\n} from './utils/http.js';\n\n/**\n * Operations whose 2xx is a file, read as a `Blob`. The spec leaves the body\n * untyped (zod has no binary type), so the type comes from this list.\n */\ntype Binary = (typeof BINARY)[number];\nconst BINARY_OPERATIONS: ReadonlySet<string> = new Set(BINARY);\n\n/** What a caller may pass: the request's own parts, never client plumbing. */\ntype RequestKeys = 'path' | 'query' | 'body' | 'headers' | 'signal';\n\ntype Call<F, Bytes extends boolean> = F extends (options: infer O) => infer R\n  ? (\n      ...args: {} extends Pick<O, Extract<keyof O, RequestKeys>>\n        ? [options?: Pick<O, Extract<keyof O, RequestKeys>>]\n        : [options: Pick<O, Extract<keyof O, RequestKeys>>]\n    ) => Promise<\n      Result<Bytes extends true ? Blob : Data<Awaited<R>>, RustrakError>\n    >\n  : never;\n\n/** The success half of the generated `{ data, error }` union. */\ntype Data<R> =\n  Extract<R, { error: undefined }> extends { data: infer D } ? D : never;\n\ntype Resource<T, Name extends string> = {\n  readonly [M in keyof T]: Call<\n    T[M],\n    `${Name}.${M & string}` extends Binary ? true : false\n  >;\n};\n\n/**\n * Every operation in `openapi.json`, grouped by tag:\n * `client.issues.list({ path: { project_id } })`.\n *\n * Generated in `src/generated/`; this file only changes what a call returns.\n */\nexport type RustrakClient = {\n  readonly [R in keyof Rustrak]: Resource<Rustrak[R], R & string>;\n};\n\n/**\n * Main Rustrak API client. Every method returns a `Result`; nothing throws for\n * an expected failure.\n *\n * @example\n * ```typescript\n * const client = new RustrakClient({\n *   baseUrl: 'http://localhost:8080',\n *   token: 'your-api-token',\n * });\n *\n * const issues = await client.issues.list({ path: { project_id: 1 } });\n * if (issues.success) console.log(issues.data.items);\n * ```\n */\nexport const RustrakClient = class {\n  constructor(config: ClientConfig) {\n    // biome-ignore lint/correctness/noConstructorReturn: the instance is the generated SDK with every method wrapped\n    return Object.setPrototypeOf(createApi(config), new.target.prototype);\n  }\n} as unknown as new (\n  config: ClientConfig,\n) => RustrakClient;\n\nfunction createApi(config: ClientConfig): RustrakClient {\n  const sdk = new Rustrak({\n    client: createClient(\n      createConfig({\n        baseUrl: config.baseUrl,\n        credentials: 'include',\n        fetch: createFetch(config),\n        // Every 2xx in the spec is JSON or empty, except the files in\n        // `BINARY`. `auto` would hand back an HTML page or a stream as a\n        // success without validating it.\n        parseAs: 'json',\n        headers: {\n          // Without it a content-negotiating hop can answer with HTML.\n          Accept: 'application/json',\n          ...config.headers,\n          ...(config.token && { Authorization: `Bearer ${config.token}` }),\n        },\n      }),\n    ),\n  });\n\n  const api: Record<string, Record<string, unknown>> = {};\n  for (const name of Object.getOwnPropertyNames(Rustrak.prototype)) {\n    if (name === 'constructor') continue;\n    const resource = sdk[name as keyof Rustrak] as unknown as Record<\n      string,\n      (options: object) => Promise<Outcome>\n    >;\n    const methods: Record<string, unknown> = {};\n    for (const method of Object.getOwnPropertyNames(\n      Object.getPrototypeOf(resource),\n    )) {\n      if (method === 'constructor') continue;\n      methods[method] = async (options: { headers?: unknown } = {}) =>\n        toResult(\n          await resource[method]!({\n            ...options,\n            // A JSON write spreads these into an object, which keeps nothing\n            // of a `Headers` or an array of pairs.\n            headers:\n              options.headers instanceof Headers ||\n              Array.isArray(options.headers)\n                ? Object.fromEntries(new Headers(options.headers))\n                : options.headers,\n            ...(BINARY_OPERATIONS.has(`${name}.${method}`) && {\n              parseAs: 'blob',\n            }),\n            throwOnError: false,\n          }),\n        );\n    }\n    api[name] = methods;\n  }\n  return api as unknown as RustrakClient;\n}\n\ntype Outcome = {\n  data?: unknown;\n  error?: unknown;\n  response?: Response;\n};\n\n/**\n * The boundary: the generated client's `{ data, error, response }` becomes a\n * `Result`.\n *\n * Only failures this file recognises become an `Err`. Anything else, a\n * `TypeError` from a genuine bug, is rethrown so it crashes where it can be\n * debugged instead of being laundered into `{ success: false }`.\n */\nfunction toResult({\n  data,\n  error,\n  response,\n}: Outcome): Result<unknown, RustrakError> {\n  if (error === undefined) return Ok(data);\n  if (error instanceof RustrakTransportFailure) return Err(error.rustrakError);\n  if (response && !response.ok) {\n    // `error` is the parsed body, or its text when it is not JSON.\n    return Err(transformHttpError(response, error));\n  }\n  if (!response && error instanceof ZodError) {\n    return Err({\n      kind: 'invalid_request',\n      message: 'The request input did not match the expected schema.',\n    });\n  }\n  if (response && error instanceof SyntaxError) {\n    return Err({\n      kind: 'invalid_response',\n      message: 'The server returned a body that is not valid JSON.',\n    });\n  }\n  if (response && error instanceof ZodError) {\n    // No Zod issues: they embed the offending response data.\n    return Err({\n      kind: 'invalid_response',\n      message: 'The server response did not match the expected schema.',\n    });\n  }\n  throw error;\n}\n"],"mappings":";;;;;;;;AAkBA,MAAM,oBAAyC,IAAI,IAAI,MAAM;;;;;;;;;;;;;;;;AAmD7D,MAAa,gBAAgB,MAAM;CACjC,YAAY,QAAsB;EAEhC,OAAO,OAAO,eAAe,UAAU,MAAM,GAAG,WAAW,SAAS;CACtE;AACF;AAIA,SAAS,UAAU,QAAqC;CACtD,MAAM,MAAM,IAAI,QAAQ,EACtB,QAAQ,aACN,aAAa;EACX,SAAS,OAAO;EAChB,aAAa;EACb,OAAO,YAAY,MAAM;EAIzB,SAAS;EACT,SAAS;GAEP,QAAQ;GACR,GAAG,OAAO;GACV,GAAI,OAAO,SAAS,EAAE,eAAe,UAAU,OAAO,QAAQ;EAChE;CACF,CAAC,CACH,EACF,CAAC;CAED,MAAM,MAA+C,CAAC;CACtD,KAAK,MAAM,QAAQ,OAAO,oBAAoB,QAAQ,SAAS,GAAG;EAChE,IAAI,SAAS,eAAe;EAC5B,MAAM,WAAW,IAAI;EAIrB,MAAM,UAAmC,CAAC;EAC1C,KAAK,MAAM,UAAU,OAAO,oBAC1B,OAAO,eAAe,QAAQ,CAChC,GAAG;GACD,IAAI,WAAW,eAAe;GAC9B,QAAQ,UAAU,OAAO,UAAiC,CAAC,MACzD,SACE,MAAM,SAAS,OAAO,CAAE;IACtB,GAAG;IAGH,SACE,QAAQ,mBAAmB,WAC3B,MAAM,QAAQ,QAAQ,OAAO,IACzB,OAAO,YAAY,IAAI,QAAQ,QAAQ,OAAO,CAAC,IAC/C,QAAQ;IACd,GAAI,kBAAkB,IAAI,GAAG,KAAK,GAAG,QAAQ,KAAK,EAChD,SAAS,OACX;IACA,cAAc;GAChB,CAAC,CACH;EACJ;EACA,IAAI,QAAQ;CACd;CACA,OAAO;AACT;;;;;;;;;AAgBA,SAAS,SAAS,EAChB,MACA,OACA,YACyC;CACzC,IAAI,UAAU,KAAA,GAAW,OAAO,GAAG,IAAI;CACvC,IAAI,iBAAiB,yBAAyB,OAAO,IAAI,MAAM,YAAY;CAC3E,IAAI,YAAY,CAAC,SAAS,IAExB,OAAO,IAAI,mBAAmB,UAAU,KAAK,CAAC;CAEhD,IAAI,CAAC,YAAY,iBAAiB,UAChC,OAAO,IAAI;EACT,MAAM;EACN,SAAS;CACX,CAAC;CAEH,IAAI,YAAY,iBAAiB,aAC/B,OAAO,IAAI;EACT,MAAM;EACN,SAAS;CACX,CAAC;CAEH,IAAI,YAAY,iBAAiB,UAE/B,OAAO,IAAI;EACT,MAAM;EACN,SAAS;CACX,CAAC;CAEH,MAAM;AACR"}

package/dist/config.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../src/config.ts"],"mappings":"A,iBAGiB;EAKf;EAOA;EAMA;EAMA;EAKA,UAAU"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../src/config.ts"],"mappings":"A,iBAAiB;EAEf;EAGA;EAMA;EAMA;EAEA,UAAU"}

package/dist/config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config.ts"],"mappings":"A,iBAGiB;EAKf;EAOA;EAMA;EAMA;EAKA,UAAU"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config.ts"],"mappings":"A,iBAAiB;EAEf;EAGA;EAMA;EAMA;EAEA,UAAU"}

package/dist/errors.cjs

@@ -16,6 +16,7 @@ const FIELD_ERROR_CODES = [
 	"already_exists",
 	"too_short",
 	"too_long",
+	"incorrect",
 	"custom"
 ];
 /**
@@ -33,19 +34,31 @@ const NETWORK_ERROR_MESSAGE = "The request could not reach the server.";
 /** The fixed message a `network` error carries when the client timed out. */
 const TIMEOUT_ERROR_MESSAGE = "The request timed out.";
 /**
-* Whether retrying the same call could plausibly succeed.
-*
-* `network` and `server_error` are transient by nature; `rate_limited` clears
-* once its window rolls over. Everything else is deterministic: the same
-* request will fail the same way.
+* Statuses where the same request may well succeed a moment later. The one
+* rule behind {@link isRetryable} and the transport's automatic retries.
+*/
+const TRANSIENT_STATUSES = /* @__PURE__ */ new Set([
+	408,
+	429,
+	500,
+	502,
+	503,
+	504
+]);
+/**
+* Whether retrying the same call could plausibly succeed: a request that never
+* got a response, or a transient status. A `rate_limited` error says how long
+* to wait in `retryAfter`. Everything else is deterministic: the same request
+* will fail the same way.
 */
 function isRetryable(error) {
-	return error.kind === "network" || error.kind === "server_error" || error.kind === "rate_limited";
+	return error.kind === "network" || "status" in error && TRANSIENT_STATUSES.has(error.status);
 }
 exports.FIELD_ERROR_CODES = FIELD_ERROR_CODES;
 exports.NETWORK_ERROR_MESSAGE = NETWORK_ERROR_MESSAGE;
 exports.SERVER_ERROR_MESSAGE = SERVER_ERROR_MESSAGE;
 exports.TIMEOUT_ERROR_MESSAGE = TIMEOUT_ERROR_MESSAGE;
+exports.TRANSIENT_STATUSES = TRANSIENT_STATUSES;
 exports.isRetryable = isRetryable;
 
 //# sourceMappingURL=errors.cjs.map