@archlast/server 0.1.8 → 0.1.9

package/package.json

@@ -1,210 +1,214 @@
-{
-    "name": "@archlast/server",
-    "version": "0.1.8",
-    "description": "Archlast server library exports and Docker templates",
-    "license": "MIT",
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/algochad/archlast-sync.git"
-    },
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js",
-            "default": "./dist/index.js"
-        },
-        "./functions/definition": {
-            "types": "./dist/functions/definition.d.ts",
-            "import": "./dist/functions/definition.js",
-            "default": "./dist/functions/definition.js"
-        },
-        "./functions/types": {
-            "types": "./dist/functions/types.d.ts",
-            "import": "./dist/functions/types.js",
-            "default": "./dist/functions/types.js"
-        },
-        "./schema/definition": {
-            "types": "./dist/schema/definition.d.ts",
-            "import": "./dist/schema/definition.js",
-            "default": "./dist/schema/definition.js"
-        },
-        "./schema/validators": {
-            "types": "./dist/schema/validators.d.ts",
-            "import": "./dist/schema/validators.js",
-            "default": "./dist/schema/validators.js"
-        },
-        "./db/interfaces": {
-            "types": "./dist/db/interfaces.d.ts",
-            "import": "./dist/db/interfaces.js",
-            "default": "./dist/db/interfaces.js"
-        },
-        "./auth/interfaces": {
-            "types": "./dist/auth/interfaces.d.ts",
-            "import": "./dist/auth/interfaces.js",
-            "default": "./dist/auth/interfaces.js"
-        },
-        "./repository/interfaces": {
-            "types": "./dist/repository/interfaces.d.ts",
-            "import": "./dist/repository/interfaces.js",
-            "default": "./dist/repository/interfaces.js"
-        },
-        "./repository/factory": {
-            "types": "./dist/repository/factory.d.ts",
-            "import": "./dist/repository/factory.js",
-            "default": "./dist/repository/factory.js"
-        },
-        "./jobs/scheduler": {
-            "types": "./dist/jobs/scheduler.d.ts",
-            "import": "./dist/jobs/scheduler.js",
-            "default": "./dist/jobs/scheduler.js"
-        },
-        "./jobs/queue": {
-            "types": "./dist/jobs/queue.d.ts",
-            "import": "./dist/jobs/queue.js",
-            "default": "./dist/jobs/queue.js"
-        },
-        "./jobs": {
-            "types": "./dist/jobs/index.d.ts",
-            "import": "./dist/jobs/index.js",
-            "default": "./dist/jobs/index.js"
-        },
-        "./storage/types": {
-            "types": "./dist/storage/types.d.ts",
-            "import": "./dist/storage/types.js",
-            "default": "./dist/storage/types.js"
-        },
-        "./logging/logger": {
-            "types": "./dist/logging/logger.d.ts",
-            "import": "./dist/logging/logger.js",
-            "default": "./dist/logging/logger.js"
-        },
-        "./context": {
-            "types": "./dist/context.d.ts",
-            "import": "./dist/context.js",
-            "default": "./dist/context.js"
-        },
-        "./jobs/scheduler-client": {
-            "types": "./dist/jobs/scheduler.d.ts",
-            "import": "./dist/jobs/scheduler.js",
-            "default": "./dist/jobs/scheduler.js"
-        },
-        "./di/decorators": {
-            "types": "./dist/di/decorators.d.ts",
-            "import": "./dist/di/decorators.js",
-            "default": "./dist/di/decorators.js"
-        },
-        "./di/container": {
-            "types": "./dist/di/container.d.ts",
-            "import": "./dist/di/container.js",
-            "default": "./dist/di/container.js"
-        },
-        "./webhook/guard": {
-            "types": "./dist/webhook/guard.d.ts",
-            "import": "./dist/webhook/guard.js",
-            "default": "./dist/webhook/guard.js"
-        },
-        "./webhook/verifier": {
-            "types": "./dist/webhook/verifier.d.ts",
-            "import": "./dist/webhook/verifier.js",
-            "default": "./dist/webhook/verifier.js"
-        },
-        "./http/definition": {
-            "types": "./dist/http/definition.d.ts",
-            "import": "./dist/http/definition.js",
-            "default": "./dist/http/definition.js"
-        },
-        "./http/router": {
-            "types": "./dist/http/router.d.ts",
-            "import": "./dist/http/router.js",
-            "default": "./dist/http/router.js"
-        },
-        "./http": {
-            "types": "./dist/http/index.d.ts",
-            "import": "./dist/http/index.js",
-            "default": "./dist/http/index.js"
-        },
-        "./webhook": {
-            "types": "./dist/webhook/index.d.ts",
-            "import": "./dist/webhook/index.js",
-            "default": "./dist/webhook/index.js"
-        },
-        "./webhook/definition": {
-            "types": "./dist/webhook/definition.d.ts",
-            "import": "./dist/webhook/definition.js",
-            "default": "./dist/webhook/definition.js"
-        },
-        "./docker": {
-            "types": "./dist/docker/index.d.ts",
-            "import": "./dist/docker/index.js",
-            "default": "./dist/docker/index.js"
-        }
-    },
-    "files": [
-        "dist",
-        "templates",
-        "docker",
-        "scripts/postinstall.js",
-        "README.md",
-        "LICENSE"
-    ],
-    "archlast": {
-        "dockerImage": "algochad/archlast-server",
-        "defaultTag": "latest",
-        "minDockerVersion": "24.0.0"
-    },
-    "scripts": {
-        "build": "bun run build:library && bun run build:startup",
-        "build:library": "tsc",
-        "build:startup": "bun build startup.ts --outdir dist --target node --format esm",
-        "build:types": "tsc --emitDeclarationOnly --declaration",
-        "typecheck": "tsc --noEmit",
-        "start": "bun dist/startup.js",
-        "dev": "bun startup.ts",
-        "postinstall": "node scripts/postinstall.js",
-        "test": "bun test tests",
-        "test:cache": "bun test tests/cache",
-        "test:repository": "bun test tests/repository",
-        "test:ipc": "bun test tests/ipc",
-        "test:jobs": "bun test tests/jobs",
-        "format": "prettier --write \"**/*.{ts,tsx,js,jsx,json,md}\"",
-        "format:check": "prettier --check \"**/*.{ts,tsx,js,jsx,json,md}\"",
-        "clean": "rm -rf dist"
-    },
-    "dependencies": {
-        "@elysiajs/cors": "^1.4.0",
-        "@elysiajs/swagger": "^1.3.1",
-        "@paralleldrive/cuid2": "^3.0.4",
-        "@react-email/components": "^1.0.2",
-        "@trpc/server": "^11.8.1",
-        "archiver": "^7.0.1",
-        "better-auth": "^1.0.0",
-        "better-sqlite3": "^12.5.0",
-        "elysia": "^1.4.19",
-        "jose": "^6.1.3",
-        "linqts": "^3.2.0",
-        "nodemailer": "^7.0.12",
-        "otpauth": "^9.4.1",
-        "react": "^19.2.3",
-        "react-dom": "^19.2.3",
-        "react-email": "^5.1.0",
-        "reflect-metadata": "^0.2.2",
-        "safe-memory-cache": "^3.0.0",
-        "stream-json": "^1.9.1",
-        "unzipper": "^0.12.3",
-        "vitest": "^4.0.16",
-        "zod": "^4.2.1"
-    },
-    "devDependencies": {
-        "@types/archiver": "^7.0.0",
-        "@types/better-sqlite3": "^7.6.13",
-        "@types/bun": "latest",
-        "@types/nodemailer": "^7.0.4",
-        "@types/react": "^19.0.0",
-        "@types/react-dom": "^19.0.0",
-        "@types/unzipper": "^0.10.11",
-        "ts-morph": "^27.0.2",
-        "typescript": "^5.0.0"
-    }
-}
+{
+    "name": "@archlast/server",
+    "version": "0.1.9",
+    "description": "Archlast server library exports and Docker templates",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/algochad/archlast-sync.git"
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "default": "./dist/index.js"
+        },
+        "./functions/definition": {
+            "types": "./dist/functions/definition.d.ts",
+            "import": "./dist/functions/definition.js",
+            "default": "./dist/functions/definition.js"
+        },
+        "./functions/types": {
+            "types": "./dist/functions/types.d.ts",
+            "import": "./dist/functions/types.js",
+            "default": "./dist/functions/types.js"
+        },
+        "./schema/definition": {
+            "types": "./dist/schema/definition.d.ts",
+            "import": "./dist/schema/definition.js",
+            "default": "./dist/schema/definition.js"
+        },
+        "./schema/validators": {
+            "types": "./dist/schema/validators.d.ts",
+            "import": "./dist/schema/validators.js",
+            "default": "./dist/schema/validators.js"
+        },
+        "./db/interfaces": {
+            "types": "./dist/db/interfaces.d.ts",
+            "import": "./dist/db/interfaces.js",
+            "default": "./dist/db/interfaces.js"
+        },
+        "./auth/interfaces": {
+            "types": "./dist/auth/interfaces.d.ts",
+            "import": "./dist/auth/interfaces.js",
+            "default": "./dist/auth/interfaces.js"
+        },
+        "./repository/interfaces": {
+            "types": "./dist/repository/interfaces.d.ts",
+            "import": "./dist/repository/interfaces.js",
+            "default": "./dist/repository/interfaces.js"
+        },
+        "./repository/factory": {
+            "types": "./dist/repository/factory.d.ts",
+            "import": "./dist/repository/factory.js",
+            "default": "./dist/repository/factory.js"
+        },
+        "./jobs/scheduler": {
+            "types": "./dist/jobs/scheduler.d.ts",
+            "import": "./dist/jobs/scheduler.js",
+            "default": "./dist/jobs/scheduler.js"
+        },
+        "./jobs/queue": {
+            "types": "./dist/jobs/queue.d.ts",
+            "import": "./dist/jobs/queue.js",
+            "default": "./dist/jobs/queue.js"
+        },
+        "./jobs": {
+            "types": "./dist/jobs/index.d.ts",
+            "import": "./dist/jobs/index.js",
+            "default": "./dist/jobs/index.js"
+        },
+        "./storage/types": {
+            "types": "./dist/storage/types.d.ts",
+            "import": "./dist/storage/types.js",
+            "default": "./dist/storage/types.js"
+        },
+        "./logging/logger": {
+            "types": "./dist/logging/logger.d.ts",
+            "import": "./dist/logging/logger.js",
+            "default": "./dist/logging/logger.js"
+        },
+        "./context": {
+            "types": "./dist/context.d.ts",
+            "import": "./dist/context.js",
+            "default": "./dist/context.js"
+        },
+        "./jobs/scheduler-client": {
+            "types": "./dist/jobs/scheduler.d.ts",
+            "import": "./dist/jobs/scheduler.js",
+            "default": "./dist/jobs/scheduler.js"
+        },
+        "./di/decorators": {
+            "types": "./dist/di/decorators.d.ts",
+            "import": "./dist/di/decorators.js",
+            "default": "./dist/di/decorators.js"
+        },
+        "./di/container": {
+            "types": "./dist/di/container.d.ts",
+            "import": "./dist/di/container.js",
+            "default": "./dist/di/container.js"
+        },
+        "./webhook/guard": {
+            "types": "./dist/webhook/guard.d.ts",
+            "import": "./dist/webhook/guard.js",
+            "default": "./dist/webhook/guard.js"
+        },
+        "./webhook/verifier": {
+            "types": "./dist/webhook/verifier.d.ts",
+            "import": "./dist/webhook/verifier.js",
+            "default": "./dist/webhook/verifier.js"
+        },
+        "./http/definition": {
+            "types": "./dist/http/definition.d.ts",
+            "import": "./dist/http/definition.js",
+            "default": "./dist/http/definition.js"
+        },
+        "./http/router": {
+            "types": "./dist/http/router.d.ts",
+            "import": "./dist/http/router.js",
+            "default": "./dist/http/router.js"
+        },
+        "./http": {
+            "types": "./dist/http/index.d.ts",
+            "import": "./dist/http/index.js",
+            "default": "./dist/http/index.js"
+        },
+        "./webhook": {
+            "types": "./dist/webhook/index.d.ts",
+            "import": "./dist/webhook/index.js",
+            "default": "./dist/webhook/index.js"
+        },
+        "./webhook/definition": {
+            "types": "./dist/webhook/definition.d.ts",
+            "import": "./dist/webhook/definition.js",
+            "default": "./dist/webhook/definition.js"
+        },
+        "./docker": {
+            "types": "./dist/docker/index.d.ts",
+            "import": "./dist/docker/index.js",
+            "default": "./dist/docker/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "templates",
+        "docker",
+        "scripts/postinstall.js",
+        "README.md",
+        "LICENSE"
+    ],
+    "archlast": {
+        "dockerImage": "algochad/archlast-server",
+        "defaultTag": "latest",
+        "minDockerVersion": "24.0.0"
+    },
+    "scripts": {
+        "build": "bun run build:library && bun run build:startup",
+        "build:library": "tsc",
+        "build:startup": "bun build startup.ts --outdir dist --target node --format esm",
+        "build:types": "tsc --emitDeclarationOnly --declaration",
+        "typecheck": "tsc --noEmit",
+        "start": "bun dist/startup.js",
+        "dev": "bun startup.ts",
+        "postinstall": "node scripts/postinstall.js",
+        "test": "bun test tests",
+        "test:cache": "bun test tests/cache",
+        "test:repository": "bun test tests/repository",
+        "test:ipc": "bun test tests/ipc",
+        "test:jobs": "bun test tests/jobs",
+        "format": "prettier --write \"**/*.{ts,tsx,js,jsx,json,md}\"",
+        "format:check": "prettier --check \"**/*.{ts,tsx,js,jsx,json,md}\"",
+        "clean": "rm -rf dist"
+    },
+    "dependencies": {
+        "@better-auth/expo": "^1.4.18",
+        "@elysiajs/cors": "^1.4.0",
+        "@elysiajs/swagger": "^1.3.1",
+        "@paralleldrive/cuid2": "^3.0.4",
+        "@react-email/components": "^1.0.2",
+        "@trpc/server": "^11.8.1",
+        "archiver": "^7.0.1",
+        "better-auth": "^1.0.0",
+        "better-sqlite3": "^12.5.0",
+        "bullmq": "^5.67.3",
+        "elysia": "^1.4.19",
+        "ioredis": "^5.4.1",
+        "jose": "^6.1.3",
+        "linqts": "^3.2.0",
+        "nodemailer": "^7.0.12",
+        "otpauth": "^9.4.1",
+        "prom-client": "^15.1.3",
+        "react": "^19.2.3",
+        "react-dom": "^19.2.3",
+        "react-email": "^5.1.0",
+        "reflect-metadata": "^0.2.2",
+        "safe-memory-cache": "^3.0.0",
+        "stream-json": "^1.9.1",
+        "unzipper": "^0.12.3",
+        "vitest": "^4.0.16",
+        "zod": "^4.2.1"
+    },
+    "devDependencies": {
+        "@types/archiver": "^7.0.0",
+        "@types/better-sqlite3": "^7.6.13",
+        "@types/bun": "latest",
+        "@types/nodemailer": "^7.0.4",
+        "@types/react": "^19.0.0",
+        "@types/react-dom": "^19.0.0",
+        "@types/unzipper": "^0.10.11",
+        "ts-morph": "^27.0.2",
+        "typescript": "^5.0.0"
+    }
+}

