@frak-labs/frame-connector 0.1.0-beta.8d103039 → 0.1.0-beta.d9302e66

package/dist/index.js

@@ -1 +0,0 @@
-import{CborDecoder as e,CborEncoder as r}from"@jsonjoy.com/json-pack/lib/cbor/index.js";import{sha256 as t}from"viem";let o={parseError:-32700,invalidRequest:-32600,methodNotFound:-32601,invalidParams:-32602,internalError:-32603,serverError:-32e3,clientNotConnected:-32001,configError:-32002,corruptedResponse:-32003,clientAborted:-32004,walletNotConnected:-32005,serverErrorForInteractionDelegation:-32006,userRejected:-32007};class n extends Error{code;data;constructor(e,r,t){super(r),this.code=e,this.data=t}toJSON(){return{code:this.code,message:this.message,data:this.data}}}class i extends n{constructor(e,r){super(o.methodNotFound,e,{method:r})}}class a extends n{constructor(e){super(o.internalError,e)}}class s extends n{constructor(){super(o.clientNotConnected,"Client not found")}}class c{_promise;_resolve;_reject;constructor(){this._promise=new Promise((e,r)=>{this._resolve=e,this._reject=r})}get promise(){return this._promise}resolve=e=>{this._resolve?.(e)};reject=e=>{this._reject?.(e)}}function l(e){let{emittingTransport:r,listeningTransport:t,targetOrigin:o,middleware:i=[],lifecycleHandlers:a}=e,s=new Map;async function l(e){try{"clientLifecycle"in e&&a?.clientLifecycle?await a.clientLifecycle(e,{origin:o,source:null}):"iframeLifecycle"in e&&a?.iframeLifecycle&&await a.iframeLifecycle(e,{origin:o,source:null})}catch(e){console.error("[RPC Client] Lifecycle handler error:",e)}}async function d(e){let r={origin:o,source:null};for(let t of i)t.onRequest&&await t.onRequest(e,r);return e}async function u(e,r){let t={origin:o,source:null},n=r;for(let r of i)r.onResponse&&(n=await r.onResponse(e,n,t));return n}async function f(e){var r,t;let n;try{let r=new URL(e.origin).origin.toLowerCase(),t=new URL(o).origin.toLowerCase();if(r!==t)return void console.log("Not expected origin",r,t)}catch(e){console.error("[RPC Client] Invalid origin",e);return}if("object"==typeof(r=e.data)&&r&&("clientLifecycle"in r||"iframeLifecycle"in r))return void await l(e.data);if(!("object"==typeof(t=e.data)&&t&&"id"in t&&"topic"in t&&"data"in t))return;try{let r=e.data.data,t=r instanceof Uint8Array||ArrayBuffer.isView(r);n=await u(e.data,t?{result:r}:r)}catch(e){console.error("[RPC Client] Middleware error on response:",e);return}let i=s.get(e.data.id);i&&i(n)}async function p(e){let t=e;try{t=await d(e)}catch(e){throw console.error("[RPC Client] Middleware error on request:",e),e}r.postMessage(t,o)}function m(){return`${Date.now()}-${Math.random().toString(36).substring(2,9)}`}return t.addEventListener("message",f),{request:function(e){let r=m(),t=new c;return s.set(r,e=>{e.error?t.reject(new n(e.error.code,e.error.message,e.error.data)):t.resolve(e.result),s.delete(r)}),p({id:r,topic:e.method,data:{method:e.method,params:e.params}}).catch(e=>{s.delete(r),t.reject(e)}),t.promise},listen:function(e,r){let t=m();return s.set(t,e=>{e.error?(console.error("[RPC Client] Listener error:",e.error),s.delete(t)):r(e.result)}),p({id:t,topic:e.method,data:{method:e.method,params:e.params}}).catch(e=>{console.error("[RPC Client] Failed to send listener request:",e),s.delete(t)}),()=>{s.delete(t)}},sendLifecycle:function(e){r.postMessage(e,o)},cleanup:function(){t.removeEventListener("message",f),s.clear()}}}function d(e){let{transport:r,allowedOrigins:t,middleware:i=[],lifecycleHandlers:a}=e,s=Array.isArray(t)?t:[t],c=new Map,l=new Map;async function d(e,r){let t=r;for(let r of i)r.onRequest&&(t=await r.onRequest(e,t));return t}async function u(e,r,t){let o=r;for(let r of i)r.onResponse&&(o=await r.onResponse(e,o,t));return o}function f(e,r,t,o,n){if(!e)return void console.error("[RPC Listener] No source to send response to");let i={id:t,topic:o,data:!n.error&&(n.result instanceof Uint8Array||ArrayBuffer.isView(n.result))?n.result:n};"postMessage"in e&&"function"==typeof e.postMessage&&e.postMessage(i,{targetOrigin:r})}function p(e,r,t,i,a){f(e,r,t,i,{error:a instanceof n?a.toJSON():{code:o.internalError,message:a.message}})}async function m(e,r){try{"clientLifecycle"in e&&a?.clientLifecycle?await a.clientLifecycle(e,r):"iframeLifecycle"in e&&a?.iframeLifecycle&&await a.iframeLifecycle(e,r)}catch(e){console.error("[RPC Listener] Lifecycle handler error:",e)}}async function h(e){var r,t;let o;if(!function(e){try{if(s.includes("*"))return!0;let r=new URL(e).origin.toLowerCase();return s.some(e=>{let t=new URL(e).origin.toLowerCase();return r===t})}catch(e){return console.error("[RPC Listener] Invalid origin",e),!1}}(e.origin))return void console.warn("[RPC Listener] Message from disallowed origin:",e.origin);let n={origin:e.origin,source:e.source};if("object"==typeof(r=e.data)&&r&&("clientLifecycle"in r||"iframeLifecycle"in r))return void await m(e.data,n);if("object"==typeof(t=e.data)&&t&&"id"in t&&"topic"in t&&"data"in t){try{o=await d(e.data,n)}catch(r){p(e.source,e.origin,e.data.id,e.data.topic,r instanceof Error?r:Error(String(r)));return}try{await y(e,o)}catch(r){p(e.source,e.origin,e.data.id,e.data.topic,r instanceof Error?r:Error(String(r)))}}}async function y(e,r){let{id:t,topic:i,data:a}=e.data,s=c.get(i);if(s){let o=await s(a,r),n=await u(e.data,{result:o},r);f(e.source,e.origin,t,i,n);return}let d=l.get(i);if(d){let o=async o=>{let n;try{n=await u(e.data,{result:o},r)}catch(e){console.error("[RPC Listener] Middleware failed on stream chunk:",e);return}f(e.source,e.origin,t,i,n)};await d(a,o,r);return}console.error("[RPC Listener] No handler found for method:",{topic:i,handlers:l.keys(),promiseHandler:c.keys()}),p(e.source,e.origin,t,i,new n(o.methodNotFound,`Method not found: ${i}`))}return r.addEventListener("message",h),{handle:function(e,r){c.set(e,r)},handleStream:function(e,r){l.set(e,r)},unregister:function(e){c.delete(e),l.delete(e)},cleanup:function(){r.removeEventListener("message",h),c.clear(),l.clear()}}}let u=new r,f=new e;function p(e){let r={...e,validationHash:w(e??{})};return u.encode(r)}function m(e){if(!e.length)throw new n(o.corruptedResponse,"Missing compressed data");let r=y(e);if(!r)throw new n(o.corruptedResponse,"Invalid compressed data");if(!r?.validationHash)throw new n(o.corruptedResponse,"Missing validation hash");let{validationHash:t,...i}=r,a=w(i);if(a!==r.validationHash)throw console.warn("Validation error",{validationHash:t,rawResultData:i,parsedData:r,expectedValidationHashes:a,recomputedHash:w(void 0)}),new n(o.corruptedResponse,"Invalid validation hash");return r}function h(e){return u.encode(e)}function y(e){try{return f.decode(e)}catch(r){return console.error("Invalid compressed data",{e:r,data:e}),null}}function w(e){return t(u.encode(e))}let g=()=>({onRequest:(e,r)=>{if(e.data instanceof Uint8Array||ArrayBuffer.isView(e.data))return r;try{e.data=p(e.data)}catch(e){console.error("[Compression Middleware] Failed to compress request",e)}return r},onResponse:(e,r,t)=>{if(r.error||!(r.result instanceof Uint8Array||ArrayBuffer.isView(r.result)))return r;try{let{validationHash:e,...t}=m(r.result);"object"==typeof t&&null!==t&&"result"in t?r.result=t.result:r.result=t}catch(e){console.error("[Compression Middleware] Failed to decompress response",e)}return r}}),L=()=>({onRequest:(e,r)=>{if(!(e.data instanceof Uint8Array||ArrayBuffer.isView(e.data)))return r;try{let{validationHash:r,...t}=m(e.data);"object"==typeof t&&"params"in t?e.data=t.params:e.data=t}catch(e){throw console.error("[Compression Middleware] Failed to decompress request",e),e}return r},onResponse:(e,r,t)=>{if(r.error||r.result instanceof Uint8Array||ArrayBuffer.isView(r.result))return r;try{let t={method:e.topic,result:r.result};r.result=p(t)}catch(e){console.error("[Compression Middleware] Failed to compress response",e)}return r}});export{s as ClientNotFound,c as Deferred,n as FrakRpcError,a as InternalError,i as MethodNotFoundError,o as RpcErrorCodes,h as compressJson,g as createClientCompressionMiddleware,L as createListenerCompressionMiddleware,l as createRpcClient,d as createRpcListener,m as decompressDataAndCheckHash,y as decompressJson,p as hashAndCompressData};

