target-supabase-sdk 0.1.8 → 0.2.0

package/dist/task/task-post.api.js

@@ -0,0 +1,91 @@
+import { createTarget, validateWithSchema } from "../core.api";
+import { generateResponse } from "../core.interface";
+import { createApiLogger, logManager } from "../shared/log";
+import { z } from "zod";
+import { CategoryTask, TaskStatus } from "./task.interface";
+import { TaskRepoValidation } from "./task-repo-validation";
+const traceIdSchema = z.string().trim().min(1).optional();
+const traceParentIdSchema = z.string().trim().min(1).nullable().optional();
+/** 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,
+    traceParentId: traceParentIdSchema,
+});
+/**
+ * Create a task row (scheduler / admin). **Node entry only** — requires local Repo bootstrap.
+ *
+ * @see target-supabase-sdk/node
+ */
+export const postTask = validateWithSchema(postTaskSchema, "postTaskSchema")(async ({ name, value, params, taskStatus, tagList, extra, traceId, traceParentId, }) => {
+    const taskTraceId = traceId?.trim() || logManager.generateTraceId();
+    const logger = createApiLogger("postTask", {
+        traceId: taskTraceId,
+        traceParentId: traceParentId ?? null,
+    });
+    const validation = await TaskRepoValidation.validate({
+        logger,
+        taskTypeKey: value,
+        params,
+        bootstrapLocal: true,
+    });
+    if (!validation.isValid) {
+        logger.warn(validation.message, {
+            topic: "task",
+            data: {
+                taskTypeKey: value,
+                reason: validation.reason,
+                step: validation.step,
+            },
+        });
+        return generateResponse.error(validation.message, undefined, String(validation.code));
+    }
+    const result = await createTarget({
+        payload: {
+            name,
+            value,
+            params,
+            taskStatus,
+            tagList,
+            extra,
+            traceId: taskTraceId,
+            traceParentId,
+        },
+        createFn: () => ({
+            name,
+            value,
+            category: CategoryTask.TASK,
+            tagList,
+            extra,
+            details: {
+                manifestVersion: 0,
+                status: taskStatus,
+                params,
+                progress: 0,
+                nodeId: null,
+                traceId: taskTraceId,
+            },
+        }),
+    });
+    logger.info("任務已創建", {
+        topic: "task",
+        data: {
+            taskId: result.data?.id,
+            taskTypeKey: value,
+            status: taskStatus,
+            traceId: taskTraceId,
+        },
+    });
+    return result;
+});
+//# sourceMappingURL=task-post.api.js.map

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

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

package/dist/task/task-repo-context.d.ts

@@ -0,0 +1,97 @@
+export interface TaskRunResult {
+    isSuccess: boolean;
+    cost: number;
+    extra: unknown;
+}
+export interface TaskFn {
+    displayName: string;
+    taskTypeKey: string;
+    (taskParams: unknown): Promise<TaskRunResult>;
+}
+/** Params already bound — used by node executor after prepareTask */
+export type ExecutableTaskFn = (() => Promise<TaskRunResult>) & {
+    displayName: string;
+    taskTypeKey: string;
+};
+/** Repo script module must expose this shape (see repo-context.utils). */
+export interface TaskRepoContext {
+    taskParamsValidator: (taskParams: unknown) => boolean;
+    taskFn: TaskFn;
+}
+/** Supabase `target.category` for rows that store task script payloads */
+export declare const TASK_REPO_SCRIPT_CATEGORY: "script";
+/**
+ * `target.details` for task script rows — not a separate Target subtype in repo.interface.
+ * Loaded dynamically to produce {@link TaskRepoContext}.
+ */
+export interface TaskRepoScriptDetails {
+    manifestVersion: number;
+    /** Inline ESM source — written to temp file then dynamically imported (Node) */
+    source?: string;
+    /** Absolute path to an ESM module on the worker machine */
+    modulePath?: string;
+    /** Named export to read TaskRepoContext from; default export if omitted */
+    exportName?: string;
+    /** Content hash for cache invalidation */
+    hash?: string;
+    /** Prefer this script as entry when multiple scripts exist for one repo */
+    isEntry?: boolean;
+}
+/** Minimal target row shape used by script loader (avoids a dedicated Script Target type). */
+export interface TaskRepoScriptRecord {
+    id: string;
+    value: string;
+    details: TaskRepoScriptDetails;
+}
+/** Host app root config at `config/task.config.js` — where to discover local task packages */
+export interface TaskRunnerRootConfig {
+    /** Directory containing one folder per task (relative to root config file), e.g. `"./tasks"` */
+    taskDir: string;
+}
+/** Per-task `task.config.js` inside `<taskDir>/<name>/` */
+export interface TaskLocalPackageConfig {
+    /** Must match `task.value` when claiming from Supabase */
+    taskTypeKey: string;
+    /** Entry module relative to this task folder, e.g. `"./index.mjs"` */
+    entry: string;
+    /** Named export on entry module; default export if omitted */
+    exportName?: string;
+    displayName?: string;
+    /** Skip registration when `false` (default `true`) */
+    enabled?: boolean;
+}
+export type BootstrapLocalTasksStatus = 
+/** Root config found and scan finished (individual tasks may still have errors) */
+"loaded"
+/** Root config found but zero tasks registered */
+ | "empty"
+/** No root config at default/explicit paths — not an error; use remote scripts or manual register */
+ | "not_configured"
+/** Root config or taskDir invalid */
+ | "failed";
+export interface BootstrapLocalTasksResult {
+    status: BootstrapLocalTasksStatus;
+    /** Human-readable summary for logs */
+    message?: string;
+    registered: string[];
+    skipped: {
+        taskDir: string;
+        reason: string;
+    }[];
+    errors: {
+        taskDir: string;
+        error: string;
+    }[];
+    /** True when scan was skipped due to unchanged config fingerprint */
+    cached?: boolean;
+}
+/** Host app config directory (relative to `cwd`) — recommended for library consumers */
+export declare const TASK_RUNNER_CONFIG_DIR: "config";
+export declare const TASK_RUNNER_ROOT_CONFIG_FILENAME: "task.config.js";
+/** Default root config path: `config/task.config.js` */
+export declare const TASK_RUNNER_ROOT_CONFIG_RELATIVE_PATH: "config/task.config.js";
+/** Legacy fallback at project root */
+export declare const TASK_RUNNER_ROOT_CONFIG_LEGACY_RELATIVE_PATH: "task.config.js";
+/** Per-task config filename inside each folder under `taskDir` */
+export declare const TASK_LOCAL_PACKAGE_CONFIG_FILENAME: "task.config.js";
+//# sourceMappingURL=task-repo-context.d.ts.map

package/dist/task/task-repo-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-repo-context.d.ts","sourceRoot":"","sources":["../../src/task/task-repo-context.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACjD;AAED,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC5B,mBAAmB,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC;IACtD,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,0EAA0E;AAC1E,eAAO,MAAM,yBAAyB,EAAG,QAAiB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,8FAA8F;AAC9F,MAAM,WAAW,oBAAoB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,qBAAqB,CAAC;CAClC;AAED,8FAA8F;AAC9F,MAAM,WAAW,oBAAoB;IACjC,gGAAgG;IAChG,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,2DAA2D;AAC3D,MAAM,WAAW,sBAAsB;IACnC,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,yBAAyB;AACjC,mFAAmF;AACjF,QAAQ;AACV,kDAAkD;GAChD,OAAO;AACT,qGAAqG;GACnG,gBAAgB;AAClB,qCAAqC;GACnC,QAAQ,CAAC;AAEf,MAAM,WAAW,yBAAyB;IACtC,MAAM,EAAE,yBAAyB,CAAC;IAClC,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,EAAG,QAAiB,CAAC;AAExD,eAAO,MAAM,gCAAgC,EAAG,gBAAyB,CAAC;AAE1E,wDAAwD;AACxD,eAAO,MAAM,qCAAqC,yBAA2E,CAAC;AAE9H,sCAAsC;AACtC,eAAO,MAAM,4CAA4C,kBAAmC,CAAC;AAE7F,kEAAkE;AAClE,eAAO,MAAM,kCAAkC,EAAG,gBAAyB,CAAC"}

package/dist/task/task-repo-context.js

@@ -0,0 +1,12 @@
+/** Supabase `target.category` for rows that store task script payloads */
+export const TASK_REPO_SCRIPT_CATEGORY = "script";
+/** Host app config directory (relative to `cwd`) — recommended for library consumers */
+export const TASK_RUNNER_CONFIG_DIR = "config";
+export const TASK_RUNNER_ROOT_CONFIG_FILENAME = "task.config.js";
+/** Default root config path: `config/task.config.js` */
+export const TASK_RUNNER_ROOT_CONFIG_RELATIVE_PATH = `${TASK_RUNNER_CONFIG_DIR}/${TASK_RUNNER_ROOT_CONFIG_FILENAME}`;
+/** Legacy fallback at project root */
+export const TASK_RUNNER_ROOT_CONFIG_LEGACY_RELATIVE_PATH = TASK_RUNNER_ROOT_CONFIG_FILENAME;
+/** Per-task config filename inside each folder under `taskDir` */
+export const TASK_LOCAL_PACKAGE_CONFIG_FILENAME = "task.config.js";
+//# sourceMappingURL=task-repo-context.js.map

