create-nexu 1.0.0

package/templates/default/packages/utils/src/index.test.ts

@@ -0,0 +1,130 @@
+import { describe, it, expect } from 'vitest';
+
+import {
+  capitalize,
+  slugify,
+  truncate,
+  pick,
+  omit,
+  isEmpty,
+  chunk,
+  unique,
+  isEmail,
+  isUrl,
+  clamp,
+  daysBetween,
+} from './index';
+
+describe('String utilities', () => {
+  describe('capitalize', () => {
+    it('should capitalize first letter', () => {
+      expect(capitalize('hello')).toBe('Hello');
+    });
+
+    it('should return empty string for empty input', () => {
+      expect(capitalize('')).toBe('');
+    });
+  });
+
+  describe('slugify', () => {
+    it('should convert string to slug', () => {
+      expect(slugify('Hello World')).toBe('hello-world');
+    });
+
+    it('should remove special characters', () => {
+      expect(slugify('Hello! World?')).toBe('hello-world');
+    });
+  });
+
+  describe('truncate', () => {
+    it('should truncate long strings', () => {
+      expect(truncate('Hello World', 8)).toBe('Hello...');
+    });
+
+    it('should not truncate short strings', () => {
+      expect(truncate('Hello', 10)).toBe('Hello');
+    });
+  });
+});
+
+describe('Object utilities', () => {
+  describe('pick', () => {
+    it('should pick specified keys', () => {
+      const obj = { a: 1, b: 2, c: 3 };
+      expect(pick(obj, ['a', 'c'])).toEqual({ a: 1, c: 3 });
+    });
+  });
+
+  describe('omit', () => {
+    it('should omit specified keys', () => {
+      const obj = { a: 1, b: 2, c: 3 };
+      expect(omit(obj, ['b'])).toEqual({ a: 1, c: 3 });
+    });
+  });
+
+  describe('isEmpty', () => {
+    it('should return true for empty values', () => {
+      expect(isEmpty(null)).toBe(true);
+      expect(isEmpty(undefined)).toBe(true);
+      expect(isEmpty('')).toBe(true);
+      expect(isEmpty([])).toBe(true);
+      expect(isEmpty({})).toBe(true);
+    });
+
+    it('should return false for non-empty values', () => {
+      expect(isEmpty('hello')).toBe(false);
+      expect(isEmpty([1])).toBe(false);
+      expect(isEmpty({ a: 1 })).toBe(false);
+    });
+  });
+});
+
+describe('Array utilities', () => {
+  describe('chunk', () => {
+    it('should split array into chunks', () => {
+      expect(chunk([1, 2, 3, 4, 5], 2)).toEqual([[1, 2], [3, 4], [5]]);
+    });
+  });
+
+  describe('unique', () => {
+    it('should remove duplicates', () => {
+      expect(unique([1, 2, 2, 3, 3, 3])).toEqual([1, 2, 3]);
+    });
+  });
+});
+
+describe('Validation utilities', () => {
+  describe('isEmail', () => {
+    it('should validate emails', () => {
+      expect(isEmail('test@example.com')).toBe(true);
+      expect(isEmail('invalid')).toBe(false);
+    });
+  });
+
+  describe('isUrl', () => {
+    it('should validate URLs', () => {
+      expect(isUrl('https://example.com')).toBe(true);
+      expect(isUrl('not-a-url')).toBe(false);
+    });
+  });
+});
+
+describe('Number utilities', () => {
+  describe('clamp', () => {
+    it('should clamp values', () => {
+      expect(clamp(5, 0, 10)).toBe(5);
+      expect(clamp(-5, 0, 10)).toBe(0);
+      expect(clamp(15, 0, 10)).toBe(10);
+    });
+  });
+});
+
+describe('Date utilities', () => {
+  describe('daysBetween', () => {
+    it('should calculate days between dates', () => {
+      const date1 = new Date('2024-01-01');
+      const date2 = new Date('2024-01-10');
+      expect(daysBetween(date1, date2)).toBe(9);
+    });
+  });
+});

package/templates/default/packages/utils/src/index.ts

