sessionpipe-core 0.13.0 → 0.13.1

package/dist/src/outbox.d.ts

@@ -26,9 +26,30 @@ export declare class Outbox {
         events: Event[];
         offset: number;
     };
-    /** Files older than `days` are pruned; the cursor files with them. */
+    /** Files older than `days` are pruned, and each sink's cursor into them. The seq
+     *  counter stays: a session resumed after the window counts on from where it was,
+     *  so a receiver's (harness, session, seq) dedup doesn't take its new events for
+     *  ones it already has, and the sinks read the new file from its start.
+     *  It all happens under the drain's `flush` lock, since a drain holds the whole
+     *  cursor map and writes it back: a file and its cursor keys go together, so a
+     *  session resumed in between can't keep a key past its new file's end. While a
+     *  drain runs, nothing is pruned (0); the next prune does it. It never throws: it
+     *  is a cleanup, and a hook's drain comes after it. */
     prune(days: number, now?: number): number;
+    /** A sink's cursor into a session file about to be pruned (`gone`), or one already
+     *  missing (an earlier prune, an older release, by hand) is removed. The caller
+     *  holds the `flush` lock. */
+    private dropStaleCursors;
     delete(ref: OutboxRef): void;
+    /** The key every sink's cursor holds for a session is removed with the session's
+     *  file: the key alone pointed into the old file, and a session that went on (still
+     *  running, or resumed later) had its new file's first events unsent until it grew
+     *  past that offset. Every file under <state>/cursors is taken (a sink since taken
+     *  out of the config still has one; one that doesn't parse reads as empty and is
+     *  left), by the key a drain writes (the file's own name, `safeId`) and by the ref
+     *  as given. The caller holds the drain's `flush` lock: a drain holds the whole
+     *  cursor map and writes it back, so a key dropped under it would come back. */
+    private dropCursors;
 }
 /** Per-sink cursor: byte offset per session file, moved only on a 2xx. */
 export declare class Cursors {
@@ -36,6 +57,8 @@ export declare class Cursors {
     readonly sink: string;
     constructor(root: string, sink: string);
     private file;
+    /** The map; empty when the file is missing, cut off mid-write, or holds anything
+     *  but an object (`null`, a list), so a drain never indexes into those. */
     read(): Record<string, number>;
     write(c: Record<string, number>): void;
     key(ref: OutboxRef): string;
@@ -44,8 +67,18 @@ export declare class Cursors {
  *  took it is gone (its 15 s deadline ends it without a release), or after 5 min. */
 export declare function takeLock(root: string, ref: OutboxRef, staleMs?: number): (() => void) | null;
 /** A named lock under <root>/locks, held by one process at a time: the file names
- *  its pid. Stale once that process is gone, or after `staleMs`. */
+ *  its pid and a nonce. Stale once that process is gone, or after `staleMs`. A stale
+ *  lock is taken over by renaming it aside first: of two workers that both judged it
+ *  stale, one rename wins, and one that moved a fresh lock instead (another worker's,
+ *  made in between) puts it back and stands down. The release deletes the file only
+ *  while it is still this taker's, so a lock taken over can't be wiped by its old
+ *  holder. Two holders at once used to mean two drains reading the same cursors and
+ *  sending the same batch (issue #208's one-request-a-second pace rests on one). */
 export declare function takeNamedLock(root: string, name: string, staleMs?: number): (() => void) | null;
+/** `takeNamedLock`, tried again every `everyMs` until `forMs` have passed: for a
+ *  command whose work goes under a lock a worker holds for seconds (a drain). null
+ *  once the time is up. */
+export declare function waitNamedLock(root: string, name: string, forMs: number, everyMs?: number): Promise<(() => void) | null>;
 /** Whether the process a lock or a claimed job names is still running. A pid that
  *  can't be read counts as running: the age rule decides then. */
 export declare function processAlive(pid: number): boolean;

package/dist/src/outbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outbox.d.ts","sourceRoot":"","sources":["../../src/outbox.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD,qBAAa,MAAM;IACL,QAAQ,CAAC,IAAI,EAAE,MAAM;IAAjC,YAAqB,IAAI,EAAE,MAAM,EAAI;IAErC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3B;IACD,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAE3B;IACD,OAAO,CAAC,OAAO;IAIf;yEACqE;IACrE,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAa9B;IAED,OAAO,CAAC,aAAa;IAarB,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAI5C;IAED,wCAAwC;IACxC,QAAQ,IAAI,SAAS,EAAE,CAmBtB;IAED;;;;;wEAKoE;IACpE,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG;QAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAqCvF;IAED,sEAAsE;IACtE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,MAAM,CAgB5C;IAED,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAM3B;CACF;AAED,0EAA0E;AAC1E,qBAAa,OAAO;IAEhB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM;IAFvB,YACW,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACnB;IACJ,OAAO,CAAC,IAAI;IAGZ,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM7B;IACD,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAMrC;IACD,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAE1B;CACF;AAED;qFACqF;AACrF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,SAAa,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAEhG;AAED;oEACoE;AACpE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,SAAa,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAkBnG;AAED;kEACkE;AAClE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQjD"}
+{"version":3,"file":"outbox.d.ts","sourceRoot":"","sources":["../../src/outbox.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD,qBAAa,MAAM;IACL,QAAQ,CAAC,IAAI,EAAE,MAAM;IAAjC,YAAqB,IAAI,EAAE,MAAM,EAAI;IAErC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3B;IACD,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAE3B;IACD,OAAO,CAAC,OAAO;IAIf;yEACqE;IACrE,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAa9B;IAED,OAAO,CAAC,aAAa;IAarB,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAI5C;IAED,wCAAwC;IACxC,QAAQ,IAAI,SAAS,EAAE,CAmBtB;IAED;;;;;wEAKoE;IACpE,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG;QAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAqCvF;IAED;;;;;;;;2DAQuD;IACvD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,MAAM,CAmC5C;IAED;;kCAE8B;IAC9B,OAAO,CAAC,gBAAgB;IAqBxB,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAW3B;IAED;;;;;;;oFAOgF;IAChF,OAAO,CAAC,WAAW;CAiBpB;AAED,0EAA0E;AAC1E,qBAAa,OAAO;IAEhB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM;IAFvB,YACW,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACnB;IACJ,OAAO,CAAC,IAAI;IAGZ;+EAC2E;IAC3E,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO7B;IACD,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAMrC;IACD,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAE1B;CACF;AAED;qFACqF;AACrF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,SAAa,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAEhG;AAED;;;;;;;oFAOoF;AACpF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,SAAa,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAyCnG;AAED;;2BAE2B;AAC3B,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,SAAM,GACZ,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAM9B;AAED;kEACkE;AAClE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQjD"}

package/dist/src/privacy/pii.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pii.d.ts","sourceRoot":"","sources":["../../../src/privacy/pii.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW,UAAU,CAAC;AAkBnC,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CASvD"}
+{"version":3,"file":"pii.d.ts","sourceRoot":"","sources":["../../../src/privacy/pii.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW,UAAU,CAAC;AA2BnC,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CASvD"}

package/dist/version.js

@@ -1,4 +1,4 @@
-// sessionpipe-core 0.13.0 · Apache-2.0 · https://sessionpipe.org
+// sessionpipe-core 0.13.1 · Apache-2.0 · https://sessionpipe.org
 
 // src/version.ts
 import { spawn } from "node:child_process";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sessionpipe-core",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "description": "sessionpipe core: protocol types, harness adapters, privacy filter and redaction rulesets, outbox and sinks. Zero runtime dependencies. (published unscoped until the @sessionpipe npm org exists; the code is the same)",
   "license": "Apache-2.0",
   "type": "module",