LockService

class LockService {
  constructor(private readonly baseUrl: string)
}

async acquisisciLock(idfolio: number): Promise<AcquisisciLockResult>

interface AcquisisciLockResult {
  successo: boolean
  idutente_lock?: number          // se successo === true
  datalock?: string               // ISO 8601
  scadenzalock?: string           // ISO 8601, ~30 min nel futuro
  errore?: 'LOCK_OCCUPIED'        // se successo === false
}

async rilasciaLock(idfolio: number): Promise<boolean>

async rinnovaLock(idfolio: number): Promise<string>

async leggiStatoLock(idfolio: number): Promise<LockInfo>

interface LockInfo {
  idfolio: number
  idutenteLock: number | null     // ← mappato da idutente_lock
  datalock: string | null
  scadenzalock: string | null
  islocked: boolean               // true se lock attivo non scaduto
}

// In useSpreadsheet
let heartbeatInterval: ReturnType<typeof setInterval> | null = null

async function startHeartbeat(idfolio: number) {
  heartbeatInterval = setInterval(async () => {
    try {
      const nuovaScadenza = await lockService.rinnovaLock(idfolio)
      // aggiorna lockInfo.scadenzalock localmente
    } catch (err) {
      // lock perso (es. invalidato da admin)
      stopHeartbeat()
    }
  }, 5 * 60 * 1000)    // ogni 5 min
}

function stopHeartbeat() {
  if (heartbeatInterval) {
    clearInterval(heartbeatInterval)
    heartbeatInterval = null
  }
}

CASE
  WHEN scadenzalock IS NULL THEN false
  WHEN scadenzalock < now() THEN false
  WHEN idutente_lock = current_user_id() THEN false  -- vediamo "no lock esterno"
  ELSE true
END

import { LockService } from '@pzeta/vue-foglidicalcolo'

const lockSvc = new LockService('https://api.example.com/rest')

const result = await lockSvc.acquisisciLock(42)

if (result.successo) {
  console.log(`Lock acquisito, scade ${result.scadenzalock}`)
  // ... apri editor in modalità edit
} else if (result.errore === 'LOCK_OCCUPIED') {
  console.warn('Foglio bloccato da altro utente')
  const stato = await lockSvc.leggiStatoLock(42)
  console.log(`Owner: utente ${stato.idutenteLock}, scade ${stato.scadenzalock}`)
  // ... apri editor in modalità view forzata
}