target-supabase-sdk 0.1.9 → 0.2.1

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

@@ -1,3 +1,4 @@
+import { type LoggerResetScopePatch, type LogScope } from "./log-scope";
 /**
  * Log severity and semantics (low → high). `minLevel` filters by {@link LOG_LEVEL_RANK}.
  *
@@ -18,75 +19,53 @@ declare enum LogLevel {
     ERROR = "ERROR",
     CRITICAL = "CRITICAL"
 }
-interface LogEntry {
+interface LogEntry extends LogScope {
     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;
+    topic: string;
     extra?: string;
-    context?: unknown;
+    /** Per-line structured business payload. */
+    data?: 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"];
+type LogRestParams = {
+    topic: string;
     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">;
+    data?: unknown;
+};
+type LogParams = {
+    message: LogEntry["message"];
+} & LogRestParams;
 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;
+/** Per-scoped-logger options for {@link LogManager.withScope}. */
+interface WithScopeOptions {
+    /** Overrides global {@link LogOptions.minLevel} for this logger instance. */
+    minLevel?: LogLevel;
+}
+interface LoggerWithScope {
+    debug: (message: LogParams["message"], restParams: LogRestParams) => void;
+    info: (message: LogParams["message"], restParams: LogRestParams) => void;
+    success: (message: LogParams["message"], restParams: LogRestParams) => void;
+    warn: (message: LogParams["message"], restParams: LogRestParams) => void;
+    error: (message: LogParams["message"], restParams: LogRestParams) => void;
+    critical: (message: LogParams["message"], restParams: LogRestParams) => void;
+    /** Merge labels / module into this logger's bound scope (trace fields are not mutable). */
+    resetScope: (patch: LoggerResetScopePatch) => 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;
@@ -95,20 +74,18 @@ declare class LogManager {
     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;
+    debug(message: LogParams["message"], logScope: LogScope, restParams: LogRestParams): void;
+    info(message: LogParams["message"], logScope: LogScope, restParams: LogRestParams): void;
+    success(message: LogParams["message"], logScope: LogScope, restParams: LogRestParams): void;
+    warn(message: LogParams["message"], logScope: LogScope, restParams: LogRestParams): void;
+    error(message: LogParams["message"], logScope: LogScope, restParams: LogRestParams): void;
+    critical(message: LogParams["message"], logScope: LogScope, restParams: LogRestParams): void;
+    withScope(scope: LogScope, options?: WithScopeOptions): {
+        logger: LoggerWithScope;
+        scope: LogScope;
     };
 }
 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 };
+export type { LogEntry, LoggerWithScope, LogOptions, LogRestParams, WithScopeOptions };
+export { LogLevel, LogManager };
 //# sourceMappingURL=log-manager.d.ts.map

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

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

package/dist/shared/log/log-persist-batch-id.d.ts

@@ -0,0 +1,13 @@
+import type { LogEntry } from "./log-manager";
+import type { LogPersistLane } from "./log-persist.interface";
+/**
+ * Deterministic List.value for a log batch — retries after timeout map to the same row key.
+ * SHA-256 over canonical JSON (service + process + lane + entries in order).
+ */
+export declare function computeLogBatchIdempotencyKey(input: {
+    service: string;
+    process: string;
+    lane: LogPersistLane;
+    entries: LogEntry[];
+}): string;
+//# sourceMappingURL=log-persist-batch-id.d.ts.map

package/dist/shared/log/log-persist-batch-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-persist-batch-id.d.ts","sourceRoot":"","sources":["../../../src/shared/log/log-persist-batch-id.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAoB9D;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,QAAQ,EAAE,CAAC;CACvB,GAAG,MAAM,CAWT"}

package/dist/shared/log/log-persist-flush.d.ts

