@jant/core 0.3.27 → 0.3.28

package/dist/lib/media-upload.js

@@ -1,104 +0,0 @@
-/**
- * Client-side Media Upload Handler
- *
- * Handles file upload flow:
- * 1. User selects file via [data-media-upload] input
- * 2. Creates placeholder in grid with spinner
- * 3. Processes image via ImageProcessor (resize/convert to WebP)
- * 4. Sets processed file on hidden Datastar form via DataTransfer API
- * 5. Triggers form.requestSubmit() — Datastar handles upload + SSE response
- */ import { ImageProcessor } from "./image-processor.js";
-/**
- * Format file size for display
- */ function formatFileSize(bytes) {
-    if (bytes < 1024) return `${bytes} B`;
-    if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
-    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
-}
-/**
- * Ensure the media grid exists, removing empty state if needed
- */ function ensureGridExists() {
-    let grid = document.getElementById("media-grid");
-    if (grid) return grid;
-    document.getElementById("empty-state")?.remove();
-    grid = document.createElement("div");
-    grid.id = "media-grid";
-    grid.className = "grid grid-cols-2 sm:grid-cols-3 md:grid-cols-4 lg:grid-cols-5 gap-4";
-    document.getElementById("media-content")?.appendChild(grid);
-    return grid;
-}
-/**
- * Create a placeholder card with spinner in the media grid
- */ function createPlaceholder(fileName, fileSize, statusText) {
-    const placeholder = document.createElement("div");
-    placeholder.id = "upload-placeholder";
-    placeholder.className = "group relative";
-    placeholder.innerHTML = `
-    <div class="aspect-square bg-muted rounded-lg overflow-hidden border flex items-center justify-center">
-      <div class="text-center px-2">
-        <svg class="animate-spin h-6 w-6 text-muted-foreground mx-auto mb-2" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24">
-          <circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle>
-          <path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"></path>
-        </svg>
-        <span id="upload-status" class="text-xs text-muted-foreground">${statusText}</span>
-      </div>
-    </div>
-    <div class="mt-2 text-xs truncate" title="${fileName}">${fileName}</div>
-    <div class="text-xs text-muted-foreground">${formatFileSize(fileSize)}</div>
-  `;
-    return placeholder;
-}
-/**
- * Replace placeholder content with an error message
- */ function showPlaceholderError(placeholder, fileName, errorMessage) {
-    placeholder.innerHTML = `
-    <div class="aspect-square bg-destructive/10 rounded-lg overflow-hidden border border-destructive flex items-center justify-center">
-      <div class="text-center px-2">
-        <span class="text-xs text-destructive">${errorMessage}</span>
-      </div>
-    </div>
-    <div class="mt-2 text-xs truncate text-destructive">${fileName}</div>
-    <button type="button" class="text-xs text-muted-foreground hover:underline" onclick="this.closest('.group').remove()">Remove</button>
-  `;
-}
-/**
- * Handle the upload flow for a selected file
- */ async function handleUpload(input, file) {
-    const processingText = input.dataset.textProcessing || "Processing...";
-    const uploadingText = input.dataset.textUploading || "Uploading...";
-    const errorText = input.dataset.textError || "Upload failed. Please try again.";
-    const grid = ensureGridExists();
-    const placeholder = createPlaceholder(file.name, file.size, processingText);
-    grid.prepend(placeholder);
-    try {
-        // Process image client-side (resize, convert to WebP)
-        const processed = await ImageProcessor.processToFile(file);
-        // Update status
-        const statusEl = document.getElementById("upload-status");
-        if (statusEl) statusEl.textContent = uploadingText;
-        // Set processed file on hidden form input via DataTransfer API
-        const formInput = document.getElementById("upload-file-input");
-        const form = document.getElementById("upload-form");
-        if (!formInput || !form) throw new Error("Upload form not found");
-        const dt = new DataTransfer();
-        dt.items.add(processed);
-        formInput.files = dt.files;
-        // Trigger Datastar-intercepted form submission
-        form.requestSubmit();
-    } catch (err) {
-        const message = err instanceof Error ? err.message : errorText;
-        showPlaceholderError(placeholder, file.name, message);
-    }
-    // Reset file input so the same file can be re-selected
-    input.value = "";
-}
-/**
- * Initialize media upload via event delegation
- */ function initMediaUpload() {
-    document.addEventListener("change", (e)=>{
-        const input = e.target.closest("[data-media-upload]");
-        if (!input?.files?.[0]) return;
-        handleUpload(input, input.files[0]);
-    });
-}
-initMediaUpload();

package/dist/lib/nav-reorder.js

@@ -1,27 +0,0 @@
-/**
- * Navigation Link Reorder
- *
- * Initializes SortableJS on the navigation links list in the dashboard.
- * Auto-detects the list element and only activates when present.
- */ import Sortable from "sortablejs";
-const list = document.getElementById("nav-links-list");
-if (list) {
-    Sortable.create(list, {
-        animation: 150,
-        handle: "[data-id]",
-        onEnd () {
-            const ids = [
-                ...list.querySelectorAll("[data-id]")
-            ].map((el)=>Number(el.dataset.id));
-            fetch("/dash/pages/reorder", {
-                method: "POST",
-                headers: {
-                    "Content-Type": "application/json"
-                },
-                body: JSON.stringify({
-                    ids
-                })
-            });
-        }
-    });
-}

package/dist/lib/navigation.js

@@ -1,79 +0,0 @@
-/**
- * Navigation Helper
- *
- * Provides shared data fetching for public page navigation.
- */ import { getSiteName, getHomeDefaultView, getSiteFooter } from "./config.js";
-import { toNavItemViews } from "./view.js";
-import { getMediaUrl, getPublicUrlForProvider } from "./image.js";
-import { render as renderMarkdown } from "./markdown.js";
-/**
- * Fetch navigation data for public pages.
- *
- * Returns NavItemView[] with pre-computed isActive/isExternal state.
- * Also checks authentication status and loads collections for authenticated users.
- *
- * @param c - Hono context
- * @returns Navigation data for SiteLayout
- *
- * @example
- * ```typescript
- * const navData = await getNavigationData(c);
- * return renderPublicPage(c, {
- *   title: "My Page",
- *   navData,
- *   content: <MyContent />,
- * });
- * ```
- */ export async function getNavigationData(c) {
-    const items = await c.var.services.navItems.list();
-    const currentPath = new URL(c.req.url).pathname;
-    const [siteName, homeDefaultView, siteFooter] = await Promise.all([
-        getSiteName(c),
-        getHomeDefaultView(c),
-        getSiteFooter(c)
-    ]);
-    // Only include description if explicitly set (DB or env), not the default
-    const dbDescription = await c.var.services.settings.get("SITE_DESCRIPTION");
-    const envDescription = c.env.SITE_DESCRIPTION;
-    const siteDescription = dbDescription || (typeof envDescription === "string" ? envDescription : "");
-    // Resolve avatar URL from storage key
-    const avatarKey = await c.var.services.settings.get("SITE_AVATAR");
-    const showHeaderAvatar = await c.var.services.settings.get("SHOW_HEADER_AVATAR") === "true";
-    let siteAvatarUrl;
-    if (avatarKey) {
-        const publicUrl = getPublicUrlForProvider(c.env.STORAGE_DRIVER || "r2", c.env.R2_PUBLIC_URL, c.env.S3_PUBLIC_URL);
-        siteAvatarUrl = getMediaUrl(avatarKey, publicUrl);
-    }
-    // Render footer markdown
-    const siteFooterHtml = siteFooter ? renderMarkdown(siteFooter) : undefined;
-    const links = toNavItemViews(items, currentPath);
-    // Check auth status for compose button
-    let isAuthenticated = false;
-    let collections = [];
-    if (c.var.auth) {
-        try {
-            const session = await c.var.auth.api.getSession({
-                headers: c.req.raw.headers
-            });
-            isAuthenticated = !!session?.user;
-        } catch  {
-        // Not authenticated
-        }
-    }
-    // Only load collections when authenticated (for compose dialog)
-    if (isAuthenticated) {
-        collections = await c.var.services.collections.list();
-    }
-    return {
-        links,
-        currentPath,
-        siteName,
-        siteDescription,
-        isAuthenticated,
-        collections,
-        homeDefaultView,
-        siteAvatarUrl,
-        showHeaderAvatar: showHeaderAvatar && !!siteAvatarUrl,
-        siteFooterHtml
-    };
-}

