@aurora-studio/starter-core 0.1.0

package/dist/lib/aurora.js

@@ -0,0 +1,235 @@
+import { AuroraClient, } from "@aurora-studio/sdk";
+const baseUrl = process.env.AURORA_API_URL ??
+    process.env.NEXT_PUBLIC_AURORA_API_URL ??
+    "";
+const apiKey = process.env.AURORA_API_KEY ??
+    process.env.NEXT_PUBLIC_AURORA_API_KEY ??
+    "";
+const tenantSlug = process.env.NEXT_PUBLIC_TENANT_SLUG ?? "";
+/** Optional spec URL so the SDK can adjust from the tenant OpenAPI spec (default: baseUrl + /v1/openapi.json) */
+const specUrl = baseUrl ? `${baseUrl.replace(/\/$/, "")}/v1/openapi.json` : undefined;
+export function createAuroraClient() {
+    if (!baseUrl || baseUrl.startsWith("/")) {
+        throw new Error("Aurora API URL is not configured. Set AURORA_API_URL (or NEXT_PUBLIC_AURORA_API_URL) to your Aurora API root (e.g. https://api.youraurora.com).");
+    }
+    return new AuroraClient({ baseUrl, apiKey, specUrl });
+}
+export function getApiBase() {
+    return baseUrl.replace(/\/$/, "");
+}
+export function getTenantSlug() {
+    return tenantSlug;
+}
+/** Store config - safe for client: fetches via /api/store/config (keeps API key server-side). */
+export async function getStoreConfig() {
+    if (typeof window !== "undefined") {
+        const res = await fetch("/api/store/config");
+        if (!res.ok)
+            return null;
+        return res.json();
+    }
+    const client = createAuroraClient();
+    return client.store.config();
+}
+/** Exclude offers from search - offers are checkout-only discounts, not products. */
+function excludeOffersFromSearch(result) {
+    const hits = result.hits ?? [];
+    const filtered = hits.filter((h) => h.tableSlug !== "offers");
+    return { ...result, hits: filtered };
+}
+/** Meilisearch-powered product search. Uses API route from client (keeps API key server-side). */
+export async function search(params) {
+    let result;
+    if (typeof window !== "undefined") {
+        const qs = new URLSearchParams();
+        if (params.q != null && params.q !== "")
+            qs.set("q", params.q);
+        if (params.limit != null)
+            qs.set("limit", String(params.limit));
+        if (params.offset != null)
+            qs.set("offset", String(params.offset));
+        if (params.vendorId)
+            qs.set("vendorId", params.vendorId);
+        if (params.category)
+            qs.set("category", params.category);
+        if (params.sort)
+            qs.set("sort", params.sort);
+        if (params.order)
+            qs.set("order", params.order);
+        if (params.excludeDietary?.length) {
+            qs.set("excludeDietary", params.excludeDietary.join(","));
+        }
+        const res = await fetch(`/api/search?${qs.toString()}`);
+        if (!res.ok) {
+            const err = (await res.json().catch(() => ({})));
+            throw new Error(err.error ?? "Search failed");
+        }
+        result = (await res.json());
+    }
+    else {
+        const client = createAuroraClient();
+        result = await client.site.search(params);
+    }
+    return excludeOffersFromSearch(result);
+}
+/** Fetch delivery slots for a location */
+export async function getDeliverySlots(lat, lng) {
+    const client = createAuroraClient();
+    return client.store.deliverySlots(lat, lng);
+}
+/** List stores/vendors */
+export async function getStores() {
+    const client = createAuroraClient();
+    return client.site.stores();
+}
+/** Create checkout session (Stripe or ACME) */
+export async function createCheckoutSession(params) {
+    const client = createAuroraClient();
+    return client.store.checkout.sessions.create(params);
+}
+/** Fetch ACME checkout session */
+export async function getAcmeSession(sessionId) {
+    const client = createAuroraClient();
+    return client.store.checkout.acme.get(sessionId);
+}
+/** Complete ACME checkout */
+export async function completeAcmeCheckout(sessionId, shippingAddress) {
+    const client = createAuroraClient();
+    return client.store.checkout.acme.complete(sessionId, shippingAddress);
+}
+/** Holmes mission inference */
+export async function holmesInfer(sessionId) {
+    const client = createAuroraClient();
+    return client.holmes.infer(sessionId);
+}
+/** Holmes insights: products for a recipe (paella, curry, pasta). Uses holmes_insights.recipe_ideas. */
+export async function holmesRecipeProducts(recipe, limit = 12, opts) {
+    if (typeof window !== "undefined") {
+        const qs = new URLSearchParams({ recipe, limit: String(limit) });
+        if (opts?.excludeDietary?.length)
+            qs.set("excludeDietary", opts.excludeDietary.join(","));
+        const res = await fetch(`/api/holmes/recipe-products?${qs.toString()}`);
+        if (!res.ok) {
+            const err = (await res.json().catch(() => ({})));
+            throw new Error(err.error ?? "Recipe products failed");
+        }
+        return res.json();
+    }
+    const client = createAuroraClient();
+    return client.store.holmesRecipeProducts(recipe, limit, opts);
+}
+/** Holmes recent recipes from cache. Ordered by most recently updated. Optional timeOfDay filters by morning/afternoon/evening. excludeDietary filters out recipes whose ingredients match excluded types. */
+export async function holmesRecentRecipes(limit = 8, timeOfDay, opts) {
+    if (typeof window !== "undefined") {
+        const qs = new URLSearchParams({ limit: String(limit) });
+        if (timeOfDay)
+            qs.set("time_of_day", timeOfDay);
+        if (opts?.excludeDietary?.length)
+            qs.set("excludeDietary", opts.excludeDietary.join(","));
+        const res = await fetch(`/api/holmes/recipes?${qs.toString()}`);
+        if (!res.ok)
+            return { recipes: [] };
+        return res.json();
+    }
+    const client = createAuroraClient();
+    return client.store.holmesRecentRecipes(limit, timeOfDay, opts);
+}
+/** Holmes cached recipe. Fetches via AI on cache miss. */
+export async function holmesRecipe(slug) {
+    if (typeof window !== "undefined") {
+        const res = await fetch(`/api/holmes/recipe/${encodeURIComponent(slug)}`);
+        if (!res.ok)
+            return null;
+        return res.json();
+    }
+    const client = createAuroraClient();
+    return client.store.holmesRecipe(slug);
+}
+/** Holmes tidbits for entity (recipe, ingredient, product). */
+export async function holmesTidbits(entity, entityType = "recipe") {
+    if (typeof window !== "undefined") {
+        const qs = new URLSearchParams({ entity, entity_type: entityType });
+        const res = await fetch(`/api/holmes/tidbits?${qs.toString()}`);
+        if (!res.ok)
+            return { tidbits: [] };
+        return res.json();
+    }
+    const client = createAuroraClient();
+    return client.store.holmesTidbits(entity, entityType);
+}
+/** Holmes insights: products that go well with a given product. Uses holmes_insights.goes_well_with. */
+export async function holmesGoesWith(productId, limit = 8, opts) {
+    if (typeof window !== "undefined") {
+        const qs = new URLSearchParams({ product_id: productId, limit: String(limit) });
+        if (opts?.excludeDietary?.length)
+            qs.set("excludeDietary", opts.excludeDietary.join(","));
+        const res = await fetch(`/api/holmes/goes-with?${qs.toString()}`);
+        if (!res.ok) {
+            const err = (await res.json().catch(() => ({})));
+            throw new Error(err.error ?? "Goes-with failed");
+        }
+        return res.json();
+    }
+    const client = createAuroraClient();
+    return client.store.holmesGoesWith(productId, limit, opts);
+}
+/** Holmes bundle/recipe options for cart. Returns 1–3 combos when cart has 2+ items. */
+export async function holmesCombosForCart(params) {
+    const qs = new URLSearchParams({ cart_ids: params.cartIds.join(",") });
+    if (params.cartNames?.length)
+        qs.set("cart_names", params.cartNames.join(","));
+    if (params.limit)
+        qs.set("limit", String(params.limit));
+    if (params.sid)
+        qs.set("sid", params.sid);
+    const res = await fetch(`/api/holmes/combos-for-cart?${qs.toString()}`);
+    if (!res.ok)
+        return { combos: [] };
+    return res.json();
+}
+/** Set selected combo for session (from recipe picker). */
+export async function holmesSelectCombo(params) {
+    const res = await fetch("/api/holmes/select-combo", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(params),
+    });
+    if (!res.ok)
+        throw new Error("Failed to set selected combo");
+    return res.json();
+}
+/** Holmes insights: similar products by type (what_it_is). For substitutions - same product type, not complementary. */
+export async function holmesSimilarProducts(productId, limit = 8, productName, opts) {
+    if (typeof window !== "undefined") {
+        const qs = new URLSearchParams({ product_id: productId, limit: String(limit) });
+        if (productName?.trim())
+            qs.set("product_name", productName.trim());
+        if (opts?.excludeDietary?.length)
+            qs.set("excludeDietary", opts.excludeDietary.join(","));
+        const res = await fetch(`/api/holmes/similar?${qs.toString()}`);
+        if (!res.ok) {
+            const err = (await res.json().catch(() => ({})));
+            throw new Error(err.error ?? "Similar products failed");
+        }
+        return res.json();
+    }
+    const client = createAuroraClient();
+    return client.store.holmesSimilar(productId, limit, productName, opts);
+}
+/** Home personalization - sections for SSR fallback. sid optional (omit for default sections). excludeDietary filters products and sections by dietary preferences. */
+export async function getHomePersonalization(sid, opts) {
+    try {
+        const client = createAuroraClient();
+        const result = await client.store.homePersonalization(sid ?? "", undefined, opts);
+        return result;
+    }
+    catch {
+        return null;
+    }
+}
+// Holmes offers & chat: available in SDK 0.2.7+ via client.holmes.offers(), client.holmes.chat.send(), client.holmes.chat.list()
+/** Current user metadata and related data (e.g. addresses) when userId is provided. Uses GET /me from tenant spec. */
+export async function getMe(userId) {
+    const client = createAuroraClient();
+    return client.me({ userId });
+}

