target-supabase-sdk 0.1.8 → 0.1.9

package/dist/task/task.api.js

@@ -1,2 +1,351 @@
-"use strict";
+import { createTarget, getPossibleTarget, updateTargetDetails, validateWithSchema, isOptimisticLockError, OPTIMISTIC_LOCK_FAILED_MESSAGE } from "../core.api";
+import { generateResponse } from "../core.interface";
+import { createApiLogger } from "../shared/log/log-manager";
+import { z } from "zod";
+import { CategoryTask, ResultCode, TaskStatus, TaskStatusAction } from "./task.interface";
+const TASK_STATUS_FIELD = "details->>status";
+const TASK_NODE_ID_FIELD = "details->>nodeId";
+// ─── State machine ───────────────────────────────────────────────────────────
+/**
+ * Task state machine (field: `details.status`)
+ *
+ * ```text
+ *   publish          claim (CLAIM / patchClaimTask)     finish
+ * OPEN ──────► TODO ──────────────────► DOING ─────────────► DONE
+ *   │                │ reset                  │ cancel           │ close
+ *   │                │                        └──────► TODO      │
+ *   └──────── reset ─┴──────────────────────── reset ────────────┘
+ *   |                                                            │
+ *   └──────────────────── close ─────────────────────────────────┘
+ *                                                               ▼
+ *                                                            CLOSED
+ * ```
+ *
+ * | TaskStatusAction | from              | to     | lock filters                   | caller        |
+ * |------------------|-------------------|--------|--------------------------------|---------------|
+ * | PUBLISH          | OPEN              | TODO   | status = OPEN                  | scheduler     |
+ * | CLAIM            | TODO              | DOING  | status = TODO                  | worker        |
+ * | RESET            | TODO              | OPEN   | status = TODO (no nodeId)      | admin         |
+ * | RESET            | DOING, DONE       | OPEN   | status ∈ {DOING,DONE} + nodeId | worker        |
+ * | CANCEL           | DOING             | TODO   | DOING + nodeId                 | worker        |
+ * | FINISH           | DOING             | DONE   | DOING + nodeId                 | worker        |
+ * | CLOSE            | OPEN, DONE        | CLOSED | status ∈ {OPEN, DONE}          | scheduler     |
+ *
+ * RESET: omit `nodeId` to reset from **TODO**; pass `nodeId` to reset from **DOING** or **DONE**.
+ *
+ * All public APIs validate input with Zod (`validateWithSchema`). Optimistic locks live in
+ * `optimisticLockFilterList` on UPDATE — see `.cursor/skills/optimistic-lock-update/SKILL.md`.
+ */
+// ─── Zod schemas ─────────────────────────────────────────────────────────────
+const taskIdSchema = z.string().trim().min(1);
+const nodeIdSchema = z.string().trim().min(1);
+/** Optional — orchestrator (e.g. NodeManager loop) passes its trace to correlate logs. */
+const traceIdSchema = z.string().trim().min(1).optional();
+const patchChangeTaskStatusBaseSchema = {
+    id: taskIdSchema,
+    extra: z.string().optional(),
+    traceId: traceIdSchema,
+};
+/** Shared by CLAIM / CANCEL / FINISH — worker-side actions that require nodeId */
+const patchChangeTaskStatusNodeOwnedSchema = {
+    ...patchChangeTaskStatusBaseSchema,
+    nodeId: nodeIdSchema,
+};
+export const patchChangeTaskStatusSchema = z.discriminatedUnion("action", [
+    z.object({
+        ...patchChangeTaskStatusBaseSchema,
+        action: z.literal(TaskStatusAction.PUBLISH),
+    }),
+    z.object({
+        ...patchChangeTaskStatusBaseSchema,
+        action: z.literal(TaskStatusAction.CLOSE),
+    }),
+    z.object({
+        ...patchChangeTaskStatusNodeOwnedSchema,
+        action: z.literal(TaskStatusAction.CLAIM),
+    }),
+    z.object({
+        ...patchChangeTaskStatusBaseSchema,
+        action: z.literal(TaskStatusAction.RESET),
+        nodeId: nodeIdSchema.optional(),
+    }),
+    z.object({
+        ...patchChangeTaskStatusNodeOwnedSchema,
+        action: z.literal(TaskStatusAction.CANCEL),
+    }),
+    z.object({
+        ...patchChangeTaskStatusNodeOwnedSchema,
+        action: z.literal(TaskStatusAction.FINISH),
+        cost: z.number().min(0),
+    }),
+]);
+export const patchTaskProgressSchema = z.object({
+    id: taskIdSchema,
+    progress: z.number().min(0).max(100),
+    nodeId: nodeIdSchema,
+    traceId: traceIdSchema,
+});
+export const patchClaimTaskSchema = z.object({
+    nodeId: nodeIdSchema,
+    availableTaskList: z.array(z.string()).min(1),
+    traceId: traceIdSchema,
+});
+/** Initial status for a new task — OPEN (draft) or TODO (claimable by workers). */
+const postTaskInitialStatusSchema = z
+    .union([z.literal(TaskStatus.OPEN), z.literal(TaskStatus.TODO)])
+    .optional()
+    .default(TaskStatus.TODO);
+export const postTaskSchema = z.object({
+    name: z.string().trim().min(1),
+    /** Task type key — matches `task.value`, {@link patchClaimTask}, {@link Repo.value}, and local Repo registry. */
+    value: z.string().trim().min(1),
+    params: z.unknown(),
+    taskStatus: postTaskInitialStatusSchema,
+    tagList: z.array(z.string()).optional().default([]),
+    extra: z.string().optional(),
+    traceId: traceIdSchema,
+});
+// ─── Optimistic lock helpers ─────────────────────────────────────────────────
+function lockOnStatus(...allowed) {
+    if (allowed.length === 1) {
+        return [{ field: TASK_STATUS_FIELD, operator: "eq", value: allowed[0] }];
+    }
+    return [{ field: TASK_STATUS_FIELD, operator: "in", value: allowed }];
+}
+function lockOnOwnerNode(nodeId) {
+    return { field: TASK_NODE_ID_FIELD, operator: "eq", value: nodeId };
+}
+/** DOING row owned by `nodeId` — used by FINISH, CANCEL, patchTaskProgress */
+function lockOnDoingOwner(nodeId) {
+    return [...lockOnStatus(TaskStatus.DOING), lockOnOwnerNode(nodeId)];
+}
+/** TODO without nodeId; DOING/DONE with owner when nodeId is provided */
+function lockOnReset(nodeId) {
+    if (nodeId != null) {
+        return [...lockOnStatus(TaskStatus.DOING, TaskStatus.DONE), lockOnOwnerNode(nodeId)];
+    }
+    return lockOnStatus(TaskStatus.TODO);
+}
+function clearExecutionState() {
+    return { progress: 0, nodeId: null, result: undefined };
+}
+// ─── Internal transitions ────────────────────────────────────────────────────
+async function transitionTask({ id, optimisticLockFilterList, updateFn, updateExtraFn, }) {
+    return updateTargetDetails({
+        id,
+        optimisticLockFilterList,
+        updateFn,
+        updateExtraFn,
+    });
+}
+function logTaskTransition(logger, action, task, context) {
+    logger.info("任务状态迁移成功", {
+        topic: "task",
+        context: {
+            action,
+            taskId: task.id,
+            taskValue: task.value,
+            status: task.details.status,
+            nodeId: task.details.nodeId,
+            ...context,
+        },
+    });
+}
+/** TODO → DOING — lock status only (no owner yet); used by CLAIM and {@link patchClaimTask} */
+async function claimTaskById({ taskId, nodeId, updateExtraFn, }) {
+    return transitionTask({
+        id: taskId,
+        optimisticLockFilterList: lockOnStatus(TaskStatus.TODO),
+        updateFn: (details) => ({
+            ...details,
+            status: TaskStatus.DOING,
+            nodeId,
+        }),
+        updateExtraFn,
+    });
+}
+// ─── patchChangeTaskStatus ───────────────────────────────────────────────────
+export const patchChangeTaskStatus = validateWithSchema(patchChangeTaskStatusSchema, "patchChangeTaskStatusSchema")(async (params) => {
+    const logger = createApiLogger("patchChangeTaskStatus", { traceId: params.traceId });
+    const { id, action, extra } = params;
+    const updateExtraFn = extra == null ? undefined : () => extra;
+    switch (action) {
+        case TaskStatusAction.PUBLISH: {
+            const data = await transitionTask({
+                id,
+                optimisticLockFilterList: lockOnStatus(TaskStatus.OPEN),
+                updateFn: (details) => ({
+                    ...details,
+                    ...clearExecutionState(),
+                    status: TaskStatus.TODO,
+                }),
+                updateExtraFn,
+            });
+            logTaskTransition(logger, action, data);
+            return generateResponse.success(data);
+        }
+        case TaskStatusAction.CLAIM: {
+            const { nodeId } = params;
+            const data = await claimTaskById({ taskId: id, nodeId, updateExtraFn });
+            logTaskTransition(logger, action, data);
+            return generateResponse.success(data);
+        }
+        case TaskStatusAction.RESET: {
+            const { nodeId } = params;
+            const data = await transitionTask({
+                id,
+                optimisticLockFilterList: lockOnReset(nodeId),
+                updateFn: (details) => ({
+                    ...details,
+                    ...clearExecutionState(),
+                    status: TaskStatus.OPEN,
+                }),
+                updateExtraFn,
+            });
+            logTaskTransition(logger, action, data, nodeId != null ? undefined : { resetFrom: "TODO" });
+            return generateResponse.success(data);
+        }
+        case TaskStatusAction.CANCEL: {
+            const { nodeId } = params;
+            const data = await transitionTask({
+                id,
+                optimisticLockFilterList: lockOnDoingOwner(nodeId),
+                updateFn: (details) => ({
+                    ...details,
+                    ...clearExecutionState(),
+                    status: TaskStatus.TODO,
+                }),
+                updateExtraFn,
+            });
+            logTaskTransition(logger, action, data);
+            return generateResponse.success(data);
+        }
+        case TaskStatusAction.CLOSE: {
+            const data = await transitionTask({
+                id,
+                optimisticLockFilterList: lockOnStatus(TaskStatus.OPEN, TaskStatus.DONE),
+                updateFn: (details) => ({
+                    ...details,
+                    status: TaskStatus.CLOSED,
+                }),
+                updateExtraFn,
+            });
+            logTaskTransition(logger, action, data);
+            return generateResponse.success(data);
+        }
+        case TaskStatusAction.FINISH: {
+            const { cost, nodeId } = params;
+            const data = await transitionTask({
+                id,
+                optimisticLockFilterList: lockOnDoingOwner(nodeId),
+                updateFn: (details) => ({
+                    ...details,
+                    progress: 100,
+                    status: TaskStatus.DONE,
+                    nodeId,
+                    result: {
+                        cost,
+                        code: ResultCode.SUCCESS,
+                    },
+                }),
+                updateExtraFn,
+            });
+            logTaskTransition(logger, action, data, { cost });
+            return generateResponse.success(data);
+        }
+        default: {
+            const _exhaustive = action;
+            throw new Error(`[patchChangeTaskStatus] Unknown action: ${_exhaustive}`);
+        }
+    }
+});
+// ─── patchTaskProgress ───────────────────────────────────────────────────────
+/** Update progress on a DOING task; only the owning node may write (see `lockOnDoingOwner`). */
+export const patchTaskProgress = validateWithSchema(patchTaskProgressSchema, "patchTaskProgressSchema")(async ({ id, progress, nodeId, traceId }) => {
+    const logger = createApiLogger("patchTaskProgress", { traceId, nodeId });
+    const data = await transitionTask({
+        id,
+        optimisticLockFilterList: lockOnDoingOwner(nodeId),
+        updateFn: (details) => ({
+            ...details,
+            progress,
+        }),
+    });
+    logTaskTransition(logger, "patchTaskProgress", data, { progress });
+    return generateResponse.success(data);
+});
+// ─── patchClaimTask ──────────────────────────────────────────────────────────
+/**
+ * Discover and claim one TODO task for this node.
+ *
+ * Flow: filter by `availableTaskList` → {@link claimTaskById} (same as `action: CLAIM`).
+ * Equivalent to `patchChangeTaskStatus({ id, action: CLAIM, nodeId })` when `id` is already known.
+ *
+ * Returns `data: null` when no TODO task matches.
+ * Optimistic lock conflicts return `{ error }` with `code: "OPTIMISTIC_LOCK"` (not thrown).
+ */
+export const patchClaimTask = validateWithSchema(patchClaimTaskSchema, "patchClaimTaskSchema")(async ({ nodeId, availableTaskList, traceId }) => {
+    const logger = createApiLogger("patchClaimTask", { traceId, nodeId });
+    try {
+        const { data: possibleTask } = await getPossibleTarget({
+            filterList: [
+                { field: "category", operator: "eq", value: CategoryTask.TASK },
+                { field: TASK_STATUS_FIELD, operator: "eq", value: TaskStatus.TODO },
+                { field: "value", operator: "in", value: availableTaskList },
+            ],
+        });
+        if (possibleTask == null) {
+            return generateResponse.success(null);
+        }
+        const todoTask = possibleTask;
+        const data = await claimTaskById({ taskId: todoTask.id, nodeId });
+        logTaskTransition(logger, "patchClaimTask", data);
+        return generateResponse.success(data);
+    }
+    catch (error) {
+        if (isOptimisticLockError(error)) {
+            logger.debug("認領競爭失敗，本輪無可認領任務", { topic: "task" });
+            return generateResponse.error(OPTIMISTIC_LOCK_FAILED_MESSAGE, undefined, "OPTIMISTIC_LOCK");
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error("認領任務失敗", { topic: "task", context: { error: message } });
+        return generateResponse.error(message);
+    }
+});
+// ─── postTask ────────────────────────────────────────────────────────────────
+/**
+ * Create a task row (scheduler / admin).
+ *
+ * `taskStatus` defaults to **TODO** (worker-claimable). Pass **OPEN** for draft tasks
+ * that require {@link patchChangeTaskStatus} `publish` before workers can claim.
+ */
+export const postTask = validateWithSchema(postTaskSchema, "postTaskSchema")(async ({ name, value, params, taskStatus, tagList, extra, traceId }) => {
+    const logger = createApiLogger("postTask", { traceId });
+    const result = await createTarget({
+        payload: { name, value, params, taskStatus, tagList, extra, traceId },
+        createFn: () => ({
+            name,
+            value,
+            category: CategoryTask.TASK,
+            tagList,
+            extra,
+            details: {
+                manifestVersion: 0,
+                status: taskStatus,
+                params,
+                progress: 0,
+                nodeId: null,
+            },
+        }),
+    });
+    logger.info("任務已創建", {
+        topic: "task",
+        context: {
+            taskId: result.data?.id,
+            taskTypeKey: value,
+            status: taskStatus,
+        },
+    });
+    return result;
+});
 //# sourceMappingURL=task.api.js.map

package/dist/task/task.api.js.map

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

package/dist/task/task.interface.d.ts

@@ -1,5 +1,4 @@
 import { Target } from "../core.interface";
-import { Repo } from "../repo/repo.interface";
 export declare enum CategoryTask {
     TASK = "task"
 }
@@ -10,6 +9,15 @@ export declare enum TaskStatus {
     DONE = "DONE",
     CLOSED = "CLOSED"
 }
+/** Named transitions for {@link patchChangeTaskStatus} — verb aligned with state machine edges */
+export declare enum TaskStatusAction {
+    PUBLISH = "publish",
+    CLAIM = "claim",
+    RESET = "reset",
+    CANCEL = "cancel",
+    CLOSE = "close",
+    FINISH = "finish"
+}
 export declare enum ResultCode {
     SUCCESS = 1000,
     /** 3xxx 依赖 / 外部 */
@@ -32,7 +40,6 @@ export interface Task extends Target {
 export interface TaskDetails {
     manifestVersion: number;
     status: TaskStatus;
-    repo: Repo;
     params: unknown;
     /** [0,100] */
     progress: number;

package/dist/task/task.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task.interface.d.ts","sourceRoot":"","sources":["../../src/task/task.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,oBAAY,UAAU;IAClB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;CACpB;AAED,oBAAY,UAAU;IAClB,OAAO,OAAO;IAEd,mBAAmB;IACnB,gBAAgB,OAAO;IACvB,cAAc,OAAO;IAErB,kBAAkB;IAClB,OAAO,OAAO;IACd,SAAS,OAAO;IAChB,gBAAgB,OAAO;IAEvB,aAAa,OAAO;CACvB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,UAAU,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,OAAO,CAAC;KAClB,CAAA;CACJ;AAGD,MAAM,WAAW,QAAS,SAAQ,MAAM;CAEvC"}
+{"version":3,"file":"task.interface.d.ts","sourceRoot":"","sources":["../../src/task/task.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,oBAAY,UAAU;IAClB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;CACpB;AAED,kGAAkG;AAClG,oBAAY,gBAAgB;IACxB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,MAAM,WAAW;CACpB;AAED,oBAAY,UAAU;IAClB,OAAO,OAAO;IAEd,mBAAmB;IACnB,gBAAgB,OAAO;IACvB,cAAc,OAAO;IAErB,kBAAkB;IAClB,OAAO,OAAO;IACd,SAAS,OAAO;IAChB,gBAAgB,OAAO;IAEvB,aAAa,OAAO;CACvB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,UAAU,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,OAAO,CAAC;KAClB,CAAA;CACJ;AAGD,MAAM,WAAW,QAAS,SAAQ,MAAM;CAEvC"}

package/dist/task/task.interface.js

@@ -10,6 +10,16 @@ export var TaskStatus;
     TaskStatus["DONE"] = "DONE";
     TaskStatus["CLOSED"] = "CLOSED";
 })(TaskStatus || (TaskStatus = {}));
+/** Named transitions for {@link patchChangeTaskStatus} — verb aligned with state machine edges */
+export var TaskStatusAction;
+(function (TaskStatusAction) {
+    TaskStatusAction["PUBLISH"] = "publish";
+    TaskStatusAction["CLAIM"] = "claim";
+    TaskStatusAction["RESET"] = "reset";
+    TaskStatusAction["CANCEL"] = "cancel";
+    TaskStatusAction["CLOSE"] = "close";
+    TaskStatusAction["FINISH"] = "finish";
+})(TaskStatusAction || (TaskStatusAction = {}));
 export var ResultCode;
 (function (ResultCode) {
     ResultCode[ResultCode["SUCCESS"] = 1000] = "SUCCESS";

package/dist/task/task.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"task.interface.js","sourceRoot":"","sources":["../../src/task/task.interface.ts"],"names":[],"mappings":"AAGA,MAAM,CAAN,IAAY,YAEX;AAFD,WAAY,YAAY;IACpB,6BAAa,CAAA;AACjB,CAAC,EAFW,YAAY,KAAZ,YAAY,QAEvB;AAED,MAAM,CAAN,IAAY,UAMX;AAND,WAAY,UAAU;IAClB,2BAAa,CAAA;IACb,2BAAa,CAAA;IACb,6BAAe,CAAA;IACf,2BAAa,CAAA;IACb,+BAAiB,CAAA;AACrB,CAAC,EANW,UAAU,KAAV,UAAU,QAMrB;AAED,MAAM,CAAN,IAAY,UAaX;AAbD,WAAY,UAAU;IAClB,oDAAc,CAAA;IAEd,mBAAmB;IACnB,sEAAuB,CAAA;IACvB,kEAAqB,CAAA;IAErB,kBAAkB;IAClB,oDAAc,CAAA;IACd,wDAAgB,CAAA;IAChB,sEAAuB,CAAA;IAEvB,gEAAoB,CAAA;AACxB,CAAC,EAbW,UAAU,KAAV,UAAU,QAarB;AAyBA,CAAC"}
+{"version":3,"file":"task.interface.js","sourceRoot":"","sources":["../../src/task/task.interface.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,YAEX;AAFD,WAAY,YAAY;IACpB,6BAAa,CAAA;AACjB,CAAC,EAFW,YAAY,KAAZ,YAAY,QAEvB;AAED,MAAM,CAAN,IAAY,UAMX;AAND,WAAY,UAAU;IAClB,2BAAa,CAAA;IACb,2BAAa,CAAA;IACb,6BAAe,CAAA;IACf,2BAAa,CAAA;IACb,+BAAiB,CAAA;AACrB,CAAC,EANW,UAAU,KAAV,UAAU,QAMrB;AAED,kGAAkG;AAClG,MAAM,CAAN,IAAY,gBAOX;AAPD,WAAY,gBAAgB;IACxB,uCAAmB,CAAA;IACnB,mCAAe,CAAA;IACf,mCAAe,CAAA;IACf,qCAAiB,CAAA;IACjB,mCAAe,CAAA;IACf,qCAAiB,CAAA;AACrB,CAAC,EAPW,gBAAgB,KAAhB,gBAAgB,QAO3B;AAED,MAAM,CAAN,IAAY,UAaX;AAbD,WAAY,UAAU;IAClB,oDAAc,CAAA;IAEd,mBAAmB;IACnB,sEAAuB,CAAA;IACvB,kEAAqB,CAAA;IAErB,kBAAkB;IAClB,oDAAc,CAAA;IACd,wDAAgB,CAAA;IAChB,sEAAuB,CAAA;IAEvB,gEAAoB,CAAA;AACxB,CAAC,EAbW,UAAU,KAAV,UAAU,QAarB;AAwBA,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "target-supabase-sdk",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Supabase client initializer and data access APIs",
   "license": "MIT",
   "author": "KyLoc20",
@@ -34,6 +34,10 @@
     "clean": "node --input-type=module -e \"import fs from 'node:fs'; fs.rmSync('dist', { recursive: true, force: true })\"",
     "build": "pnpm clean && tsc -p tsconfig.build.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck:scripts": "tsc -p tsconfig.scripts.json",
+    "worker": "tsx scripts/run-node-worker.ts",
+    "post-task": "tsx scripts/post-task.ts",
+    "post-command": "tsx scripts/post-command.ts",
     "dev": "tsc -p tsconfig.build.json --watch",
     "pack:check": "npm pack --dry-run",
     "prepack": "pnpm build"
@@ -41,7 +45,8 @@
   "peerDependencies": {
     "@supabase/postgrest-js": "^1.19.0",
     "@supabase/supabase-js": "^2.50.0",
-    "lodash-es": "^4.17.21"
+    "lodash-es": "^4.17.21",
+    "zod": "^3.23.0"
   },
   "devDependencies": {
     "@supabase/postgrest-js": "1.19.4",
@@ -49,7 +54,9 @@
     "@types/lodash-es": "^4.17.12",
     "@types/wicg-file-system-access": "^2023.10.7",
     "lodash-es": "^4.17.21",
-    "typescript": "~5.7.2"
+    "typescript": "~5.7.2",
+    "tsx": "^4.19.4",
+    "zod": "^3.24.0"
   },
   "publishConfig": {
     "access": "public"

package/src/auth/auth.api.ts

@@ -1,7 +1,9 @@
-import { supabase } from "..";
+import { SupabaseInitializer } from "../supabase";
 import { generateResponse } from "../core.interface";
 import { handleSupabaseError } from "../core.utils";
 
+const supabase = SupabaseInitializer.getInstance();
+
 export interface LoginPayload {
   email: string;
   password: string;

package/src/command/command.api.ts

@@ -0,0 +1,88 @@
+import {
+    createTarget,
+    MAX_POLL_TARGET_LIST_SIZE,
+    pollTargetList,
+    validateWithSchema,
+} from "../core.api";
+import { generateResponse } from "../core.interface";
+import { createApiLogger } from "../shared/log/log-manager";
+import { z } from "zod";
+import { CategoryCommand, Command, CommandType } from "./command.interface";
+
+const nodeIdSchema = z.string().trim().min(1);
+const traceIdSchema = z.string().trim().min(1).optional();
+
+// ─── Zod schemas ─────────────────────────────────────────────────────────────
+
+export const postCommandSchema = z.object({
+    nodeId: nodeIdSchema,
+    command: z.nativeEnum(CommandType),
+    traceId: traceIdSchema,
+});
+
+export type PostCommandPayload = z.infer<typeof postCommandSchema>;
+
+export const getPollCommandListSchema = z.object({
+    nodeId: nodeIdSchema,
+    size: z.number().int().min(1).max(MAX_POLL_TARGET_LIST_SIZE).optional(),
+    traceId: traceIdSchema,
+});
+
+export type GetPollCommandListPayload = z.infer<typeof getPollCommandListSchema>;
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
+function commandNodeFilter(nodeId: string) {
+    return [{ field: "value", operator: "eq" as const, value: nodeId }];
+}
+
+// ─── postCommand ─────────────────────────────────────────────────────────────
+
+/** Enqueue a control command for `nodeId` (scheduler / admin). */
+export const postCommand = validateWithSchema(
+    postCommandSchema,
+    "postCommandSchema"
+)(async ({ nodeId, command, traceId }) => {
+    const logger = createApiLogger("postCommand", { traceId, nodeId });
+
+    const result = await createTarget<Command, PostCommandPayload>({
+        payload: { nodeId, command, traceId },
+        createFn: () => ({
+            name: command,
+            value: nodeId,
+            category: CategoryCommand.COMMAND,
+            tagList: [],
+        }),
+    });
+
+    logger.info("Command已入隊", {
+        topic: "command",
+        context: { nodeId, command },
+    });
+
+    return result;
+});
+
+// ─── getPollCommandList ──────────────────────────────────────────────────────
+
+/** Dequeue control commands for `nodeId` (oldest first). */
+export const getPollCommandList = validateWithSchema(
+    getPollCommandListSchema,
+    "getPollCommandListSchema"
+)(async ({ nodeId, size, traceId }) => {
+    const logger = createApiLogger("getPollCommandList", { traceId, nodeId });
+
+    const { data: dequeuedList = [] } = await pollTargetList<Command>({
+        category: CategoryCommand.COMMAND,
+        size: size ?? 50,
+        filterList: commandNodeFilter(nodeId),
+        ascending: true,
+    });
+
+    logger.info("Command", {
+        topic: "command",
+        context: { nodeId, dequeued: dequeuedList.length },
+    });
+
+    return generateResponse.success(dequeuedList);
+});

package/src/command/command.interface.ts

@@ -0,0 +1,17 @@
+import { Target } from "../core.interface";
+
+
+export enum CategoryCommand {
+    COMMAND = "command",
+}
+
+export enum CommandType {
+    STOP_NODE = "stop-node",
+}
+
+export interface Command extends Target {
+    name: CommandType;
+    /** Node.id */
+    value: string;
+    category: CategoryCommand;
+}