@ycadence/sdk 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Yarlis, Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,112 @@
-# Temporary Holding Version
+# @ycadence/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.
+A TypeScript client for the YCadence REST API. The YCadence CLI and MCP server use it too.
+
+- No runtime dependencies. It uses the platform `fetch`.
+- It runs in Node 18+, Bun, Deno and browsers. Ships ESM with type declarations.
+
+## Install
+
+```sh
+npm install @ycadence/sdk
+```
+
+### If npm is unavailable
+
+Each release is mirrored to GitHub Packages when the npm publish fails, as
+`@yarlisaisolutions/ycadence-sdk`. It needs a GitHub token with `read:packages`:
+
+```sh
+# ~/.npmrc
+@yarlisaisolutions:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
+```
+
+```sh
+npm install @yarlisaisolutions/ycadence-sdk
+```
+
+## Use
+
+```ts
+import { YCadenceClient, YCadenceError } from '@ycadence/sdk'
+
+const client = new YCadenceClient({
+  baseUrl: 'https://ycadence.example.com',
+  apiKey: process.env.YCADENCE_API_KEY!, // a project, organization or personal key
+})
+
+const page = await client.listWorkItems('<projectId>', {
+  filter: { field: 'priority', operator: 'is', value: 'urgent' },
+  limit: 50,
+})
+
+try {
+  await client.createWorkItem('<projectId>', { name: 'Fix login redirect', priority: 'high' })
+} catch (error) {
+  if (error instanceof YCadenceError) {
+    console.error(error.status, error.code, error.message, error.issues)
+    if (error.retryable) {
+      // 429 or 5xx
+    }
+  }
+}
+```
+
+### Writes, retries and concurrency
+
+Every method takes an optional last argument of request options:
+
+```ts
+await client.createWorkItem(projectId, { name: 'Fix login' }, { idempotencyKey: 'import-row-17' })
+await client.updateWorkItem(id, { priority: 'urgent' }, { expectedVersion: 7 }) // If-Match: "7"
+```
+
+- `idempotencyKey` is sent as `Idempotency-Key`, and makes the write safe to retry.
+- `expectedVersion` is sent as `If-Match`. A server that versions the resource answers 409
+  `version_conflict` (or 412) when it has moved on; one that does not ignores the header.
+- GET requests, and writes that carry an idempotency key, are retried on 429, 5xx, timeouts
+  and network errors: twice by default, with exponential backoff and jitter, honouring
+  `Retry-After`. Other writes are never retried, since they may already have been applied.
+
+### Errors
+
+Every failure is a `YCadenceError` with `status`, `code`, `message`, `issues`, `details`,
+`requestId` and `retryable`, and is also an instance of a class for its kind:
+`YCadenceValidationError` (400, 422), `YCadencePermissionError` (401, 403),
+`YCadenceNotFoundError` (404), `YCadenceConflictError` (409), `YCadencePreconditionError`
+(412), `YCadenceRateLimitError` (429, with `retryAfter`) and `YCadenceNetworkError`
+(unreachable or timed out).
+
+### Pages
+
+Lists return `{ items, nextCursor }`. `iterateWorkItems` follows the cursor lazily, and
+`paginate` / `collect` do the same for any list:
+
+```ts
+import { collect, paginate } from '@ycadence/sdk'
+const all = await collect(paginate((cursor) => client.listWorkItems(projectId, { cursor })))
+```
+
+### Options
+
+| Option | Meaning |
+|---|---|
+| `baseUrl` | Your instance, for example `https://ycadence.example.com`. Trailing slashes are fine. |
+| `apiKey` | Sent as `x-api-key`. |
+| `identityToken` | Only for an instance behind Google IAP or authenticated Cloud Run. Pass a string or a function, which is called before each request; it is sent as `Authorization: Bearer`. |
+| `timeoutMs` | Defaults to 30000. |
+| `fetch` | A custom `fetch`, for tests or proxies. |
+| `retry` | `{ retries, baseDelayMs, maxDelayMs }`; `{ retries: 0 }` turns retrying off. |
+| `userAgent` | Prepended to `User-Agent` (`ycadence-sdk/<version>`). |
+| `onResponse` | Called after every response with method, path, status, request id, duration and attempt. Never sees credentials. |
+
+## Renamed from DevPulse
+
+`DevPulseClient` and `DevPulseError` still work, as deprecated aliases of
+`YCadenceClient` and `YCadenceError`. `error instanceof DevPulseError` still matches.
+Existing API keys that start with `dp_` keep working. New keys start with `yc_`.
+
+## License
+
+Apache-2.0

package/dist/client.d.ts