package/dist/lib/format-price.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Format price for display. Aurora stores prices as decimal major units (e.g. 2.00 = £2).
+ * This helper expects cents (integer) and formats for display.
+ */
+export declare function formatPrice(cents: number, currency?: string): string;
+/**
+ * Convert Aurora DB price (decimal major units, e.g. 2.00) to cents for display/cart.
+ */
+export declare function toCents(rawPrice: number | null | undefined): number | undefined;
+//# sourceMappingURL=format-price.d.ts.map

package/dist/lib/format-price.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-price.d.ts","sourceRoot":"","sources":["../../src/lib/format-price.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAQ,GAAG,MAAM,CAKnE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG/E"}

package/dist/lib/format-price.js

@@ -0,0 +1,18 @@
+/**
+ * Format price for display. Aurora stores prices as decimal major units (e.g. 2.00 = £2).
+ * This helper expects cents (integer) and formats for display.
+ */
+export function formatPrice(cents, currency = "GBP") {
+    return new Intl.NumberFormat("en-GB", {
+        style: "currency",
+        currency,
+    }).format(cents / 100);
+}
+/**
+ * Convert Aurora DB price (decimal major units, e.g. 2.00) to cents for display/cart.
+ */
+export function toCents(rawPrice) {
+    if (rawPrice == null || !Number.isFinite(rawPrice))
+        return undefined;
+    return Math.round(Number(rawPrice) * 100);
+}

