@explorins/pers-sdk-react-native 1.3.2 → 1.5.2

package/package.json

@@ -1,157 +1,177 @@
-{
-  "name": "@explorins/pers-sdk-react-native",
-  "version": "1.3.2",
-  "description": "React Native SDK for PERS Platform - Tourism Loyalty System",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "tsc && rollup -c --bundleConfigAsCjs",
-    "dev": "tsc --watch",
-    "clean": "rimraf dist",
-    "prepublishOnly": "npm run clean && npm run build"
-  },
-  "keywords": [
-    "pers",
-    "sdk",
-    "react-native",
-    "tourism",
-    "loyalty",
-    "blockchain",
-    "web3"
-  ],
-  "author": "eXplorins",
-  "license": "MIT",
-  "dependencies": {
-    "@explorins/pers-sdk": "^1.3.2",
-    "@explorins/pers-shared": "^2.1.40",
-    "buffer": "^6.0.3",
-    "ethers": "^6.15.0",
-    "web3": "^4.16.0"
-  },
-  "browser": {
-    "crypto": false,
-    "url": false,
-    "http": false,
-    "https": false,
-    "zlib": false,
-    "stream": false,
-    "assert": false,
-    "path": false,
-    "fs": false,
-    "os": false,
-    "readable-stream": false,
-    "util": false,
-    "events": false,
-    "net": false,
-    "tls": false,
-    "child_process": false,
-    "pngjs": false,
-    "pngjs/lib/bitmapper": false,
-    "pngjs/lib/parser-async": false,
-    "pngjs/lib/parser-sync": false,
-    "./bitmapper": false,
-    "hash-base": false,
-    "@ethereumjs/common": false,
-    "@ethereumjs/tx": false,
-    "@ethereumjs/util": false,
-    "stream-browserify": false,
-    "crypto-browserify": false,
-    "inherits": false,
-    "safe-buffer": false,
-    "string_decoder": false,
-    "process-nextick-args": false,
-    "isarray": false,
-    "core-util-is": false,
-    "util-deprecate": false,
-    "ethereum-cryptography": false,
-    "keccak": false,
-    "secp256k1": false,
-    "scrypt-js": false,
-    "bech32": false,
-    "ws": false,
-    "xhr2-cookies": false,
-    "aes-js": false,
-    "@ethersproject/sha2": false,
-    "@ethersproject/pbkdf2": false,
-    "@ethersproject/scrypt": false
-  },
-  "peerDependencies": {
-    "react": ">=16.8.0",
-    "react-native": ">=0.60.0"
-  },
-  "peerDependenciesMeta": {
-    "react-native-keychain": {
-      "optional": true
-    },
-    "@react-native-async-storage/async-storage": {
-      "optional": false
-    },
-    "react-native-get-random-values": {
-      "optional": true
-    },
-    "react-native-url-polyfill": {
-      "optional": true
-    },
-    "react-native-polyfill-globals": {
-      "optional": true
-    },
-    "web-streams-polyfill": {
-      "optional": true
-    }
-  },
-  "overrides": {
-    "readable-stream": false,
-    "@ethereumjs/common": false,
-    "@ethereumjs/util": false,
-    "@ethereumjs/rlp": false,
-    "@ethereumjs/tx": false,
-    "stream": false,
-    "util": false,
-    "events": false,
-    "crypto": false,
-    "fs": false,
-    "path": false,
-    "os": false,
-    "net": false,
-    "tls": false,
-    "child_process": false,
-    "hash-base": false,
-    "inherits": false,
-    "safe-buffer": false,
-    "string_decoder": false,
-    "process-nextick-args": false,
-    "isarray": false,
-    "core-util-is": false,
-    "util-deprecate": false,
-    "ethereum-cryptography": false,
-    "keccak": false,
-    "secp256k1": false,
-    "scrypt-js": false,
-    "bech32": false,
-    "ws": false,
-    "xhr2-cookies": false,
-    "aes-js": false,
-    "@ethersproject/sha2": false,
-    "@ethersproject/pbkdf2": false,
-    "@ethersproject/scrypt": false
-  },
-  "devDependencies": {
-    "@react-native-async-storage/async-storage": "^1.19.0",
-    "@types/react": "^19.1.1",
-    "@types/react-native": "^0.72.8",
-    "rimraf": "^5.0.0",
-    "rollup": "^4.0.0",
-    "rollup-plugin-typescript2": "^0.36.0",
-    "typescript": "^5.2.0"
-  },
-  "files": [
-    "dist/**/*",
-    "src/**/*",
-    "README.md"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/eXplorins/pers-sdk.git",
-    "directory": "packages/pers-sdk-react-native"
-  }
-}
+{
+  "name": "@explorins/pers-sdk-react-native",
+  "version": "1.5.2",
+  "description": "React Native SDK for PERS Platform - Tourism Loyalty System with Manager Pattern Architecture",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc && rollup -c --bundleConfigAsCjs",
+    "build:watch": "rollup -c --bundleConfigAsCjs --watch",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist",
+    "docs": "typedoc",
+    "docs:dev": "typedoc --watch",
+    "docs:json": "typedoc --json docs/api.json",
+    "docs:serve": "npx http-server docs -p 8080",
+    "prepublishOnly": "npm run clean && npm run build",
+    "publish-version": "npm run clean && npm run build && npm version patch && npm publish",
+    "publish-with-docs": "npm run clean && npm run build && npm run docs && npm version patch && npm publish",
+    "yalc:publish": "npm version patch --no-git-tag-version && npm run build && yalc publish",
+    "yalc:push": "npm version patch --no-git-tag-version && npm run build && yalc push"
+  },
+  "keywords": [
+    "pers",
+    "sdk",
+    "react-native",
+    "tourism",
+    "loyalty",
+    "blockchain",
+    "web3"
+  ],
+  "author": "eXplorins",
+  "license": "MIT",
+  "dependencies": {
+    "@dfns/sdk": "^0.8.1",
+    "@dfns/sdk-react-native": "^0.8.1",
+    "@explorins/pers-sdk": "^1.6.3",
+    "@explorins/pers-shared": "^2.1.40",
+    "@explorins/pers-signer": "^1.0.6",
+    "@explorins/web3-ts": "^0.3.75",
+    "@react-native-async-storage/async-storage": "^2.2.0",
+    "buffer": "^6.0.3",
+    "ethers": "^6.15.0",
+    "react-native-get-random-values": "^2.0.0",
+    "react-native-keychain": "^10.0.0",
+    "typedoc": "^0.25.13",
+    "typedoc-plugin-markdown": "^3.17.1"
+  },
+  "browser": {
+    "crypto": false,
+    "url": false,
+    "http": false,
+    "https": false,
+    "zlib": false,
+    "stream": false,
+    "assert": false,
+    "path": false,
+    "fs": false,
+    "os": false,
+    "readable-stream": false,
+    "util": false,
+    "events": false,
+    "net": false,
+    "tls": false,
+    "child_process": false,
+    "pngjs": false,
+    "pngjs/lib/bitmapper": false,
+    "pngjs/lib/parser-async": false,
+    "pngjs/lib/parser-sync": false,
+    "./bitmapper": false,
+    "hash-base": false,
+    "@ethereumjs/common": false,
+    "@ethereumjs/tx": false,
+    "@ethereumjs/util": false,
+    "stream-browserify": false,
+    "crypto-browserify": false,
+    "inherits": false,
+    "safe-buffer": false,
+    "string_decoder": false,
+    "process-nextick-args": false,
+    "isarray": false,
+    "core-util-is": false,
+    "util-deprecate": false,
+    "ethereum-cryptography": false,
+    "keccak": false,
+    "secp256k1": false,
+    "scrypt-js": false,
+    "bech32": false,
+    "ws": false,
+    "xhr2-cookies": false,
+    "aes-js": false,
+    "@ethersproject/sha2": false,
+    "@ethersproject/pbkdf2": false,
+    "@ethersproject/scrypt": false
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-native": ">=0.60.0"
+  },
+  "peerDependenciesMeta": {
+    "react-native-keychain": {
+      "optional": true
+    },
+    "@react-native-async-storage/async-storage": {
+      "optional": false
+    },
+    "react-native-get-random-values": {
+      "optional": true
+    },
+    "react-native-url-polyfill": {
+      "optional": true
+    },
+    "react-native-polyfill-globals": {
+      "optional": true
+    },
+    "web-streams-polyfill": {
+      "optional": true
+    }
+  },
+  "overrides": {
+    "readable-stream": false,
+    "@ethereumjs/common": false,
+    "@ethereumjs/util": false,
+    "@ethereumjs/rlp": false,
+    "@ethereumjs/tx": false,
+    "stream": false,
+    "util": false,
+    "events": false,
+    "crypto": false,
+    "fs": false,
+    "path": false,
+    "os": false,
+    "net": false,
+    "tls": false,
+    "child_process": false,
+    "hash-base": false,
+    "inherits": false,
+    "safe-buffer": false,
+    "string_decoder": false,
+    "process-nextick-args": false,
+    "isarray": false,
+    "core-util-is": false,
+    "util-deprecate": false,
+    "ethereum-cryptography": false,
+    "keccak": false,
+    "secp256k1": false,
+    "scrypt-js": false,
+    "bech32": false,
+    "ws": false,
+    "xhr2-cookies": false,
+    "aes-js": false,
+    "@ethersproject/sha2": false,
+    "@ethersproject/pbkdf2": false,
+    "@ethersproject/scrypt": false
+  },
+  "devDependencies": {
+    "@react-native-async-storage/async-storage": "^1.19.0",
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@types/react": "^19.1.1",
+    "@types/react-native": "^0.72.8",
+    "rimraf": "^5.0.0",
+    "rollup": "^4.0.0",
+    "rollup-plugin-typescript2": "^0.36.0",
+    "typescript": "^5.2.0"
+  },
+  "files": [
+    "dist/**/*",
+    "src/**/*",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eXplorins/pers-sdk.git",
+    "directory": "packages/pers-sdk-react-native"
+  }
+}

