@florent-uzio/custody 2.1.0

package/dist/services/apis/api.service.js

@@ -0,0 +1,235 @@
+import axios, {} from "axios";
+import canonicalize from "canonicalize";
+import qs from "qs";
+import { v4 as uuidv4 } from "uuid";
+import { DEFAULT_TIMEOUT_MS } from "../../constants/index.js";
+import { isObject } from "../../helpers/index.js";
+import { CustodyError } from "../../models/custody-error.js";
+import { AuthService } from "../auth/auth.service.js";
+import { KeypairService } from "../keypairs/index.js";
+import {} from "./api.service.types.js";
+/**
+ * ApiService handles authenticated API requests and token management
+ */
+export class ApiService {
+    apiClient;
+    authFormData;
+    authService;
+    apiUrl;
+    challenge;
+    keypairService;
+    privateKey;
+    constructor(options) {
+        this.authService = options.authService;
+        this.apiUrl = options.apiUrl;
+        this.authFormData = options.authFormData;
+        this.privateKey = options.privateKey;
+        const timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;
+        // Create Axios instance for API requests
+        this.apiClient = axios.create({
+            baseURL: this.apiUrl,
+            timeout,
+            headers: {
+                "Content-Type": "application/json",
+            },
+        });
+        // Set params serializer to handle arrays the way Ripple Custody expects
+        this.apiClient.defaults.paramsSerializer = (params) => qs.stringify(params, { arrayFormat: "repeat" });
+        // Add request interceptor to inject JWT token into headers
+        this.apiClient.interceptors.request.use(async (config) => {
+            const token = await this.getValidToken(this.privateKey);
+            config.headers.Authorization = `Bearer ${token}`;
+            return config;
+        }, (error) => Promise.reject(error));
+        // Add response interceptor to handle 401 errors by refreshing the token and retrying once
+        this.apiClient.interceptors.response.use((response) => response, async (error) => {
+            const originalRequest = error.config;
+            // Only retry once and only on 401 responses
+            if (axios.isAxiosError(error) &&
+                error.response?.status === 401 &&
+                originalRequest &&
+                !originalRequest._retried) {
+                originalRequest._retried = true;
+                // Generate a fresh challenge and force-refresh the token
+                const token = await this.getValidToken(this.privateKey, true);
+                originalRequest.headers.Authorization = `Bearer ${token}`;
+                return this.apiClient(originalRequest);
+            }
+            return Promise.reject(error);
+        });
+        // Validate provided private key
+        const privateKeyAlgorithm = KeypairService.detectKeyType(this.privateKey);
+        if (privateKeyAlgorithm === "unknown") {
+            throw new Error("Unsupported private key algorithm. Please provide a valid private key.");
+        }
+        // Initialize keypair service for signing
+        this.keypairService = new KeypairService(privateKeyAlgorithm);
+        // Use provided challenge or generate a new one
+        this.challenge = this.authFormData.challenge ? this.authFormData.challenge : uuidv4();
+    }
+    /**
+     * Retrieves a valid JWT token, refreshing if needed.
+     * @param privateKey - The private key for signing the challenge.
+     * @param forceRefresh - Whether to force a token refresh.
+     * @returns {Promise<string>} The valid JWT token.
+     */
+    async getValidToken(privateKey, forceRefresh = false) {
+        if (forceRefresh || this.authService.isTokenExpired()) {
+            // Generate a fresh challenge for each token refresh to avoid stale challenge rejection
+            this.challenge = this.authFormData.challenge ? this.authFormData.challenge : uuidv4();
+            const authData = {
+                signature: this.keypairService.sign(privateKey, this.challenge),
+                challenge: this.challenge,
+                publicKey: this.authFormData.publicKey,
+            };
+            return await this.authService.getToken(authData);
+        }
+        return this.authService.getCurrentToken() || "";
+    }
+    /**
+     * Makes a GET request to the API.
+     * @param url - The endpoint URL.
+     * @returns {Promise<T>} The response data.
+     * @throws {CustodyError} If the request fails with a typed error response.
+     */
+    async get(url, params) {
+        try {
+            const response = await this.apiClient.get(url, { params });
+            return response.data;
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                // Check if the error response contains the expected error structure
+                const errorData = error.response?.data;
+                if (isObject(errorData)) {
+                    throw new CustodyError(errorData, error.response?.status, error);
+                }
+                // Fallback for unexpected error formats
+                throw new CustodyError({ reason: `GET API request failed: ${error.message}` }, error.response?.status, error);
+            }
+            else {
+                // Re-throw non-Axios errors as CustodyError
+                throw new CustodyError({ reason: error instanceof Error ? error.message : "Unknown error occurred" }, undefined, error instanceof Error ? error : undefined);
+            }
+        }
+    }
+    /**
+     * Makes a POST request to the API.
+     * @param url - The endpoint URL.
+     * @param body - The request payload.
+     * @param config - Axios config; set `sign: false` to skip canonicalization/signing.
+     * @returns {Promise<T>} The response data.
+     * @throws {CustodyError} If the request fails with a typed error response.
+     */
+    async post(url, body, config) {
+        const { sign, ...rest } = config ?? {};
+        // Preserve `undefined` when no config was passed so axios receives its own default
+        const axiosConfig = config ? rest : undefined;
+        try {
+            // Sign the request (default) unless the caller opted out
+            if (sign !== false && body && (!body.signature || body.signature === "")) {
+                // Canonicalize the request body
+                // @ts-expect-error canonicalize works fine but has complex types
+                const canonicalizedRequest = canonicalize(body.request);
+                if (!canonicalizedRequest) {
+                    throw new CustodyError({ reason: "Failed to canonicalize request body" });
+                }
+                // Sign the canonicalized request
+                const signature = this.keypairService.sign(this.privateKey, canonicalizedRequest);
+                body.signature = signature;
+            }
+            const response = await this.apiClient.post(url, body, axiosConfig);
+            return response.data;
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                // Check if the error response contains the expected error structure
+                const errorData = error.response?.data;
+                if (isObject(errorData)) {
+                    throw new CustodyError(errorData, error.response?.status, error);
+                }
+                // Fallback for unexpected error formats
+                throw new CustodyError({ reason: `POST API request failed: ${error.message}` }, error.response?.status, error);
+            }
+            else {
+                // Re-throw non-Axios errors as CustodyError
+                throw new CustodyError({ reason: error instanceof Error ? error.message : "Unknown error occurred" }, undefined, error instanceof Error ? error : undefined);
+            }
+        }
+    }
+    /**
+     * Makes a PUT request to the API.
+     * @param url - The endpoint URL.
+     * @param body - The request payload (sent as-is; no canonicalization or signing).
+     * @returns {Promise<T>} The response data.
+     * @throws {CustodyError} If the request fails with a typed error response.
+     */
+    async put(url, body, config) {
+        try {
+            const response = await this.apiClient.put(url, body, config);
+            return response.data;
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                const errorData = error.response?.data;
+                if (isObject(errorData)) {
+                    throw new CustodyError(errorData, error.response?.status, error);
+                }
+                throw new CustodyError({ reason: `PUT API request failed: ${error.message}` }, error.response?.status, error);
+            }
+            else {
+                throw new CustodyError({ reason: error instanceof Error ? error.message : "Unknown error occurred" }, undefined, error instanceof Error ? error : undefined);
+            }
+        }
+    }
+    /**
+     * Makes a PATCH request to the API.
+     * @param url - The endpoint URL.
+     * @param body - The request payload (sent as-is; no canonicalization or signing).
+     * @returns {Promise<T>} The response data.
+     * @throws {CustodyError} If the request fails with a typed error response.
+     */
+    async patch(url, body, config) {
+        try {
+            const response = await this.apiClient.patch(url, body, config);
+            return response.data;
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                const errorData = error.response?.data;
+                if (isObject(errorData)) {
+                    throw new CustodyError(errorData, error.response?.status, error);
+                }
+                throw new CustodyError({ reason: `PATCH API request failed: ${error.message}` }, error.response?.status, error);
+            }
+            else {
+                throw new CustodyError({ reason: error instanceof Error ? error.message : "Unknown error occurred" }, undefined, error instanceof Error ? error : undefined);
+            }
+        }
+    }
+    /**
+     * Makes a DELETE request to the API.
+     * @param url - The endpoint URL.
+     * @returns {Promise<T>} The response data.
+     * @throws {CustodyError} If the request fails with a typed error response.
+     */
+    async delete(url, config) {
+        try {
+            const response = await this.apiClient.delete(url, config);
+            return response.data;
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                const errorData = error.response?.data;
+                if (isObject(errorData)) {
+                    throw new CustodyError(errorData, error.response?.status, error);
+                }
+                throw new CustodyError({ reason: `DELETE API request failed: ${error.message}` }, error.response?.status, error);
+            }
+            else {
+                throw new CustodyError({ reason: error instanceof Error ? error.message : "Unknown error occurred" }, undefined, error instanceof Error ? error : undefined);
+            }
+        }
+    }
+}
+//# sourceMappingURL=api.service.js.map

