@typeship-ax/mcp 0.21.0 → 0.23.0

package/src/resources/{generate.ts → packages.ts}

@@ -1,8 +1,9 @@
-// typeship — generate resource.
-// Generated by typeship — https://typeship.dev
+// Typeship — packages resource.
+// Generated by Typeship — https://typeship.dev
 
 import { HttpCore, type RequestOptions } from "../core/http.js";
 import {
+  RateLimitError,
   ResponseParseError,
   TransportError,
   UnexpectedApiError,
@@ -11,19 +12,24 @@ import {
   BadRequestError,
   ConflictError,
   ForbiddenError,
-  InternalServerError,
   NotFoundError,
   PayloadTooLargeError,
-  RateLimitedError,
+  ServerError,
   UnauthorizedError,
   UnprocessableEntityError,
 } from "../errors.js";
-import type { GenerateRequest, GenerationResult, GenerationResultRead } from "../types.js";
+import type {
+  ErrorModel,
+  ErrorModelRead,
+  GenerateRequest,
+  GenerationResult,
+  GenerationResultRead,
+} from "../types.js";
 
-export class GenerateResource {
+export class PackagesResource {
   constructor(private readonly _core: HttpCore) {}
   /**
-   * Generate one package from a Spec
+   * Generate a package
    *
    * Returns one generated package without creating a Project.
    *
@@ -47,12 +53,12 @@ export class GenerateResource {
    * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
    * `POST /generate`
    */
-  async run(
+  async generate(
     body: GenerateRequest,
-    params?: GenerateRunParams,
+    params?: PackagesGenerateParams,
     options?: RequestOptions,
   ): Promise<GenerationResultRead> {
-    return this._core.requestData<GenerationResultRead, GenerateRunError>({
+    return this._core.requestData<GenerationResultRead, PackagesGenerateError>({
       method: "POST",
       path: "/generate",
       security: [{},{"apiKey":[]}],
@@ -60,19 +66,9 @@ export class GenerateResource {
         "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
       },
       body,
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "409": ConflictError,
-        "413": PayloadTooLargeError,
-        "422": UnprocessableEntityError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-        default: ApiResponseError,
-      },
+      errors: { "413": PayloadTooLargeError, default: ApiResponseError },
       idempotencyKey: "Idempotency-Key",
-      schemaKey: "generate.run",
+      schemaKey: "packages.generate",
       options,
     });
   }
@@ -80,9 +76,9 @@ export class GenerateResource {
   /**
    * Download a generated package
    *
-   * Download the complete ZIP referenced by `generate_run`'s `download.url`. Pass the token from
-   * that URL. No API key is needed; the token grants access only to that exact package until its
-   * replay window expires. Keep the token private.
+   * Download the complete ZIP referenced by `packages_generate`'s `download.url`. Pass the token
+   * from that URL. No API key is needed; the token grants access only to that exact package until
+   * its replay window expires. Keep the token private.
    *
    * The local MCP server saves this binary response to disk. On a hosted MCP connection, download
    * the original URL directly to your workspace. Verify the ZIP against `download.sha256` before
@@ -90,28 +86,22 @@ export class GenerateResource {
    * creates a new download.
    * `GET /generate/download`
    */
-  async downloadPackage(params: GenerateDownloadPackageParams, options?: RequestOptions): Promise<Blob> {
-    return this._core.requestData<Blob, GenerateDownloadPackageError>({
+  async download(params: PackagesDownloadParams, options?: RequestOptions): Promise<Blob> {
+    return this._core.requestData<Blob, PackagesDownloadError>({
       method: "GET",
       path: "/generate/download",
       security: [{}],
       query: {
         token: params.token,
       },
-      errors: {
-        "400": BadRequestError,
-        "404": NotFoundError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
       idempotent: true,
-      schemaKey: "generate.downloadPackage",
+      schemaKey: "packages.download",
       options,
     });
   }
 }
 
-export interface GenerateRunParams {
+export interface PackagesGenerateParams {
   /**
    * 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
@@ -121,33 +111,35 @@ export interface GenerateRunParams {
   idempotencyKey?: string;
 }
 
-/** Typed errors `run` can throw. */
-export type GenerateRunError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | ConflictError
+/** Typed errors `generate` can throw. */
+export type PackagesGenerateError =
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | ConflictError<ErrorModelRead>
   | PayloadTooLargeError
-  | UnprocessableEntityError
-  | RateLimitedError
-  | InternalServerError
+  | UnprocessableEntityError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
   | ApiResponseError
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
   | ValidationError;
 
-export interface GenerateDownloadPackageParams {
+export interface PackagesDownloadParams {
   /** Private download token from download.url in the generation result. */
   token: string;
 }
 
-/** Typed errors `downloadPackage` can throw. */
-export type GenerateDownloadPackageError =
-  | BadRequestError
-  | NotFoundError
-  | RateLimitedError
-  | InternalServerError
+/** Typed errors `download` can throw. */
+export type PackagesDownloadError =
+  | BadRequestError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError

package/src/resources/projects.ts

@@ -1,23 +1,22 @@
-// typeship — projects resource.
-// Generated by typeship — https://typeship.dev
+// Typeship — projects 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,
   PayloadTooLargeError,
   PaymentRequiredError,
   PreconditionFailedError,
-  RateLimitedError,
+  ServerError,
   UnauthorizedError,
   UnprocessableEntityError,
 } from "../errors.js";
@@ -25,6 +24,8 @@ import type {
   CreateProjectRequest,
   DeletedProject,
   DeletedProjectRead,
+  ErrorModel,
+  ErrorModelRead,
   GenerateProjectRequest,
   GenerationBatch,
   GenerationBatchRead,
@@ -33,53 +34,15 @@ import type {
   ProjectList,
   ProjectListRead,
   ProjectRead,
-  ProjectSummary,
-  ProjectSummaryRead,
+  ProjectResponse,
+  ProjectResponseRead,
   UpdateProjectRequest,
 } from "../types.js";
 
 export class ProjectsResource {
   constructor(private readonly _core: HttpCore) {}
   /**
-   * List projects
-   *
-   * Auto-paginates: `for await (const item of …)` walks every page.
-   * `GET /projects`
-   */
-  list(
-    params?: ProjectsListParams,
-    options?: RequestOptions,
-  ): PagePromise<ProjectSummaryRead, ProjectsListError> {
-    return paginate<ProjectSummaryRead, ProjectsListError>(this._core, {
-      method: "GET",
-      path: "/projects",
-      security: [{"apiKey":[]}],
-      query: {
-        limit: params?.limit,
-        cursor: params?.cursor,
-      },
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
-      idempotent: true,
-      schemaKey: "projects.list",
-      options,
-    }, {
-      style: "cursor",
-      itemsField: "data",
-      cursorParam: "cursor",
-      nextCursorField: "next_cursor",
-      hasMoreField: "has_more",
-      limitParam: "limit",
-    });
-  }
-
-  /**
-   * Create a project
+   * Create a Project
    *
    * Creates a Project from a URL or GitHub Spec.
    * Automatic generation is enabled by default for a saved Project.
@@ -95,8 +58,8 @@ export class ProjectsResource {
     body: CreateProjectRequest,
     params?: ProjectsCreateParams,
     options?: RequestOptions,
-  ): Promise<ProjectRead> {
-    return this._core.requestData<ProjectRead, ProjectsCreateError>({
+  ): Promise<ProjectResponseRead> {
+    return this._core.requestData<ProjectResponseRead, ProjectsCreateError>({
       method: "POST",
       path: "/projects",
       security: [{"apiKey":[]}],
@@ -104,16 +67,7 @@ export class ProjectsResource {
         "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
       },
       body,
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "402": PaymentRequiredError,
-        "403": ForbiddenError,
-        "409": ConflictError,
-        "422": UnprocessableEntityError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-      },
+      errors: { "402": PaymentRequiredError },
       idempotencyKey: "Idempotency-Key",
       schemaKey: "projects.create",
       options,
@@ -121,70 +75,53 @@ export class ProjectsResource {
   }
 
   /**
-   * Get a project
+   * List Projects
    *
-   * Returns the Project's settings and Spec ID. List its Targets separately to retrieve Target
-   * configuration and Deliveries.
-   * `GET /projects/{project_id}`
+   * Auto-paginates: `for await (const item of …)` walks every page.
+   * `GET /projects`
    */
-  async get(projectId: ProjectId, options?: RequestOptions): Promise<ProjectRead> {
-    return this._core.requestData<ProjectRead, ProjectsGetError>({
+  list(params?: ProjectsListParams, options?: RequestOptions): PagePromise<ProjectRead, ProjectsListError> {
+    return paginate<ProjectRead, ProjectsListError>(this._core, {
       method: "GET",
-      path: `/projects/${encodeURIComponent(String(projectId))}`,
+      path: "/projects",
       security: [{"apiKey":[]}],
-      errors: {
-        "401": UnauthorizedError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
+      query: {
+        limit: params?.limit,
+        cursor: params?.cursor,
       },
       idempotent: true,
-      schemaKey: "projects.get",
+      schemaKey: "projects.list",
       options,
+    }, {
+      style: "cursor",
+      itemsField: "data",
+      cursorParam: "cursor",
+      nextCursorField: "next_cursor",
+      hasMoreField: "has_more",
+      limitParam: "limit",
     });
   }
 
   /**
-   * Delete a project
+   * Get a Project
    *
-   * A `502 repository_unavailable` means the Project was not deleted because its release pull
-   * requests could not be retired. Retry deletion to finish retiring the remaining reviews.
-   * Repeating a completed deletion returns `404`.
-   * See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag
-   * and If-Match.
-   * `DELETE /projects/{project_id}`
+   * Returns the Project's settings and Spec ID. List its Targets separately to retrieve Target
+   * configuration and Deliveries.
+   * `GET /projects/{project_id}`
    */
-  async delete(
-    projectId: ProjectId,
-    params?: ProjectsDeleteParams,
-    options?: RequestOptions,
-  ): Promise<DeletedProjectRead> {
-    return this._core.requestData<DeletedProjectRead, ProjectsDeleteError>({
-      method: "DELETE",
+  async get(projectId: ProjectId, options?: RequestOptions): Promise<ProjectResponseRead> {
+    return this._core.requestData<ProjectResponseRead, ProjectsGetError>({
+      method: "GET",
       path: `/projects/${encodeURIComponent(String(projectId))}`,
       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,
-        "502": BadGatewayError,
-      },
       idempotent: true,
-      schemaKey: "projects.delete",
+      schemaKey: "projects.get",
       options,
     });
   }
 
   /**
-   * Update a project
+   * Update a Project
    *
    * Omitted fields keep their current values. A supplied config replaces the entire stored object;
    * null or an empty object clears it.
@@ -195,9 +132,9 @@ export class ProjectsResource {
    *
    * A `409 target_busy` means a Target is publishing. Retrieve the Project, wait for publishing to
    * finish, reconcile your update, and retry.
-   * A `502 follow_up_failed` means the Project was saved, but an obsolete release pull request
-   * could not be retired. Retrieve the Project and retry the same update to finish retiring reviews
-   * if that update is still desired.
+   * A `502 follow_up_failed` means the Project was saved, but an obsolete Draft pull request could
+   * not be retired. Retrieve the Project and retry the same update to finish retiring reviews if
+   * that update is still desired.
    * See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag
    * and If-Match.
    * `PATCH /projects/{project_id}`
@@ -207,8 +144,8 @@ export class ProjectsResource {
     body: UpdateProjectRequest,
     params?: ProjectsUpdateParams,
     options?: RequestOptions,
-  ): Promise<ProjectRead> {
-    return this._core.requestData<ProjectRead, ProjectsUpdateError>({
+  ): Promise<ProjectResponseRead> {
+    return this._core.requestData<ProjectResponseRead, ProjectsUpdateError>({
       method: "PATCH",
       path: `/projects/${encodeURIComponent(String(projectId))}`,
       security: [{"apiKey":[]}],
@@ -216,26 +153,43 @@ export class ProjectsResource {
         "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: "projects.update",
       options,
     });
   }
 
   /**
-   * Start generation for active Targets
+   * Delete a Project
+   *
+   * A `502 repository_unavailable` means the Project was not deleted because its Draft pull
+   * requests could not be retired. Retry deletion to finish retiring the remaining reviews.
+   * Repeating a completed deletion returns `404`.
+   * See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag
+   * and If-Match.
+   * `DELETE /projects/{project_id}`
+   */
+  async delete(
+    projectId: ProjectId,
+    params?: ProjectsDeleteParams,
+    options?: RequestOptions,
+  ): Promise<DeletedProjectRead> {
+    return this._core.requestData<DeletedProjectRead, ProjectsDeleteError>({
+      method: "DELETE",
+      path: `/projects/${encodeURIComponent(String(projectId))}`,
+      security: [{"apiKey":[]}],
+      headers: {
+        "If-Match": params?.ifMatch === undefined ? undefined : String(params?.ifMatch),
+      },
+      errors: { "412": PreconditionFailedError },
+      idempotent: true,
+      schemaKey: "projects.delete",
+      options,
+    });
+  }
+
+  /**
+   * Generate a Project's Targets
    *
    * Queues one Generation per active Target and returns their IDs. Retrieve each Generation until
    * its status moves from `queued` to `running` and then `completed` or `failed`. `completed` means
@@ -265,19 +219,7 @@ export class ProjectsResource {
         "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
       },
       body,
-      errors: {
-        "400": BadRequestError,
-        "401": UnauthorizedError,
-        "402": PaymentRequiredError,
-        "403": ForbiddenError,
-        "404": NotFoundError,
-        "409": ConflictError,
-        "413": PayloadTooLargeError,
-        "422": UnprocessableEntityError,
-        "429": RateLimitedError,
-        "500": InternalServerError,
-        "502": BadGatewayError,
-      },
+      errors: { "402": PaymentRequiredError, "413": PayloadTooLargeError },
       idempotencyKey: "Idempotency-Key",
       schemaKey: "projects.generate",
       options,
@@ -285,6 +227,32 @@ export class ProjectsResource {
   }
 }
 
+export interface ProjectsCreateParams {
+  /**
+   * 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 ProjectsCreateError =
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | PaymentRequiredError
+  | ForbiddenError<ErrorModelRead>
+  | ConflictError<ErrorModelRead>
+  | UnprocessableEntityError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;
+
 export interface ProjectsListParams {
   /**
    * Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits
@@ -305,36 +273,12 @@ export interface ProjectsListParams {
 
 /** Typed errors `list` can throw. */
 export type ProjectsListError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | RateLimitedError
-  | InternalServerError
-  | UnexpectedApiError
-  | ResponseParseError
-  | TransportError
-  | ValidationError;
-
-export interface ProjectsCreateParams {
-  /**
-   * 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 ProjectsCreateError =
-  | BadRequestError
-  | UnauthorizedError
-  | PaymentRequiredError
-  | ForbiddenError
-  | ConflictError
-  | UnprocessableEntityError
-  | RateLimitedError
-  | InternalServerError
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
@@ -342,17 +286,18 @@ export type ProjectsCreateError =
 
 /** Typed errors `get` can throw. */
 export type ProjectsGetError =
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
-  | RateLimitedError
-  | InternalServerError
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
   | ValidationError;
 
-export interface ProjectsDeleteParams {
+export interface ProjectsUpdateParams {
   /**
    * 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
@@ -361,22 +306,25 @@ export interface ProjectsDeleteParams {
   ifMatch?: string;
 }
 
-/** Typed errors `delete` can throw. */
-export type ProjectsDeleteError =
-  | BadRequestError
-  | UnauthorizedError
-  | ForbiddenError
-  | NotFoundError
+/** Typed errors `update` can throw. */
+export type ProjectsUpdateError =
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | PaymentRequiredError
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | ConflictError<ErrorModelRead>
   | PreconditionFailedError
-  | RateLimitedError
-  | InternalServerError
-  | BadGatewayError
+  | UnprocessableEntityError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
   | ValidationError;
 
-export interface ProjectsUpdateParams {
+export interface ProjectsDeleteParams {
   /**
    * 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
@@ -385,19 +333,16 @@ export interface ProjectsUpdateParams {
   ifMatch?: string;
 }
 
-/** Typed errors `update` can throw. */
-export type ProjectsUpdateError =
-  | BadRequestError
-  | UnauthorizedError
-  | PaymentRequiredError
-  | ForbiddenError
-  | NotFoundError
-  | ConflictError
+/** Typed errors `delete` can throw. */
+export type ProjectsDeleteError =
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
   | PreconditionFailedError
-  | UnprocessableEntityError
-  | RateLimitedError
-  | InternalServerError
-  | BadGatewayError
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
@@ -415,17 +360,17 @@ export interface ProjectsGenerateParams {
 
 /** Typed errors `generate` can throw. */
 export type ProjectsGenerateError =
-  | BadRequestError
-  | UnauthorizedError
+  | BadRequestError<ErrorModelRead>
+  | UnauthorizedError<ErrorModelRead>
   | PaymentRequiredError
-  | ForbiddenError
-  | NotFoundError
-  | ConflictError
+  | ForbiddenError<ErrorModelRead>
+  | NotFoundError<ErrorModelRead>
+  | ConflictError<ErrorModelRead>
   | PayloadTooLargeError
-  | UnprocessableEntityError
-  | RateLimitedError
-  | InternalServerError
-  | BadGatewayError
+  | UnprocessableEntityError<ErrorModelRead>
+  | RateLimitError<ErrorModelRead>
+  | ServerError<ErrorModelRead>
+  | RateLimitError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError