@gigamusic/admin 0.3.0 → 2.0.0

package/README.md

@@ -1,18 +1,36 @@
 # @gigamusic/admin
 
-Source-shipped React admin for the gigamusic platform: releases CRUD,
-settings, links, link-pages, and orders view — plus per-route handler
-factories the consumer wires into `/api/admin/*`.
+Server-only admin API handler factories for the gigamusic platform: releases CRUD, track uploads, settings, links, and orders. **Auth is the consumer's responsibility** — these handlers trust that the request has been gated upstream (typically via the consumer's `proxy.ts` or middleware).
 
 ```ts
-// app/admin/page.tsx (consumer)
-export { AdminHomePage as default } from "@gigamusic/admin";
+// app/api/admin/releases/route.ts (consumer)
+import { createAdminReleasesHandlers } from "@gigamusic/admin/server";
+import { queries, storage, audio } from "@/lib/server";
 
-// app/api/admin/auth/route.ts (consumer)
-import { createAdminLoginHandler } from "@gigamusic/admin/server";
-export const POST = createAdminLoginHandler({ adminPasswordHash, adminSessionSecret });
+const handlers = createAdminReleasesHandlers({ queries, storage, audio });
+export const GET = handlers.GET;
+export const POST = handlers.POST;
 ```
 
-Every page is auth-gated by the shared admin session cookie. Override a slot
-via the standard `<GigamusicProvider components={{ Button: MyButton }}>` from
-`@gigamusic/ui`, or replace a page wholesale by simply not mounting it.
+Each factory takes a slice of `AdminDeps`:
+
+```ts
+import type { AdminDeps } from "@gigamusic/admin/server";
+
+const deps: AdminDeps = {
+  queries,    // from createQueries(prisma)
+  storage,    // from createR2Provider(...)
+  audio,      // import * as audio from "@gigamusic/audio"
+  logger,     // optional — defaults to no-op
+};
+```
+
+Available factories:
+
+- `createAdminReleasesHandlers`, `createAdminReleaseByIdHandlers`
+- `createAdminUploadPresignHandler`, `createAdminUploadProcessHandler`
+- `createAdminSettingsHandlers`
+- `createAdminLinksHandlers`
+- `createAdminOrdersHandler`
+
+The admin UI is the consumer's responsibility — write whatever pages you want and wire them to these handlers.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gigamusic/admin",
-  "version": "0.3.0",
-  "description": "Admin UI (releases CRUD, tracks, settings, links, link-pages, orders) and admin API handler factories for the gigamusic platform. Fully replaceable by the consumer — mount the pages directly or override individual slots.",
+  "version": "2.0.0",
+  "description": "Server-only admin API handler factories for the gigamusic platform (releases CRUD, tracks, uploads, settings, links, orders).",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -9,17 +9,7 @@
     "directory": "packages/admin"
   },
   "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"
@@ -34,29 +24,13 @@
   },
   "dependencies": {
     "zod": "^3.24.1",
-    "@gigamusic/audio": "0.3.0",
-    "@gigamusic/config": "0.3.0",
-    "@gigamusic/email": "0.3.0",
-    "@gigamusic/core": "0.3.0",
-    "@gigamusic/storage": "0.3.0",
-    "@gigamusic/ui": "0.3.0",
-    "@gigamusic/db": "0.3.0"
-  },
-  "peerDependencies": {
-    "next": ">=15",
-    "react": ">=18 <20",
-    "react-dom": ">=18 <20"
+    "@gigamusic/audio": "1.0.0",
+    "@gigamusic/core": "1.0.0",
+    "@gigamusic/db": "2.0.0",
+    "@gigamusic/storage": "1.0.0"
   },
   "devDependencies": {
-    "@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",
     "typescript": "^5.7.3",
     "vitest": "^2.1.8"
   },

package/src/lib/types.ts

@@ -1,7 +1,6 @@
 import type { Queries } from "@gigamusic/db";
 import type { StorageProvider } from "@gigamusic/storage";
 import type * as Audio from "@gigamusic/audio";
-import type { EmailBranding } from "@gigamusic/email";
 
 /**
  * The Next.js App Router route-handler signature. Defined locally so the admin
@@ -27,7 +26,6 @@ export interface AdminDeps {
   queries: Queries;
   storage: StorageProvider;
   audio: typeof Audio;
-  branding: EmailBranding;
   /**
    * Optional logger. Defaults to a no-op so the package never writes to
    * console on the consumer's behalf.

package/src/client.ts

@@ -1,16 +0,0 @@
-"use client";
-
-// Client-only re-exports — every consumer-side page component lives here so
-// importing them from a server-component context never accidentally pulls in
-// server-only modules.
-
-export { AdminHomePage } from "./pages/AdminHomePage";
-export { AdminReleasesPage } from "./pages/AdminReleasesPage";
-export { AdminNewReleasePage } from "./pages/AdminNewReleasePage";
-export { AdminEditReleasePage } from "./pages/AdminEditReleasePage";
-export { AdminLinksPage } from "./pages/AdminLinksPage";
-export { AdminSettingsPage } from "./pages/AdminSettingsPage";
-export { AdminOrdersPage } from "./pages/AdminOrdersPage";
-export { ReleaseForm } from "./components/ReleaseForm";
-export type { ReleaseFormProps } from "./components/ReleaseForm";
-export { AdminNav } from "./components/AdminNav";

package/src/components/AdminNav.tsx

@@ -1,50 +0,0 @@
-"use client";
-
-import Link from "next/link";
-import { usePathname } from "next/navigation";
-
-interface NavLink {
-  href: string;
-  label: string;
-  exact?: boolean;
-}
-
-const DEFAULT_LINKS: NavLink[] = [
-  { href: "/admin", label: "Releases", exact: true },
-  { href: "/admin/orders", label: "Orders" },
-  { href: "/admin/links", label: "Links" },
-  { href: "/admin/settings", label: "Settings" },
-];
-
-/**
- * Horizontal admin nav. Consumers can extend the link set by overriding the
- * `Navigation` slot if they need additional sections; the default set covers
- * everything this package ships.
- */
-export function AdminNav({ extraLinks }: { extraLinks?: NavLink[] }) {
-  const pathname = usePathname();
-  const links = [...DEFAULT_LINKS, ...(extraLinks ?? [])];
-
-  return (
-    <nav className="gm-admin-nav flex items-center gap-4 overflow-x-auto border-b border-border pb-4 mb-6">
-      {links.map(({ href, label, exact }) => {
-        const active = exact
-          ? pathname === href
-          : pathname === href || pathname.startsWith(`${href}/`);
-        return (
-          <Link
-            key={href}
-            href={href}
-            className={
-              active
-                ? "text-sm font-semibold whitespace-nowrap"
-                : "text-sm text-muted-foreground hover:underline whitespace-nowrap"
-            }
-          >
-            {label}
-          </Link>
-        );
-      })}
-    </nav>
-  );
-}