@jungjaehoon/mama-os 0.53.0 → 0.57.0

package/dist/runtime/timezone.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calendarValueKind = calendarValueKind;
+exports.validateTimeZone = validateTimeZone;
+exports.createTimeZoneSetting = createTimeZoneSetting;
+exports.localDateKey = localDateKey;
+exports.epochAtLocalDateTime = epochAtLocalDateTime;
+exports.epochForCalendarValue = epochForCalendarValue;
+exports.durationEndEpoch = durationEndEpoch;
+function calendarValueKind(value) {
+    if (/^(?:\d{4}-\d{2}-\d{2}|\d{8})$/.test(value))
+        return 'date';
+    if (/^(?:\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?|\d{8}T\d{6})Z$/.test(value))
+        return 'utc';
+    if (/^(?:\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?|\d{8}T\d{6})[+-]\d{2}:?\d{2}$/.test(value))
+        return 'offset';
+    if (/^(?:\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}|\d{8}T\d{6})$/.test(value))
+        return 'floating';
+    throw new Error(`invalid calendar value ${value}`);
+}
+function validateTimeZone(timeZone) {
+    try {
+        new Intl.DateTimeFormat('en', { timeZone });
+    }
+    catch {
+        const error = new Error(`timezone "${timeZone}" is not a valid IANA time zone`);
+        error.name = 'invalid_input';
+        throw error;
+    }
+}
+function createTimeZoneSetting(initial) {
+    validateTimeZone(initial);
+    let current = initial;
+    return {
+        get: () => current,
+        set: (timeZone) => {
+            validateTimeZone(timeZone);
+            current = timeZone;
+        },
+    };
+}
+function partsAt(ms, timeZone) {
+    const parts = new Intl.DateTimeFormat('en-CA', {
+        timeZone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hourCycle: 'h23',
+    }).formatToParts(new Date(ms));
+    return Object.fromEntries(parts.map(({ type, value }) => [type, value]));
+}
+function localDateKey(ms, timeZone) {
+    const parts = partsAt(ms, timeZone);
+    return `${parts.year}-${parts.month}-${parts.day}`;
+}
+function epochAtLocalDateTime(value, timeZone) {
+    const match = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d{1,3}))?$/.exec(value);
+    if (!match)
+        throw new Error(`invalid local date-time ${value}`);
+    const [, y, mo, d, h, mi, s, fraction = '0'] = match;
+    const desired = Date.UTC(Number(y), Number(mo) - 1, Number(d), Number(h), Number(mi), Number(s), Number(fraction.padEnd(3, '0')));
+    let candidate = desired;
+    for (let attempt = 0; attempt < 4; attempt += 1) {
+        const parts = partsAt(candidate, timeZone);
+        const represented = Date.UTC(Number(parts.year), Number(parts.month) - 1, Number(parts.day), Number(parts.hour), Number(parts.minute), Number(parts.second), Number(fraction.padEnd(3, '0')));
+        const next = candidate + desired - represented;
+        if (next === candidate)
+            return candidate;
+        candidate = next;
+    }
+    return candidate;
+}
+function epochForCalendarValue(value, eventTimeZone, ownerTimeZone) {
+    switch (calendarValueKind(value)) {
+        case 'date': {
+            const match = /^(\d{4})-?(\d{2})-?(\d{2})$/.exec(value);
+            return epochAtLocalDateTime(`${match[1]}-${match[2]}-${match[3]}T00:00:00`, eventTimeZone ?? ownerTimeZone);
+        }
+        case 'utc':
+        case 'offset': {
+            const normalized = value
+                .replace(/^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})/, '$1-$2-$3T$4:$5:$6')
+                .replace(/([+-]\d{2})(\d{2})$/, '$1:$2');
+            return Date.parse(normalized);
+        }
+        case 'floating': {
+            const normalized = value.replace(/^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})$/, '$1-$2-$3T$4:$5:$6');
+            return epochAtLocalDateTime(normalized, eventTimeZone ?? ownerTimeZone);
+        }
+    }
+}
+function durationEndEpoch(startValue, duration, zone) {
+    const match = /^P(?:(\d+)W|(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?)?$/.exec(duration);
+    if (!match)
+        return Number.NaN;
+    const startKind = calendarValueKind(startValue);
+    const start = epochForCalendarValue(startValue, undefined, zone);
+    const dayCount = Number(match[1] ?? 0) * 7 + Number(match[2] ?? 0);
+    const timeMs = Number(match[3] ?? 0) * 3_600_000 +
+        Number(match[4] ?? 0) * 60_000 +
+        Number(match[5] ?? 0) * 1_000;
+    if (startKind === 'utc' || startKind === 'offset')
+        return start + dayCount * 86_400_000 + timeMs;
+    if (dayCount === 0)
+        return start + timeMs;
+    const local = /^\d{8}$/.test(startValue)
+        ? `${startValue.slice(0, 4)}-${startValue.slice(4, 6)}-${startValue.slice(6, 8)}T00:00:00`
+        : startValue.replace(/^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})$/, '$1-$2-$3T$4:$5:$6');
+    const [date, clock] = local.split('T');
+    const [year, month, day] = date.split('-').map(Number);
+    const [hour, minute, second] = clock.split(':').map(Number);
+    const next = new Date(Date.UTC(year, month - 1, day + dayCount, hour, minute, second));
+    const wall = `${String(next.getUTCFullYear()).padStart(4, '0')}-${String(next.getUTCMonth() + 1).padStart(2, '0')}-${String(next.getUTCDate()).padStart(2, '0')}T${String(next.getUTCHours()).padStart(2, '0')}:${String(next.getUTCMinutes()).padStart(2, '0')}:${String(next.getUTCSeconds()).padStart(2, '0')}`;
+    return epochAtLocalDateTime(wall, zone) + timeMs;
+}
+//# sourceMappingURL=timezone.js.map

