@superdurable/connectors-sdk 0.1.0 → 0.1.1

package/README.md

@@ -1,6 +1,6 @@
 # Connector TypeScript SDK
 
-`@superdurable/connectors-sdk` is the provider-neutral TypeScript SDK for Dex connectors. It provides stable value contracts, typed Query and Mutation operations, Dex Step factories, credential refresh, OAuth token exchanges, HTTP safety helpers, project configuration loading, scripted mocks, and single-dispatch marker decisions. The package is at version `0.1.0`, requires Node 22 or 24, and uses `@superdurable/dex` 1.28.0 or newer. It is ESM-only, matching Dex: use `import`; direct `require()` fails with `ERR_PACKAGE_PATH_NOT_EXPORTED`.
+`@superdurable/connectors-sdk` is the provider-neutral TypeScript SDK for Dex connectors. It provides stable value contracts, typed Query and Mutation operations, Dex Step factories, credential refresh, OAuth token exchanges, HTTP safety helpers, project configuration loading, scripted mocks, and single-dispatch marker decisions. The package is at version `0.1.1`, requires Node 22 or 24, and uses `@superdurable/dex` 1.28.0 or newer. It is ESM-only, matching Dex: use `import`; direct `require()` fails with `ERR_PACKAGE_PATH_NOT_EXPORTED`.
 
 Install dependencies and verify the package from this directory:
 
@@ -99,7 +99,7 @@ if (result.kind !== 'branch' || retryPolicy.totalDurationMs !== 3600000 || crede
 
 ## Provider HTTP
 
-The [complete runnable HTTP example](examples/providerhttp.mjs) sends one bounded request to a local server. `sendProviderRequest` resolves every address before connecting, pins the chosen address, and returns redirects without following them. `ProviderTransportError.isProvablyNotSent` is true only when no socket was assigned. A failure after socket assignment has an unknown dispatch outcome.
+The [complete runnable HTTP example](examples/providerhttp.mjs) sends one bounded request to a local server. `sendProviderRequest` resolves every address before connecting, pins the chosen address for IP literals and hostnames, and returns redirects without following them. `ProviderTransportError.isProvablyNotSent` is true for DNS, TCP connect, or TLS handshake failures before a usable connection could send HTTP bytes. Failures after connection or request writing have an unknown dispatch outcome, matching the Go connectors' DNS, connect, TLS, and obtained-connection trace.
 `BodyTooLargeError` preserves the response `status` and `headers`, so a caller can classify a 429 or 503 and its `Retry-After` even when the response body exceeds its limit.
 
 ```js

package/dist/{chunk-IVJLNZVL.js → chunk-2IDXFKMY.js}

@@ -84,7 +84,7 @@ var AddressRefusal = class extends Error {
   reason;
 };
 var ProviderTransportError = class extends Error {
-  /** True only when no socket was assigned to the request. */
+  /** True only when the request failed before a usable connection could send HTTP bytes. */
   constructor(isProvablyNotSent) {
     super("provider request failed in transport");
     this.isProvablyNotSent = isProvablyNotSent;
@@ -181,10 +181,10 @@ async function sendProviderRequest(request) {
     method: request.method,
     headers: request.headers,
     signal,
-    lookup: (_hostname, _options, callback) => callback(null, selected.address, selected.family)
+    lookup: (_hostname, options2, callback) => options2?.all ? callback(null, [{ address: selected.address, family: selected.family }]) : callback(null, selected.address, selected.family)
   };
   return new Promise((resolve, reject) => {
-    let hasSocket = false;
+    let hasConnected = false;
     let hasWrittenRequest = false;
     let clientRequest;
     try {
@@ -200,17 +200,20 @@ async function sendProviderRequest(request) {
       reject(new ProviderTransportError(true));
       return;
     }
-    clientRequest.on("socket", () => {
-      hasSocket = true;
+    clientRequest.on("socket", (socket) => {
+      if (!socket.connecting) hasConnected = true;
+      socket.once(parsed.protocol === "https:" ? "secureConnect" : "connect", () => {
+        hasConnected = true;
+      });
     });
     clientRequest.on("finish", () => {
       hasWrittenRequest = true;
     });
-    clientRequest.on("error", () => reject(new ProviderTransportError(!hasSocket && !hasWrittenRequest)));
+    clientRequest.on("error", () => reject(new ProviderTransportError(!hasConnected && !hasWrittenRequest)));
     try {
       clientRequest.end(request.body);
     } catch {
-      reject(new ProviderTransportError(!hasSocket && !hasWrittenRequest));
+      reject(new ProviderTransportError(!hasConnected && !hasWrittenRequest));
     }
   });
 }

package/dist/projectconfig/index.js

@@ -3,7 +3,7 @@ import {
   isLocalStorageHost,
   isPrivateBrokerHost,
   readBoundedBody
-} from "../chunk-IVJLNZVL.js";
+} from "../chunk-2IDXFKMY.js";
 import {
   OperationRefSchema,
   ReauthorizationRequiredError

package/dist/providerhttp/index.d.ts

@@ -19,7 +19,7 @@ declare class AddressRefusal extends Error {
 /** Sanitized transport failure with positive evidence about dispatch. */
 declare class ProviderTransportError extends Error {
     readonly isProvablyNotSent: boolean;
-    /** True only when no socket was assigned to the request. */
+    /** True only when the request failed before a usable connection could send HTTP bytes. */
     constructor(isProvablyNotSent: boolean);
 }
 /** Public-only HTTPS or explicitly owned private-network HTTP. */

package/dist/providerhttp/index.js

@@ -10,7 +10,7 @@ import {
   readErrorTokens,
   sendProviderRequest,
   validateBaseURL
-} from "../chunk-IVJLNZVL.js";
+} from "../chunk-2IDXFKMY.js";
 export {
   AddressRefusal,
   BodyTooLargeError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdurable/connectors-sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Provider-neutral TypeScript contracts for Dex connectors",
   "repository": {
     "type": "git",