@coffer-org/server 1.1.0

package/dist/mutate.js

@@ -0,0 +1,128 @@
+/**
+ * ЄДИНИЙ ШЛЯХ ЗАПИСУ. Усі мутації проходять тут.
+ * validate (Zod) → транзакція → append-only audit (_events).
+ */
+import { randomUUID } from 'node:crypto';
+import { serialize } from '@mikro-orm/core';
+import { buildZodObject, buildZodObjectPartial } from '@coffer-org/sdk/module';
+import { getEm } from './db.js';
+import { encodeTemporal, decodeTemporal } from './temporal.js';
+import { splitCollections, writeCollections, deleteCollections, flattenEmbedded, nestEmbedded, readCollections, } from './collection-io.js';
+function nowIso() {
+    return new Date().toISOString();
+}
+export class ValidationError extends Error {
+    issues;
+    constructor(issues) {
+        super('validation');
+        this.issues = issues;
+        this.name = 'ValidationError';
+    }
+}
+export class NotFoundError extends Error {
+    constructor() {
+        super('Не знайдено');
+        this.name = 'NotFoundError';
+    }
+}
+function toIssue(i) {
+    const field = String(i.path[0] ?? '');
+    try {
+        const m = JSON.parse(i.message);
+        if (typeof m.code === 'string')
+            return { field, code: m.code, params: m.params };
+    }
+    catch {
+        /* не-vmsg повідомлення від zod */
+    }
+    return { field, code: 'invalid' };
+}
+function writeEvent(em, actor, op, type, recordId, before, after) {
+    em.create('_Event', {
+        id: randomUUID(),
+        ts: nowIso(),
+        actor,
+        op,
+        type,
+        record_id: recordId,
+        before: before == null ? null : JSON.stringify(before),
+        after: after == null ? null : JSON.stringify(after),
+    });
+}
+// ─── READ ─────────────────────────────────────────────────────────────────────
+export async function listRecords(entityName) {
+    const fork = getEm().fork();
+    const rows = await fork.findAll(entityName);
+    return serialize(rows);
+}
+export async function getRecord(m, entityName, id) {
+    const fork = getEm().fork();
+    const row = await fork.findOne(entityName, { id });
+    if (!row)
+        return undefined;
+    const flat = decodeTemporal(m, serialize(row));
+    const nested = nestEmbedded(m, flat);
+    const collections = await readCollections(fork, m, id);
+    return { ...nested, ...collections };
+}
+// ─── CREATE ───────────────────────────────────────────────────────────────────
+export async function createRecord(m, entityName, input, ctx) {
+    const rawInput = (input ?? {});
+    const parsed = buildZodObject(m).safeParse(input);
+    if (!parsed.success)
+        throw new ValidationError(parsed.error.issues.map(toIssue));
+    const id = typeof rawInput.id === 'string' && rawInput.id ? rawInput.id : randomUUID();
+    const ts = nowIso();
+    const { base, collections } = splitCollections(m, { ...parsed.data });
+    const row = flattenEmbedded(m, { id, ...base, created_at: ts, updated_at: ts });
+    const dbRow = encodeTemporal(m, row);
+    await getEm()
+        .fork()
+        .transactional(async (tx) => {
+        await tx.upsert(entityName, dbRow);
+        await writeCollections(tx, m, id, collections);
+        writeEvent(tx, ctx.actor, 'create', `${m.vault}/${m.module}`, id, null, { ...parsed.data, id });
+    });
+    return { ...parsed.data, id, created_at: ts, updated_at: ts };
+}
+// ─── UPDATE ───────────────────────────────────────────────────────────────────
+export async function updateRecord(m, entityName, id, input, ctx) {
+    const parsed = buildZodObjectPartial(m).safeParse(input);
+    if (!parsed.success)
+        throw new ValidationError(parsed.error.issues.map(toIssue));
+    let result;
+    await getEm()
+        .fork()
+        .transactional(async (tx) => {
+        const found = await tx.findOne(entityName, { id });
+        if (!found)
+            throw new NotFoundError();
+        const existingFlat = decodeTemporal(m, serialize(found));
+        const existing = nestEmbedded(m, existingFlat);
+        const ts = nowIso();
+        const { base, collections } = splitCollections(m, { ...parsed.data });
+        const merged = { ...existing, ...base };
+        const dbRow = encodeTemporal(m, flattenEmbedded(m, { ...merged, updated_at: ts }));
+        await tx.upsert(entityName, dbRow);
+        await writeCollections(tx, m, id, collections);
+        const after = { ...merged, ...collections, updated_at: ts };
+        writeEvent(tx, ctx.actor, 'update', `${m.vault}/${m.module}`, id, existing, after);
+        result = after;
+    });
+    return result;
+}
+// ─── DELETE ───────────────────────────────────────────────────────────────────
+export async function deleteRecord(m, entityName, id, ctx) {
+    await getEm()
+        .fork()
+        .transactional(async (tx) => {
+        const found = await tx.findOne(entityName, { id });
+        if (!found)
+            throw new NotFoundError();
+        const existing = serialize(found);
+        await deleteCollections(tx, m, id);
+        tx.remove(found);
+        writeEvent(tx, ctx.actor, 'delete', `${m.vault}/${m.module}`, id, existing, null);
+    });
+}
+//# sourceMappingURL=mutate.js.map

