@t-0/provider-sdk 1.1.26 → 1.1.27

package/README.md

@@ -14,7 +14,10 @@ See [starter README](../starter/README.md) for details on the generated project.
 
 ## Installation
 
+The SDK depends on `@buf/grpc_grpc.bufbuild_es`, which is published on the Buf Schema Registry, not npmjs. Point the `@buf` scope at BSR before installing (the starter template already ships this `.npmrc`):
+
 ```bash
+echo '@buf:registry=https://buf.build/gen/npm/v1/' >> .npmrc
 npm install @t-0/provider-sdk
 ```
 

package/lib/cjs/common/gen/tzero/v1/payment/network_pb.d.ts

@@ -192,7 +192,8 @@ export type GetQuoteResponse = Message<"tzero.v1.payment.GetQuoteResponse"> & {
     /**
      * *
      * All best quotes from providers with credit lines.
-     * Each quote is the best rate for that provider for the requested amount.
+     * Each quote is that provider's best effective price for the requested amount:
+     * the lowest settlement amount, and on a tie the largest pay-out amount.
      * Each quote indicates whether it can be executed immediately.
      * Always returned alongside success/failure - providers can compare alternatives or see options when no executable quote exists.
      *

package/lib/cjs/service/health.d.ts

@@ -0,0 +1,21 @@
+import { type ServiceImpl } from "@connectrpc/connect";
+import { Health } from "@buf/grpc_grpc.bufbuild_es/grpc/health/v1/health_pb.js";
+/**
+ * Headers carrying the identity of the SDK answering the probe. They ride on
+ * the health response and nowhere else: `HealthCheckResponse` has a single
+ * status field and `check` names its service in the request, so the contract
+ * itself has no room for this — and taxing every callback with headers only the
+ * probe reads would be worse.
+ */
+export declare const SDK_ECOSYSTEM_HEADER = "T0-Sdk-Ecosystem";
+export declare const SDK_VERSION_HEADER = "T0-Sdk-Version";
+/**
+ * Reports SERVING for the services registered on this server and NOT_FOUND for
+ * anything else. The set is frozen at registration; nothing is computed per
+ * request.
+ *
+ * `watch` is absent on purpose: it is server-streaming, and the body-hash
+ * signature scheme these servers run behind has no story for streams. Omitting
+ * it from a partial `ServiceImpl` makes connect-es answer UNIMPLEMENTED.
+ */
+export declare const createHealthServiceImpl: (services: string[]) => Partial<ServiceImpl<typeof Health>>;

package/lib/cjs/service/health.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHealthServiceImpl = exports.SDK_VERSION_HEADER = exports.SDK_ECOSYSTEM_HEADER = void 0;
+const protobuf_1 = require("@bufbuild/protobuf");
+const connect_1 = require("@connectrpc/connect");
+const health_pb_js_1 = require("@buf/grpc_grpc.bufbuild_es/grpc/health/v1/health_pb.js");
+const version_js_1 = require("../version.js");
+/**
+ * Headers carrying the identity of the SDK answering the probe. They ride on
+ * the health response and nowhere else: `HealthCheckResponse` has a single
+ * status field and `check` names its service in the request, so the contract
+ * itself has no room for this — and taxing every callback with headers only the
+ * probe reads would be worse.
+ */
+exports.SDK_ECOSYSTEM_HEADER = "T0-Sdk-Ecosystem";
+exports.SDK_VERSION_HEADER = "T0-Sdk-Version";
+const SDK_ECOSYSTEM = "node";
+/**
+ * Reports SERVING for the services registered on this server and NOT_FOUND for
+ * anything else. The set is frozen at registration; nothing is computed per
+ * request.
+ *
+ * `watch` is absent on purpose: it is server-streaming, and the body-hash
+ * signature scheme these servers run behind has no story for streams. Omitting
+ * it from a partial `ServiceImpl` makes connect-es answer UNIMPLEMENTED.
+ */
+const createHealthServiceImpl = (services) => {
+    const registered = new Set(services);
+    const serving = (0, protobuf_1.create)(health_pb_js_1.HealthCheckResponseSchema, {
+        status: health_pb_js_1.HealthCheckResponse_ServingStatus.SERVING,
+    });
+    return {
+        check(req, ctx) {
+            ctx.responseHeader.set(exports.SDK_ECOSYSTEM_HEADER, SDK_ECOSYSTEM);
+            ctx.responseHeader.set(exports.SDK_VERSION_HEADER, version_js_1.SDK_VERSION);
+            // The schema comes from a published .d.ts, whose type brands do not
+            // survive ServiceImpl's generics — connect-es widens the request to
+            // Message<string>. The descriptor is still the real one at runtime, so
+            // this narrows back to what the wire actually carries.
+            const { service } = req;
+            // An empty service name asks about the process as a whole, which is up if
+            // this handler is running at all.
+            if (service !== "" && !registered.has(service)) {
+                throw new connect_1.ConnectError(`unknown service '${service}'`, connect_1.Code.NotFound);
+            }
+            return serving;
+        },
+    };
+};
+exports.createHealthServiceImpl = createHealthServiceImpl;

package/lib/cjs/service/service.js

@@ -8,8 +8,8 @@ const connect_1 = require("@connectrpc/connect");
 const headers_js_1 = __importDefault(require("../common/headers.js"));
 const secp256k1_js_1 = require("@noble/curves/secp256k1.js");
 const validate_response_js_1 = require("./validate_response.js");
-const system_pb_js_1 = require("../common/gen/tzero/v1/system/system_pb.js");
-const system_js_1 = require("./system.js");
+const health_pb_js_1 = require("@buf/grpc_grpc.bufbuild_es/grpc/health/v1/health_pb.js");
+const health_js_1 = require("./health.js");
 exports.REQUEST_VALIDITY_MILLIS = 60000;
 const createSignatureVerification = (networkPublicKey) => (next) => async (req) => {
     const ts = decodeNum(getHeader(req, headers_js_1.default.SignatureTimestamp));
@@ -57,8 +57,11 @@ const createService = (networkPublicKey, registerRoutes) => {
                 },
             };
             registerRoutes(wrappedRouter);
-            collected.push(system_pb_js_1.SystemService.typeName);
-            origService(system_pb_js_1.SystemService, (0, system_js_1.createSystemServiceImpl)(collected));
+            // Health is the only service this transport mounts on its own — see
+            // docs/HEALTH_SERVICE.md. Same interceptors as everything else, so the
+            // probe is signed like any other call.
+            collected.push(health_pb_js_1.Health.typeName);
+            origService(health_pb_js_1.Health, (0, health_js_1.createHealthServiceImpl)(collected));
         },
         interceptors: [createSignatureVerification(networkPublicKey), (0, validate_response_js_1.createValidationInterceptor)()],
         grpcWeb: false,

