@typeship-ax/mcp 0.10.0 → 0.20.0

package/src/resources/api-keys.ts

@@ -1,7 +1,7 @@
 // typeship — apiKeys resource.
-// Generated by typeship — https://typeship.dev — do not edit by hand.
+// Generated by typeship — https://typeship.dev
 
-import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
+import { HttpCore, type RequestOptions } from "../core/http.js";
 import { paginate, PagePromise } from "../core/pagination.js";
 import {
   ResponseParseError,
@@ -10,7 +10,9 @@ import {
   ValidationError,
   BadRequestError,
   ForbiddenError,
+  InternalServerError,
   NotFoundError,
+  PreconditionFailedError,
   RateLimitedError,
   UnauthorizedError,
 } from "../errors.js";
@@ -28,16 +30,16 @@ export class ApiKeysResource {
   /**
    * List API keys
    *
-   * Keys are never returned in full — only their identity and last four. Creation stays in the
-   * console deliberately: a leaked key that can mint more keys is a leaked account.
+   * Lists key metadata and the last four characters of each key. Full keys are not returned. Create
+   * keys in the Console.
    *
    * Auto-paginates: `for await (const item of …)` walks every page.
-   * `GET /api_keys`
+   * `GET /api-keys`
    */
   list(params?: ApiKeysListParams, options?: RequestOptions): PagePromise<ApiKeyRead, ApiKeysListError> {
     return paginate<ApiKeyRead, ApiKeysListError>(this._core, {
       method: "GET",
-      path: "/api_keys",
+      path: "/api-keys",
       security: [{"apiKey":[]}],
       query: {
         limit: params?.limit,
@@ -48,6 +50,7 @@ export class ApiKeysResource {
         "401": UnauthorizedError,
         "403": ForbiddenError,
         "429": RateLimitedError,
+        "500": InternalServerError,
       },
       idempotent: true,
       schemaKey: "apiKeys.list",
@@ -62,28 +65,61 @@ export class ApiKeysResource {
     });
   }
 
+  /**
+   * Get an API key
+   *
+   * Returns the key summary and its ETag for conditional revocation.
+   * `GET /api-keys/{api_key_id}`
+   */
+  async get(apiKeyId: string, options?: RequestOptions): Promise<ApiKeyResponseRead> {
+    return this._core.requestData<ApiKeyResponseRead, ApiKeysGetError>({
+      method: "GET",
+      path: `/api-keys/${encodeURIComponent(String(apiKeyId))}`,
+      security: [{"apiKey":[]}],
+      errors: {
+        "401": UnauthorizedError,
+        "403": ForbiddenError,
+        "404": NotFoundError,
+        "429": RateLimitedError,
+        "500": InternalServerError,
+      },
+      idempotent: true,
+      schemaKey: "apiKeys.get",
+      options,
+    });
+  }
+
   /**
    * Revoke an API key
    *
-   * Idempotent: revoking an already-revoked key returns the same body, so a rotation script that
-   * re-runs does not have to special-case having already succeeded. An OAuth member may revoke a
-   * key they created; an organization admin may revoke any key. Organization API keys retain
-   * account-wide authority.
-   * `DELETE /api_keys/{api_key_id}`
+   * Revokes a key. Repeating the request returns the same result.
+   *
+   * With OAuth, members can revoke their own keys; organization admins can revoke any key.
+   * Organization API keys can revoke any key in their organization.
+   * See [conditional writes](https://typeship.dev/docs/typeship-api#conditional-writes) for ETag
+   * and If-Match.
+   * `DELETE /api-keys/{api_key_id}`
    */
   async revoke(
     apiKeyId: string,
+    params?: ApiKeysRevokeParams,
     options?: RequestOptions,
-  ): Promise<ApiResult<ApiKeyResponseRead, ApiKeysRevokeError>> {
-    return this._core.request<ApiKeyResponseRead, ApiKeysRevokeError>({
+  ): Promise<ApiKeyResponseRead> {
+    return this._core.requestData<ApiKeyResponseRead, ApiKeysRevokeError>({
       method: "DELETE",
-      path: `/api_keys/${encodeURIComponent(String(apiKeyId))}`,
+      path: `/api-keys/${encodeURIComponent(String(apiKeyId))}`,
       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,
       },
       idempotent: true,
       schemaKey: "apiKeys.revoke",
@@ -93,32 +129,64 @@ export class ApiKeysResource {
 }
 
 export interface ApiKeysListParams {
-  /** 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.
+   * 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;
 }
 
-/** Every error `list` can produce, as a discriminated union. */
+/** Typed errors `list` can throw. */
 export type ApiKeysListError =
   | BadRequestError
   | UnauthorizedError
   | ForbiddenError
   | RateLimitedError
+  | InternalServerError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError
   | ValidationError;
 
-/** Every error `revoke` can produce, as a discriminated union. */
+/** Typed errors `get` can throw. */
+export type ApiKeysGetError =
+  | UnauthorizedError
+  | ForbiddenError
+  | NotFoundError
+  | RateLimitedError
+  | InternalServerError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;
+
+export interface ApiKeysRevokeParams {
+  /**
+   * 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;
+}
+
+/** Typed errors `revoke` can throw. */
 export type ApiKeysRevokeError =
+  | BadRequestError
   | UnauthorizedError
   | ForbiddenError
   | NotFoundError
+  | PreconditionFailedError
   | RateLimitedError
+  | InternalServerError
   | UnexpectedApiError
   | ResponseParseError
   | TransportError

package/src/resources/deliveries.ts

@@ -0,0 +1,139 @@
+// typeship — deliveries 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 {
+  Delivery,
+  DeliveryId,
+  DeliveryList,
+  DeliveryListRead,
+  DeliveryRead,
+  DeliveryResponse,
+  DeliveryResponseRead,
+  TargetId,
+} from "../types.js";
+
+export class DeliveriesResource {
+  constructor(private readonly _core: HttpCore) {}
+  /**
+   * List Deliveries
+   *
+   * Auto-paginates: `for await (const item of …)` walks every page.
+   * `GET /deliveries`
+   */
+  list(
+    params?: DeliveriesListParams,
+    options?: RequestOptions,
+  ): PagePromise<DeliveryRead, DeliveriesListError> {
+    return paginate<DeliveryRead, DeliveriesListError>(this._core, {
+      method: "GET",
+      path: "/deliveries",
+      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: "deliveries.list",
+      options,
+    }, {
+      style: "cursor",
+      itemsField: "data",
+      cursorParam: "cursor",
+      nextCursorField: "next_cursor",
+      hasMoreField: "has_more",
+      limitParam: "limit",
+    });
+  }
+
+  /**
+   * Get 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 get(deliveryId: DeliveryId, options?: RequestOptions): Promise<DeliveryResponseRead> {
+    return this._core.requestData<DeliveryResponseRead, DeliveriesGetError>({
+      method: "GET",
+      path: `/deliveries/${encodeURIComponent(String(deliveryId))}`,
+      security: [{"apiKey":[]}],
+      errors: {
+        "401": UnauthorizedError,
+        "403": ForbiddenError,
+        "404": NotFoundError,
+        "429": RateLimitedError,
+        "500": InternalServerError,
+      },
+      idempotent: true,
+      schemaKey: "deliveries.get",
+      options,
+    });
+  }
+}
+
+export interface DeliveriesListParams {
+  /**
+   * 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 Deliveries of this Target. */
+  targetId?: TargetId;
+}
+
+/** Typed errors `list` can throw. */
+export type DeliveriesListError =
+  | BadRequestError
+  | UnauthorizedError
+  | ForbiddenError
+  | NotFoundError
+  | RateLimitedError
+  | InternalServerError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;
+
+/** Typed errors `get` can throw. */
+export type DeliveriesGetError =
+  | UnauthorizedError
+  | ForbiddenError
+  | NotFoundError
+  | RateLimitedError
+  | InternalServerError
+  | UnexpectedApiError
+  | ResponseParseError
+  | TransportError
+  | ValidationError;