harnery 0.34.1 → 0.36.0

package/dist/core/storage/buffer.d.ts

@@ -0,0 +1,28 @@
+export interface BufferedLogItem<T> {
+    value: T;
+    bytes: number;
+    high_priority: boolean;
+}
+export interface BoundedLogBufferOptions<T> {
+    max_bytes: number;
+    max_records: number;
+    high_severity_reserve_bytes: number;
+    flush_interval_ms: number;
+    minimum_high_priority_drain_interval_ms?: number;
+    drain(items: readonly BufferedLogItem<T>[]): Promise<void>;
+    on_drop?(reason: "normal_capacity" | "total_capacity" | "closed", item: T): void;
+    on_drain_error?(error: unknown): void;
+}
+export declare class BoundedLogBuffer<T> {
+    #private;
+    constructor(options: BoundedLogBufferOptions<T>);
+    get size(): {
+        records: number;
+        bytes: number;
+        capacity_bytes: number;
+    };
+    enqueue(item: BufferedLogItem<T>): boolean;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=buffer.d.ts.map

package/dist/core/storage/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../../src/core/storage/buffer.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B,EAAE,MAAM,CAAC;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uCAAuC,CAAC,EAAE,MAAM,CAAC;IACjD,KAAK,CAAC,KAAK,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,CAAC,MAAM,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACjF,cAAc,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACvC;AAED,qBAAa,gBAAgB,CAAC,CAAC;;gBASjB,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAe/C,IAAI,IAAI,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAMrE;IAED,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO;IAqBpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA4C7B"}

package/dist/core/storage/buffer.js

@@ -0,0 +1,101 @@
+export class BoundedLogBuffer {
+    #options;
+    #items = [];
+    #bytes = 0;
+    #closed = false;
+    #timer;
+    #draining = Promise.resolve();
+    #lastHighPriorityDrain = 0;
+    constructor(options) {
+        if (!Number.isSafeInteger(options.max_bytes) ||
+            options.max_bytes <= 0 ||
+            !Number.isSafeInteger(options.max_records) ||
+            options.max_records <= 0 ||
+            options.high_severity_reserve_bytes < 0 ||
+            options.high_severity_reserve_bytes >= options.max_bytes ||
+            options.flush_interval_ms <= 0) {
+            throw new Error("invalid bounded log buffer policy");
+        }
+        this.#options = options;
+    }
+    get size() {
+        return {
+            records: this.#items.length,
+            bytes: this.#bytes,
+            capacity_bytes: this.#options.max_bytes,
+        };
+    }
+    enqueue(item) {
+        if (this.#closed)
+            return this.#drop("closed", item.value);
+        if (!Number.isSafeInteger(item.bytes) || item.bytes <= 0) {
+            throw new Error("buffer item bytes must be a positive safe integer");
+        }
+        const byteLimit = item.high_priority
+            ? this.#options.max_bytes
+            : this.#options.max_bytes - this.#options.high_severity_reserve_bytes;
+        if (this.#items.length >= this.#options.max_records) {
+            return this.#drop(item.high_priority ? "total_capacity" : "normal_capacity", item.value);
+        }
+        if (this.#bytes + item.bytes > byteLimit) {
+            return this.#drop(item.high_priority ? "total_capacity" : "normal_capacity", item.value);
+        }
+        this.#items.push(item);
+        this.#bytes += item.bytes;
+        this.#scheduleTimer();
+        if (item.high_priority)
+            this.#scheduleHighPriorityDrain();
+        return true;
+    }
+    async flush() {
+        this.#cancelTimer();
+        const batch = this.#take();
+        if (batch.length > 0) {
+            this.#draining = this.#draining.then(() => this.#options.drain(batch));
+        }
+        await this.#draining;
+    }
+    async close() {
+        if (this.#closed)
+            return this.#draining;
+        this.#closed = true;
+        await this.flush();
+    }
+    #take() {
+        const batch = this.#items;
+        this.#items = [];
+        this.#bytes = 0;
+        return batch;
+    }
+    #scheduleTimer() {
+        if (this.#timer)
+            return;
+        this.#timer = setTimeout(() => {
+            this.#timer = undefined;
+            void this.flush().catch((error) => this.#options.on_drain_error?.(error));
+        }, this.#options.flush_interval_ms);
+        this.#timer.unref?.();
+    }
+    #scheduleHighPriorityDrain() {
+        const minimum = this.#options.minimum_high_priority_drain_interval_ms ?? 25;
+        const now = Date.now();
+        const delay = Math.max(0, minimum - (now - this.#lastHighPriorityDrain));
+        if (this.#timer)
+            clearTimeout(this.#timer);
+        this.#timer = setTimeout(() => {
+            this.#timer = undefined;
+            this.#lastHighPriorityDrain = Date.now();
+            void this.flush().catch((error) => this.#options.on_drain_error?.(error));
+        }, delay);
+        this.#timer.unref?.();
+    }
+    #cancelTimer() {
+        if (this.#timer)
+            clearTimeout(this.#timer);
+        this.#timer = undefined;
+    }
+    #drop(reason, item) {
+        this.#options.on_drop?.(reason, item);
+        return false;
+    }
+}

package/dist/core/storage/builtins.d.ts

@@ -0,0 +1,3 @@
+import type { HarneryStorageFamily } from "./contract.js";
+export declare function harneryStorageFamilies(): readonly HarneryStorageFamily[];
+//# sourceMappingURL=builtins.d.ts.map

package/dist/core/storage/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../../src/core/storage/builtins.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIV,oBAAoB,EAKrB,MAAM,eAAe,CAAC;AAwDvB,wBAAgB,sBAAsB,IAAI,SAAS,oBAAoB,EAAE,CAUxE"}