@demarker/client 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,26 @@
-# Temporary Holding Version
+# @demarker/client
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Typed client for the [Demarker](https://demarker.io/developers) API: identify what an AI image carries, then clean it. No runtime dependencies, Node 20+.
+
+```ts
+import { DemarkerClient } from "@demarker/client";
+import { readFile } from "node:fs/promises";
+
+const client = new DemarkerClient({ apiKey: process.env.DEMARKER_API_KEY });
+const bytes = new Uint8Array(await readFile("image.png"));
+
+// Free. Without an apiKey, use client.scanBytes() (keyless, rate-limited).
+const job = await client.identifyBytes(bytes, "image.png");
+console.log(job.offers);
+
+// Spends credits. maxCredits is required; nothing is charged above it.
+// rightsAttested must come from a real confirmation by the person who owns
+// or may edit the image. There is no default.
+const { image } = await client.clean({
+  bytes, filename: "image.png", maxCredits: 1, rightsAttested: true,
+});
+```
+
+Base URL defaults to `https://demarker.io/api/v1`; override with `baseUrl` or `DEMARKER_API_URL`. Errors are `DemarkerApiError` (API envelope: `code`, `status`, `details`) or `DemarkerClientError` (a rule enforced before any request, such as `OVER_CREDIT_CAP`).
+
+Create an API key at https://demarker.io/app/settings/api. See the [OpenAPI spec](https://demarker.io/api/v1/openapi).

package/dist/attestation.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The rights statement a person must confirm before a clean. Same wording as the
+ * web's AttestationCheckbox; the server stores the version with the job.
+ * Callers (CLI, MCP) must get a human's yes. It is never a default.
+ */
+export declare const ATTESTATION_VERSION = "v1";
+export declare const ATTESTATION_TEXT = "This is my image or I have the right to edit it, and I have permission from anyone shown. I will follow the terms of the tool that made it, and I am responsible for any labelling the law or the place I publish requires. I am 18 or older, and I agree to the Terms (https://demarker.io/legal/terms).";

package/dist/attestation.js

@@ -0,0 +1,8 @@
+/**
+ * The rights statement a person must confirm before a clean. Same wording as the
+ * web's AttestationCheckbox; the server stores the version with the job.
+ * Callers (CLI, MCP) must get a human's yes. It is never a default.
+ */
+export const ATTESTATION_VERSION = "v1";
+export const ATTESTATION_TEXT = "This is my image or I have the right to edit it, and I have permission from anyone shown. I will follow the terms of the tool that made it, and I am responsible for any labelling the law or the place I publish requires. I am 18 or older, and I agree to the Terms (https://demarker.io/legal/terms).";
+//# sourceMappingURL=attestation.js.map

package/dist/attestation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attestation.js","sourceRoot":"","sources":["../src/attestation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAC5B,2SAA2S,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,97 @@
+import type { Balance, Job, PendingIdentify, Pricing, ProcessOptions, ScanTicket, UploadTicket } from "./types.ts";
+export declare const DEFAULT_BASE_URL = "https://demarker.io/api/v1";
+export interface ClientOptions {
+    /**
+     * `sk_live_...` key from /app/settings/api. Optional: without it only the
+     * keyless `scan` methods and `getPricing` work.
+     */
+    apiKey?: string;
+    /** Defaults to DEMARKER_API_URL, then https://demarker.io/api/v1. */
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    userAgent?: string;
+}
+export interface WaitOptions {
+    intervalMs?: number;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    onProgress?: (job: Job) => void;
+}
+export interface CleanOptions extends WaitOptions {
+    bytes: Uint8Array;
+    filename: string;
+    tier?: "GPU" | "QUICK";
+    /**
+     * Mandatory ceiling. The API has no one-shot job, so the cap is checked
+     * against the identify response's offer before any credit is spent.
+     */
+    maxCredits: number;
+    rightsAttested: boolean;
+    keepResolution?: boolean;
+    vendorHint?: string;
+    force?: boolean;
+    marks?: string[];
+    secondAttestation?: string;
+    idempotencyKey?: string;
+    onIdentified?: (job: Job) => void;
+}
+export interface CleanResult {
+    job: Job;
+    image: Uint8Array;
+    creditsCharged: number;
+}
+export declare class DemarkerClient {
+    readonly baseUrl: string;
+    private readonly apiKey;
+    /** False for a keyless client: only `scan*` and `getPricing` work. */
+    get hasApiKey(): boolean;
+    private readonly doFetch;
+    private readonly userAgent;
+    constructor(options: ClientOptions);
+    createUpload(filename: string): Promise<UploadTicket>;
+    /** PUT the bytes to the presigned URL. Not an API call, so no bearer token. */
+    putUpload(ticket: Pick<UploadTicket, "uploadUrl" | "contentType">, bytes: Uint8Array): Promise<void>;
+    /** Returns the settled job, or a pending stub when identify is still running (202). */
+    identify(uploadKey: string, idempotencyKey?: string): Promise<Job | PendingIdentify>;
+    getJob(id: string): Promise<Job>;
+    listJobs(params?: {
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        jobs: Job[];
+        total: number;
+    }>;
+    deleteJob(id: string): Promise<{
+        deleted: boolean;
+        creditsRefunded: number;
+    }>;
+    /**
+     * Debits the offer. `rightsAttested` must be an explicit true. A retry after a
+     * lost response gets 409 JOB_NOT_IDENTIFIED, so a debit is never doubled.
+     */
+    processJob(id: string, options: ProcessOptions): Promise<Job>;
+    getBalance(): Promise<Balance>;
+    getPricing(): Promise<Pricing>;
+    /** Upload an image for the free identify step. Returns the job id and a secret claim token. */
+    scan(bytes: Uint8Array, filename: string): Promise<ScanTicket>;
+    getScan(id: string, claimToken: string): Promise<Job>;
+    /** Keyless scan and wait for the identify result. */
+    scanBytes(bytes: Uint8Array, filename: string, options?: WaitOptions): Promise<Job>;
+    /** Poll until `until` returns true or the job is terminal. */
+    waitForJob(id: string, until: (job: Job) => boolean, options?: WaitOptions): Promise<Job>;
+    /** Upload, PUT and identify (free). Polls if the API answers 202. */
+    identifyBytes(bytes: Uint8Array, filename: string, options?: WaitOptions & {
+        idempotencyKey?: string;
+    }): Promise<Job>;
+    /** Download a result URL (valid for one hour). */
+    download(url: string): Promise<Uint8Array>;
+    /**
+     * Identify, check the price against `maxCredits`, process, wait, download.
+     * Spends nothing unless the offer is at or under the cap.
+     */
+    clean(options: CleanOptions): Promise<CleanResult>;
+    private request;
+}
+/** True once identify has produced a result (not UPLOADED / IDENTIFYING). */
+export declare function isSettledIdentify(j: Job | PendingIdentify): j is Job;

package/dist/client.js

@@ -0,0 +1,266 @@
+import { DemarkerApiError, DemarkerClientError } from "./errors.js";
+export const DEFAULT_BASE_URL = "https://demarker.io/api/v1";
+const TERMINAL = ["COMPLETED", "FAILED", "REFUSED", "EXPIRED"];
+const sleep = (ms, signal) => new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+        return reject(signal.reason);
+    }
+    const t = setTimeout(resolve, ms);
+    signal?.addEventListener("abort", () => {
+        clearTimeout(t);
+        reject(signal.reason);
+    }, { once: true });
+});
+export class DemarkerClient {
+    baseUrl;
+    apiKey;
+    /** False for a keyless client: only `scan*` and `getPricing` work. */
+    get hasApiKey() {
+        return Boolean(this.apiKey);
+    }
+    doFetch;
+    userAgent;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = (options.baseUrl ??
+            process.env.DEMARKER_API_URL ??
+            DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.doFetch = options.fetch ?? fetch;
+        this.userAgent = options.userAgent ?? "@demarker/client";
+    }
+    // ----- HTTP methods: one per endpoint, no file I/O -----
+    createUpload(filename) {
+        return this.request("POST", "/upload", { filename });
+    }
+    /** PUT the bytes to the presigned URL. Not an API call, so no bearer token. */
+    async putUpload(ticket, bytes) {
+        const res = await this.doFetch(ticket.uploadUrl, {
+            method: "PUT",
+            headers: { "Content-Type": ticket.contentType },
+            body: bytes,
+        });
+        if (!res.ok) {
+            throw new DemarkerClientError("UPLOAD_FAILED", `Upload failed with HTTP ${res.status}.`, { status: res.status });
+        }
+    }
+    /** Returns the settled job, or a pending stub when identify is still running (202). */
+    identify(uploadKey, idempotencyKey) {
+        return this.request("POST", "/identify", { uploadKey }, idempotencyKey ? { "Idempotency-Key": idempotencyKey } : undefined);
+    }
+    getJob(id) {
+        return this.request("GET", `/jobs/${encodeURIComponent(id)}`);
+    }
+    listJobs(params = {}) {
+        const q = new URLSearchParams();
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined) {
+                q.set(k, String(v));
+            }
+        }
+        const qs = q.size ? `?${q}` : "";
+        return this.request("GET", `/jobs${qs}`);
+    }
+    deleteJob(id) {
+        return this.request("DELETE", `/jobs/${encodeURIComponent(id)}`);
+    }
+    /**
+     * Debits the offer. `rightsAttested` must be an explicit true. A retry after a
+     * lost response gets 409 JOB_NOT_IDENTIFIED, so a debit is never doubled.
+     */
+    processJob(id, options) {
+        if (options.rightsAttested !== true) {
+            throw new DemarkerClientError("ATTESTATION_REQUIRED", "rightsAttested must be explicitly true.");
+        }
+        return this.request("POST", `/jobs/${encodeURIComponent(id)}/process`, options);
+    }
+    getBalance() {
+        return this.request("GET", "/balance");
+    }
+    getPricing() {
+        return this.request("GET", "/pricing", undefined, undefined, false);
+    }
+    // ----- Keyless scan: identify only, no API key -----
+    /** Upload an image for the free identify step. Returns the job id and a secret claim token. */
+    async scan(bytes, filename) {
+        const form = new FormData();
+        form.set("file", new Blob([bytes]), filename);
+        return this.request("POST", "/scan", form, undefined, false);
+    }
+    getScan(id, claimToken) {
+        return this.request("GET", `/scan/${encodeURIComponent(id)}`, undefined, { "X-Claim-Token": claimToken }, false);
+    }
+    /** Keyless scan and wait for the identify result. */
+    async scanBytes(bytes, filename, options = {}) {
+        const ticket = await this.scan(bytes, filename);
+        const interval = options.intervalMs ?? 1500;
+        const deadline = Date.now() + (options.timeoutMs ?? 120_000);
+        for (;;) {
+            const job = await this.getScan(ticket.id, ticket.claimToken);
+            options.onProgress?.(job);
+            if (job.status !== "UPLOADED" && job.status !== "IDENTIFYING") {
+                return job;
+            }
+            if (Date.now() >= deadline) {
+                throw new DemarkerClientError("TIMEOUT", `Scan ${ticket.id} did not finish in time (status ${job.status}).`, { jobId: ticket.id, status: job.status });
+            }
+            await sleep(interval, options.signal);
+        }
+    }
+    // ----- Helpers that combine calls -----
+    /** Poll until `until` returns true or the job is terminal. */
+    async waitForJob(id, until, options = {}) {
+        const interval = options.intervalMs ?? 2000;
+        const deadline = Date.now() + (options.timeoutMs ?? 10 * 60_000);
+        for (;;) {
+            const job = await this.getJob(id);
+            options.onProgress?.(job);
+            if (until(job) || TERMINAL.includes(job.status)) {
+                return job;
+            }
+            if (Date.now() >= deadline) {
+                throw new DemarkerClientError("TIMEOUT", `Job ${id} did not finish in time (status ${job.status}).`, { jobId: id, status: job.status });
+            }
+            await sleep(interval, options.signal);
+        }
+    }
+    /** Upload, PUT and identify (free). Polls if the API answers 202. */
+    async identifyBytes(bytes, filename, options = {}) {
+        const ticket = await this.createUpload(filename);
+        await this.putUpload(ticket, bytes);
+        const first = await this.identify(ticket.uploadKey, options.idempotencyKey);
+        if (isSettledIdentify(first)) {
+            return first;
+        }
+        return this.waitForJob(first.id, isSettledIdentify, options);
+    }
+    /** Download a result URL (valid for one hour). */
+    async download(url) {
+        const res = await this.doFetch(url);
+        if (!res.ok) {
+            throw new DemarkerClientError("UPLOAD_FAILED", `Download failed with HTTP ${res.status}.`, { status: res.status });
+        }
+        return new Uint8Array(await res.arrayBuffer());
+    }
+    /**
+     * Identify, check the price against `maxCredits`, process, wait, download.
+     * Spends nothing unless the offer is at or under the cap.
+     */
+    async clean(options) {
+        if (!(Number.isFinite(options.maxCredits) && options.maxCredits >= 0)) {
+            throw new DemarkerClientError("CREDIT_CAP_REQUIRED", "maxCredits is required (a number of credits, 0 or more).");
+        }
+        if (options.rightsAttested !== true) {
+            throw new DemarkerClientError("ATTESTATION_REQUIRED", "rightsAttested must be explicitly true.");
+        }
+        const tier = options.tier ?? "GPU";
+        const keepResolution = options.keepResolution === true;
+        const identified = await this.identifyBytes(options.bytes, options.filename, options);
+        options.onIdentified?.(identified);
+        if (identified.status === "REFUSED") {
+            throw new DemarkerClientError("REFUSED", `Identify refused this image: ${identified.refusalReason ?? "unspecified"}.`, {
+                jobId: identified.id,
+                refusalReason: identified.refusalReason,
+            });
+        }
+        const offer = identified.offers?.find((o) => o.tier === tier && o.keepResolution === keepResolution);
+        if (!offer) {
+            throw new DemarkerClientError("NO_OFFER", `No ${tier} offer${keepResolution ? " at original size" : ""} for this image.`, { jobId: identified.id, offers: identified.offers });
+        }
+        if (offer.credits > options.maxCredits) {
+            throw new DemarkerClientError("OVER_CREDIT_CAP", `This run costs ${offer.credits} credit(s); maxCredits is ${options.maxCredits}. Nothing was charged.`, {
+                jobId: identified.id,
+                requiredCredits: offer.credits,
+                maxCredits: options.maxCredits,
+            });
+        }
+        let started;
+        try {
+            started = await this.processJob(identified.id, {
+                tier,
+                keepResolution,
+                rightsAttested: true,
+                vendorHint: options.vendorHint,
+                force: options.force,
+                marks: options.marks,
+                secondAttestation: options.secondAttestation,
+            });
+        }
+        catch (err) {
+            // The debit may have landed before the response was lost. A second
+            // pick is refused with 409, so look at the job instead.
+            if (!(err instanceof DemarkerApiError &&
+                err.code === "JOB_NOT_IDENTIFIED")) {
+                throw err;
+            }
+            started = await this.getJob(identified.id);
+            if (!["PENDING", "PROCESSING", "COMPLETED"].includes(started.status)) {
+                throw err;
+            }
+        }
+        const done = started.status === "COMPLETED"
+            ? started
+            : await this.waitForJob(started.id, (j) => j.status === "COMPLETED", options);
+        if (done.status !== "COMPLETED" || !done.outputs.image) {
+            throw new DemarkerClientError("JOB_FAILED", done.errorMessage ??
+                `Job ended as ${done.status}. Credits are refunded automatically on failure.`, {
+                jobId: done.id,
+                status: done.status,
+                errorCode: done.errorCode,
+            });
+        }
+        const image = await this.download(done.outputs.image);
+        return {
+            job: done,
+            image,
+            creditsCharged: done.creditsCharged ?? offer.credits,
+        };
+    }
+    // ----- internals -----
+    async request(method, path, body, extraHeaders, auth = true) {
+        const headers = {
+            Accept: "application/json",
+            "User-Agent": this.userAgent,
+            ...extraHeaders,
+        };
+        if (auth) {
+            if (!this.apiKey) {
+                throw new DemarkerClientError("NO_API_KEY", "This call needs an API key. Create one at https://demarker.io/app/settings/api");
+            }
+            headers.Authorization = `Bearer ${this.apiKey}`;
+        }
+        const isForm = typeof FormData !== "undefined" && body instanceof FormData;
+        if (body !== undefined && !isForm) {
+            headers["Content-Type"] = "application/json";
+        }
+        const res = await this.doFetch(`${this.baseUrl}${path}`, {
+            method,
+            headers,
+            body: body === undefined
+                ? undefined
+                : isForm
+                    ? body
+                    : JSON.stringify(body),
+        });
+        const text = await res.text();
+        let data;
+        try {
+            data = text ? JSON.parse(text) : undefined;
+        }
+        catch {
+            data = undefined;
+        }
+        if (!res.ok) {
+            const env = data?.error;
+            const { code, message, ...rest } = env ?? {};
+            throw new DemarkerApiError(res.status, typeof code === "string" ? code : `HTTP_${res.status}`, typeof message === "string"
+                ? message
+                : `Request failed with HTTP ${res.status}.`, rest);
+        }
+        return data;
+    }
+}
+/** True once identify has produced a result (not UPLOADED / IDENTIFYING). */
+export function isSettledIdentify(j) {
+    return j.status !== "UPLOADED" && j.status !== "IDENTIFYING";
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,15 @@
+/** An error envelope from the API: `{ error: { code, message, resolution, docs, ...extra } }`. */
+export declare class DemarkerApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly resolution?: string;
+    /** Extra fields the API sent with the error (requiredCredits, balance, purchaseUrl, ...). */
+    readonly details: Record<string, unknown>;
+    constructor(status: number, code: string, message: string, details?: Record<string, unknown>);
+}
+/** The caller broke a rule the client enforces before any request is sent. */
+export declare class DemarkerClientError extends Error {
+    readonly code: string;
+    readonly details: Record<string, unknown>;
+    constructor(code: "CREDIT_CAP_REQUIRED" | "OVER_CREDIT_CAP" | "NO_OFFER" | "TIMEOUT" | "JOB_FAILED" | "REFUSED" | "ATTESTATION_REQUIRED" | "UPLOAD_FAILED" | "NO_API_KEY", message: string, details?: Record<string, unknown>);
+}

