@typeship-ax/mcp 0.10.0 → 0.19.0

package/dist/resources/targets.js

@@ -1,7 +1,7 @@
 // typeship — targets 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, NotFoundError, RateLimitedError, UnauthorizedError, UnprocessableEntityError, } from "../errors.js";
+import { BadGatewayError, BadRequestError, ConflictError, ForbiddenError, InternalServerError, NotFoundError, PaymentRequiredError, PreconditionFailedError, RateLimitedError, UnauthorizedError, UnprocessableEntityError, } from "../errors.js";
 export class TargetsResource {
     _core;
     constructor(_core) {
@@ -28,6 +28,7 @@ export class TargetsResource {
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotent: true,
             schemaKey: "targets.list",
@@ -44,8 +45,8 @@ export class TargetsResource {
     /**
      * Create an independently configured Target
      *
-     * Several Targets may use the same generator with distinct configuration, Deliveries, and release
-     * streams.
+     * Creates a Target with its own configuration, Deliveries, and release history. Multiple Targets
+     * can use the same generator.
      *
      * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
      * `POST /projects/{project_id}/targets`
@@ -62,11 +63,13 @@ export class TargetsResource {
             errors: {
                 "400": BadRequestError,
                 "401": UnauthorizedError,
+                "402": PaymentRequiredError,
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "409": ConflictError,
                 "422": UnprocessableEntityError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotencyKey: "Idempotency-Key",
             schemaKey: "targets.create",
@@ -87,6 +90,7 @@ export class TargetsResource {
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotent: true,
             schemaKey: "targets.retrieve",
@@ -96,21 +100,31 @@ export class TargetsResource {
     /**
      * Delete an unused Target
      *
-     * Targets with Generation or release history, or an active release candidate, must be disabled
-     * instead.
+     * 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, options) {
+    async delete(targetId, params, options) {
         return this._core.request({
             method: "DELETE",
             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",
@@ -119,22 +133,45 @@ export class TargetsResource {
     }
     /**
      * Update a Target, its Deliveries, or its next reviewed version
+     *
+     * Omitted fields keep their current values. Supplied config, checks, and deliveries replace their
+     * complete stored values.
+     * Omitting If-Match applies the update to the current resource; with If-Match, a stale ETag
+     * returns 412 precondition_failed without saving.
+     * Send proposed_version by itself; use the Draft endpoint to select a version directly.
+     *
+     * A `409 target_busy` means the Target is publishing; wait for it to finish. A `409
+     * delivery_conflict` means another Target owns the requested repository tree; retrieve both
+     * Targets, choose a free destination, and retry.
+     * A `502` response means the update was saved, but retiring an obsolete review or regenerating a
+     * version selection failed. Retrieve the Target and follow the error's retryable and
+     * suggested_action fields. Repeating an unfinished version selection resumes generation;
+     * repeating a completed selection starts no new work.
+     * See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag
+     * and If-Match.
      * `PATCH /targets/{target_id}`
      */
-    async update(targetId, body, options) {
+    async update(targetId, body, params, options) {
         return this._core.request({
             method: "PATCH",
             path: `/targets/${encodeURIComponent(String(targetId))}`,
             security: [{ "apiKey": [] }],
+            headers: {
+                "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,
             },
             schemaKey: "targets.update",
             options,
@@ -161,6 +198,7 @@ export class TargetsResource {
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotent: true,
             schemaKey: "targets.listReleases",
@@ -177,8 +215,10 @@ export class TargetsResource {
     /**
      * Retrieve a Target's rolling Draft release
      *
-     * Returns Current, the cumulative Draft version and readiness, its exact head, and the optimistic
-     * release revision.
+     * Returns the Draft's status and its one next step, Current's version, the proposed version,
+     * readiness, checks, and conflict counts. Every status is described on `status`. The response
+     * carries an `ETag`; send it in `If-Match` when updating the Draft to avoid changing a newer
+     * version selection.
      * `GET /targets/{target_id}/draft`
      */
     async retrieveDraft(targetId, options) {
@@ -191,6 +231,7 @@ export class TargetsResource {
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotent: true,
             schemaKey: "targets.retrieveDraft",
@@ -200,15 +241,32 @@ export class TargetsResource {
     /**
      * Select an exact Draft version or return to automatic versioning
      *
-     * Validates the selection against the cumulative required bump and regenerates the same rolling
+     * Checks your version choice against the required version bump, then regenerates the existing
      * Draft pull request.
+     *
+     * Send the Draft's `ETag` in `If-Match` to reject an intervening change with 412
+     * precondition_failed before saving or regenerating. Omitting `If-Match` applies the selection to
+     * the current Draft. Version is required; null restores automatic selection.
+     *
+     * A `502` response means the selected version was saved, but regeneration failed. Follow the
+     * error's retryable and suggested_action fields. Repeating an unfinished selection resumes
+     * generation; repeating a completed selection starts no new work. If using If-Match, retrieve the
+     * Draft and confirm the saved selection before retrying with its current ETag.
+     * A `409 target_busy` means the Target is publishing; wait and retry. A `409 version_occupied`
+     * means the version is already released; retrieve the Draft and releases, choose a new version,
+     * and retry.
+     * See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag
+     * and If-Match.
      * `PATCH /targets/{target_id}/draft`
      */
-    async updateDraft(targetId, body, options) {
+    async updateDraft(targetId, body, params, options) {
         return this._core.request({
             method: "PATCH",
             path: `/targets/${encodeURIComponent(String(targetId))}/draft`,
             security: [{ "apiKey": [] }],
+            headers: {
+                "If-Match": params?.ifMatch === undefined ? undefined : String(params?.ifMatch),
+            },
             body,
             errors: {
                 "400": BadRequestError,
@@ -216,8 +274,11 @@ export class TargetsResource {
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "409": ConflictError,
+                "412": PreconditionFailedError,
                 "422": UnprocessableEntityError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
+                "502": BadGatewayError,
             },
             schemaKey: "targets.updateDraft",
             options,
@@ -226,9 +287,9 @@ export class TargetsResource {
     /**
      * Adopt a verified existing package as Current
      *
-     * Verifies the repository tag, package metadata, and registry artifact; records an Imported
-     * Current release; then opens the first Typeship Draft at the next major version because no
-     * trusted generated baseline exists yet.
+     * Checks the repository tag, package metadata, and registry artifact, then records the package as
+     * an Imported Current release. Opens the first Typeship Draft at the next major version; review
+     * it to establish the baseline for preserving existing code.
      *
      * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
      * `POST /targets/{target_id}/adopt`
@@ -250,6 +311,7 @@ export class TargetsResource {
                 "409": ConflictError,
                 "422": UnprocessableEntityError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotencyKey: "Idempotency-Key",
             schemaKey: "targets.adoptRelease",
@@ -258,18 +320,19 @@ export class TargetsResource {
     }
     /**
      * Retrieve an immutable Target release
-     * `GET /target_releases/{target_release_id}`
+     * `GET /target-releases/{target_release_id}`
      */
     async retrieveRelease(targetReleaseId, options) {
         return this._core.request({
             method: "GET",
-            path: `/target_releases/${encodeURIComponent(String(targetReleaseId))}`,
+            path: `/target-releases/${encodeURIComponent(String(targetReleaseId))}`,
             security: [{ "apiKey": [] }],
             errors: {
                 "401": UnauthorizedError,
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotent: true,
             schemaKey: "targets.retrieveRelease",
@@ -279,26 +342,30 @@ export class TargetsResource {
     /**
      * Retry publication of an exact Target release
      *
-     * Dispatches the repository-owned republish workflow for this immutable version and accepted
-     * commit. It never selects the latest Draft or release.
+     * Retries publication of the specified release through its repository workflow. Uses that
+     * release's version and accepted commit, even if a newer Draft or release exists.
+     *
+     * A `502` response means the repository publication workflow could not be dispatched.
      *
      * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
-     * `POST /target_releases/{target_release_id}/republish`
+     * `POST /target-releases/{target_release_id}/republish`
      */
     async republishRelease(targetReleaseId, params, options) {
         return this._core.request({
             method: "POST",
-            path: `/target_releases/${encodeURIComponent(String(targetReleaseId))}/republish`,
+            path: `/target-releases/${encodeURIComponent(String(targetReleaseId))}/republish`,
             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",
@@ -306,4 +373,223 @@ export class TargetsResource {
             options,
         });
     }
+    /**
+     * List customized and conflicted files on a Draft
+     *
+     * Lists the Draft's files that differ from the last accepted package or need a conflict decision,
+     * ordered by path, without file content. Each conflict names its kind, where the incoming version
+     * comes from, the saved decision, and the sides you can read with retrieveDraftFileContent. With
+     * `filter=history`, lists the files affected by a default-branch history rewrite instead; the
+     * list is empty when none is pending.
+     *
+     * Returns `409 stale_draft` while Typeship has not integrated the Draft's latest commit (Draft
+     * status generating or branch_changed), or when the Draft changes between pages.
+     *
+     * Auto-paginates: `for await (const item of …)` walks every page.
+     * `GET /targets/{target_id}/draft/files`
+     */
+    listDraftFiles(targetId, params, options) {
+        return paginate(this._core, {
+            method: "GET",
+            path: `/targets/${encodeURIComponent(String(targetId))}/draft/files`,
+            security: [{ "apiKey": [] }],
+            query: {
+                filter: params?.filter,
+                limit: params?.limit,
+                cursor: params?.cursor,
+            },
+            errors: {
+                "400": BadRequestError,
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "409": ConflictError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            idempotent: true,
+            schemaKey: "targets.listDraftFiles",
+            options,
+        }, {
+            style: "cursor",
+            itemsField: "data",
+            cursorParam: "cursor",
+            nextCursorField: "next_cursor",
+            hasMoreField: "has_more",
+            limitParam: "limit",
+        });
+    }
+    /**
+     * Read one side of a Draft file
+     *
+     * Returns up to 24 KiB of one side of a conflicted or history-affected file: text as UTF-8,
+     * binary content as base64. Follow `next_cursor` with the same path and side to read the rest,
+     * and concatenate the chunks in order. A side where the file is absent returns 404.
+     * `GET /targets/{target_id}/draft/files/content`
+     */
+    async retrieveDraftFileContent(targetId, params, options) {
+        return this._core.request({
+            method: "GET",
+            path: `/targets/${encodeURIComponent(String(targetId))}/draft/files/content`,
+            security: [{ "apiKey": [] }],
+            query: {
+                path: params.path,
+                side: params.side,
+                cursor: params.cursor,
+            },
+            errors: {
+                "400": BadRequestError,
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "409": ConflictError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            idempotent: true,
+            schemaKey: "targets.retrieveDraftFileContent",
+            options,
+        });
+    }
+    /**
+     * Resolve selected Draft conflicts
+     *
+     * Saves decisions for conflicts on the Draft's head_revision: keep the repository or incoming
+     * version, or supply the final content as text or, for binary files, base64. Decisions save
+     * together or not at all, and a decision can be replaced until it is applied. Use `dry_run` to
+     * validate them first.
+     *
+     * Saving changes no files. When every conflict has a decision, `remaining_conflicts` is 0 and the
+     * Draft status becomes `needs_generation`: generate the Target to apply the decisions and run its
+     * checks. Applying them can report conflicts from the next merge stage.
+     * `POST /targets/{target_id}/draft/conflicts/resolve`
+     */
+    async resolveDraftConflicts(targetId, body, options) {
+        return this._core.request({
+            method: "POST",
+            path: `/targets/${encodeURIComponent(String(targetId))}/draft/conflicts/resolve`,
+            security: [{ "apiKey": [] }],
+            body,
+            errors: {
+                "400": BadRequestError,
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "409": ConflictError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            schemaKey: "targets.resolveDraftConflicts",
+            options,
+        });
+    }
+    /**
+     * Discard selected Draft customizations
+     *
+     * Replaces the listed customized paths that are not conflicts with the generated files, in one
+     * commit on the Draft branch. A listed file that exists only on the Draft is deleted. Use
+     * `dry_run` to see the planned writes and deletions first. Resolve conflicts with
+     * resolveDraftConflicts.
+     *
+     * After the commit, the Draft status is `branch_changed` until Typeship integrates it from the
+     * repository's pull request event and reruns the checks; you do not need to generate the Target.
+     * `POST /targets/{target_id}/draft/customizations/discard`
+     */
+    async discardDraftCustomizations(targetId, body, options) {
+        return this._core.request({
+            method: "POST",
+            path: `/targets/${encodeURIComponent(String(targetId))}/draft/customizations/discard`,
+            security: [{ "apiKey": [] }],
+            body,
+            errors: {
+                "400": BadRequestError,
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "409": ConflictError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            schemaKey: "targets.discardDraftCustomizations",
+            options,
+        });
+    }
+    /**
+     * Approve recovery from rewritten default-branch history
+     *
+     * When the Draft status is `history_rewritten`, review the affected files with `listDraftFiles`
+     * and `filter=history`, then approve with the Draft's `history_recovery` revisions. Approval
+     * saves the recovery without changing Git, and the Draft status becomes `needs_generation`:
+     * generate the Target to open a new Draft from the rewritten default branch. The previous Draft
+     * branch stays available, and overlapping code comes back as conflicts to resolve. A rewritten
+     * Draft branch alone needs no approval.
+     * `POST /targets/{target_id}/draft/history/recover`
+     */
+    async recoverDraftHistory(targetId, body, options) {
+        return this._core.request({
+            method: "POST",
+            path: `/targets/${encodeURIComponent(String(targetId))}/draft/history/recover`,
+            security: [{ "apiKey": [] }],
+            body,
+            errors: {
+                "400": BadRequestError,
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "409": ConflictError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            schemaKey: "targets.recoverDraftHistory",
+            options,
+        });
+    }
+    /**
+     * Retrieve a Delivery
+     *
+     * Returns the configured repository or hosted MCP Delivery for a Target. A Delivery in another
+     * organization returns 404 not_found.
+     * `GET /deliveries/{delivery_id}`
+     */
+    async retrieveDelivery(deliveryId, options) {
+        return this._core.request({
+            method: "GET",
+            path: `/deliveries/${encodeURIComponent(String(deliveryId))}`,
+            security: [{ "apiKey": [] }],
+            errors: {
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            idempotent: true,
+            schemaKey: "targets.retrieveDelivery",
+            options,
+        });
+    }
+    /**
+     * Retrieve a Publication
+     *
+     * Returns the current registry publication state for a Target Release. A Publication in another
+     * organization returns 404 not_found.
+     * `GET /publications/{publication_id}`
+     */
+    async retrievePublication(publicationId, options) {
+        return this._core.request({
+            method: "GET",
+            path: `/publications/${encodeURIComponent(String(publicationId))}`,
+            security: [{ "apiKey": [] }],
+            errors: {
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            idempotent: true,
+            schemaKey: "targets.retrievePublication",
+            options,
+        });
+    }
 }

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CAmCpE,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAmIxC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CA6CpE,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CA6KxC,CAAC"}