image2ppt 0.5.3 → 0.7.0

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -15,10 +15,12 @@
  */
 export { DEFAULT_BASE_URL, Image2PPTClient } from "./client.js";
 export { VERSION } from "./version.js";
-export { APIConnectionError, APITimeoutError, AuthenticationError, Image2PPTError, Image2PPTTimeoutError, InsufficientCreditsError, InvalidAspectRatioError, InvalidFileError, JobAlreadyFinishedError, JobCancelledError, JobFailedError, JobNotFoundError, MalformedResponseError, MalformedUploadError, NoFilesError, NotReadyError, OutputExpiredError, PageRateExceededError, RateLimitedError, ServerError, TooManySlidesError, UploadAbortedError, } from "./errors.js";
+export { APIConnectionError, APITimeoutError, AuthenticationError, IdempotencyKeyInProgressError, IdempotencyKeyMismatchError, Image2PPTError, Image2PPTTimeoutError, InsufficientCreditsError, InvalidAspectRatioError, InvalidCallbackUrlError, InvalidFileError, InvalidIdempotencyKeyError, InvalidNameError, InvalidPagesError, InvalidParameterError, InvalidUrlError, JobAlreadyFinishedError, JobCancelledError, JobFailedError, JobNotFoundError, MalformedResponseError, MalformedUploadError, NoFilesError, NotReadyError, OutputExpiredError, PageRateExceededError, PagesOutOfRangeError, RateLimitedError, ServerError, TooManySlidesError, UploadAbortedError, UrlFetchFailedError, WebhookVerificationError, } from "./errors.js";
 export type { ErrorInit } from "./errors.js";
-export { BATCH_TARGET_BYTES, MAX_FILE_BYTES, MAX_PAGES_PER_JOB, MAX_UPLOAD_BYTES, checkFileSize, checkSubmission, planBatches, } from "./limits.js";
+export { BATCH_TARGET_BYTES, MAX_FILE_BYTES, MAX_PAGES_PER_JOB, MAX_UPLOAD_BYTES, checkFileSize, checkPageSelection, checkSubmission, planBatches, } from "./limits.js";
 export type { UploadItem } from "./limits.js";
