target-supabase-sdk 0.2.0 → 0.2.1

package/package.json

@@ -1,79 +1,94 @@
 {
-  "name": "target-supabase-sdk",
-  "version": "0.2.0",
-  "description": "Supabase client initializer and data access APIs",
-  "license": "MIT",
-  "author": "KyLoc20",
-  "homepage": "https://github.com/KyLoc20/target-supabase-sdk#readme",
-  "bugs": {
-    "url": "https://github.com/KyLoc20/target-supabase-sdk/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/KyLoc20/target-supabase-sdk.git"
-  },
-  "type": "module",
-  "sideEffects": false,
-  "engines": {
-    "node": ">=18"
-  },
-  "packageManager": "pnpm@9.15.0",
-  "types": "./dist/browser.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/browser.d.ts",
-      "import": "./dist/browser.js",
-      "default": "./dist/browser.js"
+    "name": "target-supabase-sdk",
+    "version": "0.2.1",
+    "description": "Supabase client initializer and data access APIs",
+    "license": "MIT",
+    "author": "KyLoc20",
+    "homepage": "https://github.com/KyLoc20/target-supabase-sdk#readme",
+    "bugs": {
+        "url": "https://github.com/KyLoc20/target-supabase-sdk/issues"
     },
-    "./browser": {
-      "types": "./dist/browser.d.ts",
-      "import": "./dist/browser.js",
-      "default": "./dist/browser.js"
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/KyLoc20/target-supabase-sdk.git"
     },
-    "./node": {
-      "types": "./dist/node.d.ts",
-      "import": "./dist/node.js",
-      "default": "./dist/node.js"
+    "type": "module",
+    "sideEffects": false,
+    "engines": {
+        "node": ">=18"
+    },
+    "packageManager": "pnpm@9.15.0",
+    "types": "./dist/browser.d.ts",
+    "exports": {
+        ".": {
+            "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"
+        },
+        "./preload": {
+            "types": "./dist/preload.d.ts",
+            "import": "./dist/preload.js",
+            "default": "./dist/preload.js"
+        }
+    },
+    "files": [
+        "dist",
+        "src"
+    ],
+    "scripts": {
+        "clean": "node --input-type=module -e \"import fs from 'node:fs'; fs.rmSync('dist', { recursive: true, force: true })\"",
+        "build": "pnpm clean && rollup -c && tsc -p tsconfig.dts.json && node scripts/verify-browser-entry.mjs",
+        "typecheck": "tsc -p tsconfig.json --noEmit",
+        "typecheck:scripts": "tsc -p tsconfig.scripts.json",
+        "format": "biome check --write .",
+        "format:check": "biome ci",
+        "lint": "biome lint .",
+        "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",
+        "parcel:split": "tsx scripts/parcel-split-local.ts",
+        "parcel:restore": "tsx scripts/parcel-restore-local.ts",
+        "dev": "rollup -c --watch",
+        "pack:check": "npm pack --dry-run",
+        "prepack": "pnpm build"
+    },
+    "peerDependencies": {
+        "@supabase/postgrest-js": "^1.19.0",
+        "@supabase/supabase-js": "^2.50.0",
+        "lodash-es": "^4.17.21",
+        "zod": "^3.23.0"
+    },
+    "devDependencies": {
+        "@biomejs/biome": "^2.5.3",
+        "@rollup/plugin-node-resolve": "^16.0.1",
+        "@rollup/plugin-typescript": "^12.1.4",
+        "@supabase/postgrest-js": "1.19.4",
+        "@supabase/supabase-js": "2.50.3",
+        "@types/lodash-es": "^4.17.12",
+        "@types/wicg-file-system-access": "^2023.10.7",
+        "@types/ws": "^8.18.1",
+        "lodash-es": "^4.17.21",
+        "rollup": "^4.40.2",
+        "tslib": "^2.8.1",
+        "tsx": "^4.19.4",
+        "typescript": "~5.7.2",
+        "ws": "^8.18.0",
+        "zod": "^3.24.0"
+    },
+    "publishConfig": {
+        "access": "public"
     }
-  },
-  "files": [
-    "dist",
-    "src"
-  ],
-  "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 && 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"
-  },
-  "peerDependencies": {
-    "@supabase/postgrest-js": "^1.19.0",
-    "@supabase/supabase-js": "^2.50.0",
-    "lodash-es": "^4.17.21",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@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": {
-    "access": "public"
-  }
 }

package/src/browser.ts

@@ -5,96 +5,161 @@
  * 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 * from "./link/link.api";
