target-supabase-sdk 0.1.9 → 0.2.1

package/dist/trigger/trigger.api.d.ts

@@ -0,0 +1,140 @@
+import { z } from "zod";
+import { type SupabaseResponse } from "../core.interface";
+import { TaskStatus } from "../task/task.interface";
+import { type Trigger, TriggerStatus } from "./trigger.interface";
+export declare const postTriggerSchema: z.ZodObject<{
+    name: z.ZodString;
+    value: z.ZodString;
+    status: z.ZodDefault<z.ZodOptional<z.ZodNativeEnum<typeof TriggerStatus>>>;
+    schedule: z.ZodObject<{
+        kind: z.ZodLiteral<"daily">;
+        hour: z.ZodNumber;
+        minute: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        hour: number;
+        minute: number;
+        kind: "daily";
+    }, {
+        hour: number;
+        minute: number;
+        kind: "daily";
+    }>;
+    action: z.ZodObject<{
+        kind: z.ZodLiteral<"post_task">;
+        taskTypeKey: z.ZodString;
+        taskParams: z.ZodUnknown;
+        taskName: z.ZodOptional<z.ZodString>;
+        taskStatus: z.ZodOptional<z.ZodEnum<[TaskStatus.OPEN, TaskStatus.TODO]>>;
+    }, "strip", z.ZodTypeAny, {
+        taskTypeKey: string;
+        kind: "post_task";
+        taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
+        taskParams?: unknown;
+        taskName?: string | undefined;
+    }, {
+        taskTypeKey: string;
+        kind: "post_task";
+        taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
+        taskParams?: unknown;
+        taskName?: string | undefined;
+    }>;
+    tagList: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    value: string;
+    tagList: string[];
+    status: TriggerStatus;
+    action: {
+        taskTypeKey: string;
+        kind: "post_task";
+        taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
+        taskParams?: unknown;
+        taskName?: string | undefined;
+    };
+    schedule: {
+        hour: number;
+        minute: number;
+        kind: "daily";
+    };
+    traceId?: string | undefined;
+}, {
+    name: string;
+    value: string;
+    action: {
+        taskTypeKey: string;
+        kind: "post_task";
+        taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
+        taskParams?: unknown;
+        taskName?: string | undefined;
+    };
+    schedule: {
+        hour: number;
+        minute: number;
+        kind: "daily";
+    };
+    tagList?: string[] | undefined;
+    traceId?: string | undefined;
+    status?: TriggerStatus | undefined;
+}>;
+export type PostTriggerPayload = z.infer<typeof postTriggerSchema>;
+export declare const scanEnabledTriggersSchema: z.ZodObject<{
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    traceId?: string | undefined;
+}, {
+    traceId?: string | undefined;
+}>;
+export type ScanEnabledTriggersPayload = z.infer<typeof scanEnabledTriggersSchema>;
+export declare const patchTriggerFiredSchema: z.ZodObject<{
+    triggerId: z.ZodString;
+    fireKey: z.ZodString;
+    expectedLastFireKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    traceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    triggerId: string;
+    fireKey: string;
+    traceId?: string | undefined;
+    expectedLastFireKey?: string | null | undefined;
+}, {
+    triggerId: string;
+    fireKey: string;
+    traceId?: string | undefined;
+    expectedLastFireKey?: string | null | undefined;
+}>;
+export type PatchTriggerFiredPayload = z.infer<typeof patchTriggerFiredSchema>;
+/** List all ENABLED triggers (Phase 1: in-memory due check). */
+export declare const scanEnabledTriggers: (payload: {
+    traceId?: string | undefined;
+}) => SupabaseResponse<Trigger[]> | Promise<SupabaseResponse<Trigger[]>>;
+/** Create a trigger row (scheduler / admin). */
+export declare const postTrigger: (payload: {
+    name: string;
+    value: string;
+    tagList: string[];
+    status: TriggerStatus;
+    action: {
+        taskTypeKey: string;
+        kind: "post_task";
+        taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
+        taskParams?: unknown;
+        taskName?: string | undefined;
+    };
+    schedule: {
+        hour: number;
+        minute: number;
+        kind: "daily";
+    };
+    traceId?: string | undefined;
+}) => SupabaseResponse<Trigger> | Promise<SupabaseResponse<Trigger>>;
+/**
+ * Mark trigger as fired for `fireKey`.
+ * When `expectedLastFireKey` is set, uses optimistic lock on that field.
+ */
+export declare const patchTriggerFired: (payload: {
+    triggerId: string;
+    fireKey: string;
+    traceId?: string | undefined;
+    expectedLastFireKey?: string | null | undefined;
+}) => SupabaseResponse<unknown> | Promise<SupabaseResponse<unknown>>;
+//# sourceMappingURL=trigger.api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.api.d.ts","sourceRoot":"","sources":["../../src/trigger/trigger.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAEH,KAAK,OAAO,EAGZ,aAAa,EAChB,MAAM,qBAAqB,CAAC;AAoB7B,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ5B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEnE,eAAO,MAAM,yBAAyB;;;;;;EAEpC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEnF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAM/E,gEAAgE;AAChE,eAAO,MAAM,mBAAmB;;wEAwB9B,CAAC;AAEH,gDAAgD;AAChD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;oEAgCtB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;oEAqC5B,CAAC"}

