@loxtep/sdk 0.1.0

package/dist/rstreams/configuration.js

@@ -0,0 +1,43 @@
+/**
+ * Resolve Loxtep stream bus configuration from explicit options and process.env
+ * (resource names from your instance / stack).
+ */
+const env = (k) => {
+    const v = process.env[k];
+    return v != null && String(v).trim() !== '' ? String(v).trim() : undefined;
+};
+/**
+ * Merge partial config with environment defaults (instance stream env + `AWS_REGION`).
+ * Returns undefined if required fields are missing (caller treats as "no bus configured").
+ */
+export function resolveStreamsConfiguration(partial) {
+    const Region = partial?.Region ?? env('AWS_REGION') ?? env('LEO_REGION');
+    const LeoEvent = partial?.LeoEvent ?? env('LEO_EVENT_TABLE');
+    const LeoStream = partial?.LeoStream ?? env('LEO_STREAM_TABLE');
+    const LeoCron = partial?.LeoCron ?? env('LEO_CRON_TABLE');
+    const LeoS3 = partial?.LeoS3 ?? env('LEO_S3_BUCKET');
+    const LeoKinesisStream = partial?.LeoKinesisStream ?? env('LEO_KINESIS_STREAM');
+    const LeoFirehoseStream = partial?.LeoFirehoseStream ?? env('FIREHOSE_STREAM') ?? env('LEO_FIREHOSE_STREAM');
+    const LeoSettings = partial?.LeoSettings ?? env('LEO_SETTINGS_TABLE');
+    if (!Region ||
+        !LeoEvent ||
+        !LeoStream ||
+        !LeoCron ||
+        !LeoS3 ||
+        !LeoKinesisStream ||
+        !LeoFirehoseStream ||
+        !LeoSettings) {
+        return undefined;
+    }
+    return {
+        Region,
+        LeoEvent,
+        LeoStream,
+        LeoCron,
+        LeoS3,
+        LeoKinesisStream,
+        LeoFirehoseStream,
+        LeoSettings,
+    };
+}
+//# sourceMappingURL=configuration.js.map

package/dist/rstreams/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../src/rstreams/configuration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,GAAG,GAAG,CAAC,CAAS,EAAsB,EAAE;IAC5C,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACzB,OAAO,CAAC,IAAI,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAyC;IAEzC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,GAAG,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG,OAAO,EAAE,gBAAgB,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAChF,MAAM,iBAAiB,GACrB,OAAO,EAAE,iBAAiB,IAAI,GAAG,CAAC,iBAAiB,CAAC,IAAI,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACrF,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACtE,IACE,CAAC,MAAM;QACP,CAAC,QAAQ;QACT,CAAC,SAAS;QACV,CAAC,OAAO;QACR,CAAC,KAAK;QACN,CAAC,gBAAgB;QACjB,CAAC,iBAAiB;QAClB,CAAC,WAAW,EACZ,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,MAAM;QACN,QAAQ;QACR,SAAS;QACT,OAAO;QACP,KAAK;QACL,gBAAgB;QAChB,iBAAiB;QACjB,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/rstreams/event-bridge.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Map stream read wrappers to the SDK queue event shape; write payloads via putEvent / putEvents.
+ */
+import type { RStreamsSdk } from 'leo-sdk';
+import type { QueueEvent } from '../client/queue-types.js';
+export declare function putPayloadsToQueue(rsdk: RStreamsSdk, botId: string, queueName: string, payloads: unknown[]): Promise<void>;
+/**
+ * Read up to `limit` events from `inQueue` acting as bot `id`, then return (mapped events, last start for next page).
+ * Uses one offloadEvents invocation per batch (stream checkpoints advance between calls).
+ */
+export type ReadQueueBatchResult = {
+    events: QueueEvent[];
+    next_start: string | undefined;
+};
+export declare function readQueueBatch<T = unknown>(rsdk: RStreamsSdk, id: string, inQueue: string, limit: number, start?: string | null): Promise<ReadQueueBatchResult>;
+//# sourceMappingURL=event-bridge.d.ts.map

package/dist/rstreams/event-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bridge.d.ts","sourceRoot":"","sources":["../../src/rstreams/event-bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,SAAS,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAwB3D,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE5F,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,OAAO,CAAC,oBAAoB,CAAC,CAqB/B"}

package/dist/rstreams/event-bridge.js

