@the-smithy/hearth 0.23.0 → 0.24.1

package/dist/{chunk-QDCU7YWV.js → chunk-3LZQGXTQ.js}

@@ -73,7 +73,7 @@ function createCore(options) {
     throw new Error("Hearth: the API key is secret, so the client only runs on the server. Fetch content in server code, or pass allowBrowser: true if you understand the risk.");
   }
   const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
-  const doFetch = options.fetch ?? globalThis.fetch;
+  const doFetch = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
   const timeoutMs = options.timeoutMs ?? 1e4;
   const retries = options.retries ?? 2;
   const hooks = options.hooks ?? {};
@@ -299,15 +299,13 @@ function createCore(options) {
     },
     globalBlocks: {
       /**
-       * The site's global blocks (Global blocks in Hearth), resolved: pop-ups (`popup` set), menu dropdowns (a menu
-       * item's `dropdown` names one) and any others the site's code places by key. Empty from Hearth versions without them.
+       * Every published global block on the site (Global blocks in Hearth), resolved, with what it is and where editors
+       * placed it: pop-ups (`popup` set), menu dropdowns (`usedOn.menuItems`), pages. Place any of them anywhere.
+       * Empty from Hearth versions without them.
        */
       list: async (o = {}) => await maybe("/global-blocks", { ...o, resource: "globalBlocks.list" }) ?? [],
-      /** One global block by key, or null. */
-      get: async (key, o = {}) => {
-        const list = await maybe("/global-blocks", { ...o, resource: "globalBlocks.list" }) ?? [];
-        return list.find((g) => g.key === key) ?? null;
-      }
+      /** One global block by its key ("contact") or id, or null if there's none or it isn't published. */
+      get: (ref, o = {}) => maybe(`/global-blocks/${encodeURIComponent(ref)}`, { ...o, resource: "globalBlocks.get" })
     },
     customBlocks: {
       /** The site's own block types (Custom blocks in Hearth): each one's key, name and fields, for rendering `custom` blocks. */

package/dist/{client-Deumm7No.d.ts → client-E1ie4g_L.d.ts}

@@ -229,12 +229,13 @@ declare function createCore(options: HearthClientOptions): {
     };
     globalBlocks: {
         /**
-         * The site's global blocks (Global blocks in Hearth), resolved: pop-ups (`popup` set), menu dropdowns (a menu
-         * item's `dropdown` names one) and any others the site's code places by key. Empty from Hearth versions without them.
+         * Every published global block on the site (Global blocks in Hearth), resolved, with what it is and where editors
+         * placed it: pop-ups (`popup` set), menu dropdowns (`usedOn.menuItems`), pages. Place any of them anywhere.
+         * Empty from Hearth versions without them.
          */
         list: (o?: CallOptions) => Promise<GlobalBlock[]>;
-        /** One global block by key, or null. */
-        get: (key: string, o?: CallOptions) => Promise<GlobalBlock | null>;
+        /** One global block by its key ("contact") or id, or null if there's none or it isn't published. */
+        get: (ref: string, o?: CallOptions) => Promise<GlobalBlock | null>;
     };
     customBlocks: {
         /** The site's own block types (Custom blocks in Hearth): each one's key, name and fields, for rendering `custom` blocks. */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { H as HearthCore, a as HearthClientOptions } from './client-Deumm7No.js';
-export { C as CallOptions, b as CollectionPage, D as DEFAULT_BASE_URL, E as EventCollectionPage, F as FormResult, c as FormValues, d as HearthError, e as HearthErrorCode, f as HearthHooks, N as NextFetchOptions, P as PreviewSession, R as RequestContext, g as RequestOptions, h as findRedirect, i as isHearthError, n as normalizeSlug } from './client-Deumm7No.js';
+import { H as HearthCore, a as HearthClientOptions } from './client-E1ie4g_L.js';
+export { C as CallOptions, b as CollectionPage, D as DEFAULT_BASE_URL, E as EventCollectionPage, F as FormResult, c as FormValues, d as HearthError, e as HearthErrorCode, f as HearthHooks, N as NextFetchOptions, P as PreviewSession, R as RequestContext, g as RequestOptions, h as findRedirect, i as isHearthError, n as normalizeSlug } from './client-E1ie4g_L.js';
 export { AnalyticsReport, AnalyticsRow, Block, BlockOf, CategoryGroup, CategoryRef, Collection, CollectionEntry, CollectionRef, DonationCheckout, DonationInput, EntryDetails, EventCustomFields, EventRegistration, EventTicket, EventVolunteerShift, EventVolunteering, Fundraiser, FundraiserDetail, GlobalBlock, GlobalPopup, HearthEvent, HearthEventDetail, ImageRef, KnownBlock, Page, PageMeta, PageSummary, Position, Redirect, RegistrationInput, RegistrationResult, ResolvedBlock, SharedFrom, Site, SiteAnalytics, SiteSettings, SitemapEntry, UnknownBlock, VolunteerInput, VolunteerResult, WebhookPayload, directionsUrl, focalPosition, pinned, videoEmbedUrl } from '@the-smithy/hearth-schema';
 
 /** A plugin adds resources (and can use the core's `request`) under its own names. */

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   findRedirect,
   isHearthError,
   normalizeSlug
-} from "./chunk-QDCU7YWV.js";
+} from "./chunk-3LZQGXTQ.js";
 
 // src/index.ts
 import { videoEmbedUrl } from "@the-smithy/hearth-schema";

