create-atsdc-stack 1.1.0 → 1.2.0

package/app/src/db/schema.ts

@@ -1,72 +1,72 @@
-import { pgTable, text, timestamp, boolean, varchar } from 'drizzle-orm/pg-core';
-import { nanoid } from 'nanoid';
-
-/**
- * Posts table schema
- * Uses NanoID for primary keys for better URL-safe unique identifiers
- */
-export const posts = pgTable('posts', {
-    // Primary key using NanoID (21 characters, URL-safe)
-    id: varchar('id', { length: 21 })
-        .primaryKey()
-        .$defaultFn(() => nanoid()),
-
-    // Post content fields
-    title: varchar('title', { length: 255 }).notNull(),
-    slug: varchar('slug', { length: 255 }).notNull().unique(),
-    content: text('content').notNull(),
-    excerpt: text('excerpt'),
-
-    // Author information (Clerk user ID)
-    authorId: varchar('author_id', { length: 255 }).notNull(),
-    authorName: varchar('author_name', { length: 255 }),
-
-    // Post metadata
-    published: boolean('published').default(false).notNull(),
-    featured: boolean('featured').default(false).notNull(),
-
-    // SEO fields
-    metaTitle: varchar('meta_title', { length: 255 }),
-    metaDescription: text('meta_description'),
-
-    // Timestamps
-    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
-    updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull(),
-    publishedAt: timestamp('published_at', { withTimezone: true }),
-});
-
-/**
- * Comments table schema
- * Demonstrates relationship with posts using NanoID
- */
-export const comments = pgTable('comments', {
-    id: varchar('id', { length: 21 })
-        .primaryKey()
-        .$defaultFn(() => nanoid()),
-
-    // Foreign key to posts table
-    postId: varchar('post_id', { length: 21 })
-        .notNull()
-        .references(() => posts.id, { onDelete: 'cascade' }),
-
-    // Comment content
-    content: text('content').notNull(),
-
-    // Author information (Clerk user ID)
-    authorId: varchar('author_id', { length: 255 }).notNull(),
-    authorName: varchar('author_name', { length: 255 }),
-
-    // Moderation
-    approved: boolean('approved').default(false).notNull(),
-    flagged: boolean('flagged').default(false).notNull(),
-
-    // Timestamps
-    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
-    updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull(),
-});
-
-// Type exports for use in application
-export type Post = typeof posts.$inferSelect;
-export type NewPost = typeof posts.$inferInsert;
-export type Comment = typeof comments.$inferSelect;
-export type NewComment = typeof comments.$inferInsert;
+import { pgTable, text, timestamp, boolean, varchar } from 'drizzle-orm/pg-core';
+import { nanoid } from 'nanoid';
+
+/**
+ * Posts table schema
+ * Uses NanoID for primary keys for better URL-safe unique identifiers
+ */
+export const posts = pgTable('posts', {
+    // Primary key using NanoID (21 characters, URL-safe)
+    id: varchar('id', { length: 21 })
+        .primaryKey()
+        .$defaultFn(() => nanoid()),
+
+    // Post content fields
+    title: varchar('title', { length: 255 }).notNull(),
+    slug: varchar('slug', { length: 255 }).notNull().unique(),
+    content: text('content').notNull(),
+    excerpt: text('excerpt'),
+
+    // Author information (Clerk user ID)
+    authorId: varchar('author_id', { length: 255 }).notNull(),
+    authorName: varchar('author_name', { length: 255 }),
+
+    // Post metadata
+    published: boolean('published').default(false).notNull(),
+    featured: boolean('featured').default(false).notNull(),
+
+    // SEO fields
+    metaTitle: varchar('meta_title', { length: 255 }),
+    metaDescription: text('meta_description'),
+
+    // Timestamps
+    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull(),
+    publishedAt: timestamp('published_at', { withTimezone: true }),
+});
+
+/**
+ * Comments table schema
+ * Demonstrates relationship with posts using NanoID
+ */
+export const comments = pgTable('comments', {
+    id: varchar('id', { length: 21 })
+        .primaryKey()
+        .$defaultFn(() => nanoid()),
+
+    // Foreign key to posts table
+    postId: varchar('post_id', { length: 21 })
+        .notNull()
+        .references(() => posts.id, { onDelete: 'cascade' }),
+
+    // Comment content
+    content: text('content').notNull(),
+
+    // Author information (Clerk user ID)
+    authorId: varchar('author_id', { length: 255 }).notNull(),
+    authorName: varchar('author_name', { length: 255 }),
+
+    // Moderation
+    approved: boolean('approved').default(false).notNull(),
+    flagged: boolean('flagged').default(false).notNull(),
+
+    // Timestamps
+    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull(),
+});
+
+// Type exports for use in application
+export type Post = typeof posts.$inferSelect;
+export type NewPost = typeof posts.$inferInsert;
+export type Comment = typeof comments.$inferSelect;
+export type NewComment = typeof comments.$inferInsert;

