@oktis-works/plugin-runtime 0.1.0

package/dist/hook-registry.d.ts

@@ -0,0 +1,82 @@
+export type HookCallback<TArgs extends unknown[] = unknown[]> = (...args: TArgs) => unknown;
+export interface AddHookOptions {
+    priority?: number;
+    acceptedArgs?: number;
+    /** Identificador da origem ('blacklotus' para core ou id do plugin). */
+    sourceId?: string;
+    sourceType?: 'core' | 'plugin';
+    /** Nível mínimo de confiança exigido pelo ponto de extensão. */
+    requiredTrustLevel?: number;
+}
+export interface AuditLogEntry {
+    timestamp: string;
+    type: 'HOOK_BLOCKED' | 'HOOK_REJECTED';
+    sourceId: string;
+    sourceType: 'core' | 'plugin';
+    action: string;
+    reason: string;
+}
+export declare class HookRegistry {
+    private registrationSeq;
+    private readonly actions;
+    private readonly filters;
+    private readonly didActionCounts;
+    private currentHook;
+    private readonly auditLog;
+    private devMode;
+    private trustLevels;
+    setDevMode(enabled: boolean): void;
+    setTrustLevel(sourceId: string, level: number): void;
+    /**
+     * Catálogo de hooks registrados (REQ-REQU-035-002): lista cada hook com tipo,
+     * prioridades e fontes, gerado automaticamente a partir do registry.
+     */
+    listRegistered(): Array<{
+        hook: string;
+        type: 'action' | 'filter';
+        priorities: number[];
+        sources: string[];
+        total: number;
+    }>;
+    getAuditLog(): AuditLogEntry[];
+    clearAuditLog(): void;
+    /**
+     * Registra um callback de ação (executado por efeitos colaterais).
+     */
+    addAction(action: string, callback: HookCallback, options?: AddHookOptions): void;
+    /**
+     * Registra um callback de filtro (transforma e retorna o valor).
+     */
+    addFilter(filter: string, callback: HookCallback<[unknown, ...unknown[]]>, options?: AddHookOptions): void;
+    removeAction(action: string, callback: HookCallback, priority?: number): boolean;
+    removeFilter(filter: string, callback: HookCallback, priority?: number): boolean;
+    hasAction(action: string, callback?: HookCallback): boolean;
+    hasFilter(filter: string, callback?: HookCallback): boolean;
+    didAction(action: string): number;
+    getCurrentHook(): string | null;
+    /**
+     * Executa todos os callbacks registrados para uma ação.
+     * Reentrante: chamadas aninhadas preservam e restauram o hook atual.
+     */
+    doAction(action: string, ...args: unknown[]): Promise<void>;
+    /**
+     * Aplica filtros em cadeia: cada callback recebe o valor transformado pelo anterior.
+     * Semântica síncrona estilo WordPress (DECI-026).
+     */
+    applyFilters(filter: string, value: unknown, ...args: unknown[]): unknown;
+    /**
+     * Versão assíncrona do pipeline de filtros — callbacks que retornam Promise
+     * são resolvidos antes de alimentar o próximo da cadeia.
+     */
+    applyFiltersAsync(filter: string, value: unknown, ...args: unknown[]): Promise<unknown>;
+    private sortedEntries;
+    private authorizeRegistration;
+    private removeEntry;
+    private hasEntry;
+}
+export declare function getHookRegistry(): HookRegistry;
+/**
+ * Substitui o registry global. Uso interno: testes e hot-reload de plugins.
+ */
+export declare function setHookRegistry(registry: HookRegistry): void;
+//# sourceMappingURL=hook-registry.d.ts.map

package/dist/hook-registry.d.ts.map

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

package/dist/hook-registry.js

