@gigamusic/links 0.1.0

package/README.md

@@ -0,0 +1,34 @@
+# @gigamusic/links
+
+Linktree-style per-release link pages for `@gigamusic/*` artist sites. Ships its own Prisma fragment (`LinkPage`, `LinkPageItem`), a public `LinkPageView` component, admin page bodies + form, admin API handler factories, and platform-detection helpers.
+
+## Install
+
+```ts
+import {
+  createLinkPageQueries,
+  LinkPageView,
+  createPublicLinkPage,
+  createAdminLinkPagesHandlers,
+  detectLinkPlatform,
+  LinkPlatformIcon,
+} from "@gigamusic/links";
+```
+
+The package is source-shipped — add `@gigamusic/links` to `transpilePackages` in your `next.config.ts` (the create-gigamusic-app scaffold does this automatically).
+
+## Prisma fragment
+
+Run `gigamusic-links sync` to copy the `link-page.prisma` fragment into `prisma/schema/20-link-page.prisma`. Run after every `@gigamusic/links` upgrade; `gigamusic-links doctor` checks for staleness.
+
+The fragment references the `Release` model owned by `@gigamusic/db`. Prisma requires both sides of a relation to be declared, so consumers must add the inverse on their copy of `Release`:
+
+```prisma
+// prisma/schema/99-app.prisma (or wherever your Release lives)
+model Release {
+  // ...existing fields...
+  linkPages LinkPage[]
+}
+```
+
+If your `Release` is shipped verbatim from `@gigamusic/db`'s `10-release.prisma`, add a thin override file at `99-release-link-pages.prisma` that re-declares the model with the extra field, or extend the upstream fragment when re-syncing.

