target-supabase-sdk 0.2.22 → 0.2.23

package/dist/task/task-node.d.ts

@@ -1,5 +1,6 @@
 import { BaseNodeRuntime, type NodeLoopContext } from "../node/node-runtime.base";
 import { type LoggerWithScope } from "../shared/log";
+import { type PatchClaimTaskPayload } from "./task.api";
 /**
  * Task worker node: commands → heartbeat → claim & execute tasks.
  * Built on {@link BaseNodeRuntime}.
@@ -8,6 +9,8 @@ declare class TaskNode extends BaseNodeRuntime {
     private _availableTaskList;
     private _includeRemote;
     get availableTaskList(): readonly string[];
+    /** Optional claim filters passed to {@link patchClaimTask} (e.g. name prefix per task type). */
+    protected getPatchClaimTaskOptions(): Pick<PatchClaimTaskPayload, "namePrefixList">;
     constructor();
     protected onBeforeRegisterNode(logger: LoggerWithScope): Promise<void>;
     protected runLoopSteps(ctx: NodeLoopContext, heartbeatOk: boolean): Promise<void>;

package/dist/task/task-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-node.d.ts","sourceRoot":"","sources":["../../src/task/task-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAkB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAA6B,KAAK,eAAe,EAAc,MAAM,eAAe,CAAC;AAO5F;;;GAGG;AACH,cAAM,QAAS,SAAQ,eAAe;IAClC,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,cAAc,CAAQ;IAE9B,IAAI,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAEzC;;cAMe,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAM5D,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YAezE,WAAW;YA6KX,YAAY;YA2BZ,eAAe;CAqDhC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"task-node.d.ts","sourceRoot":"","sources":["../../src/task/task-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAkB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAA6B,KAAK,eAAe,EAAc,MAAM,eAAe,CAAC;AAE5F,OAAO,EAAE,KAAK,qBAAqB,EAAyC,MAAM,YAAY,CAAC;AAK/F;;;GAGG;AACH,cAAM,QAAS,SAAQ,eAAe;IAClC,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,cAAc,CAAQ;IAE9B,IAAI,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAEzC;IAED,gGAAgG;IAChG,SAAS,CAAC,wBAAwB,IAAI,IAAI,CAAC,qBAAqB,EAAE,gBAAgB,CAAC;;cAQnE,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAM5D,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YAezE,WAAW;YA8KX,YAAY;YA2BZ,eAAe;CAqDhC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/task/task.api.d.ts

@@ -127,16 +127,24 @@ export declare const patchTaskProgressSchema: z.ZodObject<{
 export type PatchTaskProgressPayload = z.infer<typeof patchTaskProgressSchema>;
 export declare const patchClaimTaskSchema: z.ZodObject<{
     nodeId: z.ZodString;
+    /** Task `value` must be in this list (always applied). */
     availableTaskList: z.ZodArray<z.ZodString, "many">;
     traceId: z.ZodOptional<z.ZodString>;
+    /**
+     * Optional second axis on `name` (AND with `availableTaskList`, not coupled to `value`).
+     * When non-empty: `name` must equal a prefix or start with `prefix:`; query uses PostgREST `ilike`.
+     */
+    namePrefixList: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     nodeId: string;
     availableTaskList: string[];
     traceId?: string | undefined;
+    namePrefixList?: string[] | undefined;
 }, {
     nodeId: string;
     availableTaskList: string[];
     traceId?: string | undefined;
+    namePrefixList?: string[] | undefined;
 }>;
 export type PatchClaimTaskPayload = z.infer<typeof patchClaimTaskSchema>;
 export declare const patchChangeTaskStatus: (payload: {
@@ -185,7 +193,11 @@ export declare const patchTaskProgress: (payload: {
 /**
  * Discover and claim one TODO task for this node.
  *
- * Flow: oldest TODO in `availableTaskList` (FIFO by `created_at`) → {@link claimTaskById}.
+ * Match criteria (all required): `details.status = TODO`, `value ∈ availableTaskList`, and when
+ * `namePrefixList` is non-empty, `name` matches any listed prefix. Those filters are independent
+ * (AND); omitting `namePrefixList` does not relax the `value` constraint.
+ *
+ * Flow: oldest matching row (FIFO by `created_at`) → {@link claimTaskById}.
  * Equivalent to `patchChangeTaskStatus({ id, action: CLAIM, nodeId })` when `id` is already known.
  *
  * Returns `data: null` when no TODO task matches.
@@ -195,5 +207,6 @@ export declare const patchClaimTask: (payload: {
     nodeId: string;
     availableTaskList: string[];
     traceId?: string | undefined;
+    namePrefixList?: string[] | undefined;
 }) => SupabaseResponse<Task | null> | Promise<SupabaseResponse<Task | null>>;
 //# sourceMappingURL=task.api.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"task.api.d.ts","sourceRoot":"","sources":["../../src/task/task.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI5E,OAAO,EAA4B,KAAK,IAAI,EAAgC,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA0DvH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2BtC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEvF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE/E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAgGzE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEAmGhC,CAAC;AAIH,gGAAgG;AAChG,eAAO,MAAM,iBAAiB;;;;;8DAe5B,CAAC;AAIH;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc;;;;4EA0DzB,CAAC"}
+{"version":3,"file":"task.api.d.ts","sourceRoot":"","sources":["../../src/task/task.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAM5E,OAAO,EAA4B,KAAK,IAAI,EAAgC,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA0DvH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2BtC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEvF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE/E,eAAO,MAAM,oBAAoB;;IAE7B,0DAA0D;;;IAG1D;;;OAGG;;;;;;;;;;;;EAEL,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AA0GzE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEAmGhC,CAAC;AAIH,gGAAgG;AAChG,eAAO,MAAM,iBAAiB;;;;;8DAe5B,CAAC;AAIH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc;;;;;4EAkFzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "target-supabase-sdk",
-    "version": "0.2.22",
+    "version": "0.2.23",
     "description": "Supabase client initializer and data access APIs",
     "license": "MIT",
     "author": "KyLoc20",

package/src/task/task-node.ts

@@ -2,7 +2,7 @@ import { isOptimisticLockResponse } from "../core.api";
 import { BaseNodeRuntime, LOG_TOPIC_NODE, type NodeLoopContext } from "../node/node-runtime.base";
 import { createLogger, createScope, type LoggerWithScope, withModule } from "../shared/log";
 import { getErrorMessage, toError } from "../shared/utils/error.utils";
-import { patchChangeTaskStatus, patchClaimTask } from "./task.api";
+import { type PatchClaimTaskPayload, patchChangeTaskStatus, patchClaimTask } from "./task.api";
 import { CRITICAL_UNKNOWN_TASK_TRACE_ID, LOG_TOPIC_TASK } from "./task.constant";
 import { TaskStatusAction } from "./task.interface";
 import { TaskManager, type TaskRunResult } from "./task-manager";
@@ -19,6 +19,11 @@ class TaskNode extends BaseNodeRuntime {
         return [...this._availableTaskList];
     }
 
+    /** Optional claim filters passed to {@link patchClaimTask} (e.g. name prefix per task type). */
+    protected getPatchClaimTaskOptions(): Pick<PatchClaimTaskPayload, "namePrefixList"> {
+        return {};
+    }
+
     constructor() {
         super("taskNode");
     }
@@ -63,6 +68,7 @@ class TaskNode extends BaseNodeRuntime {
             nodeId,
             availableTaskList: [...availableTaskList],
             traceId: loopTraceId,
+            ...this.getPatchClaimTaskOptions(),
         });
         if (claimError) {
             if (isOptimisticLockResponse(claimError)) {

package/src/task/task.api.ts

@@ -5,12 +5,15 @@ import {
     OPTIMISTIC_LOCK_ERROR_CODE,
     OPTIMISTIC_LOCK_FAILED_MESSAGE,
     type QueryFilter,
+    type TargetFilterBuilder,
     updateTargetDetails,
     validateWithSchema,
 } from "../core.api";
 import { generateResponse, type SupabaseResponse } from "../core.interface";
 import { createLogger, type LoggerWithScope } from "../shared/log";
 import { getErrorMessage } from "../shared/utils/error.utils";
+import { escapeIlikePattern } from "../shared/utils/postgrest.utils";
+import { supabase } from "../supabase";
 import { LOG_TOPIC_TASK } from "./task.constant";
 import { CategoryTask, ResultCode, type Task, type TaskDetails, TaskStatus, TaskStatusAction } from "./task.interface";
 
@@ -112,12 +115,28 @@ export type PatchTaskProgressPayload = z.infer<typeof patchTaskProgressSchema>;
 
 export const patchClaimTaskSchema = z.object({
     nodeId: nodeIdSchema,
+    /** Task `value` must be in this list (always applied). */
     availableTaskList: z.array(z.string()).min(1),
     traceId: traceIdSchema,
+    /**
+     * Optional second axis on `name` (AND with `availableTaskList`, not coupled to `value`).
+     * When non-empty: `name` must equal a prefix or start with `prefix:`; query uses PostgREST `ilike`.
+     */
+    namePrefixList: z.array(z.string().trim().min(1)).optional(),
 });
 
 export type PatchClaimTaskPayload = z.infer<typeof patchClaimTaskSchema>;
 
+/** `name === prefix` or `name.startsWith(prefix + ':')` via `name ilike 'prefix%'`. */
+function buildClaimTaskNamePrefixFilterBuilder(namePrefixes: string[]): TargetFilterBuilder {
+    const base = supabase.client.from("target").select("*");
+    if (namePrefixes.length === 1) {
+        return base.ilike("name", `${escapeIlikePattern(namePrefixes[0])}%`);
+    }
+    const nameOrParts = namePrefixes.map((prefix) => `name.ilike.${escapeIlikePattern(prefix)}%`);
+    return base.or(nameOrParts.join(","));
+}
+
 // ─── Optimistic lock helpers ─────────────────────────────────────────────────
 
 function lockOnStatus(...allowed: TaskStatus[]): QueryFilter[] {
@@ -338,7 +357,11 @@ export const patchTaskProgress = validateWithSchema(
 /**
  * Discover and claim one TODO task for this node.
  *
- * Flow: oldest TODO in `availableTaskList` (FIFO by `created_at`) → {@link claimTaskById}.
+ * Match criteria (all required): `details.status = TODO`, `value ∈ availableTaskList`, and when
+ * `namePrefixList` is non-empty, `name` matches any listed prefix. Those filters are independent
+ * (AND); omitting `namePrefixList` does not relax the `value` constraint.
+ *
+ * Flow: oldest matching row (FIFO by `created_at`) → {@link claimTaskById}.
  * Equivalent to `patchChangeTaskStatus({ id, action: CLAIM, nodeId })` when `id` is already known.
  *
  * Returns `data: null` when no TODO task matches.
@@ -347,25 +370,49 @@ export const patchTaskProgress = validateWithSchema(
 export const patchClaimTask = validateWithSchema(
     patchClaimTaskSchema,
     "patchClaimTaskSchema",
-)(async ({ nodeId, availableTaskList, traceId }): Promise<SupabaseResponse<Task | null>> => {
+)(async ({ nodeId, availableTaskList, traceId, namePrefixList }): Promise<SupabaseResponse<Task | null>> => {
     const logger = createLogger({ module: "patchClaimTask", traceId, labels: { nodeId } });
 
+    const namePrefixes = (namePrefixList ?? []).map((prefix) => prefix.trim()).filter((prefix) => prefix !== "");
+
+    function taskNameMatchesPrefixList(name: string): boolean {
+        return namePrefixes.some((prefix) => name === prefix || name.startsWith(`${prefix}:`));
+    }
+
     let todoTask: Task;
     try {
-        const { data: taskCandidates } = await getTargetList<Task>({
-            category: CategoryTask.TASK,
-            filterList: [
-                { field: TASK_STATUS_FIELD, operator: "eq", value: TaskStatus.TODO },
-                { field: "value", operator: "in", value: availableTaskList },
-            ],
-            limit: 1,
-            orderBy: { field: "created_at", ascending: true },
-        });
-        const possibleTask = taskCandidates?.[0] ?? null;
-        if (possibleTask == null) {
-            return generateResponse.success(null);
+        if (namePrefixes.length === 0) {
+            const { data: taskCandidates } = await getTargetList<Task>({
+                category: CategoryTask.TASK,
+                filterList: [
+                    { field: TASK_STATUS_FIELD, operator: "eq", value: TaskStatus.TODO },
+                    { field: "value", operator: "in", value: availableTaskList },
+                ],
+                limit: 1,
+                orderBy: { field: "created_at", ascending: true },
+            });
+            const possibleTask = taskCandidates?.[0] ?? null;
+            if (possibleTask == null) {
+                return generateResponse.success(null);
+            }
+            todoTask = possibleTask;
+        } else {
+            const { data: taskCandidates } = await getTargetList<Task>({
+                category: CategoryTask.TASK,
+                filterList: [
+                    { field: TASK_STATUS_FIELD, operator: "eq", value: TaskStatus.TODO },
+                    { field: "value", operator: "in", value: availableTaskList },
+                ],
+                limit: 1,
+                orderBy: { field: "created_at", ascending: true },
+                filterBuilder: buildClaimTaskNamePrefixFilterBuilder(namePrefixes),
+            });
+            const possibleTask = taskCandidates?.find((task) => taskNameMatchesPrefixList(task.name)) ?? null;
+            if (possibleTask == null) {
+                return generateResponse.success(null);
+            }
+            todoTask = possibleTask;
         }
-        todoTask = possibleTask;
     } catch (error) {
         const message = getErrorMessage(error);
         logger.error("獲取 TODO 任務失敗", { topic: LOG_TOPIC_TASK, data: { error: message, availableTaskList } });