@tomorrowos/sdk 1.1.5 → 1.1.7

package/dist/index.d.ts

@@ -3,8 +3,12 @@ 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 { parseScreenReferences, policyWithScreenReferences, ScreenReferenceStore } from "./screen-references.js";
+export type { ScreenReferenceHost, ScreenReferences } from "./screen-references.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,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACpF,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,8 @@ 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 { parseScreenReferences, policyWithScreenReferences, ScreenReferenceStore } from "./screen-references.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-references.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Per-screen key/value references.
+ *
+ * Stored in screen-references.json beside the database. Each setPolicy for a
+ * screen includes that screen's references. The shared playlist is unchanged.
+ * The default CMS panel does not edit these; a product UI calls the HTTP routes.
+ */
+import type { IncomingMessage, ServerResponse } from "http";
+export type ScreenReferences = Record<string, string>;
+export interface ScreenReferenceHost {
+    pushLatestPolicyToDevice(deviceId: string): Promise<{
+        pushed: boolean;
+    }>;
+}
+export declare function parseScreenReferences(raw: unknown): ScreenReferences;
+/** Copy a policy and add this screen's references. Does not mutate the input. */
+export declare function policyWithScreenReferences(policy: unknown, references: ScreenReferences): unknown;
+export declare class ScreenReferenceStore {
+    private readonly filePath;
+    constructor(filePath: string);
+    get(deviceId: string): Promise<ScreenReferences>;
+    all(): Promise<Record<string, ScreenReferences>>;
+    replace(deviceId: string, references: ScreenReferences): Promise<ScreenReferences>;
+    removeKey(deviceId: string, key: string): Promise<ScreenReferences>;
+    deleteDevice(deviceId: string): Promise<void>;
+    private read;
+    private write;
+}
+export interface ScreenReferenceHttpDeps {
+    host: ScreenReferenceHost;
+    store: {
+        getPairedDevice(deviceId: string): Promise<unknown>;
+    };
+    references: ScreenReferenceStore;
+}
+export declare function handleScreenReferenceHttp(req: IncomingMessage, res: ServerResponse, deps: ScreenReferenceHttpDeps): Promise<boolean>;
+//# sourceMappingURL=screen-references.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"screen-references.d.ts","sourceRoot":"","sources":["../src/screen-references.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAO5D,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAMtD,MAAM,WAAW,mBAAmB;IAClC,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC1E;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CA0BpE;AAED,iFAAiF;AACjF,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAMT;AAED,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAEvC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKhD,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAShD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQlF,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUnE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAOrC,IAAI;YAuBJ,KAAK;CAMpB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE;QAAE,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;IAC/D,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAyDD,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,OAAO,CAAC,CA4DlB"}

package/dist/screen-references.js