@@ -0,0 +1,8 @@
+import type { LogEntry } from "./log-manager";
+import type { BuildLogListDraftInput, LogListDraft } from "./log-persist.interface";
+export declare function estimateEntriesBytes(entries: LogEntry[]): number;
+export declare function buildLogListDraft(input: BuildLogListDraftInput): LogListDraft;
+export declare function postLogBatch(draft: LogListDraft, postTimeoutMs: number): Promise<void>;
+/** Take a prefix of entries that fits within maxBytes. */
+export declare function takeEntriesWithinBytes(entries: LogEntry[], maxBytes: number): LogEntry[];
+//# sourceMappingURL=log-persist-flush.d.ts.map

package/dist/shared/log/log-persist-flush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-persist-flush.d.ts","sourceRoot":"","sources":["../../../src/shared/log/log-persist-flush.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGpF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAShE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CA4B7E;AAoBD,wBAAsB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC5F;AAED,0DAA0D;AAC1D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,CAyBxF"}

package/dist/shared/log/log-persist-hook.d.ts

@@ -0,0 +1,6 @@
+import type { LogEntry } from "./log-manager";
+type LogPersistOfferFn = (entry: LogEntry) => void;
+export declare function registerLogPersistOffer(fn: LogPersistOfferFn | null): void;
+export declare function offerToLogPersist(entry: LogEntry): void;
+export {};
+//# sourceMappingURL=log-persist-hook.d.ts.map

package/dist/shared/log/log-persist-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-persist-hook.d.ts","sourceRoot":"","sources":["../../../src/shared/log/log-persist-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,KAAK,iBAAiB,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAInD,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAE1E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEvD"}

package/dist/shared/log/log-persist-logger.d.ts

@@ -0,0 +1,15 @@
+/** User-facing / lifecycle logs — may be persisted like normal app logs. */
+export declare const LOG_PERSIST_TOPIC = "log-persist";
+/** Operational logs from the persist pipeline — never re-offered to avoid feedback loops. */
+export declare const LOG_PERSIST_INTERNAL_TOPIC = "log-persist-internal";
+export declare function isLogPersistInternalTopic(topic: string | undefined): boolean;
+type PersistLogData = Record<string, unknown>;
+export declare const persistLogger: {
+    debug: (message: string, data?: PersistLogData) => void;
+    info: (message: string, data?: PersistLogData) => void;
+    warn: (message: string, data?: PersistLogData) => void;
+    error: (message: string, data?: PersistLogData) => void;
+};
+export declare function patchPersistLoggerScope(labels: Record<string, string>): void;
+export {};
+//# sourceMappingURL=log-persist-logger.d.ts.map

package/dist/shared/log/log-persist-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-persist-logger.d.ts","sourceRoot":"","sources":["../../../src/shared/log/log-persist-logger.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C,6FAA6F;AAC7F,eAAO,MAAM,0BAA0B,yBAAyB,CAAC;AAIjE,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE5E;AAED,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAS9C,eAAO,MAAM,aAAa;qBACL,MAAM,SAAS,cAAc;oBAC9B,MAAM,SAAS,cAAc;oBAC7B,MAAM,SAAS,cAAc;qBAC5B,MAAM,SAAS,cAAc;CACjD,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAE5E"}

package/dist/shared/log/log-persist-registry.d.ts

@@ -0,0 +1,17 @@
+import type { LogPersistRegistryState } from "./log-persist.interface";
+export declare function defaultLogPersistRegistryPath(registryDir: string): string;
+export declare function registerLogPersistProcess(input: {
+    registryFilePath: string;
+    service: string;
+    process: string;
+}): Promise<void>;
+export declare function heartbeatLogPersistProcess(input: {
+    registryFilePath: string;
+    process: string;
+}): Promise<void>;
+export declare function unregisterLogPersistProcess(input: {
+    registryFilePath: string;
+    process: string;
+}): Promise<void>;
+export declare function readLogPersistRegistry(registryFilePath: string): Promise<LogPersistRegistryState>;
+//# sourceMappingURL=log-persist-registry.d.ts.map

