@typeship-ax/cli 0.22.0 → 0.24.0

package/src/resources/targets.ts

@@ -1,28 +1,29 @@
-// typeship — targets resource.
-// Generated by typeship — https://typeship.dev
+// Typeship — targets 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,
   PaymentRequiredError,
   PreconditionFailedError,
-  RateLimitedError,
+  ServerError,
   UnauthorizedError,
   UnprocessableEntityError,
 } from "../errors.js";
 import type {
   DeletedTarget,
   DeletedTargetRead,
+  ErrorModel,
+  ErrorModelRead,
   ProjectId,
   ReleaseResponse,
   ReleaseResponseRead,
@@ -41,44 +42,7 @@ import type {
 export class TargetsResource {
   constructor(private readonly _core: HttpCore) {}
   /**
-   * List Targets
-   *
-   * Auto-paginates: `for await (const item of …)` walks every page.
-   * `GET /targets`
-   */
-  list(params?: TargetsListParams, options?: RequestOptions): PagePromise<TargetRead, TargetsListError> {
-    return paginate<TargetRead, TargetsListError>(this._core, {
-      method: "GET",
-      path: "/targets",
-      security: [{"apiKey":[]}],
-      query: {
-        limit: params?.limit,
-        cursor: params?.cursor,
-        project_id: params?.projectId,
-      },
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
-      idempotent: true,
-      schemaKey: "targets.list",
-      options,
-    }, {
-      style: "cursor",
-      itemsField: "data",
-      cursorParam: "cursor",
-      nextCursorField: "next_cursor",
-      hasMoreField: "has_more",
-      limitParam: "limit",
-    });
-  }
-
-  /**
-   * Create an independently configured Target
+   * Create a Target
    *
    * Creates a Target with its own configuration, Deliveries, and release history. Multiple Targets
    * can use the same generator.
@@ -99,17 +63,7 @@ export class TargetsResource {
         "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
       },
       body,
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "402": PaymentRequiredError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "409": ConflictError,
-        "422": UnprocessableEntityError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
+      errors: { "402": PaymentRequiredError },
       idempotencyKey: "Idempotency-Key",
       schemaKey: "targets.create",
       options,
@@ -117,73 +71,56 @@ export class TargetsResource {
   }
 
   /**
-   * Get a Target
-   * `GET /targets/{target_id}`
+   * List Targets
+   *
+   * Auto-paginates: `for await (const item of …)` walks every page.
+   * `GET /targets`
    */
-  async get(targetId: TargetId, options?: RequestOptions): Promise<TargetResponseRead> {
-    return this._core.requestData<TargetResponseRead, TargetsGetError>({
+  list(params?: TargetsListParams, options?: RequestOptions): PagePromise<TargetRead, TargetsListError> {
+    return paginate<TargetRead, TargetsListError>(this._core, {
       method: "GET",
-      path: `/targets/${encodeURIComponent(String(targetId))}`,
+      path: "/targets",
       security: [{"apiKey":[]}],
-      errors: {
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
+      query: {
+        limit: params?.limit,
+        cursor: params?.cursor,
+        project_id: params?.project_id,
       },
       idempotent: true,
-      schemaKey: "targets.get",
+      schemaKey: "targets.list",
       options,
+    }, {
+      style: "cursor",
+      itemsField: "data",
+      cursorParam: "cursor",
+      nextCursorField: "next_cursor",
+      hasMoreField: "has_more",
+      limitParam: "limit",
     });
   }
 
   /**
-   * Delete an unused Target
-   *
-   * Deletes a Target with no Generation history, release history, or active Draft. A `409
-   * resource_has_dependencies` means one of those resources still depends on it. Retrieve the
-   * Target, disable it instead, or resolve the dependency before retrying.
-   *
-   * See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag
-   * and If-Match.
-   * `DELETE /targets/{target_id}`
+   * Get a Target
+   * `GET /targets/{target_id}`
    */
-  async delete(
-    targetId: TargetId,
-    params?: TargetsDeleteParams,
-    options?: RequestOptions,
-  ): Promise<DeletedTargetRead> {
-    return this._core.requestData<DeletedTargetRead, TargetsDeleteError>({
-      method: "DELETE",
+  async get(targetId: TargetId, options?: RequestOptions): Promise<TargetResponseRead> {
+    return this._core.requestData<TargetResponseRead, TargetsGetError>({
+      method: "GET",
       path: `/targets/${encodeURIComponent(String(targetId))}`,
       security: [{"apiKey":[]}],
-      headers: {
-        "If-Match": params?.ifMatch === undefined ? undefined : String(params?.ifMatch),
-      },
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "409": ConflictError,
-        "412": PreconditionFailedError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
       idempotent: true,
-      schemaKey: "targets.delete",
+      schemaKey: "targets.get",
       options,
     });
   }
 
   /**
-   * Update a Target or its Deliveries
+   * Update a Target
    *
-   * Omitted fields keep their current values. Supplied config, checks, and deliveries replace their
-   * complete stored values.
-   * With Project auto_generate enabled, changing Target config, checks, or Deliveries queues that
-   * Target's Generation. A queued or running Target reuses that Generation.
+   * Omitted fields keep their current values. Supplied config and checks replace their complete
+   * stored values. Change Deliveries with createDelivery, updateDelivery, and deleteDelivery.
+   * With Project auto_generate enabled, changing Target config or checks queues that Target's
+   * Generation. A queued or running Target reuses that Generation.
    * Omitting If-Match applies the update to the current resource; with If-Match, a stale ETag
    * returns 412 precondition_failed without saving.
    * Select the next version through PATCH /drafts/{draft_id} on the Target's draft_id.
@@ -212,26 +149,44 @@ export class TargetsResource {
         "If-Match": params?.ifMatch === undefined ? undefined : String(params?.ifMatch),
       },
       body,
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "402": PaymentRequiredError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "409": ConflictError,
-        "412": PreconditionFailedError,
-        "422": UnprocessableEntityError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-        "502": BadGatewayError,
-      },
+      errors: { "402": PaymentRequiredError, "412": PreconditionFailedError },
       schemaKey: "targets.update",
       options,
     });
   }
 
   /**
-   * Adopt a verified existing package as the latest release
+   * Delete a Target
+   *
+   * Deletes a Target with no Generation history, release history, or active Draft. A `409
+   * resource_has_dependencies` means one of those resources still depends on it. Retrieve the
+   * Target, disable it instead, or resolve the dependency before retrying.
+   *
+   * See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag
+   * and If-Match.
+   * `DELETE /targets/{target_id}`
+   */
+  async delete(
+    targetId: TargetId,
+    params?: TargetsDeleteParams,
+    options?: RequestOptions,
+  ): Promise<DeletedTargetRead> {
+    return this._core.requestData<DeletedTargetRead, TargetsDeleteError>({
+      method: "DELETE",
+      path: `/targets/${encodeURIComponent(String(targetId))}`,
+      security: [{"apiKey":[]}],
+      headers: {
+        "If-Match": params?.ifMatch === undefined ? undefined : String(params?.ifMatch),
+      },
+      errors: { "412": PreconditionFailedError },
+      idempotent: true,
+      schemaKey: "targets.delete",
+      options,
+    });
+  }
+
+  /**
+   * Adopt a package release
    *
    * Checks the repository tag, package metadata, and registry artifact, then records the package as
    * an Imported latest release. Opens the first Typeship Draft at the next major version; review it
@@ -254,16 +209,6 @@ export class TargetsResource {
         "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
       },
       body,
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "409": ConflictError,
-        "422": UnprocessableEntityError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
       idempotencyKey: "Idempotency-Key",
       schemaKey: "targets.adopt",
       options,
@@ -271,6 +216,33 @@ export class TargetsResource {
   }
 }
 
+export interface TargetsCreateParams {
+  /**
+   * 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 TargetsCreateError =
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | PaymentRequiredError
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | ConflictError<ErrorModelRead>
+  | UnprocessableEntityError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;
+
 export interface TargetsListParams {
   /**
    * Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits
@@ -288,43 +260,18 @@ export interface TargetsListParams {
    */
   cursor?: string;
   /** Only Targets in this Project. */
-  projectId?: ProjectId;
+  project_id?: ProjectId;
 }
 
 /** Typed errors `list` can throw. */
 export type TargetsListError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | RateLimitedError
-  | InternalServerError
-  | UnexpectedApiError
-  | ResponseParseError
-  | TransportError
-  | ValidationError;
-
-export interface TargetsCreateParams {
-  /**
-   * 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 TargetsCreateError =
-  | BadRequestError
-  | UnauthorizedError
-  | PaymentRequiredError
-  | ForbiddenError
-  | NotFoundError
-  | ConflictError
-  | UnprocessableEntityError
-  | RateLimitedError
-  | InternalServerError
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
@@ -332,17 +279,18 @@ export type TargetsCreateError =
 
 /** Typed errors `get` can throw. */
 export type TargetsGetError =
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | RateLimitedError
-  | InternalServerError
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
   | ValidationError;
 
-export interface TargetsDeleteParams {
+export interface TargetsUpdateParams {
   /**
    * 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
@@ -351,22 +299,25 @@ export interface TargetsDeleteParams {
   ifMatch?: string;
 }
 
-/** Typed errors `delete` can throw. */
-export type TargetsDeleteError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | ConflictError
+/** Typed errors `update` can throw. */
+export type TargetsUpdateError =
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | PaymentRequiredError
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | ConflictError<ErrorModelRead>
   | PreconditionFailedError
-  | RateLimitedError
-  | InternalServerError
+  | UnprocessableEntityError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
   | ValidationError;
 
-export interface TargetsUpdateParams {
+export interface TargetsDeleteParams {
   /**
    * 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
@@ -375,19 +326,17 @@ export interface TargetsUpdateParams {
   ifMatch?: string;
 }
 
-/** Typed errors `update` can throw. */
-export type TargetsUpdateError =
-  | BadRequestError
-  | UnauthorizedError
-  | PaymentRequiredError
-  | ForbiddenError
-  | NotFoundError
-  | ConflictError
+/** Typed errors `delete` can throw. */
+export type TargetsDeleteError =
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | ConflictError<ErrorModelRead>
   | PreconditionFailedError
-  | UnprocessableEntityError
-  | RateLimitedError
-  | InternalServerError
-  | BadGatewayError
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
@@ -405,14 +354,15 @@ export interface TargetsAdoptParams {
 
 /** Typed errors `adopt` can throw. */
 export type TargetsAdoptError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | ConflictError
-  | UnprocessableEntityError
-  | RateLimitedError
-  | InternalServerError
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | ConflictError<ErrorModelRead>
+  | UnprocessableEntityError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError