@typeship-ax/mcp 0.19.0 → 0.21.0

package/dist/resources/publications.js

@@ -0,0 +1,70 @@
+// typeship — publications resource.
+// Generated by typeship — https://typeship.dev
+import { paginate } from "../core/pagination.js";
+import { BadRequestError, ForbiddenError, InternalServerError, NotFoundError, RateLimitedError, UnauthorizedError, } from "../errors.js";
+export class PublicationsResource {
+    _core;
+    constructor(_core) {
+        this._core = _core;
+    }
+    /**
+     * List publications
+     *
+     * Auto-paginates: `for await (const item of …)` walks every page.
+     * `GET /publications`
+     */
+    list(params, options) {
+        return paginate(this._core, {
+            method: "GET",
+            path: "/publications",
+            security: [{ "apiKey": [] }],
+            query: {
+                limit: params?.limit,
+                cursor: params?.cursor,
+                release_id: params?.releaseId,
+            },
+            errors: {
+                "400": BadRequestError,
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            idempotent: true,
+            schemaKey: "publications.list",
+            options,
+        }, {
+            style: "cursor",
+            itemsField: "data",
+            cursorParam: "cursor",
+            nextCursorField: "next_cursor",
+            hasMoreField: "has_more",
+            limitParam: "limit",
+        });
+    }
+    /**
+     * Get publishing status
+     *
+     * Returns the registry publishing status for a release. A status in another organization returns
+     * 404 resource_not_found.
+     * `GET /publications/{publication_id}`
+     */
+    async get(publicationId, options) {
+        return this._core.requestData({
+            method: "GET",
+            path: `/publications/${encodeURIComponent(String(publicationId))}`,
+            security: [{ "apiKey": [] }],
+            errors: {
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            idempotent: true,
+            schemaKey: "publications.get",
+            options,
+        });
+    }
+}

package/dist/resources/releases.d.ts

@@ -0,0 +1,68 @@
+import { HttpCore, type RequestOptions } from "../core/http.js";
+import { PagePromise } from "../core/pagination.js";
+import { ResponseParseError, TransportError, UnexpectedApiError, ValidationError, BadGatewayError, BadRequestError, ConflictError, ForbiddenError, InternalServerError, NotFoundError, RateLimitedError, UnauthorizedError } from "../errors.js";
+import type { ReleaseId, ReleaseRead, ReleaseResponseRead, TargetId } from "../types.js";
+export declare class ReleasesResource {
+    private readonly _core;
+    constructor(_core: HttpCore);
+    /**
+     * List releases
+     *
+     * Auto-paginates: `for await (const item of …)` walks every page.
+     * `GET /releases`
+     */
+    list(params?: ReleasesListParams, options?: RequestOptions): PagePromise<ReleaseRead, ReleasesListError>;
+    /**
+     * Get an immutable release
+     * `GET /releases/{release_id}`
+     */
+    get(releaseId: ReleaseId, options?: RequestOptions): Promise<ReleaseResponseRead>;
+    /**
+     * Retry publishing an exact release
+     *
+     * Retries publishing the specified release through its repository workflow. Uses that release's
+     * version and accepted commit, even if a newer Draft or release exists.
+     *
+     * A `502 repository_unavailable` means the repository publishing workflow could not be
+     * dispatched, and nothing was changed.
+     *
+     * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
+     * `POST /releases/{release_id}/republish`
+     */
+    republish(releaseId: ReleaseId, params?: ReleasesRepublishParams, options?: RequestOptions): Promise<ReleaseResponseRead>;
+}
+export interface ReleasesListParams {
+    /**
+     * 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
+     * input_invalid. List query parameters must appear only once; repeated or unrecognized parameters
+     * return 400 query_param_invalid.
+     */
+    limit?: number;
+    /**
+     * Opaque cursor from the preceding page's next_cursor. Valid only for the same organization,
+     * operation, filters, and ordering that issued it. Omit to start at the first page. Empty or
+     * malformed cursors, and cursors issued for different filters, return 400 cursor_invalid; start
+     * again from the first page. Repeated cursors return 400 query_param_invalid. The page limit may
+     * change between requests.
+     */
+    cursor?: string;
+    /** Only releases of this Target. */
+    targetId?: TargetId;
+}
+/** Typed errors `list` can throw. */
+export type ReleasesListError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+/** Typed errors `get` can throw. */
+export type ReleasesGetError = UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export interface ReleasesRepublishParams {
+    /**
+     * 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 `republish` can throw. */
+export type ReleasesRepublishError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | ConflictError | RateLimitedError | InternalServerError | BadGatewayError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+//# sourceMappingURL=releases.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"releases.d.ts","sourceRoot":"","sources":["../../src/resources/releases.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChE,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,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAEV,SAAS,EAGT,WAAW,EAEX,mBAAmB,EACnB,QAAQ,EACT,MAAM,aAAa,CAAC;AAErB,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAC5C;;;;;OAKG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC,WAAW,EAAE,iBAAiB,CAAC;IA+BxG;;;OAGG;IACG,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkBvF;;;;;;;;;;;OAWG;IACG,SAAS,CACb,SAAS,EAAE,SAAS,EACpB,MAAM,CAAC,EAAE,uBAAuB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,mBAAmB,CAAC;CAuBhC;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,qCAAqC;AACrC,MAAM,MAAM,iBAAiB,GACzB,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,oCAAoC;AACpC,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,0CAA0C;AAC1C,MAAM,MAAM,sBAAsB,GAC9B,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC"}

package/dist/resources/releases.js

@@ -0,0 +1,102 @@
+// typeship — releases resource.
+// Generated by typeship — https://typeship.dev
+import { paginate } from "../core/pagination.js";
+import { BadGatewayError, BadRequestError, ConflictError, ForbiddenError, InternalServerError, NotFoundError, RateLimitedError, UnauthorizedError, } from "../errors.js";
+export class ReleasesResource {
+    _core;
+    constructor(_core) {
+        this._core = _core;
+    }
+    /**
+     * List releases
+     *
+     * Auto-paginates: `for await (const item of …)` walks every page.
+     * `GET /releases`
+     */
+    list(params, options) {
+        return paginate(this._core, {
+            method: "GET",
+            path: "/releases",
+            security: [{ "apiKey": [] }],
+            query: {
+                limit: params?.limit,
+                cursor: params?.cursor,
+                target_id: params?.targetId,
+            },
+            errors: {
+                "400": BadRequestError,
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            idempotent: true,
+            schemaKey: "releases.list",
+            options,
+        }, {
+            style: "cursor",
+            itemsField: "data",
+            cursorParam: "cursor",
+            nextCursorField: "next_cursor",
+            hasMoreField: "has_more",
+            limitParam: "limit",
+        });
+    }
+    /**
+     * Get an immutable release
+     * `GET /releases/{release_id}`
+     */
+    async get(releaseId, options) {
+        return this._core.requestData({
+            method: "GET",
+            path: `/releases/${encodeURIComponent(String(releaseId))}`,
+            security: [{ "apiKey": [] }],
+            errors: {
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            idempotent: true,
+            schemaKey: "releases.get",
+            options,
+        });
+    }
+    /**
+     * Retry publishing an exact release
+     *
+     * Retries publishing the specified release through its repository workflow. Uses that release's
+     * version and accepted commit, even if a newer Draft or release exists.
+     *
+     * A `502 repository_unavailable` means the repository publishing workflow could not be
+     * dispatched, and nothing was changed.
+     *
+     * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
+     * `POST /releases/{release_id}/republish`
+     */
+    async republish(releaseId, params, options) {
+        return this._core.requestData({
+            method: "POST",
+            path: `/releases/${encodeURIComponent(String(releaseId))}/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",
+            schemaKey: "releases.republish",
+            options,
+        });
+    }
+}

package/dist/resources/spec-revisions.d.ts

@@ -0,0 +1,87 @@
+import { HttpCore, type RequestOptions } from "../core/http.js";
+import { PagePromise } from "../core/pagination.js";
+import { ResponseParseError, TransportError, UnexpectedApiError, ValidationError, BadRequestError, ForbiddenError, InternalServerError, NotFoundError, RateLimitedError, UnauthorizedError } from "../errors.js";
+import type { SpecId, SpecRevisionFileRead, SpecRevisionId, SpecRevisionRead, SpecRevisionResponseRead } from "../types.js";
+export declare class SpecRevisionsResource {
+    private readonly _core;
+    constructor(_core: HttpCore);
+    /**
+     * List Spec Revisions
+     *
+     * Lists Spec Revisions, newest first. Source content is not included; list a revision's files
+     * with listSpecRevisionFiles.
+     *
+     * Auto-paginates: `for await (const item of …)` walks every page.
+     * `GET /spec-revisions`
+     */
+    list(params?: SpecRevisionsListParams, options?: RequestOptions): PagePromise<SpecRevisionRead, SpecRevisionsListError>;
+    /**
+     * Get a Spec Revision
+     *
+     * Returns metadata for a saved Spec Revision with a Diagnostics summary. Pass
+     * `include=diagnostics` to add every Diagnostic, evaluated with the Spec's current patches and
+     * Diagnostic policy. List its source files and resolved document with listSpecRevisionFiles.
+     * `GET /spec-revisions/{spec_revision_id}`
+     */
+    get(specRevisionId: SpecRevisionId, params?: SpecRevisionsGetParams, options?: RequestOptions): Promise<SpecRevisionResponseRead>;
+    /**
+     * List a Spec Revision's files
+     *
+     * Lists the captured source files and the resolved document Typeship generated from, ordered by
+     * path. Read content with getFile.
+     *
+     * Auto-paginates: `for await (const item of …)` walks every page.
+     * `GET /spec-revisions/{spec_revision_id}/files`
+     */
+    listFiles(specRevisionId: SpecRevisionId, params?: SpecRevisionsListFilesParams, options?: RequestOptions): PagePromise<SpecRevisionFileRead, SpecRevisionsListFilesError>;
+}
+export interface SpecRevisionsListParams {
+    /**
+     * 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
+     * input_invalid. List query parameters must appear only once; repeated or unrecognized parameters
+     * return 400 query_param_invalid.
+     */
+    limit?: number;
+    /**
+     * Opaque cursor from the preceding page's next_cursor. Valid only for the same organization,
+     * operation, filters, and ordering that issued it. Omit to start at the first page. Empty or
+     * malformed cursors, and cursors issued for different filters, return 400 cursor_invalid; start
+     * again from the first page. Repeated cursors return 400 query_param_invalid. The page limit may
+     * change between requests.
+     */
+    cursor?: string;
+    /** Only revisions of this Spec. */
+    specId?: SpecId;
+}
+/** Typed errors `list` can throw. */
+export type SpecRevisionsListError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export interface SpecRevisionsGetParams {
+    /**
+     * Add related data to the response. `diagnostics` adds the `diagnostics` and `patch_diagnostics`
+     * arrays.
+     */
+    include?: "diagnostics";
+}
+/** Typed errors `get` can throw. */
+export type SpecRevisionsGetError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export interface SpecRevisionsListFilesParams {
+    /**
+     * 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
+     * input_invalid. List query parameters must appear only once; repeated or unrecognized parameters
+     * return 400 query_param_invalid.
+     */
+    limit?: number;
+    /**
+     * Opaque cursor from the preceding page's next_cursor. Valid only for the same organization,
+     * operation, filters, and ordering that issued it. Omit to start at the first page. Empty or
+     * malformed cursors, and cursors issued for different filters, return 400 cursor_invalid; start
+     * again from the first page. Repeated cursors return 400 query_param_invalid. The page limit may
+     * change between requests.
+     */
+    cursor?: string;
+}
+/** Typed errors `listFiles` can throw. */
+export type SpecRevisionsListFilesError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+//# sourceMappingURL=spec-revisions.d.ts.map

package/dist/resources/spec-revisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-revisions.d.ts","sourceRoot":"","sources":["../../src/resources/spec-revisions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAY,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,MAAM,EAKN,oBAAoB,EACpB,cAAc,EAGd,gBAAgB,EAEhB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAErB,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAC5C;;;;;;;;OAQG;IACH,IAAI,CACF,MAAM,CAAC,EAAE,uBAAuB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,gBAAgB,EAAE,sBAAsB,CAAC;IA+BxD;;;;;;;OAOG;IACG,GAAG,CACP,cAAc,EAAE,cAAc,EAC9B,MAAM,CAAC,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,wBAAwB,CAAC;IAsBpC;;;;;;;;OAQG;IACH,SAAS,CACP,cAAc,EAAE,cAAc,EAC9B,MAAM,CAAC,EAAE,4BAA4B,EACrC,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,oBAAoB,EAAE,2BAA2B,CAAC;CA6BlE;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qCAAqC;AACrC,MAAM,MAAM,sBAAsB,GAC9B,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;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,oCAAoC;AACpC,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,4BAA4B;IAC3C;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,0CAA0C;AAC1C,MAAM,MAAM,2BAA2B,GACnC,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC"}

package/dist/resources/spec-revisions.js

@@ -0,0 +1,116 @@
+// typeship — specRevisions resource.
+// Generated by typeship — https://typeship.dev
+import { paginate } from "../core/pagination.js";
+import { BadRequestError, ForbiddenError, InternalServerError, NotFoundError, RateLimitedError, UnauthorizedError, } from "../errors.js";
+export class SpecRevisionsResource {
+    _core;
+    constructor(_core) {
+        this._core = _core;
+    }
+    /**
+     * List Spec Revisions
+     *
+     * Lists Spec Revisions, newest first. Source content is not included; list a revision's files
+     * with listSpecRevisionFiles.
+     *
+     * Auto-paginates: `for await (const item of …)` walks every page.
+     * `GET /spec-revisions`
+     */
+    list(params, options) {
+        return paginate(this._core, {
+            method: "GET",
+            path: "/spec-revisions",
+            security: [{ "apiKey": [] }],
+            query: {
+                limit: params?.limit,
+                cursor: params?.cursor,
+                spec_id: params?.specId,
+            },
+            errors: {
+                "400": BadRequestError,
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            idempotent: true,
+            schemaKey: "specRevisions.list",
+            options,
+        }, {
+            style: "cursor",
+            itemsField: "data",
+            cursorParam: "cursor",
+            nextCursorField: "next_cursor",
+            hasMoreField: "has_more",
+            limitParam: "limit",
+        });
+    }
+    /**
+     * Get a Spec Revision
+     *
+     * Returns metadata for a saved Spec Revision with a Diagnostics summary. Pass
+     * `include=diagnostics` to add every Diagnostic, evaluated with the Spec's current patches and
+     * Diagnostic policy. List its source files and resolved document with listSpecRevisionFiles.
+     * `GET /spec-revisions/{spec_revision_id}`
+     */
+    async get(specRevisionId, params, options) {
+        return this._core.requestData({
+            method: "GET",
+            path: `/spec-revisions/${encodeURIComponent(String(specRevisionId))}`,
+            security: [{ "apiKey": [] }],
+            query: {
+                include: params?.include,
+            },
+            errors: {
+                "400": BadRequestError,
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            idempotent: true,
+            schemaKey: "specRevisions.get",
+            options,
+        });
+    }
+    /**
+     * List a Spec Revision's files
+     *
+     * Lists the captured source files and the resolved document Typeship generated from, ordered by
+     * path. Read content with getFile.
+     *
+     * Auto-paginates: `for await (const item of …)` walks every page.
+     * `GET /spec-revisions/{spec_revision_id}/files`
+     */
+    listFiles(specRevisionId, params, options) {
+        return paginate(this._core, {
+            method: "GET",
+            path: `/spec-revisions/${encodeURIComponent(String(specRevisionId))}/files`,
+            security: [{ "apiKey": [] }],
+            query: {
+                limit: params?.limit,
+                cursor: params?.cursor,
+            },
+            errors: {
+                "400": BadRequestError,
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            idempotent: true,
+            schemaKey: "specRevisions.listFiles",
+            options,
+        }, {
+            style: "cursor",
+            itemsField: "data",
+            cursorParam: "cursor",
+            nextCursorField: "next_cursor",
+            hasMoreField: "has_more",
+            limitParam: "limit",
+        });
+    }
+}

package/dist/resources/specs.d.ts

@@ -0,0 +1,73 @@
+import { HttpCore, type RequestOptions } from "../core/http.js";
+import { ResponseParseError, TransportError, UnexpectedApiError, ValidationError, BadGatewayError, BadRequestError, ConflictError, ForbiddenError, InternalServerError, NotFoundError, PreconditionFailedError, RateLimitedError, UnauthorizedError, UnprocessableEntityError } from "../errors.js";
+import type { SpecId, SpecRead, SpecUpdateRequest } from "../types.js";
+export declare class SpecsResource {
+    private readonly _core;
+    constructor(_core: HttpCore);
+    /**
+     * Get a Spec
+     * `GET /specs/{spec_id}`
+     */
+    get(specId: SpecId, options?: RequestOptions): Promise<SpecRead>;
+    /**
+     * Update and resolve a Spec
+     *
+     * Resolves the source files before saving the update and records a new Spec Revision when the
+     * source changes.
+     * Omitted fields remain unchanged; supplied objects and arrays replace the whole field.
+     * If the Spec or its Project configuration changes during validation, returns 409
+     * resource_changed without saving the rejected update. Retrieve the current Spec and Project,
+     * reconcile your changes,
+     * and submit a new request with a new Idempotency-Key if using one.
+     *
+     * See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag
+     * and If-Match.
+     *
+     * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
+     * `PATCH /specs/{spec_id}`
+     */
+    update(specId: SpecId, body: SpecUpdateRequest, params?: SpecsUpdateParams, options?: RequestOptions): Promise<SpecRead>;
+    /**
+     * Refresh a Spec from its configured source
+     *
+     * Fetches the configured source now and creates a new Spec Revision only when its content
+     * changes. Diagnostics then reads that revision. If automatic generation is enabled, refresh
+     * queues generation for active Targets even when the source is unchanged. A `502
+     * follow_up_failed` means the new Spec Revision was recorded but generation could not be queued.
+     *
+     * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
+     * `POST /specs/{spec_id}/refresh`
+     */
+    refresh(specId: SpecId, params?: SpecsRefreshParams, options?: RequestOptions): Promise<SpecRead>;
+}
+/** Typed errors `get` can throw. */
+export type SpecsGetError = UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export interface SpecsUpdateParams {
+    /**
+     * 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;
+    /**
+     * 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 `update` can throw. */
+export type SpecsUpdateError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | ConflictError | PreconditionFailedError | UnprocessableEntityError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export interface SpecsRefreshParams {
+    /**
+     * 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 `refresh` can throw. */
+export type SpecsRefreshError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | ConflictError | UnprocessableEntityError | RateLimitedError | InternalServerError | BadGatewayError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+//# sourceMappingURL=specs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../src/resources/specs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAQ,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE7E,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAC5C;;;OAGG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAkBtE;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CACV,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,iBAAiB,EACvB,MAAM,CAAC,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,QAAQ,CAAC;IA2BpB;;;;;;;;;;OAUG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;CAwBxG;AAED,oCAAoC;AACpC,MAAM,MAAM,aAAa,GACrB,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,uCAAuC;AACvC,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,aAAa,GACb,uBAAuB,GACvB,wBAAwB,GACxB,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wCAAwC;AACxC,MAAM,MAAM,iBAAiB,GACzB,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,aAAa,GACb,wBAAwB,GACxB,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC"}

package/dist/resources/specs.js

@@ -0,0 +1,108 @@
+// typeship — specs resource.
+// Generated by typeship — https://typeship.dev
+import { BadGatewayError, BadRequestError, ConflictError, ForbiddenError, InternalServerError, NotFoundError, PreconditionFailedError, RateLimitedError, UnauthorizedError, UnprocessableEntityError, } from "../errors.js";
+export class SpecsResource {
+    _core;
+    constructor(_core) {
+        this._core = _core;
+    }
+    /**
+     * Get a Spec
+     * `GET /specs/{spec_id}`
+     */
+    async get(specId, options) {
+        return this._core.requestData({
+            method: "GET",
+            path: `/specs/${encodeURIComponent(String(specId))}`,
+            security: [{ "apiKey": [] }],
+            errors: {
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            idempotent: true,
+            schemaKey: "specs.get",
+            options,
+        });
+    }
+    /**
+     * Update and resolve a Spec
+     *
+     * Resolves the source files before saving the update and records a new Spec Revision when the
+     * source changes.
+     * Omitted fields remain unchanged; supplied objects and arrays replace the whole field.
+     * If the Spec or its Project configuration changes during validation, returns 409
+     * resource_changed without saving the rejected update. Retrieve the current Spec and Project,
+     * reconcile your changes,
+     * and submit a new request with a new Idempotency-Key if using one.
+     *
+     * See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag
+     * and If-Match.
+     *
+     * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
+     * `PATCH /specs/{spec_id}`
+     */
+    async update(specId, body, params, options) {
+        return this._core.requestData({
+            method: "PATCH",
+            path: `/specs/${encodeURIComponent(String(specId))}`,
+            security: [{ "apiKey": [] }],
+            headers: {
+                "If-Match": params?.ifMatch === undefined ? undefined : String(params?.ifMatch),
+                "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
+            },
+            body,
+            errors: {
+                "400": BadRequestError,
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "409": ConflictError,
+                "412": PreconditionFailedError,
+                "422": UnprocessableEntityError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            idempotencyKey: "Idempotency-Key",
+            schemaKey: "specs.update",
+            options,
+        });
+    }
+    /**
+     * Refresh a Spec from its configured source
+     *
+     * Fetches the configured source now and creates a new Spec Revision only when its content
+     * changes. Diagnostics then reads that revision. If automatic generation is enabled, refresh
+     * queues generation for active Targets even when the source is unchanged. A `502
+     * follow_up_failed` means the new Spec Revision was recorded but generation could not be queued.
+     *
+     * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
+     * `POST /specs/{spec_id}/refresh`
+     */
+    async refresh(specId, params, options) {
+        return this._core.requestData({
+            method: "POST",
+            path: `/specs/${encodeURIComponent(String(specId))}/refresh`,
+            security: [{ "apiKey": [] }],
+            headers: {
+                "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
+            },
+            errors: {
+                "400": BadRequestError,
+                "401": UnauthorizedError,
+                "403": ForbiddenError,
+                "404": NotFoundError,
+                "409": ConflictError,
+                "422": UnprocessableEntityError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+                "502": BadGatewayError,
+            },
+            idempotencyKey: "Idempotency-Key",
+            schemaKey: "specs.refresh",
+            options,
+        });
+    }
+}