@jant/core 0.3.35 → 0.3.37

package/src/lib/__tests__/sqid.test.ts

@@ -1,65 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { encode, decode, isValidSqid } from "../sqid.js";
-
-describe("encode", () => {
-  it("encodes a numeric ID to a string", () => {
-    const result = encode(1);
-    expect(typeof result).toBe("string");
-    expect(result.length).toBeGreaterThanOrEqual(4);
-  });
-
-  it("produces minimum 4-character strings", () => {
-    expect(encode(0).length).toBeGreaterThanOrEqual(4);
-    expect(encode(1).length).toBeGreaterThanOrEqual(4);
-    expect(encode(100).length).toBeGreaterThanOrEqual(4);
-  });
-
-  it("produces different strings for different IDs", () => {
-    const a = encode(1);
-    const b = encode(2);
-    const c = encode(100);
-    expect(a).not.toBe(b);
-    expect(b).not.toBe(c);
-  });
-
-  it("produces consistent results for the same ID", () => {
-    expect(encode(42)).toBe(encode(42));
-  });
-});
-
-describe("decode", () => {
-  it("decodes an encoded string back to the original ID", () => {
-    for (const id of [0, 1, 42, 100, 999, 10000]) {
-      const encoded = encode(id);
-      expect(decode(encoded)).toBe(id);
-    }
-  });
-
-  it("returns null for empty string", () => {
-    expect(decode("")).toBe(null);
-  });
-
-  it("handles round-trip encoding", () => {
-    const original = 12345;
-    const sqid = encode(original);
-    const decoded = decode(sqid);
-    expect(decoded).toBe(original);
-  });
-});
-
-describe("isValidSqid", () => {
-  it("returns true for valid encoded sqids", () => {
-    const sqid = encode(1);
-    expect(isValidSqid(sqid)).toBe(true);
-  });
-
-  it("returns true for various valid sqids", () => {
-    for (const id of [0, 1, 100, 999]) {
-      expect(isValidSqid(encode(id))).toBe(true);
-    }
-  });
-
-  it("returns false for empty string", () => {
-    expect(isValidSqid("")).toBe(false);
-  });
-});

package/src/lib/collections-reorder.ts

@@ -1,28 +0,0 @@
-/**
- * Collection Reorder
- *
- * Initializes SortableJS on the collections list in the dashboard.
- * Auto-detects the list element and only activates when present.
- * Sends prefixed string IDs (e.g. "c-1", "d-2") to support mixed
- * collections and dividers in a unified sort order.
- */
-
-import Sortable from "sortablejs";
-
-const list = document.getElementById("collections-list");
-if (list) {
-  Sortable.create(list, {
-    animation: 150,
-    handle: "[data-id]",
-    onEnd() {
-      const items = [...list.querySelectorAll<HTMLElement>("[data-id]")]
-        .map((el) => el.dataset.id)
-        .filter((id): id is string => id !== undefined);
-      fetch("/dash/collections/reorder", {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ items }),
-      });
-    },
-  });
-}

package/src/lib/compose-bridge.ts

