@aaronsb/google-workspace-mcp 2.0.0-alpha.4

package/build/__tests__/factory/patch-coverage.test.js

@@ -0,0 +1,148 @@
+/**
+ * Patch coverage report — tracks which operations have custom formatting,
+ * custom handlers, or hooks vs falling through to defaults.
+ *
+ * This isn't a pass/fail gate — it's a visibility tool. When the manifest
+ * expands, this test shows which new operations are using defaults and
+ * might benefit from a patch. When patches change, it catches regressions
+ * where an operation silently loses its custom formatter.
+ */
+import { loadManifest } from '../../factory/generator.js';
+import { patches } from '../../factory/patches.js';
+// Mock executor — patches that call execute() in custom handlers need this
+jest.mock('../../executor/gws.js');
+const manifest = loadManifest();
+/** Check if a format hook dispatches to a custom formatter for a given operation. */
+function probeFormatHook(hook, operation) {
+    if (!hook)
+        return false;
+    // Call the formatter with empty data and see if it produces something
+    // different from what the default would — we check by calling with a
+    // known operation name and seeing if the switch statement catches it
+    try {
+        const ctx = { operation, params: {}, account: 'test@test.com' };
+        const result = hook({}, ctx);
+        // If it returns without throwing, the hook handles this operation
+        return result !== undefined;
+    }
+    catch {
+        return false;
+    }
+}
+function buildCoverageMap() {
+    const entries = [];
+    for (const [serviceName, serviceDef] of Object.entries(manifest.services)) {
+        const patch = patches[serviceName];
+        for (const [opName, opDef] of Object.entries(serviceDef.operations)) {
+            entries.push({
+                service: serviceName,
+                operation: opName,
+                opType: opDef.type,
+                hasCustomHandler: Boolean(patch?.customHandlers?.[opName]),
+                hasBeforeExecute: Boolean(patch?.beforeExecute?.[opName]),
+                hasAfterExecute: Boolean(patch?.afterExecute?.[opName]),
+                usesCustomFormat: (() => {
+                    if (patch?.customHandlers?.[opName])
+                        return true; // custom handlers do their own formatting
+                    switch (opDef.type) {
+                        case 'list': return probeFormatHook(patch?.formatList, opName);
+                        case 'detail': return probeFormatHook(patch?.formatDetail, opName);
+                        case 'action': return probeFormatHook(patch?.formatAction, opName);
+                        default: return false;
+                    }
+                })(),
+            });
+        }
+    }
+    return entries;
+}
+describe('patch coverage', () => {
+    const coverage = buildCoverageMap();
+    it('reports coverage for all manifest operations', () => {
+        // This is the visibility test — it prints coverage so you can see gaps
+        const total = coverage.length;
+        const customFormatted = coverage.filter(e => e.usesCustomFormat).length;
+        const defaultFormatted = total - customFormatted;
+        const withHooks = coverage.filter(e => e.hasBeforeExecute || e.hasAfterExecute).length;
+        console.log(`\n  Patch Coverage: ${customFormatted}/${total} operations have custom formatting`);
+        console.log(`  Default formatting: ${defaultFormatted} operations`);
+        console.log(`  Lifecycle hooks: ${withHooks} operations\n`);
+        // Log per-service breakdown
+        for (const serviceName of Object.keys(manifest.services)) {
+            const serviceOps = coverage.filter(e => e.service === serviceName);
+            const custom = serviceOps.filter(e => e.usesCustomFormat);
+            const defaults = serviceOps.filter(e => !e.usesCustomFormat);
+            console.log(`  ${serviceName}: ${custom.length}/${serviceOps.length} custom`);
+            if (defaults.length > 0) {
+                console.log(`    defaults: ${defaults.map(e => e.operation).join(', ')}`);
+            }
+        }
+        expect(total).toBeGreaterThan(0);
+    });
+    // Snapshot test — catches when operations silently lose their patches
+    it('gmail core operations have custom formatting', () => {
+        const gmailCustom = coverage
+            .filter(e => e.service === 'gmail' && e.usesCustomFormat)
+            .map(e => e.operation)
+            .sort();
+        expect(gmailCustom).toContain('search');
+        expect(gmailCustom).toContain('read');
+        expect(gmailCustom).toContain('triage');
+        expect(gmailCustom).toContain('labels');
+        expect(gmailCustom).toContain('threads');
+        expect(gmailCustom).toContain('send');
+        expect(gmailCustom).toContain('reply');
+    });
+    it('calendar core operations have custom formatting', () => {
+        const calCustom = coverage
+            .filter(e => e.service === 'calendar' && e.usesCustomFormat)
+            .map(e => e.operation)
+            .sort();
+        expect(calCustom).toContain('list');
+        expect(calCustom).toContain('get');
+        expect(calCustom).toContain('calendars');
+        expect(calCustom).toContain('agenda');
+        expect(calCustom).toContain('create');
+        expect(calCustom).toContain('delete');
+    });
+    it('drive core operations have custom formatting', () => {
+        const driveCustom = coverage
+            .filter(e => e.service === 'drive' && e.usesCustomFormat)
+            .map(e => e.operation)
+            .sort();
+        expect(driveCustom).toContain('search');
+        expect(driveCustom).toContain('get');
+        expect(driveCustom).toContain('upload');
+        expect(driveCustom).toContain('download');
+    });
+    it('gmail search has afterExecute hydration hook', () => {
+        const searchEntry = coverage.find(e => e.service === 'gmail' && e.operation === 'search');
+        expect(searchEntry?.hasAfterExecute).toBe(true);
+    });
+    it('calendar list has beforeExecute hook for timeMin default', () => {
+        const listEntry = coverage.find(e => e.service === 'calendar' && e.operation === 'list');
+        expect(listEntry?.hasBeforeExecute).toBe(true);
+    });
+    it('all operations have a patch or use defaults (no orphans)', () => {
+        // Every operation should either have custom formatting OR fall through
+        // to the default formatter. This catches operations that might error
+        // because neither path handles them.
+        for (const entry of coverage) {
+            const hasPath = entry.usesCustomFormat || !entry.usesCustomFormat; // always true, but...
+            // The real check: if there IS a patch for this service, the format
+            // hooks should handle all operation types without throwing
+            const patch = patches[entry.service];
+            if (patch) {
+                const ctx = { operation: entry.operation, params: {}, account: 'test@test.com' };
+                if (entry.opType === 'list' && patch.formatList) {
+                    expect(() => patch.formatList({}, ctx)).not.toThrow();
+                }
+                if (entry.opType === 'detail' && patch.formatDetail) {
+                    expect(() => patch.formatDetail({}, ctx)).not.toThrow();
+                }
+            }
+            expect(hasPath).toBe(true);
+        }
+    });
+});
+//# sourceMappingURL=patch-coverage.test.js.map

