target-supabase-sdk 0.2.11 → 0.2.13

package/src/shared/log/log-persist.config.ts

@@ -1,115 +0,0 @@
-import { envBool, envInt, envMs } from "../../node/env/env-parsers";
-import type { LogPersistConfig } from "./log-persist.interface";
-
-export const DEFAULT_LOG_PERSIST_CONFIG: LogPersistConfig = {
-    fast: {
-        maxBufferEntries: 500,
-    },
-    medium: {
-        debounceMs: 5_000,
-        maxEntries: 20,
-        maxBytes: 512 * 1024,
-        maxBufferEntries: 1_000,
-    },
-    slow: {
-        maxEntries: 400,
-        maxBytes: 512 * 1024,
-        maxAgeMs: 120_000,
-        maxBufferEntries: 2_000,
-    },
-    postTimeoutMs: 30_000,
-    shutdownDrainTimeoutMs: 15_000,
-    laneRetryIntervalMs: 5_000,
-    errorLogRateLimitMs: 5_000,
-    circuitBreakerPermanentFailureThreshold: 3,
-};
-
-export function resolveLogPersistConfig(partial?: Partial<LogPersistConfig>): LogPersistConfig {
-    const defaults = DEFAULT_LOG_PERSIST_CONFIG;
-    return {
-        fast: { ...defaults.fast, ...partial?.fast },
-        medium: { ...defaults.medium, ...partial?.medium },
-        slow: { ...defaults.slow, ...partial?.slow },
-        postTimeoutMs: partial?.postTimeoutMs ?? defaults.postTimeoutMs,
-        shutdownDrainTimeoutMs: partial?.shutdownDrainTimeoutMs ?? defaults.shutdownDrainTimeoutMs,
-        laneRetryIntervalMs: partial?.laneRetryIntervalMs ?? defaults.laneRetryIntervalMs,
-        errorLogRateLimitMs: partial?.errorLogRateLimitMs ?? defaults.errorLogRateLimitMs,
-        circuitBreakerPermanentFailureThreshold:
-            partial?.circuitBreakerPermanentFailureThreshold ?? defaults.circuitBreakerPermanentFailureThreshold,
-    };
-}
-
-export function logPersistEnabledFromEnv(env: NodeJS.ProcessEnv = process.env): boolean {
-    return envBool("LOG_PERSIST_ENABLED", false, env);
-}
-
-export function logPersistServiceFromEnv(env: NodeJS.ProcessEnv = process.env): string | undefined {
-    const raw = env.LOG_PERSIST_SERVICE?.trim();
-    return raw != null && raw !== "" ? raw : undefined;
-}
-
-export function logPersistProcessFromEnv(env: NodeJS.ProcessEnv = process.env): string | undefined {
-    const raw = env.LOG_PERSIST_PROCESS?.trim();
-    return raw != null && raw !== "" ? raw : undefined;
-}
-
-export function logPersistRegistryDirFromEnv(env: NodeJS.ProcessEnv = process.env): string | undefined {
-    const configured = env.LOG_PERSIST_REGISTRY_DIR?.trim();
-    if (configured != null && configured !== "") {
-        return configured;
-    }
-    const runtime = env.RUNTIME_DATA_DIR?.trim();
-    return runtime != null && runtime !== "" ? runtime : undefined;
-}
-
-export function logPersistConfigFromEnv(env: NodeJS.ProcessEnv = process.env): LogPersistConfig {
-    return resolveLogPersistConfig({
-        fast: {
-            maxBufferEntries: envInt("LOG_FAST_MAX_BUFFER_ENTRIES", DEFAULT_LOG_PERSIST_CONFIG.fast.maxBufferEntries, {
-                env,
-                min: 1,
-            }),
-        },
-        medium: {
-            debounceMs: envMs("LOG_MEDIUM_DEBOUNCE_MS", DEFAULT_LOG_PERSIST_CONFIG.medium.debounceMs, { env }),
-            maxEntries: envInt("LOG_MEDIUM_MAX_ENTRIES", DEFAULT_LOG_PERSIST_CONFIG.medium.maxEntries, {
-                env,
-                min: 1,
-            }),
-            maxBytes: envInt("LOG_MEDIUM_MAX_BYTES", DEFAULT_LOG_PERSIST_CONFIG.medium.maxBytes, { env, min: 1 }),
-            maxBufferEntries: envInt(
-                "LOG_MEDIUM_MAX_BUFFER_ENTRIES",
-                DEFAULT_LOG_PERSIST_CONFIG.medium.maxBufferEntries,
-                { env, min: 1 },
-            ),
-        },
-        slow: {
-            maxEntries: envInt("LOG_SLOW_MAX_ENTRIES", DEFAULT_LOG_PERSIST_CONFIG.slow.maxEntries, { env, min: 1 }),
-            maxBytes: envInt("LOG_SLOW_MAX_BYTES", DEFAULT_LOG_PERSIST_CONFIG.slow.maxBytes, { env, min: 1 }),
-            maxAgeMs: envMs("LOG_SLOW_MAX_AGE_MS", DEFAULT_LOG_PERSIST_CONFIG.slow.maxAgeMs, { env }),
-            maxBufferEntries: envInt("LOG_SLOW_MAX_BUFFER_ENTRIES", DEFAULT_LOG_PERSIST_CONFIG.slow.maxBufferEntries, {
-                env,
-                min: 1,
-            }),
-        },
-        postTimeoutMs: envMs("LOG_PERSIST_POST_TIMEOUT_MS", DEFAULT_LOG_PERSIST_CONFIG.postTimeoutMs, { env }),
-        shutdownDrainTimeoutMs: envMs(
-            "LOG_PERSIST_SHUTDOWN_DRAIN_MS",
-            DEFAULT_LOG_PERSIST_CONFIG.shutdownDrainTimeoutMs,
-            { env },
-        ),
-        laneRetryIntervalMs: envMs("LOG_PERSIST_LANE_RETRY_MS", DEFAULT_LOG_PERSIST_CONFIG.laneRetryIntervalMs, {
-            env,
-        }),
-        errorLogRateLimitMs: envMs(
-            "LOG_PERSIST_ERROR_LOG_RATE_LIMIT_MS",
-            DEFAULT_LOG_PERSIST_CONFIG.errorLogRateLimitMs,
-            { env },
-        ),
-        circuitBreakerPermanentFailureThreshold: envInt(
-            "LOG_PERSIST_CIRCUIT_BREAKER_THRESHOLD",
-            DEFAULT_LOG_PERSIST_CONFIG.circuitBreakerPermanentFailureThreshold,
-            { env, min: 1 },
-        ),
-    });
-}

