@epochcore/qaas-sdk 1.1.0 → 1.2.0

package/dist/index.d.mts

@@ -78,6 +78,26 @@ interface HealthResponse {
     frameworks: string[];
     timestamp: string;
 }
+interface QRNGResponse {
+    bits: number;
+    value: string | number[] | string;
+    format: 'hex' | 'integer' | 'bytes';
+    entropy_source: string;
+    frequency?: number;
+    timestamp: string;
+}
+interface QRNGKeyResponse {
+    key: string;
+    bits: number;
+    algorithm: string;
+    timestamp: string;
+}
+interface QRNGUuidResponse {
+    uuid: string;
+    version: number;
+    algorithm: string;
+    timestamp: string;
+}
 type AlgorithmCategory = 'amplitude_estimation' | 'grover_search' | 'qaoa_optimization' | 'qubo' | 'bernstein_vazirani' | 'deutsch_jozsa' | 'simon' | 'phase_estimation' | 'variational' | 'qml_classification' | 'qml_regression' | 'qml_clustering' | 'qml_anomaly';
 /**
  * EpochCore QaaS Client — Quantum-Hardened
@@ -165,6 +185,34 @@ declare class QaaSClient {
         state?: string;
         strategy?: string;
     }): Promise<Record<string, unknown>>;
+    /**
+     * Generate quantum random bits.
+     *
+     * @param params.bits - Number of random bits (1–4096, default 256)
+     * @param params.format - Output format: 'hex' | 'int' | 'bytes' (default 'hex')
+     */
+    generateQRNG(params?: {
+        bits?: number;
+        format?: 'hex' | 'int' | 'bytes';
+    }): Promise<QRNGResponse>;
+    /**
+     * Generate a quantum random number in the range [0, 1).
+     * Convenience wrapper over generateQRNG for normalized floats.
+     *
+     * @param count - How many floats to generate (1–1024, default 1)
+     * @returns Array of floats in [0, 1), each derived from 32 quantum bits
+     */
+    generateQuantumFloats(count?: number): Promise<number[]>;
+    /**
+     * Generate a quantum-random cryptographic key.
+     *
+     * @param length - Key length in bytes (1–64, default 32)
+     */
+    generateQuantumKey(length?: number): Promise<QRNGKeyResponse>;
+    /**
+     * Generate a quantum-random UUID v4.
+     */
+    generateQuantumUUID(): Promise<QRNGUuidResponse>;
 }
 declare class QaaSError extends Error {
     readonly statusCode: number;
@@ -207,4 +255,4 @@ declare const ALGORITHMS: {
     };
 };
 
-export { ALGORITHMS, type Algorithm, type AlgorithmCategory, type AlgorithmsResponse, type HealthResponse, type PricingResponse, type PricingTier, QaaSClient, type QaaSConfig, QaaSError, QaaSRateLimitError, QaaSValidationError, type RunRequest, type RunResponse, SIGNATURE_MAX_AGE_MS, type UsageResponse };
+export { ALGORITHMS, type Algorithm, type AlgorithmCategory, type AlgorithmsResponse, type HealthResponse, type PricingResponse, type PricingTier, type QRNGKeyResponse, type QRNGResponse, type QRNGUuidResponse, QaaSClient, type QaaSConfig, QaaSError, QaaSRateLimitError, QaaSValidationError, type RunRequest, type RunResponse, SIGNATURE_MAX_AGE_MS, type UsageResponse };

package/dist/index.d.ts

@@ -78,6 +78,26 @@ interface HealthResponse {
     frameworks: string[];
     timestamp: string;
 }
+interface QRNGResponse {
+    bits: number;
+    value: string | number[] | string;
+    format: 'hex' | 'integer' | 'bytes';
+    entropy_source: string;
+    frequency?: number;
+    timestamp: string;
+}
+interface QRNGKeyResponse {
+    key: string;
+    bits: number;
+    algorithm: string;
+    timestamp: string;
+}
+interface QRNGUuidResponse {
+    uuid: string;
+    version: number;
+    algorithm: string;
+    timestamp: string;
+}
 type AlgorithmCategory = 'amplitude_estimation' | 'grover_search' | 'qaoa_optimization' | 'qubo' | 'bernstein_vazirani' | 'deutsch_jozsa' | 'simon' | 'phase_estimation' | 'variational' | 'qml_classification' | 'qml_regression' | 'qml_clustering' | 'qml_anomaly';
 /**
  * EpochCore QaaS Client — Quantum-Hardened
@@ -165,6 +185,34 @@ declare class QaaSClient {
         state?: string;
         strategy?: string;
     }): Promise<Record<string, unknown>>;
+    /**
+     * Generate quantum random bits.
+     *
+     * @param params.bits - Number of random bits (1–4096, default 256)
+     * @param params.format - Output format: 'hex' | 'int' | 'bytes' (default 'hex')
+     */
+    generateQRNG(params?: {
+        bits?: number;
+        format?: 'hex' | 'int' | 'bytes';
+    }): Promise<QRNGResponse>;
+    /**
+     * Generate a quantum random number in the range [0, 1).
+     * Convenience wrapper over generateQRNG for normalized floats.
+     *
+     * @param count - How many floats to generate (1–1024, default 1)
+     * @returns Array of floats in [0, 1), each derived from 32 quantum bits
+     */
+    generateQuantumFloats(count?: number): Promise<number[]>;
+    /**
+     * Generate a quantum-random cryptographic key.
+     *
+     * @param length - Key length in bytes (1–64, default 32)
+     */
+    generateQuantumKey(length?: number): Promise<QRNGKeyResponse>;
+    /**
+     * Generate a quantum-random UUID v4.
+     */
+    generateQuantumUUID(): Promise<QRNGUuidResponse>;
 }
 declare class QaaSError extends Error {
     readonly statusCode: number;
@@ -207,4 +255,4 @@ declare const ALGORITHMS: {
     };
 };
 