package/dist/middleware.cjs

@@ -1 +0,0 @@
-"use strict";let __rslib_import_meta_url__="undefined"==typeof document?new(require("url".replace("",""))).URL("file:"+__filename).href:document.currentScript&&document.currentScript.src||new URL("main.js",document.baseURI).href;var __webpack_require__={};__webpack_require__.d=(e,r)=>{for(var o in r)__webpack_require__.o(r,o)&&!__webpack_require__.o(e,o)&&Object.defineProperty(e,o,{enumerable:!0,get:r[o]})},__webpack_require__.o=(e,r)=>Object.prototype.hasOwnProperty.call(e,r),__webpack_require__.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var __webpack_exports__={};__webpack_require__.r(__webpack_exports__),__webpack_require__.d(__webpack_exports__,{createListenerCompressionMiddleware:()=>createListenerCompressionMiddleware,createClientCompressionMiddleware:()=>createClientCompressionMiddleware});let index_js_namespaceObject=require("@jsonjoy.com/json-pack/lib/cbor/index.js"),external_viem_namespaceObject=require("viem"),RpcErrorCodes={parseError:-32700,invalidRequest:-32600,methodNotFound:-32601,invalidParams:-32602,internalError:-32603,serverError:-32e3,clientNotConnected:-32001,configError:-32002,corruptedResponse:-32003,clientAborted:-32004,walletNotConnected:-32005,serverErrorForInteractionDelegation:-32006,userRejected:-32007};class FrakRpcError extends Error{code;data;constructor(e,r,o){super(r),this.code=e,this.data=o}toJSON(){return{code:this.code,message:this.message,data:this.data}}}class MethodNotFoundError extends FrakRpcError{constructor(e,r){super(RpcErrorCodes.methodNotFound,e,{method:r})}}class InternalError extends FrakRpcError{constructor(e){super(RpcErrorCodes.internalError,e)}}class ClientNotFound extends FrakRpcError{constructor(){super(RpcErrorCodes.clientNotConnected,"Client not found")}}let encoder=new index_js_namespaceObject.CborEncoder,decoder=new index_js_namespaceObject.CborDecoder;function hashAndCompressData(e){let r={...e,validationHash:hashJson(e??{})};return encoder.encode(r)}function decompressDataAndCheckHash(e){if(!e.length)throw new FrakRpcError(RpcErrorCodes.corruptedResponse,"Missing compressed data");let r=decompressJson(e);if(!r)throw new FrakRpcError(RpcErrorCodes.corruptedResponse,"Invalid compressed data");if(!r?.validationHash)throw new FrakRpcError(RpcErrorCodes.corruptedResponse,"Missing validation hash");let{validationHash:o,...t}=r,s=hashJson(t);if(s!==r.validationHash)throw console.warn("Validation error",{validationHash:o,rawResultData:t,parsedData:r,expectedValidationHashes:s,recomputedHash:hashJson(void 0)}),new FrakRpcError(RpcErrorCodes.corruptedResponse,"Invalid validation hash");return r}function compressJson(e){return encoder.encode(e)}function decompressJson(e){try{return decoder.decode(e)}catch(r){return console.error("Invalid compressed data",{e:r,data:e}),null}}function hashJson(e){return(0,external_viem_namespaceObject.sha256)(encoder.encode(e))}let createClientCompressionMiddleware=()=>({onRequest:(e,r)=>{if(e.data instanceof Uint8Array||ArrayBuffer.isView(e.data))return r;try{e.data=hashAndCompressData(e.data)}catch(e){console.error("[Compression Middleware] Failed to compress request",e)}return r},onResponse:(e,r,o)=>{if(r.error||!(r.result instanceof Uint8Array||ArrayBuffer.isView(r.result)))return r;try{let{validationHash:e,...o}=decompressDataAndCheckHash(r.result);"object"==typeof o&&null!==o&&"result"in o?r.result=o.result:r.result=o}catch(e){console.error("[Compression Middleware] Failed to decompress response",e)}return r}}),createListenerCompressionMiddleware=()=>({onRequest:(e,r)=>{if(!(e.data instanceof Uint8Array||ArrayBuffer.isView(e.data)))return r;try{let{validationHash:r,...o}=decompressDataAndCheckHash(e.data);"object"==typeof o&&"params"in o?e.data=o.params:e.data=o}catch(e){throw console.error("[Compression Middleware] Failed to decompress request",e),e}return r},onResponse:(e,r,o)=>{if(r.error||r.result instanceof Uint8Array||ArrayBuffer.isView(r.result))return r;try{let o={method:e.topic,result:r.result};r.result=hashAndCompressData(o)}catch(e){console.error("[Compression Middleware] Failed to compress response",e)}return r}});for(var __webpack_i__ in exports.createClientCompressionMiddleware=__webpack_exports__.createClientCompressionMiddleware,exports.createListenerCompressionMiddleware=__webpack_exports__.createListenerCompressionMiddleware,__webpack_exports__)-1===["createClientCompressionMiddleware","createListenerCompressionMiddleware"].indexOf(__webpack_i__)&&(exports[__webpack_i__]=__webpack_exports__[__webpack_i__]);Object.defineProperty(exports,"__esModule",{value:!0});