@@ -0,0 +1,45 @@
+/**
+ * Map stream read wrappers to the SDK queue event shape; write payloads via putEvent / putEvents.
+ */
+function readEventToQueueEvent(wrapper) {
+    const w = wrapper;
+    const event_id = (typeof w.id === 'string' && w.id) ||
+        (typeof w.eid === 'string' && w.eid) ||
+        (typeof w.event_id === 'string' &&
+            w.event_id) ||
+        '';
+    return {
+        event_id,
+        event_type: typeof w.event === 'string' ? w.event : undefined,
+        payload: (w.payload ?? w),
+        correlation_id: w.correlation_id,
+    };
+}
+export async function putPayloadsToQueue(rsdk, botId, queueName, payloads) {
+    if (payloads.length === 0)
+        return;
+    const events = payloads.map(p => p !== null && typeof p === 'object' && 'payload' in p ? p : p);
+    await rsdk.putEvents(events, { botId, queue: queueName });
+}
+export async function readQueueBatch(rsdk, id, inQueue, limit, start) {
+    const collected = [];
+    // Stream runtime transform/callback typings vary by version; keep runtime-correct shape.
+    await rsdk.offloadEvents({
+        id,
+        inQueue,
+        limit,
+        loops: 3,
+        start: start ?? undefined,
+        transform(_payload, wrapper, callback) {
+            collected.push(readEventToQueueEvent(wrapper));
+            if (typeof callback === 'function')
+                callback();
+        },
+    });
+    const last = collected[collected.length - 1];
+    return {
+        events: collected,
+        next_start: last?.event_id || undefined,
+    };
+}
+//# sourceMappingURL=event-bridge.js.map

package/dist/rstreams/event-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bridge.js","sourceRoot":"","sources":["../../src/rstreams/event-bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,SAAS,qBAAqB,CAAI,OAAqB;IACrD,MAAM,CAAC,GAAG,OAMT,CAAC;IACF,MAAM,QAAQ,GACZ,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC;QAClC,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC;QACpC,CAAC,OAAQ,CAA2B,CAAC,QAAQ,KAAK,QAAQ;YACvD,CAAqC,CAAC,QAAQ,CAAC;QAClD,EAAE,CAAC;IACL,OAAO;QACL,QAAQ;QACR,UAAU,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAC7D,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAA4B;QACpD,cAAc,EAAE,CAAC,CAAC,cAA8C;KACjE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAiB,EACjB,KAAa,EACb,SAAiB,EACjB,QAAmB;IAEnB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAC9B,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,SAAS,IAAK,CAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC1E,CAAC;IACF,MAAM,IAAI,CAAC,SAAS,CAAC,MAAiB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AACvE,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAiB,EACjB,EAAU,EACV,OAAe,EACf,KAAa,EACb,KAAqB;IAErB,MAAM,SAAS,GAAiB,EAAE,CAAC;IACnC,yFAAyF;IACzF,MACE,IACD,CAAC,aAAa,CAAC;QACd,EAAE;QACF,OAAO;QACP,KAAK;QACL,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,KAAK,IAAI,SAAS;QACzB,SAAS,CAAC,QAAW,EAAE,OAAqB,EAAE,QAAkC;YAC9E,SAAS,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;YAC/C,IAAI,OAAO,QAAQ,KAAK,UAAU;gBAAE,QAAQ,EAAE,CAAC;QACjD,CAAC;KACF,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,IAAI,EAAE,QAAQ,IAAI,SAAS;KACxC,CAAC;AACJ,CAAC"}

package/dist/rstreams/leo-runtime.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Loxtep stream runtime factory for the Node SDK data plane (ESM interop with the underlying runtime).
+ */
+import * as StreamRuntime from 'leo-sdk';
+export declare function createRStreamsSdk(config: StreamRuntime.ConfigurationResources): StreamRuntime.RStreamsSdk;
+export type { ConfigurationResources, RStreamsSdk } from 'leo-sdk';
+/** Loxtep stream runtime handle (injected in tests or advanced wiring). */
+export type { RStreamsSdk as LoxtepStreamRuntime } from 'leo-sdk';
+//# sourceMappingURL=leo-runtime.d.ts.map

package/dist/rstreams/leo-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leo-runtime.d.ts","sourceRoot":"","sources":["../../src/rstreams/leo-runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,aAAa,MAAM,SAAS,CAAC;AAEzC,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,CAAC,sBAAsB,GAC3C,aAAa,CAAC,WAAW,CAU3B;AAED,YAAY,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACnE,2EAA2E;AAC3E,YAAY,EAAE,WAAW,IAAI,mBAAmB,EAAE,MAAM,SAAS,CAAC"}

