@loxtep/sdk 0.1.0

package/dist/client/data-assets-types.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Data asset (backend: data product) API types. All snake_case per backend conventions.
+ */
+/** Pagination metadata from list APIs. */
+export interface PaginationMeta {
+    page: number;
+    page_size: number;
+    total: number;
+    total_pages: number;
+    has_next: boolean;
+    has_prev: boolean;
+}
+/** Filters for data_assets.list(). Maps to GET /dataproducts query params. */
+export interface DataAssetsListFilters {
+    page?: number;
+    page_size?: number;
+    domain_id?: string;
+    status?: 'draft' | 'active' | 'deprecated' | 'archived';
+    classification?: string;
+    owner_user_id?: string;
+    search?: string;
+    tags?: string[];
+    sort_by?: 'name' | 'created_at' | 'updated_at';
+    sort_order?: 'asc' | 'desc';
+}
+/** Single data asset (backend: data product). Simplified for SDK; full shape matches API. */
+export interface DataAsset {
+    data_product_id: string;
+    organization_id: string;
+    domain_id: string;
+    project_id?: string;
+    name: string;
+    description: string;
+    status: string;
+    owner: {
+        user_id: string;
+        team?: string;
+    };
+    schema?: Record<string, unknown>;
+    ingestion?: Record<string, unknown>;
+    storage?: Record<string, unknown>;
+    consumption?: Record<string, unknown>;
+    governance?: Record<string, unknown>;
+    quality?: Record<string, unknown>;
+    lineage?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    deleted_at?: string | null;
+    created_by?: string;
+    updated_by?: string;
+    [key: string]: unknown;
+}
+/** Response from data_assets.get() — API returns { success: true, data: DataProduct }. */
+export interface DataAssetGetResponse {
+    success: true;
+    data: DataAsset;
+}
+/** Response from data_assets.list() — API returns { success: true, data: { items, pagination } }. */
+export interface DataAssetsListResponse {
+    success: true;
+    data: {
+        items: DataAsset[];
+        pagination: PaginationMeta;
+    };
+}
+/** Options for data_assets.get() — optional query params. */
+export interface DataAssetGetOptions {
+    include_schema?: boolean;
+    include_quality?: boolean;
+    include_lineage?: boolean;
+    include_contracts?: boolean;
+}
+/** Glossary term value (definition and optional SKOS-style relations). */
+export interface GlossaryTermValue {
+    definition: string;
+    alt_labels?: string[];
+    broader?: string[];
+    narrower?: string[];
+    related?: string[];
+}
+/** Lexicon response from data_assets.get_lexicon(id). */
+export interface DataAssetLexicon {
+    glossary_terms: Record<string, GlossaryTermValue>;
+    field_glossary_map?: Record<string, string[]>;
+}
+/** Search result item (catalog/search API). */
+export interface SearchResultItem {
+    id: string;
+    type: 'data_product' | 'project' | 'domain';
+    name?: string;
+    description?: string;
+    [key: string]: unknown;
+}
+/** Response from data_assets.search() — catalog search API. */
+export interface DataAssetsSearchResponse {
+    success?: boolean;
+    results: SearchResultItem[];
+    totalCount: number;
+    facets?: Record<string, unknown>;
+}
+/** Options for data_assets.stream() — live read from queue. */
+export interface DataAssetStreamOptions {
+    from?: string;
+    batch_size?: number;
+    checkpoint?: string;
+}
+/** Options for data_assets.replay() — time-travel read. */
+export interface DataAssetReplayOptions {
+    from_eid?: string;
+    to_eid?: string;
+    from_timestamp?: string;
+    to_timestamp?: string;
+    from_beginning?: boolean;
+    from_latest?: boolean;
+    checkpoint_id?: string;
+    auto_checkpoint?: boolean;
+    limit?: number;
+}
+/** Single event from stream/replay. */
+export interface StreamEvent {
+    event_id?: string;
+    payload?: unknown;
+    timestamp?: string;
+    [key: string]: unknown;
+}
+/** Result of data_assets.query(id, sql). Backend: POST /dataproducts/query or analytics query. */
+export interface DataAssetQueryResult {
+    items: Record<string, unknown>[];
+    metadata: {
+        data_product_id: string;
+        data_product_name?: string;
+        total_rows?: number;
+        returned_rows?: number;
+        limit?: number;
+        offset?: number;
+        query_time_ms?: number;
+    };
+}
+/** Single table info from data_assets.list_tables(id). */
+export interface DataAssetTableInfo {
+    name: string;
+    schema?: string;
+    [key: string]: unknown;
+}
+/** Result of data_assets.list_tables(id). Backend: GET /dataproducts/:id/tables. */
+export interface DataAssetListTablesResult {
+    items: DataAssetTableInfo[];
+}
+//# sourceMappingURL=data-assets-types.d.ts.map

