image2ppt 0.5.3

package/dist/limits.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,229 @@
+/** Shared types and the Job model. */
+export type Locale = "zh-CN" | "en";
+export type AspectRatio = "auto" | "16:9" | "4:3";
+export type JobStatus = "pending" | "processing" | "completed" | "failed";
+/**
+ * Outcome of a single page. `converted`: it became editable content.
+ * `failed`: it did not.
+ *
+ * A value this client does not recognise is passed through as it arrives rather
+ * than being folded into one of these — the service may add one, and losing it
+ * would be worse than seeing it.
+ */
+export type PageStatus = "converted" | "failed";
+export interface JobError {
+    /**
+     * Job-level failure reason: `JOB_CANCELLED` or `CONVERSION_FAILED`.
+     *
+     * These two are the whole set and are meant to stay that way — the finer
+     * reasons live per page, in `pageResults`. Treat a code you do not recognise
+     * as `CONVERSION_FAILED`.
+     */
+    code: string;
+    /**
+     * A sentence written for a person to read. Its language follows the client's
+     * `acceptLanguage` option. **Do not branch on it** — branch on `code`.
+     */
+    message: string;
+}
+/** Why one page did not convert. */
+export declare class PageError {
+    /**
+     * Per-page failure reason. The contract's set is exactly `CONVERSION_FAILED`,
+     * `CONVERSION_TIMEOUT` and `PAGE_NOT_ATTEMPTED`; treat anything else as
+     * `CONVERSION_FAILED`.
+     *
+     * `PAGE_NOT_ATTEMPTED` is the one that changes what you do. That page never
+     * started and **is not in the delivered deck at all**. Every other failed page
+     * *is* in the deck — as the original image, not as editable content.
+     */
+    readonly code: string;
+    /**
+     * A sentence written for a person to read, in the language asked for by the
+     * client's `acceptLanguage`. **Do not branch on it** — branch on `code`.
+     */
+    readonly message: string;
+    /**
+     * Whether submitting the same image again could succeed. Every code the
+     * service returns today says true, but **branch on this field rather than
+     * hardcoding it**: a code added later may carry false.
+     */
+    readonly retryable: boolean;
+    /** Raw entry, for forward-compatible access to fields added later. */
+    readonly raw: Record<string, unknown>;
+    constructor(data: Record<string, unknown>);
+}
+/** 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). */
+    readonly pageNumber: number;
+    /** `converted` or `failed`; an unrecognised value is passed through as-is. */
+    readonly status: PageStatus;
+    /** Present only when `status` is `failed`. */
+    readonly error?: PageError;
+    /** Raw entry, for forward-compatible access to fields added later. */
+    readonly raw: Record<string, unknown>;
+    constructor(data: Record<string, unknown>);
+}
+export interface ClientOptions {
+    /** Your API key (looks like `i2p_live_...`). */
+    apiKey: string;
+    /** Service base URL, defaults to `https://image2ppt.com`. */
+    baseUrl?: string;
+    /**
+     * How long one request may sit with **no data moving**, in ms (default 60000).
+     *
+     * An idle timeout, not a cap on how long a request may take: a 40MB upload or a
+     * large PPTX download that keeps making progress is never cut off, however long
+     * it runs in total. The clock only starts when nothing has been sent or received.
+     * Nothing at all for this long — including waiting for a response that never
+     * begins — throws `APITimeoutError`.
+     *
+     * This is one HTTP request, not the whole-job wait; that one is `WaitOptions`.
+     */
+    timeoutMs?: number;
+    /** Inject a custom fetch (for testing). Defaults to the global `fetch` (Node 18+). */
+    fetch?: typeof fetch;
+    /**
+     * Language for the **error messages** the service sends back, as an
+     * `Accept-Language` header value (e.g. `"zh-CN"`, `"fr, en;q=0.8"`). Sent
+     * verbatim on every request. Unset by default, and then no header is sent at
+     * all — which the service answers in English.
+     *
+     * **This is not `SubmitOptions.locale`, and the two are easy to confuse.**
+     * `locale` decides what language the generated PPTX is written in.
+     * `acceptLanguage` decides what language a failure is explained to *you* in.
+     * They are unrelated: you can ask for an English deck and Chinese errors. That
+     * is also why this is a free-form string rather than the `Locale` union — it is
+     * an HTTP header value, and the header's own syntax (several languages, quality
+     * weights) is what belongs in it.
+     *
+     * Either way, branch on `code`, never on `message`.
+     */
+    acceptLanguage?: string;
+    /**
+     * Total ms `submitAll` / `convertAll` may spend **waiting out rate limits** across
+     * the whole call (default 1_800_000 = 30 min). Only waiting counts against it — the
+     * time the uploads themselves take does not, so a slow link cannot quietly turn this
+     * into "do not wait at all". Submitting a large pile *will* hit the per-minute page
+     * quota, so waiting is the normal path, not an error.
+     */
+    rateLimitMaxWaitMs?: number;
+    /**
+     * When the service marks this SDK version deprecated, `console.warn` once.
+     * Default true. Set to false to silence it.
+     */
+    warnOnDeprecated?: boolean;
+}
+export interface SubmitOptions {
+    /**
+     * Language of the **generated deck**: `zh-CN` (default) or `en`.
+     *
+     * Not to be confused with the client-level `acceptLanguage`, which only sets
+     * what language error messages come back in.
+     */
+    locale?: Locale;
+    /** `auto` (default) / `16:9` / `4:3`. */
+    aspectRatio?: AspectRatio;
+}
+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;
+}
+export type ConvertOptions = SubmitOptions & WaitOptions;
+export interface Account {
+    email: string;
+    credits: number;
+}
+/**
+ * Result of requesting graceful cancellation for a conversion job.
+ *
+ * Cancellation is a graceful drain, not a hard stop: pages already running finish
+ * and are billed if they succeed, and **a page being dispatched at the very moment
+ * the request arrives may still run to completion and be billed** too. Pages that
+ * have not started are skipped and refunded. Repeating the call is safe.
+ */
+export interface CancellationResult {
+    readonly jobId: string;
+    /** Whether the service accepted the cancellation request. */
+    readonly cancellationRequested: boolean;
+    /** True while the job is still winding down; keep polling `getJob` until terminal. */
+    readonly finalizing: boolean;
+}
+/**
+ * Read the three documented fields of a cancellation response.
+ *
+ * `CancellationResult` is an interface, so this is the shape check its two class
+ * siblings get in their constructors. Casting the body through instead would hand
+ * back `finalizing: undefined`, which reads as "settled" and stops a caller polling
+ * a job that is still draining.
+ *
+ * `false` is a real answer for both booleans and passes — see `requireFields`.
+ *
+ * Both are read by **identity, never truthiness** — the rule `PageError.retryable`
+ * already reads by. `[]` is truthy in JavaScript and falsy in Python, so a coerced
+ * field meant opposite things to the two clients for one API. Identity is the same
+ * test in both, and each field falls to the side that costs the caller nothing when
+ * the value cannot be read — which is why the two comparisons point opposite ways:
+ *
+ * - `cancellationRequested` needs a real `true`. Claiming a cancellation the service
+ *   never accepted is the expensive mistake; repeating the call is safe.
+ * - `finalizing` needs a real `false` to mean settled — otherwise an unreadable
+ *   value ends the wait exactly as the cast described above would. One more poll
+ *   costs nothing, and `getJob` is the authority on when the job is really terminal.
+ */
+export declare function parseCancellationResult(data: unknown): CancellationResult;
+/** A snapshot of a conversion job's state. */
+export declare class Job {
+    readonly jobId: string;
+    readonly status: JobStatus;
+    readonly slideCount: number | null;
+    readonly progress: number | null;
+    readonly creditsReserved: number | null;
+    readonly creditsUsed: number | null;
+    readonly creditsRefunded: number | null;
+    readonly createdAt: string | null;
+    readonly completedAt: string | null;
+    /** Optional in the public shape so pre-cancellation structural `Job` values still type-check. */
+    readonly cancellationRequested?: boolean;
+    readonly downloadUrl: string | null;
+    readonly error: JobError | null;
+    /**
+     * Per-page outcome, in page order, `slideCount` entries long — or `null`.
+     *
+     * That shape is what the API documents, and this client passes the ledger
+     * through as it arrived rather than cross-checking it against `slideCount`.
+     * Refusing a job over a ledger that did not add up would cost the caller a deck
+     * they can actually download, which is the worse trade. Check the length
+     * yourself if your own logic depends on it.
+     *
+     * `null` means the service did not send the field, which is a different fact
+     * from an empty array and must not be confused with one. It is absent while the
+     * job is still running (mid-run, "this page failed" and "this page has not had
+     * its turn" cannot be told apart), and absent for an early job that has no
+     * per-page record at all.
+     *
+     * `creditsRefunded` says how many pages did not convert; this says **which**,
+     * and whether each one still made it into the deck as its original image. See
+     * `PageError.code`.
+     *
+     * Declared required rather than optional (unlike `cancellationRequested`)
+     * precisely because absence is meaningful here: a third `undefined` state would
+     * make "the service didn't say" and "nobody filled this in" indistinguishable,
+     * which is the confusion `null` exists to prevent.
+     */
+    readonly pageResults: PageResult[] | null;
+    /** Raw response body, for forward-compatible access to new fields. */
+    readonly raw: Record<string, unknown>;
+    constructor(data: Record<string, unknown>);
+    /** Whether the job finished successfully (deliverable downloadable). */
+    get isCompleted(): boolean;
+    /** Whether the job failed. */
+    get isFailed(): boolean;
+    /** Whether the job reached a terminal state (completed or failed). */
+    get isTerminal(): boolean;
+    static fromJson(data: Record<string, unknown>): Job;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,256 @@
+/** Shared types and the Job model. */
+import { MalformedResponseError } from "./errors.js";
+/**
+ * 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").
+ */
+function isJsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requireFields(data, keys, what) {
+    if (!isJsonObject(data)) {
+        throw new MalformedResponseError(`malformed ${what}, expected a JSON object`);
+    }
+    const d = data;
+    for (const key of keys) {
+        if (d[key] == null) {
+            throw new MalformedResponseError(`malformed ${what}, missing ${key}`);
+        }
+    }
+    return d;
+}
+/** Why one page did not convert. */
+export class PageError {
+    /**
+     * Per-page failure reason. The contract's set is exactly `CONVERSION_FAILED`,
+     * `CONVERSION_TIMEOUT` and `PAGE_NOT_ATTEMPTED`; treat anything else as
+     * `CONVERSION_FAILED`.
+     *
+     * `PAGE_NOT_ATTEMPTED` is the one that changes what you do. That page never
+     * started and **is not in the delivered deck at all**. Every other failed page
+     * *is* in the deck — as the original image, not as editable content.
+     */
+    code;
+    /**
+     * A sentence written for a person to read, in the language asked for by the
+     * client's `acceptLanguage`. **Do not branch on it** — branch on `code`.
+     */
+    message;
+    /**
+     * Whether submitting the same image again could succeed. Every code the
+     * service returns today says true, but **branch on this field rather than
+     * hardcoding it**: a code added later may carry false.
+     */
+    retryable;
+    /** Raw entry, for forward-compatible access to fields added later. */
+    raw;
+    constructor(data) {
+        const d = data;
+        // Lenient on purpose: `pageResults` reports what went wrong, and a gap in the
+        // report is not itself worth turning into a thrown error the caller has to
+        // handle. Every rule below is pinned identically in the Python client — one
+        // body must not mean two different things depending on which SDK read it.
+        //
+        // A code has to be a non-empty string. An empty one names no failure, so it
+        // falls back the same way an unrecognised one does, which is the contract's
+        // own instruction to callers.
+        this.code = typeof d.code === "string" && d.code !== "" ? d.code : "CONVERSION_FAILED";
+        // A message has to be a string. A number is not turned into one: `42` is not a
+        // sentence anybody wants to show a person.
+        this.message = typeof d.message === "string" ? d.message : "";
+        // A real boolean, never truthiness. A flag we cannot read is not a licence to
+        // re-upload, so anything else — a missing field included — is false: telling a
+        // caller "try this page again" on a guess costs them credits, telling them
+        // "don't" costs them nothing they cannot recover by asking again themselves.
+        this.retryable = d.retryable === true;
+        this.raw = data;
+    }
+}
+/** What happened to one page of the deck. */
+export class PageResult {
+    /** 1-based, in the order the pages were submitted (a PDF follows its own page order). */
+    pageNumber;
+    /** `converted` or `failed`; an unrecognised value is passed through as-is. */
+    status;
+    /** Present only when `status` is `failed`. */
+    error;
+    /** Raw entry, for forward-compatible access to fields added later. */
+    raw;
+    constructor(data) {
+        // `pageNumber` and `status` are guaranteed by the contract and are the two
+        // fields a caller has to have: without them an entry says nothing about which
+        // page it is or how that page ended. Their *types* are checked too rather than
+        // cast through — a page number of `"3"` would otherwise be quietly converted,
+        // covering up a wrong type instead of reporting it.
+        const d = requireFields(data, ["pageNumber", "status"], "pageResults entry");
+        // A whole number, not merely a finite one: pages are counted, and `1.5` names
+        // no page. `Number.isInteger` also rejects a numeric *string*, which is the
+        // half of this the Python client had to be brought into line with.
+        if (!Number.isInteger(d.pageNumber)) {
+            throw new MalformedResponseError(`malformed pageResults entry, pageNumber is not a number: ${JSON.stringify(d.pageNumber)}`);
+        }
+        if (typeof d.status !== "string") {
+            throw new MalformedResponseError(`malformed pageResults entry, status is not a string: ${JSON.stringify(d.status)}`);
+        }
+        this.pageNumber = d.pageNumber;
+        this.status = d.status;
+        // An `error` that is present but is not an object says nothing this model could
+        // report, so it reads as absent rather than throwing: the entry itself is what
+        // the contract guarantees, and a surprise *inside* `error` should not cost the
+        // caller the rest of the ledger. Building a fully-defaulted `PageError` from it
+        // instead would put a `CONVERSION_FAILED` on the page that nobody sent.
+        this.error = isJsonObject(d.error) ? new PageError(d.error) : undefined;
+        this.raw = data;
+    }
+}
+/**
+ * Read the three documented fields of a cancellation response.
+ *
+ * `CancellationResult` is an interface, so this is the shape check its two class
+ * siblings get in their constructors. Casting the body through instead would hand
+ * back `finalizing: undefined`, which reads as "settled" and stops a caller polling
+ * a job that is still draining.
+ *
+ * `false` is a real answer for both booleans and passes — see `requireFields`.
+ *
+ * Both are read by **identity, never truthiness** — the rule `PageError.retryable`
+ * already reads by. `[]` is truthy in JavaScript and falsy in Python, so a coerced
+ * field meant opposite things to the two clients for one API. Identity is the same
+ * test in both, and each field falls to the side that costs the caller nothing when
+ * the value cannot be read — which is why the two comparisons point opposite ways:
+ *
+ * - `cancellationRequested` needs a real `true`. Claiming a cancellation the service
+ *   never accepted is the expensive mistake; repeating the call is safe.
+ * - `finalizing` needs a real `false` to mean settled — otherwise an unreadable
+ *   value ends the wait exactly as the cast described above would. One more poll
+ *   costs nothing, and `getJob` is the authority on when the job is really terminal.
+ */
+export function parseCancellationResult(data) {
+    const d = requireFields(data, ["jobId", "cancellationRequested", "finalizing"], "cancellation response");
+    return {
+        jobId: d.jobId,
+        cancellationRequested: d.cancellationRequested === true,
+        finalizing: d.finalizing !== false,
+    };
+}
+/**
+ * `pageResults` as a list, or `null` when the response did not carry the field.
+ *
+ * The `?? null` the other optional Job fields use, except that a value which *is*
+ * there has to be the shape the contract promises — an array of entries — because
+ * unlike a missing credit count, a mangled ledger would be read as a real answer
+ * about which pages made it into the deck.
+ */
+function parsePageResults(value) {
+    if (value == null)
+        return null;
+    if (!Array.isArray(value)) {
+        throw new MalformedResponseError("malformed job response, pageResults is not a list");
+    }
+    return value.map((entry) => new PageResult(entry));
+}
+/** A snapshot of a conversion job's state. */
+export class Job {
+    jobId;
+    status;
+    slideCount;
+    progress;
+    creditsReserved;
+    creditsUsed;
+    creditsRefunded;
+    createdAt;
+    completedAt;
+    /** Optional in the public shape so pre-cancellation structural `Job` values still type-check. */
+    cancellationRequested;
+    downloadUrl;
+    error;
+    /**
+     * Per-page outcome, in page order, `slideCount` entries long — or `null`.
+     *
+     * That shape is what the API documents, and this client passes the ledger
+     * through as it arrived rather than cross-checking it against `slideCount`.
+     * Refusing a job over a ledger that did not add up would cost the caller a deck
+     * they can actually download, which is the worse trade. Check the length
+     * yourself if your own logic depends on it.
+     *
+     * `null` means the service did not send the field, which is a different fact
+     * from an empty array and must not be confused with one. It is absent while the
+     * job is still running (mid-run, "this page failed" and "this page has not had
+     * its turn" cannot be told apart), and absent for an early job that has no
+     * per-page record at all.
+     *
+     * `creditsRefunded` says how many pages did not convert; this says **which**,
+     * and whether each one still made it into the deck as its original image. See
+     * `PageError.code`.
+     *
+     * Declared required rather than optional (unlike `cancellationRequested`)
+     * precisely because absence is meaningful here: a third `undefined` state would
+     * make "the service didn't say" and "nobody filled this in" indistinguishable,
+     * which is the confusion `null` exists to prevent.
+     */
+    pageResults;
+    /** Raw response body, for forward-compatible access to new fields. */
+    raw;
+    constructor(data) {
+        // The contract guarantees `jobId` and `status`, and a job without them is not a
+        // job: a snapshot with either one undefined used to sail through here, and
+        // `wait()` would then poll that nonsense object until its half-hour deadline ran
+        // out. The same standard `cancel()` has always held its own response to — which
+        // is why all three envelopes now go through one check.
+        const d = requireFields(data, ["jobId", "status"], "job response");
+        this.jobId = d.jobId;
+        this.status = d.status;
+        this.slideCount = d.slideCount ?? null;
+        this.progress = d.progress ?? null;
+        this.creditsReserved = d.creditsReserved ?? null;
+        this.creditsUsed = d.creditsUsed ?? null;
+        this.creditsRefunded = d.creditsRefunded ?? null;
+        this.createdAt = d.createdAt ?? null;
+        this.completedAt = d.completedAt ?? null;
+        // Identity, not `?? false` and not `Boolean(...)`: the field is declared
+        // `boolean`, and coercing it left the two clients reading the same malformed
+        // body differently, because `[]` is truthy in JavaScript and falsy in Python.
+        // `true` is the only value that says the service accepted a cancellation. See
+        // `parseCancellationResult` for why the envelope's `finalizing` compares the
+        // other way round.
+        this.cancellationRequested = d.cancellationRequested === true;
+        this.downloadUrl = d.downloadUrl ?? null;
+        // Same rule as a page entry's `error` one level down: present but not an object
+        // says nothing this model could report, so it reads as absent. The original is
+        // still on `raw`.
+        this.error = isJsonObject(d.error) ? d.error : null;
+        this.pageResults = parsePageResults(d.pageResults);
+        this.raw = data;
+    }
+    /** Whether the job finished successfully (deliverable downloadable). */
+    get isCompleted() {
+        return this.status === "completed";
+    }
+    /** Whether the job failed. */
+    get isFailed() {
+        return this.status === "failed";
+    }
+    /** Whether the job reached a terminal state (completed or failed). */
+    get isTerminal() {
+        return this.isCompleted || this.isFailed;
+    }
+    static fromJson(data) {
+        return new Job(data);
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Package version, in one place.
+ *
+ * `package.json` is the published number. This constant is what the User-Agent
+ * is built from, and `test/version.test.ts` keeps the two in step — they drifted
+ * apart once on the Python side, which made a bug report's version line useless.
+ *
+ * Do not read `package.json` at runtime: ESM + bundlers will not resolve it.
+ */
+export declare const VERSION = "0.5.3";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,11 @@
+/**
+ * Package version, in one place.
+ *
+ * `package.json` is the published number. This constant is what the User-Agent
+ * is built from, and `test/version.test.ts` keeps the two in step — they drifted
+ * apart once on the Python side, which made a bug report's version line useless.
+ *
+ * Do not read `package.json` at runtime: ESM + bundlers will not resolve it.
+ */
+export const VERSION = "0.5.3";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "image2ppt",
+  "version": "0.5.3",
+  "description": "Official Node.js/TypeScript client for the image2ppt API — convert images and PDFs into editable PowerPoint (.pptx).",
+  "keywords": [
+    "image2ppt",
+    "pptx",
+    "powerpoint",
+    "presentation",
+    "slides",
+    "pdf",
+    "ocr",
+    "image-to-pptx",
+    "api",
+    "sdk"
+  ],
+  "homepage": "https://image2ppt.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/image2ppt/image2ppt-sdk.git",
+    "directory": "typescript"
+  },
+  "bugs": {
+    "url": "https://github.com/image2ppt/image2ppt-sdk/issues"
+  },
+  "license": "MIT",
+  "author": "image2ppt",
+  "type": "module",
+  "engines": {
+    "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "sharp": "^0.34.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  }
+}