@everystack/events 0.3.0 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@everystack/events",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "PostgreSQL LISTEN/NOTIFY bridge for serverless — WebSocket fan-out + Lambda invocation",
   "license": "AGPL-3.0-only",
   "author": "Scalable Technology, Inc. <licensing@scalable.technology>",
@@ -55,7 +55,7 @@
     }
   },
   "dependencies": {
-    "@everystack/model": "0.3.3"
+    "@everystack/model": "0.4.4"
   },
   "peerDependencies": {
     "@aws-sdk/client-apigatewaymanagementapi": "3.1053.0",
@@ -64,7 +64,7 @@
     "@aws-sdk/signature-v4a": "3.1031.0",
     "@tanstack/react-query": "5.100.9",
     "drizzle-orm": "0.41.0",
-    "react": "19.2.6"
+    "react": "19.2.0"
   },
   "peerDependenciesMeta": {
     "@aws-sdk/client-cloudfront-keyvaluestore": {
@@ -96,10 +96,10 @@
     "@types/react": "19.2.14",
     "drizzle-orm": "0.41.0",
     "jest": "29.7.0",
-    "react": "19.2.6",
+    "react": "19.2.0",
     "ts-jest": "29.4.9",
     "typescript": "5.9.3",
-    "@everystack/auth": "0.3.0"
+    "@everystack/auth": "0.4.0"
   },
   "scripts": {
     "test": "jest",

package/src/models/descriptors.ts

@@ -0,0 +1,77 @@
+/**
+ * The events package's DECLARED derived layer — the notify functions and the trigger
+ * factory, as descriptors (docs/plans/read-model-everywhere.md). Supersedes the raw-SQL
+ * generators in `../triggers` (kept, deprecated, for the transition): declared objects
+ * are content-hashed, dependency-ordered, drift-checked by db:reconcile, and — because
+ * every compiled function revokes EXECUTE from PUBLIC — secure by default.
+ *
+ * Trigger attachment stays the APP's choice, now with owner consent visible in the
+ * model: each emitting table declares `triggers: [eventsTrigger('posts_events')]`
+ * itself — a package can offer a trigger, never silently attach one.
+ */
+
+import { defineFunction, trigger, sql, type TriggerSpec } from '@everystack/model';
+
+/** `everystack_notify()` — row-change events onto the `events` NOTIFY channel. */
+export const notifyFunction = defineFunction('everystack_notify', {
+  returns: 'trigger',
+  language: 'plpgsql',
+  body: sql`
+DECLARE
+  row_id text;
+BEGIN
+  -- A composite-key table (e.g. likes (user_id, post_id)) has no id column, so NEW.id
+  -- raises undefined_column — emit a NULL id rather than fail the whole write.
+  BEGIN
+    row_id := COALESCE(NEW.id, OLD.id);
+  EXCEPTION WHEN undefined_column THEN
+    row_id := NULL;
+  END;
+  PERFORM pg_notify(
+    'events',
+    json_build_object(
+      'schema', TG_TABLE_SCHEMA,
+      'table', TG_TABLE_NAME,
+      'op', lower(TG_OP),
+      'id', row_id
+    )::text
+  );
+  RETURN COALESCE(NEW, OLD);
+END`,
+});
+
+/**
+ * The event trigger for one emitting table — declared ON the model
+ * (`triggers: [eventsTrigger('posts_events')]`). Convention: `<table>_events`,
+ * matching what `generateTriggerSQL` created, so an existing database adopts via
+ * `db:reconcile --baseline` instead of rebuilding.
+ */
+export function eventsTrigger(name: string): TriggerSpec {
+  return trigger(name, {
+    timing: 'after',
+    events: ['insert', 'update', 'delete'],
+    forEach: 'row',
+    execute: notifyFunction,
+  });
+}
+
+/** `everystack_event_actions_notify()` — the rules table's self-notify (reload signal). */
+export const eventActionsNotifyFunction = defineFunction('everystack_event_actions_notify', {
+  returns: 'trigger',
+  language: 'plpgsql',
+  body: sql`
+BEGIN
+  PERFORM pg_notify('_event_actions', '{}');
+  RETURN COALESCE(NEW, OLD);
+END`,
+});
+
+/** The self-notify trigger for ops.event_actions — declared on the EventAction model. */
+export function eventActionsTrigger(): TriggerSpec {
+  return trigger('event_actions_notify', {
+    timing: 'after',
+    events: ['insert', 'update', 'delete'],
+    forEach: 'row',
+    execute: eventActionsNotifyFunction,
+  });
+}

package/src/models/event-action.ts

@@ -17,11 +17,14 @@
  */
 
 import { defineModel, field, can, index } from '@everystack/model';
+import { eventActionsTrigger } from './descriptors';
 
 export const EventAction = defineModel('event_actions', {
   schema: 'ops',
   writtenBy: 'worker',
   private: true,
+  // Owner consent, visible in the model: the reload-signal trigger is declared HERE.
+  triggers: [eventActionsTrigger()],
   fields: {
     id: field.uuid().primaryKey().defaultRandom(),
     tenantId: field.uuid().nullable(), // NULL = platform-wide, non-NULL = tenant-scoped

package/src/models/index.ts

@@ -9,9 +9,10 @@
 
 import { defineModule } from '@everystack/model';
 import { EventAction } from './event-action';
-import { generateEventActionsTriggerSQL } from '../triggers';
+import { eventActionsNotifyFunction, notifyFunction } from './descriptors';
 
 export { EventAction } from './event-action';
+export { notifyFunction, eventsTrigger, eventActionsNotifyFunction, eventActionsTrigger } from './descriptors';
 
 /** All events-owned models, for the app to spread into its db:generate model list. */
 export const eventModels = [EventAction];
@@ -22,5 +23,7 @@ export const eventModels = [EventAction];
  */
 export const eventModule = defineModule({
   models: eventModels,
-  functions: generateEventActionsTriggerSQL,
+  // The notify functions are DECLARED now (content-hashed, drift-checked, PUBLIC-revoked);
+  // notifyFunction ships here so app models can reference it via eventsTrigger(...).
+  derived: [notifyFunction, eventActionsNotifyFunction],
 });