@aurabase/aurabase-js 0.3.1 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/README.md +26 -795
  2. package/{packages/aurabase/dist/AuraClient-DAtDbfPB.d.ts → dist/AuraClient-BcFE8u1v.d.cts} +1 -1
  3. package/{packages/aurabase/dist/AuraClient-DAtDbfPB.d.cts → dist/AuraClient-BcFE8u1v.d.ts} +1 -1
  4. package/{packages/aurabase/dist → dist}/index.d.cts +1 -1
  5. package/{packages/aurabase/dist → dist}/index.d.ts +1 -1
  6. package/{packages/aurabase/dist → dist}/ssr.d.cts +1 -1
  7. package/{packages/aurabase/dist → dist}/ssr.d.ts +1 -1
  8. package/package.json +72 -82
  9. package/.changeset/config.json +0 -11
  10. package/CHANGELOG.md +0 -30
  11. package/packages/ai/LICENSE +0 -21
  12. package/packages/ai/README.md +0 -106
  13. package/packages/ai/dist/index.cjs +0 -229
  14. package/packages/ai/dist/index.d.cts +0 -139
  15. package/packages/ai/dist/index.d.ts +0 -139
  16. package/packages/ai/dist/index.js +0 -226
  17. package/packages/ai/package.json +0 -61
  18. package/packages/aurabase/LICENSE +0 -21
  19. package/packages/aurabase/README.md +0 -64
  20. package/packages/aurabase/package.json +0 -80
  21. package/packages/aurabase/vitest.e2e.config.ts +0 -9
  22. package/packages/auth/LICENSE +0 -21
  23. package/packages/auth/README.md +0 -215
  24. package/packages/auth/dist/index.cjs +0 -1175
  25. package/packages/auth/dist/index.d.cts +0 -397
  26. package/packages/auth/dist/index.d.ts +0 -397
  27. package/packages/auth/dist/index.js +0 -1170
  28. package/packages/auth/package.json +0 -61
  29. package/packages/core/LICENSE +0 -21
  30. package/packages/core/README.md +0 -132
  31. package/packages/core/dist/index.cjs +0 -695
  32. package/packages/core/dist/index.d.cts +0 -1137
  33. package/packages/core/dist/index.d.ts +0 -1137
  34. package/packages/core/dist/index.js +0 -673
  35. package/packages/core/package.json +0 -57
  36. package/packages/db/LICENSE +0 -21
  37. package/packages/db/README.md +0 -152
  38. package/packages/db/VENDORED.md +0 -93
  39. package/packages/db/dist/index.cjs +0 -544
  40. package/packages/db/dist/index.d.cts +0 -1111
  41. package/packages/db/dist/index.d.ts +0 -1111
  42. package/packages/db/dist/index.js +0 -541
  43. package/packages/db/package.json +0 -62
  44. package/packages/functions/LICENSE +0 -21
  45. package/packages/functions/README.md +0 -96
  46. package/packages/functions/dist/index.cjs +0 -173
  47. package/packages/functions/dist/index.d.cts +0 -81
  48. package/packages/functions/dist/index.d.ts +0 -81
  49. package/packages/functions/dist/index.js +0 -168
  50. package/packages/functions/package.json +0 -60
  51. package/packages/gen/LICENSE +0 -21
  52. package/packages/gen/README.md +0 -84
  53. package/packages/gen/dist/cli.cjs +0 -334
  54. package/packages/gen/dist/cli.d.cts +0 -1
  55. package/packages/gen/dist/cli.d.ts +0 -1
  56. package/packages/gen/dist/cli.js +0 -332
  57. package/packages/gen/dist/index.cjs +0 -257
  58. package/packages/gen/dist/index.d.cts +0 -12
  59. package/packages/gen/dist/index.d.ts +0 -12
  60. package/packages/gen/dist/index.js +0 -255
  61. package/packages/gen/package.json +0 -66
  62. package/packages/notifications/LICENSE +0 -21
  63. package/packages/notifications/README.md +0 -134
  64. package/packages/notifications/dist/index.cjs +0 -128
  65. package/packages/notifications/dist/index.d.cts +0 -81
  66. package/packages/notifications/dist/index.d.ts +0 -81
  67. package/packages/notifications/dist/index.js +0 -125
  68. package/packages/notifications/package.json +0 -60
  69. package/packages/realtime/LICENSE +0 -21
  70. package/packages/realtime/README.md +0 -183
  71. package/packages/realtime/dist/index.cjs +0 -977
  72. package/packages/realtime/dist/index.d.cts +0 -259
  73. package/packages/realtime/dist/index.d.ts +0 -259
  74. package/packages/realtime/dist/index.js +0 -973
  75. package/packages/realtime/package.json +0 -60
  76. package/packages/storage/LICENSE +0 -21
  77. package/packages/storage/README.md +0 -141
  78. package/packages/storage/dist/index.cjs +0 -333
  79. package/packages/storage/dist/index.d.cts +0 -185
  80. package/packages/storage/dist/index.d.ts +0 -185
  81. package/packages/storage/dist/index.js +0 -329
  82. package/packages/storage/package.json +0 -60
  83. /package/{packages/aurabase/dist → dist}/index.cjs +0 -0
  84. /package/{packages/aurabase/dist → dist}/index.js +0 -0
  85. /package/{packages/aurabase/dist → dist}/ssr.cjs +0 -0
  86. /package/{packages/aurabase/dist → dist}/ssr.js +0 -0
