dominus-sdk-nodejs-dev 1.2.4

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"}

package/dist/namespaces/portal.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Portal Namespace - User authentication and session orchestration.
+ *
+ * Provides login, logout, session management, profile, and navigation access.
+ */
+import type { DominusClient } from '../lib/client.js';
+export interface Session {
+    id: string;
+    userId: string;
+    tenantId: string;
+    createdAt: string;
+    expiresAt: string;
+    [key: string]: unknown;
+}
+export declare class PortalNamespace {
+    private client;
+    constructor(client: DominusClient);
+    /**
+     * Login user with password.
+     *
+     * @param username - Username or email
+     * @param password - User password
+     * @param tenantId - Optional tenant UUID/slug. If not provided, uses user's first available tenant.
+     * @returns User info, active tenant, available tenants list, and session_id
+     */
+    login(username: string, password: string, tenantId?: string): Promise<Record<string, unknown>>;
+    /**
+     * Login service client with PSK.
+     *
+     * Client is looked up by PSK directly - no client_id needed.
+     *
+     * @param psk - Pre-shared key
+     * @param tenantId - Optional tenant UUID. If not provided, uses client's first assigned tenant.
+     */
+    loginClient(psk: string, tenantId?: string): Promise<Record<string, unknown>>;
+    /**
+     * End session and clear cookie.
+     *
+     * @param userToken - User's JWT token (required for user-authenticated requests)
+     */
+    logout(userToken?: string): Promise<Record<string, unknown>>;
+    /**
+     * Refresh JWT token using existing session.
+     *
+     * @param userToken - User's current JWT token (can be expired)
+     * @returns New access token and session info
+     */
+    refresh(userToken?: string): Promise<Record<string, unknown>>;
+    /**
+     * Get current user/client info.
+     *
+     * @param userToken - User's JWT token (required for user-authenticated requests)
+     */
+    me(userToken?: string): Promise<Record<string, unknown>>;
+    /**
+     * Switch active tenant context.
+     *
+     * @param tenantId - Tenant UUID to switch to
+     * @param userToken - User's JWT token (required for user-authenticated requests)
+     */
+    switchTenant(tenantId: string, userToken?: string): Promise<Record<string, unknown>>;
+    /**
+     * Change current user's password.
+     *
+     * @param currentPassword - Current password
+     * @param newPassword - New password
+     * @param userToken - User's JWT token
+     */
+    changePassword(currentPassword: string, newPassword: string, userToken?: string): Promise<Record<string, unknown>>;
+    /**
+     * Request password reset email.
+     * Note: This does not require user authentication.
+     */
+    requestPasswordReset(email: string): Promise<Record<string, unknown>>;
+    /**
+     * Confirm password reset with token.
+     * Note: This does not require user authentication.
+     */
+    confirmPasswordReset(token: string, newPassword: string): Promise<Record<string, unknown>>;
+    /**
+     * List all active sessions for current user.
+     *
+     * @param userToken - User's JWT token
+     */
+    listSessions(userToken?: string): Promise<Session[]>;
+    /**
+     * Revoke a specific session.
+     *
+     * @param sessionId - Session UUID to revoke
+     * @param userToken - User's JWT token
+     */
+    revokeSession(sessionId: string, userToken?: string): Promise<Record<string, unknown>>;
+    /**
+     * Revoke all sessions except current.
+     *
+     * @param userToken - User's JWT token
+     */
+    revokeAllSessions(userToken?: string): Promise<Record<string, unknown>>;
+    /**
+     * Get current user's profile.
+     *
+     * @param userToken - User's JWT token
+     */
+    getProfile(userToken?: string): Promise<Record<string, unknown>>;
+    /**
+     * Update user profile.
+     *
+     * @param params - Profile fields to update
+     * @param userToken - User's JWT token
+     */
+    updateProfile(params: {
+        displayName?: string;
+        avatarUrl?: string;
+        bio?: string;
+        phone?: string;
+        extra?: Record<string, unknown>;
+    }, userToken?: string): Promise<Record<string, unknown>>;
+    /**
+     * Get current user's preferences.
+     *
+     * @param userToken - User's JWT token
+     */
+    getPreferences(userToken?: string): Promise<Record<string, unknown>>;
+    /**
+     * Update user preferences.
+     *
+     * @param params - Preference fields to update
+     * @param userToken - User's JWT token
+     */
+    updatePreferences(params: {
+        theme?: string;
+        language?: string;
+        timezone?: string;
+        sidebarCollapsed?: boolean;
+        notificationsEnabled?: boolean;
+        emailNotifications?: boolean;
+        extra?: Record<string, unknown>;
+    }, userToken?: string): Promise<Record<string, unknown>>;
+    /**
+     * Get navigation tree for current user's tenant.
+     *
+     * @param userToken - User's JWT token
+     */
+    getNavigation(userToken?: string): Promise<Record<string, unknown>>;
+    /**
+     * Check if current user can access a page.
+     *
+     * @param pagePath - Page path to check (e.g., "/dashboard/admin")
+     * @param userToken - User's JWT token
+     */
+    checkPageAccess(pagePath: string, userToken?: string): Promise<{
+        allowed: boolean;
+        reason?: string;
+    }>;
+    /**
+     * Self-register new user.
+     */
+    register(username: string, email: string, password: string, tenantId: string): Promise<Record<string, unknown>>;
+    /**
+     * Verify email with token.
+     */
+    verifyEmail(token: string): Promise<Record<string, unknown>>;
+    /**
+     * Resend verification email.
+     */
+    resendVerification(email: string): Promise<Record<string, unknown>>;
+    /**
+     * Accept admin invitation and set password.
+     */
+    acceptInvitation(token: string, password: string): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=portal.d.ts.map

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

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