@tomorrowos/sdk 1.1.4 → 1.1.6

package/PLAYER_INSTALL.md

@@ -18,7 +18,7 @@ This guide covers the full path from a verified player package to a paired scree
 
 - A running TomorrowOS CMS (Replit, Vercel, Railway, or self-hosted)
 - A CMS URL the **panel** can reach (public HTTPS in production, or a tunnel / LAN IP for lab tests)
-- A supported panel: **Samsung Tizen 6.5 and 7.0** or **BrightSign Series 3-6**
+- A supported panel: **Samsung Tizen 6.5 and 7.0**, **BrightSign Series 3-6**, or **Windows 11 Pro x64** (Windows Player V1)
 
 ---
 
@@ -28,6 +28,7 @@ This guide covers the full path from a verified player package to a paired scree
 | --- | --- |
 | **Samsung** | Install on a Samsung Tizen player via **Custom App** (`https://tmr.sh/tizen`), or download the player from the CMS and install it via USB. |
 | **BrightSign** | Download the ZIP package from the CMS with `config.js` configured so that `cmsEndpoint` points to your CMS origin and install it via SD card. |
+| **Windows** | Download **Windows Player V1** (`TomorrowOS-Windows-Setup.exe`) and run the installer on **Windows 11 Pro x64**. |
 
 ### Samsung (recommended path)
 
@@ -54,7 +55,21 @@ After install, enter your CMS URL on the on-device setup screen.
 1. Control Panel → **Download Players → BrightSign** (`GET /players/brightsign.zip`).
 2. That zip already has `cmsEndpoint` pointed at **this** CMS origin — usually you only confirm `orientation`.
 
-Caption in the Control Panel today: **Tizen 6.5 and 7.0**, **BrightSign Series 3-6**. 
+### Windows
+
+**Windows 11 Pro x64** — Windows Player V1. Download the installer from either:
+
+- `https://tmr.sh/app/windows/TomorrowOS-Windows-Setup.exe`, **or**
+- Control Panel → **Download Players → Windows**
+
+Then install:
+
+1. Run `TomorrowOS-Windows-Setup.exe`.
+2. In the wizard, set the CMS endpoint, orientation, display, and maintenance passcode.
+3. Finish the wizard and launch the player.
+4. The screen shows a six-character pairing code. Enter it in the Control Panel to pair.
+
+Caption in the Control Panel today: **Tizen 6.5 and 7.0**, **BrightSign Series 3-6**, **Windows 11 Pro x64**. 
 
 ---
 
@@ -144,6 +159,18 @@ When you download via the CMS, `cmsEndpoint` is **filled automatically** with th
 9. Wait through the initial black window (~10 seconds before `Show()` is normal).
 10. Confirm the pairing / brand UI appears.
 
+### Windows
+
+**Windows 11 Pro x64** — Windows Player V1.
+
+1. Download the installer from either:
+   - `https://tmr.sh/app/windows/TomorrowOS-Windows-Setup.exe`, **or**
+   - Control Panel → **Download Players → Windows**
+2. Run `TomorrowOS-Windows-Setup.exe`.
+3. In the wizard, set the CMS endpoint, orientation, display, and maintenance passcode.
+4. Finish the wizard and launch the player.
+5. The screen shows a six-character pairing code. Enter it in the Control Panel to pair.
+
 ---
 
 ## 4. Six-character pairing
@@ -191,7 +218,7 @@ Always record **model + firmware** from `device.info.get` before calling a fleet
 
 ### Not shipping yet
 
-LG webOS, Android, and Windows players are not in this SDK release.
+LG webOS and Android players are not in this SDK release.
 
 ---
 
@@ -225,6 +252,7 @@ await tomorrowos.pairing.unpair(deviceId);
 2. Point the player at the **new** CMS endpoint:
    - Tizen: re-enter CMS URL on the setup screen (clear / change stored URL if needed, then reboot).
    - BrightSign: download a new zip from the **new** CMS (or edit `config.js` `cmsEndpoint`), copy to SD, power-cycle.
+   - Windows: re-run `TomorrowOS-Windows-Setup.exe` and set the new CMS endpoint, then launch the player.
 3. Pair on the new CMS with the on-screen code.
 
 ---
