@tiangong-lca/cli 0.1.1 → 0.1.2

package/dist/src/lib/publish.d.ts

@@ -0,0 +1,219 @@
+import type { FetchLike } from './http.js';
+import { type LifecyclemodelPublishMetadata } from './lifecyclemodel-bundle-save.js';
+import { type ProcessPayloadValidationResult } from './process-payload-validation.js';
+type JsonObject = Record<string, unknown>;
+export type PublishDatasetEntry = string | {
+    file?: string;
+    path?: string;
+    json_ordered?: JsonObject;
+    jsonOrdered?: JsonObject;
+    payload?: JsonObject;
+    [key: string]: unknown;
+};
+export type PublishProcessBuildRunEntry = string | {
+    run_id?: string;
+    run_root?: string;
+    exports_dir?: string;
+    [key: string]: unknown;
+};
+export type PublishCollectedOrigin = {
+    source: 'bundle' | 'input';
+    base_dir: string;
+    bundle_path: string | null;
+};
+export type PublishCollectedDatasetEntry = {
+    entry: PublishDatasetEntry;
+    origin: PublishCollectedOrigin;
+};
+export type PublishCollectedProcessBuildRunEntry = {
+    entry: PublishProcessBuildRunEntry;
+    origin: PublishCollectedOrigin;
+};
+export type PublishCollectedRelationEntry = {
+    entry: unknown;
+    origin: PublishCollectedOrigin;
+};
+export type PublishRequest = {
+    inputs: {
+        bundle_paths: string[];
+        lifecyclemodels: PublishDatasetEntry[];
+        processes: PublishDatasetEntry[];
+        sources: PublishDatasetEntry[];
+        relations: unknown[];
+        process_build_runs: PublishProcessBuildRunEntry[];
+    };
+    publish: {
+        commit: boolean;
+        publish_lifecyclemodels: boolean;
+        publish_processes: boolean;
+        publish_sources: boolean;
+        publish_relations: boolean;
+        publish_process_build_runs: boolean;
+        relation_mode: 'local_manifest_only';
+        max_attempts: number;
+        retry_delay_seconds: number;
+        process_build_forward_args: string[];
+    };
+    out_dir: string;
+};
+export type PublishCollectedInputs = {
+    bundle_paths: string[];
+    lifecyclemodels: PublishCollectedDatasetEntry[];
+    processes: PublishCollectedDatasetEntry[];
+    sources: PublishCollectedDatasetEntry[];
+    relations: PublishCollectedRelationEntry[];
+    process_build_runs: PublishCollectedProcessBuildRunEntry[];
+};
+export type DatasetPublishExecutorArgs = {
+    table: 'lifecyclemodels' | 'processes' | 'sources';
+    id: string;
+    version: string;
+    payload: JsonObject;
+    metadata?: LifecyclemodelPublishMetadata | null;
+    source: 'bundle' | 'input';
+    bundle_path: string | null;
+    publish: PublishRequest['publish'];
+};
+export type ProcessBuildRunPublishExecutorArgs = {
+    run_id: string;
+    entry: PublishProcessBuildRunEntry;
+    source: 'bundle' | 'input';
+    bundle_path: string | null;
+    forward_args: string[];
+    publish: PublishRequest['publish'];
+};
+export type PublishExecutors = {
+    lifecyclemodels?: (args: DatasetPublishExecutorArgs) => Promise<unknown> | unknown;
+    processes?: (args: DatasetPublishExecutorArgs) => Promise<unknown> | unknown;
+    sources?: (args: DatasetPublishExecutorArgs) => Promise<unknown> | unknown;
+    process_build_runs?: (args: ProcessBuildRunPublishExecutorArgs) => Promise<unknown> | unknown;
+};
+export type PublishDatasetReport = {
+    table: 'lifecyclemodels' | 'processes' | 'sources';
+    id: string | null;
+    version: string | null;
+    status: 'prepared' | 'executed' | 'deferred_no_executor' | 'deferred_projection_payload' | 'failed';
+    source: 'bundle' | 'input';
+    bundle_path: string | null;
+    reason?: string;
+    validation?: ProcessPayloadValidationResult;
+    execution?: unknown;
+    error?: {
+        message: string;
+    };
+};
+export type PublishProcessBuildRunReport = {
+    run_id: string;
+    status: 'prepared' | 'executed' | 'deferred_no_executor' | 'failed';
+    source: 'bundle' | 'input';
+    bundle_path: string | null;
+    forward_args: string[];
+    execution?: unknown;
+    error?: {
+        message: string;
+    };
+};
+export type PublishRelationManifest = {
+    generated_at_utc: string;
+    relation_mode: 'local_manifest_only';
+    status: 'prepared_local_relation_manifest';
+    relations: unknown[];
+};
+export type PublishVerificationFinding = {
+    code: string;
+    severity: 'warning' | 'blocker';
+    message: string;
+    table: 'lifecyclemodels' | 'processes' | 'sources' | 'process_build_runs';
+    id: string | null;
+    version: string | null;
+    path?: string;
+    bundle_path?: string | null;
+};
+export type PublishVerificationReport = {
+    schema_version: 1;
+    generated_at_utc: string;
+    command: 'publish run';
+    status: 'passed' | 'blocked';
+    ruleset_id: string;
+    ruleset_version: string;
+    ruleset_source_version: string;
+    ruleset_rule_ids: string[];
+    commit: boolean;
+    findings: PublishVerificationFinding[];
+    blockers: PublishVerificationFinding[];
+    next_action: 'ready_for_commit_or_publish' | 'fix_blockers';
+    counts: {
+        findings: number;
+        blockers: number;
+        failed: number;
+        deferred: number;
+        executed: number;
+    };
+};
+export type PublishReport = {
+    generated_at_utc: string;
+    request_path: string;
+    out_dir: string;
+    commit: boolean;
+    status: 'completed' | 'completed_with_failures';
+    counts: {
+        bundle_paths: number;
+        lifecyclemodels: number;
+        processes: number;
+        sources: number;
+        relations: number;
+        process_build_runs: number;
+        executed: number;
+        deferred: number;
+        failed: number;
+    };
+    files: {
+        normalized_request: string;
+        collected_inputs: string;
+        relation_manifest: string;
+        verification_report: string;
+        publish_report: string;
+    };
+    verification: PublishVerificationReport;
+    lifecyclemodels: PublishDatasetReport[];
+    processes: PublishDatasetReport[];
+    sources: PublishDatasetReport[];
+    process_build_runs: PublishProcessBuildRunReport[];
+    relations: PublishRelationManifest;
+};
+export type RunPublishOptions = {
+    inputPath: string;
+    rawRequest?: unknown;
+    outDir?: string | null;
+    commit?: boolean | null;
+    executors?: PublishExecutors;
+    env?: NodeJS.ProcessEnv;
+    fetchImpl?: FetchLike;
+    timeoutMs?: number;
+    now?: Date;
+    validateProcessPayloadImpl?: (payload: JsonObject) => ProcessPayloadValidationResult;
+};
+type NormalizePublishRequestOptions = {
+    requestPath: string;
+    outDirOverride?: string;
+    commitOverride?: boolean;
+    now?: Date;
+};
+export declare function normalizePublishRequest(raw: unknown, options: NormalizePublishRequestOptions): PublishRequest;
+export declare function collectPublishInputs(normalized: PublishRequest, requestBaseDir: string): PublishCollectedInputs;
+declare function build_publish_verification_report(options: {
+    now: Date;
+    commit: boolean;
+    failed: number;
+    deferred: number;
+    executed: number;
+    lifecyclemodels: PublishDatasetReport[];
+    processes: PublishDatasetReport[];
+    sources: PublishDatasetReport[];
+    processBuildRuns: PublishProcessBuildRunReport[];
+}): PublishVerificationReport;
+export declare function runPublish(options: RunPublishOptions): Promise<PublishReport>;
+export declare const __testInternals: {
+    build_publish_verification_report: typeof build_publish_verification_report;
+};
+export {};