package/src/hooks/index.ts

@@ -2,7 +2,19 @@
 export { useAuth } from './useAuth';
 export { useTokens } from './useTokens';
 export { useTransactions } from './useTransactions';
+export { useTransactionSigner } from './useTransactionSigner';
 export { useBusiness } from './useBusiness';
 export { useCampaigns } from './useCampaigns';
 export { useRedemptions } from './useRedemptions';
-export { useWeb3 } from './useWeb3';
+export { useWeb3 } from './useWeb3';
+export { usePurchases } from './usePurchases';
+export { useTenants } from './useTenants';
+export { useUsers } from './useUsers';
+export { useUserStatus } from './useUserStatus';
+export { useFiles } from './useFiles';
+export { useAnalytics } from './useAnalytics';
+export { useDonations } from './useDonations';
+
+// Re-export auth-related types for convenience
+export type { RawUserData } from './useAuth';
+export type { TransactionSignerHook, TransactionSigningResult } from './useTransactionSigner';

package/src/hooks/useAnalytics.ts

@@ -0,0 +1,150 @@
+import { useCallback } from 'react';
+import { usePersSDK } from '../providers/PersSDKProvider';
+
+// Import analytics types directly from core SDK
+interface TransactionAnalyticsFilters {
+  status?: string;
+  tokenType?: string;
+  triggerProcessType?: string;
+  tenantId?: string;
+  chainId?: number;
+  type?: string;
+  [key: string]: any;
+}
+
+type TransactionAnalyticsGroupBy = 
+  | 'month' | 'week' | 'day' | 'year' | 'quarter'
+  | 'tokenType' | 'status' | 'chainId' | 'triggerProcessType' | 'type'
+  | 'senderAddress' | 'recipientAddress' | 'senderId' | 'recipientId' | 'senderOwnerType' | 'recipientOwnerType' | 'createdAt';
+
+type TransactionAnalyticsMetric = 
+  | 'count' | 'sum' | 'avg' | 'min' | 'max';
+
+interface TransactionAnalyticsGroupByExpression {
+  expression: string;
+  alias: string;
+}
+
+/**
+ * Request DTO for transaction analytics
+ */
+interface TransactionAnalyticsRequestDTO {
+  filters?: TransactionAnalyticsFilters;
+  groupBy?: TransactionAnalyticsGroupBy[];
+  groupByExpressions?: TransactionAnalyticsGroupByExpression[];
+  metrics?: TransactionAnalyticsMetric[];
+  orderBy?: string;
+  orderDirection?: 'ASC' | 'DESC';
+  limit?: number;
+  startDate?: string;
+  endDate?: string;
+}
+
+interface TransactionAnalyticsResultItem {
+  [key: string]: string | number | Date | undefined;
+  count?: string;
+  sum?: number;
+  avg?: number;
+  min?: number;
+  max?: number;
+  tokentype?: string;
+  tokenType?: string;
+  year?: string;
+  month?: string;
+  type?: string;
+  senderaddress?: string;
+  senderAddress?: string;
+  recipientaddress?: string;
+  recipientAddress?: string;
+  triggerprocesstype?: string;
+  triggerProcessType?: string;
+  userid?: string;
+  userId?: string;
+}
+
+/**
+ * Response DTO for transaction analytics
+ */
+interface TransactionAnalyticsResponseDTO {
+  results: TransactionAnalyticsResultItem[];
+  totalGroups: number;
+  metadata: {
+    executionTime: string;
+  };
+}
+
+/**
+ * React hook for analytics operations in the PERS SDK
+ * 
+ * Provides methods for retrieving transaction analytics and insights.
+ * Supports various analytics queries for business intelligence and reporting.
+ * 
+ * @returns Analytics hook with methods for data analysis
+ * 
+ * @example
+ * ```typescript
+ * function AnalyticsComponent() {
+ *   const { getTransactionAnalytics } = useAnalytics();
+ *   
+ *   const loadAnalytics = async () => {
+ *     try {
+ *       const analytics = await getTransactionAnalytics({
+ *         timeRange: 'last_30_days',
+ *         groupBy: 'day'
+ *       });
+ *       console.log('Transaction analytics:', analytics);
+ *     } catch (error) {
+ *       console.error('Failed to load analytics:', error);
+ *     }
+ *   };
+ * 
+ *   return <button onClick={loadAnalytics}>Load Analytics</button>;
+ * }
+ * ```
+ */
+export const useAnalytics = () => {
+  const { sdk, isInitialized } = usePersSDK();
+
+  /**
+   * Retrieves transaction analytics data based on request parameters
+   * 
+   * @param request - Analytics request parameters (time range, grouping, filters, etc.)
+   * @returns Promise resolving to analytics data with results and metadata
+   * @throws Error if SDK is not initialized
+   * 
+   * @example
+   * ```typescript
+   * const { getTransactionAnalytics } = useAnalytics();
+   * const analytics = await getTransactionAnalytics({
+   *   groupBy: ['day'],
+   *   metrics: ['count', 'sum'],
+   *   startDate: '2024-01-01',
+   *   endDate: '2024-01-31',
+   *   filters: { status: 'completed' }
+   * });
+   * console.log('Daily transaction analytics:', analytics.results);
+   * console.log('Execution time:', analytics.metadata.executionTime);
+   * ```
+   */
+  const getTransactionAnalytics = useCallback(async (request: TransactionAnalyticsRequestDTO): Promise<TransactionAnalyticsResponseDTO> => {
+    if (!isInitialized || !sdk) {
+      throw new Error('SDK not initialized. Call initialize() first.');
+    }
+    
+    try {
+      const result = await sdk.analytics.getTransactionAnalytics(request);
+      console.log('Transaction analytics fetched successfully:', result);
+      return result;
+    } catch (error) {
+      console.error('Failed to fetch transaction analytics:', error);
+      throw error;
+    }
+  }, [sdk, isInitialized]);
+
+  return {
+    getTransactionAnalytics,
+    isAvailable: isInitialized && !!sdk?.analytics,
+  };
+};
+
+export type AnalyticsHook = ReturnType<typeof useAnalytics>;