@usequeek/theme-kit 0.1.22 → 0.1.24

package/tests/metaobjects-block.test.tsx

@@ -1,70 +0,0 @@
-import React from 'react';
-import { renderToStaticMarkup } from 'react-dom/server';
-import { describe, expect, it } from 'vitest';
-import { CoreMetaobjectsBlock } from '../shared-blocks/metaobjects';
-import type { CoreMetaobjectsBlockProps } from '../shared-blocks/metaobjects';
-import type { MetaobjectEntry } from '../types/product';
-
-function makeEntry(overrides: Partial<MetaobjectEntry> = {}): MetaobjectEntry {
-  return {
-    p_id: 1,
-    type: 'designer',
-    handle: 'adaeze',
-    display_name: 'Adaeze',
-    fields: { bio: 'Lagos-based designer' },
-    ...overrides,
-  };
-}
-
-function render(props: Partial<CoreMetaobjectsBlockProps> = {}): string {
-  return renderToStaticMarkup(
-    React.createElement(CoreMetaobjectsBlock, {
-      entries: [makeEntry()],
-      definition: { type: 'designer', name: 'Designer', has_pages: false },
-      ...props,
-    }),
-  );
-}
-
-describe('CoreMetaobjectsBlock', () => {
-  it('renders nothing when there are no entries', () => {
-    expect(render({ entries: [] })).toBe('');
-  });
-
-  it('renders a grid by default with entry cards', () => {
-    const html = render();
-    expect(html).toContain('core-block-metaobjects--grid');
-    expect(html).toContain('core-block-metaobjects__list--grid');
-    expect(html).toContain('core-metafields__entry-card');
-    expect(html).toContain('Adaeze');
-  });
-
-  it('renders a list layout when requested', () => {
-    const html = render({ layout: 'list' });
-    expect(html).toContain('core-block-metaobjects--list');
-    expect(html).toContain('core-block-metaobjects__list--list');
-  });
-
-  it('renders the title when provided', () => {
-    expect(render({ title: 'Our designers' })).toContain('Our designers');
-  });
-
-  it('does not link entries when the definition has no pages', () => {
-    const html = render({ definition: { type: 'designer', name: 'Designer', has_pages: false } });
-    expect(html).not.toContain('<a ');
-  });
-
-  it('links each entry to /{type}/{handle} when the definition has pages', () => {
-    const html = render({ definition: { type: 'designer', name: 'Designer', has_pages: true } });
-    expect(html).toContain('<a ');
-    expect(html).toContain('href="/designer/adaeze"');
-  });
-
-  it('renders multiple entries', () => {
-    const html = render({
-      entries: [makeEntry(), makeEntry({ p_id: 2, handle: 'chidi', display_name: 'Chidi' })],
-    });
-    expect(html).toContain('Adaeze');
-    expect(html).toContain('Chidi');
-  });
-});

package/tests/navigation.test.tsx

@@ -1,30 +0,0 @@
-import React from 'react';
-import { renderToStaticMarkup } from 'react-dom/server';
-import { describe, expect, it } from 'vitest';
-import * as navigation from '../navigation';
-import { Link } from '../navigation';
-
-describe('navigation — what a theme links and navigates with', () => {
-  it('is exactly Link, useRouter and usePathname', () => {
-    expect(Object.keys(navigation).sort()).toEqual(['Link', 'usePathname', 'useRouter']);
-  });
-
-  it('renders Link as a plain anchor carrying its href, class and children', () => {
-    const html = renderToStaticMarkup(
-      React.createElement(Link, { href: '/medley/shop', className: 'md-nav__link', 'aria-current': 'page' }, 'Shop'),
-    );
-
-    expect(html).toContain('<a');
-    expect(html).toContain('href="/medley/shop"');
-    expect(html).toContain('class="md-nav__link"');
-    expect(html).toContain('aria-current="page"');
-    expect(html).toContain('>Shop</a>');
-  });
-
-  it('keeps a full URL as is', () => {
-    const html = renderToStaticMarkup(React.createElement(Link, { href: 'https://usequeek.com/business', target: '_blank' }, 'Queek'));
-
-    expect(html).toContain('href="https://usequeek.com/business"');
-    expect(html).toContain('target="_blank"');
-  });
-});

package/tests/orders-walk.test.ts

