@chainnew/client 0.4.0

package/README.md

@@ -0,0 +1,30 @@
+# @chainnew/client
+
+Typed TypeScript client for the `hyper.chain.new` control-plane API.
+
+## Install
+
+```bash
+npm install @chainnew/client
+```
+
+## Usage
+
+```ts
+import { HyperClient } from "@chainnew/client";
+
+const client = new HyperClient({
+  baseUrl: "http://127.0.0.1:9090",
+});
+
+const health = await client.health();
+console.log(health.status, health.api_version);
+```
+
+## Regeneration
+
+`src/generated.ts` and `src/client.ts` are generated from `docs/api/openapi.yaml`:
+
+```bash
+./scripts/generate-clients.sh
+```

package/dist/client.d.ts

@@ -0,0 +1,78 @@
+import type { components } from "./generated";
+/** API error with status code and typed body. */
+export declare class HyperApiError extends Error {
+    readonly status: number;
+    readonly body: components["schemas"]["ErrorResponse"];
+    constructor(status: number, body: components["schemas"]["ErrorResponse"]);
+}
+/** Configuration for the HyperClient. */
+export interface HyperClientConfig {
+    /** Base URL of the hyper.chain.new API (e.g. https://localhost:8443). */
+    baseUrl: string;
+    /** Auth credentials injected into every request. */
+    auth?: {
+        type: "bearer";
+        token: string;
+    } | {
+        type: "serviceToken";
+        token: string;
+    };
+}
+/** Typed HTTP client for the hyper.chain.new API. Uses native fetch. */
+export declare class HyperClient {
+    private readonly baseUrl;
+    private readonly auth;
+    constructor(config: HyperClientConfig);
+    private headers;
+    private request;
+    /** POST /api/v1/auth/bootstrap */
+    authBootstrap(body: components["schemas"]["BootstrapAuthRequest"]): Promise<components["schemas"]["TokenResponse"]>;
+    /** POST /api/v1/auth/rotate */
+    authRotate(): Promise<components["schemas"]["TokenResponse"]>;
+    /** POST /api/v1/auth/service-token */
+    authServiceToken(body: components["schemas"]["ServiceTokenRequest"]): Promise<components["schemas"]["TokenResponse"]>;
+    /** POST /api/v1/cyber/session/create */
+    cyberSessionCreate(body: components["schemas"]["CyberSessionCreateRequest"]): Promise<components["schemas"]["CyberSessionResponse"]>;
+    /** DELETE /api/v1/cyber/session/{session_id}/artifacts/{sample_id} */
+    cyberArtifactDelete(session_id: string, sample_id: string): Promise<components["schemas"]["CyberArtifactActionResponse"]>;
+    /** POST /api/v1/cyber/session/{session_id}/artifacts/{sample_id}/pin */
+    cyberArtifactPin(session_id: string, sample_id: string): Promise<components["schemas"]["CyberArtifactActionResponse"]>;
+    /** POST /api/v1/cyber/session/{session_id}/artifacts/{sample_id}/unpin */
+    cyberArtifactUnpin(session_id: string, sample_id: string): Promise<components["schemas"]["CyberArtifactActionResponse"]>;
+    /** POST /api/v1/cyber/session/{session_id}/ingest */
+    cyberSampleIngest(session_id: string, body: components["schemas"]["CyberIngestRequest"]): Promise<components["schemas"]["CyberArtifactResponse"]>;
+    /** GET /api/v1/image-cache/status */
+    imageCacheStatus(): Promise<components["schemas"]["ImageCacheStatus"]>;
+    /** GET /api/v1/operations */
+    operationsList(): Promise<components["schemas"]["OperationsPageResponse"]>;
+    /** GET /api/v1/operations/failed */
+    operationsFailed(): Promise<components["schemas"]["DlqPageResponse"]>;
+    /** GET /api/v1/ops/{id} */
+    operationStatus(id: string): Promise<components["schemas"]["OperationRecord"]>;
+    /** GET /api/v1/service/ping */
+    servicePing(): Promise<components["schemas"]["ServicePingResponse"]>;
+    /** POST /api/v1/snapshot/{id}/clone */
+    snapshotClone(id: string, body: components["schemas"]["SnapshotCloneHttpRequest"]): Promise<components["schemas"]["SnapshotResponse"]>;
+    /** POST /api/v1/snapshot/{id}/restore */
+    snapshotRestore(id: string, body: components["schemas"]["SnapshotRestoreHttpRequest"]): Promise<components["schemas"]["SnapshotResponse"]>;
+    /** GET /api/v1/system/safety */
+    systemSafety(): Promise<components["schemas"]["SystemSafety"]>;
+    /** GET /api/v1/ui/state */
+    uiState(): Promise<components["schemas"]["UiState"]>;
+    /** POST /api/v1/vault/prepare-operation */
+    vaultPrepareOperation(body: components["schemas"]["PrepareOperationRequest"]): Promise<components["schemas"]["PrepareOperationResponse"]>;
+    /** POST /api/v1/vm/create */
+    vmCreate(body: components["schemas"]["CreateVmRequest"]): Promise<components["schemas"]["OperationRecord"]>;
+    /** POST /api/v1/vm/{id}/destroy */
+    vmDestroy(id: string): Promise<components["schemas"]["OperationRecord"]>;
+    /** POST /api/v1/vm/{id}/snapshot */
+    snapshotCreate(id: string, body: components["schemas"]["SnapshotCreateHttpRequest"]): Promise<components["schemas"]["SnapshotResponse"]>;
+    /** GET /api/v1/vm/{id}/snapshots */
+    snapshotList(id: string): Promise<components["schemas"]["SnapshotPageResponse"]>;
+    /** POST /api/v1/vm/{id}/start */
+    vmStart(id: string): Promise<components["schemas"]["OperationRecord"]>;
+    /** POST /api/v1/vm/{id}/stop */
+    vmStop(id: string): Promise<components["schemas"]["OperationRecord"]>;
+    /** GET /health */
+    health(): Promise<components["schemas"]["HealthResponse"]>;
+}