package/dist/shared/log/log-persist-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-persist-registry.d.ts","sourceRoot":"","sources":["../../../src/shared/log/log-persist-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA2B,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAyBhG,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACnD,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBhB;AAED,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBpH;AAED,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBrH;AAED,wBAAsB,sBAAsB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAEvG"}

package/dist/shared/log/log-persist.config.d.ts

@@ -0,0 +1,10 @@
+import type { LogPersistConfig } from "./log-persist.interface";
+export declare const LOG_PERSIST_LOADER_KEY = "LogBatch.0";
+export declare const DEFAULT_LOG_PERSIST_CONFIG: LogPersistConfig;
+export declare function resolveLogPersistConfig(partial?: Partial<LogPersistConfig>): LogPersistConfig;
+export declare function logPersistEnabledFromEnv(env?: NodeJS.ProcessEnv): boolean;
+export declare function logPersistServiceFromEnv(env?: NodeJS.ProcessEnv): string | undefined;
+export declare function logPersistProcessFromEnv(env?: NodeJS.ProcessEnv): string | undefined;
+export declare function logPersistRegistryDirFromEnv(env?: NodeJS.ProcessEnv): string | undefined;
+export declare function logPersistConfigFromEnv(env?: NodeJS.ProcessEnv): LogPersistConfig;
+//# sourceMappingURL=log-persist.config.d.ts.map

package/dist/shared/log/log-persist.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-persist.config.d.ts","sourceRoot":"","sources":["../../../src/shared/log/log-persist.config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD,eAAO,MAAM,0BAA0B,EAAE,gBAkBxC,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAS7F;AAED,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEtF;AAED,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,SAAS,CAGjG;AAED,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,SAAS,CAGjG;AAED,wBAAgB,4BAA4B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,SAAS,CAOrG;AAED,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,gBAAgB,CAqC9F"}

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

@@ -0,0 +1,55 @@
+import { type LogEntry } from "./log-manager";
+import type { EnableLogPersistOptions, LogPersistStats } from "./log-persist.interface";
+declare class LogPersist {
+    private static instance;
+    private enabled;
+    private draining;
+    private service;
+    private processName;
+    private registryFilePath;
+    private config;
+    private fastQueue;
+    private fastRetryQueue;
+    private mediumQueue;
+    private slowQueue;
+    private mediumDebounceTimer;
+    private slowQueueStartedAt;
+    private fastRetryTimer;
+    private heartbeatTimer;
+    private lastHeartbeatAt;
+    private laneFlushing;
+    private consecutiveFailures;
+    private lastFlushAt;
+    private lastError;
+    private lastErrorAt;
+    private shutdownHookInstalled;
+    private shutdownPromise;
+    static getInstance(): LogPersist;
+    enable(options: EnableLogPersistOptions): Promise<void>;
+    disable(): Promise<void>;
+    offer(entry: LogEntry): void;
+    getStats(): LogPersistStats;
+    shutdown(): Promise<void>;
+    private shutdownInner;
+    private hasQueued;
+    private drainQueues;
+    private recordLaneError;
+    private recordLaneSuccess;
+    private queueSnapshot;
+    private installShutdownHook;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private touchRegistryHeartbeat;
+    private scheduleMediumFlush;
+    private cancelMediumDebounce;
+    private scheduleSlowFlush;
+    private evictFastOverflow;
+    private evictMediumOverflow;
+    private evictSlowOverflow;
+    private flushFast;
+    private scheduleFastRetry;
+    private flushMedium;
+    private flushSlow;
+}
+export { LogPersist };
+//# sourceMappingURL=log-persist.d.ts.map