package/lib/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.1.26";
+export declare const SDK_VERSION = "1.1.27";

package/lib/cjs/version.js

@@ -3,4 +3,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
 // SDK semantic version. Bumped in lockstep with all other SDKs by the
 // release.yaml workflow.
-exports.SDK_VERSION = "1.1.26";
+exports.SDK_VERSION = "1.1.27";

package/lib/esm/common/gen/tzero/v1/payment/network_pb.d.ts

@@ -192,7 +192,8 @@ export type GetQuoteResponse = Message<"tzero.v1.payment.GetQuoteResponse"> & {
     /**
      * *
      * All best quotes from providers with credit lines.
-     * Each quote is the best rate for that provider for the requested amount.
+     * Each quote is that provider's best effective price for the requested amount:
+     * the lowest settlement amount, and on a tie the largest pay-out amount.
      * Each quote indicates whether it can be executed immediately.
      * Always returned alongside success/failure - providers can compare alternatives or see options when no executable quote exists.
      *

package/lib/esm/service/health.d.ts

@@ -0,0 +1,21 @@
+import { type ServiceImpl } from "@connectrpc/connect";
+import { Health } from "@buf/grpc_grpc.bufbuild_es/grpc/health/v1/health_pb.js";
+/**
+ * Headers carrying the identity of the SDK answering the probe. They ride on
+ * the health response and nowhere else: `HealthCheckResponse` has a single
+ * status field and `check` names its service in the request, so the contract
+ * itself has no room for this — and taxing every callback with headers only the
+ * probe reads would be worse.
+ */
+export declare const SDK_ECOSYSTEM_HEADER = "T0-Sdk-Ecosystem";
+export declare const SDK_VERSION_HEADER = "T0-Sdk-Version";
+/**
+ * Reports SERVING for the services registered on this server and NOT_FOUND for
+ * anything else. The set is frozen at registration; nothing is computed per
+ * request.
+ *
+ * `watch` is absent on purpose: it is server-streaming, and the body-hash
+ * signature scheme these servers run behind has no story for streams. Omitting
+ * it from a partial `ServiceImpl` makes connect-es answer UNIMPLEMENTED.
+ */
+export declare const createHealthServiceImpl: (services: string[]) => Partial<ServiceImpl<typeof Health>>;

package/lib/esm/service/health.js

@@ -0,0 +1,46 @@
+import { create } from "@bufbuild/protobuf";
+import { Code, ConnectError } from "@connectrpc/connect";
+import { HealthCheckResponse_ServingStatus, HealthCheckResponseSchema, } from "@buf/grpc_grpc.bufbuild_es/grpc/health/v1/health_pb.js";
+import { SDK_VERSION } from "../version.js";
+/**
+ * Headers carrying the identity of the SDK answering the probe. They ride on
+ * the health response and nowhere else: `HealthCheckResponse` has a single
+ * status field and `check` names its service in the request, so the contract
+ * itself has no room for this — and taxing every callback with headers only the
+ * probe reads would be worse.
+ */
+export const SDK_ECOSYSTEM_HEADER = "T0-Sdk-Ecosystem";
+export const SDK_VERSION_HEADER = "T0-Sdk-Version";
+const SDK_ECOSYSTEM = "node";
+/**
+ * Reports SERVING for the services registered on this server and NOT_FOUND for
+ * anything else. The set is frozen at registration; nothing is computed per
+ * request.
+ *
+ * `watch` is absent on purpose: it is server-streaming, and the body-hash
+ * signature scheme these servers run behind has no story for streams. Omitting
+ * it from a partial `ServiceImpl` makes connect-es answer UNIMPLEMENTED.
+ */
+export const createHealthServiceImpl = (services) => {
+    const registered = new Set(services);
+    const serving = create(HealthCheckResponseSchema, {
+        status: HealthCheckResponse_ServingStatus.SERVING,
+    });
+    return {
+        check(req, ctx) {
+            ctx.responseHeader.set(SDK_ECOSYSTEM_HEADER, SDK_ECOSYSTEM);
+            ctx.responseHeader.set(SDK_VERSION_HEADER, SDK_VERSION);
+            // The schema comes from a published .d.ts, whose type brands do not
+            // survive ServiceImpl's generics — connect-es widens the request to
+            // Message<string>. The descriptor is still the real one at runtime, so
+            // this narrows back to what the wire actually carries.
+            const { service } = req;
+            // An empty service name asks about the process as a whole, which is up if
+            // this handler is running at all.
+            if (service !== "" && !registered.has(service)) {
+                throw new ConnectError(`unknown service '${service}'`, Code.NotFound);
+            }
+            return serving;
+        },
+    };
+};

package/lib/esm/service/service.js

@@ -2,8 +2,8 @@ import { Code, ConnectError, createContextKey, createContextValues } from "@conn
 import NetworkHeaders from "../common/headers.js";
 import { secp256k1 } from '@noble/curves/secp256k1.js';
 import { createValidationInterceptor } from "./validate_response.js";
-import { SystemService } from "../common/gen/tzero/v1/system/system_pb.js";
-import { createSystemServiceImpl } from "./system.js";
+import { Health } from "@buf/grpc_grpc.bufbuild_es/grpc/health/v1/health_pb.js";
+import { createHealthServiceImpl } from "./health.js";
 export const REQUEST_VALIDITY_MILLIS = 60000;
 const createSignatureVerification = (networkPublicKey) => (next) => async (req) => {
     const ts = decodeNum(getHeader(req, NetworkHeaders.SignatureTimestamp));
@@ -51,8 +51,11 @@ export const createService = (networkPublicKey, registerRoutes) => {
                 },
             };
             registerRoutes(wrappedRouter);
-            collected.push(SystemService.typeName);
-            origService(SystemService, createSystemServiceImpl(collected));
+            // Health is the only service this transport mounts on its own — see
+            // docs/HEALTH_SERVICE.md. Same interceptors as everything else, so the
+            // probe is signed like any other call.
+            collected.push(Health.typeName);
+            origService(Health, createHealthServiceImpl(collected));
         },
         interceptors: [createSignatureVerification(networkPublicKey), createValidationInterceptor()],
         grpcWeb: false,

package/lib/esm/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.1.26";
+export declare const SDK_VERSION = "1.1.27";

package/lib/esm/version.js

@@ -1,3 +1,3 @@
 // SDK semantic version. Bumped in lockstep with all other SDKs by the
 // release.yaml workflow.
-export const SDK_VERSION = "1.1.26";
+export const SDK_VERSION = "1.1.27";