@superfunctions/db 0.1.0

package/dist/testing/contract-tests.js

@@ -0,0 +1,391 @@
+/**
+ * Contract tests for adapter compliance
+ */
+/**
+ * Test adapter contract compliance
+ * Use with your test framework (vitest, jest, etc.)
+ */
+export function testAdapterContract(config) {
+    const { adapter, namespace } = config;
+    return {
+        /**
+         * Test CRUD operations
+         */
+        async testCRUD() {
+            const tests = [];
+            // Test create
+            tests.push({
+                name: 'should create a record',
+                test: async () => {
+                    const data = { name: 'Test User', email: 'test@example.com', age: 25 };
+                    const result = await adapter.create({
+                        model: 'users',
+                        data,
+                        namespace,
+                    });
+                    if (!result || typeof result !== 'object') {
+                        throw new Error('Create should return an object');
+                    }
+                    if (!('id' in result)) {
+                        throw new Error('Created record should have an id');
+                    }
+                    if (result.name !== data.name) {
+                        throw new Error('Created record should contain the provided data');
+                    }
+                },
+            });
+            // Test findOne
+            tests.push({
+                name: 'should find a record',
+                test: async () => {
+                    const created = await adapter.create({
+                        model: 'users',
+                        data: { name: 'Find Me', email: 'find@example.com', age: 30 },
+                        namespace,
+                    });
+                    const found = await adapter.findOne({
+                        model: 'users',
+                        where: [{ field: 'id', operator: 'eq', value: created.id }],
+                        namespace,
+                    });
+                    if (!found) {
+                        throw new Error('Should find the created record');
+                    }
+                    if (found.id !== created.id) {
+                        throw new Error('Found record should match created record');
+                    }
+                },
+            });
+            // Test findMany
+            tests.push({
+                name: 'should find multiple records',
+                test: async () => {
+                    await adapter.create({
+                        model: 'users',
+                        data: { name: 'User 1', email: 'user1@example.com', age: 20 },
+                        namespace,
+                    });
+                    await adapter.create({
+                        model: 'users',
+                        data: { name: 'User 2', email: 'user2@example.com', age: 25 },
+                        namespace,
+                    });
+                    const results = await adapter.findMany({
+                        model: 'users',
+                        where: [],
+                        namespace,
+                    });
+                    if (!Array.isArray(results)) {
+                        throw new Error('findMany should return an array');
+                    }
+                    if (results.length < 2) {
+                        throw new Error('Should find at least 2 records');
+                    }
+                },
+            });
+            // Test update
+            tests.push({
+                name: 'should update a record',
+                test: async () => {
+                    const created = await adapter.create({
+                        model: 'users',
+                        data: { name: 'Update Me', email: 'update@example.com', age: 30 },
+                        namespace,
+                    });
+                    const updated = await adapter.update({
+                        model: 'users',
+                        where: [{ field: 'id', operator: 'eq', value: created.id }],
+                        data: { age: 31 },
+                        namespace,
+                    });
+                    if (updated.age !== 31) {
+                        throw new Error('Record should be updated');
+                    }
+                },
+            });
+            // Test delete
+            tests.push({
+                name: 'should delete a record',
+                test: async () => {
+                    const created = await adapter.create({
+                        model: 'users',
+                        data: { name: 'Delete Me', email: 'delete@example.com', age: 30 },
+                        namespace,
+                    });
+                    await adapter.delete({
+                        model: 'users',
+                        where: [{ field: 'id', operator: 'eq', value: created.id }],
+                        namespace,
+                    });
+                    const found = await adapter.findOne({
+                        model: 'users',
+                        where: [{ field: 'id', operator: 'eq', value: created.id }],
+                        namespace,
+                    });
+                    if (found !== null) {
+                        throw new Error('Record should be deleted');
+                    }
+                },
+            });
+            return tests;
+        },
+        /**
+         * Test batch operations
+         */
+        async testBatch() {
+            if (!adapter.capabilities.operations.batch) {
+                return [];
+            }
+            const tests = [];
+            tests.push({
+                name: 'should create multiple records',
+                test: async () => {
+                    const data = [
+                        { name: 'Batch 1', email: 'batch1@example.com', age: 20 },
+                        { name: 'Batch 2', email: 'batch2@example.com', age: 25 },
+                    ];
+                    const results = await adapter.createMany({
+                        model: 'users',
+                        data,
+                        namespace,
+                    });
+                    if (!Array.isArray(results)) {
+                        throw new Error('createMany should return an array');
+                    }
+                    if (results.length !== data.length) {
+                        throw new Error('Should create all records');
+                    }
+                },
+            });
+            return tests;
+        },
+        /**
+         * Test advanced operations
+         */
+        async testAdvanced() {
+            const tests = [];
+            // Test count
+            tests.push({
+                name: 'should count records',
+                test: async () => {
+                    await adapter.create({
+                        model: 'users',
+                        data: { name: 'Count 1', email: 'count1@example.com', age: 20 },
+                        namespace,
+                    });
+                    await adapter.create({
+                        model: 'users',
+                        data: { name: 'Count 2', email: 'count2@example.com', age: 25 },
+                        namespace,
+                    });
+                    const count = await adapter.count({
+                        model: 'users',
+                        namespace,
+                    });
+                    if (typeof count !== 'number' || count < 2) {
+                        throw new Error('Count should return the number of records');
+                    }
+                },
+            });
+            // Test upsert (if supported)
+            if (adapter.capabilities.operations.upsert) {
+                tests.push({
+                    name: 'should upsert a record',
+                    test: async () => {
+                        const email = 'upsert@example.com';
+                        // First upsert (create)
+                        const result1 = await adapter.upsert({
+                            model: 'users',
+                            where: [{ field: 'email', operator: 'eq', value: email }],
+                            create: { name: 'Upsert User', email, age: 30 },
+                            update: { age: 31 },
+                            namespace,
+                        });
+                        if (!result1 || result1.age !== 30) {
+                            throw new Error('First upsert should create');
+                        }
+                        // Second upsert (update)
+                        const result2 = await adapter.upsert({
+                            model: 'users',
+                            where: [{ field: 'email', operator: 'eq', value: email }],
+                            create: { name: 'Upsert User', email, age: 30 },
+                            update: { age: 31 },
+                            namespace,
+                        });
+                        if (!result2 || result2.age !== 31) {
+                            throw new Error('Second upsert should update');
+                        }
+                    },
+                });
+            }
+            return tests;
+        },
+        /**
+         * Test lifecycle operations
+         */
+        async testLifecycle() {
+            const tests = [];
+            tests.push({
+                name: 'should initialize',
+                test: async () => {
+                    await adapter.initialize();
+                },
+            });
+            tests.push({
+                name: 'should check health',
+                test: async () => {
+                    const health = await adapter.isHealthy();
+                    if (typeof health !== 'object' || typeof health.healthy !== 'boolean') {
+                        throw new Error('isHealthy should return a health status object');
+                    }
+                },
+            });
+            tests.push({
+                name: 'should get/set schema version',
+                test: async () => {
+                    await adapter.setSchemaVersion('test', 1);
+                    const version = await adapter.getSchemaVersion('test');
+                    if (version !== 1) {
+                        throw new Error('Schema version should be set and retrieved correctly');
+                    }
+                },
+            });
+            return tests;
+        },
+        /**
+         * Run all contract tests
+         */
+        async runAll() {
+            const allTests = [
+                ...(await this.testCRUD()),
+                ...(await this.testBatch()),
+                ...(await this.testAdvanced()),
+                ...(await this.testLifecycle()),
+            ];
+            const results = {
+                total: allTests.length,
+                passed: 0,
+                failed: 0,
+                errors: [],
+            };
+            for (const test of allTests) {
+                try {
+                    if (config.beforeEach) {
+                        await config.beforeEach();
+                    }
+                    await test.test();
+                    results.passed++;
+                    if (config.afterEach) {
+                        await config.afterEach();
+                    }
+                }
+                catch (error) {
+                    results.failed++;
+                    results.errors.push({
+                        name: test.name,
+                        error: error,
+                    });
+                }
+            }
+            return results;
+        },
+    };
+}
+/**
+ * Helper function to run contract tests with a test framework
+ * Pass your test framework's describe, it, beforeEach, afterEach functions
+ */
+export function describeAdapterContract(name, config, describe, it, beforeEach, afterEach) {
+    describe(`Adapter Contract: ${name}`, () => {
+        const tests = testAdapterContract(config);
+        describe('CRUD Operations', () => {
+            if (beforeEach) {
+                beforeEach(async () => {
+                    if (config.beforeEach)
+                        await config.beforeEach();
+                });
+            }
+            if (afterEach) {
+                afterEach(async () => {
+                    if (config.afterEach)
+                        await config.afterEach();
+                });
+            }
+            it('should create a record', async () => {
+                const crudTests = await tests.testCRUD();
+                await crudTests[0].test();
+            });
+            it('should find a record', async () => {
+                const crudTests = await tests.testCRUD();
+                await crudTests[1].test();
+            });
+            it('should find multiple records', async () => {
+                const crudTests = await tests.testCRUD();
+                await crudTests[2].test();
+            });
+            it('should update a record', async () => {
+                const crudTests = await tests.testCRUD();
+                await crudTests[3].test();
+            });
+            it('should delete a record', async () => {
+                const crudTests = await tests.testCRUD();
+                await crudTests[4].test();
+            });
+        });
+        if (config.adapter.capabilities.operations.batch) {
+            describe('Batch Operations', () => {
+                if (beforeEach) {
+                    beforeEach(async () => {
+                        if (config.beforeEach)
+                            await config.beforeEach();
+                    });
+                }
+                if (afterEach) {
+                    afterEach(async () => {
+                        if (config.afterEach)
+                            await config.afterEach();
+                    });
+                }
+                it('should create multiple records', async () => {
+                    const batchTests = await tests.testBatch();
+                    if (batchTests.length > 0) {
+                        await batchTests[0].test();
+                    }
+                });
+            });
+        }
+        describe('Advanced Operations', () => {
+            if (beforeEach) {
+                beforeEach(async () => {
+                    if (config.beforeEach)
+                        await config.beforeEach();
+                });
+            }
+            if (afterEach) {
+                afterEach(async () => {
+                    if (config.afterEach)
+                        await config.afterEach();
+                });
+            }
+            it('should count records', async () => {
+                const advancedTests = await tests.testAdvanced();
+                await advancedTests[0].test();
+            });
+        });
+        describe('Lifecycle', () => {
+            it('should initialize', async () => {
+                const lifecycleTests = await tests.testLifecycle();
+                await lifecycleTests[0].test();
+            });
+            it('should check health', async () => {
+                const lifecycleTests = await tests.testLifecycle();
+                await lifecycleTests[1].test();
+            });
+            it('should manage schema versions', async () => {
+                const lifecycleTests = await tests.testLifecycle();
+                await lifecycleTests[2].test();
+            });
+        });
+    });
+}
+//# sourceMappingURL=contract-tests.js.map

