ts-packages 1.0.0

package/packages/server-utils/src/types.ts

@@ -0,0 +1,64 @@
+import express from 'express';
+
+export interface CorsOptions {
+  origin?: string | string[] | boolean | RegExp | ((origin: string | undefined, callback: (err: Error | null, allow?: boolean) => void) => void);
+  methods?: string | string[];
+  allowedHeaders?: string | string[];
+  exposedHeaders?: string | string[];
+  credentials?: boolean;
+  maxAge?: number;
+  preflightContinue?: boolean;
+  optionsSuccessStatus?: number;
+}
+
+export interface ServerConfig {
+  port?: number;
+  cors?: boolean | CorsOptions;
+  helmet?: boolean;
+  json?: boolean;
+  customMiddleware?: express.RequestHandler[];
+  healthCheck?: boolean | string;
+  gracefulShutdown?: boolean;
+  socketIO?: SocketIOConfig;
+  name?: string;
+  version?: string;
+}
+
+export interface SocketIOConfig {
+  enabled?: boolean;
+  cors?: boolean | {
+    origin?: string | string[] | boolean;
+    methods?: string[];
+    credentials?: boolean;
+  };
+  onConnection?: (socket: unknown) => void;
+  onDisconnection?: (socket: unknown, reason: string) => void;
+  path?: string;
+}
+
+export interface HealthCheckConfig {
+  path?: string;
+  customChecks?: HealthCheck[];
+}
+
+export interface HealthCheck {
+  name: string;
+  check: () => Promise<boolean>;
+}
+
+export interface GracefulShutdownConfig {
+  timeout?: number;
+  onShutdown?: () => Promise<void>;
+}
+
+export interface SocketInstance {
+  id: string;
+  emit: (event: string, data?: unknown) => void;
+  on: (event: string, handler: (...args: unknown[]) => void) => void;
+  broadcast: {
+    emit: (event: string, data?: unknown) => void;
+  };
+  disconnect: () => void;
+}
+
+export type ServerPlugin = (app: express.Application, config: ServerConfig) => void;

package/packages/server-utils/src/utils.ts

@@ -0,0 +1,34 @@
+// Environment utilities
+export function getEnv(key: string, defaultValue?: string): string {
+  const value = process.env[key];
+  if (value === undefined && defaultValue === undefined) {
+    throw new Error(`Environment variable ${key} is required`);
+  }
+  return value || defaultValue!;
+}
+
+export function getEnvNumber(key: string, defaultValue?: number): number {
+  const value = process.env[key];
+  if (value === undefined) {
+    if (defaultValue === undefined) {
+      throw new Error(`Environment variable ${key} is required`);
+    }
+    return defaultValue;
+  }
+  const parsed = parseInt(value, 10);
+  if (isNaN(parsed)) {
+    throw new Error(`Environment variable ${key} must be a number`);
+  }
+  return parsed;
+}
+
+export function getEnvBoolean(key: string, defaultValue?: boolean): boolean {
+  const value = process.env[key];
+  if (value === undefined) {
+    if (defaultValue === undefined) {
+      throw new Error(`Environment variable ${key} is required`);
+    }
+    return defaultValue;
+  }
+  return value.toLowerCase() === 'true';
+}

package/packages/server-utils/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "moduleResolution": "node",
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "baseUrl": ".",
+    "paths": {
+      "*": ["*", "*.ts", "*.js"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+packages:
+  - "packages/*"