@gzl10/nexus-backend 0.18.0 → 0.19.0

package/dist/testing/index.d.ts

@@ -0,0 +1,81 @@
+import { Knex } from 'knex';
+export { Knex } from 'knex';
+import { ActionDefinition, CollectionEntityDefinition, ComputedEntityDefinition, SingleEntityDefinition, DagEntityDefinition, EventEntityDefinition, ExternalEntityDefinition, ModuleContext, DatabaseAdapter, TreeEntityDefinition, ViewEntityDefinition } from '@gzl10/nexus-sdk';
+export { A as AppError, C as ConflictError, E as ErrorCodes, F as ForbiddenError, N as NotFoundError, U as UnauthorizedError, V as ValidationError } from '../app-error-CKbYJQ9V.js';
+
+/**
+ * Test helpers for runtime services
+ */
+
+/**
+ * Create mock Knex query builder
+ */
+declare function createMockQueryBuilder(data?: unknown[]): Knex.QueryBuilder;
+/**
+ * Create mock Knex instance
+ */
+declare function createMockDb(tableData?: Record<string, unknown[]>): Knex<any, any[]>;
+/**
+ * Create mock DbContext with the new structure.
+ * Wraps a Knex mock in the full DbContext interface.
+ */
+declare function createMockDbContext(tableData?: Record<string, unknown[]>): ModuleContext['db'];
+/**
+ * Options for createMockContext, extending ModuleContext overrides with
+ * plugin-specific helpers.
+ */
+interface MockContextOptions extends Partial<ModuleContext> {
+    pluginCode?: string;
+}
+/**
+ * Create mock ModuleContext
+ * Provides sensible defaults for all context properties.
+ * Use overrides to customize specific properties per test.
+ *
+ * Structure matches the new ModuleContext interface:
+ * - ctx.core: logger, errors, generateId, crypto, socket, etc.
+ * - ctx.db: knex, adapter, schema, helper functions
+ * - ctx.engine: module/plugin introspection
+ * - ctx.services: inter-module service registry
+ * - ctx.adapters: external data source adapters
+ *
+ * @param overrides - Partial ModuleContext overrides plus optional pluginCode
+ *   for table name prefixing via ctx.db.t()
+ */
+declare function createMockContext(overrides?: MockContextOptions): ModuleContext;
+declare function createCollectionDefinition(overrides?: Partial<CollectionEntityDefinition>): CollectionEntityDefinition;
+declare function createSingleDefinition(overrides?: Partial<SingleEntityDefinition>): SingleEntityDefinition;
+declare function createReferenceDefinition(overrides?: Partial<CollectionEntityDefinition>): CollectionEntityDefinition;
+declare function createEventDefinition(overrides?: Partial<EventEntityDefinition>): EventEntityDefinition;
+/** @deprecated Config absorbed into Single. Use createSingleDefinition with scopeField instead. */
+declare function createConfigDefinition(overrides?: Partial<SingleEntityDefinition>): SingleEntityDefinition;
+/** @deprecated Temp absorbed into Collection. Use createCollectionDefinition with retention instead. */
+declare function createTempDefinition(overrides?: Partial<CollectionEntityDefinition>): CollectionEntityDefinition;
+declare function createViewDefinition(overrides?: Partial<ViewEntityDefinition>): ViewEntityDefinition;
+declare function createExternalDefinition(overrides?: Partial<ExternalEntityDefinition>): ExternalEntityDefinition;
+/** @deprecated Use createComputedDefinition with sources instead */
+declare function createVirtualDefinition(overrides?: Partial<ComputedEntityDefinition>): ComputedEntityDefinition;
+declare function createComputedDefinition(overrides?: Partial<ComputedEntityDefinition>): ComputedEntityDefinition;
+/**
+ * Creates a mock DatabaseAdapter for testing external services.
+ * All methods are vi.fn() mocks with sensible defaults.
+ */
+declare function createMockDatabaseAdapter(overrides?: Partial<DatabaseAdapter>): DatabaseAdapter;
+declare function createTreeDefinition(overrides?: Partial<TreeEntityDefinition>): TreeEntityDefinition;
+declare function createDagDefinition(overrides?: Partial<DagEntityDefinition>): DagEntityDefinition;
+declare function createActionDefinition(overrides?: Partial<ActionDefinition>): ActionDefinition;
+
+/**
+ * Creates minimal core tables in SQLite :memory: for plugin integration tests.
+ * Only includes columns that other tables reference via FK.
+ * Call before runGeneratedMigration() in plugin tests.
+ */
+declare function createCoreTables(db: Knex): Promise<void>;
+
+/**
+ * Creates a Knex instance with SQLite :memory: for integration tests.
+ * Plugins should use this instead of importing knex/better-sqlite3 directly.
+ */
+declare function createTestDb(): Knex;
+
+export { createActionDefinition, createCollectionDefinition, createComputedDefinition, createConfigDefinition, createCoreTables, createDagDefinition, createEventDefinition, createExternalDefinition, createMockContext, createMockDatabaseAdapter, createMockDb, createMockDbContext, createMockQueryBuilder, createReferenceDefinition, createSingleDefinition, createTempDefinition, createTestDb, createTreeDefinition, createViewDefinition, createVirtualDefinition };