target-supabase-sdk 0.1.7 → 0.1.9

package/dist/repo/repo-manager.js

@@ -0,0 +1,156 @@
+import { getPossibleTarget } from "../core.api";
+import { SupabaseInitializer } from "../supabase";
+import { TASK_REPO_SCRIPT_CATEGORY } from "../task/task-repo-context";
+import { assertScriptLoadable, isTaskRepoContext, pickEntryScript, } from "./repo-context.utils";
+import { CategoryRepo } from "./repo.interface";
+import { clearRepoScriptModuleCache, loadRepoContextFromScript, loadRepoContextFromUrl, } from "./repo.script-loader";
+const supabase = SupabaseInitializer.getInstance();
+const localRepoRegistry = new Map();
+const remoteContextCache = new Map();
+function buildRemoteCacheKey(taskTypeKey, contentHash) {
+    return `${taskTypeKey}@${contentHash}`;
+}
+async function fetchRemoteRepo(taskTypeKey) {
+    const { data } = await getPossibleTarget({
+        filterList: [
+            { field: "category", operator: "eq", value: CategoryRepo.REPO },
+            { field: "value", operator: "eq", value: taskTypeKey },
+        ],
+    });
+    return data ?? null;
+}
+async function fetchRemoteScripts(taskTypeKey) {
+    const { data, error } = await supabase.client
+        .from("target")
+        .select("id, value, details")
+        .eq("category", TASK_REPO_SCRIPT_CATEGORY)
+        .eq("value", taskTypeKey);
+    if (error) {
+        throw error;
+    }
+    return (data ?? []);
+}
+async function loadLocalEntry(logger, entry, taskTypeKey) {
+    if (entry.kind === "context") {
+        return entry.context;
+    }
+    const loaded = await loadRepoContextFromScript({
+        logger,
+        script: {
+            id: `local:${taskTypeKey}`,
+            value: taskTypeKey,
+            details: {
+                manifestVersion: 0,
+                modulePath: entry.modulePath,
+                exportName: entry.exportName,
+                isEntry: true,
+            },
+        },
+        taskTypeKey,
+    });
+    return loaded?.context ?? null;
+}
+async function loadRemoteRepoContext(logger, taskTypeKey) {
+    logger.info("從 Supabase 加載 Repo", { topic: "repo", context: { taskTypeKey } });
+    const remoteRepo = await fetchRemoteRepo(taskTypeKey);
+    if (remoteRepo == null) {
+        const error = `Supabase 未找到 Repo (value=${taskTypeKey})`;
+        logger.warn(error, { topic: "repo", context: { taskTypeKey } });
+        return { context: null, error };
+    }
+    const repoUrl = remoteRepo.details?.url?.trim() ?? "";
+    const repoHash = remoteRepo.details?.hash?.trim() ?? repoUrl;
+    const cacheKey = buildRemoteCacheKey(taskTypeKey, repoHash);
+    const cached = remoteContextCache.get(cacheKey);
+    if (cached != null) {
+        logger.info("命中遠程 Repo 上下文緩存", { topic: "repo", context: { cacheKey } });
+        return { context: cached };
+    }
+    const scripts = await fetchRemoteScripts(taskTypeKey);
+    const entryScript = pickEntryScript(scripts);
+    let loaded = entryScript != null && assertScriptLoadable(entryScript.details)
+        ? await loadRepoContextFromScript({ logger, script: entryScript, taskTypeKey })
+        : null;
+    if (loaded == null && repoUrl !== "") {
+        logger.info("未找到 script 行，嘗試從 Repo.details.url 加載", {
+            topic: "repo",
+            context: { taskTypeKey, url: repoUrl },
+        });
+        loaded = await loadRepoContextFromUrl({ logger, url: repoUrl, taskTypeKey });
+    }
+    if (loaded == null) {
+        const error = `無法從 Repo 加載 TaskRepoContext (hasUrl=${repoUrl !== ""}, scriptCount=${scripts.length})`;
+        logger.warn(error, {
+            topic: "repo",
+            context: { taskTypeKey, hasUrl: repoUrl !== "", scriptCount: scripts.length },
+        });
+        return { context: null, error };
+    }
+    remoteContextCache.set(cacheKey, loaded.context);
+    return { context: loaded.context };
+}
+const getRepoContext = async ({ logger, taskTypeKey, }) => {
+    const localEntry = localRepoRegistry.get(taskTypeKey);
+    if (localEntry != null) {
+        logger.info("使用本地註冊的 Repo", { topic: "repo", context: { taskTypeKey } });
+        const context = await loadLocalEntry(logger, localEntry, taskTypeKey);
+        if (context != null && isTaskRepoContext(context)) {
+            return { context: context };
+        }
+        const error = "本地 Repo 模組加載失敗或未導出有效的 TaskRepoContext";
+        logger.warn(error, { topic: "repo", context: { taskTypeKey } });
+        return { context: null, error };
+    }
+    try {
+        const result = await loadRemoteRepoContext(logger, taskTypeKey);
+        if (result.context != null && isTaskRepoContext(result.context)) {
+            return { context: result.context };
+        }
+        return {
+            context: null,
+            error: result.error ?? "遠程 Repo 上下文無效",
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error("從 Supabase 加載 Repo 失敗", {
+            topic: "repo",
+            context: { taskTypeKey, error: message },
+        });
+        return { context: null, error: message };
+    }
+};
+/** Register an in-process TaskRepoContext (highest priority — no Supabase fetch). */
+function registerLocalRepoContext(taskTypeKey, context) {
+    if (!isTaskRepoContext(context)) {
+        throw new Error("[RepoManager] Invalid TaskRepoContext");
+    }
+    localRepoRegistry.set(taskTypeKey, { kind: "context", context });
+}
+/** Register a local ESM module path; loaded via dynamic import when the task runs. */
+function registerLocalModule(taskTypeKey, modulePath, exportName) {
+    if (modulePath.trim() === "") {
+        throw new Error("[RepoManager] modulePath must not be empty");
+    }
+    localRepoRegistry.set(taskTypeKey, { kind: "modulePath", modulePath, exportName });
+}
+function unregisterLocalRepo(taskTypeKey) {
+    localRepoRegistry.delete(taskTypeKey);
+}
+function getRegisteredLocalTaskTypeKeys() {
+    return [...localRepoRegistry.keys()];
+}
+function clearRemoteContextCache() {
+    remoteContextCache.clear();
+}
+const RepoManager = {
+    getRepoContext,
+    registerLocalRepoContext,
+    registerLocalModule,
+    unregisterLocalRepo,
+    getRegisteredLocalTaskTypeKeys,
+    clearRemoteContextCache,
+    clearRepoScriptModuleCache,
+};
+export { RepoManager };
+//# sourceMappingURL=repo-manager.js.map

package/dist/repo/repo-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-manager.js","sourceRoot":"","sources":["../../src/repo/repo-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EACH,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,GAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAQ,MAAM,kBAAkB,CAAC;AACtD,OAAO,EACH,0BAA0B,EAC1B,yBAAyB,EACzB,sBAAsB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,WAAW,EAAE,CAAC;AAMnD,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAA0B,CAAC;AAC5D,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAA2B,CAAC;AAc9D,SAAS,mBAAmB,CAAC,WAAmB,EAAE,WAAmB;IACjE,OAAO,GAAG,WAAW,IAAI,WAAW,EAAE,CAAC;AAC3C,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,WAAmB;IAC9C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,iBAAiB,CAAC;QACrC,UAAU,EAAE;YACR,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE;YAC/D,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE;SACzD;KACJ,CAAC,CAAC;IACH,OAAQ,IAAoB,IAAI,IAAI,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IACjD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM;SACxC,IAAI,CAAC,QAAQ,CAAC;SACd,MAAM,CAAC,oBAAoB,CAAC;SAC5B,EAAE,CAAC,UAAU,EAAE,yBAAyB,CAAC;SACzC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAE9B,IAAI,KAAK,EAAE,CAAC;QACR,MAAM,KAAK,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,IAAI,IAAI,EAAE,CAA2B,CAAC;AAClD,CAAC;AAED,KAAK,UAAU,cAAc,CACzB,MAAyB,EACzB,KAAqB,EACrB,WAAmB;IAEnB,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACzB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC;QAC3C,MAAM;QACN,MAAM,EAAE;YACJ,EAAE,EAAE,SAAS,WAAW,EAAE;YAC1B,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE;gBACL,eAAe,EAAE,CAAC;gBAClB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,OAAO,EAAE,IAAI;aAChB;SACJ;QACD,WAAW;KACd,CAAC,CAAC;IACH,OAAO,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC;AACnC,CAAC;AAED,KAAK,UAAU,qBAAqB,CAChC,MAAyB,EACzB,WAAmB;IAEnB,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;IAE/E,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;IACtD,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,4BAA4B,WAAW,GAAG,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;QAChE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACtD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC;IAC7D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QACzE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAE7C,IAAI,MAAM,GACN,WAAW,IAAI,IAAI,IAAI,oBAAoB,CAAC,WAAW,CAAC,OAAO,CAAC;QAC5D,CAAC,CAAC,MAAM,yBAAyB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;QAC/E,CAAC,CAAC,IAAI,CAAC;IAEf,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE;YAChD,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,EAAE;SACzC,CAAC,CAAC;QACH,MAAM,GAAG,MAAM,sBAAsB,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,uCAAuC,OAAO,KAAK,EAAE,iBAAiB,OAAO,CAAC,MAAM,GAAG,CAAC;QACtG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE;YACf,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,KAAK,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE;SAChF,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IAED,kBAAkB,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,cAAc,GAAG,KAAK,EAAuC,EAC/D,MAAM,EACN,WAAW,GACQ,EAA8C,EAAE;IACnE,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACtD,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;QACzE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QACtE,IAAI,OAAO,IAAI,IAAI,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;YAChD,OAAO,EAAE,OAAO,EAAE,OAAsB,EAAE,CAAC;QAC/C,CAAC;QACD,MAAM,KAAK,GAAG,uCAAuC,CAAC;QACtD,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;QAChE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IAED,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAChE,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI,IAAI,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAsB,EAAE,CAAC;QACtD,CAAC;QACD,OAAO;YACH,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,eAAe;SACzC,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;YAClC,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE;SAC3C,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC7C,CAAC;AACL,CAAC,CAAC;AAEF,qFAAqF;AACrF,SAAS,wBAAwB,CAAC,WAAmB,EAAE,OAAwB;IAC3E,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC7D,CAAC;IACD,iBAAiB,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,sFAAsF;AACtF,SAAS,mBAAmB,CAAC,WAAmB,EAAE,UAAkB,EAAE,UAAmB;IACrF,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAClE,CAAC;IACD,iBAAiB,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,mBAAmB,CAAC,WAAmB;IAC5C,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,8BAA8B;IACnC,OAAO,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,uBAAuB;IAC5B,kBAAkB,CAAC,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,WAAW,GAAG;IAChB,cAAc;IACd,wBAAwB;IACxB,mBAAmB;IACnB,mBAAmB;IACnB,8BAA8B;IAC9B,uBAAuB;IACvB,0BAA0B;CAC7B,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/repo/repo.api.d.ts

@@ -0,0 +1,16 @@
+import { SupabaseResponse } from "../core.interface";
+import { z } from "zod";
+export declare const getScanRemoteRepoValuesSchema: z.ZodObject<{
+    usage: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    usage: string;
+}, {
+    usage: string;
+}>;
+export type GetScanRemoteRepoValuesPayload = z.infer<typeof getScanRemoteRepoValuesSchema>;
+/**
+ * Scan `Repo.value` keys for `category=repo` with matching `details.usage`.
+ * Returns `{ data: string[] }` on success; validation and DB failures use `{ error }` (never throws).
+ */
+export declare const getScanRemoteRepoValues: (payload: GetScanRemoteRepoValuesPayload) => Promise<SupabaseResponse<string[]>>;
+//# sourceMappingURL=repo.api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repo.api.d.ts","sourceRoot":"","sources":["../../src/repo/repo.api.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,6BAA6B;;;;;;EAExC,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAE3F;;;GAGG;AACH,eAAO,MAAM,uBAAuB,YACvB,8BAA8B,KACxC,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAOpC,CAAC"}

package/dist/repo/repo.api.js

@@ -0,0 +1,40 @@
+import { scanTargetList, validateWithSchema } from "../core.api";
+import { generateResponse } from "../core.interface";
+import { z } from "zod";
+import { CategoryRepo } from "./repo.interface";
+const REPO_USAGE_FIELD = "details->>usage";
+export const getScanRemoteRepoValuesSchema = z.object({
+    usage: z.string().trim().min(1),
+});
+/**
+ * Scan `Repo.value` keys for `category=repo` with matching `details.usage`.
+ * Returns `{ data: string[] }` on success; validation and DB failures use `{ error }` (never throws).
+ */
+export const getScanRemoteRepoValues = async (payload) => {
+    try {
+        return await getScanRemoteRepoValuesValidated(payload);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return generateResponse.error(message);
+    }
+};
+const getScanRemoteRepoValuesValidated = validateWithSchema(getScanRemoteRepoValuesSchema, "getScanRemoteRepoValuesSchema")(async ({ usage }) => {
+    try {
+        const { data } = await scanTargetList({
+            category: CategoryRepo.REPO,
+            selectFields: "value",
+            orderBy: { field: "value", ascending: true },
+            filterList: [{ field: REPO_USAGE_FIELD, operator: "eq", value: usage }],
+        });
+        const values = (data ?? [])
+            .map((row) => row.value?.trim())
+            .filter((value) => value != null && value !== "");
+        return generateResponse.success([...new Set(values)]);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return generateResponse.error(message);
+    }
+});
+//# sourceMappingURL=repo.api.js.map

package/dist/repo/repo.api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.api.js","sourceRoot":"","sources":["../../src/repo/repo.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAoB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAQ,MAAM,kBAAkB,CAAC;AAEtD,MAAM,gBAAgB,GAAG,iBAA0B,CAAC;AAEpD,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAClC,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EACxC,OAAuC,EACJ,EAAE;IACrC,IAAI,CAAC;QACD,OAAO,MAAM,gCAAgC,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAA+B,CAAC;IACzE,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,gCAAgC,GAAG,kBAAkB,CACvD,6BAA6B,EAC7B,+BAA+B,CAClC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAuC,EAAE;IACvD,IAAI,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,cAAc,CAAO;YACxC,QAAQ,EAAE,YAAY,CAAC,IAAI;YAC3B,YAAY,EAAE,OAAO;YACrB,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE;YAC5C,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;SAC1E,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;aACtB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;aAC/B,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;QAEvE,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAA+B,CAAC;IACzE,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/repo/repo.interface.d.ts

@@ -0,0 +1,27 @@
+import { Target } from "../core.interface";
+export declare enum CategoryRepo {
+    /** Project */
+    REPO = "repo"
+}
+/** `Repo.details.usage` for task worker remote discovery ({@link registerTasks}). */
+export declare const TASK_REPO_USAGE = "task";
+export interface Repo extends Target {
+    /** Human readable name */
+    name: string;
+    /** Unique key, consumers use this to determine which repo to use */
+    value: string;
+    details: RepoDetails;
+    category: CategoryRepo;
+}
+export interface RepoDetails {
+    manifestVersion: number;
+    /**
+     * Business usage partition for discovery and load (caller-defined string, e.g. `"task"`).
+     * Used by {@link getScanRemoteRepoValues} to narrow scan scope; validity is the caller's responsibility.
+     */
+    usage: string;
+    /** Repo entry module URL or filesystem path — used to dynamic-import TaskRepoContext. */
+    url: string;
+    hash: string;
+}
+//# sourceMappingURL=repo.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repo.interface.d.ts","sourceRoot":"","sources":["../../src/repo/repo.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,oBAAY,YAAY;IACpB,cAAc;IACd,IAAI,SAAS;CAChB;AAED,qFAAqF;AACrF,eAAO,MAAM,eAAe,SAAS,CAAC;AAEtC,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,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;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,yFAAyF;IACzF,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CAChB"}

package/dist/repo/repo.interface.js

@@ -0,0 +1,8 @@
+export var CategoryRepo;
+(function (CategoryRepo) {
+    /** Project */
+    CategoryRepo["REPO"] = "repo";
+})(CategoryRepo || (CategoryRepo = {}));
+/** `Repo.details.usage` for task worker remote discovery ({@link registerTasks}). */
+export const TASK_REPO_USAGE = "task";
+//# sourceMappingURL=repo.interface.js.map

package/dist/repo/repo.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.interface.js","sourceRoot":"","sources":["../../src/repo/repo.interface.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACpB,cAAc;IACd,6BAAa,CAAA;AACjB,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB;AAED,qFAAqF;AACrF,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC"}

package/dist/repo/repo.script-loader.d.ts

@@ -0,0 +1,19 @@
+import { LoggerWithContext } from "../shared/log/log-manager";
+import { TaskRepoScriptRecord } from "../task/task-repo-context";
+import { LoadedRepoContext } from "./repo-context.utils";
+/** Resolve repo `details.url` to a value suitable for dynamic `import()`. */
+export declare function resolveRepoEntryHref(url: string, cwd?: string): string;
+export declare function loadRepoContextFromScript({ logger, script, taskTypeKey, }: {
+    logger: LoggerWithContext;
+    script: TaskRepoScriptRecord;
+    taskTypeKey: string;
+}): Promise<LoadedRepoContext | null>;
+export declare function loadRepoContextFromUrl({ logger, url, taskTypeKey, exportName, }: {
+    logger: LoggerWithContext;
+    url: string;
+    taskTypeKey: string;
+    exportName?: string;
+}): Promise<LoadedRepoContext | null>;
+/** Clear in-memory imported module cache (tests / hot reload). */
+export declare function clearRepoScriptModuleCache(): void;
+//# sourceMappingURL=repo.script-loader.d.ts.map

package/dist/repo/repo.script-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.script-loader.d.ts","sourceRoot":"","sources":["../../src/repo/repo.script-loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAEH,iBAAiB,EAEpB,MAAM,sBAAsB,CAAC;AAQ9B,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAAgB,GAAG,MAAM,CAM7E;AAWD,wBAAsB,yBAAyB,CAAC,EAC5C,MAAM,EACN,MAAM,EACN,WAAW,GACd,EAAE;IACC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CA8CpC;AAED,wBAAsB,sBAAsB,CAAC,EACzC,MAAM,EACN,GAAG,EACH,WAAW,EACX,UAAU,GACb,EAAE;IACC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CA8BpC;AAED,kEAAkE;AAClE,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}