package/build/__tests__/factory/patch-coverage.test.js.map

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

package/build/__tests__/factory/safety.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/__tests__/factory/safety.test.js

@@ -0,0 +1,107 @@
+import { configurePolicies, evaluatePolicies, draftOnlyEmail, noDelete, readOnly, auditLog, } from '../../factory/safety.js';
+function ctx(operation) {
+    return { operation, params: {}, account: 'test@test.com' };
+}
+describe('draftOnlyEmail', () => {
+    beforeAll(() => configurePolicies([draftOnlyEmail]));
+    afterAll(() => configurePolicies([]));
+    it('blocks send', () => {
+        const result = evaluatePolicies([], ctx('send'), 'gmail');
+        expect(result.action).toBe('block');
+        expect(result.reason).toContain('draft-only');
+    });
+    it('blocks reply', () => {
+        expect(evaluatePolicies([], ctx('reply'), 'gmail').action).toBe('block');
+    });
+    it('blocks replyAll', () => {
+        expect(evaluatePolicies([], ctx('replyAll'), 'gmail').action).toBe('block');
+    });
+    it('blocks forward', () => {
+        expect(evaluatePolicies([], ctx('forward'), 'gmail').action).toBe('block');
+    });
+    it('allows search', () => {
+        expect(evaluatePolicies([], ctx('search'), 'gmail').action).toBe('allow');
+    });
+    it('allows triage', () => {
+        expect(evaluatePolicies([], ctx('triage'), 'gmail').action).toBe('allow');
+    });
+    it('allows read', () => {
+        expect(evaluatePolicies([], ctx('read'), 'gmail').action).toBe('allow');
+    });
+    it('does not apply to other services', () => {
+        expect(evaluatePolicies([], ctx('delete'), 'drive').action).toBe('allow');
+    });
+});
+describe('noDelete', () => {
+    beforeAll(() => configurePolicies([noDelete]));
+    afterAll(() => configurePolicies([]));
+    it('blocks drive delete', () => {
+        const result = evaluatePolicies([], ctx('delete'), 'drive');
+        expect(result.action).toBe('block');
+        expect(result.reason).toContain('no-delete');
+    });
+    it('blocks calendar delete', () => {
+        expect(evaluatePolicies([], ctx('delete'), 'calendar').action).toBe('block');
+    });
+    it('blocks task delete', () => {
+        expect(evaluatePolicies([], ctx('delete'), 'tasks').action).toBe('block');
+    });
+    it('blocks deleteTaskList', () => {
+        expect(evaluatePolicies([], ctx('deleteTaskList'), 'tasks').action).toBe('block');
+    });
+    it('allows gmail trash (reversible)', () => {
+        expect(evaluatePolicies([], ctx('trash'), 'gmail').action).toBe('allow');
+    });
+    it('allows search', () => {
+        expect(evaluatePolicies([], ctx('search'), 'drive').action).toBe('allow');
+    });
+});
+describe('readOnly', () => {
+    beforeAll(() => configurePolicies([readOnly]));
+    afterAll(() => configurePolicies([]));
+    it('allows search', () => {
+        expect(evaluatePolicies([], ctx('search'), 'gmail').action).toBe('allow');
+    });
+    it('allows list', () => {
+        expect(evaluatePolicies([], ctx('list'), 'calendar').action).toBe('allow');
+    });
+    it('allows triage', () => {
+        expect(evaluatePolicies([], ctx('triage'), 'gmail').action).toBe('allow');
+    });
+    it('blocks send', () => {
+        expect(evaluatePolicies([], ctx('send'), 'gmail').action).toBe('block');
+    });
+    it('blocks create', () => {
+        expect(evaluatePolicies([], ctx('create'), 'calendar').action).toBe('block');
+    });
+    it('blocks delete', () => {
+        expect(evaluatePolicies([], ctx('delete'), 'drive').action).toBe('block');
+    });
+    it('blocks upload', () => {
+        expect(evaluatePolicies([], ctx('upload'), 'drive').action).toBe('block');
+    });
+});
+describe('policy composition', () => {
+    beforeAll(() => configurePolicies([auditLog, draftOnlyEmail, noDelete]));
+    afterAll(() => configurePolicies([]));
+    it('audit allows but draftOnly blocks send', () => {
+        const result = evaluatePolicies([], ctx('send'), 'gmail');
+        expect(result.action).toBe('block');
+    });
+    it('audit allows and noDelete blocks drive delete', () => {
+        const result = evaluatePolicies([], ctx('delete'), 'drive');
+        expect(result.action).toBe('block');
+    });
+    it('all allow search', () => {
+        const result = evaluatePolicies([], ctx('search'), 'gmail');
+        expect(result.action).toBe('allow');
+    });
+});
+describe('no policies configured', () => {
+    beforeAll(() => configurePolicies([]));
+    it('allows everything', () => {
+        expect(evaluatePolicies([], ctx('send'), 'gmail').action).toBe('allow');
+        expect(evaluatePolicies([], ctx('delete'), 'drive').action).toBe('allow');
+    });
+});
+//# sourceMappingURL=safety.test.js.map