@@ -12,7 +12,7 @@ import { NotificationsService } from '@aurabase/notifications';
12
12
  *
13
13
  * @example
14
14
  * ```ts
15
- * import { createClient } from 'aurabase'
15
+ * import { createClient } from '@aurabase/aurabase-js'
16
16
  * const aura = createClient('http://localhost:8080', 'my-project-id')
17
17
  * const { data } = await aura.db.from('posts').eq('published', true)
18
18
  * ```
@@ -12,7 +12,7 @@ import { NotificationsService } from '@aurabase/notifications';
12
12
  *
13
13
  * @example
14
14
  * ```ts
15
- * import { createClient } from 'aurabase'
15
+ * import { createClient } from '@aurabase/aurabase-js'
16
16
  * const aura = createClient('http://localhost:8080', 'my-project-id')
17
17
  * const { data } = await aura.db.from('posts').eq('published', true)
18
18
  * ```
@@ -1,4 +1,4 @@
1
- import { A as AuraClient } from './AuraClient-DAtDbfPB.cjs';
1
+ import { A as AuraClient } from './AuraClient-BcFE8u1v.cjs';
2
2
  import { AuraClientOptions } from '@aurabase/core';
3
3
  export { AdminCreateUserRequest, AdminUpdateUserRequest, AdminUser, AuditLogEntry, AuraClientOptions, AuraError, AuraErrorCode, AuraObservabilityEvent, AuraResponse, AuthChangePayload, AuthEvent, AuthSettings, BaseAuthStore, BatchSendResponse, BroadcastFilter, BroadcastPayload, ChannelConfig, ChatMessage, ChatResponse, CountMode, CronJob, EmailTemplateUpdate, EmbedRequest, EmbedResponse, FileEntry, FilterOp, FunctionDef, IdentityInfo, Job, LocalAuthStore, LoginResponse, MagicLinkRequest, Meta, MfaChallenge, MfaEnrollResponse, MfaVerifyRequest, Notification, NotificationAttempt, NotificationDeadLetter, NotificationEvent, NotificationProviderLog, NotificationQueueStats, NotificationRule, NotificationSettings, NotificationStats, NotificationTemplate, NotificationTemplatePreview, OAuthSignInOptions, PasswordResetRequest, PostgresChangesFilter, PresenceFilter, PresenceInfo, PresenceState, QueryFilter, QueryOptions, RagIngestRequest, RagIngestResponse, RagRequest, RagResponse, RealtimeEvent, RealtimeListenType, RealtimeSubscribeStatus, SchemaColumn, SchemaTable, SemanticSearchResult, SendNotificationRequest, SessionInfo, SignInRequest, SignUpRequest, StorageBucket, TokenPair, UpdateUserRequest, UploadResult, User, isAuraError } from '@aurabase/core';
4
4
  export { DatabaseService, QueryBuilder } from '@aurabase/db';
@@ -1,4 +1,4 @@
1
- import { A as AuraClient } from './AuraClient-DAtDbfPB.js';
1
+ import { A as AuraClient } from './AuraClient-BcFE8u1v.js';
2
2
  import { AuraClientOptions } from '@aurabase/core';
