@peernova/cuneiform-sf 1.0.2 → 1.0.4-beta.8

package/lib/adapters/testing/mock-connection.js

@@ -0,0 +1,207 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+/**
+ * Creates a mock connection facade for testing adapters.
+ *
+ * @param config - Optional configuration
+ * @returns Mock connection facade with call recording
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const { connection } = createMockConnection();
+ * const adapter = new SoqlQueryAdapter(connection);
+ *
+ * // With configuration
+ * const { connection, calls } = createMockConnection({
+ *   version: '58.0',
+ *   defaultQueryResult: { done: true, totalSize: 0, records: [] }
+ * });
+ * ```
+ */
+export function createMockConnection(config) {
+    const calls = [];
+    const queryResults = new Map();
+    const describeResults = new Map();
+    const errors = new Map();
+    const executeAnonymousResults = new Map();
+    const requestResults = new Map();
+    /* eslint-disable camelcase -- Salesforce API uses snake_case for identity response */
+    let identityResult = config?.defaultIdentity ?? {
+        user_id: '005xx000001ABCDEF',
+        organization_id: '00Dxx000001ABCDEF',
+        username: 'test@example.com',
+    };
+    /* eslint-enable camelcase */
+    const throws = new Map();
+    const recordCall = (method, args) => {
+        calls.push({ method, args, timestamp: Date.now() });
+    };
+    const checkThrow = (method, key) => {
+        const throwKey = `${method}:${key}`;
+        const throwError = throws.get(throwKey);
+        if (throwError) {
+            throw throwError;
+        }
+    };
+    const checkError = (method, key) => {
+        const errorKey = `${method}:${key}`;
+        const error = errors.get(errorKey);
+        if (error) {
+            throw error;
+        }
+    };
+    const tooling = {
+        query: (soql) => {
+            recordCall('tooling.query', [soql]);
+            checkThrow('tooling.query', soql);
+            checkError('tooling.query', soql);
+            const result = queryResults.get(`tooling:${soql}`);
+            if (result)
+                return Promise.resolve(result);
+            return Promise.resolve((config?.defaultQueryResult ?? { done: true, totalSize: 0, records: [] }));
+        },
+        queryMore: (locator) => {
+            recordCall('tooling.queryMore', [locator]);
+            checkThrow('tooling.queryMore', locator);
+            checkError('tooling.queryMore', locator);
+            const result = queryResults.get(`tooling:more:${locator}`);
+            if (result)
+                return Promise.resolve(result);
+            return Promise.resolve({ done: true, totalSize: 0, records: [] });
+        },
+        executeAnonymous: (apex) => {
+            recordCall('tooling.executeAnonymous', [apex]);
+            checkThrow('tooling.executeAnonymous', apex);
+            checkError('tooling.executeAnonymous', apex);
+            const result = executeAnonymousResults.get(apex);
+            if (result)
+                return Promise.resolve(result);
+            return Promise.resolve({ success: true, compiled: true });
+        },
+        create: (type, record) => {
+            recordCall('tooling.create', [type, record]);
+            checkThrow('tooling.create', type);
+            checkError('tooling.create', type);
+            return Promise.resolve({ id: `${type}Id123`, success: true });
+        },
+        destroy: (type, id) => {
+            recordCall('tooling.destroy', [type, id]);
+            checkThrow('tooling.destroy', `${type}:${id}`);
+            checkError('tooling.destroy', `${type}:${id}`);
+            return Promise.resolve({ id, success: true });
+        },
+    };
+    const createSObjectApi = (name) => ({
+        describe: () => {
+            recordCall('sobject.describe', [name]);
+            checkError('sobject.describe', name);
+            const result = describeResults.get(name);
+            if (result)
+                return Promise.resolve(result);
+            return Promise.resolve(config?.defaultDescribeResult ?? {
+                name,
+                label: name,
+                labelPlural: `${name}s`,
+                custom: false,
+                createable: true,
+                updateable: true,
+                deletable: true,
+                queryable: true,
+                searchable: true,
+                fields: [],
+            });
+        },
+        find: (conditions, fields) => {
+            recordCall('sobject.find', [name, conditions, fields]);
+            return {
+                limit: () => createSObjectApi(name).find(conditions, fields),
+                execute: () => {
+                    recordCall('sobject.find.execute', [name, conditions, fields]);
+                    return Promise.resolve([]);
+                },
+            };
+        },
+    });
+    const connection = {
+        tooling,
+        version: config?.version ?? '58.0',
+        accessToken: config?.accessToken ?? 'mock-access-token',
+        instanceUrl: config?.instanceUrl ?? 'https://test.salesforce.com',
+        query: (soql) => {
+            recordCall('query', [soql]);
+            checkThrow('query', soql);
+            checkError('query', soql);
+            const result = queryResults.get(soql);
+            if (result)
+                return Promise.resolve(result);
+            return Promise.resolve((config?.defaultQueryResult ?? { done: true, totalSize: 0, records: [] }));
+        },
+        queryMore: (locator) => {
+            recordCall('queryMore', [locator]);
+            checkThrow('queryMore', locator);
+            checkError('queryMore', locator);
+            const result = queryResults.get(`more:${locator}`);
+            if (result)
+                return Promise.resolve(result);
+            return Promise.resolve({ done: true, totalSize: 0, records: [] });
+        },
+        sobject: (name) => {
+            recordCall('sobject', [name]);
+            return createSObjectApi(name);
+        },
+        request: (request) => {
+            const url = typeof request === 'string' ? request : request.url;
+            recordCall('request', [request]);
+            checkThrow('request', url);
+            checkError('request', url);
+            const result = requestResults.get(url);
+            if (result)
+                return Promise.resolve(result);
+            return Promise.resolve({});
+        },
+        identity: () => {
+            recordCall('identity', []);
+            checkThrow('identity', '');
+            checkError('identity', '');
+            return Promise.resolve(identityResult);
+        },
+    };
+    return {
+        connection,
+        calls,
+        resetCalls: () => {
+            calls.length = 0;
+        },
+        setQueryResult: (soql, result) => {
+            queryResults.set(soql, result);
+        },
+        setDescribeResult: (objectName, result) => {
+            describeResults.set(objectName, result);
+        },
+        setError: (method, key, error) => {
+            errors.set(`${method}:${key}`, error);
+        },
+        setIdentity: (identity) => {
+            identityResult = identity;
+        },
+        setExecuteAnonymousResult: (apex, result) => {
+            executeAnonymousResults.set(apex, result);
+        },
+        setRequestResult: (url, result) => {
+            requestResults.set(url, result);
+        },
+        setThrow: (method, key, error) => {
+            throws.set(`${method}:${key}`, error);
+        },
+        clearThrow: (method, key) => {
+            throws.delete(`${method}:${key}`);
+        },
+    };
+}
+//# sourceMappingURL=mock-connection.js.map