package/dist/trigger/trigger.constant.d.ts

@@ -0,0 +1,8 @@
+export declare const LOG_TOPIC_TRIGGER = "trigger";
+/** Fixed main-loop interval for {@link TriggerNode} (ms). */
+export declare const TRIGGER_LOOP_INTERVAL_MS = 60000;
+/** Default extra retries after first failure within one runner tick. */
+export declare const TRIGGER_RUNNER_DEFAULT_RETRY_COUNT = 3;
+/** Default delay between retry attempts within the same tick (ms). */
+export declare const TRIGGER_RUNNER_DEFAULT_RETRY_DELAY_MS = 0;
+//# sourceMappingURL=trigger.constant.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.constant.d.ts","sourceRoot":"","sources":["../../src/trigger/trigger.constant.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C,6DAA6D;AAC7D,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAE/C,wEAAwE;AACxE,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAEpD,sEAAsE;AACtE,eAAO,MAAM,qCAAqC,IAAI,CAAC"}

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

@@ -0,0 +1,87 @@
+import type { Target } from "../core.interface";
+import type { LoggerWithScope } from "../shared/log";
+import type { 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;
+}
+/** Context passed to each runner invocation. */
+export interface TriggerRunnerContext {
+    loopTraceId: string;
+    nodeId: string;
+    runnerKey: string;
+    logger: LoggerWithScope;
+    /** 1-based attempt index within this tick (includes retries). */
+    attempt: number;
+    maxAttempts: number;
+}
+export type TriggerRunnerFn = (ctx: TriggerRunnerContext) => void | Promise<void>;
+export interface RegisterTriggerRunnerOptions {
+    /** Unique runner key within this process (trimmed; must be non-empty). */
+    key: string;
+    /** Minimum ms between tick starts for this runner. */
+    intervalMs: number;
+    fn: TriggerRunnerFn;
+    /** Delay first run after registration. Default `0`. */
+    initialDelayMs?: number;
+    /**
+     * Extra attempts after the first failure within the same tick.
+     * Default {@link TRIGGER_RUNNER_DEFAULT_RETRY_COUNT} from `./trigger.constant`.
+     */
+    retryCount?: number;
+    /**
+     * Delay between retry attempts within the same tick (ms).
+     * Default {@link TRIGGER_RUNNER_DEFAULT_RETRY_DELAY_MS} (`0` = immediate).
+     */
+    retryDelayMs?: number;
+    /**
+     * Max ms per fn invocation; rejects when exceeded.
+     * Does not cancel in-flight work — fn may still run after timeout. Omit for no limit.
+     */
+    timeoutMs?: number;
+}
+/** Options for {@link TriggerNode}. */
+export interface TriggerNodeOptions {
+    /**
+     * When true, bootstrap aborts if no runners were registered before `start()`.
+     * Default `false` (warn and idle loop).
+     */
+    requireRunners?: boolean;
+}
+//# 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,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,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;AAID,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,oBAAoB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAElF,MAAM,WAAW,4BAA4B;IACzC,0EAA0E;IAC1E,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,eAAe,CAAC;IACpB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IAC/B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B"}

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/word/word.api.d.ts