package/dist/client/data-assets-types.d.ts.map

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

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

@@ -0,0 +1,5 @@
+/**
+ * Data asset (backend: data product) API types. All snake_case per backend conventions.
+ */
+export {};
+//# sourceMappingURL=data-assets-types.js.map

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

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

package/dist/client/data-assets.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Data assets API (backend: data products). get, list, search, get_queue_info, get_reader_checkpoint.
+ * Customer-facing surface: data_assets.
+ */
+import type { LoxtepHttpClient } from '../http/client.js';
+import type { DataAsset, DataAssetsListFilters, DataAssetGetOptions, DataAssetsListResponse, DataAssetsSearchResponse, DataAssetStreamOptions, DataAssetReplayOptions, StreamEvent, DataAssetQueryResult, DataAssetListTablesResult, DataAssetLexicon } from './data-assets-types.js';
+import type { QueueMetadata, ReaderCheckpoint } from './queue-types.js';
+export interface DataAssetsApiDeps {
+    get_queue_metadata: (queue_name: string) => Promise<QueueMetadata>;
+    get_reader_checkpoint: (queue_name: string, bot_id: string) => Promise<ReaderCheckpoint>;
+}
+/**
+ * Create the data_assets API surface (get, list, search, query, list_tables, get_queue_info, get_reader_checkpoint, stream, replay).
+ */
+export declare function createDataAssetsApi(http: LoxtepHttpClient, deps?: DataAssetsApiDeps): {
+    get: (id: string, options?: DataAssetGetOptions) => Promise<DataAsset>;
+    get_lexicon: (id: string) => Promise<DataAssetLexicon>;
+    list: (filters?: DataAssetsListFilters) => Promise<DataAssetsListResponse['data']>;
+    search: (query: string, filters?: {
+        type?: string;
+        limit?: number;
+        offset?: number;
+    }) => Promise<DataAssetsSearchResponse>;
+    query: (id: string, sql: string) => Promise<DataAssetQueryResult>;
+    list_tables: (id: string) => Promise<DataAssetListTablesResult>;
+    get_queue_info: (id: string) => Promise<QueueMetadata>;
+    get_reader_checkpoint: (id: string, bot_id: string) => Promise<ReaderCheckpoint>;
+    stream: (id: string, options?: DataAssetStreamOptions) => AsyncIterable<StreamEvent>;
+    replay: (id: string, options?: DataAssetReplayOptions) => AsyncIterable<StreamEvent>;
+};
+//# sourceMappingURL=data-assets.d.ts.map

package/dist/client/data-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-assets.d.ts","sourceRoot":"","sources":["../../src/client/data-assets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACV,SAAS,EACT,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EACX,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAgBxE,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACnE,qBAAqB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC1F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,gBAAgB,EACtB,IAAI,CAAC,EAAE,iBAAiB,GACvB;IACD,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACvE,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvD,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,qBAAqB,KAAK,OAAO,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;IACnF,MAAM,EAAE,CACN,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KACzD,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACvC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAClE,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAChE,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACvD,qBAAqB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACjF,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,KAAK,aAAa,CAAC,WAAW,CAAC,CAAC;IACrF,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,KAAK,aAAa,CAAC,WAAW,CAAC,CAAC;CACtF,CAqLA"}

