@realiizlabs/admin 0.15.6 → 0.15.7

package/dist/studio/index.d.cts

@@ -35,6 +35,12 @@ interface StudioEnv {
     identity: IdentityConfig;
     /** Optional: without it the Team tab explains that invites aren't set up. */
     service: ServiceConfig | null;
+    /**
+     * Optional: the host's deploy hook (a Vercel Deploy Hook URL for the production
+     * branch). When a Studio update's rebuild never starts, the tracker offers
+     * "Nudge the build", which POSTs here. Without it the tracker says to tell {supportName}.
+     */
+    deployHookUrl?: string | null;
 }
 interface StudioConfig {
     /** The site's registry, keyed by type id. */
@@ -217,6 +223,14 @@ declare function updateVersionOf(pr: {
     title: string;
     branch: string;
 }): string | null;
+type NudgeOutcome = {
+    state: "sent";
+} | {
+    state: "unavailable";
+} | {
+    state: "error";
+    message: string;
+};
 declare function compareVersions(a: string, b: string): number;
 
 declare function createStudio(config: StudioConfig): {
@@ -305,6 +319,7 @@ declare function createStudio(config: StudioConfig): {
             slug: string;
         }) => Promise<PublishResult | never>;
         updateStudio: (number: number) => Promise<MergeOutcome>;
+        nudgeBuild: () => Promise<NudgeOutcome>;
     };
     authHandlers: {
         callback: (request: Request) => Promise<Response>;
@@ -315,4 +330,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 StudioUpdate, type TeamState, compareVersions, createStudio, pendingLabel, pendingText, updateVersionOf };
+export { type ActionResult, type DiscardOutcome, type IdentityConfig, ImagePayload, type ListItem, type Located, type MergeOutcome, NotHere, type NudgeOutcome, 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

@@ -35,6 +35,12 @@ interface StudioEnv {
     identity: IdentityConfig;
     /** Optional: without it the Team tab explains that invites aren't set up. */
     service: ServiceConfig | null;
+    /**
+     * Optional: the host's deploy hook (a Vercel Deploy Hook URL for the production
+     * branch). When a Studio update's rebuild never starts, the tracker offers
+     * "Nudge the build", which POSTs here. Without it the tracker says to tell {supportName}.
+     */
+    deployHookUrl?: string | null;
 }
 interface StudioConfig {
     /** The site's registry, keyed by type id. */
@@ -217,6 +223,14 @@ declare function updateVersionOf(pr: {
     title: string;
     branch: string;
 }): string | null;
+type NudgeOutcome = {
+    state: "sent";
+} | {
+    state: "unavailable";
+} | {
+    state: "error";
+    message: string;
+};
 declare function compareVersions(a: string, b: string): number;
 
 declare function createStudio(config: StudioConfig): {
@@ -305,6 +319,7 @@ declare function createStudio(config: StudioConfig): {
             slug: string;
         }) => Promise<PublishResult | never>;
         updateStudio: (number: number) => Promise<MergeOutcome>;
+        nudgeBuild: () => Promise<NudgeOutcome>;
     };
     authHandlers: {
         callback: (request: Request) => Promise<Response>;
@@ -315,4 +330,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 StudioUpdate, type TeamState, compareVersions, createStudio, pendingLabel, pendingText, updateVersionOf };
+export { type ActionResult, type DiscardOutcome, type IdentityConfig, ImagePayload, type ListItem, type Located, type MergeOutcome, NotHere, type NudgeOutcome, 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

@@ -1104,7 +1104,7 @@ function makeHandlers(ctx) {
 }
 
 // src/version.ts
-var ADMIN_VERSION = "0.15.6" ;
+var ADMIN_VERSION = "0.15.7" ;
 
 // src/studio/update.ts
 var PACKAGE_NAME = "@realiizlabs/admin";
@@ -1163,7 +1163,18 @@ function makeUpdate(config, ctx, deps = {}) {
       return { state: "error", message: err instanceof Error ? err.message : String(err) };
     }
   };
-  return { studioUpdate, updateStudio };
+  const nudgeBuild = async () => {
+    await ctx.requireAdmin({ minimumRole: "owner" });
+    const url = config.env().deployHookUrl;
+    if (!url) return { state: "unavailable" };
+    try {
+      const res = await (deps.fetch ?? fetch)(url, { method: "POST" });
+      return res.ok ? { state: "sent" } : { state: "error", message: `The hosting service answered ${res.status}.` };
+    } catch (err) {
+      return { state: "error", message: err instanceof Error ? err.message : String(err) };
+    }
+  };
+  return { studioUpdate, updateStudio, nudgeBuild };
 }
 function compareVersions(a, b) {
   const pa = a.split(".").map(Number), pb = b.split(".").map(Number);
@@ -1182,6 +1193,7 @@ function createStudio(config) {
   const update = makeUpdate(config, ctx);
   const actions = {
     updateStudio: update.updateStudio,
+    nudgeBuild: update.nudgeBuild,
     ...makePublish(config, registry, ctx, readers),
     ...makeMerge(config, ctx, readers),
     ...makePreview(ctx),