@dszp/netsapiens-lib 0.5.0 → 0.7.0

package/README.md

@@ -79,7 +79,7 @@ genuine zero from a read that never completed rather than silently undercounting
 
 ### Counting a domain: `countDomainInventory`
 
-`countDomainInventory(snapshot)` is pure — it fetches nothing, and turns a `Snapshot` (from
+`countDomainInventory(snapshot, opts?)` is pure — it fetches nothing, and turns a `Snapshot` (from
 `fetchDomainSnapshot`, a backup, or a fixture) into a fixed tree of numeric leaves along the dimensions a
 VoIP operator actually sells on:
 
@@ -92,7 +92,8 @@ VoIP operator actually sells on:
 - `transcriptionEnabled` — extensions with voicemail transcription on.
 - `teamsConnected` — extensions with a Microsoft Teams connector device (SIP `aor` local part
   `<ext>t`). That connector is excluded from `devices`/`deviceCount`: it is a connector, not a handset.
-- `dids` — phone numbers, `total` / `tollFree` / `local`.
+- `dids` — phone numbers: `total` / `tollFree` / `local`, all three **excluding fax lines**, plus
+  `fax` and `all` (everything, `total + fax === all`). See [Fax lines](#fax-lines).
 - `e911Addresses`, `smsNumbers` — record counts.
 - `devices` — `total` and `byModel`, real extensions only (a system user's device is not a seat).
 
@@ -116,9 +117,33 @@ inventory.dids.tollFree;      // e.g. 3
 inventory.devices.byModel;    // e.g. { "Yealink T54W": 12, "(unknown)": 1 }
 ```
 
+#### Fax lines
+
+On the portal's **Fax Server** treatment a fax line is an ordinary phone number whose dial rule hands it
+to a fax server: `dial-rule-application: to-connection` and `dial-rule-translation-destination-host` set
+to that server's host. The API has no fax-account endpoint and the ATA is not a device on any user, so
+that host is the only thing that says "fax line" — and nothing in the API distinguishes an analog fax
+from a digital one.
+
+The host belongs to your deployment, so you supply it; **with no hosts, nothing is a fax line** and the
+counts are exactly what they were before 0.7.0:
+
+```ts
+const inventory = countDomainInventory(snapshot, { faxServerHosts: ['203.0.113.7'] });
+inventory.dids.fax;    // 2 — billed as fax lines
+inventory.dids.total;  // the DIDs, those two NOT among them
+inventory.dids.all;    // total + fax
+```
+
+Matching is on the trimmed host, case-insensitively, and on nothing else — never the
+`dial-rule-description`, which is a note the portal writes and an operator can edit. A fax line's
+`NumberItem.fax` is `true`, its `destination` reads `to fax server` (the host is deliberately not shown),
+and it keeps its `kind`: a fax number is local or toll-free like any other, it is simply not counted as a
+DID.
+
 #### Listing a domain: `listDomainInventory`
 
-`countDomainInventory` is a fold over `listDomainInventory(snapshot)`, which returns the per-item lists
+`countDomainInventory` is a fold over `listDomainInventory(snapshot, opts?)` (same options), which returns the per-item lists
 behind those counts — for anything that shows an operator *which* extension or number a count refers to,
 not just how many. Same allowlist discipline as the counts: a device's MAC, SIP credentials and email
 never appear, though names and sites now do (that's the point of a list). Each item carries a stable
@@ -131,8 +156,9 @@ never appear, though names and sites now do (that's the point of a list). Each i
 | `e911Addresses` | `addr:<emergency-address-id>` |
 | `smsNumbers` | `sms:<number>` |
 
-A number carries `destination` — where it routes, in words (`to user 100 — Ann Lee`, `to queue 701 —
-Sales`), built by the exported `destinationOf(p, userByExt)` over `usersByExt(users)` — and `description`
+A number carries `fax` (see [Fax lines](#fax-lines)) and `destination` — where it routes, in words
+(`to user 100 — Ann Lee`, `to queue 701 — Sales`, `to fax server`), built by the exported
+`destinationOf(p, userByExt, faxServerHosts?)` over `usersByExt(users)` — and `description`
 (`dial-rule-description`, trimmed); an extension carries `devices`, an `{ name, model, teams }` per
 device it has (handset and Teams connector alike), in record order — still never the MAC, SIP password
 or email.
@@ -150,7 +176,9 @@ no separate lookup table:
 | `extensions.withAnyDevice` / `extensions.withNoDevice` | extensions with / without any device (handset or Teams connector) |
 | `transcriptionEnabled` | extensions with transcription on |
 | `teamsConnected` | extensions with a Teams connector |
-| `dids.total` / `dids.tollFree` / `dids.local` | phone numbers |
+| `dids.total` / `dids.tollFree` / `dids.local` | phone numbers, **fax lines excluded** |
+| `dids.fax` | fax lines |
+| `dids.all` | every phone number, fax lines included |
 | `e911Addresses` | E911 addresses |
 | `smsNumbers` | SMS numbers |
 
@@ -172,9 +200,17 @@ against one of them needs to know which inventory items are actually its own. `a
 answers that: it's pure (no account knowledge, just the snapshot) and labels every extension, number,
 address and SMS number either `own-site` (the item's own site matches), `via-user:<ext>` /
 `via-users:<exts>` (it's reachable only through another item that has a site), or an
-`unattributed:<reason>` — `no-site`, `routed-to:<x>`, `shared-across:<sites>`, `unreferenced`, or
+`unattributed:<reason>` — `no-site`, `routed-to:<x>`, `unreferenced`, or
 `sms-user-unknown` when a domain-level SMS number can't be matched to a user because the snapshot was
-never fetched with `includeUserSmsNumbers`. Filter `listDomainInventory(snapshot)`'s items by that
+never fetched with `includeUserSmsNumbers`.
+
+Each verdict carries **`sites: string[]`** as well as `site`. They agree wherever there is one site,
+and only an **E911 address** can carry more than one: an address is a fact about a place, and users on
+four sites can all reference it, so `sites` names every one of them while `site` stays `null`. A
+consumer splitting a domain between billing accounts should read `sites` — placing such an address on
+exactly one account leaves every other referencing account's E911 line short.
+
+Filter `listDomainInventory(snapshot)`'s items by that
 attribution to scope a domain down to one site, then run `countInventoryDetail(detail)` over what's left
 to get counts that agree with what you kept, rather than recomputing `countDomainInventory` against the
 whole domain and hoping the numbers happen to match.

package/dist/attribution.d.ts

@@ -1,7 +1,19 @@
 import type { Snapshot } from './model.js';
 export interface ItemAttribution {
-    /** The site this item belongs to; `null` when it cannot be placed. */
+    /**
+     * The single site this item belongs to; `null` when there is not exactly one — nothing placed it, or
+     * (addresses only) several did. Read {@link sites} to tell those two apart.
+     */
     site: string | null;
+    /**
+     * EVERY site this item belongs to, unique and sorted. One entry wherever {@link site} is set, none
+     * where nothing placed it, and — for an address referenced from several sites — one per site.
+     *
+     * The wider field, and the one a consumer splitting a domain between accounts should read: only an
+     * ADDRESS can carry more than one, because only an address is a fact about a place rather than about
+     * a user, a number or a route.
+     */
+    sites: string[];
     /** `own-site` | `via-user:<ext>` | `via-users:<ext,ext>` | `unattributed:<reason>`. */
     how: string;
 }

package/dist/attribution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../src/attribution.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAO,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAC;CACb;AACD,MAAM,WAAW,iBAAiB;IAAG,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CAAE;AAI7E,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,GAAG,iBAAiB,CAyD9E"}
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../src/attribution.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAO,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;;;;;;OAOG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAC;CACb;AACD,MAAM,WAAW,iBAAiB;IAAG,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CAAE;AAI7E,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,GAAG,iBAAiB,CA8D9E"}

package/dist/attribution.js

@@ -18,9 +18,12 @@
  *   a queue at the North site is a North number. Only a site-less system user falls back to
  *   `routed-to:<that user's service-code>`; when the destination names nobody, `routed-to:<application>`;
  *   a site-less real user is `no-site`.
- * - An address: the one site every REAL extension referencing it sits on (`via-users:<exts>`);
- *   `shared-across:<sites>` when they sit on more than one; `unreferenced` when none does;
- *   `no-site` when the referencing users have no site.
+ * - An address: EVERY site a REAL extension referencing it sits on (`via-users:<exts>`), in `sites`.
+ *   An address is a fact about a PLACE, and users on four sites can legitimately reference one — so
+ *   the multi-site case is not a failure to attribute, it is the answer. `site` is the single site
+ *   when there is exactly one and `null` otherwise, so a consumer that can only hold one still reads
+ *   the unambiguous case correctly. `unreferenced` when no real extension names it; `no-site` when the
+ *   ones that do have no site.
  * - An SMS number: the site of the user whose per-user list carries it (`via-user:<ext>`), or
  *   `sms-user-unknown` when no per-user list does — including when the per-user read was never
  *   made. Never guessed from the domain-level list, which does not say.
@@ -32,7 +35,7 @@
  * invariant is this library's own, and this is the one place allowed to lean on it.
  */
 import { isSystemUser, listDomainInventory, str, usersByExt } from './inventory.js';
-const none = (reason) => ({ site: null, how: `unattributed:${reason}` });
+const none = (reason) => ({ site: null, sites: [], how: `unattributed:${reason}` });
 export function attributeDomainInventory(snapshot) {
     const users = Array.isArray(snapshot.users) ? snapshot.users : [];
     const phonenumbers = Array.isArray(snapshot.phonenumbers) ? snapshot.phonenumbers : [];
@@ -42,9 +45,11 @@ export function attributeDomainInventory(snapshot) {
     const d = listDomainInventory(snapshot);
     const items = {};
     const userByExt = usersByExt(users);
+    /** The single-site verdict, with `sites` kept in step so the two fields can never disagree. */
+    const one = (site, how) => ({ site, sites: [site], how });
     // Extensions: the detail already carries `site`, so no record is needed here.
     for (const x of d.extensions)
-        items[x.key] = x.site ? { site: x.site, how: 'own-site' } : none('no-site');
+        items[x.key] = x.site ? one(x.site, 'own-site') : none('no-site');
     // Numbers, by index against `phonenumbers`.
     for (let i = 0; i < d.dids.length; i++) {
         const key = d.dids[i].key, p = phonenumbers[i] ?? {};
@@ -60,7 +65,7 @@ export function attributeDomainInventory(snapshot) {
             items[key] = isSystemUser(u) ? none(`routed-to:${str(u['service-code'])}`) : none('no-site');
             continue;
         }
-        items[key] = { site, how: `via-user:${dest}` };
+        items[key] = one(site, `via-user:${dest}`);
     }
     // Addresses, by index against `addresses`; referenced by REAL extensions only.
     const refs = new Map();
@@ -82,12 +87,15 @@ export function attributeDomainInventory(snapshot) {
             continue;
         }
         const sites = [...new Set(who.map((u) => str(u.site)).filter(Boolean))].sort();
-        if (sites.length === 0)
+        if (sites.length === 0) {
             items[key] = none('no-site');
-        else if (sites.length === 1)
-            items[key] = { site: sites[0], how: `via-users:${who.map((u) => str(u.user)).filter(Boolean).sort().join(',')}` };
-        else
-            items[key] = none(`shared-across:${sites.join(',')}`);
+            continue;
+        }
+        // SEVERAL SITES IS AN ANSWER, not a failure. The referencing users name every place this address
+        // is used, and a consumer billing per site needs all of them; `site` still answers only the
+        // unambiguous case, which is what keeps a one-site consumer correct without reading `sites`.
+        const how = `via-users:${who.map((u) => str(u.user)).filter(Boolean).sort().join(',')}`;
+        items[key] = sites.length === 1 ? one(sites[0], how) : { site: null, sites, how };
     }
     // SMS numbers, by index against `smsnumbers`, joined to a user through the per-user lists.
     const extBySms = new Map();
@@ -107,7 +115,7 @@ export function attributeDomainInventory(snapshot) {
             continue;
         }
         const site = str(u.site);
-        items[key] = site ? { site, how: `via-user:${ext}` } : none('no-site');
+        items[key] = site ? one(site, `via-user:${ext}`) : none('no-site');
     }
     return { items };
 }

package/dist/attribution.js.map

@@ -1 +1 @@
-{"version":3,"file":"attribution.js","sourceRoot":"","sources":["../src/attribution.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"attribution.js","sourceRoot":"","sources":["../src/attribution.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -16,7 +16,7 @@ export { THEMES, DEFAULT_LIGHT_THEME, DEFAULT_DARK_THEME, NODE_LIGHT, NODE_DARK,
 export { renderGalleryHtml, renderFlowCards, renderFlowCard, mermaidBootstrap, flowAnchorId, type GalleryOptions, type CardOptions, } from './html.js';
 export { resolveSvgSize, rasterizerScript } from './raster.js';
 export { NsClient, NsApiError, assertBareServer, fetchDomainSnapshot, listDomains, asArray, type NsClientConfig, type FetchSnapshotOptions } from './nsClient.js';
-export { countDomainInventory, countInventoryDetail, listDomainInventory, itemsFor, itemLabel, destinationOf, usersByExt, type DomainInventory, type DomainInventoryDetail, type ExtensionItem, type NumberItem, type AddressItem, type SmsItem, type InventoryItem } from './inventory.js';
+export { countDomainInventory, countInventoryDetail, listDomainInventory, itemsFor, itemLabel, destinationOf, usersByExt, type DomainInventory, type DomainInventoryDetail, type InventoryOptions, type ExtensionItem, type NumberItem, type AddressItem, type SmsItem, type InventoryItem } from './inventory.js';
 export { attributeDomainInventory, type DomainAttribution, type ItemAttribution } from './attribution.js';
 export { NsWriteClient, type NsWriteClientConfig } from './nsWriteClient.js';
 export { supportsSynchronous, SYNCHRONOUS_OPERATIONS, type SynchronousMethod, type SynchronousOperation, } from './nsSynchronous.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAkB,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAuC,MAAM,cAAc,CAAC;AAC9E,OAAO,EACL,MAAM,EACN,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,GAKV,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,YAAY,GAGb,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,WAAW,EAAE,OAAO,EAAkD,MAAM,eAAe,CAAC;AAClK,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAA6I,MAAM,gBAAgB,CAAC;AAC5R,OAAO,EAAE,wBAAwB,EAAgD,MAAM,kBAAkB,CAAC;AAC1G,OAAO,EAAE,aAAa,EAA4B,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GAGvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,YAAY,GAIb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAiD,MAAM,mBAAmB,CAAC;AAC7G,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAUlB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,MAAM,EACN,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,kBAAkB,GAOnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAwB,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EACL,WAAW,EACX,aAAa,EACb,eAAe,EACf,YAAY,GAIb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,SAAS,EACT,GAAG,GAIJ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,GAOpB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAkB,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAuC,MAAM,cAAc,CAAC;AAC9E,OAAO,EACL,MAAM,EACN,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,GAKV,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,YAAY,GAGb,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,WAAW,EAAE,OAAO,EAAkD,MAAM,eAAe,CAAC;AAClK,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAoK,MAAM,gBAAgB,CAAC;AACnT,OAAO,EAAE,wBAAwB,EAAgD,MAAM,kBAAkB,CAAC;AAC1G,OAAO,EAAE,aAAa,EAA4B,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GAGvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,YAAY,GAIb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAiD,MAAM,mBAAmB,CAAC;AAC7G,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAUlB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,MAAM,EACN,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,kBAAkB,GAOnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAwB,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EACL,WAAW,EACX,aAAa,EACb,eAAe,EACf,YAAY,GAIb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,SAAS,EACT,GAAG,GAIJ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,GAOpB,MAAM,kBAAkB,CAAC"}

package/dist/inventory.d.ts

@@ -9,9 +9,9 @@
  * A device record from NetSapiens carries the SIP registration password. `listDomainInventory` builds
  * per-item lists — an extension's name and site, a number's kind and routing destination, an address's
  * label — from an allowlist of named fields, and `countDomainInventory` is a fold over those same
- * lists. The allowlist now includes a device's NAME (its `aor` local part, e.g. `101b` — the same
- * short id the portal shows) alongside its model; a device's MAC, SIP password and email never appear,
- * and nothing here should be added that carries one.
+ * lists. The allowlist now includes a device's NAME (the local part of its `device` SIP URI, falling back
+ * to `aor` — e.g. `101b`, the same short id the portal shows) alongside its model; a device's MAC, SIP
+ * password and email never appear, and nothing here should be added that carries one.
  *
  * ## Every countable dimension is a numeric leaf
  *
@@ -24,6 +24,20 @@
  * A user whose `service-code` is empty or does not begin with `system-`. NetSapiens models auto
  * attendants, queues and time-of-day routers as users, and counting them as seats would overstate
  * every domain that has any. They are counted separately, as information, and never compared.
+ *
+ * ## What counts as a fax line
+ *
+ * On the portal's "Fax Server" treatment a number is an ordinary phone number whose dial rule hands it
+ * to a fax server host — `dial-rule-application: to-connection` with
+ * `dial-rule-translation-destination-host` set to that host. There is no fax-account endpoint and the
+ * ATA is not a device on any user, so the host is the only thing in the API that says "this is a fax
+ * line", and nothing in the API can tell an analog fax from a digital one.
+ *
+ * The host is therefore the whole test, and it is the CALLER's: pass `{ faxServerHosts }` to
+ * {@link listDomainInventory} or {@link countDomainInventory}. Matching is on the trimmed host,
+ * case-insensitively, and on nothing else — not the `dial-rule-description`, which is a portal-written
+ * note an operator can edit. **With no hosts supplied nothing is a fax line**, because a library that
+ * hardcoded one deployment's fax server would be wrong everywhere else.
  */
 import type { Rec, Snapshot } from './model.js';
 export interface DomainInventory {
@@ -49,16 +63,28 @@ export interface DomainInventory {
     /** Extensions whose `voicemail-transcription-enabled` is anything but empty or `no`. */
     transcriptionEnabled: number;
     /**
-     * Extensions with a Microsoft Teams connector device — one whose SIP `aor` local part is the
-     * extension number followed by `t` (`1000t`), which is how the TeamMate connector registers.
+     * Extensions with a Microsoft Teams connector device — one whose device NAME is the extension number
+     * followed by `t` (`1000t`), which is how the TeamMate connector registers. See {@link deviceName} for
+     * which field that name is read from, and why reading the wrong one silently miscounted this.
      * That device is NOT counted under `devices`: it is a connector, not a handset.
      */
     teamsConnected: number;
-    /** Phone numbers on the domain, split by NANP toll-free prefix. */
+    /**
+     * Phone numbers on the domain, split by NANP toll-free prefix — **fax lines excluded**.
+     *
+     * A number handed to the fax server is billed as a fax line, not as a DID, so `total`, `tollFree`
+     * and `local` all leave it out and `fax` counts it instead. `all` is every phone number the domain
+     * holds, fax lines included: `total + fax === all`.
+     *
+     * With no `faxServerHosts` supplied nothing is a fax line, `fax` is 0 and `total === all` — the
+     * numbers this returned before 0.7.0, unchanged.
+     */
     dids: {
         total: number;
         tollFree: number;
         local: number;
+        fax: number;
+        all: number;
     };
     /** E911 address records on the domain. */
     e911Addresses: number;
@@ -99,8 +125,9 @@ export interface ExtensionItem {
     /** `device-models-model` per handset, `(unknown)` when blank. Never the MAC. */
     deviceModels: string[];
     /**
-     * Every device on this extension, in record order, connector included: `name` is the `aor` local
-     * part (`sip:101b@acme.example` → `101b`) — the device NAME as the portal shows it — `model` is
+     * Every device on this extension, in record order, connector included: `name` is the local part of its
+     * `device` SIP URI, or of `aor` when that is all the record has (`sip:101b@acme.example` → `101b`) —
+     * the device NAME as the portal shows it — `model` is
      * `device-models-model` (`(unknown)` when blank on a handset, `''` for the Teams connector, which
      * has no model), and `teams` marks the connector entry itself. `deviceCount`/`deviceModels`/`teams`
      * above stay handset-only; this list is the one place a connector's own row shows up. Never the MAC
@@ -118,6 +145,14 @@ export interface NumberItem {
     key: string;
     number: string;
     kind: 'local' | 'tollFree';
+    /**
+     * This number is handed to a fax server — see the module doc. `false` whenever the caller supplied no
+     * `faxServerHosts`, since without a host list nothing here can tell a fax line from any other number.
+     *
+     * `kind` is still set on a fax line (a fax number is local or toll-free like any other), but the
+     * COUNTS exclude it from `dids.total`/`local`/`tollFree` and count it under `dids.fax` instead.
+     */
+    fax: boolean;
     /** Where the number routes, for a person: see {@link destinationOf}. `''` when the record says nothing. */
     destination: string;
     /** `dial-rule-description` trimmed — the note the portal writes ("Portal Created: User - 1001"); `''` when blank. */
@@ -141,6 +176,19 @@ export interface DomainInventoryDetail {
     e911Addresses: AddressItem[];
     smsNumbers: SmsItem[];
 }
+/**
+ * What the caller has to tell the counter that the API cannot. Optional in full: every option absent is
+ * the pre-0.7.0 behaviour, and no option changes what a snapshot has to contain.
+ */
+export interface InventoryOptions {
+    /**
+     * The hosts a fax line is handed to — an IP or a hostname, as it appears in
+     * `dial-rule-translation-destination-host`. Compared trimmed and case-insensitively; blanks are
+     * ignored. Absent or empty means NO number is a fax line. See the module doc for why this is the
+     * caller's to supply.
+     */
+    faxServerHosts?: readonly string[];
+}
 export declare const str: (v: unknown) => string;
 /** Is this user one of NetSapiens' internal routing objects rather than a seat? */
 export declare function isSystemUser(user: Rec): boolean;
@@ -170,8 +218,13 @@ export declare function usersByExt(users: Rec[]): Map<string, Rec>;
  * - No destination but an application is set → `to <application>` (`to-connection` → `to connection`,
  *   `to-voicemail` → `to voicemail`).
  * - Neither is set → `''`.
+ *
+ * A FAX LINE — a number whose destination host is one of `faxServerHosts` — short-circuits all of that
+ * and reads `to fax server`, host omitted. Otherwise it would render as `to connection` (which names
+ * plumbing, not a destination) or, on a rule that also carries a destination user, as a bare IP address
+ * beside a customer's phone number. Nobody reading this line needs the fax server's address.
  */
-export declare function destinationOf(p: Rec, userByExt: Map<string, Rec>): string;
+export declare function destinationOf(p: Rec, userByExt: Map<string, Rec>, faxServerHosts?: readonly string[]): string;
 /**
  * The items behind every count. Pure. Fields are copied by name from an allowlist; no record passes
  * through, so a device's MAC or SIP password cannot reach a consumer by accident.
@@ -189,9 +242,9 @@ export declare function destinationOf(p: Rec, userByExt: Map<string, Rec>): stri
  * countable thing, and one derived row is more honest than two that shuffle. A blank id is a
  * provisioning fault to fix; the fallback only keeps the distinguishable ones apart until it is.
  */
-export declare function listDomainInventory(snapshot: Snapshot): DomainInventoryDetail;
+export declare function listDomainInventory(snapshot: Snapshot, opts?: InventoryOptions): DomainInventoryDetail;
 /** The counts, as a fold over {@link listDomainInventory} so the two can never disagree. */
-export declare function countDomainInventory(snapshot: Snapshot): DomainInventory;
+export declare function countDomainInventory(snapshot: Snapshot, opts?: InventoryOptions): DomainInventory;
 /**
  * Count an item list. Exposed separately so a consumer that has FILTERED the lists — to one site, to
  * one billing account — gets counts that agree with what it kept, rather than re-counting the snapshot.

package/dist/inventory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../src/inventory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../src/inventory.ts"],"names":[],"mappings":"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"}

package/dist/inventory.js

@@ -43,17 +43,48 @@ function isTollFree(raw) {
     const nanp = digits.length === 11 && digits.startsWith('1') ? digits.slice(1) : digits;
     return nanp.length === 10 && TOLL_FREE.has(nanp.slice(0, 3));
 }
-/** The local part of a device's `aor` (`sip:103t@acme.example` → `103t`), read only to test for Teams. */
-function aorLocal(device) {
-    const a = str(device.aor).replace(/^sip:/i, '');
+/** The fax-server hosts, trimmed, lower-cased and with blanks dropped — the shape {@link isFaxLine} tests against. */
+function faxHosts(hosts) {
+    const out = new Set();
+    for (const h of hosts ?? []) {
+        const v = str(h).toLowerCase();
+        if (v)
+            out.add(v);
+    }
+    return out;
+}
+/**
+ * Is this number handed to a fax server? The `dial-rule-translation-destination-host` alone, matched
+ * against the caller's list — never the `dial-rule-description`, which is a note the portal writes and
+ * an operator can edit. An empty host set answers `false` for everything, which is the point: this
+ * library knows no fax server of its own.
+ */
+function isFaxLine(p, hosts) {
+    if (!hosts.size)
+        return false;
+    return hosts.has(str(p['dial-rule-translation-destination-host']).toLowerCase());
+}
+/**
+ * A device's NAME — the local part of its SIP URI (`sip:103t@acme.example` → `103t`), which is the short
+ * id the portal shows and the string the Teams test matches against.
+ *
+ * **`device` first, `aor` second.** A live `/users/<ext>/devices` record names the device in `device` and
+ * frequently carries no `aor` at all; reading `aor` alone therefore returned `''` on live data, which
+ * blanked every device name on the page AND broke the `<ext>t` Teams test — so a Teams connector read as
+ * `teams: false` and was counted as a handset in `deviceCount` and `devices.total`. Some records carry
+ * both, and then `device` wins, being the field the system actually names the device by. Neither, and the
+ * name is `''` rather than a guess.
+ */
+function deviceName(device) {
+    const a = (str(device.device) || str(device.aor)).replace(/^sip:/i, '');
     const at = a.indexOf('@');
     return at === -1 ? a : a.slice(0, at);
 }
 function extensionItem(u, devices) {
     const ext = str(u.user);
-    // The Teams test is `<ext>t`, so a blank ext would read every device whose aor local part is a
-    // bare `t` as a connector. No extension number, no Teams claim.
-    const handsets = ext ? devices.filter((d) => aorLocal(d) !== `${ext}t`) : devices;
+    // The Teams test is `<ext>t`, so a blank ext would read every device NAMED a bare `t` as a connector.
+    // No extension number, no Teams claim.
+    const handsets = ext ? devices.filter((d) => deviceName(d) !== `${ext}t`) : devices;
     const transcription = str(u['voicemail-transcription-enabled']).toLowerCase();
     const teams = handsets.length !== devices.length;
     const name = `${str(u['name-first-name'])} ${str(u['name-last-name'])}`.trim();
@@ -74,8 +105,9 @@ function extensionItem(u, devices) {
         deviceModels: handsets.map((d) => str(d['device-models-model']) || '(unknown)'),
         // Every device, including the Teams connector — this is a display list, not a seat count.
         devices: devices.map((d) => {
-            const isTeams = ext ? aorLocal(d) === `${ext}t` : false;
-            return { name: aorLocal(d), model: isTeams ? '' : str(d['device-models-model']) || '(unknown)', teams: isTeams };
+            const name = deviceName(d);
+            const isTeams = ext ? name === `${ext}t` : false;
+            return { name, model: isTeams ? '' : str(d['device-models-model']) || '(unknown)', teams: isTeams };
         }),
         anyDevice: handsets.length > 0 || teams,
     };
@@ -114,8 +146,15 @@ export function usersByExt(users) {
  * - No destination but an application is set → `to <application>` (`to-connection` → `to connection`,
  *   `to-voicemail` → `to voicemail`).
  * - Neither is set → `''`.
+ *
+ * A FAX LINE — a number whose destination host is one of `faxServerHosts` — short-circuits all of that
+ * and reads `to fax server`, host omitted. Otherwise it would render as `to connection` (which names
+ * plumbing, not a destination) or, on a rule that also carries a destination user, as a bare IP address
+ * beside a customer's phone number. Nobody reading this line needs the fax server's address.
  */
-export function destinationOf(p, userByExt) {
+export function destinationOf(p, userByExt, faxServerHosts) {
+    if (isFaxLine(p, faxHosts(faxServerHosts)))
+        return 'to fax server';
     const dest = str(p['dial-rule-translation-destination-user']);
     const app = str(p['dial-rule-application']).replace(/^to-/i, '');
     const host = str(p['dial-rule-translation-destination-host']);
@@ -151,7 +190,7 @@ export function destinationOf(p, userByExt) {
  * countable thing, and one derived row is more honest than two that shuffle. A blank id is a
  * provisioning fault to fix; the fallback only keeps the distinguishable ones apart until it is.
  */
-export function listDomainInventory(snapshot) {
+export function listDomainInventory(snapshot, opts) {
     const users = Array.isArray(snapshot.users) ? snapshot.users : [];
     const devicesByUser = (snapshot.devicesByUser ?? {});
     const phonenumbers = Array.isArray(snapshot.phonenumbers) ? snapshot.phonenumbers : [];
@@ -172,12 +211,17 @@ export function listDomainInventory(snapshot) {
         (isSystemUser(u) ? systemUsers : extensions).push(item);
     }
     const userByExt = usersByExt(users);
+    // Normalised once, not per number: the host list is the caller's and does not change mid-fold.
+    const hosts = faxHosts(opts?.faxServerHosts);
     const dids = phonenumbers.map((p) => {
         const number = str(p.phonenumber);
         const kind = isTollFree(number) ? 'tollFree' : 'local';
-        const destination = destinationOf(p, userByExt);
+        const fax = isFaxLine(p, hosts);
+        // The KEY does not carry `fax`. It is a fact about how the number is routed today, and routing a
+        // number to the fax server must not orphan every decision a consumer recorded against it.
+        const destination = fax ? 'to fax server' : destinationOf(p, userByExt);
         const description = str(p['dial-rule-description']);
-        return { key: identityKey('did', number, JSON.stringify({ number, kind })), number, kind, destination, description };
+        return { key: identityKey('did', number, JSON.stringify({ number, kind })), number, kind, fax, destination, description };
     });
     const e911Addresses = addresses.map((a, i) => {
         const id = str(a['emergency-address-id']);
@@ -200,8 +244,8 @@ export function listDomainInventory(snapshot) {
     return { extensions, systemUsers, dids, e911Addresses, smsNumbers };
 }
 /** The counts, as a fold over {@link listDomainInventory} so the two can never disagree. */
-export function countDomainInventory(snapshot) {
-    return countInventoryDetail(listDomainInventory(snapshot));
+export function countDomainInventory(snapshot, opts) {
+    return countInventoryDetail(listDomainInventory(snapshot, opts));
 }
 /**
  * Count an item list. Exposed separately so a consumer that has FILTERED the lists — to one site, to
@@ -213,7 +257,7 @@ export function countInventoryDetail(d) {
         systemUsers: { total: d.systemUsers.length, byServiceCode: {} },
         transcriptionEnabled: 0,
         teamsConnected: 0,
-        dids: { total: d.dids.length, tollFree: 0, local: 0 },
+        dids: { total: 0, tollFree: 0, local: 0, fax: 0, all: d.dids.length },
         e911Addresses: d.e911Addresses.length,
         smsNumbers: d.smsNumbers.length,
         devices: { total: 0, byModel: {} },
@@ -239,7 +283,16 @@ export function countInventoryDetail(d) {
         for (const m of x.deviceModels)
             bump(inv.devices.byModel, m);
     }
+    // A fax line is billed as a fax line, so it lands in `fax` and in NEITHER of the two DID buckets —
+    // counting it as both would bill one number twice on a rulebook that has a rule for each. `fax` is
+    // read off the item rather than recomputed: an item list a consumer FILTERED still carries it, and a
+    // list built by a pre-0.7.0 lib has no `fax` at all, which reads as false and counts as it always did.
     for (const n of d.dids) {
+        if (n.fax) {
+            inv.dids.fax++;
+            continue;
+        }
+        inv.dids.total++;
         if (n.kind === 'tollFree')
             inv.dids.tollFree++;
         else
@@ -276,12 +329,19 @@ export function itemsFor(detail, path) {
         return ex.filter((x) => x.transcription);
     if (path === 'teamsConnected')
         return ex.filter((x) => x.teams);
+    // The three DID paths exclude fax lines, exactly as the counts do — a `counts: "dids.total"` rule
+    // whose observed number left the fax lines out but whose item list showed them would offer an
+    // operator rows to accept that the number above them does not count.
     if (path === 'dids.total')
-        return detail.dids;
+        return detail.dids.filter((n) => !n.fax);
     if (path === 'dids.tollFree')
-        return detail.dids.filter((n) => n.kind === 'tollFree');
+        return detail.dids.filter((n) => !n.fax && n.kind === 'tollFree');
     if (path === 'dids.local')
-        return detail.dids.filter((n) => n.kind === 'local');
+        return detail.dids.filter((n) => !n.fax && n.kind === 'local');
+    if (path === 'dids.fax')
+        return detail.dids.filter((n) => n.fax);
+    if (path === 'dids.all')
+        return detail.dids;
     if (path === 'e911Addresses')
         return detail.e911Addresses;
     if (path === 'smsNumbers')