@guard-rail/core 0.10.0 → 0.12.0

package/dist/react/guardrail.css

@@ -0,0 +1,563 @@
+/*
+ * Guardrail's editing chrome — the sign-in bar, toolbar, editors, drawers and
+ * the outlines drawn around editable fields.
+ *
+ * Imported by the package itself (see GRailAdmin), so a site doesn't link it by
+ * hand, and shipped as a real stylesheet rather than inline styles so it works
+ * under a strict Content-Security-Policy (style-src 'self', no 'unsafe-inline').
+ *
+ * Theming: every color is a --gr-* variable. Override any of them in your own
+ * CSS to restyle the chrome, e.g.
+ *
+ *   :root { --gr-accent: #7c3aed; --gr-field-outline: #7c3aed; }
+ *
+ * Three layers: change a base color (--gr-bg, --gr-fg, --gr-border …) to retheme
+ * everything, or set the --gr-overlay-* variables to restyle only the floating
+ * surfaces (sign-in bar, toolbar, popups, drawers, picker) — they default to the
+ * base colors, so you only set what you want to differ.
+ *
+ * The defaults below are declared in :where(:root), which has no specificity, so
+ * a plain :root rule of yours wins whatever order the stylesheets load in — no
+ * !important, no selector tricks.
+ *
+ * Every class is prefixed gr-, so nothing here can collide with a site's own.
+ */
+
+/* ---- theme ---------------------------------------------------------------- */
+
+:where(:root) { --gr-bg: #ffffff; --gr-bg-glass: rgba(255,255,255,0.97); --gr-fg: #111827; --gr-fg2: #4b5563; --gr-muted: #6b7280; --gr-subtle: #9ca3af; --gr-border: #e5e7eb; --gr-border-strong: #d1d5db; --gr-border-soft: #f3f4f6; --gr-input-bg: #ffffff; --gr-soft: #f3f4f6; --gr-accent: #2563eb; --gr-accent-soft: #eff6ff; --gr-accent-text: #1d4ed8; --gr-primary-bg: #111827; --gr-primary-fg: #ffffff; --gr-danger: #dc2626; --gr-label: #1e3a8a; --gr-shadow: rgba(0,0,0,0.25); --gr-field-outline: #60a5fa; --gr-field-outline-active: #2563eb; --gr-on-accent: #ffffff; --gr-scrim: rgba(0,0,0,0.4); --gr-scrim-modal: rgba(0,0,0,0.5); --gr-badge-bg: #fef3c7; --gr-badge-fg: #92400e; --gr-overlay-bg: var(--gr-bg); --gr-overlay-bg-glass: var(--gr-bg-glass); --gr-overlay-fg: var(--gr-fg); --gr-overlay-border: var(--gr-border); }
+[data-guardrail] { color-scheme: light; }
+@media (prefers-color-scheme: dark) {
+  :where(:root) { --gr-bg: #0f1b2d; --gr-bg-glass: rgba(15,27,45,0.97); --gr-fg: #e6edf7; --gr-fg2: #b6c4d8; --gr-muted: #9fb0c7; --gr-subtle: #7d8ea6; --gr-border: rgba(148,163,184,0.22); --gr-border-strong: rgba(148,163,184,0.35); --gr-border-soft: rgba(148,163,184,0.14); --gr-input-bg: #14243b; --gr-soft: #1a2d49; --gr-accent: #3b82f6; --gr-accent-soft: rgba(59,130,246,0.16); --gr-accent-text: #93c5fd; --gr-primary-bg: #3b82f6; --gr-primary-fg: #ffffff; --gr-danger: #f87171; --gr-label: #dbeafe; --gr-shadow: rgba(0,0,0,0.5); }
+  [data-guardrail] { color-scheme: dark; }
+}
+
+/* ---- components ------------------------------------------------------------ */
+
+.gr-banner {
+  position: fixed;
+  bottom: 0;
+  left: 0;
+  width: 100%;
+  background: var(--gr-overlay-bg);
+  color: var(--gr-overlay-fg);
+  padding: 12px 16px;
+  z-index: 10000;
+  border-top: 1px solid var(--gr-overlay-border);
+  font-family: system-ui, -apple-system, sans-serif;
+}
+.gr-banner-form {
+  display: flex;
+  gap: 12px;
+  justify-content: center;
+  align-items: center;
+  flex-wrap: wrap;
+}
+.gr-brand {
+  font-weight: 900;
+  letter-spacing: 0.15em;
+  font-size: 12px;
+  text-transform: uppercase;
+}
+.gr-brand-stack {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 2px;
+}
+.gr-error {
+  color: var(--gr-danger);
+  font-size: 12px;
+  font-weight: 700;
+}
+.gr-input {
+  border: 1px solid var(--gr-border-strong);
+  border-radius: 4px;
+  padding: 6px 8px;
+  font-size: 13px;
+  color: var(--gr-fg);
+  background: var(--gr-input-bg);
+  outline: none;
+}
+.gr-primary-btn {
+  background: var(--gr-primary-bg);
+  color: var(--gr-primary-fg);
+  padding: 7px 16px;
+  border-radius: 4px;
+  font-size: 12px;
+  font-weight: 700;
+  border: none;
+  cursor: pointer;
+}
+.gr-toolbar {
+  position: fixed;
+  bottom: 24px;
+  left: 50%;
+  transform: translateX(-50%);
+  z-index: 9999;
+  background: var(--gr-overlay-bg-glass);
+  backdrop-filter: blur(8px);
+  color: var(--gr-overlay-fg);
+  padding: 12px 20px;
+  border-radius: 9999px;
+  box-shadow: 0 20px 40px var(--gr-shadow);
+  display: flex;
+  align-items: center;
+  gap: 20px;
+  border: 1px solid var(--gr-overlay-border);
+  font-family: system-ui, -apple-system, sans-serif;
+}
+.gr-dot {
+  display: inline-block;
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: var(--gr-accent);
+}
+.gr-toolbar-label {
+  font-size: 10px;
+  font-weight: 900;
+  text-transform: uppercase;
+  letter-spacing: 0.2em;
+  color: var(--gr-label);
+}
+.gr-divider {
+  width: 1px;
+  height: 16px;
+  background: var(--gr-border-strong);
+}
+.gr-link-btn {
+  font-size: 10px;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.15em;
+  color: var(--gr-muted);
+  background: none;
+  border: none;
+  cursor: pointer;
+}
+.gr-popover {
+  position: fixed;
+  bottom: 90px;
+  left: 50%;
+  transform: translateX(-50%);
+  z-index: 10001;
+  background: var(--gr-overlay-bg);
+  color: var(--gr-overlay-fg);
+  padding: 16px;
+  border-radius: 8px;
+  box-shadow: 0 20px 40px var(--gr-shadow);
+  border: 1px solid var(--gr-overlay-border);
+  min-width: 300px;
+  cursor: default;
+  font-family: system-ui, -apple-system, sans-serif;
+}
+.gr-label {
+  display: block;
+  font-size: 10px;
+  font-weight: 700;
+  color: var(--gr-subtle);
+  margin-bottom: 4px;
+  text-transform: uppercase;
+}
+.gr-field {
+  border: 1px solid var(--gr-border-strong);
+  border-radius: 4px;
+  padding: 6px 8px;
+  font-size: 13px;
+  color: var(--gr-fg);
+  background: var(--gr-input-bg);
+  width: 100%;
+  margin-bottom: 8px;
+  box-sizing: border-box;
+}
+.gr-row {
+  display: flex;
+  gap: 8px;
+  margin-top: 8px;
+  padding-top: 8px;
+  border-top: 1px solid var(--gr-border-soft);
+}
+.gr-cancel-btn {
+  background: var(--gr-soft);
+  color: var(--gr-fg2);
+  padding: 7px 14px;
+  border-radius: 4px;
+  font-size: 12px;
+  border: none;
+  cursor: pointer;
+}
+.gr-anchored-bar {
+  position: fixed;
+  z-index: 10001;
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  background: var(--gr-overlay-bg-glass);
+  color: var(--gr-overlay-fg);
+  backdrop-filter: blur(8px);
+  padding: 4px;
+  border-radius: 8px;
+  box-shadow: 0 8px 24px var(--gr-shadow);
+  border: 1px solid var(--gr-overlay-border);
+  font-family: system-ui, -apple-system, sans-serif;
+}
+.gr-anchored-panel {
+  position: fixed;
+  z-index: 10001;
+  max-height: calc(100vh - 24px);
+  overflow-y: auto;
+  background: var(--gr-overlay-bg);
+  color: var(--gr-overlay-fg);
+  padding: 12px;
+  border-radius: 8px;
+  box-shadow: 0 12px 32px var(--gr-shadow);
+  border: 1px solid var(--gr-overlay-border);
+  min-width: 260px;
+  max-width: min(340px, calc(100vw - 16px));
+  cursor: default;
+  font-family: system-ui, -apple-system, sans-serif;
+}
+.gr-icon-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 26px;
+  height: 26px;
+  border-radius: 6px;
+  border: none;
+  background: transparent;
+  color: var(--gr-fg);
+  cursor: pointer;
+  padding: 0;
+}
+.gr-icon-btn-primary {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 26px;
+  height: 26px;
+  border-radius: 6px;
+  border: none;
+  background: var(--gr-accent);
+  color: var(--gr-on-accent);
+  cursor: pointer;
+  padding: 0;
+}
+.gr-scrim {
+  position: fixed;
+  inset: 0;
+  background: var(--gr-scrim);
+  z-index: 10002;
+}
+.gr-drawer {
+  position: fixed;
+  top: 0;
+  right: 0;
+  height: 100%;
+  width: min(420px, 100vw);
+  background: var(--gr-overlay-bg);
+  color: var(--gr-overlay-fg);
+  z-index: 10003;
+  box-shadow: -12px 0 32px var(--gr-shadow);
+  display: flex;
+  flex-direction: column;
+  font-family: system-ui, -apple-system, sans-serif;
+}
+.gr-drawer-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 16px 20px;
+  border-bottom: 1px solid var(--gr-overlay-border);
+}
+.gr-drawer-title {
+  font-size: 14px;
+  font-weight: 800;
+  margin: 0;
+}
+.gr-drawer-body {
+  padding: 20px;
+  overflow-y: auto;
+  flex: 1;
+}
+.gr-member-row {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 10px 0;
+  border-bottom: 1px solid var(--gr-border-soft);
+}
+.gr-member-email {
+  flex: 1;
+  font-size: 13px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.gr-select {
+  border: 1px solid var(--gr-border-strong);
+  border-radius: 4px;
+  padding: 4px 6px;
+  font-size: 12px;
+  background: var(--gr-input-bg);
+  color: var(--gr-fg);
+}
+.gr-badge {
+  font-size: 9px;
+  font-weight: 800;
+  text-transform: uppercase;
+  letter-spacing: 0.1em;
+  padding: 2px 6px;
+  border-radius: 999px;
+  background: var(--gr-badge-bg);
+  color: var(--gr-badge-fg);
+}
+.gr-section-label {
+  font-size: 10px;
+  font-weight: 800;
+  text-transform: uppercase;
+  letter-spacing: 0.15em;
+  color: var(--gr-subtle);
+  margin: 20px 0 8px;
+}
+.gr-picker-scrim {
+  position: fixed;
+  inset: 0;
+  background: var(--gr-scrim-modal);
+  z-index: 10010;
+}
+.gr-picker {
+  position: fixed;
+  top: 50%;
+  left: 50%;
+  transform: translate(-50%, -50%);
+  width: min(720px, calc(100vw - 32px));
+  max-height: min(640px, calc(100vh - 32px));
+  background: var(--gr-overlay-bg);
+  color: var(--gr-overlay-fg);
+  border-radius: 12px;
+  z-index: 10011;
+  box-shadow: 0 24px 64px var(--gr-shadow);
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  font-family: system-ui, -apple-system, sans-serif;
+}
+.gr-picker-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(120px, 1fr));
+  gap: 10px;
+}
+.gr-picker-tile {
+  position: relative;
+  aspect-ratio: 1;
+  border-radius: 8px;
+  overflow: hidden;
+  border: 2px solid transparent;
+  background: var(--gr-soft);
+  cursor: pointer;
+  padding: 0;
+}
+.gr-picker-tile-active {
+  border-color: var(--gr-accent);
+}
+.gr-picker-thumb {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  display: block;
+}
+.gr-dropzone {
+  border: 1.5px dashed var(--gr-border-strong);
+  border-radius: 8px;
+  padding: 16px;
+  text-align: center;
+  font-size: 13px;
+  color: var(--gr-muted);
+  margin-bottom: 14px;
+  cursor: pointer;
+}
+.gr-dropzone-active {
+  border-color: var(--gr-accent);
+  background: var(--gr-accent-soft);
+  color: var(--gr-accent-text);
+}
+.gr-preview-thumb {
+  width: 100%;
+  max-width: 300px;
+  height: auto;
+  max-height: 200px;
+  object-fit: contain;
+  background: var(--gr-soft);
+  border-radius: 6px;
+  display: block;
+  margin-bottom: 8px;
+}
+.gr-secondary-btn {
+  background: var(--gr-soft);
+  color: var(--gr-fg);
+  padding: 7px 12px;
+  border-radius: 4px;
+  font-size: 12px;
+  font-weight: 600;
+  border: none;
+  cursor: pointer;
+  width: 100%;
+  margin-bottom: 10px;
+}
+.gr-marker-outline {
+  position: fixed;
+  z-index: 9990;
+  pointer-events: none;
+  box-sizing: border-box;
+  border-radius: 2px;
+}
+.gr-marker-handle {
+  position: fixed;
+  z-index: 9991;
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  padding: 4px 9px 4px 7px;
+  border-radius: 6px;
+  border: none;
+  background: var(--gr-accent);
+  color: var(--gr-on-accent);
+  font-size: 11px;
+  font-weight: 700;
+  font-family: system-ui, -apple-system, sans-serif;
+  cursor: pointer;
+  box-shadow: 0 4px 12px var(--gr-shadow);
+}
+.gr-repeater-item {
+  position: relative;
+  outline: 1px dashed var(--gr-field-outline);
+  outline-offset: 2px;
+}
+.gr-repeater-toolbar {
+  position: absolute;
+  top: 4px;
+  right: 4px;
+  z-index: 20;
+  display: flex;
+  gap: 2px;
+  background: var(--gr-overlay-bg-glass);
+  color: var(--gr-overlay-fg);
+  backdrop-filter: blur(6px);
+  padding: 3px;
+  border-radius: 6px;
+  box-shadow: 0 4px 12px var(--gr-shadow);
+  border: 1px solid var(--gr-overlay-border);
+}
+.gr-repeater-add-row {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+  margin-top: 8px;
+  font-family: system-ui, -apple-system, sans-serif;
+}
+.gr-repeater-add-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 8px 14px;
+  border-radius: 6px;
+  border: 1.5px dashed var(--gr-accent);
+  background: transparent;
+  color: var(--gr-accent);
+  font-size: 12px;
+  font-weight: 700;
+  cursor: pointer;
+}
+.gr-repeater-slug-input {
+  border: 1px solid var(--gr-border-strong);
+  border-radius: 4px;
+  padding: 7px 9px;
+  font-size: 13px;
+  color: var(--gr-fg);
+  background: var(--gr-input-bg);
+  min-width: 180px;
+}
+
+/* ---- modifiers and utilities ----------------------------------------------
+ * Single-class rules that follow the components above, so they win over a
+ * component's own value when both are on one element. */
+
+.gr-text-fg { color: var(--gr-fg); }
+.gr-text-muted { color: var(--gr-muted); }
+.gr-text-subtle { color: var(--gr-subtle); }
+.gr-text-danger { color: var(--gr-danger); }
+.gr-fs-11 { font-size: 11px; }
+.gr-fs-12 { font-size: 12px; }
+.gr-fs-13 { font-size: 13px; }
+.gr-lh-15 { line-height: 1.5; }
+.gr-m-0 { margin: 0; }
+.gr-mx-6 { margin-left: 6px; margin-right: 6px; }
+.gr-mt-8 { margin-top: 8px; }
+.gr-mt-10 { margin-top: 10px; }
+.gr-mt-16 { margin-top: 16px; }
+.gr-mb-0 { margin-bottom: 0; }
+.gr-mb-8 { margin-bottom: 8px; }
+.gr-mb-12 { margin-bottom: 12px; }
+.gr-mb-16 { margin-bottom: 16px; }
+.gr-p-0 { padding: 0; }
+.gr-w-full { width: 100%; }
+.gr-w-auto { width: auto; }
+.gr-size-22 { width: 22px; height: 22px; }
+.gr-size-24 { width: 24px; height: 24px; }
+.gr-flex { display: flex; }
+.gr-inline-flex { display: inline-flex; }
+.gr-flex-1 { flex: 1; }
+.gr-items-center { align-items: center; }
+.gr-justify-between { justify-content: space-between; }
+.gr-justify-end { justify-content: flex-end; }
+.gr-gap-4 { gap: 4px; }
+.gr-gap-6 { gap: 6px; }
+.gr-gap-8 { gap: 8px; }
+.gr-no-underline { text-decoration: none; }
+
+/* A text-only button, e.g. "Forgot password?". */
+.gr-text-btn {
+  background: none;
+  border: none;
+  cursor: pointer;
+  color: var(--gr-muted);
+  font-size: 12px;
+  text-decoration: underline;
+  padding: 0 4px;
+  white-space: nowrap;
+}
+
+/* ---- editable fields ------------------------------------------------------
+ * Drawn on the developer's own elements by <GRail>, which marks them with a
+ * data attribute instead of a style attribute. Images get a separate marker. */
+
+[data-gr-field] { cursor: pointer; }
+[data-gr-field="text"] { outline: 1px dashed var(--gr-field-outline); outline-offset: 2px; }
+[data-gr-field="text"][data-gr-editing] { outline: 2px solid var(--gr-field-outline-active); cursor: text; }
+
+.gr-marker-outline { border: 1px dashed var(--gr-field-outline); }
+.gr-marker-outline[data-gr-editing] { border: 2px solid var(--gr-field-outline-active); }
+
+/* ---- drawer animation ------------------------------------------------------ */
+@keyframes gr-fade-in { from { opacity: 0 } to { opacity: 1 } }
+@keyframes gr-slide-in {
+  from { transform: translateX(100%) }
+  to   { transform: translateX(0) }
+}
+[data-guardrail-scrim] { animation: gr-fade-in 160ms ease-out both }
+[data-guardrail-team]  { animation: gr-slide-in 220ms cubic-bezier(0.32, 0.72, 0, 1) both }
+[data-guardrail-team] [data-gr-row] { animation: gr-fade-in 240ms ease-out both }
+@keyframes gr-fade-out { from { opacity: 1 } to { opacity: 0 } }
+@keyframes gr-slide-out {
+  from { transform: translateX(0) }
+  to   { transform: translateX(100%) }
+}
+[data-guardrail-scrim][data-closing] { animation: gr-fade-out 180ms ease-in both }
+[data-guardrail-team][data-closing]  { animation: gr-slide-out 180ms cubic-bezier(0.4, 0, 1, 1) both }
+@media (prefers-reduced-motion: reduce) {
+  [data-guardrail-scrim], [data-guardrail-team], [data-guardrail-team] [data-gr-row] {
+    animation: none
+  }
+}