package/dist/services/apis/api.service.js.map

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

package/dist/services/apis/api.service.types.d.ts

@@ -0,0 +1,16 @@
+import { type AuthFormData, AuthService } from "../auth/index.js";
+import { type KeypairAlgorithm } from "../keypairs/index.js";
+export type PartialAuthFormData = Pick<AuthFormData, "publicKey"> & Partial<Pick<AuthFormData, "challenge">>;
+export type ApiServiceOptions = {
+    authFormData: PartialAuthFormData;
+    authService: AuthService;
+    apiUrl: string;
+    keypairAlgorithm?: KeypairAlgorithm;
+    privateKey: string;
+    /**
+     * Request timeout in milliseconds.
+     * If not provided, defaults to 30 seconds.
+     */
+    timeout?: number;
+};
+//# sourceMappingURL=api.service.types.d.ts.map

package/dist/services/apis/api.service.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.service.types.d.ts","sourceRoot":"","sources":["../../../src/services/apis/api.service.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACjE,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GAC/D,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAA;AAE1C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,mBAAmB,CAAA;IACjC,WAAW,EAAE,WAAW,CAAA;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA"}

package/dist/services/apis/api.service.types.js

@@ -0,0 +1,3 @@
+import { AuthService } from "../auth/index.js";
+import {} from "../keypairs/index.js";
+//# sourceMappingURL=api.service.types.js.map

