@lossless.org/nosqldb 8.0.0

package/dist_ts_debugserver/classes.debugserver.d.ts

@@ -0,0 +1,36 @@
+import type { NoSqlDbServer } from '../dist_ts/index.js';
+export interface IDebugServerOptions {
+    /** Port to listen on (default: 4000). */
+    port?: number;
+}
+/**
+ * Serves the NoSQLDB debug UI as a web application with API proxy endpoints.
+ *
+ * @example
+ * ```typescript
+ * import { NoSqlDbServer } from '@lossless.org/nosqldb';
+ * import { NoSqlDbDebugServer } from '@lossless.org/nosqldb/debugserver';
+ *
+ * const db = new NoSqlDbServer({ storage: 'memory' });
+ * await db.start();
+ *
+ * const debugServer = new NoSqlDbDebugServer(db, { port: 4000 });
+ * await debugServer.start();
+ * // Open http://localhost:4000
+ * ```
+ */
+export declare class NoSqlDbDebugServer {
+    private server;
+    private nosqldbServer;
+    private port;
+    constructor(nosqldbServer: NoSqlDbServer, options?: IDebugServerOptions);
+    private setupApiRoutes;
+    /**
+     * Start the debug server.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the debug server.
+     */
+    stop(): Promise<void>;
+}

package/dist_ts_debugserver/classes.debugserver.js

