webloom-framework 0.3.0 → 0.4.1

package/dist/index.js

@@ -1,1385 +1,64 @@
-import { RuntimeInitializationError, createRuntimeUnitImplementationRegistry, createPluginHost, StartupPluginError, createRemoteServiceMessageCodec, createRuntimeMessageCodec, RemoteServiceError, UpgradeGateRejectedError, unitSnapshotFromState, RuntimeUnavailableError, RUNTIME_PROTOCOL_VERSION, RUNTIME_SNAPSHOT_TYPE, RUNTIME_ERROR_TYPE } from './chunk-76BGPI6M.js';
-export { LIFECYCLE_ERROR_TEXT, LifecycleScopeRevokedError, PermissionDeniedError, PermissionLeaseRevokedError, PluginGraphValidationError, RESOURCE_OWNER, RESOURCE_REGISTRY_CAPABILITY, RUNTIME_ERROR_TYPE, RUNTIME_MESSAGE_BUS, RUNTIME_PROTOCOL_VERSION, RUNTIME_SNAPSHOT_TYPE, RemoteServiceError, RuntimeInitializationError, RuntimeUnavailableError, SCOPED_TASK_SCHEDULER_CAPABILITY, StartupCapabilityError, StartupPluginError, UpgradeGateRejectedError, buildPluginGraph, connectSharedWorker, createCapabilityRegistry, createInMemoryPluginConfigStore, createLifecycleScope, createMessageBus, createMessagePortServiceTransport, createPermissionLease, createPluginHost, createPluginIntentController, createRemoteServiceMessageCodec, createResourceRegistry, createResourceScope, createResourceStore, createRuntimeMessageCodec, createRuntimeUnitImplementationRegistry, createScopedMessageBus, createScopedTaskScheduler, createServiceBridge, dependenciesOfManifest, isRuntimeError, isRuntimeSnapshot, isRuntimeSnapshotProtocol, lifecycleErrorText, providesOfManifest, registerOwnedResource, reverseDependentsOf, unitSnapshotFromState, validatePluginGraph, validateRuntimeUnitDependencyContracts } from './chunk-76BGPI6M.js';
+export { startSharedWorkerApp } from './chunk-SX46RHDI.js';
+export { connectSharedWorker } from './chunk-ANA6GBEI.js';
+import { capabilityDescriptor } from './chunk-HJKPKWI7.js';
+export { LIFECYCLE_ERROR_TEXT, LifecycleScopeRevokedError, PermissionDeniedError, PermissionLeaseRevokedError, RESOURCE_OWNER, RESOURCE_REGISTRY, RuntimeInitializationError, RuntimeUnavailableError, SCOPED_TASK_SCHEDULER_CAPABILITY, UpgradeGateRejectedError, WebLoomError, assertCapability, capabilityDescriptor, capabilityKey, createLifecycleScope, createMessageBus, createResourceScope, createWindowApp, defineCapability, isCapability, isCapabilityDescriptor, lifecycleErrorText } from './chunk-HJKPKWI7.js';
 