package/dist/middleware.d.cts

@@ -1,251 +0,0 @@
-/**
- * Client-side compression middleware
- *
- * Compresses outgoing requests and decompresses incoming responses.
- * Always uses the format: {method: string, params: unknown}
- *
- * @example Client side
- * ```ts
- * const client = createRpcClient({
- *   transport: iframe.contentWindow,
- *   targetOrigin: 'https://wallet.frak.id',
- *   middleware: [createClientCompressionMiddleware()]
- * })
- * ```
- */
-export declare const createClientCompressionMiddleware: <TSchema extends RpcSchema, TContext>() => RpcMiddleware<TSchema, TContext>;
-
-/**
- * Listener-side compression middleware
- *
- * Decompresses incoming requests and compresses outgoing responses.
- * Always uses the format: {method: string, params: unknown}
- *
- * @example Listener side
- * ```ts
- * const listener = createRpcListener({
- *   transport: window,
- *   allowedOrigins: ['https://example.com'],
- *   middleware: [createListenerCompressionMiddleware()]
- * })
- * ```
- */
-export declare const createListenerCompressionMiddleware: <TSchema extends RpcSchema, TContext>() => RpcMiddleware<TSchema, TContext>;
-
-/**
- * Extract method names from a schema
- *
- * @typeParam TSchema - The RPC schema type
- *
- * @example
- * ```ts
- * type Methods = ExtractMethod<MySchema>
- * // "greet" | "watchTime"
- * ```
- */
-declare type ExtractMethod<TSchema extends RpcSchema> = TSchema[number]["Method"];
-
-/**
- * RPC error object
- */
-declare type RpcError = {
-    code: number;
-    message: string;
-    data?: unknown;
-};
-
-/**
- * RPC message format (maintains backward compatibility)
- * This is the exact format sent over the wire
- *
- * @typeParam TMethod - The method name type (defaults to string for flexibility)
- */
-declare type RpcMessage<TMethod extends string = string> = {
-    /**
-     * Unique message identifier for correlating requests and responses
-     */
-    id: string;
-    /**
-     * The RPC method name (topic for backward compatibility)
-     */
-    topic: TMethod;
-    /**
-     * The message payload (compressed data) or raw params
-     */
-    data: unknown;
-};
-
-/**
- * Unified middleware function for RPC requests (both listener and client)
- * Works on both listener-side (with context augmentation) and client-side (empty context)
- *
- * Key features:
- * - Can mutate message.data directly for efficiency (compression, validation)
- * - Can mutate response.result directly for transformation
- * - Listener-side: Can augment context by returning modified context
- * - Client-side: Uses TContext = {} (empty context), always returns unchanged
- *
- * @typeParam TSchema - The RPC schema type
- * @typeParam TContext - Custom context type to augment base context (empty {} for client-side)
- *
- * @example Listener-side with context augmentation
- * ```ts
- * type WalletContext = { productId: string, sourceUrl: string }
- * const contextMiddleware: RpcMiddleware<MySchema, WalletContext> = {
- *   onRequest: async (message, context) => {
- *     // Read from store and augment context
- *     const productId = await getProductId(context.origin)
- *     return { ...context, productId, sourceUrl: context.origin }
- *   }
- * }
- * ```
- *
- * @example Client-side (empty context)
- * ```ts
- * const compressionMiddleware: RpcMiddleware<MySchema> = {
- *   onRequest: async (message, context) => {
- *     // Mutate message.data directly
- *     message.data = compress(message.data)
- *     return context  // Empty context, unchanged
- *   },
- *   onResponse: async (message, response, context) => {
- *     // Mutate response.result directly
- *     response.result = decompress(response.result)
- *     return response
- *   }
- * }
- * ```
- *
- * @example Shared middleware (works on both sides)
- * ```ts
- * const loggingMiddleware: RpcMiddleware<MySchema> = {
- *   onRequest: async (message, context) => {
- *     console.log(`[RPC] ${message.topic}`, context.origin || 'client')
- *     return context
- *   },
- *   onResponse: async (message, response, context) => {
- *     console.log(`[RPC] ${message.topic} completed`)
- *     return response
- *   }
- * }
- * ```
- */
-declare type RpcMiddleware<TSchema extends RpcSchema, TContext = Record<string, never>> = {
-    /**
-     * Called before handler execution (listener) or before sending (client)
-     *
-     * For listener: Can augment context and mutate message
-     * For client: Can mutate message, context is empty {}
-     *
-     * @param message - The RPC message (can be mutated)
-     * @param context - Request context (listener-side) or empty (client-side)
-     * @returns Updated context (listener mutates this, client returns unchanged)
-     * @throws FrakRpcError to reject the request with a specific error code
-     */
-    onRequest?: (message: RpcMessage<ExtractMethod<TSchema>>, context: RpcMiddlewareContext<TContext>) => Promise<RpcMiddlewareContext<TContext>> | RpcMiddlewareContext<TContext>;
-    /**
-     * Called after handler execution (listener) or after receiving (client)
-     *
-     * @param message - The original RPC message
-     * @param response - The response (can be mutated)
-     * @param context - Request context (listener-side) or empty (client-side)
-     * @returns Transformed response
-     * @throws Error to send an error response instead
-     */
-    onResponse?: (message: RpcMessage<ExtractMethod<TSchema>>, response: RpcResponse, context: RpcMiddlewareContext<TContext>) => Promise<RpcResponse> | RpcResponse;
-};
-
-/**
- * Middleware context that can be augmented with custom fields
- * Generic type parameter allows domain-specific context augmentation
- *
- * @typeParam TCustomContext - Custom context fields to merge with base context
- *
- * @example
- * ```ts
- * type WalletContext = RpcMiddlewareContext<{
- *   productId: string
- *   sourceUrl: string
- *   isAutoContext: boolean
- * }>
- * // { origin: string, source: MessageEventSource | null, productId: string, sourceUrl: string, isAutoContext: boolean }
- * ```
- */
-declare type RpcMiddlewareContext<TCustomContext = Record<string, never>> = RpcRequestContext & TCustomContext;
-
-/**
- * Request context for handlers
- * Contains information about the origin and source of the request
- */
-declare type RpcRequestContext = {
-    /**
-     * Origin of the request
-     */
-    origin: string;
-    /**
-     * Message source (for responding)
-     */
-    source: MessageEventSource | null;
-};
-
-/**
- * RPC response wrapper
- * Contains either a successful result or an error
- */
-declare type RpcResponse<TResult = unknown> = {
-    result: TResult;
-    error?: never;
-} | {
-    result?: never;
-    error: RpcError;
-};
-
-/**
- * An RPC schema is a readonly array of schema entries
- *
- * @example
- * ```ts
- * type MySchema = [
- *   {
- *     Method: "greet";
- *     Parameters: [name: string];
- *     ReturnType: string;
- *     ResponseType: "promise";
- *   },
- *   {
- *     Method: "watchTime";
- *     Parameters?: undefined;
- *     ReturnType: number;
- *     ResponseType: "stream";
- *   }
- * ]
- * ```
- */
-declare type RpcSchema = readonly RpcSchemaEntry[];
-
-/**
- * Generic shape of a single RPC schema entry
- *
- * Each entry defines a method with its parameters, return type, and response kind
- *
- * @typeParam TMethod - The method name (string literal)
- * @typeParam TParams - The parameters type (can be undefined for no parameters)
- * @typeParam TReturn - The return type
- * @typeParam TResponseKind - Either "promise" or "stream"
- */
-declare type RpcSchemaEntry<TMethod extends string = string, TParams = unknown, TReturn = unknown> = {
-    /**
-     * The method name (e.g., "frak_sendInteraction")
-     */
-    Method: TMethod;
-    /**
-     * The parameters type (undefined if no parameters)
-     */
-    Parameters?: TParams;
-    /**
-     * The return type
-     */
-    ReturnType: TReturn;
-};
-
-export { }