package/dist/client.js

@@ -0,0 +1,143 @@
+// AUTO-GENERATED from docs/api/openapi.yaml — do not edit manually.
+// Regenerate: ./scripts/generate-clients.sh
+/** API error with status code and typed body. */
+export class HyperApiError extends Error {
+    constructor(status, body) {
+        super(`${body.error}: ${body.message}`);
+        this.status = status;
+        this.body = body;
+        this.name = "HyperApiError";
+    }
+}
+/** Typed HTTP client for the hyper.chain.new API. Uses native fetch. */
+export class HyperClient {
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, "");
+        this.auth = config.auth;
+    }
+    headers() {
+        const h = { "Content-Type": "application/json" };
+        if (this.auth) {
+            if (this.auth.type === "bearer") {
+                h.Authorization = `Bearer ${this.auth.token}`;
+            }
+            else {
+                h["x-service-token"] = this.auth.token;
+            }
+        }
+        return h;
+    }
+    async request(method, path, body) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers: this.headers(),
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            const errBody = (await res.json());
+            throw new HyperApiError(res.status, errBody);
+        }
+        return (await res.json());
+    }
+    // --- generated methods ------------------------------------------------
+    /** POST /api/v1/auth/bootstrap */
+    async authBootstrap(body) {
+        return this.request("POST", "/api/v1/auth/bootstrap", body);
+    }
+    /** POST /api/v1/auth/rotate */
+    async authRotate() {
+        return this.request("POST", "/api/v1/auth/rotate");
+    }
+    /** POST /api/v1/auth/service-token */
+    async authServiceToken(body) {
+        return this.request("POST", "/api/v1/auth/service-token", body);
+    }
+    /** POST /api/v1/cyber/session/create */
+    async cyberSessionCreate(body) {
+        return this.request("POST", "/api/v1/cyber/session/create", body);
+    }
+    /** DELETE /api/v1/cyber/session/{session_id}/artifacts/{sample_id} */
+    async cyberArtifactDelete(session_id, sample_id) {
+        return this.request("DELETE", `/api/v1/cyber/session/${encodeURIComponent(session_id)}/artifacts/${encodeURIComponent(sample_id)}`);
+    }
+    /** POST /api/v1/cyber/session/{session_id}/artifacts/{sample_id}/pin */
+    async cyberArtifactPin(session_id, sample_id) {
+        return this.request("POST", `/api/v1/cyber/session/${encodeURIComponent(session_id)}/artifacts/${encodeURIComponent(sample_id)}/pin`);
+    }
+    /** POST /api/v1/cyber/session/{session_id}/artifacts/{sample_id}/unpin */
+    async cyberArtifactUnpin(session_id, sample_id) {
+        return this.request("POST", `/api/v1/cyber/session/${encodeURIComponent(session_id)}/artifacts/${encodeURIComponent(sample_id)}/unpin`);
+    }
+    /** POST /api/v1/cyber/session/{session_id}/ingest */
+    async cyberSampleIngest(session_id, body) {
+        return this.request("POST", `/api/v1/cyber/session/${encodeURIComponent(session_id)}/ingest`, body);
+    }
+    /** GET /api/v1/image-cache/status */
+    async imageCacheStatus() {
+        return this.request("GET", "/api/v1/image-cache/status");
+    }
+    /** GET /api/v1/operations */
+    async operationsList() {
+        return this.request("GET", "/api/v1/operations");
+    }
+    /** GET /api/v1/operations/failed */
+    async operationsFailed() {
+        return this.request("GET", "/api/v1/operations/failed");
+    }
+    /** GET /api/v1/ops/{id} */
+    async operationStatus(id) {
+        return this.request("GET", `/api/v1/ops/${encodeURIComponent(id)}`);
+    }
+    /** GET /api/v1/service/ping */
+    async servicePing() {
+        return this.request("GET", "/api/v1/service/ping");
+    }
+    /** POST /api/v1/snapshot/{id}/clone */
+    async snapshotClone(id, body) {
+        return this.request("POST", `/api/v1/snapshot/${encodeURIComponent(id)}/clone`, body);
+    }
+    /** POST /api/v1/snapshot/{id}/restore */
+    async snapshotRestore(id, body) {
+        return this.request("POST", `/api/v1/snapshot/${encodeURIComponent(id)}/restore`, body);
+    }
+    /** GET /api/v1/system/safety */
+    async systemSafety() {
+        return this.request("GET", "/api/v1/system/safety");
+    }
+    /** GET /api/v1/ui/state */
+    async uiState() {
+        return this.request("GET", "/api/v1/ui/state");
+    }
+    /** POST /api/v1/vault/prepare-operation */
+    async vaultPrepareOperation(body) {
+        return this.request("POST", "/api/v1/vault/prepare-operation", body);
+    }
+    /** POST /api/v1/vm/create */
+    async vmCreate(body) {
+        return this.request("POST", "/api/v1/vm/create", body);
+    }
+    /** POST /api/v1/vm/{id}/destroy */
+    async vmDestroy(id) {
+        return this.request("POST", `/api/v1/vm/${encodeURIComponent(id)}/destroy`);
+    }
+    /** POST /api/v1/vm/{id}/snapshot */
+    async snapshotCreate(id, body) {
+        return this.request("POST", `/api/v1/vm/${encodeURIComponent(id)}/snapshot`, body);
+    }
+    /** GET /api/v1/vm/{id}/snapshots */
+    async snapshotList(id) {
+        return this.request("GET", `/api/v1/vm/${encodeURIComponent(id)}/snapshots`);
+    }
+    /** POST /api/v1/vm/{id}/start */
+    async vmStart(id) {
+        return this.request("POST", `/api/v1/vm/${encodeURIComponent(id)}/start`);
+    }
+    /** POST /api/v1/vm/{id}/stop */
+    async vmStop(id) {
+        return this.request("POST", `/api/v1/vm/${encodeURIComponent(id)}/stop`);
+    }
+    /** GET /health */
+    async health() {
+        return this.request("GET", "/health");
+    }
+}