@jini-ai/sqlite 0.1.2 → 0.5.0

package/dist/db-inspect.d.ts

@@ -1,62 +0,0 @@
-import type Database from 'better-sqlite3';
-type SqliteDb = Database.Database;
-export interface DaemonDbTableInfo {
-    name: string;
-    rowCount: number;
-}
-export interface DaemonDbStatusReport {
-    kind: 'sqlite' | 'postgres';
-    /** Absolute path on disk (sqlite); connection identifier (postgres, e.g. `'host:port/db'`). */
-    location: string;
-    /**
-     * Total bytes the DB file occupies. Sums the primary file plus `-wal`/`-shm`
-     * so the report matches `du -h` rather than just the primary file.
-     */
-    sizeBytes: number;
-    schemaVersion: number | null;
-    tables: DaemonDbTableInfo[];
-    generatedAt: number;
-}
-/**
- * Builds a structured inventory of a `better-sqlite3` database: schema version,
- * per-table row counts (system tables excluded), and total on-disk size
- * (primary file + `-wal` + `-shm`).
- *
- * @param input - The open database handle and its on-disk file path.
- * @returns The status report. Never throws — schema-read and per-table failures
- *   degrade to `null`/`0`/an empty list rather than failing the whole report.
- */
-export declare function inspectSqliteDatabase(input: {
-    db: SqliteDb;
-    file: string;
-}): Promise<DaemonDbStatusReport>;
-export type DbIntegrityIssueKind = 'integrity' | 'foreign_key';
-export interface DbIntegrityIssue {
-    kind: DbIntegrityIssueKind;
-    message: string;
-}
-export interface DbIntegrityReport {
-    ok: boolean;
-    /** `'integrity_check'` (default) or `'quick_check'` — quick is faster but skips the index-content check. */
-    mode: 'integrity_check' | 'quick_check';
-    issues: DbIntegrityIssue[];
-    elapsedMs: number;
-    generatedAt: number;
-}
-export interface VerifyDbOptions {
-    db: SqliteDb;
-    quick?: boolean;
-}
-/**
- * Runs `PRAGMA integrity_check` (or `quick_check`) plus `PRAGMA foreign_key_check`
- * against an open database and returns a structured report so a CLI can
- * pretty-print it and automation can parse the JSON.
- *
- * @param opts - The open database handle and whether to use the faster `quick_check` variant.
- * @returns `{ ok: true }` when both pragmas report clean; otherwise the list of issues found.
- *   A pragma that throws is itself recorded as one `integrity`/`foreign_key` issue rather than
- *   propagating — a caller polling DB health should always get a report, not an exception.
- */
-export declare function verifySqliteIntegrity(opts: VerifyDbOptions): DbIntegrityReport;
-export {};
-//# sourceMappingURL=db-inspect.d.ts.map

package/dist/db-inspect.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"db-inspect.d.ts","sourceRoot":"","sources":["../src/db-inspect.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,KAAK,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;AAElC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,+FAA+F;IAC/F,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA+ChH;AAsBD,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,aAAa,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,4GAA4G;IAC5G,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC;IACxC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,CAkD9E"}

package/dist/db-inspect.js

