feat: add get() function (#709)

The `get()` function is used to access an agent if it
has been started.

src/index.ts

@@ -69,3 +69,10 @@ function mergeConfigs<T>(options: T & {debug?: T}): T {
  delete result.debug;
  return Object.assign(result, options.debug);
 }
+
+/* Used to access the agent if it has been started. Returns the agent
+ * if the agent has been started. Otherwise, `undefined` is returned.
+ */
+export function get(): Debuglet | undefined {
+ return debuglet;
+}

test/test-module.ts

@@ -15,9 +15,13 @@
  */
 
 import * as assert from 'assert';
-const m: NodeModule & {start: Function} = require('../..');
+const m: NodeModule & {
+ start: Function;
+ get: () => Debuglet | undefined;
+} = require('../..');
 import * as nock from 'nock';
 import * as nocks from './nocks';
+import {Debuglet} from '../src/agent/debuglet';
 
 nock.disableNetConnect();
 
@@ -39,4 +43,26 @@ describe('Debug module', () => {
  m.start();
  });
  });
+
+ it('should return the agent via the get() method', () => {
+ const agent = m.get();
+ assert(agent, 'Expected to get the started agent');
+ assert.strictEqual(agent!.config.projectId, '0');
+ });
+});
+
+describe('Debug module without start() called', () => {
+ it('get() should return `undefined`', () => {
+ delete require.cache[require.resolve('../..')];
+ const m: NodeModule & {
+ start: Function;
+ get: () => Debuglet | undefined;
+ } = require('../..');
+ const agent = m.get();
+ assert.strictEqual(
+ agent,
+ undefined,
+ 'Expected `undefined` since the agent was not started'
+ );
+ });
 });