@jant/core 0.6.16 → 0.7.0

package/src/client/__tests__/collection-created-notice.test.ts

@@ -1,36 +0,0 @@
-// @vitest-environment happy-dom
-
-import { beforeEach, describe, expect, it } from "vitest";
-import {
-  consumeCollectionCreatedNotice,
-  PENDING_COLLECTION_CREATED_STORAGE_KEY,
-  queueCollectionCreatedNotice,
-} from "../collection-created-notice.js";
-
-describe("collection created notice", () => {
-  beforeEach(() => {
-    globalThis.sessionStorage.clear();
-  });
-
-  it("queues and consumes the newly created Collection ID once", () => {
-    queueCollectionCreatedNotice("col_books");
-
-    expect(
-      globalThis.sessionStorage.getItem(PENDING_COLLECTION_CREATED_STORAGE_KEY),
-    ).toBe('{"collectionId":"col_books"}');
-    expect(consumeCollectionCreatedNotice()).toBe("col_books");
-    expect(consumeCollectionCreatedNotice()).toBeNull();
-  });
-
-  it("clears malformed pending state", () => {
-    globalThis.sessionStorage.setItem(
-      PENDING_COLLECTION_CREATED_STORAGE_KEY,
-      '{"collectionId":false}',
-    );
-
-    expect(consumeCollectionCreatedNotice()).toBeNull();
-    expect(
-      globalThis.sessionStorage.getItem(PENDING_COLLECTION_CREATED_STORAGE_KEY),
-    ).toBeNull();
-  });
-});

package/src/client/__tests__/collection-form-bridge.test.ts

