@dxos/app-framework 0.8.4-main.bc674ce → 0.8.4-main.bcb3aa67d6

package/dist/lib/node-esm/chunk-OXXXRCQX.mjs

@@ -0,0 +1,158 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  isPlugin
+} from "./chunk-CG6UBBZZ.mjs";
+import {
+  __export
+} from "./chunk-HSLMI22Q.mjs";
+
+// src/core/url-loader.ts
+var url_loader_exports = {};
+__export(url_loader_exports, {
+  make: () => make,
+  preload: () => preload
+});
+import * as Effect from "effect/Effect";
+import { log } from "@dxos/log";
+var __dxlog_file = "/__w/dxos/dxos/packages/sdk/app-framework/src/core/url-loader.ts";
+var DEFAULT_KEY = "org.dxos.composer.remote-plugins";
+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
+    }, {
+      F: __dxlog_file,
+      L: 57,
+      S: void 0,
+      C: (f, a) => f(...a)
+    });
+  }
+};
+var isUrl = (locator) => {
+  try {
+    const url = new URL(locator);
+    return url.protocol === "http:" || url.protocol === "https:";
+  } catch {
+    return false;
+  }
+};
+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 loadRemotePlugin = async (url) => {
+  log.info("loading remote plugin", {
+    url
+  }, {
+    F: __dxlog_file,
+    L: 85,
+    S: void 0,
+    C: (f, a) => f(...a)
+  });
+  const mod = await import(
+    /* @vite-ignore */
+    url
+  );
+  const plugin = normalizePluginExport(mod);
+  if (!plugin.meta.id || !plugin.meta.name) {
+    throw new Error(`Remote plugin at ${url} is missing required meta.id or meta.name.`);
+  }
+  return plugin;
+};
+var preload = async (options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  const entries = getPersistedRemotePlugins(storage, key);
+  if (entries.length === 0) {
+    return [];
+  }
+  log.info("preloading remote plugins", {
+    count: entries.length
+  }, {
+    F: __dxlog_file,
+    L: 105,
+    S: void 0,
+    C: (f, a) => f(...a)
+  });
+  const results = await Promise.allSettled(entries.map((entry) => loadRemotePlugin(entry.url)));
+  const plugins = [];
+  for (let index = 0; index < results.length; index++) {
+    const result = results[index];
+    if (result.status === "fulfilled") {
+      plugins.push(result.value);
+    } else {
+      log.warn("failed to preload remote plugin", {
+        entry: entries[index],
+        error: result.reason
+      }, {
+        F: __dxlog_file,
+        L: 113,
+        S: void 0,
+        C: (f, a) => f(...a)
+      });
+    }
+  }
+  return plugins;
+};
+var make = (builtinPlugins, options = {}) => {
+  const storage = options.storage ?? defaultStorage();
+  const key = options.key ?? DEFAULT_KEY;
+  return (locator) => Effect.gen(function* () {
+    const builtin = builtinPlugins.find((plugin2) => plugin2.meta.id === locator);
+    if (builtin) {
+      return builtin;
+    }
+    if (!isUrl(locator)) {
+      return yield* Effect.fail(new Error(`Plugin not found and locator is not a URL: ${locator}`));
+    }
+    const plugin = yield* Effect.tryPromise({
+      try: () => loadRemotePlugin(locator),
+      catch: (error) => new Error(`Failed to load remote plugin from ${locator}: ${error}`)
+    });
+    const duplicate = builtinPlugins.find((existing) => existing.meta.id === plugin.meta.id);
+    if (duplicate) {
+      return yield* Effect.fail(new Error(`Remote plugin ${plugin.meta.id} conflicts with built-in plugin of the same id.`));
+    }
+    persistRemotePlugin(storage, key, {
+      id: plugin.meta.id,
+      url: locator
+    });
+    return plugin;
+  });
+};
+
+export {
+  preload,
+  make,
+  url_loader_exports
+};
+//# sourceMappingURL=chunk-OXXXRCQX.mjs.map

package/dist/lib/node-esm/chunk-OXXXRCQX.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/url-loader.ts"],
+  "sourcesContent": ["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { log } from '@dxos/log';\n\nimport * as Plugin from './plugin';\n\nconst DEFAULT_KEY = 'org.dxos.composer.remote-plugins';\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\ntype RemotePluginEntry = { id: string; url: string };\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 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\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\nconst loadRemotePlugin = async (url: string): Promise<Plugin.Plugin> => {\n  log.info('loading remote plugin', { url });\n  const mod = await import(/* @vite-ignore */ url);\n  const plugin = normalizePluginExport(mod);\n  if (!plugin.meta.id || !plugin.meta.name) {\n    throw new Error(`Remote plugin at ${url} is missing required meta.id or meta.name.`);\n  }\n  return plugin;\n};\n\n/**\n * Preloads previously persisted remote plugins from storage.\n */\nexport const preload = async (options: Options = {}): Promise<Plugin.Plugin[]> => {\n  const storage = options.storage ?? defaultStorage();\n  const key = options.key ?? DEFAULT_KEY;\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 results = await Promise.allSettled(entries.map((entry) => loadRemotePlugin(entry.url)));\n  const plugins: Plugin.Plugin[] = [];\n  for (let index = 0; index < results.length; index++) {\n    const result = results[index];\n    if (result.status === 'fulfilled') {\n      plugins.push(result.value);\n    } else {\n      log.warn('failed to preload remote plugin', { entry: entries[index], error: result.reason });\n    }\n  }\n  return plugins;\n};\n\n/**\n * Creates a plugin loader that resolves built-in plugins by ID or loads remote plugins from URLs.\n */\nexport const make = (builtinPlugins: Plugin.Plugin[], options: Options = {}) => {\n  const storage = options.storage ?? defaultStorage();\n  const key = options.key ?? DEFAULT_KEY;\n\n  return (locator: string): Effect.Effect<Plugin.Plugin, Error> =>\n    Effect.gen(function* () {\n      const builtin = builtinPlugins.find((plugin) => plugin.meta.id === locator);\n      if (builtin) {\n        return builtin;\n      }\n      if (!isUrl(locator)) {\n        return yield* Effect.fail(new Error(`Plugin not found and locator is not a URL: ${locator}`));\n      }\n      const plugin = yield* Effect.tryPromise({\n        try: () => loadRemotePlugin(locator),\n        catch: (error) => new Error(`Failed to load remote plugin from ${locator}: ${error}`),\n      });\n      const duplicate = builtinPlugins.find((existing) => existing.meta.id === plugin.meta.id);\n      if (duplicate) {\n        return yield* Effect.fail(\n          new Error(`Remote plugin ${plugin.meta.id} conflicts with built-in plugin of the same id.`),\n        );\n      }\n      persistRemotePlugin(storage, key, { id: plugin.meta.id, url: locator });\n      return plugin;\n    });\n};\n"],
+  "mappings": "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",
+  "names": ["Effect", "log", "DEFAULT_KEY", "defaultStorage", "get", "key", "localStorage", "getItem", "set", "value", "setItem", "getPersistedRemotePlugins", "storage", "parsed", "JSON", "parse", "Array", "isArray", "filter", "entry", "id", "url", "persistRemotePlugin", "entries", "existing", "push", "stringify", "error", "log", "warn", "isUrl", "locator", "URL", "protocol", "normalizePluginExport", "mod", "exported", "default", "isPlugin", "result", "Error", "loadRemotePlugin", "info", "plugin", "meta", "name", "preload", "options", "length", "count", "results", "Promise", "allSettled", "map", "plugins", "index", "status", "reason", "make", "builtinPlugins", "gen", "builtin", "find", "fail", "tryPromise", "try", "catch", "duplicate"]
+}