package/src/shared/log/log-persist.interface.ts

@@ -1,150 +0,0 @@
-import type { TargetDraft } from "../../core.interface";
-import type { List } from "../../list/list.interface";
-import type { LogEntry } from "./log-manager";
-
-/**
- * `ListDetails.loaderKey` stamped on every persisted log batch (write + read side).
- * Business type: **LogBatch** (transport flush). Pairs with log-service **LogTrace**
- * (`LogTrace.0`) after rekeying by `traceId`.
- */
-export const LOG_PERSIST_LOADER_KEY = "LogBatch.0";
-
-/** Alias for {@link LOG_PERSIST_LOADER_KEY} — preferred when contrasting with LogTrace. */
-export const LOG_BATCH_LOADER_KEY = LOG_PERSIST_LOADER_KEY;
-
-/** 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;
-    /** Delay before medium/slow lane flush retries after failure (fast lane uses the same interval). */
-    laneRetryIntervalMs: number;
-    /** Suppress duplicate persistLogger warn/error lines with the same message within this window. */
-    errorLogRateLimitMs: number;
-    /** Disable log-persist after this many consecutive permanent flush errors. */
-    circuitBreakerPermanentFailureThreshold: number;
-}
-
-export interface EnableLogPersistOptions {
-    service: string;
-    process: string;
-    /** Shared registry root directory — all processes use the same path; each writes its own shard file. */
-    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;
-    circuitBreakerTripped: boolean;
-    permanentFailureCount: number;
-    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>;