@greensecurity/javascript-sdk 0.46.0-beta.5 → 0.46.0-beta.7

package/dist/commonjs/apps/runtime/elements.js

@@ -0,0 +1,76 @@
+"use strict";
+/*
+ * Hand-written (not generated by Speakeasy). Third-party app developer kit (C10); see
+ * docs/third-party-apps/plan.md.
+ *
+ * One remote custom element per entry of the C0 component catalog, built from the catalog
+ * itself so the SDK and the host renderer cannot drift apart:
+ *  - every declared prop becomes a remote property (sent to the host as a property update);
+ *  - every declared event becomes a remote event listener named by `EventSpec.event`
+ *    (`press`, `change`, `shownchange`, `save`, ...). The host calls the listener with the
+ *    event's `detail` as its only argument;
+ *  - every declared slot becomes a remote slot. Slotted content arrives at the host as a
+ *    `remote-fragment` child whose `slot` attribute names the slot.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ELEMENTS = exports.REMOTE_FRAGMENT_TAG = exports.REMOTE_ROOT_TAG = void 0;
+exports.defineRemoteElements = defineRemoteElements;
+const polyfill_js_1 = require("./polyfill.js");
+const elements_1 = require("@remote-dom/core/elements");
+const components_js_1 = require("../components.js");
+exports.REMOTE_ROOT_TAG = "remote-root";
+exports.REMOTE_FRAGMENT_TAG = "remote-fragment";
+function propertyType(spec) {
+    switch (spec.type) {
+        case "string":
+        case "enum":
+        case "imageSrc":
+            return String;
+        case "number":
+            return Number;
+        case "boolean":
+            return Boolean;
+        // `href` is a RouteDescriptor or a string; `json` is a plain object. Both travel as-is.
+        case "href":
+        case "json":
+            return Object;
+    }
+}
+function buildElement(spec) {
+    const properties = {};
+    for (const [name, propSpec] of Object.entries(spec.props)) {
+        properties[name] = { type: propertyType(propSpec) };
+    }
+    return (0, elements_1.createRemoteElement)({
+        properties,
+        events: Object.values(spec.events).map((e) => e.event),
+        slots: [...spec.slots],
+    });
+}
+const CATALOG = components_js_1.COMPONENTS;
+/** The element class for each catalog component, keyed by component name. */
+exports.ELEMENTS = Object.fromEntries(Object.keys(CATALOG).map((name) => [name, buildElement(CATALOG[name])]));
+let defined = false;
+/**
+ * Registers `remote-root`, `remote-fragment` and every catalog tag with the polyfilled
+ * `customElements` registry. Idempotent, and tolerant of a tag another copy of the SDK already
+ * registered (a second registration would throw).
+ */
+function defineRemoteElements() {
+    if (defined)
+        return;
+    if (!(0, polyfill_js_1.polyfillInstalled)())
+        throw new Error("The remote-dom polyfill is not installed");
+    defineOnce(exports.REMOTE_ROOT_TAG, elements_1.RemoteRootElement);
+    // Its published typings lose the HTMLElement base (an extensionless import); it is one.
+    defineOnce(exports.REMOTE_FRAGMENT_TAG, elements_1.RemoteFragmentElement);
+    for (const name of Object.keys(exports.ELEMENTS)) {
+        defineOnce(CATALOG[name].tagName, exports.ELEMENTS[name]);
+    }
+    defined = true;
+}
+function defineOnce(tagName, ctor) {
+    if (!customElements.get(tagName))
+        customElements.define(tagName, ctor);
+}
+//# sourceMappingURL=elements.js.map