package/dist/services/apis/api.service.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.service.types.js","sourceRoot":"","sources":["../../../src/services/apis/api.service.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACjE,OAAO,EAAyB,MAAM,sBAAsB,CAAA"}

package/dist/services/apis/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./api.service.js";
+export * from "./api.service.types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/apis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/apis/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA"}

package/dist/services/apis/index.js

@@ -0,0 +1,3 @@
+export * from "./api.service.js";
+export * from "./api.service.types.js";
+//# sourceMappingURL=index.js.map

package/dist/services/apis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/apis/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA"}

package/dist/services/auth/auth.service.d.ts

@@ -0,0 +1,56 @@
+import { type AuthFormData } from "./auth.service.types.js";
+export type AuthServiceOptions = {
+    /** The full authentication token endpoint URL (e.g., https://auth.example.com/token) */
+    authUrl: string;
+    /**
+     * Request timeout in milliseconds.
+     * @default 30000 (30 seconds)
+     */
+    timeout?: number;
+};
+export declare class AuthService {
+    private authClient;
+    private accessToken;
+    private tokenExpiration;
+    private readonly DEFAULT_TOKEN_VALIDITY;
+    /**
+     * Stores the in-flight token refresh promise to prevent concurrent refresh requests.
+     * When multiple requests need a token refresh simultaneously, they will all await
+     * the same promise instead of triggering multiple auth requests.
+     */
+    private tokenRefreshPromise;
+    constructor(options: AuthServiceOptions);
+    /**
+     * Fetch a JWT token using the provided authentication data from Ripple Custody backend.
+     * @param authData - The authentication data (challenge, publicKey, signature)
+     * @returns {Promise<string>} The JWT token.
+     * @throws {CustodyError} If authentication fails.
+     */
+    private fetchToken;
+    /**
+     * Get a valid JWT token, refreshing if expired or missing.
+     *
+     * This method handles concurrent token refresh requests by ensuring only one
+     * refresh request is made at a time. If multiple callers need a token refresh
+     * simultaneously, they will all await the same promise.
+     */
+    getToken(authData: AuthFormData): Promise<string>;
+    /**
+     * Extract the `exp` (expiration) claim from a JWT token's payload.
+     * @returns The `exp` value in seconds (Unix timestamp), or null if extraction fails.
+     */
+    private extractExpFromJwt;
+    /**
+     * Check if the current token is expired or about to expire.
+     */
+    isTokenExpired(): boolean;
+    /**
+     * Get the current JWT token, if available.
+     */
+    getCurrentToken(): string | null;
+    /**
+     * Get the current JWT token expiration, if available.
+     */
+    getTokenExpiration(): number | null;
+}
+//# sourceMappingURL=auth.service.d.ts.map