3
3
  export { AdminCreateUserRequest, AdminUpdateUserRequest, AdminUser, AuditLogEntry, AuraClientOptions, AuraError, AuraErrorCode, AuraObservabilityEvent, AuraResponse, AuthChangePayload, AuthEvent, AuthSettings, BaseAuthStore, BatchSendResponse, BroadcastFilter, BroadcastPayload, ChannelConfig, ChatMessage, ChatResponse, CountMode, CronJob, EmailTemplateUpdate, EmbedRequest, EmbedResponse, FileEntry, FilterOp, FunctionDef, IdentityInfo, Job, LocalAuthStore, LoginResponse, MagicLinkRequest, Meta, MfaChallenge, MfaEnrollResponse, MfaVerifyRequest, Notification, NotificationAttempt, NotificationDeadLetter, NotificationEvent, NotificationProviderLog, NotificationQueueStats, NotificationRule, NotificationSettings, NotificationStats, NotificationTemplate, NotificationTemplatePreview, OAuthSignInOptions, PasswordResetRequest, PostgresChangesFilter, PresenceFilter, PresenceInfo, PresenceState, QueryFilter, QueryOptions, RagIngestRequest, RagIngestResponse, RagRequest, RagResponse, RealtimeEvent, RealtimeListenType, RealtimeSubscribeStatus, SchemaColumn, SchemaTable, SemanticSearchResult, SendNotificationRequest, SessionInfo, SignInRequest, SignUpRequest, StorageBucket, TokenPair, UpdateUserRequest, UploadResult, User, isAuraError } from '@aurabase/core';
4
4
  export { DatabaseService, QueryBuilder } from '@aurabase/db';
@@ -1,4 +1,4 @@
1
- import { A as AuraClient } from './AuraClient-DAtDbfPB.cjs';
1
+ import { A as AuraClient } from './AuraClient-BcFE8u1v.cjs';
2
2
  import { SerializeCookieOptions, AuraClientOptions } from '@aurabase/core';
3
3
  export { SerializeCookieOptions, parseCookieHeader, serializeCookieHeader } from '@aurabase/core';
4
4
  import '@aurabase/auth';
@@ -1,4 +1,4 @@
1
- import { A as AuraClient } from './AuraClient-DAtDbfPB.js';
1
+ import { A as AuraClient } from './AuraClient-BcFE8u1v.js';
2
2
  import { SerializeCookieOptions, AuraClientOptions } from '@aurabase/core';
3
3
  export { SerializeCookieOptions, parseCookieHeader, serializeCookieHeader } from '@aurabase/core';
4
4
  import '@aurabase/auth';