package/dist/commonjs/apps/runtime/elements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elements.js","sourceRoot":"","sources":["../../../../src/apps/runtime/elements.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAwEH,oDAWC;AAjFD,+CAAkD;AAClD,wDAMmC;AACnC,oDAAqG;AAExF,QAAA,eAAe,GAAG,aAAa,CAAC;AAChC,QAAA,mBAAmB,GAAG,iBAAiB,CAAC;AAUrD,SAAS,YAAY,CAAC,IAAc;IAClC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM,CAAC;QACZ,KAAK,UAAU;YACb,OAAO,MAAM,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,OAAO,CAAC;QACjB,wFAAwF;QACxF,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,IAAmB;IACvC,MAAM,UAAU,GAAoD,EAAE,CAAC;IACvE,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;IACtD,CAAC;IAED,OAAO,IAAA,8BAAmB,EAKxB;QACA,UAAU;QACV,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACtD,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;KACvB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,GAAG,0BAA4D,CAAC;AAE7E,6EAA6E;AAChE,QAAA,QAAQ,GAA+D,MAAM,CAAC,WAAW,CACnG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAqB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CACzC,CAAC;AAEtD,IAAI,OAAO,GAAG,KAAK,CAAC;AAEpB;;;;GAIG;AACH,SAAgB,oBAAoB;IAClC,IAAI,OAAO;QAAE,OAAO;IACpB,IAAI,CAAC,IAAA,+BAAiB,GAAE;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAEtF,UAAU,CAAC,uBAAe,EAAE,4BAAiB,CAAC,CAAC;IAC/C,wFAAwF;IACxF,UAAU,CAAC,2BAAmB,EAAE,gCAA4D,CAAC,CAAC;IAC9F,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAQ,CAAoB,EAAE,CAAC;QAC5D,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,gBAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC;AAED,SAAS,UAAU,CAAC,OAAe,EAAE,IAA8B;IACjE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACzE,CAAC"}

package/dist/commonjs/apps/runtime/index.d.ts

@@ -0,0 +1,31 @@
+import { type AppDefinition, type SandboxRuntime, type SandboxRuntimeOptions } from "./sandbox.js";
+import { type ExposedSandbox, type MessageEndpoint, RuntimeChannel } from "./transport.js";
+export { createSandboxExports, MUTATION_BATCH_MS, type AppDefinition, type SandboxRuntime, type SandboxRuntimeOptions } from "./sandbox.js";
+export { ExtensionContextProvider, type ExtensionContextProviderProps } from "./provider.js";
+export { exposeSandbox, isWorkerGlobalScope, PORT_HANDOFF_KIND, RuntimeChannel, type ExposedSandbox, type MessageEndpoint, type PortHandoffMessage, } from "./transport.js";
+export { forwardConsole, formatLogArgs, MAX_LOG_MESSAGE_CHARS, REDACTED, redactLogMessage, type ForwardConsoleOptions, type LogEnvelope, type LogLevel, } from "./console.js";
+export { defineRemoteElements, ELEMENTS, REMOTE_FRAGMENT_TAG, REMOTE_ROOT_TAG } from "./elements.js";
+export { TokenStore, type TokenKind, type TokenSource } from "./session.js";
+export interface DefineAppOptions extends Omit<SandboxRuntimeOptions, "postLog"> {
+    /**
+     * Where to serve `SandboxExports`. Defaults to the worker's global scope when running in a
+     * Web Worker; outside one (tests, SSR) nothing is exposed unless you pass an endpoint.
+     */
+    endpoint?: MessageEndpoint | RuntimeChannel;
+}
+export interface DefinedApp {
+    /** The `SandboxExports` implementation, also callable directly (tests use this). */
+    exports: SandboxRuntime;
+    /**
+     * Present when the exports are served over a thread; resolves once the thread is answering.
+     * Messages that arrive before then are held, not dropped.
+     */
+    exposed?: Promise<ExposedSandbox>;
+}
+/**
+ * Registers your views and starts serving them to the host. Call it once, at the top level of
+ * your bundle's entry file. The bundle should not `export` anything: the host loads it as a
+ * worker script.
+ */
+export declare function defineApp(definition: AppDefinition, options?: DefineAppOptions): DefinedApp;
+//# sourceMappingURL=index.d.ts.map

package/dist/commonjs/apps/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/apps/runtime/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAwB,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACzH,OAAO,EAAsC,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE/H,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC5I,OAAO,EAAE,wBAAwB,EAAE,KAAK,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,QAAQ,EACR,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,QAAQ,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrG,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAE5E,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC;IAC9E;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,GAAG,cAAc,CAAC;CAC7C;AAED,MAAM,WAAW,UAAU;IACzB,oFAAoF;IACpF,OAAO,EAAE,cAAc,CAAC;IACxB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,GAAE,gBAAqB,GAAG,UAAU,CAmB/F"}

package/dist/commonjs/apps/runtime/index.js