package/dist/rstreams/leo-runtime.js

@@ -0,0 +1,14 @@
+/**
+ * Loxtep stream runtime factory for the Node SDK data plane (ESM interop with the underlying runtime).
+ */
+import * as StreamRuntime from 'leo-sdk';
+export function createRStreamsSdk(config) {
+    const mod = StreamRuntime;
+    const defaultExport = mod.default;
+    const SDK = (mod.RStreamsSdk || defaultExport?.RStreamsSdk);
+    if (!SDK || typeof SDK !== 'function') {
+        throw new Error('Failed to resolve RStreamsSdk constructor from leo-sdk');
+    }
+    return new SDK(config);
+}
+//# sourceMappingURL=leo-runtime.js.map

package/dist/rstreams/leo-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leo-runtime.js","sourceRoot":"","sources":["../../src/rstreams/leo-runtime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,aAAa,MAAM,SAAS,CAAC;AAEzC,MAAM,UAAU,iBAAiB,CAC/B,MAA4C;IAE5C,MAAM,GAAG,GAAG,aAAmD,CAAC;IAChE,MAAM,aAAa,GAAG,GAAG,CAAC,OAA8C,CAAC;IACzE,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,aAAa,EAAE,WAAW,CAE7C,CAAC;IACd,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC"}

package/dist/streaming/index.d.ts

@@ -0,0 +1,2 @@
+export { mapStream, filterStream } from './transformer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streaming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/streaming/index.js

@@ -0,0 +1,2 @@
+export { mapStream, filterStream } from './transformer.js';
+//# sourceMappingURL=index.js.map

package/dist/streaming/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/streaming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/streaming/transformer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Stream transformation helpers: map and filter over async iterables.
+ * Use with data_products.stream(), data_products.replay(), or queues.open_reader().read().
+ */
+/**
+ * Map each item from an async iterable through a transform function.
+ * Yields transformed values.
+ */
+export declare function mapStream<T, U>(stream: AsyncIterable<T>, transform: (item: T) => U | Promise<U>): AsyncIterable<U>;
+/**
+ * Filter items from an async iterable by a predicate.
+ * Yields only items for which predicate returns true.
+ */
+export declare function filterStream<T>(stream: AsyncIterable<T>, predicate: (item: T) => boolean | Promise<boolean>): AsyncIterable<T>;
+//# sourceMappingURL=transformer.d.ts.map

package/dist/streaming/transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.d.ts","sourceRoot":"","sources":["../../src/streaming/transformer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAuB,SAAS,CAAC,CAAC,EAAE,CAAC,EACnC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACrC,aAAa,CAAC,CAAC,CAAC,CAIlB;AAED;;;GAGG;AACH,wBAAuB,YAAY,CAAC,CAAC,EACnC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GACjD,aAAa,CAAC,CAAC,CAAC,CAMlB"}

package/dist/streaming/transformer.js

@@ -0,0 +1,25 @@
+/**
+ * Stream transformation helpers: map and filter over async iterables.
+ * Use with data_products.stream(), data_products.replay(), or queues.open_reader().read().
+ */
+/**
+ * Map each item from an async iterable through a transform function.
+ * Yields transformed values.
+ */
+export async function* mapStream(stream, transform) {
+    for await (const item of stream) {
+        yield await transform(item);
+    }
+}
+/**
+ * Filter items from an async iterable by a predicate.
+ * Yields only items for which predicate returns true.
+ */
+export async function* filterStream(stream, predicate) {
+    for await (const item of stream) {
+        if (await predicate(item)) {
+            yield item;
+        }
+    }
+}
+//# sourceMappingURL=transformer.js.map

