@typeship-ax/cli 0.10.0 → 0.20.0

package/dist/resources/projects.d.ts

@@ -1,7 +1,7 @@
 import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
 import { PagePromise } from "../core/pagination.js";
-import { ResponseParseError, TransportError, UnexpectedApiError, ValidationError, BadGatewayError, BadRequestError, ConflictError, ForbiddenError, InternalServerError, NotFoundError, PaymentRequiredError, RateLimitedError, UnauthorizedError, UnprocessableEntityError } from "../errors.js";
-import type { CreateProjectRequest, DeletedProjectRead, DiagnosticRemediationRead, DiagnosticRemediationRequest, DiagnosticReportRead, GenerationBatchRead, GenerationSummaryRead, ProjectId, ProjectRead, ProjectSummaryRead, RepositoryIntegrationHealthRead, TargetId, UpdateProjectRequest } from "../types.js";
+import { ResponseParseError, TransportError, UnexpectedApiError, ValidationError, BadGatewayError, BadRequestError, ConflictError, ForbiddenError, InternalServerError, NotFoundError, PayloadTooLargeError, PaymentRequiredError, PreconditionFailedError, RateLimitedError, UnauthorizedError, UnprocessableEntityError } from "../errors.js";
+import type { CreateProjectRequest, DeletedProjectRead, DiagnosticRemediationRead, DiagnosticRemediationRequest, DiagnosticReportRead, GenerateProjectRequest, GenerationBatchRead, GenerationSummaryRead, ProjectId, ProjectRead, ProjectSummaryRead, RepositoryIntegrationHealthRead, TargetId, UpdateProjectRequest } from "../types.js";
 export declare class ProjectsResource {
     private readonly _core;
     constructor(_core: HttpCore);
@@ -15,10 +15,11 @@ export declare class ProjectsResource {
     /**
      * Create a project
      *
-     * Stores a URL- or GitHub-sourced project. Free includes one stored project, every selected
-     * target, and the first 25 operations, while keeping manual and automatic regeneration, history,
-     * destination pull requests, and preview checks. Stateless POST /generate does not consume this
-     * slot. Pro adds projects and generates every operation in the Definition.
+     * Creates a Project from a URL or GitHub Definition.
+     *
+     * Free includes one saved Project, all selected Targets, and the first 25 operations per Target,
+     * with regeneration, history, delivery pull requests, and previews. Pro supports additional
+     * Projects and all operations. One-shot generation does not use a Project slot.
      *
      * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
      * `POST /projects`
@@ -27,36 +28,54 @@ export declare class ProjectsResource {
     /**
      * Retrieve a project
      *
-     * Returns Project-owned fields only. List Targets separately for Target and Delivery data.
+     * Returns the Project's settings and Definition ID. List its Targets separately to retrieve
+     * Target configuration and Deliveries.
      * `GET /projects/{project_id}`
      */
     retrieve(projectId: ProjectId, options?: RequestOptions): Promise<ApiResult<ProjectRead, ProjectsRetrieveError>>;
     /**
      * Delete a project
+     *
+     * A `502` response 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}`
      */
-    delete(projectId: ProjectId, options?: RequestOptions): Promise<ApiResult<DeletedProjectRead, ProjectsDeleteError>>;
+    delete(projectId: ProjectId, params?: ProjectsDeleteParams, options?: RequestOptions): Promise<ApiResult<DeletedProjectRead, ProjectsDeleteError>>;
     /**
      * Update a project
+     *
+     * Omitted fields keep their current values. A supplied config replaces the entire stored object;
+     * null or an empty object clears it.
+     * Omitting If-Match applies the update to the current resource; with If-Match, a stale ETag
+     * returns 412 precondition_failed without saving.
+     *
+     * A `409 target_busy` means a Target is publishing. Retrieve the Project, wait for publication to
+     * finish, reconcile your update, and retry.
+     * A `502` response 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.
+     * See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag
+     * and If-Match.
      * `PATCH /projects/{project_id}`
      */
-    update(projectId: ProjectId, body: UpdateProjectRequest, options?: RequestOptions): Promise<ApiResult<ProjectRead, ProjectsUpdateError>>;
+    update(projectId: ProjectId, body: UpdateProjectRequest, params?: ProjectsUpdateParams, options?: RequestOptions): Promise<ApiResult<ProjectRead, ProjectsUpdateError>>;
     /**
      * Analyze a project's latest Definition Revision
      *
-     * Runs deterministic OpenAPI or GraphQL authorship checks against the latest observed immutable
-     * Definition Revision after applying the Definition's existing patches. Diagnostics group every
-     * affected location under a stable rule. Exact patches are included only when Typeship can derive
-     * the change without inventing API behavior.
+     * Checks the latest Definition Revision after applying its saved patches. Each finding groups
+     * affected locations under a stable rule ID. A suggested patch is included only when the
+     * Definition provides enough information to determine the correction.
      * `GET /projects/{project_id}/diagnostics`
      */
     retrieveDiagnostics(projectId: ProjectId, options?: RequestOptions): Promise<ApiResult<DiagnosticReportRead, ProjectsRetrieveDiagnosticsError>>;
     /**
      * Refresh a project's Diagnostics from its configured source
      *
-     * Fetches the complete configured source, records a new immutable revision only when content
-     * changed, and returns its Diagnostics. This does not generate targets or consume a metered
-     * generation.
+     * Fetches the configured source and returns updated Diagnostics. Creates a Definition Revision
+     * only when the content changes. Does not generate Targets or use a metered generation.
      *
      * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
      * `POST /projects/{project_id}/diagnostics`
@@ -65,9 +84,11 @@ export declare class ProjectsResource {
     /**
      * Apply exact, reviewed diagnostic remediations
      *
-     * Applies only deterministic patches. Repository sources receive an updateable source pull
-     * request; URL sources receive project overlays. Diagnostics that require API-owner intent return
-     * 422 and include an authoring_brief in the Diagnostic instead.
+     * Applies reviewed patches from Diagnostics. For a repository source, opens or updates a source
+     * pull request. For a URL source, saves Definition patches.
+     *
+     * Findings that need an API-owner decision return `422`. Read the finding's `authoring_brief` and
+     * update the source instead.
      *
      * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
      * `POST /projects/{project_id}/diagnostics/remediations`
@@ -76,9 +97,8 @@ export declare class ProjectsResource {
     /**
      * Diagnose a project's repository integrations
      *
-     * Returns provider-neutral, machine-actionable source and destination access, Definition
-     * readability, source-approval label setup, required status names, and the latest durable webhook
-     * delivery. The Console renders this same result.
+     * Checks repository access, Definition readability, source-approval labels, and required checks.
+     * Includes the latest webhook delivery so you can investigate missing updates.
      * `GET /projects/{project_id}/integration-health`
      */
     retrieveIntegrationHealth(projectId: ProjectId, options?: RequestOptions): Promise<ApiResult<RepositoryIntegrationHealthRead, ProjectsRetrieveIntegrationHealthError>>;
@@ -90,97 +110,130 @@ export declare class ProjectsResource {
      */
     listGenerations(projectId: ProjectId, params?: ProjectsListGenerationsParams, options?: RequestOptions): PagePromise<GenerationSummaryRead, ProjectsListGenerationsError>;
     /**
-     * Generate targets and open pull requests
+     * Start generation for active Targets
+     *
+     * Queues one Generation per active Target and returns their IDs. Retrieve each Generation until
+     * its status moves from `queued` to `running` and then `succeeded` or `failed`. `succeeded` means
+     * generated files are saved; check Delivery and Draft status separately for repository delivery
+     * and pull requests. A Target already queued or running is returned without starting another
+     * Generation. A matching Idempotency-Key replay returns the same Generations with their current
+     * statuses.
      *
-     * Resolves the project's URL or GitHub source, generates every
-     * configured delivery package, stores each result in the project's history,
-     * and attempts to open a pull request in every configured destination.
-     * When the complete generated tree already matches a destination, no
-     * commit, branch, or pull request is created and that generation reports
-     * `pr_status: no_changes`. This is the same pipeline automatic
-     * regeneration runs after a source change.
+     * If the package already matches a destination and no Draft is open, delivery reports `pr_status:
+     * no_changes` without creating a commit, branch, or pull request. An existing Draft stays open.
+     * Automatic generation uses the same workflow.
      *
      * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
      * `POST /projects/{project_id}/generations`
      */
-    generate(projectId: ProjectId, params?: ProjectsGenerateParams, options?: RequestOptions): Promise<ApiResult<GenerationBatchRead, ProjectsGenerateError>>;
+    generate(projectId: ProjectId, body?: GenerateProjectRequest, params?: ProjectsGenerateParams, options?: RequestOptions): Promise<ApiResult<GenerationBatchRead, ProjectsGenerateError>>;
 }
 export interface ProjectsListParams {
-    /** Maximum number of resources to return. */
+    /**
+     * Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits
+     * representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400
+     * invalid_request. List query parameters must appear only once; unrecognized parameters also
+     * return 400.
+     */
     limit?: number;
     /**
      * Opaque cursor from the preceding page's next_cursor. Valid only for the same account,
-     * operation, filters, and ordering that issued it.
+     * operation, filters, and ordering that issued it. Omit to start at the first page. Empty,
+     * malformed, or repeated cursors return 400 invalid_request. The page limit may change between
+     * requests.
      */
     cursor?: string;
 }
 /** Every error `list` can produce, as a discriminated union. */
-export type ProjectsListError = BadRequestError | UnauthorizedError | ForbiddenError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+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 account and
      * operation; account-less generation uses a hashed network identity. Retrying the same method,
-     * path, query, and JSON body replays the original response. Reusing the key with changed intent
-     * returns 409. After expiry the key starts a new write.
+     * 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;
 }
 /** Every error `create` can produce, as a discriminated union. */
 export type ProjectsCreateError = BadRequestError | UnauthorizedError | PaymentRequiredError | ForbiddenError | ConflictError | UnprocessableEntityError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 /** Every error `retrieve` can produce, as a discriminated union. */
-export type ProjectsRetrieveError = UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export type ProjectsRetrieveError = UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+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
+     * version. See https://typeship.dev/docs/typeship-api#conditional-writes.
+     */
+    ifMatch?: string;
+}
 /** Every error `delete` can produce, as a discriminated union. */
