@fairmint/canton-node-sdk 0.0.237 → 0.0.239

package/build/src/clients/validator-api/schemas/api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/clients/validator-api/schemas/api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iBAAiB;AACjB,2CAAyB;AAEzB,yCAAyC;AACzC,wCAAsB;AAEtB,qBAAqB;AACrB,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/clients/validator-api/schemas/api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gBAAgB;AAChB,0CAAwB;AAExB,iBAAiB;AACjB,2CAAyB;AAEzB,yCAAyC;AACzC,wCAAsB;AAEtB,qBAAqB;AACrB,+CAA6B"}

package/build/src/core/BaseClient.d.ts

@@ -1,5 +1,6 @@
 import { type PartyId, type UserId } from './branded-types';
 import { HttpClient } from './http/HttpClient';
+import { type HttpReadRequestOptions, type HttpRequestOptions } from './http/request-retry';
 import { type CantonRuntime } from './runtime';
 import { type ApiType, type ClientConfig, type NetworkType, type PartialProviderConfig, type ProviderType, type RequestConfig } from './types';
 /** Abstract base class providing common functionality for all API clients */
@@ -28,10 +29,10 @@ export declare abstract class BaseClient {
      * proactive token refresh (e.g., at 50% of lifetime or 2 minutes before expiry, whichever is later).
      */
     getTokenLifetimeMs(): number | null;
-    makeGetRequest<T>(url: string, config?: RequestConfig): Promise<T>;
-    makePostRequest<T>(url: string, data: unknown, config?: RequestConfig): Promise<T>;
-    makeDeleteRequest<T>(url: string, config?: RequestConfig): Promise<T>;
-    makePatchRequest<T>(url: string, data: unknown, config?: RequestConfig): Promise<T>;
+    makeGetRequest<T>(url: string, config?: RequestConfig, options?: HttpReadRequestOptions<undefined>): Promise<T>;
+    makePostRequest<T, Body = unknown>(url: string, data: Body, config?: RequestConfig, options?: HttpRequestOptions<Body>): Promise<T>;
+    makeDeleteRequest<T>(url: string, config?: RequestConfig, options?: HttpRequestOptions<undefined>): Promise<T>;
+    makePatchRequest<T, Body = unknown>(url: string, data: Body, config?: RequestConfig, options?: HttpRequestOptions<Body>): Promise<T>;
     getLogger(): import('./logging').Logger | undefined;
     getApiUrl(): string;
     getPartyId(): PartyId;

package/build/src/core/BaseClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseClient.d.ts","sourceRoot":"","sources":["../../../src/core/BaseClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,qBAAqB,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAE/I,6EAA6E;AAC7E,8BAAsB,UAAU;IAC9B,SAAS,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACxC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC;IACrC,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC;IACjC,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC;IAEjC,YAAY,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EA8BnD;IAEY,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAM3C;IAED;;;OAGG;IACI,UAAU,IAAI,IAAI,CAMxB;IAED;;;OAGG;IACI,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAMzC;IAED,sHAAsH;IAC/G,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAMvC;IAED;;;OAGG;IACI,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAMzC;IAEY,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAElF;IAEY,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAElG;IAEY,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAErF;IAEY,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAEnG;IAEM,SAAS,IAAI,OAAO,WAAW,EAAE,MAAM,GAAG,SAAS,CAEzD;IAEM,SAAS,IAAI,MAAM,CAMzB;IAEM,UAAU,IAAI,OAAO,CAU3B;IAED;;;OAGG;IACI,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEjD;IAEM,SAAS,IAAI,MAAM,GAAG,SAAS,CAOrC;IAEM,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAI5C;IAEM,cAAc,CAAC,iBAAiB,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,EAAE,CAWzE;IAEM,UAAU,IAAI,WAAW,CAE/B;IAEM,WAAW,IAAI,YAAY,GAAG,SAAS,CAE7C;IAEM,UAAU,IAAI,aAAa,CAEjC;IAEM,eAAe,IAAI,MAAM,CAE/B;IAEM,UAAU,IAAI,MAAM,CAE1B;IAEM,UAAU,IAAI,OAAO,CAE3B;CAEF"}
+{"version":3,"file":"BaseClient.d.ts","sourceRoot":"","sources":["../../../src/core/BaseClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,KAAK,sBAAsB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,SAAS,CAAC;AAEjB,6EAA6E;AAC7E,8BAAsB,UAAU;IAC9B,SAAS,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACxC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC;IACrC,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC;IACjC,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC;IAEjC,YAAY,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EA8BnD;IAEY,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAM3C;IAED;;;OAGG;IACI,UAAU,IAAI,IAAI,CAMxB;IAED;;;OAGG;IACI,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAMzC;IAED,sHAAsH;IAC/G,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAMvC;IAED;;;OAGG;IACI,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAMzC;IAEY,cAAc,CAAC,CAAC,EAC3B,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,aAAkB,EAC1B,OAAO,GAAE,sBAAsB,CAAC,SAAS,CAAM,GAC9C,OAAO,CAAC,CAAC,CAAC,CAEZ;IAEY,eAAe,CAAC,CAAC,EAAE,IAAI,GAAG,OAAO,EAC5C,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,aAAkB,EAC1B,OAAO,GAAE,kBAAkB,CAAC,IAAI,CAAM,GACrC,OAAO,CAAC,CAAC,CAAC,CAEZ;IAEY,iBAAiB,CAAC,CAAC,EAC9B,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,aAAkB,EAC1B,OAAO,GAAE,kBAAkB,CAAC,SAAS,CAAM,GAC1C,OAAO,CAAC,CAAC,CAAC,CAEZ;IAEY,gBAAgB,CAAC,CAAC,EAAE,IAAI,GAAG,OAAO,EAC7C,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,IAAI,EACV,MAAM,GAAE,aAAkB,EAC1B,OAAO,GAAE,kBAAkB,CAAC,IAAI,CAAM,GACrC,OAAO,CAAC,CAAC,CAAC,CAEZ;IAEM,SAAS,IAAI,OAAO,WAAW,EAAE,MAAM,GAAG,SAAS,CAEzD;IAEM,SAAS,IAAI,MAAM,CAMzB;IAEM,UAAU,IAAI,OAAO,CAU3B;IAED;;;OAGG;IACI,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEjD;IAEM,SAAS,IAAI,MAAM,GAAG,SAAS,CAOrC;IAEM,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAI5C;IAEM,cAAc,CAAC,iBAAiB,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,EAAE,CAWzE;IAEM,UAAU,IAAI,WAAW,CAE/B;IAEM,WAAW,IAAI,YAAY,GAAG,SAAS,CAE7C;IAEM,UAAU,IAAI,aAAa,CAEjC;IAEM,eAAe,IAAI,MAAM,CAE/B;IAEM,UAAU,IAAI,MAAM,CAE1B;IAEM,UAAU,IAAI,OAAO,CAE3B;CACF"}

package/build/src/core/BaseClient.js

@@ -78,17 +78,17 @@ class BaseClient {
         }
         return this.runtime.getAuthenticationManager(this.config.authUrl, apiConfig.auth).getTokenLifetimeMs();
     }
-    async makeGetRequest(url, config = {}) {
-        return this.httpClient.makeGetRequest(url, config);
+    async makeGetRequest(url, config = {}, options = {}) {
+        return this.httpClient.makeGetRequest(url, config, options);
     }
-    async makePostRequest(url, data, config = {}) {
-        return this.httpClient.makePostRequest(url, data, config);
+    async makePostRequest(url, data, config = {}, options = {}) {
+        return this.httpClient.makePostRequest(url, data, config, options);
     }
-    async makeDeleteRequest(url, config = {}) {
-        return this.httpClient.makeDeleteRequest(url, config);
+    async makeDeleteRequest(url, config = {}, options = {}) {
+        return this.httpClient.makeDeleteRequest(url, config, options);
     }
-    async makePatchRequest(url, data, config = {}) {
-        return this.httpClient.makePatchRequest(url, data, config);
+    async makePatchRequest(url, data, config = {}, options = {}) {
+        return this.httpClient.makePatchRequest(url, data, config, options);
     }
     getLogger() {
         return this.clientConfig.logger;

package/build/src/core/BaseClient.js.map

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

package/build/src/core/errors.d.ts

@@ -24,6 +24,7 @@ export declare const ErrorCode: {
     readonly API_ERROR: 'API_ERROR';
     readonly VALIDATION_ERROR: 'VALIDATION_ERROR';
     readonly NETWORK_ERROR: 'NETWORK_ERROR';
+    readonly UNKNOWN_MUTATION_OUTCOME: 'UNKNOWN_MUTATION_OUTCOME';
 };
 export type ErrorCodeType = (typeof ErrorCode)[keyof typeof ErrorCode];
 /**
@@ -67,6 +68,30 @@ export declare class NetworkError extends CantonError {
     readonly name: string;
     constructor(message: string, context?: ErrorContext);
 }
+/** HTTP methods whose requests may have changed server state before the response was lost. */
+export type MutationHttpMethod = 'POST' | 'PATCH' | 'DELETE';
+/** Safe, redacted details for a mutation whose server-side outcome cannot be determined. */
+export interface UnknownMutationOutcomeDetails {
+    readonly method: MutationHttpMethod;
+    readonly endpoint: string;
+    readonly attempts: number;
+    readonly attemptIdentifiers?: readonly string[];
+}
+/**
+ * Error thrown when a mutation was dispatched but the transport could not determine whether the server applied it.
+ *
+ * Request bodies, signatures, and tokens are deliberately excluded from the message and serializable context. Callers
+ * may opt into a retry strategy and supply explicitly redacted attempt identifiers when an operation is safe to retry.
+ */
+export declare class UnknownMutationOutcomeError extends CantonError {
+    readonly name: string;
+    readonly method: MutationHttpMethod;
+    readonly endpoint: string;
+    readonly attempts: number;
+    readonly attemptIdentifiers: readonly string[];
+    readonly cause: Error;
+    constructor(details: UnknownMutationOutcomeDetails, cause: Error);
+}
 /** Error codes for operation-specific errors. */
 export declare const OperationErrorCode: {
     readonly MISSING_CONTRACT: 'MISSING_CONTRACT';
@@ -86,7 +111,7 @@ export declare class OperationError extends CantonError {
 }
 /** Normalize a Canton SDK-shaped error into serializable details for logging or API responses. */
 export declare function normalizeCantonError(error: unknown): NormalizedCantonErrorDetails | null;
-/** Return true when a Canton error represents a non-retryable 4xx mutation rejection. */
+/** Return true when a Canton response proves that a mutation was rejected, independently from retryability. */
 export declare function isDefiniteCantonMutationRejection(error: unknown): boolean;
 /** Read Canton's structured mutation-outcome signal when the API supplies one. */
 export declare function readCantonDefiniteAnswer(error: unknown): boolean | undefined;

package/build/src/core/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE7D,qEAAqE;AACrE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,gDAAgD;AAChD,eAAO,MAAM,SAAS;aACpB,YAAY,EAAE,cAAc;aAC5B,mBAAmB,EAAE,qBAAqB;aAC1C,oBAAoB,EAAE,sBAAsB;aAC5C,SAAS,EAAE,WAAW;aACtB,gBAAgB,EAAE,kBAAkB;aACpC,aAAa,EAAE,eAAe;aAC9B,wBAAwB,EAAE,0BAA0B;CAC5C,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEvE;;;GAGG;AACH,qBAAa,WAAY,SAAQ,eAAe;IAC9C,SAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGhE;CACF;AAED,6DAA6D;AAC7D,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,SAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,8CAA8C;AAC9C,qBAAa,mBAAoB,SAAQ,WAAW;IAClD,SAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,2CAA2C;AAC3C,qBAAa,QAAS,SAAQ,WAAW;aAKrB,MAAM,CAAC,EAAE,MAAM;aACf,UAAU,CAAC,EAAE,MAAM;IALrC,SAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC,YACE,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,UAAU,CAAC,EAAE,MAAM,YAAA,EACnC,QAAQ,CAAC,EAAE,YAAY,EAIxB;IAED;;;;OAIG;IACH,IAAW,QAAQ,IAAI,YAAY,GAAG,SAAS,CAE9C;CACF;AAED,oDAAoD;AACpD,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,SAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,+CAA+C;AAC/C,qBAAa,YAAa,SAAQ,WAAW;IAC3C,SAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,8FAA8F;AAC9F,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7D,4FAA4F;AAC5F,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjD;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,WAAW;IAC1D,SAAyB,IAAI,EAAE,MAAM,CAAC;IACtC,SAAgB,MAAM,EAAE,kBAAkB,CAAC;IAC3C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtD,SAAgB,KAAK,EAAE,KAAK,CAAC;IAE7B,YAAY,OAAO,EAAE,6BAA6B,EAAE,KAAK,EAAE,KAAK,EAqB/D;CACF;AAED,iDAAiD;AACjD,eAAO,MAAM,kBAAkB;aAC7B,gBAAgB,EAAE,kBAAkB;aACpC,iBAAiB,EAAE,mBAAmB;aACtC,kBAAkB,EAAE,oBAAoB;aACxC,cAAc,EAAE,gBAAgB;aAChC,iBAAiB,EAAE,mBAAmB;aACtC,sBAAsB,EAAE,wBAAwB;aAChD,qBAAqB,EAAE,uBAAuB;aAC9C,kBAAkB,EAAE,oBAAoB;CAChC,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAElG,6CAA6C;AAC7C,qBAAa,cAAe,SAAQ,WAAW;IAC7C,SAAyB,IAAI,EAAE,MAAM,CAAC;IAEtC,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,YAAY,EAGhF;CACF;AAaD,kGAAkG;AAClG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,4BAA4B,GAAG,IAAI,CAoBxF;AAED,+GAA+G;AAC/G,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKzE;AAED,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAI5E"}

package/build/src/core/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OperationError = exports.OperationErrorCode = exports.NetworkError = exports.ValidationError = exports.ApiError = exports.AuthenticationError = exports.ConfigurationError = exports.CantonError = exports.ErrorCode = void 0;
+exports.OperationError = exports.OperationErrorCode = exports.UnknownMutationOutcomeError = exports.NetworkError = exports.ValidationError = exports.ApiError = exports.AuthenticationError = exports.ConfigurationError = exports.CantonError = exports.ErrorCode = void 0;
 exports.normalizeCantonError = normalizeCantonError;
 exports.isDefiniteCantonMutationRejection = isDefiniteCantonMutationRejection;
 exports.readCantonDefiniteAnswer = readCantonDefiniteAnswer;
@@ -13,6 +13,7 @@ exports.ErrorCode = {
     API_ERROR: 'API_ERROR',
     VALIDATION_ERROR: 'VALIDATION_ERROR',
     NETWORK_ERROR: 'NETWORK_ERROR',
+    UNKNOWN_MUTATION_OUTCOME: 'UNKNOWN_MUTATION_OUTCOME',
 };
 /**
  * Base error class for all Canton SDK errors. Extends `@hardlydifficult/rest-client`'s `RestClientError` so errors are
@@ -75,6 +76,32 @@ class NetworkError extends CantonError {
     }
 }
 exports.NetworkError = NetworkError;
+/**
+ * Error thrown when a mutation was dispatched but the transport could not determine whether the server applied it.
+ *
+ * Request bodies, signatures, and tokens are deliberately excluded from the message and serializable context. Callers
+ * may opt into a retry strategy and supply explicitly redacted attempt identifiers when an operation is safe to retry.
+ */
+class UnknownMutationOutcomeError extends CantonError {
+    constructor(details, cause) {
+        const attemptIdentifiers = Object.freeze([...(details.attemptIdentifiers ?? [])]);
+        const context = {
+            method: details.method,
+            endpoint: details.endpoint,
+            attempts: details.attempts,
+            ...(attemptIdentifiers.length > 0 ? { attemptIdentifiers } : {}),
+        };
+        super(`The outcome of ${details.method} ${details.endpoint} is unknown after ${details.attempts} request attempt${details.attempts === 1 ? '' : 's'}`, exports.ErrorCode.UNKNOWN_MUTATION_OUTCOME, context);
+        this.name = 'UnknownMutationOutcomeError';
+        this.method = details.method;
+        this.endpoint = details.endpoint;
+        this.attempts = details.attempts;
+        this.attemptIdentifiers = attemptIdentifiers;
+        this.cause = cause;
+        Object.defineProperty(this, 'cause', { enumerable: false });
+    }
+}
+exports.UnknownMutationOutcomeError = UnknownMutationOutcomeError;
 /** Error codes for operation-specific errors. */
 exports.OperationErrorCode = {
     MISSING_CONTRACT: 'MISSING_CONTRACT',
@@ -101,6 +128,7 @@ const CANTON_SDK_ERROR_NAMES = new Set([
     'ConfigurationError',
     'NetworkError',
     'OperationError',
+    'UnknownMutationOutcomeError',
     'ValidationError',
 ]);
 /** Normalize a Canton SDK-shaped error into serializable details for logging or API responses. */
@@ -124,14 +152,12 @@ function normalizeCantonError(error) {
         ...(context !== undefined ? { context, response: context } : {}),
     };
 }
-/** Return true when a Canton error represents a non-retryable 4xx mutation rejection. */
+/** Return true when a Canton response proves that a mutation was rejected, independently from retryability. */
 function isDefiniteCantonMutationRejection(error) {
     const details = normalizeCantonError(error);
     const status = details?.status;
     if (status === undefined)
         return false;
-    if (isRetryableCantonApiCode(status, details?.code))
-        return false;
     return status >= 400 && status < 500 && status !== 408 && status !== 425 && status !== 429;
 }
 /** Read Canton's structured mutation-outcome signal when the API supplies one. */
@@ -147,11 +173,6 @@ function readDefiniteAnswerProperty(source) {
     const value = source['definiteAnswer'] ?? source['definite_answer'];
     return typeof value === 'boolean' ? value : undefined;
 }
-/** Return true when a Canton API status/code pair is known to be transient. */
-function isRetryableCantonApiCode(status, code) {
-    return ((status === 400 && code === 'UNKNOWN_CONTRACT_SYNCHRONIZERS') ||
-        (status === 409 && code === 'SEQUENCER_BACKPRESSURE'));
-}
 /** Read normalized error context from current and legacy SDK error fields. */
 function readErrorContext(source) {
     const { context } = source;

package/build/src/core/errors.js.map

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

package/build/src/core/http/HttpClient.d.ts

@@ -1,12 +1,13 @@
 import { type Logger } from '../logging';
 import { type RequestConfig } from '../types';
+import { type HttpReadRequestOptions, type HttpRequestOptions } from './request-retry';
 export interface HttpClientRetryConfig {
-    /** Number of retries after the initial attempt. */
+    /** Number of retries after the initial attempt for requests explicitly classified as semantic reads. */
     readonly maxRetries: number;
-    /** Delay between retries in milliseconds. */
+    /** Delay between read-only retries in milliseconds. */
     readonly delayMs: number;
 }
-/** Handles HTTP requests with authentication, logging, and error handling */
+/** Handles HTTP requests with authentication, logging, cancellation, and explicit retry safety. */
 export declare class HttpClient {
     private readonly axiosInstance;
     private readonly bearerTokenProvider;
@@ -15,40 +16,49 @@ export declare class HttpClient {
     private static readonly CAUSE_TRUNCATE_LENGTH;
     private static readonly CONTEXT_VALUE_TRUNCATE_LENGTH;
     private static readonly MAX_CONTEXT_KEYS;
+    private static readonly MAX_ATTEMPT_IDENTIFIER_LENGTH;
     constructor(logger?: Logger, bearerTokenProvider?: () => Promise<string>);
+    /** Configure the default retry policy used only by requests classified as semantic reads. */
     setRetryConfig(config: HttpClientRetryConfig): void;
-    makeGetRequest<T>(url: string, config?: RequestConfig, _retryCount?: number): Promise<T>;
-    makePostRequest<T>(url: string, data: unknown, config?: RequestConfig, _retryCount?: number): Promise<T>;
-    makeDeleteRequest<T>(url: string, config?: RequestConfig, _retryCount?: number): Promise<T>;
-    makePatchRequest<T>(url: string, data: unknown, config?: RequestConfig, _retryCount?: number): Promise<T>;
+    makeGetRequest<T>(url: string, config?: RequestConfig, options?: HttpReadRequestOptions<undefined>): Promise<T>;
+    makePostRequest<T, Body = unknown>(url: string, data: Body, config?: RequestConfig, options?: HttpRequestOptions<Body>): Promise<T>;
+    makeDeleteRequest<T>(url: string, config?: RequestConfig, options?: HttpRequestOptions<undefined>): Promise<T>;
+    makePatchRequest<T, Body = unknown>(url: string, data: Body, config?: RequestConfig, options?: HttpRequestOptions<Body>): Promise<T>;
+    private makeRequest;
+    private resolveRetryStrategy;
+    private validateMaxAttempts;
+    private shouldRetry;
+    private waitForRetry;
+    private createAttemptContext;
+    private createReadonlyBody;
+    private cloneBody;
+    /** Convert a deeply readonly callback result back into an isolated mutable transport snapshot. */
+    private cloneDerivedBody;
+    private dispatchRequest;
     private buildHeaders;
-    private logRequestResponse;
+    /** Invoke logging as a detached observer. Logger behavior can never affect request control flow. */
+    private observeLog;
+    /** Isolate logger-owned values so a custom logger cannot mutate request or response control-flow state. */
+    private createLogSnapshot;
+    /** Remove credentials from logger-owned header snapshots without changing dispatch headers. */
+    private redactSensitiveLogHeaders;
+    private logFailedRequest;
+    private logRetry;
     private handleRequestError;
-    /**
-     * Formats a context object into a summary string for error messages. Shows up to MAX_CONTEXT_KEYS keys with truncated
-     * values.
-     */
+    /** Formats a context object into a summary string. Shows up to MAX_CONTEXT_KEYS keys with truncated values. */
     private formatContextSummary;
-    /**
-     * Safely converts a context value to a string representation. Handles null, undefined, strings, and objects (with
-     * circular reference protection).
-     */
+    /** Safely converts a context value to a string representation. */
     private stringifyContextValue;
-    /**
-     * Determines whether a request error is retryable. Retries on:
-     *
-     * - HTTP 404 (transient during Canton node restarts)
-     * - HTTP 5xx server errors
-     * - Network errors
-     * - Canton-specific transient errors: UNKNOWN_CONTRACT_SYNCHRONIZERS (400), SEQUENCER_BACKPRESSURE (409), HTTP 503
-     */
+    /** Return true for transport failures that the SDK has historically classified as transient. */
     private isRetryableError;
-    /** Sleep for the specified number of milliseconds */
-    private sleep;
-    /**
-     * Prepares request data for retry by updating commandId fields to avoid duplicate command rejection. If the data
-     * contains a commandId field, appends a retry suffix with timestamp to make it unique.
-     */
-    private prepareDataForRetry;
+    private classifyRequestError;
+    private toTerminalError;
+    private preservePriorAmbiguity;
+    private hasAmbiguousAttempt;
+    private normalizeCallbackError;
+    private redactEndpoint;
+    private redactAttemptIdentifier;
+    private isCanceledError;
+    private abortableSleep;
 }
 //# sourceMappingURL=HttpClient.d.ts.map

package/build/src/core/http/HttpClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../../../src/core/http/HttpClient.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,6EAA6E;AAC7E,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsC;IAC1E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,WAAW,CAA2D;IAG9E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAO;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,6BAA6B,CAAM;IAC3D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAK;IAE7C,YAAY,MAAM,CAAC,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAIvE;IAEM,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAEzD;IAEY,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,EAAE,WAAW,SAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CA2BnG;IAEY,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAE,aAAkB,EAAE,WAAW,SAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CA2BnH;IAEY,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,EAAE,WAAW,SAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CA0BtG;IAEY,gBAAgB,CAAC,CAAC,EAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,MAAM,GAAE,aAAkB,EAC1B,WAAW,SAAI,GACd,OAAO,CAAC,CAAC,CAAC,CA2BZ;YAEa,YAAY;YAuBZ,kBAAkB;IAMhC,OAAO,CAAC,kBAAkB;IA+C1B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAoCxB,qDAAqD;YACvC,KAAK;IAInB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAQ5B"}
+{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../../../src/core/http/HttpClient.ts"],"names":[],"mappings":"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"}