bun_plugins 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,167 @@
+import { z } from "zod";
+export declare enum WorkerMessageType {
+    RPC_CALL = "RPC_CALL",
+    HOOK_CALL = "HOOK_CALL",
+    HOOK_RESULT = "HOOK_RESULT",
+    HOOK_ERROR = "HOOK_ERROR",
+    EVENT_EMIT = "EVENT_EMIT",
+    MANIFEST = "MANIFEST",
+    LOAD_SUCCESS = "LOAD_SUCCESS",
+    LOAD_ERROR = "LOAD_ERROR",
+    START_UP = "START_UP",
+    UNLOAD = "UNLOAD"
+}
+export declare enum PluginPermission {
+    Network = "network",
+    Filesystem = "filesystem",
+    Env = "env"
+}
+export declare enum RPCMethod {
+    StorageGet = "storage:get",
+    StorageSet = "storage:set",
+    StorageDelete = "storage:delete",
+    StorageClear = "storage:clear",
+    EventsEmit = "events:emit",
+    EventsOn = "events:on",
+    HooksRegister = "hooks:register",
+    ManagerGetPlugin = "manager:getPlugin",
+    Log = "log",
+    NetworkFetch = "network:fetch",
+    PermissionCheck = "perm:check"
+}
+export declare enum HookType {
+    ON_RESOLVE = "onResolve",
+    ON_LOAD = "onLoad"
+}
+export declare enum HookOrder {
+    PRE = "pre",
+    POST = "post"
+}
+export interface PluginResource {
+    workers: Worker[];
+    timers: {
+        id: number | Timer;
+        type: 'timeout' | 'interval';
+    }[];
+    eventListeners: {
+        event: string;
+        listener: Function;
+    }[];
+}
+export interface HookRegistry<T> {
+    filter: RegExp;
+    callback: T;
+    pluginName: string;
+    order?: HookOrder;
+}
+export interface AppEvents {
+    "log": {
+        level: "info" | "error" | "warn";
+        message: string;
+    };
+    "cmd:input": {
+        command: string;
+        args: string[];
+    };
+    [key: string]: any;
+}
+export type EventCallback<T> = (payload: T) => void | Promise<void>;
+export interface IPluginStorage {
+    get<T>(key: string, defaultValue?: T): Promise<T | undefined>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+}
+export interface Logger {
+    info(msg: string, ...args: any[]): void;
+    warn(msg: string, ...args: any[]): void;
+    error(msg: string, ...args: any[]): void;
+}
+export interface PluginContext {
+    emit<K extends keyof AppEvents>(event: K, payload: AppEvents[K]): void;
+    on<K extends keyof AppEvents>(event: K, callback: EventCallback<AppEvents[K]>): void;
+    events: {
+        emit<K extends keyof AppEvents>(event: K, payload: AppEvents[K]): void;
+        on<K extends keyof AppEvents>(event: K, callback: EventCallback<AppEvents[K]>): void;
+    };
+    storage: IPluginStorage;
+    config: Record<string, any>;
+    manager: any;
+    getPlugin(name: string): unknown | undefined;
+    log: Logger;
+    createWorker(url: string | URL, options?: BunWorkerOptions): BunWorker;
+    network: {
+        fetch: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+    };
+    file: (path: string) => any;
+    env: Record<string, string | undefined>;
+    setTimeout: (callback: (...args: any[]) => void, delay?: number, ...args: any[]) => number | Timer;
+    setInterval: (callback: (...args: any[]) => void, delay?: number, ...args: any[]) => number | Timer;
+    clearTimeout: (id: number | Timer) => void;
+    clearInterval: (id: number | Timer) => void;
+}
+export interface BunWorkerOptions extends WorkerOptions {
+    smol?: boolean;
+    preload?: string[] | string;
+    ref?: boolean;
+    env?: Record<string, string>;
+}
+export interface BunWorker extends Worker {
+    ref(): void;
+    unref(): void;
+}
+export declare class AccessDeniedError extends Error {
+    constructor(permission: string, pluginName: string);
+}
+export declare const BasicPluginSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+}, z.core.$strip>;
+export interface IPlugin {
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+    engines?: {
+        host?: string;
+    };
+    configSchema?: z.ZodSchema;
+    defaultConfig?: Record<string, any>;
+    dependencies?: Record<string, string>;
+    permissions?: PluginPermission[];
+    allowedDomains?: string[];
+    onLoad(context: PluginContext): Promise<void> | void;
+    onStarted?: () => Promise<void> | void;
+    onUnload(): Promise<void> | void;
+    getSharedApi?: () => unknown;
+    setup?: (build: PluginBuilder) => void | Promise<void>;
+}
+export type OnResolveArgs = {
+    path: string;
+    importer?: string;
+    namespace?: string;
+};
+export type OnResolveResult = {
+    path: string;
+    namespace?: string;
+} | undefined | null;
+export type OnResolveCallback = (args: OnResolveArgs) => OnResolveResult | Promise<OnResolveResult>;
+export type OnLoadArgs = {
+    path: string;
+    namespace?: string;
+    previousContents?: string;
+};
+export type OnLoadResult = {
+    contents: string;
+    loader?: string;
+} | undefined | null;
+export type OnLoadCallback = (args: OnLoadArgs) => OnLoadResult | Promise<OnLoadResult>;
+export interface PluginBuilder {
+    onResolve(filter: RegExp, callback: OnResolveCallback, options?: {
+        order?: HookOrder;
+    }): void;
+    onLoad(filter: RegExp, callback: OnLoadCallback, options?: {
+        order?: HookOrder;
+    }): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+export var WorkerMessageType;
+(function (WorkerMessageType) {
+    WorkerMessageType["RPC_CALL"] = "RPC_CALL";
+    WorkerMessageType["HOOK_CALL"] = "HOOK_CALL";
+    WorkerMessageType["HOOK_RESULT"] = "HOOK_RESULT";
+    WorkerMessageType["HOOK_ERROR"] = "HOOK_ERROR";
+    WorkerMessageType["EVENT_EMIT"] = "EVENT_EMIT";
+    WorkerMessageType["MANIFEST"] = "MANIFEST";
+    WorkerMessageType["LOAD_SUCCESS"] = "LOAD_SUCCESS";
+    WorkerMessageType["LOAD_ERROR"] = "LOAD_ERROR";
+    WorkerMessageType["START_UP"] = "START_UP";
+    WorkerMessageType["UNLOAD"] = "UNLOAD";
+})(WorkerMessageType || (WorkerMessageType = {}));
+export var PluginPermission;
+(function (PluginPermission) {
+    PluginPermission["Network"] = "network";
+    PluginPermission["Filesystem"] = "filesystem";
+    PluginPermission["Env"] = "env";
+})(PluginPermission || (PluginPermission = {}));
+export var RPCMethod;
+(function (RPCMethod) {
+    RPCMethod["StorageGet"] = "storage:get";
+    RPCMethod["StorageSet"] = "storage:set";
+    RPCMethod["StorageDelete"] = "storage:delete";
+    RPCMethod["StorageClear"] = "storage:clear";
+    RPCMethod["EventsEmit"] = "events:emit";
+    RPCMethod["EventsOn"] = "events:on";
+    RPCMethod["HooksRegister"] = "hooks:register";
+    RPCMethod["ManagerGetPlugin"] = "manager:getPlugin";
+    RPCMethod["Log"] = "log";
+    RPCMethod["NetworkFetch"] = "network:fetch";
+    RPCMethod["PermissionCheck"] = "perm:check";
+})(RPCMethod || (RPCMethod = {}));
+export var HookType;
+(function (HookType) {
+    HookType["ON_RESOLVE"] = "onResolve";
+    HookType["ON_LOAD"] = "onLoad";
+})(HookType || (HookType = {}));
+export var HookOrder;
+(function (HookOrder) {
+    HookOrder["PRE"] = "pre";
+    HookOrder["POST"] = "post";
+})(HookOrder || (HookOrder = {}));
+export class AccessDeniedError extends Error {
+    constructor(permission, pluginName) {
+        super(`Plugin '${pluginName}' tried to access '${permission}' but does not have permission.`);
+        this.name = "AccessDeniedError";
+    }
+}
+// Validation schema for a basic plugin structure if needed
+export const BasicPluginSchema = z.object({
+    name: z.string(),
+    version: z.string(),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAN,IAAY,iBAWX;AAXD,WAAY,iBAAiB;IACzB,0CAAqB,CAAA;IACrB,4CAAuB,CAAA;IACvB,gDAA2B,CAAA;IAC3B,8CAAyB,CAAA;IACzB,8CAAyB,CAAA;IACzB,0CAAqB,CAAA;IACrB,kDAA6B,CAAA;IAC7B,8CAAyB,CAAA;IACzB,0CAAqB,CAAA;IACrB,sCAAiB,CAAA;AACrB,CAAC,EAXW,iBAAiB,KAAjB,iBAAiB,QAW5B;AAED,MAAM,CAAN,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IACxB,uCAAmB,CAAA;IACnB,6CAAyB,CAAA;IACzB,+BAAW,CAAA;AACf,CAAC,EAJW,gBAAgB,KAAhB,gBAAgB,QAI3B;AAED,MAAM,CAAN,IAAY,SAYX;AAZD,WAAY,SAAS;IACjB,uCAA0B,CAAA;IAC1B,uCAA0B,CAAA;IAC1B,6CAAgC,CAAA;IAChC,2CAA8B,CAAA;IAC9B,uCAA0B,CAAA;IAC1B,mCAAsB,CAAA;IACtB,6CAAgC,CAAA;IAChC,mDAAsC,CAAA;IACtC,wBAAW,CAAA;IACX,2CAA8B,CAAA;IAC9B,2CAA8B,CAAA;AAClC,CAAC,EAZW,SAAS,KAAT,SAAS,QAYpB;AAED,MAAM,CAAN,IAAY,QAGX;AAHD,WAAY,QAAQ;IAChB,oCAAwB,CAAA;IACxB,8BAAkB,CAAA;AACtB,CAAC,EAHW,QAAQ,KAAR,QAAQ,QAGnB;AAED,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACjB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACjB,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AA0FD,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACxC,YAAY,UAAkB,EAAE,UAAkB;QAC9C,KAAK,CAAC,WAAW,UAAU,sBAAsB,UAAU,iCAAiC,CAAC,CAAC;QAC9F,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACpC,CAAC;CACJ;AAED,2DAA2D;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC"}

package/dist/utils/errorParser.d.ts

@@ -0,0 +1,3 @@
+export declare function errorParser(error: unknown, prefix?: string): Error;
+export default errorParser;
+//# sourceMappingURL=errorParser.d.ts.map

package/dist/utils/errorParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorParser.d.ts","sourceRoot":"","sources":["../../src/utils/errorParser.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAoBlE;AACD,eAAe,WAAW,CAAC"}

package/dist/utils/errorParser.js

@@ -0,0 +1,23 @@
+export function errorParser(error, prefix) {
+    let parsedError;
+    // Parse the error
+    if (error instanceof Error) {
+        parsedError = error;
+    }
+    else if (typeof error === "string") {
+        parsedError = new Error(error);
+    }
+    else if (error && typeof error === "object" && "message" in error) {
+        parsedError = new Error(String(error.message));
+    }
+    else {
+        parsedError = new Error(String(error));
+    }
+    // Prepend prefix if provided
+    if (prefix) {
+        parsedError.message = `${prefix}: ${parsedError.message}`;
+    }
+    return parsedError;
+}
+export default errorParser;
+//# sourceMappingURL=errorParser.js.map

package/dist/utils/errorParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorParser.js","sourceRoot":"","sources":["../../src/utils/errorParser.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,MAAe;IACzD,IAAI,WAAkB,CAAC;IAEvB,kBAAkB;IAClB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,WAAW,GAAG,KAAK,CAAC;IACtB,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,WAAW,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;SAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QACpE,WAAW,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,6BAA6B;IAC7B,IAAI,MAAM,EAAE,CAAC;QACX,WAAW,CAAC,OAAO,GAAG,GAAG,MAAM,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC;IAC5D,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AACD,eAAe,WAAW,CAAC"}

package/dist/utils/pluginValidator.d.ts

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import type { IPlugin } from "../types";
+export declare const PluginSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodDefault<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    configSchema: z.ZodOptional<z.ZodAny>;
+    defaultConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        network: "network";
+        filesystem: "filesystem";
+        env: "env";
+    }>>>;
+    allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    engines: z.ZodOptional<z.ZodObject<{
+        host: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    onLoad: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+    onStarted: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+    onUnload: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+    getSharedApi: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+    setup: z.ZodOptional<z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>;
+}, z.core.$strip>;
+export declare const StrictPluginSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    onLoad: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+    onUnload: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+}, z.core.$strip>;
+export type ValidationResult = {
+    valid: true;
+    plugin: IPlugin;
+} | {
+    valid: false;
+    error: string;
+};
+/**
+ * Validates if an unknown object is a valid plugin.
+ * Handles:
+ * 1. Class instances (Standard)
+ * 2. Plain objects
+ * 3. Class Constructors (instantiates them) // TODO if we want to move that logic here
+ */
+export declare function validatePlugin(candidate: unknown): ValidationResult;
+//# sourceMappingURL=pluginValidator.d.ts.map

package/dist/utils/pluginValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginValidator.d.ts","sourceRoot":"","sources":["../../src/utils/pluginValidator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;iBAsBvB,CAAC;AAGH,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GACxB;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAChC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,OAAO,GAAG,gBAAgB,CAqBnE"}

package/dist/utils/pluginValidator.js

@@ -0,0 +1,76 @@
+import { z } from "zod";
+import { errorParser } from "../utils/errorParser";
+export const PluginSchema = z.object({
+    name: z.string().min(1, "Plugin name is required"),
+    version: z.string().min(1, "Plugin version is required").default("1.0.0"),
+    description: z.string().optional(),
+    author: z.string().optional(),
+    configSchema: z.any().optional(), // We accept any Zod-like object here
+    defaultConfig: z.record(z.string(), z.any()).optional(),
+    dependencies: z.record(z.string(), z.string()).optional(),
+    permissions: z.array(z.enum(['network', 'filesystem', 'env'])).optional(),
+    allowedDomains: z.array(z.string()).optional(),
+    engines: z.object({
+        host: z.string().optional(),
+    }).optional(),
+    onLoad: z.function(),
+    onStarted: z.function().optional(),
+    onUnload: z.function().optional(),
+    getSharedApi: z.function().optional(),
+    setup: z.function().optional(),
+});
+// We can have a stricter schema for the full IPlugin
+export const StrictPluginSchema = z.object({
+    name: z.string(),
+    version: z.string(),
+    onLoad: z.function(),
+    onUnload: z.function(),
+});
+/**
+ * Validates if an unknown object is a valid plugin.
+ * Handles:
+ * 1. Class instances (Standard)
+ * 2. Plain objects
+ * 3. Class Constructors (instantiates them) // TODO if we want to move that logic here
+ */
+export function validatePlugin(candidate) {
+    try {
+        // If it's a class constructor (function), try to instantiate it
+        if (typeof candidate === 'function' && candidate.prototype) {
+            // We can't easily instantiate it without knowing if it needs args, 
+            // but our convention is 0-arg constructor for plugins.
+            try {
+                // @ts-ignore
+                const instance = new candidate();
+                return validatePluginInstance(instance);
+            }
+            catch (e) {
+                const errorplugin = errorParser(e, `Failed to instantiate plugin class:`);
+                return { valid: false, error: errorplugin.message };
+            }
+        }
+        return validatePluginInstance(candidate);
+    }
+    catch (error) {
+        const errorplugin = errorParser(error, `Unexpected validation error:`);
+        return { valid: false, error: errorplugin.message };
+    }
+}
+function validatePluginInstance(obj) {
+    const result = PluginSchema.safeParse(obj);
+    if (!result.success) {
+        return {
+            valid: false,
+            error: result.error.issues.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ')
+        };
+    }
+    // Cast to IPlugin (fill in missing optional methods if needed)
+    const plugin = result.data;
+    // Shim onUnload if missing (since we made it optional in schema but it is required in IPlugin interface usually, 
+    // though we can be lenient)
+    if (!plugin.onUnload) {
+        plugin.onUnload = () => { };
+    }
+    return { valid: true, plugin };
+}
+//# sourceMappingURL=pluginValidator.js.map

package/dist/utils/pluginValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginValidator.js","sourceRoot":"","sources":["../../src/utils/pluginValidator.ts"],"names":[],"mappings":"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"}

package/dist/utils/security.d.ts

@@ -0,0 +1,3 @@
+export declare function checkNetworkPermission(pluginName: string, permissions: string[] | undefined, allowedDomains: string[] | undefined, urlStr: string): void;
+export declare function checkPermission(pluginName: string, permissions: string[] | undefined, perm: 'filesystem' | 'env'): void;
+//# sourceMappingURL=security.d.ts.map

package/dist/utils/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/utils/security.ts"],"names":[],"mappings":"AAAA,wBAAgB,sBAAsB,CAClC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,EACjC,cAAc,EAAE,MAAM,EAAE,GAAG,SAAS,EACpC,MAAM,EAAE,MAAM,GACf,IAAI,CAuBN;AAED,wBAAgB,eAAe,CAC3B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,EACjC,IAAI,EAAE,YAAY,GAAG,KAAK,GAC3B,IAAI,CAIN"}

package/dist/utils/security.js

@@ -0,0 +1,26 @@
+export function checkNetworkPermission(pluginName, permissions, allowedDomains, urlStr) {
+    if (!permissions?.includes('network')) {
+        throw new Error(`AccessDenied: Plugin '${pluginName}' requires 'network' permission.`);
+    }
+    if (allowedDomains && allowedDomains.length > 0) {
+        let url;
+        try {
+            url = new URL(urlStr);
+        }
+        catch (e) {
+            // If URL is invalid, we block it just in case
+            throw new Error(`AccessDenied: Invalid URL '${urlStr}' for plugin '${pluginName}'.`);
+        }
+        const hostname = url.hostname;
+        const isAllowed = allowedDomains.some(domain => hostname === domain || hostname.endsWith('.' + domain));
+        if (!isAllowed) {
+            throw new Error(`AccessDenied: Domain '${hostname}' is not in allowedDomains for plugin '${pluginName}'.`);
+        }
+    }
+}
+export function checkPermission(pluginName, permissions, perm) {
+    if (!permissions?.includes(perm)) {
+        throw new Error(`AccessDenied: Plugin '${pluginName}' requires '${perm}' permission.`);
+    }
+}
+//# sourceMappingURL=security.js.map

package/dist/utils/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/utils/security.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,sBAAsB,CAClC,UAAkB,EAClB,WAAiC,EACjC,cAAoC,EACpC,MAAc;IAEd,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,yBAAyB,UAAU,kCAAkC,CAAC,CAAC;IAC3F,CAAC;IAED,IAAI,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,IAAI,GAAQ,CAAC;QACb,IAAI,CAAC;YACD,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,8CAA8C;YAC9C,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,iBAAiB,UAAU,IAAI,CAAC,CAAC;QACzF,CAAC;QAED,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC9B,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAC3C,QAAQ,KAAK,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,GAAG,MAAM,CAAC,CACzD,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,0CAA0C,UAAU,IAAI,CAAC,CAAC;QAC/G,CAAC;IACL,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAC3B,UAAkB,EAClB,WAAiC,EACjC,IAA0B;IAE1B,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,yBAAyB,UAAU,eAAe,IAAI,eAAe,CAAC,CAAC;IAC3F,CAAC;AACL,CAAC"}

package/dist/worker/WorkerRunner.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=WorkerRunner.d.ts.map

package/dist/worker/WorkerRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerRunner.d.ts","sourceRoot":"","sources":["../../src/worker/WorkerRunner.ts"],"names":[],"mappings":""}