@@ -1,153 +0,0 @@
-/**
- * @module db-inspect
- *
- * Pure `better-sqlite3` inspection helpers: a structured inventory (file size,
- * table list, per-table row count, `user_version` schema pragma) and an
- * integrity check (`PRAGMA integrity_check`/`quick_check` + `foreign_key_check`).
- * Useful behind a host daemon's own ops CLI (a `db status` subcommand) or a
- * diagnostics aggregator that folds the summary in without re-implementing the
- * SQLite read.
- *
- * Pure relative to its inputs: callers pass the SQLite handle + the on-disk
- * file path. Neither function opens a new connection or mutates state.
- */
-import { promises as fsp } from 'node:fs';
-const SYSTEM_TABLE_PREFIXES = ['sqlite_', 'better_sqlite3_'];
-function isSystemTable(name) {
-    return SYSTEM_TABLE_PREFIXES.some((p) => name.startsWith(p));
-}
-/**
- * Builds a structured inventory of a `better-sqlite3` database: schema version,
- * per-table row counts (system tables excluded), and total on-disk size
- * (primary file + `-wal` + `-shm`).
- *
- * @param input - The open database handle and its on-disk file path.
- * @returns The status report. Never throws — schema-read and per-table failures
- *   degrade to `null`/`0`/an empty list rather than failing the whole report.
- */
-export async function inspectSqliteDatabase(input) {
-    const { db, file } = input;
-    // 1. Schema version (user_version pragma).
-    let schemaVersion = null;
-    try {
-        const v = db.pragma('user_version', { simple: true });
-        schemaVersion = typeof v === 'number' ? v : Number(v);
-        if (!Number.isFinite(schemaVersion))
-            schemaVersion = null;
-    }
-    catch {
-        schemaVersion = null;
-    }
-    // 2. Table list with row counts.
-    const tables = [];
-    try {
-        const names = db.prepare(`SELECT name FROM sqlite_master WHERE type='table' ORDER BY name`).all();
-        for (const { name } of names) {
-            if (isSystemTable(name))
-                continue;
-            try {
-                const safe = sanitizeTableName(name);
-                if (!safe)
-                    continue;
-                const row = db.prepare(`SELECT count(*) AS c FROM "${safe}"`).get();
-                tables.push({ name: safe, rowCount: row?.c ?? 0 });
-            }
-            catch {
-                // A malformed view / corrupted table shouldn't fail the whole report; record 0 rows.
-                tables.push({ name, rowCount: 0 });
-            }
-        }
-    }
-    catch {
-        // ignore — empty tables[] surfaces "cannot read schema" to the caller (a CLI shows 0 tables,
-        // which is itself a useful signal).
-    }
-    // 3. File size = primary + -wal + -shm so the number matches du.
-    const sizeBytes = await sumFileSizes([file, `${file}-wal`, `${file}-shm`]);
-    return {
-        kind: 'sqlite',
-        location: file,
-        sizeBytes,
-        schemaVersion,
-        tables,
-        generatedAt: Date.now(),
-    };
-}
-async function sumFileSizes(paths) {
-    let total = 0;
-    for (const p of paths) {
-        try {
-            const stat = await fsp.stat(p);
-            total += stat.size;
-        }
-        catch {
-            // missing -wal / -shm is normal when the DB hasn't been written since open.
-        }
-    }
-    return total;
-}
-function sanitizeTableName(name) {
-    // Allow ASCII alphanumerics + underscore; SQLite identifier sanity check. Prevents accidental
-    // SQL injection if a malicious migration ever invents a hostile table name.
-    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name))
-        return null;
-    return name;
-}
-/**
- * Runs `PRAGMA integrity_check` (or `quick_check`) plus `PRAGMA foreign_key_check`
- * against an open database and returns a structured report so a CLI can
- * pretty-print it and automation can parse the JSON.
- *
- * @param opts - The open database handle and whether to use the faster `quick_check` variant.
- * @returns `{ ok: true }` when both pragmas report clean; otherwise the list of issues found.
- *   A pragma that throws is itself recorded as one `integrity`/`foreign_key` issue rather than
- *   propagating — a caller polling DB health should always get a report, not an exception.
- */
-export function verifySqliteIntegrity(opts) {
-    const { db, quick = false } = opts;
-    const startedAt = Date.now();
-    const issues = [];
-    // 1. integrity_check / quick_check.
-    const pragma = quick ? 'quick_check' : 'integrity_check';
-    try {
-        const rows = db.pragma(pragma);
-        for (const row of rows) {
-            // SQLite returns the string under either `integrity_check`, `quick_check`, or just the
-            // first column. Normalise to the first string-valued field.
-            const message = (row[pragma] ?? Object.values(row)[0]);
-            if (typeof message !== 'string')
-                continue;
-            if (message.toLowerCase() === 'ok')
-                continue;
-            issues.push({ kind: 'integrity', message });
-        }
-    }
-    catch (err) {
-        issues.push({ kind: 'integrity', message: `pragma ${pragma} threw: ${err.message}` });
-    }
-    // 2. foreign_key_check.
-    try {
-        const rows = db.pragma('foreign_key_check');
-        for (const row of rows) {
-            const tbl = row.table ?? '?';
-            const parent = row.parent ?? '?';
-            const fkid = row.fkid ?? '?';
-            const rowid = row.rowid ?? '?';
-            issues.push({
-                kind: 'foreign_key',
-                message: `FK violation in ${tbl} (rowid=${rowid}) referencing ${parent} (fkid=${fkid})`,
-            });
-        }
-    }
-    catch (err) {
-        issues.push({ kind: 'foreign_key', message: `pragma foreign_key_check threw: ${err.message}` });
-    }
-    return {
-        ok: issues.length === 0,
-        mode: quick ? 'quick_check' : 'integrity_check',
-        issues,
-        elapsedMs: Date.now() - startedAt,
-        generatedAt: Date.now(),
-    };
-}
-//# sourceMappingURL=db-inspect.js.map