package/app/src/db/validations.ts

@@ -1,158 +1,158 @@
-import { z } from 'zod';
-
-/**
- * Zod validation schemas for database models
- * Provides runtime type safety and validation for user inputs
- */
-
-// Slug validation helper
-const slugSchema = z
-    .string()
-    .min(1, 'Slug is required')
-    .max(255, 'Slug must be 255 characters or less')
-    .regex(
-        /^[a-z0-9]+(?:-[a-z0-9]+)*$/,
-        'Slug must be lowercase alphanumeric with hyphens only'
-    );
-
-/**
- * Post validation schemas
- */
-
-// Schema for creating a new post
-export const createPostSchema = z.object({
-    title: z
-        .string()
-        .min(1, 'Title is required')
-        .max(255, 'Title must be 255 characters or less')
-        .trim(),
-
-    slug: slugSchema,
-
-    content: z
-        .string()
-        .min(1, 'Content is required')
-        .max(50000, 'Content must be 50,000 characters or less'),
-
-    excerpt: z
-        .string()
-        .max(500, 'Excerpt must be 500 characters or less')
-        .optional()
-        .nullable(),
-
-    authorId: z.string().min(1, 'Author ID is required'),
-
-    authorName: z
-        .string()
-        .max(255, 'Author name must be 255 characters or less')
-        .optional()
-        .nullable(),
-
-    published: z.boolean().default(false),
-
-    featured: z.boolean().default(false),
-
-    metaTitle: z
-        .string()
-        .max(255, 'Meta title must be 255 characters or less')
-        .optional()
-        .nullable(),
-
-    metaDescription: z
-        .string()
-        .max(500, 'Meta description must be 500 characters or less')
-        .optional()
-        .nullable(),
-});
-
-// Schema for updating an existing post
-export const updatePostSchema = createPostSchema.partial().extend({
-    id: z.string().length(21, 'Invalid post ID'),
-});
-
-// Schema for publishing/unpublishing a post
-export const publishPostSchema = z.object({
-    id: z.string().length(21, 'Invalid post ID'),
-    published: z.boolean(),
-});
-
-// Schema for post query parameters
-export const postQuerySchema = z.object({
-    page: z.coerce.number().int().positive().default(1),
-    limit: z.coerce.number().int().positive().max(100).default(10),
-    published: z
-        .string()
-        .transform((val) => val === 'true')
-        .optional(),
-    featured: z
-        .string()
-        .transform((val) => val === 'true')
-        .optional(),
-    authorId: z.string().optional(),
-    search: z.string().optional(),
-});
-
-/**
- * Comment validation schemas
- */
-
-// Schema for creating a new comment
-export const createCommentSchema = z.object({
-    postId: z.string().length(21, 'Invalid post ID'),
-
-    content: z
-        .string()
-        .min(1, 'Comment content is required')
-        .max(2000, 'Comment must be 2,000 characters or less')
-        .trim(),
-
-    authorId: z.string().min(1, 'Author ID is required'),
-
-    authorName: z
-        .string()
-        .max(255, 'Author name must be 255 characters or less')
-        .optional()
-        .nullable(),
-});
-
-// Schema for updating a comment
-export const updateCommentSchema = z.object({
-    id: z.string().length(21, 'Invalid comment ID'),
-    content: z
-        .string()
-        .min(1, 'Comment content is required')
-        .max(2000, 'Comment must be 2,000 characters or less')
-        .trim(),
-});
-
-// Schema for moderating a comment
-export const moderateCommentSchema = z.object({
-    id: z.string().length(21, 'Invalid comment ID'),
-    approved: z.boolean().optional(),
-    flagged: z.boolean().optional(),
-});
-
-// Schema for comment query parameters
-export const commentQuerySchema = z.object({
-    postId: z.string().length(21, 'Invalid post ID').optional(),
-    page: z.coerce.number().int().positive().default(1),
-    limit: z.coerce.number().int().positive().max(100).default(20),
-    approved: z
-        .string()
-        .transform((val) => val === 'true')
-        .optional(),
-    authorId: z.string().optional(),
-});
-
-/**
- * Type exports for use in application
- */
-export type CreatePostInput = z.infer<typeof createPostSchema>;
-export type UpdatePostInput = z.infer<typeof updatePostSchema>;
-export type PublishPostInput = z.infer<typeof publishPostSchema>;
-export type PostQueryInput = z.infer<typeof postQuerySchema>;
-
-export type CreateCommentInput = z.infer<typeof createCommentSchema>;
-export type UpdateCommentInput = z.infer<typeof updateCommentSchema>;
-export type ModerateCommentInput = z.infer<typeof moderateCommentSchema>;
-export type CommentQueryInput = z.infer<typeof commentQuerySchema>;
+import { z } from 'zod';
+
+/**
+ * Zod validation schemas for database models
+ * Provides runtime type safety and validation for user inputs
+ */
+
+// Slug validation helper
+const slugSchema = z
+    .string()
+    .min(1, 'Slug is required')
+    .max(255, 'Slug must be 255 characters or less')
+    .regex(
+        /^[a-z0-9]+(?:-[a-z0-9]+)*$/,
+        'Slug must be lowercase alphanumeric with hyphens only'
+    );
+
+/**
+ * Post validation schemas
+ */
+
+// Schema for creating a new post
+export const createPostSchema = z.object({
+    title: z
+        .string()
+        .min(1, 'Title is required')
+        .max(255, 'Title must be 255 characters or less')
+        .trim(),
+
+    slug: slugSchema,
+
+    content: z
+        .string()
+        .min(1, 'Content is required')
+        .max(50000, 'Content must be 50,000 characters or less'),
+
+    excerpt: z
+        .string()
+        .max(500, 'Excerpt must be 500 characters or less')
+        .optional()
+        .nullable(),
+
+    authorId: z.string().min(1, 'Author ID is required'),
+
+    authorName: z
+        .string()
+        .max(255, 'Author name must be 255 characters or less')
+        .optional()
+        .nullable(),
+
+    published: z.boolean().default(false),
+
+    featured: z.boolean().default(false),
+
+    metaTitle: z
+        .string()
+        .max(255, 'Meta title must be 255 characters or less')
+        .optional()
+        .nullable(),
+
+    metaDescription: z
+        .string()
+        .max(500, 'Meta description must be 500 characters or less')
+        .optional()
+        .nullable(),
+});
+
+// Schema for updating an existing post
+export const updatePostSchema = createPostSchema.partial().extend({
+    id: z.string().length(21, 'Invalid post ID'),
+});
+
+// Schema for publishing/unpublishing a post
+export const publishPostSchema = z.object({
+    id: z.string().length(21, 'Invalid post ID'),
+    published: z.boolean(),
+});
+
+// Schema for post query parameters
+export const postQuerySchema = z.object({
+    page: z.coerce.number().int().positive().default(1),
+    limit: z.coerce.number().int().positive().max(100).default(10),
+    published: z
+        .string()
+        .transform((val) => val === 'true')
+        .optional(),
+    featured: z
+        .string()
+        .transform((val) => val === 'true')
+        .optional(),
+    authorId: z.string().optional(),
+    search: z.string().optional(),
+});
+
+/**
+ * Comment validation schemas
+ */
+
+// Schema for creating a new comment
+export const createCommentSchema = z.object({
+    postId: z.string().length(21, 'Invalid post ID'),
+
+    content: z
+        .string()
+        .min(1, 'Comment content is required')
+        .max(2000, 'Comment must be 2,000 characters or less')
+        .trim(),
+
+    authorId: z.string().min(1, 'Author ID is required'),
+
+    authorName: z
+        .string()
+        .max(255, 'Author name must be 255 characters or less')
+        .optional()
+        .nullable(),
+});
+
+// Schema for updating a comment
+export const updateCommentSchema = z.object({
+    id: z.string().length(21, 'Invalid comment ID'),
+    content: z
+        .string()
+        .min(1, 'Comment content is required')
+        .max(2000, 'Comment must be 2,000 characters or less')
+        .trim(),
+});
+
+// Schema for moderating a comment
+export const moderateCommentSchema = z.object({
+    id: z.string().length(21, 'Invalid comment ID'),
+    approved: z.boolean().optional(),
+    flagged: z.boolean().optional(),
+});
+
+// Schema for comment query parameters
+export const commentQuerySchema = z.object({
+    postId: z.string().length(21, 'Invalid post ID').optional(),
+    page: z.coerce.number().int().positive().default(1),
+    limit: z.coerce.number().int().positive().max(100).default(20),
+    approved: z
+        .string()
+        .transform((val) => val === 'true')
+        .optional(),
+    authorId: z.string().optional(),
+});
+
+/**
+ * Type exports for use in application
+ */
+export type CreatePostInput = z.infer<typeof createPostSchema>;
+export type UpdatePostInput = z.infer<typeof updatePostSchema>;
+export type PublishPostInput = z.infer<typeof publishPostSchema>;
+export type PostQueryInput = z.infer<typeof postQuerySchema>;
+
+export type CreateCommentInput = z.infer<typeof createCommentSchema>;
+export type UpdateCommentInput = z.infer<typeof updateCommentSchema>;
+export type ModerateCommentInput = z.infer<typeof moderateCommentSchema>;
+export type CommentQueryInput = z.infer<typeof commentQuerySchema>;

