@kuunda/kuunda-js

Client JavaScript / TypeScript pour Kuunda Cloud (PostgREST, GoTrue, stockage, etc.). L’API est volontairement proche de supabase-js (createClient, auth, from, …).

Installation

Registre npm (recommandé après publication)

npm install @kuunda/kuunda-js

Le paquet doit être publié sur npm (voir prepublishOnly dans ce dossier et le workflow .github/workflows/publish-kuunda-js.yml à la racine du monorepo). Tant qu’il n’apparaît pas sur npmjs.com, utilisez la méthode « dépôt Git » ci-dessous.

Depuis ce dépôt (monorepo)

Le dossier dist/ est versionné : vous pouvez installer le paquet sans lancer build.

git clone --depth 1 https://github.com/Arowtech/kuunda-cloud.git .kuunda-cloud
npm install ./.kuunda-cloud/packages/kuunda-js

Avec pnpm :

git clone --depth 1 https://github.com/Arowtech/kuunda-cloud.git .kuunda-cloud
pnpm add ./.kuunda-cloud/packages/kuunda-js

Ajoutez .kuunda-cloud/ à votre .gitignore si le clone est à côté de votre appli.

Développement du SDK (contributeurs)

cd packages/kuunda-js
npm install
npm run build

Utilisation

Les URL et la clé anon sont affichées dans la console Kuunda : Projet → Paramètres → API.

import { createClient } from '@kuunda/kuunda-js';

const kuunda = createClient(process.env.NEXT_PUBLIC_KUUNDA_URL!, process.env.NEXT_PUBLIC_KUUNDA_ANON_KEY!);

const { data, error } = await kuunda.from('ma_table').select('*');

• URL typique par projet : https://<ref8>.kuunda-cloud.com (le sous-domaine permet d’identifier le projet).
• Si vous passez par un hôte unique type https://api.kuunda-cloud.com, ajoutez l’en-tête X-Project-Ref (ref à 8 caractères) :

createClient(url, anonKey, {
  global: { headers: { 'X-Project-Ref': 'abcdef12' } },
});

Référence PostgREST : documentation officielle.

Mainteneurs (monorepo)

Après toute modification sous src/, régénérez les artefacts et versionnez-les avec le code :

npm run build
git add dist/