target-supabase-sdk 0.2.0 → 0.2.1

package/src/auth/auth.api.ts

@@ -1,87 +0,0 @@
-import { SupabaseInitializer } from "../supabase";
-import { generateResponse } from "../core.interface";
-import { handleSupabaseError } from "../core.utils";
-
-const supabase = SupabaseInitializer.getInstance();
-
-export interface LoginPayload {
-  email: string;
-  password: string;
-}
-
-export interface RegisterPayload {
-  email: string;
-  password: string;
-  confirmPassword?: string;
-}
-
-export interface User {
-  id: string;
-  email: string;
-  created_at: string;
-  last_sign_in_at?: string;
-}
-
-// 用户注册
-export const registerUser = async ({ email, password }: RegisterPayload) => {
-  const { data, error } = await supabase.authClient!.auth.signUp({
-    email,
-    password,
-  });
-
-  if (error) {
-    handleSupabaseError("registerUser", error, "Registration failed. Please try again.");
-  }
-
-  return generateResponse.success(data);
-};
-
-// 用户登录
-export const loginUser = async ({ email, password }: LoginPayload) => {
-  const { data, error } = await supabase.authClient!.auth.signInWithPassword({
-    email,
-    password,
-  });
-
-  if (error) {
-    handleSupabaseError("loginUser", error, "Login failed. Please check your credentials.");
-  }
-
-  return generateResponse.success(data);
-};
-
-// 用户登出
-export const logoutUser = async () => {
-  const { error } = await supabase.authClient!.auth.signOut();
-
-  if (error) {
-    handleSupabaseError("logoutUser", error, "Logout failed.");
-  }
-
-  return generateResponse.success();
-};
-
-// 获取当前用户
-export const getCurrentUser = async () => {
-  const {
-    data: { user },
-    error,
-  } = await supabase.authClient!.auth.getUser();
-
-  if (error) {
-    handleSupabaseError("getCurrentUser", error, "Failed to get current user.");
-  }
-
-  return generateResponse.success<User | null>(user as User | null);
-};
-
-// 重置密码
-export const resetPassword = async (email: string) => {
-  const { error } = await supabase.authClient!.auth.resetPasswordForEmail(email);
-
-  if (error) {
-    handleSupabaseError("resetPassword", error, "Password reset request failed.");
-  }
-
-  return generateResponse.success();
-};

package/src/feed/feed.interface.ts

@@ -1,33 +0,0 @@
-import { Target } from "../core.interface";
-
-export interface Feed extends Target {
-  category: CategoryFeed;
-  details: FeedDetails;
-}
-
-export enum CategoryFeed {
-  FEED = "feed",
-  DOC = "doc",
-}
-
-export interface FeedDetails {
-  manifestVersion: number;
-  list: FeedItem[];
-}
-
-export enum FeedItemType {
-  /** Plain Target */
-  TEXT = "TEXT",
-  /** Parcel */
-  IMAGE = "IMAGE",
-  /** Parcel */
-  VIDEO = "VIDEO",
-  /** TODO Review */
-  // REVIEW = "REVIEW",
-}
-
-export interface FeedItem {
-  index: number;
-  type: FeedItemType;
-  refTargetId: string;
-}

package/src/file/file-manager.ts

