Function readLockContents

packages/server/src/lock.ts:129–146

Read + JSON.parse the lock file; returns undefined on any error so callers can fall through.

(path: string)

/** Read + JSON.parse the lock file; returns undefined on any error so callers can fall through. */
function readLockContents(path: string): LockContents | undefined {
  try {
    const raw = readFileSync(path, 'utf8');
    const parsed = JSON.parse(raw) as unknown;
    if (
      typeof parsed === 'object' &&
      parsed !== null &&
      typeof (parsed as LockContents).pid === 'number' &&
      typeof (parsed as LockContents).started_at === 'string' &&
      typeof (parsed as LockContents).port === 'number'
    ) {
      return parsed as LockContents;
    }
    return undefined;
  } catch {
    return undefined;
  }
}

/**
 * Read the lock file and return its contents only when it describes a *live*