cantonjs 0.2.0 → 0.3.0

package/dist/cjs/chains/presets.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineChainPreset = defineChainPreset;
+exports.withChainOverrides = withChainOverrides;
+function defineChainPreset(input) {
+    const participant = { ...(input.participant ?? {}) };
+    const scan = { ...(input.scan ?? {}) };
+    const validator = { ...(input.validator ?? {}) };
+    const authAudiences = { ...(input.authAudiences ?? {}) };
+    const splice = { ...(input.splice ?? {}) };
+    return {
+        id: input.id,
+        name: input.name,
+        network: input.network,
+        participant,
+        scan,
+        validator,
+        authAudiences,
+        splice,
+        jsonApiUrl: participant.jsonApiUrl,
+        grpcUrl: participant.grpcUrl,
+        scanUrl: scan.url,
+        validatorApiUrl: validator.apiBaseUrl,
+        scanProxyUrl: validator.scanProxyBaseUrl,
+        resetCycle: splice.resetCycleNote,
+    };
+}
+function withChainOverrides(chain, overrides = {}) {
+    return defineChainPreset({
+        id: chain.id,
+        name: overrides.name ?? chain.name,
+        network: chain.network,
+        participant: {
+            ...chain.participant,
+            ...overrides.participant,
+        },
+        scan: {
+            ...chain.scan,
+            ...overrides.scan,
+        },
+        validator: {
+            ...chain.validator,
+            ...overrides.validator,
+        },
+        authAudiences: {
+            ...chain.authAudiences,
+            ...overrides.authAudiences,
+        },
+        splice: {
+            ...chain.splice,
+            ...overrides.splice,
+        },
+    });
+}
+//# sourceMappingURL=presets.js.map

package/dist/cjs/chains/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../src/chains/presets.ts"],"names":[],"mappings":";;AAkEA,8CAuBC;AAED,gDA6BC;AAtDD,SAAgB,iBAAiB,CAAC,KAA6B;IAC7D,MAAM,WAAW,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,CAAA;IACpD,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAA;IACtC,MAAM,SAAS,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAA;IAChD,MAAM,aAAa,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,CAAA;IACxD,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAA;IAE1C,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW;QACX,IAAI;QACJ,SAAS;QACT,aAAa;QACb,MAAM;QACN,UAAU,EAAE,WAAW,CAAC,UAAU;QAClC,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,OAAO,EAAE,IAAI,CAAC,GAAG;QACjB,eAAe,EAAE,SAAS,CAAC,UAAU;QACrC,YAAY,EAAE,SAAS,CAAC,gBAAgB;QACxC,UAAU,EAAE,MAAM,CAAC,cAAc;KAClC,CAAA;AACH,CAAC;AAED,SAAgB,kBAAkB,CAChC,KAAkB,EAClB,YAAkC,EAAE;IAEpC,OAAO,iBAAiB,CAAC;QACvB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI;QAClC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE;YACX,GAAG,KAAK,CAAC,WAAW;YACpB,GAAG,SAAS,CAAC,WAAW;SACzB;QACD,IAAI,EAAE;YACJ,GAAG,KAAK,CAAC,IAAI;YACb,GAAG,SAAS,CAAC,IAAI;SAClB;QACD,SAAS,EAAE;YACT,GAAG,KAAK,CAAC,SAAS;YAClB,GAAG,SAAS,CAAC,SAAS;SACvB;QACD,aAAa,EAAE;YACb,GAAG,KAAK,CAAC,aAAa;YACtB,GAAG,SAAS,CAAC,aAAa;SAC3B;QACD,MAAM,EAAE;YACN,GAAG,KAAK,CAAC,MAAM;YACf,GAAG,SAAS,CAAC,MAAM;SACpB;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/cjs/errors/auth.d.ts

@@ -10,4 +10,10 @@ export declare class InvalidTokenError extends CantonjsError {
         cause?: Error;
     });
 }
+/** A request-scoped auth/session provider failed before the request was sent. */
+export declare class AuthProviderError extends CantonjsError {
+    constructor(transport: string, path: string, options?: {
+        cause?: Error;
+    });
+}
 //# sourceMappingURL=auth.d.ts.map

package/dist/cjs/errors/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/errors/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,WAAW,CAAA;AAEzD,6BAA6B;AAC7B,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;gBAEZ,SAAS,EAAE,IAAI;CAW5B;AAED,yCAAyC;AACzC,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAWxD"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/errors/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,WAAW,CAAA;AAEzD,6BAA6B;AAC7B,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;gBAEZ,SAAS,EAAE,IAAI;CAW5B;AAED,yCAAyC;AACzC,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAWxD;AAED,iFAAiF;AACjF,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAYzE"}

package/dist/cjs/errors/auth.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InvalidTokenError = exports.TokenExpiredError = void 0;
+exports.AuthProviderError = exports.InvalidTokenError = exports.TokenExpiredError = void 0;
 const base_js_1 = require("./base.js");
 /** JWT token has expired. */
 class TokenExpiredError extends base_js_1.CantonjsError {
@@ -33,4 +33,20 @@ class InvalidTokenError extends base_js_1.CantonjsError {
     }
 }
 exports.InvalidTokenError = InvalidTokenError;
+/** A request-scoped auth/session provider failed before the request was sent. */
+class AuthProviderError extends base_js_1.CantonjsError {
+    constructor(transport, path, options) {
+        super('Failed to resolve authentication for request', {
+            code: 'CJ2003',
+            cause: options?.cause,
+            metaMessages: [
+                `Transport: ${transport}`,
+                `Path: ${path}`,
+                'Ensure your auth/session provider returns a token or throws a CantonjsError.',
+            ],
+        });
+        this.name = 'AuthProviderError';
+    }
+}
+exports.AuthProviderError = AuthProviderError;
 //# sourceMappingURL=auth.js.map