package/dist/shared/log/log-persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-persist.d.ts","sourceRoot":"","sources":["../../../src/shared/log/log-persist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,eAAe,CAAC;AAExD,OAAO,KAAK,EACR,uBAAuB,EAGvB,eAAe,EAClB,MAAM,yBAAyB,CAAC;AAoBjC,cAAM,UAAU;IACZ,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAElD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,MAAM,CAAgD;IAE9D,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,SAAS,CAAkB;IAEnC,OAAO,CAAC,mBAAmB,CAA8C;IACzE,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,eAAe,CAAK;IAE5B,OAAO,CAAC,YAAY,CAIlB;IAEF,OAAO,CAAC,mBAAmB,CAIzB;IAEF,OAAO,CAAC,WAAW,CAIjB;IAEF,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,eAAe,CAA8B;IAErD,MAAM,CAAC,WAAW,IAAI,UAAU;IAK1B,MAAM,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDvD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAa9B,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAmC5B,QAAQ,IAAI,eAAe;IA4BrB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YASjB,aAAa;IAqC3B,OAAO,CAAC,SAAS;YASH,WAAW;IASzB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,aAAa;YAOP,sBAAsB;IAepC,OAAO,CAAC,mBAAmB;IA+B3B,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,mBAAmB;IAuB3B,OAAO,CAAC,iBAAiB;YA0BX,SAAS;IAkEvB,OAAO,CAAC,iBAAiB;YAaX,WAAW;YA0EX,SAAS;CA6E1B;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/shared/log/log-persist.interface.d.ts

@@ -0,0 +1,116 @@
+import type { TargetDraft } from "../../core.interface";
+import type { List } from "../../list/list.interface";
+import type { LogEntry } from "./log-manager";
+/** Persistence lane — maps to List tagList and flush policy. */
+export type LogPersistLane = "fast" | "medium" | "slow";
+export interface LogPersistFastConfig {
+    maxBufferEntries: number;
+}
+export interface LogPersistMediumConfig {
+    debounceMs: number;
+    maxEntries: number;
+    maxBytes: number;
+    maxBufferEntries: number;
+}
+export interface LogPersistSlowConfig {
+    maxEntries: number;
+    maxBytes: number;
+    maxAgeMs: number;
+    maxBufferEntries: number;
+}
+export interface LogPersistConfig {
+    fast: LogPersistFastConfig;
+    medium: LogPersistMediumConfig;
+    slow: LogPersistSlowConfig;
+    /** postListCreate / network ceiling per batch */
+    postTimeoutMs: number;
+    /** Graceful shutdown drain ceiling */
+    shutdownDrainTimeoutMs: number;
+}
+export interface EnableLogPersistOptions {
+    service: string;
+    process: string;
+    /** Shared registry file — all processes of one service use the same path. */
+    registryFilePath?: string;
+    config?: Partial<LogPersistConfig>;
+}
+export interface EnsureLogPersistFromEnvOptions {
+    /** Overrides LOG_PERSIST_PROCESS when set. */
+    process?: string;
+    /** Overrides LOG_PERSIST_SERVICE when set. */
+    service?: string;
+    registryFilePath?: string;
+    config?: Partial<LogPersistConfig>;
+}
+export interface LogPersistProcessRecord {
+    pid: number;
+    enabledAt: string;
+    lastHeartbeatAt: string;
+}
+export interface LogPersistRegistryState {
+    updatedAt: string;
+    service: string;
+    processes: Record<string, LogPersistProcessRecord>;
+}
+export interface LogPersistQueueStats {
+    fast: number;
+    fastRetry: number;
+    medium: number;
+    slow: number;
+}
+export interface LogPersistQueueBytesStats {
+    fast: number;
+    fastRetry: number;
+    medium: number;
+    slow: number;
+}
+export interface LogPersistStats {
+    enabled: boolean;
+    draining: boolean;
+    service: string | null;
+    process: string | null;
+    queues: LogPersistQueueStats;
+    queueBytes: LogPersistQueueBytesStats;
+    mediumDebouncePending: boolean;
+    laneFlushing: Record<LogPersistLane, boolean>;
+    consecutiveFailures: Record<LogPersistLane, number>;
+    config: LogPersistConfig;
+    lastFlushAt: Record<LogPersistLane, string | null>;
+    lastError: string | null;
+    lastErrorAt: string | null;
+}
+export interface WaitForLogPersistReadyOptions {
+    registryFilePath: string;
+    service: string;
+    expectedProcesses: string[];
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    /** Process heartbeat older than this is treated as missing. */
+    staleMs?: number;
+}
+export interface LogPersistReadySnapshot {
+    ok: boolean;
+    missing: string[];
+    stale: string[];
+    registered: string[];
+}
+export interface LogBatchMeta {
+    service: string;
+    process: string;
+    pid: number;
+    lane: LogPersistLane;
+    count: number;
+    from: number | null;
+    to: number | null;
+    flushedAt: number;
+    idempotencyKey: string;
+}
+export interface BuildLogListDraftInput {
+    service: string;
+    process: string;
+    lane: LogPersistLane;
+    idempotencyKey: string;
+    entries: LogEntry[];
+}
+export type LogListDraft = TargetDraft<List>;
+//# sourceMappingURL=log-persist.interface.d.ts.map