package/dist/server/actions.d.ts

@@ -1,5 +1,5 @@
 import { GRRole, GRAsset, GRMember, OverrideValue, SetPasswordState, ActionState, OverrideRow } from '../core/types.js';
-import { GRUploadTarget, AuthRedirectParams } from '../core/adapter-types.js';
+import { GRUploadTarget, GRRevertInfo, AuthRedirectParams } from '../core/adapter-types.js';
 import 'react';
 
 /** `notice` is for a success the admin should still read, e.g. "no email was sent because...". */
@@ -28,6 +28,23 @@ declare function saveOverride(row: OverrideRow): Promise<Result>;
  * <GRail>, and vice versa.
  */
 declare function setFieldValue(id: string, value: string | OverrideValue): Promise<Result>;
+/**
+ * What reverting this field would do — "previous" (with the date of the version
+ * it goes back to), "default" (back to what the page itself says), or "none".
+ * The editor asks when it opens, so visitors never pay for it.
+ */
+declare function getRevertInfo(id: string): Promise<GRRevertInfo>;
+/**
+ * One step back for a field. Restores its previous saved value and returns it,
+ * or, with none left, removes the saved value (`action: "reset"`) so the field
+ * shows the default written in the page. Same permission as saving.
+ */
+declare function revertField(id: string): Promise<{
+    success: boolean;
+    error?: string;
+    action?: "restored" | "reset" | "none";
+    value?: OverrideValue;
+}>;
 /**
  * Authorizes an upload and returns where the browser should send the bytes.
  * Only metadata comes through here — the file itself goes straight to storage.
@@ -100,4 +117,4 @@ declare function skipSetPasswordAction(): Promise<{
     success: boolean;
 }>;
 
-export { completeAuthRedirectAction, createAssetUpload, forgotPasswordAction, inviteMember, listAssets, listTeam, loginAction, logoutAction, removeMember, saveOverride, sendPasswordResetAction, setFieldValue, setPasswordAction, skipSetPasswordAction, updateMemberRole };
+export { completeAuthRedirectAction, createAssetUpload, forgotPasswordAction, getRevertInfo, inviteMember, listAssets, listTeam, loginAction, logoutAction, removeMember, revertField, saveOverride, sendPasswordResetAction, setFieldValue, setPasswordAction, skipSetPasswordAction, updateMemberRole };

package/dist/server/actions.js

@@ -57,6 +57,39 @@ async function writeOverride(rawPathKey, rawValue) {
     return { success: false, error: "Database write failed." };
   }
 }
+async function getRevertInfo(id) {
+  const viewer = await requireRole(["admin", "editor"]);
+  const pathKey = validPathKey(id);
+  if (!viewer || !pathKey) return { kind: "none" };
+  const db = getDB();
+  if (!db.getRevertInfo) return { kind: "none" };
+  try {
+    return await db.getRevertInfo(pathKey, await resolveSiteId());
+  } catch (e) {
+    rethrowIfBailout(e);
+    return { kind: "none" };
+  }
+}
+async function revertField(id) {
+  const viewer = await requireRole(["admin", "editor"]);
+  if (!viewer) return DENIED;
+  const pathKey = validPathKey(id);
+  if (!pathKey) return { success: false, error: "A valid field id is required." };
+  const db = getDB();
+  if (!db.revertOverride) {
+    return { success: false, error: "This site's database setup doesn't keep history, so there's nothing to revert to." };
+  }
+  try {
+    const res = await db.revertOverride(pathKey, await resolveSiteId());
+    if (!res.success) return { success: false, error: res.error };
+    revalidatePath("/", "layout");
+    return res.action === "restored" ? { success: true, action: "restored", value: res.value } : { success: true, action: res.action };
+  } catch (e) {
+    rethrowIfBailout(e);
+    console.error("Guardrail: revert failed", e);
+    return { success: false, error: "Couldn't revert that." };
+  }
+}
 const IMAGE_TYPES = ["image/png", "image/jpeg", "image/webp", "image/gif", "image/avif"];
 const MAX_UPLOAD_BYTES = 10 * 1024 * 1024;
 async function createAssetUpload(file) {
@@ -381,12 +414,14 @@ export {
   completeAuthRedirectAction,
   createAssetUpload,
   forgotPasswordAction,
+  getRevertInfo,
   inviteMember,
   listAssets,
   listTeam,
   loginAction,
   logoutAction,
   removeMember,
+  revertField,
   saveOverride,
   sendPasswordResetAction,
   setFieldValue,