react-ssr-seo-toolkit 1.0.2

package/dist/index.d.cts

@@ -0,0 +1,103 @@
+import { a as AlternateLink, b as OpenGraphConfig, R as RobotsConfig, T as TwitterConfig, S as SEOConfig } from './index-Dr2yktvz.cjs';
+export { A as ArticleSchemaInput, B as BreadcrumbItem, F as FAQItem, J as JSONLDBase, c as OpenGraphImage, d as OpenGraphType, O as OrganizationSchemaInput, P as ProductSchemaInput, e as TwitterCardType, W as WebsiteSchemaInput } from './index-Dr2yktvz.cjs';
+export { composeSchemas, createArticleSchema, createBreadcrumbSchema, createFAQSchema, createOrganizationSchema, createProductSchema, createWebsiteSchema } from './schema.cjs';
+export { J as JsonLd, a as JsonLdProps, S as SEOHead, b as SEOHeadProps } from './index-RBSUcdqN.cjs';
+import 'react';
+
+/**
+ * Create an SEO config with sensible defaults.
+ */
+declare function createSEOConfig(config?: SEOConfig): SEOConfig;
+/**
+ * Deep-merge a base SEO config with page-level overrides.
+ * Useful for combining a global site config with per-page config.
+ */
+declare function mergeSEOConfig(base: SEOConfig, override: SEOConfig): SEOConfig;
+/**
+ * Normalize an SEO config: trim strings, normalize URLs, remove empties.
+ */
+declare function normalizeSEOConfig(config: SEOConfig): SEOConfig;
+/**
+ * Build a title string, optionally applying a template.
+ * Template uses `%s` as the placeholder for the page title.
+ *
+ * @example
+ * buildTitle("About", "%s | MySite") // "About | MySite"
+ * buildTitle("Home") // "Home"
+ */
+declare function buildTitle(title?: string, template?: string): string;
+/**
+ * Build a description, truncating at a max length if specified.
+ */
+declare function buildDescription(description?: string, maxLength?: number): string;
+/**
+ * Build a canonical URL from a base URL and optional path.
+ */
+declare function buildCanonicalUrl(baseUrl: string, path?: string): string;
+/**
+ * Build a robots meta content string from a config.
+ *
+ * @example
+ * buildRobotsDirectives({ index: true, follow: true }) // "index, follow"
+ * buildRobotsDirectives({ index: false, follow: false, noarchive: true })
+ * // "noindex, nofollow, noarchive"
+ */
+declare function buildRobotsDirectives(config?: RobotsConfig): string;
+/**
+ * Create a noindex/nofollow robots config.
+ */
+declare function noIndexNoFollow(): RobotsConfig;
+/**
+ * Create a noindex robots config that still allows following links.
+ */
+declare function noIndex(): RobotsConfig;
+/**
+ * Build Open Graph meta tag entries from config.
+ * Returns an array of { property, content } pairs.
+ */
+declare function buildOpenGraph(config?: OpenGraphConfig): Array<{
+    property: string;
+    content: string;
+}>;
+/**
+ * Build Twitter card meta tag entries from config.
+ * Returns an array of { name, content } pairs.
+ */
+declare function buildTwitterMetadata(config?: TwitterConfig): Array<{
+    name: string;
+    content: string;
+}>;
+/**
+ * Build alternate link entries for hreflang from an array of alternates.
+ * Returns an array of { rel, hreflang, href } suitable for <link> tags.
+ */
+declare function buildAlternateLinks(alternates?: AlternateLink[]): Array<{
+    rel: string;
+    hreflang: string;
+    href: string;
+}>;
+
+/**
+ * Safely serialize a value to JSON for use in a <script> tag.
+ * Escapes characters that could break out of script context.
+ */
+declare function safeJsonLdSerialize(data: unknown): string;
+/**
+ * Strip undefined/null values from an object (shallow).
+ */
+declare function omitEmpty<T extends Record<string, unknown>>(obj: T): Partial<T>;
+/**
+ * Deep-merge two objects. Arrays are replaced, not concatenated.
+ */
+declare function deepMerge<T>(base: T, override: Partial<T>): T;
+/**
+ * Normalize a URL by trimming whitespace and removing trailing slashes
+ * (except for root "/").
+ */
+declare function normalizeUrl(url: string): string;
+/**
+ * Build a full canonical URL from a base and a path.
+ */
+declare function buildFullUrl(base: string, path?: string): string;
+
+export { AlternateLink, OpenGraphConfig, RobotsConfig, SEOConfig, TwitterConfig, buildAlternateLinks, buildCanonicalUrl, buildDescription, buildFullUrl, buildOpenGraph, buildRobotsDirectives, buildTitle, buildTwitterMetadata, createSEOConfig, deepMerge, mergeSEOConfig, noIndex, noIndexNoFollow, normalizeSEOConfig, normalizeUrl, omitEmpty, safeJsonLdSerialize };

