catalyst-core 0.2.0-beta.3 → 0.3.0-beta.2

package/dist/native/internalPluginUtils.js

@@ -1,7 +1,232 @@
-"use strict";const fs=require("fs");const path=require("path");function isDir(dirPath){return fs.existsSync(dirPath)&&fs.statSync(dirPath).isDirectory();}function mustBeNonEmptyString(value,fieldName,sourcePath){if(typeof value!=="string"||!value.trim()){throw new Error(`Invalid '${fieldName}' in ${sourcePath}`);}return value.trim();}function readStringArray(value,fieldName,sourcePath,{required=false,nonEmpty=false}={}){if(!Array.isArray(value)){if(required){throw new Error(`'${fieldName}' is required and must be an array in ${sourcePath}`);}return[];}const result=value.map(entry=>mustBeNonEmptyString(entry,`${fieldName}[]`,sourcePath));if(nonEmpty&&result.length===0){throw new Error(`'${fieldName}' is required and must be non-empty in ${sourcePath}`);}return result;}function readPlainObject(value,fieldName,sourcePath){if(value==null){return{};}if(!value||typeof value!=="object"||Array.isArray(value)){throw new Error(`'${fieldName}' must be an object in ${sourcePath}`);}return value;}function cloneJsonValue(value,fieldName,sourcePath){try{return JSON.parse(JSON.stringify(value));}catch(error){throw new Error(`'${fieldName}' must be JSON-serializable in ${sourcePath}`);}}function readIosUrlSchemes(value,fieldName,sourcePath){if(value==null){return[];}if(!Array.isArray(value)){throw new Error(`'${fieldName}' must be an array in ${sourcePath}`);}return value.map((entry,index)=>{const entryField=`${fieldName}[${index}]`;if(!entry||typeof entry!=="object"||Array.isArray(entry)){throw new Error(`'${entryField}' must be an object in ${sourcePath}`);}return{name:entry.name==null?null:mustBeNonEmptyString(entry.name,`${entryField}.name`,sourcePath),schemes:readStringArray(entry.schemes,`${entryField}.schemes`,sourcePath,{required:true,nonEmpty:true})};});}function readIosDependencies(value,fieldName,sourcePath){if(value==null){return[];}if(!Array.isArray(value)){throw new Error(`'${fieldName}' must be an array in ${sourcePath}`);}return value.map((entry,index)=>{const entryField=`${fieldName}[${index}]`;if(!entry||typeof entry!=="object"||Array.isArray(entry)){throw new Error(`'${entryField}' must be an object in ${sourcePath}`);}const url=mustBeNonEmptyString(entry.url,`${entryField}.url`,sourcePath);const packageIdentity=entry.package==null?derivePackageIdentityFromUrl(url,`${entryField}.url`,sourcePath):mustBeNonEmptyString(entry.package,`${entryField}.package`,sourcePath);const products=readStringArray(entry.products,`${entryField}.products`,sourcePath,{required:true,nonEmpty:true});if(new Set(products).size!==products.length){throw new Error(`Duplicate product(s) found in '${entryField}.products' in ${sourcePath}`);}const hasFrom=entry.from!=null;const hasExact=entry.exact!=null;if(hasFrom===hasExact){throw new Error(`'${entryField}' must define exactly one version requirement: 'from' or 'exact' in ${sourcePath}`);}return{url,package:packageIdentity,products,requirement:hasFrom?{type:"from",version:mustBeNonEmptyString(entry.from,`${entryField}.from`,sourcePath)}:{type:"exact",version:mustBeNonEmptyString(entry.exact,`${entryField}.exact`,sourcePath)}};});}function derivePackageIdentityFromUrl(url,fieldName,sourcePath){const sanitizedUrl=url.replace(/\/+$/,"");const packageIdentity=sanitizedUrl.split("/").pop()?.replace(/\.git$/,"");if(!packageIdentity){throw new Error(`Unable to derive package identity from '${fieldName}' in ${sourcePath}`);}return packageIdentity;}function parsePluginManifest(pluginDir){// nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal - pluginDir is discovered from the internal plugin root and the filename is fixed.
-const manifestPath=path.join(pluginDir,"manifest.json");if(!fs.existsSync(manifestPath)){return null;}let manifestContent;try{manifestContent=fs.readFileSync(manifestPath,"utf8");}catch(error){throw new Error(`Failed to read plugin manifest at ${manifestPath}: ${error.message}`);}let manifest;try{manifest=JSON.parse(manifestContent);}catch(error){throw new Error(`Invalid JSON in plugin manifest ${manifestPath}: ${error.message}`);}const id=mustBeNonEmptyString(manifest.id,"id",manifestPath);const configKey=mustBeNonEmptyString(manifest.configKey,"configKey",manifestPath);const platforms=readStringArray(manifest.platforms,"platforms",manifestPath,{required:true,nonEmpty:true});const androidConfig=platforms.includes("android")?manifest.android:null;const iosConfig=platforms.includes("ios")?manifest.ios:null;if(platforms.includes("android")&&(!androidConfig||typeof androidConfig!=="object")){throw new Error(`'android' config is required for plugin '${id}' in ${manifestPath}`);}if(platforms.includes("ios")&&(!iosConfig||typeof iosConfig!=="object")){throw new Error(`'ios' config is required for plugin '${id}' in ${manifestPath}`);}return{pluginDir,manifestPath,id,configKey,version:mustBeNonEmptyString(manifest.version,"version",manifestPath),displayName:mustBeNonEmptyString(manifest.displayName,"displayName",manifestPath),description:mustBeNonEmptyString(manifest.description,"description",manifestPath),category:mustBeNonEmptyString(manifest.category,"category",manifestPath),platforms,commands:readStringArray(manifest.commands,"commands",manifestPath,{required:true,nonEmpty:true}),android:androidConfig?{// nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal - pluginDir is discovered from the internal plugin root and the child directory is fixed.
-sourceDir:path.join(pluginDir,"android"),permissions:readStringArray(androidConfig.permissions,"android.permissions",manifestPath),dependencies:readStringArray(androidConfig.dependencies,"android.dependencies",manifestPath),className:mustBeNonEmptyString(androidConfig.className,"android.className",manifestPath)}:null,ios:iosConfig?{// nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal - pluginDir is discovered from the internal plugin root and the child directory is fixed.
-sourceDir:path.join(pluginDir,"ios"),dependencies:readIosDependencies(iosConfig.dependencies,"ios.dependencies",manifestPath),className:mustBeNonEmptyString(iosConfig.className,"ios.className",manifestPath),infoPlist:cloneJsonValue(readPlainObject(iosConfig.infoPlist,"ios.infoPlist",manifestPath),"ios.infoPlist",manifestPath),urlSchemes:readIosUrlSchemes(iosConfig.urlSchemes,"ios.urlSchemes",manifestPath),querySchemes:readStringArray(iosConfig.querySchemes,"ios.querySchemes",manifestPath),entitlements:cloneJsonValue(readPlainObject(iosConfig.entitlements,"ios.entitlements",manifestPath),"ios.entitlements",manifestPath),resources:readStringArray(iosConfig.resources,"ios.resources",manifestPath)}:null};}function discoverInternalPlugins(corePluginsRoot,log=()=>{}){if(!corePluginsRoot||!isDir(corePluginsRoot)){log(`No internal plugin directory found at ${corePluginsRoot||"<empty>"}`,"info");return[];}const plugins=[];const entries=fs.readdirSync(corePluginsRoot,{withFileTypes:true}).sort((left,right)=>left.name.localeCompare(right.name));for(const entry of entries){if(!entry.isDirectory()){continue;}// nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal - entry.name comes from readdirSync under the internal plugin root.
-const pluginDir=path.join(corePluginsRoot,entry.name);const parsed=parsePluginManifest(pluginDir);if(parsed){plugins.push(parsed);}}log(`Discovered ${plugins.length} internal plugin manifest(s)`,"info");return plugins;}function resolveInternalPluginsRoot(packageRoot){// nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal - These are fixed package-internal directories.
-const distPluginsPath=path.join(packageRoot,"dist","native","internal-plugins");// nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal - These are fixed package-internal directories.
-const srcPluginsPath=path.join(packageRoot,"src","native","internal-plugins");return fs.existsSync(distPluginsPath)?distPluginsPath:srcPluginsPath;}function resolvePluginConfig(WEBVIEW_CONFIG){const pluginConfig={};if(WEBVIEW_CONFIG.plugins!=null){if(typeof WEBVIEW_CONFIG.plugins!=="object"||Array.isArray(WEBVIEW_CONFIG.plugins)){throw new Error("'WEBVIEW_CONFIG.plugins' must be an object with boolean values");}for(const[key,value]of Object.entries(WEBVIEW_CONFIG.plugins)){if(typeof value!=="boolean"){throw new Error(`'WEBVIEW_CONFIG.plugins.${key}' must be boolean`);}pluginConfig[key]=value;}}return pluginConfig;}module.exports={discoverInternalPlugins,parsePluginManifest,resolvePluginConfig,resolveInternalPluginsRoot};
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+function isDir(dirPath) {
+  return fs.existsSync(dirPath) && fs.statSync(dirPath).isDirectory();
+}
+function mustBeNonEmptyString(value, fieldName, sourcePath) {
+  if (typeof value !== "string" || !value.trim()) {
+    throw new Error(`Invalid '${fieldName}' in ${sourcePath}`);
+  }
+  return value.trim();
+}
+function readStringArray(value, fieldName, sourcePath, {
+  required = false,
+  nonEmpty = false
+} = {}) {
+  if (!Array.isArray(value)) {
+    if (required) {
+      throw new Error(`'${fieldName}' is required and must be an array in ${sourcePath}`);
+    }
+    return [];
+  }
+  const result = value.map(entry => mustBeNonEmptyString(entry, `${fieldName}[]`, sourcePath));
+  if (nonEmpty && result.length === 0) {
+    throw new Error(`'${fieldName}' is required and must be non-empty in ${sourcePath}`);
+  }
+  return result;
+}
+function readPlainObject(value, fieldName, sourcePath) {
+  if (value == null) {
+    return {};
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`'${fieldName}' must be an object in ${sourcePath}`);
+  }
+  return value;
+}
+function cloneJsonValue(value, fieldName, sourcePath) {
+  try {
+    return JSON.parse(JSON.stringify(value));
+  } catch (error) {
+    throw new Error(`'${fieldName}' must be JSON-serializable in ${sourcePath}`);
+  }
+}
+function readIosUrlSchemes(value, fieldName, sourcePath) {
+  if (value == null) {
+    return [];
+  }
+  if (!Array.isArray(value)) {
+    throw new Error(`'${fieldName}' must be an array in ${sourcePath}`);
+  }
+  return value.map((entry, index) => {
+    const entryField = `${fieldName}[${index}]`;
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+      throw new Error(`'${entryField}' must be an object in ${sourcePath}`);
+    }
+    return {
+      name: entry.name == null ? null : mustBeNonEmptyString(entry.name, `${entryField}.name`, sourcePath),
+      schemes: readStringArray(entry.schemes, `${entryField}.schemes`, sourcePath, {
+        required: true,
+        nonEmpty: true
+      })
+    };
+  });
+}
+function readIosDependencies(value, fieldName, sourcePath) {
+  if (value == null) {
+    return [];
+  }
+  if (!Array.isArray(value)) {
+    throw new Error(`'${fieldName}' must be an array in ${sourcePath}`);
+  }
+  return value.map((entry, index) => {
+    const entryField = `${fieldName}[${index}]`;
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+      throw new Error(`'${entryField}' must be an object in ${sourcePath}`);
+    }
+    const url = mustBeNonEmptyString(entry.url, `${entryField}.url`, sourcePath);
+    const packageIdentity = entry.package == null ? derivePackageIdentityFromUrl(url, `${entryField}.url`, sourcePath) : mustBeNonEmptyString(entry.package, `${entryField}.package`, sourcePath);
+    const products = readStringArray(entry.products, `${entryField}.products`, sourcePath, {
+      required: true,
+      nonEmpty: true
+    });
+    if (new Set(products).size !== products.length) {
+      throw new Error(`Duplicate product(s) found in '${entryField}.products' in ${sourcePath}`);
+    }
+    const hasFrom = entry.from != null;
+    const hasExact = entry.exact != null;
+    if (hasFrom === hasExact) {
+      throw new Error(`'${entryField}' must define exactly one version requirement: 'from' or 'exact' in ${sourcePath}`);
+    }
+    return {
+      url,
+      package: packageIdentity,
+      products,
+      requirement: hasFrom ? {
+        type: "from",
+        version: mustBeNonEmptyString(entry.from, `${entryField}.from`, sourcePath)
+      } : {
+        type: "exact",
+        version: mustBeNonEmptyString(entry.exact, `${entryField}.exact`, sourcePath)
+      }
+    };
+  });
+}
+function derivePackageIdentityFromUrl(url, fieldName, sourcePath) {
+  const sanitizedUrl = url.replace(/\/+$/, "");
+  const packageIdentity = sanitizedUrl.split("/").pop()?.replace(/\.git$/, "");
+  if (!packageIdentity) {
+    throw new Error(`Unable to derive package identity from '${fieldName}' in ${sourcePath}`);
+  }
+  return packageIdentity;
+}
+function parsePluginManifest(pluginDir) {
+  // nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal - pluginDir is discovered from the internal plugin root and the filename is fixed.
+  const manifestPath = path.join(pluginDir, "manifest.json");
+  if (!fs.existsSync(manifestPath)) {
+    return null;
+  }
+  let manifestContent;
+  try {
+    manifestContent = fs.readFileSync(manifestPath, "utf8");
+  } catch (error) {
+    throw new Error(`Failed to read plugin manifest at ${manifestPath}: ${error.message}`);
+  }
+  let manifest;
+  try {
+    manifest = JSON.parse(manifestContent);
+  } catch (error) {
+    throw new Error(`Invalid JSON in plugin manifest ${manifestPath}: ${error.message}`);
+  }
+  const id = mustBeNonEmptyString(manifest.id, "id", manifestPath);
+  const configKey = mustBeNonEmptyString(manifest.configKey, "configKey", manifestPath);
+  const platforms = readStringArray(manifest.platforms, "platforms", manifestPath, {
+    required: true,
+    nonEmpty: true
+  });
+  const androidConfig = platforms.includes("android") ? manifest.android : null;
+  const iosConfig = platforms.includes("ios") ? manifest.ios : null;
+  if (platforms.includes("android") && (!androidConfig || typeof androidConfig !== "object")) {
+    throw new Error(`'android' config is required for plugin '${id}' in ${manifestPath}`);
+  }
+  if (platforms.includes("ios") && (!iosConfig || typeof iosConfig !== "object")) {
+    throw new Error(`'ios' config is required for plugin '${id}' in ${manifestPath}`);
+  }
+  return {
+    pluginDir,
+    manifestPath,
+    id,
+    configKey,
+    version: mustBeNonEmptyString(manifest.version, "version", manifestPath),
+    displayName: mustBeNonEmptyString(manifest.displayName, "displayName", manifestPath),
+    description: mustBeNonEmptyString(manifest.description, "description", manifestPath),
+    category: mustBeNonEmptyString(manifest.category, "category", manifestPath),
+    platforms,
+    commands: readStringArray(manifest.commands, "commands", manifestPath, {
+      required: true,
+      nonEmpty: true
+    }),
+    android: androidConfig ? {
+      // nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal - pluginDir is discovered from the internal plugin root and the child directory is fixed.
+      sourceDir: path.join(pluginDir, "android"),
+      permissions: readStringArray(androidConfig.permissions, "android.permissions", manifestPath),
+      dependencies: readStringArray(androidConfig.dependencies, "android.dependencies", manifestPath),
+      className: mustBeNonEmptyString(androidConfig.className, "android.className", manifestPath)
+    } : null,
+    ios: iosConfig ? {
+      // nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal - pluginDir is discovered from the internal plugin root and the child directory is fixed.
+      sourceDir: path.join(pluginDir, "ios"),
+      dependencies: readIosDependencies(iosConfig.dependencies, "ios.dependencies", manifestPath),
+      className: mustBeNonEmptyString(iosConfig.className, "ios.className", manifestPath),
+      infoPlist: cloneJsonValue(readPlainObject(iosConfig.infoPlist, "ios.infoPlist", manifestPath), "ios.infoPlist", manifestPath),
+      urlSchemes: readIosUrlSchemes(iosConfig.urlSchemes, "ios.urlSchemes", manifestPath),
+      querySchemes: readStringArray(iosConfig.querySchemes, "ios.querySchemes", manifestPath),
+      entitlements: cloneJsonValue(readPlainObject(iosConfig.entitlements, "ios.entitlements", manifestPath), "ios.entitlements", manifestPath),
+      resources: readStringArray(iosConfig.resources, "ios.resources", manifestPath)
+    } : null
+  };
+}
+function discoverInternalPlugins(corePluginsRoot, log = () => {}) {
+  if (!corePluginsRoot || !isDir(corePluginsRoot)) {
+    log(`No internal plugin directory found at ${corePluginsRoot || "<empty>"}`, "info");
+    return [];
+  }
+  const plugins = [];
+  const entries = fs.readdirSync(corePluginsRoot, {
+    withFileTypes: true
+  }).sort((left, right) => left.name.localeCompare(right.name));
+  for (const entry of entries) {
+    if (!entry.isDirectory()) {
+      continue;
+    }
+
+    // nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal - entry.name comes from readdirSync under the internal plugin root.
+    const pluginDir = path.join(corePluginsRoot, entry.name);
+    const parsed = parsePluginManifest(pluginDir);
+    if (parsed) {
+      plugins.push(parsed);
+    }
+  }
+  log(`Discovered ${plugins.length} internal plugin manifest(s)`, "info");
+  return plugins;
+}
+function resolveInternalPluginsRoot(packageRoot) {
+  // nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal - These are fixed package-internal directories.
+  const distPluginsPath = path.join(packageRoot, "dist", "native", "internal-plugins");
+  // nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal - These are fixed package-internal directories.
+  const srcPluginsPath = path.join(packageRoot, "src", "native", "internal-plugins");
+  return fs.existsSync(distPluginsPath) ? distPluginsPath : srcPluginsPath;
+}
+function resolvePluginConfig(WEBVIEW_CONFIG) {
+  const pluginConfig = {};
+  if (WEBVIEW_CONFIG.plugins != null) {
+    if (typeof WEBVIEW_CONFIG.plugins !== "object" || Array.isArray(WEBVIEW_CONFIG.plugins)) {
+      throw new Error("'WEBVIEW_CONFIG.plugins' must be an object with boolean values");
+    }
+    for (const [key, value] of Object.entries(WEBVIEW_CONFIG.plugins)) {
+      if (typeof value !== "boolean") {
+        throw new Error(`'WEBVIEW_CONFIG.plugins.${key}' must be boolean`);
+      }
+      pluginConfig[key] = value;
+    }
+  }
+  return pluginConfig;
+}
+module.exports = {
+  discoverInternalPlugins,
+  parsePluginManifest,
+  resolvePluginConfig,
+  resolveInternalPluginsRoot
+};

