@loxtep/sdk 0.3.0 → 0.5.0

package/dist/client/data-assets.js

@@ -1,182 +0,0 @@
-/**
- * Data assets API (backend: data products). get, list, search, get_queue_info, get_reader_checkpoint.
- * Customer-facing surface: data_assets.
- */
-function buildQueryString(params) {
-    const search = new URLSearchParams();
-    for (const [k, v] of Object.entries(params)) {
-        if (v === undefined || v === null)
-            continue;
-        if (Array.isArray(v)) {
-            search.set(k, v.join(','));
-        }
-        else {
-            search.set(k, String(v));
-        }
-    }
-    const qs = search.toString();
-    return qs ? `?${qs}` : '';
-}
-/**
- * Create the data_assets API surface (get, list, search, query, list_tables, get_queue_info, get_reader_checkpoint, stream, replay).
- */
-export function createDataAssetsApi(http, deps) {
-    return {
-        async get(id, options) {
-            const qs = options
-                ? buildQueryString({
-                    include_schema: options.include_schema,
-                    include_quality: options.include_quality,
-                    include_lineage: options.include_lineage,
-                    include_contracts: options.include_contracts,
-                })
-                : '';
-            const res = await http.get(`/dataproducts/${encodeURIComponent(id)}${qs}`);
-            return res.data;
-        },
-        /**
-         * Get the glossary/lexicon (definitions) for a data asset.
-         * Returns glossary_terms (term -> { definition, alt_labels?, broader?, narrower?, related? }) and field_glossary_map.
-         */
-        async get_lexicon(id) {
-            const asset = await this.get(id);
-            const glossary_terms = asset
-                .glossary_terms ??
-                asset.metadata?.business_glossary ??
-                {};
-            const field_glossary_map = asset.metadata?.field_glossary_map ?? undefined;
-            return { glossary_terms, field_glossary_map };
-        },
-        async list(filters) {
-            const params = {
-                page: filters?.page ?? 1,
-                page_size: filters?.page_size ?? 100,
-                sort_by: filters?.sort_by ?? 'created_at',
-                sort_order: filters?.sort_order ?? 'desc',
-            };
-            if (filters?.domain_id)
-                params.domain_id = filters.domain_id;
-            if (filters?.status)
-                params.status = filters.status;
-            if (filters?.classification)
-                params.classification = filters.classification;
-            if (filters?.owner_user_id)
-                params.owner_user_id = filters.owner_user_id;
-            if (filters?.search)
-                params.search = filters.search;
-            if (filters?.tags?.length)
-                params.tags = filters.tags.join(',');
-            const qs = buildQueryString(params);
-            const res = await http.get(`/dataproducts${qs}`);
-            return res.data;
-        },
-        async search(query, filters) {
-            const params = {
-                q: query,
-                type: filters?.type ?? 'data_product',
-                limit: filters?.limit ?? 20,
-                offset: filters?.offset ?? 0,
-            };
-            const qs = buildQueryString(params);
-            return http.get(`/search${qs}`);
-        },
-        async query(id, sql) {
-            const res = await http.post('/dataproducts/query', { data_product_id: id, sql });
-            const payload = res.data;
-            if (!payload) {
-                return { items: [], metadata: { data_product_id: id } };
-            }
-            return payload;
-        },
-        async list_tables(id) {
-            const res = await http.get(`/dataproducts/${encodeURIComponent(id)}/tables`);
-            const payload = res.data;
-            if (!payload) {
-                return { items: [] };
-            }
-            return payload;
-        },
-        async get_queue_info(id) {
-            if (!deps) {
-                throw new Error('data_assets.get_queue_info requires queues API; use LoxtepClient which wires it');
-            }
-            const asset = await this.get(id);
-            const queue_name = asset.storage?.rstreams_queue;
-            if (!queue_name) {
-                return {
-                    queue_name: '',
-                    checkpoints: [],
-                    readers: [],
-                    writers: [],
-                    stats: {},
-                };
-            }
-            return deps.get_queue_metadata(queue_name);
-        },
-        async get_reader_checkpoint(id, bot_id) {
-            if (!deps) {
-                throw new Error('data_assets.get_reader_checkpoint requires queues API; use LoxtepClient which wires it');
-            }
-            const asset = await this.get(id);
-            const queue_name = asset.storage?.rstreams_queue;
-            if (!queue_name) {
-                throw new Error(`Data asset ${id} has no rstreams_queue (storage not configured)`);
-            }
-            return deps.get_reader_checkpoint(queue_name, bot_id);
-        },
-        async *stream(id, options) {
-            const asset = await this.get(id);
-            const queue_name = asset.storage?.rstreams_queue;
-            if (!queue_name) {
-                throw new Error(`Data asset ${id} has no rstreams_queue (storage not configured)`);
-            }
-            const batch_size = options?.batch_size ?? 100;
-            let start = options?.from ?? options?.checkpoint ?? undefined;
-            const path = `/observe/trace/${encodeURIComponent(queue_name)}/events`;
-            while (true) {
-                const qs = buildQueryString({ start, limit: batch_size });
-                const res = await http.get(`${path}${qs}`);
-                const payload = res.data ?? res;
-                const events = payload.events ??
-                    res.events ??
-                    [];
-                for (const event of events) {
-                    yield event;
-                }
-                if (events.length < batch_size)
-                    break;
-                const last = events[events.length - 1];
-                start = last.event_id ?? last.id;
-                if (!start)
-                    break;
-            }
-        },
-        async *replay(id, options) {
-            const asset = await this.get(id);
-            const queue_name = asset.storage?.rstreams_queue;
-            if (!queue_name) {
-                throw new Error(`Data asset ${id} has no rstreams_queue (storage not configured)`);
-            }
-            const limit = options?.limit ?? 1000;
-            const start = options?.from_beginning
-                ? '0'
-                : (options?.from_eid ?? options?.from_timestamp ?? options?.checkpoint_id ?? undefined);
-            const end = options?.to_eid ?? options?.to_timestamp ?? undefined;
-            const path = `/observe/trace/${encodeURIComponent(queue_name)}/events`;
-            const qs = buildQueryString({
-                start: start ?? undefined,
-                end: end ?? undefined,
-                limit,
-            });
-            const res = await http.get(`${path}${qs}`);
-            const payload = res.data ?? res;
-            const events = payload.events ??
-                res.events ??
-                [];
-            for (const event of events) {
-                yield event;
-            }
-        },
-    };
-}
-//# sourceMappingURL=data-assets.js.map

