@laserdata/laser-sdk 0.0.1-rc.1 → 0.0.1-rc.3

package/dist/stream/consumer.d.ts

@@ -0,0 +1,50 @@
+import type { ConsumerTarget, IggyHeaderValue, LaserTransport } from "../iggy/apache-iggy.js";
+import type { PollingStrategy } from "./polling-strategy.js";
+export interface ConsumedMessage {
+    readonly payload: Uint8Array;
+    readonly partitionId: number;
+    readonly offset: bigint;
+    readonly timestampMicros?: bigint;
+    readonly headers: ReadonlyMap<string, IggyHeaderValue>;
+}
+export interface ConsumerOptions {
+    readonly batchLength?: number;
+    readonly autoCommit?: boolean;
+    readonly startFrom?: PollingStrategy;
+    readonly pollIntervalMs?: number;
+}
+/** Polls one partition or consumer group until shutdown. */
+export declare class Consumer implements AsyncIterable<ConsumedMessage>, AsyncDisposable {
+    private readonly transport;
+    private readonly streamName;
+    private readonly topicName;
+    private readonly target;
+    private readonly batchLength;
+    private readonly autoCommit;
+    private readonly startFrom;
+    private readonly pollIntervalMs;
+    private buffer;
+    private readonly consumedOffsets;
+    private started;
+    private shuttingDown;
+    constructor(transport: LaserTransport, streamName: string, topicName: string, target: ConsumerTarget, options?: ConsumerOptions);
+    nextWithin(timeoutMs: number, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<ConsumedMessage | null>;
+    [Symbol.asyncIterator](): AsyncIterator<ConsumedMessage>;
+    stream(options?: {
+        readonly signal?: AbortSignal;
+    }): AsyncIterable<ConsumedMessage>;
+    commit(message: ConsumedMessage): Promise<void>;
+    lastConsumedOffset(partitionId: number): bigint | undefined;
+    storedOffset(partitionId: number): Promise<{
+        readonly storedOffset: bigint;
+        readonly currentOffset: bigint;
+    } | undefined>;
+    /** Ends iteration and leaves the consumer group when present. */
+    shutdown(): Promise<void>;
+    /** Delegates async disposal to `shutdown()`. */
+    [Symbol.asyncDispose](): Promise<void>;
+    private fillBuffer;
+}
+//# sourceMappingURL=consumer.d.ts.map

package/dist/stream/consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer.d.ts","sourceRoot":"","sources":["../../src/stream/consumer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,cAAc,EAEf,MAAM,wBAAwB,CAAA;AAE/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CACvD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAA;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACjC;AAwBD,4DAA4D;AAC5D,qBAAa,QAAS,YAAW,aAAa,CAAC,eAAe,CAAC,EAAE,eAAe;IAW5E,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAbzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4B;IAC5D,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,YAAY,CAAQ;IAE5B,YACmB,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,EACvC,OAAO,GAAE,eAAoB,EAwB9B;IAEK,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAC9C,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAiBjC;IAEM,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,eAAe,CAAC,CAE9D;IAEM,MAAM,CAAC,OAAO,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,aAAa,CAAC,eAAe,CAAC,CAe7F;IAEK,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAQpD;IAED,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1D;IAEK,YAAY,CAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAmBxF;IAED,iEAAiE;IAC3D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAM9B;IAED,gDAAgD;IAChD,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAErC;YAEa,UAAU;CAiBzB"}

package/dist/stream/consumer.js

@@ -0,0 +1,145 @@
+import { CancelledError, InvalidError, UnsupportedError } from "../client/errors.js";
+const DEFAULT_BATCH_LENGTH = 100;
+const DEFAULT_POLL_INTERVAL_MS = 250;
+const DEFAULT_START_FROM = { kind: "next" };
+function delay(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new CancelledError("wait aborted", { cause: signal.reason }));
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new CancelledError("wait aborted", { cause: signal?.reason }));
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+/** Polls one partition or consumer group until shutdown. */
+export class Consumer {
+    transport;
+    streamName;
+    topicName;
+    target;
+    batchLength;
+    autoCommit;
+    startFrom;
+    pollIntervalMs;
+    buffer = [];
+    consumedOffsets = new Map();
+    started = false;
+    shuttingDown = false;
+    constructor(transport, streamName, topicName, target, options = {}) {
+        this.transport = transport;
+        this.streamName = streamName;
+        this.topicName = topicName;
+        this.target = target;
+        this.batchLength = options.batchLength ?? DEFAULT_BATCH_LENGTH;
+        this.autoCommit = options.autoCommit ?? true;
+        this.startFrom = options.startFrom ?? DEFAULT_START_FROM;
+        this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+        if (this.target.kind === "single" &&
+            (!Number.isSafeInteger(this.target.partitionId) || this.target.partitionId < 0)) {
+            throw new InvalidError("consumer partition must be a non-negative safe integer");
+        }
+        if (!Number.isSafeInteger(this.batchLength) || this.batchLength < 1) {
+            throw new InvalidError("consumer batchLength must be a positive safe integer");
+        }
+        if (!Number.isFinite(this.pollIntervalMs) || this.pollIntervalMs < 0) {
+            throw new InvalidError("consumer pollIntervalMs must be a non-negative finite number");
+        }
+        if ((this.startFrom.kind === "offset" || this.startFrom.kind === "timestamp") &&
+            this.startFrom.value < 0n) {
+            throw new InvalidError("consumer start value must be non-negative");
+        }
+    }
+    async nextWithin(timeoutMs, options = {}) {
+        if (!Number.isFinite(timeoutMs) || timeoutMs < 0) {
+            throw new InvalidError("nextWithin timeout must be a non-negative finite number");
+        }
+        const deadline = Date.now() + timeoutMs;
+        for (;;) {
+            if (options.signal?.aborted === true) {
+                throw new CancelledError("nextWithin aborted", { cause: options.signal.reason });
+            }
+            const message = this.buffer.shift();
+            if (message !== undefined)
+                return message;
+            await this.fillBuffer(options.signal);
+            if (this.buffer.length > 0)
+                continue;
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                return null;
+            await delay(Math.min(this.pollIntervalMs, remaining), options.signal);
+        }
+    }
+    async *[Symbol.asyncIterator]() {
+        yield* this.stream();
+    }
+    async *stream(options = {}) {
+        while (!this.shuttingDown) {
+            if (options.signal?.aborted === true) {
+                throw new CancelledError("consumer stream aborted", { cause: options.signal.reason });
+            }
+            const message = this.buffer.shift();
+            if (message !== undefined) {
+                yield message;
+                continue;
+            }
+            await this.fillBuffer(options.signal);
+            if (this.buffer.length === 0) {
+                await delay(this.pollIntervalMs, options.signal);
+            }
+        }
+    }
+    async commit(message) {
+        await this.transport.storeOffset(this.streamName, this.topicName, this.target, message.partitionId, message.offset);
+    }
+    lastConsumedOffset(partitionId) {
+        return this.consumedOffsets.get(partitionId);
+    }
+    async storedOffset(partitionId) {
+        if (this.transport.getConsumerOffset === undefined) {
+            throw new UnsupportedError("the Apache Iggy client does not expose consumer offsets");
+        }
+        const offsetTarget = this.target.kind === "group"
+            ? { kind: "group", name: this.target.name }
+            : this.target.name === undefined
+                ? undefined
+                : { kind: "consumer", name: this.target.name };
+        if (offsetTarget === undefined) {
+            throw new InvalidError("storedOffset() requires a named standalone consumer");
+        }
+        return this.transport.getConsumerOffset(this.streamName, this.topicName, offsetTarget, partitionId);
+    }
+    /** Ends iteration and leaves the consumer group when present. */
+    async shutdown() {
+        if (this.shuttingDown)
+            return;
+        this.shuttingDown = true;
+        if (this.target.kind === "group") {
+            await this.transport.leaveConsumerGroup(this.streamName, this.topicName, this.target.name);
+        }
+    }
+    /** Delegates async disposal to `shutdown()`. */
+    [Symbol.asyncDispose]() {
+        return this.shutdown();
+    }
+    async fillBuffer(signal) {
+        if (signal?.aborted === true) {
+            throw new CancelledError("consumer poll aborted", { cause: signal.reason });
+        }
+        const strategy = this.started ? { kind: "next" } : this.startFrom;
+        this.started = true;
+        const polled = await this.transport.pollMessages(this.streamName, this.topicName, this.target, strategy, this.batchLength, this.autoCommit);
+        for (const message of polled)
+            this.consumedOffsets.set(message.partitionId, message.offset);
+        this.buffer.push(...polled);
+    }
+}
+//# sourceMappingURL=consumer.js.map

