@loxtep/sdk 0.1.0

package/dist/client/workflows-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows-types.js","sourceRoot":"","sources":["../../src/client/workflows-types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/client/workflows.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Workflows API: listWorkflows, getWorkflowGraph, createWorkflow, deploy.
+ * Backend: workflows microservice (/workflows/workflows, graph, projects/:id/deploy).
+ */
+import type { LoxtepHttpClient } from '../http/client.js';
+import type { WorkflowsListFilters, WorkflowsListResponse, GetWorkflowGraphResponse, DeployInput, DeployResponse, CreateWorkflowInput } from './workflows-types.js';
+import type { Flow } from './flow-types.js';
+export type WorkflowsApi = {
+    listWorkflows: (filters: WorkflowsListFilters) => Promise<WorkflowsListResponse['data']>;
+    getWorkflowGraph: (workflow_id: string, project_id: string) => Promise<GetWorkflowGraphResponse['data']>;
+    createWorkflow: (input: CreateWorkflowInput) => Promise<Flow>;
+    deploy: (input: DeployInput) => Promise<DeployResponse['data']>;
+};
+export declare function createWorkflowsApi(http: LoxtepHttpClient): WorkflowsApi;
+//# sourceMappingURL=workflows.d.ts.map

package/dist/client/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/client/workflows.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,WAAW,EACX,cAAc,EACd,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAe5C,MAAM,MAAM,YAAY,GAAG;IACzB,aAAa,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IACzF,gBAAgB,EAAE,CAChB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,cAAc,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;CACjE,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAyCvE"}

package/dist/client/workflows.js

@@ -0,0 +1,50 @@
+/**
+ * Workflows API: listWorkflows, getWorkflowGraph, createWorkflow, deploy.
+ * Backend: workflows microservice (/workflows/workflows, graph, projects/:id/deploy).
+ */
+const WORKFLOWS_BASE = '/workflows/workflows';
+const PROJECTS_BASE = '/workflows/projects';
+function buildQueryString(params) {
+    const search = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v === undefined || v === null)
+            continue;
+        search.set(k, String(v));
+    }
+    const qs = search.toString();
+    return qs ? `?${qs}` : '';
+}
+export function createWorkflowsApi(http) {
+    const api = {
+        async listWorkflows(filters) {
+            const params = {
+                project_id: filters.project_id,
+                page: filters.page ?? 1,
+                page_size: filters.page_size ?? 100,
+            };
+            if (filters.status)
+                params.status = filters.status;
+            if (filters.search)
+                params.search = filters.search;
+            const qs = buildQueryString(params);
+            const res = await http.get(`${WORKFLOWS_BASE}${qs}`);
+            return res.data;
+        },
+        async getWorkflowGraph(workflow_id, project_id) {
+            const qs = buildQueryString({ project_id });
+            const res = await http.get(`${WORKFLOWS_BASE}/${encodeURIComponent(workflow_id)}/graph${qs}`);
+            return res.data;
+        },
+        async createWorkflow(input) {
+            const res = await http.post(WORKFLOWS_BASE, input);
+            return res.data;
+        },
+        async deploy(input) {
+            const { project_id, instance_id, version_id, force_redeploy } = input;
+            const res = await http.post(`${PROJECTS_BASE}/${encodeURIComponent(project_id)}/deploy`, { instance_id, version_id, force_redeploy: force_redeploy ?? false });
+            return res.data;
+        },
+    };
+    return api;
+}
+//# sourceMappingURL=workflows.js.map