-export type ProjectsDeleteError = UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export type ProjectsDeleteError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | PreconditionFailedError | RateLimitedError | InternalServerError | BadGatewayError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+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
+     * version. See https://typeship.dev/docs/typeship-api#conditional-writes.
+     */
+    ifMatch?: string;
+}
 /** Every error `update` can produce, as a discriminated union. */
-export type ProjectsUpdateError = BadRequestError | UnauthorizedError | PaymentRequiredError | ForbiddenError | NotFoundError | ConflictError | UnprocessableEntityError | RateLimitedError | BadGatewayError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export type ProjectsUpdateError = BadRequestError | UnauthorizedError | PaymentRequiredError | ForbiddenError | NotFoundError | ConflictError | PreconditionFailedError | UnprocessableEntityError | RateLimitedError | InternalServerError | BadGatewayError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 /** Every error `retrieveDiagnostics` can produce, as a discriminated union. */
-export type ProjectsRetrieveDiagnosticsError = UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export type ProjectsRetrieveDiagnosticsError = UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 export interface ProjectsRefreshDiagnosticsParams {
     /**
      * Identifies one logical write for 24 hours. The key is scoped to the authenticated account and
      * operation; account-less generation uses a hashed network identity. Retrying the same method,
-     * path, query, and JSON body replays the original response. Reusing the key with changed intent
-     * returns 409. After expiry the key starts a new write.
+     * 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;
 }
 /** Every error `refreshDiagnostics` can produce, as a discriminated union. */
-export type ProjectsRefreshDiagnosticsError = UnauthorizedError | ForbiddenError | NotFoundError | ConflictError | UnprocessableEntityError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export type ProjectsRefreshDiagnosticsError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | ConflictError | UnprocessableEntityError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 export interface ProjectsRemediateDiagnosticsParams {
     /**
      * Identifies one logical write for 24 hours. The key is scoped to the authenticated account and
      * operation; account-less generation uses a hashed network identity. Retrying the same method,
-     * path, query, and JSON body replays the original response. Reusing the key with changed intent
-     * returns 409. After expiry the key starts a new write.
+     * 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;
 }
 /** Every error `remediateDiagnostics` can produce, as a discriminated union. */
-export type ProjectsRemediateDiagnosticsError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | ConflictError | UnprocessableEntityError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export type ProjectsRemediateDiagnosticsError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | ConflictError | UnprocessableEntityError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 /** Every error `retrieveIntegrationHealth` can produce, as a discriminated union. */
-export type ProjectsRetrieveIntegrationHealthError = UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export type ProjectsRetrieveIntegrationHealthError = UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 export interface ProjectsListGenerationsParams {
-    /** Maximum number of resources to return. */
+    /**
+     * Maximum number of resources to return. Omit for 20; otherwise supply base-10 digits
+     * representing an integer from 1 to 100. Empty, malformed, or out-of-range values return 400
+     * invalid_request. List query parameters must appear only once; unrecognized parameters also
+     * return 400.
+     */
     limit?: number;
     /**
      * Opaque cursor from the preceding page's next_cursor. Valid only for the same account,
-     * operation, filters, and ordering that issued it.
+     * operation, filters, and ordering that issued it. Omit to start at the first page. Empty,
+     * malformed, or repeated cursors return 400 invalid_request. The page limit may change between
+     * requests.
      */
     cursor?: string;
     /** Only generations for this persisted Target. */
     targetId?: TargetId;
 }
 /** Every error `listGenerations` can produce, as a discriminated union. */
-export type ProjectsListGenerationsError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export type ProjectsListGenerationsError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 export interface ProjectsGenerateParams {
     /**
      * Identifies one logical write for 24 hours. The key is scoped to the authenticated account and
      * operation; account-less generation uses a hashed network identity. Retrying the same method,
-     * path, query, and JSON body replays the original response. Reusing the key with changed intent
-     * returns 409. After expiry the key starts a new write.
+     * 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;
 }
 /** Every error `generate` can produce, as a discriminated union. */
-export type ProjectsGenerateError = UnauthorizedError | PaymentRequiredError | ForbiddenError | NotFoundError | ConflictError | UnprocessableEntityError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export type ProjectsGenerateError = BadRequestError | UnauthorizedError | PaymentRequiredError | ForbiddenError | NotFoundError | ConflictError | PayloadTooLargeError | UnprocessableEntityError | RateLimitedError | InternalServerError | BadGatewayError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 //# sourceMappingURL=projects.d.ts.map

package/dist/resources/projects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/resources/projects.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/resources/projects.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAY,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,oBAAoB,EAEpB,kBAAkB,EAElB,yBAAyB,EACzB,4BAA4B,EAE5B,oBAAoB,EACpB,sBAAsB,EAEtB,mBAAmB,EAInB,qBAAqB,EAErB,SAAS,EAGT,WAAW,EAEX,kBAAkB,EAElB,+BAA+B,EAC/B,QAAQ,EACR,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAC5C;;;;;OAKG;IACH,IAAI,CACF,MAAM,CAAC,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,kBAAkB,EAAE,iBAAiB,CAAC;IA6BrD;;;;;;;;;;;OAWG;IACG,MAAM,CACV,IAAI,EAAE,oBAAoB,EAC1B,MAAM,CAAC,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;IAyBvD;;;;;;OAMG;IACG,QAAQ,CACZ,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;IAkBzD;;;;;;;;;OASG;IACG,MAAM,CACV,SAAS,EAAE,SAAS,EACpB,MAAM,CAAC,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;IAwB9D;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CACV,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,oBAAoB,EAC1B,MAAM,CAAC,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;IA2BvD;;;;;;;OAOG;IACG,mBAAmB,CACvB,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,oBAAoB,EAAE,gCAAgC,CAAC,CAAC;IAkB7E;;;;;;;;OAQG;IACG,kBAAkB,CACtB,SAAS,EAAE,SAAS,EACpB,MAAM,CAAC,EAAE,gCAAgC,EACzC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,oBAAoB,EAAE,+BAA+B,CAAC,CAAC;IAwB5E;;;;;;;;;;;OAWG;IACG,oBAAoB,CACxB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,4BAA4B,EAClC,MAAM,CAAC,EAAE,kCAAkC,EAC3C,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,yBAAyB,EAAE,iCAAiC,CAAC,CAAC;IAyBnF;;;;;;OAMG;IACG,yBAAyB,CAC7B,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,+BAA+B,EAAE,sCAAsC,CAAC,CAAC;IAkB9F;;;;;OAKG;IACH,eAAe,CACb,SAAS,EAAE,SAAS,EACpB,MAAM,CAAC,EAAE,6BAA6B,EACtC,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;IA+BnE;;;;;;;;;;;;;;;;OAgBG;IACG,QAAQ,CACZ,SAAS,EAAE,SAAS,EACpB,IAAI,CAAC,EAAE,sBAAsB,EAC7B,MAAM,CAAC,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,mBAAmB,EAAE,qBAAqB,CAAC,CAAC;CA2BlE;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,GACzB,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,kEAAkE;AAClE,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,iBAAiB,GACjB,oBAAoB,GACpB,cAAc,GACd,aAAa,GACb,wBAAwB,GACxB,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,oEAAoE;AACpE,MAAM,MAAM,qBAAqB,GAC7B,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,kEAAkE;AAClE,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,uBAAuB,GACvB,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,kEAAkE;AAClE,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,iBAAiB,GACjB,oBAAoB,GACpB,cAAc,GACd,aAAa,GACb,aAAa,GACb,uBAAuB,GACvB,wBAAwB,GACxB,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,+EAA+E;AAC/E,MAAM,MAAM,gCAAgC,GACxC,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,gCAAgC;IAC/C;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,8EAA8E;AAC9E,MAAM,MAAM,+BAA+B,GACvC,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,aAAa,GACb,wBAAwB,GACxB,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,kCAAkC;IACjD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gFAAgF;AAChF,MAAM,MAAM,iCAAiC,GACzC,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,aAAa,GACb,wBAAwB,GACxB,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,qFAAqF;AACrF,MAAM,MAAM,sCAAsC,GAC9C,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,6BAA6B;IAC5C;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,2EAA2E;AAC3E,MAAM,MAAM,4BAA4B,GACpC,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,oEAAoE;AACpE,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,iBAAiB,GACjB,oBAAoB,GACpB,cAAc,GACd,aAAa,GACb,aAAa,GACb,oBAAoB,GACpB,wBAAwB,GACxB,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC"}

package/dist/resources/projects.js

@@ -1,7 +1,7 @@
 // typeship — projects resource.
-// Generated by typeship — https://typeship.dev — do not edit by hand.
+// Generated by typeship — https://typeship.dev
 import { paginate } from "../core/pagination.js";
-import { BadGatewayError, BadRequestError, ConflictError, ForbiddenError, InternalServerError, NotFoundError, PaymentRequiredError, RateLimitedError, UnauthorizedError, UnprocessableEntityError, } from "../errors.js";
+import { BadGatewayError, BadRequestError, ConflictError, ForbiddenError, InternalServerError, NotFoundError, PayloadTooLargeError, PaymentRequiredError, PreconditionFailedError, RateLimitedError, UnauthorizedError, UnprocessableEntityError, } from "../errors.js";
 export class ProjectsResource {
     _core;
     constructor(_core) {
@@ -27,6 +27,7 @@ export class ProjectsResource {
                 "401": UnauthorizedError,
                 "403": ForbiddenError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotent: true,
             schemaKey: "projects.list",
@@ -43,10 +44,11 @@ export class ProjectsResource {
     /**
      * Create a project
      *
-     * Stores a URL- or GitHub-sourced project. Free includes one stored project, every selected
-     * target, and the first 25 operations, while keeping manual and automatic regeneration, history,
-     * destination pull requests, and preview checks. Stateless POST /generate does not consume this
-     * slot. Pro adds projects and generates every operation in the Definition.
+     * Creates a Project from a URL or GitHub Definition.
+     *
+     * Free includes one saved Project, all selected Targets, and the first 25 operations per Target,
+     * with regeneration, history, delivery pull requests, and previews. Pro supports additional
+     * Projects and all operations. One-shot generation does not use a Project slot.
      *
      * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
      * `POST /projects`
@@ -78,7 +80,8 @@ export class ProjectsResource {
     /**
      * Retrieve a project
      *
-     * Returns Project-owned fields only. List Targets separately for Target and Delivery data.
+     * Returns the Project's settings and Definition ID. List its Targets separately to retrieve
+     * Target configuration and Deliveries.
      * `GET /projects/{project_id}`
      */
     async retrieve(projectId, options) {
@@ -91,6 +94,7 @@ export class ProjectsResource {
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotent: true,
             schemaKey: "projects.retrieve",
@@ -99,18 +103,31 @@ export class ProjectsResource {
     }
     /**
      * Delete a project
+     *
+     * A `502` response 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}`
      */
-    async delete(projectId, options) {
+    async delete(projectId, params, options) {
         return this._core.request({
             method: "DELETE",
             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",
@@ -119,13 +136,29 @@ export class ProjectsResource {
     }
     /**
      * Update a project
+     *
+     * Omitted fields keep their current values. A supplied config replaces the entire stored object;
+     * null or an empty object clears it.
+     * Omitting If-Match applies the update to the current resource; with If-Match, a stale ETag
+     * returns 412 precondition_failed without saving.
+     *
+     * A `409 target_busy` means a Target is publishing. Retrieve the Project, wait for publication to
+     * finish, reconcile your update, and retry.
+     * A `502` response 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.
+     * See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag
+     * and If-Match.
      * `PATCH /projects/{project_id}`
      */
-    async update(projectId, body, options) {
+    async update(projectId, body, params, options) {
         return this._core.request({
             method: "PATCH",
             path: `/projects/${encodeURIComponent(String(projectId))}`,
             security: [{ "apiKey": [] }],
+            headers: {
+                "If-Match": params?.ifMatch === undefined ? undefined : String(params?.ifMatch),
+            },
             body,
             errors: {
                 "400": BadRequestError,
@@ -134,8 +167,10 @@ export class ProjectsResource {
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "409": ConflictError,
+                "412": PreconditionFailedError,
                 "422": UnprocessableEntityError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
                 "502": BadGatewayError,
             },
             schemaKey: "projects.update",
@@ -145,10 +180,9 @@ export class ProjectsResource {
     /**
      * Analyze a project's latest Definition Revision
      *
-     * Runs deterministic OpenAPI or GraphQL authorship checks against the latest observed immutable
-     * Definition Revision after applying the Definition's existing patches. Diagnostics group every
-     * affected location under a stable rule. Exact patches are included only when Typeship can derive
-     * the change without inventing API behavior.
+     * Checks the latest Definition Revision after applying its saved patches. Each finding groups
+     * affected locations under a stable rule ID. A suggested patch is included only when the
+     * Definition provides enough information to determine the correction.
      * `GET /projects/{project_id}/diagnostics`
      */
     async retrieveDiagnostics(projectId, options) {
@@ -161,6 +195,7 @@ export class ProjectsResource {
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotent: true,
             schemaKey: "projects.retrieveDiagnostics",
@@ -170,9 +205,8 @@ export class ProjectsResource {
     /**
      * Refresh a project's Diagnostics from its configured source
      *
-     * Fetches the complete configured source, records a new immutable revision only when content
-     * changed, and returns its Diagnostics. This does not generate targets or consume a metered
-     * generation.
+     * Fetches the configured source and returns updated Diagnostics. Creates a Definition Revision
+     * only when the content changes. Does not generate Targets or use a metered generation.
      *
      * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
      * `POST /projects/{project_id}/diagnostics`
@@ -186,12 +220,14 @@ export class ProjectsResource {
                 "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,
             },
             idempotencyKey: "Idempotency-Key",
             schemaKey: "projects.refreshDiagnostics",
@@ -201,9 +237,11 @@ export class ProjectsResource {
     /**
      * Apply exact, reviewed diagnostic remediations
      *
-     * Applies only deterministic patches. Repository sources receive an updateable source pull
-     * request; URL sources receive project overlays. Diagnostics that require API-owner intent return
-     * 422 and include an authoring_brief in the Diagnostic instead.
+     * Applies reviewed patches from Diagnostics. For a repository source, opens or updates a source
+     * pull request. For a URL source, saves Definition patches.
+     *
+     * Findings that need an API-owner decision return `422`. Read the finding's `authoring_brief` and
+     * update the source instead.
      *
      * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
      * `POST /projects/{project_id}/diagnostics/remediations`
@@ -225,6 +263,7 @@ export class ProjectsResource {
                 "409": ConflictError,
                 "422": UnprocessableEntityError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotencyKey: "Idempotency-Key",
             schemaKey: "projects.remediateDiagnostics",
@@ -234,9 +273,8 @@ export class ProjectsResource {
     /**
      * Diagnose a project's repository integrations
      *
-     * Returns provider-neutral, machine-actionable source and destination access, Definition
-     * readability, source-approval label setup, required status names, and the latest durable webhook
-     * delivery. The Console renders this same result.
+     * Checks repository access, Definition readability, source-approval labels, and required checks.
+     * Includes the latest webhook delivery so you can investigate missing updates.
      * `GET /projects/{project_id}/integration-health`
      */
     async retrieveIntegrationHealth(projectId, options) {
@@ -249,6 +287,7 @@ export class ProjectsResource {
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotent: true,
             schemaKey: "projects.retrieveIntegrationHealth",
@@ -277,6 +316,7 @@ export class ProjectsResource {
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotent: true,
             schemaKey: "projects.listGenerations",
@@ -291,20 +331,23 @@ export class ProjectsResource {
         });
     }
     /**
-     * Generate targets and open pull requests
+     * Start generation for active Targets
+     *
+     * Queues one Generation per active Target and returns their IDs. Retrieve each Generation until
+     * its status moves from `queued` to `running` and then `succeeded` or `failed`. `succeeded` means
+     * generated files are saved; check Delivery and Draft status separately for repository delivery
+     * and pull requests. A Target already queued or running is returned without starting another
+     * Generation. A matching Idempotency-Key replay returns the same Generations with their current
+     * statuses.
      *
-     * Resolves the project's URL or GitHub source, generates every
-     * configured delivery package, stores each result in the project's history,
-     * and attempts to open a pull request in every configured destination.
-     * When the complete generated tree already matches a destination, no
-     * commit, branch, or pull request is created and that generation reports
-     * `pr_status: no_changes`. This is the same pipeline automatic
-     * regeneration runs after a source change.
+     * If the package already matches a destination and no Draft is open, delivery reports `pr_status:
+     * no_changes` without creating a commit, branch, or pull request. An existing Draft stays open.
+     * Automatic generation uses the same workflow.
      *
      * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
      * `POST /projects/{project_id}/generations`
      */
-    async generate(projectId, params, options) {
+    async generate(projectId, body, params, options) {
         return this._core.request({
             method: "POST",
             path: `/projects/${encodeURIComponent(String(projectId))}/generations`,
@@ -312,15 +355,19 @@ export class ProjectsResource {
             headers: {
                 "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,
             },
             idempotencyKey: "Idempotency-Key",
             schemaKey: "projects.generate",