@@ -1,280 +0,0 @@
-/**
- * Compose Bridge
- *
- * Handles server communication between the Lit compose dialog and the server.
- * Manages file uploads, deferred submit flow, and toast notifications.
- */
-
-import type { ComposeSubmitDetail } from "../ui/components/compose-types.js";
-import type { ComposeAttachment } from "../ui/components/compose-types.js";
-import type { JantComposeDialog } from "../ui/components/jant-compose-dialog.js";
-import type { JantComposeEditor } from "../ui/components/jant-compose-editor.js";
-import { ImageProcessor } from "./image-processor.js";
-import {
-  showToast,
-  showPersistentToast,
-  replaceWithAutoClose,
-} from "./toast.js";
-
-// ── Upload manager ──────────────────────────────────────────────────
-
-/** Track in-flight upload promises keyed by clientId */
-const uploadPromises = new Map<string, Promise<string | null>>();
-
-/** Track attachments removed while their upload is still in flight */
-const removedClientIds = new Set<string>();
-
-/**
- * Upload a single file: process with ImageProcessor, then POST to /api/upload.
- * Returns the mediaId on success, null on failure.
- */
-async function uploadFile(
-  file: File,
-  clientId: string,
-  editor: JantComposeEditor | null,
-): Promise<string | null> {
-  try {
-    // Update status to uploading
-    editor?.updateAttachmentStatus(clientId, "uploading", null, null);
-
-    // Process image (resize, convert to WebP)
-    const processed = await ImageProcessor.processToFile(file);
-
-    // Upload to server
-    const formData = new FormData();
-    formData.append("file", processed);
-
-    const res = await fetch("/api/upload", {
-      method: "POST",
-      body: formData,
-    });
-
-    if (!res.ok) {
-      const data = await res.json();
-      const error = data.error ?? "Upload failed";
-      editor?.updateAttachmentStatus(clientId, "error", null, error);
-      return null;
-    }
-
-    const data = await res.json();
-    const mediaId = data.id as string;
-    editor?.updateAttachmentStatus(clientId, "done", mediaId, null);
-    return mediaId;
-  } catch {
-    editor?.updateAttachmentStatus(clientId, "error", null, "Upload failed");
-    return null;
-  }
-}
-
-function getEditor(): JantComposeEditor | null {
-  return document.querySelector("jant-compose-editor");
-}
-
-// ── Attachment removal handler ───────────────────────────────────────
-
-document.addEventListener("jant:attachment-removed", (e: Event) => {
-  const { clientId, mediaId } = (
-    e as CustomEvent<{ clientId: string; mediaId: string | null }>
-  ).detail;
-
-  if (mediaId) {
-    // Upload already finished — fire-and-forget delete
-    fetch(`/api/upload/${mediaId}`, { method: "DELETE" }).catch(() => {});
-  } else {
-    // Upload still in flight — mark for cleanup after it finishes
-    removedClientIds.add(clientId);
-  }
-});
-
-// ── File selection handler ──────────────────────────────────────────
-
-document.addEventListener("jant:files-selected", (e: Event) => {
-  const event = e as CustomEvent<{
-    files: { file: File; clientId: string }[];
-  }>;
-  const editor = getEditor();
-
-  for (const { file, clientId } of event.detail.files) {
-    const promise = uploadFile(file, clientId, editor).then((mediaId) => {
-      // If the attachment was removed while uploading, delete it immediately
-      if (removedClientIds.has(clientId)) {
-        removedClientIds.delete(clientId);
-        if (mediaId) {
-          fetch(`/api/upload/${mediaId}`, { method: "DELETE" }).catch(() => {});
-        }
-        return null;
-      }
-      return mediaId;
-    });
-    uploadPromises.set(clientId, promise);
-    promise.finally(() => uploadPromises.delete(clientId));
-  }
-});
-
-// ── Submit handler ──────────────────────────────────────────────────
-
-document.addEventListener("jant:compose-submit", async (e: Event) => {
-  const event = e as CustomEvent<ComposeSubmitDetail>;
-  const detail = event.detail;
-  const dialog = document.getElementById(
-    "compose-dialog",
-  ) as HTMLDialogElement | null;
-  const composeEl = document.querySelector(
-    "jant-compose-dialog",
-  ) as JantComposeDialog | null;
-
-  if (!composeEl) return;
-  composeEl.loading = true;
-
-  try {
-    const res = await fetch("/compose", {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Accept: "application/json",
-      },
-      body: JSON.stringify({
-        format: detail.format,
-        title: detail.title || undefined,
-        body: detail.body || undefined,
-        url: detail.url || undefined,
-        quoteText: detail.quoteText || undefined,
-        status: detail.status,
-        rating: detail.rating || undefined,
-        collectionIds:
-          detail.collectionIds.length > 0 ? detail.collectionIds : undefined,
-        mediaIds: detail.mediaIds.length > 0 ? detail.mediaIds : undefined,
-        mediaAlts:
-          Object.keys(detail.mediaAlts).length > 0
-            ? detail.mediaAlts
-            : undefined,
-      }),
-    });
-
-    if (!res.ok) {
-      const data = await res.json();
-      showToast(data.error ?? "Something went wrong", "error");
-      return;
-    }
-
-    const data = await res.json();
-
-    if (data.status === "draft") {
-      showToast(data.toast ?? "Draft saved.");
-    } else if (data.status === "published" && data.cardHtml) {
-      const timeline = document.getElementById("timeline-items");
-      if (timeline) {
-        document.getElementById("empty-timeline")?.remove();
-        timeline.insertAdjacentHTML("afterbegin", data.cardHtml);
-      }
-    }
-
-    dialog?.close();
-    // Prevent browser from restoring focus to the trigger button
-    (document.activeElement as HTMLElement)?.blur();
-    composeEl.reset();
-  } catch {
-    showToast("Something went wrong", "error");
-  } finally {
-    composeEl.loading = false;
-  }
-});
-
-// ── Deferred submit handler ─────────────────────────────────────────
-
-interface DeferredDetail extends ComposeSubmitDetail {
-  pendingAttachments: ComposeAttachment[];
-}
-
-document.addEventListener("jant:compose-submit-deferred", async (e: Event) => {
-  const event = e as CustomEvent<DeferredDetail>;
-  const detail = event.detail;
-  const composeEl = document.querySelector(
-    "jant-compose-dialog",
-  ) as JantComposeDialog | null;
-
-  // Get labels for toast messages
-  const labels = composeEl?.labels;
-  const uploadingMsg = labels?.uploading ?? "Uploading...";
-  const publishedMsg = labels?.published ?? "Published!";
-
-  // Show persistent toast
-  showPersistentToast("compose-deferred", uploadingMsg);
-
-  try {
-    // Wait for all pending uploads to complete
-    const pendingClientIds = detail.pendingAttachments.map((a) => a.clientId);
-    const pendingPromises = pendingClientIds
-      .map((id) => uploadPromises.get(id))
-      .filter((p): p is Promise<string | null> => p !== undefined);
-
-    const results = await Promise.all(pendingPromises);
-
-    // Merge newly completed mediaIds with already-done ones
-    const newMediaIds = results.filter((id): id is string => id !== null);
-    const allMediaIds = [...detail.mediaIds, ...newMediaIds];
-
-    // Merge alt text: for pending attachments that just uploaded,
-    // map their clientId → mediaId and include their alt text
-    const mediaAlts = { ...detail.mediaAlts };
-    for (const att of detail.pendingAttachments) {
-      if (att.alt) {
-        // Find the mediaId from the upload result by matching clientId position
-        const idx = pendingClientIds.indexOf(att.clientId);
-        const mediaId = results[idx];
-        if (mediaId) {
-          mediaAlts[mediaId] = att.alt;
-        }
-      }
-    }
-
-    // POST to /compose
-    const res = await fetch("/compose", {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Accept: "application/json",
-      },
-      body: JSON.stringify({
-        format: detail.format,
-        title: detail.title || undefined,
-        body: detail.body || undefined,
-        url: detail.url || undefined,
-        quoteText: detail.quoteText || undefined,
-        status: detail.status,
-        rating: detail.rating || undefined,
-        collectionIds:
-          detail.collectionIds.length > 0 ? detail.collectionIds : undefined,
-        mediaIds: allMediaIds.length > 0 ? allMediaIds : undefined,
-        mediaAlts: Object.keys(mediaAlts).length > 0 ? mediaAlts : undefined,
-      }),
-    });
-
-    if (!res.ok) {
-      const data = await res.json();
-      replaceWithAutoClose(
-        "compose-deferred",
-        data.error ?? "Something went wrong",
-        "error",
-      );
-      return;
-    }
-
-    const data = await res.json();
-
-    if (data.status === "published" && data.cardHtml) {
-      const timeline = document.getElementById("timeline-items");
-      if (timeline) {
-        document.getElementById("empty-timeline")?.remove();
-        timeline.insertAdjacentHTML("afterbegin", data.cardHtml);
-      }
-    }
-
-    replaceWithAutoClose(
-      "compose-deferred",
-      data.status === "draft" ? (data.toast ?? "Draft saved.") : publishedMsg,
-    );
-  } catch {
-    replaceWithAutoClose("compose-deferred", "Something went wrong", "error");
-  }
-});

package/src/lib/media-upload.ts

@@ -1,148 +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: number): string {
-  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(): HTMLElement {
-  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: string,
-  fileSize: number,
-  statusText: string,
-): HTMLElement {
-  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: HTMLElement,
-  fileName: string,
-  errorMessage: string,
-): void {
-  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: HTMLInputElement,
-  file: File,
-): Promise<void> {
-  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",
-    ) as HTMLInputElement | null;
-    const form = document.getElementById(
-      "upload-form",
-    ) as HTMLFormElement | null;
-    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(): void {
-  document.addEventListener("change", (e) => {
-    const input = (e.target as HTMLElement).closest(
-      "[data-media-upload]",
-    ) as HTMLInputElement | null;
-    if (!input?.files?.[0]) return;
-
-    handleUpload(input, input.files[0]);
-  });
-}
-
-initMediaUpload();

package/src/lib/sqid.ts

@@ -1,79 +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: number): string {
-  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: string): number | null {
-  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: string): boolean {
-  return decode(str) !== null;
-}