@@ -0,0 +1,95 @@
+import * as plugins from './plugins.js';
+import { files as bundledFiles } from './bundled.js';
+/**
+ * Serves the NoSQLDB debug UI as a web application with API proxy endpoints.
+ *
+ * @example
+ * ```typescript
+ * import { NoSqlDbServer } from '@lossless.org/nosqldb';
+ * import { NoSqlDbDebugServer } from '@lossless.org/nosqldb/debugserver';
+ *
+ * const db = new NoSqlDbServer({ storage: 'memory' });
+ * await db.start();
+ *
+ * const debugServer = new NoSqlDbDebugServer(db, { port: 4000 });
+ * await debugServer.start();
+ * // Open http://localhost:4000
+ * ```
+ */
+export class NoSqlDbDebugServer {
+    constructor(nosqldbServer, options = {}) {
+        this.nosqldbServer = nosqldbServer;
+        this.port = options.port ?? 4000;
+        this.server = new plugins.typedserver.TypedServer({
+            cors: true,
+            port: this.port,
+            bundledContent: bundledFiles,
+            spaFallback: true,
+            noCache: true,
+        });
+        this.setupApiRoutes();
+    }
+    setupApiRoutes() {
+        const jsonResponse = (data, status = 200) => new Response(JSON.stringify(data), {
+            status,
+            headers: { 'Content-Type': 'application/json' },
+        });
+        // Metrics
+        this.server.addRoute('/api/nosqldb/metrics', 'GET', async () => {
+            return jsonResponse(await this.nosqldbServer.getMetrics());
+        });
+        // OpLog stats
+        this.server.addRoute('/api/nosqldb/oplog/stats', 'GET', async () => {
+            return jsonResponse(await this.nosqldbServer.getOpLogStats());
+        });
+        // OpLog entries
+        this.server.addRoute('/api/nosqldb/oplog', 'GET', async (ctx) => {
+            const result = await this.nosqldbServer.getOpLog({
+                sinceSeq: ctx.query.sinceSeq ? parseInt(ctx.query.sinceSeq) : undefined,
+                limit: ctx.query.limit ? parseInt(ctx.query.limit) : undefined,
+                db: ctx.query.db || undefined,
+                collection: ctx.query.collection || undefined,
+            });
+            return jsonResponse(result);
+        });
+        // Collections
+        this.server.addRoute('/api/nosqldb/collections', 'GET', async (ctx) => {
+            const collections = await this.nosqldbServer.getCollections(ctx.query.db || undefined);
+            return jsonResponse({ collections });
+        });
+        // Documents
+        this.server.addRoute('/api/nosqldb/documents', 'GET', async (ctx) => {
+            const { db, collection } = ctx.query;
+            if (!db || !collection) {
+                return jsonResponse({ error: 'db and collection required' }, 400);
+            }
+            const limit = parseInt(ctx.query.limit ?? '50');
+            const skip = parseInt(ctx.query.skip ?? '0');
+            const result = await this.nosqldbServer.getDocuments(db, collection, limit, skip);
+            return jsonResponse(result);
+        });
+        // Revert
+        this.server.addRoute('/api/nosqldb/revert', 'GET', async (ctx) => {
+            const { seq, dryRun } = ctx.query;
+            if (!seq) {
+                return jsonResponse({ error: 'seq required' }, 400);
+            }
+            const result = await this.nosqldbServer.revertToSeq(parseInt(seq), dryRun === 'true');
+            return jsonResponse(result);
+        });
+    }
+    /**
+     * Start the debug server.
+     */
+    async start() {
+        await this.server.start();
+        console.log(`NoSQLDB Debug UI available at http://localhost:${this.port}`);
+    }
+    /**
+     * Stop the debug server.
+     */
+    async stop() {
+        await this.server.stop();
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5kZWJ1Z3NlcnZlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzX2RlYnVnc2VydmVyL2NsYXNzZXMuZGVidWdzZXJ2ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFDeEMsT0FBTyxFQUFFLEtBQUssSUFBSSxZQUFZLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFRckQ7Ozs7Ozs7Ozs7Ozs7OztHQWVHO0FBQ0gsTUFBTSxPQUFPLGtCQUFrQjtJQUs3QixZQUFZLGFBQTRCLEVBQUUsVUFBK0IsRUFBRTtRQUN6RSxJQUFJLENBQUMsYUFBYSxHQUFHLGFBQWEsQ0FBQztRQUNuQyxJQUFJLENBQUMsSUFBSSxHQUFHLE9BQU8sQ0FBQyxJQUFJLElBQUksSUFBSSxDQUFDO1FBRWpDLElBQUksQ0FBQyxNQUFNLEdBQUcsSUFBSSxPQUFPLENBQUMsV0FBVyxDQUFDLFdBQVcsQ0FBQztZQUNoRCxJQUFJLEVBQUUsSUFBSTtZQUNWLElBQUksRUFBRSxJQUFJLENBQUMsSUFBSTtZQUNmLGNBQWMsRUFBRSxZQUFZO1lBQzVCLFdBQVcsRUFBRSxJQUFJO1lBQ2pCLE9BQU8sRUFBRSxJQUFJO1NBQ2QsQ0FBQyxDQUFDO1FBRUgsSUFBSSxDQUFDLGNBQWMsRUFBRSxDQUFDO0lBQ3hCLENBQUM7SUFFTyxjQUFjO1FBQ3BCLE1BQU0sWUFBWSxHQUFHLENBQUMsSUFBUyxFQUFFLE1BQU0sR0FBRyxHQUFHLEVBQUUsRUFBRSxDQUMvQyxJQUFJLFFBQVEsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLElBQUksQ0FBQyxFQUFFO1lBQ2pDLE1BQU07WUFDTixPQUFPLEVBQUUsRUFBRSxjQUFjLEVBQUUsa0JBQWtCLEVBQUU7U0FDaEQsQ0FBQyxDQUFDO1FBRUwsVUFBVTtRQUNWLElBQUksQ0FBQyxNQUFNLENBQUMsUUFBUSxDQUFDLHNCQUFzQixFQUFFLEtBQUssRUFBRSxLQUFLLElB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

package/dist_ts_debugserver/index.d.ts

@@ -0,0 +1,2 @@
+export { NoSqlDbDebugServer } from './classes.debugserver.js';
+export type { IDebugServerOptions } from './classes.debugserver.js';

package/dist_ts_debugserver/index.js

@@ -0,0 +1,2 @@
+export { NoSqlDbDebugServer } from './classes.debugserver.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19kZWJ1Z3NlcnZlci9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQyJ9

package/dist_ts_debugserver/plugins.d.ts

@@ -0,0 +1,2 @@
+import * as typedserver from '@api.global/typedserver';
+export { typedserver };

package/dist_ts_debugserver/plugins.js

@@ -0,0 +1,3 @@
+import * as typedserver from '@api.global/typedserver';
+export { typedserver };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzX2RlYnVnc2VydmVyL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLFdBQVcsTUFBTSx5QkFBeUIsQ0FBQztBQUV2RCxPQUFPLEVBQUUsV0FBVyxFQUFFLENBQUMifQ==

package/dist_ts_debugui/index.d.ts

@@ -0,0 +1,2 @@
+export { NoSqlDbDebugUi } from './nosqldb-debugui.js';
+export type { IOpLogEntry, IOpLogResult, IOpLogStats, IRevertResult, ICollectionInfo, IDocumentsResult, INoSqlDbMetrics, } from '../dist_ts/index.js';

package/dist_ts_debugui/index.js

@@ -0,0 +1,2 @@
+export { NoSqlDbDebugUi } from './nosqldb-debugui.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19kZWJ1Z3VpL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQyJ9

package/dist_ts_debugui/nosqldb-debugui.d.ts

@@ -0,0 +1,62 @@
+import { DeesElement, type CSSResult, type TemplateResult } from './plugins.js';
+import type { NoSqlDbServer, IOpLogEntry, IOpLogStats, ICollectionInfo, INoSqlDbMetrics } from '../dist_ts/index.js';
+type TTab = 'dashboard' | 'collections' | 'oplog' | 'revert';
+export declare class NoSqlDbDebugUi extends DeesElement {
+    /** Direct server reference (Node-side usage). */
+    accessor server: NoSqlDbServer | null;
+    /** Base URL for HTTP API (browser usage, e.g. "" for same origin). When set, uses fetch instead of direct server calls. */
+    accessor apiBaseUrl: string | null;
+    accessor refreshInterval: number;
+    accessor activeTab: TTab;
+    accessor metrics: INoSqlDbMetrics | null;
+    accessor oplogStats: IOpLogStats | null;
+    accessor oplogEntries: IOpLogEntry[];
+    accessor collections: ICollectionInfo[];
+    accessor selectedCollection: {
+        db: string;
+        name: string;
+    } | null;
+    accessor documents: Record<string, any>[];
+    accessor documentsTotal: number;
+    accessor expandedOplogSeqs: Set<number>;
+    accessor revertTargetSeq: number;
+    accessor revertPreview: {
+        reverted: number;
+        entries?: any[];
+    } | null;
+    accessor revertInProgress: boolean;
+    accessor oplogFilter: {
+        op?: string;
+        collection?: string;
+    };
+    private refreshTimer;
+    static styles: CSSResult[];
+    connectedCallback(): Promise<void>;
+    disconnectedCallback(): Promise<void>;
+    private startRefreshing;
+    private stopRefreshing;
+    private get useHttp();
+    private apiFetch;
+    private refresh;
+    private loadOplog;
+    private loadCollections;
+    private selectCollection;
+    private toggleOplogEntry;
+    private handlePreviewRevert;
+    private handleExecuteRevert;
+    private switchTab;
+    private computeDiff;
+    private diffRecursive;
+    private formatValue;
+    private formatTime;
+    render(): TemplateResult;
+    private renderDashboard;
+    private formatUptime;
+    private renderCollections;
+    private renderOplog;
+    private getFilteredOplog;
+    private renderOplogEntry;
+    private renderDiffRow;
+    private renderRevert;
+}
+export {};