package/dist/lib/holmes-events.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Holmes event bridge - push storefront signals to the Holmes script.
+ * Works for any storefront: call directly or dispatch DOM events.
+ * The Holmes script (loaded via layout) listens and sends data to Aurora.
+ *
+ * Integration: paste <script src=".../holmes/v1/script.js?site=X"></script>
+ * then call these helpers or dispatch the equivalent CustomEvents.
+ */
+declare global {
+    interface Window {
+        holmes?: {
+            setSearch: (q: string | string[]) => void;
+            setProductsViewed: (ids: string[]) => void;
+            setCartCount: (n: number) => void;
+            setCartItems: (items: Array<{
+                id: string;
+                name: string;
+                price: number;
+            }>) => void;
+            setRecipeViewed?: (slug: string, title: string) => void;
+            setRecipeMissionLock?: (key: string) => void;
+            clearRecipeMissionLock?: () => void;
+            getSessionId?: () => string;
+            getMissionStartTimestamp?: () => number | null;
+            addBundleToCart?: (products: Array<{
+                id: string;
+                name: string;
+                price: number;
+                image?: string;
+            }>, tableSlug: string) => void;
+        };
+    }
+}
+export declare function holmesRecipeView(slug: string, title: string): void;
+/** Dispatch event for Holmes to add a bundle to cart. CartProvider listens and calls addItem. */
+export declare function holmesAddBundle(products: Array<{
+    id: string;
+    name: string;
+    price: number;
+    image?: string;
+}>, tableSlug: string): void;
+/** Lock recipe/combo mission on the server until reset (meal searches, mission pills). */
+export declare function holmesMissionLockCombo(): void;
+/** Clear sticky recipe mission (e.g. mission bar reset). */
+export declare function holmesMissionLockClear(): void;
+export declare function holmesSearch(query: string): void;
+export declare function holmesProductView(productIds: string[]): void;
+export declare function holmesCartUpdate(count: number, items?: Array<{
+    id: string;
+    name: string;
+    price: number;
+}>, bootstrap?: boolean): void;
+//# sourceMappingURL=holmes-events.d.ts.map