package/build/__tests__/factory/safety.test.js.map

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

package/build/__tests__/integration/executor.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Integration tests for the executor layer.
+ * Runs real gws commands against the first configured account.
+ */
+export {};

package/build/__tests__/integration/executor.test.js

@@ -0,0 +1,46 @@
+/**
+ * Integration tests for the executor layer.
+ * Runs real gws commands against the first configured account.
+ */
+import { execute, gwsVersion } from '../../executor/gws.js';
+import { GwsError } from '../../executor/errors.js';
+import { getTestAccount } from './setup.js';
+const account = getTestAccount();
+const describeIf = account ? describe : describe.skip;
+describeIf('executor (integration)', () => {
+    it('gwsVersion returns a version string', async () => {
+        const version = await gwsVersion();
+        expect(version).toMatch(/gws\s+\d+\.\d+/);
+    }, 10_000);
+    it('executes gmail messages list with account credentials', async () => {
+        const result = await execute(['gmail', 'users', 'messages', 'list', '--params', JSON.stringify({ userId: 'me', maxResults: 1 })], { account: account.email });
+        expect(result.success).toBe(true);
+        expect(result.data).toHaveProperty('messages');
+        const messages = result.data.messages;
+        expect(Array.isArray(messages)).toBe(true);
+        expect(messages.length).toBeGreaterThan(0);
+        expect(messages[0]).toHaveProperty('id');
+    }, 15_000);
+    it('executes calendar list', async () => {
+        const result = await execute(['calendar', 'calendarList', 'list'], { account: account.email });
+        expect(result.success).toBe(true);
+        expect(result.data).toBeDefined();
+    }, 15_000);
+    it('rejects with GwsError for invalid API call', async () => {
+        await expect(execute(['gmail', 'users', 'messages', 'get', '--params', JSON.stringify({ userId: 'me', id: 'nonexistent-message-id-xxxxx' })], { account: account.email })).rejects.toThrow(GwsError);
+    }, 15_000);
+    it('maps exit codes correctly on auth error', async () => {
+        // Use a bogus credential file to trigger auth error
+        try {
+            await execute(['gmail', 'users', 'messages', 'list', '--params', JSON.stringify({ userId: 'me', maxResults: 1 })], { account: 'nonexistent-account@bogus.invalid' });
+            fail('Should have thrown');
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(GwsError);
+            // Could be AuthError (2) or InternalError (5) depending on gws behavior
+            // with a missing credential file — either way it should be a GwsError
+            expect(err.exitCode).toBeGreaterThan(0);
+        }
+    }, 15_000);
+});
+//# sourceMappingURL=executor.test.js.map