package/dist/stream/consumer.js.map

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

package/dist/stream/cursor.d.ts

@@ -0,0 +1,26 @@
+import type { LaserTransport } from "../iggy/apache-iggy.js";
+import type { ConsumedMessage } from "./consumer.js";
+export interface CursorOptions {
+    readonly batchSize?: number;
+    readonly readerName?: string;
+}
+export declare class Cursor {
+    private readonly transport;
+    private readonly streamName;
+    private readonly topicName;
+    private batchSize;
+    private readonly partitionOffsets;
+    private readonly readerName;
+    constructor(transport: LaserTransport, streamName: string, topicName: string, partitionIds: readonly number[], options?: CursorOptions);
+    get offsets(): ReadonlyMap<number, bigint>;
+    fromOffsets(offsets: ReadonlyMap<number, bigint>): this;
+    batch(size: number): this;
+    poll(options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<readonly ConsumedMessage[]>;
+    stream(options?: {
+        readonly signal?: AbortSignal;
+        readonly pollIntervalMs?: number;
+    }): AsyncIterable<ConsumedMessage>;
+}
+//# sourceMappingURL=cursor.d.ts.map

package/dist/stream/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/stream/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAGpD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAuBD,qBAAa,MAAM;IAMf,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP5B,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAE/C,YACmB,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAClC,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,OAAO,GAAE,aAAkB,EAK5B;IAED,IAAI,OAAO,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzC;IAED,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAOtD;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGxB;IAEK,IAAI,CAAC,OAAO,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAyB/F;IAEM,MAAM,CACX,OAAO,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAO,GAChF,aAAa,CAAC,eAAe,CAAC,CAUhC;CACF"}

package/dist/stream/cursor.js

@@ -0,0 +1,83 @@
+import { CancelledError } from "../client/errors.js";
+const DEFAULT_BATCH_SIZE = 100;
+const DEFAULT_POLL_INTERVAL_MS = 250;
+function delay(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new CancelledError("wait aborted", { cause: signal.reason }));
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new CancelledError("wait aborted", { cause: signal?.reason }));
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+export class Cursor {
+    transport;
+    streamName;
+    topicName;
+    batchSize;
+    partitionOffsets;
+    readerName;
+    constructor(transport, streamName, topicName, partitionIds, options = {}) {
+        this.transport = transport;
+        this.streamName = streamName;
+        this.topicName = topicName;
+        this.batchSize = options.batchSize ?? DEFAULT_BATCH_SIZE;
+        this.readerName = options.readerName;
+        this.partitionOffsets = new Map(partitionIds.map((id) => [id, 0n]));
+    }
+    get offsets() {
+        return new Map(this.partitionOffsets);
+    }
+    fromOffsets(offsets) {
+        for (const [partitionId, offset] of offsets) {
+            if (this.partitionOffsets.has(partitionId)) {
+                this.partitionOffsets.set(partitionId, offset);
+            }
+        }
+        return this;
+    }
+    batch(size) {
+        this.batchSize = size;
+        return this;
+    }
+    async poll(options = {}) {
+        if (options.signal?.aborted === true) {
+            throw new CancelledError("poll aborted", { cause: options.signal.reason });
+        }
+        const results = [];
+        for (const [partitionId, offset] of this.partitionOffsets) {
+            const strategy = { kind: "offset", value: offset };
+            const polled = await this.transport.pollMessages(this.streamName, this.topicName, {
+                kind: "single",
+                partitionId,
+                ...(this.readerName !== undefined ? { name: this.readerName } : {})
+            }, strategy, this.batchSize, false);
+            for (const message of polled) {
+                results.push(message);
+                this.partitionOffsets.set(partitionId, message.offset + 1n);
+            }
+        }
+        return results;
+    }
+    async *stream(options = {}) {
+        const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+        for (;;) {
+            const batch = await this.poll(options.signal === undefined ? {} : { signal: options.signal });
+            if (batch.length === 0) {
+                await delay(pollIntervalMs, options.signal);
+                continue;
+            }
+            for (const message of batch)
+                yield message;
+        }
+    }
+}
+//# sourceMappingURL=cursor.js.map

