@dxos/app-framework 0.8.4-main.c4373fc → 0.8.4-main.cb12b3f963

package/dist/lib/browser/chunk-CZ4BIAHH.mjs

@@ -0,0 +1,422 @@
+import {
+  isPlugin
+} from "./chunk-Z55LVAGN.mjs";
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/core/url-loader.ts
+var url_loader_exports = {};
+__export(url_loader_exports, {
+  RemotePluginLoadError: () => RemotePluginLoadError,
+  getInstalledVersion: () => getInstalledVersion,
+  getRemoteEntries: () => getRemoteEntries,
+  isLocalUrl: () => isLocalUrl,
+  make: () => make,
+  preload: () => preload,
+  setInstalledVersion: () => setInstalledVersion,
+  uninstall: () => uninstall
+});
+import * as Effect3 from "effect/Effect";
+import * as Option from "effect/Option";
+import { BaseError as BaseError3 } from "@dxos/errors";
+import { log } from "@dxos/log";
+
+// src/core/plugin-asset-cache.ts
+var plugin_asset_cache_exports = {};
+__export(plugin_asset_cache_exports, {
+  PluginAssetCacheError: () => PluginAssetCacheError,
+  noop: () => noop
+});
+import * as Effect from "effect/Effect";
+import { BaseError } from "@dxos/errors";
+var PluginAssetCacheError = class extends BaseError.extend("PluginAssetCacheError", "Plugin asset cache operation failed") {
+};
+var noop = () => ({
+  cache: () => Effect.void,
+  evict: () => Effect.void,
+  resolve: (_pluginId, url) => Effect.succeed(url),
+  list: () => Effect.succeed([])
+});
+
+// src/core/plugin-manifest.ts
+var plugin_manifest_exports = {};
+__export(plugin_manifest_exports, {
+  Manifest: () => Manifest,
+  PLUGIN_DEV_SERVER_PORT: () => PLUGIN_DEV_SERVER_PORT,
+  PluginManifestError: () => PluginManifestError,
+  fetchManifest: () => fetchManifest,
+  parse: () => parse
+});
+import * as FetchHttpClient from "@effect/platform/FetchHttpClient";
+import * as HttpClient from "@effect/platform/HttpClient";
+import * as HttpClientRequest from "@effect/platform/HttpClientRequest";
+import * as HttpClientResponse from "@effect/platform/HttpClientResponse";
+import * as Effect2 from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { BaseError as BaseError2 } from "@dxos/errors";
+import { PLUGIN_ENTRY_FILENAME } from "@dxos/protocols";
+var PLUGIN_DEV_SERVER_PORT = 3967;
+var PluginManifestError = class extends BaseError2.extend("PluginManifestError", "Plugin manifest is invalid") {
+};
+var Manifest = Schema.Struct({
+  id: Schema.String,
+  name: Schema.String,
+  version: Schema.String,
+  assets: Schema.Array(Schema.String),
+  devEntry: Schema.String.pipe(Schema.optional)
+});
+var resolve = (manifestUrl, manifest) => {
+  const dev = manifest.devEntry !== void 0;
+  return {
+    id: manifest.id,
+    name: manifest.name,
+    version: manifest.version,
+    entryUrl: new URL(dev ? manifest.devEntry : PLUGIN_ENTRY_FILENAME, manifestUrl).toString(),
+    assetUrls: manifest.assets.map((asset) => new URL(asset, manifestUrl).toString()),
+    dev
+  };
+};
+var parse = (manifestUrl, payload) => {
+  const manifest = Schema.decodeUnknownSync(Manifest)(payload);
+  if (manifest.devEntry === void 0 && !manifest.assets.includes(PLUGIN_ENTRY_FILENAME)) {
+    throw new Error(`Manifest at ${manifestUrl} does not list ${PLUGIN_ENTRY_FILENAME} in assets.`);
+  }
+  return resolve(manifestUrl, manifest);
+};
+var fetchManifest = (manifestUrl) => Effect2.gen(function* () {
+  const response = yield* HttpClientRequest.get(manifestUrl).pipe(HttpClient.execute, Effect2.mapError((cause) => new PluginManifestError({
+    context: {
+      manifestUrl,
+      reason: "fetch-failed"
+    },
+    cause
+  })));
+  if (response.status >= 400) {
+    return yield* Effect2.fail(new PluginManifestError({
+      context: {
+        manifestUrl,
+        reason: "http-error",
+        status: response.status
+      }
+    }));
+  }
+  const manifest = yield* HttpClientResponse.schemaBodyJson(Manifest)(response).pipe(Effect2.mapError((cause) => new PluginManifestError({
+    context: {
+      manifestUrl,
+      reason: "parse-failed"
+    },
+    cause
+  })));
+  if (manifest.devEntry === void 0 && !manifest.assets.includes(PLUGIN_ENTRY_FILENAME)) {
+    return yield* Effect2.fail(new PluginManifestError({
+      context: {
+        manifestUrl,
+        reason: "invalid"
+      },
+      cause: `assets does not include ${PLUGIN_ENTRY_FILENAME}`
+    }));
+  }
+  return resolve(manifestUrl, manifest);
+}).pipe(Effect2.scoped, Effect2.provide(FetchHttpClient.layer));
+
+// src/core/url-loader.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/core/url-loader.ts";
+var DEFAULT_KEY = "org.dxos.composer.remote-plugins";
+var RemotePluginLoadError = class extends BaseError3.extend("RemotePluginLoadError", "Failed to load remote plugin") {
+};
+var defaultStorage = () => ({
+  get: (key) => localStorage.getItem(key),
+  set: (key, value) => localStorage.setItem(key, value)
+});
+var getPersistedRemotePlugins = (storage, key) => {
+  try {
+    const parsed = JSON.parse(storage.get(key) ?? "[]");
+    if (!Array.isArray(parsed)) {
+      return [];
+    }
+    return parsed.filter((entry) => typeof entry === "object" && entry !== null && typeof entry.id === "string" && typeof entry.url === "string");
+  } catch {
+    return [];
+  }
+};
+var persistRemotePlugin = (storage, key, entry) => {
+  try {
+    const entries = getPersistedRemotePlugins(storage, key).filter((existing) => existing.id !== entry.id);
+    entries.push(entry);
+    storage.set(key, JSON.stringify(entries));
+  } catch (error) {
+    log.warn("failed to persist remote plugin entry", {
+      entry,
+      error
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 40, S: void 0 });
+  }
+};
+var removePersistedRemotePlugin = (storage, key, pluginId) => {
+  try {
+    const entries = getPersistedRemotePlugins(storage, key).filter((existing) => existing.id !== pluginId);
+    storage.set(key, JSON.stringify(entries));
+  } catch (error) {
+    log.warn("failed to remove remote plugin entry", {
+      pluginId,
+      error
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 51, S: void 0 });
+  }
+};
+var isUrl = (locator) => {
+  try {
+    const url = new URL(locator);
+    return url.protocol === "http:" || url.protocol === "https:";
+  } catch {
+    return false;
+  }
+};
+var isLocalUrl = (locator) => {
+  try {
+    const hostname = new URL(locator).hostname.toLowerCase();
+    return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1" || hostname === "[::1]";
+  } catch {
+    return false;
+  }
+};
+var getRemoteEntries = (options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  return getPersistedRemotePlugins(storage, key);
+};
+var setInstalledVersion = (id, version, options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  const entries = getPersistedRemotePlugins(storage, key);
+  const index = entries.findIndex((entry) => entry.id === id);
+  if (index === -1) {
+    return;
+  }
+  entries[index] = {
+    ...entries[index],
+    version
+  };
+  try {
+    storage.set(key, JSON.stringify(entries));
+  } catch (error) {
+    log.warn("failed to update installed version for remote plugin", {
+      id,
+      version,
+      error
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 103, S: void 0 });
+  }
+};
+var getInstalledVersion = (id, options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  return getPersistedRemotePlugins(storage, key).find((entry) => entry.id === id)?.version;
+};
+var normalizePluginExport = (mod) => {
+  const exported = mod.default;
+  if (isPlugin(exported)) {
+    return exported;
+  }
+  if (typeof exported === "function") {
+    const result = exported();
+    if (isPlugin(result)) {
+      return result;
+    }
+  }
+  throw new Error("Remote module default export is not a Plugin or a zero-arg plugin factory.");
+};
+var loadStylesheets = (manifest, cache) => Effect3.gen(function* () {
+  if (typeof document === "undefined") {
+    return;
+  }
+  const cssUrls = manifest.assetUrls.filter((url) => url.endsWith(".css"));
+  for (const url of cssUrls) {
+    const resolved = yield* cache.resolve(manifest.id, url);
+    if (document.querySelector(`link[data-dxos-plugin-id="${manifest.id}"][href="${resolved}"]`)) {
+      continue;
+    }
+    const link = document.createElement("link");
+    link.rel = "stylesheet";
+    link.href = resolved;
+    link.dataset.dxosPluginId = manifest.id;
+    document.head.appendChild(link);
+  }
+});
+var loadFromManifest = (manifestUrl, cache) => Effect3.gen(function* () {
+  log.info("loading remote plugin", {
+    manifestUrl
+  }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 152, S: this });
+  const manifest = yield* fetchManifest(manifestUrl).pipe(Effect3.mapError((cause) => new RemotePluginLoadError({
+    context: {
+      locator: manifestUrl,
+      reason: "manifest-error"
+    },
+    cause
+  })));
+  const wrapCacheError = Effect3.mapError((cause) => new RemotePluginLoadError({
+    context: {
+      locator: manifestUrl,
+      reason: "cache-error"
+    },
+    cause
+  }));
+  if (!manifest.dev) {
+    const cachedUrls = manifest.assetUrls.indexOf(manifestUrl) === -1 ? [
+      manifestUrl,
+      ...manifest.assetUrls
+    ] : manifest.assetUrls;
+    yield* cache.cache(manifest.id, cachedUrls).pipe(wrapCacheError);
+  }
+  const entryUrl = manifest.dev ? manifest.entryUrl : yield* cache.resolve(manifest.id, manifest.entryUrl).pipe(wrapCacheError);
+  const mod = yield* Effect3.tryPromise({
+    try: () => import(
+      /* @vite-ignore */
+      entryUrl
+    ),
+    catch: (cause) => new RemotePluginLoadError({
+      context: {
+        locator: manifestUrl,
+        reason: "import-failed"
+      },
+      cause
+    })
+  });
+  const plugin = normalizePluginExport(mod);
+  if (!plugin.meta.id || !plugin.meta.name) {
+    return yield* Effect3.fail(new RemotePluginLoadError({
+      context: {
+        locator: manifestUrl,
+        reason: "meta-missing"
+      }
+    }));
+  }
+  if (plugin.meta.id !== manifest.id) {
+    return yield* Effect3.fail(new RemotePluginLoadError({
+      context: {
+        locator: manifestUrl,
+        reason: "meta-mismatch",
+        metaId: plugin.meta.id,
+        manifestId: manifest.id
+      }
+    }));
+  }
+  if (!manifest.dev) {
+    yield* loadStylesheets(manifest, cache).pipe(wrapCacheError);
+  }
+  return {
+    plugin,
+    manifest
+  };
+});
+var preload = (options = {}) => Effect3.gen(function* () {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  const cache = options.cache ?? noop();
+  const onPluginLoaded = options.onPluginLoaded;
+  const entries = getPersistedRemotePlugins(storage, key);
+  if (entries.length === 0) {
+    return [];
+  }
+  log.info("preloading remote plugins", {
+    count: entries.length
+  }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 240, S: this });
+  const total = entries.length;
+  let loaded = 0;
+  const results = yield* Effect3.all(entries.map((entry) => loadFromManifest(entry.url, cache).pipe(
+    Effect3.tapError((error) => Effect3.sync(() => log.warn("failed to preload remote plugin", {
+      entry,
+      error
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 245, S: this }))),
+    Effect3.option,
+    // Tick the progress hook on both success and recoverable failure so
+    // the counter monotonically reaches `total`. The host-supplied
+    // callback is best-effort: any synchronous throw flows through
+    // `Effect.try` and gets logged + ignored so a buggy hook can't
+    // derail the preload.
+    Effect3.tap(() => Effect3.sync(() => {
+      loaded += 1;
+    }).pipe(Effect3.andThen(Effect3.try(() => onPluginLoaded?.(loaded, total))), Effect3.tapError((error) => Effect3.sync(() => log.warn("onPluginLoaded threw", {
+      loaded,
+      total,
+      error
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 255, S: this }))), Effect3.ignore))
+  )), {
+    concurrency: "unbounded"
+  });
+  return results.flatMap((result) => Option.match(result, {
+    onNone: () => [],
+    onSome: ({ plugin }) => [
+      plugin
+    ]
+  }));
+});
+var make = (builtinPlugins, options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  const cache = options.cache ?? noop();
+  return (locator) => Effect3.gen(function* () {
+    const builtin = builtinPlugins.find((plugin2) => plugin2.meta.id === locator);
+    if (builtin) {
+      return {
+        plugin: builtin
+      };
+    }
+    if (!isUrl(locator)) {
+      return yield* Effect3.fail(new RemotePluginLoadError({
+        context: {
+          locator,
+          reason: "invalid-locator"
+        }
+      }));
+    }
+    const { plugin, manifest } = yield* loadFromManifest(locator, cache);
+    if (!manifest.dev) {
+      const duplicate = builtinPlugins.find((existing) => existing.meta.id === plugin.meta.id);
+      if (duplicate) {
+        return yield* Effect3.fail(new RemotePluginLoadError({
+          context: {
+            locator,
+            reason: "duplicate-id",
+            id: plugin.meta.id
+          }
+        }));
+      }
+      persistRemotePlugin(storage, key, {
+        id: plugin.meta.id,
+        url: locator
+      });
+    }
+    return {
+      plugin,
+      dev: manifest.dev
+    };
+  });
+};
+var uninstall = (pluginId, options = {}) => Effect3.gen(function* () {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  const cache = options.cache ?? noop();
+  removePersistedRemotePlugin(storage, key, pluginId);
+  if (typeof document !== "undefined") {
+    document.querySelectorAll(`link[data-dxos-plugin-id="${pluginId}"]`).forEach((node) => node.remove());
+  }
+  yield* cache.evict(pluginId).pipe(Effect3.tapError((error) => Effect3.sync(() => log.warn("failed to evict plugin assets", {
+    pluginId,
+    error
+  }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 337, S: this }))), Effect3.ignore);
+});
+
+export {
+  plugin_asset_cache_exports,
+  PLUGIN_DEV_SERVER_PORT,
+  plugin_manifest_exports,
+  RemotePluginLoadError,
+  isLocalUrl,
+  getRemoteEntries,
+  setInstalledVersion,
+  getInstalledVersion,
+  preload,
+  make,
+  uninstall,
+  url_loader_exports
+};
+//# sourceMappingURL=chunk-CZ4BIAHH.mjs.map

