@memberjunction/remote-browser-base 0.0.1 → 5.42.0

package/dist/control.js

@@ -0,0 +1,52 @@
+/**
+ * Determines whether a {@link RemoteBrowserControlMode} is valid given a backend's capabilities.
+ *
+ * A mode is only valid when the backend supports the capabilities it requires:
+ * - `AgentOnly` — always valid (the agent drives; no viewing/takeover prerequisite).
+ * - `ViewOnly` — requires `LiveView` (humans must be able to watch).
+ * - `Collaborative` — requires `LiveView` **and** `HumanTakeover` (humans watch *and* can take over).
+ *
+ * @param mode The control mode to validate.
+ * @param features The backend's capability flags.
+ * @returns `true` when the backend can support the mode, `false` otherwise.
+ */
+export function isControlModeSupported(mode, features) {
+    switch (mode) {
+        case 'AgentOnly':
+            return true;
+        case 'ViewOnly':
+            return features.LiveView === true;
+        case 'Collaborative':
+            return features.LiveView === true && features.HumanTakeover === true;
+        default:
+            // Exhaustive — `mode` is `never` here; any unhandled member is a compile error above.
+            return false;
+    }
+}
+/**
+ * Resolves which {@link RemoteBrowserControlStrategy} the engine should use for a backend, honoring an
+ * optional caller preference.
+ *
+ * **Precedence (highest to lowest):**
+ * 1. **`NativeAI`** — chosen *only* when the backend advertises `NativeAIControl` **and** the caller
+ *    did not explicitly pin `ComputerUse`. (A caller preference of `'NativeAI'` is honored only if the
+ *    backend actually supports it; an explicit `'ComputerUse'` always suppresses native delegation.)
+ * 2. **`ComputerUse`** — the universal default, chosen whenever the backend exposes the
+ *    `RawCdpControl` substrate and native control was not selected above.
+ * 3. **`ComputerUse`** — also the fallback when neither flag is set, because CDP-connect is the one
+ *    primitive every backend is expected to provide; emitting `ComputerUse` lets the caller surface a
+ *    clear downstream error if the backend genuinely cannot be driven, rather than this helper
+ *    inventing an unsupported strategy.
+ *
+ * @param features The backend's capability flags.
+ * @param preferred An optional caller preference; `'ComputerUse'` pins the universal loop and
+ *  suppresses native delegation even when the backend supports it.
+ * @returns The resolved control strategy.
+ */
+export function resolveControlStrategy(features, preferred) {
+    if (features.NativeAIControl === true && preferred !== 'ComputerUse') {
+        return 'NativeAI';
+    }
+    return 'ComputerUse';
+}
+//# sourceMappingURL=control.js.map

package/dist/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../src/control.ts"],"names":[],"mappings":"AAqCA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CAClC,IAA8B,EAC9B,QAAwC;IAExC,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,WAAW;YACZ,OAAO,IAAI,CAAC;QAChB,KAAK,UAAU;YACX,OAAO,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC;QACtC,KAAK,eAAe;YAChB,OAAO,QAAQ,CAAC,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,aAAa,KAAK,IAAI,CAAC;QACzE;YACI,sFAAsF;YACtF,OAAO,KAAK,CAAC;IACrB,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,sBAAsB,CAClC,QAAwC,EACxC,SAAwC;IAExC,IAAI,QAAQ,CAAC,eAAe,KAAK,IAAI,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;QACnE,OAAO,UAAU,CAAC;IACtB,CAAC;IACD,OAAO,aAAa,CAAC;AACzB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './capability-errors.js';
+export * from './remote-browser-features.js';
+export * from './control.js';
+export * from './remote-browser-session.js';
+export * from './base-remote-browser-provider.js';
+export * from './remote-browser-engine-base.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './capability-errors.js';
+export * from './remote-browser-features.js';
+export * from './control.js';
+export * from './remote-browser-session.js';
+export * from './base-remote-browser-provider.js';
+export * from './remote-browser-engine-base.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC"}

package/dist/remote-browser-engine-base.d.ts