@@ -0,0 +1,69 @@
+"use strict";
+/*
+ * Hand-written (not generated by Speakeasy). Third-party app developer kit (C10); see
+ * docs/third-party-apps/plan.md.
+ *
+ * Import as `@greensecurity/javascript-sdk/apps/runtime`.
+ *
+ * ```ts
+ * import { defineApp } from "@greensecurity/javascript-sdk/apps/runtime";
+ * defineApp({ views: { VendorPanel, AppSettings } });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenStore = exports.REMOTE_ROOT_TAG = exports.REMOTE_FRAGMENT_TAG = exports.ELEMENTS = exports.defineRemoteElements = exports.redactLogMessage = exports.REDACTED = exports.MAX_LOG_MESSAGE_CHARS = exports.formatLogArgs = exports.forwardConsole = exports.RuntimeChannel = exports.PORT_HANDOFF_KIND = exports.isWorkerGlobalScope = exports.exposeSandbox = exports.ExtensionContextProvider = exports.MUTATION_BATCH_MS = exports.createSandboxExports = void 0;
+exports.defineApp = defineApp;
+const polyfill_js_1 = require("./polyfill.js");
+const sandbox_js_1 = require("./sandbox.js");
+const transport_js_1 = require("./transport.js");
+var sandbox_js_2 = require("./sandbox.js");
+Object.defineProperty(exports, "createSandboxExports", { enumerable: true, get: function () { return sandbox_js_2.createSandboxExports; } });
+Object.defineProperty(exports, "MUTATION_BATCH_MS", { enumerable: true, get: function () { return sandbox_js_2.MUTATION_BATCH_MS; } });
+var provider_js_1 = require("./provider.js");
+Object.defineProperty(exports, "ExtensionContextProvider", { enumerable: true, get: function () { return provider_js_1.ExtensionContextProvider; } });
+var transport_js_2 = require("./transport.js");
+Object.defineProperty(exports, "exposeSandbox", { enumerable: true, get: function () { return transport_js_2.exposeSandbox; } });
+Object.defineProperty(exports, "isWorkerGlobalScope", { enumerable: true, get: function () { return transport_js_2.isWorkerGlobalScope; } });
+Object.defineProperty(exports, "PORT_HANDOFF_KIND", { enumerable: true, get: function () { return transport_js_2.PORT_HANDOFF_KIND; } });
+Object.defineProperty(exports, "RuntimeChannel", { enumerable: true, get: function () { return transport_js_2.RuntimeChannel; } });
+var console_js_1 = require("./console.js");
+Object.defineProperty(exports, "forwardConsole", { enumerable: true, get: function () { return console_js_1.forwardConsole; } });
+Object.defineProperty(exports, "formatLogArgs", { enumerable: true, get: function () { return console_js_1.formatLogArgs; } });
+Object.defineProperty(exports, "MAX_LOG_MESSAGE_CHARS", { enumerable: true, get: function () { return console_js_1.MAX_LOG_MESSAGE_CHARS; } });
+Object.defineProperty(exports, "REDACTED", { enumerable: true, get: function () { return console_js_1.REDACTED; } });
+Object.defineProperty(exports, "redactLogMessage", { enumerable: true, get: function () { return console_js_1.redactLogMessage; } });
+var elements_js_1 = require("./elements.js");
+Object.defineProperty(exports, "defineRemoteElements", { enumerable: true, get: function () { return elements_js_1.defineRemoteElements; } });
+Object.defineProperty(exports, "ELEMENTS", { enumerable: true, get: function () { return elements_js_1.ELEMENTS; } });
+Object.defineProperty(exports, "REMOTE_FRAGMENT_TAG", { enumerable: true, get: function () { return elements_js_1.REMOTE_FRAGMENT_TAG; } });
+Object.defineProperty(exports, "REMOTE_ROOT_TAG", { enumerable: true, get: function () { return elements_js_1.REMOTE_ROOT_TAG; } });
+var session_js_1 = require("./session.js");
+Object.defineProperty(exports, "TokenStore", { enumerable: true, get: function () { return session_js_1.TokenStore; } });
+/**
+ * Registers your views and starts serving them to the host. Call it once, at the top level of
+ * your bundle's entry file. The bundle should not `export` anything: the host loads it as a
+ * worker script.
+ */
+function defineApp(definition, options = {}) {
+    if (!(0, polyfill_js_1.polyfillInstalled)())
+        throw new Error("The remote-dom polyfill failed to install");
+    const { endpoint, ...runtimeOptions } = options;
+    let channel;
+    if (endpoint instanceof transport_js_1.RuntimeChannel)
+        channel = endpoint;
+    else if (endpoint)
+        channel = new transport_js_1.RuntimeChannel(endpoint);
+    else if ((0, transport_js_1.isWorkerGlobalScope)())
+        channel = new transport_js_1.RuntimeChannel(globalThis);
+    const exports = (0, sandbox_js_1.createSandboxExports)(definition, {
+        ...runtimeOptions,
+        ...(channel ? { postLog: (envelope) => channel.postLog(envelope) } : {}),
+    });
+    if (!channel)
+        return { exports };
+    const exposed = (0, transport_js_1.exposeSandbox)(exports, { endpoint: channel });
+    // Nothing in a worker entry awaits this, so report a failed load instead of an unhandled rejection.
+    exposed.catch((error) => console.error("[green-app] could not start the host connection:", error));
+    return { exports, exposed };
+}
+//# sourceMappingURL=index.js.map

