@aurabase/aurabase-js 0.3.1 → 0.4.1

package/packages/ai/dist/index.d.cts

@@ -1,139 +0,0 @@
-import { BaseService, AuraClientLike, ChatMessage, AuraResponse, ChatResponse, EmbedRequest, EmbedResponse, RagRequest, RagResponse, RagIngestRequest, RagIngestResponse, SemanticSearchResult } from '@aurabase/core';
-export { AuraResponse, ChatMessage, ChatResponse, EmbedRequest, EmbedResponse, RagIngestRequest, RagIngestResponse, RagRequest, RagResponse, SemanticSearchResult } from '@aurabase/core';
-
-/** Un message SSE dispatché : nom d'event (`message` par défaut) + données jointes. */
-interface SSEMessage {
-    event: string;
-    data: string;
-}
-/** Chunk de streaming de chat : un delta de tokens incrémental. */
-interface ChatStreamChunk {
-    delta: string;
-}
-/**
- * Parse un flux SSE en `AsyncGenerator<SSEMessage>`.
- *
- * Conforme au protocole EventSource :
- *  - événements séparés par une ligne vide (`\n\n`) ;
- *  - champs `event:` / `data:` (espace optionnel après le `:`), autres champs ignorés ;
- *  - plusieurs `data:` d'un même event sont jointes par `\n` ;
- *  - lignes commençant par `:` = commentaires/keep-alive → ignorées ;
- *  - CRLF toléré (le `\r` de fin de ligne est retiré).
- *
- * Gère les trames partielles : un event scindé sur plusieurs chunks est
- * bufferisé jusqu'à réception de la ligne vide. Un éventuel event final non
- * terminé par une ligne vide est tout de même livré à la fermeture du flux.
- */
-declare function parseSSE(stream: ReadableStream<Uint8Array>): AsyncGenerator<SSEMessage>;
-
-/**
- * Un namespace RAG. Le backend (`GET /rag/namespaces` → `Vec<String>`) renvoie
- * de simples chaînes ; le type reste un alias pour documenter l'intention et
- * autoriser une évolution ultérieure vers un objet sans casser les appelants.
- */
-type RagNamespace = string;
-/**
- * Réponse de `DELETE /rag/{namespace}` — forme réelle du handler
- * (`rag_delete_namespace` → `{ "deleted": <count> }`).
- */
-interface RagDeleteResponse {
-    /** Nombre d'entrées supprimées du namespace. */
-    deleted: number;
-}
-/**
- * Réponse de `POST /rag/{namespace}/reindex` — forme réelle du handler
- * (`ReindexResponse` dans `services/aura-ai/src/rag/mod.rs`).
- */
-interface RagReindexResponse {
-    /** Nombre de chunks ré-embeddés sous le modèle courant. */
-    reindexed: number;
-    /** Modèle d'embedding désormais appliqué au namespace. */
-    embedding_model: string;
-}
-
-declare class AiService extends BaseService {
-    constructor(client: AuraClientLike);
-    private get prefix();
-    /**
-     * Send a chat completion request.
-     */
-    chat(messages: ChatMessage[], options?: {
-        model?: string;
-        temperature?: number;
-        max_tokens?: number;
-    }): Promise<AuraResponse<ChatResponse>>;
-    /**
-     * Chat completion streamé (SSE). Renvoie un `AsyncIterable` de deltas de tokens,
-     * consommable par `for await (const { delta } of ai.chatStream(msgs)) { … }`.
-     *
-     * Court-circuite volontairement le pipeline JSON (`@aurabase/core/fetch.ts`) et
-     * emprunte le chemin transport BRUT `client.fetchFn` (patron `StorageService.download`) :
-     *  - refresh proactif du token expiré (même règle que `download`, marge 30 s) ;
-     *  - pose manuelle de `Authorization: Bearer` + `apikey`, `Accept: text/event-stream` ;
-     *  - lecture de `res.body` via `parseSSE`, mapping des events serveur :
-     *    `delta` (`{ content }`) → `yield { delta }`, `error` (`{ error }`) → lève une
-     *    `AuraError`, `done` → termine l'itération.
-     *
-     * `options.signal` interrompt proprement le flux (annulation du `fetch` + fin
-     * d'itération sans throw). Sur `!res.ok`, lève `AuraError(res.status)`.
-     *
-     * Backend route: POST /v1/ai/{project_id}/chat/stream
-     */
-    chatStream(messages: ChatMessage[], options?: {
-        model?: string;
-        temperature?: number;
-        max_tokens?: number;
-        signal?: AbortSignal;
-    }): AsyncGenerator<ChatStreamChunk>;
-    /**
-     * Generate embeddings for the given input(s).
-     */
-    embed(req: EmbedRequest): Promise<AuraResponse<EmbedResponse>>;
-    /**
-     * Retrieval-Augmented Generation: query a collection and get an answer.
-     */
-    rag(req: RagRequest): Promise<AuraResponse<RagResponse>>;
-    /**
-     * Ingest a document into a RAG namespace.
-     */
-    ragIngest(req: RagIngestRequest): Promise<AuraResponse<RagIngestResponse>>;
-    /**
-     * Liste les namespaces RAG du projet.
-     * Backend route: GET /v1/ai/{project_id}/rag/namespaces (→ `Vec<String>`).
-     */
-    listNamespaces(): Promise<AuraResponse<RagNamespace[]>>;
-    /**
-     * Supprime un namespace RAG (et son corpus). Le segment `namespace` est
-     * URL-encodé (anti-injection de chemin).
-     * Backend route: DELETE /v1/ai/{project_id}/rag/{namespace} (→ `{ deleted }`).
-     */
-    deleteNamespace(namespace: string): Promise<AuraResponse<RagDeleteResponse>>;
-    /**
-     * Ré-indexe un namespace RAG avec le modèle d'embedding courant (remédiation
-     * après un changement de modèle/dimension). Le segment `namespace` est URL-encodé.
-     * Backend route: POST /v1/ai/{project_id}/rag/{namespace}/reindex (→ `ReindexResponse`).
-     */
-    reindexNamespace(namespace: string): Promise<AuraResponse<RagReindexResponse>>;
-    /**
-     * Semantic search over an embedding namespace.
-     */
-    semanticSearch(query: string, namespace: string, options?: {
-        top_k?: number;
-        threshold?: number;
-    }): Promise<AuraResponse<SemanticSearchResult[]>>;
-    /**
-     * Natural-language to SQL: convert a question into a SQL query.
-     */
-    nl2sql(question: string, schema: string, options?: {
-        dialect?: string;
-        examples?: Array<{
-            question: string;
-            sql: string;
-        }>;
-    }): Promise<AuraResponse<{
-        sql: string;
-        explanation: string;
-    }>>;
-}
-
-export { AiService, type ChatStreamChunk, type RagDeleteResponse, type RagNamespace, type RagReindexResponse, type SSEMessage, parseSSE };

