@nitrostack/core 1.0.17 → 1.1.0-beta.0

package/dist/core/interceptors/spillover/fs-spillover.store.js

@@ -0,0 +1,302 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+/** Grace period before a leftover temp file is treated as abandoned. */
+const ORPHAN_TEMP_FILE_MAX_AGE_MS = 5 * 60 * 1000;
+/**
+ * Filesystem spillover store.
+ *
+ * Directory mode 0o700 and file mode 0o600 are enforced on Unix. Windows ignores
+ * those bits, so a shared temp directory is not private there; set `storageDir`
+ * to a directory only this process can read.
+ */
+export class FsSpilloverStore {
+    storageDir;
+    explicitDir;
+    maxSizeBytes;
+    sweepTimer;
+    initialized = false;
+    usageReady = false;
+    currentSizeBytes = 0;
+    /** Serializes saves so two writers cannot both pass the capacity check. */
+    writeChain = Promise.resolve();
+    constructor(options = {}) {
+        this.explicitDir = options.storageDir !== undefined;
+        // A fixed name under os.tmpdir() can be planted as a symlink before startup.
+        // The default path is created with mkdtemp on first write.
+        this.storageDir = options.storageDir ?? '';
+        this.maxSizeBytes = options.maxSizeBytes ?? 512 * 1024 * 1024;
+        const sweepIntervalMs = (options.sweepIntervalSeconds ?? 120) * 1000;
+        this.sweepTimer = setInterval(() => {
+            void this.cleanup().catch(() => { });
+        }, sweepIntervalMs);
+        if (typeof this.sweepTimer.unref === 'function') {
+            this.sweepTimer.unref();
+        }
+    }
+    async ensureDir() {
+        if (this.initialized)
+            return;
+        if (!this.explicitDir) {
+            this.storageDir = await fs.mkdtemp(path.join(os.tmpdir(), 'nitrostack-spillover-'));
+            this.initialized = true;
+            return;
+        }
+        await this.assertRealDirectory(this.storageDir);
+        this.initialized = true;
+    }
+    /**
+     * Refuse a symlink. mkdir({ recursive: true }) follows one, and chmod follows
+     * it too, so a planted link would receive the spilled files.
+     */
+    async assertRealDirectory(dir) {
+        let stat;
+        try {
+            stat = await fs.lstat(dir);
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== 'ENOENT')
+                throw err;
+            await fs.mkdir(dir, { recursive: true, mode: 0o700 });
+            stat = await fs.lstat(dir);
+        }
+        if (stat.isSymbolicLink()) {
+            throw new Error(`Spillover directory ${dir} is a symlink. Refusing to write tool output.`);
+        }
+        if (!stat.isDirectory()) {
+            throw new Error(`Spillover directory ${dir} is not a directory.`);
+        }
+        try {
+            await fs.chmod(dir, 0o700);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new Error(`Spillover directory ${dir} is not private (${message}). Refusing to write tool output.`);
+        }
+    }
+    sanitizeId(id) {
+        // Defend against directory traversal attacks (e.g. ../../)
+        const sanitized = id.replace(/[^a-zA-Z0-9_-]/g, '_');
+        return sanitized.length > 0 ? sanitized : 'spillover_id';
+    }
+    getFilePath(id) {
+        return path.join(this.storageDir, `${this.sanitizeId(id)}.json`);
+    }
+    getStorageDir() {
+        return this.storageDir;
+    }
+    getMaxSizeBytes() {
+        return this.maxSizeBytes;
+    }
+    getCurrentSizeBytes() {
+        return this.currentSizeBytes;
+    }
+    enqueue(fn) {
+        const run = this.writeChain.then(fn);
+        this.writeChain = run.then(() => undefined, () => undefined);
+        return run;
+    }
+    async save(id, data, mimeType, ttlSeconds, sessionId) {
+        return this.enqueue(() => this.writeRecord(id, data, mimeType, ttlSeconds, sessionId));
+    }
+    async writeRecord(id, data, mimeType, ttlSeconds, sessionId) {
+        await this.ensureDir();
+        await this.ensureUsage();
+        const sizeBytes = Buffer.byteLength(data, 'utf8');
+        if (sizeBytes > this.maxSizeBytes) {
+            throw new Error(`Spillover payload of ${sizeBytes} bytes exceeds the store limit of ${this.maxSizeBytes} bytes.`);
+        }
+        const filePath = this.getFilePath(id);
+        const existingBytes = await this.fileSize(filePath);
+        if (existingBytes > 0)
+            this.currentSizeBytes -= existingBytes;
+        try {
+            while (this.currentSizeBytes + sizeBytes > this.maxSizeBytes) {
+                const evicted = await this.evictOldestFile(filePath);
+                if (!evicted)
+                    break;
+            }
+            if (this.currentSizeBytes + sizeBytes > this.maxSizeBytes) {
+                throw new Error(`Spillover store is at capacity (${this.maxSizeBytes} bytes). ` +
+                    `Raise maxSizeBytes or remove expired payloads.`);
+            }
+        }
+        catch (err) {
+            this.currentSizeBytes += existingBytes;
+            throw err;
+        }
+        const now = Date.now();
+        const record = {
+            // expiresAt is first so cleanup can read it from the file prefix
+            // without loading the spilled payload.
+            expiresAt: now + ttlSeconds * 1000,
+            id,
+            mimeType,
+            sizeBytes,
+            createdAt: now,
+            sessionId,
+            data,
+        };
+        const tempPath = `${filePath}.tmp.${Date.now()}.${Math.random().toString(36).slice(2)}`;
+        try {
+            await fs.writeFile(tempPath, JSON.stringify(record), { encoding: 'utf8', mode: 0o600 });
+            await fs.rename(tempPath, filePath);
+        }
+        catch (err) {
+            this.currentSizeBytes += existingBytes;
+            await fs.unlink(tempPath).catch(() => undefined);
+            throw err;
+        }
+        this.currentSizeBytes += await this.fileSize(filePath);
+        return record;
+    }
+    async get(id) {
+        await this.ensureDir();
+        const filePath = this.getFilePath(id);
+        try {
+            const content = await fs.readFile(filePath, 'utf8');
+            const record = JSON.parse(content);
+            if (Date.now() > record.expiresAt) {
+                await this.enqueue(() => this.deleteIfStillExpired(id));
+                return undefined;
+            }
+            return record;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async delete(id) {
+        return this.enqueue(() => this.unlinkId(id));
+    }
+    async unlinkId(id) {
+        const filePath = this.getFilePath(id);
+        const size = await this.fileSize(filePath);
+        try {
+            await fs.unlink(filePath);
+            if (this.usageReady)
+                this.currentSizeBytes = Math.max(0, this.currentSizeBytes - size);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async deleteIfStillExpired(id) {
+        const filePath = this.getFilePath(id);
+        const expiresAt = await this.readExpiresAt(filePath);
+        if (expiresAt !== undefined && Date.now() <= expiresAt)
+            return;
+        await this.unlinkId(id);
+    }
+    async cleanup() {
+        return this.enqueue(() => this.cleanupNow());
+    }
+    async cleanupNow() {
+        await this.ensureDir();
+        let pruned = 0;
+        const now = Date.now();
+        try {
+            const files = await fs.readdir(this.storageDir);
+            for (const file of files) {
+                const filePath = path.join(this.storageDir, file);
+                // Sweep leftovers from writes interrupted between writeFile and rename;
+                // these never carry the plain `.json` suffix and would otherwise accumulate.
+                if (file.includes('.json.tmp.')) {
+                    const stat = await fs.stat(filePath).catch(() => undefined);
+                    if (stat && now - stat.mtimeMs > ORPHAN_TEMP_FILE_MAX_AGE_MS) {
+                        await fs.unlink(filePath).catch(() => { });
+                        if (this.usageReady)
+                            this.currentSizeBytes = Math.max(0, this.currentSizeBytes - stat.size);
+                        pruned++;
+                    }
+                    continue;
+                }
+                if (!file.endsWith('.json'))
+                    continue;
+                try {
+                    const expiresAt = await this.readExpiresAt(filePath);
+                    if (expiresAt === undefined || now > expiresAt) {
+                        const size = await this.fileSize(filePath);
+                        await fs.unlink(filePath);
+                        if (this.usageReady)
+                            this.currentSizeBytes = Math.max(0, this.currentSizeBytes - size);
+                        pruned++;
+                    }
+                }
+                catch {
+                    // Bad/partial file, remove
+                    const size = await this.fileSize(filePath);
+                    await fs.unlink(filePath).catch(() => { });
+                    if (this.usageReady)
+                        this.currentSizeBytes = Math.max(0, this.currentSizeBytes - size);
+                }
+            }
+        }
+        catch {
+            /* ignore read errors during cleanup */
+        }
+        return pruned;
+    }
+    async ensureUsage() {
+        if (this.usageReady)
+            return;
+        let total = 0;
+        const files = await fs.readdir(this.storageDir).catch(() => []);
+        for (const file of files) {
+            if (!file.endsWith('.json') || file.includes('.json.tmp.'))
+                continue;
+            total += await this.fileSize(path.join(this.storageDir, file));
+        }
+        this.currentSizeBytes = total;
+        this.usageReady = true;
+    }
+    async fileSize(filePath) {
+        const stat = await fs.stat(filePath).catch(() => undefined);
+        return stat?.size ?? 0;
+    }
+    /** Deletes the oldest payload file, excluding the path about to be replaced. */
+    async evictOldestFile(skipPath) {
+        const files = await fs.readdir(this.storageDir).catch(() => []);
+        let oldest;
+        for (const file of files) {
+            if (!file.endsWith('.json') || file.includes('.json.tmp.'))
+                continue;
+            const filePath = path.join(this.storageDir, file);
+            if (skipPath && filePath === skipPath)
+                continue;
+            const stat = await fs.stat(filePath).catch(() => undefined);
+            if (!stat)
+                continue;
+            if (!oldest || stat.mtimeMs < oldest.mtimeMs) {
+                oldest = { filePath, mtimeMs: stat.mtimeMs, size: stat.size };
+            }
+        }
+        if (!oldest)
+            return false;
+        await fs.unlink(oldest.filePath).catch(() => undefined);
+        this.currentSizeBytes = Math.max(0, this.currentSizeBytes - oldest.size);
+        return true;
+    }
+    /** First bytes of a record. `expiresAt` is written before the payload. */
+    async readExpiresAt(filePath) {
+        const fh = await fs.open(filePath, 'r');
+        try {
+            const buf = Buffer.alloc(96);
+            const { bytesRead } = await fh.read(buf, 0, buf.length, 0);
+            const head = buf.subarray(0, bytesRead).toString('utf8');
+            const match = head.match(/"expiresAt"\s*:\s*(\d+)/);
+            if (!match?.[1])
+                return undefined;
+            return Number(match[1]);
+        }
+        finally {
+            await fh.close();
+        }
+    }
+    async dispose() {
+        clearInterval(this.sweepTimer);
+    }
+}
+//# sourceMappingURL=fs-spillover.store.js.map

package/dist/core/interceptors/spillover/fs-spillover.store.js.map

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

package/dist/core/interceptors/spillover/index.d.ts

@@ -0,0 +1,6 @@
+export * from './spillover-store.interface.js';
+export * from './memory-spillover.store.js';
+export * from './fs-spillover.store.js';
+export * from './types.js';
+export * from './preview-generator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/interceptors/spillover/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/interceptors/spillover/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC"}

package/dist/core/interceptors/spillover/index.js

@@ -0,0 +1,6 @@
+export * from './spillover-store.interface.js';
+export * from './memory-spillover.store.js';
+export * from './fs-spillover.store.js';
+export * from './types.js';
+export * from './preview-generator.js';
+//# sourceMappingURL=index.js.map

package/dist/core/interceptors/spillover/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/interceptors/spillover/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC"}

package/dist/core/interceptors/spillover/memory-spillover.store.d.ts

@@ -0,0 +1,25 @@
+import { SpilloverRecord, SpilloverStore } from './spillover-store.interface.js';
+export interface MemorySpilloverOptions {
+    maxSizeBytes?: number;
+    sweepIntervalSeconds?: number;
+}
+export declare class MemorySpilloverStore implements SpilloverStore {
+    private readonly records;
+    private currentSizeBytes;
+    private readonly maxSizeBytes;
+    private readonly sweepTimer;
+    /** Serializes saves so two writers cannot both pass the capacity check. */
+    private writeChain;
+    constructor(options?: MemorySpilloverOptions);
+    save(id: string, data: string, mimeType: string, ttlSeconds: number, sessionId?: string): Promise<SpilloverRecord>;
+    private writeRecord;
+    get(id: string): Promise<SpilloverRecord | undefined>;
+    delete(id: string): Promise<boolean>;
+    cleanup(): Promise<number>;
+    private evictOldest;
+    getMaxSizeBytes(): number;
+    getCurrentSizeBytes(): number;
+    getRecordCount(): number;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=memory-spillover.store.d.ts.map

package/dist/core/interceptors/spillover/memory-spillover.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-spillover.store.d.ts","sourceRoot":"","sources":["../../../../src/core/interceptors/spillover/memory-spillover.store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEjF,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,2EAA2E;IAC3E,OAAO,CAAC,UAAU,CAAoC;gBAE1C,OAAO,GAAE,sBAA2B;IAa1C,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;YAS1G,WAAW;IAiDnB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAerD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQpC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAahC,OAAO,CAAC,WAAW;IAWnB,eAAe,IAAI,MAAM;IAIzB,mBAAmB,IAAI,MAAM;IAI7B,cAAc,IAAI,MAAM;IAIlB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}

package/dist/core/interceptors/spillover/memory-spillover.store.js

@@ -0,0 +1,115 @@
+export class MemorySpilloverStore {
+    records = new Map();
+    currentSizeBytes = 0;
+    maxSizeBytes;
+    sweepTimer;
+    /** Serializes saves so two writers cannot both pass the capacity check. */
+    writeChain = Promise.resolve();
+    constructor(options = {}) {
+        this.maxSizeBytes = options.maxSizeBytes ?? 100 * 1024 * 1024;
+        const sweepIntervalMs = (options.sweepIntervalSeconds ?? 60) * 1000;
+        this.sweepTimer = setInterval(() => {
+            this.cleanup().catch(() => { });
+        }, sweepIntervalMs);
+        if (typeof this.sweepTimer.unref === 'function') {
+            this.sweepTimer.unref();
+        }
+    }
+    async save(id, data, mimeType, ttlSeconds, sessionId) {
+        const run = this.writeChain.then(() => this.writeRecord(id, data, mimeType, ttlSeconds, sessionId));
+        this.writeChain = run.then(() => undefined, () => undefined);
+        return run;
+    }
+    async writeRecord(id, data, mimeType, ttlSeconds, sessionId) {
+        // Yield so a second save started in the same turn waits on writeChain
+        // instead of reading currentSizeBytes before this insert lands.
+        await Promise.resolve();
+        const sizeBytes = Buffer.byteLength(data, 'utf8');
+        const now = Date.now();
+        // Reject before evicting: a record larger than the cap would otherwise clear the
+        // entire store and still be admitted, leaving usage above the configured limit.
+        if (sizeBytes > this.maxSizeBytes) {
+            throw new Error(`Spillover payload of ${sizeBytes} bytes exceeds the store limit of ${this.maxSizeBytes} bytes. ` +
+                `Raise maxSizeBytes or use the filesystem spillover driver.`);
+        }
+        // If updating an existing id, subtract prior size first
+        const existing = this.records.get(id);
+        if (existing) {
+            this.currentSizeBytes -= existing.sizeBytes;
+            this.records.delete(id);
+        }
+        // Evict oldest if adding this record exceeds max memory capacity
+        while (this.currentSizeBytes + sizeBytes > this.maxSizeBytes && this.records.size > 0) {
+            this.evictOldest();
+        }
+        const record = {
+            expiresAt: now + ttlSeconds * 1000,
+            id,
+            mimeType,
+            sizeBytes,
+            createdAt: now,
+            sessionId,
+            data,
+        };
+        this.records.set(id, record);
+        this.currentSizeBytes += sizeBytes;
+        return record;
+    }
+    async get(id) {
+        const record = this.records.get(id);
+        if (!record)
+            return undefined;
+        if (Date.now() > record.expiresAt) {
+            await this.delete(id);
+            return undefined;
+        }
+        // Refresh Map insertion order for LRU
+        this.records.delete(id);
+        this.records.set(id, record);
+        return record;
+    }
+    async delete(id) {
+        const record = this.records.get(id);
+        if (!record)
+            return false;
+        this.currentSizeBytes -= record.sizeBytes;
+        return this.records.delete(id);
+    }
+    async cleanup() {
+        const now = Date.now();
+        let pruned = 0;
+        for (const [id, record] of this.records.entries()) {
+            if (now > record.expiresAt) {
+                this.currentSizeBytes -= record.sizeBytes;
+                this.records.delete(id);
+                pruned++;
+            }
+        }
+        return pruned;
+    }
+    evictOldest() {
+        const oldestKey = this.records.keys().next().value;
+        if (oldestKey !== undefined) {
+            const rec = this.records.get(oldestKey);
+            if (rec) {
+                this.currentSizeBytes -= rec.sizeBytes;
+            }
+            this.records.delete(oldestKey);
+        }
+    }
+    getMaxSizeBytes() {
+        return this.maxSizeBytes;
+    }
+    getCurrentSizeBytes() {
+        return this.currentSizeBytes;
+    }
+    getRecordCount() {
+        return this.records.size;
+    }
+    async dispose() {
+        clearInterval(this.sweepTimer);
+        this.records.clear();
+        this.currentSizeBytes = 0;
+    }
+}
+//# sourceMappingURL=memory-spillover.store.js.map

package/dist/core/interceptors/spillover/memory-spillover.store.js.map

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

package/dist/core/interceptors/spillover/preview-generator.d.ts

@@ -0,0 +1,7 @@
+export interface PreviewResult {
+    preview: unknown;
+    summary: string;
+    totalItems?: number;
+}
+export declare function generatePreview(data: unknown, sizeBytes: number, previewItems?: number, previewChars?: number): PreviewResult;
+//# sourceMappingURL=preview-generator.d.ts.map

package/dist/core/interceptors/spillover/preview-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-generator.d.ts","sourceRoot":"","sources":["../../../../src/core/interceptors/spillover/preview-generator.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAiCD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,MAAM,EACjB,YAAY,SAAI,EAChB,YAAY,SAAM,GACjB,aAAa,CA6Cf"}

package/dist/core/interceptors/spillover/preview-generator.js

@@ -0,0 +1,79 @@
+function capPreviewValue(value, previewChars) {
+    if (value == null || typeof value === 'number' || typeof value === 'boolean') {
+        return value;
+    }
+    if (typeof value === 'string') {
+        return value.length > previewChars ? `${value.slice(0, previewChars)}... [truncated]` : value;
+    }
+    let accounted = 0;
+    try {
+        const encoded = JSON.stringify(value, (_key, val) => {
+            if (typeof val === 'string')
+                accounted += val.length;
+            else if (val !== undefined)
+                accounted += 8;
+            if (accounted > previewChars) {
+                throw new Error('preview-cap');
+            }
+            return val;
+        });
+        if (encoded == null || encoded.length <= previewChars)
+            return value;
+        return `${encoded.slice(0, previewChars)}... [truncated]`;
+    }
+    catch (err) {
+        if (err instanceof Error && err.message === 'preview-cap')
+            return '[truncated]';
+        return '[unserializable]';
+    }
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+export function generatePreview(data, sizeBytes, previewItems = 3, previewChars = 500) {
+    const sizeStr = formatBytes(sizeBytes);
+    // 1. Array payload (most common for database queries)
+    if (Array.isArray(data)) {
+        const totalItems = data.length;
+        const preview = data.slice(0, previewItems).map((item) => capPreviewValue(item, previewChars));
+        return {
+            preview,
+            totalItems,
+            summary: `Query returned ${totalItems.toLocaleString()} items (${sizeStr})`,
+        };
+    }
+    // 2. String payload (CSV, raw text, HTML)
+    if (typeof data === 'string') {
+        const preview = data.length > previewChars
+            ? `${data.slice(0, previewChars)}... [truncated]`
+            : data;
+        return {
+            preview,
+            summary: `Text payload (${sizeStr})`,
+        };
+    }
+    // 3. Plain Object / Dictionary
+    if (data && typeof data === 'object') {
+        const keys = Object.keys(data);
+        const totalItems = keys.length;
+        const preview = {};
+        for (let i = 0; i < Math.min(keys.length, previewItems); i++) {
+            const key = keys[i];
+            preview[key] = capPreviewValue(data[key], previewChars);
+        }
+        return {
+            preview,
+            totalItems,
+            summary: `Object with ${totalItems} top-level fields (${sizeStr})`,
+        };
+    }
+    return {
+        preview: data,
+        summary: `Dataset payload (${sizeStr})`,
+    };
+}
+//# sourceMappingURL=preview-generator.js.map

package/dist/core/interceptors/spillover/preview-generator.js.map

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

package/dist/core/interceptors/spillover/spillover-store.interface.d.ts

@@ -0,0 +1,20 @@
+export interface SpilloverRecord {
+    id: string;
+    data: string;
+    mimeType: string;
+    sizeBytes: number;
+    createdAt: number;
+    expiresAt: number;
+    /** Session that produced the payload. Absent for stateless writes. */
+    sessionId?: string;
+}
+export interface SpilloverStore {
+    save(id: string, data: string, mimeType: string, ttlSeconds: number, sessionId?: string): Promise<SpilloverRecord>;
+    get(id: string): Promise<SpilloverRecord | undefined>;
+    delete(id: string): Promise<boolean>;
+    cleanup(): Promise<number>;
+    dispose(): Promise<void>;
+    /** Byte cap for stored payloads. Absent on custom stores. */
+    getMaxSizeBytes?(): number;
+}
+//# sourceMappingURL=spillover-store.interface.d.ts.map

package/dist/core/interceptors/spillover/spillover-store.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spillover-store.interface.d.ts","sourceRoot":"","sources":["../../../../src/core/interceptors/spillover/spillover-store.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACnH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;IACtD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,6DAA6D;IAC7D,eAAe,CAAC,IAAI,MAAM,CAAC;CAC5B"}

package/dist/core/interceptors/spillover/spillover-store.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=spillover-store.interface.js.map

package/dist/core/interceptors/spillover/spillover-store.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spillover-store.interface.js","sourceRoot":"","sources":["../../../../src/core/interceptors/spillover/spillover-store.interface.ts"],"names":[],"mappings":""}