package/dist/middleware.d.ts

@@ -1,251 +0,0 @@
-/**
- * Client-side compression middleware
- *
- * Compresses outgoing requests and decompresses incoming responses.
- * Always uses the format: {method: string, params: unknown}
- *
- * @example Client side
- * ```ts
- * const client = createRpcClient({
- *   transport: iframe.contentWindow,
- *   targetOrigin: 'https://wallet.frak.id',
- *   middleware: [createClientCompressionMiddleware()]
- * })
- * ```
- */
-export declare const createClientCompressionMiddleware: <TSchema extends RpcSchema, TContext>() => RpcMiddleware<TSchema, TContext>;
-
-/**
- * Listener-side compression middleware
- *
- * Decompresses incoming requests and compresses outgoing responses.
- * Always uses the format: {method: string, params: unknown}
- *
- * @example Listener side
- * ```ts
- * const listener = createRpcListener({
- *   transport: window,
- *   allowedOrigins: ['https://example.com'],
- *   middleware: [createListenerCompressionMiddleware()]
- * })
- * ```
- */
-export declare const createListenerCompressionMiddleware: <TSchema extends RpcSchema, TContext>() => RpcMiddleware<TSchema, TContext>;
-
-/**
- * Extract method names from a schema
- *
- * @typeParam TSchema - The RPC schema type
- *
- * @example
- * ```ts
- * type Methods = ExtractMethod<MySchema>
- * // "greet" | "watchTime"
- * ```
- */
-declare type ExtractMethod<TSchema extends RpcSchema> = TSchema[number]["Method"];
-
-/**
- * RPC error object
- */
-declare type RpcError = {
-    code: number;
-    message: string;
-    data?: unknown;
-};
-
-/**
- * RPC message format (maintains backward compatibility)
- * This is the exact format sent over the wire
- *
- * @typeParam TMethod - The method name type (defaults to string for flexibility)
- */
-declare type RpcMessage<TMethod extends string = string> = {
-    /**
-     * Unique message identifier for correlating requests and responses
-     */
-    id: string;
-    /**
-     * The RPC method name (topic for backward compatibility)
-     */
-    topic: TMethod;
-    /**
-     * The message payload (compressed data) or raw params
-     */
-    data: unknown;
-};
-
-/**
- * Unified middleware function for RPC requests (both listener and client)
- * Works on both listener-side (with context augmentation) and client-side (empty context)
- *
- * Key features:
- * - Can mutate message.data directly for efficiency (compression, validation)
- * - Can mutate response.result directly for transformation
- * - Listener-side: Can augment context by returning modified context
- * - Client-side: Uses TContext = {} (empty context), always returns unchanged
- *
- * @typeParam TSchema - The RPC schema type
- * @typeParam TContext - Custom context type to augment base context (empty {} for client-side)
- *
- * @example Listener-side with context augmentation
- * ```ts
- * type WalletContext = { productId: string, sourceUrl: string }
- * const contextMiddleware: RpcMiddleware<MySchema, WalletContext> = {
- *   onRequest: async (message, context) => {
- *     // Read from store and augment context
- *     const productId = await getProductId(context.origin)
- *     return { ...context, productId, sourceUrl: context.origin }
- *   }
- * }
- * ```
- *
- * @example Client-side (empty context)
- * ```ts
- * const compressionMiddleware: RpcMiddleware<MySchema> = {
- *   onRequest: async (message, context) => {
- *     // Mutate message.data directly
- *     message.data = compress(message.data)
- *     return context  // Empty context, unchanged
- *   },
- *   onResponse: async (message, response, context) => {
- *     // Mutate response.result directly
- *     response.result = decompress(response.result)
- *     return response
- *   }
- * }
- * ```
- *
- * @example Shared middleware (works on both sides)
- * ```ts
- * const loggingMiddleware: RpcMiddleware<MySchema> = {
- *   onRequest: async (message, context) => {
- *     console.log(`[RPC] ${message.topic}`, context.origin || 'client')
- *     return context
- *   },
- *   onResponse: async (message, response, context) => {
- *     console.log(`[RPC] ${message.topic} completed`)
- *     return response
- *   }
- * }
- * ```
- */
-declare type RpcMiddleware<TSchema extends RpcSchema, TContext = Record<string, never>> = {
-    /**
-     * Called before handler execution (listener) or before sending (client)
-     *
-     * For listener: Can augment context and mutate message
-     * For client: Can mutate message, context is empty {}
-     *
-     * @param message - The RPC message (can be mutated)
-     * @param context - Request context (listener-side) or empty (client-side)
-     * @returns Updated context (listener mutates this, client returns unchanged)
-     * @throws FrakRpcError to reject the request with a specific error code
-     */
-    onRequest?: (message: RpcMessage<ExtractMethod<TSchema>>, context: RpcMiddlewareContext<TContext>) => Promise<RpcMiddlewareContext<TContext>> | RpcMiddlewareContext<TContext>;
-    /**
-     * Called after handler execution (listener) or after receiving (client)
-     *
-     * @param message - The original RPC message
-     * @param response - The response (can be mutated)
-     * @param context - Request context (listener-side) or empty (client-side)
-     * @returns Transformed response
-     * @throws Error to send an error response instead
-     */
-    onResponse?: (message: RpcMessage<ExtractMethod<TSchema>>, response: RpcResponse, context: RpcMiddlewareContext<TContext>) => Promise<RpcResponse> | RpcResponse;
-};
-
-/**
- * Middleware context that can be augmented with custom fields
- * Generic type parameter allows domain-specific context augmentation
- *
- * @typeParam TCustomContext - Custom context fields to merge with base context
- *
- * @example
- * ```ts
- * type WalletContext = RpcMiddlewareContext<{
- *   productId: string
- *   sourceUrl: string
- *   isAutoContext: boolean
- * }>
- * // { origin: string, source: MessageEventSource | null, productId: string, sourceUrl: string, isAutoContext: boolean }
- * ```
- */
-declare type RpcMiddlewareContext<TCustomContext = Record<string, never>> = RpcRequestContext & TCustomContext;
-
-/**
- * Request context for handlers
- * Contains information about the origin and source of the request
- */
-declare type RpcRequestContext = {
-    /**
-     * Origin of the request
-     */
-    origin: string;
-    /**
-     * Message source (for responding)
-     */
-    source: MessageEventSource | null;
-};
-
-/**
- * RPC response wrapper
- * Contains either a successful result or an error
- */
-declare type RpcResponse<TResult = unknown> = {
-    result: TResult;
-    error?: never;
-} | {
-    result?: never;
-    error: RpcError;
-};
-
-/**
- * An RPC schema is a readonly array of schema entries
- *
- * @example
- * ```ts
- * type MySchema = [
- *   {
- *     Method: "greet";
- *     Parameters: [name: string];
- *     ReturnType: string;
- *     ResponseType: "promise";
- *   },
- *   {
- *     Method: "watchTime";
- *     Parameters?: undefined;
- *     ReturnType: number;
- *     ResponseType: "stream";
- *   }
- * ]
- * ```
- */
-declare type RpcSchema = readonly RpcSchemaEntry[];
-
-/**
- * Generic shape of a single RPC schema entry
- *
- * Each entry defines a method with its parameters, return type, and response kind
- *
- * @typeParam TMethod - The method name (string literal)
- * @typeParam TParams - The parameters type (can be undefined for no parameters)
- * @typeParam TReturn - The return type
- * @typeParam TResponseKind - Either "promise" or "stream"
- */
-declare type RpcSchemaEntry<TMethod extends string = string, TParams = unknown, TReturn = unknown> = {
-    /**
-     * The method name (e.g., "frak_sendInteraction")
-     */
-    Method: TMethod;
-    /**
-     * The parameters type (undefined if no parameters)
-     */
-    Parameters?: TParams;
-    /**
-     * The return type
-     */
-    ReturnType: TReturn;
-};
-
-export { }

