@blockrun/llm 3.23.0 → 3.23.1

package/dist/index.cjs

@@ -4833,7 +4833,7 @@ function getCostSummary() {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.23.0";
+var SDK_VERSION = "3.23.1";
 var USER_AGENT = `blockrun-ts/${SDK_VERSION}`;
 
 // src/client.ts
@@ -10861,6 +10861,38 @@ function capOutstandingEscrow(scheme, wallet) {
     return original.call(this, requirements, requestAmount, needed, context, widened, existingDeposit);
   };
 }
+var payScope = new import_async_hooks.AsyncLocalStorage();
+function registerHookDispatchers(client) {
+  client.onBeforePaymentCreation(async (context) => {
+    for (const hook of payScope.getStore()?.hooks.before ?? []) {
+      const result = await hook(context);
+      if (result && typeof result === "object" && result.abort) return result;
+    }
+    return void 0;
+  });
+  client.onAfterPaymentCreation(async (context) => {
+    const scope = payScope.getStore();
+    for (const hook of scope?.hooks.after ?? []) {
+      try {
+        await hook(context);
+      } catch (error) {
+        if (scope && !scope.afterError) scope.afterError = { error };
+      }
+    }
+  });
+  client.onPaymentCreationFailure(async (context) => {
+    await runFailureHooks(payScope.getStore(), context);
+    return void 0;
+  });
+}
+async function runFailureHooks(scope, context) {
+  for (const hook of scope?.hooks.failure ?? []) {
+    try {
+      await hook(context);
+    } catch {
+    }
+  }
+}
 var RPC_SCOPE_STORE = /* @__PURE__ */ Symbol.for("@blockrun/llm/batch-rpc-scope/v1");
 var RPC_HEADER_HOOK = /* @__PURE__ */ Symbol.for("@blockrun/llm/batch-rpc-headers/v1");
 var sharedGlobal = globalThis;
@@ -10912,6 +10944,11 @@ function intentTarget(intent) {
 var SolanaBatchPayer = class {
   constructor(init) {
     this.init = init;
+    init.configureClient?.({
+      onBeforePaymentCreation: (hook) => void this.hooks.before.push(hook),
+      onAfterPaymentCreation: (hook) => void this.hooks.after.push(hook),
+      onPaymentCreationFailure: (hook) => void this.hooks.failure.push(hook)
+    });
     const { operators, rateLimit, inDoubt } = init.options;
     if (!Array.isArray(operators) || operators.length === 0 || operators.some((o) => typeof o !== "string" || !o)) {
       throw new Error("batch.operators must list at least one base58 operator public key");
@@ -10944,6 +10981,7 @@ var SolanaBatchPayer = class {
     unresolved: 0,
     unresolvedByReason: {}
   };
+  hooks = { before: [], after: [], failure: [] };
   /** A copy of this client's batch counters. */
   stats() {
     return {
@@ -11046,7 +11084,7 @@ var SolanaBatchPayer = class {
       capOutstandingEscrow(scheme, wallet);
       const client = new core.x402Client().register("solana:*", scheme).registerPolicy(scheme.paymentPolicy);
       client.setSpendControls({ maxAmountPerPayment: false });
-      this.init.configureClient?.(client);
+      registerHookDispatchers(client);
       const raw = new core.x402HTTPClient(client);
       const http = {
         getPaymentSettleResponse: (getHeader) => raw.getPaymentSettleResponse(getHeader),
@@ -11340,7 +11378,10 @@ var SolanaBatchPayer = class {
     }
     wallet.active += 1;
     try {
-      return await this.payWith(wallet, paymentRequired, send, rechallenge, closesAtStart ?? wallet.closes);
+      return await payScope.run(
+        { hooks: this.hooks },
+        () => this.payWith(wallet, paymentRequired, send, rechallenge, closesAtStart ?? wallet.closes)
+      );
     } finally {
       wallet.active -= 1;
     }
@@ -11752,6 +11793,18 @@ var SolanaBatchPayer = class {
   /** Build a new batch payment for a 402: the payload, its headers and its kind. */
   async buildPayment(wallet, paymentRequired) {
     const { http, payload } = await this.createPayload(wallet, paymentRequired);
+    const scope = payScope.getStore();
+    if (scope?.afterError) {
+      const { error } = scope.afterError;
+      scope.afterError = void 0;
+      await this.settle(http, payload, () => null, 0);
+      await runFailureHooks(scope, {
+        paymentRequired,
+        selectedRequirements: payload.accepted,
+        error
+      });
+      throw error;
+    }
     const headers = http.encodePaymentSignatureHeader(payload);
     const channelId = payloadChannelId(payload);
     const known = channelId ? wallet.book.find(channelId) : void 0;

package/dist/index.d.cts

@@ -3194,14 +3194,20 @@ interface SolanaBatchPayerInit {
     /** Headers the exact path sends to `rpcUrl` (`rpcHeaders`, `SOLANA_RPC_HEADERS`, `SOLANA_RPC_API_KEY`). */
     rpcHeaders?: Record<string, string>;
     /**
-     * Called once with the batch scheme's `x402Client`, after the scheme and its
-     * policy are registered and before anything is signed. An embedder that
-     * enforces its own spend rules registers its payment-creation hooks here, so
-     * they see every batch payment this payer signs (each one's
-     * `selectedRequirements.amount` is the per-call ceiling, not the channel
-     * deposit) exactly as they see the embedder's own `exact` payments. A
-     * before-hook that throws refuses the payment: nothing is signed or sent,
-     * and `pay()` reports a fallback.
+     * Called once, when the payer is constructed, with a registrar for x402
+     * payment-creation hooks. An embedder that enforces its own spend rules
+     * registers its hooks here, so they see every batch payment THIS payer signs
+     * (each one's `selectedRequirements.amount` is the per-call ceiling, not the
+     * channel deposit) exactly as they see the embedder's own `exact` payments.
+     *
+     * The hooks are this payer's own: payers that share a wallet (and so its
+     * channel and scheme client) never run each other's hooks. A before-hook
+     * that throws refuses the payment: nothing is signed or sent, and `pay()`
+     * reports a fallback. An after-hook that throws does the same: the payment
+     * was signed but is rolled back unsent, so the channel is not left pending,
+     * and the failure hooks are told. Failure hooks are notifications only: a
+     * payload one returns as `recovered` is ignored, since a batch payment is
+     * never replaced by a payment built outside the batch scheme.
      */
     configureClient?: (client: X402ClientLike) => void;
 }
@@ -3242,6 +3248,7 @@ declare class SolanaBatchPayer {
     private readonly maxWaitMs;
     private readonly inDoubtMaxWaitMs;
     private readonly counters;
+    private readonly hooks;
     constructor(init: SolanaBatchPayerInit);
     /** A copy of this client's batch counters. */
     stats(): SolanaBatchStats;

package/dist/index.d.ts

@@ -3194,14 +3194,20 @@ interface SolanaBatchPayerInit {
     /** Headers the exact path sends to `rpcUrl` (`rpcHeaders`, `SOLANA_RPC_HEADERS`, `SOLANA_RPC_API_KEY`). */
     rpcHeaders?: Record<string, string>;
     /**
-     * Called once with the batch scheme's `x402Client`, after the scheme and its
-     * policy are registered and before anything is signed. An embedder that
-     * enforces its own spend rules registers its payment-creation hooks here, so
-     * they see every batch payment this payer signs (each one's
-     * `selectedRequirements.amount` is the per-call ceiling, not the channel
-     * deposit) exactly as they see the embedder's own `exact` payments. A
-     * before-hook that throws refuses the payment: nothing is signed or sent,
-     * and `pay()` reports a fallback.
+     * Called once, when the payer is constructed, with a registrar for x402
+     * payment-creation hooks. An embedder that enforces its own spend rules
+     * registers its hooks here, so they see every batch payment THIS payer signs
+     * (each one's `selectedRequirements.amount` is the per-call ceiling, not the
+     * channel deposit) exactly as they see the embedder's own `exact` payments.
+     *
+     * The hooks are this payer's own: payers that share a wallet (and so its
+     * channel and scheme client) never run each other's hooks. A before-hook
+     * that throws refuses the payment: nothing is signed or sent, and `pay()`
+     * reports a fallback. An after-hook that throws does the same: the payment
+     * was signed but is rolled back unsent, so the channel is not left pending,
+     * and the failure hooks are told. Failure hooks are notifications only: a
+     * payload one returns as `recovered` is ignored, since a batch payment is
+     * never replaced by a payment built outside the batch scheme.
      */
     configureClient?: (client: X402ClientLike) => void;
 }
@@ -3242,6 +3248,7 @@ declare class SolanaBatchPayer {
     private readonly maxWaitMs;
     private readonly inDoubtMaxWaitMs;
     private readonly counters;
+    private readonly hooks;
     constructor(init: SolanaBatchPayerInit);
     /** A copy of this client's batch counters. */
     stats(): SolanaBatchStats;

package/dist/index.js

@@ -4702,7 +4702,7 @@ function getCostSummary() {
 }
 
 // src/version.ts
-var SDK_VERSION = "3.23.0";
+var SDK_VERSION = "3.23.1";
 var USER_AGENT = `blockrun-ts/${SDK_VERSION}`;
 
 // src/client.ts
@@ -10730,6 +10730,38 @@ function capOutstandingEscrow(scheme, wallet) {
     return original.call(this, requirements, requestAmount, needed, context, widened, existingDeposit);
   };
 }
+var payScope = new AsyncLocalStorage();
+function registerHookDispatchers(client) {
+  client.onBeforePaymentCreation(async (context) => {
+    for (const hook of payScope.getStore()?.hooks.before ?? []) {
+      const result = await hook(context);
+      if (result && typeof result === "object" && result.abort) return result;
+    }
+    return void 0;
+  });
+  client.onAfterPaymentCreation(async (context) => {
+    const scope = payScope.getStore();
+    for (const hook of scope?.hooks.after ?? []) {
+      try {
+        await hook(context);
+      } catch (error) {
+        if (scope && !scope.afterError) scope.afterError = { error };
+      }
+    }
+  });
+  client.onPaymentCreationFailure(async (context) => {
+    await runFailureHooks(payScope.getStore(), context);
+    return void 0;
+  });
+}
+async function runFailureHooks(scope, context) {
+  for (const hook of scope?.hooks.failure ?? []) {
+    try {
+      await hook(context);
+    } catch {
+    }
+  }
+}
 var RPC_SCOPE_STORE = /* @__PURE__ */ Symbol.for("@blockrun/llm/batch-rpc-scope/v1");
 var RPC_HEADER_HOOK = /* @__PURE__ */ Symbol.for("@blockrun/llm/batch-rpc-headers/v1");
 var sharedGlobal = globalThis;
@@ -10781,6 +10813,11 @@ function intentTarget(intent) {
 var SolanaBatchPayer = class {
   constructor(init) {
     this.init = init;
+    init.configureClient?.({
+      onBeforePaymentCreation: (hook) => void this.hooks.before.push(hook),
+      onAfterPaymentCreation: (hook) => void this.hooks.after.push(hook),
+      onPaymentCreationFailure: (hook) => void this.hooks.failure.push(hook)
+    });
     const { operators, rateLimit, inDoubt } = init.options;
     if (!Array.isArray(operators) || operators.length === 0 || operators.some((o) => typeof o !== "string" || !o)) {
       throw new Error("batch.operators must list at least one base58 operator public key");
@@ -10813,6 +10850,7 @@ var SolanaBatchPayer = class {
     unresolved: 0,
     unresolvedByReason: {}
   };
+  hooks = { before: [], after: [], failure: [] };
   /** A copy of this client's batch counters. */
   stats() {
     return {
@@ -10915,7 +10953,7 @@ var SolanaBatchPayer = class {
       capOutstandingEscrow(scheme, wallet);
       const client = new core.x402Client().register("solana:*", scheme).registerPolicy(scheme.paymentPolicy);
       client.setSpendControls({ maxAmountPerPayment: false });
-      this.init.configureClient?.(client);
+      registerHookDispatchers(client);
       const raw = new core.x402HTTPClient(client);
       const http = {
         getPaymentSettleResponse: (getHeader) => raw.getPaymentSettleResponse(getHeader),
@@ -11209,7 +11247,10 @@ var SolanaBatchPayer = class {
     }
     wallet.active += 1;
     try {
-      return await this.payWith(wallet, paymentRequired, send, rechallenge, closesAtStart ?? wallet.closes);
+      return await payScope.run(
+        { hooks: this.hooks },
+        () => this.payWith(wallet, paymentRequired, send, rechallenge, closesAtStart ?? wallet.closes)
+      );
     } finally {
       wallet.active -= 1;
     }
@@ -11621,6 +11662,18 @@ var SolanaBatchPayer = class {
   /** Build a new batch payment for a 402: the payload, its headers and its kind. */
   async buildPayment(wallet, paymentRequired) {
     const { http, payload } = await this.createPayload(wallet, paymentRequired);
+    const scope = payScope.getStore();
+    if (scope?.afterError) {
+      const { error } = scope.afterError;
+      scope.afterError = void 0;
+      await this.settle(http, payload, () => null, 0);
+      await runFailureHooks(scope, {
+        paymentRequired,
+        selectedRequirements: payload.accepted,
+        error
+      });
+      throw error;
+    }
     const headers = http.encodePaymentSignatureHeader(payload);
     const channelId = payloadChannelId(payload);
     const known = channelId ? wallet.book.find(channelId) : void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/llm",
-  "version": "3.23.0",
+  "version": "3.23.1",
   "type": "module",
   "description": "TypeScript SDK for BlockRun - every frontier model behind one OpenAI-compatible client. Pay with a BlockRun API key or per-call in USDC. Smart routing picks the cheapest capable model. No rate limits.",
   "main": "dist/index.cjs",