@@ -0,0 +1,255 @@
+// @oktis-works/plugin-runtime - Hook Registry (WordPress-style Actions & Filters)
+const CORE_PREFIX = 'blacklotus.';
+const PLUGIN_PREFIX = 'plugin.';
+function isPrefixed(action) {
+    return action.startsWith(CORE_PREFIX) || action.startsWith(PLUGIN_PREFIX);
+}
+export class HookRegistry {
+    registrationSeq = 0;
+    actions = new Map();
+    filters = new Map();
+    didActionCounts = new Map();
+    currentHook = null;
+    auditLog = [];
+    devMode = false;
+    trustLevels = new Map();
+    setDevMode(enabled) {
+        this.devMode = enabled;
+    }
+    setTrustLevel(sourceId, level) {
+        this.trustLevels.set(sourceId, level);
+    }
+    /**
+     * Catálogo de hooks registrados (REQ-REQU-035-002): lista cada hook com tipo,
+     * prioridades e fontes, gerado automaticamente a partir do registry.
+     */
+    listRegistered() {
+        const merge = (map, type) => {
+            const out = [];
+            for (const [hook, buckets] of map) {
+                const entries = [...buckets.values()].flat();
+                out.push({
+                    hook,
+                    type,
+                    priorities: [...buckets.keys()].sort((a, b) => a - b),
+                    sources: [...new Set(entries.map((e) => e.sourceId))],
+                    total: entries.length,
+                });
+            }
+            return out;
+        };
+        return [...merge(this.actions, 'action'), ...merge(this.filters, 'filter')].sort((a, b) => a.hook.localeCompare(b.hook));
+    }
+    getAuditLog() {
+        return [...this.auditLog];
+    }
+    clearAuditLog() {
+        this.auditLog.length = 0;
+    }
+    /**
+     * Registra um callback de ação (executado por efeitos colaterais).
+     */
+    addAction(action, callback, options = {}) {
+        if (!this.authorizeRegistration(action, options))
+            return;
+        const bucket = this.actions.get(action) ?? new Map();
+        const priority = options.priority ?? 10;
+        const entries = bucket.get(priority) ?? [];
+        entries.push({
+            seq: ++this.registrationSeq,
+            id: `${action}:${options.sourceId ?? 'anonymous'}:${Date.now().toString(36)}:${Math.random().toString(36).slice(2, 8)}`,
+            callback,
+            priority,
+            acceptedArgs: options.acceptedArgs ?? callback.length,
+            sourceId: options.sourceId ?? 'anonymous',
+            sourceType: options.sourceType ?? 'plugin',
+        });
+        bucket.set(priority, entries);
+        this.actions.set(action, bucket);
+    }
+    /**
+     * Registra um callback de filtro (transforma e retorna o valor).
+     */
+    addFilter(filter, callback, options = {}) {
+        if (!this.authorizeRegistration(filter, options))
+            return;
+        const bucket = this.filters.get(filter) ?? new Map();
+        const priority = options.priority ?? 10;
+        const entries = bucket.get(priority) ?? [];
+        entries.push({
+            seq: ++this.registrationSeq,
+            id: `${filter}:${options.sourceId ?? 'anonymous'}:${Date.now().toString(36)}:${Math.random().toString(36).slice(2, 8)}`,
+            callback,
+            priority,
+            acceptedArgs: options.acceptedArgs ?? callback.length,
+            sourceId: options.sourceId ?? 'anonymous',
+            sourceType: options.sourceType ?? 'plugin',
+        });
+        bucket.set(priority, entries);
+        this.filters.set(filter, bucket);
+    }
+    removeAction(action, callback, priority) {
+        return this.removeEntry(this.actions, action, callback, priority);
+    }
+    removeFilter(filter, callback, priority) {
+        return this.removeEntry(this.filters, filter, callback, priority);
+    }
+    hasAction(action, callback) {
+        return this.hasEntry(this.actions, action, callback);
+    }
+    hasFilter(filter, callback) {
+        return this.hasEntry(this.filters, filter, callback);
+    }
+    didAction(action) {
+        return this.didActionCounts.get(action) ?? 0;
+    }
+    getCurrentHook() {
+        return this.currentHook;
+    }
+    /**
+     * Executa todos os callbacks registrados para uma ação.
+     * Reentrante: chamadas aninhadas preservam e restauram o hook atual.
+     */
+    async doAction(action, ...args) {
+        const previous = this.currentHook;
+        this.currentHook = action;
+        this.didActionCounts.set(action, (this.didActionCounts.get(action) ?? 0) + 1);
+        try {
+            for (const entry of this.sortedEntries(this.actions, action)) {
+                try {
+                    await entry.callback(...args.slice(0, Math.max(entry.acceptedArgs, 0)));
+                }
+                catch (error) {
+                    // Callbacks com falha não interrompem os demais (BUSI-031).
+                    console.error(`[hooks] Erro no callback de ação "${action}" (${entry.sourceId}):`, error);
+                }
+            }
+        }
+        finally {
+            this.currentHook = previous;
+        }
+    }
+    /**
+     * Aplica filtros em cadeia: cada callback recebe o valor transformado pelo anterior.
+     * Semântica síncrona estilo WordPress (DECI-026).
+     */
+    applyFilters(filter, value, ...args) {
+        const previous = this.currentHook;
+        this.currentHook = filter;
+        try {
+            let result = value;
+            for (const entry of this.sortedEntries(this.filters, filter)) {
+                try {
+                    result = entry.callback(result, ...args.slice(0, Math.max(entry.acceptedArgs - 1, 0)));
+                }
+                catch (error) {
+                    console.error(`[hooks] Erro no callback de filtro "${filter}" (${entry.sourceId}):`, error);
+                }
+            }
+            return result;
+        }
+        finally {
+            this.currentHook = previous;
+        }
+    }
+    /**
+     * Versão assíncrona do pipeline de filtros — callbacks que retornam Promise
+     * são resolvidos antes de alimentar o próximo da cadeia.
+     */
+    async applyFiltersAsync(filter, value, ...args) {
+        const previous = this.currentHook;
+        this.currentHook = filter;
+        try {
+            let result = value;
+            for (const entry of this.sortedEntries(this.filters, filter)) {
+                try {
+                    result = await entry.callback(result, ...args.slice(0, Math.max(entry.acceptedArgs - 1, 0)));
+                }
+                catch (error) {
+                    console.error(`[hooks] Erro no callback de filtro "${filter}" (${entry.sourceId}):`, error);
+                }
+            }
+            return result;
+        }
+        finally {
+            this.currentHook = previous;
+        }
+    }
+    sortedEntries(map, action) {
+        const bucket = map.get(action);
+        if (!bucket)
+            return [];
+        return [...bucket.entries()]
+            .sort(([a], [b]) => a - b)
+            .flatMap(([, entries]) => [...entries].sort((a, b) => a.seq - b.seq));
+    }
+    authorizeRegistration(action, options) {
+        const sourceId = options.sourceId ?? 'anonymous';
+        if (this.devMode && !isPrefixed(action)) {
+            throw new Error(`[hooks] Em modo dev, hooks customizados devem ser prefixados ("${CORE_PREFIX}..." ou "plugin.<id>...."). Recebido: "${action}"`);
+        }
+        const requiredLevel = options.requiredTrustLevel ?? 0;
+        const sourceLevel = this.trustLevels.get(sourceId) ?? 0;
+        if (sourceLevel < requiredLevel) {
+            this.auditLog.push({
+                timestamp: new Date().toISOString(),
+                type: 'HOOK_BLOCKED',
+                sourceId,
+                sourceType: options.sourceType ?? 'plugin',
+                action,
+                reason: `trust level ${sourceLevel} insuficiente (mínimo ${requiredLevel})`,
+            });
+            return false;
+        }
+        return true;
+    }
+    removeEntry(map, name, callback, priority) {
+        const bucket = map.get(name);
+        if (!bucket)
+            return false;
+        let removed = false;
+        const prioritiesToRemove = priority !== undefined ? [priority] : [...bucket.keys()];
+        for (const p of prioritiesToRemove) {
+            const entries = bucket.get(p);
+            if (!entries)
+                continue;
+            const index = entries.findIndex((entry) => entry.callback === callback);
+            if (index >= 0) {
+                entries.splice(index, 1);
+                removed = true;
+                if (entries.length === 0)
+                    bucket.delete(p);
+            }
+        }
+        if (bucket.size === 0)
+            map.delete(name);
+        return removed;
+    }
+    hasEntry(map, name, callback) {
+        const bucket = map.get(name);
+        if (!bucket)
+            return false;
+        if (!callback)
+            return true;
+        for (const entries of bucket.values()) {
+            if (entries.some((entry) => entry.callback === callback))
+                return true;
+        }
+        return false;
+    }
+}
+let globalRegistry = null;
+export function getHookRegistry() {
+    if (!globalRegistry) {
+        globalRegistry = new HookRegistry();
+        globalRegistry.setDevMode(process.env['NODE_ENV'] !== 'production');
+    }
+    return globalRegistry;
+}
+/**
+ * Substitui o registry global. Uso interno: testes e hot-reload de plugins.
+ */
+export function setHookRegistry(registry) {
+    globalRegistry = registry;
+}
+//# sourceMappingURL=hook-registry.js.map

