@florent-uzio/custody 2.4.0 → 2.6.0

package/dist/transport/typed-transport.js

@@ -1,3 +1,4 @@
+import { VersionGuard } from "../versioning/version-guard.js";
 import { splitParams } from "./split-params.js";
 /**
  * A typed transport layer that wraps ApiService, handling URL template
@@ -7,14 +8,17 @@ import { splitParams } from "./split-params.js";
  */
 export class TypedTransport {
     api;
-    constructor(api) {
+    guard;
+    constructor(api, guard = new VersionGuard(undefined)) {
         this.api = api;
+        this.guard = guard;
     }
     /**
      * Makes a typed GET request.
      * Splits flat params into path and query params based on the URL template.
      */
     async get(url, pathParams, query, _config) {
+        await this.guard.checkEndpoint("GET", url);
         let resolvedUrl = url;
         if (pathParams && Object.keys(pathParams).length > 0) {
             const result = splitParams(url, pathParams);
@@ -31,30 +35,49 @@ export class TypedTransport {
      * Resolves path params from the URL template before posting.
      */
     async post(url, body, pathParams, config) {
+        await this.guard.checkEndpoint("POST", url);
         let resolvedUrl = url;
+        let mergedConfig = config;
         if (pathParams && Object.keys(pathParams).length > 0) {
             const result = splitParams(url, pathParams);
             resolvedUrl = result.url;
+            // Non-path keys become query params, mirroring get()/delete().
+            if (result.query) {
+                mergedConfig = {
+                    ...(mergedConfig ?? {}),
+                    params: { ...(mergedConfig?.params ?? {}), ...result.query },
+                };
+            }
         }
-        return this.api.post(resolvedUrl, body, config);
+        return this.api.post(resolvedUrl, body, mergedConfig);
     }
     /**
      * Makes a typed PUT request.
      * Resolves path params from the URL template before sending.
      */
     async put(url, body, pathParams, config) {
+        await this.guard.checkEndpoint("PUT", url);
         let resolvedUrl = url;
+        let mergedConfig = config;
         if (pathParams && Object.keys(pathParams).length > 0) {
             const result = splitParams(url, pathParams);
             resolvedUrl = result.url;
+            // Non-path keys become query params, mirroring get()/delete().
+            if (result.query) {
+                mergedConfig = {
+                    ...(mergedConfig ?? {}),
+                    params: { ...(mergedConfig?.params ?? {}), ...result.query },
+                };
+            }
         }
-        return this.api.put(resolvedUrl, body, config);
+        return this.api.put(resolvedUrl, body, mergedConfig);
     }
     /**
      * Makes a typed PATCH request.
      * Resolves path params from the URL template before sending.
      */
     async patch(url, body, pathParams, config) {
+        await this.guard.checkEndpoint("PATCH", url);
         let resolvedUrl = url;
         if (pathParams && Object.keys(pathParams).length > 0) {
             const result = splitParams(url, pathParams);
@@ -64,15 +87,22 @@ export class TypedTransport {
     }
     /**
      * Makes a typed DELETE request.
-     * Resolves path params from the URL template before sending.
+     * Splits flat params into path and query params based on the URL template.
      */
-    async delete(url, pathParams, config) {
+    async delete(url, pathParams, query, config) {
+        await this.guard.checkEndpoint("DELETE", url);
         let resolvedUrl = url;
         if (pathParams && Object.keys(pathParams).length > 0) {
             const result = splitParams(url, pathParams);
             resolvedUrl = result.url;
+            if (result.query) {
+                query = { ...(query ?? {}), ...result.query };
+            }
         }
-        return this.api.delete(resolvedUrl, config);
+        return this.api.delete(resolvedUrl, {
+            ...config,
+            params: query,
+        });
     }
 }
 //# sourceMappingURL=typed-transport.js.map

package/dist/transport/typed-transport.js.map

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

package/dist/versioning/detect.d.ts

@@ -0,0 +1,25 @@
+import type { ResolvedCapabilities } from "./version-guard.js";
+/**
+ * Fetches the target instance's live OpenAPI document. Production is backed by
+ * an HTTP GET; tests supply an in-memory implementation.
+ */
+export interface SpecSource {
+    /** Fetch and return the parsed live OpenAPI document. */
+    fetchSpec(): Promise<unknown>;
+}
+/**
+ * Builds the OpenAPI document URL for an instance from its API base URL.
+ * The endpoint is unauthenticated (the same one the `rc-version` skill reads).
+ */
+export declare function buildOpenApiUrl(apiUrl: string): string;
+/** Default HTTP-backed spec source (plain, unauthenticated GET). */
+export declare function createHttpSpecSource(openApiUrl: string, timeout?: number): SpecSource;
+/**
+ * Derives a runtime capability set from a live OpenAPI document: every
+ * `METHOD /path` it serves and every component schema name it defines.
+ * Accurate for any version, including ones the SDK has never bundled.
+ */
+export declare function extractCapabilitiesFromSpec(spec: unknown): ResolvedCapabilities;
+/** Fetches the live spec via `source` and derives its capability set. */
+export declare function detectCapabilities(source: SpecSource): Promise<ResolvedCapabilities>;
+//# sourceMappingURL=detect.d.ts.map

package/dist/versioning/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/versioning/detect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAE9D;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9B;AAKD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAOrF;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,CAoB/E;AAED,yEAAyE;AACzE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAG1F"}

package/dist/versioning/detect.js

@@ -0,0 +1,45 @@
+import axios from "axios";
+/** OpenAPI path-item keys that denote an operation. */
+const HTTP_METHODS = ["get", "put", "post", "delete", "options", "head", "patch", "trace"];
+/**
+ * Builds the OpenAPI document URL for an instance from its API base URL.
+ * The endpoint is unauthenticated (the same one the `rc-version` skill reads).
+ */
+export function buildOpenApiUrl(apiUrl) {
+    return `${apiUrl.replace(/\/+$/, "")}/api/OpenAPI?scope=&layout=`;
+}
+/** Default HTTP-backed spec source (plain, unauthenticated GET). */
+export function createHttpSpecSource(openApiUrl, timeout) {
+    return {
+        async fetchSpec() {
+            const response = await axios.get(openApiUrl, { timeout });
+            return response.data;
+        },
+    };
+}
+/**
+ * Derives a runtime capability set from a live OpenAPI document: every
+ * `METHOD /path` it serves and every component schema name it defines.
+ * Accurate for any version, including ones the SDK has never bundled.
+ */
+export function extractCapabilitiesFromSpec(spec) {
+    const doc = (spec ?? {});
+    const appVersion = doc.info?.["x-app-version"] ?? "unknown";
+    const endpoints = new Set();
+    for (const [path, item] of Object.entries(doc.paths ?? {})) {
+        if (!item || typeof item !== "object")
+            continue;
+        for (const method of HTTP_METHODS) {
+            if (item[method])
+                endpoints.add(`${method.toUpperCase()} ${path}`);
+        }
+    }
+    const schemas = new Set(Object.keys(doc.components?.schemas ?? {}));
+    return { appVersion, endpoints, schemas };
+}
+/** Fetches the live spec via `source` and derives its capability set. */
+export async function detectCapabilities(source) {
+    const spec = await source.fetchSpec();
+    return extractCapabilitiesFromSpec(spec);
+}
+//# sourceMappingURL=detect.js.map

package/dist/versioning/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/versioning/detect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAYzB,uDAAuD;AACvD,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AAE1F;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,6BAA6B,CAAA;AACnE,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,oBAAoB,CAAC,UAAkB,EAAE,OAAgB;IACvE,OAAO;QACL,KAAK,CAAC,SAAS;YACb,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;YACzD,OAAO,QAAQ,CAAC,IAAI,CAAA;QACtB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAa;IACvD,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAItB,CAAA;IAED,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,SAAS,CAAA;IAE3D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAA;IACnC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAQ;QAC/C,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,MAAM,CAAC;gBAAE,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,CAAA;QACpE,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,CAAA;IAE3E,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;AAC3C,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAkB;IACzD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAA;IACrC,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAA;AAC1C,CAAC"}

package/dist/versioning/version-guard.d.ts

@@ -0,0 +1,101 @@
+import { CustodyError } from "../models/index.js";
+/** Whether a capability is a whole endpoint or a feature carried inside one. */
+export type CapabilityKind = "endpoint" | "feature";
+/**
+ * The capability set the guard checks against: the endpoints and component
+ * schemas a single resolved backend version exposes.
+ */
+export type ResolvedCapabilities = {
+    /** The resolved app version (`x-app-version`), used for messaging. */
+    appVersion: string;
+    /** Endpoint capabilities, each formatted `METHOD /path-template`. */
+    endpoints: ReadonlySet<string>;
+    /** Feature capabilities: the names of component schemas the version defines. */
+    schemas: ReadonlySet<string>;
+};
+/**
+ * Thrown when a call needs a capability the resolved backend version does not
+ * support. Extends {@link CustodyError} so existing `catch (CustodyError)`
+ * handlers still catch it.
+ */
+export declare class UnsupportedInVersionError extends CustodyError {
+    readonly capability: string;
+    readonly kind: CapabilityKind;
+    readonly appVersion: string;
+    readonly sdkMethod: string;
+    constructor(args: {
+        capability: string;
+        kind: CapabilityKind;
+        appVersion: string;
+        sdkMethod: string;
+    });
+}
+/**
+ * Maps an XRPL operation `type` (the discriminator of `Core_XrplOperation`) to
+ * its component-schema name. The generated union members are named
+ * `Core_XrplOperation_<type>` exactly, so no lookup table is needed.
+ */
+export declare function xrplOperationSchema(operationType: string): string;
+/**
+ * Builds the capability set for an explicitly-requested app version from the
+ * bundled capability data. Throws when the version is not bundled.
+ */
+export declare function resolveExplicitCapabilities(apiVersion: string): ResolvedCapabilities;
+/**
+ * Runtime guard that blocks calls the resolved backend version cannot serve.
+ *
+ * When constructed with no resolved capabilities it is a **pass-through**: every
+ * check is a no-op (fail-open). The backend remains the ultimate authority.
+ */
+export declare class VersionGuard {
+    private resolved;
+    private settled;
+    private pending?;
+    private failedOpen;
+    private warned;
+    private readonly resolver?;
+    private readonly onFailOpen?;
+    /**
+     * Construct a guard with capabilities already resolved (or `undefined` for a
+     * pass-through guard). Pass a `resolver` for lazy resolution, or use
+     * {@link VersionGuard.deferred}. `onFailOpen` runs once the first time the
+     * guard passes a call through because no version could be resolved.
+     */
+    constructor(resolved: ResolvedCapabilities | undefined, resolver?: () => Promise<ResolvedCapabilities | undefined>, onFailOpen?: () => void);
+    /**
+     * Construct a guard whose capabilities are resolved lazily on first use (e.g.
+     * by fetching the live instance spec). The resolver runs at most once per
+     * successful resolution; concurrent triggers share a single invocation.
+     */
+    static deferred(resolver: () => Promise<ResolvedCapabilities | undefined>, onFailOpen?: () => void): VersionGuard;
+    /** Whether the guard has a resolved version and is actively gating. */
+    get isActive(): boolean;
+    /**
+     * Resolve the capability set if not already resolved. Idempotent and
+     * concurrency-safe: parallel calls share one in-flight resolution. On failure
+     * the error propagates and a later call retries.
+     */
+    ensureResolved(): Promise<void>;
+    /** Resolves (detecting if needed) then asserts the endpoint capability. */
+    checkEndpoint(httpMethod: string, pathTemplate: string, sdkMethod?: string): Promise<void>;
+    /** Resolves (detecting if needed) then asserts the feature capability. */
+    checkFeature(schemaName: string, sdkMethod: string): Promise<void>;
+    /**
+     * Whether gating is active for the call path. Resolves the version on first
+     * use; if no version can be resolved — detection failed, or the guard is a
+     * pass-through — it **fails open**: returns `false` (call passes through) and
+     * fires `onFailOpen` once. The unresolved state is cached, so detection is
+     * not re-attempted on every call. `ensureResolved`/`ready()` keep surfacing
+     * detection errors independently.
+     */
+    private gatingActive;
+    private enterFailOpen;
+    /**
+     * Asserts the resolved version serves `METHOD /pathTemplate`.
+     * @param sdkMethod - Label for the error (defaults to the HTTP descriptor).
+     */
+    assertEndpoint(httpMethod: string, pathTemplate: string, sdkMethod?: string): void;
+    /** Asserts the resolved version defines the component schema `schemaName`. */
+    assertFeature(schemaName: string, sdkMethod: string): void;
+}
+//# sourceMappingURL=version-guard.d.ts.map

package/dist/versioning/version-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-guard.d.ts","sourceRoot":"","sources":["../../src/versioning/version-guard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,gFAAgF;AAChF,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,CAAA;AAEnD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAA;IAClB,qEAAqE;IACrE,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC9B,gFAAgF;IAChF,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAC7B,CAAA;AAED;;;;GAIG;AACH,qBAAa,yBAA0B,SAAQ,YAAY;IACzD,SAAgB,UAAU,EAAE,MAAM,CAAA;IAClC,SAAgB,IAAI,EAAE,cAAc,CAAA;IACpC,SAAgB,UAAU,EAAE,MAAM,CAAA;IAClC,SAAgB,SAAS,EAAE,MAAM,CAAA;gBAErB,IAAI,EAAE;QAChB,UAAU,EAAE,MAAM,CAAA;QAClB,IAAI,EAAE,cAAc,CAAA;QACpB,UAAU,EAAE,MAAM,CAAA;QAClB,SAAS,EAAE,MAAM,CAAA;KAClB;CAYF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAapF;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAiD;IAC3E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAY;IAExC;;;;;OAKG;gBAED,QAAQ,EAAE,oBAAoB,GAAG,SAAS,EAC1C,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,EAC1D,UAAU,CAAC,EAAE,MAAM,IAAI;IAQzB;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CACb,QAAQ,EAAE,MAAM,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,EACzD,UAAU,CAAC,EAAE,MAAM,IAAI,GACtB,YAAY;IAIf,uEAAuE;IACvE,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBrC,2EAA2E;IACrE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhG,0EAA0E;IACpE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxE;;;;;;;OAOG;YACW,YAAY;IAW1B,OAAO,CAAC,aAAa;IASrB;;;OAGG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAalF,8EAA8E;IAC9E,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;CAW3D"}

package/dist/versioning/version-guard.js

@@ -0,0 +1,181 @@
+import { CAPABILITIES } from "../models/capabilities.generated.js";
+import { CustodyError } from "../models/index.js";
+/**
+ * Thrown when a call needs a capability the resolved backend version does not
+ * support. Extends {@link CustodyError} so existing `catch (CustodyError)`
+ * handlers still catch it.
+ */
+export class UnsupportedInVersionError extends CustodyError {
+    capability;
+    kind;
+    appVersion;
+    sdkMethod;
+    constructor(args) {
+        super({
+            reason: `${args.sdkMethod} requires ${args.kind} "${args.capability}", which is not ` +
+                `available on the resolved backend version ${args.appVersion}.`,
+        });
+        this.name = "UnsupportedInVersionError";
+        this.capability = args.capability;
+        this.kind = args.kind;
+        this.appVersion = args.appVersion;
+        this.sdkMethod = args.sdkMethod;
+    }
+}
+/**
+ * Maps an XRPL operation `type` (the discriminator of `Core_XrplOperation`) to
+ * its component-schema name. The generated union members are named
+ * `Core_XrplOperation_<type>` exactly, so no lookup table is needed.
+ */
+export function xrplOperationSchema(operationType) {
+    return `Core_XrplOperation_${operationType}`;
+}
+/**
+ * Builds the capability set for an explicitly-requested app version from the
+ * bundled capability data. Throws when the version is not bundled.
+ */
+export function resolveExplicitCapabilities(apiVersion) {
+    const entry = CAPABILITIES[apiVersion];
+    if (!entry) {
+        const known = Object.keys(CAPABILITIES).join(", ");
+        throw new CustodyError({
+            reason: `Unknown apiVersion "${apiVersion}". Known versions: ${known}.`,
+        });
+    }
+    return {
+        appVersion: apiVersion,
+        endpoints: new Set(entry.endpoints),
+        schemas: new Set(entry.schemas),
+    };
+}
+/**
+ * Runtime guard that blocks calls the resolved backend version cannot serve.
+ *
+ * When constructed with no resolved capabilities it is a **pass-through**: every
+ * check is a no-op (fail-open). The backend remains the ultimate authority.
+ */
+export class VersionGuard {
+    resolved;
+    settled;
+    pending;
+    failedOpen = false;
+    warned = false;
+    resolver;
+    onFailOpen;
+    /**
+     * Construct a guard with capabilities already resolved (or `undefined` for a
+     * pass-through guard). Pass a `resolver` for lazy resolution, or use
+     * {@link VersionGuard.deferred}. `onFailOpen` runs once the first time the
+     * guard passes a call through because no version could be resolved.
+     */
+    constructor(resolved, resolver, onFailOpen) {
+        this.resolved = resolved;
+        this.resolver = resolver;
+        this.onFailOpen = onFailOpen;
+        this.settled = resolver === undefined;
+    }
+    /**
+     * Construct a guard whose capabilities are resolved lazily on first use (e.g.
+     * by fetching the live instance spec). The resolver runs at most once per
+     * successful resolution; concurrent triggers share a single invocation.
+     */
+    static deferred(resolver, onFailOpen) {
+        return new VersionGuard(undefined, resolver, onFailOpen);
+    }
+    /** Whether the guard has a resolved version and is actively gating. */
+    get isActive() {
+        return this.resolved !== undefined;
+    }
+    /**
+     * Resolve the capability set if not already resolved. Idempotent and
+     * concurrency-safe: parallel calls share one in-flight resolution. On failure
+     * the error propagates and a later call retries.
+     */
+    async ensureResolved() {
+        if (this.settled)
+            return;
+        if (!this.pending) {
+            const resolver = this.resolver;
+            this.pending = resolver().then((caps) => {
+                this.resolved = caps;
+                this.settled = true;
+            }, (error) => {
+                this.pending = undefined;
+                throw error;
+            });
+        }
+        return this.pending;
+    }
+    /** Resolves (detecting if needed) then asserts the endpoint capability. */
+    async checkEndpoint(httpMethod, pathTemplate, sdkMethod) {
+        if (await this.gatingActive()) {
+            this.assertEndpoint(httpMethod, pathTemplate, sdkMethod);
+        }
+    }
+    /** Resolves (detecting if needed) then asserts the feature capability. */
+    async checkFeature(schemaName, sdkMethod) {
+        if (await this.gatingActive()) {
+            this.assertFeature(schemaName, sdkMethod);
+        }
+    }
+    /**
+     * Whether gating is active for the call path. Resolves the version on first
+     * use; if no version can be resolved — detection failed, or the guard is a
+     * pass-through — it **fails open**: returns `false` (call passes through) and
+     * fires `onFailOpen` once. The unresolved state is cached, so detection is
+     * not re-attempted on every call. `ensureResolved`/`ready()` keep surfacing
+     * detection errors independently.
+     */
+    async gatingActive() {
+        if (this.failedOpen)
+            return false;
+        try {
+            await this.ensureResolved();
+        }
+        catch {
+            return this.enterFailOpen();
+        }
+        if (!this.resolved)
+            return this.enterFailOpen();
+        return true;
+    }
+    enterFailOpen() {
+        this.failedOpen = true;
+        if (!this.warned) {
+            this.warned = true;
+            this.onFailOpen?.();
+        }
+        return false;
+    }
+    /**
+     * Asserts the resolved version serves `METHOD /pathTemplate`.
+     * @param sdkMethod - Label for the error (defaults to the HTTP descriptor).
+     */
+    assertEndpoint(httpMethod, pathTemplate, sdkMethod) {
+        if (!this.resolved)
+            return;
+        const capability = `${httpMethod.toUpperCase()} ${pathTemplate}`;
+        if (!this.resolved.endpoints.has(capability)) {
+            throw new UnsupportedInVersionError({
+                capability,
+                kind: "endpoint",
+                appVersion: this.resolved.appVersion,
+                sdkMethod: sdkMethod ?? capability,
+            });
+        }
+    }
+    /** Asserts the resolved version defines the component schema `schemaName`. */
+    assertFeature(schemaName, sdkMethod) {
+        if (!this.resolved)
+            return;
+        if (!this.resolved.schemas.has(schemaName)) {
+            throw new UnsupportedInVersionError({
+                capability: schemaName,
+                kind: "feature",
+                appVersion: this.resolved.appVersion,
+                sdkMethod,
+            });
+        }
+    }
+}
+//# sourceMappingURL=version-guard.js.map

package/dist/versioning/version-guard.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@florent-uzio/custody",
-  "version": "2.4.0",
+  "version": "2.6.0",
   "description": "An SDK to interact with the Ripple Custody API",
   "keywords": [
     "Ripple Custody",
@@ -36,8 +36,9 @@
     "check-format": "prettier --check .",
     "ci": "npm run build && npm run check-format && npm run test",
     "dev": "vitest",
+    "fetch:openapi-spec": "node ./scripts/fetch-openapi-release.mjs",
     "format": "prettier --write .",
-    "generate:custody-types": "npx openapi-typescript ./openapi/Ripple-Custody-v1-OpenAPI.json -o ./src/models/custody-types.ts && prettier --write ./src/models/custody-types.ts",
+    "generate:custody-types": "node ./scripts/generate-custody-types/generate.mjs && prettier --write ./src/models/custody-types.ts ./src/models/capabilities.generated.ts",
     "local-release": "changeset version && changeset publish",
     "prepare": "npm run build",
     "release": "changeset publish",
@@ -49,25 +50,24 @@
     "test:coverage:ui": "vitest --coverage --ui"
   },
   "dependencies": {
-    "axios": "^1.8.4",
-    "canonicalize": "^2.1.0",
-    "dayjs": "^1.11.19",
-    "qs": "^6.14.1",
-    "uuid": "^11.1.0",
-    "xrpl": "^4.6.0"
+    "axios": "^1.18.1",
+    "canonicalize": "^3.0.0",
+    "dayjs": "^1.11.21",
+    "qs": "^6.15.3",
+    "uuid": "^14.0.1",
+    "xrpl": "^5.0.0"
   },
   "devDependencies": {
-    "@arethetypeswrong/cli": "^0.18.2",
-    "@changesets/cli": "^2.29.6",
-    "@types/qs": "^6.14.0",
-    "@vitest/coverage-v8": "^3.1.4",
-    "@vitest/ui": "^3.1.4",
-    "dotenv": "^16.4.7",
-    "openapi-typescript": "^7.9.1",
-    "prettier": "^3.5.3",
-    "prettier-plugin-organize-imports": "^4.1.0",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.8.2",
-    "vitest": "^3.1.4"
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@changesets/cli": "^2.31.0",
+    "@types/qs": "^6.15.1",
+    "@vitest/coverage-v8": "^4.1.10",
+    "@vitest/ui": "^4.1.10",
+    "dotenv": "^17.4.2",
+    "openapi-typescript": "^7.13.0",
+    "prettier": "^3.9.5",
+    "prettier-plugin-organize-imports": "^4.3.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10"
   }
 }