package/packages/ai/dist/index.d.ts

@@ -1,139 +0,0 @@
-import { BaseService, AuraClientLike, ChatMessage, AuraResponse, ChatResponse, EmbedRequest, EmbedResponse, RagRequest, RagResponse, RagIngestRequest, RagIngestResponse, SemanticSearchResult } from '@aurabase/core';
-export { AuraResponse, ChatMessage, ChatResponse, EmbedRequest, EmbedResponse, RagIngestRequest, RagIngestResponse, RagRequest, RagResponse, SemanticSearchResult } from '@aurabase/core';
-
-/** Un message SSE dispatché : nom d'event (`message` par défaut) + données jointes. */
-interface SSEMessage {
-    event: string;
-    data: string;
-}
-/** Chunk de streaming de chat : un delta de tokens incrémental. */
-interface ChatStreamChunk {
-    delta: string;
-}
-/**
- * Parse un flux SSE en `AsyncGenerator<SSEMessage>`.
- *
- * Conforme au protocole EventSource :
- *  - événements séparés par une ligne vide (`\n\n`) ;
- *  - champs `event:` / `data:` (espace optionnel après le `:`), autres champs ignorés ;
- *  - plusieurs `data:` d'un même event sont jointes par `\n` ;
- *  - lignes commençant par `:` = commentaires/keep-alive → ignorées ;
- *  - CRLF toléré (le `\r` de fin de ligne est retiré).
- *
- * Gère les trames partielles : un event scindé sur plusieurs chunks est
- * bufferisé jusqu'à réception de la ligne vide. Un éventuel event final non
- * terminé par une ligne vide est tout de même livré à la fermeture du flux.
- */
-declare function parseSSE(stream: ReadableStream<Uint8Array>): AsyncGenerator<SSEMessage>;
-
-/**
- * Un namespace RAG. Le backend (`GET /rag/namespaces` → `Vec<String>`) renvoie
- * de simples chaînes ; le type reste un alias pour documenter l'intention et
- * autoriser une évolution ultérieure vers un objet sans casser les appelants.
- */
-type RagNamespace = string;
-/**
- * Réponse de `DELETE /rag/{namespace}` — forme réelle du handler
- * (`rag_delete_namespace` → `{ "deleted": <count> }`).
- */
-interface RagDeleteResponse {
-    /** Nombre d'entrées supprimées du namespace. */
-    deleted: number;
-}
-/**
- * Réponse de `POST /rag/{namespace}/reindex` — forme réelle du handler
- * (`ReindexResponse` dans `services/aura-ai/src/rag/mod.rs`).
- */
-interface RagReindexResponse {
-    /** Nombre de chunks ré-embeddés sous le modèle courant. */
-    reindexed: number;
-    /** Modèle d'embedding désormais appliqué au namespace. */
-    embedding_model: string;
-}
-
-declare class AiService extends BaseService {
-    constructor(client: AuraClientLike);
-    private get prefix();
-    /**
-     * Send a chat completion request.
-     */
-    chat(messages: ChatMessage[], options?: {
-        model?: string;
-        temperature?: number;
-        max_tokens?: number;
-    }): Promise<AuraResponse<ChatResponse>>;
-    /**
-     * Chat completion streamé (SSE). Renvoie un `AsyncIterable` de deltas de tokens,
-     * consommable par `for await (const { delta } of ai.chatStream(msgs)) { … }`.
-     *
-     * Court-circuite volontairement le pipeline JSON (`@aurabase/core/fetch.ts`) et
-     * emprunte le chemin transport BRUT `client.fetchFn` (patron `StorageService.download`) :
-     *  - refresh proactif du token expiré (même règle que `download`, marge 30 s) ;
-     *  - pose manuelle de `Authorization: Bearer` + `apikey`, `Accept: text/event-stream` ;
-     *  - lecture de `res.body` via `parseSSE`, mapping des events serveur :
-     *    `delta` (`{ content }`) → `yield { delta }`, `error` (`{ error }`) → lève une
-     *    `AuraError`, `done` → termine l'itération.
-     *
-     * `options.signal` interrompt proprement le flux (annulation du `fetch` + fin
-     * d'itération sans throw). Sur `!res.ok`, lève `AuraError(res.status)`.
-     *
-     * Backend route: POST /v1/ai/{project_id}/chat/stream
-     */
-    chatStream(messages: ChatMessage[], options?: {
-        model?: string;
-        temperature?: number;
-        max_tokens?: number;
-        signal?: AbortSignal;
-    }): AsyncGenerator<ChatStreamChunk>;
-    /**
-     * Generate embeddings for the given input(s).
-     */
-    embed(req: EmbedRequest): Promise<AuraResponse<EmbedResponse>>;
-    /**
-     * Retrieval-Augmented Generation: query a collection and get an answer.
-     */
-    rag(req: RagRequest): Promise<AuraResponse<RagResponse>>;
-    /**
-     * Ingest a document into a RAG namespace.
-     */
-    ragIngest(req: RagIngestRequest): Promise<AuraResponse<RagIngestResponse>>;
-    /**
-     * Liste les namespaces RAG du projet.
-     * Backend route: GET /v1/ai/{project_id}/rag/namespaces (→ `Vec<String>`).
-     */
-    listNamespaces(): Promise<AuraResponse<RagNamespace[]>>;
-    /**
-     * Supprime un namespace RAG (et son corpus). Le segment `namespace` est
-     * URL-encodé (anti-injection de chemin).
-     * Backend route: DELETE /v1/ai/{project_id}/rag/{namespace} (→ `{ deleted }`).
-     */
-    deleteNamespace(namespace: string): Promise<AuraResponse<RagDeleteResponse>>;
-    /**
-     * Ré-indexe un namespace RAG avec le modèle d'embedding courant (remédiation
-     * après un changement de modèle/dimension). Le segment `namespace` est URL-encodé.
-     * Backend route: POST /v1/ai/{project_id}/rag/{namespace}/reindex (→ `ReindexResponse`).
-     */
-    reindexNamespace(namespace: string): Promise<AuraResponse<RagReindexResponse>>;
-    /**
-     * Semantic search over an embedding namespace.
-     */
-    semanticSearch(query: string, namespace: string, options?: {
-        top_k?: number;
-        threshold?: number;
-    }): Promise<AuraResponse<SemanticSearchResult[]>>;
-    /**
-     * Natural-language to SQL: convert a question into a SQL query.
-     */
-    nl2sql(question: string, schema: string, options?: {
-        dialect?: string;
-        examples?: Array<{
-            question: string;
-            sql: string;
-        }>;
-    }): Promise<AuraResponse<{
-        sql: string;
-        explanation: string;
-    }>>;
-}
-
-export { AiService, type ChatStreamChunk, type RagDeleteResponse, type RagNamespace, type RagReindexResponse, type SSEMessage, parseSSE };