@@ -0,0 +1,228 @@
+/**
+ * Per-screen key/value references.
+ *
+ * Stored in screen-references.json beside the database. Each setPolicy for a
+ * screen includes that screen's references. The shared playlist is unchanged.
+ * The default CMS panel does not edit these; a product UI calls the HTTP routes.
+ */
+import { mkdir, readFile, rename, writeFile } from "fs/promises";
+import { dirname } from "path";
+const KEY_PATTERN = /^[A-Za-z][A-Za-z0-9_]{0,63}$/;
+const MAX_KEYS = 32;
+const MAX_VALUE_LENGTH = 500;
+export function parseScreenReferences(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new Error("references must be an object of string values");
+    }
+    const entries = Object.entries(raw);
+    if (entries.length > MAX_KEYS) {
+        throw new Error(`At most ${MAX_KEYS} references`);
+    }
+    const out = {};
+    for (const [key, value] of entries) {
+        const name = key.trim();
+        if (!KEY_PATTERN.test(name)) {
+            throw new Error(`Invalid reference key “${key}”. Use a letter, then letters, numbers, or underscores.`);
+        }
+        if (typeof value !== "string") {
+            throw new Error(`Reference “${name}” must be a string`);
+        }
+        const text = value.trim();
+        if (!text || text.length > MAX_VALUE_LENGTH) {
+            throw new Error(`Reference “${name}” must be 1–${MAX_VALUE_LENGTH} characters`);
+        }
+        out[name] = text;
+    }
+    return out;
+}
+/** Copy a policy and add this screen's references. Does not mutate the input. */
+export function policyWithScreenReferences(policy, references) {
+    if (!policy || typeof policy !== "object" || Array.isArray(policy))
+        return policy;
+    return {
+        ...policy,
+        references: { ...references }
+    };
+}
+export class ScreenReferenceStore {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    async get(deviceId) {
+        const file = await this.read();
+        return { ...(file.devices[deviceId] ?? {}) };
+    }
+    async all() {
+        const file = await this.read();
+        const out = {};
+        for (const [deviceId, references] of Object.entries(file.devices)) {
+            out[deviceId] = { ...references };
+        }
+        return out;
+    }
+    async replace(deviceId, references) {
+        const file = await this.read();
+        if (Object.keys(references).length === 0)
+            delete file.devices[deviceId];
+        else
+            file.devices[deviceId] = references;
+        await this.write(file);
+        return { ...references };
+    }
+    async removeKey(deviceId, key) {
+        const file = await this.read();
+        const current = { ...(file.devices[deviceId] ?? {}) };
+        delete current[key];
+        if (Object.keys(current).length === 0)
+            delete file.devices[deviceId];
+        else
+            file.devices[deviceId] = current;
+        await this.write(file);
+        return current;
+    }
+    async deleteDevice(deviceId) {
+        const file = await this.read();
+        if (!file.devices[deviceId])
+            return;
+        delete file.devices[deviceId];
+        await this.write(file);
+    }
+    async read() {
+        try {
+            const raw = JSON.parse(await readFile(this.filePath, "utf8"));
+            const devices = {};
+            if (raw?.devices && typeof raw.devices === "object") {
+                for (const [deviceId, references] of Object.entries(raw.devices)) {
+                    try {
+                        devices[deviceId] = parseScreenReferences(references);
+                    }
+                    catch {
+                        devices[deviceId] = {};
+                    }
+                }
+            }
+            return { devices };
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === "ENOENT")
+                return { devices: {} };
+            throw err;
+        }
+    }
+    async write(file) {
+        await mkdir(dirname(this.filePath), { recursive: true });
+        const tmp = `${this.filePath}.${process.pid}.tmp`;
+        await writeFile(tmp, JSON.stringify(file, null, 2), "utf8");
+        await rename(tmp, this.filePath);
+    }
+}
+function sendJson(res, status, body) {
+    res.writeHead(status, {
+        "Content-Type": "application/json; charset=utf-8",
+        "Cache-Control": "no-store"
+    });
+    res.end(JSON.stringify(body));
+}
+function pathnameOf(req) {
+    const url = new URL(req.url || "/", "http://localhost");
+    let pathname = url.pathname || "/";
+    if (pathname.length > 1 && pathname.endsWith("/"))
+        pathname = pathname.slice(0, -1);
+    return pathname;
+}
+async function readJson(req) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of req) {
+        const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        size += buf.length;
+        if (size > 1_000_000)
+            throw new Error("Body too large");
+        chunks.push(buf);
+    }
+    if (chunks.length === 0)
+        return {};
+    const parsed = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("JSON object required");
+    }
+    return parsed;
+}
+async function requirePaired(deps, deviceId, res) {
+    const paired = await deps.store.getPairedDevice(deviceId);
+    if (paired)
+        return true;
+    sendJson(res, 404, { status: "failed", error: "Device not found" });
+    return false;
+}
+async function pushReferences(deps, deviceId) {
+    try {
+        const result = await deps.host.pushLatestPolicyToDevice(deviceId);
+        return result.pushed;
+    }
+    catch {
+        return false;
+    }
+}
+export async function handleScreenReferenceHttp(req, res, deps) {
+    const method = String(req.method || "GET").toUpperCase();
+    const pathname = pathnameOf(req);
+    if (method === "GET" && pathname === "/screen-references") {
+        sendJson(res, 200, {
+            status: "success",
+            referencesByDevice: await deps.references.all()
+        });
+        return true;
+    }
+    const collection = /^\/device\/([^/]+)\/references$/.exec(pathname);
+    if (collection && method === "GET") {
+        const deviceId = decodeURIComponent(collection[1]);
+        if (!(await requirePaired(deps, deviceId, res)))
+            return true;
+        sendJson(res, 200, {
+            status: "success",
+            deviceId,
+            references: await deps.references.get(deviceId)
+        });
+        return true;
+    }
+    if (collection && method === "PUT") {
+        const deviceId = decodeURIComponent(collection[1]);
+        if (!(await requirePaired(deps, deviceId, res)))
+            return true;
+        let references;
+        try {
+            const body = await readJson(req);
+            references = parseScreenReferences(body.references);
+        }
+        catch (err) {
+            sendJson(res, 400, {
+                status: "failed",
+                error: err instanceof Error ? err.message : "Invalid references"
+            });
+            return true;
+        }
+        const saved = await deps.references.replace(deviceId, references);
+        const pushed = await pushReferences(deps, deviceId);
+        sendJson(res, 200, { status: "success", deviceId, references: saved, pushed });
+        return true;
+    }
+    const oneKey = /^\/device\/([^/]+)\/references\/([^/]+)$/.exec(pathname);
+    if (oneKey && method === "DELETE") {
+        const deviceId = decodeURIComponent(oneKey[1]);
+        const key = decodeURIComponent(oneKey[2]);
+        if (!KEY_PATTERN.test(key)) {
+            sendJson(res, 400, { status: "failed", error: "Invalid reference key" });
+            return true;
+        }
+        if (!(await requirePaired(deps, deviceId, res)))
+            return true;
+        const references = await deps.references.removeKey(deviceId, key);
+        const pushed = await pushReferences(deps, deviceId);
+        sendJson(res, 200, { status: "success", deviceId, references, pushed });
+        return true;
+    }
+    return false;
+}

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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"}