package/dist/stream/cursor.js.map

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

package/dist/stream/header-value.d.ts

@@ -0,0 +1,18 @@
+import type { IggyHeaderValue } from "../iggy/apache-iggy.js";
+export declare const HeaderValue: {
+    readonly string: (value: string) => IggyHeaderValue;
+    readonly bool: (value: boolean) => IggyHeaderValue;
+    readonly int8: (value: number) => IggyHeaderValue;
+    readonly int16: (value: number) => IggyHeaderValue;
+    readonly int32: (value: number) => IggyHeaderValue;
+    readonly int64: (value: bigint) => IggyHeaderValue;
+    readonly int128: (value: Uint8Array) => IggyHeaderValue;
+    readonly uint8: (value: number) => IggyHeaderValue;
+    readonly uint16: (value: number) => IggyHeaderValue;
+    readonly uint32: (value: number) => IggyHeaderValue;
+    readonly uint64: (value: bigint) => IggyHeaderValue;
+    readonly uint128: (value: Uint8Array) => IggyHeaderValue;
+    readonly float: (value: number) => IggyHeaderValue;
+    readonly double: (value: number) => IggyHeaderValue;
+};
+//# sourceMappingURL=header-value.d.ts.map

package/dist/stream/header-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-value.d.ts","sourceRoot":"","sources":["../../src/stream/header-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AA2B7D,eAAO,MAAM,WAAW;aACtB,MAAM,UAAU,MAAM,KAAG,eAAe;aACxC,IAAI,UAAU,OAAO,KAAG,eAAe;aACvC,IAAI,UAAU,MAAM,KAAG,eAAe;aAItC,KAAK,UAAU,MAAM,KAAG,eAAe;aAIvC,KAAK,UAAU,MAAM,KAAG,eAAe;aAIvC,KAAK,UAAU,MAAM,KAAG,eAAe;aAIvC,MAAM,UAAU,UAAU,KAAG,eAAe;aAI5C,KAAK,UAAU,MAAM,KAAG,eAAe;aAIvC,MAAM,UAAU,MAAM,KAAG,eAAe;aAIxC,MAAM,UAAU,MAAM,KAAG,eAAe;aAIxC,MAAM,UAAU,MAAM,KAAG,eAAe;aAIxC,OAAO,UAAU,UAAU,KAAG,eAAe;aAI7C,KAAK,UAAU,MAAM,KAAG,eAAe;aACvC,MAAM,UAAU,MAAM,KAAG,eAAe;CAChC,CAAA"}