package/dist/client/data-assets.js

@@ -0,0 +1,182 @@
+/**
+ * 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

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

package/dist/client/data-product-resolver.d.ts

@@ -0,0 +1,92 @@
+/**
+ * DataProductResolver — resolves a data product name or UUID into fully-qualified
+ * runtime configuration (queue, bot_id, stream bus resources).
+ *
+ * Resolution chain:
+ * 1. Resolve data product (by UUID direct lookup or name search)
+ * 2. Extract runtime bindings (deployment_bindings)
+ * 3. Resolve stream config from instance record
+ *
+ * Results are cached in-memory keyed by both name and ID.
+ */
+import type { LoxtepHttpClient } from '../http/client.js';
+import { LoxtepError } from '../errors/base.js';
+export interface ResolvedDataProduct {
+    data_product_id: string;
+    name: string;
+    queue_name: string;
+    bot_id: string;
+    instance_id: string;
+    workflow_id: string;
+    deployment_id: string;
+}
+export interface ResolvedStreamConfig {
+    Region: string;
+    LeoEvent: string;
+    LeoStream: string;
+    LeoCron: string;
+    LeoS3: string;
+    LeoKinesisStream: string;
+    LeoFirehoseStream: string;
+    LeoSettings: string;
+}
+export interface FullResolution {
+    dataProduct: ResolvedDataProduct;
+    streamConfig: ResolvedStreamConfig;
+}
+/** Thrown when multiple data products match a name search (ambiguous). */
+export declare class AmbiguityError extends LoxtepError {
+    readonly matches: Array<{
+        data_product_id: string;
+        instance_id?: string;
+    }>;
+    constructor(message: string, matches: Array<{
+        data_product_id: string;
+        instance_id?: string;
+    }>, options?: {
+        details?: Record<string, unknown>;
+        request_id?: string;
+    });
+}
+/**
+ * Resolves data product identifiers (name or UUID) into full runtime configuration
+ * including queue name, bot_id, and stream bus resources.
+ */
+export declare class DataProductResolver {
+    private readonly http;
+    private readonly clientInstanceId?;
+    private cache;
+    constructor(http: LoxtepHttpClient, clientInstanceId?: string | undefined);
+    /**
+     * Full resolution chain: data product → runtime bindings → stream config.
+     * Results are cached by both name and ID for subsequent calls.
+     */
+    resolve(idOrName: string): Promise<FullResolution>;
+    /**
+     * Invalidate cached resolution. If no argument is provided, clears all cached entries.
+     * If a specific name or ID is provided, removes only that entry.
+     */
+    invalidate(idOrName?: string): void;
+    /**
+     * Return the first cached stream config (if any resolution has been performed).
+     * Used by LoxtepClient.resolve_stream_sdk() to reuse stream config from a prior
+     * data product resolution without making additional API calls.
+     */
+    getCachedStreamConfig(): ResolvedStreamConfig | undefined;
+    /**
+     * Resolve a data product by UUID (direct GET) or by name (search + exact match).
+     * Throws NotFoundError if no match, AmbiguityError if multiple matches.
+     */
+    private resolveDataProduct;
+    /**
+     * Extract and validate runtime bindings from a data product record.
+     * Throws StreamingError if the data product has not been deployed.
+     */
+    private extractRuntimeBindings;
+    /**
+     * Resolve stream bus configuration from the instance record.
+     * Calls GET /instances/{id}/stream-config.
+     */
+    private resolveStreamConfig;
+}
+//# sourceMappingURL=data-product-resolver.d.ts.map

