@gigamusic/links 0.2.0 → 1.0.0

package/src/cli/sync.ts

@@ -1,169 +0,0 @@
-import {
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  readdirSync,
-  statSync,
-  writeFileSync,
-} from "node:fs";
-import { join, resolve } from "node:path";
-
-export interface SyncOptions {
-  /** Where the consumer's prisma schema folder lives. Defaults to `<cwd>/prisma/schema`. */
-  target?: string;
-  /** When true, log planned writes without touching the filesystem. */
-  dryRun?: boolean;
-  /** Override for testing — defaults to process.cwd(). */
-  cwd?: string;
-}
-
-export interface SyncResult {
-  written: string[];
-  skipped: { file: string; reason: string }[];
-}
-
-export interface SyncDeps {
-  sourceDir: string;
-  version: string;
-  today?: string;
-  logger?: { info: (msg: string) => void; warn: (msg: string) => void };
-}
-
-/**
- * Sync prefix — `20-` orders after `10-` (gigamusic/db) and before `99-`
- * (consumer-owned). Keeping the prefix shared with @gigamusic/db's sort
- * convention so consumers don't need to learn a new rule.
- */
-const SYNC_PREFIX = "20-";
-
-const VERSION_RE = /AUTOGENERATED by @gigamusic\/links@([^\s]+) on (\d{4}-\d{2}-\d{2})/;
-
-export function listFragmentFiles(sourceDir: string): string[] {
-  return readdirSync(sourceDir)
-    .filter((f) => f.endsWith(".prisma") && !f.startsWith("_"))
-    .sort();
-}
-
-function buildHeader(version: string, today: string): string {
-  return `// AUTOGENERATED by @gigamusic/links@${version} on ${today} — do not edit; re-run \`pnpm gigamusic-links sync\`\n`;
-}
-
-function readExistingVersion(filePath: string): string | null {
-  if (!existsSync(filePath)) return null;
-  const head = readFileSync(filePath, "utf8").split("\n", 2).join("\n");
-  const match = VERSION_RE.exec(head);
-  return match?.[1] ?? null;
-}
-
-/**
- * Semver-ish comparison — accepts `x.y.z` or pre-release suffixes. Returns
- * 1/0/-1 like `Array.prototype.sort`. Workspace `workspace:*` and similar
- * non-numeric strings compare equal so we never refuse to overwrite during
- * local dev.
- */
-export function compareVersions(a: string, b: string): number {
-  if (a === b) return 0;
-  const aParts = a.split(/[.-]/);
-  const bParts = b.split(/[.-]/);
-  const len = Math.max(aParts.length, bParts.length);
-  for (let i = 0; i < len; i++) {
-    const ai = parseInt(aParts[i] ?? "0", 10);
-    const bi = parseInt(bParts[i] ?? "0", 10);
-    if (Number.isNaN(ai) || Number.isNaN(bi)) {
-      const as = aParts[i] ?? "";
-      const bs = bParts[i] ?? "";
-      if (as === bs) continue;
-      return as < bs ? -1 : 1;
-    }
-    if (ai !== bi) return ai < bi ? -1 : 1;
-  }
-  return 0;
-}
-
-export function syncFragments(opts: SyncOptions, deps: SyncDeps): SyncResult {
-  const cwd = opts.cwd ?? process.cwd();
-  const target = resolve(cwd, opts.target ?? join("prisma", "schema"));
-  const today = deps.today ?? new Date().toISOString().slice(0, 10);
-  const logger = deps.logger ?? console;
-  const header = buildHeader(deps.version, today);
-
-  const written: string[] = [];
-  const skipped: { file: string; reason: string }[] = [];
-
-  if (!opts.dryRun) {
-    mkdirSync(target, { recursive: true });
-  } else if (!existsSync(target) || !statSync(target).isDirectory()) {
-    logger.info(`(dry-run) would create directory ${target}`);
-  }
-
-  for (const file of listFragmentFiles(deps.sourceDir)) {
-    const srcPath = join(deps.sourceDir, file);
-    const destPath = join(target, `${SYNC_PREFIX}${file}`);
-    const existingVersion = readExistingVersion(destPath);
-
-    if (existingVersion && compareVersions(existingVersion, deps.version) > 0) {
-      skipped.push({
-        file: destPath,
-        reason: `existing version ${existingVersion} is newer than installed ${deps.version}`,
-      });
-      logger.warn(
-        `skip ${destPath} — existing v${existingVersion} is newer than installed v${deps.version}`,
-      );
-      continue;
-    }
-
-    const body = readFileSync(srcPath, "utf8");
-    const contents = header + body;
-
-    if (opts.dryRun) {
-      logger.info(`(dry-run) would write ${destPath}`);
-    } else {
-      writeFileSync(destPath, contents, "utf8");
-      logger.info(`wrote ${destPath}`);
-    }
-    written.push(destPath);
-  }
-
-  return { written, skipped };
-}
-
-export interface DoctorOptions {
-  target?: string;
-  cwd?: string;
-}
-
-export interface DoctorResult {
-  ok: boolean;
-  stale: { file: string; installed: string; found: string }[];
-  missing: string[];
-}
-
-export function doctorFragments(opts: DoctorOptions, deps: SyncDeps): DoctorResult {
-  const cwd = opts.cwd ?? process.cwd();
-  const target = resolve(cwd, opts.target ?? join("prisma", "schema"));
-  const stale: { file: string; installed: string; found: string }[] = [];
-  const missing: string[] = [];
-  const logger = deps.logger ?? console;
-
-  for (const file of listFragmentFiles(deps.sourceDir)) {
-    const destPath = join(target, `${SYNC_PREFIX}${file}`);
-    const existingVersion = readExistingVersion(destPath);
-    if (existingVersion === null) {
-      missing.push(destPath);
-      logger.warn(`missing: ${destPath}`);
-      continue;
-    }
-    if (compareVersions(existingVersion, deps.version) < 0) {
-      stale.push({
-        file: destPath,
-        installed: deps.version,
-        found: existingVersion,
-      });
-      logger.warn(
-        `stale: ${destPath} is v${existingVersion}; installed @gigamusic/links is v${deps.version}`,
-      );
-    }
-  }
-
-  return { ok: stale.length === 0 && missing.length === 0, stale, missing };
-}

