@epicdm/flowstate-extension-api 1.0.0

package/dist/index.d.mts

@@ -0,0 +1 @@
+export { ActivationEvent, AuthService, CommandHandler, Disposable, DisposableStore, EventBusService, ExtensionContext, ExtensionHost, ExtensionInfo, ExtensionModule, ExtensionRegistry, ExtensionServices, ExtensionState, ExtensionStorage, ExtensionStorageAPI, ExtensionType, InMemoryStorageBackend, McpToolDefinition, NetworkService, PermissionEnforcer, Platform, PlatformEvent, SettingsTabConfig, StatusBarConfig, StorageBackend, SyncProviderFactory, UpdateInfo, ViewContribution } from '@epicdm/flowstate-app-framework/extensions';

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { ActivationEvent, AuthService, CommandHandler, Disposable, DisposableStore, EventBusService, ExtensionContext, ExtensionHost, ExtensionInfo, ExtensionModule, ExtensionRegistry, ExtensionServices, ExtensionState, ExtensionStorage, ExtensionStorageAPI, ExtensionType, InMemoryStorageBackend, McpToolDefinition, NetworkService, PermissionEnforcer, Platform, PlatformEvent, SettingsTabConfig, StatusBarConfig, StorageBackend, SyncProviderFactory, UpdateInfo, ViewContribution } from '@epicdm/flowstate-app-framework/extensions';

package/dist/index.js