package/dist/errors.js

@@ -0,0 +1,31 @@
+/** An error envelope from the API: `{ error: { code, message, resolution, docs, ...extra } }`. */
+export class DemarkerApiError extends Error {
+    status;
+    code;
+    resolution;
+    /** Extra fields the API sent with the error (requiredCredits, balance, purchaseUrl, ...). */
+    details;
+    constructor(status, code, message, details = {}) {
+        super(message);
+        this.name = "DemarkerApiError";
+        this.status = status;
+        this.code = code;
+        this.details = details;
+        const resolution = details.resolution;
+        if (typeof resolution === "string") {
+            this.resolution = resolution;
+        }
+    }
+}
+/** The caller broke a rule the client enforces before any request is sent. */
+export class DemarkerClientError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.name = "DemarkerClientError";
+        this.code = code;
+        this.details = details;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACjC,MAAM,CAAS;IACf,IAAI,CAAS;IACb,UAAU,CAAU;IAC7B,6FAA6F;IACpF,OAAO,CAA0B;IAE1C,YACC,MAAc,EACd,IAAY,EACZ,OAAe,EACf,UAAmC,EAAE;QAErC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACtC,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC9B,CAAC;IACF,CAAC;CACD;AAED,8EAA8E;AAC9E,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACpC,IAAI,CAAS;IACb,OAAO,CAA0B;IAE1C,YACC,IASe,EACf,OAAe,EACf,UAAmC,EAAE;QAErC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;CACD"}

