@jant/core 0.3.24 → 0.3.26

package/dist/lib/timezones.js

@@ -0,0 +1,388 @@
+/**
+ * Timezone List
+ *
+ * Provides a curated list of timezones for the settings UI
+ * and a helper to map IANA timezone names to our list entries.
+ */ export const TIMEZONES = [
+    {
+        value: "International Date Line West",
+        label: "(UTC-12:00) International Date Line West",
+        offset: "-12:00",
+        iana: [
+            "Etc/GMT+12"
+        ]
+    },
+    {
+        value: "American Samoa",
+        label: "(UTC-11:00) American Samoa",
+        offset: "-11:00",
+        iana: [
+            "Pacific/Pago_Pago",
+            "Pacific/Midway",
+            "Etc/GMT+11"
+        ]
+    },
+    {
+        value: "Hawaii",
+        label: "(UTC-10:00) Hawaii",
+        offset: "-10:00",
+        iana: [
+            "Pacific/Honolulu",
+            "Etc/GMT+10"
+        ]
+    },
+    {
+        value: "Alaska",
+        label: "(UTC-09:00) Alaska",
+        offset: "-09:00",
+        iana: [
+            "America/Anchorage",
+            "America/Juneau",
+            "America/Nome"
+        ]
+    },
+    {
+        value: "Pacific Time (US & Canada)",
+        label: "(UTC-08:00) Pacific Time (US & Canada)",
+        offset: "-08:00",
+        iana: [
+            "America/Los_Angeles",
+            "America/Vancouver",
+            "America/Tijuana"
+        ]
+    },
+    {
+        value: "Mountain Time (US & Canada)",
+        label: "(UTC-07:00) Mountain Time (US & Canada)",
+        offset: "-07:00",
+        iana: [
+            "America/Denver",
+            "America/Edmonton",
+            "America/Phoenix",
+            "America/Boise"
+        ]
+    },
+    {
+        value: "Central Time (US & Canada)",
+        label: "(UTC-06:00) Central Time (US & Canada)",
+        offset: "-06:00",
+        iana: [
+            "America/Chicago",
+            "America/Winnipeg",
+            "America/Mexico_City",
+            "America/Guatemala"
+        ]
+    },
+    {
+        value: "Eastern Time (US & Canada)",
+        label: "(UTC-05:00) Eastern Time (US & Canada)",
+        offset: "-05:00",
+        iana: [
+            "America/New_York",
+            "America/Toronto",
+            "America/Detroit",
+            "America/Indiana/Indianapolis",
+            "America/Bogota",
+            "America/Lima"
+        ]
+    },
+    {
+        value: "Atlantic Time (Canada)",
+        label: "(UTC-04:00) Atlantic Time (Canada)",
+        offset: "-04:00",
+        iana: [
+            "America/Halifax",
+            "America/Caracas",
+            "America/Santiago",
+            "America/La_Paz"
+        ]
+    },
+    {
+        value: "Newfoundland",
+        label: "(UTC-03:30) Newfoundland",
+        offset: "-03:30",
+        iana: [
+            "America/St_Johns"
+        ]
+    },
+    {
+        value: "Buenos Aires",
+        label: "(UTC-03:00) Buenos Aires",
+        offset: "-03:00",
+        iana: [
+            "America/Argentina/Buenos_Aires",
+            "America/Sao_Paulo",
+            "America/Montevideo"
+        ]
+    },
+    {
+        value: "Mid-Atlantic",
+        label: "(UTC-02:00) Mid-Atlantic",
+        offset: "-02:00",
+        iana: [
+            "Atlantic/South_Georgia",
+            "Etc/GMT+2"
+        ]
+    },
+    {
+        value: "Azores",
+        label: "(UTC-01:00) Azores",
+        offset: "-01:00",
+        iana: [
+            "Atlantic/Azores",
+            "Atlantic/Cape_Verde"
+        ]
+    },
+    {
+        value: "UTC",
+        label: "(UTC+00:00) UTC",
+        offset: "+00:00",
+        iana: [
+            "Etc/UTC",
+            "UTC",
+            "Etc/GMT",
+            "Africa/Accra"
+        ]
+    },
+    {
+        value: "London",
+        label: "(UTC+00:00) London",
+        offset: "+00:00",
+        iana: [
+            "Europe/London",
+            "Europe/Dublin",
+            "Europe/Lisbon"
+        ]
+    },
+    {
+        value: "Central European Time",
+        label: "(UTC+01:00) Central European Time",
+        offset: "+01:00",
+        iana: [
+            "Europe/Paris",
+            "Europe/Berlin",
+            "Europe/Amsterdam",
+            "Europe/Rome",
+            "Europe/Madrid",
+            "Europe/Brussels",
+            "Europe/Vienna",
+            "Europe/Warsaw",
+            "Europe/Prague",
+            "Europe/Stockholm",
+            "Europe/Oslo",
+            "Europe/Copenhagen",
+            "Europe/Zurich",
+            "Africa/Lagos"
+        ]
+    },
+    {
+        value: "Eastern European Time",
+        label: "(UTC+02:00) Eastern European Time",
+        offset: "+02:00",
+        iana: [
+            "Europe/Helsinki",
+            "Europe/Athens",
+            "Europe/Bucharest",
+            "Europe/Istanbul",
+            "Africa/Cairo",
+            "Africa/Johannesburg",
+            "Asia/Jerusalem",
+            "Asia/Beirut"
+        ]
+    },
+    {
+        value: "Moscow",
+        label: "(UTC+03:00) Moscow",
+        offset: "+03:00",
+        iana: [
+            "Europe/Moscow",
+            "Europe/Minsk",
+            "Asia/Baghdad",
+            "Asia/Riyadh",
+            "Africa/Nairobi",
+            "Asia/Kuwait"
+        ]
+    },
+    {
+        value: "Tehran",
+        label: "(UTC+03:30) Tehran",
+        offset: "+03:30",
+        iana: [
+            "Asia/Tehran"
+        ]
+    },
+    {
+        value: "Dubai",
+        label: "(UTC+04:00) Dubai",
+        offset: "+04:00",
+        iana: [
+            "Asia/Dubai",
+            "Asia/Muscat",
+            "Asia/Baku",
+            "Asia/Tbilisi"
+        ]
+    },
+    {
+        value: "Kabul",
+        label: "(UTC+04:30) Kabul",
+        offset: "+04:30",
+        iana: [
+            "Asia/Kabul"
+        ]
+    },
+    {
+        value: "Karachi",
+        label: "(UTC+05:00) Karachi",
+        offset: "+05:00",
+        iana: [
+            "Asia/Karachi",
+            "Asia/Tashkent",
+            "Asia/Yekaterinburg"
+        ]
+    },
+    {
+        value: "Mumbai",
+        label: "(UTC+05:30) Mumbai",
+        offset: "+05:30",
+        iana: [
+            "Asia/Kolkata",
+            "Asia/Calcutta",
+            "Asia/Colombo"
+        ]
+    },
+    {
+        value: "Kathmandu",
+        label: "(UTC+05:45) Kathmandu",
+        offset: "+05:45",
+        iana: [
+            "Asia/Kathmandu"
+        ]
+    },
+    {
+        value: "Dhaka",
+        label: "(UTC+06:00) Dhaka",
+        offset: "+06:00",
+        iana: [
+            "Asia/Dhaka",
+            "Asia/Almaty",
+            "Asia/Omsk"
+        ]
+    },
+    {
+        value: "Yangon",
+        label: "(UTC+06:30) Yangon",
+        offset: "+06:30",
+        iana: [
+            "Asia/Yangon",
+            "Asia/Rangoon"
+        ]
+    },
+    {
+        value: "Bangkok",
+        label: "(UTC+07:00) Bangkok",
+        offset: "+07:00",
+        iana: [
+            "Asia/Bangkok",
+            "Asia/Jakarta",
+            "Asia/Ho_Chi_Minh",
+            "Asia/Krasnoyarsk"
+        ]
+    },
+    {
+        value: "Beijing",
+        label: "(UTC+08:00) Beijing",
+        offset: "+08:00",
+        iana: [
+            "Asia/Shanghai",
+            "Asia/Hong_Kong",
+            "Asia/Taipei",
+            "Asia/Singapore",
+            "Asia/Kuala_Lumpur",
+            "Asia/Makassar",
+            "Asia/Irkutsk",
+            "Australia/Perth"
+        ]
+    },
+    {
+        value: "Tokyo",
+        label: "(UTC+09:00) Tokyo",
+        offset: "+09:00",
+        iana: [
+            "Asia/Tokyo",
+            "Asia/Seoul",
+            "Asia/Yakutsk"
+        ]
+    },
+    {
+        value: "Adelaide",
+        label: "(UTC+09:30) Adelaide",
+        offset: "+09:30",
+        iana: [
+            "Australia/Adelaide",
+            "Australia/Darwin"
+        ]
+    },
+    {
+        value: "Sydney",
+        label: "(UTC+10:00) Sydney",
+        offset: "+10:00",
+        iana: [
+            "Australia/Sydney",
+            "Australia/Melbourne",
+            "Australia/Brisbane",
+            "Australia/Hobart",
+            "Pacific/Guam",
+            "Asia/Vladivostok"
+        ]
+    },
+    {
+        value: "Noumea",
+        label: "(UTC+11:00) Noumea",
+        offset: "+11:00",
+        iana: [
+            "Pacific/Noumea",
+            "Asia/Magadan",
+            "Pacific/Guadalcanal"
+        ]
+    },
+    {
+        value: "Auckland",
+        label: "(UTC+12:00) Auckland",
+        offset: "+12:00",
+        iana: [
+            "Pacific/Auckland",
+            "Pacific/Fiji",
+            "Asia/Kamchatka"
+        ]
+    },
+    {
+        value: "Nuku'alofa",
+        label: "(UTC+13:00) Nuku'alofa",
+        offset: "+13:00",
+        iana: [
+            "Pacific/Tongatapu",
+            "Pacific/Apia"
+        ]
+    }
+];
+/**
+ * Maps an IANA timezone name (e.g. "Asia/Shanghai") to our timezone list value
+ * (e.g. "Beijing"). Returns "UTC" if no match found.
+ *
+ * @param iana - IANA timezone identifier from Intl.DateTimeFormat
+ * @returns The matching timezone value from TIMEZONES
+ *
+ * @example
+ * ```ts
+ * mapIanaToTimezone("Asia/Shanghai"); // "Beijing"
+ * mapIanaToTimezone("America/New_York"); // "Eastern Time (US & Canada)"
+ * mapIanaToTimezone("Unknown/Zone"); // "UTC"
+ * ```
+ */ export function mapIanaToTimezone(iana) {
+    for (const tz of TIMEZONES){
+        if (tz.iana.includes(iana)) {
+            return tz.value;
+        }
+    }
+    return "UTC";
+}