@@ -1,48 +0,0 @@
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import { fetchOrders } from '../api/orders';
-
-/**
- * `GET store/orders` answers the ONE storefront list envelope: `has_more` +
- * `next_cursor` top-level, no `links`, no paginator `meta`. The kit reads the
- * page it asked for.
- */
-describe('fetchOrders walk state', () => {
-  afterEach(() => vi.unstubAllGlobals());
-
-  it('asks /client/store/orders by page and returns the top-level walk state', async () => {
-    const fetchMock = vi.fn(async () => ({
-      ok: true,
-      json: async () => ({
-        status: 'success',
-        message: 'Orders retrieved',
-        data: [{ id: 'o1', order_no: 'Q-1' }],
-        meta: { currency: { code: 'NGN' } },
-        has_more: true,
-        next_cursor: 'eyJ2IjoxfQ',
-      }),
-    }));
-    vi.stubGlobal('fetch', fetchMock);
-
-    const page = await fetchOrders('demo-store', 2, 'ongoing');
-
-    const url = String((fetchMock.mock.calls[0] as unknown[])[0]);
-    expect(url).toContain('/client/store/orders');
-    expect(url).toContain('page=2');
-    expect(url).toContain('status=ongoing');
-    expect(page.has_more).toBe(true);
-    expect(page.next_cursor).toBe('eyJ2IjoxfQ');
-    expect(page).not.toHaveProperty('links');
-    expect(page.data).toHaveLength(1);
-  });
-
-  it('never sends status=all (the unfiltered list)', async () => {
-    const fetchMock = vi.fn(async () => ({ ok: true, json: async () => ({ data: [], has_more: false, next_cursor: null }) }));
-    vi.stubGlobal('fetch', fetchMock);
-
-    const page = await fetchOrders('demo-store', 1, 'all');
-
-    expect(String((fetchMock.mock.calls[0] as unknown[])[0])).not.toContain('status=');
-    expect(page.has_more).toBe(false);
-    expect(page.next_cursor).toBeNull();
-  });
-});

package/tests/page-renderer-signature.test.tsx

@@ -1,42 +0,0 @@
-import { renderToStaticMarkup } from 'react-dom/server';
-import { describe, expect, it } from 'vitest';
-import { StorefrontContext } from '../provider';
-import { ThemeProvider } from '../theme-context';
-import { PageRenderer } from '../page-renderer';
-import type { Block } from '../types/block';
-import type { ThemeModule } from '../types/theme';
-
-/**
- * The storefront attaches streamed `productsPromise` / `metaobjectsPromise` to
- * page blocks. On the server they arrive as React Flight thenables that point
- * back at the whole RSC response. PageRenderer's change-detection signature
- * JSON-stringified the blocks, and that threw "Converting circular structure to
- * JSON" during server rendering — every real store with a products block fell
- * back to client-only rendering in `next dev`.
- */
-
-function circularThenable(): unknown {
-  const response: Record<string, unknown> = { _chunks: new Map() };
-  response._weakResponse = { response };
-  return { status: 'pending', value: null, reason: response, then: () => undefined };
-}
-
-describe('PageRenderer', () => {
-  it('server-renders blocks that carry a streamed (circular) promise', () => {
-    const blocks = [
-      { type: 'content', data: { markdown: 'Fresh meals, delivered' }, productsPromise: circularThenable(), metaobjectsPromise: circularThenable() },
-    ] as unknown as Block[];
-    const theme = { getBlock: () => () => null } as unknown as ThemeModule;
-    const store = { vendor: { id: 'v1', slug: 'demo-store' }, config: {}, menus: [], basePath: '', pagesChrome: {} };
-
-    const html = renderToStaticMarkup(
-      <StorefrontContext.Provider value={store as never}>
-        <ThemeProvider theme={theme}>
-          <PageRenderer blocks={blocks} />
-        </ThemeProvider>
-      </StorefrontContext.Provider>,
-    );
-
-    expect(html).toContain('Fresh meals, delivered');
-  });
-});

package/tests/powered-by-queek.test.tsx

