@answerable-kit/metadata 0.1.0

package/README.md

@@ -0,0 +1,45 @@
+# @answerable-kit/metadata
+
+Next.js App Router metadata helpers for the [Answerable](https://github.com/Anuj7411/answerable) SEO toolkit. Compose `title`, `description`, canonical URL, OpenGraph, Twitter, and robots directives from a single typed input — with smart fallbacks across the social-card chain.
+
+> **Pre-alpha.** Only `defineSeo()` ships today. More helpers (`defineRobots()`, `defineOg()`) land in Phase 1 — see the [project roadmap](../../docs/internal/ROADMAP.md).
+
+## Install
+
+```bash
+pnpm add @answerable-kit/metadata
+# requires next >= 14
+```
+
+## Usage
+
+```tsx
+// app/layout.tsx
+import { defineSeo } from '@answerable-kit/metadata';
+
+export const metadata = defineSeo({
+  title: { default: 'Acme', template: '%s — Acme' },
+  description: 'The friendliest widget shop on the internet.',
+  url: 'https://acme.com',
+  image: 'https://acme.com/og.png',
+  siteName: 'Acme',
+  locale: 'en_US',
+});
+```
+
+What you get back is a fully-formed Next.js `Metadata` object: `title` template, `metadataBase`, `alternates.canonical`, `openGraph`, `twitter`, and (when supplied) `robots` — all populated from the same source of truth.
+
+## Smart defaults
+
+- **Image fallback chain**: a single top-level `image` populates both `openGraph.images` and `twitter.images` unless overridden.
+- **Title / description fallback**: OG and Twitter inherit from the top level unless explicitly set, and Twitter inherits from OG when set there but not on Twitter.
+- **Canonical** is required and validated as an absolute `http(s)` URL.
+- **`twitter.card` defaults to `summary_large_image`** — the better-converting default.
+
+## Robots conflict guard
+
+Googlebot directives must be *at most as permissive* as the top-level directives — Google can be told to be stricter than the global, but not looser. `defineSeo()` rejects e.g. `index: false` at the top with `googleBot.index: true`.
+
+## License
+
+[MIT](../../LICENSE) © 2026 Anuj Ojha

package/dist/define-seo.d.ts

@@ -0,0 +1,75 @@
+import type { Metadata } from 'next';
+/**
+ * A static title (`"Acme"`) or a templated title with `%s` placeholder
+ * that Next.js substitutes with each child page's title
+ * (`{ default: "Acme", template: "%s — Acme" }`).
+ */
+export type SeoTitle = string | {
+    readonly default: string;
+    readonly template: string;
+};
+export interface SeoOpenGraph {
+    /** Defaults to the top-level title. */
+    readonly title?: string | undefined;
+    /** Defaults to the top-level description. */
+    readonly description?: string | undefined;
+    readonly siteName?: string | undefined;
+    /** BCP 47 locale code, e.g. `"en_US"`. */
+    readonly locale?: string | undefined;
+    readonly type?: 'website' | 'article' | 'profile' | 'book' | undefined;
+    /** Absolute http(s) URLs. Defaults to `[image]` from the top level. */
+    readonly images?: readonly string[] | undefined;
+}
+export interface SeoTwitter {
+    readonly card?: 'summary' | 'summary_large_image' | 'app' | 'player' | undefined;
+    /** Defaults to og.title, then top-level title. */
+    readonly title?: string | undefined;
+    /** Defaults to og.description, then top-level description. */
+    readonly description?: string | undefined;
+    /** Defaults to og.images, then `[image]` from the top level. */
+    readonly images?: readonly string[] | undefined;
+    /** Twitter handle, e.g. `"@acme"`. */
+    readonly site?: string | undefined;
+}
+export interface SeoGoogleBotDirectives {
+    readonly index?: boolean | undefined;
+    readonly follow?: boolean | undefined;
+    readonly noimageindex?: boolean | undefined;
+    readonly 'max-snippet'?: number | undefined;
+    readonly 'max-image-preview'?: 'none' | 'standard' | 'large' | undefined;
+    readonly 'max-video-preview'?: number | undefined;
+}
+export interface SeoRobots {
+    readonly index?: boolean | undefined;
+    readonly follow?: boolean | undefined;
+    readonly googleBot?: SeoGoogleBotDirectives | undefined;
+}
+export interface SeoInput {
+    readonly title: SeoTitle;
+    readonly description: string;
+    /** Canonical absolute http(s) URL for this page. */
+    readonly url: string;
+    /** Single hero image. Populates both OG and Twitter unless overridden. */
+    readonly image?: string | undefined;
+    /** Site name, propagated to `openGraph.siteName`. */
+    readonly siteName?: string | undefined;
+    /** Default locale, propagated to `openGraph.locale`. */
+    readonly locale?: string | undefined;
+    readonly openGraph?: SeoOpenGraph | undefined;
+    readonly twitter?: SeoTwitter | undefined;
+    readonly robots?: SeoRobots | undefined;
+}
+/**
+ * Compose a complete Next.js `Metadata` object from a single typed
+ * input. Drives audit checks **A1** (title length), **A3** (meta
+ * description length), **A4** (canonical URL), and the **F-series**
+ * (OpenGraph + Twitter cards).
+ *
+ * @throws SchemaValidationError batching every issue across title,
+ *   description, and robots directives.
+ * @throws InvalidUrlError for the first malformed URL encountered
+ *   (`url`, `image`, any `openGraph.images` entry, any
+ *   `twitter.images` entry).
+ */
+export declare function defineSeo(input: SeoInput): Metadata;
+//# sourceMappingURL=define-seo.d.ts.map

package/dist/define-seo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-seo.d.ts","sourceRoot":"","sources":["../src/define-seo.ts"],"names":[],"mappings":"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"}

package/dist/define-seo.js

@@ -0,0 +1,128 @@
+import { SchemaValidationError, parseAbsoluteUrl } from '@answerable-kit/core';
+function validateTitle(t, issues) {
+    if (typeof t === 'string') {
+        if (t.trim() === '')
+            issues.push('title is empty');
+        return;
+    }
+    if (t.default.trim() === '')
+        issues.push('title.default is empty');
+    if (t.template.trim() === '')
+        issues.push('title.template is empty');
+    else if (!t.template.includes('%s')) {
+        issues.push('title.template must contain "%s" placeholder');
+    }
+}
+function validateRobots(r, issues) {
+    const bot = r.googleBot;
+    if (bot === undefined)
+        return;
+    // Googlebot must be at most as permissive as the top-level directive.
+    if (r.index === false && bot.index === true) {
+        issues.push('robots: googleBot.index cannot be true when top-level index is false (googleBot must be at most as permissive as the top-level directive)');
+    }
+    if (r.follow === false && bot.follow === true) {
+        issues.push('robots: googleBot.follow cannot be true when top-level follow is false');
+    }
+}
+function titleText(t) {
+    return typeof t === 'string' ? t : t.default;
+}
+function resolveOgImages(input) {
+    if (input.openGraph?.images !== undefined)
+        return input.openGraph.images;
+    if (input.image !== undefined)
+        return [input.image];
+    return [];
+}
+function resolveTwitterImages(input, ogImages) {
+    if (input.twitter?.images !== undefined)
+        return input.twitter.images;
+    return ogImages;
+}
+function buildOpenGraph(input, ogImageUrls) {
+    const og = {
+        title: input.openGraph?.title ?? titleText(input.title),
+        description: input.openGraph?.description ?? input.description,
+        url: parseAbsoluteUrl(input.url),
+        type: input.openGraph?.type ?? 'website',
+    };
+    const siteName = input.openGraph?.siteName ?? input.siteName;
+    if (siteName !== undefined)
+        og.siteName = siteName;
+    const locale = input.openGraph?.locale ?? input.locale;
+    if (locale !== undefined)
+        og.locale = locale;
+    if (ogImageUrls.length > 0) {
+        og.images = ogImageUrls.map((url) => ({ url: parseAbsoluteUrl(url) }));
+    }
+    return og;
+}
+function buildTwitter(input, twitterImageUrls) {
+    const tw = {
+        card: input.twitter?.card ?? 'summary_large_image',
+        title: input.twitter?.title ?? input.openGraph?.title ?? titleText(input.title),
+        description: input.twitter?.description ?? input.openGraph?.description ?? input.description,
+    };
+    if (twitterImageUrls.length > 0) {
+        tw.images = twitterImageUrls.map((url) => parseAbsoluteUrl(url));
+    }
+    if (input.twitter?.site !== undefined)
+        tw.site = input.twitter.site;
+    return tw;
+}
+function buildRobots(r) {
+    const out = {};
+    if (r.index !== undefined)
+        out.index = r.index;
+    if (r.follow !== undefined)
+        out.follow = r.follow;
+    if (r.googleBot !== undefined) {
+        // Pass through the structured-record form; Next.js accepts it.
+        out.googleBot = r.googleBot;
+    }
+    return out;
+}
+/**
+ * Compose a complete Next.js `Metadata` object from a single typed
+ * input. Drives audit checks **A1** (title length), **A3** (meta
+ * description length), **A4** (canonical URL), and the **F-series**
+ * (OpenGraph + Twitter cards).
+ *
+ * @throws SchemaValidationError batching every issue across title,
+ *   description, and robots directives.
+ * @throws InvalidUrlError for the first malformed URL encountered
+ *   (`url`, `image`, any `openGraph.images` entry, any
+ *   `twitter.images` entry).
+ */
+export function defineSeo(input) {
+    const issues = [];
+    validateTitle(input.title, issues);
+    if (input.description.trim() === '') {
+        issues.push('description is empty');
+    }
+    if (input.robots !== undefined) {
+        validateRobots(input.robots, issues);
+    }
+    if (issues.length > 0) {
+        throw new SchemaValidationError(issues);
+    }
+    const canonicalUrl = parseAbsoluteUrl(input.url);
+    const ogImageUrls = resolveOgImages(input);
+    const twitterImageUrls = resolveTwitterImages(input, ogImageUrls);
+    const out = {
+        title: input.title,
+        description: input.description,
+        metadataBase: new URL(new URL(canonicalUrl).origin),
+        alternates: {
+            canonical: canonicalUrl,
+        },
+        openGraph: buildOpenGraph(input, ogImageUrls),
+        twitter: buildTwitter(input, twitterImageUrls),
+    };
+    if (input.robots !== undefined) {
+        out.robots = buildRobots(input.robots);
+    }
+    return out;
+}
+//# sourceMappingURL=define-seo.js.map

package/dist/define-seo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-seo.js","sourceRoot":"","sources":["../src/define-seo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAkE/E,SAAS,aAAa,CAAC,CAAW,EAAE,MAAgB;IAClD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IACD,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACnE,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;SAChE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,CAAY,EAAE,MAAgB;IACpD,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC;IACxB,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO;IAC9B,sEAAsE;IACtE,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CACT,2IAA2I,CAC5I,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,CAAW;IAC5B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AAC/C,CAAC;AAED,SAAS,eAAe,CAAC,KAAe;IACtC,IAAI,KAAK,CAAC,SAAS,EAAE,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;IACzE,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAe,EAAE,QAA2B;IACxE,IAAI,KAAK,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;IACrE,OAAO,QAAQ,CAAC;AAClB,CAAC;AAQD,SAAS,cAAc,CAAC,KAAe,EAAE,WAA8B;IACrE,MAAM,EAAE,GAAc;QACpB,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;QACvD,WAAW,EAAE,KAAK,CAAC,SAAS,EAAE,WAAW,IAAI,KAAK,CAAC,WAAW;QAC9D,GAAG,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC;QAChC,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,IAAI,SAAS;KACzC,CAAC;IACF,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,EAAE,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC;IAC7D,IAAI,QAAQ,KAAK,SAAS;QAAE,EAAE,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACnD,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,EAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;IACvD,IAAI,MAAM,KAAK,SAAS;QAAE,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC;IAC7C,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,EAAE,CAAC,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,YAAY,CAAC,KAAe,EAAE,gBAAmC;IACxE,MAAM,EAAE,GAAY;QAClB,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,IAAI,qBAAqB;QAClD,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC,SAAS,EAAE,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;QAC/E,WAAW,EAAE,KAAK,CAAC,OAAO,EAAE,WAAW,IAAI,KAAK,CAAC,SAAS,EAAE,WAAW,IAAI,KAAK,CAAC,WAAW;KAC7F,CAAC;IACF,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,EAAE,CAAC,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,KAAK,SAAS;QAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;IACpE,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,WAAW,CAAC,CAAY;IAC/B,MAAM,GAAG,GAAW,EAAE,CAAC;IACvB,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAC/C,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAC9B,+DAA+D;QAC/D,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,SAAgC,CAAC;IACrD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,KAAe;IACvC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,YAAY,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAElE,MAAM,GAAG,GAAa;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,YAAY,EAAE,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC;QACnD,UAAU,EAAE;YACV,SAAS,EAAE,YAAY;SACxB;QACD,SAAS,EAAE,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC;QAC7C,OAAO,EAAE,YAAY,CAAC,KAAK,EAAE,gBAAgB,CAAC;KAC/C,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @answerable-kit/metadata — Next.js App Router metadata helpers for the
+ * Answerable SEO toolkit. Compose `title`, `description`, canonical
+ * URL, OpenGraph, Twitter cards, and robots directives from a single
+ * typed input, with smart fallbacks across the social-card chain.
+ */
+export declare const VERSION = "0.0.0";
+export { defineSeo, type SeoGoogleBotDirectives, type SeoInput, type SeoOpenGraph, type SeoRobots, type SeoTitle, type SeoTwitter, } from './define-seo.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,OAAO,EACL,SAAS,EACT,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @answerable-kit/metadata — Next.js App Router metadata helpers for the
+ * Answerable SEO toolkit. Compose `title`, `description`, canonical
+ * URL, OpenGraph, Twitter cards, and robots directives from a single
+ * typed input, with smart fallbacks across the social-card chain.
+ */
+export const VERSION = '0.0.0';
+export { defineSeo, } from './define-seo.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,OAAO,EACL,SAAS,GAOV,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@answerable-kit/metadata",
+  "version": "0.1.0",
+  "description": "Next.js App Router metadata helpers for the Answerable SEO toolkit.",
+  "license": "MIT",
+  "author": "Anuj Ojha",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Anuj7411/answerable.git",
+    "directory": "packages/metadata"
+  },
+  "homepage": "https://github.com/Anuj7411/answerable/tree/main/packages/metadata#readme",
+  "bugs": "https://github.com/Anuj7411/answerable/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist .tsbuildinfo"
+  },
+  "dependencies": {
+    "@answerable-kit/core": "workspace:*"
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0"
+  },
+  "devDependencies": {
+    "next": "^15.0.0",
+    "react": "^19.0.0",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  }
+}