@@ -0,0 +1,272 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  DisposableStore: () => DisposableStore,
+  ExtensionRegistry: () => ExtensionRegistry,
+  ExtensionStorage: () => ExtensionStorage,
+  InMemoryStorageBackend: () => InMemoryStorageBackend,
+  PermissionEnforcer: () => PermissionEnforcer
+});
+module.exports = __toCommonJS(src_exports);
+
+// ../flowstate-app-framework/src/extensions/DisposableStore.ts
+var DisposableStore = class {
+  constructor() {
+    this.disposables = [];
+  }
+  get size() {
+    return this.disposables.length;
+  }
+  add(disposable) {
+    this.disposables.push(disposable);
+    return disposable;
+  }
+  disposeAll() {
+    const toDispose = this.disposables.splice(0);
+    for (const d of toDispose) {
+      try {
+        d.dispose();
+      } catch {
+      }
+    }
+  }
+};
+
+// ../flowstate-app-framework/src/extensions/PermissionEnforcer.ts
+var PermissionEnforcer = class {
+  constructor(permissions) {
+    this.permissions = new Set(permissions);
+    this.networkDomains = new Set(
+      permissions.filter((p) => p.startsWith("network:")).map((p) => p.slice("network:".length))
+    );
+  }
+  hasPermission(permission) {
+    return this.permissions.has(permission);
+  }
+  assertPermission(permission) {
+    if (!this.hasPermission(permission)) {
+      throw new Error(`Extension lacks permission: ${permission}`);
+    }
+  }
+  canAccessNetwork(url) {
+    if (this.networkDomains.size === 0) return false;
+    try {
+      const parsed = new URL(url);
+      const host = parsed.host;
+      return this.networkDomains.has(host) || this.networkDomains.has(parsed.hostname);
+    } catch {
+      return false;
+    }
+  }
+  assertNetworkAccess(url) {
+    if (!this.canAccessNetwork(url)) {
+      let domain = url;
+      try {
+        domain = new URL(url).host;
+      } catch {
+      }
+      throw new Error(`Network access denied for domain: ${domain}`);
+    }
+  }
+};
+
+// ../flowstate-app-framework/src/extensions/ExtensionStorage.ts
+var InMemoryStorageBackend = class {
+  constructor() {
+    this.store = /* @__PURE__ */ new Map();
+  }
+  async get(key) {
+    return this.store.get(key);
+  }
+  async set(key, value) {
+    this.store.set(key, value);
+  }
+  async delete(key) {
+    this.store.delete(key);
+  }
+};
+var ExtensionStorage = class {
+  constructor(extensionId, backend) {
+    this.backend = backend;
+    this.prefix = `ext:${extensionId}:`;
+  }
+  async get(key) {
+    const raw = await this.backend.get(this.prefix + key);
+    if (raw === void 0) return void 0;
+    return JSON.parse(raw);
+  }
+  async set(key, value) {
+    await this.backend.set(this.prefix + key, JSON.stringify(value));
+  }
+  async delete(key) {
+    await this.backend.delete(this.prefix + key);
+  }
+};
+
+// ../flowstate-app-framework/src/extensions/ExtensionRegistry.ts
+var ExtensionRegistry = class {
+  constructor() {
+    this.extensions = /* @__PURE__ */ new Map();
+    this.views = /* @__PURE__ */ new Map();
+    // slot -> contributions
+    this.viewSnapshots = /* @__PURE__ */ new Map();
+    // memoized for useSyncExternalStore
+    this.extensionsSnapshot = null;
+    // memoized for useSyncExternalStore
+    this.listeners = /* @__PURE__ */ new Set();
+  }
+  register(info) {
+    this.extensions.set(info.id, { ...info });
+    this.notify();
+  }
+  get(id) {
+    const info = this.extensions.get(id);
+    return info ? { ...info } : void 0;
+  }
+  getState(id) {
+    return this.extensions.get(id)?.state;
+  }
+  getAll() {
+    return Array.from(this.extensions.values()).map((e) => ({ ...e }));
+  }
+  setState(id, state, error) {
+    const ext = this.extensions.get(id);
+    if (!ext) return;
+    ext.state = state;
+    ext.error = state === "failed" ? error : void 0;
+    this.notify();
+  }
+  remove(id) {
+    this.extensions.delete(id);
+    this.removeViewsForExtension(id);
+  }
+  // View contribution management
+  registerView(contribution) {
+    const { slot } = contribution;
+    if (!this.views.has(slot)) this.views.set(slot, []);
+    this.views.get(slot).push(contribution);
+    this.notify();
+    return () => {
+      const list = this.views.get(slot);
+      if (!list) return;
+      const idx = list.indexOf(contribution);
+      if (idx >= 0) list.splice(idx, 1);
+      this.notify();
+    };
+  }
+  // Returns a stable memoized snapshot of all extensions for useSyncExternalStore.
+  // useSyncExternalStore compares snapshot references with Object.is, so returning
+  // a new array on every call would cause infinite re-renders.
+  // The cache is cleared on every notify() call so stale data is never served.
+  getExtensionsSnapshot() {
+    if (this.extensionsSnapshot === null) {
+      this.extensionsSnapshot = Array.from(this.extensions.values()).map((e) => ({ ...e }));
+    }
+    return this.extensionsSnapshot;
+  }
+  // Returns a memoized snapshot for useSyncExternalStore compatibility.
+  // useSyncExternalStore compares snapshot references with Object.is, so
+  // returning a new array on every call would cause infinite re-renders.
+  // The cache is cleared on every notify() call so stale data is never served.
+  getViewsForSlot(slot) {
+    if (!this.viewSnapshots.has(slot)) {
+      const sorted = (this.views.get(slot) ?? []).slice().sort((a, b) => a.order - b.order);
+      this.viewSnapshots.set(slot, sorted);
+    }
+    return this.viewSnapshots.get(slot);
+  }
+  removeViewsForExtension(extensionId) {
+    for (const [slot, contributions] of this.views) {
+      this.views.set(
+        slot,
+        contributions.filter((c) => c.extensionId !== extensionId)
+      );
+    }
+    this.notify();
+  }
+  // Change notification
+  onChange(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  notify() {
+    this.viewSnapshots.clear();
+    this.extensionsSnapshot = null;
+    for (const listener of this.listeners) {
+      listener();
+    }
+  }
+  clear() {
+    this.extensions.clear();
+    this.views.clear();
+    this.viewSnapshots.clear();
+    this.extensionsSnapshot = null;
+    this.notify();
+  }
+};
+
+// ../flowstate-app-framework/src/extensions/ExtensionSlot.tsx
+var import_react = __toESM(require("react"));
+var import_jsx_runtime = require("react/jsx-runtime");
+
+// ../flowstate-app-framework/src/extensions/ExtensionHostContext.tsx
+var import_react2 = __toESM(require("react"));
+var import_jsx_runtime2 = require("react/jsx-runtime");
+var ExtensionHostCtx = (0, import_react2.createContext)(null);
+var McpToolRegistryContext = (0, import_react2.createContext)(null);
+var ThemeRegistryContext = (0, import_react2.createContext)(null);
+
+// ../flowstate-app-framework/src/extensions/hooks/useExtensions.ts
+var import_react3 = require("react");
+
+// ../flowstate-app-framework/src/extensions/hooks/useMarketplaceSearch.ts
+var import_react4 = require("react");
+
+// ../flowstate-app-framework/src/extensions/hooks/useExtensionUpdates.ts
+var import_react5 = require("react");
+
+// ../flowstate-app-framework/src/extensions/hooks/useMcpTools.ts
+var import_react6 = require("react");
+
+// ../flowstate-app-framework/src/extensions/hooks/useActiveTheme.ts
+var import_react7 = require("react");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DisposableStore,
+  ExtensionRegistry,
+  ExtensionStorage,
+  InMemoryStorageBackend,
+  PermissionEnforcer
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../../flowstate-app-framework/src/extensions/DisposableStore.ts","../../flowstate-app-framework/src/extensions/PermissionEnforcer.ts","../../flowstate-app-framework/src/extensions/ExtensionStorage.ts","../../flowstate-app-framework/src/extensions/ExtensionRegistry.ts","../../flowstate-app-framework/src/extensions/ExtensionSlot.tsx","../../flowstate-app-framework/src/extensions/ExtensionHostContext.tsx","../../flowstate-app-framework/src/extensions/hooks/useExtensions.ts","../../flowstate-app-framework/src/extensions/hooks/useMarketplaceSearch.ts","../../flowstate-app-framework/src/extensions/hooks/useExtensionUpdates.ts","../../flowstate-app-framework/src/extensions/hooks/useMcpTools.ts","../../flowstate-app-framework/src/extensions/hooks/useActiveTheme.ts"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\n// Core types — the public API surface for extension authors.\n// Imported from the framework's dedicated extensions sub-path so we pull\n// only the extension surface, not the full framework bundle.\nexport type {\n  Disposable,\n  ExtensionState,\n  ExtensionInfo,\n  ExtensionType,\n  Platform,\n  ExtensionModule,\n  ExtensionContext,\n  ExtensionStorageAPI,\n  CommandHandler,\n  SettingsTabConfig,\n  StatusBarConfig,\n  SyncProviderFactory,\n  McpToolDefinition,\n  ExtensionServices,\n  AuthService,\n  NetworkService,\n  EventBusService,\n  PlatformEvent,\n  ExtensionHost,\n  UpdateInfo,\n  ActivationEvent,\n  ViewContribution,\n} from '@epicdm/flowstate-app-framework/extensions'\n\n// Runtime classes — for advanced usage (building custom hosts, testing)\nexport {\n  DisposableStore,\n  PermissionEnforcer,\n  ExtensionStorage,\n  InMemoryStorageBackend,\n  ExtensionRegistry,\n} from '@epicdm/flowstate-app-framework/extensions'\n\nexport type { StorageBackend } from '@epicdm/flowstate-app-framework/extensions'\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport type { Disposable } from './types'\n\nexport class DisposableStore {\n  private disposables: Disposable[] = []\n\n  get size(): number {\n    return this.disposables.length\n  }\n\n  add<T extends Disposable>(disposable: T): T {\n    this.disposables.push(disposable)\n    return disposable\n  }\n\n  disposeAll(): void {\n    const toDispose = this.disposables.splice(0)\n    for (const d of toDispose) {\n      try {\n        d.dispose()\n      } catch {\n        // Swallow errors — continue disposing remaining items\n      }\n    }\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nexport class PermissionEnforcer {\n  private readonly permissions: Set<string>\n  private readonly networkDomains: Set<string>\n\n  constructor(permissions: string[]) {\n    this.permissions = new Set(permissions)\n    this.networkDomains = new Set(\n      permissions.filter(p => p.startsWith('network:')).map(p => p.slice('network:'.length))\n    )\n  }\n\n  hasPermission(permission: string): boolean {\n    return this.permissions.has(permission)\n  }\n\n  assertPermission(permission: string): void {\n    if (!this.hasPermission(permission)) {\n      throw new Error(`Extension lacks permission: ${permission}`)\n    }\n  }\n\n  canAccessNetwork(url: string): boolean {\n    if (this.networkDomains.size === 0) return false\n    try {\n      const parsed = new URL(url)\n      const host = parsed.host // includes port if present\n      return this.networkDomains.has(host) || this.networkDomains.has(parsed.hostname)\n    } catch {\n      return false\n    }\n  }\n\n  assertNetworkAccess(url: string): void {\n    if (!this.canAccessNetwork(url)) {\n      let domain = url\n      try {\n        domain = new URL(url).host\n      } catch {\n        // Use raw URL if parsing fails\n      }\n      throw new Error(`Network access denied for domain: ${domain}`)\n    }\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport type { ExtensionStorageAPI } from './types'\n\nexport interface StorageBackend {\n  get(key: string): Promise<string | undefined>\n  set(key: string, value: string): Promise<void>\n  delete(key: string): Promise<void>\n}\n\nexport class InMemoryStorageBackend implements StorageBackend {\n  private store = new Map<string, string>()\n\n  async get(key: string): Promise<string | undefined> {\n    return this.store.get(key)\n  }\n\n  async set(key: string, value: string): Promise<void> {\n    this.store.set(key, value)\n  }\n\n  async delete(key: string): Promise<void> {\n    this.store.delete(key)\n  }\n}\n\nexport class ExtensionStorage implements ExtensionStorageAPI {\n  private readonly prefix: string\n\n  constructor(\n    extensionId: string,\n    private readonly backend: StorageBackend\n  ) {\n    this.prefix = `ext:${extensionId}:`\n  }\n\n  async get<T>(key: string): Promise<T | undefined> {\n    const raw = await this.backend.get(this.prefix + key)\n    if (raw === undefined) return undefined\n    return JSON.parse(raw) as T\n  }\n\n  async set<T>(key: string, value: T): Promise<void> {\n    await this.backend.set(this.prefix + key, JSON.stringify(value))\n  }\n\n  async delete(key: string): Promise<void> {\n    await this.backend.delete(this.prefix + key)\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport type { ExtensionInfo, ExtensionState, ViewContribution } from './types'\n\nexport class ExtensionRegistry {\n  private extensions = new Map<string, ExtensionInfo>()\n  private views = new Map<string, ViewContribution[]>() // slot -> contributions\n  private viewSnapshots = new Map<string, ViewContribution[]>() // memoized for useSyncExternalStore\n  private extensionsSnapshot: ExtensionInfo[] | null = null // memoized for useSyncExternalStore\n  private listeners = new Set<() => void>()\n\n  register(info: ExtensionInfo): void {\n    this.extensions.set(info.id, { ...info })\n    this.notify()\n  }\n\n  get(id: string): ExtensionInfo | undefined {\n    const info = this.extensions.get(id)\n    return info ? { ...info } : undefined\n  }\n\n  getState(id: string): ExtensionState | undefined {\n    return this.extensions.get(id)?.state\n  }\n\n  getAll(): ExtensionInfo[] {\n    return Array.from(this.extensions.values()).map(e => ({ ...e }))\n  }\n\n  setState(id: string, state: ExtensionState, error?: string): void {\n    const ext = this.extensions.get(id)\n    if (!ext) return\n    ext.state = state\n    ext.error = state === 'failed' ? error : undefined\n    this.notify()\n  }\n\n  remove(id: string): void {\n    this.extensions.delete(id)\n    this.removeViewsForExtension(id) // calls notify() internally\n  }\n\n  // View contribution management\n\n  registerView(contribution: ViewContribution): () => void {\n    const { slot } = contribution\n    if (!this.views.has(slot)) this.views.set(slot, [])\n    this.views.get(slot)!.push(contribution)\n    this.notify()\n    return () => {\n      const list = this.views.get(slot)\n      if (!list) return\n      const idx = list.indexOf(contribution)\n      if (idx >= 0) list.splice(idx, 1)\n      this.notify()\n    }\n  }\n\n  // Returns a stable memoized snapshot of all extensions for useSyncExternalStore.\n  // useSyncExternalStore compares snapshot references with Object.is, so returning\n  // a new array on every call would cause infinite re-renders.\n  // The cache is cleared on every notify() call so stale data is never served.\n  getExtensionsSnapshot(): ExtensionInfo[] {\n    if (this.extensionsSnapshot === null) {\n      this.extensionsSnapshot = Array.from(this.extensions.values()).map(e => ({ ...e }))\n    }\n    return this.extensionsSnapshot\n  }\n\n  // Returns a memoized snapshot for useSyncExternalStore compatibility.\n  // useSyncExternalStore compares snapshot references with Object.is, so\n  // returning a new array on every call would cause infinite re-renders.\n  // The cache is cleared on every notify() call so stale data is never served.\n  getViewsForSlot(slot: string): ViewContribution[] {\n    if (!this.viewSnapshots.has(slot)) {\n      const sorted = (this.views.get(slot) ?? []).slice().sort((a, b) => a.order - b.order)\n      this.viewSnapshots.set(slot, sorted)\n    }\n    return this.viewSnapshots.get(slot)!\n  }\n\n  removeViewsForExtension(extensionId: string): void {\n    for (const [slot, contributions] of this.views) {\n      this.views.set(\n        slot,\n        contributions.filter(c => c.extensionId !== extensionId)\n      )\n    }\n    this.notify()\n  }\n\n  // Change notification\n\n  onChange(listener: () => void): () => void {\n    this.listeners.add(listener)\n    return () => {\n      this.listeners.delete(listener)\n    }\n  }\n\n  private notify(): void {\n    this.viewSnapshots.clear() // invalidate memoized snapshots\n    this.extensionsSnapshot = null // invalidate extensions snapshot\n    for (const listener of this.listeners) {\n      listener()\n    }\n  }\n\n  clear(): void {\n    this.extensions.clear()\n    this.views.clear()\n    this.viewSnapshots.clear()\n    this.extensionsSnapshot = null\n    this.notify()\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport React, { Component, useSyncExternalStore, type ReactNode } from 'react'\nimport type { ExtensionRegistry } from './ExtensionRegistry'\n\n// Error boundary per contribution\ninterface SlotErrorBoundaryProps {\n  extensionId: string\n  children: ReactNode\n}\n\ninterface SlotErrorBoundaryState {\n  hasError: boolean\n}\n\nclass SlotErrorBoundary extends Component<SlotErrorBoundaryProps, SlotErrorBoundaryState> {\n  state: SlotErrorBoundaryState = { hasError: false }\n\n  static getDerivedStateFromError(): SlotErrorBoundaryState {\n    return { hasError: true }\n  }\n\n  componentDidCatch(error: Error) {\n    console.error(`[ExtensionSlot] Extension \"${this.props.extensionId}\" threw:`, error)\n  }\n\n  render() {\n    if (this.state.hasError) return null\n    return this.props.children\n  }\n}\n\n// ExtensionSlot component\nexport interface ExtensionSlotProps {\n  name: string\n  context: Record<string, unknown>\n  registry: ExtensionRegistry\n  activationEngine?: { triggerEvent(event: string): Promise<void> }\n  className?: string\n}\n\nexport function ExtensionSlot({\n  name,\n  context,\n  registry,\n  activationEngine,\n  className,\n}: ExtensionSlotProps) {\n  // Trigger lazy activation for extensions listening to onView:<slot>\n  React.useEffect(() => {\n    activationEngine?.triggerEvent(`onView:${name}`)\n  }, [activationEngine, name])\n\n  const views = useSyncExternalStore(\n    onStoreChange => registry.onChange(onStoreChange),\n    () => registry.getViewsForSlot(name)\n  )\n\n  if (views.length === 0) return null\n\n  return (\n    <div className={className} data-extension-slot={name}>\n      {views.map((view, i) => (\n        <SlotErrorBoundary key={`${view.extensionId}-${i}`} extensionId={view.extensionId}>\n          <view.component {...context} />\n        </SlotErrorBoundary>\n      ))}\n    </div>\n  )\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport React, { createContext, useContext } from 'react'\nimport type { ExtensionHost } from './types'\nimport type { ExtensionRegistry } from './ExtensionRegistry'\nimport type { ActivationEngine } from './ActivationEngine'\nimport type { McpToolRegistry } from './McpToolRegistry'\nimport type { ThemeRegistry } from './ThemeRegistry'\n\ninterface ExtensionHostContextValue {\n  registry: ExtensionRegistry\n  host: ExtensionHost | null\n  engine: ActivationEngine | null\n}\n\nconst ExtensionHostCtx = createContext<ExtensionHostContextValue | null>(null)\nconst McpToolRegistryContext = createContext<McpToolRegistry | null>(null)\nconst ThemeRegistryContext = createContext<ThemeRegistry | null>(null)\n\nexport interface ExtensionHostProviderProps {\n  registry: ExtensionRegistry\n  host: ExtensionHost | null\n  engine: ActivationEngine | null\n  mcpToolRegistry?: McpToolRegistry | null\n  themeRegistry?: ThemeRegistry | null\n  children: React.ReactNode\n}\n\nexport function ExtensionHostProvider({\n  registry,\n  host,\n  engine,\n  mcpToolRegistry,\n  themeRegistry,\n  children,\n}: ExtensionHostProviderProps) {\n  const value = React.useMemo(() => ({ registry, host, engine }), [registry, host, engine])\n  return (\n    <ThemeRegistryContext.Provider value={themeRegistry ?? null}>\n      <McpToolRegistryContext.Provider value={mcpToolRegistry ?? null}>\n        <ExtensionHostCtx.Provider value={value}>{children}</ExtensionHostCtx.Provider>\n      </McpToolRegistryContext.Provider>\n    </ThemeRegistryContext.Provider>\n  )\n}\n\nfunction useExtensionHostContext(): ExtensionHostContextValue {\n  const ctx = useContext(ExtensionHostCtx)\n  if (!ctx) throw new Error('Extension hooks must be used within ExtensionHostProvider')\n  return ctx\n}\n\nexport function useExtensionRegistry(): ExtensionRegistry {\n  return useExtensionHostContext().registry\n}\n\nexport function useExtensionHost(): ExtensionHost | null {\n  return useExtensionHostContext().host\n}\n\nexport function useActivationEngine(): ActivationEngine | null {\n  return useExtensionHostContext().engine\n}\n\nexport function useMcpToolRegistry(): McpToolRegistry | null {\n  const ctx = useContext(McpToolRegistryContext)\n  return ctx\n}\n\nexport function useThemeRegistry(): ThemeRegistry | null {\n  return useContext(ThemeRegistryContext)\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport { useSyncExternalStore } from 'react'\nimport type { ExtensionInfo, ExtensionState } from '../types'\nimport { useExtensionRegistry } from '../ExtensionHostContext'\n\nexport function useExtensions(): ExtensionInfo[] {\n  const registry = useExtensionRegistry()\n  return useSyncExternalStore(\n    cb => registry.onChange(cb),\n    () => registry.getExtensionsSnapshot()\n  )\n}\n\nexport function useExtensionState(id: string): ExtensionState | undefined {\n  const registry = useExtensionRegistry()\n  return useSyncExternalStore(\n    cb => registry.onChange(cb),\n    () => registry.getState(id)\n  )\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport { useEffect, useState } from 'react'\n\nexport interface MarketplaceSearchOptions {\n  baseUrl: string\n  query?: string\n  category?: string\n  type?: string\n  limit?: number\n}\n\nexport interface MarketplaceListingResult {\n  id: string\n  label: string\n  description: string\n  category: string\n  type: string\n  tags: string[]\n  iconUrl: string | null\n  author: string | null\n  downloadCount: number | null\n  pricing: string | null\n  priceUsdc: string | null\n}\n\nexport interface MarketplaceSearchResult {\n  results: MarketplaceListingResult[]\n  loading: boolean\n  error: string | null\n}\n\nexport function useMarketplaceSearch(options: MarketplaceSearchOptions): MarketplaceSearchResult {\n  const { baseUrl, query, category, type, limit } = options\n\n  const hasSearchParams = Boolean(query || category || type)\n\n  const [results, setResults] = useState<MarketplaceListingResult[]>([])\n  const [loading, setLoading] = useState(false)\n  const [error, setError] = useState<string | null>(null)\n\n  useEffect(() => {\n    if (!hasSearchParams) {\n      setResults([])\n      setLoading(false)\n      setError(null)\n      return\n    }\n\n    setLoading(true)\n    setError(null)\n\n    const controller = new AbortController()\n\n    const timer = setTimeout(async () => {\n      const params = new URLSearchParams()\n      if (query) params.set('q', query)\n      if (category) params.set('category', category)\n      if (type) params.set('type', type)\n      params.set('limit', String(limit ?? 20))\n\n      const url = `${baseUrl}/api/listings?${params.toString()}`\n\n      try {\n        const response = await fetch(url, { signal: controller.signal })\n\n        if (!response.ok) {\n          setError(`Request failed with status ${response.status}`)\n          setResults([])\n          setLoading(false)\n          return\n        }\n\n        const data = await response.json()\n        setResults(data.listings ?? [])\n        setError(null)\n      } catch (err) {\n        if (err instanceof DOMException && err.name === 'AbortError') {\n          // Fetch was aborted by cleanup — do not update state\n          return\n        }\n        setError(err instanceof Error ? err.message : 'Unknown error')\n        setResults([])\n      } finally {\n        // Only clear loading if the fetch was not aborted\n        if (!controller.signal.aborted) {\n          setLoading(false)\n        }\n      }\n    }, 300)\n\n    return () => {\n      clearTimeout(timer)\n      controller.abort()\n    }\n  }, [baseUrl, query, category, type, limit, hasSearchParams])\n\n  return { results, loading, error }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport { useEffect, useState } from 'react'\nimport { useExtensionHost } from '../ExtensionHostContext'\nimport type { UpdateInfo } from '../types'\n\nexport function useExtensionUpdates(): { updates: UpdateInfo[]; loading: boolean } {\n  const host = useExtensionHost()\n  const [updates, setUpdates] = useState<UpdateInfo[]>([])\n  const [loading, setLoading] = useState(false)\n\n  useEffect(() => {\n    if (!host) return\n    let cancelled = false\n    setLoading(true)\n    host\n      .checkForUpdates()\n      .then(result => {\n        if (!cancelled) {\n          setUpdates(result)\n          setLoading(false)\n        }\n      })\n      .catch(() => {\n        if (!cancelled) setLoading(false)\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [host])\n\n  return { updates, loading }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport { useSyncExternalStore } from 'react'\nimport type { McpToolRegistry } from '../McpToolRegistry'\nimport type { RegisteredMcpTool } from '../types'\n\n/**\n * React hook that subscribes to the McpToolRegistry and returns\n * the current list of registered MCP tools. Re-renders when tools\n * are added or removed.\n */\nexport function useMcpTools(registry: McpToolRegistry): RegisteredMcpTool[] {\n  return useSyncExternalStore(\n    onStoreChange => registry.onChange(onStoreChange),\n    () => registry.getToolsSnapshot()\n  )\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport { useSyncExternalStore } from 'react'\nimport type { ThemeRegistry, RegisteredTheme } from '../ThemeRegistry'\n\nexport function useActiveTheme(registry: ThemeRegistry): RegisteredTheme | null {\n  return useSyncExternalStore(\n    onStoreChange => registry.onChange(onStoreChange),\n    () => registry.getActiveThemeSnapshot()\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACKO,IAAM,kBAAN,MAAsB;AAAA,EAAtB;AACL,SAAQ,cAA4B,CAAC;AAAA;AAAA,EAErC,IAAI,OAAe;AACjB,WAAO,KAAK,YAAY;AAAA,EAC1B;AAAA,EAEA,IAA0B,YAAkB;AAC1C,SAAK,YAAY,KAAK,UAAU;AAChC,WAAO;AAAA,EACT;AAAA,EAEA,aAAmB;AACjB,UAAM,YAAY,KAAK,YAAY,OAAO,CAAC;AAC3C,eAAW,KAAK,WAAW;AACzB,UAAI;AACF,UAAE,QAAQ;AAAA,MACZ,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACF;;;ACxBO,IAAM,qBAAN,MAAyB;AAAA,EAI9B,YAAY,aAAuB;AACjC,SAAK,cAAc,IAAI,IAAI,WAAW;AACtC,SAAK,iBAAiB,IAAI;AAAA,MACxB,YAAY,OAAO,OAAK,EAAE,WAAW,UAAU,CAAC,EAAE,IAAI,OAAK,EAAE,MAAM,WAAW,MAAM,CAAC;AAAA,IACvF;AAAA,EACF;AAAA,EAEA,cAAc,YAA6B;AACzC,WAAO,KAAK,YAAY,IAAI,UAAU;AAAA,EACxC;AAAA,EAEA,iBAAiB,YAA0B;AACzC,QAAI,CAAC,KAAK,cAAc,UAAU,GAAG;AACnC,YAAM,IAAI,MAAM,+BAA+B,UAAU,EAAE;AAAA,IAC7D;AAAA,EACF;AAAA,EAEA,iBAAiB,KAAsB;AACrC,QAAI,KAAK,eAAe,SAAS,EAAG,QAAO;AAC3C,QAAI;AACF,YAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,YAAM,OAAO,OAAO;AACpB,aAAO,KAAK,eAAe,IAAI,IAAI,KAAK,KAAK,eAAe,IAAI,OAAO,QAAQ;AAAA,IACjF,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,oBAAoB,KAAmB;AACrC,QAAI,CAAC,KAAK,iBAAiB,GAAG,GAAG;AAC/B,UAAI,SAAS;AACb,UAAI;AACF,iBAAS,IAAI,IAAI,GAAG,EAAE;AAAA,MACxB,QAAQ;AAAA,MAER;AACA,YAAM,IAAI,MAAM,qCAAqC,MAAM,EAAE;AAAA,IAC/D;AAAA,EACF;AACF;;;ACnCO,IAAM,yBAAN,MAAuD;AAAA,EAAvD;AACL,SAAQ,QAAQ,oBAAI,IAAoB;AAAA;AAAA,EAExC,MAAM,IAAI,KAA0C;AAClD,WAAO,KAAK,MAAM,IAAI,GAAG;AAAA,EAC3B;AAAA,EAEA,MAAM,IAAI,KAAa,OAA8B;AACnD,SAAK,MAAM,IAAI,KAAK,KAAK;AAAA,EAC3B;AAAA,EAEA,MAAM,OAAO,KAA4B;AACvC,SAAK,MAAM,OAAO,GAAG;AAAA,EACvB;AACF;AAEO,IAAM,mBAAN,MAAsD;AAAA,EAG3D,YACE,aACiB,SACjB;AADiB;AAEjB,SAAK,SAAS,OAAO,WAAW;AAAA,EAClC;AAAA,EAEA,MAAM,IAAO,KAAqC;AAChD,UAAM,MAAM,MAAM,KAAK,QAAQ,IAAI,KAAK,SAAS,GAAG;AACpD,QAAI,QAAQ,OAAW,QAAO;AAC9B,WAAO,KAAK,MAAM,GAAG;AAAA,EACvB;AAAA,EAEA,MAAM,IAAO,KAAa,OAAyB;AACjD,UAAM,KAAK,QAAQ,IAAI,KAAK,SAAS,KAAK,KAAK,UAAU,KAAK,CAAC;AAAA,EACjE;AAAA,EAEA,MAAM,OAAO,KAA4B;AACvC,UAAM,KAAK,QAAQ,OAAO,KAAK,SAAS,GAAG;AAAA,EAC7C;AACF;;;AC7CO,IAAM,oBAAN,MAAwB;AAAA,EAAxB;AACL,SAAQ,aAAa,oBAAI,IAA2B;AACpD,SAAQ,QAAQ,oBAAI,IAAgC;AACpD;AAAA,SAAQ,gBAAgB,oBAAI,IAAgC;AAC5D;AAAA,SAAQ,qBAA6C;AACrD;AAAA,SAAQ,YAAY,oBAAI,IAAgB;AAAA;AAAA,EAExC,SAAS,MAA2B;AAClC,SAAK,WAAW,IAAI,KAAK,IAAI,EAAE,GAAG,KAAK,CAAC;AACxC,SAAK,OAAO;AAAA,EACd;AAAA,EAEA,IAAI,IAAuC;AACzC,UAAM,OAAO,KAAK,WAAW,IAAI,EAAE;AACnC,WAAO,OAAO,EAAE,GAAG,KAAK,IAAI;AAAA,EAC9B;AAAA,EAEA,SAAS,IAAwC;AAC/C,WAAO,KAAK,WAAW,IAAI,EAAE,GAAG;AAAA,EAClC;AAAA,EAEA,SAA0B;AACxB,WAAO,MAAM,KAAK,KAAK,WAAW,OAAO,CAAC,EAAE,IAAI,QAAM,EAAE,GAAG,EAAE,EAAE;AAAA,EACjE;AAAA,EAEA,SAAS,IAAY,OAAuB,OAAsB;AAChE,UAAM,MAAM,KAAK,WAAW,IAAI,EAAE;AAClC,QAAI,CAAC,IAAK;AACV,QAAI,QAAQ;AACZ,QAAI,QAAQ,UAAU,WAAW,QAAQ;AACzC,SAAK,OAAO;AAAA,EACd;AAAA,EAEA,OAAO,IAAkB;AACvB,SAAK,WAAW,OAAO,EAAE;AACzB,SAAK,wBAAwB,EAAE;AAAA,EACjC;AAAA;AAAA,EAIA,aAAa,cAA4C;AACvD,UAAM,EAAE,KAAK,IAAI;AACjB,QAAI,CAAC,KAAK,MAAM,IAAI,IAAI,EAAG,MAAK,MAAM,IAAI,MAAM,CAAC,CAAC;AAClD,SAAK,MAAM,IAAI,IAAI,EAAG,KAAK,YAAY;AACvC,SAAK,OAAO;AACZ,WAAO,MAAM;AACX,YAAM,OAAO,KAAK,MAAM,IAAI,IAAI;AAChC,UAAI,CAAC,KAAM;AACX,YAAM,MAAM,KAAK,QAAQ,YAAY;AACrC,UAAI,OAAO,EAAG,MAAK,OAAO,KAAK,CAAC;AAChC,WAAK,OAAO;AAAA,IACd;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,wBAAyC;AACvC,QAAI,KAAK,uBAAuB,MAAM;AACpC,WAAK,qBAAqB,MAAM,KAAK,KAAK,WAAW,OAAO,CAAC,EAAE,IAAI,QAAM,EAAE,GAAG,EAAE,EAAE;AAAA,IACpF;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,gBAAgB,MAAkC;AAChD,QAAI,CAAC,KAAK,cAAc,IAAI,IAAI,GAAG;AACjC,YAAM,UAAU,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK;AACpF,WAAK,cAAc,IAAI,MAAM,MAAM;AAAA,IACrC;AACA,WAAO,KAAK,cAAc,IAAI,IAAI;AAAA,EACpC;AAAA,EAEA,wBAAwB,aAA2B;AACjD,eAAW,CAAC,MAAM,aAAa,KAAK,KAAK,OAAO;AAC9C,WAAK,MAAM;AAAA,QACT;AAAA,QACA,cAAc,OAAO,OAAK,EAAE,gBAAgB,WAAW;AAAA,MACzD;AAAA,IACF;AACA,SAAK,OAAO;AAAA,EACd;AAAA;AAAA,EAIA,SAAS,UAAkC;AACzC,SAAK,UAAU,IAAI,QAAQ;AAC3B,WAAO,MAAM;AACX,WAAK,UAAU,OAAO,QAAQ;AAAA,IAChC;AAAA,EACF;AAAA,EAEQ,SAAe;AACrB,SAAK,cAAc,MAAM;AACzB,SAAK,qBAAqB;AAC1B,eAAW,YAAY,KAAK,WAAW;AACrC,eAAS;AAAA,IACX;AAAA,EACF;AAAA,EAEA,QAAc;AACZ,SAAK,WAAW,MAAM;AACtB,SAAK,MAAM,MAAM;AACjB,SAAK,cAAc,MAAM;AACzB,SAAK,qBAAqB;AAC1B,SAAK,OAAO;AAAA,EACd;AACF;;;ACjHA,mBAAuE;AA8D7D;;;AC9DV,IAAAA,gBAAiD;AAsCzC,IAAAC,sBAAA;AAzBR,IAAM,uBAAmB,6BAAgD,IAAI;AAC7E,IAAM,6BAAyB,6BAAsC,IAAI;AACzE,IAAM,2BAAuB,6BAAoC,IAAI;;;ACfrE,IAAAC,gBAAqC;;;ACArC,IAAAC,gBAAoC;;;ACApC,IAAAC,gBAAoC;;;ACApC,IAAAC,gBAAqC;;;ACArC,IAAAC,gBAAqC;","names":["import_react","import_jsx_runtime","import_react","import_react","import_react","import_react","import_react"]}

