@timbro/invoices 0.7.0-next.30

package/dist/direct-connection.js

@@ -0,0 +1,192 @@
+import { approveDirectConnectionRequest, cancelDirectConnectionRequest, confirmDirectConnection, createDirectConnectionRequest, pollDirectConnectionRequest, previewDirectConnectionRequest, } from "./generated/index.js";
+import { createGeneratedOperationClient } from "./generated-operation-client.js";
+import { throwGeneratedProblem } from "./generated-problem.js";
+import { createStampServerHttpTransport } from "./stamp-server-http-transport.js";
+const CREDENTIAL_KEY_BYTES = 16;
+const CREDENTIAL_SECRET_BYTES = 32;
+/** Generates the customer-managed bearer used by a direct Source connection. */
+export function generateDirectConnectionCredential(environment) {
+    const key = new Uint8Array(CREDENTIAL_KEY_BYTES);
+    const secret = new Uint8Array(CREDENTIAL_SECRET_BYTES);
+    globalThis.crypto.getRandomValues(key);
+    globalThis.crypto.getRandomValues(secret);
+    return `tmb_${environment}_${encodeBase64Url(key)}.${encodeBase64Url(secret)}`;
+}
+/** Creates the unauthenticated create/poll/cancel client and credential-scoped confirm call. */
+export function createDirectConnectionClient(options) {
+    const transportOptions = {
+        stampServerOrigin: options.baseUrl,
+        ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+    };
+    const anonymousClient = createGeneratedOperationClient(createStampServerHttpTransport({ ...transportOptions, authentication: { mode: "none" } }));
+    return {
+        create: async (body) => toRequest(await createDirectConnectionRequestResource(anonymousClient, await toGeneratedCreate(body))),
+        poll: (requestId, pollingSecret) => pollDirectConnectionRequestResource(anonymousClient, requestId, pollingSecret),
+        cancel: (requestId, pollingSecret) => cancelDirectConnectionRequestResource(anonymousClient, requestId, pollingSecret),
+        confirm: (sourceConnectionId, credential) => {
+            const credentialClient = createGeneratedOperationClient(createStampServerHttpTransport({
+                ...transportOptions,
+                authentication: { mode: "source_connection", credential },
+            }));
+            return confirmDirectConnectionResource(credentialClient, sourceConnectionId);
+        },
+    };
+}
+/** Adds Workspace-session preview and approval to the authenticated Workspace client. */
+export function createDirectConnectionWorkspaceOperations(client) {
+    return {
+        preview: async (organizationId, userCode) => {
+            const response = await previewDirectConnectionRequest({
+                client,
+                path: { organization_id: organizationId, user_code: userCode },
+            });
+            if (response.status !== 200) {
+                throwGeneratedProblem(response, "Direct connection preview failed");
+            }
+            return toPreview(response.body);
+        },
+        approve: async (organizationId, userCode, body) => {
+            const response = await approveDirectConnectionRequest({
+                client,
+                path: { organization_id: organizationId, user_code: userCode },
+                body: { legal_issuer_id: body.legalIssuerId },
+            });
+            if (response.status !== 201) {
+                throwGeneratedProblem(response, "Direct connection approval failed");
+            }
+            return toApproval(response.body);
+        },
+    };
+}
+async function toGeneratedCreate(body) {
+    const { environment, keyId, secret } = parseCredential(body.credential, body.environment);
+    const digest = await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(secret));
+    return {
+        client_request_id: body.clientRequestId,
+        installation_id: body.installationId,
+        database_id: body.databaseId,
+        company_id: body.companyId,
+        company_name: body.companyName,
+        company_tax_id: body.companyTaxId,
+        software_version: body.softwareVersion,
+        environment,
+        credential_proof: {
+            key_id: keyId,
+            secret_sha256: encodeBase64Url(new Uint8Array(digest)),
+        },
+        polling_secret: body.pollingSecret,
+    };
+}
+function parseCredential(credential, expectedEnvironment) {
+    const match = /^tmb_(sandbox|certification|production)_([A-Za-z0-9_-]{22})\.([A-Za-z0-9_-]{43})$/.exec(credential);
+    if (match === null || match[1] !== expectedEnvironment) {
+        throw new TypeError("credential must use the exact Timbro Source bearer grammar and environment");
+    }
+    const [, environment, keyId, secret] = match;
+    if (keyId === undefined || secret === undefined) {
+        throw new TypeError("credential is malformed");
+    }
+    const keyBytes = decodeBase64Url(keyId);
+    const secretBytes = decodeBase64Url(secret);
+    if (keyBytes.length !== CREDENTIAL_KEY_BYTES ||
+        secretBytes.length !== CREDENTIAL_SECRET_BYTES ||
+        encodeBase64Url(keyBytes) !== keyId ||
+        encodeBase64Url(secretBytes) !== secret) {
+        throw new TypeError("credential must use canonical base64url segments");
+    }
+    return {
+        environment: environment,
+        keyId,
+        secret,
+    };
+}
+function encodeBase64Url(bytes) {
+    let binary = "";
+    for (const byte of bytes) {
+        binary += String.fromCharCode(byte);
+    }
+    return globalThis.btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/[=]+$/, "");
+}
+function decodeBase64Url(value) {
+    const padding = "=".repeat((4 - (value.length % 4)) % 4);
+    const binary = globalThis.atob(value.replaceAll("-", "+").replaceAll("_", "/") + padding);
+    return Uint8Array.from(binary, (character) => character.charCodeAt(0));
+}
+async function createDirectConnectionRequestResource(client, body) {
+    const response = await createDirectConnectionRequest({ client, body });
+    if (response.status !== 201) {
+        throwGeneratedProblem(response, "Direct connection request failed");
+    }
+    return response.body;
+}
+function toRequest(resource) {
+    return {
+        requestId: resource.request_id,
+        userCode: resource.user_code,
+        verificationUri: resource.verification_uri,
+        expiresAt: resource.expires_at,
+        pollingSecret: resource.polling_secret,
+    };
+}
+function toPoll(resource) {
+    return {
+        requestId: resource.request_id,
+        state: resource.state,
+        sourceConnectionId: resource.source_connection_id,
+        expiresAt: resource.expires_at,
+    };
+}
+function toPreview(resource) {
+    return {
+        requestId: resource.request_id,
+        installationId: resource.installation_id,
+        companyId: resource.company_id,
+        companyName: resource.company_name,
+        companyTaxId: resource.company_tax_id,
+        softwareVersion: resource.software_version,
+        environment: resource.environment,
+        state: resource.state,
+        expiresAt: resource.expires_at,
+    };
+}
+function toApproval(resource) {
+    return {
+        requestId: resource.request_id,
+        sourceConnectionId: resource.source_connection_id,
+        state: resource.state,
+    };
+}
+async function pollDirectConnectionRequestResource(client, requestId, pollingSecret) {
+    const response = await pollDirectConnectionRequest({
+        client,
+        path: { request_id: requestId },
+        headers: { "X-Timbro-Polling-Secret": pollingSecret },
+    });
+    if (response.status !== 200) {
+        throwGeneratedProblem(response, "Direct connection polling failed");
+    }
+    return toPoll(response.body);
+}
+async function cancelDirectConnectionRequestResource(client, requestId, pollingSecret) {
+    const response = await cancelDirectConnectionRequest({
+        client,
+        path: { request_id: requestId },
+        headers: { "X-Timbro-Polling-Secret": pollingSecret },
+    });
+    if (response.status !== 204) {
+        throwGeneratedProblem(response, "Direct connection cancellation failed");
+    }
+}
+async function confirmDirectConnectionResource(client, sourceConnectionId) {
+    const response = await confirmDirectConnection({
+        client,
+        path: { source_connection_id: sourceConnectionId },
+    });
+    if (response.status !== 200) {
+        throwGeneratedProblem(response, "Direct connection confirmation failed");
+    }
+    return toConfirmation(response.body);
+}
+function toConfirmation(resource) {
+    return { sourceConnectionId: resource.source_connection_id, confirmed: resource.confirmed };
+}