package/dist/index.d.ts

@@ -0,0 +1,103 @@
+import { a as AlternateLink, b as OpenGraphConfig, R as RobotsConfig, T as TwitterConfig, S as SEOConfig } from './index-Dr2yktvz.js';
+export { A as ArticleSchemaInput, B as BreadcrumbItem, F as FAQItem, J as JSONLDBase, c as OpenGraphImage, d as OpenGraphType, O as OrganizationSchemaInput, P as ProductSchemaInput, e as TwitterCardType, W as WebsiteSchemaInput } from './index-Dr2yktvz.js';
+export { composeSchemas, createArticleSchema, createBreadcrumbSchema, createFAQSchema, createOrganizationSchema, createProductSchema, createWebsiteSchema } from './schema.js';
+export { J as JsonLd, a as JsonLdProps, S as SEOHead, b as SEOHeadProps } from './index-DAGfo2Fc.js';
+import 'react';
+
+/**
+ * Create an SEO config with sensible defaults.
+ */
+declare function createSEOConfig(config?: SEOConfig): SEOConfig;
+/**
+ * Deep-merge a base SEO config with page-level overrides.
+ * Useful for combining a global site config with per-page config.
+ */
+declare function mergeSEOConfig(base: SEOConfig, override: SEOConfig): SEOConfig;
+/**
+ * Normalize an SEO config: trim strings, normalize URLs, remove empties.
+ */
+declare function normalizeSEOConfig(config: SEOConfig): SEOConfig;
+/**
+ * Build a title string, optionally applying a template.
+ * Template uses `%s` as the placeholder for the page title.
+ *
+ * @example
+ * buildTitle("About", "%s | MySite") // "About | MySite"
+ * buildTitle("Home") // "Home"
+ */
+declare function buildTitle(title?: string, template?: string): string;
+/**
+ * Build a description, truncating at a max length if specified.
+ */
+declare function buildDescription(description?: string, maxLength?: number): string;
+/**
+ * Build a canonical URL from a base URL and optional path.
+ */
+declare function buildCanonicalUrl(baseUrl: string, path?: string): string;
+/**
+ * Build a robots meta content string from a config.
+ *
+ * @example
+ * buildRobotsDirectives({ index: true, follow: true }) // "index, follow"
+ * buildRobotsDirectives({ index: false, follow: false, noarchive: true })
+ * // "noindex, nofollow, noarchive"
+ */
+declare function buildRobotsDirectives(config?: RobotsConfig): string;
+/**
+ * Create a noindex/nofollow robots config.
+ */
+declare function noIndexNoFollow(): RobotsConfig;
+/**
+ * Create a noindex robots config that still allows following links.
+ */
+declare function noIndex(): RobotsConfig;
+/**
+ * Build Open Graph meta tag entries from config.
+ * Returns an array of { property, content } pairs.
+ */
+declare function buildOpenGraph(config?: OpenGraphConfig): Array<{
+    property: string;
+    content: string;
+}>;
+/**
+ * Build Twitter card meta tag entries from config.
+ * Returns an array of { name, content } pairs.
+ */
+declare function buildTwitterMetadata(config?: TwitterConfig): Array<{
+    name: string;
+    content: string;
+}>;
+/**
+ * Build alternate link entries for hreflang from an array of alternates.
+ * Returns an array of { rel, hreflang, href } suitable for <link> tags.
+ */
+declare function buildAlternateLinks(alternates?: AlternateLink[]): Array<{
+    rel: string;
+    hreflang: string;
+    href: string;
+}>;
+
+/**
+ * Safely serialize a value to JSON for use in a <script> tag.
+ * Escapes characters that could break out of script context.
+ */
+declare function safeJsonLdSerialize(data: unknown): string;
+/**
+ * Strip undefined/null values from an object (shallow).
+ */
+declare function omitEmpty<T extends Record<string, unknown>>(obj: T): Partial<T>;
+/**
+ * Deep-merge two objects. Arrays are replaced, not concatenated.
+ */
+declare function deepMerge<T>(base: T, override: Partial<T>): T;
+/**
+ * Normalize a URL by trimming whitespace and removing trailing slashes
+ * (except for root "/").
+ */
+declare function normalizeUrl(url: string): string;
+/**
+ * Build a full canonical URL from a base and a path.
+ */
+declare function buildFullUrl(base: string, path?: string): string;
+
+export { AlternateLink, OpenGraphConfig, RobotsConfig, SEOConfig, TwitterConfig, buildAlternateLinks, buildCanonicalUrl, buildDescription, buildFullUrl, buildOpenGraph, buildRobotsDirectives, buildTitle, buildTwitterMetadata, createSEOConfig, deepMerge, mergeSEOConfig, noIndex, noIndexNoFollow, normalizeSEOConfig, normalizeUrl, omitEmpty, safeJsonLdSerialize };