package/dist/index.mjs

@@ -0,0 +1,231 @@
+// ../flowstate-app-framework/src/extensions/DisposableStore.ts
+var DisposableStore = class {
+  constructor() {
+    this.disposables = [];
+  }
+  get size() {
+    return this.disposables.length;
+  }
+  add(disposable) {
+    this.disposables.push(disposable);
+    return disposable;
+  }
+  disposeAll() {
+    const toDispose = this.disposables.splice(0);
+    for (const d of toDispose) {
+      try {
+        d.dispose();
+      } catch {
+      }
+    }
+  }
+};
+
+// ../flowstate-app-framework/src/extensions/PermissionEnforcer.ts
+var PermissionEnforcer = class {
+  constructor(permissions) {
+    this.permissions = new Set(permissions);
+    this.networkDomains = new Set(
+      permissions.filter((p) => p.startsWith("network:")).map((p) => p.slice("network:".length))
+    );
+  }
+  hasPermission(permission) {
+    return this.permissions.has(permission);
+  }
+  assertPermission(permission) {
+    if (!this.hasPermission(permission)) {
+      throw new Error(`Extension lacks permission: ${permission}`);
+    }
+  }
+  canAccessNetwork(url) {
+    if (this.networkDomains.size === 0) return false;
+    try {
+      const parsed = new URL(url);
+      const host = parsed.host;
+      return this.networkDomains.has(host) || this.networkDomains.has(parsed.hostname);
+    } catch {
+      return false;
+    }
+  }
+  assertNetworkAccess(url) {
+    if (!this.canAccessNetwork(url)) {
+      let domain = url;
+      try {
+        domain = new URL(url).host;
+      } catch {
+      }
+      throw new Error(`Network access denied for domain: ${domain}`);
+    }
+  }
+};
+
+// ../flowstate-app-framework/src/extensions/ExtensionStorage.ts
+var InMemoryStorageBackend = class {
+  constructor() {
+    this.store = /* @__PURE__ */ new Map();
+  }
+  async get(key) {
+    return this.store.get(key);
+  }
+  async set(key, value) {
+    this.store.set(key, value);
+  }
+  async delete(key) {
+    this.store.delete(key);
+  }
+};
+var ExtensionStorage = class {
+  constructor(extensionId, backend) {
+    this.backend = backend;
+    this.prefix = `ext:${extensionId}:`;
+  }
+  async get(key) {
+    const raw = await this.backend.get(this.prefix + key);
+    if (raw === void 0) return void 0;
+    return JSON.parse(raw);
+  }
+  async set(key, value) {
+    await this.backend.set(this.prefix + key, JSON.stringify(value));
+  }
+  async delete(key) {
+    await this.backend.delete(this.prefix + key);
+  }
+};
+
+// ../flowstate-app-framework/src/extensions/ExtensionRegistry.ts
+var ExtensionRegistry = class {
+  constructor() {
+    this.extensions = /* @__PURE__ */ new Map();
+    this.views = /* @__PURE__ */ new Map();
+    // slot -> contributions
+    this.viewSnapshots = /* @__PURE__ */ new Map();
+    // memoized for useSyncExternalStore
+    this.extensionsSnapshot = null;
+    // memoized for useSyncExternalStore
+    this.listeners = /* @__PURE__ */ new Set();
+  }
+  register(info) {
+    this.extensions.set(info.id, { ...info });
+    this.notify();
+  }
+  get(id) {
+    const info = this.extensions.get(id);
+    return info ? { ...info } : void 0;
+  }
+  getState(id) {
+    return this.extensions.get(id)?.state;
+  }
+  getAll() {
+    return Array.from(this.extensions.values()).map((e) => ({ ...e }));
+  }
+  setState(id, state, error) {
+    const ext = this.extensions.get(id);
+    if (!ext) return;
+    ext.state = state;
+    ext.error = state === "failed" ? error : void 0;
+    this.notify();
+  }
+  remove(id) {
+    this.extensions.delete(id);
+    this.removeViewsForExtension(id);
+  }
+  // View contribution management
+  registerView(contribution) {
+    const { slot } = contribution;
+    if (!this.views.has(slot)) this.views.set(slot, []);
+    this.views.get(slot).push(contribution);
+    this.notify();
+    return () => {
+      const list = this.views.get(slot);
+      if (!list) return;
+      const idx = list.indexOf(contribution);
+      if (idx >= 0) list.splice(idx, 1);
+      this.notify();
+    };
+  }
+  // Returns a stable memoized snapshot of all extensions for useSyncExternalStore.
+  // useSyncExternalStore compares snapshot references with Object.is, so returning
+  // a new array on every call would cause infinite re-renders.
+  // The cache is cleared on every notify() call so stale data is never served.
+  getExtensionsSnapshot() {
+    if (this.extensionsSnapshot === null) {
+      this.extensionsSnapshot = Array.from(this.extensions.values()).map((e) => ({ ...e }));
+    }
+    return this.extensionsSnapshot;
+  }
+  // Returns a memoized snapshot for useSyncExternalStore compatibility.
+  // useSyncExternalStore compares snapshot references with Object.is, so
+  // returning a new array on every call would cause infinite re-renders.
+  // The cache is cleared on every notify() call so stale data is never served.
+  getViewsForSlot(slot) {
+    if (!this.viewSnapshots.has(slot)) {
+      const sorted = (this.views.get(slot) ?? []).slice().sort((a, b) => a.order - b.order);
+      this.viewSnapshots.set(slot, sorted);
+    }
+    return this.viewSnapshots.get(slot);
+  }
+  removeViewsForExtension(extensionId) {
+    for (const [slot, contributions] of this.views) {
+      this.views.set(
+        slot,
+        contributions.filter((c) => c.extensionId !== extensionId)
+      );
+    }
+    this.notify();
+  }
+  // Change notification
+  onChange(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  notify() {
+    this.viewSnapshots.clear();
+    this.extensionsSnapshot = null;
+    for (const listener of this.listeners) {
+      listener();
+    }
+  }
+  clear() {
+    this.extensions.clear();
+    this.views.clear();
+    this.viewSnapshots.clear();
+    this.extensionsSnapshot = null;
+    this.notify();
+  }
+};
+
+// ../flowstate-app-framework/src/extensions/ExtensionSlot.tsx
+import React, { Component, useSyncExternalStore } from "react";
+import { jsx } from "react/jsx-runtime";
+
+// ../flowstate-app-framework/src/extensions/ExtensionHostContext.tsx
+import React2, { createContext, useContext } from "react";
+import { jsx as jsx2 } from "react/jsx-runtime";
+var ExtensionHostCtx = createContext(null);
+var McpToolRegistryContext = createContext(null);
+var ThemeRegistryContext = createContext(null);
+
+// ../flowstate-app-framework/src/extensions/hooks/useExtensions.ts
+import { useSyncExternalStore as useSyncExternalStore2 } from "react";
+
+// ../flowstate-app-framework/src/extensions/hooks/useMarketplaceSearch.ts
+import { useEffect, useState } from "react";
+
+// ../flowstate-app-framework/src/extensions/hooks/useExtensionUpdates.ts
+import { useEffect as useEffect2, useState as useState2 } from "react";
+
+// ../flowstate-app-framework/src/extensions/hooks/useMcpTools.ts
+import { useSyncExternalStore as useSyncExternalStore3 } from "react";
+
+// ../flowstate-app-framework/src/extensions/hooks/useActiveTheme.ts
+import { useSyncExternalStore as useSyncExternalStore4 } from "react";
+export {
+  DisposableStore,
+  ExtensionRegistry,
+  ExtensionStorage,
+  InMemoryStorageBackend,
+  PermissionEnforcer
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../flowstate-app-framework/src/extensions/DisposableStore.ts","../../flowstate-app-framework/src/extensions/PermissionEnforcer.ts","../../flowstate-app-framework/src/extensions/ExtensionStorage.ts","../../flowstate-app-framework/src/extensions/ExtensionRegistry.ts","../../flowstate-app-framework/src/extensions/ExtensionSlot.tsx","../../flowstate-app-framework/src/extensions/ExtensionHostContext.tsx","../../flowstate-app-framework/src/extensions/hooks/useExtensions.ts","../../flowstate-app-framework/src/extensions/hooks/useMarketplaceSearch.ts","../../flowstate-app-framework/src/extensions/hooks/useExtensionUpdates.ts","../../flowstate-app-framework/src/extensions/hooks/useMcpTools.ts","../../flowstate-app-framework/src/extensions/hooks/useActiveTheme.ts"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport type { Disposable } from './types'\n\nexport class DisposableStore {\n  private disposables: Disposable[] = []\n\n  get size(): number {\n    return this.disposables.length\n  }\n\n  add<T extends Disposable>(disposable: T): T {\n    this.disposables.push(disposable)\n    return disposable\n  }\n\n  disposeAll(): void {\n    const toDispose = this.disposables.splice(0)\n    for (const d of toDispose) {\n      try {\n        d.dispose()\n      } catch {\n        // Swallow errors — continue disposing remaining items\n      }\n    }\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nexport class PermissionEnforcer {\n  private readonly permissions: Set<string>\n  private readonly networkDomains: Set<string>\n\n  constructor(permissions: string[]) {\n    this.permissions = new Set(permissions)\n    this.networkDomains = new Set(\n      permissions.filter(p => p.startsWith('network:')).map(p => p.slice('network:'.length))\n    )\n  }\n\n  hasPermission(permission: string): boolean {\n    return this.permissions.has(permission)\n  }\n\n  assertPermission(permission: string): void {\n    if (!this.hasPermission(permission)) {\n      throw new Error(`Extension lacks permission: ${permission}`)\n    }\n  }\n\n  canAccessNetwork(url: string): boolean {\n    if (this.networkDomains.size === 0) return false\n    try {\n      const parsed = new URL(url)\n      const host = parsed.host // includes port if present\n      return this.networkDomains.has(host) || this.networkDomains.has(parsed.hostname)\n    } catch {\n      return false\n    }\n  }\n\n  assertNetworkAccess(url: string): void {\n    if (!this.canAccessNetwork(url)) {\n      let domain = url\n      try {\n        domain = new URL(url).host\n      } catch {\n        // Use raw URL if parsing fails\n      }\n      throw new Error(`Network access denied for domain: ${domain}`)\n    }\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport type { ExtensionStorageAPI } from './types'\n\nexport interface StorageBackend {\n  get(key: string): Promise<string | undefined>\n  set(key: string, value: string): Promise<void>\n  delete(key: string): Promise<void>\n}\n\nexport class InMemoryStorageBackend implements StorageBackend {\n  private store = new Map<string, string>()\n\n  async get(key: string): Promise<string | undefined> {\n    return this.store.get(key)\n  }\n\n  async set(key: string, value: string): Promise<void> {\n    this.store.set(key, value)\n  }\n\n  async delete(key: string): Promise<void> {\n    this.store.delete(key)\n  }\n}\n\nexport class ExtensionStorage implements ExtensionStorageAPI {\n  private readonly prefix: string\n\n  constructor(\n    extensionId: string,\n    private readonly backend: StorageBackend\n  ) {\n    this.prefix = `ext:${extensionId}:`\n  }\n\n  async get<T>(key: string): Promise<T | undefined> {\n    const raw = await this.backend.get(this.prefix + key)\n    if (raw === undefined) return undefined\n    return JSON.parse(raw) as T\n  }\n\n  async set<T>(key: string, value: T): Promise<void> {\n    await this.backend.set(this.prefix + key, JSON.stringify(value))\n  }\n\n  async delete(key: string): Promise<void> {\n    await this.backend.delete(this.prefix + key)\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport type { ExtensionInfo, ExtensionState, ViewContribution } from './types'\n\nexport class ExtensionRegistry {\n  private extensions = new Map<string, ExtensionInfo>()\n  private views = new Map<string, ViewContribution[]>() // slot -> contributions\n  private viewSnapshots = new Map<string, ViewContribution[]>() // memoized for useSyncExternalStore\n  private extensionsSnapshot: ExtensionInfo[] | null = null // memoized for useSyncExternalStore\n  private listeners = new Set<() => void>()\n\n  register(info: ExtensionInfo): void {\n    this.extensions.set(info.id, { ...info })\n    this.notify()\n  }\n\n  get(id: string): ExtensionInfo | undefined {\n    const info = this.extensions.get(id)\n    return info ? { ...info } : undefined\n  }\n\n  getState(id: string): ExtensionState | undefined {\n    return this.extensions.get(id)?.state\n  }\n\n  getAll(): ExtensionInfo[] {\n    return Array.from(this.extensions.values()).map(e => ({ ...e }))\n  }\n\n  setState(id: string, state: ExtensionState, error?: string): void {\n    const ext = this.extensions.get(id)\n    if (!ext) return\n    ext.state = state\n    ext.error = state === 'failed' ? error : undefined\n    this.notify()\n  }\n\n  remove(id: string): void {\n    this.extensions.delete(id)\n    this.removeViewsForExtension(id) // calls notify() internally\n  }\n\n  // View contribution management\n\n  registerView(contribution: ViewContribution): () => void {\n    const { slot } = contribution\n    if (!this.views.has(slot)) this.views.set(slot, [])\n    this.views.get(slot)!.push(contribution)\n    this.notify()\n    return () => {\n      const list = this.views.get(slot)\n      if (!list) return\n      const idx = list.indexOf(contribution)\n      if (idx >= 0) list.splice(idx, 1)\n      this.notify()\n    }\n  }\n\n  // Returns a stable memoized snapshot of all extensions for useSyncExternalStore.\n  // useSyncExternalStore compares snapshot references with Object.is, so returning\n  // a new array on every call would cause infinite re-renders.\n  // The cache is cleared on every notify() call so stale data is never served.\n  getExtensionsSnapshot(): ExtensionInfo[] {\n    if (this.extensionsSnapshot === null) {\n      this.extensionsSnapshot = Array.from(this.extensions.values()).map(e => ({ ...e }))\n    }\n    return this.extensionsSnapshot\n  }\n\n  // Returns a memoized snapshot for useSyncExternalStore compatibility.\n  // useSyncExternalStore compares snapshot references with Object.is, so\n  // returning a new array on every call would cause infinite re-renders.\n  // The cache is cleared on every notify() call so stale data is never served.\n  getViewsForSlot(slot: string): ViewContribution[] {\n    if (!this.viewSnapshots.has(slot)) {\n      const sorted = (this.views.get(slot) ?? []).slice().sort((a, b) => a.order - b.order)\n      this.viewSnapshots.set(slot, sorted)\n    }\n    return this.viewSnapshots.get(slot)!\n  }\n\n  removeViewsForExtension(extensionId: string): void {\n    for (const [slot, contributions] of this.views) {\n      this.views.set(\n        slot,\n        contributions.filter(c => c.extensionId !== extensionId)\n      )\n    }\n    this.notify()\n  }\n\n  // Change notification\n\n  onChange(listener: () => void): () => void {\n    this.listeners.add(listener)\n    return () => {\n      this.listeners.delete(listener)\n    }\n  }\n\n  private notify(): void {\n    this.viewSnapshots.clear() // invalidate memoized snapshots\n    this.extensionsSnapshot = null // invalidate extensions snapshot\n    for (const listener of this.listeners) {\n      listener()\n    }\n  }\n\n  clear(): void {\n    this.extensions.clear()\n    this.views.clear()\n    this.viewSnapshots.clear()\n    this.extensionsSnapshot = null\n    this.notify()\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport React, { Component, useSyncExternalStore, type ReactNode } from 'react'\nimport type { ExtensionRegistry } from './ExtensionRegistry'\n\n// Error boundary per contribution\ninterface SlotErrorBoundaryProps {\n  extensionId: string\n  children: ReactNode\n}\n\ninterface SlotErrorBoundaryState {\n  hasError: boolean\n}\n\nclass SlotErrorBoundary extends Component<SlotErrorBoundaryProps, SlotErrorBoundaryState> {\n  state: SlotErrorBoundaryState = { hasError: false }\n\n  static getDerivedStateFromError(): SlotErrorBoundaryState {\n    return { hasError: true }\n  }\n\n  componentDidCatch(error: Error) {\n    console.error(`[ExtensionSlot] Extension \"${this.props.extensionId}\" threw:`, error)\n  }\n\n  render() {\n    if (this.state.hasError) return null\n    return this.props.children\n  }\n}\n\n// ExtensionSlot component\nexport interface ExtensionSlotProps {\n  name: string\n  context: Record<string, unknown>\n  registry: ExtensionRegistry\n  activationEngine?: { triggerEvent(event: string): Promise<void> }\n  className?: string\n}\n\nexport function ExtensionSlot({\n  name,\n  context,\n  registry,\n  activationEngine,\n  className,\n}: ExtensionSlotProps) {\n  // Trigger lazy activation for extensions listening to onView:<slot>\n  React.useEffect(() => {\n    activationEngine?.triggerEvent(`onView:${name}`)\n  }, [activationEngine, name])\n\n  const views = useSyncExternalStore(\n    onStoreChange => registry.onChange(onStoreChange),\n    () => registry.getViewsForSlot(name)\n  )\n\n  if (views.length === 0) return null\n\n  return (\n    <div className={className} data-extension-slot={name}>\n      {views.map((view, i) => (\n        <SlotErrorBoundary key={`${view.extensionId}-${i}`} extensionId={view.extensionId}>\n          <view.component {...context} />\n        </SlotErrorBoundary>\n      ))}\n    </div>\n  )\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport React, { createContext, useContext } from 'react'\nimport type { ExtensionHost } from './types'\nimport type { ExtensionRegistry } from './ExtensionRegistry'\nimport type { ActivationEngine } from './ActivationEngine'\nimport type { McpToolRegistry } from './McpToolRegistry'\nimport type { ThemeRegistry } from './ThemeRegistry'\n\ninterface ExtensionHostContextValue {\n  registry: ExtensionRegistry\n  host: ExtensionHost | null\n  engine: ActivationEngine | null\n}\n\nconst ExtensionHostCtx = createContext<ExtensionHostContextValue | null>(null)\nconst McpToolRegistryContext = createContext<McpToolRegistry | null>(null)\nconst ThemeRegistryContext = createContext<ThemeRegistry | null>(null)\n\nexport interface ExtensionHostProviderProps {\n  registry: ExtensionRegistry\n  host: ExtensionHost | null\n  engine: ActivationEngine | null\n  mcpToolRegistry?: McpToolRegistry | null\n  themeRegistry?: ThemeRegistry | null\n  children: React.ReactNode\n}\n\nexport function ExtensionHostProvider({\n  registry,\n  host,\n  engine,\n  mcpToolRegistry,\n  themeRegistry,\n  children,\n}: ExtensionHostProviderProps) {\n  const value = React.useMemo(() => ({ registry, host, engine }), [registry, host, engine])\n  return (\n    <ThemeRegistryContext.Provider value={themeRegistry ?? null}>\n      <McpToolRegistryContext.Provider value={mcpToolRegistry ?? null}>\n        <ExtensionHostCtx.Provider value={value}>{children}</ExtensionHostCtx.Provider>\n      </McpToolRegistryContext.Provider>\n    </ThemeRegistryContext.Provider>\n  )\n}\n\nfunction useExtensionHostContext(): ExtensionHostContextValue {\n  const ctx = useContext(ExtensionHostCtx)\n  if (!ctx) throw new Error('Extension hooks must be used within ExtensionHostProvider')\n  return ctx\n}\n\nexport function useExtensionRegistry(): ExtensionRegistry {\n  return useExtensionHostContext().registry\n}\n\nexport function useExtensionHost(): ExtensionHost | null {\n  return useExtensionHostContext().host\n}\n\nexport function useActivationEngine(): ActivationEngine | null {\n  return useExtensionHostContext().engine\n}\n\nexport function useMcpToolRegistry(): McpToolRegistry | null {\n  const ctx = useContext(McpToolRegistryContext)\n  return ctx\n}\n\nexport function useThemeRegistry(): ThemeRegistry | null {\n  return useContext(ThemeRegistryContext)\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport { useSyncExternalStore } from 'react'\nimport type { ExtensionInfo, ExtensionState } from '../types'\nimport { useExtensionRegistry } from '../ExtensionHostContext'\n\nexport function useExtensions(): ExtensionInfo[] {\n  const registry = useExtensionRegistry()\n  return useSyncExternalStore(\n    cb => registry.onChange(cb),\n    () => registry.getExtensionsSnapshot()\n  )\n}\n\nexport function useExtensionState(id: string): ExtensionState | undefined {\n  const registry = useExtensionRegistry()\n  return useSyncExternalStore(\n    cb => registry.onChange(cb),\n    () => registry.getState(id)\n  )\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport { useEffect, useState } from 'react'\n\nexport interface MarketplaceSearchOptions {\n  baseUrl: string\n  query?: string\n  category?: string\n  type?: string\n  limit?: number\n}\n\nexport interface MarketplaceListingResult {\n  id: string\n  label: string\n  description: string\n  category: string\n  type: string\n  tags: string[]\n  iconUrl: string | null\n  author: string | null\n  downloadCount: number | null\n  pricing: string | null\n  priceUsdc: string | null\n}\n\nexport interface MarketplaceSearchResult {\n  results: MarketplaceListingResult[]\n  loading: boolean\n  error: string | null\n}\n\nexport function useMarketplaceSearch(options: MarketplaceSearchOptions): MarketplaceSearchResult {\n  const { baseUrl, query, category, type, limit } = options\n\n  const hasSearchParams = Boolean(query || category || type)\n\n  const [results, setResults] = useState<MarketplaceListingResult[]>([])\n  const [loading, setLoading] = useState(false)\n  const [error, setError] = useState<string | null>(null)\n\n  useEffect(() => {\n    if (!hasSearchParams) {\n      setResults([])\n      setLoading(false)\n      setError(null)\n      return\n    }\n\n    setLoading(true)\n    setError(null)\n\n    const controller = new AbortController()\n\n    const timer = setTimeout(async () => {\n      const params = new URLSearchParams()\n      if (query) params.set('q', query)\n      if (category) params.set('category', category)\n      if (type) params.set('type', type)\n      params.set('limit', String(limit ?? 20))\n\n      const url = `${baseUrl}/api/listings?${params.toString()}`\n\n      try {\n        const response = await fetch(url, { signal: controller.signal })\n\n        if (!response.ok) {\n          setError(`Request failed with status ${response.status}`)\n          setResults([])\n          setLoading(false)\n          return\n        }\n\n        const data = await response.json()\n        setResults(data.listings ?? [])\n        setError(null)\n      } catch (err) {\n        if (err instanceof DOMException && err.name === 'AbortError') {\n          // Fetch was aborted by cleanup — do not update state\n          return\n        }\n        setError(err instanceof Error ? err.message : 'Unknown error')\n        setResults([])\n      } finally {\n        // Only clear loading if the fetch was not aborted\n        if (!controller.signal.aborted) {\n          setLoading(false)\n        }\n      }\n    }, 300)\n\n    return () => {\n      clearTimeout(timer)\n      controller.abort()\n    }\n  }, [baseUrl, query, category, type, limit, hasSearchParams])\n\n  return { results, loading, error }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport { useEffect, useState } from 'react'\nimport { useExtensionHost } from '../ExtensionHostContext'\nimport type { UpdateInfo } from '../types'\n\nexport function useExtensionUpdates(): { updates: UpdateInfo[]; loading: boolean } {\n  const host = useExtensionHost()\n  const [updates, setUpdates] = useState<UpdateInfo[]>([])\n  const [loading, setLoading] = useState(false)\n\n  useEffect(() => {\n    if (!host) return\n    let cancelled = false\n    setLoading(true)\n    host\n      .checkForUpdates()\n      .then(result => {\n        if (!cancelled) {\n          setUpdates(result)\n          setLoading(false)\n        }\n      })\n      .catch(() => {\n        if (!cancelled) setLoading(false)\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [host])\n\n  return { updates, loading }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport { useSyncExternalStore } from 'react'\nimport type { McpToolRegistry } from '../McpToolRegistry'\nimport type { RegisteredMcpTool } from '../types'\n\n/**\n * React hook that subscribes to the McpToolRegistry and returns\n * the current list of registered MCP tools. Re-renders when tools\n * are added or removed.\n */\nexport function useMcpTools(registry: McpToolRegistry): RegisteredMcpTool[] {\n  return useSyncExternalStore(\n    onStoreChange => registry.onChange(onStoreChange),\n    () => registry.getToolsSnapshot()\n  )\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport { useSyncExternalStore } from 'react'\nimport type { ThemeRegistry, RegisteredTheme } from '../ThemeRegistry'\n\nexport function useActiveTheme(registry: ThemeRegistry): RegisteredTheme | null {\n  return useSyncExternalStore(\n    onStoreChange => registry.onChange(onStoreChange),\n    () => registry.getActiveThemeSnapshot()\n  )\n}\n"],"mappings":"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","names":["React","jsx","useSyncExternalStore","useEffect","useState","useSyncExternalStore","useSyncExternalStore"]}

