@thymian/core-testing 0.0.0-PLACEHOLDER

package/dist/mocks/logger.mock.d.ts

@@ -0,0 +1,29 @@
+import type { Logger } from '@thymian/core';
+/**
+ * Creates a mock Logger with all methods stubbed using vi.fn().
+ * Useful for testing plugins and components that depend on a Logger.
+ *
+ * @param overrides - Partial logger to override defaults
+ * @returns A mock Logger instance
+ *
+ * @example
+ * ```typescript
+ * const logger = createMockLogger({ namespace: 'test-plugin' });
+ *
+ * // Use in tests
+ * myPlugin(emitter, logger, options);
+ *
+ * // Assert on calls
+ * expect(logger.info).toHaveBeenCalledWith('Starting plugin');
+ * ```
+ */
+export declare function createMockLogger(overrides?: Partial<Logger>): Logger;
+/**
+ * Creates a silent mock Logger that doesn't call any functions.
+ * Useful when you don't want to spy on logger calls.
+ *
+ * @param overrides - Partial logger to override defaults
+ * @returns A mock Logger instance with no-op functions
+ */
+export declare function createSilentMockLogger(overrides?: Partial<Logger>): Logger;
+//# sourceMappingURL=logger.mock.d.ts.map

package/dist/mocks/logger.mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mock.d.ts","sourceRoot":"","sources":["../../src/mocks/logger.mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAY,MAAM,eAAe,CAAC;AAGtD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,OAAO,CAAC,MAAM,CAAM,GAAG,MAAM,CAmBxE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,GAAE,OAAO,CAAC,MAAM,CAAM,GAC9B,MAAM,CAgBR"}

package/dist/mocks/logger.mock.js

@@ -0,0 +1,61 @@
+import { vi } from 'vitest';
+/**
+ * Creates a mock Logger with all methods stubbed using vi.fn().
+ * Useful for testing plugins and components that depend on a Logger.
+ *
+ * @param overrides - Partial logger to override defaults
+ * @returns A mock Logger instance
+ *
+ * @example
+ * ```typescript
+ * const logger = createMockLogger({ namespace: 'test-plugin' });
+ *
+ * // Use in tests
+ * myPlugin(emitter, logger, options);
+ *
+ * // Assert on calls
+ * expect(logger.info).toHaveBeenCalledWith('Starting plugin');
+ * ```
+ */
+export function createMockLogger(overrides = {}) {
+    const logger = {
+        namespace: 'mock-logger',
+        level: 'warn',
+        debug: vi.fn(),
+        info: vi.fn(),
+        error: vi.fn(),
+        trace: vi.fn(),
+        warn: vi.fn(),
+        out: vi.fn(),
+        child: vi.fn((name) => createMockLogger({
+            level: logger.level,
+            namespace: `${logger.namespace}:${name}`,
+        })),
+        ...overrides,
+    };
+    return logger;
+}
+/**
+ * Creates a silent mock Logger that doesn't call any functions.
+ * Useful when you don't want to spy on logger calls.
+ *
+ * @param overrides - Partial logger to override defaults
+ * @returns A mock Logger instance with no-op functions
+ */
+export function createSilentMockLogger(overrides = {}) {
+    return {
+        namespace: 'silent-logger',
+        level: 'silent',
+        debug: () => undefined,
+        info: () => undefined,
+        error: () => undefined,
+        trace: () => undefined,
+        warn: () => undefined,
+        out: () => undefined,
+        child: (name) => createSilentMockLogger({
+            namespace: `silent-logger:${name}`,
+        }),
+        ...overrides,
+    };
+}
+//# sourceMappingURL=logger.mock.js.map

package/dist/mocks/logger.mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mock.js","sourceRoot":"","sources":["../../src/mocks/logger.mock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE5B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAA6B,EAAE;IAC9D,MAAM,MAAM,GAAW;QACrB,SAAS,EAAE,aAAa;QACxB,KAAK,EAAE,MAAkB;QACzB,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;QACd,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QACb,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;QACd,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;QACd,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QACb,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,IAAY,EAAE,EAAE,CAC5B,gBAAgB,CAAC;YACf,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,EAAE;SACzC,CAAC,CACH;QACD,GAAG,SAAS;KACb,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,YAA6B,EAAE;IAE/B,OAAO;QACL,SAAS,EAAE,eAAe;QAC1B,KAAK,EAAE,QAAoB;QAC3B,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;QACtB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;QACrB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;QACtB,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;QACtB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;QACrB,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS;QACpB,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CACtB,sBAAsB,CAAC;YACrB,SAAS,EAAE,iBAAiB,IAAI,EAAE;SACnC,CAAC;QACJ,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/dist/mocks/plugin.mock.d.ts