@@ -0,0 +1,76 @@
+import { BaseEngine, IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { MJAIRemoteBrowserProviderEntity } from '@memberjunction/core-entities';
+import { IRemoteBrowserProviderFeatures } from './remote-browser-features.js';
+/**
+ * Cross-platform, **metadata-only** engine for the Remote Browser plane.
+ *
+ * `RemoteBrowserEngineBase` mirrors `AIBridgeEngineBase` (and `AIEngineBase`) exactly: it is a
+ * {@link BaseEngine} subclass that caches the remote-browser provider registry rows (backends + their
+ * capability flags) and exposes synchronous resolution helpers over them. It performs **no
+ * execution** — live browser sessions, control arbitration, and the viewport→screen-track encode all
+ * live in `RemoteBrowserEngine` (the server package) which *composes over* this base. Keeping the
+ * metadata layer free of execution lets it be used anywhere (client or server) and stay reactive via
+ * the inherited {@link BaseEngine} event integration.
+ *
+ * Because the cached dataset is a small reference table, all lookups filter the in-memory array
+ * client-side rather than issuing RunViews.
+ *
+ * @see `/plans/realtime/realtime-bridges-architecture.md` §4d-i — the
+ * `RemoteBrowserEngineBase` / `RemoteBrowserEngine` pair.
+ */
+export declare class RemoteBrowserEngineBase extends BaseEngine<RemoteBrowserEngineBase> {
+    private _providers;
+    /**
+     * Loads (or refreshes) the remote-browser metadata cache.
+     *
+     * Registers the provider registry as locally-cached and delegates to the inherited
+     * {@link BaseEngine.Load}, which wires up event-driven invalidation so the cache stays fresh as
+     * rows change. Idempotent — a no-op when already loaded unless `forceRefresh` is set.
+     *
+     * @param forceRefresh When `true`, reloads even if already loaded.
+     * @param contextUser Required on the server side for proper data isolation.
+     * @param provider Optional explicit metadata provider (multi-provider scenarios); defaults to the engine's provider.
+     * @returns A promise that resolves once the cache is populated.
+     */
+    Config(forceRefresh?: boolean, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<void>;
+    /**
+     * All cached `MJ: AI Remote Browser Providers` rows (the backend registry + capability flags).
+     */
+    get Providers(): MJAIRemoteBrowserProviderEntity[];
+    /**
+     * Resolves a backend by its display name, case-insensitively and trim-tolerant.
+     *
+     * @param name The backend name (e.g. `'Browserbase'`, `'Self-Hosted Chrome'`).
+     * @returns The matching provider row, or `undefined` if none matches.
+     */
+    ProviderByName(name: string): MJAIRemoteBrowserProviderEntity | undefined;
+    /**
+     * Resolves a backend by its `DriverClass` (the `ClassFactory` key used to instantiate the concrete
+     * provider driver via `MJGlobal.ClassFactory.CreateInstance(BaseRemoteBrowserProvider, driverClass)`),
+     * case-insensitively and trim-tolerant.
+     *
+     * @param driverClass The driver class key (e.g. `'BrowserbaseRemoteBrowser'`).
+     * @returns The matching provider row, or `undefined` if none matches.
+     */
+    ProviderByDriverClass(driverClass: string): MJAIRemoteBrowserProviderEntity | undefined;
+    /**
+     * Returns the backends currently available for use (those with `Status === 'Active'`). Disabled
+     * backends cannot start new remote-browser sessions and are excluded.
+     *
+     * @returns The active provider rows.
+     */
+    ActiveProviders(): MJAIRemoteBrowserProviderEntity[];
+    /**
+     * Null-safely reads a backend's typed capability flags from its `SupportedFeaturesObject`
+     * accessor, substituting an empty (all-unsupported) set when none are declared.
+     *
+     * @param provider The provider row to read.
+     * @returns The backend's capability flags, or an empty object when none are declared.
+     */
+    FeaturesFor(provider: MJAIRemoteBrowserProviderEntity): IRemoteBrowserProviderFeatures;
+    /**
+     * The singleton accessor (via {@link BaseEngine}'s global object store).
+     */
+    static get Instance(): RemoteBrowserEngineBase;
+}
+//# sourceMappingURL=remote-browser-engine-base.d.ts.map

package/dist/remote-browser-engine-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-browser-engine-base.d.ts","sourceRoot":"","sources":["../src/remote-browser-engine-base.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,UAAU,EAEV,iBAAiB,EAEjB,QAAQ,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAE3E;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,uBAAwB,SAAQ,UAAU,CAAC,uBAAuB,CAAC;IAC5E,OAAO,CAAC,UAAU,CAAyC;IAE3D;;;;;;;;;;;OAWG;IACU,MAAM,CACf,YAAY,CAAC,EAAE,OAAO,EACtB,WAAW,CAAC,EAAE,QAAQ,EACtB,QAAQ,CAAC,EAAE,iBAAiB,GAC7B,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;IACH,IAAW,SAAS,IAAI,+BAA+B,EAAE,CAExD;IAED;;;;;OAKG;IACI,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,+BAA+B,GAAG,SAAS;IAQhF;;;;;;;OAOG;IACI,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,+BAA+B,GAAG,SAAS;IAQ9F;;;;;OAKG;IACI,eAAe,IAAI,+BAA+B,EAAE;IAI3D;;;;;;OAMG;IACI,WAAW,CACd,QAAQ,EAAE,+BAA+B,GAC1C,8BAA8B;IAIjC;;OAEG;IACH,WAAkB,QAAQ,IAAI,uBAAuB,CAEpD;CACJ"}

package/dist/remote-browser-engine-base.js

@@ -0,0 +1,116 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseEngine, RegisterForStartup, } from '@memberjunction/core';
+/**
+ * Cross-platform, **metadata-only** engine for the Remote Browser plane.
+ *
+ * `RemoteBrowserEngineBase` mirrors `AIBridgeEngineBase` (and `AIEngineBase`) exactly: it is a
+ * {@link BaseEngine} subclass that caches the remote-browser provider registry rows (backends + their
+ * capability flags) and exposes synchronous resolution helpers over them. It performs **no
+ * execution** — live browser sessions, control arbitration, and the viewport→screen-track encode all
+ * live in `RemoteBrowserEngine` (the server package) which *composes over* this base. Keeping the
+ * metadata layer free of execution lets it be used anywhere (client or server) and stay reactive via
+ * the inherited {@link BaseEngine} event integration.
+ *
+ * Because the cached dataset is a small reference table, all lookups filter the in-memory array
+ * client-side rather than issuing RunViews.
+ *
+ * @see `/plans/realtime/realtime-bridges-architecture.md` §4d-i — the
+ * `RemoteBrowserEngineBase` / `RemoteBrowserEngine` pair.
+ */
+let RemoteBrowserEngineBase = class RemoteBrowserEngineBase extends BaseEngine {
+    constructor() {
+        super(...arguments);
+        this._providers = [];
+    }
+    /**
+     * Loads (or refreshes) the remote-browser metadata cache.
+     *
+     * Registers the provider registry as locally-cached and delegates to the inherited
+     * {@link BaseEngine.Load}, which wires up event-driven invalidation so the cache stays fresh as
+     * rows change. Idempotent — a no-op when already loaded unless `forceRefresh` is set.
+     *
+     * @param forceRefresh When `true`, reloads even if already loaded.
+     * @param contextUser Required on the server side for proper data isolation.
+     * @param provider Optional explicit metadata provider (multi-provider scenarios); defaults to the engine's provider.
+     * @returns A promise that resolves once the cache is populated.
+     */
+    async Config(forceRefresh, contextUser, provider) {
+        const params = [
+            {
+                PropertyName: '_providers',
+                EntityName: 'MJ: AI Remote Browser Providers',
+                CacheLocal: true,
+            },
+        ];
+        return await this.Load(params, provider, forceRefresh, contextUser);
+    }
+    /**
+     * All cached `MJ: AI Remote Browser Providers` rows (the backend registry + capability flags).
+     */
+    get Providers() {
+        return this._providers;
+    }
+    /**
+     * Resolves a backend by its display name, case-insensitively and trim-tolerant.
+     *
+     * @param name The backend name (e.g. `'Browserbase'`, `'Self-Hosted Chrome'`).
+     * @returns The matching provider row, or `undefined` if none matches.
+     */
+    ProviderByName(name) {
+        const target = (name ?? '').trim().toLowerCase();
+        if (target.length === 0) {
+            return undefined;
+        }
+        return this._providers.find(p => (p.Name ?? '').trim().toLowerCase() === target);
+    }
+    /**
+     * Resolves a backend by its `DriverClass` (the `ClassFactory` key used to instantiate the concrete
+     * provider driver via `MJGlobal.ClassFactory.CreateInstance(BaseRemoteBrowserProvider, driverClass)`),
+     * case-insensitively and trim-tolerant.
+     *
+     * @param driverClass The driver class key (e.g. `'BrowserbaseRemoteBrowser'`).
+     * @returns The matching provider row, or `undefined` if none matches.
+     */
+    ProviderByDriverClass(driverClass) {
+        const target = (driverClass ?? '').trim().toLowerCase();
+        if (target.length === 0) {
+            return undefined;
+        }
+        return this._providers.find(p => (p.DriverClass ?? '').trim().toLowerCase() === target);
+    }
+    /**
+     * Returns the backends currently available for use (those with `Status === 'Active'`). Disabled
+     * backends cannot start new remote-browser sessions and are excluded.
+     *
+     * @returns The active provider rows.
+     */
+    ActiveProviders() {
+        return this._providers.filter(p => p.Status === 'Active');
+    }
+    /**
+     * Null-safely reads a backend's typed capability flags from its `SupportedFeaturesObject`
+     * accessor, substituting an empty (all-unsupported) set when none are declared.
+     *
+     * @param provider The provider row to read.
+     * @returns The backend's capability flags, or an empty object when none are declared.
+     */
+    FeaturesFor(provider) {
+        return provider.SupportedFeaturesObject ?? {};
+    }
+    /**
+     * The singleton accessor (via {@link BaseEngine}'s global object store).
+     */
+    static get Instance() {
+        return super.getInstance();
+    }
+};
+RemoteBrowserEngineBase = __decorate([
+    RegisterForStartup()
+], RemoteBrowserEngineBase);
+export { RemoteBrowserEngineBase };
+//# sourceMappingURL=remote-browser-engine-base.js.map

package/dist/remote-browser-engine-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-browser-engine-base.js","sourceRoot":"","sources":["../src/remote-browser-engine-base.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EACH,UAAU,EAGV,kBAAkB,GAErB,MAAM,sBAAsB,CAAC;AAI9B;;;;;;;;;;;;;;;;GAgBG;AAEI,IAAM,uBAAuB,GAA7B,MAAM,uBAAwB,SAAQ,UAAmC;IAAzE;;QACK,eAAU,GAAsC,EAAE,CAAC;IA+F/D,CAAC;IA7FG;;;;;;;;;;;OAWG;IACI,KAAK,CAAC,MAAM,CACf,YAAsB,EACtB,WAAsB,EACtB,QAA4B;QAE5B,MAAM,MAAM,GAA6C;YACrD;gBACI,YAAY,EAAE,YAAY;gBAC1B,UAAU,EAAE,iCAAiC;gBAC7C,UAAU,EAAE,IAAI;aACnB;SACJ,CAAC;QACF,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACI,cAAc,CAAC,IAAY;QAC9B,MAAM,MAAM,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;OAOG;IACI,qBAAqB,CAAC,WAAmB;QAC5C,MAAM,MAAM,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACxD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC;IAC5F,CAAC;IAED;;;;;OAKG;IACI,eAAe;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;OAMG;IACI,WAAW,CACd,QAAyC;QAEzC,OAAO,QAAQ,CAAC,uBAAuB,IAAI,EAAE,CAAC;IAClD,CAAC;IAED;;OAEG;IACI,MAAM,KAAK,QAAQ;QACtB,OAAO,KAAK,CAAC,WAAW,EAA2B,CAAC;IACxD,CAAC;CACJ,CAAA;AAhGY,uBAAuB;IADnC,kBAAkB,EAAE;GACR,uBAAuB,CAgGnC"}

package/dist/remote-browser-features.d.ts

@@ -0,0 +1,46 @@
+import { MJAIRemoteBrowserProviderEntity, MJAIRemoteBrowserProviderEntity_IRemoteBrowserProviderFeatures } from '@memberjunction/core-entities';
+/**
+ * Strongly-typed shape of a remote-browser backend's `SupportedFeatures` JSON.
+ *
+ * This is an **alias** of the CodeGen-generated
+ * `MJAIRemoteBrowserProviderEntity_IRemoteBrowserProviderFeatures` (emitted from the
+ * `IRemoteBrowserProviderFeatures` JSONType interface bound to the
+ * `MJ: AI Remote Browser Providers.SupportedFeatures` column). It is re-exported here under the
+ * short source-interface name so channel/engine/driver code can refer to
+ * `IRemoteBrowserProviderFeatures` without importing the verbose generated name.
+ *
+ * Per repo convention we do not re-export TYPES from other packages as a dependency chain — this is a
+ * documented type alias of a generated entity shape for ergonomics, and the canonical source remains
+ * `@memberjunction/core-entities`.
+ *
+ * The capability flags are *transport / control* concerns only — the universal CDP substrate
+ * (`RawCdpControl`), an optional provider-native AI-control harness (`NativeAIControl`), viewing &
+ * collaboration (`LiveView`, `HumanTakeover`, `ScreenStreaming`), and operational capabilities
+ * (`Stealth`, `ProxyEgress`, `SessionRecording`, `PersistentContext`, `MultiTab`, `FileDownloads`,
+ * `CaptchaSolving`). Every flag is optional; an omitted flag means the feature is **not** supported.
+ *
+ * @see `/plans/realtime/realtime-bridges-architecture.md` §4d / §4d-i.
+ */
+export type IRemoteBrowserProviderFeatures = MJAIRemoteBrowserProviderEntity_IRemoteBrowserProviderFeatures;
+/**
+ * The complete set of `IRemoteBrowserProviderFeatures` keys, as a readonly tuple.
+ *
+ * Useful for validators, diffing a driver's declared overrides against its provider metadata, and any
+ * code that must iterate over every known capability flag. Typed as `ReadonlyArray<keyof
+ * IRemoteBrowserProviderFeatures>` so the list stays in lock-step with the interface — adding a flag
+ * to the interface surfaces a compile error here until the key is added.
+ */
+export declare const KNOWN_REMOTE_BROWSER_FEATURE_KEYS: ReadonlyArray<keyof IRemoteBrowserProviderFeatures>;
+/**
+ * Null-safely reads a provider's typed capability flags.
+ *
+ * Reads `provider.SupportedFeaturesObject` (the generated, lazily-parsed JSON accessor — never
+ * `JSON.parse(provider.SupportedFeatures)`) and substitutes an empty feature set when the column is
+ * NULL/omitted, so callers can dereference flags without a null guard. An empty set means every
+ * capability reads as `undefined` (i.e. unsupported), which is the intended fail-closed default.
+ *
+ * @param provider The remote-browser provider metadata row.
+ * @returns The provider's capability flags, or an empty object when none are declared.
+ */
+export declare function featuresOf(provider: MJAIRemoteBrowserProviderEntity): IRemoteBrowserProviderFeatures;
+//# sourceMappingURL=remote-browser-features.d.ts.map

package/dist/remote-browser-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-browser-features.d.ts","sourceRoot":"","sources":["../src/remote-browser-features.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,+BAA+B,EAC/B,8DAA8D,EACjE,MAAM,+BAA+B,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,8BAA8B,GAAG,8DAA8D,CAAC;AAE5G;;;;;;;GAOG;AACH,eAAO,MAAM,iCAAiC,EAAE,aAAa,CAAC,MAAM,8BAA8B,CAajG,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACtB,QAAQ,EAAE,+BAA+B,GAC1C,8BAA8B,CAEhC"}

package/dist/remote-browser-features.js

@@ -0,0 +1,37 @@
+/**
+ * The complete set of `IRemoteBrowserProviderFeatures` keys, as a readonly tuple.
+ *
+ * Useful for validators, diffing a driver's declared overrides against its provider metadata, and any
+ * code that must iterate over every known capability flag. Typed as `ReadonlyArray<keyof
+ * IRemoteBrowserProviderFeatures>` so the list stays in lock-step with the interface — adding a flag
+ * to the interface surfaces a compile error here until the key is added.
+ */
+export const KNOWN_REMOTE_BROWSER_FEATURE_KEYS = [
+    'RawCdpControl',
+    'NativeAIControl',
+    'LiveView',
+    'HumanTakeover',
+    'ScreenStreaming',
+    'Stealth',
+    'ProxyEgress',
+    'SessionRecording',
+    'PersistentContext',
+    'MultiTab',
+    'FileDownloads',
+    'CaptchaSolving',
+];
+/**
+ * Null-safely reads a provider's typed capability flags.
+ *
+ * Reads `provider.SupportedFeaturesObject` (the generated, lazily-parsed JSON accessor — never
+ * `JSON.parse(provider.SupportedFeatures)`) and substitutes an empty feature set when the column is
+ * NULL/omitted, so callers can dereference flags without a null guard. An empty set means every
+ * capability reads as `undefined` (i.e. unsupported), which is the intended fail-closed default.
+ *
+ * @param provider The remote-browser provider metadata row.
+ * @returns The provider's capability flags, or an empty object when none are declared.
+ */
+export function featuresOf(provider) {
+    return provider.SupportedFeaturesObject ?? {};
+}
+//# sourceMappingURL=remote-browser-features.js.map

package/dist/remote-browser-features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-browser-features.js","sourceRoot":"","sources":["../src/remote-browser-features.ts"],"names":[],"mappings":"AA6BA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAwD;IAClG,eAAe;IACf,iBAAiB;IACjB,UAAU;IACV,eAAe;IACf,iBAAiB;IACjB,SAAS;IACT,aAAa;IACb,kBAAkB;IAClB,mBAAmB;IACnB,UAAU;IACV,eAAe;IACf,gBAAgB;CACnB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CACtB,QAAyC;IAEzC,OAAO,QAAQ,CAAC,uBAAuB,IAAI,EAAE,CAAC;AAClD,CAAC"}