package/lib/adapters/testing/mock-connection.js.map

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

package/lib/adapters/testing/mock-logger.d.ts

@@ -0,0 +1,29 @@
+import sinon from 'sinon';
+/**
+ * Result of creating a mock logger.
+ */
+export type MockLogger = {
+    /** Type-safe Console mock with all methods stubbed */
+    logger: Console;
+    /** Direct reference to the log stub for assertion access */
+    logStub: sinon.SinonStub;
+    /** Direct reference to the warn stub for assertion access */
+    warnStub: sinon.SinonStub;
+};
+/**
+ * Create a type-safe mock Console logger for testing.
+ *
+ * Replaces the common `{ log: sinon.stub() } as unknown as Console` pattern
+ * with a properly typed factory that satisfies the Console interface.
+ *
+ * @returns MockLogger with logger instance and direct stub references
+ *
+ * @example
+ * ```typescript
+ * const { logger, logStub } = createMockLogger();
+ * const service = new MyService(connection, config, logger);
+ * await service.doWork();
+ * expect(logStub.calledWith('Processing...')).to.be.true;
+ * ```
+ */
+export declare function createMockLogger(): MockLogger;

package/lib/adapters/testing/mock-logger.js

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+// eslint-disable-next-line import/no-extraneous-dependencies -- test-only factory, sinon is a devDependency
+import sinon from 'sinon';
+/**
+ * Create a type-safe mock Console logger for testing.
+ *
+ * Replaces the common `{ log: sinon.stub() } as unknown as Console` pattern
+ * with a properly typed factory that satisfies the Console interface.
+ *
+ * @returns MockLogger with logger instance and direct stub references
+ *
+ * @example
+ * ```typescript
+ * const { logger, logStub } = createMockLogger();
+ * const service = new MyService(connection, config, logger);
+ * await service.doWork();
+ * expect(logStub.calledWith('Processing...')).to.be.true;
+ * ```
+ */
+export function createMockLogger() {
+    const logStub = sinon.stub();
+    const warnStub = sinon.stub();
+    // Build a Console-compatible object with all required methods stubbed
+    const logger = {
+        log: logStub,
+        warn: warnStub,
+        error: sinon.stub(),
+        info: sinon.stub(),
+        debug: sinon.stub(),
+        dir: sinon.stub(),
+        dirxml: sinon.stub(),
+        table: sinon.stub(),
+        trace: sinon.stub(),
+        assert: sinon.stub(),
+        clear: sinon.stub(),
+        count: sinon.stub(),
+        countReset: sinon.stub(),
+        group: sinon.stub(),
+        groupCollapsed: sinon.stub(),
+        groupEnd: sinon.stub(),
+        time: sinon.stub(),
+        timeEnd: sinon.stub(),
+        timeLog: sinon.stub(),
+        timeStamp: sinon.stub(),
+        profile: sinon.stub(),
+        profileEnd: sinon.stub(),
+        Console: console.Console, // eslint-disable-line no-console -- required Console constructor property
+    };
+    return { logger, logStub, warnStub };
+}
+//# sourceMappingURL=mock-logger.js.map

