@qubiton/sdk 0.1.0-dev.1610

package/README.md

@@ -0,0 +1,128 @@
+# QubitOn API — Node.js SDK
+
+TypeScript/Node.js client for the [QubitOn API](https://www.qubiton.com) by QubitOn. Validate addresses, tax IDs, and bank accounts; look up business registrations; screen for sanctions and disqualified directors.
+
+## Installation
+
+```bash
+npm install @qubiton/sdk
+```
+
+## Quick Start
+
+```typescript
+import { QubitOnClient } from '@qubiton/sdk';
+
+const client = new QubitOnClient({ apiKey: 'svm...' });
+
+const result = await client.validateAddress({
+  addressLine1: '123 Main St',
+  city: 'New York',
+  state: 'NY',
+  postalCode: '10001',
+  country: 'US',
+});
+
+console.log(`Valid: ${result.isValid}, Score: ${result.confidenceScore}`);
+```
+
+## Authentication
+
+### API Key (recommended)
+
+```typescript
+const client = new QubitOnClient({ apiKey: 'svm...' });
+```
+
+### OAuth2 Client Credentials
+
+```typescript
+const client = new QubitOnClient({
+  clientId: 'your-client-id',
+  clientSecret: 'your-client-secret',
+});
+```
+
+## Methods
+
+| Method | Description | Endpoint |
+|--------|-------------|----------|
+| `validateAddress()` | Validate and standardize a postal address | POST /api/validate/address |
+| `validateTaxId()` | Validate a tax identification number | POST /api/validate/taxid |
+| `validateBankAccount()` | Verify bank account details | POST /api/validate/bank |
+| `lookupBusiness()` | Look up official business registration data | POST /api/enrich/business |
+| `checkSanctions()` | Screen against global sanctions lists | POST /api/risk/sanctions |
+| `checkDirectors()` | Check for disqualified directors | POST /api/risk/directors |
+
+## Error Handling
+
+```typescript
+import { QubitOnClient, ApiError, RateLimitError } from '@qubiton/sdk';
+
+const client = new QubitOnClient({ apiKey: 'svm...' });
+
+try {
+  const result = await client.validateAddress(req);
+} catch (err) {
+  if (err instanceof RateLimitError) {
+    console.log(`Rate limited, retry after ${err.retryAfter}s`);
+  } else if (err instanceof ApiError) {
+    console.log(`API error [${err.status}]: ${err.message}`);
+  }
+}
+```
+
+All response objects include a `raw` property with the full API response for fields not yet mapped to typed properties.
+
+## Configuration
+
+```typescript
+const client = new QubitOnClient({
+  apiKey: 'svm...',
+  baseUrl: 'https://api.qubiton.com', // default
+  timeout: 30000,                         // milliseconds
+});
+```
+
+## Requirements
+
+- Node.js 18+ (uses built-in `fetch`)
+- Zero runtime dependencies
+
+## MCP Protocol Support
+
+This API is available as a native [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server.
+
+### Tools (37), Prompts (20), Resources (7)
+
+| Category | Count | Description |
+|----------|-------|-------------|
+| MCP Tools | 37 | 1:1 mapped to API endpoints — same auth, rate limits, and plan access |
+| MCP Prompts | 20 | Multi-tool workflow templates (onboarding, compliance, risk, payment) |
+| MCP Resources | 7 | Reference datasets (tool inventory, risk categories, country coverage) |
+
+Prompts may be plan-gated. See [Pricing](https://www.qubiton.com/pricing) for details.
+
+- [MCP Manifest](https://mcp.qubiton.com/.well-known/mcp.json)
+- [Resource Content](https://mcp.qubiton.com/api/portal/mcp/resources/{name})
+
+### Accessing Resource Content
+
+Resources provide reference data via HTTP:
+
+```bash
+curl https://mcp.qubiton.com/api/portal/mcp/resources/tool_inventory
+curl https://mcp.qubiton.com/api/portal/mcp/resources/supported_countries
+```
+
+Available resources: `tool_inventory`, `entity_risk_categories`, `healthcare_types`, `india_identity_types`, `certification_types`, `supported_countries`, `about`.
+
+## Getting an API Key
+
+1. Sign up for a free account at [www.qubiton.com](https://www.qubiton.com/auth/register)
+2. Navigate to Dashboard → API Keys
+3. Copy your API key (starts with `svm`)
+
+## License
+
+MIT

package/dist/auth.d.ts

@@ -0,0 +1,10 @@
+/** OAuth2 token manager for client credentials flow. */
+export declare class OAuth2TokenManager {
+    private clientId;
+    private clientSecret;
+    private tokenUrl;
+    private cache;
+    constructor(clientId: string, clientSecret: string, tokenUrl: string);
+    getToken(): Promise<string>;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAOxD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAA2B;gBAE5B,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAM9D,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;CA8BlC"}

package/dist/auth.js

@@ -0,0 +1,37 @@
+/** OAuth2 token manager for client credentials flow. */
+export class OAuth2TokenManager {
+    clientId;
+    clientSecret;
+    tokenUrl;
+    cache = null;
+    constructor(clientId, clientSecret, tokenUrl) {
+        this.clientId = clientId;
+        this.clientSecret = clientSecret;
+        this.tokenUrl = tokenUrl;
+    }
+    async getToken() {
+        if (this.cache && Date.now() < this.cache.expiresAt - 30_000) {
+            return this.cache.accessToken;
+        }
+        const body = new URLSearchParams({
+            grant_type: 'client_credentials',
+            client_id: this.clientId,
+            client_secret: this.clientSecret,
+        });
+        const resp = await fetch(this.tokenUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString(),
+        });
+        if (!resp.ok) {
+            throw new Error(`OAuth2 token request failed: ${resp.status}`);
+        }
+        const data = (await resp.json());
+        this.cache = {
+            accessToken: data.access_token,
+            expiresAt: Date.now() + (data.expires_in ?? 3600) * 1000,
+        };
+        return this.cache.accessToken;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAOxD,MAAM,OAAO,kBAAkB;IACrB,QAAQ,CAAS;IACjB,YAAY,CAAS;IACrB,QAAQ,CAAS;IACjB,KAAK,GAAsB,IAAI,CAAC;IAExC,YAAY,QAAgB,EAAE,YAAoB,EAAE,QAAgB;QAClE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,MAAM,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;QAChC,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC;YAC/B,UAAU,EAAE,oBAAoB;YAChC,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,aAAa,EAAE,IAAI,CAAC,YAAY;SACjC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;YACtC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;YAChE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;SACtB,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAkD,CAAC;QAElF,IAAI,CAAC,KAAK,GAAG;YACX,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,IAAI;SACzD,CAAC;QAEF,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;IAChC,CAAC;CACF"}

package/dist/client.d.ts

@@ -0,0 +1,25 @@
+import type { AddressRequest, AddressResponse, BankAccountRequest, BankAccountResponse, BusinessLookupRequest, BusinessLookupResponse, DirectorsRequest, DirectorsResponse, SanctionsRequest, SanctionsResponse, TaxIdRequest, TaxIdResponse } from './models';
+export interface ClientOptions {
+    apiKey?: string;
+    clientId?: string;
+    clientSecret?: string;
+    tokenUrl?: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+export declare class QubitOnClient {
+    private apiKey;
+    private baseUrl;
+    private timeout;
+    private oauth;
+    constructor(options?: ClientOptions);
+    private headers;
+    private request;
+    validateAddress(req: AddressRequest): Promise<AddressResponse>;
+    validateTaxId(req: TaxIdRequest): Promise<TaxIdResponse>;
+    validateBankAccount(req: BankAccountRequest): Promise<BankAccountResponse>;
+    lookupBusiness(req: BusinessLookupRequest): Promise<BusinessLookupResponse>;
+    checkSanctions(req: SanctionsRequest): Promise<SanctionsResponse>;
+    checkDirectors(req: DirectorsRequest): Promise<DirectorsResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACd,MAAM,UAAU,CAAC;AAMlB,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAA4B;gBAE7B,OAAO,GAAE,aAAkB;YAezB,OAAO;YAgBP,OAAO;IAgEf,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAU9D,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAWxD,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAU1E,cAAc,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAY3E,cAAc,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAUjE,cAAc,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAQxE"}

package/dist/client.js

@@ -0,0 +1,158 @@
+import { OAuth2TokenManager } from './auth';
+import { ApiError, AuthenticationError, RateLimitError } from './errors';
+const VERSION = '0.1.0';
+const DEFAULT_BASE_URL = 'https://api.qubiton.com';
+const MAX_RETRIES = 3;
+export class QubitOnClient {
+    apiKey;
+    baseUrl;
+    timeout;
+    oauth;
+    constructor(options = {}) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this.timeout = options.timeout ?? 30_000;
+        this.oauth = null;
+        if (options.clientId && options.clientSecret) {
+            this.oauth = new OAuth2TokenManager(options.clientId, options.clientSecret, options.tokenUrl ?? `${this.baseUrl}/api/oauth/token`);
+        }
+    }
+    async headers() {
+        const h = {
+            'Content-Type': 'application/json',
+            'User-Agent': `qubiton-node-sdk/${VERSION}`,
+        };
+        if (this.apiKey) {
+            h['X-Api-Key'] = this.apiKey;
+        }
+        else if (this.oauth) {
+            const token = await this.oauth.getToken();
+            h['Authorization'] = `Bearer ${token}`;
+        }
+        return h;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        let lastError = null;
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), this.timeout);
+            try {
+                const resp = await fetch(url, {
+                    method,
+                    headers: await this.headers(),
+                    body: body ? JSON.stringify(body) : undefined,
+                    signal: controller.signal,
+                });
+                clearTimeout(timer);
+                if (resp.status === 429) {
+                    const retryAfter = parseFloat(resp.headers.get('Retry-After') ?? String(2 ** attempt));
+                    if (attempt < MAX_RETRIES - 1) {
+                        await sleep(retryAfter * 1000);
+                        continue;
+                    }
+                    const raw = await safeJson(resp);
+                    throw new RateLimitError(retryAfter, raw);
+                }
+                if (resp.status >= 500) {
+                    lastError = new ApiError(resp.status, await resp.text());
+                    if (attempt < MAX_RETRIES - 1) {
+                        await sleep(2 ** attempt * 1000);
+                        continue;
+                    }
+                    throw lastError;
+                }
+                if (resp.status === 401 || resp.status === 403) {
+                    const raw = await safeJson(resp);
+                    throw new AuthenticationError(raw.message ?? 'Authentication failed', raw);
+                }
+                if (resp.status >= 400) {
+                    const raw = await safeJson(resp);
+                    throw new ApiError(resp.status, raw.message ?? 'Request failed', raw);
+                }
+                return (await resp.json());
+            }
+            catch (err) {
+                clearTimeout(timer);
+                if (err instanceof ApiError)
+                    throw err;
+                lastError = err;
+                if (attempt < MAX_RETRIES - 1) {
+                    await sleep(2 ** attempt * 1000);
+                    continue;
+                }
+            }
+        }
+        throw lastError ?? new ApiError(0, 'Request failed after retries');
+    }
+    // ── Public Methods ────────────────────────────────────────────────────
+    async validateAddress(req) {
+        const data = await this.request('POST', '/api/validate/address', req);
+        return {
+            isValid: data.isValid ?? false,
+            confidenceScore: data.confidenceScore ?? 0,
+            standardizedAddress: data.standardizedAddress ?? {},
+            raw: data,
+        };
+    }
+    async validateTaxId(req) {
+        const data = await this.request('POST', '/api/validate/taxid', req);
+        return {
+            isValid: data.isValid ?? false,
+            taxIdType: data.taxIdType ?? '',
+            country: data.country ?? '',
+            registeredName: data.registeredName ?? '',
+            raw: data,
+        };
+    }
+    async validateBankAccount(req) {
+        const data = await this.request('POST', '/api/validate/bank', req);
+        return {
+            isValid: data.isValid ?? false,
+            bankName: data.bankName ?? '',
+            accountType: data.accountType ?? '',
+            raw: data,
+        };
+    }
+    async lookupBusiness(req) {
+        const data = await this.request('POST', '/api/enrich/business', req);
+        return {
+            found: data.found ?? false,
+            companyName: data.companyName ?? '',
+            registrationNumber: data.registrationNumber ?? '',
+            status: data.status ?? '',
+            address: data.address ?? {},
+            raw: data,
+        };
+    }
+    async checkSanctions(req) {
+        const data = await this.request('POST', '/api/risk/sanctions', req);
+        return {
+            hasMatches: data.hasMatches ?? false,
+            matches: data.matches ?? [],
+            screenedLists: data.screenedLists ?? [],
+            raw: data,
+        };
+    }
+    async checkDirectors(req) {
+        const data = await this.request('POST', '/api/risk/directors', req);
+        return {
+            hasDisqualified: data.hasDisqualified ?? false,
+            directors: data.directors ?? [],
+            raw: data,
+        };
+    }
+}
+// ── Helpers ──────────────────────────────────────────────────────────────
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function safeJson(resp) {
+    try {
+        return (await resp.json());
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+/** Base API error with status code and optional raw response. */
+export declare class ApiError extends Error {
+    status: number;
+    raw: Record<string, unknown>;
+    constructor(status: number, message: string, raw?: Record<string, unknown>);
+}
+/** Raised on 401/403 responses. */
+export declare class AuthenticationError extends ApiError {
+    constructor(message?: string, raw?: Record<string, unknown>);
+}
+/** Raised on 429 responses. */
+export declare class RateLimitError extends ApiError {
+    retryAfter: number | undefined;
+    constructor(retryAfter?: number, raw?: Record<string, unknown>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,qBAAa,QAAS,SAAQ,KAAK;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEjB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAM3E;AAED,mCAAmC;AACnC,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,SAA0B,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI7E;AAED,+BAA+B;AAC/B,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEnB,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAK/D"}

package/dist/errors.js

@@ -0,0 +1,28 @@
+/** Base API error with status code and optional raw response. */
+export class ApiError extends Error {
+    status;
+    raw;
+    constructor(status, message, raw) {
+        super(message);
+        this.name = 'ApiError';
+        this.status = status;
+        this.raw = raw ?? {};
+    }
+}
+/** Raised on 401/403 responses. */
+export class AuthenticationError extends ApiError {
+    constructor(message = 'Authentication failed', raw) {
+        super(401, message, raw);
+        this.name = 'AuthenticationError';
+    }
+}
+/** Raised on 429 responses. */
+export class RateLimitError extends ApiError {
+    retryAfter;
+    constructor(retryAfter, raw) {
+        super(429, 'Rate limit exceeded', raw);
+        this.name = 'RateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,MAAM,CAAS;IACf,GAAG,CAA0B;IAE7B,YAAY,MAAc,EAAE,OAAe,EAAE,GAA6B;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,GAAG,GAAG,GAAG,IAAI,EAAE,CAAC;IACvB,CAAC;CACF;AAED,mCAAmC;AACnC,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,OAAO,GAAG,uBAAuB,EAAE,GAA6B;QAC1E,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,+BAA+B;AAC/B,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC1C,UAAU,CAAqB;IAE/B,YAAY,UAAmB,EAAE,GAA6B;QAC5D,KAAK,CAAC,GAAG,EAAE,qBAAqB,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { QubitOnClient } from './client';
+export type { ClientOptions } from './client';
+export { ApiError, AuthenticationError, RateLimitError } from './errors';
+export type { AddressRequest, AddressResponse, BankAccountRequest, BankAccountResponse, BusinessLookupRequest, BusinessLookupResponse, DirectorsRequest, DirectorsResponse, SanctionsRequest, SanctionsResponse, TaxIdRequest, TaxIdResponse, } from './models';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACzE,YAAY,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,GACd,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { QubitOnClient } from './client';
+export { ApiError, AuthenticationError, RateLimitError } from './errors';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/models.d.ts

@@ -0,0 +1,75 @@
+export interface AddressRequest {
+    addressLine1: string;
+    addressLine2?: string;
+    city: string;
+    state?: string;
+    postalCode?: string;
+    country: string;
+}
+export interface AddressResponse {
+    isValid: boolean;
+    confidenceScore: number;
+    standardizedAddress: Record<string, string>;
+    raw: Record<string, unknown>;
+}
+export interface TaxIdRequest {
+    taxId: string;
+    country: string;
+    taxIdType?: string;
+}
+export interface TaxIdResponse {
+    isValid: boolean;
+    taxIdType: string;
+    country: string;
+    registeredName: string;
+    raw: Record<string, unknown>;
+}
+export interface BankAccountRequest {
+    accountNumber: string;
+    country: string;
+    routingNumber?: string;
+    iban?: string;
+    bankCode?: string;
+}
+export interface BankAccountResponse {
+    isValid: boolean;
+    bankName: string;
+    accountType: string;
+    raw: Record<string, unknown>;
+}
+export interface BusinessLookupRequest {
+    companyName: string;
+    country: string;
+    registrationNumber?: string;
+    state?: string;
+}
+export interface BusinessLookupResponse {
+    found: boolean;
+    companyName: string;
+    registrationNumber: string;
+    status: string;
+    address: Record<string, string>;
+    raw: Record<string, unknown>;
+}
+export interface SanctionsRequest {
+    entityName: string;
+    entityType?: string;
+    country?: string;
+}
+export interface SanctionsResponse {
+    hasMatches: boolean;
+    matches: Record<string, unknown>[];
+    screenedLists: string[];
+    raw: Record<string, unknown>;
+}
+export interface DirectorsRequest {
+    companyName: string;
+    country: string;
+    registrationNumber?: string;
+}
+export interface DirectorsResponse {
+    hasDisqualified: boolean;
+    directors: Record<string, unknown>[];
+    raw: Record<string, unknown>;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAID,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAID,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAID,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAID,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACnC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAID,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACrC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B"}

package/dist/models.js

@@ -0,0 +1,3 @@
+// ── Address Validation ────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA,6EAA6E"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@qubiton/sdk",
+  "version": "0.1.0-dev.1610",
+  "description": "Node.js SDK for the QubitOn API by QubitOn",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "api",
+    "validation",
+    "enrichment",
+    "sanctions",
+    "qubiton",
+    "QubitOn"
+  ],
+  "author": "QubitOn <support@qubiton.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/qubitonhq/qubiton-node"
+  },
+  "homepage": "https://www.qubiton.com",
+  "devDependencies": {
+    "typescript": "~5.7.0"
+  }
+}