dominus-sdk-nodejs 1.24.1 → 1.24.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dominus-sdk-nodejs",
-  "version": "1.24.1",
+  "version": "1.24.3",
   "description": "Node.js SDK for the Dominus Orchestrator Platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/docs/services.md

@@ -1,479 +0,0 @@
-# Services Reference
-
-All 19 service namespaces with actual endpoints and method signatures from source code.
-
-Gateway routing: all `/api/*` paths are transformed to `/svc/*` by the client.
-
-## 1. secrets (Warden)
-
-Encrypted secrets management. Single endpoint with action-based dispatch.
-
-| Method | Endpoint | Action |
-|--------|----------|--------|
-| `get(key)` | `POST /api/warden/secrets` | `get` |
-| `upsert(key, value, comment?)` | `POST /api/warden/secrets` | `update` (falls back to `create`) |
-| `list(prefix?)` | `POST /api/warden/secrets` | `list` |
-| `delete(key)` | `POST /api/warden/secrets` | `delete` |
-
-**Root shortcuts:** `dominus.get(key)`, `dominus.upsert(key, value, comment?)`
-
----
-
-## 2. db (Scribe)
-
-Database CRUD via DB Worker. Includes provisioning.
-
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `schemas()` | `/api/database/schemas` | POST |
-| `tables(schema?)` | `/api/database/tables` | POST |
-| `columns(table, schema?)` | `/api/database/columns` | POST |
-| `query(table, options?)` | `/api/database/select` | POST |
-| `insert(table, data, options?)` | `/api/database/insert` | POST |
-| `update(table, data, filters, options?)` | `/api/database/update` | POST |
-| `delete(table, filters, options?)` | `/api/database/delete` | POST |
-| `raw(sql, params?, options?)` | `/api/database/raw` | POST |
-| `bulkInsert(table, rows, options?)` | `/api/database/raw` | POST |
-| `syncSchema()` | `/api/provision/sync` | POST |
-
-**Root shortcuts:** `dominus.listTables()`, `dominus.queryTable()`, `dominus.insertRow()`, `dominus.updateRows()`, `dominus.deleteRows()`, `dominus.listColumns()`
-
-### Provisioning: syncSchema()
-
-Idempotent schema provisioning using the **3-role model**:
-
-| Role | Database | Schemas |
-|------|----------|---------|
-| `neondb_owner` | both | DDL provisioning (runs syncSchema) |
-| `dominus_user` | `dominus` | auth, logs, meta, object, rag, agent, observability, workflow, tenant_admin |
-| `open_user` | `dominus_open` | tenant_*, cat_* |
-
-Creates missing schemas, tables, indexes, and seeds default data. 2-minute timeout.
-
-Source: `src/namespaces/db.ts:327`
-
----
-
-## 3. secure (Scribe)
-
-Audit-logged table access. All operations require `SecureAccessContext` with `reason` and `actor`.
-
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `tables(schema?)` | `/api/scribe/data/{schema}/tables` | GET |
-| `columns(table, schema?)` | `/api/scribe/data/{schema}/{table}/columns` | GET |
-| `query(table, context, options?)` | `/api/scribe/data/{schema}/{table}/query` | POST |
-| `insert(table, data, context, schema?)` | `/api/scribe/data/{schema}/{table}/insert` | POST |
-| `update(table, data, filters, context, schema?)` | `/api/scribe/data/{schema}/{table}/update` | POST |
-| `delete(table, filters, context, schema?)` | `/api/scribe/data/{schema}/{table}/delete` | POST |
-| `bulkInsert(table, rows, context, schema?)` | `/api/scribe/data/{schema}/{table}/bulk-insert` | POST |
-
----
-
-## 4. redis (Whisperer)
-
-Redis cache via Upstash REST API. TTL enforced: 60s-86400s.
-
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `set(key, value, ttl?, category?)` | `/api/whisperer/set` | POST |
-| `get(key, options?)` | `/api/whisperer/get` | POST |
-| `delete(key, category?)` | `/api/whisperer/delete` | POST |
-| `list(options?)` | `/api/whisperer/list` | POST |
-| `mget(keys)` | `/api/whisperer/mget` | POST |
-| `setnx(key, value, ttl?, category?)` | `/api/whisperer/setnx` | POST |
-| `incr(key, delta?, ttl?, category?)` | `/api/whisperer/incr` | POST |
-| `hset(key, field, value, ttl?, category?)` | `/api/whisperer/hset` | POST |
-| `hget(key, field, category?)` | `/api/whisperer/hget` | POST |
-| `hgetall(key, category?)` | `/api/whisperer/hgetall` | POST |
-| `hdel(key, field, category?)` | `/api/whisperer/hdel` | POST |
-| `type(key, category?)` | `/api/whisperer/type` | POST |
-| `smembers(key, category?)` | `/api/whisperer/smembers` | POST |
-| `lrange(key, options?)` | `/api/whisperer/lrange` | POST |
-
----
-
-## 5. files (Archivist)
-
-File storage via Backblaze B2. Supports upload, download, browse, views, and folders.
-
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `upload(data, filename, options?)` | `/api/archivist/upload` | POST |
-| `download(options)` | `/api/archivist/download` | POST |
-| `fetch(options)` | `/api/archivist/fetch` | POST |
-| `list(options?)` | `/api/archivist/list` | POST |
-| `delete(options)` | `/api/archivist/delete` | POST |
-| `move(fileId, options)` | `/api/archivist/move` | POST |
-| `updateMeta(fileId, options)` | `/api/archivist/update` | POST |
-| `browse(options)` | `/api/archivist/browse` | POST |
-| `getStorageStats()` | `/api/archivist/stats` | POST |
-| `listCategories()` | `/api/archivist/categories` | POST |
-| `listViews(options?)` | `/api/archivist/views` | POST |
-| `listCategoriesInView(view)` | `/api/archivist/view-categories` | POST |
-| `createFolder(options)` | `/api/archivist/folder` | POST |
-| `deleteFolder(options)` | `/api/archivist/folder` | DELETE |
-| `factoryReset(options?)` | `/api/admin/factory-reset-storage` | POST |
-
----
-
-## 6. auth (Guardian)
-
-User, role, scope, client, tenant, page management. Full CRUD. Source: `src/namespaces/auth.ts`
-
-**Users:** `createUser`, `getUser`, `updateUser`, `deleteUser`, `listUsers`, `inviteUser`
-- Endpoints: `/api/guardian/users`, `/api/guardian/users/{id}`
-
-**Roles:** `createRole`, `getRole`, `updateRole`, `deleteRole`, `listRoles`
-- Endpoints: `/api/guardian/roles`, `/api/guardian/roles/{id}`
-
-**Scopes:** `createScope`, `getScope`, `updateScope`, `deleteScope`, `listScopes`
-- Endpoints: `/api/guardian/scopes`, `/api/guardian/scopes/{id}`
-
-**Clients:** `createClient`, `getClient`, `updateClient`, `deleteClient`, `listClients`
-- Endpoints: `/api/guardian/clients`, `/api/guardian/clients/{id}`
-
-**Tenants:** `createTenant`, `getTenant`, `updateTenant`, `deleteTenant`, `listTenants`
-- Endpoints: `/api/guardian/tenants`, `/api/guardian/tenants/{id}`
-
-**Tenant Categories:** `createTenantCategory`, `listTenantCategories`, `getTenantCategory`, `deleteTenantCategory`
-- Endpoints: `/api/guardian/tenant-categories`, `/api/guardian/tenant-categories/{id}`
-
-**Pages:** `createPage`, `getPage`, `updatePage`, `deletePage`, `listPages`
-- Endpoints: `/api/guardian/pages`, `/api/guardian/pages/{id}`
-
-**Navigation:** `createNavItem`, `updateNavItem`, `deleteNavItem`, `listNavItems`, `reorderNavItems`
-- Endpoints: `/api/guardian/navigation`, `/api/guardian/navigation/{id}`, `/api/guardian/navigation/reorder`
-
-**Secure Tables:** `createSecureTable`, `listSecureTables`, `getSecureTable`, `deleteSecureTable`
-- Endpoints: `/api/guardian/secure-tables`, `/api/guardian/secure-tables/{id}`
-
-**Role/Scope Assignments:** `assignRoleToUser`, `removeRoleFromUser`, `assignScopeToRole`, `removeScopeFromRole`
-- Endpoints: `/api/guardian/users/{id}/roles/{roleId}`, `/api/guardian/roles/{id}/scopes/{scopeId}`
-
----
-
-## 7. portal (Portal)
-
-User-facing authentication, sessions, profile, navigation, registration.
-
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `login(username, password, tenantId?)` | `/api/portal/auth/login` | POST |
-| `loginClient(psk, tenantId?)` | `/api/portal/auth/login-client` | POST |
-| `logout(userToken?)` | `/api/portal/auth/logout` | POST |
-| `refresh(userToken?)` | `/api/portal/auth/refresh` | POST |
-| `me(userToken?)` | `/api/portal/auth/me` | GET |
-| `switchTenant(tenantId, userToken?)` | `/api/portal/auth/switch-tenant` | POST |
-| `changePassword(current, new, userToken?)` | `/api/portal/security/change-password` | POST |
-| `requestPasswordReset(email)` | `/api/portal/security/request-reset` | POST |
-| `confirmPasswordReset(token, newPassword)` | `/api/portal/security/confirm-reset` | POST |
-| `listSessions(userToken?)` | `/api/portal/security/sessions` | GET |
-| `revokeSession(sessionId, userToken?)` | `/api/portal/security/sessions/{id}` | DELETE |
-| `revokeAllSessions(userToken?)` | `/api/portal/security/sessions/revoke-all` | POST |
-| `getProfile(userToken?)` | `/api/portal/profile` | GET |
-| `updateProfile(params, userToken?)` | `/api/portal/profile` | PUT |
-| `getPreferences(userToken?)` | `/api/portal/profile/preferences` | GET |
-| `updatePreferences(params, userToken?)` | `/api/portal/profile/preferences` | PUT |
-| `getNavigation(userToken?, options?)` | `/api/portal/nav` | GET |
-| `checkPageAccess(pagePath, userToken?)` | `/api/portal/nav/check-access` | POST |
-| `register(username, email, password, tenantId)` | `/api/portal/register` | POST |
-| `verifyEmail(token)` | `/api/portal/register/verify` | POST |
-| `resendVerification(email)` | `/api/portal/register/resend-verification` | POST |
-| `acceptInvitation(token, password)` | `/api/portal/register/accept-invitation` | POST |
-
----
-
-## 8. ddl (Smith)
-
-Schema DDL, migrations, provisioning, and Schema Builder.
-
-### Direct DDL
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `createTable(name, columns, schema?)` | `/api/smith/schema/create-table` | POST |
-| `dropTable(name, schema?)` | `/api/smith/schema/drop-table` | POST |
-| `addColumn(table, column, schema?)` | `/api/smith/schema/add-column` | POST |
-| `dropColumn(table, column, schema?)` | `/api/smith/schema/drop-column` | POST |
-| `alterColumn(table, column, changes, schema?)` | `/api/smith/schema/alter-column` | POST |
-| `createIndex(table, name, columns, options?)` | `/api/smith/schema/create-index` | POST |
-| `dropIndex(name, schema?)` | `/api/smith/schema/drop-index` | POST |
-
-### Category DDL (atomic multi-schema)
-| Method | Endpoint |
-|--------|----------|
-| `categoryCreateTable(slug, name, columns)` | `/api/smith/category/create-table` |
-| `categoryAddColumn(slug, name, column)` | `/api/smith/category/add-column` |
-
-### Migrations
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `listMigrations(schema)` | `/api/smith/migrations/list/{schema}` | GET |
-| `listCategoryMigrations(slug)` | `/api/smith/migrations/category/{slug}/list` | GET |
-| `applyMigration(schema, id)` | `/api/smith/migrations/apply` | POST |
-| `rollbackMigration(schema, id)` | `/api/smith/migrations/rollback` | POST |
-
-### Provisioning
-| Method | Endpoint |
-|--------|----------|
-| `provisionTenantSchema(slug, categorySlug?)` | `/api/smith/provision/tenant-schema` |
-| `provisionTenantFromCategory(slug, categorySlug)` | `/api/smith/provision/tenant-from-category` |
-
-### Schema Builder
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `getCategoryStructure(slug)` | `/api/database/builder/category/{slug}/structure` | GET |
-| `getCategoryMigrationHistory(slug)` | `/api/database/builder/category/{slug}/migrations` | GET |
-| `previewMigration(slug, op, params, name)` | `/api/database/builder/category/{slug}/preview-migration` | POST |
-| `applyBuilderMigration(slug, op, params, name)` | `/api/database/builder/category/{slug}/apply-migration` | POST |
-| `getMigrationFile(slug, versionId)` | `/api/database/builder/category/{slug}/migrations/{id}` | GET |
-| `getTenantSyncStatus(slug)` | `/api/database/builder/category/{slug}/sync-status` | GET |
-| `syncTenantsToLatest(slug)` | `/api/database/builder/category/{slug}/sync-tenants` | POST |
-| `resetCategorySchema(slug)` | `/api/database/builder/category/{slug}/reset` | DELETE |
-| `resetTenantSchema(slug, tenant)` | `/api/database/builder/category/{slug}/tenants/{t}/reset` | DELETE |
-| `deleteMigration(slug, versionId)` | `/api/database/builder/category/{slug}/migrations/{id}` | DELETE |
-
-**Root shortcuts:** `dominus.addTable()`, `dominus.deleteTable()`, `dominus.addColumn()`, `dominus.deleteColumn()`
-
----
-
-## 9. open (Scribe Open)
-
-Direct database access for advanced use cases.
-
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `dsn()` | `/api/scribe/open/dsn` | GET |
-| `execute(sql, params?)` | `/api/scribe/open/execute` | POST |
-
----
-
-## 10. logs (Herald)
-
-Structured logging via Logs Worker. `useGateway: true`.
-
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `debug(msg, context?, category?)` | `/api/logs/ingest` | POST |
-| `info(msg, context?, category?)` | `/api/logs/ingest` | POST |
-| `notice(msg, context?, category?)` | `/api/logs/ingest` | POST |
-| `warn(msg, context?, category?)` | `/api/logs/ingest` | POST |
-| `error(msg, context?, options?)` | `/api/logs/ingest` | POST |
-| `critical(msg, context?, options?)` | `/api/logs/ingest` | POST |
-| `tail(options?)` | `/api/logs/tail` | GET |
-| `query(options?)` | `/api/logs/tail` | GET |
-| `batch(events)` | `/api/logs/ingest` | POST |
-
-All log methods auto-capture callsite (file, function) from the stack. Batch max: 100 events.
-
----
-
-## 11. health
-
-Service health checks. No authentication required for `check()`.
-
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `check()` | `/api/health` | GET (direct fetch, no base64) |
-| `ping()` | `/api/health/ping` | GET |
-| `warmup()` | `/api/health/warmup` | GET |
-
----
-
-## 12. courier (Courier)
-
-Email delivery via Postmark templates.
-
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `send(templateAlias, to, from, model, options?)` | `/api/courier/send` | POST |
-| `sendWelcome(to, from, params)` | `/api/courier/send` | POST |
-| `sendPasswordReset(to, from, params)` | `/api/courier/send` | POST |
-| `sendEmailVerification(to, from, params)` | `/api/courier/send` | POST |
-| `sendInvitation(to, from, params)` | `/api/courier/send` | POST |
-
----
-
-## 13. ai (Agent Runtime)
-
-LLM agent execution, completions, RAG, artifacts, speech, workflows. `useGateway: true`.
-
-**Agent execution:** `runAgent(params)`, `streamAgent(params)`, `runAgentAsync(params)`
-**LLM completions:** `complete(params)`, `completeStream(params)`
-**Speech:** `stt(audio, options?)`, `tts(text, options?)`
-**Setup:** `setup(options?)`
-
-**Sub-namespaces:**
-- `ai.rag.*` -- RAG corpus management (ensure, upsert, search, list, ingest, getStats)
-- `ai.artifacts.*` -- Artifact CRUD (create, fetch, list, delete)
-- `ai.results.*` -- Async task polling (poll)
-- `ai.workflow.*` -- Workflow execution (execute, cancel, list)
-- `ai.tools.*` -- Tool registry (list, enable, disable)
-
----
-
-## 14. workflow (Workflow Manager)
-
-Workflow CRUD, categories/pipelines, templates, tools, execution. `useGateway: true`.
-
-### Workflows
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `save(options)` | `/api/workflow/workflows` | POST |
-| `get(id, options?)` | `/api/workflow/workflows/{id}` | GET |
-| `list(options?)` | `/api/workflow/workflows` | GET |
-| `delete(id)` | `/api/workflow/workflows/{id}` | DELETE |
-
-### Categories
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `createCategory(options)` | `/api/workflow/categories` | POST |
-| `getCategory(id, options?)` | `/api/workflow/categories/{id}` | GET |
-| `listCategories(options?)` | `/api/workflow/categories` | GET |
-| `deleteCategory(id)` | `/api/workflow/categories/{id}` | DELETE |
-| `addToCategory(catId, wfId, pos?)` | `/api/workflow/categories/{id}/workflows` | POST |
-| `removeFromCategory(catId, wfId)` | `/api/workflow/categories/{id}/workflows/{wfId}` | DELETE |
-| `reorderCategory(catId, order)` | `/api/workflow/categories/{id}/workflows/order` | PUT |
-
-### Templates
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `listTemplates()` | `/api/workflow/templates` | GET |
-| `getTemplate(id, options?)` | `/api/workflow/templates/{id}` | GET |
-| `copyTemplate(id, options?)` | `/api/workflow/templates/{id}/copy` | POST |
-
-### Execution
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `execute(wfId, context?)` | `/api/workflow/execute/workflow` | POST |
-| `executeAsync(wfId, options?)` | `/api/workflow/execute/workflow` | POST |
-| `executeCategory(catId, options?)` | `/api/workflow/execute/category` | POST |
-
-### Tools
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `listTools(options?)` | `/api/workflow/tools` | GET |
-| `getTool(id)` | `/api/workflow/tools/{id}` | GET |
-| `registerTool(options)` | `/api/workflow/tools` | POST |
-| `updateTool(id, options)` | `/api/workflow/tools/{id}` | PUT |
-| `deleteTool(id)` | `/api/workflow/tools/{id}` | DELETE |
-| `enableTool(id)` | `/api/workflow/tools/{id}/enable` | POST |
-| `disableTool(id)` | `/api/workflow/tools/{id}/disable` | POST |
-
-### Admin
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `seed(options?)` | `/api/workflow/admin/seed` | POST |
-| `factoryReset(options)` | `/api/workflow/admin/factory-reset` | POST |
-
----
-
-## 15. stt / oracle (Oracle)
-
-Streaming speech-to-text with WebSocket and VAD. Browser-side only.
-
-```typescript
-const session = dominus.stt.createSession(userJwt);
-session.onUtterance = (text) => handleText(text);
-session.onVADStateChange = (state) => updateUI(state);
-await session.start();
-// ... user speaks ...
-await session.stop();
-```
-
-VAD states: `IDLE` -> `ARMED` -> `SPEAKING` -> `TRAILING`
-
----
-
-## 16. admin
-
-Infrastructure operations with elevated privileges. Uses `neondb_owner` credentials.
-
-| Method | Endpoint | HTTP | Notes |
-|--------|----------|------|-------|
-| `reseedAdminCategory()` | `/api/admin/reseed-admin-category` | POST | Idempotent, seeds baseline data |
-| `resetAdminCategory()` | `/api/admin/reset-admin-category` | DELETE | DESTRUCTIVE: drops tenant_admin |
-| `exportTokens()` | `/api/admin/tokens/export` | GET | `useGateway: true` |
-| `seedKV()` | `/api/admin/kv/seed` | POST | `useGateway: true` |
-
----
-
-## 17. sync (Sync Worker)
-
-KV cache synchronization. `useGateway: true`. Requires admin system level.
-
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `triggerSync()` | `/api/sync/` | POST |
-| `getHealth()` | `/api/sync/health` | GET |
-
----
-
-## 18. artifacts (Artifact Worker)
-
-Temporary artifact storage (Redis < 1MB, B2 >= 1MB). `useGateway: true`.
-
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `list(options?)` | `/api/artifact/list` | POST |
-| `getHealth()` | `/api/artifact/health` | GET |
-| `store(options)` | `/api/artifact/store` | POST |
-| `retrieve(key)` | `/api/artifact/retrieve` | POST |
-| `delete(key)` | `/api/artifact/delete` | POST |
-| `cleanup(options?)` | `/api/artifact/cleanup` | POST |
-
----
-
-## 19. jobs (Job Worker) + processor (Job Processor)
-
-### jobs -- `useGateway: true`
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `enqueue(jobType, payload)` | `/api/job/enqueue` | POST |
-| `getStatus(jobId)` | `/api/job/status` | POST |
-| `getResult(jobId, timeoutMs?)` | `/api/job/result` | POST |
-| `listDeadLetterJobs(jobType?)` | `/api/job/dead-letter` | POST |
-| `retryJob(jobId)` | `/api/job/dead-letter` | POST |
-| `discardJob(jobId)` | `/api/job/dead-letter` | POST |
-| `list(options?)` | `/api/job/list` | POST |
-| `getHealth()` | `/api/job/health` | GET |
-
-Job types: `db_query`, `db_ddl`, `db_migration`, `file_upload`, `workflow_exec`
-
-### processor -- `useGateway: true`
-| Method | Endpoint | HTTP |
-|--------|----------|------|
-| `getHealth()` | `/api/processor/health` | GET |
-| `processAll(jobType?)` | `/api/processor/process` | POST |
-| `processOne(jobType?)` | `/api/processor/process-one` | POST |
-
----
-
-## Summary
-
-| # | Namespace | Backend Service | Endpoint Prefix | Gateway |
-|---|-----------|----------------|-----------------|---------|
-| 1 | secrets | Warden | `/api/warden/` | default |
-| 2 | db | Scribe (DB Worker) | `/api/database/`, `/api/provision/` | default |
-| 3 | secure | Scribe | `/api/scribe/data/` | default |
-| 4 | redis | Whisperer | `/api/whisperer/` | default |
-| 5 | files | Archivist (B2 Worker) | `/api/archivist/` | default |
-| 6 | auth | Guardian | `/api/guardian/` | default |
-| 7 | portal | Portal | `/api/portal/` | default |
-| 8 | ddl | Smith | `/api/smith/`, `/api/database/builder/` | default |
-| 9 | open | Scribe Open | `/api/scribe/open/` | default |
-| 10 | logs | Herald (Logs Worker) | `/api/logs/` | explicit |
-| 11 | health | Gateway | `/api/health/` | default |
-| 12 | courier | Courier | `/api/courier/` | default |
-| 13 | ai | Agent Runtime | `/api/agent/` | explicit |
-| 14 | workflow | Workflow Manager | `/api/workflow/` | explicit |
-| 15 | stt | Oracle | WebSocket | n/a |
-| 16 | admin | Admin | `/api/admin/` | mixed |
-| 17 | sync | Sync Worker | `/api/sync/` | explicit |
-| 18 | artifacts | Artifact Worker | `/api/artifact/` | explicit |
-| 19 | jobs+processor | Job Worker + Processor | `/api/job/`, `/api/processor/` | explicit |
-
-**"explicit"** = passes `useGateway: true` in request options.
-**"default"** = uses `BASE_URL` (which defaults to gateway).
-
-Total: **19 namespaces**, **200+ methods** covering data, auth, AI, infrastructure, and admin operations.