@antlur/backstage 1.12.16 → 1.13.0

package/src/studio/define-block.ts

@@ -1,10 +1,12 @@
 import { BlockSchema, BlockDefinition, BlockComponent, Field } from "./types";
+import type { BlockFrontstageConfig } from "./types/block";
 
 export function defineBlock<TFields extends readonly Field[]>(options: {
   name: string;
   slug: string;
   description?: string;
   schema: BlockSchema<TFields>;
+  frontstage?: BlockFrontstageConfig;
   component: BlockComponent<BlockSchema<TFields>>;
 }): BlockDefinition<TFields> {
   // Runtime validation

package/src/studio/types/block.ts

@@ -1,5 +1,6 @@
 import { Field, FieldType, FieldTypeToValue } from "./field";
 import { Entry } from "../../types/entry";
+import type { FrontstageStandardBlockType, FrontstageStandardBlockVariant } from "../../types/frontstage";
 
 type Nullable<T> = T | null;
 
@@ -28,6 +29,7 @@ export interface BlockDefinition<TFields extends readonly Field[]> {
   slug: string;
   description?: string;
   schema: BlockSchema<TFields>;
+  frontstage?: BlockFrontstageConfig;
   component: BlockComponent<BlockSchema<TFields>>;
 }
 
@@ -35,6 +37,14 @@ export interface BlockProperties {
   customClassName?: string;
 }
 
+export interface BlockFrontstageConfig {
+  enabled?: boolean;
+  type?: FrontstageStandardBlockType | string;
+  defaultVariant?: FrontstageStandardBlockVariant | string;
+  variants?: Array<FrontstageStandardBlockVariant | string>;
+  category?: string;
+}
+
 export interface BuilderBlock<TSchema extends BlockSchema<readonly Field[]>> {
   id: string;
   type: string;

package/src/types/account-block.ts

@@ -1,9 +1,30 @@
+import type { FrontstageBlockDefinition } from "./frontstage";
+import type { Field } from "../studio/types/field";
+
+export interface AccountBlockSchema {
+  fields?: readonly Field[];
+}
+
+export interface AccountBlockFrontstageConfig {
+  enabled?: boolean;
+  type?: FrontstageBlockDefinition["frontstage"] extends infer T
+    ? T extends { type: infer Type }
+      ? Type
+      : string
+    : string;
+  defaultVariant?: string;
+  variants?: string[];
+  category?: string;
+}
+
 export interface AccountBlock {
   id: string;
   account_id: string;
   slug: string;
   name: string;
-  schema: any;
+  description?: string | null;
+  schema: AccountBlockSchema;
+  frontstage?: AccountBlockFrontstageConfig | null;
   created_at: string;
   updated_at: string;
 }

package/src/types/account-layout.ts

@@ -1,14 +1,37 @@
+import type { Field } from "../studio/types/field";
+import type { FrontstageBlock, FrontstageNavItem, FrontstageTheme } from "./frontstage";
+
+export interface AccountLayoutSchema {
+  fields: Field[];
+  [key: string]: unknown;
+}
+
+export interface AccountLayoutValues {
+  theme?: Partial<FrontstageTheme["layout"]>;
+  navigation?: {
+    primary?: FrontstageNavItem[];
+    footer?: FrontstageNavItem[];
+  };
+  regions?: {
+    beforeHeader?: FrontstageBlock[];
+    afterHeader?: FrontstageBlock[];
+    beforeMain?: FrontstageBlock[];
+    afterMain?: FrontstageBlock[];
+    beforeFooter?: FrontstageBlock[];
+    footer?: FrontstageBlock[];
+    afterFooter?: FrontstageBlock[];
+  };
+  [key: string]: unknown;
+}
+
 export interface AccountLayout {
   id: string;
+  account_id?: string;
   name: string;
   slug: string;
-  schema: {
-    fields: Array<{
-      slug: string;
-      name: string;
-      type: string;
-      [key: string]: any;
-    }>;
-  };
-  data: Record<string, any>;
+  schema: AccountLayoutSchema;
+  values?: AccountLayoutValues;
+  data?: AccountLayoutValues;
+  created_at?: string;
+  updated_at?: string;
 }

package/src/types/account-module.ts

@@ -0,0 +1,38 @@
+export type AccountModuleKey =
+  | "core.modules"
+  | "core.media"
+  | "core.change_management"
+  | "core.deployments"
+  | "cms.site_builder"
+  | "cms.custom_blocks"
+  | "cms.custom_layouts"
+  | "restaurant.menus"
+  | "engagement.events"
+  | "engagement.press"
+  | (string & {});
+
+export interface AccountModule {
+  key: AccountModuleKey;
+  label: string;
+  category: string;
+  description: string;
+  default_enabled: boolean;
+  dependencies: AccountModuleKey[];
+  plan_entitlement: string | null;
+  active: boolean;
+  entitled: boolean;
+  enabled: boolean;
+}
+
+export const AccountModules = {
+  CoreModules: "core.modules",
+  CoreMedia: "core.media",
+  CoreChangeManagement: "core.change_management",
+  CoreDeployments: "core.deployments",
+  CmsSiteBuilder: "cms.site_builder",
+  CmsCustomBlocks: "cms.custom_blocks",
+  CmsCustomLayouts: "cms.custom_layouts",
+  RestaurantMenus: "restaurant.menus",
+  EngagementEvents: "engagement.events",
+  EngagementPress: "engagement.press",
+} as const satisfies Record<string, AccountModuleKey>;

package/src/types/frontstage.ts

@@ -0,0 +1,254 @@
+export type FrontstageContractVersion = "2026-05-frontstage-v1";
+
+export interface FrontstageImage {
+  url: string;
+  alt?: string;
+  width?: number;
+  height?: number;
+}
+
+export interface FrontstageNavItem {
+  label: string;
+  href: string;
+  variant?: "link" | "button";
+}
+
+export type FrontstageThemePreset = "classic-restaurant" | "premium-hospitality" | "fast-casual" | (string & {});
+export type FrontstageAlertType = "banner" | "popup";
+export type FrontstageAlertPosition = "top" | "bottom" | "center" | "bottom-right";
+
+export interface FrontstageHourRow {
+  label: string;
+  value: string;
+}
+
+export interface FrontstageSpecialHour {
+  id?: string;
+  date: string;
+  label: string;
+  title?: string;
+  value?: string;
+  notes?: string;
+}
+
+export interface FrontstageAlert {
+  id: string;
+  title: string;
+  type: FrontstageAlertType;
+  position?: FrontstageAlertPosition;
+  dismissible: boolean;
+  content?: string;
+  media?: FrontstageImage;
+  cta?: {
+    label: string;
+    href: string;
+  };
+  analytics?: {
+    name?: string;
+    category?: string;
+    label?: string;
+  };
+}
+
+export interface FrontstageBlock<TProps = Record<string, unknown>> {
+  id: string;
+  type: FrontstageStandardBlockType | string;
+  variant?: string;
+  props: TProps;
+}
+
+export type FrontstageStandardBlockType =
+  | "hero"
+  | "content"
+  | "feature-grid"
+  | "gallery"
+  | "media-feature"
+  | "menu-preview"
+  | "menu-section"
+  | "locations"
+  | "hours"
+  | "ordering"
+  | "cta"
+  | "events"
+  | "event-spotlight"
+  | "private-events"
+  | "contact-form"
+  | "testimonials"
+  | "press"
+  | "awards"
+  | "reviews"
+  | "newsletter"
+  | "faq"
+  | "html-embed";
+
+export type FrontstageStandardBlockVariant =
+  | "default"
+  | "full-bleed-image"
+  | "background-video"
+  | "image-collage"
+  | "masonry"
+  | "carousel"
+  | "editorial-strip"
+  | "mixed-media"
+  | "full-width"
+  | "inline";
+
+export interface FrontstageTheme {
+  preset?: FrontstageThemePreset;
+  colors: {
+    background: string;
+    foreground: string;
+    primary: string;
+    primaryForeground: string;
+    muted: string;
+    mutedForeground: string;
+    border: string;
+    secondary?: string;
+    secondaryForeground?: string;
+    accent?: string;
+    accentForeground?: string;
+    topbar?: string;
+    topbarForeground?: string;
+  };
+  fonts: {
+    heading: FrontstageFont;
+    body: FrontstageFont;
+  };
+  radius: string;
+  layout: {
+    container: "narrow" | "default" | "wide" | "full";
+    header: "default" | "centered-logo" | "split-nav" | "minimal";
+    footer: "simple" | "multi-column" | "location-heavy";
+  };
+}
+
+export interface FrontstageFont {
+  source: "system" | "google" | "custom";
+  name: string;
+  family: string;
+}
+
+export interface FrontstageSiteResponse {
+  contractVersion: FrontstageContractVersion;
+  site: {
+    id: string;
+    accountId: string;
+    name: string;
+    baseUrl: string;
+    locale: string;
+    timezone: string;
+    description?: string | null;
+    status: "draft" | "published" | "archived";
+  };
+  brand: {
+    logo?: FrontstageImage;
+    favicon?: { url: string };
+    social?: Record<string, string>;
+  };
+  contact?: {
+    address?: string;
+    mapUrl?: string;
+    phone?: string;
+    email?: string;
+    neighborhood?: string;
+    hours?: FrontstageHourRow[];
+    specialHours?: FrontstageSpecialHour[];
+  };
+  theme: FrontstageTheme;
+  navigation: {
+    primary: FrontstageNavItem[];
+    footer: FrontstageNavItem[];
+  };
+  alerts?: FrontstageAlert[];
+  integrations?: {
+    analytics?: { gtmId?: string };
+    ordering?: { provider?: string; url?: string };
+    reservations?: { provider?: string; url?: string };
+  };
+}
+
+export interface FrontstageResolvedLayout {
+  id: string | null;
+  name: string | null;
+  slug: string | null;
+  source?: "page" | "site" | "fallback" | "preview" | "override" | null;
+  theme?: Partial<FrontstageTheme["layout"]>;
+  navigation?: {
+    primary?: FrontstageNavItem[];
+    footer?: FrontstageNavItem[];
+  };
+  regions?: {
+    beforeHeader?: FrontstageBlock[];
+    afterHeader?: FrontstageBlock[];
+    beforeMain?: FrontstageBlock[];
+    afterMain?: FrontstageBlock[];
+    beforeFooter?: FrontstageBlock[];
+    footer?: FrontstageBlock[];
+    afterFooter?: FrontstageBlock[];
+  };
+}
+
+export interface FrontstageSeo {
+  title: string;
+  description?: string;
+  canonical?: string;
+  noindex?: boolean;
+  image?: FrontstageImage;
+}
+
+export interface FrontstagePageResponse {
+  contractVersion: FrontstageContractVersion;
+  page: {
+    id: string;
+    title: string;
+    slug: string;
+    status: "draft" | "published" | "archived";
+    seo: FrontstageSeo;
+    blocks: FrontstageBlock[];
+    layout?: FrontstageResolvedLayout;
+    alerts?: FrontstageAlert[];
+  };
+}
+
+export interface FrontstageRoute {
+  id?: string | null;
+  path: string;
+  slug?: string;
+  type?: string | null;
+  model?: string | null;
+  modelId?: string | null;
+  title?: string | null;
+  lastModified?: string | null;
+  changeFrequency?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+  priority?: number;
+}
+
+export interface FrontstageRoutesResponse {
+  routes: FrontstageRoute[];
+}
+
+export interface FrontstageBlockDefinition {
+  id: string;
+  name: string;
+  type: FrontstageStandardBlockType | string;
+  category: string;
+  description: string;
+  variants: FrontstageStandardBlockVariant[] | string[];
+  fields: unknown[];
+  frontstage?: {
+    enabled: boolean;
+    type: FrontstageStandardBlockType | string;
+    defaultVariant?: FrontstageStandardBlockVariant | string;
+    variants: FrontstageStandardBlockVariant[] | string[];
+    category: string;
+  };
+}
+
+export interface FrontstageBlocksResponse {
+  blocks: FrontstageBlockDefinition[];
+}
+
+export interface FrontstagePreviewParams {
+  preview?: boolean;
+  previewId?: string;
+}

package/src/types/index.ts

@@ -5,6 +5,7 @@ export type * from "./api";
 export type * from "./blueprint";
 export type * from "./entry";
 export type * from "./event";
+export type * from "./frontstage";
 export type * from "./instagram";
 export type * from "./location";
 export type * from "./media-item";
@@ -12,10 +13,13 @@ export type * from "./menu-category-item";
 export type * from "./menu-category";
 export type * from "./menu-item";
 export type * from "./menu";
+export { AccountModules } from "./account-module";
+export type * from "./account-module";
 export type * from "./navigation";
 export type * from "./page";
 export type * from "./press";
 export type * from "./redirect";
+export type * from "./review";
 export type * from "./route";
 export type * from "./website";
 

package/src/types/location.ts

@@ -35,6 +35,7 @@ export interface Location {
     date: string;
     openTime: string;
     closeTime: string;
+    title?: string | null;
     open24Hours: boolean;
     closed24Hours: boolean;
     notes: string;

package/src/types/review.ts

@@ -0,0 +1,16 @@
+export interface Review {
+  id: number;
+  account_id: string;
+  location_id: string | null;
+  external_id: string;
+  source: string;
+  author_name: string;
+  author_avatar: string | null;
+  rating: number;
+  text: string | null;
+  url: string | null;
+  responded_at: string | null;
+  published_at: string | null;
+  created_at: string;
+  updated_at: string;
+}

package/src/util/special-hours.ts

@@ -1,16 +1,20 @@
 import type { Location } from "../types";
 import { DateTime } from "luxon";
 
-export function getSpecialHoursFromLocation(location: Location): any[] {
+export function getSpecialHoursFromLocation(location: Location, noticeDays?: number): any[] {
   if (!location.special_hours) return [];
 
-  // filter out any special hours that are before today
-  const now = DateTime.now().startOf("day");
-  if (location.timezone) now.setZone(location.timezone);
+  const now = (location.timezone ? DateTime.now().setZone(location.timezone) : DateTime.now()).startOf("day");
+  const lastVisibleDate = typeof noticeDays === "number" ? now.plus({ days: Math.max(0, noticeDays) }) : null;
 
   const specialHours = location.special_hours.filter((specialHour) => {
-    const specialHourDate = DateTime.fromISO(specialHour.date);
-    return specialHourDate >= now;
+    const specialHourDate = DateTime.fromISO(specialHour.date, { zone: location.timezone || undefined }).startOf("day");
+
+    if (specialHourDate < now) {
+      return false;
+    }
+
+    return lastVisibleDate ? specialHourDate <= lastVisibleDate : true;
   });
 
   // sort by date