@@ -0,0 +1,190 @@
+/**
+ * The YCadence client.
+ *
+ * Shared by the CLI, the MCP server and anyone integrating from TypeScript, so
+ * there is one place that knows how to talk to the API — how errors are shaped,
+ * how paging works, how a key is presented, when a request is safe to retry.
+ * Three separate implementations of that would disagree, and the disagreement
+ * would surface as "the CLI works but the MCP server does not".
+ */
+import { YCadenceError } from './errors';
+import { type OperationId } from './operations';
+import type { CreateViewInput, CreateWorkItemInput, Cycle, CycleProgress, Health, ImportInput, ImportPreview, ImportRun, IntakeItem, Label, ListWorkItemsOptions, Me, Page, Project, State, SubmitIntakeInput, SubmitIntakeResult, TriageInput, TriageResult, UpdateWorkItemInput, View, WorkItem, WorkItemDetail } from './types';
+export interface RetryOptions {
+    /** Attempts after the first. Default 2. `0` turns retrying off. */
+    retries?: number;
+    /** First backoff, doubled each attempt, with jitter. Default 250ms. */
+    baseDelayMs?: number;
+    /** Ceiling for one wait, including a server's `Retry-After`. Default 8s. */
+    maxDelayMs?: number;
+}
+/** What happened to one HTTP exchange; for logging. Never carries credentials. */
+export interface ResponseInfo {
+    method: string;
+    path: string;
+    status: number;
+    requestId: string | undefined;
+    durationMs: number;
+    attempt: number;
+    replayed: boolean;
+}
+export interface ClientOptions {
+    /** e.g. https://ycadence.example.com. Trailing slashes are tolerated. */
+    baseUrl: string;
+    apiKey: string;
+    /**
+     * A Google identity token for an instance behind IAP or an authenticated
+     * Cloud Run service, sent as `Authorization: Bearer`. The transport's
+     * credential and the product's are different things and travel in different
+     * headers: the key always goes in `x-api-key`.
+     *
+     * A function is called before every request, because these tokens last
+     * about an hour and a long-running caller — the MCP server — outlives one.
+     */
+    identityToken?: string | (() => string | undefined | Promise<string | undefined>);
+    /** Defaults to 30s. A request that hangs forever is worse than one that fails. */
+    timeoutMs?: number;
+    fetch?: typeof globalThis.fetch;
+    /**
+     * Retries for 429, 5xx, timeouts and network errors. Only GET requests, and
+     * mutations sent with an idempotency key, are retried: repeating any other
+     * write could apply it twice.
+     */
+    retry?: RetryOptions;
+    /** Prepended to the default `User-Agent`, e.g. `ycadence-cli/0.2.0`. */
+    userAgent?: string;
+    /** Called after every response, including ones that are retried. */
+    onResponse?: (info: ResponseInfo) => void;
+    /** Injected for tests; defaults to a timer. */
+    sleep?: (ms: number) => Promise<void>;
+}
+/** Per-call options for any request. */
+export interface RequestOptions {
+    /**
+     * Sent as `Idempotency-Key` on a mutation, which also makes the mutation
+     * safe to retry. Servers that do not support the header ignore it.
+     */
+    idempotencyKey?: string;
+    /**
+     * The version the caller last saw, sent as `If-Match: "<version>"`. A server
+     * that versions the resource answers 409 `version_conflict` or 412 when it
+     * has moved on; one that does not ignores the header.
+     */
+    expectedVersion?: number | string;
+    signal?: AbortSignal;
+    /** Overrides the client's retry count for this call. */
+    retries?: number;
+}
+export declare class YCadenceClient {
+    private readonly options;
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly identityToken;
+    private readonly timeoutMs;
+    private readonly doFetch;
+    private readonly retry;
+    private readonly userAgent;
+    private readonly onResponse;
+    private readonly sleep;
+    constructor(options: ClientOptions);
+    /** A copy of this client with some options replaced. */
+    withOptions(overrides: Partial<ClientOptions>): YCadenceClient;
+    /** The fetch this client sends with; for wrapping in `withOptions`. */
+    get fetchImplementation(): typeof globalThis.fetch;
+    health(): Promise<Health>;
+    /** Who the credential is. A 404 means the server predates Slice 2A. */
+    me(options?: RequestOptions): Promise<Me>;
+    /** Projects the credential can read; `q` matches a name or identifier prefix. */
+    listProjects(query?: {
+        q?: string;
+        archived?: boolean;
+        limit?: number;
+        cursor?: string;
+    }, options?: RequestOptions): Promise<Page<Project>>;
+    listWorkItems(projectId: string, query?: ListWorkItemsOptions, options?: RequestOptions): Promise<Page<WorkItem>>;
+    /**
+     * Every work item matching a filter, following the cursor.
+     *
+     * An async generator rather than an array: a project can hold tens of
+     * thousands of items, and a caller that wanted the first twenty should not
+     * pay for all of them — nor should the process hold them all in memory.
+     */
+    iterateWorkItems(projectId: string, options?: {
+        filter?: unknown;
+        pageSize?: number;
+    }): AsyncGenerator<WorkItem>;
+    createWorkItem(projectId: string, body: CreateWorkItemInput | Record<string, unknown>, options?: RequestOptions): Promise<WorkItem>;
+    getWorkItem(workItemId: string, options?: RequestOptions): Promise<WorkItemDetail>;
+    updateWorkItem(workItemId: string, body: UpdateWorkItemInput | Record<string, unknown>, options?: RequestOptions): Promise<WorkItem>;
+    deleteWorkItem(workItemId: string, options?: RequestOptions): Promise<void>;
+    listStates(projectId: string, options?: RequestOptions): Promise<{
+        states: State[];
+    }>;
+    listLabels(projectId: string, options?: RequestOptions): Promise<{
+        labels: Label[];
+    }>;
+    createLabel(projectId: string, body: {
+        name: string;
+        color: string;
+        description?: string;
+    }, options?: RequestOptions): Promise<Label>;
+    listTypes(projectId: string, options?: RequestOptions): Promise<{
+        types: unknown[];
+    }>;
+    listCycles(projectId: string, options?: RequestOptions): Promise<{
+        cycles: Cycle[];
+    }>;
+    createCycle(projectId: string, body: {
+        name: string;
+        description?: string;
+        startDate?: string;
+        endDate?: string;
+    }, options?: RequestOptions): Promise<Cycle>;
+    getCycleProgress(cycleId: string, options?: RequestOptions): Promise<CycleProgress>;
+    addWorkItemsToCycle(cycleId: string, workItemIds: string[], options?: RequestOptions): Promise<{
+        added: number;
+    }>;
+    listViews(projectId: string, options?: RequestOptions): Promise<{
+        views: View[];
+    }>;
+    createView(projectId: string, body: CreateViewInput, options?: RequestOptions): Promise<View>;
+    listIntake(projectId: string, query?: {
+        includeDecided?: boolean;
+    }, options?: RequestOptions): Promise<{
+        items: IntakeItem[];
+    }>;
+    submitIntake(projectId: string, body: SubmitIntakeInput, options?: RequestOptions): Promise<SubmitIntakeResult>;
+    triageIntake(intakeItemId: string, body: TriageInput, options?: RequestOptions): Promise<TriageResult>;
+    previewImport(projectId: string, body: ImportInput | Record<string, unknown>, options?: RequestOptions): Promise<ImportPreview>;
+    startImport(projectId: string, body: ImportInput | Record<string, unknown>, options?: RequestOptions): Promise<{
+        runId: string;
+    }>;
+    getImport(runId: string, options?: RequestOptions): Promise<ImportRun>;
+    listImports(projectId: string, options?: RequestOptions): Promise<{
+        runs: ImportRun[];
+    }>;
+    /** Call any operation in the table by id. */
+    call<T>(operation: OperationId, params?: Record<string, string>, query?: Record<string, string | number | boolean | undefined>, body?: unknown, options?: RequestOptions): Promise<T>;
+    private request;
+    private backoff;
+    private send;
+}
+/** Seconds, from either form `Retry-After` takes: a number or an HTTP date. */
+export declare function parseRetryAfter(value: string | null, now?: number): number | undefined;
+export type { ImportPreview, ImportRun, Page, WorkItem } from './types';
+/**
+ * @deprecated Renamed to {@link YCadenceClient}. This alias stays for one
+ * release so existing integrations keep compiling.
+ */
+export declare const DevPulseClient: typeof YCadenceClient;
+/** @deprecated Renamed to {@link YCadenceClient}. */
+export type DevPulseClient = YCadenceClient;
+export { type ApiFailure, YCadenceError } from './errors';
+/**
+ * @deprecated Renamed to {@link YCadenceError}. The alias is the same class,
+ * so `error instanceof DevPulseError` still matches errors the client throws.
+ */
+export declare const DevPulseError: typeof YCadenceError;
+/** @deprecated Renamed to {@link YCadenceError}. */
+export type DevPulseError = YCadenceError;
+//# 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":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Errors the client throws.
+ *
+ * One base class, `YCadenceError`, so `instanceof YCadenceError` catches every
+ * failure the client produces, and a subclass per kind of failure, so a caller
+ * can branch on the class instead of comparing status codes. The base keeps its
+ * original positional constructor `(status, code, message, issues)`, because
+ * integrations construct it in their own tests.
+ */
+export interface ApiIssue {
+    path: string;
+    message: string;
+}
+/** The error body every v1 route returns (`packages/api/src/types.ts`). */
+export interface ApiFailure {
+    error: string;
+    code: string;
+    issues?: ApiIssue[];
+    /** Added by the work management contracts; absent on older servers. */
+    details?: Record<string, unknown>;
+    requestId?: string;
+}
+export interface ErrorExtras {
+    /** The server's request id, from the body or the `x-request-id` header. */
+    requestId?: string;
+    details?: Record<string, unknown>;
+    /** Seconds, from `Retry-After`, when the server sent one. */
+    retryAfter?: number;
+    method?: string;
+    path?: string;
+}
+export declare class YCadenceError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly issues?: ApiIssue[] | undefined;
+    readonly requestId: string | undefined;
+    readonly details: Record<string, unknown> | undefined;
+    readonly retryAfter: number | undefined;
+    readonly method: string | undefined;
+    readonly path: string | undefined;
+    constructor(status: number, code: string, message: string, issues?: ApiIssue[] | undefined, extras?: ErrorExtras);
+    /**
+     * Whether retrying unchanged could plausibly succeed: rate limits, server
+     * errors, timeouts and an unreachable host. A 4xx means the request itself
+     * needs to change.
+     */
+    get retryable(): boolean;
+}
+/** 400 or 422: the request was understood and refused as invalid. */
+export declare class YCadenceValidationError extends YCadenceError {
+    name: string;
+}
+/** 401 or 403: no credential, a bad one, or not allowed. */
+export declare class YCadencePermissionError extends YCadenceError {
+    name: string;
+}
+/** 404: missing, deleted, or in another organization. */
+export declare class YCadenceNotFoundError extends YCadenceError {
+    name: string;
+}
+/** 409: a domain rule, a version conflict, or the same idempotency key still running. */
+export declare class YCadenceConflictError extends YCadenceError {
+    name: string;
+}
+/** 412: an `If-Match` precondition failed; reload and try again. */
+export declare class YCadencePreconditionError extends YCadenceError {
+    name: string;
+}
+/** 429: slow down; `retryAfter` says for how long when the server said. */
+export declare class YCadenceRateLimitError extends YCadenceError {
+    name: string;
+}
+/** Status 0 or 408: the host could not be reached, or did not answer in time. */
+export declare class YCadenceNetworkError extends YCadenceError {
+    name: string;
+}
+/** The class that matches a status. */
+export declare function errorClassFor(status: number): typeof YCadenceError;
+export declare function createError(status: number, code: string, message: string, issues?: ApiIssue[], extras?: ErrorExtras): YCadenceError;
+/**
+ * Thrown, unchanged, through the client by a custom `fetch` that wants to stop
+ * a request without it being reported as a network error. The CLI's
+ * `--dry-run` uses it to show a mutation instead of sending it.
+ */
+export declare class RequestIntercepted extends Error {
+    readonly request: {
+        method: string;
+        url: string;
+        headers: Record<string, string>;
+        body: unknown;
+    };
+    name: string;
+    constructor(request: {
+        method: string;
+        url: string;
+        headers: Record<string, string>;
+        body: unknown;
+    });
+}
+//# 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":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { type ClientOptions, DevPulseClient, DevPulseError, parseRetryAfter, type RequestOptions, type ResponseInfo, type RetryOptions, YCadenceClient, } from './client.js';
+export { type ApiFailure, type ApiIssue, createError, type ErrorExtras, errorClassFor, RequestIntercepted, YCadenceConflictError, YCadenceError, YCadenceNetworkError, YCadenceNotFoundError, YCadencePermissionError, YCadencePreconditionError, YCadenceRateLimitError, YCadenceValidationError, } from './errors.js';
+export { buildPath, type HttpMethod, isIdempotentMethod, OPERATIONS, type Operation, type OperationId, } from './operations.js';
+export { collect, paginate } from './pagination.js';
+export * from './types.js';
+export { SDK_VERSION } from './version.js';
+//# 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,EACL,KAAK,aAAa,EAClB,cAAc,EACd,aAAa,EACb,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,WAAW,EACX,KAAK,WAAW,EAChB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,SAAS,EACT,KAAK,UAAU,EACf,kBAAkB,EAClB,UAAU,EACV,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACnD,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA"}