@@ -1,145 +0,0 @@
-import type { FileDetails, FilePreview } from "./file.interface";
-
-const FILE_MANIFEST_VERSION = 1;
-const PREVIEW_MANIFEST_VERSION = 1;
-
-export class FileManagerError extends Error {
-    constructor(
-        message: string,
-        cause?: unknown
-    ) {
-        super(message, { cause });
-        this.name = "FileManagerError";
-    }
-}
-
-export interface CreatePreviewProps {
-    refTargetId: string;
-}
-
-function createPreviewV0(props: CreatePreviewProps): FilePreview {
-    return {
-        manifestVersion: PREVIEW_MANIFEST_VERSION,
-        refTargetId: props.refTargetId,
-    };
-}
-
-export interface CreateFileProps {
-    manifestVersion: 0
-    /** "abc.1" */
-    value: string;
-    filePath: string;
-    needParcel: boolean;
-}
-
-async function sha256Hex(buffer: ArrayBuffer): Promise<string> {
-    try {
-        const hashBuffer = await globalThis.crypto.subtle.digest("SHA-256", buffer);
-        const bytes = new Uint8Array(hashBuffer);
-        return Array.from(bytes)
-            .map((byte) => byte.toString(16).padStart(2, "0"))
-            .join("");
-    } catch (error) {
-        throw new FileManagerError("FileManager.sha256Hex: 計算文件 hash 失敗", error);
-    }
-}
-
-function isLikelyLocalPath(path: string): boolean {
-    // Windows: C:\foo\bar.txt / \\server\share ; POSIX absolute: /foo/bar
-    return /^[a-zA-Z]:[\\/]/.test(path) || path.startsWith("\\\\") || path.startsWith("/");
-}
-
-function isFetchableResource(path: string): boolean {
-    return /^(https?:|blob:|data:)/.test(path) || path.startsWith("./") || path.startsWith("../");
-}
-
-function getBaseName(path: string): string {
-    const parts = path.split(/[\\/]/).filter(Boolean);
-    return parts.at(-1) ?? "unknown";
-}
-
-async function readLocalFileByPicker(filePath: string): Promise<ArrayBuffer> {
-    try {
-        if (!("showOpenFilePicker" in globalThis) || typeof globalThis.showOpenFilePicker !== "function") {
-            throw new FileManagerError(
-                "FileManager.readLocalFileByPicker: 當前瀏覽器不支持 File System Access API",
-                { filePath }
-            );
-        }
-
-        const [handle] = await globalThis.showOpenFilePicker({
-            multiple: false,
-        });
-        const file = await handle.getFile();
-        const expectedName = getBaseName(filePath);
-        if (expectedName !== "unknown" && file.name !== expectedName) {
-            throw new FileManagerError(
-                "FileManager.readLocalFileByPicker: 選擇的文件與目標路徑不一致",
-                { expectedName, actualName: file.name, filePath }
-            );
-        }
-        return file.arrayBuffer();
-    } catch (error) {
-        throw new FileManagerError("FileManager.readLocalFileByPicker: 本地文件讀取失敗", error);
-    }
-}
-
-async function readFileBufferFromPath(filePath: string): Promise<ArrayBuffer> {
-    try {
-        if (isLikelyLocalPath(filePath) && !isFetchableResource(filePath)) {
-            return readLocalFileByPicker(filePath);
-        }
-
-        const response = await fetch(filePath);
-        if (!response.ok) {
-            throw new FileManagerError(
-                `FileManager.readFileBufferFromPath: 無法讀取文件內容 (${response.status})`,
-                { status: response.status, statusText: response.statusText, filePath }
-            );
-        }
-        return response.arrayBuffer();
-    } catch (error) {
-        throw new FileManagerError("FileManager.readFileBufferFromPath: 讀取文件失敗", error);
-    }
-}
-
-async function createFileV0(props: CreateFileProps): Promise<FileDetails> {
-    try {
-        const fileBuffer = await readFileBufferFromPath(props.filePath);
-        const contentHash = await sha256Hex(fileBuffer);
-
-        return {
-            manifestVersion: props.manifestVersion ?? FILE_MANIFEST_VERSION,
-            value: props.value,
-            // Hash file bytes directly so checksum can be verified by re-hashing the same content.
-            hash: contentHash,
-            preview: null,
-            url: props.needParcel ? null : props.filePath,
-            parcelId: null,
-        };
-    } catch (error) {
-        throw new FileManagerError("FileManager.createFile: 建立文件 metadata 失敗", error);
-    }
-}
-
-async function verifyFileHash(filePath: string, expectedHash: string): Promise<boolean> {
-    try {
-        const normalizedExpected = expectedHash.trim().toLowerCase();
-        const fileBuffer = await readFileBufferFromPath(filePath);
-        const actualHash = await sha256Hex(fileBuffer);
-        return actualHash === normalizedExpected;
-    } catch (error) {
-        throw new FileManagerError("FileManager.verifyFileHash: 文件 hash 驗證失敗", error);
-    }
-}
-
-const createFile = createFileV0;
-const createPreview = createPreviewV0;
-
-const FileManager = {
-    createFile,
-    createPreview,
-    verifyFileHash,
-};
-
-export { FileManager };

package/src/file/file.api.ts