-export { Job, PageError, PageResult } from "./types.js";
-export type { Account, AspectRatio, CancellationResult, ClientOptions, ConvertOptions, JobError, JobStatus, Locale, PageStatus, SubmitOptions, WaitOptions, } from "./types.js";
+export { CallbackStatus, Job, JobList, PageError, PageResult } from "./types.js";
+export { WebhookEvent, verifyWebhook } from "./webhook.js";
+export type { VerifyWebhookOptions, WebhookHeaders } from "./webhook.js";
+export type { Account, AspectRatio, CancellationResult, ClientOptions, ConvertAllOptions, ConvertOptions, JobError, ListJobsOptions, JobStatus, Locale, PageProgress, PageStatus, SubmitAllOptions, SubmitOptions, WaitOptions, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EACV,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,QAAQ,EACR,SAAS,EACT,MAAM,EACN,UAAU,EACV,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,6BAA6B,EAC7B,2BAA2B,EAC3B,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,0BAA0B,EAC1B,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACzE,YAAY,EACV,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,eAAe,EACf,SAAS,EACT,MAAM,EACN,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -15,7 +15,8 @@
  */
 export { DEFAULT_BASE_URL, Image2PPTClient } from "./client.js";
 export { VERSION } from "./version.js";
-export { APIConnectionError, APITimeoutError, AuthenticationError, Image2PPTError, Image2PPTTimeoutError, InsufficientCreditsError, InvalidAspectRatioError, InvalidFileError, JobAlreadyFinishedError, JobCancelledError, JobFailedError, JobNotFoundError, MalformedResponseError, MalformedUploadError, NoFilesError, NotReadyError, OutputExpiredError, PageRateExceededError, RateLimitedError, ServerError, TooManySlidesError, UploadAbortedError, } from "./errors.js";
-export { BATCH_TARGET_BYTES, MAX_FILE_BYTES, MAX_PAGES_PER_JOB, MAX_UPLOAD_BYTES, checkFileSize, checkSubmission, planBatches, } from "./limits.js";
-export { Job, PageError, PageResult } from "./types.js";
+export { APIConnectionError, APITimeoutError, AuthenticationError, IdempotencyKeyInProgressError, IdempotencyKeyMismatchError, Image2PPTError, Image2PPTTimeoutError, InsufficientCreditsError, InvalidAspectRatioError, InvalidCallbackUrlError, InvalidFileError, InvalidIdempotencyKeyError, InvalidNameError, InvalidPagesError, InvalidParameterError, InvalidUrlError, JobAlreadyFinishedError, JobCancelledError, JobFailedError, JobNotFoundError, MalformedResponseError, MalformedUploadError, NoFilesError, NotReadyError, OutputExpiredError, PageRateExceededError, PagesOutOfRangeError, RateLimitedError, ServerError, TooManySlidesError, UploadAbortedError, UrlFetchFailedError, WebhookVerificationError, } from "./errors.js";
+export { BATCH_TARGET_BYTES, MAX_FILE_BYTES, MAX_PAGES_PER_JOB, MAX_UPLOAD_BYTES, checkFileSize, checkPageSelection, checkSubmission, planBatches, } from "./limits.js";
+export { CallbackStatus, Job, JobList, PageError, PageResult } from "./types.js";
+export { WebhookEvent, verifyWebhook } from "./webhook.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,6BAA6B,EAC7B,2BAA2B,EAC3B,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,0BAA0B,EAC1B,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/limits.d.ts

@@ -1,7 +1,7 @@
 /**
  * Upload size limits and batch planning.
  *
- * The API caps the **file content of a single request** at 45MB. Going over that
+ * The API caps the **file content of a single request** at 90MB. Going over that
  * is not a friendly failure: the check can only run after the whole body has been
  * received, and the network layer in front of the API gives up on an oversized
  * request before it ever gets there — so a client that sends too much sees the
@@ -68,7 +68,7 @@ export declare function formatBytes(size: number): string;
  * Throw if one file is over the per-file cap, whatever else it travels with.
  *
  * Separate from `checkSubmission` because it is a property of the file, not of
- * the request: a 40MB PDF fits under the 45MB request cap and would sail through
+ * the request: a 40MB PDF fits under the 90MB request cap and would sail through
  * batch planning, then be rejected by the server every single time. Fail on it
  * locally instead of building a batch that can never succeed.
  *
@@ -94,12 +94,30 @@ export declare function checkFileSize(path: string, size: number): void;
  * @param imagePages Number of image files. Each is exactly 1 page.
  * @param pdfFiles Number of PDFs (or other files whose page count is unknown to
  *   the client). Each counts as at least 1 page.
- * @throws TooManySlidesError The minimum page count already exceeds what one job
- *   can hold.
+ * @param pages The `pages` selection, if any. **With a selection, the page limit
+ *   applies to the pages selected, not to the files** — 60 images with
+ *   `pages: "1-10"` is a 10-page job, and a PDF may itself run past 50 pages. See
+ *   `checkPageSelection`.
+ * @throws TooManySlidesError The page count already exceeds what one job can hold.
+ * @throws InvalidPagesError / PagesOutOfRangeError See `checkPageSelection`.
  * @throws InvalidFileError File content over the per-request cap
  *   (`code = "PAYLOAD_TOO_LARGE"`).
  */
-export declare function checkSubmission(totalBytes: number, imagePages: number, pdfFiles?: number): void;
+export declare function checkSubmission(totalBytes: number, imagePages: number, pdfFiles?: number, pages?: string | null): void;
+/**
+ * Throw if a `pages` selection is certain to be refused.
+ *
+ * Only what is certain: the spelling, page 0, a page past `totalPages` when the total
+ * is known (`undefined` when it is not — a PDF, or files behind `urls`), and more than
+ * `MAX_PAGES_PER_JOB` distinct pages selected. That last one fails whatever the files
+ * hold: either the pages exist and there are too many, or they do not. A blank or
+ * absent selection selects nothing and passes.
+ *
+ * @throws InvalidPagesError The spelling is wrong (`INVALID_PAGES`).
+ * @throws PagesOutOfRangeError Page 0, or past the known total (`PAGES_OUT_OF_RANGE`).
+ * @throws TooManySlidesError More than `MAX_PAGES_PER_JOB` pages selected.
+ */
+export declare function checkPageSelection(pages: string | null | undefined, totalPages?: number): void;
 /**
  * Split files into batches that each fit in one submission.
  *

package/dist/limits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAmB,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,QAAmB,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAS9D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,SAAI,GACX,IAAI,CAuBN;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,UAAU,EAAE,EAAE,CAsCvE"}
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAmB,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,QAAmB,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAS9D;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,SAAI,EACZ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,IAAI,CAkBN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAmB9F;AAeD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,UAAU,EAAE,EAAE,CAsCvE"}

package/dist/limits.js

@@ -1,7 +1,7 @@
 /**
  * Upload size limits and batch planning.
  *
- * The API caps the **file content of a single request** at 45MB. Going over that
+ * The API caps the **file content of a single request** at 90MB. Going over that
  * is not a friendly failure: the check can only run after the whole body has been
  * received, and the network layer in front of the API gives up on an oversized
  * request before it ever gets there — so a client that sends too much sees the
@@ -17,7 +17,8 @@
  * pages per job (`MAX_PAGES_PER_JOB`). `BATCH_TARGET_BYTES` is not a fourth cap — it
  * is how much `planBatches` puts in one batch, deliberately under the real one.
  */
-import { InvalidFileError, TooManySlidesError } from "./errors.js";
+import { InvalidFileError, PagesOutOfRangeError, TooManySlidesError } from "./errors.js";
+import { normalizePages, parsePages, selectedPageCount } from "./pages.js";
 /**
  * Server cap on **one** file. A file over this is rejected with `INVALID_FILE`
  * however it is submitted, so no amount of batching helps. Keep in sync with the
@@ -30,7 +31,7 @@ export const MAX_FILE_BYTES = 35 * 1024 * 1024;
  * (413 `PAYLOAD_TOO_LARGE`) — or, further up, cut off outright before the server can
  * answer at all. Keep in sync with the documented API contract.
  */
-export const MAX_UPLOAD_BYTES = 45 * 1024 * 1024;
+export const MAX_UPLOAD_BYTES = 90 * 1024 * 1024;
 /**
  * Byte budget for one auto-planned batch. **A splitting budget, not a cap** — the cap
  * is `MAX_UPLOAD_BYTES`, and `checkSubmission` compares against that exactly.
@@ -43,7 +44,7 @@ export const MAX_UPLOAD_BYTES = 45 * 1024 * 1024;
  * count against the published limit, and a pre-flight that "leaves room" for framing
  * just makes the documented maximum unreachable.
  */
-export const BATCH_TARGET_BYTES = 40 * 1024 * 1024;
+export const BATCH_TARGET_BYTES = 80 * 1024 * 1024;
 /**
  * Server cap on pages per job. An image is 1 page; a PDF counts as its own page
  * count. Keep in sync with the documented API contract.
@@ -52,7 +53,7 @@ export const MAX_PAGES_PER_JOB = 50;
 /** Format a byte count as MB, for human-readable error messages. */
 export function formatBytes(size) {
     // Stays honest below a megabyte. Rounding everything to MB makes a submission one
-    // byte over the cap read as "45.0MB, over the 45.0MB limit (0.0MB too much)" — a
+    // byte over the cap read as "90.0MB, over the 90.0MB limit (0.0MB too much)" — a
     // message that contradicts itself and looks like the check is broken.
     if (size < 1024)
         return `${size}B`;
@@ -64,7 +65,7 @@ export function formatBytes(size) {
  * Throw if one file is over the per-file cap, whatever else it travels with.
  *
  * Separate from `checkSubmission` because it is a property of the file, not of
- * the request: a 40MB PDF fits under the 45MB request cap and would sail through
+ * the request: a 40MB PDF fits under the 90MB request cap and would sail through
  * batch planning, then be rejected by the server every single time. Fail on it
  * locally instead of building a batch that can never succeed.
  *
@@ -96,14 +97,23 @@ export function checkFileSize(path, size) {
  * @param imagePages Number of image files. Each is exactly 1 page.
  * @param pdfFiles Number of PDFs (or other files whose page count is unknown to
  *   the client). Each counts as at least 1 page.
- * @throws TooManySlidesError The minimum page count already exceeds what one job
- *   can hold.
+ * @param pages The `pages` selection, if any. **With a selection, the page limit
+ *   applies to the pages selected, not to the files** — 60 images with
+ *   `pages: "1-10"` is a 10-page job, and a PDF may itself run past 50 pages. See
+ *   `checkPageSelection`.
+ * @throws TooManySlidesError The page count already exceeds what one job can hold.
+ * @throws InvalidPagesError / PagesOutOfRangeError See `checkPageSelection`.
  * @throws InvalidFileError File content over the per-request cap
  *   (`code = "PAYLOAD_TOO_LARGE"`).
  */
-export function checkSubmission(totalBytes, imagePages, pdfFiles = 0) {
+export function checkSubmission(totalBytes, imagePages, pdfFiles = 0, pages) {
     const minPages = imagePages + pdfFiles;
-    if (minPages > MAX_PAGES_PER_JOB) {
+    if (normalizePages(pages) !== undefined) {
+        // Without PDFs every page is an image and the total is exact; with any, it is
+        // only known server-side.
+        checkPageSelection(pages, pdfFiles ? undefined : imagePages);
+    }
+    else if (minPages > MAX_PAGES_PER_JOB) {
         const counted = pdfFiles
             ? `${imagePages} images plus ${pdfFiles} ${pdfFiles === 1 ? "PDF" : "PDFs"} ` +
                 `(at least 1 page each) is at least ${minPages} pages`
@@ -111,6 +121,37 @@ export function checkSubmission(totalBytes, imagePages, pdfFiles = 0) {
         throw new TooManySlidesError(`${counted} in one submission, over the ${MAX_PAGES_PER_JOB}-page-per-job ` +
             "limit; use submitAll() or convertAll() to split them into jobs automatically", { code: "TOO_MANY_SLIDES" });
     }
+    checkBytes(totalBytes);
+}
+/**
+ * Throw if a `pages` selection is certain to be refused.
+ *
+ * Only what is certain: the spelling, page 0, a page past `totalPages` when the total
+ * is known (`undefined` when it is not — a PDF, or files behind `urls`), and more than
+ * `MAX_PAGES_PER_JOB` distinct pages selected. That last one fails whatever the files
+ * hold: either the pages exist and there are too many, or they do not. A blank or
+ * absent selection selects nothing and passes.
+ *
+ * @throws InvalidPagesError The spelling is wrong (`INVALID_PAGES`).
+ * @throws PagesOutOfRangeError Page 0, or past the known total (`PAGES_OUT_OF_RANGE`).
+ * @throws TooManySlidesError More than `MAX_PAGES_PER_JOB` pages selected.
+ */
+export function checkPageSelection(pages, totalPages) {
+    const selection = normalizePages(pages);
+    if (selection === undefined)
+        return;
+    const ranges = parsePages(selection);
+    if (totalPages !== undefined && Math.max(...ranges.map(([, end]) => end)) > totalPages) {
+        throw new PagesOutOfRangeError(`pages ${JSON.stringify(selection)} goes past the end of the submission, which has ` +
+            `${totalPages} ${totalPages === 1 ? "page" : "pages"}`, { code: "PAGES_OUT_OF_RANGE" });
+    }
+    const selected = selectedPageCount(ranges);
+    if (selected > MAX_PAGES_PER_JOB) {
+        throw new TooManySlidesError(`pages ${JSON.stringify(selection)} selects ${selected} pages, over the ` +
+            `${MAX_PAGES_PER_JOB}-page-per-job limit`, { code: "TOO_MANY_SLIDES" });
+    }
+}
+function checkBytes(totalBytes) {
     if (totalBytes > MAX_UPLOAD_BYTES) {
         throw new InvalidFileError(`these files add up to ${formatBytes(totalBytes)}, over the ` +
             `${formatBytes(MAX_UPLOAD_BYTES)} of file content one request may carry ` +

package/dist/limits.js.map

@@ -1 +1 @@
-{"version":3,"file":"limits.js","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../src/limits.ts"],"names":[],"mappings":"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"}

package/dist/pages.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Local reading of the `pages` selection, e.g. `"1-3, 7"`.
+ *
+ * The API picks pages out of the whole submission laid end to end (an image is one
+ * page, a PDF is its own page count). This module only answers what can be known
+ * without the files: whether the spelling is valid, and how many pages it selects.
+ *
+ * **It must never refuse a selection the API would accept.** Every rule here is the
+ * contract's, and every one is pinned identically in the Python client, so a
+ * selection means the same thing to both. Digits are ASCII only.
+ */
+/**
+ * Longest `pages` value the API accepts. Measured in UTF-16 units here and in
+ * characters by the Python client; the two only differ for characters outside the
+ * Basic Multilingual Plane, and any such character is a spelling error on both sides
+ * anyway.
+ */
+export declare const MAX_PAGES_LENGTH = 1000;
+export type PageRanges = Array<[number, number]>;
+/** Whether `text` is empty once surrounding whitespace is removed. */
+export declare function isBlank(text: string): boolean;
+/**
+ * Return `pages` if it selects anything, or undefined when it counts as not given.
+ *
+ * `undefined`, `null`, an empty string, and a string of nothing but whitespace all
+ * mean "no selection" to the service, so none of them is sent. Anything but a string
+ * is a caller mistake: sent as a form field it would silently become text, and in a
+ * JSON body it would be refused — the same call behaving two different ways.
+ */
+export declare function normalizePages(pages: unknown): string | undefined;
+/**
+ * Parse a non-empty selection into `[start, end]` ranges, as written.
+ *
+ * @throws InvalidPagesError The spelling is wrong (`INVALID_PAGES`). Every token is
+ *   checked for spelling before any range is, so `"0,abc"` is a spelling error, as it
+ *   is to the service.
+ * @throws PagesOutOfRangeError A page number is 0 (`PAGES_OUT_OF_RANGE`).
+ */
+export declare function parsePages(pages: string): PageRanges;
+/**
+ * How many distinct pages the ranges select, overlaps counted once.
+ *
+ * Counted by merging, never by expanding: `"1-1000000000000"` is a valid spelling,
+ * and listing it out would be a very long wait for the answer "too many".
+ */
+export declare function selectedPageCount(ranges: PageRanges): number;
+//# sourceMappingURL=pages.d.ts.map

package/dist/pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../src/pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAIrC,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjD,sEAAsE;AACtE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMjE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAgCpD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAS5D"}

package/dist/pages.js

@@ -0,0 +1,90 @@
+/**
+ * Local reading of the `pages` selection, e.g. `"1-3, 7"`.
+ *
+ * The API picks pages out of the whole submission laid end to end (an image is one
+ * page, a PDF is its own page count). This module only answers what can be known
+ * without the files: whether the spelling is valid, and how many pages it selects.
+ *
+ * **It must never refuse a selection the API would accept.** Every rule here is the
+ * contract's, and every one is pinned identically in the Python client, so a
+ * selection means the same thing to both. Digits are ASCII only.
+ */
+import { InvalidPagesError, PagesOutOfRangeError } from "./errors.js";
+/**
+ * Longest `pages` value the API accepts. Measured in UTF-16 units here and in
+ * characters by the Python client; the two only differ for characters outside the
+ * Basic Multilingual Plane, and any such character is a spelling error on both sides
+ * anyway.
+ */
+export const MAX_PAGES_LENGTH = 1000;
+const TOKEN = /^(\d+)(?:\s*-\s*(\d+))?$/;
+/** Whether `text` is empty once surrounding whitespace is removed. */
+export function isBlank(text) {
+    return text.trim() === "";
+}
+/**
+ * Return `pages` if it selects anything, or undefined when it counts as not given.
+ *
+ * `undefined`, `null`, an empty string, and a string of nothing but whitespace all
+ * mean "no selection" to the service, so none of them is sent. Anything but a string
+ * is a caller mistake: sent as a form field it would silently become text, and in a
+ * JSON body it would be refused — the same call behaving two different ways.
+ */
+export function normalizePages(pages) {
+    if (pages == null)
+        return undefined;
+    if (typeof pages !== "string") {
+        throw new TypeError(`pages must be a string like '1-3,7', not ${typeof pages}`);
+    }
+    return isBlank(pages) ? undefined : pages;
+}
+/**
+ * Parse a non-empty selection into `[start, end]` ranges, as written.
+ *
+ * @throws InvalidPagesError The spelling is wrong (`INVALID_PAGES`). Every token is
+ *   checked for spelling before any range is, so `"0,abc"` is a spelling error, as it
+ *   is to the service.
+ * @throws PagesOutOfRangeError A page number is 0 (`PAGES_OUT_OF_RANGE`).
+ */
+export function parsePages(pages) {
+    // Measured after trimming: surrounding whitespace is not part of the value.
+    const length = pages.trim().length;
+    if (length > MAX_PAGES_LENGTH) {
+        throw new InvalidPagesError(`pages is ${length} characters long, over the ${MAX_PAGES_LENGTH} allowed`, { code: "INVALID_PAGES" });
+    }
+    const ranges = [];
+    for (const rawToken of pages.split(",")) {
+        const match = TOKEN.exec(rawToken.trim());
+        const start = match ? Number(match[1]) : 0;
+        const end = match && match[2] !== undefined ? Number(match[2]) : start;
+        // 2**53 - 1 is the largest page number the API accepts; past it the answer is
+        // INVALID_PAGES, not an out-of-range page — so it is here too.
+        if (!match || !Number.isSafeInteger(start) || !Number.isSafeInteger(end) || start > end) {
+            throw new InvalidPagesError(`pages ${JSON.stringify(pages)} is not a valid selection: write single pages or ` +
+                "start-end ranges separated by commas, e.g. '1-3, 7'", { code: "INVALID_PAGES" });
+        }
+        ranges.push([start, end]);
+    }
+    if (ranges.some(([start]) => start < 1)) {
+        throw new PagesOutOfRangeError(`pages ${JSON.stringify(pages)} selects page 0; pages are numbered from 1`, { code: "PAGES_OUT_OF_RANGE" });
+    }
+    return ranges;
+}
+/**
+ * How many distinct pages the ranges select, overlaps counted once.
+ *
+ * Counted by merging, never by expanding: `"1-1000000000000"` is a valid spelling,
+ * and listing it out would be a very long wait for the answer "too many".
+ */
+export function selectedPageCount(ranges) {
+    let count = 0;
+    let coveredTo = 0;
+    for (const [start, end] of [...ranges].sort((a, b) => a[0] - b[0] || a[1] - b[1])) {
+        if (end <= coveredTo)
+            continue;
+        count += end - Math.max(start, coveredTo + 1) + 1;
+        coveredTo = end;
+    }
+    return count;
+}
+//# sourceMappingURL=pages.js.map

package/dist/pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../src/pages.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -11,6 +11,26 @@ export type JobStatus = "pending" | "processing" | "completed" | "failed";
  * would be worse than seeing it.
  */
 export type PageStatus = "converted" | "failed";
+/**
+ * A response envelope as an object, with every field the contract guarantees.
+ *
+ * One helper for all three envelopes — a job, a cancellation result, a page entry.
+ * The check used to be hand-written at each of them, and the copies drifted apart
+ * from each other and from the Python client's, which is exactly the kind of
+ * disagreement two clients for one API cannot afford.
+ *
+ * **A field counts as missing when the key is absent or its value is null.** The
+ * two mean the same thing to a caller: there is no value to act on.
+ *
+ * The test is `== null`, which catches null and undefined and nothing else. A
+ * falsiness test would look almost identical and be wrong: `cancellationRequested`
+ * and `finalizing` are booleans whose `false` is a real answer the service sends,
+ * and rejecting it would fail the response that says "no, the job is not still
+ * winding down".
+ *
+ * `what` names the envelope for the message ("job response").
+ */
+export declare function isJsonObject(value: unknown): value is Record<string, any>;
 export interface JobError {
     /**
      * Job-level failure reason: `JOB_CANCELLED` or `CONVERSION_FAILED`.
@@ -55,7 +75,12 @@ export declare class PageError {
 }
 /** What happened to one page of the deck. */
 export declare class PageResult {
-    /** 1-based, in the order the pages were submitted (a PDF follows its own page order). */
+    /**
+     * 1-based, and counts **pages of the delivered deck**. Without `pages` that is the
+     * order the files were submitted in (a PDF follows its own page order). With
+     * `pages` it is the k-th *selected* page, not the page number you selected:
+     * `pages: "3,7"` gives entries 1 and 2.
+     */
     readonly pageNumber: number;
     /** `converted` or `failed`; an unrecognised value is passed through as-is. */
     readonly status: PageStatus;
@@ -115,7 +140,10 @@ export interface ClientOptions {
      */
     warnOnDeprecated?: boolean;
 }
-export interface SubmitOptions {
+/** Options every kind of submission takes, including the batch calls. */
+export interface SubmitAllOptions {
+    /** Task and download filename without `.pptx`; the service resolves collisions. */
+    name?: string;
     /**
      * Language of the **generated deck**: `zh-CN` (default) or `en`.
      *
@@ -125,14 +153,63 @@ export interface SubmitOptions {
     locale?: Locale;
     /** `auto` (default) / `16:9` / `4:3`. */
     aspectRatio?: AspectRatio;
+    /**
+     * An `https` URL the service POSTs to when the job ends. Check each delivery with
+     * `verifyWebhook`. With `submitAll`, every batch's job calls it.
+     */
+    callbackUrl?: string;
+}
+/**
+ * Options for one submission (`submit`, `submitUrls`, `convert`).
+ *
+ * `pages` and `idempotencyKey` exist only here, not on `SubmitAllOptions`: page
+ * numbers run across one submission and a key names one job, so neither can span
+ * the several batches `submitAll` makes.
+ */
+export interface SubmitOptions extends SubmitAllOptions {
+    /**
+     * Convert only these pages, e.g. `"1-3, 7"`. Page numbers run across the whole
+     * submission in order — an image is one page, a PDF its page count — so with a
+     * single PDF they are the PDF's own. Only the selected pages are charged and count
+     * towards the 50-page limit; the PDF itself may be longer.
+     */
+    pages?: string;
+    /**
+     * 1–255 printable ASCII characters. Default: a random UUID per call. Pass your own
+     * to make resubmitting safe across calls or processes — e.g. an id from your own
+     * database.
+     */
+    idempotencyKey?: string;
 }
 export interface WaitOptions {
     /** Initial poll interval in ms (default 5000), backs off to 15000. */
     pollIntervalMs?: number;
     /** Overall wait cap in ms (default 1_800_000 = 30 min). */
     timeoutMs?: number;
+    /**
+     * Called as `onProgress(job, elapsedMs)` after every successful poll, the final
+     * one included — so a completed job reports `progress === 100` before `wait`
+     * resolves. `job` is the fresh snapshot (`job.progress` is 0–100, or `null` if
+     * the service did not report it); `elapsedMs` is milliseconds since this `wait`
+     * call started. Polls that failed and are being retried do not call it. A
+     * returned promise is awaited before the next poll; anything it throws (or
+     * rejects with) ends the wait. In `convertAll` it is called for each job in turn
+     * — tell them apart by `job.jobId`; `elapsedMs` restarts at zero for each job.
+     */
+    onProgress?: (job: Job, elapsedMs: number) => void | Promise<void>;
 }
 export type ConvertOptions = SubmitOptions & WaitOptions;
+export type ConvertAllOptions = SubmitAllOptions & WaitOptions;
+export interface ListJobsOptions {
+    /** `YYYY-MM-DD` in UTC, inclusive. */
+    createdFrom?: string;
+    /** `YYYY-MM-DD` in UTC, inclusive. */
+    createdTo?: string;
+    /** Jobs per page, 1–100 (default 20). */
+    limit?: number;
+    /** `nextCursor` from the previous page, passed back unchanged. */
+    cursor?: string;
+}
 export interface Account {
     email: string;
     credits: number;
@@ -175,9 +252,53 @@ export interface CancellationResult {
  *   costs nothing, and `getJob` is the authority on when the job is really terminal.
  */
 export declare function parseCancellationResult(data: unknown): CancellationResult;
+/** A whole number: `3` and `3.0` count, `"3"`, `true` and `1.5` do not. */
+export declare function wholeNumber(value: unknown): number | null;
+/** How far one page has got while the job is still running. */
+export interface PageProgress {
+    /** 1-based, numbered like `PageResult.pageNumber`. */
+    readonly pageNumber: number;
+    /** 0–100. */
+    readonly progress: number;
+    /**
+     * A short human-readable line about what the page is doing right now, in the
+     * language of the client's `acceptLanguage` (English by default), or `null`.
+     * Show it as-is; its wording changes as the service changes, so never branch
+     * on it.
+     */
+    readonly stepLabel: string | null;
+}
+/**
+ * How delivering the completion callback is going (only for jobs submitted with
+ * `callbackUrl`).
+ *
+ * `status` is `pending` (the job has not finished, or the next attempt is
+ * scheduled), `delivered`, or `failed` (all 6 attempts failed; no more retries).
+ * `lastResponseStatus` is `null` for a network error or timeout. Times are
+ * `YYYY-MM-DD HH:MM:SS` in UTC, or `null`.
+ *
+ * Read leniently, like `PageError`: this is a report on a side channel, and a
+ * surprise inside it should not cost you the job it is attached to. A field of the
+ * wrong type reads as `null`; the original is on `raw`.
+ */
+export declare class CallbackStatus {
+    readonly url: string | null;
+    /** `pending` | `delivered` | `failed`. */
+    readonly status: string | null;
+    readonly attempts: number | null;
+    readonly lastAttemptAt: string | null;
+    readonly lastResponseStatus: number | null;
+    readonly nextAttemptAt: string | null;
+    readonly raw: Record<string, unknown>;
+    constructor(data: Record<string, unknown>);
+    /** Build it from a `callback` value, or return null for anything but an object. */
+    static fromJson(value: unknown): CallbackStatus | null;
+}
 /** A snapshot of a conversion job's state. */
 export declare class Job {
     readonly jobId: string;
+    /** Current resolved task name, or null when an older server does not send it. */
+    readonly name: string | null;
     readonly status: JobStatus;
     readonly slideCount: number | null;
     readonly progress: number | null;
@@ -215,6 +336,27 @@ export declare class Job {
      * which is the confusion `null` exists to prevent.
      */
     readonly pageResults: PageResult[] | null;
+    /** Delivery of the completion callback; `null` unless submitted with `callbackUrl`. */
+    readonly callback: CallbackStatus | null;
+    /**
+     * True when `submit` got this job back from an earlier request with the same
+     * `Idempotency-Key` (response header `Idempotent-Replayed: true`) instead of
+     * creating it now. Nothing was charged for the replay. Set by the client after
+     * construction, since it comes from a header rather than the body.
+     */
+    replayed: boolean;
+    /**
+     * While the job runs: seconds the service expects it still needs. `null` while
+     * no estimate is available yet, and once the job has ended.
+     */
+    readonly estimatedRemainingSeconds: number | null;
+    /** Jobs ahead of this one while it waits to start; `null` once it is running. */
+    readonly queueAhead: number | null;
+    /**
+     * Per-page progress while the job is `pending` / `processing`, one entry per
+     * page; `null` otherwise. `progress` is the whole job's figure.
+     */
+    readonly pageProgress: PageProgress[] | null;
     /** Raw response body, for forward-compatible access to new fields. */
     readonly raw: Record<string, unknown>;
     constructor(data: Record<string, unknown>);
@@ -226,4 +368,23 @@ export declare class Job {
     get isTerminal(): boolean;
     static fromJson(data: Record<string, unknown>): Job;
 }
+/**
+ * One page of `listJobs`: API-submitted jobs, newest first.
+ *
+ * Each job in `data` has the same shape as `getJob` returns, minus `pageResults`.
+ * `nextCursor` is `null` on the last page; otherwise pass it back as `cursor`
+ * unchanged. For reconciliation, add up each job's `creditsUsed` (charged) and
+ * `creditsRefunded`.
+ */
+export declare class JobList {
+    readonly data: Job[];
+    readonly nextCursor: string | null;
+    readonly raw: Record<string, unknown>;
+    /**
+     * `nextCursor` that is missing or not a string reads as the last page: an
+     * unreadable cursor could not be passed back anyway, and stopping is the answer
+     * that cannot loop forever.
+     */
+    constructor(data: unknown);
+}
 //# sourceMappingURL=types.d.ts.map