@explorins/pers-shared 2.1.115 → 2.1.117

package/dist/cjs/browser.d.ts

@@ -4,6 +4,7 @@
  */
 export * from './shared-lib/enum';
 export type * from './shared-lib/interfaces';
+export { isServerMessage, isEventMessage, isConnectedMessage, isSubscribedMessage, isUnsubscribedMessage, isErrorMessage, isPingMessage } from './shared-lib/interfaces/ws-relay.types';
 export type * from './shared-lib/dto';
 export * from './shared-lib/types';
 export * from '@explorins/web3-types';

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

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,mBAAmB,yBAAyB,CAAC;AAG7C,mBAAmB,kBAAkB,CAAC;AAGtC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,uBAAuB,CAAC;AAEtC,mBAAmB,qBAAqB,CAAC"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,mBAAmB,yBAAyB,CAAC;AAG7C,OAAO,EACL,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,aAAa,EACd,MAAM,wCAAwC,CAAC;AAGhD,mBAAmB,kBAAkB,CAAC;AAGtC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,uBAAuB,CAAC;AAEtC,mBAAmB,qBAAqB,CAAC"}

package/dist/cjs/browser.js

@@ -18,8 +18,18 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPingMessage = exports.isErrorMessage = exports.isUnsubscribedMessage = exports.isSubscribedMessage = exports.isConnectedMessage = exports.isEventMessage = exports.isServerMessage = void 0;
 // Export enums - these are safe for browser use (barrel export)
 __exportStar(require("./shared-lib/enum"), exports);
+// Export WS Relay type guards (runtime functions)
+var ws_relay_types_1 = require("./shared-lib/interfaces/ws-relay.types");
+Object.defineProperty(exports, "isServerMessage", { enumerable: true, get: function () { return ws_relay_types_1.isServerMessage; } });
+Object.defineProperty(exports, "isEventMessage", { enumerable: true, get: function () { return ws_relay_types_1.isEventMessage; } });
+Object.defineProperty(exports, "isConnectedMessage", { enumerable: true, get: function () { return ws_relay_types_1.isConnectedMessage; } });
+Object.defineProperty(exports, "isSubscribedMessage", { enumerable: true, get: function () { return ws_relay_types_1.isSubscribedMessage; } });
+Object.defineProperty(exports, "isUnsubscribedMessage", { enumerable: true, get: function () { return ws_relay_types_1.isUnsubscribedMessage; } });
+Object.defineProperty(exports, "isErrorMessage", { enumerable: true, get: function () { return ws_relay_types_1.isErrorMessage; } });
+Object.defineProperty(exports, "isPingMessage", { enumerable: true, get: function () { return ws_relay_types_1.isPingMessage; } });
 // Export types and constants (runtime exports) - browser-safe only
 __exportStar(require("./shared-lib/types"), exports);
 // Re-export web3 types for convenience

package/dist/cjs/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,gEAAgE;AAChE,oDAAkC;AAQlC,mEAAmE;AACnE,qDAAmC;AAEnC,uCAAuC;AACvC,wDAAsC;AAItC,0FAA0F"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,gEAAgE;AAChE,oDAAkC;AAKlC,kDAAkD;AAClD,yEAQgD;AAP9C,iHAAA,eAAe,OAAA;AACf,gHAAA,cAAc,OAAA;AACd,oHAAA,kBAAkB,OAAA;AAClB,qHAAA,mBAAmB,OAAA;AACnB,uHAAA,qBAAqB,OAAA;AACrB,gHAAA,cAAc,OAAA;AACd,+GAAA,aAAa,OAAA;AAMf,mEAAmE;AACnE,qDAAmC;AAEnC,uCAAuC;AACvC,wDAAsC;AAItC,0FAA0F"}

package/dist/cjs/shared-lib/interfaces/index.d.ts

@@ -19,4 +19,5 @@ export * from './counterfactual-wallet-response.interface';
 export * from './campaign';
 export * from './ai-prompt-config.interface';
 export * from './balance-filter-options.interface';