package/dist/runtime/timezone.js.map

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

package/dist/sqlite.d.ts

@@ -1,35 +1,10 @@
 /**
- * SQLite wrapper for standalone using better-sqlite3.
- * API-compatible with the previous node:sqlite wrapper.
+ * The product's SQLite wrapper.
+ *
+ * This file used to re-export the core's copy. The driver moved down here because a
+ * shared core that opens a particular database engine is not shared: it is that engine's
+ * library with other things attached.
  */
-import BetterSqlite3 from 'better-sqlite3';
-export interface SQLiteRunResult {
-    changes: number;
-    lastInsertRowid: number | bigint;
-}
-export interface SQLiteStatement {
-    all: (...params: unknown[]) => unknown[];
-    get: (...params: unknown[]) => unknown;
-    run: (...params: unknown[]) => SQLiteRunResult;
-}
-export type SQLiteDatabase = Database;
-export default class Database {
-    private db;
-    readonly driver: "better-sqlite3";
-    constructor(path: string);
-    prepare(sql: string): SQLiteStatement;
-    exec(sql: string): void;
-    pragma(sql: string, options?: {
-        simple?: boolean;
-    }): unknown;
-    transaction<T extends (...args: never[]) => unknown>(fn: T, mode?: 'deferred' | 'immediate'): T;
-    close(): void;
-    /**
-     * Test-only escape hatch to the underlying better-sqlite3 handle, for harnesses
-     * that need connection-scoped features the wrapper does not surface (UDFs, TEMP
-     * views). Never use this on a production path.
-     */
-    get unsafeRawHandle(): BetterSqlite3.Database;
-    get open(): boolean;
-}
+export { default } from './storage-sqlite.js';
+export type { SQLiteDatabase, SQLiteRunResult, SQLiteStatement } from './storage-sqlite.js';
 //# sourceMappingURL=sqlite.d.ts.map

package/dist/sqlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,CAAC;IACzC,GAAG,EAAE,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IACvC,GAAG,EAAE,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,eAAe,CAAC;CAChD;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEtC,MAAM,CAAC,OAAO,OAAO,QAAQ;IAC3B,OAAO,CAAC,EAAE,CAAyB;IACnC,QAAQ,CAAC,MAAM,EAAG,gBAAgB,CAAU;gBAEhC,IAAI,EAAE,MAAM;IAIxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IAYrC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIvB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAI5D,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EACjD,EAAE,EAAE,CAAC,EACL,IAAI,GAAE,UAAU,GAAG,WAAwB,GAC1C,CAAC;IAKJ,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,IAAI,eAAe,IAAI,aAAa,CAAC,QAAQ,CAE5C;IAED,IAAI,IAAI,IAAI,OAAO,CAElB;CACF"}
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/sqlite.js

