@iteraai/vite-plugin-react-inspector 0.1.0

package/README.md

@@ -0,0 +1,75 @@
+# `@iteraai/vite-plugin-react-inspector`
+
+Vite plugin for injecting the Itera React component inspector runtime into React-Vite apps.
+
+This package is the React-Vite integration surface for the Itera inspector. It reuses `@iteraai/react-component-inspector` and `@iteraai/inspector-protocol`; it does not replace the existing bridge or iteration runtime.
+
+## Installation
+
+```bash
+npm install @iteraai/vite-plugin-react-inspector @vitejs/plugin-react
+```
+
+Your app should already provide React and React DOM:
+
+- `react`: `^18.3.0 || ^19.0.0`
+- `react-dom`: `^18.3.0 || ^19.0.0`
+
+## Manual React-Vite Usage
+
+```ts
+import react from '@vitejs/plugin-react';
+import { defineConfig } from 'vite';
+import { createIteraReactInspectorVitePlugin } from '@iteraai/vite-plugin-react-inspector';
+
+export default defineConfig({
+  plugins: [createIteraReactInspectorVitePlugin(), react()],
+});
+```
+
+Enable it for local testing with Vite environment variables:
+
+```bash
+VITE_ITERA_COMPONENT_INSPECTOR_ENABLED=true \
+VITE_ITERA_COMPONENT_INSPECTOR_HOST_ORIGINS=https://app.iteradev.ai \
+npm run dev
+```
+
+You can also configure it directly:
+
+```ts
+createIteraReactInspectorVitePlugin({
+  enabled: true,
+  hostOrigins: ['https://app.iteradev.ai'],
+});
+```
+
+By default, the plugin only injects the runtime for Vite serve/dev mode. For an explicit local preview build, opt in to build HTML injection:
+
+```ts
+createIteraReactInspectorVitePlugin({
+  enabled: true,
+  hostOrigins: ['https://app.iteradev.ai'],
+  includeInBuild: true,
+});
+```
+
+Do not enable `includeInBuild` for normal production builds unless the build output is specifically intended to carry the inspector runtime.
+
+## API
+
+```ts
+createIteraReactInspectorVitePlugin(options?: {
+  enabled?: boolean;
+  hostOrigins?: readonly string[] | string;
+  includeInBuild?: boolean;
+})
+```
+
+The package also exports `iteraReactInspector` as a shorter alias for the same factory.
+
+The plugin-generated virtual module imports `@iteraai/vite-plugin-react-inspector/client` as a small browser runtime support entry. Application code should normally use the plugin factory instead of importing the client entry directly.
+
+When `enabled` is omitted, the plugin enables only when `VITE_ITERA_COMPONENT_INSPECTOR_ENABLED` is exactly `true`. Host origins can come from `hostOrigins` or the comma-separated `VITE_ITERA_COMPONENT_INSPECTOR_HOST_ORIGINS` value.
+
+If the inspector is enabled but no trusted host origins are available, the plugin warns and does not inject or start the bridge.

package/dist/client.d.ts

@@ -0,0 +1,8 @@
+export type IteraReactInspectorViteRuntimeOptions = {
+    enabled: boolean;
+    hostOrigins: readonly string[];
+    stateKey?: string;
+    warningPrefix?: string;
+};
+export declare const bootIteraReactInspectorViteRuntime: (options: IteraReactInspectorViteRuntimeOptions) => () => void;
+export declare const stopIteraReactInspectorViteRuntime: (options?: Pick<IteraReactInspectorViteRuntimeOptions, "stateKey">) => void;

package/dist/client.js