package/dist/db-inspect.js.map

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

package/dist/event-log.d.ts

@@ -1,33 +0,0 @@
-import type { EventLog } from '@jini-ai/daemon';
-/**
- * Default per-run retention cap applied when `SqliteEventLogOptions.maxEntriesPerRun` is
- * omitted — see that option's doc for why a durable adapter defaults to a bound instead of
- * mirroring the in-memory reference adapter's unbounded-by-default behavior.
- */
-export declare const DEFAULT_MAX_ENTRIES_PER_RUN = 2000;
-export interface SqliteEventLogOptions {
-    /**
-     * Maximum entries retained per run before the oldest are evicted. Defaults to
-     * {@link DEFAULT_MAX_ENTRIES_PER_RUN} (2000) when omitted — unlike the in-memory reference
-     * adapter (`@jini-ai/daemon`'s `createInMemoryEventLog`), where an omitted cap means unbounded,
-     * a durable on-disk store defaults to a bounded retention window because unbounded persistent
-     * growth is a real, unattended operational risk (disk exhaustion across long-lived runs) in a
-     * way an in-process, GC'd, process-lifetime-bounded structure is not. Pass an explicit value
-     * (larger, smaller, or `0`) to override the default in either direction — the caller then
-     * owns that tradeoff explicitly. Must be a non-negative safe integer; anything else (negative,
-     * fractional, `NaN`, `Infinity`) throws at construction time.
-     */
-    readonly maxEntriesPerRun?: number;
-}
-/** A `@jini-ai/daemon` `EventLog` backed by a `better-sqlite3` database, plus a `close()` to release the file handle. */
-export interface SqliteEventLog extends EventLog {
-    close(): Promise<void>;
-}
-/**
- * Opens (creating if absent) a `better-sqlite3` database at `dbPath` and returns an `EventLog`
- * backed by it. Pass `':memory:'` for a non-durable in-process database (useful in tests that
- * want SQL semantics without a file). Schema creation is idempotent (`CREATE TABLE IF NOT
- * EXISTS`), so re-opening the same file resumes from whatever was durably committed.
- */
-export declare function createSqliteEventLog(dbPath: string, options?: SqliteEventLogOptions): SqliteEventLog;
-//# sourceMappingURL=event-log.d.ts.map

package/dist/event-log.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../src/event-log.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,QAAQ,EAIT,MAAM,iBAAiB,CAAC;AAEzB;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAwBD,yHAAyH;AACzH,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAyBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GAClC,cAAc,CAuKhB"}

package/dist/event-log.js

