target-supabase-sdk 0.1.8 → 0.2.0

package/README.md

@@ -30,20 +30,54 @@ cp .env.example .env.local
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `VITE_SUPABASE_URL` | Yes | Main Supabase project URL |
-| `VITE_SUPABASE_ANON_KEY` | Yes | Main project anon (public) key |
-| `VITE_SUPABASE_NEED_AUTH_URL` | No | Separate auth project URL |
-| `VITE_SUPABASE_NEED_AUTH_ANON_KEY` | No | Separate auth project anon key |
+| `SUPABASE_URL` | Yes | Main Supabase project URL |
+| `SUPABASE_ANON_KEY` | Yes | Main project anon (public) key |
+| `SUPABASE_NEED_AUTH_URL` | No | Separate auth project URL |
+| `SUPABASE_NEED_AUTH_ANON_KEY` | No | Separate auth project anon key |
+
+Used by `scripts/` (`pnpm worker`, `pnpm post-task`) via `.env.local`. Browser apps pass the same values to `supabase.initialize()` (e.g. `import.meta.env.VITE_SUPABASE_URL` if your bundler uses a `VITE_` prefix).
 
 ### Security
 
-- `VITE_*` variables are embedded in the client bundle at build time. Only use the **anon (public) key** — it is designed to be public when protected by Row Level Security (RLS).
-- **Never** put the `service_role` key in a `VITE_*` variable or any frontend code. Use it only in trusted server-side environments.
+- Only use the **anon (public) key** in client or script env — it is designed to be public when protected by Row Level Security (RLS).
+- **Never** put the `service_role` key in env files or frontend code. Use it only in trusted server-side environments.
 - Do not commit `.env` or `.env.local`. They are gitignored; only `.env.example` (placeholders) should be tracked.
 - Auth APIs return session tokens. Store them securely and never log them.
 
 ## Usage
 
+### Browser / bundlers (default)
+
+Chrome extensions, React, Vite — import from the main entry (no Node built-ins):
+
+```typescript
+import { supabase, getTarget, postLinkCreate } from "target-supabase-sdk";
+```
+
+### Node.js workers / CLI
+
+Local task registry, repo script loading, TaskNode — use the `/node` entry:
+
+```typescript
+import { TaskManager, RepoManager, TaskNode, postTask } from "target-supabase-sdk/node";
+```
+
+> **Breaking change in 0.2.0:** `TaskManager`, `RepoManager`, and `postTask` are no longer on the default entry. Import them from `/node`.
+
+### Browser vs Node (package layout)
+
+Since **0.2.0**, the package ships two compiled entries:
+
+| Import | Built file | Runtime |
+|--------|------------|---------|
+| `target-supabase-sdk` | `dist/browser.js` | Chrome extension, React, Vite — no Node built-ins |
+| `target-supabase-sdk/node` | `dist/node.js` | Workers, CLI, TaskNode — includes browser API + Node-only code |
+| `target-supabase-sdk/browser` | `dist/browser.js` | Explicit alias of default |
+
+`src/browser.ts` is the curated browser public surface. `src/node.ts` re-exports browser and adds Node-only symbols (`TaskManager`, `postTask`, `RepoManager`, …).
+
+### Initialize Supabase
+
 ```typescript
 import { supabase, getTarget, loginUser } from "target-supabase-sdk";
 
@@ -57,6 +91,40 @@ await supabase.initialize({
 const target = await getTarget({ id: "..." });
 ```
 