package/dist/lib/view.js

@@ -30,7 +30,7 @@ import { getHtmlExcerpt } from "./excerpt.js";
  * @returns Render-ready MediaView with pre-computed URLs
  */ export function toMediaView(media, ctx) {
     const publicUrl = getPublicUrlForProvider(media.provider, ctx.r2PublicUrl, ctx.s3PublicUrl);
-    const url = getMediaUrl(media.id, media.storageKey, publicUrl);
+    const url = getMediaUrl(media.storageKey, publicUrl);
     const thumbnailUrl = getImageUrl(url, ctx.imageTransformUrl, {
         width: 400,
         quality: 80,
@@ -58,7 +58,7 @@ import { getHtmlExcerpt } from "./excerpt.js";
  * @param _ctx - Media context with URL configuration
  * @returns Render-ready PostView with pre-computed fields
  */ export function toPostView(post, _ctx) {
-    const permalink = post.slug ? `/${post.slug}` : `/p/${encode(post.id)}`;
+    const permalink = post.path ? `/${post.path}` : `/p/${encode(post.id)}`;
     // Pre-compute excerpt from raw body
     let excerpt;
     if (post.body) {
@@ -85,7 +85,7 @@ import { getHtmlExcerpt } from "./excerpt.js";
     return {
         id: post.id,
         permalink,
-        slug: post.slug ?? undefined,
+        path: post.path ?? undefined,
         title: post.title ?? undefined,
         bodyHtml: post.bodyHtml ?? undefined,
         excerpt,

package/dist/routes/api/collections.js

@@ -0,0 +1,124 @@
+/**
+ * Collections API Routes
+ */ import { Hono } from "hono";
+import { requireAuthApi } from "../../middleware/auth.js";
+import { z } from "zod";
+import { SORT_ORDERS } from "../../types.js";
+export const collectionsApiRoutes = new Hono();
+const SortOrderSchema = z.enum(SORT_ORDERS);
+const CreateCollectionSchema = z.object({
+    slug: z.string().min(1),
+    title: z.string().min(1),
+    description: z.string().optional(),
+    icon: z.string().optional(),
+    sortOrder: SortOrderSchema.optional(),
+    position: z.number().int().min(0).optional(),
+    showDivider: z.boolean().optional()
+});
+const UpdateCollectionSchema = z.object({
+    slug: z.string().min(1).optional(),
+    title: z.string().min(1).optional(),
+    description: z.string().nullable().optional(),
+    icon: z.string().nullable().optional(),
+    sortOrder: SortOrderSchema.optional(),
+    position: z.number().int().min(0).optional(),
+    showDivider: z.boolean().optional()
+});
+const ReorderSchema = z.object({
+    ids: z.array(z.number().int().positive())
+});
+// List collections (includes post counts)
+collectionsApiRoutes.get("/", async (c)=>{
+    const collections = await c.var.services.collections.list();
+    const postCounts = await c.var.services.collections.getPostCounts();
+    return c.json({
+        collections: collections.map((col)=>({
+                ...col,
+                postCount: postCounts.get(col.id) ?? 0
+            }))
+    });
+});
+// Get single collection
+collectionsApiRoutes.get("/:id", async (c)=>{
+    const id = parseInt(c.req.param("id"), 10);
+    if (isNaN(id)) return c.json({
+        error: "Invalid ID"
+    }, 400);
+    const collection = await c.var.services.collections.getById(id);
+    if (!collection) return c.json({
+        error: "Not found"
+    }, 404);
+    return c.json(collection);
+});
+// Reorder collections (requires auth) — must be before /:id
+collectionsApiRoutes.put("/reorder", requireAuthApi(), async (c)=>{
+    const rawBody = await c.req.json();
+    const parseResult = ReorderSchema.safeParse(rawBody);
+    if (!parseResult.success) {
+        return c.json({
+            error: "Validation failed",
+            details: parseResult.error.flatten()
+        }, 400);
+    }
+    await c.var.services.collections.reorder(parseResult.data.ids);
+    const collections = await c.var.services.collections.list();
+    return c.json({
+        collections
+    });
+});
+// Create collection (requires auth)
+collectionsApiRoutes.post("/", requireAuthApi(), async (c)=>{
+    const rawBody = await c.req.json();
+    const parseResult = CreateCollectionSchema.safeParse(rawBody);
+    if (!parseResult.success) {
+        return c.json({
+            error: "Validation failed",
+            details: parseResult.error.flatten()
+        }, 400);
+    }
+    const body = parseResult.data;
+    const collection = await c.var.services.collections.create({
+        slug: body.slug,
+        title: body.title,
+        description: body.description,
+        icon: body.icon,
+        sortOrder: body.sortOrder,
+        position: body.position,
+        showDivider: body.showDivider
+    });
+    return c.json(collection, 201);
+});
+// Update collection (requires auth)
+collectionsApiRoutes.put("/:id", requireAuthApi(), async (c)=>{
+    const id = parseInt(c.req.param("id"), 10);
+    if (isNaN(id)) return c.json({
+        error: "Invalid ID"
+    }, 400);
+    const rawBody = await c.req.json();
+    const parseResult = UpdateCollectionSchema.safeParse(rawBody);
+    if (!parseResult.success) {
+        return c.json({
+            error: "Validation failed",
+            details: parseResult.error.flatten()
+        }, 400);
+    }
+    const collection = await c.var.services.collections.update(id, parseResult.data);
+    if (!collection) return c.json({
+        error: "Not found"
+    }, 404);
+    return c.json(collection);
+});
+// Delete collection (requires auth)
+collectionsApiRoutes.delete("/:id", requireAuthApi(), async (c)=>{
+    const id = parseInt(c.req.param("id"), 10);
+    if (isNaN(id)) return c.json({
+        error: "Invalid ID"
+    }, 400);
+    const success = await c.var.services.collections.delete(id);
+    if (!success) return c.json({
+        error: "Not found"
+    }, 404);
+    return c.json({
+        success: true
+    });
+});

package/dist/routes/api/nav-items.js

@@ -0,0 +1,104 @@
+/**
+ * Nav Items API Routes
+ */ import { Hono } from "hono";
+import { requireAuthApi } from "../../middleware/auth.js";
+import { z } from "zod";
+export const navItemsApiRoutes = new Hono();
+const NavItemTypeSchema = z.enum([
+    "link",
+    "page"
+]);
+const CreateNavItemSchema = z.object({
+    type: NavItemTypeSchema,
+    label: z.string().min(1),
+    url: z.string().min(1),
+    pageId: z.number().int().positive().optional(),
+    position: z.number().int().min(0).optional()
+});
+const UpdateNavItemSchema = z.object({
+    type: NavItemTypeSchema.optional(),
+    label: z.string().min(1).optional(),
+    url: z.string().min(1).optional(),
+    pageId: z.number().int().positive().nullable().optional(),
+    position: z.number().int().min(0).optional()
+});
+const ReorderSchema = z.object({
+    ids: z.array(z.number().int().positive())
+});
+// List nav items
+navItemsApiRoutes.get("/", async (c)=>{
+    const items = await c.var.services.navItems.list();
+    return c.json({
+        navItems: items
+    });
+});
+// Reorder nav items (requires auth) — must be before /:id
+navItemsApiRoutes.put("/reorder", requireAuthApi(), async (c)=>{
+    const rawBody = await c.req.json();
+    const parseResult = ReorderSchema.safeParse(rawBody);
+    if (!parseResult.success) {
+        return c.json({
+            error: "Validation failed",
+            details: parseResult.error.flatten()
+        }, 400);
+    }
+    await c.var.services.navItems.reorder(parseResult.data.ids);
+    const items = await c.var.services.navItems.list();
+    return c.json({
+        navItems: items
+    });
+});
+// Create nav item (requires auth)
+navItemsApiRoutes.post("/", requireAuthApi(), async (c)=>{
+    const rawBody = await c.req.json();
+    const parseResult = CreateNavItemSchema.safeParse(rawBody);
+    if (!parseResult.success) {
+        return c.json({
+            error: "Validation failed",
+            details: parseResult.error.flatten()
+        }, 400);
+    }
+    const body = parseResult.data;
+    const item = await c.var.services.navItems.create({
+        type: body.type,
+        label: body.label,
+        url: body.url,
+        pageId: body.pageId,
+        position: body.position
+    });
+    return c.json(item, 201);
+});
+// Update nav item (requires auth)
+navItemsApiRoutes.put("/:id", requireAuthApi(), async (c)=>{
+    const id = parseInt(c.req.param("id"), 10);
+    if (isNaN(id)) return c.json({
+        error: "Invalid ID"
+    }, 400);
+    const rawBody = await c.req.json();
+    const parseResult = UpdateNavItemSchema.safeParse(rawBody);
+    if (!parseResult.success) {
+        return c.json({
+            error: "Validation failed",
+            details: parseResult.error.flatten()
+        }, 400);
+    }
+    const item = await c.var.services.navItems.update(id, parseResult.data);
+    if (!item) return c.json({
+        error: "Not found"
+    }, 404);
+    return c.json(item);
+});
+// Delete nav item (requires auth)
+navItemsApiRoutes.delete("/:id", requireAuthApi(), async (c)=>{
+    const id = parseInt(c.req.param("id"), 10);
+    if (isNaN(id)) return c.json({
+        error: "Invalid ID"
+    }, 400);
+    const success = await c.var.services.navItems.delete(id);
+    if (!success) return c.json({
+        error: "Not found"
+    }, 404);
+    return c.json({
+        success: true
+    });
+});