@@ -0,0 +1,85 @@
+import type { ThymianPlugin, ThymianPluginFn } from '@thymian/core';
+/**
+ * Creates a mock ThymianPlugin with sensible defaults.
+ * All properties can be overridden.
+ *
+ * @param overrides - Partial plugin to override defaults
+ * @returns A complete ThymianPlugin object
+ *
+ * @example
+ * ```typescript
+ * const plugin = createMockPlugin({
+ *   name: 'test-plugin',
+ *   plugin: async (emitter, logger, options) => {
+ *     // Plugin logic
+ *   }
+ * });
+ * ```
+ */
+export declare function createMockPlugin<Options extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>>(overrides?: Partial<ThymianPlugin<Options>>): ThymianPlugin<Options>;
+/**
+ * Creates a spy plugin function that can be used with createMockPlugin.
+ * Useful when you want to test what arguments are passed to the plugin.
+ *
+ * @param implementation - Optional plugin implementation
+ * @returns A spy function compatible with ThymianPluginFn
+ *
+ * @example
+ * ```typescript
+ * const pluginFn = createSpyPluginFn(async (emitter, logger, options) => {
+ *   logger.info('Plugin started');
+ * });
+ *
+ * const plugin = createMockPlugin({ plugin: pluginFn });
+ *
+ * await plugin.plugin(emitter, logger, options);
+ * expect(pluginFn).toHaveBeenCalledWith(emitter, logger, options);
+ * ```
+ */
+export declare function createSpyPluginFn<Options extends Record<PropertyKey, unknown> & {
+    cwd: string;
+} = {
+    cwd: string;
+}>(implementation?: ThymianPluginFn<Options>): ThymianPluginFn<Options>;
+/**
+ * Creates a plugin that emits a specific event when executed.
+ * Useful for testing event flow between plugins.
+ *
+ * @param eventName - The event name to emit
+ * @param eventData - The event data to emit
+ * @param overrides - Additional plugin overrides
+ * @returns A ThymianPlugin that emits the specified event
+ *
+ * @example
+ * ```typescript
+ * const plugin = createPluginThatEmits('core.register', {
+ *   plugin: somePlugin
+ * });
+ * ```
+ */
+export declare function createPluginThatEmits<Options extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>>(eventName: string, eventData: any, overrides?: Partial<ThymianPlugin<Options>>): ThymianPlugin<Options>;
+/**
+ * Creates a plugin with event and action metadata configured.
+ * Useful for testing plugin registration and capability declaration.
+ *
+ * @param config - Plugin configuration including events and actions
+ * @returns A ThymianPlugin with metadata
+ *
+ * @example
+ * ```typescript
+ * const plugin = createPluginWithMetadata({
+ *   name: 'my-plugin',
+ *   events: {
+ *     emits: ['core.register'],
+ *     listensOn: ['core.ready']
+ *   },
+ *   actions: {
+ *     provides: {
+ *       'core.format.load': { event: {}, response: {} }
+ *     }
+ *   }
+ * });
+ * ```
+ */
+export declare function createPluginWithMetadata<Options extends Record<PropertyKey, unknown> = Record<PropertyKey, unknown>>(config: Partial<ThymianPlugin<Options>>): ThymianPlugin<Options>;
+//# sourceMappingURL=plugin.mock.d.ts.map

package/dist/mocks/plugin.mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.mock.d.ts","sourceRoot":"","sources":["../../src/mocks/plugin.mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGpE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,EAC3E,SAAS,GAAE,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAazE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAC/D,GAAG,EAAE,MAAM,CAAC;CACb,EACD,cAAc,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAErE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,EAE3E,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,GAAG,EACd,SAAS,GAAE,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAM,GAC9C,aAAa,CAAC,OAAO,CAAC,CAOxB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,EAC3E,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAEjE"}

package/dist/mocks/plugin.mock.js

