@lensmcp/core 1.25.0 → 1.25.2

package/lib/flow-shape.d.ts

@@ -70,7 +70,7 @@ export declare function trimFlowEvent(event: BaseEvent, opts?: FlowShapeOptions)
     outcome?: "returned" | "threw" | undefined;
     source: "nx" | "vite" | "typescript" | "eslint" | "rollup" | "client-runtime" | "chrome" | "react" | "valtio" | "nestjs" | "nextjs" | "db" | "redis" | "queue" | "memory" | "visual" | "perf" | "security" | "gateway" | "external" | "ai" | "lens";
     category: "db" | "memory" | "visual" | "security" | "ai" | "build" | "lint" | "typecheck" | "test" | "runtime" | "render" | "trace" | "state" | "network" | "backend" | "performance" | "deps" | "cluster" | "agent";
-    severity: "debug" | "info" | "warning" | "error" | "fatal";
+    severity: "error" | "debug" | "info" | "warning" | "fatal";
     title: string;
     kind: string | undefined;
     area: FlowArea;
@@ -139,7 +139,7 @@ export declare function buildFlowDetail(rawEvents: BaseEvent[], opts?: FlowShape
         outcome?: "returned" | "threw" | undefined;
         source: "nx" | "vite" | "typescript" | "eslint" | "rollup" | "client-runtime" | "chrome" | "react" | "valtio" | "nestjs" | "nextjs" | "db" | "redis" | "queue" | "memory" | "visual" | "perf" | "security" | "gateway" | "external" | "ai" | "lens";
         category: "db" | "memory" | "visual" | "security" | "ai" | "build" | "lint" | "typecheck" | "test" | "runtime" | "render" | "trace" | "state" | "network" | "backend" | "performance" | "deps" | "cluster" | "agent";
-        severity: "debug" | "info" | "warning" | "error" | "fatal";
+        severity: "error" | "debug" | "info" | "warning" | "fatal";
         title: string;
         kind: string | undefined;
         area: FlowArea;

package/lib/pg-errors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * What a node-postgres connection error means — read from its code and message, the same way in the pool tap (an error
+ * it sees) and in the lens (an error a service only logged).
+ *
+ * The four that read alike and are not alike:
+ *
+ *   pool-wait-timeout   `timeout exceeded when trying to connect` — pg-pool's QUEUE wait: every connection of the
+ *                       service's OWN pool was taken (or still opening) for `connectionTimeoutMillis`. Postgres may
+ *                       have hundreds free. Also what a frozen process reads as: the wait's timer fires on wake,
+ *                       before the replies already waiting in the sockets are read.
+ *   connect-timeout     `Connection terminated due to connection timeout` — opening a NEW connection took longer than
+ *                       the limit (the server, the network, or this process's blocked loop).
+ *   server-full         SQLSTATE 53300 — Postgres itself is at `max_connections`.
+ *   server-unreachable  nothing answers at the address.
+ */
+export type PgConnectReason = 'pool-wait-timeout' | 'connect-timeout' | 'server-full' | 'server-unreachable' | 'pool-ended' | 'auth-failed';
+export declare const PG_CONNECT_MEANING: Record<PgConnectReason, string>;
+/** Any of the texts above, for finding them in a line a service logged. */
+export declare const PG_CONNECT_TEXT: RegExp;
+/** The reason a connect failed, or undefined when the error is not about getting a connection. */
+export declare function pgConnectReason(err: unknown): PgConnectReason | undefined;

package/lib/pg-errors.js

@@ -0,0 +1 @@
+"use strict";var d=Object.defineProperty;var n=(o,e)=>d(o,"name",{value:e,configurable:!0});var u=Object.defineProperty,l=n((o,e)=>u(o,"name",{value:e,configurable:!0}),"t");export const PG_CONNECT_MEANING={"pool-wait-timeout":"waited for a free connection in the service\u2019s own pool and the wait ran out \u2014 not Postgres refusing","connect-timeout":"opening a new connection to Postgres took longer than the limit","server-full":"Postgres is at its max_connections and refused a new connection","server-unreachable":"nothing answered at the database\u2019s address","pool-ended":"the code used a pool that had already been closed (an app being shut down)","auth-failed":"Postgres refused the user or password"};const a=[["pool-wait-timeout",/timeout exceeded when trying to connect/i],["connect-timeout",/Connection terminated due to connection timeout/i],["server-full",/sorry, too many clients already|remaining connection slots are reserved|too many connections for role/i],["pool-ended",/Cannot use a pool after calling end on the pool/i],["auth-failed",/password authentication failed|no pg_hba\.conf entry/i],["server-unreachable",/connect (ECONNREFUSED|EHOSTUNREACH|ETIMEDOUT)|getaddrinfo ENOTFOUND/i]],r={53300:"server-full","28P01":"auth-failed",28e3:"auth-failed",ECONNREFUSED:"server-unreachable",EHOSTUNREACH:"server-unreachable",ENOTFOUND:"server-unreachable"};export const PG_CONNECT_TEXT=new RegExp(a.map(([,o])=>o.source).join("|"),"i");export function pgConnectReason(o){const e=o,t=typeof e=="object"&&e&&typeof e.code=="string"?e.code:void 0;if(t&&r[t])return r[t];const s=typeof e=="string"?e:typeof e=="object"&&e&&typeof e.message=="string"?e.message:"";for(const[i,c]of a)if(c.test(s))return i}n(pgConnectReason,"pgConnectReason"),l(pgConnectReason,"pgConnectReason");

package/lib/resource-store.d.ts

@@ -8,6 +8,17 @@ import type { Unsubscribe } from './common.js';
 export type ResourceValue = unknown;
 export type ResourceProducer = () => ResourceValue | Promise<ResourceValue>;
 export type ResourceUpdatedHandler = (uri: string, revision: number) => void;
+export interface ResourceStoreOptions {
+    /**
+     * Recompute a resource at most once per this many milliseconds, however often it is marked dirty (0, the default:
+     * on every call). A lens session sets it: a reducer marks its resource dirty on EVERY event it folds, and finding out
+     * whether the resource changed means producing it whole and serialising it — `flow://recent` summarises every flow.
+     * At FoodGuard's 450 events a second that was most of the dashboard's CPU, and the backlog it left was ingested in
+     * one synchronous tick that held the event loop for up to 51 s (the dashboard's "Connection to the lens lost").
+     * Reads are never delayed: `read` produces the resource fresh. Only the revision and the notification wait.
+     */
+    coalesceMs?: number;
+}
 /**
  * The resource store. URIs are registered once; reading is cheap; the
  * `markDirty` call bumps the revision counter and notifies subscribers
@@ -16,6 +27,11 @@ export type ResourceUpdatedHandler = (uri: string, revision: number) => void;
 export declare class ResourceStore {
     private readonly entries;
     private readonly subs;
+    private readonly coalesceMs;
+    /** A recompute already scheduled per URI — every mark until it runs rides on it. */
+    private readonly queued;
+    private readonly lastRun;
+    constructor(opts?: ResourceStoreOptions);
     register(uri: string, produce: ResourceProducer): Unsubscribe;
     read(uri: string): Promise<ResourceValue>;
     list(): string[];
@@ -25,6 +41,7 @@ export declare class ResourceStore {
      * change.
      */
     markDirty(uri: string): Promise<void>;
+    private recompute;
     revision(uri: string): number | undefined;
     subscribe(uri: string, handler: ResourceUpdatedHandler): Unsubscribe;
 }

package/lib/resource-store.js

@@ -1 +1 @@
-"use strict";var u=Object.defineProperty;var i=(r,e)=>u(r,"name",{value:e,configurable:!0});var a=Object.defineProperty,h=i((r,e)=>a(r,"name",{value:e,configurable:!0}),"o");export class ResourceStore{static{i(this,"ResourceStore")}static{h(this,"ResourceStore")}constructor(){this.entries=new Map,this.subs=new Map}register(e,t){if(this.entries.has(e))throw new Error(`Resource already registered: ${e}`);return this.entries.set(e,{uri:e,produce:t,revision:0}),()=>{this.entries.delete(e),this.subs.delete(e)}}async read(e){const t=this.entries.get(e);if(!t)throw new Error(`Unknown resource: ${e}`);return t.produce()}list(){return[...this.entries.keys()]}async markDirty(e){const t=this.entries.get(e);if(!t)return;const s=await t.produce(),n=JSON.stringify(s);if(n===t.lastJson)return;t.lastJson=n,t.revision+=1;const o=this.subs.get(e);if(o)for(const c of o)try{c(e,t.revision)}catch{}}revision(e){return this.entries.get(e)?.revision}subscribe(e,t){let s=this.subs.get(e);return s||(s=new Set,this.subs.set(e,s)),s.add(t),()=>{s?.delete(t)}}}
+"use strict";var c=Object.defineProperty;var u=(n,e)=>c(n,"name",{value:e,configurable:!0});var h=Object.defineProperty,a=u((n,e)=>h(n,"name",{value:e,configurable:!0}),"o");export class ResourceStore{static{u(this,"ResourceStore")}static{a(this,"ResourceStore")}constructor(e={}){this.entries=new Map,this.subs=new Map,this.queued=new Map,this.lastRun=new Map,this.coalesceMs=Math.max(0,e.coalesceMs??0)}register(e,t){if(this.entries.has(e))throw new Error(`Resource already registered: ${e}`);return this.entries.set(e,{uri:e,produce:t,revision:0}),()=>{this.entries.delete(e),this.subs.delete(e),this.lastRun.delete(e)}}async read(e){const t=this.entries.get(e);if(!t)throw new Error(`Unknown resource: ${e}`);return t.produce()}list(){return[...this.entries.keys()]}markDirty(e){if(this.coalesceMs===0)return this.recompute(e);if(!this.entries.has(e))return Promise.resolve();const t=this.queued.get(e);if(t)return t;const s=Math.max(0,(this.lastRun.get(e)??Number.NEGATIVE_INFINITY)+this.coalesceMs-Date.now()),r=new Promise(i=>{const o=a(()=>{this.queued.delete(e),this.lastRun.set(e,Date.now()),this.recompute(e).then(i,()=>i())},"go");s===0?setImmediate(o):setTimeout(o,s).unref?.()});return this.queued.set(e,r),r}async recompute(e){const t=this.entries.get(e);if(!t)return;const s=await t.produce(),r=JSON.stringify(s);if(r===t.lastJson)return;t.lastJson=r,t.revision+=1;const i=this.subs.get(e);if(i)for(const o of i)try{o(e,t.revision)}catch{}}revision(e){return this.entries.get(e)?.revision}subscribe(e,t){let s=this.subs.get(e);return s||(s=new Set,this.subs.set(e,s)),s.add(t),()=>{s?.delete(t)}}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lensmcp/core",
-  "version": "1.25.0",
+  "version": "1.25.2",
   "type": "module",
   "main": "./index.js",
   "module": "./index.js",
@@ -22,6 +22,11 @@
       "import": "./lib/sql-shape.js",
       "default": "./lib/sql-shape.js"
     },
+    "./pg-errors": {
+      "types": "./lib/pg-errors.d.ts",
+      "import": "./lib/pg-errors.js",
+      "default": "./lib/pg-errors.js"
+    },
     "./stores": {
       "types": "./lib/stores.d.ts",
       "import": "./lib/stores.js",
@@ -59,7 +64,7 @@
     }
   },
   "dependencies": {
-    "@lensmcp/protocol-types": "1.25.0",
+    "@lensmcp/protocol-types": "1.25.2",
     "tslib": "^2.3.0"
   },
   "license": "Apache-2.0",