package/packages/ai/dist/index.js

@@ -1,226 +0,0 @@
-import { BaseService, isTokenExpired, refreshOnce, AuraError, isAbortError } from '@aurabase/core';
-
-// src/AiService.ts
-
-// src/sse.ts
-async function* parseSSE(stream) {
-  const reader = stream.getReader();
-  const decoder = new TextDecoder();
-  let buffer = "";
-  let eventName = "message";
-  let dataLines = [];
-  const consumeLine = (raw) => {
-    const line = raw.endsWith("\r") ? raw.slice(0, -1) : raw;
-    if (line === "") {
-      if (dataLines.length === 0) {
-        eventName = "message";
-        return null;
-      }
-      const msg = { event: eventName, data: dataLines.join("\n") };
-      eventName = "message";
-      dataLines = [];
-      return msg;
-    }
-    if (line.startsWith(":")) return null;
-    const colon = line.indexOf(":");
-    let field;
-    let value;
-    if (colon === -1) {
-      field = line;
-      value = "";
-    } else {
-      field = line.slice(0, colon);
-      value = line.slice(colon + 1);
-      if (value.startsWith(" ")) value = value.slice(1);
-    }
-    if (field === "event") eventName = value;
-    else if (field === "data") dataLines.push(value);
-    return null;
-  };
-  try {
-    for (; ; ) {
-      const { done, value } = await reader.read();
-      if (done) break;
-      buffer += decoder.decode(value, { stream: true });
-      let idx;
-      while ((idx = buffer.indexOf("\n")) !== -1) {
-        const raw = buffer.slice(0, idx);
-        buffer = buffer.slice(idx + 1);
-        const msg = consumeLine(raw);
-        if (msg) yield msg;
-      }
-    }
-    buffer += decoder.decode();
-    if (buffer.length > 0) {
-      const msg = consumeLine(buffer);
-      if (msg) yield msg;
-    }
-    if (dataLines.length > 0) {
-      yield { event: eventName, data: dataLines.join("\n") };
-    }
-  } finally {
-    reader.releaseLock();
-  }
-}
-
-// src/AiService.ts
-var AiService = class extends BaseService {
-  constructor(client) {
-    super(client);
-  }
-  get prefix() {
-    return `/v1/ai/${this.client.projectId}`;
-  }
-  /**
-   * Send a chat completion request.
-   */
-  async chat(messages, options) {
-    return this.request("POST", `${this.prefix}/chat`, {
-      messages,
-      ...options
-    });
-  }
-  /**
-   * Chat completion streamé (SSE). Renvoie un `AsyncIterable` de deltas de tokens,
-   * consommable par `for await (const { delta } of ai.chatStream(msgs)) { … }`.
-   *
-   * Court-circuite volontairement le pipeline JSON (`@aurabase/core/fetch.ts`) et
-   * emprunte le chemin transport BRUT `client.fetchFn` (patron `StorageService.download`) :
-   *  - refresh proactif du token expiré (même règle que `download`, marge 30 s) ;
-   *  - pose manuelle de `Authorization: Bearer` + `apikey`, `Accept: text/event-stream` ;
-   *  - lecture de `res.body` via `parseSSE`, mapping des events serveur :
-   *    `delta` (`{ content }`) → `yield { delta }`, `error` (`{ error }`) → lève une
-   *    `AuraError`, `done` → termine l'itération.
-   *
-   * `options.signal` interrompt proprement le flux (annulation du `fetch` + fin
-   * d'itération sans throw). Sur `!res.ok`, lève `AuraError(res.status)`.
-   *
-   * Backend route: POST /v1/ai/{project_id}/chat/stream
-   */
-  async *chatStream(messages, options) {
-    const client = this.client;
-    const store = client.authStore;
-    if (store.token && store.refreshToken && isTokenExpired(store.token, 30)) {
-      await refreshOnce(client);
-    }
-    const headers = {
-      "Content-Type": "application/json",
-      Accept: "text/event-stream"
-    };
-    if (store.token) headers["Authorization"] = `Bearer ${store.token}`;
-    if (client.apiKey) headers["apikey"] = client.apiKey;
-    const body = JSON.stringify({
-      messages,
-      model: options?.model,
-      temperature: options?.temperature,
-      max_tokens: options?.max_tokens
-    });
-    try {
-      const res = await client.fetchFn(this.url(`${this.prefix}/chat/stream`), {
-        method: "POST",
-        headers,
-        body,
-        signal: options?.signal
-      });
-      if (!res.ok) {
-        let parsed = null;
-        try {
-          parsed = await res.json();
-        } catch {
-        }
-        throw new AuraError(res.status, parsed);
-      }
-      if (!res.body) {
-        throw new AuraError(0, {
-          error: { code: "invalid_response", message: "chatStream: la r\xE9ponse SSE n'a pas de corps lisible" }
-        });
-      }
-      for await (const msg of parseSSE(res.body)) {
-        if (msg.event === "delta") {
-          let content = "";
-          try {
-            content = JSON.parse(msg.data).content ?? "";
-          } catch {
-            content = "";
-          }
-          if (content) yield { delta: content };
-        } else if (msg.event === "error") {
-          let message = "AI stream error";
-          try {
-            message = JSON.parse(msg.data).error ?? message;
-          } catch {
-          }
-          throw new AuraError(0, { error: { code: "ai_stream_error", message } });
-        } else if (msg.event === "done") {
-          return;
-        }
-      }
-    } catch (err) {
-      if (options?.signal?.aborted || isAbortError(err)) return;
-      throw err;
-    }
-  }
-  /**
-   * Generate embeddings for the given input(s).
-   */
-  async embed(req) {
-    return this.request("POST", `${this.prefix}/embed`, req);
-  }
-  /**
-   * Retrieval-Augmented Generation: query a collection and get an answer.
-   */
-  async rag(req) {
-    return this.request("POST", `${this.prefix}/rag/query`, req);
-  }
-  /**
-   * Ingest a document into a RAG namespace.
-   */
-  async ragIngest(req) {
-    return this.request("POST", `${this.prefix}/rag/ingest`, req);
-  }
-  /**
-   * Liste les namespaces RAG du projet.
-   * Backend route: GET /v1/ai/{project_id}/rag/namespaces (→ `Vec<String>`).
-   */
-  async listNamespaces() {
-    return this.request("GET", `${this.prefix}/rag/namespaces`);
-  }
-  /**
-   * Supprime un namespace RAG (et son corpus). Le segment `namespace` est
-   * URL-encodé (anti-injection de chemin).
-   * Backend route: DELETE /v1/ai/{project_id}/rag/{namespace} (→ `{ deleted }`).
-   */
-  async deleteNamespace(namespace) {
-    return this.request("DELETE", `${this.prefix}/rag/${encodeURIComponent(namespace)}`);
-  }
-  /**
-   * Ré-indexe un namespace RAG avec le modèle d'embedding courant (remédiation
-   * après un changement de modèle/dimension). Le segment `namespace` est URL-encodé.
-   * Backend route: POST /v1/ai/{project_id}/rag/{namespace}/reindex (→ `ReindexResponse`).
-   */
-  async reindexNamespace(namespace) {
-    return this.request("POST", `${this.prefix}/rag/${encodeURIComponent(namespace)}/reindex`);
-  }
-  /**
-   * Semantic search over an embedding namespace.
-   */
-  async semanticSearch(query, namespace, options) {
-    const params = new URLSearchParams({ query, namespace });
-    if (options?.top_k !== void 0) params.set("top_k", String(options.top_k));
-    if (options?.threshold !== void 0) params.set("threshold", String(options.threshold));
-    return this.request("GET", `${this.prefix}/search?${params.toString()}`);
-  }
-  /**
-   * Natural-language to SQL: convert a question into a SQL query.
-   */
-  async nl2sql(question, schema, options) {
-    return this.request("POST", `${this.prefix}/nl2sql`, {
-      question,
-      schema,
-      dialect: options?.dialect,
-      examples: options?.examples
-    });
-  }
-};
-
-export { AiService, parseSSE };

