ai-database 2.0.1 → 2.1.1

package/test/provider-resolution.test.ts

@@ -1,402 +0,0 @@
-/**
- * Tests for provider resolution from DATABASE_URL
- *
- * Tests how the DB factory resolves different DATABASE_URL formats.
- */
-
-import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest'
-import { setProvider, createMemoryProvider } from '../src/index.js'
-
-describe('DATABASE_URL parsing', () => {
-  let originalEnv: NodeJS.ProcessEnv
-
-  beforeEach(() => {
-    // Save original environment
-    originalEnv = { ...process.env }
-    // Reset provider
-    setProvider(createMemoryProvider())
-  })
-
-  afterEach(() => {
-    // Restore original environment
-    process.env = originalEnv
-  })
-
-  describe('URL format detection', () => {
-    it('detects in-memory provider', () => {
-      const url = ':memory:'
-
-      // The parseDatabaseUrl function is internal, but we can test the behavior
-      // by checking that it doesn't throw and returns expected structure
-      expect(url).toBe(':memory:')
-    })
-
-    it('detects filesystem provider (default)', () => {
-      const urls = [
-        './content',
-        '/absolute/path/to/content',
-        'relative/path',
-      ]
-
-      urls.forEach(url => {
-        expect(url).not.toContain('://')
-      })
-    })
-
-    it('detects SQLite provider', () => {
-      const urls = [
-        'sqlite://./content',
-        'sqlite:///absolute/path',
-      ]
-
-      urls.forEach(url => {
-        expect(url.startsWith('sqlite://')).toBe(true)
-      })
-    })
-
-    it('detects Turso provider', () => {
-      const urls = [
-        'libsql://my-db.turso.io',
-        'libsql://my-db.turso.io/db',
-      ]
-
-      urls.forEach(url => {
-        expect(
-          url.startsWith('libsql://') || url.includes('.turso.io')
-        ).toBe(true)
-      })
-    })
-
-    it('detects ClickHouse provider (local)', () => {
-      const urls = [
-        'chdb://./content',
-        'chdb:///absolute/path',
-      ]
-
-      urls.forEach(url => {
-        expect(url.startsWith('chdb://')).toBe(true)
-      })
-    })
-
-    it('detects ClickHouse provider (remote)', () => {
-      const urls = [
-        'clickhouse://localhost:8123',
-        'clickhouse://clickhouse.example.com:8123/db',
-      ]
-
-      urls.forEach(url => {
-        expect(url.startsWith('clickhouse://') && url.includes(':')).toBe(true)
-      })
-    })
-  })
-
-  describe('provider selection', () => {
-    it('uses default provider when DATABASE_URL not set', () => {
-      delete process.env.DATABASE_URL
-
-      // Should default to filesystem or memory
-      expect(process.env.DATABASE_URL).toBeUndefined()
-    })
-
-    it('respects DATABASE_URL environment variable', () => {
-      process.env.DATABASE_URL = 'sqlite://./test.db'
-
-      expect(process.env.DATABASE_URL).toBe('sqlite://./test.db')
-    })
-
-    it('handles empty DATABASE_URL', () => {
-      process.env.DATABASE_URL = ''
-
-      // Should use default
-      expect(process.env.DATABASE_URL).toBe('')
-    })
-  })
-
-  describe('URL parsing logic', () => {
-    it('extracts root path from filesystem URL', () => {
-      const url = './content'
-      const root = url
-
-      expect(root).toBe('./content')
-    })
-
-    it('extracts root path from SQLite URL', () => {
-      const url = 'sqlite://./content'
-      const root = url.replace('sqlite://', '')
-
-      expect(root).toBe('./content')
-    })
-
-    it('extracts root path from chDB URL', () => {
-      const url = 'chdb://./data'
-      const root = url.replace('chdb://', '')
-
-      expect(root).toBe('./data')
-    })
-
-    it('preserves remote URLs', () => {
-      const url = 'libsql://my-db.turso.io'
-
-      expect(url).toContain('turso.io')
-    })
-
-    it('converts clickhouse:// to https:// for remote', () => {
-      const url = 'clickhouse://localhost:8123'
-      const httpUrl = url.replace('clickhouse://', 'https://')
-
-      expect(httpUrl).toBe('https://localhost:8123')
-    })
-  })
-
-  describe('provider paths', () => {
-    it('generates correct .db folder path for SQLite', () => {
-      const root = './content'
-      const dbPath = `${root}/.db/index.sqlite`
-
-      expect(dbPath).toBe('./content/.db/index.sqlite')
-    })
-
-    it('generates correct .db folder path for ClickHouse', () => {
-      const root = './content'
-      const dbPath = `${root}/.db/clickhouse`
-
-      expect(dbPath).toBe('./content/.db/clickhouse')
-    })
-
-    it('handles absolute paths', () => {
-      const root = '/var/data/content'
-      const dbPath = `${root}/.db/index.sqlite`
-
-      expect(dbPath).toBe('/var/data/content/.db/index.sqlite')
-    })
-  })
-
-  describe('special cases', () => {
-    it('handles URLs with query parameters', () => {
-      const url = 'libsql://my-db.turso.io?auth=token'
-
-      expect(url).toContain('?auth=token')
-    })
-
-    it('handles URLs with database names', () => {
-      const url = 'clickhouse://localhost:8123/mydb'
-
-      expect(url).toContain('/mydb')
-    })
-
-    it('handles file:// protocol', () => {
-      const url = 'sqlite:///absolute/path/to/db.sqlite'
-      const path = url.replace('sqlite://', '')
-
-      expect(path).toBe('/absolute/path/to/db.sqlite')
-    })
-  })
-})
-
-describe('provider initialization', () => {
-  beforeEach(() => {
-    setProvider(createMemoryProvider())
-  })
-
-  it('initializes memory provider synchronously', () => {
-    const provider = createMemoryProvider()
-
-    expect(provider).toBeDefined()
-    expect(typeof provider.get).toBe('function')
-    expect(typeof provider.create).toBe('function')
-  })
-
-  it('memory provider is immediately usable', async () => {
-    const provider = createMemoryProvider()
-
-    const result = await provider.create('Test', 'test1', { value: 'test' })
-
-    expect(result.$id).toBe('test1')
-    expect(result.value).toBe('test')
-  })
-
-  it('setProvider allows custom provider', () => {
-    const customProvider = createMemoryProvider()
-
-    // Should not throw
-    expect(() => setProvider(customProvider)).not.toThrow()
-  })
-
-  it('multiple setProvider calls replace provider', async () => {
-    const provider1 = createMemoryProvider()
-    const provider2 = createMemoryProvider()
-
-    setProvider(provider1)
-    await provider1.create('Test', 'test1', { value: 'first' })
-
-    setProvider(provider2)
-
-    // provider2 should not have test1
-    const result = await provider2.get('Test', 'test1')
-    expect(result).toBeNull()
-  })
-})
-
-describe('provider interface compliance', () => {
-  it('memory provider implements all required methods', () => {
-    const provider = createMemoryProvider()
-
-    const requiredMethods = [
-      'get',
-      'list',
-      'search',
-      'create',
-      'update',
-      'delete',
-      'related',
-      'relate',
-      'unrelate',
-    ]
-
-    requiredMethods.forEach(method => {
-      expect(typeof (provider as any)[method]).toBe('function')
-    })
-  })
-
-  it('memory provider has utility methods', () => {
-    const provider = createMemoryProvider()
-
-    expect(typeof provider.clear).toBe('function')
-    expect(typeof provider.stats).toBe('function')
-  })
-
-  it('provider methods return expected types', async () => {
-    const provider = createMemoryProvider()
-
-    // get returns Record<string, unknown> | null
-    const getResult = await provider.get('Test', 'id1')
-    expect(getResult === null || typeof getResult === 'object').toBe(true)
-
-    // create returns Record<string, unknown>
-    const createResult = await provider.create('Test', 'id1', { value: 'test' })
-    expect(typeof createResult).toBe('object')
-
-    // delete returns boolean
-    const deleteResult = await provider.delete('Test', 'id1')
-    expect(typeof deleteResult).toBe('boolean')
-
-    // list returns array
-    const listResult = await provider.list('Test')
-    expect(Array.isArray(listResult)).toBe(true)
-
-    // search returns array
-    const searchResult = await provider.search('Test', 'query')
-    expect(Array.isArray(searchResult)).toBe(true)
-
-    // related returns array
-    const relatedResult = await provider.related('Test', 'id1', 'relation')
-    expect(Array.isArray(relatedResult)).toBe(true)
-  })
-})
-
-describe('error handling', () => {
-  it('handles invalid DATABASE_URL gracefully', () => {
-    const invalidUrls = [
-      'invalid://something',
-      'ftp://not-supported',
-      '://malformed',
-    ]
-
-    // These should not crash the parsing logic
-    invalidUrls.forEach(url => {
-      expect(typeof url).toBe('string')
-    })
-  })
-
-  it('handles missing provider dependencies gracefully', async () => {
-    // When using a provider that requires external packages,
-    // it should fail gracefully if packages aren't installed
-
-    // This is more of a documentation test - the actual behavior
-    // depends on dynamic imports in resolveProvider()
-    expect(true).toBe(true)
-  })
-})
-
-describe('performance considerations', () => {
-  it('provider stats track counts correctly', async () => {
-    const provider = createMemoryProvider()
-
-    await provider.create('User', 'user1', { name: 'User 1' })
-    await provider.create('User', 'user2', { name: 'User 2' })
-    await provider.create('Post', 'post1', { title: 'Post 1' })
-
-    const stats = provider.stats()
-
-    expect(stats.entities).toBe(3)
-    expect(stats.relations).toBe(0)
-  })
-
-  it('tracks relation counts', async () => {
-    const provider = createMemoryProvider()
-
-    await provider.create('User', 'user1', { name: 'User 1' })
-    await provider.create('Post', 'post1', { title: 'Post 1' })
-    await provider.create('Post', 'post2', { title: 'Post 2' })
-
-    await provider.relate('User', 'user1', 'posts', 'Post', 'post1')
-    await provider.relate('User', 'user1', 'posts', 'Post', 'post2')
-
-    const stats = provider.stats()
-
-    expect(stats.entities).toBe(3)
-    expect(stats.relations).toBe(2)
-  })
-
-  it('clear resets all counts', async () => {
-    const provider = createMemoryProvider()
-
-    await provider.create('User', 'user1', { name: 'User 1' })
-    await provider.create('Post', 'post1', { title: 'Post 1' })
-    await provider.relate('User', 'user1', 'posts', 'Post', 'post1')
-
-    provider.clear()
-
-    const stats = provider.stats()
-    expect(stats.entities).toBe(0)
-    expect(stats.relations).toBe(0)
-  })
-})
-
-describe('documentation examples', () => {
-  it('matches README filesystem example', () => {
-    const url = './content'
-
-    expect(url).toBe('./content')
-  })
-
-  it('matches README SQLite example', () => {
-    const url = 'sqlite://./content'
-
-    expect(url.startsWith('sqlite://')).toBe(true)
-  })
-
-  it('matches README Turso example', () => {
-    const url = 'libsql://your-db.turso.io'
-
-    expect(url.includes('.turso.io')).toBe(true)
-  })
-
-  it('matches README chDB example', () => {
-    const url = 'chdb://./content'
-
-    expect(url.startsWith('chdb://')).toBe(true)
-  })
-
-  it('matches README ClickHouse example', () => {
-    const url = 'clickhouse://localhost:8123'
-
-    expect(url.startsWith('clickhouse://')).toBe(true)
-  })
-
-  it('matches README memory example', () => {
-    const url = ':memory:'
-
-    expect(url).toBe(':memory:')
-  })
-})

package/tsconfig.json

@@ -1,9 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "rootDir": "src",
-    "outDir": "dist"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
-}

package/vitest.config.ts

@@ -1,19 +0,0 @@
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  test: {
-    globals: false,
-    environment: 'node',
-    include: ['src/**/*.test.ts', 'test/**/*.test.ts'],
-    exclude: ['node_modules/**', 'dist/**'],
-    testTimeout: 30000,
-    hookTimeout: 15000,
-    // Run tests sequentially for database operations
-    pool: 'forks',
-    poolOptions: {
-      forks: {
-        singleFork: true,
-      },
-    },
-  },
-})