convex-cms 0.0.8 → 0.0.9-alpha.1

package/dist/cli/templates/cmsClient.js

@@ -1,55 +1,86 @@
 /**
- * CMS Client template
+ * CMS Client template - Blank starter
  *
  * Generated by: npx convex-cms init
  */
 export const CMS_CLIENT_TEMPLATE = `/**
  * CMS Setup
  *
- * Uses the unified createCms API for type-safe content management.
- * Define content types with defineContent() and export the admin API.
+ * This file defines content types and creates typed helpers for type-safe access.
  *
- * @example
+ * Architecture:
+ * - defineContentType() creates schema definitions for the admin API
+ * - createTypedHelpers() creates type-safe CRUD helpers for programmatic access
+ * - Both work together: definitions go to admin API, helpers provide typed access
+ *
+ * @example Type-safe queries in Convex functions
  * \`\`\`typescript
- * import { blogPost, admin } from "./cms";
+ * import { content } from "./cms";
  *
- * // Use in a mutation (typed helpers)
- * export const createPost = mutation({
- *   args: { title: v.string() },
- *   handler: async (ctx, args) => {
- *     return await blogPost.create(ctx, {
- *       data: { title: args.title },
- *     });
- *   },
- * });
+ * // Fully typed - data fields have correct types
+ * const items = await content.blog.list(ctx, { status: "published" });
+ * items.page[0].data.title;  // string
  * \`\`\`
  */
 
-import { createCms } from "convex-cms";
-import { v } from "convex/values";
+import { defineContentType, createTypedHelpers } from "convex-cms";
 import { components } from "./_generated/api";
-import cmsConfig from "./cms.config";
+import { v } from "convex/values";
 
-const cms = createCms(components.convexCms, cmsConfig);
+// =============================================================================
+// CONTENT TYPE DEFINITIONS
+// =============================================================================
+// Define your content types here. These are automatically registered and
+// available in the admin API. Code-defined types show as "Native Fields"
+// and cannot be edited/deleted through the admin UI.
 
-// Define your content types here
-export const blogPost = cms.defineContent({
+export const blogPost = defineContentType({
   name: "Blog Post",
-  fields: v.object({
+  validator: v.object({
     title: v.string(),
+    slug: v.string(),
     content: v.string(),
+    excerpt: v.optional(v.string()),
     publishedAt: v.optional(v.number()),
   }),
-  display: {
+  meta: {
+    displayName: "Blog Post",
     titleField: "title",
-    icon: "📝",
+    slugField: "slug",
+    fields: {
+      title: {
+        label: "Title",
+        maxLength: 200,
+        searchable: true,
+      },
+      slug: {
+        label: "URL Slug",
+        description: "URL-friendly identifier",
+      },
+      content: {
+        label: "Content",
+        renderAs: "richText",
+      },
+      excerpt: {
+        label: "Excerpt",
+        maxLength: 300,
+      },
+      publishedAt: {
+        label: "Publish Date",
+        renderAs: "datetime",
+      },
+    },
   },
 });
 
-// Export admin API for the admin UI
-export const admin = cms.admin;
+// =============================================================================
+// TYPED HELPERS
+// =============================================================================
+// Create type-safe CRUD helpers for programmatic access.
+// Use these in Convex functions for fully typed data access.
 
-// For advanced usage, you can also access CmsClient namespaces:
-// cms.contentTypes, cms.contentEntries, cms.versions, etc.
+export const content = createTypedHelpers(components.cms, {
+  blog: blogPost,
+});
 `;
 //# sourceMappingURL=cmsClient.js.map