@@ -1,191 +0,0 @@
-/**
- * `createSqliteEventLog` — the durable `EventLog` adapter (extraction-plan §8 task 8,
- * §2.6: "`@jini-ai/sqlite` is the default adapter... an adapter conformance suite covers
- * transactions/ordering/cursor-durability/cancellation/migrations").
- *
- * Implements `@jini-ai/daemon`'s `EventLog` port exactly (same method signatures, same
- * `dedupeKey` idempotency semantics, same distinguishable `'replay-gap'` result,
- * same never-reused monotonic per-run cursor allocation, same FIFO eviction at
- * `maxEntriesPerRun`) — see `createInMemoryEventLog` in `@jini-ai/daemon` for the
- * reference behavior this mirrors. `better-sqlite3` is synchronous; every public
- * method still returns a `Promise` per extraction-plan §2.6 ("ports are async-only
- * from day one... a real persistent adapter is a drop-in swap"), and every
- * multi-statement operation (`append`'s dedupe-check + insert + eviction) runs
- * inside a `better-sqlite3` transaction for atomicity.
- *
- * Two deliberate divergences from the in-memory reference adapter, both scoped to this durable
- * adapter only: (1) `maxEntriesPerRun` defaults to {@link DEFAULT_MAX_ENTRIES_PER_RUN} (2000)
- * instead of unbounded — see `SqliteEventLogOptions.maxEntriesPerRun`'s doc; (2) `replay`'s
- * `afterCursor` is validated up front and throws for anything other than `null` or a
- * non-negative-safe-integer string, instead of returning a `'invalid-cursor'` result — see
- * `assertValidReplayCursor`.
- */
-import Database from 'better-sqlite3';
-/**
- * Default per-run retention cap applied when `SqliteEventLogOptions.maxEntriesPerRun` is
- * omitted — see that option's doc for why a durable adapter defaults to a bound instead of
- * mirroring the in-memory reference adapter's unbounded-by-default behavior.
- */
-export const DEFAULT_MAX_ENTRIES_PER_RUN = 2000;
-/** @internal Validates and resolves `options.maxEntriesPerRun`, applying the documented default. */
-function resolveMaxEntriesPerRun(value) {
-    if (value === undefined)
-        return DEFAULT_MAX_ENTRIES_PER_RUN;
-    if (!Number.isSafeInteger(value) || value < 0) {
-        throw new Error(`createSqliteEventLog: options.maxEntriesPerRun must be a non-negative safe integer, got ${value}`);
-    }
-    return value;
-}
-/** @internal Validates a `replay(runId, afterCursor)` cursor. `null` ("from the beginning") is always valid. */
-function assertValidReplayCursor(afterCursor) {
-    if (afterCursor === null)
-        return;
-    const n = Number(afterCursor);
-    if (!Number.isSafeInteger(n) || n < 0) {
-        throw new Error(`createSqliteEventLog: invalid replay cursor ${JSON.stringify(afterCursor)} — must be a non-negative safe integer string`);
-    }
-}
-function rowToEntry(row) {
-    return {
-        id: String(row.cursor),
-        event: row.event,
-        data: JSON.parse(row.data),
-        recordedAt: row.recorded_at,
-    };
-}
-/**
- * Opens (creating if absent) a `better-sqlite3` database at `dbPath` and returns an `EventLog`
- * backed by it. Pass `':memory:'` for a non-durable in-process database (useful in tests that
- * want SQL semantics without a file). Schema creation is idempotent (`CREATE TABLE IF NOT
- * EXISTS`), so re-opening the same file resumes from whatever was durably committed.
- */
-export function createSqliteEventLog(dbPath, options = {}) {
-    const maxEntriesPerRun = resolveMaxEntriesPerRun(options.maxEntriesPerRun);
-    const db = new Database(dbPath);
-    db.pragma('journal_mode = WAL');
-    db.exec(`
-    CREATE TABLE IF NOT EXISTS jini_event_log_runs (
-      run_id TEXT PRIMARY KEY,
-      next_cursor INTEGER NOT NULL
-    );
-
-    CREATE TABLE IF NOT EXISTS jini_event_log_entries (
-      run_id TEXT NOT NULL,
-      cursor INTEGER NOT NULL,
-      event TEXT NOT NULL,
-      data TEXT NOT NULL,
-      recorded_at INTEGER NOT NULL,
-      dedupe_key TEXT,
-      PRIMARY KEY (run_id, cursor)
-    );
-
-    CREATE INDEX IF NOT EXISTS idx_jini_event_log_entries_dedupe
-      ON jini_event_log_entries (run_id, dedupe_key)
-      WHERE dedupe_key IS NOT NULL;
-  `);
-    const getRunStmt = db.prepare('SELECT run_id, next_cursor FROM jini_event_log_runs WHERE run_id = ?');
-    const insertRunStmt = db.prepare('INSERT INTO jini_event_log_runs (run_id, next_cursor) VALUES (?, ?)');
-    const updateNextCursorStmt = db.prepare('UPDATE jini_event_log_runs SET next_cursor = ? WHERE run_id = ?');
-    const getByDedupeStmt = db.prepare('SELECT * FROM jini_event_log_entries WHERE run_id = ? AND dedupe_key = ?');
-    const insertEntryStmt = db.prepare('INSERT INTO jini_event_log_entries (run_id, cursor, event, data, recorded_at, dedupe_key) VALUES (?, ?, ?, ?, ?, ?)');
-    const countEntriesStmt = db.prepare('SELECT COUNT(*) AS count FROM jini_event_log_entries WHERE run_id = ?');
-    const evictOldestStmt = db.prepare(`
-    DELETE FROM jini_event_log_entries
-    WHERE run_id = ? AND cursor IN (
-      SELECT cursor FROM jini_event_log_entries WHERE run_id = ? ORDER BY cursor ASC LIMIT ?
-    )
-  `);
-    const selectAllStmt = db.prepare('SELECT * FROM jini_event_log_entries WHERE run_id = ? ORDER BY cursor ASC');
-    const selectAfterStmt = db.prepare('SELECT * FROM jini_event_log_entries WHERE run_id = ? AND cursor > ? ORDER BY cursor ASC');
-    const selectOldestStmt = db.prepare('SELECT * FROM jini_event_log_entries WHERE run_id = ? ORDER BY cursor ASC LIMIT 1');
-    const selectRunIdsStmt = db.prepare('SELECT run_id FROM jini_event_log_runs ORDER BY run_id ASC');
-    const deleteRunEntriesStmt = db.prepare('DELETE FROM jini_event_log_entries WHERE run_id = ?');
-    const deleteRunStmt = db.prepare('DELETE FROM jini_event_log_runs WHERE run_id = ?');
-    // `db.transaction()` does not preserve a wrapped callback's own generic parameter (the
-    // returned `Transaction` type is non-generic), so this runs on `unknown` payloads and the
-    // public `append<Payload>` method below casts at the boundary — the same pattern
-    // `createInMemoryEventLog` uses for its dedupe-hit early return.
-    const appendTxn = db.transaction((input) => {
-        let runRow = getRunStmt.get(input.runId);
-        if (!runRow) {
-            insertRunStmt.run(input.runId, 1);
-            runRow = { run_id: input.runId, next_cursor: 1 };
-        }
-        if (input.dedupeKey !== undefined) {
-            const existing = getByDedupeStmt.get(input.runId, input.dedupeKey);
-            if (existing) {
-                return rowToEntry(existing);
-            }
-        }
-        const cursor = runRow.next_cursor;
-        const recordedAt = Date.now();
-        insertEntryStmt.run(input.runId, cursor, input.event, JSON.stringify(input.data ?? null), recordedAt, input.dedupeKey ?? null);
-        updateNextCursorStmt.run(cursor + 1, input.runId);
-        const { count } = countEntriesStmt.get(input.runId);
-        if (count > maxEntriesPerRun) {
-            evictOldestStmt.run(input.runId, input.runId, count - maxEntriesPerRun);
-        }
-        return {
-            id: String(cursor),
-            event: input.event,
-            data: input.data,
-            recordedAt,
-        };
-    });
-    function replaySync(runId, afterCursor) {
-        // Validated up front, independent of whether `runId` is known: a malformed cursor is a
-        // caller/transport bug regardless of run state, so it throws rather than being folded into
-        // (or masked by) an `'unknown-run'`/`'replay-gap'` result.
-        assertValidReplayCursor(afterCursor);
-        const runRow = getRunStmt.get(runId);
-        if (!runRow) {
-            return { kind: 'unknown-run' };
-        }
-        if (afterCursor === null) {
-            const oldestRow = selectOldestStmt.get(runId);
-            const truncated = oldestRow !== undefined && oldestRow.cursor > 1;
-            return {
-                kind: 'ok',
-                entries: selectAllStmt.all(runId).map(rowToEntry),
-                ...(truncated ? { truncated: true } : {}),
-            };
-        }
-        // Safe: assertValidReplayCursor already proved this parses to a non-negative safe integer.
-        const afterCursorNum = Number(afterCursor);
-        const oldestRow = selectOldestStmt.get(runId);
-        const oldestRetainedId = oldestRow ? oldestRow.cursor : runRow.next_cursor;
-        if (afterCursorNum < oldestRetainedId - 1) {
-            return {
-                kind: 'replay-gap',
-                requestedCursor: afterCursor,
-                oldestAvailableCursor: oldestRow ? String(oldestRow.cursor) : null,
-            };
-        }
-        return {
-            kind: 'ok',
-            entries: selectAfterStmt.all(runId, afterCursorNum).map(rowToEntry),
-        };
-    }
-    const dropTxn = db.transaction((runId) => {
-        deleteRunEntriesStmt.run(runId);
-        deleteRunStmt.run(runId);
-    });
-    return {
-        async append(input) {
-            return appendTxn(input);
-        },
-        async replay(runId, afterCursor) {
-            return replaySync(runId, afterCursor);
-        },
-        async listRunIds() {
-            return selectRunIdsStmt.all().map((row) => row.run_id);
-        },
-        async drop(runId) {
-            dropTxn(runId);
-        },
-        async close() {
-            db.close();
-        },
-    };
-}
-//# sourceMappingURL=event-log.js.map

package/dist/event-log.js.map

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

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}