+export * from './ws-relay.types';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/shared-lib/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,kCAAkC,CAAC;AAEjD,cAAc,yBAAyB,CAAC;AAExC,cAAc,4CAA4C,CAAC;AAE3D,cAAc,YAAY,CAAC;AAE3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,kCAAkC,CAAC;AAEjD,cAAc,yBAAyB,CAAC;AAExC,cAAc,4CAA4C,CAAC;AAE3D,cAAc,YAAY,CAAC;AAE3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AAEnD,cAAc,kBAAkB,CAAC"}

package/dist/cjs/shared-lib/interfaces/index.js

@@ -36,4 +36,5 @@ __exportStar(require("./counterfactual-wallet-response.interface"), exports);
 __exportStar(require("./campaign"), exports);
 __exportStar(require("./ai-prompt-config.interface"), exports);
 __exportStar(require("./balance-filter-options.interface"), exports);
+__exportStar(require("./ws-relay.types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/shared-lib/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAkD;AAClD,mEAAiD;AACjD,uEAAqD;AACrD,iEAA+C;AAC/C,iEAA+C;AAC/C,0DAAwC;AACxC,+DAA6C;AAC7C,2EAAyD;AACzD,iEAA+C;AAC/C,qDAAmC;AACnC,gEAA8C;AAC9C,kEAAgD;AAChD,sEAAoD;AACpD,8DAA4C;AAC5C,kEAAgD;AAChD,4EAA0D;AAC1D,mEAAiD;AAEjD,0DAAwC;AAExC,6EAA2D;AAE3D,6CAA2B;AAE3B,+DAA6C;AAC7C,qEAAmD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAkD;AAClD,mEAAiD;AACjD,uEAAqD;AACrD,iEAA+C;AAC/C,iEAA+C;AAC/C,0DAAwC;AACxC,+DAA6C;AAC7C,2EAAyD;AACzD,iEAA+C;AAC/C,qDAAmC;AACnC,gEAA8C;AAC9C,kEAAgD;AAChD,sEAAoD;AACpD,8DAA4C;AAC5C,kEAAgD;AAChD,4EAA0D;AAC1D,mEAAiD;AAEjD,0DAAwC;AAExC,6EAA2D;AAE3D,6CAA2B;AAE3B,+DAA6C;AAC7C,qEAAmD;AAEnD,mDAAiC"}

package/dist/cjs/shared-lib/interfaces/ws-relay.types.d.ts

@@ -0,0 +1,193 @@
+/**
+ * PERS WS-Relay Shared Types
+ *
+ * Type-safe WebSocket communication types for the PERS event relay system.
+ *
+ * @version 1.2.0
+ */
+/**
+ * Wallet information for subscription
+ */
+export interface WalletInfo {
+    /** Ethereum address (0x...) */
+    address: string;
+    /** Chain ID (e.g., 39123 for PERS testnet) */
+    chainId: number;
+}
+/**
+ * Base client message
+ */
+export interface WSClientMessageBase {
+    type: 'subscribe' | 'unsubscribe' | 'pong';
+}
+/**
+ * Subscribe to wallet addresses (filtered events) or chains (all events)
+ *
+ * @example Subscribe to wallets (User SDK)
+ * ```typescript
+ * ws.send(JSON.stringify({
+ *   type: 'subscribe',
+ *   wallets: [{ address: '0x...', chainId: 39123 }]
+ * }));
+ * ```
+ *
+ * @example Subscribe to chains (Admin Dashboard - all events)
+ * ```typescript
+ * ws.send(JSON.stringify({
+ *   type: 'subscribe',
+ *   chains: [39123]
+ * }));
+ * ```
+ */
+export interface SubscribeMessage extends WSClientMessageBase {
+    type: 'subscribe';
+    /** Wallet addresses to subscribe (filtered events) */
+    wallets?: WalletInfo[];
+    /** Chain IDs for full chain subscription (all events - admin mode) */
+    chains?: number[];
+}
+/**
+ * Unsubscribe from wallets or chains
+ */
+export interface UnsubscribeMessage extends WSClientMessageBase {
+    type: 'unsubscribe';
+    /** Wallet addresses to unsubscribe */
+    wallets?: WalletInfo[];
+    /** Chain IDs to unsubscribe */
+    chains?: number[];
+}
+/**
+ * Pong response to server ping
+ */
+export interface PongMessage extends WSClientMessageBase {
+    type: 'pong';
+}
+/**
+ * All client message types
+ */
+export type WSClientMessage = SubscribeMessage | UnsubscribeMessage | PongMessage;
+/**
+ * Connection confirmation (sent immediately after auth)
+ */
+export interface ConnectedPayload {
+    userId: string;
+    wallets: WalletInfo[];
+    activeChains: number[];
+}
+/**
+ * Subscription confirmation
+ */
+export interface SubscribedPayload {
+    /** Currently subscribed wallets */
+    wallets: WalletInfo[];
+    /** Currently subscribed chains (admin mode) */
+    chains: number[];
+    /** All active chain IDs */
+    activeChains: number[];
+}
+/**
+ * Unsubscription confirmation
+ */
+export interface UnsubscribedPayload {
+    /** Remaining subscribed wallets */
+    wallets: WalletInfo[];
+    /** Remaining subscribed chains */
+    chains: number[];
+    /** All active chain IDs */
+    activeChains: number[];
+}
+/**
+ * Error payload
+ */
+export interface ErrorPayload {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+/**
+ * Blockchain event types
+ */
+export type BlockchainEventType = 'Transfer' | 'Approval' | 'Mint' | 'Burn' | 'Swap' | 'Unknown';
+/**
+ * Blockchain event payload
+ */
+export interface BlockchainEvent {
+    chainId: number;
+    type: BlockchainEventType;
+    txHash: string;
+    blockNumber: number;
+    timestamp: number;
+    contractAddress: string;
+    data: {
+        from?: string;
+        to?: string;
+        value?: string;
+        [key: string]: unknown;
+    };
+    userMessage: string;
+}
+/**
+ * Server message types
+ */
+export interface WSServerMessageConnected {
+    type: 'connected';
+    payload: ConnectedPayload;
+    timestamp: number;
+}
+export interface WSServerMessageSubscribed {
+    type: 'subscribed';
+    payload: SubscribedPayload;
+    timestamp: number;
+}
+export interface WSServerMessageUnsubscribed {
+    type: 'unsubscribed';
+    payload: UnsubscribedPayload;
+    timestamp: number;
+}
+export interface WSServerMessageEvent {
+    type: 'event';
+    payload: BlockchainEvent;
+    timestamp: number;
+}
+export interface WSServerMessageError {
+    type: 'error';
+    payload: ErrorPayload;
+    timestamp: number;
+}
+export interface WSServerMessagePing {
+    type: 'ping';
+    timestamp: number;
+}
+/**
+ * All server message types
+ */
+export type WSServerMessage = WSServerMessageConnected | WSServerMessageSubscribed | WSServerMessageUnsubscribed | WSServerMessageEvent | WSServerMessageError | WSServerMessagePing;
+/**
+ * Type guard for server messages
+ */
+export declare function isServerMessage(data: unknown): data is WSServerMessage;
+/**
+ * Type guard for event messages
+ */
+export declare function isEventMessage(msg: WSServerMessage): msg is WSServerMessageEvent;
+/**
+ * Type guard for connected messages
+ */
+export declare function isConnectedMessage(msg: WSServerMessage): msg is WSServerMessageConnected;
+/**
+ * Type guard for subscribed messages
+ */
+export declare function isSubscribedMessage(msg: WSServerMessage): msg is WSServerMessageSubscribed;
+/**
+ * Type guard for unsubscribed messages
+ */
+export declare function isUnsubscribedMessage(msg: WSServerMessage): msg is WSServerMessageUnsubscribed;
+/**
+ * Type guard for error messages
+ */
+export declare function isErrorMessage(msg: WSServerMessage): msg is WSServerMessageError;
+/**
+ * Type guard for ping messages
+ */
+export declare function isPingMessage(msg: WSServerMessage): msg is WSServerMessagePing;
+//# sourceMappingURL=ws-relay.types.d.ts.map

package/dist/cjs/shared-lib/interfaces/ws-relay.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-relay.types.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/ws-relay.types.ts"],"names":[],"mappings":"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"}

package/dist/cjs/shared-lib/interfaces/ws-relay.types.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * PERS WS-Relay Shared Types
+ *
+ * Type-safe WebSocket communication types for the PERS event relay system.
+ *
+ * @version 1.2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isServerMessage = isServerMessage;
+exports.isEventMessage = isEventMessage;
+exports.isConnectedMessage = isConnectedMessage;
+exports.isSubscribedMessage = isSubscribedMessage;
+exports.isUnsubscribedMessage = isUnsubscribedMessage;
+exports.isErrorMessage = isErrorMessage;
+exports.isPingMessage = isPingMessage;
+// =============================================================================
+// HELPER FUNCTIONS (TYPE GUARDS)
+// =============================================================================
+/**
+ * Type guard for server messages
+ */
+function isServerMessage(data) {
+    return (typeof data === 'object' &&
+        data !== null &&
+        'type' in data &&
+        'timestamp' in data);
+}
+/**
+ * Type guard for event messages
+ */
+function isEventMessage(msg) {
+    return msg.type === 'event';
+}
+/**
+ * Type guard for connected messages
+ */
+function isConnectedMessage(msg) {
+    return msg.type === 'connected';
+}
+/**
+ * Type guard for subscribed messages
+ */
+function isSubscribedMessage(msg) {
+    return msg.type === 'subscribed';
+}
+/**
+ * Type guard for unsubscribed messages
+ */
+function isUnsubscribedMessage(msg) {
+    return msg.type === 'unsubscribed';
+}
+/**
+ * Type guard for error messages
+ */
+function isErrorMessage(msg) {
+    return msg.type === 'error';
+}
+/**
+ * Type guard for ping messages
+ */
+function isPingMessage(msg) {
+    return msg.type === 'ping';
+}
+//# sourceMappingURL=ws-relay.types.js.map

package/dist/cjs/shared-lib/interfaces/ws-relay.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-relay.types.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/ws-relay.types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAiNH,0CAOC;AAKD,wCAEC;AAKD,gDAEC;AAKD,kDAEC;AAKD,sDAEC;AAKD,wCAEC;AAKD,sCAEC;AAxDD,gFAAgF;AAChF,iCAAiC;AACjC,gFAAgF;AAEhF;;GAEG;AACH,SAAgB,eAAe,CAAC,IAAa;IAC3C,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,MAAM,IAAI,IAAI;QACd,WAAW,IAAI,IAAI,CACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,GAAoB;IACjD,OAAO,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,GAAoB;IACrD,OAAO,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,GAAoB;IACtD,OAAO,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,GAAoB;IACxD,OAAO,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,GAAoB;IACjD,OAAO,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,GAAoB;IAChD,OAAO,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AAC7B,CAAC"}

package/dist/esm/browser.d.ts

@@ -4,6 +4,7 @@
  */
 export * from './shared-lib/enum';
 export type * from './shared-lib/interfaces';
+export { isServerMessage, isEventMessage, isConnectedMessage, isSubscribedMessage, isUnsubscribedMessage, isErrorMessage, isPingMessage } from './shared-lib/interfaces/ws-relay.types';
 export type * from './shared-lib/dto';
 export * from './shared-lib/types';
 export * from '@explorins/web3-types';

package/dist/esm/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,mBAAmB,yBAAyB,CAAC;AAG7C,mBAAmB,kBAAkB,CAAC;AAGtC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,uBAAuB,CAAC;AAEtC,mBAAmB,qBAAqB,CAAC"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,mBAAmB,yBAAyB,CAAC;AAG7C,OAAO,EACL,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,aAAa,EACd,MAAM,wCAAwC,CAAC;AAGhD,mBAAmB,kBAAkB,CAAC;AAGtC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,uBAAuB,CAAC;AAEtC,mBAAmB,qBAAqB,CAAC"}

package/dist/esm/browser.js

@@ -4,6 +4,8 @@
  */
 // Export enums - these are safe for browser use (barrel export)
 export * from './shared-lib/enum/index.js';
+// Export WS Relay type guards (runtime functions)
+export { isServerMessage, isEventMessage, isConnectedMessage, isSubscribedMessage, isUnsubscribedMessage, isErrorMessage, isPingMessage } from './shared-lib/interfaces/ws-relay.types.js';
 // Export types and constants (runtime exports) - browser-safe only
 export * from './shared-lib/types/index.js';
 // Re-export web3 types for convenience

package/dist/esm/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gEAAgE;AAChE,cAAc,mBAAmB,CAAC;AAQlC,mEAAmE;AACnE,cAAc,oBAAoB,CAAC;AAEnC,uCAAuC;AACvC,cAAc,uBAAuB,CAAC;AAItC,0FAA0F"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gEAAgE;AAChE,cAAc,mBAAmB,CAAC;AAKlC,kDAAkD;AAClD,OAAO,EACL,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,aAAa,EACd,MAAM,wCAAwC,CAAC;AAKhD,mEAAmE;AACnE,cAAc,oBAAoB,CAAC;AAEnC,uCAAuC;AACvC,cAAc,uBAAuB,CAAC;AAItC,0FAA0F"}