@@ -1,54 +1,16 @@
 "use strict";
-/**
- * SQLite wrapper for standalone using better-sqlite3.
- * API-compatible with the previous node:sqlite wrapper.
- */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
-class Database {
-    db;
-    driver = 'better-sqlite3';
-    constructor(path) {
-        this.db = new better_sqlite3_1.default(path);
-    }
-    prepare(sql) {
-        const stmt = this.db.prepare(sql);
-        return {
-            all: (...params) => stmt.all(...params),
-            get: (...params) => stmt.get(...params),
-            run: (...params) => {
-                const result = stmt.run(...params);
-                return { changes: result.changes, lastInsertRowid: result.lastInsertRowid };
-            },
-        };
-    }
-    exec(sql) {
-        this.db.exec(sql);
-    }
-    pragma(sql, options) {
-        return this.db.pragma(sql, options);
-    }
-    transaction(fn, mode = 'deferred') {
-        const transaction = this.db.transaction(fn);
-        return (mode === 'immediate' ? transaction.immediate : transaction);
-    }
-    close() {
-        this.db.close();
-    }
-    /**
-     * Test-only escape hatch to the underlying better-sqlite3 handle, for harnesses
-     * that need connection-scoped features the wrapper does not surface (UDFs, TEMP
-     * views). Never use this on a production path.
-     */
-    get unsafeRawHandle() {
-        return this.db;
-    }
-    get open() {
-        return this.db.open;
-    }
-}
-exports.default = Database;
+exports.default = void 0;
+/**
+ * The product's SQLite wrapper.
+ *
+ * This file used to re-export the core's copy. The driver moved down here because a
+ * shared core that opens a particular database engine is not shared: it is that engine's
+ * library with other things attached.
+ */
+var storage_sqlite_js_1 = require("./storage-sqlite.js");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(storage_sqlite_js_1).default; } });
 //# sourceMappingURL=sqlite.js.map

package/dist/sqlite.js.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAEH,oEAA2C;AAe3C,MAAqB,QAAQ;IACnB,EAAE,CAAyB;IAC1B,MAAM,GAAG,gBAAyB,CAAC;IAE5C,YAAY,IAAY;QACtB,IAAI,CAAC,EAAE,GAAG,IAAI,wBAAa,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,CAAC,GAAW;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO;YACL,GAAG,EAAE,CAAC,GAAG,MAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YAClD,GAAG,EAAE,CAAC,GAAG,MAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YAClD,GAAG,EAAE,CAAC,GAAG,MAAiB,EAAE,EAAE;gBAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;gBACnC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC;YAC9E,CAAC;SACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,GAAW;QACd,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,OAA8B;QAChD,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,WAAW,CACT,EAAK,EACL,OAAiC,UAAU;QAE3C,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAiB,CAAC;IACtF,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;IACtB,CAAC;CACF;AApDD,2BAoDC"}
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;GAMG;AACH,yDAA8C;AAArC,6HAAA,OAAO,OAAA"}

package/dist/storage/migrations/raw-item-revisions.d.ts

@@ -0,0 +1,6 @@
+import type { SQLiteDatabase } from '../../storage-sqlite.js';
+/** Preserve legacy source locators while adding explicit entity and revision identity. */
+export declare function applyRawItemRevisionsMigration(db: SQLiteDatabase): void;
+/** Convert the legacy raw-row join queue into immutable payload snapshots. */
+export declare function applyPendingProjectionSnapshotsMigration(db: SQLiteDatabase): void;
+//# sourceMappingURL=raw-item-revisions.d.ts.map

package/dist/storage/migrations/raw-item-revisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-item-revisions.d.ts","sourceRoot":"","sources":["../../../src/storage/migrations/raw-item-revisions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,0FAA0F;AAC1F,wBAAgB,8BAA8B,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CA6BvE;AAqDD,8EAA8E;AAC9E,wBAAgB,wCAAwC,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAkDjF"}

