@kweaver-ai/kweaver-sdk 0.5.1 → 0.5.2

package/dist/commands/bkn-utils.d.ts

@@ -0,0 +1,36 @@
+export interface PollOptions<T> {
+    fn: () => Promise<{
+        done: boolean;
+        value: T;
+    }>;
+    interval: number;
+    timeout: number;
+    maxInterval?: number;
+    _sleep?: (ms: number) => Promise<void>;
+}
+export declare function pollWithBackoff<T>(opts: PollOptions<T>): Promise<T>;
+export declare function parseJsonObject(text: string, errorMessage: string): Record<string, unknown>;
+export declare function parseSearchAfterArray(text: string): unknown[];
+/** Parse common flags for ontology-query subcommands; returns { filteredArgs, pretty, businessDomain } */
+export declare function parseOntologyQueryFlags(args: string[]): {
+    filteredArgs: string[];
+    pretty: boolean;
+    businessDomain: string;
+};
+export declare const DISPLAY_HINTS: string[];
+/** Detect primary key: first column (left-to-right) with all unique values in the sample. */
+export declare function detectPrimaryKey(table: {
+    name: string;
+    columns: Array<{
+        name: string;
+        type: string;
+    }>;
+}, rows?: Array<Record<string, string | null>>): string;
+export declare function detectDisplayKey(table: {
+    name: string;
+    columns: Array<{
+        name: string;
+        type: string;
+    }>;
+}, primaryKey: string): string;
+export declare function confirmYes(prompt: string): Promise<boolean>;

package/dist/commands/bkn-utils.js

@@ -0,0 +1,102 @@
+import { createInterface } from "node:readline";
+import { resolveBusinessDomain } from "../config/store.js";
+export async function pollWithBackoff(opts) {
+    const { fn, timeout, maxInterval = 15000, _sleep = (ms) => new Promise(r => setTimeout(r, ms)) } = opts;
+    let currentInterval = opts.interval;
+    const deadline = Date.now() + timeout;
+    while (Date.now() < deadline) {
+        const result = await fn();
+        if (result.done)
+            return result.value;
+        await _sleep(currentInterval);
+        currentInterval = Math.min(currentInterval * 2, maxInterval);
+    }
+    throw new Error(`Polling timed out after ${timeout}ms`);
+}
+// ── JSON parsing helpers ─────────────────────────────────────────────────────
+export function parseJsonObject(text, errorMessage) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new Error(errorMessage);
+    }
+    if (!parsed || Array.isArray(parsed) || typeof parsed !== "object") {
+        throw new Error(errorMessage);
+    }
+    return parsed;
+}
+export function parseSearchAfterArray(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new Error("Invalid value for --search-after. Expected a JSON array string.");
+    }
+    if (!Array.isArray(parsed)) {
+        throw new Error("Invalid value for --search-after. Expected a JSON array string.");
+    }
+    return parsed;
+}
+// ── Ontology query flag parsing ──────────────────────────────────────────────
+/** Parse common flags for ontology-query subcommands; returns { filteredArgs, pretty, businessDomain } */
+export function parseOntologyQueryFlags(args) {
+    let pretty = true;
+    let businessDomain = "";
+    const filteredArgs = [];
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === "--help" || arg === "-h") {
+            throw new Error("help");
+        }
+        if (arg === "--pretty") {
+            pretty = true;
+            continue;
+        }
+        if ((arg === "-bd" || arg === "--biz-domain") && args[i + 1]) {
+            businessDomain = args[i + 1];
+            i += 1;
+            continue;
+        }
+        filteredArgs.push(arg);
+    }
+    if (!businessDomain)
+        businessDomain = resolveBusinessDomain();
+    return { filteredArgs, pretty, businessDomain };
+}
+// ── Schema detection helpers ─────────────────────────────────────────────────
+export const DISPLAY_HINTS = ["name", "title", "label", "display_name", "description"];
+/** Detect primary key: first column (left-to-right) with all unique values in the sample. */
+export function detectPrimaryKey(table, rows) {
+    if (rows && rows.length > 0) {
+        for (const col of table.columns) {
+            const values = rows.map((r) => r[col.name]);
+            const unique = new Set(values);
+            if (unique.size === rows.length)
+                return col.name;
+        }
+    }
+    // Fallback: first column
+    return table.columns[0]?.name ?? "id";
+}
+export function detectDisplayKey(table, primaryKey) {
+    for (const col of table.columns) {
+        if (DISPLAY_HINTS.some((h) => col.name.toLowerCase().includes(h))) {
+            return col.name;
+        }
+    }
+    return primaryKey;
+}
+// ── Interactive confirmation ─────────────────────────────────────────────────
+export function confirmYes(prompt) {
+    return new Promise((resolve) => {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(`${prompt} [y/N] `, (answer) => {
+            rl.close();
+            const trimmed = answer.trim().toLowerCase();
+            resolve(trimmed === "y" || trimmed === "yes");
+        });
+    });
+}

package/dist/commands/bkn.d.ts