package/dist/middleware.js

@@ -1 +0,0 @@
-import{CborDecoder as e,CborEncoder as r}from"@jsonjoy.com/json-pack/lib/cbor/index.js";import{sha256 as t}from"viem";let o={corruptedResponse:-32003};class s extends Error{code;data;constructor(e,r,t){super(r),this.code=e,this.data=t}toJSON(){return{code:this.code,message:this.message,data:this.data}}}let a=new r,n=new e;function i(e){let r={...e,validationHash:l(e??{})};return a.encode(r)}function d(e){if(!e.length)throw new s(o.corruptedResponse,"Missing compressed data");let r=function(e){try{return n.decode(e)}catch(r){return console.error("Invalid compressed data",{e:r,data:e}),null}}(e);if(!r)throw new s(o.corruptedResponse,"Invalid compressed data");if(!r?.validationHash)throw new s(o.corruptedResponse,"Missing validation hash");let{validationHash:t,...a}=r,i=l(a);if(i!==r.validationHash)throw console.warn("Validation error",{validationHash:t,rawResultData:a,parsedData:r,expectedValidationHashes:i,recomputedHash:l(void 0)}),new s(o.corruptedResponse,"Invalid validation hash");return r}function l(e){return t(a.encode(e))}let c=()=>({onRequest:(e,r)=>{if(e.data instanceof Uint8Array||ArrayBuffer.isView(e.data))return r;try{e.data=i(e.data)}catch(e){console.error("[Compression Middleware] Failed to compress request",e)}return r},onResponse:(e,r,t)=>{if(r.error||!(r.result instanceof Uint8Array||ArrayBuffer.isView(r.result)))return r;try{let{validationHash:e,...t}=d(r.result);"object"==typeof t&&null!==t&&"result"in t?r.result=t.result:r.result=t}catch(e){console.error("[Compression Middleware] Failed to decompress response",e)}return r}}),u=()=>({onRequest:(e,r)=>{if(!(e.data instanceof Uint8Array||ArrayBuffer.isView(e.data)))return r;try{let{validationHash:r,...t}=d(e.data);"object"==typeof t&&"params"in t?e.data=t.params:e.data=t}catch(e){throw console.error("[Compression Middleware] Failed to decompress request",e),e}return r},onResponse:(e,r,t)=>{if(r.error||r.result instanceof Uint8Array||ArrayBuffer.isView(r.result))return r;try{let t={method:e.topic,result:r.result};r.result=i(t)}catch(e){console.error("[Compression Middleware] Failed to compress response",e)}return r}});export{c as createClientCompressionMiddleware,u as createListenerCompressionMiddleware};