package/dist/storage/migrations/raw-item-revisions.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyRawItemRevisionsMigration = applyRawItemRevisionsMigration;
+exports.applyPendingProjectionSnapshotsMigration = applyPendingProjectionSnapshotsMigration;
+/** Preserve legacy source locators while adding explicit entity and revision identity. */
+function applyRawItemRevisionsMigration(db) {
+    db.exec('BEGIN IMMEDIATE');
+    try {
+        const columns = new Set(db.prepare('PRAGMA table_info(raw_items)').all().map((row) => row.name));
+        for (const name of ['origin_source_id', 'source_entity_id', 'revision_hash']) {
+            if (!columns.has(name)) {
+                db.exec(`ALTER TABLE raw_items ADD COLUMN ${name} TEXT`);
+            }
+        }
+        if (!columns.has('origin_source_id')) {
+            db.exec('UPDATE raw_items SET origin_source_id = source_id');
+        }
+        if (!columns.has('source_entity_id')) {
+            db.exec('UPDATE raw_items SET source_entity_id = source_id');
+        }
+        db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_raw_items_entity_revision ON raw_items(source_entity_id, id);
+      CREATE INDEX IF NOT EXISTS idx_raw_items_origin_revision
+        ON raw_items(origin_source_id, id);
+    `);
+        db.exec('COMMIT');
+    }
+    catch (error) {
+        db.exec('ROLLBACK');
+        throw error;
+    }
+}
+function legacyPendingPayload(row) {
+    let metadata;
+    if (row.metadata !== null) {
+        try {
+            metadata = JSON.parse(row.metadata);
+        }
+        catch (error) {
+            throw new Error(`Legacy pending metadata is malformed at local sequence ${row.sequence}`, {
+                cause: error,
+            });
+        }
+    }
+    return JSON.stringify({
+        source: row.source,
+        sourceId: row.source_id,
+        sourceEntityId: row.source_entity_id,
+        channel: row.channel,
+        author: row.author,
+        content: row.content,
+        timestamp: row.timestamp,
+        type: row.type,
+        ...(metadata === undefined ? {} : { metadata }),
+        ...(row.content_hash === null ? {} : { contentHash: row.content_hash }),
+        ...(row.source_cursor === null ? {} : { sourceCursor: row.source_cursor }),
+        ...(row.tenant_id === null ? {} : { tenantId: row.tenant_id }),
+        ...(row.project_id === null ? {} : { projectId: row.project_id }),
+        ...(row.memory_scope_kind === null ? {} : { memoryScopeKind: row.memory_scope_kind }),
+        ...(row.memory_scope_id === null ? {} : { memoryScopeId: row.memory_scope_id }),
+        observedAt: row.observed_at,
+    });
+}
+/** Convert the legacy raw-row join queue into immutable payload snapshots. */
+function applyPendingProjectionSnapshotsMigration(db) {
+    const columns = new Set(db.prepare('PRAGMA table_info(pending_core_projections)').all().map((row) => row.name));
+    if (columns.has('payload_hash') && columns.has('payload_json')) {
+        return;
+    }
+    db.exec('BEGIN IMMEDIATE');
+    try {
+        const rows = db
+            .prepare(`SELECT p.sequence, p.observed_at, r.source_id, r.source_entity_id, r.source,
+              r.channel, r.author, r.content, r.timestamp, r.type, r.metadata, r.content_hash,
+              r.source_cursor, r.tenant_id, r.project_id, r.memory_scope_kind, r.memory_scope_id
+         FROM pending_core_projections p
+         JOIN raw_items r ON r.source_id = p.raw_source_id
+        ORDER BY p.sequence`)
+            .all();
+        db.exec(`
+    DROP INDEX IF EXISTS idx_pending_core_projection_sequence;
+    ALTER TABLE pending_core_projections RENAME TO pending_core_projections_legacy;
+    CREATE TABLE pending_core_projections (
+      sequence INTEGER PRIMARY KEY AUTOINCREMENT,
+      raw_source_id TEXT NOT NULL REFERENCES raw_items(source_id),
+      payload_hash TEXT NOT NULL,
+      payload_json TEXT NOT NULL,
+      observed_at INTEGER NOT NULL,
+      created_at INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000),
+      UNIQUE(raw_source_id, payload_hash)
+    );
+    CREATE INDEX idx_pending_core_projection_sequence ON pending_core_projections(sequence);
+  `);
+        const insert = db.prepare(`INSERT INTO pending_core_projections
+       (sequence, raw_source_id, payload_hash, payload_json, observed_at)
+     VALUES (?, ?, ?, ?, ?)`);
+        for (const row of rows) {
+            const payload = legacyPendingPayload(row);
+            insert.run(row.sequence, row.source_id, `legacy:${row.sequence}`, payload, row.observed_at);
+        }
+        db.exec('DROP TABLE pending_core_projections_legacy');
+        db.exec('COMMIT');
+    }
+    catch (error) {
+        db.exec('ROLLBACK');
+        throw error;
+    }
+}
+//# sourceMappingURL=raw-item-revisions.js.map

package/dist/storage/migrations/raw-item-revisions.js.map

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

package/dist/storage/migrations-source.d.ts

@@ -0,0 +1,5 @@
+export declare const STANDALONE_MIGRATION_SOURCE: {
+    readonly name: "standalone";
+    readonly dir: string;
+};
+//# sourceMappingURL=migrations-source.d.ts.map

package/dist/storage/migrations-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations-source.d.ts","sourceRoot":"","sources":["../../src/storage/migrations-source.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,2BAA2B;;kBAE3B,MAAM;CAGT,CAAC"}

package/dist/storage/migrations-source.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STANDALONE_MIGRATION_SOURCE = void 0;
+/**
+ * Where this package's own schema lives.
+ *
+ * The connector event index is declared here rather than by the core, because
+ * three of the core's four consumers have no connectors and were creating
+ * eighteen tables they never write. A migration belongs to whoever wrote it, and
+ * its identity is (source, version), so this package's numbering is its own.
+ */
+const node_path_1 = require("node:path");
+/** Resolved from this file so it holds under both src and dist layouts. */
+function packageRoot() {
+    // src/storage/... or dist/storage/...
+    return (0, node_path_1.resolve)((0, node_path_1.dirname)(__filename), '..', '..');
+}
+exports.STANDALONE_MIGRATION_SOURCE = {
+    name: 'standalone',
+    get dir() {
+        return (0, node_path_1.join)(packageRoot(), 'db', 'migrations');
+    },
+};
+//# sourceMappingURL=migrations-source.js.map

package/dist/storage/migrations-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations-source.js","sourceRoot":"","sources":["../../src/storage/migrations-source.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,yCAAmD;AAEnD,2EAA2E;AAC3E,SAAS,WAAW;IAClB,sCAAsC;IACtC,OAAO,IAAA,mBAAO,EAAC,IAAA,mBAAO,EAAC,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAClD,CAAC;AAEY,QAAA,2BAA2B,GAAG;IACzC,IAAI,EAAE,YAAY;IAClB,IAAI,GAAG;QACL,OAAO,IAAA,gBAAI,EAAC,WAAW,EAAE,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;IACjD,CAAC;CACO,CAAC"}

package/dist/storage/source-archive.d.ts

@@ -0,0 +1,123 @@
+/**
+ * RawStore — per-connector SQLite evidence storage.
+ * Creates basePath/<connectorName>/raw.db for each connector.
+ * Uses the project's existing Database wrapper (sqlite.ts).
+ */
+export interface NormalizedItem {
+    source: string;
+    /** Immutable stored observation locator; collectors may initially supply the upstream ID. */
+    sourceId: string;
+    /** Stable upstream entity across revisions (page, event, file, card). */
+    sourceEntityId?: string;
+    channel: string;
+    author: string;
+    content: string;
+    timestamp: Date;
+    contentHash?: string;
+    sourceCursor?: string;
+    /** First complete feed snapshots are stored without admitting them as live deltas. */
+    collectOnly?: boolean;
+    tenantId?: string;
+    projectId?: string;
+    memoryScopeKind?: string;
+    memoryScopeId?: string;
+    type: 'message' | 'email' | 'event' | 'document' | 'note' | 'spreadsheet_row' | 'kanban_card' | 'file_change';
+    /**
+     * Arbitrary structured facts. Reserved key: `observedAt` means observation-time bookkeeping and is
+     * excluded from the stored content-identity/revision hash (a re-poll that only moves observedAt is
+     * not a new version). Do NOT put a semantic datum under `observedAt`; use `sourceCursor` or another
+     * field for last-seen values that must be tracked.
+     */
+    metadata?: Record<string, unknown>;
+    /** Host capture time. It is preserved across projection retries. */
+    observedAt?: number;
+    /** Internal exact pending-row identity used to acknowledge one immutable projection. */
+    pendingProjectionId?: number;
+}
+export interface PendingProjection extends NormalizedItem {
+    pendingProjectionId: number;
+    /** Historical imports may be indexed, but never admitted as live changes. */
+    collectOnly?: boolean;
+}
+export interface RawIndexProjection {
+    sourceId: string;
+    observationRef: string;
+}
+interface ConnectorEventIndexInput {
+    source_connector: string;
+    source_type: string;
+    source_id: string;
+    source_entity_id: string;
+    source_locator: string;
+    channel: string;
+    author: string;
+    content: string;
+    event_datetime: number;
+    source_timestamp_ms: number;
+    source_cursor: string | null;
+    tenant_id: string | null;
+    project_id: string | null;
+    memory_scope_kind: string | null;
+    memory_scope_id: string | null;
+    metadata: Record<string, unknown> | null;
+    content_hash: Buffer;
+    observation: {
+        producer_version_id: string;
+        body_location: {
+            kind: 'raw';
+            connectorName: string;
+            revisionSourceId: string;
+        };
+        observed_at: number;
+        source_at: number | null;
+    };
+}
+export type RawIndexSink = (connectorName: string, items: NormalizedItem[]) => RawIndexProjection[] | Promise<RawIndexProjection[]>;
+export interface RawVersionReadResult {
+    status: 'available' | 'version_unavailable';
+    body?: string;
+    contentHash?: string;
+    reason?: 'VERSION_NOT_FOUND' | 'HASH_MISMATCH';
+}
+export declare function mapNormalizedItemsToConnectorEventIndexInputs(connectorName: string, items: NormalizedItem[]): ConnectorEventIndexInput[];
+export declare class RawStore {
+    private dbs;
+    private readonly basePath;
+    constructor(basePath: string);
+    private getDb;
+    private getDbPath;
+    private mapRawRowToNormalizedItem;
+    /**
+     * Atomically persist a batch and return the stored row for each input (1:1). The returned rows carry
+     * the corrected sourceId/sourceEntityId so the store and the index share one locator; an unchanged
+     * re-poll or a re-listed immutable version returns the existing row instead of forging a new one.
+     */
+    save(connectorName: string, items: NormalizedItem[], options?: {
+        collectOnly?: boolean;
+    }): NormalizedItem[];
+    listPendingProjections(connectorName: string, limit?: number, afterSequence?: number): PendingProjection[];
+    acknowledgeProjection(connectorName: string, revisionSourceId: string, pendingProjectionId: number): void;
+    acknowledgeProjections(connectorName: string, projections: readonly {
+        revisionSourceId: string;
+        pendingProjectionId: number;
+    }[]): void;
+    readVersion(connectorName: string, revisionSourceId: string, expectedContentHash: string): RawVersionReadResult;
+    /** Stable, bounded traversal of an entity's stored revisions. Cursor is the last row ID. */
+    getRevisions(connectorName: string, entityId: string, options?: {
+        limit?: number;
+        cursor?: number;
+    }): {
+        items: NormalizedItem[];
+        nextCursor: number | null;
+    };
+    query(connectorName: string, since: Date): NormalizedItem[];
+    hasConnector(connectorName: string): boolean;
+    /** Existing raw connector directories, without creating new stores. */
+    listConnectorNames(): string[];
+    count(connectorName: string): number;
+    pendingProjectionCount(connectorName: string): number;
+    getRecent(connectorName: string, count: number): NormalizedItem[];
+    close(): void;
+}
+export {};
+//# sourceMappingURL=source-archive.d.ts.map

package/dist/storage/source-archive.d.ts.map

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