@yss123/cage-kernel 0.0.0-stage → 0.1.0

package/dist/worker/scheduler.js

@@ -0,0 +1,77 @@
+// 定时任务调度：多实例只跑一次（PostgreSQL 咨询锁 + 记录上次执行时间）。任务只能读数据和调用声明过的命令。
+import { CronExpressionParser } from 'cron-parser';
+import { sql } from 'kysely';
+import { cageError } from '../errors.js';
+import { systemCtx } from '../org.js';
+import { scopedFind } from '../pipeline/load.js';
+import { rowToSnapshot } from '../db/rows.js';
+import { hash32 } from '../util/names.js';
+export function nextRun(cron, after) {
+    return CronExpressionParser.parse(cron, { currentDate: after }).next().toDate();
+}
+export function jobApi(k, j, tenantId, now) {
+    const caps = j.calls.map((c) => k.registry.capabilityOf(c));
+    const ctx = systemCtx({ kind: 'job', name: j.name, tenantId, capabilities: caps });
+    const allowedReads = new Set(j.reads);
+    return {
+        tenantId,
+        now,
+        log: (msg, extra) => k.log.info({ job: j.name, ...extra }, msg),
+        query: {
+            async list(agg, where = {}, opts = {}) {
+                if (!allowedReads.has(agg))
+                    throw new Error(`[CAGE-JOB-003] 任务 ${j.name} 读取了未声明的聚合 ${agg.name}`);
+                const { createdBefore, createdAfter, updatedBefore, ...eq } = where;
+                let q = scopedFind(k.app, agg, ctx, eq, { limit: opts.limit ?? 1000 });
+                if (createdBefore)
+                    q = q.where('t.created_at', '<', new Date(createdBefore));
+                if (createdAfter)
+                    q = q.where('t.created_at', '>=', new Date(createdAfter));
+                if (updatedBefore)
+                    q = q.where('t.updated_at', '<', new Date(updatedBefore));
+                return (await q.execute()).map((r) => rowToSnapshot(agg, r, false));
+            },
+        },
+        async call(cmd, input) {
+            if (!j.calls.includes(cmd))
+                throw cageError('FORBIDDEN', { message: `[CAGE-JOB-002] 任务 ${j.name} 调用了未声明的命令` });
+            return (await k.execute(cmd, input, ctx));
+        },
+    };
+}
+/** 执行一次任务（拿到锁才执行）；返回是否执行了 */
+export async function tick(k, j, lockConn, scheduledAt, force = false) {
+    const lockId = hash32(`cage.job.${j.name}`);
+    const r = await lockConn.query('select pg_try_advisory_lock($1) as ok', [lockId]);
+    if (!r.rows[0].ok)
+        return false; // 别的实例在跑：本实例跳过
+    try {
+        await k.app.insertInto('sys.job_state').values({ name: j.name }).onConflict((oc) => oc.column('name').doNothing()).execute();
+        const st = await k.app.selectFrom('sys.job_state').selectAll().where('name', '=', j.name).executeTakeFirstOrThrow();
+        if (!st.enabled && !force)
+            return false; // 管理员在 /admin 停用了
+        if (!force && st.last_run_at && new Date(st.last_run_at) >= scheduledAt)
+            return false; // 这一轮别的实例已经跑过
+        const tenants = await k.app.selectFrom('sys.tenant').select('id').execute();
+        let error = null;
+        for (const t of tenants) {
+            try {
+                await j.run(jobApi(k, j, t.id, new Date()));
+            }
+            catch (e) {
+                error = String(e?.message ?? e);
+                k.log.error({ job: j.name, tenant: t.id, err: error }, '定时任务失败');
+            }
+        }
+        await k.app
+            .updateTable('sys.job_state')
+            .set({ last_run_at: force ? new Date() : scheduledAt, last_status: error ? 'failed' : 'ok', last_error: error, updated_at: sql `now()` })
+            .where('name', '=', j.name)
+            .execute();
+        return true;
+    }
+    finally {
+        await lockConn.query('select pg_advisory_unlock($1)', [lockId]); // 加锁和解锁必须在同一个连接上
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/worker/scheduler.js.map

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

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@yss123/cage-kernel",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "笼子内核：声明原语、写入流水线、范围组合子、读侧、worker 运行时",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./worker": {
+      "types": "./dist/worker/index.d.ts",
+      "default": "./dist/worker/index.js"
+    },
+    "./brands": {
+      "types": "./dist/brands.d.ts",
+      "default": "./dist/brands.js"
+    },
+    "./db": {
+      "types": "./dist/db/index.d.ts",
+      "default": "./dist/db/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "cron-parser": "^5.3.1",
+    "kysely": "^0.28.5",
+    "pg": "^8.16.3",
+    "zod": "^4.1.5"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.15.5",
+    "fast-check": "^4.3.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shunshunyue/cage.git",
+    "directory": "packages/kernel"
+  },
+  "homepage": "https://github.com/shunshunyue/cage#readme",
+  "bugs": {
+    "url": "https://github.com/shunshunyue/cage/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }