target-supabase-sdk 0.1.9 → 0.2.1

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;
-}