package/dist/cli.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+import { readFileSync, mkdirSync, existsSync, statSync, writeFileSync, readdirSync } from 'fs';
+import { dirname, resolve, join } from 'path';
+import { fileURLToPath } from 'url';
+
+function fragmentsDir(metaUrl) {
+  const here = dirname(fileURLToPath(metaUrl));
+  return resolve(here, "..", "prisma");
+}
+var SYNC_PREFIX = "20-";
+var VERSION_RE = /AUTOGENERATED by @gigamusic\/links@([^\s]+) on (\d{4}-\d{2}-\d{2})/;
+function listFragmentFiles(sourceDir) {
+  return readdirSync(sourceDir).filter((f) => f.endsWith(".prisma") && !f.startsWith("_")).sort();
+}
+function buildHeader(version, today) {
+  return `// AUTOGENERATED by @gigamusic/links@${version} on ${today} \u2014 do not edit; re-run \`pnpm gigamusic-links sync\`
+`;
+}
+function readExistingVersion(filePath) {
+  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;
+}
+function compareVersions(a, b) {
+  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;
+}
+function syncFragments(opts, deps) {
+  const cwd = opts.cwd ?? process.cwd();
+  const target = resolve(cwd, opts.target ?? join("prisma", "schema"));
+  const today = deps.today ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const logger = deps.logger ?? console;
+  const header = buildHeader(deps.version, today);
+  const written = [];
+  const skipped = [];
+  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} \u2014 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 };
+}
+function doctorFragments(opts, deps) {
+  const cwd = opts.cwd ?? process.cwd();
+  const target = resolve(cwd, opts.target ?? join("prisma", "schema"));
+  const stale = [];
+  const missing = [];
+  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 };
+}
+
+// src/cli/index.ts
+function parseArgs(argv) {
+  const [command = "help", ...rest] = argv;
+  const parsed = {
+    command: ["sync", "doctor", "help", "version"].includes(command) ? command : "help",
+    dryRun: false
+  };
+  for (let i = 0; i < rest.length; i++) {
+    const arg = rest[i];
+    if (arg === "--dry-run") parsed.dryRun = true;
+    else if (arg === "--target") parsed.target = rest[++i];
+    else if (arg?.startsWith("--target=")) parsed.target = arg.slice("--target=".length);
+  }
+  return parsed;
+}
+function readPackageVersion(metaUrl) {
+  try {
+    const pkgPath = resolve(fragmentsDir(metaUrl), "..", "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    return pkg.version ?? "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+function printHelp() {
+  console.log(`gigamusic-links \u2014 Prisma fragment sync for @gigamusic/links
+
+Usage:
+  gigamusic-links sync   [--target <prismaSchemaFolder>] [--dry-run]
+  gigamusic-links doctor [--target <prismaSchemaFolder>]
+  gigamusic-links version
+  gigamusic-links help
+
+Fragments are written with a "20-" prefix so they sort AFTER @gigamusic/db's
+"10-" fragments and BEFORE consumer-owned "99-" files. Default --target is
+./prisma/schema (Prisma 6 prismaSchemaFolder layout).
+`);
+}
+async function main(argv, metaUrl) {
+  const args = parseArgs(argv);
+  const sourceDir = fragmentsDir(metaUrl);
+  const version = readPackageVersion(metaUrl);
+  if (args.command === "help") {
+    printHelp();
+    return 0;
+  }
+  if (args.command === "version") {
+    console.log(version);
+    return 0;
+  }
+  if (args.command === "sync") {
+    syncFragments(
+      { target: args.target, dryRun: args.dryRun },
+      { sourceDir, version }
+    );
+    return 0;
+  }
+  if (args.command === "doctor") {
+    const result = doctorFragments({ target: args.target }, { sourceDir, version });
+    if (!result.ok) {
+      console.error(
+        `gigamusic-links doctor: ${result.stale.length} stale, ${result.missing.length} missing`
+      );
+      return 1;
+    }
+    console.log("gigamusic-links doctor: all fragments are up to date.");
+    return 0;
+  }
+  printHelp();
+  return 1;
+}
+main(process.argv.slice(2), import.meta.url).then(
+  (code) => process.exit(code),
+  (err) => {
+    console.error(err);
+    process.exit(1);
+  }
+);
+
+export { main };
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/paths.ts","../src/cli/sync.ts","../src/cli/index.ts"],"names":["resolve","readFileSync"],"mappings":"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","file":"cli.js","sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport { dirname, resolve } from \"node:path\";\n\n/**\n * Locate the shipped `prisma/` fragments directory. At runtime the CLI bundle\n * lives at `<pkg>/dist/cli.js`; the fragments live at `<pkg>/prisma/`.\n */\nexport function fragmentsDir(metaUrl: string): string {\n  const here = dirname(fileURLToPath(metaUrl));\n  return resolve(here, \"..\", \"prisma\");\n}\n","import {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  readdirSync,\n  statSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { join, resolve } from \"node:path\";\n\nexport interface SyncOptions {\n  /** Where the consumer's prisma schema folder lives. Defaults to `<cwd>/prisma/schema`. */\n  target?: string;\n  /** When true, log planned writes without touching the filesystem. */\n  dryRun?: boolean;\n  /** Override for testing — defaults to process.cwd(). */\n  cwd?: string;\n}\n\nexport interface SyncResult {\n  written: string[];\n  skipped: { file: string; reason: string }[];\n}\n\nexport interface SyncDeps {\n  sourceDir: string;\n  version: string;\n  today?: string;\n  logger?: { info: (msg: string) => void; warn: (msg: string) => void };\n}\n\n/**\n * Sync prefix — `20-` orders after `10-` (gigamusic/db) and before `99-`\n * (consumer-owned). Keeping the prefix shared with @gigamusic/db's sort\n * convention so consumers don't need to learn a new rule.\n */\nconst SYNC_PREFIX = \"20-\";\n\nconst VERSION_RE = /AUTOGENERATED by @gigamusic\\/links@([^\\s]+) on (\\d{4}-\\d{2}-\\d{2})/;\n\nexport function listFragmentFiles(sourceDir: string): string[] {\n  return readdirSync(sourceDir)\n    .filter((f) => f.endsWith(\".prisma\") && !f.startsWith(\"_\"))\n    .sort();\n}\n\nfunction buildHeader(version: string, today: string): string {\n  return `// AUTOGENERATED by @gigamusic/links@${version} on ${today} — do not edit; re-run \\`pnpm gigamusic-links sync\\`\\n`;\n}\n\nfunction readExistingVersion(filePath: string): string | null {\n  if (!existsSync(filePath)) return null;\n  const head = readFileSync(filePath, \"utf8\").split(\"\\n\", 2).join(\"\\n\");\n  const match = VERSION_RE.exec(head);\n  return match?.[1] ?? null;\n}\n\n/**\n * Semver-ish comparison — accepts `x.y.z` or pre-release suffixes. Returns\n * 1/0/-1 like `Array.prototype.sort`. Workspace `workspace:*` and similar\n * non-numeric strings compare equal so we never refuse to overwrite during\n * local dev.\n */\nexport function compareVersions(a: string, b: string): number {\n  if (a === b) return 0;\n  const aParts = a.split(/[.-]/);\n  const bParts = b.split(/[.-]/);\n  const len = Math.max(aParts.length, bParts.length);\n  for (let i = 0; i < len; i++) {\n    const ai = parseInt(aParts[i] ?? \"0\", 10);\n    const bi = parseInt(bParts[i] ?? \"0\", 10);\n    if (Number.isNaN(ai) || Number.isNaN(bi)) {\n      const as = aParts[i] ?? \"\";\n      const bs = bParts[i] ?? \"\";\n      if (as === bs) continue;\n      return as < bs ? -1 : 1;\n    }\n    if (ai !== bi) return ai < bi ? -1 : 1;\n  }\n  return 0;\n}\n\nexport function syncFragments(opts: SyncOptions, deps: SyncDeps): SyncResult {\n  const cwd = opts.cwd ?? process.cwd();\n  const target = resolve(cwd, opts.target ?? join(\"prisma\", \"schema\"));\n  const today = deps.today ?? new Date().toISOString().slice(0, 10);\n  const logger = deps.logger ?? console;\n  const header = buildHeader(deps.version, today);\n\n  const written: string[] = [];\n  const skipped: { file: string; reason: string }[] = [];\n\n  if (!opts.dryRun) {\n    mkdirSync(target, { recursive: true });\n  } else if (!existsSync(target) || !statSync(target).isDirectory()) {\n    logger.info(`(dry-run) would create directory ${target}`);\n  }\n\n  for (const file of listFragmentFiles(deps.sourceDir)) {\n    const srcPath = join(deps.sourceDir, file);\n    const destPath = join(target, `${SYNC_PREFIX}${file}`);\n    const existingVersion = readExistingVersion(destPath);\n\n    if (existingVersion && compareVersions(existingVersion, deps.version) > 0) {\n      skipped.push({\n        file: destPath,\n        reason: `existing version ${existingVersion} is newer than installed ${deps.version}`,\n      });\n      logger.warn(\n        `skip ${destPath} — existing v${existingVersion} is newer than installed v${deps.version}`,\n      );\n      continue;\n    }\n\n    const body = readFileSync(srcPath, \"utf8\");\n    const contents = header + body;\n\n    if (opts.dryRun) {\n      logger.info(`(dry-run) would write ${destPath}`);\n    } else {\n      writeFileSync(destPath, contents, \"utf8\");\n      logger.info(`wrote ${destPath}`);\n    }\n    written.push(destPath);\n  }\n\n  return { written, skipped };\n}\n\nexport interface DoctorOptions {\n  target?: string;\n  cwd?: string;\n}\n\nexport interface DoctorResult {\n  ok: boolean;\n  stale: { file: string; installed: string; found: string }[];\n  missing: string[];\n}\n\nexport function doctorFragments(opts: DoctorOptions, deps: SyncDeps): DoctorResult {\n  const cwd = opts.cwd ?? process.cwd();\n  const target = resolve(cwd, opts.target ?? join(\"prisma\", \"schema\"));\n  const stale: { file: string; installed: string; found: string }[] = [];\n  const missing: string[] = [];\n  const logger = deps.logger ?? console;\n\n  for (const file of listFragmentFiles(deps.sourceDir)) {\n    const destPath = join(target, `${SYNC_PREFIX}${file}`);\n    const existingVersion = readExistingVersion(destPath);\n    if (existingVersion === null) {\n      missing.push(destPath);\n      logger.warn(`missing: ${destPath}`);\n      continue;\n    }\n    if (compareVersions(existingVersion, deps.version) < 0) {\n      stale.push({\n        file: destPath,\n        installed: deps.version,\n        found: existingVersion,\n      });\n      logger.warn(\n        `stale: ${destPath} is v${existingVersion}; installed @gigamusic/links is v${deps.version}`,\n      );\n    }\n  }\n\n  return { ok: stale.length === 0 && missing.length === 0, stale, missing };\n}\n","import { readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { fragmentsDir } from \"./paths\";\nimport { doctorFragments, syncFragments } from \"./sync\";\n\ninterface ParsedArgs {\n  command: \"sync\" | \"doctor\" | \"help\" | \"version\";\n  target?: string;\n  dryRun: boolean;\n}\n\nfunction parseArgs(argv: string[]): ParsedArgs {\n  const [command = \"help\", ...rest] = argv;\n  const parsed: ParsedArgs = {\n    command: ([\"sync\", \"doctor\", \"help\", \"version\"].includes(command)\n      ? command\n      : \"help\") as ParsedArgs[\"command\"],\n    dryRun: false,\n  };\n  for (let i = 0; i < rest.length; i++) {\n    const arg = rest[i];\n    if (arg === \"--dry-run\") parsed.dryRun = true;\n    else if (arg === \"--target\") parsed.target = rest[++i];\n    else if (arg?.startsWith(\"--target=\")) parsed.target = arg.slice(\"--target=\".length);\n  }\n  return parsed;\n}\n\nfunction readPackageVersion(metaUrl: string): string {\n  try {\n    const pkgPath = resolve(fragmentsDir(metaUrl), \"..\", \"package.json\");\n    const pkg = JSON.parse(readFileSync(pkgPath, \"utf8\")) as { version?: string };\n    return pkg.version ?? \"0.0.0\";\n  } catch {\n    return \"0.0.0\";\n  }\n}\n\nfunction printHelp() {\n  console.log(`gigamusic-links — Prisma fragment sync for @gigamusic/links\n\nUsage:\n  gigamusic-links sync   [--target <prismaSchemaFolder>] [--dry-run]\n  gigamusic-links doctor [--target <prismaSchemaFolder>]\n  gigamusic-links version\n  gigamusic-links help\n\nFragments are written with a \"20-\" prefix so they sort AFTER @gigamusic/db's\n\"10-\" fragments and BEFORE consumer-owned \"99-\" files. Default --target is\n./prisma/schema (Prisma 6 prismaSchemaFolder layout).\n`);\n}\n\nexport async function main(argv: string[], metaUrl: string): Promise<number> {\n  const args = parseArgs(argv);\n  const sourceDir = fragmentsDir(metaUrl);\n  const version = readPackageVersion(metaUrl);\n\n  if (args.command === \"help\") {\n    printHelp();\n    return 0;\n  }\n  if (args.command === \"version\") {\n    console.log(version);\n    return 0;\n  }\n  if (args.command === \"sync\") {\n    syncFragments(\n      { target: args.target, dryRun: args.dryRun },\n      { sourceDir, version },\n    );\n    return 0;\n  }\n  if (args.command === \"doctor\") {\n    const result = doctorFragments({ target: args.target }, { sourceDir, version });\n    if (!result.ok) {\n      console.error(\n        `gigamusic-links doctor: ${result.stale.length} stale, ${result.missing.length} missing`,\n      );\n      return 1;\n    }\n    console.log(\"gigamusic-links doctor: all fragments are up to date.\");\n    return 0;\n  }\n  printHelp();\n  return 1;\n}\n\nmain(process.argv.slice(2), import.meta.url).then(\n  (code) => process.exit(code),\n  (err) => {\n    console.error(err);\n    process.exit(1);\n  },\n);\n"]}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@gigamusic/links",
+  "version": "0.1.0",
+  "description": "Editable Linktree-style link pages for gigamusic artist sites. Ships a Prisma fragment, public + admin React components, admin API handler factories, and platform-detection helpers.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gigamesh/gigamusic.git",
+    "directory": "packages/links"
+  },
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./client": {
+      "types": "./src/client.ts",
+      "default": "./src/client.ts"
+    },
+    "./server": {
+      "types": "./src/server.ts",
+      "default": "./src/server.ts"
+    }
+  },
+  "bin": {
+    "gigamusic-links": "./dist/cli.js"
+  },
+  "files": [
+    "src",
+    "prisma",
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@gigamusic/config": "0.1.0",
+    "@gigamusic/core": "0.1.0",
+    "@gigamusic/db": "0.1.0",
+    "@gigamusic/ui": "0.1.0"
+  },
+  "peerDependencies": {
+    "@prisma/client": ">=6",
+    "next": ">=15",
+    "react": ">=18 <20",
+    "react-dom": ">=18 <20"
+  },
+  "devDependencies": {
+    "@prisma/client": "^6.1.0",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/react": "^16.1.0",
+    "@types/node": "^22.10.5",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "jsdom": "^25.0.1",
+    "next": "^16.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "pnpm run prisma:generate && tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src",
+    "test": "pnpm run prisma:generate && vitest run",
+    "typecheck": "pnpm run prisma:generate && tsc --noEmit",
+    "prisma:generate": "prisma generate --schema=./prisma",
+    "clean": "rm -rf dist .turbo *.tsbuildinfo"
+  }
+}