+export * from "./link/link.interface";
+export * from "./list/list.api";
+export * from "./list/list.interface";
+export * from "./node/node.api";
+export * from "./node/node.interface";
+export type {
+    EvaluateBusyNodeLivenessOptions,
+    TaskNodeLivenessFreshest,
+    TaskNodeLivenessReport,
+} from "./node/node-liveness";
+export { evaluateBusyNodeLiveness } from "./node/node-liveness";
+export type { ChunkResolveProvider } from "./parcel/chunk-fetch-registry";
+export {
+    installChunkFetchRegistry,
+    registerProviderChunkResolver,
+} from "./parcel/chunk-fetch-registry";
+export {
+    isLocalFilesystemPath,
+    isOpaqueChunkUrl,
+    parseProviderPrefixedUrl,
+} from "./parcel/chunk-url.utils";
+export type { DeleteParcelPayload, GetParcelPayload, PostParcelPayload } from "./parcel/parcel.api";
+export {
+    deleteParcel,
+    deleteParcelSchema,
+    getParcel,
+    getParcelSchema,
+    parcelDetailsSchema,
+    postParcel,
+    postParcelSchema,
+} from "./parcel/parcel.api";
 export type {
-	Parcel,
-	ParcelDetails,
-	Chunk,
-	LifecycleStatus as ParcelLifecycleStatus,
-	Lifecycle as ParcelLifecycle,
+    Chunk,
+    Lifecycle as ParcelLifecycle,
+    LifecycleStatus as ParcelLifecycleStatus,
+    Parcel,
+    ParcelCrypto,
+    ParcelDetails,
 } from "./parcel/parcel.interface";
+export { CategoryParcel } from "./parcel/parcel.interface";
+export type {
+    PublishParcelInput,
+    PublishParcelResult,
+    RestoreParcelByIdInput,
+    RestoreParcelByIdResult,
+} from "./parcel/parcel.service";
+export {
+    publishParcel,
+    restoreParcel,
+    restoreParcelById,
+} from "./parcel/parcel.service";
+export type {
+    CreateOptions,
+    CreateResult,
+    ParcelSaveInput,
+    ReassembleOptions,
+    StorageAdapter,
+} from "./parcel/parcel-manager";
 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";
+    CreateUploadAdapterOptions,
+    ProviderProbeFail,
+    ProviderProbeOk,
+    ProviderProbeResult,
+    StorageProviderModule,
+    UploadTracker,
+} from "./parcel/storage-provider.types";
+export { createUploadTracker } from "./parcel/storage-provider.types";
+export type { ProviderProbeMap, StorageProviderRegistry } from "./parcel/storage-provider-registry";
+export { createStorageProviderRegistry } from "./parcel/storage-provider-registry";
+export * from "./repo/repo.api";
+export * from "./repo/repo.interface";
+export type {
+    Api,
+    ApiDetails,
+    DiscoverServiceInput,
+    GetApiPayload,
+    GetServicePayload,
+    PostApiPayload,
+    PostServicePayload,
+    Service,
+    ServiceDetails,
+} from "./service/index";
 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)
