target-supabase-sdk 0.1.9 → 0.2.0

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

package/dist/trigger/trigger.api.js.map

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

package/dist/trigger/trigger.interface.d.ts

@@ -0,0 +1,43 @@
+import { Target } from "../core.interface";
+import { TaskStatus } from "../task/task.interface";
+export declare enum CategoryTrigger {
+    TRIGGER = "trigger"
+}
+export declare enum TriggerStatus {
+    ENABLED = "ENABLED",
+    DISABLED = "DISABLED",
+    PAUSED = "PAUSED"
+}
+/** Phase 1: daily fire at `hour`:`minute` UTC. */
+export interface TriggerDailySchedule {
+    kind: "daily";
+    hour: number;
+    minute: number;
+}
+export type TriggerSchedule = TriggerDailySchedule;
+export interface TriggerPostTaskAction {
+    kind: "post_task";
+    taskTypeKey: string;
+    taskParams: unknown;
+    taskName?: string;
+    taskStatus?: TaskStatus.OPEN | TaskStatus.TODO;
+}
+export type TriggerAction = TriggerPostTaskAction;
+export interface Trigger extends Target {
+    /** Human readable */
+    name: string;
+    /** Unique trigger key */
+    value: string;
+    details: TriggerDetails;
+    category: CategoryTrigger;
+}
+export interface TriggerDetails {
+    manifestVersion: number;
+    status: TriggerStatus;
+    schedule: TriggerSchedule;
+    action: TriggerAction;
+    lastFiredAt?: number | null;
+    /** Idempotency key for the last successful fire, e.g. `daily:2026-06-18` (UTC date). */
+    lastFireKey?: string | null;
+}
+//# sourceMappingURL=trigger.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.interface.d.ts","sourceRoot":"","sources":["../../src/trigger/trigger.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,oBAAY,eAAe;IACvB,OAAO,YAAY;CACtB;AAED,oBAAY,aAAa;IACrB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,MAAM,WAAW;CACpB;AAED,kDAAkD;AAClD,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAEnD,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;CAClD;AAED,MAAM,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAElD,MAAM,WAAW,OAAQ,SAAQ,MAAM;IACnC,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B"}

package/dist/trigger/trigger.interface.js

@@ -0,0 +1,11 @@
+export var CategoryTrigger;
+(function (CategoryTrigger) {
+    CategoryTrigger["TRIGGER"] = "trigger";
+})(CategoryTrigger || (CategoryTrigger = {}));
+export var TriggerStatus;
+(function (TriggerStatus) {
+    TriggerStatus["ENABLED"] = "ENABLED";
+    TriggerStatus["DISABLED"] = "DISABLED";
+    TriggerStatus["PAUSED"] = "PAUSED";
+})(TriggerStatus || (TriggerStatus = {}));
+//# sourceMappingURL=trigger.interface.js.map

package/dist/trigger/trigger.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.interface.js","sourceRoot":"","sources":["../../src/trigger/trigger.interface.ts"],"names":[],"mappings":"AAGA,MAAM,CAAN,IAAY,eAEX;AAFD,WAAY,eAAe;IACvB,sCAAmB,CAAA;AACvB,CAAC,EAFW,eAAe,KAAf,eAAe,QAE1B;AAED,MAAM,CAAN,IAAY,aAIX;AAJD,WAAY,aAAa;IACrB,oCAAmB,CAAA;IACnB,sCAAqB,CAAA;IACrB,kCAAiB,CAAA;AACrB,CAAC,EAJW,aAAa,KAAb,aAAa,QAIxB"}

package/dist/trigger/trigger.utils.d.ts

@@ -0,0 +1,6 @@
+import type { Trigger, TriggerDailySchedule } from "./trigger.interface";
+export declare function buildDailyFireKey(_schedule: TriggerDailySchedule, now: Date): string;
+export declare function isDailyScheduleDue(schedule: TriggerDailySchedule, now: Date, lastFireKey: string | null | undefined): boolean;
+export declare function isTriggerDue(trigger: Trigger, now?: Date): boolean;
+export declare function buildFireKey(trigger: Trigger, now?: Date): string;
+//# sourceMappingURL=trigger.utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.utils.d.ts","sourceRoot":"","sources":["../../src/trigger/trigger.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAoBzE,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,oBAAoB,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAMpF;AAED,wBAAgB,kBAAkB,CAC9B,QAAQ,EAAE,oBAAoB,EAC9B,GAAG,EAAE,IAAI,EACT,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,OAAO,CAOT;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAM9E;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAM7E"}

package/dist/trigger/trigger.utils.js

