feat(core): allow passing entry options via script query

packages/core/src/helpers/web.ts

@@ -1,3 +1,5 @@
+import { IRunOptions } from '../types';
+
 export function injectScript(win: Window, rootComId: string, scriptUrl: string) {
     return new Promise<Window>((res, rej) => {
         // This is the contract of the communication to get the root communication id
@@ -9,3 +11,20 @@ export function injectScript(win: Window, rootComId: string, scriptUrl: string)
         win.document.head.appendChild(scriptEl);
     });
 }
+
+interface EngineWebEntryGlobalObj {
+    document?: Document,
+    location?: Location
+
+    engineEntryOptions(options: { urlParams: URLSearchParams; envName: string }): IRunOptions;
+}
+
+export function getEngineEntryOptions(envName: string, globalObj: EngineWebEntryGlobalObj): IRunOptions {
+    const urlParams = new URLSearchParams(globalObj?.location?.search);
+    const currentScript = globalObj?.document?.currentScript;
+
+    const optionsFromScript = new URLSearchParams(currentScript && currentScript.dataset.engineRunOptions || undefined);
+    const injectedOptions = globalObj?.engineEntryOptions?.({ urlParams, envName }) ?? new URLSearchParams('');
+
+    return new Map([...optionsFromScript, ...urlParams, ...injectedOptions]);
+}

packages/core/src/types.ts

@@ -171,6 +171,8 @@ export interface IRunOptions {
     has(key: string): boolean;
     get(key: string): string | string[] | boolean | null | undefined;
     entries(): IterableIterator<[string, string | string[] | boolean | null | undefined]>;
+
+    [Symbol.iterator](): IterableIterator<[string, string | string[] | boolean | null | undefined]>;
 }
 
 export type RegisteringFeature<

packages/core/test/helpers.spec.ts

@@ -0,0 +1,25 @@
+import { expect } from 'chai';
+import { getEngineEntryOptions } from '@wixc3/engine-core';
+
+describe('helpers', () => {
+  describe('getEngineEntryOptions', () => {
+    it('it gets engine entry options from query string, from script url, from engineEntryOptions', () => {
+      const document = { currentScript: { dataset: { engineRunOptions: 'http://localhost:3000?one=0&two=1&script=123' } } } as unknown as Document;
+      const location = { search: 'one=2&two=2&search=123' } as Location;
+      const engineEntryOptions = ({ envName }: { envName: string }) => {
+        if (envName === 'thisTest') {
+          return new URLSearchParams([['injected', '123'], ['one', '1']]);
+        }
+        return new URLSearchParams();
+      };
+      const result = getEngineEntryOptions('thisTest', { document, location, engineEntryOptions });
+
+      expect(result.get('one'), 'Priorities injected options over search string and script url').to.eql('1');
+      expect(result.get('two'), 'Priorities search params over script url').to.eql('2');
+      expect(result.get('script'), 'Gets options from script url').to.eql('123');
+      expect(result.get('search'), 'Gets options from search string').to.eql('123');
+      expect(result.get('injected'), 'Gets options from engineEntryOptions').to.eql('123');
+    });
+  });
+});
+

packages/scripts/src/create-web-entrypoint.ts

@@ -46,10 +46,9 @@ export function createMainEntrypoint({
     );
 
     return `
-import { main, COM } from '@wixc3/engine-core';
+import { main, COM, getEngineEntryOptions } from '@wixc3/engine-core';
 
-const urlParams = new URLSearchParams(globalThis.location.search);
-const options = globalThis.engineEntryOptions?.({ urlParams, envName: ${stringify(env.name)} }) ?? urlParams;
+const options = getEngineEntryOptions(${stringify(env.name)}, globalThis)
 const runtimePublicPath = ${runtimePublicPath};
 main({
     featureName: ${stringify(featureName)},