package/dist/client/workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../src/client/workflows.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAC9C,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAE5C,SAAS,gBAAgB,CAAC,MAA6D;IACrF,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;YAAE,SAAS;QAC5C,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5B,CAAC;AAYD,MAAM,UAAU,kBAAkB,CAAC,IAAsB;IACvD,MAAM,GAAG,GAAiB;QACxB,KAAK,CAAC,aAAa,CAAC,OAA6B;YAC/C,MAAM,MAAM,GAAgD;gBAC1D,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;gBACvB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG;aACpC,CAAC;YACF,IAAI,OAAO,CAAC,MAAM;gBAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YACnD,IAAI,OAAO,CAAC,MAAM;gBAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YACnD,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAwB,GAAG,cAAc,GAAG,EAAE,EAAE,CAAC,CAAC;YAC5E,OAAO,GAAG,CAAC,IAAI,CAAC;QAClB,CAAC;QAED,KAAK,CAAC,gBAAgB,CACpB,WAAmB,EACnB,UAAkB;YAElB,MAAM,EAAE,GAAG,gBAAgB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAC5C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CACxB,GAAG,cAAc,IAAI,kBAAkB,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,CAClE,CAAC;YACF,OAAO,GAAG,CAAC,IAAI,CAAC;QAClB,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,KAA0B;YAC7C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAgC,cAAc,EAAE,KAAK,CAAC,CAAC;YAClF,OAAO,GAAG,CAAC,IAAI,CAAC;QAClB,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAkB;YAC7B,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;YACtE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CACzB,GAAG,aAAa,IAAI,kBAAkB,CAAC,UAAU,CAAC,SAAS,EAC3D,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,IAAI,KAAK,EAAE,CACrE,CAAC;YACF,OAAO,GAAG,CAAC,IAAI,CAAC;QAClB,CAAC;KACF,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/config/api-path.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Loxtep public HTTP APIs: the first path segment is the microservice (e.g. `app`, `dataproducts`)
+ * on the shared API host. The SDK and CLI must not assume `/auth/login` is at the origin root.
+ */
+/**
+ * Build URL for `POST` auth endpoints (`/auth/login`, `/auth/refresh`).
+ * When `pathPrefix` is `undefined` (key absent from config), the default segment is `app` (app microservice).
+ * When `pathPrefix` is `''`, no extra segment is added.
+ */
+export declare function buildAuthServiceUrl(baseUrl: string, pathPrefix: string | undefined, resourcePath: string): string;
+/**
+ * For {@link LoxtepClient}: extends `api_url` with one path segment when set (e.g. `dataproducts`),
+ * and avoids duplicating a trailing segment that already matches.
+ * When `pathPrefix` is `undefined` or `''`, returns `api_url` (trimmed).
+ */
+export declare function extendClientBaseUrl(apiUrl: string, pathPrefix: string | undefined | null): string;
+//# sourceMappingURL=api-path.d.ts.map

package/dist/config/api-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-path.d.ts","sourceRoot":"","sources":["../../src/config/api-path.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,YAAY,EAAE,MAAM,GACnB,MAAM,CAeR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAcjG"}

package/dist/config/api-path.js

@@ -0,0 +1,57 @@
+/**
+ * Loxtep public HTTP APIs: the first path segment is the microservice (e.g. `app`, `dataproducts`)
+ * on the shared API host. The SDK and CLI must not assume `/auth/login` is at the origin root.
+ */
+/** Last non-empty path segment of an absolute http(s) URL. */
+function lastUrlPathSegment(absoluteBaseUrl) {
+    try {
+        const p = new URL(absoluteBaseUrl).pathname.replace(/\/$/, '');
+        const segs = p.split('/').filter(Boolean);
+        return segs.length ? segs[segs.length - 1] : null;
+    }
+    catch {
+        return null;
+    }
+}
+const DEFAULT_AUTH_PATH_PREFIX = 'app';
+/**
+ * Build URL for `POST` auth endpoints (`/auth/login`, `/auth/refresh`).
+ * When `pathPrefix` is `undefined` (key absent from config), the default segment is `app` (app microservice).
+ * When `pathPrefix` is `''`, no extra segment is added.
+ */
+export function buildAuthServiceUrl(baseUrl, pathPrefix, resourcePath) {
+    const base = baseUrl.replace(/\/$/, '');
+    const seg = pathPrefix === undefined
+        ? DEFAULT_AUTH_PATH_PREFIX
+        : String(pathPrefix).replace(/^\/+|\/+$/g, '');
+    const rp = resourcePath.startsWith('/') ? resourcePath : `/${resourcePath}`;
+    if (seg.length === 0) {
+        return `${base}${rp}`;
+    }
+    const last = lastUrlPathSegment(base);
+    if (last === seg) {
+        return `${base}${rp}`;
+    }
+    return `${base}/${seg}${rp}`;
+}
+/**
+ * For {@link LoxtepClient}: extends `api_url` with one path segment when set (e.g. `dataproducts`),
+ * and avoids duplicating a trailing segment that already matches.
+ * When `pathPrefix` is `undefined` or `''`, returns `api_url` (trimmed).
+ */
+export function extendClientBaseUrl(apiUrl, pathPrefix) {
+    if (pathPrefix === undefined || pathPrefix === null) {
+        return apiUrl.replace(/\/$/, '');
+    }
+    const seg = String(pathPrefix).replace(/^\/+|\/+$/g, '');
+    if (seg.length === 0) {
+        return apiUrl.replace(/\/$/, '');
+    }
+    const base = apiUrl.replace(/\/$/, '');
+    const last = lastUrlPathSegment(base);
+    if (last === seg) {
+        return base;
+    }
+    return `${base}/${seg}`;
+}
+//# sourceMappingURL=api-path.js.map