package/dist/document-node.d.ts

@@ -0,0 +1,15 @@
+/** Options for the server-only Node document runtime bridge. */
+export type NodeDocumentRuntimeOptions = {
+    /** Override the generated Wasm glue module, primarily for isolated hosts and tests. */
+    readonly glueModuleUrl?: string | URL;
+    /** Override the generated Wasm binary, primarily for isolated hosts and tests. */
+    readonly wasmModuleUrl?: string | URL;
+};
+/**
+ * Loads the generated browser-fiscal Wasm glue and binary for a Node host.
+ *
+ * This module is an explicit server-only package entrypoint. Do not import it from browser code:
+ * it imports Node's filesystem and URL modules by design.
+ */
+export declare function createNodeDocumentRuntime(options?: NodeDocumentRuntimeOptions): (requestJson: string) => Promise<string>;
+//# sourceMappingURL=document-node.d.ts.map

package/dist/document-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-node.d.ts","sourceRoot":"","sources":["../src/document-node.ts"],"names":[],"mappings":"AASA,gEAAgE;AAChE,MAAM,MAAM,0BAA0B,GAAG;IACvC,uFAAuF;IACvF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACtC,kFAAkF;IAClF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;CACvC,CAAC;AAOF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAyB1C"}

package/dist/document-node.js