package/dist/native/package.json

@@ -0,0 +1,3 @@
+{
+    "type": "commonjs"
+}

package/dist/native/plugin-bridge/PluginBridge.js

@@ -1 +1,227 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.default=void 0;class PluginNativeBridge{constructor(){this.handlers=new Map();this.requestCount=0;this.isInitialized=false;}createRequestId=()=>{this.requestCount+=1;return`plugin_${Date.now()}_${this.requestCount}`;};normalizeRequiredString=(value,fieldName)=>{if(typeof value!=="string"||!value.trim()){throw new Error(`${fieldName} must be a non-empty string`);}return value.trim();};normalizeCommand=command=>{if(command==null){return null;}return this.normalizeRequiredString(command,"command");};getHandlerKey=({pluginId,eventName,command=null}={})=>{return JSON.stringify([this.normalizeRequiredString(pluginId,"pluginId"),this.normalizeRequiredString(eventName,"eventName"),this.normalizeCommand(command)]);};getHandlerSet=(key,create=false)=>{let handlers=this.handlers.get(key);if(!handlers&&create){handlers=new Set();this.handlers.set(key,handlers);}return handlers||null;};addHandler=({pluginId,eventName,command}={},handler)=>{if(typeof handler!=="function"){throw new Error("handler must be a function");}this.getHandlerSet(this.getHandlerKey({pluginId,eventName,command}),true).add(handler);};removeHandler=({pluginId,eventName,command}={},handler)=>{const key=this.getHandlerKey({pluginId,eventName,command});const handlers=this.getHandlerSet(key,false);if(!handlers){return false;}if(handler==null){handlers.clear();this.handlers.delete(key);return true;}const removed=handlers.delete(handler);if(handlers.size===0){this.handlers.delete(key);}return removed;};ensureInitialized=()=>{if(typeof window==="undefined"||this.isInitialized){return this;}window.PluginBridgeWeb=window.PluginBridgeWeb||{};window.PluginBridgeWeb.callback=this.dispatchCallback;window.PluginBridgeWeb.dispatch=message=>{let parsed=message;if(typeof parsed==="string"){try{parsed=JSON.parse(parsed);}catch{return false;}}if(!parsed||typeof parsed!=="object"){return false;}const payload=Object.prototype.hasOwnProperty.call(parsed,"payload")?parsed.payload:null;return this.dispatchCallback(parsed.pluginId,parsed.eventName,payload,parsed.requestId??null,parsed.command??null);};this.isInitialized=true;return this;};hasAndroidBridge=()=>typeof window!=="undefined"&&!!window.PluginBridge;hasIOSBridge=()=>typeof window!=="undefined"&&!!window.webkit?.messageHandlers?.PluginBridge;init=()=>this.ensureInitialized();assertInitialized=()=>{if(!this.isInitialized){throw new Error("PluginBridge.init() must be called before using emit() or register()");}};reportHandlerError=error=>{if(typeof queueMicrotask==="function"){queueMicrotask(()=>{throw error;});return;}setTimeout(()=>{throw error;},0);};emit=({pluginId,command,data=null}={})=>{const normalizedPluginId=this.normalizeRequiredString(pluginId,"pluginId");const normalizedCommand=this.normalizeRequiredString(command,"command");if(typeof window==="undefined"){throw new Error("PluginBridge is not available in this environment");}this.assertInitialized();const payload={pluginId:normalizedPluginId,command:normalizedCommand,data,requestId:this.createRequestId()};if(this.hasAndroidBridge()){window.PluginBridge.emit(JSON.stringify(payload));return;}if(this.hasIOSBridge()){window.webkit.messageHandlers.PluginBridge.postMessage(payload);return;}throw new Error("PluginBridge is not available in this environment");};register=({pluginId,eventName,command,handler}={})=>{this.assertInitialized();this.addHandler({pluginId,eventName,command},handler);return()=>this.removeHandler({pluginId,eventName,command},handler);};unregister=({pluginId,eventName,command,handler}={})=>{if(typeof handler!=="function"){throw new Error("handler must be a function");}return this.removeHandler({pluginId,eventName,command},handler);};dispatchCallback=(pluginId,eventName,payload,requestId=null,command=null)=>{void requestId;const normalizedPluginId=typeof pluginId==="string"&&pluginId.trim()?pluginId.trim():null;const normalizedEventName=typeof eventName==="string"&&eventName.trim()?eventName.trim():null;if(normalizedPluginId==null||normalizedEventName==null){return false;}const normalizedCommand=typeof command==="string"&&command.trim()?command.trim():null;const toCall=new Set();const collectHandlers=commandScope=>{const handlers=this.getHandlerSet(JSON.stringify([normalizedPluginId,normalizedEventName,commandScope]),false);if(!handlers){return;}handlers.forEach(handler=>{toCall.add(handler);});};if(normalizedCommand!=null){collectHandlers(normalizedCommand);}collectHandlers(null);if(toCall.size===0){return false;}const meta={pluginId:normalizedPluginId,eventName:normalizedEventName,command:normalizedCommand};toCall.forEach(handler=>{try{handler(payload,meta);}catch(error){this.reportHandlerError(error);}});return true;};}const pluginNativeBridge=new PluginNativeBridge();var _default=exports.default=pluginNativeBridge;
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+class PluginNativeBridge {
+  constructor() {
+    this.handlers = new Map();
+    this.requestCount = 0;
+    this.isInitialized = false;
+  }
+  createRequestId = () => {
+    this.requestCount += 1;
+    return `plugin_${Date.now()}_${this.requestCount}`;
+  };
+  normalizeRequiredString = (value, fieldName) => {
+    if (typeof value !== "string" || !value.trim()) {
+      throw new Error(`${fieldName} must be a non-empty string`);
+    }
+    return value.trim();
+  };
+  normalizeCommand = command => {
+    if (command == null) {
+      return null;
+    }
+    return this.normalizeRequiredString(command, "command");
+  };
+  getHandlerKey = ({
+    pluginId,
+    eventName,
+    command = null
+  } = {}) => {
+    return JSON.stringify([this.normalizeRequiredString(pluginId, "pluginId"), this.normalizeRequiredString(eventName, "eventName"), this.normalizeCommand(command)]);
+  };
+  getHandlerSet = (key, create = false) => {
+    let handlers = this.handlers.get(key);
+    if (!handlers && create) {
+      handlers = new Set();
+      this.handlers.set(key, handlers);
+    }
+    return handlers || null;
+  };
+  addHandler = ({
+    pluginId,
+    eventName,
+    command
+  } = {}, handler) => {
+    if (typeof handler !== "function") {
+      throw new Error("handler must be a function");
+    }
+    this.getHandlerSet(this.getHandlerKey({
+      pluginId,
+      eventName,
+      command
+    }), true).add(handler);
+  };
+  removeHandler = ({
+    pluginId,
+    eventName,
+    command
+  } = {}, handler) => {
+    const key = this.getHandlerKey({
+      pluginId,
+      eventName,
+      command
+    });
+    const handlers = this.getHandlerSet(key, false);
+    if (!handlers) {
+      return false;
+    }
+    if (handler == null) {
+      handlers.clear();
+      this.handlers.delete(key);
+      return true;
+    }
+    const removed = handlers.delete(handler);
+    if (handlers.size === 0) {
+      this.handlers.delete(key);
+    }
+    return removed;
+  };
+  ensureInitialized = () => {
+    if (typeof window === "undefined" || this.isInitialized) {
+      return this;
+    }
+    window.PluginBridgeWeb = window.PluginBridgeWeb || {};
+    window.PluginBridgeWeb.callback = this.dispatchCallback;
+    window.PluginBridgeWeb.dispatch = message => {
+      let parsed = message;
+      if (typeof parsed === "string") {
+        try {
+          parsed = JSON.parse(parsed);
+        } catch {
+          return false;
+        }
+      }
+      if (!parsed || typeof parsed !== "object") {
+        return false;
+      }
+      const payload = Object.prototype.hasOwnProperty.call(parsed, "payload") ? parsed.payload : null;
+      return this.dispatchCallback(parsed.pluginId, parsed.eventName, payload, parsed.requestId ?? null, parsed.command ?? null);
+    };
+    this.isInitialized = true;
+    return this;
+  };
+  hasAndroidBridge = () => typeof window !== "undefined" && !!window.PluginBridge;
+  hasIOSBridge = () => typeof window !== "undefined" && !!window.webkit?.messageHandlers?.PluginBridge;
+  init = () => this.ensureInitialized();
+  assertInitialized = () => {
+    if (!this.isInitialized) {
+      throw new Error("PluginBridge.init() must be called before using emit() or register()");
+    }
+  };
+  reportHandlerError = error => {
+    if (typeof queueMicrotask === "function") {
+      queueMicrotask(() => {
+        throw error;
+      });
+      return;
+    }
+    setTimeout(() => {
+      throw error;
+    }, 0);
+  };
+  emit = ({
+    pluginId,
+    command,
+    data = null
+  } = {}) => {
+    const normalizedPluginId = this.normalizeRequiredString(pluginId, "pluginId");
+    const normalizedCommand = this.normalizeRequiredString(command, "command");
+    if (typeof window === "undefined") {
+      throw new Error("PluginBridge is not available in this environment");
+    }
+    this.assertInitialized();
+    const payload = {
+      pluginId: normalizedPluginId,
+      command: normalizedCommand,
+      data,
+      requestId: this.createRequestId()
+    };
+    if (this.hasAndroidBridge()) {
+      window.PluginBridge.emit(JSON.stringify(payload));
+      return;
+    }
+    if (this.hasIOSBridge()) {
+      window.webkit.messageHandlers.PluginBridge.postMessage(payload);
+      return;
+    }
+    throw new Error("PluginBridge is not available in this environment");
+  };
+  register = ({
+    pluginId,
+    eventName,
+    command,
+    handler
+  } = {}) => {
+    this.assertInitialized();
+    this.addHandler({
+      pluginId,
+      eventName,
+      command
+    }, handler);
+    return () => this.removeHandler({
+      pluginId,
+      eventName,
+      command
+    }, handler);
+  };
+  unregister = ({
+    pluginId,
+    eventName,
+    command,
+    handler
+  } = {}) => {
+    if (typeof handler !== "function") {
+      throw new Error("handler must be a function");
+    }
+    return this.removeHandler({
+      pluginId,
+      eventName,
+      command
+    }, handler);
+  };
+  dispatchCallback = (pluginId, eventName, payload, requestId = null, command = null) => {
+    void requestId;
+    const normalizedPluginId = typeof pluginId === "string" && pluginId.trim() ? pluginId.trim() : null;
+    const normalizedEventName = typeof eventName === "string" && eventName.trim() ? eventName.trim() : null;
+    if (normalizedPluginId == null || normalizedEventName == null) {
+      return false;
+    }
+    const normalizedCommand = typeof command === "string" && command.trim() ? command.trim() : null;
+    const toCall = new Set();
+    const collectHandlers = commandScope => {
+      const handlers = this.getHandlerSet(JSON.stringify([normalizedPluginId, normalizedEventName, commandScope]), false);
+      if (!handlers) {
+        return;
+      }
+      handlers.forEach(handler => {
+        toCall.add(handler);
+      });
+    };
+    if (normalizedCommand != null) {
+      collectHandlers(normalizedCommand);
+    }
+    collectHandlers(null);
+    if (toCall.size === 0) {
+      return false;
+    }
+    const meta = {
+      pluginId: normalizedPluginId,
+      eventName: normalizedEventName,
+      command: normalizedCommand
+    };
+    toCall.forEach(handler => {
+      try {
+        handler(payload, meta);
+      } catch (error) {
+        this.reportHandlerError(error);
+      }
+    });
+    return true;
+  };
+}
+const pluginNativeBridge = new PluginNativeBridge();
+var _default = exports.default = pluginNativeBridge;