package/app/src/layouts/Layout.astro

@@ -1,63 +1,63 @@
----
-/**
- * Base Layout Component
- * Demonstrates proper SCSS architecture:
- * - No <style> tags in this file
- * - All styles imported from external SCSS files
- * - Global styles applied via import in the head
- */
-
-import { siteConfig } from '@/lib/config';
-
-interface Props {
-    pageTitle?: string | string[];
-    description?: string;
-}
-
-const {
-    pageTitle,
-    description = siteConfig.stackDescription,
-} = Astro.props;
-
-const pageArray = Array.isArray(pageTitle) ? pageTitle : [pageTitle];
-
-const firstElement = pageArray?.[0];
-const shouldSkipFirst =
-    firstElement === '' ||
-    firstElement === siteConfig.stackName ||
-    firstElement?.toLowerCase() === 'index' ||
-    firstElement?.toLowerCase() === 'home';
-
-const newPageTitle = (pageArray && pageArray.length > 0 && firstElement)
-    ? shouldSkipFirst
-        ? pageArray.filter((a, i) => i !== 0)
-        : pageArray
-    : null;
-
-const title = newPageTitle ? `${newPageTitle.join(' | ')} | ${siteConfig.stackName}` : siteConfig.stackName;
----
-
-<!doctype html>
-<html lang="en">
-    <head>
-        <meta charset="UTF-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-        <meta name="description" content={description} />
-        <meta name="generator" content={Astro.generator} />
-
-        <!-- Favicons -->
-        <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
-        <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
-
-        <!-- PWA manifest -->
-        <link rel="manifest" href="/manifest.webmanifest" />
-
-        <title>{title}</title>
-
-        <!-- Global styles imported from external SCSS file -->
-        <link rel="stylesheet" href="/src/styles/global.scss" />
-    </head>
-    <body>
-        <slot />
-    </body>
-</html>
+---
+/**
+ * Base Layout Component
+ * Demonstrates proper SCSS architecture:
+ * - No <style> tags in this file
+ * - All styles imported from external SCSS files
+ * - Global styles applied via import in the head
+ */
+
+import { siteConfig } from '@/lib/config';
+
+interface Props {
+    pageTitle?: string | string[];
+    description?: string;
+}
+
+const {
+    pageTitle,
+    description = siteConfig.stackDescription,
+} = Astro.props;
+
+const pageArray = Array.isArray(pageTitle) ? pageTitle : [pageTitle];
+
+const firstElement = pageArray?.[0];
+const shouldSkipFirst =
+    firstElement === '' ||
+    firstElement === siteConfig.stackName ||
+    firstElement?.toLowerCase() === 'index' ||
+    firstElement?.toLowerCase() === 'home';
+
+const newPageTitle = (pageArray && pageArray.length > 0 && firstElement)
+    ? shouldSkipFirst
+        ? pageArray.filter((a, i) => i !== 0)
+        : pageArray
+    : null;
+
+const title = newPageTitle ? `${newPageTitle.join(' | ')} | ${siteConfig.stackName}` : siteConfig.stackName;
+---
+
+<!doctype html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <meta name="description" content={description} />
+        <meta name="generator" content={Astro.generator} />
+
+        <!-- Favicons -->
+        <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+        <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
+
+        <!-- PWA manifest -->
+        <link rel="manifest" href="/manifest.webmanifest" />
+
+        <title>{title}</title>
+
+        <!-- Global styles imported from external SCSS file -->
+        <link rel="stylesheet" href="/src/styles/global.scss" />
+    </head>
+    <body>
+        <slot />
+    </body>
+</html>

