@realiizlabs/admin 0.14.1 → 0.15.1

package/LICENSE

@@ -0,0 +1,21 @@
+Realiiz Studio License (source-available)
+
+Copyright (c) 2026 Realiiz Labs LLC. All rights reserved.
+
+This package (@realiizlabs/admin, "Studio") is published so that websites built
+from the Realiiz site-starter-pro template can install and update it without
+credentials. It is not open source.
+
+You may install, run and modify this package as part of a website that you or
+your organization built from a licensed copy of site-starter-pro, or that
+Realiiz built for you. You may keep it installed for as long as that website
+exists, including after your relationship with Realiiz ends.
+
+You may not redistribute this package, sell it, offer it as part of another
+template, product or service, or remove this notice.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. In no event
+shall Realiiz Labs LLC be liable for any claim, damages or other liability
+arising from the use of the software.
+
+Questions: hello@realiiz.com

package/dist/bar/index.cjs

@@ -0,0 +1,111 @@
+"use client";
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/bar/StudioBar.tsx
+var STUDIO_MARKER_COOKIE = "rz-studio";
+var HIDE_KEY = "rz-bar-hidden";
+function hasStudioMarker(cookie = typeof document === "undefined" ? "" : document.cookie) {
+  return cookie.split(";").some((c) => c.trim().startsWith(`${STUDIO_MARKER_COOKIE}=1`));
+}
+function editHrefFor(pathname, routes, adminPath = "/admin") {
+  for (const [prefix, typeId] of Object.entries(routes)) {
+    if (!pathname.startsWith(prefix)) continue;
+    const rest = pathname.slice(prefix.length).replace(/\/+$/, "");
+    if (!rest || rest.includes("/")) continue;
+    if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(rest)) continue;
+    return `${adminPath}/${typeId}/${rest}`;
+  }
+  return null;
+}
+function usePathname() {
+  const [path, setPath] = react.useState("");
+  react.useEffect(() => {
+    const read = () => setPath(window.location.pathname);
+    read();
+    window.addEventListener("popstate", read);
+    const h = window.history;
+    if (!h.__rzWrapped) {
+      h.__rzWrapped = true;
+      for (const m of ["pushState", "replaceState"]) {
+        const orig = h[m].bind(h);
+        h[m] = ((...args) => {
+          orig(...args);
+          window.dispatchEvent(new Event("rz:navigate"));
+        });
+      }
+    }
+    window.addEventListener("rz:navigate", read);
+    return () => {
+      window.removeEventListener("popstate", read);
+      window.removeEventListener("rz:navigate", read);
+    };
+  }, []);
+  return path;
+}
+function StudioBar({ routes = {}, adminPath = "/admin", label = "Studio" }) {
+  const path = usePathname();
+  const [show, setShow] = react.useState(false);
+  react.useEffect(() => {
+    if (!path) return;
+    if (path === adminPath || path.startsWith(`${adminPath}/`)) {
+      setShow(false);
+      return;
+    }
+    let hidden = false;
+    try {
+      hidden = sessionStorage.getItem(HIDE_KEY) === "1";
+    } catch {
+    }
+    setShow(!hidden && hasStudioMarker());
+  }, [path, adminPath]);
+  if (!show) return null;
+  const edit = editHrefFor(path, routes, adminPath);
+  const close = () => {
+    try {
+      sessionStorage.setItem(HIDE_KEY, "1");
+    } catch {
+    }
+    setShow(false);
+  };
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { style: S.wrap, role: "region", "aria-label": "Studio", "data-studio-bar": true, children: [
+    /* @__PURE__ */ jsxRuntime.jsxs("span", { style: S.brand, children: [
+      /* @__PURE__ */ jsxRuntime.jsx("svg", { width: "12", height: "12", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.4", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: /* @__PURE__ */ jsxRuntime.jsx("path", { d: "M12 3l7 3v5c0 5-3.5 8.5-7 10-3.5-1.5-7-5-7-10V6z" }) }),
+      label
+    ] }),
+    edit && /* @__PURE__ */ jsxRuntime.jsx("a", { href: edit, style: S.link, children: "Edit this page" }),
+    /* @__PURE__ */ jsxRuntime.jsx("a", { href: adminPath, style: S.link, children: "Dashboard" }),
+    /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", onClick: close, style: S.close, "aria-label": "Hide the Studio bar for this tab", children: "\xD7" })
+  ] });
+}
+var S = {
+  wrap: {
+    position: "fixed",
+    left: 16,
+    bottom: 16,
+    zIndex: 2147483e3,
+    display: "flex",
+    alignItems: "center",
+    gap: 2,
+    padding: "4px 6px 4px 10px",
+    borderRadius: 999,
+    background: "#0b1220",
+    color: "#e5e7eb",
+    boxShadow: "0 6px 24px rgba(0,0,0,.28)",
+    font: "500 13px/1 system-ui, -apple-system, Segoe UI, Roboto, sans-serif",
+    letterSpacing: ".01em",
+    WebkitFontSmoothing: "antialiased"
+  },
+  brand: { display: "inline-flex", alignItems: "center", gap: 6, paddingRight: 8, marginRight: 4, borderRight: "1px solid rgba(255,255,255,.18)", color: "#a5b4fc", fontWeight: 600 },
+  link: { color: "#e5e7eb", textDecoration: "none", padding: "6px 8px", borderRadius: 999 },
+  close: { marginLeft: 2, width: 26, height: 26, border: 0, borderRadius: 999, background: "transparent", color: "#9ca3af", fontSize: 16, lineHeight: 1, cursor: "pointer" }
+};
+
+exports.STUDIO_MARKER_COOKIE = STUDIO_MARKER_COOKIE;
+exports.StudioBar = StudioBar;
+exports.editHrefFor = editHrefFor;
+exports.hasStudioMarker = hasStudioMarker;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/bar/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/bar/StudioBar.tsx"],"names":["useState","useEffect","jsxs","jsx"],"mappings":";;;;;;AAIO,IAAM,oBAAA,GAAuB;AACpC,IAAM,QAAA,GAAW,eAAA;AAYV,SAAS,gBAAgB,MAAA,GAAiB,OAAO,aAAa,WAAA,GAAc,EAAA,GAAK,SAAS,MAAA,EAAiB;AAChH,EAAA,OAAO,MAAA,CAAO,KAAA,CAAM,GAAG,CAAA,CAAE,KAAK,CAAC,CAAA,KAAM,CAAA,CAAE,IAAA,EAAK,CAAE,UAAA,CAAW,CAAA,EAAG,oBAAoB,IAAI,CAAC,CAAA;AACvF;AAGO,SAAS,WAAA,CAAY,QAAA,EAAkB,MAAA,EAAgC,SAAA,GAAY,QAAA,EAAyB;AACjH,EAAA,KAAA,MAAW,CAAC,MAAA,EAAQ,MAAM,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,EAAG;AACrD,IAAA,IAAI,CAAC,QAAA,CAAS,UAAA,CAAW,MAAM,CAAA,EAAG;AAClC,IAAA,MAAM,IAAA,GAAO,SAAS,KAAA,CAAM,MAAA,CAAO,MAAM,CAAA,CAAE,OAAA,CAAQ,QAAQ,EAAE,CAAA;AAC7D,IAAA,IAAI,CAAC,IAAA,IAAQ,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA,EAAG;AACjC,IAAA,IAAI,CAAC,4BAAA,CAA6B,IAAA,CAAK,IAAI,CAAA,EAAG;AAC9C,IAAA,OAAO,CAAA,EAAG,SAAS,CAAA,CAAA,EAAI,MAAM,IAAI,IAAI,CAAA,CAAA;AAAA,EACvC;AACA,EAAA,OAAO,IAAA;AACT;AAGA,SAAS,WAAA,GAAsB;AAC7B,EAAA,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,GAAIA,eAAS,EAAE,CAAA;AACnC,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,IAAA,GAAO,MAAM,OAAA,CAAQ,MAAA,CAAO,SAAS,QAAQ,CAAA;AACnD,IAAA,IAAA,EAAK;AACL,IAAA,MAAA,CAAO,gBAAA,CAAiB,YAAY,IAAI,CAAA;AAExC,IAAA,MAAM,IAAI,MAAA,CAAO,OAAA;AACjB,IAAA,IAAI,CAAC,EAAE,WAAA,EAAa;AAClB,MAAA,CAAA,CAAE,WAAA,GAAc,IAAA;AAChB,MAAA,KAAA,MAAW,CAAA,IAAK,CAAC,WAAA,EAAa,cAAc,CAAA,EAAY;AACtD,QAAA,MAAM,IAAA,GAAO,CAAA,CAAE,CAAC,CAAA,CAAE,KAAK,CAAC,CAAA;AACxB,QAAA,CAAA,CAAE,CAAC,CAAA,IAAK,CAAA,GAAI,IAAA,KAA2C;AAAE,UAAA,IAAA,CAAK,GAAG,IAAI,CAAA;AAAG,UAAA,MAAA,CAAO,aAAA,CAAc,IAAI,KAAA,CAAM,aAAa,CAAC,CAAA;AAAA,QAAG,CAAA,CAAA;AAAA,MAC1H;AAAA,IACF;AACA,IAAA,MAAA,CAAO,gBAAA,CAAiB,eAAe,IAAI,CAAA;AAC3C,IAAA,OAAO,MAAM;AAAE,MAAA,MAAA,CAAO,mBAAA,CAAoB,YAAY,IAAI,CAAA;AAAG,MAAA,MAAA,CAAO,mBAAA,CAAoB,eAAe,IAAI,CAAA;AAAA,IAAG,CAAA;AAAA,EAChH,CAAA,EAAG,EAAE,CAAA;AACL,EAAA,OAAO,IAAA;AACT;AAEO,SAAS,SAAA,CAAU,EAAE,MAAA,GAAS,IAAI,SAAA,GAAY,QAAA,EAAU,KAAA,GAAQ,QAAA,EAAS,EAAmB;AACjG,EAAA,MAAM,OAAO,WAAA,EAAY;AACzB,EAAA,MAAM,CAAC,IAAA,EAAM,OAAO,CAAA,GAAID,eAAS,KAAK,CAAA;AAEtC,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,IAAA,EAAM;AACX,IAAA,IAAI,SAAS,SAAA,IAAa,IAAA,CAAK,WAAW,CAAA,EAAG,SAAS,GAAG,CAAA,EAAG;AAAE,MAAA,OAAA,CAAQ,KAAK,CAAA;AAAG,MAAA;AAAA,IAAQ;AACtF,IAAA,IAAI,MAAA,GAAS,KAAA;AACb,IAAA,IAAI;AAAE,MAAA,MAAA,GAAS,cAAA,CAAe,OAAA,CAAQ,QAAQ,CAAA,KAAM,GAAA;AAAA,IAAK,CAAA,CAAA,MAAQ;AAAA,IAAqB;AACtF,IAAA,OAAA,CAAQ,CAAC,MAAA,IAAU,eAAA,EAAiB,CAAA;AAAA,EACtC,CAAA,EAAG,CAAC,IAAA,EAAM,SAAS,CAAC,CAAA;AAEpB,EAAA,IAAI,CAAC,MAAM,OAAO,IAAA;AAClB,EAAA,MAAM,IAAA,GAAO,WAAA,CAAY,IAAA,EAAM,MAAA,EAAQ,SAAS,CAAA;AAChD,EAAA,MAAM,QAAQ,MAAM;AAAE,IAAA,IAAI;AAAE,MAAA,cAAA,CAAe,OAAA,CAAQ,UAAU,GAAG,CAAA;AAAA,IAAG,CAAA,CAAA,MAAQ;AAAA,IAAqB;AAAE,IAAA,OAAA,CAAQ,KAAK,CAAA;AAAA,EAAG,CAAA;AAElH,EAAA,uBACEC,eAAA,CAAC,KAAA,EAAA,EAAI,KAAA,EAAO,CAAA,CAAE,IAAA,EAAM,MAAK,QAAA,EAAS,YAAA,EAAW,QAAA,EAAS,iBAAA,EAAe,IAAA,EACnE,QAAA,EAAA;AAAA,oBAAAA,eAAA,CAAC,MAAA,EAAA,EAAK,KAAA,EAAO,CAAA,CAAE,KAAA,EACb,QAAA,EAAA;AAAA,sBAAAC,cAAA,CAAC,KAAA,EAAA,EAAI,OAAM,IAAA,EAAK,MAAA,EAAO,MAAK,OAAA,EAAQ,WAAA,EAAY,IAAA,EAAK,MAAA,EAAO,MAAA,EAAO,cAAA,EAAe,aAAY,KAAA,EAAM,aAAA,EAAc,OAAA,EAAQ,cAAA,EAAe,OAAA,EAAQ,aAAA,EAAY,QAAO,QAAA,kBAAAA,cAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,kDAAA,EAAmD,CAAA,EAAE,CAAA;AAAA,MAChO;AAAA,KAAA,EACH,CAAA;AAAA,IACC,IAAA,mCAAS,GAAA,EAAA,EAAE,IAAA,EAAM,MAAM,KAAA,EAAO,CAAA,CAAE,MAAM,QAAA,EAAA,gBAAA,EAAc,CAAA;AAAA,mCACpD,GAAA,EAAA,EAAE,IAAA,EAAM,WAAW,KAAA,EAAO,CAAA,CAAE,MAAM,QAAA,EAAA,WAAA,EAAS,CAAA;AAAA,oBAC5CA,cAAA,CAAC,QAAA,EAAA,EAAO,IAAA,EAAK,QAAA,EAAS,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,CAAA,CAAE,KAAA,EAAO,YAAA,EAAW,kCAAA,EAAmC,QAAA,EAAA,MAAA,EAAC;AAAA,GAAA,EACvG,CAAA;AAEJ;AAGA,IAAM,CAAA,GAAmC;AAAA,EACvC,IAAA,EAAM;AAAA,IACJ,QAAA,EAAU,OAAA;AAAA,IAAS,IAAA,EAAM,EAAA;AAAA,IAAI,MAAA,EAAQ,EAAA;AAAA,IAAI,MAAA,EAAQ,SAAA;AAAA,IACjD,OAAA,EAAS,MAAA;AAAA,IAAQ,UAAA,EAAY,QAAA;AAAA,IAAU,GAAA,EAAK,CAAA;AAAA,IAC5C,OAAA,EAAS,kBAAA;AAAA,IAAoB,YAAA,EAAc,GAAA;AAAA,IAC3C,UAAA,EAAY,SAAA;AAAA,IAAW,KAAA,EAAO,SAAA;AAAA,IAAW,SAAA,EAAW,4BAAA;AAAA,IACpD,IAAA,EAAM,mEAAA;AAAA,IAAqE,aAAA,EAAe,OAAA;AAAA,IAC1F,mBAAA,EAAqB;AAAA,GACvB;AAAA,EACA,OAAO,EAAE,OAAA,EAAS,aAAA,EAAe,UAAA,EAAY,UAAU,GAAA,EAAK,CAAA,EAAG,YAAA,EAAc,CAAA,EAAG,aAAa,CAAA,EAAG,WAAA,EAAa,mCAAmC,KAAA,EAAO,SAAA,EAAW,YAAY,GAAA,EAAI;AAAA,EAClL,IAAA,EAAM,EAAE,KAAA,EAAO,SAAA,EAAW,gBAAgB,MAAA,EAAQ,OAAA,EAAS,SAAA,EAAW,YAAA,EAAc,GAAA,EAAI;AAAA,EACxF,KAAA,EAAO,EAAE,UAAA,EAAY,CAAA,EAAG,OAAO,EAAA,EAAI,MAAA,EAAQ,IAAI,MAAA,EAAQ,CAAA,EAAG,cAAc,GAAA,EAAK,UAAA,EAAY,eAAe,KAAA,EAAO,SAAA,EAAW,UAAU,EAAA,EAAI,UAAA,EAAY,CAAA,EAAG,MAAA,EAAQ,SAAA;AACjK,CAAA","file":"index.cjs","sourcesContent":["\"use client\";\n\nimport { useEffect, useState, type CSSProperties } from \"react\";\n\nexport const STUDIO_MARKER_COOKIE = \"rz-studio\";\nconst HIDE_KEY = \"rz-bar-hidden\";\n\nexport interface StudioBarProps {\n  /** Public URL prefix → content type id, e.g. { \"/blog/\": \"posts\", \"/events/\": \"events\" }. */\n  routes?: Record<string, string>;\n  /** Where Studio lives. Default \"/admin\". */\n  adminPath?: string;\n  /** Shown on the pill. Default \"Studio\". */\n  label?: string;\n}\n\n/** True when Studio's marker cookie is present (someone signed in to Studio in this browser). */\nexport function hasStudioMarker(cookie: string = typeof document === \"undefined\" ? \"\" : document.cookie): boolean {\n  return cookie.split(\";\").some((c) => c.trim().startsWith(`${STUDIO_MARKER_COOKIE}=1`));\n}\n\n/** The Studio edit page for a public path, or null when the path isn't an item Studio manages. */\nexport function editHrefFor(pathname: string, routes: Record<string, string>, adminPath = \"/admin\"): string | null {\n  for (const [prefix, typeId] of Object.entries(routes)) {\n    if (!pathname.startsWith(prefix)) continue;\n    const rest = pathname.slice(prefix.length).replace(/\\/+$/, \"\");\n    if (!rest || rest.includes(\"/\")) continue; // the index page, or something nested — not an item\n    if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(rest)) continue;\n    return `${adminPath}/${typeId}/${rest}`;\n  }\n  return null;\n}\n\n/** The current pathname, kept in step with client-side navigation (Next's router uses pushState). */\nfunction usePathname(): string {\n  const [path, setPath] = useState(\"\");\n  useEffect(() => {\n    const read = () => setPath(window.location.pathname);\n    read();\n    window.addEventListener(\"popstate\", read);\n    // pushState/replaceState fire no event; wrap them once per page so every router notifies us.\n    const h = window.history as History & { __rzWrapped?: boolean };\n    if (!h.__rzWrapped) {\n      h.__rzWrapped = true;\n      for (const m of [\"pushState\", \"replaceState\"] as const) {\n        const orig = h[m].bind(h);\n        h[m] = ((...args: Parameters<History[\"pushState\"]>) => { orig(...args); window.dispatchEvent(new Event(\"rz:navigate\")); }) as History[\"pushState\"];\n      }\n    }\n    window.addEventListener(\"rz:navigate\", read);\n    return () => { window.removeEventListener(\"popstate\", read); window.removeEventListener(\"rz:navigate\", read); };\n  }, []);\n  return path;\n}\n\nexport function StudioBar({ routes = {}, adminPath = \"/admin\", label = \"Studio\" }: StudioBarProps) {\n  const path = usePathname();\n  const [show, setShow] = useState(false);\n\n  useEffect(() => {\n    if (!path) return;\n    if (path === adminPath || path.startsWith(`${adminPath}/`)) { setShow(false); return; }\n    let hidden = false;\n    try { hidden = sessionStorage.getItem(HIDE_KEY) === \"1\"; } catch { /* private mode */ }\n    setShow(!hidden && hasStudioMarker());\n  }, [path, adminPath]);\n\n  if (!show) return null;\n  const edit = editHrefFor(path, routes, adminPath);\n  const close = () => { try { sessionStorage.setItem(HIDE_KEY, \"1\"); } catch { /* private mode */ } setShow(false); };\n\n  return (\n    <div style={S.wrap} role=\"region\" aria-label=\"Studio\" data-studio-bar>\n      <span style={S.brand}>\n        <svg width=\"12\" height=\"12\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2.4\" strokeLinecap=\"round\" strokeLinejoin=\"round\" aria-hidden=\"true\"><path d=\"M12 3l7 3v5c0 5-3.5 8.5-7 10-3.5-1.5-7-5-7-10V6z\" /></svg>\n        {label}\n      </span>\n      {edit && <a href={edit} style={S.link}>Edit this page</a>}\n      <a href={adminPath} style={S.link}>Dashboard</a>\n      <button type=\"button\" onClick={close} style={S.close} aria-label=\"Hide the Studio bar for this tab\">×</button>\n    </div>\n  );\n}\n\n/* Self-contained styles: no dependency on the site's CSS, fonts or theme. */\nconst S: Record<string, CSSProperties> = {\n  wrap: {\n    position: \"fixed\", left: 16, bottom: 16, zIndex: 2147483000,\n    display: \"flex\", alignItems: \"center\", gap: 2,\n    padding: \"4px 6px 4px 10px\", borderRadius: 999,\n    background: \"#0b1220\", color: \"#e5e7eb\", boxShadow: \"0 6px 24px rgba(0,0,0,.28)\",\n    font: \"500 13px/1 system-ui, -apple-system, Segoe UI, Roboto, sans-serif\", letterSpacing: \".01em\",\n    WebkitFontSmoothing: \"antialiased\",\n  },\n  brand: { display: \"inline-flex\", alignItems: \"center\", gap: 6, paddingRight: 8, marginRight: 4, borderRight: \"1px solid rgba(255,255,255,.18)\", color: \"#a5b4fc\", fontWeight: 600 },\n  link: { color: \"#e5e7eb\", textDecoration: \"none\", padding: \"6px 8px\", borderRadius: 999 },\n  close: { marginLeft: 2, width: 26, height: 26, border: 0, borderRadius: 999, background: \"transparent\", color: \"#9ca3af\", fontSize: 16, lineHeight: 1, cursor: \"pointer\" },\n};\n"]}

