@explorins/pers-sdk 2.1.11 → 2.1.15

package/dist/managers/web3-manager.d.ts

@@ -1,7 +1,8 @@
 import { PersApiClient } from '../core/pers-api-client';
 import { Web3ApplicationService } from '../web3/application/web3-application.service';
+import { TenantManager } from './tenant-manager';
 import type { TokenBalanceRequest, TokenCollectionRequest, TokenBalance, TokenCollection, TokenMetadata, AccountOwnedTokensResult } from '../web3/application/web3-application.service';
-import type { ChainData } from '../web3-chain';
+import type { ChainDataDTO } from '@explorins/pers-shared';
 import type { TokenDTO } from '../token/models';
 /**
  * Web3 Manager - Clean, high-level interface for Web3 operations
@@ -39,12 +40,18 @@ import type { TokenDTO } from '../token/models';
  *   tokenIds  // Required for ERC-1155, optional for ERC-721
  * });
  * ```
+ *
+ * ## IPFS Resolution
+ *
+ * For IPFS URL resolution, use `sdk.tenant.resolveIPFSUrl()` instead.
+ * IPFS is chain-agnostic and configured at the tenant level.
  */
 export declare class Web3Manager {
     private apiClient;
     private web3ApplicationService;
     private web3ChainService;
-    constructor(apiClient: PersApiClient);
+    private tenantManager;
+    constructor(apiClient: PersApiClient, tenantManager?: TenantManager);
     /**
      * Get token balance for a specific token
      *
@@ -66,29 +73,20 @@ export declare class Web3Manager {
      * @returns Promise resolving to token collection
      */
     getTokenCollection(request: TokenCollectionRequest): Promise<TokenCollection>;
-    /**
-     * Resolve IPFS URL to accessible URL
-     *
-     * @param url - IPFS URL to resolve
-     * @param chainId - Chain ID for context
-     * @returns Promise resolving to accessible URL
-     */
-    resolveIPFSUrl(url: string, chainId: number): Promise<string>;
     /**
      * Fetch and process token metadata
      *
      * @param tokenUri - Token URI to fetch metadata from
-     * @param chainId - Chain ID for context
      * @returns Promise resolving to processed metadata or null if not found
      */
-    fetchAndProcessMetadata(tokenUri: string, chainId: number): Promise<TokenMetadata | null>;
+    fetchAndProcessMetadata(tokenUri: string): Promise<TokenMetadata | null>;
     /**
      * Get blockchain chain data by chain ID
      *
      * @param chainId - Chain ID to get data for
      * @returns Promise resolving to chain data or null if not found
      */
-    getChainDataById(chainId: number): Promise<ChainData | null>;
+    getChainDataById(chainId: number): Promise<ChainDataDTO | null>;
     /**
      * Get explorer URL for a given address or transaction
      *
@@ -150,7 +148,7 @@ export declare class Web3Manager {
      *
      * @param accountAddress - Any valid blockchain address (wallet, contract, etc.)
      * @param token - Token definition (from getRewardTokens, getStatusTokens, etc.)
-     * @param maxTokens - Maximum tokens to retrieve (default: 50)
+     * @param maxTokens - Maximum tokens to retrieve (default: 100, max: 100)
      * @returns Promise resolving to collection result with owned tokens
      *
      * @example Query user's wallet

package/dist/managers/web3-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web3-manager.d.ts","sourceRoot":"","sources":["../../src/managers/web3-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAItF,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,wBAAwB,EACzB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,WAAW;IAYV,OAAO,CAAC,SAAS;IAX7B,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,gBAAgB,CAAmB;gBAUvB,SAAS,EAAE,aAAa;IAW5C;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI1E;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAInF;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAInF;;;;;;OAMG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAInE;;;;;;OAMG;IACG,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAI/F;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIlE;;;;;;;OAOG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,GAAG,IAAI,GACrB,OAAO,CAAC,MAAM,CAAC;IASlB;;;;OAIG;IACH,yBAAyB,IAAI,sBAAsB;IAQnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,GAAG,SAAS;IAOtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,iCAAiC,CACrC,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,QAAQ,EACf,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,wBAAwB,CAAC;IAiCpC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,sBAAsB,CACpB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,QAAQ,EACf,SAAS,GAAE,MAAW,GACrB,sBAAsB;CAU1B"}
+{"version":3,"file":"web3-manager.d.ts","sourceRoot":"","sources":["../../src/managers/web3-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAItF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,wBAAwB,EACzB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,WAAW;IAaV,OAAO,CAAC,SAAS;IAZ7B,OAAO,CAAC,sBAAsB,CAAyB;IACvD,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAgB;gBAUjB,SAAS,EAAE,aAAa,EAAE,aAAa,CAAC,EAAE,aAAa;IAc3E;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAI1E;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAInF;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAInF;;;;;OAKG;IACG,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAI9E;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAIrE;;;;;;;OAOG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,GAAG,IAAI,GACrB,OAAO,CAAC,MAAM,CAAC;IASlB;;;;OAIG;IACH,yBAAyB,IAAI,sBAAsB;IAQnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,GAAG,SAAS;IAOtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,iCAAiC,CACrC,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,QAAQ,EACf,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,wBAAwB,CAAC;IAiCpC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,sBAAsB,CACpB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,QAAQ,EACf,SAAS,GAAE,MAAW,GACrB,sBAAsB;CAU1B"}

package/dist/managers/webhook-manager.d.ts

@@ -0,0 +1,237 @@
+import { PaginatedResponseDTO, WebhookDTO, WebhookCreateRequestDTO, WebhookUpdateRequestDTO, WebhookExecutionDTO, WebhookTriggerResponseDTO } from '@explorins/pers-shared';
+import { PersApiClient } from '../core/pers-api-client';
+import { PersEventEmitter } from '../core/events';
+import { WebhookService, WebhookQueryOptions, WebhookExecutionQueryOptions } from '../webhook';
+/**
+ * Webhook Manager - Clean, high-level interface for webhook operations
+ *
+ * Webhooks enable integration with external systems (n8n, Zapier, custom backends):
+ * - **Admin operations**: Create, configure, and manage webhook endpoints
+ * - **Trigger operations**: Programmatically trigger webhooks with payloads
+ * - **Async workflows**: Wait for callbacks from workflow systems
+ * - **Monitoring**: Track execution history
+ *
+ * ## Security Model
+ * - Admin endpoints require tenant authentication
+ * - Trigger endpoints work with user/business/tenant auth
+ * - Caller identity is passed to webhook target
+ *
+ * @group Managers
+ * @category Webhook Management
+ *
+ * @example Basic Webhook Operations
+ * ```typescript
+ * // Admin: Create a webhook for order processing
+ * const webhook = await sdk.webhooks.create({
+ *   name: 'Process Order',
+ *   targetUrl: 'https://n8n.example.com/webhook/orders',
+ *   method: 'POST',
+ *   headers: { 'X-Custom-Header': 'value' }
+ * });
+ *
+ * // Trigger webhook with order data
+ * const result = await sdk.webhooks.trigger(webhook.id, {
+ *   orderId: 'order-123',
+ *   items: [{ productId: 'prod-1', quantity: 2 }]
+ * });
+ *
+ * console.log('Execution ID:', result.executionId);
+ * ```
+ *
+ * @example Async Workflow with Callback
+ * ```typescript
+ * // Trigger and wait for workflow completion (up to 30s)
+ * const result = await sdk.webhooks.triggerAndWait(
+ *   'ai-processing-webhook',
+ *   { prompt: 'Generate report for Q1' },
+ *   30000
+ * );
+ *
+ * if (result.status === 'COMPLETED') {
+ *   console.log('AI Response:', result.body);
+ * }
+ * ```
+ */
+export declare class WebhookManager {
+    private apiClient;
+    private projectKey;
+    private events?;
+    private webhookService;
+    constructor(apiClient: PersApiClient, projectKey: string, events?: PersEventEmitter | undefined);
+    /**
+     * Get all webhooks with optional filters (Admin)
+     *
+     * @param options - Filter and pagination options
+     * @returns Promise resolving to paginated webhooks
+     *
+     * @example
+     * ```typescript
+     * // Get all webhooks
+     * const webhooks = await sdk.webhooks.getAll();
+     *
+     * // Get only active webhooks
+     * const active = await sdk.webhooks.getAll({ active: true });
+     *
+     * // Search by name
+     * const found = await sdk.webhooks.getAll({ search: 'order' });
+     * ```
+     */
+    getAll(options?: WebhookQueryOptions): Promise<PaginatedResponseDTO<WebhookDTO>>;
+    /**
+     * Get active webhooks only (Admin)
+     */
+    getActive(): Promise<PaginatedResponseDTO<WebhookDTO>>;
+    /**
+     * Get webhook by ID (Admin)
+     *
+     * @param webhookId - UUID of the webhook
+     * @returns Promise resolving to webhook details
+     */
+    getById(webhookId: string): Promise<WebhookDTO>;
+    /**
+     * Create a new webhook (Admin)
+     *
+     * @param webhook - Webhook configuration
+     * @returns Promise resolving to created webhook
+     *
+     * @example
+     * ```typescript
+     * const webhook = await sdk.webhooks.create({
+     *   name: 'Order Notifications',
+     *   targetUrl: 'https://api.example.com/webhooks/orders',
+     *   method: 'POST',
+     *   headers: {
+     *     'Authorization': 'Bearer secret-token'
+     *   },
+     *   rateLimitPerMinute: 60
+     * });
+     * ```
+     */
+    create(webhook: WebhookCreateRequestDTO): Promise<WebhookDTO>;
+    /**
+     * Update a webhook (Admin)
+     *
+     * @param webhookId - UUID of the webhook to update
+     * @param webhook - Updated configuration (partial)
+     * @returns Promise resolving to updated webhook
+     */
+    update(webhookId: string, webhook: WebhookUpdateRequestDTO): Promise<WebhookDTO>;
+    /**
+     * Enable a webhook (Admin)
+     */
+    enable(webhookId: string): Promise<WebhookDTO>;
+    /**
+     * Disable a webhook (Admin)
+     */
+    disable(webhookId: string): Promise<WebhookDTO>;
+    /**
+     * Delete a webhook (Admin)
+     *
+     * @param webhookId - UUID of the webhook to delete
+     * @returns Promise resolving to deletion confirmation
+     */
+    delete(webhookId: string): Promise<{
+        message: string;
+        hookId: string;
+    }>;
+    /**
+     * Trigger a webhook with GET method
+     *
+     * Sends a GET request through the webhook proxy. Returns the full response
+     * including execution metadata and raw data from the target.
+     *
+     * @param hookId - Webhook ID to trigger
+     * @param queryParams - Optional query parameters
+     * @returns Promise resolving to trigger response with metadata and data
+     *
+     * @example
+     * ```typescript
+     * // Fetch data from external API via webhook proxy
+     * const result = await sdk.webhooks.get('user-directory-webhook');
+     * console.log('Success:', result.success);
+     * console.log('Data:', result.data); // Raw data from target
+     * ```
+     */
+    get(hookId: string, queryParams?: Record<string, string>): Promise<WebhookTriggerResponseDTO>;
+    /**
+     * Trigger a webhook with POST method
+     *
+     * Sends data to the configured webhook target. The caller's identity
+     * (user/business/tenant) is included in the request context.
+     *
+     * @param hookId - Webhook ID to trigger
+     * @param body - Payload to send
+     * @returns Promise resolving to trigger response with execution metadata
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.webhooks.trigger('order-webhook', {
+     *   orderId: 'order-123',
+     *   action: 'created',
+     *   items: [...]
+     * });
+     *
+     * console.log('Success:', result.success);
+     * console.log('Execution ID:', result.executionId);
+     * console.log('Response:', result.data);
+     * ```
+     */
+    trigger(hookId: string, body: unknown): Promise<WebhookTriggerResponseDTO>;
+    /**
+     * Trigger a webhook and wait for async callback
+     *
+     * Use this for workflow systems (n8n, Zapier) that need time to process
+     * and return results via callback. The SDK will wait for the callback
+     * up to the specified timeout.
+     *
+     * @param hookId - Webhook ID to trigger
+     * @param body - Payload to send
+     * @param timeoutMs - Max time to wait for callback (default: 30s)
+     * @returns Promise resolving when callback received or timeout
+     *
+     * @example
+     * ```typescript
+     * // Trigger AI workflow and wait for result
+     * const result = await sdk.webhooks.triggerAndWait(
+     *   'ai-analysis-webhook',
+     *   { documentId: 'doc-123', analysisType: 'sentiment' },
+     *   60000 // Wait up to 60 seconds
+     * );
+     *
+     * if (result.success) {
+     *   console.log('Analysis:', result.data);
+     * }
+     * ```
+     */
+    triggerAndWait(hookId: string, body: unknown, timeoutMs?: number): Promise<WebhookTriggerResponseDTO>;
+    /**
+     * Get webhook execution history (Admin)
+     *
+     * @param options - Filter and pagination options
+     * @returns Promise resolving to paginated executions
+     *
+     * @example
+     * ```typescript
+     * // Get recent failed executions
+     * const failed = await sdk.webhooks.getExecutions({ status: 'FAILED' });
+     *
+     * // Get executions for specific webhook
+     * const executions = await sdk.webhooks.getExecutions({
+     *   webhookId: 'webhook-123',
+     *   fromDate: '2024-01-01'
+     * });
+     * ```
+     */
+    getExecutions(options?: WebhookExecutionQueryOptions): Promise<PaginatedResponseDTO<WebhookExecutionDTO>>;
+    /**
+     * Get execution details by ID (Admin)
+     */
+    getExecutionById(executionId: string): Promise<WebhookExecutionDTO>;
+    /**
+     * Get the full webhook service for advanced operations
+     *
+     * @returns WebhookService instance with full API access
+     */
+    getWebhookService(): WebhookService;
+}
+//# sourceMappingURL=webhook-manager.d.ts.map

package/dist/managers/webhook-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-manager.d.ts","sourceRoot":"","sources":["../../src/managers/webhook-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,UAAU,EACV,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAEL,cAAc,EACd,mBAAmB,EACnB,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,qBAAa,cAAc;IAIvB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM,CAAC;IALjB,OAAO,CAAC,cAAc,CAAiB;gBAG7B,SAAS,EAAE,aAAa,EACxB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,8BAAkB;IAUnC;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAItF;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAI5D;;;;;OAKG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIrD;;;;;;;;;;;;;;;;;;OAkBG;IACG,MAAM,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC;IAanE;;;;;;OAMG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC;IAatF;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpD;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIrD;;;;;OAKG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAiB7E;;;;;;;;;;;;;;;;;OAiBG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAInG;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAahF;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC,yBAAyB,CAAC;IAQrC;;;;;;;;;;;;;;;;;OAiBG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,4BAA4B,GAAG,OAAO,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAI/G;;OAEG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIzE;;;;OAIG;IACH,iBAAiB,IAAI,cAAc;CAGpC"}

package/dist/node.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var persSdk = require('./chunks/pers-sdk-Bheg5mKX.cjs');
+var persSdk = require('./chunks/pers-sdk-Cv7hM1I7.cjs');
 var persShared = require('@explorins/pers-shared');
 var nodeHttpClient = require('./chunks/node-http-client-D_avaa5F.cjs');
-require('./chunks/index-B-g2JPVK.cjs');
+require('./chunks/index-CGaKfZNU.cjs');
 require('./user.cjs');
 require('./chunks/pagination-utils-B2jRHMSO.cjs');
 require('./user-status.cjs');
@@ -11,8 +11,9 @@ require('./chunks/token-service-C1xe11OX.cjs');
 require('./chunks/business-membership-service-BfHzIQlc.cjs');
 require('./campaign.cjs');
 require('./chunks/redemption-service-C61Qr2vI.cjs');
-require('./chunks/transaction-request.builder-Bjxi0C9F.cjs');
+require('./chunks/transaction-request.builder-CW3Wwdi3.cjs');
 require('./chunks/payment-service-Bkw7ZXev.cjs');
+require('./chunks/tenant-manager-BUiFM33X.cjs');
 require('./chunks/tenant-service-fj-pkXTw.cjs');
 require('./chunks/analytics-service-CF9AsMQH.cjs');
 require('./donation.cjs');

package/dist/node.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"node.cjs","sources":["../src/node.ts"],"sourcesContent":[null],"names":["NodeHttpClientAdapter","StaticJwtAuthProvider","AccountOwnerType","PersSDK"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;AAkBG;AAQH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCG;AACG,SAAU,aAAa,CAAC,OAK7B,EAAA;AACC,IAAA,MAAM,UAAU,GAAG,IAAIA,oCAAqB,EAAE;AAC9C,IAAA,MAAM,YAAY,GAAG,IAAIC,6BAAqB,CAAC;QAC7C,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU,EAAE,OAAO,CAAC,UAAU;AAC9B,QAAA,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAIC,2BAAgB,CAAC;AAChD,KAAA,CAAC;AAEF,IAAA,OAAO,IAAIC,eAAO,CAAC,UAAU,EAAE;AAC7B,QAAA,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,YAAY;QAChD,aAAa,EAAE,OAAO,CAAC,UAAU;QACjC;AACD,KAAA,CAAC;AACJ;;;;;;;;;"}
+{"version":3,"file":"node.cjs","sources":["../src/node.ts"],"sourcesContent":[null],"names":["NodeHttpClientAdapter","StaticJwtAuthProvider","AccountOwnerType","PersSDK"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;AAkBG;AAQH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCG;AACG,SAAU,aAAa,CAAC,OAK7B,EAAA;AACC,IAAA,MAAM,UAAU,GAAG,IAAIA,oCAAqB,EAAE;AAC9C,IAAA,MAAM,YAAY,GAAG,IAAIC,6BAAqB,CAAC;QAC7C,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU,EAAE,OAAO,CAAC,UAAU;AAC9B,QAAA,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAIC,2BAAgB,CAAC;AAChD,KAAA,CAAC;AAEF,IAAA,OAAO,IAAIC,eAAO,CAAC,UAAU,EAAE;AAC7B,QAAA,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,YAAY;QAChD,aAAa,EAAE,OAAO,CAAC,UAAU;QACjC;AACD,KAAA,CAAC;AACJ;;;;;;;;;"}

package/dist/node.js

@@ -1,8 +1,8 @@
-import { j as StaticJwtAuthProvider, P as PersSDK } from './chunks/pers-sdk-CJo4CCTG.js';
+import { k as StaticJwtAuthProvider, P as PersSDK } from './chunks/pers-sdk-BiP7UMJ3.js';
 import { AccountOwnerType } from '@explorins/pers-shared';
 export { AccountOwnerType } from '@explorins/pers-shared';
 import { N as NodeHttpClientAdapter } from './chunks/node-http-client-DloDLfm9.js';
-import './chunks/index-CKm_V5XE.js';
+import './chunks/index-DgTEdUgC.js';
 import './user.js';
 import './chunks/pagination-utils-9vQ-Npkr.js';
 import './user-status.js';
@@ -10,8 +10,9 @@ import './chunks/token-service-BxEO5YVN.js';
 import './chunks/business-membership-service-CFa-TI39.js';
 import './campaign.js';
 import './chunks/redemption-service-C_UTTDag.js';
-import './chunks/transaction-request.builder-DGTxGvc3.js';
+import './chunks/transaction-request.builder-C3C19kCx.js';
 import './chunks/payment-service-IvM6rryM.js';
+import './chunks/tenant-manager-Bbj0bKoo.js';
 import './chunks/tenant-service-CsRA3O2V.js';
 import './chunks/analytics-service-vm7B7LhS.js';
 import './donation.js';

package/dist/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sources":["../src/node.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;AAkBG;AAQH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCG;AACG,SAAU,aAAa,CAAC,OAK7B,EAAA;AACC,IAAA,MAAM,UAAU,GAAG,IAAI,qBAAqB,EAAE;AAC9C,IAAA,MAAM,YAAY,GAAG,IAAI,qBAAqB,CAAC;QAC7C,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU,EAAE,OAAO,CAAC,UAAU;AAC9B,QAAA,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAC;AAChD,KAAA,CAAC;AAEF,IAAA,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE;AAC7B,QAAA,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,YAAY;QAChD,aAAa,EAAE,OAAO,CAAC,UAAU;QACjC;AACD,KAAA,CAAC;AACJ;;;;"}
+{"version":3,"file":"node.js","sources":["../src/node.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;AAkBG;AAQH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCG;AACG,SAAU,aAAa,CAAC,OAK7B,EAAA;AACC,IAAA,MAAM,UAAU,GAAG,IAAI,qBAAqB,EAAE;AAC9C,IAAA,MAAM,YAAY,GAAG,IAAI,qBAAqB,CAAC;QAC7C,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,UAAU,EAAE,OAAO,CAAC,UAAU;AAC9B,QAAA,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAC;AAChD,KAAA,CAAC;AAEF,IAAA,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE;AAC7B,QAAA,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,YAAY;QAChD,aAAa,EAAE,OAAO,CAAC,UAAU;QACjC;AACD,KAAA,CAAC;AACJ;;;;"}

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-sdk",
-  "version": "2.1.11",
+  "version": "2.1.15",
   "description": "Platform-agnostic SDK for PERS (Phygital Experience Rewards System) - Core business logic and API integration",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -132,8 +132,9 @@
     "publish-with-docs": "npm run clean && npm run build && npm run docs && npm version patch && npm publish"
   },
   "dependencies": {
-    "@explorins/pers-shared": "^2.1.100",
+    "@explorins/pers-shared": "^2.1.117",
     "@explorins/web3-ts": "^0.3.77",
+    "@explorins/web3-types": "^1.2.0",
     "ethers": "^6.15.0"
   },
   "devDependencies": {

package/dist/pers-sdk.d.ts

@@ -170,7 +170,8 @@ import { PersConfig } from './core/pers-config';
 import { PersApiClient } from './core/pers-api-client';
 import { PersEventEmitter } from './core/events';
 import { UserDTO } from '@explorins/pers-shared';
-import { AuthManager, UserManager, UserStatusManager, TokenManager, BusinessManager, CampaignManager, RedemptionManager, TransactionManager, PurchaseManager, FileManager, TenantManager, ApiKeyManager, AnalyticsManager, DonationManager, TriggerSourceManager } from './managers';
+import { AuthManager, UserManager, UserStatusManager, TokenManager, BusinessManager, CampaignManager, RedemptionManager, TransactionManager, PurchaseManager, FileManager, TenantManager, ApiKeyManager, AnalyticsManager, DonationManager, TriggerSourceManager, WebhookManager, WalletEventsManager } from './managers';
+import type { WalletEventsConfig } from './managers';
 /**
  * PERS SDK - Main SDK class with domain managers
  *
@@ -246,6 +247,9 @@ export declare class PersSDK {
     private _analytics?;
     private _donations?;
     private _triggerSources?;
+    private _webhooks?;
+    private _walletEvents?;
+    private walletEventsConfig?;
     /**
      * Creates a new PERS SDK instance
      *
@@ -289,6 +293,29 @@ export declare class PersSDK {
      * ```
      */
     constructor(httpClient: HttpClient, config: PersConfig);
+    /**
+     * Setup auto-connect for wallet events on authentication
+     * @internal
+     */
+    private setupWalletEventsAutoConnect;
+    /**
+     * Connect to wallet events and auto-subscribe based on auth type
+     *
+     * Connects to the WebSocket relay and automatically subscribes to relevant
+     * blockchain events based on the current authentication type:
+     * - **USER**: Subscribes to all user's wallets
+     * - **BUSINESS**: Subscribes to all business's wallets
+     * - **TENANT**: Subscribes to all chains where tokens are deployed
+     *
+     * This method is called automatically on login when `captureWalletEvents` is enabled.
+     * Call manually if you need to reconnect or refresh subscriptions.
+     *
+     * @example Manual connection
+     * ```typescript
+     * await sdk.connectWalletEvents();
+     * ```
+     */
+    connectWalletEvents(): Promise<void>;
     /**
      * Restore user session from stored tokens
      *
@@ -578,6 +605,88 @@ export declare class PersSDK {
      * ```
      */
     get triggerSources(): TriggerSourceManager;
+    /**
+     * Webhook manager - High-level webhook operations
+     *
+     * Provides methods for creating webhooks, triggering them programmatically,
+     * and monitoring execution history. Supports async workflows with callbacks.
+     *
+     * @returns WebhookManager instance
+     *
+     * @example Webhook Operations
+     * ```typescript
+     * // Admin: Create a webhook
+     * const webhook = await sdk.webhooks.create({
+     *   name: 'Order Processing',
+     *   targetUrl: 'https://n8n.example.com/webhook/orders',
+     *   method: 'POST'
+     * });
+     *
+     * // Trigger webhook with payload
+     * const result = await sdk.webhooks.trigger(webhook.id, {
+     *   orderId: 'order-123',
+     *   action: 'created'
+     * });
+     *
+     * // Trigger and wait for async workflow completion
+     * const asyncResult = await sdk.webhooks.triggerAndWait(
+     *   'ai-webhook',
+     *   { prompt: 'Analyze this data' },
+     *   30000  // Wait up to 30s
+     * );
+     * ```
+     *
+     * @see {@link WebhookManager} for detailed documentation
+     */
+    get webhooks(): WebhookManager;
+    /**
+     * Wallet Events Manager - Real-time blockchain events for user's wallets
+     *
+     * Provides real-time WebSocket connection to receive blockchain events
+     * for the user's wallets (transfers, approvals, NFT mints, etc.).
+     *
+     * Events are also routed through `sdk.events` for unified event handling.
+     *
+     * **Important:** Requires `walletEventsWsUrl` configuration and authentication.
+     *
+     * @returns WalletEventsManager instance
+     *
+     * @example Basic Usage
+     * ```typescript
+     * // Configure SDK with events URL
+     * sdk.configureWalletEvents({ wsUrl: 'wss://events.pers.ninja' });
+     *
+     * // Connect after authentication
+     * await sdk.auth.loginWithToken(jwt, 'user');
+     * await sdk.walletEvents.connect();
+     *
+     * // Listen for token transfers
+     * sdk.walletEvents.on('Transfer', (event) => {
+     *   if (event.data.to === myWallet) {
+     *     showNotification(`Received ${event.data.value} tokens!`);
+     *   }
+     * });
+     * ```
+     *
+     * @example Unified Event Stream
+     * ```typescript
+     * // Wallet events also flow through sdk.events
+     * sdk.events.subscribe((event) => {
+     *   if (event.domain === 'wallet') {
+     *     console.log('Wallet event:', event.type);
+     *   }
+     * });
+     * ```
+     *
+     * @see {@link WalletEventsManager} for detailed documentation
+     */
+    get walletEvents(): WalletEventsManager;
+    /**
+     * Configure wallet events (call before accessing walletEvents)
+     *
+     * @param config - Events configuration including wsUrl
+     */
+    configureWalletEvents(config: WalletEventsConfig): void;
     /**
      * Gets the API client for direct PERS API requests
      *

package/dist/pers-sdk.d.ts.map

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

package/dist/transaction/index.d.ts

@@ -8,6 +8,6 @@ export { TransactionApi } from './api/transaction-api';
 export { TransactionService } from './services/transaction-service';
 export type { TransactionQueryOptions, POSAuthorizationOptions } from './models';
 export { buildMintRequest, buildBurnRequest, buildTransferRequest, buildPOSTransferRequest, buildPOSBurnRequest, buildSubmissionRequest } from './models';
-export { ClientTransactionType, extractDeadlineFromSigningData, buildPendingTransactionData, needsExternalSigning, getSigningUrl, } from './models/transaction-request.builder';
+export { ClientTransactionType, extractDeadlineFromSigningData, buildPendingTransactionData, needsExternalSigning, needsSubmission, getSigningUrl, } from './models/transaction-request.builder';
 export type { ClientTransactionType as ClientTransactionTypeEnum, PendingTransactionParams } from './models/transaction-request.builder';
 //# sourceMappingURL=index.d.ts.map

package/dist/transaction/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transaction/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGpE,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAG1J,OAAO,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,2BAA2B,EAC3B,oBAAoB,EACpB,aAAa,GACd,MAAM,sCAAsC,CAAC;AAE9C,YAAY,EACV,qBAAqB,IAAI,yBAAyB,EAClD,wBAAwB,EACzB,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transaction/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGpE,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAG1J,OAAO,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,2BAA2B,EAC3B,oBAAoB,EACpB,eAAe,EACf,aAAa,GACd,MAAM,sCAAsC,CAAC;AAE9C,YAAY,EACV,qBAAqB,IAAI,yBAAyB,EAClD,wBAAwB,EACzB,MAAM,sCAAsC,CAAC"}

package/dist/transaction/models/transaction-request.builder.d.ts

@@ -15,6 +15,22 @@ import { TransactionRequestDTO, Web3TransactionType, AccountOwnerType, Transacti
  * ```
  */
 export declare function needsExternalSigning(response: TransactionRequestResponseDTO | null | undefined): boolean;
+/**
+ * 🔍 Check if a transaction response is signed and ready for submission
+ *
+ * Returns true when the user has signed the transaction and it's waiting
+ * to be submitted to the blockchain (typically by a business in POS flows).
+ *
+ * @example
+ * ```typescript
+ * const response = await sdk.transactions.getTransaction(transactionId);
+ * if (needsSubmission(response)) {
+ *   // Transaction is signed, ready to submit
+ *   await sdk.transactions.submitSignedTransaction({ ... });
+ * }
+ * ```
+ */
+export declare function needsSubmission(response: TransactionRequestResponseDTO | null | undefined): boolean;
 /**
  * 🔗 Get the signing URL from a transaction response
  *

package/dist/transaction/models/transaction-request.builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-request.builder.d.ts","sourceRoot":"","sources":["../../../src/transaction/models/transaction-request.builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transaction-request.builder.d.ts","sourceRoot":"","sources":["../../../src/transaction/models/transaction-request.builder.ts"],"names":[],"mappings":"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"}

package/dist/transaction.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var transactionRequest_builder = require('./chunks/transaction-request.builder-Bjxi0C9F.cjs');
+var transactionRequest_builder = require('./chunks/transaction-request.builder-CW3Wwdi3.cjs');
 require('@explorins/pers-shared');
 require('./chunks/pagination-utils-B2jRHMSO.cjs');
 
@@ -19,4 +19,5 @@ exports.buildTransferRequest = transactionRequest_builder.buildTransferRequest;
 exports.extractDeadlineFromSigningData = transactionRequest_builder.extractDeadlineFromSigningData;
 exports.getSigningUrl = transactionRequest_builder.getSigningUrl;
 exports.needsExternalSigning = transactionRequest_builder.needsExternalSigning;
+exports.needsSubmission = transactionRequest_builder.needsSubmission;
 //# sourceMappingURL=transaction.cjs.map

package/dist/transaction.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"transaction.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;"}

package/dist/transaction.js

@@ -1,4 +1,4 @@
-export { C as ClientTransactionType, T as TransactionApi, a as TransactionService, c as buildBurnRequest, b as buildMintRequest, f as buildPOSBurnRequest, e as buildPOSTransferRequest, i as buildPendingTransactionData, g as buildSubmissionRequest, d as buildTransferRequest, h as extractDeadlineFromSigningData, j as getSigningUrl, n as needsExternalSigning } from './chunks/transaction-request.builder-DGTxGvc3.js';
+export { C as ClientTransactionType, T as TransactionApi, a as TransactionService, c as buildBurnRequest, b as buildMintRequest, f as buildPOSBurnRequest, e as buildPOSTransferRequest, i as buildPendingTransactionData, g as buildSubmissionRequest, d as buildTransferRequest, h as extractDeadlineFromSigningData, k as getSigningUrl, n as needsExternalSigning, j as needsSubmission } from './chunks/transaction-request.builder-C3C19kCx.js';
 import '@explorins/pers-shared';
 import './chunks/pagination-utils-9vQ-Npkr.js';
 //# sourceMappingURL=transaction.js.map