@qpher/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Qpher
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,266 @@
+# @qpher/sdk
+
+Official Node.js SDK for the [Qpher](https://qpher.ai) Post-Quantum Cryptography API.
+
+## Installation
+
+```bash
+npm install @qpher/sdk
+```
+
+## Requirements
+
+- Node.js 18+
+
+## Quick Start
+
+```typescript
+import { Qpher } from '@qpher/sdk';
+
+// Initialize the client
+const client = new Qpher({ apiKey: 'qph_live_your_api_key' });
+
+// Encrypt data using Kyber768 KEM
+const encrypted = await client.kem.encrypt({
+  plaintext: Buffer.from('Hello, Quantum World!'),
+  keyVersion: 1,
+});
+console.log('Ciphertext:', encrypted.ciphertext.toString('hex'));
+
+// Decrypt data
+const decrypted = await client.kem.decrypt({
+  ciphertext: encrypted.ciphertext,
+  keyVersion: encrypted.keyVersion,
+});
+console.log('Plaintext:', decrypted.plaintext.toString());
+
+// Sign a message using Dilithium3
+const signed = await client.signatures.sign({
+  message: Buffer.from('Invoice #12345'),
+  keyVersion: 1,
+});
+console.log('Signature:', signed.signature.toString('hex'));
+
+// Verify a signature
+const verified = await client.signatures.verify({
+  message: Buffer.from('Invoice #12345'),
+  signature: signed.signature,
+  keyVersion: signed.keyVersion,
+});
+console.log('Valid:', verified.valid);
+```
+
+## API Reference
+
+### Client Initialization
+
+```typescript
+import { Qpher } from '@qpher/sdk';
+
+const client = new Qpher({
+  apiKey: 'qph_live_your_api_key', // Required
+  baseUrl: 'https://api.qpher.ai', // Optional, default
+  timeout: 30000,                   // Optional, milliseconds
+  maxRetries: 3,                    // Optional
+});
+```
+
+### KEM Operations (Kyber768)
+
+#### Encrypt
+
+```typescript
+const result = await client.kem.encrypt({
+  plaintext: Buffer.from('secret data'),
+  keyVersion: 1,
+  mode: 'standard',           // Optional: 'standard' | 'deterministic'
+  salt: Buffer.alloc(32),     // Required if mode='deterministic'
+});
+// result.ciphertext: Buffer
+// result.keyVersion: number
+// result.algorithm: string ('Kyber768')
+// result.requestId: string
+```
+
+#### Decrypt
+
+```typescript
+const result = await client.kem.decrypt({
+  ciphertext: encryptedData,
+  keyVersion: 1,
+});
+// result.plaintext: Buffer
+// result.keyVersion: number
+// result.algorithm: string
+// result.requestId: string
+```
+
+### Signature Operations (Dilithium3)
+
+#### Sign
+
+```typescript
+const result = await client.signatures.sign({
+  message: Buffer.from('document to sign'),
+  keyVersion: 1,
+});
+// result.signature: Buffer (3,293 bytes)
+// result.keyVersion: number
+// result.algorithm: string ('Dilithium3')
+// result.requestId: string
+```
+
+#### Verify
+
+```typescript
+const result = await client.signatures.verify({
+  message: Buffer.from('document to sign'),
+  signature: signatureBuffer,
+  keyVersion: 1,
+});
+// result.valid: boolean
+// result.keyVersion: number
+// result.algorithm: string
+// result.requestId: string
+```
+
+### Key Management
+
+#### Generate Key
+
+```typescript
+const result = await client.keys.generate({ algorithm: 'Kyber768' });
+// result.keyVersion: number
+// result.algorithm: string
+// result.status: string ('active')
+// result.publicKey: Buffer
+// result.createdAt: string
+```
+
+#### Rotate Key
+
+```typescript
+const result = await client.keys.rotate({ algorithm: 'Kyber768' });
+// result.keyVersion: number (new)
+// result.oldKeyVersion: number
+// result.algorithm: string
+// result.publicKey: Buffer
+```
+
+#### Get Active Key
+
+```typescript
+const keyInfo = await client.keys.getActive({ algorithm: 'Kyber768' });
+// keyInfo.keyVersion: number
+// keyInfo.algorithm: string
+// keyInfo.status: string
+// keyInfo.publicKey: Buffer
+// keyInfo.createdAt: string
+```
+
+#### List Keys
+
+```typescript
+const result = await client.keys.list({
+  algorithm: 'Kyber768', // Optional filter
+  status: 'active',       // Optional filter
+});
+// result.keys: KeyInfo[]
+// result.total: number
+```
+
+#### Retire Key
+
+```typescript
+const result = await client.keys.retire({
+  algorithm: 'Kyber768',
+  keyVersion: 1,
+});
+// result.keyVersion: number
+// result.status: string ('retired')
+```
+
+## Error Handling
+
+```typescript
+import {
+  Qpher,
+  QpherError,
+  AuthenticationError,
+  ValidationError,
+  NotFoundError,
+  RateLimitError,
+} from '@qpher/sdk';
+
+try {
+  const result = await client.kem.encrypt({
+    plaintext: Buffer.from('data'),
+    keyVersion: 99,
+  });
+} catch (err) {
+  if (err instanceof NotFoundError) {
+    console.log(`Key not found: ${err.message}`);
+    console.log(`Error code: ${err.errorCode}`);
+    console.log(`Request ID: ${err.requestId}`);
+  } else if (err instanceof RateLimitError) {
+    console.log('Rate limit exceeded, please retry later');
+  } else if (err instanceof AuthenticationError) {
+    console.log('Invalid API key');
+  } else if (err instanceof ValidationError) {
+    console.log(`Invalid input: ${err.message}`);
+  } else if (err instanceof QpherError) {
+    console.log(`API error: ${err.message}`);
+  }
+}
+```
+
+## Error Types
+
+| Exception | HTTP Status | Description |
+|-----------|-------------|-------------|
+| `AuthenticationError` | 401 | Invalid or missing API key |
+| `ValidationError` | 400 | Invalid request parameters |
+| `ForbiddenError` | 403 | Operation not allowed |
+| `NotFoundError` | 404 | Resource not found |
+| `RateLimitError` | 429 | Rate limit exceeded |
+| `ServerError` | 500+ | Server-side errors |
+| `TimeoutError` | 504 | Request timed out |
+| `ConnectionError` | 503 | Connection failed |
+
+## TypeScript Support
+
+This SDK is written in TypeScript and provides full type definitions. All input and output types are exported:
+
+```typescript
+import {
+  QpherOptions,
+  EncryptInput,
+  EncryptResult,
+  DecryptInput,
+  DecryptResult,
+  SignInput,
+  SignResult,
+  VerifyInput,
+  VerifyResult,
+  KeyInfo,
+  KeyListResult,
+  // ... and more
+} from '@qpher/sdk';
+```
+
+## Supported Algorithms
+
+| Algorithm | Type | Security Level |
+|-----------|------|----------------|
+| Kyber768 | KEM (Encryption) | NIST Level 3 |
+| Dilithium3 | Digital Signatures | NIST Level 3 |
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Links
+
+- [Qpher Website](https://qpher.ai)
+- [API Documentation](https://docs.qpher.ai)
+- [GitHub Repository](https://github.com/qpher/qpher-node)

package/dist/client.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Main Qpher client class.
+ */
+import { KEMModule } from './kem';
+import { SignaturesModule } from './signatures';
+import { KeysModule } from './keys';
+import { QpherOptions } from './types';
+/**
+ * Qpher PQC API client.
+ *
+ * @example
+ * ```typescript
+ * import { Qpher } from '@qpher/sdk';
+ *
+ * const client = new Qpher({ apiKey: 'qph_live_abc123' });
+ *
+ * const result = await client.kem.encrypt({
+ *   plaintext: Buffer.from('Hello!'),
+ *   keyVersion: 1,
+ * });
+ *
+ * console.log(result.ciphertext);
+ * ```
+ */
+export declare class Qpher {
+    readonly kem: KEMModule;
+    readonly signatures: SignaturesModule;
+    readonly keys: KeysModule;
+    private readonly http;
+    constructor(options: QpherOptions);
+}
+//# 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":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAMvC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,KAAK;IAChB,SAAgB,GAAG,EAAE,SAAS,CAAC;IAC/B,SAAgB,UAAU,EAAE,gBAAgB,CAAC;IAC7C,SAAgB,IAAI,EAAE,UAAU,CAAC;IAEjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,OAAO,EAAE,YAAY;CAmBlC"}

package/dist/client.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Main Qpher client class.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Qpher = void 0;
+const http_client_1 = require("./http-client");
+const kem_1 = require("./kem");
+const signatures_1 = require("./signatures");
+const keys_1 = require("./keys");
+const DEFAULT_BASE_URL = 'https://api.qpher.ai';
+const DEFAULT_TIMEOUT = 30_000; // 30 seconds
+const DEFAULT_MAX_RETRIES = 3;
+/**
+ * Qpher PQC API client.
+ *
+ * @example
+ * ```typescript
+ * import { Qpher } from '@qpher/sdk';
+ *
+ * const client = new Qpher({ apiKey: 'qph_live_abc123' });
+ *
+ * const result = await client.kem.encrypt({
+ *   plaintext: Buffer.from('Hello!'),
+ *   keyVersion: 1,
+ * });
+ *
+ * console.log(result.ciphertext);
+ * ```
+ */
+class Qpher {
+    kem;
+    signatures;
+    keys;
+    http;
+    constructor(options) {
+        if (!options.apiKey) {
+            throw new Error('apiKey is required');
+        }
+        if (!options.apiKey.startsWith('qph_')) {
+            throw new Error("apiKey must start with 'qph_'");
+        }
+        this.http = new http_client_1.HttpClient({
+            apiKey: options.apiKey,
+            baseUrl: (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, ''),
+            timeout: options.timeout ?? DEFAULT_TIMEOUT,
+            maxRetries: options.maxRetries ?? DEFAULT_MAX_RETRIES,
+        });
+        this.kem = new kem_1.KEMModule(this.http);
+        this.signatures = new signatures_1.SignaturesModule(this.http);
+        this.keys = new keys_1.KeysModule(this.http);
+    }
+}
+exports.Qpher = Qpher;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,+CAA2C;AAC3C,+BAAkC;AAClC,6CAAgD;AAChD,iCAAoC;AAGpC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAChD,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,aAAa;AAC7C,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,KAAK;IACA,GAAG,CAAY;IACf,UAAU,CAAmB;IAC7B,IAAI,CAAa;IAEhB,IAAI,CAAa;IAElC,YAAY,OAAqB;QAC/B,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,IAAI,wBAAU,CAAC;YACzB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YACjE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,eAAe;YAC3C,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,mBAAmB;SACtD,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,GAAG,IAAI,eAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,IAAI,6BAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,IAAI,iBAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;CACF;AA1BD,sBA0BC"}

package/dist/errors.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Qpher SDK error classes.
+ */
+export declare class QpherError extends Error {
+    readonly errorCode: string;
+    readonly statusCode: number;
+    readonly requestId?: string;
+    constructor(message: string, errorCode: string, statusCode: number, requestId?: string);
+}
+export declare class AuthenticationError extends QpherError {
+    constructor(message: string, errorCode: string, requestId?: string);
+}
+export declare class ValidationError extends QpherError {
+    constructor(message: string, errorCode: string, requestId?: string);
+}
+export declare class NotFoundError extends QpherError {
+    constructor(message: string, errorCode: string, requestId?: string);
+}
+export declare class ForbiddenError extends QpherError {
+    constructor(message: string, errorCode: string, requestId?: string);
+}
+export declare class RateLimitError extends QpherError {
+    constructor(message: string, errorCode: string, requestId?: string);
+}
+export declare class ServerError extends QpherError {
+    constructor(message: string, errorCode: string, statusCode: number, requestId?: string);
+}
+export declare class TimeoutError extends QpherError {
+    constructor(message: string, requestId?: string);
+}
+export declare class ConnectionError extends QpherError {
+    constructor(message: string, requestId?: string);
+}
+export declare function parseErrorResponse(statusCode: number, body: unknown, fallbackMessage: string): QpherError;
+//# 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;;GAEG;AAEH,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGjC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM;CAarB;AAED,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAInE;AAED,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAInE;AAED,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAInE;AAED,qBAAa,cAAe,SAAQ,UAAU;gBAChC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAInE;AAED,qBAAa,cAAe,SAAQ,UAAU;gBAChC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAInE;AAED,qBAAa,WAAY,SAAQ,UAAU;gBAEvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM;CAKrB;AAED,qBAAa,YAAa,SAAQ,UAAU;gBAC9B,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAED,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAaD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,EACb,eAAe,EAAE,MAAM,GACtB,UAAU,CAwBZ"}

package/dist/errors.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Qpher SDK error classes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectionError = exports.TimeoutError = exports.ServerError = exports.RateLimitError = exports.ForbiddenError = exports.NotFoundError = exports.ValidationError = exports.AuthenticationError = exports.QpherError = void 0;
+exports.parseErrorResponse = parseErrorResponse;
+class QpherError extends Error {
+    errorCode;
+    statusCode;
+    requestId;
+    constructor(message, errorCode, statusCode, requestId) {
+        super(message);
+        this.name = 'QpherError';
+        this.errorCode = errorCode;
+        this.statusCode = statusCode;
+        this.requestId = requestId;
+        // Maintain proper stack trace for where error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, QpherError);
+        }
+    }
+}
+exports.QpherError = QpherError;
+class AuthenticationError extends QpherError {
+    constructor(message, errorCode, requestId) {
+        super(message, errorCode, 401, requestId);
+        this.name = 'AuthenticationError';
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+class ValidationError extends QpherError {
+    constructor(message, errorCode, requestId) {
+        super(message, errorCode, 400, requestId);
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+class NotFoundError extends QpherError {
+    constructor(message, errorCode, requestId) {
+        super(message, errorCode, 404, requestId);
+        this.name = 'NotFoundError';
+    }
+}
+exports.NotFoundError = NotFoundError;
+class ForbiddenError extends QpherError {
+    constructor(message, errorCode, requestId) {
+        super(message, errorCode, 403, requestId);
+        this.name = 'ForbiddenError';
+    }
+}
+exports.ForbiddenError = ForbiddenError;
+class RateLimitError extends QpherError {
+    constructor(message, errorCode, requestId) {
+        super(message, errorCode, 429, requestId);
+        this.name = 'RateLimitError';
+    }
+}
+exports.RateLimitError = RateLimitError;
+class ServerError extends QpherError {
+    constructor(message, errorCode, statusCode, requestId) {
+        super(message, errorCode, statusCode, requestId);
+        this.name = 'ServerError';
+    }
+}
+exports.ServerError = ServerError;
+class TimeoutError extends QpherError {
+    constructor(message, requestId) {
+        super(message, 'ERR_TIMEOUT_001', 504, requestId);
+        this.name = 'TimeoutError';
+    }
+}
+exports.TimeoutError = TimeoutError;
+class ConnectionError extends QpherError {
+    constructor(message, requestId) {
+        super(message, 'ERR_SERVICE_001', 503, requestId);
+        this.name = 'ConnectionError';
+    }
+}
+exports.ConnectionError = ConnectionError;
+const STATUS_TO_ERROR = {
+    400: ValidationError,
+    401: AuthenticationError,
+    403: ForbiddenError,
+    404: NotFoundError,
+    429: RateLimitError,
+};
+function parseErrorResponse(statusCode, body, fallbackMessage) {
+    let errorCode = `ERR_UNKNOWN_${statusCode}`;
+    let message = fallbackMessage;
+    let requestId;
+    if (body && typeof body === 'object') {
+        const errorBody = body;
+        if (errorBody.error) {
+            errorCode = errorBody.error.error_code ?? errorCode;
+            message = errorBody.error.message ?? message;
+        }
+        requestId = errorBody.request_id;
+    }
+    const ErrorClass = STATUS_TO_ERROR[statusCode];
+    if (ErrorClass) {
+        return new ErrorClass(message, errorCode, requestId);
+    }
+    return new ServerError(message, errorCode, statusCode, requestId);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/esm/client.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Main Qpher client class.
+ */
+import { KEMModule } from './kem';
+import { SignaturesModule } from './signatures';
+import { KeysModule } from './keys';
+import { QpherOptions } from './types';
+/**
+ * Qpher PQC API client.
+ *
+ * @example
+ * ```typescript
+ * import { Qpher } from '@qpher/sdk';
+ *
+ * const client = new Qpher({ apiKey: 'qph_live_abc123' });
+ *
+ * const result = await client.kem.encrypt({
+ *   plaintext: Buffer.from('Hello!'),
+ *   keyVersion: 1,
+ * });
+ *
+ * console.log(result.ciphertext);
+ * ```
+ */
+export declare class Qpher {
+    readonly kem: KEMModule;
+    readonly signatures: SignaturesModule;
+    readonly keys: KeysModule;
+    private readonly http;
+    constructor(options: QpherOptions);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/esm/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAMvC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,KAAK;IAChB,SAAgB,GAAG,EAAE,SAAS,CAAC;IAC/B,SAAgB,UAAU,EAAE,gBAAgB,CAAC;IAC7C,SAAgB,IAAI,EAAE,UAAU,CAAC;IAEjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;gBAEtB,OAAO,EAAE,YAAY;CAmBlC"}

package/dist/esm/client.js

@@ -0,0 +1,51 @@
+/**
+ * Main Qpher client class.
+ */
+import { HttpClient } from './http-client';
+import { KEMModule } from './kem';
+import { SignaturesModule } from './signatures';
+import { KeysModule } from './keys';
+const DEFAULT_BASE_URL = 'https://api.qpher.ai';
+const DEFAULT_TIMEOUT = 30_000; // 30 seconds
+const DEFAULT_MAX_RETRIES = 3;
+/**
+ * Qpher PQC API client.
+ *
+ * @example
+ * ```typescript
+ * import { Qpher } from '@qpher/sdk';
+ *
+ * const client = new Qpher({ apiKey: 'qph_live_abc123' });
+ *
+ * const result = await client.kem.encrypt({
+ *   plaintext: Buffer.from('Hello!'),
+ *   keyVersion: 1,
+ * });
+ *
+ * console.log(result.ciphertext);
+ * ```
+ */
+export class Qpher {
+    kem;
+    signatures;
+    keys;
+    http;
+    constructor(options) {
+        if (!options.apiKey) {
+            throw new Error('apiKey is required');
+        }
+        if (!options.apiKey.startsWith('qph_')) {
+            throw new Error("apiKey must start with 'qph_'");
+        }
+        this.http = new HttpClient({
+            apiKey: options.apiKey,
+            baseUrl: (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, ''),
+            timeout: options.timeout ?? DEFAULT_TIMEOUT,
+            maxRetries: options.maxRetries ?? DEFAULT_MAX_RETRIES,
+        });
+        this.kem = new KEMModule(this.http);
+        this.signatures = new SignaturesModule(this.http);
+        this.keys = new KeysModule(this.http);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGpC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAChD,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,aAAa;AAC7C,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,KAAK;IACA,GAAG,CAAY;IACf,UAAU,CAAmB;IAC7B,IAAI,CAAa;IAEhB,IAAI,CAAa;IAElC,YAAY,OAAqB;QAC/B,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC;YACzB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YACjE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,eAAe;YAC3C,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,mBAAmB;SACtD,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/esm/errors.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Qpher SDK error classes.
+ */
+export declare class QpherError extends Error {
+    readonly errorCode: string;
+    readonly statusCode: number;
+    readonly requestId?: string;
+    constructor(message: string, errorCode: string, statusCode: number, requestId?: string);
+}
+export declare class AuthenticationError extends QpherError {
+    constructor(message: string, errorCode: string, requestId?: string);
+}
+export declare class ValidationError extends QpherError {
+    constructor(message: string, errorCode: string, requestId?: string);
+}
+export declare class NotFoundError extends QpherError {
+    constructor(message: string, errorCode: string, requestId?: string);
+}
+export declare class ForbiddenError extends QpherError {
+    constructor(message: string, errorCode: string, requestId?: string);
+}
+export declare class RateLimitError extends QpherError {
+    constructor(message: string, errorCode: string, requestId?: string);
+}
+export declare class ServerError extends QpherError {
+    constructor(message: string, errorCode: string, statusCode: number, requestId?: string);
+}
+export declare class TimeoutError extends QpherError {
+    constructor(message: string, requestId?: string);
+}
+export declare class ConnectionError extends QpherError {
+    constructor(message: string, requestId?: string);
+}
+export declare function parseErrorResponse(statusCode: number, body: unknown, fallbackMessage: string): QpherError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGjC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM;CAarB;AAED,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAInE;AAED,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAInE;AAED,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAInE;AAED,qBAAa,cAAe,SAAQ,UAAU;gBAChC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAInE;AAED,qBAAa,cAAe,SAAQ,UAAU;gBAChC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAInE;AAED,qBAAa,WAAY,SAAQ,UAAU;gBAEvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM;CAKrB;AAED,qBAAa,YAAa,SAAQ,UAAU;gBAC9B,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAED,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAaD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,EACb,eAAe,EAAE,MAAM,GACtB,UAAU,CAwBZ"}