package/dist/hook-registry.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { PluginSandbox } from './sandbox.js';
+export type { SandboxConfig, LoadedPlugin } from './sandbox.js';
+export { PluginLoader } from './loader.js';
+export type { DiscoveredPlugin } from './loader.js';
+export { HookRegistry, getHookRegistry, setHookRegistry, } from './hook-registry.js';
+export type { AddHookOptions, AuditLogEntry, HookCallback } from './hook-registry.js';
+export { scopePluginCss, getPluginScopeAttribute, wrapWithPluginScope, lintPluginCss, } from './style-isolation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,GACd,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { PluginSandbox } from './sandbox.js';
+export { PluginLoader } from './loader.js';
+export { HookRegistry, getHookRegistry, setHookRegistry, } from './hook-registry.js';
+export { scopePluginCss, getPluginScopeAttribute, wrapWithPluginScope, lintPluginCss, } from './style-isolation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,GACd,MAAM,sBAAsB,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,19 @@
+import type { PluginManifest } from '@oktis-works/plugin-sdk';
+import type { LoadedPlugin } from './sandbox.js';
+export interface DiscoveredPlugin {
+    manifest: PluginManifest;
+    path: string;
+}
+export declare class PluginLoader {
+    private pluginsDir;
+    constructor(pluginsDir: string);
+    discoverPlugins(): Promise<DiscoveredPlugin[]>;
+    loadPlugin(manifest: PluginManifest, pluginPath: string): Promise<LoadedPlugin>;
+    resolveDependencies(plugins: DiscoveredPlugin[]): DiscoveredPlugin[][];
+    topologicalSort(plugins: DiscoveredPlugin[], pluginMap: Map<string, DiscoveredPlugin>): string[];
+    private visit;
+    private groupByLevel;
+    private findLevelForPlugin;
+    private loadManifest;
+}
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAIxB,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAgB9C,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAuBrF,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,EAAE;IAMtE,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,MAAM,EAAE;IAYhG,OAAO,CAAC,KAAK;IAyBb,OAAO,CAAC,YAAY;IA2BpB,OAAO,CAAC,kBAAkB;YAYZ,YAAY;CAS3B"}

package/dist/loader.js

@@ -0,0 +1,121 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { satisfies, validRange } from 'semver';
+import { CMS_VERSION } from '@oktis-works/validation';
+export class PluginLoader {
+    pluginsDir;
+    constructor(pluginsDir) {
+        this.pluginsDir = resolve(pluginsDir);
+    }
+    async discoverPlugins() {
+        const entries = await readdir(this.pluginsDir, { withFileTypes: true });
+        const plugins = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const pluginPath = join(this.pluginsDir, entry.name);
+            const manifest = await this.loadManifest(pluginPath);
+            if (manifest) {
+                plugins.push({ manifest, path: pluginPath });
+            }
+        }
+        return plugins;
+    }
+    async loadPlugin(manifest, pluginPath) {
+        // RULE-semver-compatibility: range compatibility.blacklotus deve satisfazer a versão do CMS
+        const compat = manifest.compatibility?.blacklotus;
+        if (typeof compat === 'string' && validRange(compat) && !satisfies(CMS_VERSION, compat)) {
+            throw new Error(`Plugin "${manifest.name}" requer BlackLotus ${compat}, mas a versão atual é ${CMS_VERSION}`);
+        }
+        const entryPath = resolve(join(pluginPath, manifest.main));
+        if (!entryPath.startsWith(this.pluginsDir)) {
+            throw new Error(`Plugin entry point escapes plugins directory: ${manifest.main}`);
+        }
+        const mod = await import(entryPath);
+        const api = mod.default ?? mod;
+        return {
+            manifest,
+            api,
+            loaded: true,
+            loadedAt: Date.now(),
+        };
+    }
+    resolveDependencies(plugins) {
+        const pluginMap = new Map(plugins.map(p => [p.manifest.name, p]));
+        const sorted = this.topologicalSort(plugins, pluginMap);
+        return this.groupByLevel(sorted, pluginMap);
+    }
+    topologicalSort(plugins, pluginMap) {
+        const visited = new Set();
+        const visiting = new Set();
+        const result = [];
+        for (const plugin of plugins) {
+            this.visit(plugin.manifest.name, pluginMap, visited, visiting, result);
+        }
+        return result;
+    }
+    visit(name, pluginMap, visited, visiting, result) {
+        if (visited.has(name))
+            return;
+        if (visiting.has(name))
+            throw new Error(`Circular dependency detected: ${name}`);
+        const plugin = pluginMap.get(name);
+        if (!plugin)
+            return;
+        visiting.add(name);
+        const deps = plugin.manifest.dependencies ?? [];
+        for (const dep of deps) {
+            this.visit(dep.name, pluginMap, visited, visiting, result);
+        }
+        visiting.delete(name);
+        visited.add(name);
+        result.push(name);
+    }
+    groupByLevel(sorted, pluginMap) {
+        const levels = [];
+        const placed = new Set();
+        for (const name of sorted) {
+            const plugin = pluginMap.get(name);
+            if (!plugin)
+                continue;
+            const deps = plugin.manifest.dependencies ?? [];
+            let level = 0;
+            for (const dep of deps) {
+                const depIndex = sorted.indexOf(dep.name);
+                const pluginIndex = sorted.indexOf(name);
+                if (depIndex >= 0 && depIndex < pluginIndex) {
+                    level = Math.max(level, ...this.findLevelForPlugin(dep.name, levels, pluginMap));
+                }
+            }
+            if (!levels[level])
+                levels[level] = [];
+            levels[level].push(plugin);
+            placed.add(name);
+        }
+        return levels.filter(l => l.length > 0);
+    }
+    findLevelForPlugin(name, levels, _pluginMap) {
+        const result = [];
+        for (let i = 0; i < levels.length; i++) {
+            const level = levels[i];
+            if (!level)
+                continue;
+            for (const p of level) {
+                if (p.manifest.name === name)
+                    result.push(i);
+            }
+        }
+        return result.length > 0 ? result : [0];
+    }
+    async loadManifest(pluginPath) {
+        try {
+            const manifestPath = join(pluginPath, 'package.json');
+            const content = await readFile(manifestPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/sandbox.d.ts

@@ -0,0 +1,24 @@
+import type { PluginManifest, PluginContext, PluginHookHandler, PluginAPI } from '@oktis-works/plugin-sdk';
+export interface SandboxConfig {
+    timeoutMs: number;
+    maxMemoryMb: number;
+    allowedPermissions: string[];
+}
+export declare class PluginSandbox {
+    private config;
+    constructor(config?: Partial<SandboxConfig>);
+    loadPlugin(manifest: PluginManifest, api: PluginAPI): LoadedPlugin;
+    /** BUSI plugin-style-isolation: bloqueia CSS global se plugin declarar style inline sem escopo */
+    private enforceStyleIsolation;
+    executeHook(hookName: string, context: PluginContext, handler: PluginHookHandler, payload: unknown, pluginPermissions?: string[]): Promise<void>;
+    callHandler<T>(handler: (...args: unknown[]) => T | Promise<T>, context: PluginContext, ...args: unknown[]): Promise<T>;
+    private withTimeout;
+    private checkPermissions;
+}
+export interface LoadedPlugin {
+    manifest: PluginManifest;
+    api: PluginAPI;
+    loaded: boolean;
+    loadedAt: number;
+}
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAE3G,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAQD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAI/C,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,GAAG,YAAY;IAMlE,kGAAkG;IAClG,OAAO,CAAC,qBAAqB;IASvB,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,OAAO,EAChB,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAC3B,OAAO,CAAC,IAAI,CAAC;IAOV,WAAW,CAAC,CAAC,EACjB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAC/C,OAAO,EAAE,aAAa,EACtB,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,CAAC,CAAC;YAIC,WAAW;IAczB,OAAO,CAAC,gBAAgB;CAOzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,GAAG,EAAE,SAAS,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/sandbox.js

@@ -0,0 +1,57 @@
+const defaultSandboxConfig = {
+    timeoutMs: 5000,
+    maxMemoryMb: 128,
+    allowedPermissions: [],
+};
+export class PluginSandbox {
+    config;
+    constructor(config = {}) {
+        this.config = { ...defaultSandboxConfig, ...config };
+    }
+    loadPlugin(manifest, api) {
+        this.checkPermissions(manifest.permissions ?? []);
+        this.enforceStyleIsolation(manifest);
+        return { manifest, api, loaded: true, loadedAt: Date.now() };
+    }
+    /** BUSI plugin-style-isolation: bloqueia CSS global se plugin declarar style inline sem escopo */
+    enforceStyleIsolation(manifest) {
+        const anyManifest = manifest;
+        const style = anyManifest['style'] ?? anyManifest['styles'];
+        if (typeof style === 'string' && (style.includes(':root') || style.includes('html{') || style.includes('body{')) && !style.includes('data-plugin')) {
+            // apenas warn — escopo será aplicado em runtime via scopePluginCss
+            console.warn(`[sandbox] Plugin ${manifest.name} declara CSS global sem [data-plugin] — será escopado automaticamente`);
+        }
+    }
+    async executeHook(hookName, context, handler, payload, pluginPermissions) {
+        if (pluginPermissions) {
+            this.checkPermissions(pluginPermissions);
+        }
+        await this.withTimeout(Promise.resolve(handler(context, payload)));
+    }
+    async callHandler(handler, context, ...args) {
+        return this.withTimeout(Promise.resolve(handler(context, ...args)));
+    }
+    async withTimeout(promise) {
+        let timer;
+        try {
+            return await Promise.race([
+                promise,
+                new Promise((_, reject) => {
+                    timer = setTimeout(() => reject(new Error('Plugin operation timed out')), this.config.timeoutMs);
+                }),
+            ]);
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    }
+    checkPermissions(permissions) {
+        for (const permission of permissions) {
+            if (!this.config.allowedPermissions.includes(permission)) {
+                throw new Error(`Plugin permission denied: ${permission}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAQA,MAAM,oBAAoB,GAAkB;IAC1C,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,GAAG;IAChB,kBAAkB,EAAE,EAAE;CACvB,CAAC;AAEF,MAAM,OAAO,aAAa;IAChB,MAAM,CAAgB;IAE9B,YAAY,SAAiC,EAAE;QAC7C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,oBAAoB,EAAE,GAAG,MAAM,EAAE,CAAC;IACvD,CAAC;IAED,UAAU,CAAC,QAAwB,EAAE,GAAc;QACjD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACrC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAC/D,CAAC;IAED,kGAAkG;IAC1F,qBAAqB,CAAC,QAAwB;QACpD,MAAM,WAAW,GAAG,QAA8C,CAAC;QACnE,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACnJ,mEAAmE;YACnE,OAAO,CAAC,IAAI,CAAC,oBAAoB,QAAQ,CAAC,IAAI,uEAAuE,CAAC,CAAC;QACzH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CACf,QAAgB,EAChB,OAAsB,EACtB,OAA0B,EAC1B,OAAgB,EAChB,iBAA4B;QAE5B,IAAI,iBAAiB,EAAE,CAAC;YACtB,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,WAAW,CACf,OAA+C,EAC/C,OAAsB,EACtB,GAAG,IAAe;QAElB,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;IAEO,KAAK,CAAC,WAAW,CAAI,OAAmB;QAC9C,IAAI,KAAiC,CAAC;QACtC,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;gBACxB,OAAO;gBACP,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;oBAC3B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACnG,CAAC,CAAC;aACH,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,WAAqB;QAC5C,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACzD,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/style-isolation.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Escopa CSS sob [data-plugin="name"] — isolamento fino para plugins.
+ * Cobre seletores, @media/@supports recursivo, preserva @keyframes/@font-face.
+ * Sem dependência de PostCSS (fallback runtime); para build use mesmo algoritmo de theme-runtime.
+ */
+export declare function scopePluginCss(css: string, pluginName: string, prefix?: string): string;
+export declare function getPluginScopeAttribute(pluginName: string): {
+    attr: string;
+    selector: string;
+    dataAttr: string;
+};
+/**
+ * Envelopa HTML de plugin com [data-plugin] para garantir escopo no DOM.
+ * Idempotente: se já contém data-plugin, retorna intacto.
+ */
+export declare function wrapWithPluginScope(html: string, pluginName: string): string;
+/**
+ * Valida que CSS de plugin não contém vazamento global óbvio.
+ * Retorna warnings se encontrar :root/html/body sem escopo ou * global sem prefix.
+ */
+export declare function lintPluginCss(css: string, pluginName: string): string[];
+//# sourceMappingURL=style-isolation.d.ts.map

package/dist/style-isolation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-isolation.d.ts","sourceRoot":"","sources":["../src/style-isolation.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAkC,GAAG,MAAM,CAgEhH;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAGhH;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAMvE"}

package/dist/style-isolation.js

@@ -0,0 +1,125 @@
+// @oktis-works/plugin-runtime - Plugin Style Isolation [data-plugin="nome"] — obrigatório
+// Equivalente ao isolamento de tema [data-theme], mas para plugins (admin + site).
+// BUSI plugin-style-isolation: todo CSS injetado por plugin deve ser escopado.
+/**
+ * Escopa CSS sob [data-plugin="name"] — isolamento fino para plugins.
+ * Cobre seletores, @media/@supports recursivo, preserva @keyframes/@font-face.
+ * Sem dependência de PostCSS (fallback runtime); para build use mesmo algoritmo de theme-runtime.
+ */
+export function scopePluginCss(css, pluginName, prefix = `[data-plugin="${pluginName}"]`) {
+    const isExcludedAtRule = (selector) => {
+        const s = selector.trim();
+        return s.startsWith('@keyframes') || s.startsWith('@font-face') || s.startsWith('@import');
+    };
+    const shouldReplaceRoot = (sel) => /:root|\bhtml\b|\bbody\b/.test(sel);
+    let out = '';
+    let i = 0;
+    const len = css.length;
+    while (i < len) {
+        if (css[i]?.trim() === '') {
+            out += css[i++];
+            continue;
+        }
+        if (css.startsWith('/*', i)) {
+            const end = css.indexOf('*/', i + 2);
+            const comment = end === -1 ? css.slice(i) : css.slice(i, end + 2);
+            out += comment;
+            i += comment.length;
+            continue;
+        }
+        if (css[i] === '@') {
+            const semi = css.indexOf(';', i);
+            const brace = css.indexOf('{', i);
+            if (semi !== -1 && (brace === -1 || semi < brace)) {
+                out += css.slice(i, semi + 1);
+                i = semi + 1;
+                continue;
+            }
+        }
+        const braceIdx = css.indexOf('{', i);
+        if (braceIdx === -1) {
+            out += css.slice(i);
+            break;
+        }
+        const selectorPart = css.slice(i, braceIdx).trim();
+        let depth = 0;
+        let endIdx = -1;
+        for (let k = braceIdx; k < len; k++) {
+            if (css[k] === '{')
+                depth++;
+            else if (css[k] === '}') {
+                depth--;
+                if (depth === 0) {
+                    endIdx = k;
+                    break;
+                }
+            }
+        }
+        if (endIdx === -1) {
+            out += css.slice(i);
+            break;
+        }
+        const block = css.slice(i, endIdx + 1);
+        const body = css.slice(braceIdx, endIdx + 1);
+        if (isExcludedAtRule(selectorPart)) {
+            out += block;
+        }
+        else if (selectorPart.startsWith('@media') || selectorPart.startsWith('@supports') || selectorPart.startsWith('@layer')) {
+            const inner = css.slice(braceIdx + 1, endIdx);
+            out += `${selectorPart} {${scopePluginCss(inner, pluginName, prefix)}}`;
+        }
+        else if (selectorPart.startsWith('@')) {
+            const inner = css.slice(braceIdx + 1, endIdx);
+            out += `${selectorPart} {${inner}}`;
+        }
+        else {
+            const selectors = selectorPart.split(',').map(s => s.trim()).filter(Boolean);
+            const scoped = selectors.map(sel => {
+                if (sel.startsWith('@'))
+                    return sel;
+                if (sel.includes(prefix))
+                    return sel;
+                if (shouldReplaceRoot(sel)) {
+                    if (sel === ':root' || sel === 'html' || sel === 'body')
+                        return prefix;
+                    return sel.replace(':root', prefix).replace(/\bhtml\b/, prefix).replace(/\bbody\b/, prefix);
+                }
+                return `${prefix} ${sel}`;
+            });
+            out += `${scoped.join(', ')}${body}`;
+        }
+        i = endIdx + 1;
+    }
+    if (!out.trim() && css.trim())
+        return `${prefix} { ${css} }`;
+    return out || css;
+}
+export function getPluginScopeAttribute(pluginName) {
+    const escaped = pluginName.replace(/"/g, '&quot;');
+    return { attr: `data-plugin="${escaped}"`, selector: `[data-plugin="${escaped}"]`, dataAttr: 'data-plugin' };
+}
+/**
+ * Envelopa HTML de plugin com [data-plugin] para garantir escopo no DOM.
+ * Idempotente: se já contém data-plugin, retorna intacto.
+ */
+export function wrapWithPluginScope(html, pluginName) {
+    const { attr } = getPluginScopeAttribute(pluginName);
+    if (html.includes('data-plugin='))
+        return html;
+    // prefere wrapper <div data-plugin="...">
+    return `<div ${attr}>${html}</div>`;
+}
+/**
+ * Valida que CSS de plugin não contém vazamento global óbvio.
+ * Retorna warnings se encontrar :root/html/body sem escopo ou * global sem prefix.
+ */
+export function lintPluginCss(css, pluginName) {
+    const warnings = [];
+    const prefix = `[data-plugin="${pluginName}"]`;
+    if (css.includes(':root') && !css.includes(prefix))
+        warnings.push('CSS contém :root sem escopo [data-plugin] — será remapeado para prefix');
+    if (/\bhtml\s*\{/.test(css) || /\bbody\s*\{/.test(css))
+        warnings.push('CSS contém html/body global — será remapeado para [data-plugin]');
+    return warnings;
+}
+//# sourceMappingURL=style-isolation.js.map

package/dist/style-isolation.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@oktis-works/plugin-runtime",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo"
+  },
+  "dependencies": {
+    "@oktis-works/plugin-sdk": "0.1.0",
+    "@oktis-works/types": "0.1.0",
+    "@oktis-works/validation": "0.1.0",
+    "semver": "7"
+  },
+  "devDependencies": {
+    "typescript": "5.7.3"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/blacklotus/blacklotus-cms",
+    "directory": "packages/plugin-runtime"
+  }
+}