package/dist/commonjs/apps/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/apps/runtime/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAsDH,8BAmBC;AAvED,+CAAkD;AAElD,6CAAyH;AACzH,iDAA+H;AAE/H,2CAA4I;AAAnI,kHAAA,oBAAoB,OAAA;AAAE,+GAAA,iBAAiB,OAAA;AAChD,6CAA6F;AAApF,uHAAA,wBAAwB,OAAA;AACjC,+CAQwB;AAPtB,6GAAA,aAAa,OAAA;AACb,mHAAA,mBAAmB,OAAA;AACnB,iHAAA,iBAAiB,OAAA;AACjB,8GAAA,cAAc,OAAA;AAKhB,2CASsB;AARpB,4GAAA,cAAc,OAAA;AACd,2GAAA,aAAa,OAAA;AACb,mHAAA,qBAAqB,OAAA;AACrB,sGAAA,QAAQ,OAAA;AACR,8GAAA,gBAAgB,OAAA;AAKlB,6CAAqG;AAA5F,mHAAA,oBAAoB,OAAA;AAAE,uGAAA,QAAQ,OAAA;AAAE,kHAAA,mBAAmB,OAAA;AAAE,8GAAA,eAAe,OAAA;AAC7E,2CAA4E;AAAnE,wGAAA,UAAU,OAAA;AAoBnB;;;;GAIG;AACH,SAAgB,SAAS,CAAC,UAAyB,EAAE,UAA4B,EAAE;IACjF,IAAI,CAAC,IAAA,+BAAiB,GAAE;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAEvF,MAAM,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;IAChD,IAAI,OAAmC,CAAC;IACxC,IAAI,QAAQ,YAAY,6BAAc;QAAE,OAAO,GAAG,QAAQ,CAAC;SACtD,IAAI,QAAQ;QAAE,OAAO,GAAG,IAAI,6BAAc,CAAC,QAAQ,CAAC,CAAC;SACrD,IAAI,IAAA,kCAAmB,GAAE;QAAE,OAAO,GAAG,IAAI,6BAAc,CAAC,UAAwC,CAAC,CAAC;IAEvG,MAAM,OAAO,GAAG,IAAA,iCAAoB,EAAC,UAAU,EAAE;QAC/C,GAAG,cAAc;QACjB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzE,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,IAAA,4BAAa,EAAC,OAAgC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACvF,oGAAoG;IACpG,OAAO,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,kDAAkD,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5G,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/dist/commonjs/apps/runtime/polyfill.d.ts

@@ -0,0 +1,5 @@
+import { window as remoteWindow } from "@remote-dom/core/polyfill";
+export { remoteWindow };
+/** True once the polyfilled `window` is in place. Referencing it keeps this module in bundles. */
+export declare function polyfillInstalled(): boolean;
+//# sourceMappingURL=polyfill.d.ts.map

package/dist/commonjs/apps/runtime/polyfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfill.d.ts","sourceRoot":"","sources":["../../../../src/apps/runtime/polyfill.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAKnE,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,kGAAkG;AAClG,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}