package/dist/testing/index.d.mts

@@ -0,0 +1,31 @@
+import { AuthService, NetworkService, EventBusService, PlatformEvent, ExtensionStorageAPI, ExtensionContext, ViewContribution } from '@epicdm/flowstate-app-framework/extensions';
+
+interface MockUser {
+    id: string;
+    email: string;
+    name: string;
+}
+declare function createMockAuthService(user?: MockUser | null): AuthService;
+declare function createMockNetworkService(fetchImpl?: (url: string, init?: RequestInit) => Promise<Response>): NetworkService;
+declare function createMockEventBusService(): EventBusService & {
+    emit: (event: PlatformEvent, ...args: unknown[]) => void;
+};
+declare function createMockStorage(): ExtensionStorageAPI;
+
+interface MockContextOptions {
+    extensionId?: string;
+    extensionVersion?: string;
+    /** Pass null to simulate an unauthenticated session. */
+    user?: MockUser | null;
+    fetch?: (url: string, init?: RequestInit) => Promise<Response>;
+    permissions?: string[];
+}
+interface MockExtensionContext extends ExtensionContext {
+    /** Returns all views contributed to a named slot — use in test assertions. */
+    getContributedViews(slot: string): ViewContribution[];
+    /** Calls dispose() on every entry in subscriptions and clears the array. */
+    cleanup(): void;
+}
+declare function createMockContext(options?: MockContextOptions): MockExtensionContext;
+
+export { type MockContextOptions, type MockExtensionContext, type MockUser, createMockAuthService, createMockContext, createMockEventBusService, createMockNetworkService, createMockStorage };