package/dist/index.js

@@ -0,0 +1,2 @@
+export{g as composeSchemas,d as createArticleSchema,c as createBreadcrumbSchema,f as createFAQSchema,a as createOrganizationSchema,e as createProductSchema,b as createWebsiteSchema}from'./chunk-ES4OXVOR.js';export{s as JsonLd,r as SEOHead,q as buildAlternateLinks,k as buildCanonicalUrl,j as buildDescription,e as buildFullUrl,o as buildOpenGraph,l as buildRobotsDirectives,i as buildTitle,p as buildTwitterMetadata,f as createSEOConfig,c as deepMerge,g as mergeSEOConfig,n as noIndex,m as noIndexNoFollow,h as normalizeSEOConfig,d as normalizeUrl,b as omitEmpty,a as safeJsonLdSerialize}from'./chunk-YMCW2G4X.js';//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/schema.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunk63ETSZTD_cjs=require('./chunk-63ETSZTD.cjs');Object.defineProperty(exports,"composeSchemas",{enumerable:true,get:function(){return chunk63ETSZTD_cjs.g}});Object.defineProperty(exports,"createArticleSchema",{enumerable:true,get:function(){return chunk63ETSZTD_cjs.d}});Object.defineProperty(exports,"createBreadcrumbSchema",{enumerable:true,get:function(){return chunk63ETSZTD_cjs.c}});Object.defineProperty(exports,"createFAQSchema",{enumerable:true,get:function(){return chunk63ETSZTD_cjs.f}});Object.defineProperty(exports,"createOrganizationSchema",{enumerable:true,get:function(){return chunk63ETSZTD_cjs.a}});Object.defineProperty(exports,"createProductSchema",{enumerable:true,get:function(){return chunk63ETSZTD_cjs.e}});Object.defineProperty(exports,"createWebsiteSchema",{enumerable:true,get:function(){return chunk63ETSZTD_cjs.b}});//# sourceMappingURL=schema.cjs.map
+//# sourceMappingURL=schema.cjs.map

package/dist/schema.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"schema.cjs"}

package/dist/schema.d.cts

