@nanolink/mirrors 1.1.34 → 1.1.35

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,269 +1,269 @@
-# @nanolink/mirrors
-
-GraphQL subscription client + in‑memory mirror synchronization utilities. Optimized for incremental change streams that send START / UPDATED / DELETED / DONE / VERSION_ERROR frames.
-
-## Features
-* Lightweight `SubscriptionClient` around `graphql-ws` with explicit connect, controlled reconnect, and small event surface.
-* Dual version support in `MirrorSync` (`version` numeric + optional `opVersion` string) for hybrid sequence + causality ordering (either dimension can drive resync logic when present).
-* Stale delete & update guards: ignores events older in either version dimension to prevent resurrecting removed or outdated entities.
-* Efficient updates: UPDATED replaces item wholesale only when newer; no deep merge overhead.
-* Full sync cycle handling via START/DONE gates; `loaded` promise resolves after first DONE and re-arms on VERSION_ERROR.
-* Automatic resubscribe after reconnect using last known versions (no duplicate inserts).
-* Read‑only delegated map interface for consumers (prevents accidental mutation of internal state).
-* `Connection` helper manages multiple mirrors, re‑emitting namespaced events (`mirror:start`, `mirror:updated`, ...).
-* Proxy-aware WebSocket resolution: if proxy env vars are present (ALL_PROXY / HTTPS_PROXY / HTTP_PROXY / GLOBAL_AGENT_HTTP_PROXY) the client prefers the Node `ws` implementation; otherwise uses existing global WebSocket (browser / Node >=18) or falls back to `ws`.
-* Minimal dependencies; event system via `eventemitter3`.
-
-## Install
-```bash
-npm install @nanolink/mirrors
-```
-
-Optional (proxy via global-agent for generic HTTP(S) requests—WebSocket selection is still handled automatically as described):
-```js
-// enableProxy.js
-import 'global-agent/bootstrap';
-process.env.GLOBAL_AGENT_HTTP_PROXY = 'http://proxy:3128';
-```
-Run with:
-```bash
-node -r global-agent/bootstrap app.js
-```
-
-## Usage
-### What is a mirror?
-A mirror is an in-memory, read-only view of a server-side collection. The server sends GraphQL subscription frames with `START`, `UPDATED`, `DELETED`, `DONE`, and `VERSION_ERROR` messages; `MirrorSync` applies those messages to a local `Map` keyed by `id`.
-
-Each mirror tracks the latest cursor it has seen. Older subscriptions use numeric `version` / `deleteVersion`; newer subscriptions may use string `opVersion` / `deleteOpVersion`. `MirrorSync` supports both cursor styles and resubscribes from the latest known cursor after reconnect.
-
-`Connection` manages multiple named mirrors. It creates `MirrorSync` instances, stores them in `Connection.Mirrors`, and re-emits mirror events as `mirror:<event>` with the mirror name included.
-
-### Quick connection with a predefined mirror
-```ts
-import { Connection } from '@nanolink/mirrors';
-
-const conn = new Connection();
-
-conn.InitConnection('wss://api.example.com/ws', async () => ({
-  authToken: 'TOKEN',
-}));
-
-conn.on('connected', () => console.log('socket up'));
-conn.on('mirror:updated', e => console.log('updated', e.mirrorName, e.doc.id));
-
-conn.connect();
-
-async function main() {
-  const trackers = await conn.getPredefinedMirror('trackers');
-
-  console.log('Initial size', trackers.size);
-  for (const tracker of trackers.values()) {
-    console.log(tracker);
-  }
-}
-
-main();
-```
-
-### Custom mirror subscription
-```ts
-const users = await conn.getMirror('users', `
-    subscription Users($version: Long, $opVersion: String) {
-      users(version: $version, opVersion: $opVersion) {
-        type
-        total
-        deleteId
-        deleteVersion
-        deleteOpVersion
-        data { id version opVersion name }
-      }
-    }
-  `, {});
-
-console.log('Initial size', users.size);
-for (const user of users.values()) {
-  console.log(user);
-}
-```
-
-### Accessing the MirrorSync instance
-`getMirror()` and `getPredefinedMirror()` wait for the initial `DONE` frame and return a `ReadonlyMapView`. If you need mirror-specific events or stats, use `registerMirror()` directly.
-
-```ts
-const mirror = conn.registerMirror('users', usersSubscription, {});
-
-mirror.on('updated', e => console.log('user updated', e.doc.id));
-mirror.on('deleted', e => console.log('user deleted', e.orgDoc.id));
-
-const users = await mirror.load();
-console.log(mirror.stats(), users.size);
-```
-
-### Waiting for a specific mirror change
-Use `waitForUpdated()` or `waitForDeleted()` when a command or mutation must wait until the local mirror has observed the resulting server-side change. Create the wait promise before sending the command, then await it after the command completes.
-
-```ts
-const updated = mirror.waitForUpdated(referenceId);
-
-await saveReferenceMutation(referenceId);
-const { doc, orgDoc } = await updated;
-
-console.log('Mirror caught up', doc.id, orgDoc?.version, doc.version);
-```
-
-Both methods accept either an id or a predicate, and default to a 120 second timeout.
-
-```ts
-await mirror.waitForUpdated(
-  event => event.doc.externalIds?.some((id: any) => id.key === 'SAP_ID' && id.value === sapId),
-  { timeoutMs: 30_000 }
-);
-
-await mirror.waitForDeleted(referenceId);
-```
-
-### Numeric‑only subscriptions (most common)
-Most Nanolink GraphQL subscription fields expose only a numeric `version` and omit `opVersion`. `MirrorSync` handles this seamlessly: pass just `$version` in the query and the server responses won’t include `opVersion` / `deleteOpVersion` fields.
-
-```ts
-// Numeric-only example
-const products = await conn.getMirror('products', `
-  subscription Products($version: Long) {
-    products(version: $version) {
-      type
-      total
-      deleteId
-      deleteVersion
-      data { id version title }
-    }
-  }
-`, {});
-
-await products.loaded; // after first DONE
-console.log('Products count', products.size);
-```
-
-When `opVersion` fields are absent they are simply ignored; ordering & stale protections rely on numeric `version` only.
-
-### Direct low-level client
-```ts
-import { SubscriptionClient } from '@nanolink/mirrors';
-
-const sc = new SubscriptionClient();
-
-sc.InitClient({
-  url: 'wss://api.example.com/ws',
-  connectionParams: async () => ({ authToken: 'TOKEN' }),
-  maxReconnectAttempts: 10,
-});
-
-sc.connect();
-
-sc.on('connected', () => {
-  const dispose = sc.clientsubscribe({
-    query: 'subscription Ping { ping }'
-  }, {
-    next: (msg) => console.log(msg),
-    error: (e) => console.error('err', e),
-    complete: () => console.log('done')
-  });
-});
-```
-
-## Events
-`SubscriptionClient` emits:
-* connecting
-* connected (first successful connect)
-* reconnected (subsequent successful connect after a disconnect)
-* disconnected ({ code, reason, wasClean })
-* retry ({ attempt }) before a reconnect attempt delay
-* error (network/protocol)
-
-`Connection` re‑emits mirror events as `mirror:<event>` with payload `{ mirrorName, ... }`:
-* start
-* updated (only when a newer item actually replaced stored data)
-* deleted
-* done (end of full sync batch)
-* versionError (triggered resync)
-* resubscribe (automatic after reconnect)
-* error
-* removed (mirror explicitly removed)
-* cleared (mirror internal state cleared)
-
-## API Surface
-* `SubscriptionClient` – low level websocket subscription wrapper.
-* `MirrorSync` – single mirror controller (dual version tracking).
-* `Connection` – manages multiple named mirrors and re-emits namespaced mirror events.
-* `ReadonlyMapView` – read-only view returned by `getMirror()`, `getPredefinedMirror()`, and `MirrorSync.load()`.
-* `waitForUpdated()` / `waitForDeleted()` – wait until the mirror observes a specific future update or delete event.
-
-Note about mirror helpers
--------------------------
-`getMirror()` is available for custom ad-hoc mirrors but is seldom used in most integrations. The more commonly used helper is `getPredefinedMirror()` which returns mirrors for known server-side definitions (IDs and field payload shapes) and avoids having to supply the raw GraphQL subscription yourself. Check `src/definitions` for available predefined mirror names and subscription fragments.
-
-## Notes
-* Always call `connect()` explicitly; no implicit lazy connect.
-* Call `InitConnection()` on `Connection`, or `InitClient()` on `SubscriptionClient`, before connecting.
-* VERSION_ERROR triggers automatic full resync (re-arms `loaded`).
-* First top-level field in GraphQL subscription payload is treated as the sync envelope.
-* Full sync updates are buffered until `DONE`, then swapped into the live mirror.
-* Provide `webSocketImpl` manually if bundling for environments without a global WebSocket and you do NOT want `ws` as fallback.
-* When proxy env vars are set in Node, `SubscriptionClient` prefers `ws` (allowing external agent configuration); browsers ignore these env vars.
-
-## Build & Publish
-TypeScript sources compile to `dist/`.
-
-Scripts:
-```bash
-npm run build       # compile
-npm run publish:dry # preview publish contents
-npm run release     # build + publish (public)
-```
-
-Developer notes (recent refactor)
----------------------------------
-This repository recently split GraphQL subscription template literals into per-property modules to make maintenance easier:
-
-- Subscription templates: `src/definitions/subscriptions/*.ts` — one file per subscription property.
-- Shared fragments: `src/definitions/fragments.ts` — common fragment string constants used by the subscription files.
-- Compatibility surface: `src/definitions/mirrors.ts` now re-exports the assembled `Subscriptions`, `RequiredMirrors`, `TempSubscriptions`, and the fragment constants to preserve the original API.
-
-Packaging and what is published
---------------------------------
-- The npm package only ships the compiled build output. `package.json` lists `dist` and `dist-compat` in the `files` field, so the raw TypeScript source files under `src/` (including `src/definitions/subscriptions/*.ts`) are not included in the published package by default.
-- The TypeScript compiler emits JavaScript (to `dist`) and declaration files (`.d.ts`) when you run the build; those compiled artifacts are what go into the package.
-
-How to verify locally (PowerShell)
-----------------------------------
-1) Build the project:
-
-```powershell
-npm run build
-```
-
-2) Inspect the compiled `dist` tree to see the compiled outputs for the subscription modules:
-
-```powershell
-Get-ChildItem -Recurse .\dist | Select-Object FullName
-```
-
-3) See exactly what would be published (dry-run):
-
-```powershell
-npm pack --dry-run
-```
-
-If you want `.ts` sources included in the published package, add `src` to the `files` array in `package.json` or add a copy step that places sources in `dist`/`dist-compat` before publishing; then verify with `npm pack --dry-run`.
-
-## CI / GitHub Actions
-
-This repository includes a workflow that publishes the package to npm when changes are pushed to `main` and when a GitHub Release is published. The workflow expects a repository secret named `NPM_TOKEN` containing a valid npm automation token.
-
-To create and add the secret:
-1. Generate an npm token on https://www.npmjs.com/ under your account settings (Access Tokens -> Automation).
-2. In the GitHub repository, go to Settings → Secrets → Actions and add a new secret named `NPM_TOKEN` with the token value.
-
-The workflow builds both `dist` and `dist-compat` and then runs `npm publish --access public`. If you need to restrict publishing (for example, to skip on regular pushes), adjust the workflow triggers in `.github/workflows/publish.yml`.
-
-## License
-MIT
+# @nanolink/mirrors
+
+GraphQL subscription client + in‑memory mirror synchronization utilities. Optimized for incremental change streams that send START / UPDATED / DELETED / DONE / VERSION_ERROR frames.
+
+## Features
+* Lightweight `SubscriptionClient` around `graphql-ws` with explicit connect, controlled reconnect, and small event surface.
+* Dual version support in `MirrorSync` (`version` numeric + optional `opVersion` string) for hybrid sequence + causality ordering (either dimension can drive resync logic when present).
+* Stale delete & update guards: ignores events older in either version dimension to prevent resurrecting removed or outdated entities.
+* Efficient updates: UPDATED replaces item wholesale only when newer; no deep merge overhead.
+* Full sync cycle handling via START/DONE gates; `loaded` promise resolves after first DONE and re-arms on VERSION_ERROR.
+* Automatic resubscribe after reconnect using last known versions (no duplicate inserts).
+* Read‑only delegated map interface for consumers (prevents accidental mutation of internal state).
+* `Connection` helper manages multiple mirrors, re‑emitting namespaced events (`mirror:start`, `mirror:updated`, ...).
+* Proxy-aware WebSocket resolution: if proxy env vars are present (ALL_PROXY / HTTPS_PROXY / HTTP_PROXY / GLOBAL_AGENT_HTTP_PROXY) the client prefers the Node `ws` implementation; otherwise uses existing global WebSocket (browser / Node >=18) or falls back to `ws`.
+* Minimal dependencies; event system via `eventemitter3`.
+
+## Install
+```bash
+npm install @nanolink/mirrors
+```
+
+Optional (proxy via global-agent for generic HTTP(S) requests—WebSocket selection is still handled automatically as described):
+```js
+// enableProxy.js
+import 'global-agent/bootstrap';
+process.env.GLOBAL_AGENT_HTTP_PROXY = 'http://proxy:3128';
+```
+Run with:
+```bash
+node -r global-agent/bootstrap app.js
+```
+
+## Usage
+### What is a mirror?
+A mirror is an in-memory, read-only view of a server-side collection. The server sends GraphQL subscription frames with `START`, `UPDATED`, `DELETED`, `DONE`, and `VERSION_ERROR` messages; `MirrorSync` applies those messages to a local `Map` keyed by `id`.
+
+Each mirror tracks the latest cursor it has seen. Older subscriptions use numeric `version` / `deleteVersion`; newer subscriptions may use string `opVersion` / `deleteOpVersion`. `MirrorSync` supports both cursor styles and resubscribes from the latest known cursor after reconnect.
+
+`Connection` manages multiple named mirrors. It creates `MirrorSync` instances, stores them in `Connection.Mirrors`, and re-emits mirror events as `mirror:<event>` with the mirror name included.
+
+### Quick connection with a predefined mirror
+```ts
+import { Connection } from '@nanolink/mirrors';
+
+const conn = new Connection();
+
+conn.InitConnection('wss://api.example.com/ws', async () => ({
+  authToken: 'TOKEN',
+}));
+
+conn.on('connected', () => console.log('socket up'));
+conn.on('mirror:updated', e => console.log('updated', e.mirrorName, e.doc.id));
+
+conn.connect();
+
+async function main() {
+  const trackers = await conn.getPredefinedMirror('trackers');
+
+  console.log('Initial size', trackers.size);
+  for (const tracker of trackers.values()) {
+    console.log(tracker);
+  }
+}
+
+main();
+```
+
+### Custom mirror subscription
+```ts
+const users = await conn.getMirror('users', `
+    subscription Users($version: Long, $opVersion: String) {
+      users(version: $version, opVersion: $opVersion) {
+        type
+        total
+        deleteId
+        deleteVersion
+        deleteOpVersion
+        data { id version opVersion name }
+      }
+    }
+  `, {});
+
+console.log('Initial size', users.size);
+for (const user of users.values()) {
+  console.log(user);
+}
+```
+
+### Accessing the MirrorSync instance
+`getMirror()` and `getPredefinedMirror()` wait for the initial `DONE` frame and return a `ReadonlyMapView`. If you need mirror-specific events or stats, use `registerMirror()` directly.
+
+```ts
+const mirror = conn.registerMirror('users', usersSubscription, {});
+
+mirror.on('updated', e => console.log('user updated', e.doc.id));
+mirror.on('deleted', e => console.log('user deleted', e.orgDoc.id));
+
+const users = await mirror.load();
+console.log(mirror.stats(), users.size);
+```
+
+### Waiting for a specific mirror change
+Use `waitForUpdated()` or `waitForDeleted()` when a command or mutation must wait until the local mirror has observed the resulting server-side change. Create the wait promise before sending the command, then await it after the command completes.
+
+```ts
+const updated = mirror.waitForUpdated(referenceId);
+
+await saveReferenceMutation(referenceId);
+const { doc, orgDoc } = await updated;
+
+console.log('Mirror caught up', doc.id, orgDoc?.version, doc.version);
+```
+
+Both methods accept either an id or a predicate, and default to a 120 second timeout.
+
+```ts
+await mirror.waitForUpdated(
+  event => event.doc.externalIds?.some((id: any) => id.key === 'SAP_ID' && id.value === sapId),
+  { timeoutMs: 30_000 }
+);
+
+await mirror.waitForDeleted(referenceId);
+```
+
+### Numeric‑only subscriptions (most common)
+Most Nanolink GraphQL subscription fields expose only a numeric `version` and omit `opVersion`. `MirrorSync` handles this seamlessly: pass just `$version` in the query and the server responses won’t include `opVersion` / `deleteOpVersion` fields.
+
+```ts
+// Numeric-only example
+const products = await conn.getMirror('products', `
+  subscription Products($version: Long) {
+    products(version: $version) {
+      type
+      total
+      deleteId
+      deleteVersion
+      data { id version title }
+    }
+  }
+`, {});
+
+await products.loaded; // after first DONE
+console.log('Products count', products.size);
+```
+
+When `opVersion` fields are absent they are simply ignored; ordering & stale protections rely on numeric `version` only.
+
+### Direct low-level client
+```ts
+import { SubscriptionClient } from '@nanolink/mirrors';
+
+const sc = new SubscriptionClient();
+
+sc.InitClient({
+  url: 'wss://api.example.com/ws',
+  connectionParams: async () => ({ authToken: 'TOKEN' }),
+  maxReconnectAttempts: 10,
+});
+
+sc.connect();
+
+sc.on('connected', () => {
+  const dispose = sc.clientsubscribe({
+    query: 'subscription Ping { ping }'
+  }, {
+    next: (msg) => console.log(msg),
+    error: (e) => console.error('err', e),
+    complete: () => console.log('done')
+  });
+});
+```
+
+## Events
+`SubscriptionClient` emits:
+* connecting
+* connected (first successful connect)
+* reconnected (subsequent successful connect after a disconnect)
+* disconnected ({ code, reason, wasClean })
+* retry ({ attempt }) before a reconnect attempt delay
+* error (network/protocol)
+
+`Connection` re‑emits mirror events as `mirror:<event>` with payload `{ mirrorName, ... }`:
+* start
+* updated (only when a newer item actually replaced stored data)
+* deleted
+* done (end of full sync batch)
+* versionError (triggered resync)
+* resubscribe (automatic after reconnect)
+* error
+* removed (mirror explicitly removed)
+* cleared (mirror internal state cleared)
+
+## API Surface
+* `SubscriptionClient` – low level websocket subscription wrapper.
+* `MirrorSync` – single mirror controller (dual version tracking).
+* `Connection` – manages multiple named mirrors and re-emits namespaced mirror events.
+* `ReadonlyMapView` – read-only view returned by `getMirror()`, `getPredefinedMirror()`, and `MirrorSync.load()`.
+* `waitForUpdated()` / `waitForDeleted()` – wait until the mirror observes a specific future update or delete event.
+
+Note about mirror helpers
+-------------------------
+`getMirror()` is available for custom ad-hoc mirrors but is seldom used in most integrations. The more commonly used helper is `getPredefinedMirror()` which returns mirrors for known server-side definitions (IDs and field payload shapes) and avoids having to supply the raw GraphQL subscription yourself. Check `src/definitions` for available predefined mirror names and subscription fragments.
+
+## Notes
+* Always call `connect()` explicitly; no implicit lazy connect.
+* Call `InitConnection()` on `Connection`, or `InitClient()` on `SubscriptionClient`, before connecting.
+* VERSION_ERROR triggers automatic full resync (re-arms `loaded`).
+* First top-level field in GraphQL subscription payload is treated as the sync envelope.
+* Full sync updates are buffered until `DONE`, then swapped into the live mirror.
+* Provide `webSocketImpl` manually if bundling for environments without a global WebSocket and you do NOT want `ws` as fallback.
+* When proxy env vars are set in Node, `SubscriptionClient` prefers `ws` (allowing external agent configuration); browsers ignore these env vars.
+
+## Build & Publish
+TypeScript sources compile to `dist/`.
+
+Scripts:
+```bash
+npm run build       # compile
+npm run publish:dry # preview publish contents
+npm run release     # build + publish (public)
+```
+
+Developer notes (recent refactor)
+---------------------------------
+This repository recently split GraphQL subscription template literals into per-property modules to make maintenance easier:
+
+- Subscription templates: `src/definitions/subscriptions/*.ts` — one file per subscription property.
+- Shared fragments: `src/definitions/fragments.ts` — common fragment string constants used by the subscription files.
+- Compatibility surface: `src/definitions/mirrors.ts` now re-exports the assembled `Subscriptions`, `RequiredMirrors`, `TempSubscriptions`, and the fragment constants to preserve the original API.
+
+Packaging and what is published
+--------------------------------
+- The npm package only ships the compiled build output. `package.json` lists `dist` and `dist-compat` in the `files` field, so the raw TypeScript source files under `src/` (including `src/definitions/subscriptions/*.ts`) are not included in the published package by default.
+- The TypeScript compiler emits JavaScript (to `dist`) and declaration files (`.d.ts`) when you run the build; those compiled artifacts are what go into the package.
+
+How to verify locally (PowerShell)
+----------------------------------
+1) Build the project:
+
+```powershell
+npm run build
+```
+
+2) Inspect the compiled `dist` tree to see the compiled outputs for the subscription modules:
+
+```powershell
+Get-ChildItem -Recurse .\dist | Select-Object FullName
+```
+
+3) See exactly what would be published (dry-run):
+
+```powershell
+npm pack --dry-run
+```
+
+If you want `.ts` sources included in the published package, add `src` to the `files` array in `package.json` or add a copy step that places sources in `dist`/`dist-compat` before publishing; then verify with `npm pack --dry-run`.
+
+## CI / GitHub Actions
+
+This repository includes a workflow that publishes the package to npm when changes are pushed to `main` and when a GitHub Release is published. The workflow expects a repository secret named `NPM_TOKEN` containing a valid npm automation token.
+
+To create and add the secret:
+1. Generate an npm token on https://www.npmjs.com/ under your account settings (Access Tokens -> Automation).
+2. In the GitHub repository, go to Settings → Secrets → Actions and add a new secret named `NPM_TOKEN` with the token value.
+
+The workflow builds both `dist` and `dist-compat` and then runs `npm publish --access public`. If you need to restrict publishing (for example, to skip on regular pushes), adjust the workflow triggers in `.github/workflows/publish.yml`.
+
+## License
+MIT