package/dist/testing/index.d.ts

@@ -0,0 +1,31 @@
+import { AuthService, NetworkService, EventBusService, PlatformEvent, ExtensionStorageAPI, ExtensionContext, ViewContribution } from '@epicdm/flowstate-app-framework/extensions';
+
+interface MockUser {
+    id: string;
+    email: string;
+    name: string;
+}
+declare function createMockAuthService(user?: MockUser | null): AuthService;
+declare function createMockNetworkService(fetchImpl?: (url: string, init?: RequestInit) => Promise<Response>): NetworkService;
+declare function createMockEventBusService(): EventBusService & {
+    emit: (event: PlatformEvent, ...args: unknown[]) => void;
+};
+declare function createMockStorage(): ExtensionStorageAPI;
+
+interface MockContextOptions {
+    extensionId?: string;
+    extensionVersion?: string;
+    /** Pass null to simulate an unauthenticated session. */
+    user?: MockUser | null;
+    fetch?: (url: string, init?: RequestInit) => Promise<Response>;
+    permissions?: string[];
+}
+interface MockExtensionContext extends ExtensionContext {
+    /** Returns all views contributed to a named slot — use in test assertions. */
+    getContributedViews(slot: string): ViewContribution[];
+    /** Calls dispose() on every entry in subscriptions and clears the array. */
+    cleanup(): void;
+}
+declare function createMockContext(options?: MockContextOptions): MockExtensionContext;
+
+export { type MockContextOptions, type MockExtensionContext, type MockUser, createMockAuthService, createMockContext, createMockEventBusService, createMockNetworkService, createMockStorage };