package/prisma/_typegen.prisma

@@ -0,0 +1,29 @@
+// Internal — exists ONLY so `prisma generate --schema=./prisma` in THIS
+// package can produce a PrismaClient with LinkPage + LinkPageItem on the
+// delegate. The `gigamusic-links sync` CLI skips files starting with `_`,
+// so this is never copied into a consumer app. The consumer's merged
+// schema gets `Release` from `@gigamusic/db`; here we declare a minimal
+// stub so the link-page.prisma relation compiles in isolation.
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+generator client {
+  provider      = "prisma-client-js"
+  binaryTargets = ["native"]
+}
+
+/// Minimal stub of @gigamusic/db's `Release` model — only the fields this
+/// package's queries select. The consumer's merged schema redefines `Release`
+/// with all its fields; this stub only needs to satisfy the link-page relation
+/// and the columns we read.
+model Release {
+  id            Int        @id @default(autoincrement())
+  name          String
+  slug          String     @unique
+  coverImageUrl String?
+  isPublished   Boolean    @default(false)
+  linkPages     LinkPage[]
+}

package/prisma/link-page.prisma

@@ -0,0 +1,54 @@
+// gigamusic link-page schema fragment
+//
+// Shipped by `@gigamusic/links` and copied into a consumer app's
+// `prisma/schema/` directory by `gigamusic-links sync` with a `20-` prefix
+// (after `10-` fragments from @gigamusic/db, before consumer-owned `99-`).
+//
+// `LinkPage` references the `Release` model from @gigamusic/db via the
+// `releaseId` scalar foreign key. Prisma requires *both* sides of every
+// relation to be declared, so for the `release Release?` relation to compile
+// the consumer must extend the upstream `Release` model with:
+//
+//     model Release {
+//       // ...existing fields...
+//       linkPages LinkPage[]
+//     }
+//
+// The demo + create-gigamusic-app scaffolding wire this up automatically.
+//
+// Reserved model names: LinkPage, LinkPageItem
+// Reserved table names: link_pages, link_page_items
+
+model LinkPage {
+  id            Int      @id @default(autoincrement())
+  slug          String   @unique
+  title         String
+  description   String?
+  coverImageUrl String?
+  releaseId     Int?
+  isPublished   Boolean  @default(true)
+  createdAt     DateTime @default(now())
+  updatedAt     DateTime @updatedAt
+
+  release Release?       @relation(fields: [releaseId], references: [id], onDelete: SetNull)
+  items   LinkPageItem[]
+
+  @@index([releaseId])
+  @@map("link_pages")
+}
+
+model LinkPageItem {
+  id        Int      @id @default(autoincrement())
+  pageId    Int
+  title     String
+  url       String
+  position  Int      @default(0)
+  isVisible Boolean  @default(true)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  page LinkPage @relation(fields: [pageId], references: [id], onDelete: Cascade)
+
+  @@index([pageId])
+  @@map("link_page_items")
+}

package/src/api/auth.ts

@@ -0,0 +1,34 @@
+import { verifyAdminSessionToken } from "@gigamusic/core";
+
+const ADMIN_SESSION_COOKIE = "admin_session";
+
+/**
+ * Stateless cookie verification for route handlers. Mirrors
+ * `@gigamusic/admin`'s `verifyAdminSession` so consumers can wire both
+ * packages to the same session secret without coupling them at the package
+ * level.
+ */
+export async function verifyAdminSession(
+  req: Request,
+  adminSessionSecret: string,
+): Promise<boolean> {
+  const header = req.headers.get("cookie");
+  if (!header) return false;
+  const token = parseCookieHeader(header, ADMIN_SESSION_COOKIE);
+  if (!token) return false;
+  try {
+    await verifyAdminSessionToken(token, adminSessionSecret);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function parseCookieHeader(header: string, name: string): string | null {
+  for (const raw of header.split(";")) {
+    const trimmed = raw.trim();
+    if (!trimmed.startsWith(`${name}=`)) continue;
+    return decodeURIComponent(trimmed.slice(name.length + 1));
+  }
+  return null;
+}