@@ -1,65 +0,0 @@
-import React from 'react';
-import { renderToStaticMarkup } from 'react-dom/server';
-import { describe, expect, it } from 'vitest';
-import { PoweredByQueek } from '../components/powered-by-queek';
-import { StorefrontContext } from '../provider';
-
-const BASE = 'https://usequeek.com/business?utm_source=powered_by&utm_medium=storefront';
-
-function render(props?: { className?: string; hidden?: boolean }, vendor?: { id: string; slug: string | null }): string {
-  const element = React.createElement(PoweredByQueek, props);
-
-  if (!vendor) return renderToStaticMarkup(element);
-
-  return renderToStaticMarkup(
-    React.createElement(StorefrontContext.Provider, { value: { vendor } as never }, element),
-  );
-}
-
-describe('PoweredByQueek', () => {
-  it('links to the Queek business page with the attribution contract intact', () => {
-    const html = render();
-
-    expect(html).toContain('<a');
-    expect(html).toContain(`href="${BASE}"`);
-    expect(html).toContain('target="_blank"');
-    expect(html).toContain('rel="noopener noreferrer"');
-  });
-
-  it('tags the link with the store slug as utm_campaign', () => {
-    const html = render(undefined, { id: 'uuid-1', slug: 'demo-store' });
-
-    expect(html).toContain(`href="${BASE}&amp;utm_campaign=demo-store"`);
-    expect(html).toContain('rel="noopener noreferrer"');
-  });
-
-  it('omits utm_campaign (never the internal UUID) when the store has no slug', () => {
-    const html = render(undefined, { id: 'uuid-1', slug: null });
-
-    expect(html).not.toContain('utm_campaign');
-    expect(html).not.toContain('uuid-1');
-  });
-
-  it('omits utm_campaign (never errors) when no storefront provider is mounted', () => {
-    expect(render()).not.toContain('utm_campaign');
-  });
-
-  it('renders "Powered by Queek" with the brand hook for theme styling', () => {
-    const html = render();
-
-    expect(html).toContain('core-powered-by');
-    expect(html).toContain('Powered by');
-    expect(html).toContain('<strong class="core-powered-by__brand">Queek</strong>');
-  });
-
-  it('passes a footer positioning class through alongside the core class', () => {
-    const html = render({ className: 'qn-footer4__powered' });
-
-    expect(html).toContain('class="core-powered-by qn-footer4__powered"');
-  });
-
-  it('renders nothing when hidden', () => {
-    expect(render({ hidden: true })).toBe('');
-    expect(render({ hidden: true }, { id: 'uuid-1', slug: 'demo-store' })).toBe('');
-  });
-});

package/tests/powered-by-url.test.ts

@@ -1,49 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { POWERED_BY_QUEEK_URL, poweredByQueekUrl } from '../utils/powered-by';
-
-function params(url: string): Record<string, string> {
-  return Object.fromEntries(new URL(url).searchParams.entries());
-}
-
-describe('poweredByQueekUrl', () => {
-  it('keeps the business-page destination and adds source, medium and campaign', () => {
-    const url = poweredByQueekUrl('demo-store');
-
-    expect(url.startsWith(`${POWERED_BY_QUEEK_URL}?`)).toBe(true);
-    expect(params(url)).toEqual({
-      utm_source: 'powered_by',
-      utm_medium: 'storefront',
-      utm_campaign: 'demo-store',
-    });
-  });
-
-  it.each([undefined, null, '', '   '])('omits utm_campaign for a blank campaign (%j)', (campaign) => {
-    expect(params(poweredByQueekUrl(campaign))).toEqual({
-      utm_source: 'powered_by',
-      utm_medium: 'storefront',
-    });
-  });
-
-  it('preserves an existing query and overrides only its own utm keys', () => {
-    const url = poweredByQueekUrl('shop-1', 'https://usequeek.com/business?plan=pro&utm_source=old&utm_campaign=stale');
-
-    expect(params(url)).toEqual({
-      plan: 'pro',
-      utm_source: 'powered_by',
-      utm_medium: 'storefront',
-      utm_campaign: 'shop-1',
-    });
-  });
-
-  it('drops a stale utm_campaign when the new campaign is blank', () => {
-    expect(params(poweredByQueekUrl(null, 'https://usequeek.com/business?utm_campaign=stale'))).not.toHaveProperty('utm_campaign');
-  });
-
-  it('url-encodes the campaign and is deterministic (SSR-safe, no window/Date)', () => {
-    const url = poweredByQueekUrl('a b&c');
-
-    expect(url).toContain('utm_campaign=a+b%26c');
-    expect(params(url).utm_campaign).toBe('a b&c');
-    expect(poweredByQueekUrl('a b&c')).toBe(url);
-  });
-});

package/tests/product-images.test.ts

