@avow-finance/sdk 0.0.0-stage → 0.2.0

package/dist/agent.js

@@ -0,0 +1,493 @@
+import { approvalCaps, approvalDigest, approvalMandateProblem, approvalPartiesProblem, approvalTermsProblem, approvalTokenProblem, chainedTermsShapeProblem, checkEnvelope, checkMandate, digestOf, isChainedTerms, isKeySignature, isTermsV1, lockTerms, MESSAGE_VERSIONS, mandateHash, newSalt, startReceiptTypedData, termsAgreementTypedData, termsHash, termsShapeProblem, } from '@avow-finance/spec';
+import { readBacking, verifyDependencies, } from '@avow-finance/verifier';
+import { hexToBigInt, isAddressEqual, toHex, } from 'viem';
+import { getBlock, getTransactionReceipt } from 'viem/actions';
+import { reserveCalls } from './lock.js';
+import { SEND_LIMITS, SendError, sendSponsored } from './send.js';
+/**
+ * A booking whose funding failed after Avow approved it. The agent has already read the lock
+ * after the approval stopped working, so `failed` means no reserve was funded and none can be.
+ * `unknown` means the chain didn't show the outcome in time. It carries the commitment and every
+ * transaction hash sent, so the agent can `reconcile` this booking later instead of making
+ * another one.
+ */
+export class BookingError extends Error {
+    outcome;
+    /** The commitment, whose terms are version 3 only when `commitToQuote` made it. */
+    commitment;
+    hashes;
+    constructor(message, outcome, commitment, hashes, options) {
+        super(message, options);
+        this.name = 'BookingError';
+        this.outcome = outcome;
+        this.commitment = commitment;
+        this.hashes = [...hashes];
+    }
+}
+/** Every call of Avow's records, so a JavaScript caller's `records` is checked for each. */
+const RECORD_CALLS = Object.keys({
+    cancel: true,
+    requestStart: true,
+    recordStart: true,
+});
+const randomUint = () => hexToBigInt(toHex(crypto.getRandomValues(new Uint8Array(16))));
+const systemClock = () => BigInt(Math.floor(Date.now() / 1000));
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * An agent that makes commitments under its mandate. It agrees terms with a supplier, asks Avow to
+ * approve the reserve, checks Avow's approval against the terms and the mandate before any money
+ * moves, and funds the reserve from the business's account with its own key while Avow's relay
+ * pays the fee. It cancels and starts jobs only through an `AvowApi` that has `records`.
+ */
+export function createAgent(config) {
+    const { client, key, avow, token } = config;
+    const mandate = config.mandate.message;
+    const d = {
+        chainId: config.mandate.chainId,
+        verifyingContract: config.mandate.lock,
+    };
+    const envelope = checkEnvelope(config.mandate, { type: 'Mandate', chainId: client.chain.id });
+    if (envelope)
+        throw new Error(`The mandate can't be used on this chain (${envelope})`);
+    if (!isAddressEqual(mandate.agentKey, key.accessKeyAddress)) {
+        throw new Error("The mandate names another agent key than this agent's");
+    }
+    if (!isAddressEqual(mandate.account, key.address)) {
+        throw new Error("The mandate names another business account than the key's");
+    }
+    if (token.chainId !== d.chainId || token.currency !== mandate.currency) {
+        throw new Error("The token isn't on the mandate's chain or in its currency");
+    }
+    const mHash = mandateHash(mandate, d);
+    const now = config.now ?? systemClock;
+    const offerValidity = config.offerValidity ?? 600n;
+    const maxApprovalValidity = config.maxApprovalValidity ?? 300n;
+    const permits = (action) => mandate.actions.includes(action);
+    // An AvowApi serves all of Avow's record calls or none. TypeScript refuses a partial group, and
+    // this refuses one from a JavaScript caller when the agent is made, before any call needs it.
+    const served = avow.records;
+    if (served) {
+        const missing = RECORD_CALLS.filter((call) => typeof served[call] !== 'function');
+        if (missing.length > 0) {
+            throw new Error(`The AvowApi's records lack ${missing.join(' and ')}. An AvowApi serves all of Avow's record calls or none.`);
+        }
+    }
+    /**
+     * Avow's records of cancellations and starts. TypeScript gives an agent `cancel` and `start` only
+     * when its `AvowApi` has them, so this refusal is for a JavaScript caller, before anything is
+     * read or sent.
+     */
+    const records = (what) => {
+        if (!served) {
+            throw new Error(`The AvowApi this agent uses has no records, so it can't ${what}. httpAvowApi serves them.`);
+        }
+        return served;
+    };
+    const send = config.send ??
+        ((calls) => sendSponsored({
+            client,
+            account: key,
+            calls,
+            sponsor: (transaction) => avow.sponsor(transaction),
+            ...(config.limits ? { limits: config.limits } : {}),
+        }));
+    /**
+     * Why an approval differs from what the agent asked for, or null when it doesn't. The lock
+     * enforces what the approval says, so the agent funds only an approval that names exactly the
+     * terms, parties and mandate it agreed, and that the lock will still take.
+     */
+    function approvalProblem(approval, expected) {
+        const envelopeProblem = checkEnvelope(approval, {
+            type: 'Approval',
+            chainId: d.chainId,
+            lock: d.verifyingContract,
+        });
+        if (envelopeProblem)
+            return envelopeProblem;
+        const a = approval.message;
+        if (a.commitmentId.toLowerCase() !== expected.commitmentId.toLowerCase()) {
+            return 'approval.commitment_mismatch';
+        }
+        const parties = approvalPartiesProblem(a, expected.supplier);
+        if (parties)
+            return parties;
+        const tokenProblem = approvalTokenProblem(a, token.token);
+        if (tokenProblem)
+            return tokenProblem;
+        const termsProblem = approvalTermsProblem(a, {
+            lock: lockTerms(expected.terms, token.decimals),
+            termsHash: expected.termsHash,
+        });
+        if (termsProblem)
+            return termsProblem;
+        // The agent funds the reserve with its own key, so the approval has to name that key.
+        const mandateProblem = approvalMandateProblem(a, {
+            mandateHash: mHash,
+            caps: approvalCaps(mandate, token.decimals),
+            fundingKeys: [key.accessKeyAddress],
+        });
+        if (mandateProblem)
+            return mandateProblem;
+        // The lock refuses an approval past its expiry or its acceptance deadline.
+        if (a.expiry <= now())
+            return 'message.expired';
+        if (a.acceptBy <= now())
+            return 'authorization.accept_by_passed';
+        if (a.expiry > now() + maxApprovalValidity)
+            return 'message.validity_too_long';
+        return null;
+    }
+    /**
+     * What the lock holds for the commitment as of the block the funding landed in, read again
+     * while the node answers with an error, since a node without the block refuses the read.
+     */
+    async function backingAt(commitmentId, blockNumber) {
+        for (let i = 1;; i++) {
+            try {
+                return await readBacking(client, d.verifyingContract, commitmentId, 'buyer', {
+                    blockNumber,
+                });
+            }
+            catch (error) {
+                if (i >= 6)
+                    throw error;
+                await sleep(1500);
+            }
+        }
+    }
+    const limits = config.limits ?? SEND_LIMITS;
+    /**
+     * The first of the agent's own transactions whose receipt shows it succeeded with a log from the
+     * lock, or null when none shows one. That's when the reserve landed in a transaction the agent
+     * didn't send, or when a receipt couldn't be read.
+     */
+    async function landedOf(hashes) {
+        for (const hash of hashes) {
+            const receipt = await getTransactionReceipt(client, { hash }).catch(() => null);
+            if (receipt?.status === 'success' &&
+                receipt.logs.some((l) => isAddressEqual(l.address, d.verifyingContract))) {
+                return hash;
+            }
+        }
+        return null;
+    }
+    /**
+     * Reads the lock for an approved commitment once no transaction carrying Avow's approval can
+     * still land. The lock takes the approval only in a block before its expiry and before the
+     * acceptance deadline, so it reads the lock as of a finalized block at or past the earlier of
+     * the two, which no later block can change. It waits for that block up to the limit's receipt
+     * timeout.
+     */
+    async function reconcile(approved, hashes = []) {
+        const a = approved.approval.message;
+        const closes = a.expiry < a.acceptBy ? a.expiry : a.acceptBy;
+        const digest = approvalDigest(a, d).toLowerCase();
+        const deadline = Date.now() + limits.receiptTimeout;
+        for (;;) {
+            const final = await getBlock(client, { blockTag: 'finalized' }).catch(() => null);
+            if (final && final.timestamp >= closes) {
+                const read = (at) => readBacking(client, d.verifyingContract, approved.commitmentId, 'buyer', at === undefined ? {} : { blockNumber: at }).catch(() => undefined);
+                // A read that fails is read again, never taken as an empty lock.
+                const held = await read(final.number);
+                if (held) {
+                    if (held.approvalHash.toLowerCase() !== digest)
+                        return { outcome: 'unknown' };
+                    return { outcome: 'funded', reservedIn: await landedOf(hashes) };
+                }
+                if (held === null) {
+                    // Nothing carrying the approval can land after that block, so the latest block has to
+                    // agree. A node that answered the past block from other state shows up here.
+                    const latest = await read();
+                    if (latest === null)
+                        return { outcome: 'failed' };
+                    if (latest)
+                        return { outcome: 'unknown' };
+                }
+            }
+            if (Date.now() > deadline)
+                return { outcome: 'unknown' };
+            await sleep(limits.wait);
+        }
+    }
+    /** Why a supplier's start receipt doesn't answer the start request, or null when it does. */
+    function receiptProblem(receipt, expected) {
+        const envelopeProblem = checkEnvelope(receipt, {
+            type: 'StartReceipt',
+            chainId: d.chainId,
+            lock: d.verifyingContract,
+        });
+        if (envelopeProblem)
+            return envelopeProblem;
+        const m = receipt.message;
+        if (m.commitmentId.toLowerCase() !== expected.commitmentId.toLowerCase() ||
+            m.startRequestHash.toLowerCase() !== expected.startRequestHash.toLowerCase() ||
+            m.side !== 'buyer' ||
+            m.startedAt < expected.requestedAt) {
+            return 'message.invalid';
+        }
+        if (m.expiry <= now())
+            return 'message.expired';
+        const digest = digestOf(startReceiptTypedData(m, d));
+        if (!isKeySignature(digest, receipt.signature, expected.signer)) {
+            return 'message.signature_invalid';
+        }
+        return null;
+    }
+    // Every agent has `cancel` and `start` at run time, so a JavaScript caller whose `AvowApi` has
+    // no records learns why from the error. `Agent<A>` shows them only when `A` has records.
+    /** The reserve request Avow approves and the mandate check reads, for terms of either version. */
+    function requestOf(commitmentId, supplier, category, terms) {
+        return {
+            commitmentId,
+            agentKey: key.accessKeyAddress,
+            supplier: supplier.businessId,
+            payee: supplier.payee,
+            category,
+            terms,
+        };
+    }
+    /**
+     * The same check Avow and a supplier's verifier run, or null when it approves. The lock enforces
+     * the open reserves cap, so this check counts none open, as the verifier does. The SDK can't yet
+     * carry the administrator's approval in person, so a reserve the mandate sends to them is
+     * refused.
+     */
+    function mandateCheck(request) {
+        const allowed = checkMandate({
+            mandate,
+            request,
+            token,
+            openReserves: 0n,
+            revoked: false,
+            now: now(),
+            profile: config.profile,
+        });
+        return allowed.result === 'approved' ? null : allowed.reason;
+    }
+    /**
+     * Signs the agreement as the buyer once the supplier's signature checks out, asks Avow to
+     * approve the reserve, and checks the approval against the terms and the mandate. Version 3
+     * terms then pass `verifyDependencies` on that approval, which names the owner of each booking
+     * they rely on, and the mandate check on the checked terms. Only then is the reserve funded.
+     */
+    async function commitAgreed(a) {
+        const { supplier, terms, salt, agreement } = a;
+        const digest = digestOf(termsAgreementTypedData(agreement, d));
+        if (!isKeySignature(digest, a.supplierSignature, supplier.signingKey)) {
+            return { ok: false, reason: 'message.signature_invalid', layer: 'sdk' };
+        }
+        const buyerSignature = await key.sign({ hash: digest, raw: true });
+        const signed = {
+            type: 'TermsAgreement',
+            schemaVersion: MESSAGE_VERSIONS.TermsAgreement,
+            chainId: d.chainId,
+            lock: d.verifyingContract,
+            message: agreement,
+            buyerSignature,
+            supplierSignature: a.supplierSignature,
+        };
+        const { commitmentId } = agreement;
+        const request = requestOf(commitmentId, supplier, agreement.category, terms);
+        const answer = await avow.approveReserve({
+            request,
+            salt,
+            agreement: signed,
+            fundedBy: 'agent',
+        });
+        if (!answer.ok) {
+            return { ok: false, reason: answer.reason, layer: 'avow', decisionId: answer.decisionId };
+        }
+        const { decisionId } = answer;
+        const problem = approvalProblem(answer.approval, {
+            commitmentId,
+            supplier,
+            terms,
+            termsHash: agreement.termsHash,
+        });
+        if (problem)
+            return { ok: false, reason: problem, layer: 'sdk', decisionId };
+        let dependencies = [];
+        if (isChainedTerms(terms)) {
+            const relied = await verifyDependencies({ terms, approval: answer.approval.message, disclosed: a.disclosed ?? [], now: now() }, config.dependencies ?? { readers: [] });
+            if (!relied.ok)
+                return { ...relied, layer: 'sdk', decisionId };
+            const allowed = mandateCheck({ ...request, terms: relied.terms });
+            if (allowed)
+                return { ok: false, reason: allowed, layer: 'sdk', decisionId };
+            dependencies = relied.checked;
+        }
+        const approved = {
+            commitmentId,
+            supplier,
+            terms,
+            salt,
+            termsHash: agreement.termsHash,
+            agreement: signed,
+            approval: answer.approval,
+        };
+        const reservedIn = await fund(approved);
+        return { ok: true, commitment: { ...approved, reservedIn }, dependencies };
+    }
+    /**
+     * Funds an approved reserve with the agent's key and returns the transaction that funded it,
+     * once the lock holds the commitment under exactly the approval the agent checked. When funding
+     * fails it reads the lock after the approval stops working, returns if the reserve landed
+     * anyway, and otherwise throws a `BookingError`.
+     */
+    async function fund(approved) {
+        const { commitmentId, approval } = approved;
+        let landed = null;
+        let failure = null;
+        try {
+            landed = await send(reserveCalls(approval, d));
+        }
+        catch (error) {
+            failure = error;
+        }
+        if (landed) {
+            const held = await backingAt(commitmentId, landed.blockNumber).catch(() => null);
+            const expected = approvalDigest(approval.message, d).toLowerCase();
+            if (held && held.approvalHash.toLowerCase() === expected)
+                return landed.transactionHash;
+        }
+        const hashes = failure instanceof SendError ? failure.hashes : landed ? [landed.transactionHash] : [];
+        const what = failure
+            ? failure instanceof Error
+                ? failure.message
+                : String(failure)
+            : `${landed?.transactionHash} landed, but the lock didn't show the reserve under Avow's approval`;
+        // A transaction the key never signed can't land, so a send that failed before signing
+        // settles the booking.
+        if (failure instanceof SendError && failure.signings === 0) {
+            throw new BookingError(`Funding ${commitmentId} failed: ${what}`, 'failed', approved, hashes, {
+                cause: failure,
+            });
+        }
+        const settled = await reconcile(approved, hashes);
+        if (settled.outcome === 'funded')
+            return settled.reservedIn;
+        throw new BookingError(settled.outcome === 'failed'
+            ? `Funding ${commitmentId} failed, and the lock holds no reserve for it: ${what}`
+            : `Whether ${commitmentId} was funded is unknown: ${what}`, settled.outcome, approved, hashes, { cause: failure ?? undefined });
+    }
+    const agent = {
+        account: mandate.account,
+        lock: d.verifyingContract,
+        domain: d,
+        mandateHash: mHash,
+        async book(b) {
+            const { terms } = b;
+            // A new commitment takes version 2 terms. Version 1 is only for commitments made under it,
+            // and version 3 terms come signed by their supplier through `commitToQuote`, so both stop
+            // here, before anything is signed.
+            if (isTermsV1(terms) || isChainedTerms(terms)) {
+                return { ok: false, reason: 'terms.version_unknown' };
+            }
+            const supplier = b.supplier.profile;
+            const commitmentId = toHex(crypto.getRandomValues(new Uint8Array(32)));
+            const allowed = mandateCheck(requestOf(commitmentId, supplier, b.category, terms));
+            if (allowed)
+                return { ok: false, reason: allowed };
+            const salt = newSalt();
+            const agreement = {
+                commitmentId,
+                termsHash: termsHash(terms, salt),
+                category: b.category,
+                buyerBusinessId: mandate.businessId,
+                supplierBusinessId: supplier.businessId,
+                mandateHash: mHash,
+                nonce: randomUint(),
+                expiry: now() + offerValidity,
+            };
+            const supplierSignature = await b.supplier.signAgreement({
+                agreement,
+                terms,
+                salt,
+                domain: d,
+            });
+            const done = await commitAgreed({ supplier, terms, salt, agreement, supplierSignature });
+            if (done.ok)
+                return { ok: true, commitment: { ...done.commitment, terms } };
+            return done.decisionId === undefined
+                ? { ok: false, reason: done.reason }
+                : { ok: false, reason: done.reason, decisionId: done.decisionId };
+        },
+        async commitToQuote(q) {
+            const { terms, agreement: a } = q;
+            if (isTermsV1(terms))
+                return { ok: false, reason: 'terms.version_unknown', layer: 'sdk' };
+            const shape = isChainedTerms(terms)
+                ? chainedTermsShapeProblem(terms)
+                : termsShapeProblem(terms);
+            if (shape)
+                return { ok: false, reason: shape, layer: 'sdk' };
+            if (termsHash(terms, q.salt).toLowerCase() !== a.termsHash.toLowerCase()) {
+                return { ok: false, reason: 'terms.hash_mismatch', layer: 'sdk' };
+            }
+            const parties = a.buyerBusinessId === mandate.businessId &&
+                a.mandateHash.toLowerCase() === mHash.toLowerCase() &&
+                a.supplierBusinessId === q.supplier.businessId;
+            if (!parties)
+                return { ok: false, reason: 'agreement.parties_mismatch', layer: 'sdk' };
+            if (a.expiry <= now())
+                return { ok: false, reason: 'message.expired', layer: 'sdk' };
+            if (a.expiry > now() + offerValidity) {
+                return { ok: false, reason: 'message.validity_too_long', layer: 'sdk' };
+            }
+            // Version 2 terms go through the mandate check before anything is signed, as in `book`.
+            // Version 3 terms go through it once their bookings are checked, since it takes them only as
+            // checked terms.
+            if (!isChainedTerms(terms)) {
+                const allowed = mandateCheck(requestOf(a.commitmentId, q.supplier, a.category, terms));
+                if (allowed)
+                    return { ok: false, reason: allowed, layer: 'sdk' };
+            }
+            return commitAgreed({
+                supplier: q.supplier,
+                terms,
+                salt: q.salt,
+                agreement: a,
+                supplierSignature: q.supplierSignature,
+                disclosed: q.disclosed ?? [],
+            });
+        },
+        reconcile,
+        async cancel(commitmentId) {
+            const served = records('record a cancellation');
+            if (!permits('cancel'))
+                return { ok: false, reason: 'mandate.action_not_permitted' };
+            const { cancelledAt } = await served.cancel({ commitmentId });
+            return { ok: true, cancelledAt };
+        },
+        async start(commitmentId, supplier) {
+            const served = records('start the job');
+            if (!permits('start'))
+                return { ok: false, reason: 'mandate.action_not_permitted' };
+            // The receipt has to come from the signing key the lock holds for the commitment.
+            const held = await readBacking(client, d.verifyingContract, commitmentId, 'buyer');
+            if (!held)
+                return { ok: false, reason: 'chain.reserve_missing' };
+            if (!isAddressEqual(held.supplierSigner, supplier.profile.signingKey)) {
+                return { ok: false, reason: 'chain.supplier_mismatch' };
+            }
+            const request = await served.requestStart({ commitmentId });
+            const receipt = await supplier.startJob({ commitmentId, ...request });
+            const problem = receiptProblem(receipt, {
+                commitmentId,
+                ...request,
+                signer: held.supplierSigner,
+            });
+            if (problem)
+                return { ok: false, reason: problem };
+            const recorded = await served.recordStart({ commitmentId, receipt });
+            if (!recorded.ok)
+                return { ok: false, reason: recorded.reason };
+            return { ok: true, receipt };
+        },
+        commitment(commitmentId) {
+            return readBacking(client, d.verifyingContract, commitmentId, 'buyer');
+        },
+    };
+    return agent;
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/avow-api.d.ts

@@ -0,0 +1,78 @@
+import type { ContestStatementAnswer, ContestStatementRequest, ReasonCode, ReserveApproval, ReserveApprovalRequest, Signed, StartReceipt } from '@avow-finance/spec';
+import type { Hex } from 'viem';
+export type { ReserveApproval, ReserveApprovalRequest } from '@avow-finance/spec';
+/**
+ * Avow's records of cancellations and job starts. An `AvowApi` serves all three calls together, as
+ * its `records`, or none of them. Avow's hosted API serves all three, each answer carrying Avow's
+ * timestamp on the request.
+ */
+export interface AvowRecords {
+    /**
+     * Records the business cancelling a commitment, timestamped by Avow, once free cancellation has
+     * ended and until the no-show charge can be reported. Before then the business cancels on the
+     * lock, and Avow refuses with `commitment.cancel_on_lock`. After it a cancellation no longer
+     * changes the charge, and Avow refuses with `commitment.cancel_closed`. A commitment has one
+     * cancellation, so every later call gives the first one's time.
+     */
+    cancel(request: {
+        commitmentId: Hex;
+    }): Promise<{
+        cancelledAt: bigint;
+    }>;
+    /**
+     * Timestamps the business's request to start a job. The supplier's start receipt names the
+     * request's hash, and the job can't have started before the timestamp.
+     */
+    requestStart(request: {
+        commitmentId: Hex;
+    }): Promise<{
+        startRequestHash: Hex;
+        requestedAt: bigint;
+    }>;
+    /** Records the supplier's start receipt, which a kept booking rests on, or refuses it. */
+    recordStart(request: {
+        commitmentId: Hex;
+        receipt: Signed<StartReceipt>;
+    }): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        reason: ReasonCode;
+    }>;
+}
+/**
+ * Avow's side of an agent's commitments. Avow's hosted API implements it over HTTP through
+ * `httpAvowApi`, which signs each request with the agent's key, and a local stand-in implements it
+ * for a demo or a test. Pre-release, so it may change before 1.0.
+ *
+ * Avow's records of cancellations and job starts are one optional group, `records`, which a
+ * stand-in for a demo or a test may leave out. `createAgent` gives an agent `cancel` and `start`
+ * only when its `AvowApi` has `records`.
+ */
+export interface AvowApi {
+    /** Avow's reserve check. It signs an approval the lock takes, or refuses with a reason code. */
+    approveReserve(request: ReserveApprovalRequest): Promise<ReserveApproval>;
+    /**
+     * Has Avow's relay co-sign a transaction the agent signed with `feePayer: true`, so the relay
+     * pays its fee and the business needs no fee token. It takes and returns serialized bytes, and
+     * never sends them. The relay signs only when each call goes to the business's own lock or
+     * approves that lock to pull the reserve token. The agent checks the co-signed bytes, sends them
+     * itself and tracks their hash.
+     */
+    sponsor(transaction: Hex): Promise<Hex>;
+    /** Avow's records of cancellations and job starts, all three calls or none. */
+    records?: AvowRecords;
+}
+/**
+ * Avow's records the business account's own root key writes to, which Avow's hosted API serves
+ * through `httpBusinessRecords`. Pre-release, so it may change before 1.0.
+ */
+export interface BusinessRecords {
+    /**
+     * Gives Avow the statement for a contest the lock already took, naming the transaction that
+     * carried it, so Avow holds the text it rules on. A commitment has one statement, so posting the
+     * same one again gets the first answer, and posting again is always safe.
+     */
+    postContestStatement(request: ContestStatementRequest): Promise<ContestStatementAnswer>;
+}
+//# sourceMappingURL=avow-api.d.ts.map

package/dist/avow-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avow-api.d.ts","sourceRoot":"","sources":["../src/avow-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,MAAM,EACN,YAAY,EACb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAE/B,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAEjF;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE;QAAE,YAAY,EAAE,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACxE;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE;QACpB,YAAY,EAAE,GAAG,CAAA;KAClB,GAAG,OAAO,CAAC;QAAE,gBAAgB,EAAE,GAAG,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC3D,0FAA0F;IAC1F,WAAW,CAAC,OAAO,EAAE;QACnB,YAAY,EAAE,GAAG,CAAA;QACjB,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,CAAA;KAC9B,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC,CAAA;CAC9D;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,OAAO;IACtB,gGAAgG;IAChG,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IACzE;;;;;;OAMG;IACH,OAAO,CAAC,WAAW,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACvC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;CACxF"}

package/dist/avow-api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=avow-api.js.map

package/dist/avow-api.js.map

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