@agent-native/core 0.172.3 → 0.172.4

package/corpus/templates/calendar/server/lib/find-time.ts

@@ -3,6 +3,12 @@ import type {
   FindTimeParticipant,
   FindTimeSlot,
 } from "../../shared/api.js";
+import {
+  addDaysToDateKey,
+  dateKeyInTimezone,
+  dateTimeInTimezoneToIso,
+  isCalendarTimezone,
+} from "../../shared/timezone.js";
 
 export interface AvailabilitySchedule {
   timezone: string;
@@ -37,108 +43,24 @@ const DEFAULT_SCHEDULE: AvailabilitySchedule["schedule"] = {
   sunday: [],
 };
 
+/**
+ * These live in shared/timezone.ts so the grid, the actions, and this module
+ * cannot drift on DST edges. Kept under their original names because callers
+ * across the template import them from here.
+ */
 export function normalizeTimezone(timezone?: string): string {
-  if (!timezone) return "UTC";
-  try {
-    new Intl.DateTimeFormat("en-US", { timeZone: timezone }).format();
-    return timezone;
-  } catch {
-    return "UTC";
-  }
-}
-
-function datePartsInTimezone(date: Date, timezone: string) {
-  const parts = new Intl.DateTimeFormat("en-US", {
-    timeZone: timezone,
-    hourCycle: "h23",
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit",
-    hour: "2-digit",
-    minute: "2-digit",
-    second: "2-digit",
-  }).formatToParts(date);
-  const get = (type: string) =>
-    Number(parts.find((part) => part.type === type)?.value ?? "0");
-  return {
-    year: get("year"),
-    month: get("month"),
-    day: get("day"),
-    hour: get("hour"),
-    minute: get("minute"),
-    second: get("second"),
-  };
+  return isCalendarTimezone(timezone) ? timezone : "UTC";
 }
 
-export function dateOnlyInTimezone(date: Date, timezone: string): string {
-  const parts = datePartsInTimezone(date, timezone);
-  return [
-    String(parts.year).padStart(4, "0"),
-    String(parts.month).padStart(2, "0"),
-    String(parts.day).padStart(2, "0"),
-  ].join("-");
-}
-
-export function addDaysToDateOnly(dateOnly: string, days: number): string {
-  const [year, month, day] = dateOnly.split("-").map(Number);
-  const date = new Date(Date.UTC(year, month - 1, day + days));
-  return [
-    String(date.getUTCFullYear()).padStart(4, "0"),
-    String(date.getUTCMonth() + 1).padStart(2, "0"),
-    String(date.getUTCDate()).padStart(2, "0"),
-  ].join("-");
-}
-
-function offsetMsForTimezone(date: Date, timezone: string): number {
-  const parts = datePartsInTimezone(date, timezone);
-  const asUtc = Date.UTC(
-    parts.year,
-    parts.month - 1,
-    parts.day,
-    parts.hour,
-    parts.minute,
-    parts.second,
-  );
-  return asUtc - date.getTime();
-}
+export const dateOnlyInTimezone = dateKeyInTimezone;
+export const addDaysToDateOnly = addDaysToDateKey;
 
 export function zonedDateTimeToUtcIso(
   dateOnly: string,
   time: string,
   timezone: string,
 ): string {
-  const [year, month, day] = dateOnly.split("-").map(Number);
-  const [hour, minute] = time.split(":").map(Number);
-  const wallClockUtc = Date.UTC(year, month - 1, day, hour, minute, 0);
-  const offsets = new Set<number>();
-  for (let hours = -36; hours <= 36; hours += 6) {
-    offsets.add(
-      offsetMsForTimezone(
-        new Date(wallClockUtc + hours * 60 * 60 * 1000),
-        timezone,
-      ),
-    );
-  }
-
-  const candidates = [...offsets]
-    .map((offset) => new Date(wallClockUtc - offset))
-    .map((candidate) => ({
-      candidate,
-      localWallClock:
-        candidate.getTime() + offsetMsForTimezone(candidate, timezone),
-    }))
-    .sort((a, b) => {
-      const aDelta = a.localWallClock - wallClockUtc;
-      const bDelta = b.localWallClock - wallClockUtc;
-      if (aDelta === 0 && bDelta === 0) {
-        return a.candidate.getTime() - b.candidate.getTime();
-      }
-      if (aDelta >= 0 && bDelta < 0) return -1;
-      if (aDelta < 0 && bDelta >= 0) return 1;
-      return Math.abs(aDelta) - Math.abs(bDelta);
-    });
-
-  return candidates[0].candidate.toISOString();
+  return dateTimeInTimezoneToIso(dateOnly, time, timezone);
 }
 
 function normalizeDateBound(value: string, timezone: string): string {

package/corpus/templates/calendar/shared/settings.ts

@@ -3,6 +3,7 @@ import {
   DEFAULT_CALENDAR_WEEK_START,
   isCalendarWeekStart,
 } from "./calendar-week.js";
+import { isCalendarTimezone } from "./timezone.js";
 
 export const DEFAULT_SETTINGS: Settings = {
   timezone: "America/New_York",
@@ -12,33 +13,38 @@ export const DEFAULT_SETTINGS: Settings = {
   weekStart: DEFAULT_CALENDAR_WEEK_START,
 };
 
-export function normalizeCalendarSettings(input: unknown): Settings {
+export function normalizeCalendarSettings(
+  input: unknown,
+  fallbacks?: Partial<Settings>,
+): Settings {
+  const defaults = fallbacks
+    ? normalizeCalendarSettings(fallbacks)
+    : DEFAULT_SETTINGS;
   const raw =
     input && typeof input === "object"
       ? (input as Partial<Settings>)
       : ({} as Partial<Settings>);
 
   return {
-    timezone:
-      typeof raw.timezone === "string"
-        ? raw.timezone
-        : DEFAULT_SETTINGS.timezone,
+    timezone: isCalendarTimezone(raw.timezone)
+      ? raw.timezone
+      : defaults.timezone,
     bookingPageTitle:
       typeof raw.bookingPageTitle === "string"
         ? raw.bookingPageTitle
-        : DEFAULT_SETTINGS.bookingPageTitle,
+        : defaults.bookingPageTitle,
     bookingPageDescription:
       typeof raw.bookingPageDescription === "string"
         ? raw.bookingPageDescription
-        : DEFAULT_SETTINGS.bookingPageDescription,
+        : defaults.bookingPageDescription,
     defaultEventDuration:
       typeof raw.defaultEventDuration === "number" &&
       Number.isFinite(raw.defaultEventDuration) &&
       raw.defaultEventDuration > 0
         ? raw.defaultEventDuration
-        : DEFAULT_SETTINGS.defaultEventDuration,
+        : defaults.defaultEventDuration,
     weekStart: isCalendarWeekStart(raw.weekStart)
       ? raw.weekStart
-      : DEFAULT_SETTINGS.weekStart,
+      : defaults.weekStart,
   };
 }

package/corpus/templates/calendar/shared/timezone.ts

@@ -0,0 +1,127 @@
+/**
+ * Constructing an `Intl.DateTimeFormat` costs ~45µs, and resolving one wall
+ * clock probes the zone a dozen times — so formatters are cached per zone and
+ * option set. Only the date varies per call, and that is an argument to
+ * `format`/`formatToParts`, never part of the formatter.
+ */
+const formatterCache = new Map<string, Intl.DateTimeFormat>();
+
+export function timezoneFormatter(
+  timezone: string | undefined,
+  options: Intl.DateTimeFormatOptions,
+  locale?: string,
+): Intl.DateTimeFormat {
+  const key = `${locale ?? ""}\u0000${timezone ?? ""}\u0000${JSON.stringify(options)}`;
+  let formatter = formatterCache.get(key);
+  if (!formatter) {
+    formatter = new Intl.DateTimeFormat(locale, {
+      ...options,
+      timeZone: timezone,
+    });
+    formatterCache.set(key, formatter);
+  }
+  return formatter;
+}
+
+/**
+ * Whether a value names a zone this calendar can use. Only a `RangeError` means
+ * Intl rejected the zone; any other failure is a real fault and must surface
+ * instead of being reported as "invalid".
+ *
+ * Several older helpers around the template still run their own version of this
+ * check with a bare `catch`; prefer this one and delete those as you touch them.
+ */
+export function isCalendarTimezone(value: unknown): value is string {
+  if (typeof value !== "string" || !value.trim()) return false;
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone: value }).format();
+    return true;
+  } catch (error) {
+    if (error instanceof RangeError) return false;
+    throw error;
+  }
+}
+
+const OFFSET_PROBE_OPTIONS: Intl.DateTimeFormatOptions = {
+  hourCycle: "h23",
+  year: "numeric",
+  month: "2-digit",
+  day: "2-digit",
+  hour: "2-digit",
+  minute: "2-digit",
+  second: "2-digit",
+};
+
+function offsetMsInTimezone(date: Date, timezone: string): number {
+  const parts = timezoneFormatter(
+    timezone,
+    OFFSET_PROBE_OPTIONS,
+    "en-US",
+  ).formatToParts(date);
+  const values = new Map(parts.map((part) => [part.type, part.value]));
+  const asUtc = Date.UTC(
+    Number(values.get("year")),
+    Number(values.get("month")) - 1,
+    Number(values.get("day")),
+    Number(values.get("hour")),
+    Number(values.get("minute")),
+    Number(values.get("second")),
+  );
+  return asUtc - date.getTime();
+}
+
+export function dateTimeInTimezoneToIso(
+  date: string,
+  time: string,
+  timezone: string,
+): string {
+  const [year, month, day] = date.split("-").map(Number);
+  const [hour, minute] = time.split(":").map(Number);
+  const wallClockUtc = Date.UTC(year, month - 1, day, hour, minute, 0);
+  const offsets = new Set<number>();
+  for (let hours = -36; hours <= 36; hours += 6) {
+    offsets.add(
+      offsetMsInTimezone(
+        new Date(wallClockUtc + hours * 60 * 60 * 1000),
+        timezone,
+      ),
+    );
+  }
+
+  const candidates = [...offsets]
+    .map((offset) => new Date(wallClockUtc - offset))
+    .map((candidate) => ({
+      candidate,
+      localWallClock:
+        candidate.getTime() + offsetMsInTimezone(candidate, timezone),
+    }))
+    .sort((a, b) => {
+      const aDelta = a.localWallClock - wallClockUtc;
+      const bDelta = b.localWallClock - wallClockUtc;
+      if (aDelta === 0 && bDelta === 0) {
+        return a.candidate.getTime() - b.candidate.getTime();
+      }
+      if (aDelta >= 0 && bDelta < 0) return -1;
+      if (aDelta < 0 && bDelta >= 0) return 1;
+      return Math.abs(aDelta) - Math.abs(bDelta);
+    });
+
+  return candidates[0].candidate.toISOString();
+}
+
+export function dateKeyInTimezone(date: Date, timezone: string): string {
+  const parts = timezoneFormatter(
+    timezone,
+    { year: "numeric", month: "2-digit", day: "2-digit" },
+    "en-CA",
+  ).formatToParts(date);
+  const value = (type: string) =>
+    parts.find((part) => part.type === type)!.value;
+  return `${value("year")}-${value("month")}-${value("day")}`;
+}
+
+export function addDaysToDateKey(date: string, amount: number): string {
+  const [year, month, day] = date.split("-").map(Number);
+  const shifted = new Date(Date.UTC(year, month - 1, day + amount));
+  return shifted.toISOString().slice(0, 10);
+}

package/corpus/templates/slides/actions/list-decks.ts

@@ -1,4 +1,5 @@
 import { defineAction } from "@agent-native/core";
+import { isPostgres } from "@agent-native/core/db";
 import { buildDeepLink } from "@agent-native/core/server";
 import { getRequestUserEmail } from "@agent-native/core/server/request-context";
 import { accessFilter } from "@agent-native/core/sharing";
@@ -13,6 +14,16 @@ function slidesDeepLink(): string {
   return buildDeepLink({ app: "slides", view: "list" });
 }
 
+function parseJsonProjection(value: unknown, label: string): unknown {
+  if (value === null || value === undefined) return undefined;
+  if (typeof value !== "string") return value;
+  try {
+    return JSON.parse(value);
+  } catch (error) {
+    throw new Error(`Invalid ${label} JSON projection`, { cause: error });
+  }
+}
+
 export default defineAction({
   description: "List all decks from the database with metadata.",
   schema: z.object({
@@ -26,13 +37,20 @@ export default defineAction({
       .describe(
         "Set to 'true' for full frontend deck payloads; omitted returns metadata only",
       ),
+    includePreview: z
+      .enum(["true", "false"])
+      .optional()
+      .describe(
+        "Set to 'true' with light mode to include only the first slide preview",
+      ),
     light: z
       .enum(["true", "false"])
       .optional()
       .describe(
         "Set to 'true' for a minimal id/title/updatedAt/visibility listing " +
           "used for cheap add/remove diffing (e.g. background polling). " +
-          "Never reads the deck body — no slides, no slideCount.",
+          "By default never reads the deck body — no slides, no slideCount. " +
+          "Use includePreview for the first slide only.",
       ),
     createdBy: z
       .enum(["all", "me"])
@@ -50,7 +68,7 @@ export default defineAction({
     const ownerEmail = getRequestUserEmail();
     const normalizedOwnerEmail = normalizeOwnerEmail(ownerEmail);
     if (
-      args.includeSlides === "true" &&
+      (args.includeSlides === "true" || args.includePreview === "true") &&
       ctx?.caller === "frontend" &&
       normalizedOwnerEmail === null
     ) {
@@ -75,9 +93,65 @@ export default defineAction({
     if (args.light === "true") {
       // Column-projected listing for cheap add/remove diffing (the client's
       // background poll and SSE-reconnect resync). The `data` column holds
-      // each deck's entire slide JSON and can be large — never select it
-      // here. Callers that need slide content use `includeSlides: "true"` or
-      // fetch the specific deck via `get-deck`.
+      // each deck's entire slide JSON and can be large. The home grid opts
+      // into the separate preview projection; polling keeps the metadata-only
+      // path below.
+      if (args.includePreview === "true") {
+        // Keep the list bounded at the database boundary. `data` is an opaque
+        // full-deck blob, so selecting it and parsing it here scales with every
+        // slide even though the caller only needs the first one.
+        const previewSlideProjection = isPostgres()
+          ? sql<
+              string | null
+            >`(${schema.decks.data}::jsonb -> 'slides' -> 0)::text`
+          : sql<
+              string | null
+            >`json_extract(${schema.decks.data}, '$.slides[0]')`;
+        const aspectRatioProjection = isPostgres()
+          ? sql<string | null>`(${schema.decks.data}::jsonb ->> 'aspectRatio')`
+          : sql<
+              string | null
+            >`json_extract(${schema.decks.data}, '$.aspectRatio')`;
+        const rows = await db
+          .select({
+            id: schema.decks.id,
+            title: schema.decks.title,
+            updatedAt: schema.decks.updatedAt,
+            visibility: schema.decks.visibility,
+            ownerEmail: schema.decks.ownerEmail,
+            previewSlide: previewSlideProjection,
+            aspectRatio: aspectRatioProjection,
+          })
+          .from(schema.decks)
+          .where(where)
+          .orderBy(desc(schema.decks.updatedAt));
+
+        return {
+          count: rows.length,
+          decks: rows.map((row) => {
+            const previewSlide = parseJsonProjection(
+              row.previewSlide,
+              "first slide preview",
+            );
+            return {
+              id: row.id,
+              title: row.title,
+              updatedAt: row.updatedAt,
+              visibility: row.visibility,
+              createdByMe:
+                normalizedOwnerEmail !== null &&
+                normalizeOwnerEmail(row.ownerEmail) === normalizedOwnerEmail,
+              ...(previewSlide && typeof previewSlide === "object"
+                ? { previewSlide }
+                : {}),
+              ...(typeof row.aspectRatio === "string"
+                ? { aspectRatio: row.aspectRatio }
+                : {}),
+            };
+          }),
+        };
+      }
+
       const rows = await db
         .select({
           id: schema.decks.id,

package/corpus/templates/slides/app/components/deck/DeckCard.tsx

@@ -8,6 +8,7 @@ import {
   IconCopy,
   IconPencil,
   IconPlus,
+  IconShare2,
   IconStar,
   IconStarFilled,
 } from "@tabler/icons-react";
@@ -24,6 +25,7 @@ import {
 import type { Deck } from "@/context/DeckContext";
 import { getDeckListingPreviewFrameStyle } from "@/lib/deck-preview-frame";
 
+import ShareDialog from "../editor/ShareDialog";
 import SlideRenderer from "./SlideRenderer";
 
 interface DeckCardProps {
@@ -48,16 +50,18 @@ export default function DeckCard({
   onSetWorkspaceDefault,
 }: DeckCardProps) {
   const t = useT();
-  const firstSlide = deck.slides?.[0];
+  const firstSlide = deck.previewSlide ?? deck.slides?.[0];
   const previewFrameStyle = getDeckListingPreviewFrameStyle(deck.aspectRatio);
   const [isRenaming, setIsRenaming] = useState(false);
   const [menuOpen, setMenuOpen] = useState(false);
   const [renameValue, setRenameValue] = useState(deck.title);
   const [contextOpen, setContextOpen] = useState(false);
+  const [shareOpen, setShareOpen] = useState(false);
   const inputRef = useRef<HTMLInputElement>(null);
   const pendingRenameRef = useRef(false);
   const pendingDeleteRef = useRef(false);
   const pendingWorkspaceDefaultRef = useRef(false);
+  const pendingShareRef = useRef(false);
 
   useEffect(() => {
     if (isRenaming) {
@@ -206,6 +210,11 @@ export default function DeckCard({
                 pendingWorkspaceDefaultRef.current = false;
                 onSetWorkspaceDefault?.(deck.id, !isWorkspaceDefault);
               }
+              if (pendingShareRef.current) {
+                e.preventDefault();
+                pendingShareRef.current = false;
+                setTimeout(() => setShareOpen(true), 0);
+              }
               if (pendingDeleteRef.current) {
                 e.preventDefault();
                 pendingDeleteRef.current = false;
@@ -226,6 +235,16 @@ export default function DeckCard({
               <IconCopy className="w-3.5 h-3.5 me-2" />
               Duplicate
             </DropdownMenuItem>
+            <DropdownMenuItem
+              onSelect={(event) => {
+                event.preventDefault();
+                pendingShareRef.current = true;
+                setMenuOpen(false);
+              }}
+            >
+              <IconShare2 className="w-3.5 h-3.5 me-2" />
+              {t("share.title")}
+            </DropdownMenuItem>
             <DropdownMenuItem
               onSelect={(event) => {
                 event.preventDefault();
@@ -279,6 +298,7 @@ export default function DeckCard({
         }}
         canManage={deck.createdByMe}
       />
+      <ShareDialog deck={deck} open={shareOpen} onOpenChange={setShareOpen} />
     </div>
   );
 }

package/corpus/templates/slides/app/components/editor/ShareDialog.tsx

@@ -7,6 +7,7 @@ import {
   cloneElement,
   isValidElement,
   useCallback,
+  useEffect,
   useState,
   type MouseEvent,
   type ReactElement,
@@ -22,7 +23,10 @@ import { getDeckShareLinkOrder } from "@/lib/deck-share-links";
 interface ShareDialogProps {
   deck: Deck;
   /** Trigger element rendered as the dialog anchor (usually the Share button). */
-  children: ReactNode;
+  children?: ReactNode;
+  /** Controlled opening for menu items that must wait for their parent to close. */
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
 }
 
 function getShareUrls(deckId: string) {
@@ -40,7 +44,12 @@ function getShareUrls(deckId: string) {
   };
 }
 
-export default function ShareDialog({ deck, children }: ShareDialogProps) {
+export default function ShareDialog({
+  deck,
+  children,
+  open: requestedOpen,
+  onOpenChange,
+}: ShareDialogProps) {
   const t = useT();
   const { isLocal } = useDbStatus();
   const [open, setOpen] = useState(false);
@@ -50,6 +59,14 @@ export default function ShareDialog({ deck, children }: ShareDialogProps) {
   } | null>(null);
   const [creatingLink, setCreatingLink] = useState(false);
 
+  const setDialogOpen = useCallback(
+    (nextOpen: boolean) => {
+      setOpen(nextOpen);
+      onOpenChange?.(nextOpen);
+    },
+    [onOpenChange],
+  );
+
   const shareUrls = getShareUrls(deck.id);
   const shareLinkOrder = getDeckShareLinkOrder(deck.visibility);
   const shareToken =
@@ -61,11 +78,11 @@ export default function ShareDialog({ deck, children }: ShareDialogProps) {
 
   const openShareDialog = useCallback(async () => {
     if (isLocal) {
-      setOpen(true);
+      setDialogOpen(true);
       return;
     }
     if (shareToken) {
-      setOpen(true);
+      setDialogOpen(true);
       return;
     }
     if (creatingLink) return;
@@ -97,29 +114,40 @@ export default function ShareDialog({ deck, children }: ShareDialogProps) {
         throw new Error(t("share.createFailed"));
       }
       setShareLink({ deckId: deck.id, token: payload.shareToken });
-      setOpen(true);
+      setDialogOpen(true);
     } catch (error) {
       toast.error(
         error instanceof Error ? error.message : t("share.createFailed"),
       );
+      if (requestedOpen !== undefined) setDialogOpen(false);
     } finally {
       setCreatingLink(false);
     }
-  }, [creatingLink, deck, isLocal, shareToken, t]);
+  }, [creatingLink, deck, isLocal, setDialogOpen, shareToken, t]);
+
+  useEffect(() => {
+    if (requestedOpen === undefined) return;
+    if (!requestedOpen) {
+      setOpen(false);
+      return;
+    }
+    if (!open) void openShareDialog();
+  }, [open, openShareDialog, requestedOpen]);
 
-  const trigger = isValidElement(children)
-    ? (() => {
-        const triggerElement = children as ReactElement<{
-          onClick?: (event: MouseEvent) => void;
-        }>;
-        return cloneElement(triggerElement, {
-          onClick: (event) => {
-            triggerElement.props.onClick?.(event);
-            if (!event.defaultPrevented) void openShareDialog();
-          },
-        });
-      })()
-    : children;
+  const trigger =
+    children && isValidElement(children)
+      ? (() => {
+          const triggerElement = children as ReactElement<{
+            onClick?: (event: MouseEvent) => void;
+          }>;
+          return cloneElement(triggerElement, {
+            onClick: (event) => {
+              triggerElement.props.onClick?.(event);
+              if (!event.defaultPrevented) void openShareDialog();
+            },
+          });
+        })()
+      : children;
 
   return (
     <>
@@ -128,12 +156,12 @@ export default function ShareDialog({ deck, children }: ShareDialogProps) {
         <CloudUpgrade
           title={t("share.title")}
           description={t("share.cloudUpgradeDescription")}
-          onClose={() => setOpen(false)}
+          onClose={() => setDialogOpen(false)}
         />
       ) : null}
       <CoreShareDialog
         open={open && !isLocal}
-        onClose={() => setOpen(false)}
+        onClose={() => setDialogOpen(false)}
         resourceType="deck"
         resourceId={deck.id}
         resourceTitle={deck.title}