@ainsleydev/sveltekit-helper 0.3.2 → 0.4.0

package/dist/components/payload/PayloadFooter.svelte

@@ -0,0 +1,34 @@
+<script lang="ts">
+import type { PayloadFooterProps } from './types.js';
+
+const { settings, pageCodeInjection }: PayloadFooterProps = $props();
+
+/**
+ * Code injection meta.
+ */
+const siteCodeInjection = $derived(settings?.codeInjection?.footer);
+const pageFooterInjection = $derived(pageCodeInjection?.footer);
+</script>
+
+<!--
+	@component
+
+	PayloadFooter renders footer code injection scripts from both
+	site-level settings and page-level overrides.
+
+	@example
+	```svelte
+	<PayloadFooter
+		settings={globalSettings}
+		pageCodeInjection={page.codeInjection}
+	/>
+	```
+-->
+<!-- Code Injection - Settings -->
+{#if siteCodeInjection}
+	{@html siteCodeInjection}
+{/if}
+<!-- Code Injection - Page -->
+{#if pageFooterInjection}
+	{@html pageFooterInjection}
+{/if}

package/dist/components/payload/PayloadFooter.svelte.d.ts

@@ -0,0 +1,17 @@
+import type { PayloadFooterProps } from './types.js';
+/**
+ * PayloadFooter renders footer code injection scripts from both
+ * site-level settings and page-level overrides.
+ *
+ * @example
+ * ```svelte
+ * <PayloadFooter
+ * 	settings={globalSettings}
+ * 	pageCodeInjection={page.codeInjection}
+ * />
+ * ```
+ */
+declare const PayloadFooter: import("svelte").Component<PayloadFooterProps, {}, "">;
+type PayloadFooter = ReturnType<typeof PayloadFooter>;
+export default PayloadFooter;
+//# sourceMappingURL=PayloadFooter.svelte.d.ts.map

package/dist/components/payload/PayloadFooter.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PayloadFooter.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/payload/PayloadFooter.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA0BrD;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,aAAa,wDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/components/payload/PayloadSEO.svelte

@@ -0,0 +1,195 @@
+<script lang="ts">
+import { serializeSchema } from '../../utils/seo/ld-json.js';
+import { resolveItems } from './resolve.js';
+
+import type { PayloadSEOProps } from './types.js';
+
+const { siteName, pageMeta, settings }: PayloadSEOProps = $props();
+
+/**
+ * Meta properties that should appear on both the
+ * page and global level.
+ */
+const meta = $derived.by(() => {
+	return {
+		title: pageMeta?.title ?? settings.meta?.title ?? settings.siteName ?? siteName,
+		description: pageMeta?.description ?? settings.meta?.description ?? settings.tagLine ?? '',
+		media: pageMeta?.image
+			? resolveItems(pageMeta.image)
+			: settings.meta?.image
+				? resolveItems(settings.meta.image)
+				: null,
+		canonical: pageMeta?.canonicalURL ?? settings.meta?.canonicalURL ?? null,
+		private: pageMeta?.private ?? settings.meta?.private ?? false,
+		structuredData: {
+			settings: settings.meta?.structuredData ?? null,
+			page: pageMeta?.structuredData ?? null,
+		},
+	};
+});
+
+/**
+ * Other meta props that could change on page refresh.
+ */
+const site = $derived(settings.siteName?.trim() ?? siteName);
+const locale = $derived(settings?.locale ?? 'en');
+const social = $derived(settings?.social ?? {});
+const codeInjectionSettings = $derived(settings?.codeInjection);
+const socialLinks = $derived(Object.values(social).filter(Boolean) as string[]);
+
+/**
+ * Generate structured data for the website.
+ */
+const websiteSchema = $derived.by(() => ({
+	'@context': 'https://schema.org',
+	'@type': 'WebSite',
+	name: siteName,
+	url: meta.canonical,
+}));
+
+/**
+ * Generate structured data for the organisation.
+ */
+const organizationSchema = $derived.by(() => {
+	if (socialLinks.length === 0) return null;
+
+	return {
+		'@context': 'https://schema.org',
+		'@type': 'Organization',
+		name: siteName,
+		...(meta.canonical ? { url: meta.canonical } : {}),
+		...(meta?.media?.url ? { logo: meta.media.url } : {}),
+		...(settings.tagLine || settings.meta?.description
+			? { description: settings.tagLine ?? settings.meta?.description }
+			: {}),
+		sameAs: socialLinks.filter((url) => url.startsWith('http')),
+		...(settings.contact?.email || settings.contact?.telephone
+			? {
+					contactPoint: [
+						{
+							'@type': 'ContactPoint',
+							...(settings.contact?.telephone
+								? { telephone: settings.contact.telephone }
+								: {}),
+							...(settings.contact?.email ? { email: settings.contact.email } : {}),
+							contactType: 'customer support',
+						},
+					],
+				}
+			: {}),
+		...(settings.address
+			? {
+					address: {
+						'@type': 'PostalAddress',
+						...(settings.address.line1
+							? { streetAddress: settings.address.line1 }
+							: {}),
+						...(settings.address.city
+							? { addressLocality: settings.address.city }
+							: {}),
+						...(settings.address.county
+							? { addressRegion: settings.address.county }
+							: {}),
+						...(settings.address.postcode
+							? { postalCode: settings.address.postcode }
+							: {}),
+						...(settings.address.country
+							? { addressCountry: settings.address.country }
+							: {}),
+					},
+				}
+			: {}),
+	};
+});
+</script>
+
+<!--
+	@component
+
+	PayloadSEO renders all head meta tags for a page, including Open Graph,
+	Twitter Card, canonical URL, structured data, and code injection from
+	Payload CMS settings.
+
+	@example
+	```svelte
+	<PayloadSEO
+		siteName="My Site"
+		settings={globalSettings}
+		pageMeta={page.meta}
+	/>
+	```
+-->
+<svelte:head>
+	<!-- Meta -->
+	<title>{meta.title} | {siteName}</title>
+	<meta name="description" content={meta.description} />
+	<!-- Canonical -->
+	{#if meta.canonical}
+		<link rel="canonical" href={meta.canonical} />
+	{/if}
+	<!-- No Index -->
+	{#if meta.private}
+		<meta name="robots" content="noindex" />
+	{/if}
+	<!-- Open Graph -->
+	<meta property="og:type" content="website" />
+	<meta property="og:title" content={meta.title} />
+	<meta property="og:description" content={meta.description} />
+	<meta property="og:site_name" content={site} />
+	<meta property="og:locale" content={locale} />
+	{#if meta.canonical}
+		<meta property="og:url" content={meta.canonical} />
+	{/if}
+	{#if meta.media}
+		{#if meta.media.url}
+			<meta property="og:image" content={meta.media.url} />
+		{/if}
+		{#if meta.media.alt}
+			<meta property="og:image:alt" content={meta.media.alt} />
+		{/if}
+		{#if meta.media.width}
+			<meta property="og:image:width" content={meta.media.width.toString()} />
+		{/if}
+		{#if meta.media.height}
+			<meta property="og:image:height" content={meta.media.height.toString()} />
+		{/if}
+		{#if meta.media.mimeType}
+			<meta property="og:image:type" content={meta.media.mimeType} />
+		{/if}
+	{/if}
+	<!-- Twitter Card -->
+	<meta name="twitter:card" content={meta?.media?.url ? 'summary_large_image' : 'summary'} />
+	<meta name="twitter:title" content={meta.title} />
+	<meta name="twitter:description" content={meta.description} />
+	{#if meta.media}
+		{#if meta.media.url}
+			<meta name="twitter:image" content={meta.media.url} />
+		{/if}
+		{#if meta.media.alt}
+			<meta name="twitter:image:alt" content={meta.media.alt} />
+		{/if}
+	{/if}
+	{#if social.x}
+		<meta name="twitter:site" content={social.x.startsWith('@') ? social.x : `@${social.x}`} />
+	{/if}
+	<!-- Structured Data - Settings -->
+	{#if meta.structuredData.settings}
+		{@html serializeSchema(meta.structuredData.settings)}
+	{/if}
+	<!-- Structured Data - Page -->
+	{#if meta.structuredData.page}
+		{@html serializeSchema(meta.structuredData.page)}
+	{/if}
+	<!-- Website Schema -->
+	{#if websiteSchema}
+		{@html serializeSchema(websiteSchema)}
+	{/if}
+	<!-- Social Organisation Schema -->
+	{#if organizationSchema}
+		{@html serializeSchema(organizationSchema)}
+	{/if}
+	<!-- Code Injection - Settings -->
+	{#if codeInjectionSettings?.head}
+		{@html codeInjectionSettings.head}
+	{/if}
+</svelte:head>

package/dist/components/payload/PayloadSEO.svelte.d.ts

@@ -0,0 +1,19 @@
+import type { PayloadSEOProps } from './types.js';
+/**
+ * PayloadSEO renders all head meta tags for a page, including Open Graph,
+ * Twitter Card, canonical URL, structured data, and code injection from
+ * Payload CMS settings.
+ *
+ * @example
+ * ```svelte
+ * <PayloadSEO
+ * 	siteName="My Site"
+ * 	settings={globalSettings}
+ * 	pageMeta={page.meta}
+ * />
+ * ```
+ */
+declare const PayloadSEO: import("svelte").Component<PayloadSEOProps, {}, "">;
+type PayloadSEO = ReturnType<typeof PayloadSEO>;
+export default PayloadSEO;
+//# sourceMappingURL=PayloadSEO.svelte.d.ts.map

package/dist/components/payload/PayloadSEO.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PayloadSEO.svelte.d.ts","sourceRoot":"","sources":["../../../src/components/payload/PayloadSEO.svelte.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAyLlD;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,UAAU,qDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/components/payload/index.d.ts

@@ -1,4 +1,7 @@
 export { default as PayloadForm } from './PayloadForm.svelte';
 export { default as PayloadMedia } from './PayloadMedia.svelte';
-export type { Media, MediaSizes, PayloadMediaProps } from './types.js';
+export { default as PayloadSEO } from './PayloadSEO.svelte';
+export { default as PayloadFooter } from './PayloadFooter.svelte';
+export { resolveItems } from './resolve.js';
+export type { Media, MediaSizes, PayloadMediaProps, PayloadSEOProps, PayloadFooterProps, PayloadMeta, PayloadSettings, PayloadSocial, PayloadCodeInjection, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/payload/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/payload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/payload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EACX,KAAK,EACL,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,aAAa,EACb,oBAAoB,GACpB,MAAM,YAAY,CAAC"}

package/dist/components/payload/index.js

@@ -1,2 +1,5 @@
 export { default as PayloadForm } from './PayloadForm.svelte';
 export { default as PayloadMedia } from './PayloadMedia.svelte';
+export { default as PayloadSEO } from './PayloadSEO.svelte';
+export { default as PayloadFooter } from './PayloadFooter.svelte';
+export { resolveItems } from './resolve.js';

package/dist/components/payload/resolve.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resolves a Payload relationship field value to its populated object.
+ * Returns null if the value is an unresolved ID (number), null or undefined.
+ *
+ * @param {number | null | undefined | T} item - The relationship field value to resolve.
+ * @returns {T | null} The populated object, or null if unresolved.
+ */
+export declare const resolveItems: <T>(item: number | null | undefined | T) => T | null;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/components/payload/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/components/payload/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,KAAG,CAAC,GAAG,IAGzE,CAAC"}

package/dist/components/payload/resolve.js

@@ -0,0 +1,12 @@
+/**
+ * Resolves a Payload relationship field value to its populated object.
+ * Returns null if the value is an unresolved ID (number), null or undefined.
+ *
+ * @param {number | null | undefined | T} item - The relationship field value to resolve.
+ * @returns {T | null} The populated object, or null if unresolved.
+ */
+export const resolveItems = (item) => {
+    if (item === null || item === undefined || typeof item === 'number')
+        return null;
+    return item;
+};

package/dist/components/payload/types.d.ts

@@ -30,4 +30,76 @@ export type Media = {
     focalY?: number | null;
     sizes?: MediaSizes;
 };
+/**
+ * Props that the PayloadSEO component expects. Accepts site-level settings
+ * and an optional page meta object which is merged with higher priority.
+ */
+export type PayloadSEOProps = {
+    siteName: string;
+    settings: PayloadSettings;
+    pageMeta?: PayloadMeta;
+    pageCodeInjection?: PayloadCodeInjection;
+};
+/**
+ * Props that the PayloadFooter component expects.
+ * Renders code injection scripts for both settings and page level.
+ */
+export type PayloadFooterProps = {
+    settings: PayloadSettings;
+    pageCodeInjection?: PayloadCodeInjection;
+};
+/**
+ * Meta exported from the Payload SEO plugin. Appears on
+ * both page and settings level.
+ */
+export type PayloadMeta = {
+    title?: string | null;
+    description?: string | null;
+    image?: (number | null) | Media;
+    private?: boolean | null;
+    canonicalURL?: string | null;
+    structuredData?: unknown;
+};
+/**
+ * Settings compatible with the type generated in Payload
+ * under the webkit settings global.
+ */
+export type PayloadSettings = {
+    siteName?: string | null;
+    locale?: string;
+    tagLine?: string | null;
+    contact?: {
+        email?: string | null;
+        telephone?: string | null;
+    };
+    address?: {
+        line1?: string | null;
+        line2?: string | null;
+        city?: string | null;
+        county?: string | null;
+        postcode?: string | null;
+        country?: string | null;
+    };
+    meta?: PayloadMeta;
+    social?: PayloadSocial;
+    codeInjection?: PayloadCodeInjection;
+};
+/**
+ * Social links that appear in the organisation settings.
+ */
+export type PayloadSocial = {
+    linkedIn?: string | null;
+    x?: string | null;
+    facebook?: string | null;
+    instagram?: string | null;
+    youtube?: string | null;
+    tiktok?: string | null;
+};
+/**
+ * Header and footer scripts to be injected.
+ */
+export type PayloadCodeInjection = {
+    head?: string | null;
+    footer?: string | null;
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/components/payload/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/payload/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,MAAM,UAAU,GAAG,MAAM,CAC9B,MAAM,EACJ,OAAO,CAAC;IACR,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC,GACF,SAAS,CACX,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG;IAC7D,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,UAAU,CAAC;CACnB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/payload/types.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -8,4 +8,5 @@ export * from './components/index.js';
 export * from './components/Grid/index.js';
 export * from './components/payload/index.js';
 export * from './utils/forms/index.js';
+export * from './utils/seo/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -9,3 +9,4 @@ export * from './components/index.js';
 export * from './components/Grid/index.js';
 export * from './components/payload/index.js';
 export * from './utils/forms/index.js';
+export * from './utils/seo/index.js';

package/dist/utils/seo/index.d.ts

@@ -0,0 +1,2 @@
+export { serializeSchema } from './ld-json.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/seo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/seo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/utils/seo/index.js

@@ -0,0 +1 @@
+export { serializeSchema } from './ld-json.js';

package/dist/utils/seo/ld-json.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Serialises a value as a JSON-LD script tag for embedding
+ * structured data in HTML.
+ *
+ * @param {unknown} thing - The structured data object to serialise.
+ * @returns {string} An application/ld+json script tag containing the serialised data.
+ */
+export declare const serializeSchema: (thing: unknown) => string;
+//# sourceMappingURL=ld-json.d.ts.map

package/dist/utils/seo/ld-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ld-json.d.ts","sourceRoot":"","sources":["../../../src/utils/seo/ld-json.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,MAEhD,CAAC"}

package/dist/utils/seo/ld-json.js

@@ -0,0 +1,10 @@
+/**
+ * Serialises a value as a JSON-LD script tag for embedding
+ * structured data in HTML.
+ *
+ * @param {unknown} thing - The structured data object to serialise.
+ * @returns {string} An application/ld+json script tag containing the serialised data.
+ */
+export const serializeSchema = (thing) => {
+    return `<script type="application/ld+json">${JSON.stringify(thing)}</script>`;
+};

package/dist/utils/seo/ld-json.test.js

@@ -0,0 +1,31 @@
+import { describe, expect, test } from 'vitest';
+import { serializeSchema } from './ld-json';
+describe('serializeSchema', () => {
+    test('serialises a simple object to a JSON-LD script tag', () => {
+        const input = { '@context': 'https://schema.org', '@type': 'WebSite', name: 'Test' };
+        const got = serializeSchema(input);
+        expect(got).toBe('<script type="application/ld+json">{"@context":"https://schema.org","@type":"WebSite","name":"Test"}</script>');
+    });
+    test('serialises a string value', () => {
+        const got = serializeSchema('hello');
+        expect(got).toBe('<script type="application/ld+json">"hello"</script>');
+    });
+    test('serialises null', () => {
+        const got = serializeSchema(null);
+        expect(got).toBe('<script type="application/ld+json">null</script>');
+    });
+    test('serialises nested objects', () => {
+        const input = {
+            '@context': 'https://schema.org',
+            '@type': 'Organization',
+            address: {
+                '@type': 'PostalAddress',
+                streetAddress: '123 Main St',
+            },
+        };
+        const got = serializeSchema(input);
+        expect(got).toContain('"@type":"Organization"');
+        expect(got).toContain('"streetAddress":"123 Main St"');
+        expect(got).toMatch(/^<script type="application\/ld\+json">.*<\/script>$/);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ainsleydev/sveltekit-helper",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "SvelteKit utilities, components and helpers for ainsley.dev builds",
   "license": "MIT",
   "type": "module",
@@ -57,6 +57,10 @@
       "types": "./dist/utils/strings/index.d.ts",
       "import": "./dist/utils/strings/index.js"
     },
+    "./utils/seo": {
+      "types": "./dist/utils/seo/index.d.ts",
+      "import": "./dist/utils/seo/index.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [