@ontologie/cli 0.1.0-preview.1

package/dist/schema/load-schema-file.js

@@ -0,0 +1,88 @@
+/**
+ * Schema file loading — dynamic import with WeakSet deduplication
+ * and clear TypeScript loader error messages.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { isRecord } from './helpers.js';
+export async function loadParseNodeProperties() {
+    const { parseNodeProperties } = await import('@dataforge/types');
+    return parseNodeProperties;
+}
+// ---------------------------------------------------------------------------
+// Schema file loading — dedup via WeakSet, clear TS import error
+// ---------------------------------------------------------------------------
+function isObjectTypeDefinition(value) {
+    if (!isRecord(value) || value._kind !== 'objectType')
+        return false;
+    if (typeof value.apiName !== 'string' || value.apiName.length === 0)
+        return false;
+    return true;
+}
+function isActionDefinition(value) {
+    if (!isRecord(value) || value._kind !== 'action')
+        return false;
+    if (typeof value.apiName !== 'string' && typeof value.key !== 'string')
+        return false;
+    return true;
+}
+function collectSchemaDefinition(value, objectTypes, actions, seen) {
+    if (!value || typeof value !== 'object')
+        return;
+    if (seen.has(value))
+        return;
+    seen.add(value);
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            collectSchemaDefinition(item, objectTypes, actions, seen);
+        }
+        return;
+    }
+    if (isObjectTypeDefinition(value)) {
+        objectTypes.push(value);
+        return;
+    }
+    if (isActionDefinition(value)) {
+        actions.push(value);
+        return;
+    }
+}
+async function importSchemaModule(fileUrl) {
+    try {
+        return await import(fileUrl);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error([
+            `Could not import schema file: ${fileUrl}`,
+            '',
+            'If this is a TypeScript schema file, make sure the CLI is running with a TypeScript loader',
+            'or compile the schema before importing it.',
+            '',
+            `Original error: ${message}`,
+        ].join('\n'));
+    }
+}
+export async function loadSchemaFile(schemaPath) {
+    const abs = path.resolve(schemaPath);
+    if (!fs.existsSync(abs)) {
+        throw new Error(`Schema file not found: ${abs}`);
+    }
+    const fileUrl = pathToFileURL(abs).href;
+    const mod = await importSchemaModule(fileUrl);
+    const objectTypes = [];
+    const actions = [];
+    const seen = new WeakSet();
+    for (const [exportName, value] of Object.entries(mod)) {
+        if (exportName === 'default')
+            continue;
+        collectSchemaDefinition(value, objectTypes, actions, seen);
+    }
+    collectSchemaDefinition(mod.default, objectTypes, actions, seen);
+    if (objectTypes.length === 0) {
+        throw new Error(`No objectType definitions found in ${schemaPath}`);
+    }
+    return { objectTypes, actions };
+}
+//# sourceMappingURL=load-schema-file.js.map

package/dist/schema/load-schema-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-schema-file.js","sourceRoot":"","sources":["../../src/schema/load-schema-file.ts"],"names":[],"mappings":"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"}

package/dist/schema/lockfile.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Lockfile path resolution and atomic file writes.
+ */
+export declare function resolveLockfilePath(schemaPath: string): string;
+export declare function writeTextFileAtomic(filePath: string, content: string): Promise<void>;
+//# sourceMappingURL=lockfile.d.ts.map

package/dist/schema/lockfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockfile.d.ts","sourceRoot":"","sources":["../../src/schema/lockfile.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B1F"}

package/dist/schema/lockfile.js