@@ -0,0 +1,135 @@
+import { INSPECTOR_CHANNEL as y } from "@iteraai/inspector-protocol";
+import { bootstrapEmbeddedInspectorBridge as m } from "@iteraai/react-component-inspector/embeddedBootstrap";
+const g = "__ITERA_REACT_INSPECTOR_VITE_BOOTSTRAP__", h = "[itera-vite-plugin-react-inspector]", c = (e) => e, A = (e) => ({
+  enabled: e.enabled,
+  hostOrigins: e.hostOrigins,
+  stateKey: e.stateKey ?? g,
+  warningPrefix: e.warningPrefix ?? h
+}), E = (e, t) => c(e)[t], f = (e, t, n) => {
+  c(e)[t] = n;
+}, T = (e, t) => {
+  delete c(e)[t];
+}, p = (e, t, n = void 0) => {
+  if (n === void 0) {
+    console.warn(`${e} ${t}`);
+    return;
+  }
+  console.warn(`${e} ${t}`, n);
+}, v = (e, t, n) => {
+  const r = E(e, t);
+  if (!(n !== void 0 && (r == null ? void 0 : r.ownerToken) !== n)) {
+    if (typeof (r == null ? void 0 : r.stop) == "function") {
+      r.stop();
+      return;
+    }
+    (r == null ? void 0 : r.starting) === !0 && T(e, t);
+  }
+}, R = (e) => {
+  try {
+    return new URL(e).origin;
+  } catch {
+    return;
+  }
+}, N = (e, t) => {
+  const n = R(e);
+  return n !== void 0 && t.some((r) => R(r) === n);
+}, _ = (e) => typeof e == "object" && e !== null, b = (e) => {
+  if (typeof e == "string")
+    try {
+      const t = JSON.parse(e);
+      return _(t) ? t : void 0;
+    } catch {
+      return;
+    }
+  return _(e) ? e : void 0;
+}, P = (e) => {
+  const t = b(e);
+  return (t == null ? void 0 : t.channel) === y;
+}, S = (e) => new MessageEvent("message", {
+  data: e.data,
+  origin: e.origin,
+  lastEventId: e.lastEventId,
+  source: e.source,
+  ports: [...e.ports]
+}), K = (e, t) => {
+  const n = [], r = (o) => {
+    !N(o.origin, t) || !P(o.data) || n.push(o);
+  };
+  return e.addEventListener("message", r), {
+    dispose: () => {
+      e.removeEventListener("message", r);
+    },
+    replay: () => {
+      e.removeEventListener("message", r), n.forEach((o) => {
+        e.dispatchEvent(S(o));
+      }), n.length = 0;
+    }
+  };
+}, L = async (e, t, n, r) => {
+  const o = E(e, t.stateKey);
+  if ((o == null ? void 0 : o.started) === !0 || (o == null ? void 0 : o.starting) === !0 || !t.enabled)
+    return;
+  if (t.hostOrigins.length === 0) {
+    p(
+      t.warningPrefix,
+      "Inspector is enabled but no trusted host origins are configured."
+    );
+    return;
+  }
+  const I = K(
+    e,
+    t.hostOrigins
+  );
+  let d, s, u = !1, l = !1;
+  const i = () => {
+    var a;
+    l || (l = !0, I.dispose(), e.removeEventListener("beforeunload", i), u && (s == null || s.stop()), u && s !== null && s !== void 0 && c(e).__ITERA_ITERATION_INSPECTOR_RUNTIME__ === s && delete c(e).__ITERA_ITERATION_INSPECTOR_RUNTIME__, d == null || d.destroy(), ((a = E(e, t.stateKey)) == null ? void 0 : a.stop) === i && T(e, t.stateKey));
+  };
+  f(e, t.stateKey, {
+    starting: !0,
+    ownerToken: n,
+    stop: i
+  }), e.addEventListener("beforeunload", i);
+  try {
+    d = m({
+      enabled: !0,
+      hostOrigins: t.hostOrigins
+    }), I.replay();
+    const a = await import("@iteraai/react-component-inspector/iterationInspector");
+    if (r() || l) {
+      i();
+      return;
+    }
+    const O = c(e).__ITERA_ITERATION_INSPECTOR_RUNTIME__;
+    s = a.bootIterationInspectorRuntime(), u = s != null && s !== O, f(e, t.stateKey, {
+      started: !0,
+      ownerToken: n,
+      stop: i
+    });
+  } catch (a) {
+    i(), p(
+      t.warningPrefix,
+      "Failed to start the React inspector runtime.",
+      a
+    );
+  }
+}, C = (e) => {
+  if (typeof window > "u")
+    return () => {
+    };
+  const t = A(e), n = Symbol("iteraReactInspectorViteBootstrap");
+  let r = !1;
+  return L(window, t, n, () => r), () => {
+    r = !0, v(window, t.stateKey, n);
+  };
+}, w = (e = {}) => {
+  typeof window > "u" || v(
+    window,
+    e.stateKey ?? g
+  );
+};
+export {
+  C as bootIteraReactInspectorViteRuntime,
+  w as stopIteraReactInspectorViteRuntime
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sources":["../src/client.ts"],"sourcesContent":["import { INSPECTOR_CHANNEL } from '@iteraai/inspector-protocol';\nimport { bootstrapEmbeddedInspectorBridge } from '@iteraai/react-component-inspector/embeddedBootstrap';\nimport type { IterationInspectorRuntime } from '@iteraai/react-component-inspector/iterationInspector';\n\nexport type IteraReactInspectorViteRuntimeOptions = {\n  enabled: boolean;\n  hostOrigins: readonly string[];\n  stateKey?: string;\n  warningPrefix?: string;\n};\n\ntype InspectorBridge = {\n  destroy: () => void;\n};\n\ntype BootstrapOwnerToken = symbol;\n\ntype BootstrapState =\n  | {\n      starting: true;\n      started?: false;\n      ownerToken: BootstrapOwnerToken;\n      stop: () => void;\n    }\n  | {\n      starting?: false;\n      started: true;\n      ownerToken: BootstrapOwnerToken;\n      stop: () => void;\n    };\n\ntype WindowWithInspectorRuntimeState = Window &\n  Record<string, BootstrapState | undefined> & {\n    __ITERA_ITERATION_INSPECTOR_RUNTIME__?: IterationInspectorRuntime;\n  };\n\nconst DEFAULT_BOOTSTRAP_STATE_KEY = '__ITERA_REACT_INSPECTOR_VITE_BOOTSTRAP__';\nconst DEFAULT_WARNING_PREFIX = '[itera-vite-plugin-react-inspector]';\n\nconst toRuntimeWindow = (win: Window): WindowWithInspectorRuntimeState => {\n  return win as WindowWithInspectorRuntimeState;\n};\n\nconst resolveRuntimeOptions = (\n  options: IteraReactInspectorViteRuntimeOptions,\n) => {\n  return {\n    enabled: options.enabled,\n    hostOrigins: options.hostOrigins,\n    stateKey: options.stateKey ?? DEFAULT_BOOTSTRAP_STATE_KEY,\n    warningPrefix: options.warningPrefix ?? DEFAULT_WARNING_PREFIX,\n  };\n};\n\nconst readBootstrapState = (\n  win: Window,\n  stateKey: string,\n): BootstrapState | undefined => {\n  return toRuntimeWindow(win)[stateKey];\n};\n\nconst writeBootstrapState = (\n  win: Window,\n  stateKey: string,\n  state: BootstrapState,\n) => {\n  toRuntimeWindow(win)[stateKey] = state;\n};\n\nconst clearBootstrapState = (win: Window, stateKey: string) => {\n  delete toRuntimeWindow(win)[stateKey];\n};\n\nconst warn = (\n  warningPrefix: string,\n  message: string,\n  error: unknown = undefined,\n) => {\n  if (error === undefined) {\n    console.warn(`${warningPrefix} ${message}`);\n    return;\n  }\n\n  console.warn(`${warningPrefix} ${message}`, error);\n};\n\nconst stopActiveBootstrap = (\n  win: Window,\n  stateKey: string,\n  ownerToken?: BootstrapOwnerToken,\n) => {\n  const state = readBootstrapState(win, stateKey);\n\n  if (ownerToken !== undefined && state?.ownerToken !== ownerToken) {\n    return;\n  }\n\n  if (typeof state?.stop === 'function') {\n    state.stop();\n    return;\n  }\n\n  if (state?.starting === true) {\n    clearBootstrapState(win, stateKey);\n  }\n};\n\nconst resolveOrigin = (originOrUrl: string) => {\n  try {\n    return new URL(originOrUrl).origin;\n  } catch {\n    return undefined;\n  }\n};\n\nconst isTrustedOrigin = (\n  origin: string,\n  trustedOrigins: readonly string[],\n) => {\n  const resolvedOrigin = resolveOrigin(origin);\n\n  return (\n    resolvedOrigin !== undefined &&\n    trustedOrigins.some((trustedOrigin) => {\n      return resolveOrigin(trustedOrigin) === resolvedOrigin;\n    })\n  );\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => {\n  return typeof value === 'object' && value !== null;\n};\n\nconst toRawMessageObject = (\n  rawMessage: unknown,\n): Record<string, unknown> | undefined => {\n  if (typeof rawMessage === 'string') {\n    try {\n      const parsedMessage = JSON.parse(rawMessage) as unknown;\n\n      return isRecord(parsedMessage) ? parsedMessage : undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  return isRecord(rawMessage) ? rawMessage : undefined;\n};\n\nconst isInspectorChannelMessage = (data: unknown) => {\n  const messageObject = toRawMessageObject(data);\n\n  return messageObject?.channel === INSPECTOR_CHANNEL;\n};\n\nconst cloneMessageEvent = (event: MessageEvent) => {\n  return new MessageEvent('message', {\n    data: event.data,\n    origin: event.origin,\n    lastEventId: event.lastEventId,\n    source: event.source,\n    ports: [...event.ports],\n  });\n};\n\nconst createEarlyInspectorMessageQueue = (\n  win: Window,\n  trustedOrigins: readonly string[],\n) => {\n  const queuedEvents: MessageEvent[] = [];\n\n  const onMessage = (event: MessageEvent) => {\n    if (\n      !isTrustedOrigin(event.origin, trustedOrigins) ||\n      !isInspectorChannelMessage(event.data)\n    ) {\n      return;\n    }\n\n    queuedEvents.push(event);\n  };\n\n  win.addEventListener('message', onMessage);\n\n  return {\n    dispose: () => {\n      win.removeEventListener('message', onMessage);\n    },\n    replay: () => {\n      win.removeEventListener('message', onMessage);\n\n      queuedEvents.forEach((event) => {\n        win.dispatchEvent(cloneMessageEvent(event));\n      });\n      queuedEvents.length = 0;\n    },\n  };\n};\n\nconst startRuntime = async (\n  win: Window,\n  options: ReturnType<typeof resolveRuntimeOptions>,\n  ownerToken: BootstrapOwnerToken,\n  isDisposed: () => boolean,\n) => {\n  const existingState = readBootstrapState(win, options.stateKey);\n\n  if (existingState?.started === true || existingState?.starting === true) {\n    return;\n  }\n\n  if (!options.enabled) {\n    return;\n  }\n\n  if (options.hostOrigins.length === 0) {\n    warn(\n      options.warningPrefix,\n      'Inspector is enabled but no trusted host origins are configured.',\n    );\n    return;\n  }\n\n  const earlyInspectorMessages = createEarlyInspectorMessageQueue(\n    win,\n    options.hostOrigins,\n  );\n  let bridge: InspectorBridge | undefined;\n  let runtime: IterationInspectorRuntime | null | undefined;\n  let ownsIterationRuntime = false;\n  let stopped = false;\n\n  const stop = () => {\n    if (stopped) {\n      return;\n    }\n\n    stopped = true;\n    earlyInspectorMessages.dispose();\n    win.removeEventListener('beforeunload', stop);\n    if (ownsIterationRuntime) {\n      runtime?.stop();\n    }\n\n    if (\n      ownsIterationRuntime &&\n      runtime !== null &&\n      runtime !== undefined &&\n      toRuntimeWindow(win).__ITERA_ITERATION_INSPECTOR_RUNTIME__ === runtime\n    ) {\n      delete toRuntimeWindow(win).__ITERA_ITERATION_INSPECTOR_RUNTIME__;\n    }\n\n    bridge?.destroy();\n\n    if (readBootstrapState(win, options.stateKey)?.stop === stop) {\n      clearBootstrapState(win, options.stateKey);\n    }\n  };\n\n  writeBootstrapState(win, options.stateKey, {\n    starting: true,\n    ownerToken,\n    stop,\n  });\n  win.addEventListener('beforeunload', stop);\n\n  try {\n    bridge = bootstrapEmbeddedInspectorBridge({\n      enabled: true,\n      hostOrigins: options.hostOrigins,\n    });\n    earlyInspectorMessages.replay();\n\n    const iterationModule = await import(\n      '@iteraai/react-component-inspector/iterationInspector'\n    );\n\n    if (isDisposed() || stopped) {\n      stop();\n      return;\n    }\n\n    const existingIterationRuntime =\n      toRuntimeWindow(win).__ITERA_ITERATION_INSPECTOR_RUNTIME__;\n\n    runtime = iterationModule.bootIterationInspectorRuntime();\n    ownsIterationRuntime =\n      runtime !== null &&\n      runtime !== undefined &&\n      runtime !== existingIterationRuntime;\n\n    writeBootstrapState(win, options.stateKey, {\n      started: true,\n      ownerToken,\n      stop,\n    });\n  } catch (error) {\n    stop();\n\n    warn(\n      options.warningPrefix,\n      'Failed to start the React inspector runtime.',\n      error,\n    );\n  }\n};\n\nexport const bootIteraReactInspectorViteRuntime = (\n  options: IteraReactInspectorViteRuntimeOptions,\n) => {\n  if (typeof window === 'undefined') {\n    return () => undefined;\n  }\n\n  const resolvedOptions = resolveRuntimeOptions(options);\n  const ownerToken = Symbol('iteraReactInspectorViteBootstrap');\n  let disposed = false;\n\n  void startRuntime(window, resolvedOptions, ownerToken, () => disposed);\n\n  return () => {\n    disposed = true;\n    stopActiveBootstrap(window, resolvedOptions.stateKey, ownerToken);\n  };\n};\n\nexport const stopIteraReactInspectorViteRuntime = (\n  options: Pick<IteraReactInspectorViteRuntimeOptions, 'stateKey'> = {},\n) => {\n  if (typeof window === 'undefined') {\n    return;\n  }\n\n  stopActiveBootstrap(\n    window,\n    options.stateKey ?? DEFAULT_BOOTSTRAP_STATE_KEY,\n  );\n};\n"],"names":["DEFAULT_BOOTSTRAP_STATE_KEY","DEFAULT_WARNING_PREFIX","toRuntimeWindow","win","resolveRuntimeOptions","options","readBootstrapState","stateKey","writeBootstrapState","state","clearBootstrapState","warn","warningPrefix","message","error","stopActiveBootstrap","ownerToken","resolveOrigin","originOrUrl","isTrustedOrigin","origin","trustedOrigins","resolvedOrigin","trustedOrigin","isRecord","value","toRawMessageObject","rawMessage","parsedMessage","isInspectorChannelMessage","data","messageObject","INSPECTOR_CHANNEL","cloneMessageEvent","event","createEarlyInspectorMessageQueue","queuedEvents","onMessage","startRuntime","isDisposed","existingState","earlyInspectorMessages","bridge","runtime","ownsIterationRuntime","stopped","stop","_a","bootstrapEmbeddedInspectorBridge","iterationModule","existingIterationRuntime","bootIteraReactInspectorViteRuntime","resolvedOptions","disposed","stopIteraReactInspectorViteRuntime"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { createIteraReactInspectorVitePlugin, iteraReactInspector, type IteraReactInspectorVitePluginOptions, } from './plugin';

package/dist/index.js

@@ -0,0 +1,112 @@
+import { normalizeOrigin as _ } from "@iteraai/inspector-protocol";
+const i = "virtual:itera-react-inspector-runtime", a = `\0${i}`, R = "VITE_ITERA_COMPONENT_INSPECTOR_ENABLED", u = "VITE_ITERA_COMPONENT_INSPECTOR_HOST_ORIGINS", E = "__ITERA_REACT_INSPECTOR_VITE_BOOTSTRAP__", l = "[itera-vite-plugin-react-inspector]", p = `/@id/__x00__${i}`, m = {
+  enabled: !1,
+  hostOrigins: []
+}, d = (t) => Array.isArray(t) ? [...t] : typeof t == "string" ? t.split(",") : [], T = (t, e) => t ?? e === "true", f = (t, e) => {
+  const r = [], n = [];
+  return [
+    ...d(t),
+    ...d(e)
+  ].forEach((I) => {
+    const o = I.trim();
+    if (o.length === 0)
+      return;
+    const c = _(o);
+    if (c === void 0) {
+      n.push(o);
+      return;
+    }
+    r.includes(c) || r.push(c);
+  }), {
+    hostOrigins: r,
+    invalidHostOrigins: n
+  };
+}, g = (t, e) => {
+  const r = t.env[e];
+  return typeof r == "string" ? r : void 0;
+}, O = (t, e) => e.command !== "build" || t.includeInBuild === !0, h = (t, e) => {
+  const r = T(
+    t.enabled,
+    g(e, R)
+  ), n = f(
+    t.hostOrigins,
+    g(e, u)
+  );
+  return r ? O(t, e) ? (n.invalidHostOrigins.length > 0 && e.logger.warn(
+    `${l} Ignoring invalid host origin values: ${n.invalidHostOrigins.join(", ")}`
+  ), n.hostOrigins.length === 0 && e.logger.warn(
+    `${l} Inspector is enabled but no trusted host origins are configured. Set hostOrigins in createIteraReactInspectorVitePlugin(...) or ${u}.`
+  ), {
+    enabled: r,
+    hostOrigins: n.hostOrigins
+  }) : {
+    enabled: r,
+    hostOrigins: n.hostOrigins
+  } : {
+    enabled: !1,
+    hostOrigins: n.hostOrigins
+  };
+}, v = (t, e, r) => r !== void 0 && O(e, r) && t.enabled && t.hostOrigins.length > 0, S = (t, e) => t.length === 0 || t === "/" ? e : `${t.endsWith("/") ? t.slice(0, -1) : t}${e}`, A = (t) => {
+  try {
+    return new URL(t), !0;
+  } catch {
+    return !1;
+  }
+}, N = (t, e) => t === void 0 || t.length === 0 || A(e) ? e : new URL(e, `${t.replace(/\/$/, "")}/`).toString(), V = (t) => N(
+  t.server.origin,
+  S(t.base, p)
+), H = (t) => t.command === "serve" ? {
+  tag: "script",
+  attrs: {
+    type: "module",
+    src: V(t)
+  },
+  injectTo: "head-prepend"
+} : {
+  tag: "script",
+  attrs: {
+    type: "module"
+  },
+  children: `import ${JSON.stringify(i)};`,
+  injectTo: "head-prepend"
+}, P = (t) => `
+import { bootIteraReactInspectorViteRuntime } from '@iteraai/vite-plugin-react-inspector/client';
+
+const stop = bootIteraReactInspectorViteRuntime(${JSON.stringify({
+  enabled: t.enabled,
+  hostOrigins: t.hostOrigins,
+  stateKey: E,
+  warningPrefix: l
+})});
+
+if (import.meta.hot) {
+  import.meta.hot.dispose(stop);
+}
+
+export {};
+`, b = (t = {}) => {
+  let e, r = m;
+  return {
+    name: "itera-react-inspector-vite-plugin",
+    enforce: "pre",
+    configResolved(n) {
+      e = n, r = h(t, n);
+    },
+    resolveId(n) {
+      return n === i ? a : null;
+    },
+    load(n) {
+      return n !== a ? null : P(r);
+    },
+    transformIndexHtml(n) {
+      const s = e;
+      if (s !== void 0 && !(n.includes(i) || !v(r, t, s)))
+        return [H(s)];
+    }
+  };
+}, $ = b;
+export {
+  b as createIteraReactInspectorVitePlugin,
+  $ as iteraReactInspector
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/plugin.ts"],"sourcesContent":["import { normalizeOrigin } from '@iteraai/inspector-protocol';\nimport type { HtmlTagDescriptor, Plugin, ResolvedConfig } from 'vite';\n\nexport type IteraReactInspectorVitePluginOptions = {\n  enabled?: boolean;\n  hostOrigins?: readonly string[] | string;\n  includeInBuild?: boolean;\n};\n\ntype RuntimeOptions = {\n  enabled: boolean;\n  hostOrigins: readonly string[];\n};\n\ntype HostOriginResolution = {\n  hostOrigins: string[];\n  invalidHostOrigins: string[];\n};\n\nexport const ITERA_REACT_INSPECTOR_VIRTUAL_MODULE_ID =\n  'virtual:itera-react-inspector-runtime';\nexport const ITERA_REACT_INSPECTOR_RESOLVED_VIRTUAL_MODULE_ID = `\\0${ITERA_REACT_INSPECTOR_VIRTUAL_MODULE_ID}`;\n\nconst ENABLED_ENV_KEY = 'VITE_ITERA_COMPONENT_INSPECTOR_ENABLED';\nconst HOST_ORIGINS_ENV_KEY = 'VITE_ITERA_COMPONENT_INSPECTOR_HOST_ORIGINS';\nconst BOOTSTRAP_STATE_KEY = '__ITERA_REACT_INSPECTOR_VITE_BOOTSTRAP__';\nconst WARNING_PREFIX = '[itera-vite-plugin-react-inspector]';\nconst VITE_BROWSER_RESOLVED_ID_PATH = `/@id/__x00__${ITERA_REACT_INSPECTOR_VIRTUAL_MODULE_ID}`;\n\nconst disabledRuntimeOptions: RuntimeOptions = {\n  enabled: false,\n  hostOrigins: [],\n};\n\nconst toHostOriginItems = (\n  hostOrigins: IteraReactInspectorVitePluginOptions['hostOrigins'],\n) => {\n  if (Array.isArray(hostOrigins)) {\n    return [...hostOrigins];\n  }\n\n  if (typeof hostOrigins === 'string') {\n    return hostOrigins.split(',');\n  }\n\n  return [];\n};\n\nexport const resolveInspectorEnabled = (\n  optionEnabled: boolean | undefined,\n  envEnabled: string | undefined,\n) => {\n  return optionEnabled ?? envEnabled === 'true';\n};\n\nexport const resolveInspectorHostOrigins = (\n  optionHostOrigins: IteraReactInspectorVitePluginOptions['hostOrigins'],\n  envHostOrigins: string | undefined,\n): HostOriginResolution => {\n  const hostOrigins: string[] = [];\n  const invalidHostOrigins: string[] = [];\n  const configuredHostOrigins = [\n    ...toHostOriginItems(optionHostOrigins),\n    ...toHostOriginItems(envHostOrigins),\n  ];\n\n  configuredHostOrigins.forEach((hostOrigin) => {\n    const trimmedHostOrigin = hostOrigin.trim();\n\n    if (trimmedHostOrigin.length === 0) {\n      return;\n    }\n\n    const normalizedHostOrigin = normalizeOrigin(trimmedHostOrigin);\n\n    if (normalizedHostOrigin === undefined) {\n      invalidHostOrigins.push(trimmedHostOrigin);\n      return;\n    }\n\n    if (!hostOrigins.includes(normalizedHostOrigin)) {\n      hostOrigins.push(normalizedHostOrigin);\n    }\n  });\n\n  return {\n    hostOrigins,\n    invalidHostOrigins,\n  };\n};\n\nconst getEnvString = (config: ResolvedConfig, key: string) => {\n  const value = config.env[key];\n\n  return typeof value === 'string' ? value : undefined;\n};\n\nconst allowsHtmlInjection = (\n  options: IteraReactInspectorVitePluginOptions,\n  config: ResolvedConfig,\n) => {\n  return config.command !== 'build' || options.includeInBuild === true;\n};\n\nexport const resolveRuntimeOptions = (\n  options: IteraReactInspectorVitePluginOptions,\n  config: ResolvedConfig,\n): RuntimeOptions => {\n  const enabled = resolveInspectorEnabled(\n    options.enabled,\n    getEnvString(config, ENABLED_ENV_KEY),\n  );\n  const hostOriginResolution = resolveInspectorHostOrigins(\n    options.hostOrigins,\n    getEnvString(config, HOST_ORIGINS_ENV_KEY),\n  );\n\n  if (!enabled) {\n    return {\n      enabled: false,\n      hostOrigins: hostOriginResolution.hostOrigins,\n    };\n  }\n\n  if (!allowsHtmlInjection(options, config)) {\n    return {\n      enabled,\n      hostOrigins: hostOriginResolution.hostOrigins,\n    };\n  }\n\n  if (hostOriginResolution.invalidHostOrigins.length > 0) {\n    config.logger.warn(\n      `${WARNING_PREFIX} Ignoring invalid host origin values: ${hostOriginResolution.invalidHostOrigins.join(', ')}`,\n    );\n  }\n\n  if (hostOriginResolution.hostOrigins.length === 0) {\n    config.logger.warn(\n      `${WARNING_PREFIX} Inspector is enabled but no trusted host origins are configured. Set hostOrigins in createIteraReactInspectorVitePlugin(...) or ${HOST_ORIGINS_ENV_KEY}.`,\n    );\n  }\n\n  return {\n    enabled,\n    hostOrigins: hostOriginResolution.hostOrigins,\n  };\n};\n\nconst shouldInjectRuntime = (\n  runtimeOptions: RuntimeOptions,\n  pluginOptions: IteraReactInspectorVitePluginOptions,\n  config: ResolvedConfig | undefined,\n) => {\n  return (\n    config !== undefined &&\n    allowsHtmlInjection(pluginOptions, config) &&\n    runtimeOptions.enabled &&\n    runtimeOptions.hostOrigins.length > 0\n  );\n};\n\nconst prefixViteBase = (base: string, path: string) => {\n  if (base.length === 0 || base === '/') {\n    return path;\n  }\n\n  const normalizedBase = base.endsWith('/') ? base.slice(0, -1) : base;\n\n  return `${normalizedBase}${path}`;\n};\n\nconst isAbsoluteUrl = (value: string) => {\n  try {\n    new URL(value);\n\n    return true;\n  } catch {\n    return false;\n  }\n};\n\nconst prefixViteServerOrigin = (\n  serverOrigin: string | undefined,\n  path: string,\n) => {\n  if (\n    serverOrigin === undefined ||\n    serverOrigin.length === 0 ||\n    isAbsoluteUrl(path)\n  ) {\n    return path;\n  }\n\n  return new URL(path, `${serverOrigin.replace(/\\/$/, '')}/`).toString();\n};\n\nconst resolveDevRuntimeModuleSrc = (config: ResolvedConfig) => {\n  return prefixViteServerOrigin(\n    config.server.origin,\n    prefixViteBase(config.base, VITE_BROWSER_RESOLVED_ID_PATH),\n  );\n};\n\nconst createRuntimeHtmlTag = (config: ResolvedConfig): HtmlTagDescriptor => {\n  if (config.command === 'serve') {\n    return {\n      tag: 'script',\n      attrs: {\n        type: 'module',\n        src: resolveDevRuntimeModuleSrc(config),\n      },\n      injectTo: 'head-prepend',\n    };\n  }\n\n  return {\n    tag: 'script',\n    attrs: {\n      type: 'module',\n    },\n    children: `import ${JSON.stringify(ITERA_REACT_INSPECTOR_VIRTUAL_MODULE_ID)};`,\n    injectTo: 'head-prepend',\n  };\n};\n\nexport const createRuntimeModuleCode = (runtimeOptions: RuntimeOptions) => {\n  const serializedOptions = JSON.stringify({\n    enabled: runtimeOptions.enabled,\n    hostOrigins: runtimeOptions.hostOrigins,\n    stateKey: BOOTSTRAP_STATE_KEY,\n    warningPrefix: WARNING_PREFIX,\n  });\n\n  return `\nimport { bootIteraReactInspectorViteRuntime } from '@iteraai/vite-plugin-react-inspector/client';\n\nconst stop = bootIteraReactInspectorViteRuntime(${serializedOptions});\n\nif (import.meta.hot) {\n  import.meta.hot.dispose(stop);\n}\n\nexport {};\n`;\n};\n\nexport const createIteraReactInspectorVitePlugin = (\n  options: IteraReactInspectorVitePluginOptions = {},\n): Plugin => {\n  let resolvedConfig: ResolvedConfig | undefined;\n  let runtimeOptions = disabledRuntimeOptions;\n\n  return {\n    name: 'itera-react-inspector-vite-plugin',\n    enforce: 'pre',\n    configResolved(config) {\n      resolvedConfig = config;\n      runtimeOptions = resolveRuntimeOptions(options, config);\n    },\n    resolveId(id) {\n      if (id === ITERA_REACT_INSPECTOR_VIRTUAL_MODULE_ID) {\n        return ITERA_REACT_INSPECTOR_RESOLVED_VIRTUAL_MODULE_ID;\n      }\n\n      return null;\n    },\n    load(id) {\n      if (id !== ITERA_REACT_INSPECTOR_RESOLVED_VIRTUAL_MODULE_ID) {\n        return null;\n      }\n\n      return createRuntimeModuleCode(runtimeOptions);\n    },\n    transformIndexHtml(html) {\n      const config = resolvedConfig;\n\n      if (config === undefined) {\n        return;\n      }\n\n      if (\n        html.includes(ITERA_REACT_INSPECTOR_VIRTUAL_MODULE_ID) ||\n        !shouldInjectRuntime(runtimeOptions, options, config)\n      ) {\n        return;\n      }\n\n      return [createRuntimeHtmlTag(config)];\n    },\n  };\n};\n\nexport const iteraReactInspector = createIteraReactInspectorVitePlugin;\n"],"names":["ITERA_REACT_INSPECTOR_VIRTUAL_MODULE_ID","ITERA_REACT_INSPECTOR_RESOLVED_VIRTUAL_MODULE_ID","ENABLED_ENV_KEY","HOST_ORIGINS_ENV_KEY","BOOTSTRAP_STATE_KEY","WARNING_PREFIX","VITE_BROWSER_RESOLVED_ID_PATH","disabledRuntimeOptions","toHostOriginItems","hostOrigins","resolveInspectorEnabled","optionEnabled","envEnabled","resolveInspectorHostOrigins","optionHostOrigins","envHostOrigins","invalidHostOrigins","hostOrigin","trimmedHostOrigin","normalizedHostOrigin","normalizeOrigin","getEnvString","config","key","value","allowsHtmlInjection","options","resolveRuntimeOptions","enabled","hostOriginResolution","shouldInjectRuntime","runtimeOptions","pluginOptions","prefixViteBase","base","path","isAbsoluteUrl","prefixViteServerOrigin","serverOrigin","resolveDevRuntimeModuleSrc","createRuntimeHtmlTag","createRuntimeModuleCode","createIteraReactInspectorVitePlugin","resolvedConfig","id","html","iteraReactInspector"],"mappings":"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"}

package/dist/plugin.d.ts

@@ -0,0 +1,23 @@
+import { Plugin, ResolvedConfig } from 'vite';
+export type IteraReactInspectorVitePluginOptions = {
+    enabled?: boolean;
+    hostOrigins?: readonly string[] | string;
+    includeInBuild?: boolean;
+};
+type RuntimeOptions = {
+    enabled: boolean;
+    hostOrigins: readonly string[];
+};
+type HostOriginResolution = {
+    hostOrigins: string[];
+    invalidHostOrigins: string[];
+};
+export declare const ITERA_REACT_INSPECTOR_VIRTUAL_MODULE_ID = "virtual:itera-react-inspector-runtime";
+export declare const ITERA_REACT_INSPECTOR_RESOLVED_VIRTUAL_MODULE_ID = "\0virtual:itera-react-inspector-runtime";
+export declare const resolveInspectorEnabled: (optionEnabled: boolean | undefined, envEnabled: string | undefined) => boolean;
+export declare const resolveInspectorHostOrigins: (optionHostOrigins: IteraReactInspectorVitePluginOptions["hostOrigins"], envHostOrigins: string | undefined) => HostOriginResolution;
+export declare const resolveRuntimeOptions: (options: IteraReactInspectorVitePluginOptions, config: ResolvedConfig) => RuntimeOptions;
+export declare const createRuntimeModuleCode: (runtimeOptions: RuntimeOptions) => string;
+export declare const createIteraReactInspectorVitePlugin: (options?: IteraReactInspectorVitePluginOptions) => Plugin;
+export declare const iteraReactInspector: (options?: IteraReactInspectorVitePluginOptions) => Plugin;
+export {};

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@iteraai/vite-plugin-react-inspector",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "description": "Vite plugin that injects the Itera React component inspector runtime into React-Vite apps.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iteraai/component-inspector.git",
+    "directory": "packages/vite-plugin-react-inspector"
+  },
+  "bugs": {
+    "url": "https://github.com/iteraai/component-inspector/issues"
+  },
+  "homepage": "https://github.com/iteraai/component-inspector/tree/main/packages/vite-plugin-react-inspector#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build",
+    "prepack": "npm run build",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "lint": "eslint . --fix",
+    "lint:ci": "eslint . --max-warnings=0"
+  },
+  "dependencies": {
+    "@iteraai/inspector-protocol": "0.1.0",
+    "@iteraai/react-component-inspector": "0.4.1"
+  },
+  "peerDependencies": {
+    "react": "^18.3.0 || ^19.0.0",
+    "react-dom": "^18.3.0 || ^19.0.0",
+    "vite": "^5.0.0 || ^6.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.19.0",
+    "@stylistic/eslint-plugin-ts": "^4.2.0",
+    "@types/node": "^22.13.1",
+    "eslint": "^9.20.1",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-unicorn": "^58.0.0",
+    "globals": "^15.14.0",
+    "typescript": "~5.6.2",
+    "typescript-eslint": "^8.23.0",
+    "vite": "^6.0.5",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^3.0.8"
+  }
+}