support mariadb

Author: noxify

.github/workflows/ci.yml

@@ -58,8 +58,17 @@ jobs:
       - name: Setup
         uses: ./.github/setup
 
-      - name: Unittest
-        run: pnpm test
+      - name: Test Core Package
+        run: turbo test --filter=@vorsteh-queue/core
+
+      - name: Test Drizzle PostgreSQL (PGlite)
+        run: pnpm test:drizzle-postgres
+
+      - name: Test Drizzle MariaDB (Testcontainers)
+        run: pnpm test:drizzle-mariadb
+        env:
+          # Ensure Docker is available for Testcontainers
+          TESTCONTAINERS_RYUK_DISABLED: true
 
   pkg-new-release:
     needs: [lint, format, typecheck, unittest]

README.md

@@ -1,13 +1,13 @@
 <div align="center">
   <img src="./assets/vorsteh-queue-logo-nobg.png" alt="Vorsteh Queue" height="200" />
   <h1>Vorsteh Queue</h1>
-  <p>A TypeScript-first job queue system with multiple database adapters, built for reliability and developer experience.</p>
+  <p>A powerful, ORM-agnostic queue engine that works with any orm. Handle background jobs, scheduled tasks, and recurring processes with ease.</p>
 </div>
 
 ## Features
 
 - **Type-safe**: Full TypeScript support with generic job payloads
-- **Multiple adapters**: Drizzle ORM and in-memory implementations (Prisma coming soon)
+- **Multiple adapters**: Drizzle ORM (PostgreSQL + MariaDB/MySQL) and in-memory implementations
 - **Priority queues**: Numeric priority system (lower = higher priority)
 - **Delayed jobs**: Schedule jobs for future execution
 - **Recurring jobs**: Cron expressions and interval-based repetition
@@ -22,7 +22,7 @@
 .
 ├── packages/
 │   ├── core/                # Core queue logic and interfaces
-│   ├── adapter-drizzle/     # Drizzle ORM adapter
+│   ├── adapter-drizzle/     # Drizzle ORM adapter (PostgreSQL + MariaDB/MySQL)
 │   └── adapter-prisma/      # Prisma adapter (coming soon)
 ├── examples/                # Standalone usage examples
 │   ├── drizzle-pg/         # Drizzle + node-postgres
