@typeship-ax/mcp 0.10.0 → 0.20.0

package/src/resources/publications.ts

@@ -0,0 +1,139 @@
+// typeship — publications resource.
+// Generated by typeship — https://typeship.dev
+
+import { HttpCore, type RequestOptions } from "../core/http.js";
+import { paginate, PagePromise } from "../core/pagination.js";
+import {
+  ResponseParseError,
+  TransportError,
+  UnexpectedApiError,
+  ValidationError,
+  BadRequestError,
+  ForbiddenError,
+  InternalServerError,
+  NotFoundError,
+  RateLimitedError,
+  UnauthorizedError,
+} from "../errors.js";
+import type {
+  Publication,
+  PublicationId,
+  PublicationList,
+  PublicationListRead,
+  PublicationRead,
+  PublicationResponse,
+  PublicationResponseRead,
+  ReleaseId,
+} from "../types.js";
+
+export class PublicationsResource {
+  constructor(private readonly _core: HttpCore) {}
+  /**
+   * List publications
+   *
+   * Auto-paginates: `for await (const item of …)` walks every page.
+   * `GET /publications`
+   */
+  list(
+    params?: PublicationsListParams,
+    options?: RequestOptions,
+  ): PagePromise<PublicationRead, PublicationsListError> {
+    return paginate<PublicationRead, PublicationsListError>(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 not_found.
+   * `GET /publications/{publication_id}`
+   */
+  async get(publicationId: PublicationId, options?: RequestOptions): Promise<PublicationResponseRead> {
+    return this._core.requestData<PublicationResponseRead, PublicationsGetError>({
+      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,
+    });
+  }
+}
+
+export interface PublicationsListParams {
+  /**
+   * 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 organization,
+   * 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 publications of this release. */
+  releaseId?: ReleaseId;
+}
+
+/** Typed errors `list` can throw. */
+export type PublicationsListError =
+  | BadRequestError
+  | UnauthorizedError
+  | ForbiddenError
+  | NotFoundError
+  | RateLimitedError
+  | InternalServerError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;
+
+/** Typed errors `get` can throw. */
+export type PublicationsGetError =
+  | UnauthorizedError
+  | ForbiddenError
+  | NotFoundError
+  | RateLimitedError
+  | InternalServerError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;

package/src/resources/releases.ts

@@ -0,0 +1,199 @@
+// typeship — releases resource.
+// Generated by typeship — https://typeship.dev
+
+import { HttpCore, type RequestOptions } from "../core/http.js";
+import { paginate, PagePromise } from "../core/pagination.js";
+import {
+  ResponseParseError,
+  TransportError,
+  UnexpectedApiError,
+  ValidationError,
+  BadGatewayError,
+  BadRequestError,
+  ConflictError,
+  ForbiddenError,
+  InternalServerError,
+  NotFoundError,
+  RateLimitedError,
+  UnauthorizedError,
+} from "../errors.js";
+import type {
+  Release,
+  ReleaseId,
+  ReleaseList,
+  ReleaseListRead,
+  ReleaseRead,
+  ReleaseResponse,
+  ReleaseResponseRead,
+  TargetId,
+} from "../types.js";
+
+export class ReleasesResource {
+  constructor(private readonly _core: HttpCore) {}
+  /**
+   * List releases
+   *
+   * Auto-paginates: `for await (const item of …)` walks every page.
+   * `GET /releases`
+   */
+  list(params?: ReleasesListParams, options?: RequestOptions): PagePromise<ReleaseRead, ReleasesListError> {
+    return paginate<ReleaseRead, ReleasesListError>(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: ReleaseId, options?: RequestOptions): Promise<ReleaseResponseRead> {
+    return this._core.requestData<ReleaseResponseRead, ReleasesGetError>({
+      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` response means the repository publishing workflow could not be dispatched.
+   *
+   * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
+   * `POST /releases/{release_id}/republish`
+   */
+  async republish(
+    releaseId: ReleaseId,
+    params?: ReleasesRepublishParams,
+    options?: RequestOptions,
+  ): Promise<ReleaseResponseRead> {
+    return this._core.requestData<ReleaseResponseRead, ReleasesRepublishError>({
+      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,
+    });
+  }
+}
+
+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
+   * 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 organization,
+   * 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 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;

package/src/resources/spec-revisions.ts

@@ -0,0 +1,237 @@
+// typeship — specRevisions resource.
+// Generated by typeship — https://typeship.dev
+
+import { HttpCore, type RequestOptions } from "../core/http.js";
+import { paginate, PagePromise } from "../core/pagination.js";
+import {
+  ResponseParseError,
+  TransportError,
+  UnexpectedApiError,
+  ValidationError,
+  BadRequestError,
+  ForbiddenError,
+  InternalServerError,
+  NotFoundError,
+  RateLimitedError,
+  UnauthorizedError,
+} from "../errors.js";
+import type {
+  SpecId,
+  SpecRevision,
+  SpecRevisionFile,
+  SpecRevisionFileList,
+  SpecRevisionFileListRead,
+  SpecRevisionFileRead,
+  SpecRevisionId,
+  SpecRevisionList,
+  SpecRevisionListRead,
+  SpecRevisionRead,
+  SpecRevisionResponse,
+  SpecRevisionResponseRead,
+} from "../types.js";
+
+export class SpecRevisionsResource {
+  constructor(private readonly _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> {
+    return paginate<SpecRevisionRead, SpecRevisionsListError>(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: SpecRevisionId,
+    params?: SpecRevisionsGetParams,
+    options?: RequestOptions,
+  ): Promise<SpecRevisionResponseRead> {
+    return this._core.requestData<SpecRevisionResponseRead, SpecRevisionsGetError>({
+      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: SpecRevisionId,
+    params?: SpecRevisionsListFilesParams,
+    options?: RequestOptions,
+  ): PagePromise<SpecRevisionFileRead, SpecRevisionsListFilesError> {
+    return paginate<SpecRevisionFileRead, SpecRevisionsListFilesError>(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",
+    });
+  }
+}
+
+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
+   * 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 organization,
+   * 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 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
+   * 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 organization,
+   * 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;
+}
+
+/** Typed errors `listFiles` can throw. */
+export type SpecRevisionsListFilesError =
+  | BadRequestError
+  | UnauthorizedError
+  | ForbiddenError
+  | NotFoundError
+  | RateLimitedError
+  | InternalServerError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;