@documentdb-js/shell-runtime 0.8.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation. All rights reserved.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

package/README.md

@@ -0,0 +1,94 @@
+# @documentdb-js/shell-runtime
+
+[DocumentDB](https://documentdb.io/) is an open-source document database built on PostgreSQL, with native BSON support, rich indexing, and vector search. It uses the MongoDB-compatible wire protocol, runs locally with Docker, and is MIT licensed.
+
+This package is a sandboxed JavaScript evaluation engine for DocumentDB — provides shell command handling, result transformation, and help generation. Supports both single-shot evaluation (playground/scratchpad style) and persistent REPL sessions (interactive shell style).
+
+> **Pre-1.0 notice** — The API may change between minor versions until `1.0.0` is released.
+> If you depend on this package and need stability guarantees sooner, please
+> [open an issue](https://github.com/microsoft/vscode-documentdb/issues) and let us know.
+
+## Features
+
+- **JavaScript evaluation** — executes user code in a sandboxed `vm.Context` against a target database
+- **Command interception** — routes shell commands (`help`, `exit`, `cls`) before evaluation
+- **Result transformation** — normalizes evaluation results into a protocol-agnostic `ShellEvaluationResult`
+- **Help text** — generates DocumentDB-specific help output
+- **Service provider** — bridges the evaluation engine to the MongoDB Node.js driver
+
+## Installation
+
+```bash
+npm install @documentdb-js/shell-runtime
+```
+
+Requires `mongodb` ≥ 6.0.0 as a peer dependency.
+
+## Eval Modes
+
+The runtime supports two modes via the `persistent` option:
+
+| Mode               | `persistent`      | Behavior                                                                                                                                                                   |
+| ------------------ | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Fresh context      | `false` (default) | New `ShellInstanceState` + `vm.Context` per `evaluate()` call. No variable leakage between runs.                                                                           |
+| Persistent context | `true`            | Reuses the same `ShellInstanceState`, `ShellEvaluator`, and `vm.Context` across calls. Variables, cursor state (`it`), and the `db` reference persist between evaluations. |
+
+## Usage
+
+```typescript
+import { MongoClient } from 'mongodb';
+import { DocumentDBShellRuntime } from '@documentdb-js/shell-runtime';
+
+// The caller owns the MongoClient — create, connect, and close it yourself.
+// The runtime never opens or closes the connection.
+const mongoClient = new MongoClient(connectionString);
+await mongoClient.connect();
+
+// Constructor signature:
+//   new DocumentDBShellRuntime(mongoClient, callbacks?, options?)
+//
+//   callbacks: { onConsoleOutput?, onLog? }
+//   options:   { persistent?, productName?, displayBatchSize? }
+
+// Fresh context (playground mode — default)
+const playground = new DocumentDBShellRuntime(mongoClient, {
+  onConsoleOutput: (output) => console.log(output),
+});
+const result = await playground.evaluate('db.users.find({})', 'myDatabase');
+
+// Persistent context (interactive shell mode)
+const shell = new DocumentDBShellRuntime(
+  mongoClient,
+  { onConsoleOutput: (output) => console.log(output) }, // callbacks
+  { persistent: true }, // options
+);
+await shell.evaluate('const x = 1', 'myDatabase');
+await shell.evaluate('x + 1', 'myDatabase'); // returns 2 — variable survived
+
+// Dispose the runtime when done — this does NOT close the MongoClient.
+shell.dispose();
+
+// Close the MongoClient when the session is over.
+// The runtime intentionally never closes it, so the same client
+// can be reused across multiple evaluate() calls and runtime instances.
+await mongoClient.close();
+```
+
+## Components
+
+| File                        | Role                                                                          |
+| --------------------------- | ----------------------------------------------------------------------------- |
+| `DocumentDBShellRuntime`    | Main entry point — `evaluate(code, databaseName, options)`                    |
+| `CommandInterceptor`        | Pre-eval command routing (regex-based detection)                              |
+| `ResultTransformer`         | Post-eval result normalization (cursor iteration, `cursorHasMore` extraction) |
+| `DocumentDBServiceProvider` | Evaluation engine ↔ MongoDB driver bridge (leverages `@mongosh` internals)    |
+| `HelpProvider`              | Help text generation                                                          |
+| `types.ts`                  | Public API types (`ShellEvaluationResult`, `ShellRuntimeOptions`, etc.)       |
+
+## Origin
+
+This package was developed while building features for the [DocumentDB VS Code extension](https://github.com/microsoft/vscode-documentdb), which remains the primary consumer. The runtime is designed to work with any Node.js application that has a `MongoClient` and needs to evaluate shell-style JavaScript against a DocumentDB database.
+
+## License
+
+[MIT](LICENSE.md)

package/dist/CommandInterceptor.d.ts

@@ -0,0 +1,55 @@
+import { HelpProvider } from './HelpProvider';
+import { type ShellEvaluationResult } from './types';
+/**
+ * Pre-eval command routing for shell input.
+ *
+ * Intercepts commands that should be handled without going through the
+ * @mongosh evaluation pipeline. Handles:
+ * - `help` / `help()` → show help text
+ * - `exit` / `quit` → signal shell exit
+ * - `cls` / `clear` → signal screen clear
+ */
+export declare class CommandInterceptor {
+    private readonly _helpProvider;
+    /**
+     * Matches standalone `help` invocations:
+     * - `help` (bare keyword)
+     * - `help()` (function call, no arguments)
+     * - `` help`...` `` (tagged template literal — any content between backticks)
+     *
+     * Does NOT match when `help` is part of a larger expression
+     * (e.g. `helper()`, `var help = 1`, `help("topic")`).
+     */
+    private static readonly HELP_PATTERN;
+    /**
+     * Matches standalone `exit` or `quit` keywords, with optional parens and trailing semicolon.
+     * - `exit`, `quit` (bare keywords)
+     * - `exit()`, `quit()` (function call form — common in mongosh)
+     * - `exit;`, `quit;`, `exit();`, `quit();` (with semicolon)
+     * - `  exit  `, `  quit  ` (with whitespace — trimmed before matching)
+     *
+     * Does NOT match:
+     * - `exit(0)`, `quit(0)` (function calls with arguments)
+     * - `exitFunction()`, `var exit = 1` (substrings)
+     * - `db.exit` (property access)
+     */
+    private static readonly EXIT_PATTERN;
+    /**
+     * Matches standalone `cls` or `clear` keywords, with optional trailing semicolon.
+     * - `cls`, `clear` (bare keywords)
+     * - `cls;`, `clear;` (with semicolon)
+     *
+     * Does NOT match:
+     * - `clear()`, `cls()` (function calls)
+     * - `clearInterval()`, `clearTimeout()` (substrings)
+     */
+    private static readonly CLEAR_PATTERN;
+    constructor(helpProvider?: HelpProvider);
+    /**
+     * Check if the input is a command that should be intercepted.
+     * Returns a result if intercepted, undefined if the input should
+     * proceed through normal evaluation.
+     */
+    tryIntercept(input: string): ShellEvaluationResult | undefined;
+}
+//# sourceMappingURL=CommandInterceptor.d.ts.map

package/dist/CommandInterceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandInterceptor.d.ts","sourceRoot":"","sources":["../src/CommandInterceptor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAE7C;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAEnE;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAgC;IAEpE;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAuB;gBAEhD,YAAY,CAAC,EAAE,YAAY;IAIvC;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;CA4BjE"}

package/dist/CommandInterceptor.js

@@ -0,0 +1,87 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandInterceptor = void 0;
+const HelpProvider_1 = require("./HelpProvider");
+/**
+ * Pre-eval command routing for shell input.
+ *
+ * Intercepts commands that should be handled without going through the
+ * @mongosh evaluation pipeline. Handles:
+ * - `help` / `help()` → show help text
+ * - `exit` / `quit` → signal shell exit
+ * - `cls` / `clear` → signal screen clear
+ */
+class CommandInterceptor {
+    _helpProvider;
+    /**
+     * Matches standalone `help` invocations:
+     * - `help` (bare keyword)
+     * - `help()` (function call, no arguments)
+     * - `` help`...` `` (tagged template literal — any content between backticks)
+     *
+     * Does NOT match when `help` is part of a larger expression
+     * (e.g. `helper()`, `var help = 1`, `help("topic")`).
+     */
+    static HELP_PATTERN = /^help(?:\(\)|\s*`[^]*`)?$/;
+    /**
+     * Matches standalone `exit` or `quit` keywords, with optional parens and trailing semicolon.
+     * - `exit`, `quit` (bare keywords)
+     * - `exit()`, `quit()` (function call form — common in mongosh)
+     * - `exit;`, `quit;`, `exit();`, `quit();` (with semicolon)
+     * - `  exit  `, `  quit  ` (with whitespace — trimmed before matching)
+     *
+     * Does NOT match:
+     * - `exit(0)`, `quit(0)` (function calls with arguments)
+     * - `exitFunction()`, `var exit = 1` (substrings)
+     * - `db.exit` (property access)
+     */
+    static EXIT_PATTERN = /^(?:exit|quit)(?:\(\))?;?$/;
+    /**
+     * Matches standalone `cls` or `clear` keywords, with optional trailing semicolon.
+     * - `cls`, `clear` (bare keywords)
+     * - `cls;`, `clear;` (with semicolon)
+     *
+     * Does NOT match:
+     * - `clear()`, `cls()` (function calls)
+     * - `clearInterval()`, `clearTimeout()` (substrings)
+     */
+    static CLEAR_PATTERN = /^(?:cls|clear);?$/;
+    constructor(helpProvider) {
+        this._helpProvider = helpProvider ?? new HelpProvider_1.HelpProvider();
+    }
+    /**
+     * Check if the input is a command that should be intercepted.
+     * Returns a result if intercepted, undefined if the input should
+     * proceed through normal evaluation.
+     */
+    tryIntercept(input) {
+        const trimmed = input.trim();
+        // Help command (bare, function call, or tagged template literal)
+        if (CommandInterceptor.HELP_PATTERN.test(trimmed)) {
+            return this._helpProvider.getHelpResult();
+        }
+        // Exit / quit — signal shell close
+        if (CommandInterceptor.EXIT_PATTERN.test(trimmed)) {
+            return {
+                type: 'exit',
+                printable: '',
+                durationMs: 0,
+            };
+        }
+        // Clear / cls — signal screen clear
+        if (CommandInterceptor.CLEAR_PATTERN.test(trimmed)) {
+            return {
+                type: 'clear',
+                printable: '',
+                durationMs: 0,
+            };
+        }
+        return undefined;
+    }
+}
+exports.CommandInterceptor = CommandInterceptor;
+//# sourceMappingURL=CommandInterceptor.js.map

package/dist/CommandInterceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandInterceptor.js","sourceRoot":"","sources":["../src/CommandInterceptor.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;;;AAEhG,iDAA8C;AAG9C;;;;;;;;GAQG;AACH,MAAa,kBAAkB;IACV,aAAa,CAAe;IAE7C;;;;;;;;OAQG;IACK,MAAM,CAAU,YAAY,GAAG,2BAA2B,CAAC;IAEnE;;;;;;;;;;;OAWG;IACK,MAAM,CAAU,YAAY,GAAG,4BAA4B,CAAC;IAEpE;;;;;;;;OAQG;IACK,MAAM,CAAU,aAAa,GAAG,mBAAmB,CAAC;IAE5D,YAAY,YAA2B;QACnC,IAAI,CAAC,aAAa,GAAG,YAAY,IAAI,IAAI,2BAAY,EAAE,CAAC;IAC5D,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,KAAa;QACtB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAE7B,iEAAiE;QACjE,IAAI,kBAAkB,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,CAAC;QAC9C,CAAC;QAED,mCAAmC;QACnC,IAAI,kBAAkB,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAChD,OAAO;gBACH,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,EAAE;gBACb,UAAU,EAAE,CAAC;aAChB,CAAC;QACN,CAAC;QAED,oCAAoC;QACpC,IAAI,kBAAkB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACjD,OAAO;gBACH,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,EAAE;gBACb,UAAU,EAAE,CAAC;aAChB,CAAC;QACN,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;;AA3EL,gDA4EC"}

package/dist/CommandInterceptor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CommandInterceptor.test.d.ts.map

package/dist/CommandInterceptor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandInterceptor.test.d.ts","sourceRoot":"","sources":["../src/CommandInterceptor.test.ts"],"names":[],"mappings":""}

package/dist/CommandInterceptor.test.js

@@ -0,0 +1,195 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+const CommandInterceptor_1 = require("./CommandInterceptor");
+describe('CommandInterceptor', () => {
+    let interceptor;
+    beforeEach(() => {
+        interceptor = new CommandInterceptor_1.CommandInterceptor();
+    });
+    describe('help command', () => {
+        it('intercepts "help"', () => {
+            const result = interceptor.tryIntercept('help');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('Help');
+            expect(result.durationMs).toBe(0);
+        });
+        it('intercepts "help()"', () => {
+            const result = interceptor.tryIntercept('help()');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('Help');
+        });
+        it('intercepts "help" with leading/trailing whitespace', () => {
+            const result = interceptor.tryIntercept('  help  ');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('Help');
+        });
+        it('intercepts "help()" with leading/trailing whitespace', () => {
+            const result = interceptor.tryIntercept('  help()  ');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('Help');
+        });
+        it('intercepts help with empty tagged template literal', () => {
+            const result = interceptor.tryIntercept('help``');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('Help');
+            expect(result.durationMs).toBe(0);
+        });
+        it('intercepts help with non-empty tagged template literal', () => {
+            const result = interceptor.tryIntercept('help`some content`');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('Help');
+        });
+        it('intercepts help with tagged template literal with whitespace before backtick', () => {
+            const result = interceptor.tryIntercept('help `text`');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('Help');
+        });
+        it('intercepts help tagged template literal with leading/trailing whitespace', () => {
+            const result = interceptor.tryIntercept('  help``  ');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('Help');
+        });
+        it('does not intercept "help(arg)"', () => {
+            const result = interceptor.tryIntercept('help("collections")');
+            expect(result).toBeUndefined();
+        });
+        it('does not intercept code containing "help" as substring', () => {
+            expect(interceptor.tryIntercept('var help = 1')).toBeUndefined();
+            expect(interceptor.tryIntercept('helper()')).toBeUndefined();
+        });
+    });
+    describe('exit / quit commands', () => {
+        it('intercepts "exit"', () => {
+            const result = interceptor.tryIntercept('exit');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('exit');
+            expect(result.durationMs).toBe(0);
+        });
+        it('intercepts "quit"', () => {
+            const result = interceptor.tryIntercept('quit');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('exit');
+            expect(result.durationMs).toBe(0);
+        });
+        it('intercepts "exit" with leading/trailing whitespace', () => {
+            const result = interceptor.tryIntercept('  exit  ');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('exit');
+        });
+        it('intercepts "quit" with leading/trailing whitespace', () => {
+            const result = interceptor.tryIntercept('  quit  ');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('exit');
+        });
+        it('intercepts "exit;" with trailing semicolon', () => {
+            const result = interceptor.tryIntercept('exit;');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('exit');
+        });
+        it('intercepts "quit;" with trailing semicolon', () => {
+            const result = interceptor.tryIntercept('quit;');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('exit');
+        });
+        it('intercepts "exit()" as exit command', () => {
+            const result = interceptor.tryIntercept('exit()');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('exit');
+        });
+        it('intercepts "quit()" as exit command', () => {
+            const result = interceptor.tryIntercept('quit()');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('exit');
+        });
+        it('intercepts "exit();" with trailing semicolon', () => {
+            const result = interceptor.tryIntercept('exit();');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('exit');
+        });
+        it('intercepts "quit();" with trailing semicolon', () => {
+            const result = interceptor.tryIntercept('quit();');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('exit');
+        });
+        it('does not intercept "exitFunction()"', () => {
+            expect(interceptor.tryIntercept('exitFunction()')).toBeUndefined();
+        });
+        it('does not intercept "var exit = 1"', () => {
+            expect(interceptor.tryIntercept('var exit = 1')).toBeUndefined();
+        });
+        it('does not intercept "db.exit"', () => {
+            expect(interceptor.tryIntercept('db.exit')).toBeUndefined();
+        });
+        it('does not intercept "process.exit(0)"', () => {
+            expect(interceptor.tryIntercept('process.exit(0)')).toBeUndefined();
+        });
+    });
+    describe('cls / clear commands', () => {
+        it('intercepts "cls"', () => {
+            const result = interceptor.tryIntercept('cls');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('clear');
+            expect(result.durationMs).toBe(0);
+        });
+        it('intercepts "clear"', () => {
+            const result = interceptor.tryIntercept('clear');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('clear');
+            expect(result.durationMs).toBe(0);
+        });
+        it('intercepts "cls" with leading/trailing whitespace', () => {
+            const result = interceptor.tryIntercept('  cls  ');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('clear');
+        });
+        it('intercepts "clear" with leading/trailing whitespace', () => {
+            const result = interceptor.tryIntercept('  clear  ');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('clear');
+        });
+        it('intercepts "cls;" with trailing semicolon', () => {
+            const result = interceptor.tryIntercept('cls;');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('clear');
+        });
+        it('intercepts "clear;" with trailing semicolon', () => {
+            const result = interceptor.tryIntercept('clear;');
+            expect(result).toBeDefined();
+            expect(result.type).toBe('clear');
+        });
+        it('does not intercept "clear()"', () => {
+            expect(interceptor.tryIntercept('clear()')).toBeUndefined();
+        });
+        it('does not intercept "cls()"', () => {
+            expect(interceptor.tryIntercept('cls()')).toBeUndefined();
+        });
+        it('does not intercept "clearInterval()"', () => {
+            expect(interceptor.tryIntercept('clearInterval()')).toBeUndefined();
+        });
+        it('does not intercept "clearTimeout(timer)"', () => {
+            expect(interceptor.tryIntercept('clearTimeout(timer)')).toBeUndefined();
+        });
+        it('does not intercept "var clear = true"', () => {
+            expect(interceptor.tryIntercept('var clear = true')).toBeUndefined();
+        });
+        it('does not intercept "db.clear"', () => {
+            expect(interceptor.tryIntercept('db.clear')).toBeUndefined();
+        });
+    });
+    describe('non-intercepted input', () => {
+        it('does not intercept regular code', () => {
+            expect(interceptor.tryIntercept('db.users.find({})')).toBeUndefined();
+            expect(interceptor.tryIntercept('show dbs')).toBeUndefined();
+            expect(interceptor.tryIntercept('use admin')).toBeUndefined();
+        });
+        it('does not intercept empty input', () => {
+            expect(interceptor.tryIntercept('')).toBeUndefined();
+            expect(interceptor.tryIntercept('   ')).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=CommandInterceptor.test.js.map

package/dist/CommandInterceptor.test.js.map

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

package/dist/DocumentDBServiceProvider.d.ts

@@ -0,0 +1,48 @@
+import { NodeDriverServiceProvider } from '@mongosh/service-provider-node-driver';
+import { EventEmitter } from 'events';
+import { type MongoClient } from 'mongodb';
+/**
+ * Result of creating a DocumentDB service provider.
+ * Returns both the provider and the event bus (needed by ShellInstanceState).
+ */
+export interface ServiceProviderWithBus {
+    readonly serviceProvider: DocumentDBServiceProvider;
+    readonly bus: EventEmitter;
+}
+/**
+ * DocumentDB-specific service provider for @mongosh.
+ *
+ * Currently a thin wrapper around `NodeDriverServiceProvider` that configures
+ * DocumentDB-specific product metadata.
+ *
+ * Future extensions:
+ * - Block unsupported operations (e.g. `watch()`, `createChangeStream()`)
+ *   with clear "Not supported by DocumentDB" error messages
+ * - Override methods to provide DocumentDB-specific behavior
+ *
+ * @see future-work.md §"operator-registry.methods" for the planned
+ *   unsupported-method blocking via a static method registry.
+ */
+export declare class DocumentDBServiceProvider extends NodeDriverServiceProvider {
+    /**
+     * Create a DocumentDB service provider from an existing MongoClient.
+     *
+     * Returns both the provider and the shared event bus (needed by
+     * `ShellInstanceState` constructor).
+     *
+     * @param mongoClient - Connected MongoClient instance (caller owns lifecycle)
+     * @param productName - Product name for @mongosh metadata
+     * @param productDocsLink - Product documentation link for @mongosh metadata
+     */
+    static createForDocumentDB(mongoClient: MongoClient, productName?: string, productDocsLink?: string): ServiceProviderWithBus;
+    /**
+     * Override close() to NOT close the underlying MongoClient.
+     *
+     * The caller (worker thread) owns the MongoClient lifecycle. The base
+     * class's close() calls `mongoClient.close()`, which would break
+     * subsequent evaluations in fresh-context mode (playground) where
+     * `ShellInstanceState.close()` cascades through the service provider.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=DocumentDBServiceProvider.d.ts.map

package/dist/DocumentDBServiceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentDBServiceProvider.d.ts","sourceRoot":"","sources":["../src/DocumentDBServiceProvider.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAK3C;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACnC,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;IACpD,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;CAC9B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAA0B,SAAQ,yBAAyB;IACpE;;;;;;;;;OASG;IACH,MAAM,CAAC,mBAAmB,CACtB,WAAW,EAAE,WAAW,EACxB,WAAW,CAAC,EAAE,MAAM,EACpB,eAAe,CAAC,EAAE,MAAM,GACzB,sBAAsB;IASzB;;;;;;;OAOG;IACY,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAIxC"}

package/dist/DocumentDBServiceProvider.js

@@ -0,0 +1,59 @@
+"use strict";
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentDBServiceProvider = void 0;
+const service_provider_node_driver_1 = require("@mongosh/service-provider-node-driver");
+const events_1 = require("events");
+const DEFAULT_PRODUCT_NAME = 'DocumentDB for VS Code';
+const DEFAULT_PRODUCT_DOCS_LINK = 'https://github.com/microsoft/vscode-documentdb';
+/**
+ * DocumentDB-specific service provider for @mongosh.
+ *
+ * Currently a thin wrapper around `NodeDriverServiceProvider` that configures
+ * DocumentDB-specific product metadata.
+ *
+ * Future extensions:
+ * - Block unsupported operations (e.g. `watch()`, `createChangeStream()`)
+ *   with clear "Not supported by DocumentDB" error messages
+ * - Override methods to provide DocumentDB-specific behavior
+ *
+ * @see future-work.md §"operator-registry.methods" for the planned
+ *   unsupported-method blocking via a static method registry.
+ */
+class DocumentDBServiceProvider extends service_provider_node_driver_1.NodeDriverServiceProvider {
+    /**
+     * Create a DocumentDB service provider from an existing MongoClient.
+     *
+     * Returns both the provider and the shared event bus (needed by
+     * `ShellInstanceState` constructor).
+     *
+     * @param mongoClient - Connected MongoClient instance (caller owns lifecycle)
+     * @param productName - Product name for @mongosh metadata
+     * @param productDocsLink - Product documentation link for @mongosh metadata
+     */
+    static createForDocumentDB(mongoClient, productName, productDocsLink) {
+        const bus = new events_1.EventEmitter();
+        const serviceProvider = new DocumentDBServiceProvider(mongoClient, bus, {
+            productDocsLink: productDocsLink ?? DEFAULT_PRODUCT_DOCS_LINK,
+            productName: productName ?? DEFAULT_PRODUCT_NAME,
+        });
+        return { serviceProvider, bus };
+    }
+    /**
+     * Override close() to NOT close the underlying MongoClient.
+     *
+     * The caller (worker thread) owns the MongoClient lifecycle. The base
+     * class's close() calls `mongoClient.close()`, which would break
+     * subsequent evaluations in fresh-context mode (playground) where
+     * `ShellInstanceState.close()` cascades through the service provider.
+     */
+    async close() {
+        // Intentionally empty — the MongoClient is owned by the worker thread
+        // and will be closed when the worker shuts down.
+    }
+}
+exports.DocumentDBServiceProvider = DocumentDBServiceProvider;
+//# sourceMappingURL=DocumentDBServiceProvider.js.map

package/dist/DocumentDBServiceProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentDBServiceProvider.js","sourceRoot":"","sources":["../src/DocumentDBServiceProvider.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;;;AAEhG,wFAAkF;AAClF,mCAAsC;AAGtC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AACtD,MAAM,yBAAyB,GAAG,gDAAgD,CAAC;AAWnF;;;;;;;;;;;;;GAaG;AACH,MAAa,yBAA0B,SAAQ,wDAAyB;IACpE;;;;;;;;;OASG;IACH,MAAM,CAAC,mBAAmB,CACtB,WAAwB,EACxB,WAAoB,EACpB,eAAwB;QAExB,MAAM,GAAG,GAAG,IAAI,qBAAY,EAAE,CAAC;QAC/B,MAAM,eAAe,GAAG,IAAI,yBAAyB,CAAC,WAAW,EAAE,GAAG,EAAE;YACpE,eAAe,EAAE,eAAe,IAAI,yBAAyB;YAC7D,WAAW,EAAE,WAAW,IAAI,oBAAoB;SACnD,CAAC,CAAC;QACH,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACM,KAAK,CAAC,KAAK;QAChB,sEAAsE;QACtE,iDAAiD;IACrD,CAAC;CACJ;AApCD,8DAoCC"}