package/dist/client/data-assets.js.map

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

package/dist/client/flows.d.ts

@@ -1,33 +0,0 @@
-/**
- * Flows API (backend: workflows). list, get (with nodes), create, get_writer.
- * Flow writes for live events use the Loxtep stream data plane — not HTTP POST to /workflows/.../events.
- */
-import type { RStreamsSdk } from '../rstreams/leo-runtime.js';
-import type { LoxtepHttpClient } from '../http/client.js';
-import type { Flow, FlowWithNodes, FlowsListFilters, FlowsListResponse, FlowCreateInput, FlowWriter, GetWriterOptions } from './flow-types.js';
-export interface FlowsApiDeps {
-    /** Stream runtime; required for get_writer().close() */
-    rsdk?: RStreamsSdk;
-    /** Lazy stream runtime resolver (attempts observe.stream_config() when rsdk is not set). */
-    get_rsdk?: () => Promise<RStreamsSdk | undefined>;
-}
-/**
- * Determine whether an error is transient and should be retried.
- * Transient: network errors, timeouts, throttling (429), 5xx responses.
- * Non-transient: 4xx (except 429), auth failures — fail immediately.
- */
-export declare function isTransientError(err: unknown): boolean;
-/**
- * Sleep for the given number of milliseconds. Extracted for testability.
- */
-export declare function sleep(ms: number): Promise<void>;
-/**
- * Create the flows API surface (list, get with nodes, create, get_writer).
- */
-export declare function createFlowsApi(http: LoxtepHttpClient, deps?: FlowsApiDeps): {
-    list: (filters: FlowsListFilters) => Promise<FlowsListResponse['data']>;
-    get: (id: string) => Promise<FlowWithNodes>;
-    create: (input: FlowCreateInput) => Promise<Flow>;
-    get_writer: (flow_id: string, options?: GetWriterOptions) => Promise<FlowWriter>;
-};
-//# sourceMappingURL=flows.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../src/client/flows.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACV,IAAI,EACJ,aAAa,EAEb,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAUzB,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;CACnD;AAkCD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAwEtD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,gBAAgB,EACtB,IAAI,CAAC,EAAE,YAAY,GAClB;IACD,IAAI,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5C,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAClF,CAmIA"}