package/dist/shared/log/log-persist.interface.d.ts.map

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

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

@@ -0,0 +1,56 @@
+/** Logger-bound scope: module + trace chain + optional labels. */
+export interface LogScope {
+    module: string;
+    traceId: string;
+    traceParentId: string | null;
+    labels?: Readonly<Record<string, string>>;
+}
+/** Partial update for {@link patchScope}. */
+export type LogScopePatch = Partial<Omit<LogScope, "labels">> & {
+    labels?: Record<string, string>;
+};
+/** Fields allowed on {@link LoggerWithScope.resetScope} — no trace identity changes. */
+export type LoggerResetScopePatch = {
+    module?: string;
+    labels?: Record<string, string>;
+};
+export type LogScopeInput = LogScopePatch & Pick<LogScope, "module">;
+interface NormalizeScopeOptions {
+    /** When true and traceId is missing, generate a new id. */
+    generateTraceId?: boolean;
+}
+/** Input for {@link patchScope}. */
+export type PatchScopeInput = {
+    scope: LogScope;
+    patch: LogScopePatch;
+    /**
+     * When `false` (default), `patch.traceId` / `patch.traceParentId` are ignored.
+     * New spans: use {@link createScope}.
+     */
+    allowTraceMutation?: boolean;
+};
+/** Coerce partial input into a {@link LogScope}. */
+export declare function normalizeScope(input: LogScopeInput, options?: NormalizeScopeOptions): LogScope;
+/** Input for {@link createScope}. */
+export type CreateScopeInput = {
+    module: string;
+    traceId: string;
+    traceParentId?: string | null;
+    labels?: Record<string, string>;
+    /** When set, default traceParentId to parent.traceId and merge labels. */
+    parent?: LogScope;
+};
+/** Build a scope; optional parent links trace chain and merges labels. */
+export declare function createScope(input: CreateScopeInput): LogScope;
+/** Merge patch into scope (labels deep-merge). Returns a new scope. */
+export declare function patchScope(input: PatchScopeInput): LogScope;
+/** Same trace chain, different module (e.g. prepareTask vs executeTask). */
+export declare function withModule(scope: LogScope, module: string): LogScope;
+export declare function formatScopeLabels(labels?: Readonly<Record<string, string>>): string;
+/** Prefer `data`; fall back to deprecated `context` on log rest params. */
+export declare function resolveLogData(rest?: {
+    data?: unknown;
+    context?: unknown;
+}): unknown | undefined;
+export {};
+//# sourceMappingURL=log-scope.d.ts.map

package/dist/shared/log/log-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-scope.d.ts","sourceRoot":"","sources":["../../../src/shared/log/log-scope.ts"],"names":[],"mappings":"AAEA,kEAAkE;AAClE,MAAM,WAAW,QAAQ;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC7C;AAED,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,wFAAwF;AACxF,MAAM,MAAM,qBAAqB,GAAG;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAErE,UAAU,qBAAqB;IAC3B,2DAA2D;IAC3D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,oCAAoC;AACpC,MAAM,MAAM,eAAe,GAAG;IAC1B,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,aAAa,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAUF,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,QAAQ,CAa9F;AAED,qCAAqC;AACrC,MAAM,MAAM,gBAAgB,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,QAAQ,CAAC;CACrB,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,QAAQ,CAQ7D;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,QAAQ,CAY3D;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAEpE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAOnF;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,GAAG,SAAS,CAQhG"}

