dominus-sdk-nodejs 3.2.6 → 4.0.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.
- package/README.md +13 -1
- package/dist/index.d.ts +4 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -2
- package/dist/index.js.map +1 -1
- package/dist/lib/client.d.ts +1 -2
- package/dist/lib/client.d.ts.map +1 -1
- package/dist/lib/client.js +1 -3
- package/dist/lib/client.js.map +1 -1
- package/dist/namespaces/authority.d.ts +95 -11
- package/dist/namespaces/authority.d.ts.map +1 -1
- package/dist/namespaces/authority.js +181 -19
- package/dist/namespaces/authority.js.map +1 -1
- package/dist/namespaces/files.js +15 -16
- package/dist/namespaces/files.js.map +1 -1
- package/dist/namespaces/logs.d.ts +29 -0
- package/dist/namespaces/logs.d.ts.map +1 -1
- package/dist/namespaces/logs.js +29 -1
- package/dist/namespaces/logs.js.map +1 -1
- package/docs/architecture.md +2 -2
- package/docs/routes-services.md +1 -1
- package/docs/usage-reference.md +16 -15
- package/package.json +1 -1
package/dist/namespaces/logs.js
CHANGED
|
@@ -173,7 +173,7 @@ export class LogsNamespace {
|
|
|
173
173
|
* @param options.trace_id - Optional trace_id filter to return only events from a specific trace
|
|
174
174
|
*/
|
|
175
175
|
async tail(options = {}) {
|
|
176
|
-
const { minutes = 10, limit = 100, trace_id, since, level, company, subject, run_id, deploy_id, installation_id, artifact_ref, } = options;
|
|
176
|
+
const { minutes = 10, limit = 100, trace_id, request_id, since, until, service, level, company, subject, run_id, deploy_id, installation_id, artifact_ref, } = options;
|
|
177
177
|
const params = [];
|
|
178
178
|
if (minutes !== 10)
|
|
179
179
|
params.push(`minutes=${minutes}`);
|
|
@@ -181,8 +181,14 @@ export class LogsNamespace {
|
|
|
181
181
|
params.push(`limit=${limit}`);
|
|
182
182
|
if (trace_id)
|
|
183
183
|
params.push(`trace_id=${trace_id}`);
|
|
184
|
+
if (request_id)
|
|
185
|
+
params.push(`request_id=${encodeURIComponent(request_id)}`);
|
|
184
186
|
if (since)
|
|
185
187
|
params.push(`since=${encodeURIComponent(since)}`);
|
|
188
|
+
if (until)
|
|
189
|
+
params.push(`until=${encodeURIComponent(until)}`);
|
|
190
|
+
if (service)
|
|
191
|
+
params.push(`service=${encodeURIComponent(service)}`);
|
|
186
192
|
if (level)
|
|
187
193
|
params.push(`level=${encodeURIComponent(level)}`);
|
|
188
194
|
if (company)
|
|
@@ -210,6 +216,28 @@ export class LogsNamespace {
|
|
|
210
216
|
return [];
|
|
211
217
|
}
|
|
212
218
|
}
|
|
219
|
+
/**
|
|
220
|
+
* Get archive backlog status for logs cold storage.
|
|
221
|
+
*/
|
|
222
|
+
async getArchiveStatus(options = {}) {
|
|
223
|
+
const params = [];
|
|
224
|
+
if (options.all_scopes)
|
|
225
|
+
params.push('all_scopes=true');
|
|
226
|
+
if (options.target_org_id)
|
|
227
|
+
params.push(`target_org_id=${encodeURIComponent(options.target_org_id)}`);
|
|
228
|
+
if (options.target_env)
|
|
229
|
+
params.push(`target_env=${encodeURIComponent(options.target_env)}`);
|
|
230
|
+
if (options.use_shared)
|
|
231
|
+
params.push('use_shared=true');
|
|
232
|
+
if (options.limit !== undefined)
|
|
233
|
+
params.push(`limit=${options.limit}`);
|
|
234
|
+
const qs = params.length ? `?${params.join('&')}` : '';
|
|
235
|
+
return this.client.request({
|
|
236
|
+
endpoint: `/api/logs/archive-status${qs}`,
|
|
237
|
+
method: 'GET',
|
|
238
|
+
useGateway: true,
|
|
239
|
+
});
|
|
240
|
+
}
|
|
213
241
|
/**
|
|
214
242
|
* Query logs — alias for tail().
|
|
215
243
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/namespaces/logs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/namespaces/logs.ts"],"names":[],"mappings":"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"}
|
package/docs/architecture.md
CHANGED
|
@@ -64,8 +64,8 @@ See [routes-services.md](./routes-services.md) for full route/service assessment
|
|
|
64
64
|
|
|
65
65
|
### Local JWT utilities
|
|
66
66
|
|
|
67
|
-
- `verifyJwtLocally`, `isJwtValid`, and `
|
|
68
|
-
- `
|
|
67
|
+
- `verifyJwtLocally`, `isJwtValid`, and `mintSelectedScopeJwt` are exported from `src/lib/client.ts`. Selected-scope targeting is now the only supported SDK helper vocabulary.
|
|
68
|
+
- `mintSelectedScopeJwt(targetOrgId, targetEnv)` is the canonical selected-scope mint helper; the live `/jwt/mint` contract keys selected scope off org plus environment, not a shared-routing flag.
|
|
69
69
|
- `auth.getJwks` fetches public keys and caches them.
|
|
70
70
|
- `auth.validateJwt` performs local payload checks/expiry validation.
|
|
71
71
|
|
package/docs/routes-services.md
CHANGED
|
@@ -42,7 +42,7 @@ Audited commands: **412** across **26** namespace surfaces.
|
|
|
42
42
|
| `/api/scribe/*` | secure, open | `scribe` |
|
|
43
43
|
| `/api/smith/*` | ddl | `smith` |
|
|
44
44
|
| `/api/redis/*` | redis | `redis-worker` |
|
|
45
|
-
| `/api/
|
|
45
|
+
| `/api/b2/*` | files | `b2-worker` |
|
|
46
46
|
| `/api/courier/*` | courier | `courier-worker` |
|
|
47
47
|
| `/api/logs/*` | logs | `logs-worker` |
|
|
48
48
|
| `/health`, `/v1/ping` | health | `gateway-local` |
|
package/docs/usage-reference.md
CHANGED
|
@@ -88,20 +88,20 @@ Source: `src/namespaces/files.ts` (FilesNamespace)
|
|
|
88
88
|
|
|
89
89
|
| Command | Params | Returns | Route | What it does |
|
|
90
90
|
|---|---|---|---|---|
|
|
91
|
-
| `dominus.files.upload` | `data: Buffer, filename: string, options?: { contentType?: string; category?: string; path?: string; tags?: Record<string, string>; compliance?: boolean; actor?: string; retentionDays?: number; }` | `Promise<UploadResult>` | `POST /api/
|
|
92
|
-
| `dominus.files.download` | `options: FileInfo & { expiresSeconds?: number }` | `Promise<DownloadResult>` | `POST /api/
|
|
93
|
-
| `dominus.files.fetch` | `options: FileInfo` | `Promise<FetchResult>` | `POST /api/
|
|
94
|
-
| `dominus.files.list` | `options?: { category?: string; prefix?: string; limit?: number; cursor?: string; }` | `Promise<ListResult>` | `POST /api/
|
|
95
|
-
| `dominus.files.delete` | `options: FileInfo` | `Promise<{ deleted: boolean }>` | `POST /api/
|
|
96
|
-
| `dominus.files.move` | `fileId: string, options: { newCategory?: string; newPath?: string }` | `Promise<Record<string, unknown>>` | `POST /api/
|
|
97
|
-
| `dominus.files.updateMeta` | `fileId: string, options: { tags?: Record<string, string>; description?: string }` | `Promise<Record<string, unknown>>` | `POST /api/
|
|
98
|
-
| `dominus.files.browse` | `options: { category: string; path?: string; includeSubfolders?: boolean; limit?: number; cursor?: string; }` | `Promise<BrowseResult>` | `POST /api/
|
|
99
|
-
| `dominus.files.getStorageStats` | `none` | `Promise<StorageStats>` | `POST /api/
|
|
100
|
-
| `dominus.files.listCategories` | `none` | `Promise<CategoriesResponse>` | `POST /api/
|
|
101
|
-
| `dominus.files.listViews` | `options?: { userScopes?: string[]; activeTenant?: string; }` | `Promise<ViewsResult>` | `POST /api/
|
|
102
|
-
| `dominus.files.listCategoriesInView` | `view: string` | `Promise<CategoriesResponse>` | `POST /api/
|
|
103
|
-
| `dominus.files.createFolder` | `options: { category: string; path: string; }` | `Promise<CreateFolderResult>` | `POST /api/
|
|
104
|
-
| `dominus.files.deleteFolder` | `options: { category: string; path: string; force?: boolean; }` | `Promise<DeleteFolderResult>` | `DELETE /api/
|
|
91
|
+
| `dominus.files.upload` | `data: Buffer, filename: string, options?: { contentType?: string; category?: string; path?: string; tags?: Record<string, string>; compliance?: boolean; actor?: string; retentionDays?: number; }` | `Promise<UploadResult>` | `POST /api/b2/upload` | Upload a file to object storage. |
|
|
92
|
+
| `dominus.files.download` | `options: FileInfo & { expiresSeconds?: number }` | `Promise<DownloadResult>` | `POST /api/b2/download` | Get a presigned download URL for a file. |
|
|
93
|
+
| `dominus.files.fetch` | `options: FileInfo` | `Promise<FetchResult>` | `POST /api/b2/fetch` | Fetch file content directly. |
|
|
94
|
+
| `dominus.files.list` | `options?: { category?: string; prefix?: string; limit?: number; cursor?: string; }` | `Promise<ListResult>` | `POST /api/b2/list` | List files with optional filtering. |
|
|
95
|
+
| `dominus.files.delete` | `options: FileInfo` | `Promise<{ deleted: boolean }>` | `POST /api/b2/delete` | Delete a file. |
|
|
96
|
+
| `dominus.files.move` | `fileId: string, options: { newCategory?: string; newPath?: string }` | `Promise<Record<string, unknown>>` | `POST /api/b2/move` | Move or rename a file. |
|
|
97
|
+
| `dominus.files.updateMeta` | `fileId: string, options: { tags?: Record<string, string>; description?: string }` | `Promise<Record<string, unknown>>` | `POST /api/b2/update` | Update file metadata. |
|
|
98
|
+
| `dominus.files.browse` | `options: { category: string; path?: string; includeSubfolders?: boolean; limit?: number; cursor?: string; }` | `Promise<BrowseResult>` | `POST /api/b2/browse` | Browse storage with hierarchical navigation. |
|
|
99
|
+
| `dominus.files.getStorageStats` | `none` | `Promise<StorageStats>` | `POST /api/b2/stats` | Get storage statistics. |
|
|
100
|
+
| `dominus.files.listCategories` | `none` | `Promise<CategoriesResponse>` | `POST /api/b2/categories` | List all categories (root folders) in storage. |
|
|
101
|
+
| `dominus.files.listViews` | `options?: { userScopes?: string[]; activeTenant?: string; }` | `Promise<ViewsResult>` | `POST /api/b2/views` | List storage views filtered by user access. |
|
|
102
|
+
| `dominus.files.listCategoriesInView` | `view: string` | `Promise<CategoriesResponse>` | `POST /api/b2/view-categories` | List categories within a specific view (scope). |
|
|
103
|
+
| `dominus.files.createFolder` | `options: { category: string; path: string; }` | `Promise<CreateFolderResult>` | `POST /api/b2/folder` | Create a virtual folder. |
|
|
104
|
+
| `dominus.files.deleteFolder` | `options: { category: string; path: string; force?: boolean; }` | `Promise<DeleteFolderResult>` | `DELETE /api/b2/folder` | Delete a virtual folder and all its contents. |
|
|
105
105
|
| `dominus.files.factoryReset` | `options?: { force?: boolean; reinitializeStructure?: boolean; }` | `Promise<FactoryResetResult>` | `POST /api/admin/factory-reset-storage` | Factory reset - delete ALL objects in the project/environment. |
|
|
106
106
|
|
|
107
107
|
## dominus.auth
|
|
@@ -303,7 +303,8 @@ Source: `src/namespaces/logs.ts` (LogsNamespace)
|
|
|
303
303
|
| `dominus.logs.warn` | `message: string, context?: LogContext, category?: string` | `Promise<boolean>` | `POST /api/logs/ingest (delegates to _log)` | Log warning message. |
|
|
304
304
|
| `dominus.logs.error` | `message: string, context?: LogContext, options?: { category?: string; exception?: Error }` | `Promise<boolean>` | `POST /api/logs/ingest (delegates to _log)` | Log error message. |
|
|
305
305
|
| `dominus.logs.critical` | `message: string, context?: LogContext, options?: { category?: string; exception?: Error }` | `Promise<boolean>` | `POST /api/logs/ingest (delegates to _log)` | Log critical message. |
|
|
306
|
-
| `dominus.logs.tail` | `options?: { minutes?: number; limit?: number; }` | `Promise<LogEvent[]>` | `GET /api/logs/tail${qs}` | Tail recent logs from the Logs Worker. |
|
|
306
|
+
| `dominus.logs.tail` | `options?: { minutes?: number; limit?: number; trace_id?: string; request_id?: string; since?: string; until?: string; service?: string; level?: string; company?: string; subject?: string; run_id?: string; deploy_id?: string; installation_id?: string; artifact_ref?: string; }` | `Promise<LogEvent[]>` | `GET /api/logs/tail${qs}` | Tail recent logs from the Logs Worker. |
|
|
307
|
+
| `dominus.logs.getArchiveStatus` | `options?: { all_scopes?: boolean; target_org_id?: string; target_env?: string; use_shared?: boolean; limit?: number; }` | `Promise<LogArchiveStatusResult>` | `GET /api/logs/archive-status${qs}` | Get log cold-storage backlog state. |
|
|
307
308
|
| `dominus.logs.query` | `options?: { minutes?: number; limit?: number; }` | `Promise<LogEvent[]>` | `GET /api/logs/tail (alias of logs.tail)` | Query logs — alias for tail(). |
|
|
308
309
|
| `dominus.logs.batch` | `events: Array<{ level: string; message: string; context?: LogContext; category?: string; }>` | `Promise<BatchResult>` | `POST /api/logs/ingest` | Send multiple log events in one request. |
|
|
309
310
|
|