package/packages/ai/package.json

@@ -1,61 +0,0 @@
-{
-  "name": "@aurabase/ai",
-  "version": "0.3.0",
-  "description": "Service IA du SDK Aurabase (chat, embeddings, RAG, recherche sémantique, NL2SQL)",
-  "type": "module",
-  "main": "dist/index.cjs",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
-    }
-  },
-  "sideEffects": false,
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "license": "MIT",
-  "author": "Aurabase",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/daylami555/aurabase.git",
-    "directory": "aurabase-js/packages/ai"
-  },
-  "homepage": "https://github.com/daylami555/aurabase/tree/main/aurabase-js/packages/ai#readme",
-  "bugs": {
-    "url": "https://github.com/daylami555/aurabase/issues"
-  },
-  "keywords": [
-    "aurabase",
-    "baas",
-    "sdk",
-    "ai",
-    "chat"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run --passWithNoTests",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@aurabase/core": "workspace:*"
-  },
-  "devDependencies": {
-    "tsup": "catalog:",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
-  }
-}

package/packages/aurabase/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Aurabase
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/packages/aurabase/README.md

@@ -1,64 +0,0 @@
-# aurabase
-
-Client JavaScript/TypeScript officiel d'Aurabase : point d'entrée principal du SDK, agrégeant les 8 packages de service (`@aurabase/*`) derrière `createClient`/`createAdminClient` et l'export `aurabase/ssr`.
-
-![npm](https://img.shields.io/npm/v/aurabase) ![license](https://img.shields.io/badge/license-MIT-blue)
-
-> Pre-release — pas encore publié sur npm.
-
-## Installation
-
-```bash
-npm i aurabase
-```
-
-## Rôle
-
-Ce package ne réimplémente aucune logique de service : il compose `AuthService`, `DatabaseService`, `StorageService`, `RealtimeService`, `FunctionsService`, `AiService` et `NotificationsService` (chacun dans son propre package `@aurabase/*`) derrière un seul client.
-
-- `createClient(baseUrl, projectId, apiKey, options?)` — client applicatif standard.
-- `createAdminClient(baseUrl, projectId, serviceRoleKey, options?)` — client serveur avec `authAdmin` (clé `service_role`, jamais côté navigateur).
-- `aurabase/ssr` — `createServerClient`/`createBrowserClient` pour Next.js et frameworks SSR (cookies, session partagée serveur/navigateur).
-
-## Quick Start
-
-```ts
-import { createClient } from 'aurabase'
-
-const aura = createClient(
-  'http://localhost:8080',
-  '00000000-0000-0000-0000-000000000001',
-  'aura_anon_xxx',
-)
-
-const { data, error } = await aura.db
-  .from('posts')
-  .select('id,title,published')
-  .eq('published', true)
-  .order('created_at', 'desc')
-  .limit(10)
-
-if (error) {
-  console.error(error.code, error.message)
-}
-```
-
-## Sous-packages
-
-| Package | Contenu |
-|---|---|
-| [`@aurabase/core`](../core) | fetch, erreurs, types, stores, `BaseService`, interface `AuraClientLike` |
-| [`@aurabase/auth`](../auth) | `AuthService`, `AuthAdminService` |
-| [`@aurabase/db`](../db) | `DatabaseService`, `QueryBuilder` |
-| [`@aurabase/storage`](../storage) | `StorageService` |
-| [`@aurabase/realtime`](../realtime) | `RealtimeService`, `AuraChannel`, `HeartbeatManager` |
-| [`@aurabase/functions`](../functions) | `FunctionsService` |
-| [`@aurabase/ai`](../ai) | `AiService` |
-| [`@aurabase/notifications`](../notifications) | `NotificationsService`, `NotificationsAdminService` |
-| [`@aurabase/gen`](../gen) | générateur CLI de types `Database` (dev-dependency, non inclus dans `aurabase`) |
-
-Tous ces packages (hors `@aurabase/gen`) sont des dépendances directes de `aurabase` : les installer séparément n'est utile que pour du tree-shaking ciblé ou pour composer votre propre client.
-
-## Documentation
-
-Cette page ne couvre que le rôle du package d'agrégation. Documentation de référence complète : voir le [README du dépôt](../../README.md).