evikit 2.4.0 → 2.5.0

package/.woodpecker/test.yaml

@@ -0,0 +1,26 @@
+when:
+  - event: push
+    branch: main
+  - event: pull_request
+
+steps:
+  - name: build
+    image: node:24-alpine
+    commands:
+      - apk add git
+      # Are types correct?
+      - npm i
+      - npm run lint
+      - npx tsc
+      # Does todo app example build?
+      - npm create evikit my-app
+      - rm -rf my-app/node_modules/evikit
+      - (cd my-app/node_modules; git clone ../.. evikit)
+      - (cd my-app; npm run build)
+      # Does real-world application pass tests?
+      - git clone https://codeberg.org/nykula/lanquiz
+      - (cd lanquiz; npm i)
+      - rm -rf lanquiz/node_modules/evikit
+      - (cd lanquiz/node_modules; git clone ../.. evikit)
+      - (cd lanquiz; npm run build)
+      - (cd lanquiz; npm test -- --test-concurrency=1)

package/README.md

@@ -932,6 +932,26 @@ Change your `index.html` like this:
 
 Style your app however you like.
 
+### Background worker
+
+You can run something repeatedly in main process, not in listeners for each CPU core. In development, it will restart whenever you edit api routes.
+
+Add to `src/lib/db/index.js`:
+
+```js
+import { daemon } from "evikit/server";
+
+// ...
+
+const unique = crypto.randomUUID();
+daemon(() => {
+  const interval = setInterval(() => {
+    console.log({ now: Date.now(), unique });
+  }, 1000);
+  return () => clearInterval(interval);
+});
+```
+
 ### Testing
 
 A practical integration test for EviKit itself is [Lanquiz](https://codeberg.org/nykula/lanquiz), an app to host quizzes in LAN from a laptop, which is built on top of EviKit.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "evikit",
   "description": "Preact/SQLite SSR framework for small web apps",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "type": "module",
   "exports": {
     ".": "./index.js",

package/server.d.ts

@@ -8,6 +8,8 @@ import type {
   ServerText,
 } from "./server-generic.js";
 
+export function daemon(callback: () => () => void): void;
+
 export const endpoint: ServerEndpoint;
 
 export const json: ServerJson;

package/server.js

@@ -20,6 +20,21 @@ import {
 
 import { Po } from "./i18n.js";
 
+/** @param {() => () => void} callback */
+export function daemon(callback) {
+  if (
+    (process.env["npm_command"] == "start" && cluster.isPrimary) ||
+    process.env["npm_lifecycle_event"] == "dev"
+  ) {
+    /** @type {any} */
+    const self = globalThis;
+    if (self.clearDaemon) {
+      self.clearDaemon();
+    }
+    self.clearDaemon = callback();
+  }
+}
+
 /** @type {import("./server-generic.js").ServerEndpoint} */
 export function endpoint({ input, outputs }, handler) {
   const arrayOf = ArrayOf(input);