Skip to content

A self-hosted UPI & COD payment gateway with zero per-transaction platform fees, universal JavaScript checkout integration, dynamic QR payments, WhatsApp OTP authentication, and automated payment verification.

JavaScript

fix(startup): load root environment before development migrations

Samir Hanna Verzafac4a233f587
diff --git a/scripts/dev-env.test.js b/scripts/dev-env.test.js
new file mode 100644
index 0000000..309d26a
--- /dev/null
+++ b/scripts/dev-env.test.js
@@ -0,0 +1,154 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+
+const repoRoot = fileURLToPath(new URL('..', import.meta.url));
+
+function runDev(t, { envFile, shellEnv = {} } = {}) {
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'youpi dev env '));
+ t.after(() => fs.rmSync(root, { recursive: true, force: true }));
+ fs.writeFileSync(path.join(root, 'package.json'), '{"type":"module"}');
+
+ // Exercise the real launcher, migrations, SQLite and child-process environment
+ // in a scratch checkout. Only network-facing servers are replaced with fixtures.
+ for (const name of ['common', 'db']) {
+ const destination = path.join(root, 'packages', name);
+ fs.mkdirSync(destination, { recursive: true });
+ fs.cpSync(path.join(repoRoot, 'packages', name, 'src'), path.join(destination, 'src'), { recursive: true });
+ fs.copyFileSync(path.join(repoRoot, 'packages', name, 'package.json'), path.join(destination, 'package.json'));
+ }
+ fs.mkdirSync(path.join(root, 'node_modules', '@youpi'), { recursive: true });
+ fs.symlinkSync(path.join(root, 'packages', 'common'), path.join(root, 'node_modules', '@youpi', 'common'),
+ process.platform === 'win32' ? 'junction' : 'dir');
+ fs.mkdirSync(path.join(root, 'scripts'));
+ fs.copyFileSync(path.join(repoRoot, 'scripts', 'dev.js'), path.join(root, 'scripts', 'dev.js'));
+ fs.mkdirSync(path.join(root, 'apps', 'control-center', 'src'), { recursive: true });
+ fs.copyFileSync(path.join(repoRoot, 'apps', 'control-center', 'src', 'process-manager.js'),
+ path.join(root, 'apps', 'control-center', 'src', 'process-manager.js'));
+ if (envFile !== undefined) fs.writeFileSync(path.join(root, '.env'), envFile);
+
+ fs.mkdirSync(path.join(root, 'apps', 'payment-api', 'src'), { recursive: true });
+ fs.writeFileSync(path.join(root, 'apps', 'payment-api', 'src', 'index.js'), `
+import { getDatabase } from '../../../packages/db/src/database.js';
+const db = getDatabase();
+console.log('CHILD_CONFIG ' + JSON.stringify({
+ database: db.queryOne('PRAGMA database_list').file,
+ merchant: db.queryOne('SELECT business_name FROM merchants').business_name,
+ port: Number(process.env.PAYMENT_API_PORT || 6100),
+ nodeEnv: process.env.NODE_ENV,
+ mode: process.env.YOUPI_MODE
+}));
+db.close();
+`);
+ fs.writeFileSync(path.join(root, 'apps', 'control-center', 'src', 'index.js'), `
+import { once } from 'node:events';
+import { ProcessManager } from './process-manager.js';
+import { getDatabase } from '../../../packages/db/src/database.js';
+export async function startControlCenter() {
+ const manager = new ProcessManager();
+ const db = getDatabase();
+ console.log('PARENT_CONFIG ' + JSON.stringify({
+ database: db.queryOne('PRAGMA database_list').file,
+ merchant: db.queryOne('SELECT business_name FROM merchants').business_name,
+ port: manager.getService('payment-api').port,
+ nodeEnv: process.env.NODE_ENV,
+ mode: process.env.YOUPI_MODE
+ }));
+ manager.on('log', entry => console.log(entry.line));
+ manager.startAll = async () => {
+ const service = await manager.startService('payment-api');
+ const [code] = await once(service.child, 'exit');
+ if (code !== 0) throw new Error('Fixture child exited with code ' + code);
+ };
+ return { processManager: manager, close: async () => {} };
+}
+`);
+
+ // Launch outside the repository root to require module-relative .env lookup.
+ const cwd = path.join(root, 'another working directory');
+ fs.mkdirSync(cwd);
+ const result = spawnSync(process.execPath, [path.join(root, 'scripts', 'dev.js')], {
+ cwd,
+ env: { PATH: process.env.PATH, ...(process.env.SystemRoot ? { SystemRoot: process.env.SystemRoot } : {}), ...shellEnv },
+ encoding: 'utf8',
+ timeout: 15000
+ });
+ assert.equal(result.status, 0, `${result.error || ''}\n${result.stderr}\n${result.stdout}`);
+ const readConfig = prefix => {
+ const line = result.stdout.split('\n').find(value => value.startsWith(prefix));
+ assert.ok(line, result.stdout);
+ const config = JSON.parse(line.slice(prefix.length));
+ config.database = path.relative(fs.realpathSync(root), config.database);
+ return config;
+ };
+ return {
+ parent: readConfig('PARENT_CONFIG '),
+ child: readConfig('CHILD_CONFIG '),
+ defaultDatabaseExists: fs.existsSync(path.join(root, 'data', 'youpi_pg.sqlite'))
+ };
+}
+
+const configuredEnv = [
+ 'SQLITE_DB_PATH=./data/configured.sqlite',
+ 'DEFAULT_MERCHANT_NAME="Configured Fixture Merchant"',
+ 'PAYMENT_API_PORT=16100'
+].join('\n');
+
+test('dev loads root .env before migrating and constructing the service registry', t => {
+ const { parent, child, defaultDatabaseExists } = runDev(t, { envFile: configuredEnv });
+ assert.deepEqual(parent, {
+ database: path.join('data', 'configured.sqlite'),
+ merchant: 'Configured Fixture Merchant',
+ port: 16100,
+ nodeEnv: 'development',
+ mode: 'localhost'
+ });
+ assert.deepEqual(child, parent, 'supervisor and child must share the configured database and defaults');
+ assert.equal(defaultDatabaseExists, false, 'dev must not migrate an unintended default database');
+});
+
+test('dev defaults keep priority over production modes in .env', t => {
+ const { parent, child } = runDev(t, { envFile: `${configuredEnv}\nNODE_ENV=production\nYOUPI_MODE=production\n` });
+ for (const config of [parent, child]) {
+ assert.equal(config.nodeEnv, 'development');
+ assert.equal(config.mode, 'localhost');
+ }
+});
+
+test('dev still starts with shared defaults when .env is absent', t => {
+ const { parent, child } = runDev(t);
+ assert.deepEqual(parent, {
+ database: path.join('data', 'youpi_pg.sqlite'),
+ merchant: 'YOUPI Demo Store',
+ port: 6100,
+ nodeEnv: 'development',
+ mode: 'localhost'
+ });
+ assert.deepEqual(child, parent);
+});
+
+test('explicit shell configuration retains priority over .env and dev defaults', t => {
+ const { parent, child, defaultDatabaseExists } = runDev(t, {
+ envFile: `${configuredEnv}\nNODE_ENV=development\nYOUPI_MODE=localhost\n`,
+ shellEnv: {
+ SQLITE_DB_PATH: './data/shell.sqlite',
+ DEFAULT_MERCHANT_NAME: 'Shell Fixture Merchant',
+ PAYMENT_API_PORT: '17100',
+ NODE_ENV: 'production',
+ YOUPI_MODE: 'production'
+ }
+ });
+ assert.deepEqual(parent, {
+ database: path.join('data', 'shell.sqlite'),
+ merchant: 'Shell Fixture Merchant',
+ port: 17100,
+ nodeEnv: 'production',
+ mode: 'production'
+ });
+ assert.deepEqual(child, parent);
+ assert.equal(defaultDatabaseExists, false);
+});
diff --git a/scripts/dev.js b/scripts/dev.js
index 7efc513..a53df4c 100644
--- a/scripts/dev.js
+++ b/scripts/dev.js
@@ -1,4 +1,6 @@
import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
import { runMigrations } from '../packages/db/src/migrate.js';
import { startControlCenter } from '../apps/control-center/src/index.js';
import { startCloudflaredSafely } from '../packages/common/src/tunnel-command.js';
@@ -6,6 +8,11 @@ import { startCloudflaredSafely } from '../packages/common/src/tunnel-command.js
if (!process.env.YOUPI_MODE) process.env.YOUPI_MODE = 'localhost';
if (!process.env.NODE_ENV) process.env.NODE_ENV = 'development';
+// Load the shared configuration before migrations and service discovery. Set the
+// dev defaults first so .env cannot override them; explicit shell values still win.
+const rootEnv = fileURLToPath(new URL('../.env', import.meta.url));
+if (fs.existsSync(rootEnv)) process.loadEnvFile(rootEnv);
+
console.log('====================================================');
console.log('🚀 Starting YOUPI PG (Development / Localhost Mode)');
console.log('====================================================');
diff --git a/scripts/test-all.js b/scripts/test-all.js
index 65ccf0e..022842f 100644
--- a/scripts/test-all.js
+++ b/scripts/test-all.js
@@ -47,7 +47,8 @@ const testFiles = [
'apps/payment-api/src/__tests__/gateway-hardening-invariants.test.js',
'apps/payment-api/src/__tests__/observer-poller.test.js',
'scripts/chaos-concurrency.test.js',
- 'scripts/production-infrastructure.test.js'
+ 'scripts/production-infrastructure.test.js',
+ 'scripts/dev-env.test.js'
];
console.log('============================================================');