Merge branch 'chore/scrub-internal-refs'

Author: perki

components/pryv-cmc/test/cmc.test.js

@@ -787,12 +787,12 @@ describe('[CMCL1] @pryv/cmc Level-1 protocol functions', function () {
   });
 
   // ------------------------------------------------------------
-  // Phase 5.2 (Plan 68) — J3–J10 wire-shape contract tests.
+  // J3–J10 wire-shape contract tests.
   //
   // J1 + J2 covered by [CMCL1OA] (readOffer) + [CMCXE] (errorIds catalogue).
   // J3-J10 fill the remaining contract slots so a release-blocking
   // regression in any of these wire shapes surfaces as a unit-test
-  // failure rather than a Phase-6 deploy-validation surprise.
+  // failure rather than a deploy-validation surprise.
   // ------------------------------------------------------------
 
   describe('[CMCL1OB] J3 listInvites wire-shape', function () {

components/pryv-monitor/src/Monitor.js

@@ -164,9 +164,9 @@ class Monitor extends EventEmitter {
   }
 
   /**
-   * Plan 66: register a handler for the server's fine-grained
-   * `accessUpdated` event. Fires whenever a Pryv.io ≥ 2.0.0-pre.X server
-   * emits the event after a successful `accesses.update` — payload is
+   * Register a handler for the server's fine-grained `accessUpdated`
+   * event. Fires whenever a Pryv.io ≥ 2.0.0-pre.X server emits the
+   * event after a successful `accesses.update` — payload is
    * `{ type: 'access-updated', accessId: '<base>:<serial>', serial }`.
    *
    * Requires `Monitor.UpdateMethod.Socket` to be active (the event

components/pryv-monitor/src/UpdateMethod/Socket.js

@@ -23,8 +23,8 @@ class Socket extends UpdateMethod {
     this.socket = await this.monitor.connection.socket.open();
     this.socket.on('eventsChanged', () => { this.monitor.updateEvents(); });
     this.socket.on('streamsChanged', () => { this.monitor.updateStreams(); });
-    // Plan 66: re-emit the server's fine-grained `accessUpdated` event
-    // on the Monitor itself so consumers can subscribe via
+    // Re-emit the server's fine-grained `accessUpdated` event on the
+    // Monitor itself so consumers can subscribe via
     // `monitor.onAccessUpdated(handler)`. The underlying SocketIO has
     // already busted the connection's accessInfo cache; the payload
     // carries the new composite accessId + serial for fine-grained

components/pryv-monitor/src/index.d.ts

@@ -97,10 +97,10 @@ declare module 'pryv' {
     stop(): Monitor;
 
     /**
-     * Plan 66: register a handler for the server's fine-grained
-     * `accessUpdated` event. Requires `Monitor.UpdateMethod.Socket`.
-     * The underlying `connection.socket` busts the
-     * `connection.accessInfo` cache before this fires.
+     * Register a handler for the server's fine-grained `accessUpdated`
+     * event. Requires `Monitor.UpdateMethod.Socket`. The underlying
+     * `connection.socket` busts the `connection.accessInfo` cache
+     * before this fires.
      */
     onAccessUpdated(handler: (payload: { type: 'access-updated', accessId: string, serial: number }) => void): Monitor;
 

components/pryv-socket.io/src/SocketIO.js

@@ -84,10 +84,10 @@ class SocketIO extends EventEmitter {
           this._io.on('connect', () => {
             this.connecting = false;
             registerListeners(this);
-            // Plan 66: when the server emits `accessUpdated` (fine-grained
-            // event fired after every successful `accesses.update`), bust
-            // the connection's `accessInfo` cache so the next read picks
-            // up the new permissions / serial. Best-effort: a failed
+            // When the server emits `accessUpdated` (fine-grained event
+            // fired after every successful `accesses.update`), bust the
+            // connection's `accessInfo` cache so the next read picks up
+            // the new permissions / serial. Best-effort: a failed
             // refresh leaves the previous cached value intact.
             this._io.on('accessUpdated', () => {
               this.connection.accessInfo(true).catch(() => { /* swallow */ });

components/pryv/src/Connection.js

@@ -77,8 +77,8 @@ class Connection {
    * caches the result; subsequent calls return the cached copy in O(1).
    * Pass `forceRefresh: true` to invalidate the cache and fetch a fresh
    * copy from the server — used internally by `connection.socket` to
-   * react to Plan 66 `accessUpdated` server-push events. A failed
-   * server fetch leaves any prior cached value intact.
+   * react to `accessUpdated` server-push events. A failed server
+   * fetch leaves any prior cached value intact.
    *
    * @param {boolean} [forceRefresh=false] - bypass + refresh the cache
    * @returns {Promise<AccessInfo>} Promise resolving to the access info
@@ -429,10 +429,10 @@ class Connection {
   }
 
   /**
-   * Plan 66 (open-pryv.io ≥ 2.0.0-pre.X): update an access by composite id.
-   * Wraps `accesses.update` and translates the 409 `stale-resource` response
-   * into a typed `StaleAccessIdError` so callers can `instanceof`-test and
-   * refetch + retry without re-parsing the inner error.
+   * Update an access by composite id (Pryv.io ≥ 2.0.0-pre.X). Wraps
+   * `accesses.update` and translates the 409 `stale-resource` response
+   * into a typed `StaleAccessIdError` so callers can `instanceof`-test
+   * and refetch + retry without re-parsing the inner error.
    *
    * Pass `id` as the wire-format reference returned by the server — bare
    * cuid on a never-updated access, composite `<base>:<serial>` otherwise.
@@ -456,8 +456,8 @@ class Connection {
   }
 
   /**
-   * Plan 66: fetch an access by composite id including its full version
-   * history (oldest first). Server: `accesses.getOne ?includeHistory=true`.
+   * Fetch an access by composite id including its full version history
+   * (oldest first). Server: `accesses.getOne ?includeHistory=true`.
    *
    * Useful for audit views. Pass the composite `<base>:<serial>` to
    * inspect a specific past version (the result's `current` field then

components/pryv/src/index.d.ts

@@ -725,9 +725,9 @@ declare module 'pryv' {
     ): Promise<HFSeriesAddResult>;
     /** Memoized; pass `forceRefresh: true` to bypass + refresh the cache. */
     accessInfo(forceRefresh?: boolean): Promise<AccessInfo>;
-    /** Plan 66: update an access by composite id. */
+    /** Update an access by composite id. */
     updateAccess(id: string, changes: object): Promise<object>;
-    /** Plan 66: fetch an access including its full version history. */
+    /** Fetch an access including its full version history. */
     getAccessWithHistory(id: string): Promise<{ access: object, current?: string, history?: object[] }>;
     revoke(throwOnFail?: boolean, usingConnection?: Connection): Promise<any>;
     readonly deltaTime: number;

components/pryv/src/index.js

@@ -11,7 +11,7 @@
  * @property {pryv.utils} utils - Exposes some utils for HTTP calls and tools to manipulate Pryv's API endpoints
  * @property {pryv.PryvError} PryvError - Custom error class with innerObject + structured API-error fields
  * @property {pryv.MfaRequiredError} MfaRequiredError - Thrown by Service.login when the platform returns an mfaToken instead of a token. Carries `.mfaToken`.
- * @property {pryv.StaleAccessIdError} StaleAccessIdError - Plan 66: thrown when a Pryv.io server rejects an `accesses.update` / `accesses.delete` with a 409 stale-resource. Refetch + retry.
+ * @property {pryv.StaleAccessIdError} StaleAccessIdError - Thrown when a Pryv.io server rejects an `accesses.update` / `accesses.delete` with a 409 stale-resource. Refetch + retry.
  * @property {Object} ERRORS - Catalogue of Pryv API error ids (mirrors open-pryv.io/components/errors)
  */
 module.exports = {

components/pryv/src/lib/StaleAccessIdError.js

@@ -6,9 +6,9 @@
 const PryvError = require('./PryvError');
 
 /**
- * Plan 66: typed error surfaced when a Pryv.io server (≥ 2.0.0-pre.X)
- * rejects an `accesses.update` or `accesses.delete` call with a
- * 409 `stale-resource` response.
+ * Typed error surfaced when a Pryv.io server (≥ 2.0.0-pre.X) rejects
+ * an `accesses.update` or `accesses.delete` call with a 409
+ * `stale-resource` response.
  *
  * The composite access id `<base>:<serial>` carries the version the
  * caller last observed. If the access has since been updated, the

components/pryv/src/utils.js

@@ -226,11 +226,11 @@ const utils = module.exports = {
   },
 
   /**
-   * Plan 66 (open-pryv.io ≥ 2.0.0-pre.X): parse a wire-format access
-   * reference into `{ base, serial }`. Accepts both bare cuid
-   * (`"abc123"` → `{ base: 'abc123', serial: null }`) and composite
-   * (`"abc123:3"` → `{ base: 'abc123', serial: 3 }`). Throws on
-   * malformed input. Apply this to `access.id`, `access.createdBy`,
+   * Parse a wire-format access reference into `{ base, serial }`
+   * (Pryv.io ≥ 2.0.0-pre.X). Accepts both bare cuid (`"abc123"` →
+   * `{ base: 'abc123', serial: null }`) and composite (`"abc123:3"` →
+   * `{ base: 'abc123', serial: 3 }`). Throws on malformed input.
+   * Apply this to `access.id`, `access.createdBy`,
    * `access.modifiedBy`, and `streamIds` entries of the form
    * `access-<base>:<serial>` from audit events.
    * @memberof pryv.utils
@@ -256,9 +256,9 @@ const utils = module.exports = {
   },
 
   /**
-   * Plan 66: render an `{ base, serial }` pair back to the wire
-   * format. Bare cuid when serial is null/undefined; `<base>:<serial>`
-   * otherwise. Mostly used to construct the composite id when calling
+   * Render an `{ base, serial }` pair back to the wire format. Bare
+   * cuid when serial is null/undefined; `<base>:<serial>` otherwise.
+   * Mostly used to construct the composite id when calling
    * `connection.api()` for `accesses.update` / `accesses.delete`.
    * @memberof pryv.utils
    * @param {{ base: string, serial?: number | null }} ref