@explorins/pers-shared 2.1.114 → 2.1.116

package/dist/cjs/shared-lib/dto/chain-data.dto.d.ts

@@ -1,6 +1,6 @@
 import type { ChainType } from "@explorins/web3-types";
 export declare class ChainDataDTO {
-    name?: string;
+    name: string;
     shortName?: string;
     chain?: string;
     network?: string;

package/dist/cjs/shared-lib/dto/chain-data.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chain-data.dto.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/dto/chain-data.dto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAKvD,qBAAa,YAAY;IAQrB,IAAI,CAAC,EAAE,MAAM,CAAC;IAQd,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,KAAK,CAAC,EAAE,MAAM,CAAC;IAQf,OAAO,CAAC,EAAE,MAAM,CAAC;IAQjB,OAAO,EAAG,MAAM,CAAC;IAQjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,MAAM,EAAG,MAAM,CAAC;IAQhB,KAAK,CAAC,EAAE,MAAM,CAAC;IAQf,UAAU,CAAC,EAAE,MAAM,CAAC;IAOpB,SAAS,EAAE,SAAS,CAAsB;CAE7C"}
+{"version":3,"file":"chain-data.dto.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/dto/chain-data.dto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAKvD,qBAAa,YAAY;IAQrB,IAAI,EAAG,MAAM,CAAC;IAQd,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,KAAK,CAAC,EAAE,MAAM,CAAC;IAQf,OAAO,CAAC,EAAE,MAAM,CAAC;IAQjB,OAAO,EAAG,MAAM,CAAC;IAQjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,MAAM,EAAG,MAAM,CAAC;IAQhB,KAAK,CAAC,EAAE,MAAM,CAAC;IAQf,UAAU,CAAC,EAAE,MAAM,CAAC;IAOpB,SAAS,EAAE,SAAS,CAAsB;CAE7C"}

package/dist/cjs/shared-lib/dto/chain-data.dto.js

@@ -27,7 +27,7 @@ class ChainDataDTO {
 }
 exports.ChainDataDTO = ChainDataDTO;
 __decorate([
-    (0, swagger_1.ApiPropertyOptional)({
+    (0, swagger_1.ApiProperty)({
         type: String,
         description: 'Name of the chain'
     }),

package/dist/cjs/shared-lib/dto/chain-data.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"chain-data.dto.js","sourceRoot":"","sources":["../../../../src/shared-lib/dto/chain-data.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,sDAAmD;AACnD,6CAAmE;AAGnE,MAAa,YAAY;IAQrB,IAAI,CAAU;IAQd,SAAS,CAAU;IAQnB,KAAK,CAAU;IAQf,OAAO,CAAU;IAQjB,OAAO,CAAU;IAQjB,WAAW,CAAU;IAQrB,SAAS,CAAU;IAQnB,MAAM,CAAU;IAQhB,KAAK,CAAU;IAQf,UAAU,CAAU;IAOpB,SAAS,GAAc,uBAAU,CAAC,OAAO,CAAC;CAE7C;AAzFD,oCAyFC;AAjFG;IANC,IAAA,6BAAmB,EAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,mBAAmB;KACnC,CACJ;;0CACa;AAQd;IANC,IAAA,6BAAmB,EAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,yBAAyB;KACzC,CACJ;;+CACkB;AAQnB;IANC,IAAA,6BAAmB,EAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,YAAY;KAC5B,CACJ;;2CACc;AAQf;IANC,IAAA,6BAAmB,EAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,cAAc;KAC9B,CACJ;;6CACgB;AAQjB;IANC,IAAA,qBAAW,EACR;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,UAAU;KAC1B,CACJ;;6CACgB;AAQjB;IANC,IAAA,6BAAmB,EAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,cAAc;KAC9B,CACJ;;iDACoB;AAQrB;IANC,IAAA,6BAAmB,EAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,YAAY;KAC5B,CACJ;;+CACkB;AAQnB;IANC,IAAA,qBAAW,EACR;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,SAAS;KACzB,CACJ;;4CACe;AAQhB;IANC,IAAA,6BAAmB,EAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,eAAe;KAC/B,CACJ;;2CACc;AAQf;IANC,IAAA,6BAAmB,EAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,sBAAsB;KACtC,CACJ;;gDACmB;AAOpB;IALC,IAAA,qBAAW,EACR;QACI,WAAW,EAAE,YAAY;KAC5B,CACJ;;+CACyC"}
+{"version":3,"file":"chain-data.dto.js","sourceRoot":"","sources":["../../../../src/shared-lib/dto/chain-data.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,sDAAmD;AACnD,6CAAmE;AAGnE,MAAa,YAAY;IAQrB,IAAI,CAAU;IAQd,SAAS,CAAU;IAQnB,KAAK,CAAU;IAQf,OAAO,CAAU;IAQjB,OAAO,CAAU;IAQjB,WAAW,CAAU;IAQrB,SAAS,CAAU;IAQnB,MAAM,CAAU;IAQhB,KAAK,CAAU;IAQf,UAAU,CAAU;IAOpB,SAAS,GAAc,uBAAU,CAAC,OAAO,CAAC;CAE7C;AAzFD,oCAyFC;AAjFG;IANC,IAAA,qBAAW,EACR;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,mBAAmB;KACnC,CACJ;;0CACa;AAQd;IANC,IAAA,6BAAmB,EAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,yBAAyB;KACzC,CACJ;;+CACkB;AAQnB;IANC,IAAA,6BAAmB,EAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,YAAY;KAC5B,CACJ;;2CACc;AAQf;IANC,IAAA,6BAAmB,EAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,cAAc;KAC9B,CACJ;;6CACgB;AAQjB;IANC,IAAA,qBAAW,EACR;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,UAAU;KAC1B,CACJ;;6CACgB;AAQjB;IANC,IAAA,6BAAmB,EAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,cAAc;KAC9B,CACJ;;iDACoB;AAQrB;IANC,IAAA,6BAAmB,EAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,YAAY;KAC5B,CACJ;;+CACkB;AAQnB;IANC,IAAA,qBAAW,EACR;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,SAAS;KACzB,CACJ;;4CACe;AAQhB;IANC,IAAA,6BAAmB,EAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,eAAe;KAC/B,CACJ;;2CACc;AAQf;IANC,IAAA,6BAAmB,EAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,sBAAsB;KACtC,CACJ;;gDACmB;AAOpB;IALC,IAAA,qBAAW,EACR;QACI,WAAW,EAAE,YAAY;KAC5B,CACJ;;+CACyC"}

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/shared-lib/dto/chain-data.dto.d.ts

@@ -1,6 +1,6 @@
 import type { ChainType } from "@explorins/web3-types";
 export declare class ChainDataDTO {
-    name?: string;
+    name: string;
     shortName?: string;
     chain?: string;
     network?: string;

package/dist/esm/shared-lib/dto/chain-data.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chain-data.dto.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/dto/chain-data.dto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAKvD,qBAAa,YAAY;IAQrB,IAAI,CAAC,EAAE,MAAM,CAAC;IAQd,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,KAAK,CAAC,EAAE,MAAM,CAAC;IAQf,OAAO,CAAC,EAAE,MAAM,CAAC;IAQjB,OAAO,EAAG,MAAM,CAAC;IAQjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,MAAM,EAAG,MAAM,CAAC;IAQhB,KAAK,CAAC,EAAE,MAAM,CAAC;IAQf,UAAU,CAAC,EAAE,MAAM,CAAC;IAOpB,SAAS,EAAE,SAAS,CAAsB;CAE7C"}
+{"version":3,"file":"chain-data.dto.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/dto/chain-data.dto.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAKvD,qBAAa,YAAY;IAQrB,IAAI,EAAG,MAAM,CAAC;IAQd,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,KAAK,CAAC,EAAE,MAAM,CAAC;IAQf,OAAO,CAAC,EAAE,MAAM,CAAC;IAQjB,OAAO,EAAG,MAAM,CAAC;IAQjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,MAAM,EAAG,MAAM,CAAC;IAQhB,KAAK,CAAC,EAAE,MAAM,CAAC;IAQf,UAAU,CAAC,EAAE,MAAM,CAAC;IAOpB,SAAS,EAAE,SAAS,CAAsB;CAE7C"}

package/dist/esm/shared-lib/dto/chain-data.dto.js

@@ -20,7 +20,7 @@ export class ChainDataDTO {
     chainType = ChainTypes.PRIVATE;
 }
 __decorate([
-    ApiPropertyOptional({
+    ApiProperty({
         type: String,
         description: 'Name of the chain'
     })

package/dist/esm/shared-lib/dto/chain-data.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"chain-data.dto.js","sourceRoot":"","sources":["../../../../src/shared-lib/dto/chain-data.dto.ts"],"names":[],"mappings":";;;;;;AACA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGnE,MAAM,OAAO,YAAY;IAQrB,IAAI,CAAU;IAQd,SAAS,CAAU;IAQnB,KAAK,CAAU;IAQf,OAAO,CAAU;IAQjB,OAAO,CAAU;IAQjB,WAAW,CAAU;IAQrB,SAAS,CAAU;IAQnB,MAAM,CAAU;IAQhB,KAAK,CAAU;IAQf,UAAU,CAAU;IAOpB,SAAS,GAAc,UAAU,CAAC,OAAO,CAAC;CAE7C;AAjFG;IANC,mBAAmB,CAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,mBAAmB;KACnC,CACJ;0CACa;AAQd;IANC,mBAAmB,CAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,yBAAyB;KACzC,CACJ;+CACkB;AAQnB;IANC,mBAAmB,CAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,YAAY;KAC5B,CACJ;2CACc;AAQf;IANC,mBAAmB,CAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,cAAc;KAC9B,CACJ;6CACgB;AAQjB;IANC,WAAW,CACR;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,UAAU;KAC1B,CACJ;6CACgB;AAQjB;IANC,mBAAmB,CAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,cAAc;KAC9B,CACJ;iDACoB;AAQrB;IANC,mBAAmB,CAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,YAAY;KAC5B,CACJ;+CACkB;AAQnB;IANC,WAAW,CACR;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,SAAS;KACzB,CACJ;4CACe;AAQhB;IANC,mBAAmB,CAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,eAAe;KAC/B,CACJ;2CACc;AAQf;IANC,mBAAmB,CAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,sBAAsB;KACtC,CACJ;gDACmB;AAOpB;IALC,WAAW,CACR;QACI,WAAW,EAAE,YAAY;KAC5B,CACJ;+CACyC"}
+{"version":3,"file":"chain-data.dto.js","sourceRoot":"","sources":["../../../../src/shared-lib/dto/chain-data.dto.ts"],"names":[],"mappings":";;;;;;AACA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGnE,MAAM,OAAO,YAAY;IAQrB,IAAI,CAAU;IAQd,SAAS,CAAU;IAQnB,KAAK,CAAU;IAQf,OAAO,CAAU;IAQjB,OAAO,CAAU;IAQjB,WAAW,CAAU;IAQrB,SAAS,CAAU;IAQnB,MAAM,CAAU;IAQhB,KAAK,CAAU;IAQf,UAAU,CAAU;IAOpB,SAAS,GAAc,UAAU,CAAC,OAAO,CAAC;CAE7C;AAjFG;IANC,WAAW,CACR;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,mBAAmB;KACnC,CACJ;0CACa;AAQd;IANC,mBAAmB,CAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,yBAAyB;KACzC,CACJ;+CACkB;AAQnB;IANC,mBAAmB,CAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,YAAY;KAC5B,CACJ;2CACc;AAQf;IANC,mBAAmB,CAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,cAAc;KAC9B,CACJ;6CACgB;AAQjB;IANC,WAAW,CACR;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,UAAU;KAC1B,CACJ;6CACgB;AAQjB;IANC,mBAAmB,CAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,cAAc;KAC9B,CACJ;iDACoB;AAQrB;IANC,mBAAmB,CAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,YAAY;KAC5B,CACJ;+CACkB;AAQnB;IANC,WAAW,CACR;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,SAAS;KACzB,CACJ;4CACe;AAQhB;IANC,mBAAmB,CAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,eAAe;KAC/B,CACJ;2CACc;AAQf;IANC,mBAAmB,CAChB;QACI,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,sBAAsB;KACtC,CACJ;gDACmB;AAOpB;IALC,WAAW,CACR;QACI,WAAW,EAAE,YAAY;KAC5B,CACJ;+CACyC"}

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.114",
+  "version": "2.1.116",
   "scripts": {
     "clean": "find dist -type f -delete 2>/dev/null || true",
     "build:esm": "tsc -p tsconfig.esm.json && node scripts/add-js-extensions.js",