@jant/core 0.3.35 → 0.3.37

package/src/types/bindings.ts

@@ -12,6 +12,7 @@ export interface Bindings {
   IMAGE_TRANSFORM_URL?: string;
   DEMO_EMAIL?: string;
   DEMO_PASSWORD?: string;
+  DEV_API_TOKEN?: string;
   // Timeline
   PAGE_SIZE?: string;
   // Site configuration (optional - can be overridden in DB)
@@ -27,6 +28,13 @@ export interface Bindings {
   S3_SECRET_ACCESS_KEY?: string;
   S3_REGION?: string;
   S3_PUBLIC_URL?: string;
+  // Upload
+  UPLOAD_MAX_FILE_SIZE_MB?: string;
+  // Summary extraction
+  SUMMARY_MAX_PARAGRAPHS?: string;
+  SUMMARY_MAX_CHARS?: string;
+  // Slug generation
+  SLUG_ID_LENGTH?: string;
   // RSS feed
   RSS_FEED_LIMIT?: string;
 }

package/src/types/config.ts

@@ -15,7 +15,7 @@
  * - envOnly: true -> Environment-only (ENV > Default)
  */
 export const CONFIG_FIELDS = {
-  // User-configurable (can be modified in dashboard)
+  // User-configurable (can be modified in settings)
   SITE_NAME: {
     defaultValue: "Jant",
     envOnly: false,
@@ -33,7 +33,7 @@ export const CONFIG_FIELDS = {
     envOnly: false,
   },
   HEADER_NAV_MAX_VISIBLE: {
-    defaultValue: "3",
+    defaultValue: "2",
     envOnly: false,
   },
 
@@ -98,8 +98,24 @@ export const CONFIG_FIELDS = {
     defaultValue: "",
     envOnly: true,
   },
+  UPLOAD_MAX_FILE_SIZE_MB: {
+    defaultValue: "500",
+    envOnly: true,
+  },
+  SUMMARY_MAX_PARAGRAPHS: {
+    defaultValue: "5",
+    envOnly: true,
+  },
+  SUMMARY_MAX_CHARS: {
+    defaultValue: "500",
+    envOnly: true,
+  },
+  SLUG_ID_LENGTH: {
+    defaultValue: "5",
+    envOnly: true,
+  },
 
-  // Internal settings (DB-only, not configurable via env or dashboard)
+  // Internal settings (DB-only, not configurable via env or settings UI)
   THEME: {
     defaultValue: "",
     envOnly: false,
@@ -195,10 +211,24 @@ export interface AppConfig {
   s3PublicUrl: string;
   imageTransformUrl: string;
 
+  // Upload (ENV only, parsed to number)
+  /** Max upload file size in MB. Defaults to 500. */
+  uploadMaxFileSize: number;
+
+  // Summary extraction (ENV only)
+  /** Max paragraphs to include in auto-extracted summary. Defaults to 5. */
+  summaryMaxParagraphs: number;
+  /** Max characters to include in auto-extracted summary. Defaults to 500. */
+  summaryMaxChars: number;
+
   // Pagination/Feed (ENV only, parsed to number)
   pageSize: number;
   rssFeedLimit: number;
 
+  // Slug (ENV only)
+  /** Length of random IDs used in auto-generated slugs. Defaults to 5. */
+  slugIdLength: number;
+
   // Demo (ENV only)
   demoEmail: string;
   demoPassword: string;
@@ -216,7 +246,7 @@ export interface AppConfig {
   siteAvatarUrl: string;
   faviconVersion: string;
 
-  // Dashboard form placeholders (ENV > Default, without DB)
+  // Settings form placeholders (ENV > Default, without DB)
   fallbacks: {
     siteName: string;
     siteDescription: string;

package/src/types/constants.ts

@@ -8,6 +8,9 @@ export type Format = (typeof FORMATS)[number];
 export const STATUSES = ["draft", "published"] as const;
 export type Status = (typeof STATUSES)[number];
 
+export const VISIBILITIES = ["public", "unlisted", "private"] as const;
+export type Visibility = (typeof VISIBILITIES)[number];
+
 export const SORT_ORDERS = [
   "newest",
   "oldest",
@@ -16,12 +19,12 @@ export const SORT_ORDERS = [
 ] as const;
 export type SortOrder = (typeof SORT_ORDERS)[number];
 
-export const NAV_ITEM_TYPES = ["page", "link", "system"] as const;
+export const NAV_ITEM_TYPES = ["link", "system"] as const;
 export type NavItemType = (typeof NAV_ITEM_TYPES)[number];
 
 export const SYSTEM_NAV_KEYS = {
   rss: { defaultLabel: "RSS", url: "/feed" },
-  dashboard: { defaultLabel: "Dashboard", url: "/dash" },
+  settings: { defaultLabel: "Settings", url: "/settings" },
   collections: { defaultLabel: "Collections", url: "/c" },
   archive: { defaultLabel: "Archive", url: "/archive" },
 } as const;
@@ -30,5 +33,17 @@ export type SystemNavKey = keyof typeof SYSTEM_NAV_KEYS;
 export const MAX_MEDIA_ATTACHMENTS = 20;
 export const MAX_PINNED_POSTS = 3;
 
+export const MEDIA_KINDS = [
+  "image",
+  "video",
+  "audio",
+  "text",
+  "document",
+] as const;
+export type MediaKind = (typeof MEDIA_KINDS)[number];
+
 export const STORAGE_DRIVERS = ["r2", "s3"] as const;
 export type StorageDriver = (typeof STORAGE_DRIVERS)[number];
+
+export const PATH_KINDS = ["slug", "alias", "redirect"] as const;
+export type PathKind = (typeof PATH_KINDS)[number];

package/src/types/entities.ts

@@ -2,43 +2,44 @@
  * Entity Types (database-level models)
  */
 
-import type { Format, Status, SortOrder, NavItemType } from "./constants.js";
+import type {
+  Format,
+  Status,
+  Visibility,
+  SortOrder,
+  NavItemType,
+  MediaKind,
+  PathKind,
+} from "./constants.js";
 
 export interface Post {
-  id: number;
+  id: string;
   format: Format;
   status: Status;
-  featured: number; // 0 | 1
-  pinned: number; // 0 | 1
-  path: string | null;
+  visibility: Visibility;
+  pinnedAt: number | null;
+  featuredAt: number | null;
+  slug: string;
   title: string | null;
   url: string | null;
   body: string | null;
   bodyHtml: string | null;
+  bodyText: string | null;
   quoteText: string | null;
+  summary: string | null;
   rating: number | null;
-  replyToId: number | null;
-  threadId: number | null;
+  replyToId: string | null;
+  threadId: string;
   deletedAt: number | null;
-  publishedAt: number;
-  createdAt: number;
-  updatedAt: number;
-}
-
-export interface Page {
-  id: number;
-  slug: string;
-  title: string | null;
-  body: string | null;
-  bodyHtml: string | null;
-  status: Status;
+  publishedAt: number | null;
+  lastActivityAt: number;
   createdAt: number;
   updatedAt: number;
 }
 
 export interface Media {
   id: string; // UUIDv7
-  postId: number | null;
+  postId: string | null;
   filename: string;
   originalName: string;
   mimeType: string;
@@ -48,9 +49,15 @@ export interface Media {
   width: number | null;
   height: number | null;
   alt: string | null;
-  position: number;
+  position: string;
   blurhash: string | null;
+  waveform: string | null;
+  posterKey: string | null;
+  summary: string | null;
+  chars: number | null;
+  mediaKind: MediaKind;
   createdAt: number;
+  updatedAt: number;
 }
 
 export interface MediaAttachment {
@@ -59,10 +66,16 @@ export interface MediaAttachment {
   previewUrl: string;
   alt: string | null;
   blurhash: string | null;
+  waveform: string | null;
+  posterUrl: string | null;
   width: number | null;
   height: number | null;
-  position: number;
+  position: string;
   mimeType: string;
+  originalName: string;
+  size: number;
+  summary: string | null;
+  chars: number | null;
 }
 
 export interface PostWithMedia extends Post {
@@ -70,46 +83,62 @@ export interface PostWithMedia extends Post {
 }
 
 export interface Collection {
-  id: number;
+  id: string;
   slug: string;
   title: string;
   description: string | null;
   icon: string | null;
   sortOrder: SortOrder;
-  position: number;
   createdAt: number;
   updatedAt: number;
 }
 
-export interface CollectionDivider {
-  id: number;
-  position: number;
+export type SidebarItemType = "collection" | "divider";
+
+export interface SidebarItem {
+  id: string;
+  type: SidebarItemType;
+  collectionId: string | null;
+  position: string;
   createdAt: number;
   updatedAt: number;
 }
 
 export interface PostCollection {
-  postId: number;
-  collectionId: number;
+  postId: string;
+  collectionId: string;
 }
 
 export interface NavItem {
-  id: number;
+  id: string;
   type: NavItemType;
   label: string;
   url: string;
-  pageId: number | null;
-  position: number;
+  position: string;
   createdAt: number;
   updatedAt: number;
 }
 
-export interface Redirect {
-  id: number;
-  fromPath: string;
-  toPath: string;
-  type: 301 | 302;
+export interface CustomUrl {
+  id: string;
+  path: string;
+  targetType: "post" | "collection" | "redirect";
+  targetId: string | null;
+  toPath: string | null;
+  redirectType: 301 | 302 | null;
+  createdAt: number;
+}
+
+export interface PathRecord {
+  id: string;
+  path: string;
+  kind: PathKind;
+  postId: string | null;
+  collectionId: string | null;
+  redirectToPath: string | null;
+  redirectType: 301 | 302 | null;
   createdAt: number;
+  updatedAt: number;
 }
 
 export interface Setting {
@@ -117,3 +146,20 @@ export interface Setting {
   value: string;
   updatedAt: number;
 }
+
+export interface ApiToken {
+  id: string;
+  name: string;
+  prefix: string;
+  lastUsedAt: number | null;
+  createdAt: number;
+  updatedAt: number;
+}
+
+/** Latest-reply context for a thread root, used in timeline display */
+export interface ThreadTimelineContext {
+  latestReply: Post;
+  /** Parent of latestReply, only if it's not the root */
+  parentReply: Post | null;
+  totalReplyCount: number;
+}

package/src/types/operations.ts

@@ -2,21 +2,30 @@
  * Operation Types (create/update DTOs)
  */
 
-import type { Format, Status, SortOrder, NavItemType } from "./constants.js";
+import type {
+  Format,
+  Status,
+  Visibility,
+  SortOrder,
+  NavItemType,
+} from "./constants.js";
 
 export interface CreatePost {
   format: Format;
   status?: Status;
-  featured?: boolean;
+  visibility?: Visibility;
   pinned?: boolean;
+  featured?: boolean;
+  slug?: string;
   path?: string;
   title?: string;
   url?: string;
   body?: string;
+  bodyMarkdown?: string;
   quoteText?: string;
   rating?: number;
-  collectionIds?: number[];
-  replyToId?: number;
+  collectionIds?: string[];
+  replyToId?: string;
   publishedAt?: number;
   mediaIds?: string[];
 }
@@ -24,47 +33,33 @@ export interface CreatePost {
 export interface UpdatePost {
   format?: Format;
   status?: Status;
-  featured?: boolean;
+  visibility?: Visibility;
   pinned?: boolean;
-  path?: string | null;
+  featured?: boolean;
+  slug?: string;
   title?: string | null;
   url?: string | null;
   body?: string | null;
+  bodyMarkdown?: string | null;
   quoteText?: string | null;
   rating?: number | null;
-  collectionIds?: number[];
+  collectionIds?: string[];
   publishedAt?: number;
   mediaIds?: string[];
 }
 
-export interface CreatePage {
-  slug: string;
-  title?: string;
-  body?: string;
-  status?: Status;
-}
-
-export interface UpdatePage {
-  slug?: string;
-  title?: string | null;
-  body?: string | null;
-  status?: Status;
-}
-
 export interface CreateNavItem {
   type: NavItemType;
   label: string;
   url: string;
-  pageId?: number;
-  position?: number;
+  position?: string;
 }
 
 export interface UpdateNavItem {
   type?: NavItemType;
   label?: string;
   url?: string;
-  pageId?: number | null;
-  position?: number;
+  position?: string;
 }
 
 export interface CreateCollection {
@@ -73,7 +68,6 @@ export interface CreateCollection {
   description?: string;
   icon?: string;
   sortOrder?: SortOrder;
-  position?: number;
 }
 
 export interface UpdateCollection {
@@ -82,5 +76,4 @@ export interface UpdateCollection {
   description?: string | null;
   icon?: string | null;
   sortOrder?: SortOrder;
-  position?: number;
 }

package/src/types/props.ts

@@ -2,11 +2,10 @@
  * Page-Level Props & Feed Data Types
  */
 
-import type { Format } from "./constants.js";
+import type { Format, MediaKind } from "./constants.js";
 import type { Collection } from "./entities.js";
 import type {
   PostView,
-  PageView,
   TimelineItemView,
   SearchResultView,
   ArchiveGroup,
@@ -19,7 +18,6 @@ import type {
 /** Props for the home page component */
 export interface HomePageProps {
   items: TimelineItemView[];
-  pinnedItems: PostView[];
   currentPage: number;
   totalPages: number;
 }
@@ -27,11 +25,7 @@ export interface HomePageProps {
 /** Props for the single post page component */
 export interface PostPageProps {
   post: PostView;
-}
-
-/** Props for the custom page component */
-export interface SinglePageProps {
-  page: PageView;
+  threadPosts?: PostView[];
 }
 
 /** Props for the featured page component */
@@ -39,13 +33,35 @@ export interface FeaturedPageProps {
   items: TimelineItemView[];
 }
 
+/** Visibility filter values for the archive page (includes "featured" as a virtual value). */
+export type ArchiveVisibility = "public" | "unlisted" | "private" | "featured";
+
+/** View mode for the archive page. */
+export type ArchiveView = "grid" | "list";
+
+/** Filters currently active on the archive page */
+export interface ArchiveFilters {
+  year?: number;
+  collectionSlug?: string;
+  collectionTitle?: string;
+  collectionIcon?: string | null;
+  format?: Format;
+  mediaKinds?: MediaKind[];
+  hasMedia?: boolean;
+  hasTitle?: boolean;
+  visibility?: ArchiveVisibility;
+  view?: ArchiveView;
+}
+
 /** Props for the archive page component */
 export interface ArchivePageProps {
   groups: ArchiveGroup[];
-  hasMore: boolean;
-  nextCursor?: number;
-  format?: Format;
-  featured?: boolean;
+  currentPage: number;
+  totalPages: number;
+  filters: ArchiveFilters;
+  availableYears: number[];
+  availableCollections: { slug: string; title: string; icon: string | null }[];
+  isAuthenticated: boolean;
 }
 
 /** Props for the search page component */
@@ -60,9 +76,9 @@ export interface SearchPageProps {
 /** Props for the single collection page component */
 export interface CollectionPageProps {
   collection: Collection;
-  posts: PostView[];
+  items: TimelineItemView[];
   hasMore: boolean;
-  nextCursor?: number;
+  nextCursor?: string;
 }
 
 /** Props for the collections list page component */
@@ -87,23 +103,42 @@ export interface FeedData {
 export interface SitemapData {
   siteUrl: string;
   posts: PostView[];
-  pages: PageView[];
 }
 
 // =============================================================================
 // Timeline Types
 // =============================================================================
 
+/**
+ * Display mode for timeline cards.
+ * - `compact` — condensed view for constrained contexts
+ * - `feed`    — standard timeline card (default)
+ * - `detail`  — full single-post page view
+ */
+export type CardMode = "compact" | "feed" | "detail";
+
+export interface PostFooterDisplayOptions {
+  hideActions?: boolean;
+}
+
+export interface TimelineCardDisplayOptions {
+  hideStatusBadges?: boolean;
+  hideRating?: boolean;
+  footer?: PostFooterDisplayOptions;
+}
+
 /** Props for per-type timeline cards */
 export interface TimelineCardProps {
   post: PostView;
-  compact?: boolean;
+  mode?: CardMode;
+  display?: TimelineCardDisplayOptions;
 }
 
 /** Props for thread inline preview */
 export interface ThreadPreviewProps {
   rootPost: PostView;
-  previewReplies: PostView[];
+  latestReply: PostView;
+  parentReply?: PostView;
   totalReplyCount: number;
 }