target-supabase-sdk 0.1.8 → 0.2.0

package/dist/task/task.api.js

@@ -1,2 +1,303 @@
-"use strict";
+import { getPossibleTarget, updateTargetDetails, validateWithSchema, isOptimisticLockError, OPTIMISTIC_LOCK_FAILED_MESSAGE } from "../core.api";
+import { generateResponse } from "../core.interface";
+import { createApiLogger } from "../shared/log";
+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. TaskNode loop) passes its trace to correlate logs. */
+const traceIdSchema = z.string().trim().min(1).optional();
+const traceParentIdSchema = z.string().trim().min(1).nullable().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,
+});
+// ─── 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, data) {
+    logger.info("任务状态迁移成功", {
+        topic: "task",
+        data: {
+            action,
+            taskId: task.id,
+            taskValue: task.value,
+            status: task.details.status,
+            nodeId: task.details.nodeId,
+            ...data,
+        },
+    });
+}
+/** 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;
+            const message = `[patchChangeTaskStatus] Unknown action: ${String(_exhaustive)}`;
+            logger.error(message, { topic: "task", data: { action: String(_exhaustive) } });
+            return generateResponse.error(message);
+        }
+    }
+});
+// ─── 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, labels: { 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, labels: { 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", data: { error: message } });
+        return generateResponse.error(message);
+    }
+});
 //# 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,11 +40,12 @@ export interface Task extends Target {
 export interface TaskDetails {
     manifestVersion: number;
     status: TaskStatus;
-    repo: Repo;
     params: unknown;
     /** [0,100] */
     progress: number;
     nodeId: null | string;