package/dist/src/lib/remote.d.ts

@@ -0,0 +1,19 @@
+import type { FetchLike } from './http.js';
+type RemoteCommandSpec = {
+    endpoint: string;
+    includeRegion: boolean;
+    help: string;
+};
+declare const REMOTE_COMMANDS: Record<string, RemoteCommandSpec>;
+export type RemoteCommandOptions = {
+    commandKey: keyof typeof REMOTE_COMMANDS;
+    inputPath: string;
+    env: NodeJS.ProcessEnv;
+    timeoutMs: number;
+    dryRun: boolean;
+    compactJson: boolean;
+    fetchImpl: FetchLike;
+};
+export declare function executeRemoteCommand(options: RemoteCommandOptions): Promise<string>;
+export declare function getRemoteCommandHelp(commandKey: keyof typeof REMOTE_COMMANDS): string;
+export {};

package/dist/src/lib/run.d.ts

@@ -0,0 +1,60 @@
+export type RunLayout = {
+    namespace: string;
+    runId: string;
+    artifactsRoot: string;
+    collectionDir: string;
+    runRoot: string;
+    cacheDir: string;
+    inputsDir: string;
+    outputsDir: string;
+    reportsDir: string;
+    logsDir: string;
+    manifestsDir: string;
+    latestRunIdPath: string;
+};
+export type RunManifest = {
+    schemaVersion: 1;
+    namespace: string;
+    runId: string;
+    command: string[];
+    cwd: string;
+    createdAt: string;
+    layout: Omit<RunLayout, 'namespace' | 'runId'>;
+};
+export type ResumeMetadata = {
+    runId: string;
+    resumedFrom: string;
+    checkpoint: string | null;
+    attempt: number;
+    resumedAt: string;
+};
+type BuildRunIdOptions = {
+    namespace: string;
+    subject?: string;
+    operation?: string;
+    now?: Date;
+    suffix?: string;
+};
+type BuildRunManifestOptions = {
+    layout: RunLayout;
+    command: string[];
+    cwd?: string;
+    createdAt?: Date;
+};
+type BuildResumeMetadataOptions = {
+    runId: string;
+    resumedFrom: string;
+    checkpoint?: string | null;
+    attempt?: number;
+    resumedAt?: Date;
+};
+export declare function sanitizeRunToken(value: string, fallback?: string): string;
+export declare function buildUtcTimestamp(now?: Date): string;
+export declare function buildRunId(options: BuildRunIdOptions): string;
+export declare function resolveRunLayout(artifactsRoot: string, namespace: string, runId: string): RunLayout;
+export declare function ensureRunLayout(layout: RunLayout): RunLayout;
+export declare function writeLatestRunId(layout: RunLayout, runId?: string): string;
+export declare function readLatestRunId(collectionDir: string): string | null;
+export declare function buildRunManifest(options: BuildRunManifestOptions): RunManifest;
+export declare function buildResumeMetadata(options: BuildResumeMetadataOptions): ResumeMetadata;
+export {};