package/dist/bar/index.d.cts

@@ -0,0 +1,18 @@
+import * as react from 'react';
+
+declare const STUDIO_MARKER_COOKIE = "rz-studio";
+interface StudioBarProps {
+    /** Public URL prefix → content type id, e.g. { "/blog/": "posts", "/events/": "events" }. */
+    routes?: Record<string, string>;
+    /** Where Studio lives. Default "/admin". */
+    adminPath?: string;
+    /** Shown on the pill. Default "Studio". */
+    label?: string;
+}
+/** True when Studio's marker cookie is present (someone signed in to Studio in this browser). */
+declare function hasStudioMarker(cookie?: string): boolean;
+/** The Studio edit page for a public path, or null when the path isn't an item Studio manages. */
+declare function editHrefFor(pathname: string, routes: Record<string, string>, adminPath?: string): string | null;
+declare function StudioBar({ routes, adminPath, label }: StudioBarProps): react.JSX.Element | null;
+
+export { STUDIO_MARKER_COOKIE, StudioBar, type StudioBarProps, editHrefFor, hasStudioMarker };

package/dist/bar/index.d.ts

@@ -0,0 +1,18 @@
+import * as react from 'react';
+
+declare const STUDIO_MARKER_COOKIE = "rz-studio";
+interface StudioBarProps {
+    /** Public URL prefix → content type id, e.g. { "/blog/": "posts", "/events/": "events" }. */
+    routes?: Record<string, string>;
+    /** Where Studio lives. Default "/admin". */
+    adminPath?: string;
+    /** Shown on the pill. Default "Studio". */
+    label?: string;
+}
+/** True when Studio's marker cookie is present (someone signed in to Studio in this browser). */
+declare function hasStudioMarker(cookie?: string): boolean;
+/** The Studio edit page for a public path, or null when the path isn't an item Studio manages. */
+declare function editHrefFor(pathname: string, routes: Record<string, string>, adminPath?: string): string | null;
+declare function StudioBar({ routes, adminPath, label }: StudioBarProps): react.JSX.Element | null;
+
+export { STUDIO_MARKER_COOKIE, StudioBar, type StudioBarProps, editHrefFor, hasStudioMarker };