@@ -0,0 +1,34 @@
+/**
+ * Lockfile path resolution and atomic file writes.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const DEFAULT_LOCK_FILE = 'dataforge.lock';
+export function resolveLockfilePath(schemaPath) {
+    return path.join(path.dirname(path.resolve(schemaPath)), DEFAULT_LOCK_FILE);
+}
+export async function writeTextFileAtomic(filePath, content) {
+    const abs = path.resolve(filePath);
+    const dir = path.dirname(abs);
+    const base = path.basename(abs);
+    const tmp = path.join(dir, `.${base}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`);
+    await fs.promises.mkdir(dir, { recursive: true });
+    try {
+        await fs.promises.writeFile(tmp, content, 'utf-8');
+        // Windows: fs.rename fails if target exists — unlink first
+        if (process.platform === 'win32') {
+            await fs.promises.unlink(abs).catch(() => { });
+        }
+        await fs.promises.rename(tmp, abs);
+    }
+    catch (error) {
+        try {
+            await fs.promises.unlink(tmp);
+        }
+        catch {
+            // Ignore cleanup failure
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=lockfile.js.map

package/dist/schema/lockfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockfile.js","sourceRoot":"","sources":["../../src/schema/lockfile.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAE3C,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAgB,EAAE,OAAe;IACzE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CACnB,GAAG,EACH,IAAI,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CACnF,CAAC;IAEF,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,2DAA2D;QAC3D,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/schema/manifest-client.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Manifest fetching — primary endpoint with fallback to node reconstruction.
+ *
+ * Pagination-safe, numeric ID tolerant, interface-aware, normalized output.
+ */
+import type { OntologyManifest } from '@dataforge/sdk-types';
+import type { createDfClient } from '../client.js';
+export type RawOntologyNode = Record<string, unknown>;
+type ClientInstance = ReturnType<typeof createDfClient>;
+export interface ManifestConfig {
+    workspaceId: string;
+    spaceId?: string;
+}
+export declare function isEndpointUnavailable(error: unknown): boolean;
+export declare function normalizeManifest(manifest: OntologyManifest): OntologyManifest;
+export declare function fetchAllNodes(client: ClientInstance, config: {
+    spaceId?: string;
+}): Promise<RawOntologyNode[]>;
+export declare function fetchAllNodesWithHeaders(client: ClientInstance, config: {
+    spaceId?: string;
+}): Promise<{
+    nodes: RawOntologyNode[];
+    headers: Record<string, string>;
+}>;
+export declare function fetchRemoteManifest(client: ClientInstance, config: ManifestConfig): Promise<OntologyManifest>;
+export declare function fetchFullManifest(client: ClientInstance, config: ManifestConfig): Promise<OntologyManifest>;
+export declare function fetchManifestVersion(client: ClientInstance, config: {
+    spaceId?: string;
+}): Promise<string>;
+export {};
+//# sourceMappingURL=manifest-client.d.ts.map

package/dist/schema/manifest-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-client.d.ts","sourceRoot":"","sources":["../../src/schema/manifest-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAKjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AASnD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiBD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG7D;AA8BD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,gBAAgB,CAe9E;AA4DD,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,eAAe,EAAE,CAAC,CAqB5B;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC;IAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAqBxE;AAmCD,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAuG3B;AAMD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAoB3B;AAMD,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,MAAM,CAAC,CAUjB"}

package/dist/schema/manifest-client.js