package/package.json CHANGED
@@ -1,90 +1,80 @@
1
1
  {
2
2
  "name": "@aurabase/aurabase-js",
3
- "version": "0.3.1",
4
- "description": "Aurabase JavaScript SDK",
5
- "license": "ISC",
6
- "author": "Daylami Affane",
3
+ "version": "0.4.0",
4
+ "description": "Official JavaScript/TypeScript client for Aurabase BaaS",
7
5
  "type": "module",
8
- "main": "index.js",
9
- "scripts": {
10
- "build": "pnpm -r build",
11
- "typecheck": "pnpm -r typecheck",
12
- "test": "pnpm -r test",
13
- "test:e2e": "pnpm --filter aurabase run test:e2e"
14
- },
15
- "dependencies": {},
16
- "devDependencies": {
17
- "acorn": "^8.16.0",
18
- "any-promise": "^1.3.0",
19
- "assertion-error": "^2.0.1",
20
- "bundle-require": "^5.1.0",
21
- "cac": "^6.7.14",
22
- "chai": "^6.2.2",
23
- "chokidar": "^4.0.3",
24
- "commander": "^4.1.1",
25
- "confbox": "^0.1.8",
26
- "consola": "^3.4.2",
27
- "convert-source-map": "^2.0.0",
28
- "debug": "^4.4.3",
29
- "detect-libc": "^2.1.2",
30
- "es-module-lexer": "^2.1.0",
31
- "esbuild": "^0.28.1",
32
- "estree-walker": "^3.0.3",
33
- "expect-type": "^1.3.0",
34
- "fdir": "^6.5.0",
35
- "fix-dts-default-cjs-exports": "^1.0.1",
36
- "fsevents": "^2.3.3",
37
- "joycon": "^3.1.1",
38
- "lightningcss": "^1.32.0",
39
- "lightningcss-darwin-arm64": "^1.32.0",
40
- "lilconfig": "^3.1.3",
41
- "lines-and-columns": "^1.2.4",
42
- "load-tsconfig": "^0.2.5",
43
- "magic-string": "^0.30.21",
44
- "mlly": "^1.8.2",
45
- "ms": "^2.1.3",
46
- "mz": "^2.7.0",
47
- "nanoid": "^3.3.12",
48
- "object-assign": "^4.1.1",
49
- "obug": "^2.1.1",
50
- "pathe": "^2.0.3",
51
- "picocolors": "^1.1.1",
52
- "picomatch": "^4.0.4",
53
- "pirates": "^4.0.7",
54
- "pkg-types": "^1.3.1",
55
- "postcss": "^8.5.15",
56
- "postcss-load-config": "^6.0.1",
57
- "readdirp": "^4.1.2",
58
- "resolve-from": "^5.0.0",
59
- "rolldown": "^1.0.3",
60
- "rollup": "^4.60.0",
61
- "siginfo": "^2.0.0",
62
- "source-map": "^0.7.6",
63
- "source-map-js": "^1.2.1",
64
- "stackback": "^0.0.2",
65
- "std-env": "^4.1.0",
66
- "sucrase": "^3.35.1",
67
- "thenify": "^3.3.1",
68
- "thenify-all": "^1.6.0",
69
- "tinybench": "^2.9.0",
70
- "tinyexec": "^0.3.2",
71
- "tinyglobby": "^0.2.17",
72
- "tinyrainbow": "^3.1.0",
73
- "tree-kill": "^1.2.2",
74
- "ts-interface-checker": "^0.1.13",
75
- "tsup": "^8.5.1",
76
- "typescript": "^5.9.3",
77
- "ufo": "^1.6.3",
78
- "vite": "^8.0.16",
79
- "vitest": "^4.1.9",
80
- "why-is-node-running": "^2.3.0"
6
+ "main": "dist/index.cjs",
7
+ "module": "dist/index.js",
8
+ "types": "dist/index.d.ts",
9
+ "exports": {
10
+ ".": {
11
+ "import": {
12
+ "types": "./dist/index.d.ts",
13
+ "default": "./dist/index.js"
14
+ },
15
+ "require": {
16
+ "types": "./dist/index.d.cts",
17
+ "default": "./dist/index.cjs"
18
+ }
19
+ },
20
+ "./ssr": {
21
+ "import": {
22
+ "types": "./dist/ssr.d.ts",
23
+ "default": "./dist/ssr.js"
24
+ },
25
+ "require": {
26
+ "types": "./dist/ssr.d.cts",
27
+ "default": "./dist/ssr.cjs"
28
+ }
29
+ }
81
30
  },
31
+ "sideEffects": false,
32
+ "files": [
33
+ "dist",
34
+ "README.md",
35
+ "LICENSE"
36
+ ],
82
37
  "engines": {
83
38
  "node": ">=20.0.0"
84
39
  },
85
- "pnpm": {
86
- "overrides": {
87
- "esbuild": "^0.28.1"
88
- }
40
+ "license": "MIT",
41
+ "author": "Aurabase",
42
+ "repository": {
43
+ "type": "git",
44
+ "url": "git+https://github.com/daylami555/aurabase.git",
45
+ "directory": "aurabase-js/packages/aurabase"
46
+ },
47
+ "homepage": "https://github.com/daylami555/aurabase/tree/main/aurabase-js/packages/aurabase#readme",
48
+ "bugs": {
49
+ "url": "https://github.com/daylami555/aurabase/issues"
50
+ },
51
+ "keywords": [
52
+ "aurabase",
53
+ "baas",
54
+ "backend-as-a-service",
55
+ "sdk",
56
+ "client"
57
+ ],
58
+ "dependencies": {
59
+ "@aurabase/core": "0.4.0",
60
+ "@aurabase/db": "0.4.0",
61
+ "@aurabase/realtime": "0.4.0",
62
+ "@aurabase/auth": "0.4.0",
63
+ "@aurabase/storage": "0.4.0",
64
+ "@aurabase/functions": "0.4.0",
65
+ "@aurabase/ai": "0.4.0",
66
+ "@aurabase/notifications": "0.4.0"
67
+ },
68
+ "devDependencies": {
69
+ "tsup": "^8.0.0",
70
+ "typescript": "^5.5.0",
71
+ "vitest": "^4.1.6"
72
+ },
73
+ "scripts": {
74
+ "build": "tsup",
75
+ "test": "vitest run && tsc --noEmit -p tsconfig.test-d.json",
76
+ "test:types": "tsc --noEmit -p tsconfig.test-d.json",
77
+ "test:e2e": "RUN_E2E=true vitest run --config vitest.e2e.config.ts tests/integration.test.ts",
78
+ "typecheck": "tsc --noEmit"
89
79
  }
90
- }
80
+ }
@@ -1,11 +0,0 @@
1
- {
2
- "$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
3
- "changelog": "@changesets/cli/changelog",
4
- "commit": false,
5
- "fixed": [["@aurabase/*", "aurabase"]],
6
- "linked": [],
7
- "access": "restricted",
8
- "baseBranch": "main",
9
- "updateInternalDependencies": "patch",
10
- "ignore": []
11
- }
package/CHANGELOG.md DELETED
@@ -1,30 +0,0 @@
1
- # Changelog
2
-
3
- Toutes les modifications notables du SDK `aurabase-js` (versions synchronisées, mode fixed).
4
-
5
- ## [Unreleased]
6
-
7
- ### Added
8
- - Filtre de colonne complet sur `postgres_changes` (champ `filter`, syntaxe PostgREST/Supabase `"column=operator.value"`) : opérateurs `eq, neq, lt, lte, gt, gte, in, like, ilike, is, match, imatch, isdistinct`, négation `not.`, AND par virgules (hors `in.(...)`), filtrage serveur autoritaire + fallback client fail-closed en second rideau, `DELETE` évalué sur l'ancienne ligne.
9
- - `db.rpc()` (appel de fonctions Postgres, builder filtrable, options `count`/`head`/`get`, typage via `@aurabase/gen` `Functions`) ; introspection backend des fonctions (`SchemaDefinition.functions`).
10
- - Transformations d'image côté Storage : `getPublicUrl()`/`download()`/`createSignedUrl()` acceptent `{ transform: ImageTransform }` (`width`/`height`/`resize`/`quality`/`format`), durcissement backend (flag projet `img_transform_enabled`, borne 2500px, `quality` JPEG-only) et cache serveur des dérivés (header `x-aura-cache: HIT|MISS`).
11
-
12
- ## [0.3.0] — 2026-07-12
13
-
14
- ### Added
15
- - Types de base de données générés : package `@aurabase/gen` (CLI `aurabase-gen`) + inférence type-level (`createClient<Database>`, select/filtres/mutations typés).
16
- - Parité auth : `getClaims` (vérif JWT locale RS256/ES256 anti-alg-confusion + fallback), flux PKCE (`flowType: 'pkce'`), méthodes admin (users/sessions/templates/audit/stats).
17
- - Documentation de distribution : README autonome par package, métadonnées npm complètes, LICENSE MIT, CHANGELOG, process de release.
18
-
19
- ### Changed
20
- - Résilience réseau consolidée (retry full-jitter GET/HEAD, `Retry-After` plafonné, timeout par tentative, refresh single-flight + commit-guard anti-race).
21
- - SSR : chunking de cookies (3600), parité `getAll/setAll` avec `@supabase/ssr`.
22
- - `signInWithOAuth` retourne `{ url }` ; mutations DB ciblées par `id`.
23
-
24
- ### Fixed
25
- - Durcissement session/realtime/storage/functions (voir historique de branche).
26
-
27
- ## [0.2.0]
28
-
29
- ### Added
30
- - Passage en monorepo pnpm : 10 packages (`@aurabase/{core,auth,db,storage,realtime,functions,ai,notifications,gen}` + méta `aurabase`), surface publique test-gardée.
@@ -1,21 +0,0 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Aurabase
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
@@ -1,106 +0,0 @@
1
- # @aurabase/ai
2
-
3
- Service IA du SDK Aurabase : chat, embeddings, RAG (retrieval-augmented generation), recherche sémantique et conversion langage naturel → SQL.
4
-
5
- ![npm](https://img.shields.io/npm/v/@aurabase/ai) ![license](https://img.shields.io/badge/license-MIT-blue)
6
-
7
- > Pre-release — pas encore publié sur npm.
8
-
9
- Fait partie du SDK **[aurabase](../aurabase)**. Installé automatiquement avec `aurabase` ; ce package est publié séparément pour un usage ciblé / tree-shaking.
10
-
11
- Sans équivalent 1st-party chez Supabase, Appwrite ou Firebase : `@aurabase/ai` est un **différenciateur** du SDK, pas une simple parité.
12
-
13
- ## Installation
14
-
15
- ```bash
16
- npm i @aurabase/ai
17
- ```
18
-
19
- > Ce package dépend de `@aurabase/core` (`workspace:*` en interne, résolu en semver côté npm). Si vous utilisez déjà le package `aurabase`, `@aurabase/ai` est déjà inclus — cette installation ciblée n'est utile que pour composer votre propre client ou limiter la taille du bundle.
20
-
21
- ## Usage
22
-
23
- Dans l'usage courant, `AiService` n'est jamais instancié directement : il est exposé par le client principal sous `aura.ai`.
24
-
25
- ```ts
26
- import { createClient } from 'aurabase'
27
-
28
- const aura = createClient('http://localhost:8080', 'my-project', 'aura_anon_xxx')
29
- ```
30
-
31
- ### Chat
32
-
33
- Réponse complète en un seul appel — pas de streaming SSE/token-par-token (voir Limitations).
34
-
35
- ```ts
36
- const { data, error } = await aura.ai.chat(
37
- [{ role: 'user', content: 'Résume ce texte en une phrase.' }],
38
- { model: 'gpt-4o-mini', temperature: 0.2, max_tokens: 200 },
39
- )
40
-
41
- if (error) throw error
42
- console.log(data!.content)
43
- ```
44
-
45
- ### Embeddings
46
-
47
- ```ts
48
- const { data: embedding } = await aura.ai.embed({
49
- text: 'Aurabase est une plateforme Backend-as-a-Service.',
50
- namespace: 'docs',
51
- })
52
-
53
- console.log(embedding!.dimensions)
54
- ```
55
-
56
- ### RAG — ingestion puis question/réponse
57
-
58
- ```ts
59
- await aura.ai.ragIngest({
60
- namespace: 'docs',
61
- content: 'Aurabase expose un service de fonctions edge invocables via aura.functions.invoke().',
62
- })
63
-
64
- const { data: answer } = await aura.ai.rag({
65
- question: 'Comment invoquer une edge function ?',
66
- namespace: 'docs',
67
- })
68
-
69
- console.log(answer!.answer, answer!.sources)
70
- ```
71
-
72
- ### Recherche sémantique
73
-
74
- ```ts
75
- const { data: results } = await aura.ai.semanticSearch('invocation de fonction', 'docs', {
76
- top_k: 5,
77
- threshold: 0.75,
78
- })
79
-
80
- for (const r of results ?? []) {
81
- console.log(r.similarity, r.content)
82
- }
83
- ```
84
-
85
- ### NL2SQL
86
-
87
- ```ts
88
- const schema = 'CREATE TABLE posts (id uuid, title text, published boolean);'
89
-
90
- const { data: query } = await aura.ai.nl2sql('Combien de posts sont publiés ?', schema, {
91
- dialect: 'postgres',
92
- })
93
-
94
- console.log(query!.sql, query!.explanation)
95
- ```
96
-
97
- ## Limitations
98
-
99
- - Pas de streaming de chat (SSE / token-par-token) : `chat()` résout une fois la réponse complète générée.
100
- - Pas de tool/function calling : le modèle ne peut pas invoquer d'outils côté client.
101
- - Pas de gestion de namespaces RAG (création/liste/suppression) : un namespace existe implicitement dès le premier `ragIngest()`, sans API de cycle de vie dédiée.
102
- - Pas de suivi d'usage/coût par requête au-delà des champs `input_tokens`/`output_tokens` optionnels de `ChatResponse`.
103
-
104
- ## Documentation
105
-
106
- Référence complète du SDK (tous les services, types partagés, SSR) : [README racine](../../README.md).
@@ -1,229 +0,0 @@
1
- 'use strict';
2
-
3
- var core = require('@aurabase/core');
4
-
5
- // src/AiService.ts
6
-
7
- // src/sse.ts
8
- async function* parseSSE(stream) {
9
- const reader = stream.getReader();
10
- const decoder = new TextDecoder();
11
- let buffer = "";
12
- let eventName = "message";
13
- let dataLines = [];
14
- const consumeLine = (raw) => {
15
- const line = raw.endsWith("\r") ? raw.slice(0, -1) : raw;
16
- if (line === "") {
17
- if (dataLines.length === 0) {
18
- eventName = "message";
19
- return null;
20
- }
21
- const msg = { event: eventName, data: dataLines.join("\n") };
22
- eventName = "message";
23
- dataLines = [];
24
- return msg;
25
- }
26
- if (line.startsWith(":")) return null;
27
- const colon = line.indexOf(":");
28
- let field;
29
- let value;
30
- if (colon === -1) {
31
- field = line;
32
- value = "";
33
- } else {
34
- field = line.slice(0, colon);
35
- value = line.slice(colon + 1);
36
- if (value.startsWith(" ")) value = value.slice(1);
37
- }
38
- if (field === "event") eventName = value;
39
- else if (field === "data") dataLines.push(value);
40
- return null;
41
- };
42
- try {
43
- for (; ; ) {
44
- const { done, value } = await reader.read();
45
- if (done) break;
46
- buffer += decoder.decode(value, { stream: true });
47
- let idx;
48
- while ((idx = buffer.indexOf("\n")) !== -1) {
49
- const raw = buffer.slice(0, idx);
50
- buffer = buffer.slice(idx + 1);
51
- const msg = consumeLine(raw);
52
- if (msg) yield msg;
53
- }
54
- }
55
- buffer += decoder.decode();
56
- if (buffer.length > 0) {
57
- const msg = consumeLine(buffer);
58
- if (msg) yield msg;
59
- }
60
- if (dataLines.length > 0) {
61
- yield { event: eventName, data: dataLines.join("\n") };
62
- }
63
- } finally {
64
- reader.releaseLock();
65
- }
66
- }
67
-
68
- // src/AiService.ts
69
- var AiService = class extends core.BaseService {
70
- constructor(client) {
71
- super(client);
72
- }
73
- get prefix() {
74
- return `/v1/ai/${this.client.projectId}`;
75
- }
76
- /**
77
- * Send a chat completion request.
78
- */
79
- async chat(messages, options) {
80
- return this.request("POST", `${this.prefix}/chat`, {
81
- messages,
82
- ...options
83
- });
84
- }
85
- /**
86
- * Chat completion streamé (SSE). Renvoie un `AsyncIterable` de deltas de tokens,
87
- * consommable par `for await (const { delta } of ai.chatStream(msgs)) { … }`.
88
- *
89
- * Court-circuite volontairement le pipeline JSON (`@aurabase/core/fetch.ts`) et
90
- * emprunte le chemin transport BRUT `client.fetchFn` (patron `StorageService.download`) :
91
- * - refresh proactif du token expiré (même règle que `download`, marge 30 s) ;
92
- * - pose manuelle de `Authorization: Bearer` + `apikey`, `Accept: text/event-stream` ;
93
- * - lecture de `res.body` via `parseSSE`, mapping des events serveur :
94
- * `delta` (`{ content }`) → `yield { delta }`, `error` (`{ error }`) → lève une
95
- * `AuraError`, `done` → termine l'itération.
96
- *
97
- * `options.signal` interrompt proprement le flux (annulation du `fetch` + fin
98
- * d'itération sans throw). Sur `!res.ok`, lève `AuraError(res.status)`.
99
- *
100
- * Backend route: POST /v1/ai/{project_id}/chat/stream
101
- */
102
- async *chatStream(messages, options) {
103
- const client = this.client;
104
- const store = client.authStore;
105
- if (store.token && store.refreshToken && core.isTokenExpired(store.token, 30)) {
106
- await core.refreshOnce(client);
107
- }
108
- const headers = {
109
- "Content-Type": "application/json",
110
- Accept: "text/event-stream"
111
- };
112
- if (store.token) headers["Authorization"] = `Bearer ${store.token}`;
113
- if (client.apiKey) headers["apikey"] = client.apiKey;
114
- const body = JSON.stringify({
115
- messages,
116
- model: options?.model,
117
- temperature: options?.temperature,
118
- max_tokens: options?.max_tokens
119
- });
120
- try {
121
- const res = await client.fetchFn(this.url(`${this.prefix}/chat/stream`), {
122
- method: "POST",
123
- headers,
124
- body,
125
- signal: options?.signal
126
- });
127
- if (!res.ok) {
128
- let parsed = null;
129
- try {
130
- parsed = await res.json();
131
- } catch {
132
- }
133
- throw new core.AuraError(res.status, parsed);
134
- }
135
- if (!res.body) {
136
- throw new core.AuraError(0, {
137
- error: { code: "invalid_response", message: "chatStream: la r\xE9ponse SSE n'a pas de corps lisible" }
138
- });
139
- }
140
- for await (const msg of parseSSE(res.body)) {
141
- if (msg.event === "delta") {
142
- let content = "";
143
- try {
144
- content = JSON.parse(msg.data).content ?? "";
145
- } catch {
146
- content = "";
147
- }
148
- if (content) yield { delta: content };
149
- } else if (msg.event === "error") {
150
- let message = "AI stream error";
151
- try {
152
- message = JSON.parse(msg.data).error ?? message;
153
- } catch {
154
- }
155
- throw new core.AuraError(0, { error: { code: "ai_stream_error", message } });
156
- } else if (msg.event === "done") {
157
- return;
158
- }
159
- }
160
- } catch (err) {
161
- if (options?.signal?.aborted || core.isAbortError(err)) return;
162
- throw err;
163
- }
164
- }
165
- /**
166
- * Generate embeddings for the given input(s).
167
- */
168
- async embed(req) {
169
- return this.request("POST", `${this.prefix}/embed`, req);
170
- }
171
- /**
172
- * Retrieval-Augmented Generation: query a collection and get an answer.
173
- */
174
- async rag(req) {
175
- return this.request("POST", `${this.prefix}/rag/query`, req);
176
- }
177
- /**
178
- * Ingest a document into a RAG namespace.
179
- */
180
- async ragIngest(req) {
181
- return this.request("POST", `${this.prefix}/rag/ingest`, req);
182
- }
183
- /**
184
- * Liste les namespaces RAG du projet.
185
- * Backend route: GET /v1/ai/{project_id}/rag/namespaces (→ `Vec<String>`).
186
- */
187
- async listNamespaces() {
188
- return this.request("GET", `${this.prefix}/rag/namespaces`);
189
- }
190
- /**
191
- * Supprime un namespace RAG (et son corpus). Le segment `namespace` est
192
- * URL-encodé (anti-injection de chemin).
193
- * Backend route: DELETE /v1/ai/{project_id}/rag/{namespace} (→ `{ deleted }`).
194
- */
195
- async deleteNamespace(namespace) {
196
- return this.request("DELETE", `${this.prefix}/rag/${encodeURIComponent(namespace)}`);
197
- }
198
- /**
199
- * Ré-indexe un namespace RAG avec le modèle d'embedding courant (remédiation
200
- * après un changement de modèle/dimension). Le segment `namespace` est URL-encodé.
201
- * Backend route: POST /v1/ai/{project_id}/rag/{namespace}/reindex (→ `ReindexResponse`).
202
- */
203
- async reindexNamespace(namespace) {
204
- return this.request("POST", `${this.prefix}/rag/${encodeURIComponent(namespace)}/reindex`);
205
- }
206
- /**
207
- * Semantic search over an embedding namespace.
208
- */
209
- async semanticSearch(query, namespace, options) {
210
- const params = new URLSearchParams({ query, namespace });
211
- if (options?.top_k !== void 0) params.set("top_k", String(options.top_k));
212
- if (options?.threshold !== void 0) params.set("threshold", String(options.threshold));
213
- return this.request("GET", `${this.prefix}/search?${params.toString()}`);
214
- }
215
- /**
216
- * Natural-language to SQL: convert a question into a SQL query.
217
- */
218
- async nl2sql(question, schema, options) {
219
- return this.request("POST", `${this.prefix}/nl2sql`, {
220
- question,
221
- schema,
222
- dialect: options?.dialect,
223
- examples: options?.examples
224
- });
225
- }
226
- };
227
-
228
- exports.AiService = AiService;
229
- exports.parseSSE = parseSSE;