@forgezero/providers 0.1.24 → 0.1.26

package/README.md

@@ -5,7 +5,7 @@
   and commit the generator and rendered files together.
 -->
 
-# @forgezero/providers
+# Service providers
 
 Send through whichever provider is up. Priority and failover, reordered live.
 

package/dist/billing.js

@@ -336,7 +336,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.24";
+var VERSION = "0.1.26";
 
 // src/billing.ts
 var PAYMENT_PROVIDER_KEYS = ["stripe:v1", "paypal:v1", "razorpay:v1"];

package/dist/database.js

@@ -336,7 +336,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.24";
+var VERSION = "0.1.26";
 
 // src/database.ts
 var pools = new Map;

package/dist/email.js

@@ -336,7 +336,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.24";
+var VERSION = "0.1.26";
 
 // src/email.ts
 var recipients = (to) => Array.isArray(to) ? [...to] : [to];

package/dist/git.js

@@ -336,7 +336,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.24";
+var VERSION = "0.1.26";
 
 // src/git.ts
 var githubAppConfigSchema = {

package/dist/http.d.ts

@@ -2,12 +2,10 @@ import { ProviderError } from './index';
 /**
  * Outbound HTTP with a budget that is actually respected.
  *
- * Exchanges do not rate-limit requests; they rate-limit COST. Binance publishes
- * 6000 weight per minute per IP, and a single depth or klines call can cost 50
- * where a status call costs 1. A per-request limiter set to "6000 a minute" is
- * therefore wrong by more than an order of magnitude on exactly the endpoints
- * a trading system leans on, and the failure mode is a 418 and a temporary ban
- * rather than a slowdown.
+ * Some providers rate-limit cost rather than request count. A call may consume
+ * many units while a status probe consumes one, so a per-request limiter can be
+ * wrong by an order of magnitude. This generic ledger accepts the provider's
+ * reported cost without embedding a vendor-specific protocol in the package.
  *
  * ## The budget is per HOST, and shared
  *
@@ -24,7 +22,7 @@ import { ProviderError } from './index';
  */
 export interface HostBudget {
     host: string;
-    /** Units per window. `weight` for Binance, `requests` for a simpler venue. */
+    /** Provider-defined units per window, or requests for a simpler API. */
     limit: number;
     windowMs: number;
     /** Assumed cost before the real one is known. */
@@ -58,9 +56,8 @@ export interface HttpConfig {
     baseUrl: string;
     budget: HostBudget;
     /**
-     * Reads the true cost out of a response. Binance reports it in
-     * `x-mbx-used-weight-1m` as a running total, so the adapter that knows the
-     * venue owns this rather than the client guessing.
+         * Reads the true cost out of a response. The provider adapter owns the
+         * response-header contract rather than this generic client guessing.
      */
     costOf?: (response: Response) => number | undefined;
     fetch?: typeof globalThis.fetch;
@@ -94,7 +91,7 @@ export type HttpClient = ReturnType<typeof createHttpClient>;
  * that decides whether a retry helps or makes things worse.
  */
 export declare const http: import("./index").ProviderDefinition<Record<"request", import("./index").ProviderMethodSpec<HttpRequest, HttpResponse<unknown>>>>;
-/** Binance reports a running total for the window, not a per-call cost. */
-export declare const binanceWeight: (response: Response) => number | undefined;
+/** Build a provider-specific response-cost reader without coupling this module to a vendor. */
+export declare const responseHeaderCost: (headerName: string) => (response: Response) => number | undefined;
 export declare const httpProviders: readonly [import("./index").ProviderDefinition<Record<"request", import("./index").ProviderMethodSpec<HttpRequest, HttpResponse<unknown>>>>];
 export {};

package/dist/http.js

@@ -336,7 +336,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.24";
+var VERSION = "0.1.26";
 
 // src/http.ts
 class BudgetExhausted extends ProviderError {
@@ -465,8 +465,6 @@ var http = defineSingleMethodProvider({
   },
   classify(error) {
     const status = error.status;
-    if (status === 418)
-      return "backoff";
     if (status === 429)
       return "backoff";
     if (status === 400 || status === 422)
@@ -476,19 +474,22 @@ var http = defineSingleMethodProvider({
     return "retryable";
   }
 });
-var binanceWeight = (response) => {
-  const header = response.headers.get("x-mbx-used-weight-1m");
-  return header === null ? undefined : Number(header);
+var responseHeaderCost = (headerName) => (response) => {
+  const header = response.headers.get(headerName);
+  if (header === null)
+    return;
+  const value = Number(header);
+  return Number.isFinite(value) && value >= 0 ? value : undefined;
 };
 var httpProviders = [http];
 export {
   spend,
   settle,
+  responseHeaderCost,
   resetBudgets,
   httpProviders,
   http,
   createHttpClient,
   budgetState,
-  binanceWeight,
   BudgetExhausted
 };

package/dist/index.d.ts

@@ -303,5 +303,5 @@ export interface EmailBatchResult {
     };
     results: readonly EmailBatchItemResult[];
 }
-export declare const VERSION = "0.1.24";
+export declare const VERSION = "0.1.26";
 export {};

package/dist/index.js

@@ -336,7 +336,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.24";
+var VERSION = "0.1.26";
 export {
   staticConfig,
   serviceMethod,

package/dist/pool.js

@@ -336,7 +336,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.24";
+var VERSION = "0.1.26";
 
 // src/http.ts
 class BudgetExhausted extends ProviderError {
@@ -465,8 +465,6 @@ var http = defineSingleMethodProvider({
   },
   classify(error) {
     const status = error.status;
-    if (status === 418)
-      return "backoff";
     if (status === 429)
       return "backoff";
     if (status === 400 || status === 422)
@@ -476,9 +474,12 @@ var http = defineSingleMethodProvider({
     return "retryable";
   }
 });
-var binanceWeight = (response) => {
-  const header = response.headers.get("x-mbx-used-weight-1m");
-  return header === null ? undefined : Number(header);
+var responseHeaderCost = (headerName) => (response) => {
+  const header = response.headers.get(headerName);
+  if (header === null)
+    return;
+  const value = Number(header);
+  return Number.isFinite(value) && value >= 0 ? value : undefined;
 };
 var httpProviders = [http];
 

package/dist/storage.js

@@ -336,7 +336,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.24";
+var VERSION = "0.1.26";
 
 // src/storage.ts
 var encoder = new TextEncoder;

package/dist/translation.js

@@ -336,7 +336,7 @@ function createService(definition, methods, options = {}) {
     }
   };
 }
-var VERSION = "0.1.24";
+var VERSION = "0.1.26";
 
 // src/translation.ts
 var GOOGLE_ENDPOINT = "https://generativelanguage.googleapis.com/v1beta/models";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgezero/providers",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "type": "module",
   "publishConfig": {
     "access": "public",
@@ -85,6 +85,6 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgezero/runtime": "^0.1.15"
+    "@forgezero/runtime": "^0.1.17"
   }
 }