@@ -0,0 +1,282 @@
+/**
+ * Manifest fetching — primary endpoint with fallback to node reconstruction.
+ *
+ * Pagination-safe, numeric ID tolerant, interface-aware, normalized output.
+ */
+import { readString, readId, readRecord } from './helpers.js';
+import { loadParseNodeProperties } from './load-schema-file.js';
+import { addWarning } from '../output/warnings.js';
+// ---------------------------------------------------------------------------
+// HTTP status helpers
+// ---------------------------------------------------------------------------
+function getHttpStatus(error) {
+    if (!error || typeof error !== 'object')
+        return undefined;
+    const err = error;
+    const status = err.status ?? err.statusCode ?? err.response?.status;
+    return typeof status === 'number' ? status : undefined;
+}
+export function isEndpointUnavailable(error) {
+    const status = getHttpStatus(error);
+    return status === 404 || status === 405 || status === 501 || status === 502 || status === 503;
+}
+// ---------------------------------------------------------------------------
+// Manifest validation & normalization
+// ---------------------------------------------------------------------------
+function validateManifest(value) {
+    if (!value || typeof value !== 'object') {
+        throw new Error('Invalid ontology manifest: expected object');
+    }
+    const manifest = value;
+    if (!Array.isArray(manifest.objectTypes)) {
+        throw new Error('Invalid ontology manifest: objectTypes must be an array');
+    }
+    if (!Array.isArray(manifest.linkTypes)) {
+        throw new Error('Invalid ontology manifest: linkTypes must be an array');
+    }
+    if (manifest.actions !== undefined && !Array.isArray(manifest.actions)) {
+        throw new Error('Invalid ontology manifest: actions must be an array');
+    }
+    if (manifest.interfaces !== undefined && !Array.isArray(manifest.interfaces)) {
+        throw new Error('Invalid ontology manifest: interfaces must be an array');
+    }
+}
+const _collator = new Intl.Collator('en', { sensitivity: 'base' });
+function byApiName(a, b) {
+    return _collator.compare(a.apiName ?? a.name ?? '', b.apiName ?? b.name ?? '');
+}
+export function normalizeManifest(manifest) {
+    return {
+        ...manifest,
+        objectTypes: [...(manifest.objectTypes ?? [])].map((type) => ({
+            ...type,
+            properties: [...(type.properties ?? [])].sort(byApiName),
+            interfaces: [...(type.interfaces ?? [])].sort(),
+        })).sort(byApiName),
+        linkTypes: [...(manifest.linkTypes ?? [])].sort(byApiName),
+        interfaces: [...(manifest.interfaces ?? [])].map((iface) => ({
+            ...iface,
+            sharedProperties: [...(iface.sharedProperties ?? [])].sort(byApiName),
+        })).sort(byApiName),
+        actions: [...(manifest.actions ?? [])].sort(byApiName),
+    };
+}
+// ---------------------------------------------------------------------------
+// Node fetching — paginated with infinite-loop protection
+// ---------------------------------------------------------------------------
+const NODES_PAGE_LIMIT = 1000;
+const NODES_MAX_PAGES = 100;
+/**
+ * Shared pagination engine for node fetching.
+ * Throws when maxPages is reached (manifest may be incomplete).
+ * Uses JSON.stringify for page keys to avoid false collisions from IDs containing '|'.
+ */
+async function paginateNodes(fetcher) {
+    let offset = 0;
+    const all = [];
+    let firstHeaders = {};
+    const seenPageKeys = new Set();
+    for (let pageIndex = 0; pageIndex < NODES_MAX_PAGES; pageIndex += 1) {
+        const result = await fetcher(offset);
+        if (pageIndex === 0 && result.headers) {
+            firstHeaders = result.headers;
+        }
+        const pageKey = JSON.stringify(result.nodes.map((node) => String(node.id ?? '')));
+        if (pageKey !== '[]' && seenPageKeys.has(pageKey)) {
+            throw new Error('Pagination did not advance while fetching ontology nodes');
+        }
+        seenPageKeys.add(pageKey);
+        all.push(...result.nodes);
+        if (result.nodes.length < NODES_PAGE_LIMIT)
+            break;
+        offset += NODES_PAGE_LIMIT;
+    }
+    // Throw if we exhausted maxPages — manifest may be incomplete
+    if (all.length > 0 && all.length % NODES_PAGE_LIMIT === 0 && all.length / NODES_PAGE_LIMIT >= NODES_MAX_PAGES) {
+        throw new Error(`Pagination limit reached (${NODES_MAX_PAGES} pages, ${all.length} nodes). ` +
+            `Manifest may be incomplete. Contact support if your ontology exceeds ${NODES_MAX_PAGES * NODES_PAGE_LIMIT} nodes.`);
+    }
+    return { nodes: all, firstHeaders };
+}
+export async function fetchAllNodes(client, config) {
+    const { nodes } = await paginateNodes(async (offset) => {
+        const page = await client.transport.request({
+            method: 'GET',
+            path: '/api/v2/queries/nodes',
+            query: {
+                status: 'active',
+                limit: NODES_PAGE_LIMIT,
+                offset,
+                ...(config.spaceId ? { espaceId: config.spaceId } : {}),
+            },
+        });
+        if (!Array.isArray(page)) {
+            throw new Error('Invalid nodes response: expected an array');
+        }
+        return { nodes: page };
+    });
+    return nodes;
+}
+export async function fetchAllNodesWithHeaders(client, config) {
+    const { nodes, firstHeaders } = await paginateNodes(async (offset) => {
+        const response = await client.transport.requestWithHeaders({
+            method: 'GET',
+            path: '/api/v2/queries/nodes',
+            query: {
+                status: 'active',
+                limit: NODES_PAGE_LIMIT,
+                offset,
+                ...(config.spaceId ? { espaceId: config.spaceId } : {}),
+            },
+        });
+        if (!Array.isArray(response.data)) {
+            throw new Error('Invalid nodes response: expected an array');
+        }
+        return { nodes: response.data, headers: response.headers };
+    });
+    return { nodes, headers: firstHeaders };
+}
+// ---------------------------------------------------------------------------
+// Node accessors (numeric ID tolerant)
+// ---------------------------------------------------------------------------
+function getNodeId(node) {
+    const id = readId(node.id);
+    if (!id)
+        throw new Error('Ontology node is missing id');
+    return id;
+}
+function getNodeApiName(node) {
+    const apiName = readString(node.api_name) ??
+        readString(node.apiName) ??
+        readString(node.name);
+    if (!apiName) {
+        throw new Error(`Ontology node ${String(node.id ?? '<unknown>')} is missing apiName/name`);
+    }
+    return apiName;
+}
+function getNodeDisplayName(node) {
+    return (readString(node.displayName) ??
+        readString(node.name) ??
+        getNodeApiName(node));
+}
+// ---------------------------------------------------------------------------
+// fetchRemoteManifest — fallback when /manifest endpoint unavailable
+// ---------------------------------------------------------------------------
+export async function fetchRemoteManifest(client, config) {
+    const normalizeProps = await loadParseNodeProperties();
+    const nodes = await fetchAllNodes(client, config);
+    const objectTypeNodes = nodes.filter((node) => node.type === 'ObjectType');
+    const linkTypeNodes = nodes.filter((node) => node.type === 'LinkType');
+    const interfaceNodes = nodes.filter((node) => node.type === 'Interface');
+    const objectApiNameById = new Map();
+    for (const node of objectTypeNodes) {
+        objectApiNameById.set(getNodeId(node), getNodeApiName(node));
+    }
+    const objectTypes = objectTypeNodes.map((node) => ({
+        id: getNodeId(node),
+        apiName: getNodeApiName(node),
+        displayName: getNodeDisplayName(node),
+        description: readString(node.description),
+        status: 'active',
+        properties: normalizeProps(node.properties),
+        interfaces: [],
+        primaryKey: readString(node.primaryKey) ??
+            readString(node.primary_key),
+    }));
+    const linkTypes = linkTypeNodes.map((node) => {
+        const props = readRecord(node.properties);
+        const sourceId = readId(node.sourceId) ??
+            readId(node.source_id) ??
+            readId(props.sourceId) ??
+            readId(props.source_id);
+        const targetId = readId(node.targetId) ??
+            readId(node.target_id) ??
+            readId(props.targetId) ??
+            readId(props.target_id);
+        const sourceTypeApiName = readString(props.sourceTypeApiName) ??
+            readString(node.sourceTypeApiName) ??
+            (sourceId ? objectApiNameById.get(sourceId) : undefined);
+        const targetTypeApiName = readString(props.targetTypeApiName) ??
+            readString(node.targetTypeApiName) ??
+            (targetId ? objectApiNameById.get(targetId) : undefined);
+        if (!sourceTypeApiName || !targetTypeApiName) {
+            throw new Error(`LinkType ${getNodeApiName(node)} is missing sourceTypeApiName or targetTypeApiName`);
+        }
+        return {
+            id: getNodeId(node),
+            apiName: getNodeApiName(node),
+            sourceTypeApiName,
+            targetTypeApiName,
+            relationshipType: readString(props.relationshipType) ??
+                readString(node.relationshipType) ??
+                readString(node.name) ??
+                getNodeApiName(node),
+            cardinality: readString(props.cardinality) ??
+                readString(node.cardinality) ??
+                'N:1',
+            label: readString(node.label) ??
+                readString(props.label),
+            inverseName: readString(props.inverseName),
+            properties: [],
+        };
+    });
+    const interfaces = interfaceNodes.map((node) => ({
+        id: getNodeId(node),
+        apiName: getNodeApiName(node),
+        displayName: getNodeDisplayName(node),
+        description: readString(node.description),
+        sharedProperties: normalizeProps(node.properties),
+    }));
+    return normalizeManifest({
+        version: '1.0',
+        // Use empty string for generatedAt to prevent lockfile churn on every fetch —
+        // the lockfile should only change when the ontology itself changes.
+        generatedAt: '',
+        workspaceId: config.workspaceId,
+        espaceId: config.spaceId ?? '',
+        objectTypes,
+        linkTypes,
+        interfaces,
+        actions: [],
+    });
+}
+// ---------------------------------------------------------------------------
+// fetchFullManifest — primary endpoint with fallback
+// ---------------------------------------------------------------------------
+export async function fetchFullManifest(client, config) {
+    try {
+        const manifest = await client.transport.request({
+            method: 'GET',
+            path: '/api/v1/ontology/manifest',
+            query: config.spaceId ? { espaceId: config.spaceId } : undefined,
+        });
+        validateManifest(manifest);
+        return normalizeManifest(manifest);
+    }
+    catch (error) {
+        if (!isEndpointUnavailable(error)) {
+            throw error;
+        }
+        addWarning({
+            code: 'MANIFEST_FALLBACK',
+            message: 'Manifest endpoint unavailable — actions are not available in fallback mode.',
+            severity: 'warning',
+        });
+        return fetchRemoteManifest(client, config);
+    }
+}
+// ---------------------------------------------------------------------------
+// fetchManifestVersion — strict for CI
+// ---------------------------------------------------------------------------
+export async function fetchManifestVersion(client, config) {
+    const result = await client.transport.request({
+        method: 'GET',
+        path: '/api/v1/ontology/manifest/version',
+        query: config.spaceId ? { espaceId: config.spaceId } : undefined,
+    });
+    if (!result.version) {
+        throw new Error('Remote manifest version response is missing version');
+    }
+    return result.version;
+}
+//# sourceMappingURL=manifest-client.js.map