package/dist/stream/header-value.js

@@ -0,0 +1,70 @@
+import { InvalidError } from "../client/errors.js";
+function integer(name, value, minimum, maximum) {
+    if (!Number.isSafeInteger(value) || value < minimum || value > maximum) {
+        throw new InvalidError(`${name} header value is outside ${String(minimum)}..${String(maximum)}`);
+    }
+    return value;
+}
+function bigint(name, value, minimum, maximum) {
+    if (value < minimum || value > maximum) {
+        throw new InvalidError(`${name} header value is outside its integer range`);
+    }
+    return value;
+}
+function integer128(name, value) {
+    if (value.byteLength !== 16)
+        throw new InvalidError(`${name} header value must be 16 bytes`);
+    return value.slice();
+}
+function floating(name, value) {
+    if (!Number.isFinite(value))
+        throw new InvalidError(`${name} header value must be finite`);
+    return value;
+}
+export const HeaderValue = {
+    string: (value) => ({ kind: "string", value }),
+    bool: (value) => ({ kind: "bool", value }),
+    int8: (value) => ({
+        kind: "int8",
+        value: integer("int8", value, -128, 127)
+    }),
+    int16: (value) => ({
+        kind: "int16",
+        value: integer("int16", value, -32_768, 32_767)
+    }),
+    int32: (value) => ({
+        kind: "int32",
+        value: integer("int32", value, -2_147_483_648, 2_147_483_647)
+    }),
+    int64: (value) => ({
+        kind: "int64",
+        value: bigint("int64", value, -(1n << 63n), (1n << 63n) - 1n)
+    }),
+    int128: (value) => ({
+        kind: "int128",
+        value: integer128("int128", value)
+    }),
+    uint8: (value) => ({
+        kind: "uint8",
+        value: integer("uint8", value, 0, 255)
+    }),
+    uint16: (value) => ({
+        kind: "uint16",
+        value: integer("uint16", value, 0, 65_535)
+    }),
+    uint32: (value) => ({
+        kind: "uint32",
+        value: integer("uint32", value, 0, 4_294_967_295)
+    }),
+    uint64: (value) => ({
+        kind: "uint64",
+        value: bigint("uint64", value, 0n, (1n << 64n) - 1n)
+    }),
+    uint128: (value) => ({
+        kind: "uint128",
+        value: integer128("uint128", value)
+    }),
+    float: (value) => ({ kind: "float", value: floating("float", value) }),
+    double: (value) => ({ kind: "double", value: floating("double", value) })
+};
+//# sourceMappingURL=header-value.js.map