@@ -0,0 +1,154 @@
+// String utilities
+export function capitalize(str: string): string {
+  if (!str) return '';
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+export function slugify(str: string): string {
+  return str
+    .toLowerCase()
+    .trim()
+    .replace(/[^\w\s-]/g, '')
+    .replace(/[\s_-]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+}
+
+export function truncate(str: string, length: number, suffix = '...'): string {
+  if (str.length <= length) return str;
+  return str.slice(0, length - suffix.length) + suffix;
+}
+
+// Object utilities
+export function pick<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K> {
+  const result = {} as Pick<T, K>;
+  keys.forEach(key => {
+    if (key in obj) {
+      result[key] = obj[key];
+    }
+  });
+  return result;
+}
+
+export function omit<T extends object, K extends keyof T>(obj: T, keys: K[]): Omit<T, K> {
+  const result = { ...obj };
+  keys.forEach(key => {
+    delete result[key];
+  });
+  return result as Omit<T, K>;
+}
+
+export function isEmpty(value: unknown): boolean {
+  if (value == null) return true;
+  if (typeof value === 'string' || Array.isArray(value)) return value.length === 0;
+  if (typeof value === 'object') return Object.keys(value).length === 0;
+  return false;
+}
+
+// Array utilities
+export function chunk<T>(array: T[], size: number): T[][] {
+  const chunks: T[][] = [];
+  for (let i = 0; i < array.length; i += size) {
+    chunks.push(array.slice(i, i + size));
+  }
+  return chunks;
+}
+
+export function unique<T>(array: T[]): T[] {
+  return [...new Set(array)];
+}
+
+export function groupBy<T, K extends string | number | symbol>(
+  array: T[],
+  keyFn: (item: T) => K
+): Record<K, T[]> {
+  return array.reduce(
+    (acc, item) => {
+      const key = keyFn(item);
+      if (!acc[key]) {
+        acc[key] = [];
+      }
+      acc[key].push(item);
+      return acc;
+    },
+    {} as Record<K, T[]>
+  );
+}
+
+// Date utilities
+export function formatDate(date: Date, locale = 'en-US'): string {
+  return new Intl.DateTimeFormat(locale, {
+    year: 'numeric',
+    month: 'long',
+    day: 'numeric',
+  }).format(date);
+}
+
+export function isValidDate(date: unknown): date is Date {
+  return date instanceof Date && !isNaN(date.getTime());
+}
+
+export function daysBetween(date1: Date, date2: Date): number {
+  const oneDay = 24 * 60 * 60 * 1000;
+  return Math.round(Math.abs((date1.getTime() - date2.getTime()) / oneDay));
+}
+
+// Async utilities
+export function sleep(ms: number): Promise<void> {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+export async function retry<T>(
+  fn: () => Promise<T>,
+  options: { attempts?: number; delay?: number } = {}
+): Promise<T> {
+  const { attempts = 3, delay = 1000 } = options;
+  let lastError: Error | undefined;
+
+  for (let i = 0; i < attempts; i++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error instanceof Error ? error : new Error(String(error));
+      if (i < attempts - 1) {
+        await sleep(delay);
+      }
+    }
+  }
+
+  throw lastError;
+}
+
+// Validation utilities
+export function isEmail(email: string): boolean {
+  const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+  return emailRegex.test(email);
+}
+
+export function isUrl(url: string): boolean {
+  try {
+    new URL(url);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// Number utilities
+export function clamp(value: number, min: number, max: number): number {
+  return Math.min(Math.max(value, min), max);
+}
+
+export function randomInt(min: number, max: number): number {
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+
+export function formatNumber(num: number, locale = 'en-US'): string {
+  return new Intl.NumberFormat(locale).format(num);
+}
+
+export function formatCurrency(amount: number, currency = 'USD', locale = 'en-US'): string {
+  return new Intl.NumberFormat(locale, {
+    style: 'currency',
+    currency,
+  }).format(amount);
+}

package/templates/default/packages/utils/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../config/typescript/base.json",
+  "compilerOptions": {
+    "lib": ["ES2022", "DOM"],
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/default/packages/utils/tsup.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['cjs', 'esm'],
+  dts: true,
+  splitting: false,
+  sourcemap: true,
+  clean: true,
+});

package/templates/default/pnpm-workspace.yaml

@@ -0,0 +1,3 @@
+packages:
+  - 'apps/*'
+  - 'packages/*'

package/templates/default/scripts/deploy.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+
+set -e
+
+ENVIRONMENT=${1:-staging}
+
+echo "🚀 Deploying to $ENVIRONMENT..."
+
+# Build all packages
+echo "🔨 Building packages..."
+pnpm build
+
+# Build Docker images
+echo "🐳 Building Docker images..."
+docker-compose -f docker/docker-compose.prod.yml build
+
+# Push images (if deploying to production)
+if [ "$ENVIRONMENT" = "production" ]; then
+    echo "📤 Pushing images to registry..."
+    docker-compose -f docker/docker-compose.prod.yml push
+fi
+
+echo ""
+echo "✅ Deployment to $ENVIRONMENT complete!"
+echo ""

package/templates/default/scripts/generate-app.sh

@@ -0,0 +1,166 @@
+#!/bin/bash
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(dirname "$SCRIPT_DIR")"
+APPS_DIR="$ROOT_DIR/apps"
+DOCKER_DIR="$ROOT_DIR/docker"
+
+# Show usage
+if [ -z "$1" ]; then
+  echo -e "${BLUE}Usage:${NC} pnpm generate:app <app-name> [port]"
+  echo ""
+  echo -e "${BLUE}Exemples:${NC}"
+  echo "  pnpm generate:app web 3000"
+  echo "  pnpm generate:app api 4000"
+  exit 1
+fi
+
+APP_NAME=$1
+PORT=${2:-3000}
+APP_DIR="$APPS_DIR/$APP_NAME"
+
+# Check if app already exists
+if [ -d "$APP_DIR" ]; then
+  echo -e "${RED}Error:${NC} L'application '$APP_NAME' existe déjà dans apps/"
+  exit 1
+fi
+
+echo -e "${BLUE}Creating${NC} app: $APP_NAME (port: $PORT)"
+
+# Create app directory structure
+mkdir -p "$APP_DIR/src"
+mkdir -p "$APP_DIR/docker"
+
+# Create Dockerfile
+cat > "$APP_DIR/docker/Dockerfile" << EOF
+# ====== Base ======
+FROM node:20-alpine AS base
+RUN corepack enable && corepack prepare pnpm@9.0.0 --activate
+WORKDIR /app
+
+# ====== Dependencies ======
+FROM base AS deps
+COPY pnpm-lock.yaml pnpm-workspace.yaml package.json ./
+COPY apps/$APP_NAME/package.json ./apps/$APP_NAME/
+COPY packages/*/package.json ./packages/
+RUN pnpm install --frozen-lockfile
+
+# ====== Development ======
+FROM base AS development
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+WORKDIR /app/apps/$APP_NAME
+EXPOSE $PORT
+CMD ["pnpm", "dev"]
+
+# ====== Builder ======
+FROM base AS builder
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+RUN pnpm turbo build --filter=@repo/$APP_NAME
+
+# ====== Production ======
+FROM node:20-alpine AS production
+WORKDIR /app
+ENV NODE_ENV=production
+
+COPY --from=builder /app/apps/$APP_NAME/dist ./dist
+COPY --from=builder /app/apps/$APP_NAME/package.json ./
+
+RUN npm install --omit=dev
+
+EXPOSE $PORT
+CMD ["node", "dist/index.js"]
+EOF
+
+# Create docker-compose.yml for the app
+cat > "$APP_DIR/docker-compose.yml" << EOF
+services:
+  $APP_NAME:
+    build:
+      context: ../..
+      dockerfile: apps/$APP_NAME/docker/Dockerfile
+      target: development
+    ports:
+      - "$PORT:$PORT"
+    environment:
+      - NODE_ENV=development
+      - PORT=$PORT
+    volumes:
+      - ../../apps/$APP_NAME:/app/apps/$APP_NAME
+      - ../../packages:/app/packages
+      - /app/node_modules
+      - /app/apps/$APP_NAME/node_modules
+    command: pnpm dev
+EOF
+
+# Create docker-compose.prod.yml for the app
+cat > "$APP_DIR/docker-compose.prod.yml" << EOF
+services:
+  $APP_NAME:
+    build:
+      context: ../..
+      dockerfile: apps/$APP_NAME/docker/Dockerfile
+      target: production
+    ports:
+      - "$PORT:$PORT"
+    environment:
+      - NODE_ENV=production
+      - PORT=$PORT
+    restart: unless-stopped
+EOF
+
+# Update main docker-compose.yml
+update_main_compose() {
+  MAIN_COMPOSE="$DOCKER_DIR/docker-compose.yml"
+  INCLUDE_PATH="../apps/$APP_NAME/docker-compose.yml"
+
+  # Create main compose if it doesn't exist
+  if [ ! -f "$MAIN_COMPOSE" ]; then
+    cat > "$MAIN_COMPOSE" << MAINEOF
+# Main docker-compose - includes all apps
+# Each app has its own docker-compose.yml in apps/<app-name>/
+
+include:
+  - path: $INCLUDE_PATH
+MAINEOF
+    return
+  fi
+
+  # Check if app is already included
+  if grep -q "apps/$APP_NAME/docker-compose.yml" "$MAIN_COMPOSE" 2>/dev/null; then
+    return
+  fi
+
+  # If include is empty array [], replace it
+  if grep -q "include: \[\]" "$MAIN_COMPOSE"; then
+    sed -i '' "s|include: \[\]|include:\n  - path: $INCLUDE_PATH|" "$MAIN_COMPOSE"
+  else
+    # Append to existing include list
+    echo "  - path: $INCLUDE_PATH" >> "$MAIN_COMPOSE"
+  fi
+}
+
+update_main_compose
+
+echo -e "${GREEN}✓${NC} Created app: apps/$APP_NAME"
+echo ""
+echo -e "${YELLOW}Files created:${NC}"
+echo "  - apps/$APP_NAME/docker/Dockerfile"
+echo "  - apps/$APP_NAME/docker-compose.yml"
+echo "  - apps/$APP_NAME/docker-compose.prod.yml"
+echo ""
+echo -e "${YELLOW}Commands:${NC}"
+echo "  Dev (app only):  cd apps/$APP_NAME && docker compose up"
+echo "  Dev (all apps):  pnpm docker:dev"
+echo "  Prod (app only): cd apps/$APP_NAME && docker compose -f docker-compose.prod.yml up -d"

package/templates/default/scripts/publish-cli.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+
+# Publish create-nexu CLI to npm
+# This script generates the template, builds, and publishes
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(dirname "$SCRIPT_DIR")"
+CLI_DIR="$ROOT_DIR/create-nexu"
+
+echo "📦 Publishing create-nexu..."
+echo ""
+
+# Step 1: Generate template
+echo "1️⃣  Generating template..."
+"$SCRIPT_DIR/generate-template.sh"
+echo ""
+
+# Step 2: Build CLI
+echo "2️⃣  Building CLI..."
+cd "$CLI_DIR"
+pnpm build
+echo ""
+
+# Step 3: Run checks
+echo "3️⃣  Running checks..."
+pnpm typecheck
+pnpm lint
+echo "✅ All checks passed"
+echo ""
+
+# Step 4: Show package info
+echo "4️⃣  Package info:"
+cat package.json | grep -E '"name"|"version"'
+echo ""
+
+# Step 5: Confirm publish
+read -p "Publish to npm? (y/N) " -n 1 -r
+echo ""
+
+if [[ $REPLY =~ ^[Yy]$ ]]; then
+    echo "5️⃣  Publishing to npm..."
+    npm publish --access public
+    echo ""
+    echo "✅ Published successfully!"
+    echo ""
+    echo "Users can now run:"
+    echo "  npm create nexu my-app"
+    echo "  # or"
+    echo "  npx create-nexu my-app"
+else
+    echo "❌ Publish cancelled"
+fi

package/templates/default/scripts/setup.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+
+set -e
+
+echo "🚀 Setting up monorepo..."
+
+# Check if pnpm is installed
+if ! command -v pnpm &> /dev/null; then
+    echo "📦 Installing pnpm..."
+    npm install -g pnpm
+fi
+
+# Install dependencies
+echo "📦 Installing dependencies..."
+pnpm install
+
+# Setup husky
+echo "🐶 Setting up Husky..."
+pnpm prepare
+
+# Create environment files
+echo "🔐 Creating environment files..."
+
+if [ ! -f ".env" ]; then
+    cat > .env << EOF
+# Database
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/nexu
+DB_USER=postgres
+DB_PASSWORD=postgres
+DB_NAME=nexu
+
+# API
+API_URL=http://localhost:4000
+
+# App
+NODE_ENV=development
+EOF
+    echo "✅ Created .env file"
+fi
+
+if [ ! -f "apps/web/.env.local" ]; then
+    cat > apps/web/.env.local << EOF
+NEXT_PUBLIC_API_URL=http://localhost:4000
+EOF
+    echo "✅ Created apps/web/.env.local"
+fi
+
+if [ ! -f "apps/api/.env" ]; then
+    cat > apps/api/.env << EOF
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/nexu
+PORT=4000
+NODE_ENV=development
+EOF
+    echo "✅ Created apps/api/.env"
+fi
+
+# Build packages
+echo "🔨 Building packages..."
+pnpm build
+
+echo ""
+echo "✅ Setup complete!"
+echo ""
+echo "Available commands:"
+echo "  pnpm dev          - Start development servers"
+echo "  pnpm build        - Build all packages"
+echo "  pnpm lint         - Run linting"
+echo "  pnpm test         - Run tests"
+echo "  pnpm docker:dev   - Start with Docker (dev)"
+echo ""

package/templates/default/services/.env.example

@@ -0,0 +1,16 @@
+# Database
+POSTGRES_USER=nexu
+POSTGRES_PASSWORD=nexu
+POSTGRES_DB=nexu
+
+# Messaging
+RABBITMQ_USER=nexu
+RABBITMQ_PASSWORD=nexu
+
+# Monitoring
+GRAFANA_USER=admin
+GRAFANA_PASSWORD=admin
+
+# Storage
+MINIO_USER=nexu
+MINIO_PASSWORD=nexu1234