@immediately-run/sdk 0.2.5 → 0.2.7

package/dist/index.cjs

@@ -30,6 +30,7 @@ __reExport(index_exports, require("./contribute"), module.exports);
 __reExport(index_exports, require("./catalog"), module.exports);
 __reExport(index_exports, require("./ipc"), module.exports);
 __reExport(index_exports, require("./tasks"), module.exports);
+__reExport(index_exports, require("./runtime"), module.exports);
 __reExport(index_exports, require("./protocolStream"), module.exports);
 __reExport(index_exports, require("./sandboxTypes"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
@@ -49,6 +50,7 @@ __reExport(index_exports, require("./sandboxTypes"), module.exports);
   ...require("./catalog"),
   ...require("./ipc"),
   ...require("./tasks"),
+  ...require("./runtime"),
   ...require("./protocolStream"),
   ...require("./sandboxTypes")
 });

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"./MDXProvider\";\nexport * from \"./routing\";\nexport * from \"./boot\";\nexport * from './components/Include';\nexport * from './components/MDXComponents';\nexport * from './hooks'\nexport * from './auth';\nexport * from './theme';\nexport * from './editorContext';\nexport * from './formFactor';\nexport * from './mounts';\nexport * from './contribute';\nexport * from './catalog';\nexport * from './ipc';\nexport * from './tasks';\nexport * from './protocolStream';\nexport * from './sandboxTypes';\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAAA,0BAAc,0BAAd;AACA,0BAAc,sBADd;AAEA,0BAAc,mBAFd;AAGA,0BAAc,iCAHd;AAIA,0BAAc,uCAJd;AAKA,0BAAc,oBALd;AAMA,0BAAc,mBANd;AAOA,0BAAc,oBAPd;AAQA,0BAAc,4BARd;AASA,0BAAc,yBATd;AAUA,0BAAc,qBAVd;AAWA,0BAAc,yBAXd;AAYA,0BAAc,sBAZd;AAaA,0BAAc,kBAbd;AAcA,0BAAc,oBAdd;AAeA,0BAAc,6BAfd;AAgBA,0BAAc,2BAhBd;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"./MDXProvider\";\nexport * from \"./routing\";\nexport * from \"./boot\";\nexport * from './components/Include';\nexport * from './components/MDXComponents';\nexport * from './hooks'\nexport * from './auth';\nexport * from './theme';\nexport * from './editorContext';\nexport * from './formFactor';\nexport * from './mounts';\nexport * from './contribute';\nexport * from './catalog';\nexport * from './ipc';\nexport * from './tasks';\nexport * from './runtime';\nexport * from './protocolStream';\nexport * from './sandboxTypes';\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAAA,0BAAc,0BAAd;AACA,0BAAc,sBADd;AAEA,0BAAc,mBAFd;AAGA,0BAAc,iCAHd;AAIA,0BAAc,uCAJd;AAKA,0BAAc,oBALd;AAMA,0BAAc,mBANd;AAOA,0BAAc,oBAPd;AAQA,0BAAc,4BARd;AASA,0BAAc,yBATd;AAUA,0BAAc,qBAVd;AAWA,0BAAc,yBAXd;AAYA,0BAAc,sBAZd;AAaA,0BAAc,kBAbd;AAcA,0BAAc,oBAdd;AAeA,0BAAc,sBAfd;AAgBA,0BAAc,6BAhBd;AAiBA,0BAAc,2BAjBd;","names":[]}

package/dist/index.d.cts