package/dist/lib/pagination.js

@@ -1,44 +0,0 @@
-/**
- * Pagination Utilities
- *
- * Pure utility functions for page-based pagination.
- */ /**
- * Computes which page numbers to display in a numbered pagination control.
- * Always includes: first page, last page, current page, and 1 page on each side of current.
- * Gaps between non-consecutive pages are represented by 0 (ellipsis marker).
- *
- * @param currentPage - The current active page (1-indexed)
- * @param totalPages - Total number of pages
- * @returns Array of page numbers, with 0 representing ellipsis gaps
- *
- * @example
- * ```ts
- * getPageNumbers(1, 5)    // [1, 2, 3, 4, 5]
- * getPageNumbers(1, 20)   // [1, 2, 0, 20]
- * getPageNumbers(10, 20)  // [1, 0, 9, 10, 11, 0, 20]
- * ```
- */ export function getPageNumbers(currentPage, totalPages) {
-    if (totalPages <= 7) {
-        return Array.from({
-            length: totalPages
-        }, (_, i)=>i + 1);
-    }
-    const pages = new Set();
-    pages.add(1);
-    pages.add(totalPages);
-    pages.add(currentPage);
-    if (currentPage > 1) pages.add(currentPage - 1);
-    if (currentPage < totalPages) pages.add(currentPage + 1);
-    const sorted = [
-        ...pages
-    ].sort((a, b)=>a - b);
-    // Insert 0 for gaps
-    const result = [];
-    for(let i = 0; i < sorted.length; i++){
-        if (i > 0 && sorted[i] - sorted[i - 1] > 1) {
-            result.push(0); // ellipsis marker
-        }
-        result.push(sorted[i]);
-    }
-    return result;
-}

package/dist/lib/render.js

@@ -1,53 +0,0 @@
-/**
- * Public Page Rendering Helper
- *
- * Provides a single entry point for rendering public pages with the
- * correct layout stack: BaseLayout > SiteLayout > content.
- */ import { jsx as _jsx } from "hono/jsx/jsx-runtime";
-import { BaseLayout } from "../ui/layouts/BaseLayout.js";
-import { SiteLayout } from "../ui/layouts/SiteLayout.js";
-/**
- * Render a public page with the standard layout stack.
- *
- * @param c - Hono context
- * @param options - Page rendering options
- * @returns Hono HTML response
- *
- * @example
- * ```typescript
- * const navData = await getNavigationData(c);
- * return renderPublicPage(c, {
- *   title: "My Page",
- *   navData,
- *   content: <MyPageComponent />,
- * });
- * ```
- */ export function renderPublicPage(c, options) {
-    const { title, description, navData, content } = options;
-    const layoutProps = {
-        siteName: navData.siteName,
-        siteDescription: navData.siteDescription,
-        links: navData.links,
-        currentPath: navData.currentPath,
-        isAuthenticated: navData.isAuthenticated,
-        collections: navData.collections,
-        homeDefaultView: navData.homeDefaultView,
-        siteAvatarUrl: navData.siteAvatarUrl,
-        showHeaderAvatar: navData.showHeaderAvatar,
-        siteFooterHtml: navData.siteFooterHtml
-    };
-    // Read favicon and noindex from context (set by theme middleware)
-    const faviconUrl = c.get("faviconUrl");
-    const noindex = c.get("noindex");
-    return c.html(/*#__PURE__*/ _jsx(BaseLayout, {
-        title: title,
-        description: description,
-        c: c,
-        faviconUrl: faviconUrl,
-        noindex: noindex,
-        children: /*#__PURE__*/ _jsx(SiteLayout, {
-            ...layoutProps,
-            children: content
-        })
-    }));
-}

package/dist/lib/schemas.js