package/dist/cjs/errors/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/errors/auth.ts"],"names":[],"mappings":";;;AAAA,uCAAyD;AAEzD,6BAA6B;AAC7B,MAAa,iBAAkB,SAAQ,uBAAa;IACzC,SAAS,CAAM;IAExB,YAAY,SAAe;QACzB,KAAK,CAAC,uBAAuB,EAAE;YAC7B,IAAI,EAAE,QAAqB;YAC3B,YAAY,EAAE;gBACZ,qBAAqB,SAAS,CAAC,WAAW,EAAE,EAAE;gBAC9C,sEAAsE;aACvE;SACF,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5B,CAAC;CACF;AAdD,8CAcC;AAED,yCAAyC;AACzC,MAAa,iBAAkB,SAAQ,uBAAa;IAClD,YAAY,MAAc,EAAE,OAA2B;QACrD,KAAK,CAAC,sBAAsB,MAAM,EAAE,EAAE;YACpC,IAAI,EAAE,QAAqB;YAC3B,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,YAAY,EAAE;gBACZ,kEAAkE;gBAClE,iCAAiC;aAClC;SACF,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AAZD,8CAYC"}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/errors/auth.ts"],"names":[],"mappings":";;;AAAA,uCAAyD;AAEzD,6BAA6B;AAC7B,MAAa,iBAAkB,SAAQ,uBAAa;IACzC,SAAS,CAAM;IAExB,YAAY,SAAe;QACzB,KAAK,CAAC,uBAAuB,EAAE;YAC7B,IAAI,EAAE,QAAqB;YAC3B,YAAY,EAAE;gBACZ,qBAAqB,SAAS,CAAC,WAAW,EAAE,EAAE;gBAC9C,sEAAsE;aACvE;SACF,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5B,CAAC;CACF;AAdD,8CAcC;AAED,yCAAyC;AACzC,MAAa,iBAAkB,SAAQ,uBAAa;IAClD,YAAY,MAAc,EAAE,OAA2B;QACrD,KAAK,CAAC,sBAAsB,MAAM,EAAE,EAAE;YACpC,IAAI,EAAE,QAAqB;YAC3B,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,YAAY,EAAE;gBACZ,kEAAkE;gBAClE,iCAAiC;aAClC;SACF,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AAZD,8CAYC;AAED,iFAAiF;AACjF,MAAa,iBAAkB,SAAQ,uBAAa;IAClD,YAAY,SAAiB,EAAE,IAAY,EAAE,OAA2B;QACtE,KAAK,CAAC,8CAA8C,EAAE;YACpD,IAAI,EAAE,QAAqB;YAC3B,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,YAAY,EAAE;gBACZ,cAAc,SAAS,EAAE;gBACzB,SAAS,IAAI,EAAE;gBACf,8EAA8E;aAC/E;SACF,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AAbD,8CAaC"}

package/dist/cjs/errors/index.d.ts

@@ -1,6 +1,6 @@
 export { CantonjsError, type ErrorCode, type CantonjsErrorOptions } from './base.js';
 export { ConnectionError, HttpError, GrpcError, TimeoutError } from './transport.js';
 export { CommandRejectedError, ContractNotFoundError, AuthorizationError } from './ledger.js';
-export { TokenExpiredError, InvalidTokenError } from './auth.js';
+export { TokenExpiredError, InvalidTokenError, AuthProviderError } from './auth.js';
 export { WebSocketError, StreamClosedError, ReconnectFailedError } from './streaming.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/errors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACpF,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACpF,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC7F,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAA;AACpF,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACpF,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC7F,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AACnF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/cjs/errors/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReconnectFailedError = exports.StreamClosedError = exports.WebSocketError = exports.InvalidTokenError = exports.TokenExpiredError = exports.AuthorizationError = exports.ContractNotFoundError = exports.CommandRejectedError = exports.TimeoutError = exports.GrpcError = exports.HttpError = exports.ConnectionError = exports.CantonjsError = void 0;
+exports.ReconnectFailedError = exports.StreamClosedError = exports.WebSocketError = exports.AuthProviderError = exports.InvalidTokenError = exports.TokenExpiredError = exports.AuthorizationError = exports.ContractNotFoundError = exports.CommandRejectedError = exports.TimeoutError = exports.GrpcError = exports.HttpError = exports.ConnectionError = exports.CantonjsError = void 0;
 var base_js_1 = require("./base.js");
 Object.defineProperty(exports, "CantonjsError", { enumerable: true, get: function () { return base_js_1.CantonjsError; } });
 var transport_js_1 = require("./transport.js");