package/dist/repo/repo.script-loader.js

@@ -0,0 +1,108 @@
+import { createHash } from "node:crypto";
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { resolvePathFromCwd, toFileImportHref } from "../shared/utils/config-path.utils";
+import { getScriptLoadKey, normalizeRepoContextModule, } from "./repo-context.utils";
+const importedModuleCache = new Map();
+async function importFromFilePath(modulePath) {
+    return import(toFileImportHref(modulePath));
+}
+/** Resolve repo `details.url` to a value suitable for dynamic `import()`. */
+export function resolveRepoEntryHref(url, cwd = process.cwd()) {
+    const trimmed = url.trim();
+    if (trimmed.includes("://")) {
+        return trimmed;
+    }
+    return toFileImportHref(resolvePathFromCwd(cwd, trimmed));
+}
+async function importFromSource(source, cacheKey) {
+    const hash = createHash("sha256").update(source).digest("hex").slice(0, 16);
+    const dir = join(tmpdir(), "target-supabase-sdk", "repo-scripts");
+    await mkdir(dir, { recursive: true });
+    const filePath = join(dir, `${cacheKey}-${hash}.mjs`);
+    await writeFile(filePath, source, "utf8");
+    return importFromFilePath(filePath);
+}
+export async function loadRepoContextFromScript({ logger, script, taskTypeKey, }) {
+    const loadKey = getScriptLoadKey(script);
+    const cacheKey = `${taskTypeKey}@${loadKey}`;
+    const cached = importedModuleCache.get(cacheKey);
+    if (cached != null) {
+        logger.info("命中 Repo 脚本模块缓存", { topic: "repo", context: { cacheKey } });
+        return cached;
+    }
+    const { source, modulePath, exportName } = script.details;
+    try {
+        let moduleExports;
+        if (source != null && source.trim() !== "") {
+            logger.info("从 source 动态加载 Repo 脚本", { topic: "repo", context: { scriptId: script.id } });
+            moduleExports = await importFromSource(source, cacheKey);
+        }
+        else if (modulePath != null && modulePath.trim() !== "") {
+            logger.info("从 modulePath 动态加载 Repo 脚本", {
+                topic: "repo",
+                context: { scriptId: script.id, modulePath },
+            });
+            moduleExports = await importFromFilePath(modulePath);
+        }
+        else {
+            logger.warn("脚本缺少 source 或 modulePath", { topic: "repo", context: { scriptId: script.id } });
+            return null;
+        }
+        const context = normalizeRepoContextModule(moduleExports, taskTypeKey, exportName);
+        if (context == null) {
+            logger.warn("脚本模块未导出合法的 TaskRepoContext", {
+                topic: "repo",
+                context: { scriptId: script.id, exportName: exportName ?? "default" },
+            });
+            return null;
+        }
+        const loaded = { context, contentHash: loadKey };
+        importedModuleCache.set(cacheKey, loaded);
+        return loaded;
+    }
+    catch (error) {
+        logger.error("动态加载 Repo 脚本失败", {
+            topic: "repo",
+            context: { scriptId: script.id, error: error instanceof Error ? error.message : error },
+        });
+        return null;
+    }
+}
+export async function loadRepoContextFromUrl({ logger, url, taskTypeKey, exportName, }) {
+    const href = resolveRepoEntryHref(url);
+    const cacheKey = `${taskTypeKey}@url:${href}`;
+    const cached = importedModuleCache.get(cacheKey);
+    if (cached != null) {
+        logger.info("命中 Repo URL 模块缓存", { topic: "repo", context: { cacheKey } });
+        return cached;
+    }
+    try {
+        logger.info("从 Repo URL 动态加载脚本", { topic: "repo", context: { url, href } });
+        const moduleExports = await import(href);
+        const context = normalizeRepoContextModule(moduleExports, taskTypeKey, exportName);
+        if (context == null) {
+            logger.warn("Repo URL 模块未导出合法的 TaskRepoContext", {
+                topic: "repo",
+                context: { url, exportName: exportName ?? "default" },
+            });
+            return null;
+        }
+        const loaded = { context, contentHash: cacheKey };
+        importedModuleCache.set(cacheKey, loaded);
+        return loaded;
+    }
+    catch (error) {
+        logger.error("从 Repo URL 动态加载失败", {
+            topic: "repo",
+            context: { url, error: error instanceof Error ? error.message : error },
+        });
+        return null;
+    }
+}
+/** Clear in-memory imported module cache (tests / hot reload). */
+export function clearRepoScriptModuleCache() {
+    importedModuleCache.clear();
+}
+//# sourceMappingURL=repo.script-loader.js.map

