@odvi/create-dtt-framework 0.1.3 → 0.1.6

package/template/src/server/api/routes/health/storage.ts

@@ -0,0 +1,177 @@
+import { Hono } from 'hono'
+import { supabaseAdmin } from '@/lib/supabase/admin'
+import { env } from '@/config/env'
+
+const BUCKET_NAME = 'health-check-bucket'
+const TEST_FILE_PATH = 'health-check/test-file.txt'
+
+export const storageHealthRoutes = new Hono()
+
+storageHealthRoutes.post('/upload', async (c) => {
+  const start = performance.now()
+
+  try {
+    // Ensure bucket exists
+    const { data: buckets } = await supabaseAdmin.storage.listBuckets()
+    const bucketExists = buckets?.some((b) => b.name === BUCKET_NAME)
+
+    if (!bucketExists) {
+      // Create bucket if it doesn't exist
+      const { error: createError } = await supabaseAdmin.storage.createBucket(
+        BUCKET_NAME,
+        {
+          public: false,
+        }
+      )
+      if (createError) throw createError
+    }
+
+    // Upload test file
+    const testContent = `Health check test file - ${new Date().toISOString()}`
+    const { data, error } = await supabaseAdmin.storage
+      .from(BUCKET_NAME)
+      .upload(TEST_FILE_PATH, new Blob([testContent], { type: 'text/plain' }), {
+        upsert: true,
+      })
+
+    if (error) throw error
+
+    return c.json({
+      status: 'healthy',
+      responseTimeMs: Math.round(performance.now() - start),
+      message: 'Successfully uploaded test file to storage',
+      data: {
+        path: data?.path,
+        bucket: BUCKET_NAME,
+      },
+    })
+  } catch (error) {
+    return c.json(
+      {
+        status: 'error',
+        responseTimeMs: Math.round(performance.now() - start),
+        error: error instanceof Error ? error.message : 'Failed to upload to storage',
+      },
+      500
+    )
+  }
+})
+
+storageHealthRoutes.get('/download', async (c) => {
+  const start = performance.now()
+
+  try {
+    // Check if file exists
+    const { data: fileData, error: checkError } = await supabaseAdmin.storage
+      .from(BUCKET_NAME)
+      .list('health-check', {
+        limit: 10,
+      })
+
+    if (checkError) throw checkError
+
+    const testFile = fileData?.find((f) => f.name === 'test-file.txt')
+
+    if (!testFile) {
+      return c.json({
+        status: 'healthy',
+        responseTimeMs: Math.round(performance.now() - start),
+        message: 'Storage connection successful, but no test file found',
+        data: { found: false },
+      })
+    }
+
+    // Get signed URL for download
+    const { data, error } = await supabaseAdmin.storage
+      .from(BUCKET_NAME)
+      .createSignedUrl(TEST_FILE_PATH, 60)
+
+    // Handle "Object not found" as a success state for health check
+    // since connectivity is working, but the file just isn't there
+    if (error && error.message.includes('Object not found')) {
+      return c.json({
+        status: 'healthy',
+        responseTimeMs: Math.round(performance.now() - start),
+        message: 'Storage connection successful, but no test file found to download',
+        data: {
+          found: false,
+          path: TEST_FILE_PATH,
+        },
+      })
+    }
+
+    if (error) throw error
+
+    return c.json({
+      status: 'healthy',
+      responseTimeMs: Math.round(performance.now() - start),
+      message: 'Successfully generated download URL for test file',
+      data: {
+        found: true,
+        signedUrl: data?.signedUrl,
+        path: TEST_FILE_PATH,
+      },
+    })
+  } catch (error) {
+    return c.json(
+      {
+        status: 'error',
+        responseTimeMs: Math.round(performance.now() - start),
+        error: error instanceof Error ? error.message : 'Failed to download from storage',
+      },
+      500
+    )
+  }
+})
+
+storageHealthRoutes.delete('/delete', async (c) => {
+  const start = performance.now()
+
+  try {
+    // Check if file exists first
+    const { data: fileData, error: checkError } = await supabaseAdmin.storage
+      .from(BUCKET_NAME)
+      .list('health-check', {
+        limit: 10,
+      })
+
+    if (checkError) throw checkError
+
+    const testFile = fileData?.find((f) => f.name === 'test-file.txt')
+
+    if (!testFile) {
+      return c.json({
+        status: 'healthy',
+        responseTimeMs: Math.round(performance.now() - start),
+        message: 'Storage connection successful, but no test file to delete',
+        data: { deleted: false },
+      })
+    }
+
+    // Delete test file
+    const { error } = await supabaseAdmin.storage
+      .from(BUCKET_NAME)
+      .remove([TEST_FILE_PATH])
+
+    if (error) throw error
+
+    return c.json({
+      status: 'healthy',
+      responseTimeMs: Math.round(performance.now() - start),
+      message: 'Successfully deleted test file from storage',
+      data: {
+        deleted: true,
+        path: TEST_FILE_PATH,
+      },
+    })
+  } catch (error) {
+    return c.json(
+      {
+        status: 'error',
+        responseTimeMs: Math.round(performance.now() - start),
+        error: error instanceof Error ? error.message : 'Failed to delete from storage',
+      },
+      500
+    )
+  }
+})