@@ -0,0 +1,67 @@
+// biome-ignore-all lint/correctness/noNodejsModules: this is an explicitly server-only bridge.
+// biome-ignore-all lint/correctness/useImportExtensions: package build rewrites TypeScript imports.
+// biome-ignore-all lint/security/noSecrets: this module handles only public Wasm evaluator assets.
+// biome-ignore-all lint/correctness/noUnusedVariables: runtime shape is validated at the bridge boundary.
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { FiscalDocumentEvaluatorError } from "./document.js";
+/**
+ * Loads the generated browser-fiscal Wasm glue and binary for a Node host.
+ *
+ * This module is an explicit server-only package entrypoint. Do not import it from browser code:
+ * it imports Node's filesystem and URL modules by design.
+ */
+export function createNodeDocumentRuntime(options = {}) {
+    let engine;
+    return async (requestJson) => {
+        try {
+            engine ??= loadEngine(options);
+            const loaded = await engine;
+            const response = loaded.evaluateFiscalDocument(requestJson);
+            if (typeof response !== "string") {
+                throw new Error("the fiscal document engine returned a non-string response");
+            }
+            return response;
+        }
+        catch (cause) {
+            if (cause instanceof FiscalDocumentEvaluatorError) {
+                throw cause;
+            }
+            const error = new FiscalDocumentEvaluatorError(cause instanceof Error
+                ? `the Node fiscal document runtime is unavailable: ${cause.message}`
+                : "the Node fiscal document runtime is unavailable", "runtime_unavailable");
+            error.cause = cause;
+            throw error;
+        }
+    };
+}
+async function loadEngine(options) {
+    const glueUrl = resolveModuleUrl(options.glueModuleUrl ?? new URL("./timbro_fiscal_engine.js", import.meta.url));
+    const wasmUrl = resolveModuleUrl(options.wasmModuleUrl ?? new URL("./timbro_fiscal_engine_bg.wasm", import.meta.url));
+    const loaded = await import(__rewriteRelativeImportExtension(glueUrl.href));
+    if (!isFiscalEngineGlue(loaded)) {
+        throw new Error("the fiscal document glue module is invalid");
+    }
+    const wasmBytes = await readFile(fileURLToPath(wasmUrl));
+    await loaded.default({ module_or_path: wasmBytes });
+    return loaded;
+}
+function resolveModuleUrl(value) {
+    return value instanceof URL ? value : new URL(value, import.meta.url);
+}
+function isFiscalEngineGlue(candidate) {
+    return (typeof candidate === "object" &&
+        candidate !== null &&
+        "default" in candidate &&
+        typeof candidate.default === "function" &&
+        "evaluateFiscalDocument" in candidate &&
+        typeof candidate.evaluateFiscalDocument === "function");
+}

package/dist/document-worker-protocol.d.ts

@@ -0,0 +1,30 @@
+import type { SourceDocumentEvaluationResponse } from "./generated/index.ts";
+export declare const DOCUMENT_WORKER_PROTOCOL: "timbro.fiscal-document-worker.v1";
+export declare const DOCUMENT_EVALUATION_PROTOCOL: "timbro.fiscal-document-evaluation.v1";
+export type DocumentWorkerCommand = {
+    readonly type: "evaluate";
+    readonly request_id: string;
+    readonly request: string;
+} | {
+    readonly type: "initialize";
+    readonly glue_module_url: string;
+    readonly wasm_module_url: string;
+};
+export declare function decodeDocumentWorkerResponse(candidate: unknown, expectedRequestId: string): {
+    readonly outcome: "decoded";
+    readonly response: SourceDocumentEvaluationResponse;
+} | {
+    readonly outcome: "protocol_mismatch";
+    readonly detail: string;
+};
+export declare function decodeDocumentWorkerEvent(candidate: unknown, expectedWorkerRequestId: string | null, expectedEvaluatorRequestId: string | null): {
+    readonly outcome: "evaluated";
+    readonly response: SourceDocumentEvaluationResponse;
+} | {
+    readonly outcome: "failed";
+    readonly detail: string;
+} | {
+    readonly outcome: "protocol_mismatch";
+    readonly detail: string;
+};
+//# sourceMappingURL=document-worker-protocol.d.ts.map

package/dist/document-worker-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-worker-protocol.d.ts","sourceRoot":"","sources":["../src/document-worker-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AAM7E,eAAO,MAAM,wBAAwB,EAAG,kCAA2C,CAAC;AACpF,eAAO,MAAM,4BAA4B,EAAG,sCAA+C,CAAC;AAO5F,MAAM,MAAM,qBAAqB,GAC7B;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC,CAAC;AAEN,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,OAAO,EAClB,iBAAiB,EAAE,MAAM,GAEvB;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,gCAAgC,CAAA;CAAE,GACpF;IAAE,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA0BrE;AAgGD,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,OAAO,EAClB,uBAAuB,EAAE,MAAM,GAAG,IAAI,EACtC,0BAA0B,EAAE,MAAM,GAAG,IAAI,GAEvC;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,gCAAgC,CAAA;CAAE,GACtF;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA+CrE"}

package/dist/document-worker-protocol.js

@@ -0,0 +1,103 @@
+import { zEvaluatedSourceDocumentResponse, zRejectedSourceDocumentResponse, } from "./generated/index.js";
+export const DOCUMENT_WORKER_PROTOCOL = "timbro.fiscal-document-worker.v1";
+export const DOCUMENT_EVALUATION_PROTOCOL = "timbro.fiscal-document-evaluation.v1";
+const FISCAL_DOCUMENT_ENGINE_NAME = "timbro-fiscal-engine";
+const FISCAL_DOCUMENT_RULES_VERSION = "timbro.fiscal-document-rules.v2";
+const SHA256_PATTERN = /^[0-9a-f]{64}$/u;
+const MONEY_PATTERN = /^(?:0|[1-9][0-9]*)\.[0-9]{2}$/u;
+const DOCUMENT_PATH_PATTERN = /^\/document(?:\/[A-Za-z0-9_-]+)*$/u;
+export function decodeDocumentWorkerResponse(candidate, expectedRequestId) {
+    const evaluated = zEvaluatedSourceDocumentResponse.safeParse(candidate);
+    if (evaluated.success && evaluated.data.outcome === "evaluated") {
+        const response = evaluated.data;
+        if (!(hasCommonIdentity(response, expectedRequestId, true) && hasValidTotals(response.totals))) {
+            return mismatch("the evaluated fiscal document response is incomplete or has an unexpected identity");
+        }
+        return { outcome: "decoded", response: response };
+    }
+    const rejected = zRejectedSourceDocumentResponse.safeParse(candidate);
+    if (rejected.success && rejected.data.outcome === "rejected") {
+        const response = rejected.data;
+        if (!(hasCommonIdentity(response, expectedRequestId, false) && hasProblems(response.problems))) {
+            return mismatch("the rejected fiscal document response is incomplete or has an unexpected identity");
+        }
+        return { outcome: "decoded", response: response };
+    }
+    return mismatch("the fiscal document evaluator returned an invalid response");
+}
+function isSha256(candidate) {
+    return typeof candidate === "string" && SHA256_PATTERN.test(candidate);
+}
+function hasCommonIdentity(response, expectedRequestId, requireHash) {
+    return (response.protocol === DOCUMENT_EVALUATION_PROTOCOL &&
+        response.request_id === expectedRequestId &&
+        response.engine.name === FISCAL_DOCUMENT_ENGINE_NAME &&
+        response.engine.version.length > 0 &&
+        response.rules_version === FISCAL_DOCUMENT_RULES_VERSION &&
+        (requireHash
+            ? isSha256(response.canonical_input_sha256)
+            : response.canonical_input_sha256 === undefined || isSha256(response.canonical_input_sha256)));
+}
+function hasProblems(problems) {
+    return (problems.length > 0 &&
+        problems.every((problem) => DOCUMENT_PATH_PATTERN.test(problem.path) &&
+            problem.code.length > 0 &&
+            problem.message.length > 0));
+}
+function hasValidTotals(totals) {
+    return ([totals.net, totals.tax, totals.total, totals.non_billable].every(isMoney) &&
+        totals.lines.length > 0 &&
+        totals.lines.every((line) => line.source_line_id.length > 0 && [line.net, line.tax, line.total].every(isMoney)));
+}
+function isMoney(value) {
+    return MONEY_PATTERN.test(value);
+}
+function mismatch(detail) {
+    return { outcome: "protocol_mismatch", detail };
+}
+export function decodeDocumentWorkerEvent(candidate, expectedWorkerRequestId, expectedEvaluatorRequestId) {
+    if (typeof candidate !== "object" || candidate === null) {
+        return {
+            outcome: "protocol_mismatch",
+            detail: "the fiscal document worker returned a malformed message",
+        };
+    }
+    const event = candidate;
+    if (event.protocol !== DOCUMENT_WORKER_PROTOCOL || event.request_id !== expectedWorkerRequestId) {
+        return {
+            outcome: "protocol_mismatch",
+            detail: "the fiscal document worker returned an unexpected identity",
+        };
+    }
+    if (event.type === "failed") {
+        if (typeof event.detail !== "string" || event.detail.length === 0) {
+            return {
+                outcome: "protocol_mismatch",
+                detail: "the fiscal document worker returned an invalid failure",
+            };
+        }
+        return { outcome: "failed", detail: event.detail };
+    }
+    if (event.type !== "evaluated") {
+        return {
+            outcome: "protocol_mismatch",
+            detail: "the fiscal document worker returned an unknown event",
+        };
+    }
+    if (expectedEvaluatorRequestId === null) {
+        return { outcome: "protocol_mismatch", detail: "the evaluated worker event has no request id" };
+    }
+    if (typeof event.response !== "object" ||
+        event.response === null ||
+        // biome-ignore lint/complexity/useLiteralKeys: response is narrowed from an unknown wire record.
+        typeof event.response["request_id"] !== "string") {
+        return {
+            outcome: "protocol_mismatch",
+            detail: "the evaluated worker event has no response request id",
+        };
+    }
+    const decoded = decodeDocumentWorkerResponse(event.response, expectedEvaluatorRequestId);
+    return decoded.outcome === "decoded"
+        ? { outcome: "evaluated", response: decoded.response }
+        : decoded;
+}

