@everystack/events 0.3.1 → 0.4.1

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+All notable changes to `@everystack/events` are documented here.
+
+Format based on [Keep a Changelog](https://keepachangelog.com/).
+
+## [0.4.1] - 2026-09-16
+
+### Added
+
+- auto-generated changelogs from conventional commits
+- automate the version-drift check — a manual note is not a gate
+
+## [0.4.0] - 2026-07-19
+
+### Added
+
+- descriptors go live in the verbs — the B3 wiring (read-model-everywhere)
+
+### Fixed
+
+- pin React to a single 19.2.0 across the monorepo
+- guard npm publish on workspace-dep packages; cli 0.3.8
+
+## [0.3.1] - 2026-06-30
+
+### Added
+
+- add @everystack/events package and wire real-time UI
+- data-driven event actions for admin-configurable routing
+- own ops.event_actions as a v3 Model + eventModule
+- wire cache invalidation + event-driven jobs in example app
+
+### Fixed
+
+- add AWS KVS + SigV4a as direct dependencies
+- pin all dependency versions to lockfile-resolved values
+- revert @aws-sdk/signature-v4a to 3.1031.0, fix KVS SigV4a signing
+- everystack_notify guards NEW.id for composite-key tables
+- extensionless relative imports (repo convention; Metro resolution)
+
+### Changed
+
+- migrate all package schemas to everyschema canonical tables
+- drop type module from all packages, switch Jest to CJS mode
+- consolidate Jest configs into shared base
+- route server imports through react-free package doors

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@everystack/events",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "PostgreSQL LISTEN/NOTIFY bridge for serverless — WebSocket fan-out + Lambda invocation",
   "license": "AGPL-3.0-only",
   "author": "Scalable Technology, Inc. <licensing@scalable.technology>",
@@ -18,44 +18,53 @@
   },
   "files": [
     "src",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./src/index.ts",
       "default": "./src/index.ts"
     },
     "./triggers": {
+      "source": "./src/triggers.ts",
       "types": "./src/triggers.ts",
       "default": "./src/triggers.ts"
     },
     "./handler": {
+      "source": "./src/handler/index.ts",
       "types": "./src/handler/index.ts",
       "default": "./src/handler/index.ts"
     },
     "./schema": {
+      "source": "./src/schema.ts",
       "types": "./src/schema.ts",
       "default": "./src/schema.ts"
     },
     "./models": {
+      "source": "./src/models/index.ts",
       "types": "./src/models/index.ts",
       "default": "./src/models/index.ts"
     },
     "./client": {
+      "source": "./src/client/index.ts",
       "types": "./src/client/index.ts",
       "default": "./src/client/index.ts"
     },
     "./actions": {
+      "source": "./src/actions.ts",
       "types": "./src/actions.ts",
       "default": "./src/actions.ts"
     },
     "./listener": {
+      "source": "./src/listener.ts",
       "types": "./src/listener.ts",
       "default": "./src/listener.ts"
     }
   },
   "dependencies": {
-    "@everystack/model": "0.3.3"
+    "@everystack/model": "0.4.18"
   },
   "peerDependencies": {
     "@aws-sdk/client-apigatewaymanagementapi": "3.1053.0",
@@ -64,7 +73,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 +105,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.1"
+    "@everystack/auth": "0.4.5"
   },
   "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],
 });