@@ -0,0 +1,39 @@
+function parseUtcDateParts(now) {
+    return {
+        year: now.getUTCFullYear(),
+        month: now.getUTCMonth() + 1,
+        day: now.getUTCDate(),
+        hour: now.getUTCHours(),
+        minute: now.getUTCMinutes(),
+    };
+}
+export function buildDailyFireKey(_schedule, now) {
+    const { year, month, day } = parseUtcDateParts(now);
+    const yyyy = String(year).padStart(4, "0");
+    const mm = String(month).padStart(2, "0");
+    const dd = String(day).padStart(2, "0");
+    return `daily:${yyyy}-${mm}-${dd}`;
+}
+export function isDailyScheduleDue(schedule, now, lastFireKey) {
+    const parts = parseUtcDateParts(now);
+    if (parts.hour !== schedule.hour || parts.minute !== schedule.minute) {
+        return false;
+    }
+    const fireKey = buildDailyFireKey(schedule, now);
+    return lastFireKey !== fireKey;
+}
+export function isTriggerDue(trigger, now = new Date()) {
+    const { schedule, lastFireKey } = trigger.details;
+    if (schedule.kind !== "daily") {
+        throw new Error(`Unsupported trigger schedule kind: ${String(schedule.kind)}`);
+    }
+    return isDailyScheduleDue(schedule, now, lastFireKey);
+}
+export function buildFireKey(trigger, now = new Date()) {
+    const { schedule } = trigger.details;
+    if (schedule.kind !== "daily") {
+        throw new Error(`Unsupported trigger schedule kind: ${String(schedule.kind)}`);
+    }
+    return buildDailyFireKey(schedule, now);
+}
+//# sourceMappingURL=trigger.utils.js.map

package/dist/trigger/trigger.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.utils.js","sourceRoot":"","sources":["../../src/trigger/trigger.utils.ts"],"names":[],"mappings":"AAUA,SAAS,iBAAiB,CAAC,GAAS;IAChC,OAAO;QACH,IAAI,EAAE,GAAG,CAAC,cAAc,EAAE;QAC1B,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC;QAC5B,GAAG,EAAE,GAAG,CAAC,UAAU,EAAE;QACrB,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE;QACvB,MAAM,EAAE,GAAG,CAAC,aAAa,EAAE;KAC9B,CAAC;AACN,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAA+B,EAAE,GAAS;IACxE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3C,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxC,OAAO,SAAS,IAAI,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAC9B,QAA8B,EAC9B,GAAS,EACT,WAAsC;IAEtC,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACjD,OAAO,WAAW,KAAK,OAAO,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,MAAY,IAAI,IAAI,EAAE;IACjE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAClD,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,CAAE,QAA8B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1G,CAAC;IACD,OAAO,kBAAkB,CAAC,QAAQ,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,MAAY,IAAI,IAAI,EAAE;IACjE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IACrC,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,CAAE,QAA8B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1G,CAAC;IACD,OAAO,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAC5C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "target-supabase-sdk",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "Supabase client initializer and data access APIs",
   "license": "MIT",
   "author": "KyLoc20",
@@ -18,12 +18,22 @@
     "node": ">=18"
   },
   "packageManager": "pnpm@9.15.0",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/browser.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js",