package/dist/lib/browser/chunk-CZ4BIAHH.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/url-loader.ts", "../../../src/core/plugin-asset-cache.ts", "../../../src/core/plugin-manifest.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Option from 'effect/Option';\n\nimport { BaseError } from '@dxos/errors';\nimport { log } from '@dxos/log';\n\nimport * as Plugin from './plugin';\nimport * as PluginAssetCache from './plugin-asset-cache';\nimport * as PluginManifest from './plugin-manifest';\n\nconst DEFAULT_KEY = 'org.dxos.composer.remote-plugins';\n\n/**\n * Tagged error for any failure during remote plugin loading. Construction sites\n * set `context.locator` and `context.reason` (one of `'invalid-locator' |\n * 'manifest-error' | 'cache-error' | 'import-failed' | 'meta-missing' |\n * 'meta-mismatch' | 'duplicate-id'`) so handlers can route on the failure mode.\n */\nexport class RemotePluginLoadError extends BaseError.extend('RemotePluginLoadError', 'Failed to load remote plugin') {}\n\n/**\n * Abstraction over key-value storage (defaults to localStorage).\n */\nexport type Storage = {\n  get(key: string): string | null;\n  set(key: string, value: string): void;\n};\n\n/**\n * Options for configuring the URL loader.\n */\nexport type Options = {\n  storage?: Storage;\n  key?: string;\n  /**\n   * Per-platform offline asset cache. Defaults to a no-op cache (no offline support).\n   */\n  cache?: PluginAssetCache.Cache;\n};\n\n/**\n * Options for the preload entry point. Adds an optional progress hook so hosts\n * can drive a boot-loader counter (`Loading plugins (3/12)…`) as remote plugin\n * manifests resolve. Resolution order is *not* deterministic — each entry races\n * its own network fetch — so callers should treat `loaded` as a count, not an\n * index. Failures are still swallowed; `loaded` advances on both success and\n * recoverable failure so the counter always reaches `total`.\n */\nexport type PreloadOptions = Options & {\n  onPluginLoaded?: (loaded: number, total: number) => void;\n};\n\n/**\n * Persisted record of a remote plugin that has been loaded previously.\n *\n * `url` is the URL of the plugin manifest (`plugin.json`), not the entry module.\n */\nexport type RemotePluginEntry = {\n  id: string;\n  url: string;\n  /** Installed version string, e.g. `v1.0.0`. Populated after install from a community catalog entry. */\n  version?: string;\n};\n\nconst defaultStorage = (): Storage => ({\n  get: (key) => localStorage.getItem(key),\n  set: (key, value) => localStorage.setItem(key, value),\n});\n\nconst getPersistedRemotePlugins = (storage: Storage, key: string): RemotePluginEntry[] => {\n  try {\n    const parsed: unknown = JSON.parse(storage.get(key) ?? '[]');\n    if (!Array.isArray(parsed)) {\n      return [];\n    }\n    return parsed.filter(\n      (entry): entry is RemotePluginEntry =>\n        typeof entry === 'object' && entry !== null && typeof entry.id === 'string' && typeof entry.url === 'string',\n    );\n  } catch {\n    return [];\n  }\n};\n\nconst persistRemotePlugin = (storage: Storage, key: string, entry: RemotePluginEntry): void => {\n  try {\n    const entries = getPersistedRemotePlugins(storage, key).filter((existing) => existing.id !== entry.id);\n    entries.push(entry);\n    storage.set(key, JSON.stringify(entries));\n  } catch (error) {\n    log.warn('failed to persist remote plugin entry', { entry, error });\n  }\n};\n\nconst removePersistedRemotePlugin = (storage: Storage, key: string, pluginId: string): void => {\n  try {\n    const entries = getPersistedRemotePlugins(storage, key).filter((existing) => existing.id !== pluginId);\n    storage.set(key, JSON.stringify(entries));\n  } catch (error) {\n    log.warn('failed to remove remote plugin entry', { pluginId, error });\n  }\n};\n\nconst isUrl = (locator: string): boolean => {\n  try {\n    const url = new URL(locator);\n    return url.protocol === 'http:' || url.protocol === 'https:';\n  } catch {\n    return false;\n  }\n};\n\n/**\n * Returns true when the URL's hostname is the local host (localhost, 127.0.0.1, or ::1).\n */\nexport const isLocalUrl = (locator: string): boolean => {\n  try {\n    const hostname = new URL(locator).hostname.toLowerCase();\n    // WHATWG URL returns '::1' without brackets in Node; some browsers return '[::1]'.\n    return hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '::1' || hostname === '[::1]';\n  } catch {\n    return false;\n  }\n};\n\n/**\n * Returns the list of remote plugin entries previously persisted by {@link make}.\n * Useful for UI code that needs to know which loaded plugins were installed from a URL\n * (e.g. to surface a tag on remote or localhost-hosted plugins).\n */\nexport const getRemoteEntries = (options: Options = {}): readonly RemotePluginEntry[] => {\n  const storage = options.storage ?? defaultStorage();\n  const key = options.key ?? DEFAULT_KEY;\n  return getPersistedRemotePlugins(storage, key);\n};\n\n/**\n * Updates the persisted installed version for an already-stored remote plugin entry.\n * Does nothing if the plugin has not been persisted yet.\n */\nexport const setInstalledVersion = (id: string, version: string, options: Options = {}): void => {\n  const storage = options.storage ?? defaultStorage();\n  const key = options.key ?? DEFAULT_KEY;\n  const entries = getPersistedRemotePlugins(storage, key);\n  const index = entries.findIndex((entry) => entry.id === id);\n  if (index === -1) {\n    return;\n  }\n  entries[index] = { ...entries[index], version };\n  try {\n    storage.set(key, JSON.stringify(entries));\n  } catch (error) {\n    log.warn('failed to update installed version for remote plugin', { id, version, error });\n  }\n};\n\n/**\n * Returns the installed version string for the given plugin id, or `undefined` if\n * the plugin was installed without version tracking (legacy install) or is not found.\n */\nexport const getInstalledVersion = (id: string, options: Options = {}): string | undefined => {\n  const storage = options.storage ?? defaultStorage();\n  const key = options.key ?? DEFAULT_KEY;\n  return getPersistedRemotePlugins(storage, key).find((entry) => entry.id === id)?.version;\n};\n\nconst normalizePluginExport = (mod: Record<string, unknown>): Plugin.Plugin => {\n  const exported = mod.default;\n  if (Plugin.isPlugin(exported)) {\n    return exported;\n  }\n  if (typeof exported === 'function') {\n    const result = (exported as () => unknown)();\n    if (Plugin.isPlugin(result)) {\n      return result;\n    }\n  }\n  throw new Error('Remote module default export is not a Plugin or a zero-arg plugin factory.');\n};\n\n/**\n * Loads stylesheets declared in the manifest by appending `<link rel=\"stylesheet\">` elements to the host document.\n * Each link is tagged with `data-dxos-plugin-id` so `uninstall` can clean them up.\n */\nconst loadStylesheets = (\n  manifest: PluginManifest.ResolvedManifest,\n  cache: PluginAssetCache.Cache,\n): Effect.Effect<void, PluginAssetCache.PluginAssetCacheError> =>\n  Effect.gen(function* () {\n    if (typeof document === 'undefined') {\n      return;\n    }\n    const cssUrls = manifest.assetUrls.filter((url) => url.endsWith('.css'));\n    for (const url of cssUrls) {\n      const resolved = yield* cache.resolve(manifest.id, url);\n      if (document.querySelector(`link[data-dxos-plugin-id=\"${manifest.id}\"][href=\"${resolved}\"]`)) {\n        continue;\n      }\n      const link = document.createElement('link');\n      link.rel = 'stylesheet';\n      link.href = resolved;\n      link.dataset.dxosPluginId = manifest.id;\n      document.head.appendChild(link);\n    }\n  });\n\nconst loadFromManifest = (\n  manifestUrl: string,\n  cache: PluginAssetCache.Cache,\n): Effect.Effect<{ plugin: Plugin.Plugin; manifest: PluginManifest.ResolvedManifest }, RemotePluginLoadError> =>\n  Effect.gen(function* () {\n    log.info('loading remote plugin', { manifestUrl });\n    const manifest = yield* PluginManifest.fetchManifest(manifestUrl).pipe(\n      Effect.mapError(\n        (cause) => new RemotePluginLoadError({ context: { locator: manifestUrl, reason: 'manifest-error' }, cause }),\n      ),\n    );\n    const wrapCacheError = Effect.mapError(\n      (cause: PluginAssetCache.PluginAssetCacheError) =>\n        new RemotePluginLoadError({ context: { locator: manifestUrl, reason: 'cache-error' }, cause }),\n    );\n    // Dev-mode manifests (served by `vite dev` via composerPlugin) skip the offline\n    // cache: chunks resolve on demand through the dev server, the asset list isn't\n    // enumerable up-front, and CSS arrives via runtime <style> injection rather than\n    // static <link> tags.\n    if (!manifest.dev) {\n      // Cache the manifest URL alongside its declared assets. Without it, `preload` on a\n      // subsequent reload would fetch the manifest from the network — and fail when the\n      // plugin's host is offline, dropping the plugin from the runtime.\n      const cachedUrls =\n        manifest.assetUrls.indexOf(manifestUrl) === -1 ? [manifestUrl, ...manifest.assetUrls] : manifest.assetUrls;\n      yield* cache.cache(manifest.id, cachedUrls).pipe(wrapCacheError);\n    }\n    const entryUrl = manifest.dev\n      ? manifest.entryUrl\n      : yield* cache.resolve(manifest.id, manifest.entryUrl).pipe(wrapCacheError);\n    const mod = yield* Effect.tryPromise({\n      try: () => import(/* @vite-ignore */ entryUrl),\n      catch: (cause) =>\n        new RemotePluginLoadError({ context: { locator: manifestUrl, reason: 'import-failed' }, cause }),\n    });\n    const plugin = normalizePluginExport(mod);\n    if (!plugin.meta.id || !plugin.meta.name) {\n      return yield* Effect.fail(\n        new RemotePluginLoadError({ context: { locator: manifestUrl, reason: 'meta-missing' } }),\n      );\n    }\n    if (plugin.meta.id !== manifest.id) {\n      return yield* Effect.fail(\n        new RemotePluginLoadError({\n          context: {\n            locator: manifestUrl,\n            reason: 'meta-mismatch',\n            metaId: plugin.meta.id,\n            manifestId: manifest.id,\n          },\n        }),\n      );\n    }\n    // Append stylesheets only after the entry imports cleanly and meta validation\n    // passes. If we did this earlier and the import or meta checks failed, the\n    // `<link>` tags would leak into the host DOM with no plugin to own their\n    // teardown — `uninstall` only runs for plugins the manager actually accepted.\n    // In dev mode, Vite injects styles at runtime via the module graph, so static\n    // <link> tags would duplicate (or 404, since CSS chunks aren't pre-built).\n    if (!manifest.dev) {\n      yield* loadStylesheets(manifest, cache).pipe(wrapCacheError);\n    }\n    return { plugin, manifest };\n  });\n\n/**\n * Preloads previously persisted remote plugins from storage. Per-entry failures\n * are logged and swallowed — the returned effect always succeeds with whichever\n * plugins loaded cleanly, so a single bad entry can't block the host's startup.\n */\nexport const preload = (options: PreloadOptions = {}): Effect.Effect<Plugin.Plugin[], never> =>\n  Effect.gen(function* () {\n    const storage = options.storage ?? defaultStorage();\n    const key = options.key ?? DEFAULT_KEY;\n    const cache = options.cache ?? PluginAssetCache.noop();\n    const onPluginLoaded = options.onPluginLoaded;\n\n    const entries = getPersistedRemotePlugins(storage, key);\n    if (entries.length === 0) {\n      return [];\n    }\n    log.info('preloading remote plugins', { count: entries.length });\n    const total = entries.length;\n    let loaded = 0;\n    const results = yield* Effect.all(\n      entries.map((entry) =>\n        loadFromManifest(entry.url, cache).pipe(\n          Effect.tapError((error) => Effect.sync(() => log.warn('failed to preload remote plugin', { entry, error }))),\n          Effect.option,\n          // Tick the progress hook on both success and recoverable failure so\n          // the counter monotonically reaches `total`. The host-supplied\n          // callback is best-effort: any synchronous throw flows through\n          // `Effect.try` and gets logged + ignored so a buggy hook can't\n          // derail the preload.\n          Effect.tap(() =>\n            Effect.sync(() => {\n              loaded += 1;\n            }).pipe(\n              Effect.andThen(Effect.try(() => onPluginLoaded?.(loaded, total))),\n              Effect.tapError((error) => Effect.sync(() => log.warn('onPluginLoaded threw', { loaded, total, error }))),\n              Effect.ignore,\n            ),\n          ),\n        ),\n      ),\n      { concurrency: 'unbounded' },\n    );\n    return results.flatMap((result) =>\n      Option.match(result, {\n        onNone: () => [],\n        onSome: ({ plugin }) => [plugin],\n      }),\n    );\n  });\n\n/**\n * Creates a plugin loader that resolves built-in plugins by ID or loads remote plugins from URLs.\n *\n * Remote URLs must point at a plugin manifest (`plugin.json`). The loader fetches the manifest,\n * eagerly persists every declared asset via the configured `PluginAssetCache`, then dynamic-imports\n * the entry module.\n */\nexport const make = (builtinPlugins: Plugin.Plugin[], options: Options = {}) => {\n  const storage = options.storage ?? defaultStorage();\n  const key = options.key ?? DEFAULT_KEY;\n  const cache = options.cache ?? PluginAssetCache.noop();\n\n  return (locator: string): Effect.Effect<{ plugin: Plugin.Plugin; dev?: boolean }, RemotePluginLoadError> =>\n    Effect.gen(function* () {\n      const builtin = builtinPlugins.find((plugin) => plugin.meta.id === locator);\n      if (builtin) {\n        return { plugin: builtin };\n      }\n      if (!isUrl(locator)) {\n        return yield* Effect.fail(new RemotePluginLoadError({ context: { locator, reason: 'invalid-locator' } }));\n      }\n      const { plugin, manifest } = yield* loadFromManifest(locator, cache);\n      // Production manifests can't collide with a builtin id — that would make\n      // the registered plugin permanently inaccessible. Dev manifests are\n      // allowed to collide because the manager shadow primitive handles the\n      // overlap (dev plugin takes the id slot for the session, original is\n      // restored on uninstall or page reload).\n      if (!manifest.dev) {\n        const duplicate = builtinPlugins.find((existing) => existing.meta.id === plugin.meta.id);\n        if (duplicate) {\n          return yield* Effect.fail(\n            new RemotePluginLoadError({ context: { locator, reason: 'duplicate-id', id: plugin.meta.id } }),\n          );\n        }\n        persistRemotePlugin(storage, key, { id: plugin.meta.id, url: locator });\n      }\n      return { plugin, dev: manifest.dev };\n    });\n};\n\n/**\n * Removes a previously installed remote plugin: drops the persisted entry, evicts cached\n * assets, and removes any stylesheet `<link>` tags that {@link loadFromManifest} appended.\n *\n * Cache eviction failures are logged and swallowed — the persisted entry has already been\n * dropped so the user-visible state is consistent regardless of whether the platform\n * cache cooperated.\n */\nexport const uninstall = (pluginId: string, options: Options = {}): Effect.Effect<void, never> =>\n  Effect.gen(function* () {\n    const storage = options.storage ?? defaultStorage();\n    const key = options.key ?? DEFAULT_KEY;\n    const cache = options.cache ?? PluginAssetCache.noop();\n\n    removePersistedRemotePlugin(storage, key, pluginId);\n    if (typeof document !== 'undefined') {\n      document.querySelectorAll(`link[data-dxos-plugin-id=\"${pluginId}\"]`).forEach((node) => node.remove());\n    }\n    yield* cache.evict(pluginId).pipe(\n      Effect.tapError((error) => Effect.sync(() => log.warn('failed to evict plugin assets', { pluginId, error }))),\n      Effect.ignore,\n    );\n  });\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { BaseError } from '@dxos/errors';\n\n/**\n * Tagged error for cache operations. Construction sites supply `context.operation`\n * (one of `'cache' | 'evict' | 'resolve' | 'list'`) and `context.pluginId` so\n * downstream handlers can route on the failed call without scanning the message.\n */\nexport class PluginAssetCacheError extends BaseError.extend(\n  'PluginAssetCacheError',\n  'Plugin asset cache operation failed',\n) {}\n\n/**\n * Per-platform offline cache for third-party plugin assets.\n *\n * Implementations live alongside their platform glue (composer-app's\n * `asset-cache/{tauri,service-worker}.ts`); the no-op default is for tests\n * and unsupported environments.\n */\nexport interface Cache {\n  /**\n   * Persist all listed URLs under the namespace of `pluginId`. Idempotent.\n   * The order of `urls` is significant — the first entry is treated as the entry module.\n   */\n  cache(pluginId: string, urls: readonly string[]): Effect.Effect<void, PluginAssetCacheError>;\n\n  /**\n   * Drop all assets for a plugin (uninstall).\n   */\n  evict(pluginId: string): Effect.Effect<void, PluginAssetCacheError>;\n\n  /**\n   * Resolves a plugin asset URL to a platform-specific cached URL when one is available.\n   * Returns the original URL when no cached copy exists or the platform serves cached\n   * responses transparently (e.g. service worker fetch interception on web).\n   */\n  resolve(pluginId: string, url: string): Effect.Effect<string, PluginAssetCacheError>;\n\n  /**\n   * List currently cached plugin ids (diagnostic).\n   */\n  list(): Effect.Effect<readonly string[], PluginAssetCacheError>;\n}\n\n/**\n * No-op implementation. Used when no platform cache is registered (tests, unsupported environments).\n * Plugins still load — they just have no offline guarantee.\n */\nexport const noop = (): Cache => ({\n  cache: () => Effect.void,\n  evict: () => Effect.void,\n  resolve: (_pluginId, url) => Effect.succeed(url),\n  list: () => Effect.succeed([] as readonly string[]),\n});\n", "//\n// Copyright 2026 DXOS.org\n//\n\nimport * as FetchHttpClient from '@effect/platform/FetchHttpClient';\nimport * as HttpClient from '@effect/platform/HttpClient';\nimport * as HttpClientRequest from '@effect/platform/HttpClientRequest';\nimport * as HttpClientResponse from '@effect/platform/HttpClientResponse';\nimport * as Effect from 'effect/Effect';\nimport * as Schema from 'effect/Schema';\n\nimport { BaseError } from '@dxos/errors';\nimport { PLUGIN_ENTRY_FILENAME } from '@dxos/protocols';\n\n/**\n * Default port the Vite plugin (`composerPlugin`) binds the dev server to.\n *\n * Shared single source of truth — `composerPlugin` reads it as the default\n * port, and the host's \"Load Dev Plugin\" affordance pre-fills the manifest URL\n * with `http://localhost:${PLUGIN_DEV_SERVER_PORT}/manifest.json`. Lives in\n * app-framework rather than `@dxos/protocols` because the constant is a\n * client-side convention (host loader + Vite plugin) rather than a wire-level\n * protocol.\n */\nexport const PLUGIN_DEV_SERVER_PORT = 3967;\n\n/**\n * Tagged error for manifest fetch / parse failures. Construction sites set\n * `context.manifestUrl` and `context.reason` (one of `'fetch-failed' |\n * 'http-error' | 'parse-failed' | 'invalid'`) so handlers can route on the\n * specific failure mode.\n */\nexport class PluginManifestError extends BaseError.extend('PluginManifestError', 'Plugin manifest is invalid') {}\n\n/**\n * Schema for a third-party plugin manifest.\n *\n * Production manifests are published as a sibling of the plugin's entry module\n * ({@link PLUGIN_ENTRY_FILENAME}) and advertise every file the plugin needs at\n * runtime so the host can eagerly cache them for offline use.\n *\n * Dev manifests (served by `vite dev` via {@link composerPlugin}) set `devEntry`\n * to point at the unbundled source entry. The host's loader treats the presence\n * of `devEntry` as the dev-mode signal: it imports the entry directly from the\n * dev server, skips eager asset caching, and skips static stylesheet injection\n * (Vite handles CSS via runtime `<style>` injection during HMR). `assets` is not\n * required to enumerate every file in dev mode — chunks and styles flow through\n * the dev server on demand.\n */\nexport const Manifest = Schema.Struct({\n  id: Schema.String,\n  name: Schema.String,\n  version: Schema.String,\n  assets: Schema.Array(Schema.String),\n  devEntry: Schema.String.pipe(Schema.optional),\n});\n\nexport type Manifest = Schema.Schema.Type<typeof Manifest>;\n\n/**\n * Resolved manifest with all asset paths converted to absolute URLs.\n *\n * `dev` reflects whether the source manifest declared a `devEntry`. Loaders branch\n * on this to skip offline caching and stylesheet injection — both are no-ops (or\n * actively wrong) when the plugin is being served by a Vite dev server.\n */\nexport type ResolvedManifest = {\n  id: string;\n  name: string;\n  version: string;\n  entryUrl: string;\n  assetUrls: readonly string[];\n  dev: boolean;\n};\n\n/**\n * Resolves a parsed manifest's relative asset paths against the manifest's URL.\n * In dev mode the entry comes from `devEntry`; otherwise it's the canonical\n * {@link PLUGIN_ENTRY_FILENAME} sitting next to the manifest.\n */\nconst resolve = (manifestUrl: string, manifest: Manifest): ResolvedManifest => {\n  const dev = manifest.devEntry !== undefined;\n  return {\n    id: manifest.id,\n    name: manifest.name,\n    version: manifest.version,\n    entryUrl: new URL(dev ? manifest.devEntry! : PLUGIN_ENTRY_FILENAME, manifestUrl).toString(),\n    assetUrls: manifest.assets.map((asset) => new URL(asset, manifestUrl).toString()),\n    dev,\n  };\n};\n\n/**\n * Synchronous decode + validate + resolve for an in-memory manifest payload. Used\n * by tests and tooling that have the manifest body already loaded; the runtime\n * path goes through {@link fetchManifest}.\n */\nexport const parse = (manifestUrl: string, payload: unknown): ResolvedManifest => {\n  const manifest = Schema.decodeUnknownSync(Manifest)(payload);\n  if (manifest.devEntry === undefined && !manifest.assets.includes(PLUGIN_ENTRY_FILENAME)) {\n    throw new Error(`Manifest at ${manifestUrl} does not list ${PLUGIN_ENTRY_FILENAME} in assets.`);\n  }\n  return resolve(manifestUrl, manifest);\n};\n\n/**\n * Fetches and parses a manifest from the given URL via Effect's HTTP client and\n * Schema-driven JSON decoding. All failure modes surface as a single tagged\n * {@link PluginManifestError}; callers route on `error.context.reason`.\n */\nexport const fetchManifest = (manifestUrl: string): Effect.Effect<ResolvedManifest, PluginManifestError> =>\n  Effect.gen(function* () {\n    const response = yield* HttpClientRequest.get(manifestUrl).pipe(\n      HttpClient.execute,\n      Effect.mapError((cause) => new PluginManifestError({ context: { manifestUrl, reason: 'fetch-failed' }, cause })),\n    );\n    if (response.status >= 400) {\n      return yield* Effect.fail(\n        new PluginManifestError({ context: { manifestUrl, reason: 'http-error', status: response.status } }),\n      );\n    }\n    const manifest = yield* HttpClientResponse.schemaBodyJson(Manifest)(response).pipe(\n      Effect.mapError((cause) => new PluginManifestError({ context: { manifestUrl, reason: 'parse-failed' }, cause })),\n    );\n    if (manifest.devEntry === undefined && !manifest.assets.includes(PLUGIN_ENTRY_FILENAME)) {\n      return yield* Effect.fail(\n        new PluginManifestError({\n          context: { manifestUrl, reason: 'invalid' },\n          cause: `assets does not include ${PLUGIN_ENTRY_FILENAME}`,\n        }),\n      );\n    }\n    return resolve(manifestUrl, manifest);\n  }).pipe(Effect.scoped, Effect.provide(FetchHttpClient.layer));\n"],
+  "mappings": "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",
+  "names": ["Effect", "Option", "BaseError", "log", "Effect", "BaseError", "PluginAssetCacheError", "extend", "noop", "cache", "void", "evict", "resolve", "_pluginId", "url", "succeed", "list", "FetchHttpClient", "HttpClient", "HttpClientRequest", "HttpClientResponse", "Effect", "Schema", "BaseError", "PLUGIN_ENTRY_FILENAME", "PLUGIN_DEV_SERVER_PORT", "PluginManifestError", "extend", "Manifest", "Struct", "id", "String", "name", "version", "assets", "Array", "devEntry", "pipe", "optional", "resolve", "manifestUrl", "manifest", "dev", "undefined", "entryUrl", "URL", "toString", "assetUrls", "map", "asset", "parse", "payload", "decodeUnknownSync", "includes", "Error", "fetchManifest", "gen", "response", "get", "execute", "mapError", "cause", "context", "reason", "status", "fail", "schemaBodyJson", "scoped", "provide", "layer", "DEFAULT_KEY", "defaultStorage", "BaseError", "value", "localStorage", "getPersistedRemotePlugins", "storage", "key", "get", "parsed", "entries", "error", "log", "entry", "pluginId", "url", "URL", "hostname", "locator", "options", "index", "findIndex", "version", "id", "find", "normalizePluginExport", "mod", "exported", "Plugin", "result", "resolved", "resolve", "manifest", "document", "querySelector", "link", "href", "dataset", "head", "loadFromManifest", "manifestUrl", "context", "reason", "cause", "wrapCacheError", "assetUrls", "cache", "entryUrl", "try", "catch", "RemotePluginLoadError", "plugin", "metaId", "manifestId", "PluginAssetCache", "noop", "onPluginLoaded", "info", "total", "results", "pipe", "andThen", "Effect", "loaded", "flatMap", "onSome", "gen", "builtin", "duplicate", "persistRemotePlugin", "dev", "removePersistedRemotePlugin", "querySelectorAll", "evict", "sync", "warn"]
+}

package/dist/lib/browser/chunk-FJ4765WW.mjs

@@ -0,0 +1,8 @@
+// src/context.ts
+import { createContext } from "@dxos/web-context";
+var PluginManagerContext = createContext("org.dxos.app-framework.plugin-manager");
+
+export {
+  PluginManagerContext
+};
+//# sourceMappingURL=chunk-FJ4765WW.mjs.map

package/dist/lib/browser/chunk-FJ4765WW.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/context.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { createContext } from '@dxos/web-context';\n\nimport { type PluginManager } from './core';\n\nexport const PluginManagerContext = createContext<PluginManager.PluginManager>('org.dxos.app-framework.plugin-manager');\n"],
+  "mappings": ";AAIA,SAASA,qBAAqB;AAIvB,IAAMC,uBAAuBD,cAA2C,uCAAA;",
+  "names": ["createContext", "PluginManagerContext"]
+}