package/dist/repo/repo.script-loader.js.map

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

package/dist/review/review.api.js

@@ -1,6 +1,6 @@
 import { cloneDeep } from "lodash-es";
 import { createTarget, getPossibleTarget, updateTargetDetails } from "../core.api";
-import { createResponse } from "../core.interface";
+import { generateResponse } from "../core.interface";
 import { BaseValidator } from "../core.utils";
 import { CategoryReview } from "./review.interface";
 class PatchUpsertReviewValidator extends BaseValidator {
@@ -10,7 +10,7 @@ class PatchUpsertReviewValidator extends BaseValidator {
     constructor() {
         super();
         // Add custom
-        this.addValidator((val) => {
+        this.addCustomValidator((val) => {
             if (val.reviewResult == null || Object.values(val.reviewResult).some((v) => typeof v !== "number")) {
                 return "[Check reviewResult] reviewResult invalid";
             }
@@ -64,7 +64,7 @@ export const patchUpsertReview = async (payload) => {
                 return details;
             },
         });
-        return createResponse.success(data);
+        return generateResponse.success(data);
     }
     // Create
     const { data: newReview } = await postReview({
@@ -76,7 +76,7 @@ export const patchUpsertReview = async (payload) => {
         console.error(msg);
         throw new Error(msg);
     }
-    return createResponse.success(newReview);
+    return generateResponse.success(newReview);
 };
 export class PostReviewValidator extends BaseValidator {
     requiredFields = ["reviewTargetId", "reviewDomain"];
@@ -84,7 +84,7 @@ export class PostReviewValidator extends BaseValidator {
     constructor() {
         super();
         // Add custom
-        this.addValidator((val) => {
+        this.addCustomValidator((val) => {
             return true;
         });
     }

package/dist/review/review.api.js.map

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

package/dist/shared/log/create-api-logger.d.ts

@@ -0,0 +1,17 @@
+import { type LogContext, type LoggerWithContext } from "./log-manager";
+/**
+ * Options for {@link createApiLogger}.
+ *
+ * - **Core:** optional `traceId` (generated when omitted)
+ * - **Business:** any other {@link LogContext} field (e.g. `nodeId`)
+ */
+export type CreateApiLoggerOptions = {
+    traceId?: string;
+} & Partial<Omit<LogContext, "module" | "traceId">>;
+/**
+ * Logger for one SDK API invocation.
+ *
+ * Binds required `module` + optional caller `traceId`; business fields (e.g. `nodeId`) are optional.
+ */
+export declare function createApiLogger(module: string, options?: CreateApiLoggerOptions): LoggerWithContext;
+//# sourceMappingURL=create-api-logger.d.ts.map

package/dist/shared/log/create-api-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-api-logger.d.ts","sourceRoot":"","sources":["../../../src/shared/log/create-api-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,iBAAiB,CAOnG"}

package/dist/shared/log/create-api-logger.js

@@ -0,0 +1,15 @@
+import { logManager } from "./log-manager";
+/**
+ * Logger for one SDK API invocation.
+ *
+ * Binds required `module` + optional caller `traceId`; business fields (e.g. `nodeId`) are optional.
+ */
+export function createApiLogger(module, options) {
+    const { traceId, ...businessFields } = options ?? {};
+    return logManager.withContext({
+        module,
+        traceId: traceId ?? logManager.generateTraceId(),
+        ...businessFields,
+    }).logger;
+}
+//# sourceMappingURL=create-api-logger.js.map

package/dist/shared/log/create-api-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-api-logger.js","sourceRoot":"","sources":["../../../src/shared/log/create-api-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2C,MAAM,eAAe,CAAC;AAYpF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,OAAgC;IAC5E,MAAM,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IACrD,OAAO,UAAU,CAAC,WAAW,CAAC;QAC1B,MAAM;QACN,OAAO,EAAE,OAAO,IAAI,UAAU,CAAC,eAAe,EAAE;QAChD,GAAG,cAAc;KACpB,CAAC,CAAC,MAAM,CAAC;AACd,CAAC"}

package/dist/shared/log/log-manager.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Log severity and semantics (low → high). `minLevel` filters by {@link LOG_LEVEL_RANK}.
+ *
+ * | Level    | Rank | When to use |
+ * |----------|------|-------------|
+ * | DEBUG    | 0    | Diagnostic detail for dev/troubleshooting; noisy, safe to drop in prod. |
+ * | INFO     | 1    | Normal operational flow (startup, polling, state transitions). |
+ * | SUCCESS  | 2    | Positive milestone within a flow (not a separate severity axis — same band as INFO). |
+ * | WARN     | 3    | Recoverable anomaly or degradation; work continues but worth watching. |
+ * | ERROR    | 4    | A concrete operation failed (API, task step, I/O); investigate and retry/fix locally. |
+ * | CRITICAL | 5    | Invariant violated — design flaw, data-integrity risk, or business rule broken; escalate and fix urgently. |
+ */
+declare enum LogLevel {
+    DEBUG = "DEBUG",
+    INFO = "INFO",
+    SUCCESS = "SUCCESS",
+    WARN = "WARN",
+    ERROR = "ERROR",
+    CRITICAL = "CRITICAL"
+}
+interface LogEntry {
+    timestamp: number;
+    level: LogLevel;
+    /** Tell people what happened, but more structured */
+    message: string;
+    /** Category of a kind of log */
+    topic: string | null;
+    /** Where the log comes from */
+    module: string;
+    /** Specific process — correlates one logical chain (loop, request). */
+    traceId: string;
+    /** Worker node id when the log is node-scoped; omit for scheduler / admin / API-only paths. */
+    nodeId?: string;
+    extra?: string;
+    context?: unknown;
+}
+interface LogContext {
+    module: LogEntry["module"];
+    traceId: LogEntry["traceId"];
+    nodeId?: LogEntry["nodeId"];
+}
+type LogRestParams = Omit<LogParams, "message">;
+interface LogEntryPayload {
+    message: LogEntry["message"];
+    topic?: LogEntry["topic"];
+    extra?: LogEntry["extra"];
+    context?: LogEntry["context"];
+    level: LogEntry["level"];
+    module: LogEntry["module"];
+    traceId: LogEntry["traceId"];
+    nodeId?: LogEntry["nodeId"];
+}
+type LogParams = Pick<LogEntryPayload, "message" | "topic" | "extra" | "context">;
+interface LogOptions {
+    defaultTopic: LogEntry["topic"];
+    formatTimestamp: boolean;
+    formatEmoji: boolean;
+    formatPrefix: string;
+    maxHistoryLength: number;
+    /** Logs below this level are skipped. Defaults to DEBUG in dev, INFO in production. */
+    minLevel?: LogLevel;
+    onLog?: (entry: LogEntry) => void;
+}
+interface LoggerWithContext {
+    /** Rank 0 — diagnostic detail; dev/troubleshooting only. */
+    debug: (message: LogParams["message"], restParams?: LogRestParams) => void;
+    /** Rank 1 — normal operational flow. */
+    info: (message: LogParams["message"], restParams?: LogRestParams) => void;
+    /** Rank 2 — positive milestone (semantic INFO, not higher severity). */
+    success: (message: LogParams["message"], restParams?: LogRestParams) => void;
+    /** Rank 3 — recoverable anomaly; system continues. */
+    warn: (message: LogParams["message"], restParams?: LogRestParams) => void;
+    /** Rank 4 — a concrete operation failed; needs investigation. */
+    error: (message: LogParams["message"], restParams?: LogRestParams) => void;
+    /** Rank 5 — invariant / design / integrity breach; escalate immediately. */
+    critical: (message: LogParams["message"], restParams?: LogRestParams) => void;
+    /** Merge partial fields into this logger's bound context (e.g. nodeId after register). */
+    resetContext: (fields: Partial<LogContext>) => void;
+}
+declare class LogManager {
+    private static instance;
+    private options;
+    private history;
+    private readonly levelEmojis;
+    private constructor();
+    static getInstance(options?: Partial<LogOptions>): LogManager;
+    setOptions(options: Partial<LogOptions>): void;
+    getHistory(): LogEntry[];
+    clearHistory(): void;
+    private getMinLevel;
+    private shouldLog;
+    private createLogEntry;
+    private formatLevelTag;
+    private formatLog;
+    private emitLog;
+    private log;
+    generateTraceId(): string;
+    debug(message: LogParams["message"], logContext: LogContext, restParams?: LogRestParams): void;
+    info(message: LogParams["message"], logContext: LogContext, restParams?: LogRestParams): void;
+    success(message: LogParams["message"], logContext: LogContext, restParams?: LogRestParams): void;
+    warn(message: LogParams["message"], logContext: LogContext, restParams?: LogRestParams): void;
+    error(message: LogParams["message"], logContext: LogContext, restParams?: LogRestParams): void;
+    critical(message: LogParams["message"], logContext: LogContext, restParams?: LogRestParams): void;
+    withContext(context: LogContext): {
+        logger: LoggerWithContext;
+        context: LogContext;
+    };
+}
+export declare const logManager: LogManager;
+export { LogManager, LogLevel };
+export { createApiLogger } from "./create-api-logger";
+export type { CreateApiLoggerOptions } from "./create-api-logger";
+export type { LogOptions, LogEntry, LogContext, LoggerWithContext, LogRestParams };
+//# sourceMappingURL=log-manager.d.ts.map