dominus-sdk-nodejs 1.0.0

package/dist/namespaces/files.js

@@ -0,0 +1,161 @@
+/**
+ * Files Namespace - Archivist object storage operations.
+ *
+ * Provides file upload, download, and management via B2 object storage.
+ */
+export class FilesNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Upload a file to object storage.
+     *
+     * @param data - File content as Buffer
+     * @param filename - Original filename
+     * @param options - Upload options
+     */
+    async upload(data, filename, options = {}) {
+        const { contentType, category = 'general', path, tags, compliance = false, actor, retentionDays = 90, } = options;
+        const fileB64 = data.toString('base64');
+        const body = {
+            file_content: fileB64,
+            filename,
+            category,
+            logical_path: path || filename,
+        };
+        if (contentType)
+            body.content_type = contentType;
+        if (tags)
+            body.tags = tags;
+        if (compliance) {
+            body.is_compliance = true;
+            body.retention_days = retentionDays;
+            if (actor)
+                body.owner_user_id = actor;
+        }
+        return this.client.request({
+            endpoint: '/api/archivist/upload',
+            body,
+        });
+    }
+    /**
+     * Get a presigned download URL for a file.
+     *
+     * @param options - File identifier and options
+     */
+    async download(options) {
+        const { id, category, path, actor, expiresSeconds = 3600 } = options;
+        const body = { expires_seconds: expiresSeconds };
+        if (id)
+            body.id = id;
+        if (category)
+            body.category = category;
+        if (path)
+            body.logical_path = path;
+        if (actor)
+            body.actor_user_id = actor;
+        return this.client.request({
+            endpoint: '/api/archivist/download',
+            body,
+        });
+    }
+    /**
+     * Fetch file content directly.
+     *
+     * @param options - File identifier
+     */
+    async fetch(options) {
+        const { id, category, path, actor } = options;
+        const body = {};
+        if (id)
+            body.id = id;
+        if (category)
+            body.category = category;
+        if (path)
+            body.logical_path = path;
+        if (actor)
+            body.actor_user_id = actor;
+        return this.client.request({
+            endpoint: '/api/archivist/fetch',
+            body,
+        });
+    }
+    /**
+     * List files with optional filtering.
+     *
+     * @param options - List options
+     */
+    async list(options = {}) {
+        const { category, prefix, limit = 100, cursor } = options;
+        const body = { limit };
+        if (category)
+            body.category = category;
+        if (prefix)
+            body.prefix = prefix;
+        if (cursor)
+            body.cursor = cursor;
+        return this.client.request({
+            endpoint: '/api/archivist/list',
+            body,
+        });
+    }
+    /**
+     * Delete a file.
+     *
+     * @param options - File identifier
+     */
+    async delete(options) {
+        const { id, category, path, actor } = options;
+        const body = {};
+        if (id)
+            body.id = id;
+        if (category)
+            body.category = category;
+        if (path)
+            body.logical_path = path;
+        if (actor)
+            body.actor_user_id = actor;
+        return this.client.request({
+            endpoint: '/api/archivist/delete',
+            body,
+        });
+    }
+    /**
+     * Move or rename a file.
+     *
+     * @param fileId - File UUID
+     * @param options - New category and/or path
+     */
+    async move(fileId, options) {
+        const { newCategory, newPath } = options;
+        const body = { id: fileId };
+        if (newCategory)
+            body.new_category = newCategory;
+        if (newPath)
+            body.new_logical_path = newPath;
+        return this.client.request({
+            endpoint: '/api/archivist/move',
+            body,
+        });
+    }
+    /**
+     * Update file metadata.
+     *
+     * @param fileId - File UUID
+     * @param options - New metadata
+     */
+    async updateMeta(fileId, options) {
+        const { tags, description } = options;
+        const body = { id: fileId };
+        if (tags !== undefined)
+            body.tags = tags;
+        if (description !== undefined)
+            body.description = description;
+        return this.client.request({
+            endpoint: '/api/archivist/update',
+            body,
+        });
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/namespaces/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/namespaces/files.ts"],"names":[],"mappings":"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"}

package/dist/namespaces/health.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Health Namespace - Service health check operations.
+ *
+ * Provides health check endpoints for the orchestrator service.
+ */
+import type { DominusClient } from '../lib/client.js';
+export interface HealthStatus {
+    status: string;
+    latency_ms?: number;
+    [key: string]: unknown;
+}
+export declare class HealthNamespace {
+    private client;
+    constructor(client: DominusClient);
+    /**
+     * Perform comprehensive health check of orchestrator and dependencies.
+     */
+    check(): Promise<HealthStatus>;
+    /**
+     * Simple ping check (fastest response).
+     */
+    ping(): Promise<{
+        status: string;
+    }>;
+    /**
+     * Warmup request (triggers cold start if needed).
+     */
+    warmup(): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=health.d.ts.map

package/dist/namespaces/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/namespaces/health.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEzC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;IAoCpC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAOzC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAMjD"}

package/dist/namespaces/health.js

@@ -0,0 +1,66 @@
+/**
+ * Health Namespace - Service health check operations.
+ *
+ * Provides health check endpoints for the orchestrator service.
+ */
+import { BASE_URL } from '../lib/config.js';
+export class HealthNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Perform comprehensive health check of orchestrator and dependencies.
+     */
+    async check() {
+        const start = Date.now();
+        try {
+            const response = await fetch(`${BASE_URL}/api/health`, {
+                method: 'GET',
+                headers: {
+                    'Accept': 'application/json',
+                },
+            });
+            const latencyMs = Date.now() - start;
+            if (!response.ok) {
+                return {
+                    status: 'unhealthy',
+                    latency_ms: latencyMs,
+                    error: `HTTP ${response.status}`,
+                };
+            }
+            const data = await response.json();
+            return {
+                status: data.status || 'healthy',
+                ...data,
+                latency_ms: latencyMs,
+            };
+        }
+        catch (error) {
+            return {
+                status: 'unhealthy',
+                latency_ms: Date.now() - start,
+                error: error instanceof Error ? error.message : 'Connection failed',
+            };
+        }
+    }
+    /**
+     * Simple ping check (fastest response).
+     */
+    async ping() {
+        return this.client.request({
+            endpoint: '/api/health/ping',
+            method: 'GET',
+        });
+    }
+    /**
+     * Warmup request (triggers cold start if needed).
+     */
+    async warmup() {
+        return this.client.request({
+            endpoint: '/api/health/warmup',
+            method: 'GET',
+        });
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/namespaces/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/namespaces/health.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQ5C,MAAM,OAAO,eAAe;IACN;IAApB,YAAoB,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAE7C;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,aAAa,EAAE;gBACrD,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACP,QAAQ,EAAE,kBAAkB;iBAC7B;aACF,CAAC,CAAC;YAEH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YAErC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO;oBACL,MAAM,EAAE,WAAW;oBACnB,UAAU,EAAE,SAAS;oBACrB,KAAK,EAAE,QAAQ,QAAQ,CAAC,MAAM,EAAE;iBACjC,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA6B,CAAC;YAC9D,OAAO;gBACL,MAAM,EAAG,IAAI,CAAC,MAAiB,IAAI,SAAS;gBAC5C,GAAG,IAAI;gBACP,UAAU,EAAE,SAAS;aACtB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBAC9B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB;aACpE,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YACzB,QAAQ,EAAE,kBAAkB;YAC5B,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YACzB,QAAQ,EAAE,oBAAoB;YAC9B,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/namespaces/logs.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Logs Namespace - Herald structured logging operations.
+ *
+ * Provides zero-friction logging to BetterStack via Herald service.
+ * SDK automatically captures callsite (file, function) - users just call:
+ *     await dominus.logs.info("message", { key: "value" })
+ */
+import type { DominusClient } from '../lib/client.js';
+export interface LogContext {
+    [key: string]: unknown;
+}
+export interface LogEntry {
+    level: string;
+    message: string;
+    context?: LogContext;
+    category?: string;
+    file?: string;
+    function?: string;
+    dt?: string;
+    [key: string]: unknown;
+}
+export interface BatchResult {
+    total: number;
+    stored: number;
+    failed: number;
+}
+export declare class LogsNamespace {
+    private client;
+    constructor(client: DominusClient);
+    /**
+     * Capture callsite information from the call stack.
+     */
+    private captureCallsite;
+    /**
+     * Fallback log to stderr when backend unavailable.
+     */
+    private fallbackLog;
+    /**
+     * Internal log method with callsite capture.
+     */
+    private _log;
+    /**
+     * Log debug message.
+     */
+    debug(message: string, context?: LogContext, category?: string): Promise<boolean>;
+    /**
+     * Log info message.
+     */
+    info(message: string, context?: LogContext, category?: string): Promise<boolean>;
+    /**
+     * Log notice message.
+     */
+    notice(message: string, context?: LogContext, category?: string): Promise<boolean>;
+    /**
+     * Log warning message.
+     */
+    warn(message: string, context?: LogContext, category?: string): Promise<boolean>;
+    /**
+     * Log error message.
+     */
+    error(message: string, context?: LogContext, options?: {
+        category?: string;
+        exception?: Error;
+    }): Promise<boolean>;
+    /**
+     * Log critical message.
+     */
+    critical(message: string, context?: LogContext, options?: {
+        category?: string;
+        exception?: Error;
+    }): Promise<boolean>;
+    /**
+     * Query logs from Herald.
+     */
+    query(options?: {
+        level?: string;
+        category?: string;
+        startTime?: string;
+        endTime?: string;
+        file?: string;
+        function?: string;
+        search?: string;
+        limit?: number;
+        project?: string;
+        environment?: string;
+    }): Promise<LogEntry[]>;
+    /**
+     * Send multiple log events in one request.
+     */
+    batch(events: Array<{
+        level: string;
+        message: string;
+        context?: LogContext;
+        category?: string;
+    }>): Promise<BatchResult>;
+}
+//# sourceMappingURL=logs.d.ts.map

package/dist/namespaces/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/namespaces/logs.ts"],"names":[],"mappings":"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"}

package/dist/namespaces/logs.js

@@ -0,0 +1,194 @@
+/**
+ * Logs Namespace - Herald structured logging operations.
+ *
+ * Provides zero-friction logging to BetterStack via Herald service.
+ * SDK automatically captures callsite (file, function) - users just call:
+ *     await dominus.logs.info("message", { key: "value" })
+ */
+export class LogsNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Capture callsite information from the call stack.
+     */
+    captureCallsite() {
+        try {
+            const err = new Error();
+            const stack = err.stack?.split('\n') || [];
+            // Skip: Error, captureCallsite, _log, public method, caller
+            const callerLine = stack[4] || stack[3] || '';
+            // Parse stack line like "at functionName (file:line:col)" or "at file:line:col"
+            const match = callerLine.match(/at\s+(?:(.+?)\s+\()?(.+?)(?::\d+:\d+)?\)?$/);
+            if (match) {
+                let filepath = match[2] || '';
+                const func = match[1];
+                // Normalize filepath - keep last 3 path components
+                const parts = filepath.split(/[/\\]/);
+                if (parts.length > 3) {
+                    filepath = parts.slice(-3).join('/');
+                }
+                return { file: filepath || undefined, func: func || undefined };
+            }
+        }
+        catch {
+            // Ignore callsite capture errors
+        }
+        return {};
+    }
+    /**
+     * Fallback log to stderr when backend unavailable.
+     */
+    fallbackLog(level, message, context) {
+        try {
+            const entry = {
+                dt: new Date().toISOString(),
+                level: level.toUpperCase(),
+                message,
+                _fallback: true,
+            };
+            if (context) {
+                entry.context = context;
+            }
+            console.error(JSON.stringify(entry));
+        }
+        catch {
+            // Ignore
+        }
+    }
+    /**
+     * Internal log method with callsite capture.
+     */
+    async _log(level, message, context, category, exception) {
+        const { file, func } = this.captureCallsite();
+        const body = {
+            level,
+            message,
+        };
+        if (context)
+            body.context = context;
+        if (category)
+            body.category = category;
+        if (file)
+            body.file = file;
+        if (func)
+            body.function = func;
+        if (exception) {
+            body.context = {
+                ...(body.context || {}),
+                exception: {
+                    type: exception.name,
+                    message: exception.message,
+                },
+            };
+        }
+        try {
+            const result = await this.client.request({
+                endpoint: '/api/herald/log',
+                body,
+            });
+            return result.stored ?? false;
+        }
+        catch {
+            // Never raise - fallback to local
+            this.fallbackLog(level, message, context);
+            return false;
+        }
+    }
+    /**
+     * Log debug message.
+     */
+    async debug(message, context, category) {
+        return this._log('debug', message, context, category);
+    }
+    /**
+     * Log info message.
+     */
+    async info(message, context, category) {
+        return this._log('info', message, context, category);
+    }
+    /**
+     * Log notice message.
+     */
+    async notice(message, context, category) {
+        return this._log('notice', message, context, category);
+    }
+    /**
+     * Log warning message.
+     */
+    async warn(message, context, category) {
+        return this._log('warn', message, context, category);
+    }
+    /**
+     * Log error message.
+     */
+    async error(message, context, options) {
+        return this._log('error', message, context, options?.category, options?.exception);
+    }
+    /**
+     * Log critical message.
+     */
+    async critical(message, context, options) {
+        return this._log('critical', message, context, options?.category, options?.exception);
+    }
+    /**
+     * Query logs from Herald.
+     */
+    async query(options = {}) {
+        const { level, category, startTime, endTime, file, function: func, search, limit = 100, project, environment, } = options;
+        const body = { limit };
+        if (level)
+            body.level = level;
+        if (category)
+            body.category = category;
+        if (startTime)
+            body.start_time = startTime;
+        if (endTime)
+            body.end_time = endTime;
+        if (file)
+            body.file = file;
+        if (func)
+            body.function = func;
+        if (search)
+            body.search = search;
+        if (project)
+            body.project = project;
+        if (environment)
+            body.environment = environment;
+        try {
+            const result = await this.client.request({
+                endpoint: '/api/herald/query',
+                body,
+            });
+            return result.logs ?? [];
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Send multiple log events in one request.
+     */
+    async batch(events) {
+        try {
+            const result = await this.client.request({
+                endpoint: '/api/herald/batch',
+                body: { events: events.slice(0, 100) },
+            });
+            return result;
+        }
+        catch {
+            // Fallback - log each locally
+            for (const event of events) {
+                this.fallbackLog(event.level || 'info', event.message || '', event.context);
+            }
+            return {
+                total: events.length,
+                stored: 0,
+                failed: events.length,
+            };
+        }
+    }
+}
+//# sourceMappingURL=logs.js.map

package/dist/namespaces/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/namespaces/logs.ts"],"names":[],"mappings":"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"}

package/dist/namespaces/open.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Open Namespace - Direct database access operations.
+ *
+ * Provides DSN retrieval and raw SQL execution for advanced use cases.
+ */
+import type { DominusClient } from '../lib/client.js';
+export declare class OpenNamespace {
+    private client;
+    constructor(client: DominusClient);
+    /**
+     * Get the PostgreSQL connection DSN.
+     *
+     * Returns the complete PostgreSQL connection URI that can be
+     * used directly by clients to connect to the database.
+     */
+    dsn(): Promise<string>;
+    /**
+     * Execute raw SQL query.
+     *
+     * Use with caution - this bypasses most safety checks.
+     *
+     * @param sql - SQL query string
+     * @param params - Optional parameter dictionary
+     */
+    execute(sql: string, params?: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=open.d.ts.map

package/dist/namespaces/open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../src/namespaces/open.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEzC;;;;;OAKG;IACG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAY5B;;;;;;;OAOG;IACG,OAAO,CACX,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAWpC"}

package/dist/namespaces/open.js

@@ -0,0 +1,46 @@
+/**
+ * Open Namespace - Direct database access operations.
+ *
+ * Provides DSN retrieval and raw SQL execution for advanced use cases.
+ */
+export class OpenNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get the PostgreSQL connection DSN.
+     *
+     * Returns the complete PostgreSQL connection URI that can be
+     * used directly by clients to connect to the database.
+     */
+    async dsn() {
+        const result = await this.client.request({
+            endpoint: '/api/scribe/open/dsn',
+            method: 'GET',
+        });
+        if (typeof result === 'string') {
+            return result;
+        }
+        return result.dsn || result.connection_string || '';
+    }
+    /**
+     * Execute raw SQL query.
+     *
+     * Use with caution - this bypasses most safety checks.
+     *
+     * @param sql - SQL query string
+     * @param params - Optional parameter dictionary
+     */
+    async execute(sql, params) {
+        const body = { sql };
+        if (params) {
+            body.params = params;
+        }
+        return this.client.request({
+            endpoint: '/api/scribe/open/execute',
+            body,
+        });
+    }
+}
+//# sourceMappingURL=open.js.map

package/dist/namespaces/open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../src/namespaces/open.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,OAAO,aAAa;IACJ;IAApB,YAAoB,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAE7C;;;;;OAKG;IACH,KAAK,CAAC,GAAG;QACP,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAwD;YAC9F,QAAQ,EAAE,sBAAsB;YAChC,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QAEH,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC;IACtD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CACX,GAAW,EACX,MAAgC;QAEhC,MAAM,IAAI,GAA4B,EAAE,GAAG,EAAE,CAAC;QAC9C,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YACzB,QAAQ,EAAE,0BAA0B;YACpC,IAAI;SACL,CAAC,CAAC;IACL,CAAC;CACF"}