package/lib/adapters/testing/mock-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-logger.js","sourceRoot":"","sources":["../../../src/adapters/testing/mock-logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4GAA4G;AAC5G,OAAO,KAAK,MAAM,OAAO,CAAC;AAc1B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE9B,sEAAsE;IACtE,MAAM,MAAM,GAAG;QACb,GAAG,EAAE,OAAO;QACZ,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QACnB,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;QAClB,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QACnB,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE;QACjB,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE;QACpB,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QACnB,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QACnB,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE;QACpB,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QACnB,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QACnB,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE;QACxB,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QACnB,cAAc,EAAE,KAAK,CAAC,IAAI,EAAE;QAC5B,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;QAClB,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE;QACrB,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE;QACrB,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE;QACvB,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE;QACrB,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,0EAA0E;KAC/E,CAAC;IAExB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACvC,CAAC"}

package/lib/adapters/testing/mock-mcp-adapters.d.ts

@@ -0,0 +1,32 @@
+import type { McpAdapters } from '../../mcp/config/mcp-config.js';
+import type { IConnectionFacade } from '../connection-facade.js';
+import { type MockSalesforceConnectionConfig } from './mock-salesforce-connection.js';
+/**
+ * Configuration for McpAdapters mock.
+ */
+export type MockMcpAdaptersConfig = MockSalesforceConnectionConfig & {
+    /** Override the facade mock (e.g., to provide identity() or instanceUrl) */
+    readonly facade?: Partial<IConnectionFacade>;
+};
+/**
+ * Creates a mock McpAdapters suitable for MCP handler unit tests.
+ *
+ * Handler tests stub at the service level (e.g., `sinon.stub(ProfilingDefinitionService.prototype)`),
+ * so the adapter fields only need to satisfy the TypeScript type — they are never invoked directly.
+ * The single `as unknown as` casts are isolated here so test files have zero type-safety bypasses.
+ *
+ * @param config - Optional overrides for connection and facade properties
+ * @returns A McpAdapters-typed mock
+ *
+ * @example
+ * ```typescript
+ * import { createMockAdapters } from '../../../src/adapters/testing/index.js';
+ *
+ * let mockAdapters: McpAdapters;
+ *
+ * beforeEach(() => {
+ *   mockAdapters = createMockAdapters();
+ * });
+ * ```
+ */
+export declare function createMockAdapters(config?: MockMcpAdaptersConfig): McpAdapters;