package/dist/commonjs/apps/runtime/polyfill.js

@@ -0,0 +1,26 @@
+"use strict";
+/*
+ * Hand-written (not generated by Speakeasy). Third-party app developer kit (C10); see
+ * docs/third-party-apps/plan.md.
+ *
+ * Installs the DOM polyfill an app's worker needs before anything touches `HTMLElement`.
+ * Order matters: `@remote-dom/core/polyfill` creates `window`, `document`, `HTMLElement` and
+ * `customElements`, then `installReactDomShims` adds what react-dom probes for
+ * (`HTMLIFrameElement`, `location`, `navigator`, `Element#style`).
+ *
+ * Every module in this kit that imports `@remote-dom/core/elements` imports this module first,
+ * and uses `remoteWindow` so bundlers cannot drop the import: the SDK package is
+ * `sideEffects: false`, so a bare `import "./polyfill.js"` would be tree-shaken away.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remoteWindow = void 0;
+exports.polyfillInstalled = polyfillInstalled;
+const polyfill_1 = require("@remote-dom/core/polyfill");
+Object.defineProperty(exports, "remoteWindow", { enumerable: true, get: function () { return polyfill_1.window; } });
+const react_dom_shims_js_1 = require("./react-dom-shims.js");
+(0, react_dom_shims_js_1.installReactDomShims)(polyfill_1.window);
+/** True once the polyfilled `window` is in place. Referencing it keeps this module in bundles. */
+function polyfillInstalled() {
+    return typeof polyfill_1.window === "object" && polyfill_1.window !== null;
+}
+//# sourceMappingURL=polyfill.js.map

package/dist/commonjs/apps/runtime/polyfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfill.js","sourceRoot":"","sources":["../../../../src/apps/runtime/polyfill.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAUH,8CAEC;AAVD,wDAAmE;AAK1D,6FALU,iBAAY,OAKV;AAJrB,6DAA4D;AAE5D,IAAA,yCAAoB,EAAC,iBAAY,CAAC,CAAC;AAInC,kGAAkG;AAClG,SAAgB,iBAAiB;IAC/B,OAAO,OAAO,iBAAY,KAAK,QAAQ,IAAI,iBAAY,KAAK,IAAI,CAAC;AACnE,CAAC"}

package/dist/commonjs/apps/runtime/provider.d.ts

