@typeship-ax/cli 0.10.0 → 0.20.0

package/dist/resources/definitions.js

@@ -1,6 +1,6 @@
 // typeship — definitions resource.
-// Generated by typeship — https://typeship.dev — do not edit by hand.
-import { BadRequestError, ConflictError, ForbiddenError, NotFoundError, RateLimitedError, UnauthorizedError, UnprocessableEntityError, } from "../errors.js";
+// Generated by typeship — https://typeship.dev
+import { BadRequestError, ConflictError, ForbiddenError, InternalServerError, NotFoundError, PreconditionFailedError, RateLimitedError, UnauthorizedError, UnprocessableEntityError, } from "../errors.js";
 export class DefinitionsResource {
     _core;
     constructor(_core) {
@@ -20,6 +20,7 @@ export class DefinitionsResource {
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotent: true,
             schemaKey: "definitions.retrieve",
@@ -29,7 +30,16 @@ export class DefinitionsResource {
     /**
      * Update and resolve a Definition
      *
-     * Resolves the complete document graph and records a new immutable revision before saving.
+     * Resolves the source documents before saving the update and records a new Definition Revision
+     * when the source changes.
+     * Omitted fields remain unchanged; supplied objects and arrays replace the whole field.
+     * If the Definition or its Project configuration changes during validation, returns 409
+     * definition_changed without saving the rejected update. Retrieve the current Definition 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 /definitions/{definition_id}`
@@ -40,6 +50,7 @@ export class DefinitionsResource {
             path: `/definitions/${encodeURIComponent(String(definitionId))}`,
             security: [{ "apiKey": [] }],
             headers: {
+                "If-Match": params?.ifMatch === undefined ? undefined : String(params?.ifMatch),
                 "Idempotency-Key": params?.idempotencyKey === undefined ? undefined : String(params?.idempotencyKey),
             },
             body,
@@ -49,8 +60,10 @@ export class DefinitionsResource {
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "409": ConflictError,
+                "412": PreconditionFailedError,
                 "422": UnprocessableEntityError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotencyKey: "Idempotency-Key",
             schemaKey: "definitions.update",

package/dist/resources/generate.d.ts

@@ -1,36 +1,65 @@
 import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
-import { ResponseParseError, TransportError, UnexpectedApiError, ValidationError, ApiResponseError, BadRequestError, ConflictError, ForbiddenError, PayloadTooLargeError, RateLimitedError, UnauthorizedError, UnprocessableEntityError } from "../errors.js";
+import { ResponseParseError, TransportError, UnexpectedApiError, ValidationError, ApiResponseError, BadRequestError, ConflictError, ForbiddenError, InternalServerError, NotFoundError, PayloadTooLargeError, RateLimitedError, UnauthorizedError, UnprocessableEntityError } from "../errors.js";
 import type { GenerateRequest, GenerationResultRead } from "../types.js";
 export declare class GenerateResource {
     private readonly _core;
     constructor(_core: HttpCore);
     /**
-     * Generate one Target from a Definition
-     *
-     * Stateless generation: nothing is stored. Returns the full generated
-     * package as files. Works without an API key: anonymous calls generate
-     * the first 25 operations, rate limited per IP address, and the
-     * response's `limits` object says what was held back and where to lift
-     * it; anonymous calls from a Definition URL also carry `claim.url`, a link
-     * that turns the run into a project once a person signs in. With a key, the free plan generates
-     * the first 25 operations and
-     * paid plans generate the complete Definition. A present but invalid key is a
-     * 401, not a downgrade to anonymous.
+     * Generate one package from a Definition
+     *
+     * Returns one generated package without creating a Project.
+     *
+     * Supports [idempotent retries](https://typeship.dev/docs/typeship-api/idempotency); keyed
+     * responses include generated files in the replay cache.
+     *
+     * Use `download.url` to save the complete ZIP, verify `download.sha256`, and extract it into an
+     * empty directory. The link expires at `download.expires_at` and grants access to anyone who has
+     * it. CLI, MCP, and SDK calls supply an idempotency key automatically. Agents should request
+     * `fields=["download","meta","warnings","limits","claim"]` to keep the MCP result compact; files
+     * can exceed the response limit. Download the ZIP instead of repeating generation to retrieve
+     * omitted files.
+     *
+     * Anonymous and Free requests include the first 25 operations. Paid plans include all operations.
+     * Anonymous requests are rate limited by IP address. Check `limits` for omitted operations; an
+     * invalid API key returns `401`.
+     *
+     * An anonymous URL request without source headers may return `claim.url`. Sign in through that
+     * link within seven days to save the recipe as a Project.
      *
      * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
      * `POST /generate`
      */
     run(body: GenerateRequest, params?: GenerateRunParams, options?: RequestOptions): Promise<ApiResult<GenerationResultRead, GenerateRunError>>;
+    /**
+     * Download a generated package
+     *
+     * Download the complete ZIP referenced by `generate_run`'s `download.url`. Pass the token from
+     * that URL. No API key is needed; the token grants access only to that exact package until its
+     * replay window expires. Keep the token private.
+     *
+     * The local MCP server saves this binary response to disk. On a hosted MCP connection, download
+     * the original URL directly to your workspace. Verify the ZIP against `download.sha256` before
+     * extracting it into an empty directory. Expired or invalid tokens return `404`; a new generation
+     * creates a new download.
+     * `GET /generate/download`
+     */
+    downloadPackage(params: GenerateDownloadPackageParams, options?: RequestOptions): Promise<ApiResult<Blob, GenerateDownloadPackageError>>;
 }
 export interface GenerateRunParams {
     /**
      * 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 `run` can produce, as a discriminated union. */
-export type GenerateRunError = BadRequestError | UnauthorizedError | ForbiddenError | ConflictError | PayloadTooLargeError | UnprocessableEntityError | RateLimitedError | ApiResponseError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export type GenerateRunError = BadRequestError | UnauthorizedError | ForbiddenError | ConflictError | PayloadTooLargeError | UnprocessableEntityError | RateLimitedError | InternalServerError | ApiResponseError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export interface GenerateDownloadPackageParams {
+    /** Private download token from download.url in the generation result. */
+    token: string;
+}
+/** Every error `downloadPackage` can produce, as a discriminated union. */
+export type GenerateDownloadPackageError = BadRequestError | NotFoundError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 //# sourceMappingURL=generate.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/resources/generate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,eAAe,EAAoB,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE3F,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAC5C;;;;;;;;;;;;;;;OAeG;IACG,GAAG,CACP,IAAI,EAAE,eAAe,EACrB,MAAM,CAAC,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;CAwB9D;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,+DAA+D;AAC/D,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,oBAAoB,GACpB,wBAAwB,GACxB,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/resources/generate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,eAAe,EAAoB,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE3F,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAC5C;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,GAAG,CACP,IAAI,EAAE,eAAe,EACrB,MAAM,CAAC,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;IA0B7D;;;;;;;;;;;;OAYG;IACG,eAAe,CACnB,MAAM,EAAE,6BAA6B,EACrC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,4BAA4B,CAAC,CAAC;CAmB1D;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,+DAA+D;AAC/D,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,oBAAoB,GACpB,wBAAwB,GACxB,gBAAgB,GAChB,mBAAmB,GACnB,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,6BAA6B;IAC5C,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2EAA2E;AAC3E,MAAM,MAAM,4BAA4B,GACpC,eAAe,GACf,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC"}

package/dist/resources/generate.js

@@ -1,23 +1,32 @@
 // typeship — generate resource.
-// Generated by typeship — https://typeship.dev — do not edit by hand.
-import { ApiResponseError, BadRequestError, ConflictError, ForbiddenError, PayloadTooLargeError, RateLimitedError, UnauthorizedError, UnprocessableEntityError, } from "../errors.js";
+// Generated by typeship — https://typeship.dev
+import { ApiResponseError, BadRequestError, ConflictError, ForbiddenError, InternalServerError, NotFoundError, PayloadTooLargeError, RateLimitedError, UnauthorizedError, UnprocessableEntityError, } from "../errors.js";
 export class GenerateResource {
     _core;
     constructor(_core) {
         this._core = _core;
     }
     /**
-     * Generate one Target from a Definition
-     *
-     * Stateless generation: nothing is stored. Returns the full generated
-     * package as files. Works without an API key: anonymous calls generate
-     * the first 25 operations, rate limited per IP address, and the
-     * response's `limits` object says what was held back and where to lift
-     * it; anonymous calls from a Definition URL also carry `claim.url`, a link
-     * that turns the run into a project once a person signs in. With a key, the free plan generates
-     * the first 25 operations and
-     * paid plans generate the complete Definition. A present but invalid key is a
-     * 401, not a downgrade to anonymous.
+     * Generate one package from a Definition
+     *
+     * Returns one generated package without creating a Project.
+     *
+     * Supports [idempotent retries](https://typeship.dev/docs/typeship-api/idempotency); keyed
+     * responses include generated files in the replay cache.
+     *
+     * Use `download.url` to save the complete ZIP, verify `download.sha256`, and extract it into an
+     * empty directory. The link expires at `download.expires_at` and grants access to anyone who has
+     * it. CLI, MCP, and SDK calls supply an idempotency key automatically. Agents should request
+     * `fields=["download","meta","warnings","limits","claim"]` to keep the MCP result compact; files
+     * can exceed the response limit. Download the ZIP instead of repeating generation to retrieve
+     * omitted files.
+     *
+     * Anonymous and Free requests include the first 25 operations. Paid plans include all operations.
+     * Anonymous requests are rate limited by IP address. Check `limits` for omitted operations; an
+     * invalid API key returns `401`.
+     *
+     * An anonymous URL request without source headers may return `claim.url`. Sign in through that
+     * link within seven days to save the recipe as a Project.
      *
      * A `Idempotency-Key` UUID is generated per call (stable across retries) unless you pass one.
      * `POST /generate`
@@ -39,6 +48,7 @@ export class GenerateResource {
                 "413": PayloadTooLargeError,
                 "422": UnprocessableEntityError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
                 default: ApiResponseError,
             },
             idempotencyKey: "Idempotency-Key",
@@ -46,4 +56,36 @@ export class GenerateResource {
             options,
         });
     }
+    /**
+     * Download a generated package
+     *
+     * Download the complete ZIP referenced by `generate_run`'s `download.url`. Pass the token from
+     * that URL. No API key is needed; the token grants access only to that exact package until its
+     * replay window expires. Keep the token private.
+     *
+     * The local MCP server saves this binary response to disk. On a hosted MCP connection, download
+     * the original URL directly to your workspace. Verify the ZIP against `download.sha256` before
+     * extracting it into an empty directory. Expired or invalid tokens return `404`; a new generation
+     * creates a new download.
+     * `GET /generate/download`
+     */
+    async downloadPackage(params, options) {
+        return this._core.request({
+            method: "GET",
+            path: "/generate/download",
+            security: [{}],
+            query: {
+                token: params.token,
+            },
+            errors: {
+                "400": BadRequestError,
+                "404": NotFoundError,
+                "429": RateLimitedError,
+                "500": InternalServerError,
+            },
+            idempotent: true,
+            schemaKey: "generate.downloadPackage",
+            options,
+        });
+    }
 }

package/dist/resources/generations.d.ts

@@ -1,5 +1,5 @@
 import { HttpCore, type ApiResult, type RequestOptions } from "../core/http.js";
-import { ResponseParseError, TransportError, UnexpectedApiError, ValidationError, BadRequestError, ForbiddenError, NotFoundError, RateLimitedError, UnauthorizedError } from "../errors.js";
+import { ResponseParseError, TransportError, UnexpectedApiError, ValidationError, BadRequestError, ForbiddenError, InternalServerError, NotFoundError, RateLimitedError, UnauthorizedError } from "../errors.js";
 import type { GenerationId, GenerationResponseRead } from "../types.js";
 export declare class GenerationsResource {
     private readonly _core;
@@ -7,25 +7,33 @@ export declare class GenerationsResource {
     /**
      * Retrieve a generation
      *
-     * Includes the generated files when the generation succeeded.
+     * Returns the current Generation status. `queued` and `running` mean generation is still in
+     * progress. `succeeded` means generated files are saved, not that repository delivery or a Draft
+     * is complete. Successful results include files, or a file index when the package is too large to
+     * inline.
      * `GET /generations/{generation_id}`
      */
     retrieve(generationId: GenerationId, options?: RequestOptions): Promise<ApiResult<GenerationResponseRead, GenerationsRetrieveError>>;
     /**
      * Fetch one file from a generation
      *
-     * Raw file content, for generations whose target was too large to inline (files_omitted true).
-     * The generation's files_index lists valid paths.
+     * Returns one file's raw content. Use a path from `files_index` when the Generation reports
+     * `files_omitted: true`.
      * `GET /generations/{generation_id}/file`
      */
     retrieveFile(generationId: GenerationId, params: GenerationsRetrieveFileParams, options?: RequestOptions): Promise<ApiResult<string, GenerationsRetrieveFileError>>;
+    /** Poll until files are generated or the Generation fails. */
+    wait(generationId: GenerationId, options?: RequestOptions & {
+        intervalMs?: number;
+        waitTimeoutMs?: number;
+    }): Promise<ApiResult<GenerationResponseRead, GenerationsRetrieveError>>;
 }
 /** Every error `retrieve` can produce, as a discriminated union. */
-export type GenerationsRetrieveError = UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export type GenerationsRetrieveError = UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 export interface GenerationsRetrieveFileParams {
     /** Repo-relative path inside the generated package. */
     path: string;
 }
 /** Every error `retrieveFile` can produce, as a discriminated union. */
-export type GenerationsRetrieveFileError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
+export type GenerationsRetrieveFileError = BadRequestError | UnauthorizedError | ForbiddenError | NotFoundError | RateLimitedError | InternalServerError | UnexpectedApiError | ResponseParseError | TransportError | ValidationError;
 //# sourceMappingURL=generations.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"generations.d.ts","sourceRoot":"","sources":["../../src/resources/generations.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,YAAY,EAAsB,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE5F,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAC5C;;;;;OAKG;IACG,QAAQ,CACZ,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,sBAAsB,EAAE,wBAAwB,CAAC,CAAC;IAiBvE;;;;;;OAMG;IACG,YAAY,CAChB,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,6BAA6B,EACrC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;CAoB5D;AAED,oEAAoE;AACpE,MAAM,MAAM,wBAAwB,GAChC,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,6BAA6B;IAC5C,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wEAAwE;AACxE,MAAM,MAAM,4BAA4B,GACpC,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC"}
+{"version":3,"file":"generations.d.ts","sourceRoot":"","sources":["../../src/resources/generations.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChF,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,EAAE,YAAY,EAAsB,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE5F,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,QAAQ;IAC5C;;;;;;;;OAQG;IACG,QAAQ,CACZ,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,sBAAsB,EAAE,wBAAwB,CAAC,CAAC;IAkBvE;;;;;;OAMG;IACG,YAAY,CAChB,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,6BAA6B,EACrC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;IAsB7D,8DAA8D;IACtD,IAAI,CACR,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,cAAc,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAO,GAC7E,OAAO,CAAC,SAAS,CAAC,sBAAsB,EAAE,wBAAwB,CAAC,CAAC;CAcxE;AAED,oEAAoE;AACpE,MAAM,MAAM,wBAAwB,GAChC,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,MAAM,WAAW,6BAA6B;IAC5C,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wEAAwE;AACxE,MAAM,MAAM,4BAA4B,GACpC,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC"}

package/dist/resources/generations.js

@@ -1,6 +1,6 @@
 // typeship — generations resource.
-// Generated by typeship — https://typeship.dev — do not edit by hand.
-import { BadRequestError, ForbiddenError, NotFoundError, RateLimitedError, UnauthorizedError, } from "../errors.js";
+// Generated by typeship — https://typeship.dev
+import { BadRequestError, ForbiddenError, InternalServerError, NotFoundError, RateLimitedError, UnauthorizedError, } from "../errors.js";
 export class GenerationsResource {
     _core;
     constructor(_core) {
@@ -9,7 +9,10 @@ export class GenerationsResource {
     /**
      * Retrieve a generation
      *
-     * Includes the generated files when the generation succeeded.
+     * Returns the current Generation status. `queued` and `running` mean generation is still in
+     * progress. `succeeded` means generated files are saved, not that repository delivery or a Draft
+     * is complete. Successful results include files, or a file index when the package is too large to
+     * inline.
      * `GET /generations/{generation_id}`
      */
     async retrieve(generationId, options) {
@@ -22,6 +25,7 @@ export class GenerationsResource {
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotent: true,
             schemaKey: "generations.retrieve",
@@ -31,8 +35,8 @@ export class GenerationsResource {
     /**
      * Fetch one file from a generation
      *
-     * Raw file content, for generations whose target was too large to inline (files_omitted true).
-     * The generation's files_index lists valid paths.
+     * Returns one file's raw content. Use a path from `files_index` when the Generation reports
+     * `files_omitted: true`.
      * `GET /generations/{generation_id}/file`
      */
     async retrieveFile(generationId, params, options) {
@@ -49,10 +53,27 @@ export class GenerationsResource {
                 "403": ForbiddenError,
                 "404": NotFoundError,
                 "429": RateLimitedError,
+                "500": InternalServerError,
             },
             idempotent: true,
             schemaKey: "generations.retrieveFile",
             options,
         });
     }
+    /** Poll until files are generated or the Generation fails. */
+    async wait(generationId, options = {}) {
+        const { intervalMs = 1_000, waitTimeoutMs = 600_000, ...requestOptions } = options;
+        const deadline = Date.now() + waitTimeoutMs;
+        while (true) {
+            if (requestOptions.signal?.aborted) {
+                throw requestOptions.signal.reason ?? new Error("Generation wait aborted.");
+            }
+            const result = await this.retrieve(generationId, requestOptions);
+            if (!result.ok || (result.data.status !== "queued" && result.data.status !== "running"))
+                return result;
+            if (Date.now() >= deadline)
+                throw new Error("Timed out waiting for Generation " + generationId + ".");
+            await new Promise((resolve) => setTimeout(resolve, Math.min(intervalMs, deadline - Date.now())));
+        }
+    }
 }