package/dist/testing/index.js

@@ -0,0 +1,172 @@
+"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);
+
+// src/testing/index.ts
+var testing_exports = {};
+__export(testing_exports, {
+  createMockAuthService: () => createMockAuthService,
+  createMockContext: () => createMockContext,
+  createMockEventBusService: () => createMockEventBusService,
+  createMockNetworkService: () => createMockNetworkService,
+  createMockStorage: () => createMockStorage
+});
+module.exports = __toCommonJS(testing_exports);
+
+// src/testing/mocks.ts
+var DEFAULT_USER = {
+  id: "test-user-id",
+  email: "test@example.com",
+  name: "Test User"
+};
+function createMockAuthService(user) {
+  const resolvedUser = user === null ? null : user ?? DEFAULT_USER;
+  return {
+    getCurrentUser: () => resolvedUser,
+    getActiveOrgId: () => resolvedUser ? "test-org-id" : null,
+    getAccessToken: async () => resolvedUser ? "mock-access-token" : null
+  };
+}
+function createMockNetworkService(fetchImpl) {
+  const defaultFetch = async (_url, _init) => new Response(JSON.stringify({}), {
+    status: 200,
+    headers: { "Content-Type": "application/json" }
+  });
+  const resolved = fetchImpl ?? defaultFetch;
+  return {
+    // Always forward init explicitly so mock assertions on argument count are predictable
+    fetch: (url, init) => resolved(url, init)
+  };
+}
+function createMockEventBusService() {
+  const handlers = /* @__PURE__ */ new Map();
+  return {
+    on(event, handler) {
+      if (!handlers.has(event)) handlers.set(event, /* @__PURE__ */ new Set());
+      handlers.get(event).add(handler);
+      return {
+        dispose: () => {
+          handlers.get(event)?.delete(handler);
+        }
+      };
+    },
+    emit(event, ...args) {
+      handlers.get(event)?.forEach((h) => h(...args));
+    }
+  };
+}
+function createMockStorage() {
+  const store = /* @__PURE__ */ new Map();
+  return {
+    async get(key) {
+      const raw = store.get(key);
+      return raw ? JSON.parse(raw) : void 0;
+    },
+    async set(key, value) {
+      store.set(key, JSON.stringify(value));
+    },
+    async delete(key) {
+      store.delete(key);
+    }
+  };
+}
+
+// src/testing/createMockContext.ts
+function createMockContext(options = {}) {
+  const {
+    extensionId = "test-extension",
+    extensionVersion = "1.0.0",
+    user,
+    fetch: fetchImpl
+  } = options;
+  const storage = createMockStorage();
+  const eventBus = createMockEventBusService();
+  const subscriptions = [];
+  const views = /* @__PURE__ */ new Map();
+  const ctx = {
+    extensionId,
+    extensionVersion,
+    storage,
+    services: {
+      auth: createMockAuthService(user),
+      network: createMockNetworkService(fetchImpl),
+      events: eventBus
+    },
+    subscriptions,
+    contributeView(slot, component) {
+      const contribution = {
+        extensionId,
+        slot,
+        component,
+        order: views.get(slot)?.length ?? 0
+      };
+      if (!views.has(slot)) views.set(slot, []);
+      views.get(slot).push(contribution);
+      const disposable = {
+        dispose: () => {
+          const list = views.get(slot);
+          if (list) {
+            const idx = list.indexOf(contribution);
+            if (idx >= 0) list.splice(idx, 1);
+          }
+        }
+      };
+      subscriptions.push(disposable);
+      return disposable;
+    },
+    contributeCommand(_id, _handler) {
+      return { dispose: () => {
+      } };
+    },
+    contributeSettingsTab(_config) {
+      return { dispose: () => {
+      } };
+    },
+    contributeStatusBarItem(_config) {
+      return { dispose: () => {
+      } };
+    },
+    registerSyncProvider(_factory) {
+      return { dispose: () => {
+      } };
+    },
+    registerMcpTool(_tool) {
+      return { dispose: () => {
+      } };
+    },
+    getContributedViews(slot) {
+      return views.get(slot) ?? [];
+    },
+    cleanup() {
+      for (const sub of subscriptions) {
+        sub.dispose();
+      }
+      subscriptions.length = 0;
+    }
+  };
+  return ctx;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createMockAuthService,
+  createMockContext,
+  createMockEventBusService,
+  createMockNetworkService,
+  createMockStorage
+});
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/index.ts","../../src/testing/mocks.ts","../../src/testing/createMockContext.ts"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nexport {\n  createMockContext,\n  type MockContextOptions,\n  type MockExtensionContext,\n} from './createMockContext'\nexport {\n  createMockAuthService,\n  createMockNetworkService,\n  createMockEventBusService,\n  createMockStorage,\n  type MockUser,\n} from './mocks'\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport type {\n  AuthService,\n  NetworkService,\n  EventBusService,\n  ExtensionStorageAPI,\n  Disposable,\n  PlatformEvent,\n} from '../index'\n\nexport interface MockUser {\n  id: string\n  email: string\n  name: string\n}\n\nconst DEFAULT_USER: MockUser = {\n  id: 'test-user-id',\n  email: 'test@example.com',\n  name: 'Test User',\n}\n\nexport function createMockAuthService(user?: MockUser | null): AuthService {\n  const resolvedUser = user === null ? null : (user ?? DEFAULT_USER)\n  return {\n    getCurrentUser: () => resolvedUser,\n    getActiveOrgId: () => (resolvedUser ? 'test-org-id' : null),\n    getAccessToken: async () => (resolvedUser ? 'mock-access-token' : null),\n  }\n}\n\nexport function createMockNetworkService(\n  fetchImpl?: (url: string, init?: RequestInit) => Promise<Response>\n): NetworkService {\n  const defaultFetch = async (_url: string, _init?: RequestInit) =>\n    new Response(JSON.stringify({}), {\n      status: 200,\n      headers: { 'Content-Type': 'application/json' },\n    })\n  const resolved = fetchImpl ?? defaultFetch\n  return {\n    // Always forward init explicitly so mock assertions on argument count are predictable\n    fetch: (url: string, init?: RequestInit) => resolved(url, init),\n  }\n}\n\nexport function createMockEventBusService(): EventBusService & {\n  emit: (event: PlatformEvent, ...args: unknown[]) => void\n} {\n  const handlers = new Map<string, Set<(...args: unknown[]) => void>>()\n\n  return {\n    on(event: PlatformEvent, handler: (...args: unknown[]) => void): Disposable {\n      if (!handlers.has(event)) handlers.set(event, new Set())\n      // Non-null assertion is safe: we just set the key above\n      handlers.get(event)!.add(handler)\n      return {\n        dispose: () => {\n          handlers.get(event)?.delete(handler)\n        },\n      }\n    },\n    emit(event: PlatformEvent, ...args: unknown[]) {\n      handlers.get(event)?.forEach(h => h(...args))\n    },\n  }\n}\n\nexport function createMockStorage(): ExtensionStorageAPI {\n  const store = new Map<string, string>()\n  return {\n    async get<T>(key: string): Promise<T | undefined> {\n      const raw = store.get(key)\n      return raw ? (JSON.parse(raw) as T) : undefined\n    },\n    async set<T>(key: string, value: T): Promise<void> {\n      store.set(key, JSON.stringify(value))\n    },\n    async delete(key: string): Promise<void> {\n      store.delete(key)\n    },\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport type { ComponentType } from 'react'\nimport type {\n  ExtensionContext,\n  Disposable,\n  ViewContribution,\n  CommandHandler,\n  SettingsTabConfig,\n  StatusBarConfig,\n  SyncProviderFactory,\n  McpToolDefinition,\n} from '../index'\nimport {\n  createMockAuthService,\n  createMockNetworkService,\n  createMockEventBusService,\n  createMockStorage,\n  type MockUser,\n} from './mocks'\n\nexport interface MockContextOptions {\n  extensionId?: string\n  extensionVersion?: string\n  /** Pass null to simulate an unauthenticated session. */\n  user?: MockUser | null\n  fetch?: (url: string, init?: RequestInit) => Promise<Response>\n  permissions?: string[]\n}\n\nexport interface MockExtensionContext extends ExtensionContext {\n  /** Returns all views contributed to a named slot — use in test assertions. */\n  getContributedViews(slot: string): ViewContribution[]\n  /** Calls dispose() on every entry in subscriptions and clears the array. */\n  cleanup(): void\n}\n\nexport function createMockContext(options: MockContextOptions = {}): MockExtensionContext {\n  const {\n    extensionId = 'test-extension',\n    extensionVersion = '1.0.0',\n    user,\n    fetch: fetchImpl,\n  } = options\n\n  const storage = createMockStorage()\n  const eventBus = createMockEventBusService()\n  const subscriptions: Disposable[] = []\n  const views = new Map<string, ViewContribution[]>()\n\n  const ctx: MockExtensionContext = {\n    extensionId,\n    extensionVersion,\n    storage,\n    services: {\n      auth: createMockAuthService(user),\n      network: createMockNetworkService(fetchImpl),\n      events: eventBus,\n    },\n    subscriptions,\n\n    contributeView(slot: string, component: ComponentType<unknown>): Disposable {\n      const contribution: ViewContribution = {\n        extensionId,\n        slot,\n        component,\n        order: views.get(slot)?.length ?? 0,\n      }\n      if (!views.has(slot)) views.set(slot, [])\n      views.get(slot)!.push(contribution)\n      const disposable: Disposable = {\n        dispose: () => {\n          const list = views.get(slot)\n          if (list) {\n            const idx = list.indexOf(contribution)\n            if (idx >= 0) list.splice(idx, 1)\n          }\n        },\n      }\n      subscriptions.push(disposable)\n      return disposable\n    },\n\n    contributeCommand(_id: string, _handler: CommandHandler): Disposable {\n      return { dispose: () => {} }\n    },\n\n    contributeSettingsTab(_config: SettingsTabConfig): Disposable {\n      return { dispose: () => {} }\n    },\n\n    contributeStatusBarItem(_config: StatusBarConfig): Disposable {\n      return { dispose: () => {} }\n    },\n\n    registerSyncProvider(_factory: SyncProviderFactory): Disposable {\n      return { dispose: () => {} }\n    },\n\n    registerMcpTool(_tool: McpToolDefinition): Disposable {\n      return { dispose: () => {} }\n    },\n\n    getContributedViews(slot: string): ViewContribution[] {\n      return views.get(slot) ?? []\n    },\n\n    cleanup() {\n      for (const sub of subscriptions) {\n        sub.dispose()\n      }\n      // Clear in place so any reference held by the caller sees the empty array\n      subscriptions.length = 0\n    },\n  }\n\n  return ctx\n}\n"],"mappings":"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","names":[]}