@@ -1,5 +1,5 @@
 import { BaseValidator } from "../core.utils";
-import { Word, WordDetails } from "./word.interface";
+import type { Word, WordDetails } from "./word.interface";
 export interface PostWordPayload {
     name: Word["name"];
     value: Word["value"];

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

@@ -1 +1 @@
-{"version":3,"file":"word.api.d.ts","sourceRoot":"","sources":["../../src/word/word.api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,qBAAa,iBAAkB,SAAQ,aAAa,CAAC,eAAe,CAAC;IACnE,SAAS,CAAC,cAAc,EAAE,CAAC,MAAM,eAAe,CAAC,EAAE,CAA4C;IAC/F,SAAS,CAAC,cAAc,EAAE,CAAC,MAAM,eAAe,CAAC,EAAE,CAAM;;CAS1D;AAID,eAAO,MAAM,QAAQ,YAAmB,eAAe,iDAgBtD,CAAC"}
+{"version":3,"file":"word.api.d.ts","sourceRoot":"","sources":["../../src/word/word.api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;CACxB;AAED,qBAAa,iBAAkB,SAAQ,aAAa,CAAC,eAAe,CAAC;IACjE,SAAS,CAAC,cAAc,EAAE,CAAC,MAAM,eAAe,CAAC,EAAE,CAA4C;IAC/F,SAAS,CAAC,cAAc,EAAE,CAAC,MAAM,eAAe,CAAC,EAAE,CAAM;;CAS5D;AAED,eAAO,MAAM,QAAQ,YAAmB,eAAe,iDAgBtD,CAAC"}

package/dist/word/word.interface.d.ts

@@ -1,5 +1,5 @@
-import { Target } from "../core.interface";
-import { Link } from "../link/link.interface";
+import type { Target } from "../core.interface";
+import type { Link } from "../link/link.interface";
 export declare enum CategoryWord {
     WORD = "word"
 }

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

@@ -1 +1 @@
-{"version":3,"file":"word.interface.d.ts","sourceRoot":"","sources":["../../src/word/word.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpC"}
+{"version":3,"file":"word.interface.d.ts","sourceRoot":"","sources":["../../src/word/word.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEnD,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpC"}

package/package.json

@@ -1,64 +1,94 @@
 {
-  "name": "target-supabase-sdk",
-  "version": "0.1.9",
-  "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/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.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"
+    },
+    "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"
+        },
+        "./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",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "typecheck:scripts": "tsc -p tsconfig.scripts.json",
-    "worker": "tsx scripts/run-node-worker.ts",
-    "post-task": "tsx scripts/post-task.ts",
-    "post-command": "tsx scripts/post-command.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/wicg-file-system-access": "^2023.10.7",
-    "lodash-es": "^4.17.21",
-    "typescript": "~5.7.2",
-    "tsx": "^4.19.4",
-    "zod": "^3.24.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
 }

package/src/browser.ts

@@ -0,0 +1,165 @@
+/**
+ * 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 type { SupabaseClient } from "@supabase/supabase-js";
+export * from "./core.api";
+export * from "./core.interface";
+export * from "./core.utils";
+export * from "./idea/idea.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 {
+    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 {
+    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 {
+    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 {
+    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 {
+    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,
+} from "./task/task.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";