Skip to content

Free, Open Source, Self-Hosted WhatsApp API Gateway

docs: count every not-available cell in the docs/29 headings

Yudhi Armyndharise5e47371ad7e
diff --git a/docs/29-engine-capability-matrix.md b/docs/29-engine-capability-matrix.md
index 7ba568ced..7df9aa0c3 100644
--- a/docs/29-engine-capability-matrix.md
+++ b/docs/29-engine-capability-matrix.md
@@ -842,7 +842,7 @@ OpenWA consumes events by normalizing them into `EngineEventCallbacks`; anything
| `group_leave` | ✅ | | `group_update` | ✅ |
| `group_membership_request` | ✅ | | | |
-## 29.6 The 26 not-available cells in detail
+## 29.6 The 27 not-available cells in detail
Every ❌ in 29.4, with the exact library symbol inspected (full evidence strings:
`engine-capability-matrix.ts`). All of these throw `EngineNotSupportedError` → HTTP 501 at the
@@ -865,7 +865,7 @@ adapter boundary — none silently stubs.
| `sendCatalog` | lib | `AnyMessageContent` (`Types/Message.d.ts:166-210`) has only `{product}` (single product); the catalog CRUD nodes (`Socket/business.js:294-362`) mutate the catalog, they don't send it. |
| `votePoll` | lib | No vote-send helper at all; the library only _decrypts incoming_ votes (`decryptPollVote`). Sending needs a hand-built `proto.Message.PollUpdateMessage` with HMAC-SHA256 encryption keyed by the poll creation's `messageSecret`. |
-### 29.6.2 wwjs adapter (14 cells)
+### 29.6.2 wwjs adapter (15 cells)
| Method | Cause | What's missing (evidence) |
| -------------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
diff --git a/src/engine/docs-29-counts.spec.ts b/src/engine/docs-29-counts.spec.ts
index 96281bb1f..d3b327fca 100644
--- a/src/engine/docs-29-counts.spec.ts
+++ b/src/engine/docs-29-counts.spec.ts
@@ -3,8 +3,8 @@ import { join } from 'node:path';
import { engineCapabilityMatrix } from './engine-capability-matrix';
/**
- * `docs/29` states the same three figures in ten places — the intro, the architecture prose, a
- * mermaid node, two section headings, the §29.4 totals and the §29.8 summary. All ten are
+ * `docs/29` states the matrix's figures in many places: the intro, the architecture prose, a
+ * mermaid node, the §29.4 and §29.6 headings, the §29.4 totals and the §29.8 summary. All of them are
* hand-written restatements of what `engine-capability-matrix.ts` contains.
*
* Adding one interface method updated the matrix and §29.8 and left the other six behind, and
@@ -79,11 +79,22 @@ describe('docs/29 counts match the capability matrix', () => {
// The REST caller's view counts the two store-backed status reads as neutral rather than
// wwjs-only; docs/29 states that adjustment explicitly where it uses the figure.
const neutralRaw = rows.filter(r => ok(r.wwjs) && ok(r.baileys)).length;
- return { methods: rows.length, cells: rows.length * 2, supported, neutral: neutralRaw + 2 };
+ // 'not-available' exactly, not "not supported": the document states uncertain cells separately.
+ const wwjsNotAvailable = rows.filter(r => r.wwjs === 'not-available').length;
+ const baileysNotAvailable = rows.filter(r => r.baileys === 'not-available').length;
+ return {
+ methods: rows.length,
+ cells: rows.length * 2,
+ supported,
+ neutral: neutralRaw + 2,
+ notAvailable: wwjsNotAvailable + baileysNotAvailable,
+ wwjsNotAvailable,
+ baileysNotAvailable,
+ };
};
/** Every phrasing in the file that restates one of those figures. */
- const CLAIMS: { label: string; re: RegExp; of: 'methods' | 'cells' | 'supported' | 'neutral' }[] = [
+ const CLAIMS: { label: string; re: RegExp; of: keyof ReturnType<typeof recount> }[] = [
{ label: 'intro coverage', re: /Coverage is total: all (\d+) `IWhatsAppEngine` methods/, of: 'methods' },
{ label: 'section guide', re: /Rows are the (\d+) `IWhatsAppEngine` methods/, of: 'methods' },
{ label: 'architecture prose', re: /`IWhatsAppEngine` interface \((\d+) methods/, of: 'methods' },
@@ -98,6 +109,11 @@ describe('docs/29 counts match the capability matrix', () => {
{ label: '29.8 supported', re: /adapter cells: \*\*(\d+) ✅\*\*/, of: 'supported' },
{ label: '29.8 restated supported', re: /Of the (\d+) ✅ cells/, of: 'supported' },
{ label: '29.8 REST view', re: /REST caller's view: \*\*(\d+)\*\* engine-neutral/, of: 'neutral' },
+ { label: '29.4 totals not-available', re: /adapter cells: \*\*\d+ ✅, (\d+) ❌\*\*/, of: 'notAvailable' },
+ { label: '29.6 heading', re: /^## 29\.6 The (\d+) not-available cells/m, of: 'notAvailable' },
+ { label: '29.6.1 heading', re: /^### 29\.6\.1 Baileys adapter \((\d+) cells\)/m, of: 'baileysNotAvailable' },
+ { label: '29.6.2 heading', re: /^### 29\.6\.2 wwjs adapter \((\d+) cells\)/m, of: 'wwjsNotAvailable' },
+ { label: '29.8 not-available', re: /\*\*\d+ ✅\*\* \/ \*\*(\d+) ❌\*\*/, of: 'notAvailable' },
];
/**