+    ApiMethod,
+    apiDetailsSchema,
+    CategoryService,
+    discoverService,
+    fieldDefinitionSchema,
+    getApi,
+    getApiSchema,
+    getService,
+    getServiceSchema,
+    postApi,
+    postApiSchema,
+    postService,
+    postServiceSchema,
+    ServiceLifecycleStatus,
+    schemaDefinitionSchema,
+    serviceDetailsSchema,
+    serviceLifecycleSchema,
+} from "./service/index";
+export type { FetchInitFactory, FetchRetryOptions } from "./shared/http/fetch-retry";
 export {
-	CategoryTask,
-	ResultCode,
-	TaskStatus,
-	TaskStatusAction,
-} from "./task/task.interface";
-export type { Task, TaskDetails, TaskFlow } from "./task/task.interface";
+    fetchBinaryWithRetry,
+    fetchWithRetry,
+    isRetryableHttpStatus,
+    requestHasBody,
+} from "./shared/http/fetch-retry";
+export type { CreateLoggerInput, LoggerWithScope, LogScope, LogScopePatch } from "./shared/log";
+export { createLogger, LogLevel, logManager } from "./shared/log";
+export { isHttpUrl, resolveFetchUrl } from "./shared/utils/fetch-url";
+export type {
+    ClassifiedNetworkError,
+    FormatNetworkErrorOptions,
+    NetworkErrorKind,
+} from "./shared/utils/network-error";
 export {
-	patchChangeTaskStatus,
-	patchChangeTaskStatusSchema,
-	patchClaimTask,
-	patchClaimTaskSchema,
-	patchTaskProgress,
-	patchTaskProgressSchema,
-} from "./task/task.api";
+    classifyNetworkError,
+    formatNetworkError,
+} from "./shared/utils/network-error";
+export type { SanitizeFileNameOptions } from "./shared/utils/safe-file-name";
+export { sanitizeFileName, sanitizeParcelFileName } from "./shared/utils/safe-file-name";
+export { sha256Hex } from "./shared/utils/sha256";
+export type { SupabaseHolder, SupabaseInitializerParams } from "./supabase";
+export { supabase } from "./supabase";
 export type {
-	PatchChangeTaskStatusPayload,
-	PatchClaimTaskPayload,
-	PatchTaskProgressPayload,
+    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";
+export {
+    patchChangeTaskStatus,
+    patchChangeTaskStatusSchema,
+    patchClaimTask,
+    patchClaimTaskSchema,
+    patchTaskProgress,
+    patchTaskProgressSchema,
+} from "./task/task.api";
+export type { Task, TaskDetails, TaskFlow } from "./task/task.interface";
+// task — api + enqueue only (TaskManager / postTaskWithValidation → node entry)
+export {
+    CategoryTask,
+    ResultCode,
+    TaskStatus,
+    TaskStatusAction,
+} from "./task/task.interface";
+export type { PostTaskPayload } from "./task/task-post.api";
+export { postTask, postTaskSchema } from "./task/task-post.api";
+export type { TaskStatusCount } from "./task/task-queue";
+export { countTasksByType, summarizeTaskQueue } from "./task/task-queue";
+export * from "./word/word.interface";

package/src/command/command.api.ts

@@ -1,13 +1,8 @@
-import {
-    createTarget,
-    MAX_POLL_TARGET_LIST_SIZE,
-    pollTargetList,
-    validateWithSchema,
-} from "../core.api";
-import { generateResponse } from "../core.interface";
-import { createApiLogger } from "../shared/log";
 import { z } from "zod";
-import { CategoryCommand, Command, CommandType } from "./command.interface";
+import { createTarget, MAX_POLL_TARGET_LIST_SIZE, pollTargetList, validateWithSchema } from "../core.api";
+import { generateResponse } from "../core.interface";
+import { createLogger } from "../shared/log";
+import { CategoryCommand, type Command, CommandType } from "./command.interface";
 
 const nodeIdSchema = z.string().trim().min(1);
 const traceIdSchema = z.string().trim().min(1).optional();
@@ -41,9 +36,9 @@ function commandNodeFilter(nodeId: string) {
 /** Enqueue a control command for `nodeId` (scheduler / admin). */
 export const postCommand = validateWithSchema(
     postCommandSchema,
-    "postCommandSchema"
+    "postCommandSchema",
 )(async ({ nodeId, command, traceId }) => {
-    const logger = createApiLogger("postCommand", { traceId, labels: { nodeId } });
+    const logger = createLogger({ module: "postCommand", traceId, labels: { nodeId } });
 
     const result = await createTarget<Command, PostCommandPayload>({
         payload: { nodeId, command, traceId },
@@ -68,9 +63,9 @@ export const postCommand = validateWithSchema(
 /** Dequeue control commands for `nodeId` (oldest first). */
 export const getPollCommandList = validateWithSchema(
     getPollCommandListSchema,
-    "getPollCommandListSchema"
+    "getPollCommandListSchema",
 )(async ({ nodeId, size, traceId }) => {
-    const logger = createApiLogger("getPollCommandList", { traceId, labels: { nodeId } });
+    const logger = createLogger({ module: "getPollCommandList", traceId, labels: { nodeId } });
 
     const { data: dequeuedList = [] } = await pollTargetList<Command>({
         category: CategoryCommand.COMMAND,
@@ -79,10 +74,17 @@ export const getPollCommandList = validateWithSchema(
         ascending: true,
     });
 
-    logger.info("Command", {
-        topic: "command",
-        data: { nodeId, dequeued: dequeuedList.length },
-    });
+    if (dequeuedList.length === 0) {
+        logger.debug("Command", {
+            topic: "command",
+            data: { nodeId, dequeued: dequeuedList.length },
+        });
+    } else {
+        logger.info("Command", {
+            topic: "command",
+            data: { nodeId, dequeued: dequeuedList.length },
+        });
+    }
 
     return generateResponse.success(dequeuedList);
 });

package/src/command/command.interface.ts

@@ -1,5 +1,4 @@
-import { Target } from "../core.interface";
-
+import type { Target } from "../core.interface";
 
 export enum CategoryCommand {
     COMMAND = "command",
@@ -14,4 +13,4 @@ export interface Command extends Target {
     /** Node.id */
     value: string;
     category: CategoryCommand;
-}
+}