target-supabase-sdk 0.3.1 → 0.3.3

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

@@ -1,145 +0,0 @@
-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, {
-        kind: "daily";
-        hour: number;
-        minute: number;
-    }, {
-        kind: "daily";
-        hour: number;
-        minute: number;
-    }>;
-    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, {
-        kind: "post_task";
-        taskTypeKey: string;
-        taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
-        taskParams?: unknown;
-        taskName?: string | undefined;
-    }, {
-        kind: "post_task";
-        taskTypeKey: string;
-        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, {
-    status: TriggerStatus;
-    value: string;
-    name: string;
-    tagList: string[];
-    action: {
-        kind: "post_task";
-        taskTypeKey: string;
-        taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
-        taskParams?: unknown;
-        taskName?: string | undefined;
-    };
-    schedule: {
-        kind: "daily";
-        hour: number;
-        minute: number;
-    };
-    traceId?: string | undefined;
-}, {
-    value: string;
-    name: string;
-    action: {
-        kind: "post_task";
-        taskTypeKey: string;
-        taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
-        taskParams?: unknown;
-        taskName?: string | undefined;
-    };
-    schedule: {
-        kind: "daily";
-        hour: number;
-        minute: number;
-    };
-    status?: TriggerStatus | undefined;
-    tagList?: string[] | undefined;
-    traceId?: string | 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. Due-check is in-memory on the caller:
- * filter with `isTriggerDue`, then `patchTriggerFired` with `buildFireKey`
- * (both from `trigger.utils`, exported on `/node`).
- * Do not call this from TriggerNode (local interval runners only).
- */
-export declare const scanEnabledTriggers: (payload: {
-    traceId?: string | undefined;
-}) => SupabaseResponse<Trigger[]> | Promise<SupabaseResponse<Trigger[]>>;
-/** Create a trigger row (scheduler / admin). */
-export declare const postTrigger: (payload: {
-    status: TriggerStatus;
-    value: string;
-    name: string;
-    tagList: string[];
-    action: {
-        kind: "post_task";
-        taskTypeKey: string;
-        taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
-        taskParams?: unknown;
-        taskName?: string | undefined;
-    };
-    schedule: {
-        kind: "daily";
-        hour: number;
-        minute: number;
-    };
-    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

@@ -1 +0,0 @@
-{"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;;;;;GAKG;AACH,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.utils.d.ts

@@ -1,6 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/src/trigger/trigger.api.ts

@@ -1,171 +0,0 @@
-import { z } from "zod";
-import { createTarget, scanTargetList, updateTargetDetails, validateWithSchema } from "../core.api";
-import { generateResponse, type SupabaseResponse } from "../core.interface";
-import { createLogger } from "../shared/log";
-import { TaskStatus } from "../task/task.interface";
-import {
-    CategoryTrigger,
-    type Trigger,
-    type TriggerAction,
-    type TriggerSchedule,
-    TriggerStatus,
-} from "./trigger.interface";
-
-const TRIGGER_STATUS_FIELD = "details->>status" as const;
-
-const traceIdSchema = z.string().trim().min(1).optional();
-
-const dailyScheduleSchema = z.object({
-    kind: z.literal("daily"),
-    hour: z.number().int().min(0).max(23),
-    minute: z.number().int().min(0).max(59),
-});
-
-const postTaskActionSchema = z.object({
-    kind: z.literal("post_task"),
-    taskTypeKey: z.string().trim().min(1),
-    taskParams: z.unknown(),
-    taskName: z.string().trim().min(1).optional(),
-    taskStatus: z.enum([TaskStatus.OPEN, TaskStatus.TODO]).optional(),
-});
-
-export const postTriggerSchema = z.object({
-    name: z.string().trim().min(1),
-    value: z.string().trim().min(1),
-    status: z.nativeEnum(TriggerStatus).optional().default(TriggerStatus.ENABLED),
-    schedule: dailyScheduleSchema,
-    action: postTaskActionSchema,
-    tagList: z.array(z.string()).optional().default([]),
-    traceId: traceIdSchema,
-});
-
-export type PostTriggerPayload = z.infer<typeof postTriggerSchema>;
-
-export const scanEnabledTriggersSchema = z.object({
-    traceId: traceIdSchema,
-});
-
-export type ScanEnabledTriggersPayload = z.infer<typeof scanEnabledTriggersSchema>;
-
-export const patchTriggerFiredSchema = z.object({
-    triggerId: z.string().trim().min(1),
-    fireKey: z.string().trim().min(1),
-    expectedLastFireKey: z.string().nullable().optional(),
-    traceId: traceIdSchema,
-});
-
-export type PatchTriggerFiredPayload = z.infer<typeof patchTriggerFiredSchema>;
-
-function enabledTriggerFilter() {
-    return [{ field: TRIGGER_STATUS_FIELD, operator: "eq" as const, value: TriggerStatus.ENABLED }];
-}
-
-/**
- * List all ENABLED triggers. Due-check is in-memory on the caller:
- * filter with `isTriggerDue`, then `patchTriggerFired` with `buildFireKey`
- * (both from `trigger.utils`, exported on `/node`).
- * Do not call this from TriggerNode (local interval runners only).
- */
-export const scanEnabledTriggers = validateWithSchema(
-    scanEnabledTriggersSchema,
-    "scanEnabledTriggersSchema",
-)(async ({ traceId }) => {
-    const logger = createLogger({ module: "scanEnabledTriggers", traceId });
-
-    try {
-        const { data: triggerList } = await scanTargetList<Trigger>({
-            category: CategoryTrigger.TRIGGER,
-            filterList: enabledTriggerFilter(),
-            orderBy: { field: "created_at", ascending: true },
-        });
-
-        const rows = triggerList ?? [];
-        logger.debug("已掃描 ENABLED Trigger", {
-            topic: "trigger",
-            data: { count: rows.length },
-        });
-
-        return generateResponse.success(rows);
-    } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return generateResponse.error(message) as SupabaseResponse<Trigger[]>;
-    }
-});
-
-/** Create a trigger row (scheduler / admin). */
-export const postTrigger = validateWithSchema(
-    postTriggerSchema,
-    "postTriggerSchema",
-)(async ({ name, value, status, schedule, action, tagList, traceId }) => {
-    const logger = createLogger({ module: "postTrigger", traceId });
-
-    const details = {
-        manifestVersion: 0,
-        status,
-        schedule: schedule as TriggerSchedule,
-        action: action as TriggerAction,
-        lastFiredAt: null,
-        lastFireKey: null,
-    };
-
-    const result = await createTarget<Trigger, PostTriggerPayload>({
-        payload: { name, value, status, schedule, action, tagList, traceId },
-        createFn: () => ({
-            name,
-            value,
-            category: CategoryTrigger.TRIGGER,
-            tagList,
-            details,
-        }),
-    });
-
-    logger.info("Trigger 已創建", {
-        topic: "trigger",
-        data: { triggerId: result.data?.id, triggerKey: value, status },
-    });
-
-    return result;
-});
-
-/**
- * Mark trigger as fired for `fireKey`.
- * When `expectedLastFireKey` is set, uses optimistic lock on that field.
- */
-export const patchTriggerFired = validateWithSchema(
-    patchTriggerFiredSchema,
-    "patchTriggerFiredSchema",
-)(async ({ triggerId, fireKey, expectedLastFireKey, traceId }) => {
-    const logger = createLogger({ module: "patchTriggerFired", traceId });
-    const now = Date.now();
-
-    try {
-        const optimisticLockFilterList =
-            expectedLastFireKey != null && expectedLastFireKey !== ""
-                ? [{ field: "details->>lastFireKey" as const, operator: "eq" as const, value: expectedLastFireKey }]
-                : [];
-
-        const data = await updateTargetDetails<Trigger, Trigger["details"]>({
-            id: triggerId,
-            optimisticLockFilterList,
-            updateFn: (current) => ({
-                ...current,
-                lastFireKey: fireKey,
-                lastFiredAt: now,
-            }),
-        });
-
-        logger.success("Trigger 觸發記錄已更新", {
-            topic: "trigger",
-            data: { triggerId, fireKey },
-        });
-
-        return generateResponse.success(data);
-    } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        logger.warn("Trigger 觸發記錄更新失敗", {
-            topic: "trigger",
-            data: { triggerId, fireKey, error: message },
-        });
-        return generateResponse.error(message);
-    }
-});

package/src/trigger/trigger.utils.ts

@@ -1,56 +0,0 @@
-import type { Trigger, TriggerDailySchedule } from "./trigger.interface";
-
-interface UtcDateParts {
-    year: number;
-    month: number;
-    day: number;
-    hour: number;
-    minute: number;
-}
-
-function parseUtcDateParts(now: Date): UtcDateParts {
-    return {
-        year: now.getUTCFullYear(),
-        month: now.getUTCMonth() + 1,
-        day: now.getUTCDate(),
-        hour: now.getUTCHours(),
-        minute: now.getUTCMinutes(),
-    };
-}
-
-export function buildDailyFireKey(_schedule: TriggerDailySchedule, now: Date): string {
-    const { year, month, day } = parseUtcDateParts(now);
-    const yyyy = String(year).padStart(4, "0");
-    const mm = String(month).padStart(2, "0");
-    const dd = String(day).padStart(2, "0");
-    return `daily:${yyyy}-${mm}-${dd}`;
-}
-
-export function isDailyScheduleDue(
-    schedule: TriggerDailySchedule,
-    now: Date,
-    lastFireKey: string | null | undefined,
-): boolean {
-    const parts = parseUtcDateParts(now);
-    if (parts.hour !== schedule.hour || parts.minute !== schedule.minute) {
-        return false;
-    }
-    const fireKey = buildDailyFireKey(schedule, now);
-    return lastFireKey !== fireKey;
-}
-
-export function isTriggerDue(trigger: Trigger, now: Date = new Date()): boolean {
-    const { schedule, lastFireKey } = trigger.details;
-    if (schedule.kind !== "daily") {
-        throw new Error(`Unsupported trigger schedule kind: ${String((schedule as { kind?: string }).kind)}`);
-    }
-    return isDailyScheduleDue(schedule, now, lastFireKey);
-}
-
-export function buildFireKey(trigger: Trigger, now: Date = new Date()): string {
-    const { schedule } = trigger.details;
-    if (schedule.kind !== "daily") {
-        throw new Error(`Unsupported trigger schedule kind: ${String((schedule as { kind?: string }).kind)}`);
-    }
-    return buildDailyFireKey(schedule, now);
-}