package/dist/schema/manifest-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-client.js","sourceRoot":"","sources":["../../src/schema/manifest-client.ts"],"names":[],"mappings":"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"}

package/dist/schema/output.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Schema-specific output helpers.
+ *
+ * Handles structured format detection, error envelope formatting
+ * (json, jsonl, yaml, csv), and command name extraction from CQRS payloads.
+ */
+import { type FormatOptions } from '../output/formatter.js';
+import type { CliError } from '../output/types.js';
+import type { buildCliMeta } from '../output/meta.js';
+type CliMeta = ReturnType<typeof buildCliMeta>;
+export declare function isStructuredFormat(flags: FormatOptions): boolean;
+/**
+ * Write a CliError envelope respecting the requested output format.
+ * - json: pretty-printed JSON
+ * - jsonl: single-line JSON
+ * - yaml/csv: delegated to output()
+ */
+export declare function writeErrorEnvelope(cliError: CliError, meta: CliMeta, flags: FormatOptions): void;
+/**
+ * Extract a human-readable name from a CQRS command payload.
+ * Searches both top-level fields and nested node/edge/action sub-objects.
+ */
+export declare function readCommandName(payload: unknown): string;
+/**
+ * Build a label string from a CQRS command: "CREATE_NODE:Company".
+ */
+export declare function readCommandLabel(command: {
+    type: string;
+    payload: unknown;
+}): string;
+/**
+ * Write a structured CLI error and set the exit code.
+ * Handles both structured (json/jsonl/yaml/csv) and text output.
+ * Use this instead of mixing output() + process.exitCode for error cases.
+ */
+export declare function failCli(error: CliError, meta: CliMeta, flags: FormatOptions): void;
+export {};
+//# sourceMappingURL=output.d.ts.map

