@open-xchange/fastify-sdk 0.1.0

package/lib/redis/index.js

@@ -0,0 +1,58 @@
+import Redis from 'ioredis'
+
+const defaultQueueOptions = { enableReadyCheck: false, maxRetriesPerRequest: null }
+
+export function createRedisClient (options = {}) {
+  const hosts = (process.env.REDIS_HOSTS || process.env.REDIS_HOST || '').split(',').filter(Boolean).map(host => {
+    const [hostname, port] = host.split(':')
+    return { host: hostname, port: Number(port) || 6379 }
+  })
+
+  const tlsOptions = {}
+  if (process.env.REDIS_TLS_ENABLED === 'true') {
+    tlsOptions.tls = {}
+    if (process.env.REDIS_TLS_CA) tlsOptions.tls.ca = process.env.REDIS_TLS_CA
+  }
+
+  let clientOptions = {
+    username: process.env.REDIS_USERNAME,
+    db: Number(process.env.REDIS_DB) || 0,
+    password: process.env.REDIS_PASSWORD,
+    ...tlsOptions,
+    ...defaultQueueOptions,
+    ...options
+  }
+
+  const mode = process.env.REDIS_MODE || 'standalone'
+
+  if (mode === 'sentinel') {
+    clientOptions = {
+      sentinels: hosts,
+      name: process.env.REDIS_SENTINEL_MASTER_ID,
+      ...clientOptions
+    }
+  } else if (mode === 'standalone' && hosts.length > 0) {
+    clientOptions = {
+      ...hosts[0],
+      ...clientOptions
+    }
+  }
+
+  if (mode === 'cluster') {
+    return new Redis.Cluster(hosts, { redisOptions: clientOptions })
+  }
+  return new Redis(clientOptions)
+}
+
+export function createRedisClientFromEnv (options = {}) {
+  return createRedisClient(options)
+}
+
+export async function redisReadyCheck (client) {
+  return new Promise((resolve, reject) => {
+    const rawClient = client.getClient ? client.getClient() : client
+    if (rawClient.status === 'ready') return resolve()
+    rawClient.once('ready', () => resolve())
+    rawClient.once('error', (err) => reject(err))
+  })
+}

package/lib/testing/index.js

@@ -0,0 +1,32 @@
+import pino from 'pino'
+import { createApp } from '../app.js'
+
+export { generateTokenForJwks, getJwks } from './jwt.js'
+
+const silentLogger = pino({ level: 'silent' })
+
+export async function createTestApp (options = {}) {
+  const {
+    plugins: pluginOverrides = {},
+    ...rest
+  } = options
+
+  const defaultTestPlugins = {
+    cors: false,
+    helmet: false,
+    metrics: false,
+    logging: false,
+    ...pluginOverrides
+  }
+
+  return createApp({
+    pluginsDir: null,
+    metricsServer: false,
+    ...rest,
+    plugins: defaultTestPlugins,
+    fastify: {
+      loggerInstance: silentLogger,
+      ...options.fastify
+    }
+  })
+}

package/lib/testing/jwt.js

@@ -0,0 +1,17 @@
+import * as jose from 'jose'
+
+const { publicKey, privateKey } = await jose.generateKeyPair('RS256')
+
+export async function generateTokenForJwks (payload, kid, issuer) {
+  return new jose.SignJWT(payload)
+    .setProtectedHeader({ alg: 'RS256', kid })
+    .setSubject(payload.userId || payload.sub || 'test')
+    .setIssuer(issuer)
+    .sign(privateKey)
+}
+
+export async function getJwks (kid) {
+  const jwk = await jose.exportJWK(publicKey)
+  jwk.kid = kid || jwk.kid
+  return { keys: [jwk] }
+}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@open-xchange/fastify-sdk",
+  "version": "0.1.0",
+  "description": "Shared foundation package for OX App Suite Node.js services",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": "./lib/index.js",
+    "./mysql": "./lib/database/mysql.js",
+    "./postgres": "./lib/database/postgres.js",
+    "./migrations": "./lib/database/migrations.js",
+    "./config": "./lib/config/index.js",
+    "./redis": "./lib/redis/index.js",
+    "./testing": "./lib/testing/index.js",
+    "./lint": "./lib/lint/index.js"
+  },
+  "scripts": {
+    "lint": "eslint . --cache --fix",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
+  },
+  "author": "Open-Xchange",
+  "license": "AGPL-3.0-or-later",
+  "dependencies": {
+    "@fastify/autoload": "^6.3.1",
+    "@fastify/cors": "^11.2.0",
+    "@fastify/helmet": "^13.0.2",
+    "@fastify/jwt": "^10.0.0",
+    "@fastify/sensible": "^6.0.4",
+    "@fastify/static": "^9.0.0",
+    "@fastify/swagger": "^9.7.0",
+    "@fastify/swagger-ui": "^5.2.5",
+    "ajv-errors": "^3.0.0",
+    "chokidar": "^5.0.0",
+    "fastify": "^5.7.4",
+    "fastify-metrics": "^12.1.0",
+    "fastify-plugin": "^5.1.0",
+    "http-errors": "^2.0.1",
+    "joi": "^18.0.2",
+    "jose": "^6.1.3",
+    "js-yaml": "^4.1.1",
+    "pino": "^10.3.1",
+    "pino-pretty": "^13.1.3",
+    "prom-client": "^15.1.3"
+  },
+  "peerDependencies": {
+    "ioredis": "^5.9.0",
+    "mysql2": "^3.16.0",
+    "pg": "^8.16.0",
+    "umzug": "^3.8.2"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": {
+      "optional": true
+    },
+    "mysql2": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    },
+    "umzug": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@open-xchange/lint": "^0.2.1",
+    "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^9.39.2",
+    "ioredis": "^5.9.2",
+    "mysql2": "^3.16.3",
+    "pg": "^8.18.0",
+    "umzug": "^3.8.2",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "packageManager": "pnpm@10.27.0",
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "unrs-resolver"
+    ]
+  }
+}