@@ -245,7 +273,7 @@ await tomorrowos.pairing.unpair(deviceId);
 
 ## Coming soon
 
-LG webOS, Android, and Windows apps.
+LG webOS and Android players.
 
 ---
 

package/README.md

@@ -106,9 +106,9 @@ Player install and pairing: `PLAYER_INSTALL.md`. Deep hosting and agent protocol
 | Samsung Tizen 6.5 and 7.0 | Supported | Certified models and firmware only |
 | BrightSign Series 3-6 | Supported | Series 3 requires firmware **9.1.140+** |
 | BrightSign Series 3 4K H.264 | Not supported | Use certified **1080p H.264** media |
+| Windows 11 Pro x64 | Supported | None |
 | Android | Planned | Not available for production |
 | LG webOS | Planned | Not available for production |
-| Windows | Planned | Not available for production |
 
 Treat a combination as production-ready only after you validate it on your panels.
 

package/dist/index.d.ts

@@ -3,8 +3,10 @@ export type { DeviceListItem, DeviceScreenshotInfo, ListenOptions, TomorrowOSBra
 export type { ConnectorState, ConnectorStatus, ServerStatusReport, StatusBlocker } from "./server-status.js";
 export { buildServerStatus } from "./server-status.js";
 export { getSdkPackageVersion } from "./sdk-version.js";
-export type { DeviceOnOffTimer, DevicePlaylistAssignment, DeviceRegistryRecord, PairedDeviceRecord, PendingCodeEntry, PendingCodeRecord, DeviceRegistryEntry, PlaylistItemRecord, PlaylistSchedule, PublishedPlaylistSnapshot, StoredPlaylist, TomorrowOSDataSnapshot, TomorrowOSMigratableStore, TomorrowOSStore } from "./store/types.js";
+export type { DeviceOnOffTimer, DevicePlaylistAssignment, DeviceRegistryRecord, PairedDeviceRecord, PendingCodeEntry, PendingCodeRecord, DeviceRegistryEntry, PlaylistItemRecord, PlaylistItemSchedule, PlaylistItemTagRule, PlaylistSchedule, PublishedPlaylistSnapshot, StoredPlaylist, TomorrowOSDataSnapshot, TomorrowOSMigratableStore, TomorrowOSStore } from "./store/types.js";
 export { PlaylistCatalog } from "./playlist-catalog.js";
+export { filterPolicyForScreen, itemMatchesScreen, itemScheduleActive, parseItemSchedule, parseTagRule, ScreenTagStore } from "./screen-tags.js";
+export type { ItemSchedule, ScreenTagHost, ScreenTagHttpDeps, TagRule, TagRuleOp } from "./screen-tags.js";
 export type { BuiltDevicePolicy, SavePlaylistInput } from "./playlist-catalog.js";
 export { DEFAULT_PAIRING_CODE_SECRET, generateDeterministicPairingCode, generateRandomPairingCode, isValidPairingCodeFormat, normalizePairingCode, PAIRING_CODE_ALPHABET, PAIRING_CODE_LENGTH, resolvePairingCodeSecret } from "./pairing-code.js";
 export { MemoryStore } from "./store/memory-store.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,YAAY,EACV,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,EAChC,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,YAAY,EACV,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,OAAO,EACP,SAAS,EACV,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,EAChC,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -2,6 +2,7 @@ export { TomorrowOS } from "./tomorrowos.js";
 export { buildServerStatus } from "./server-status.js";
 export { getSdkPackageVersion } from "./sdk-version.js";
 export { PlaylistCatalog } from "./playlist-catalog.js";
+export { filterPolicyForScreen, itemMatchesScreen, itemScheduleActive, parseItemSchedule, parseTagRule, ScreenTagStore } from "./screen-tags.js";
 export { DEFAULT_PAIRING_CODE_SECRET, generateDeterministicPairingCode, generateRandomPairingCode, isValidPairingCodeFormat, normalizePairingCode, PAIRING_CODE_ALPHABET, PAIRING_CODE_LENGTH, resolvePairingCodeSecret } from "./pairing-code.js";
 export { MemoryStore } from "./store/memory-store.js";
 export { PostgresStore } from "./store/postgres-store.js";

package/dist/playlist-catalog.d.ts

@@ -29,6 +29,11 @@ export declare class PlaylistCatalog {
     removePlaylistFromDevice(deviceId: string, playlistId: string): Promise<BuiltDevicePolicy>;
     /** Remove every playlist assignment from a device (CMS catalog + empty policy). */
     clearAllAssignmentsFromDevice(deviceId: string): Promise<BuiltDevicePolicy>;
+    /**
+     * A retired playlist stays only while some device still has its published snapshot.
+     * Clear (or removing it from the last screen) drops that snapshot, so the row goes too.
+     */
+    private deleteRetiredPlaylistsWithoutAssignments;
     /**
      * If the device has this playlist assigned, refresh its snapshot to latest
      * and return a rebuilt snapshot policy for immediate push.

package/dist/playlist-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playlist-catalog.d.ts","sourceRoot":"","sources":["../src/playlist-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE;QACN,SAAS,EAAE,yBAAyB,EAAE,CAAC;QACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;KAClC,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAyDD,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAE7C,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAK1C,6BAA6B,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAI5D,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IA8B/D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAcnD,oBAAoB,CACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAIhC,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;IAiEvB,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAO7B,mFAAmF;IAC7E,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKjF;;;OAGG;IACG,+BAA+B,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAC;IA4BrD,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;YAKf,0BAA0B;IA+BxC,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGpE"}
+{"version":3,"file":"playlist-catalog.d.ts","sourceRoot":"","sources":["../src/playlist-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE;QACN,SAAS,EAAE,yBAAyB,EAAE,CAAC;QACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;KAClC,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAyDD,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAE7C,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAK1C,6BAA6B,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAI5D,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IA8B/D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAkBnD,oBAAoB,CACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAIhC,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;IAiEvB,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAQ7B,mFAAmF;IAC7E,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IASjF;;;OAGG;YACW,wCAAwC;IAStD;;;OAGG;IACG,+BAA+B,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAC;IA4BrD,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;YAKf,0BAA0B;IA+BxC,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGpE"}

package/dist/playlist-catalog.js

@@ -100,7 +100,11 @@ export class PlaylistCatalog {
             retired: true,
             retiredAt: new Date().toISOString()
         };
-        await this.store.setPlaylist(record);
+        if (await this.store.isPlaylistAssigned(id)) {
+            await this.store.setPlaylist(record);
+            return record;
+        }
+        await this.store.deletePlaylist(id);
         return record;
     }
     async getDeviceAssignments(deviceId) {
@@ -161,13 +165,30 @@ export class PlaylistCatalog {
         const assignments = await this.store.getDeviceAssignments(deviceId);
         const next = assignments.filter((a) => a.playlistId !== playlistId);
         await this.store.setDeviceAssignments(deviceId, next);
+        await this.deleteRetiredPlaylistsWithoutAssignments([playlistId]);
         return this.buildPolicyFromAssignments(next, { useLatest: false });
     }
     /** Remove every playlist assignment from a device (CMS catalog + empty policy). */
     async clearAllAssignmentsFromDevice(deviceId) {
+        const removedIds = (await this.store.getDeviceAssignments(deviceId)).map((assignment) => assignment.playlistId);
         await this.store.setDeviceAssignments(deviceId, []);
+        await this.deleteRetiredPlaylistsWithoutAssignments(removedIds);
         return this.buildPolicyFromAssignments([], { useLatest: false });
     }
+    /**
+     * A retired playlist stays only while some device still has its published snapshot.
+     * Clear (or removing it from the last screen) drops that snapshot, so the row goes too.
+     */
+    async deleteRetiredPlaylistsWithoutAssignments(playlistIds) {
+        for (const playlistId of new Set(playlistIds)) {
+            const playlist = await this.store.getPlaylist(playlistId);
+            if (!playlist?.retired)
+                continue;
+            if (await this.store.isPlaylistAssigned(playlistId))
+                continue;
+            await this.store.deletePlaylist(playlistId);
+        }
+    }
     /**
      * If the device has this playlist assigned, refresh its snapshot to latest
      * and return a rebuilt snapshot policy for immediate push.

package/dist/screen-tags.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Screen tags and per-item schedules.
+ *
+ * Screens store tags. Each playlist item may store a tagRule and a schedule.
+ * When a policy is pushed, items that do not match that screen right now are
+ * removed. Items with no rule play on every screen. Items with no schedule
+ * play all the time. tagRule and schedule are stripped before the player sees
+ * the policy.
+ *
+ * Screen tags live in screen-tags.json beside the SQLite database (or
+ * data/screen-tags.json). Playlist item rules ride along in items JSON.
+ */
+import type { IncomingMessage, ServerResponse } from "http";
+import type { TomorrowOSStore } from "./store/types.js";
+export interface ScreenTagHost {
+    listDevices(): Promise<Array<{
+        deviceId: string;
+        deviceName?: string | null;
+        connected: boolean;
+    }>>;
+    pushLatestPolicyToDevice(deviceId: string): Promise<{
+        pushed: boolean;
+    }>;
+    playlists: {
+        buildPolicyForDevice(deviceId: string, options: {
+            useLatest?: boolean;
+        }): Promise<{
+            policy: unknown;
+        }>;
+    };
+}
+export type TagRuleOp = "any" | "all" | "notAny" | "notAll";
+export interface TagRule {
+    op: TagRuleOp;
+    tags: string[];
+}
+export declare function normalizeTag(raw: unknown): string | null;
+export declare function normalizeTagList(raw: unknown): string[];
+/**
+ * Monday = 0 … Sunday = 6.
+ * [true, true, true, true, true, false, false] is Mon–Fri and does not play Sat or Sun.
+ * [false, false, false, false, false, true, true] is Sat and Sun.
+ */
+export declare function weekdayIndexMondayFirst(date: Date): number;
+export interface ItemSchedule {
+    startDate?: string;
+    endDate?: string;
+    startTime?: string;
+    endTime?: string;
+    days?: boolean[];
+}
+/** Missing or empty schedule means the item plays all the time. */
+export declare function parseItemSchedule(raw: unknown): ItemSchedule | null;
+/**
+ * `now` is interpreted in its local timezone. End times are exclusive.
+ * A window whose end is earlier than its start continues past midnight,
+ * and that tail still belongs to the day the window started.
+ */
+export declare function itemScheduleActive(raw: unknown, now?: Date): boolean;
+/** Missing, empty, or invalid rules mean the item plays on every screen. */
+export declare function parseTagRule(raw: unknown): TagRule | null;
+export declare function itemMatchesScreen(screenTags: readonly string[], item: unknown, now?: Date): boolean;
+/** Returns a new policy. Does not mutate the SDK snapshot objects. */
+export declare function filterPolicyForScreen(policy: unknown, screenTags: readonly string[], now?: Date): unknown;
+/**
+ * Re-push a screen when a schedule window opens or closes.
+ * Current players ignore item schedules, so the CMS removes inactive items
+ * before the policy is sent. The check uses this computer's local clock.
+ */
+export declare function startItemScheduleRefresher(deps: ScreenTagHttpDeps): void;
+export declare class ScreenTagStore {
+    private readonly filePath;
+    private chain;
+    constructor(filePath: string);
+    get(deviceId: string): Promise<string[]>;
+    all(): Promise<Record<string, string[]>>;
+    catalog(): Promise<string[]>;
+    remember(tag: string): Promise<string[]>;
+    rename(from: string, to: string): Promise<string[]>;
+    forget(tag: string): Promise<void>;
+    add(deviceId: string, tag: string): Promise<string[]>;
+    remove(deviceId: string, tag: string): Promise<string[]>;
+    deleteDevice(deviceId: string): Promise<void>;
+    private rememberOn;
+    private enqueue;
+    private read;
+    private write;
+}
+export interface ScreenTagHttpDeps {
+    host: ScreenTagHost;
+    store: TomorrowOSStore;
+    tags: ScreenTagStore;
+}
+export declare function handleScreenTagHttp(req: IncomingMessage, res: ServerResponse, deps: ScreenTagHttpDeps): Promise<boolean>;
+//# sourceMappingURL=screen-tags.d.ts.map

package/dist/screen-tags.d.ts.map

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