package/src/client.ts

@@ -1,10 +0,0 @@
-"use client";
-
-// Client-only entry — components that use React context or browser APIs.
-export { LinksSlotsProvider, useLinksSlot, defaultLinkSlots } from "./slots-context";
-export { LinkPageView } from "./components/LinkPageView";
-export { DefaultLinkButton } from "./components/LinkButton";
-export { DefaultLinkPageHeader } from "./components/LinkPageHeader";
-export { LinkPageForm } from "./components/admin/LinkPageForm";
-export { NewLinkPageForm } from "./components/admin/NewLinkPageForm";
-export { DeleteLinkPageButton } from "./components/admin/DeleteLinkPageButton";

package/src/components/LinkButton.tsx

@@ -1,20 +0,0 @@
-import { LinkPlatformIcon } from "../platforms/icon";
-import type { LinkButtonProps } from "../slots";
-
-/**
- * Default link-button: a pill anchor with the platform icon (if known) and the
- * link title. External URLs open in a new tab; same-origin URLs stay in-tab.
- * Consumers can override via `<GigamusicProvider components={{ LinkButton: ... }}>`.
- */
-export function DefaultLinkButton({ href, title, platform, internal }: LinkButtonProps) {
-  return (
-    <a
-      href={href}
-      {...(!internal && { target: "_blank", rel: "noopener noreferrer" })}
-      className="flex items-center justify-center gap-3 w-full py-3.5 px-4 rounded-full border border-[var(--gm-color-primary)]/30 bg-[var(--gm-color-primary)]/10 backdrop-blur-sm text-[color:var(--gm-color-foreground,white)] font-medium text-sm uppercase tracking-wide hover:bg-[var(--gm-color-primary)]/20 hover:border-[var(--gm-color-primary)]/60 transition-all duration-200"
-    >
-      {platform && <LinkPlatformIcon platform={platform} size={18} />}
-      <span>{title}</span>
-    </a>
-  );
-}

package/src/components/LinkPageHeader.tsx

@@ -1,35 +0,0 @@
-import type { LinkPageHeaderProps } from "../slots";
-
-/**
- * Default header for `LinkPageView`: optional cover image, page title, and
- * description. Consumers can override via `<GigamusicProvider components={{
- * LinkPageHeader: ... }}>` to swap in a logo, custom typography, etc.
- */
-export function DefaultLinkPageHeader({ title, description, cover }: LinkPageHeaderProps) {
-  return (
-    <>
-      {cover && (
-        <div className="w-36 h-36 sm:w-44 sm:h-44 rounded-2xl overflow-hidden ring-2 ring-white/20">
-          {/* Plain <img> to keep the component framework-agnostic; consumers
-              wanting next/image can override this slot. */}
-          {/* eslint-disable-next-line @next/next/no-img-element */}
-          <img
-            src={cover.src}
-            alt={cover.alt}
-            width={400}
-            height={400}
-            className="w-full h-full object-cover"
-            loading="eager"
-            decoding="async"
-          />
-        </div>
-      )}
-      <div className="text-center">
-        <h1 className="text-2xl font-semibold tracking-tight">{title}</h1>
-        {description && (
-          <p className="text-white/60 text-sm mt-1 whitespace-pre-line">{description}</p>
-        )}
-      </div>
-    </>
-  );
-}