package/dist/stream/header-value.js.map

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

package/dist/stream/polling-strategy.d.ts

@@ -0,0 +1,14 @@
+export type PollingStrategy = {
+    readonly kind: "first";
+} | {
+    readonly kind: "last";
+} | {
+    readonly kind: "next";
+} | {
+    readonly kind: "offset";
+    readonly value: bigint;
+} | {
+    readonly kind: "timestamp";
+    readonly value: bigint;
+};
+//# sourceMappingURL=polling-strategy.d.ts.map

package/dist/stream/polling-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling-strategy.d.ts","sourceRoot":"","sources":["../../src/stream/polling-strategy.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA"}

package/dist/stream/polling-strategy.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=polling-strategy.js.map

package/dist/stream/polling-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling-strategy.js","sourceRoot":"","sources":["../../src/stream/polling-strategy.ts"],"names":[],"mappings":""}

package/dist/stream/producer.d.ts

@@ -0,0 +1,44 @@
+import { type BytesLike } from "../client/bytes.js";
+import type { IggyHeaderValue, LaserTransport } from "../iggy/apache-iggy.js";
+import type { Routing } from "./routing.js";
+export interface ProducerOptions {
+    readonly routing?: Routing;
+    readonly retries?: number;
+    readonly retryIntervalMs?: number;
+}
+export interface ProducerSendOptions {
+    readonly key?: Uint8Array;
+    readonly partition?: number;
+    readonly headers?: ReadonlyMap<string, IggyHeaderValue> | Readonly<Record<string, IggyHeaderValue>>;
+}
+export interface ProducerMessage {
+    readonly payload: BytesLike;
+    readonly headers?: ReadonlyMap<string, IggyHeaderValue> | Readonly<Record<string, IggyHeaderValue>>;
+}
+/** Publishes directly with bounded retries and explicit routing. */
+export declare class Producer implements AsyncDisposable {
+    private readonly transport;
+    private readonly streamName;
+    private readonly topicName;
+    private readonly routing;
+    private readonly retries;
+    private readonly retryIntervalMs;
+    private closed;
+    constructor(transport: LaserTransport, streamName: string, topicName: string, options?: ProducerOptions);
+    send(payload: BytesLike, options?: ProducerSendOptions): Promise<void>;
+    sendMessage(message: ProducerMessage, routing?: Routing): Promise<void>;
+    sendWithRouting(message: ProducerMessage, routing: Routing): Promise<void>;
+    sendKeyed(message: ProducerMessage, key: BytesLike): Promise<void>;
+    sendToPartition(message: ProducerMessage, partition: number): Promise<void>;
+    sendBatch(messages: readonly (BytesLike | ProducerMessage)[], options?: ProducerSendOptions): Promise<number>;
+    sendBatchWithRouting(messages: readonly ProducerMessage[], routing?: Routing): Promise<number>;
+    private sendLoweredBatch;
+    flush(): Promise<void>;
+    /** Rejects future sends. Safe to call more than once. */
+    shutdown(): Promise<void>;
+    /** Delegates async disposal to `shutdown()`. */
+    [Symbol.asyncDispose](): Promise<void>;
+    private throwIfClosed;
+    private sendWithRetry;
+}
+//# sourceMappingURL=producer.d.ts.map