@@ -1,216 +0,0 @@
-// @vitest-environment happy-dom
-
-import { beforeEach, describe, expect, it, vi } from "vitest";
-
-vi.mock("../toast.js", () => ({
-  showToast: vi.fn(),
-}));
-
-vi.mock("../collection-created-notice.js", () => ({
-  queueCollectionCreatedNotice: vi.fn(),
-}));
-
-import "../collection-form-bridge.js";
-
-type CollectionFormHarness = HTMLElement & {
-  cancelHref?: string;
-  initial?: {
-    slug?: string;
-  };
-  loading?: boolean;
-};
-
-function createPageForm(
-  cancelHref = "/collections",
-  initial: CollectionFormHarness["initial"] = { slug: "books" },
-): CollectionFormHarness {
-  document.body.innerHTML = `
-    <div
-      data-collection-editor-page
-      data-collection-editor-save-failed="Couldn't save. Try again in a moment."
-    >
-      <jant-collection-form></jant-collection-form>
-    </div>
-  `;
-
-  const formEl = document.querySelector(
-    "jant-collection-form",
-  ) as CollectionFormHarness | null;
-
-  if (!formEl) {
-    throw new Error("Expected collection form element");
-  }
-
-  formEl.cancelHref = cancelHref;
-  formEl.initial = initial;
-  return formEl;
-}
-
-async function flushAsyncWork() {
-  await new Promise((resolve) => setTimeout(resolve, 0));
-  await new Promise((resolve) => setTimeout(resolve, 0));
-}
-
-describe("collection form bridge", () => {
-  beforeEach(() => {
-    document.body.innerHTML = "";
-    vi.clearAllMocks();
-    vi.restoreAllMocks();
-    window.location.href = "http://localhost/collections/new";
-  });
-
-  it("redirects new collections back to the configured return URL", async () => {
-    const formEl = createPageForm("/collections");
-    const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue(
-      new Response(JSON.stringify({ id: "col_books", slug: "books" }), {
-        status: 201,
-        headers: { "Content-Type": "application/json" },
-      }),
-    );
-
-    formEl.dispatchEvent(
-      new CustomEvent("jant:collection-submit", {
-        bubbles: true,
-        detail: {
-          endpoint: "/api/collections",
-          isEdit: false,
-          data: {
-            title: "Books",
-            slug: "books",
-          },
-        },
-      }),
-    );
-
-    await flushAsyncWork();
-
-    const { queueCollectionCreatedNotice } =
-      await import("../collection-created-notice.js");
-
-    expect(fetchSpy).toHaveBeenCalledWith("/api/collections", {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Accept: "application/json",
-      },
-      body: JSON.stringify({
-        title: "Books",
-        slug: "books",
-      }),
-    });
-    expect(window.location.pathname).toBe("/collections");
-    expect(queueCollectionCreatedNotice).toHaveBeenCalledWith("col_books");
-  });
-
-  it("redirects edited collections back to the collections page when launched from the list", async () => {
-    const formEl = createPageForm("/collections");
-    const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue(
-      new Response(JSON.stringify({ slug: "books-renamed" }), {
-        status: 200,
-        headers: { "Content-Type": "application/json" },
-      }),
-    );
-
-    formEl.dispatchEvent(
-      new CustomEvent("jant:collection-submit", {
-        bubbles: true,
-        detail: {
-          endpoint: "/api/collections/collection-1",
-          isEdit: true,
-          data: {
-            title: "Books renamed",
-            slug: "books-renamed",
-          },
-        },
-      }),
-    );
-
-    await flushAsyncWork();
-
-    expect(fetchSpy).toHaveBeenCalledWith("/api/collections/collection-1", {
-      method: "PUT",
-      headers: {
-        "Content-Type": "application/json",
-        Accept: "application/json",
-      },
-      body: JSON.stringify({
-        title: "Books renamed",
-        slug: "books-renamed",
-      }),
-    });
-    expect(window.location.pathname).toBe("/collections");
-  });
-
-  it("redirects edited collections back to the updated detail page when launched from detail", async () => {
-    window.location.href =
-      "http://localhost/collections/books/edit?returnTo=%2Fbooks";
-    const formEl = createPageForm("/books");
-    vi.spyOn(globalThis, "fetch").mockResolvedValue(
-      new Response(JSON.stringify({ slug: "books-renamed" }), {
-        status: 200,
-        headers: { "Content-Type": "application/json" },
-      }),
-    );
-
-    formEl.dispatchEvent(
-      new CustomEvent("jant:collection-submit", {
-        bubbles: true,
-        detail: {
-          endpoint: "/api/collections/collection-1",
-          isEdit: true,
-          data: {
-            title: "Books renamed",
-            slug: "books-renamed",
-          },
-        },
-      }),
-    );
-
-    await flushAsyncWork();
-
-    expect(window.location.pathname).toBe("/books-renamed");
-  });
-
-  it("rewrites aggregate return paths when a collection slug changes", async () => {
-    window.location.href =
-      "http://localhost/collections/books/edit?returnTo=%2Fcollections%2Fbooks%2Bessays";
-    const formEl = createPageForm("/collections/books+essays", {
-      slug: "books",
-    });
-    const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue(
-      new Response(JSON.stringify({ slug: "books-renamed" }), {
-        status: 200,
-        headers: { "Content-Type": "application/json" },
-      }),
-    );
-
-    formEl.dispatchEvent(
-      new CustomEvent("jant:collection-submit", {
-        bubbles: true,
-        detail: {
-          endpoint: "/api/collections/collection-1",
-          isEdit: true,
-          data: {
-            title: "Books renamed",
-            slug: "books-renamed",
-          },
-        },
-      }),
-    );
-
-    await flushAsyncWork();
-
-    expect(fetchSpy).toHaveBeenCalledWith("/api/collections/collection-1", {
-      method: "PUT",
-      headers: {
-        "Content-Type": "application/json",
-        Accept: "application/json",
-      },
-      body: JSON.stringify({
-        title: "Books renamed",
-        slug: "books-renamed",
-      }),
-    });
-    expect(window.location.pathname).toBe("/collections/books-renamed+essays");
-  });
-});

package/src/client/__tests__/post-form-bridge.test.ts

@@ -1,82 +0,0 @@
-// @vitest-environment happy-dom
-
-import { beforeEach, describe, expect, it, vi } from "vitest";
-import "../post-form-bridge.js";
-import { QUEUED_TOAST_STORAGE_KEY } from "../toast.js";
-
-type PostFormHarness = HTMLElement & {
-  loading: boolean;
-  clearDirty: () => void;
-};
-
-function flushAsyncWork() {
-  return new Promise((resolve) => setTimeout(resolve, 0));
-}
-
-describe("post form bridge", () => {
-  beforeEach(() => {
-    document.body.innerHTML = '<div id="toast-container"></div>';
-    vi.restoreAllMocks();
-    globalThis.sessionStorage.clear();
-  });
-
-  it("queues a success toast before redirecting after publish", async () => {
-    const formEl = document.createElement("jant-post-form") as PostFormHarness;
-    formEl.loading = false;
-    formEl.clearDirty = vi.fn();
-    document.body.appendChild(formEl);
-
-    const locationSpy = vi.spyOn(window.location, "href", "set");
-
-    vi.spyOn(globalThis, "fetch").mockResolvedValue(
-      new Response(
-        JSON.stringify({
-          status: "redirect",
-          url: "http://example.com/published-post",
-        }),
-        {
-          status: 200,
-          headers: { "Content-Type": "application/json" },
-        },
-      ),
-    );
-
-    formEl.dispatchEvent(
-      new CustomEvent("jant:post-submit", {
-        bubbles: true,
-        detail: {
-          endpoint: "/api/posts/post-1",
-          isEdit: false,
-          data: {
-            format: "note",
-            title: "",
-            body: "Published body",
-            status: "published",
-            visibility: "public",
-            pinned: false,
-            url: "",
-            quoteText: "",
-            rating: 0,
-            collectionIds: [],
-            mediaIds: [],
-          },
-          messages: {
-            success: "Published!",
-            error: "Could not publish.",
-          },
-        },
-      }),
-    );
-
-    await flushAsyncWork();
-    await flushAsyncWork();
-
-    expect(formEl.clearDirty).toHaveBeenCalledTimes(1);
-    expect(locationSpy).toHaveBeenCalledWith(
-      "http://example.com/published-post",
-    );
-    expect(globalThis.sessionStorage.getItem(QUEUED_TOAST_STORAGE_KEY)).toBe(
-      '{"message":"Published!","type":"success"}',
-    );
-  });
-});

