cursedbelt-server 4.19.1 → 4.20.0

package/dist/server/bench/tail.d.ts

@@ -15,7 +15,7 @@
  * Two ways to get the events, and a consumer needs neither code nor a new Worker for the first:
  *
  *   · **`wrangler tail <worker> --format json`** during a bench or a smoke against the live
- *     Worker — one JSON trace per line, parsed with {@link parseTailLines}.
+ *     Worker — pretty-printed objects back to back, parsed with {@link parseTailLines}.
  *   · **a Tail Worker** (`tail_consumers` in the producer's wrangler config) whose `tail(events)`
  *     hands the array straight to {@link recordTailTraces}.
  *
@@ -90,8 +90,14 @@ export interface TailRecordResult {
  */
 export declare function recordTailTraces(recorder: CpuRecorder, traces: readonly TailTraceLike[], opts?: RecordTailTracesOpts): TailRecordResult;
 /**
- * `wrangler tail --format json` output → trace events. Tolerates the banner lines wrangler
- * prints and blank lines; a line that is not a JSON object is skipped, never guessed at.
+ * `wrangler tail --format json` output → trace events.
+ *
+ * 🔴 That output is PRETTY-PRINTED — one object spread over ~100 lines, objects back to back — not
+ * one JSON document per line. Measured 2026-09-23 against the live `collections` Worker: 61 traces
+ * in 6,771 lines, and a line-by-line parser (this function's first version) found none of them. So
+ * this scans for balanced top-level `{…}` objects, string- and escape-aware, and parses each; it
+ * reads JSON-lines output identically. Banner text between objects is skipped, and a truncated
+ * object (a tail killed mid-write) is dropped rather than guessed at.
  */
 export declare function parseTailLines(text: string): TailTraceLike[];
 export interface TailTrafficRate {

package/dist/server/bench/tail.js

@@ -15,7 +15,7 @@
  * Two ways to get the events, and a consumer needs neither code nor a new Worker for the first:
  *
  *   · **`wrangler tail <worker> --format json`** during a bench or a smoke against the live
- *     Worker — one JSON trace per line, parsed with {@link parseTailLines}.
+ *     Worker — pretty-printed objects back to back, parsed with {@link parseTailLines}.
  *   · **a Tail Worker** (`tail_consumers` in the producer's wrangler config) whose `tail(events)`
  *     hands the array straight to {@link recordTailTraces}.
  *
@@ -144,22 +144,65 @@ export function recordTailTraces(recorder, traces, opts = {}) {
     return result;
 }
 /**
- * `wrangler tail --format json` output → trace events. Tolerates the banner lines wrangler
- * prints and blank lines; a line that is not a JSON object is skipped, never guessed at.
+ * `wrangler tail --format json` output → trace events.
+ *
+ * 🔴 That output is PRETTY-PRINTED — one object spread over ~100 lines, objects back to back — not
+ * one JSON document per line. Measured 2026-09-23 against the live `collections` Worker: 61 traces
+ * in 6,771 lines, and a line-by-line parser (this function's first version) found none of them. So
+ * this scans for balanced top-level `{…}` objects, string- and escape-aware, and parses each; it
+ * reads JSON-lines output identically. Banner text between objects is skipped, and a truncated
+ * object (a tail killed mid-write) is dropped rather than guessed at.
  */
 export function parseTailLines(text) {
     const out = [];
-    for (const line of text.split('\n')) {
-        const trimmed = line.trim();
-        if (!trimmed.startsWith('{'))
+    let depth = 0;
+    let start = -1;
+    let inString = false;
+    let escaped = false;
+    for (let i = 0; i < text.length; i += 1) {
+        const ch = text[i];
+        if (inString && ch === '\n') {
+            // A raw newline cannot occur inside a JSON string: the object this began is truncated.
+            inString = false;
+            escaped = false;
+            depth = 0;
+            start = -1;
             continue;
-        try {
-            const parsed = JSON.parse(trimmed);
-            if (parsed && typeof parsed === 'object')
-                out.push(parsed);
         }
-        catch {
-            // a partial line from an interrupted tail — not a trace
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (ch === '\\')
+                escaped = true;
+            else if (ch === '"')
+                inString = false;
+            continue;
+        }
+        if (ch === '"' && depth > 0) {
+            inString = true;
+        }
+        else if (ch === '{') {
+            // wrangler writes every top-level object from column 0 and indents everything nested, so a
+            // `{` at the start of a line while one is still open means the open one was cut short.
+            if (depth > 0 && (i === 0 || text[i - 1] === '\n'))
+                depth = 0;
+            if (depth === 0)
+                start = i;
+            depth += 1;
+        }
+        else if (ch === '}' && depth > 0) {
+            depth -= 1;
+            if (depth === 0 && start >= 0) {
+                try {
+                    const parsed = JSON.parse(text.slice(start, i + 1));
+                    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed))
+                        out.push(parsed);
+                }
+                catch {
+                    // not JSON after all (banner text with braces in it) — not a trace
+                }
+                start = -1;
+            }
         }
     }
     return out;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cursedbelt-server",
-	"version": "4.19.1",
+	"version": "4.20.0",
 	"license": "ISC",
 	"type": "module",
 	"description": "The app-facing Bun/Hono server tier of the cursedbelt split — storage, sharing, activity, guard, sync. React-free; cursedbelt-core below it.",
@@ -18,13 +18,14 @@
 	"scripts": {
 		"clean": "rm -rf dist",
 		"typecheck": "tsc -p tsconfig.build.json --noEmit",
-		"test": "NODE_ENV=development bun test src",
+		"test": "NODE_ENV=development bun test --timeout 60000 --parallel=6 src",
 		"build": "bun run clean && tsc -p tsconfig.build.json",
 		"paths": "bun run scripts/paths.ts",
 		"surface": "public-surface",
-		"verify": "bun run paths && bun run typecheck && bun run build && bun run test",
-		"prepublishOnly": "bun run verify",
-		"test:pg": "bun run scripts/testPg.ts"
+		"verify": "bun run gate",
+		"prepublishOnly": "bun run gate --force",
+		"test:pg": "bun run scripts/testPg.ts",
+		"gate": "bun run scripts/paths.ts --only gate.ts"
 	},
 	"files": [
 		"dist",
@@ -58,6 +59,12 @@
 			"source": "./src/server/analytics/index.ts",
 			"import": "./dist/server/analytics/index.js"
 		},
+		"./app-data-home": {
+			"types": "./dist/server/paths/appDataHome.d.ts",
+			"bun": "./src/server/paths/appDataHome.ts",
+			"source": "./src/server/paths/appDataHome.ts",
+			"import": "./dist/server/paths/appDataHome.js"
+		},
 		"./bench": {
 			"types": "./dist/server/bench/index.d.ts",
 			"bun": "./src/server/bench/index.ts",
@@ -339,5 +346,25 @@
 		"sharp": "^0.35.2",
 		"typescript": "^6.0.3",
 		"zod": "4.4.3"
+	},
+	"gate": {
+		"stages": [
+			{
+				"script": "paths"
+			},
+			{
+				"script": "typecheck"
+			},
+			{
+				"script": "build"
+			},
+			{
+				"script": "test",
+				"needs": [
+					"build"
+				],
+				"why": "build starts with `rm -rf dist`, and barrelsReachNoOptionalPeer / the publish-shape specs read dist/; racing it they read a directory that is not there yet"
+			}
+		]
 	}
 }

package/src/leafSubpathsImportNothing.spec.ts

@@ -104,6 +104,16 @@ const REPO = fileURLToPath(new URL('..', import.meta.url));
  * follows it to the new file rather than going quietly green against the old one.
  */
 const LEAVES = [
+  {
+    subpath: './app-data-home',
+    /**
+     * Where a PUBLISHED package keeps per-user data: `APP_DATA_HOME`, then XDG, then the OS
+     * convention (task 2117). `cursedbelt-cc`'s local host needs this one function, and until
+     * this leaf it could reach it only through the root barrel — which made every cc install
+     * an `otplib`/`kysely` install. `node:os` and `node:path` only.
+     */
+    evaluates: 'resolveAppDataHome',
+  },
   {
     subpath: './storage/types',
     /** Claim/config shapes + the keyspace helpers. apps/collections wants `FileTokenClaims`. */

package/src/server/bench/tail.spec.ts

@@ -117,6 +117,18 @@ describe('parseTailLines and tailTrafficRate', () => {
     expect(parseTailLines(text).map((t) => t.cpuTime)).toEqual([1, 2]);
   });
 
+  it('🔴 reads PRETTY-PRINTED objects back to back — what wrangler actually prints', () => {
+    // The shape measured against the live `collections` Worker, 2026-09-23: 61 traces over
+    // 6,771 lines. The first version of this parser split on newlines and found none.
+    const text = [
+      'Successfully created tail',
+      JSON.stringify({ ...trace('GET', '/healthz', 16, 1), logs: [{ message: ['a } brace', 'q "x"'] }] }, null, 4),
+      JSON.stringify(trace('GET', '/api/folders', 3, 2), null, 4),
+      JSON.stringify(trace('GET', '/cut', 9, 3), null, 4).slice(0, 40),
+    ].join('\n');
+    expect(parseTailLines(text).map((t) => t.cpuTime)).toEqual([16, 3]);
+  });
+
   it('scales a window to requests/day — and refuses to scale one shorter than an hour', () => {
     const hour = 3_600_000;
     const two = [trace('GET', '/healthz', 1, 0), trace('GET', '/healthz', 1, 2 * hour), { cpuTime: 5 }];

package/src/server/bench/tail.ts

@@ -15,7 +15,7 @@
  * Two ways to get the events, and a consumer needs neither code nor a new Worker for the first:
  *
  *   · **`wrangler tail <worker> --format json`** during a bench or a smoke against the live
- *     Worker — one JSON trace per line, parsed with {@link parseTailLines}.
+ *     Worker — pretty-printed objects back to back, parsed with {@link parseTailLines}.
  *   · **a Tail Worker** (`tail_consumers` in the producer's wrangler config) whose `tail(events)`
  *     hands the array straight to {@link recordTailTraces}.
  *
@@ -192,19 +192,56 @@ export function recordTailTraces(
 }
 
 /**
- * `wrangler tail --format json` output → trace events. Tolerates the banner lines wrangler
- * prints and blank lines; a line that is not a JSON object is skipped, never guessed at.
+ * `wrangler tail --format json` output → trace events.
+ *
+ * 🔴 That output is PRETTY-PRINTED — one object spread over ~100 lines, objects back to back — not
+ * one JSON document per line. Measured 2026-09-23 against the live `collections` Worker: 61 traces
+ * in 6,771 lines, and a line-by-line parser (this function's first version) found none of them. So
+ * this scans for balanced top-level `{…}` objects, string- and escape-aware, and parses each; it
+ * reads JSON-lines output identically. Banner text between objects is skipped, and a truncated
+ * object (a tail killed mid-write) is dropped rather than guessed at.
  */
 export function parseTailLines(text: string): TailTraceLike[] {
   const out: TailTraceLike[] = [];
-  for (const line of text.split('\n')) {
-    const trimmed = line.trim();
-    if (!trimmed.startsWith('{')) continue;
-    try {
-      const parsed = JSON.parse(trimmed) as unknown;
-      if (parsed && typeof parsed === 'object') out.push(parsed as TailTraceLike);
-    } catch {
-      // a partial line from an interrupted tail — not a trace
+  let depth = 0;
+  let start = -1;
+  let inString = false;
+  let escaped = false;
+  for (let i = 0; i < text.length; i += 1) {
+    const ch = text[i];
+    if (inString && ch === '\n') {
+      // A raw newline cannot occur inside a JSON string: the object this began is truncated.
+      inString = false;
+      escaped = false;
+      depth = 0;
+      start = -1;
+      continue;
+    }
+    if (inString) {
+      if (escaped) escaped = false;
+      else if (ch === '\\') escaped = true;
+      else if (ch === '"') inString = false;
+      continue;
+    }
+    if (ch === '"' && depth > 0) {
+      inString = true;
+    } else if (ch === '{') {
+      // wrangler writes every top-level object from column 0 and indents everything nested, so a
+      // `{` at the start of a line while one is still open means the open one was cut short.
+      if (depth > 0 && (i === 0 || text[i - 1] === '\n')) depth = 0;
+      if (depth === 0) start = i;
+      depth += 1;
+    } else if (ch === '}' && depth > 0) {
+      depth -= 1;
+      if (depth === 0 && start >= 0) {
+        try {
+          const parsed = JSON.parse(text.slice(start, i + 1)) as unknown;
+          if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) out.push(parsed as TailTraceLike);
+        } catch {
+          // not JSON after all (banner text with braces in it) — not a trace
+        }
+        start = -1;
+      }
     }
   }
   return out;