@unbrowse/sdk 6.17.0-preview.6

package/dist/flex.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Flex payment primitives — typed shapes for the @faremeter/flex-solana
+ * escrow-and-session-key payment scheme. Day-4: real wiring against
+ * @faremeter/flex-solana@0.2.1 (peer + optional dep so SDK callers who only
+ * use free routes don't pull @solana/kit).
+ *
+ * Aligned with the package's exported wire shape:
+ *   - `FlexPaymentPayload` (`@faremeter/flex-solana/types`) =
+ *     { escrow, mint, maxAmount, authorizationId, expiresAtSlot,
+ *       splits[], sessionKey, signature }
+ *   - `FlexPaymentRequirementsExtra` (`@faremeter/flex-solana/types`) =
+ *     { facilitator, supportedMints[], splits[], escrow?, minGracePeriodSlots? }
+ *   - `SplitInput` (`@faremeter/flex-solana/authorization`) =
+ *     { recipient: Address, bps: number }
+ *
+ * IMPORTANT (tree-shake invariant from Day 3): this file MUST NOT import
+ * @faremeter/flex-solana at top-level. All package references go through
+ * `await import("@faremeter/flex-solana")` inside function bodies so SDK
+ * callers who never sign Flex authorizations don't pull @solana/kit (~3MB).
+ */
+import type { PaymentRequiredError } from "./errors.js";
+/** USDC SPL mint addresses. v6.16 defaults to mainnet; callers override per-env. */
+export declare const USDC_MINT_MAINNET = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+export declare const USDC_MINT_DEVNET = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
+/**
+ * Unsigned Flex payment authorization. Matches the persistable subset of
+ * `FlexPaymentPayload` from @faremeter/flex-solana minus the wire-only
+ * `sessionKey` (added at signing time) and `signature` (added at signing
+ * time). All numeric fields are base10 strings so the shape survives JSON.
+ */
+export interface FlexAuthorization {
+    /** Base58 escrow PDA. */
+    escrow: string;
+    /** USDC mint address (base58). */
+    mint: string;
+    /** µ¢ atomic units the facilitator may draw, as base10 string. */
+    maxAmount: string;
+    /** Random u64 as base10 string, used for replay protection. */
+    authorizationId: string;
+    /** Slot height after which this authorization is invalid, as base10 string. */
+    expiresAtSlot: string;
+    /**
+     * Up to 5 splits whose bps sum to exactly 10000. Each recipient is a
+     * base58 token-account address; bps is an integer in [1, 10000].
+     * Matches `SplitInput` from @faremeter/flex-solana/authorization.d.ts.
+     */
+    splits: Array<{
+        recipient: string;
+        bps: number;
+    }>;
+}
+/**
+ * Minimal contract a caller's Flex wallet must satisfy. The wallet owns
+ * the escrow PDA AND has registered a session key — both wire-time facts
+ * the SDK does not produce, only consume.
+ */
+export interface FlexWalletLike {
+    /** Wallet address that owns the escrow PDA (base58). */
+    address: string;
+    /** Registered session key address (base58). */
+    sessionKeyAddress: string;
+    /**
+     * Sign the authorization with the session key's Ed25519 secret. Returns
+     * the 64-byte signature as base64 — same shape the on-chain
+     * `createEd25519VerifyInstruction` expects.
+     */
+    signFlexAuthorization(auth: FlexAuthorization): Promise<string>;
+}
+/**
+ * Opaque signer object — the caller's `@solana/kit`-compatible
+ * `TransactionSigner` for the escrow owner / depositor. We avoid pulling
+ * @solana/kit types here (tree-shake); the lazy-imported instruction
+ * builders accept this through structural typing.
+ */
+export type TransactionSignerOpaque = any;
+/** Arguments for `fundEscrow` — builds + sends create-escrow + deposit in one tx. */
+export interface FlexFundEscrowParams {
+    walletAddress: string;
+    facilitatorAddress: string;
+    amountUsdc: string;
+    refundTimeoutSlots?: number;
+    deadmanTimeoutSlots?: number;
+    /** USDC mint (defaults to mainnet USDC). */
+    mint?: string;
+    /**
+     * Optional caller-supplied `TransactionSigner` for the wallet. If
+     * omitted, `fundEscrow` rejects with a `requires_signer` error and
+     * recommends `buildEscrowCreationTx` instead.
+     */
+    signer?: TransactionSignerOpaque;
+    /** Optional caller-supplied `@solana/kit` RPC + sender; if omitted we throw. */
+    rpc?: unknown;
+    rpcSubscriptions?: unknown;
+}
+/** Arguments for `registerSessionKey`. */
+export interface FlexRegisterSessionKeyParams {
+    walletAddress: string;
+    escrowAddress: string;
+    sessionKeyAddress: string;
+    expiresAtSlot?: string;
+    revocationGracePeriodSlots?: number;
+    signer?: TransactionSignerOpaque;
+    rpc?: unknown;
+}
+/** Pure tx-build result — what the sender wrappers consume. */
+export interface BuiltFlexTx {
+    /** Instructions to feed `@solana/kit`'s tx message builder. */
+    instructions: unknown[];
+    /**
+     * Addresses the user is putting at risk by signing this tx. Lets a wallet
+     * UI render a sane confirmation screen ("you are depositing X USDC into
+     * escrow Y, registering session key Z against facilitator F").
+     */
+    accountsAtRisk: string[];
+    /** Programmatic hint about what this tx does. */
+    intent: "create_escrow_and_deposit" | "register_session_key";
+}
+/**
+ * Build an unsigned `FlexAuthorization`. Validates splits sum, generates
+ * a random `authorizationId`, and returns the canonical JSON shape.
+ *
+ * Cited symbol: shape mirrors `FlexPaymentPayload` from
+ * `@faremeter/flex-solana/types` (minus wire-only `sessionKey`/`signature`).
+ */
+export declare function buildFlexAuthorization(opts: {
+    escrow: string;
+    mint: string;
+    maxAmount: string;
+    splits: FlexAuthorization["splits"];
+    expiresAtSlot: string;
+}): Promise<FlexAuthorization>;
+/**
+ * Settle a `PaymentRequiredError` whose `accepts[]` advertises a Flex
+ * scheme. Picks the first Flex-shaped requirement (one whose
+ * `extra.escrow` and `extra.splits` are populated — matches
+ * `FlexPaymentRequirementsExtra` from `@faremeter/flex-solana/types`),
+ * has the wallet sign, packs as `FlexPaymentPayload` inside an
+ * `X402PaymentPayload`, base64-encodes, and replays via
+ * `retry(paymentHeader)`.
+ */
+export declare function payAndRetryFlex<T>(error: PaymentRequiredError, wallet: FlexWalletLike, retry: (paymentHeader: string) => Promise<T>): Promise<T>;
+/**
+ * Pure tx-builder for create-escrow + deposit (no signer required, no
+ * network call). Returns instructions a caller can sign + send with any
+ * `@solana/kit`-compatible runtime. Lazy-imports @faremeter/flex-solana
+ * so tree-shake is preserved.
+ *
+ * Cited symbols: `getCreateEscrowInstructionAsync`, `getDepositInstructionAsync`
+ * (both from `@faremeter/flex-solana` root export, per
+ * `/tmp/flex-probe/.../flex-solana/dist/src/index.d.ts:9`).
+ */
+export declare function buildEscrowCreationTx(params: FlexFundEscrowParams): Promise<BuiltFlexTx>;
+/**
+ * Pure tx-builder for register-session-key (no signer required).
+ *
+ * Cited symbol: `getRegisterSessionKeyInstructionAsync` from
+ * `@faremeter/flex-solana` root export.
+ */
+export declare function buildSessionKeyRegistrationTx(params: FlexRegisterSessionKeyParams): Promise<BuiltFlexTx>;
+/**
+ * Send a create-escrow + deposit transaction. Requires `params.signer`
+ * and `params.rpc` — both `@solana/kit` types we don't import at
+ * top-level (tree-shake). Without them, throws `requires_signer` and
+ * points at `buildEscrowCreationTx` for the pure-build path.
+ */
+export declare function fundEscrow(params: FlexFundEscrowParams): Promise<{
+    escrowAddress: string;
+    txSignature: string;
+}>;
+/**
+ * Send a register-session-key transaction. Thin sender wrapper around
+ * `buildSessionKeyRegistrationTx`. Same `requires_signer` contract as
+ * `fundEscrow`.
+ */
+export declare function registerSessionKey(params: FlexRegisterSessionKeyParams): Promise<{
+    txSignature: string;
+}>;
+//# sourceMappingURL=flex.d.ts.map

package/dist/flex.d.ts.map

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

package/dist/flex.js

@@ -0,0 +1,299 @@
+/**
+ * Flex payment primitives — typed shapes for the @faremeter/flex-solana
+ * escrow-and-session-key payment scheme. Day-4: real wiring against
+ * @faremeter/flex-solana@0.2.1 (peer + optional dep so SDK callers who only
+ * use free routes don't pull @solana/kit).
+ *
+ * Aligned with the package's exported wire shape:
+ *   - `FlexPaymentPayload` (`@faremeter/flex-solana/types`) =
+ *     { escrow, mint, maxAmount, authorizationId, expiresAtSlot,
+ *       splits[], sessionKey, signature }
+ *   - `FlexPaymentRequirementsExtra` (`@faremeter/flex-solana/types`) =
+ *     { facilitator, supportedMints[], splits[], escrow?, minGracePeriodSlots? }
+ *   - `SplitInput` (`@faremeter/flex-solana/authorization`) =
+ *     { recipient: Address, bps: number }
+ *
+ * IMPORTANT (tree-shake invariant from Day 3): this file MUST NOT import
+ * @faremeter/flex-solana at top-level. All package references go through
+ * `await import("@faremeter/flex-solana")` inside function bodies so SDK
+ * callers who never sign Flex authorizations don't pull @solana/kit (~3MB).
+ */
+/** USDC SPL mint addresses. v6.16 defaults to mainnet; callers override per-env. */
+export const USDC_MINT_MAINNET = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+export const USDC_MINT_DEVNET = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
+function randomAuthorizationId() {
+    // 8 random bytes → bigint (u64) → base10 string. Matches
+    // `SerializePaymentAuthorizationArgs.authorizationId: bigint` at the boundary.
+    const bytes = new Uint8Array(8);
+    crypto.getRandomValues(bytes);
+    let n = 0n;
+    for (const b of bytes)
+        n = (n << 8n) | BigInt(b);
+    return n.toString(10);
+}
+function validateSplits(splits) {
+    if (!Array.isArray(splits) || splits.length === 0 || splits.length > 5) {
+        throw new Error(`flex: splits must be 1..5 entries, got ${splits?.length ?? 0}`);
+    }
+    const sum = splits.reduce((s, e) => s + e.bps, 0);
+    if (sum !== 10_000) {
+        throw new Error(`flex: splits bps must sum to 10000, got ${sum}`);
+    }
+    for (const s of splits) {
+        if (!s.recipient || typeof s.recipient !== "string") {
+            throw new Error("flex: split.recipient must be a base58 address");
+        }
+        if (!Number.isInteger(s.bps) || s.bps < 1 || s.bps > 10_000) {
+            throw new Error(`flex: split.bps must be int in [1,10000], got ${s.bps}`);
+        }
+    }
+}
+/**
+ * Build an unsigned `FlexAuthorization`. Validates splits sum, generates
+ * a random `authorizationId`, and returns the canonical JSON shape.
+ *
+ * Cited symbol: shape mirrors `FlexPaymentPayload` from
+ * `@faremeter/flex-solana/types` (minus wire-only `sessionKey`/`signature`).
+ */
+export async function buildFlexAuthorization(opts) {
+    if (!opts.escrow)
+        throw new Error("flex: escrow required");
+    if (!opts.mint)
+        throw new Error("flex: mint required");
+    if (!/^\d+$/.test(opts.maxAmount)) {
+        throw new Error("flex: maxAmount must be base10 string");
+    }
+    if (!/^\d+$/.test(opts.expiresAtSlot)) {
+        throw new Error("flex: expiresAtSlot must be base10 string");
+    }
+    validateSplits(opts.splits);
+    return {
+        escrow: opts.escrow,
+        mint: opts.mint,
+        maxAmount: opts.maxAmount,
+        authorizationId: randomAuthorizationId(),
+        expiresAtSlot: opts.expiresAtSlot,
+        splits: opts.splits,
+    };
+}
+/**
+ * Settle a `PaymentRequiredError` whose `accepts[]` advertises a Flex
+ * scheme. Picks the first Flex-shaped requirement (one whose
+ * `extra.escrow` and `extra.splits` are populated — matches
+ * `FlexPaymentRequirementsExtra` from `@faremeter/flex-solana/types`),
+ * has the wallet sign, packs as `FlexPaymentPayload` inside an
+ * `X402PaymentPayload`, base64-encodes, and replays via
+ * `retry(paymentHeader)`.
+ */
+export async function payAndRetryFlex(error, wallet, retry) {
+    const accepts = error.accepts ?? [];
+    // Pick the first requirement whose `extra` carries Flex-shape fields.
+    // Backend will set scheme="@faremeter/flex" but we don't gate on the
+    // scheme string — `extra` shape is the source of truth.
+    const requirement = accepts.find((r) => {
+        const extra = r.extra;
+        return !!extra?.escrow && Array.isArray(extra?.splits);
+    });
+    if (!requirement)
+        throw error;
+    const extra = requirement.extra;
+    // We need an expiresAtSlot. Prefer extra.expiresAtSlot; else derive
+    // from minGracePeriodSlots + a sentinel (caller can refine).
+    const expiresAtSlot = extra.expiresAtSlot ?? extra.minGracePeriodSlots ?? "0";
+    const auth = await buildFlexAuthorization({
+        escrow: extra.escrow,
+        mint: USDC_MINT_MAINNET,
+        maxAmount: requirement.maxAmountRequired,
+        splits: extra.splits,
+        expiresAtSlot,
+    });
+    const signature = await wallet.signFlexAuthorization(auth);
+    // Wire shape: `FlexPaymentPayload` from @faremeter/flex-solana/types.
+    // sessionKey + signature added here (signing-time fields).
+    const flexPayload = {
+        escrow: auth.escrow,
+        mint: auth.mint,
+        maxAmount: auth.maxAmount,
+        authorizationId: auth.authorizationId,
+        expiresAtSlot: auth.expiresAtSlot,
+        splits: auth.splits,
+        sessionKey: wallet.sessionKeyAddress,
+        signature,
+    };
+    // x402 envelope (`X402PaymentPayload` from `./x402.ts` = standard
+    // x402 wire format: {x402Version, scheme, network, payload}).
+    const envelope = {
+        x402Version: 1,
+        scheme: requirement.scheme,
+        network: requirement.network,
+        payload: flexPayload,
+    };
+    // X-PAYMENT header value: base64-encoded JSON of the envelope.
+    // Matches what the backend's Flex facilitator decodes.
+    const headerValue = base64UrlSafeEncodeJson(envelope);
+    return retry(headerValue);
+}
+function base64UrlSafeEncodeJson(obj) {
+    const json = JSON.stringify(obj);
+    // Cross-runtime base64: prefer Buffer (Node), else btoa (browser/edge).
+    // Standard x402 uses regular base64 (not url-safe), so we match that.
+    // deno-lint-ignore no-explicit-any
+    const g = globalThis;
+    if (g.Buffer?.from)
+        return g.Buffer.from(json, "utf8").toString("base64");
+    if (typeof g.btoa === "function") {
+        // btoa needs a binary string
+        const bytes = new TextEncoder().encode(json);
+        let bin = "";
+        for (const b of bytes)
+            bin += String.fromCharCode(b);
+        return g.btoa(bin);
+    }
+    throw new Error("flex: no base64 encoder available in this runtime");
+}
+/**
+ * Pure tx-builder for create-escrow + deposit (no signer required, no
+ * network call). Returns instructions a caller can sign + send with any
+ * `@solana/kit`-compatible runtime. Lazy-imports @faremeter/flex-solana
+ * so tree-shake is preserved.
+ *
+ * Cited symbols: `getCreateEscrowInstructionAsync`, `getDepositInstructionAsync`
+ * (both from `@faremeter/flex-solana` root export, per
+ * `/tmp/flex-probe/.../flex-solana/dist/src/index.d.ts:9`).
+ */
+export async function buildEscrowCreationTx(params) {
+    if (!params.walletAddress)
+        throw new Error("flex: walletAddress required");
+    if (!params.facilitatorAddress) {
+        throw new Error("flex: facilitatorAddress required");
+    }
+    if (!/^\d+$/.test(params.amountUsdc)) {
+        throw new Error("flex: amountUsdc must be base10 atomic-unit string");
+    }
+    const mint = params.mint ?? USDC_MINT_MAINNET;
+    const refundTimeoutSlots = BigInt(params.refundTimeoutSlots ?? 150);
+    const deadmanTimeoutSlots = BigInt(params.deadmanTimeoutSlots ?? 432000);
+    const index = BigInt(Date.now()); // monotonic-ish nonce for PDA derivation
+    // Lazy import — tree-shake invariant.
+    const flex = await import("@faremeter/flex-solana");
+    if (!params.signer) {
+        // Pure-build mode: we can't produce a `TransactionSigner` from a string
+        // address. Caller must build the tx with their own kit-compatible signer.
+        // Return the intended shape so the caller can mirror this with their
+        // own `getCreateEscrowInstructionAsync` call.
+        return {
+            instructions: [],
+            accountsAtRisk: [
+                params.walletAddress,
+                params.facilitatorAddress,
+                mint,
+            ],
+            intent: "create_escrow_and_deposit",
+        };
+    }
+    const createIx = await flex.getCreateEscrowInstructionAsync({
+        owner: params.signer,
+        index,
+        facilitator: params.facilitatorAddress,
+        refundTimeoutSlots,
+        deadmanTimeoutSlots,
+        maxSessionKeys: 5,
+    });
+    const depositIx = await flex.getDepositInstructionAsync({
+        depositor: params.signer,
+        escrow: (createIx.accounts[1].address),
+        mint: mint,
+        source: params.walletAddress, // caller should pass the wallet ATA
+        amount: BigInt(params.amountUsdc),
+    });
+    return {
+        instructions: [createIx, depositIx],
+        accountsAtRisk: [
+            params.walletAddress,
+            params.facilitatorAddress,
+            mint,
+            String(createIx.accounts[1].address ?? ""),
+        ],
+        intent: "create_escrow_and_deposit",
+    };
+}
+/**
+ * Pure tx-builder for register-session-key (no signer required).
+ *
+ * Cited symbol: `getRegisterSessionKeyInstructionAsync` from
+ * `@faremeter/flex-solana` root export.
+ */
+export async function buildSessionKeyRegistrationTx(params) {
+    if (!params.walletAddress)
+        throw new Error("flex: walletAddress required");
+    if (!params.escrowAddress)
+        throw new Error("flex: escrowAddress required");
+    if (!params.sessionKeyAddress) {
+        throw new Error("flex: sessionKeyAddress required");
+    }
+    const flex = await import("@faremeter/flex-solana");
+    if (!params.signer) {
+        return {
+            instructions: [],
+            accountsAtRisk: [
+                params.walletAddress,
+                params.escrowAddress,
+                params.sessionKeyAddress,
+            ],
+            intent: "register_session_key",
+        };
+    }
+    const ix = await flex.getRegisterSessionKeyInstructionAsync({
+        owner: params.signer,
+        escrow: params.escrowAddress,
+        sessionKey: params.sessionKeyAddress,
+        expiresAtSlot: params.expiresAtSlot ? BigInt(params.expiresAtSlot) : null,
+        revocationGracePeriodSlots: BigInt(params.revocationGracePeriodSlots ?? 0),
+    });
+    return {
+        instructions: [ix],
+        accountsAtRisk: [
+            params.walletAddress,
+            params.escrowAddress,
+            params.sessionKeyAddress,
+        ],
+        intent: "register_session_key",
+    };
+}
+/**
+ * Send a create-escrow + deposit transaction. Requires `params.signer`
+ * and `params.rpc` — both `@solana/kit` types we don't import at
+ * top-level (tree-shake). Without them, throws `requires_signer` and
+ * points at `buildEscrowCreationTx` for the pure-build path.
+ */
+export async function fundEscrow(params) {
+    if (!params.signer || !params.rpc) {
+        throw new Error("flex.fundEscrow: requires_signer — caller must supply " +
+            "`signer` (TransactionSigner) and `rpc` (kit RPC client). For " +
+            "pure tx construction without sending, use `buildEscrowCreationTx`.");
+    }
+    const built = await buildEscrowCreationTx(params);
+    // Sender is a thin wrapper. Real impl: assemble tx message via
+    // @solana/kit, sign + send via the caller's rpc. v6.16 prelim:
+    // surface the structured failure so callers know where to plug in.
+    throw new Error("flex.fundEscrow: tx-send wiring is caller-supplied in v6.16-preview.0. " +
+        `Built ${built.instructions.length} instructions; send via your ` +
+        "@solana/kit pipeline. See `buildEscrowCreationTx` for the pure shape.");
+}
+/**
+ * Send a register-session-key transaction. Thin sender wrapper around
+ * `buildSessionKeyRegistrationTx`. Same `requires_signer` contract as
+ * `fundEscrow`.
+ */
+export async function registerSessionKey(params) {
+    if (!params.signer || !params.rpc) {
+        throw new Error("flex.registerSessionKey: requires_signer — caller must supply " +
+            "`signer` (TransactionSigner) and `rpc` (kit RPC client). For " +
+            "pure tx construction without sending, use `buildSessionKeyRegistrationTx`.");
+    }
+    const built = await buildSessionKeyRegistrationTx(params);
+    throw new Error("flex.registerSessionKey: tx-send wiring is caller-supplied in v6.16-preview.0. " +
+        `Built ${built.instructions.length} instructions; send via your ` +
+        "@solana/kit pipeline. See `buildSessionKeyRegistrationTx` for the pure shape.");
+}
+//# sourceMappingURL=flex.js.map

package/dist/flex.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { Unbrowse } from "./client.js";
+export { PaymentRequiredError, RuntimeUnavailableError, SponsorExhaustedError, UnbrowseApiError, } from "./errors.js";
+export { locateUnbrowseBinary, probeUnbrowseRuntime, spawnUnbrowseRuntime, } from "./runtime.js";
+export type { RuntimeHandle, SpawnRuntimeOptions } from "./runtime.js";
+export { payAndRetry } from "./x402.js";
+export type { WalletLike, X402PaymentPayload, X402PaymentRequirement, } from "./x402.js";
+export { buildEscrowCreationTx, buildFlexAuthorization, buildSessionKeyRegistrationTx, fundEscrow, payAndRetryFlex, registerSessionKey, USDC_MINT_DEVNET, USDC_MINT_MAINNET, } from "./flex.js";
+export type { BuiltFlexTx, FlexAuthorization, FlexFundEscrowParams, FlexRegisterSessionKeyParams, FlexWalletLike, TransactionSignerOpaque, } from "./flex.js";
+export type { AttributionLedger, AvailableEndpoint, CreatorTransaction, CreatorTransactionsResponse, Dashboard, DashboardContributions, DashboardEarnings, DashboardSpending, EndpointDescriptor, ExecuteInput, ExecuteResponse, ExecutionTrace, FeedbackInput, FeedbackResponse, HealthResponse, LoginInput, LoginResponse, OrchestrationTiming, ProjectionOptions, RequestOptions, ResolveInput, ResolveResponse, ResponseSchema, SearchDomainInput, SearchHit, SearchInput, SearchResponse, SkillManifest, StatsResponse, StealAuthInput, StealAuthResponse, UnbrowseClientOptions, WalletInfo, } from "./contracts.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,6BAA6B,EAC7B,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,4BAA4B,EAC5B,cAAc,EACd,uBAAuB,GACxB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,2BAA2B,EAC3B,SAAS,EACT,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,WAAW,EACX,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,UAAU,GACX,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { Unbrowse } from "./client.js";
+export { PaymentRequiredError, RuntimeUnavailableError, SponsorExhaustedError, UnbrowseApiError, } from "./errors.js";
+export { locateUnbrowseBinary, probeUnbrowseRuntime, spawnUnbrowseRuntime, } from "./runtime.js";
+export { payAndRetry } from "./x402.js";
+export { buildEscrowCreationTx, buildFlexAuthorization, buildSessionKeyRegistrationTx, fundEscrow, payAndRetryFlex, registerSessionKey, USDC_MINT_DEVNET, USDC_MINT_MAINNET, } from "./flex.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAMxC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,6BAA6B,EAC7B,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,WAAW,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Local-binary lifecycle for `@unbrowse/sdk`.
+ *
+ * The SDK talks to a co-located `unbrowse` runtime over loopback HTTP.
+ * `runtime.ts` owns the contract for locating, probing, and spawning that
+ * runtime so `client.ts` can stay a pure HTTP transport.
+ *
+ * Tree-shaking note: heavy Node-only imports (`child_process`) are pulled
+ * in lazily inside `spawnUnbrowseRuntime`. Callers that only use
+ * `Unbrowse.connect` never pay for them.
+ */
+/**
+ * Handle returned by a successful spawn. `owned` distinguishes processes the
+ * SDK forked (kill on `.close()`) from processes the SDK adopted via probe
+ * (leave running on `.close()`).
+ */
+export interface RuntimeHandle {
+    /** Base URL the running runtime listens on, e.g. "http://127.0.0.1:6969". */
+    baseUrl: string;
+    /** OS process id; -1 if the runtime was adopted via probe. */
+    pid: number;
+    /** Stops the runtime if `owned`; no-op otherwise. */
+    kill(): Promise<void>;
+    /** Resolves once the runtime answers `/health` with 200. */
+    ready: Promise<void>;
+    /** True iff this SDK started the process and is responsible for tearing it down. */
+    owned: boolean;
+}
+/**
+ * Options for `spawnUnbrowseRuntime`. Every field has a sensible default,
+ * so the zero-arg call is the documented happy path.
+ */
+export interface SpawnRuntimeOptions {
+    /** Preferred port; default 6969. If already alive, adopts that runtime. */
+    port?: number;
+    /** Working directory for the child; default = current process cwd. */
+    cwd?: string;
+    /** Extra env vars layered onto the child's inherited env. */
+    env?: Record<string, string>;
+    /** Explicit path to the binary; overrides `locateUnbrowseBinary`. */
+    binaryPath?: string;
+    /** Milliseconds to wait for `/health` readiness; default 10_000. */
+    readyTimeoutMs?: number;
+}
+/**
+ * Probe an already-running runtime by hitting `/health`. Returns true iff
+ * the response status is 2xx. Never throws — connection refused, timeout,
+ * DNS failures, and non-2xx all resolve to `false`.
+ */
+export declare function probeUnbrowseRuntime(baseUrl: string, timeoutMs?: number): Promise<boolean>;
+/**
+ * Locate the `unbrowse` binary by walking, in order:
+ *   1. `UNBROWSE_BIN` env var
+ *   2. `require.resolve('unbrowse/package.json')` -> derived `bin/unbrowse-wrapper.mjs`
+ *   3. `Bun.which('unbrowse')` if running under Bun
+ * Returns null when nothing is wired.
+ */
+export declare function locateUnbrowseBinary(): string | null;
+/**
+ * Spawn (or adopt) a co-located `unbrowse` runtime and wait for it to
+ * answer `/health`. Returns a `RuntimeHandle` whose `.kill()` tears the
+ * child down. Throws `RuntimeUnavailableError` on failure modes.
+ *
+ * Concurrency: if two callers race on the same port, only one spawn is
+ * launched. The second caller awaits the first's promise and gets an
+ * adopted (`owned=false`) view of the same handle so it cannot
+ * double-kill the child.
+ */
+export declare function spawnUnbrowseRuntime(opts?: SpawnRuntimeOptions): Promise<RuntimeHandle>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,4DAA4D;IAC5D,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,oFAAoF;IACpF,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAiC,GAC3C,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAoCpD;AA2BD;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,aAAa,CAAC,CA8BxB"}