package/templates/.env.example

@@ -1,55 +1,115 @@
-# Archlast Docker runtime configuration
-
-# Server
-PORT=4000
-ARCHLAST_PORT=4000
-NODE_ENV=development
-
-# CORS
-ARCHLAST_ALLOWED_ORIGINS=http://localhost:3000,http://localhost:3001,http://localhost:4001
-ARCHLAST_CORS_ALLOW_CREDENTIALS=true
-
-# Data root
-ARCHLAST_DB_ROOT=/data
-STORAGE_ROOT=/data/storage
-STORAGE_SIGNING_SECRET=dev-secret
-
-# Document store connection
-ARCHLAST_STORE_HOST=127.0.0.1
-ARCHLAST_STORE_PORT=7001
-ARCHLAST_STORE_SECRET=
-ARCHLAST_STORE_FINGERPRINT=
-ARCHLAST_STORE_CA_PATH=
-ARCHLAST_STORE_NO_TLS=false
-ARCHLAST_STORE_AUTH_TIMEOUT=2000
-
-# Dashboard
-ARCHLAST_DASHBOARD_PORT=4001
-ARCHLAST_DASHBOARD_URL=
-
-# Admin authentication
-ARCHLAST_ADMIN_TOKEN=
-ARCHLAST_ADMIN_USERNAME=admin
-ARCHLAST_ADMIN_PASSWORD=change-me
-ARCHLAST_PROVISIONING_SECRET=
-
-# Auth system
-ARCHLAST_AUTH_TOKEN_PEPPER=
-
-# S3 storage (optional)
-S3_ENABLED=false
-S3_BUCKET=
-S3_REGION=
-AWS_ACCESS_KEY_ID=
-AWS_SECRET_ACCESS_KEY=
-
-# Deploy authentication
-ARCHLAST_DEPLOY_AUTH_REQUIRED=false
-
-# Development
-IS_DEV=true
-
-# Docker metadata
-ARCHLAST_VERSION=latest
-ARCHLAST_CONTAINER_NAME=archlast-server
-ARCHLAST_DATA_VOLUME=archlast-data
+# Archlast Docker runtime configuration
+
+# Server
+PORT=4000
+ARCHLAST_PORT=4000
+NODE_ENV=development
+
+# CORS
+ARCHLAST_ALLOWED_ORIGINS=http://localhost:3000,http://localhost:3001,http://localhost:4001
+ARCHLAST_CORS_ALLOW_CREDENTIALS=true
+
+# ============================================
+# Storage Provider Configuration
+# ============================================
+
+# SQLite Configuration (Default)
+# Path to SQLite database file
+SQLITE_PATH=/data/archlast.db
+
+# PostgreSQL Configuration (optional)
+# Uncomment to use PostgreSQL instead of SQLite
+# POSTGRES_HOST=localhost
+# POSTGRES_PORT=5432
+# POSTGRES_DB=archlast
+# POSTGRES_USER=archlast
+# POSTGRES_PASSWORD=your-password
+# POSTGRES_SSL=false
+
+# C# Document Store Configuration (optional)
+# Uncomment to use the C# document store provider
+# DOCUMENT_STORE_MODE=tcp
+# DOCUMENT_STORE_HOST=127.0.0.1
+# DOCUMENT_STORE_PORT=7001
+# DOCUMENT_STORE_SECRET=your-256-bit-hex-secret
+# DOCUMENT_STORE_CERT=/path/to/cert.pfx
+# DOCUMENT_STORE_CERT_PASSWORD=cert-password
+
+# Data root
+ARCHLAST_DB_ROOT=/data
+
+# Storage Configuration
+# NOTE: STORAGE_ROOT is deprecated. S3 storage is now required.
+STORAGE_ROOT=/data/storage
+STORAGE_SIGNING_SECRET=dev-secret
+
+# Dashboard
+ARCHLAST_DASHBOARD_PORT=4001
+ARCHLAST_DASHBOARD_URL=
+
+# Admin authentication
+ARCHLAST_ADMIN_TOKEN=
+ARCHLAST_ADMIN_USERNAME=admin
+ARCHLAST_ADMIN_PASSWORD=change-me
+ARCHLAST_PROVISIONING_SECRET=
+
+# Auth system
+ARCHLAST_AUTH_TOKEN_PEPPER=
+
+# ============================================
+# Docker Compose Services
+# ============================================
+# These services are automatically started with Docker Compose:
+# - redis: In-memory data store (port 6379, internal only)
+# - minio: S3-compatible object storage (ports 9000, 9001, optional)
+# - minio-init: Initializes MinIO bucket on startup
+
+# ============================================
+# Resource Limits
+# ============================================
+# Production overrides available in docker-compose.prod.yml
+# Redis: 512MB memory limit
+# MinIO: 1 CPU, 1GB memory limit
+
+# ============================================
+# S3-Compatible Storage Configuration (MinIO)
+# ============================================
+
+S3_ENABLED=true
+# For Docker Compose: Use 'http://minio:9000'
+# For external MinIO: Use 'http://localhost:9000' or external URL
+S3_ENDPOINT=http://minio:9000
+S3_BUCKET=archlast-storage
+S3_REGION=us-east-1
+S3_ACCESS_KEY_ID=minioadmin
+S3_SECRET_ACCESS_KEY=minioadmin
+
+# MinIO Root Credentials (for console access)
+MINIO_ROOT_USER=minioadmin
+MINIO_ROOT_PASSWORD=minioadmin
+
+# ============================================
+# Redis L2 Cache Configuration
+# ============================================
+
+# Redis L2 Cache (enabled by default for Docker Compose)
+REDIS_ENABLED=true
+# For Docker Compose: Use 'redis' (service name)
+# For external Redis: Use 'localhost' or external host IP
+REDIS_HOST=redis
+REDIS_PORT=6379
+# Set password when using external Redis
+REDIS_PASSWORD=
+REDIS_DB=0
+REDIS_TTL_MULTIPLIER=2
+
+# Deploy authentication
+ARCHLAST_DEPLOY_AUTH_REQUIRED=false
+
+# Development
+IS_DEV=true
+
+# Docker metadata
+ARCHLAST_VERSION=latest
+ARCHLAST_CONTAINER_NAME=archlast-server
+ARCHLAST_DATA_VOLUME=archlast-data