@render-foundation/utils 0.0.232-beta.0 → 0.0.232

package/lib/esm/src/client/dispersed.js

@@ -1,108 +0,0 @@
-import { consoleLogger } from '../logger';
-import fetch from 'node-fetch';
-/**
- * Dispersed Token Burn API client (M2M OAuth2 client_credentials).
- *
- * Thin transport only: it mints/caches the bearer token and posts the two burn
- * endpoints (claim, settle). It does NOT price RENDER, sum obligations, or do
- * any burn math — the consumer owns that (incl. the `settled_amount == Σ
- * obligation amounts` invariant). Amounts are passed through as decimal strings.
- *
- * Contract: see docs/dispersed-burn.md. Authoritative spec at
- * `{apiBaseUrl}/openapi.json` (tag "Burn Ledger").
- */
-// Both scopes, space-delimited, requested on every token mint.
-const SCOPES = 'burn_ledger_claims.create.all burn_ledger_settlements.create.all';
-// Re-mint a little before the token actually expires.
-const TOKEN_REFRESH_MARGIN_MS = 60_000;
-/**
- * Thrown on a 409 from settle: the claim is missing/expired/released/already
- * settled, an obligation mismatch, an amount mismatch, or a tx_signature reused
- * with a different payload. Nothing was written. Do NOT re-burn — reconcile.
- */
-export class DispersedConflictError extends Error {
-    body;
-    status = 409;
-    constructor(body) {
-        super(`dispersed 409 conflict: ${body}`);
-        this.body = body;
-        this.name = 'DispersedConflictError';
-    }
-}
-export const dispersedClient = (cfg, fetchImpl = fetch) => {
-    let cached;
-    const mintToken = async () => {
-        const res = await fetchImpl(`${cfg.authBaseUrl}/token`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({
-                grant_type: 'client_credentials',
-                client_id: cfg.clientId,
-                client_secret: cfg.clientSecret,
-                scope: SCOPES,
-            }),
-        });
-        if (res.status !== 200) {
-            throw new Error(`dispersed token mint failed. code: ${res.status} body: ${JSON.stringify(await res.text())}`);
-        }
-        const json = (await res.json());
-        cached = {
-            token: json.access_token,
-            expiresAt: Date.now() + json.expires_in * 1000,
-        };
-        return cached.token;
-    };
-    const getToken = async () => {
-        if (cached && Date.now() < cached.expiresAt - TOKEN_REFRESH_MARGIN_MS) {
-            return cached.token;
-        }
-        return mintToken();
-    };
-    // POST with bearer; one transparent re-mint+retry on 401 (a dropped daily run
-    // is expensive, so it's worth recovering from a token that died mid-flight).
-    const authedPost = async (path, body) => {
-        const doPost = (token) => fetchImpl(`${cfg.apiBaseUrl}${path}`, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                Authorization: `Bearer ${token}`,
-            },
-            body: JSON.stringify(body),
-        });
-        let res = await doPost(await getToken());
-        if (res.status === 401) {
-            cached = undefined;
-            res = await doPost(await mintToken());
-        }
-        return res;
-    };
-    return {
-        async claim({ from, to, limit }, log = consoleLogger) {
-            const res = await authedPost('/v1/burn-ledger-claims', {
-                executor_id: cfg.executorId,
-                from: from.toISOString(),
-                to: to.toISOString(),
-                ...(limit !== undefined ? { limit } : {}),
-            });
-            if (res.status !== 201) {
-                throw new Error(`dispersed claim failed. code: ${res.status} body: ${JSON.stringify(await res.text())}`);
-            }
-            const result = (await res.json());
-            log.info(`dispersed claim ${result.claim.uuid}: ${result.claimed_count} obligations, expires ${result.claim.claim_expires_at}`);
-            return result;
-        },
-        async settle(req, log = consoleLogger) {
-            const res = await authedPost('/v1/burn-ledger-settlements', req);
-            if (res.status === 409) {
-                throw new DispersedConflictError(await res.text());
-            }
-            if (res.status !== 201 && res.status !== 200) {
-                throw new Error(`dispersed settle failed. code: ${res.status} body: ${JSON.stringify(await res.text())}`);
-            }
-            const result = (await res.json());
-            log.info(`dispersed settle ${result.settlement.uuid} for tx ${req.tx_signature} (replay=${result.idempotent_replay})`);
-            return result;
-        },
-    };
-};
-//# sourceMappingURL=dispersed.js.map