@@ -13,6 +13,7 @@ export { ContributeMode, ContributeOptions, ContributionEvent, ContributionResul
 export { ApiMethod, getCatalog, invoke, invokeStream, onCatalogChange, useCatalog } from './catalog.cjs';
 export { RegionMessage, onRegionMessage, postToRegion, useRegionMessage } from './ipc.cjs';
 export { FileCap, TaskInput, cancelTask, capFile, completeTask, getTaskInput, invokeTask, useTaskInput } from './tasks.cjs';
+export { ImmediatelyRunGlobal, SDK_PROTOCOL_VERSION, SDK_VERSION, SdkHandshake, announceHandshake, getHostRuntime, sdkHandshake } from './runtime.cjs';
 export { StreamError, StreamFrame, StreamTransport, consumeStream, protocolStream } from './protocolStream.cjs';
 export { EvaluationContext, FileQueryResult, FilesMetadata, Metadata, MetadataQueryFunction, MetadataQueryResult, ModuleExports } from './sandboxTypes.cjs';
 import 'react';

package/dist/index.d.ts

@@ -13,6 +13,7 @@ export { ContributeMode, ContributeOptions, ContributionEvent, ContributionResul
 export { ApiMethod, getCatalog, invoke, invokeStream, onCatalogChange, useCatalog } from './catalog.js';
 export { RegionMessage, onRegionMessage, postToRegion, useRegionMessage } from './ipc.js';
 export { FileCap, TaskInput, cancelTask, capFile, completeTask, getTaskInput, invokeTask, useTaskInput } from './tasks.js';
+export { ImmediatelyRunGlobal, SDK_PROTOCOL_VERSION, SDK_VERSION, SdkHandshake, announceHandshake, getHostRuntime, sdkHandshake } from './runtime.js';
 export { StreamError, StreamFrame, StreamTransport, consumeStream, protocolStream } from './protocolStream.js';
 export { EvaluationContext, FileQueryResult, FilesMetadata, Metadata, MetadataQueryFunction, MetadataQueryResult, ModuleExports } from './sandboxTypes.js';
 import 'react';

package/dist/index.js

@@ -13,6 +13,7 @@ export * from "./contribute";
 export * from "./catalog";
 export * from "./ipc";
 export * from "./tasks";
+export * from "./runtime";
 export * from "./protocolStream";
 export * from "./sandboxTypes";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"./MDXProvider\";\nexport * from \"./routing\";\nexport * from \"./boot\";\nexport * from './components/Include';\nexport * from './components/MDXComponents';\nexport * from './hooks'\nexport * from './auth';\nexport * from './theme';\nexport * from './editorContext';\nexport * from './formFactor';\nexport * from './mounts';\nexport * from './contribute';\nexport * from './catalog';\nexport * from './ipc';\nexport * from './tasks';\nexport * from './protocolStream';\nexport * from './sandboxTypes';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"./MDXProvider\";\nexport * from \"./routing\";\nexport * from \"./boot\";\nexport * from './components/Include';\nexport * from './components/MDXComponents';\nexport * from './hooks'\nexport * from './auth';\nexport * from './theme';\nexport * from './editorContext';\nexport * from './formFactor';\nexport * from './mounts';\nexport * from './contribute';\nexport * from './catalog';\nexport * from './ipc';\nexport * from './tasks';\nexport * from './runtime';\nexport * from './protocolStream';\nexport * from './sandboxTypes';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/runtime.cjs

@@ -0,0 +1,60 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var runtime_exports = {};
+__export(runtime_exports, {
+  SDK_PROTOCOL_VERSION: () => SDK_PROTOCOL_VERSION,
+  SDK_VERSION: () => SDK_VERSION,
+  announceHandshake: () => announceHandshake,
+  getHostRuntime: () => getHostRuntime,
+  sdkHandshake: () => sdkHandshake
+});
+module.exports = __toCommonJS(runtime_exports);
+var import_sandboxUtils = require("./sandboxUtils");
+const SDK_PROTOCOL_VERSION = "1.0.0";
+const SDK_VERSION = "0.2.7";
+function getHostRuntime() {
+  try {
+    return globalThis.__immediatelyRun__ ?? null;
+  } catch {
+    return null;
+  }
+}
+const sdkHandshake = () => ({
+  sdkVersion: SDK_VERSION,
+  protocolVersion: SDK_PROTOCOL_VERSION
+});
+function announceHandshake() {
+  const send = () => {
+    try {
+      (0, import_sandboxUtils.sendMessage)("sdk-handshake", sdkHandshake());
+    } catch {
+    }
+  };
+  send();
+  return (0, import_sandboxUtils.addListener)("request-handshake", send);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SDK_PROTOCOL_VERSION,
+  SDK_VERSION,
+  announceHandshake,
+  getHostRuntime,
+  sdkHandshake
+});
+//# sourceMappingURL=runtime.cjs.map

package/dist/runtime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime.ts"],"sourcesContent":["// Runtime discovery + version handshake (SDK_PACKAGING_SPEC §4/§6).\n//\n// Today the SDK reaches the host through the INJECTED sandbox services\n// (`module.evaluation.module.bundler.*`, see sandboxUtils). The packaging migration\n// makes the SDK an app-pinnable npm dependency that finds the runtime through a\n// stable, versioned global the sandbox publishes BEFORE evaluating app code:\n//\n//   globalThis.__immediatelyRun__ = { runtimeVersion, protocolVersion, transport }\n//\n// Phase 1 (behind a flag, injection still active): the SDK can READ that global\n// when present (else fall back to injection), and ANNOUNCE its own version +\n// protocol so the host can record + version-check it (§6/T45). The transport itself\n// is unchanged here — this only wires the discovery + handshake fields so the check\n// exists when app-pinned versions become real.\nimport { sendMessage, addListener } from './sandboxUtils';\n\n/** The wire protocol (postMessage envelope / channels / methods) THIS SDK speaks.\n *  Additive-only (§9); bump only for a backwards-compatible extension. */\nexport const SDK_PROTOCOL_VERSION = '1.0.0';\n\n/** This SDK's package version. Kept in step with package.json (a build step can\n *  inject it later; a constant is fine while versions are still effectively fixed). */\nexport const SDK_VERSION = '0.2.7';\n\n/** The sandbox runtime's pre-evaluation discovery global (§4). */\nexport interface ImmediatelyRunGlobal {\n  /** Sandbox-runtime protocol version (semver). */\n  runtimeVersion?: string;\n  /** postMessage envelope/protocol version. */\n  protocolVersion?: string;\n  /** The host channel the SDK talks over (MessagePort | message bus). */\n  transport?: unknown;\n  /** Resolves when ports arrive, if they arrive async after register-frame. */\n  ready?: Promise<void>;\n}\n\n/**\n * Read the sandbox runtime's discovery global (§4), or null when absent — in which\n * case the SDK uses the current INJECTED path (`module.evaluation.*`). Lets the SDK\n * detect a host too old/new and fail closed (§6) once the global ships.\n */\nexport function getHostRuntime(): ImmediatelyRunGlobal | null {\n  try {\n    return (globalThis as { __immediatelyRun__?: ImmediatelyRunGlobal }).__immediatelyRun__ ?? null;\n  } catch {\n    return null;\n  }\n}\n\n/** This SDK's handshake payload — the version + protocol the host records + checks\n *  against `HOST_PROTOCOL_VERSION` (§6/T45). */\nexport interface SdkHandshake {\n  sdkVersion: string;\n  protocolVersion: string;\n}\nexport const sdkHandshake = (): SdkHandshake => ({\n  sdkVersion: SDK_VERSION,\n  protocolVersion: SDK_PROTOCOL_VERSION,\n});\n\n/**\n * Announce this SDK's version to the host (§6). Sends `sdk-handshake` eagerly\n * (best-effort — the host may already be listening) AND replies to a host\n * `request-handshake` (the robust path, mirroring the other `request-*` pulls).\n * Idempotent; safe to call more than once. Returns an unsubscribe fn.\n */\nexport function announceHandshake(): () => void {\n  const send = () => {\n    try {\n      sendMessage('sdk-handshake', sdkHandshake() as unknown as Record<string, unknown>);\n    } catch {\n      /* transport not ready yet — the request-handshake reply covers it */\n    }\n  };\n  send();\n  return addListener('request-handshake', send);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAcA,0BAAyC;AAIlC,MAAM,uBAAuB;AAI7B,MAAM,cAAc;AAmBpB,SAAS,iBAA8C;AAC5D,MAAI;AACF,WAAQ,WAA6D,sBAAsB;AAAA,EAC7F,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAQO,MAAM,eAAe,OAAqB;AAAA,EAC/C,YAAY;AAAA,EACZ,iBAAiB;AACnB;AAQO,SAAS,oBAAgC;AAC9C,QAAM,OAAO,MAAM;AACjB,QAAI;AACF,2CAAY,iBAAiB,aAAa,CAAuC;AAAA,IACnF,QAAQ;AAAA,IAER;AAAA,EACF;AACA,OAAK;AACL,aAAO,iCAAY,qBAAqB,IAAI;AAC9C;","names":[]}

package/dist/runtime.d.cts

@@ -0,0 +1,39 @@
+/** The wire protocol (postMessage envelope / channels / methods) THIS SDK speaks.
+ *  Additive-only (§9); bump only for a backwards-compatible extension. */
+declare const SDK_PROTOCOL_VERSION = "1.0.0";
+/** This SDK's package version. Kept in step with package.json (a build step can
+ *  inject it later; a constant is fine while versions are still effectively fixed). */
+declare const SDK_VERSION = "0.2.7";
+/** The sandbox runtime's pre-evaluation discovery global (§4). */
+interface ImmediatelyRunGlobal {
+    /** Sandbox-runtime protocol version (semver). */
+    runtimeVersion?: string;
+    /** postMessage envelope/protocol version. */
+    protocolVersion?: string;
+    /** The host channel the SDK talks over (MessagePort | message bus). */
+    transport?: unknown;
+    /** Resolves when ports arrive, if they arrive async after register-frame. */
+    ready?: Promise<void>;
+}
+/**
+ * Read the sandbox runtime's discovery global (§4), or null when absent — in which
+ * case the SDK uses the current INJECTED path (`module.evaluation.*`). Lets the SDK
+ * detect a host too old/new and fail closed (§6) once the global ships.
+ */
+declare function getHostRuntime(): ImmediatelyRunGlobal | null;
+/** This SDK's handshake payload — the version + protocol the host records + checks
+ *  against `HOST_PROTOCOL_VERSION` (§6/T45). */
+interface SdkHandshake {
+    sdkVersion: string;
+    protocolVersion: string;
+}
+declare const sdkHandshake: () => SdkHandshake;
+/**
+ * Announce this SDK's version to the host (§6). Sends `sdk-handshake` eagerly
+ * (best-effort — the host may already be listening) AND replies to a host
+ * `request-handshake` (the robust path, mirroring the other `request-*` pulls).
+ * Idempotent; safe to call more than once. Returns an unsubscribe fn.
+ */
+declare function announceHandshake(): () => void;
+
+export { type ImmediatelyRunGlobal, SDK_PROTOCOL_VERSION, SDK_VERSION, type SdkHandshake, announceHandshake, getHostRuntime, sdkHandshake };

package/dist/runtime.d.ts

@@ -0,0 +1,39 @@
+/** The wire protocol (postMessage envelope / channels / methods) THIS SDK speaks.
+ *  Additive-only (§9); bump only for a backwards-compatible extension. */
+declare const SDK_PROTOCOL_VERSION = "1.0.0";
+/** This SDK's package version. Kept in step with package.json (a build step can
+ *  inject it later; a constant is fine while versions are still effectively fixed). */
+declare const SDK_VERSION = "0.2.7";
+/** The sandbox runtime's pre-evaluation discovery global (§4). */
+interface ImmediatelyRunGlobal {
+    /** Sandbox-runtime protocol version (semver). */
+    runtimeVersion?: string;
+    /** postMessage envelope/protocol version. */
+    protocolVersion?: string;
+    /** The host channel the SDK talks over (MessagePort | message bus). */
+    transport?: unknown;
+    /** Resolves when ports arrive, if they arrive async after register-frame. */
+    ready?: Promise<void>;
+}
+/**
+ * Read the sandbox runtime's discovery global (§4), or null when absent — in which
+ * case the SDK uses the current INJECTED path (`module.evaluation.*`). Lets the SDK
+ * detect a host too old/new and fail closed (§6) once the global ships.
+ */
+declare function getHostRuntime(): ImmediatelyRunGlobal | null;
+/** This SDK's handshake payload — the version + protocol the host records + checks
+ *  against `HOST_PROTOCOL_VERSION` (§6/T45). */
+interface SdkHandshake {
+    sdkVersion: string;
+    protocolVersion: string;
+}
+declare const sdkHandshake: () => SdkHandshake;
+/**
+ * Announce this SDK's version to the host (§6). Sends `sdk-handshake` eagerly
+ * (best-effort — the host may already be listening) AND replies to a host
+ * `request-handshake` (the robust path, mirroring the other `request-*` pulls).
+ * Idempotent; safe to call more than once. Returns an unsubscribe fn.
+ */
+declare function announceHandshake(): () => void;
+
+export { type ImmediatelyRunGlobal, SDK_PROTOCOL_VERSION, SDK_VERSION, type SdkHandshake, announceHandshake, getHostRuntime, sdkHandshake };

package/dist/runtime.js

@@ -0,0 +1,32 @@
+import { sendMessage, addListener } from "./sandboxUtils";
+const SDK_PROTOCOL_VERSION = "1.0.0";
+const SDK_VERSION = "0.2.7";
+function getHostRuntime() {
+  try {
+    return globalThis.__immediatelyRun__ ?? null;
+  } catch {
+    return null;
+  }
+}
+const sdkHandshake = () => ({
+  sdkVersion: SDK_VERSION,
+  protocolVersion: SDK_PROTOCOL_VERSION
+});
+function announceHandshake() {
+  const send = () => {
+    try {
+      sendMessage("sdk-handshake", sdkHandshake());
+    } catch {
+    }
+  };
+  send();
+  return addListener("request-handshake", send);
+}
+export {
+  SDK_PROTOCOL_VERSION,
+  SDK_VERSION,
+  announceHandshake,
+  getHostRuntime,
+  sdkHandshake
+};
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime.ts"],"sourcesContent":["// Runtime discovery + version handshake (SDK_PACKAGING_SPEC §4/§6).\n//\n// Today the SDK reaches the host through the INJECTED sandbox services\n// (`module.evaluation.module.bundler.*`, see sandboxUtils). The packaging migration\n// makes the SDK an app-pinnable npm dependency that finds the runtime through a\n// stable, versioned global the sandbox publishes BEFORE evaluating app code:\n//\n//   globalThis.__immediatelyRun__ = { runtimeVersion, protocolVersion, transport }\n//\n// Phase 1 (behind a flag, injection still active): the SDK can READ that global\n// when present (else fall back to injection), and ANNOUNCE its own version +\n// protocol so the host can record + version-check it (§6/T45). The transport itself\n// is unchanged here — this only wires the discovery + handshake fields so the check\n// exists when app-pinned versions become real.\nimport { sendMessage, addListener } from './sandboxUtils';\n\n/** The wire protocol (postMessage envelope / channels / methods) THIS SDK speaks.\n *  Additive-only (§9); bump only for a backwards-compatible extension. */\nexport const SDK_PROTOCOL_VERSION = '1.0.0';\n\n/** This SDK's package version. Kept in step with package.json (a build step can\n *  inject it later; a constant is fine while versions are still effectively fixed). */\nexport const SDK_VERSION = '0.2.7';\n\n/** The sandbox runtime's pre-evaluation discovery global (§4). */\nexport interface ImmediatelyRunGlobal {\n  /** Sandbox-runtime protocol version (semver). */\n  runtimeVersion?: string;\n  /** postMessage envelope/protocol version. */\n  protocolVersion?: string;\n  /** The host channel the SDK talks over (MessagePort | message bus). */\n  transport?: unknown;\n  /** Resolves when ports arrive, if they arrive async after register-frame. */\n  ready?: Promise<void>;\n}\n\n/**\n * Read the sandbox runtime's discovery global (§4), or null when absent — in which\n * case the SDK uses the current INJECTED path (`module.evaluation.*`). Lets the SDK\n * detect a host too old/new and fail closed (§6) once the global ships.\n */\nexport function getHostRuntime(): ImmediatelyRunGlobal | null {\n  try {\n    return (globalThis as { __immediatelyRun__?: ImmediatelyRunGlobal }).__immediatelyRun__ ?? null;\n  } catch {\n    return null;\n  }\n}\n\n/** This SDK's handshake payload — the version + protocol the host records + checks\n *  against `HOST_PROTOCOL_VERSION` (§6/T45). */\nexport interface SdkHandshake {\n  sdkVersion: string;\n  protocolVersion: string;\n}\nexport const sdkHandshake = (): SdkHandshake => ({\n  sdkVersion: SDK_VERSION,\n  protocolVersion: SDK_PROTOCOL_VERSION,\n});\n\n/**\n * Announce this SDK's version to the host (§6). Sends `sdk-handshake` eagerly\n * (best-effort — the host may already be listening) AND replies to a host\n * `request-handshake` (the robust path, mirroring the other `request-*` pulls).\n * Idempotent; safe to call more than once. Returns an unsubscribe fn.\n */\nexport function announceHandshake(): () => void {\n  const send = () => {\n    try {\n      sendMessage('sdk-handshake', sdkHandshake() as unknown as Record<string, unknown>);\n    } catch {\n      /* transport not ready yet — the request-handshake reply covers it */\n    }\n  };\n  send();\n  return addListener('request-handshake', send);\n}\n"],"mappings":"AAcA,SAAS,aAAa,mBAAmB;AAIlC,MAAM,uBAAuB;AAI7B,MAAM,cAAc;AAmBpB,SAAS,iBAA8C;AAC5D,MAAI;AACF,WAAQ,WAA6D,sBAAsB;AAAA,EAC7F,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAQO,MAAM,eAAe,OAAqB;AAAA,EAC/C,YAAY;AAAA,EACZ,iBAAiB;AACnB;AAQO,SAAS,oBAAgC;AAC9C,QAAM,OAAO,MAAM;AACjB,QAAI;AACF,kBAAY,iBAAiB,aAAa,CAAuC;AAAA,IACnF,QAAQ;AAAA,IAER;AAAA,EACF;AACA,OAAK;AACL,SAAO,YAAY,qBAAqB,IAAI;AAC9C;","names":[]}

package/dist/sandboxUtils.cjs

@@ -23,14 +23,24 @@ __export(sandboxUtils_exports, {
   sendMessage: () => sendMessage
 });
 module.exports = __toCommonJS(sandboxUtils_exports);
+var import_runtime = require("./runtime");
+function transport() {
+  try {
+    const injected = module?.evaluation?.module?.bundler?.messageBus;
+    if (injected && typeof injected.sendMessage === "function") return injected;
+  } catch {
+  }
+  const t = (0, import_runtime.getHostRuntime)()?.transport;
+  if (t && typeof t.sendMessage === "function") return t;
+  throw new Error("immediately.run: no host transport (neither injected nor __immediatelyRun__)");
+}
 const sendMessage = (type, data = {}) => {
-  module.evaluation.module.bundler.messageBus.sendMessage(type, data);
-};
-const protocolRequest = (protocolName, method, params) => {
-  return module.evaluation.module.bundler.messageBus.protocolRequest(protocolName, method, params);
+  transport().sendMessage(type, data);
 };
+const protocolRequest = (protocolName, method, params) => transport().protocolRequest(protocolName, method, params);
 const addListener = (msgType, handler, event) => {
-  const disposable = (event ?? module.evaluation.module.bundler.messageBus.onMessage)((msg) => {
+  const onMessage = event ?? transport().onMessage;
+  const disposable = onMessage((msg) => {
     if (msg.type === msgType) {
       handler(msg);
     }

package/dist/sandboxUtils.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/sandboxUtils.ts"],"sourcesContent":["export const sendMessage = (type: string, data: Record<string, any> = {}) => {\n  // module.evaluation is defined in the sandbox environment\n  // @ts-ignore\n  module.evaluation.module.bundler.messageBus.sendMessage(type, data);\n}\n\nexport const protocolRequest = (protocolName: string, method: string, params: Array<any>): Promise<any> => {\n  // example usage: const response = await protocolRequest('fs', 'readFile', [path]);\n  // module.evaluation is defined in the sandbox environment\n  // @ts-ignore\n  return module.evaluation.module.bundler.messageBus.protocolRequest(protocolName, method, params);\n}\n\nexport const addListener = (msgType: string, handler: (msg:any)=>void, event?:any):(() => void) => {\n  // @ts-ignore\n  const disposable = (event ?? module.evaluation.module.bundler.messageBus.onMessage)((msg) => {\n    if (msg.type === msgType) {\n      handler(msg);\n    }\n  });\n  return () => disposable.dispose();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,MAAM,cAAc,CAAC,MAAc,OAA4B,CAAC,MAAM;AAG3E,SAAO,WAAW,OAAO,QAAQ,WAAW,YAAY,MAAM,IAAI;AACpE;AAEO,MAAM,kBAAkB,CAAC,cAAsB,QAAgB,WAAqC;AAIzG,SAAO,OAAO,WAAW,OAAO,QAAQ,WAAW,gBAAgB,cAAc,QAAQ,MAAM;AACjG;AAEO,MAAM,cAAc,CAAC,SAAiB,SAA0B,UAA4B;AAEjG,QAAM,cAAc,SAAS,OAAO,WAAW,OAAO,QAAQ,WAAW,WAAW,CAAC,QAAQ;AAC3F,QAAI,IAAI,SAAS,SAAS;AACxB,cAAQ,GAAG;AAAA,IACb;AAAA,EACF,CAAC;AACD,SAAO,MAAM,WAAW,QAAQ;AAClC;","names":[]}
+{"version":3,"sources":["../src/sandboxUtils.ts"],"sourcesContent":["// Host transport access (SDK_PACKAGING_SPEC §4, expose-transport). All host comms\n// (sendMessage / protocolRequest / onMessage) go through ONE resolver so the SDK is\n// transport-agnostic: it works whether it was INJECTED into the bundler's evaluation\n// context (the current path — `module.evaluation.module.bundler.messageBus`) OR\n// fetched from npm as an ordinary dependency, in which case the sandbox runtime hands\n// it the transport via the §4 discovery global (`globalThis.__immediatelyRun__`).\n//\n// Dual-mode (§8): injection wins while it's active, so existing behaviour is\n// byte-for-byte preserved; the global is the fallback the npm-fetched SDK uses. When\n// injection is removed (phase 3), only the global path remains — `bundler.*` stops\n// being API, which is the whole point.\nimport { getHostRuntime } from './runtime';\n\ninterface HostTransport {\n  sendMessage(type: string, data?: Record<string, any>): void;\n  protocolRequest(protocolName: string, method: string, params: Array<any>): Promise<any>;\n  onMessage(handler: (msg: any) => void): { dispose(): void };\n}\n\nfunction transport(): HostTransport {\n  // Injected bundler messageBus first — the current path, unchanged.\n  try {\n    // @ts-ignore - `module.evaluation` is injected by the sandbox runtime\n    const injected = module?.evaluation?.module?.bundler?.messageBus;\n    if (injected && typeof injected.sendMessage === 'function') return injected;\n  } catch {\n    /* no injection in this realm — fall through to the §4 global */\n  }\n  // §4 runtime-discovery transport (the npm-fetched SDK path).\n  const t = getHostRuntime()?.transport as HostTransport | undefined;\n  if (t && typeof t.sendMessage === 'function') return t;\n  throw new Error('immediately.run: no host transport (neither injected nor __immediatelyRun__)');\n}\n\nexport const sendMessage = (type: string, data: Record<string, any> = {}) => {\n  transport().sendMessage(type, data);\n};\n\nexport const protocolRequest = (\n  protocolName: string,\n  method: string,\n  params: Array<any>,\n): Promise<any> => transport().protocolRequest(protocolName, method, params);\n\nexport const addListener = (\n  msgType: string,\n  handler: (msg: any) => void,\n  event?: any,\n): (() => void) => {\n  const onMessage = event ?? transport().onMessage;\n  const disposable = onMessage((msg: any) => {\n    if (msg.type === msgType) {\n      handler(msg);\n    }\n  });\n  return () => disposable.dispose();\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWA,qBAA+B;AAQ/B,SAAS,YAA2B;AAElC,MAAI;AAEF,UAAM,WAAW,QAAQ,YAAY,QAAQ,SAAS;AACtD,QAAI,YAAY,OAAO,SAAS,gBAAgB,WAAY,QAAO;AAAA,EACrE,QAAQ;AAAA,EAER;AAEA,QAAM,QAAI,+BAAe,GAAG;AAC5B,MAAI,KAAK,OAAO,EAAE,gBAAgB,WAAY,QAAO;AACrD,QAAM,IAAI,MAAM,8EAA8E;AAChG;AAEO,MAAM,cAAc,CAAC,MAAc,OAA4B,CAAC,MAAM;AAC3E,YAAU,EAAE,YAAY,MAAM,IAAI;AACpC;AAEO,MAAM,kBAAkB,CAC7B,cACA,QACA,WACiB,UAAU,EAAE,gBAAgB,cAAc,QAAQ,MAAM;AAEpE,MAAM,cAAc,CACzB,SACA,SACA,UACiB;AACjB,QAAM,YAAY,SAAS,UAAU,EAAE;AACvC,QAAM,aAAa,UAAU,CAAC,QAAa;AACzC,QAAI,IAAI,SAAS,SAAS;AACxB,cAAQ,GAAG;AAAA,IACb;AAAA,EACF,CAAC;AACD,SAAO,MAAM,WAAW,QAAQ;AAClC;","names":[]}

package/dist/sandboxUtils.js

@@ -1,11 +1,21 @@
+import { getHostRuntime } from "./runtime";
+function transport() {
+  try {
+    const injected = module?.evaluation?.module?.bundler?.messageBus;
+    if (injected && typeof injected.sendMessage === "function") return injected;
+  } catch {
+  }
+  const t = getHostRuntime()?.transport;
+  if (t && typeof t.sendMessage === "function") return t;
+  throw new Error("immediately.run: no host transport (neither injected nor __immediatelyRun__)");
+}
 const sendMessage = (type, data = {}) => {
-  module.evaluation.module.bundler.messageBus.sendMessage(type, data);
-};
-const protocolRequest = (protocolName, method, params) => {
-  return module.evaluation.module.bundler.messageBus.protocolRequest(protocolName, method, params);
+  transport().sendMessage(type, data);
 };
+const protocolRequest = (protocolName, method, params) => transport().protocolRequest(protocolName, method, params);
 const addListener = (msgType, handler, event) => {
-  const disposable = (event ?? module.evaluation.module.bundler.messageBus.onMessage)((msg) => {
+  const onMessage = event ?? transport().onMessage;
+  const disposable = onMessage((msg) => {
     if (msg.type === msgType) {
       handler(msg);
     }

package/dist/sandboxUtils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/sandboxUtils.ts"],"sourcesContent":["export const sendMessage = (type: string, data: Record<string, any> = {}) => {\n  // module.evaluation is defined in the sandbox environment\n  // @ts-ignore\n  module.evaluation.module.bundler.messageBus.sendMessage(type, data);\n}\n\nexport const protocolRequest = (protocolName: string, method: string, params: Array<any>): Promise<any> => {\n  // example usage: const response = await protocolRequest('fs', 'readFile', [path]);\n  // module.evaluation is defined in the sandbox environment\n  // @ts-ignore\n  return module.evaluation.module.bundler.messageBus.protocolRequest(protocolName, method, params);\n}\n\nexport const addListener = (msgType: string, handler: (msg:any)=>void, event?:any):(() => void) => {\n  // @ts-ignore\n  const disposable = (event ?? module.evaluation.module.bundler.messageBus.onMessage)((msg) => {\n    if (msg.type === msgType) {\n      handler(msg);\n    }\n  });\n  return () => disposable.dispose();\n}\n"],"mappings":"AAAO,MAAM,cAAc,CAAC,MAAc,OAA4B,CAAC,MAAM;AAG3E,SAAO,WAAW,OAAO,QAAQ,WAAW,YAAY,MAAM,IAAI;AACpE;AAEO,MAAM,kBAAkB,CAAC,cAAsB,QAAgB,WAAqC;AAIzG,SAAO,OAAO,WAAW,OAAO,QAAQ,WAAW,gBAAgB,cAAc,QAAQ,MAAM;AACjG;AAEO,MAAM,cAAc,CAAC,SAAiB,SAA0B,UAA4B;AAEjG,QAAM,cAAc,SAAS,OAAO,WAAW,OAAO,QAAQ,WAAW,WAAW,CAAC,QAAQ;AAC3F,QAAI,IAAI,SAAS,SAAS;AACxB,cAAQ,GAAG;AAAA,IACb;AAAA,EACF,CAAC;AACD,SAAO,MAAM,WAAW,QAAQ;AAClC;","names":[]}
+{"version":3,"sources":["../src/sandboxUtils.ts"],"sourcesContent":["// Host transport access (SDK_PACKAGING_SPEC §4, expose-transport). All host comms\n// (sendMessage / protocolRequest / onMessage) go through ONE resolver so the SDK is\n// transport-agnostic: it works whether it was INJECTED into the bundler's evaluation\n// context (the current path — `module.evaluation.module.bundler.messageBus`) OR\n// fetched from npm as an ordinary dependency, in which case the sandbox runtime hands\n// it the transport via the §4 discovery global (`globalThis.__immediatelyRun__`).\n//\n// Dual-mode (§8): injection wins while it's active, so existing behaviour is\n// byte-for-byte preserved; the global is the fallback the npm-fetched SDK uses. When\n// injection is removed (phase 3), only the global path remains — `bundler.*` stops\n// being API, which is the whole point.\nimport { getHostRuntime } from './runtime';\n\ninterface HostTransport {\n  sendMessage(type: string, data?: Record<string, any>): void;\n  protocolRequest(protocolName: string, method: string, params: Array<any>): Promise<any>;\n  onMessage(handler: (msg: any) => void): { dispose(): void };\n}\n\nfunction transport(): HostTransport {\n  // Injected bundler messageBus first — the current path, unchanged.\n  try {\n    // @ts-ignore - `module.evaluation` is injected by the sandbox runtime\n    const injected = module?.evaluation?.module?.bundler?.messageBus;\n    if (injected && typeof injected.sendMessage === 'function') return injected;\n  } catch {\n    /* no injection in this realm — fall through to the §4 global */\n  }\n  // §4 runtime-discovery transport (the npm-fetched SDK path).\n  const t = getHostRuntime()?.transport as HostTransport | undefined;\n  if (t && typeof t.sendMessage === 'function') return t;\n  throw new Error('immediately.run: no host transport (neither injected nor __immediatelyRun__)');\n}\n\nexport const sendMessage = (type: string, data: Record<string, any> = {}) => {\n  transport().sendMessage(type, data);\n};\n\nexport const protocolRequest = (\n  protocolName: string,\n  method: string,\n  params: Array<any>,\n): Promise<any> => transport().protocolRequest(protocolName, method, params);\n\nexport const addListener = (\n  msgType: string,\n  handler: (msg: any) => void,\n  event?: any,\n): (() => void) => {\n  const onMessage = event ?? transport().onMessage;\n  const disposable = onMessage((msg: any) => {\n    if (msg.type === msgType) {\n      handler(msg);\n    }\n  });\n  return () => disposable.dispose();\n};\n"],"mappings":"AAWA,SAAS,sBAAsB;AAQ/B,SAAS,YAA2B;AAElC,MAAI;AAEF,UAAM,WAAW,QAAQ,YAAY,QAAQ,SAAS;AACtD,QAAI,YAAY,OAAO,SAAS,gBAAgB,WAAY,QAAO;AAAA,EACrE,QAAQ;AAAA,EAER;AAEA,QAAM,IAAI,eAAe,GAAG;AAC5B,MAAI,KAAK,OAAO,EAAE,gBAAgB,WAAY,QAAO;AACrD,QAAM,IAAI,MAAM,8EAA8E;AAChG;AAEO,MAAM,cAAc,CAAC,MAAc,OAA4B,CAAC,MAAM;AAC3E,YAAU,EAAE,YAAY,MAAM,IAAI;AACpC;AAEO,MAAM,kBAAkB,CAC7B,cACA,QACA,WACiB,UAAU,EAAE,gBAAgB,cAAc,QAAQ,MAAM;AAEpE,MAAM,cAAc,CACzB,SACA,SACA,UACiB;AACjB,QAAM,YAAY,SAAS,UAAU,EAAE;AACvC,QAAM,aAAa,UAAU,CAAC,QAAa;AACzC,QAAI,IAAI,SAAS,SAAS;AACxB,cAAQ,GAAG;AAAA,IACb;AAAA,EACF,CAAC;AACD,SAAO,MAAM,WAAW,QAAQ;AAClC;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@immediately-run/sdk",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Runtime SDK for code executing inside an immediately.run sandbox.",
   "license": "MIT",
   "repository": "github:immediately-run/immediately-run-sdk",