package/lib/adapters/testing/mock-mcp-adapters.js

@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+import { createMockSalesforceConnection } from './mock-salesforce-connection.js';
+/**
+ * Creates a mock McpAdapters suitable for MCP handler unit tests.
+ *
+ * Handler tests stub at the service level (e.g., `sinon.stub(ProfilingDefinitionService.prototype)`),
+ * so the adapter fields only need to satisfy the TypeScript type — they are never invoked directly.
+ * The single `as unknown as` casts are isolated here so test files have zero type-safety bypasses.
+ *
+ * @param config - Optional overrides for connection and facade properties
+ * @returns A McpAdapters-typed mock
+ *
+ * @example
+ * ```typescript
+ * import { createMockAdapters } from '../../../src/adapters/testing/index.js';
+ *
+ * let mockAdapters: McpAdapters;
+ *
+ * beforeEach(() => {
+ *   mockAdapters = createMockAdapters();
+ * });
+ * ```
+ */
+export function createMockAdapters(config) {
+    const connection = createMockSalesforceConnection(config);
+    /* eslint-disable camelcase -- Salesforce Identity API returns snake_case fields */
+    const defaultFacade = {
+        identity: () => Promise.resolve({
+            user_id: 'test-user',
+            organization_id: 'test-org',
+            username: config?.username ?? 'test@example.com',
+        }),
+        instanceUrl: config?.instanceUrl ?? 'https://test.salesforce.com',
+        ...config?.facade,
+    };
+    /* eslint-enable camelcase */
+    // eslint-disable-next-line test-quality/no-type-safety-bypass -- isolated cast: adapters are never invoked in handler tests (services are stubbed); only type satisfaction is needed
+    return {
+        connection,
+        facade: defaultFacade,
+        soql: {},
+        rest: {},
+        tooling: {},
+    };
+}
+//# sourceMappingURL=mock-mcp-adapters.js.map

package/lib/adapters/testing/mock-mcp-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-mcp-adapters.js","sourceRoot":"","sources":["../../../src/adapters/testing/mock-mcp-adapters.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,8BAA8B,EAAuC,MAAM,iCAAiC,CAAC;AAUtH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA8B;IAC/D,MAAM,UAAU,GAAe,8BAA8B,CAAC,MAAM,CAAC,CAAC;IAEtE,mFAAmF;IACnF,MAAM,aAAa,GAAG;QACpB,QAAQ,EAAE,GAAG,EAAE,CACb,OAAO,CAAC,OAAO,CAAC;YACd,OAAO,EAAE,WAAW;YACpB,eAAe,EAAE,UAAU;YAC3B,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,kBAAkB;SACjD,CAAC;QACJ,WAAW,EAAE,MAAM,EAAE,WAAW,IAAI,6BAA6B;QACjE,GAAG,MAAM,EAAE,MAAM;KAClB,CAAC;IACF,6BAA6B;IAE7B,qLAAqL;IACrL,OAAO;QACL,UAAU;QACV,MAAM,EAAE,aAAiD;QACzD,IAAI,EAAE,EAAoC;QAC1C,IAAI,EAAE,EAAoC;QAC1C,OAAO,EAAE,EAAuC;KACjD,CAAC;AACJ,CAAC"}

package/lib/adapters/testing/mock-oclif-config.d.ts