package/app/src/lib/config.ts

@@ -1,36 +1,36 @@
-/**
- * Site Configuration
- * Central configuration for the application that will be rendered on screen
- */
-
-/**
- * The core stack identifier - change this in ONE place to update everywhere
- */
-const STACK_SHORT_NAME = 'ATSDC';
-
-export const siteConfig = {
-    /**
-     * Short name for the stack (used in PWA and compact displays)
-     */
-    stackShortName: STACK_SHORT_NAME,
-
-    /**
-     * The full name of the stack/framework (derived from stackShortName)
-     */
-    stackName: `${STACK_SHORT_NAME} Stack`,
-
-    /**
-     * Full description of the stack
-     */
-    stackDescription:
-        'Full-stack application built with Astro, TypeScript, Drizzle, Clerk, and SCSS',
-
-    /**
-     * Docs URL
-     */
-    docsUrl: 'https://github.com/adarshrkumar/The-ATSDC-Stack',
-    /**
-     * GitHub repository URL
-     */
-    githubUrl: 'https://github.com/adarshrkumar/The-ATSDC-Stack',
-} as const;
+/**
+ * Site Configuration
+ * Central configuration for the application that will be rendered on screen
+ */
+
+/**
+ * The core stack identifier - change this in ONE place to update everywhere
+ */
+const STACK_SHORT_NAME = 'ATSDC';
+
+export const siteConfig = {
+    /**
+     * Short name for the stack (used in PWA and compact displays)
+     */
+    stackShortName: STACK_SHORT_NAME,
+
+    /**
+     * The full name of the stack/framework (derived from stackShortName)
+     */
+    stackName: `${STACK_SHORT_NAME} Stack`,
+
+    /**
+     * Full description of the stack
+     */
+    stackDescription:
+        'Full-stack application built with Astro, TypeScript, Drizzle, Clerk, and SCSS',
+
+    /**
+     * Docs URL
+     */
+    docsUrl: 'https://github.com/adarshrkumar/The-ATSDC-Stack',
+    /**
+     * GitHub repository URL
+     */
+    githubUrl: 'https://github.com/adarshrkumar/The-ATSDC-Stack',
+} as const;