@aurabase/aurabase-js 0.3.1 → 0.4.0

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

@@ -1,81 +0,0 @@
-import { BaseService, AuraClientLike, AuraResponse, NotificationSettings, NotificationStats, NotificationQueueStats, NotificationAttempt, NotificationDeadLetter, Notification, NotificationEvent, NotificationProviderLog, NotificationTemplatePreview, NotificationRule, SendNotificationRequest, BatchSendResponse, NotificationTemplate } from '@aurabase/core';
-export { AuraResponse, BatchSendResponse, Notification, NotificationAttempt, NotificationDeadLetter, NotificationEvent, NotificationProviderLog, NotificationQueueStats, NotificationRule, NotificationSettings, NotificationStats, NotificationTemplate, NotificationTemplatePreview, SendNotificationRequest } from '@aurabase/core';
-
-type NotificationChannel = 'email' | 'sms' | 'push' | 'webhook';
-type NotificationStatus = 'queued' | 'processing' | 'sent' | 'failed' | 'delivered' | 'expired' | 'dead_lettered';
-type CreateNotificationRuleRequest = {
-    name: string;
-    trigger_type: string;
-    condition?: Record<string, unknown>;
-    template_id?: string | null;
-    channel: NotificationChannel;
-    recipient_expr: string;
-    delay_seconds?: number;
-};
-declare class NotificationsService extends BaseService {
-    readonly admin: NotificationsAdminService;
-    constructor(client: AuraClientLike);
-    private get prefix();
-    send(channel: NotificationChannel, recipient: string, body: string, options?: {
-        subject?: string;
-        templateId?: string;
-        variables?: Record<string, unknown>;
-        metadata?: Record<string, unknown>;
-        idempotencyKey?: string;
-    }): Promise<AuraResponse<Notification>>;
-    sendBatch(items: SendNotificationRequest[]): Promise<AuraResponse<BatchSendResponse>>;
-    list(options?: {
-        channel?: NotificationChannel;
-        status?: NotificationStatus;
-        search?: string;
-        sort?: 'created_at' | 'updated_at' | 'status';
-        order?: 'asc' | 'desc';
-        limit?: number;
-        offset?: number;
-    }): Promise<AuraResponse<Notification[]>>;
-    get(id: string): Promise<AuraResponse<Notification>>;
-    listTemplates(): Promise<AuraResponse<NotificationTemplate[]>>;
-    getTemplate(id: string): Promise<AuraResponse<NotificationTemplate>>;
-    createTemplate(template: Omit<NotificationTemplate, 'id' | 'created_at' | 'updated_at'>): Promise<AuraResponse<NotificationTemplate>>;
-    updateTemplate(id: string, updates: Partial<Omit<NotificationTemplate, 'id' | 'created_at' | 'updated_at'>>): Promise<AuraResponse<NotificationTemplate>>;
-    deleteTemplate(id: string): Promise<AuraResponse<null>>;
-}
-declare class NotificationsAdminService extends BaseService {
-    constructor(client: AuraClientLike);
-    private get prefix();
-    private query;
-    getSettings(): Promise<AuraResponse<NotificationSettings>>;
-    updateSettings(settings: Partial<NotificationSettings>): Promise<AuraResponse<NotificationSettings>>;
-    getStats(options?: {
-        window?: string;
-        channel?: NotificationChannel;
-    }): Promise<AuraResponse<NotificationStats>>;
-    getQueue(): Promise<AuraResponse<NotificationQueueStats>>;
-    listAttempts(notificationId: string): Promise<AuraResponse<NotificationAttempt[]>>;
-    listDeadLetters(options?: {
-        channel?: NotificationChannel;
-        search?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<AuraResponse<NotificationDeadLetter[]>>;
-    retryDeadLetter(id: string): Promise<AuraResponse<Notification>>;
-    listEvents(options?: {
-        status?: 'received' | 'matched' | 'ignored' | 'failed' | 'enqueued';
-        limit?: number;
-        offset?: number;
-    }): Promise<AuraResponse<NotificationEvent[]>>;
-    listProviderLogs(options?: {
-        channel?: NotificationChannel;
-        status?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<AuraResponse<NotificationProviderLog[]>>;
-    previewTemplate(id: string, variables: Record<string, unknown>): Promise<AuraResponse<NotificationTemplatePreview>>;
-    listRules(): Promise<AuraResponse<NotificationRule[]>>;
-    createRule(rule: CreateNotificationRuleRequest): Promise<AuraResponse<NotificationRule>>;
-    getRule(id: string): Promise<AuraResponse<NotificationRule>>;
-    updateRule(id: string, updates: Partial<Omit<NotificationRule, 'id' | 'project_id' | 'created_at' | 'updated_at'>>): Promise<AuraResponse<NotificationRule>>;
-    deleteRule(id: string): Promise<AuraResponse<null>>;
-}
-
-export { NotificationsAdminService, NotificationsService };

package/packages/notifications/dist/index.js

@@ -1,125 +0,0 @@
-import { BaseService } from '@aurabase/core';
-
-// src/NotificationsService.ts
-var NotificationsService = class extends BaseService {
-  admin;
-  constructor(client) {
-    super(client);
-    this.admin = new NotificationsAdminService(client);
-  }
-  get prefix() {
-    return `/v1/notifications/${this.client.projectId}`;
-  }
-  // -- Send -------------------------------------------------------------------
-  async send(channel, recipient, body, options) {
-    return this.request("POST", `${this.prefix}/send`, {
-      channel,
-      recipient,
-      body,
-      subject: options?.subject,
-      template_id: options?.templateId,
-      variables: options?.variables,
-      metadata: options?.metadata,
-      idempotency_key: options?.idempotencyKey
-    });
-  }
-  async sendBatch(items) {
-    return this.request("POST", `${this.prefix}/send/batch`, { items });
-  }
-  // -- Notification history ---------------------------------------------------
-  async list(options) {
-    const params = new URLSearchParams();
-    if (options?.channel !== void 0) params.set("channel", options.channel);
-    if (options?.status !== void 0) params.set("status", options.status);
-    if (options?.search !== void 0) params.set("search", options.search);
-    if (options?.sort !== void 0) params.set("sort", options.sort);
-    if (options?.order !== void 0) params.set("order", options.order);
-    if (options?.limit !== void 0) params.set("limit", String(options.limit));
-    if (options?.offset !== void 0) params.set("offset", String(options.offset));
-    const qs = params.toString();
-    const sep = qs ? "?" : "";
-    return this.request("GET", `${this.prefix}${sep}${qs}`);
-  }
-  async get(id) {
-    return this.request("GET", `${this.prefix}/${id}`);
-  }
-  // -- Templates --------------------------------------------------------------
-  async listTemplates() {
-    return this.request("GET", `${this.prefix}/templates`);
-  }
-  async getTemplate(id) {
-    return this.request("GET", `${this.prefix}/templates/${id}`);
-  }
-  async createTemplate(template) {
-    return this.request("POST", `${this.prefix}/templates`, template);
-  }
-  async updateTemplate(id, updates) {
-    return this.request("PATCH", `${this.prefix}/templates/${id}`, updates);
-  }
-  async deleteTemplate(id) {
-    return this.request("DELETE", `${this.prefix}/templates/${id}`);
-  }
-};
-var NotificationsAdminService = class extends BaseService {
-  constructor(client) {
-    super(client);
-  }
-  get prefix() {
-    return `/v1/notifications/${this.client.projectId}`;
-  }
-  query(options) {
-    const params = new URLSearchParams();
-    for (const [key, value] of Object.entries(options ?? {})) {
-      if (value !== void 0 && value !== null && value !== "") params.set(key, String(value));
-    }
-    const qs = params.toString();
-    return qs ? `?${qs}` : "";
-  }
-  async getSettings() {
-    return this.request("GET", `${this.prefix}/settings`);
-  }
-  async updateSettings(settings) {
-    return this.request("PATCH", `${this.prefix}/settings`, settings);
-  }
-  async getStats(options) {
-    return this.request("GET", `${this.prefix}/stats${this.query(options)}`);
-  }
-  async getQueue() {
-    return this.request("GET", `${this.prefix}/queue`);
-  }
-  async listAttempts(notificationId) {
-    return this.request("GET", `${this.prefix}/${notificationId}/attempts`);
-  }
-  async listDeadLetters(options) {
-    return this.request("GET", `${this.prefix}/dead-letters${this.query(options)}`);
-  }
-  async retryDeadLetter(id) {
-    return this.request("POST", `${this.prefix}/dead-letters/${id}/retry`);
-  }
-  async listEvents(options) {
-    return this.request("GET", `${this.prefix}/events${this.query(options)}`);
-  }
-  async listProviderLogs(options) {
-    return this.request("GET", `${this.prefix}/providers/logs${this.query(options)}`);
-  }
-  async previewTemplate(id, variables) {
-    return this.request("POST", `${this.prefix}/templates/${id}/preview`, variables);
-  }
-  async listRules() {
-    return this.request("GET", `${this.prefix}/rules`);
-  }
-  async createRule(rule) {
-    return this.request("POST", `${this.prefix}/rules`, rule);
-  }
-  async getRule(id) {
-    return this.request("GET", `${this.prefix}/rules/${id}`);
-  }
-  async updateRule(id, updates) {
-    return this.request("PATCH", `${this.prefix}/rules/${id}`, updates);
-  }
-  async deleteRule(id) {
-    return this.request("DELETE", `${this.prefix}/rules/${id}`);
-  }
-};
-
-export { NotificationsAdminService, NotificationsService };

package/packages/notifications/package.json

@@ -1,60 +0,0 @@
-{
-  "name": "@aurabase/notifications",
-  "version": "0.3.0",
-  "description": "Service notifications multi-canal du SDK Aurabase (email, SMS, push, webhook, templates, règles)",
-  "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/notifications"
-  },
-  "homepage": "https://github.com/daylami555/aurabase/tree/main/aurabase-js/packages/notifications#readme",
-  "bugs": {
-    "url": "https://github.com/daylami555/aurabase/issues"
-  },
-  "keywords": [
-    "aurabase",
-    "baas",
-    "sdk",
-    "notifications"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run --passWithNoTests",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@aurabase/core": "workspace:*"
-  },
-  "devDependencies": {
-    "tsup": "catalog:",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
-  }
-}

package/packages/realtime/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/realtime/README.md

@@ -1,183 +0,0 @@
-# @aurabase/realtime
-
-Service temps réel du SDK Aurabase : une connexion WebSocket multiplexée sur des channels (`postgres_changes`, `broadcast`, `presence`).
-
-![npm](https://img.shields.io/npm/v/@aurabase/realtime) ![license](https://img.shields.io/badge/license-MIT-blue)
-
-> Pre-release — pas encore publié sur npm.
-
-Fait partie du SDK **[aurabase](../aurabase)**. Installé automatiquement avec `aurabase` ; ce package est publié séparément pour un usage ciblé / tree-shaking.
-
-## Installation
-
-```bash
-npm i @aurabase/realtime
-```
-
-> Dépend de `@aurabase/core`. Déjà inclus si vous utilisez le package `aurabase` — cette installation ciblée sert à composer votre propre client ou à limiter la taille du bundle. Nécessite un runtime avec `WebSocket` global (navigateur, ou Node avec un polyfill).
-
-## Usage
-
-`RealtimeService` est exposé par le client principal sous `aura.realtime`, et `aura.channel(name)` est un raccourci pour `aura.realtime.channel(name)`.
-
-```ts
-import { createClient } from 'aurabase'
-
-const aura = createClient('http://localhost:8080', 'my-project', 'aura_anon_xxx')
-```
-
-### Connexion
-
-```ts
-const unsubscribe = aura.realtime.onStateChange((state) => {
-  console.log('realtime state:', state) // 'disconnected' | 'connecting' | 'connected' | 'reconnecting'
-})
-
-aura.realtime.connect()
-console.log(aura.realtime.connectionState)
-
-// Désactive la reconnexion auto (backoff + jitter), ou borne le nombre de tentatives.
-aura.realtime.setAutoReconnect(true, 5)
-
-// Pousse un nouveau token sur la connexion existante (sans reconnexion).
-aura.realtime.refreshToken('new-access-token')
-```
-
-Un heartbeat applicatif (`ping`) est envoyé toutes les **25 secondes** via un Worker dédié, pour éviter le throttling des timers par les navigateurs en arrière-plan. La reconnexion automatique utilise un backoff exponentiel avec jitter.
-
-### `postgres_changes`
-
-```ts
-const channel = aura.channel('db:public.posts')
-  .on('postgres_changes', { event: 'INSERT', schema: 'public', table: 'posts' }, (payload) => {
-    console.log('insert:', payload)
-  })
-  .subscribe((status, err) => {
-    console.log(status, err) // 'SUBSCRIBED' | 'CLOSED' | 'CHANNEL_ERROR' | 'TIMED_OUT'
-  })
-```
-
-## Filtres de colonne (`postgres_changes`)
-
-`postgres_changes` accepte un champ `filter` (syntaxe PostgREST/Supabase : `"column=operator.value"`) pour ne recevoir que les events dont la ligne matche la condition :
-
-```ts
-aura.channel('room')
-  .on('postgres_changes', {
-    event: 'INSERT',
-    schema: 'public',
-    table: 'messages',
-    filter: 'room_id=eq.42',
-  }, (e) => console.log(e))
-  .subscribe()
-```
-
-Opérateurs supportés : `eq, neq, lt, lte, gt, gte, in, like, ilike, is, match, imatch, isdistinct`.
-
-```ts
-// Comparaison numérique.
-{ event: '*', schema: 'public', table: 'items', filter: 'qty=gt.5' }
-
-// Appartenance à un ensemble — les virgules internes à `in.(...)` ne
-// séparent PAS des conditions AND (voir plus bas).
-{ event: '*', schema: 'public', table: 'orders', filter: 'status=in.(open,pending)' }
-
-// Motif SQL LIKE (% / _).
-{ event: '*', schema: 'public', table: 'users', filter: 'name=like.jo%' }
-
-// Négation — préfixe `not.` devant l'opérateur.
-{ event: '*', schema: 'public', table: 'orders', filter: 'status=not.eq.done' }
-
-// AND par virgules — chaque condition séparée par `,` (hors `in.(...)`).
-{ event: '*', schema: 'public', table: 'items', filter: 'room_id=eq.42,qty=gt.5' }
-```
-
-À savoir :
-
-- **Le serveur `aura-realtime` est autoritaire** : il applique déjà le filtre avant d'envoyer l'event sur le socket. Le client réapplique la même logique en second rideau (defense-in-depth) — il ne peut que sur-filtrer, jamais laisser passer un event que le serveur aurait dû exclure.
-- **Fail-closed** : une condition non parsable (syntaxe invalide, opérateur inconnu, trop de valeurs `in`, pattern `match`/`imatch` trop long) exclut l'event plutôt que de le laisser passer.
-- **DELETE** : le filtre est évalué sur **l'ancienne ligne** (`old_record`), pas sur la nouvelle (qui n'existe plus). Les colonnes disponibles dans `old_record` dépendent du `REPLICA IDENTITY` de la table (`DEFAULT` : seule la clé primaire ; `FULL` : toutes les colonnes) — un filtre sur une colonne absente de `old_record` échoue à matcher (résultat non évaluable ⇒ exclusion, jamais inversée par `not.`), **sauf `is.null` et `isdistinct`** qui traitent une colonne absente comme `NULL` et peuvent donc matcher même si la colonne n'est pas présente dans `old_record`.
-- `schema` (et `table`) doivent correspondre exactement au schéma/table réels tels qu'envoyés par le serveur dans l'event — un `schema` incorrect exclut silencieusement tous les events de ce channel.
-
-### Broadcast
-
-```ts
-const room = aura.realtime.channel('room-1', { broadcast: { ack: true, self: true } })
-
-room
-  .on('broadcast', { event: 'cursor-pos' }, (payload) => {
-    console.log(payload)
-  })
-  .subscribe()
-
-// 'ok' | 'timeout' | 'error' — résout à l'ACK serveur si broadcast.ack est activé sur le channel.
-const status = await room.send({ type: 'broadcast', event: 'cursor-pos', payload: { x: 100, y: 200 } })
-```
-
-#### Broadcast HTTP (sans WebSocket)
-
-Émet un broadcast via REST, sans connexion WebSocket ouverte — utile côté serveur/edge.
-
-```ts
-// POST /v1/realtime/{projectId}/broadcast — pas besoin de connect().
-const { error } = await aura.realtime.httpBroadcast('room-1', 'cursor-pos', { x: 10, y: 20 })
-if (error) console.error(error) // 4xx / rate-limit surfacés proprement
-```
-
-Le nom de canal est préfixé par le projet automatiquement s'il ne l'est pas déjà.
-
-### Canaux privés (`setAuth`)
-
-Les canaux privés (`{ private: true }`) sont autorisés par les policies RLS côté serveur à
-partir du JWT courant. Fixez/rafraîchissez ce token via `setAuth()` **avant** de vous abonner :
-
-```ts
-// Utilise le token fourni (ou, sans argument, reprend client.authStore.token).
-aura.realtime.setAuth(session.access_token)
-
-const secret = aura.realtime
-  .channel('secret-room', { private: true })
-  .on('broadcast', { event: 'msg' }, console.log)
-  .subscribe((status, err) => {
-    if (status === 'CHANNEL_ERROR') console.error('Refusé par la policy RLS', err)
-  })
-```
-
-`setAuth()` propage `{ type: 'access_token' }` sur une connexion ouverte (dédupliqué, sans
-reconnexion). Un token non autorisé par la policy provoque un `CHANNEL_ERROR` à la souscription.
-
-### Presence
-
-```ts
-const lobby = aura.channel('room-1', { config: { presence: { key: 'user-1' } } })
-
-lobby
-  .on('presence', { event: 'sync' }, () => {
-    console.log(lobby.presenceState())
-  })
-  .on('presence', { event: 'join' }, console.log)
-  .on('presence', { event: 'leave' }, console.log)
-  .subscribe()
-
-await lobby.track({ online_at: new Date().toISOString() })
-await lobby.untrack()
-```
-
-### Nettoyage
-
-```ts
-aura.realtime.getChannels()
-aura.realtime.removeChannel('room-1')
-aura.realtime.removeAllChannels()
-aura.realtime.disconnect()
-unsubscribe()
-```
-
-## Limitations
-
-- Pas de limitation de débit configurable (`eventsPerSecond`) sur le broadcast (côté client).
-- La reconnexion réabonne les channels existants mais ne garantit pas la livraison des événements manqués pendant la coupure (au-delà du rejeu par `since_id` quand le serveur le supporte).
-
-## Documentation
-
-Référence complète du SDK (tous les services, types partagés, SSR) : [README racine](../../README.md).