-// src/contracts/plugin.ts
-function runtimeCapabilityContractVersion(capability) {
-  return `${capability}.v1`;
+// src/contracts/messageBus.ts
+var RUNTIME_MESSAGE_BUS = "webloom.messageBus";
+
+// src/authoring/definePlugin.ts
+function nonEmpty(value, label) {
+  if (value.trim() === "") throw new TypeError(`${label} must be a non-empty string`);
+  return value;
 }
-function defineRuntimeUnitDependencies(dependencies, defaults) {
+function normalizeDependencies(dependencies, runtime) {
   return dependencies.map((dependency) => ({
-    capability: dependency.capability,
-    contractVersion: runtimeCapabilityContractVersion(dependency.capability),
-    sourceRuntime: defaults.sourceRuntime,
+    capability: capabilityDescriptor(dependency.capability),
+    ...dependency.source === "peer" ? { source: "peer" } : { sourceRuntime: dependency.sourceRuntime ?? runtime },
     ...dependency.reason !== void 0 ? { reason: dependency.reason } : {},
     ...dependency.optional !== void 0 ? { optional: dependency.optional } : {}
   }));
 }
-function defineRuntimeUnitProvidedContracts(capabilities) {
-  return Object.fromEntries(
-    capabilities.map((capability) => [capability, runtimeCapabilityContractVersion(capability)])
-  );
-}
-
-// src/authoring/definePlugin.ts
-function normalizeDependency(dependency) {
-  const contractVersion = dependency.contractVersion ?? runtimeCapabilityContractVersion(dependency.capability);
-  return {
-    capability: dependency.capability,
-    contractVersion,
-    ...dependency.sourceRuntime !== void 0 ? { sourceRuntime: dependency.sourceRuntime } : {},
-    ...dependency.reason !== void 0 ? { reason: dependency.reason } : {},
-    ...dependency.optional !== void 0 ? { optional: dependency.optional } : {}
-  };
-}
 function definePlugin(options) {
-  if (!options || typeof options.id !== "string" || options.id.trim() === "") {
-    throw new Error("Plugin id must be a non-empty string");
-  }
-  if (typeof options.setup !== "function") throw new Error(`Plugin "${options.id}" setup must be a function`);
-  const unitId = options.unitId ?? options.id;
-  if (unitId.trim() === "") throw new Error(`Plugin "${options.id}" unitId must be a non-empty string`);
-  const provides = [...new Set(options.provides ?? [])];
-  const dependencies = (options.dependencies ?? []).map(normalizeDependency);
-  const providedContracts = {
-    ...defineRuntimeUnitProvidedContracts(provides),
-    ...options.providedContracts ?? {}
-  };
+  if (!options || typeof options.id !== "string") throw new TypeError("Plugin id must be a non-empty string");
+  nonEmpty(options.id, "Plugin id");
+  if (typeof options.setup !== "function") throw new TypeError(`Plugin "${options.id}" setup must be a function`);
+  const unitId = nonEmpty(options.unitId ?? options.id, `Plugin "${options.id}" unitId`);
+  const startup = options.startup ?? "optional";
+  const defaultEnabled = options.defaultEnabled ?? true;
+  const canDisable = options.canDisable ?? startup !== "required";
+  if (startup === "required" && (!defaultEnabled || canDisable)) {
+    throw new TypeError(`Plugin "${options.id}" required startup policy is inconsistent`);
+  }
+  const provides = [...options.provides ?? []];
+  const dependencies = [...options.dependencies ?? []];
+  const runtime = options.runtime;
   const descriptor = {
     id: unitId,
-    ...options.runtime !== void 0 ? { runtime: options.runtime } : {},
-    ...dependencies.length > 0 ? { dependencies } : {},
-    ...provides.length > 0 ? { provides } : {},
-    ...Object.keys(providedContracts).length > 0 ? { providedContracts } : {},
-    ...options.contribution !== void 0 ? { contribution: options.contribution } : {},
+    ...runtime !== void 0 ? { runtime } : {},
+    ...provides.length > 0 ? { provides: provides.map((capability) => capabilityDescriptor(capability)) } : {},
+    ...dependencies.length > 0 ? { dependencies: normalizeDependencies(dependencies, runtime ?? "window-main") } : {},
     ...options.permissions !== void 0 ? { permissions: [...options.permissions] } : {},
-    ...options.config !== void 0 ? { config: options.config } : {}
-  };
-  const metaInput = options.meta ?? {};
-  const required = options.required === true || options.startup === "required" || metaInput.startup === "required";
-  const meta = {
-    ...metaInput,
-    defaultEnabled: options.defaultEnabled ?? metaInput.defaultEnabled ?? true,
-    canDisable: options.canDisable ?? metaInput.canDisable ?? !required,
-    startup: required ? "required" : options.startup ?? metaInput.startup ?? "optional"
+    ...options.config !== void 0 ? { config: options.config } : {},
+    ...options.contribution !== void 0 ? { contribution: options.contribution } : {}
   };
-  if (meta.startup === "required" && (meta.canDisable || !meta.defaultEnabled)) {
-    throw new Error(`Plugin "${options.id}" required metadata is inconsistent`);
-  }
   const manifest = {
     id: options.id,
     name: options.name ?? options.id,
     ...options.description !== void 0 ? { description: options.description } : {},
-    meta,
+    startup,
+    defaultEnabled,
+    canDisable,
     units: [descriptor]
   };
   return Object.freeze({
     manifest: Object.freeze(manifest),
     descriptor: Object.freeze(descriptor),
-    setup: options.setup
+    setup: options.setup,
+    capabilities: Object.freeze([...provides, ...dependencies.map((dependency) => dependency.capability)])
   });
 }
 
-// src/runtime/pluginDefinitions.ts
-function normalizeProductDependencies(dependencies, runtime) {
-  return dependencies?.map((dependency) => ({
-    capability: dependency.capability,
-    contractVersion: dependency.contractVersion ?? runtimeCapabilityContractVersion(dependency.capability),
-    sourceRuntime: dependency.sourceRuntime ?? runtime,
-    ...dependency.reason !== void 0 ? { reason: dependency.reason } : {},
-    ...dependency.optional !== void 0 ? { optional: dependency.optional } : {}
-  }));
-}
-function materializePluginDefinition(input, runtime) {
-  const manifest = input.manifest;
-  const setup = input.setup;
-  if (!manifest || typeof manifest.id !== "string" || manifest.id.trim() === "") {
-    throw new Error("Plugin manifest id must be a non-empty string");
-  }
-  const existingUnits = manifest.units ?? [];
-  const requestedUnitId = "unitId" in input ? input.unitId : void 0;
-  const matchingUnits = existingUnits.filter((unit) => unit.runtime === void 0 || unit.runtime === runtime);
-  let implementationUnitId;
-  if (existingUnits.length === 0) {
-    implementationUnitId = manifest.id;
-  } else if (requestedUnitId !== void 0) {
-    const selected = existingUnits.find((unit) => unit.id === requestedUnitId);
-    if (!selected) throw new Error(`Plugin "${manifest.id}" does not declare unit "${requestedUnitId}"`);
-    if (selected.runtime !== void 0 && selected.runtime !== runtime) {
-      throw new Error(`Plugin "${manifest.id}" unit "${requestedUnitId}" targets ${selected.runtime}, not ${runtime}`);
-    }
-    implementationUnitId = selected.id;
-  } else if (matchingUnits.length === 1 && matchingUnits[0]) {
-    implementationUnitId = matchingUnits[0].id;
-  } else {
-    throw new Error(
-      `Plugin "${manifest.id}" has ${matchingUnits.length} implementation units for ${runtime}; specify unitId explicitly`
-    );
-  }
-  const selectedUnit = existingUnits.length > 0 ? existingUnits.find((unit) => unit.id === implementationUnitId) : void 0;
-  const units = selectedUnit ? [(() => {
-    const unitRuntime = selectedUnit.runtime ?? runtime;
-    const provides = [...selectedUnit.provides ?? []];
-    const dependencies = selectedUnit.dependencies?.map((dependency) => ({
-      capability: dependency.capability,
-      contractVersion: dependency.contractVersion ?? runtimeCapabilityContractVersion(dependency.capability),
-      sourceRuntime: dependency.sourceRuntime ?? unitRuntime,
-      ...dependency.reason !== void 0 ? { reason: dependency.reason } : {},
-      ...dependency.optional !== void 0 ? { optional: dependency.optional } : {}
-    }));
-    return {
-      ...selectedUnit,
-      runtime: unitRuntime,
-      dependencies,
-      ...provides.length > 0 ? { providedContracts: { ...defineRuntimeUnitProvidedContracts(provides), ...selectedUnit.providedContracts ?? {} } } : {}
-    };
-  })()] : [{
-    id: manifest.id,
-    runtime,
-    dependencies: normalizeProductDependencies(manifest.dependencies, runtime),
-    ...manifest.provides && manifest.provides.length > 0 ? {
-      provides: [...manifest.provides],
-      providedContracts: defineRuntimeUnitProvidedContracts(manifest.provides)
-    } : {},
-    ...manifest.permissions !== void 0 ? { permissions: [...manifest.permissions] } : {},
-    ...manifest.config !== void 0 ? { config: manifest.config } : {},
-    ...manifest.contribution !== void 0 ? { contribution: manifest.contribution } : {}
-  }];
-  const normalized = {
-    ...manifest,
-    units
-    // Product-level declarations are retained only for compatibility with
-    // low-level manifests; the selected unit is the source of truth in Host.
-  };
-  return { manifest: normalized, unitId: implementationUnitId, setup };
-}
-function materializePluginDefinitions(inputs, runtime) {
-  return inputs.map((input) => materializePluginDefinition(input, runtime));
-}
-
-// src/runtime/windowRuntime.ts
-function makeRuntimeInstanceId(runtimeId) {
-  try {
-    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
-      return `${runtimeId}:${crypto.randomUUID()}`;
-    }
-  } catch {
-  }
-  return `${runtimeId}:${Date.now().toString(36)}:${Math.random().toString(36).slice(2)}`;
-}
-function errorMessage(error) {
-  return error instanceof Error ? error.message : String(error);
-}
-function isStartupPluginError(error) {
-  return error instanceof StartupPluginError && typeof error.details?.pluginId === "string";
-}
-function buildLocalServices(host, manifests, runtimeInstanceId) {
-  const services = [];
-  for (const manifest of manifests) {
-    const state = host.state(manifest.id);
-    const unit = manifest.units?.find((candidate) => candidate.id === state.unitId) ?? manifest.units?.[0];
-    if (!unit || unit.runtime === void 0 || !state.instanceId || state.kind !== "enabled") continue;
-    for (const capability of unit.provides ?? []) {
-      services.push({
-        capabilityId: capability,
-        contractVersion: unit.providedContracts?.[capability] ?? `${capability}.v1`,
-        runtime: unit.runtime,
-        runtimeInstanceId,
-        serviceInstanceId: state.instanceId,
-        status: "ready",
-        attributes: Object.freeze({})
-      });
-    }
-  }
-  return services;
-}
-async function createWindowApp(options) {
-  const runtimeId = options.id ?? "window-main";
-  const remoteRuntime = options.remoteRuntime;
-  const runtimeInstanceId = makeRuntimeInstanceId(runtimeId);
-  let currentState = {
-    runtimeId,
-    runtimeKind: "window-main",
-    runtimeInstanceId,
-    state: "starting",
-    revision: 0,
-    units: [],
-    services: []
-  };
-  const listeners = /* @__PURE__ */ new Set();
-  let disposed = false;
-  let disposePromise;
-  const emit = (next) => {
-    currentState = Object.freeze({
-      ...next,
-      units: Object.freeze([...next.units]),
-      services: Object.freeze([...next.services])
-    });
-    for (const listener of [...listeners]) {
-      try {
-        listener(currentState);
-      } catch {
-      }
-    }
-  };
-  let materialized;
-  try {
-    materialized = materializePluginDefinitions(options.plugins, "window-main");
-  } catch (error) {
-    throw new RuntimeInitializationError({ phase: "validate", error: errorMessage(error) });
-  }
-  const manifests = materialized.map((item) => item.manifest);
-  let implementations;
-  try {
-    const duplicate = manifests.find((manifest, index) => manifests.findIndex((candidate) => candidate.id === manifest.id) !== index);
-    if (duplicate) throw new Error(`Plugin "${duplicate.id}" is declared more than once`);
-    implementations = createRuntimeUnitImplementationRegistry(
-      materialized.map((item) => ({
-        pluginId: item.manifest.id,
-        unitId: item.unitId,
-        setup: item.setup
-      }))
-    );
-  } catch (error) {
-    throw new RuntimeInitializationError({ phase: "validate", error: errorMessage(error) });
-  }
-  let host;
-  const suppliedHost = options.host;
-  const remoteServiceBridge = remoteRuntime ? remoteRuntime.serviceBridge : void 0;
-  try {
-    const {
-      id: _id,
-      plugins: _plugins,
-      host: _host,
-      remoteRuntime: _remoteRuntime,
-      ...hostOptions
-    } = options;
-    const suppliedBridgeFactory = hostOptions.serviceBridgeForPlugin;
-    host = suppliedHost ?? createPluginHost({
-      ...hostOptions,
-      runtime: "window-main",
-      externalRuntimeDependencies: remoteRuntime !== void 0 || hostOptions.externalRuntimeDependencies,
-      remoteServiceReferences: () => remoteRuntime?.state().services ?? hostOptions.remoteServiceReferences?.() ?? [],
-      runtimeSnapshots: () => remoteRuntime ? remoteRuntime.state().units.map((unit) => ({
-        pluginId: unit.pluginId,
-        unitId: unit.unitId,
-        runtime: unit.runtime,
-        ...unit.instanceId !== void 0 ? { instanceId: unit.instanceId } : {},
-        state: unit.state
-      })) : hostOptions.runtimeSnapshots?.() ?? [],
-      serviceBridgeForPlugin: (pluginId, instanceId) => suppliedBridgeFactory?.(pluginId, instanceId) ?? remoteServiceBridge,
-      rootAttributes: {
-        ...hostOptions.rootAttributes ?? {},
-        runtimeId,
-        runtimeInstanceId
-      },
-      runtimeUnitImplementationRegistry: implementations
-    });
-  } catch (error) {
-    throw new RuntimeInitializationError({ phase: "validate", error: errorMessage(error) });
-  }
-  let removeRemoteSubscription;
-  const manifestsForSnapshot = () => {
-    if (!suppliedHost) return manifests;
-    return suppliedHost.manifests().map((pluginId) => suppliedHost.getManifest(pluginId)).filter((manifest) => manifest !== void 0);
-  };
-  const refresh = () => {
-    const snapshotManifests = manifestsForSnapshot();
-    const units = snapshotManifests.flatMap((manifest) => {
-      const state = host.state(manifest.id);
-      return (state.units ?? []).map((unit) => unitSnapshotFromState(
-        unit,
-        unit.runtime
-      ));
-    });
-    const revision = Math.max(currentState.revision + 1, host.version());
-    emit({
-      ...currentState,
-      revision,
-      units,
-      services: [
-        ...buildLocalServices(host, snapshotManifests, runtimeInstanceId),
-        ...remoteRuntime?.state().services ?? []
-      ]
-    });
-  };
-  const removeHostSubscription = host.subscribe(refresh);
-  try {
-    if (!suppliedHost) await host.registerAll(manifests);
-    const failedRequired = suppliedHost ? void 0 : manifests.find((manifest) => {
-      const required = manifest.meta.startup === "required" || manifest.meta.canDisable === false;
-      return required && host.state(manifest.id).kind !== "enabled";
-    });
-    if (failedRequired) {
-      const state = host.state(failedRequired.id);
-      throw new StartupPluginError({
-        pluginId: failedRequired.id,
-        unitId: state.unitId ?? failedRequired.units?.[0]?.id ?? failedRequired.id,
-        capabilities: [],
-        state: state.kind,
-        error: state.error ?? `Required plugin is ${state.kind}${state.blockedBy ? `: ${state.blockedBy.join(", ")}` : ""}`
-      });
-    }
-  } catch (error) {
-    refresh();
-    const pluginId = isStartupPluginError(error) ? error.details.pluginId : void 0;
-    const manifest = pluginId ? manifests.find((candidate) => candidate.id === pluginId) : void 0;
-    const required = manifest?.meta.startup === "required" || manifest?.meta.canDisable === false;
-    if (required || !isStartupPluginError(error)) {
-      removeHostSubscription();
-      removeRemoteSubscription?.();
-      await host.dispose("window runtime initialization failed").catch(() => void 0);
-      if (error instanceof RuntimeInitializationError) throw error;
-      throw new RuntimeInitializationError({
-        pluginId,
-        unitId: isStartupPluginError(error) ? error.details.unitId : manifest?.units?.[0]?.id,
-        phase: "startup",
-        error: errorMessage(error)
-      });
-    }
-  }
-  refresh();
-  emit({ ...currentState, state: "ready" });
-  removeRemoteSubscription = remoteRuntime?.subscribe(() => {
-    host.refreshRuntimeUnitSnapshots();
-    void host.reconcile().catch(() => void 0);
-  });
-  const app = {
-    runtimeKind: "window-main",
-    runtimeId,
-    runtimeInstanceId,
-    host,
-    state: () => currentState,
-    capability(capabilityId) {
-      if (disposed || currentState.state === "disposed" || currentState.state === "stopping") {
-        throw new RuntimeUnavailableError("Window Runtime has been disposed");
-      }
-      return host.capabilities.get(capabilityId);
-    },
-    subscribe(listener) {
-      listeners.add(listener);
-      listener(currentState);
-      return () => listeners.delete(listener);
-    },
-    dispose(reason = "window runtime disposed") {
-      if (disposePromise) return disposePromise;
-      disposed = true;
-      emit({ ...currentState, state: "stopping" });
-      removeHostSubscription();
-      removeRemoteSubscription?.();
-      disposePromise = host.dispose(reason).then((result) => {
-        emit({ ...currentState, state: "disposed" });
-        return result;
-      }, (error) => {
-        emit({ ...currentState, state: "failed", error: errorMessage(error) });
-        throw error;
-      });
-      return disposePromise;
-    }
-  };
-  return app;
-}
-
-// src/transport/messagePortServiceProvider.ts
-function isCallMessage(input, codec) {
-  if (!input || typeof input !== "object") return false;
-  const message = input;
-  return message.type === codec.type("call") && typeof message.protocolVersion === "string" && typeof message.callId === "string" && message.callId.length > 0 && typeof message.capabilityId === "string" && typeof message.contractVersion === "string" && typeof message.serviceInstanceId === "string";
-}
-function isCancelMessage(input, codec) {
-  if (!input || typeof input !== "object") return false;
-  const message = input;
-  return message.type === codec.type("cancel") && typeof message.protocolVersion === "string" && typeof message.callId === "string" && typeof message.serviceInstanceId === "string";
-}
-function errorMessage2(error) {
-  const candidate = error && typeof error === "object" ? error : void 0;
-  const code = typeof candidate?.code === "string" && candidate.code.length > 0 ? candidate.code : "handler_failed";
-  return {
-    ...typeof candidate?.name === "string" ? { name: candidate.name } : {},
-    message: typeof candidate?.message === "string" ? candidate.message : String(error),
-    code,
-    ...candidate?.details && typeof candidate.details === "object" && !Array.isArray(candidate.details) ? { details: candidate.details } : {}
-  };
-}
-function stableValue(value) {
-  if (Array.isArray(value)) return value.map(stableValue);
-  if (!value || typeof value !== "object") return value;
-  return Object.fromEntries(
-    Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, item]) => [key, stableValue(item)])
-  );
-}
-function bindingKey(reference) {
-  return [
-    reference.capabilityId,
-    reference.contractVersion,
-    reference.runtime,
-    reference.runtimeInstanceId,
-    reference.serviceInstanceId
-  ].join("\0");
-}
-function referenceFingerprint(reference) {
-  return JSON.stringify({
-    ...reference,
-    attributes: stableValue(reference.attributes)
-  });
-}
-function postBestEffort(port, message) {
-  try {
-    port.postMessage(message);
-  } catch {
-  }
-}
-function createMessagePortServiceProvider(options) {
-  const pending = /* @__PURE__ */ new Map();
-  const codec = options.codec ?? createRemoteServiceMessageCodec();
-  let services = [...options.services?.() ?? []];
-  let bindings = /* @__PURE__ */ new Map();
-  let nextBindingEpoch = 0;
-  let revoked = false;
-  let disposed = false;
-  const buildBindings = (nextServices) => {
-    const nextBindings = /* @__PURE__ */ new Map();
-    for (const reference of nextServices) {
-      const key = bindingKey(reference);
-      const previous = bindings.get(key);
-      const epoch = previous && referenceFingerprint(previous.reference) === referenceFingerprint(reference) ? previous.epoch : ++nextBindingEpoch;
-      nextBindings.set(key, { reference, epoch });
-    }
-    return nextBindings;
-  };
-  const isCurrent = (callId, call) => {
-    const current = bindings.get(call.bindingKey);
-    return !disposed && !revoked && pending.get(callId) === call && current?.epoch === call.bindingEpoch && current.reference.serviceInstanceId === call.serviceInstanceId;
-  };
-  const revokeReplacedCalls = (nextBindings) => {
-    for (const call of pending.values()) {
-      const next = nextBindings.get(call.bindingKey);
-      if (!next || next.epoch !== call.bindingEpoch) {
-        sendError(call.message, new RemoteServiceError("service_revoked", "Remote service binding was replaced"));
-        call.controller.abort(new RemoteServiceError("service_revoked", "Remote service binding was replaced"));
-      }
-    }
-  };
-  bindings = buildBindings(services);
-  const sendError = (message, error) => {
-    const response = {
-      type: codec.type("error"),
-      protocolVersion: codec.protocolVersion,
-      callId: message.callId,
-      serviceInstanceId: message.serviceInstanceId,
-      error: errorMessage2(error)
-    };
-    postBestEffort(options.port, codec.encode(response));
-  };
-  const onMessage = (event) => {
-    if (disposed) return;
-    const decoded = codec.decode(event.data);
-    if (isCancelMessage(decoded, codec)) {
-      if (decoded.protocolVersion !== codec.protocolVersion) return;
-      const call2 = pending.get(decoded.callId);
-      if (call2?.serviceInstanceId === decoded.serviceInstanceId) {
-        call2.controller.abort(new RemoteServiceError("request_cancelled", "Remote service request cancelled"));
-      }
-      return;
-    }
-    if (!isCallMessage(decoded, codec)) return;
-    const message = decoded;
-    if (message.protocolVersion !== codec.protocolVersion) {
-      sendError(message, new RemoteServiceError("protocol_mismatch", "Remote service protocol version mismatch"));
-      return;
-    }
-    if (revoked) {
-      sendError(message, new RemoteServiceError("service_revoked", "Remote service Provider has been revoked"));
-      return;
-    }
-    const reference = services.find((candidate) => candidate.status === "ready" && candidate.capabilityId === message.capabilityId && candidate.contractVersion === message.contractVersion && candidate.serviceInstanceId === message.serviceInstanceId);
-    if (!reference) {
-      sendError(message, new RemoteServiceError("service_stale", "Remote service instance is stale or unavailable"));
-      return;
-    }
-    if (pending.has(message.callId)) {
-      sendError(message, new RemoteServiceError("handler_failed", "Remote service callId is duplicated"));
-      return;
-    }
-    const controller = new AbortController();
-    const currentBindingKey = bindingKey(reference);
-    const currentBinding = bindings.get(currentBindingKey);
-    if (!currentBinding || currentBinding.reference !== reference) {
-      sendError(message, new RemoteServiceError("service_stale", "Remote service binding changed"));
-      return;
-    }
-    const call = {
-      message,
-      controller,
-      serviceInstanceId: message.serviceInstanceId,
-      bindingKey: currentBindingKey,
-      bindingEpoch: currentBinding.epoch
-    };
-    pending.set(message.callId, call);
-    void (async () => {
-      try {
-        const result = await options.handleCall({ message, reference, signal: controller.signal });
-        if (controller.signal.aborted || !isCurrent(message.callId, call)) return;
-        const response = {
-          type: codec.type("result"),
-          protocolVersion: codec.protocolVersion,
-          callId: message.callId,
-          serviceInstanceId: message.serviceInstanceId,
-          result
-        };
-        postBestEffort(options.port, codec.encode(response));
-      } catch (error) {
-        if (controller.signal.aborted || !isCurrent(message.callId, call)) return;
-        sendError(message, error);
-      } finally {
-        if (pending.get(message.callId) === call) pending.delete(message.callId);
-      }
-    })();
-  };
-  options.port.addEventListener("message", onMessage);
-  options.port.start();
-  const provider = {
-    setServices(nextServices) {
-      if (disposed) return;
-      const next = [...nextServices];
-      const nextBindings = buildBindings(next);
-      revoked = true;
-      revokeReplacedCalls(nextBindings);
-      services = next;
-      bindings = nextBindings;
-      revoked = false;
-    },
-    revoke(reason = "Remote service Provider revoked") {
-      if (disposed) return;
-      revoked = true;
-      for (const call of pending.values()) {
-        sendError(call.message, new RemoteServiceError("service_revoked", reason));
-        call.controller.abort(new RemoteServiceError("service_revoked", reason));
-      }
-      services = [];
-      bindings = /* @__PURE__ */ new Map();
-    },
-    dispose() {
-      if (disposed) return;
-      disposed = true;
-      revoked = true;
-      options.port.removeEventListener("message", onMessage);
-      for (const { controller } of pending.values()) {
-        controller.abort(new RemoteServiceError("transport_unavailable", "Remote service Provider disposed"));
-      }
-      pending.clear();
-      services = [];
-      bindings = /* @__PURE__ */ new Map();
-      if (options.closeOnDispose !== false) {
-        try {
-          options.port.close();
-        } catch {
-        }
-      }
-    }
-  };
-  return provider;
-}
-
-// src/runtime/sharedWorkerHost.ts
-function makeRuntimeInstanceId2(runtimeId) {
-  try {
-    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
-      return `${runtimeId}:${crypto.randomUUID()}`;
-    }
-  } catch {
-  }
-  return `${runtimeId}:${Date.now().toString(36)}:${Math.random().toString(36).slice(2)}`;
-}
-function errorMessage3(error) {
-  return error instanceof Error ? error.message : String(error);
-}
-function startupDetails(error) {
-  if (error instanceof StartupPluginError) {
-    return { pluginId: error.details.pluginId, unitId: error.details.unitId, message: error.details.error ?? error.message };
-  }
-  if (error instanceof RuntimeInitializationError) {
-    return { pluginId: error.details.pluginId, unitId: error.details.unitId, message: error.message };
-  }
-  return { message: errorMessage3(error) };
-}
-function addPortListener(port, listener) {
-  port.addEventListener("message", listener);
-  return () => port.removeEventListener("message", listener);
-}
-function post(port, message) {
-  try {
-    port.postMessage(message);
-  } catch {
-  }
-}
-function startSharedWorkerApp(options) {
-  if (!options || typeof options.id !== "string" || options.id.trim() === "") {
-    throw new Error("SharedWorker runtime id must be a non-empty string");
-  }
-  const workerScope = options.globalScope ?? ("onconnect" in globalThis ? globalThis : void 0);
-  if (!workerScope) {
-    throw new RuntimeInitializationError({
-      phase: "validate",
-      error: "startSharedWorkerApp must run in a SharedWorkerGlobalScope"
-    });
-  }
-  const runtimeId = options.id;
-  const runtimeInstanceId = makeRuntimeInstanceId2(runtimeId);
-  const listeners = /* @__PURE__ */ new Set();
-  const endpoints = /* @__PURE__ */ new Set();
-  const codec = createRuntimeMessageCodec();
-  let runtimeState = "starting";
-  let revision = 0;
-  let host;
-  let manifests = [];
-  let disposed = false;
-  let acceptingConnections = true;
-  let disposePromise;
-  let startupError;
-  const serviceReferences = () => {
-    if (!host || runtimeState !== "ready") return [];
-    const services = [];
-    for (const manifest of manifests) {
-      const state = host.state(manifest.id);
-      const unit = manifest.units?.find((candidate) => candidate.id === state.unitId) ?? manifest.units?.[0];
-      if (!unit || unit.runtime === void 0 || !state.instanceId || state.kind !== "enabled") continue;
-      const scope = host.scope(manifest.id);
-      const attributes = Object.freeze({ ...scope?.identity.attributes ?? {} });
-      for (const capability of unit.provides ?? []) {
-        services.push({
-          capabilityId: capability,
-          contractVersion: unit.providedContracts?.[capability] ?? `${capability}.v1`,
-          runtime: unit.runtime,
-          runtimeInstanceId,
-          serviceInstanceId: state.instanceId,
-          status: "ready",
-          attributes
-        });
-      }
-    }
-    return services;
-  };
-  const currentSnapshot = () => Object.freeze({
-    runtimeId,
-    runtimeKind: "shared-worker",
-    runtimeInstanceId,
-    state: runtimeState,
-    revision,
-    units: Object.freeze(host && runtimeState !== "failed" ? manifests.flatMap((manifest) => {
-      const state = host?.state(manifest.id);
-      return (state?.units ?? []).map((unit) => ({
-        pluginId: unit.pluginId,
-        unitId: unit.unitId,
-        runtime: unit.runtime,
-        ...unit.instanceId !== void 0 ? { instanceId: unit.instanceId } : {},
-        state: unit.kind
-      }));
-    }) : []),
-    services: Object.freeze(serviceReferences())
-  });
-  const emit = () => {
-    const snapshot = currentSnapshot();
-    for (const listener of [...listeners]) {
-      try {
-        listener(snapshot);
-      } catch {
-      }
-    }
-  };
-  const runtimeSnapshot = () => ({
-    type: RUNTIME_SNAPSHOT_TYPE,
-    protocolVersion: RUNTIME_PROTOCOL_VERSION,
-    runtimeId,
-    runtimeKind: "shared-worker",
-    runtimeInstanceId,
-    revision,
-    state: runtimeState,
-    units: currentSnapshot().units,
-    services: serviceReferences()
-  });
-  const publishEndpoint = (endpoint) => {
-    if (endpoint.closed) return;
-    endpoint.provider.setServices(serviceReferences());
-    post(endpoint.port, codec.encode(runtimeSnapshot()));
-  };
-  const publishAll = () => {
-    for (const endpoint of [...endpoints]) publishEndpoint(endpoint);
-  };
-  const closeEndpoint = (endpoint, _reason) => {
-    if (endpoint.closed) return;
-    endpoint.closed = true;
-    endpoints.delete(endpoint);
-    endpoint.removeMessage();
-    endpoint.provider.dispose();
-  };
-  const sendError = (port, code, message, details = {}) => {
-    const error = {
-      type: RUNTIME_ERROR_TYPE,
-      protocolVersion: RUNTIME_PROTOCOL_VERSION,
-      code,
-      message,
-      ...details.pluginId !== void 0 ? { pluginId: details.pluginId } : {},
-      ...details.unitId !== void 0 ? { unitId: details.unitId } : {},
-      ...details.phase !== void 0 ? { phase: details.phase } : {}
-    };
-    post(port, error);
-  };
-  const isAcceptingConnections = () => acceptingConnections && runtimeState !== "stopping" && runtimeState !== "disposed" && !disposed;
-  const rejectLateConnection = (port) => {
-    post(port, codec.encode(runtimeSnapshot()));
-    setTimeout(() => {
-      try {
-        port.close();
-      } catch {
-      }
-    }, 0);
-  };
-  const handleCall = async (input) => {
-    if (!host || runtimeState !== "ready") throw new Error("SharedWorker Runtime is not ready");
-    const { message, reference } = input;
-    if (reference.runtimeInstanceId !== runtimeInstanceId || reference.runtime !== "shared-worker" || reference.status !== "ready") {
-      throw new Error("Runtime service reference is stale");
-    }
-    const manifest = manifests.find((candidate) => host?.state(candidate.id).instanceId === reference.serviceInstanceId);
-    if (!manifest) throw new Error("Runtime service provider is no longer active");
-    const state = host.state(manifest.id);
-    if (state.kind !== "enabled" || state.instanceId !== reference.serviceInstanceId) {
-      throw new Error("Runtime service provider is no longer active");
-    }
-    const unit = manifest.units?.find((candidate) => candidate.id === state.unitId);
-    if (!unit || unit.runtime !== "shared-worker" || !unit.provides?.includes(reference.capabilityId)) {
-      throw new Error("Runtime capability is not declared");
-    }
-    const expectedVersion = unit.providedContracts?.[reference.capabilityId] ?? `${reference.capabilityId}.v1`;
-    if (expectedVersion !== reference.contractVersion) throw new Error("Runtime capability contract mismatch");
-    const value = host.capabilities.get(reference.capabilityId);
-    if (input.signal.aborted) throw input.signal.reason ?? new Error("Runtime service request cancelled");
-    const request = message.request;
-    if (typeof value === "function") return await value(request, input.signal);
-    if (value && typeof value === "object") {
-      const object = value;
-      if (typeof object.handle === "function") return await object.handle(request, input.signal);
-      if (request && typeof request === "object" && typeof request.method === "string") {
-        const method = request.method;
-        const methodValue = object[method];
-        if (typeof methodValue === "function") {
-          const args = request.args;
-          return await methodValue(...Array.isArray(args) ? args : []);
-        }
-      }
-    }
-    throw new Error(`Runtime capability "${reference.capabilityId}" does not expose an RPC handler`);
-  };
-  const attachPort = (port) => {
-    let endpoint;
-    let removeMessage = () => void 0;
-    const onMessageError = () => {
-      if (endpoint) closeEndpoint(endpoint);
-    };
-    endpoint = {
-      port,
-      provider: void 0,
-      removeMessage: () => void 0,
-      closed: false
-    };
-    endpoint.provider = createMessagePortServiceProvider({
-      port,
-      codec,
-      services: serviceReferences,
-      handleCall
-    });
-    endpoints.add(endpoint);
-    const onMessage = (event) => {
-    };
-    removeMessage = addPortListener(port, onMessage);
-    endpoint.removeMessage = () => {
-      removeMessage();
-      port.removeEventListener("messageerror", onMessageError);
-    };
-    port.addEventListener("messageerror", onMessageError);
-    port.start();
-    publishEndpoint(endpoint);
-  };
-  workerScope.onconnect = (event) => {
-    const ports = event.ports ?? [];
-    if (!isAcceptingConnections()) {
-      for (const port of ports) rejectLateConnection(port);
-      return;
-    }
-    try {
-      options.onPortConnect?.(event);
-    } catch (error) {
-      const detail = startupDetails(error);
-      for (const port of ports) {
-        sendError(port, "runtime_initialization_failed", detail.message, {
-          pluginId: detail.pluginId,
-          unitId: detail.unitId,
-          phase: "startup"
-        });
-        try {
-          port.close();
-        } catch {
-        }
-      }
-      return;
-    }
-    if (!isAcceptingConnections()) {
-      for (const port of ports) rejectLateConnection(port);
-      return;
-    }
-    for (const port of ports) attachPort(port);
-  };
-  let materialized = [];
-  let readyPromise;
-  try {
-    materialized = materializePluginDefinitions(options.plugins, "shared-worker");
-    manifests = materialized.map((item) => item.manifest);
-    const implementations = createRuntimeUnitImplementationRegistry(materialized.map((item) => ({
-      pluginId: item.manifest.id,
-      unitId: item.unitId,
-      setup: item.setup
-    })));
-    const { id: _id, plugins: _plugins, globalScope: _scope, onPortConnect: _onPortConnect, ...hostOptions } = options;
-    host = createPluginHost({
-      ...hostOptions,
-      runtime: "shared-worker",
-      rootAttributes: { ...hostOptions.rootAttributes ?? {}, runtimeId, runtimeInstanceId },
-      runtimeUnitImplementationRegistry: implementations
-    });
-    host.subscribe(() => {
-      if (runtimeState !== "ready" || disposed) return;
-      revision += 1;
-      publishAll();
-      emit();
-    });
-    readyPromise = host.registerAll(manifests).then(() => {
-      if (runtimeState === "stopping" || disposed) return;
-      const runtimeHost = host;
-      if (!runtimeHost) throw new Error("SharedWorker Plugin Host is unavailable");
-      const failedRequired = manifests.find((manifest) => {
-        const required = manifest.meta.startup === "required" || manifest.meta.canDisable === false;
-        return required && runtimeHost.state(manifest.id).kind !== "enabled";
-      });
-      if (failedRequired) {
-        const state = runtimeHost.state(failedRequired.id);
-        throw new StartupPluginError({
-          pluginId: failedRequired.id,
-          unitId: state.unitId ?? failedRequired.units?.[0]?.id ?? failedRequired.id,
-          capabilities: [],
-          state: state.kind,
-          error: state.error ?? `Required plugin is ${state.kind}`
-        });
-      }
-      runtimeState = "ready";
-      revision = Math.max(1, revision + 1);
-      publishAll();
-      emit();
-    }).catch((error) => {
-      if (runtimeState === "stopping" || disposed) return;
-      startupError = error;
-      runtimeState = "failed";
-      emit();
-      const detail = startupDetails(error);
-      for (const endpoint of [...endpoints]) {
-        sendError(endpoint.port, "runtime_initialization_failed", detail.message, {
-          pluginId: detail.pluginId,
-          unitId: detail.unitId,
-          phase: "startup"
-        });
-        closeEndpoint(endpoint, "Runtime initialization failed");
-      }
-      throw new RuntimeInitializationError({
-        pluginId: detail.pluginId,
-        unitId: detail.unitId,
-        phase: "startup",
-        error: detail.message
-      });
-    });
-  } catch (error) {
-    startupError = error;
-    runtimeState = "failed";
-    emit();
-    readyPromise = Promise.reject(error instanceof RuntimeInitializationError ? error : new RuntimeInitializationError({ phase: "validate", error: errorMessage3(error) }));
-    void readyPromise.catch(() => void 0);
-  }
-  const app = {
-    runtimeKind: "shared-worker",
-    runtimeId,
-    runtimeInstanceId,
-    ready: () => readyPromise,
-    async reconcile() {
-      if (!host) {
-        await readyPromise;
-        return;
-      }
-      if (runtimeState === "failed" || runtimeState === "stopping" || runtimeState === "disposed" || disposed) {
-        await readyPromise;
-        return;
-      }
-      await host.reconcile();
-    },
-    state: currentSnapshot,
-    subscribe(listener) {
-      listeners.add(listener);
-      listener(currentSnapshot());
-      return () => listeners.delete(listener);
-    },
-    dispose(reason = "shared worker runtime disposed") {
-      if (disposePromise) return disposePromise;
-      acceptingConnections = false;
-      runtimeState = "stopping";
-      revision += 1;
-      publishAll();
-      emit();
-      disposePromise = (async () => {
-        let result;
-        let failure;
-        try {
-          result = host ? await host.dispose(reason) : { scopeId: `runtime:${runtimeInstanceId}`, state: "stopped", attempted: 0, released: 0, pending: [], errors: [], cleanupIncomplete: false };
-        } catch (error) {
-          failure = error;
-          result = {
-            scopeId: `runtime:${runtimeInstanceId}`,
-            state: "stopped",
-            attempted: 0,
-            released: 0,
-            pending: [],
-            errors: [{ resourceId: "runtime.dispose", code: "lifecycle.cleanup_failed", message: errorMessage3(error) }],
-            cleanupIncomplete: true
-          };
-        }
-        runtimeState = "disposed";
-        revision += 1;
-        publishAll();
-        emit();
-        disposed = true;
-        for (const endpoint of [...endpoints]) closeEndpoint(endpoint);
-        if (failure) throw failure;
-        return result;
-      })();
-      return disposePromise;
-    }
-  };
-  return app;
-}
-
-// src/lifecycle/permissionVerifier.ts
-function verifyPermissionLease(options) {
-  options.lease.assert(options.permission);
-  if (options.binding) options.lease.assertBinding(options.binding);
-}
-
-// src/lifecycle/scopedRegistry.ts
-function definitionId(value) {
-  if (!value || typeof value !== "object") return void 0;
-  const id = value.id;
-  return typeof id === "string" && id.length > 0 ? id : void 0;
-}
-function defaultRegistrationRules() {
-  return [{ method: "register", idArgument: 0, unregisterMethod: "unregister" }];
-}
-function createScopedRegistryFacade(target, scope, options) {
-  const rules = options.registrations ?? defaultRegistrationRules();
-  const byMethod = new Map(rules.map((rule) => [rule.method, rule]));
-  const unregisterMethods = new Set(
-    rules.map((rule) => rule.unregisterMethod).filter((method) => Boolean(method))
-  );
-  const ownedRegistrations = /* @__PURE__ */ new Set();
-  const objectTarget = target;
-  const remember = (rule, id, result, args) => {
-    const unregisterMethod = rule.unregisterMethod;
-    if (typeof result !== "function" && (!unregisterMethod || id === void 0)) return result;
-    const key = rule.method + ":" + (id ?? "returned");
-    let active = true;
-    let removeScopeRevoke = () => void 0;
-    let removeScopeCleanup = () => void 0;
-    const entry = {};
-    const clearOwnership = (removeDispose = true) => {
-      if (!active) return false;
-      active = false;
-      ownedRegistrations.delete(entry);
-      removeScopeRevoke();
-      if (removeDispose) removeScopeCleanup();
-      return true;
-    };
-    const invokeUnregister = (...offArgs) => {
-      if (typeof result === "function") {
-        return result.apply(target, offArgs);
-      }
-      const unregister = objectTarget[unregisterMethod];
-      if (typeof unregister !== "function") return void 0;
-      const unregisterArgument = rule.unregisterArgument ?? rule.idArgument ?? 0;
-      const unregisterArgs = [...args];
-      unregisterArgs[unregisterArgument] = id;
-      return unregister.apply(target, unregisterArgs);
-    };
-    const cleanup = async (_reason) => {
-      if (!active) {
-        if (entry.revokedCleanup) await entry.revokedCleanup;
-        return;
-      }
-      if (!clearOwnership()) return;
-      await invokeUnregister();
-    };
-    const revokeNow = (_reason) => {
-      if (!clearOwnership(false)) return;
-      try {
-        const pending = invokeUnregister();
-        if (pending && typeof pending.then === "function") {
-          const revokedCleanup = Promise.resolve(pending).then(() => void 0);
-          entry.revokedCleanup = revokedCleanup;
-          revokedCleanup.catch(() => void 0);
-        }
-      } catch (error) {
-        entry.revokedCleanup = Promise.reject(error);
-        entry.revokedCleanup.catch(() => void 0);
-      }
-    };
-    entry.id = id;
-    entry.unregisterMethod = unregisterMethod;
-    entry.revokeNow = revokeNow;
-    Object.defineProperty(entry, "active", {
-      enumerable: true,
-      configurable: false,
-      get: () => active,
-      set: (value) => {
-        active = value;
-      }
-    });
-    entry.removeScopeCleanup = removeScopeCleanup;
-    ownedRegistrations.add(entry);
-    removeScopeCleanup = scope.onDispose(
-      cleanup,
-      options.name + ":" + key,
-      "after-teardown"
-    );
-    entry.removeScopeCleanup = removeScopeCleanup;
-    removeScopeRevoke = scope.onRevoke(revokeNow);
-    if (typeof result === "function") {
-      return (...offArgs) => {
-        if (!clearOwnership()) return void 0;
-        return result.apply(target, offArgs);
-      };
-    }
-    return result;
-  };
-  return new Proxy(target, {
-    get(current, property, receiver) {
-      const value = Reflect.get(current, property, receiver);
-      if (typeof value !== "function") return value;
-      const rule = typeof property === "string" ? byMethod.get(property) : void 0;
-      if (rule) {
-        return (...args) => {
-          scope.assertActive();
-          const callArgs = [...args];
-          if (rule.bindPluginIdArgument !== void 0 && scope.identity.pluginId) {
-            const claimedPluginId = callArgs[rule.bindPluginIdArgument];
-            if (claimedPluginId !== void 0 && claimedPluginId !== scope.identity.pluginId) {
-              throw new Error(
-                'Registry owner "' + String(claimedPluginId) + '" does not match plugin instance "' + scope.identity.pluginId + '"'
-              );
-            }
-            callArgs[rule.bindPluginIdArgument] = scope.identity.pluginId;
-          }
-          if (rule.ownerPluginIdProperty && scope.identity.pluginId) {
-            const definition = callArgs[rule.idArgument ?? 0];
-            if (definition && typeof definition === "object") {
-              const claimedPluginId = definition[rule.ownerPluginIdProperty];
-              if (claimedPluginId !== void 0 && claimedPluginId !== scope.identity.pluginId) {
-                throw new Error(
-                  'Registry owner "' + String(claimedPluginId) + '" does not match plugin instance "' + scope.identity.pluginId + '"'
-                );
-              }
-            }
-          }
-          const result = value.apply(target, callArgs);
-          const id = rule.idArgument === void 0 ? void 0 : definitionId(callArgs[rule.idArgument]);
-          return remember(rule, id, result, callArgs);
-        };
-      }
-      if (typeof property === "string" && unregisterMethods.has(property)) {
-        return (...args) => {
-          scope.assertActive();
-          const id = definitionId(args[0]) ?? (typeof args[0] === "string" ? args[0] : void 0);
-          const owned = [...ownedRegistrations].find(
-            (entry) => entry.active && entry.id === id && entry.unregisterMethod === property
-          );
-          if (!owned) {
-            throw new Error(
-              'Registry resource "' + (id ?? "unknown") + '" is not owned by this plugin instance'
-            );
-          }
-          const result = value.apply(target, args);
-          owned.active = false;
-          ownedRegistrations.delete(owned);
-          owned.removeScopeCleanup();
-          return result;
-        };
-      }
-      return value.bind(target);
-    }
-  });
-}
-
-// src/lifecycle/upgradeGate.ts
-function validGeneration(value) {
-  return Number.isSafeInteger(value) && value >= 0;
-}
-function uniqueStrings(values) {
-  return [...new Set(values.filter((value) => typeof value === "string" && value.length > 0))];
-}
-function makeSessionId() {
-  try {
-    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
-      return `upgrade-session:${crypto.randomUUID()}`;
-    }
-  } catch {
-  }
-  return `upgrade-session:${Date.now().toString(36)}:${Math.random().toString(36).slice(2)}`;
-}
-function buildIsCompatible(options, buildId) {
-  try {
-    if (options.isBuildCompatible) return options.isBuildCompatible(buildId);
-  } catch {
-    return false;
-  }
-  return buildId === options.buildId || options.compatibleBuildIds?.has(buildId) === true;
-}
-function createUpgradeGate(options) {
-  if (!options.protocolVersion || !options.buildId || !options.authorityInstanceId) {
-    throw new Error("\u5347\u7EA7\u95E8\u7981\u7684 protocolVersion\u3001buildId \u548C authorityInstanceId \u5FC5\u987B\u6709\u6548");
-  }
-  if (!validGeneration(options.handoverGeneration)) {
-    throw new Error("\u5347\u7EA7\u95E8\u7981\u7684 handoverGeneration \u5FC5\u987B\u662F\u975E\u8D1F\u5B89\u5168\u6574\u6570");
-  }
-  const contractVersions = uniqueStrings(options.supportedContractVersions);
-  if (contractVersions.length === 0) {
-    throw new Error("\u5347\u7EA7\u95E8\u7981\u81F3\u5C11\u9700\u8981\u4E00\u4E2A supportedContractVersions");
-  }
-  let currentState = "active";
-  let closeReason = "upgrade gate closed";
-  const leases = /* @__PURE__ */ new Set();
-  const sessions = /* @__PURE__ */ new Set();
-  const sessionByObject = /* @__PURE__ */ new WeakMap();
-  const emptyWaiters = /* @__PURE__ */ new Set();
-  const notifyEmpty = () => {
-    if (leases.size !== 0) return;
-    for (const resolve of [...emptyWaiters]) {
-      emptyWaiters.delete(resolve);
-      resolve();
-    }
-  };
-  const removeLease = (record) => {
-    if (!leases.delete(record)) return;
-    record.session.leases.delete(record);
-    record.removeExternalAbort?.();
-    record.removeExternalAbort = void 0;
-    notifyEmpty();
-  };
-  const revokeSession = (record, reason) => {
-    if (record.revoked) return;
-    record.revoked = true;
-    record.reason = reason;
-    try {
-      record.controller.abort(new UpgradeGateRejectedError(reason));
-    } catch {
-      record.controller.abort();
-    }
-    for (const lease of [...record.leases]) revokeLease(lease, reason);
-    sessions.delete(record);
-  };
-  const revokeLease = (record, reason) => {
-    if (record.revoked) return;
-    record.revoked = true;
-    record.reason = reason;
-    try {
-      record.controller.abort(new UpgradeGateRejectedError(reason));
-    } catch {
-      record.controller.abort();
-    }
-    removeLease(record);
-  };
-  const assertAccepting = () => {
-    if (currentState === "active") return;
-    throw new UpgradeGateRejectedError(currentState === "draining" ? "draining" : "closed", closeReason);
-  };
-  const handshake = (input) => {
-    if (currentState !== "active") {
-      return { accepted: false, reason: currentState === "draining" ? "draining" : "closed" };
-    }
-    if (typeof input.connectionId !== "string" || input.connectionId.length === 0 || input.protocolVersion !== options.protocolVersion || typeof input.protocolVersion !== "string" || typeof input.buildId !== "string" || typeof input.authorityInstanceId !== "string" || input.authorityInstanceId.length === 0) {
-      return { accepted: false, reason: "protocol-mismatch" };
-    }
-    if (!buildIsCompatible(options, input.buildId)) {
-      return { accepted: false, reason: "build-incompatible" };
-    }
-    if (!validGeneration(input.handoverGeneration)) {
-      return { accepted: false, reason: "stale-generation" };
-    }
-    if (input.handoverGeneration < options.handoverGeneration) {
-      return { accepted: false, reason: "stale-generation" };
-    }
-    if (input.handoverGeneration > options.handoverGeneration) {
-      return { accepted: false, reason: "future-generation" };
-    }
-    const contractVersion = contractVersions.find((version) => input.supportedContractVersions.includes(version));
-    if (!contractVersion) return { accepted: false, reason: "contract-mismatch" };
-    const sessionRecord = {
-      sessionId: makeSessionId(),
-      connectionId: input.connectionId,
-      contractVersion,
-      controller: new AbortController(),
-      revoked: false,
-      reason: "upgrade session closed",
-      leases: /* @__PURE__ */ new Set()
-    };
-    const session = {
-      connectionId: sessionRecord.connectionId,
-      sessionId: sessionRecord.sessionId,
-      authorityInstanceId: options.authorityInstanceId,
-      handoverGeneration: options.handoverGeneration,
-      contractVersion,
-      get revoked() {
-        return sessionRecord.revoked || !sessions.has(sessionRecord);
-      },
-      signal: sessionRecord.controller.signal,
-      assertActive() {
-        if (sessionRecord.revoked || !sessions.has(sessionRecord)) {
-          throw new UpgradeGateRejectedError(sessionRecord.reason, "\u5347\u7EA7\u63E1\u624B\u4F1A\u8BDD\u5DF2\u5931\u6548");
-        }
-        if (currentState === "closed") {
-          throw new UpgradeGateRejectedError("closed", closeReason);
-        }
-      },
-      admit(input2) {
-        return admitForSession(sessionRecord, input2);
-      },
-      close(reason = "upgrade session closed") {
-        revokeSession(sessionRecord, reason);
-      }
-    };
-    sessionRecord.session = session;
-    sessions.add(sessionRecord);
-    sessionByObject.set(session, sessionRecord);
-    return {
-      accepted: true,
-      mode: options.mode ?? "cold-switch",
-      handoverGeneration: options.handoverGeneration,
-      contractVersion,
-      connectionId: sessionRecord.connectionId,
-      sessionId: sessionRecord.sessionId,
-      session
-    };
-  };
-  const admitForSession = (sessionRecord, input) => {
-    if (sessionRecord.revoked || !sessions.has(sessionRecord)) {
-      throw new UpgradeGateRejectedError(sessionRecord.reason, "\u5347\u7EA7\u63E1\u624B\u4F1A\u8BDD\u5DF2\u5931\u6548");
-    }
-    assertAccepting();
-    if (input.signal?.aborted) {
-      throw new UpgradeGateRejectedError("caller-aborted", "I/O \u5728\u53D6\u5F97\u63A5\u7BA1\u79DF\u7EA6\u524D\u5DF2\u53D6\u6D88");
-    }
-    const record = {
-      session: sessionRecord,
-      operation: input.operation,
-      controller: new AbortController(),
-      revoked: false,
-      reason: "upgrade I/O lease released"
-    };
-    leases.add(record);
-    sessionRecord.leases.add(record);
-    if (input.signal) {
-      const onAbort = () => revokeLease(record, "caller-aborted");
-      input.signal.addEventListener("abort", onAbort, { once: true });
-      record.removeExternalAbort = () => input.signal?.removeEventListener("abort", onAbort);
-    }
-    const lease = {
-      connectionId: sessionRecord.connectionId,
-      sessionId: sessionRecord.sessionId,
-      authorityInstanceId: options.authorityInstanceId,
-      handoverGeneration: options.handoverGeneration,
-      contractVersion: sessionRecord.contractVersion,
-      operation: record.operation,
-      get revoked() {
-        return record.revoked || !leases.has(record);
-      },
-      signal: record.controller.signal,
-      assertActive() {
-        if (record.revoked || !leases.has(record)) {
-          throw new UpgradeGateRejectedError(record.reason, "\u5347\u7EA7 I/O \u79DF\u7EA6\u5DF2\u5931\u6548");
-        }
-        if (currentState === "closed") {
-          throw new UpgradeGateRejectedError("closed", closeReason);
-        }
-      },
-      release() {
-        if (record.revoked) return;
-        record.revoked = true;
-        record.reason = "upgrade I/O lease released";
-        removeLease(record);
-      }
-    };
-    return lease;
-  };
-  const admit = (input) => {
-    const sessionRecord = sessionByObject.get(input.session);
-    if (!sessionRecord) {
-      throw new UpgradeGateRejectedError("invalid-session", "I/O \u5FC5\u987B\u4F7F\u7528\u5F53\u524D\u95E8\u7981\u63E1\u624B\u8FD4\u56DE\u7684\u4F1A\u8BDD");
-    }
-    return admitForSession(sessionRecord, input);
-  };
-  const beginDrain = (reason = "upgrade handover draining") => {
-    if (currentState !== "active") return;
-    closeReason = reason;
-    currentState = "draining";
-  };
-  const drain = async (timeoutMs) => {
-    beginDrain();
-    if (leases.size === 0) return { state: currentState, drained: true, pending: 0 };
-    if (timeoutMs !== void 0 && (!Number.isFinite(timeoutMs) || timeoutMs < 0)) {
-      throw new Error("\u5347\u7EA7\u6392\u7A7A timeoutMs \u5FC5\u987B\u662F\u975E\u8D1F\u6709\u9650\u6570");
-    }
-    let timeout;
-    let timerResolve;
-    const empty = new Promise((resolve) => {
-      emptyWaiters.add(resolve);
-      timerResolve = resolve;
-    });
-    const timeoutPromise = timeoutMs === void 0 ? void 0 : new Promise((resolve) => {
-      timeout = setTimeout(resolve, timeoutMs);
-    });
-    if (timeoutPromise) await Promise.race([empty, timeoutPromise]);
-    else await empty;
-    if (timeout !== void 0) clearTimeout(timeout);
-    if (timerResolve) emptyWaiters.delete(timerResolve);
-    const pending = leases.size;
-    return { state: currentState, drained: pending === 0, pending };
-  };
-  const close = (reason = "upgrade gate closed") => {
-    if (currentState === "closed") return;
-    closeReason = reason;
-    currentState = "closed";
-    for (const session of [...sessions]) revokeSession(session, reason);
-    for (const lease of [...leases]) revokeLease(lease, reason);
-    notifyEmpty();
-  };
-  return {
-    get state() {
-      return currentState;
-    },
-    mode: options.mode ?? "cold-switch",
-    authorityInstanceId: options.authorityInstanceId,
-    handoverGeneration: options.handoverGeneration,
-    handshake,
-    assertAccepting,
-    admit,
-    beginDrain,
-    drain,
-    close,
-    activeIo: () => leases.size
-  };
-}
-
-export { createMessagePortServiceProvider, createScopedRegistryFacade, createUpgradeGate, createWindowApp, definePlugin, defineRuntimeUnitDependencies, defineRuntimeUnitProvidedContracts, materializePluginDefinition, materializePluginDefinitions, runtimeCapabilityContractVersion, startSharedWorkerApp, verifyPermissionLease };
+export { RUNTIME_MESSAGE_BUS, definePlugin };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map