package/dist/client/flows.js

@@ -1,218 +0,0 @@
-/**
- * Flows API (backend: workflows). list, get (with nodes), create, get_writer.
- * Flow writes for live events use the Loxtep stream data plane — not HTTP POST to /workflows/.../events.
- */
-import { DefinitionValidationError } from '../errors/validation.js';
-import { StreamingError } from '../errors/streaming.js';
-import { createQueueWriter } from '../rstreams/event-bridge.js';
-import { resolveIngestionQueueName } from './flow-queue-resolve.js';
-const WORKFLOWS_API_BASE = '/workflows/workflows';
-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}` : '';
-}
-function validateEventAgainstDefinition(event, definition) {
-    const errors = [];
-    const required = definition.required;
-    if (Array.isArray(required) &&
-        required.length > 0 &&
-        event !== null &&
-        typeof event === 'object') {
-        const obj = event;
-        for (const key of required) {
-            if (!(key in obj) || obj[key] === undefined) {
-                errors.push({ path: key, message: `Missing required field: ${key}` });
-            }
-        }
-    }
-    return errors;
-}
-/**
- * Determine whether an error is transient and should be retried.
- * Transient: network errors, timeouts, throttling (429), 5xx responses.
- * Non-transient: 4xx (except 429), auth failures — fail immediately.
- */
-export function isTransientError(err) {
-    if (err === null || err === undefined)
-        return false;
-    // Check for status code on the error object (HTTP response errors)
-    const statusCode = typeof err.status_code === 'number'
-        ? err.status_code
-        : typeof err.statusCode === 'number'
-            ? err.statusCode
-            : typeof err.status === 'number'
-                ? err.status
-                : undefined;
-    if (statusCode !== undefined) {
-        // 429 (throttling) is transient
-        if (statusCode === 429)
-            return true;
-        // 5xx responses are transient
-        if (statusCode >= 500 && statusCode < 600)
-            return true;
-        // Other 4xx are non-transient (auth failures, validation errors, etc.)
-        if (statusCode >= 400 && statusCode < 500)
-            return false;
-    }
-    // Check error code strings
-    const code = typeof err.code === 'string'
-        ? err.code
-        : undefined;
-    if (code) {
-        const transientCodes = new Set([
-            'ECONNRESET',
-            'ECONNREFUSED',
-            'ENOTFOUND',
-            'ETIMEDOUT',
-            'EPIPE',
-            'EAI_AGAIN',
-            'RATE_LIMIT_EXCEEDED',
-            'RATE_LIMIT_ERROR',
-            'SERVICE_UNAVAILABLE',
-            'GATEWAY_TIMEOUT',
-            'INTERNAL_SERVER_ERROR',
-        ]);
-        if (transientCodes.has(code))
-            return true;
-        // Auth-related codes are non-transient
-        const nonTransientCodes = new Set([
-            'AUTHENTICATION_ERROR',
-            'AUTHORIZATION_ERROR',
-            'VALIDATION_ERROR',
-            'NOT_FOUND',
-        ]);
-        if (nonTransientCodes.has(code))
-            return false;
-    }
-    // Check error message for network-related keywords
-    const message = typeof err.message === 'string'
-        ? err.message.toLowerCase()
-        : '';
-    if (message.includes('timeout') ||
-        message.includes('econnreset') ||
-        message.includes('econnrefused') ||
-        message.includes('network') ||
-        message.includes('socket hang up')) {
-        return true;
-    }
-    // Default: treat unknown errors as transient to allow retry
-    return true;
-}
-/**
- * Sleep for the given number of milliseconds. Extracted for testability.
- */
-export function sleep(ms) {
-    if (ms <= 0)
-        return Promise.resolve();
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-/**
- * Create the flows API surface (list, get with nodes, create, get_writer).
- */
-export function createFlowsApi(http, deps) {
-    return {
-        async list(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_API_BASE}${qs}`);
-            return res.data;
-        },
-        async get(id) {
-            const flowRes = await http.get(`${WORKFLOWS_API_BASE}/${encodeURIComponent(id)}`);
-            const flow = flowRes.data;
-            let nodes = [];
-            try {
-                const nodesRes = await http.get(`${WORKFLOWS_API_BASE}/${encodeURIComponent(id)}/nodes`);
-                const payload = nodesRes.data ?? nodesRes;
-                nodes = payload.items ?? [];
-            }
-            catch {
-                // Nodes endpoint may not exist or may 404; flow still has node_count
-            }
-            return { ...flow, nodes };
-        },
-        async create(input) {
-            const res = await http.post(WORKFLOWS_API_BASE, input);
-            return res.data;
-        },
-        async get_writer(flow_id, options) {
-            // Resolve the stream runtime, source bot, and destination queue up front; the rstreams `load`
-            // stream (created inside createQueueWriter) owns buffering, batching, backoff, and checkpointing.
-            const rsdk = deps?.rsdk ?? (await deps?.get_rsdk?.());
-            if (!rsdk) {
-                throw new StreamingError('Stream bus configuration missing. Set LEO_* environment variables or add `streams` to ~/.loxtep/config.json. ' +
-                    'Pass `streams` in LoxtepClientOptions, or ensure your instance stream environment is configured.', {
-                    details: {
-                        flow_id,
-                        hint: 'Run `loxtep init` to configure stream bus, or set LEO_* env vars from your instance.',
-                    },
-                });
-            }
-            const botId = options?.bot_id;
-            if (!botId) {
-                throw new StreamingError('flows.get_writer requires bot_id in options (stream writer identity on the bus).', { details: { flow_id } });
-            }
-            let queueName = options?.output_queue_name;
-            if (!queueName && options?.environment_prefix && options?.project_id) {
-                const flowRes = await http.get(`${WORKFLOWS_API_BASE}/${encodeURIComponent(flow_id)}`);
-                const flowData = flowRes && typeof flowRes === 'object' && 'data' in flowRes
-                    ? flowRes.data
-                    : flowRes;
-                let nodes = [];
-                try {
-                    const nodesRes = await http.get(`${WORKFLOWS_API_BASE}/${encodeURIComponent(flow_id)}/nodes`);
-                    const payload = nodesRes.data ?? nodesRes;
-                    nodes = payload.items ?? [];
-                }
-                catch {
-                    /* ignore */
-                }
-                const flowWithNodes = { ...flowData, nodes };
-                queueName = resolveIngestionQueueName(flowWithNodes, options.environment_prefix);
-            }
-            if (!queueName) {
-                throw new StreamingError('flows.get_writer requires output_queue_name, or environment_prefix + project_id so the SDK can resolve the ingestion queue from the flow.', { details: { flow_id } });
-            }
-            const writer = createQueueWriter(rsdk, botId, queueName, () => new StreamingError('Cannot write to a closed FlowWriter. Create a new writer via flows.get_writer().', { details: { flow_id } }));
-            // Optional per-event definition validation wraps the passthrough writer.
-            const validate = options?.validate_definition === true && !!options?.definition;
-            if (!validate)
-                return writer;
-            const onError = options?.on_validation_error ?? 'reject';
-            return {
-                write(event, writeOptions) {
-                    if (options?.definition) {
-                        const errors = validateEventAgainstDefinition(event, options.definition);
-                        if (errors.length > 0) {
-                            if (onError === 'reject') {
-                                throw new DefinitionValidationError('Event failed definition validation', options.definition_version ?? '', errors);
-                            }
-                            if (onError === 'warn') {
-                                console.warn('[FlowWriter] Definition validation failed:', errors);
-                            }
-                            if (onError === 'skip')
-                                return;
-                        }
-                    }
-                    writer.write(event, writeOptions);
-                },
-                close: () => writer.close(),
-            };
-        },
-    };
-}
-//# sourceMappingURL=flows.js.map

package/dist/client/flows.js.map

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