package/dist/mutate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutate.js","sourceRoot":"","sources":["../src/mutate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,SAAS,MAAM;IACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAYD,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACrB;IAAnB,YAAmB,MAAyB;QAC1C,KAAK,CAAC,YAAY,CAAC,CAAC;QADH,WAAM,GAAN,MAAM,CAAmB;QAE1C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AACD,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC;QACE,KAAK,CAAC,aAAa,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,SAAS,OAAO,CAAC,CAAa;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAuD,CAAC;QACtF,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACnF,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,UAAU,CACjB,EAAiB,EACjB,KAAa,EACb,EAAU,EACV,IAAY,EACZ,QAAgB,EAChB,MAAe,EACf,KAAc;IAEd,EAAE,CAAC,MAAM,CACP,QAAiB,EACjB;QACE,EAAE,EAAE,UAAU,EAAE;QAChB,EAAE,EAAE,MAAM,EAAE;QACZ,KAAK;QACL,EAAE;QACF,IAAI;QACJ,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QACtD,KAAK,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;KAC3C,CACX,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAAkB;IAClD,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAmB,CAAC,CAAC;IACrD,OAAO,SAAS,CAAC,IAAI,CAA8B,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,CAAY,EACZ,UAAkB,EAClB,EAAU;IAEV,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAmB,EAAE,EAAE,EAAE,EAAW,CAAC,CAAC;IACrE,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,CAA4B,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACvD,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;AACvC,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,CAAY,EACZ,UAAkB,EAClB,KAAc,EACd,GAAc;IAEd,MAAM,QAAQ,GAAG,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;IAC1D,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjF,MAAM,EAAE,GAAG,OAAO,QAAQ,CAAC,EAAE,KAAK,QAAQ,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;IACvF,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,gBAAgB,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,GAAG,GAAG,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAErC,MAAM,KAAK,EAAE;SACV,IAAI,EAAE;SACN,aAAa,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QAC1B,MAAM,EAAE,CAAC,MAAM,CAAC,UAAmB,EAAE,KAAc,CAAC,CAAC;QACrD,MAAM,gBAAgB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;QAC/C,UAAU,CAAC,EAAE,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;IACL,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAA6B,CAAC;AAC3F,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,CAAY,EACZ,UAAkB,EAClB,EAAU,EACV,KAAc,EACd,GAAc;IAEd,MAAM,MAAM,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjF,IAAI,MAAgC,CAAC;IACrC,MAAM,KAAK,EAAE;SACV,IAAI,EAAE;SACN,aAAa,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAmB,EAAE,EAAE,EAAE,EAAW,CAAC,CAAC;QACrE,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,aAAa,EAAE,CAAC;QACtC,MAAM,YAAY,GAAG,cAAc,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAA4B,CAAC,CAAC;QACpF,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QAC/C,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,gBAAgB,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,cAAc,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACnF,MAAM,EAAE,CAAC,MAAM,CAAC,UAAmB,EAAE,KAAc,CAAC,CAAC;QACrD,MAAM,gBAAgB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAC5D,UAAU,CAAC,EAAE,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QACnF,MAAM,GAAG,KAAgC,CAAC;IAC5C,CAAC,CAAC,CAAC;IACL,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,CAAY,EAAE,UAAkB,EAAE,EAAU,EAAE,GAAc;IAC7F,MAAM,KAAK,EAAE;SACV,IAAI,EAAE;SACN,aAAa,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAmB,EAAE,EAAE,EAAE,EAAW,CAAC,CAAC;QACrE,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,aAAa,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAA4B,CAAC;QAC7D,MAAM,iBAAiB,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACnC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjB,UAAU,CAAC,EAAE,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/plugin-discovery.d.ts

@@ -0,0 +1,36 @@
+import type { PluginManifest } from '@coffer-org/sdk/plugin';
+import type { PluginHooks } from './plugin-hooks.js';
+export interface PluginAssetPaths {
+    schema: string;
+    web?: string;
+    css?: string;
+}
+export interface PluginAssetUrls {
+    schema: string;
+    web?: string;
+    css?: string;
+}
+/** Maps a plugin's published `coffer` asset paths to host-served URLs.
+ *  The relative path's basename is fixed by convention (schema.js/web.js/web.css);
+ *  the actual file is read from node_modules by the static handler. */
+export declare function resolveAssetUrls(id: string, coffer: PluginAssetPaths): PluginAssetUrls;
+export interface PluginAssetRecord {
+    id: string;
+    version: string;
+    dependsOn: string[];
+    packageName: string;
+    schema: string;
+    web?: string;
+    css?: string;
+}
+export declare function discoverPluginAssets(): Promise<PluginAssetRecord[]>;
+/** Усі знайдені плагіни. Порядок неважливий — composeRegistry резолвить за dependsOn. */
+export declare function discoverPlugins(): Promise<PluginManifest[]>;
+/**
+ * Збирає серверні хуки наявних плагінів. Плагін із runtime-входом
+ * (package.json `coffer.server` або `exports["./runtime"]`) може експортувати
+ * `serverHooks: PluginHooks`. Імпорт — через ЗМІННИЙ специфікатор, тож tsc НЕ тягне
+ * plugin-src у серверну програму (розрив циклу server↔плагіни).
+ */
+export declare function loadServerHooks(): Promise<Record<string, PluginHooks>>;
+//# sourceMappingURL=plugin-discovery.d.ts.map

package/dist/plugin-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-discovery.d.ts","sourceRoot":"","sources":["../src/plugin-discovery.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAqBrD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;uEAEuE;AACvE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,eAAe,CAMtF;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA6BzE;AAkBD,yFAAyF;AACzF,wBAAsB,eAAe,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAYjE;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAqB5E"}

package/dist/plugin-discovery.js

@@ -0,0 +1,137 @@
+/**
+ * Рантайм-виявлення плагінів: скан node_modules на @coffer-org/plugin-* та
+ * coffer-plugin-*. Кожен пакет постачає PluginManifest (default-export schema-entry).
+ * Один битий плагін логиться й пропускається — інстанс не падає (trust=none маркетплейс).
+ */
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+async function pkgNames(nm) {
+    const names = [];
+    try {
+        for (const d of await readdir(join(nm, '@coffer-org'))) {
+            if (d.startsWith('plugin-'))
+                names.push(`@coffer-org/${d}`);
+        }
+    }
+    catch {
+        /* немає @coffer-скоупу — ок */
+    }
+    try {
+        for (const d of await readdir(nm)) {
+            if (d.startsWith('coffer-plugin-'))
+                names.push(d);
+        }
+    }
+    catch {
+        /* немає node_modules — ок */
+    }
+    return names;
+}
+/** Maps a plugin's published `coffer` asset paths to host-served URLs.
+ *  The relative path's basename is fixed by convention (schema.js/web.js/web.css);
+ *  the actual file is read from node_modules by the static handler. */
+export function resolveAssetUrls(id, coffer) {
+    const base = `/plugins/${id}`;
+    const out = { schema: `${base}/schema.js` };
+    if (coffer.web)
+        out.web = `${base}/web.js`;
+    if (coffer.css)
+        out.css = `${base}/web.css`;
+    return out;
+}
+export async function discoverPluginAssets() {
+    const nm = join(process.cwd(), 'node_modules');
+    const names = await pkgNames(nm);
+    const out = [];
+    for (const name of names) {
+        try {
+            const pkg = JSON.parse(await readFile(join(nm, name, 'package.json'), 'utf8'));
+            if (!pkg.coffer?.schema)
+                continue;
+            const spec = pathToFileURL(join(nm, name, pkg.coffer.schema)).href;
+            const manifest = (await import(spec)).default;
+            if (!manifest?.id)
+                continue;
+            const urls = resolveAssetUrls(manifest.id, pkg.coffer);
+            out.push({
+                id: manifest.id,
+                version: pkg.version ?? '0.0.0',
+                dependsOn: manifest.dependsOn ?? [],
+                packageName: name,
+                schema: urls.schema,
+                web: urls.web,
+                css: urls.css,
+            });
+        }
+        catch (e) {
+            console.error(`[discovery] ${name}: asset scan skip — ${e.message}`);
+        }
+    }
+    return out;
+}
+async function loadManifest(nm, name) {
+    try {
+        const pkg = JSON.parse(await readFile(join(nm, name, 'package.json'), 'utf8'));
+        const schemaRel = pkg?.coffer?.schema;
+        const spec = schemaRel ? pathToFileURL(join(nm, name, schemaRel)).href : name;
+        const mod = (await import(spec));
+        const manifest = mod.default;
+        if (manifest && typeof manifest.id === 'string')
+            return manifest;
+        console.warn(`[discovery] ${name}: немає валідного default-маніфесту, пропуск`);
+        return null;
+    }
+    catch (e) {
+        console.error(`[discovery] ${name}: збій імпорту, пропуск — ${e.message}`);
+        return null;
+    }
+}
+/** Усі знайдені плагіни. Порядок неважливий — composeRegistry резолвить за dependsOn. */
+export async function discoverPlugins() {
+    // Скануємо node_modules коренем інстансу (cwd): сервер запускається з кореня,
+    // npm workspaces хостить пакети у корене́вий node_modules. Запуск із packages/server
+    // дивився б у локальний node_modules і не побачив би хостовані плагіни.
+    const nm = join(process.cwd(), 'node_modules');
+    const names = await pkgNames(nm);
+    const manifests = [];
+    for (const name of names) {
+        const m = await loadManifest(nm, name);
+        if (m)
+            manifests.push(m);
+    }
+    return manifests;
+}
+/**
+ * Збирає серверні хуки наявних плагінів. Плагін із runtime-входом
+ * (package.json `coffer.server` або `exports["./runtime"]`) може експортувати
+ * `serverHooks: PluginHooks`. Імпорт — через ЗМІННИЙ специфікатор, тож tsc НЕ тягне
+ * plugin-src у серверну програму (розрив циклу server↔плагіни).
+ */
+export async function loadServerHooks() {
+    const nm = join(process.cwd(), 'node_modules');
+    const names = await pkgNames(nm);
+    const hooks = {};
+    for (const name of names) {
+        try {
+            const pkg = JSON.parse(await readFile(join(nm, name, 'package.json'), 'utf8'));
+            const serverRel = pkg?.coffer?.server;
+            const hasRuntime = Boolean(serverRel) || Boolean(pkg?.exports?.['./runtime']);
+            if (!hasRuntime)
+                continue;
+            const manifest = (await import(name)).default;
+            const id = manifest?.id;
+            if (!id)
+                continue;
+            const spec = serverRel ? pathToFileURL(join(nm, name, serverRel)).href : `${name}/runtime`;
+            const mod = (await import(spec));
+            if (mod.serverHooks)
+                hooks[id] = mod.serverHooks;
+        }
+        catch (e) {
+            console.error(`[discovery] ${name}: серверні хуки не завантажено — ${e.message}`);
+        }
+    }
+    return hooks;
+}
+//# sourceMappingURL=plugin-discovery.js.map

package/dist/plugin-discovery.js.map

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

package/dist/plugin-hooks.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Серверні хуки життєвого циклу плагінів (server-only).
+ *
+ * Маніфест плагіна (@coffer-org/sdk/plugin) — ізоморфний і НЕ містить функцій (щоб не тягнути
+ * серверні залежності у чисте ядро). Усе, що стосується сервера — міграції/seed/init/teardown —
+ * реєструється тут, по id плагіна.
+ *
+ *   pluginHooks['people'] = {
+ *     seed:     async (ctx) => { ... ідемпотентне наповнення ... },
+ *     init:     async (ctx) => { ... запуск воркерів/перевірки ... },
+ *     teardown: async (ctx) => { ... зняття (м'яке: лише cleanup стану) ... },
+ *   };
+ *
+ * teardown за рішенням — М'ЯКЕ: таблиці/дані лишаються в БД,
+ * плагін лише вимикається. ctx.em — fork-нутий EntityManager для seed/init операцій.
+ *
+ * Реальні хуки оголошуються у самих плагінах (serverHooks) і збираються
+ * генерично через loadServerHooks() — тут лише контракт і порожній реєстр.
+ */
+import type { EntityManager } from '@mikro-orm/core';
+export interface PluginCtx {
+    /** Fork-нутий EntityManager для seed/init операцій. */
+    em: EntityManager;
+}
+export interface PluginHooks {
+    /** Ідемпотентне наповнення даними після міграцій. */
+    seed?(ctx: PluginCtx): Promise<void> | void;
+    /** Довільна ініціалізація після seed (воркери, перевірки). */
+    init?(ctx: PluginCtx): Promise<void> | void;
+    /** Зняття плагіна (м'яке): cleanup рантайм-стану. Дані НЕ дропаються. */
+    teardown?(ctx: PluginCtx): Promise<void> | void;
+}
+/** Реєстр серверних хуків по id плагіна. Порожньо = плагін без серверної логіки. */
+export declare const pluginHooks: Record<string, PluginHooks>;
+//# sourceMappingURL=plugin-hooks.d.ts.map

package/dist/plugin-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-hooks.d.ts","sourceRoot":"","sources":["../src/plugin-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB,uDAAuD;IACvD,EAAE,EAAE,aAAa,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5C,8DAA8D;IAC9D,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5C,yEAAyE;IACzE,QAAQ,CAAC,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjD;AAED,oFAAoF;AACpF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAM,CAAC"}

package/dist/plugin-hooks.js

@@ -0,0 +1,3 @@
+/** Реєстр серверних хуків по id плагіна. Порожньо = плагін без серверної логіки. */
+export const pluginHooks = {};
+//# sourceMappingURL=plugin-hooks.js.map

package/dist/plugin-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-hooks.js","sourceRoot":"","sources":["../src/plugin-hooks.ts"],"names":[],"mappings":"AAmCA,oFAAoF;AACpF,MAAM,CAAC,MAAM,WAAW,GAAgC,EAAE,CAAC"}

package/dist/plugin-runtime.d.ts

@@ -0,0 +1,36 @@
+import { type Registry } from '@coffer-org/core/compose';
+import type { PluginManifest } from '@coffer-org/sdk/plugin';
+export declare function getPlugins(): Promise<PluginManifest[]>;
+/** Прочитати множину вимкнених плагінів із _plugins (core ніколи не вимкнено). */
+export declare function readDisabled(): Promise<Set<string>>;
+/**
+ * Прочитати налаштування плагіна (singleton-запис у _settings__<id>).
+ * Повертає {} якщо запис ще не збережено.
+ */
+export declare function getPluginSettings(pluginId: string): Promise<Record<string, unknown>>;
+/**
+ * Двофазний bootstrap БД. Повертає множину вимкнених плагінів.
+ * Викликається сервером (через initPlugins) і CLI-скриптами напряму.
+ */
+export declare function initStorage(): Promise<Set<string>>;
+export declare function initPlugins(): Promise<Registry>;
+/**
+ * Graceful-зупинка воркерів активних плагінів (виклик teardown) на shutdown сервера.
+ * Зворотний порядок відносно init. Помилки окремого плагіна не зупиняють решту.
+ */
+export declare function teardownPlugins(): Promise<void>;
+/** М'яке зняття плагіна: лише cleanup-хук. Таблиці/дані НЕ дропаються. */
+export declare function teardownPlugin(id: string): Promise<void>;
+/**
+ * ЯВНЕ видалення даних плагіна (безповоротне):
+ * teardown-хук → DROP TABLE (модулі + extends) → enabled=0 → аудит.
+ * Ідемпотентно: повторний виклик безпечний (IF EXISTS, findOne).
+ * DDL у SQLite через knex виконується в авто-комміті, тому атомарності
+ * між дропами нема — натомість послідовність безпечно перезапускається.
+ */
+export declare function purgePluginData(p: PluginManifest, actor: string): Promise<void>;
+/** Pure filter: drop disabled ids, preserve input order. */
+export declare function filterEnabled<T extends {
+    id: string;
+}>(all: T[], disabled: Set<string>): T[];
+//# sourceMappingURL=plugin-runtime.d.ts.map

package/dist/plugin-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-runtime.d.ts","sourceRoot":"","sources":["../src/plugin-runtime.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAU7D,wBAAsB,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAE5D;AAED,kFAAkF;AAClF,wBAAsB,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAMzD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAc1F;AAeD;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAcxD;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC,CA0BrD;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAcrD;AAED,0EAA0E;AAC1E,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9D;AAUD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCrF;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAE5F"}

package/dist/plugin-runtime.js

@@ -0,0 +1,195 @@
+/**
+ * Оркестрація життєвого циклу плагінів на старті сервера (Рівень 1: набір — з БД).
+ *
+ *   initStorage() — двофазний bootstrap БД:
+ *     1. initDb(системні схеми) → syncSchema() — _events/_folders/_plugins існують;
+ *     2. seed рядків _plugins (нові → enabled=1) → читання вимкнених;
+ *     3. discoverEntity(схеми АКТИВНИХ плагінів) → syncSchema() — таблиці плагінів.
+ *   Entities вимкнених плагінів НЕ реєструються: їхні таблиці невідомі ORM,
+ *   тому dropTables:false гарантує збереження даних (м'яке вимкнення).
+ *
+ *   initPlugins() = initStorage() + composeRegistry + seed/init хуки.
+ *   purgePluginData() — ЯВНЕ видалення даних плагіна (DROP TABLE + _folders + enabled=0).
+ *
+ * core вимкнути не можна.
+ */
+import { randomUUID } from 'node:crypto';
+import { serialize } from '@mikro-orm/core';
+import { composeRegistry } from '@coffer-org/core/compose';
+import { initDb, getOrm, getEm } from './db.js';
+import { syncSchema } from './schema-sync.js';
+import { systemEntities, buildPluginEntities, moduleTableName } from './entity-schema.js';
+import { pluginHooks } from './plugin-hooks.js';
+import { discoverPlugins, loadServerHooks } from './plugin-discovery.js';
+import { setActiveRegistry } from './registry-context.js';
+/** Кеш discovered-набору: discovery виконується раз на процес (перший виклик — на bootstrap). */
+let _plugins = null;
+export async function getPlugins() {
+    return (_plugins ??= await discoverPlugins());
+}
+/** Прочитати множину вимкнених плагінів із _plugins (core ніколи не вимкнено). */
+export async function readDisabled() {
+    const fork = getEm().fork();
+    const rows = await fork.find('_Plugin', { enabled: 0 });
+    const disabled = new Set(rows.map((r) => r.id));
+    disabled.delete('core');
+    return disabled;
+}
+/**
+ * Прочитати налаштування плагіна (singleton-запис у _settings__<id>).
+ * Повертає {} якщо запис ще не збережено.
+ */
+export async function getPluginSettings(pluginId) {
+    try {
+        const fork = getEm().fork();
+        const row = await fork.findOne(`_settings__${pluginId}`, {
+            plugin_id: pluginId,
+        });
+        if (!row)
+            return {};
+        return serialize(row);
+    }
+    catch {
+        return {};
+    }
+}
+/** Зареєструвати рядки _plugins для всіх відомих плагінів (нові → enabled=1). */
+async function seedPluginRows() {
+    const fork = getEm().fork();
+    const existing = new Set((await fork.find('_Plugin', {})).map((r) => r.id));
+    const now = new Date().toISOString();
+    for (const p of await getPlugins()) {
+        if (!existing.has(p.id)) {
+            fork.create('_Plugin', { id: p.id, enabled: 1, updated_at: now });
+        }
+    }
+    await fork.flush();
+}
+/**
+ * Двофазний bootstrap БД. Повертає множину вимкнених плагінів.
+ * Викликається сервером (через initPlugins) і CLI-скриптами напряму.
+ */
+export async function initStorage() {
+    await initDb(systemEntities);
+    await syncSchema(); // системні таблиці
+    // Legacy-зачистка: folder-інфраструктура прибрана. Колонку folder_id у таблицях
+    // модулів дропає syncSchema (safe:false); таблицю _folders — лише явний DROP
+    // (dropTables:false таблиці не чіпає). Ідемпотентно (IF EXISTS).
+    await getEm().fork().getConnection().execute('DROP TABLE IF EXISTS "_folders"');
+    await seedPluginRows();
+    const disabled = await readDisabled();
+    const active = (await getPlugins()).filter((p) => !disabled.has(p.id));
+    const pluginEntities = buildPluginEntities(active);
+    if (pluginEntities.length)
+        getOrm().discoverEntity(pluginEntities);
+    await syncSchema(); // таблиці/колонки активних плагінів
+    return disabled;
+}
+export async function initPlugins() {
+    const disabled = await initStorage();
+    const reg = composeRegistry(await getPlugins(), { disabled });
+    setActiveRegistry(reg);
+    Object.assign(pluginHooks, await loadServerHooks());
+    for (const p of reg.order) {
+        const h = pluginHooks[p.id];
+        try {
+            if (h?.seed) {
+                await h.seed({ em: getEm().fork() });
+                console.log(`[plugin] ${p.id}: seed ✓`);
+            }
+            if (h?.init) {
+                await h.init({ em: getEm().fork() });
+                console.log(`[plugin] ${p.id}: init ✓`);
+            }
+        }
+        catch (err) {
+            console.error(`[plugin] ${p.id}: збій при ініціалізації`, err);
+            throw err;
+        }
+    }
+    console.log(`[plugin] активні: ${reg.order.map((p) => p.id).join(' ')}` +
+        (disabled.size ? ` | вимкнені: ${[...disabled].join(' ')}` : ''));
+    return reg;
+}
+/**
+ * Graceful-зупинка воркерів активних плагінів (виклик teardown) на shutdown сервера.
+ * Зворотний порядок відносно init. Помилки окремого плагіна не зупиняють решту.
+ */
+export async function teardownPlugins() {
+    Object.assign(pluginHooks, await loadServerHooks());
+    const disabled = await readDisabled();
+    const reg = composeRegistry(await getPlugins(), { disabled });
+    for (const p of [...reg.order].reverse()) {
+        const h = pluginHooks[p.id];
+        if (!h?.teardown)
+            continue;
+        try {
+            await h.teardown({ em: getEm().fork() });
+            console.log(`[plugin] ${p.id}: teardown ✓`);
+        }
+        catch (e) {
+            console.warn(`[plugin] ${p.id}: teardown ✗ ${e.message}`);
+        }
+    }
+}
+/** М'яке зняття плагіна: лише cleanup-хук. Таблиці/дані НЕ дропаються. */
+export async function teardownPlugin(id) {
+    const h = pluginHooks[id];
+    if (h?.teardown) {
+        await h.teardown({ em: getEm().fork() });
+        console.log(`[plugin] ${id}: teardown ✓`);
+    }
+}
+/** Пари (vault, module) усіх модулів плагіна — власні vault'и + vaultModules. */
+function pluginModules(p) {
+    return [
+        ...(p.vaults ?? []).flatMap((v) => v.modules.map((m) => ({ vault: m.vault, module: m.module }))),
+        ...(p.vaultModules ?? []).map((m) => ({ vault: m.vault, module: m.module })),
+    ];
+}
+/**
+ * ЯВНЕ видалення даних плагіна (безповоротне):
+ * teardown-хук → DROP TABLE (модулі + extends) → enabled=0 → аудит.
+ * Ідемпотентно: повторний виклик безпечний (IF EXISTS, findOne).
+ * DDL у SQLite через knex виконується в авто-комміті, тому атомарності
+ * між дропами нема — натомість послідовність безпечно перезапускається.
+ */
+export async function purgePluginData(p, actor) {
+    await teardownPlugin(p.id);
+    const tables = [
+        ...pluginModules(p).map(({ vault, module }) => moduleTableName(vault, module)),
+        ...(p.extends_ ?? []).map((e) => `extend__${e.id}`),
+        ...(p.settings && p.settings.fields.length > 0 ? [`_settings__${p.id}`] : []),
+    ];
+    const conn = getEm().fork().getConnection();
+    for (const t of tables) {
+        await conn.execute(`DROP TABLE IF EXISTS "${t}"`);
+    }
+    // enabled=0 + аудит — однією транзакцією.
+    await getEm()
+        .fork()
+        .transactional(async (tx) => {
+        const now = new Date().toISOString();
+        const row = await tx.findOne('_Plugin', { id: p.id });
+        if (row)
+            tx.assign(row, { enabled: 0, updated_at: now });
+        else
+            tx.create('_Plugin', { id: p.id, enabled: 0, updated_at: now });
+        tx.create('_Event', {
+            id: randomUUID(),
+            ts: now,
+            actor,
+            op: 'purge',
+            type: p.id,
+            record_id: p.id,
+            before: null,
+            after: null,
+        });
+    });
+    console.log(`[plugin] ${p.id}: purge ✓ (${tables.length} табл.)`);
+}
+/** Pure filter: drop disabled ids, preserve input order. */
+export function filterEnabled(all, disabled) {
+    return all.filter((p) => !disabled.has(p.id));
+}
+//# sourceMappingURL=plugin-runtime.js.map

package/dist/plugin-runtime.js.map

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

package/dist/plugins-api.d.ts

@@ -0,0 +1,3 @@
+import type { FastifyInstance } from 'fastify';
+export declare function registerPluginsApi(app: FastifyInstance): Promise<void>;
+//# sourceMappingURL=plugins-api.d.ts.map

package/dist/plugins-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins-api.d.ts","sourceRoot":"","sources":["../src/plugins-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAW/C,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA2C5E"}