@oktis-works/plugin-runtime 0.6.1 → 0.7.0

package/dist/manifest.js

@@ -1,22 +1,220 @@
-// @oktis-works/plugin-runtime - Fonte única de leitura de manifesto de plugin
+// @oktis-works/plugin-runtime - Single source of truth for reading plugin manifests
 //
-// Antes havia duas fontes de verdade divergentes:
-//   - o loader lia `package.json` primeiro, depois `manifest.json`;
-//   - o sync (admin) e a CLI liam só `manifest.json`.
-// Um plugin no formato npm era descoberto pelo runtime mas nunca chegava ao
-// banco (invisível no admin). Aqui tudo passa por `readPluginManifest`:
+// Historically:
+//   - the admin sync and the CLI read only `manifest.json`;
+//   - npm plugins could skip it and live off `package.json` (fields then came
+//     from the database — invisible in the admin). Everything now goes through
+//     `readPluginManifest`:
 //
-//   - **precedência**: `manifest.json` (canônico do OkCMS) vence `package.json`
-//     (formato npm); campos ausentes em `manifest.json` são preenchidos do npm;
-//   - **validação**: `name`/`version` obrigatórios; `type` explícito ≠ 'plugin'
-//     é rejeitado (ex.: theme.json/manifest de tema dentro de plugins/);
-//   - `strict` (sync/instalação) exige mais que `main` e devolve `issues`
+//   - **precedence**: `manifest.json` (the OkCMS canonical) wins over
+//     `package.json` (npm format); fields missing from `manifest.json` are
+//     filled from npm;
+//   - **validation**: `name`/`version` required; an explicit `type` other than
+//     'plugin' is rejected (e.g. a theme.json/manifest inside plugins/);
+//   - `strict` (sync/install) demands more than `main` and returns `issues`.
 //     para o chamador decidir; o loader usa `strict = false` (leniente).
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
+import { validatePermissions } from '@oktis-works/plugin-sdk';
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
+function isString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+/**
+ * Valida os campos do schema v2 (tudo opcional — um manifesto v1 continua
+ * valid). Returns the found issues; empty = valid.
+ */
+export function validateManifestV2(merged) {
+    const issues = [];
+    const manifestVersion = merged['manifestVersion'];
+    if (manifestVersion !== undefined && manifestVersion !== 1 && manifestVersion !== 2) {
+        issues.push(`manifestVersion "${String(manifestVersion)}" invalid (expected 1 or 2)`);
+    }
+    // Permissions: unknown ones are rejected (the plugin-sdk catalog).
+    const permissions = merged['permissions'];
+    if (Array.isArray(permissions)) {
+        for (const unknown of validatePermissions(permissions.filter(isString))) {
+            issues.push(`unknown permission "${unknown}"`);
+        }
+    }
+    const blocks = merged['blocks'];
+    if (Array.isArray(blocks)) {
+        for (const block of blocks) {
+            if (!isRecord(block) || !isString(block['type']) || !isString(block['label']) || !isString(block['icon']) || !isString(block['adminComponentPath'])) {
+                issues.push('block missing valid type/label/icon/adminComponentPath');
+            }
+        }
+    }
+    const patterns = merged['patterns'];
+    if (Array.isArray(patterns)) {
+        for (const pattern of patterns) {
+            if (!isRecord(pattern) || !isString(pattern['name']) || !isString(pattern['label']) || !isString(pattern['content']) || pattern['content'].length === 0) {
+                issues.push('pattern missing valid name/label/content');
+            }
+        }
+    }
+    const locales = merged['locales'];
+    if (locales !== undefined) {
+        if (!Array.isArray(locales) || !locales.every(isString)) {
+            issues.push('locales must be an array of file paths');
+        }
+        else if (locales.some((path) => path.includes('..') || path.startsWith('/'))) {
+            issues.push('locales with paths outside the plugin directory');
+        }
+    }
+    const postTypes = merged['postTypes'];
+    if (Array.isArray(postTypes)) {
+        for (const postType of postTypes) {
+            if (!isRecord(postType) || !isString(postType['key']) || !isString(postType['label'])) {
+                issues.push('postType missing valid key/label');
+            }
+        }
+    }
+    const taxonomies = merged['taxonomies'];
+    if (Array.isArray(taxonomies)) {
+        for (const taxonomy of taxonomies) {
+            if (!isRecord(taxonomy) || !isString(taxonomy['key']) || !isString(taxonomy['label']) || !Array.isArray(taxonomy['postTypes'])) {
+                issues.push('taxonomy missing valid key/label/postTypes');
+            }
+        }
+    }
+    const scheduleJobs = merged['scheduleJobs'];
+    if (Array.isArray(scheduleJobs)) {
+        for (const job of scheduleJobs) {
+            if (!isRecord(job) || !isString(job['name'])) {
+                issues.push('scheduleJob missing a name');
+                continue;
+            }
+            const hasEvery = typeof job['every'] === 'number' && job['every'] > 0;
+            const hasCron = isString(job['cron']);
+            if (hasEvery === hasCron) {
+                issues.push(`scheduleJob "${job['name']}" requires exactly one of: every | cron`);
+            }
+        }
+    }
+    const httpPolicy = merged['httpPolicy'];
+    if (httpPolicy !== undefined) {
+        if (!isRecord(httpPolicy)) {
+            issues.push('httpPolicy invalid');
+        }
+        else if (httpPolicy['allowHosts'] !== undefined && !Array.isArray(httpPolicy['allowHosts'])) {
+            issues.push('httpPolicy.allowHosts must be an array of hosts');
+        }
+    }
+    const rateLimit = merged['rateLimit'];
+    if (rateLimit !== undefined) {
+        if (!isRecord(rateLimit)) {
+            issues.push('rateLimit invalid');
+        }
+        else if (rateLimit['rpm'] !== undefined && !(typeof rateLimit['rpm'] === 'number' && rateLimit['rpm'] > 0)) {
+            issues.push('rateLimit.rpm must be a positive number');
+        }
+    }
+    const migrations = merged['migrations'];
+    if (migrations !== undefined) {
+        if (!Array.isArray(migrations) || !migrations.every(isString)) {
+            issues.push('migrations must be an array of valid SQL paths');
+        }
+        else if (migrations.some((path) => path.includes('..') || path.startsWith('/'))) {
+            issues.push('migrations with paths outside the plugin directory');
+        }
+    }
+    // Declarative admin UI slots (FEAT-098 / DECI-027): identity is mandatory,
+    // capability is mandatory on menus (slot-level capability gating) and
+    // metaBoxes need a non-empty screens array. context/priority/render/mode,
+    // when present, must be known values (the endpoint merge applies defaults).
+    const admin = merged['admin'];
+    if (admin !== undefined) {
+        if (!isRecord(admin)) {
+            issues.push('admin must be an object');
+        }
+        else {
+            const checkList = (key, fields) => {
+                const list = admin[key];
+                if (list === undefined)
+                    return;
+                if (!Array.isArray(list)) {
+                    issues.push(`admin.${key} must be an array`);
+                    return;
+                }
+                list.forEach((entry, index) => {
+                    if (!isRecord(entry) || fields.some((field) => !isString(entry[field]) || entry[field].length === 0)) {
+                        issues.push(`admin.${key}[${index}] missing valid ${fields.join('/')}`);
+                    }
+                });
+            };
+            checkList('menuPages', ['slug', 'label', 'capability']);
+            checkList('submenuPages', ['parentSlug', 'slug', 'label', 'capability']);
+            checkList('dashboardWidgets', ['id', 'title', 'componentId']);
+            checkList('metaBoxes', ['id', 'title', 'componentId']);
+            checkList('columns', ['contentType', 'key', 'label']);
+            checkList('columnRenderers', ['contentType', 'key', 'componentId']);
+            checkList('actionLinks', ['label', 'url']);
+            checkList('editors', ['id', 'componentId', 'mode']);
+            const notices = admin['notices'];
+            if (notices !== undefined) {
+                if (!Array.isArray(notices)) {
+                    issues.push('admin.notices must be an array');
+                }
+                else {
+                    notices.forEach((entry, index) => {
+                        if (!isRecord(entry) || !isString(entry['message'])) {
+                            issues.push(`admin.notices[${index}] missing message`);
+                        }
+                        else if (!['info', 'success', 'warning', 'error'].includes(String(entry['level']))) {
+                            issues.push(`admin.notices[${index}].level invalid`);
+                        }
+                    });
+                }
+            }
+            const metaBoxes = admin['metaBoxes'];
+            if (Array.isArray(metaBoxes)) {
+                metaBoxes.forEach((entry, index) => {
+                    if (!isRecord(entry))
+                        return;
+                    const screens = entry['screens'];
+                    if (!Array.isArray(screens) || screens.length === 0 || !screens.every(isString)) {
+                        issues.push(`admin.metaBoxes[${index}].screens must be a non-empty array of strings`);
+                    }
+                    if (entry['context'] !== undefined && !['normal', 'side', 'advanced'].includes(String(entry['context']))) {
+                        issues.push(`admin.metaBoxes[${index}].context invalid`);
+                    }
+                    if (entry['priority'] !== undefined && !['high', 'default', 'low'].includes(String(entry['priority']))) {
+                        issues.push(`admin.metaBoxes[${index}].priority invalid`);
+                    }
+                });
+            }
+            const widgets = admin['dashboardWidgets'];
+            if (Array.isArray(widgets)) {
+                widgets.forEach((entry, index) => {
+                    if (isRecord(entry) && entry['render'] !== undefined && entry['render'] !== 'component') {
+                        issues.push(`admin.dashboardWidgets[${index}].render invalid (expected "component")`);
+                    }
+                });
+            }
+            const editors = admin['editors'];
+            if (Array.isArray(editors)) {
+                editors.forEach((entry, index) => {
+                    if (!isRecord(entry))
+                        return;
+                    const screens = entry['screens'];
+                    if (!Array.isArray(screens) || screens.length === 0 || !screens.every(isString)) {
+                        issues.push(`admin.editors[${index}].screens must be a non-empty array of strings`);
+                    }
+                    if (entry['mode'] !== undefined && !['replace-body', 'below'].includes(String(entry['mode']))) {
+                        issues.push(`admin.editors[${index}].mode invalid (expected "replace-body" or "below")`);
+                    }
+                    if (entry['priority'] !== undefined && !(typeof entry['priority'] === 'number')) {
+                        issues.push(`admin.editors[${index}].priority must be a number`);
+                    }
+                });
+            }
+        }
+    }
+    return issues;
+}
 async function readJson(dir, file) {
     try {
         const raw = await readFile(join(dir, file), 'utf8');
@@ -28,11 +226,11 @@ async function readJson(dir, file) {
     }
 }
 /**
- * Lê o manifesto de um diretório de plugin com precedência única.
+ * Reads a plugin directory's manifest with a single precedence rule.
  *
- * @param dir diretório do plugin
+ * @param dir the plugin directory
  * @param options.strict exige `main` e valida `type === 'plugin'` quando
- *        declarado (usado por sync/instalação/CLI)
+ *        declared (used by sync/install/CLI)
  */
 export async function readPluginManifest(dir, options = {}) {
     const canonical = await readJson(dir, 'manifest.json');
@@ -51,12 +249,24 @@ export async function readPluginManifest(dir, options = {}) {
         issues.push('manifest sem "version"');
     const type = merged['type'];
     if (type !== undefined && type !== 'plugin') {
-        issues.push(`type "${String(type)}" não é "plugin"`);
+        issues.push(`type "${String(type)}" is not "plugin"`);
     }
     const main = merged['main'];
     if (options.strict && typeof main !== 'string') {
         issues.push('manifest sem "main" (entrypoint)');
     }
+    // v2 schema fields: in strict mode (sync/install) they block; in the
+    // loader (runtime) they only warn — a plugin with a malformed v2 field
+    // must not prevent the other plugins from booting.
+    const v2Issues = validateManifestV2(merged);
+    if (options.strict) {
+        issues.push(...v2Issues);
+    }
+    else {
+        for (const issue of v2Issues) {
+            console.warn(`[manifest] ${merged['name'] ?? '?'}: ${issue}`);
+        }
+    }
     if (issues.length > 0) {
         return { manifest: null, source, issues };
     }
@@ -67,8 +277,8 @@ export async function readPluginManifest(dir, options = {}) {
     };
 }
 /**
- * Normaliza o manifesto para gravação no banco (mantém só campos conhecidos,
- * preservando campos extras legítimos do autor).
+ * Normalizes the manifest for database storage (keeps only known fields,
+ * preserving the author's legitimate extra fields).
  */
 export function normalizePluginManifest(manifest) {
     return manifest;

package/dist/manifest.js.map

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

package/dist/plugin-api.d.ts

@@ -1,23 +1,23 @@
 import type { HookRegistryLike } from '@oktis-works/plugin-sdk';
-import type { PluginManifest, PluginFieldTypeManifest } from '@oktis-works/plugin-sdk';
-/** Contexto disponível para o plugin em cada execução de hook. */
+import type { PluginManifest, PluginFieldTypeManifest, PluginPostTypeDeclaration, PluginTaxonomyDeclaration, PluginBlockManifest, PluginPatternManifest, PluginCacheApi, PluginJobsApi, PluginJobHandler, PluginHttpApi, PluginAdminApi, PluginRolesApi, PluginAssetsApi, PluginI18nApi, PluginHealthApi, PluginHealthCheck, PluginMailApi, PluginContentApi, EnqueuedAsset, AdminExtensionsState } from '@oktis-works/plugin-sdk';
+/** Context available to the plugin on every hook execution. */
 export interface PluginContext {
     tenantId: string;
     userId: string;
     requestId: string;
     api: PluginAPI;
 }
-/** Definição de rota registrada pelo plugin. */
+/** Route definition registered by the plugin. */
 export interface RouteDefinition {
     method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS';
     path: string;
     handler: (c: any, api: PluginAPI) => Promise<Response> | Response;
     /** Middlewares opcionais (ex.: auth, rate-limit). */
     middleware?: Array<(c: any, next: () => Promise<void>) => Promise<void>>;
-    /** Permissões exigidas para acessar esta rota. */
+    /** Permissions required to access this route. */
     requiredPermissions?: string[];
 }
-/** Configuração do tenant (para getTenant). */
+/** Tenant configuration (for getTenant). */
 export interface TenantInfo {
     id: string;
     name: string;
@@ -25,20 +25,20 @@ export interface TenantInfo {
     domain?: string | null;
     subdomain?: string | null;
 }
-/** Info do usuário (para getUser). */
+/** User info (for getUser). */
 export interface UserInfo {
     id: string;
     email: string;
     name: string;
     roles?: string[];
 }
-/** API exposta aos plugins — implementada pelo core e passada via factory. */
+/** API exposed to plugins — implemented by the core and passed via the factory. */
 export interface PluginAPI {
-    /** Registra hook de lifecycle (onInstall, onActivate, etc.). */
+    /** Registers a lifecycle hook (onInstall, onActivate, etc.). */
     registerHook(type: string, handler: (context: PluginContext, payload: unknown) => void | Promise<void>): void;
-    /** Registra rota HTTP exposta pelo plugin. */
+    /** Registers an HTTP route exposed by the plugin. */
     addRoute(route: RouteDefinition): void;
-    /** Registra campo de conteúdo customizado. */
+    /** Registers a custom content field. */
     addContentField(field: {
         name: string;
         type: string;
@@ -46,21 +46,49 @@ export interface PluginAPI {
         required?: boolean;
         options?: Record<string, unknown>;
     }): void;
-    /** Registra um novo tipo de campo customizado. */
+    /** Registers a new custom field type. */
     addFieldType(definition: PluginFieldTypeManifest): void;
-    /** Lê setting do tenant (group/key). */
+    /** Registers a Custom Post Type (permission post-types:register). */
+    addPostType(declaration: PluginPostTypeDeclaration): void;
+    /** Registers a Custom Taxonomy (permission taxonomies:register). */
+    addTaxonomy(declaration: PluginTaxonomyDeclaration): void;
+    /** Registers an editor block (permission blocks:register). Data plane: no table — lives while the plugin is active. */
+    registerBlock(block: PluginBlockManifest): void;
+    /** Registers an editor pattern (permission patterns:register). Data plane: no table — lives while the plugin is active. */
+    registerPattern(pattern: PluginPatternManifest): void;
+    /** Per-plugin cache/transient (permissions cache:read/cache:write). */
+    readonly cache: PluginCacheApi;
+    /** Per-plugin jobs/cron (permission jobs:schedule). */
+    readonly jobs: PluginJobsApi;
+    /** External HTTP protected against SSRF (permission http:outbound). */
+    readonly http: PluginHttpApi;
+    /** Slots declarativos do admin (FEAT-098 / DECI-027). */
+    readonly admin: PluginAdminApi;
+    /** Tenant role management (Item 6 — tenant scope, anti-escalation, audit). */
+    readonly roles: PluginRolesApi;
+    /** Public-site asset enqueue (Item 8 — permission assets:enqueue). */
+    readonly assets: PluginAssetsApi;
+    /** Server-side translations (Item 9 — fallback chain locale → base → en). */
+    readonly i18n: PluginI18nApi;
+    /** Health checks aggregated in /health (Item 14 — permission health:register). */
+    readonly health: PluginHealthApi;
+    /** Mail sending via the outbox (Item 12 — permission mail:send). */
+    readonly mail: PluginMailApi;
+    /** Typed content query builder (Item 22 — permission db:query). */
+    readonly content: PluginContentApi;
+    /** Reads a tenant setting (group/key). */
     getSetting(key: string, group?: string): Promise<unknown>;
-    /** Escreve setting do tenant. */
+    /** Writes a tenant setting. */
     setSetting(key: string, value: unknown, group?: string): Promise<void>;
-    /** Info do tenant atual. */
+    /** Current tenant info. */
     getTenant(): Promise<TenantInfo>;
-    /** Info do usuário atual. */
+    /** Current user info. */
     getUser(): Promise<UserInfo>;
-    /** Executa SQL no schema do plugin + RLS do tenant (WP8). */
+    /** Executes SQL with tenant RLS (WP8). */
     query(sql: string, params?: unknown[]): Promise<unknown[]>;
-    /** Emite evento no barramento interno. */
+    /** Emits an event on the internal bus. */
     emit(eventType: string, payload: Record<string, unknown>): Promise<void>;
-    /** Hooks WordPress-style (actions/filters) — mantido para compat. */
+    /** WordPress-style hooks (actions/filters) — kept for compatibility. */
     addAction(action: string, callback: (...args: unknown[]) => unknown, options?: {
         priority?: number;
         acceptedArgs?: number;
@@ -76,18 +104,18 @@ export interface PluginAPI {
     didAction(action: string): number;
     currentHook(): string | null;
 }
-/** Dependências que o core deve prover para criar a API real. */
+/** Dependencies the core must provide to create the real API. */
 export interface PluginApiDependencies {
-    /** Registry de hooks do escopo (tenant ou platform). */
+    /** Hook registry of the scope (tenant or platform). */
     hooks: HookRegistryLike;
-    /** Manifesto do plugin (para validar permissões no query). */
+    /** Plugin manifest (to validate permissions on query). */
     manifest: PluginManifest;
-    /** Serviço de settings (get/set por grupo/key). */
+    /** Settings service (get/set by group/key). */
     settings: {
         get(key: string, group?: string): Promise<unknown>;
         set(key: string, value: unknown, group?: string): Promise<void>;
     };
-    /** Bus de eventos interno. */
+    /** Internal event bus. */
     eventBus: {
         emit(event: {
             id: string;
@@ -100,23 +128,23 @@ export interface PluginApiDependencies {
             createdAt: Date;
         }): Promise<void>;
     };
-    /** Conexão PostgreSQL com RLS já configurado para o tenant. */
+    /** PostgreSQL connection with RLS already configured for the tenant. */
     db: {
         query(sql: string, params?: unknown[]): Promise<unknown[]>;
     };
-    /** Resolvedor do tenantId atual (ALS). */
+    /** Current tenantId resolver (ALS). */
     getTenantId: () => string | null;
-    /** Resolvedor do userId atual (ALS). */
+    /** Current userId resolver (ALS). */
     getUserId: () => string | null;
-    /** Resolvedor do requestId atual (ALS). */
+    /** Current requestId resolver (ALS). */
     getRequestId: () => string | null;
-    /** Consulta tenant por id (para getTenant). */
+    /** Tenant lookup by id (for getTenant). */
     getTenantById: (id: string) => Promise<TenantInfo | null>;
-    /** Consulta usuário por id (para getUser). */
+    /** User lookup by id (for getUser). */
     getUserById: (id: string) => Promise<UserInfo | null>;
-    /** Registra rotas do plugin (o core monta no router da API). */
+    /** Registers plugin routes (the core mounts them on the API router). */
     registerRoutes: (routes: RouteDefinition[]) => void;
-    /** Registra campos de conteúdo do plugin (o core expõe via field-groups). */
+    /** Registers plugin content fields (the core exposes them via field groups). */
     registerContentFields: (fields: Array<{
         name: string;
         type: string;
@@ -124,21 +152,113 @@ export interface PluginApiDependencies {
         required?: boolean;
         options?: Record<string, unknown>;
     }>) => void;
-    /** Registra tipos de campo do plugin (o core expõe via registry). */
+    /** Registers plugin field types (the core exposes them via the registry). */
     registerFieldTypes: (fieldTypes: PluginFieldTypeManifest[]) => void;
-    /** Permissões concedidas ao plugin (policy já resolvida). */
+    /** Registers plugin Custom Post Types (the core persists via postTypeRegistry). */
+    registerPostTypes?: (postTypes: Array<PluginPostTypeDeclaration & {
+        pluginName: string;
+    }>) => void;
+    /** Registers plugin Custom Taxonomies (the core persists via taxonomyService). */
+    registerTaxonomies?: (taxonomies: Array<PluginTaxonomyDeclaration & {
+        pluginName: string;
+    }>) => void;
+    /**
+     * Core cache backend (Redis/memory) — RAW operations, no namespace (the
+     * plugin/tenant namespace and tags belong to the PluginAPI).
+     * Absent → per-process memory fallback (dev/legacy, never throws).
+     */
+    cache?: {
+        get<T>(key: string): Promise<T | null>;
+        set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+        del(key: string): Promise<void>;
+    };
+    /**
+     * Core jobs backend (`plugins` queue). Absent → schedule/enqueue/cancel
+     * return false (optional queue, never throws — degradation A3).
+     */
+    jobs?: {
+        schedule(jobName: string, spec: {
+            every?: number;
+            cron?: string;
+        }, ctx: {
+            pluginName: string;
+            tenantId: string | null;
+        }): Promise<boolean>;
+        cancel(jobName: string, ctx: {
+            pluginName: string;
+            tenantId: string | null;
+        }): Promise<boolean>;
+        enqueue(jobName: string, payload: Record<string, unknown>, ctx: {
+            pluginName: string;
+            tenantId: string | null;
+        }): Promise<boolean>;
+    };
+    /** Permissions granted to the plugin (already-resolved policy). */
     allowedPermissions: string[];
+    /**
+     * Backend de roles do core (Item 6 — persiste + audita com anti-escalada).
+     * Absent → api.roles throws a clear error (backend not wired).
+     */
+    roles?: {
+        add(input: {
+            tenantId: string;
+            pluginName: string;
+            name: string;
+            slug?: string;
+            permissions?: string[];
+        }): Promise<{
+            id: string;
+            name: string;
+            slug: string;
+            permissions: string[];
+        }>;
+        remove(input: {
+            tenantId: string;
+            pluginName: string;
+            slug: string;
+        }): Promise<boolean>;
+        addPermission(input: {
+            tenantId: string;
+            pluginName: string;
+            slug: string;
+            permission: string;
+        }): Promise<boolean>;
+    };
+    /**
+     * Backend de mail do core (Item 12 — outbox + rate limit + audit).
+     * Absent → api.mail.send returns false (queue unavailable, like jobs).
+     */
+    mail?: {
+        send(input: {
+            tenantId: string | null;
+            pluginName: string;
+            to: string;
+            subject: string;
+            html?: string;
+            text?: string;
+            template?: string;
+            params?: Record<string, unknown>;
+        }): Promise<boolean>;
+    };
+    /**
+     * Audit backend (Item 18 — sensitive plugin operations → audit_log).
+     * Ausente → sem auditoria (degrada silenciosamente, nunca bloqueia).
+     */
+    audit?: {
+        record(entry: {
+            tenantId?: string | null;
+            action: string;
+            resourceType: string;
+            resourceId?: string;
+            changes?: Record<string, unknown>;
+        }): Promise<void>;
+    };
 }
-/**
- * Cria a PluginAPI real a partir das dependências do core.
- * Chamado pelo core no bootstrap (não pelo plugin-runtime diretamente).
- * Retorna { api: PluginAPI, internal: PluginApiInternal } para separar a API pública dos detalhes internos.
- */
 export declare function createPluginApi(deps: PluginApiDependencies): {
     api: PluginAPI;
     internal: PluginApiInternal;
 };
-/** Tipo para o core acessar as rotas/campos registrados internamente. */
+/** Type for the core to access internally registered routes/fields. */
 export interface PluginApiInternal {
     getRoutes: () => RouteDefinition[];
     getFields: () => Array<{
@@ -152,5 +272,30 @@ export interface PluginApiInternal {
         pluginName: string;
         isPluginType: true;
     }>;
+    getPostTypes: () => Array<PluginPostTypeDeclaration & {
+        pluginName: string;
+    }>;
+    getTaxonomies: () => Array<PluginTaxonomyDeclaration & {
+        pluginName: string;
+    }>;
+    /** Job handlers declared via api.jobs.on (dispatched by the worker). */
+    getJobHandlers: () => Map<string, PluginJobHandler>;
+    /** Declarative slots registered at runtime via api.admin.*. */
+    getAdminState: () => AdminExtensionsState;
+    /** Blocos do editor registrados em runtime via api.registerBlock. */
+    getBlocks: () => Array<PluginBlockManifest & {
+        pluginName: string;
+    }>;
+    /** Patterns do editor registrados em runtime via api.registerPattern. */
+    getPatterns: () => Array<PluginPatternManifest & {
+        pluginName: string;
+    }>;
+    /** Assets enfileirados em runtime via api.assets (Item 8). */
+    getEnqueuedAssets: () => EnqueuedAsset[];
+    /** Health checks registrados em runtime via api.health (Item 14). */
+    getHealthChecks: () => Array<{
+        name: string;
+        check: PluginHealthCheck;
+    }>;
 }
 //# sourceMappingURL=plugin-api.d.ts.map