package/dist/esm/shared-lib/interfaces/index.d.ts

@@ -19,4 +19,5 @@ export * from './counterfactual-wallet-response.interface';
 export * from './campaign';
 export * from './ai-prompt-config.interface';
 export * from './balance-filter-options.interface';
+export * from './ws-relay.types';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/shared-lib/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,kCAAkC,CAAC;AAEjD,cAAc,yBAAyB,CAAC;AAExC,cAAc,4CAA4C,CAAC;AAE3D,cAAc,YAAY,CAAC;AAE3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,kCAAkC,CAAC;AAEjD,cAAc,yBAAyB,CAAC;AAExC,cAAc,4CAA4C,CAAC;AAE3D,cAAc,YAAY,CAAC;AAE3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AAEnD,cAAc,kBAAkB,CAAC"}

package/dist/esm/shared-lib/interfaces/index.js

@@ -20,4 +20,5 @@ export * from './counterfactual-wallet-response.interface.js';
 export * from './campaign/index.js';
 export * from './ai-prompt-config.interface.js';
 export * from './balance-filter-options.interface.js';
+export * from './ws-relay.types.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/shared-lib/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,kCAAkC,CAAC;AAEjD,cAAc,yBAAyB,CAAC;AAExC,cAAc,4CAA4C,CAAC;AAE3D,cAAc,YAAY,CAAC;AAE3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,kCAAkC,CAAC;AAEjD,cAAc,yBAAyB,CAAC;AAExC,cAAc,4CAA4C,CAAC;AAE3D,cAAc,YAAY,CAAC;AAE3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AAEnD,cAAc,kBAAkB,CAAC"}