package/dist/config/api-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-path.js","sourceRoot":"","sources":["../../src/config/api-path.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8DAA8D;AAC9D,SAAS,kBAAkB,CAAC,eAAuB;IACjD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,UAA8B,EAC9B,YAAoB;IAEpB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxC,MAAM,GAAG,GACP,UAAU,KAAK,SAAS;QACtB,CAAC,CAAC,wBAAwB;QAC1B,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,YAAY,EAAE,CAAC;IAC5E,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,GAAG,IAAI,GAAG,EAAE,EAAE,CAAC;IACxB,CAAC;IACD,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,OAAO,GAAG,IAAI,GAAG,EAAE,EAAE,CAAC;IACxB,CAAC;IACD,OAAO,GAAG,IAAI,IAAI,GAAG,GAAG,EAAE,EAAE,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,UAAqC;IACvF,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACpD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACzD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC;AAC1B,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,10 @@
+export { loadConfig, loadConfigSync } from './load.js';
+export { saveConfig } from './save.js';
+export { parseStreamsPartial } from './streams-partial.js';
+export { getConfigDir, getDefaultConfigPath } from './paths.js';
+export type { LoxtepConfig } from './types.js';
+export { DEFAULT_CONFIG } from './types.js';
+export { buildAuthServiceUrl, extendClientBaseUrl } from './api-path.js';
+export { buildPlatformRequestUrl, getGatewayMicroserviceId, SDK_HTTP_PATHS_BY_FEATURE, } from './platform-request-url.js';
+export { resolveSdkApiPaths, resolveConfigSdkPath, SDK_EXAMPLE_PATHS, type ResolvedSdkApiPaths, } from './resolve-sdk-urls.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,9 @@
+export { loadConfig, loadConfigSync } from './load.js';
+export { saveConfig } from './save.js';
+export { parseStreamsPartial } from './streams-partial.js';
+export { getConfigDir, getDefaultConfigPath } from './paths.js';
+export { DEFAULT_CONFIG } from './types.js';
+export { buildAuthServiceUrl, extendClientBaseUrl } from './api-path.js';
+export { buildPlatformRequestUrl, getGatewayMicroserviceId, SDK_HTTP_PATHS_BY_FEATURE, } from './platform-request-url.js';
+export { resolveSdkApiPaths, resolveConfigSdkPath, SDK_EXAMPLE_PATHS, } from './resolve-sdk-urls.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,GAElB,MAAM,uBAAuB,CAAC"}

package/dist/config/load.d.ts

@@ -0,0 +1,12 @@
+import type { LoxtepConfig } from './types.js';
+/**
+ * Load config from env and optional file. Precedence: env > file > defaults.
+ * No secrets (token) are read; token is in memory only.
+ */
+export declare function loadConfig(filePath?: string): Promise<LoxtepConfig>;
+/**
+ * Load config synchronously from env and optional file. Precedence: env > file > defaults.
+ * Uses readFileSync for file; prefer loadConfig() in async code.
+ */
+export declare function loadConfigSync(filePath?: string): LoxtepConfig;
+//# sourceMappingURL=load.d.ts.map

package/dist/config/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAgD/C;;;GAGG;AACH,wBAAsB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA0DzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,CA0D9D"}

package/dist/config/load.js