package/dist/streaming/transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.js","sourceRoot":"","sources":["../../src/streaming/transformer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,SAAS,CAC9B,MAAwB,EACxB,SAAsC;IAEtC,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAChC,MAAM,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,YAAY,CACjC,MAAwB,EACxB,SAAkD;IAElD,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAChC,IAAI,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,CAAC;QACb,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/types/generated-api.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Generated TypeScript types from API Zod schemas. Do not edit by hand.
+ * Regenerate: pnpm run generate:api-types
+ * Source: scripts/api-schemas.ts
+ */
+export type PaginationMetaApi = {
+    page: number;
+    page_size: number;
+    total: number;
+    total_pages: number;
+    has_next: boolean;
+    has_prev: boolean;
+};
+export type DataProductApi = {
+    data_product_id: string;
+    organization_id: string;
+    domain_id: string;
+    project_id?: string | undefined;
+    name: string;
+    description: string;
+    status: string;
+    owner: {
+        user_id: string;
+        team?: string | undefined;
+    };
+    schema?: {
+        [x: string]: unknown;
+    } | undefined;
+    ingestion?: {
+        [x: string]: unknown;
+    } | undefined;
+    storage?: {
+        [x: string]: unknown;
+    } | undefined;
+    consumption?: {
+        [x: string]: unknown;
+    } | undefined;
+    governance?: {
+        [x: string]: unknown;
+    } | undefined;
+    quality?: {
+        [x: string]: unknown;
+    } | undefined;
+    lineage?: {
+        [x: string]: unknown;
+    } | undefined;
+    metadata?: {
+        [x: string]: unknown;
+    } | undefined;
+    created_at: string;
+    updated_at: string;
+    deleted_at?: (string | null) | undefined;
+    created_by?: string | undefined;
+    updated_by?: string | undefined;
+};
+export type FlowApi = {
+    workflow_id: string;
+    project_id: string;
+    name: string;
+    connection_id?: string | undefined;
+    template_id?: string | undefined;
+    configuration: {
+        [x: string]: unknown;
+    };
+    deployment: {
+        [x: string]: unknown;
+    };
+    status: 'active' | 'paused' | 'error' | 'inactive';
+    metrics: {
+        [x: string]: unknown;
+    };
+    node_count?: number | undefined;
+    created_at: string;
+    updated_at: string;
+    deleted_at?: string | undefined;
+};
+export type FlowNodeApi = {
+    node_id: string;
+    workflow_id: string;
+    name: string;
+    type: 'ingestion' | 'transformation' | 'export';
+    node_subtype?: string | undefined;
+    webhook_id?: string | undefined;
+    configuration?: {
+        [x: string]: unknown;
+    } | undefined;
+    created_at: string;
+    updated_at: string;
+    deleted_at?: string | undefined;
+};
+export type ConnectionApi = {
+    connection_id: string;
+    organization_id?: (string | null) | undefined;
+    key: string;
+    name: string;
+    type: string;
+    status: string;
+    data: string;
+    configuration: {
+        [x: string]: unknown;
+    };
+    metadata: {
+        [x: string]: unknown;
+    };
+    verified: boolean;
+    draft: boolean;
+    last_tested?: (string | null) | undefined;
+    created_by?: (string | null) | undefined;
+    updated_by?: (string | null) | undefined;
+    created_at: string;
+    updated_at: string;
+    deleted_at?: (string | null) | undefined;
+};
+export type QueueMetadataApi = {
+    queue_id?: string | undefined;
+    queue_name?: string | undefined;
+    checkpoints?: {
+        [x: string]: unknown;
+    }[] | undefined;
+    readers?: {
+        [x: string]: unknown;
+    }[] | undefined;
+    writers?: {
+        [x: string]: unknown;
+    }[] | undefined;
+    stats?: {
+        [x: string]: unknown;
+    } | undefined;
+};
+export type QueueEventApi = {
+    event_id?: string | undefined;
+    payload?: unknown | undefined;
+    timestamp?: string | undefined;
+};
+export type QualityMetricApi = {
+    metric_id?: string | undefined;
+    data_product_id?: string | undefined;
+    metric_type?: string | undefined;
+    value?: number | undefined;
+    threshold?: number | undefined;
+    status?: string | undefined;
+    severity?: string | undefined;
+    measured_at?: string | undefined;
+    created_at?: string | undefined;
+};
+//# sourceMappingURL=generated-api.d.ts.map

package/dist/types/generated-api.d.ts.map

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

package/dist/types/generated-api.js

@@ -0,0 +1,7 @@
+/**
+ * Generated TypeScript types from API Zod schemas. Do not edit by hand.
+ * Regenerate: pnpm run generate:api-types
+ * Source: scripts/api-schemas.ts
+ */
+export {};
+//# sourceMappingURL=generated-api.js.map

package/dist/types/generated-api.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generated API types (from Zod schemas). Export from @loxtep/sdk.
+ */
+export type { PaginationMetaApi, DataProductApi, FlowApi, FlowNodeApi, ConnectionApi, QueueMetadataApi, QueueEventApi, QualityMetricApi, } from './generated-api.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,OAAO,EACP,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * Generated API types (from Zod schemas). Export from @loxtep/sdk.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/docs/event-replay-cookbook.md