package/dist/src/lib/runtime-rulesets.d.ts

@@ -0,0 +1,29 @@
+export type RuntimeDatasetType = 'process' | 'flow' | 'publish';
+export type RuntimeRuleSeverity = 'info' | 'warning' | 'blocker';
+export type RuntimeRulesetPhase = 'authoring' | 'repair' | 'publish' | 'identity' | 'verification';
+export type RuntimeRulesetId = 'process-authoring/strict' | 'process-authoring/repair' | 'process-publish/default' | 'process-dedup/default' | 'flow-authoring/strict' | 'flow-publish/default' | 'flow-dedup/default' | 'publish-run/default';
+export type RuntimeRule = {
+    id: string;
+    dataset_type: RuntimeDatasetType;
+    severity: RuntimeRuleSeverity;
+    default_blocker: boolean;
+    phases: string[];
+};
+export type RuntimeRuleset = {
+    id: RuntimeRulesetId;
+    version: '1';
+    source_version: typeof RUNTIME_RULESET_SOURCE_VERSION;
+    dataset_type: RuntimeDatasetType;
+    phase: RuntimeRulesetPhase;
+    rule_ids: string[];
+};
+export declare const RUNTIME_RULESET_SOURCE_VERSION = "2026.05.23";
+export declare const RUNTIME_RULESET_VERSION = "1";
+export declare function listRuntimeRulesets(): RuntimeRuleset[];
+export declare function getRuntimeRuleset<T extends RuntimeRulesetId>(id: T): RuntimeRuleset & {
+    id: T;
+};
+export declare function getRuntimeRule(id: string): RuntimeRule | null;
+export declare function runtimeRuleIds(id: RuntimeRulesetId): string[];
+export declare function resolveRuntimeRuleId(rulesetId: RuntimeRulesetId, localRuleId: string | null | undefined): string | null;
+export declare function isRuntimeRuleBlocker(ruleId: string | null | undefined): boolean;

