zpan/server/licensing/instance-id.ts

import { eq } from 'drizzle-orm'
import { nanoid } from 'nanoid'
import { systemOptions } from '../db/schema'
import type { Database } from '../platform/interface'

const INSTANCE_ID_KEY = 'instance_id'

// Returns the instance UUID, creating and persisting one if it does not exist.
// The ID is stored in systemOptions under key 'instance_id'.
export async function getOrCreateInstanceId(db: Database, configuredId?: string): Promise<string> {
  const rows = await db
    .select({ value: systemOptions.value })
    .from(systemOptions)
    .where(eq(systemOptions.key, INSTANCE_ID_KEY))
    .limit(1)

  if (rows[0]?.value) return rows[0].value

  const id = configuredId?.trim() || nanoid(21)
  await db
    .insert(systemOptions)
    .values({ key: INSTANCE_ID_KEY, value: id, public: false })
    .onConflictDoUpdate({ target: systemOptions.key, set: { value: id } })

  return id
}