package/dist/document-worker.d.ts

@@ -0,0 +1,2 @@
+export declare function installDocumentWorker(): void;
+//# sourceMappingURL=document-worker.d.ts.map

package/dist/document-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-worker.d.ts","sourceRoot":"","sources":["../src/document-worker.ts"],"names":[],"mappings":"AAYA,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C"}

package/dist/document-worker.js

@@ -0,0 +1,71 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { DOCUMENT_WORKER_PROTOCOL, } from "./document-worker-protocol.js";
+let engine;
+export function installDocumentWorker() {
+    addEventListener("message", (event) => {
+        void serve(event.data);
+    });
+}
+if (typeof addEventListener === "function" && typeof postMessage === "function") {
+    installDocumentWorker();
+}
+async function serve(command) {
+    if (command.type === "initialize") {
+        engine = loadEngine(command.glue_module_url, command.wasm_module_url);
+        return;
+    }
+    if (engine === undefined) {
+        publishFailure(command.request_id, "the fiscal document worker was not initialized");
+        return;
+    }
+    try {
+        const loaded = await engine;
+        const responseJson = loaded.evaluateFiscalDocument(command.request);
+        if (typeof responseJson !== "string") {
+            publishFailure(command.request_id, "the fiscal document engine returned a non-string response");
+            return;
+        }
+        const response = JSON.parse(responseJson);
+        publish({
+            protocol: DOCUMENT_WORKER_PROTOCOL,
+            type: "evaluated",
+            request_id: command.request_id,
+            response,
+        });
+    }
+    catch (failure) {
+        publishFailure(command.request_id, describeFailure(failure));
+    }
+}
+async function loadEngine(glueModuleUrl, wasmModuleUrl) {
+    const loaded = await import(__rewriteRelativeImportExtension(/* @vite-ignore */ glueModuleUrl));
+    if (!isFiscalEngineGlue(loaded)) {
+        throw new Error("the fiscal document glue module is invalid");
+    }
+    await loaded.default({ module_or_path: wasmModuleUrl });
+    return loaded;
+}
+function isFiscalEngineGlue(candidate) {
+    return (typeof candidate === "object" &&
+        candidate !== null &&
+        "default" in candidate &&
+        typeof candidate.default === "function" &&
+        "evaluateFiscalDocument" in candidate &&
+        typeof candidate.evaluateFiscalDocument === "function");
+}
+function publish(event) {
+    postMessage(event);
+}
+function publishFailure(request_id, detail) {
+    publish({ protocol: DOCUMENT_WORKER_PROTOCOL, type: "failed", request_id, detail });
+}
+function describeFailure(failure) {
+    return failure instanceof Error ? failure.message : "the fiscal document evaluator failed";
+}