@@ -15,6 +15,7 @@ Object.defineProperty(exports, "AuthorizationError", { enumerable: true, get: fu
 var auth_js_1 = require("./auth.js");
 Object.defineProperty(exports, "TokenExpiredError", { enumerable: true, get: function () { return auth_js_1.TokenExpiredError; } });
 Object.defineProperty(exports, "InvalidTokenError", { enumerable: true, get: function () { return auth_js_1.InvalidTokenError; } });
+Object.defineProperty(exports, "AuthProviderError", { enumerable: true, get: function () { return auth_js_1.AuthProviderError; } });
 var streaming_js_1 = require("./streaming.js");
 Object.defineProperty(exports, "WebSocketError", { enumerable: true, get: function () { return streaming_js_1.WebSocketError; } });
 Object.defineProperty(exports, "StreamClosedError", { enumerable: true, get: function () { return streaming_js_1.StreamClosedError; } });

package/dist/cjs/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":";;;AAAA,qCAAoF;AAA3E,wGAAA,aAAa,OAAA;AACtB,+CAAoF;AAA3E,+GAAA,eAAe,OAAA;AAAE,yGAAA,SAAS,OAAA;AAAE,yGAAA,SAAS,OAAA;AAAE,4GAAA,YAAY,OAAA;AAC5D,yCAA6F;AAApF,iHAAA,oBAAoB,OAAA;AAAE,kHAAA,qBAAqB,OAAA;AAAE,+GAAA,kBAAkB,OAAA;AACxE,qCAAgE;AAAvD,4GAAA,iBAAiB,OAAA;AAAE,4GAAA,iBAAiB,OAAA;AAC7C,+CAAwF;AAA/E,8GAAA,cAAc,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AAAE,oHAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":";;;AAAA,qCAAoF;AAA3E,wGAAA,aAAa,OAAA;AACtB,+CAAoF;AAA3E,+GAAA,eAAe,OAAA;AAAE,yGAAA,SAAS,OAAA;AAAE,yGAAA,SAAS,OAAA;AAAE,4GAAA,YAAY,OAAA;AAC5D,yCAA6F;AAApF,iHAAA,oBAAoB,OAAA;AAAE,kHAAA,qBAAqB,OAAA;AAAE,+GAAA,kBAAkB,OAAA;AACxE,qCAAmF;AAA1E,4GAAA,iBAAiB,OAAA;AAAE,4GAAA,iBAAiB,OAAA;AAAE,4GAAA,iBAAiB,OAAA;AAChE,+CAAwF;AAA/E,8GAAA,cAAc,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AAAE,oHAAA,oBAAoB,OAAA"}

package/dist/cjs/index.d.ts

@@ -4,14 +4,15 @@ export { createTestClient, type TestClient, type TestClientConfig, } from './cli
 export { jsonApi } from './transport/json-api.js';
 export { grpc, type GrpcTransportConfig, type GrpcTransportLike } from './transport/grpc.js';
 export { fallback, type FallbackTransportConfig } from './transport/fallback.js';
-export type { Transport, TransportConfig, TransportRequest } from './transport/types.js';
-export { CantonjsError, ConnectionError, HttpError, GrpcError, TimeoutError, CommandRejectedError, ContractNotFoundError, AuthorizationError, TokenExpiredError, InvalidTokenError, WebSocketError, StreamClosedError, ReconnectFailedError, } from './errors/index.js';
+export type { Transport, TransportAuthConfig, TransportConfig, TransportRequest, } from './transport/types.js';
+export type { MaybePromise, AuthContext, AuthSession, AuthProvider, SessionProvider, } from './auth/index.js';
+export { CantonjsError, ConnectionError, HttpError, GrpcError, TimeoutError, CommandRejectedError, ContractNotFoundError, AuthorizationError, TokenExpiredError, InvalidTokenError, AuthProviderError, WebSocketError, StreamClosedError, ReconnectFailedError, } from './errors/index.js';
 export type { ErrorCode, CantonjsErrorOptions } from './errors/base.js';
-export { localNet, devNet, testNet, mainNet, type CantonChain } from './chains/definitions.js';
+export { defineChainPreset, withChainOverrides, localNet, devNet, testNet, mainNet, type CantonAuthAudienceHints, type CantonChain, type CantonChainOverrides, type CantonChainPresetInput, type CantonNetwork, type CantonParticipantEndpoints, type CantonScanEndpoints, type CantonSpliceMetadata, type CantonValidatorEndpoints, } from './chains/index.js';
 export type { ContractId, TemplateId, CreatedEvent, ArchivedEvent, ExercisedEvent, TaggedEvent, ActiveContract, ContractEntry, } from './types/contract.js';
 export type { Party, ObjectMeta, PartyDetails, AllocatePartyRequest } from './types/party.js';
 export type { LedgerOffset, TaggedCommand, JsCommands, TransactionShape, EventFormat, TransactionFormat, } from './types/command.js';
-export type { JsTransaction, TaggedUpdate, UpdateFormat, } from './types/transaction.js';
+export type { JsTransaction, TaggedUpdate, UpdateFormat } from './types/transaction.js';
 export type { User, Right, RightKind, CreateUserRequest } from './types/user.js';
 export type { PackageStatus, PackageDetails } from './types/package.js';
 export type { IdentityProviderConfig, CreateIdentityProviderRequest, UpdateIdentityProviderRequest, } from './types/idp.js';

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,GACnB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,gCAAgC,CAAA;AAEvC,OAAO,EACL,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,+BAA+B,CAAA;AAGtC,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACjD,OAAO,EAAE,IAAI,EAAE,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAC5F,OAAO,EAAE,QAAQ,EAAE,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAChF,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAGxF,OAAO,EACL,aAAa,EACb,eAAe,EACf,SAAS,EACT,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAGvE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAG9F,YAAY,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAA;AAE5B,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAE7F,YAAY,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,iBAAiB,GAClB,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,wBAAwB,CAAA;AAE/B,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAChF,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACvE,YAAY,EACV,sBAAsB,EACtB,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,aAAa,GACd,MAAM,yBAAyB,CAAA;AAEhC,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,eAAe,EACf,SAAS,EACT,eAAe,GAChB,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,EAAE,eAAe,EAAE,KAAK,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,GAChB,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toWebSocketUrl = exports.streamCompletions = exports.streamContracts = exports.streamUpdates = exports.mainNet = exports.testNet = exports.devNet = exports.localNet = exports.ReconnectFailedError = exports.StreamClosedError = exports.WebSocketError = exports.InvalidTokenError = exports.TokenExpiredError = exports.AuthorizationError = exports.ContractNotFoundError = exports.CommandRejectedError = exports.TimeoutError = exports.GrpcError = exports.HttpError = exports.ConnectionError = exports.CantonjsError = exports.fallback = exports.grpc = exports.jsonApi = exports.createTestClient = exports.createAdminClient = exports.createLedgerClient = void 0;
+exports.toWebSocketUrl = exports.streamCompletions = exports.streamContracts = exports.streamUpdates = exports.mainNet = exports.testNet = exports.devNet = exports.localNet = exports.withChainOverrides = exports.defineChainPreset = exports.ReconnectFailedError = exports.StreamClosedError = exports.WebSocketError = exports.AuthProviderError = exports.InvalidTokenError = exports.TokenExpiredError = exports.AuthorizationError = exports.ContractNotFoundError = exports.CommandRejectedError = exports.TimeoutError = exports.GrpcError = exports.HttpError = exports.ConnectionError = exports.CantonjsError = exports.fallback = exports.grpc = exports.jsonApi = exports.createTestClient = exports.createAdminClient = exports.createLedgerClient = void 0;
 // Clients
 var createLedgerClient_js_1 = require("./clients/createLedgerClient.js");
 Object.defineProperty(exports, "createLedgerClient", { enumerable: true, get: function () { return createLedgerClient_js_1.createLedgerClient; } });
@@ -27,15 +27,18 @@ Object.defineProperty(exports, "ContractNotFoundError", { enumerable: true, get:
 Object.defineProperty(exports, "AuthorizationError", { enumerable: true, get: function () { return index_js_1.AuthorizationError; } });
 Object.defineProperty(exports, "TokenExpiredError", { enumerable: true, get: function () { return index_js_1.TokenExpiredError; } });
 Object.defineProperty(exports, "InvalidTokenError", { enumerable: true, get: function () { return index_js_1.InvalidTokenError; } });
+Object.defineProperty(exports, "AuthProviderError", { enumerable: true, get: function () { return index_js_1.AuthProviderError; } });
 Object.defineProperty(exports, "WebSocketError", { enumerable: true, get: function () { return index_js_1.WebSocketError; } });
 Object.defineProperty(exports, "StreamClosedError", { enumerable: true, get: function () { return index_js_1.StreamClosedError; } });
 Object.defineProperty(exports, "ReconnectFailedError", { enumerable: true, get: function () { return index_js_1.ReconnectFailedError; } });
 // Chains
-var definitions_js_1 = require("./chains/definitions.js");
-Object.defineProperty(exports, "localNet", { enumerable: true, get: function () { return definitions_js_1.localNet; } });
-Object.defineProperty(exports, "devNet", { enumerable: true, get: function () { return definitions_js_1.devNet; } });
-Object.defineProperty(exports, "testNet", { enumerable: true, get: function () { return definitions_js_1.testNet; } });
-Object.defineProperty(exports, "mainNet", { enumerable: true, get: function () { return definitions_js_1.mainNet; } });
+var index_js_2 = require("./chains/index.js");
+Object.defineProperty(exports, "defineChainPreset", { enumerable: true, get: function () { return index_js_2.defineChainPreset; } });
+Object.defineProperty(exports, "withChainOverrides", { enumerable: true, get: function () { return index_js_2.withChainOverrides; } });
+Object.defineProperty(exports, "localNet", { enumerable: true, get: function () { return index_js_2.localNet; } });
+Object.defineProperty(exports, "devNet", { enumerable: true, get: function () { return index_js_2.devNet; } });
+Object.defineProperty(exports, "testNet", { enumerable: true, get: function () { return index_js_2.testNet; } });
+Object.defineProperty(exports, "mainNet", { enumerable: true, get: function () { return index_js_2.mainNet; } });
 // Streaming
 var streamUpdates_js_1 = require("./streaming/streamUpdates.js");
 Object.defineProperty(exports, "streamUpdates", { enumerable: true, get: function () { return streamUpdates_js_1.streamUpdates; } });

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,UAAU;AACV,yEAQwC;AAPtC,2HAAA,kBAAkB,OAAA;AASpB,uEAMuC;AALrC,yHAAA,iBAAiB,OAAA;AAOnB,qEAIsC;AAHpC,uHAAA,gBAAgB,OAAA;AAKlB,YAAY;AACZ,uDAAiD;AAAxC,sGAAA,OAAO,OAAA;AAChB,+CAA4F;AAAnF,+FAAA,IAAI,OAAA;AACb,uDAAgF;AAAvE,uGAAA,QAAQ,OAAA;AAGjB,SAAS;AACT,8CAc0B;AAbxB,yGAAA,aAAa,OAAA;AACb,2GAAA,eAAe,OAAA;AACf,qGAAA,SAAS,OAAA;AACT,qGAAA,SAAS,OAAA;AACT,wGAAA,YAAY,OAAA;AACZ,gHAAA,oBAAoB,OAAA;AACpB,iHAAA,qBAAqB,OAAA;AACrB,8GAAA,kBAAkB,OAAA;AAClB,6GAAA,iBAAiB,OAAA;AACjB,6GAAA,iBAAiB,OAAA;AACjB,0GAAA,cAAc,OAAA;AACd,6GAAA,iBAAiB,OAAA;AACjB,gHAAA,oBAAoB,OAAA;AAItB,SAAS;AACT,0DAA8F;AAArF,0GAAA,QAAQ,OAAA;AAAE,wGAAA,MAAM,OAAA;AAAE,yGAAA,OAAO,OAAA;AAAE,yGAAA,OAAO,OAAA;AAyD3C,YAAY;AACZ,iEAA4D;AAAnD,iHAAA,aAAa,OAAA;AACtB,qEAA8F;AAArF,qHAAA,eAAe,OAAA;AACxB,yEAAoE;AAA3D,yHAAA,iBAAiB,OAAA;AAC1B,+DAA4D;AAAnD,iHAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,UAAU;AACV,yEAQwC;AAPtC,2HAAA,kBAAkB,OAAA;AASpB,uEAMuC;AALrC,yHAAA,iBAAiB,OAAA;AAOnB,qEAIsC;AAHpC,uHAAA,gBAAgB,OAAA;AAKlB,YAAY;AACZ,uDAAiD;AAAxC,sGAAA,OAAO,OAAA;AAChB,+CAA4F;AAAnF,+FAAA,IAAI,OAAA;AACb,uDAAgF;AAAvE,uGAAA,QAAQ,OAAA;AAiBjB,SAAS;AACT,8CAe0B;AAdxB,yGAAA,aAAa,OAAA;AACb,2GAAA,eAAe,OAAA;AACf,qGAAA,SAAS,OAAA;AACT,qGAAA,SAAS,OAAA;AACT,wGAAA,YAAY,OAAA;AACZ,gHAAA,oBAAoB,OAAA;AACpB,iHAAA,qBAAqB,OAAA;AACrB,8GAAA,kBAAkB,OAAA;AAClB,6GAAA,iBAAiB,OAAA;AACjB,6GAAA,iBAAiB,OAAA;AACjB,6GAAA,iBAAiB,OAAA;AACjB,0GAAA,cAAc,OAAA;AACd,6GAAA,iBAAiB,OAAA;AACjB,gHAAA,oBAAoB,OAAA;AAItB,SAAS;AACT,8CAgB0B;AAfxB,6GAAA,iBAAiB,OAAA;AACjB,8GAAA,kBAAkB,OAAA;AAClB,oGAAA,QAAQ,OAAA;AACR,kGAAA,MAAM,OAAA;AACN,mGAAA,OAAO,OAAA;AACP,mGAAA,OAAO,OAAA;AA+DT,YAAY;AACZ,iEAA4D;AAAnD,iHAAA,aAAa,OAAA;AACtB,qEAA8F;AAArF,qHAAA,eAAe,OAAA;AACxB,yEAAoE;AAA3D,yHAAA,iBAAiB,OAAA;AAC1B,+DAA4D;AAAnD,iHAAA,cAAc,OAAA"}

package/dist/cjs/testing/setupSandbox.d.ts

@@ -18,6 +18,7 @@
  * await sandbox.teardown()
  * ```
  */
+import type { AuthProvider, SessionProvider } from '../auth/types.js';
 import { type TestClient } from '../clients/createTestClient.js';
 import type { Transport } from '../transport/types.js';
 import type { Party } from '../types/party.js';
@@ -29,7 +30,11 @@ export type SandboxConfig = {
     readonly timeout?: number;
     /** JWT token. If not provided, attempts to use cantonctl auth. */
     readonly token?: string;
-    /** Party for the TestClient. Default: allocated via sandbox. */
+    /** Per-request bearer token provider for participant calls. */
+    readonly auth?: AuthProvider;
+    /** Per-request session provider for participant calls. */
+    readonly session?: SessionProvider;
+    /** Party for the TestClient. Default: `test-party`. */
     readonly party?: Party;
     /** Custom fetch implementation (for testing the fixture itself). */
     readonly fetchFn?: typeof fetch;
@@ -50,6 +55,11 @@ export type SandboxContext = {
     /** Tear down the sandbox. */
     readonly teardown: () => Promise<void>;
 };
+/** Default exec using child_process (Node.js only). */
+export declare function defaultExec(cmd: string): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
 /**
  * Set up a Canton sandbox for integration testing.
  *

package/dist/cjs/testing/setupSandbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setupSandbox.d.ts","sourceRoot":"","sources":["../../../src/testing/setupSandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAClF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAE9C,uCAAuC;AACvC,MAAM,MAAM,aAAa,GAAG;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,kEAAkE;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC/E,CAAA;AAED,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACvC,CAAA;AAiDD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,cAAc,CAAC,CAmDzB"}
+{"version":3,"file":"setupSandbox.d.ts","sourceRoot":"","sources":["../../../src/testing/setupSandbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAErE,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAClF,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,uBAAuB,CAAA;AACvE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAE9C,uCAAuC;AACvC,MAAM,MAAM,aAAa,GAAG;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,kEAAkE;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAA;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAA;IAClC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC/E,CAAA;AAED,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACvC,CAAA;AAED,uDAAuD;AACvD,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAM1F;AAqED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,cAAc,CAAC,CA6CzB"}

package/dist/cjs/testing/setupSandbox.js

@@ -20,16 +20,15 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultExec = defaultExec;
 exports.setupCantonSandbox = setupCantonSandbox;
 const json_api_js_1 = require("../transport/json-api.js");
 const createTestClient_js_1 = require("../clients/createTestClient.js");
 /** Default exec using child_process (Node.js only). */
 async function defaultExec(cmd) {
-    // Dynamic import to avoid bundling Node.js modules in browser builds
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const cp = await Function('return import("node:child_process")')();
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const util = await Function('return import("node:util")')();
+    // Dynamic import keeps Node-only modules out of browser-oriented consumers.
+    const cp = await Promise.resolve().then(() => require('node:child_process'));
+    const util = await Promise.resolve().then(() => require('node:util'));
     const execAsync = util.promisify(cp.exec);
     return execAsync(cmd);
 }
@@ -60,6 +59,26 @@ async function waitForHealth(url, timeoutMs, fetchFn) {
     }
     throw new Error(`Canton sandbox did not become ready within ${timeoutMs}ms at ${url}`);
 }
+async function resolveSandboxTransportConfig(url, fetchFn, execFn, config) {
+    const token = config.token?.trim() === '' ? undefined : config.token?.trim();
+    const transportConfig = {
+        url,
+        fetchFn,
+        token,
+        auth: config.auth,
+        session: config.session,
+    };
+    if (transportConfig.token === undefined &&
+        transportConfig.auth === undefined &&
+        transportConfig.session === undefined) {
+        const result = await execFn('cantonctl auth token');
+        return {
+            ...transportConfig,
+            token: result.stdout.trim(),
+        };
+    }
+    return transportConfig;
+}
 /**
  * Set up a Canton sandbox for integration testing.
  *
@@ -82,14 +101,7 @@ async function setupCantonSandbox(config = {}) {
     await execFn(`cantonctl dev start --port ${port}`);
     // Wait for health
     await waitForHealth(url, timeout, fetchFn);
-    // Get or generate token
-    let token = config.token;
-    if (!token) {
-        const result = await execFn('cantonctl auth token');
-        token = result.stdout.trim();
-    }
-    // Create transport and client
-    const transport = (0, json_api_js_1.jsonApi)({ url, token, fetchFn });
+    const transport = (0, json_api_js_1.jsonApi)(await resolveSandboxTransportConfig(url, fetchFn, execFn, config));
     const party = config.party ?? 'test-party';
     const client = (0, createTestClient_js_1.createTestClient)({ transport, party });
     return {

package/dist/cjs/testing/setupSandbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"setupSandbox.js","sourceRoot":"","sources":["../../../src/testing/setupSandbox.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;AA0FH,gDAqDC;AA7ID,0DAAkD;AAClD,wEAAkF;AAgClF,uDAAuD;AACvD,KAAK,UAAU,WAAW,CAAC,GAAW;IACpC,qEAAqE;IACrE,8DAA8D;IAC9D,MAAM,EAAE,GAAG,MAAO,QAAQ,CAAC,qCAAqC,CAAC,EAAmB,CAAA;IACpF,8DAA8D;IAC9D,MAAM,IAAI,GAAG,MAAO,QAAQ,CAAC,4BAA4B,CAAC,EAAmB,CAAA;IAC7E,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;IACzC,OAAO,SAAS,CAAC,GAAG,CAAgD,CAAA;AACtE,CAAC;AAED,+CAA+C;AAC/C,KAAK,UAAU,cAAc,CAC3B,MAAoE;IAEpE,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAA;QACnC,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,uDAAuD;AACvD,KAAK,UAAU,aAAa,CAC1B,GAAW,EACX,SAAiB,EACjB,OAAqB;IAErB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;IACvC,MAAM,QAAQ,GAAG,GAAG,CAAA;IAEpB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAA;YAC9C,IAAI,QAAQ,CAAC,EAAE;gBAAE,OAAM;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC/D,CAAC;IAED,MAAM,IAAI,KAAK,CACb,8CAA8C,SAAS,SAAS,GAAG,EAAE,CACtE,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,kBAAkB,CACtC,SAAwB,EAAE;IAE1B,MAAM,EACJ,IAAI,GAAG,IAAI,EACX,OAAO,GAAG,KAAK,EACf,OAAO,GAAG,UAAU,CAAC,KAAK,EAC1B,MAAM,GAAG,WAAW,GACrB,GAAG,MAAM,CAAA;IAEV,MAAM,GAAG,GAAG,oBAAoB,IAAI,EAAE,CAAA;IAEtC,+BAA+B;IAC/B,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAA;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,8CAA8C;YAC9C,4DAA4D;YAC5D,yCAAyC,CAC1C,CAAA;IACH,CAAC;IAED,gBAAgB;IAChB,MAAM,MAAM,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAA;IAElD,kBAAkB;IAClB,MAAM,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAE1C,wBAAwB;IACxB,IAAI,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IACxB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAA;QACnD,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;IAC9B,CAAC;IAED,8BAA8B;IAC9B,MAAM,SAAS,GAAG,IAAA,qBAAO,EAAC,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IAElD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAK,YAAsB,CAAA;IACrD,MAAM,MAAM,GAAG,IAAA,sCAAgB,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAA;IAErD,OAAO;QACL,GAAG;QACH,SAAS;QACT,MAAM;QACN,KAAK,CAAC,QAAQ;YACZ,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAA;YACnD,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"setupSandbox.js","sourceRoot":"","sources":["../../../src/testing/setupSandbox.ts"],"names":[],"mappings":"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"}

package/dist/cjs/transport/grpc.d.ts

@@ -19,13 +19,11 @@
  *     grpcTransport: createGrpcWebTransport({ baseUrl: 'http://localhost:7575' }),
  *   })
  */
-import type { Transport } from './types.js';
+import { type Transport, type TransportAuthConfig } from './types.js';
 /** Configuration for the gRPC transport. */
-export type GrpcTransportConfig = {
+export type GrpcTransportConfig = TransportAuthConfig & {
     /** Base URL of the Canton node. */
     readonly url: string;
-    /** JWT Bearer token for authentication. */
-    readonly token?: string;
     /**
      * A ConnectRPC transport instance (from @connectrpc/connect-web or connect-node).
      * Injected to keep cantonjs zero-dependency.

package/dist/cjs/transport/grpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grpc.d.ts","sourceRoot":"","sources":["../../../src/transport/grpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,YAAY,CAAA;AAE7D,4CAA4C;AAC5C,MAAM,MAAM,mBAAmB,GAAG;IAChC,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAA;CAC1C,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,KAAK,EAAE,CACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO,KACb,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAC5C,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CA0B3D"}
+{"version":3,"file":"grpc.d.ts","sourceRoot":"","sources":["../../../src/transport/grpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,mBAAmB,EAEzB,MAAM,YAAY,CAAA;AAEnB,4CAA4C;AAC5C,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG;IACtD,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAA;CAC1C,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,KAAK,EAAE,CACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO,KACb,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAC5C,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAmC3D"}

package/dist/cjs/transport/grpc.js

@@ -22,6 +22,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.grpc = grpc;
+const types_js_1 = require("./types.js");
 /**
  * Create a gRPC transport for the Canton Ledger API.
  *
@@ -29,16 +30,25 @@ exports.grpc = grpc;
  * Maps Transport requests to gRPC unary calls.
  */
 function grpc(config) {
-    const { url, token, grpcTransport } = config;
+    const { url, grpcTransport } = config;
     const baseUrl = url.replace(/\/+$/, '');
     return {
         type: 'grpc',
         url: baseUrl,
         async request(args) {
-            const headers = {};
-            if (token !== undefined) {
-                headers['Authorization'] = `Bearer ${token}`;
-            }
+            const headers = {
+                ...args.headers,
+                ...(await (0, types_js_1.resolveTransportHeaders)(config, {
+                    transport: 'grpc',
+                    url: baseUrl,
+                    request: {
+                        method: args.method,
+                        path: args.path,
+                        headers: args.headers,
+                        signal: args.signal,
+                    },
+                })),
+            };
             const result = await grpcTransport.unary(pathToService(args.path), pathToMethod(args.path), args.signal, args.timeout, headers, args.body ?? {});
             return result.message;
         },
@@ -52,18 +62,19 @@ function grpc(config) {
 function pathToService(path) {
     const segments = path.replace(/^\/v2\//, '').split('/');
     const serviceMap = {
-        'commands': 'com.daml.ledger.api.v2.CommandService',
+        commands: 'com.daml.ledger.api.v2.CommandService',
         'interactive-submission': 'com.daml.ledger.api.v2.InteractiveSubmissionService',
-        'state': 'com.daml.ledger.api.v2.StateService',
-        'updates': 'com.daml.ledger.api.v2.UpdateService',
-        'events': 'com.daml.ledger.api.v2.EventQueryService',
-        'parties': 'com.daml.ledger.api.v2.PartyManagementService',
-        'users': 'com.daml.ledger.api.v2.UserManagementService',
-        'packages': 'com.daml.ledger.api.v2.PackageService',
-        'dars': 'com.daml.ledger.api.v2.PackageManagementService',
-        'version': 'com.daml.ledger.api.v2.VersionService',
+        state: 'com.daml.ledger.api.v2.StateService',
+        updates: 'com.daml.ledger.api.v2.UpdateService',
+        events: 'com.daml.ledger.api.v2.EventQueryService',
+        parties: 'com.daml.ledger.api.v2.PartyManagementService',
+        users: 'com.daml.ledger.api.v2.UserManagementService',
+        packages: 'com.daml.ledger.api.v2.PackageService',
+        dars: 'com.daml.ledger.api.v2.PackageManagementService',
+        version: 'com.daml.ledger.api.v2.VersionService',
     };
-    const serviceName = serviceMap[segments[0] ?? ''] ?? 'unknown';
+    const serviceKey = segments.find((segment) => segment.length > 0);
+    const serviceName = serviceKey === undefined ? 'unknown' : (serviceMap[serviceKey] ?? 'unknown');
     return { typeName: serviceName };
 }
 /**
@@ -84,7 +95,8 @@ function pathToMethod(path) {
         '/v2/events/events-by-contract-id': 'GetEventsByContractId',
         '/v2/version': 'GetLedgerApiVersion',
     };
-    const methodName = methodMap[path] ?? path.split('/').pop() ?? 'unknown';
+    const fallbackMethodName = path.split('/').filter((segment) => segment.length > 0).at(-1);
+    const methodName = methodMap[path] ?? fallbackMethodName ?? 'unknown';
     return { name: methodName };
 }
 //# sourceMappingURL=grpc.js.map

package/dist/cjs/transport/grpc.js.map

@@ -1 +1 @@
-{"version":3,"file":"grpc.js","sourceRoot":"","sources":["../../../src/transport/grpc.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAsCH,oBA0BC;AAhCD;;;;;GAKG;AACH,SAAgB,IAAI,CAAC,MAA2B;IAC9C,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,CAAA;IAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAEvC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,OAAO;QAEZ,KAAK,CAAC,OAAO,CAAsB,IAAsB;YACvD,MAAM,OAAO,GAA2B,EAAE,CAAA;YAC1C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAA;YAC9C,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,CACtC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EACxB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EACvB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,OAAO,EACZ,OAAO,EACP,IAAI,CAAC,IAAI,IAAI,EAAE,CAChB,CAAA;YAED,OAAO,MAAM,CAAC,OAAoB,CAAA;QACpC,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACvD,MAAM,UAAU,GAA2B;QACzC,UAAU,EAAE,uCAAuC;QACnD,wBAAwB,EAAE,qDAAqD;QAC/E,OAAO,EAAE,qCAAqC;QAC9C,SAAS,EAAE,sCAAsC;QACjD,QAAQ,EAAE,0CAA0C;QACpD,SAAS,EAAE,+CAA+C;QAC1D,OAAO,EAAE,8CAA8C;QACvD,UAAU,EAAE,uCAAuC;QACnD,MAAM,EAAE,iDAAiD;QACzD,SAAS,EAAE,uCAAuC;KACnD,CAAA;IACD,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,SAAS,CAAA;IAC9D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAA;AAClC,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,SAAS,GAA2B;QACxC,8BAA8B,EAAE,eAAe;QAC/C,8CAA8C,EAAE,6BAA6B;QAC7E,+CAA+C,EAAE,8BAA8B;QAC/E,oCAAoC,EAAE,mBAAmB;QACzD,oCAAoC,EAAE,mBAAmB;QACzD,4BAA4B,EAAE,oBAAoB;QAClD,mCAAmC,EAAE,2BAA2B;QAChE,sBAAsB,EAAE,cAAc;QACtC,iCAAiC,EAAE,wBAAwB;QAC3D,+BAA+B,EAAE,oBAAoB;QACrD,kCAAkC,EAAE,uBAAuB;QAC3D,aAAa,EAAE,qBAAqB;KACrC,CAAA;IACD,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS,CAAA;IACxE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;AAC7B,CAAC"}
+{"version":3,"file":"grpc.js","sourceRoot":"","sources":["../../../src/transport/grpc.ts"],"names":[],"mappings":"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"}

package/dist/cjs/transport/index.d.ts

@@ -1,3 +1,3 @@
 export { jsonApi } from './json-api.js';
-export type { Transport, TransportConfig, TransportRequest, TransportFactory } from './types.js';
+export type { Transport, TransportAuthConfig, TransportConfig, TransportRequest, TransportFactory, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/transport/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,YAAY,EACV,SAAS,EACT,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAA"}

package/dist/cjs/transport/json-api.d.ts

@@ -4,6 +4,6 @@
  * Primary transport for cantonjs. Communicates with Canton's JSON Ledger API
  * via HTTP requests to /v2/* endpoints.
  */
-import type { Transport, TransportConfig } from './types.js';
+import { type Transport, type TransportConfig } from './types.js';
 export declare function jsonApi(config: TransportConfig): Transport;
 //# sourceMappingURL=json-api.d.ts.map

package/dist/cjs/transport/json-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-api.d.ts","sourceRoot":"","sources":["../../../src/transport/json-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAoB,MAAM,YAAY,CAAA;AAI9E,wBAAgB,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAsE1D"}
+{"version":3,"file":"json-api.d.ts","sourceRoot":"","sources":["../../../src/transport/json-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,eAAe,EAErB,MAAM,YAAY,CAAA;AAInB,wBAAgB,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAkF1D"}

package/dist/cjs/transport/json-api.js

@@ -8,27 +8,41 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.jsonApi = jsonApi;
 const transport_js_1 = require("../errors/transport.js");
+const types_js_1 = require("./types.js");
 const DEFAULT_TIMEOUT = 30_000;
 function jsonApi(config) {
-    const { url, token, timeout = DEFAULT_TIMEOUT, fetchFn = globalThis.fetch } = config;
+    const { url, timeout = DEFAULT_TIMEOUT, fetchFn = globalThis.fetch } = config;
     const baseUrl = url.replace(/\/+$/, '');
     return {
         type: 'json-api',
         url: baseUrl,
         async request(args) {
             const requestUrl = `${baseUrl}${args.path}`;
+            const authHeaders = await (0, types_js_1.resolveTransportHeaders)(config, {
+                transport: 'json-api',
+                url: baseUrl,
+                request: {
+                    method: args.method,
+                    path: args.path,
+                    headers: args.headers,
+                    signal: args.signal,
+                },
+            });
             const headers = {
                 'Content-Type': 'application/json',
                 ...args.headers,
+                ...authHeaders,
             };
-            if (token !== undefined) {
-                headers['Authorization'] = `Bearer ${token}`;
-            }
             const controller = new AbortController();
             const timeoutMs = args.timeout ?? timeout;
             const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
             if (args.signal !== undefined) {
-                args.signal.addEventListener('abort', () => controller.abort(), { once: true });
+                if (args.signal.aborted) {
+                    controller.abort();
+                }
+                else {
+                    args.signal.addEventListener('abort', () => controller.abort(), { once: true });
+                }
             }
             try {
                 const response = await fetchFn(requestUrl, {

package/dist/cjs/transport/json-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"json-api.js","sourceRoot":"","sources":["../../../src/transport/json-api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"json-api.js","sourceRoot":"","sources":["../../../src/transport/json-api.ts"],"names":[],"mappings":"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"}

package/dist/cjs/transport/types.d.ts

@@ -5,6 +5,7 @@
  * transport that handles the actual request execution. This separates
  * client logic from communication concerns.
  */
+import type { AuthContext, AuthProvider, AuthSession, SessionProvider } from '../auth/types.js';
 /** A transport handles sending requests to a Canton node. */
 export type Transport = {
     readonly type: string;
@@ -20,12 +21,19 @@ export type TransportRequest = {
     signal?: AbortSignal;
     timeout?: number;
 };
+/** Authentication configuration shared by core transports. */
+export type TransportAuthConfig = {
+    /** Static JWT Bearer token for authentication. */
+    readonly token?: string;
+    /** Per-request bearer token provider. */
+    readonly auth?: AuthProvider;
+    /** Per-request session provider for advanced auth/header injection. */
+    readonly session?: SessionProvider;
+};
 /** Configuration shared by all transport types. */
-export type TransportConfig = {
+export type TransportConfig = TransportAuthConfig & {
     /** Base URL of the Canton node. */
     readonly url: string;
-    /** JWT Bearer token for authentication. */
-    readonly token?: string;
     /** Request timeout in milliseconds. Default: 30000. */
     readonly timeout?: number;
     /** Custom fetch implementation (for testing or environments without global fetch). */
@@ -33,4 +41,6 @@ export type TransportConfig = {
 };
 /** Factory function type for creating transports. */
 export type TransportFactory = (config: TransportConfig) => Transport;
+export declare function resolveTransportSession(config: TransportAuthConfig, context: AuthContext): Promise<AuthSession | undefined>;
+export declare function resolveTransportHeaders(config: TransportAuthConfig, context: AuthContext): Promise<Record<string, string>>;
 //# sourceMappingURL=types.d.ts.map