package/dist/schema/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/schema/output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAsC,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGhG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AAE/C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAGhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,aAAa,GACnB,IAAI,CAgBN;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CA8BxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAGpF;AAMD;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,aAAa,GACnB,IAAI,CAcN"}

package/dist/schema/output.js

@@ -0,0 +1,95 @@
+/**
+ * Schema-specific output helpers.
+ *
+ * Handles structured format detection, error envelope formatting
+ * (json, jsonl, yaml, csv), and command name extraction from CQRS payloads.
+ */
+import { resolveFormat, output as cliOutput } from '../output/formatter.js';
+// See also: output/errors.ts:buildErrorEnvelope (canonical builder)
+import { buildErrorEnvelope, getExitCode } from '../output/errors.js';
+import { isRecord, readString, readRecord } from './helpers.js';
+export function isStructuredFormat(flags) {
+    const format = resolveFormat(flags);
+    return format === 'json' || format === 'jsonl' || format === 'yaml' || format === 'csv';
+}
+/**
+ * Write a CliError envelope respecting the requested output format.
+ * - json: pretty-printed JSON
+ * - jsonl: single-line JSON
+ * - yaml/csv: delegated to output()
+ */
+export function writeErrorEnvelope(cliError, meta, flags) {
+    const envelope = buildErrorEnvelope(cliError, meta);
+    const format = resolveFormat(flags);
+    if (format === 'jsonl') {
+        process.stdout.write(JSON.stringify(envelope) + '\n');
+        return;
+    }
+    if (format === 'json') {
+        process.stdout.write(JSON.stringify(envelope, null, 2) + '\n');
+        return;
+    }
+    // yaml, csv, or other structured formats
+    cliOutput(envelope, meta, flags);
+}
+/**
+ * Extract a human-readable name from a CQRS command payload.
+ * Searches both top-level fields and nested node/edge/action sub-objects.
+ */
+export function readCommandName(payload) {
+    if (!isRecord(payload))
+        return 'unknown';
+    const direct = readString(payload.name) ??
+        readString(payload.apiName) ??
+        readString(payload.api_name) ??
+        readString(payload.displayName) ??
+        readString(payload.display_name) ??
+        readString(payload.id);
+    if (direct)
+        return direct;
+    for (const key of ['node', 'edge', 'action', 'updates']) {
+        const nested = readRecord(payload[key]);
+        const nestedName = readString(nested.name) ??
+            readString(nested.apiName) ??
+            readString(nested.api_name) ??
+            readString(nested.displayName) ??
+            readString(nested.display_name) ??
+            readString(nested.relationshipType) ??
+            readString(nested.object_type_api_name) ??
+            readString(nested.id);
+        if (nestedName)
+            return nestedName;
+    }
+    return 'unknown';
+}
+/**
+ * Build a label string from a CQRS command: "CREATE_NODE:Company".
+ */
+export function readCommandLabel(command) {
+    const name = readCommandName(command.payload);
+    return name === 'unknown' ? command.type : `${command.type}:${name}`;
+}
+// ---------------------------------------------------------------------------
+// failCli — unified error output for commands
+// ---------------------------------------------------------------------------
+/**
+ * Write a structured CLI error and set the exit code.
+ * Handles both structured (json/jsonl/yaml/csv) and text output.
+ * Use this instead of mixing output() + process.exitCode for error cases.
+ */
+export function failCli(error, meta, flags) {
+    if (isStructuredFormat(flags)) {
+        writeErrorEnvelope(error, meta, flags);
+    }
+    else {
+        process.stderr.write(`Error [${error.code}]: ${error.message}\n`);
+        if (error.details && typeof error.details === 'object') {
+            const hint = error.details.hint;
+            if (typeof hint === 'string') {
+                process.stderr.write(`${hint}\n`);
+            }
+        }
+    }
+    process.exitCode = getExitCode(error.code);
+}
+//# sourceMappingURL=output.js.map