+    /** Task lifecycle correlation id (written at postTask). */
+    traceId?: string;
     result?: {
         cost: number;
         code: ResultCode;

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,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,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;AA0BA,CAAC"}

package/dist/trigger/trigger.api.d.ts

@@ -0,0 +1,140 @@
+import { type SupabaseResponse } from "../core.interface";
+import { TaskStatus } from "../task/task.interface";
+import { z } from "zod";
+import { Trigger, TriggerStatus } from "./trigger.interface";
+export declare const postTriggerSchema: z.ZodObject<{
+    name: z.ZodString;
+    value: z.ZodString;
+    status: z.ZodDefault<z.ZodOptional<z.ZodNativeEnum<typeof TriggerStatus>>>;
+    schedule: z.ZodObject<{
+        kind: z.ZodLiteral<"daily">;
+        hour: z.ZodNumber;
+        minute: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        hour: number;
+        minute: number;
+        kind: "daily";
+    }, {
+        hour: number;
+        minute: number;
+        kind: "daily";
+    }>;
+    action: z.ZodObject<{
+        kind: z.ZodLiteral<"post_task">;
+        taskTypeKey: z.ZodString;
+        taskParams: z.ZodUnknown;
+        taskName: z.ZodOptional<z.ZodString>;
+        taskStatus: z.ZodOptional<z.ZodEnum<[TaskStatus.OPEN, TaskStatus.TODO]>>;
+    }, "strip", z.ZodTypeAny, {
+        taskTypeKey: string;
+        kind: "post_task";
+        taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
+        taskParams?: unknown;
+        taskName?: string | undefined;
+    }, {
+        taskTypeKey: string;
+        kind: "post_task";
+        taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
+        taskParams?: unknown;
+        taskName?: string | undefined;
+    }>;
+    tagList: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    value: string;
+    tagList: string[];
+    action: {
+        taskTypeKey: string;
+        kind: "post_task";
+        taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
+        taskParams?: unknown;
+        taskName?: string | undefined;
+    };
+    status: TriggerStatus;
+    schedule: {
+        hour: number;
+        minute: number;
+        kind: "daily";
+    };
+    traceId?: string | undefined;
+}, {
+    name: string;
+    value: string;
+    action: {
+        taskTypeKey: string;
+        kind: "post_task";
+        taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
+        taskParams?: unknown;
+        taskName?: string | undefined;
+    };
+    schedule: {
+        hour: number;
+        minute: number;
+        kind: "daily";
+    };
+    tagList?: string[] | undefined;
+    traceId?: string | undefined;
+    status?: TriggerStatus | undefined;
+}>;
+export type PostTriggerPayload = z.infer<typeof postTriggerSchema>;
+export declare const scanEnabledTriggersSchema: z.ZodObject<{
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    traceId?: string | undefined;
+}, {
+    traceId?: string | undefined;
+}>;
+export type ScanEnabledTriggersPayload = z.infer<typeof scanEnabledTriggersSchema>;
+export declare const patchTriggerFiredSchema: z.ZodObject<{
+    triggerId: z.ZodString;
+    fireKey: z.ZodString;
+    expectedLastFireKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    triggerId: string;
+    fireKey: string;
+    traceId?: string | undefined;
+    expectedLastFireKey?: string | null | undefined;
+}, {
+    triggerId: string;
+    fireKey: string;
+    traceId?: string | undefined;
+    expectedLastFireKey?: string | null | undefined;
+}>;
+export type PatchTriggerFiredPayload = z.infer<typeof patchTriggerFiredSchema>;
+/** List all ENABLED triggers (Phase 1: in-memory due check). */
+export declare const scanEnabledTriggers: (payload: {
+    traceId?: string | undefined;
+}) => SupabaseResponse<Trigger[]> | Promise<SupabaseResponse<Trigger[]>>;
+/** Create a trigger row (scheduler / admin). */
+export declare const postTrigger: (payload: {
+    name: string;
+    value: string;
+    tagList: string[];
+    action: {
+        taskTypeKey: string;
+        kind: "post_task";
+        taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
+        taskParams?: unknown;
+        taskName?: string | undefined;
+    };
+    status: TriggerStatus;
+    schedule: {
+        hour: number;
+        minute: number;
+        kind: "daily";
+    };
+    traceId?: string | undefined;
+}) => SupabaseResponse<Trigger> | Promise<SupabaseResponse<Trigger>>;
+/**
+ * Mark trigger as fired for `fireKey`.
+ * When `expectedLastFireKey` is set, uses optimistic lock on that field.
+ */
+export declare const patchTriggerFired: (payload: {
+    triggerId: string;
+    fireKey: string;
+    traceId?: string | undefined;
+    expectedLastFireKey?: string | null | undefined;
+}) => SupabaseResponse<unknown> | Promise<SupabaseResponse<unknown>>;
+//# sourceMappingURL=trigger.api.d.ts.map

package/dist/trigger/trigger.api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.api.d.ts","sourceRoot":"","sources":["../../src/trigger/trigger.api.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEH,OAAO,EACP,aAAa,EAGhB,MAAM,qBAAqB,CAAC;AAoB7B,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ5B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEnE,eAAO,MAAM,yBAAyB;;;;;;EAEpC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEnF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAM/E,gEAAgE;AAChE,eAAO,MAAM,mBAAmB;;wEAwB9B,CAAC;AAEH,gDAAgD;AAChD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;oEAgCtB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;oEAqC5B,CAAC"}

package/dist/trigger/trigger.api.js

@@ -0,0 +1,125 @@
+import { createTarget, scanTargetList, updateTargetDetails, validateWithSchema } from "../core.api";
+import { generateResponse } from "../core.interface";
+import { TaskStatus } from "../task/task.interface";
+import { createApiLogger } from "../shared/log";
+import { z } from "zod";
+import { CategoryTrigger, TriggerStatus, } from "./trigger.interface";
+const TRIGGER_STATUS_FIELD = "details->>status";
+const traceIdSchema = z.string().trim().min(1).optional();
+const dailyScheduleSchema = z.object({
+    kind: z.literal("daily"),
+    hour: z.number().int().min(0).max(23),
+    minute: z.number().int().min(0).max(59),
+});
+const postTaskActionSchema = z.object({
+    kind: z.literal("post_task"),
+    taskTypeKey: z.string().trim().min(1),
+    taskParams: z.unknown(),
+    taskName: z.string().trim().min(1).optional(),
+    taskStatus: z.enum([TaskStatus.OPEN, TaskStatus.TODO]).optional(),
+});
+export const postTriggerSchema = z.object({
+    name: z.string().trim().min(1),
+    value: z.string().trim().min(1),
+    status: z.nativeEnum(TriggerStatus).optional().default(TriggerStatus.ENABLED),
+    schedule: dailyScheduleSchema,
+    action: postTaskActionSchema,
+    tagList: z.array(z.string()).optional().default([]),
+    traceId: traceIdSchema,
+});
+export const scanEnabledTriggersSchema = z.object({
+    traceId: traceIdSchema,
+});
+export const patchTriggerFiredSchema = z.object({
+    triggerId: z.string().trim().min(1),
+    fireKey: z.string().trim().min(1),
+    expectedLastFireKey: z.string().nullable().optional(),
+    traceId: traceIdSchema,
+});
+function enabledTriggerFilter() {
+    return [{ field: TRIGGER_STATUS_FIELD, operator: "eq", value: TriggerStatus.ENABLED }];
+}
+/** List all ENABLED triggers (Phase 1: in-memory due check). */
+export const scanEnabledTriggers = validateWithSchema(scanEnabledTriggersSchema, "scanEnabledTriggersSchema")(async ({ traceId }) => {
+    const logger = createApiLogger("scanEnabledTriggers", { traceId });
+    try {
+        const { data: triggerList } = await scanTargetList({
+            category: CategoryTrigger.TRIGGER,
+            filterList: enabledTriggerFilter(),
+            orderBy: { field: "created_at", ascending: true },
+        });
+        const rows = triggerList ?? [];
+        logger.info("已掃描 ENABLED Trigger", {
+            topic: "trigger",
+            data: { count: rows.length },
+        });
+        return generateResponse.success(rows);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return generateResponse.error(message);
+    }
+});
+/** Create a trigger row (scheduler / admin). */
+export const postTrigger = validateWithSchema(postTriggerSchema, "postTriggerSchema")(async ({ name, value, status, schedule, action, tagList, traceId }) => {
+    const logger = createApiLogger("postTrigger", { traceId });
+    const details = {
+        manifestVersion: 0,
+        status,
+        schedule: schedule,
+        action: action,
+        lastFiredAt: null,
+        lastFireKey: null,
+    };
+    const result = await createTarget({
+        payload: { name, value, status, schedule, action, tagList, traceId },
+        createFn: () => ({
+            name,
+            value,
+            category: CategoryTrigger.TRIGGER,
+            tagList,
+            details,
+        }),
+    });
+    logger.info("Trigger 已創建", {
+        topic: "trigger",
+        data: { triggerId: result.data?.id, triggerKey: value, status },
+    });
+    return result;
+});
+/**
+ * Mark trigger as fired for `fireKey`.
+ * When `expectedLastFireKey` is set, uses optimistic lock on that field.
+ */
+export const patchTriggerFired = validateWithSchema(patchTriggerFiredSchema, "patchTriggerFiredSchema")(async ({ triggerId, fireKey, expectedLastFireKey, traceId }) => {
+    const logger = createApiLogger("patchTriggerFired", { traceId });
+    const now = Date.now();
+    try {
+        const optimisticLockFilterList = expectedLastFireKey != null && expectedLastFireKey !== ""
+            ? [{ field: "details->>lastFireKey", operator: "eq", value: expectedLastFireKey }]
+            : [];
+        const data = await updateTargetDetails({
+            id: triggerId,
+            optimisticLockFilterList,
+            updateFn: (current) => ({
+                ...current,
+                lastFireKey: fireKey,
+                lastFiredAt: now,
+            }),
+        });
+        logger.success("Trigger 觸發記錄已更新", {
+            topic: "trigger",
+            data: { triggerId, fireKey },
+        });
+        return generateResponse.success(data);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.warn("Trigger 觸發記錄更新失敗", {
+            topic: "trigger",
+            data: { triggerId, fireKey, error: message },
+        });
+        return generateResponse.error(message);
+    }
+});
+//# sourceMappingURL=trigger.api.js.map