-export { ALGORITHMS, type Algorithm, type AlgorithmCategory, type AlgorithmsResponse, type HealthResponse, type PricingResponse, type PricingTier, QaaSClient, type QaaSConfig, QaaSError, QaaSRateLimitError, QaaSValidationError, type RunRequest, type RunResponse, SIGNATURE_MAX_AGE_MS, type UsageResponse };
+export { ALGORITHMS, type Algorithm, type AlgorithmCategory, type AlgorithmsResponse, type HealthResponse, type PricingResponse, type PricingTier, type QRNGKeyResponse, type QRNGResponse, type QRNGUuidResponse, QaaSClient, type QaaSConfig, QaaSError, QaaSRateLimitError, QaaSValidationError, type RunRequest, type RunResponse, SIGNATURE_MAX_AGE_MS, type UsageResponse };

package/dist/index.js

@@ -28,7 +28,7 @@ __export(index_exports, {
   SIGNATURE_MAX_AGE_MS: () => SIGNATURE_MAX_AGE_MS
 });
 module.exports = __toCommonJS(index_exports);
-var SDK_VERSION = "1.1.0";
+var SDK_VERSION = "1.2.0";
 var SDK_USER_AGENT = `EpochCore-QaaS-SDK/${SDK_VERSION}`;
 var _crypto = typeof globalThis.crypto !== "undefined" ? globalThis.crypto : require("crypto").webcrypto;
 var MIN_TIMEOUT_MS = 5e3;
@@ -358,6 +358,81 @@ var QaaSClient = class {
       })
     );
   }
+  // ═══════════════════════════════════════════════════════════════════
+  // Quantum Random Number Generation (QRNG)
+  // ═══════════════════════════════════════════════════════════════════
+  /**
+   * Generate quantum random bits.
+   *
+   * @param params.bits - Number of random bits (1–4096, default 256)
+   * @param params.format - Output format: 'hex' | 'int' | 'bytes' (default 'hex')
+   */
+  async generateQRNG(params = {}) {
+    const bits = params.bits ?? 256;
+    if (typeof bits !== "number" || !Number.isInteger(bits)) {
+      throw new QaaSValidationError("bits must be an integer");
+    }
+    if (bits < 1 || bits > 4096) {
+      throw new QaaSValidationError("bits must be between 1 and 4096");
+    }
+    const format = params.format ?? "hex";
+    if (!["hex", "int", "bytes"].includes(format)) {
+      throw new QaaSValidationError("format must be hex, int, or bytes");
+    }
+    return this.request(
+      "POST",
+      "/v1/random/generate",
+      JSON.stringify({ bits, format })
+    );
+  }
+  /**
+   * Generate a quantum random number in the range [0, 1).
+   * Convenience wrapper over generateQRNG for normalized floats.
+   *
+   * @param count - How many floats to generate (1–1024, default 1)
+   * @returns Array of floats in [0, 1), each derived from 32 quantum bits
+   */
+  async generateQuantumFloats(count = 1) {
+    if (typeof count !== "number" || !Number.isInteger(count)) {
+      throw new QaaSValidationError("count must be an integer");
+    }
+    if (count < 1 || count > 1024) {
+      throw new QaaSValidationError("count must be between 1 and 1024");
+    }
+    const totalBits = count * 32;
+    const response = await this.generateQRNG({ bits: Math.min(totalBits, 4096), format: "bytes" });
+    const bytes = response.value;
+    const floats = [];
+    for (let i = 0; i < count && i * 4 + 3 < bytes.length; i++) {
+      const u32 = (bytes[i * 4] << 24 | bytes[i * 4 + 1] << 16 | bytes[i * 4 + 2] << 8 | bytes[i * 4 + 3]) >>> 0;
+      floats.push(u32 / 4294967295);
+    }
+    return floats;
+  }
+  /**
+   * Generate a quantum-random cryptographic key.
+   *
+   * @param length - Key length in bytes (1–64, default 32)
+   */
+  async generateQuantumKey(length = 32) {
+    if (typeof length !== "number" || !Number.isInteger(length)) {
+      throw new QaaSValidationError("length must be an integer");
+    }
+    if (length < 1 || length > 64) {
+      throw new QaaSValidationError("length must be between 1 and 64");
+    }
+    return this.request(
+      "POST",
+      "/v1/random/key",
+      JSON.stringify({ length })
+    );
+  }
+  /**
+   * Generate a quantum-random UUID v4.
+   */
+  async generateQuantumUUID() {
+    return this.request("POST", "/v1/random/uuid", "{}");
+  }
 };
 var QaaSError = class extends Error {
   constructor(message, statusCode) {

package/dist/index.mjs

@@ -6,7 +6,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // src/index.ts
-var SDK_VERSION = "1.1.0";
+var SDK_VERSION = "1.2.0";
 var SDK_USER_AGENT = `EpochCore-QaaS-SDK/${SDK_VERSION}`;
 var _crypto = typeof globalThis.crypto !== "undefined" ? globalThis.crypto : __require("crypto").webcrypto;
 var MIN_TIMEOUT_MS = 5e3;
@@ -336,6 +336,81 @@ var QaaSClient = class {
       })
     );
   }