@@ -0,0 +1,22 @@
+import sinon from 'sinon';
+import type { Config } from '@oclif/core';
+/**
+ * Creates a minimal mock oclif Config object for use in SfCommand unit tests.
+ *
+ * SfCommand constructors require a Config instance, but tests that stub `parse()` never
+ * access it at runtime. This factory satisfies the type system without requiring a real
+ * oclif config, eliminating the `{} as never` pattern across command test files.
+ *
+ * All methods are sinon stubs. All required properties are populated with sensible test
+ * defaults. Optional overrides let individual tests supply specific values when needed.
+ *
+ * @param sandbox - Sinon sandbox used to create all method stubs (enables automatic restore)
+ * @param overrides - Optional partial Config values to override defaults
+ * @returns A Config-compatible object with stubbed methods
+ *
+ * @example
+ * ```typescript
+ * const cmd = new SummaryStop([], createMockOclifConfig($$.SANDBOX));
+ * ```
+ */
+export declare function createMockOclifConfig(sandbox: sinon.SinonSandbox, overrides?: Partial<Config>): Config;

package/lib/adapters/testing/mock-oclif-config.js

@@ -0,0 +1,90 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+/**
+ * Creates a minimal mock oclif Config object for use in SfCommand unit tests.
+ *
+ * SfCommand constructors require a Config instance, but tests that stub `parse()` never
+ * access it at runtime. This factory satisfies the type system without requiring a real
+ * oclif config, eliminating the `{} as never` pattern across command test files.
+ *
+ * All methods are sinon stubs. All required properties are populated with sensible test
+ * defaults. Optional overrides let individual tests supply specific values when needed.
+ *
+ * @param sandbox - Sinon sandbox used to create all method stubs (enables automatic restore)
+ * @param overrides - Optional partial Config values to override defaults
+ * @returns A Config-compatible object with stubbed methods
+ *
+ * @example
+ * ```typescript
+ * const cmd = new SummaryStop([], createMockOclifConfig($$.SANDBOX));
+ * ```
+ */
+export function createMockOclifConfig(sandbox, overrides = {}) {
+    // Cast to Config: the class has private/protected fields (warned, _base, etc.) that are
+    // unreachable from outside. Tests that use this factory stub parse() and never access the
+    // config object at runtime, so the incomplete implementation is safe.
+    const config = {
+        // Required string properties
+        arch: 'x64',
+        bin: 'sf',
+        cacheDir: '/tmp/sf-test-cache',
+        channel: 'stable',
+        configDir: '/tmp/sf-test-config',
+        dataDir: '/tmp/sf-test-data',
+        dirname: 'sf',
+        home: '/tmp/sf-test-home',
+        name: '@peernova/cuneiform-sf',
+        root: '/tmp/sf-test-root',
+        shell: 'zsh',
+        userAgent: 'sf/0.0.0',
+        version: '0.0.0',
+        // Required boolean properties
+        isSingleCommandCLI: false,
+        valid: true,
+        windows: false,
+        // Required array properties
+        commandIDs: [],
+        commands: [],
+        topics: [],
+        // Required map/object properties
+        plugins: new Map(),
+        // Required complex properties
+        topicSeparator: ':',
+        platform: 'darwin',
+        pjson: {
+            name: '@peernova/cuneiform-sf',
+            version: '0.0.0',
+            oclif: {},
+        },
+        updateConfig: {},
+        versionDetails: {
+            architecture: 'x64',
+            cliVersion: '0.0.0',
+            nodeVersion: 'v20.0.0',
+        },
+        // Required stub methods
+        findCommand: sandbox.stub().returns(undefined),
+        findMatches: sandbox.stub().returns([]),
+        findTopic: sandbox.stub().returns(undefined),
+        getAllCommandIDs: sandbox.stub().returns([]),
+        getAllCommands: sandbox.stub().returns([]),
+        getPluginsList: sandbox.stub().returns([]),
+        runCommand: sandbox.stub().resolves(),
+        runHook: sandbox.stub().resolves({ successes: [], failures: [] }),
+        s3Key: sandbox.stub().returns(''),
+        s3Url: sandbox.stub().returns(''),
+        scopedEnvVar: sandbox.stub().returns(undefined),
+        scopedEnvVarKey: sandbox.stub().returns(''),
+        scopedEnvVarKeys: sandbox.stub().returns([]),
+        scopedEnvVarTrue: sandbox.stub().returns(false),
+        // Apply any test-specific overrides
+        ...overrides,
+    };
+    return config;
+}
+//# sourceMappingURL=mock-oclif-config.js.map