@@ -1,15 +1,10 @@
-import { type BknEncodingImportOptions } from "../utils/bkn-encoding.js";
-export interface PollOptions<T> {
-    fn: () => Promise<{
-        done: boolean;
-        value: T;
-    }>;
-    interval: number;
-    timeout: number;
-    maxInterval?: number;
-    _sleep?: (ms: number) => Promise<void>;
-}
-export declare function pollWithBackoff<T>(opts: PollOptions<T>): Promise<T>;
+export { pollWithBackoff, parseOntologyQueryFlags, parseJsonObject, parseSearchAfterArray, confirmYes, DISPLAY_HINTS, detectPrimaryKey, detectDisplayKey, } from "./bkn-utils.js";
+export type { PollOptions } from "./bkn-utils.js";
+export { parseObjectTypeCreateArgs, finalizeObjectTypeCreateFromDataview, ensureMappedFieldOnDataProperty, normalizeAdpFieldType, parseKnObjectTypeQueryArgs, parseKnActionTypeExecuteArgs, parseRelationTypeCreateArgs, applyObjectTypeMerge, stripObjectTypeForPut, parseObjectTypeUpdateArgs, parseObjectTypeDeleteArgs, parseRelationTypeUpdateArgs, parseRelationTypeDeleteArgs, runKnObjectTypeCommand, runKnRelationTypeCommand, runKnActionTypeCommand, parseConceptGroupArgs, } from "./bkn-schema.js";
+export type { KnObjectTypeQueryOptions, KnActionTypeExecuteOptions, ObjectTypeMergeFields, ObjectTypeUpdateParsed, ObjectTypeCreateParsed, } from "./bkn-schema.js";
+export { parseKnSearchArgs } from "./bkn-query.js";
+export { parseKnBuildArgs, parseKnPushArgs, parseKnPullArgs, packDirectoryToTar, extractTarToDirectory, parseActionScheduleArgs, parseJobArgs, } from "./bkn-ops.js";
+export type { KnPushOptions, KnPullOptions } from "./bkn-ops.js";
 export interface KnListOptions {
     offset: number;
     limit: number;
@@ -53,105 +48,4 @@ export interface KnDeleteOptions {
     yes: boolean;
 }
 export declare function parseKnDeleteArgs(args: string[]): KnDeleteOptions;
-export interface KnPushOptions {
-    directory: string;
-    branch: string;
-    businessDomain: string;
-    pretty: boolean;
-    encodingOptions: BknEncodingImportOptions;
-}
-export declare function parseKnPushArgs(args: string[]): KnPushOptions;
-export interface KnPullOptions {
-    knId: string;
-    directory: string;
-    branch: string;
-    businessDomain: string;
-}
-export declare function parseKnPullArgs(args: string[]): KnPullOptions;
-export interface KnObjectTypeQueryOptions {
-    knId: string;
-    otId: string;
-    body: string;
-    pretty: boolean;
-    businessDomain: string;
-}
-export declare function parseKnObjectTypeQueryArgs(args: string[]): KnObjectTypeQueryOptions;
 export declare function runKnCommand(args: string[]): Promise<number>;
-/** Parse object-type create args: --name --dataview-id --primary-key --display-key [--property '<json>' ...] */
-export declare function parseObjectTypeCreateArgs(args: string[]): {
-    knId: string;
-    body: string;
-    businessDomain: string;
-    branch: string;
-    pretty: boolean;
-};
-/** Fields merged via GET → modify → PUT (not raw body mode). */
-export interface ObjectTypeMergeFields {
-    name?: string;
-    displayKey?: string;
-    addProperties: Record<string, unknown>[];
-    removeProperties: string[];
-    tags?: string[];
-    comment?: string;
-    icon?: string;
-    color?: string;
-}
-export type ObjectTypeUpdateParsed = {
-    mode: "body";
-    knId: string;
-    otId: string;
-    body: string;
-    businessDomain: string;
-    pretty: boolean;
-} | {
-    mode: "merge";
-    knId: string;
-    otId: string;
-    merge: ObjectTypeMergeFields;
-    businessDomain: string;
-    pretty: boolean;
-    branch: string;
-};
-/** Prepare a GET response entry for PUT (drop read-only fields). */
-export declare function stripObjectTypeForPut(entry: Record<string, unknown>): Record<string, unknown>;
-/**
- * Apply merge flags onto a stripped object-type object (mutates copy).
- * - Add: property `name` not in list → append.
- * - Update: property `name` exists → replace entry (same as add; CLI also accepts `--update-property`).
- * - Delete: `--remove-property` removes by `name` before adds are applied.
- */
-export declare function applyObjectTypeMerge(target: Record<string, unknown>, merge: ObjectTypeMergeFields): Record<string, unknown>;
-export interface KnActionTypeExecuteOptions {
-    knId: string;
-    atId: string;
-    body: string;
-    pretty: boolean;
-    businessDomain: string;
-    wait: boolean;
-    timeout: number;
-}
-export declare function parseKnActionTypeExecuteArgs(args: string[]): KnActionTypeExecuteOptions;
-/** Parse relation-type create args: --name --source --target [--mapping src:tgt ...] */
-export declare function parseRelationTypeCreateArgs(args: string[]): {
-    knId: string;
-    body: string;
-    businessDomain: string;
-    branch: string;
-    pretty: boolean;
-};
-export declare function parseKnBuildArgs(args: string[]): {
-    knId: string;
-    wait: boolean;
-    timeout: number;
-    businessDomain: string;
-};
-export declare function packDirectoryToTar(dirPath: string): Buffer;
-export declare function extractTarToDirectory(tarBuffer: Buffer, dirPath: string): void;
-export declare function parseKnSearchArgs(args: string[]): {
-    knId: string;
-    query: string;
-    maxConcepts: number;
-    mode: string;
-    pretty: boolean;
-    businessDomain: string;
-};