Function getDeviceId

apps/api/src/utils/ids.ts:10–59

({
  projectId,
  ip,
  ua,
  salts,
  overrideDeviceId,
  eventTimeMs,
}: {
  projectId: string;
  ip: string;
  ua: string | undefined;
  salts: { current: string; previous: string };
  overrideDeviceId?: string;
  /** Event timestamp (ms). Used to decide whether an existing session is
   *  still within its idle window. Defaults to `Date.now()`. */
  eventTimeMs?: number;
})

import type { IClickhouseSession } from '@openpanel/db';

export async function getDeviceId({
  projectId,
  ip,
  ua,
  salts,
  overrideDeviceId,
  eventTimeMs,
}: {
  projectId: string;
  ip: string;
  ua: string | undefined;
  salts: { current: string; previous: string };
  overrideDeviceId?: string;
  /** Event timestamp (ms). Used to decide whether an existing session is
   *  still within its idle window. Defaults to `Date.now()`. */
  eventTimeMs?: number;
}) {
  if (overrideDeviceId) {
    // A caller-supplied device id is stable (no salt rotation), so it's the only
    // candidate — resolve it through the same path as internal ids.
    return await getInfoFromSession({
      projectId,
      deviceIds: [overrideDeviceId],
      eventTimeMs: eventTimeMs ?? Date.now(),
    });
  }

  if (!ua) {
    return { deviceId: '', sessionId: '' };
  }

  const currentDeviceId = generateDeviceId({
    salt: salts.current,
    origin: projectId,
    ip,
    ua,
  });
  const previousDeviceId = generateDeviceId({
    salt: salts.previous,
    origin: projectId,
    ip,
    ua,
  });

  return await getInfoFromSession({
    projectId,
    deviceIds: [currentDeviceId, previousDeviceId],
    eventTimeMs: eventTimeMs ?? Date.now(),
  });
}

interface DeviceIdResult {
  deviceId: string;