package/dist/files.d.ts

@@ -0,0 +1,4 @@
+/** Pick the extension from the bytes: the API returns the result as stored, not by name. */
+export declare function detectExt(bytes: Uint8Array): string;
+/** `photo.png` -> `photo.clean.png` next to the input, or inside/at `out`. */
+export declare function outputPathFor(input: string, ext: string, out?: string, outIsDir?: boolean): string;

package/dist/files.js

@@ -0,0 +1,28 @@
+import { basename, dirname, extname, join } from "node:path";
+/** Pick the extension from the bytes: the API returns the result as stored, not by name. */
+export function detectExt(bytes) {
+    const b = bytes;
+    if (b[0] === 0x89 && b[1] === 0x50 && b[2] === 0x4e && b[3] === 0x47) {
+        return ".png";
+    }
+    if (b[0] === 0xff && b[1] === 0xd8) {
+        return ".jpg";
+    }
+    if (b[0] === 0x52 &&
+        b[1] === 0x49 &&
+        b[2] === 0x46 &&
+        b[3] === 0x46 &&
+        b[8] === 0x57) {
+        return ".webp";
+    }
+    return ".png";
+}
+/** `photo.png` -> `photo.clean.png` next to the input, or inside/at `out`. */
+export function outputPathFor(input, ext, out, outIsDir = false) {
+    const name = `${basename(input, extname(input))}.clean${ext}`;
+    if (!out) {
+        return join(dirname(input), name);
+    }
+    return outIsDir ? join(out, name) : out;
+}
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE7D,4FAA4F;AAC5F,MAAM,UAAU,SAAS,CAAC,KAAiB;IAC1C,MAAM,CAAC,GAAG,KAAK,CAAC;IAChB,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACtE,OAAO,MAAM,CAAC;IACf,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACpC,OAAO,MAAM,CAAC;IACf,CAAC;IACD,IACC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EACZ,CAAC;QACF,OAAO,OAAO,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAC5B,KAAa,EACb,GAAW,EACX,GAAY,EACZ,QAAQ,GAAG,KAAK;IAEhB,MAAM,IAAI,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC;IAC9D,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACzC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./attestation.ts";
+export * from "./client.ts";
+export * from "./errors.ts";
+export * from "./files.ts";
+export * from "./types.ts";

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./attestation.js";
+export * from "./client.js";
+export * from "./errors.js";
+export * from "./files.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,99 @@
+/** Shapes of `/api/v1` responses. Mirror `apps/web/app/api/v1/lib/serialize.ts`. */
+export type JobStatus = "UPLOADED" | "IDENTIFYING" | "IDENTIFIED" | "HELD" | "PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "REFUSED" | "EXPIRED";
+export type Tier = "QUICK" | "GPU";
+export interface Offer {
+    tier: Tier;
+    keepResolution: boolean;
+    credits: number;
+    [key: string]: unknown;
+}
+export interface Job {
+    id: string;
+    status: JobStatus;
+    progress: number | null;
+    width: number;
+    height: number;
+    megapixels: number;
+    band: string | null;
+    hasInvisibleTarget: boolean | null;
+    vendor: string | null;
+    /** The identify report: visible marks, AI metadata, inferred hidden watermarks. */
+    report: unknown;
+    cmiFields: unknown;
+    offers: Offer[] | null;
+    /** Present on the identify response only. */
+    balance?: number;
+    attestationVersion: string | null;
+    tier: Tier | null;
+    keepResolution: boolean | null;
+    creditsCharged: number | null;
+    refusalReason: string | null;
+    processBlocked: string | null;
+    errorCode: string | null;
+    errorMessage: string | null;
+    cleanReport: unknown;
+    outputs: {
+        image: string | null;
+    };
+    createdAt: string;
+    completedAt: string | null;
+    expiresAt: string | null;
+}
+/** 202 from /identify while the worker is still busy. */
+export interface PendingIdentify {
+    id: string;
+    status: JobStatus;
+}
+export interface UploadTicket {
+    uploadUrl: string;
+    uploadKey: string;
+    expiresAt: string;
+    maxFileSizeBytes: number;
+    maxFileSizeMb: number;
+    contentType: string;
+}
+export interface Balance {
+    balanceCredits: number;
+    updatedAt: string;
+}
+export interface Pricing {
+    unit: string;
+    bandMegapixels: number;
+    maxMegapixels: number;
+    tiers: {
+        QUICK: {
+            purchasable: boolean;
+            freePerDayWeb: number;
+        };
+        GPU: {
+            standardOutput: number;
+            originalOverBand: number;
+        };
+    };
+    packs: {
+        id: string;
+        label: string;
+        credits: number;
+        priceCents: number;
+    }[];
+}
+export interface ProcessOptions {
+    tier: Tier;
+    /** Must be an explicit `true`. There is no default. */
+    rightsAttested: boolean;
+    keepResolution?: boolean;
+    vendorHint?: string;
+    force?: boolean;
+    marks?: string[];
+    secondAttestation?: string;
+}
+/** 202 from POST /scan. `claimToken` is a secret: send it as X-Claim-Token, never in a URL. */
+export interface ScanTicket {
+    id: string;
+    claimToken: string;
+    status: JobStatus;
+    width: number;
+    height: number;
+    megapixels: number;
+    identifyOnly: boolean;
+}

package/dist/types.js

@@ -0,0 +1,3 @@
+/** Shapes of `/api/v1` responses. Mirror `apps/web/app/api/v1/lib/serialize.ts`. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oFAAoF"}

package/package.json

@@ -1,6 +1,40 @@
 {
-  "name": "@demarker/client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+	"name": "@demarker/client",
+	"version": "0.1.0",
+	"description": "Typed client for the Demarker API: identify what an AI image carries, then clean it.",
+	"license": "MIT",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"engines": {
+		"node": ">=20"
+	},
+	"homepage": "https://demarker.io/developers",
+	"keywords": [
+		"demarker",
+		"ai-watermark",
+		"synthid",
+		"image",
+		"api-client"
+	],
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"type-check": "tsc --noEmit",
+		"test": "node --test \"src/**/*.test.ts\"",
+		"clean": "rm -rf dist"
+	},
+	"devDependencies": {
+		"@types/node": "^24.10.1",
+		"typescript": "5.9.3"
+	}
+}