package/dist/task/task-repo-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-repo-context.js","sourceRoot":"","sources":["../../src/task/task-repo-context.ts"],"names":[],"mappings":"AAwBA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,yBAAyB,GAAG,QAAiB,CAAC;AAmE3D,wFAAwF;AACxF,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAiB,CAAC;AAExD,MAAM,CAAC,MAAM,gCAAgC,GAAG,gBAAyB,CAAC;AAE1E,wDAAwD;AACxD,MAAM,CAAC,MAAM,qCAAqC,GAAG,GAAG,sBAAsB,IAAI,gCAAgC,EAAW,CAAC;AAE9H,sCAAsC;AACtC,MAAM,CAAC,MAAM,4CAA4C,GAAG,gCAAgC,CAAC;AAE7F,kEAAkE;AAClE,MAAM,CAAC,MAAM,kCAAkC,GAAG,gBAAyB,CAAC"}

package/dist/task/task-repo-validation.d.ts

@@ -0,0 +1,46 @@
+import { type RepoContextFailureReason } from "../repo/repo-manager";
+import { LoggerWithScope } from "../shared/log";
+import { type BootstrapLocalTasksOptions } from "./local-task-registry";
+import { ResultCode } from "./task.interface";
+import type { TaskRepoContext } from "./task-repo-context";
+export type TaskRepoValidationFailureReason = "MISSING_PARAMS" | RepoContextFailureReason | "PARAMS_VALIDATION_FAILED" | "TASK_TYPE_KEY_MISMATCH";
+export type ValidateTaskRepoAndParamsInput = {
+    logger: LoggerWithScope;
+    taskTypeKey: string;
+    params: unknown;
+    /**
+     * When true, run {@link bootstrapLocalTasks} before resolve (CLI / Trigger / postTask).
+     * Worker paths should omit — {@link TaskManager.registerTasks} already bootstrapped.
+     */
+    bootstrapLocal?: boolean;
+    bootstrapLocalOptions?: BootstrapLocalTasksOptions;
+    /**
+     * When false, do not fetch Repo from Supabase if the task type is not locally registered.
+     * Default `true`. Align with {@link RegisterTasksOptions.includeRemote}.
+     */
+    includeRemote?: boolean;
+};
+export type ValidateTaskRepoAndParamsFailure = {
+    isValid: false;
+    code: ResultCode;
+    message: string;
+    reason: TaskRepoValidationFailureReason;
+    step: string;
+};
+export type ValidateTaskRepoAndParamsSuccess = {
+    isValid: true;
+    repoContext: TaskRepoContext;
+};
+export type ValidateTaskRepoAndParamsResult = ValidateTaskRepoAndParamsFailure | ValidateTaskRepoAndParamsSuccess;
+/**
+ * Resolve task Repo context and validate `params` via `taskParamsValidator`.
+ *
+ * Repo resolution uses {@link RepoManager.getRepoContext}:
+ * local registry first; when no local entry and `includeRemote`, loads from Supabase.
+ */
+declare function validateTaskRepoAndParams({ logger, taskTypeKey, params, bootstrapLocal, bootstrapLocalOptions, includeRemote, }: ValidateTaskRepoAndParamsInput): Promise<ValidateTaskRepoAndParamsResult>;
+declare const TaskRepoValidation: {
+    validate: typeof validateTaskRepoAndParams;
+};
+export { TaskRepoValidation, validateTaskRepoAndParams };
+//# sourceMappingURL=task-repo-validation.d.ts.map

package/dist/task/task-repo-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-repo-validation.d.ts","sourceRoot":"","sources":["../../src/task/task-repo-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAuB,KAAK,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,MAAM,+BAA+B,GACrC,gBAAgB,GAChB,wBAAwB,GACxB,0BAA0B,GAC1B,wBAAwB,CAAC;AAE/B,MAAM,MAAM,8BAA8B,GAAG;IACzC,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qBAAqB,CAAC,EAAE,0BAA0B,CAAC;IACnD;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC3C,OAAO,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,+BAA+B,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC3C,OAAO,EAAE,IAAI,CAAC;IACd,WAAW,EAAE,eAAe,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,+BAA+B,GACrC,gCAAgC,GAChC,gCAAgC,CAAC;AA2BvC;;;;;GAKG;AACH,iBAAe,yBAAyB,CAAC,EACrC,MAAM,EACN,WAAW,EACX,MAAM,EACN,cAAsB,EACtB,qBAAqB,EACrB,aAAoB,GACvB,EAAE,8BAA8B,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAgF3E;AAED,QAAA,MAAM,kBAAkB;;CAEvB,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/task/task-repo-validation.js

