latticesql 0.9.0 → 0.10.0

package/dist/cli.js

@@ -1389,6 +1389,7 @@ var Lattice = class {
   _renderHandlers = [];
   _writebackHandlers = [];
   _errorHandlers = [];
+  _writeHooks = [];
   constructor(pathOrConfig, options = {}) {
     let dbPath;
     let configTables;
@@ -1448,6 +1449,14 @@ var Lattice = class {
     this._schema.defineEntityContext(table, def);
     return this;
   }
+  /**
+   * Register a write hook that fires after insert/update/delete operations.
+   * Hooks run synchronously after the DB write and audit emit.
+   */
+  defineWriteHook(hook) {
+    this._writeHooks.push(hook);
+    return this;
+  }
   defineWriteback(def) {
     this._writeback.define(def);
     return this;
@@ -1497,6 +1506,7 @@ var Lattice = class {
     const rawPk = rowWithPk[pkCol];
     const pkValue = rawPk != null ? String(rawPk) : "";
     this._sanitizer.emitAudit(table, "insert", pkValue);
+    this._fireWriteHooks(table, "insert", rowWithPk, pkValue);
     return Promise.resolve(pkValue);
   }
   upsert(table, row) {
@@ -1550,6 +1560,7 @@ var Lattice = class {
     this._adapter.run(`UPDATE "${table}" SET ${setCols} WHERE ${clause}`, values);
     const auditId = typeof id === "string" ? id : JSON.stringify(id);
     this._sanitizer.emitAudit(table, "update", auditId);
+    this._fireWriteHooks(table, "update", sanitized, auditId, Object.keys(sanitized));
     return Promise.resolve();
   }
   delete(table, id) {
@@ -1559,6 +1570,7 @@ var Lattice = class {
     this._adapter.run(`DELETE FROM "${table}" WHERE ${clause}`, params);
     const auditId = typeof id === "string" ? id : JSON.stringify(id);
     this._sanitizer.emitAudit(table, "delete", auditId);
+    this._fireWriteHooks(table, "delete", { id: auditId }, auditId);
     return Promise.resolve();
   }
   get(table, id) {
@@ -1796,6 +1808,22 @@ var Lattice = class {
     return { clauses, params };
   }
   /** Returns a rejected Promise if not initialized; null if ready. */
+  _fireWriteHooks(table, op, row, pk, changedColumns) {
+    for (const hook of this._writeHooks) {
+      if (hook.table !== table) continue;
+      if (!hook.on.includes(op)) continue;
+      if (op === "update" && hook.watchColumns && changedColumns) {
+        if (!hook.watchColumns.some((c) => changedColumns.includes(c))) continue;
+      }
+      try {
+        const ctx = { table, op, row, pk };
+        if (changedColumns) ctx.changedColumns = changedColumns;
+        hook.handler(ctx);
+      } catch (err) {
+        for (const h of this._errorHandlers) h(err instanceof Error ? err : new Error(String(err)));
+      }
+    }
+  }
   _notInitError() {
     if (!this._initialized) {
       return Promise.reject(

package/dist/index.cjs

@@ -1363,6 +1363,7 @@ var Lattice = class {
   _renderHandlers = [];
   _writebackHandlers = [];
   _errorHandlers = [];
+  _writeHooks = [];
   constructor(pathOrConfig, options = {}) {
     let dbPath;
     let configTables;
@@ -1422,6 +1423,14 @@ var Lattice = class {
     this._schema.defineEntityContext(table, def);
     return this;
   }
+  /**
+   * Register a write hook that fires after insert/update/delete operations.
+   * Hooks run synchronously after the DB write and audit emit.
+   */
+  defineWriteHook(hook) {
+    this._writeHooks.push(hook);
+    return this;
+  }
   defineWriteback(def) {
     this._writeback.define(def);
     return this;
@@ -1471,6 +1480,7 @@ var Lattice = class {
     const rawPk = rowWithPk[pkCol];
     const pkValue = rawPk != null ? String(rawPk) : "";
     this._sanitizer.emitAudit(table, "insert", pkValue);
+    this._fireWriteHooks(table, "insert", rowWithPk, pkValue);
     return Promise.resolve(pkValue);
   }
   upsert(table, row) {
@@ -1524,6 +1534,7 @@ var Lattice = class {
     this._adapter.run(`UPDATE "${table}" SET ${setCols} WHERE ${clause}`, values);
     const auditId = typeof id === "string" ? id : JSON.stringify(id);
     this._sanitizer.emitAudit(table, "update", auditId);
+    this._fireWriteHooks(table, "update", sanitized, auditId, Object.keys(sanitized));
     return Promise.resolve();
   }
   delete(table, id) {
@@ -1533,6 +1544,7 @@ var Lattice = class {
     this._adapter.run(`DELETE FROM "${table}" WHERE ${clause}`, params);
     const auditId = typeof id === "string" ? id : JSON.stringify(id);
     this._sanitizer.emitAudit(table, "delete", auditId);
+    this._fireWriteHooks(table, "delete", { id: auditId }, auditId);
     return Promise.resolve();
   }
   get(table, id) {
@@ -1770,6 +1782,22 @@ var Lattice = class {
     return { clauses, params };
   }
   /** Returns a rejected Promise if not initialized; null if ready. */
+  _fireWriteHooks(table, op, row, pk, changedColumns) {
+    for (const hook of this._writeHooks) {
+      if (hook.table !== table) continue;
+      if (!hook.on.includes(op)) continue;
+      if (op === "update" && hook.watchColumns && changedColumns) {
+        if (!hook.watchColumns.some((c) => changedColumns.includes(c))) continue;
+      }
+      try {
+        const ctx = { table, op, row, pk };
+        if (changedColumns) ctx.changedColumns = changedColumns;
+        hook.handler(ctx);
+      } catch (err) {
+        for (const h of this._errorHandlers) h(err instanceof Error ? err : new Error(String(err)));
+      }
+    }
+  }
   _notInitError() {
     if (!this._initialized) {
       return Promise.reject(

package/dist/index.d.cts

@@ -749,6 +749,45 @@ interface AuditEvent {
     id: string;
     timestamp: string;
 }
+/**
+ * Context passed to write hook handlers.
+ */
+interface WriteHookContext {
+    /** Table that was modified. */
+    table: string;
+    /** The operation that triggered the hook. */
+    op: 'insert' | 'update' | 'delete';
+    /** The row data (for insert: full row; for update: changed fields; for delete: { id }). */
+    row: Row;
+    /** Primary key value(s) of the affected row. */
+    pk: string;
+    /** For updates: the column names that were changed. */
+    changedColumns?: string[];
+}
+/**
+ * A write hook fires after insert/update/delete operations.
+ *
+ * @example
+ * ```ts
+ * db.defineWriteHook({
+ *   table: 'agents',
+ *   on: ['insert', 'update'],
+ *   watchColumns: ['team_id'],
+ *   handler: (ctx) => { denormalizeTeamFields(ctx.pk); },
+ * });
+ * ```
+ */
+interface WriteHook {
+    /** Table the hook fires on. */
+    table: string;
+    /** Operations that trigger the hook. */
+    on: Array<'insert' | 'update' | 'delete'>;
+    /** Only fire on update when these columns changed. Omit = fire on any change. */
+    watchColumns?: string[];
+    /** Handler function. Runs synchronously after the DB write. */
+    handler: (ctx: WriteHookContext) => void;
+}
+
 interface ReconcileOptions {
     /** Remove entity directories whose slug is no longer in the DB. Default: true. */
     removeOrphanedDirectories?: boolean;
@@ -801,10 +840,16 @@ declare class Lattice {
     private readonly _renderHandlers;
     private readonly _writebackHandlers;
     private readonly _errorHandlers;
+    private readonly _writeHooks;
     constructor(pathOrConfig: string | LatticeConfigInput, options?: LatticeOptions);
     define(table: string, def: TableDefinition): this;
     defineMulti(name: string, def: MultiTableDefinition): this;
     defineEntityContext(table: string, def: EntityContextDefinition): this;
+    /**
+     * Register a write hook that fires after insert/update/delete operations.
+     * Hooks run synchronously after the DB write and audit emit.
+     */
+    defineWriteHook(hook: WriteHook): this;
     defineWriteback(def: WritebackDefinition): this;
     init(options?: InitOptions): Promise<void>;
     close(): void;
@@ -850,6 +895,7 @@ declare class Lattice {
      */
     private _buildFilters;
     /** Returns a rejected Promise if not initialized; null if ready. */
+    private _fireWriteHooks;
     private _notInitError;
     /**
      * Returns a rejected Promise if any of the given column names are not present
@@ -1305,4 +1351,4 @@ declare function createReadOnlyHeader(options?: ReadOnlyHeaderOptions): string;
  */
 declare const READ_ONLY_HEADER: string;
 
-export { type ApplyWriteResult, type AuditEvent, type BelongsToRelation, type BelongsToSource, type BuiltinTemplateName, type CleanupOptions, type CleanupResult, type CountOptions, type CustomSource, DEFAULT_ENTRY_TYPES, DEFAULT_TYPE_ALIASES, type EnrichedSource, type EnrichmentLookup, type EntityContextDefinition, type EntityContextManifestEntry, type EntityFileSource, type EntityFileSpec, type EntityProfileField, type EntityProfileSection, type EntityProfileTemplate, type EntityRenderSpec, type EntityRenderTemplate, type EntitySectionPerRow, type EntitySectionsTemplate, type EntityTableColumn, type EntityTableTemplate, type Filter, type FilterOp, type HasManyRelation, type HasManySource, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type ManyToManySource, type MarkdownTableColumn, type Migration, type MultiTableDefinition, type OrderBySpec, type ParseError, type ParseResult, type ParsedConfig, type PkLookup, type PrimaryKey, type QueryOptions, READ_ONLY_HEADER, type ReadOnlyHeaderOptions, type ReconcileOptions, type ReconcileResult, type Relation, type RenderHooks, type RenderResult, type RenderSpec, type Row, type SecurityOptions, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type WatchOptions, type WritebackDefinition, applyWriteEntry, createReadOnlyHeader, frontmatter, generateEntryId, generateWriteEntryId, manifestPath, markdownTable, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, slugify, truncate, validateEntryId, writeManifest };
+export { type ApplyWriteResult, type AuditEvent, type BelongsToRelation, type BelongsToSource, type BuiltinTemplateName, type CleanupOptions, type CleanupResult, type CountOptions, type CustomSource, DEFAULT_ENTRY_TYPES, DEFAULT_TYPE_ALIASES, type EnrichedSource, type EnrichmentLookup, type EntityContextDefinition, type EntityContextManifestEntry, type EntityFileSource, type EntityFileSpec, type EntityProfileField, type EntityProfileSection, type EntityProfileTemplate, type EntityRenderSpec, type EntityRenderTemplate, type EntitySectionPerRow, type EntitySectionsTemplate, type EntityTableColumn, type EntityTableTemplate, type Filter, type FilterOp, type HasManyRelation, type HasManySource, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type ManyToManySource, type MarkdownTableColumn, type Migration, type MultiTableDefinition, type OrderBySpec, type ParseError, type ParseResult, type ParsedConfig, type PkLookup, type PrimaryKey, type QueryOptions, READ_ONLY_HEADER, type ReadOnlyHeaderOptions, type ReconcileOptions, type ReconcileResult, type Relation, type RenderHooks, type RenderResult, type RenderSpec, type Row, type SecurityOptions, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type WatchOptions, type WriteHook, type WriteHookContext, type WritebackDefinition, applyWriteEntry, createReadOnlyHeader, frontmatter, generateEntryId, generateWriteEntryId, manifestPath, markdownTable, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, slugify, truncate, validateEntryId, writeManifest };

package/dist/index.d.ts

@@ -749,6 +749,45 @@ interface AuditEvent {
     id: string;
     timestamp: string;
 }
+/**
+ * Context passed to write hook handlers.
+ */
+interface WriteHookContext {
+    /** Table that was modified. */
+    table: string;
+    /** The operation that triggered the hook. */
+    op: 'insert' | 'update' | 'delete';
+    /** The row data (for insert: full row; for update: changed fields; for delete: { id }). */
+    row: Row;
+    /** Primary key value(s) of the affected row. */
+    pk: string;
+    /** For updates: the column names that were changed. */
+    changedColumns?: string[];
+}
+/**
+ * A write hook fires after insert/update/delete operations.
+ *
+ * @example
+ * ```ts
+ * db.defineWriteHook({
+ *   table: 'agents',
+ *   on: ['insert', 'update'],
+ *   watchColumns: ['team_id'],
+ *   handler: (ctx) => { denormalizeTeamFields(ctx.pk); },
+ * });
+ * ```
+ */
+interface WriteHook {
+    /** Table the hook fires on. */
+    table: string;
+    /** Operations that trigger the hook. */
+    on: Array<'insert' | 'update' | 'delete'>;
+    /** Only fire on update when these columns changed. Omit = fire on any change. */
+    watchColumns?: string[];
+    /** Handler function. Runs synchronously after the DB write. */
+    handler: (ctx: WriteHookContext) => void;
+}
+
 interface ReconcileOptions {
     /** Remove entity directories whose slug is no longer in the DB. Default: true. */
     removeOrphanedDirectories?: boolean;
@@ -801,10 +840,16 @@ declare class Lattice {
     private readonly _renderHandlers;
     private readonly _writebackHandlers;
     private readonly _errorHandlers;
+    private readonly _writeHooks;
     constructor(pathOrConfig: string | LatticeConfigInput, options?: LatticeOptions);
     define(table: string, def: TableDefinition): this;
     defineMulti(name: string, def: MultiTableDefinition): this;
     defineEntityContext(table: string, def: EntityContextDefinition): this;
+    /**
+     * Register a write hook that fires after insert/update/delete operations.
+     * Hooks run synchronously after the DB write and audit emit.
+     */
+    defineWriteHook(hook: WriteHook): this;
     defineWriteback(def: WritebackDefinition): this;
     init(options?: InitOptions): Promise<void>;
     close(): void;
@@ -850,6 +895,7 @@ declare class Lattice {
      */
     private _buildFilters;
     /** Returns a rejected Promise if not initialized; null if ready. */
+    private _fireWriteHooks;
     private _notInitError;
     /**
      * Returns a rejected Promise if any of the given column names are not present
@@ -1305,4 +1351,4 @@ declare function createReadOnlyHeader(options?: ReadOnlyHeaderOptions): string;
  */
 declare const READ_ONLY_HEADER: string;
 
-export { type ApplyWriteResult, type AuditEvent, type BelongsToRelation, type BelongsToSource, type BuiltinTemplateName, type CleanupOptions, type CleanupResult, type CountOptions, type CustomSource, DEFAULT_ENTRY_TYPES, DEFAULT_TYPE_ALIASES, type EnrichedSource, type EnrichmentLookup, type EntityContextDefinition, type EntityContextManifestEntry, type EntityFileSource, type EntityFileSpec, type EntityProfileField, type EntityProfileSection, type EntityProfileTemplate, type EntityRenderSpec, type EntityRenderTemplate, type EntitySectionPerRow, type EntitySectionsTemplate, type EntityTableColumn, type EntityTableTemplate, type Filter, type FilterOp, type HasManyRelation, type HasManySource, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type ManyToManySource, type MarkdownTableColumn, type Migration, type MultiTableDefinition, type OrderBySpec, type ParseError, type ParseResult, type ParsedConfig, type PkLookup, type PrimaryKey, type QueryOptions, READ_ONLY_HEADER, type ReadOnlyHeaderOptions, type ReconcileOptions, type ReconcileResult, type Relation, type RenderHooks, type RenderResult, type RenderSpec, type Row, type SecurityOptions, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type WatchOptions, type WritebackDefinition, applyWriteEntry, createReadOnlyHeader, frontmatter, generateEntryId, generateWriteEntryId, manifestPath, markdownTable, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, slugify, truncate, validateEntryId, writeManifest };
+export { type ApplyWriteResult, type AuditEvent, type BelongsToRelation, type BelongsToSource, type BuiltinTemplateName, type CleanupOptions, type CleanupResult, type CountOptions, type CustomSource, DEFAULT_ENTRY_TYPES, DEFAULT_TYPE_ALIASES, type EnrichedSource, type EnrichmentLookup, type EntityContextDefinition, type EntityContextManifestEntry, type EntityFileSource, type EntityFileSpec, type EntityProfileField, type EntityProfileSection, type EntityProfileTemplate, type EntityRenderSpec, type EntityRenderTemplate, type EntitySectionPerRow, type EntitySectionsTemplate, type EntityTableColumn, type EntityTableTemplate, type Filter, type FilterOp, type HasManyRelation, type HasManySource, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type ManyToManySource, type MarkdownTableColumn, type Migration, type MultiTableDefinition, type OrderBySpec, type ParseError, type ParseResult, type ParsedConfig, type PkLookup, type PrimaryKey, type QueryOptions, READ_ONLY_HEADER, type ReadOnlyHeaderOptions, type ReconcileOptions, type ReconcileResult, type Relation, type RenderHooks, type RenderResult, type RenderSpec, type Row, type SecurityOptions, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type WatchOptions, type WriteHook, type WriteHookContext, type WritebackDefinition, applyWriteEntry, createReadOnlyHeader, frontmatter, generateEntryId, generateWriteEntryId, manifestPath, markdownTable, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, slugify, truncate, validateEntryId, writeManifest };

package/dist/index.js

@@ -1307,6 +1307,7 @@ var Lattice = class {
   _renderHandlers = [];
   _writebackHandlers = [];
   _errorHandlers = [];
+  _writeHooks = [];
   constructor(pathOrConfig, options = {}) {
     let dbPath;
     let configTables;
@@ -1366,6 +1367,14 @@ var Lattice = class {
     this._schema.defineEntityContext(table, def);
     return this;
   }
+  /**
+   * Register a write hook that fires after insert/update/delete operations.
+   * Hooks run synchronously after the DB write and audit emit.
+   */
+  defineWriteHook(hook) {
+    this._writeHooks.push(hook);
+    return this;
+  }
   defineWriteback(def) {
     this._writeback.define(def);
     return this;
@@ -1415,6 +1424,7 @@ var Lattice = class {
     const rawPk = rowWithPk[pkCol];
     const pkValue = rawPk != null ? String(rawPk) : "";
     this._sanitizer.emitAudit(table, "insert", pkValue);
+    this._fireWriteHooks(table, "insert", rowWithPk, pkValue);
     return Promise.resolve(pkValue);
   }
   upsert(table, row) {
@@ -1468,6 +1478,7 @@ var Lattice = class {
     this._adapter.run(`UPDATE "${table}" SET ${setCols} WHERE ${clause}`, values);
     const auditId = typeof id === "string" ? id : JSON.stringify(id);
     this._sanitizer.emitAudit(table, "update", auditId);
+    this._fireWriteHooks(table, "update", sanitized, auditId, Object.keys(sanitized));
     return Promise.resolve();
   }
   delete(table, id) {
@@ -1477,6 +1488,7 @@ var Lattice = class {
     this._adapter.run(`DELETE FROM "${table}" WHERE ${clause}`, params);
     const auditId = typeof id === "string" ? id : JSON.stringify(id);
     this._sanitizer.emitAudit(table, "delete", auditId);
+    this._fireWriteHooks(table, "delete", { id: auditId }, auditId);
     return Promise.resolve();
   }
   get(table, id) {
@@ -1714,6 +1726,22 @@ var Lattice = class {
     return { clauses, params };
   }
   /** Returns a rejected Promise if not initialized; null if ready. */
+  _fireWriteHooks(table, op, row, pk, changedColumns) {
+    for (const hook of this._writeHooks) {
+      if (hook.table !== table) continue;
+      if (!hook.on.includes(op)) continue;
+      if (op === "update" && hook.watchColumns && changedColumns) {
+        if (!hook.watchColumns.some((c) => changedColumns.includes(c))) continue;
+      }
+      try {
+        const ctx = { table, op, row, pk };
+        if (changedColumns) ctx.changedColumns = changedColumns;
+        hook.handler(ctx);
+      } catch (err) {
+        for (const h of this._errorHandlers) h(err instanceof Error ? err : new Error(String(err)));
+      }
+    }
+  }
   _notInitError() {
     if (!this._initialized) {
       return Promise.reject(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "latticesql",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Persistent structured memory for AI agent systems — SQLite ↔ LLM context bridge",
   "type": "module",
   "main": "./dist/index.js",