@realiizlabs/admin 0.14.1 → 0.15.0

package/dist/studio/index.d.cts

@@ -5,6 +5,7 @@ import { a as PullRequestStatus } from '../types-BP5G1myE.cjs';
 import { C as ContentTypeEntry } from '../types-DeHdasdP.cjs';
 import * as zod from 'zod';
 import * as zod_v4_core from 'zod/v4/core';
+export { A as ADMIN_VERSION } from '../version-DMS0azUx.cjs';
 import { R as RequireOptions } from '../roles-BjWuj2_v.cjs';
 import '@supabase/supabase-js';
 
@@ -190,6 +191,34 @@ type TeamState = {
     error: string;
 };
 
+/**
+ * Updating Studio from Studio. A new package version arrives in a site as a
+ * Dependabot pull request; this finds it, reads its release notes from the
+ * public npm registry, and merges it (owners and staff only) the same way a
+ * content change is published — only when the checks are green.
+ */
+
+interface StudioUpdate {
+    /** The pull request that carries the update. */
+    number: number;
+    htmlUrl: string;
+    /** The version the update installs. */
+    version: string;
+    /** The version running now. */
+    currentVersion: string;
+    state: "checking" | "ready" | "failed";
+    failingCheck: string | null;
+    previewUrl: string | null;
+    /** Plain-English release notes for `version`, from the npm registry; null when unavailable. */
+    notes: string | null;
+}
+/** The version a Dependabot PR bumps @realiizlabs/admin to, from its title or branch; null for any other PR. */
+declare function updateVersionOf(pr: {
+    title: string;
+    branch: string;
+}): string | null;
+declare function compareVersions(a: string, b: string): number;
+
 declare function createStudio(config: StudioConfig): {
     config: StudioConfig;
     isConfigured: () => boolean;
@@ -201,6 +230,7 @@ declare function createStudio(config: StudioConfig): {
         locate: (path: string) => Located | null;
         publicUrlFor: (typeId: string, slug: string) => string | null;
         publicDirFor: (typeId: string) => string;
+        studioUpdate: () => Promise<StudioUpdate | null>;
         listPendingChanges: () => Promise<Map<string, PendingChange>>;
         pendingFor: (path: string) => Promise<PendingChange | null>;
         pathOf: (typeId: string, slug: string) => Promise<string | null>;
@@ -274,6 +304,7 @@ declare function createStudio(config: StudioConfig): {
             type: string;
             slug: string;
         }) => Promise<PublishResult | never>;
+        updateStudio: (number: number) => Promise<MergeOutcome>;
     };
     authHandlers: {
         callback: (request: Request) => Promise<Response>;
@@ -284,4 +315,4 @@ type Studio = ReturnType<typeof createStudio>;
 type StudioActions = Studio["actions"];
 type StudioReaders = Studio["readers"];
 
-export { type ActionResult, type DiscardOutcome, type IdentityConfig, ImagePayload, type ListItem, type Located, type MergeOutcome, NotHere, type PendingChange, type PendingState, type PrSummary, type PublishInput, type PublishResult, type RepoConfig, type ServiceConfig, type Session, type Studio, type StudioActions, type StudioConfig, type StudioEnv, type StudioReaders, type TeamState, createStudio, pendingLabel, pendingText };
+export { type ActionResult, type DiscardOutcome, type IdentityConfig, ImagePayload, type ListItem, type Located, type MergeOutcome, NotHere, type PendingChange, type PendingState, type PrSummary, type PublishInput, type PublishResult, type RepoConfig, type ServiceConfig, type Session, type Studio, type StudioActions, type StudioConfig, type StudioEnv, type StudioReaders, type StudioUpdate, type TeamState, compareVersions, createStudio, pendingLabel, pendingText, updateVersionOf };

package/dist/studio/index.d.ts

@@ -5,6 +5,7 @@ import { a as PullRequestStatus } from '../types-BP5G1myE.js';
 import { C as ContentTypeEntry } from '../types-DeHdasdP.js';
 import * as zod from 'zod';
 import * as zod_v4_core from 'zod/v4/core';
+export { A as ADMIN_VERSION } from '../version-DMS0azUx.js';
 import { R as RequireOptions } from '../roles-Dnwj-DAm.js';
 import '@supabase/supabase-js';
 
@@ -190,6 +191,34 @@ type TeamState = {
     error: string;
 };
 
+/**
+ * Updating Studio from Studio. A new package version arrives in a site as a
+ * Dependabot pull request; this finds it, reads its release notes from the
+ * public npm registry, and merges it (owners and staff only) the same way a
+ * content change is published — only when the checks are green.
+ */
+
+interface StudioUpdate {
+    /** The pull request that carries the update. */
+    number: number;
+    htmlUrl: string;
+    /** The version the update installs. */
+    version: string;
+    /** The version running now. */
+    currentVersion: string;
+    state: "checking" | "ready" | "failed";
+    failingCheck: string | null;
+    previewUrl: string | null;
+    /** Plain-English release notes for `version`, from the npm registry; null when unavailable. */
+    notes: string | null;
+}
+/** The version a Dependabot PR bumps @realiizlabs/admin to, from its title or branch; null for any other PR. */
+declare function updateVersionOf(pr: {
+    title: string;
+    branch: string;
+}): string | null;
+declare function compareVersions(a: string, b: string): number;
+
 declare function createStudio(config: StudioConfig): {
     config: StudioConfig;
     isConfigured: () => boolean;
@@ -201,6 +230,7 @@ declare function createStudio(config: StudioConfig): {
         locate: (path: string) => Located | null;
         publicUrlFor: (typeId: string, slug: string) => string | null;
         publicDirFor: (typeId: string) => string;
+        studioUpdate: () => Promise<StudioUpdate | null>;
         listPendingChanges: () => Promise<Map<string, PendingChange>>;
         pendingFor: (path: string) => Promise<PendingChange | null>;
         pathOf: (typeId: string, slug: string) => Promise<string | null>;
@@ -274,6 +304,7 @@ declare function createStudio(config: StudioConfig): {
             type: string;
             slug: string;
         }) => Promise<PublishResult | never>;
+        updateStudio: (number: number) => Promise<MergeOutcome>;
     };
     authHandlers: {
         callback: (request: Request) => Promise<Response>;
@@ -284,4 +315,4 @@ type Studio = ReturnType<typeof createStudio>;
 type StudioActions = Studio["actions"];
 type StudioReaders = Studio["readers"];
 
-export { type ActionResult, type DiscardOutcome, type IdentityConfig, ImagePayload, type ListItem, type Located, type MergeOutcome, NotHere, type PendingChange, type PendingState, type PrSummary, type PublishInput, type PublishResult, type RepoConfig, type ServiceConfig, type Session, type Studio, type StudioActions, type StudioConfig, type StudioEnv, type StudioReaders, type TeamState, createStudio, pendingLabel, pendingText };
+export { type ActionResult, type DiscardOutcome, type IdentityConfig, ImagePayload, type ListItem, type Located, type MergeOutcome, NotHere, type PendingChange, type PendingState, type PrSummary, type PublishInput, type PublishResult, type RepoConfig, type ServiceConfig, type Session, type Studio, type StudioActions, type StudioConfig, type StudioEnv, type StudioReaders, type StudioUpdate, type TeamState, compareVersions, createStudio, pendingLabel, pendingText, updateVersionOf };

package/dist/studio/index.js

@@ -1095,18 +1095,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.0" ;
+
+// 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),
@@ -1120,12 +1195,12 @@ 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)
   };
 }
 
-export { IMAGE_ERRORS, IMAGE_LIMITS, NotHere, createStudio, decodedSize, pendingLabel, pendingText, validateImages };
+export { ADMIN_VERSION, IMAGE_ERRORS, IMAGE_LIMITS, NotHere, compareVersions, createStudio, decodedSize, pendingLabel, pendingText, updateVersionOf, validateImages };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map