package/dist/shared/utils/fetch-url.d.ts

@@ -0,0 +1,3 @@
+export declare function resolveFetchUrl(input: string | URL | Request): string;
+export declare function isHttpUrl(url: string): boolean;
+//# sourceMappingURL=fetch-url.d.ts.map

package/dist/shared/utils/fetch-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-url.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/fetch-url.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,MAAM,CAQrE;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C"}

package/dist/shared/utils/network-error.d.ts

@@ -0,0 +1,14 @@
+export type NetworkErrorKind = "connect_timeout" | "tls_disconnect" | "connection_refused" | "dns_error" | "socket_closed" | "timeout" | "proxy_error" | "unknown";
+export interface ClassifiedNetworkError {
+    kind: NetworkErrorKind;
+    retryable: boolean;
+    code: string;
+    detail: string;
+}
+export declare function classifyNetworkError(error: unknown): ClassifiedNetworkError;
+export interface FormatNetworkErrorOptions {
+    /** Extra hint appended (proxy URL, env var name, etc.). */
+    hint?: string;
+}
+export declare function formatNetworkError(error: unknown, label: string, options?: FormatNetworkErrorOptions): string;
+//# sourceMappingURL=network-error.d.ts.map

package/dist/shared/utils/network-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-error.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/network-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACtB,iBAAiB,GACjB,gBAAgB,GAChB,oBAAoB,GACpB,WAAW,GACX,eAAe,GACf,SAAS,GACT,aAAa,GACb,SAAS,CAAC;AAEhB,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB;AAsBD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAkF3E;AAED,MAAM,WAAW,yBAAyB;IACtC,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,yBAA8B,GAAG,MAAM,CAyBjH"}

package/dist/shared/utils/safe-file-name.d.ts

@@ -0,0 +1,14 @@
+export interface SanitizeFileNameOptions {
+    /** Max length after sanitization (default 200). */
+    maxLength?: number;
+    /** When set, used instead of throwing on invalid names. */
+    fallback?: string;
+}
+/**
+ * Safe display / storage file name from a browser or filesystem path string.
+ * Strips directory segments and forbidden characters.
+ */
+export declare function sanitizeFileName(raw: string, options?: SanitizeFileNameOptions): string;
+/** Parcel.name / value default — 200 char cap. */
+export declare function sanitizeParcelFileName(raw: string): string;
+//# sourceMappingURL=safe-file-name.d.ts.map

package/dist/shared/utils/safe-file-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-file-name.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/safe-file-name.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACpC,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAQD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,MAAM,CAc3F;AAED,kDAAkD;AAClD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/shared/utils/sha256.d.ts

@@ -0,0 +1,3 @@
+/** SHA-256 digest as lowercase hex (browser + Node Web Crypto). */
+export declare function sha256Hex(buffer: ArrayBuffer): Promise<string>;
+//# sourceMappingURL=sha256.d.ts.map

package/dist/shared/utils/sha256.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/sha256.ts"],"names":[],"mappings":"AAOA,mEAAmE;AACnE,wBAAsB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAMpE"}

package/dist/supabase.d.ts

@@ -1,11 +1,11 @@
-import { SupabaseClient } from "@supabase/supabase-js";
+import { type SupabaseClient } from "@supabase/supabase-js";
 export interface SupabaseInitializerParams {
     supabaseUrl: string;
     supabaseAnonKey: string;
     supabaseNeedAuthUrl?: string;
     supabaseNeedAuthAnonKey?: string;
 }
