@dermacore/node 0.1.0

package/dist/internal/http.js

@@ -0,0 +1,128 @@
+import { APIConnectionError, APITimeoutError, errorFromResponse } from "../errors.js";
+export class HttpClient {
+    #config;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new Error("DermaCore: `apiKey` is required.");
+        }
+        this.#config = {
+            apiKey: config.apiKey,
+            baseURL: (config.baseURL ?? "https://api.dermacore.ai").replace(/\/+$/, ""),
+            timeoutMs: config.timeoutMs ?? 30_000,
+            maxRetries: config.maxRetries ?? 2,
+            defaultHeaders: config.defaultHeaders ?? {},
+            fetchImpl: config.fetch ?? fetch,
+        };
+    }
+    async request(method, path, options = {}) {
+        const url = new URL(this.#config.baseURL + path);
+        if (options.query) {
+            for (const [key, value] of Object.entries(options.query)) {
+                if (value === undefined)
+                    continue;
+                url.searchParams.set(key, String(value));
+            }
+        }
+        const headers = new Headers(this.#config.defaultHeaders);
+        headers.set("Authorization", `ApiKey ${this.#config.apiKey}`);
+        headers.set("Accept", "application/json");
+        if (options.idempotencyKey)
+            headers.set("Idempotency-Key", options.idempotencyKey);
+        if (options.headers) {
+            for (const [key, value] of Object.entries(options.headers))
+                headers.set(key, value);
+        }
+        let body;
+        if (options.form) {
+            // Do not set Content-Type — fetch derives the multipart boundary itself.
+            body = options.form;
+        }
+        else if (options.json !== undefined) {
+            headers.set("Content-Type", "application/json");
+            body = JSON.stringify(options.json);
+        }
+        const maxAttempts = this.#config.maxRetries + 1;
+        let lastNetworkError;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            const timeoutSignal = AbortSignal.timeout(this.#config.timeoutMs);
+            const signal = options.signal ? AbortSignal.any([options.signal, timeoutSignal]) : timeoutSignal;
+            const isLastAttempt = attempt === maxAttempts - 1;
+            let response;
+            try {
+                response = await this.#config.fetchImpl(url, { method, headers, signal, ...(body !== undefined && { body }) });
+            }
+            catch (err) {
+                lastNetworkError = err;
+                if (!isLastAttempt) {
+                    await sleep(backoffMs(attempt));
+                    continue;
+                }
+                const isTimeout = err instanceof Error && err.name === "TimeoutError";
+                const message = `Request to ${path} failed: ${err instanceof Error ? err.message : String(err)}`;
+                throw isTimeout
+                    ? new APITimeoutError(message, { cause: err })
+                    : new APIConnectionError(message, { cause: err });
+            }
+            const requestId = response.headers.get("x-request-id") ?? undefined;
+            if (response.ok) {
+                const data = (await safeJson(response));
+                return { data, requestId, rateLimit: readRateLimit(response.headers) };
+            }
+            const retryAfterHeader = response.headers.get("retry-after");
+            const retryAfterSeconds = retryAfterHeader !== null ? Number(retryAfterHeader) : undefined;
+            const isRetryableStatus = response.status === 429 || response.status >= 500;
+            if (isRetryableStatus && !isLastAttempt) {
+                const delayMs = retryAfterSeconds !== undefined && !Number.isNaN(retryAfterSeconds)
+                    ? retryAfterSeconds * 1000
+                    : backoffMs(attempt);
+                await sleep(delayMs);
+                continue;
+            }
+            const errorBody = (await safeJson(response));
+            throw errorFromResponse(response.status, errorBody, {
+                requestId,
+                retryAfterSeconds: retryAfterSeconds !== undefined && !Number.isNaN(retryAfterSeconds)
+                    ? retryAfterSeconds
+                    : undefined,
+                instance: path,
+            });
+        }
+        // Every loop iteration either returns or throws; this satisfies the
+        // compiler's control-flow analysis without being reachable at runtime.
+        throw lastNetworkError instanceof Error
+            ? lastNetworkError
+            : new APIConnectionError(`Request to ${path} failed.`);
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function backoffMs(attempt) {
+    const capped = Math.min(300 * 2 ** attempt, 5_000);
+    return capped + Math.random() * 100;
+}
+async function safeJson(response) {
+    const text = await response.text();
+    if (!text)
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+function readRateLimit(headers) {
+    return {
+        limit: toNumber(headers.get("x-ratelimit-limit")),
+        remaining: toNumber(headers.get("x-ratelimit-remaining")),
+        resetSeconds: toNumber(headers.get("x-ratelimit-reset")),
+    };
+}
+function toNumber(value) {
+    if (value === null)
+        return undefined;
+    const n = Number(value);
+    return Number.isNaN(n) ? undefined : n;
+}
+//# sourceMappingURL=http.js.map

package/dist/internal/http.js.map

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

package/dist/resources/analysis.d.ts

@@ -0,0 +1,69 @@
+import type { HttpClient } from "../internal/http.js";
+import { type BinaryInput } from "../internal/binary.js";
+import type { AnalysisListResponse, AnalysisResponse, BatchJobAccepted, BatchJobResponse } from "../types.js";
+export interface SubmitAnalysisParams {
+    /** Front-facing image. Required when using named angle fields (preferred over `images`). */
+    imageFront?: BinaryInput;
+    imageLeft?: BinaryInput;
+    imageRight?: BinaryInput;
+    imageChin?: BinaryInput;
+    /** Legacy: 1-5 same-person images, all treated as frontal. Prefer the named angle fields above. */
+    images?: BinaryInput[];
+    mode?: "standard" | "premium";
+    /** Your own reference data, echoed back on every response. Max 1 KB once serialized. */
+    metadata?: string | Record<string, unknown>;
+    /** Links this analysis to a patient created via `patients.upsert()`. */
+    patientId?: string;
+    /**
+     * Deduplicates retries of this exact submission within 24h. Auto-generated
+     * if omitted, so a network-error retry never double-charges your quota.
+     */
+    idempotencyKey?: string;
+}
+export interface ListAnalysesParams {
+    limit?: number;
+    cursor?: string;
+    status?: "queued" | "processing" | "completed" | "failed";
+    fromDate?: string;
+    toDate?: string;
+    patientId?: string;
+}
+export interface UpdateAnalysisMetadataParams {
+    customerRef?: string;
+    patientId?: string;
+    notes?: string;
+}
+export interface AnalysisMetadataResult {
+    id: string;
+    customer_ref: string | null;
+    patient_id: string | null;
+    notes: string | null;
+}
+export interface BatchImageItem {
+    /** Your own reference ID for this image, echoed back in results. */
+    imageId: string;
+    data: BinaryInput;
+    mimeType?: string;
+    metadata?: string | Record<string, unknown>;
+}
+export interface SubmitBatchAnalysisParams {
+    images: BatchImageItem[];
+    webhookUrl?: string;
+    notifyOnCompletion?: boolean;
+    idempotencyKey?: string;
+}
+export declare class AnalysisResource {
+    private readonly http;
+    readonly batch: {
+        submit: (params: SubmitBatchAnalysisParams) => Promise<BatchJobAccepted>;
+        get: (jobId: string) => Promise<BatchJobResponse>;
+    };
+    constructor(http: HttpClient);
+    submit(params: SubmitAnalysisParams): Promise<AnalysisResponse>;
+    get(id: string): Promise<AnalysisResponse>;
+    list(params?: ListAnalysesParams): Promise<AnalysisListResponse>;
+    updateMetadata(id: string, params: UpdateAnalysisMetadataParams): Promise<AnalysisMetadataResult>;
+    private submitBatch;
+    private getBatch;
+}
+//# sourceMappingURL=analysis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/resources/analysis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE9G,MAAM,WAAW,oBAAoB;IACnC,4FAA4F;IAC5F,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,mGAAmG;IACnG,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9B,wFAAwF;IACxF,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gBAAgB;IAMf,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,QAAQ,CAAC,KAAK,EAAE;QACd,MAAM,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACzE,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;KACnD,CAAC;gBAE2B,IAAI,EAAE,UAAU;IAOvC,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2B/D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAK1C,IAAI,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAcpE,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,4BAA4B,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAezF,WAAW;YAsBX,QAAQ;CAOvB"}

package/dist/resources/analysis.js

@@ -0,0 +1,91 @@
+import { randomUUID } from "node:crypto";
+import { toBase64DataUrl, toBlob } from "../internal/binary.js";
+export class AnalysisResource {
+    http;
+    batch;
+    constructor(http) {
+        this.http = http;
+        this.batch = {
+            submit: (params) => this.submitBatch(params),
+            get: (jobId) => this.getBatch(jobId),
+        };
+    }
+    async submit(params) {
+        const form = new FormData();
+        if (params.imageFront)
+            form.append("image_front", await toBlob(params.imageFront), "image_front.jpg");
+        if (params.imageLeft)
+            form.append("image_left", await toBlob(params.imageLeft), "image_left.jpg");
+        if (params.imageRight)
+            form.append("image_right", await toBlob(params.imageRight), "image_right.jpg");
+        if (params.imageChin)
+            form.append("image_chin", await toBlob(params.imageChin), "image_chin.jpg");
+        if (params.images) {
+            for (const image of params.images) {
+                form.append("images", await toBlob(image), "image.jpg");
+            }
+        }
+        if (params.mode)
+            form.append("mode", params.mode);
+        if (params.metadata !== undefined) {
+            form.append("metadata", typeof params.metadata === "string" ? params.metadata : JSON.stringify(params.metadata));
+        }
+        if (params.patientId)
+            form.append("patient_id", params.patientId);
+        const { data } = await this.http.request("POST", "/v1/analysis", {
+            form,
+            idempotencyKey: params.idempotencyKey ?? randomUUID(),
+        });
+        return data;
+    }
+    async get(id) {
+        const { data } = await this.http.request("GET", `/v1/analysis/${encodeURIComponent(id)}`);
+        return data;
+    }
+    async list(params = {}) {
+        const { data } = await this.http.request("GET", "/v1/analysis", {
+            query: {
+                limit: params.limit,
+                cursor: params.cursor,
+                status: params.status,
+                from_date: params.fromDate,
+                to_date: params.toDate,
+                patient_id: params.patientId,
+            },
+        });
+        return data;
+    }
+    async updateMetadata(id, params) {
+        const { data } = await this.http.request("PATCH", `/v1/analysis/${encodeURIComponent(id)}/metadata`, {
+            json: {
+                ...(params.customerRef !== undefined && { customer_ref: params.customerRef }),
+                ...(params.patientId !== undefined && { patient_id: params.patientId }),
+                ...(params.notes !== undefined && { notes: params.notes }),
+            },
+        });
+        return data;
+    }
+    async submitBatch(params) {
+        const images = await Promise.all(params.images.map(async (image) => ({
+            image_id: image.imageId,
+            data: await toBase64DataUrl(image.data, image.mimeType ?? "image/jpeg"),
+            ...(image.metadata !== undefined && {
+                metadata: typeof image.metadata === "string" ? image.metadata : JSON.stringify(image.metadata),
+            }),
+        })));
+        const { data } = await this.http.request("POST", "/v1/analysis/batch", {
+            json: {
+                images,
+                ...(params.webhookUrl !== undefined && { webhook_url: params.webhookUrl }),
+                ...(params.notifyOnCompletion !== undefined && { notify_on_completion: params.notifyOnCompletion }),
+            },
+            idempotencyKey: params.idempotencyKey ?? randomUUID(),
+        });
+        return data;
+    }
+    async getBatch(jobId) {
+        const { data } = await this.http.request("GET", `/v1/analysis/batch/${encodeURIComponent(jobId)}`);
+        return data;
+    }
+}
+//# sourceMappingURL=analysis.js.map

package/dist/resources/analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.js","sourceRoot":"","sources":["../../src/resources/analysis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAoB,MAAM,uBAAuB,CAAC;AA4DlF,MAAM,OAAO,gBAAgB;IAME;IALpB,KAAK,CAGZ;IAEF,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;QAC3C,IAAI,CAAC,KAAK,GAAG;YACX,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YAC5C,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;SACrC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAA4B;QACvC,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,MAAM,CAAC,UAAU;YAAE,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC,CAAC;QACtG,IAAI,MAAM,CAAC,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC,CAAC;QAClG,IAAI,MAAM,CAAC,UAAU;YAAE,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC,CAAC;QACtG,IAAI,MAAM,CAAC,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC,CAAC;QAClG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,IAAI;YAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM,CACT,UAAU,EACV,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CACxF,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAElE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAmB,MAAM,EAAE,cAAc,EAAE;YACjF,IAAI;YACJ,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,UAAU,EAAE;SACtD,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAmB,KAAK,EAAE,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5G,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAA6B,EAAE;QACxC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAuB,KAAK,EAAE,cAAc,EAAE;YACpF,KAAK,EAAE;gBACL,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,QAAQ;gBAC1B,OAAO,EAAE,MAAM,CAAC,MAAM;gBACtB,UAAU,EAAE,MAAM,CAAC,SAAS;aAC7B;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,EAAU,EAAE,MAAoC;QACnE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CACtC,OAAO,EACP,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,WAAW,EACjD;YACE,IAAI,EAAE;gBACJ,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;gBAC7E,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;gBACvE,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;aAC3D;SACF,CACF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,MAAiC;QACzD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAClC,QAAQ,EAAE,KAAK,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,IAAI,YAAY,CAAC;YACvE,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI;gBAClC,QAAQ,EAAE,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC;aAC/F,CAAC;SACH,CAAC,CAAC,CACJ,CAAC;QAEF,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAmB,MAAM,EAAE,oBAAoB,EAAE;YACvF,IAAI,EAAE;gBACJ,MAAM;gBACN,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;gBAC1E,GAAG,CAAC,MAAM,CAAC,kBAAkB,KAAK,SAAS,IAAI,EAAE,oBAAoB,EAAE,MAAM,CAAC,kBAAkB,EAAE,CAAC;aACpG;YACD,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,UAAU,EAAE;SACtD,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,KAAa;QAClC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CACtC,KAAK,EACL,sBAAsB,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAClD,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/resources/patients.d.ts

@@ -0,0 +1,36 @@
+import type { HttpClient } from "../internal/http.js";
+import type { PatientSummary } from "../types.js";
+export interface UpsertPatientParams {
+    fullName: string;
+    gender?: "female" | "male";
+    /** E.164 format. When provided, upserts by `(organization_id, phone)`. */
+    phone?: string;
+    email?: string;
+    birthDate?: string;
+}
+export interface SearchPatientsParams {
+    q?: string;
+    limit?: number;
+}
+export interface ListPatientsParams {
+    search?: string;
+    cursor?: string;
+    limit?: number;
+}
+export interface PatientListResponse {
+    data: PatientSummary[];
+    pagination: {
+        has_more: boolean;
+        next_cursor: string | null;
+    };
+}
+export declare class PatientsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Creates a patient, or upserts by `(organization_id, phone)` when `phone` is provided. */
+    upsert(params: UpsertPatientParams): Promise<PatientSummary>;
+    search(params?: SearchPatientsParams): Promise<PatientSummary[]>;
+    list(params?: ListPatientsParams): Promise<PatientListResponse>;
+    update(id: string, params: UpsertPatientParams): Promise<PatientSummary>;
+}
+//# sourceMappingURL=patients.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"patients.d.ts","sourceRoot":"","sources":["../../src/resources/patients.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,UAAU,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAC/D;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,4FAA4F;IACtF,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;IAO5D,MAAM,CAAC,MAAM,GAAE,oBAAyB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOpE,IAAI,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAOnE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;CAM/E"}

package/dist/resources/patients.js

@@ -0,0 +1,41 @@
+export class PatientsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Creates a patient, or upserts by `(organization_id, phone)` when `phone` is provided. */
+    async upsert(params) {
+        const { data } = await this.http.request("POST", "/v1/patients", {
+            json: toPatientBody(params),
+        });
+        return data;
+    }
+    async search(params = {}) {
+        const { data } = await this.http.request("GET", "/v1/patients", {
+            query: { q: params.q, limit: params.limit },
+        });
+        return data;
+    }
+    async list(params = {}) {
+        const { data } = await this.http.request("GET", "/v1/patients/list", {
+            query: { search: params.search, cursor: params.cursor, limit: params.limit },
+        });
+        return data;
+    }
+    async update(id, params) {
+        const { data } = await this.http.request("PATCH", `/v1/patients/${encodeURIComponent(id)}`, {
+            json: toPatientBody(params),
+        });
+        return data;
+    }
+}
+function toPatientBody(params) {
+    return {
+        full_name: params.fullName,
+        ...(params.gender !== undefined && { gender: params.gender }),
+        ...(params.phone !== undefined && { phone: params.phone }),
+        ...(params.email !== undefined && { email: params.email }),
+        ...(params.birthDate !== undefined && { birth_date: params.birthDate }),
+    };
+}
+//# sourceMappingURL=patients.js.map

package/dist/resources/patients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patients.js","sourceRoot":"","sources":["../../src/resources/patients.ts"],"names":[],"mappings":"AA4BA,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,4FAA4F;IAC5F,KAAK,CAAC,MAAM,CAAC,MAA2B;QACtC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAiB,MAAM,EAAE,cAAc,EAAE;YAC/E,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;SAC5B,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAA+B,EAAE;QAC5C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAmB,KAAK,EAAE,cAAc,EAAE;YAChF,KAAK,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;SAC5C,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAA6B,EAAE;QACxC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAsB,KAAK,EAAE,mBAAmB,EAAE;YACxF,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;SAC7E,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,MAA2B;QAClD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAiB,OAAO,EAAE,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE;YAC1G,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;SAC5B,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,SAAS,aAAa,CAAC,MAA2B;IAChD,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,QAAQ;QAC1B,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7D,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1D,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1D,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;KACxE,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Response shapes, hand-mirrored from docs/api/b2b-partner.openapi.yaml.
+ * Field names are kept snake_case to match the wire format exactly.
+ */
+export type AnalysisStatus = "queued" | "processing" | "completed" | "failed";
+export type AnalysisMode = "standard" | "premium";
+export type ScanAngle = "front" | "left" | "right" | "chin" | "top" | "unknown";
+export type Severity = "none" | "mild" | "moderate" | "severe";
+export type Concern = "acne" | "breakouts" | "dark_circles" | "hydration" | "lines" | "oiliness" | "pigmentation" | "pore_visibility" | "redness" | "sagging" | "under_eye_puffiness" | "uniformness" | "wrinkles";
+export interface SkinProfile {
+    skin_type: "oily" | "dry" | "combination" | "normal";
+    sensitivity: "low" | "moderate" | "high";
+}
+export interface ImageQuality {
+    score: number;
+    lighting_condition: string;
+}
+export interface IssueMask {
+    angle: ScanAngle;
+    data_url: string;
+    blend_mode: string;
+    provenance: string;
+    preview_photo_jpeg: string | null;
+    score: number | null;
+    severity: string | null;
+    confidence: number | null;
+}
+export interface ConcernResult {
+    concern: Concern;
+    severity: Severity;
+    severity_score: number;
+    confidence: number;
+    affected_regions: string[];
+    model_version: string;
+    notes: string | null;
+    region_scores: Record<string, number> | null;
+    accuracy_flags: string[];
+    spatial_provenance: "detected_features" | "computed_signal" | "anatomical_template" | "region_only" | null;
+    issue_masks: IssueMask[] | null;
+    markers: Array<[number, number]> | null;
+    marker_radii: number[] | null;
+}
+export interface QualityFlag {
+    code: string;
+    severity: "warning" | "error";
+    message: string;
+}
+export interface ScanImageSlot {
+    index: number;
+    angle: ScanAngle;
+    processed: boolean;
+    quality_score: number;
+    flag_codes: string[];
+    preview_photo_jpeg: string | null;
+    concern_scores: Record<string, {
+        score: number;
+        severity: string;
+        confidence: number;
+    }> | null;
+    concern_masks: Record<string, {
+        data_url: string;
+        blend_mode: string;
+        provenance: string;
+    }> | null;
+}
+export interface PatientSummary {
+    id: string;
+    full_name: string;
+    gender: "female" | "male";
+    phone: string | null;
+    email: string | null;
+    birth_date: string | null;
+}
+export interface AnalysisResponse {
+    id: string;
+    status: AnalysisStatus;
+    created_at: string;
+    completed_at: string | null;
+    estimated_seconds: number | null;
+    image_count: number | null;
+    face_analysis_provider: "dermacore" | "perfect_corp" | null;
+    highlight_style: "heatmap" | "none" | null;
+    skin_profile: SkinProfile | null;
+    image_quality: ImageQuality | null;
+    concerns: ConcernResult[] | null;
+    quality_flags: QualityFlag[] | null;
+    preview_photo_jpeg: string | null;
+    scan_images: ScanImageSlot[] | null;
+    error_code: string | null;
+    error_message: string | null;
+    model_pipeline_version: string | null;
+    metadata: string | null;
+    notes: string | null;
+    patient: PatientSummary | null;
+    disclaimer: string;
+}
+export interface AnalysisSummary {
+    id: string;
+    status: AnalysisStatus;
+    image_count: number | null;
+    skin_profile: SkinProfile | null;
+    concern_scores: Array<{
+        concern: string;
+        severity_score: number;
+        severity: string;
+        confidence: number;
+    }> | null;
+    created_at: string;
+    completed_at: string | null;
+    metadata: string | null;
+}
+export interface Page<T> {
+    data: T[];
+    pagination: {
+        has_more: boolean;
+        next_cursor: string | null;
+        total_count?: number | null;
+    };
+}
+export type AnalysisListResponse = Page<AnalysisSummary>;
+export interface BatchJobAccepted {
+    job_id: string;
+    status: "queued";
+    image_count: number;
+    estimated_seconds: number;
+    quota_consumed: number;
+    quota_remaining: number;
+    created_at: string;
+}
+export interface BatchItemResult {
+    image_id: string;
+    status: "processing" | "completed" | "failed";
+    analysis_id: string | null;
+    error_code: string | null;
+    error_message: string | null;
+}
+export interface BatchJobResponse {
+    job_id: string;
+    status: "queued" | "processing" | "completed" | "failed" | "partial";
+    image_count: number;
+    completed_count: number;
+    failed_count: number;
+    created_at: string;
+    completed_at: string | null;
+    results: BatchItemResult[];
+}
+//# 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,6 @@
+/**
+ * Response shapes, hand-mirrored from docs/api/b2b-partner.openapi.yaml.
+ * Field names are kept snake_case to match the wire format exactly.
+ */
+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;;;GAGG"}

package/dist/webhooks.d.ts

@@ -0,0 +1,30 @@
+export interface WebhookEvent<T = Record<string, unknown>> {
+    event: string;
+    timestamp: string;
+    data: T;
+}
+/** The header name Derma Core sends the HMAC signature under. */
+export declare const SIGNATURE_HEADER_NAME = "x-dermacore-signature";
+export interface ConstructEventOptions {
+    /**
+     * Reject payloads whose `timestamp` is older than this many seconds, to
+     * guard against replay of a captured request. Default: `300` (5 minutes).
+     * Set to `0` to disable.
+     */
+    toleranceSeconds?: number;
+}
+/**
+ * Verifies the `X-DermaCore-Signature: sha256=<hex>` header against the raw
+ * request body and returns the parsed event. Always verify before trusting a
+ * webhook payload.
+ *
+ * `payload` must be the **raw, unparsed** request body — if your framework's
+ * body parser has already turned it into a JS object, re-serializing it will
+ * not reproduce the exact bytes that were signed and verification will fail.
+ */
+export declare function constructEvent(payload: string | Buffer, signatureHeader: string | null | undefined, secret: string, options?: ConstructEventOptions): WebhookEvent;
+export declare const webhooks: {
+    constructEvent: typeof constructEvent;
+    SIGNATURE_HEADER_NAME: string;
+};
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,CAAC,CAAC;CACT;AAED,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC1C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GAClC,YAAY,CAmCd;AAED,eAAO,MAAM,QAAQ;;;CAA4C,CAAC"}

package/dist/webhooks.js

@@ -0,0 +1,43 @@
+import { createHmac, timingSafeEqual } from "node:crypto";
+import { SignatureVerificationError } from "./errors.js";
+/** The header name Derma Core sends the HMAC signature under. */
+export const SIGNATURE_HEADER_NAME = "x-dermacore-signature";
+/**
+ * Verifies the `X-DermaCore-Signature: sha256=<hex>` header against the raw
+ * request body and returns the parsed event. Always verify before trusting a
+ * webhook payload.
+ *
+ * `payload` must be the **raw, unparsed** request body — if your framework's
+ * body parser has already turned it into a JS object, re-serializing it will
+ * not reproduce the exact bytes that were signed and verification will fail.
+ */
+export function constructEvent(payload, signatureHeader, secret, options = {}) {
+    if (!signatureHeader) {
+        throw new SignatureVerificationError("Missing webhook signature header.");
+    }
+    const raw = typeof payload === "string" ? Buffer.from(payload, "utf8") : payload;
+    const expected = `sha256=${createHmac("sha256", secret).update(raw).digest("hex")}`;
+    const providedBuf = Buffer.from(signatureHeader);
+    const expectedBuf = Buffer.from(expected);
+    const signaturesMatch = providedBuf.length === expectedBuf.length && timingSafeEqual(providedBuf, expectedBuf);
+    if (!signaturesMatch) {
+        throw new SignatureVerificationError("Webhook signature does not match the payload.");
+    }
+    let event;
+    try {
+        event = JSON.parse(raw.toString("utf8"));
+    }
+    catch {
+        throw new SignatureVerificationError("Webhook payload is not valid JSON.");
+    }
+    const toleranceSeconds = options.toleranceSeconds ?? 300;
+    if (toleranceSeconds > 0) {
+        const ageSeconds = (Date.now() - new Date(event.timestamp).getTime()) / 1000;
+        if (Number.isNaN(ageSeconds) || Math.abs(ageSeconds) > toleranceSeconds) {
+            throw new SignatureVerificationError(`Webhook timestamp is outside the ${toleranceSeconds}s tolerance window (possible replay).`);
+        }
+    }
+    return event;
+}
+export const webhooks = { constructEvent, SIGNATURE_HEADER_NAME };
+//# sourceMappingURL=webhooks.js.map