@typeship-ax/cli 0.22.0 → 0.23.1

package/src/resources/releases.ts

@@ -1,23 +1,24 @@
-// typeship — releases resource.
-// Generated by typeship — https://typeship.dev
+// Typeship — releases 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,
-  BadGatewayError,
   BadRequestError,
   ConflictError,
   ForbiddenError,
-  InternalServerError,
   NotFoundError,
-  RateLimitedError,
+  ServerError,
   UnauthorizedError,
 } from "../errors.js";
 import type {
+  ErrorModel,
+  ErrorModelRead,
   Release,
   ReleaseId,
   ReleaseList,
@@ -31,7 +32,7 @@ import type {
 export class ReleasesResource {
   constructor(private readonly _core: HttpCore) {}
   /**
-   * List releases
+   * List Releases
    *
    * Auto-paginates: `for await (const item of …)` walks every page.
    * `GET /releases`
@@ -46,14 +47,6 @@ export class ReleasesResource {
         cursor: params?.cursor,
         target_id: params?.targetId,
       },
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
       idempotent: true,
       schemaKey: "releases.list",
       options,
@@ -68,7 +61,7 @@ export class ReleasesResource {
   }
 
   /**
-   * Get an immutable release
+   * Get a Release
    * `GET /releases/{release_id}`
    */
   async get(releaseId: ReleaseId, options?: RequestOptions): Promise<ReleaseResponseRead> {
@@ -76,13 +69,6 @@ export class ReleasesResource {
       method: "GET",
       path: `/releases/${encodeURIComponent(String(releaseId))}`,
       security: [{"apiKey":[]}],
-      errors: {
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
       idempotent: true,
       schemaKey: "releases.get",
       options,
@@ -90,41 +76,36 @@ export class ReleasesResource {
   }
 
   /**
-   * Retry publishing an exact release
+   * Retry publishing a Release
    *
-   * Retries publishing the specified release through its repository workflow. Uses that release's
-   * version and accepted commit, even if a newer Draft or release exists.
+   * Queues every failed or queued Publication of the release and starts its repository publishing
+   * workflow again. Publishing uses that release's version and accepted commit, even if a newer
+   * Draft or release exists. Completed Publications are not repeated.
    *
-   * A `502 repository_unavailable` means the repository publishing workflow could not be
-   * dispatched, and nothing was changed.
+   * Returns `202` with the Release. Get the Release until each Publication reaches `completed` or
+   * `failed`.
+   *
+   * A `409 publication_not_retryable` means no Publication is queued or failed. A `502
+   * repository_unavailable` means the repository publishing workflow could not be dispatched, and
+   * nothing was changed.
    *
    * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
-   * `POST /releases/{release_id}/republish`
+   * `POST /releases/{release_id}/retry`
    */
-  async republish(
+  async retry(
     releaseId: ReleaseId,
-    params?: ReleasesRepublishParams,
+    params?: ReleasesRetryParams,
     options?: RequestOptions,
   ): Promise<ReleaseResponseRead> {
-    return this._core.requestData<ReleaseResponseRead, ReleasesRepublishError>({
+    return this._core.requestData<ReleaseResponseRead, ReleasesRetryError>({
       method: "POST",
-      path: `/releases/${encodeURIComponent(String(releaseId))}/republish`,
+      path: `/releases/${encodeURIComponent(String(releaseId))}/retry`,
       security: [{"apiKey":[]}],
       headers: {
         "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
       },
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "409": ConflictError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-        "502": BadGatewayError,
-      },
       idempotencyKey: "Idempotency-Key",
-      schemaKey: "releases.republish",
+      schemaKey: "releases.retry",
       options,
     });
   }
@@ -152,12 +133,13 @@ export interface ReleasesListParams {
 
 /** Typed errors `list` can throw. */
 export type ReleasesListError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | RateLimitedError
-  | InternalServerError
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
@@ -165,17 +147,18 @@ export type ReleasesListError =
 
 /** Typed errors `get` can throw. */
 export type ReleasesGetError =
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | RateLimitedError
-  | InternalServerError
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
   | ValidationError;
 
-export interface ReleasesRepublishParams {
+export interface ReleasesRetryParams {
   /**
    * 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
@@ -185,16 +168,16 @@ export interface ReleasesRepublishParams {
   idempotencyKey?: string;
 }
 
-/** Typed errors `republish` can throw. */
-export type ReleasesRepublishError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | ConflictError
-  | RateLimitedError
-  | InternalServerError
-  | BadGatewayError
+/** Typed errors `retry` can throw. */
+export type ReleasesRetryError =
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | ConflictError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError

package/src/resources/spec-revisions.ts

@@ -1,21 +1,23 @@
-// typeship — specRevisions resource.
-// Generated by typeship — https://typeship.dev
+// Typeship — specRevisions 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,
-  RateLimitedError,
+  ServerError,
   UnauthorizedError,
 } from "../errors.js";
 import type {
+  ErrorModel,
+  ErrorModelRead,
   SpecId,
   SpecRevision,
   SpecRevisionFile,
@@ -54,14 +56,6 @@ export class SpecRevisionsResource {
         cursor: params?.cursor,
         spec_id: params?.specId,
       },
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
       idempotent: true,
       schemaKey: "specRevisions.list",
       options,
@@ -80,7 +74,9 @@ export class SpecRevisionsResource {
    *
    * Returns metadata for a saved Spec Revision with a Diagnostics summary. Pass
    * `include=diagnostics` to add every Diagnostic, evaluated with the Spec's current patches and
-   * Diagnostic policy. List its source files and resolved document with listSpecRevisionFiles.
+   * Diagnostic policy. Add `filter=blocking` to receive only the locations that fail the policy,
+   * which is what to fix when `diagnostic_summary.status` is blocked. List its source files and
+   * resolved document with listSpecRevisionFiles.
    * `GET /spec-revisions/{spec_revision_id}`
    */
   async get(
@@ -94,14 +90,7 @@ export class SpecRevisionsResource {
       security: [{"apiKey":[]}],
       query: {
         include: params?.include,
-      },
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
+        filter: params?.filter,
       },
       idempotent: true,
       schemaKey: "specRevisions.get",
@@ -131,14 +120,6 @@ export class SpecRevisionsResource {
         limit: params?.limit,
         cursor: params?.cursor,
       },
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
       idempotent: true,
       schemaKey: "specRevisions.listFiles",
       options,
@@ -175,12 +156,13 @@ export interface SpecRevisionsListParams {
 
 /** Typed errors `list` can throw. */
 export type SpecRevisionsListError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | RateLimitedError
-  | InternalServerError
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
@@ -192,16 +174,24 @@ export interface SpecRevisionsGetParams {
    * arrays.
    */
   include?: "diagnostics";
+  /**
+   * Narrow the included Diagnostics to matching locations. Requires include=diagnostics. blocking:
+   * locations that fail the Diagnostic policy. introduced: locations new since the baseline. A
+   * Diagnostic with no matching location is omitted. diagnostic_summary always describes the
+   * complete revision.
+   */
+  filter?: "blocking" | "introduced";
 }
 
 /** Typed errors `get` can throw. */
 export type SpecRevisionsGetError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | RateLimitedError
-  | InternalServerError
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
@@ -227,12 +217,13 @@ export interface SpecRevisionsListFilesParams {
 
 /** Typed errors `listFiles` can throw. */
 export type SpecRevisionsListFilesError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | RateLimitedError
-  | InternalServerError
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError

package/src/resources/specs.ts

@@ -1,24 +1,30 @@
-// typeship — specs resource.
-// Generated by typeship — https://typeship.dev
+// Typeship — specs resource.
+// Generated by Typeship — https://typeship.dev
 
 import { HttpCore, type RequestOptions } from "../core/http.js";
 import {
+  RateLimitError,
   ResponseParseError,
   TransportError,
   UnexpectedApiError,
   ValidationError,
-  BadGatewayError,
   BadRequestError,
   ConflictError,
   ForbiddenError,
-  InternalServerError,
   NotFoundError,
   PreconditionFailedError,
-  RateLimitedError,
+  ServerError,
   UnauthorizedError,
   UnprocessableEntityError,
 } from "../errors.js";
-import type { Spec, SpecId, SpecRead, SpecUpdateRequest } from "../types.js";
+import type {
+  ErrorModel,
+  ErrorModelRead,
+  Spec,
+  SpecId,
+  SpecRead,
+  SpecUpdateRequest,
+} from "../types.js";
 
 export class SpecsResource {
   constructor(private readonly _core: HttpCore) {}
@@ -31,13 +37,6 @@ export class SpecsResource {
       method: "GET",
       path: `/specs/${encodeURIComponent(String(specId))}`,
       security: [{"apiKey":[]}],
-      errors: {
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
       idempotent: true,
       schemaKey: "specs.get",
       options,
@@ -45,7 +44,7 @@ export class SpecsResource {
   }
 
   /**
-   * Update and resolve a Spec
+   * Update a Spec
    *
    * Resolves the source files before saving the update and records a new Spec Revision when the
    * source changes.
@@ -76,17 +75,7 @@ export class SpecsResource {
         "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
       },
       body,
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "409": ConflictError,
-        "412": PreconditionFailedError,
-        "422": UnprocessableEntityError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
+      errors: { "412": PreconditionFailedError },
       idempotencyKey: "Idempotency-Key",
       schemaKey: "specs.update",
       options,
@@ -94,7 +83,7 @@ export class SpecsResource {
   }
 
   /**
-   * Refresh a Spec from its configured source
+   * Refresh a Spec
    *
    * Fetches the configured source now and creates a new Spec Revision only when its content
    * changes. Diagnostics then reads that revision. If automatic generation is enabled, refresh
@@ -112,17 +101,6 @@ export class SpecsResource {
       headers: {
         "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
       },
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "409": ConflictError,
-        "422": UnprocessableEntityError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-        "502": BadGatewayError,
-      },
       idempotencyKey: "Idempotency-Key",
       schemaKey: "specs.refresh",
       options,
@@ -132,11 +110,12 @@ export class SpecsResource {
 
 /** Typed errors `get` can throw. */
 export type SpecsGetError =
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | RateLimitedError
-  | InternalServerError
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
@@ -160,15 +139,16 @@ export interface SpecsUpdateParams {
 
 /** Typed errors `update` can throw. */
 export type SpecsUpdateError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | ConflictError
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | ConflictError<ErrorModelRead>
   | PreconditionFailedError
-  | UnprocessableEntityError
-  | RateLimitedError
-  | InternalServerError
+  | UnprocessableEntityError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
@@ -186,15 +166,15 @@ export interface SpecsRefreshParams {
 
 /** Typed errors `refresh` can throw. */
 export type SpecsRefreshError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | ConflictError
-  | UnprocessableEntityError
-  | RateLimitedError
-  | InternalServerError
-  | BadGatewayError
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | ConflictError<ErrorModelRead>
+  | UnprocessableEntityError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError