@onetype/stack-api-kit 1.0.0

package/dist/testing.js

@@ -0,0 +1,450 @@
+import { database, createKernel, limiter } from './chunk-UCWOCNTI.js';
+import { readdirSync, existsSync, readFileSync, statSync } from 'fs';
+import { join, dirname, relative } from 'path';
+import { fileURLToPath } from 'url';
+
+// src/testing/booting.ts
+var Booting = {
+  tables: (plugins) => {
+    return Object.fromEntries(plugins.map((plugin) => [plugin.name, plugin.definition.tables ?? {}]));
+  },
+  migrations: (plugins) => {
+    return plugins.filter((plugin) => plugin.definition.migrations !== void 0).map((plugin) => ({ plugin: plugin.name, from: plugin.definition.migrations }));
+  }
+};
+var TAKES = /* @__PURE__ */ new Set(["plugins", "config", "answers", "outbox", "schedule", "now"]);
+async function booting(given) {
+  const unknown = Object.keys(given).filter((key) => !TAKES.has(key));
+  if (unknown.length > 0) {
+    throw new TypeError(
+      `booting was given ${unknown.map((key) => `"${key}"`).join(", ")}, which it does not take. It takes ${[...TAKES].join(", ")}.`
+    );
+  }
+  const store = database({ file: ":memory:", tables: Booting.tables(given.plugins) });
+  store.migrate(Booting.migrations(given.plugins));
+  const said = [];
+  const called = [];
+  const heard = [];
+  const listening = {
+    name: "testing-ears",
+    definition: {
+      version: "1.0.0",
+      describe: "Records every event, for a test to read.",
+      // Only what the given plugins declare: an ear on an event nobody
+      // publishes fails the boot, blaming a plugin the author never
+      // wrote and cannot find.
+      listens: Object.fromEntries(
+        given.plugins.flatMap(
+          (plugin) => Object.keys(plugin.definition.emits ?? {}).map((event) => [event, {
+            describe: `Records ${event}.`,
+            // The plugin recorded is the one that declared the
+            // event, not this one: ctx.name here is always the
+            // listener, which tells a test nothing.
+            handle: (payload) => {
+              heard.push({ plugin: plugin.name, event, payload });
+            }
+          }])
+        )
+      )
+    }
+  };
+  const dial = (call) => {
+    called.push({ method: call.method, url: call.url, body: call.body, headers: call.headers });
+    return Promise.resolve(given.answers?.(call) ?? {});
+  };
+  const keeping = given.outbox === true ? store.outbox?.() : void 0;
+  const later = given.schedule === true ? store.schedule?.() : void 0;
+  const scoping = given.plugins.some((plugin) => plugin.definition.scope !== void 0);
+  const kernel = createKernel({
+    plugins: [...given.plugins, listening],
+    ...keeping !== void 0 && { outbox: keeping },
+    ...later !== void 0 && { schedule: later },
+    ...scoping && store.narrowing !== void 0 && { narrow: store.narrowing() },
+    ...given.now !== void 0 && { now: given.now },
+    // Never a beat in a test: a job that fires on its own turns an
+    // assertion into a race with an interval nobody controls.
+    beat: 24 * 60 * 60 * 1e3,
+    db: store,
+    dial,
+    budget: limiter(),
+    config: given.config ?? {},
+    log: (level, plugin, line, about) => {
+      said.push({ level, plugin, line, ...about });
+    }
+  });
+  await kernel.start();
+  return {
+    kernel,
+    store,
+    said,
+    called: () => [...called],
+    heard: () => [...heard],
+    due: () => kernel.due(),
+    settled: async () => {
+      for (let turn = 0; turn < 4; turn += 1) {
+        await new Promise((keep) => {
+          setTimeout(keep, 0);
+        });
+      }
+    },
+    stop: async () => {
+      await kernel.stop();
+      store.close();
+    }
+  };
+}
+function calling(permissions = [], id = "11111111-1111-4111-8111-111111111111", claims = {}) {
+  return { id, permissions, claims };
+}
+function boundaries(root) {
+  const names = readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+  const contracts = names.filter((name) => existsSync(join(root, name, "plugin.ts")));
+  const missing2 = names.filter((name) => !contracts.includes(name)).map((name) => ({
+    rule: "contract",
+    message: `"${name}" is a plugin folder with no plugin.ts. Add its contract, or remove the folder.`
+  }));
+  const plugins = contracts.map((name) => read(root, name, contracts));
+  return [...missing2, ...undeclared(needed(plugins)), ...deep(needed(plugins)), ...cycles(plugins)];
+}
+function needed(plugins) {
+  const answers = new Map(plugins.map((one) => [one.name, one.answers]));
+  const declared2 = new Map(plugins.map((one) => [one.name, one.declared]));
+  return plugins.map((one) => {
+    const reached = /* @__PURE__ */ new Set([...one.answers, ...one.declared]);
+    const walking = [...reached];
+    while (walking.length > 0) {
+      const next = walking.pop();
+      for (const set of [answers.get(next), declared2.get(next)]) {
+        for (const further of set ?? []) {
+          if (further !== one.name && !reached.has(further)) {
+            reached.add(further);
+            walking.push(further);
+          }
+        }
+      }
+    }
+    return { ...one, answers: reached };
+  });
+}
+function read(root, name, names) {
+  const others = new Set(names.filter((one) => one !== name));
+  const contract = readFileSync(join(root, name, "plugin.ts"), "utf8");
+  const found = /dependsOn:\s*\[([^\]]*)\]/.exec(contract);
+  const answering = /* @__PURE__ */ new Set();
+  for (const block of [/listens:\s*\{/, /participates:\s*\{/]) {
+    const at = block.exec(contract);
+    if (at === null) {
+      continue;
+    }
+    for (const key of contract.slice(at.index).matchAll(/"([a-z0-9-]+)\.[^"]+":/g)) {
+      if (others.has(key[1])) {
+        answering.add(key[1]);
+      }
+    }
+  }
+  return {
+    name,
+    declared: new Set(found === null ? [] : [...found[1].matchAll(/"([^"]+)"/g)].map((one) => one[1])),
+    answers: answering,
+    crossings: files(root, name).flatMap(({ path, source }) => crossings(name, path, source, others))
+  };
+}
+function files(root, name) {
+  const at = join(root, name);
+  return readdirSync(at, { withFileTypes: true, recursive: true }).filter((entry) => entry.isFile() && /\.tsx?$/.test(entry.name)).map((entry) => {
+    const path = join(entry.parentPath, entry.name);
+    return { path: path.replace(`${at}/`, ""), source: readFileSync(path, "utf8") };
+  });
+}
+function crossings(name, path, source, others) {
+  return [...source.matchAll(/from\s+"([^"]+)"/g)].flatMap((match) => {
+    const specifier = match[1];
+    const alias = /^@plugins\/([^/]+)/.exec(specifier);
+    if (alias !== null && others.has(alias[1])) {
+      return [{ from: path, to: alias[1], specifier }];
+    }
+    if (!specifier.startsWith(".")) {
+      return [];
+    }
+    const parts = [name, ...path.split("/").slice(0, -1), ...specifier.split("/")];
+    const walked = [];
+    for (const part of parts) {
+      if (part === "..") {
+        walked.pop();
+      } else if (part !== ".") {
+        walked.push(part);
+      }
+    }
+    const target = walked[0];
+    return target !== void 0 && others.has(target) ? [{ from: path, to: target, specifier }] : [];
+  });
+}
+function undeclared(plugins) {
+  return plugins.flatMap(
+    (one) => one.crossings.filter((crossing) => {
+      if (one.declared.has(crossing.to)) {
+        return false;
+      }
+      return !(tested(crossing.from) && one.answers.has(crossing.to) && crossing.specifier === `@plugins/${crossing.to}/plugin`);
+    }).map((crossing) => ({
+      rule: "undeclared",
+      message: `${one.name}/${crossing.from} imports "${crossing.specifier}" without declaring "${crossing.to}" in dependsOn.`
+    }))
+  );
+}
+function tested(path) {
+  return /(^|\/)tests?\//.test(path) || /\.test\.tsx?$/.test(path);
+}
+function deep(plugins) {
+  return plugins.flatMap(
+    (one) => one.crossings.filter((crossing) => {
+      if (crossing.specifier === `@plugins/${crossing.to}`) {
+        return false;
+      }
+      return !(tested(crossing.from) && (one.declared.has(crossing.to) || one.answers.has(crossing.to)) && crossing.specifier === `@plugins/${crossing.to}/plugin`);
+    }).map((crossing) => ({
+      rule: "deep",
+      message: `${one.name}/${crossing.from} reaches "${crossing.specifier}" instead of "@plugins/${crossing.to}".`
+    }))
+  );
+}
+function cycles(plugins) {
+  const edges = new Map(plugins.map((one) => [one.name, new Set(one.crossings.map((crossing) => crossing.to))]));
+  const found = [];
+  const walking = /* @__PURE__ */ new Set();
+  const done = /* @__PURE__ */ new Set();
+  function walk2(name, trail) {
+    if (done.has(name)) {
+      return;
+    }
+    if (walking.has(name)) {
+      found.push({
+        rule: "cycle",
+        message: `Plugins import each other in a loop: ${[...trail.slice(trail.indexOf(name)), name].join(" -> ")}.`
+      });
+      return;
+    }
+    walking.add(name);
+    for (const target of edges.get(name) ?? []) {
+      walk2(target, [...trail, name]);
+    }
+    walking.delete(name);
+    done.add(name);
+  }
+  for (const one of plugins) {
+    walk2(one.name, []);
+  }
+  return found;
+}
+var LIMIT = 1800;
+function oversized(root, limit = LIMIT) {
+  if (!existsSync(root)) {
+    return [];
+  }
+  return readdirSync(root, { withFileTypes: true, recursive: true }).filter((entry) => {
+    return entry.isFile() && entry.name.endsWith(".md") && !entry.parentPath.includes("progress");
+  }).map((entry) => {
+    const path = join(entry.parentPath, entry.name);
+    return { path, size: readFileSync(path, "utf8").length };
+  }).filter((doc) => {
+    return doc.size > limit;
+  });
+}
+function missing(root, required) {
+  return required.filter((path) => {
+    try {
+      return readFileSync(join(root, path), "utf8").trim().length === 0;
+    } catch {
+      return true;
+    }
+  });
+}
+function unexplained(plugins) {
+  if (!existsSync(plugins)) {
+    return [];
+  }
+  return readdirSync(plugins, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).filter((name) => {
+    try {
+      return readFileSync(join(plugins, name, "usage.md"), "utf8").trim().length === 0;
+    } catch {
+      return true;
+    }
+  });
+}
+function undocumented(contract, procedure) {
+  const shape = /export type Definition[\s\S]*?\n\};/.exec(contract)?.[0] ?? "";
+  const keys = [...shape.matchAll(/^\s{4}([a-zA-Z]+)\??:/gm)].map((match) => {
+    return match[1] ?? "";
+  });
+  return keys.filter((key) => {
+    return !procedure.includes(`\`${key}\``);
+  });
+}
+function wiring(root, apart = true) {
+  const sources = walk(root).filter((file) => !tested2(file)).map((file) => [file, withoutComments(readFileSync(file, "utf8"))]);
+  const unread = [];
+  for (const [file, source] of sources) {
+    const owns = apart ? within(sources, file) : sources;
+    for (const { shape, field } of declared(source)) {
+      if (!reads(field, owns, file)) {
+        unread.push({ file: relative(root, file), shape, field });
+      }
+    }
+  }
+  return unread;
+}
+function within(sources, file) {
+  const at = file.lastIndexOf("/src/plugins/");
+  if (at === -1) {
+    return [...sources];
+  }
+  const plugin = file.slice(0, file.indexOf("/", at + "/src/plugins/".length) + 1);
+  return sources.filter(([one]) => one.startsWith(plugin));
+}
+function tested2(file) {
+  return /(^|\/)tests?\//.test(file) || /\.test\.tsx?$/.test(file);
+}
+function withoutComments(source) {
+  return source.replace(/\/\*[\s\S]*?\*\//g, " ").replace(/(^|[^:])\/\/[^\n]*/g, "$1");
+}
+function walk(path) {
+  if (!existsSync(path)) {
+    return [];
+  }
+  const found = [];
+  for (const entry of readdirSync(path)) {
+    const full = join(path, entry);
+    if (statSync(full).isDirectory()) {
+      found.push(...walk(full));
+      continue;
+    }
+    if (/\.tsx?$/.test(entry)) {
+      found.push(full);
+    }
+  }
+  return found;
+}
+function declared(source) {
+  const found = [];
+  for (const shape of source.matchAll(/export\s+(?:type\s+(\w+)\s*=\s*\{|interface\s+(\w+)[^{]*\{)/g)) {
+    const name = shape[1] ?? shape[2] ?? "";
+    const from = (shape.index ?? 0) + shape[0].length;
+    const body = withoutParameters(source.slice(from, closes(source, from)));
+    for (const field of body.matchAll(/(?:^|[;,{\n])\s*(?:readonly\s+)?(\w+)\s*\??\s*:/g)) {
+      found.push({ shape: name, field: field[1] ?? "" });
+    }
+  }
+  return found;
+}
+function closes(source, from) {
+  let depth = 1;
+  let at = from;
+  while (at < source.length && depth > 0) {
+    if (source[at] === "{") {
+      depth += 1;
+    }
+    if (source[at] === "}") {
+      depth -= 1;
+    }
+    at += 1;
+  }
+  return at - 1;
+}
+function withoutParameters(body) {
+  let out = "";
+  let depth = 0;
+  for (const character of body) {
+    if (character === "(") {
+      depth += 1;
+    }
+    if (depth === 0) {
+      out += character;
+    }
+    if (character === ")") {
+      depth = Math.max(0, depth - 1);
+    }
+  }
+  return out;
+}
+function reads(field, sources, where) {
+  const patterns = [
+    new RegExp(`\\.${field}\\b`),
+    new RegExp(`\\b${field}\\s*[,}]`),
+    new RegExp(`\\b${field}\\s*:`),
+    new RegExp(`\\[["']${field}["']\\]`),
+    new RegExp(`["']${field}["']`)
+  ];
+  return sources.some(([file, source]) => {
+    const searched = file === where ? withoutShapes(source) : source;
+    return patterns.some((pattern) => pattern.test(searched));
+  });
+}
+function withoutShapes(source) {
+  let out = "";
+  let at = 0;
+  for (const shape of source.matchAll(/export\s+(?:type\s+\w+\s*=\s*|interface\s+\w+[^{]*)\{/g)) {
+    const from = (shape.index ?? 0) + shape[0].length;
+    out += source.slice(at, shape.index);
+    at = closes(source, from) + 1;
+  }
+  return out + source.slice(at);
+}
+
+// src/testing/project.ts
+var CONTRACT = join(dirname(fileURLToPath(import.meta.url)), "..", "plugins", "kernel", "internal", "contract.ts");
+var Project = {
+  required: ["#docs/usage.md", "#docs/stack.md", "#docs/architecture.md", "README.md"],
+  checks: (checking = {}) => {
+    const root = checking.root ?? process.cwd();
+    const docs = checking.docs ?? join(root, "#docs");
+    const limit = checking.limit ?? 1800;
+    return [
+      ...Project.boundaries(checking.plugins ?? join(root, "src", "plugins")),
+      ...Project.wiring(checking.plugins ?? join(root, "src", "plugins")),
+      // Utils shared between plugins are checked too: a field nothing
+      // reads is the same defect wherever it is declared, and code no
+      // plugin owns is code nobody notices going stale.
+      ...Project.wiring(checking.utils ?? join(root, "src", "utils"), false),
+      ...Project.unexplained(checking.plugins ?? join(root, "src", "plugins")),
+      ...Project.docs(root, docs, checking.required ?? Project.required, limit),
+      ...Project.contract(checking.procedure ?? join(docs, "procedures", "plugin", "contract.md"))
+    ];
+  },
+  boundaries: (at) => {
+    return boundaries(at).map((wrong) => ({ check: "boundaries", message: wrong.message }));
+  },
+  wiring: (at, apart = true) => {
+    return wiring(at, apart).map((unread) => ({
+      check: "wiring",
+      message: `${unread.file}: ${unread.shape}.${unread.field} is declared and nothing reads it.`
+    }));
+  },
+  unexplained: (at) => {
+    return unexplained(at).map((name) => ({
+      check: "unexplained",
+      message: `"${name}" has no usage.md. A plugin nobody can read is one nobody can depend on.`
+    }));
+  },
+  docs: (root, at, required, limit) => {
+    return [
+      ...oversized(at, limit).map((doc) => ({
+        check: "oversized",
+        message: `${doc.path.replace(`${root}/`, "")} is ${String(doc.size)} characters, over ${String(limit)}.`
+      })),
+      ...missing(root, required).map((path) => ({
+        check: "missing",
+        message: `${path} is absent or says nothing.`
+      }))
+    ];
+  },
+  contract: (procedure) => {
+    return undocumented(readFileSync(CONTRACT, "utf8"), readFileSync(procedure, "utf8")).map((key) => ({
+      check: "undocumented",
+      message: `The contract accepts "${key}" and ${procedure.split("/").slice(-1).join("")} never names it.`
+    }));
+  }
+};
+
+export { Booting, Project, booting, boundaries, calling, missing, oversized, undocumented, unexplained, wiring };
+//# sourceMappingURL=testing.js.map
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing/booting.ts","../src/testing/boundaries.ts","../src/testing/docs.ts","../src/testing/wiring.ts","../src/testing/project.ts"],"names":["missing","declared","walk","existsSync","readdirSync","join","readFileSync","tested"],"mappings":"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","file":"testing.js","sourcesContent":["import { database } from \"../plugins/database/api\";\nimport { limiter } from \"../plugins/guard/api\";\nimport { createKernel } from \"../plugins/kernel/api\";\n\nimport type { Handle, Store } from \"../plugins/database/api\";\nimport type { Caller, Dialer, Kernel, Outbound, Plugin } from \"../plugins/kernel/api\";\n\nexport type Said = {\n    level: string;\n    plugin: string;\n    line: string;\n} & Readonly<Record<string, unknown>>;\n\n/** One outbound call, as a test sees it. */\nexport type Called = {\n    method: string;\n    url: string;\n    body: unknown;\n    headers: Readonly<Record<string, string>> | undefined;\n};\n\nexport type Booting = {\n    plugins: readonly Plugin[];\n    config?: Readonly<Record<string, unknown>>;\n    answers?: (call: Outbound) => unknown;\n\n    /**\n     * Whether events are kept until a listener has heard them, as\n     * `start({ outbox: true })` does.\n     *\n     * A test proving a listener survives hearing the same event twice needs\n     * the same machinery the deployment runs, or it is proving something\n     * else.\n     */\n    outbox?: boolean;\n\n    /**\n     * Whether a plugin may ask for work later, as `start({ schedule: true })`.\n     *\n     * A test drives it with `due()` rather than a beat: waiting a real second\n     * to watch a job run is a slow test that fails on a busy machine.\n     */\n    schedule?: boolean;\n\n    /** What the clock answers, so a test can reach tomorrow. */\n    now?: () => number;\n};\n\n/** One event, as a test sees it. */\nexport type Heard = {\n    plugin: string;\n    event: string;\n    payload: unknown;\n};\n\nexport type Booted = {\n    kernel: Kernel;\n    store: Store<Handle>;\n    said: Said[];\n    called: () => Called[];\n\n    /**\n     * Every event emitted since boot, in order.\n     *\n     * A plugin with no listener still emits, and proving that it did would\n     * otherwise mean writing a plugin whose only purpose is to hear. This\n     * listens to everything declared, so a test asserts on the emit itself.\n     */\n    heard: () => Heard[];\n\n    /**\n     * Waits until every listener an emit started has finished.\n     *\n     * `emit` returns void and a listener runs after the caller, so a test\n     * that reads straight after emitting reads the state from before it.\n     * Nothing in a plugin ever needs this; a test that asserts on what a\n     * listener did always does.\n     */\n    settled: () => Promise<void>;\n\n    /**\n     * Runs whatever the schedule says is due, once.\n     *\n     * A test moves its own clock forward and asks, rather than waiting for a\n     * beat: what is being proved is that the work runs at its moment, not\n     * that an interval fired.\n     */\n    due: () => Promise<void>;\n\n    stop: () => Promise<void>;\n};\n\nexport const Booting = {\n    tables: (plugins: readonly Plugin[]): Readonly<Record<string, Readonly<Record<string, unknown>>>> =>\n    {\n        return Object.fromEntries(plugins.map((plugin) => [plugin.name, plugin.definition.tables ?? {}]));\n    },\n\n    migrations: (plugins: readonly Plugin[]): { plugin: string; from: string }[] =>\n    {\n        return plugins\n            .filter((plugin) => plugin.definition.migrations !== undefined)\n            .map((plugin) => ({ plugin: plugin.name, from: plugin.definition.migrations as string }));\n    },\n};\n\n/** Everything `booting` knows how to be given. */\nconst TAKES: ReadonlySet<string> = new Set([\"plugins\", \"config\", \"answers\", \"outbox\", \"schedule\", \"now\"]);\n\nexport async function booting(given: Booting): Promise<Booted>\n{\n    // Refused rather than ignored: a key that looks like it worked is how an\n    // author spends an afternoon on a test that was never wired to anything.\n    const unknown = Object.keys(given).filter((key) => !TAKES.has(key));\n\n    if (unknown.length > 0)\n    {\n        throw new TypeError(\n            `booting was given ${unknown.map((key) => `\"${key}\"`).join(\", \")}, which it does not take. It takes ${[...TAKES].join(\", \")}.`,\n        );\n    }\n\n    const store = database({ file: \":memory:\", tables: Booting.tables(given.plugins) });\n\n    store.migrate(Booting.migrations(given.plugins));\n\n    const said: Said[] = [];\n    const called: Called[] = [];\n    const heard: Heard[] = [];\n\n    // A plugin that hears everything, added to the ones under test. Named so\n    // it cannot collide with a real one, and declared as listening to every\n    // event the given plugins publish.\n    const listening: Plugin = {\n        name: \"testing-ears\",\n        definition: {\n            version: \"1.0.0\",\n            describe: \"Records every event, for a test to read.\",\n            // Only what the given plugins declare: an ear on an event nobody\n            // publishes fails the boot, blaming a plugin the author never\n            // wrote and cannot find.\n            listens: Object.fromEntries(\n                given.plugins.flatMap((plugin) =>\n                    Object.keys(plugin.definition.emits ?? {}).map((event) => [event, {\n                        describe: `Records ${event}.`,\n\n                        // The plugin recorded is the one that declared the\n                        // event, not this one: ctx.name here is always the\n                        // listener, which tells a test nothing.\n                        handle: (payload: never): void =>\n                        {\n                            heard.push({ plugin: plugin.name, event, payload });\n                        },\n                    }]),\n                ),\n            ),\n        },\n    };\n\n    const dial: Dialer = (call) =>\n    {\n        called.push({ method: call.method, url: call.url, body: call.body, headers: call.headers });\n\n        return Promise.resolve(given.answers?.(call) ?? {});\n    };\n\n    const keeping = given.outbox === true ? store.outbox?.() : undefined;\n    const later = given.schedule === true ? store.schedule?.() : undefined;\n    const scoping = given.plugins.some((plugin) => plugin.definition.scope !== undefined);\n\n    const kernel = createKernel({\n        plugins: [...given.plugins, listening],\n        ...(keeping !== undefined && { outbox: keeping }),\n        ...(later !== undefined && { schedule: later }),\n        ...(scoping && store.narrowing !== undefined && { narrow: store.narrowing() }),\n        ...(given.now !== undefined && { now: given.now }),\n\n        // Never a beat in a test: a job that fires on its own turns an\n        // assertion into a race with an interval nobody controls.\n        beat: 24 * 60 * 60 * 1000,\n        db: store,\n        dial,\n        budget: limiter(),\n        config: given.config ?? {},\n        log: (level, plugin, line, about) =>\n        {\n            said.push({ level, plugin, line, ...about });\n        },\n    });\n\n    await kernel.start();\n\n    return {\n        kernel,\n        store,\n        said,\n        called: () => [...called],\n        heard: () => [...heard],\n\n        due: () => kernel.due(),\n\n        settled: async (): Promise<void> =>\n        {\n            // Two turns, not one: a listener that writes hands its work to\n            // the store's queue, and a chain of two listeners needs the\n            // second to start before the first is done.\n            for (let turn = 0; turn < 4; turn += 1)\n            {\n                await new Promise((keep) => { setTimeout(keep, 0); });\n            }\n        },\n        stop: async (): Promise<void> =>\n        {\n            await kernel.stop();\n            store.close();\n        },\n    };\n}\n\n/**\n * A caller a test controls.\n *\n * `claims` is what the project decided a caller carries: a tenant, a role, a\n * plan. The kernel never reads it, so a test proving that one tenant cannot\n * reach another's rows has to be able to say who this caller belongs to.\n */\nexport function calling(\n    permissions: readonly string[] = [],\n    id = \"11111111-1111-4111-8111-111111111111\",\n    claims: Readonly<Record<string, unknown>> = {},\n): Caller\n{\n    return { id, permissions, claims };\n}\n","import { existsSync, readFileSync, readdirSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport type Crossing = {\n    from: string;\n    to: string;\n    specifier: string;\n};\n\nexport type Wrong = {\n    rule: \"undeclared\" | \"deep\" | \"cycle\" | \"contract\";\n    message: string;\n};\n\ntype Read = {\n    name: string;\n    declared: Set<string>;\n\n    /**\n     * Plugins whose events or hooks this one answers.\n     *\n     * Not dependencies: hearing is not depending, and the kernel adds no edge\n     * for it. But a test still has to boot the plugin that emits, or there is\n     * nothing to hear, so a test may name its contract exactly as a test of a\n     * dependency may.\n     */\n    answers: Set<string>;\n\n    crossings: Crossing[];\n};\n\nexport function boundaries(root: string): Wrong[]\n{\n    const names = readdirSync(root, { withFileTypes: true })\n        .filter((entry) => entry.isDirectory())\n        .map((entry) => entry.name);\n\n    // A folder with no contract is reported, not thrown: a half-built plugin\n    // is the commonest reason to run this check, and a raw ENOENT naming a\n    // path inside the kit tells its author nothing about their own folder.\n    const contracts = names.filter((name) => existsSync(join(root, name, \"plugin.ts\")));\n\n    const missing: Wrong[] = names\n        .filter((name) => !contracts.includes(name))\n        .map((name) => ({\n            rule: \"contract\" as const,\n            message: `\"${name}\" is a plugin folder with no plugin.ts. Add its contract, or remove the folder.`,\n        }));\n\n    const plugins = contracts.map((name) => read(root, name, contracts));\n\n    return [...missing, ...undeclared(needed(plugins)), ...deep(needed(plugins)), ...cycles(plugins)];\n}\n\n/**\n * What each plugin's tests must boot, following the chain.\n *\n * A listener has to boot what it hears. But that emitter may itself be a\n * listener, and cannot start without the plugin *it* hears: a test two hops\n * down the chain has to boot all three. Refusing that made the checker decide\n * an architecture, which is backwards.\n *\n * Dependencies are not widened this way: only what a test has to assemble.\n */\nfunction needed(plugins: readonly Read[]): Read[]\n{\n    const answers = new Map(plugins.map((one) => [one.name, one.answers]));\n    const declared = new Map(plugins.map((one) => [one.name, one.declared]));\n\n    return plugins.map((one) =>\n    {\n        // Seeded from both: a test boots what this plugin hears *and* what it\n        // depends on, and then whatever those need in turn. Seeding only from\n        // what it hears leaves a three-deep dependency chain untestable\n        // without writing a dependency that is not one.\n        const reached = new Set([...one.answers, ...one.declared]);\n        const walking = [...reached];\n\n        while (walking.length > 0)\n        {\n            const next = walking.pop() as string;\n\n            for (const set of [answers.get(next), declared.get(next)])\n            {\n                for (const further of set ?? [])\n                {\n                    if (further !== one.name && !reached.has(further))\n                    {\n                        reached.add(further);\n                        walking.push(further);\n                    }\n                }\n            }\n        }\n\n        return { ...one, answers: reached };\n    });\n}\n\nfunction read(root: string, name: string, names: readonly string[]): Read\n{\n    const others = new Set(names.filter((one) => one !== name));\n    const contract = readFileSync(join(root, name, \"plugin.ts\"), \"utf8\");\n    const found = /dependsOn:\\s*\\[([^\\]]*)\\]/.exec(contract);\n\n    // An event or hook key is \"<plugin>.<something>\", so what a plugin\n    // answers is the first segment of every key it listens to or joins.\n    const answering = new Set<string>();\n\n    for (const block of [/listens:\\s*\\{/, /participates:\\s*\\{/])\n    {\n        const at = block.exec(contract);\n\n        if (at === null)\n        {\n            continue;\n        }\n\n        for (const key of contract.slice(at.index).matchAll(/\"([a-z0-9-]+)\\.[^\"]+\":/g))\n        {\n            if (others.has(key[1]!))\n            {\n                answering.add(key[1]!);\n            }\n        }\n    }\n\n    return {\n        name,\n        declared: new Set(found === null ? [] : [...found[1]!.matchAll(/\"([^\"]+)\"/g)].map((one) => one[1]!)),\n        answers: answering,\n        crossings: files(root, name).flatMap(({ path, source }) => crossings(name, path, source, others)),\n    };\n}\n\nfunction files(root: string, name: string): { path: string; source: string }[]\n{\n    const at = join(root, name);\n\n    return readdirSync(at, { withFileTypes: true, recursive: true })\n        .filter((entry) => entry.isFile() && /\\.tsx?$/.test(entry.name))\n        .map((entry) =>\n        {\n            const path = join(entry.parentPath, entry.name);\n\n            return { path: path.replace(`${at}/`, \"\"), source: readFileSync(path, \"utf8\") };\n        });\n}\n\n// A specifier is resolved against the file that wrote it rather than matched as\n// text: \"../../other/thing\" reaches the same private file an alias would, and a\n// rule reading the alias alone calls that clean.\nfunction crossings(name: string, path: string, source: string, others: ReadonlySet<string>): Crossing[]\n{\n    return [...source.matchAll(/from\\s+\"([^\"]+)\"/g)].flatMap((match) =>\n    {\n        const specifier = match[1]!;\n        const alias = /^@plugins\\/([^/]+)/.exec(specifier);\n\n        if (alias !== null && others.has(alias[1]!))\n        {\n            return [{ from: path, to: alias[1]!, specifier }];\n        }\n\n        if (!specifier.startsWith(\".\"))\n        {\n            return [];\n        }\n\n        const parts = [name, ...path.split(\"/\").slice(0, -1), ...specifier.split(\"/\")];\n        const walked: string[] = [];\n\n        for (const part of parts)\n        {\n            if (part === \"..\")\n            {\n                walked.pop();\n            }\n            else if (part !== \".\")\n            {\n                walked.push(part);\n            }\n        }\n\n        const target = walked[0];\n\n        return target !== undefined && others.has(target) ? [{ from: path, to: target, specifier }] : [];\n    });\n}\n\nfunction undeclared(plugins: readonly Read[]): Wrong[]\n{\n    return plugins.flatMap((one) =>\n        one.crossings\n            .filter((crossing) =>\n            {\n                if (one.declared.has(crossing.to))\n                {\n                    return false;\n                }\n\n                // A test of a listener boots what it listens to. That is not\n                // a dependency, and writing one to satisfy this check would\n                // put a lie in the contract.\n                return !(tested(crossing.from)\n                    && one.answers.has(crossing.to)\n                    && crossing.specifier === `@plugins/${crossing.to}/plugin`);\n            })\n            .map((crossing) => ({\n                rule: \"undeclared\" as const,\n                message: `${one.name}/${crossing.from} imports \"${crossing.specifier}\" without declaring \"${crossing.to}\" in dependsOn.`,\n            })),\n    );\n}\n\n/**\n * Whether a file is a test, which may reach one file more than the rest.\n *\n * A plugin with a dependency has to boot it to test itself, and a contract is\n * not reachable through `index.ts`: what a consumer imports is the public API,\n * and what a kernel takes is the plugin. Refusing this left `tests.md`'s \"a\n * plugin tests itself in its own tests/\" impossible for anything with a\n * dependency.\n */\nfunction tested(path: string): boolean\n{\n    return /(^|\\/)tests?\\//.test(path) || /\\.test\\.tsx?$/.test(path);\n}\n\nfunction deep(plugins: readonly Read[]): Wrong[]\n{\n    return plugins.flatMap((one) =>\n        one.crossings\n            .filter((crossing) =>\n            {\n                if (crossing.specifier === `@plugins/${crossing.to}`)\n                {\n                    return false;\n                }\n\n                // A test may name a declared dependency's contract, and only\n                // its contract: everything below it is still private.\n                return !(tested(crossing.from)\n                    && (one.declared.has(crossing.to) || one.answers.has(crossing.to))\n                    && crossing.specifier === `@plugins/${crossing.to}/plugin`);\n            })\n            .map((crossing) => ({\n                rule: \"deep\" as const,\n                message: `${one.name}/${crossing.from} reaches \"${crossing.specifier}\" instead of \"@plugins/${crossing.to}\".`,\n            })),\n    );\n}\n\nfunction cycles(plugins: readonly Read[]): Wrong[]\n{\n    const edges = new Map(plugins.map((one) => [one.name, new Set(one.crossings.map((crossing) => crossing.to))]));\n    const found: Wrong[] = [];\n    const walking = new Set<string>();\n    const done = new Set<string>();\n\n    function walk(name: string, trail: readonly string[]): void\n    {\n        if (done.has(name))\n        {\n            return;\n        }\n\n        if (walking.has(name))\n        {\n            found.push({\n                rule: \"cycle\",\n                message: `Plugins import each other in a loop: ${[...trail.slice(trail.indexOf(name)), name].join(\" -> \")}.`,\n            });\n\n            return;\n        }\n\n        walking.add(name);\n\n        for (const target of edges.get(name) ?? [])\n        {\n            walk(target, [...trail, name]);\n        }\n\n        walking.delete(name);\n        done.add(name);\n    }\n\n    for (const one of plugins)\n    {\n        walk(one.name, []);\n    }\n\n    return found;\n}\n","import { existsSync, readFileSync, readdirSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport type Oversized = {\n    path: string;\n    size: number;\n};\n\nexport type Undocumented = {\n    key: string;\n};\n\nconst LIMIT = 1800;\n\n// A contract nobody can read in one sitting is a contract nobody reads. What\n// grows past this is two documents, or a rule that belongs in code.\nexport function oversized(root: string, limit: number = LIMIT): Oversized[]\n{\n    if (!existsSync(root))\n    {\n        return [];\n    }\n\n    return readdirSync(root, { withFileTypes: true, recursive: true })\n        .filter((entry) =>\n        {\n            return entry.isFile() && entry.name.endsWith(\".md\") && !entry.parentPath.includes(\"progress\");\n        })\n        .map((entry) =>\n        {\n            const path = join(entry.parentPath, entry.name);\n\n            return { path, size: readFileSync(path, \"utf8\").length };\n        })\n        .filter((doc) =>\n        {\n            return doc.size > limit;\n        });\n}\n\n// A document that is present but empty reads as done and says nothing, which\n// is worse than one that is missing and obviously so.\nexport function missing(root: string, required: readonly string[]): string[]\n{\n    return required.filter((path) =>\n    {\n        try\n        {\n            return readFileSync(join(root, path), \"utf8\").trim().length === 0;\n        }\n        catch\n        {\n            return true;\n        }\n    });\n}\n\n/**\n * Plugins that describe themselves nowhere.\n *\n * A plugin is a capability someone else has to understand before they can\n * depend on it, and its contract says what crosses the boundary rather than\n * why anyone would want it. A folder with no `usage.md` is one nobody can\n * decide about without reading its source.\n */\nexport function unexplained(plugins: string): string[]\n{\n    if (!existsSync(plugins))\n    {\n        return [];\n    }\n\n    return readdirSync(plugins, { withFileTypes: true })\n        .filter((entry) => entry.isDirectory())\n        .map((entry) => entry.name)\n        .filter((name) =>\n        {\n            try\n            {\n                return readFileSync(join(plugins, name, \"usage.md\"), \"utf8\").trim().length === 0;\n            }\n            catch\n            {\n                return true;\n            }\n        });\n}\n\n// Every key the contract accepts is named in the procedure that explains it.\n// A key added to one and not the other is how a document starts lying.\nexport function undocumented(contract: string, procedure: string): string[]\n{\n    const shape = /export type Definition[\\s\\S]*?\\n\\};/.exec(contract)?.[0] ?? \"\";\n    const keys = [...shape.matchAll(/^\\s{4}([a-zA-Z]+)\\??:/gm)].map((match) =>\n    {\n        return match[1] ?? \"\";\n    });\n\n    return keys.filter((key) =>\n    {\n        return !procedure.includes(`\\`${key}\\``);\n    });\n}\n","import { readFileSync, readdirSync, existsSync, statSync } from \"node:fs\";\nimport { join, relative } from \"node:path\";\n\nexport type Unread = {\n    file: string;\n    shape: string;\n    field: string;\n};\n\n/**\n * Fields a contract declares that nothing in production reads.\n *\n * Tests and comments are excluded from what counts as a read. Counting them\n * is what made this check certify rather than check: a field kept alive by a\n * fixture is a field the document promises and no code honours, which is the\n * defect this exists to catch.\n */\nexport function wiring(root: string, apart = true): Unread[]\n{\n    const sources = walk(root)\n        .filter((file) => !tested(file))\n        .map((file): [string, string] => [file, withoutComments(readFileSync(file, \"utf8\"))]);\n\n    const unread: Unread[] = [];\n\n    for (const [file, source] of sources)\n    {\n        // Only the plugin that declared it can read it, so only its files are\n        // searched. Searching every plugin makes the check weaker the more\n        // plugins there are: a field called `id` or `status` is read\n        // somewhere in any codebase, and would be certified everywhere.\n        const owns = apart ? within(sources, file) : sources;\n\n        for (const { shape, field } of declared(source))\n        {\n            if (!reads(field, owns, file))\n            {\n                unread.push({ file: relative(root, file), shape, field });\n            }\n        }\n    }\n\n    return unread;\n}\n\n/**\n * The files of the plugin a file belongs to, and no others.\n *\n * A plugin cannot read another's types, so a field read only elsewhere is a\n * field nothing honours. Searching every plugin makes the check weaker the\n * more there are: `id` or `status` occurs somewhere in any codebase, and\n * would be certified everywhere it appears.\n */\nfunction within(sources: readonly [string, string][], file: string): [string, string][]\n{\n    const at = file.lastIndexOf(\"/src/plugins/\");\n\n    if (at === -1)\n    {\n        return [...sources];\n    }\n\n    const plugin = file.slice(0, file.indexOf(\"/\", at + \"/src/plugins/\".length) + 1);\n\n    return sources.filter(([one]) => one.startsWith(plugin));\n}\n\n/** Whether a file is a test rather than the code a contract is honoured by. */\nfunction tested(file: string): boolean\n{\n    return /(^|\\/)tests?\\//.test(file) || /\\.test\\.tsx?$/.test(file);\n}\n\n/**\n * The source with comments removed.\n *\n * A name mentioned in a comment is a name nothing consumes: \"someday we will\n * enforce `limit`\" is exactly the shape this check exists to refuse.\n */\nfunction withoutComments(source: string): string\n{\n    return source\n        .replace(/\\/\\*[\\s\\S]*?\\*\\//g, \" \")\n        .replace(/(^|[^:])\\/\\/[^\\n]*/g, \"$1\");\n}\n\nfunction walk(path: string): string[]\n{\n    if (!existsSync(path))\n    {\n        return [];\n    }\n\n    const found: string[] = [];\n\n    for (const entry of readdirSync(path))\n    {\n        const full = join(path, entry);\n\n        if (statSync(full).isDirectory())\n        {\n            found.push(...walk(full));\n            continue;\n        }\n\n        if (/\\.tsx?$/.test(entry))\n        {\n            found.push(full);\n        }\n    }\n\n    return found;\n}\n\n// A contract is what crosses a boundary, so only exported shapes count: an\n// internal type is read by whoever wrote it or it would not compile.\nfunction declared(source: string): { shape: string; field: string }[]\n{\n    const found: { shape: string; field: string }[] = [];\n\n    for (const shape of source.matchAll(/export\\s+(?:type\\s+(\\w+)\\s*=\\s*\\{|interface\\s+(\\w+)[^{]*\\{)/g))\n    {\n        const name = shape[1] ?? shape[2] ?? \"\";\n        const from = (shape.index ?? 0) + shape[0].length;\n        const body = withoutParameters(source.slice(from, closes(source, from)));\n\n        for (const field of body.matchAll(/(?:^|[;,{\\n])\\s*(?:readonly\\s+)?(\\w+)\\s*\\??\\s*:/g))\n        {\n            found.push({ shape: name, field: field[1] ?? \"\" });\n        }\n    }\n\n    return found;\n}\n\n// Where the brace opened at `from` closes. Walking counts nested shapes as\n// part of the same contract; stopping at the first \"}\" would miss their fields.\nfunction closes(source: string, from: number): number\n{\n    let depth = 1;\n    let at = from;\n\n    while (at < source.length && depth > 0)\n    {\n        if (source[at] === \"{\")\n        {\n            depth += 1;\n        }\n\n        if (source[at] === \"}\")\n        {\n            depth -= 1;\n        }\n\n        at += 1;\n    }\n\n    return at - 1;\n}\n\n// A parameter inside a function type is not a field: `debug: (line, about?: X)\n// => void` declares one name, and \"about\" is positional. Counting it reports a\n// defect where there is none.\nfunction withoutParameters(body: string): string\n{\n    let out = \"\";\n    let depth = 0;\n\n    for (const character of body)\n    {\n        if (character === \"(\")\n        {\n            depth += 1;\n        }\n\n        if (depth === 0)\n        {\n            out += character;\n        }\n\n        if (character === \")\")\n        {\n            depth = Math.max(0, depth - 1);\n        }\n    }\n\n    return out;\n}\n\n// Property access, destructuring, an object literal built from it, a string\n// key. A name in none of those is a name nothing consumes.\nfunction reads(field: string, sources: readonly [string, string][], where: string): boolean\n{\n    const patterns = [\n        new RegExp(`\\\\.${field}\\\\b`),\n        new RegExp(`\\\\b${field}\\\\s*[,}]`),\n        new RegExp(`\\\\b${field}\\\\s*:`),\n        new RegExp(`\\\\[[\"']${field}[\"']\\\\]`),\n        new RegExp(`[\"']${field}[\"']`),\n    ];\n\n    return sources.some(([file, source]) =>\n    {\n        const searched = file === where ? withoutShapes(source) : source;\n\n        return patterns.some((pattern) => pattern.test(searched));\n    });\n}\n\n// The declaration itself is not a read. Shapes are stripped by walking braces,\n// never by matching to the next \"}\": a regex doing that runs past the end of\n// the type and swallows the code below it.\nfunction withoutShapes(source: string): string\n{\n    let out = \"\";\n    let at = 0;\n\n    for (const shape of source.matchAll(/export\\s+(?:type\\s+\\w+\\s*=\\s*|interface\\s+\\w+[^{]*)\\{/g))\n    {\n        const from = (shape.index ?? 0) + shape[0].length;\n\n        out += source.slice(at, shape.index);\n        at = closes(source, from) + 1;\n    }\n\n    return out + source.slice(at);\n}\n","import { readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport { boundaries } from \"./boundaries\";\nimport { missing, oversized, undocumented, unexplained } from \"./docs\";\nimport { wiring } from \"./wiring\";\n\nexport type Wrong = {\n    check: \"boundaries\" | \"wiring\" | \"oversized\" | \"missing\" | \"unexplained\" | \"undocumented\";\n    message: string;\n};\n\nexport type Checking = {\n    root?: string;\n    plugins?: string;\n\n    /** Where pure code shared between plugins lives. */\n    utils?: string;\n    docs?: string;\n    required?: readonly string[];\n    procedure?: string;\n    limit?: number;\n};\n\nconst CONTRACT = join(dirname(fileURLToPath(import.meta.url)), \"..\", \"plugins\", \"kernel\", \"internal\", \"contract.ts\");\n\nexport const Project = {\n    required: [\"#docs/usage.md\", \"#docs/stack.md\", \"#docs/architecture.md\", \"README.md\"] as const,\n\n    checks: (checking: Checking = {}): Wrong[] =>\n    {\n        const root = checking.root ?? process.cwd();\n        const docs = checking.docs ?? join(root, \"#docs\");\n        const limit = checking.limit ?? 1800;\n\n        return [\n            ...Project.boundaries(checking.plugins ?? join(root, \"src\", \"plugins\")),\n            ...Project.wiring(checking.plugins ?? join(root, \"src\", \"plugins\")),\n\n            // Utils shared between plugins are checked too: a field nothing\n            // reads is the same defect wherever it is declared, and code no\n            // plugin owns is code nobody notices going stale.\n            ...Project.wiring(checking.utils ?? join(root, \"src\", \"utils\"), false),\n            ...Project.unexplained(checking.plugins ?? join(root, \"src\", \"plugins\")),\n            ...Project.docs(root, docs, checking.required ?? Project.required, limit),\n            ...Project.contract(checking.procedure ?? join(docs, \"procedures\", \"plugin\", \"contract.md\")),\n        ];\n    },\n\n    boundaries: (at: string): Wrong[] =>\n    {\n        return boundaries(at).map((wrong) => ({ check: \"boundaries\" as const, message: wrong.message }));\n    },\n\n    wiring: (at: string, apart = true): Wrong[] =>\n    {\n        return wiring(at, apart).map((unread) => ({\n            check: \"wiring\" as const,\n            message: `${unread.file}: ${unread.shape}.${unread.field} is declared and nothing reads it.`,\n        }));\n    },\n\n    unexplained: (at: string): Wrong[] =>\n    {\n        return unexplained(at).map((name) => ({\n            check: \"unexplained\" as const,\n            message: `\"${name}\" has no usage.md. A plugin nobody can read is one nobody can depend on.`,\n        }));\n    },\n\n    docs: (root: string, at: string, required: readonly string[], limit: number): Wrong[] =>\n    {\n        return [\n            ...oversized(at, limit).map((doc) => ({\n                check: \"oversized\" as const,\n                message: `${doc.path.replace(`${root}/`, \"\")} is ${String(doc.size)} characters, over ${String(limit)}.`,\n            })),\n            ...missing(root, required).map((path) => ({\n                check: \"missing\" as const,\n                message: `${path} is absent or says nothing.`,\n            })),\n        ];\n    },\n\n    contract: (procedure: string): Wrong[] =>\n    {\n        return undocumented(readFileSync(CONTRACT, \"utf8\"), readFileSync(procedure, \"utf8\")).map((key) => ({\n            check: \"undocumented\" as const,\n            message: `The contract accepts \"${key}\" and ${procedure.split(\"/\").slice(-1).join(\"\")} never names it.`,\n        }));\n    },\n};\n"]}

package/package.json

@@ -0,0 +1,75 @@
+{
+    "name": "@onetype/stack-api-kit",
+    "version": "1.0.0",
+    "type": "module",
+    "sideEffects": false,
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./testing": {
+            "types": "./dist/testing.d.ts",
+            "import": "./dist/testing.js"
+        }
+    },
+    "scripts": {
+        "check": "tools/check.sh",
+        "test": "vitest run",
+        "typecheck": "tsc --noEmit",
+        "boundaries": "node tools/boundaries.mjs",
+        "docs": "node tools/docs.mjs",
+        "build": "tsup",
+        "prepublishOnly": "tools/check.sh && tsup"
+    },
+    "dependencies": {
+        "zod": "^4.5.4"
+    },
+    "peerDependencies": {
+        "better-sqlite3": ">=13",
+        "drizzle-orm": ">=0.45",
+        "hono": ">=4"
+    },
+    "devDependencies": {
+        "@types/better-sqlite3": "^7.6.13",
+        "@types/node": "^26.4.0",
+        "better-sqlite3": "^13.0.3",
+        "drizzle-orm": "^0.45.2",
+        "hono": "^4.13.5",
+        "tsup": "^8.5.1",
+        "typescript": "^5.7.0",
+        "vitest": "^4.1.11"
+    },
+    "description": "A kernel that holds plugins apart: contracts, routes, events, hooks, permissions and scope, refused at startup rather than in review.",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/onetype-ai/stack-api-kit.git"
+    },
+    "homepage": "https://github.com/onetype-ai/stack-api-kit#readme",
+    "bugs": {
+        "url": "https://github.com/onetype-ai/stack-api-kit/issues"
+    },
+    "keywords": [
+        "plugins",
+        "kernel",
+        "api",
+        "hono",
+        "drizzle",
+        "sqlite",
+        "typescript",
+        "multi-tenant"
+    ],
+    "engines": {
+        "node": ">=22"
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "publishConfig": {
+        "access": "public"
+    }
+}