package/src/client/collection-created-notice.ts

@@ -1,66 +0,0 @@
-/**
- * One-time state passed from the Collection editor to the Collections page.
- */
-
-export const PENDING_COLLECTION_CREATED_STORAGE_KEY =
-  "jant.pendingCollectionCreated";
-
-interface PendingCollectionCreated {
-  collectionId: string;
-}
-
-function canUseSessionStorage(): boolean {
-  try {
-    return typeof globalThis.sessionStorage !== "undefined";
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Queue a Collection ID so the destination page can show an inline next step.
- *
- * @param collectionId - TypeID of the newly created Collection
- * @returns Nothing
- * @example
- * queueCollectionCreatedNotice("col_01abc");
- */
-export function queueCollectionCreatedNotice(collectionId: string): void {
-  const normalizedId = collectionId.trim();
-  if (!normalizedId || !canUseSessionStorage()) return;
-
-  globalThis.sessionStorage.setItem(
-    PENDING_COLLECTION_CREATED_STORAGE_KEY,
-    JSON.stringify({
-      collectionId: normalizedId,
-    } satisfies PendingCollectionCreated),
-  );
-}
-
-/**
- * Consume the queued Collection ID, clearing it whether or not it is valid.
- *
- * @returns The newly created Collection ID, or null when none is available
- * @example
- * const collectionId = consumeCollectionCreatedNotice();
- */
-export function consumeCollectionCreatedNotice(): string | null {
-  if (!canUseSessionStorage()) return null;
-
-  const raw = globalThis.sessionStorage.getItem(
-    PENDING_COLLECTION_CREATED_STORAGE_KEY,
-  );
-  if (!raw) return null;
-
-  globalThis.sessionStorage.removeItem(PENDING_COLLECTION_CREATED_STORAGE_KEY);
-
-  try {
-    const parsed = JSON.parse(raw) as Partial<PendingCollectionCreated>;
-    return typeof parsed.collectionId === "string" &&
-      parsed.collectionId.trim().length > 0
-      ? parsed.collectionId.trim()
-      : null;
-  } catch {
-    return null;
-  }
-}

package/src/client/collection-form-bridge.ts

@@ -1,191 +0,0 @@
-/**
- * Collection Form Bridge
- *
- * Handles full-page collection editor submissions.
- * Quick-create flows inside compose and timeline intercept the same event
- * locally, so only page-level forms reach this bridge.
- */
-
-import type { CollectionSubmitDetail } from "./components/collection-types.js";
-import type { JantCollectionForm } from "./components/jant-collection-form.js";
-import {
-  getCollectionPagePath,
-  getCollectionSelectionPath,
-  getCollectionsDirectoryPath,
-} from "../lib/collection-paths.js";
-import { publicPath } from "./runtime-paths.js";
-import { queueCollectionCreatedNotice } from "./collection-created-notice.js";
-import { showToast } from "./toast.js";
-
-function normalizeLocalHref(href: string): URL | null {
-  try {
-    const url = new URL(href, window.location.origin);
-    if (url.origin !== window.location.origin) return null;
-    return url;
-  } catch {
-    return null;
-  }
-}
-
-function getSitePathPrefix(): string {
-  return document.documentElement.dataset.sitePathPrefix || "";
-}
-
-function toInternalPath(pathname: string): string | null {
-  const sitePathPrefix = getSitePathPrefix();
-  if (!sitePathPrefix) return pathname || "/";
-  if (pathname === sitePathPrefix) return "/";
-  if (pathname.startsWith(`${sitePathPrefix}/`)) {
-    return pathname.slice(sitePathPrefix.length) || "/";
-  }
-  return null;
-}
-
-function replaceCollectionSelectionSlug(
-  slugExpression: string,
-  nextSlug: string,
-  currentSlug: string | undefined,
-): string {
-  const slugs = slugExpression.split("+").filter(Boolean);
-  if (slugs.length === 0) {
-    return nextSlug;
-  }
-
-  if (slugs.length === 1) {
-    return nextSlug;
-  }
-
-  if (!currentSlug) {
-    return slugExpression;
-  }
-
-  let replaced = false;
-  const nextSlugs = slugs.map((slug) => {
-    if (slug !== currentSlug) {
-      return slug;
-    }
-
-    replaced = true;
-    return nextSlug;
-  });
-
-  return replaced ? nextSlugs.join("+") : slugExpression;
-}
-
-function resolveRedirectUrl(
-  detail: CollectionSubmitDetail,
-  formEl: JantCollectionForm,
-  nextSlug: string | undefined,
-): string {
-  const fallbackUrl =
-    formEl.cancelHref || publicPath(getCollectionsDirectoryPath());
-  if (!detail.isEdit) {
-    return fallbackUrl;
-  }
-
-  if (!nextSlug) {
-    return fallbackUrl;
-  }
-
-  const cancelUrl = normalizeLocalHref(fallbackUrl);
-  if (!cancelUrl) {
-    return publicPath(getCollectionPagePath(nextSlug));
-  }
-
-  const internalPath = toInternalPath(cancelUrl.pathname);
-  const currentSlug = formEl.initial?.slug?.trim() || undefined;
-  if (currentSlug && internalPath === getCollectionPagePath(currentSlug)) {
-    cancelUrl.pathname = publicPath(getCollectionPagePath(nextSlug));
-    return `${cancelUrl.pathname}${cancelUrl.search}${cancelUrl.hash}`;
-  }
-
-  const selectionMatch = internalPath?.match(/^\/collections\/([^/]+)$/);
-  if (!selectionMatch) {
-    return `${cancelUrl.pathname}${cancelUrl.search}${cancelUrl.hash}`;
-  }
-
-  const nextSelection = replaceCollectionSelectionSlug(
-    selectionMatch[1],
-    nextSlug,
-    currentSlug,
-  );
-
-  cancelUrl.pathname = publicPath(getCollectionSelectionPath(nextSelection));
-  return `${cancelUrl.pathname}${cancelUrl.search}${cancelUrl.hash}`;
-}
-
-document.addEventListener("jant:collection-submit", async (event: Event) => {
-  const customEvent = event as CustomEvent<CollectionSubmitDetail>;
-  const detail = customEvent.detail;
-  const formEl =
-    customEvent.target instanceof HTMLElement
-      ? (customEvent.target as JantCollectionForm)
-      : document.querySelector<JantCollectionForm>("jant-collection-form");
-  const pageRoot = formEl?.closest<HTMLElement>(
-    "[data-collection-editor-page]",
-  );
-
-  if (!detail?.endpoint || !formEl || !pageRoot) return;
-
-  formEl.loading = true;
-
-  try {
-    const res = await fetch(detail.endpoint, {
-      method: detail.isEdit ? "PUT" : "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Accept: "application/json",
-      },
-      body: JSON.stringify(detail.data),
-    });
-    const json = (await res.json().catch(() => null)) as {
-      id?: string;
-      slug?: string;
-      error?: string;
-    } | null;
-
-    if (!res.ok) {
-      throw new Error(
-        json?.error ||
-          pageRoot.dataset.collectionEditorSaveFailed ||
-          "Couldn't save. Try again in a moment.",
-      );
-    }
-
-    const redirectUrl = resolveRedirectUrl(
-      detail,
-      formEl,
-      typeof json?.slug === "string" && json.slug.length > 0
-        ? json.slug
-        : undefined,
-    );
-
-    if (!detail.isEdit) {
-      const collectionId =
-        typeof json?.id === "string" && json.id.length > 0
-          ? json.id
-          : undefined;
-      const destination = normalizeLocalHref(redirectUrl);
-      const destinationPath = destination
-        ? toInternalPath(destination.pathname)
-        : null;
-
-      if (collectionId && destinationPath === getCollectionsDirectoryPath()) {
-        queueCollectionCreatedNotice(collectionId);
-      }
-    }
-
-    window.location.href = redirectUrl;
-    return;
-  } catch (error) {
-    showToast(
-      error instanceof Error
-        ? error.message
-        : pageRoot.dataset.collectionEditorSaveFailed ||
-            "Couldn't save. Try again in a moment.",
-      "error",
-    );
-  } finally {
-    formEl.loading = false;
-  }
-});