package/dist/lib/holmes-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"holmes-events.d.ts","sourceRoot":"","sources":["../../src/lib/holmes-events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,MAAM,CAAC,EAAE;YACP,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC;YAC1C,iBAAiB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;YAC3C,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;YAClC,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAA;aAAE,CAAC,KAAK,IAAI,CAAC;YAClF,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;YACxD,oBAAoB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;YAC7C,sBAAsB,CAAC,EAAE,MAAM,IAAI,CAAC;YACpC,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;YAC5B,wBAAwB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;YAC/C,eAAe,CAAC,EAAE,CAChB,QAAQ,EAAE,KAAK,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAC;gBAAC,KAAK,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,EAC5E,SAAS,EAAE,MAAM,KACd,IAAI,CAAC;SACX,CAAC;KACH;CACF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAUlE;AAED,iGAAiG;AACjG,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC5E,SAAS,EAAE,MAAM,GAChB,IAAI,CAKN;AAKD,0FAA0F;AAC1F,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAOhD;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAM5D;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAC1D,SAAS,CAAC,EAAE,OAAO,GAClB,IAAI,CAWN"}

package/dist/lib/holmes-events.js

@@ -0,0 +1,73 @@
+/**
+ * Holmes event bridge - push storefront signals to the Holmes script.
+ * Works for any storefront: call directly or dispatch DOM events.
+ * The Holmes script (loaded via layout) listens and sends data to Aurora.
+ *
+ * Integration: paste <script src=".../holmes/v1/script.js?site=X"></script>
+ * then call these helpers or dispatch the equivalent CustomEvents.
+ */
+export function holmesRecipeView(slug, title) {
+    if (typeof document === "undefined")
+        return;
+    const s = String(slug || "").trim();
+    const t = String(title || "").trim();
+    if (!s || !t)
+        return;
+    holmesMissionLockCombo();
+    if (window.holmes?.setRecipeViewed)
+        window.holmes.setRecipeViewed(s, t);
+    document.dispatchEvent(new CustomEvent("holmes:recipeView", { detail: { slug: s, title: t } }));
+}
+/** Dispatch event for Holmes to add a bundle to cart. CartProvider listens and calls addItem. */
+export function holmesAddBundle(products, tableSlug) {
+    if (typeof document === "undefined")
+        return;
+    document.dispatchEvent(new CustomEvent("holmes:addBundle", { detail: { products, tableSlug } }));
+}
+const MEAL_SEARCH_LOCK_RE = /dinner|lunch|breakfast|brunch|supper|recipe|cook\b|meal\b|paella|curry|pasta|steak|roast|ingredient|grill|bbq|beef|lamb|pork|salmon|chicken|fish/i;
+/** Lock recipe/combo mission on the server until reset (meal searches, mission pills). */
+export function holmesMissionLockCombo() {
+    if (typeof document === "undefined")
+        return;
+    document.dispatchEvent(new CustomEvent("holmes:missionLock", { detail: { key: "combo_mission" } }));
+}
+/** Clear sticky recipe mission (e.g. mission bar reset). */
+export function holmesMissionLockClear() {
+    if (typeof document === "undefined")
+        return;
+    document.dispatchEvent(new CustomEvent("holmes:missionLockClear"));
+}
+export function holmesSearch(query) {
+    if (typeof window === "undefined")
+        return;
+    const q = String(query || "").trim();
+    if (!q)
+        return;
+    if (MEAL_SEARCH_LOCK_RE.test(q))
+        holmesMissionLockCombo();
+    if (window.holmes)
+        window.holmes.setSearch(q);
+    document.dispatchEvent(new CustomEvent("holmes:search", { detail: { q } }));
+}
+export function holmesProductView(productIds) {
+    if (typeof window === "undefined")
+        return;
+    const ids = Array.isArray(productIds) ? productIds : [];
+    if (ids.length === 0)
+        return;
+    if (window.holmes)
+        window.holmes.setProductsViewed(ids);
+    document.dispatchEvent(new CustomEvent("holmes:productView", { detail: { productIds: ids } }));
+}
+export function holmesCartUpdate(count, items, bootstrap) {
+    if (typeof window === "undefined")
+        return;
+    if (window.holmes) {
+        window.holmes.setCartCount(count);
+        if (items)
+            window.holmes.setCartItems(items);
+    }
+    document.dispatchEvent(new CustomEvent("holmes:cartUpdate", {
+        detail: { count, items: items ?? [], bootstrap: bootstrap === true },
+    }));
+}