package/dist/testing/index.mjs

@@ -0,0 +1,141 @@
+// src/testing/mocks.ts
+var DEFAULT_USER = {
+  id: "test-user-id",
+  email: "test@example.com",
+  name: "Test User"
+};
+function createMockAuthService(user) {
+  const resolvedUser = user === null ? null : user ?? DEFAULT_USER;
+  return {
+    getCurrentUser: () => resolvedUser,
+    getActiveOrgId: () => resolvedUser ? "test-org-id" : null,
+    getAccessToken: async () => resolvedUser ? "mock-access-token" : null
+  };
+}
+function createMockNetworkService(fetchImpl) {
+  const defaultFetch = async (_url, _init) => new Response(JSON.stringify({}), {
+    status: 200,
+    headers: { "Content-Type": "application/json" }
+  });
+  const resolved = fetchImpl ?? defaultFetch;
+  return {
+    // Always forward init explicitly so mock assertions on argument count are predictable
+    fetch: (url, init) => resolved(url, init)
+  };
+}
+function createMockEventBusService() {
+  const handlers = /* @__PURE__ */ new Map();
+  return {
+    on(event, handler) {
+      if (!handlers.has(event)) handlers.set(event, /* @__PURE__ */ new Set());
+      handlers.get(event).add(handler);
+      return {
+        dispose: () => {
+          handlers.get(event)?.delete(handler);
+        }
+      };
+    },
+    emit(event, ...args) {
+      handlers.get(event)?.forEach((h) => h(...args));
+    }
+  };
+}
+function createMockStorage() {
+  const store = /* @__PURE__ */ new Map();
+  return {
+    async get(key) {
+      const raw = store.get(key);
+      return raw ? JSON.parse(raw) : void 0;
+    },
+    async set(key, value) {
+      store.set(key, JSON.stringify(value));
+    },
+    async delete(key) {
+      store.delete(key);
+    }
+  };
+}
+
+// src/testing/createMockContext.ts
+function createMockContext(options = {}) {
+  const {
+    extensionId = "test-extension",
+    extensionVersion = "1.0.0",
+    user,
+    fetch: fetchImpl
+  } = options;
+  const storage = createMockStorage();
+  const eventBus = createMockEventBusService();
+  const subscriptions = [];
+  const views = /* @__PURE__ */ new Map();
+  const ctx = {
+    extensionId,
+    extensionVersion,
+    storage,
+    services: {
+      auth: createMockAuthService(user),
+      network: createMockNetworkService(fetchImpl),
+      events: eventBus
+    },
+    subscriptions,
+    contributeView(slot, component) {
+      const contribution = {
+        extensionId,
+        slot,
+        component,
+        order: views.get(slot)?.length ?? 0
+      };
+      if (!views.has(slot)) views.set(slot, []);
+      views.get(slot).push(contribution);
+      const disposable = {
+        dispose: () => {
+          const list = views.get(slot);
+          if (list) {
+            const idx = list.indexOf(contribution);
+            if (idx >= 0) list.splice(idx, 1);
+          }
+        }
+      };
+      subscriptions.push(disposable);
+      return disposable;
+    },
+    contributeCommand(_id, _handler) {
+      return { dispose: () => {
+      } };
+    },
+    contributeSettingsTab(_config) {
+      return { dispose: () => {
+      } };
+    },
+    contributeStatusBarItem(_config) {
+      return { dispose: () => {
+      } };
+    },
+    registerSyncProvider(_factory) {
+      return { dispose: () => {
+      } };
+    },
+    registerMcpTool(_tool) {
+      return { dispose: () => {
+      } };
+    },
+    getContributedViews(slot) {
+      return views.get(slot) ?? [];
+    },
+    cleanup() {
+      for (const sub of subscriptions) {
+        sub.dispose();
+      }
+      subscriptions.length = 0;
+    }
+  };
+  return ctx;
+}
+export {
+  createMockAuthService,
+  createMockContext,
+  createMockEventBusService,
+  createMockNetworkService,
+  createMockStorage
+};
+//# sourceMappingURL=index.mjs.map

