@typeship-ax/cli 0.22.0 → 0.24.0

package/src/polling-login.ts

@@ -2,9 +2,12 @@ import { createHash, randomBytes } from "node:crypto";
 import { oauthJsonRequest, oauthDeviceRequest, OAuthResponseError } from "./oauth-request.js";
 
 export class LoginPollingError extends Error {
-  constructor(readonly code: "cancelled" | "expired" | "denied" | "invalid_response" | "request_failed") {
-    super({ cancelled: "Login was cancelled.", expired: "Login expired. Run login again and approve the new request.", denied: "Login was denied. Run login again if you want to retry.", invalid_response: "The login service returned an invalid response. Check its configuration.", request_failed: "The login request failed. Check the service and start a new login." }[code]);
+  /** The provider's own `error: error_description`, when it sent one. */
+  readonly providerError?: string;
+  constructor(readonly code: "cancelled" | "expired" | "denied" | "consumed" | "invalid_response" | "request_failed", providerError?: string) {
+    super((providerError ? "The provider returned " + providerError + ". " : "") + { cancelled: "Login was cancelled.", expired: "Login expired. Run login again and approve the new request.", denied: "Login was denied. Run login again if you want to retry.", consumed: "This approval was already used. Run login again.", invalid_response: "The login service returned an invalid response. Check its configuration.", request_failed: "The login request failed. Check the service and start a new login." }[code]);
     this.name = "LoginPollingError";
+    if (providerError) this.providerError = providerError;
   }
 }
 
@@ -50,6 +53,11 @@ async function pause(ms: number, signal: AbortSignal): Promise<void> {
 }
 const form = (params: Record<string, string>, signal: AbortSignal): RequestInit => ({ method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded", Accept: "application/json" }, body: new URLSearchParams(params), signal });
 
+/** Neither the API Spec nor the provider's metadata declares a device endpoint. */
+export class DeviceFlowUnavailableError extends Error {
+  constructor() { super("This provider does not declare device authorization. Use browser login instead."); this.name = "DeviceFlowUnavailableError"; }
+}
+
 export interface DeviceLoginConfig {
   clientId: string; issuer?: string | null; discoveryUrls: string[];
   deviceUrl?: string | null; tokenUrl?: string | null;
@@ -84,11 +92,11 @@ export async function oauthDeviceLogin(config: DeviceLoginConfig, interaction: {
       if (!tokenUrl && typeof data.token_endpoint === "string") tokenUrl = loginEndpoint(data.token_endpoint).href;
       if (data.revocation_endpoint !== undefined) revocationUrl = loginEndpoint(data.revocation_endpoint as string).href;
     }
-    if (!deviceUrl || !tokenUrl) throw new LoginPollingError("invalid_response");
+    if (!deviceUrl || !tokenUrl) throw new DeviceFlowUnavailableError();
     const params = { ...(config.audience ? { audience: config.audience } : {}), ...(config.resource ? { resource: config.resource } : {}) };
     const start = await oauthJsonRequest(deviceUrl, form({ client_id: config.clientId, ...(config.scopes.length ? { scope: config.scopes.join(" ") } : {}), ...params }, flow.signal));
     const data = start.data;
-    if (start.status !== 200) throw new LoginPollingError("request_failed");
+    if (start.status !== 200) throw new LoginPollingError("request_failed", start.providerError);
     if (!data || !text(data.device_code) || !text(data.user_code, 512) || !text(data.verification_uri, 8192) || !seconds(data.expires_in)) throw new LoginPollingError("invalid_response");
     loginEndpoint(data.verification_uri);
     const verificationUri = loginEndpoint((data.verification_uri_complete ?? data.verification_uri) as string).href;
@@ -98,9 +106,12 @@ export async function oauthDeviceLogin(config: DeviceLoginConfig, interaction: {
     while (true) {
       await pause(Math.min(intervalMs, Math.max(0, deadline - Date.now())), flow.signal);
       flow.check();
-      if (Date.now() >= deadline) throw new LoginPollingError("expired");
+      // One reading of the clock: a request budget of zero or less is the
+      // login expiring, not a failed request.
+      const remaining = deadline - Date.now();
+      if (remaining <= 0) throw new LoginPollingError("expired");
       let response: Awaited<ReturnType<typeof oauthDeviceRequest>>;
-      try { response = await oauthDeviceRequest(tokenUrl, form({ ...params, grant_type: "urn:ietf:params:oauth:grant-type:device_code", device_code: data.device_code, client_id: config.clientId }, flow.signal), Math.min(30_000, deadline - Date.now())); }
+      try { response = await oauthDeviceRequest(tokenUrl, form({ ...params, grant_type: "urn:ietf:params:oauth:grant-type:device_code", device_code: data.device_code, client_id: config.clientId }, flow.signal), Math.min(30_000, remaining)); }
       catch (error) {
         flow.check();
         if (error instanceof OAuthResponseError && error.code === "timed_out") { intervalMs *= 2; continue; }
@@ -112,7 +123,7 @@ export async function oauthDeviceLogin(config: DeviceLoginConfig, interaction: {
       if (response.status === 400 && response.error === "slow_down") { intervalMs += 5000; continue; }
       if (response.status === 400 && response.error === "access_denied") throw new LoginPollingError("denied");
       if (response.status === 400 && response.error === "expired_token") throw new LoginPollingError("expired");
-      if (response.status !== 200) throw new LoginPollingError("request_failed");
+      if (response.status !== 200) throw new LoginPollingError("request_failed", response.providerError);
       const token = response.data!;
       if (!text(token.access_token) || typeof token.token_type !== "string" || token.token_type.toLowerCase() !== "bearer" || token.error !== undefined || token.refresh_token !== undefined && !text(token.refresh_token) || token.expires_in !== undefined && !seconds(token.expires_in) || token.scope !== undefined && typeof token.scope !== "string") throw new LoginPollingError("invalid_response");
       return { accessToken: token.access_token, ...(typeof token.refresh_token === "string" ? { refreshToken: token.refresh_token } : {}), ...(typeof token.expires_in === "number" ? { expiresAt: Date.now() + token.expires_in * 1000 } : {}), clientId: config.clientId, tokenUrl, ...(config.issuer ? { issuer: config.issuer } : {}), ...(revocationUrl ? { revocationUrl } : {}), ...(typeof token.scope === "string" ? { scopes: token.scope.split(/\s+/).filter(Boolean) } : {}) };
@@ -138,7 +149,7 @@ export async function customBrowserApproval(config: { authUrl: string; name: str
     const verifier = randomBytes(32).toString("base64url"), challenge = createHash("sha256").update(verifier).digest("base64url");
     const post = (body: unknown): RequestInit => ({ method: "POST", headers: { "Content-Type": "application/json", Accept: "application/json" }, body: JSON.stringify(body), signal: flow.signal });
     const response = await oauthJsonRequest(url + "/start", post({ code_challenge: challenge, name: config.name, source: config.source }), 15_000);
-    if (response.status !== 200) throw new LoginPollingError("request_failed");
+    if (response.status !== 200) throw new LoginPollingError("request_failed", response.providerError);
     const start = response.data!;
     if (!text(start.session) || !text(start.verification_url, 8192) || start.expires_in !== undefined && !seconds(start.expires_in)) throw new LoginPollingError("invalid_response");
     const verificationUrl = loginEndpoint(start.verification_url).href;
@@ -148,10 +159,11 @@ export async function customBrowserApproval(config: { authUrl: string; name: str
     while (true) {
       await pause(Math.min(intervalMs, Math.max(0, deadline - Date.now())), flow.signal);
       flow.check();
-      if (Date.now() >= deadline) throw new LoginPollingError("expired");
+      const remaining = deadline - Date.now();
+      if (remaining <= 0) throw new LoginPollingError("expired");
       let result: Awaited<ReturnType<typeof oauthJsonRequest>>;
       try {
-        result = await oauthJsonRequest(url + "/status", post({ session: start.session, code_verifier: verifier }), Math.min(15_000, deadline - Date.now()));
+        result = await oauthJsonRequest(url + "/status", post({ session: start.session, code_verifier: verifier }), Math.min(15_000, remaining));
       } catch (error) {
         flow.check();
         if (error instanceof OAuthResponseError && error.code === "timed_out" && Date.now() >= deadline) {
@@ -161,11 +173,12 @@ export async function customBrowserApproval(config: { authUrl: string; name: str
       }
       flow.check();
       if (Date.now() >= deadline) throw new LoginPollingError("expired");
-      if (result.status !== 200) throw new LoginPollingError("request_failed");
+      if (result.status !== 200) throw new LoginPollingError("request_failed", result.providerError);
       const poll = result.data!;
       if (poll.status === "pending") continue;
       if (poll.status === "denied") throw new LoginPollingError("denied");
       if (poll.status === "expired") throw new LoginPollingError("expired");
+      if (poll.status === "consumed") throw new LoginPollingError("consumed");
       if (poll.status !== "complete" || !text(poll.api_key) || poll.key_name !== undefined && !text(poll.key_name, 1024) || poll.org_id !== undefined && !text(poll.org_id, 1024)) throw new LoginPollingError("invalid_response");
       return { api_key: poll.api_key, key_name: typeof poll.key_name === "string" ? poll.key_name : config.name, ...(typeof poll.org_id === "string" ? { org_id: poll.org_id } : {}), revocationUrl: url + "/revoke" };
     }

package/src/resources/api-keys.ts

@@ -1,19 +1,19 @@
-// typeship — apiKeys resource.
-// Generated by typeship — https://typeship.dev
+// Typeship — apiKeys resource.
+// Generated by Typeship — https://typeship.dev
 
 import { HttpCore, type RequestOptions } from "../core/http.js";
 import { paginate, PagePromise } from "../core/pagination.js";
 import {
+  RateLimitError,
   ResponseParseError,
   TransportError,
   UnexpectedApiError,
   ValidationError,
   BadRequestError,
   ForbiddenError,
-  InternalServerError,
   NotFoundError,
   PreconditionFailedError,
-  RateLimitedError,
+  ServerError,
   UnauthorizedError,
 } from "../errors.js";
 import type {
@@ -23,6 +23,8 @@ import type {
   ApiKeyRead,
   ApiKeyResponse,
   ApiKeyResponseRead,
+  ErrorModel,
+  ErrorModelRead,
 } from "../types.js";
 
 export class ApiKeysResource {
@@ -44,13 +46,7 @@ export class ApiKeysResource {
       query: {
         limit: params?.limit,
         cursor: params?.cursor,
-      },
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
+        status: params?.status,
       },
       idempotent: true,
       schemaKey: "apiKeys.list",
@@ -76,13 +72,6 @@ export class ApiKeysResource {
       method: "GET",
       path: `/api-keys/${encodeURIComponent(String(apiKeyId))}`,
       security: [{"apiKey":[]}],
-      errors: {
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
       idempotent: true,
       schemaKey: "apiKeys.get",
       options,
@@ -92,13 +81,14 @@ export class ApiKeysResource {
   /**
    * Revoke an API key
    *
-   * Revokes a key. Repeating the request returns the same result.
+   * Revokes a key immediately. The key stays listed with `status: revoked`. Repeating the request
+   * returns the same result.
    *
    * With OAuth, members can revoke their own keys; organization admins can revoke any key.
    * Organization API keys can revoke any key in their organization.
    * See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag
    * and If-Match.
-   * `DELETE /api-keys/{api_key_id}`
+   * `POST /api-keys/{api_key_id}/revoke`
    */
   async revoke(
     apiKeyId: string,
@@ -106,22 +96,13 @@ export class ApiKeysResource {
     options?: RequestOptions,
   ): Promise<ApiKeyResponseRead> {
     return this._core.requestData<ApiKeyResponseRead, ApiKeysRevokeError>({
-      method: "DELETE",
-      path: `/api-keys/${encodeURIComponent(String(apiKeyId))}`,
+      method: "POST",
+      path: `/api-keys/${encodeURIComponent(String(apiKeyId))}/revoke`,
       security: [{"apiKey":[]}],
       headers: {
         "If-Match": params?.ifMatch === undefined ? undefined : String(params?.ifMatch),
       },
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "412": PreconditionFailedError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
-      idempotent: true,
+      errors: { "412": PreconditionFailedError },
       schemaKey: "apiKeys.revoke",
       options,
     });
@@ -144,15 +125,18 @@ export interface ApiKeysListParams {
    * change between requests.
    */
   cursor?: string;
+  /** Only keys with this status. */
+  status?: "active" | "revoked";
 }
 
 /** Typed errors `list` can throw. */
 export type ApiKeysListError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | RateLimitedError
-  | InternalServerError
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
@@ -160,11 +144,12 @@ export type ApiKeysListError =
 
 /** Typed errors `get` can throw. */
 export type ApiKeysGetError =
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | RateLimitedError
-  | InternalServerError
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
@@ -181,13 +166,14 @@ export interface ApiKeysRevokeParams {
 
 /** Typed errors `revoke` can throw. */
 export type ApiKeysRevokeError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
   | PreconditionFailedError
-  | RateLimitedError
-  | InternalServerError
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError

package/src/resources/deliveries.ts

@@ -1,33 +1,78 @@
-// typeship — deliveries resource.
-// Generated by typeship — https://typeship.dev
+// Typeship — deliveries resource.
+// Generated by Typeship — https://typeship.dev
 
 import { HttpCore, type RequestOptions } from "../core/http.js";
 import { paginate, PagePromise } from "../core/pagination.js";
 import {
+  RateLimitError,
   ResponseParseError,
   TransportError,
   UnexpectedApiError,
   ValidationError,
   BadRequestError,
+  ConflictError,
   ForbiddenError,
-  InternalServerError,
   NotFoundError,
-  RateLimitedError,
+  PreconditionFailedError,
+  ServerError,
   UnauthorizedError,
+  UnprocessableEntityError,
 } from "../errors.js";
 import type {
+  DeletedDelivery,
+  DeletedDeliveryRead,
   Delivery,
+  DeliveryCreateRequest,
   DeliveryId,
   DeliveryList,
   DeliveryListRead,
   DeliveryRead,
   DeliveryResponse,
   DeliveryResponseRead,
+  DeliveryUpdateRequest,
+  ErrorModel,
+  ErrorModelRead,
   TargetId,
 } from "../types.js";
 
 export class DeliveriesResource {
   constructor(private readonly _core: HttpCore) {}
+  /**
+   * Create a Delivery
+   *
+   * Adds a repository or hosted MCP Delivery to a Target. A Target has at most one Delivery of each
+   * type; a `409 delivery_exists` means it already has one, so update that Delivery instead.
+   * With Project auto_generate enabled, adding a Delivery queues the Target's Generation. A queued
+   * or running Target reuses that Generation.
+   *
+   * A `409 delivery_conflict` means another Target owns the requested repository directory. A `409
+   * target_busy` means the Target is publishing; wait for it to finish.
+   * A `502 follow_up_failed` means the Delivery was saved, but retiring an obsolete review or
+   * regenerating the Target failed. Get the Delivery and follow the error's retryable and
+   * suggested_action fields.
+   *
+   * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
+   * `POST /deliveries`
+   */
+  async create(
+    body: DeliveryCreateRequest,
+    params?: DeliveriesCreateParams,
+    options?: RequestOptions,
+  ): Promise<DeliveryResponseRead> {
+    return this._core.requestData<DeliveryResponseRead, DeliveriesCreateError>({
+      method: "POST",
+      path: "/deliveries",
+      security: [{"apiKey":[]}],
+      headers: {
+        "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
+      },
+      body,
+      idempotencyKey: "Idempotency-Key",
+      schemaKey: "deliveries.create",
+      options,
+    });
+  }
+
   /**
    * List Deliveries
    *
@@ -45,15 +90,7 @@ export class DeliveriesResource {
       query: {
         limit: params?.limit,
         cursor: params?.cursor,
-        target_id: params?.targetId,
-      },
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
+        target_id: params?.target_id,
       },
       idempotent: true,
       schemaKey: "deliveries.list",
@@ -80,20 +117,111 @@ export class DeliveriesResource {
       method: "GET",
       path: `/deliveries/${encodeURIComponent(String(deliveryId))}`,
       security: [{"apiKey":[]}],
-      errors: {
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
       idempotent: true,
       schemaKey: "deliveries.get",
       options,
     });
   }
+
+  /**
+   * Update a Delivery
+   *
+   * Replaces a repository Delivery's settings. Omitted optional settings reset to their defaults.
+   * Hosted MCP Deliveries have no settings to update.
+   * With Project auto_generate enabled, changing a Delivery queues the Target's Generation. A
+   * queued or running Target reuses that Generation.
+   * Omitting If-Match applies the update to the current Delivery; with If-Match, a stale ETag
+   * returns 412 precondition_failed without saving.
+   *
+   * A `409 delivery_conflict` means another Target owns the requested repository directory. A `409
+   * target_busy` means the Target is publishing; wait for it to finish.
+   * A `502 follow_up_failed` means the Delivery was saved, but retiring an obsolete review or
+   * regenerating the Target failed. Get the Delivery and follow the error's retryable and
+   * suggested_action fields.
+   * See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag
+   * and If-Match.
+   * `PATCH /deliveries/{delivery_id}`
+   */
+  async update(
+    deliveryId: DeliveryId,
+    body: DeliveryUpdateRequest,
+    params?: DeliveriesUpdateParams,
+    options?: RequestOptions,
+  ): Promise<DeliveryResponseRead> {
+    return this._core.requestData<DeliveryResponseRead, DeliveriesUpdateError>({
+      method: "PATCH",
+      path: `/deliveries/${encodeURIComponent(String(deliveryId))}`,
+      security: [{"apiKey":[]}],
+      headers: {
+        "If-Match": params?.ifMatch === undefined ? undefined : String(params?.ifMatch),
+      },
+      body,
+      errors: { "412": PreconditionFailedError },
+      schemaKey: "deliveries.update",
+      options,
+    });
+  }
+
+  /**
+   * Delete a Delivery
+   *
+   * Removes a Delivery from its Target. Removing a repository Delivery retires the Target's open
+   * Draft pull request; removing a hosted MCP Delivery stops serving its URL. Recreating the type
+   * later allocates a new ID and, for hosted MCP, a new URL.
+   *
+   * A `409 target_busy` means the Target is publishing; wait for it to finish. A `502
+   * follow_up_failed` means the Delivery was removed, but retiring an obsolete review or
+   * regenerating the Target failed.
+   * See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag
+   * and If-Match.
+   * `DELETE /deliveries/{delivery_id}`
+   */
+  async delete(
+    deliveryId: DeliveryId,
+    params?: DeliveriesDeleteParams,
+    options?: RequestOptions,
+  ): Promise<DeletedDeliveryRead> {
+    return this._core.requestData<DeletedDeliveryRead, DeliveriesDeleteError>({
+      method: "DELETE",
+      path: `/deliveries/${encodeURIComponent(String(deliveryId))}`,
+      security: [{"apiKey":[]}],
+      headers: {
+        "If-Match": params?.ifMatch === undefined ? undefined : String(params?.ifMatch),
+      },
+      errors: { "412": PreconditionFailedError },
+      idempotent: true,
+      schemaKey: "deliveries.delete",
+      options,
+    });
+  }
 }
 
+export interface DeliveriesCreateParams {
+  /**
+   * Identifies one logical write for 24 hours. The key is scoped to the authenticated organization
+   * and operation; generation without an organization uses a hashed network identity. Retrying the
+   * same method, path, query, If-Match header, and JSON body replays the original response. Reusing
+   * the key with changed intent returns 409. After expiry the key starts a new write.
+   */
+  idempotencyKey?: string;
+}
+
+/** Typed errors `create` can throw. */
+export type DeliveriesCreateError =
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | ConflictError<ErrorModelRead>
+  | UnprocessableEntityError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;
+
 export interface DeliveriesListParams {
   /**
    * Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits
@@ -111,17 +239,18 @@ export interface DeliveriesListParams {
    */
   cursor?: string;
   /** Only Deliveries of this Target. */
-  targetId?: TargetId;
+  target_id?: TargetId;
 }
 
 /** Typed errors `list` can throw. */
 export type DeliveriesListError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | RateLimitedError
-  | InternalServerError
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
@@ -129,11 +258,63 @@ export type DeliveriesListError =
 
 /** Typed errors `get` can throw. */
 export type DeliveriesGetError =
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | RateLimitedError
-  | InternalServerError
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;
+
+export interface DeliveriesUpdateParams {
+  /**
+   * ETag from a preceding response. The write applies only if the resource still has that version;
+   * otherwise it returns 412 precondition_failed without changes. Omit to write the current
+   * version. See https://typeship.dev/docs/typeship-api#conditional-writes.
+   */
+  ifMatch?: string;
+}
+
+/** Typed errors `update` can throw. */
+export type DeliveriesUpdateError =
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | ConflictError<ErrorModelRead>
+  | PreconditionFailedError
+  | UnprocessableEntityError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;
+
+export interface DeliveriesDeleteParams {
+  /**
+   * ETag from a preceding response. The write applies only if the resource still has that version;
+   * otherwise it returns 412 precondition_failed without changes. Omit to write the current
+   * version. See https://typeship.dev/docs/typeship-api#conditional-writes.
+   */
+  ifMatch?: string;
+}
+
+/** Typed errors `delete` can throw. */
+export type DeliveriesDeleteError =
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | ConflictError<ErrorModelRead>
+  | PreconditionFailedError
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError