@farthershore/backend 0.11.0 → 0.13.0

package/dist/types/testing/usageSink.d.ts

@@ -0,0 +1,31 @@
+import type { RuntimeMeteringEvent } from "../runtime-types.js";
+/** One recorded usage observation. `source` distinguishes the two channels. */
+export type DevUsageEvent = {
+    source: "response";
+    /** rawDimsUnits from the signed response-metering payload. */
+    meters: Record<string, number>;
+    /** The full response-metering payload (method/path/rawDimsUnits/…). */
+    payload: Record<string, unknown>;
+    /** The gateway request id this usage was reported against, when known. */
+    requestId?: string;
+    at: number;
+} | {
+    source: "meter";
+    /** `{ [meter]: qty }` for a single background metering event. */
+    meters: Record<string, number>;
+    event: RuntimeMeteringEvent;
+    requestId?: string;
+    at: number;
+};
+/** In-memory, assertable sink for all dev usage. */
+export declare class DevUsageSink {
+    readonly events: DevUsageEvent[];
+    /** Record a signed response-metering payload (withUsage / computeMeteringHeaders). */
+    recordResponse(payload: Record<string, unknown>, requestId?: string): void;
+    /** Record a background `fs.meter()` event captured by the dev gateway. */
+    recordMeterEvent(event: RuntimeMeteringEvent): void;
+    /** Total quantity per meter key across every recorded event. */
+    byMeter(): Record<string, number>;
+    /** Clear all recorded usage. */
+    reset(): void;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farthershore/backend",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Farther Shore backend SDK for builder upstreams: signed response usage, fail-closed gateway request verification, health, and lifecycle from FS_RUNTIME_TOKEN",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,6 +22,10 @@
     "./runtime": {
       "types": "./dist/types/generated/runtime-contract.d.ts",
       "import": "./dist/generated/runtime-contract.js"
+    },
+    "./testing": {
+      "types": "./dist/types/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
     }
   },
   "files": [
@@ -33,9 +37,9 @@
   },
   "optionalDependencies": {
     "@farthershore/cloudflared-linux-x64": "0.0.0",
+    "@farthershore/cloudflared-darwin-arm64": "0.0.0",
     "@farthershore/cloudflared-linux-arm64": "0.0.0",
-    "@farthershore/cloudflared-darwin-x64": "0.0.0",
-    "@farthershore/cloudflared-darwin-arm64": "0.0.0"
+    "@farthershore/cloudflared-darwin-x64": "0.0.0"
   },
   "peerDependencies": {
     "express": "^4.0.0 || ^5.0.0"
@@ -53,7 +57,7 @@
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.59.0",
     "vitest": "^4.1.6",
-    "@farthershore/contracts": "0.61.1"
+    "@farthershore/contracts": "0.62.0"
   },
   "engines": {
     "node": ">=22"