@objectifthunes/create-sandstone 0.1.0

package/dist/generators.d.ts

@@ -0,0 +1,7 @@
+import type { ProjectConfig } from './prompts.js';
+export declare function generatePackageJson(config: ProjectConfig): string;
+export declare function generateTsConfig(config: ProjectConfig): string;
+export declare function generateEnvExample(config: ProjectConfig): string;
+export declare function generateGitignore(): string;
+export declare function generateDockerCompose(): string;
+export declare function generateMainTs(config: ProjectConfig): string;

package/dist/generators.js

@@ -0,0 +1,328 @@
+export function generatePackageJson(config) {
+    const deps = {
+        '@objectifthunes/sandstone-sdk': '^0.5.0',
+        graphql: '^16.9.0',
+    };
+    const devDeps = {
+        typescript: '^5.7.0',
+        '@types/node': '^22.0.0',
+        vitest: '^3.0.0',
+    };
+    // Database
+    deps.pg = '^8.13.0';
+    // JWT
+    deps.jose = '^5.9.0';
+    // Logger
+    deps.pino = '^9.6.0';
+    // Framework
+    switch (config.framework) {
+        case 'express':
+            deps.express = '^5.0.0';
+            devDeps['@types/express'] = '^5.0.0';
+            break;
+        case 'fastify':
+            deps.fastify = '^5.2.0';
+            break;
+        case 'hono':
+            deps.hono = '^4.6.0';
+            break;
+        case 'nestjs':
+            deps['@nestjs/common'] = '^11.0.0';
+            deps['@nestjs/core'] = '^11.0.0';
+            deps['@nestjs/platform-express'] = '^11.0.0';
+            deps['@nestjs/graphql'] = '^13.0.0';
+            deps['@nestjs/apollo'] = '^13.0.0';
+            deps['@apollo/server'] = '^5.0.0';
+            deps['reflect-metadata'] = '^0.2.0';
+            deps.rxjs = '^7.8.0';
+            devDeps['@nestjs/cli'] = '^11.0.0';
+            devDeps['@types/express'] = '^5.0.0';
+            break;
+    }
+    // Email
+    if (config.email === 'resend')
+        deps.resend = '^4.1.0';
+    if (config.email === 'nodemailer') {
+        deps.nodemailer = '^6.9.0';
+        devDeps['@types/nodemailer'] = '^6.0.0';
+    }
+    // Password
+    if (config.authStrategies.includes('password'))
+        deps.argon2 = '^0.41.0';
+    // Payments
+    if (config.payments === 'stripe')
+        deps.stripe = '^17.5.0';
+    // Storage
+    if (config.storage === 'r2' || config.storage === 's3') {
+        deps['@aws-sdk/client-s3'] = '^3.700.0';
+        deps['@aws-sdk/s3-request-presigner'] = '^3.700.0';
+    }
+    // Cache
+    if (config.cache === 'upstash')
+        deps['@upstash/redis'] = '^1.34.0';
+    const scripts = {
+        build: 'tsc',
+        start: 'node dist/main.js',
+        test: 'vitest run',
+        'test:watch': 'vitest',
+    };
+    if (config.framework === 'nestjs') {
+        scripts.build = 'nest build';
+        scripts['start:dev'] = 'nest start --watch';
+    }
+    return JSON.stringify({
+        name: config.name,
+        version: '0.0.1',
+        private: true,
+        type: 'module',
+        scripts,
+        dependencies: deps,
+        devDependencies: devDeps,
+    }, null, 2);
+}
+export function generateTsConfig(config) {
+    const isNest = config.framework === 'nestjs';
+    return JSON.stringify({
+        compilerOptions: {
+            target: 'ES2022',
+            module: isNest ? 'NodeNext' : 'NodeNext',
+            moduleResolution: 'NodeNext',
+            lib: ['ES2022'],
+            outDir: 'dist',
+            rootDir: 'src',
+            declaration: true,
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            forceConsistentCasingInFileNames: true,
+            ...(isNest
+                ? { emitDecoratorMetadata: true, experimentalDecorators: true }
+                : {}),
+        },
+        include: ['src'],
+        exclude: ['node_modules', 'dist'],
+    }, null, 2);
+}
+export function generateEnvExample(config) {
+    const lines = ['# Database'];
+    lines.push('DATABASE_URL=postgresql://user:password@localhost:5432/mydb');
+    lines.push('');
+    lines.push('# JWT');
+    lines.push('JWT_SECRET=your-secret-at-least-32-characters-long');
+    lines.push('');
+    if (config.email === 'resend') {
+        lines.push('# Resend');
+        lines.push('RESEND_API_KEY=re_xxxxxxxxxxxx');
+        lines.push('EMAIL_FROM=noreply@yourdomain.com');
+        lines.push('');
+    }
+    else if (config.email === 'nodemailer') {
+        lines.push('# SMTP');
+        lines.push('SMTP_HOST=smtp.example.com');
+        lines.push('SMTP_PORT=587');
+        lines.push('SMTP_USER=user');
+        lines.push('SMTP_PASS=pass');
+        lines.push('EMAIL_FROM=noreply@yourdomain.com');
+        lines.push('');
+    }
+    if (config.authStrategies.includes('oauth')) {
+        for (const p of config.oauthProviders) {
+            lines.push(`# OAuth: ${p}`);
+            lines.push(`${p.toUpperCase()}_CLIENT_ID=`);
+            lines.push(`${p.toUpperCase()}_CLIENT_SECRET=`);
+            lines.push('');
+        }
+    }
+    if (config.payments === 'stripe') {
+        lines.push('# Stripe');
+        lines.push('STRIPE_SECRET_KEY=sk_test_xxx');
+        lines.push('STRIPE_WEBHOOK_SECRET=whsec_xxx');
+        lines.push('');
+    }
+    else if (config.payments === 'revenuecat') {
+        lines.push('# RevenueCat');
+        lines.push('REVENUECAT_API_KEY=');
+        lines.push('REVENUECAT_WEBHOOK_SECRET=');
+        lines.push('');
+    }
+    if (config.storage === 'r2') {
+        lines.push('# Cloudflare R2');
+        lines.push('R2_ACCOUNT_ID=');
+        lines.push('R2_ACCESS_KEY_ID=');
+        lines.push('R2_SECRET_ACCESS_KEY=');
+        lines.push('R2_BUCKET=');
+        lines.push('R2_PUBLIC_URL=');
+        lines.push('');
+    }
+    else if (config.storage === 's3') {
+        lines.push('# AWS S3');
+        lines.push('S3_BUCKET=');
+        lines.push('S3_REGION=');
+        lines.push('S3_ACCESS_KEY_ID=');
+        lines.push('S3_SECRET_ACCESS_KEY=');
+        lines.push('');
+    }
+    if (config.cache === 'upstash') {
+        lines.push('# Upstash Redis');
+        lines.push('UPSTASH_REDIS_URL=');
+        lines.push('UPSTASH_REDIS_TOKEN=');
+        lines.push('');
+    }
+    lines.push('# Server');
+    lines.push('PORT=3000');
+    return lines.join('\n');
+}
+export function generateGitignore() {
+    return `node_modules/
+dist/
+*.tsbuildinfo
+.env
+.env.local
+coverage/
+.DS_Store
+`;
+}
+export function generateDockerCompose() {
+    return `services:
+  postgres:
+    image: postgres:17-alpine
+    ports:
+      - "5488:5432"
+    environment:
+      POSTGRES_USER: dev
+      POSTGRES_PASSWORD: dev
+      POSTGRES_DB: dev
+    tmpfs:
+      - /var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U dev"]
+      interval: 2s
+      timeout: 5s
+      retries: 10
+
+  mailhog:
+    image: mailhog/mailhog:latest
+    ports:
+      - "1025:1025"
+      - "8025:8025"
+`;
+}
+export function generateMainTs(config) {
+    const pkg = '@objectifthunes/sandstone-sdk';
+    const dbImport = config.database === 'supabase'
+        ? `import { createSupabaseClient } from '${pkg}/supabase';`
+        : `import { createPgClient } from '${pkg}/pg';`;
+    const dbCreate = config.database === 'supabase'
+        ? `createSupabaseClient({ connectionString: process.env.DATABASE_URL! })`
+        : `createPgClient({ connectionString: process.env.DATABASE_URL! })`;
+    let emailImport = '';
+    let emailCreate = '';
+    if (config.email === 'resend') {
+        emailImport = `import { createResendTransport } from '${pkg}/resend';`;
+        emailCreate = `createResendTransport({ apiKey: process.env.RESEND_API_KEY! })`;
+    }
+    else if (config.email === 'nodemailer') {
+        emailImport = `import { createNodemailerTransport } from '${pkg}/nodemailer';`;
+        emailCreate = `createNodemailerTransport({ host: process.env.SMTP_HOST!, port: Number(process.env.SMTP_PORT ?? 587), auth: { user: process.env.SMTP_USER!, pass: process.env.SMTP_PASS! } })`;
+    }
+    let passwordImport = '';
+    let passwordConfig = '';
+    if (config.authStrategies.includes('password')) {
+        passwordImport = `import { createArgon2Hasher } from '${pkg}/argon2';`;
+        passwordConfig = `  password: { hasher: createArgon2Hasher() },`;
+    }
+    let oauthImports = '';
+    let oauthConfig = '';
+    if (config.authStrategies.includes('oauth') && config.oauthProviders.length > 0) {
+        const oauthLines = [];
+        const configLines = [];
+        for (const p of config.oauthProviders) {
+            const upper = p.charAt(0).toUpperCase() + p.slice(1);
+            oauthLines.push(`import { create${upper}OAuth } from '${pkg}/oauth-${p}';`);
+            configLines.push(`    ${p}: create${upper}OAuth({ clientId: process.env.${p.toUpperCase()}_CLIENT_ID!, clientSecret: process.env.${p.toUpperCase()}_CLIENT_SECRET! }),`);
+        }
+        oauthImports = oauthLines.join('\n');
+        oauthConfig = `  oauth: {\n${configLines.join('\n')}\n  },`;
+    }
+    let paymentImport = '';
+    let paymentConfig = '';
+    if (config.payments === 'stripe') {
+        paymentImport = `import { createStripeProvider } from '${pkg}/stripe';`;
+        paymentConfig = `  payments: { provider: createStripeProvider({ secretKey: process.env.STRIPE_SECRET_KEY!, webhookSecret: process.env.STRIPE_WEBHOOK_SECRET! }) },`;
+    }
+    else if (config.payments === 'revenuecat') {
+        paymentImport = `import { createRevenueCatProvider } from '${pkg}/revenuecat';`;
+        paymentConfig = `  payments: { provider: createRevenueCatProvider({ apiKey: process.env.REVENUECAT_API_KEY!, webhookSecret: process.env.REVENUECAT_WEBHOOK_SECRET! }) },`;
+    }
+    let storageImport = '';
+    let storageConfig = '';
+    if (config.storage === 'r2') {
+        storageImport = `import { createR2Storage } from '${pkg}/r2';`;
+        storageConfig = `  storage: createR2Storage({ accountId: process.env.R2_ACCOUNT_ID!, accessKeyId: process.env.R2_ACCESS_KEY_ID!, secretAccessKey: process.env.R2_SECRET_ACCESS_KEY!, bucket: process.env.R2_BUCKET! }),`;
+    }
+    else if (config.storage === 's3') {
+        storageImport = `import { createS3Storage } from '${pkg}/s3';`;
+        storageConfig = `  storage: createS3Storage({ bucket: process.env.S3_BUCKET!, region: process.env.S3_REGION!, accessKeyId: process.env.S3_ACCESS_KEY_ID!, secretAccessKey: process.env.S3_SECRET_ACCESS_KEY! }),`;
+    }
+    else if (config.storage === 'local') {
+        storageImport = `import { createLocalStorage } from '${pkg}/local-storage';`;
+        storageConfig = `  storage: createLocalStorage({ directory: './uploads' }),`;
+    }
+    let cacheImport = '';
+    let cacheConfig = '';
+    if (config.cache === 'upstash') {
+        cacheImport = `import { createUpstashCache } from '${pkg}/upstash';`;
+        cacheConfig = `  cache: createUpstashCache({ url: process.env.UPSTASH_REDIS_URL!, token: process.env.UPSTASH_REDIS_TOKEN! }),`;
+    }
+    const imports = [
+        `import { createAuth, createGraphQLHandler, createContextFactory, runMigrations } from '${pkg}';`,
+        `import { createJoseSigner } from '${pkg}/jose';`,
+        `import { createPinoLogger } from '${pkg}/pino';`,
+        dbImport,
+        emailImport,
+        passwordImport,
+        oauthImports,
+        paymentImport,
+        storageImport,
+        cacheImport,
+    ]
+        .filter(Boolean)
+        .join('\n');
+    const authConfig = [
+        `  otp: { length: 6, expiresIn: '10m', maxAttempts: 3, cooldown: '60s' },`,
+        passwordConfig,
+        oauthConfig,
+        `  session: { enabled: true },`,
+    ]
+        .filter(Boolean)
+        .join('\n');
+    return `${imports}
+
+async function main() {
+  const db = ${dbCreate};
+  const logger = createPinoLogger({ level: 'info', pretty: true });
+  const tokens = createJoseSigner({ secret: process.env.JWT_SECRET! });
+${config.email !== 'none' ? `  const emailTransport = ${emailCreate};` : ''}
+
+  await runMigrations(db, { includeBuiltIn: true });
+
+  const auth = createAuth({
+    db,
+${config.email !== 'none' ? '    email: emailTransport,' : ''}
+    tokens,
+    logger,
+${authConfig}
+  });
+
+  const createContext = createContextFactory({ db, tokens, logger });
+  // TODO: add your GraphQL schema here
+  // const graphqlHandler = createGraphQLHandler({ schema, createContext });
+
+  const port = process.env.PORT ?? 3000;
+  logger.info(\`Server ready to start on port \${port}\`);
+  logger.info('Add your HTTP framework and GraphQL schema to complete setup.');
+}
+
+main().catch(console.error);
+`;
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { runPrompts } from './prompts.js';
+import { generatePackageJson, generateTsConfig, generateEnvExample, generateGitignore, generateDockerCompose, generateMainTs, } from './generators.js';
+async function write(dir, name, content) {
+    const path = join(dir, name);
+    await writeFile(path, content, 'utf-8');
+    console.log(`  created ${name}`);
+}
+async function main() {
+    console.log('\n  @objectifthunes/create-sandstone\n');
+    const config = await runPrompts();
+    const dir = join(process.cwd(), config.name);
+    console.log(`\n  Scaffolding ${config.name}...\n`);
+    await mkdir(dir, { recursive: true });
+    await mkdir(join(dir, 'src'), { recursive: true });
+    await mkdir(join(dir, 'migrations'), { recursive: true });
+    await mkdir(join(dir, 'tests', 'unit'), { recursive: true });
+    await write(dir, 'package.json', generatePackageJson(config));
+    await write(dir, 'tsconfig.json', generateTsConfig(config));
+    await write(dir, '.env.example', generateEnvExample(config));
+    await write(dir, '.gitignore', generateGitignore());
+    await write(dir, 'src/main.ts', generateMainTs(config));
+    if (config.docker) {
+        await write(dir, 'docker-compose.yml', generateDockerCompose());
+    }
+    // Sample migration
+    await write(dir, 'migrations/001_sample.sql', `CREATE TABLE IF NOT EXISTS items (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  user_id UUID NOT NULL REFERENCES auth_users(id) ON DELETE CASCADE,
+  title TEXT NOT NULL,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+`);
+    // Sample test
+    await write(dir, 'tests/unit/sample.test.ts', `import { describe, it, expect } from 'vitest';
+import { createInMemoryDatabase } from '@objectifthunes/sandstone-sdk/testing';
+
+describe('sample', () => {
+  it('in-memory database works', async () => {
+    const db = createInMemoryDatabase();
+    await db.query('CREATE TABLE test (id TEXT)');
+    await db.query('INSERT INTO "test" ("id") VALUES ($1) RETURNING *', ['1']);
+    const result = await db.query('SELECT * FROM "test"');
+    expect(result.rows.length).toBe(1);
+  });
+});
+`);
+    // Vitest config
+    await write(dir, 'vitest.config.ts', `import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    include: ['tests/unit/**/*.test.ts'],
+  },
+});
+`);
+    console.log('\n  Done! Next steps:\n');
+    console.log(`  cd ${config.name}`);
+    console.log('  cp .env.example .env');
+    console.log('  pnpm install');
+    console.log('  pnpm test');
+    console.log('');
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/dist/prompts.d.ts

@@ -0,0 +1,13 @@
+export interface ProjectConfig {
+    name: string;
+    framework: 'express' | 'fastify' | 'hono' | 'nestjs' | 'none';
+    database: 'supabase' | 'neon' | 'pg';
+    authStrategies: ('otp' | 'password' | 'oauth')[];
+    oauthProviders: ('google' | 'github' | 'apple' | 'discord')[];
+    email: 'resend' | 'nodemailer' | 'none';
+    payments: 'stripe' | 'revenuecat' | 'none';
+    storage: 'r2' | 's3' | 'local' | 'none';
+    cache: 'upstash' | 'none';
+    docker: boolean;
+}
+export declare function runPrompts(): Promise<ProjectConfig>;

package/dist/prompts.js

@@ -0,0 +1,113 @@
+import prompts from 'prompts';
+export async function runPrompts() {
+    const response = await prompts([
+        {
+            type: 'text',
+            name: 'name',
+            message: 'Project name',
+            initial: 'my-backend',
+        },
+        {
+            type: 'select',
+            name: 'framework',
+            message: 'HTTP framework',
+            choices: [
+                { title: 'Express', value: 'express' },
+                { title: 'Fastify', value: 'fastify' },
+                { title: 'Hono', value: 'hono' },
+                { title: 'NestJS', value: 'nestjs' },
+                { title: 'None (raw Node.js)', value: 'none' },
+            ],
+        },
+        {
+            type: 'select',
+            name: 'database',
+            message: 'Database',
+            choices: [
+                { title: 'Supabase PostgreSQL', value: 'supabase' },
+                { title: 'Raw PostgreSQL (pg)', value: 'pg' },
+            ],
+        },
+        {
+            type: 'multiselect',
+            name: 'authStrategies',
+            message: 'Auth strategies',
+            choices: [
+                { title: 'Email OTP (6-digit code)', value: 'otp', selected: true },
+                { title: 'Password (argon2)', value: 'password' },
+                { title: 'OAuth', value: 'oauth' },
+            ],
+            min: 1,
+        },
+        {
+            type: (prev) => prev.includes('oauth') ? 'multiselect' : null,
+            name: 'oauthProviders',
+            message: 'OAuth providers',
+            choices: [
+                { title: 'Google', value: 'google', selected: true },
+                { title: 'GitHub', value: 'github' },
+                { title: 'Apple', value: 'apple' },
+                { title: 'Discord', value: 'discord' },
+            ],
+            min: 1,
+        },
+        {
+            type: 'select',
+            name: 'email',
+            message: 'Email provider',
+            choices: [
+                { title: 'Resend', value: 'resend' },
+                { title: 'Nodemailer (SMTP)', value: 'nodemailer' },
+                { title: 'None', value: 'none' },
+            ],
+        },
+        {
+            type: 'select',
+            name: 'payments',
+            message: 'Payments',
+            choices: [
+                { title: 'Stripe', value: 'stripe' },
+                { title: 'RevenueCat', value: 'revenuecat' },
+                { title: 'None', value: 'none' },
+            ],
+        },
+        {
+            type: 'select',
+            name: 'storage',
+            message: 'Storage',
+            choices: [
+                { title: 'Cloudflare R2', value: 'r2' },
+                { title: 'AWS S3', value: 's3' },
+                { title: 'Local filesystem', value: 'local' },
+                { title: 'None', value: 'none' },
+            ],
+        },
+        {
+            type: 'select',
+            name: 'cache',
+            message: 'Cache',
+            choices: [
+                { title: 'Upstash Redis', value: 'upstash' },
+                { title: 'None', value: 'none' },
+            ],
+        },
+        {
+            type: 'confirm',
+            name: 'docker',
+            message: 'Include docker-compose for local dev/testing?',
+            initial: true,
+        },
+    ], { onCancel: () => process.exit(0) });
+    return {
+        name: response.name,
+        framework: response.framework,
+        database: response.database,
+        authStrategies: response.authStrategies ?? ['otp'],
+        oauthProviders: response.oauthProviders ?? [],
+        email: response.email,
+        payments: response.payments,
+        storage: response.storage,
+        cache: response.cache,
+        docker: response.docker,
+    };
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@objectifthunes/create-sandstone",
+  "version": "0.1.0",
+  "description": "Scaffold a backend project using @objectifthunes/sandstone-sdk",
+  "type": "module",
+  "bin": {
+    "create-sandstone": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "prompts": "^2.4.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0",
+    "@types/prompts": "^2.4.0"
+  },
+  "scripts": {
+    "build": "tsc"
+  }
+}