package/dist/lib/browser/chunk-FO3IYSLV.mjs

@@ -0,0 +1,68 @@
+// src/core/edge-registry-plugin-provider.ts
+import * as Effect from "effect/Effect";
+import { Context } from "@dxos/context";
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/core/edge-registry-plugin-provider.ts";
+var toRegistryPlugin = (entry) => ({
+  id: entry.meta.id,
+  name: entry.meta.name,
+  description: entry.meta.description,
+  homePage: entry.meta.homePage,
+  source: entry.meta.source,
+  screenshots: entry.meta.screenshots ? [
+    ...entry.meta.screenshots
+  ] : void 0,
+  tags: entry.meta.tags ? [
+    ...entry.meta.tags
+  ] : void 0,
+  icon: entry.meta.icon,
+  iconHue: entry.meta.iconHue,
+  moduleUrl: entry.moduleUrl,
+  repo: entry.repo,
+  version: entry.releaseTag
+});
+var EdgeRegistryPluginProvider = class {
+  _client;
+  // Cached on first load so getPlugin/listVersions can resolve without re-fetching.
+  #cachedPlugins = [];
+  constructor(_client) {
+    this._client = _client;
+  }
+  listPlugins() {
+    return Effect.tryPromise({
+      try: () => this._client.getRegistryPlugins(Context.default(void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 56 })),
+      catch: (error) => error instanceof Error ? error : new Error(String(error))
+    }).pipe(Effect.map((body) => {
+      const plugins = body.plugins.filter((entry) => entry.health === "ok").map(toRegistryPlugin);
+      this.#cachedPlugins = plugins;
+      return plugins;
+    }));
+  }
+  listVersions(repo) {
+    const plugin = this.#cachedPlugins.find((candidate) => candidate.repo === repo);
+    if (!plugin) {
+      return Effect.fail(new Error(`Plugin not found in catalog: ${repo}`));
+    }
+    const version = {
+      tag: plugin.version,
+      moduleUrl: plugin.moduleUrl
+    };
+    return Effect.succeed([
+      version
+    ]);
+  }
+  getPlugin(repo, version) {
+    const plugin = this.#cachedPlugins.find((p) => p.repo === repo);
+    if (!plugin) {
+      return Effect.fail(new Error(`Plugin not found in catalog: ${repo}`));
+    }
+    if (version && version !== plugin.version) {
+      return Effect.fail(new Error(`Version ${version} not available for ${repo}; only ${plugin.version} is cached`));
+    }
+    return Effect.succeed(plugin);
+  }
+};
+
+export {
+  EdgeRegistryPluginProvider
+};
+//# sourceMappingURL=chunk-FO3IYSLV.mjs.map