@@ -0,0 +1,152 @@
+import { readFile } from 'node:fs/promises';
+import { existsSync, readFileSync } from 'node:fs';
+import { DEFAULT_CONFIG } from './types.js';
+import { getDefaultConfigPath } from './paths.js';
+import { parseStreamsPartial } from './streams-partial.js';
+const ENV_API_URL = 'LOXTEP_API_URL';
+const ENV_AUTH_PATH_PREFIX = 'LOXTEP_AUTH_PATH_PREFIX';
+const ENV_API_PATH_PREFIX = 'LOXTEP_API_PATH_PREFIX';
+const ENV_ORGANIZATION_ID = 'LOXTEP_ORGANIZATION_ID';
+const ENV_PROJECT_ID = 'LOXTEP_PROJECT_ID';
+const ENV_INSTANCE_ID = 'LOXTEP_INSTANCE_ID';
+const ENV_REGION = 'LOXTEP_REGION';
+/** Path to a JSON file with the same shape as the main config `streams` key (PascalCase). Merged on top of `streams` from the primary config file. */
+const ENV_RSTREAMS_CONFIG_FILE = 'LOXTEP_RSTREAMS_CONFIG_FILE';
+function mergeStreamsPartials(a, b) {
+    if (!a && !b)
+        return undefined;
+    return { ...a, ...b };
+}
+function readStreamsFromRstreamsFileSync() {
+    const p = process.env[ENV_RSTREAMS_CONFIG_FILE]?.trim();
+    if (!p || !existsSync(p))
+        return undefined;
+    try {
+        const raw = readFileSync(p, 'utf-8');
+        return parseStreamsPartial(JSON.parse(raw));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function readStreamsFromRstreamsFileAsync() {
+    const p = process.env[ENV_RSTREAMS_CONFIG_FILE]?.trim();
+    if (!p || !existsSync(p))
+        return undefined;
+    try {
+        const raw = await readFile(p, 'utf-8');
+        return parseStreamsPartial(JSON.parse(raw));
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Load config from env and optional file. Precedence: env > file > defaults.
+ * No secrets (token) are read; token is in memory only.
+ */
+export async function loadConfig(filePath) {
+    const path = filePath ?? getDefaultConfigPath();
+    let fileConfig = {};
+    if (existsSync(path)) {
+        try {
+            const raw = await readFile(path, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (typeof parsed === 'object' && parsed !== null) {
+                fileConfig = {
+                    api_url: typeof parsed.api_url === 'string' ? parsed.api_url : undefined,
+                    auth_path_prefix: typeof parsed.auth_path_prefix === 'string' ? parsed.auth_path_prefix : undefined,
+                    api_path_prefix: typeof parsed.api_path_prefix === 'string' ? parsed.api_path_prefix : undefined,
+                    organization_id: typeof parsed.organization_id === 'string' ? parsed.organization_id : undefined,
+                    project_id: typeof parsed.project_id === 'string' ? parsed.project_id : undefined,
+                    instance_id: typeof parsed.instance_id === 'string' ? parsed.instance_id : undefined,
+                    region: typeof parsed.region === 'string' ? parsed.region : undefined,
+                    streams: parseStreamsPartial(parsed.streams),
+                };
+            }
+        }
+        catch {
+            // Ignore invalid or unreadable file; fall back to env/defaults
+        }
+    }
+    const rstreamsFilePartial = await readStreamsFromRstreamsFileAsync();
+    const streamsMerged = mergeStreamsPartials(fileConfig.streams, rstreamsFilePartial);
+    const envConfig = {
+        api_url: process.env[ENV_API_URL]?.trim() || undefined,
+        auth_path_prefix: process.env[ENV_AUTH_PATH_PREFIX] !== undefined
+            ? process.env[ENV_AUTH_PATH_PREFIX].replace(/^\/+|\/+$/g, '')
+            : undefined,
+        api_path_prefix: process.env[ENV_API_PATH_PREFIX] !== undefined
+            ? process.env[ENV_API_PATH_PREFIX].replace(/^\/+|\/+$/g, '')
+            : undefined,
+        organization_id: process.env[ENV_ORGANIZATION_ID]?.trim() || undefined,
+        project_id: process.env[ENV_PROJECT_ID]?.trim() || undefined,
+        instance_id: process.env[ENV_INSTANCE_ID]?.trim() || undefined,
+        region: process.env[ENV_REGION]?.trim() || undefined,
+    };
+    return {
+        api_url: envConfig.api_url ?? fileConfig.api_url ?? DEFAULT_CONFIG.api_url,
+        auth_path_prefix: envConfig.auth_path_prefix ?? fileConfig.auth_path_prefix,
+        api_path_prefix: envConfig.api_path_prefix ?? fileConfig.api_path_prefix,
+        organization_id: envConfig.organization_id ?? fileConfig.organization_id ?? DEFAULT_CONFIG.organization_id,
+        project_id: envConfig.project_id ?? fileConfig.project_id ?? DEFAULT_CONFIG.project_id,
+        instance_id: envConfig.instance_id ?? fileConfig.instance_id ?? DEFAULT_CONFIG.instance_id,
+        region: envConfig.region ?? fileConfig.region ?? DEFAULT_CONFIG.region,
+        streams: streamsMerged,
+    };
+}
+/**
+ * Load config synchronously from env and optional file. Precedence: env > file > defaults.
+ * Uses readFileSync for file; prefer loadConfig() in async code.
+ */
+export function loadConfigSync(filePath) {
+    const path = filePath ?? getDefaultConfigPath();
+    let fileConfig = {};
+    if (existsSync(path)) {
+        try {
+            const raw = readFileSync(path, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (typeof parsed === 'object' && parsed !== null) {
+                fileConfig = {
+                    api_url: typeof parsed.api_url === 'string' ? parsed.api_url : undefined,
+                    auth_path_prefix: typeof parsed.auth_path_prefix === 'string' ? parsed.auth_path_prefix : undefined,
+                    api_path_prefix: typeof parsed.api_path_prefix === 'string' ? parsed.api_path_prefix : undefined,
+                    organization_id: typeof parsed.organization_id === 'string' ? parsed.organization_id : undefined,
+                    project_id: typeof parsed.project_id === 'string' ? parsed.project_id : undefined,
+                    instance_id: typeof parsed.instance_id === 'string' ? parsed.instance_id : undefined,
+                    region: typeof parsed.region === 'string' ? parsed.region : undefined,
+                    streams: parseStreamsPartial(parsed.streams),
+                };
+            }
+        }
+        catch {
+            // Ignore invalid or unreadable file
+        }
+    }
+    const rstreamsFilePartial = readStreamsFromRstreamsFileSync();
+    const streamsMerged = mergeStreamsPartials(fileConfig.streams, rstreamsFilePartial);
+    const envConfig = {
+        api_url: process.env[ENV_API_URL]?.trim() || undefined,
+        auth_path_prefix: process.env[ENV_AUTH_PATH_PREFIX] !== undefined
+            ? process.env[ENV_AUTH_PATH_PREFIX].replace(/^\/+|\/+$/g, '')
+            : undefined,
+        api_path_prefix: process.env[ENV_API_PATH_PREFIX] !== undefined
+            ? process.env[ENV_API_PATH_PREFIX].replace(/^\/+|\/+$/g, '')
+            : undefined,
+        organization_id: process.env[ENV_ORGANIZATION_ID]?.trim() || undefined,
+        project_id: process.env[ENV_PROJECT_ID]?.trim() || undefined,
+        instance_id: process.env[ENV_INSTANCE_ID]?.trim() || undefined,
+        region: process.env[ENV_REGION]?.trim() || undefined,
+    };
+    return {
+        api_url: envConfig.api_url ?? fileConfig.api_url ?? DEFAULT_CONFIG.api_url,
+        auth_path_prefix: envConfig.auth_path_prefix ?? fileConfig.auth_path_prefix,
+        api_path_prefix: envConfig.api_path_prefix ?? fileConfig.api_path_prefix,
+        organization_id: envConfig.organization_id ?? fileConfig.organization_id ?? DEFAULT_CONFIG.organization_id,
+        project_id: envConfig.project_id ?? fileConfig.project_id ?? DEFAULT_CONFIG.project_id,
+        instance_id: envConfig.instance_id ?? fileConfig.instance_id ?? DEFAULT_CONFIG.instance_id,
+        region: envConfig.region ?? fileConfig.region ?? DEFAULT_CONFIG.region,
+        streams: streamsMerged,
+    };
+}
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,GAAG,gBAAgB,CAAC;AACrC,MAAM,oBAAoB,GAAG,yBAAyB,CAAC;AACvD,MAAM,mBAAmB,GAAG,wBAAwB,CAAC;AACrD,MAAM,mBAAmB,GAAG,wBAAwB,CAAC;AACrD,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAC3C,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAC7C,MAAM,UAAU,GAAG,eAAe,CAAC;AACnC,sJAAsJ;AACtJ,MAAM,wBAAwB,GAAG,6BAA6B,CAAC;AAE/D,SAAS,oBAAoB,CAC3B,CAAmC,EACnC,CAAmC;IAEnC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,+BAA+B;IACtC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,IAAI,EAAE,CAAC;IACxD,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACrC,OAAO,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gCAAgC;IAG7C,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE,IAAI,EAAE,CAAC;IACxD,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACvC,OAAO,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAiB;IAChD,MAAM,IAAI,GAAG,QAAQ,IAAI,oBAAoB,EAAE,CAAC;IAChD,IAAI,UAAU,GAA0B,EAAE,CAAC;IAE3C,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;YAC1D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBAClD,UAAU,GAAG;oBACX,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;oBACxE,gBAAgB,EACd,OAAO,MAAM,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;oBACnF,eAAe,EACb,OAAO,MAAM,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;oBACjF,eAAe,EACb,OAAO,MAAM,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;oBACjF,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;oBACjF,WAAW,EAAE,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;oBACpF,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;oBACrE,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC;iBAC7C,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;QACjE,CAAC;IACH,CAAC;IAED,MAAM,mBAAmB,GAAG,MAAM,gCAAgC,EAAE,CAAC;IACrE,MAAM,aAAa,GAAG,oBAAoB,CAAC,UAAU,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;IAEpF,MAAM,SAAS,GAA0B;QACvC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS;QACtD,gBAAgB,EACd,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,KAAK,SAAS;YAC7C,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;YAC9D,CAAC,CAAC,SAAS;QACf,eAAe,EACb,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,SAAS;YAC5C,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;YAC7D,CAAC,CAAC,SAAS;QACf,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS;QACtE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS;QAC5D,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS;QAC9D,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS;KACrD,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO;QAC1E,gBAAgB,EAAE,SAAS,CAAC,gBAAgB,IAAI,UAAU,CAAC,gBAAgB;QAC3E,eAAe,EAAE,SAAS,CAAC,eAAe,IAAI,UAAU,CAAC,eAAe;QACxE,eAAe,EACb,SAAS,CAAC,eAAe,IAAI,UAAU,CAAC,eAAe,IAAI,cAAc,CAAC,eAAe;QAC3F,UAAU,EAAE,SAAS,CAAC,UAAU,IAAI,UAAU,CAAC,UAAU,IAAI,cAAc,CAAC,UAAU;QACtF,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,UAAU,CAAC,WAAW,IAAI,cAAc,CAAC,WAAW;QAC1F,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM;QACtE,OAAO,EAAE,aAAa;KACvB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAiB;IAC9C,MAAM,IAAI,GAAG,QAAQ,IAAI,oBAAoB,EAAE,CAAC;IAChD,IAAI,UAAU,GAA0B,EAAE,CAAC;IAE3C,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;YAC1D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBAClD,UAAU,GAAG;oBACX,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;oBACxE,gBAAgB,EACd,OAAO,MAAM,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;oBACnF,eAAe,EACb,OAAO,MAAM,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;oBACjF,eAAe,EACb,OAAO,MAAM,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;oBACjF,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;oBACjF,WAAW,EAAE,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;oBACpF,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;oBACrE,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC;iBAC7C,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;IACH,CAAC;IAED,MAAM,mBAAmB,GAAG,+BAA+B,EAAE,CAAC;IAC9D,MAAM,aAAa,GAAG,oBAAoB,CAAC,UAAU,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;IAEpF,MAAM,SAAS,GAA0B;QACvC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS;QACtD,gBAAgB,EACd,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,KAAK,SAAS;YAC7C,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;YAC9D,CAAC,CAAC,SAAS;QACf,eAAe,EACb,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,SAAS;YAC5C,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;YAC7D,CAAC,CAAC,SAAS;QACf,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS;QACtE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS;QAC5D,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS;QAC9D,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS;KACrD,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO;QAC1E,gBAAgB,EAAE,SAAS,CAAC,gBAAgB,IAAI,UAAU,CAAC,gBAAgB;QAC3E,eAAe,EAAE,SAAS,CAAC,eAAe,IAAI,UAAU,CAAC,eAAe;QACxE,eAAe,EACb,SAAS,CAAC,eAAe,IAAI,UAAU,CAAC,eAAe,IAAI,cAAc,CAAC,eAAe;QAC3F,UAAU,EAAE,SAAS,CAAC,UAAU,IAAI,UAAU,CAAC,UAAU,IAAI,cAAc,CAAC,UAAU;QACtF,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,UAAU,CAAC,WAAW,IAAI,cAAc,CAAC,WAAW;QAC1F,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM;QACtE,OAAO,EAAE,aAAa;KACvB,CAAC;AACJ,CAAC"}

package/dist/config/paths.d.ts

@@ -0,0 +1,5 @@
+/** Default config directory: ~/.loxtep (Unix) or %USERPROFILE%\.loxtep (Windows). */
+export declare function getConfigDir(): string;
+/** Default config file path: ~/.loxtep/config.json. */
+export declare function getDefaultConfigPath(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/config/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAGA,qFAAqF;AACrF,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,uDAAuD;AACvD,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/dist/config/paths.js

@@ -0,0 +1,11 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/** Default config directory: ~/.loxtep (Unix) or %USERPROFILE%\.loxtep (Windows). */
+export function getConfigDir() {
+    return join(homedir(), '.loxtep');
+}
+/** Default config file path: ~/.loxtep/config.json. */
+export function getDefaultConfigPath() {
+    return join(getConfigDir(), 'config.json');
+}
+//# sourceMappingURL=paths.js.map

package/dist/config/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,qFAAqF;AACrF,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACpC,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC"}

package/dist/config/platform-request-url.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Loxtep’s shared API host routes each **microservice** as the first path segment (e.g. `…/dataproducts/...`,
+ * `…/workflows/…`, `…/app/…` for `observe`). The SDK’s relative paths (e.g. `/dataproducts`, `/workflows/projects`)
+ * are the **API Gateway resource tree** for that service, so the public URL is usually:
+ *   `{host}/{microservice}{samePath}`
+ * and when `path` already begins with a microservice (e.g. `/ai/…`, `/graph/…`) we do **not** add another
+ * segment (see `PATH_ALREADY_HAS_SERVICE_PREFIX`).
+ *
+ * For backend route definitions, see each microservice’s `config.loxtep.api.uri` in
+ * `platform-backend` per-service `api` trees (`.../api/.../package.json`).
+ */
+/**
+ * Returns the public URL path (first segment) for the service that handles this request path, before overrides.
+ * Typically the first segment of `path` is the **resource** name in CDK, which is often the same as the
+ * microservice id (`dataproducts`, `workflows`, `organizations`, …).
+ */
+export declare function getGatewayMicroserviceId(path: string): string;
+/**
+ * Build a full request URL for a shared control-plane host.
+ * - `/ai/…`, `/graph/…`: `path` is already a full public path from the host root.
+ * - `/dataproducts/…`: SDK paths are in-service; public routes are `…/dataproducts/dataproducts/…`.
+ * - Most other services: in-service path starts with a microservice segment (e.g. `/workflows/projects`);
+ *   public is `…/workflows/projects` (do **not** prepend the microservice again).
+ * - One-segment paths (e.g. `/workflows`, `/search`, `/governance`) still need a prefix: `…/workflows/workflow`, `…/graph/search`, `…/governance/governance`.
+ */
+export declare function buildPlatformRequestUrl(apiHost: string, path: string): string;
+/**
+ * All path prefixes the Node SDK’s `LoxtepClient` can emit (for docs / `loxtep config paths` extensions).
+ * Values are the **path** part after `base_url` in the SDK source (before `buildPlatformRequestUrl`).
+ */
+export declare const SDK_HTTP_PATHS_BY_FEATURE: {
+    feature: string;
+    pathPrefixes: string[];
+}[];
+//# sourceMappingURL=platform-request-url.d.ts.map

package/dist/config/platform-request-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-request-url.d.ts","sourceRoot":"","sources":["../../src/config/platform-request-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO7D;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAiC7E;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,EAmBA,CAAC"}

package/dist/config/platform-request-url.js

@@ -0,0 +1,100 @@
+/**
+ * Loxtep’s shared API host routes each **microservice** as the first path segment (e.g. `…/dataproducts/...`,
+ * `…/workflows/…`, `…/app/…` for `observe`). The SDK’s relative paths (e.g. `/dataproducts`, `/workflows/projects`)
+ * are the **API Gateway resource tree** for that service, so the public URL is usually:
+ *   `{host}/{microservice}{samePath}`
+ * and when `path` already begins with a microservice (e.g. `/ai/…`, `/graph/…`) we do **not** add another
+ * segment (see `PATH_ALREADY_HAS_SERVICE_PREFIX`).
+ *
+ * For backend route definitions, see each microservice’s `config.loxtep.api.uri` in
+ * `platform-backend` per-service `api` trees (`.../api/.../package.json`).
+ */
+/** Paths that are already correct from the host root (include the gateway’s first segment in `path`). */
+const PATH_ALREADY_HAS_SERVICE_PREFIX = /^\/(ai|graph)(\/|$)/;
+const MICROSERVICE_OVERRIDES = {
+    /** Observe, botmon-style routes live in the `app` microservice. */
+    observe: 'app',
+    /** Global rate limit discovery (if deployed on app stack). */
+    'rate-limits': 'app',
+};
+function getSearchMicroserviceFromEnv() {
+    return process.env.LOXTEP_PLATFORM_SEARCH_MS?.trim() || 'graph';
+}
+/**
+ * Returns the public URL path (first segment) for the service that handles this request path, before overrides.
+ * Typically the first segment of `path` is the **resource** name in CDK, which is often the same as the
+ * microservice id (`dataproducts`, `workflows`, `organizations`, …).
+ */
+export function getGatewayMicroserviceId(path) {
+    const clean = path.split('?')[0] ?? path;
+    const first = clean.replace(/^\//, '').split('/').filter(Boolean)[0] ?? '';
+    if (first === 'search') {
+        return getSearchMicroserviceFromEnv();
+    }
+    return MICROSERVICE_OVERRIDES[first] ?? first;
+}
+/**
+ * Build a full request URL for a shared control-plane host.
+ * - `/ai/…`, `/graph/…`: `path` is already a full public path from the host root.
+ * - `/dataproducts/…`: SDK paths are in-service; public routes are `…/dataproducts/dataproducts/…`.
+ * - Most other services: in-service path starts with a microservice segment (e.g. `/workflows/projects`);
+ *   public is `…/workflows/projects` (do **not** prepend the microservice again).
+ * - One-segment paths (e.g. `/workflows`, `/search`, `/governance`) still need a prefix: `…/workflows/workflow`, `…/graph/search`, `…/governance/governance`.
+ */
+export function buildPlatformRequestUrl(apiHost, path) {
+    const host = apiHost.replace(/\/$/, '');
+    const clean = path.split('?')[0] ?? path;
+    const p = clean.startsWith('/') ? clean : `/${clean}`;
+    if (PATH_ALREADY_HAS_SERVICE_PREFIX.test(p)) {
+        return `${host}${p}`;
+    }
+    if (!p || p === '/') {
+        return host;
+    }
+    const segments = p.replace(/^\//, '').split('/').filter(Boolean);
+    if (segments.length === 0) {
+        return host;
+    }
+    const first = segments[0] ?? '';
+    const microservice = getGatewayMicroserviceId(p);
+    if (first === 'dataproducts') {
+        return `${host}/dataproducts/dataproducts${p.slice('/dataproducts'.length)}`;
+    }
+    if (segments.length === 1) {
+        if (!microservice)
+            return `${host}${p}`;
+        return `${host}/${microservice}${p}`;
+    }
+    if (first === microservice) {
+        return `${host}${p}`;
+    }
+    if (microservice) {
+        return `${host}/${microservice}${p}`;
+    }
+    return `${host}${p}`;
+}
+/**
+ * All path prefixes the Node SDK’s `LoxtepClient` can emit (for docs / `loxtep config paths` extensions).
+ * Values are the **path** part after `base_url` in the SDK source (before `buildPlatformRequestUrl`).
+ */
+export const SDK_HTTP_PATHS_BY_FEATURE = [
+    {
+        feature: 'auth (login/refresh) — not via LoxtepClient',
+        pathPrefixes: ['/auth/login', '/auth/refresh'],
+    },
+    {
+        feature: 'data_products, schemas (partial), quality, consumptions, templates',
+        pathPrefixes: ['/dataproducts', '/search'],
+    },
+    { feature: 'catalog', pathPrefixes: ['/search'] },
+    { feature: 'flows, workflows, projects, connections', pathPrefixes: ['/workflows'] },
+    { feature: 'domains, instances (organizations API)', pathPrefixes: ['/organizations'] },
+    { feature: 'standards (governance)', pathPrefixes: ['/governance'] },
+    { feature: 'connectors', pathPrefixes: ['/connectors'] },
+    { feature: 'observe, queues, data_products trace (HTTP fallback)', pathPrefixes: ['/observe'] },
+    { feature: 'discovery (MCP tools)', pathPrefixes: ['/ai/mcp/'] },
+    { feature: 'thesaurus', pathPrefixes: ['/graph/organizations/'] },
+    { feature: 'process_intelligence, procedures', pathPrefixes: ['/process-intelligence'] },
+    { feature: 'rate limits', pathPrefixes: ['/rate-limits'] },
+];
+//# sourceMappingURL=platform-request-url.js.map

package/dist/config/platform-request-url.js.map

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

package/dist/config/resolve-sdk-urls.d.ts

@@ -0,0 +1,39 @@
+import type { LoxtepConfig } from './types.js';
+/**
+ * One example path per LoxtepClient surface (see `src/client/*.ts`). Used only for `resolveSdkApiPaths` / CLI output.
+ */
+export declare const SDK_EXAMPLE_PATHS: ReadonlyArray<{
+    label: string;
+    path: string;
+}>;
+/** Resolve an SDK-relative path the same way `LoxtepClient` does (platform vs legacy). Exported for tools/tests. */
+export declare function resolveConfigSdkPath(c: Pick<LoxtepConfig, 'api_url' | 'api_path_prefix'>, sdkPath: string): string;
+/**
+ * Fully resolved example URLs the SDK/CLI will call for common operations.
+ * Use this to verify `api_url`, `auth_path_prefix`, and `api_path_prefix` match your API Gateway / custom-domain mapping.
+ */
+export type ResolvedSdkApiPaths = {
+    raw_api_url: string;
+    /** `platform` = shared host, per-path microservice prefix (default). `legacy` = single `api_path_prefix` baked into the client base URL. */
+    loxtep_url_mode: 'platform' | 'legacy';
+    post_auth_login: string;
+    post_auth_refresh: string;
+    loxtep_client_base_url: string;
+    post_dataproducts_create: string;
+    get_dataproducts_list: string;
+    /** Representative SDK path → full URL (see {@link SDK_EXAMPLE_PATHS}; placeholders, not real IDs). */
+    example_endpoints: {
+        label: string;
+        sdk_path: string;
+        resolved_url: string;
+    }[];
+    notes: string[];
+};
+/**
+ * Derive concrete URLs from config (after env/file merge in {@link loadConfig}).
+ * - Auth: `buildAuthServiceUrl` → default first segment `app` for `/auth/*` when `auth_path_prefix` is unset.
+ * - LoxtepClient (default): `api_url` = API **origin**; data-plane paths are resolved with `buildPlatformRequestUrl` (see `config/platform-request-url.ts`).
+ * - Legacy: `api_path_prefix` set → one static `base_url` = `api_url` + that segment (old behavior).
+ */
+export declare function resolveSdkApiPaths(c: Pick<LoxtepConfig, 'api_url' | 'auth_path_prefix' | 'api_path_prefix'>): ResolvedSdkApiPaths;
+//# sourceMappingURL=resolve-sdk-urls.d.ts.map

package/dist/config/resolve-sdk-urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-sdk-urls.d.ts","sourceRoot":"","sources":["../../src/config/resolve-sdk-urls.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAmC5E,CAAC;AAYF,oHAAoH;AACpH,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,iBAAiB,CAAC,EACpD,OAAO,EAAE,MAAM,GACd,MAAM,CASR;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,4IAA4I;IAC5I,eAAe,EAAE,UAAU,GAAG,QAAQ,CAAC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sGAAsG;IACtG,iBAAiB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/E,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,kBAAkB,GAAG,iBAAiB,CAAC,GACxE,mBAAmB,CAgErB"}