package/dist/testing/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/mocks.ts","../../src/testing/createMockContext.ts"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport type {\n  AuthService,\n  NetworkService,\n  EventBusService,\n  ExtensionStorageAPI,\n  Disposable,\n  PlatformEvent,\n} from '../index'\n\nexport interface MockUser {\n  id: string\n  email: string\n  name: string\n}\n\nconst DEFAULT_USER: MockUser = {\n  id: 'test-user-id',\n  email: 'test@example.com',\n  name: 'Test User',\n}\n\nexport function createMockAuthService(user?: MockUser | null): AuthService {\n  const resolvedUser = user === null ? null : (user ?? DEFAULT_USER)\n  return {\n    getCurrentUser: () => resolvedUser,\n    getActiveOrgId: () => (resolvedUser ? 'test-org-id' : null),\n    getAccessToken: async () => (resolvedUser ? 'mock-access-token' : null),\n  }\n}\n\nexport function createMockNetworkService(\n  fetchImpl?: (url: string, init?: RequestInit) => Promise<Response>\n): NetworkService {\n  const defaultFetch = async (_url: string, _init?: RequestInit) =>\n    new Response(JSON.stringify({}), {\n      status: 200,\n      headers: { 'Content-Type': 'application/json' },\n    })\n  const resolved = fetchImpl ?? defaultFetch\n  return {\n    // Always forward init explicitly so mock assertions on argument count are predictable\n    fetch: (url: string, init?: RequestInit) => resolved(url, init),\n  }\n}\n\nexport function createMockEventBusService(): EventBusService & {\n  emit: (event: PlatformEvent, ...args: unknown[]) => void\n} {\n  const handlers = new Map<string, Set<(...args: unknown[]) => void>>()\n\n  return {\n    on(event: PlatformEvent, handler: (...args: unknown[]) => void): Disposable {\n      if (!handlers.has(event)) handlers.set(event, new Set())\n      // Non-null assertion is safe: we just set the key above\n      handlers.get(event)!.add(handler)\n      return {\n        dispose: () => {\n          handlers.get(event)?.delete(handler)\n        },\n      }\n    },\n    emit(event: PlatformEvent, ...args: unknown[]) {\n      handlers.get(event)?.forEach(h => h(...args))\n    },\n  }\n}\n\nexport function createMockStorage(): ExtensionStorageAPI {\n  const store = new Map<string, string>()\n  return {\n    async get<T>(key: string): Promise<T | undefined> {\n      const raw = store.get(key)\n      return raw ? (JSON.parse(raw) as T) : undefined\n    },\n    async set<T>(key: string, value: T): Promise<void> {\n      store.set(key, JSON.stringify(value))\n    },\n    async delete(key: string): Promise<void> {\n      store.delete(key)\n    },\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\n// Copyright 2026 Epic Digital Interactive Media LLC\n\nimport type { ComponentType } from 'react'\nimport type {\n  ExtensionContext,\n  Disposable,\n  ViewContribution,\n  CommandHandler,\n  SettingsTabConfig,\n  StatusBarConfig,\n  SyncProviderFactory,\n  McpToolDefinition,\n} from '../index'\nimport {\n  createMockAuthService,\n  createMockNetworkService,\n  createMockEventBusService,\n  createMockStorage,\n  type MockUser,\n} from './mocks'\n\nexport interface MockContextOptions {\n  extensionId?: string\n  extensionVersion?: string\n  /** Pass null to simulate an unauthenticated session. */\n  user?: MockUser | null\n  fetch?: (url: string, init?: RequestInit) => Promise<Response>\n  permissions?: string[]\n}\n\nexport interface MockExtensionContext extends ExtensionContext {\n  /** Returns all views contributed to a named slot — use in test assertions. */\n  getContributedViews(slot: string): ViewContribution[]\n  /** Calls dispose() on every entry in subscriptions and clears the array. */\n  cleanup(): void\n}\n\nexport function createMockContext(options: MockContextOptions = {}): MockExtensionContext {\n  const {\n    extensionId = 'test-extension',\n    extensionVersion = '1.0.0',\n    user,\n    fetch: fetchImpl,\n  } = options\n\n  const storage = createMockStorage()\n  const eventBus = createMockEventBusService()\n  const subscriptions: Disposable[] = []\n  const views = new Map<string, ViewContribution[]>()\n\n  const ctx: MockExtensionContext = {\n    extensionId,\n    extensionVersion,\n    storage,\n    services: {\n      auth: createMockAuthService(user),\n      network: createMockNetworkService(fetchImpl),\n      events: eventBus,\n    },\n    subscriptions,\n\n    contributeView(slot: string, component: ComponentType<unknown>): Disposable {\n      const contribution: ViewContribution = {\n        extensionId,\n        slot,\n        component,\n        order: views.get(slot)?.length ?? 0,\n      }\n      if (!views.has(slot)) views.set(slot, [])\n      views.get(slot)!.push(contribution)\n      const disposable: Disposable = {\n        dispose: () => {\n          const list = views.get(slot)\n          if (list) {\n            const idx = list.indexOf(contribution)\n            if (idx >= 0) list.splice(idx, 1)\n          }\n        },\n      }\n      subscriptions.push(disposable)\n      return disposable\n    },\n\n    contributeCommand(_id: string, _handler: CommandHandler): Disposable {\n      return { dispose: () => {} }\n    },\n\n    contributeSettingsTab(_config: SettingsTabConfig): Disposable {\n      return { dispose: () => {} }\n    },\n\n    contributeStatusBarItem(_config: StatusBarConfig): Disposable {\n      return { dispose: () => {} }\n    },\n\n    registerSyncProvider(_factory: SyncProviderFactory): Disposable {\n      return { dispose: () => {} }\n    },\n\n    registerMcpTool(_tool: McpToolDefinition): Disposable {\n      return { dispose: () => {} }\n    },\n\n    getContributedViews(slot: string): ViewContribution[] {\n      return views.get(slot) ?? []\n    },\n\n    cleanup() {\n      for (const sub of subscriptions) {\n        sub.dispose()\n      }\n      // Clear in place so any reference held by the caller sees the empty array\n      subscriptions.length = 0\n    },\n  }\n\n  return ctx\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@epicdm/flowstate-extension-api",
+  "version": "1.0.0",
+  "description": "FlowState Extension SDK — types and testing utilities for extension developers",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.mjs",
+      "require": "./dist/testing/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "jest",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "dependencies": {
+    "@epicdm/flowstate-app-framework": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/react": "^19.0.0",
+    "dts-bundle-generator": "^9.5.1",
+    "jest": "^30.0.0",
+    "react": "19.2.0",
+    "ts-jest": "^29.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.5.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "author": "Epic Digital Interactive Media LLC",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/epicdm/epic-flowstate.git",
+    "directory": "packages/extension-sdk"
+  }
+}