package/dist/esm/shared-lib/interfaces/ws-relay.types.d.ts

@@ -0,0 +1,193 @@
+/**
+ * PERS WS-Relay Shared Types
+ *
+ * Type-safe WebSocket communication types for the PERS event relay system.
+ *
+ * @version 1.2.0
+ */
+/**
+ * Wallet information for subscription
+ */
+export interface WalletInfo {
+    /** Ethereum address (0x...) */
+    address: string;
+    /** Chain ID (e.g., 39123 for PERS testnet) */
+    chainId: number;
+}
+/**
+ * Base client message
+ */
+export interface WSClientMessageBase {
+    type: 'subscribe' | 'unsubscribe' | 'pong';
+}
+/**
+ * Subscribe to wallet addresses (filtered events) or chains (all events)
+ *
+ * @example Subscribe to wallets (User SDK)
+ * ```typescript
+ * ws.send(JSON.stringify({
+ *   type: 'subscribe',
+ *   wallets: [{ address: '0x...', chainId: 39123 }]
+ * }));
+ * ```
+ *
+ * @example Subscribe to chains (Admin Dashboard - all events)
+ * ```typescript
+ * ws.send(JSON.stringify({
+ *   type: 'subscribe',
+ *   chains: [39123]
+ * }));
+ * ```
+ */
+export interface SubscribeMessage extends WSClientMessageBase {
+    type: 'subscribe';
+    /** Wallet addresses to subscribe (filtered events) */
+    wallets?: WalletInfo[];
+    /** Chain IDs for full chain subscription (all events - admin mode) */
+    chains?: number[];
+}
+/**
+ * Unsubscribe from wallets or chains
+ */
+export interface UnsubscribeMessage extends WSClientMessageBase {
+    type: 'unsubscribe';
+    /** Wallet addresses to unsubscribe */
+    wallets?: WalletInfo[];
+    /** Chain IDs to unsubscribe */
+    chains?: number[];
+}
+/**
+ * Pong response to server ping
+ */
+export interface PongMessage extends WSClientMessageBase {
+    type: 'pong';
+}
+/**
+ * All client message types
+ */
+export type WSClientMessage = SubscribeMessage | UnsubscribeMessage | PongMessage;
+/**
+ * Connection confirmation (sent immediately after auth)
+ */
+export interface ConnectedPayload {
+    userId: string;
+    wallets: WalletInfo[];
+    activeChains: number[];
+}
+/**
+ * Subscription confirmation
+ */
+export interface SubscribedPayload {
+    /** Currently subscribed wallets */
+    wallets: WalletInfo[];
+    /** Currently subscribed chains (admin mode) */
+    chains: number[];
+    /** All active chain IDs */
+    activeChains: number[];
+}
+/**
+ * Unsubscription confirmation
+ */
+export interface UnsubscribedPayload {
+    /** Remaining subscribed wallets */
+    wallets: WalletInfo[];
+    /** Remaining subscribed chains */
+    chains: number[];
+    /** All active chain IDs */
+    activeChains: number[];
+}
+/**
+ * Error payload
+ */
+export interface ErrorPayload {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+/**
+ * Blockchain event types
+ */
+export type BlockchainEventType = 'Transfer' | 'Approval' | 'Mint' | 'Burn' | 'Swap' | 'Unknown';
+/**
+ * Blockchain event payload
+ */
+export interface BlockchainEvent {
+    chainId: number;
+    type: BlockchainEventType;
+    txHash: string;
+    blockNumber: number;
+    timestamp: number;
+    contractAddress: string;
+    data: {
+        from?: string;
+        to?: string;
+        value?: string;
+        [key: string]: unknown;
+    };
+    userMessage: string;
+}
+/**
+ * Server message types
+ */
+export interface WSServerMessageConnected {
+    type: 'connected';
+    payload: ConnectedPayload;
+    timestamp: number;
+}
+export interface WSServerMessageSubscribed {
+    type: 'subscribed';
+    payload: SubscribedPayload;
+    timestamp: number;
+}
+export interface WSServerMessageUnsubscribed {
+    type: 'unsubscribed';
+    payload: UnsubscribedPayload;
+    timestamp: number;
+}
+export interface WSServerMessageEvent {
+    type: 'event';
+    payload: BlockchainEvent;
+    timestamp: number;
+}
+export interface WSServerMessageError {
+    type: 'error';
+    payload: ErrorPayload;
+    timestamp: number;
+}
+export interface WSServerMessagePing {
+    type: 'ping';
+    timestamp: number;
+}
+/**
+ * All server message types
+ */
+export type WSServerMessage = WSServerMessageConnected | WSServerMessageSubscribed | WSServerMessageUnsubscribed | WSServerMessageEvent | WSServerMessageError | WSServerMessagePing;
+/**
+ * Type guard for server messages
+ */
+export declare function isServerMessage(data: unknown): data is WSServerMessage;
+/**
+ * Type guard for event messages
+ */
+export declare function isEventMessage(msg: WSServerMessage): msg is WSServerMessageEvent;
+/**
+ * Type guard for connected messages
+ */
+export declare function isConnectedMessage(msg: WSServerMessage): msg is WSServerMessageConnected;
+/**
+ * Type guard for subscribed messages
+ */
+export declare function isSubscribedMessage(msg: WSServerMessage): msg is WSServerMessageSubscribed;
+/**
+ * Type guard for unsubscribed messages
+ */
+export declare function isUnsubscribedMessage(msg: WSServerMessage): msg is WSServerMessageUnsubscribed;
+/**
+ * Type guard for error messages
+ */
+export declare function isErrorMessage(msg: WSServerMessage): msg is WSServerMessageError;
+/**
+ * Type guard for ping messages
+ */
+export declare function isPingMessage(msg: WSServerMessage): msg is WSServerMessagePing;
+//# sourceMappingURL=ws-relay.types.d.ts.map

package/dist/esm/shared-lib/interfaces/ws-relay.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-relay.types.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/ws-relay.types.ts"],"names":[],"mappings":"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"}

package/dist/esm/shared-lib/interfaces/ws-relay.types.js

@@ -0,0 +1,56 @@
+/**
+ * PERS WS-Relay Shared Types
+ *
+ * Type-safe WebSocket communication types for the PERS event relay system.
+ *
+ * @version 1.2.0
+ */
+// =============================================================================
+// HELPER FUNCTIONS (TYPE GUARDS)
+// =============================================================================
+/**
+ * Type guard for server messages
+ */
+export function isServerMessage(data) {
+    return (typeof data === 'object' &&
+        data !== null &&
+        'type' in data &&
+        'timestamp' in data);
+}
+/**
+ * Type guard for event messages
+ */
+export function isEventMessage(msg) {
+    return msg.type === 'event';
+}
+/**
+ * Type guard for connected messages
+ */
+export function isConnectedMessage(msg) {
+    return msg.type === 'connected';
+}
+/**
+ * Type guard for subscribed messages
+ */
+export function isSubscribedMessage(msg) {
+    return msg.type === 'subscribed';
+}
+/**
+ * Type guard for unsubscribed messages
+ */
+export function isUnsubscribedMessage(msg) {
+    return msg.type === 'unsubscribed';
+}
+/**
+ * Type guard for error messages
+ */
+export function isErrorMessage(msg) {
+    return msg.type === 'error';
+}
+/**
+ * Type guard for ping messages
+ */
+export function isPingMessage(msg) {
+    return msg.type === 'ping';
+}
+//# sourceMappingURL=ws-relay.types.js.map

package/dist/esm/shared-lib/interfaces/ws-relay.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-relay.types.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/ws-relay.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0MH,gFAAgF;AAChF,iCAAiC;AACjC,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,MAAM,IAAI,IAAI;QACd,WAAW,IAAI,IAAI,CACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAoB;IACjD,OAAO,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAoB;IACrD,OAAO,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAoB;IACtD,OAAO,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAoB;IACxD,OAAO,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAoB;IACjD,OAAO,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAoB;IAChD,OAAO,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AAC7B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-shared",
-  "version": "2.1.115",
+  "version": "2.1.117",
   "scripts": {
     "clean": "find dist -type f -delete 2>/dev/null || true",
     "build:esm": "tsc -p tsconfig.esm.json && node scripts/add-js-extensions.js",