KV Store

KV est un store clé/valeur durable et restreint à l'application. C'est un store de chaînes : chaque valeur est persistée sous forme de chaîne. Les clés et les valeurs sont restreintes à l'identifiant de votre application (voir le modèle loopback dans la Présentation du SDK).

API JS

import { createSdk } from "@bext-stack/framework";

const sdk = createSdk("<app-id>");

await sdk.kv.set("greeting", { hello: "world" }, 3600); // optional TTL in seconds
const value = await sdk.kv.get<{ hello: string }>("greeting");
await sdk.kv.delete("greeting");
const keys = await sdk.kv.list("post:", 100);           // prefix + limit

Endpoints

Tous les endpoints sont en POST et restreints par X-Bext-App-Id (voir Présentation du SDK) :

curl -s http://127.0.0.1/__bext/sdk/kv/set \
  -H "X-Bext-App-Id: <app-id>" \
  -H "Content-Type: application/json" \
  -d '{"key":"greeting","value":"hi","ttl":3600}'

Sémantique

• Store de chaînes — les valeurs sont stockées sous forme de chaînes.
• TTL — passez ttl (secondes) à set / ttlSecs à kv.set pour faire expirer une clé.
• Listing par préfixe — list / entries acceptent un prefix et une limit.

Le piège du double encodage

Conséquences pratiques :

• Faire un aller-retour via sdk.kv est sûr — le client re-parse à la lecture.
• Si vous lisez la chaîne brute d'une autre manière (par ex. directement via /kv/entries, ou depuis un runtime différent), vous pouvez voir une valeur enveloppée en JSON une à trois fois et devrez appliquer JSON.parse vous-même le même nombre de fois.

Motif : enregistrement de job durable en KV

La Queue n'a pas de store de résultats — elle est fire-and-forget, sans statut par message. Quand vous devez suivre le résultat d'un job, superposez un enregistrement de job durable en KV :

// Store a record when you enqueue…
await sdk.kv.set(`job:${id}`, { status: "queued", submittedAt: Date.now() });

// …the worker updates it as it progresses…
await sdk.kv.set(`job:${id}`, { status: "running" });

// …and on completion or failure.
await sdk.kv.set(`job:${id}`, { status: "complete", result });

Utilisez des clés comme job:<id> avec de petits helpers submit / get / complete / fail autour d'elles. Voir Queue pour le côté enqueue, ou Tasks & Planificateur dont le task-executor suit déjà le statut pour vous.

Et ensuite