package/dist/src/lib/state-lock.d.ts

@@ -0,0 +1,25 @@
+import { CliError } from './errors.js';
+export type StateLockMetadata = {
+    ownerPid: number;
+    ownerHost: string;
+    reason: string;
+    updatedAt: string;
+};
+export type StateLockOptions = {
+    reason: string;
+    metadata?: Record<string, string | number | boolean | null>;
+    stalePolicy?: 'local-pid' | 'same-host-pid' | 'never';
+    timeoutMs?: number;
+    pollMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+    pid?: number;
+    host?: string;
+    now?: Date;
+};
+export declare class StateLockTimeoutError extends CliError {
+    constructor(lockPath: string, reason: string, waitedMs: number, owner: Record<string, unknown> | null);
+}
+export declare function lockPathForState(statePath: string): string;
+export declare function readStateLockMetadata(lockPath: string): Record<string, unknown> | null;
+export declare function isProcessAlive(pid: number): boolean;
+export declare function withStateFileLock<T>(statePath: string, options: StateLockOptions, task: () => Promise<T> | T): Promise<T>;

package/dist/src/lib/state-lock.js

@@ -5,6 +5,7 @@ import { CliError } from './errors.js';
 const LOCAL_LOCK_OWNERS = new Map();
 const DEFAULT_TIMEOUT_MS = 300_000;
 const DEFAULT_POLL_MS = 200;