+## Adding new modules (contributors)
+
+When adding a domain, API, or Manager, **classify browser vs Node before** registering exports. The default entry must stay bundler-safe (Chrome extensions, Webpack, Vite).
+
+### Decision flow
+
+1. **Scan static dependencies** — grep the new code and everything it imports for `node:fs`, `node:crypto`, `node:path`, etc.
+2. **Choose entry:**
+   - No `node:*` in the chain → add to `src/browser.ts` (and domain `index.ts`)
+   - Uses Node built-ins → add **only** to `src/node.ts` (consumers use `target-supabase-sdk/node`)
+   - Same file mixes both → **split** into separate leaf modules (example: `task.api.ts` vs `task-post.api.ts`)
+3. **Build** — `pnpm build` runs TypeScript compile plus `scripts/verify-browser-entry.mjs`, which walks the static import graph from `dist/browser.js` and fails if any module references `node:*`.
+
+```bash
+pnpm build
+# [verify:browser] OK — N module(s) in browser graph, no node: imports.
+```
+
+Node entry (`/node`) is validated by `tsc` compile only — no separate verify script.
+
+### Rules of thumb
+
+| Safe on default entry `.` | Node entry `/node` only |
+|---------------------------|-------------------------|
+| `*.interface.ts`, Supabase RPC `*.api.ts` | `TaskManager`, `RepoManager`, `TaskNode` |
+| `createTarget`, `postLinkCreate`, task `patch*` APIs | `postTask`, `TaskRepoValidation` |
+| `repo.api` (remote) | `local-task-registry`, `repo.script-loader` |
+
+**Do not rely on dynamic `import()`** to hide Node code: if `browser.ts` statically re-exports a file, bundlers include the whole module. Keep Node-only code in separate files that `browser.ts` never touches.
+
+**Internal imports:** within a domain, import leaf paths (`from "./task.api"`) not the domain barrel (`from "./index"`) to avoid cycles.
+
+Detailed conventions: `.cursor/skills/browser-node-exports/SKILL.md` and `.cursor/skills/library-exports/SKILL.md`.
+
 ## Development
 
 ```bash

package/dist/auth/auth.api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.api.d.ts","sourceRoot":"","sources":["../../src/auth/auth.api.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAGD,eAAO,MAAM,YAAY,wBAA+B,eAAe;;;GAWtE,CAAC;AAGF,eAAO,MAAM,SAAS,wBAA+B,YAAY;;;;GAWhE,CAAC;AAGF,eAAO,MAAM,UAAU,uDAQtB,CAAC;AAGF,eAAO,MAAM,cAAc,2DAW1B,CAAC;AAGF,eAAO,MAAM,aAAa,UAAiB,MAAM,oDAQhD,CAAC"}
+{"version":3,"file":"auth.api.d.ts","sourceRoot":"","sources":["../../src/auth/auth.api.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAGD,eAAO,MAAM,YAAY,wBAA+B,eAAe;;;GAWtE,CAAC;AAGF,eAAO,MAAM,SAAS,wBAA+B,YAAY;;;;GAWhE,CAAC;AAGF,eAAO,MAAM,UAAU,uDAQtB,CAAC;AAGF,eAAO,MAAM,cAAc,2DAW1B,CAAC;AAGF,eAAO,MAAM,aAAa,UAAiB,MAAM,oDAQhD,CAAC"}

package/dist/auth/auth.api.js

@@ -1,6 +1,7 @@
-import { supabase } from "..";
+import { SupabaseInitializer } from "../supabase";
 import { generateResponse } from "../core.interface";
 import { handleSupabaseError } from "../core.utils";
+const supabase = SupabaseInitializer.getInstance();
 // 用户注册
 export const registerUser = async ({ email, password }) => {
     const { data, error } = await supabase.authClient.auth.signUp({

package/dist/auth/auth.api.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.api.js","sourceRoot":"","sources":["../../src/auth/auth.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAoBpD,OAAO;AACP,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAmB,EAAE,EAAE;IACzE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,MAAM,CAAC;QAC7D,KAAK;QACL,QAAQ;KACT,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,cAAc,EAAE,KAAK,EAAE,wCAAwC,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,OAAO;AACP,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAgB,EAAE,EAAE;IACnE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC;QACzE,KAAK;QACL,QAAQ;KACT,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,WAAW,EAAE,KAAK,EAAE,8CAA8C,CAAC,CAAC;IAC1F,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,OAAO;AACP,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE;IACnC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAE5D,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,YAAY,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC,CAAC;AAEF,SAAS;AACT,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;IACvC,MAAM,EACJ,IAAI,EAAE,EAAE,IAAI,EAAE,EACd,KAAK,GACN,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAE9C,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,gBAAgB,EAAE,KAAK,EAAE,6BAA6B,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,CAAc,IAAmB,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,OAAO;AACP,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,KAAa,EAAE,EAAE;IACnD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAE/E,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,eAAe,EAAE,KAAK,EAAE,gCAAgC,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC,CAAC"}
+{"version":3,"file":"auth.api.js","sourceRoot":"","sources":["../../src/auth/auth.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,WAAW,EAAE,CAAC;AAoBnD,OAAO;AACP,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAmB,EAAE,EAAE;IACzE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,MAAM,CAAC;QAC7D,KAAK;QACL,QAAQ;KACT,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,cAAc,EAAE,KAAK,EAAE,wCAAwC,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,OAAO;AACP,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAgB,EAAE,EAAE;IACnE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC;QACzE,KAAK;QACL,QAAQ;KACT,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,WAAW,EAAE,KAAK,EAAE,8CAA8C,CAAC,CAAC;IAC1F,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,OAAO;AACP,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE;IACnC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAE5D,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,YAAY,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC,CAAC;AAEF,SAAS;AACT,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;IACvC,MAAM,EACJ,IAAI,EAAE,EAAE,IAAI,EAAE,EACd,KAAK,GACN,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAE9C,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,gBAAgB,EAAE,KAAK,EAAE,6BAA6B,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,CAAc,IAAmB,CAAC,CAAC;AACpE,CAAC,CAAC;AAEF,OAAO;AACP,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,KAAa,EAAE,EAAE;IACnD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,UAAW,CAAC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAE/E,IAAI,KAAK,EAAE,CAAC;QACV,mBAAmB,CAAC,eAAe,EAAE,KAAK,EAAE,gCAAgC,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC,CAAC"}

package/dist/browser.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 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 declare const supabase: SupabaseInitializer;
+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";
+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";
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,QAAQ,qBAAoC,CAAC;AAE1D,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAE7B,cAAc,iBAAiB,CAAC;AAEhC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EACX,MAAM,EACN,aAAa,EACb,KAAK,EACL,eAAe,IAAI,qBAAqB,EACxC,SAAS,IAAI,eAAe,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhF,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAE1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,mCAAmC,CAAC;AAElD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AAEpC,YAAY,EACX,QAAQ,EACR,eAAe,EACf,YAAY,GACZ,MAAM,8BAA8B,CAAC;AACtC,cAAc,sCAAsC,CAAC;AACrD,OAAO,EACN,UAAU,IAAI,YAAY,EAC1B,mBAAmB,IAAI,qBAAqB,GAC5C,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,iBAAiB,IAAI,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACjG,cAAc,0CAA0C,CAAC;AAEzD,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AAExC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAEhC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAEhC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EACN,YAAY,EACZ,UAAU,EACV,UAAU,EACV,gBAAgB,GAChB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EACN,qBAAqB,EACrB,2BAA2B,EAC3B,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,GACvB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACX,4BAA4B,EAC5B,qBAAqB,EACrB,wBAAwB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAEhC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC"}

package/dist/browser.js

@@ -0,0 +1,45 @@
+/**
+ * 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";
+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 { ParcelManager } 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 * from "./review-v2/review-setting.interface";
+export { postReview as postReviewV2, PostReviewValidator as PostReviewV2Validator, } 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 { patchChangeTaskStatus, patchChangeTaskStatusSchema, patchClaimTask, patchClaimTaskSchema, patchTaskProgress, patchTaskProgressSchema, } from "./task/task.api";
+export * from "./node/node.interface";
+export * from "./node/node.api";
+export * from "./repo/repo.interface";
+export * from "./repo/repo.api";
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,CAAC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,WAAW,EAAE,CAAC;AAE1D,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAE7B,cAAc,iBAAiB,CAAC;AAEhC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAQ3D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAE1C,cAAc,yCAAyC,CAAC;AACxD,cAAc,mCAAmC,CAAC;AAElD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AAOpC,cAAc,sCAAsC,CAAC;AACrD,OAAO,EACN,UAAU,IAAI,YAAY,EAC1B,mBAAmB,IAAI,qBAAqB,GAC5C,MAAM,kCAAkC,CAAC;AAE1C,cAAc,0CAA0C,CAAC;AAEzD,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AAExC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAEhC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAEhC,cAAc,uBAAuB,CAAC;AAEtC,uEAAuE;AACvE,OAAO,EACN,YAAY,EACZ,UAAU,EACV,UAAU,EACV,gBAAgB,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACN,qBAAqB,EACrB,2BAA2B,EAC3B,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,GACvB,MAAM,iBAAiB,CAAC;AAOzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAEhC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC"}

package/dist/command/command.api.d.ts

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { Command, CommandType } from "./command.interface";
+export declare const postCommandSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    command: z.ZodNativeEnum<typeof CommandType>;
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    nodeId: string;
+    command: CommandType;
+    traceId?: string | undefined;
+}, {
+    nodeId: string;
+    command: CommandType;
+    traceId?: string | undefined;
+}>;
+export type PostCommandPayload = z.infer<typeof postCommandSchema>;
+export declare const getPollCommandListSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    size: z.ZodOptional<z.ZodNumber>;
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    nodeId: string;
+    size?: number | undefined;
+    traceId?: string | undefined;
+}, {
+    nodeId: string;
+    size?: number | undefined;
+    traceId?: string | undefined;
+}>;
+export type GetPollCommandListPayload = z.infer<typeof getPollCommandListSchema>;
+/** Enqueue a control command for `nodeId` (scheduler / admin). */
+export declare const postCommand: (payload: {
+    nodeId: string;
+    command: CommandType;
+    traceId?: string | undefined;
+}) => import("..").SupabaseResponse<Command> | Promise<import("..").SupabaseResponse<Command>>;
+/** Dequeue control commands for `nodeId` (oldest first). */
+export declare const getPollCommandList: (payload: {
+    nodeId: string;
+    size?: number | undefined;
+    traceId?: string | undefined;
+}) => import("..").SupabaseResponse<Command[]> | Promise<import("..").SupabaseResponse<Command[]>>;
+//# sourceMappingURL=command.api.d.ts.map

package/dist/command/command.api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.api.d.ts","sourceRoot":"","sources":["../../src/command/command.api.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAmB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAO5E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEnE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAUjF,kEAAkE;AAClE,eAAO,MAAM,WAAW;;;;8FAsBtB,CAAC;AAIH,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB;;;;kGAmB7B,CAAC"}

package/dist/command/command.api.js

@@ -0,0 +1,58 @@
+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, CommandType } from "./command.interface";
+const nodeIdSchema = z.string().trim().min(1);
+const traceIdSchema = z.string().trim().min(1).optional();
+// ─── Zod schemas ─────────────────────────────────────────────────────────────
+export const postCommandSchema = z.object({
+    nodeId: nodeIdSchema,
+    command: z.nativeEnum(CommandType),
+    traceId: traceIdSchema,
+});
+export const getPollCommandListSchema = z.object({
+    nodeId: nodeIdSchema,
+    size: z.number().int().min(1).max(MAX_POLL_TARGET_LIST_SIZE).optional(),
+    traceId: traceIdSchema,
+});
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function commandNodeFilter(nodeId) {
+    return [{ field: "value", operator: "eq", value: nodeId }];
+}
+// ─── postCommand ─────────────────────────────────────────────────────────────
+/** Enqueue a control command for `nodeId` (scheduler / admin). */
+export const postCommand = validateWithSchema(postCommandSchema, "postCommandSchema")(async ({ nodeId, command, traceId }) => {
+    const logger = createApiLogger("postCommand", { traceId, labels: { nodeId } });
+    const result = await createTarget({
+        payload: { nodeId, command, traceId },
+        createFn: () => ({
+            name: command,
+            value: nodeId,
+            category: CategoryCommand.COMMAND,
+            tagList: [],
+        }),
+    });
+    logger.info("Command已入隊", {
+        topic: "command",
+        data: { nodeId, command },
+    });
+    return result;
+});
+// ─── getPollCommandList ──────────────────────────────────────────────────────
+/** Dequeue control commands for `nodeId` (oldest first). */
+export const getPollCommandList = validateWithSchema(getPollCommandListSchema, "getPollCommandListSchema")(async ({ nodeId, size, traceId }) => {
+    const logger = createApiLogger("getPollCommandList", { traceId, labels: { nodeId } });
+    const { data: dequeuedList = [] } = await pollTargetList({
+        category: CategoryCommand.COMMAND,
+        size: size ?? 50,
+        filterList: commandNodeFilter(nodeId),
+        ascending: true,
+    });
+    logger.info("Command", {
+        topic: "command",
+        data: { nodeId, dequeued: dequeuedList.length },
+    });
+    return generateResponse.success(dequeuedList);
+});
+//# sourceMappingURL=command.api.js.map

package/dist/command/command.api.js.map

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

package/dist/command/command.interface.d.ts

@@ -0,0 +1,14 @@
+import { Target } from "../core.interface";
+export declare enum CategoryCommand {
+    COMMAND = "command"
+}
+export declare enum CommandType {
+    STOP_NODE = "stop-node"
+}
+export interface Command extends Target {
+    name: CommandType;
+    /** Node.id */
+    value: string;
+    category: CategoryCommand;
+}
+//# sourceMappingURL=command.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.interface.d.ts","sourceRoot":"","sources":["../../src/command/command.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C,oBAAY,eAAe;IACvB,OAAO,YAAY;CACtB;AAED,oBAAY,WAAW;IACnB,SAAS,cAAc;CAC1B;AAED,MAAM,WAAW,OAAQ,SAAQ,MAAM;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,cAAc;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,CAAC;CAC7B"}

package/dist/command/command.interface.js

@@ -0,0 +1,9 @@
+export var CategoryCommand;
+(function (CategoryCommand) {
+    CategoryCommand["COMMAND"] = "command";
+})(CategoryCommand || (CategoryCommand = {}));
+export var CommandType;
+(function (CommandType) {
+    CommandType["STOP_NODE"] = "stop-node";
+})(CommandType || (CommandType = {}));
+//# sourceMappingURL=command.interface.js.map

package/dist/command/command.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.interface.js","sourceRoot":"","sources":["../../src/command/command.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,WAEX;AAFD,WAAY,WAAW;IACnB,sCAAuB,CAAA;AAC3B,CAAC,EAFW,WAAW,KAAX,WAAW,QAEtB"}

package/dist/core.api.d.ts

@@ -1,11 +1,16 @@
 import { Target, TargetPayload } from "./core.interface";
 import { BaseValidator } from "./core.utils";
 import { PostgrestFilterBuilder } from "@supabase/postgrest-js";
+import type { ZodType } from "zod";
 export interface QueryFilter {
     field: string;
     operator: "eq" | "neq" | "in";
     value: unknown;
 }
+export declare const MAX_TARGET_LIST_PAGE_SIZE = 100;
+/** Alias for {@link pollTargetList} batch size cap. */
+export declare const MAX_POLL_TARGET_LIST_SIZE = 100;
+export type TargetFilterBuilder = PostgrestFilterBuilder<any, any, any[], "target", unknown>;
 export interface QueryOrderBy {
     field: string;
     ascending: boolean;
@@ -22,18 +27,75 @@ export declare const getPossibleTarget: ({ filterList }: {
     filterList: QueryFilter[];
 }) => Promise<import("./core.interface").SupabaseResponse<Target | null>>;
 export interface GetTargetListParams extends BaseQueryParams {
-    pageNum: number;
-    pageSize: number;
     category: Target["category"];
+    /** 0-based page index. Required with pageSize unless `limit` is set. */
+    pageNum?: number;
+    pageSize?: number;
+    /** Shorthand for `{ pageNum: 0, pageSize: limit }`. Max {@link MAX_TARGET_LIST_PAGE_SIZE}. */
+    limit?: number;
+    /** PostgREST select clause; defaults to `"*"`. */
+    selectFields?: string;
+    /** Custom query builder; `category` and `filterList` are still applied. */
+    filterBuilder?: TargetFilterBuilder;
 }
-export declare const getTargetList: ({ pageNum, pageSize, category, filterList, orderBy, filterBuilder, }: GetTargetListParams & {
-    filterBuilder?: PostgrestFilterBuilder<any, any, any[], "target", unknown>;
-}) => Promise<import("./core.interface").SupabaseResponse<Target[]>>;
+/**
+ * Paginated target list by category. Failures throw via `handleSupabaseError` (no `{ error }` envelope).
+ */
+export declare const getTargetList: <T extends Target = Target>({ pageNum, pageSize, limit, category, filterList, orderBy, selectFields, filterBuilder, }: GetTargetListParams) => Promise<import("./core.interface").SupabaseResponse<T[]>>;
+export interface ScanTargetListParams {
+    category: Target["category"];
+    filterList?: QueryFilter[];
+    orderBy?: QueryOrderBy;
+    selectFields?: string;
+    filterBuilder?: TargetFilterBuilder;
+    /** Stop after this many rows (optional guard against runaway scans). */
+    maxRows?: number;
+}
+/**
+ * Scan all rows matching `category` + `filterList` by paging until exhausted.
+ *
+ * Use for worker bootstrap / sync jobs that need the full matching set.
+ * For UI pagination, use {@link getTargetList} (single page, explicit pageNum).
+ *
+ * Internal batch size is fixed at {@link MAX_TARGET_LIST_PAGE_SIZE} (PostgREST max-rows).
+ * Callers receive the full merged result; they do not pass a per-request page size.
+ *
+ * Uses offset pagination (`.range`). Stable enough for small catalogs (e.g. Repo registry);
+ * for large tables under concurrent writes, consider a DB RPC or keyset pagination later.
+ */
+export declare const scanTargetList: <T extends Target = Target>({ category, filterList, orderBy, selectFields, filterBuilder, maxRows, }: ScanTargetListParams) => Promise<import("./core.interface").SupabaseResponse<T[]>>;
 export interface GetTargetTotalCountParams extends BaseQueryParams {
     category: Target["category"];
-    filterBuilder?: PostgrestFilterBuilder<any, any, any[], "target", unknown>;
+    /** Custom query builder; `category` and `filterList` are still applied. */
+    filterBuilder?: TargetFilterBuilder;
 }
 export declare const getTargetTotalCount: ({ category, filterList, filterBuilder, }: GetTargetTotalCountParams) => Promise<import("./core.interface").SupabaseResponse<number>>;
+export interface PollTargetListParams {
+    category: Target["category"];
+    /** Max rows to read and attempt dequeue (not offset pagination). */
+    size: number;
+    filterList?: QueryFilter[];
+    /** Order by `created_at`. Default `true` (oldest first). */
+    ascending?: boolean;
+    selectFields?: string;
+}
+/**
+ * Queue poll: SELECT up to `size` rows matching `category` + `filterList`, ordered by
+ * `created_at`, then DELETE each by `id`. Returns only dequeued rows (at-most-once).
+ *
+ * Delete failures (concurrent consumer) are skipped silently.
+ * Failures on the initial SELECT throw via `handleSupabaseError`.
+ *
+ * TODO(concurrency): 当前为 SELECT → 逐条 DELETE，非 DB 原子出队，多 consumer 并发时可能：
+ * - 重叠读取：两个 worker 同一批 SELECT 命中相同行，靠 DELETE 竞速，后者 skip（多数 at-most-once）
+ * - TOCTOU：SELECT 与 DELETE 之间无锁，极端情况下 DELETE 0 行仍不报错 → 可能重复计入 polled
+ * - 非 exactly-once：行已删但 worker 崩溃未处理 → 消息丢失
+ * 若同一 filter 多实例 poll（或多 worker 同 nodeId），需改为 DB 侧原子方案，例如：
+ * - RPC：`DELETE … WHERE id IN (SELECT … FOR UPDATE SKIP LOCKED) RETURNING *`
+ * - 或 claim 状态机：UPDATE … WHERE pending → DELETE/标记已消费（类似 patchClaimTask 乐观锁）
+ * - 短期加固：DELETE 后校验影响行数，0 行则不 push 到 polled
+ */
+export declare const pollTargetList: <T extends Target = Target>({ category, size, filterList, ascending, selectFields, }: PollTargetListParams) => Promise<import("./core.interface").SupabaseResponse<T[]>>;
 export declare const deleteTarget: ({ id, filterList }: {
     id: string;
     filterList?: QueryFilter[];
@@ -105,4 +167,6 @@ export declare const createTarget: <T extends Target, P extends object>({ payloa
     upsert?: boolean;
 }) => Promise<import("./core.interface").SupabaseResponse<T>>;
 export declare function validateWith<P extends object, V extends BaseValidator<P>>(ValidatorClass: new () => V): <R>(fn: (validPayload: P) => R) => (payload: P) => R;
+/** Zod-based counterpart to {@link validateWith} — requires `zod` as a peer dependency. */
+export declare function validateWithSchema<T extends ZodType>(schema: T, schemaName?: string): <R>(fn: (validPayload: T["_output"]) => R | Promise<R>) => (payload: T["_output"]) => R | Promise<R>;
 //# sourceMappingURL=core.api.d.ts.map

package/dist/core.api.d.ts.map

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