package/template/src/server/api/routes/users.ts

@@ -0,0 +1,79 @@
+import { Hono } from 'hono'
+import { supabaseAdmin } from '@/lib/supabase/admin'
+
+export const usersRoutes = new Hono()
+
+usersRoutes.get('/', async (c) => {
+  const start = performance.now()
+
+  try {
+    const { data: allUsers, error } = await supabaseAdmin
+      .from('users')
+      .select('id, email, first_name, last_name, image_url, clerk_org_id, created_at, updated_at')
+      .order('created_at', { ascending: false })
+      .limit(100)
+
+    if (error) throw error
+
+    return c.json({
+      status: 'healthy',
+      responseTimeMs: Math.round(performance.now() - start),
+      message: 'Successfully retrieved users',
+      data: {
+        users: allUsers,
+        count: allUsers.length,
+      },
+    })
+  } catch (error) {
+    return c.json(
+      {
+        status: 'error',
+        responseTimeMs: Math.round(performance.now() - start),
+        error: error instanceof Error ? error.message : 'Failed to retrieve users',
+      },
+      500
+    )
+  }
+})
+
+usersRoutes.get('/:id', async (c) => {
+  const start = performance.now()
+  const id = c.req.param('id')
+
+  try {
+    const { data: user, error } = await supabaseAdmin
+      .from('users')
+      .select('id, email, first_name, last_name, image_url, clerk_org_id, created_at, updated_at')
+      .eq('id', id)
+      .limit(1)
+
+    if (error) throw error
+
+    if (!user || user.length === 0) {
+      return c.json(
+        {
+          status: 'error',
+          responseTimeMs: Math.round(performance.now() - start),
+          error: 'User not found',
+        },
+        404
+      )
+    }
+
+    return c.json({
+      status: 'healthy',
+      responseTimeMs: Math.round(performance.now() - start),
+      message: 'Successfully retrieved user',
+      data: { user: user[0] },
+    })
+  } catch (error) {
+    return c.json(
+      {
+        status: 'error',
+        responseTimeMs: Math.round(performance.now() - start),
+        error: error instanceof Error ? error.message : 'Failed to retrieve user',
+      },
+      500
+    )
+  }
+})

package/template/src/server/db/index.ts

@@ -0,0 +1,17 @@
+import { drizzle } from 'drizzle-orm/postgres-js'
+import postgres from 'postgres'
+import { env } from '@/config/env'
+import * as schema from './schema'
+
+/**
+ * Cache the database connection in development. This avoids creating a new connection on every HMR
+ * update.
+ */
+const globalForDb = globalThis as unknown as {
+  conn: postgres.Sql | undefined
+}
+
+const conn = globalForDb.conn ?? postgres(env.DATABASE_URL, { prepare: false })
+if (env.NODE_ENV !== 'production') globalForDb.conn = conn
+
+export const db = drizzle(conn, { schema })

package/template/src/server/db/queries/users.ts

@@ -0,0 +1,8 @@
+import { db } from '../index'
+import { users } from '../schema/users'
+import { eq } from 'drizzle-orm'
+
+export async function getUserById(id: string) {
+  const user = await db.select().from(users).where(eq(users.id, id)).limit(1)
+  return user[0] ?? null
+}

package/template/src/server/db/schema/__tests__/health-checks.test.ts