package/dist/next.d.ts

@@ -1,4 +1,4 @@
-import { H as HearthCore, b as CollectionPage, E as EventCollectionPage, F as FormResult, c as FormValues } from './client-Deumm7No.js';
+import { H as HearthCore, b as CollectionPage, E as EventCollectionPage, F as FormResult, c as FormValues } from './client-E1ie4g_L.js';
 import * as _the_smithy_hearth_schema from '@the-smithy/hearth-schema';
 import { Site, PageMeta } from '@the-smithy/hearth-schema';
 import { Metadata, MetadataRoute } from 'next';
@@ -170,8 +170,10 @@ declare function createHearthNext(client: HearthCore, { tag, revalidate }?: Hear
             optional?: boolean | undefined;
         })[];
     }[]>;
-    /** Global blocks (pop-ups, menu dropdowns, ones the site places by key); drafts while previewing. */
+    /** Every global block (to place anywhere, and for pop-ups and menu dropdowns); drafts while previewing. */
     getGlobalBlocks: () => Promise<_the_smithy_hearth_schema.GlobalBlock[]>;
+    /** One global block by key or id, or null; its draft while previewing. */
+    getGlobalBlock: (ref: string) => Promise<_the_smithy_hearth_schema.GlobalBlock | null>;
     getCollections: () => Promise<_the_smithy_hearth_schema.Collection[]>;
     getCollection: (slug: string, opts?: {
         limit?: number;

package/dist/next.js

@@ -2,7 +2,7 @@ import {
   findRedirect,
   isHearthError,
   normalizeSlug
-} from "./chunk-QDCU7YWV.js";
+} from "./chunk-3LZQGXTQ.js";
 import {
   parseWebhook,
   tagsForWebhook
@@ -60,8 +60,10 @@ function createHearthNext(client, { tag = "hearth", revalidate = 3600 } = {}) {
     getEvents: (opts) => client.events.list(opts, tags(`${tag}:events`)),
     getCategories: () => client.categories.list(tags(`${tag}:site`)),
     getCustomBlocks: () => client.customBlocks.list(tags(`${tag}:site`)),
-    /** Global blocks (pop-ups, menu dropdowns, ones the site places by key); drafts while previewing. */
+    /** Every global block (to place anywhere, and for pop-ups and menu dropdowns); drafts while previewing. */
     getGlobalBlocks: async () => client.globalBlocks.list(await read(`${tag}:global`)),
+    /** One global block by key or id, or null; its draft while previewing. */
+    getGlobalBlock: async (ref) => client.globalBlocks.get(ref, await read(`${tag}:global`)),
     getCollections: () => client.collections.list(tags(`${tag}:site`, `${tag}:pages`)),
     getCollection: (slug, opts) => client.collections.get(slug, opts, tags(`${tag}:pages`, `${tag}:events`)),
     getEvent: async (slug) => client.events.get(slug, await read(`${tag}:events`)),

package/dist/testing.js

@@ -49,6 +49,11 @@ function createMockHearth(data = {}) {
     if (rest === "/llms") return json({ data: data.llmsTxt ?? null });
     if (rest === "/redirects") return json({ data: data.redirects ?? [] });
     if (rest === "/global-blocks") return json({ data: data.globalBlocks ?? [] });
+    if (rest.startsWith("/global-blocks/")) {
+      const ref = decodeURIComponent(rest.slice(15));
+      const block = (data.globalBlocks ?? []).find((g) => g.key === ref || g.id === ref);
+      return block ? json({ data: block }) : notFound();
+    }
     if (rest === "/fundraisers" || rest.startsWith("/fundraisers?")) {
       const status = url.searchParams.get("status") ?? "active";
       return json({ data: (data.fundraisers ?? []).filter((f) => status === "all" || f.status === status) });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-smithy/hearth",
-  "version": "0.23.0",
+  "version": "0.24.1",
   "description": "Typed client for the Hearth Delivery API: content, SEO, forms and publish webhooks.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
@@ -49,7 +49,7 @@
     "llms.md"
   ],
   "dependencies": {
-    "@the-smithy/hearth-schema": "^0.23.0"
+    "@the-smithy/hearth-schema": "^0.24.1"
   },
   "peerDependencies": {
     "next": ">=15",