package/dist/lib/node-esm/chunk-WZCSOX5Q.mjs

@@ -0,0 +1,35 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+import {
+  activation_event_exports
+} from "./chunk-ZZ7CKK6W.mjs";
+import {
+  __export
+} from "./chunk-HSLMI22Q.mjs";
+
+// src/common/activation-events.ts
+var activation_events_exports = {};
+__export(activation_events_exports, {
+  ManagedRuntimeReady: () => ManagedRuntimeReady,
+  OperationInvokerReady: () => OperationInvokerReady,
+  SetupLayer: () => SetupLayer,
+  SetupOperationHandler: () => SetupOperationHandler,
+  SetupReactSurface: () => SetupReactSurface,
+  Startup: () => Startup
+});
+var Startup = activation_event_exports.make("org.dxos.app-framework.event.startup");
+var SetupReactSurface = activation_event_exports.make("org.dxos.app-framework.event.setup-react-surface");
+var SetupOperationHandler = activation_event_exports.make("org.dxos.app-framework.event.setup-operation-handler");
+var SetupLayer = activation_event_exports.make("org.dxos.app-framework.event.setup-layer");
+var OperationInvokerReady = activation_event_exports.make("org.dxos.app-framework.event.operation-invoker-ready");
+var ManagedRuntimeReady = activation_event_exports.make("org.dxos.app-framework.event.managed-runtime-ready");
+
+export {
+  Startup,
+  SetupReactSurface,
+  SetupOperationHandler,
+  SetupLayer,
+  OperationInvokerReady,
+  ManagedRuntimeReady,
+  activation_events_exports
+};
+//# sourceMappingURL=chunk-WZCSOX5Q.mjs.map

package/dist/lib/node-esm/chunk-WZCSOX5Q.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/common/activation-events.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { ActivationEvent as ActivationEvent$ } from '../core';\n\n/**\n * Fired when the app is started.\n */\nexport const Startup = ActivationEvent$.make('org.dxos.app-framework.event.startup');\n\n//\n// Dependent Events\n//\n\n/**\n * Fired to load any newly available surfaces.\n */\nexport const SetupReactSurface = ActivationEvent$.make('org.dxos.app-framework.event.setup-react-surface');\n\n/**\n * Fired before the operation invoker is activated.\n */\nexport const SetupOperationHandler = ActivationEvent$.make('org.dxos.app-framework.event.setup-operation-handler');\n\n/**\n * Fired before the managed runtime is created.\n * Plugins should contribute their Layer capabilities before this event.\n */\nexport const SetupLayer = ActivationEvent$.make('org.dxos.app-framework.event.setup-layer');\n\n//\n// Triggered Events\n//\n\n/**\n * Fired after the operation invoker is ready.\n */\nexport const OperationInvokerReady = ActivationEvent$.make('org.dxos.app-framework.event.operation-invoker-ready');\n\n/**\n * Fired after the managed runtime is ready.\n */\nexport const ManagedRuntimeReady = ActivationEvent$.make('org.dxos.app-framework.event.managed-runtime-ready');\n"],
+  "mappings": ";;;;;;;;;AAAA;;;;;;;;;AASO,IAAMA,UAAUC,yBAAiBC,KAAK,sCAAA;AAStC,IAAMC,oBAAoBF,yBAAiBC,KAAK,kDAAA;AAKhD,IAAME,wBAAwBH,yBAAiBC,KAAK,sDAAA;AAMpD,IAAMG,aAAaJ,yBAAiBC,KAAK,0CAAA;AASzC,IAAMI,wBAAwBL,yBAAiBC,KAAK,sDAAA;AAKpD,IAAMK,sBAAsBN,yBAAiBC,KAAK,oDAAA;",
+  "names": ["Startup", "ActivationEvent$", "make", "SetupReactSurface", "SetupOperationHandler", "SetupLayer", "OperationInvokerReady", "ManagedRuntimeReady"]
+}