@webstir-io/webstir-backend 0.1.15

package/templates/backend/env.ts

@@ -0,0 +1,174 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+
+export interface AuthSecrets {
+  jwtSecret?: string;
+  jwtIssuer?: string;
+  jwtAudience?: string;
+  serviceTokens: string[];
+}
+
+export interface LoggingConfig {
+  level: LogLevel;
+  serviceName: string;
+}
+
+export interface MetricsConfig {
+  enabled: boolean;
+  windowSize: number;
+}
+
+export interface DatabaseConfig {
+  url: string;
+  migrationsTable: string;
+}
+
+export interface AppEnv {
+  NODE_ENV: string;
+  PORT: number;
+  API_BASE_URL: string;
+  auth: AuthSecrets;
+  logging: LoggingConfig;
+  metrics: MetricsConfig;
+  database: DatabaseConfig;
+}
+
+const ENV_FILES = ['.env.local', '.env'];
+const WORKSPACE_ROOT = resolveWorkspaceRoot();
+let envLoaded = false;
+
+export function loadEnv(): AppEnv {
+  if (!envLoaded) {
+    loadEnvFiles();
+    envLoaded = true;
+  }
+
+  const NODE_ENV = process.env.NODE_ENV ?? 'development';
+  const PORT = parsePort(process.env.PORT ?? '4000');
+  const API_BASE_URL = requireEnv('API_BASE_URL', 'http://localhost:4000');
+  const auth: AuthSecrets = {
+    jwtSecret: process.env.AUTH_JWT_SECRET,
+    jwtIssuer: process.env.AUTH_JWT_ISSUER,
+    jwtAudience: process.env.AUTH_JWT_AUDIENCE,
+    serviceTokens: parseList(process.env.AUTH_SERVICE_TOKENS)
+  };
+  const logging: LoggingConfig = {
+    level: parseLogLevel(process.env.LOG_LEVEL),
+    serviceName: process.env.LOG_SERVICE_NAME ?? 'backend-template'
+  };
+  const metrics: MetricsConfig = {
+    enabled: parseBoolean(process.env.METRICS_ENABLED, true),
+    windowSize: parsePositiveInt(process.env.METRICS_WINDOW, 200)
+  };
+  const database: DatabaseConfig = {
+    url: process.env.DATABASE_URL ?? 'file:./data/dev.sqlite',
+    migrationsTable: process.env.DATABASE_MIGRATIONS_TABLE ?? '_webstir_migrations'
+  };
+
+  return {
+    NODE_ENV,
+    PORT,
+    API_BASE_URL,
+    auth,
+    logging,
+    metrics,
+    database
+  };
+}
+
+function loadEnvFiles(): void {
+  for (const file of ENV_FILES) {
+    const full = path.resolve(WORKSPACE_ROOT, file);
+    if (!existsSync(full)) continue;
+    try {
+      applyEnvFile(full);
+    } catch (error) {
+      console.warn(`[webstir-backend] failed to load ${file}: ${(error as Error).message}`);
+    }
+  }
+}
+
+function applyEnvFile(filePath: string): void {
+  const lines = readFileSync(filePath, 'utf8').split(/\r?\n/);
+  for (const line of lines) {
+    if (!line || line.trim().startsWith('#')) continue;
+    const idx = line.indexOf('=');
+    if (idx === -1) continue;
+    const key = line.slice(0, idx).trim();
+    if (!key || process.env[key] !== undefined) continue;
+    let value = line.slice(idx + 1).trim();
+    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith('\'') && value.endsWith('\''))) {
+      value = value.slice(1, -1);
+    }
+    process.env[key] = value;
+  }
+}
+
+function requireEnv(name: string, fallback?: string): string {
+  const value = process.env[name] ?? fallback;
+  if (value === undefined) {
+    throw new Error(`Missing required env var ${name}`);
+  }
+  return value;
+}
+
+function parsePort(value: string): number {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed) || parsed <= 0) {
+    return 4000;
+  }
+  return parsed;
+}
+
+function parseList(value: string | undefined): string[] {
+  if (!value) return [];
+  return value
+    .split(/[,\s]+/)
+    .map((item) => item.trim())
+    .filter((item) => item.length > 0);
+}
+
+function parseLogLevel(value: string | undefined): LogLevel {
+  const normalized = (value ?? 'info').toLowerCase();
+  if (normalized === 'trace' || normalized === 'debug' || normalized === 'info' || normalized === 'warn' || normalized === 'error' || normalized === 'fatal') {
+    return normalized;
+  }
+  return 'info';
+}
+
+function parseBoolean(value: string | undefined, fallback: boolean): boolean {
+  if (value === undefined) return fallback;
+  const normalized = value.toLowerCase();
+  return normalized === '1' || normalized === 'true' || normalized === 'yes' || normalized === 'on';
+}
+
+function parsePositiveInt(value: string | undefined, fallback: number): number {
+  if (!value) return fallback;
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed) || parsed <= 0) {
+    return fallback;
+  }
+  return Math.floor(parsed);
+}
+
+export function resolveWorkspaceRoot(): string {
+  if (process.env.WORKSPACE_ROOT) {
+    return process.env.WORKSPACE_ROOT;
+  }
+  try {
+    const filePath = fileURLToPath(import.meta.url);
+    const dir = path.dirname(filePath);
+    if (dir.endsWith(`${path.sep}src${path.sep}backend`)) {
+      return path.resolve(dir, '..', '..');
+    }
+    if (dir.endsWith(`${path.sep}build${path.sep}backend`)) {
+      return path.resolve(dir, '..', '..');
+    }
+  } catch {
+    // ignore
+  }
+  return process.cwd();
+}

package/templates/backend/functions/hello/index.ts

@@ -0,0 +1,29 @@
+// Example function entry (invoked by your runtime)
+// This is a simple placeholder; wire it into your job/queue system as needed.
+
+export async function run(): Promise<void> {
+  // Do some background work here
+  // e.g., send an email, process a small batch, etc.
+  console.info('[function:hello] ran at', new Date().toISOString());
+}
+
+// Execute when launched directly: `node build/backend/functions/hello/index.js`
+const isMain = (() => {
+  try {
+    const argv1 = process.argv?.[1];
+    if (!argv1) return false;
+    const here = new URL(import.meta.url);
+    const run = new URL(`file://${argv1}`);
+    return here.pathname === run.pathname;
+  } catch {
+    return false;
+  }
+})();
+
+if (isMain) {
+  run().catch((err) => {
+    console.error(err);
+    process.exitCode = 1;
+  });
+}
+