@@ -0,0 +1,15 @@
+import { J as JSONLDBase, A as ArticleSchemaInput, B as BreadcrumbItem, F as FAQItem, O as OrganizationSchemaInput, P as ProductSchemaInput, W as WebsiteSchemaInput } from './index-Dr2yktvz.cjs';
+
+declare function createOrganizationSchema(input: OrganizationSchemaInput): JSONLDBase;
+declare function createWebsiteSchema(input: WebsiteSchemaInput): JSONLDBase;
+declare function createBreadcrumbSchema(items: BreadcrumbItem[]): JSONLDBase;
+declare function createArticleSchema(input: ArticleSchemaInput): JSONLDBase;
+declare function createProductSchema(input: ProductSchemaInput): JSONLDBase;
+declare function createFAQSchema(items: FAQItem[]): JSONLDBase;
+/**
+ * Compose multiple JSON-LD schemas into a single @graph array.
+ * Useful for embedding multiple structured data blocks in one script tag.
+ */
+declare function composeSchemas(...schemas: JSONLDBase[]): JSONLDBase;
+
+export { composeSchemas, createArticleSchema, createBreadcrumbSchema, createFAQSchema, createOrganizationSchema, createProductSchema, createWebsiteSchema };

package/dist/schema.d.ts

@@ -0,0 +1,15 @@
+import { J as JSONLDBase, A as ArticleSchemaInput, B as BreadcrumbItem, F as FAQItem, O as OrganizationSchemaInput, P as ProductSchemaInput, W as WebsiteSchemaInput } from './index-Dr2yktvz.js';
+
+declare function createOrganizationSchema(input: OrganizationSchemaInput): JSONLDBase;
+declare function createWebsiteSchema(input: WebsiteSchemaInput): JSONLDBase;
+declare function createBreadcrumbSchema(items: BreadcrumbItem[]): JSONLDBase;
+declare function createArticleSchema(input: ArticleSchemaInput): JSONLDBase;
+declare function createProductSchema(input: ProductSchemaInput): JSONLDBase;
+declare function createFAQSchema(items: FAQItem[]): JSONLDBase;
+/**
+ * Compose multiple JSON-LD schemas into a single @graph array.
+ * Useful for embedding multiple structured data blocks in one script tag.
+ */
+declare function composeSchemas(...schemas: JSONLDBase[]): JSONLDBase;
+
+export { composeSchemas, createArticleSchema, createBreadcrumbSchema, createFAQSchema, createOrganizationSchema, createProductSchema, createWebsiteSchema };

package/dist/schema.js

@@ -0,0 +1,2 @@
+export{g as composeSchemas,d as createArticleSchema,c as createBreadcrumbSchema,f as createFAQSchema,a as createOrganizationSchema,e as createProductSchema,b as createWebsiteSchema}from'./chunk-ES4OXVOR.js';//# sourceMappingURL=schema.js.map
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"schema.js"}

package/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "react-ssr-seo-toolkit",
+  "version": "1.0.2",
+  "description": "Framework-agnostic SEO utilities, metadata builders, structured data helpers, and React components for SSR applications",
+  "keywords": [
+    "seo",
+    "react",
+    "ssr",
+    "nextjs",
+    "react-router",
+    "metadata",
+    "open-graph",
+    "json-ld",
+    "structured-data",
+    "canonical",
+    "robots",
+    "twitter-card",
+    "schema-org",
+    "breadcrumb",
+    "hreflang",
+    "server-side-rendering"
+  ],
+  "author": "tonmoy1996",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Tonmoy01/react-ssr-seo.git"
+  },
+  "homepage": "https://react-ssr-seo.tonmoykhan.site/",
+  "bugs": {
+    "url": "https://github.com/Tonmoy01/react-ssr-seo/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./schema": {
+      "import": {
+        "types": "./dist/schema.d.ts",
+        "default": "./dist/schema.js"
+      },
+      "require": {
+        "types": "./dist/schema.d.cts",
+        "default": "./dist/schema.cjs"
+      }
+    },
+    "./components": {
+      "import": {
+        "types": "./dist/components.d.ts",
+        "default": "./dist/components.js"
+      },
+      "require": {
+        "types": "./dist/components.d.cts",
+        "default": "./dist/components.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf dist",
+    "demo": "tsx examples/dev-server/server.tsx",
+    "demo:build": "tsup examples/dev-server/server.tsx --format esm --platform node --out-dir demo-dist --no-splitting --no-dts --external express --external react --external react-dom --external react/jsx-runtime",
+    "demo:start": "node demo-dist/server.js"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.2.3",
+    "express": "^5.2.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.2.4",
+    "tsup": "^8.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}