@@ -0,0 +1,41 @@
+import { Component, type ErrorInfo, type ReactNode } from "react";
+import type { ExtensionContext } from "../context.js";
+import type { HostApi } from "../protocol.js";
+import { AppSession } from "./session.js";
+export interface ExtensionContextProviderProps {
+    context: ExtensionContext;
+    host: HostApi;
+    /** Supplied by the runtime. Omit it to get a standalone session (stories, custom harnesses). */
+    session?: AppSession;
+    /**
+     * Called after a render that carries a new `context` commits, once the session holds it. The
+     * runtime uses it to act on committed state only (dev-session console forwarding).
+     */
+    onCommit?: (context: ExtensionContext) => void;
+    children?: ReactNode;
+}
+/**
+ * Makes `context` and `host` available to `useExtensionContext()`, `useHostApi()` and
+ * `createAppClient()`. The runtime wraps every mounted view in one; you only render it
+ * yourself outside the sandbox.
+ */
+export declare function ExtensionContextProvider(props: ExtensionContextProviderProps): ReactNode;
+interface ViewErrorBoundaryProps {
+    onError: (error: unknown, info: ErrorInfo) => void;
+    children?: ReactNode;
+}
+/** Stops a throwing view from tearing down the root, and reports the error to the runtime. */
+export declare class ViewErrorBoundary extends Component<ViewErrorBoundaryProps, {
+    failed: boolean;
+}> {
+    state: {
+        failed: boolean;
+    };
+    static getDerivedStateFromError(): {
+        failed: boolean;
+    };
+    componentDidCatch(error: unknown, info: ErrorInfo): void;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/commonjs/apps/runtime/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/apps/runtime/provider.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAuE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACvI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAA4D,MAAM,cAAc,CAAC;AAEpG,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,gBAAgB,CAAC;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,gGAAgG;IAChG,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC/C,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,GAAG,SAAS,CAgCxF;AAED,UAAU,sBAAsB;IAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,8FAA8F;AAC9F,qBAAa,iBAAkB,SAAQ,SAAS,CAAC,sBAAsB,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;IAClF,KAAK;;MAAqB;IAEnC,MAAM,CAAC,wBAAwB,IAAI;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE;IAI7C,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAIxD,MAAM,IAAI,SAAS;CAG7B"}

package/dist/commonjs/apps/runtime/provider.js

@@ -0,0 +1,66 @@
+"use strict";
+/*
+ * Hand-written (not generated by Speakeasy). Third-party app developer kit (C10); see
+ * docs/third-party-apps/plan.md.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewErrorBoundary = void 0;
+exports.ExtensionContextProvider = ExtensionContextProvider;
+const react_1 = require("react");
+const session_js_1 = require("./session.js");
+/**
+ * Makes `context` and `host` available to `useExtensionContext()`, `useHostApi()` and
+ * `createAppClient()`. The runtime wraps every mounted view in one; you only render it
+ * yourself outside the sandbox.
+ */
+function ExtensionContextProvider(props) {
+    const { context, host, session: given, onCommit, children } = props;
+    // A standalone session is created once and then follows the `context` and `host` props, so
+    // `useHostApi()` and token refreshes always reach the current host.
+    const standalone = (0, react_1.useRef)(null);
+    let session = given;
+    if (!session) {
+        standalone.current ?? (standalone.current = new session_js_1.AppSession("standalone", context, host));
+        session = standalone.current;
+    }
+    // During render, only make `context` findable, so children rendering with it (and calling
+    // `createAppClient(ctx)`) reach this session. The session itself changes only once this
+    // render commits: a suspended or abandoned render must not hand its tokens or host to clients
+    // that already committed. An insertion effect runs before every layout and passive effect of
+    // the commit, so no child effect sees the previous context.
+    (0, session_js_1.registerContext)(context, session);
+    (0, react_1.useInsertionEffect)(() => {
+        if (session.context !== context)
+            session.setContext(context);
+        if (session.host !== host)
+            session.setHost(host);
+    }, [session, context, host]);
+    // Read through a ref so a new callback identity alone does not count as a commit.
+    const onCommitRef = (0, react_1.useRef)(onCommit);
+    (0, react_1.useLayoutEffect)(() => {
+        onCommitRef.current = onCommit;
+    });
+    (0, react_1.useLayoutEffect)(() => {
+        onCommitRef.current?.(context);
+    }, [context]);
+    const value = (0, react_1.useMemo)(() => ({ session, context, host }), [session, context, host]);
+    return (0, react_1.createElement)(session_js_1.AppSessionContext.Provider, { value }, children);
+}
+/** Stops a throwing view from tearing down the root, and reports the error to the runtime. */
+class ViewErrorBoundary extends react_1.Component {
+    constructor() {
+        super(...arguments);
+        this.state = { failed: false };
+    }
+    static getDerivedStateFromError() {
+        return { failed: true };
+    }
+    componentDidCatch(error, info) {
+        this.props.onError(error, info);
+    }
+    render() {
+        return this.state.failed ? null : this.props.children;
+    }
+}
+exports.ViewErrorBoundary = ViewErrorBoundary;
+//# sourceMappingURL=provider.js.map

package/dist/commonjs/apps/runtime/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/apps/runtime/provider.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAyBH,4DAgCC;AAvDD,iCAAuI;AAGvI,6CAAoG;AAepG;;;;GAIG;AACH,SAAgB,wBAAwB,CAAC,KAAoC;IAC3E,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAEpE,2FAA2F;IAC3F,oEAAoE;IACpE,MAAM,UAAU,GAAG,IAAA,cAAM,EAAoB,IAAI,CAAC,CAAC;IACnD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,UAAU,CAAC,OAAO,KAAlB,UAAU,CAAC,OAAO,GAAK,IAAI,uBAAU,CAAC,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAC;QACnE,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IAC/B,CAAC;IACD,0FAA0F;IAC1F,wFAAwF;IACxF,8FAA8F;IAC9F,6FAA6F;IAC7F,4DAA4D;IAC5D,IAAA,4BAAe,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClC,IAAA,0BAAkB,EAAC,GAAG,EAAE;QACtB,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO;YAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC7B,kFAAkF;IAClF,MAAM,WAAW,GAAG,IAAA,cAAM,EAAC,QAAQ,CAAC,CAAC;IACrC,IAAA,uBAAe,EAAC,GAAG,EAAE;QACnB,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,IAAA,uBAAe,EAAC,GAAG,EAAE;QACnB,WAAW,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,KAAK,GAAG,IAAA,eAAO,EAAkB,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACrG,OAAO,IAAA,qBAAa,EAAC,8BAAiB,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;AACxE,CAAC;AAOD,8FAA8F;AAC9F,MAAa,iBAAkB,SAAQ,iBAAsD;IAA7F;;QACW,UAAK,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAarC,CAAC;IAXC,MAAM,CAAC,wBAAwB;QAC7B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1B,CAAC;IAEQ,iBAAiB,CAAC,KAAc,EAAE,IAAe;QACxD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAEQ,MAAM;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IACxD,CAAC;CACF;AAdD,8CAcC"}

package/dist/commonjs/apps/runtime/react-dom-shims.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Installs the shims on `win` (the polyfilled window) and `globalThis`. Must run after the
+ * remote-dom polyfill, which provides `HTMLElement` and `Element`. Idempotent.
+ */
+export declare function installReactDomShims(win: object): void;
+//# sourceMappingURL=react-dom-shims.d.ts.map

package/dist/commonjs/apps/runtime/react-dom-shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-dom-shims.d.ts","sourceRoot":"","sources":["../../../../src/apps/runtime/react-dom-shims.ts"],"names":[],"mappings":"AA4CA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAwBtD"}

package/dist/commonjs/apps/runtime/react-dom-shims.js

@@ -0,0 +1,66 @@
+"use strict";
+/*
+ * Hand-written (not generated by Speakeasy). Third-party app developer kit (C10); see
+ * docs/third-party-apps/plan.md.
+ *
+ * The few globals react-dom probes for that the remote-dom DOM polyfill does not provide:
+ * `HTMLIFrameElement` (checked while react-dom finds the active element), `location` and
+ * `navigator` (read by development warnings), and `Element#style` (react-dom reads
+ * `document.createElement("div").style` at load). None of them does anything in the worker.
+ *
+ * This replaces `@remote-dom/react/polyfill`, which serves the same purpose. The SDK does not
+ * depend on `@remote-dom/react` because its peer range (`react ^17 || ^18`) makes React 19
+ * installs fail with ERESOLVE for every app author.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installReactDomShims = installReactDomShims;
+/** A style object that accepts and forgets every write. */
+class InertStyleDeclaration {
+    get cssText() {
+        return "";
+    }
+    set cssText(_value) { }
+    getPropertyValue(_name) {
+        return "";
+    }
+    setProperty(_name, _value, _priority) { }
+    removeProperty(_name) {
+        return "";
+    }
+}
+const STYLE = Symbol("gs-apps.style");
+function defineOnGlobals(targets, name, value) {
+    for (const target of targets) {
+        if (target[name] !== undefined)
+            continue;
+        Object.defineProperty(target, name, { value, configurable: true, writable: true });
+    }
+}
+/**
+ * Installs the shims on `win` (the polyfilled window) and `globalThis`. Must run after the
+ * remote-dom polyfill, which provides `HTMLElement` and `Element`. Idempotent.
+ */
+function installReactDomShims(win) {
+    const targets = win === globalThis ? [globalThis] : [win, globalThis];
+    const g = globalThis;
+    const HTMLElementCtor = g["HTMLElement"];
+    if (HTMLElementCtor && g["HTMLIFrameElement"] === undefined) {
+        defineOnGlobals(targets, "HTMLIFrameElement", class HTMLIFrameElement extends HTMLElementCtor {
+        });
+    }
+    defineOnGlobals(targets, "location", { protocol: "https:", href: "", origin: "null" });
+    defineOnGlobals(targets, "navigator", { userAgent: "" });
+    const ElementCtor = g["Element"];
+    if (ElementCtor && !Object.prototype.hasOwnProperty.call(ElementCtor.prototype, "style")) {
+        Object.defineProperty(ElementCtor.prototype, "style", {
+            configurable: true,
+            get() {
+                return (this[STYLE] ?? (this[STYLE] = new InertStyleDeclaration()));
+            },
+            set(value) {
+                this.style.cssText = String(value);
+            },
+        });
+    }
+}
+//# sourceMappingURL=react-dom-shims.js.map

package/dist/commonjs/apps/runtime/react-dom-shims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-dom-shims.js","sourceRoot":"","sources":["../../../../src/apps/runtime/react-dom-shims.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAoCH,oDAwBC;AAxDD,2DAA2D;AAC3D,MAAM,qBAAqB;IACzB,IAAI,OAAO;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,OAAO,CAAC,MAAc,IAAG,CAAC;IAE9B,gBAAgB,CAAC,KAAa;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,WAAW,CAAC,KAAa,EAAE,MAAqB,EAAE,SAAkB,IAAS,CAAC;IAE9E,cAAc,CAAC,KAAa;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AAEtC,SAAS,eAAe,CAAC,OAA0B,EAAE,IAAY,EAAE,KAAc;IAC/E,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAK,MAAoB,CAAC,IAAI,CAAC,KAAK,SAAS;YAAE,SAAS;QACxD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,GAAW;IAC9C,MAAM,OAAO,GAAG,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACtE,MAAM,CAAC,GAAG,UAAkC,CAAC;IAE7C,MAAM,eAAe,GAAG,CAAC,CAAC,aAAa,CAA4C,CAAC;IACpF,IAAI,eAAe,IAAI,CAAC,CAAC,mBAAmB,CAAC,KAAK,SAAS,EAAE,CAAC;QAC5D,eAAe,CAAC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAkB,SAAS,eAAoC;SAAG,CAAC,CAAC;IAC1H,CAAC;IAED,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvF,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,WAAW,GAAG,CAAC,CAAC,SAAS,CAAsC,CAAC;IACtE,IAAI,WAAW,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC;QACzF,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE;YACpD,YAAY,EAAE,IAAI;YAClB,GAAG;gBACD,OAAO,CAAC,IAAI,CAAC,KAAK,MAAV,IAAI,CAAC,KAAK,IAAM,IAAI,qBAAqB,EAAE,EAAC,CAAC;YACvD,CAAC;YACD,GAAG,CAAyC,KAAc;gBACxD,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/commonjs/apps/runtime/sandbox.d.ts

@@ -0,0 +1,30 @@
+import { type ComponentType } from "react";
+import type { SandboxExports } from "../protocol.js";
+import { type LogEnvelope } from "./console.js";
+/** Milliseconds between mutation flushes to the host (about one frame). */
+export declare const MUTATION_BATCH_MS = 16;
+export interface AppDefinition {
+    /**
+     * The views this bundle can render, keyed by the component name the manifest's
+     * `ui_extensions.views[].component` refers to.
+     */
+    views: Record<string, ComponentType>;
+}
+export interface SandboxRuntimeOptions {
+    /** How queued mutations are flushed. Defaults to a {@link MUTATION_BATCH_MS} timer. */
+    batch?: (flush: () => void) => void;
+    /** Called for errors thrown by a view after it mounted, and for failed host calls. */
+    onError?: (error: unknown, info: {
+        mountId: string;
+        phase: "render" | "connection";
+    }) => void;
+    /** Where dev-session logs go. Without it, `console` is not forwarded. */
+    postLog?: (envelope: LogEnvelope) => void;
+}
+export interface SandboxRuntime extends SandboxExports {
+    /** Ids of the views currently mounted. */
+    mountIds(): string[];
+}
+export declare function validateViews(views: Record<string, ComponentType>): void;
+export declare function createSandboxExports(definition: AppDefinition, options?: SandboxRuntimeOptions): SandboxRuntime;
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/commonjs/apps/runtime/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../../../src/apps/runtime/sandbox.ts"],"names":[],"mappings":"AAUA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAK1D,OAAO,KAAK,EAA6B,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhE,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,uFAAuF;IACvF,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpC,sFAAsF;IACtF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,GAAG,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IAC9F,yEAAyE;IACzE,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;CAC3C;AAgBD,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,0CAA0C;IAC1C,QAAQ,IAAI,MAAM,EAAE,CAAC;CACtB;AAMD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI,CAQxE;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAgJnH"}