@@ -1,43 +0,0 @@
-import { createTarget } from "../core.api";
-import { BaseValidator } from "../core.utils";
-import { File, FileDetails } from "./file.interface";
-
-export interface PostFileCreatePayload {
-  name: File["name"];
-  value: File["value"];
-  category: File["category"];
-  details: FileDetails;
-}
-
-export class PostFileValidator extends BaseValidator<PostFileCreatePayload> {
-  protected requiredFields: (keyof PostFileCreatePayload)[] = ["name", "value", "category", "details"];
-  protected optionalFields: (keyof PostFileCreatePayload)[] = [];
-
-  constructor() {
-    super();
-    // Add custom
-    this.addCustomValidator((val) => {
-      return true;
-    });
-  }
-}
-
-
-
-export const postFileCreate = async (payload: PostFileCreatePayload) => {
-  return createTarget<File, PostFileCreatePayload>({
-    payload: payload,
-    validator: PostFileValidator,
-    createFn: (validPayload) => {
-      const { name, value, category, details } = validPayload;
-
-      return {
-        name,
-        category,
-        value,
-        tagList: [],
-        details,
-      };
-    },
-  });
-};

package/src/file/file.interface.ts

@@ -1,30 +0,0 @@
-import { Target } from "../core.interface";
-
-export enum CategoryFile {
-  VIDEO = "video",
-  IMAGE = "image",
-  TEXT = "text",
-}
-
-export interface File extends Target {
-  details: FileDetails;
-  category: CategoryFile;
-}
-
-export interface FileDetails {
-  manifestVersion: number;
-  /** "abc.1" 唯一键 */
-  value: string;
-  hash: string | null;
-  preview: FilePreview | null;
-  /** Quickly access the file */
-  url: string | null;
-  parcelId: string | null;
-  /** TODO 消費與改動歷史 */
-  // reviewList?: string[];
-};
-
-export interface FilePreview {
-  manifestVersion: number;
-  refTargetId: string;
-};

package/src/file-list/file-list.api.ts

@@ -1,64 +0,0 @@
-import { createTarget } from "../core.api";
-import { BaseValidator } from "../core.utils";
-import { FileList, CategoryFileList, FileListDetails } from "./file-list.interface";
-
-export class PostCreateFileListValidator extends BaseValidator<PostCreateFileListPayload> {
-  protected requiredFields: (keyof PostCreateFileListPayload)[] = ["name", "dirName", "dirSize", "storageUrl"];
-  protected optionalFields: (keyof PostCreateFileListPayload)[] = [];
-
-  constructor() {
-    super();
-    // Add custom
-    this.addCustomValidator((val) => {
-      return true;
-    });
-  }
-}
-
-export interface PostCreateFileListPayload {
-  name: FileListDetails["name"];
-  dirName: FileListDetails["dirName"];
-  dirSize: FileListDetails["dirSize"];
-  storageUrl: FileListDetails["storageUrl"];
-}
-
-export const postCreateFileList = async (payload: PostCreateFileListPayload) => {
-  return createTarget<FileList, PostCreateFileListPayload>({
-    payload: payload,
-    validator: PostCreateFileListValidator,
-    checkRedundancyFilterList: [
-      {
-        field: "category",
-        operator: "eq",
-        value: CategoryFileList.FILE_LIST,
-      },
-      {
-        field: "details->>dirName",
-        operator: "eq",
-        value: payload.dirName,
-      },
-      {
-        field: "details->>storageUrl",
-        operator: "eq",
-        value: payload.storageUrl,
-      },
-    ],
-    createFn: (validPayload) => {
-      const { name, dirName, dirSize, storageUrl = "" } = validPayload;
-      const details: FileListDetails = {
-        name,
-        dirName,
-        dirSize,
-        storageUrl,
-      };
-
-      return {
-        name: validPayload.name,
-        category: CategoryFileList.FILE_LIST,
-        value: dirName,
-        tagList: [],
-        details,
-      };
-    },
-  });
-};

package/src/file-list/file-list.interface.ts

