questverify-cert-sdk 1.0.1

package/README.md

@@ -0,0 +1,122 @@
+# QuestVerify Certificate SDK
+
+Server-side SDK for QuestVerify blockchain certificate platform.
+
+## Installation
+
+```bash
+npm install @questverify/cert-sdk
+```
+
+## Quick Start
+
+```typescript
+import { CertSDK } from '@questverify/cert-sdk';
+
+const sdk = new CertSDK({
+  environment: 'sandbox', // or 'production'
+  clientId: 'your-client-id',
+  clientSecret: 'your-client-secret',
+  privateKey: 'your-secp256k1-private-key-hex', // 64 character hex string
+});
+
+// Upload PDF
+const result = await sdk.uploadPDF({
+  pdf: Buffer.from('...'), // or file path
+  filename: 'certificate.pdf',
+});
+
+console.log('Batch ID:', result.batchId);
+```
+
+## API Reference
+
+### Upload PDF
+
+```typescript
+await sdk.uploadPDF({
+  pdf: Buffer | string,
+  filename?: string,
+  metadata?: Record<string, any>,
+});
+```
+
+### Upload CSV
+
+```typescript
+await sdk.uploadCSV({
+  csv: Buffer | string,
+  templateId: string,
+  fieldMapping?: Record<string, string>,
+  filename?: string,
+});
+```
+
+### Upload JSON
+
+```typescript
+await sdk.uploadJSON({
+  data: Array<Record<string, any>>,
+  templateId: string,
+  fieldMapping?: Record<string, string>,
+});
+```
+
+### Verify PDF
+
+```typescript
+await sdk.verifyPDF({
+  pdf: Buffer | string,
+  filename?: string,
+});
+```
+
+### Batch Status
+
+```typescript
+await sdk.getBatchStatus('batch-uuid');
+await sdk.waitForBatchCompletion('batch-uuid', { interval?: number, timeout?: number });
+```
+
+## Configuration
+
+```typescript
+interface SDKConfig {
+  environment: 'sandbox' | 'production';
+  clientId: string;
+  clientSecret: string;
+  privateKey: string; // secp256k1 private key in hex format (64 chars)
+  baseUrl?: string;
+  timeout?: number; // default: 30000
+  retry?: {
+    maxAttempts?: number; // default: 3
+    delay?: number; // default: 1000
+  };
+}
+```
+
+## Error Handling
+
+```typescript
+import { SDKError, SDKErrorCode } from '@questverify/cert-sdk';
+
+try {
+  await sdk.uploadPDF({ pdf: buffer });
+} catch (error) {
+  if (error instanceof SDKError) {
+    console.error(error.code, error.message);
+  }
+}
+```
+
+**Error Codes:** `AUTHENTICATION_FAILED`, `INVALID_CREDENTIALS`, `INVALID_PDF`, `INVALID_CSV`, `TEMPLATE_NOT_FOUND`, `NETWORK_ERROR`, `TIMEOUT`, `VALIDATION_ERROR`, `UNKNOWN_ERROR`
+
+## Security
+
+- Never commit private keys to version control
+- Use environment variables for sensitive configuration
+- Use different keys for sandbox and production
+
+## License
+
+MIT

package/dist/AuthManager.d.ts