@@ -0,0 +1,96 @@
+import { RepoManager } from "../repo/repo-manager";
+import { bootstrapLocalTasks } from "./local-task-registry";
+import { ResultCode } from "./task.interface";
+function validateTaskParams(validator, taskParams, logger) {
+    try {
+        return validator(taskParams) === true;
+    }
+    catch (error) {
+        logger.warn("taskParamsValidator 拋出異常", {
+            topic: "task",
+            data: { error: error instanceof Error ? error.message : error },
+        });
+        return false;
+    }
+}
+function invalid(params) {
+    return { isValid: false, ...params };
+}
+/**
+ * Resolve task Repo context and validate `params` via `taskParamsValidator`.
+ *
+ * Repo resolution uses {@link RepoManager.getRepoContext}:
+ * local registry first; when no local entry and `includeRemote`, loads from Supabase.
+ */
+async function validateTaskRepoAndParams({ logger, taskTypeKey, params, bootstrapLocal = false, bootstrapLocalOptions, includeRemote = true, }) {
+    if (params == null) {
+        return invalid({
+            reason: "MISSING_PARAMS",
+            code: ResultCode.PARAMS_NOT_VALID,
+            message: "任務缺少 params",
+            step: "params",
+        });
+    }
+    if (bootstrapLocal) {
+        const bootstrap = await bootstrapLocalTasks({
+            ...bootstrapLocalOptions,
+            forTaskTypeKey: taskTypeKey,
+        });
+        logger.debug("本地任務 bootstrap 完成", {
+            topic: "task",
+            data: {
+                taskTypeKey,
+                step: "local_bootstrap",
+                status: bootstrap.status,
+                registered: bootstrap.registered,
+                cached: bootstrap.cached ?? false,
+                message: bootstrap.message,
+            },
+        });
+    }
+    logger.debug("開始解析 Repo 上下文", {
+        topic: "task",
+        data: { taskTypeKey, step: "repo_load", includeRemote },
+    });
+    const { context: repoContext, error: repoError, failureReason, resolvedVia, } = await RepoManager.getRepoContext({
+        logger,
+        taskTypeKey,
+        includeRemote,
+    });
+    if (repoContext == null) {
+        return invalid({
+            reason: failureReason ?? "REMOTE_REPO_LOAD_FAILED",
+            code: ResultCode.REPO_NOT_VALID,
+            message: repoError ?? "無法加載 Repo 上下文",
+            step: "repo_load",
+        });
+    }
+    logger.debug("Repo 上下文解析完成", {
+        topic: "task",
+        data: { taskTypeKey, step: "repo_load", resolvedVia },
+    });
+    if (repoContext.taskFn.taskTypeKey !== taskTypeKey) {
+        return invalid({
+            reason: "TASK_TYPE_KEY_MISMATCH",
+            code: ResultCode.REPO_NOT_VALID,
+            message: `taskFn.taskTypeKey (${repoContext.taskFn.taskTypeKey}) 與 task.value (${taskTypeKey}) 不一致`,
+            step: "task_type_key",
+        });
+    }
+    logger.debug("開始校驗任務參數", { topic: "task", data: { taskTypeKey, step: "params_validation" } });
+    if (!validateTaskParams(repoContext.taskParamsValidator, params, logger)) {
+        return invalid({
+            reason: "PARAMS_VALIDATION_FAILED",
+            code: ResultCode.PARAMS_NOT_VALID,
+            message: "任務參數校驗失敗",
+            step: "params_validation",
+        });
+    }
+    logger.debug("任務參數校驗通過", { topic: "task", data: { taskTypeKey, step: "params_validation" } });
+    return { isValid: true, repoContext };
+}
+const TaskRepoValidation = {
+    validate: validateTaskRepoAndParams,
+};
+export { TaskRepoValidation, validateTaskRepoAndParams };
+//# sourceMappingURL=task-repo-validation.js.map

package/dist/task/task-repo-validation.js.map

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

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

