@knowzai/api-client 0.1.0

package/dist/resources/search.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import { SearchResultSchema } from './schemas.js';
+export class SearchApi {
+    core;
+    constructor(core) {
+        this.core = core;
+    }
+    async search(query) {
+        // Live route is GET /api/v1/knowledge/search?query=… (returns a bare array of
+        // knowledge DTOs). It takes no limit, so slice client-side.
+        const all = await this.core.request({
+            method: 'GET',
+            path: '/api/v1/knowledge/search',
+            query: { query: query.q },
+            schema: z.array(SearchResultSchema),
+        });
+        const limit = query.limit ?? 10;
+        return limit > 0 ? all.slice(0, limit) : all;
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/resources/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/resources/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AASlD,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,KAAK,CAAC,MAAM,CAAC,KAAkB;QAC7B,8EAA8E;QAC9E,4DAA4D;QAC5D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YAClC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,0BAA0B;YAChC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE;YACzB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;SACpC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/C,CAAC;CACF"}

package/dist/resources/vaults.d.ts

@@ -0,0 +1,14 @@
+import type { CoreClient } from '../contracts.js';
+import type { VaultSummary, VaultDetail, CreateVaultRequest, KnowledgeSummary, Paged } from '@knowzai/types';
+export declare class VaultsApi {
+    private readonly core;
+    constructor(core: CoreClient);
+    list(): Promise<VaultSummary[]>;
+    create(req: CreateVaultRequest): Promise<VaultDetail>;
+    get(id: string): Promise<VaultDetail>;
+    contents(id: string, q?: {
+        page?: number;
+        pageSize?: number;
+    }): Promise<Paged<KnowledgeSummary>>;
+}
+//# sourceMappingURL=vaults.d.ts.map

package/dist/resources/vaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vaults.d.ts","sourceRoot":"","sources":["../../src/resources/vaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,EACN,MAAM,gBAAgB,CAAC;AAIxB,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEvC,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IASrC,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IASrD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ/B,QAAQ,CACZ,EAAE,EAAE,MAAM,EACV,CAAC,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAC3C,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;CASpC"}

package/dist/resources/vaults.js

@@ -0,0 +1,41 @@
+import { VaultSummarySchema, KnowledgeSummarySchema, pagedSchema } from './schemas.js';
+import { toArray, toPaged } from './paging.js';
+export class VaultsApi {
+    core;
+    constructor(core) {
+        this.core = core;
+    }
+    async list() {
+        const data = await this.core.request({
+            method: 'GET',
+            path: '/api/v1/vaults',
+            schema: pagedSchema(VaultSummarySchema),
+        });
+        return toArray(data);
+    }
+    create(req) {
+        return this.core.request({
+            method: 'POST',
+            path: '/api/v1/vaults',
+            body: req,
+            schema: VaultSummarySchema,
+        });
+    }
+    get(id) {
+        return this.core.request({
+            method: 'GET',
+            path: `/api/v1/vaults/${encodeURIComponent(id)}`,
+            schema: VaultSummarySchema,
+        });
+    }
+    async contents(id, q = {}) {
+        const data = await this.core.request({
+            method: 'GET',
+            path: `/api/v1/vaults/${encodeURIComponent(id)}/knowledge`,
+            query: { page: q.page ?? 1, pageSize: q.pageSize ?? 20 },
+            schema: pagedSchema(KnowledgeSummarySchema),
+        });
+        return toPaged(data, q);
+    }
+}
+//# sourceMappingURL=vaults.js.map

package/dist/resources/vaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vaults.js","sourceRoot":"","sources":["../../src/resources/vaults.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACnC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,WAAW,CAAC,kBAAkB,CAAC;SACxC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,IAAa,CAAmB,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,GAAuB;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,kBAAkB;SAC3B,CAAyB,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,EAAE;YAChD,MAAM,EAAE,kBAAkB;SAC3B,CAAyB,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,EAAU,EACV,IAA0C,EAAE;QAE5C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACnC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,YAAY;YAC1D,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE,EAAE;YACxD,MAAM,EAAE,WAAW,CAAC,sBAAsB,CAAC;SAC5C,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,IAAa,EAAE,CAAC,CAA4B,CAAC;IAC9D,CAAC;CACF"}

package/dist/tls.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Enforce TLS: only `https://` is allowed, except for local hosts (used by
+ * `@knowzai/web` and self-hosted dev). Throws synchronously before any request.
+ * (Security requirement S-N3-4.)
+ */
+export declare function assertTlsAllowed(rawUrl: string): void;
+//# sourceMappingURL=tls.d.ts.map

package/dist/tls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tls.d.ts","sourceRoot":"","sources":["../src/tls.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAcrD"}

package/dist/tls.js

@@ -0,0 +1,22 @@
+import { ApiError } from '@knowzai/types';
+const LOCAL_HOSTS = new Set(['localhost', '127.0.0.1', '::1', '[::1]']);
+/**
+ * Enforce TLS: only `https://` is allowed, except for local hosts (used by
+ * `@knowzai/web` and self-hosted dev). Throws synchronously before any request.
+ * (Security requirement S-N3-4.)
+ */
+export function assertTlsAllowed(rawUrl) {
+    let url;
+    try {
+        url = new URL(rawUrl);
+    }
+    catch {
+        throw new ApiError(0, [`Invalid API URL: ${rawUrl}`], { code: 'invalid_url' });
+    }
+    if (url.protocol === 'https:')
+        return;
+    if (url.protocol === 'http:' && LOCAL_HOSTS.has(url.hostname))
+        return;
+    throw new ApiError(0, [`Refusing insecure API URL '${rawUrl}'. Use https:// (http:// is allowed only for localhost).`], { code: 'insecure_url' });
+}
+//# sourceMappingURL=tls.js.map

package/dist/tls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tls.js","sourceRoot":"","sources":["../src/tls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;AAExE;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,CAAC,EAAE,CAAC,oBAAoB,MAAM,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO;IACtC,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO;IACtE,MAAM,IAAI,QAAQ,CAChB,CAAC,EACD,CAAC,8BAA8B,MAAM,0DAA0D,CAAC,EAChG,EAAE,IAAI,EAAE,cAAc,EAAE,CACzB,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@knowzai/api-client",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "p-retry": "^6.2.1",
+    "zod": "^3.24.1",
+    "@knowzai/types": "0.1.0"
+  },
+  "license": "MIT",
+  "author": "Knowz",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/knowz-io/knowz-platform.git",
+    "directory": "cli/api-client"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
+}