package/src/components/LinkPageView.tsx

@@ -1,64 +0,0 @@
-"use client";
-
-import { detectLinkPlatform } from "../platforms/detect";
-import { isInternalUrl } from "./url-helpers";
-import { useLinksSlot } from "../slots-context";
-import type { LinkPageWithItems } from "../types";
-import type { LinksSlots } from "../slots";
-
-interface LinkPageViewProps {
-  page: LinkPageWithItems;
-  /**
-   * Per-call slot overrides. Most consumers register slots once on
-   * `<LinksSlotsProvider>` and omit this prop. Keys not present here fall
-   * back to the provider, then to the package defaults.
-   */
-  slots?: Partial<LinksSlots>;
-}
-
-/**
- * Public-facing render of a `LinkPage`. Renders the resolved cover, header,
- * and a vertical list of link buttons. Slots:
- *  - `LinkButton` — the rendered pill for each item.
- *  - `LinkPageHeader` — the title block above the buttons.
- *
- * Cover image resolution: explicit `page.coverImageUrl` override → linked
- * release's `coverImageUrl` (only when the release is published, to avoid
- * leaking a draft's art) → `null`.
- */
-export function LinkPageView({ page, slots }: LinkPageViewProps) {
-  const providerHeader = useLinksSlot("LinkPageHeader");
-  const providerButton = useLinksSlot("LinkButton");
-  const Header = slots?.LinkPageHeader ?? providerHeader;
-  const LinkButton = slots?.LinkButton ?? providerButton;
-
-  const releaseCover = page.release?.isPublished
-    ? page.release.coverImageUrl
-    : null;
-  const coverSrc = page.coverImageUrl ?? releaseCover ?? null;
-  const cover = coverSrc ? { src: coverSrc, alt: page.title } : null;
-
-  return (
-    <div className="min-h-dvh flex items-start justify-center px-4 py-10">
-      <div className="w-full max-w-md flex flex-col items-center gap-5">
-        <Header title={page.title} description={page.description} cover={cover} />
-
-        <div className="w-full flex flex-col gap-3 mt-2">
-          {page.items.map((item) => {
-            const platform = detectLinkPlatform(item.url);
-            const internal = isInternalUrl(item.url);
-            return (
-              <LinkButton
-                key={item.id}
-                href={item.url}
-                title={item.title}
-                platform={platform}
-                internal={internal}
-              />
-            );
-          })}
-        </div>
-      </div>
-    </div>
-  );
-}

package/src/components/admin/DeleteLinkPageButton.tsx

@@ -1,52 +0,0 @@
-"use client";
-
-import { useState } from "react";
-import { useRouter } from "next/navigation";
-
-interface Props {
-  pageId: number;
-  pageTitle: string;
-  redirectOnDelete?: boolean;
-}
-
-/**
- * Confirm-then-delete control for a single link page. POSTs DELETE to the
- * admin route the consumer mounted from `createAdminLinkPageByIdHandlers`.
- * Set `redirectOnDelete` when used from the edit page so the user lands back
- * on the index after a successful delete.
- */
-export function DeleteLinkPageButton({
-  pageId,
-  pageTitle,
-  redirectOnDelete,
-}: Props) {
-  const router = useRouter();
-  const [deleting, setDeleting] = useState(false);
-
-  async function handleDelete() {
-    if (!confirm(`Delete "${pageTitle}"? Its public URL will return 404.`)) return;
-    setDeleting(true);
-    const res = await fetch(`/api/admin/link-pages/${pageId}`, { method: "DELETE" });
-    if (!res.ok) {
-      setDeleting(false);
-      alert("Failed to delete link page");
-      return;
-    }
-    if (redirectOnDelete) {
-      router.push("/admin/link-pages");
-    } else {
-      router.refresh();
-    }
-  }
-
-  return (
-    <button
-      type="button"
-      onClick={handleDelete}
-      disabled={deleting}
-      className="text-sm rounded-md px-2.5 py-1 text-destructive hover:bg-destructive/10 disabled:opacity-50"
-    >
-      {deleting ? "Deleting..." : "Delete"}
-    </button>
-  );
-}