package/lib/esm/src/client/dispersed.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dispersed.js","sourceRoot":"","sources":["../../../../src/client/dispersed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAgB,MAAM,WAAW,CAAA;AACvD,OAAO,KAAK,MAAM,YAAY,CAAA;AAE9B;;;;;;;;;;GAUG;AAEH,+DAA+D;AAC/D,MAAM,MAAM,GACV,kEAAkE,CAAA;AAEpE,sDAAsD;AACtD,MAAM,uBAAuB,GAAG,MAAM,CAAA;AA6EtC;;;;GAIG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAEnB;IADnB,MAAM,GAAG,GAAG,CAAA;IACrB,YAA4B,IAAY;QACtC,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAA;QADd,SAAI,GAAJ,IAAI,CAAQ;QAEtC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAA;IACtC,CAAC;CACF;AAUD,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,GAAoB,EACpB,YAAqB,KAA2B,EAC/B,EAAE;IACnB,IAAI,MAAwD,CAAA;IAE5D,MAAM,SAAS,GAAG,KAAK,IAAqB,EAAE;QAC5C,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,GAAG,CAAC,WAAW,QAAQ,EAAE;YACtD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,UAAU,EAAE,oBAAoB;gBAChC,SAAS,EAAE,GAAG,CAAC,QAAQ;gBACvB,aAAa,EAAE,GAAG,CAAC,YAAY;gBAC/B,KAAK,EAAE,MAAM;aACd,CAAC;SACH,CAAC,CAAA;QACF,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE;YACtB,MAAM,IAAI,KAAK,CACb,sCACE,GAAG,CAAC,MACN,UAAU,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAC7C,CAAA;SACF;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAG7B,CAAA;QACD,MAAM,GAAG;YACP,KAAK,EAAE,IAAI,CAAC,YAAY;YACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI;SAC/C,CAAA;QACD,OAAO,MAAM,CAAC,KAAK,CAAA;IACrB,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,KAAK,IAAqB,EAAE;QAC3C,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,uBAAuB,EAAE;YACrE,OAAO,MAAM,CAAC,KAAK,CAAA;SACpB;QACD,OAAO,SAAS,EAAE,CAAA;IACpB,CAAC,CAAA;IAED,8EAA8E;IAC9E,6EAA6E;IAC7E,MAAM,UAAU,GAAG,KAAK,EAAE,IAAY,EAAE,IAAa,EAAE,EAAE;QACvD,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE,CAC/B,SAAS,CAAC,GAAG,GAAG,CAAC,UAAU,GAAG,IAAI,EAAE,EAAE;YACpC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,KAAK,EAAE;aACjC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAA;QAEJ,IAAI,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAA;QACxC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE;YACtB,MAAM,GAAG,SAAS,CAAA;YAClB,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,SAAS,EAAE,CAAC,CAAA;SACtC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;IAED,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,GAAG,aAAa;YAClD,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,wBAAwB,EAAE;gBACrD,WAAW,EAAE,GAAG,CAAC,UAAU;gBAC3B,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE;gBACxB,EAAE,EAAE,EAAE,CAAC,WAAW,EAAE;gBACpB,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1C,CAAC,CAAA;YACF,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE;gBACtB,MAAM,IAAI,KAAK,CACb,iCAAiC,GAAG,CAAC,MAAM,UAAU,IAAI,CAAC,SAAS,CACjE,MAAM,GAAG,CAAC,IAAI,EAAE,CACjB,EAAE,CACJ,CAAA;aACF;YACD,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAgB,CAAA;YAChD,GAAG,CAAC,IAAI,CACN,mBAAmB,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,aAAa,yBAAyB,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,CACtH,CAAA;YACD,OAAO,MAAM,CAAA;QACf,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa;YACnC,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAA;YAChE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE;gBACtB,MAAM,IAAI,sBAAsB,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;aACnD;YACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE;gBAC5C,MAAM,IAAI,KAAK,CACb,kCAAkC,GAAG,CAAC,MAAM,UAAU,IAAI,CAAC,SAAS,CAClE,MAAM,GAAG,CAAC,IAAI,EAAE,CACjB,EAAE,CACJ,CAAA;aACF;YACD,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAiB,CAAA;YACjD,GAAG,CAAC,IAAI,CACN,oBAAoB,MAAM,CAAC,UAAU,CAAC,IAAI,WAAW,GAAG,CAAC,YAAY,YAAY,MAAM,CAAC,iBAAiB,GAAG,CAC7G,CAAA;YACD,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/lib/types/src/client/dispersed.d.ts