package/build/__tests__/integration/executor.test.js.map

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

package/build/__tests__/integration/handlers.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Integration tests for handler layer.
+ * Verifies that handlers produce correctly shaped markdown output
+ * when talking to real Google APIs through gws.
+ */
+export {};

package/build/__tests__/integration/handlers.test.js

@@ -0,0 +1,95 @@
+/**
+ * Integration tests for handler layer.
+ * Verifies that handlers produce correctly shaped markdown output
+ * when talking to real Google APIs through gws.
+ */
+// Mock registry — avoids import.meta.url in Jest
+jest.mock('../../factory/registry.js', () => {
+    const { loadManifest, generateTools } = jest.requireActual('../../factory/generator.js');
+    const { patches } = jest.requireActual('../../factory/patches.js');
+    const manifest = loadManifest();
+    return { manifest, generatedTools: generateTools(manifest, patches) };
+});
+import { handleEmail } from '../../server/handlers/email.js';
+import { handleCalendar } from '../../server/handlers/calendar.js';
+import { handleDrive } from '../../server/handlers/drive.js';
+import { handleAccounts } from '../../server/handlers/accounts.js';
+import { getTestAccount } from './setup.js';
+const account = getTestAccount();
+const describeIf = account ? describe : describe.skip;
+describeIf('handlers (integration)', () => {
+    describe('manage_accounts', () => {
+        it('list returns markdown with accounts and next-steps', async () => {
+            const result = await handleAccounts({ operation: 'list' });
+            expect(result.text).toContain('## Accounts');
+            expect(result.text).toContain('[x]'); // at least one account with credentials
+            expect(result.text).toContain('**Next steps:**');
+            expect(result.refs.count).toBeGreaterThan(0);
+            expect(result.refs.accounts).toBeDefined();
+        }, 10_000);
+    });
+    describe('manage_email', () => {
+        it('search returns markdown email list', async () => {
+            const result = await handleEmail({
+                operation: 'search',
+                email: account.email,
+                query: 'in:inbox',
+                maxResults: 3,
+            });
+            expect(typeof result.text).toBe('string');
+            expect(result.text.length).toBeGreaterThan(0);
+            expect(result.text).toContain('**Next steps:**');
+            expect(result.refs.count).toBeGreaterThanOrEqual(0);
+        }, 15_000);
+        it('read returns markdown email detail', async () => {
+            // First get a message ID
+            const list = await handleEmail({
+                operation: 'search',
+                email: account.email,
+                query: 'in:inbox',
+                maxResults: 1,
+            });
+            if (list.refs.count === 0) {
+                console.warn('No emails in inbox — skipping read test');
+                return;
+            }
+            const messageId = list.refs.messageId;
+            const result = await handleEmail({
+                operation: 'read',
+                email: account.email,
+                messageId,
+            });
+            expect(result.text).toContain('**From:**');
+            expect(result.text).toContain('**Next steps:**');
+            expect(result.refs.from).toBeDefined();
+            expect(result.refs.subject).toBeDefined();
+        }, 20_000);
+    });
+    describe('manage_calendar', () => {
+        it('list returns markdown events', async () => {
+            const result = await handleCalendar({
+                operation: 'list',
+                email: account.email,
+                maxResults: 5,
+            });
+            expect(typeof result.text).toBe('string');
+            expect(result.text.length).toBeGreaterThan(0);
+            expect(result.text).toContain('**Next steps:**');
+            expect(result.refs.count).toBeGreaterThanOrEqual(0);
+        }, 15_000);
+    });
+    describe('manage_drive', () => {
+        it('search returns markdown file list', async () => {
+            const result = await handleDrive({
+                operation: 'search',
+                email: account.email,
+                maxResults: 3,
+            });
+            expect(typeof result.text).toBe('string');
+            expect(result.text.length).toBeGreaterThan(0);
+            expect(result.text).toContain('**Next steps:**');
+            expect(result.refs.count).toBeGreaterThanOrEqual(0);
+        }, 15_000);
+    });
+});
+//# sourceMappingURL=handlers.test.js.map