-export declare class SupabaseInitializer {
+declare class SupabaseInitializer {
     private static instance;
     private isInitialized;
     private _mainClient;
@@ -29,4 +29,9 @@ export declare class SupabaseInitializer {
     get authClient(): SupabaseClient | null;
     reset(): void;
 }
+/** Process-wide holder — import this; class is module-private. */
+export declare const supabase: SupabaseInitializer;
+/** Public type for the `supabase` holder instance. */
+export type SupabaseHolder = typeof supabase;
+export {};
 //# sourceMappingURL=supabase.d.ts.map

package/dist/supabase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../src/supabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAcrE,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAC7C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,WAAW,CAA+B;IAElD,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,mBAAmB;IAOzC;;OAEG;IACG,UAAU,CACd,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC;QAAE,QAAQ,EAAE,cAAc,CAAC;QAAC,YAAY,EAAE,cAAc,GAAG,IAAI,CAAA;KAAE,CAAC;IAwC7E,OAAO,CAAC,4BAA4B;IAqBpC,OAAO,CAAC,gBAAgB;IAWxB,UAAU;;;;IAOV,IAAI,MAAM,IAAI,cAAc,CAQ3B;IAED,IAAI,UAAU,IAAI,cAAc,GAAG,IAAI,CAKtC;IAED,KAAK;CAKN"}
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../src/supabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAc1E,MAAM,WAAW,yBAAyB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uBAAuB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,cAAM,mBAAmB;IACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAC7C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,WAAW,CAA+B;IAElD,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,mBAAmB;IAOzC;;OAEG;IACG,UAAU,CACZ,MAAM,EAAE,yBAAyB,GAClC,OAAO,CAAC;QAAE,QAAQ,EAAE,cAAc,CAAC;QAAC,YAAY,EAAE,cAAc,GAAG,IAAI,CAAA;KAAE,CAAC;IAwC7E,OAAO,CAAC,4BAA4B;IAqBpC,OAAO,CAAC,gBAAgB;IAWxB,UAAU;;;;IAOV,IAAI,MAAM,IAAI,cAAc,CAQ3B;IAED,IAAI,UAAU,IAAI,cAAc,GAAG,IAAI,CAKtC;IAED,KAAK;CAKR;AAED,kEAAkE;AAClE,eAAO,MAAM,QAAQ,qBAAoC,CAAC;AAE1D,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG,OAAO,QAAQ,CAAC"}

package/dist/task/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Task domain public API — curated re-exports only.
+ * Internal modules (local-task-registry, task-repo-context, task.utils) stay private.
+ */
+export type { PatchChangeTaskStatusPayload, PatchClaimTaskPayload, PatchTaskProgressPayload, } from "./task.api";
+export { patchChangeTaskStatus, patchChangeTaskStatusSchema, patchClaimTask, patchClaimTaskSchema, patchTaskProgress, patchTaskProgressSchema, } from "./task.api";
+export type { Task, TaskDetails, TaskFlow } from "./task.interface";
+export { CategoryTask, ResultCode, TaskStatus, TaskStatusAction, } from "./task.interface";
+export type { PrepareTaskParams, PrepareTaskResponse, RegisterTasksOptions, RegisterTasksResult, } from "./task-manager";
+export { TaskManager } from "./task-manager";
+export type { PostTaskPayload } from "./task-post.api";
+export { postTask, postTaskSchema } from "./task-post.api";
+export { postTaskWithValidation } from "./task-post-validated.api";
+export type { TaskRepoValidationFailureReason, ValidateTaskRepoAndParamsInput, ValidateTaskRepoAndParamsResult, } from "./task-repo-validation";
+export { TaskRepoValidation } from "./task-repo-validation";
+//# sourceMappingURL=index.d.ts.map

package/dist/task/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACR,4BAA4B,EAC5B,qBAAqB,EACrB,wBAAwB,GAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACH,qBAAqB,EACrB,2BAA2B,EAC3B,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,GAC1B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEpE,OAAO,EACH,YAAY,EACZ,UAAU,EACV,UAAU,EACV,gBAAgB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACR,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,YAAY,EACR,+BAA+B,EAC/B,8BAA8B,EAC9B,+BAA+B,GAClC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}