@starkeep/storage-sqlite 0.1.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +69 -87
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +5 -16
- package/dist/index.d.ts +5 -16
- package/dist/index.js +69 -90
- package/dist/index.js.map +1 -1
- package/package.json +6 -7
package/dist/index.cjs
CHANGED
|
@@ -24,7 +24,6 @@ __export(index_exports, {
|
|
|
24
24
|
SqliteAppSyncableNamespaceStore: () => SqliteAppSyncableNamespaceStore,
|
|
25
25
|
SqliteDatabaseAdapter: () => SqliteDatabaseAdapter,
|
|
26
26
|
appSyncableTableName: () => appSyncableTableName,
|
|
27
|
-
createSqliteAccessPolicyStore: () => createSqliteAccessPolicyStore,
|
|
28
27
|
deleteAppSyncableNamespace: () => deleteAppSyncableNamespace,
|
|
29
28
|
getAppSyncableNamespace: () => getAppSyncableNamespace,
|
|
30
29
|
initializeLocalSchema: () => initializeLocalSchema,
|
|
@@ -48,7 +47,7 @@ function recordToRow(record) {
|
|
|
48
47
|
type: record.type,
|
|
49
48
|
created_at: (0, import_protocol_primitives.serializeHLC)(record.createdAt),
|
|
50
49
|
updated_at: (0, import_protocol_primitives.serializeHLC)(record.updatedAt),
|
|
51
|
-
|
|
50
|
+
node_id: record.updatedAt.nodeId,
|
|
52
51
|
deleted_at: record.deletedAt ? (0, import_protocol_primitives.serializeHLC)(record.deletedAt) : null,
|
|
53
52
|
version: record.version,
|
|
54
53
|
content_hash: record.contentHash,
|
|
@@ -57,7 +56,8 @@ function recordToRow(record) {
|
|
|
57
56
|
size_bytes: record.sizeBytes,
|
|
58
57
|
original_filename: record.originalFilename,
|
|
59
58
|
origin_app_id: record.originAppId,
|
|
60
|
-
parent_id: record.parentId
|
|
59
|
+
parent_id: record.parentId,
|
|
60
|
+
label: record.label
|
|
61
61
|
};
|
|
62
62
|
}
|
|
63
63
|
function rowToRecord(row) {
|
|
@@ -67,7 +67,6 @@ function rowToRecord(row) {
|
|
|
67
67
|
type: row.type,
|
|
68
68
|
createdAt: (0, import_protocol_primitives.deserializeHLC)(row.created_at),
|
|
69
69
|
updatedAt: (0, import_protocol_primitives.deserializeHLC)(row.updated_at),
|
|
70
|
-
ownerId: row.owner_id,
|
|
71
70
|
deletedAt: row.deleted_at ? (0, import_protocol_primitives.deserializeHLC)(row.deleted_at) : null,
|
|
72
71
|
version: row.version,
|
|
73
72
|
contentHash: row.content_hash,
|
|
@@ -76,7 +75,8 @@ function rowToRecord(row) {
|
|
|
76
75
|
sizeBytes: row.size_bytes,
|
|
77
76
|
originalFilename: row.original_filename,
|
|
78
77
|
originAppId: row.origin_app_id,
|
|
79
|
-
parentId: row.parent_id ? (0, import_protocol_primitives.createStarkeepId)(row.parent_id) : null
|
|
78
|
+
parentId: row.parent_id ? (0, import_protocol_primitives.createStarkeepId)(row.parent_id) : null,
|
|
79
|
+
label: row.label
|
|
80
80
|
};
|
|
81
81
|
}
|
|
82
82
|
|
|
@@ -87,7 +87,6 @@ var FIELD_MAP = {
|
|
|
87
87
|
type: "type",
|
|
88
88
|
createdAt: "created_at",
|
|
89
89
|
updatedAt: "updated_at",
|
|
90
|
-
ownerId: "owner_id",
|
|
91
90
|
deletedAt: "deleted_at",
|
|
92
91
|
version: "version",
|
|
93
92
|
contentHash: "content_hash",
|
|
@@ -96,7 +95,8 @@ var FIELD_MAP = {
|
|
|
96
95
|
sizeBytes: "size_bytes",
|
|
97
96
|
originAppId: "origin_app_id",
|
|
98
97
|
parentId: "parent_id",
|
|
99
|
-
originalFilename: "original_filename"
|
|
98
|
+
originalFilename: "original_filename",
|
|
99
|
+
label: "label"
|
|
100
100
|
};
|
|
101
101
|
function mapField(field) {
|
|
102
102
|
return FIELD_MAP[field] ?? field;
|
|
@@ -174,23 +174,32 @@ function initializeLocalSchema(db) {
|
|
|
174
174
|
type TEXT NOT NULL,
|
|
175
175
|
created_at TEXT NOT NULL,
|
|
176
176
|
updated_at TEXT NOT NULL,
|
|
177
|
-
|
|
177
|
+
-- Denormalized from updated_at (its nodeId component) on every write.
|
|
178
|
+
-- Feeds the sync responder's per-node coverage watermark via the
|
|
179
|
+
-- (node_id, updated_at) index without scanning the table.
|
|
180
|
+
node_id TEXT NOT NULL,
|
|
178
181
|
deleted_at TEXT,
|
|
179
182
|
version INTEGER NOT NULL DEFAULT 1,
|
|
180
183
|
content_hash TEXT NOT NULL,
|
|
181
184
|
object_storage_key TEXT NOT NULL,
|
|
182
|
-
mime_type TEXT
|
|
185
|
+
mime_type TEXT,
|
|
183
186
|
size_bytes INTEGER NOT NULL,
|
|
184
187
|
original_filename TEXT,
|
|
185
188
|
origin_app_id TEXT NOT NULL,
|
|
186
|
-
parent_id TEXT
|
|
189
|
+
parent_id TEXT,
|
|
190
|
+
-- Advisory appId/purpose interest-filter marker (e.g. photos/thumbnail);
|
|
191
|
+
-- NULL = general interest. See DataRecord.label.
|
|
192
|
+
label TEXT
|
|
187
193
|
)
|
|
188
194
|
`);
|
|
189
195
|
db.exec("CREATE INDEX IF NOT EXISTS idx_shared_records_type ON shared_records(type)");
|
|
196
|
+
db.exec(
|
|
197
|
+
"CREATE INDEX IF NOT EXISTS idx_shared_records_node_watermark ON shared_records(node_id, updated_at)"
|
|
198
|
+
);
|
|
190
199
|
db.exec("CREATE INDEX IF NOT EXISTS idx_shared_records_origin_app ON shared_records(origin_app_id)");
|
|
191
200
|
db.exec("CREATE INDEX IF NOT EXISTS idx_shared_records_parent_id ON shared_records(parent_id)");
|
|
192
201
|
db.exec(
|
|
193
|
-
"CREATE UNIQUE INDEX IF NOT EXISTS
|
|
202
|
+
"CREATE UNIQUE INDEX IF NOT EXISTS uq_shared_records_filename_hash ON shared_records(original_filename, content_hash) WHERE deleted_at IS NULL AND original_filename IS NOT NULL"
|
|
194
203
|
);
|
|
195
204
|
db.exec(`
|
|
196
205
|
CREATE TABLE IF NOT EXISTS shared_access_grants (
|
|
@@ -235,19 +244,6 @@ function initializeLocalSchema(db) {
|
|
|
235
244
|
created_at TEXT NOT NULL DEFAULT (datetime('now'))
|
|
236
245
|
)
|
|
237
246
|
`);
|
|
238
|
-
db.exec(`
|
|
239
|
-
CREATE TABLE IF NOT EXISTS access_policies (
|
|
240
|
-
policy_id TEXT PRIMARY KEY,
|
|
241
|
-
subject_type TEXT NOT NULL,
|
|
242
|
-
subject_id TEXT NOT NULL,
|
|
243
|
-
resource_type TEXT NOT NULL,
|
|
244
|
-
resource_id TEXT NOT NULL,
|
|
245
|
-
permissions TEXT NOT NULL,
|
|
246
|
-
granted_at TEXT NOT NULL,
|
|
247
|
-
expires_at TEXT
|
|
248
|
-
)
|
|
249
|
-
`);
|
|
250
|
-
db.exec("CREATE INDEX IF NOT EXISTS idx_access_policies_subject ON access_policies(subject_type, subject_id)");
|
|
251
247
|
for (const c of import_protocol_primitives2.CATEGORIES) {
|
|
252
248
|
if (c.id === "other") continue;
|
|
253
249
|
db.exec((0, import_protocol_primitives2.sqliteMetadataDdl)(c));
|
|
@@ -325,12 +321,23 @@ var SqliteDatabaseAdapter = class {
|
|
|
325
321
|
async delete(id, hlc) {
|
|
326
322
|
const ts = (0, import_protocol_primitives3.serializeHLC)(hlc);
|
|
327
323
|
this.runStmt(
|
|
328
|
-
"UPDATE shared_records SET deleted_at = ?, updated_at = ? WHERE id = ?",
|
|
324
|
+
"UPDATE shared_records SET deleted_at = ?, updated_at = ?, node_id = ? WHERE id = ?",
|
|
329
325
|
ts,
|
|
330
326
|
ts,
|
|
327
|
+
hlc.nodeId,
|
|
331
328
|
id
|
|
332
329
|
);
|
|
333
330
|
}
|
|
331
|
+
async getNodeWatermarks() {
|
|
332
|
+
const rows = this.allRows(
|
|
333
|
+
"SELECT node_id, MAX(updated_at) AS max_updated_at FROM shared_records GROUP BY node_id"
|
|
334
|
+
);
|
|
335
|
+
const out = {};
|
|
336
|
+
for (const row of rows) {
|
|
337
|
+
out[row.node_id] = (0, import_protocol_primitives3.deserializeHLC)(row.max_updated_at);
|
|
338
|
+
}
|
|
339
|
+
return out;
|
|
340
|
+
}
|
|
334
341
|
async query(query) {
|
|
335
342
|
const { sql, params } = buildSelectQuery(query);
|
|
336
343
|
const rows = this.allRows(sql, ...params);
|
|
@@ -429,61 +436,6 @@ function columnsToMetadataRow(recordId, columns) {
|
|
|
429
436
|
return row;
|
|
430
437
|
}
|
|
431
438
|
|
|
432
|
-
// src/control-plane-stores.ts
|
|
433
|
-
var import_protocol_primitives4 = require("@starkeep/protocol-primitives");
|
|
434
|
-
function createSqliteAccessPolicyStore(db) {
|
|
435
|
-
return {
|
|
436
|
-
async putPolicy(policy) {
|
|
437
|
-
db.prepare(
|
|
438
|
-
`INSERT INTO access_policies (
|
|
439
|
-
policy_id, subject_type, subject_id, resource_type, resource_id,
|
|
440
|
-
permissions, granted_at, expires_at
|
|
441
|
-
) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
|
|
442
|
-
ON CONFLICT(policy_id) DO UPDATE SET
|
|
443
|
-
subject_type = excluded.subject_type,
|
|
444
|
-
subject_id = excluded.subject_id,
|
|
445
|
-
resource_type = excluded.resource_type,
|
|
446
|
-
resource_id = excluded.resource_id,
|
|
447
|
-
permissions = excluded.permissions,
|
|
448
|
-
granted_at = excluded.granted_at,
|
|
449
|
-
expires_at = excluded.expires_at`
|
|
450
|
-
).run(
|
|
451
|
-
policy.policyId,
|
|
452
|
-
policy.subjectType,
|
|
453
|
-
policy.subjectId,
|
|
454
|
-
policy.resourceType,
|
|
455
|
-
policy.resourceId,
|
|
456
|
-
policy.permissions.join(","),
|
|
457
|
-
(0, import_protocol_primitives4.serializeHLC)(policy.grantedAt),
|
|
458
|
-
policy.expiresAt ? (0, import_protocol_primitives4.serializeHLC)(policy.expiresAt) : null
|
|
459
|
-
);
|
|
460
|
-
},
|
|
461
|
-
async getPolicy(policyId) {
|
|
462
|
-
const row = db.prepare("SELECT * FROM access_policies WHERE policy_id = ?").get(policyId);
|
|
463
|
-
return row ? rowToPolicy(row) : null;
|
|
464
|
-
},
|
|
465
|
-
async listPolicies() {
|
|
466
|
-
const rows = db.prepare("SELECT * FROM access_policies").all();
|
|
467
|
-
return rows.map(rowToPolicy);
|
|
468
|
-
},
|
|
469
|
-
async deletePolicy(policyId) {
|
|
470
|
-
db.prepare("DELETE FROM access_policies WHERE policy_id = ?").run(policyId);
|
|
471
|
-
}
|
|
472
|
-
};
|
|
473
|
-
}
|
|
474
|
-
function rowToPolicy(row) {
|
|
475
|
-
return {
|
|
476
|
-
policyId: (0, import_protocol_primitives4.createStarkeepId)(row.policy_id),
|
|
477
|
-
subjectType: row.subject_type,
|
|
478
|
-
subjectId: row.subject_id,
|
|
479
|
-
resourceType: row.resource_type,
|
|
480
|
-
resourceId: row.resource_id,
|
|
481
|
-
permissions: row.permissions.split(",").filter(Boolean),
|
|
482
|
-
grantedAt: (0, import_protocol_primitives4.deserializeHLC)(row.granted_at),
|
|
483
|
-
expiresAt: row.expires_at ? (0, import_protocol_primitives4.deserializeHLC)(row.expires_at) : null
|
|
484
|
-
};
|
|
485
|
-
}
|
|
486
|
-
|
|
487
439
|
// src/app-syncable/namespace.ts
|
|
488
440
|
function normalizeAppId(appId) {
|
|
489
441
|
return appId.toLowerCase().replace(/-/g, "_");
|
|
@@ -538,7 +490,7 @@ var SqliteAppSyncableNamespaceStore = class {
|
|
|
538
490
|
};
|
|
539
491
|
|
|
540
492
|
// src/app-syncable/apply.ts
|
|
541
|
-
var
|
|
493
|
+
var import_protocol_primitives4 = require("@starkeep/protocol-primitives");
|
|
542
494
|
var SqliteAppSyncableApplier = class {
|
|
543
495
|
constructor(db, namespace) {
|
|
544
496
|
this.db = db;
|
|
@@ -568,7 +520,7 @@ var SqliteAppSyncableApplier = class {
|
|
|
568
520
|
}
|
|
569
521
|
}
|
|
570
522
|
applyInsert(fullName, pkColumns, entry) {
|
|
571
|
-
const row = entry.row ?? {};
|
|
523
|
+
const row = withNodeId(entry.row ?? {}, entry);
|
|
572
524
|
const cols = Object.keys(row);
|
|
573
525
|
if (cols.length === 0) return;
|
|
574
526
|
const colList = cols.map(q).join(", ");
|
|
@@ -594,7 +546,8 @@ var SqliteAppSyncableApplier = class {
|
|
|
594
546
|
).run(...values);
|
|
595
547
|
}
|
|
596
548
|
applyUpdate(fullName, entry) {
|
|
597
|
-
const
|
|
549
|
+
const rawPatch = entry.row ?? {};
|
|
550
|
+
const patch = rawPatch["updated_at"] ? withNodeId(rawPatch, entry) : rawPatch;
|
|
598
551
|
const where = entry.where ?? {};
|
|
599
552
|
const patchCols = Object.keys(patch);
|
|
600
553
|
const whereCols = Object.keys(where);
|
|
@@ -615,7 +568,7 @@ var SqliteAppSyncableApplier = class {
|
|
|
615
568
|
const where = entry.where ?? {};
|
|
616
569
|
const whereCols = Object.keys(where);
|
|
617
570
|
const incomingUpdatedAt = entry.row?.["updated_at"];
|
|
618
|
-
const ts = incomingUpdatedAt ?? (0,
|
|
571
|
+
const ts = incomingUpdatedAt ?? (0, import_protocol_primitives4.serializeHLC)(entry.timestamp);
|
|
619
572
|
const conditions = [
|
|
620
573
|
...whereCols.map((c) => `${q(c)} = ?`),
|
|
621
574
|
`(updated_at IS NULL OR updated_at < ?)`
|
|
@@ -624,14 +577,32 @@ var SqliteAppSyncableApplier = class {
|
|
|
624
577
|
const params = [
|
|
625
578
|
ts,
|
|
626
579
|
ts,
|
|
580
|
+
nodeIdOf(ts, entry),
|
|
627
581
|
...whereCols.map((c) => where[c]),
|
|
628
582
|
ts
|
|
629
583
|
// for the LWW updated_at < ? condition
|
|
630
584
|
];
|
|
631
585
|
this.db.prepare(
|
|
632
|
-
`UPDATE ${q(fullName)} SET deleted_at = ?, updated_at = ?${whereClause}`
|
|
586
|
+
`UPDATE ${q(fullName)} SET deleted_at = ?, updated_at = ?, node_id = ?${whereClause}`
|
|
633
587
|
).run(...params);
|
|
634
588
|
}
|
|
589
|
+
/** See `ScanCapableApplier.getNodeWatermarks`. Missing table → `{}`. */
|
|
590
|
+
async getNodeWatermarks(appId, table) {
|
|
591
|
+
const fullName = appSyncableTableName(appId, table);
|
|
592
|
+
let rows;
|
|
593
|
+
try {
|
|
594
|
+
rows = this.db.prepare(
|
|
595
|
+
`SELECT node_id, MAX(updated_at) AS max_updated_at FROM ${q(fullName)} GROUP BY node_id`
|
|
596
|
+
).all();
|
|
597
|
+
} catch {
|
|
598
|
+
return {};
|
|
599
|
+
}
|
|
600
|
+
const out = {};
|
|
601
|
+
for (const row of rows) {
|
|
602
|
+
out[row.node_id] = (0, import_protocol_primitives4.deserializeHLC)(row.max_updated_at);
|
|
603
|
+
}
|
|
604
|
+
return out;
|
|
605
|
+
}
|
|
635
606
|
/**
|
|
636
607
|
* Pull-side synthesis: return rows updated after `sinceHlcStr` (or `cursor`
|
|
637
608
|
* if higher) in HLC order, paginated. `updated_at` is a serialized HLC
|
|
@@ -677,10 +648,22 @@ var SqliteAppSyncableApplier = class {
|
|
|
677
648
|
function q(name) {
|
|
678
649
|
return `"${name}"`;
|
|
679
650
|
}
|
|
651
|
+
function withNodeId(row, entry) {
|
|
652
|
+
return { ...row, node_id: nodeIdOf(row["updated_at"], entry) };
|
|
653
|
+
}
|
|
654
|
+
function nodeIdOf(updatedAt, entry) {
|
|
655
|
+
if (typeof updatedAt === "string") {
|
|
656
|
+
try {
|
|
657
|
+
return (0, import_protocol_primitives4.deserializeHLC)(updatedAt).nodeId;
|
|
658
|
+
} catch {
|
|
659
|
+
}
|
|
660
|
+
}
|
|
661
|
+
return entry.timestamp.nodeId;
|
|
662
|
+
}
|
|
680
663
|
function rowToEntry(appId, table, row) {
|
|
681
664
|
const updatedAtStr = row["updated_at"];
|
|
682
665
|
const deletedAtStr = row["deleted_at"];
|
|
683
|
-
const timestamp = (0,
|
|
666
|
+
const timestamp = (0, import_protocol_primitives4.deserializeHLC)(updatedAtStr);
|
|
684
667
|
if (deletedAtStr) {
|
|
685
668
|
return { timestamp, appId, table, op: "delete", row };
|
|
686
669
|
}
|
|
@@ -692,7 +675,6 @@ function rowToEntry(appId, table, row) {
|
|
|
692
675
|
SqliteAppSyncableNamespaceStore,
|
|
693
676
|
SqliteDatabaseAdapter,
|
|
694
677
|
appSyncableTableName,
|
|
695
|
-
createSqliteAccessPolicyStore,
|
|
696
678
|
deleteAppSyncableNamespace,
|
|
697
679
|
getAppSyncableNamespace,
|
|
698
680
|
initializeLocalSchema,
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts","../src/adapter.ts","../src/serialization.ts","../src/query-builder.ts","../src/schema/bootstrap.ts","../src/control-plane-stores.ts","../src/app-syncable/namespace.ts","../src/app-syncable/apply.ts"],"sourcesContent":["export { SqliteDatabaseAdapter } from \"./adapter.js\";\nexport type { SqliteDatabaseAdapterOptions } from \"./adapter.js\";\nexport { initializeLocalSchema } from \"./schema/bootstrap.js\";\nexport { createSqliteAccessPolicyStore } from \"./control-plane-stores.js\";\nexport {\n appSyncableTableName,\n getAppSyncableNamespace,\n upsertAppSyncableNamespace,\n deleteAppSyncableNamespace,\n listAppSyncableNamespaces,\n SqliteAppSyncableNamespaceStore,\n} from \"./app-syncable/namespace.js\";\nexport type { AppSyncableNamespace, AppSyncableTableInfo } from \"./app-syncable/namespace.js\";\nexport { SqliteAppSyncableApplier } from \"./app-syncable/apply.js\";\n","import { DatabaseSync } from \"node:sqlite\";\nimport { mkdirSync, existsSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport type { DataRecord, HLCTimestamp, MetadataRow, StarkeepId } from \"@starkeep/protocol-primitives\";\nimport { serializeHLC, sqliteMetadataTableName } from \"@starkeep/protocol-primitives\";\nimport type {\n DatabaseAdapter,\n Query,\n QueryResult,\n BatchOperation,\n Transaction,\n} from \"@starkeep/storage-adapter\";\nimport { StorageError, TransactionError } from \"@starkeep/storage-adapter\";\nimport { recordToRow, rowToRecord, type SqliteRow } from \"./serialization.js\";\nimport { buildSelectQuery } from \"./query-builder.js\";\nimport { initializeLocalSchema } from \"./schema/bootstrap.js\";\n\nexport interface SqliteDatabaseAdapterOptions {\n path: string | \":memory:\";\n}\n\nexport class SqliteDatabaseAdapter implements DatabaseAdapter {\n private database: DatabaseSync | null = null;\n private readonly options: SqliteDatabaseAdapterOptions;\n\n constructor(options: SqliteDatabaseAdapterOptions) {\n this.options = options;\n }\n\n async init(): Promise<void> {\n if (this.database) return;\n if (this.options.path !== \":memory:\") {\n const dir = dirname(this.options.path);\n if (!existsSync(dir)) {\n mkdirSync(dir, { recursive: true });\n }\n }\n this.database = new DatabaseSync(this.options.path);\n initializeLocalSchema(this.database);\n }\n\n async close(): Promise<void> {\n this.database?.close();\n this.database = null;\n }\n\n async healthCheck(): Promise<boolean> {\n if (!this.database) return false;\n try {\n this.database.prepare(\"SELECT 1\").get();\n return true;\n } catch {\n return false;\n }\n }\n\n private getDatabase(): DatabaseSync {\n if (!this.database) throw new StorageError(\"Database not initialized. Call init() first.\");\n return this.database;\n }\n\n /**\n * Returns the raw SQLite connection so sibling subsystems (e.g. the sync\n * engine's change log + state store) can create side tables in the same\n * database file. Callers must only use this after `init()`.\n */\n getRawDatabase(): DatabaseSync {\n return this.getDatabase();\n }\n\n private runStmt(sql: string, ...params: unknown[]): void {\n this.getDatabase().prepare(sql).run(...(params as Parameters<ReturnType<DatabaseSync[\"prepare\"]>[\"run\"]>));\n }\n\n private getRow<T = SqliteRow>(sql: string, ...params: unknown[]): T | undefined {\n return this.getDatabase().prepare(sql).get(\n ...(params as Parameters<ReturnType<DatabaseSync[\"prepare\"]>[\"get\"]>),\n ) as unknown as T | undefined;\n }\n\n private allRows<T = SqliteRow>(sql: string, ...params: unknown[]): T[] {\n return this.getDatabase().prepare(sql).all(\n ...(params as Parameters<ReturnType<DatabaseSync[\"prepare\"]>[\"all\"]>),\n ) as unknown as T[];\n }\n\n async put(record: DataRecord): Promise<void> {\n const row = recordToRow(record);\n const columns = Object.keys(row);\n const placeholders = columns.map(() => \"?\").join(\", \");\n const updates = columns\n .filter((column) => column !== \"id\")\n .map((column) => `${column} = excluded.${column}`)\n .join(\", \");\n const sql = `INSERT INTO shared_records (${columns.join(\", \")}) VALUES (${placeholders}) ON CONFLICT(id) DO UPDATE SET ${updates}`;\n this.runStmt(sql, ...Object.values(row));\n }\n\n async get(id: StarkeepId): Promise<DataRecord | null> {\n const row = this.getRow<SqliteRow>(\"SELECT * FROM shared_records WHERE id = ?\", id);\n return row ? rowToRecord(row) : null;\n }\n\n async delete(id: StarkeepId, hlc: HLCTimestamp): Promise<void> {\n const ts = serializeHLC(hlc);\n this.runStmt(\n \"UPDATE shared_records SET deleted_at = ?, updated_at = ? WHERE id = ?\",\n ts,\n ts,\n id,\n );\n }\n\n async query(query: Query): Promise<QueryResult> {\n const { sql, params } = buildSelectQuery(query);\n const rows = this.allRows<SqliteRow>(sql, ...params);\n\n const limit = query.limit;\n const hasMore = limit ? rows.length > limit : false;\n const resultRows = hasMore ? rows.slice(0, limit) : rows;\n\n return {\n records: resultRows.map(rowToRecord),\n nextCursor: hasMore ? resultRows[resultRows.length - 1].id : null,\n hasMore,\n };\n }\n\n async batch(operations: BatchOperation[]): Promise<void> {\n this.getDatabase().exec(\"BEGIN\");\n try {\n for (const operation of operations) {\n if (operation.type === \"put\") {\n await this.put(operation.record);\n } else {\n await this.delete(operation.id, operation.hlc);\n }\n }\n this.getDatabase().exec(\"COMMIT\");\n } catch (error) {\n this.getDatabase().exec(\"ROLLBACK\");\n throw error;\n }\n }\n\n async transaction<T>(callback: (transaction: Transaction) => Promise<T>): Promise<T> {\n this.getDatabase().exec(\"SAVEPOINT starkeep_tx\");\n try {\n const transaction: Transaction = {\n put: async (record) => this.put(record),\n get: async (id) => this.get(id),\n delete: async (id, hlc) => this.delete(id, hlc),\n query: async (query) => this.query(query),\n };\n const result = await callback(transaction);\n this.getDatabase().exec(\"RELEASE SAVEPOINT starkeep_tx\");\n return result;\n } catch (error) {\n this.getDatabase().exec(\"ROLLBACK TO SAVEPOINT starkeep_tx\");\n this.getDatabase().exec(\"RELEASE SAVEPOINT starkeep_tx\");\n throw new TransactionError(\"Transaction failed\", error);\n }\n }\n\n async putMetadata(typeId: string, row: MetadataRow): Promise<void> {\n const table = sqliteMetadataTableName(typeId);\n const cols: string[] = [\"record_id\"];\n const values: unknown[] = [row.recordId];\n for (const [key, value] of Object.entries(row)) {\n if (key === \"recordId\") continue;\n cols.push(key);\n values.push(value);\n }\n const placeholders = cols.map(() => \"?\").join(\", \");\n const updates = cols\n .filter((c) => c !== \"record_id\")\n .map((c) => `${c} = excluded.${c}`)\n .join(\", \");\n const sql = updates\n ? `INSERT INTO ${table} (${cols.join(\", \")}) VALUES (${placeholders}) ON CONFLICT(record_id) DO UPDATE SET ${updates}`\n : `INSERT INTO ${table} (${cols.join(\", \")}) VALUES (${placeholders}) ON CONFLICT(record_id) DO NOTHING`;\n this.runStmt(sql, ...values);\n }\n\n async getMetadata(typeId: string, recordId: StarkeepId): Promise<MetadataRow | null> {\n const table = sqliteMetadataTableName(typeId);\n const row = this.getRow<Record<string, unknown>>(\n `SELECT * FROM ${table} WHERE record_id = ?`,\n recordId,\n );\n if (!row) return null;\n return columnsToMetadataRow(recordId, row);\n }\n\n async getMetadataByIds(\n typeId: string,\n recordIds: StarkeepId[],\n ): Promise<Map<StarkeepId, MetadataRow>> {\n const result = new Map<StarkeepId, MetadataRow>();\n if (recordIds.length === 0) return result;\n const table = sqliteMetadataTableName(typeId);\n const placeholders = recordIds.map(() => \"?\").join(\", \");\n const rows = this.allRows<Record<string, unknown>>(\n `SELECT * FROM ${table} WHERE record_id IN (${placeholders})`,\n ...recordIds,\n );\n for (const row of rows) {\n const recordId = row[\"record_id\"] as StarkeepId;\n result.set(recordId, columnsToMetadataRow(recordId, row));\n }\n return result;\n }\n\n async deleteMetadata(typeId: string, recordId: StarkeepId): Promise<void> {\n const table = sqliteMetadataTableName(typeId);\n this.runStmt(`DELETE FROM ${table} WHERE record_id = ?`, recordId);\n }\n\n}\n\nfunction columnsToMetadataRow(\n recordId: StarkeepId,\n columns: Record<string, unknown>,\n): MetadataRow {\n const row: MetadataRow = { recordId };\n for (const [key, value] of Object.entries(columns)) {\n if (key === \"record_id\") continue;\n row[key] = value;\n }\n return row;\n}\n","import type { DataRecord, MetadataRow, StarkeepId } from \"@starkeep/protocol-primitives\";\nimport { serializeHLC, deserializeHLC, createStarkeepId } from \"@starkeep/protocol-primitives\";\n\nexport interface SqliteRow {\n id: string;\n type: string;\n created_at: string;\n updated_at: string;\n owner_id: string;\n deleted_at: string | null;\n version: number;\n content_hash: string;\n object_storage_key: string;\n mime_type: string;\n size_bytes: number;\n original_filename: string | null;\n origin_app_id: string;\n parent_id: string | null;\n}\n\nexport function recordToRow(record: DataRecord): SqliteRow {\n return {\n id: record.id,\n type: record.type,\n created_at: serializeHLC(record.createdAt),\n updated_at: serializeHLC(record.updatedAt),\n owner_id: record.ownerId,\n deleted_at: record.deletedAt ? serializeHLC(record.deletedAt) : null,\n version: record.version,\n content_hash: record.contentHash,\n object_storage_key: record.objectStorageKey,\n mime_type: record.mimeType,\n size_bytes: record.sizeBytes,\n original_filename: record.originalFilename,\n origin_app_id: record.originAppId,\n parent_id: record.parentId,\n };\n}\n\nexport function rowToRecord(row: SqliteRow): DataRecord {\n return {\n id: createStarkeepId(row.id),\n kind: \"data\",\n type: row.type,\n createdAt: deserializeHLC(row.created_at),\n updatedAt: deserializeHLC(row.updated_at),\n ownerId: row.owner_id,\n deletedAt: row.deleted_at ? deserializeHLC(row.deleted_at) : null,\n version: row.version,\n contentHash: row.content_hash,\n objectStorageKey: row.object_storage_key,\n mimeType: row.mime_type,\n sizeBytes: row.size_bytes,\n originalFilename: row.original_filename,\n originAppId: row.origin_app_id,\n parentId: row.parent_id ? createStarkeepId(row.parent_id) : null,\n };\n}\n\n/**\n * Convert SQLite column-keyed row data into a MetadataRow keyed by recordId\n * plus camelCase or snake_case columns. We pass columns through as-is from\n * the DB so callers can address them however they prefer.\n */\nexport function metadataRowFromColumns(\n recordId: StarkeepId,\n columns: Record<string, unknown>,\n): MetadataRow {\n const row: MetadataRow = { recordId };\n for (const [key, value] of Object.entries(columns)) {\n if (key === \"record_id\") continue;\n row[key] = value;\n }\n return row;\n}\n","import type { Query } from \"@starkeep/storage-adapter\";\nimport {\n DummyDriver,\n Kysely,\n SqliteAdapter,\n SqliteIntrospector,\n SqliteQueryCompiler,\n type ExpressionBuilder,\n type SelectQueryBuilder,\n} from \"kysely\";\n\n// External (camelCase) → column name (snake_case). Unknown fields pass through.\nconst FIELD_MAP: Record<string, string> = {\n id: \"id\",\n type: \"type\",\n createdAt: \"created_at\",\n updatedAt: \"updated_at\",\n ownerId: \"owner_id\",\n deletedAt: \"deleted_at\",\n version: \"version\",\n contentHash: \"content_hash\",\n objectStorageKey: \"object_storage_key\",\n mimeType: \"mime_type\",\n sizeBytes: \"size_bytes\",\n originAppId: \"origin_app_id\",\n parentId: \"parent_id\",\n originalFilename: \"original_filename\",\n};\n\nfunction mapField(field: string): string {\n return FIELD_MAP[field] ?? field;\n}\n\n// Single dynamic-schema Kysely instance used only to compile SQL — never\n// executes. The DummyDriver lets us reuse Kysely's compiler without pulling\n// in a real connection. `any` keeps it dialect-agnostic at the row level;\n// column names are validated against the live SQLite schema at runtime.\ntype DB = Record<string, Record<string, unknown>>;\nconst compiler = new Kysely<DB>({\n dialect: {\n createAdapter: () => new SqliteAdapter(),\n createDriver: () => new DummyDriver(),\n createIntrospector: (db) => new SqliteIntrospector(db),\n createQueryCompiler: () => new SqliteQueryCompiler(),\n },\n});\n\nexport interface BuiltQuery {\n sql: string;\n params: unknown[];\n}\n\nexport function buildSelectQuery(query: Query): BuiltQuery {\n type Qb = SelectQueryBuilder<DB, \"shared_records\", unknown>;\n let qb = compiler.selectFrom(\"shared_records\").selectAll() as Qb;\n\n if (query.type) {\n qb = qb.where(\"type\", \"=\", query.type);\n }\n\n if (query.filters) {\n for (const filter of query.filters) {\n qb = applyFilter(qb, filter);\n }\n }\n\n if (query.cursor) {\n qb = qb.where(\"id\", \">\", query.cursor);\n }\n\n if (query.sort && query.sort.length > 0) {\n for (const s of query.sort) {\n qb = qb.orderBy(mapField(s.field), s.direction === \"desc\" ? \"desc\" : \"asc\");\n }\n } else {\n qb = qb.orderBy(\"id\", \"asc\");\n }\n\n if (query.limit) {\n qb = qb.limit(query.limit + 1); // +1 to detect hasMore\n }\n\n const compiled = qb.compile();\n return { sql: compiled.sql, params: [...compiled.parameters] };\n}\n\nfunction applyFilter<Qb extends SelectQueryBuilder<DB, \"shared_records\", unknown>>(\n qb: Qb,\n filter: { field: string; operator: string; value?: unknown },\n): Qb {\n const col = mapField(filter.field);\n switch (filter.operator) {\n case \"eq\": return qb.where(col, \"=\", filter.value) as Qb;\n case \"neq\": return qb.where(col, \"!=\", filter.value) as Qb;\n case \"gt\": return qb.where(col, \">\", filter.value) as Qb;\n case \"gte\": return qb.where(col, \">=\", filter.value) as Qb;\n case \"lt\": return qb.where(col, \"<\", filter.value) as Qb;\n case \"lte\": return qb.where(col, \"<=\", filter.value) as Qb;\n case \"in\": return qb.where(col, \"in\", filter.value as unknown[]) as Qb;\n case \"like\": return qb.where(col, \"like\", `%${filter.value}%`) as Qb;\n case \"isNull\":\n return qb.where((eb: ExpressionBuilder<DB, \"shared_records\">) => eb(col, \"is\", null)) as Qb;\n case \"isNotNull\":\n return qb.where((eb: ExpressionBuilder<DB, \"shared_records\">) => eb(col, \"is not\", null)) as Qb;\n default: return qb;\n }\n}\n","import type { DatabaseSync } from \"node:sqlite\";\nimport { CATEGORIES, sqliteMetadataDdl } from \"@starkeep/protocol-primitives\";\n\n/**\n * Local sqlite schema bootstrap.\n *\n * Layout follows desired-state-roles-and-permissions.md \"DSQL DDL ... Local\n * SQLite asymmetry\" section: prefix-named tables in one file instead of\n * separate schemas. Only tables that something in phase 1 actually reads or\n * writes are created here — promotion, metadata enrichment, and the janitor\n * land as separate workstreams with their own DDL.\n *\n * - shared_records — all shared data, all types (file-backed only)\n * - shared_record_<category>_metadata — per-category metadata rows (typed columns)\n * - shared_access_grants — per-app, per-extension permissions\n * - shared_app_registry — installed apps + HMAC secrets\n * - shared_app_install_steps — idempotent install/uninstall ledger\n * - access_policies — control-plane: AccessControlEngine policies\n *\n * `sharing_tokens` is not persisted anywhere today — local uses the disabled\n * stub store and no cloud-side table or endpoint exists. The redemption path\n * is left for a future workstream.\n *\n * No migration system: this is a fresh-start schema. The user removes\n * ~/.starkeep/data.db (or the local-data-server's STARKEEP_DIR is fresh)\n * before this code runs.\n */\nexport function initializeLocalSchema(db: DatabaseSync): void {\n db.exec(\"PRAGMA journal_mode = WAL\");\n db.exec(\"PRAGMA foreign_keys = ON\");\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_records (\n id TEXT PRIMARY KEY,\n type TEXT NOT NULL,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL,\n owner_id TEXT NOT NULL,\n deleted_at TEXT,\n version INTEGER NOT NULL DEFAULT 1,\n content_hash TEXT NOT NULL,\n object_storage_key TEXT NOT NULL,\n mime_type TEXT NOT NULL,\n size_bytes INTEGER NOT NULL,\n original_filename TEXT,\n origin_app_id TEXT NOT NULL,\n parent_id TEXT\n )\n `);\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_records_type ON shared_records(type)\");\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_records_origin_app ON shared_records(origin_app_id)\");\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_records_parent_id ON shared_records(parent_id)\");\n // Duplicate-file prevention: (filename + bytes) is unique per owner among\n // live records. Tombstoned rows (deleted_at IS NOT NULL) are excluded so a\n // re-upload after delete is allowed. Records with NULL filename are not\n // constrained — the rule requires both filename and content to match.\n db.exec(\n \"CREATE UNIQUE INDEX IF NOT EXISTS uq_shared_records_owner_filename_hash \" +\n \"ON shared_records(owner_id, original_filename, content_hash) \" +\n \"WHERE deleted_at IS NULL AND original_filename IS NOT NULL\",\n );\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_access_grants (\n app_id TEXT NOT NULL,\n type_id TEXT NOT NULL,\n access TEXT NOT NULL CHECK (access IN ('read', 'readwrite')),\n metadata_write INTEGER NOT NULL DEFAULT 0,\n created_at TEXT NOT NULL DEFAULT (datetime('now')),\n PRIMARY KEY (app_id, type_id)\n )\n `);\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_access_grants_app ON shared_access_grants(app_id)\");\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_app_registry (\n app_id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n version TEXT NOT NULL,\n tier TEXT NOT NULL DEFAULT 'app',\n manifest TEXT NOT NULL,\n status TEXT NOT NULL DEFAULT 'installing',\n hmac_secret TEXT NOT NULL,\n installed_at TEXT NOT NULL DEFAULT (datetime('now')),\n updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n )\n `);\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_app_install_steps (\n app_id TEXT NOT NULL,\n operation TEXT NOT NULL CHECK (operation IN ('install', 'uninstall')),\n step TEXT NOT NULL,\n status TEXT NOT NULL CHECK (status IN ('pending', 'done', 'failed')),\n error TEXT,\n updated_at TEXT NOT NULL DEFAULT (datetime('now')),\n PRIMARY KEY (app_id, operation, step)\n )\n `);\n\n // App-specific syncable namespace registry. One row per installed app that\n // declared `infraRequirements.appSpecificSyncable`. Lists the tables the\n // installer materialized as `<app_id>_syncable_<name>` and whether the app\n // opted into the `apps/<app_id>/syncable/` file prefix. Read by the SDK to\n // gate row CRUD/file ops and by the sync engine to enumerate what to sync.\n db.exec(`\n CREATE TABLE IF NOT EXISTS app_syncable_namespaces (\n app_id TEXT PRIMARY KEY,\n tables_json TEXT NOT NULL,\n files_enabled INTEGER NOT NULL DEFAULT 0,\n created_at TEXT NOT NULL DEFAULT (datetime('now'))\n )\n `);\n\n // Control-plane: access policies issued via sdk.accessControl.createPolicy.\n // Instance-local; never synced. See AccessControlEngine.\n db.exec(`\n CREATE TABLE IF NOT EXISTS access_policies (\n policy_id TEXT PRIMARY KEY,\n subject_type TEXT NOT NULL,\n subject_id TEXT NOT NULL,\n resource_type TEXT NOT NULL,\n resource_id TEXT NOT NULL,\n permissions TEXT NOT NULL,\n granted_at TEXT NOT NULL,\n expires_at TEXT\n )\n `);\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_access_policies_subject ON access_policies(subject_type, subject_id)\");\n\n // Per-category metadata tables on parity with DSQL. Generated from CATEGORIES\n // so adding a category or a column is a single edit in @starkeep/protocol-primitives's\n // core-types.ts. `other` has no metadata columns and gets no table.\n for (const c of CATEGORIES) {\n if (c.id === \"other\") continue;\n db.exec(sqliteMetadataDdl(c));\n }\n}\n","import type { DatabaseSync } from \"node:sqlite\";\nimport {\n createStarkeepId,\n deserializeHLC,\n serializeHLC,\n type StarkeepId,\n} from \"@starkeep/protocol-primitives\";\nimport type {\n AccessPolicy,\n AccessPolicyStore,\n Permission,\n ResourceType,\n SubjectType,\n} from \"@starkeep/access-control\";\n\n/**\n * SQLite-backed AccessPolicyStore. Schema is bootstrapped in\n * storage-sqlite/src/schema/bootstrap.ts. Permissions are stored as a\n * comma-separated string — never user-supplied, always picked from the\n * Permission enum so no escaping is required.\n */\nexport function createSqliteAccessPolicyStore(db: DatabaseSync): AccessPolicyStore {\n return {\n async putPolicy(policy: AccessPolicy): Promise<void> {\n db.prepare(\n `INSERT INTO access_policies (\n policy_id, subject_type, subject_id, resource_type, resource_id,\n permissions, granted_at, expires_at\n ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)\n ON CONFLICT(policy_id) DO UPDATE SET\n subject_type = excluded.subject_type,\n subject_id = excluded.subject_id,\n resource_type = excluded.resource_type,\n resource_id = excluded.resource_id,\n permissions = excluded.permissions,\n granted_at = excluded.granted_at,\n expires_at = excluded.expires_at`,\n ).run(\n policy.policyId,\n policy.subjectType,\n policy.subjectId,\n policy.resourceType,\n policy.resourceId,\n policy.permissions.join(\",\"),\n serializeHLC(policy.grantedAt),\n policy.expiresAt ? serializeHLC(policy.expiresAt) : null,\n );\n },\n\n async getPolicy(policyId: StarkeepId): Promise<AccessPolicy | null> {\n const row = db\n .prepare(\"SELECT * FROM access_policies WHERE policy_id = ?\")\n .get(policyId) as PolicyRow | undefined;\n return row ? rowToPolicy(row) : null;\n },\n\n async listPolicies(): Promise<AccessPolicy[]> {\n const rows = db.prepare(\"SELECT * FROM access_policies\").all() as unknown as PolicyRow[];\n return rows.map(rowToPolicy);\n },\n\n async deletePolicy(policyId: StarkeepId): Promise<void> {\n db.prepare(\"DELETE FROM access_policies WHERE policy_id = ?\").run(policyId);\n },\n };\n}\n\ninterface PolicyRow {\n policy_id: string;\n subject_type: string;\n subject_id: string;\n resource_type: string;\n resource_id: string;\n permissions: string;\n granted_at: string;\n expires_at: string | null;\n}\n\nfunction rowToPolicy(row: PolicyRow): AccessPolicy {\n return {\n policyId: createStarkeepId(row.policy_id),\n subjectType: row.subject_type as SubjectType,\n subjectId: row.subject_id,\n resourceType: row.resource_type as ResourceType,\n resourceId: row.resource_id,\n permissions: row.permissions.split(\",\").filter(Boolean) as Permission[],\n grantedAt: deserializeHLC(row.granted_at),\n expiresAt: row.expires_at ? deserializeHLC(row.expires_at) : null,\n };\n}\n\n","import type { DatabaseSync } from \"node:sqlite\";\nimport type {\n AppSyncableNamespace,\n AppSyncableTableInfo,\n AppSyncableNamespaceStore,\n} from \"@starkeep/shared-space-api\";\n\nexport type { AppSyncableNamespace, AppSyncableTableInfo };\n\n// `<appId>_syncable_<table>` is what the manifest convention pins, but appIds\n// may contain dashes (e.g. \"cloud-data-server\") which aren't legal SQLite\n// identifiers. Normalize the same way as cloud-side PG roles.\nfunction normalizeAppId(appId: string): string {\n return appId.toLowerCase().replace(/-/g, \"_\");\n}\n\nexport function appSyncableTableName(appId: string, tableName: string): string {\n return `${normalizeAppId(appId)}_syncable_${tableName}`;\n}\n\nfunction rowToNamespace(r: {\n app_id: string;\n tables_json: string;\n files_enabled: number;\n}): AppSyncableNamespace {\n const tables: AppSyncableTableInfo[] = JSON.parse(r.tables_json);\n return {\n appId: r.app_id,\n tables,\n filesEnabled: r.files_enabled === 1,\n tableNames: tables.map((t) => t.name),\n };\n}\n\nexport function upsertAppSyncableNamespace(\n db: DatabaseSync,\n appId: string,\n tables: AppSyncableTableInfo[],\n filesEnabled: boolean,\n): void {\n db.prepare(\n `INSERT INTO app_syncable_namespaces (app_id, tables_json, files_enabled)\n VALUES (?, ?, ?)\n ON CONFLICT(app_id) DO UPDATE SET\n tables_json = excluded.tables_json,\n files_enabled = excluded.files_enabled`,\n ).run(appId, JSON.stringify(tables), filesEnabled ? 1 : 0);\n}\n\nexport function deleteAppSyncableNamespace(db: DatabaseSync, appId: string): void {\n db.prepare(\"DELETE FROM app_syncable_namespaces WHERE app_id = ?\").run(appId);\n}\n\nexport function getAppSyncableNamespace(\n db: DatabaseSync,\n appId: string,\n): AppSyncableNamespace | null {\n const row = db\n .prepare(\n \"SELECT app_id, tables_json, files_enabled FROM app_syncable_namespaces WHERE app_id = ?\",\n )\n .get(appId) as { app_id: string; tables_json: string; files_enabled: number } | undefined;\n if (!row) return null;\n return rowToNamespace(row);\n}\n\nexport function listAppSyncableNamespaces(db: DatabaseSync): AppSyncableNamespace[] {\n const rows = db\n .prepare(\n \"SELECT app_id, tables_json, files_enabled FROM app_syncable_namespaces\",\n )\n .all() as Array<{ app_id: string; tables_json: string; files_enabled: number }>;\n return rows.map(rowToNamespace);\n}\n\n/**\n * Object-oriented wrapper over the free functions above — implements the\n * `AppSyncableNamespaceStore` interface required by `createAppSpecificFactory`\n * and the sync applier.\n */\nexport class SqliteAppSyncableNamespaceStore implements AppSyncableNamespaceStore {\n constructor(private readonly db: DatabaseSync) {}\n\n get(appId: string): AppSyncableNamespace | null {\n return getAppSyncableNamespace(this.db, appId);\n }\n\n list(): AppSyncableNamespace[] {\n return listAppSyncableNamespaces(this.db);\n }\n}\n","import type { DatabaseSync } from \"node:sqlite\";\nimport { serializeHLC, deserializeHLC } from \"@starkeep/protocol-primitives\";\nimport type { AppSyncableApplier, AppSyncableRowEntry, AppSyncableNamespaceStore, ScanCapableApplier, ScanSinceOptions, ScanSincePage } from \"@starkeep/shared-space-api\";\nimport { appSyncableTableName } from \"./namespace.js\";\n\n/**\n * SQLite-backed implementation of `AppSyncableApplier`.\n *\n * All writes use the LWW (last-write-wins) rule based on the HLC-serialized\n * `updated_at` column: an incoming entry is only applied if its timestamp is\n * strictly greater than the row's current `updated_at`. This makes the applier\n * idempotent — replaying the same entry twice is a no-op.\n *\n * Delete is soft: the `deleted_at` column is set rather than removing the row\n * so that the inline-HLC pull path can propagate tombstones to other clients.\n */\nexport class SqliteAppSyncableApplier\n implements AppSyncableApplier, ScanCapableApplier\n{\n constructor(\n private readonly db: DatabaseSync,\n private readonly namespace: AppSyncableNamespaceStore,\n ) {}\n\n apply(entry: AppSyncableRowEntry): void {\n const ns = this.namespace.get(entry.appId);\n if (!ns) {\n throw new Error(\n `SqliteAppSyncableApplier: app \"${entry.appId}\" not installed`,\n );\n }\n const tableInfo = ns.tables.find((t) => t.name === entry.table);\n if (!tableInfo) {\n throw new Error(\n `SqliteAppSyncableApplier: table \"${entry.table}\" not declared for app \"${entry.appId}\"`,\n );\n }\n\n const fullName = appSyncableTableName(entry.appId, entry.table);\n const { pkColumns } = tableInfo;\n\n if (entry.op === \"insert\") {\n this.applyInsert(fullName, pkColumns, entry);\n } else if (entry.op === \"update\") {\n this.applyUpdate(fullName, entry);\n } else {\n this.applyDelete(fullName, entry);\n }\n }\n\n private applyInsert(\n fullName: string,\n pkColumns: string[],\n entry: AppSyncableRowEntry,\n ): void {\n const row = entry.row ?? {};\n const cols = Object.keys(row);\n if (cols.length === 0) return;\n\n const colList = cols.map(q).join(\", \");\n const placeholders = cols.map(() => \"?\").join(\", \");\n const values = cols.map((c) => row[c] as unknown);\n\n if (pkColumns.length === 0) {\n // No PK declared — just insert, ignoring duplicates.\n this.db\n .prepare(`INSERT OR IGNORE INTO ${q(fullName)} (${colList}) VALUES (${placeholders})`)\n .run(...(values as never[]));\n return;\n }\n\n // UPSERT with LWW: only overwrite if the incoming updated_at is newer.\n const conflictTarget = pkColumns.map(q).join(\", \");\n const updateCols = cols.filter((c) => !pkColumns.includes(c));\n if (updateCols.length === 0) {\n this.db\n .prepare(\n `INSERT OR IGNORE INTO ${q(fullName)} (${colList}) VALUES (${placeholders})`,\n )\n .run(...(values as never[]));\n return;\n }\n const setClause = updateCols.map((c) => `${q(c)} = excluded.${q(c)}`).join(\", \");\n this.db\n .prepare(\n `INSERT INTO ${q(fullName)} (${colList}) VALUES (${placeholders})\n ON CONFLICT(${conflictTarget}) DO UPDATE SET ${setClause}\n WHERE excluded.updated_at > ${q(fullName)}.updated_at`,\n )\n .run(...(values as never[]));\n }\n\n private applyUpdate(fullName: string, entry: AppSyncableRowEntry): void {\n const patch = entry.row ?? {};\n const where = entry.where ?? {};\n const patchCols = Object.keys(patch);\n const whereCols = Object.keys(where);\n if (patchCols.length === 0) return;\n\n const setClause = patchCols.map((c) => `${q(c)} = ?`).join(\", \");\n // Only apply if the incoming updated_at is strictly newer (LWW).\n const incomingUpdatedAt = patch[\"updated_at\"] as string | undefined;\n const conditions: string[] = whereCols.map((c) => `${q(c)} = ?`);\n if (incomingUpdatedAt) conditions.push(`updated_at < ?`);\n const whereClause = conditions.length ? \" WHERE \" + conditions.join(\" AND \") : \"\";\n\n const params: unknown[] = [\n ...patchCols.map((c) => patch[c]),\n ...whereCols.map((c) => where[c]),\n ];\n if (incomingUpdatedAt) params.push(incomingUpdatedAt);\n\n this.db\n .prepare(`UPDATE ${q(fullName)} SET ${setClause}${whereClause}`)\n .run(...(params as never[]));\n }\n\n private applyDelete(fullName: string, entry: AppSyncableRowEntry): void {\n const where = entry.where ?? {};\n const whereCols = Object.keys(where);\n // Soft-delete: set deleted_at and updated_at.\n const incomingUpdatedAt = entry.row?.[\"updated_at\"] as string | undefined;\n const ts = incomingUpdatedAt ?? serializeHLC(entry.timestamp);\n\n const conditions: string[] = [\n ...whereCols.map((c) => `${q(c)} = ?`),\n `(updated_at IS NULL OR updated_at < ?)`,\n ];\n const whereClause = \" WHERE \" + conditions.join(\" AND \");\n\n // params order: SET deleted_at=?, updated_at=?, then WHERE bindings\n const params: unknown[] = [\n ts,\n ts,\n ...whereCols.map((c) => where[c]),\n ts, // for the LWW updated_at < ? condition\n ];\n\n this.db\n .prepare(\n `UPDATE ${q(fullName)} SET deleted_at = ?, updated_at = ?${whereClause}`,\n )\n .run(...(params as never[]));\n }\n\n /**\n * Pull-side synthesis: return rows updated after `sinceHlcStr` (or `cursor`\n * if higher) in HLC order, paginated. `updated_at` is a serialized HLC\n * whose lexicographic order matches HLC order (fixed-width hex), and each\n * row's HLC is unique per node, so it doubles as the cursor — no separate\n * tiebreaker column is needed.\n */\n async scanSince(\n appId: string,\n table: string,\n sinceHlcStr: string,\n options?: ScanSinceOptions,\n ): Promise<ScanSincePage> {\n const fullName = appSyncableTableName(appId, table);\n const floor =\n options?.cursor !== undefined && options.cursor > sinceHlcStr\n ? options.cursor\n : sinceHlcStr;\n const limit = options?.limit;\n let rows: Record<string, unknown>[];\n try {\n if (limit !== undefined) {\n rows = this.db\n .prepare(\n `SELECT * FROM ${q(fullName)} WHERE updated_at > ? ORDER BY updated_at ASC LIMIT ?`,\n )\n .all(floor, limit + 1) as Record<string, unknown>[];\n } else {\n rows = this.db\n .prepare(\n `SELECT * FROM ${q(fullName)} WHERE updated_at > ? ORDER BY updated_at ASC`,\n )\n .all(floor) as Record<string, unknown>[];\n }\n } catch {\n // Table might not exist yet (app not installed locally).\n return { rows: [], nextCursor: null, hasMore: false };\n }\n const hasMore = limit !== undefined && rows.length > limit;\n const pageRows = hasMore ? rows.slice(0, limit) : rows;\n const entries = pageRows.map((row) => rowToEntry(appId, table, row));\n const nextCursor =\n hasMore && pageRows.length > 0\n ? (pageRows[pageRows.length - 1]![\"updated_at\"] as string)\n : null;\n return { rows: entries, nextCursor, hasMore };\n }\n\n /** Support read path from the factory's queryRows. */\n queryRows(\n appId: string,\n table: string,\n where?: Record<string, unknown>,\n ): Record<string, unknown>[] {\n const fullName = appSyncableTableName(appId, table);\n const whereCols = where ? Object.keys(where) : [];\n // Filter out soft-deleted rows by default.\n const whereClause = [\n \"deleted_at IS NULL\",\n ...whereCols.map((c) => `${q(c)} = ?`),\n ].join(\" AND \");\n return this.db\n .prepare(`SELECT * FROM ${q(fullName)} WHERE ${whereClause}`)\n .all(...(whereCols.map((c) => where![c]) as never[])) as Record<string, unknown>[];\n }\n}\n\nfunction q(name: string): string {\n return `\"${name}\"`;\n}\n\nfunction rowToEntry(\n appId: string,\n table: string,\n row: Record<string, unknown>,\n): AppSyncableRowEntry {\n const updatedAtStr = row[\"updated_at\"] as string;\n const deletedAtStr = row[\"deleted_at\"] as string | null | undefined;\n const timestamp = deserializeHLC(updatedAtStr);\n\n // For wire propagation we emit op=\"insert\" (upsert) for live rows so the\n // receiver creates the row if it doesn't exist yet. op=\"update\" only\n // targets existing rows and would silently drop new rows during initial\n // sync. Tombstones still ride the soft-delete path.\n if (deletedAtStr) {\n return { timestamp, appId, table, op: \"delete\", row };\n }\n return { timestamp, appId, table, op: \"insert\", row };\n}\n"],"mappings":"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","names":["import_protocol_primitives","import_protocol_primitives","import_protocol_primitives","import_protocol_primitives"]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/adapter.ts","../src/serialization.ts","../src/query-builder.ts","../src/schema/bootstrap.ts","../src/app-syncable/namespace.ts","../src/app-syncable/apply.ts"],"sourcesContent":["export { SqliteDatabaseAdapter } from \"./adapter.js\";\nexport type { SqliteDatabaseAdapterOptions } from \"./adapter.js\";\nexport { initializeLocalSchema } from \"./schema/bootstrap.js\";\nexport {\n appSyncableTableName,\n getAppSyncableNamespace,\n upsertAppSyncableNamespace,\n deleteAppSyncableNamespace,\n listAppSyncableNamespaces,\n SqliteAppSyncableNamespaceStore,\n} from \"./app-syncable/namespace.js\";\nexport type { AppSyncableNamespace, AppSyncableTableInfo } from \"./app-syncable/namespace.js\";\nexport { SqliteAppSyncableApplier } from \"./app-syncable/apply.js\";\n","import { DatabaseSync } from \"node:sqlite\";\nimport { mkdirSync, existsSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport type { DataRecord, HLCTimestamp, MetadataRow, StarkeepId } from \"@starkeep/protocol-primitives\";\nimport { serializeHLC, deserializeHLC, sqliteMetadataTableName } from \"@starkeep/protocol-primitives\";\nimport type {\n DatabaseAdapter,\n Query,\n QueryResult,\n BatchOperation,\n Transaction,\n} from \"@starkeep/storage-adapter\";\nimport { StorageError, TransactionError } from \"@starkeep/storage-adapter\";\nimport { recordToRow, rowToRecord, type SqliteRow } from \"./serialization.js\";\nimport { buildSelectQuery } from \"./query-builder.js\";\nimport { initializeLocalSchema } from \"./schema/bootstrap.js\";\n\nexport interface SqliteDatabaseAdapterOptions {\n path: string | \":memory:\";\n}\n\nexport class SqliteDatabaseAdapter implements DatabaseAdapter {\n private database: DatabaseSync | null = null;\n private readonly options: SqliteDatabaseAdapterOptions;\n\n constructor(options: SqliteDatabaseAdapterOptions) {\n this.options = options;\n }\n\n async init(): Promise<void> {\n if (this.database) return;\n if (this.options.path !== \":memory:\") {\n const dir = dirname(this.options.path);\n if (!existsSync(dir)) {\n mkdirSync(dir, { recursive: true });\n }\n }\n this.database = new DatabaseSync(this.options.path);\n initializeLocalSchema(this.database);\n }\n\n async close(): Promise<void> {\n this.database?.close();\n this.database = null;\n }\n\n async healthCheck(): Promise<boolean> {\n if (!this.database) return false;\n try {\n this.database.prepare(\"SELECT 1\").get();\n return true;\n } catch {\n return false;\n }\n }\n\n private getDatabase(): DatabaseSync {\n if (!this.database) throw new StorageError(\"Database not initialized. Call init() first.\");\n return this.database;\n }\n\n /**\n * Returns the raw SQLite connection so sibling subsystems (e.g. the sync\n * engine's change log + state store) can create side tables in the same\n * database file. Callers must only use this after `init()`.\n */\n getRawDatabase(): DatabaseSync {\n return this.getDatabase();\n }\n\n private runStmt(sql: string, ...params: unknown[]): void {\n this.getDatabase().prepare(sql).run(...(params as Parameters<ReturnType<DatabaseSync[\"prepare\"]>[\"run\"]>));\n }\n\n private getRow<T = SqliteRow>(sql: string, ...params: unknown[]): T | undefined {\n return this.getDatabase().prepare(sql).get(\n ...(params as Parameters<ReturnType<DatabaseSync[\"prepare\"]>[\"get\"]>),\n ) as unknown as T | undefined;\n }\n\n private allRows<T = SqliteRow>(sql: string, ...params: unknown[]): T[] {\n return this.getDatabase().prepare(sql).all(\n ...(params as Parameters<ReturnType<DatabaseSync[\"prepare\"]>[\"all\"]>),\n ) as unknown as T[];\n }\n\n async put(record: DataRecord): Promise<void> {\n const row = recordToRow(record);\n const columns = Object.keys(row);\n const placeholders = columns.map(() => \"?\").join(\", \");\n const updates = columns\n .filter((column) => column !== \"id\")\n .map((column) => `${column} = excluded.${column}`)\n .join(\", \");\n const sql = `INSERT INTO shared_records (${columns.join(\", \")}) VALUES (${placeholders}) ON CONFLICT(id) DO UPDATE SET ${updates}`;\n this.runStmt(sql, ...Object.values(row));\n }\n\n async get(id: StarkeepId): Promise<DataRecord | null> {\n const row = this.getRow<SqliteRow>(\"SELECT * FROM shared_records WHERE id = ?\", id);\n return row ? rowToRecord(row) : null;\n }\n\n async delete(id: StarkeepId, hlc: HLCTimestamp): Promise<void> {\n const ts = serializeHLC(hlc);\n this.runStmt(\n \"UPDATE shared_records SET deleted_at = ?, updated_at = ?, node_id = ? WHERE id = ?\",\n ts,\n ts,\n hlc.nodeId,\n id,\n );\n }\n\n async getNodeWatermarks(): Promise<Record<string, HLCTimestamp>> {\n // Within one node_id group, updated_at is fixed-width hex up to the\n // nodeId suffix, so lexicographic MAX equals HLC MAX. The\n // (node_id, updated_at) index makes this an index-only scan.\n const rows = this.allRows<{ node_id: string; max_updated_at: string }>(\n \"SELECT node_id, MAX(updated_at) AS max_updated_at FROM shared_records GROUP BY node_id\",\n );\n const out: Record<string, HLCTimestamp> = {};\n for (const row of rows) {\n out[row.node_id] = deserializeHLC(row.max_updated_at);\n }\n return out;\n }\n\n async query(query: Query): Promise<QueryResult> {\n const { sql, params } = buildSelectQuery(query);\n const rows = this.allRows<SqliteRow>(sql, ...params);\n\n const limit = query.limit;\n const hasMore = limit ? rows.length > limit : false;\n const resultRows = hasMore ? rows.slice(0, limit) : rows;\n\n return {\n records: resultRows.map(rowToRecord),\n nextCursor: hasMore ? resultRows[resultRows.length - 1].id : null,\n hasMore,\n };\n }\n\n async batch(operations: BatchOperation[]): Promise<void> {\n this.getDatabase().exec(\"BEGIN\");\n try {\n for (const operation of operations) {\n if (operation.type === \"put\") {\n await this.put(operation.record);\n } else {\n await this.delete(operation.id, operation.hlc);\n }\n }\n this.getDatabase().exec(\"COMMIT\");\n } catch (error) {\n this.getDatabase().exec(\"ROLLBACK\");\n throw error;\n }\n }\n\n async transaction<T>(callback: (transaction: Transaction) => Promise<T>): Promise<T> {\n this.getDatabase().exec(\"SAVEPOINT starkeep_tx\");\n try {\n const transaction: Transaction = {\n put: async (record) => this.put(record),\n get: async (id) => this.get(id),\n delete: async (id, hlc) => this.delete(id, hlc),\n query: async (query) => this.query(query),\n };\n const result = await callback(transaction);\n this.getDatabase().exec(\"RELEASE SAVEPOINT starkeep_tx\");\n return result;\n } catch (error) {\n this.getDatabase().exec(\"ROLLBACK TO SAVEPOINT starkeep_tx\");\n this.getDatabase().exec(\"RELEASE SAVEPOINT starkeep_tx\");\n throw new TransactionError(\"Transaction failed\", error);\n }\n }\n\n async putMetadata(typeId: string, row: MetadataRow): Promise<void> {\n const table = sqliteMetadataTableName(typeId);\n const cols: string[] = [\"record_id\"];\n const values: unknown[] = [row.recordId];\n for (const [key, value] of Object.entries(row)) {\n if (key === \"recordId\") continue;\n cols.push(key);\n values.push(value);\n }\n const placeholders = cols.map(() => \"?\").join(\", \");\n const updates = cols\n .filter((c) => c !== \"record_id\")\n .map((c) => `${c} = excluded.${c}`)\n .join(\", \");\n const sql = updates\n ? `INSERT INTO ${table} (${cols.join(\", \")}) VALUES (${placeholders}) ON CONFLICT(record_id) DO UPDATE SET ${updates}`\n : `INSERT INTO ${table} (${cols.join(\", \")}) VALUES (${placeholders}) ON CONFLICT(record_id) DO NOTHING`;\n this.runStmt(sql, ...values);\n }\n\n async getMetadata(typeId: string, recordId: StarkeepId): Promise<MetadataRow | null> {\n const table = sqliteMetadataTableName(typeId);\n const row = this.getRow<Record<string, unknown>>(\n `SELECT * FROM ${table} WHERE record_id = ?`,\n recordId,\n );\n if (!row) return null;\n return columnsToMetadataRow(recordId, row);\n }\n\n async getMetadataByIds(\n typeId: string,\n recordIds: StarkeepId[],\n ): Promise<Map<StarkeepId, MetadataRow>> {\n const result = new Map<StarkeepId, MetadataRow>();\n if (recordIds.length === 0) return result;\n const table = sqliteMetadataTableName(typeId);\n const placeholders = recordIds.map(() => \"?\").join(\", \");\n const rows = this.allRows<Record<string, unknown>>(\n `SELECT * FROM ${table} WHERE record_id IN (${placeholders})`,\n ...recordIds,\n );\n for (const row of rows) {\n const recordId = row[\"record_id\"] as StarkeepId;\n result.set(recordId, columnsToMetadataRow(recordId, row));\n }\n return result;\n }\n\n async deleteMetadata(typeId: string, recordId: StarkeepId): Promise<void> {\n const table = sqliteMetadataTableName(typeId);\n this.runStmt(`DELETE FROM ${table} WHERE record_id = ?`, recordId);\n }\n\n}\n\nfunction columnsToMetadataRow(\n recordId: StarkeepId,\n columns: Record<string, unknown>,\n): MetadataRow {\n const row: MetadataRow = { recordId };\n for (const [key, value] of Object.entries(columns)) {\n if (key === \"record_id\") continue;\n row[key] = value;\n }\n return row;\n}\n","import type { DataRecord, MetadataRow, StarkeepId } from \"@starkeep/protocol-primitives\";\nimport { serializeHLC, deserializeHLC, createStarkeepId } from \"@starkeep/protocol-primitives\";\n\nexport interface SqliteRow {\n id: string;\n type: string;\n created_at: string;\n updated_at: string;\n /** Denormalized `updatedAt.nodeId`; must be rewritten with `updated_at`. */\n node_id: string;\n deleted_at: string | null;\n version: number;\n content_hash: string;\n object_storage_key: string;\n mime_type: string | null;\n size_bytes: number;\n original_filename: string | null;\n origin_app_id: string;\n parent_id: string | null;\n label: string | null;\n}\n\nexport function recordToRow(record: DataRecord): SqliteRow {\n return {\n id: record.id,\n type: record.type,\n created_at: serializeHLC(record.createdAt),\n updated_at: serializeHLC(record.updatedAt),\n node_id: record.updatedAt.nodeId,\n deleted_at: record.deletedAt ? serializeHLC(record.deletedAt) : null,\n version: record.version,\n content_hash: record.contentHash,\n object_storage_key: record.objectStorageKey,\n mime_type: record.mimeType,\n size_bytes: record.sizeBytes,\n original_filename: record.originalFilename,\n origin_app_id: record.originAppId,\n parent_id: record.parentId,\n label: record.label,\n };\n}\n\nexport function rowToRecord(row: SqliteRow): DataRecord {\n return {\n id: createStarkeepId(row.id),\n kind: \"data\",\n type: row.type,\n createdAt: deserializeHLC(row.created_at),\n updatedAt: deserializeHLC(row.updated_at),\n deletedAt: row.deleted_at ? deserializeHLC(row.deleted_at) : null,\n version: row.version,\n contentHash: row.content_hash,\n objectStorageKey: row.object_storage_key,\n mimeType: row.mime_type,\n sizeBytes: row.size_bytes,\n originalFilename: row.original_filename,\n originAppId: row.origin_app_id,\n parentId: row.parent_id ? createStarkeepId(row.parent_id) : null,\n label: row.label,\n };\n}\n\n/**\n * Convert SQLite column-keyed row data into a MetadataRow keyed by recordId\n * plus camelCase or snake_case columns. We pass columns through as-is from\n * the DB so callers can address them however they prefer.\n */\nexport function metadataRowFromColumns(\n recordId: StarkeepId,\n columns: Record<string, unknown>,\n): MetadataRow {\n const row: MetadataRow = { recordId };\n for (const [key, value] of Object.entries(columns)) {\n if (key === \"record_id\") continue;\n row[key] = value;\n }\n return row;\n}\n","import type { Query } from \"@starkeep/storage-adapter\";\nimport {\n DummyDriver,\n Kysely,\n SqliteAdapter,\n SqliteIntrospector,\n SqliteQueryCompiler,\n type ExpressionBuilder,\n type SelectQueryBuilder,\n} from \"kysely\";\n\n// External (camelCase) → column name (snake_case). Unknown fields pass through.\nconst FIELD_MAP: Record<string, string> = {\n id: \"id\",\n type: \"type\",\n createdAt: \"created_at\",\n updatedAt: \"updated_at\",\n deletedAt: \"deleted_at\",\n version: \"version\",\n contentHash: \"content_hash\",\n objectStorageKey: \"object_storage_key\",\n mimeType: \"mime_type\",\n sizeBytes: \"size_bytes\",\n originAppId: \"origin_app_id\",\n parentId: \"parent_id\",\n originalFilename: \"original_filename\",\n label: \"label\",\n};\n\nfunction mapField(field: string): string {\n return FIELD_MAP[field] ?? field;\n}\n\n// Single dynamic-schema Kysely instance used only to compile SQL — never\n// executes. The DummyDriver lets us reuse Kysely's compiler without pulling\n// in a real connection. `any` keeps it dialect-agnostic at the row level;\n// column names are validated against the live SQLite schema at runtime.\ntype DB = Record<string, Record<string, unknown>>;\nconst compiler = new Kysely<DB>({\n dialect: {\n createAdapter: () => new SqliteAdapter(),\n createDriver: () => new DummyDriver(),\n createIntrospector: (db) => new SqliteIntrospector(db),\n createQueryCompiler: () => new SqliteQueryCompiler(),\n },\n});\n\nexport interface BuiltQuery {\n sql: string;\n params: unknown[];\n}\n\nexport function buildSelectQuery(query: Query): BuiltQuery {\n type Qb = SelectQueryBuilder<DB, \"shared_records\", unknown>;\n let qb = compiler.selectFrom(\"shared_records\").selectAll() as Qb;\n\n if (query.type) {\n qb = qb.where(\"type\", \"=\", query.type);\n }\n\n if (query.filters) {\n for (const filter of query.filters) {\n qb = applyFilter(qb, filter);\n }\n }\n\n if (query.cursor) {\n qb = qb.where(\"id\", \">\", query.cursor);\n }\n\n if (query.sort && query.sort.length > 0) {\n for (const s of query.sort) {\n qb = qb.orderBy(mapField(s.field), s.direction === \"desc\" ? \"desc\" : \"asc\");\n }\n } else {\n qb = qb.orderBy(\"id\", \"asc\");\n }\n\n if (query.limit) {\n qb = qb.limit(query.limit + 1); // +1 to detect hasMore\n }\n\n const compiled = qb.compile();\n return { sql: compiled.sql, params: [...compiled.parameters] };\n}\n\nfunction applyFilter<Qb extends SelectQueryBuilder<DB, \"shared_records\", unknown>>(\n qb: Qb,\n filter: { field: string; operator: string; value?: unknown },\n): Qb {\n const col = mapField(filter.field);\n switch (filter.operator) {\n case \"eq\": return qb.where(col, \"=\", filter.value) as Qb;\n case \"neq\": return qb.where(col, \"!=\", filter.value) as Qb;\n case \"gt\": return qb.where(col, \">\", filter.value) as Qb;\n case \"gte\": return qb.where(col, \">=\", filter.value) as Qb;\n case \"lt\": return qb.where(col, \"<\", filter.value) as Qb;\n case \"lte\": return qb.where(col, \"<=\", filter.value) as Qb;\n case \"in\": return qb.where(col, \"in\", filter.value as unknown[]) as Qb;\n case \"like\": return qb.where(col, \"like\", `%${filter.value}%`) as Qb;\n case \"isNull\":\n return qb.where((eb: ExpressionBuilder<DB, \"shared_records\">) => eb(col, \"is\", null)) as Qb;\n case \"isNotNull\":\n return qb.where((eb: ExpressionBuilder<DB, \"shared_records\">) => eb(col, \"is not\", null)) as Qb;\n default: return qb;\n }\n}\n","import type { DatabaseSync } from \"node:sqlite\";\nimport { CATEGORIES, sqliteMetadataDdl } from \"@starkeep/protocol-primitives\";\n\n/**\n * Local sqlite schema bootstrap.\n *\n * Layout follows desired-state-roles-and-permissions.md \"DSQL DDL ... Local\n * SQLite asymmetry\" section: prefix-named tables in one file instead of\n * separate schemas. Only tables that something in phase 1 actually reads or\n * writes are created here — promotion, metadata enrichment, and the janitor\n * land as separate workstreams with their own DDL.\n *\n * - shared_records — all shared data, all types (file-backed only)\n * - shared_record_<category>_metadata — per-category metadata rows (typed columns)\n * - shared_access_grants — per-app, per-type permissions\n * - shared_app_registry — installed apps + HMAC secrets\n * - shared_app_install_steps — idempotent install/uninstall ledger\n *\n * No migration system: this is a fresh-start schema. The user removes\n * ~/.starkeep/data.db (or the local-data-server's STARKEEP_DIR is fresh)\n * before this code runs.\n */\nexport function initializeLocalSchema(db: DatabaseSync): void {\n db.exec(\"PRAGMA journal_mode = WAL\");\n db.exec(\"PRAGMA foreign_keys = ON\");\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_records (\n id TEXT PRIMARY KEY,\n type TEXT NOT NULL,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL,\n -- Denormalized from updated_at (its nodeId component) on every write.\n -- Feeds the sync responder's per-node coverage watermark via the\n -- (node_id, updated_at) index without scanning the table.\n node_id TEXT NOT NULL,\n deleted_at TEXT,\n version INTEGER NOT NULL DEFAULT 1,\n content_hash TEXT NOT NULL,\n object_storage_key TEXT NOT NULL,\n mime_type TEXT,\n size_bytes INTEGER NOT NULL,\n original_filename TEXT,\n origin_app_id TEXT NOT NULL,\n parent_id TEXT,\n -- Advisory appId/purpose interest-filter marker (e.g. photos/thumbnail);\n -- NULL = general interest. See DataRecord.label.\n label TEXT\n )\n `);\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_records_type ON shared_records(type)\");\n db.exec(\n \"CREATE INDEX IF NOT EXISTS idx_shared_records_node_watermark ON shared_records(node_id, updated_at)\",\n );\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_records_origin_app ON shared_records(origin_app_id)\");\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_records_parent_id ON shared_records(parent_id)\");\n // Duplicate-file prevention: (filename + bytes) is unique among live records.\n // Tombstoned rows (deleted_at IS NOT NULL) are excluded so a re-upload after\n // delete is allowed. Records with NULL filename are not constrained — the\n // rule requires both filename and content to match.\n db.exec(\n \"CREATE UNIQUE INDEX IF NOT EXISTS uq_shared_records_filename_hash \" +\n \"ON shared_records(original_filename, content_hash) \" +\n \"WHERE deleted_at IS NULL AND original_filename IS NOT NULL\",\n );\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_access_grants (\n app_id TEXT NOT NULL,\n type_id TEXT NOT NULL,\n access TEXT NOT NULL CHECK (access IN ('read', 'readwrite')),\n metadata_write INTEGER NOT NULL DEFAULT 0,\n created_at TEXT NOT NULL DEFAULT (datetime('now')),\n PRIMARY KEY (app_id, type_id)\n )\n `);\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_access_grants_app ON shared_access_grants(app_id)\");\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_app_registry (\n app_id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n version TEXT NOT NULL,\n tier TEXT NOT NULL DEFAULT 'app',\n manifest TEXT NOT NULL,\n status TEXT NOT NULL DEFAULT 'installing',\n hmac_secret TEXT NOT NULL,\n installed_at TEXT NOT NULL DEFAULT (datetime('now')),\n updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n )\n `);\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_app_install_steps (\n app_id TEXT NOT NULL,\n operation TEXT NOT NULL CHECK (operation IN ('install', 'uninstall')),\n step TEXT NOT NULL,\n status TEXT NOT NULL CHECK (status IN ('pending', 'done', 'failed')),\n error TEXT,\n updated_at TEXT NOT NULL DEFAULT (datetime('now')),\n PRIMARY KEY (app_id, operation, step)\n )\n `);\n\n // App-specific syncable namespace registry. One row per installed app that\n // declared `infraRequirements.appSpecificSyncable`. Lists the tables the\n // installer materialized as `<app_id>_syncable_<name>` and whether the app\n // opted into the `apps/<app_id>/syncable/` file prefix. Read by the SDK to\n // gate row CRUD/file ops and by the sync engine to enumerate what to sync.\n db.exec(`\n CREATE TABLE IF NOT EXISTS app_syncable_namespaces (\n app_id TEXT PRIMARY KEY,\n tables_json TEXT NOT NULL,\n files_enabled INTEGER NOT NULL DEFAULT 0,\n created_at TEXT NOT NULL DEFAULT (datetime('now'))\n )\n `);\n\n // Per-category metadata tables on parity with DSQL. Generated from CATEGORIES\n // so adding a category or a column is a single edit in @starkeep/protocol-primitives's\n // core-types.ts. `other` has no metadata columns and gets no table.\n for (const c of CATEGORIES) {\n if (c.id === \"other\") continue;\n db.exec(sqliteMetadataDdl(c));\n }\n}\n","import type { DatabaseSync } from \"node:sqlite\";\nimport type {\n AppSyncableNamespace,\n AppSyncableTableInfo,\n AppSyncableNamespaceStore,\n} from \"@starkeep/shared-space-api\";\n\nexport type { AppSyncableNamespace, AppSyncableTableInfo };\n\n// `<appId>_syncable_<table>` is what the manifest convention pins, but appIds\n// may contain dashes (e.g. \"cloud-data-server\") which aren't legal SQLite\n// identifiers. Normalize the same way as cloud-side PG roles.\nfunction normalizeAppId(appId: string): string {\n return appId.toLowerCase().replace(/-/g, \"_\");\n}\n\nexport function appSyncableTableName(appId: string, tableName: string): string {\n return `${normalizeAppId(appId)}_syncable_${tableName}`;\n}\n\nfunction rowToNamespace(r: {\n app_id: string;\n tables_json: string;\n files_enabled: number;\n}): AppSyncableNamespace {\n const tables: AppSyncableTableInfo[] = JSON.parse(r.tables_json);\n return {\n appId: r.app_id,\n tables,\n filesEnabled: r.files_enabled === 1,\n tableNames: tables.map((t) => t.name),\n };\n}\n\nexport function upsertAppSyncableNamespace(\n db: DatabaseSync,\n appId: string,\n tables: AppSyncableTableInfo[],\n filesEnabled: boolean,\n): void {\n db.prepare(\n `INSERT INTO app_syncable_namespaces (app_id, tables_json, files_enabled)\n VALUES (?, ?, ?)\n ON CONFLICT(app_id) DO UPDATE SET\n tables_json = excluded.tables_json,\n files_enabled = excluded.files_enabled`,\n ).run(appId, JSON.stringify(tables), filesEnabled ? 1 : 0);\n}\n\nexport function deleteAppSyncableNamespace(db: DatabaseSync, appId: string): void {\n db.prepare(\"DELETE FROM app_syncable_namespaces WHERE app_id = ?\").run(appId);\n}\n\nexport function getAppSyncableNamespace(\n db: DatabaseSync,\n appId: string,\n): AppSyncableNamespace | null {\n const row = db\n .prepare(\n \"SELECT app_id, tables_json, files_enabled FROM app_syncable_namespaces WHERE app_id = ?\",\n )\n .get(appId) as { app_id: string; tables_json: string; files_enabled: number } | undefined;\n if (!row) return null;\n return rowToNamespace(row);\n}\n\nexport function listAppSyncableNamespaces(db: DatabaseSync): AppSyncableNamespace[] {\n const rows = db\n .prepare(\n \"SELECT app_id, tables_json, files_enabled FROM app_syncable_namespaces\",\n )\n .all() as Array<{ app_id: string; tables_json: string; files_enabled: number }>;\n return rows.map(rowToNamespace);\n}\n\n/**\n * Object-oriented wrapper over the free functions above — implements the\n * `AppSyncableNamespaceStore` interface required by `createAppSpecificFactory`\n * and the sync applier.\n */\nexport class SqliteAppSyncableNamespaceStore implements AppSyncableNamespaceStore {\n constructor(private readonly db: DatabaseSync) {}\n\n get(appId: string): AppSyncableNamespace | null {\n return getAppSyncableNamespace(this.db, appId);\n }\n\n list(): AppSyncableNamespace[] {\n return listAppSyncableNamespaces(this.db);\n }\n}\n","import type { DatabaseSync } from \"node:sqlite\";\nimport type { HLCTimestamp } from \"@starkeep/protocol-primitives\";\nimport { serializeHLC, deserializeHLC } from \"@starkeep/protocol-primitives\";\nimport type { AppSyncableApplier, AppSyncableRowEntry, AppSyncableNamespaceStore, ScanCapableApplier, ScanSinceOptions, ScanSincePage } from \"@starkeep/shared-space-api\";\nimport { appSyncableTableName } from \"./namespace.js\";\n\n/**\n * SQLite-backed implementation of `AppSyncableApplier`.\n *\n * All writes use the LWW (last-write-wins) rule based on the HLC-serialized\n * `updated_at` column: an incoming entry is only applied if its timestamp is\n * strictly greater than the row's current `updated_at`. This makes the applier\n * idempotent — replaying the same entry twice is a no-op.\n *\n * Delete is soft: the `deleted_at` column is set rather than removing the row\n * so that the inline-HLC pull path can propagate tombstones to other clients.\n */\nexport class SqliteAppSyncableApplier\n implements AppSyncableApplier, ScanCapableApplier\n{\n constructor(\n private readonly db: DatabaseSync,\n private readonly namespace: AppSyncableNamespaceStore,\n ) {}\n\n apply(entry: AppSyncableRowEntry): void {\n const ns = this.namespace.get(entry.appId);\n if (!ns) {\n throw new Error(\n `SqliteAppSyncableApplier: app \"${entry.appId}\" not installed`,\n );\n }\n const tableInfo = ns.tables.find((t) => t.name === entry.table);\n if (!tableInfo) {\n throw new Error(\n `SqliteAppSyncableApplier: table \"${entry.table}\" not declared for app \"${entry.appId}\"`,\n );\n }\n\n const fullName = appSyncableTableName(entry.appId, entry.table);\n const { pkColumns } = tableInfo;\n\n if (entry.op === \"insert\") {\n this.applyInsert(fullName, pkColumns, entry);\n } else if (entry.op === \"update\") {\n this.applyUpdate(fullName, entry);\n } else {\n this.applyDelete(fullName, entry);\n }\n }\n\n private applyInsert(\n fullName: string,\n pkColumns: string[],\n entry: AppSyncableRowEntry,\n ): void {\n const row = withNodeId(entry.row ?? {}, entry);\n const cols = Object.keys(row);\n if (cols.length === 0) return;\n\n const colList = cols.map(q).join(\", \");\n const placeholders = cols.map(() => \"?\").join(\", \");\n const values = cols.map((c) => row[c] as unknown);\n\n if (pkColumns.length === 0) {\n // No PK declared — just insert, ignoring duplicates.\n this.db\n .prepare(`INSERT OR IGNORE INTO ${q(fullName)} (${colList}) VALUES (${placeholders})`)\n .run(...(values as never[]));\n return;\n }\n\n // UPSERT with LWW: only overwrite if the incoming updated_at is newer.\n const conflictTarget = pkColumns.map(q).join(\", \");\n const updateCols = cols.filter((c) => !pkColumns.includes(c));\n if (updateCols.length === 0) {\n this.db\n .prepare(\n `INSERT OR IGNORE INTO ${q(fullName)} (${colList}) VALUES (${placeholders})`,\n )\n .run(...(values as never[]));\n return;\n }\n const setClause = updateCols.map((c) => `${q(c)} = excluded.${q(c)}`).join(\", \");\n this.db\n .prepare(\n `INSERT INTO ${q(fullName)} (${colList}) VALUES (${placeholders})\n ON CONFLICT(${conflictTarget}) DO UPDATE SET ${setClause}\n WHERE excluded.updated_at > ${q(fullName)}.updated_at`,\n )\n .run(...(values as never[]));\n }\n\n private applyUpdate(fullName: string, entry: AppSyncableRowEntry): void {\n // node_id rides along whenever updated_at changes (it's derived from it).\n const rawPatch = entry.row ?? {};\n const patch = rawPatch[\"updated_at\"] ? withNodeId(rawPatch, entry) : rawPatch;\n const where = entry.where ?? {};\n const patchCols = Object.keys(patch);\n const whereCols = Object.keys(where);\n if (patchCols.length === 0) return;\n\n const setClause = patchCols.map((c) => `${q(c)} = ?`).join(\", \");\n // Only apply if the incoming updated_at is strictly newer (LWW).\n const incomingUpdatedAt = patch[\"updated_at\"] as string | undefined;\n const conditions: string[] = whereCols.map((c) => `${q(c)} = ?`);\n if (incomingUpdatedAt) conditions.push(`updated_at < ?`);\n const whereClause = conditions.length ? \" WHERE \" + conditions.join(\" AND \") : \"\";\n\n const params: unknown[] = [\n ...patchCols.map((c) => patch[c]),\n ...whereCols.map((c) => where[c]),\n ];\n if (incomingUpdatedAt) params.push(incomingUpdatedAt);\n\n this.db\n .prepare(`UPDATE ${q(fullName)} SET ${setClause}${whereClause}`)\n .run(...(params as never[]));\n }\n\n private applyDelete(fullName: string, entry: AppSyncableRowEntry): void {\n const where = entry.where ?? {};\n const whereCols = Object.keys(where);\n // Soft-delete: set deleted_at and updated_at (and node_id with it).\n const incomingUpdatedAt = entry.row?.[\"updated_at\"] as string | undefined;\n const ts = incomingUpdatedAt ?? serializeHLC(entry.timestamp);\n\n const conditions: string[] = [\n ...whereCols.map((c) => `${q(c)} = ?`),\n `(updated_at IS NULL OR updated_at < ?)`,\n ];\n const whereClause = \" WHERE \" + conditions.join(\" AND \");\n\n // params order: SET deleted_at=?, updated_at=?, node_id=?, then WHERE bindings\n const params: unknown[] = [\n ts,\n ts,\n nodeIdOf(ts, entry),\n ...whereCols.map((c) => where[c]),\n ts, // for the LWW updated_at < ? condition\n ];\n\n this.db\n .prepare(\n `UPDATE ${q(fullName)} SET deleted_at = ?, updated_at = ?, node_id = ?${whereClause}`,\n )\n .run(...(params as never[]));\n }\n\n /** See `ScanCapableApplier.getNodeWatermarks`. Missing table → `{}`. */\n async getNodeWatermarks(\n appId: string,\n table: string,\n ): Promise<Record<string, HLCTimestamp>> {\n const fullName = appSyncableTableName(appId, table);\n let rows: { node_id: string; max_updated_at: string }[];\n try {\n rows = this.db\n .prepare(\n `SELECT node_id, MAX(updated_at) AS max_updated_at FROM ${q(fullName)} GROUP BY node_id`,\n )\n .all() as { node_id: string; max_updated_at: string }[];\n } catch {\n // Table might not exist yet (app not installed locally).\n return {};\n }\n const out: Record<string, HLCTimestamp> = {};\n for (const row of rows) {\n out[row.node_id] = deserializeHLC(row.max_updated_at);\n }\n return out;\n }\n\n /**\n * Pull-side synthesis: return rows updated after `sinceHlcStr` (or `cursor`\n * if higher) in HLC order, paginated. `updated_at` is a serialized HLC\n * whose lexicographic order matches HLC order (fixed-width hex), and each\n * row's HLC is unique per node, so it doubles as the cursor — no separate\n * tiebreaker column is needed.\n */\n async scanSince(\n appId: string,\n table: string,\n sinceHlcStr: string,\n options?: ScanSinceOptions,\n ): Promise<ScanSincePage> {\n const fullName = appSyncableTableName(appId, table);\n const floor =\n options?.cursor !== undefined && options.cursor > sinceHlcStr\n ? options.cursor\n : sinceHlcStr;\n const limit = options?.limit;\n let rows: Record<string, unknown>[];\n try {\n if (limit !== undefined) {\n rows = this.db\n .prepare(\n `SELECT * FROM ${q(fullName)} WHERE updated_at > ? ORDER BY updated_at ASC LIMIT ?`,\n )\n .all(floor, limit + 1) as Record<string, unknown>[];\n } else {\n rows = this.db\n .prepare(\n `SELECT * FROM ${q(fullName)} WHERE updated_at > ? ORDER BY updated_at ASC`,\n )\n .all(floor) as Record<string, unknown>[];\n }\n } catch {\n // Table might not exist yet (app not installed locally).\n return { rows: [], nextCursor: null, hasMore: false };\n }\n const hasMore = limit !== undefined && rows.length > limit;\n const pageRows = hasMore ? rows.slice(0, limit) : rows;\n const entries = pageRows.map((row) => rowToEntry(appId, table, row));\n const nextCursor =\n hasMore && pageRows.length > 0\n ? (pageRows[pageRows.length - 1]![\"updated_at\"] as string)\n : null;\n return { rows: entries, nextCursor, hasMore };\n }\n\n /** Support read path from the factory's queryRows. */\n queryRows(\n appId: string,\n table: string,\n where?: Record<string, unknown>,\n ): Record<string, unknown>[] {\n const fullName = appSyncableTableName(appId, table);\n const whereCols = where ? Object.keys(where) : [];\n // Filter out soft-deleted rows by default.\n const whereClause = [\n \"deleted_at IS NULL\",\n ...whereCols.map((c) => `${q(c)} = ?`),\n ].join(\" AND \");\n return this.db\n .prepare(`SELECT * FROM ${q(fullName)} WHERE ${whereClause}`)\n .all(...(whereCols.map((c) => where![c]) as never[])) as Record<string, unknown>[];\n }\n}\n\nfunction q(name: string): string {\n return `\"${name}\"`;\n}\n\n/**\n * Return `row` with `node_id` set from its `updated_at` (falling back to the\n * entry timestamp). Writers can't be trusted to carry the column — locally\n * authored entries and older wire rows don't — so the applier derives it at\n * write time, keeping the NOT NULL invariant without touching every producer.\n */\nfunction withNodeId(\n row: Record<string, unknown>,\n entry: AppSyncableRowEntry,\n): Record<string, unknown> {\n return { ...row, node_id: nodeIdOf(row[\"updated_at\"], entry) };\n}\n\n/** nodeId from a serialized-HLC `updated_at`, or the entry timestamp's. */\nfunction nodeIdOf(updatedAt: unknown, entry: AppSyncableRowEntry): string {\n if (typeof updatedAt === \"string\") {\n try {\n return deserializeHLC(updatedAt).nodeId;\n } catch {\n // Not a serialized HLC — fall through to the entry timestamp.\n }\n }\n return entry.timestamp.nodeId;\n}\n\nfunction rowToEntry(\n appId: string,\n table: string,\n row: Record<string, unknown>,\n): AppSyncableRowEntry {\n const updatedAtStr = row[\"updated_at\"] as string;\n const deletedAtStr = row[\"deleted_at\"] as string | null | undefined;\n const timestamp = deserializeHLC(updatedAtStr);\n\n // For wire propagation we emit op=\"insert\" (upsert) for live rows so the\n // receiver creates the row if it doesn't exist yet. op=\"update\" only\n // targets existing rows and would silently drop new rows during initial\n // sync. Tombstones still ride the soft-delete path.\n if (deletedAtStr) {\n return { timestamp, appId, table, op: \"delete\", row };\n }\n return { timestamp, appId, table, op: \"insert\", row };\n}\n"],"mappings":"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","names":["import_protocol_primitives","import_protocol_primitives","import_protocol_primitives"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
import { DatabaseSync } from 'node:sqlite';
|
|
2
2
|
import { DataRecord, StarkeepId, HLCTimestamp, MetadataRow } from '@starkeep/protocol-primitives';
|
|
3
3
|
import { DatabaseAdapter, Query, QueryResult, BatchOperation, Transaction } from '@starkeep/storage-adapter';
|
|
4
|
-
import { AccessPolicyStore } from '@starkeep/access-control';
|
|
5
4
|
import { AppSyncableNamespaceStore, AppSyncableNamespace, AppSyncableTableInfo, AppSyncableApplier, ScanCapableApplier, AppSyncableRowEntry, ScanSinceOptions, ScanSincePage } from '@starkeep/shared-space-api';
|
|
6
5
|
export { AppSyncableNamespace, AppSyncableTableInfo } from '@starkeep/shared-space-api';
|
|
7
6
|
|
|
@@ -28,6 +27,7 @@ declare class SqliteDatabaseAdapter implements DatabaseAdapter {
|
|
|
28
27
|
put(record: DataRecord): Promise<void>;
|
|
29
28
|
get(id: StarkeepId): Promise<DataRecord | null>;
|
|
30
29
|
delete(id: StarkeepId, hlc: HLCTimestamp): Promise<void>;
|
|
30
|
+
getNodeWatermarks(): Promise<Record<string, HLCTimestamp>>;
|
|
31
31
|
query(query: Query): Promise<QueryResult>;
|
|
32
32
|
batch(operations: BatchOperation[]): Promise<void>;
|
|
33
33
|
transaction<T>(callback: (transaction: Transaction) => Promise<T>): Promise<T>;
|
|
@@ -48,14 +48,9 @@ declare class SqliteDatabaseAdapter implements DatabaseAdapter {
|
|
|
48
48
|
*
|
|
49
49
|
* - shared_records — all shared data, all types (file-backed only)
|
|
50
50
|
* - shared_record_<category>_metadata — per-category metadata rows (typed columns)
|
|
51
|
-
* - shared_access_grants — per-app, per-
|
|
51
|
+
* - shared_access_grants — per-app, per-type permissions
|
|
52
52
|
* - shared_app_registry — installed apps + HMAC secrets
|
|
53
53
|
* - shared_app_install_steps — idempotent install/uninstall ledger
|
|
54
|
-
* - access_policies — control-plane: AccessControlEngine policies
|
|
55
|
-
*
|
|
56
|
-
* `sharing_tokens` is not persisted anywhere today — local uses the disabled
|
|
57
|
-
* stub store and no cloud-side table or endpoint exists. The redemption path
|
|
58
|
-
* is left for a future workstream.
|
|
59
54
|
*
|
|
60
55
|
* No migration system: this is a fresh-start schema. The user removes
|
|
61
56
|
* ~/.starkeep/data.db (or the local-data-server's STARKEEP_DIR is fresh)
|
|
@@ -63,14 +58,6 @@ declare class SqliteDatabaseAdapter implements DatabaseAdapter {
|
|
|
63
58
|
*/
|
|
64
59
|
declare function initializeLocalSchema(db: DatabaseSync): void;
|
|
65
60
|
|
|
66
|
-
/**
|
|
67
|
-
* SQLite-backed AccessPolicyStore. Schema is bootstrapped in
|
|
68
|
-
* storage-sqlite/src/schema/bootstrap.ts. Permissions are stored as a
|
|
69
|
-
* comma-separated string — never user-supplied, always picked from the
|
|
70
|
-
* Permission enum so no escaping is required.
|
|
71
|
-
*/
|
|
72
|
-
declare function createSqliteAccessPolicyStore(db: DatabaseSync): AccessPolicyStore;
|
|
73
|
-
|
|
74
61
|
declare function appSyncableTableName(appId: string, tableName: string): string;
|
|
75
62
|
declare function upsertAppSyncableNamespace(db: DatabaseSync, appId: string, tables: AppSyncableTableInfo[], filesEnabled: boolean): void;
|
|
76
63
|
declare function deleteAppSyncableNamespace(db: DatabaseSync, appId: string): void;
|
|
@@ -107,6 +94,8 @@ declare class SqliteAppSyncableApplier implements AppSyncableApplier, ScanCapabl
|
|
|
107
94
|
private applyInsert;
|
|
108
95
|
private applyUpdate;
|
|
109
96
|
private applyDelete;
|
|
97
|
+
/** See `ScanCapableApplier.getNodeWatermarks`. Missing table → `{}`. */
|
|
98
|
+
getNodeWatermarks(appId: string, table: string): Promise<Record<string, HLCTimestamp>>;
|
|
110
99
|
/**
|
|
111
100
|
* Pull-side synthesis: return rows updated after `sinceHlcStr` (or `cursor`
|
|
112
101
|
* if higher) in HLC order, paginated. `updated_at` is a serialized HLC
|
|
@@ -119,4 +108,4 @@ declare class SqliteAppSyncableApplier implements AppSyncableApplier, ScanCapabl
|
|
|
119
108
|
queryRows(appId: string, table: string, where?: Record<string, unknown>): Record<string, unknown>[];
|
|
120
109
|
}
|
|
121
110
|
|
|
122
|
-
export { SqliteAppSyncableApplier, SqliteAppSyncableNamespaceStore, SqliteDatabaseAdapter, type SqliteDatabaseAdapterOptions, appSyncableTableName,
|
|
111
|
+
export { SqliteAppSyncableApplier, SqliteAppSyncableNamespaceStore, SqliteDatabaseAdapter, type SqliteDatabaseAdapterOptions, appSyncableTableName, deleteAppSyncableNamespace, getAppSyncableNamespace, initializeLocalSchema, listAppSyncableNamespaces, upsertAppSyncableNamespace };
|
package/dist/index.d.ts
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
import { DatabaseSync } from 'node:sqlite';
|
|
2
2
|
import { DataRecord, StarkeepId, HLCTimestamp, MetadataRow } from '@starkeep/protocol-primitives';
|
|
3
3
|
import { DatabaseAdapter, Query, QueryResult, BatchOperation, Transaction } from '@starkeep/storage-adapter';
|
|
4
|
-
import { AccessPolicyStore } from '@starkeep/access-control';
|
|
5
4
|
import { AppSyncableNamespaceStore, AppSyncableNamespace, AppSyncableTableInfo, AppSyncableApplier, ScanCapableApplier, AppSyncableRowEntry, ScanSinceOptions, ScanSincePage } from '@starkeep/shared-space-api';
|
|
6
5
|
export { AppSyncableNamespace, AppSyncableTableInfo } from '@starkeep/shared-space-api';
|
|
7
6
|
|
|
@@ -28,6 +27,7 @@ declare class SqliteDatabaseAdapter implements DatabaseAdapter {
|
|
|
28
27
|
put(record: DataRecord): Promise<void>;
|
|
29
28
|
get(id: StarkeepId): Promise<DataRecord | null>;
|
|
30
29
|
delete(id: StarkeepId, hlc: HLCTimestamp): Promise<void>;
|
|
30
|
+
getNodeWatermarks(): Promise<Record<string, HLCTimestamp>>;
|
|
31
31
|
query(query: Query): Promise<QueryResult>;
|
|
32
32
|
batch(operations: BatchOperation[]): Promise<void>;
|
|
33
33
|
transaction<T>(callback: (transaction: Transaction) => Promise<T>): Promise<T>;
|
|
@@ -48,14 +48,9 @@ declare class SqliteDatabaseAdapter implements DatabaseAdapter {
|
|
|
48
48
|
*
|
|
49
49
|
* - shared_records — all shared data, all types (file-backed only)
|
|
50
50
|
* - shared_record_<category>_metadata — per-category metadata rows (typed columns)
|
|
51
|
-
* - shared_access_grants — per-app, per-
|
|
51
|
+
* - shared_access_grants — per-app, per-type permissions
|
|
52
52
|
* - shared_app_registry — installed apps + HMAC secrets
|
|
53
53
|
* - shared_app_install_steps — idempotent install/uninstall ledger
|
|
54
|
-
* - access_policies — control-plane: AccessControlEngine policies
|
|
55
|
-
*
|
|
56
|
-
* `sharing_tokens` is not persisted anywhere today — local uses the disabled
|
|
57
|
-
* stub store and no cloud-side table or endpoint exists. The redemption path
|
|
58
|
-
* is left for a future workstream.
|
|
59
54
|
*
|
|
60
55
|
* No migration system: this is a fresh-start schema. The user removes
|
|
61
56
|
* ~/.starkeep/data.db (or the local-data-server's STARKEEP_DIR is fresh)
|
|
@@ -63,14 +58,6 @@ declare class SqliteDatabaseAdapter implements DatabaseAdapter {
|
|
|
63
58
|
*/
|
|
64
59
|
declare function initializeLocalSchema(db: DatabaseSync): void;
|
|
65
60
|
|
|
66
|
-
/**
|
|
67
|
-
* SQLite-backed AccessPolicyStore. Schema is bootstrapped in
|
|
68
|
-
* storage-sqlite/src/schema/bootstrap.ts. Permissions are stored as a
|
|
69
|
-
* comma-separated string — never user-supplied, always picked from the
|
|
70
|
-
* Permission enum so no escaping is required.
|
|
71
|
-
*/
|
|
72
|
-
declare function createSqliteAccessPolicyStore(db: DatabaseSync): AccessPolicyStore;
|
|
73
|
-
|
|
74
61
|
declare function appSyncableTableName(appId: string, tableName: string): string;
|
|
75
62
|
declare function upsertAppSyncableNamespace(db: DatabaseSync, appId: string, tables: AppSyncableTableInfo[], filesEnabled: boolean): void;
|
|
76
63
|
declare function deleteAppSyncableNamespace(db: DatabaseSync, appId: string): void;
|
|
@@ -107,6 +94,8 @@ declare class SqliteAppSyncableApplier implements AppSyncableApplier, ScanCapabl
|
|
|
107
94
|
private applyInsert;
|
|
108
95
|
private applyUpdate;
|
|
109
96
|
private applyDelete;
|
|
97
|
+
/** See `ScanCapableApplier.getNodeWatermarks`. Missing table → `{}`. */
|
|
98
|
+
getNodeWatermarks(appId: string, table: string): Promise<Record<string, HLCTimestamp>>;
|
|
110
99
|
/**
|
|
111
100
|
* Pull-side synthesis: return rows updated after `sinceHlcStr` (or `cursor`
|
|
112
101
|
* if higher) in HLC order, paginated. `updated_at` is a serialized HLC
|
|
@@ -119,4 +108,4 @@ declare class SqliteAppSyncableApplier implements AppSyncableApplier, ScanCapabl
|
|
|
119
108
|
queryRows(appId: string, table: string, where?: Record<string, unknown>): Record<string, unknown>[];
|
|
120
109
|
}
|
|
121
110
|
|
|
122
|
-
export { SqliteAppSyncableApplier, SqliteAppSyncableNamespaceStore, SqliteDatabaseAdapter, type SqliteDatabaseAdapterOptions, appSyncableTableName,
|
|
111
|
+
export { SqliteAppSyncableApplier, SqliteAppSyncableNamespaceStore, SqliteDatabaseAdapter, type SqliteDatabaseAdapterOptions, appSyncableTableName, deleteAppSyncableNamespace, getAppSyncableNamespace, initializeLocalSchema, listAppSyncableNamespaces, upsertAppSyncableNamespace };
|
package/dist/index.js
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
import { DatabaseSync } from "sqlite";
|
|
3
3
|
import { mkdirSync, existsSync } from "fs";
|
|
4
4
|
import { dirname } from "path";
|
|
5
|
-
import { serializeHLC as serializeHLC2, sqliteMetadataTableName } from "@starkeep/protocol-primitives";
|
|
5
|
+
import { serializeHLC as serializeHLC2, deserializeHLC as deserializeHLC2, sqliteMetadataTableName } from "@starkeep/protocol-primitives";
|
|
6
6
|
import { StorageError, TransactionError } from "@starkeep/storage-adapter";
|
|
7
7
|
|
|
8
8
|
// src/serialization.ts
|
|
@@ -13,7 +13,7 @@ function recordToRow(record) {
|
|
|
13
13
|
type: record.type,
|
|
14
14
|
created_at: serializeHLC(record.createdAt),
|
|
15
15
|
updated_at: serializeHLC(record.updatedAt),
|
|
16
|
-
|
|
16
|
+
node_id: record.updatedAt.nodeId,
|
|
17
17
|
deleted_at: record.deletedAt ? serializeHLC(record.deletedAt) : null,
|
|
18
18
|
version: record.version,
|
|
19
19
|
content_hash: record.contentHash,
|
|
@@ -22,7 +22,8 @@ function recordToRow(record) {
|
|
|
22
22
|
size_bytes: record.sizeBytes,
|
|
23
23
|
original_filename: record.originalFilename,
|
|
24
24
|
origin_app_id: record.originAppId,
|
|
25
|
-
parent_id: record.parentId
|
|
25
|
+
parent_id: record.parentId,
|
|
26
|
+
label: record.label
|
|
26
27
|
};
|
|
27
28
|
}
|
|
28
29
|
function rowToRecord(row) {
|
|
@@ -32,7 +33,6 @@ function rowToRecord(row) {
|
|
|
32
33
|
type: row.type,
|
|
33
34
|
createdAt: deserializeHLC(row.created_at),
|
|
34
35
|
updatedAt: deserializeHLC(row.updated_at),
|
|
35
|
-
ownerId: row.owner_id,
|
|
36
36
|
deletedAt: row.deleted_at ? deserializeHLC(row.deleted_at) : null,
|
|
37
37
|
version: row.version,
|
|
38
38
|
contentHash: row.content_hash,
|
|
@@ -41,7 +41,8 @@ function rowToRecord(row) {
|
|
|
41
41
|
sizeBytes: row.size_bytes,
|
|
42
42
|
originalFilename: row.original_filename,
|
|
43
43
|
originAppId: row.origin_app_id,
|
|
44
|
-
parentId: row.parent_id ? createStarkeepId(row.parent_id) : null
|
|
44
|
+
parentId: row.parent_id ? createStarkeepId(row.parent_id) : null,
|
|
45
|
+
label: row.label
|
|
45
46
|
};
|
|
46
47
|
}
|
|
47
48
|
|
|
@@ -58,7 +59,6 @@ var FIELD_MAP = {
|
|
|
58
59
|
type: "type",
|
|
59
60
|
createdAt: "created_at",
|
|
60
61
|
updatedAt: "updated_at",
|
|
61
|
-
ownerId: "owner_id",
|
|
62
62
|
deletedAt: "deleted_at",
|
|
63
63
|
version: "version",
|
|
64
64
|
contentHash: "content_hash",
|
|
@@ -67,7 +67,8 @@ var FIELD_MAP = {
|
|
|
67
67
|
sizeBytes: "size_bytes",
|
|
68
68
|
originAppId: "origin_app_id",
|
|
69
69
|
parentId: "parent_id",
|
|
70
|
-
originalFilename: "original_filename"
|
|
70
|
+
originalFilename: "original_filename",
|
|
71
|
+
label: "label"
|
|
71
72
|
};
|
|
72
73
|
function mapField(field) {
|
|
73
74
|
return FIELD_MAP[field] ?? field;
|
|
@@ -145,23 +146,32 @@ function initializeLocalSchema(db) {
|
|
|
145
146
|
type TEXT NOT NULL,
|
|
146
147
|
created_at TEXT NOT NULL,
|
|
147
148
|
updated_at TEXT NOT NULL,
|
|
148
|
-
|
|
149
|
+
-- Denormalized from updated_at (its nodeId component) on every write.
|
|
150
|
+
-- Feeds the sync responder's per-node coverage watermark via the
|
|
151
|
+
-- (node_id, updated_at) index without scanning the table.
|
|
152
|
+
node_id TEXT NOT NULL,
|
|
149
153
|
deleted_at TEXT,
|
|
150
154
|
version INTEGER NOT NULL DEFAULT 1,
|
|
151
155
|
content_hash TEXT NOT NULL,
|
|
152
156
|
object_storage_key TEXT NOT NULL,
|
|
153
|
-
mime_type TEXT
|
|
157
|
+
mime_type TEXT,
|
|
154
158
|
size_bytes INTEGER NOT NULL,
|
|
155
159
|
original_filename TEXT,
|
|
156
160
|
origin_app_id TEXT NOT NULL,
|
|
157
|
-
parent_id TEXT
|
|
161
|
+
parent_id TEXT,
|
|
162
|
+
-- Advisory appId/purpose interest-filter marker (e.g. photos/thumbnail);
|
|
163
|
+
-- NULL = general interest. See DataRecord.label.
|
|
164
|
+
label TEXT
|
|
158
165
|
)
|
|
159
166
|
`);
|
|
160
167
|
db.exec("CREATE INDEX IF NOT EXISTS idx_shared_records_type ON shared_records(type)");
|
|
168
|
+
db.exec(
|
|
169
|
+
"CREATE INDEX IF NOT EXISTS idx_shared_records_node_watermark ON shared_records(node_id, updated_at)"
|
|
170
|
+
);
|
|
161
171
|
db.exec("CREATE INDEX IF NOT EXISTS idx_shared_records_origin_app ON shared_records(origin_app_id)");
|
|
162
172
|
db.exec("CREATE INDEX IF NOT EXISTS idx_shared_records_parent_id ON shared_records(parent_id)");
|
|
163
173
|
db.exec(
|
|
164
|
-
"CREATE UNIQUE INDEX IF NOT EXISTS
|
|
174
|
+
"CREATE UNIQUE INDEX IF NOT EXISTS uq_shared_records_filename_hash ON shared_records(original_filename, content_hash) WHERE deleted_at IS NULL AND original_filename IS NOT NULL"
|
|
165
175
|
);
|
|
166
176
|
db.exec(`
|
|
167
177
|
CREATE TABLE IF NOT EXISTS shared_access_grants (
|
|
@@ -206,19 +216,6 @@ function initializeLocalSchema(db) {
|
|
|
206
216
|
created_at TEXT NOT NULL DEFAULT (datetime('now'))
|
|
207
217
|
)
|
|
208
218
|
`);
|
|
209
|
-
db.exec(`
|
|
210
|
-
CREATE TABLE IF NOT EXISTS access_policies (
|
|
211
|
-
policy_id TEXT PRIMARY KEY,
|
|
212
|
-
subject_type TEXT NOT NULL,
|
|
213
|
-
subject_id TEXT NOT NULL,
|
|
214
|
-
resource_type TEXT NOT NULL,
|
|
215
|
-
resource_id TEXT NOT NULL,
|
|
216
|
-
permissions TEXT NOT NULL,
|
|
217
|
-
granted_at TEXT NOT NULL,
|
|
218
|
-
expires_at TEXT
|
|
219
|
-
)
|
|
220
|
-
`);
|
|
221
|
-
db.exec("CREATE INDEX IF NOT EXISTS idx_access_policies_subject ON access_policies(subject_type, subject_id)");
|
|
222
219
|
for (const c of CATEGORIES) {
|
|
223
220
|
if (c.id === "other") continue;
|
|
224
221
|
db.exec(sqliteMetadataDdl(c));
|
|
@@ -296,12 +293,23 @@ var SqliteDatabaseAdapter = class {
|
|
|
296
293
|
async delete(id, hlc) {
|
|
297
294
|
const ts = serializeHLC2(hlc);
|
|
298
295
|
this.runStmt(
|
|
299
|
-
"UPDATE shared_records SET deleted_at = ?, updated_at = ? WHERE id = ?",
|
|
296
|
+
"UPDATE shared_records SET deleted_at = ?, updated_at = ?, node_id = ? WHERE id = ?",
|
|
300
297
|
ts,
|
|
301
298
|
ts,
|
|
299
|
+
hlc.nodeId,
|
|
302
300
|
id
|
|
303
301
|
);
|
|
304
302
|
}
|
|
303
|
+
async getNodeWatermarks() {
|
|
304
|
+
const rows = this.allRows(
|
|
305
|
+
"SELECT node_id, MAX(updated_at) AS max_updated_at FROM shared_records GROUP BY node_id"
|
|
306
|
+
);
|
|
307
|
+
const out = {};
|
|
308
|
+
for (const row of rows) {
|
|
309
|
+
out[row.node_id] = deserializeHLC2(row.max_updated_at);
|
|
310
|
+
}
|
|
311
|
+
return out;
|
|
312
|
+
}
|
|
305
313
|
async query(query) {
|
|
306
314
|
const { sql, params } = buildSelectQuery(query);
|
|
307
315
|
const rows = this.allRows(sql, ...params);
|
|
@@ -400,65 +408,6 @@ function columnsToMetadataRow(recordId, columns) {
|
|
|
400
408
|
return row;
|
|
401
409
|
}
|
|
402
410
|
|
|
403
|
-
// src/control-plane-stores.ts
|
|
404
|
-
import {
|
|
405
|
-
createStarkeepId as createStarkeepId2,
|
|
406
|
-
deserializeHLC as deserializeHLC2,
|
|
407
|
-
serializeHLC as serializeHLC3
|
|
408
|
-
} from "@starkeep/protocol-primitives";
|
|
409
|
-
function createSqliteAccessPolicyStore(db) {
|
|
410
|
-
return {
|
|
411
|
-
async putPolicy(policy) {
|
|
412
|
-
db.prepare(
|
|
413
|
-
`INSERT INTO access_policies (
|
|
414
|
-
policy_id, subject_type, subject_id, resource_type, resource_id,
|
|
415
|
-
permissions, granted_at, expires_at
|
|
416
|
-
) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
|
|
417
|
-
ON CONFLICT(policy_id) DO UPDATE SET
|
|
418
|
-
subject_type = excluded.subject_type,
|
|
419
|
-
subject_id = excluded.subject_id,
|
|
420
|
-
resource_type = excluded.resource_type,
|
|
421
|
-
resource_id = excluded.resource_id,
|
|
422
|
-
permissions = excluded.permissions,
|
|
423
|
-
granted_at = excluded.granted_at,
|
|
424
|
-
expires_at = excluded.expires_at`
|
|
425
|
-
).run(
|
|
426
|
-
policy.policyId,
|
|
427
|
-
policy.subjectType,
|
|
428
|
-
policy.subjectId,
|
|
429
|
-
policy.resourceType,
|
|
430
|
-
policy.resourceId,
|
|
431
|
-
policy.permissions.join(","),
|
|
432
|
-
serializeHLC3(policy.grantedAt),
|
|
433
|
-
policy.expiresAt ? serializeHLC3(policy.expiresAt) : null
|
|
434
|
-
);
|
|
435
|
-
},
|
|
436
|
-
async getPolicy(policyId) {
|
|
437
|
-
const row = db.prepare("SELECT * FROM access_policies WHERE policy_id = ?").get(policyId);
|
|
438
|
-
return row ? rowToPolicy(row) : null;
|
|
439
|
-
},
|
|
440
|
-
async listPolicies() {
|
|
441
|
-
const rows = db.prepare("SELECT * FROM access_policies").all();
|
|
442
|
-
return rows.map(rowToPolicy);
|
|
443
|
-
},
|
|
444
|
-
async deletePolicy(policyId) {
|
|
445
|
-
db.prepare("DELETE FROM access_policies WHERE policy_id = ?").run(policyId);
|
|
446
|
-
}
|
|
447
|
-
};
|
|
448
|
-
}
|
|
449
|
-
function rowToPolicy(row) {
|
|
450
|
-
return {
|
|
451
|
-
policyId: createStarkeepId2(row.policy_id),
|
|
452
|
-
subjectType: row.subject_type,
|
|
453
|
-
subjectId: row.subject_id,
|
|
454
|
-
resourceType: row.resource_type,
|
|
455
|
-
resourceId: row.resource_id,
|
|
456
|
-
permissions: row.permissions.split(",").filter(Boolean),
|
|
457
|
-
grantedAt: deserializeHLC2(row.granted_at),
|
|
458
|
-
expiresAt: row.expires_at ? deserializeHLC2(row.expires_at) : null
|
|
459
|
-
};
|
|
460
|
-
}
|
|
461
|
-
|
|
462
411
|
// src/app-syncable/namespace.ts
|
|
463
412
|
function normalizeAppId(appId) {
|
|
464
413
|
return appId.toLowerCase().replace(/-/g, "_");
|
|
@@ -513,7 +462,7 @@ var SqliteAppSyncableNamespaceStore = class {
|
|
|
513
462
|
};
|
|
514
463
|
|
|
515
464
|
// src/app-syncable/apply.ts
|
|
516
|
-
import { serializeHLC as
|
|
465
|
+
import { serializeHLC as serializeHLC3, deserializeHLC as deserializeHLC3 } from "@starkeep/protocol-primitives";
|
|
517
466
|
var SqliteAppSyncableApplier = class {
|
|
518
467
|
constructor(db, namespace) {
|
|
519
468
|
this.db = db;
|
|
@@ -543,7 +492,7 @@ var SqliteAppSyncableApplier = class {
|
|
|
543
492
|
}
|
|
544
493
|
}
|
|
545
494
|
applyInsert(fullName, pkColumns, entry) {
|
|
546
|
-
const row = entry.row ?? {};
|
|
495
|
+
const row = withNodeId(entry.row ?? {}, entry);
|
|
547
496
|
const cols = Object.keys(row);
|
|
548
497
|
if (cols.length === 0) return;
|
|
549
498
|
const colList = cols.map(q).join(", ");
|
|
@@ -569,7 +518,8 @@ var SqliteAppSyncableApplier = class {
|
|
|
569
518
|
).run(...values);
|
|
570
519
|
}
|
|
571
520
|
applyUpdate(fullName, entry) {
|
|
572
|
-
const
|
|
521
|
+
const rawPatch = entry.row ?? {};
|
|
522
|
+
const patch = rawPatch["updated_at"] ? withNodeId(rawPatch, entry) : rawPatch;
|
|
573
523
|
const where = entry.where ?? {};
|
|
574
524
|
const patchCols = Object.keys(patch);
|
|
575
525
|
const whereCols = Object.keys(where);
|
|
@@ -590,7 +540,7 @@ var SqliteAppSyncableApplier = class {
|
|
|
590
540
|
const where = entry.where ?? {};
|
|
591
541
|
const whereCols = Object.keys(where);
|
|
592
542
|
const incomingUpdatedAt = entry.row?.["updated_at"];
|
|
593
|
-
const ts = incomingUpdatedAt ??
|
|
543
|
+
const ts = incomingUpdatedAt ?? serializeHLC3(entry.timestamp);
|
|
594
544
|
const conditions = [
|
|
595
545
|
...whereCols.map((c) => `${q(c)} = ?`),
|
|
596
546
|
`(updated_at IS NULL OR updated_at < ?)`
|
|
@@ -599,14 +549,32 @@ var SqliteAppSyncableApplier = class {
|
|
|
599
549
|
const params = [
|
|
600
550
|
ts,
|
|
601
551
|
ts,
|
|
552
|
+
nodeIdOf(ts, entry),
|
|
602
553
|
...whereCols.map((c) => where[c]),
|
|
603
554
|
ts
|
|
604
555
|
// for the LWW updated_at < ? condition
|
|
605
556
|
];
|
|
606
557
|
this.db.prepare(
|
|
607
|
-
`UPDATE ${q(fullName)} SET deleted_at = ?, updated_at = ?${whereClause}`
|
|
558
|
+
`UPDATE ${q(fullName)} SET deleted_at = ?, updated_at = ?, node_id = ?${whereClause}`
|
|
608
559
|
).run(...params);
|
|
609
560
|
}
|
|
561
|
+
/** See `ScanCapableApplier.getNodeWatermarks`. Missing table → `{}`. */
|
|
562
|
+
async getNodeWatermarks(appId, table) {
|
|
563
|
+
const fullName = appSyncableTableName(appId, table);
|
|
564
|
+
let rows;
|
|
565
|
+
try {
|
|
566
|
+
rows = this.db.prepare(
|
|
567
|
+
`SELECT node_id, MAX(updated_at) AS max_updated_at FROM ${q(fullName)} GROUP BY node_id`
|
|
568
|
+
).all();
|
|
569
|
+
} catch {
|
|
570
|
+
return {};
|
|
571
|
+
}
|
|
572
|
+
const out = {};
|
|
573
|
+
for (const row of rows) {
|
|
574
|
+
out[row.node_id] = deserializeHLC3(row.max_updated_at);
|
|
575
|
+
}
|
|
576
|
+
return out;
|
|
577
|
+
}
|
|
610
578
|
/**
|
|
611
579
|
* Pull-side synthesis: return rows updated after `sinceHlcStr` (or `cursor`
|
|
612
580
|
* if higher) in HLC order, paginated. `updated_at` is a serialized HLC
|
|
@@ -652,6 +620,18 @@ var SqliteAppSyncableApplier = class {
|
|
|
652
620
|
function q(name) {
|
|
653
621
|
return `"${name}"`;
|
|
654
622
|
}
|
|
623
|
+
function withNodeId(row, entry) {
|
|
624
|
+
return { ...row, node_id: nodeIdOf(row["updated_at"], entry) };
|
|
625
|
+
}
|
|
626
|
+
function nodeIdOf(updatedAt, entry) {
|
|
627
|
+
if (typeof updatedAt === "string") {
|
|
628
|
+
try {
|
|
629
|
+
return deserializeHLC3(updatedAt).nodeId;
|
|
630
|
+
} catch {
|
|
631
|
+
}
|
|
632
|
+
}
|
|
633
|
+
return entry.timestamp.nodeId;
|
|
634
|
+
}
|
|
655
635
|
function rowToEntry(appId, table, row) {
|
|
656
636
|
const updatedAtStr = row["updated_at"];
|
|
657
637
|
const deletedAtStr = row["deleted_at"];
|
|
@@ -666,7 +646,6 @@ export {
|
|
|
666
646
|
SqliteAppSyncableNamespaceStore,
|
|
667
647
|
SqliteDatabaseAdapter,
|
|
668
648
|
appSyncableTableName,
|
|
669
|
-
createSqliteAccessPolicyStore,
|
|
670
649
|
deleteAppSyncableNamespace,
|
|
671
650
|
getAppSyncableNamespace,
|
|
672
651
|
initializeLocalSchema,
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/adapter.ts","../src/serialization.ts","../src/query-builder.ts","../src/schema/bootstrap.ts","../src/control-plane-stores.ts","../src/app-syncable/namespace.ts","../src/app-syncable/apply.ts"],"sourcesContent":["import { DatabaseSync } from \"node:sqlite\";\nimport { mkdirSync, existsSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport type { DataRecord, HLCTimestamp, MetadataRow, StarkeepId } from \"@starkeep/protocol-primitives\";\nimport { serializeHLC, sqliteMetadataTableName } from \"@starkeep/protocol-primitives\";\nimport type {\n DatabaseAdapter,\n Query,\n QueryResult,\n BatchOperation,\n Transaction,\n} from \"@starkeep/storage-adapter\";\nimport { StorageError, TransactionError } from \"@starkeep/storage-adapter\";\nimport { recordToRow, rowToRecord, type SqliteRow } from \"./serialization.js\";\nimport { buildSelectQuery } from \"./query-builder.js\";\nimport { initializeLocalSchema } from \"./schema/bootstrap.js\";\n\nexport interface SqliteDatabaseAdapterOptions {\n path: string | \":memory:\";\n}\n\nexport class SqliteDatabaseAdapter implements DatabaseAdapter {\n private database: DatabaseSync | null = null;\n private readonly options: SqliteDatabaseAdapterOptions;\n\n constructor(options: SqliteDatabaseAdapterOptions) {\n this.options = options;\n }\n\n async init(): Promise<void> {\n if (this.database) return;\n if (this.options.path !== \":memory:\") {\n const dir = dirname(this.options.path);\n if (!existsSync(dir)) {\n mkdirSync(dir, { recursive: true });\n }\n }\n this.database = new DatabaseSync(this.options.path);\n initializeLocalSchema(this.database);\n }\n\n async close(): Promise<void> {\n this.database?.close();\n this.database = null;\n }\n\n async healthCheck(): Promise<boolean> {\n if (!this.database) return false;\n try {\n this.database.prepare(\"SELECT 1\").get();\n return true;\n } catch {\n return false;\n }\n }\n\n private getDatabase(): DatabaseSync {\n if (!this.database) throw new StorageError(\"Database not initialized. Call init() first.\");\n return this.database;\n }\n\n /**\n * Returns the raw SQLite connection so sibling subsystems (e.g. the sync\n * engine's change log + state store) can create side tables in the same\n * database file. Callers must only use this after `init()`.\n */\n getRawDatabase(): DatabaseSync {\n return this.getDatabase();\n }\n\n private runStmt(sql: string, ...params: unknown[]): void {\n this.getDatabase().prepare(sql).run(...(params as Parameters<ReturnType<DatabaseSync[\"prepare\"]>[\"run\"]>));\n }\n\n private getRow<T = SqliteRow>(sql: string, ...params: unknown[]): T | undefined {\n return this.getDatabase().prepare(sql).get(\n ...(params as Parameters<ReturnType<DatabaseSync[\"prepare\"]>[\"get\"]>),\n ) as unknown as T | undefined;\n }\n\n private allRows<T = SqliteRow>(sql: string, ...params: unknown[]): T[] {\n return this.getDatabase().prepare(sql).all(\n ...(params as Parameters<ReturnType<DatabaseSync[\"prepare\"]>[\"all\"]>),\n ) as unknown as T[];\n }\n\n async put(record: DataRecord): Promise<void> {\n const row = recordToRow(record);\n const columns = Object.keys(row);\n const placeholders = columns.map(() => \"?\").join(\", \");\n const updates = columns\n .filter((column) => column !== \"id\")\n .map((column) => `${column} = excluded.${column}`)\n .join(\", \");\n const sql = `INSERT INTO shared_records (${columns.join(\", \")}) VALUES (${placeholders}) ON CONFLICT(id) DO UPDATE SET ${updates}`;\n this.runStmt(sql, ...Object.values(row));\n }\n\n async get(id: StarkeepId): Promise<DataRecord | null> {\n const row = this.getRow<SqliteRow>(\"SELECT * FROM shared_records WHERE id = ?\", id);\n return row ? rowToRecord(row) : null;\n }\n\n async delete(id: StarkeepId, hlc: HLCTimestamp): Promise<void> {\n const ts = serializeHLC(hlc);\n this.runStmt(\n \"UPDATE shared_records SET deleted_at = ?, updated_at = ? WHERE id = ?\",\n ts,\n ts,\n id,\n );\n }\n\n async query(query: Query): Promise<QueryResult> {\n const { sql, params } = buildSelectQuery(query);\n const rows = this.allRows<SqliteRow>(sql, ...params);\n\n const limit = query.limit;\n const hasMore = limit ? rows.length > limit : false;\n const resultRows = hasMore ? rows.slice(0, limit) : rows;\n\n return {\n records: resultRows.map(rowToRecord),\n nextCursor: hasMore ? resultRows[resultRows.length - 1].id : null,\n hasMore,\n };\n }\n\n async batch(operations: BatchOperation[]): Promise<void> {\n this.getDatabase().exec(\"BEGIN\");\n try {\n for (const operation of operations) {\n if (operation.type === \"put\") {\n await this.put(operation.record);\n } else {\n await this.delete(operation.id, operation.hlc);\n }\n }\n this.getDatabase().exec(\"COMMIT\");\n } catch (error) {\n this.getDatabase().exec(\"ROLLBACK\");\n throw error;\n }\n }\n\n async transaction<T>(callback: (transaction: Transaction) => Promise<T>): Promise<T> {\n this.getDatabase().exec(\"SAVEPOINT starkeep_tx\");\n try {\n const transaction: Transaction = {\n put: async (record) => this.put(record),\n get: async (id) => this.get(id),\n delete: async (id, hlc) => this.delete(id, hlc),\n query: async (query) => this.query(query),\n };\n const result = await callback(transaction);\n this.getDatabase().exec(\"RELEASE SAVEPOINT starkeep_tx\");\n return result;\n } catch (error) {\n this.getDatabase().exec(\"ROLLBACK TO SAVEPOINT starkeep_tx\");\n this.getDatabase().exec(\"RELEASE SAVEPOINT starkeep_tx\");\n throw new TransactionError(\"Transaction failed\", error);\n }\n }\n\n async putMetadata(typeId: string, row: MetadataRow): Promise<void> {\n const table = sqliteMetadataTableName(typeId);\n const cols: string[] = [\"record_id\"];\n const values: unknown[] = [row.recordId];\n for (const [key, value] of Object.entries(row)) {\n if (key === \"recordId\") continue;\n cols.push(key);\n values.push(value);\n }\n const placeholders = cols.map(() => \"?\").join(\", \");\n const updates = cols\n .filter((c) => c !== \"record_id\")\n .map((c) => `${c} = excluded.${c}`)\n .join(\", \");\n const sql = updates\n ? `INSERT INTO ${table} (${cols.join(\", \")}) VALUES (${placeholders}) ON CONFLICT(record_id) DO UPDATE SET ${updates}`\n : `INSERT INTO ${table} (${cols.join(\", \")}) VALUES (${placeholders}) ON CONFLICT(record_id) DO NOTHING`;\n this.runStmt(sql, ...values);\n }\n\n async getMetadata(typeId: string, recordId: StarkeepId): Promise<MetadataRow | null> {\n const table = sqliteMetadataTableName(typeId);\n const row = this.getRow<Record<string, unknown>>(\n `SELECT * FROM ${table} WHERE record_id = ?`,\n recordId,\n );\n if (!row) return null;\n return columnsToMetadataRow(recordId, row);\n }\n\n async getMetadataByIds(\n typeId: string,\n recordIds: StarkeepId[],\n ): Promise<Map<StarkeepId, MetadataRow>> {\n const result = new Map<StarkeepId, MetadataRow>();\n if (recordIds.length === 0) return result;\n const table = sqliteMetadataTableName(typeId);\n const placeholders = recordIds.map(() => \"?\").join(\", \");\n const rows = this.allRows<Record<string, unknown>>(\n `SELECT * FROM ${table} WHERE record_id IN (${placeholders})`,\n ...recordIds,\n );\n for (const row of rows) {\n const recordId = row[\"record_id\"] as StarkeepId;\n result.set(recordId, columnsToMetadataRow(recordId, row));\n }\n return result;\n }\n\n async deleteMetadata(typeId: string, recordId: StarkeepId): Promise<void> {\n const table = sqliteMetadataTableName(typeId);\n this.runStmt(`DELETE FROM ${table} WHERE record_id = ?`, recordId);\n }\n\n}\n\nfunction columnsToMetadataRow(\n recordId: StarkeepId,\n columns: Record<string, unknown>,\n): MetadataRow {\n const row: MetadataRow = { recordId };\n for (const [key, value] of Object.entries(columns)) {\n if (key === \"record_id\") continue;\n row[key] = value;\n }\n return row;\n}\n","import type { DataRecord, MetadataRow, StarkeepId } from \"@starkeep/protocol-primitives\";\nimport { serializeHLC, deserializeHLC, createStarkeepId } from \"@starkeep/protocol-primitives\";\n\nexport interface SqliteRow {\n id: string;\n type: string;\n created_at: string;\n updated_at: string;\n owner_id: string;\n deleted_at: string | null;\n version: number;\n content_hash: string;\n object_storage_key: string;\n mime_type: string;\n size_bytes: number;\n original_filename: string | null;\n origin_app_id: string;\n parent_id: string | null;\n}\n\nexport function recordToRow(record: DataRecord): SqliteRow {\n return {\n id: record.id,\n type: record.type,\n created_at: serializeHLC(record.createdAt),\n updated_at: serializeHLC(record.updatedAt),\n owner_id: record.ownerId,\n deleted_at: record.deletedAt ? serializeHLC(record.deletedAt) : null,\n version: record.version,\n content_hash: record.contentHash,\n object_storage_key: record.objectStorageKey,\n mime_type: record.mimeType,\n size_bytes: record.sizeBytes,\n original_filename: record.originalFilename,\n origin_app_id: record.originAppId,\n parent_id: record.parentId,\n };\n}\n\nexport function rowToRecord(row: SqliteRow): DataRecord {\n return {\n id: createStarkeepId(row.id),\n kind: \"data\",\n type: row.type,\n createdAt: deserializeHLC(row.created_at),\n updatedAt: deserializeHLC(row.updated_at),\n ownerId: row.owner_id,\n deletedAt: row.deleted_at ? deserializeHLC(row.deleted_at) : null,\n version: row.version,\n contentHash: row.content_hash,\n objectStorageKey: row.object_storage_key,\n mimeType: row.mime_type,\n sizeBytes: row.size_bytes,\n originalFilename: row.original_filename,\n originAppId: row.origin_app_id,\n parentId: row.parent_id ? createStarkeepId(row.parent_id) : null,\n };\n}\n\n/**\n * Convert SQLite column-keyed row data into a MetadataRow keyed by recordId\n * plus camelCase or snake_case columns. We pass columns through as-is from\n * the DB so callers can address them however they prefer.\n */\nexport function metadataRowFromColumns(\n recordId: StarkeepId,\n columns: Record<string, unknown>,\n): MetadataRow {\n const row: MetadataRow = { recordId };\n for (const [key, value] of Object.entries(columns)) {\n if (key === \"record_id\") continue;\n row[key] = value;\n }\n return row;\n}\n","import type { Query } from \"@starkeep/storage-adapter\";\nimport {\n DummyDriver,\n Kysely,\n SqliteAdapter,\n SqliteIntrospector,\n SqliteQueryCompiler,\n type ExpressionBuilder,\n type SelectQueryBuilder,\n} from \"kysely\";\n\n// External (camelCase) → column name (snake_case). Unknown fields pass through.\nconst FIELD_MAP: Record<string, string> = {\n id: \"id\",\n type: \"type\",\n createdAt: \"created_at\",\n updatedAt: \"updated_at\",\n ownerId: \"owner_id\",\n deletedAt: \"deleted_at\",\n version: \"version\",\n contentHash: \"content_hash\",\n objectStorageKey: \"object_storage_key\",\n mimeType: \"mime_type\",\n sizeBytes: \"size_bytes\",\n originAppId: \"origin_app_id\",\n parentId: \"parent_id\",\n originalFilename: \"original_filename\",\n};\n\nfunction mapField(field: string): string {\n return FIELD_MAP[field] ?? field;\n}\n\n// Single dynamic-schema Kysely instance used only to compile SQL — never\n// executes. The DummyDriver lets us reuse Kysely's compiler without pulling\n// in a real connection. `any` keeps it dialect-agnostic at the row level;\n// column names are validated against the live SQLite schema at runtime.\ntype DB = Record<string, Record<string, unknown>>;\nconst compiler = new Kysely<DB>({\n dialect: {\n createAdapter: () => new SqliteAdapter(),\n createDriver: () => new DummyDriver(),\n createIntrospector: (db) => new SqliteIntrospector(db),\n createQueryCompiler: () => new SqliteQueryCompiler(),\n },\n});\n\nexport interface BuiltQuery {\n sql: string;\n params: unknown[];\n}\n\nexport function buildSelectQuery(query: Query): BuiltQuery {\n type Qb = SelectQueryBuilder<DB, \"shared_records\", unknown>;\n let qb = compiler.selectFrom(\"shared_records\").selectAll() as Qb;\n\n if (query.type) {\n qb = qb.where(\"type\", \"=\", query.type);\n }\n\n if (query.filters) {\n for (const filter of query.filters) {\n qb = applyFilter(qb, filter);\n }\n }\n\n if (query.cursor) {\n qb = qb.where(\"id\", \">\", query.cursor);\n }\n\n if (query.sort && query.sort.length > 0) {\n for (const s of query.sort) {\n qb = qb.orderBy(mapField(s.field), s.direction === \"desc\" ? \"desc\" : \"asc\");\n }\n } else {\n qb = qb.orderBy(\"id\", \"asc\");\n }\n\n if (query.limit) {\n qb = qb.limit(query.limit + 1); // +1 to detect hasMore\n }\n\n const compiled = qb.compile();\n return { sql: compiled.sql, params: [...compiled.parameters] };\n}\n\nfunction applyFilter<Qb extends SelectQueryBuilder<DB, \"shared_records\", unknown>>(\n qb: Qb,\n filter: { field: string; operator: string; value?: unknown },\n): Qb {\n const col = mapField(filter.field);\n switch (filter.operator) {\n case \"eq\": return qb.where(col, \"=\", filter.value) as Qb;\n case \"neq\": return qb.where(col, \"!=\", filter.value) as Qb;\n case \"gt\": return qb.where(col, \">\", filter.value) as Qb;\n case \"gte\": return qb.where(col, \">=\", filter.value) as Qb;\n case \"lt\": return qb.where(col, \"<\", filter.value) as Qb;\n case \"lte\": return qb.where(col, \"<=\", filter.value) as Qb;\n case \"in\": return qb.where(col, \"in\", filter.value as unknown[]) as Qb;\n case \"like\": return qb.where(col, \"like\", `%${filter.value}%`) as Qb;\n case \"isNull\":\n return qb.where((eb: ExpressionBuilder<DB, \"shared_records\">) => eb(col, \"is\", null)) as Qb;\n case \"isNotNull\":\n return qb.where((eb: ExpressionBuilder<DB, \"shared_records\">) => eb(col, \"is not\", null)) as Qb;\n default: return qb;\n }\n}\n","import type { DatabaseSync } from \"node:sqlite\";\nimport { CATEGORIES, sqliteMetadataDdl } from \"@starkeep/protocol-primitives\";\n\n/**\n * Local sqlite schema bootstrap.\n *\n * Layout follows desired-state-roles-and-permissions.md \"DSQL DDL ... Local\n * SQLite asymmetry\" section: prefix-named tables in one file instead of\n * separate schemas. Only tables that something in phase 1 actually reads or\n * writes are created here — promotion, metadata enrichment, and the janitor\n * land as separate workstreams with their own DDL.\n *\n * - shared_records — all shared data, all types (file-backed only)\n * - shared_record_<category>_metadata — per-category metadata rows (typed columns)\n * - shared_access_grants — per-app, per-extension permissions\n * - shared_app_registry — installed apps + HMAC secrets\n * - shared_app_install_steps — idempotent install/uninstall ledger\n * - access_policies — control-plane: AccessControlEngine policies\n *\n * `sharing_tokens` is not persisted anywhere today — local uses the disabled\n * stub store and no cloud-side table or endpoint exists. The redemption path\n * is left for a future workstream.\n *\n * No migration system: this is a fresh-start schema. The user removes\n * ~/.starkeep/data.db (or the local-data-server's STARKEEP_DIR is fresh)\n * before this code runs.\n */\nexport function initializeLocalSchema(db: DatabaseSync): void {\n db.exec(\"PRAGMA journal_mode = WAL\");\n db.exec(\"PRAGMA foreign_keys = ON\");\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_records (\n id TEXT PRIMARY KEY,\n type TEXT NOT NULL,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL,\n owner_id TEXT NOT NULL,\n deleted_at TEXT,\n version INTEGER NOT NULL DEFAULT 1,\n content_hash TEXT NOT NULL,\n object_storage_key TEXT NOT NULL,\n mime_type TEXT NOT NULL,\n size_bytes INTEGER NOT NULL,\n original_filename TEXT,\n origin_app_id TEXT NOT NULL,\n parent_id TEXT\n )\n `);\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_records_type ON shared_records(type)\");\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_records_origin_app ON shared_records(origin_app_id)\");\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_records_parent_id ON shared_records(parent_id)\");\n // Duplicate-file prevention: (filename + bytes) is unique per owner among\n // live records. Tombstoned rows (deleted_at IS NOT NULL) are excluded so a\n // re-upload after delete is allowed. Records with NULL filename are not\n // constrained — the rule requires both filename and content to match.\n db.exec(\n \"CREATE UNIQUE INDEX IF NOT EXISTS uq_shared_records_owner_filename_hash \" +\n \"ON shared_records(owner_id, original_filename, content_hash) \" +\n \"WHERE deleted_at IS NULL AND original_filename IS NOT NULL\",\n );\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_access_grants (\n app_id TEXT NOT NULL,\n type_id TEXT NOT NULL,\n access TEXT NOT NULL CHECK (access IN ('read', 'readwrite')),\n metadata_write INTEGER NOT NULL DEFAULT 0,\n created_at TEXT NOT NULL DEFAULT (datetime('now')),\n PRIMARY KEY (app_id, type_id)\n )\n `);\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_access_grants_app ON shared_access_grants(app_id)\");\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_app_registry (\n app_id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n version TEXT NOT NULL,\n tier TEXT NOT NULL DEFAULT 'app',\n manifest TEXT NOT NULL,\n status TEXT NOT NULL DEFAULT 'installing',\n hmac_secret TEXT NOT NULL,\n installed_at TEXT NOT NULL DEFAULT (datetime('now')),\n updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n )\n `);\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_app_install_steps (\n app_id TEXT NOT NULL,\n operation TEXT NOT NULL CHECK (operation IN ('install', 'uninstall')),\n step TEXT NOT NULL,\n status TEXT NOT NULL CHECK (status IN ('pending', 'done', 'failed')),\n error TEXT,\n updated_at TEXT NOT NULL DEFAULT (datetime('now')),\n PRIMARY KEY (app_id, operation, step)\n )\n `);\n\n // App-specific syncable namespace registry. One row per installed app that\n // declared `infraRequirements.appSpecificSyncable`. Lists the tables the\n // installer materialized as `<app_id>_syncable_<name>` and whether the app\n // opted into the `apps/<app_id>/syncable/` file prefix. Read by the SDK to\n // gate row CRUD/file ops and by the sync engine to enumerate what to sync.\n db.exec(`\n CREATE TABLE IF NOT EXISTS app_syncable_namespaces (\n app_id TEXT PRIMARY KEY,\n tables_json TEXT NOT NULL,\n files_enabled INTEGER NOT NULL DEFAULT 0,\n created_at TEXT NOT NULL DEFAULT (datetime('now'))\n )\n `);\n\n // Control-plane: access policies issued via sdk.accessControl.createPolicy.\n // Instance-local; never synced. See AccessControlEngine.\n db.exec(`\n CREATE TABLE IF NOT EXISTS access_policies (\n policy_id TEXT PRIMARY KEY,\n subject_type TEXT NOT NULL,\n subject_id TEXT NOT NULL,\n resource_type TEXT NOT NULL,\n resource_id TEXT NOT NULL,\n permissions TEXT NOT NULL,\n granted_at TEXT NOT NULL,\n expires_at TEXT\n )\n `);\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_access_policies_subject ON access_policies(subject_type, subject_id)\");\n\n // Per-category metadata tables on parity with DSQL. Generated from CATEGORIES\n // so adding a category or a column is a single edit in @starkeep/protocol-primitives's\n // core-types.ts. `other` has no metadata columns and gets no table.\n for (const c of CATEGORIES) {\n if (c.id === \"other\") continue;\n db.exec(sqliteMetadataDdl(c));\n }\n}\n","import type { DatabaseSync } from \"node:sqlite\";\nimport {\n createStarkeepId,\n deserializeHLC,\n serializeHLC,\n type StarkeepId,\n} from \"@starkeep/protocol-primitives\";\nimport type {\n AccessPolicy,\n AccessPolicyStore,\n Permission,\n ResourceType,\n SubjectType,\n} from \"@starkeep/access-control\";\n\n/**\n * SQLite-backed AccessPolicyStore. Schema is bootstrapped in\n * storage-sqlite/src/schema/bootstrap.ts. Permissions are stored as a\n * comma-separated string — never user-supplied, always picked from the\n * Permission enum so no escaping is required.\n */\nexport function createSqliteAccessPolicyStore(db: DatabaseSync): AccessPolicyStore {\n return {\n async putPolicy(policy: AccessPolicy): Promise<void> {\n db.prepare(\n `INSERT INTO access_policies (\n policy_id, subject_type, subject_id, resource_type, resource_id,\n permissions, granted_at, expires_at\n ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)\n ON CONFLICT(policy_id) DO UPDATE SET\n subject_type = excluded.subject_type,\n subject_id = excluded.subject_id,\n resource_type = excluded.resource_type,\n resource_id = excluded.resource_id,\n permissions = excluded.permissions,\n granted_at = excluded.granted_at,\n expires_at = excluded.expires_at`,\n ).run(\n policy.policyId,\n policy.subjectType,\n policy.subjectId,\n policy.resourceType,\n policy.resourceId,\n policy.permissions.join(\",\"),\n serializeHLC(policy.grantedAt),\n policy.expiresAt ? serializeHLC(policy.expiresAt) : null,\n );\n },\n\n async getPolicy(policyId: StarkeepId): Promise<AccessPolicy | null> {\n const row = db\n .prepare(\"SELECT * FROM access_policies WHERE policy_id = ?\")\n .get(policyId) as PolicyRow | undefined;\n return row ? rowToPolicy(row) : null;\n },\n\n async listPolicies(): Promise<AccessPolicy[]> {\n const rows = db.prepare(\"SELECT * FROM access_policies\").all() as unknown as PolicyRow[];\n return rows.map(rowToPolicy);\n },\n\n async deletePolicy(policyId: StarkeepId): Promise<void> {\n db.prepare(\"DELETE FROM access_policies WHERE policy_id = ?\").run(policyId);\n },\n };\n}\n\ninterface PolicyRow {\n policy_id: string;\n subject_type: string;\n subject_id: string;\n resource_type: string;\n resource_id: string;\n permissions: string;\n granted_at: string;\n expires_at: string | null;\n}\n\nfunction rowToPolicy(row: PolicyRow): AccessPolicy {\n return {\n policyId: createStarkeepId(row.policy_id),\n subjectType: row.subject_type as SubjectType,\n subjectId: row.subject_id,\n resourceType: row.resource_type as ResourceType,\n resourceId: row.resource_id,\n permissions: row.permissions.split(\",\").filter(Boolean) as Permission[],\n grantedAt: deserializeHLC(row.granted_at),\n expiresAt: row.expires_at ? deserializeHLC(row.expires_at) : null,\n };\n}\n\n","import type { DatabaseSync } from \"node:sqlite\";\nimport type {\n AppSyncableNamespace,\n AppSyncableTableInfo,\n AppSyncableNamespaceStore,\n} from \"@starkeep/shared-space-api\";\n\nexport type { AppSyncableNamespace, AppSyncableTableInfo };\n\n// `<appId>_syncable_<table>` is what the manifest convention pins, but appIds\n// may contain dashes (e.g. \"cloud-data-server\") which aren't legal SQLite\n// identifiers. Normalize the same way as cloud-side PG roles.\nfunction normalizeAppId(appId: string): string {\n return appId.toLowerCase().replace(/-/g, \"_\");\n}\n\nexport function appSyncableTableName(appId: string, tableName: string): string {\n return `${normalizeAppId(appId)}_syncable_${tableName}`;\n}\n\nfunction rowToNamespace(r: {\n app_id: string;\n tables_json: string;\n files_enabled: number;\n}): AppSyncableNamespace {\n const tables: AppSyncableTableInfo[] = JSON.parse(r.tables_json);\n return {\n appId: r.app_id,\n tables,\n filesEnabled: r.files_enabled === 1,\n tableNames: tables.map((t) => t.name),\n };\n}\n\nexport function upsertAppSyncableNamespace(\n db: DatabaseSync,\n appId: string,\n tables: AppSyncableTableInfo[],\n filesEnabled: boolean,\n): void {\n db.prepare(\n `INSERT INTO app_syncable_namespaces (app_id, tables_json, files_enabled)\n VALUES (?, ?, ?)\n ON CONFLICT(app_id) DO UPDATE SET\n tables_json = excluded.tables_json,\n files_enabled = excluded.files_enabled`,\n ).run(appId, JSON.stringify(tables), filesEnabled ? 1 : 0);\n}\n\nexport function deleteAppSyncableNamespace(db: DatabaseSync, appId: string): void {\n db.prepare(\"DELETE FROM app_syncable_namespaces WHERE app_id = ?\").run(appId);\n}\n\nexport function getAppSyncableNamespace(\n db: DatabaseSync,\n appId: string,\n): AppSyncableNamespace | null {\n const row = db\n .prepare(\n \"SELECT app_id, tables_json, files_enabled FROM app_syncable_namespaces WHERE app_id = ?\",\n )\n .get(appId) as { app_id: string; tables_json: string; files_enabled: number } | undefined;\n if (!row) return null;\n return rowToNamespace(row);\n}\n\nexport function listAppSyncableNamespaces(db: DatabaseSync): AppSyncableNamespace[] {\n const rows = db\n .prepare(\n \"SELECT app_id, tables_json, files_enabled FROM app_syncable_namespaces\",\n )\n .all() as Array<{ app_id: string; tables_json: string; files_enabled: number }>;\n return rows.map(rowToNamespace);\n}\n\n/**\n * Object-oriented wrapper over the free functions above — implements the\n * `AppSyncableNamespaceStore` interface required by `createAppSpecificFactory`\n * and the sync applier.\n */\nexport class SqliteAppSyncableNamespaceStore implements AppSyncableNamespaceStore {\n constructor(private readonly db: DatabaseSync) {}\n\n get(appId: string): AppSyncableNamespace | null {\n return getAppSyncableNamespace(this.db, appId);\n }\n\n list(): AppSyncableNamespace[] {\n return listAppSyncableNamespaces(this.db);\n }\n}\n","import type { DatabaseSync } from \"node:sqlite\";\nimport { serializeHLC, deserializeHLC } from \"@starkeep/protocol-primitives\";\nimport type { AppSyncableApplier, AppSyncableRowEntry, AppSyncableNamespaceStore, ScanCapableApplier, ScanSinceOptions, ScanSincePage } from \"@starkeep/shared-space-api\";\nimport { appSyncableTableName } from \"./namespace.js\";\n\n/**\n * SQLite-backed implementation of `AppSyncableApplier`.\n *\n * All writes use the LWW (last-write-wins) rule based on the HLC-serialized\n * `updated_at` column: an incoming entry is only applied if its timestamp is\n * strictly greater than the row's current `updated_at`. This makes the applier\n * idempotent — replaying the same entry twice is a no-op.\n *\n * Delete is soft: the `deleted_at` column is set rather than removing the row\n * so that the inline-HLC pull path can propagate tombstones to other clients.\n */\nexport class SqliteAppSyncableApplier\n implements AppSyncableApplier, ScanCapableApplier\n{\n constructor(\n private readonly db: DatabaseSync,\n private readonly namespace: AppSyncableNamespaceStore,\n ) {}\n\n apply(entry: AppSyncableRowEntry): void {\n const ns = this.namespace.get(entry.appId);\n if (!ns) {\n throw new Error(\n `SqliteAppSyncableApplier: app \"${entry.appId}\" not installed`,\n );\n }\n const tableInfo = ns.tables.find((t) => t.name === entry.table);\n if (!tableInfo) {\n throw new Error(\n `SqliteAppSyncableApplier: table \"${entry.table}\" not declared for app \"${entry.appId}\"`,\n );\n }\n\n const fullName = appSyncableTableName(entry.appId, entry.table);\n const { pkColumns } = tableInfo;\n\n if (entry.op === \"insert\") {\n this.applyInsert(fullName, pkColumns, entry);\n } else if (entry.op === \"update\") {\n this.applyUpdate(fullName, entry);\n } else {\n this.applyDelete(fullName, entry);\n }\n }\n\n private applyInsert(\n fullName: string,\n pkColumns: string[],\n entry: AppSyncableRowEntry,\n ): void {\n const row = entry.row ?? {};\n const cols = Object.keys(row);\n if (cols.length === 0) return;\n\n const colList = cols.map(q).join(\", \");\n const placeholders = cols.map(() => \"?\").join(\", \");\n const values = cols.map((c) => row[c] as unknown);\n\n if (pkColumns.length === 0) {\n // No PK declared — just insert, ignoring duplicates.\n this.db\n .prepare(`INSERT OR IGNORE INTO ${q(fullName)} (${colList}) VALUES (${placeholders})`)\n .run(...(values as never[]));\n return;\n }\n\n // UPSERT with LWW: only overwrite if the incoming updated_at is newer.\n const conflictTarget = pkColumns.map(q).join(\", \");\n const updateCols = cols.filter((c) => !pkColumns.includes(c));\n if (updateCols.length === 0) {\n this.db\n .prepare(\n `INSERT OR IGNORE INTO ${q(fullName)} (${colList}) VALUES (${placeholders})`,\n )\n .run(...(values as never[]));\n return;\n }\n const setClause = updateCols.map((c) => `${q(c)} = excluded.${q(c)}`).join(\", \");\n this.db\n .prepare(\n `INSERT INTO ${q(fullName)} (${colList}) VALUES (${placeholders})\n ON CONFLICT(${conflictTarget}) DO UPDATE SET ${setClause}\n WHERE excluded.updated_at > ${q(fullName)}.updated_at`,\n )\n .run(...(values as never[]));\n }\n\n private applyUpdate(fullName: string, entry: AppSyncableRowEntry): void {\n const patch = entry.row ?? {};\n const where = entry.where ?? {};\n const patchCols = Object.keys(patch);\n const whereCols = Object.keys(where);\n if (patchCols.length === 0) return;\n\n const setClause = patchCols.map((c) => `${q(c)} = ?`).join(\", \");\n // Only apply if the incoming updated_at is strictly newer (LWW).\n const incomingUpdatedAt = patch[\"updated_at\"] as string | undefined;\n const conditions: string[] = whereCols.map((c) => `${q(c)} = ?`);\n if (incomingUpdatedAt) conditions.push(`updated_at < ?`);\n const whereClause = conditions.length ? \" WHERE \" + conditions.join(\" AND \") : \"\";\n\n const params: unknown[] = [\n ...patchCols.map((c) => patch[c]),\n ...whereCols.map((c) => where[c]),\n ];\n if (incomingUpdatedAt) params.push(incomingUpdatedAt);\n\n this.db\n .prepare(`UPDATE ${q(fullName)} SET ${setClause}${whereClause}`)\n .run(...(params as never[]));\n }\n\n private applyDelete(fullName: string, entry: AppSyncableRowEntry): void {\n const where = entry.where ?? {};\n const whereCols = Object.keys(where);\n // Soft-delete: set deleted_at and updated_at.\n const incomingUpdatedAt = entry.row?.[\"updated_at\"] as string | undefined;\n const ts = incomingUpdatedAt ?? serializeHLC(entry.timestamp);\n\n const conditions: string[] = [\n ...whereCols.map((c) => `${q(c)} = ?`),\n `(updated_at IS NULL OR updated_at < ?)`,\n ];\n const whereClause = \" WHERE \" + conditions.join(\" AND \");\n\n // params order: SET deleted_at=?, updated_at=?, then WHERE bindings\n const params: unknown[] = [\n ts,\n ts,\n ...whereCols.map((c) => where[c]),\n ts, // for the LWW updated_at < ? condition\n ];\n\n this.db\n .prepare(\n `UPDATE ${q(fullName)} SET deleted_at = ?, updated_at = ?${whereClause}`,\n )\n .run(...(params as never[]));\n }\n\n /**\n * Pull-side synthesis: return rows updated after `sinceHlcStr` (or `cursor`\n * if higher) in HLC order, paginated. `updated_at` is a serialized HLC\n * whose lexicographic order matches HLC order (fixed-width hex), and each\n * row's HLC is unique per node, so it doubles as the cursor — no separate\n * tiebreaker column is needed.\n */\n async scanSince(\n appId: string,\n table: string,\n sinceHlcStr: string,\n options?: ScanSinceOptions,\n ): Promise<ScanSincePage> {\n const fullName = appSyncableTableName(appId, table);\n const floor =\n options?.cursor !== undefined && options.cursor > sinceHlcStr\n ? options.cursor\n : sinceHlcStr;\n const limit = options?.limit;\n let rows: Record<string, unknown>[];\n try {\n if (limit !== undefined) {\n rows = this.db\n .prepare(\n `SELECT * FROM ${q(fullName)} WHERE updated_at > ? ORDER BY updated_at ASC LIMIT ?`,\n )\n .all(floor, limit + 1) as Record<string, unknown>[];\n } else {\n rows = this.db\n .prepare(\n `SELECT * FROM ${q(fullName)} WHERE updated_at > ? ORDER BY updated_at ASC`,\n )\n .all(floor) as Record<string, unknown>[];\n }\n } catch {\n // Table might not exist yet (app not installed locally).\n return { rows: [], nextCursor: null, hasMore: false };\n }\n const hasMore = limit !== undefined && rows.length > limit;\n const pageRows = hasMore ? rows.slice(0, limit) : rows;\n const entries = pageRows.map((row) => rowToEntry(appId, table, row));\n const nextCursor =\n hasMore && pageRows.length > 0\n ? (pageRows[pageRows.length - 1]![\"updated_at\"] as string)\n : null;\n return { rows: entries, nextCursor, hasMore };\n }\n\n /** Support read path from the factory's queryRows. */\n queryRows(\n appId: string,\n table: string,\n where?: Record<string, unknown>,\n ): Record<string, unknown>[] {\n const fullName = appSyncableTableName(appId, table);\n const whereCols = where ? Object.keys(where) : [];\n // Filter out soft-deleted rows by default.\n const whereClause = [\n \"deleted_at IS NULL\",\n ...whereCols.map((c) => `${q(c)} = ?`),\n ].join(\" AND \");\n return this.db\n .prepare(`SELECT * FROM ${q(fullName)} WHERE ${whereClause}`)\n .all(...(whereCols.map((c) => where![c]) as never[])) as Record<string, unknown>[];\n }\n}\n\nfunction q(name: string): string {\n return `\"${name}\"`;\n}\n\nfunction rowToEntry(\n appId: string,\n table: string,\n row: Record<string, unknown>,\n): AppSyncableRowEntry {\n const updatedAtStr = row[\"updated_at\"] as string;\n const deletedAtStr = row[\"deleted_at\"] as string | null | undefined;\n const timestamp = deserializeHLC(updatedAtStr);\n\n // For wire propagation we emit op=\"insert\" (upsert) for live rows so the\n // receiver creates the row if it doesn't exist yet. op=\"update\" only\n // targets existing rows and would silently drop new rows during initial\n // sync. Tombstones still ride the soft-delete path.\n if (deletedAtStr) {\n return { timestamp, appId, table, op: \"delete\", row };\n }\n return { timestamp, appId, table, op: \"insert\", row };\n}\n"],"mappings":"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","names":["serializeHLC","serializeHLC","createStarkeepId","deserializeHLC","serializeHLC","serializeHLC","deserializeHLC","serializeHLC","deserializeHLC"]}
|
|
1
|
+
{"version":3,"sources":["../src/adapter.ts","../src/serialization.ts","../src/query-builder.ts","../src/schema/bootstrap.ts","../src/app-syncable/namespace.ts","../src/app-syncable/apply.ts"],"sourcesContent":["import { DatabaseSync } from \"node:sqlite\";\nimport { mkdirSync, existsSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport type { DataRecord, HLCTimestamp, MetadataRow, StarkeepId } from \"@starkeep/protocol-primitives\";\nimport { serializeHLC, deserializeHLC, sqliteMetadataTableName } from \"@starkeep/protocol-primitives\";\nimport type {\n DatabaseAdapter,\n Query,\n QueryResult,\n BatchOperation,\n Transaction,\n} from \"@starkeep/storage-adapter\";\nimport { StorageError, TransactionError } from \"@starkeep/storage-adapter\";\nimport { recordToRow, rowToRecord, type SqliteRow } from \"./serialization.js\";\nimport { buildSelectQuery } from \"./query-builder.js\";\nimport { initializeLocalSchema } from \"./schema/bootstrap.js\";\n\nexport interface SqliteDatabaseAdapterOptions {\n path: string | \":memory:\";\n}\n\nexport class SqliteDatabaseAdapter implements DatabaseAdapter {\n private database: DatabaseSync | null = null;\n private readonly options: SqliteDatabaseAdapterOptions;\n\n constructor(options: SqliteDatabaseAdapterOptions) {\n this.options = options;\n }\n\n async init(): Promise<void> {\n if (this.database) return;\n if (this.options.path !== \":memory:\") {\n const dir = dirname(this.options.path);\n if (!existsSync(dir)) {\n mkdirSync(dir, { recursive: true });\n }\n }\n this.database = new DatabaseSync(this.options.path);\n initializeLocalSchema(this.database);\n }\n\n async close(): Promise<void> {\n this.database?.close();\n this.database = null;\n }\n\n async healthCheck(): Promise<boolean> {\n if (!this.database) return false;\n try {\n this.database.prepare(\"SELECT 1\").get();\n return true;\n } catch {\n return false;\n }\n }\n\n private getDatabase(): DatabaseSync {\n if (!this.database) throw new StorageError(\"Database not initialized. Call init() first.\");\n return this.database;\n }\n\n /**\n * Returns the raw SQLite connection so sibling subsystems (e.g. the sync\n * engine's change log + state store) can create side tables in the same\n * database file. Callers must only use this after `init()`.\n */\n getRawDatabase(): DatabaseSync {\n return this.getDatabase();\n }\n\n private runStmt(sql: string, ...params: unknown[]): void {\n this.getDatabase().prepare(sql).run(...(params as Parameters<ReturnType<DatabaseSync[\"prepare\"]>[\"run\"]>));\n }\n\n private getRow<T = SqliteRow>(sql: string, ...params: unknown[]): T | undefined {\n return this.getDatabase().prepare(sql).get(\n ...(params as Parameters<ReturnType<DatabaseSync[\"prepare\"]>[\"get\"]>),\n ) as unknown as T | undefined;\n }\n\n private allRows<T = SqliteRow>(sql: string, ...params: unknown[]): T[] {\n return this.getDatabase().prepare(sql).all(\n ...(params as Parameters<ReturnType<DatabaseSync[\"prepare\"]>[\"all\"]>),\n ) as unknown as T[];\n }\n\n async put(record: DataRecord): Promise<void> {\n const row = recordToRow(record);\n const columns = Object.keys(row);\n const placeholders = columns.map(() => \"?\").join(\", \");\n const updates = columns\n .filter((column) => column !== \"id\")\n .map((column) => `${column} = excluded.${column}`)\n .join(\", \");\n const sql = `INSERT INTO shared_records (${columns.join(\", \")}) VALUES (${placeholders}) ON CONFLICT(id) DO UPDATE SET ${updates}`;\n this.runStmt(sql, ...Object.values(row));\n }\n\n async get(id: StarkeepId): Promise<DataRecord | null> {\n const row = this.getRow<SqliteRow>(\"SELECT * FROM shared_records WHERE id = ?\", id);\n return row ? rowToRecord(row) : null;\n }\n\n async delete(id: StarkeepId, hlc: HLCTimestamp): Promise<void> {\n const ts = serializeHLC(hlc);\n this.runStmt(\n \"UPDATE shared_records SET deleted_at = ?, updated_at = ?, node_id = ? WHERE id = ?\",\n ts,\n ts,\n hlc.nodeId,\n id,\n );\n }\n\n async getNodeWatermarks(): Promise<Record<string, HLCTimestamp>> {\n // Within one node_id group, updated_at is fixed-width hex up to the\n // nodeId suffix, so lexicographic MAX equals HLC MAX. The\n // (node_id, updated_at) index makes this an index-only scan.\n const rows = this.allRows<{ node_id: string; max_updated_at: string }>(\n \"SELECT node_id, MAX(updated_at) AS max_updated_at FROM shared_records GROUP BY node_id\",\n );\n const out: Record<string, HLCTimestamp> = {};\n for (const row of rows) {\n out[row.node_id] = deserializeHLC(row.max_updated_at);\n }\n return out;\n }\n\n async query(query: Query): Promise<QueryResult> {\n const { sql, params } = buildSelectQuery(query);\n const rows = this.allRows<SqliteRow>(sql, ...params);\n\n const limit = query.limit;\n const hasMore = limit ? rows.length > limit : false;\n const resultRows = hasMore ? rows.slice(0, limit) : rows;\n\n return {\n records: resultRows.map(rowToRecord),\n nextCursor: hasMore ? resultRows[resultRows.length - 1].id : null,\n hasMore,\n };\n }\n\n async batch(operations: BatchOperation[]): Promise<void> {\n this.getDatabase().exec(\"BEGIN\");\n try {\n for (const operation of operations) {\n if (operation.type === \"put\") {\n await this.put(operation.record);\n } else {\n await this.delete(operation.id, operation.hlc);\n }\n }\n this.getDatabase().exec(\"COMMIT\");\n } catch (error) {\n this.getDatabase().exec(\"ROLLBACK\");\n throw error;\n }\n }\n\n async transaction<T>(callback: (transaction: Transaction) => Promise<T>): Promise<T> {\n this.getDatabase().exec(\"SAVEPOINT starkeep_tx\");\n try {\n const transaction: Transaction = {\n put: async (record) => this.put(record),\n get: async (id) => this.get(id),\n delete: async (id, hlc) => this.delete(id, hlc),\n query: async (query) => this.query(query),\n };\n const result = await callback(transaction);\n this.getDatabase().exec(\"RELEASE SAVEPOINT starkeep_tx\");\n return result;\n } catch (error) {\n this.getDatabase().exec(\"ROLLBACK TO SAVEPOINT starkeep_tx\");\n this.getDatabase().exec(\"RELEASE SAVEPOINT starkeep_tx\");\n throw new TransactionError(\"Transaction failed\", error);\n }\n }\n\n async putMetadata(typeId: string, row: MetadataRow): Promise<void> {\n const table = sqliteMetadataTableName(typeId);\n const cols: string[] = [\"record_id\"];\n const values: unknown[] = [row.recordId];\n for (const [key, value] of Object.entries(row)) {\n if (key === \"recordId\") continue;\n cols.push(key);\n values.push(value);\n }\n const placeholders = cols.map(() => \"?\").join(\", \");\n const updates = cols\n .filter((c) => c !== \"record_id\")\n .map((c) => `${c} = excluded.${c}`)\n .join(\", \");\n const sql = updates\n ? `INSERT INTO ${table} (${cols.join(\", \")}) VALUES (${placeholders}) ON CONFLICT(record_id) DO UPDATE SET ${updates}`\n : `INSERT INTO ${table} (${cols.join(\", \")}) VALUES (${placeholders}) ON CONFLICT(record_id) DO NOTHING`;\n this.runStmt(sql, ...values);\n }\n\n async getMetadata(typeId: string, recordId: StarkeepId): Promise<MetadataRow | null> {\n const table = sqliteMetadataTableName(typeId);\n const row = this.getRow<Record<string, unknown>>(\n `SELECT * FROM ${table} WHERE record_id = ?`,\n recordId,\n );\n if (!row) return null;\n return columnsToMetadataRow(recordId, row);\n }\n\n async getMetadataByIds(\n typeId: string,\n recordIds: StarkeepId[],\n ): Promise<Map<StarkeepId, MetadataRow>> {\n const result = new Map<StarkeepId, MetadataRow>();\n if (recordIds.length === 0) return result;\n const table = sqliteMetadataTableName(typeId);\n const placeholders = recordIds.map(() => \"?\").join(\", \");\n const rows = this.allRows<Record<string, unknown>>(\n `SELECT * FROM ${table} WHERE record_id IN (${placeholders})`,\n ...recordIds,\n );\n for (const row of rows) {\n const recordId = row[\"record_id\"] as StarkeepId;\n result.set(recordId, columnsToMetadataRow(recordId, row));\n }\n return result;\n }\n\n async deleteMetadata(typeId: string, recordId: StarkeepId): Promise<void> {\n const table = sqliteMetadataTableName(typeId);\n this.runStmt(`DELETE FROM ${table} WHERE record_id = ?`, recordId);\n }\n\n}\n\nfunction columnsToMetadataRow(\n recordId: StarkeepId,\n columns: Record<string, unknown>,\n): MetadataRow {\n const row: MetadataRow = { recordId };\n for (const [key, value] of Object.entries(columns)) {\n if (key === \"record_id\") continue;\n row[key] = value;\n }\n return row;\n}\n","import type { DataRecord, MetadataRow, StarkeepId } from \"@starkeep/protocol-primitives\";\nimport { serializeHLC, deserializeHLC, createStarkeepId } from \"@starkeep/protocol-primitives\";\n\nexport interface SqliteRow {\n id: string;\n type: string;\n created_at: string;\n updated_at: string;\n /** Denormalized `updatedAt.nodeId`; must be rewritten with `updated_at`. */\n node_id: string;\n deleted_at: string | null;\n version: number;\n content_hash: string;\n object_storage_key: string;\n mime_type: string | null;\n size_bytes: number;\n original_filename: string | null;\n origin_app_id: string;\n parent_id: string | null;\n label: string | null;\n}\n\nexport function recordToRow(record: DataRecord): SqliteRow {\n return {\n id: record.id,\n type: record.type,\n created_at: serializeHLC(record.createdAt),\n updated_at: serializeHLC(record.updatedAt),\n node_id: record.updatedAt.nodeId,\n deleted_at: record.deletedAt ? serializeHLC(record.deletedAt) : null,\n version: record.version,\n content_hash: record.contentHash,\n object_storage_key: record.objectStorageKey,\n mime_type: record.mimeType,\n size_bytes: record.sizeBytes,\n original_filename: record.originalFilename,\n origin_app_id: record.originAppId,\n parent_id: record.parentId,\n label: record.label,\n };\n}\n\nexport function rowToRecord(row: SqliteRow): DataRecord {\n return {\n id: createStarkeepId(row.id),\n kind: \"data\",\n type: row.type,\n createdAt: deserializeHLC(row.created_at),\n updatedAt: deserializeHLC(row.updated_at),\n deletedAt: row.deleted_at ? deserializeHLC(row.deleted_at) : null,\n version: row.version,\n contentHash: row.content_hash,\n objectStorageKey: row.object_storage_key,\n mimeType: row.mime_type,\n sizeBytes: row.size_bytes,\n originalFilename: row.original_filename,\n originAppId: row.origin_app_id,\n parentId: row.parent_id ? createStarkeepId(row.parent_id) : null,\n label: row.label,\n };\n}\n\n/**\n * Convert SQLite column-keyed row data into a MetadataRow keyed by recordId\n * plus camelCase or snake_case columns. We pass columns through as-is from\n * the DB so callers can address them however they prefer.\n */\nexport function metadataRowFromColumns(\n recordId: StarkeepId,\n columns: Record<string, unknown>,\n): MetadataRow {\n const row: MetadataRow = { recordId };\n for (const [key, value] of Object.entries(columns)) {\n if (key === \"record_id\") continue;\n row[key] = value;\n }\n return row;\n}\n","import type { Query } from \"@starkeep/storage-adapter\";\nimport {\n DummyDriver,\n Kysely,\n SqliteAdapter,\n SqliteIntrospector,\n SqliteQueryCompiler,\n type ExpressionBuilder,\n type SelectQueryBuilder,\n} from \"kysely\";\n\n// External (camelCase) → column name (snake_case). Unknown fields pass through.\nconst FIELD_MAP: Record<string, string> = {\n id: \"id\",\n type: \"type\",\n createdAt: \"created_at\",\n updatedAt: \"updated_at\",\n deletedAt: \"deleted_at\",\n version: \"version\",\n contentHash: \"content_hash\",\n objectStorageKey: \"object_storage_key\",\n mimeType: \"mime_type\",\n sizeBytes: \"size_bytes\",\n originAppId: \"origin_app_id\",\n parentId: \"parent_id\",\n originalFilename: \"original_filename\",\n label: \"label\",\n};\n\nfunction mapField(field: string): string {\n return FIELD_MAP[field] ?? field;\n}\n\n// Single dynamic-schema Kysely instance used only to compile SQL — never\n// executes. The DummyDriver lets us reuse Kysely's compiler without pulling\n// in a real connection. `any` keeps it dialect-agnostic at the row level;\n// column names are validated against the live SQLite schema at runtime.\ntype DB = Record<string, Record<string, unknown>>;\nconst compiler = new Kysely<DB>({\n dialect: {\n createAdapter: () => new SqliteAdapter(),\n createDriver: () => new DummyDriver(),\n createIntrospector: (db) => new SqliteIntrospector(db),\n createQueryCompiler: () => new SqliteQueryCompiler(),\n },\n});\n\nexport interface BuiltQuery {\n sql: string;\n params: unknown[];\n}\n\nexport function buildSelectQuery(query: Query): BuiltQuery {\n type Qb = SelectQueryBuilder<DB, \"shared_records\", unknown>;\n let qb = compiler.selectFrom(\"shared_records\").selectAll() as Qb;\n\n if (query.type) {\n qb = qb.where(\"type\", \"=\", query.type);\n }\n\n if (query.filters) {\n for (const filter of query.filters) {\n qb = applyFilter(qb, filter);\n }\n }\n\n if (query.cursor) {\n qb = qb.where(\"id\", \">\", query.cursor);\n }\n\n if (query.sort && query.sort.length > 0) {\n for (const s of query.sort) {\n qb = qb.orderBy(mapField(s.field), s.direction === \"desc\" ? \"desc\" : \"asc\");\n }\n } else {\n qb = qb.orderBy(\"id\", \"asc\");\n }\n\n if (query.limit) {\n qb = qb.limit(query.limit + 1); // +1 to detect hasMore\n }\n\n const compiled = qb.compile();\n return { sql: compiled.sql, params: [...compiled.parameters] };\n}\n\nfunction applyFilter<Qb extends SelectQueryBuilder<DB, \"shared_records\", unknown>>(\n qb: Qb,\n filter: { field: string; operator: string; value?: unknown },\n): Qb {\n const col = mapField(filter.field);\n switch (filter.operator) {\n case \"eq\": return qb.where(col, \"=\", filter.value) as Qb;\n case \"neq\": return qb.where(col, \"!=\", filter.value) as Qb;\n case \"gt\": return qb.where(col, \">\", filter.value) as Qb;\n case \"gte\": return qb.where(col, \">=\", filter.value) as Qb;\n case \"lt\": return qb.where(col, \"<\", filter.value) as Qb;\n case \"lte\": return qb.where(col, \"<=\", filter.value) as Qb;\n case \"in\": return qb.where(col, \"in\", filter.value as unknown[]) as Qb;\n case \"like\": return qb.where(col, \"like\", `%${filter.value}%`) as Qb;\n case \"isNull\":\n return qb.where((eb: ExpressionBuilder<DB, \"shared_records\">) => eb(col, \"is\", null)) as Qb;\n case \"isNotNull\":\n return qb.where((eb: ExpressionBuilder<DB, \"shared_records\">) => eb(col, \"is not\", null)) as Qb;\n default: return qb;\n }\n}\n","import type { DatabaseSync } from \"node:sqlite\";\nimport { CATEGORIES, sqliteMetadataDdl } from \"@starkeep/protocol-primitives\";\n\n/**\n * Local sqlite schema bootstrap.\n *\n * Layout follows desired-state-roles-and-permissions.md \"DSQL DDL ... Local\n * SQLite asymmetry\" section: prefix-named tables in one file instead of\n * separate schemas. Only tables that something in phase 1 actually reads or\n * writes are created here — promotion, metadata enrichment, and the janitor\n * land as separate workstreams with their own DDL.\n *\n * - shared_records — all shared data, all types (file-backed only)\n * - shared_record_<category>_metadata — per-category metadata rows (typed columns)\n * - shared_access_grants — per-app, per-type permissions\n * - shared_app_registry — installed apps + HMAC secrets\n * - shared_app_install_steps — idempotent install/uninstall ledger\n *\n * No migration system: this is a fresh-start schema. The user removes\n * ~/.starkeep/data.db (or the local-data-server's STARKEEP_DIR is fresh)\n * before this code runs.\n */\nexport function initializeLocalSchema(db: DatabaseSync): void {\n db.exec(\"PRAGMA journal_mode = WAL\");\n db.exec(\"PRAGMA foreign_keys = ON\");\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_records (\n id TEXT PRIMARY KEY,\n type TEXT NOT NULL,\n created_at TEXT NOT NULL,\n updated_at TEXT NOT NULL,\n -- Denormalized from updated_at (its nodeId component) on every write.\n -- Feeds the sync responder's per-node coverage watermark via the\n -- (node_id, updated_at) index without scanning the table.\n node_id TEXT NOT NULL,\n deleted_at TEXT,\n version INTEGER NOT NULL DEFAULT 1,\n content_hash TEXT NOT NULL,\n object_storage_key TEXT NOT NULL,\n mime_type TEXT,\n size_bytes INTEGER NOT NULL,\n original_filename TEXT,\n origin_app_id TEXT NOT NULL,\n parent_id TEXT,\n -- Advisory appId/purpose interest-filter marker (e.g. photos/thumbnail);\n -- NULL = general interest. See DataRecord.label.\n label TEXT\n )\n `);\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_records_type ON shared_records(type)\");\n db.exec(\n \"CREATE INDEX IF NOT EXISTS idx_shared_records_node_watermark ON shared_records(node_id, updated_at)\",\n );\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_records_origin_app ON shared_records(origin_app_id)\");\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_records_parent_id ON shared_records(parent_id)\");\n // Duplicate-file prevention: (filename + bytes) is unique among live records.\n // Tombstoned rows (deleted_at IS NOT NULL) are excluded so a re-upload after\n // delete is allowed. Records with NULL filename are not constrained — the\n // rule requires both filename and content to match.\n db.exec(\n \"CREATE UNIQUE INDEX IF NOT EXISTS uq_shared_records_filename_hash \" +\n \"ON shared_records(original_filename, content_hash) \" +\n \"WHERE deleted_at IS NULL AND original_filename IS NOT NULL\",\n );\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_access_grants (\n app_id TEXT NOT NULL,\n type_id TEXT NOT NULL,\n access TEXT NOT NULL CHECK (access IN ('read', 'readwrite')),\n metadata_write INTEGER NOT NULL DEFAULT 0,\n created_at TEXT NOT NULL DEFAULT (datetime('now')),\n PRIMARY KEY (app_id, type_id)\n )\n `);\n db.exec(\"CREATE INDEX IF NOT EXISTS idx_shared_access_grants_app ON shared_access_grants(app_id)\");\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_app_registry (\n app_id TEXT PRIMARY KEY,\n name TEXT NOT NULL,\n version TEXT NOT NULL,\n tier TEXT NOT NULL DEFAULT 'app',\n manifest TEXT NOT NULL,\n status TEXT NOT NULL DEFAULT 'installing',\n hmac_secret TEXT NOT NULL,\n installed_at TEXT NOT NULL DEFAULT (datetime('now')),\n updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n )\n `);\n\n db.exec(`\n CREATE TABLE IF NOT EXISTS shared_app_install_steps (\n app_id TEXT NOT NULL,\n operation TEXT NOT NULL CHECK (operation IN ('install', 'uninstall')),\n step TEXT NOT NULL,\n status TEXT NOT NULL CHECK (status IN ('pending', 'done', 'failed')),\n error TEXT,\n updated_at TEXT NOT NULL DEFAULT (datetime('now')),\n PRIMARY KEY (app_id, operation, step)\n )\n `);\n\n // App-specific syncable namespace registry. One row per installed app that\n // declared `infraRequirements.appSpecificSyncable`. Lists the tables the\n // installer materialized as `<app_id>_syncable_<name>` and whether the app\n // opted into the `apps/<app_id>/syncable/` file prefix. Read by the SDK to\n // gate row CRUD/file ops and by the sync engine to enumerate what to sync.\n db.exec(`\n CREATE TABLE IF NOT EXISTS app_syncable_namespaces (\n app_id TEXT PRIMARY KEY,\n tables_json TEXT NOT NULL,\n files_enabled INTEGER NOT NULL DEFAULT 0,\n created_at TEXT NOT NULL DEFAULT (datetime('now'))\n )\n `);\n\n // Per-category metadata tables on parity with DSQL. Generated from CATEGORIES\n // so adding a category or a column is a single edit in @starkeep/protocol-primitives's\n // core-types.ts. `other` has no metadata columns and gets no table.\n for (const c of CATEGORIES) {\n if (c.id === \"other\") continue;\n db.exec(sqliteMetadataDdl(c));\n }\n}\n","import type { DatabaseSync } from \"node:sqlite\";\nimport type {\n AppSyncableNamespace,\n AppSyncableTableInfo,\n AppSyncableNamespaceStore,\n} from \"@starkeep/shared-space-api\";\n\nexport type { AppSyncableNamespace, AppSyncableTableInfo };\n\n// `<appId>_syncable_<table>` is what the manifest convention pins, but appIds\n// may contain dashes (e.g. \"cloud-data-server\") which aren't legal SQLite\n// identifiers. Normalize the same way as cloud-side PG roles.\nfunction normalizeAppId(appId: string): string {\n return appId.toLowerCase().replace(/-/g, \"_\");\n}\n\nexport function appSyncableTableName(appId: string, tableName: string): string {\n return `${normalizeAppId(appId)}_syncable_${tableName}`;\n}\n\nfunction rowToNamespace(r: {\n app_id: string;\n tables_json: string;\n files_enabled: number;\n}): AppSyncableNamespace {\n const tables: AppSyncableTableInfo[] = JSON.parse(r.tables_json);\n return {\n appId: r.app_id,\n tables,\n filesEnabled: r.files_enabled === 1,\n tableNames: tables.map((t) => t.name),\n };\n}\n\nexport function upsertAppSyncableNamespace(\n db: DatabaseSync,\n appId: string,\n tables: AppSyncableTableInfo[],\n filesEnabled: boolean,\n): void {\n db.prepare(\n `INSERT INTO app_syncable_namespaces (app_id, tables_json, files_enabled)\n VALUES (?, ?, ?)\n ON CONFLICT(app_id) DO UPDATE SET\n tables_json = excluded.tables_json,\n files_enabled = excluded.files_enabled`,\n ).run(appId, JSON.stringify(tables), filesEnabled ? 1 : 0);\n}\n\nexport function deleteAppSyncableNamespace(db: DatabaseSync, appId: string): void {\n db.prepare(\"DELETE FROM app_syncable_namespaces WHERE app_id = ?\").run(appId);\n}\n\nexport function getAppSyncableNamespace(\n db: DatabaseSync,\n appId: string,\n): AppSyncableNamespace | null {\n const row = db\n .prepare(\n \"SELECT app_id, tables_json, files_enabled FROM app_syncable_namespaces WHERE app_id = ?\",\n )\n .get(appId) as { app_id: string; tables_json: string; files_enabled: number } | undefined;\n if (!row) return null;\n return rowToNamespace(row);\n}\n\nexport function listAppSyncableNamespaces(db: DatabaseSync): AppSyncableNamespace[] {\n const rows = db\n .prepare(\n \"SELECT app_id, tables_json, files_enabled FROM app_syncable_namespaces\",\n )\n .all() as Array<{ app_id: string; tables_json: string; files_enabled: number }>;\n return rows.map(rowToNamespace);\n}\n\n/**\n * Object-oriented wrapper over the free functions above — implements the\n * `AppSyncableNamespaceStore` interface required by `createAppSpecificFactory`\n * and the sync applier.\n */\nexport class SqliteAppSyncableNamespaceStore implements AppSyncableNamespaceStore {\n constructor(private readonly db: DatabaseSync) {}\n\n get(appId: string): AppSyncableNamespace | null {\n return getAppSyncableNamespace(this.db, appId);\n }\n\n list(): AppSyncableNamespace[] {\n return listAppSyncableNamespaces(this.db);\n }\n}\n","import type { DatabaseSync } from \"node:sqlite\";\nimport type { HLCTimestamp } from \"@starkeep/protocol-primitives\";\nimport { serializeHLC, deserializeHLC } from \"@starkeep/protocol-primitives\";\nimport type { AppSyncableApplier, AppSyncableRowEntry, AppSyncableNamespaceStore, ScanCapableApplier, ScanSinceOptions, ScanSincePage } from \"@starkeep/shared-space-api\";\nimport { appSyncableTableName } from \"./namespace.js\";\n\n/**\n * SQLite-backed implementation of `AppSyncableApplier`.\n *\n * All writes use the LWW (last-write-wins) rule based on the HLC-serialized\n * `updated_at` column: an incoming entry is only applied if its timestamp is\n * strictly greater than the row's current `updated_at`. This makes the applier\n * idempotent — replaying the same entry twice is a no-op.\n *\n * Delete is soft: the `deleted_at` column is set rather than removing the row\n * so that the inline-HLC pull path can propagate tombstones to other clients.\n */\nexport class SqliteAppSyncableApplier\n implements AppSyncableApplier, ScanCapableApplier\n{\n constructor(\n private readonly db: DatabaseSync,\n private readonly namespace: AppSyncableNamespaceStore,\n ) {}\n\n apply(entry: AppSyncableRowEntry): void {\n const ns = this.namespace.get(entry.appId);\n if (!ns) {\n throw new Error(\n `SqliteAppSyncableApplier: app \"${entry.appId}\" not installed`,\n );\n }\n const tableInfo = ns.tables.find((t) => t.name === entry.table);\n if (!tableInfo) {\n throw new Error(\n `SqliteAppSyncableApplier: table \"${entry.table}\" not declared for app \"${entry.appId}\"`,\n );\n }\n\n const fullName = appSyncableTableName(entry.appId, entry.table);\n const { pkColumns } = tableInfo;\n\n if (entry.op === \"insert\") {\n this.applyInsert(fullName, pkColumns, entry);\n } else if (entry.op === \"update\") {\n this.applyUpdate(fullName, entry);\n } else {\n this.applyDelete(fullName, entry);\n }\n }\n\n private applyInsert(\n fullName: string,\n pkColumns: string[],\n entry: AppSyncableRowEntry,\n ): void {\n const row = withNodeId(entry.row ?? {}, entry);\n const cols = Object.keys(row);\n if (cols.length === 0) return;\n\n const colList = cols.map(q).join(\", \");\n const placeholders = cols.map(() => \"?\").join(\", \");\n const values = cols.map((c) => row[c] as unknown);\n\n if (pkColumns.length === 0) {\n // No PK declared — just insert, ignoring duplicates.\n this.db\n .prepare(`INSERT OR IGNORE INTO ${q(fullName)} (${colList}) VALUES (${placeholders})`)\n .run(...(values as never[]));\n return;\n }\n\n // UPSERT with LWW: only overwrite if the incoming updated_at is newer.\n const conflictTarget = pkColumns.map(q).join(\", \");\n const updateCols = cols.filter((c) => !pkColumns.includes(c));\n if (updateCols.length === 0) {\n this.db\n .prepare(\n `INSERT OR IGNORE INTO ${q(fullName)} (${colList}) VALUES (${placeholders})`,\n )\n .run(...(values as never[]));\n return;\n }\n const setClause = updateCols.map((c) => `${q(c)} = excluded.${q(c)}`).join(\", \");\n this.db\n .prepare(\n `INSERT INTO ${q(fullName)} (${colList}) VALUES (${placeholders})\n ON CONFLICT(${conflictTarget}) DO UPDATE SET ${setClause}\n WHERE excluded.updated_at > ${q(fullName)}.updated_at`,\n )\n .run(...(values as never[]));\n }\n\n private applyUpdate(fullName: string, entry: AppSyncableRowEntry): void {\n // node_id rides along whenever updated_at changes (it's derived from it).\n const rawPatch = entry.row ?? {};\n const patch = rawPatch[\"updated_at\"] ? withNodeId(rawPatch, entry) : rawPatch;\n const where = entry.where ?? {};\n const patchCols = Object.keys(patch);\n const whereCols = Object.keys(where);\n if (patchCols.length === 0) return;\n\n const setClause = patchCols.map((c) => `${q(c)} = ?`).join(\", \");\n // Only apply if the incoming updated_at is strictly newer (LWW).\n const incomingUpdatedAt = patch[\"updated_at\"] as string | undefined;\n const conditions: string[] = whereCols.map((c) => `${q(c)} = ?`);\n if (incomingUpdatedAt) conditions.push(`updated_at < ?`);\n const whereClause = conditions.length ? \" WHERE \" + conditions.join(\" AND \") : \"\";\n\n const params: unknown[] = [\n ...patchCols.map((c) => patch[c]),\n ...whereCols.map((c) => where[c]),\n ];\n if (incomingUpdatedAt) params.push(incomingUpdatedAt);\n\n this.db\n .prepare(`UPDATE ${q(fullName)} SET ${setClause}${whereClause}`)\n .run(...(params as never[]));\n }\n\n private applyDelete(fullName: string, entry: AppSyncableRowEntry): void {\n const where = entry.where ?? {};\n const whereCols = Object.keys(where);\n // Soft-delete: set deleted_at and updated_at (and node_id with it).\n const incomingUpdatedAt = entry.row?.[\"updated_at\"] as string | undefined;\n const ts = incomingUpdatedAt ?? serializeHLC(entry.timestamp);\n\n const conditions: string[] = [\n ...whereCols.map((c) => `${q(c)} = ?`),\n `(updated_at IS NULL OR updated_at < ?)`,\n ];\n const whereClause = \" WHERE \" + conditions.join(\" AND \");\n\n // params order: SET deleted_at=?, updated_at=?, node_id=?, then WHERE bindings\n const params: unknown[] = [\n ts,\n ts,\n nodeIdOf(ts, entry),\n ...whereCols.map((c) => where[c]),\n ts, // for the LWW updated_at < ? condition\n ];\n\n this.db\n .prepare(\n `UPDATE ${q(fullName)} SET deleted_at = ?, updated_at = ?, node_id = ?${whereClause}`,\n )\n .run(...(params as never[]));\n }\n\n /** See `ScanCapableApplier.getNodeWatermarks`. Missing table → `{}`. */\n async getNodeWatermarks(\n appId: string,\n table: string,\n ): Promise<Record<string, HLCTimestamp>> {\n const fullName = appSyncableTableName(appId, table);\n let rows: { node_id: string; max_updated_at: string }[];\n try {\n rows = this.db\n .prepare(\n `SELECT node_id, MAX(updated_at) AS max_updated_at FROM ${q(fullName)} GROUP BY node_id`,\n )\n .all() as { node_id: string; max_updated_at: string }[];\n } catch {\n // Table might not exist yet (app not installed locally).\n return {};\n }\n const out: Record<string, HLCTimestamp> = {};\n for (const row of rows) {\n out[row.node_id] = deserializeHLC(row.max_updated_at);\n }\n return out;\n }\n\n /**\n * Pull-side synthesis: return rows updated after `sinceHlcStr` (or `cursor`\n * if higher) in HLC order, paginated. `updated_at` is a serialized HLC\n * whose lexicographic order matches HLC order (fixed-width hex), and each\n * row's HLC is unique per node, so it doubles as the cursor — no separate\n * tiebreaker column is needed.\n */\n async scanSince(\n appId: string,\n table: string,\n sinceHlcStr: string,\n options?: ScanSinceOptions,\n ): Promise<ScanSincePage> {\n const fullName = appSyncableTableName(appId, table);\n const floor =\n options?.cursor !== undefined && options.cursor > sinceHlcStr\n ? options.cursor\n : sinceHlcStr;\n const limit = options?.limit;\n let rows: Record<string, unknown>[];\n try {\n if (limit !== undefined) {\n rows = this.db\n .prepare(\n `SELECT * FROM ${q(fullName)} WHERE updated_at > ? ORDER BY updated_at ASC LIMIT ?`,\n )\n .all(floor, limit + 1) as Record<string, unknown>[];\n } else {\n rows = this.db\n .prepare(\n `SELECT * FROM ${q(fullName)} WHERE updated_at > ? ORDER BY updated_at ASC`,\n )\n .all(floor) as Record<string, unknown>[];\n }\n } catch {\n // Table might not exist yet (app not installed locally).\n return { rows: [], nextCursor: null, hasMore: false };\n }\n const hasMore = limit !== undefined && rows.length > limit;\n const pageRows = hasMore ? rows.slice(0, limit) : rows;\n const entries = pageRows.map((row) => rowToEntry(appId, table, row));\n const nextCursor =\n hasMore && pageRows.length > 0\n ? (pageRows[pageRows.length - 1]![\"updated_at\"] as string)\n : null;\n return { rows: entries, nextCursor, hasMore };\n }\n\n /** Support read path from the factory's queryRows. */\n queryRows(\n appId: string,\n table: string,\n where?: Record<string, unknown>,\n ): Record<string, unknown>[] {\n const fullName = appSyncableTableName(appId, table);\n const whereCols = where ? Object.keys(where) : [];\n // Filter out soft-deleted rows by default.\n const whereClause = [\n \"deleted_at IS NULL\",\n ...whereCols.map((c) => `${q(c)} = ?`),\n ].join(\" AND \");\n return this.db\n .prepare(`SELECT * FROM ${q(fullName)} WHERE ${whereClause}`)\n .all(...(whereCols.map((c) => where![c]) as never[])) as Record<string, unknown>[];\n }\n}\n\nfunction q(name: string): string {\n return `\"${name}\"`;\n}\n\n/**\n * Return `row` with `node_id` set from its `updated_at` (falling back to the\n * entry timestamp). Writers can't be trusted to carry the column — locally\n * authored entries and older wire rows don't — so the applier derives it at\n * write time, keeping the NOT NULL invariant without touching every producer.\n */\nfunction withNodeId(\n row: Record<string, unknown>,\n entry: AppSyncableRowEntry,\n): Record<string, unknown> {\n return { ...row, node_id: nodeIdOf(row[\"updated_at\"], entry) };\n}\n\n/** nodeId from a serialized-HLC `updated_at`, or the entry timestamp's. */\nfunction nodeIdOf(updatedAt: unknown, entry: AppSyncableRowEntry): string {\n if (typeof updatedAt === \"string\") {\n try {\n return deserializeHLC(updatedAt).nodeId;\n } catch {\n // Not a serialized HLC — fall through to the entry timestamp.\n }\n }\n return entry.timestamp.nodeId;\n}\n\nfunction rowToEntry(\n appId: string,\n table: string,\n row: Record<string, unknown>,\n): AppSyncableRowEntry {\n const updatedAtStr = row[\"updated_at\"] as string;\n const deletedAtStr = row[\"deleted_at\"] as string | null | undefined;\n const timestamp = deserializeHLC(updatedAtStr);\n\n // For wire propagation we emit op=\"insert\" (upsert) for live rows so the\n // receiver creates the row if it doesn't exist yet. op=\"update\" only\n // targets existing rows and would silently drop new rows during initial\n // sync. Tombstones still ride the soft-delete path.\n if (deletedAtStr) {\n return { timestamp, appId, table, op: \"delete\", row };\n }\n return { timestamp, appId, table, op: \"insert\", row };\n}\n"],"mappings":"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","names":["serializeHLC","deserializeHLC","serializeHLC","deserializeHLC","serializeHLC","deserializeHLC","serializeHLC","deserializeHLC"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@starkeep/storage-sqlite",
|
|
3
|
-
"version": "0.1
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.cjs",
|
|
@@ -22,16 +22,15 @@
|
|
|
22
22
|
},
|
|
23
23
|
"repository": {
|
|
24
24
|
"type": "git",
|
|
25
|
-
"url": "git+https://github.com/starkeep-
|
|
25
|
+
"url": "git+https://github.com/starkeep-org/starkeep-core.git",
|
|
26
26
|
"directory": "packages/storage-sqlite"
|
|
27
27
|
},
|
|
28
|
-
"homepage": "https://github.com/starkeep-
|
|
28
|
+
"homepage": "https://github.com/starkeep-org/starkeep-core/tree/main/packages/storage-sqlite",
|
|
29
29
|
"dependencies": {
|
|
30
30
|
"kysely": "^0.27.0",
|
|
31
|
-
"@starkeep/
|
|
32
|
-
"@starkeep/storage-adapter": "0.1
|
|
33
|
-
"@starkeep/shared-space-api": "0.1
|
|
34
|
-
"@starkeep/protocol-primitives": "0.1.0"
|
|
31
|
+
"@starkeep/protocol-primitives": "0.2.1",
|
|
32
|
+
"@starkeep/storage-adapter": "0.2.1",
|
|
33
|
+
"@starkeep/shared-space-api": "0.2.1"
|
|
35
34
|
},
|
|
36
35
|
"devDependencies": {
|
|
37
36
|
"@types/node": "^25.4.0",
|