@validpay/node-sdk 0.1.0

package/README.md

@@ -0,0 +1,52 @@
+# @validpay/node-sdk
+
+Official Node.js SDK for the [ValidPay](https://validpay.io) document verification API.
+
+## Overview
+
+ValidPay provides cryptographic document verification infrastructure. This SDK enables issuers (banks, fintechs, check printers) to create tamper-proof verification intents and allows verifiers to authenticate documents in real-time.
+
+## Installation
+
+```bash
+npm install @validpay/node-sdk
+```
+
+## Quick Start
+
+```typescript
+import { ValidPayClient } from '@validpay/node-sdk';
+
+const client = new ValidPayClient({
+  apiKey: process.env.VALIDPAY_API_KEY,
+});
+
+// Create a verification intent
+const intent = await client.createIntent({
+  documentType: 'check',
+  payload: { payee: 'Jane Doe', amount: 1500.00 },
+});
+
+// intent.id → embed in QR code
+// intent.verifyUrl → direct verification link
+```
+
+## Features
+
+- Zero production dependencies (Node built-in crypto + native fetch)
+- ESM-only, TypeScript-first
+- AES-256-GCM encryption with client-side key generation
+- XOR key splitting for multi-party verification
+- Automatic retry with exponential backoff
+
+## Documentation
+
+Full API documentation: [https://validpay.io/docs](https://validpay.io/docs)
+
+## Status
+
+**Private Beta** — Contact mike@validpay.io for API access.
+
+## License
+
+MIT — Copyright (c) 2026 MiLu Technologies LLC

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export interface ValidPayClientOptions {
+  apiKey: string;
+  baseUrl?: string;
+}
+
+export interface CreateIntentParams {
+  documentType: 'check' | 'invoice' | 'receipt' | 'document';
+  payload: Record<string, unknown>;
+}
+
+export interface Intent {
+  id: string;
+  verifyUrl: string;
+  createdAt: string;
+  expiresAt: string;
+}
+
+export declare class ValidPayClient {
+  constructor(options: ValidPayClientOptions);
+  createIntent(params: CreateIntentParams): Promise<Intent>;
+  getIntent(id: string): Promise<Intent>;
+}
+
+export default ValidPayClient;

package/dist/index.js

@@ -0,0 +1,33 @@
+/**
+ * @validpay/node-sdk
+ * Official Node.js SDK for the ValidPay document verification API.
+ *
+ * Status: Private Beta — Contact mike@validpay.io for API access.
+ * Docs: https://validpay.io/docs
+ */
+
+export class ValidPayClient {
+  constructor(options = {}) {
+    if (!options.apiKey) {
+      throw new Error(
+        'ValidPay: API key required. Get yours at https://validpay.io'
+      );
+    }
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl || 'https://api.validpay.io';
+  }
+
+  async createIntent(params) {
+    throw new Error(
+      'ValidPay SDK is in private beta. Contact mike@validpay.io for access.'
+    );
+  }
+
+  async getIntent(id) {
+    throw new Error(
+      'ValidPay SDK is in private beta. Contact mike@validpay.io for access.'
+    );
+  }
+}
+
+export default ValidPayClient;

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@validpay/node-sdk",
+  "version": "0.1.0",
+  "description": "ValidPay Node.js SDK — Document verification and authentication API client",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "keywords": ["validpay", "document-verification", "authentication", "check-verification", "anti-fraud", "encryption"],
+  "author": "MiLu Technologies LLC <mike@validpay.io>",
+  "license": "MIT",
+  "homepage": "https://validpay.io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ValidPay-io/validpay-node-sdk"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}