@nimba/api-client 2.5.0

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @nimba/api-client — the typed SDK over the Nimba HTTP API.
+ *
+ * Every client (CLI, web, anything else) talks to @nimba/server through this,
+ * and NEVER imports the engine, the bridge, or the tasks. This package has no
+ * dependency on the server-internal half of the monorepo — that boundary is the
+ * point.
+ */
+export interface NimbaApiClientOptions {
+    /** Base URL of the Nimba server, e.g. "http://localhost:3000". */
+    baseUrl: string;
+    /** Bearer token for the Nimba API, when authentication is enabled. */
+    token?: string;
+}
+export interface HealthResponse {
+    status: string;
+}
+export interface FlowSummary {
+    name: string;
+    description: string;
+}
+export interface FlowInfo {
+    name: string;
+    description: string;
+    unimplemented: string[];
+    steps: unknown[];
+}
+export interface FlowRunResponse {
+    flow: string;
+    success: boolean;
+    duration: number;
+    error?: string;
+    steps: Array<{
+        stepNumber: number;
+        name: string;
+        skipped: boolean;
+        success: boolean;
+        data?: unknown;
+        error?: string;
+    }>;
+}
+export declare class NimbaApiClient {
+    private readonly options;
+    constructor(options: NimbaApiClientOptions);
+    /** Liveness check against the server's /health endpoint. */
+    health(): Promise<HealthResponse>;
+    /** List the available flows. */
+    listFlows(): Promise<FlowSummary[]>;
+    /** Get a flow's expanded step plan and unimplemented-task list. */
+    getFlow(name: string): Promise<FlowInfo>;
+    /** Run a flow against an org and return the result. */
+    runFlow(name: string, org: string, params?: Record<string, unknown>): Promise<FlowRunResponse>;
+    private get;
+    private post;
+    private authHeaders;
+}
+//# 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;;;;;;;GAOG;AAEH,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxH;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,qBAAqB;IAE3D,4DAA4D;IAC5D,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAIjC,gCAAgC;IAChC,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAInC,mEAAmE;IACnE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIxC,uDAAuD;IACvD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,eAAe,CAAC;YAIpF,GAAG;YAMH,IAAI;IAUlB,OAAO,CAAC,WAAW;CAGpB"}

package/dist/index.js

@@ -0,0 +1,50 @@
+/**
+ * @nimba/api-client — the typed SDK over the Nimba HTTP API.
+ *
+ * Every client (CLI, web, anything else) talks to @nimba/server through this,
+ * and NEVER imports the engine, the bridge, or the tasks. This package has no
+ * dependency on the server-internal half of the monorepo — that boundary is the
+ * point.
+ */
+export class NimbaApiClient {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /** Liveness check against the server's /health endpoint. */
+    health() {
+        return this.get('/health');
+    }
+    /** List the available flows. */
+    listFlows() {
+        return this.get('/flows');
+    }
+    /** Get a flow's expanded step plan and unimplemented-task list. */
+    getFlow(name) {
+        return this.get(`/flows/${encodeURIComponent(name)}`);
+    }
+    /** Run a flow against an org and return the result. */
+    runFlow(name, org, params = {}) {
+        return this.post(`/flows/${encodeURIComponent(name)}/run`, { org, params });
+    }
+    async get(path) {
+        const res = await fetch(new URL(path, this.options.baseUrl), { headers: this.authHeaders() });
+        if (!res.ok)
+            throw new Error(`Nimba API GET ${path} failed: ${res.status} ${res.statusText}`);
+        return (await res.json());
+    }
+    async post(path, body) {
+        const res = await fetch(new URL(path, this.options.baseUrl), {
+            method: 'POST',
+            headers: { ...this.authHeaders(), 'content-type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw new Error(`Nimba API POST ${path} failed: ${res.status} ${res.statusText}`);
+        return (await res.json());
+    }
+    authHeaders() {
+        return this.options.token ? { authorization: `Bearer ${this.options.token}` } : {};
+    }
+}
+//# 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;;;;;;;GAOG;AAiCH,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,OAA8B;QAA9B,YAAO,GAAP,OAAO,CAAuB;IAAG,CAAC;IAE/D,4DAA4D;IAC5D,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAAiB,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,gCAAgC;IAChC,SAAS;QACP,OAAO,IAAI,CAAC,GAAG,CAAgB,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,mEAAmE;IACnE,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,GAAG,CAAW,UAAU,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,uDAAuD;IACvD,OAAO,CAAC,IAAY,EAAE,GAAW,EAAE,SAAkC,EAAE;QACrE,OAAO,IAAI,CAAC,IAAI,CAAkB,UAAU,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/F,CAAC;IAEO,KAAK,CAAC,GAAG,CAAI,IAAY;QAC/B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC9F,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,YAAY,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9F,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;IACjC,CAAC;IAEO,KAAK,CAAC,IAAI,CAAI,IAAY,EAAE,IAAa;QAC/C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC3D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YACtE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,YAAY,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC/F,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;IACjC,CAAC;IAEO,WAAW;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrF,CAAC;CACF"}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@nimba/api-client",
+  "version": "2.5.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b --noEmit",
+    "clean": "rimraf dist *.tsbuildinfo",
+    "test": "vitest run --passWithNoTests"
+  }
+}