package/build/__tests__/integration/handlers.test.js.map

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

package/build/__tests__/integration/setup.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Integration test setup — resolves test account from:
+ *   1. TEST_ACCOUNT env var (explicit override)
+ *   2. First account in accounts.json (default)
+ *
+ * Skips the entire suite if no accounts or credentials are configured,
+ * so CI without credentials just reports "skipped" rather than failing.
+ */
+interface TestAccount {
+    email: string;
+    credentialFile: string;
+}
+export declare function getTestAccount(): TestAccount | null;
+/**
+ * Call at the top of an integration describe block.
+ * Returns the test account or skips the suite.
+ */
+export declare function requireTestAccount(): TestAccount;
+export {};

package/build/__tests__/integration/setup.js

@@ -0,0 +1,61 @@
+/**
+ * Integration test setup — resolves test account from:
+ *   1. TEST_ACCOUNT env var (explicit override)
+ *   2. First account in accounts.json (default)
+ *
+ * Skips the entire suite if no accounts or credentials are configured,
+ * so CI without credentials just reports "skipped" rather than failing.
+ */
+import * as fs from 'node:fs';
+import { accountsFilePath, credentialPath } from '../../executor/paths.js';
+let cachedAccount;
+export function getTestAccount() {
+    if (cachedAccount !== undefined)
+        return cachedAccount;
+    try {
+        // Prefer explicit override
+        const override = process.env.TEST_ACCOUNT;
+        if (override) {
+            const credFile = credentialPath(override);
+            if (!fs.existsSync(credFile)) {
+                console.warn(`TEST_ACCOUNT=${override} but no credential file at ${credFile}`);
+                cachedAccount = null;
+                return null;
+            }
+            cachedAccount = { email: override, credentialFile: credFile };
+            return cachedAccount;
+        }
+        // Fall back to first account in registry
+        const raw = fs.readFileSync(accountsFilePath(), 'utf-8');
+        const { accounts } = JSON.parse(raw);
+        if (!accounts?.length) {
+            cachedAccount = null;
+            return null;
+        }
+        const email = accounts[0].email;
+        const credFile = credentialPath(email);
+        if (!fs.existsSync(credFile)) {
+            cachedAccount = null;
+            return null;
+        }
+        cachedAccount = { email, credentialFile: credFile };
+        return cachedAccount;
+    }
+    catch {
+        cachedAccount = null;
+        return null;
+    }
+}
+/**
+ * Call at the top of an integration describe block.
+ * Returns the test account or skips the suite.
+ */
+export function requireTestAccount() {
+    const account = getTestAccount();
+    if (!account) {
+        // Jest doesn't have suite-level skip, so we use a conditional describe pattern
+        throw new Error('No test account available — skipping integration tests');
+    }
+    return account;
+}
+//# sourceMappingURL=setup.js.map

package/build/__tests__/integration/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/__tests__/integration/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAO3E,IAAI,aAA6C,CAAC;AAElD,MAAM,UAAU,cAAc;IAC5B,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC;IAEtD,IAAI,CAAC;QACH,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;YAC1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC,gBAAgB,QAAQ,8BAA8B,QAAQ,EAAE,CAAC,CAAC;gBAC/E,aAAa,GAAG,IAAI,CAAC;gBACrB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,aAAa,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;YAC9D,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,yCAAyC;QACzC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;YACtB,aAAa,GAAG,IAAI,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAChC,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAEvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,aAAa,GAAG,IAAI,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,aAAa,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;QACpD,OAAO,aAAa,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,+EAA+E;QAC/E,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/build/__tests__/server/formatting/markdown.test.d.ts

@@ -0,0 +1 @@
+export {};