Reconnexion/ng-eventually
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(logs): logs données restructurés — identité en préfixe, trace résolution/barrière, inspection outbox

Browse Source 
Chemin données bas-niveau du polyfill rendu lisible pour diagnostiquer en session live :

- Format identité-en-premier : `[<identity>][polyfill] OP shortNuri (label)` ;
  console.error épars (store-registry, inbox) unifiés au même préfixe.
- Trace (derrière le flag debug) : issue de la barrière ensureRepoOpen
  (synced|timed-out + durée) et résultat sémantique de chaque étage de résolution
  (resolvePointer/canonicalDoc/resolveAccount/resolveShimDoc/readScopeIndex).
- outbox-log.ts (nouveau) : inspection read-only de l'outbox hors-ligne au
  démarrage de session ; console.warn si non vide (anomalie, toujours visible),
  sous flag si vide. Le comptage seul est fiable (payloads BARE opaques côté JS).

Pas de changement fonctionnel. bun test 126 pass ; tsc 0 erreur.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014GbGgNEHRejVKoREvFuDFg
This commit is contained in:
Sylvain Duchesne
2026-07-14 10:37:46 +02:00
parent 3547967d37
commit 70de7afa3c
7 changed files with 207 additions and 33 deletions
Download Patch File Download Diff File Expand all files Collapse all files
packages/client/test/access-log.test.ts
+12 -15
View File
@@ -6,9 +6,10 @@
* (a) OFF by default: reads + writes via sparqlQuery / sparqlUpdate / docCreate
* emit nothing to console.log.
* (b) ON via configure({ debugAccessLog: true }): each read/write emits a line
* matching `[polyfill] [<identity>] READ/WRITE <shortNuri> (<label>)` plus
* row-count suffix on READs. The NURI is shortened by shortNuri (did:ng:o:
* prefix + :v: suffix stripped, RepoID truncated to 8 chars + ellipsis).
* matching `[<identity>][polyfill] READ/WRITE <shortNuri> (<label>)` (identity
* FIRST, `[polyfill]` glued right after) plus row-count suffix on READs. The
* NURI is shortened by shortNuri (did:ng:o: prefix + :v: suffix stripped,
* RepoID truncated to 8 chars + ellipsis).
* (c) ON via env var NG_EVENTUALLY_ACCESS_LOG=1: same behavior without changing
* calling code.
* (d) Identity follows setCurrentUser: after setCurrentUser the prefix changes.
@@ -160,8 +161,7 @@ describe("access-log: ON via configure({ debugAccessLog: true })", () => {
restore();
}
expect(lines.length).toBe(1);
expect(lines[0]).toMatch(/^\[polyfill\] /); // SDK-layer access-log prefix
expect(lines[0]).toMatch(/\[alice\]/);
expect(lines[0]).toMatch(/^\[alice\]\[polyfill\] /); // identity-first, glued [polyfill] prefix
expect(lines[0]).toMatch(/READ/);
expect(lines[0]).toContain(shortNuri("did:ng:o:q")); // NURI shortened
expect(lines[0]).not.toContain("did:ng:o:"); // full prefix stripped
@@ -179,8 +179,7 @@ describe("access-log: ON via configure({ debugAccessLog: true })", () => {
restore();
}
expect(lines.length).toBe(1);
expect(lines[0]).toMatch(/^\[polyfill\] /);
expect(lines[0]).toMatch(/\[alice\]/);
expect(lines[0]).toMatch(/^\[alice\]\[polyfill\] /); // identity-first, glued [polyfill] prefix
expect(lines[0]).toMatch(/WRITE/);
expect(lines[0]).toContain(shortNuri("did:ng:o:w"));
expect(lines[0]).toMatch(/writeLabel/);
@@ -196,8 +195,7 @@ describe("access-log: ON via configure({ debugAccessLog: true })", () => {
restore();
}
expect(lines.length).toBe(1);
expect(lines[0]).toMatch(/^\[polyfill\] /);
expect(lines[0]).toMatch(/\[alice\]/);
expect(lines[0]).toMatch(/^\[alice\]\[polyfill\] /); // identity-first, glued [polyfill] prefix
expect(lines[0]).toMatch(/WRITE/);
// The nuri is the value returned by ng.doc_create, shortened by shortNuri.
expect(lines[0]).toContain(shortNuri("did:ng:o:log-doc"));
@@ -223,8 +221,7 @@ describe("access-log: ON via env var NG_EVENTUALLY_ACCESS_LOG=1", () => {
restore();
}
expect(lines.length).toBe(1);
expect(lines[0]).toMatch(/^\[polyfill\] /);
expect(lines[0]).toMatch(/\[bob\]/);
expect(lines[0]).toMatch(/^\[bob\]\[polyfill\] /); // identity-first, glued [polyfill] prefix
expect(lines[0]).toMatch(/READ/);
expect(lines[0]).toContain(shortNuri("did:ng:o:env-q"));
});
@@ -241,7 +238,7 @@ describe("access-log: ON via env var NG_EVENTUALLY_ACCESS_LOG=1", () => {
restore();
}
expect(lines.length).toBe(1);
expect(lines[0]).toMatch(/\[charlie\]/);
expect(lines[0]).toMatch(/^\[charlie\]\[polyfill\] /); // identity-first, glued [polyfill] prefix
expect(lines[0]).toMatch(/WRITE/);
});
@@ -266,8 +263,8 @@ describe("access-log: identity follows setCurrentUser", () => {
restore();
}
expect(lines.length).toBe(2);
expect(lines[0]).toMatch(/\[first-user\]/);
expect(lines[1]).toMatch(/\[second-user\]/);
expect(lines[0]).toMatch(/^\[first-user\]\[polyfill\] /); // identity-first, glued [polyfill] prefix
expect(lines[1]).toMatch(/^\[second-user\]\[polyfill\] /);
});
it("prefix is (none) when no identity is set", async () => {
@@ -280,6 +277,6 @@ describe("access-log: identity follows setCurrentUser", () => {
restore();
}
expect(lines.length).toBe(1);
expect(lines[0]).toMatch(/\[\(none\)\]/);
expect(lines[0]).toMatch(/^\[\(none\)\]\[polyfill\] /); // identity-first, glued [polyfill] prefix
});
});