@@ -0,0 +1,102 @@
+import { vi } from 'vitest';
+/**
+ * Creates a mock ThymianPlugin with sensible defaults.
+ * All properties can be overridden.
+ *
+ * @param overrides - Partial plugin to override defaults
+ * @returns A complete ThymianPlugin object
+ *
+ * @example
+ * ```typescript
+ * const plugin = createMockPlugin({
+ *   name: 'test-plugin',
+ *   plugin: async (emitter, logger, options) => {
+ *     // Plugin logic
+ *   }
+ * });
+ * ```
+ */
+export function createMockPlugin(overrides = {}) {
+    const defaultPlugin = vi.fn(async () => {
+        // Default no-op plugin
+    });
+    return {
+        name: 'mock-plugin',
+        version: '0.0.1',
+        plugin: defaultPlugin,
+        ...overrides,
+    };
+}
+/**
+ * Creates a spy plugin function that can be used with createMockPlugin.
+ * Useful when you want to test what arguments are passed to the plugin.
+ *
+ * @param implementation - Optional plugin implementation
+ * @returns A spy function compatible with ThymianPluginFn
+ *
+ * @example
+ * ```typescript
+ * const pluginFn = createSpyPluginFn(async (emitter, logger, options) => {
+ *   logger.info('Plugin started');
+ * });
+ *
+ * const plugin = createMockPlugin({ plugin: pluginFn });
+ *
+ * await plugin.plugin(emitter, logger, options);
+ * expect(pluginFn).toHaveBeenCalledWith(emitter, logger, options);
+ * ```
+ */
+export function createSpyPluginFn(implementation) {
+    return vi.fn(implementation || (() => Promise.resolve()));
+}
+/**
+ * Creates a plugin that emits a specific event when executed.
+ * Useful for testing event flow between plugins.
+ *
+ * @param eventName - The event name to emit
+ * @param eventData - The event data to emit
+ * @param overrides - Additional plugin overrides
+ * @returns A ThymianPlugin that emits the specified event
+ *
+ * @example
+ * ```typescript
+ * const plugin = createPluginThatEmits('core.register', {
+ *   plugin: somePlugin
+ * });
+ * ```
+ */
+export function createPluginThatEmits(eventName, eventData, overrides = {}) {
+    return createMockPlugin({
+        plugin: async (emitter, logger, options) => {
+            await emitter.emit(eventName, eventData);
+        },
+        ...overrides,
+    });
+}
+/**
+ * Creates a plugin with event and action metadata configured.
+ * Useful for testing plugin registration and capability declaration.
+ *
+ * @param config - Plugin configuration including events and actions
+ * @returns A ThymianPlugin with metadata
+ *
+ * @example
+ * ```typescript
+ * const plugin = createPluginWithMetadata({
+ *   name: 'my-plugin',
+ *   events: {
+ *     emits: ['core.register'],
+ *     listensOn: ['core.ready']
+ *   },
+ *   actions: {
+ *     provides: {
+ *       'core.format.load': { event: {}, response: {} }
+ *     }
+ *   }
+ * });
+ * ```
+ */
+export function createPluginWithMetadata(config) {
+    return createMockPlugin(config);
+}
+//# sourceMappingURL=plugin.mock.js.map

package/dist/mocks/plugin.mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.mock.js","sourceRoot":"","sources":["../../src/mocks/plugin.mock.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE5B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAE9B,YAA6C,EAAE;IAC/C,MAAM,aAAa,GAA+C,EAAE,CAAC,EAAE,CACrE,KAAK,IAAI,EAAE;QACT,uBAAuB;IACzB,CAAC,CACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,aAAa;QACrB,GAAG,SAAS;KACa,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAI/B,cAAyC;IACzC,OAAO,EAAE,CAAC,EAAE,CAAC,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB,CAGnC,SAAiB,EACjB,SAAc,EACd,YAA6C,EAAE;IAE/C,OAAO,gBAAgB,CAAU;QAC/B,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;YACzC,MAAM,OAAO,CAAC,IAAI,CAAC,SAAgB,EAAE,SAAS,CAAC,CAAC;QAClD,CAAC;QACD,GAAG,SAAS;KACb,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,wBAAwB,CAEtC,MAAuC;IACvC,OAAO,gBAAgB,CAAU,MAAM,CAAC,CAAC;AAC3C,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@thymian/core-testing",
+  "version": "0.0.0-PLACEHOLDER",
+  "description": "Testing utilities, factories, and mocks for writing Thymian plugin tests",
+  "license": "AGPL-3.0-only",
+  "bugs": {
+    "url": "https://github.com/thymianofficial/thymian/issues"
+  },
+  "homepage": "https://thymian.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thymianofficial/thymian.git",
+    "directory": "packages/core-testing"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "thymian",
+    "testing",
+    "test-utils",
+    "plugin-testing",
+    "http-mocks",
+    "api-testing"
+  ],
+  "main": "./dist/index.js",
+  "type": "module",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "devDependencies": {
+    "@thymian/core": "0.0.0-PLACEHOLDER"
+  },
+  "peerDependencies": {
+    "@thymian/core": "0.0.0-PLACEHOLDER"
+  }
+}