package/dist/stream/producer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"producer.d.ts","sourceRoot":"","sources":["../../src/stream/producer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,oBAAoB,CAAA;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAsB,MAAM,wBAAwB,CAAA;AACjG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EACf,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;CACnF;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EACf,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;CACnF;AA2BD,oEAAoE;AACpE,qBAAa,QAAS,YAAW,eAAe;IAO5C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAR5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,MAAM,CAAQ;IAEtB,YACmB,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAClC,OAAO,GAAE,eAAoB,EAiB9B;IAEK,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/E;IAEK,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,GAAE,OAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1F;IAEK,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/E;IAEK,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;IAEK,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhF;IAEK,SAAS,CACb,QAAQ,EAAE,SAAS,CAAC,SAAS,GAAG,eAAe,CAAC,EAAE,EAClD,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAOjB;IAEK,oBAAoB,CACxB,QAAQ,EAAE,SAAS,eAAe,EAAE,EACpC,OAAO,GAAE,OAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAEjB;YAEa,gBAAgB;IAU9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAIrB;IAED,yDAAyD;IACzD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAGxB;IAED,gDAAgD;IAChD,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAErC;IAED,OAAO,CAAC,aAAa;YAIP,aAAa;CAwB5B"}

package/dist/stream/producer.js

@@ -0,0 +1,125 @@
+import { ownedBytes } from "../client/bytes.js";
+import { InvalidError, TransportError } from "../client/errors.js";
+const DEFAULT_RETRIES = 3;
+const DEFAULT_RETRY_INTERVAL_MS = 1_000;
+function headersMap(headers) {
+    if (headers === undefined)
+        return new Map();
+    return headers instanceof Map ? new Map(headers) : new Map(Object.entries(headers));
+}
+function optionRouting(options, fallback) {
+    if (options.key !== undefined && options.partition !== undefined) {
+        throw new InvalidError("send() accepts a routing key or an explicit partition, not both");
+    }
+    if (options.partition !== undefined)
+        return { kind: "partition", partition: options.partition };
+    if (options.key !== undefined)
+        return { kind: "key", key: options.key.slice() };
+    return fallback;
+}
+function lowerMessage(message) {
+    return { payload: ownedBytes(message.payload), headers: headersMap(message.headers) };
+}
+function isProducerMessage(value) {
+    return "payload" in value;
+}
+/** Publishes directly with bounded retries and explicit routing. */
+export class Producer {
+    transport;
+    streamName;
+    topicName;
+    routing;
+    retries;
+    retryIntervalMs;
+    closed = false;
+    constructor(transport, streamName, topicName, options = {}) {
+        this.transport = transport;
+        this.streamName = streamName;
+        this.topicName = topicName;
+        this.routing =
+            options.routing?.kind === "key"
+                ? { kind: "key", key: options.routing.key.slice() }
+                : (options.routing ?? { kind: "balanced" });
+        this.retries = options.retries ?? DEFAULT_RETRIES;
+        this.retryIntervalMs = options.retryIntervalMs ?? DEFAULT_RETRY_INTERVAL_MS;
+        if (!Number.isSafeInteger(this.retries) || this.retries < 0) {
+            throw new InvalidError("producer retries must be a non-negative safe integer");
+        }
+        if (!Number.isFinite(this.retryIntervalMs) || this.retryIntervalMs < 0) {
+            throw new InvalidError("producer retryIntervalMs must be a non-negative finite number");
+        }
+        if (this.routing.kind === "partition" && this.routing.partition < 0) {
+            throw new InvalidError("producer partition must be non-negative");
+        }
+    }
+    async send(payload, options = {}) {
+        await this.sendMessage({ payload, ...(options.headers !== undefined ? { headers: options.headers } : {}) }, optionRouting(options, this.routing));
+    }
+    async sendMessage(message, routing = this.routing) {
+        this.throwIfClosed("sendMessage");
+        await this.sendWithRetry([lowerMessage(message)], routing);
+    }
+    async sendWithRouting(message, routing) {
+        await this.sendMessage(message, routing);
+    }
+    async sendKeyed(message, key) {
+        await this.sendMessage(message, { kind: "key", key: ownedBytes(key) });
+    }
+    async sendToPartition(message, partition) {
+        if (!Number.isSafeInteger(partition) || partition < 0) {
+            throw new InvalidError("partition must be a non-negative safe integer");
+        }
+        await this.sendMessage(message, { kind: "partition", partition });
+    }
+    async sendBatch(messages, options = {}) {
+        const lowered = messages.map((message) => isProducerMessage(message)
+            ? lowerMessage(message)
+            : { payload: ownedBytes(message), headers: headersMap(options.headers) });
+        return this.sendLoweredBatch(lowered, optionRouting(options, this.routing));
+    }
+    async sendBatchWithRouting(messages, routing = this.routing) {
+        return this.sendLoweredBatch(messages.map(lowerMessage), routing);
+    }
+    async sendLoweredBatch(messages, routing) {
+        this.throwIfClosed("sendBatch");
+        if (messages.length === 0)
+            return 0;
+        await this.sendWithRetry(messages, routing);
+        return messages.length;
+    }
+    flush() {
+        return this.closed
+            ? Promise.reject(new InvalidError("flush() called after shutdown()"))
+            : Promise.resolve();
+    }
+    /** Rejects future sends. Safe to call more than once. */
+    shutdown() {
+        this.closed = true;
+        return Promise.resolve();
+    }
+    /** Delegates async disposal to `shutdown()`. */
+    [Symbol.asyncDispose]() {
+        return this.shutdown();
+    }
+    throwIfClosed(operation) {
+        if (this.closed)
+            throw new InvalidError(`${operation}() called after shutdown()`);
+    }
+    async sendWithRetry(messages, routing) {
+        for (let attempt = 0;; attempt += 1) {
+            try {
+                await this.transport.sendMessagesWithHeaders(this.streamName, this.topicName, messages, routing.kind === "key" ? routing.key : undefined, routing.kind === "partition" ? routing.partition : undefined);
+                return;
+            }
+            catch (error) {
+                if (!(error instanceof TransportError) || !error.retryable || attempt >= this.retries) {
+                    throw error;
+                }
+                if (this.retryIntervalMs > 0) {
+                    await new Promise((resolve) => setTimeout(resolve, this.retryIntervalMs));
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=producer.js.map