@@ -0,0 +1,31 @@
+import { describe, it, expect } from 'vitest';
+import { healthCheckTests, type HealthCheckTest } from '../health-checks';
+
+describe('healthCheckTests schema', () => {
+  it('should have healthCheckTests table defined', () => {
+    expect(healthCheckTests).toBeDefined();
+  });
+
+  it('should export HealthCheckTest type', () => {
+    const healthCheckTest: HealthCheckTest = {
+      id: 'test-uuid',
+      testKey: 'test-key',
+      testValue: 'test-value',
+      createdAt: new Date(),
+    };
+    expect(healthCheckTest).toBeDefined();
+    expect(healthCheckTest.testKey).toBe('test-key');
+  });
+
+  it('should allow HealthCheckTest with null testValue', () => {
+    const healthCheckTest: HealthCheckTest = {
+      id: 'test-uuid',
+      testKey: 'test-key',
+      testValue: null,
+      createdAt: new Date(),
+    };
+    expect(healthCheckTest).toBeDefined();
+    expect(healthCheckTest.testKey).toBe('test-key');
+    expect(healthCheckTest.testValue).toBeNull();
+  });
+});

package/template/src/server/db/schema/__tests__/users.test.ts

@@ -0,0 +1,46 @@
+import { describe, it, expect } from 'vitest';
+import { users, type User, type NewUser } from '../users';
+
+describe('users schema', () => {
+  it('should have users table defined', () => {
+    expect(users).toBeDefined();
+  });
+
+  it('should export User type', () => {
+    const user: User = {
+      id: 'test-id',
+      email: 'test@example.com',
+      firstName: 'Test',
+      lastName: 'User',
+      imageUrl: 'https://example.com/image.jpg',
+      clerkOrgId: 'org-123',
+      createdAt: new Date(),
+      updatedAt: new Date(),
+    };
+    expect(user).toBeDefined();
+    expect(user.id).toBe('test-id');
+  });
+
+  it('should export NewUser type', () => {
+    const newUser: NewUser = {
+      id: 'test-id',
+      email: 'test@example.com',
+      firstName: 'Test',
+      lastName: 'User',
+      imageUrl: 'https://example.com/image.jpg',
+      clerkOrgId: 'org-123',
+    };
+    expect(newUser).toBeDefined();
+    expect(newUser.email).toBe('test@example.com');
+  });
+
+  it('should allow NewUser without optional fields', () => {
+    const newUser: NewUser = {
+      id: 'test-id',
+      email: 'test@example.com',
+    };
+    expect(newUser).toBeDefined();
+    expect(newUser.id).toBe('test-id');
+    expect(newUser.email).toBe('test@example.com');
+  });
+});

package/template/src/server/db/schema/health-checks.ts