package/dist/cli/templates/cmsClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"cmsClient.js","sourceRoot":"","sources":["../../../src/cli/templates/cmsClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDlC,CAAC"}
+{"version":3,"file":"cmsClient.js","sourceRoot":"","sources":["../../../src/cli/templates/cmsClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+ElC,CAAC"}

package/dist/cli/templates/content.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Content queries template
+ *
+ * Generated by: npx convex-cms init
+ *
+ * Shows how to use typed helpers from cms.ts in public queries.
+ */
+import type { SchemaTemplate } from "./schemas/index.js";
+export declare function getContentTemplate(template: SchemaTemplate): string;
+//# sourceMappingURL=content.d.ts.map

package/dist/cli/templates/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/content.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAYnE"}

package/dist/cli/templates/content.js

@@ -0,0 +1,257 @@
+/**
+ * Content queries template
+ *
+ * Generated by: npx convex-cms init
+ *
+ * Shows how to use typed helpers from cms.ts in public queries.
+ */
+export function getContentTemplate(template) {
+    switch (template) {
+        case "blog":
+            return CONTENT_BLOG_TEMPLATE;
+        case "docs":
+            return CONTENT_DOCS_TEMPLATE;
+        case "landing":
+            return CONTENT_LANDING_TEMPLATE;
+        case "blank":
+        default:
+            return CONTENT_BLANK_TEMPLATE;
+    }
+}
+const CONTENT_BLANK_TEMPLATE = `/**
+ * Public content queries for the frontend
+ *
+ * These queries use the typed helpers from cms.ts for type-safe data access.
+ * The content helpers provide full TypeScript inference for all fields.
+ */
+
+import { query } from "./_generated/server";
+import { content } from "./cms";
+
+export const getBlogPosts = query({
+  args: {},
+  handler: async (ctx) => {
+    // Using typed helper - result.page[].data is fully typed
+    const result = await content.blog.list(ctx, { status: "published" });
+
+    // Return entries with data flattened for easier frontend consumption
+    return result.page.map((entry) => ({
+      _id: entry._id,
+      ...entry.data,
+    }));
+  },
+});
+`;
+const CONTENT_BLOG_TEMPLATE = `/**
+ * Public content queries for the frontend - Blog Template
+ *
+ * These queries use the typed helpers from cms.ts for type-safe data access.
+ * The content helpers provide full TypeScript inference for all fields.
+ */
+
+import { query } from "./_generated/server";
+import { v } from "convex/values";
+import { content } from "./cms";
+
+export const getBlogPosts = query({
+  args: {},
+  handler: async (ctx) => {
+    const result = await content.blog.list(ctx, { status: "published" });
+
+    return result.page.map((entry) => ({
+      _id: entry._id,
+      ...entry.data,
+    }));
+  },
+});
+
+export const getBlogPostBySlug = query({
+  args: { slug: v.string() },
+  handler: async (ctx, { slug }) => {
+    const result = await content.blog.list(ctx, { status: "published" });
+
+    const post = result.page.find((entry) => entry.data.slug === slug);
+    if (!post) return null;
+
+    return {
+      _id: post._id,
+      ...post.data,
+    };
+  },
+});
+
+export const getAuthors = query({
+  args: {},
+  handler: async (ctx) => {
+    const result = await content.author.list(ctx, { status: "published" });
+
+    return result.page.map((entry) => ({
+      _id: entry._id,
+      ...entry.data,
+    }));
+  },
+});
+
+export const getCategories = query({
+  args: {},
+  handler: async (ctx) => {
+    const result = await content.category.list(ctx, { status: "published" });
+
+    return result.page.map((entry) => ({
+      _id: entry._id,
+      ...entry.data,
+    }));
+  },
+});
+`;
+const CONTENT_DOCS_TEMPLATE = `/**
+ * Public content queries for the frontend - Documentation Template
+ *
+ * These queries use the typed helpers from cms.ts for type-safe data access.
+ * The content helpers provide full TypeScript inference for all fields.
+ */
+
+import { query } from "./_generated/server";
+import { v } from "convex/values";
+import { content } from "./cms";
+
+export const getDocPages = query({
+  args: {},
+  handler: async (ctx) => {
+    const result = await content.docPage.list(ctx, { status: "published" });
+
+    return result.page.map((entry) => ({
+      _id: entry._id,
+      ...entry.data,
+    }));
+  },
+});
+
+export const getDocPageBySlug = query({
+  args: { slug: v.string() },
+  handler: async (ctx, { slug }) => {
+    const result = await content.docPage.list(ctx, { status: "published" });
+
+    const page = result.page.find((entry) => entry.data.slug === slug);
+    if (!page) return null;
+
+    return {
+      _id: page._id,
+      ...page.data,
+    };
+  },
+});
+
+export const getDocSections = query({
+  args: {},
+  handler: async (ctx) => {
+    const result = await content.docSection.list(ctx, { status: "published" });
+
+    // Sort by order
+    return result.page
+      .map((entry) => ({
+        _id: entry._id,
+        ...entry.data,
+      }))
+      .sort((a, b) => a.order - b.order);
+  },
+});
+
+export const getDocNavigation = query({
+  args: {},
+  handler: async (ctx) => {
+    const result = await content.docNavigation.list(ctx, { status: "published" });
+
+    // Find the default navigation
+    const defaultNav = result.page.find((entry) => entry.data.isDefault);
+    if (!defaultNav) {
+      // Return first nav if no default
+      const first = result.page[0];
+      if (!first) return null;
+      return { _id: first._id, ...first.data };
+    }
+
+    return {
+      _id: defaultNav._id,
+      ...defaultNav.data,
+    };
+  },
+});
+`;
+const CONTENT_LANDING_TEMPLATE = `/**
+ * Public content queries for the frontend - Landing Page Template
+ *
+ * These queries use the typed helpers from cms.ts for type-safe data access.
+ * The content helpers provide full TypeScript inference for all fields.
+ */
+
+import { query } from "./_generated/server";
+import { content } from "./cms";
+
+export const getHeroSections = query({
+  args: {},
+  handler: async (ctx) => {
+    const result = await content.hero.list(ctx, { status: "published" });
+
+    return result.page.map((entry) => ({
+      _id: entry._id,
+      ...entry.data,
+    }));
+  },
+});
+
+export const getFeatureBlocks = query({
+  args: {},
+  handler: async (ctx) => {
+    const result = await content.feature.list(ctx, { status: "published" });
+
+    // Sort by order
+    return result.page
+      .map((entry) => ({
+        _id: entry._id,
+        ...entry.data,
+      }))
+      .sort((a, b) => a.order - b.order);
+  },
+});
+
+export const getTestimonials = query({
+  args: {},
+  handler: async (ctx) => {
+    const result = await content.testimonial.list(ctx, { status: "published" });
+
+    return result.page.map((entry) => ({
+      _id: entry._id,
+      ...entry.data,
+    }));
+  },
+});
+
+export const getFeaturedTestimonials = query({
+  args: {},
+  handler: async (ctx) => {
+    const result = await content.testimonial.list(ctx, { status: "published" });
+
+    // Filter to featured only
+    return result.page
+      .filter((entry) => entry.data.featured)
+      .map((entry) => ({
+        _id: entry._id,
+        ...entry.data,
+      }));
+  },
+});
+
+export const getCtaSections = query({
+  args: {},
+  handler: async (ctx) => {
+    const result = await content.cta.list(ctx, { status: "published" });
+
+    return result.page.map((entry) => ({
+      _id: entry._id,
+      ...entry.data,
+    }));
+  },
+});
+`;
+//# sourceMappingURL=content.js.map

package/dist/cli/templates/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../src/cli/templates/content.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,UAAU,kBAAkB,CAAC,QAAwB;IACzD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,qBAAqB,CAAC;QAC/B,KAAK,MAAM;YACT,OAAO,qBAAqB,CAAC;QAC/B,KAAK,SAAS;YACZ,OAAO,wBAAwB,CAAC;QAClC,KAAK,OAAO,CAAC;QACb;YACE,OAAO,sBAAsB,CAAC;IAClC,CAAC;AACH,CAAC;AAED,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuB9B,CAAC;AAEF,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6D7B,CAAC;AAEF,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyE7B,CAAC;AAEF,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2EhC,CAAC"}

package/dist/cli/templates/index.d.ts

@@ -3,8 +3,9 @@
  *
  * All templates for the init command.
  */
-export { ADMIN_TEMPLATE } from "./admin.js";
+export { ADMIN_TEMPLATE, getAdminTemplate } from "./admin.js";
 export { CMS_CONFIG_TEMPLATE } from "./cmsConfig.js";
 export { CMS_CLIENT_TEMPLATE } from "./cmsClient.js";
-export { BLOG_SCHEMA_TEMPLATE, DOCS_SCHEMA_TEMPLATE, LANDING_SCHEMA_TEMPLATE, type SchemaTemplate, } from "./schemas/index.js";
+export { getContentTemplate } from "./content.js";
+export { CMS_BLOG_TEMPLATE, CMS_DOCS_TEMPLATE, CMS_LANDING_TEMPLATE, type SchemaTemplate, } from "./schemas/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/cli/templates/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/templates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/cli/templates/index.js

@@ -3,8 +3,9 @@
  *
  * All templates for the init command.
  */
-export { ADMIN_TEMPLATE } from "./admin.js";
+export { ADMIN_TEMPLATE, getAdminTemplate } from "./admin.js";
 export { CMS_CONFIG_TEMPLATE } from "./cmsConfig.js";
 export { CMS_CLIENT_TEMPLATE } from "./cmsClient.js";
-export { BLOG_SCHEMA_TEMPLATE, DOCS_SCHEMA_TEMPLATE, LANDING_SCHEMA_TEMPLATE, } from "./schemas/index.js";
+export { getContentTemplate } from "./content.js";
+export { CMS_BLOG_TEMPLATE, CMS_DOCS_TEMPLATE, CMS_LANDING_TEMPLATE, } from "./schemas/index.js";
 //# sourceMappingURL=index.js.map

package/dist/cli/templates/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/templates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,GAExB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/templates/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,GAErB,MAAM,oBAAoB,CAAC"}

package/dist/cli/templates/schemas/blog.d.ts

@@ -1,8 +1,9 @@
 /**
- * Blog schema template
+ * Blog cms.ts template
  *
- * Content types: blog_post, author, category
+ * Content types: Blog Post, Author, Category
+ * Includes typed helpers for programmatic access
  */
-export declare const BLOG_SCHEMA_TEMPLATE = "/**\n * Blog Content Types\n *\n * Defines the content structure for a blog with posts, authors, and categories.\n * These definitions are code-first and type-safe using Convex validators.\n *\n * Generated by: npx convex-cms init --template blog\n */\n\nimport { v } from \"convex/values\";\nimport { defineContentType } from \"convex-cms\";\n\nexport const blogPost = defineContentType({\n  name: \"blog_post\",\n  validator: v.object({\n    title: v.string(),\n    slug: v.string(),\n    excerpt: v.optional(v.string()),\n    content: v.string(),\n    featuredImage: v.optional(v.string()),\n    publishedAt: v.optional(v.number()),\n    author: v.optional(v.string()),\n    tags: v.optional(v.array(v.string())),\n  }),\n  meta: {\n    displayName: \"Blog Post\",\n    titleField: \"title\",\n    slugField: \"slug\",\n    fields: {\n      title: { label: \"Title\", maxLength: 200 },\n      slug: { label: \"URL Slug\", description: \"URL-friendly identifier\" },\n      excerpt: { label: \"Excerpt\", maxLength: 300 },\n      content: { label: \"Content\", renderAs: \"richText\" },\n      featuredImage: { label: \"Featured Image\", renderAs: \"media\" },\n      publishedAt: { label: \"Publish Date\", renderAs: \"datetime\" },\n      author: { label: \"Author\" },\n      tags: { label: \"Tags\", renderAs: \"tags\" },\n    },\n  },\n});\n\nexport const author = defineContentType({\n  name: \"author\",\n  validator: v.object({\n    name: v.string(),\n    slug: v.string(),\n    bio: v.optional(v.string()),\n    avatar: v.optional(v.string()),\n    email: v.optional(v.string()),\n    socialLinks: v.optional(\n      v.object({\n        twitter: v.optional(v.string()),\n        linkedin: v.optional(v.string()),\n        github: v.optional(v.string()),\n        website: v.optional(v.string()),\n      })\n    ),\n  }),\n  meta: {\n    displayName: \"Author\",\n    titleField: \"name\",\n    slugField: \"slug\",\n    fields: {\n      name: { label: \"Full Name\" },\n      slug: { label: \"URL Slug\" },\n      bio: { label: \"Biography\", renderAs: \"richText\" },\n      avatar: { label: \"Profile Photo\", renderAs: \"media\" },\n      email: { label: \"Email Address\" },\n      socialLinks: { label: \"Social Links\", renderAs: \"json\" },\n    },\n  },\n});\n\nexport const category = defineContentType({\n  name: \"category\",\n  validator: v.object({\n    name: v.string(),\n    slug: v.string(),\n    description: v.optional(v.string()),\n    color: v.optional(v.string()),\n    parentCategory: v.optional(v.string()),\n  }),\n  meta: {\n    displayName: \"Category\",\n    titleField: \"name\",\n    slugField: \"slug\",\n    fields: {\n      name: { label: \"Category Name\" },\n      slug: { label: \"URL Slug\" },\n      description: { label: \"Description\" },\n      color: { label: \"Color\", description: \"Hex color for UI display\" },\n      parentCategory: { label: \"Parent Category\" },\n    },\n  },\n});\n";
+export declare const CMS_BLOG_TEMPLATE = "/**\n * CMS Setup - Blog Template\n *\n * This file defines content types and creates typed helpers for type-safe access.\n *\n * Architecture:\n * - defineContentType() creates schema definitions for the admin API\n * - createTypedHelpers() creates type-safe CRUD helpers for programmatic access\n * - Both work together: definitions go to admin API, helpers provide typed access\n *\n * @example Type-safe queries in Convex functions\n * ```typescript\n * import { content } from \"./cms\";\n *\n * // Fully typed - data fields have correct types\n * const posts = await content.blog.list(ctx, { status: \"published\" });\n * posts.page[0].data.title;  // string\n * ```\n *\n * Generated by: npx convex-cms init --template blog\n */\n\nimport { defineContentType, createTypedHelpers } from \"convex-cms\";\nimport { components } from \"./_generated/api\";\nimport { v } from \"convex/values\";\n\n// =============================================================================\n// CONTENT TYPE DEFINITIONS\n// =============================================================================\n\nexport const blogPost = defineContentType({\n  name: \"Blog Post\",\n  validator: v.object({\n    title: v.string(),\n    slug: v.string(),\n    excerpt: v.optional(v.string()),\n    content: v.string(),\n    featuredImage: v.optional(v.string()),\n    publishedAt: v.optional(v.number()),\n    author: v.optional(v.string()),\n    tags: v.optional(v.array(v.string())),\n  }),\n  meta: {\n    displayName: \"Blog Post\",\n    titleField: \"title\",\n    slugField: \"slug\",\n    fields: {\n      title: { label: \"Title\", maxLength: 200, searchable: true },\n      slug: { label: \"URL Slug\", description: \"URL-friendly identifier\" },\n      excerpt: { label: \"Excerpt\", maxLength: 300 },\n      content: { label: \"Content\", renderAs: \"richText\" },\n      featuredImage: { label: \"Featured Image\", renderAs: \"media\" },\n      publishedAt: { label: \"Publish Date\", renderAs: \"datetime\" },\n      author: { label: \"Author\" },\n      tags: { label: \"Tags\", renderAs: \"tags\" },\n    },\n  },\n});\n\nexport const author = defineContentType({\n  name: \"Author\",\n  validator: v.object({\n    name: v.string(),\n    slug: v.string(),\n    bio: v.optional(v.string()),\n    avatar: v.optional(v.string()),\n    email: v.optional(v.string()),\n    socialLinks: v.optional(\n      v.object({\n        twitter: v.optional(v.string()),\n        linkedin: v.optional(v.string()),\n        github: v.optional(v.string()),\n        website: v.optional(v.string()),\n      })\n    ),\n  }),\n  meta: {\n    displayName: \"Author\",\n    titleField: \"name\",\n    slugField: \"slug\",\n    fields: {\n      name: { label: \"Full Name\", searchable: true },\n      slug: { label: \"URL Slug\" },\n      bio: { label: \"Biography\", renderAs: \"richText\" },\n      avatar: { label: \"Profile Photo\", renderAs: \"media\" },\n      email: { label: \"Email Address\" },\n      socialLinks: { label: \"Social Links\", renderAs: \"json\" },\n    },\n  },\n});\n\nexport const category = defineContentType({\n  name: \"Category\",\n  validator: v.object({\n    name: v.string(),\n    slug: v.string(),\n    description: v.optional(v.string()),\n    color: v.optional(v.string()),\n    parentCategory: v.optional(v.string()),\n  }),\n  meta: {\n    displayName: \"Category\",\n    titleField: \"name\",\n    slugField: \"slug\",\n    fields: {\n      name: { label: \"Category Name\", searchable: true },\n      slug: { label: \"URL Slug\" },\n      description: { label: \"Description\" },\n      color: { label: \"Color\", description: \"Hex color for UI display\" },\n      parentCategory: { label: \"Parent Category\" },\n    },\n  },\n});\n\n// =============================================================================\n// TYPED HELPERS\n// =============================================================================\n// Create type-safe CRUD helpers for programmatic access.\n// Use these in Convex functions for fully typed data access.\n\nexport const content = createTypedHelpers(components.cms, {\n  blog: blogPost,\n  author: author,\n  category: category,\n});\n";
 export declare const BLOG_SCHEMA_DESCRIPTION = "Blog (post, author, category)";
 //# sourceMappingURL=blog.d.ts.map

package/dist/cli/templates/schemas/blog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/schemas/blog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,oBAAoB,o4FA+FhC,CAAC;AAEF,eAAO,MAAM,uBAAuB,kCAAkC,CAAC"}
+{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/schemas/blog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,iBAAiB,0lIA6H7B,CAAC;AAEF,eAAO,MAAM,uBAAuB,kCAAkC,CAAC"}

package/dist/cli/templates/schemas/blog.js

@@ -1,22 +1,41 @@
 /**
- * Blog schema template
+ * Blog cms.ts template
  *
- * Content types: blog_post, author, category
+ * Content types: Blog Post, Author, Category
+ * Includes typed helpers for programmatic access
  */
-export const BLOG_SCHEMA_TEMPLATE = `/**
- * Blog Content Types
+export const CMS_BLOG_TEMPLATE = `/**
+ * CMS Setup - Blog Template
  *
- * Defines the content structure for a blog with posts, authors, and categories.
- * These definitions are code-first and type-safe using Convex validators.
+ * This file defines content types and creates typed helpers for type-safe access.
+ *
+ * Architecture:
+ * - defineContentType() creates schema definitions for the admin API
+ * - createTypedHelpers() creates type-safe CRUD helpers for programmatic access
+ * - Both work together: definitions go to admin API, helpers provide typed access
+ *
+ * @example Type-safe queries in Convex functions
+ * \`\`\`typescript
+ * import { content } from "./cms";
+ *
+ * // Fully typed - data fields have correct types
+ * const posts = await content.blog.list(ctx, { status: "published" });
+ * posts.page[0].data.title;  // string
+ * \`\`\`
  *
  * Generated by: npx convex-cms init --template blog
  */
 
+import { defineContentType, createTypedHelpers } from "convex-cms";
+import { components } from "./_generated/api";
 import { v } from "convex/values";
-import { defineContentType } from "convex-cms";
+
+// =============================================================================
+// CONTENT TYPE DEFINITIONS
+// =============================================================================
 
 export const blogPost = defineContentType({
-  name: "blog_post",
+  name: "Blog Post",
   validator: v.object({
     title: v.string(),
     slug: v.string(),
@@ -32,7 +51,7 @@ export const blogPost = defineContentType({
     titleField: "title",
     slugField: "slug",
     fields: {
-      title: { label: "Title", maxLength: 200 },
+      title: { label: "Title", maxLength: 200, searchable: true },
       slug: { label: "URL Slug", description: "URL-friendly identifier" },
       excerpt: { label: "Excerpt", maxLength: 300 },
       content: { label: "Content", renderAs: "richText" },
@@ -45,7 +64,7 @@ export const blogPost = defineContentType({
 });
 
 export const author = defineContentType({
-  name: "author",
+  name: "Author",
   validator: v.object({
     name: v.string(),
     slug: v.string(),
@@ -66,7 +85,7 @@ export const author = defineContentType({
     titleField: "name",
     slugField: "slug",
     fields: {
-      name: { label: "Full Name" },
+      name: { label: "Full Name", searchable: true },
       slug: { label: "URL Slug" },
       bio: { label: "Biography", renderAs: "richText" },
       avatar: { label: "Profile Photo", renderAs: "media" },
@@ -77,7 +96,7 @@ export const author = defineContentType({
 });
 
 export const category = defineContentType({
-  name: "category",
+  name: "Category",
   validator: v.object({
     name: v.string(),
     slug: v.string(),
@@ -90,7 +109,7 @@ export const category = defineContentType({
     titleField: "name",
     slugField: "slug",
     fields: {
-      name: { label: "Category Name" },
+      name: { label: "Category Name", searchable: true },
       slug: { label: "URL Slug" },
       description: { label: "Description" },
       color: { label: "Color", description: "Hex color for UI display" },
@@ -98,6 +117,18 @@ export const category = defineContentType({
     },
   },
 });
+
+// =============================================================================
+// TYPED HELPERS
+// =============================================================================
+// Create type-safe CRUD helpers for programmatic access.
+// Use these in Convex functions for fully typed data access.
+
+export const content = createTypedHelpers(components.cms, {
+  blog: blogPost,
+  author: author,
+  category: category,
+});
 `;
 export const BLOG_SCHEMA_DESCRIPTION = "Blog (post, author, category)";
 //# sourceMappingURL=blog.js.map

package/dist/cli/templates/schemas/blog.js.map

@@ -1 +1 @@
-{"version":3,"file":"blog.js","sourceRoot":"","sources":["../../../../src/cli/templates/schemas/blog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+FnC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,+BAA+B,CAAC"}
+{"version":3,"file":"blog.js","sourceRoot":"","sources":["../../../../src/cli/templates/schemas/blog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6HhC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,+BAA+B,CAAC"}

package/dist/cli/templates/schemas/docs.d.ts

@@ -1,8 +1,9 @@
 /**
- * Documentation schema template
+ * Documentation cms.ts template
  *
- * Content types: doc_page, doc_section, doc_navigation
+ * Content types: Documentation Page, Documentation Section, Navigation Tree
+ * Includes typed helpers for programmatic access
  */
-export declare const DOCS_SCHEMA_TEMPLATE = "/**\n * Documentation Content Types\n *\n * Defines the content structure for technical documentation with pages,\n * sections, and navigation. Supports hierarchical organization.\n *\n * Generated by: npx convex-cms init --template docs\n */\n\nimport { v } from \"convex/values\";\nimport { defineContentType } from \"convex-cms\";\n\nexport const docPage = defineContentType({\n  name: \"doc_page\",\n  validator: v.object({\n    title: v.string(),\n    slug: v.string(),\n    content: v.string(),\n    order: v.number(),\n    sectionId: v.optional(v.string()),\n    parentPageId: v.optional(v.string()),\n    description: v.optional(v.string()),\n    lastUpdatedBy: v.optional(v.string()),\n    tags: v.optional(v.array(v.string())),\n    relatedPages: v.optional(v.array(v.string())),\n  }),\n  meta: {\n    displayName: \"Documentation Page\",\n    titleField: \"title\",\n    slugField: \"slug\",\n    fields: {\n      title: { label: \"Page Title\", searchable: true },\n      slug: { label: \"URL Slug\" },\n      content: { label: \"Content\", renderAs: \"richText\", searchable: true },\n      order: { label: \"Display Order\" },\n      sectionId: { label: \"Section\" },\n      parentPageId: { label: \"Parent Page\" },\n      description: { label: \"Meta Description\", maxLength: 160 },\n      lastUpdatedBy: { label: \"Last Updated By\" },\n      tags: { label: \"Tags\", renderAs: \"tags\" },\n      relatedPages: { label: \"Related Pages\", renderAs: \"json\" },\n    },\n  },\n});\n\nexport const docSection = defineContentType({\n  name: \"doc_section\",\n  validator: v.object({\n    name: v.string(),\n    slug: v.string(),\n    order: v.number(),\n    description: v.optional(v.string()),\n    icon: v.optional(v.string()),\n    isCollapsible: v.optional(v.boolean()),\n    defaultExpanded: v.optional(v.boolean()),\n  }),\n  meta: {\n    displayName: \"Documentation Section\",\n    titleField: \"name\",\n    slugField: \"slug\",\n    fields: {\n      name: { label: \"Section Name\" },\n      slug: { label: \"URL Slug\" },\n      order: { label: \"Display Order\" },\n      description: { label: \"Description\" },\n      icon: { label: \"Icon\", description: \"Icon name or emoji\" },\n      isCollapsible: { label: \"Collapsible\" },\n      defaultExpanded: { label: \"Expanded by Default\" },\n    },\n  },\n});\n\nexport const docNavigation = defineContentType({\n  name: \"doc_navigation\",\n  validator: v.object({\n    name: v.string(),\n    items: v.array(\n      v.object({\n        type: v.union(\n          v.literal(\"page\"),\n          v.literal(\"section\"),\n          v.literal(\"link\"),\n          v.literal(\"divider\")\n        ),\n        label: v.optional(v.string()),\n        targetId: v.optional(v.string()),\n        url: v.optional(v.string()),\n        children: v.optional(v.array(v.string())),\n      })\n    ),\n    isDefault: v.optional(v.boolean()),\n  }),\n  meta: {\n    displayName: \"Navigation Tree\",\n    titleField: \"name\",\n    fields: {\n      name: { label: \"Navigation Name\" },\n      items: { label: \"Navigation Items\", renderAs: \"json\" },\n      isDefault: { label: \"Default Navigation\" },\n    },\n  },\n});\n";
+export declare const CMS_DOCS_TEMPLATE = "/**\n * CMS Setup - Documentation Template\n *\n * This file defines content types and creates typed helpers for type-safe access.\n *\n * Architecture:\n * - defineContentType() creates schema definitions for the admin API\n * - createTypedHelpers() creates type-safe CRUD helpers for programmatic access\n * - Both work together: definitions go to admin API, helpers provide typed access\n *\n * @example Type-safe queries in Convex functions\n * ```typescript\n * import { content } from \"./cms\";\n *\n * // Fully typed - data fields have correct types\n * const pages = await content.docPage.list(ctx, { status: \"published\" });\n * pages.page[0].data.title;  // string\n * ```\n *\n * Generated by: npx convex-cms init --template docs\n */\n\nimport { defineContentType, createTypedHelpers } from \"convex-cms\";\nimport { components } from \"./_generated/api\";\nimport { v } from \"convex/values\";\n\n// =============================================================================\n// CONTENT TYPE DEFINITIONS\n// =============================================================================\n\nexport const docPage = defineContentType({\n  name: \"Documentation Page\",\n  validator: v.object({\n    title: v.string(),\n    slug: v.string(),\n    content: v.string(),\n    order: v.number(),\n    sectionId: v.optional(v.string()),\n    parentPageId: v.optional(v.string()),\n    description: v.optional(v.string()),\n    lastUpdatedBy: v.optional(v.string()),\n    tags: v.optional(v.array(v.string())),\n    relatedPages: v.optional(v.array(v.string())),\n  }),\n  meta: {\n    displayName: \"Documentation Page\",\n    titleField: \"title\",\n    slugField: \"slug\",\n    fields: {\n      title: { label: \"Page Title\", searchable: true },\n      slug: { label: \"URL Slug\" },\n      content: { label: \"Content\", renderAs: \"richText\", searchable: true },\n      order: { label: \"Display Order\" },\n      sectionId: { label: \"Section\" },\n      parentPageId: { label: \"Parent Page\" },\n      description: { label: \"Meta Description\", maxLength: 160 },\n      lastUpdatedBy: { label: \"Last Updated By\" },\n      tags: { label: \"Tags\", renderAs: \"tags\" },\n      relatedPages: { label: \"Related Pages\", renderAs: \"json\" },\n    },\n  },\n});\n\nexport const docSection = defineContentType({\n  name: \"Documentation Section\",\n  validator: v.object({\n    name: v.string(),\n    slug: v.string(),\n    order: v.number(),\n    description: v.optional(v.string()),\n    icon: v.optional(v.string()),\n    isCollapsible: v.optional(v.boolean()),\n    defaultExpanded: v.optional(v.boolean()),\n  }),\n  meta: {\n    displayName: \"Documentation Section\",\n    titleField: \"name\",\n    slugField: \"slug\",\n    fields: {\n      name: { label: \"Section Name\", searchable: true },\n      slug: { label: \"URL Slug\" },\n      order: { label: \"Display Order\" },\n      description: { label: \"Description\" },\n      icon: { label: \"Icon\", description: \"Icon name or emoji\" },\n      isCollapsible: { label: \"Collapsible\" },\n      defaultExpanded: { label: \"Expanded by Default\" },\n    },\n  },\n});\n\nexport const docNavigation = defineContentType({\n  name: \"Navigation Tree\",\n  validator: v.object({\n    name: v.string(),\n    items: v.array(\n      v.object({\n        type: v.union(\n          v.literal(\"page\"),\n          v.literal(\"section\"),\n          v.literal(\"link\"),\n          v.literal(\"divider\")\n        ),\n        label: v.optional(v.string()),\n        targetId: v.optional(v.string()),\n        url: v.optional(v.string()),\n        children: v.optional(v.array(v.string())),\n      })\n    ),\n    isDefault: v.optional(v.boolean()),\n  }),\n  meta: {\n    displayName: \"Navigation Tree\",\n    titleField: \"name\",\n    fields: {\n      name: { label: \"Navigation Name\", searchable: true },\n      items: { label: \"Navigation Items\", renderAs: \"json\" },\n      isDefault: { label: \"Default Navigation\" },\n    },\n  },\n});\n\n// =============================================================================\n// TYPED HELPERS\n// =============================================================================\n// Create type-safe CRUD helpers for programmatic access.\n// Use these in Convex functions for fully typed data access.\n\nexport const content = createTypedHelpers(components.cms, {\n  docPage: docPage,\n  docSection: docSection,\n  docNavigation: docNavigation,\n});\n";
 export declare const DOCS_SCHEMA_DESCRIPTION = "Documentation (page, section, navigation)";
 //# sourceMappingURL=docs.d.ts.map

package/dist/cli/templates/schemas/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/schemas/docs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,oBAAoB,goGAsGhC,CAAC;AAEF,eAAO,MAAM,uBAAuB,8CAA8C,CAAC"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/schemas/docs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,iBAAiB,k4IAoI7B,CAAC;AAEF,eAAO,MAAM,uBAAuB,8CAA8C,CAAC"}