Files
wiki/convex/pages.ts
Wayne Sutton 997b9cad21 docs: update blog post and TASK.md with v1.9.0 scroll-to-top and v1.10.0 fork configuration
Updated:
- content/blog/raw-markdown-and-copy-improvements.md
  - Changed title from 'v1.7 and v1.8' to 'v1.7 to v1.10'
  - Added Fork configuration section (v1.10.0) with 9-file table
  - Added Scroll-to-top section (v1.9.0) with configuration options
  - Updated summary to include all features from v1.7 to v1.10
  - Fixed image path to /images/v17.png
  - Updated sync command guidance for dev vs prod
- TASK.md
  - Added new To Do items for future features
  - Removed duplicate Future Enhancements section
- content/pages/docs.md
  - Added Mobile menu section
  - Added Copy Page dropdown table with all options
  - Added Markdown tables section
- content/pages/about.md
  - Updated Features list with new v1.8.0 features
- content/blog/setup-guide.md
  - Added image field to pages schema
  - Updated Project structure with new directories
  - Added /raw/{slug}.md to API endpoints
  - Added Mobile Navigation and Copy Page Dropdown sections
  - Added featured image documentation with ordering details

Documentation now covers all features from v1.7.0 through v1.10.0.
2025-12-20 11:05:38 -08:00

205 lines
5.2 KiB
TypeScript

import { query, mutation } from "./_generated/server";
import { v } from "convex/values";
// Get all published pages for navigation
export const getAllPages = query({
args: {},
returns: v.array(
v.object({
_id: v.id("pages"),
slug: v.string(),
title: v.string(),
published: v.boolean(),
order: v.optional(v.number()),
excerpt: v.optional(v.string()),
image: v.optional(v.string()),
featured: v.optional(v.boolean()),
featuredOrder: v.optional(v.number()),
}),
),
handler: async (ctx) => {
const pages = await ctx.db
.query("pages")
.withIndex("by_published", (q) => q.eq("published", true))
.collect();
// Sort by order (lower numbers first), then by title
const sortedPages = pages.sort((a, b) => {
const orderA = a.order ?? 999;
const orderB = b.order ?? 999;
if (orderA !== orderB) return orderA - orderB;
return a.title.localeCompare(b.title);
});
return sortedPages.map((page) => ({
_id: page._id,
slug: page.slug,
title: page.title,
published: page.published,
order: page.order,
excerpt: page.excerpt,
image: page.image,
featured: page.featured,
featuredOrder: page.featuredOrder,
}));
},
});
// Get featured pages for the homepage featured section
export const getFeaturedPages = query({
args: {},
returns: v.array(
v.object({
_id: v.id("pages"),
slug: v.string(),
title: v.string(),
excerpt: v.optional(v.string()),
image: v.optional(v.string()),
featuredOrder: v.optional(v.number()),
}),
),
handler: async (ctx) => {
const pages = await ctx.db
.query("pages")
.withIndex("by_featured", (q) => q.eq("featured", true))
.collect();
// Filter to only published pages and sort by featuredOrder
const featuredPages = pages
.filter((p) => p.published)
.sort((a, b) => {
const orderA = a.featuredOrder ?? 999;
const orderB = b.featuredOrder ?? 999;
return orderA - orderB;
});
return featuredPages.map((page) => ({
_id: page._id,
slug: page.slug,
title: page.title,
excerpt: page.excerpt,
image: page.image,
featuredOrder: page.featuredOrder,
}));
},
});
// Get a single page by slug
export const getPageBySlug = query({
args: {
slug: v.string(),
},
returns: v.union(
v.object({
_id: v.id("pages"),
slug: v.string(),
title: v.string(),
content: v.string(),
published: v.boolean(),
order: v.optional(v.number()),
excerpt: v.optional(v.string()),
image: v.optional(v.string()),
featured: v.optional(v.boolean()),
featuredOrder: v.optional(v.number()),
}),
v.null(),
),
handler: async (ctx, args) => {
const page = await ctx.db
.query("pages")
.withIndex("by_slug", (q) => q.eq("slug", args.slug))
.first();
if (!page || !page.published) {
return null;
}
return {
_id: page._id,
slug: page.slug,
title: page.title,
content: page.content,
published: page.published,
order: page.order,
excerpt: page.excerpt,
image: page.image,
featured: page.featured,
featuredOrder: page.featuredOrder,
};
},
});
// Public mutation for syncing pages from markdown files
export const syncPagesPublic = mutation({
args: {
pages: v.array(
v.object({
slug: v.string(),
title: v.string(),
content: v.string(),
published: v.boolean(),
order: v.optional(v.number()),
excerpt: v.optional(v.string()),
image: v.optional(v.string()),
featured: v.optional(v.boolean()),
featuredOrder: v.optional(v.number()),
}),
),
},
returns: v.object({
created: v.number(),
updated: v.number(),
deleted: v.number(),
}),
handler: async (ctx, args) => {
let created = 0;
let updated = 0;
let deleted = 0;
const now = Date.now();
const incomingSlugs = new Set(args.pages.map((p) => p.slug));
// Get all existing pages
const existingPages = await ctx.db.query("pages").collect();
const existingBySlug = new Map(existingPages.map((p) => [p.slug, p]));
// Upsert incoming pages
for (const page of args.pages) {
const existing = existingBySlug.get(page.slug);
if (existing) {
// Update existing page
await ctx.db.patch(existing._id, {
title: page.title,
content: page.content,
published: page.published,
order: page.order,
excerpt: page.excerpt,
image: page.image,
featured: page.featured,
featuredOrder: page.featuredOrder,
lastSyncedAt: now,
});
updated++;
} else {
// Create new page
await ctx.db.insert("pages", {
...page,
lastSyncedAt: now,
});
created++;
}
}
// Delete pages that no longer exist in the repo
for (const existing of existingPages) {
if (!incomingSlugs.has(existing.slug)) {
await ctx.db.delete(existing._id);
deleted++;
}
}
return { created, updated, deleted };
},
});