package/dist/schema/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/schema/output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,IAAI,SAAS,EAAsB,MAAM,wBAAwB,CAAC;AAChG,oEAAoE;AACpE,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGtE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAIhE,MAAM,UAAU,kBAAkB,CAAC,KAAoB;IACrD,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,KAAK,CAAC;AAC1F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAkB,EAClB,IAAa,EACb,KAAoB;IAEpB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAEpC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IAED,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IAED,yCAAyC;IACzC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAEzC,MAAM,MAAM,GACV,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;QACxB,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC;QAC3B,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC5B,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC;QAC/B,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC;QAChC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEzB,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAExC,MAAM,UAAU,GACd,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;YACvB,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC;YAC1B,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC3B,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC;YAC9B,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC;YAC/B,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC;YACnC,UAAU,CAAC,MAAM,CAAC,oBAAoB,CAAC;YACvC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAExB,IAAI,UAAU;YAAE,OAAO,UAAU,CAAC;IACpC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA2C;IAC1E,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;AACvE,CAAC;AAED,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,OAAO,CACrB,KAAe,EACf,IAAa,EACb,KAAoB;IAEpB,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QAClE,IAAI,KAAK,CAAC,OAAO,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,IAAI,GAAI,KAAK,CAAC,OAAmC,CAAC,IAAI,CAAC;YAC7D,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC"}

package/dist/stdin.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Stdin ID reader -- reads IDs line-by-line for pipe composition.
+ * Skips empty lines and # comments.
+ *
+ * Usage: ontologie nodes search "Client" --ids-only | ontologie graph neighbors --stdin
+ */
+export declare function readStdinIds(): Promise<string[]>;
+//# sourceMappingURL=stdin.d.ts.map

package/dist/stdin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.d.ts","sourceRoot":"","sources":["../src/stdin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAatD"}