package/dist/testing/contract-tests.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Testing utilities
+ */
+export { memoryAdapter } from '../adapters/memory/index.js';
+export type { MemoryAdapterConfig } from '../adapters/memory/index.js';
+export { testAdapterContract, describeAdapterContract } from './contract-tests.js';
+export type { AdapterTestConfig } from './contract-tests.js';
+export { MockAdapter, createMockAdapter } from './mocks.js';
+export type { MockCall } from './mocks.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGvE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnF,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,10 @@
+/**
+ * Testing utilities
+ */
+// Re-export memory adapter for testing
+export { memoryAdapter } from '../adapters/memory/index.js';
+// Contract test utilities
+export { testAdapterContract, describeAdapterContract } from './contract-tests.js';
+// Mock adapter
+export { MockAdapter, createMockAdapter } from './mocks.js';
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uCAAuC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,0BAA0B;AAC1B,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAGnF,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/testing/mocks.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Mock adapter for testing with call tracking
+ */
+import type { Adapter, CreateParams, FindOneParams, FindManyParams, UpdateParams, DeleteParams, CreateManyParams, UpdateManyParams, DeleteManyParams, UpsertParams, CountParams, TransactionAdapter, TableSchema, ValidationResult, HealthStatus } from '../adapter/types.js';
+export interface MockCall {
+    method: string;
+    params: any;
+    timestamp: Date;
+}
+/**
+ * Mock adapter for testing
+ * Records all method calls and allows inspection
+ */
+export declare class MockAdapter implements Adapter {
+    calls: MockCall[];
+    private responses;
+    private errors;
+    readonly id = "mock";
+    readonly name = "Mock Adapter";
+    readonly version = "1.0.0";
+    readonly capabilities: import("../index.js").AdapterCapabilities;
+    /**
+     * Set a mock response for a specific method
+     */
+    setResponse(method: string, response: any): void;
+    /**
+     * Set an error to throw for a specific method
+     */
+    setError(method: string, error: Error): void;
+    /**
+     * Record a method call
+     */
+    private recordCall;
+    /**
+     * Get a mock response or throw error if configured
+     */
+    private getResponse;
+    create<T = any>(params: CreateParams): Promise<T>;
+    findOne<T = any>(params: FindOneParams): Promise<T | null>;
+    findMany<T = any>(params: FindManyParams): Promise<T[]>;
+    update<T = any>(params: UpdateParams): Promise<T>;
+    delete(params: DeleteParams): Promise<void>;
+    createMany<T = any>(params: CreateManyParams): Promise<T[]>;
+    updateMany(params: UpdateManyParams): Promise<number>;
+    deleteMany(params: DeleteManyParams): Promise<number>;
+    upsert<T = any>(params: UpsertParams): Promise<T>;
+    count(params: CountParams): Promise<number>;
+    transaction<R>(_callback: (trx: TransactionAdapter) => Promise<R>): Promise<R>;
+    initialize(): Promise<void>;
+    isHealthy(): Promise<HealthStatus>;
+    close(): Promise<void>;
+    getSchemaVersion(namespace: string): Promise<number>;
+    setSchemaVersion(namespace: string, version: number): Promise<void>;
+    validateSchema(_schema: TableSchema): Promise<ValidationResult>;
+    /**
+     * Get all calls for a specific method
+     */
+    getCalls(method?: string): MockCall[];
+    /**
+     * Get the last call for a specific method
+     */
+    getLastCall(method: string): MockCall | undefined;
+    /**
+     * Check if a method was called
+     */
+    wasCalled(method: string): boolean;
+    /**
+     * Check how many times a method was called
+     */
+    getCallCount(method?: string): number;
+    /**
+     * Clear all recorded calls
+     */
+    clearCalls(): void;
+    /**
+     * Clear all mock responses and errors
+     */
+    clearMocks(): void;
+    /**
+     * Reset the mock adapter completely
+     */
+    reset(): void;
+    /**
+     * Verify that a method was called with specific parameters
+     */
+    verifyCall(method: string, params?: Partial<any>): boolean;
+}
+/**
+ * Create a mock adapter instance
+ */
+export declare function createMockAdapter(): MockAdapter;
+//# sourceMappingURL=mocks.d.ts.map

package/dist/testing/mocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mocks.d.ts","sourceRoot":"","sources":["../../src/testing/mocks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACb,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,GAAG,CAAC;IACZ,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,WAAY,YAAW,OAAO;IAClC,KAAK,EAAE,QAAQ,EAAE,CAAM;IAC9B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,MAAM,CAAiC;IAE/C,QAAQ,CAAC,EAAE,UAAU;IACrB,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,YAAY,4CAAwB;IAE7C;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,IAAI;IAIhD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAI5C;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAWb,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC;IAKjD,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAK1D,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAKvD,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC;IAKjD,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3C,UAAU,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAQ3D,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrD,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAMrD,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC;IAKjD,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAM3C,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAM9E,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAQlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKpD,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAMrE;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE;IAIrC;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAKjD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAIrC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO;CAc3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C"}