package/dist/services/auth/auth.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.service.d.ts","sourceRoot":"","sources":["../../../src/services/auth/auth.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,YAAY,EAAqB,MAAM,yBAAyB,CAAA;AAE9E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wFAAwF;IACxF,OAAO,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAqB;IAE5D;;;;OAIG;IACH,OAAO,CAAC,mBAAmB,CAA+B;gBAE9C,OAAO,EAAE,kBAAkB;IAavC;;;;;OAKG;YACW,UAAU;IA+BxB;;;;;;OAMG;IACG,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBvD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,cAAc,IAAI,OAAO;IASzB;;OAEG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,kBAAkB,IAAI,MAAM,GAAG,IAAI;CAGpC"}

package/dist/services/auth/auth.service.js

@@ -0,0 +1,120 @@
+import axios, {} from "axios";
+import { DEFAULT_TIMEOUT_MS } from "../../constants/index.js";
+import { CustodyError } from "../../models/custody-error.js";
+import {} from "./auth.service.types.js";
+export class AuthService {
+    authClient;
+    accessToken = "";
+    tokenExpiration = null; // timestamp in milliseconds
+    DEFAULT_TOKEN_VALIDITY = 4 * 60 * 60 * 1000; // 4 hours in milliseconds
+    /**
+     * Stores the in-flight token refresh promise to prevent concurrent refresh requests.
+     * When multiple requests need a token refresh simultaneously, they will all await
+     * the same promise instead of triggering multiple auth requests.
+     */
+    tokenRefreshPromise = null;
+    constructor(options) {
+        const { authUrl, timeout = DEFAULT_TIMEOUT_MS } = options;
+        // Initialize Axios client for auth requests
+        this.authClient = axios.create({
+            baseURL: authUrl,
+            timeout,
+            headers: {
+                "Content-Type": "application/x-www-form-urlencoded",
+            },
+        });
+    }
+    /**
+     * Fetch a JWT token using the provided authentication data from Ripple Custody backend.
+     * @param authData - The authentication data (challenge, publicKey, signature)
+     * @returns {Promise<string>} The JWT token.
+     * @throws {CustodyError} If authentication fails.
+     */
+    async fetchToken(authData) {
+        // Prepare form data for token request
+        const formData = new URLSearchParams();
+        formData.append("grant_type", "password");
+        formData.append("client_id", "customer_api");
+        formData.append("signature", authData.signature);
+        formData.append("challenge", authData.challenge);
+        formData.append("public_key", authData.publicKey);
+        try {
+            // Send POST request to obtain token
+            const response = await this.authClient.post("", formData);
+            this.accessToken = response.data.access_token;
+            // Extract expiration from the JWT's exp claim, fall back to default validity
+            const exp = this.extractExpFromJwt(this.accessToken);
+            this.tokenExpiration = exp ? exp * 1000 : Date.now() + this.DEFAULT_TOKEN_VALIDITY;
+            return this.accessToken;
+        }
+        catch (error) {
+            if (axios.isAxiosError(error) && error.response) {
+                const errorData = error.response.data;
+                throw new CustodyError(errorData, error.response.status, error);
+            }
+            throw new CustodyError({ reason: "Authentication request failed" }, undefined, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Get a valid JWT token, refreshing if expired or missing.
+     *
+     * This method handles concurrent token refresh requests by ensuring only one
+     * refresh request is made at a time. If multiple callers need a token refresh
+     * simultaneously, they will all await the same promise.
+     */
+    async getToken(authData) {
+        // Return existing valid token
+        if (this.accessToken && !this.isTokenExpired()) {
+            return this.accessToken;
+        }
+        // If a refresh is already in progress, wait for it
+        if (this.tokenRefreshPromise) {
+            return this.tokenRefreshPromise;
+        }
+        // Start a new token refresh and store the promise
+        this.tokenRefreshPromise = this.fetchToken(authData).finally(() => {
+            // Clear the promise once completed (success or failure)
+            this.tokenRefreshPromise = null;
+        });
+        return this.tokenRefreshPromise;
+    }
+    /**
+     * Extract the `exp` (expiration) claim from a JWT token's payload.
+     * @returns The `exp` value in seconds (Unix timestamp), or null if extraction fails.
+     */
+    extractExpFromJwt(token) {
+        try {
+            const payload = token.split(".")[1];
+            if (!payload)
+                return null;
+            const decoded = JSON.parse(Buffer.from(payload, "base64url").toString());
+            return typeof decoded.exp === "number" ? decoded.exp : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Check if the current token is expired or about to expire.
+     */
+    isTokenExpired() {
+        if (!this.tokenExpiration)
+            return true;
+        // Consider token expired 5 minutes before actual expiration for safety
+        const bufferTime = 5 * 60 * 1000;
+        return Date.now() > this.tokenExpiration - bufferTime;
+    }
+    /**
+     * Get the current JWT token, if available.
+     */
+    getCurrentToken() {
+        return this.accessToken;
+    }
+    /**
+     * Get the current JWT token expiration, if available.
+     */
+    getTokenExpiration() {
+        return this.tokenExpiration;
+    }
+}
+//# sourceMappingURL=auth.service.js.map

package/dist/services/auth/auth.service.js.map

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

package/dist/services/auth/auth.service.types.d.ts

@@ -0,0 +1,9 @@
+export type AuthFormData = {
+    challenge: string;
+    publicKey: string;
+    signature: string;
+};
+export interface AuthResponse {
+    access_token: string;
+}
+//# sourceMappingURL=auth.service.types.d.ts.map

package/dist/services/auth/auth.service.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.service.types.d.ts","sourceRoot":"","sources":["../../../src/services/auth/auth.service.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAA;CACrB"}

package/dist/services/auth/auth.service.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auth.service.types.js.map

package/dist/services/auth/auth.service.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.service.types.js","sourceRoot":"","sources":["../../../src/services/auth/auth.service.types.ts"],"names":[],"mappings":""}

package/dist/services/auth/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./auth.service.js";
+export * from "./auth.service.types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/auth/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA"}

package/dist/services/auth/index.js

@@ -0,0 +1,3 @@
+export * from "./auth.service.js";
+export * from "./auth.service.types.js";
+//# sourceMappingURL=index.js.map

package/dist/services/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/auth/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA"}

package/dist/services/channels/channels.types.d.ts

@@ -0,0 +1,37 @@
+import type { components, operations } from "../../models/custody-types.js";
+import type { Prettify } from "../../type-utils/index.js";
+import type { Core_HarmonizeEvent, Core_HarmonizeEventPayload } from "../events/index.js";
+export type GetChannelsPathParams = operations["getAllChannels"]["parameters"]["path"];
+export type GetChannelPathParams = operations["getChannel"]["parameters"]["path"];
+export type CreateChannelPathParams = operations["createChannel"]["parameters"]["path"];
+export type UpdateChannelPathParams = operations["updateChannel"]["parameters"]["path"];
+export type DeleteChannelPathParams = operations["deleteChannel"]["parameters"]["path"];
+export type TestChannelPathParams = operations["testChannel"]["parameters"]["path"];
+export type GetChannelEventsPathParams = operations["getAllChannelEvents"]["parameters"]["path"];
+export type GetChannelEventPathParams = operations["getEvent"]["parameters"]["path"];
+export type GetAllChannelsEventsPathParams = operations["getAllEvents"]["parameters"]["path"];
+export type EDS_Channel = components["schemas"]["EDS_Channel"];
+export type EDS_Event = components["schemas"]["EDS_Event"];
+export type EDS_ChannelUpdate = components["schemas"]["EDS_ChannelUpdate"];
+export type EDS_WebhookChannelCreate = Omit<components["schemas"]["EDS_ChannelCreate"], "type" | "supportedEventTypes"> & {
+    supportedEventTypes: (Core_HarmonizeEventPayload["type"] | (string & {}))[];
+    type: "WEBHOOK";
+    url: string;
+};
+/**
+ * Request body for `channels.create`. Modeled as a discriminated union so new
+ * channel types (e.g. non-WEBHOOK) can be added without a breaking change.
+ */
+export type EDS_ChannelCreate = Prettify<EDS_WebhookChannelCreate>;
+/**
+ * Body shape delivered to a webhook channel's URL. The outer envelope adds a
+ * W3C `traceId` for distributed tracing; `msg` is a fully-parsed
+ * `Core_HarmonizeEvent` (its `payload` is an object, not a JSON string — this
+ * is distinct from `EDS_Event`, which the REST API returns with `payload` as
+ * a string and which is what `parseEventPayload` operates on).
+ */
+export type EDS_WebhookEvent = {
+    traceId: string;
+    msg: Core_HarmonizeEvent;
+};
+//# sourceMappingURL=channels.types.d.ts.map

package/dist/services/channels/channels.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.types.d.ts","sourceRoot":"","sources":["../../../src/services/channels/channels.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA;AAGzF,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACtF,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACjF,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACvF,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACvF,MAAM,MAAM,uBAAuB,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACvF,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACnF,MAAM,MAAM,0BAA0B,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAChG,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACpF,MAAM,MAAM,8BAA8B,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAG7F,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAA;AAC9D,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,CAAA;AAC1D,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAA;AAM1E,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,EAC1C,MAAM,GAAG,qBAAqB,CAC/B,GAAG;IACF,mBAAmB,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,EAAE,CAAA;IAC3E,IAAI,EAAE,SAAS,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,wBAAwB,CAAC,CAAA;AAElE;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,mBAAmB,CAAA;CACzB,CAAA"}

package/dist/services/channels/channels.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=channels.types.js.map

package/dist/services/channels/channels.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.types.js","sourceRoot":"","sources":["../../../src/services/channels/channels.types.ts"],"names":[],"mappings":""}

package/dist/services/channels/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./channels.types.js";
+export { parseEventPayload } from "./parse-event-payload.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/channels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/channels/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/services/channels/index.js

@@ -0,0 +1,3 @@
+export * from "./channels.types.js";
+export { parseEventPayload } from "./parse-event-payload.js";
+//# sourceMappingURL=index.js.map

package/dist/services/channels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/channels/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/services/channels/parse-event-payload.d.ts

@@ -0,0 +1,12 @@
+import type { Core_HarmonizeEvent } from "../events/events.types.js";
+import type { EDS_Event } from "./channels.types.js";
+/**
+ * Parses the JSON-encoded `payload` on an `EDS_Event` into a fully typed
+ * `Core_HarmonizeEvent`. TypeScript narrows the inner `payload.type`
+ * discriminator so callers can switch on the event variant.
+ *
+ * Throws `CustodyError` when `payload` is missing, is not valid JSON, or
+ * does not contain a `Core_HarmonizeEvent` with a string `payload.type`.
+ */
+export declare function parseEventPayload(event: EDS_Event): Core_HarmonizeEvent;
+//# sourceMappingURL=parse-event-payload.d.ts.map

package/dist/services/channels/parse-event-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-event-payload.d.ts","sourceRoot":"","sources":["../../../src/services/channels/parse-event-payload.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,mBAAmB,CAuBvE"}