bruce-models 7.1.44 → 7.1.45

package/dist/lib/server/record-change-feed.js

@@ -0,0 +1,332 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecordChangeFeed = void 0;
+const account_concept_1 = require("../account/account-concept");
+const api_1 = require("../api/api");
+/**
+ * Handles change events from Bruce API for various concepts.
+ * Apps/utils can subscribe to specific concept changes, eg: N Entity was updated so we should reload a panel.
+ */
+var RecordChangeFeed;
+(function (RecordChangeFeed) {
+    const VALID_ACTIONS = ["C", "U", "D"];
+    const ENTITY_CONCEPT = account_concept_1.AccountConcept.EConcept.ENTITY;
+    const getTopicEnvPrefix = (env) => {
+        if (env === api_1.Api.EEnv.DEV) {
+            return "D";
+        }
+        if (env === api_1.Api.EEnv.UAT) {
+            return "U";
+        }
+        return "P";
+    };
+    const isValidAction = (value) => {
+        return VALID_ACTIONS.includes(value);
+    };
+    /**
+     * Parses a raw broker message into a typed record-change event.
+     * Returns null if the message does not conform to the record-change format.
+     */
+    RecordChangeFeed.parseEvent = (message) => {
+        if (!(message === null || message === void 0 ? void 0 : message.event) || typeof message.event !== "string") {
+            return null;
+        }
+        const parts = message.event.split(".");
+        if (parts.length !== 2) {
+            return null;
+        }
+        const [conceptCode, actionCode] = parts;
+        if (!conceptCode || !actionCode || !isValidAction(actionCode)) {
+            return null;
+        }
+        return {
+            topic: message.topic,
+            concept: conceptCode.toLowerCase(),
+            action: actionCode,
+            data: message.data,
+            user: message.user,
+            message
+        };
+    };
+    /**
+     * Returns true if the given Entity internal ID falls within the reported range string.
+     *
+     * @example
+     * isEntityInternalIdInRangeString("100-200,305,400-450", 150) // true
+     * isEntityInternalIdInRangeString("100-200,305,400-450", 301) // false
+     */
+    RecordChangeFeed.isEntityInternalIdInRangeString = (rangeString, entityInternalId) => {
+        if (!rangeString || !Number.isInteger(entityInternalId)) {
+            return false;
+        }
+        for (const part of rangeString.split(",")) {
+            const token = part.trim();
+            if (!token) {
+                continue;
+            }
+            const [startText, endText] = token.split("-");
+            const start = Number(startText);
+            const end = endText === undefined ? start : Number(endText);
+            if (!Number.isInteger(start) || !Number.isInteger(end)) {
+                continue;
+            }
+            const min = Math.min(start, end);
+            const max = Math.max(start, end);
+            if (entityInternalId >= min && entityInternalId <= max) {
+                return true;
+            }
+        }
+        return false;
+    };
+    /**
+     * Returns true if the given record ID appears in a comma-separated list string.
+     *
+     * @example
+     * isRecordIdInListString("abc,def,ghi", "def") // true
+     * isRecordIdInListString("abc,def,ghi", "xyz") // false
+     */
+    RecordChangeFeed.isRecordIdInListString = (listString, recordId) => {
+        const normalizedId = String(recordId !== null && recordId !== void 0 ? recordId : "").trim();
+        if (!listString || !normalizedId) {
+            return false;
+        }
+        for (const part of listString.split(",")) {
+            if (part.trim() === normalizedId) {
+                return true;
+            }
+        }
+        return false;
+    };
+    /**
+     * Returns the set of {@link Api.ECacheKey} namespaces that should be
+     * invalidated when a record-change event arrives for the given concept.
+     *
+     * A concept can map to multiple cache namespaces (e.g. a tileset change
+     * also invalidates the publish-tileset and tileset-access caches).
+     */
+    RecordChangeFeed.getConceptCacheKeys = (concept) => {
+        switch (concept) {
+            case account_concept_1.AccountConcept.EConcept.ASSEMBLY:
+                return [api_1.Api.ECacheKey.Assembly];
+            case account_concept_1.AccountConcept.EConcept.ATTACHMENT_TYPE:
+                return [api_1.Api.ECacheKey.AttachmentType];
+            case account_concept_1.AccountConcept.EConcept.CLIENT_FILE:
+                return [
+                    api_1.Api.ECacheKey.ClientFile,
+                    api_1.Api.ECacheKey.ClientFileCountsPurpose,
+                    api_1.Api.ECacheKey.ClientFileCountsExtension,
+                    api_1.Api.ECacheKey.ClientFileCountsMIMEType,
+                    api_1.Api.ECacheKey.ClientFileCountsUser
+                ];
+            case account_concept_1.AccountConcept.EConcept.CUSTOM_FORM:
+                return [api_1.Api.ECacheKey.CustomForm];
+            case account_concept_1.AccountConcept.EConcept.DATA_FEED:
+                return [api_1.Api.ECacheKey.DataFeed];
+            case account_concept_1.AccountConcept.EConcept.DATA_SOURCE:
+                return [api_1.Api.ECacheKey.DataSource, api_1.Api.ECacheKey.EntitySource];
+            case account_concept_1.AccountConcept.EConcept.DOCUMENT_VIEW:
+                return [api_1.Api.ECacheKey.AnnDocument];
+            case account_concept_1.AccountConcept.EConcept.ENTITY:
+                return [
+                    api_1.Api.ECacheKey.Entity,
+                    api_1.Api.ECacheKey.EntityCoords,
+                    api_1.Api.ECacheKey.Attachment,
+                    api_1.Api.ECacheKey.Comment,
+                    api_1.Api.ECacheKey.Link
+                ];
+            case account_concept_1.AccountConcept.EConcept.ENTITY_LOD:
+                return [api_1.Api.ECacheKey.Lod];
+            case account_concept_1.AccountConcept.EConcept.ENTITY_RELATION:
+                return [api_1.Api.ECacheKey.Relation];
+            case account_concept_1.AccountConcept.EConcept.ENTITY_TYPE:
+                return [api_1.Api.ECacheKey.EntityType, api_1.Api.ECacheKey.EntityTypeTrigger];
+            case account_concept_1.AccountConcept.EConcept.ENTITY_TYPE_LOD:
+                return [api_1.Api.ECacheKey.Lod];
+            case account_concept_1.AccountConcept.EConcept.LAYER:
+                return [api_1.Api.ECacheKey.Tag];
+            case account_concept_1.AccountConcept.EConcept.LOD_CATEGORY:
+                return [api_1.Api.ECacheKey.LodCategory];
+            case account_concept_1.AccountConcept.EConcept.PENDING_ACTION:
+                return [api_1.Api.ECacheKey.PendingAction];
+            case account_concept_1.AccountConcept.EConcept.PROGRAM_KEY:
+                return [api_1.Api.ECacheKey.ProgramKey];
+            case account_concept_1.AccountConcept.EConcept.PROJECT_VIEW:
+                return [api_1.Api.ECacheKey.ProjectView, api_1.Api.ECacheKey.ProjectViewBookmark];
+            case account_concept_1.AccountConcept.EConcept.RELATION_TYPE:
+                return [api_1.Api.ECacheKey.RelationType];
+            case account_concept_1.AccountConcept.EConcept.TILESET:
+                return [api_1.Api.ECacheKey.Tileset, api_1.Api.ECacheKey.PublishTileset, api_1.Api.ECacheKey.TilesetAccess];
+            case account_concept_1.AccountConcept.EConcept.UI_ENTITY_DISPLAY_SETTING:
+                return [api_1.Api.ECacheKey.Style];
+            case account_concept_1.AccountConcept.EConcept.UI_PLUGIN:
+                return [api_1.Api.ECacheKey.Plugin, api_1.Api.ECacheKey.PluginIndexFile];
+            case account_concept_1.AccountConcept.EConcept.UI_SLIDE:
+            case account_concept_1.AccountConcept.EConcept.UI_SLIDE_GROUP:
+                return [api_1.Api.ECacheKey.ProjectViewBookmark];
+            default:
+                return [];
+        }
+    };
+    /**
+     * Evicts relevant cache entries in response to a record-change event.
+     */
+    RecordChangeFeed.clearCachesForEvent = (event, cache) => {
+        const cacheKeys = RecordChangeFeed.getConceptCacheKeys(event.concept);
+        if (!cacheKeys.length) {
+            return;
+        }
+        // Entity-concept events use internal ID ranges, not public record IDs,
+        // so individual entity cache entries cannot be matched.
+        const isEntityConcept = event.concept === ENTITY_CONCEPT;
+        const recordIds = [];
+        if (!isEntityConcept && typeof event.data === "string" && event.data) {
+            for (const part of event.data.split(",")) {
+                const id = part.trim();
+                if (id) {
+                    recordIds.push(id);
+                }
+            }
+        }
+        for (const cacheKey of cacheKeys) {
+            // Phase 1: evict record-specific cache entries.
+            for (const recordId of recordIds) {
+                cache.RemoveByContains(cacheKey + api_1.Api.ECacheKey.Id + recordId);
+            }
+            // Phase 2: evict list / concept-level entries.
+            cache.RemoveByCallback((key) => {
+                const keyStr = key == null ? "" : String(key);
+                for (const recordId of recordIds) {
+                    if (keyStr.includes(recordId)) {
+                        return false;
+                    }
+                }
+                return keyStr === cacheKey || keyStr.startsWith(cacheKey + api_1.Api.ECacheKey.Id);
+            });
+        }
+    };
+    /**
+     * A typed, self-managing live feed for Bruce record-change events.
+     *
+     * Wraps a {@link MessageBroker.IBroker} and routes incoming WebSocket messages
+     * to strongly-typed, optionally-filtered subscriber callbacks.
+     *
+     * When a "cache" is provided (via the {@link BruceApi.Api} constructor),
+     * relevant cache entries are automatically evicted on every incoming event
+     * before subscribers are notified.
+     *
+     * Reconnection is handled by the underlying broker, subscribers do not need
+     * to re-register after a disconnect/reconnect cycle.
+     *
+     * @example
+     * const unsub = api.RecordChangeFeed.Subscribe(
+     *   { concepts: [AccountConcept.EConcept.ENTITY_TYPE] },
+     *   (event) => console.log("Entity type changed:", event)
+     * );
+     *
+     * // Later:
+     * unsub();
+     */
+    class Client {
+        /**
+         * Initialize new instance. Done through a BruceAPI instance in all current uses.
+         * @param broker
+         * @param accountId
+         * @param env
+         * @param cache
+         */
+        constructor(broker, accountId, env, cache) {
+            this.subscribers = [];
+            this.topic = `${getTopicEnvPrefix(env)}_${accountId}_API_DATA`;
+            this.broker = broker;
+            this.cache = cache;
+            this.brokerCallback = this.onBrokerMessage.bind(this);
+            this.broker.Subscribe(this.topic, this.brokerCallback);
+        }
+        /**
+         * Whether the underlying WebSocket connection is currently open.
+         */
+        get IsConnected() {
+            return this.broker.IsConnected;
+        }
+        /**
+         * Forward the authenticated user ID to the underlying broker.
+         */
+        SetUserId(userId) {
+            this.broker.SetUserId(userId);
+        }
+        onBrokerMessage(message) {
+            if ((message === null || message === void 0 ? void 0 : message.event) === "usersUpdate") {
+                return;
+            }
+            const event = RecordChangeFeed.parseEvent(message);
+            if (!event) {
+                return;
+            }
+            // Auto-evict relevant cache entries before notifying subscribers.
+            if (this.cache) {
+                RecordChangeFeed.clearCachesForEvent(event, this.cache);
+            }
+            for (const { params, callback } of this.subscribers) {
+                if (!this.matchesFilter(event, params)) {
+                    continue;
+                }
+                callback(event);
+            }
+        }
+        matchesFilter(event, params) {
+            var _a, _b;
+            if (((_a = params.concepts) === null || _a === void 0 ? void 0 : _a.length) && !params.concepts.includes(event.concept)) {
+                return false;
+            }
+            if (((_b = params.actions) === null || _b === void 0 ? void 0 : _b.length) && !params.actions.includes(event.action)) {
+                return false;
+            }
+            const isEntityConcept = event.concept === ENTITY_CONCEPT;
+            if (!isEntityConcept && params.recordId !== undefined) {
+                const list = typeof event.data === "string" ? event.data : "";
+                if (!RecordChangeFeed.isRecordIdInListString(list, params.recordId)) {
+                    return false;
+                }
+            }
+            // Entity events don't carry public record IDs, skip if caller only
+            // specified recordId (they need entityInternalId for entity filtering).
+            if (isEntityConcept && params.recordId !== undefined && params.entityInternalId === undefined) {
+                return false;
+            }
+            if (isEntityConcept && params.entityInternalId !== undefined) {
+                const range = typeof event.data === "string" ? event.data : "";
+                if (!RecordChangeFeed.isEntityInternalIdInRangeString(range, params.entityInternalId)) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        /**
+         * Register a typed callback for record-change events.
+         *
+         * @param params Filtering criteria. All fields are optional.
+         * @param callback Invoked for each matching event.
+         * @returns An unsubscribe function. Call it to stop receiving events.
+         */
+        Subscribe(params, callback) {
+            const subscriber = { params, callback };
+            this.subscribers.push(subscriber);
+            return () => {
+                const index = this.subscribers.indexOf(subscriber);
+                if (index !== -1) {
+                    this.subscribers.splice(index, 1);
+                }
+            };
+        }
+        /**
+         * Unsubscribes from the broker topic and clears all local subscribers.
+         * Call this when the owning API instance is being torn down.
+         */
+        Destroy() {
+            this.subscribers.length = 0;
+            this.broker.Unsubscribe(this.topic, this.brokerCallback);
+        }
+    }
+    RecordChangeFeed.Client = Client;
+})(RecordChangeFeed = exports.RecordChangeFeed || (exports.RecordChangeFeed = {}));
+//# sourceMappingURL=record-change-feed.js.map

package/dist/lib/server/record-change-feed.js.map

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

package/dist/types/api/bruce-api.d.ts

@@ -1,8 +1,9 @@
+import { Account, IDictionary } from "../bruce-models";
+import { MessageBroker } from "../server/message-broker";
+import { RecordChangeFeed } from "../server/record-change-feed";
 import { AbstractApi } from "./abstract-api";
 import { Api as A } from "./api";
-import { MessageBroker } from "../server/message-broker";
 import { GuardianApi } from "./guardian-api";
-import { Account, IDictionary } from "../bruce-models";
 /**
  * The primary API for communication with Nextspace.
  * This API is used to manage your data.
@@ -27,7 +28,18 @@ export declare namespace BruceApi {
         private env;
         private loadCancelled;
         private messageBroker;
+        /**
+         * General-purpose WebSocket message broker for this API instance.
+         * Use this to subscribe to custom topics.
+         * For typed record-change events, prefer {@link RecordChangeFeed}.
+         */
         get MessageBroker(): MessageBroker.IBroker;
+        private _recordChangeFeed;
+        /**
+         * Typed live feed for Bruce record-change events.
+         * Available once the API has finished loading (await api.Loading) when `loadWebSocket: true` was passed to the constructor.
+         */
+        get RecordChangeFeed(): RecordChangeFeed.Client | null;
         private configLoadAttempted;
         get ConfigLoadAttempted(): boolean;
         private cdnBaseUrl;

package/dist/types/bruce-models.d.ts

@@ -1,16 +1,25 @@
-export * from "./assembly/assembly";
+export * from "./account/account";
+export * from "./account/account-concept";
+export * from "./account/account-features";
+export * from "./account/account-invite";
+export * from "./account/account-limits";
+export * from "./account/account-settings";
+export * from "./account/account-template";
+export * from "./account/account-type";
 export * from "./ann-document/ann-document";
-export * from "./custom-form/custom-form";
-export * from "./custom-form/custom-form-content";
 export * from "./api/abstract-api";
 export * from "./api/api";
+export * from "./api/api-getters";
 export * from "./api/bruce-api";
 export * from "./api/global-api";
 export * from "./api/guardian-api";
-export * from "./api/api-getters";
+export * from "./assembly/assembly";
 export * from "./calculator/calculator";
+export * from "./change-set/change-set";
+export * from "./client-file/client-file";
 export * from "./common/bounds";
 export * from "./common/bruce-event";
+export * from "./common/bruce-variable";
 export * from "./common/cache";
 export * from "./common/camera";
 export * from "./common/cartes";
@@ -18,91 +27,83 @@ export * from "./common/carto";
 export * from "./common/color";
 export * from "./common/delay-queue";
 export * from "./common/dictionary";
+export * from "./common/geojson";
 export * from "./common/geometry";
-export * from "./common/transform";
-export * from "./common/utc";
-export * from "./common/bruce-variable";
 export * from "./common/lru-cache";
 export * from "./common/section";
-export * from "./common/geojson";
-export * from "./entity/entity-attachment-type";
+export * from "./common/transform";
+export * from "./common/utc";
+export * from "./custom-form/custom-form";
+export * from "./custom-form/custom-form-content";
+export * from "./dashboard/dashboard-view";
+export * from "./data-feed/data-feed";
+export * from "./data-lab/data-lab";
+export * from "./data-lab/data-lab-group";
+export * from "./data-source/data-source";
+export * from "./data-transform/data-transform";
+export * from "./entity-type-model/comment";
+export * from "./entity/entity";
 export * from "./entity/entity-attachment";
+export * from "./entity/entity-attachment-type";
+export * from "./entity/entity-attribute";
 export * from "./entity/entity-comment";
+export * from "./entity/entity-coords";
+export * from "./entity/entity-historic-data";
 export * from "./entity/entity-link";
 export * from "./entity/entity-lod";
 export * from "./entity/entity-lod-category";
-export * from "./entity/entity-relation-type";
 export * from "./entity/entity-relation";
+export * from "./entity/entity-relation-type";
 export * from "./entity/entity-source";
+export * from "./entity/entity-table-view";
 export * from "./entity/entity-tag";
-export * from "./entity/entity-type-trigger";
 export * from "./entity/entity-type";
-export * from "./entity/entity";
-export * from "./entity/entity-coords";
-export * from "./entity/entity-attribute";
-export * from "./entity/entity-historic-data";
-export * from "./entity/entity-table-view";
-export * from "./dashboard/dashboard-view";
-export * from "./entity-type-model/comment";
-export * from "./client-file/client-file";
+export * from "./entity/entity-type-trigger";
+export * from "./environment";
+export * from "./export/export-brz";
+export * from "./export/export-usd";
+export * from "./import/import-assembly";
+export * from "./import/import-cad";
+export * from "./import/import-csv";
+export * from "./import/import-geojson";
+export * from "./import/import-json";
+export * from "./import/import-kml";
+export * from "./import/import-lcc";
+export * from "./import/imported-file";
+export * from "./internal/uploader";
+export * from "./markup/markup";
+export * from "./mcp/navigator-chat";
+export * from "./mcp/navigator-mcp-websocket";
+export * from "./plugin/plugin";
 export * from "./program-key/program-key";
-export * from "./project/zoom-control";
 export * from "./project/menu-item";
-export * from "./project/project-view-bookmark";
 export * from "./project/project-view";
-export * from "./project/project-view-legacy-tile";
-export * from "./project/project-view-tile";
-export * from "./project/project-view-selection";
+export * from "./project/project-view-bookmark";
+export * from "./project/project-view-bookmark-group";
 export * from "./project/project-view-legacy";
 export * from "./project/project-view-legacy-bookmark";
-export * from "./project/project-view-bookmark-group";
-export * from "./server/pending-action";
-export * from "./server/message-broker";
-export * from "./server/hosting-location";
+export * from "./project/project-view-legacy-tile";
+export * from "./project/project-view-selection";
+export * from "./project/project-view-tile";
+export * from "./project/zoom-control";
+export * from "./scenario/scenario";
 export * from "./server/database-server";
 export * from "./server/file-store-location";
+export * from "./server/hosting-location";
+export * from "./server/message-broker";
+export * from "./server/pending-action";
+export * from "./server/record-change-feed";
 export * from "./style/style";
 export * from "./tileset/tileset";
+export * from "./tracking/tracking";
 export * from "./user/permission";
 export * from "./user/session";
-export * from "./user/user-group";
 export * from "./user/user";
+export * from "./user/user-group";
 export * from "./user/user-mfa-method";
-export * from "./account/account";
-export * from "./account/account-concept";
-export * from "./account/account-settings";
-export * from "./account/account-invite";
-export * from "./account/account-features";
-export * from "./account/account-limits";
-export * from "./account/account-template";
-export * from "./account/account-type";
 export * from "./util/encrypt-utils";
 export * from "./util/math-utils";
 export * from "./util/object-utils";
 export * from "./util/path-utils";
 export * from "./util/url-utils";
-export * from "./data-lab/data-lab";
-export * from "./data-transform/data-transform";
-export * from "./data-lab/data-lab-group";
-export * from "./data-feed/data-feed";
-export * from "./import/import-assembly";
-export * from "./import/import-cad";
-export * from "./import/import-csv";
-export * from "./import/import-json";
-export * from "./import/import-geojson";
-export * from "./import/import-kml";
-export * from "./import/import-lcc";
-export * from "./import/imported-file";
-export * from "./export/export-brz";
-export * from "./export/export-usd";
-export * from "./markup/markup";
-export * from "./internal/uploader";
-export * from "./plugin/plugin";
-export * from "./environment";
-export * from "./data-source/data-source";
-export * from "./scenario/scenario";
-export * from "./tracking/tracking";
-export * from "./mcp/navigator-chat";
-export * from "./mcp/navigator-mcp-websocket";
-export * from "./change-set/change-set";
-export declare const VERSION = "7.1.44";
+export declare const VERSION = "7.1.45";