@@ -0,0 +1,11 @@
+// Health checks table schema placeholder
+import { pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core'
+
+export const healthCheckTests = pgTable('health_check_tests', {
+  id: uuid('id').primaryKey().defaultRandom(),
+  testKey: text('test_key').notNull(),
+  testValue: text('test_value'),
+  createdAt: timestamp('created_at').defaultNow().notNull(),
+})
+
+export type HealthCheckTest = typeof healthCheckTests.$inferSelect

package/template/src/server/db/schema/index.ts

@@ -0,0 +1,2 @@
+export * from './users'
+export * from './health-checks'

package/template/src/server/db/schema/users.ts

@@ -0,0 +1,16 @@
+// Users table schema placeholder
+import { pgTable, text, timestamp, varchar } from 'drizzle-orm/pg-core'
+
+export const users = pgTable('users', {
+  id: text('id').primaryKey(),
+  email: varchar('email', { length: 255 }).notNull().unique(),
+  firstName: varchar('first_name', { length: 255 }),
+  lastName: varchar('last_name', { length: 255 }),
+  imageUrl: text('image_url'),
+  clerkOrgId: text('clerk_org_id'),
+  createdAt: timestamp('created_at').defaultNow().notNull(),
+  updatedAt: timestamp('updated_at').defaultNow().notNull(),
+})
+
+export type User = typeof users.$inferSelect
+export type NewUser = typeof users.$inferInsert

package/template/src/server/db/schema.ts

@@ -0,0 +1 @@
+export * from "./schema/index";

package/template/src/stores/__tests__/ui-store.test.ts

@@ -0,0 +1,87 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { useUIStore } from '../ui-store';
+
+describe('useUIStore', () => {
+  beforeEach(() => {
+    // Reset store state before each test
+    useUIStore.setState({ sidebarOpen: false });
+  });
+
+  it('should have initial state with sidebar closed', () => {
+    const state = useUIStore.getState();
+    expect(state.sidebarOpen).toBe(false);
+  });
+
+  it('should toggle sidebar from closed to open', () => {
+    const { toggleSidebar } = useUIStore.getState();
+    toggleSidebar();
+
+    const state = useUIStore.getState();
+    expect(state.sidebarOpen).toBe(true);
+  });
+
+  it('should toggle sidebar from open to closed', () => {
+    useUIStore.setState({ sidebarOpen: true });
+    const { toggleSidebar } = useUIStore.getState();
+    toggleSidebar();
+
+    const state = useUIStore.getState();
+    expect(state.sidebarOpen).toBe(false);
+  });
+
+  it('should toggle sidebar multiple times', () => {
+    const { toggleSidebar } = useUIStore.getState();
+
+    toggleSidebar();
+    expect(useUIStore.getState().sidebarOpen).toBe(true);
+
+    toggleSidebar();
+    expect(useUIStore.getState().sidebarOpen).toBe(false);
+
+    toggleSidebar();
+    expect(useUIStore.getState().sidebarOpen).toBe(true);
+
+    toggleSidebar();
+    expect(useUIStore.getState().sidebarOpen).toBe(false);
+  });
+
+  it('should provide toggleSidebar function', () => {
+    const state = useUIStore.getState();
+    expect(state.toggleSidebar).toBeDefined();
+    expect(typeof state.toggleSidebar).toBe('function');
+  });
+
+  it('should maintain state consistency across multiple store accesses', () => {
+    const state1 = useUIStore.getState();
+    const state2 = useUIStore.getState();
+
+    expect(state1.sidebarOpen).toBe(state2.sidebarOpen);
+    expect(state1.toggleSidebar).toBe(state2.toggleSidebar);
+  });
+
+  it('should allow direct state setting', () => {
+    useUIStore.setState({ sidebarOpen: true });
+
+    const state = useUIStore.getState();
+    expect(state.sidebarOpen).toBe(true);
+  });
+
+  it('should handle rapid state changes', () => {
+    const { toggleSidebar } = useUIStore.getState();
+
+    for (let i = 0; i < 10; i++) {
+      toggleSidebar();
+    }
+
+    const state = useUIStore.getState();
+    expect(state.sidebarOpen).toBe(false); // 10 toggles from false = false
+  });
+
+  it('should reset to initial state when explicitly set', () => {
+    useUIStore.setState({ sidebarOpen: true });
+    expect(useUIStore.getState().sidebarOpen).toBe(true);
+
+    useUIStore.setState({ sidebarOpen: false });
+    expect(useUIStore.getState().sidebarOpen).toBe(false);
+  });
+});

package/template/src/stores/ui-store.ts

@@ -0,0 +1,14 @@
+// UI store placeholder
+'use client'
+
+import { create } from 'zustand'
+
+interface UIState {
+  sidebarOpen: boolean
+  toggleSidebar: () => void
+}
+
+export const useUIStore = create<UIState>((set) => ({
+  sidebarOpen: false,
+  toggleSidebar: () => set((state) => ({ sidebarOpen: !state.sidebarOpen })),
+}))

package/template/src/styles/globals.css

@@ -0,0 +1,129 @@
+@import "tailwindcss";
+@plugin "@tailwindcss/typography";
+@import "tw-animate-css";
+
+@custom-variant dark (&:is(.dark *));
+
+@theme {
+  --font-sans: var(--font-geist-sans), ui-sans-serif, system-ui, sans-serif,
+    "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";
+}
+
+@theme inline {
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+  --radius-2xl: calc(var(--radius) + 8px);
+  --radius-3xl: calc(var(--radius) + 12px);
+  --radius-4xl: calc(var(--radius) + 16px);
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --color-chart-1: var(--chart-1);
+  --color-chart-2: var(--chart-2);
+  --color-chart-3: var(--chart-3);
+  --color-chart-4: var(--chart-4);
+  --color-chart-5: var(--chart-5);
+  --color-sidebar: var(--sidebar);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-ring: var(--sidebar-ring);
+}
+
+:root {
+  --radius: 0.625rem;
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.145 0 0);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+  --primary: oklch(0.205 0 0);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+  --destructive: oklch(0.577 0.245 27.325);
+  --border: oklch(0.922 0 0);
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.708 0 0);
+  --chart-1: oklch(0.646 0.222 41.116);
+  --chart-2: oklch(0.6 0.118 184.704);
+  --chart-3: oklch(0.398 0.07 227.392);
+  --chart-4: oklch(0.828 0.189 84.429);
+  --chart-5: oklch(0.769 0.188 70.08);
+  --sidebar: oklch(0.985 0 0);
+  --sidebar-foreground: oklch(0.145 0 0);
+  --sidebar-primary: oklch(0.205 0 0);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.97 0 0);
+  --sidebar-accent-foreground: oklch(0.205 0 0);
+  --sidebar-border: oklch(0.922 0 0);
+  --sidebar-ring: oklch(0.708 0 0);
+}
+
+.dark {
+  --background: oklch(0.145 0 0);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.205 0 0);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.205 0 0);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.922 0 0);
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.704 0.191 22.216);
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 15%);
+  --ring: oklch(0.556 0 0);
+  --chart-1: oklch(0.488 0.243 264.376);
+  --chart-2: oklch(0.696 0.17 162.48);
+  --chart-3: oklch(0.769 0.188 70.08);
+  --chart-4: oklch(0.627 0.265 303.9);
+  --chart-5: oklch(0.645 0.246 16.439);
+  --sidebar: oklch(0.205 0 0);
+  --sidebar-foreground: oklch(0.985 0 0);
+  --sidebar-primary: oklch(0.488 0.243 264.376);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.269 0 0);
+  --sidebar-accent-foreground: oklch(0.985 0 0);
+  --sidebar-border: oklch(1 0 0 / 10%);
+  --sidebar-ring: oklch(0.556 0 0);
+}
+
+@layer base {
+  * {
+    @apply border-border outline-ring/50;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
+}

package/template/src/test/mocks/clerk.ts

@@ -0,0 +1,35 @@
+import { vi } from 'vitest';
+
+// Mock Clerk
+export const mockClerkClient = {
+  users: {
+    getUser: vi.fn(),
+    getUserList: vi.fn(),
+  },
+  organizations: {
+    getOrganizationMembershipList: vi.fn(),
+    getOrganizationList: vi.fn(),
+  },
+};
+
+vi.mock('@clerk/nextjs', () => ({
+  auth: vi.fn(),
+  currentUser: vi.fn(),
+  ClerkProvider: ({ children }: { children: React.ReactNode }) => children,
+  SignedIn: ({ children }: { children: React.ReactNode }) => children,
+  SignedOut: ({ children }: { children: React.ReactNode }) => null,
+  UserButton: vi.fn(() => null),
+  SignIn: vi.fn(() => null),
+  SignUp: vi.fn(() => null),
+  useUser: vi.fn(() => ({
+    user: null,
+    isLoaded: true,
+  })),
+  useAuth: vi.fn(() => ({
+    userId: null,
+    sessionId: null,
+    isLoaded: true,
+  })),
+}));
+
+export default mockClerkClient;

package/template/src/test/mocks/snowflake.ts

@@ -0,0 +1,28 @@
+import { vi } from 'vitest';
+
+// Mock Snowflake connection
+export const mockSnowflakeConnection = {
+  connect: vi.fn((callback) => {
+    callback(null, mockSnowflakeConnection);
+  }),
+  execute: vi.fn((options: any) => {
+    if (options.complete) {
+      options.complete(null, null, []);
+    }
+  }),
+  destroy: vi.fn((callback) => {
+    callback(null);
+  }),
+  isUp: vi.fn(() => true),
+  getId: vi.fn(() => 'test-connection-id'),
+};
+
+// Mock Snowflake SDK
+export const mockSnowflakeSDK = {
+  createConnection: vi.fn(() => mockSnowflakeConnection),
+  createConnector: vi.fn(),
+};
+
+vi.mock('snowflake-sdk', () => mockSnowflakeSDK);
+
+export default mockSnowflakeConnection;