@@ -1,91 +0,0 @@
-import { RenderLogger } from '../logger';
-export type DispersedConfig = {
-    authBaseUrl: string;
-    apiBaseUrl: string;
-    clientId: string;
-    clientSecret: string;
-    executorId: string;
-};
-export type FetchFn = (url: string, init?: {
-    method?: string;
-    headers?: Record<string, string>;
-    body?: string;
-}) => Promise<{
-    status: number;
-    json(): Promise<unknown>;
-    text(): Promise<string>;
-}>;
-export type EurAmount = {
-    amount: string;
-    currency: 'EUR';
-};
-export type RenderAmount = {
-    amount: string;
-    currency: 'RENDER';
-};
-export type DispersedObligation = {
-    uuid: string;
-    amount: string;
-    currency: 'EUR';
-    status: string;
-};
-export type DispersedClaim = {
-    uuid: string;
-    executor_id: string;
-    status: string;
-    claimed_at: string;
-    claim_expires_at: string;
-};
-export type ClaimResult = {
-    claim: DispersedClaim;
-    claimed_count: number;
-    effective_window: {
-        from: string;
-        requested_to: string;
-        to: string;
-    };
-    obligations: DispersedObligation[];
-};
-export type SettleRequest = {
-    burn_ledger_claim_uuid: string;
-    obligation_uuids: string[];
-    settled_amount: EurAmount;
-    burned_amount: RenderAmount;
-    executed_at: string;
-    tx_signature: string;
-    pricing_snapshot?: Record<string, unknown>;
-    executor_metadata?: Record<string, unknown>;
-};
-export type SettleResult = {
-    settlement: {
-        uuid: string;
-        burn_ledger_claim_uuid: string;
-        tx_signature: string;
-        executed_at: string;
-        settled_amount: string;
-        currency: 'EUR';
-        burned_amount: RenderAmount;
-    };
-    applications: unknown[];
-    idempotent_replay: boolean;
-};
-/**
- * Thrown on a 409 from settle: the claim is missing/expired/released/already
- * settled, an obligation mismatch, an amount mismatch, or a tx_signature reused
- * with a different payload. Nothing was written. Do NOT re-burn — reconcile.
- */
-export declare class DispersedConflictError extends Error {
-    readonly body: string;
-    readonly status = 409;
-    constructor(body: string);
-}
-export interface DispersedClient {
-    claim(args: {
-        from: Date;
-        to: Date;
-        limit?: number;
-    }, log?: RenderLogger): Promise<ClaimResult>;
-    settle(req: SettleRequest, log?: RenderLogger): Promise<SettleResult>;
-}
-export declare const dispersedClient: (cfg: DispersedConfig, fetchImpl?: FetchFn) => DispersedClient;
-//# sourceMappingURL=dispersed.d.ts.map

package/lib/types/src/client/dispersed.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dispersed.d.ts","sourceRoot":"","sources":["../../../../src/client/dispersed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,YAAY,EAAE,MAAM,WAAW,CAAA;AAsBvD,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAID,MAAM,MAAM,OAAO,GAAG,CACpB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IACL,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,KACE,OAAO,CAAC;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IACxB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CACxB,CAAC,CAAA;AAEF,MAAM,MAAM,SAAS,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAA;CAAE,CAAA;AAC3D,MAAM,MAAM,YAAY,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAA;AAIjE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,KAAK,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,cAAc,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IACpE,WAAW,EAAE,mBAAmB,EAAE,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,cAAc,EAAE,SAAS,CAAA;IACzB,aAAa,EAAE,YAAY,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC5C,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,sBAAsB,EAAE,MAAM,CAAA;QAC9B,YAAY,EAAE,MAAM,CAAA;QACpB,WAAW,EAAE,MAAM,CAAA;QACnB,cAAc,EAAE,MAAM,CAAA;QACtB,QAAQ,EAAE,KAAK,CAAA;QACf,aAAa,EAAE,YAAY,CAAA;KAC5B,CAAA;IACD,YAAY,EAAE,OAAO,EAAE,CAAA;IACvB,iBAAiB,EAAE,OAAO,CAAA;CAC3B,CAAA;AAED;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;aAEnB,IAAI,EAAE,MAAM;IADxC,QAAQ,CAAC,MAAM,OAAM;gBACO,IAAI,EAAE,MAAM;CAIzC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CACH,IAAI,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAC9C,GAAG,CAAC,EAAE,YAAY,GACjB,OAAO,CAAC,WAAW,CAAC,CAAA;IACvB,MAAM,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CACtE;AAED,eAAO,MAAM,eAAe,QACrB,eAAe,cACT,OAAO,KACjB,eAqGF,CAAA"}