package/dist/bar/index.js

@@ -0,0 +1,106 @@
+"use client";
+import { useState, useEffect } from 'react';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/bar/StudioBar.tsx
+var STUDIO_MARKER_COOKIE = "rz-studio";
+var HIDE_KEY = "rz-bar-hidden";
+function hasStudioMarker(cookie = typeof document === "undefined" ? "" : document.cookie) {
+  return cookie.split(";").some((c) => c.trim().startsWith(`${STUDIO_MARKER_COOKIE}=1`));
+}
+function editHrefFor(pathname, routes, adminPath = "/admin") {
+  for (const [prefix, typeId] of Object.entries(routes)) {
+    if (!pathname.startsWith(prefix)) continue;
+    const rest = pathname.slice(prefix.length).replace(/\/+$/, "");
+    if (!rest || rest.includes("/")) continue;
+    if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(rest)) continue;
+    return `${adminPath}/${typeId}/${rest}`;
+  }
+  return null;
+}
+function usePathname() {
+  const [path, setPath] = useState("");
+  useEffect(() => {
+    const read = () => setPath(window.location.pathname);
+    read();
+    window.addEventListener("popstate", read);
+    const h = window.history;
+    if (!h.__rzWrapped) {
+      h.__rzWrapped = true;
+      for (const m of ["pushState", "replaceState"]) {
+        const orig = h[m].bind(h);
+        h[m] = ((...args) => {
+          orig(...args);
+          window.dispatchEvent(new Event("rz:navigate"));
+        });
+      }
+    }
+    window.addEventListener("rz:navigate", read);
+    return () => {
+      window.removeEventListener("popstate", read);
+      window.removeEventListener("rz:navigate", read);
+    };
+  }, []);
+  return path;
+}
+function StudioBar({ routes = {}, adminPath = "/admin", label = "Studio" }) {
+  const path = usePathname();
+  const [show, setShow] = useState(false);
+  useEffect(() => {
+    if (!path) return;
+    if (path === adminPath || path.startsWith(`${adminPath}/`)) {
+      setShow(false);
+      return;
+    }
+    let hidden = false;
+    try {
+      hidden = sessionStorage.getItem(HIDE_KEY) === "1";
+    } catch {
+    }
+    setShow(!hidden && hasStudioMarker());
+  }, [path, adminPath]);
+  if (!show) return null;
+  const edit = editHrefFor(path, routes, adminPath);
+  const close = () => {
+    try {
+      sessionStorage.setItem(HIDE_KEY, "1");
+    } catch {
+    }
+    setShow(false);
+  };
+  return /* @__PURE__ */ jsxs("div", { style: S.wrap, role: "region", "aria-label": "Studio", "data-studio-bar": true, children: [
+    /* @__PURE__ */ jsxs("span", { style: S.brand, children: [
+      /* @__PURE__ */ jsx("svg", { width: "12", height: "12", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.4", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: /* @__PURE__ */ jsx("path", { d: "M12 3l7 3v5c0 5-3.5 8.5-7 10-3.5-1.5-7-5-7-10V6z" }) }),
+      label
+    ] }),
+    edit && /* @__PURE__ */ jsx("a", { href: edit, style: S.link, children: "Edit this page" }),
+    /* @__PURE__ */ jsx("a", { href: adminPath, style: S.link, children: "Dashboard" }),
+    /* @__PURE__ */ jsx("button", { type: "button", onClick: close, style: S.close, "aria-label": "Hide the Studio bar for this tab", children: "\xD7" })
+  ] });
+}
+var S = {
+  wrap: {
+    position: "fixed",
+    left: 16,
+    bottom: 16,
+    zIndex: 2147483e3,
+    display: "flex",
+    alignItems: "center",
+    gap: 2,
+    padding: "4px 6px 4px 10px",
+    borderRadius: 999,
+    background: "#0b1220",
+    color: "#e5e7eb",
+    boxShadow: "0 6px 24px rgba(0,0,0,.28)",
+    font: "500 13px/1 system-ui, -apple-system, Segoe UI, Roboto, sans-serif",
+    letterSpacing: ".01em",
+    WebkitFontSmoothing: "antialiased"
+  },
+  brand: { display: "inline-flex", alignItems: "center", gap: 6, paddingRight: 8, marginRight: 4, borderRight: "1px solid rgba(255,255,255,.18)", color: "#a5b4fc", fontWeight: 600 },
+  link: { color: "#e5e7eb", textDecoration: "none", padding: "6px 8px", borderRadius: 999 },
+  close: { marginLeft: 2, width: 26, height: 26, border: 0, borderRadius: 999, background: "transparent", color: "#9ca3af", fontSize: 16, lineHeight: 1, cursor: "pointer" }
+};
+
+export { STUDIO_MARKER_COOKIE, StudioBar, editHrefFor, hasStudioMarker };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/bar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/bar/StudioBar.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["\"use client\";\n\nimport { useEffect, useState, type CSSProperties } from \"react\";\n\nexport const STUDIO_MARKER_COOKIE = \"rz-studio\";\nconst HIDE_KEY = \"rz-bar-hidden\";\n\nexport interface StudioBarProps {\n  /** Public URL prefix → content type id, e.g. { \"/blog/\": \"posts\", \"/events/\": \"events\" }. */\n  routes?: Record<string, string>;\n  /** Where Studio lives. Default \"/admin\". */\n  adminPath?: string;\n  /** Shown on the pill. Default \"Studio\". */\n  label?: string;\n}\n\n/** True when Studio's marker cookie is present (someone signed in to Studio in this browser). */\nexport function hasStudioMarker(cookie: string = typeof document === \"undefined\" ? \"\" : document.cookie): boolean {\n  return cookie.split(\";\").some((c) => c.trim().startsWith(`${STUDIO_MARKER_COOKIE}=1`));\n}\n\n/** The Studio edit page for a public path, or null when the path isn't an item Studio manages. */\nexport function editHrefFor(pathname: string, routes: Record<string, string>, adminPath = \"/admin\"): string | null {\n  for (const [prefix, typeId] of Object.entries(routes)) {\n    if (!pathname.startsWith(prefix)) continue;\n    const rest = pathname.slice(prefix.length).replace(/\\/+$/, \"\");\n    if (!rest || rest.includes(\"/\")) continue; // the index page, or something nested — not an item\n    if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(rest)) continue;\n    return `${adminPath}/${typeId}/${rest}`;\n  }\n  return null;\n}\n\n/** The current pathname, kept in step with client-side navigation (Next's router uses pushState). */\nfunction usePathname(): string {\n  const [path, setPath] = useState(\"\");\n  useEffect(() => {\n    const read = () => setPath(window.location.pathname);\n    read();\n    window.addEventListener(\"popstate\", read);\n    // pushState/replaceState fire no event; wrap them once per page so every router notifies us.\n    const h = window.history as History & { __rzWrapped?: boolean };\n    if (!h.__rzWrapped) {\n      h.__rzWrapped = true;\n      for (const m of [\"pushState\", \"replaceState\"] as const) {\n        const orig = h[m].bind(h);\n        h[m] = ((...args: Parameters<History[\"pushState\"]>) => { orig(...args); window.dispatchEvent(new Event(\"rz:navigate\")); }) as History[\"pushState\"];\n      }\n    }\n    window.addEventListener(\"rz:navigate\", read);\n    return () => { window.removeEventListener(\"popstate\", read); window.removeEventListener(\"rz:navigate\", read); };\n  }, []);\n  return path;\n}\n\nexport function StudioBar({ routes = {}, adminPath = \"/admin\", label = \"Studio\" }: StudioBarProps) {\n  const path = usePathname();\n  const [show, setShow] = useState(false);\n\n  useEffect(() => {\n    if (!path) return;\n    if (path === adminPath || path.startsWith(`${adminPath}/`)) { setShow(false); return; }\n    let hidden = false;\n    try { hidden = sessionStorage.getItem(HIDE_KEY) === \"1\"; } catch { /* private mode */ }\n    setShow(!hidden && hasStudioMarker());\n  }, [path, adminPath]);\n\n  if (!show) return null;\n  const edit = editHrefFor(path, routes, adminPath);\n  const close = () => { try { sessionStorage.setItem(HIDE_KEY, \"1\"); } catch { /* private mode */ } setShow(false); };\n\n  return (\n    <div style={S.wrap} role=\"region\" aria-label=\"Studio\" data-studio-bar>\n      <span style={S.brand}>\n        <svg width=\"12\" height=\"12\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2.4\" strokeLinecap=\"round\" strokeLinejoin=\"round\" aria-hidden=\"true\"><path d=\"M12 3l7 3v5c0 5-3.5 8.5-7 10-3.5-1.5-7-5-7-10V6z\" /></svg>\n        {label}\n      </span>\n      {edit && <a href={edit} style={S.link}>Edit this page</a>}\n      <a href={adminPath} style={S.link}>Dashboard</a>\n      <button type=\"button\" onClick={close} style={S.close} aria-label=\"Hide the Studio bar for this tab\">×</button>\n    </div>\n  );\n}\n\n/* Self-contained styles: no dependency on the site's CSS, fonts or theme. */\nconst S: Record<string, CSSProperties> = {\n  wrap: {\n    position: \"fixed\", left: 16, bottom: 16, zIndex: 2147483000,\n    display: \"flex\", alignItems: \"center\", gap: 2,\n    padding: \"4px 6px 4px 10px\", borderRadius: 999,\n    background: \"#0b1220\", color: \"#e5e7eb\", boxShadow: \"0 6px 24px rgba(0,0,0,.28)\",\n    font: \"500 13px/1 system-ui, -apple-system, Segoe UI, Roboto, sans-serif\", letterSpacing: \".01em\",\n    WebkitFontSmoothing: \"antialiased\",\n  },\n  brand: { display: \"inline-flex\", alignItems: \"center\", gap: 6, paddingRight: 8, marginRight: 4, borderRight: \"1px solid rgba(255,255,255,.18)\", color: \"#a5b4fc\", fontWeight: 600 },\n  link: { color: \"#e5e7eb\", textDecoration: \"none\", padding: \"6px 8px\", borderRadius: 999 },\n  close: { marginLeft: 2, width: 26, height: 26, border: 0, borderRadius: 999, background: \"transparent\", color: \"#9ca3af\", fontSize: 16, lineHeight: 1, cursor: \"pointer\" },\n};\n"]}

package/dist/studio/index.cjs

@@ -1107,18 +1107,93 @@ function makeHandlers(ctx) {
       await signOut(await ctx.identityClient());
     } catch {
     }
-    return Response.redirect(new URL("/admin/sign-in", request.url), 303);
+    const res = Response.redirect(new URL("/admin/sign-in", request.url), 303);
+    const headers = new Headers(res.headers);
+    headers.append("Set-Cookie", "rz-studio=; Path=/; Max-Age=0; SameSite=Lax");
+    return new Response(null, { status: 303, headers });
   };
   return { callback, signout };
 }
 