+      "default": "./dist/browser.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js",
+      "default": "./dist/browser.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js",
+      "default": "./dist/node.js"
     }
   },
   "files": [
@@ -32,12 +42,15 @@
   ],
   "scripts": {
     "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",
+    "build": "pnpm clean && tsc -p tsconfig.build.json && node scripts/verify-browser-entry.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "typecheck:scripts": "tsc -p tsconfig.scripts.json",
     "worker": "tsx scripts/run-node-worker.ts",
+    "worker:trigger": "tsx scripts/run-trigger-node.ts",
+    "chrome-sidecar": "tsx scripts/chrome-sidecar-hub.ts",
     "post-task": "tsx scripts/post-task.ts",
     "post-command": "tsx scripts/post-command.ts",
+    "post-trigger": "tsx scripts/post-trigger.ts",
     "dev": "tsc -p tsconfig.build.json --watch",
     "pack:check": "npm pack --dry-run",
     "prepack": "pnpm build"
@@ -52,10 +65,12 @@
     "@supabase/postgrest-js": "1.19.4",
     "@supabase/supabase-js": "2.50.3",
     "@types/lodash-es": "^4.17.12",
+    "@types/ws": "^8.18.1",
     "@types/wicg-file-system-access": "^2023.10.7",
     "lodash-es": "^4.17.21",
     "typescript": "~5.7.2",
     "tsx": "^4.19.4",
+    "ws": "^8.18.0",
     "zod": "^3.24.0"
   },
   "publishConfig": {

package/src/browser.ts

@@ -0,0 +1,100 @@
+/**
+ * Browser-safe public API — no Node.js built-ins (node:fs, node:crypto, …).
+ * Default package entry (`target-supabase-sdk`).
+ *
+ * For TaskManager, RepoManager, TaskNode, use `target-supabase-sdk/node`.
+ */
+
+export { SupabaseInitializer } from "./supabase";
+export type { SupabaseInitializerParams } from "./supabase";
+export type { SupabaseClient } from "@supabase/supabase-js";
+
+import { SupabaseInitializer } from "./supabase";
+
+export const supabase = SupabaseInitializer.getInstance();
+
+export * from "./core.api";
+export * from "./core.interface";
+export * from "./core.utils";
+
+export * from "./auth/auth.api";
+
+export * from "./feed/feed.interface";
+export * from "./idea/idea.interface";
+
+export { CategoryParcel } from "./parcel/parcel.interface";
+export type {
+	Parcel,
+	ParcelDetails,
+	Chunk,
+	LifecycleStatus as ParcelLifecycleStatus,
+	Lifecycle as ParcelLifecycle,
+} from "./parcel/parcel.interface";
+export { ParcelManager } from "./parcel/parcel-manager";
+export type { StorageAdapter, ParcelTargetBase } from "./parcel/parcel-manager";
+
+export * from "./file/file.interface";
+export * from "./file/file.api";
+export * from "./file/file-manager";
+
+export * from "./file-list/file-list.interface";
+export * from "./file-list/file-list.api";
+
+export * from "./question-list/question-list.interface";
+export * from "./question-list/question-list.api";
+
+export * from "./review/review.interface";
+export * from "./review/review.api";
+
+export type {
+	ReviewV2,
+	ReviewV2Details,
+	ReviewResult,
+} from "./review-v2/review.interface";
+export * from "./review-v2/review-setting.interface";
+export {
+	postReview as postReviewV2,
+	PostReviewValidator as PostReviewV2Validator,
+} from "./review-v2/apis/post-review.api";
+export type { PostReviewPayload as PostReviewV2Payload } from "./review-v2/apis/post-review.api";
+export * from "./review-v2/apis/post-review-setting.api";
+
+export * from "./service/base.interface";
+export * from "./service/service.interface";
+export * from "./service/api.interface";
+
+export * from "./link/link.interface";
+export * from "./link/link.api";
+
+export * from "./list/list.interface";
+export * from "./list/list.api";
+
+export * from "./word/word.interface";
+
+// task — api + validation only (TaskManager is Node-only → node entry)
+export {
+	CategoryTask,
+	ResultCode,
+	TaskStatus,
+	TaskStatusAction,
+} from "./task/task.interface";
+export type { Task, TaskDetails, TaskFlow } from "./task/task.interface";
+export {
+	patchChangeTaskStatus,
+	patchChangeTaskStatusSchema,
+	patchClaimTask,
+	patchClaimTaskSchema,
+	patchTaskProgress,
+	patchTaskProgressSchema,
+} from "./task/task.api";
+export type {
+	PatchChangeTaskStatusPayload,
+	PatchClaimTaskPayload,
+	PatchTaskProgressPayload,
+} from "./task/task.api";
+
+export * from "./node/node.interface";
+export * from "./node/node.api";
+
+export * from "./repo/repo.interface";
+export * from "./repo/repo.api";

package/src/command/command.api.ts

@@ -5,7 +5,7 @@ import {
     validateWithSchema,
 } from "../core.api";
 import { generateResponse } from "../core.interface";
-import { createApiLogger } from "../shared/log/log-manager";
+import { createApiLogger } from "../shared/log";
 import { z } from "zod";
 import { CategoryCommand, Command, CommandType } from "./command.interface";
 
@@ -43,7 +43,7 @@ export const postCommand = validateWithSchema(
     postCommandSchema,
     "postCommandSchema"
 )(async ({ nodeId, command, traceId }) => {
-    const logger = createApiLogger("postCommand", { traceId, nodeId });
+    const logger = createApiLogger("postCommand", { traceId, labels: { nodeId } });
 
     const result = await createTarget<Command, PostCommandPayload>({
         payload: { nodeId, command, traceId },
@@ -57,7 +57,7 @@ export const postCommand = validateWithSchema(
 
     logger.info("Command已入隊", {
         topic: "command",
-        context: { nodeId, command },
+        data: { nodeId, command },
     });
 
     return result;
@@ -70,7 +70,7 @@ export const getPollCommandList = validateWithSchema(
     getPollCommandListSchema,
     "getPollCommandListSchema"
 )(async ({ nodeId, size, traceId }) => {
-    const logger = createApiLogger("getPollCommandList", { traceId, nodeId });
+    const logger = createApiLogger("getPollCommandList", { traceId, labels: { nodeId } });
 
     const { data: dequeuedList = [] } = await pollTargetList<Command>({
         category: CategoryCommand.COMMAND,
@@ -81,7 +81,7 @@ export const getPollCommandList = validateWithSchema(
 
     logger.info("Command", {
         topic: "command",
-        context: { nodeId, dequeued: dequeuedList.length },
+        data: { nodeId, dequeued: dequeuedList.length },
     });
 
     return generateResponse.success(dequeuedList);

package/src/index.ts

@@ -1,79 +1,2 @@
-export { SupabaseInitializer } from "./supabase";
-export type { SupabaseInitializerParams } from "./supabase";
-export type { SupabaseClient } from "@supabase/supabase-js";
-
-import { SupabaseInitializer } from "./supabase";
-
-export const supabase = SupabaseInitializer.getInstance();
-
-export * from "./core.api";
-export * from "./core.interface";
-export * from "./core.utils";
-
-export * from "./auth/auth.api";
-
-export * from "./feed/feed.interface";
-export * from "./idea/idea.interface";
-export * from "./link/link.interface";
-
-export { CategoryParcel } from "./parcel/parcel.interface";
-export type {
-  Parcel,
-  ParcelDetails,
-  Chunk,
-  LifecycleStatus as ParcelLifecycleStatus,
-  Lifecycle as ParcelLifecycle,
-} from "./parcel/parcel.interface";
-export { ParcelManager } from "./parcel/parcel-manager";
-export type { StorageAdapter, ParcelTargetBase } from "./parcel/parcel-manager";
-
-export * from "./file/file.interface";
-export * from "./file/file.api";
-export * from "./file/file-manager";
-
-export * from "./file-list/file-list.interface";
-export * from "./file-list/file-list.api";
-
-export * from "./question-list/question-list.interface";
-export * from "./question-list/question-list.api";
-
-export * from "./review/review.interface";
-export * from "./review/review.api";
-
-export type { ReviewV2, ReviewV2Details, ReviewResult } from "./review-v2/review.interface";
-export * from "./review-v2/review-setting.interface";
-export { postReview as postReviewV2, PostReviewValidator as PostReviewV2Validator } from "./review-v2/apis/post-review.api";
-export type { PostReviewPayload as PostReviewV2Payload } from "./review-v2/apis/post-review.api";
-export * from "./review-v2/apis/post-review-setting.api";
-
-export * from "./service/base.interface";
-export * from "./service/service.interface";
-export * from "./service/api.interface";
-
-
-export * from "./link/link.interface";
-export * from "./link/link.api";
-
-export * from "./list/list.interface";
-export * from "./list/list.api";
-
-export * from "./word/word.interface";
-
-export * from "./task/task.interface";
-export * from "./task/task.api";
-export { TaskManager } from "./task/task-manager";
-export type {
-    RegisterTasksOptions,
-    RegisterTasksResult,
-    PrepareTaskResponse,
-    PrepareTaskParams,
-    PrepareTaskFailureReason,
-} from "./task/task-manager";
-
-export * from "./node/node.interface";
-export * from "./node/node.api";
-export { NodeManager } from "./node/node-manager";
-
-export * from "./repo/repo.interface";
-export * from "./repo/repo.api";
-export { RepoManager } from "./repo/repo-manager";
+/** @deprecated Use explicit entry — re-exports browser-safe API only. */
+export * from "./browser";

package/src/link/link.interface.ts

@@ -6,7 +6,7 @@ export enum CategoryLink {
 }
 
 export interface Link extends Target {
-    /** 鏈接名稱 */
+    /** Should be unique */
     name: string;
     /** URL */
     value: string;

package/src/node/node-log-scope.ts

@@ -0,0 +1,15 @@
+import { createRootScope, type LogScope } from "../shared/log";
+
+/** Input for {@link scopeForNodeLoop}. */
+export type ScopeForNodeLoopInput = {
+    module: string;
+    traceId: string;
+    nodeId: string;
+    traceParentId?: string | null;
+};
+
+/** Log scope for one node main-loop iteration (trace + nodeId label). */
+export function scopeForNodeLoop(input: ScopeForNodeLoopInput): LogScope {
+    const { module, traceId, nodeId, traceParentId = null } = input;
+    return createRootScope({ module, traceId, labels: { nodeId }, traceParentId });
+}