@@ -1,24 +0,0 @@
-import { Target } from "../core.interface";
-
-/**
- * Use storageUrl+dirName to identify the file list
- * You can iterate all files in the directory
- */
-export type FileListDetails = {
-  /** Human readable name, should be same to Target.name */
-  name: string;
-  /** unique path */
-  dirName: string;
-  dirSize: number;
-  /** where to store the file list */
-  storageUrl: string;
-};
-
-export enum CategoryFileList {
-  FILE_LIST = "file-list",
-}
-
-export interface FileList extends Target {
-  details: FileListDetails;
-  category: CategoryFileList;
-}

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

@@ -1,15 +0,0 @@
-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 });
-}

package/src/node/node-task.preset.ts

@@ -1,13 +0,0 @@
-// export const generateControllerTaskPreset = () => {
-//     return {
-//         category: CategoryTask.TASK_CONTROLLER,
-//         taskTypeFilterList: CONTROLLER_TASK_TYPE_ALLOW_LIST,
-//     };
-// };
-
-// export const getWorkerTaskPreset = () => {
-//     return {
-//         category: CategoryTask.TASK,
-//         taskTypeFilterList: WORKER_TASK_TYPE_ALLOW_LIST,
-//     };
-// };

package/src/node/trigger-node.ts

@@ -1,180 +0,0 @@
-import { logManager, type LoggerWithScope } from "../shared/log";
-import { scopeForNodeLoop } from "./node-log-scope";
-import { postTask } from "../task/task-post.api";
-import { TaskStatus } from "../task/task.interface";
-import { patchTriggerFired, scanEnabledTriggers } from "../trigger/trigger.api";
-import type { Trigger, TriggerPostTaskAction } from "../trigger/trigger.interface";
-import { buildFireKey, isTriggerDue } from "../trigger/trigger.utils";
-import { NodeLoopContext } from "./node.interface";
-import { BaseNodeRuntime } from "./node-runtime.base";
-
-/**
- * Dedicated trigger scheduler node.
- * Main loop: commands → heartbeat → evaluate due triggers → postTask.
- *
- * Phase 1: run a **single** TriggerNode process per deployment to avoid duplicate fires.
- */
-class TriggerNode extends BaseNodeRuntime {
-    constructor() {
-        super("triggerNode");
-    }
-
-    protected async onBeforeRegisterNode(logger: LoggerWithScope): Promise<void> {
-        logger.info("Trigger 節點啟動，跳過任務註冊", { topic: "trigger" });
-    }
-
-    protected async runLoopSteps(ctx: NodeLoopContext, heartbeatOk: boolean): Promise<void> {
-        const loopScope = scopeForNodeLoop({
-            module: `${this.runtimeModule}-loop-iteration`,
-            traceId: ctx.loopTraceId,
-            nodeId: ctx.nodeId,
-        });
-        if (!heartbeatOk) {
-            const { logger } = logManager.withScope(loopScope);
-            logger.warn("心跳失敗，本輪跳過 Trigger 評估", { topic: "trigger" });
-            return;
-        }
-        await this.evaluateTriggers(ctx);
-    }
-
-    async evaluateTriggers(ctx: NodeLoopContext): Promise<void> {
-        const { loopTraceId, nodeId } = ctx;
-        const loopScope = scopeForNodeLoop({ module: "evaluateTriggers", traceId: loopTraceId, nodeId });
-        const { logger } = logManager.withScope(loopScope);
-
-        logger.debug("開始評估 Trigger", { topic: "trigger" });
-
-        const { data: triggerList = [], error } = await scanEnabledTriggers({ traceId: loopTraceId });
-        if (error) {
-            logger.warn("掃描 Trigger 失敗", {
-                topic: "trigger",
-                data: { error: error.message },
-            });
-            return;
-        }
-        if (triggerList.length === 0) {
-            logger.info("無 ENABLED Trigger", { topic: "trigger" });
-            return;
-        }
-
-        const now = new Date();
-        let dueCount = 0;
-        let firedCount = 0;
-
-        for (const trigger of triggerList) {
-            if (!isTriggerDue(trigger, now)) {
-                continue;
-            }
-            dueCount++;
-            const fired = await this.fireTrigger(ctx, trigger, now);
-            if (fired) {
-                firedCount++;
-            }
-        }
-
-        logger.info("Trigger 評估完成", {
-            topic: "trigger",
-            data: {
-                scanned: triggerList.length,
-                due: dueCount,
-                fired: firedCount,
-            },
-        });
-    }
-
-    private async fireTrigger(ctx: NodeLoopContext, trigger: Trigger, now: Date): Promise<boolean> {
-        const { loopTraceId, nodeId } = ctx;
-        const { logger } = logManager.withScope(
-            scopeForNodeLoop({ module: "fireTrigger", traceId: loopTraceId, nodeId })
-        );
-
-        const fireKey = buildFireKey(trigger, now);
-        const action = trigger.details.action;
-
-        if (action.kind !== "post_task") {
-            logger.warn("不支援的 Trigger action", {
-                topic: "trigger",
-                data: { triggerId: trigger.id, kind: action.kind },
-            });
-            return false;
-        }
-
-        logger.info("Trigger 到期，準備 postTask", {
-            topic: "trigger",
-            data: {
-                triggerId: trigger.id,
-                triggerKey: trigger.value,
-                fireKey,
-                taskTypeKey: action.taskTypeKey,
-            },
-        });
-
-        const taskExtra = `trigger:${trigger.id}:${fireKey}`;
-        const { data: task, error: postError } = await postTask(
-            buildPostTaskPayload(trigger, action, taskExtra, loopTraceId)
-        );
-
-        if (postError) {
-            logger.error("Trigger postTask 失敗", {
-                topic: "trigger",
-                data: {
-                    triggerId: trigger.id,
-                    fireKey,
-                    error: postError.message,
-                },
-            });
-            return false;
-        }
-
-        const { error: patchError } = await patchTriggerFired({
-            triggerId: trigger.id,
-            fireKey,
-            expectedLastFireKey: trigger.details.lastFireKey ?? null,
-            traceId: loopTraceId,
-        });
-
-        if (patchError) {
-            logger.warn("Trigger 已 postTask 但更新 lastFireKey 失敗", {
-                topic: "trigger",
-                data: {
-                    triggerId: trigger.id,
-                    taskId: task?.id,
-                    fireKey,
-                    error: patchError.message,
-                },
-            });
-            return false;
-        }
-
-        logger.success("Trigger 觸發成功", {
-            topic: "trigger",
-            data: {
-                triggerId: trigger.id,
-                triggerKey: trigger.value,
-                fireKey,
-                taskId: task?.id,
-                taskTraceId: task?.details.traceId,
-            },
-        });
-        return true;
-    }
-}
-
-function buildPostTaskPayload(
-    trigger: Trigger,
-    action: TriggerPostTaskAction,
-    extra: string,
-    loopTraceId: string
-) {
-    return {
-        name: action.taskName ?? trigger.name,
-        value: action.taskTypeKey,
-        params: action.taskParams,
-        taskStatus: action.taskStatus ?? TaskStatus.TODO,
-        tagList: trigger.tagList ?? [],
-        extra,
-        traceParentId: loopTraceId,
-    };
-}
-
-export { TriggerNode };

