Method acquire

src/node/services/serverLockfile.ts:38–80

* Acquire the lockfile with the given baseUrl and token. * Writes atomically with 0600 permissions (owner read/write only).

(
    baseUrl: string,
    token: string,
    extra?: {
      bindHost?: string;
      port?: number;
      networkBaseUrls?: string[];
    }
  )

   * Writes atomically with 0600 permissions (owner read/write only).
   */
  async acquire(
    baseUrl: string,
    token: string,
    extra?: {
      bindHost?: string;
      port?: number;
      networkBaseUrls?: string[];
    }
  ): Promise<void> {
    const bindHost = extra?.bindHost?.trim() ? extra.bindHost.trim() : undefined;
    const port =
      typeof extra?.port === "number" &&
      Number.isInteger(extra.port) &&
      extra.port >= 0 &&
      extra.port <= 65535
        ? extra.port
        : undefined;

    const data: ServerLockData = {
      pid: process.pid,
      baseUrl,
      token,
      startedAt: new Date().toISOString(),
      bindHost,
      port,
      networkBaseUrls: extra?.networkBaseUrls?.length ? extra.networkBaseUrls : undefined,
    };

    // Ensure directory exists
    const dir = path.dirname(this.lockPath);
    try {
      await fs.access(dir);
    } catch {
      await fs.mkdir(dir, { recursive: true });
    }

    // Write atomically by writing to temp file then renaming
    const tempPath = `${this.lockPath}.${process.pid}.tmp`;
    await fs.writeFile(tempPath, JSON.stringify(data, null, 2), {
      mode: 0o600, // Owner read/write only
    });
    await fs.rename(tempPath, this.lockPath);
  }

  /**
   * Read the lockfile and validate it.