+  // ═══════════════════════════════════════════════════════════════════
+  // Quantum Random Number Generation (QRNG)
+  // ═══════════════════════════════════════════════════════════════════
+  /**
+   * Generate quantum random bits.
+   *
+   * @param params.bits - Number of random bits (1–4096, default 256)
+   * @param params.format - Output format: 'hex' | 'int' | 'bytes' (default 'hex')
+   */
+  async generateQRNG(params = {}) {
+    const bits = params.bits ?? 256;
+    if (typeof bits !== "number" || !Number.isInteger(bits)) {
+      throw new QaaSValidationError("bits must be an integer");
+    }
+    if (bits < 1 || bits > 4096) {
+      throw new QaaSValidationError("bits must be between 1 and 4096");
+    }
+    const format = params.format ?? "hex";
+    if (!["hex", "int", "bytes"].includes(format)) {
+      throw new QaaSValidationError("format must be hex, int, or bytes");
+    }
+    return this.request(
+      "POST",
+      "/v1/random/generate",
+      JSON.stringify({ bits, format })
+    );
+  }
+  /**
+   * Generate a quantum random number in the range [0, 1).
+   * Convenience wrapper over generateQRNG for normalized floats.
+   *
+   * @param count - How many floats to generate (1–1024, default 1)
+   * @returns Array of floats in [0, 1), each derived from 32 quantum bits
+   */
+  async generateQuantumFloats(count = 1) {
+    if (typeof count !== "number" || !Number.isInteger(count)) {
+      throw new QaaSValidationError("count must be an integer");
+    }
+    if (count < 1 || count > 1024) {
+      throw new QaaSValidationError("count must be between 1 and 1024");
+    }
+    const totalBits = count * 32;
+    const response = await this.generateQRNG({ bits: Math.min(totalBits, 4096), format: "bytes" });
+    const bytes = response.value;
+    const floats = [];
+    for (let i = 0; i < count && i * 4 + 3 < bytes.length; i++) {
+      const u32 = (bytes[i * 4] << 24 | bytes[i * 4 + 1] << 16 | bytes[i * 4 + 2] << 8 | bytes[i * 4 + 3]) >>> 0;
+      floats.push(u32 / 4294967295);
+    }
+    return floats;
+  }
+  /**
+   * Generate a quantum-random cryptographic key.
+   *
+   * @param length - Key length in bytes (1–64, default 32)
+   */
+  async generateQuantumKey(length = 32) {
+    if (typeof length !== "number" || !Number.isInteger(length)) {
+      throw new QaaSValidationError("length must be an integer");
+    }
+    if (length < 1 || length > 64) {
+      throw new QaaSValidationError("length must be between 1 and 64");
+    }
+    return this.request(
+      "POST",
+      "/v1/random/key",
+      JSON.stringify({ length })
+    );
+  }
+  /**
+   * Generate a quantum-random UUID v4.
+   */
+  async generateQuantumUUID() {
+    return this.request("POST", "/v1/random/uuid", "{}");
+  }
 };
 var QaaSError = class extends Error {
   constructor(message, statusCode) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epochcore/qaas-sdk",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Official SDK for EpochCore Quantum as a Service (QaaS) API - Access 100 quantum computing algorithms",
   "main": "dist/index.js",
   "module": "dist/index.mjs",