package/src/question-list/question-list.api.ts

@@ -1,42 +0,0 @@
-import { createTarget } from "../core.api";
-import { BaseValidator } from "../core.utils";
-import { QuestionList, CategoryQuestionList, QuestionListDetails } from "./question-list.interface";
-
-export class PostCreateQuestionListValidator extends BaseValidator<PostCreateQuestionListPayload> {
-  protected requiredFields: (keyof PostCreateQuestionListPayload)[] = ["name", "list"];
-  protected optionalFields: (keyof PostCreateQuestionListPayload)[] = [];
-
-  constructor() {
-    super();
-    // Add custom
-    this.addCustomValidator((val) => {
-      return true;
-    });
-  }
-}
-
-export interface PostCreateQuestionListPayload {
-  name: QuestionListDetails["name"];
-  list: QuestionListDetails["list"];
-}
-
-export const postCreateQuestionList = async (payload: PostCreateQuestionListPayload) => {
-  return createTarget<QuestionList, PostCreateQuestionListPayload>({
-    payload: payload,
-    validator: PostCreateQuestionListValidator,
-    createFn: (validPayload) => {
-      const { name, list } = validPayload;
-      const details: QuestionListDetails = {
-        name,
-        list,
-      };
-      return {
-        name: validPayload.name,
-        category: CategoryQuestionList.QUESTION_LIST,
-        value: "",
-        tagList: [],
-        details,
-      };
-    },
-  });
-};