@@ -46,16 +46,30 @@ pnpm add @vorsteh-queue/core @vorsteh-queue/adapter-drizzle
 ### Basic Usage
 
 ```typescript
+// PostgreSQL
 import { drizzle } from "drizzle-orm/node-postgres"
 import { Pool } from "pg"
-
-import { DrizzleQueueAdapter } from "@vorsteh-queue/adapter-drizzle"
+import { PostgresQueueAdapter } from "@vorsteh-queue/adapter-drizzle"
 import { Queue } from "@vorsteh-queue/core"
 
-// Setup database and queue
 const pool = new Pool({ connectionString: "postgresql://..." })
 const db = drizzle(pool)
-const adapter = new DrizzleQueueAdapter(db, "my-queue")
+const adapter = new PostgresQueueAdapter(db, "my-queue")
+const queue = new Queue(adapter, { name: "my-queue" })
+
+// MariaDB/MySQL
+import { drizzle } from "drizzle-orm/mysql2"
+import mysql from "mysql2/promise"
+import { MariaDBQueueAdapter } from "@vorsteh-queue/adapter-drizzle"
+
+const connection = await mysql.createConnection({
+  host: "localhost",
+  user: "root",
+  password: "password",
+  database: "queue_db"
+})
+const db = drizzle(connection, { mode: "default" })
+const adapter = new MariaDBQueueAdapter(db, "my-queue")
 const queue = new Queue(adapter, { name: "my-queue" })
 
 // Register job handlers
@@ -241,9 +255,14 @@ queue.on("queue:resumed", () => {
 # Install dependencies
 pnpm install
 
-# Run tests
+# Run all tests
 pnpm test
 
+# Run specific test suites
+pnpm test:core                # Core package tests
+pnpm test:drizzle-postgres    # PostgreSQL adapter tests
+pnpm test:drizzle-mariadb     # MariaDB adapter tests
+
 # Type check
 pnpm typecheck
 

apps/docs/next.config.mjs

@@ -1,3 +1,14 @@
+import createMDXPlugin from "@next/mdx"
+import { rehypePlugins, remarkPlugins } from "renoun/mdx"
+
+const withMDX = createMDXPlugin({
+  extension: /\.mdx?$/,
+  options: {
+    remarkPlugins,
+    rehypePlugins,
+  },
+})
+
 /** @type {import('next').NextConfig} */
 const nextConfig = {
   output: "export",
@@ -22,4 +33,4 @@ const nextConfig = {
   },
 }
 
-export default nextConfig
+export default withMDX(nextConfig)

apps/docs/package.json

@@ -4,17 +4,18 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "build": "next build",
+    "build": "renoun next build",
     "clean": "git clean -xdf .cache .turbo dist node_modules .next",
     "clean:cache": "git clean -xdf .cache",
-    "dev": "next dev",
+    "dev": "renoun next dev",
     "format": "prettier --check . --ignore-path ../../.gitignore",
     "lint": "eslint .",
     "start": "next start",
     "typecheck": "tsc --noEmit"
   },
   "prettier": "@vorsteh-queue/prettier-config",
   "dependencies": {
+    "@next/mdx": "15.4.1",
     "class-variance-authority": "0.7.1",
     "clsx": "2.1.1",
     "cmdk": "1.1.1",
@@ -23,7 +24,9 @@
     "next": "15.4.1",
     "next-themes": "latest",
     "react": "19.1.0",
-    "react-dom": "19.1.0"
+    "react-dom": "19.1.0",
+    "renoun": "8.14.0",
+    "ts-morph": "26.0.0"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "4.1.11",

package.json

@@ -27,6 +27,9 @@
     "deps:update": "pnpm update -i -L -r",
     "test": "vitest",
     "test:ui": "vitest --ui",
+    "test:core": "turbo test --filter=@vorsteh-queue/core",
+    "test:drizzle-postgres": "turbo test:postgres",
+    "test:drizzle-mariadb": "turbo test:mariadb",
     "prune": "turbo prune --docker",
     "cs": "changeset",
     "ci:publish": "pnpm build && pnpm publish -r --access public --publish-branch main && pnpm changeset tag",

packages/adapter-drizzle/MARIADB_TESTING.md

@@ -0,0 +1,102 @@
+# MariaDB Testing Setup
+
+## Prerequisites
+
+1. **Docker Desktop** must be installed and running
+2. **Node.js 18+** and **pnpm** installed
+
+## Quick Start
+
+```bash
+# 1. Start Docker Desktop
+# 2. Install dependencies
+pnpm install
+
+# 3. Run MariaDB tests
+pnpm test:mariadb
+
+# 4. Run all tests
+pnpm test
+```
+
+## Manual MariaDB Setup (Alternative)
+
+If you prefer not to use Docker:
+
+```bash
+# Install MariaDB locally (macOS)
+brew install mariadb
+brew services start mariadb
+
+# Create test database
+mysql -u root -e "CREATE DATABASE testdb;"
+
+# Set environment variables
+export MARIADB_HOST=localhost
+export MARIADB_PORT=3306
+export MARIADB_USER=root
+export MARIADB_PASSWORD=
+export MARIADB_DATABASE=testdb
+
+# Run tests
+pnpm test:mariadb:local
+```
+
+## Test Commands
+
+- `pnpm test:mariadb` - Run MariaDB tests with Testcontainers
+- `pnpm test:postgres` - Run PostgreSQL tests with PGlite
+- `pnpm test` - Run all tests
+- `pnpm test:watch` - Run tests in watch mode
+
+## Troubleshooting
+
+### Docker Issues
+
+- Ensure Docker Desktop is running
+- Try: `docker pull mariadb:10.6`
+- Check Docker permissions
+
+### Connection Issues
+
+- MariaDB container takes ~10-15 seconds to start
+- Tests have 2-minute timeout for container startup
+- Check firewall settings
+
+### Performance
+
+- First run downloads MariaDB image (~200MB)
+- Subsequent runs are much faster
+- Container startup: ~10-15 seconds
+
+## What the Tests Verify
+
+✅ **Basic Operations**
+
+- Job creation and retrieval
+- SKIP LOCKED functionality
+- Status updates
+- Queue statistics
+
+✅ **MariaDB-Specific Features**
+
+- UUID generation with VARCHAR(36)
+- JSON payload handling
+- MySQL-specific query patterns
+
+✅ **Scheduling Features**
+
+- Cron job support
+- Recurring jobs
+- Delayed job processing
+
+## CI/CD Integration
+
+The tests work in GitHub Actions automatically:
+
+```yaml
+- name: Run MariaDB tests
+  run: pnpm test:mariadb
+```
+
+Docker is pre-installed in GitHub runners, so no additional setup needed.