package/lib/adapters/testing/mock-oclif-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-oclif-config.js","sourceRoot":"","sources":["../../../src/adapters/testing/mock-oclif-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA2B,EAAE,YAA6B,EAAE;IAChG,wFAAwF;IACxF,0FAA0F;IAC1F,sEAAsE;IACtE,MAAM,MAAM,GAAG;QACb,6BAA6B;QAC7B,IAAI,EAAE,KAAK;QACX,GAAG,EAAE,IAAI;QACT,QAAQ,EAAE,oBAAoB;QAC9B,OAAO,EAAE,QAAQ;QACjB,SAAS,EAAE,qBAAqB;QAChC,OAAO,EAAE,mBAAmB;QAC5B,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,wBAAwB;QAC9B,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,UAAU;QACrB,OAAO,EAAE,OAAO;QAEhB,8BAA8B;QAC9B,kBAAkB,EAAE,KAAK;QACzB,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,KAAK;QAEd,4BAA4B;QAC5B,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,EAAE;QAEV,iCAAiC;QACjC,OAAO,EAAE,IAAI,GAAG,EAAE;QAElB,8BAA8B;QAC9B,cAAc,EAAE,GAAG;QACnB,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE;YACL,IAAI,EAAE,wBAAwB;YAC9B,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,EAAE;SACV;QACD,YAAY,EAAE,EAAE;QAChB,cAAc,EAAE;YACd,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,OAAO;YACnB,WAAW,EAAE,SAAS;SACvB;QAED,wBAAwB;QACxB,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,SAAS,CAA0B;QACvE,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAA0B;QAChE,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,SAAS,CAAwB;QACnE,gBAAgB,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAA+B;QAC1E,cAAc,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAA6B;QACtE,cAAc,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAA6B;QACtE,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,QAAQ,EAA0B;QAC7D,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAsB;QACtF,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAAoB;QACpD,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAAoB;QACpD,YAAY,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,SAAS,CAA2B;QACzE,eAAe,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAA8B;QACxE,gBAAgB,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,CAA+B;QAC1E,gBAAgB,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,CAA+B;QAE7E,oCAAoC;QACpC,GAAG,SAAS;KACQ,CAAC;IAEvB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/adapters/testing/mock-rest-adapter.d.ts

@@ -0,0 +1,26 @@
+import type { IRestApiAdapter } from '../rest/rest-api-adapter.js';
+import type { MockAdapterConfig, MockAdapter } from './types.js';
+/**
+ * Creates a mock REST API adapter for testing.
+ *
+ * @param config - Optional configuration for responses and errors
+ * @returns Mock adapter with call recording
+ *
+ * @example
+ * ```typescript
+ * const { adapter, calls, setResponse, setError } = createMockRestApiAdapter();
+ *
+ * // Configure describe result
+ * setResponse('describe:Account', {
+ *   name: 'Account',
+ *   label: 'Account',
+ *   fields: [{ name: 'Id', type: 'id' }]
+ * });
+ *
+ * // Use in test
+ * const result = await adapter.describeObject('Account');
+ * expect(result.success).to.be.true;
+ * expect(calls).to.have.lengthOf(1);
+ * ```
+ */
+export declare function createMockRestApiAdapter(config?: MockAdapterConfig<unknown>): MockAdapter<IRestApiAdapter>;