package/dist/lib/browser/chunk-FO3IYSLV.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/edge-registry-plugin-provider.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Context } from '@dxos/context';\nimport { type EdgeHttpClient } from '@dxos/edge-client';\nimport { type PluginEntry } from '@dxos/protocols';\n\nimport * as Registry from './registry';\n\n/**\n * Maps a wire-format `PluginEntry` (from `@dxos/protocols`) to a\n * `Registry.Plugin` (the app-framework domain type).\n *\n * This is the only translation seam between the two independently-defined type\n * hierarchies — fields are mapped explicitly, with no shared type between them.\n */\nconst toRegistryPlugin = (entry: PluginEntry): Registry.Plugin => ({\n  id: entry.meta.id,\n  name: entry.meta.name,\n  description: entry.meta.description,\n  homePage: entry.meta.homePage,\n  source: entry.meta.source,\n  screenshots: entry.meta.screenshots ? [...entry.meta.screenshots] : undefined,\n  tags: entry.meta.tags ? [...entry.meta.tags] : undefined,\n  icon: entry.meta.icon,\n  iconHue: entry.meta.iconHue,\n  moduleUrl: entry.moduleUrl,\n  repo: entry.repo,\n  version: entry.releaseTag,\n});\n\n/**\n * Implements `Registry.PluginProvider` against the Edge `/registry` HTTP endpoints.\n *\n * Lives in app-framework (rather than the more obvious home of `@dxos/edge-client`)\n * because edge-client doesn't depend on app-framework; siting the implementation\n * here keeps the dependency arrow `app-framework → edge-client` and avoids a\n * cycle. The class needs only the public `EdgeHttpClient` type, so a one-way\n * type-import is enough.\n *\n * `listVersions` is currently a stub: it returns the single latest version derived\n * from the cached plugin list, so the host's version picker has something to render.\n * The wire contract for the real endpoint already exists — see\n * `GetPluginVersionsResponseBodySchema` in `@dxos/protocols/edge/registry` and\n * {@link EdgeHttpClient.getRegistryPluginVersions} — so once Edge ships\n * `GET /registry/plugins/:repo/versions`, swap this stub for a call to\n * `this._client.getRegistryPluginVersions(...)` and map each entry through a\n * `toRegistryPluginVersion` helper (mirror of {@link toRegistryPlugin}).\n */\nexport class EdgeRegistryPluginProvider implements Registry.PluginProvider {\n  // Cached on first load so getPlugin/listVersions can resolve without re-fetching.\n  #cachedPlugins: readonly Registry.Plugin[] = [];\n\n  constructor(private readonly _client: EdgeHttpClient) {}\n\n  listPlugins(): Effect.Effect<readonly Registry.Plugin[], Error> {\n    return Effect.tryPromise({\n      try: () => this._client.getRegistryPlugins(Context.default()),\n      catch: (error) => (error instanceof Error ? error : new Error(String(error))),\n    }).pipe(\n      Effect.map((body) => {\n        const plugins = body.plugins.filter((entry) => entry.health === 'ok').map(toRegistryPlugin);\n        this.#cachedPlugins = plugins;\n        return plugins;\n      }),\n    );\n  }\n\n  listVersions(repo: string): Effect.Effect<readonly Registry.PluginVersion[], Error> {\n    // Stub: return only the currently-known version until Edge implements the versions endpoint.\n    const plugin = this.#cachedPlugins.find((candidate) => candidate.repo === repo);\n    if (!plugin) {\n      return Effect.fail(new Error(`Plugin not found in catalog: ${repo}`));\n    }\n    const version: Registry.PluginVersion = { tag: plugin.version, moduleUrl: plugin.moduleUrl };\n    return Effect.succeed([version]);\n  }\n\n  getPlugin(repo: string, version?: string): Effect.Effect<Registry.Plugin, Error> {\n    const plugin = this.#cachedPlugins.find((p) => p.repo === repo);\n    if (!plugin) {\n      return Effect.fail(new Error(`Plugin not found in catalog: ${repo}`));\n    }\n    if (version && version !== plugin.version) {\n      return Effect.fail(new Error(`Version ${version} not available for ${repo}; only ${plugin.version} is cached`));\n    }\n    return Effect.succeed(plugin);\n  }\n}\n"],
+  "mappings": ";AAIA,YAAYA,YAAY;AAExB,SAASC,eAAe;AAMxB,IAAA,eAAA;IASEC,mBAAqB,CAAA,WAAA;EACrBC,IAAAA,MAAAA,KAAaC;EACbC,MAAAA,MAAUD,KAAME;EAChBC,aAAQH,MAAWG,KAAAA;EACnBC,UAAAA,MAAaJ,KAAME;UAAuBF,MAAME,KAAKE;eAAeC,MAAAA,KAAAA,cAAAA;IACpEC,GAAMN,MAAME,KAAKI;;QAA8BD,MAAAA,KAAAA,OAAAA;IAC/CE,GAAMP,MAAME,KAAKK;EACjBC,IAAAA;EACAC,MAAAA,MAAWT,KAAMS;EACjBC,SAAMV,MAAMU,KAAI;EAChBC,WAASX,MAAMY;EACjB,MAAA,MAAA;EAEA,SAAA,MAAA;;AAmBE,IAAA,6BAAA,MAAA;EACA;;mBAE6BC,CAAAA;EAA0B,YAAA,SAAA;AAEvDC,SAAAA,UAAgE;;gBAEvD;WACGC,kBAAWA;MAClBC,KACDpB,MAAAA,KAAU,QAAEqB,mBAAAA,QAAAA,QAAAA,QAAAA,EAAAA,YAAAA,YAAAA,GAAAA,cAAAA,GAAAA,GAAAA,CAAAA,CAAAA;MACV,OAAMC,CAAAA,UAAUD,iBAAaE,QAAQnB,QAAUA,IAAMoB,MAAM,OAAK,KAAS,CAACC;YACrE,WAAA,CAAA,SAAiBH;AACtB,YAAA,UAAOA,KAAAA,QAAAA,OAAAA,CAAAA,UAAAA,MAAAA,WAAAA,IAAAA,EAAAA,IAAAA,gBAAAA;AACT,WAAA,iBAAA;AAEJ,aAAA;IAEAI,CAAAA,CAAAA;;eAEQC,MAAS;UAEb,SAAO3B,KAAO4B,eAAgB,KAAA,CAAA,cAAA,UAA6B,SAAQ,IAAA;AACrE,QAAA,CAAA,QAAA;AACA,aAAwC,YAAA,IAAA,MAAA,gCAAA,IAAA,EAAA,CAAA;;UAAuBf,UAAWc;MAAiB,KAAA,OAAA;MAC3F,WAAcE,OAAQ;;WAAS,eAAA;MACjC;IAEAC,CAAAA;;YAEOH,MAAAA,SAAQ;UACX,SAAO3B,KAAO4B,eAAgB,KAAA,CAAA,MAAA,EAAA,SAAA,IAAA;AAChC,QAAA,CAAA,QAAA;AACIb,aAAWA,YAAAA,IAAYY,MAAAA,gCAAgB,IAAA,EAAA,CAAA;;AAE3C,QAAA,WAAA,YAAA,OAAA,SAAA;AACA,aAAcE,YAAQF,IAAAA,MAAAA,WAAAA,OAAAA,sBAAAA,IAAAA,UAAAA,OAAAA,OAAAA,YAAAA,CAAAA;IACxB;AACF,WAAA,eAAA,MAAA;;;",
+  "names": ["Effect", "Context", "name", "description", "entry", "homePage", "meta", "source", "screenshots", "undefined", "tags", "icon", "iconHue", "moduleUrl", "repo", "version", "releaseTag", "_client", "listPlugins", "error", "pipe", "body", "plugins", "filter", "health", "toRegistryPlugin", "listVersions", "plugin", "fail", "succeed", "getPlugin"]
+}

package/dist/lib/browser/chunk-J5LGTIGS.mjs

@@ -0,0 +1,10 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+export {
+  __export
+};
+//# sourceMappingURL=chunk-J5LGTIGS.mjs.map