@epochcore/qaas-sdk 1.0.0

package/dist/index.mjs

@@ -0,0 +1,198 @@
+// src/index.ts
+var QaaSClient = class {
+  constructor(config = {}) {
+    this.baseUrl = config.baseUrl || "https://api.qaas.epochcoreqcs.com";
+    this.apiKey = config.apiKey;
+    this.timeout = config.timeout || 3e4;
+  }
+  async request(path, options = {}) {
+    const headers = {
+      "Content-Type": "application/json",
+      ...options.headers || {}
+    };
+    if (this.apiKey) {
+      headers["X-API-Key"] = this.apiKey;
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const response = await fetch(`${this.baseUrl}${path}`, {
+        ...options,
+        headers,
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        const error = await response.json().catch(() => ({ error: "Unknown error" }));
+        throw new QaaSError(
+          error.error || `Request failed with status ${response.status}`,
+          response.status,
+          error
+        );
+      }
+      return await response.json();
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  /**
+   * Check API health and status
+   */
+  async health() {
+    return this.request("/health");
+  }
+  /**
+   * Get pricing information for all tiers
+   */
+  async getPricing() {
+    return this.request("/api/pricing");
+  }
+  /**
+   * Get available algorithms for your tier
+   */
+  async getAlgorithms() {
+    return this.request("/api/quantum/algorithms");
+  }
+  /**
+   * Get algorithms filtered by category
+   */
+  async getAlgorithmsByCategory(category) {
+    const response = await this.getAlgorithms();
+    return response.algorithms.filter((algo) => algo.category === category);
+  }
+  /**
+   * Run a quantum algorithm
+   */
+  async runAlgorithm(request) {
+    return this.request("/api/quantum/run", {
+      method: "POST",
+      body: JSON.stringify(request)
+    });
+  }
+  /**
+   * Get current usage statistics
+   */
+  async getUsage() {
+    return this.request("/api/quantum/usage");
+  }
+  // ==========================================
+  // Convenience methods for common algorithms
+  // ==========================================
+  /**
+   * Run Markowitz portfolio optimization (QAOA)
+   */
+  async optimizePortfolio(params) {
+    return this.runAlgorithm({
+      algorithm_id: "QAOA_PORT_001",
+      parameters: {
+        assets: params.assets,
+        returns: params.returns,
+        covariance: params.covariance,
+        risk_tolerance: params.risk_tolerance ?? 0.5
+      },
+      backend: params.backend || "simulator"
+    });
+  }
+  /**
+   * Run Value at Risk (VaR) estimation
+   */
+  async estimateVaR(params) {
+    return this.runAlgorithm({
+      algorithm_id: "AE_PROB_004",
+      parameters: {
+        portfolio_value: params.portfolio_value,
+        returns_history: params.returns_history,
+        confidence_level: params.confidence_level ?? 0.95
+      },
+      backend: params.backend || "simulator"
+    });
+  }
+  /**
+   * Run Grover search for arbitrage opportunities
+   */
+  async findArbitrage(params) {
+    return this.runAlgorithm({
+      algorithm_id: "GROVER_BOOL_003",
+      parameters: {
+        price_matrix: params.price_matrix,
+        threshold: params.threshold ?? 1e-3
+      },
+      backend: params.backend || "simulator"
+    });
+  }
+  /**
+   * Solve a QUBO problem
+   */
+  async solveQUBO(params) {
+    return this.runAlgorithm({
+      algorithm_id: "QAOA_QUBO_001",
+      parameters: {
+        Q: params.Q_matrix,
+        num_reads: params.num_reads ?? 1e3
+      },
+      backend: params.backend || "simulator"
+    });
+  }
+  /**
+   * Run Monte Carlo amplitude estimation
+   */
+  async monteCarloEstimate(params) {
+    return this.runAlgorithm({
+      algorithm_id: "AE_PROB_002",
+      parameters: {
+        target_function: params.target_function,
+        num_samples: params.num_samples ?? 1e4,
+        epsilon: params.epsilon ?? 0.01
+      },
+      backend: params.backend || "simulator"
+    });
+  }
+};
+var QaaSError = class extends Error {
+  constructor(message, statusCode, response) {
+    super(message);
+    this.statusCode = statusCode;
+    this.response = response;
+    this.name = "QaaSError";
+  }
+};
+var qaas = new QaaSClient();
+var ALGORITHMS = {
+  // Amplitude Estimation
+  AMPLITUDE_ESTIMATION: {
+    PROB_001: "AE_PROB_001",
+    PROB_002: "AE_PROB_002",
+    PROB_003: "AE_PROB_003",
+    VAR: "AE_PROB_004",
+    CVAR: "AE_PROB_005"
+  },
+  // Grover Search
+  GROVER: {
+    BOOLEAN_SAT: "GROVER_BOOL_001",
+    PORTFOLIO_CONSTRAINT: "GROVER_BOOL_002",
+    ARBITRAGE: "GROVER_BOOL_003",
+    COMPLIANCE: "GROVER_BOOL_004",
+    PATTERN: "GROVER_BOOL_005"
+  },
+  // QAOA Portfolio
+  QAOA_PORTFOLIO: {
+    MARKOWITZ: "QAOA_PORT_001",
+    RISK_PARITY: "QAOA_PORT_002",
+    MAX_SHARPE: "QAOA_PORT_003",
+    MIN_VARIANCE: "QAOA_PORT_004",
+    BLACK_LITTERMAN: "QAOA_PORT_005"
+  },
+  // QUBO
+  QUBO: {
+    GENERAL: "QAOA_QUBO_001",
+    MAX_CUT: "QAOA_QUBO_002",
+    GRAPH_COLORING: "QAOA_QUBO_003",
+    TSP: "QAOA_QUBO_004",
+    KNAPSACK: "QAOA_QUBO_005"
+  }
+};
+export {
+  ALGORITHMS,
+  QaaSClient,
+  QaaSError,
+  qaas
+};

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@epochcore/qaas-sdk",
+  "version": "1.0.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",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "quantum",
+    "quantum-computing",
+    "qiskit",
+    "cirq",
+    "pennylane",
+    "qaoa",
+    "grover",
+    "amplitude-estimation",
+    "fintech",
+    "portfolio-optimization",
+    "epochcore",
+    "qaas"
+  ],
+  "author": "EpochCore <CEO.QuantumAmazon@EpochCoreQcs.com>",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Jvryan92/qaas-sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/Jvryan92/qaas-sdk/issues"
+  },
+  "homepage": "https://epochcoreqcs.com",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}