+// src/version.ts
+var ADMIN_VERSION = "0.15.1" ;
+
+// src/studio/update.ts
+var PACKAGE_NAME = "@realiizlabs/admin";
+var DEPENDABOT_PREFIX = "dependabot/npm_and_yarn/";
+var TITLE_RE = /@realiizlabs\/admin\b.*?\bto\s+v?(\d+\.\d+\.\d+)/i;
+var BRANCH_RE2 = /realiizlabs\/admin-(\d+\.\d+\.\d+)$/;
+function updateVersionOf(pr) {
+  if (!pr.branch.startsWith(DEPENDABOT_PREFIX)) return null;
+  const fromTitle = TITLE_RE.exec(pr.title)?.[1];
+  if (fromTitle) return fromTitle;
+  return BRANCH_RE2.exec(pr.branch)?.[1] ?? null;
+}
+async function fetchReleaseNotes(version, fetchImpl = fetch) {
+  try {
+    const res = await fetchImpl(`https://registry.npmjs.org/${PACKAGE_NAME}/${version}`, { headers: { accept: "application/json" } });
+    if (!res.ok) return null;
+    const json = await res.json();
+    return typeof json.releaseNotes === "string" && json.releaseNotes.trim() ? json.releaseNotes.trim() : null;
+  } catch {
+    return null;
+  }
+}
+function stateOf(status) {
+  if (status.state === "green") return { state: "ready", failingCheck: null, previewUrl: status.previewUrl ?? null };
+  if (status.state === "red") return { state: "failed", failingCheck: status.failingCheck ?? null, previewUrl: null };
+  return { state: "checking", failingCheck: null, previewUrl: null };
+}
+function makeUpdate(config, ctx, deps = {}) {
+  const revalidate = config.revalidate ?? (() => {
+  });
+  const studioUpdate = async () => {
+    try {
+      const repo = config.env().repo;
+      const prs = await listOpenPullRequests(repo, { headPrefix: DEPENDABOT_PREFIX });
+      const candidates = prs.map((pr2) => ({ pr: pr2, version: updateVersionOf(pr2) })).filter((c) => c.version !== null);
+      if (candidates.length === 0) return null;
+      candidates.sort((a, b) => compareVersions(b.version, a.version));
+      const { pr, version } = candidates[0];
+      const [status, notes] = await Promise.all([getPullRequestStatus(repo, pr.number), fetchReleaseNotes(version, deps.fetch)]);
+      return { number: pr.number, htmlUrl: pr.html_url, version, currentVersion: ADMIN_VERSION, notes, ...stateOf(status) };
+    } catch {
+      return null;
+    }
+  };
+  const updateStudio = async (number) => {
+    await ctx.requireAdmin({ minimumRole: "owner" });
+    const update = await studioUpdate();
+    if (!update || update.number !== number) return { state: "error", message: "That isn\u2019t a Studio update." };
+    try {
+      const result = await mergePullRequest(config.env().repo, number, { requireGreen: true });
+      revalidate("/admin");
+      return result.merged ? { state: "merged", sha: result.sha } : { state: "pending" };
+    } catch (err) {
+      if (err instanceof StaleBaseError) return { state: "stale" };
+      if (err instanceof ChecksFailedError) return { state: "red", failingCheck: err.failingCheck };
+      return { state: "error", message: err instanceof Error ? err.message : String(err) };
+    }
+  };
+  return { studioUpdate, updateStudio };
+}
+function compareVersions(a, b) {
+  const pa = a.split(".").map(Number), pb = b.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] ?? 0) !== (pb[i] ?? 0)) return (pa[i] ?? 0) - (pb[i] ?? 0);
+  }
+  return 0;
+}
+
 // src/studio/index.ts
 function createStudio(config) {
   const ctx = makeContext(config);
   const registry = makeRegistry(config);
   const pending = makePending(config, registry);
   const readers = makeReaders(config, registry, pending);
+  const update = makeUpdate(config, ctx);
   const actions = {
+    updateStudio: update.updateStudio,
     ...makePublish(config, registry, ctx, readers),
     ...makeMerge(config, ctx, readers),
     ...makePreview(ctx),
@@ -1132,19 +1207,22 @@ function createStudio(config) {
     entries: registry.entries,
     requireAdmin: ctx.requireAdmin,
     identityClient: ctx.identityClient,
-    readers: { ...readers, ...pending, locate: registry.locate, publicUrlFor: registry.publicUrlFor, publicDirFor: registry.publicDirFor },
+    readers: { ...readers, ...pending, locate: registry.locate, publicUrlFor: registry.publicUrlFor, publicDirFor: registry.publicDirFor, studioUpdate: update.studioUpdate },
     actions,
     authHandlers: makeHandlers(ctx)
   };
 }
 
+exports.ADMIN_VERSION = ADMIN_VERSION;
 exports.IMAGE_ERRORS = IMAGE_ERRORS;
 exports.IMAGE_LIMITS = IMAGE_LIMITS;
 exports.NotHere = NotHere;
+exports.compareVersions = compareVersions;
 exports.createStudio = createStudio;
 exports.decodedSize = decodedSize;
 exports.pendingLabel = pendingLabel;
 exports.pendingText = pendingText;
+exports.updateVersionOf = updateVersionOf;
 exports.validateImages = validateImages;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map