package/dist/document.d.ts

@@ -0,0 +1,38 @@
+export type { SourceDocumentEvaluationResponse, SourceSalesDocumentDraft, } from "./generated/index.ts";
+import type { SourceDocumentEvaluationResponse, SourceSalesDocumentDraft } from "./generated/index.ts";
+export declare const DOCUMENT_EVALUATION_PROTOCOL: "timbro.fiscal-document-evaluation.v1";
+export declare class FiscalDocumentEvaluatorError extends Error {
+    readonly code: "runtime_unavailable" | "protocol_mismatch" | "worker_failure";
+    constructor(message: string, code: FiscalDocumentEvaluatorError["code"]);
+}
+export type DocumentEvaluator = {
+    evaluate: (input: {
+        readonly document: SourceSalesDocumentDraft;
+    }) => Promise<SourceDocumentEvaluationResponse>;
+    /** Releases the worker and rejects any in-flight evaluations. */
+    readonly dispose: () => void;
+};
+export type DocumentEvaluatorOptions = {
+    /** Advanced native/Wasm bridge used by conformance harnesses and hosts with a worker already installed. */
+    readonly runtime?: (requestJson: string) => string | Promise<string>;
+    /** Advanced worker injection; ordinary callers should use evaluateFiscalDocument directly. */
+    readonly worker?: DocumentWorkerPort;
+    readonly glueModuleUrl?: string;
+    readonly wasmModuleUrl?: string;
+    readonly timeoutMs?: number;
+};
+export type DocumentWorkerPort = {
+    postMessage: (message: unknown) => void;
+    addEventListener: (type: "message" | "error" | "messageerror", listener: (event: MessageEvent<unknown> | ErrorEvent) => void) => void;
+    removeEventListener?: (type: "message" | "error" | "messageerror", listener: (event: MessageEvent<unknown> | ErrorEvent) => void) => void;
+    terminate?: () => void;
+};
+/** Evaluates a Source sales draft through the lazy browser-safe Rust/Wasm document runtime. */
+export declare function evaluateFiscalDocument(input: {
+    readonly document: SourceSalesDocumentDraft;
+}): Promise<SourceDocumentEvaluationResponse>;
+/** Releases the lazily created default worker, if one has been created. */
+export declare function disposeFiscalDocumentEvaluator(): void;
+/** Creates an evaluator while keeping worker and artifact details out of the common call. */
+export declare function createDocumentEvaluator(options?: DocumentEvaluatorOptions): DocumentEvaluator;
+//# sourceMappingURL=document.d.ts.map

package/dist/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AASA,YAAY,EACV,gCAAgC,EAChC,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EACV,gCAAgC,EAChC,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,4BAA4B,wCAAqC,CAAC;AAE/E,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,IAAI,EAAE,qBAAqB,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;IAE9E,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,CAAC,MAAM,CAAC,EAItE;CACF;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE;QAChB,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;KAC7C,KAAK,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAChD,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,2GAA2G;IAC3G,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,gBAAgB,EAAE,CAChB,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,cAAc,EAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,UAAU,KAAK,IAAI,KAC1D,IAAI,CAAC;IACV,mBAAmB,CAAC,EAAE,CACpB,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,cAAc,EAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,UAAU,KAAK,IAAI,KAC1D,IAAI,CAAC;IACV,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB,CAAC;AAIF,+FAA+F;AAC/F,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;CAC7C,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAG5C;AAED,2EAA2E;AAC3E,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD;AAED,6FAA6F;AAC7F,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,wBAA6B,GAAG,iBAAiB,CA8CjG"}