@@ -0,0 +1,40 @@
+import { AxiosInstance } from 'axios';
+import { SDKConfig } from './types';
+/**
+ * Authentication Manager
+ * Handles token acquisition, refresh, and automatic retry on 401
+ */
+export declare class AuthManager {
+    private accessToken;
+    private refreshToken;
+    private tokenExpiry;
+    private refreshPromise;
+    private config;
+    private axiosInstance;
+    constructor(config: SDKConfig);
+    /**
+     * Get valid access token (auto-refresh if needed)
+     */
+    getAccessToken(): Promise<string>;
+    /**
+     * Authenticate and get tokens
+     */
+    private authenticate;
+    /**
+     * Refresh access token using refresh token
+     */
+    private refreshAccessToken;
+    /**
+     * Make authenticated request with auto-retry on 401
+     */
+    request<T>(method: 'GET' | 'POST' | 'PUT' | 'DELETE', url: string, data?: any, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Get axios instance with authentication
+     */
+    getAxiosInstance(): AxiosInstance;
+    /**
+     * Clear tokens (for logout/testing)
+     */
+    clearTokens(): void;
+}
+//# sourceMappingURL=AuthManager.d.ts.map

package/dist/AuthManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthManager.d.ts","sourceRoot":"","sources":["../src/AuthManager.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAyC,MAAM,SAAS,CAAC;AAG3E;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,aAAa,CAAgB;gBAEzB,MAAM,EAAE,SAAS;IAQ7B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAsBvC;;OAEG;YACW,YAAY;IAyC1B;;OAEG;YACW,kBAAkB;IAwChC;;OAEG;IACG,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,EACzC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAmEb;;OAEG;IACH,gBAAgB,IAAI,aAAa;IAIjC;;OAEG;IACH,WAAW,IAAI,IAAI;CAKpB"}

package/dist/AuthManager.js

@@ -0,0 +1,188 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthManager = void 0;
+const axios_1 = __importDefault(require("axios"));
+const types_1 = require("./types");
+const config_1 = require("./config");
+/**
+ * Authentication Manager
+ * Handles token acquisition, refresh, and automatic retry on 401
+ */
+class AuthManager {
+    constructor(config) {
+        this.accessToken = null;
+        this.refreshToken = null;
+        this.tokenExpiry = 0;
+        this.refreshPromise = null;
+        this.config = config;
+        this.axiosInstance = axios_1.default.create({
+            baseURL: (0, config_1.getBaseUrl)(config),
+            timeout: config.timeout,
+        });
+    }
+    /**
+     * Get valid access token (auto-refresh if needed)
+     */
+    async getAccessToken() {
+        // If we have a valid token, return it
+        if (this.accessToken && Date.now() < this.tokenExpiry - 60000) {
+            // Refresh 1 minute before expiry
+            return this.accessToken;
+        }
+        // If refresh is already in progress, wait for it
+        if (this.refreshPromise) {
+            return this.refreshPromise;
+        }
+        // Start new refresh
+        this.refreshPromise = this.refreshAccessToken();
+        try {
+            const token = await this.refreshPromise;
+            return token;
+        }
+        finally {
+            this.refreshPromise = null;
+        }
+    }
+    /**
+     * Authenticate and get tokens
+     */
+    async authenticate() {
+        try {
+            const response = await this.axiosInstance.post('/api/auth/client/token', {
+                clientId: this.config.clientId,
+                clientSecret: this.config.clientSecret,
+            });
+            if (!response.data.success || !response.data.data) {
+                throw new types_1.SDKError(types_1.SDKErrorCode.AUTHENTICATION_FAILED, 'Authentication failed: Invalid response from server');
+            }
+            return response.data.data;
+        }
+        catch (error) {
+            if (axios_1.default.isAxiosError(error)) {
+                if (error.response?.status === 401) {
+                    throw new types_1.SDKError(types_1.SDKErrorCode.INVALID_CREDENTIALS, 'Invalid client credentials', error);
+                }
+                throw new types_1.SDKError(types_1.SDKErrorCode.AUTHENTICATION_FAILED, `Authentication failed: ${error.message}`, error);
+            }
+            throw new types_1.SDKError(types_1.SDKErrorCode.AUTHENTICATION_FAILED, `Authentication failed: ${error.message}`, error);
+        }
+    }
+    /**
+     * Refresh access token using refresh token
+     */
+    async refreshAccessToken() {
+        // If no refresh token, authenticate fresh
+        if (!this.refreshToken) {
+            const tokens = await this.authenticate();
+            this.accessToken = tokens.accessToken;
+            this.refreshToken = tokens.refreshToken;
+            this.tokenExpiry = Date.now() + tokens.expiresIn * 1000;
+            return this.accessToken;
+        }
+        try {
+            const response = await this.axiosInstance.post('/api/auth/client/refresh', {
+                refreshToken: this.refreshToken,
+            });
+            if (!response.data.success || !response.data.data) {
+                // Refresh token invalid, authenticate fresh
+                const tokens = await this.authenticate();
+                this.accessToken = tokens.accessToken;
+                this.refreshToken = tokens.refreshToken;
+                this.tokenExpiry = Date.now() + tokens.expiresIn * 1000;
+                return this.accessToken;
+            }
+            this.accessToken = response.data.data.accessToken;
+            this.tokenExpiry = Date.now() + response.data.data.expiresIn * 1000;
+            return this.accessToken;
+        }
+        catch (error) {
+            // Refresh failed, authenticate fresh
+            const tokens = await this.authenticate();
+            this.accessToken = tokens.accessToken;
+            this.refreshToken = tokens.refreshToken;
+            this.tokenExpiry = Date.now() + tokens.expiresIn * 1000;
+            return this.accessToken;
+        }
+    }
+    /**
+     * Make authenticated request with auto-retry on 401
+     */
+    async request(method, url, data, headers) {
+        const token = await this.getAccessToken();
+        try {
+            // Handle FormData specially
+            const requestHeaders = {
+                Authorization: `Bearer ${token}`,
+            };
+            // If data is FormData, don't set Content-Type (let FormData set it with boundary)
+            if (data && typeof data.getHeaders === 'function') {
+                // FormData object
+                const formDataHeaders = data.getHeaders();
+                Object.assign(requestHeaders, formDataHeaders);
+            }
+            else {
+                // Regular JSON data
+                requestHeaders['Content-Type'] = 'application/json';
+            }
+            // Merge with custom headers (custom headers take precedence)
+            if (headers) {
+                Object.assign(requestHeaders, headers);
+            }
+            const response = await this.axiosInstance.request({
+                method,
+                url,
+                data,
+                headers: requestHeaders,
+            });
+            return response.data;
+        }
+        catch (error) {
+            if (axios_1.default.isAxiosError(error) && error.response?.status === 401) {
+                // Token expired, refresh and retry once
+                this.accessToken = null; // Force refresh
+                const newToken = await this.getAccessToken();
+                // Rebuild headers for retry
+                const retryHeaders = {
+                    Authorization: `Bearer ${newToken}`,
+                };
+                if (data && typeof data.getHeaders === 'function') {
+                    const formDataHeaders = data.getHeaders();
+                    Object.assign(retryHeaders, formDataHeaders);
+                }
+                else {
+                    retryHeaders['Content-Type'] = 'application/json';
+                }
+                if (headers) {
+                    Object.assign(retryHeaders, headers);
+                }
+                const retryResponse = await this.axiosInstance.request({
+                    method,
+                    url,
+                    data,
+                    headers: retryHeaders,
+                });
+                return retryResponse.data;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get axios instance with authentication
+     */
+    getAxiosInstance() {
+        return this.axiosInstance;
+    }
+    /**
+     * Clear tokens (for logout/testing)
+     */
+    clearTokens() {
+        this.accessToken = null;
+        this.refreshToken = null;
+        this.tokenExpiry = 0;
+    }
+}
+exports.AuthManager = AuthManager;
+//# sourceMappingURL=AuthManager.js.map

package/dist/AuthManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthManager.js","sourceRoot":"","sources":["../src/AuthManager.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA6C;AAC7C,mCAA2E;AAC3E,qCAAsC;AAEtC;;;GAGG;AACH,MAAa,WAAW;IAQtB,YAAY,MAAiB;QAPrB,gBAAW,GAAkB,IAAI,CAAC;QAClC,iBAAY,GAAkB,IAAI,CAAC;QACnC,gBAAW,GAAW,CAAC,CAAC;QACxB,mBAAc,GAA2B,IAAI,CAAC;QAKpD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,eAAK,CAAC,MAAM,CAAC;YAChC,OAAO,EAAE,IAAA,mBAAU,EAAC,MAAM,CAAC;YAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc;QAClB,sCAAsC;QACtC,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,GAAG,KAAK,EAAE,CAAC;YAC9D,iCAAiC;YACjC,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;QAED,iDAAiD;QACjD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7B,CAAC;QAED,oBAAoB;QACpB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY;QACxB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAG3C,wBAAwB,EAAE;gBAC3B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;aACvC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClD,MAAM,IAAI,gBAAQ,CAChB,oBAAY,CAAC,qBAAqB,EAClC,qDAAqD,CACtD,CAAC;YACJ,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,eAAK,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;oBACnC,MAAM,IAAI,gBAAQ,CAChB,oBAAY,CAAC,mBAAmB,EAChC,4BAA4B,EAC5B,KAAK,CACN,CAAC;gBACJ,CAAC;gBACD,MAAM,IAAI,gBAAQ,CAChB,oBAAY,CAAC,qBAAqB,EAClC,0BAA0B,KAAK,CAAC,OAAO,EAAE,EACzC,KAAK,CACN,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,gBAAQ,CAChB,oBAAY,CAAC,qBAAqB,EAClC,0BAA0B,KAAK,CAAC,OAAO,EAAE,EACzC,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB;QAC9B,0CAA0C;QAC1C,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YACzC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;YACtC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;YACxC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;YACxD,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAG3C,0BAA0B,EAAE;gBAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;aAChC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClD,4CAA4C;gBAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;gBACzC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;gBACtC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;gBACxC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;gBACxD,OAAO,IAAI,CAAC,WAAW,CAAC;YAC1B,CAAC;YAED,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;YAClD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACpE,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,qCAAqC;YACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YACzC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;YACtC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;YACxC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;YACxD,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,MAAyC,EACzC,GAAW,EACX,IAAU,EACV,OAAgC;QAEhC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAE1C,IAAI,CAAC;YACH,4BAA4B;YAC5B,MAAM,cAAc,GAA2B;gBAC7C,aAAa,EAAE,UAAU,KAAK,EAAE;aACjC,CAAC;YAEF,kFAAkF;YAClF,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBAClD,kBAAkB;gBAClB,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC1C,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,oBAAoB;gBACpB,cAAc,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;YACtD,CAAC;YAED,6DAA6D;YAC7D,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YACzC,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAI;gBACnD,MAAM;gBACN,GAAG;gBACH,IAAI;gBACJ,OAAO,EAAE,cAAc;aACxB,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,eAAK,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;gBAChE,wCAAwC;gBACxC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,gBAAgB;gBACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;gBAE7C,4BAA4B;gBAC5B,MAAM,YAAY,GAA2B;oBAC3C,aAAa,EAAE,UAAU,QAAQ,EAAE;iBACpC,CAAC;gBAEF,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;oBAClD,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;oBAC1C,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;gBAC/C,CAAC;qBAAM,CAAC;oBACN,YAAY,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;gBACpD,CAAC;gBAED,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBACvC,CAAC;gBAED,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAI;oBACxD,MAAM;oBACN,GAAG;oBACH,IAAI;oBACJ,OAAO,EAAE,YAAY;iBACtB,CAAC,CAAC;gBAEH,OAAO,aAAa,CAAC,IAAI,CAAC;YAC5B,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACvB,CAAC;CACF;AA1ND,kCA0NC"}

package/dist/CertSDK.d.ts

@@ -0,0 +1,93 @@
+import { SDKConfig, UploadPDFOptions, UploadPDFResult, UploadCSVOptions, UploadCSVResult, UploadJSONOptions, VerifyPDFOptions, VerificationResult, BatchStatus, BatchDetails } from './types';
+/**
+ * QuestVerify Certificate SDK
+ * Main SDK class for blockchain certificate operations
+ */
+export declare class CertSDK {
+    private config;
+    private authManager;
+    private signer;
+    private axiosInstance;
+    constructor(config: SDKConfig);
+    /**
+     * Upload single or multiple PDFs for certificate issuance
+     */
+    uploadPDF(options: UploadPDFOptions): Promise<UploadPDFResult>;
+    /**
+     * Upload multiple PDFs (ZIP file or array of buffers)
+     */
+    uploadPDFs(pdfs: Array<Buffer | string>): Promise<{
+        batchId: string;
+        totalRecords: number;
+        jobs: Array<{
+            jobId: string;
+            filename: string;
+            status: string;
+        }>;
+    }>;
+    /**
+     * Upload CSV file for bulk certificate issuance
+     */
+    uploadCSV(options: UploadCSVOptions): Promise<UploadCSVResult>;
+    /**
+     * Upload JSON data for bulk certificate issuance
+     */
+    uploadJSON(options: UploadJSONOptions): Promise<UploadCSVResult>;
+    /**
+     * Verify PDF certificate
+     */
+    verifyPDF(options: VerifyPDFOptions): Promise<VerificationResult>;
+    /**
+     * Get batch status
+     */
+    getBatchStatus(batchId: string): Promise<BatchStatus>;
+    /**
+     * Wait for batch to complete (polling)
+     */
+    waitForBatchCompletion(batchId: string, options?: {
+        interval?: number;
+        timeout?: number;
+    }): Promise<BatchStatus>;
+    /**
+     * Get full batch details including job IDs.
+     * Useful for downloading generated PDFs after a batch completes.
+     */
+    getBatchDetails(batchId: string): Promise<BatchDetails>;
+    /**
+     * Download the generated (QR/VD embedded) certificate PDF for a job.
+     */
+    downloadJobPDF(jobId: string): Promise<Buffer>;
+    /**
+     * Download all certificates in a batch as a ZIP file.
+     */
+    downloadBatchZIP(batchId: string): Promise<Buffer>;
+    /**
+     * Trigger email sending for a batch.
+     */
+    emailBatch(options: {
+        batchId: string;
+        sendZipTo?: string;
+    }): Promise<{
+        success: boolean;
+        message: string;
+        type: 'zip' | 'individual';
+        stats?: {
+            sent: number;
+            failed: number;
+            skipped: number;
+        };
+    }>;
+    /**
+     * Get public key (for verification/display)
+     */
+    getPublicKey(compressed?: boolean): Buffer;
+    /**
+     * Hash data (utility method)
+     */
+    hashData(data: Buffer | string): string;
+    /**
+     * Sign data (utility method)
+     */
+    signData(data: Buffer | string): string;
+}
+//# sourceMappingURL=CertSDK.d.ts.map

package/dist/CertSDK.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CertSDK.d.ts","sourceRoot":"","sources":["../src/CertSDK.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,YAAY,EAGb,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,aAAa,CAAgB;gBAEzB,MAAM,EAAE,SAAS;IAe7B;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAwEpE;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC;QACtD,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClE,CAAC;IAUF;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAsGpE;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IA6GtE;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuEvE;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA2B3D;;OAEG;IACG,sBAAsB,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KACb,GACL,OAAO,CAAC,WAAW,CAAC;IAuBvB;;;OAGG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAuB7D;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBpD;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBxD;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAC1E,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,KAAK,GAAG,YAAY,CAAC;QAC3B,KAAK,CAAC,EAAE;YACN,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,CAAC;IAgCF;;OAEG;IACH,YAAY,CAAC,UAAU,GAAE,OAAc,GAAG,MAAM;IAUhD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAIvC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;CASxC"}