package/dist/definitions/mirrors.d.ts

@@ -16,6 +16,7 @@ export declare const Subscriptions: {
     voltage: string;
     internalvoltage: string;
     unplug: string;
+    alarm: string;
     temperature: string;
     temperaturedecimal: string;
     humiditydecimal: string;

package/dist/definitions/mirrors.js

@@ -56,6 +56,7 @@ exports.Subscriptions = {
     voltage: subs.voltage,
     internalvoltage: subs.internalvoltage,
     unplug: subs.unplug,
+    alarm: subs.alarm,
     temperature: subs.temperature,
     temperaturedecimal: subs.temperaturedecimal,
     humiditydecimal: subs.humiditydecimal,

package/dist/definitions/mirrors.js.map

@@ -1 +1 @@
-{"version":3,"file":"mirrors.js","sourceRoot":"","sources":["../../src/definitions/mirrors.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,sDAAuC;AACvC,gEAAiD;AACjD,6DAA8C;AAC9C,gEAAiD;AAEpC,QAAA,aAAa,GAAG;IAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;IAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;IACvB,MAAM,EAAE,IAAI,CAAC,MAAM;IACnB,YAAY,EAAE,IAAI,CAAC,YAAY;IAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;IAC/B,cAAc,EAAE,IAAI,CAAC,cAAc;IACnC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;IACvC,OAAO,EAAE,IAAI,CAAC,OAAO;IACrB,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,MAAM,EAAE,IAAI,CAAC,MAAM;IACnB,eAAe,EAAE,IAAI,CAAC,eAAe;IACrC,GAAG,EAAE,IAAI,CAAC,GAAG;IACb,aAAa,EAAE,IAAI,CAAC,aAAa;IACjC,SAAS,EAAE,IAAI,CAAC,SAAS;IACzB,OAAO,EAAE,IAAI,CAAC,OAAO;IACrB,eAAe,EAAE,IAAI,CAAC,eAAe;IACrC,MAAM,EAAE,IAAI,CAAC,MAAM;IACnB,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;IAC3C,eAAe,EAAE,IAAI,CAAC,eAAe;IACrC,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;IACrD,aAAa,EAAE,IAAI,CAAC,aAAa;IACjC,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;IAC3C,cAAc,EAAE,IAAI,CAAC,cAAc;IACnC,YAAY,EAAE,IAAI,CAAC,YAAY;IAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;IAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;IAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;IACzC,KAAK,EAAE,IAAI,CAAC,KAAK;IACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;IACvB,KAAK,EAAE,IAAI,CAAC,KAAK;IACjB,aAAa,EAAE,IAAI,CAAC,aAAa;CAClC,CAAA;AAEY,QAAA,eAAe,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;IAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;IAC7B,MAAM,EAAE,MAAM,CAAC,KAAK;CACrB,CAAA;AAEY,QAAA,eAAe,GAAG;IAC7B,cAAc,EAAE,GAAG,CAAC,cAAc;IAClC,QAAQ,EAAE,GAAG,CAAC,QAAQ;IACtB,KAAK,EAAE,GAAG,CAAC,KAAK;CACjB,CAAA;AAEY,QAAA,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAA"}
+{"version":3,"file":"mirrors.js","sourceRoot":"","sources":["../../src/definitions/mirrors.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,sDAAuC;AACvC,gEAAiD;AACjD,6DAA8C;AAC9C,gEAAiD;AAEpC,QAAA,aAAa,GAAG;IAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;IAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;IACvB,MAAM,EAAE,IAAI,CAAC,MAAM;IACnB,YAAY,EAAE,IAAI,CAAC,YAAY;IAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;IAC/B,cAAc,EAAE,IAAI,CAAC,cAAc;IACnC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;IACvC,OAAO,EAAE,IAAI,CAAC,OAAO;IACrB,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,MAAM,EAAE,IAAI,CAAC,MAAM;IACnB,eAAe,EAAE,IAAI,CAAC,eAAe;IACrC,GAAG,EAAE,IAAI,CAAC,GAAG;IACb,aAAa,EAAE,IAAI,CAAC,aAAa;IACjC,SAAS,EAAE,IAAI,CAAC,SAAS;IACzB,OAAO,EAAE,IAAI,CAAC,OAAO;IACrB,eAAe,EAAE,IAAI,CAAC,eAAe;IACrC,MAAM,EAAE,IAAI,CAAC,MAAM;IACnB,KAAK,EAAE,IAAI,CAAC,KAAK;IACjB,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;IAC3C,eAAe,EAAE,IAAI,CAAC,eAAe;IACrC,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;IACrD,aAAa,EAAE,IAAI,CAAC,aAAa;IACjC,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;IAC3C,cAAc,EAAE,IAAI,CAAC,cAAc;IACnC,YAAY,EAAE,IAAI,CAAC,YAAY;IAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;IAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;IAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;IACzC,KAAK,EAAE,IAAI,CAAC,KAAK;IACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;IACvB,KAAK,EAAE,IAAI,CAAC,KAAK;IACjB,aAAa,EAAE,IAAI,CAAC,aAAa;CAClC,CAAA;AAEY,QAAA,eAAe,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;IAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;IAC7B,MAAM,EAAE,MAAM,CAAC,KAAK;CACrB,CAAA;AAEY,QAAA,eAAe,GAAG;IAC7B,cAAc,EAAE,GAAG,CAAC,cAAc;IAClC,QAAQ,EAAE,GAAG,CAAC,QAAQ;IACtB,KAAK,EAAE,GAAG,CAAC,KAAK;CACjB,CAAA;AAEY,QAAA,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAA"}

package/dist/definitions/opsubscriptions/contained.js

@@ -1,17 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.contained = void 0;
-exports.contained = `subscription contained($opVersion: String) {
-  contained(opversion: $opVersion) {
-    type
-    data {
-      id
-      receiverId
-      start
-      deleted
-      opVersion
-    }
-    deleteId
-  }
+exports.contained = `subscription contained($opVersion: String) {
+  contained(opversion: $opVersion) {
+    type
+    data {
+      id
+      receiverId
+      start
+      deleted
+      opVersion
+    }
+    deleteId
+  }
 }`;
 //# sourceMappingURL=contained.js.map