@@ -1,242 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import type { LegacyProductLike, Product } from '../types/product';
-import { normalizeProduct } from '../utils/product-normalizer';
-import { buildMediaFrames, getHoverImage, getSlideshowImages } from '../utils/product-media';
-
-function raw(overrides: LegacyProductLike = {}): LegacyProductLike {
-  return { id: 'p1', title: 'Ankara Gown', slug: 'ankara-gown', ...overrides };
-}
-
-function viewVariants(url: string) {
-  return {
-    thumb: null,
-    card: { url: '/card.jpg', w: 480, h: 480 },
-    card2x: { url: '/card2x.jpg', w: 800, h: 800 },
-    view: { url, w: 1600, h: 1600 },
-    original: { url: '/orig.jpg', w: 2400, h: 2400 },
-  };
-}
-
-describe('normalizeProduct images', () => {
-  it('carries backend images verbatim, ordered primary-first', () => {
-    const product = normalizeProduct(
-      raw({
-        media: {
-          image: 'https://cdn/x/primary.jpg',
-          thumbnail: 'https://cdn/x/thumb.jpg',
-          images: [
-            { id: 11, url: 'https://cdn/x/primary.jpg', alt: 'Front', variants: null },
-            { id: 12, url: 'https://cdn/x/side.jpg', alt: 'Side', variants: viewVariants('https://cdn/x/side-view.jpg') },
-          ],
-        },
-      }),
-    );
-
-    expect(product.media.images).toHaveLength(2);
-    expect(product.media.images?.[0]).toMatchObject({ id: 11, url: 'https://cdn/x/primary.jpg' });
-    expect(product.media.images?.[1]?.variants).toMatchObject({ view: { url: 'https://cdn/x/side-view.jpg' } });
-    // The featured shortcut is untouched.
-    expect(product.media.image).toBe('https://cdn/x/primary.jpg');
-  });
-
-  it('drops blank entries from a provided images list', () => {
-    const product = normalizeProduct(
-      raw({
-        media: {
-          image: 'https://cdn/x/primary.jpg',
-          images: [
-            { id: 11, url: '', alt: 'Blank' },
-            { id: 12, url: 'https://cdn/x/side.jpg', alt: 'Side' },
-          ],
-        },
-      }),
-    );
-
-    expect(product.media.images?.map((i) => i.url)).toEqual(['https://cdn/x/side.jpg']);
-  });
-
-  it('ignores a legacy gallery key: images come from images only', () => {
-    const product = normalizeProduct(
-      raw({
-        media: {
-          image: 'https://cdn/x/primary.jpg',
-          images: [{ id: 11, url: 'https://cdn/x/primary.jpg', alt: 'Front' }],
-          gallery: [
-            { id: 12, url: 'https://cdn/x/side.jpg', alt: 'Side' },
-            { id: 13, url: 'https://cdn/x/back.jpg', alt: 'Back' },
-          ],
-        } as LegacyProductLike['media'],
-      }),
-    );
-
-    expect(product.media.images?.map((i) => i.url)).toEqual(['https://cdn/x/primary.jpg']);
-    expect(product.media).not.toHaveProperty('gallery');
-  });
-
-  it('rejects a misspelled images key at compile time instead of silently yielding []', () => {
-    const product = normalizeProduct(
-      raw({
-        media: {
-          // @ts-expect-error `imagess` is not a media key — the narrowed type turns this typo into a compile error, not a [].
-          imagess: [{ id: 1, url: 'https://cdn/x/a.jpg' }],
-        },
-      }),
-    );
-
-    expect(product.media.images).toEqual([]);
-  });
-
-  it('derives nothing from image/gallery on old payloads: no images list means []', () => {
-    const product = normalizeProduct(
-      raw({
-        image: 'https://cdn/x/primary.jpg',
-        media: {
-          image: 'https://cdn/x/primary.jpg',
-          gallery: [
-            { id: 11, url: 'https://cdn/x/primary.jpg', alt: 'Dupe of primary' },
-            { id: 12, url: 'https://cdn/x/side.jpg', alt: 'Side' },
-            { id: 13, url: '', alt: 'Blank' },
-          ],
-        } as LegacyProductLike['media'],
-      }),
-    );
-
-    expect(product.media.images).toEqual([]);
-    expect(product.media).not.toHaveProperty('gallery');
-    // The primary shortcut itself is untouched.
-    expect(product.media.image).toBe('https://cdn/x/primary.jpg');
-  });
-
-  it('yields [] for a payload with no imagery at all and no gallery key', () => {
-    const none = normalizeProduct(raw({}));
-
-    expect(none.media.images).toEqual([]);
-    expect(none.media).not.toHaveProperty('gallery');
-  });
-
-  it('yields [] when a provided images list is entirely blank, even with gallery present', () => {
-    const product = normalizeProduct(
-      raw({
-        media: {
-          image: 'https://cdn/x/primary.jpg',
-          gallery: [{ id: 12, url: 'https://cdn/x/side.jpg' }],
-          images: [{ id: 11, url: '' }],
-        } as LegacyProductLike['media'],
-      }),
-    );
-
-    expect(product.media.images).toEqual([]);
-    expect(product.media).not.toHaveProperty('gallery');
-  });
-});
-
-describe('getHoverImage / getSlideshowImages', () => {
-  const product = (urls: string[]): Product =>
-    normalizeProduct(
-      raw({
-        media: {
-          image: urls[0] ?? null,
-          images: urls.map((url, i) => ({ id: i + 1, url })),
-        },
-      }),
-    );
-
-  it('returns images[1] and null unless two images exist', () => {
-    expect(getHoverImage(product([]))).toBeNull();
-    expect(getHoverImage(product(['https://cdn/x/a.jpg']))).toBeNull();
-    expect(getHoverImage(product(['https://cdn/x/a.jpg', 'https://cdn/x/b.jpg']))).toBe(
-      'https://cdn/x/b.jpg',
-    );
-  });
-
-  it('returns the ordered slideshow list', () => {
-    const list = getSlideshowImages(product(['https://cdn/x/a.jpg', 'https://cdn/x/b.jpg']));
-    expect(list.map((i) => i.url)).toEqual(['https://cdn/x/a.jpg', 'https://cdn/x/b.jpg']);
-  });
-
-  it('treats a missing images key as no slideshow', () => {
-    const legacy = normalizeProduct(raw({ image: 'https://cdn/x/a.jpg' }));
-    delete legacy.media.images;
-    expect(getSlideshowImages(legacy)).toEqual([]);
-    expect(getHoverImage(legacy)).toBeNull();
-  });
-});
-
-describe('buildMediaFrames reads images', () => {
-  it('renders identical frames with and without a legacy gallery key present', () => {
-    const images = [
-      { id: 11, url: 'https://cdn/x/primary.jpg', alt: 'Ankara Gown' },
-      { id: 12, url: 'https://cdn/x/side.jpg', alt: 'Side' },
-      { id: 13, url: 'https://cdn/x/back.jpg', alt: 'Back' },
-    ];
-    const withGallery = normalizeProduct(
-      raw({
-        media: {
-          image: 'https://cdn/x/primary.jpg',
-          original: 'https://cdn/x/primary-orig.jpg',
-          gallery: [{ id: 99, url: 'https://cdn/x/stale.jpg', alt: 'Stale' }],
-          images,
-        } as LegacyProductLike['media'],
-      }),
-    );
-
-    const stripped = normalizeProduct(
-      raw({
-        media: {
-          image: 'https://cdn/x/primary.jpg',
-          original: 'https://cdn/x/primary-orig.jpg',
-          images,
-        },
-      }),
-    );
-
-    const withUrls = buildMediaFrames(withGallery).map((f) => f.url);
-    const strippedUrls = buildMediaFrames(stripped).map((f) => f.url);
-    expect(withUrls).toEqual(strippedUrls);
-    expect(withUrls).toEqual([
-      'https://cdn/x/primary-orig.jpg',
-      'https://cdn/x/side.jpg',
-      'https://cdn/x/back.jpg',
-    ]);
-    expect(withUrls).not.toContain('https://cdn/x/stale.jpg');
-  });
-
-  it('builds no frames from a gallery-only payload: gallery urls never render', () => {
-    const product = normalizeProduct(
-      raw({
-        media: {
-          image: 'https://cdn/x/primary.jpg',
-          gallery: [
-            { id: 12, url: 'https://cdn/x/side.jpg', alt: 'Side' },
-            { id: 13, url: 'https://cdn/x/back.jpg', alt: 'Back' },
-          ],
-        } as LegacyProductLike['media'],
-      }),
-    );
-
-    // Only the media.image primary single-frame fallback survives — the
-    // gallery urls are ignored, not derived into images.
-    expect(product.media.images).toEqual([]);
-    expect(buildMediaFrames(product).map((f) => f.url)).toEqual(['https://cdn/x/primary.jpg']);
-  });
-
-  it('prefers the view tier off images entries and appends video last', () => {
-    const product = normalizeProduct(
-      raw({
-        media: {
-          image: 'https://cdn/x/primary.jpg',
-          images: [
-            { id: 11, url: 'https://cdn/x/primary.jpg', variants: viewVariants('https://cdn/x/primary-view.jpg') },
-            { id: 12, url: 'https://cdn/x/side.jpg' },
-          ],
-          video_url: 'https://cdn/x/clip.mp4',
-        },
-      }),
-    );
-
-    const frames = buildMediaFrames(product);
-    expect(frames.map((f) => f.type)).toEqual(['image', 'image', 'video']);
-    expect(frames[0].url).toBe('https://cdn/x/primary-view.jpg');
-    expect(frames[2].url).toBe('https://cdn/x/clip.mp4');
-  });
-});