@@ -0,0 +1,152 @@
+# Event replay cookbook
+
+Replay events from a data product or from a queue. This is a key differentiator
+for the Loxtep SDK: you can iterate over historical or live events without
+managing checkpoints yourself (or use checkpoints for resumable replay).
+
+## Replay from a data product
+
+Use `data_products.replay()` to read events for a data product by ID. You can
+optionally pass a start position and batch size.
+
+```ts
+import { LoxtepClient } from '@loxtep/sdk';
+
+const client = new LoxtepClient({
+  api_url: 'https://api.loxtep.com',
+  auth: { type: 'jwt', token: process.env.LOXTEP_TOKEN },
+});
+
+const dataProductId = '550e8400-e29b-41d4-a716-446655440000';
+
+for await (const event of client.data_products.replay(dataProductId)) {
+  console.log(event.event_id, event.payload);
+}
+```
+
+With options (start position, batch size):
+
+```ts
+for await (const event of client.data_products.replay(dataProductId, {
+  start: 'z/100',
+  batch_size: 200,
+})) {
+  process(event);
+}
+```
+
+## Read from a queue (open_reader)
+
+Use `queues.open_reader()` when you want to read from a specific queue by name
+(e.g. for observability or debugging). You get a handle with a `read()` async
+iterable.
+
+```ts
+const reader = await client.queues.open_reader({
+  bot_id: 'dev-bot-process',
+  queue_name: 'dev-app-notification-requested',
+});
+
+for await (const event of reader.read()) {
+  console.log(event.event_id, event.payload);
+}
+```
+
+With options (start, batch_size, checkpoint):
+
+```ts
+for await (const event of reader.read({
+  start: 'z/0',
+  batch_size: 100,
+})) {
+  process(event);
+}
+```
+
+## Stream live events from a data product
+
+Use `data_products.stream()` for a live stream of events (no fixed start; reads
+from the current tail).
+
+```ts
+for await (const event of client.data_products.stream(dataProductId)) {
+  console.log(event);
+}
+```
+
+## Transform and filter with mapStream / filterStream
+
+Use the streaming helpers to transform or filter events without loading
+everything into memory.
+
+```ts
+import { mapStream, filterStream } from '@loxtep/sdk';
+
+// Only events that pass a predicate
+for await (const event of filterStream(
+  client.data_products.replay(dataProductId),
+  e => (e.payload as { type: string }).type === 'order'
+)) {
+  console.log(event);
+}
+
+// Map to a simpler shape
+for await (const payload of mapStream(
+  client.data_products.replay(dataProductId),
+  e => e.payload as { id: string; amount: number }
+)) {
+  console.log(payload.id, payload.amount);
+}
+```
+
+## Checkpoint (resumable replay)
+
+Use `queues.get_reader_checkpoint()` to get the last checkpoint for a queue and
+bot, then pass it as `checkpoint` (or `start`) when opening a reader or
+replaying so you resume from that position.
+
+```ts
+const checkpoint = await client.queues.get_reader_checkpoint(
+  'dev-app-notification-requested',
+  'dev-bot-process'
+);
+
+const reader = await client.queues.open_reader({
+  bot_id: 'dev-bot-process',
+  queue_name: 'dev-app-notification-requested',
+  options: { checkpoint: checkpoint.checkpoint, batch_size: 100 },
+});
+
+for await (const event of reader.read()) {
+  await processAndSaveCheckpoint(event);
+}
+```
+
+## Error handling
+
+If the API returns an error (e.g. 429 rate limit), the async iterator will
+throw. Wrap in try/catch and optionally retry or back off.
+
+```ts
+try {
+  for await (const event of client.data_products.replay(dataProductId)) {
+    process(event);
+  }
+} catch (err) {
+  if (err instanceof RateLimitError) {
+    await sleep(err.retry_after_seconds * 1000);
+    // retry...
+  }
+  throw err;
+}
+```
+
+## Summary
+
+| Use case                  | Method                                              | When to use                              |
+| ------------------------- | --------------------------------------------------- | ---------------------------------------- |
+| Replay by data product    | `data_products.replay(id [, options])`                | Historical events for a data product     |
+| Live stream by data product | `data_products.stream(id)`                            | Tail of events for a data product        |
+| Read by queue name        | `queues.open_reader({ bot_id, queue_name }).read()` | Inspect a specific queue (observe/debug) |
+| Resumable read            | `get_reader_checkpoint` + `options.checkpoint`      | Continue from last position              |
+| Transform/filter          | `mapStream`, `filterStream`                         | Without loading all events into memory   |