@@ -1 +1,199 @@
+import { type SupabaseResponse } from "../core.interface";
+import { z } from "zod";
+import { Task, TaskStatusAction } from "./task.interface";
+export declare const patchChangeTaskStatusSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
+    action: z.ZodLiteral<TaskStatusAction.PUBLISH>;
+    id: z.ZodString;
+    extra: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    action: TaskStatusAction.PUBLISH;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+}, {
+    id: string;
+    action: TaskStatusAction.PUBLISH;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<TaskStatusAction.CLOSE>;
+    id: z.ZodString;
+    extra: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    action: TaskStatusAction.CLOSE;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+}, {
+    id: string;
+    action: TaskStatusAction.CLOSE;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<TaskStatusAction.CLAIM>;
+    nodeId: z.ZodString;
+    id: z.ZodString;
+    extra: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    action: TaskStatusAction.CLAIM;
+    nodeId: string;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+}, {
+    id: string;
+    action: TaskStatusAction.CLAIM;
+    nodeId: string;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<TaskStatusAction.RESET>;
+    nodeId: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    extra: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    action: TaskStatusAction.RESET;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+    nodeId?: string | undefined;
+}, {
+    id: string;
+    action: TaskStatusAction.RESET;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+    nodeId?: string | undefined;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<TaskStatusAction.CANCEL>;
+    nodeId: z.ZodString;
+    id: z.ZodString;
+    extra: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    action: TaskStatusAction.CANCEL;
+    nodeId: string;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+}, {
+    id: string;
+    action: TaskStatusAction.CANCEL;
+    nodeId: string;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+}>, z.ZodObject<{
+    action: z.ZodLiteral<TaskStatusAction.FINISH>;
+    cost: z.ZodNumber;
+    nodeId: z.ZodString;
+    id: z.ZodString;
+    extra: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    action: TaskStatusAction.FINISH;
+    nodeId: string;
+    cost: number;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+}, {
+    id: string;
+    action: TaskStatusAction.FINISH;
+    nodeId: string;
+    cost: number;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+}>]>;
+export type PatchChangeTaskStatusPayload = z.infer<typeof patchChangeTaskStatusSchema>;
+export declare const patchTaskProgressSchema: z.ZodObject<{
+    id: z.ZodString;
+    progress: z.ZodNumber;
+    nodeId: z.ZodString;
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    nodeId: string;
+    progress: number;
+    traceId?: string | undefined;
+}, {
+    id: string;
+    nodeId: string;
+    progress: number;
+    traceId?: string | undefined;
+}>;
+export type PatchTaskProgressPayload = z.infer<typeof patchTaskProgressSchema>;
+export declare const patchClaimTaskSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    availableTaskList: z.ZodArray<z.ZodString, "many">;
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    nodeId: string;
+    availableTaskList: string[];
+    traceId?: string | undefined;
+}, {
+    nodeId: string;
+    availableTaskList: string[];
+    traceId?: string | undefined;
+}>;
+export type PatchClaimTaskPayload = z.infer<typeof patchClaimTaskSchema>;
+export declare const patchChangeTaskStatus: (payload: {
+    id: string;
+    action: TaskStatusAction.PUBLISH;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+} | {
+    id: string;
+    action: TaskStatusAction.CLOSE;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+} | {
+    id: string;
+    action: TaskStatusAction.CLAIM;
+    nodeId: string;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+} | {
+    id: string;
+    action: TaskStatusAction.RESET;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+    nodeId?: string | undefined;
+} | {
+    id: string;
+    action: TaskStatusAction.CANCEL;
+    nodeId: string;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+} | {
+    id: string;
+    action: TaskStatusAction.FINISH;
+    nodeId: string;
+    cost: number;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+}) => SupabaseResponse<unknown> | Promise<SupabaseResponse<unknown>>;
+/** Update progress on a DOING task; only the owning node may write (see `lockOnDoingOwner`). */
+export declare const patchTaskProgress: (payload: {
+    id: string;
+    nodeId: string;
+    progress: number;
+    traceId?: string | undefined;
+}) => SupabaseResponse<Task> | Promise<SupabaseResponse<Task>>;
+/**
+ * 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 declare const patchClaimTask: (payload: {
+    nodeId: string;
+    availableTaskList: string[];
+    traceId?: 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":""}
+{"version":3,"file":"task.api.d.ts","sourceRoot":"","sources":["../../src/task/task.api.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA4B,IAAI,EAA2B,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA0D7G,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;;;;4EAgCzB,CAAC"}