@minion-stack/shared 0.5.0 → 0.6.0

package/dist/gateway/cache-events.d.ts

@@ -0,0 +1,22 @@
+export type CacheInvalidateSource = 'hub' | 'gateway' | 'paperclip' | 'browser' | 'site';
+export interface CacheInvalidatePayload {
+    /** Tag names whose entries should be busted. Always present (may be empty if `keys` covers the bust). */
+    tags: string[];
+    /** Optional surgical key list — busted in addition to tag-matched keys. */
+    keys?: string[];
+    /** Runtime that originated the mutation. */
+    source: CacheInvalidateSource;
+    /** Per-process unique id so emitters can dedupe their own busts. */
+    sourceId: string;
+    /** Tenant scope — subscribers may gate on this. Empty string means global/no-tenant. */
+    tenantId: string;
+    /** Emission timestamp, ms since epoch. */
+    ts: number;
+}
+export interface CacheInvalidateEvent {
+    type: 'event';
+    event: 'cache.invalidate';
+    payload: CacheInvalidatePayload;
+}
+export declare function isCacheInvalidateEvent(value: unknown): value is CacheInvalidateEvent;
+//# sourceMappingURL=cache-events.d.ts.map

package/dist/gateway/cache-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-events.d.ts","sourceRoot":"","sources":["../../src/gateway/cache-events.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzF,MAAM,WAAW,sBAAsB;IACrC,yGAAyG;IACzG,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4CAA4C;IAC5C,MAAM,EAAE,qBAAqB,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAapF"}

package/dist/gateway/cache-events.js

@@ -0,0 +1,21 @@
+// Cache invalidation gateway event frame.
+//
+// Convention follows existing EventFrame in ./types.ts:
+//   { type: 'event', event: '<name>', payload: {...} }
+// (No `v: 3` discriminator — the gateway WS protocol does not version frames.)
+export function isCacheInvalidateEvent(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    if (v.type !== 'event' || v.event !== 'cache.invalidate')
+        return false;
+    if (typeof v.payload !== 'object' || v.payload === null)
+        return false;
+    const p = v.payload;
+    return (Array.isArray(p.tags) &&
+        typeof p.source === 'string' &&
+        typeof p.sourceId === 'string' &&
+        typeof p.tenantId === 'string' &&
+        typeof p.ts === 'number');
+}
+//# sourceMappingURL=cache-events.js.map

package/dist/gateway/cache-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-events.js","sourceRoot":"","sources":["../../src/gateway/cache-events.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,EAAE;AACF,wDAAwD;AACxD,uDAAuD;AACvD,+EAA+E;AAyB/E,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,KAAK,KAAK,kBAAkB;QAAE,OAAO,KAAK,CAAC;IACvE,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACtE,MAAM,CAAC,GAAG,CAAC,CAAC,OAAkC,CAAC;IAC/C,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACrB,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAC5B,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,CACzB,CAAC;AACJ,CAAC"}

package/dist/gateway/cache-events.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cache-events.test.d.ts.map

package/dist/gateway/cache-events.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-events.test.d.ts","sourceRoot":"","sources":["../../src/gateway/cache-events.test.ts"],"names":[],"mappings":""}

package/dist/gateway/cache-events.test.js

@@ -0,0 +1,47 @@
+import { describe, expect, it } from 'vitest';
+import { isCacheInvalidateEvent } from './cache-events.js';
+describe('CacheInvalidateEvent', () => {
+    it('isCacheInvalidateEvent returns true for a valid event', () => {
+        const evt = {
+            type: 'event',
+            event: 'cache.invalidate',
+            payload: {
+                tags: ['t:abc:agent-groups'],
+                keys: [],
+                source: 'hub',
+                sourceId: 'vercel-fn-1',
+                tenantId: 'ten_abc',
+                ts: 1715500000000,
+            },
+        };
+        expect(isCacheInvalidateEvent(evt)).toBe(true);
+    });
+    it('isCacheInvalidateEvent returns false for the wrong name', () => {
+        const evt = {
+            type: 'event',
+            event: 'chat.message',
+            payload: { tags: [], keys: [], source: 'hub', sourceId: 'x', tenantId: 't', ts: 0 },
+        };
+        expect(isCacheInvalidateEvent(evt)).toBe(false);
+    });
+    it('isCacheInvalidateEvent returns false for non-objects', () => {
+        expect(isCacheInvalidateEvent(null)).toBe(false);
+        expect(isCacheInvalidateEvent('event')).toBe(false);
+        expect(isCacheInvalidateEvent({})).toBe(false);
+    });
+    it('isCacheInvalidateEvent allows missing optional keys', () => {
+        const evt = {
+            type: 'event',
+            event: 'cache.invalidate',
+            payload: {
+                tags: ['t:abc'],
+                source: 'gateway',
+                sourceId: 'gw-1',
+                tenantId: 'ten_abc',
+                ts: 0,
+            },
+        };
+        expect(isCacheInvalidateEvent(evt)).toBe(true);
+    });
+});
+//# sourceMappingURL=cache-events.test.js.map

package/dist/gateway/cache-events.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-events.test.js","sourceRoot":"","sources":["../../src/gateway/cache-events.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAA6B,MAAM,mBAAmB,CAAC;AAEtF,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,GAAG,GAAyB;YAChC,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,kBAAkB;YACzB,OAAO,EAAE;gBACP,IAAI,EAAE,CAAC,oBAAoB,CAAC;gBAC5B,IAAI,EAAE,EAAE;gBACR,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,aAAa;gBACvB,QAAQ,EAAE,SAAS;gBACnB,EAAE,EAAE,aAAa;aAClB;SACF,CAAC;QACF,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,GAAG,GAAG;YACV,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE;SACpF,CAAC;QACF,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpD,MAAM,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,GAAG,GAAG;YACV,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,kBAAkB;YACzB,OAAO,EAAE;gBACP,IAAI,EAAE,CAAC,OAAO,CAAC;gBACf,MAAM,EAAE,SAAS;gBACjB,QAAQ,EAAE,MAAM;gBAChB,QAAQ,EAAE,SAAS;gBACnB,EAAE,EAAE,CAAC;aACN;SACF,CAAC;QACF,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/gateway/index.d.ts

@@ -2,4 +2,5 @@ export * from './types.js';
 export * from './protocol.js';
 export * from './connection.js';
 export * from './client.js';
+export * from './cache-events.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/gateway/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gateway/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gateway/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC"}

package/dist/gateway/index.js

@@ -2,4 +2,5 @@ export * from './types.js';
 export * from './protocol.js';
 export * from './connection.js';
 export * from './client.js';
+export * from './cache-events.js';
 //# sourceMappingURL=index.js.map

package/dist/gateway/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gateway/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gateway/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minion-stack/shared",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Shared gateway protocol types and utilities for the Minion platform.",
   "license": "MIT",
   "repository": {