+const MAX_NODE_TIMER_DELAY_MS = 2_147_483_647;
 function sleepMs(ms) {
     return new Promise((resolve) => {
         setTimeout(resolve, ms);
@@ -17,6 +18,19 @@ function isErrnoException(error, code) {
         error.code === code);
 }
 function normalizeLockTimings(options) {
+    for (const [label, value] of [
+        ['timeoutMs', options.timeoutMs],
+        ['pollMs', options.pollMs],
+    ]) {
+        if (value === undefined)
+            continue;
+        if (!Number.isSafeInteger(value)) {
+            throw new RangeError(`State lock ${label} must be a finite safe integer.`);
+        }
+        if (value > MAX_NODE_TIMER_DELAY_MS) {
+            throw new RangeError(`State lock ${label} exceeds the maximum supported timer delay (${MAX_NODE_TIMER_DELAY_MS} ms).`);
+        }
+    }
     return {
         timeoutMs: Math.max(options.timeoutMs ?? DEFAULT_TIMEOUT_MS, 0),
         pollMs: Math.max(options.pollMs ?? DEFAULT_POLL_MS, 10),
@@ -96,6 +110,7 @@ export async function withStateFileLock(statePath, options, task) {
         try {
             const fileDescriptor = openSync(lockPath, 'wx');
             const metadata = {
+                ...options.metadata,
                 ownerPid: options.pid ?? process.pid,
                 ownerHost: options.host ?? os.hostname(),
                 reason: options.reason,
@@ -128,7 +143,14 @@ export async function withStateFileLock(statePath, options, task) {
             }
             const metadata = readStateLockMetadata(lockPath);
             const ownerPid = metadata?.ownerPid;
-            if (typeof ownerPid === 'number' && !isProcessAlive(ownerPid)) {
+            const stalePolicy = options.stalePolicy ?? 'local-pid';
+            const ownerHost = metadata?.ownerHost;
+            const currentHost = options.host ?? os.hostname();
+            const staleOwner = stalePolicy !== 'never' &&
+                typeof ownerPid === 'number' &&
+                !isProcessAlive(ownerPid) &&
+                (stalePolicy === 'local-pid' || ownerHost === currentHost);
+            if (staleOwner) {
                 try {
                     unlinkSync(lockPath);
                     continue;

package/dist/src/lib/state-lock.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-lock.js","sourceRoot":"","sources":["../../../src/lib/state-lock.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  closeSync,\n  existsSync,\n  mkdirSync,\n  openSync,\n  readFileSync,\n  unlinkSync,\n  writeFileSync,\n} from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { CliError } from './errors.js';\n\nexport type StateLockMetadata = {\n  ownerPid: number;\n  ownerHost: string;\n  reason: string;\n  updatedAt: string;\n};\n\nexport type StateLockOptions = {\n  reason: string;\n  timeoutMs?: number;\n  pollMs?: number;\n  sleep?: (ms: number) => Promise<void>;\n  pid?: number;\n  host?: string;\n  now?: Date;\n};\n\ntype LocalLockOwner = {\n  depth: number;\n  fd: number;\n};\n\nconst LOCAL_LOCK_OWNERS = new Map<string, LocalLockOwner>();\nconst DEFAULT_TIMEOUT_MS = 300_000;\nconst DEFAULT_POLL_MS = 200;\n\nfunction sleepMs(ms: number): Promise<void> {\n  return new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n}\n\nfunction isErrnoException(error: unknown, code: string): boolean {\n  return Boolean(\n    error &&\n    typeof error === 'object' &&\n    'code' in error &&\n    (error as NodeJS.ErrnoException).code === code,\n  );\n}\n\nfunction normalizeLockTimings(options: StateLockOptions): { timeoutMs: number; pollMs: number } {\n  return {\n    timeoutMs: Math.max(options.timeoutMs ?? DEFAULT_TIMEOUT_MS, 0),\n    pollMs: Math.max(options.pollMs ?? DEFAULT_POLL_MS, 10),\n  };\n}\n\nfunction writeLockMetadata(fileDescriptor: number, metadata: StateLockMetadata): void {\n  writeFileSync(fileDescriptor, `${JSON.stringify(metadata, null, 2)}\\n`, 'utf8');\n}\n\nfunction releaseLocalLockOwner(lockKey: string): void {\n  const owner = LOCAL_LOCK_OWNERS.get(lockKey);\n  if (owner && owner.depth > 1) {\n    owner.depth -= 1;\n    return;\n  }\n\n  LOCAL_LOCK_OWNERS.delete(lockKey);\n}\n\nexport class StateLockTimeoutError extends CliError {\n  constructor(\n    lockPath: string,\n    reason: string,\n    waitedMs: number,\n    owner: Record<string, unknown> | null,\n  ) {\n    super(`Timed out after ${waitedMs}ms acquiring state lock: ${lockPath}`, {\n      code: 'STATE_LOCK_TIMEOUT',\n      exitCode: 1,\n      details: {\n        lockPath,\n        reason,\n        waitedMs,\n        owner,\n      },\n    });\n  }\n}\n\nexport function lockPathForState(statePath: string): string {\n  return `${statePath}.lock`;\n}\n\nexport function readStateLockMetadata(lockPath: string): Record<string, unknown> | null {\n  if (!existsSync(lockPath)) {\n    return null;\n  }\n\n  const text = readFileSync(lockPath, 'utf8').trim();\n  if (!text) {\n    return null;\n  }\n\n  try {\n    const parsed = JSON.parse(text);\n    return parsed && typeof parsed === 'object' ? (parsed as Record<string, unknown>) : null;\n  } catch {\n    return { raw: text };\n  }\n}\n\nexport function isProcessAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch (error) {\n    return !isErrnoException(error, 'ESRCH');\n  }\n}\n\nexport async function withStateFileLock<T>(\n  statePath: string,\n  options: StateLockOptions,\n  task: () => Promise<T> | T,\n): Promise<T> {\n  const { timeoutMs, pollMs } = normalizeLockTimings(options);\n  const lockPath = lockPathForState(statePath);\n  const lockKey = path.resolve(lockPath);\n  const localOwner = LOCAL_LOCK_OWNERS.get(lockKey);\n\n  if (localOwner) {\n    localOwner.depth += 1;\n    try {\n      return await task();\n    } finally {\n      releaseLocalLockOwner(lockKey);\n    }\n  }\n\n  mkdirSync(path.dirname(lockPath), { recursive: true });\n  const startedAt = Date.now();\n  const sleep = options.sleep ?? sleepMs;\n\n  while (true) {\n    try {\n      const fileDescriptor = openSync(lockPath, 'wx');\n      const metadata: StateLockMetadata = {\n        ownerPid: options.pid ?? process.pid,\n        ownerHost: options.host ?? os.hostname(),\n        reason: options.reason,\n        updatedAt: (options.now ?? new Date()).toISOString(),\n      };\n      writeLockMetadata(fileDescriptor, metadata);\n      LOCAL_LOCK_OWNERS.set(lockKey, {\n        depth: 1,\n        fd: fileDescriptor,\n      });\n\n      try {\n        return await task();\n      } finally {\n        releaseLocalLockOwner(lockKey);\n        closeSync(fileDescriptor);\n        try {\n          unlinkSync(lockPath);\n        } catch (error) {\n          if (!isErrnoException(error, 'ENOENT')) {\n            process.stderr.write(`Failed to remove state lock file: ${lockPath}\\n`);\n          }\n        }\n      }\n    } catch (error) {\n      if (!isErrnoException(error, 'EEXIST')) {\n        throw error;\n      }\n\n      const metadata = readStateLockMetadata(lockPath);\n      const ownerPid = metadata?.ownerPid;\n      if (typeof ownerPid === 'number' && !isProcessAlive(ownerPid)) {\n        try {\n          unlinkSync(lockPath);\n          continue;\n        } catch (unlinkError) {\n          if (!isErrnoException(unlinkError, 'ENOENT')) {\n            throw unlinkError;\n          }\n        }\n      }\n\n      const waitedMs = Date.now() - startedAt;\n      if (timeoutMs === 0 || waitedMs >= timeoutMs) {\n        throw new StateLockTimeoutError(lockPath, options.reason, waitedMs, metadata);\n      }\n\n      await sleep(pollMs);\n    }\n  }\n}\n"]}
+{"version":3,"file":"state-lock.js","sourceRoot":"","sources":["../../../src/lib/state-lock.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  closeSync,\n  existsSync,\n  mkdirSync,\n  openSync,\n  readFileSync,\n  unlinkSync,\n  writeFileSync,\n} from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { CliError } from './errors.js';\n\nexport type StateLockMetadata = {\n  ownerPid: number;\n  ownerHost: string;\n  reason: string;\n  updatedAt: string;\n};\n\nexport type StateLockOptions = {\n  reason: string;\n  metadata?: Record<string, string | number | boolean | null>;\n  stalePolicy?: 'local-pid' | 'same-host-pid' | 'never';\n  timeoutMs?: number;\n  pollMs?: number;\n  sleep?: (ms: number) => Promise<void>;\n  pid?: number;\n  host?: string;\n  now?: Date;\n};\n\ntype LocalLockOwner = {\n  depth: number;\n  fd: number;\n};\n\nconst LOCAL_LOCK_OWNERS = new Map<string, LocalLockOwner>();\nconst DEFAULT_TIMEOUT_MS = 300_000;\nconst DEFAULT_POLL_MS = 200;\nconst MAX_NODE_TIMER_DELAY_MS = 2_147_483_647;\n\nfunction sleepMs(ms: number): Promise<void> {\n  return new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n}\n\nfunction isErrnoException(error: unknown, code: string): boolean {\n  return Boolean(\n    error &&\n    typeof error === 'object' &&\n    'code' in error &&\n    (error as NodeJS.ErrnoException).code === code,\n  );\n}\n\nfunction normalizeLockTimings(options: StateLockOptions): { timeoutMs: number; pollMs: number } {\n  for (const [label, value] of [\n    ['timeoutMs', options.timeoutMs],\n    ['pollMs', options.pollMs],\n  ] as const) {\n    if (value === undefined) continue;\n    if (!Number.isSafeInteger(value)) {\n      throw new RangeError(`State lock ${label} must be a finite safe integer.`);\n    }\n    if (value > MAX_NODE_TIMER_DELAY_MS) {\n      throw new RangeError(\n        `State lock ${label} exceeds the maximum supported timer delay (${MAX_NODE_TIMER_DELAY_MS} ms).`,\n      );\n    }\n  }\n  return {\n    timeoutMs: Math.max(options.timeoutMs ?? DEFAULT_TIMEOUT_MS, 0),\n    pollMs: Math.max(options.pollMs ?? DEFAULT_POLL_MS, 10),\n  };\n}\n\nfunction writeLockMetadata(fileDescriptor: number, metadata: StateLockMetadata): void {\n  writeFileSync(fileDescriptor, `${JSON.stringify(metadata, null, 2)}\\n`, 'utf8');\n}\n\nfunction releaseLocalLockOwner(lockKey: string): void {\n  const owner = LOCAL_LOCK_OWNERS.get(lockKey);\n  if (owner && owner.depth > 1) {\n    owner.depth -= 1;\n    return;\n  }\n\n  LOCAL_LOCK_OWNERS.delete(lockKey);\n}\n\nexport class StateLockTimeoutError extends CliError {\n  constructor(\n    lockPath: string,\n    reason: string,\n    waitedMs: number,\n    owner: Record<string, unknown> | null,\n  ) {\n    super(`Timed out after ${waitedMs}ms acquiring state lock: ${lockPath}`, {\n      code: 'STATE_LOCK_TIMEOUT',\n      exitCode: 1,\n      details: {\n        lockPath,\n        reason,\n        waitedMs,\n        owner,\n      },\n    });\n  }\n}\n\nexport function lockPathForState(statePath: string): string {\n  return `${statePath}.lock`;\n}\n\nexport function readStateLockMetadata(lockPath: string): Record<string, unknown> | null {\n  if (!existsSync(lockPath)) {\n    return null;\n  }\n\n  const text = readFileSync(lockPath, 'utf8').trim();\n  if (!text) {\n    return null;\n  }\n\n  try {\n    const parsed = JSON.parse(text);\n    return parsed && typeof parsed === 'object' ? (parsed as Record<string, unknown>) : null;\n  } catch {\n    return { raw: text };\n  }\n}\n\nexport function isProcessAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch (error) {\n    return !isErrnoException(error, 'ESRCH');\n  }\n}\n\nexport async function withStateFileLock<T>(\n  statePath: string,\n  options: StateLockOptions,\n  task: () => Promise<T> | T,\n): Promise<T> {\n  const { timeoutMs, pollMs } = normalizeLockTimings(options);\n  const lockPath = lockPathForState(statePath);\n  const lockKey = path.resolve(lockPath);\n  const localOwner = LOCAL_LOCK_OWNERS.get(lockKey);\n\n  if (localOwner) {\n    localOwner.depth += 1;\n    try {\n      return await task();\n    } finally {\n      releaseLocalLockOwner(lockKey);\n    }\n  }\n\n  mkdirSync(path.dirname(lockPath), { recursive: true });\n  const startedAt = Date.now();\n  const sleep = options.sleep ?? sleepMs;\n\n  while (true) {\n    try {\n      const fileDescriptor = openSync(lockPath, 'wx');\n      const metadata: StateLockMetadata = {\n        ...options.metadata,\n        ownerPid: options.pid ?? process.pid,\n        ownerHost: options.host ?? os.hostname(),\n        reason: options.reason,\n        updatedAt: (options.now ?? new Date()).toISOString(),\n      };\n      writeLockMetadata(fileDescriptor, metadata);\n      LOCAL_LOCK_OWNERS.set(lockKey, {\n        depth: 1,\n        fd: fileDescriptor,\n      });\n\n      try {\n        return await task();\n      } finally {\n        releaseLocalLockOwner(lockKey);\n        closeSync(fileDescriptor);\n        try {\n          unlinkSync(lockPath);\n        } catch (error) {\n          if (!isErrnoException(error, 'ENOENT')) {\n            process.stderr.write(`Failed to remove state lock file: ${lockPath}\\n`);\n          }\n        }\n      }\n    } catch (error) {\n      if (!isErrnoException(error, 'EEXIST')) {\n        throw error;\n      }\n\n      const metadata = readStateLockMetadata(lockPath);\n      const ownerPid = metadata?.ownerPid;\n      const stalePolicy = options.stalePolicy ?? 'local-pid';\n      const ownerHost = metadata?.ownerHost;\n      const currentHost = options.host ?? os.hostname();\n      const staleOwner =\n        stalePolicy !== 'never' &&\n        typeof ownerPid === 'number' &&\n        !isProcessAlive(ownerPid) &&\n        (stalePolicy === 'local-pid' || ownerHost === currentHost);\n      if (staleOwner) {\n        try {\n          unlinkSync(lockPath);\n          continue;\n        } catch (unlinkError) {\n          if (!isErrnoException(unlinkError, 'ENOENT')) {\n            throw unlinkError;\n          }\n        }\n      }\n\n      const waitedMs = Date.now() - startedAt;\n      if (timeoutMs === 0 || waitedMs >= timeoutMs) {\n        throw new StateLockTimeoutError(lockPath, options.reason, waitedMs, metadata);\n      }\n\n      await sleep(pollMs);\n    }\n  }\n}\n"]}

package/dist/src/lib/supabase-client.d.ts

@@ -0,0 +1,47 @@
+import { type PostgrestError } from '@supabase/supabase-js';
+import type { FetchLike } from './http.js';
+export type SupabaseRestRuntime = {
+    apiBaseUrl: string;
+    userApiKey: string;
+    publishableKey: string;
+    sessionFile: string | null;
+    disableSessionCache: boolean;
+    forceReauth: boolean;
+};
+export type SupabaseDataRuntime = {
+    apiBaseUrl: string;
+    publishableKey: string;
+    getAccessToken: () => Promise<string>;
+    refreshAccessToken?: () => Promise<string>;
+};
+declare function trimToken(value: unknown): string;
+declare function parseBooleanEnv(value: unknown): boolean;
+export declare function requireSupabaseRestRuntime(env: NodeJS.ProcessEnv): SupabaseRestRuntime;
+export declare function deriveSupabaseProjectBaseUrl(apiBaseUrl: string): string;
+export declare function deriveSupabaseRestBaseUrl(apiBaseUrl: string): string;
+export declare const deriveSupabaseFunctionsBaseUrl: (apiBaseUrl: string) => string;
+export declare function buildSupabaseAuthHeaders(publishableKey: string, accessToken: string): Record<string, string>;
+export declare function createSupabaseFetch(fetchImpl: FetchLike, timeoutMs: number, runtime?: SupabaseDataRuntime): typeof fetch;
+type SupabaseQueryResult<T> = {
+    data: T | null;
+    error: PostgrestError | null;
+    status: number;
+};
+declare function postgrestInvalidJsonDetails(error: PostgrestError): string;
+export declare function runSupabaseArrayQuery<T>(queryPromise: PromiseLike<SupabaseQueryResult<T[]>>, sourceUrl: string): Promise<T[]>;
+export declare function runSupabaseQuery<T>(queryPromise: PromiseLike<SupabaseQueryResult<T>>, sourceUrl: string): Promise<T | null>;
+export declare function runSupabaseMutation(queryPromise: PromiseLike<{
+    error: PostgrestError | null;
+    status: number;
+}>, sourceUrl: string): Promise<void>;
+export declare function createSupabaseDataClient(runtime: SupabaseDataRuntime, fetchImpl: FetchLike, timeoutMs: number): {
+    client: import("@supabase/supabase-js").SupabaseClient<any, "public", "public", any, any>;
+    restBaseUrl: string;
+    functionsBaseUrl: string;
+};
+export declare const __testInternals: {
+    postgrestInvalidJsonDetails: typeof postgrestInvalidJsonDetails;
+    parseBooleanEnv: typeof parseBooleanEnv;
+    trimToken: typeof trimToken;
+};
+export {};