package/dist/lib/image-url.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Centralized product image URL resolution.
+ * Ensures relative URLs get correct base (storefront or CDN) so images load reliably.
+ * Supports Contentful CDN resize params to request appropriately-sized thumbnails.
+ */
+/**
+ * For Contentful CDN URLs, append resize params so the CDN returns an appropriately-sized
+ * image. Uses fit=pad to preserve aspect ratio and avoid cropping portrait/landscape images.
+ * Other URLs are returned unchanged.
+ */
+export declare function getThumbnailImageUrl(url: string | null | undefined, width?: number, height?: number): string | null;
+/**
+ * Extract image URL from a product/record.
+ */
+export declare function getImageUrlFromRecord(record: Record<string, unknown>): string | null;
+/**
+ * Resolve product image URL for display.
+ * - Empty/invalid URLs return null.
+ * - Absolute URLs (http/https) returned as-is.
+ * - Relative URLs get baseUrl prepended (storefront origin or imageBaseUrl from config).
+ */
+export declare function resolveProductImageUrl(url: string | null | undefined, baseUrl?: string | null): string | null;
+//# sourceMappingURL=image-url.d.ts.map

package/dist/lib/image-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-url.d.ts","sourceRoot":"","sources":["../../src/lib/image-url.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,KAAK,SAAM,EACX,MAAM,SAAM,GACX,MAAM,GAAG,IAAI,CAiBf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,GAAG,IAAI,CAGf;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,MAAM,GAAG,IAAI,CAyBf"}

package/dist/lib/image-url.js