@@ -1,174 +0,0 @@
-/**
- * Shared Zod schemas for validation (v2)
- *
- * These schemas ensure type-safe validation of user input
- * from forms, API requests, and other external sources.
- *
- * IMPORTANT: Types are defined in types.ts as the single source of truth.
- * This file only defines Zod validation schemas based on those types.
- */ import { z } from "zod";
-import { FORMATS, STATUSES, SORT_ORDERS, NAV_ITEM_TYPES, MAX_MEDIA_ATTACHMENTS } from "../types.js";
-/**
- * Post format enum schema
- * Based on FORMATS from types.ts
- */ export const FormatSchema = z.enum(FORMATS);
-/**
- * Post status enum schema
- * Based on STATUSES from types.ts
- */ export const StatusSchema = z.enum(STATUSES);
-/**
- * Collection sort order enum schema
- */ export const SortOrderSchema = z.enum(SORT_ORDERS);
-/**
- * Navigation item type enum schema
- */ export const NavItemTypeSchema = z.enum(NAV_ITEM_TYPES);
-/**
- * Redirect type enum schema
- * Form input validation for redirect type (stored as number in DB)
- */ export const RedirectTypeSchema = z.enum([
-    "301",
-    "302"
-]);
-/**
- * Rating schema (1-5 integer)
- */ export const RatingSchema = z.coerce.number().int().min(0).max(5).optional().or(z.literal("").transform(()=>undefined)).transform((v)=>v === 0 ? undefined : v);
-/**
- * API request body schema for creating a post
- */ export const CreatePostSchema = z.object({
-    format: FormatSchema,
-    path: z.string().regex(/^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\/[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$/).optional().or(z.literal("").transform(()=>undefined)),
-    title: z.string().optional(),
-    body: z.string().optional(),
-    status: StatusSchema.optional(),
-    featured: z.union([
-        z.boolean(),
-        z.literal("on").transform(()=>true)
-    ]).optional(),
-    pinned: z.union([
-        z.boolean(),
-        z.literal("on").transform(()=>true)
-    ]).optional(),
-    url: z.url().optional().or(z.literal("")),
-    quoteText: z.string().optional(),
-    rating: RatingSchema,
-    collectionId: z.coerce.number().int().min(0).optional().or(z.literal("").transform(()=>undefined)).transform((v)=>v === 0 ? undefined : v),
-    replyToId: z.string().optional(),
-    publishedAt: z.number().int().positive().optional(),
-    mediaIds: z.array(z.string()).max(MAX_MEDIA_ATTACHMENTS).optional()
-});
-/**
- * API request body schema for updating a post
- */ export const UpdatePostSchema = CreatePostSchema.partial();
-/**
- * API request body schema for creating a page
- */ export const CreatePageSchema = z.object({
-    slug: z.string().min(1).regex(/^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$/),
-    title: z.string().optional(),
-    body: z.string().optional(),
-    status: StatusSchema.optional()
-});
-/**
- * API request body schema for updating a page
- */ export const UpdatePageSchema = CreatePageSchema.partial();
-/**
- * API request body schema for creating a navigation item
- */ export const CreateNavItemSchema = z.object({
-    type: NavItemTypeSchema,
-    label: z.string().min(1),
-    url: z.string().min(1),
-    pageId: z.coerce.number().int().positive().optional(),
-    position: z.coerce.number().int().min(0).optional()
-});
-/**
- * API request body schema for updating a navigation item
- */ export const UpdateNavItemSchema = CreateNavItemSchema.partial();
-/**
- * API request body schema for creating a collection
- */ export const CreateCollectionSchema = z.object({
-    slug: z.string().min(1).regex(/^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$/),
-    title: z.string().min(1),
-    description: z.string().optional(),
-    icon: z.string().optional(),
-    sortOrder: SortOrderSchema.optional(),
-    position: z.coerce.number().int().min(0).optional(),
-    showDivider: z.union([
-        z.boolean(),
-        z.literal("on").transform(()=>true)
-    ]).optional()
-});
-/**
- * API request body schema for updating a collection
- */ export const UpdateCollectionSchema = CreateCollectionSchema.partial();
-// =============================================================================
-// Auth Schemas
-// =============================================================================
-/**
- * Setup form validation schema
- */ export const SetupSchema = z.object({
-    name: z.string().min(1, "Name is required"),
-    email: z.string().email("Invalid email address"),
-    password: z.string().min(8, "Password must be at least 8 characters")
-});
-/**
- * Sign-in form validation schema
- */ export const SigninSchema = z.object({
-    email: z.string().email("Invalid email address"),
-    password: z.string().min(1, "Password is required")
-});
-/**
- * Password reset form validation schema
- */ export const ResetPasswordSchema = z.object({
-    password: z.string().min(8, "Password must be at least 8 characters"),
-    confirmPassword: z.string().min(1),
-    token: z.string().min(1)
-}).refine((d)=>d.password === d.confirmPassword, {
-    message: "Passwords do not match",
-    path: [
-        "confirmPassword"
-    ]
-});
-// =============================================================================
-// Form Data Helpers
-// =============================================================================
-/**
- * Form data helper: safely parse a FormData value with a schema
- *
- * @example
- * ```ts
- * const format = parseFormData(formData, "format", FormatSchema);
- * // format is Format, throws if invalid
- * ```
- */ export function parseFormData(formData, key, schema) {
-    const value = formData.get(key);
-    if (value === null) {
-        throw new Error(`Missing required field: ${key}`);
-    }
-    return schema.parse(value);
-}
-/**
- * Form data helper: safely parse optional FormData value with a schema
- *
- * @example
- * ```ts
- * const slug = parseFormDataOptional(formData, "slug", z.string());
- * // slug is string | undefined
- * ```
- */ export function parseFormDataOptional(formData, key, schema) {
-    const value = formData.get(key);
-    if (value === null || value === "") {
-        return undefined;
-    }
-    return schema.parse(value);
-}
-/**
- * Validates media attachment count for a post.
- * All formats allow 0-20 media attachments.
- *
- * @param mediaIds - Array of media IDs to attach
- * @returns null if valid, error string if invalid
- */ export function validateMediaCount(mediaIds) {
-    if (mediaIds.length > MAX_MEDIA_ATTACHMENTS) {
-        return `Posts allow at most ${MAX_MEDIA_ATTACHMENTS} media attachments`;
-    }
-    return null;
-}

package/dist/lib/sqid.js

@@ -1,72 +0,0 @@
-/**
- * Sqids - Short unique IDs for URLs
- *
- * Encodes numeric IDs to short strings like "jR3k"
- */ import Sqids from "sqids";
-const sqids = new Sqids({
-    minLength: 4
-});
-/**
- * Encodes a numeric database ID to a short, URL-friendly string.
- *
- * Uses the Sqids library to generate short unique identifiers with a minimum length of 4 characters.
- * These are used in URLs (e.g., `/p/jR3k`) to obscure sequential integer IDs while maintaining
- * uniqueness and reversibility.
- *
- * @param id - The numeric database ID to encode
- * @returns A short string representation of the ID (minimum 4 characters)
- *
- * @example
- * ```ts
- * const sqid = encode(123);
- * // Returns: "jR3k" (or similar short string)
- * ```
- */ export function encode(id) {
-    return sqids.encode([
-        id
-    ]);
-}
-/**
- * Decodes a sqid string back to the original numeric database ID.
- *
- * Attempts to decode a sqid string generated by the `encode()` function. Returns the original
- * numeric ID if valid, or `null` if the string is not a valid sqid. This is used to extract
- * database IDs from URL parameters.
- *
- * @param str - The sqid string to decode
- * @returns The original numeric ID if valid, or `null` if decoding fails
- *
- * @example
- * ```ts
- * const id = decode("jR3k");
- * // Returns: 123
- *
- * const invalid = decode("invalid");
- * // Returns: null
- * ```
- */ export function decode(str) {
-    try {
-        const ids = sqids.decode(str);
-        return ids[0] ?? null;
-    } catch  {
-        return null;
-    }
-}
-/**
- * Checks if a string is a valid sqid that can be decoded.
- *
- * Validates whether a string can be successfully decoded to a numeric ID.
- * Useful for route validation and input sanitization.
- *
- * @param str - The string to validate
- * @returns `true` if the string is a valid sqid, `false` otherwise
- *
- * @example
- * ```ts
- * if (isValidSqid("jR3k")) {
- *   // Process the valid sqid
- * }
- * ```
- */ export function isValidSqid(str) {
-    return decode(str) !== null;
-}