package/dist/client/data-product-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-product-resolver.d.ts","sourceRoot":"","sources":["../../src/client/data-product-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,mBAAmB,CAAC;IACjC,YAAY,EAAE,oBAAoB,CAAC;CACpC;AAID,0EAA0E;AAC1E,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;gBAGzE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,KAAK,CAAC;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EACjE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAYvE;AAQD;;;GAGG;AACH,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAJpC,OAAO,CAAC,KAAK,CAAqC;gBAG/B,IAAI,EAAE,gBAAgB,EACtB,gBAAgB,CAAC,EAAE,MAAM,YAAA;IAG5C;;;OAGG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAqBxD;;;OAGG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAQnC;;;;OAIG;IACH,qBAAqB,IAAI,oBAAoB,GAAG,SAAS;IAOzD;;;OAGG;YACW,kBAAkB;IAyDhC;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IA0B9B;;;OAGG;YACW,mBAAmB;CAMlC"}

package/dist/client/data-product-resolver.js

@@ -0,0 +1,165 @@
+/**
+ * DataProductResolver — resolves a data product name or UUID into fully-qualified
+ * runtime configuration (queue, bot_id, stream bus resources).
+ *
+ * Resolution chain:
+ * 1. Resolve data product (by UUID direct lookup or name search)
+ * 2. Extract runtime bindings (deployment_bindings)
+ * 3. Resolve stream config from instance record
+ *
+ * Results are cached in-memory keyed by both name and ID.
+ */
+import { NotFoundError } from '../errors/resource.js';
+import { StreamingError } from '../errors/streaming.js';
+import { LoxtepError } from '../errors/base.js';
+// ─── Errors ──────────────────────────────────────────────────────────────────
+/** Thrown when multiple data products match a name search (ambiguous). */
+export class AmbiguityError extends LoxtepError {
+    matches;
+    constructor(message, matches, options) {
+        super(message, {
+            code: 'AMBIGUITY_ERROR',
+            status_code: 409,
+            details: options?.details,
+            request_id: options?.request_id,
+        });
+        this.name = 'AmbiguityError';
+        this.matches = matches;
+        Object.setPrototypeOf(this, AmbiguityError.prototype);
+    }
+}
+// ─── UUID detection ──────────────────────────────────────────────────────────
+const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+// ─── Resolver ────────────────────────────────────────────────────────────────
+/**
+ * Resolves data product identifiers (name or UUID) into full runtime configuration
+ * including queue name, bot_id, and stream bus resources.
+ */
+export class DataProductResolver {
+    http;
+    clientInstanceId;
+    cache = new Map();
+    constructor(http, clientInstanceId) {
+        this.http = http;
+        this.clientInstanceId = clientInstanceId;
+    }
+    /**
+     * Full resolution chain: data product → runtime bindings → stream config.
+     * Results are cached by both name and ID for subsequent calls.
+     */
+    async resolve(idOrName) {
+        const cacheKey = idOrName.toLowerCase();
+        const cached = this.cache.get(cacheKey);
+        if (cached)
+            return cached;
+        // Step 1: Resolve data product record with runtime bindings
+        const dp = await this.resolveDataProduct(idOrName);
+        // Step 2: Resolve stream config from instance
+        const streamConfig = await this.resolveStreamConfig(dp.instance_id);
+        const result = { dataProduct: dp, streamConfig };
+        // Cache by the original key, by ID, and by name
+        this.cache.set(cacheKey, result);
+        this.cache.set(dp.data_product_id.toLowerCase(), result);
+        this.cache.set(dp.name.toLowerCase(), result);
+        return result;
+    }
+    /**
+     * Invalidate cached resolution. If no argument is provided, clears all cached entries.
+     * If a specific name or ID is provided, removes only that entry.
+     */
+    invalidate(idOrName) {
+        if (!idOrName) {
+            this.cache.clear();
+            return;
+        }
+        this.cache.delete(idOrName.toLowerCase());
+    }
+    /**
+     * Return the first cached stream config (if any resolution has been performed).
+     * Used by LoxtepClient.resolve_stream_sdk() to reuse stream config from a prior
+     * data product resolution without making additional API calls.
+     */
+    getCachedStreamConfig() {
+        for (const entry of this.cache.values()) {
+            return entry.streamConfig;
+        }
+        return undefined;
+    }
+    /**
+     * Resolve a data product by UUID (direct GET) or by name (search + exact match).
+     * Throws NotFoundError if no match, AmbiguityError if multiple matches.
+     */
+    async resolveDataProduct(idOrName) {
+        const isUuid = UUID_REGEX.test(idOrName);
+        if (isUuid) {
+            const res = await this.http.get(`/dataproducts/${encodeURIComponent(idOrName)}`);
+            return this.extractRuntimeBindings(res.data);
+        }
+        // Search by name, scoped to instance if configured
+        const params = new URLSearchParams({ search: idOrName });
+        if (this.clientInstanceId) {
+            params.set('instance_id', this.clientInstanceId);
+        }
+        const qs = params.toString();
+        const res = await this.http.get(`/dataproducts?${qs}`);
+        const matches = res.data.items.filter(dp => dp.name === idOrName);
+        if (matches.length === 0) {
+            throw new NotFoundError(`Data product '${idOrName}' not found. Verify the name is correct and that the workflow has been deployed.`, 'data_product', idOrName, {
+                details: {
+                    searched_name: idOrName,
+                    instance_id: this.clientInstanceId ?? null,
+                    hint: 'Check the data product name or use the UUID directly. Ensure the workflow containing this data product has been deployed.',
+                },
+            });
+        }
+        if (matches.length > 1) {
+            const matchInfo = matches.map(dp => ({
+                data_product_id: dp.data_product_id,
+                instance_id: dp.deployment_bindings?.instance_id,
+            }));
+            throw new AmbiguityError(`Multiple data products match name '${idOrName}'. Specify an instance_id in the client config or use the data product UUID directly.`, matchInfo, {
+                details: {
+                    searched_name: idOrName,
+                    match_count: matches.length,
+                    matches: matchInfo,
+                    hint: 'Set instance_id in LoxtepClient options to scope the search, or use the data_product_id UUID.',
+                },
+            });
+        }
+        return this.extractRuntimeBindings(matches[0]);
+    }
+    /**
+     * Extract and validate runtime bindings from a data product record.
+     * Throws StreamingError if the data product has not been deployed.
+     */
+    extractRuntimeBindings(dp) {
+        const bindings = dp.deployment_bindings;
+        if (!bindings?.queue_name || !bindings?.bot_id || !bindings?.instance_id) {
+            throw new StreamingError(`Data product '${dp.name}' (${dp.data_product_id}) is not deployed. Deploy the workflow first.`, {
+                details: {
+                    data_product_id: dp.data_product_id,
+                    name: dp.name,
+                    hint: "Use 'deploy_workflow' or 'deploy_project' to deploy the workflow containing this data product.",
+                },
+            });
+        }
+        return {
+            data_product_id: dp.data_product_id,
+            name: dp.name,
+            queue_name: bindings.queue_name,
+            bot_id: bindings.bot_id,
+            instance_id: bindings.instance_id,
+            workflow_id: dp.workflow_id ?? '',
+            deployment_id: bindings.deployment_id,
+        };
+    }
+    /**
+     * Resolve stream bus configuration from the instance record.
+     * Calls GET /instances/{id}/stream-config.
+     */
+    async resolveStreamConfig(instanceId) {
+        const res = await this.http.get(`/instances/${encodeURIComponent(instanceId)}/stream-config`);
+        return res.data;
+    }
+}
+//# sourceMappingURL=data-product-resolver.js.map