@@ -0,0 +1,70 @@
+/**
+ * Centralized product image URL resolution.
+ * Ensures relative URLs get correct base (storefront or CDN) so images load reliably.
+ * Supports Contentful CDN resize params to request appropriately-sized thumbnails.
+ */
+const IMAGE_FIELDS = ["image_url", "image", "thumbnail", "photo"];
+/** Matches Contentful CDN URLs (images.ctfassets.net or images.eu.ctfassets.net), with or without protocol */
+const CONTENTFUL_CDN_RE = /^(https?:)?\/\/images\.(eu\.)?ctfassets\.net\//i;
+/**
+ * For Contentful CDN URLs, append resize params so the CDN returns an appropriately-sized
+ * image. Uses fit=pad to preserve aspect ratio and avoid cropping portrait/landscape images.
+ * Other URLs are returned unchanged.
+ */
+export function getThumbnailImageUrl(url, width = 400, height = 400) {
+    const raw = typeof url === "string" ? url.trim() : "";
+    if (!raw)
+        return null;
+    if (!CONTENTFUL_CDN_RE.test(raw))
+        return raw;
+    try {
+        const u = new URL(raw.startsWith("//") ? `https:${raw}` : raw);
+        const params = u.searchParams;
+        if (params.has("w") || params.has("h"))
+            return raw.startsWith("//") ? `https:${raw}` : raw;
+        params.set("w", String(Math.min(4000, width)));
+        params.set("h", String(Math.min(4000, height)));
+        params.set("fit", "pad");
+        params.set("fm", "webp");
+        return u.toString();
+    }
+    catch {
+        return raw;
+    }
+}
+/**
+ * Extract image URL from a product/record.
+ */
+export function getImageUrlFromRecord(record) {
+    const field = IMAGE_FIELDS.find((f) => record[f]);
+    return field ? String(record[field]).trim() || null : null;
+}
+/**
+ * Resolve product image URL for display.
+ * - Empty/invalid URLs return null.
+ * - Absolute URLs (http/https) returned as-is.
+ * - Relative URLs get baseUrl prepended (storefront origin or imageBaseUrl from config).
+ */
+export function resolveProductImageUrl(url, baseUrl) {
+    const raw = typeof url === "string" ? url.trim() : "";
+    if (!raw)
+        return null;
+    if (raw.startsWith("http://") || raw.startsWith("https://")) {
+        return raw;
+    }
+    if (raw.startsWith("//")) {
+        return `https:${raw}`;
+    }
+    const base = baseUrl ??
+        process.env.NEXT_PUBLIC_IMAGE_BASE_URL?.trim() ??
+        (typeof window !== "undefined"
+            ? window.location?.origin
+            : null) ??
+        process.env.NEXT_PUBLIC_APP_URL?.trim() ??
+        "";
+    if (!base)
+        return raw.startsWith("/") ? raw : `/${raw}`;
+    const normalized = base.replace(/\/$/, "");
+    const path = raw.startsWith("/") ? raw : `/${raw}`;
+    return `${normalized}${path}`;
+}

package/dist/lib/utils.d.ts

@@ -0,0 +1,3 @@
+/** Returns time-of-day label (morning, afternoon, evening) for copy like "Recipe ideas for morning". */
+export declare function getTimeOfDay(): "morning" | "afternoon" | "evening";
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,wBAAgB,YAAY,IAAI,SAAS,GAAG,WAAW,GAAG,SAAS,CAKlE"}

package/dist/lib/utils.js

@@ -0,0 +1,9 @@
+/** Returns time-of-day label (morning, afternoon, evening) for copy like "Recipe ideas for morning". */
+export function getTimeOfDay() {
+    const hour = new Date().getHours();
+    if (hour >= 5 && hour < 12)
+        return "morning";
+    if (hour >= 12 && hour < 17)
+        return "afternoon";
+    return "evening";
+}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@aurora-studio/starter-core",
+  "version": "0.1.0",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepare": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit"
+  },
+  "description": "Shared Aurora storefront primitives (SDK helpers, Holmes bridge, commerce UI) for Hippo templates.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Purple-Napkin/aurora-starter-core.git"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@aurora-studio/sdk": "^0.2.27",
+    "next": ">=14",
+    "react": "^18 || ^19",
+    "react-dom": "^18 || ^19",
+    "lucide-react": ">=0.400"
+  },
+  "devDependencies": {
+    "@aurora-studio/sdk": "^0.2.27",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "lucide-react": "^0.454.0",
+    "next": "15.0.7",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.3.3"
+  },
+  "packageManager": "pnpm@10.32.1+sha512.a706938f0e89ac1456b6563eab4edf1d1faf3368d1191fc5c59790e96dc918e4456ab2e67d613de1043d2e8c81f87303e6b40d4ffeca9df15ef1ad567348f2be",
+  "author": "Marcel du Preez - @Purple-Napkin",
+  "bugs": {
+    "url": "https://github.com/Purple-Napkin/aurora-starter-core/issues"
+  },
+  "homepage": "https://github.com/Purple-Napkin/aurora-starter-core#readme"
+}