@daiso-tech/core
Version:
The library offers flexible, framework-agnostic solutions for modern web applications, built on adaptable components that integrate seamlessly with popular frameworks like Next Js.
66 lines (65 loc) • 2.46 kB
TypeScript
/**
* @module Lock
*/
import { type TestAPI, type SuiteAPI, type ExpectStatic, type beforeEach } from "vitest";
import type { ILockProvider } from "../../../lock/contracts/_module-exports.js";
import { type Promisable } from "../../../utilities/_module-exports.js";
import type { ISerde } from "../../../serde/contracts/_module-exports.js";
/**
*
* IMPORT_PATH: `"@daiso-tech/core/lock/test-utilities"`
* @group Utilities
*/
export type LockProviderTestSuiteSettings = {
expect: ExpectStatic;
test: TestAPI;
describe: SuiteAPI;
beforeEach: typeof beforeEach;
createLockProvider: () => Promisable<ILockProvider>;
serde?: ISerde;
};
/**
* The `lockProviderTestSuite` function simplifies the process of testing your custom implementation of {@link ILock | `ILock`} with `vitest`.
*
* IMPORT_PATH: `"@daiso-tech/core/lock/test-utilities"`
* @group Utilities
* @example
* ```ts
* import { describe, expect, test, beforeEach } from "vitest";
* import { MemoryLockAdapter } from "@daiso-tech/core/lock/adapters";
* import { LockProvider } from "@daiso-tech/core/lock";
* import { EventBus } from "@daiso-tech/core/event-bus";
* import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/adapters";
* import { lockProviderTestSuite } from "@daiso-tech/core/lock/test-utilities";
* import { Serde } from "@daiso-tech/core/serde";
* import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/adapters";
* import type { ILockData } from "@daiso-tech/core/lock/contracts";
* import { KeyPrefixer } from "@daiso-tech/core/utilities";
*
* describe("class: LockProvider", () => {
* const eventBus = new EventBus({
* keyPrefixer: new KeyPrefixer("event-bus"),
* adapter: new MemoryEventBusAdapter(),
* });
* const serde = new Serde(new SuperJsonSerdeAdapter());
* let map: Map<string, ILockData>;
* lockProviderTestSuite({
* createLockProvider: () => {
* const lockProvider = new LockProvider({
* serde,
* adapter: new MemoryLockAdapter(),
* eventBus,
* keyPrefixer: new KeyPrefixer("lock"),
* });
* return lockProvider;
* },
* beforeEach,
* describe,
* expect,
* test,
* serde,
* });
* });
* ```
*/
export declare function lockProviderTestSuite(settings: LockProviderTestSuiteSettings): void;