@johnqh/indexer_client 0.0.1

package/dist/utils/indexer-webhooks.d.ts

@@ -0,0 +1,60 @@
+import type { NetworkClient } from '@johnqh/di';
+export interface IndexerWebhookConfig {
+    indexerBackendUrl: string;
+    networkClient: NetworkClient;
+}
+export interface WebhookEmailSent {
+    senderAddress: string;
+    recipientAddress: string;
+    emailId: string;
+    chainId?: number;
+}
+export interface WebhookRecipientLogin {
+    recipientAddress: string;
+}
+export interface WebhookReferralRegistration {
+    referrerAddress: string;
+    refereeAddress: string;
+    referralCode?: string;
+    source?: string;
+}
+export interface WebhookLoginEvent {
+    walletAddress: string;
+    signature: string;
+    message?: string;
+    refer?: string;
+    referralCode?: string;
+}
+export interface WebhookLoginResult {
+    message: string;
+    walletAddress: string;
+    results: {
+        recipientLogin: boolean;
+        referralBonus: boolean;
+        referralRegistration: boolean;
+        pointsAwarded: number;
+    };
+}
+export interface WebhookResponse {
+    success: boolean;
+    data: {
+        message: string;
+    };
+}
+export declare class IndexerWebhookHelper {
+    private config;
+    private client;
+    constructor(config: IndexerWebhookConfig);
+    processEmailSent(emailData: WebhookEmailSent): Promise<WebhookResponse>;
+    processRecipientLogin(loginData: WebhookRecipientLogin): Promise<WebhookResponse>;
+    registerReferral(referralData: WebhookReferralRegistration): Promise<WebhookResponse>;
+    processRefereeLogin(walletAddress: string, signature: string, message?: string): Promise<WebhookResponse>;
+    processLogin(loginData: WebhookLoginEvent): Promise<WebhookLoginResult>;
+    processSolanaWebhook(transactions: unknown[]): Promise<{
+        success: boolean;
+        processed: number;
+        total: number;
+    }>;
+}
+export declare const createIndexerWebhookHelper: (indexerBackendUrl: string, networkClient: NetworkClient) => IndexerWebhookHelper;
+//# sourceMappingURL=indexer-webhooks.d.ts.map

package/dist/utils/indexer-webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer-webhooks.d.ts","sourceRoot":"","sources":["../../src/utils/indexer-webhooks.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE;QACP,cAAc,EAAE,OAAO,CAAC;QACxB,aAAa,EAAE,OAAO,CAAC;QACvB,oBAAoB,EAAE,OAAO,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAUD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,oBAAoB;IAQlC,gBAAgB,CACpB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,eAAe,CAAC;IAoBrB,qBAAqB,CACzB,SAAS,EAAE,qBAAqB,GAC/B,OAAO,CAAC,eAAe,CAAC;IAoBrB,gBAAgB,CACpB,YAAY,EAAE,2BAA2B,GACxC,OAAO,CAAC,eAAe,CAAC;IAoBrB,mBAAmB,CACvB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,CAAC;IAwBrB,YAAY,CAChB,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,kBAAkB,CAAC;IAoBxB,oBAAoB,CAAC,YAAY,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAC3D,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CAmBH;AAKD,eAAO,MAAM,0BAA0B,GACrC,mBAAmB,MAAM,EACzB,eAAe,aAAa,KAC3B,oBAKF,CAAC"}

package/dist/utils/indexer-webhooks.js

@@ -0,0 +1,68 @@
+const getIndexerBaseUrl = (config) => {
+    return config.indexerBackendUrl;
+};
+export class IndexerWebhookHelper {
+    constructor(config) {
+        this.config = config;
+        this.client = config.networkClient;
+    }
+    async processEmailSent(emailData) {
+        const response = await this.client.post(`${getIndexerBaseUrl(this.config)}/webhook/email-sent`, emailData);
+        if (!response.ok) {
+            throw new Error(response.data?.error ||
+                `HTTP error! status: ${response.status}`);
+        }
+        return response.data;
+    }
+    async processRecipientLogin(loginData) {
+        const response = await this.client.post(`${getIndexerBaseUrl(this.config)}/webhook/recipient-login`, loginData);
+        if (!response.ok) {
+            throw new Error(response.data?.error ||
+                `HTTP error! status: ${response.status}`);
+        }
+        return response.data;
+    }
+    async registerReferral(referralData) {
+        const response = await this.client.post(`${getIndexerBaseUrl(this.config)}/points/register-referral`, referralData);
+        if (!response.ok) {
+            throw new Error(response.data?.error ||
+                `HTTP error! status: ${response.status}`);
+        }
+        return response.data;
+    }
+    async processRefereeLogin(walletAddress, signature, message) {
+        const response = await this.client.post(`${getIndexerBaseUrl(this.config)}/points/referee-login`, {
+            walletAddress,
+            signature,
+            message,
+        });
+        if (!response.ok) {
+            throw new Error(response.data?.error ||
+                `HTTP error! status: ${response.status}`);
+        }
+        return response.data;
+    }
+    async processLogin(loginData) {
+        const response = await this.client.post(`${getIndexerBaseUrl(this.config)}/webhook/login`, loginData);
+        if (!response.ok) {
+            throw new Error(response.data?.error ||
+                `HTTP error! status: ${response.status}`);
+        }
+        return response.data.data;
+    }
+    async processSolanaWebhook(transactions) {
+        const response = await this.client.post(`${getIndexerBaseUrl(this.config)}/solana/webhook`, transactions);
+        if (!response.ok) {
+            throw new Error(response.data?.error ||
+                `HTTP error! status: ${response.status}`);
+        }
+        return response.data;
+    }
+}
+export const createIndexerWebhookHelper = (indexerBackendUrl, networkClient) => {
+    return new IndexerWebhookHelper({
+        indexerBackendUrl,
+        networkClient,
+    });
+};
+//# sourceMappingURL=indexer-webhooks.js.map

package/dist/utils/indexer-webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer-webhooks.js","sourceRoot":"","sources":["../../src/utils/indexer-webhooks.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@johnqh/indexer_client",
+  "version": "0.0.1",
+  "description": "React and React Native compatible client library for 0xMail indexer API with TypeScript support",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest --watch",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:integration:watch": "vitest --config vitest.integration.config.ts",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "format": "prettier --write src/**/*.ts",
+    "format:check": "prettier --check src/**/*.ts",
+    "typecheck": "tsc --noEmit",
+    "typecheck:watch": "tsc --noEmit --watch",
+    "check-all": "npm run lint && npm run typecheck && npm run test:run"
+  },
+  "keywords": [
+    "indexer",
+    "client",
+    "react",
+    "react-native",
+    "typescript",
+    "0xmail"
+  ],
+  "author": "John Huang",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": "^19.2.0"
+  },
+  "dependencies": {
+    "@johnqh/di": "^1.3.19",
+    "@johnqh/types": "^1.8.14",
+    "@tanstack/react-query": "^5.90.2",
+    "axios": "^1.12.2"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.0",
+    "@types/node": "^24.7.0",
+    "@types/react": "^19.2.2",
+    "@typescript-eslint/eslint-plugin": "^8.46.0",
+    "@typescript-eslint/parser": "^8.46.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "dotenv": "^17.2.3",
+    "eslint": "^9.37.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^6.1.1",
+    "happy-dom": "^19.0.2",
+    "prettier": "^3.6.2",
+    "typescript": "^5.9.3",
+    "vite": "^7.1.9",
+    "vitest": "^3.2.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/johnqh/mail_box_indexer_client.git"
+  }
+}