@we8/cms 0.1.0

package/dist/modules/openapi/spec.js

@@ -0,0 +1,468 @@
+import { CONSENT_DECISIONS, POST_TYPES } from '../../shared/index.js';
+/**
+ * The we8 public API, described as OpenAPI 3.1.
+ *
+ * This is the durable, language-agnostic contract: a frontend in any stack
+ * calls these endpoints over HTTPS with the site's publishable key. The JS SDK
+ * (@we8/client, @we8/astro) is an optional convenience over exactly these
+ * routes, never a requirement. Served live at GET /v1/openapi.json so a
+ * deployment's API is self-describing, and kept in sync BY HAND with the public
+ * routes (the golden-file contract tests pin the actual JSON shapes; this
+ * document is the human and tooling facing description of the same surface).
+ *
+ * It is deliberately the SAME dialect a managed we8 tenant speaks, extended
+ * only by what 0.1 adds for AEO, so a site can move between the two without
+ * rewriting its frontend.
+ *
+ * Scope: the PUBLIC, frontend-facing surface only. The admin API (/v1/admin/*,
+ * reached with a signed-in session) is not documented here; this spec is what
+ * a site owner hands to whoever builds their site.
+ */
+export function buildOpenApiSpec(siteUrl) {
+    const okEnvelope = (dataProps, required = []) => ({
+        type: 'object',
+        required: ['ok', ...required],
+        properties: { ok: { type: 'boolean', enum: [true] }, ...dataProps },
+    });
+    return {
+        openapi: '3.1.0',
+        info: {
+            title: 'we8 public API',
+            version: '1.0.0',
+            description: 'The public content and engagement API for a we8 site. Call it from any ' +
+                'frontend, in any language, over HTTPS with your publishable key in the ' +
+                'X-We8-Key header. Reads are safe with a publishable (pk_) key; the ' +
+                'optional @we8/client SDK is a thin typed wrapper over these same routes.',
+        },
+        // A standalone deployment IS the API origin: there is no router in front
+        // splitting a path prefix off to somewhere else.
+        servers: [{ url: siteUrl, description: 'Your CMS' }],
+        security: [{ publishableKey: [] }],
+        tags: [
+            { name: 'content', description: 'Published posts and authors' },
+            { name: 'site', description: 'Site identity and documents' },
+            { name: 'forms', description: 'Form submissions' },
+            { name: 'analytics', description: 'Visit and consent beacons' },
+            { name: 'media', description: 'Uploaded media (keyless)' },
+            { name: 'aeo', description: 'Answer-engine surfaces' },
+            { name: 'meta', description: 'Health and this spec' },
+        ],
+        paths: {
+            '/v1/posts': {
+                get: {
+                    tags: ['content'],
+                    summary: 'List published posts',
+                    parameters: [
+                        { name: 'page', in: 'query', schema: { type: 'integer', minimum: 1, default: 1 } },
+                        {
+                            name: 'pageSize',
+                            in: 'query',
+                            schema: { type: 'integer', minimum: 1, maximum: 50, default: 20 },
+                        },
+                        { name: 'type', in: 'query', schema: { type: 'string', enum: [...POST_TYPES] } },
+                        { name: 'category', in: 'query', schema: { type: 'string' } },
+                        { name: 'tag', in: 'query', schema: { type: 'string' } },
+                    ],
+                    responses: {
+                        '200': {
+                            description: 'A page of published posts.',
+                            content: {
+                                'application/json': {
+                                    schema: okEnvelope({
+                                        items: { type: 'array', items: { $ref: '#/components/schemas/Post' } },
+                                        page: { type: 'integer' },
+                                        pageSize: { type: 'integer' },
+                                        total: { type: 'integer' },
+                                    }),
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            '/v1/posts/{slug}': {
+                get: {
+                    tags: ['content'],
+                    summary: 'Get a published post by slug',
+                    parameters: [{ name: 'slug', in: 'path', required: true, schema: { type: 'string' } }],
+                    responses: {
+                        '200': {
+                            description: 'The post, its resolved authors, and its JSON-LD.',
+                            content: {
+                                'application/json': {
+                                    schema: okEnvelope({
+                                        post: { $ref: '#/components/schemas/Post' },
+                                        authors: { type: 'array', items: { $ref: '#/components/schemas/Author' } },
+                                        jsonld: { type: 'object', additionalProperties: true },
+                                    }),
+                                },
+                            },
+                        },
+                        '404': { $ref: '#/components/responses/NotFound' },
+                    },
+                },
+            },
+            '/v1/posts/{slug}/view': {
+                post: {
+                    tags: ['content'],
+                    summary: 'Record a view (one per session)',
+                    parameters: [{ name: 'slug', in: 'path', required: true, schema: { type: 'string' } }],
+                    requestBody: { $ref: '#/components/requestBodies/SessionId' },
+                    responses: { '200': { $ref: '#/components/responses/Ok' } },
+                },
+            },
+            '/v1/posts/{slug}/like': {
+                post: {
+                    tags: ['content'],
+                    summary: 'Toggle a like (one per session)',
+                    parameters: [{ name: 'slug', in: 'path', required: true, schema: { type: 'string' } }],
+                    requestBody: { $ref: '#/components/requestBodies/SessionId' },
+                    responses: {
+                        '200': {
+                            description: 'The new like state.',
+                            content: {
+                                'application/json': {
+                                    schema: okEnvelope({
+                                        liked: { type: 'boolean' },
+                                        likeCount: { type: 'integer' },
+                                    }),
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            '/v1/authors/{slug}': {
+                get: {
+                    tags: ['content'],
+                    summary: 'Get an author by slug',
+                    parameters: [{ name: 'slug', in: 'path', required: true, schema: { type: 'string' } }],
+                    responses: {
+                        '200': {
+                            description: 'The author.',
+                            content: {
+                                'application/json': {
+                                    schema: okEnvelope({ author: { $ref: '#/components/schemas/Author' } }),
+                                },
+                            },
+                        },
+                        '404': { $ref: '#/components/responses/NotFound' },
+                    },
+                },
+            },
+            '/v1/site': {
+                get: {
+                    tags: ['site'],
+                    summary: 'Get site identity and SEO/brand config',
+                    responses: {
+                        '200': {
+                            description: 'The site config.',
+                            content: {
+                                'application/json': {
+                                    schema: okEnvelope({ site: { type: 'object', additionalProperties: true } }),
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            '/v1/documents/{kind}': {
+                get: {
+                    tags: ['site'],
+                    summary: 'Get a site document (design.md or llms.txt)',
+                    description: 'The llms-txt document doubles as the manual override for GET /llms.txt: ' +
+                        'when it has content, that content is served there verbatim.',
+                    parameters: [
+                        {
+                            name: 'kind',
+                            in: 'path',
+                            required: true,
+                            schema: { type: 'string', enum: ['design-md', 'llms-txt'] },
+                        },
+                    ],
+                    responses: {
+                        '200': {
+                            description: 'The document.',
+                            content: {
+                                'application/json': {
+                                    schema: okEnvelope({ document: { type: 'object', additionalProperties: true } }),
+                                },
+                            },
+                        },
+                        '404': { $ref: '#/components/responses/NotFound' },
+                    },
+                },
+            },
+            '/v1/forms/{formKey}/submissions': {
+                post: {
+                    tags: ['forms'],
+                    summary: 'Submit a form',
+                    description: 'Fields are passthrough; email is typical. Honeypot, Turnstile (if the ' +
+                        'form enables it), and a short dedupe window are enforced server-side.',
+                    parameters: [{ name: 'formKey', in: 'path', required: true, schema: { type: 'string' } }],
+                    requestBody: {
+                        required: true,
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'object',
+                                    properties: {
+                                        email: { type: 'string', format: 'email' },
+                                        name: { type: 'string' },
+                                        message: { type: 'string' },
+                                        sourcePage: { type: 'string' },
+                                        turnstileToken: { type: 'string' },
+                                    },
+                                    additionalProperties: true,
+                                },
+                            },
+                        },
+                    },
+                    responses: {
+                        '200': {
+                            description: 'Accepted (id is null when the honeypot silently swallowed it).',
+                            content: {
+                                'application/json': {
+                                    schema: okEnvelope({ id: { type: 'string', nullable: true } }),
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            '/v1/events/visit': {
+                post: {
+                    tags: ['analytics'],
+                    summary: 'Record an anonymous page visit',
+                    requestBody: {
+                        required: true,
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'object',
+                                    required: ['pathname', 'sessionId'],
+                                    properties: {
+                                        pathname: { type: 'string' },
+                                        sessionId: { type: 'string' },
+                                        referrer: { type: 'string' },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                    responses: { '200': { $ref: '#/components/responses/Ok' } },
+                },
+            },
+            '/v1/events/consent': {
+                post: {
+                    tags: ['analytics'],
+                    summary: 'Record a cookie-consent decision',
+                    requestBody: {
+                        required: true,
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    type: 'object',
+                                    required: ['sessionId', 'decision', 'analytics', 'performance'],
+                                    properties: {
+                                        sessionId: { type: 'string' },
+                                        decision: { type: 'string', enum: [...CONSENT_DECISIONS] },
+                                        analytics: { type: 'boolean' },
+                                        performance: { type: 'boolean' },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                    responses: { '200': { $ref: '#/components/responses/Ok' } },
+                },
+            },
+            '/v1/media/{key}': {
+                get: {
+                    tags: ['media'],
+                    summary: 'Fetch an uploaded media object (keyless)',
+                    security: [],
+                    parameters: [{ name: 'key', in: 'path', required: true, schema: { type: 'string' } }],
+                    responses: {
+                        '200': {
+                            description: 'The binary object.',
+                            content: { '*/*': { schema: { type: 'string', format: 'binary' } } },
+                        },
+                        '404': { $ref: '#/components/responses/NotFound' },
+                    },
+                },
+            },
+            '/v1/sitemap.xml': {
+                get: {
+                    tags: ['site'],
+                    // Keyless: a search crawler cannot present a key, and a sitemap
+                    // behind one is a sitemap nothing reads.
+                    summary: 'The sitemap (keyless)',
+                    security: [],
+                    responses: {
+                        '200': { description: 'XML sitemap.', content: { 'application/xml': {} } },
+                    },
+                },
+            },
+            '/llms.txt': {
+                get: {
+                    tags: ['aeo'],
+                    summary: 'The llms.txt index of this site (keyless)',
+                    description: 'Generated from site settings and published content in the llmstxt.org ' +
+                        'convention, or served verbatim when the site has authored its own. ' +
+                        'Keyless for the same reason as the sitemap: the readers are crawlers. ' +
+                        'Returns 404 when the site has turned generation off and authored nothing.',
+                    security: [],
+                    responses: {
+                        '200': { description: 'The document.', content: { 'text/plain': {} } },
+                        '404': { $ref: '#/components/responses/NotFound' },
+                    },
+                },
+            },
+            '/v1/health': {
+                get: {
+                    tags: ['meta'],
+                    summary: 'CMS health and enabled modules (keyless)',
+                    security: [],
+                    responses: {
+                        '200': {
+                            description: 'Health.',
+                            content: {
+                                'application/json': {
+                                    schema: okEnvelope({
+                                        cmsVersion: { type: 'string' },
+                                        modules: { type: 'object', additionalProperties: { type: 'boolean' } },
+                                    }),
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            '/v1/openapi.json': {
+                get: {
+                    tags: ['meta'],
+                    summary: 'This OpenAPI document (keyless)',
+                    security: [],
+                    responses: {
+                        '200': {
+                            description: 'The spec.',
+                            content: { 'application/json': { schema: { type: 'object' } } },
+                        },
+                    },
+                },
+            },
+        },
+        components: {
+            securitySchemes: {
+                publishableKey: {
+                    type: 'apiKey',
+                    in: 'header',
+                    name: 'X-We8-Key',
+                    description: 'Your publishable (pk_) key. Safe to ship in browser code.',
+                },
+                secretKey: {
+                    type: 'http',
+                    scheme: 'bearer',
+                    description: 'Your secret (sk_) key, as a bearer token. Server-side only, and ' +
+                        'accepted anywhere a publishable key is. It does NOT reach the admin ' +
+                        'API, which is gated by a signed-in session instead.',
+                },
+            },
+            requestBodies: {
+                SessionId: {
+                    required: true,
+                    content: {
+                        'application/json': {
+                            schema: {
+                                type: 'object',
+                                required: ['sessionId'],
+                                properties: { sessionId: { type: 'string' } },
+                            },
+                        },
+                    },
+                },
+            },
+            responses: {
+                Ok: {
+                    description: 'Success.',
+                    content: {
+                        'application/json': {
+                            schema: {
+                                type: 'object',
+                                required: ['ok'],
+                                properties: { ok: { type: 'boolean', enum: [true] } },
+                            },
+                        },
+                    },
+                },
+                NotFound: {
+                    description: 'Not found.',
+                    content: {
+                        'application/json': {
+                            schema: {
+                                type: 'object',
+                                required: ['ok', 'error', 'code'],
+                                properties: {
+                                    ok: { type: 'boolean', enum: [false] },
+                                    error: { type: 'string' },
+                                    code: { type: 'string' },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            schemas: {
+                Post: {
+                    type: 'object',
+                    description: 'A published post (the frozen current version).',
+                    properties: {
+                        id: { type: 'string' },
+                        postId: { type: 'string' },
+                        slug: { type: 'string' },
+                        type: { type: 'string', enum: [...POST_TYPES] },
+                        title: { type: 'string' },
+                        excerpt: { type: 'string', nullable: true },
+                        content: { type: 'string', description: 'Sanitized HTML.' },
+                        coverImageUrl: { type: 'string', nullable: true },
+                        category: { type: 'string', nullable: true },
+                        tags: { type: 'array', items: { type: 'string' } },
+                        ogTitle: { type: 'string', nullable: true },
+                        ogDescription: { type: 'string', nullable: true },
+                        ogImageUrl: { type: 'string', nullable: true },
+                        answerSummary: {
+                            type: 'string',
+                            nullable: true,
+                            description: 'AEO: the answer this content gives, written to be quoted verbatim.',
+                        },
+                        questionHeading: {
+                            type: 'string',
+                            nullable: true,
+                            description: 'AEO: the question this content answers, phrased as a question.',
+                        },
+                        authorIds: { type: 'array', items: { type: 'string' } },
+                        wordCount: { type: 'integer' },
+                        publishedAt: { type: 'string', nullable: true },
+                        viewCount: { type: 'integer' },
+                        likeCount: { type: 'integer' },
+                    },
+                },
+                Author: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'string' },
+                        slug: { type: 'string' },
+                        name: { type: 'string' },
+                        type: { type: 'string' },
+                        roleTitle: { type: 'string', nullable: true },
+                        avatarUrl: { type: 'string', nullable: true },
+                        bio: { type: 'string', nullable: true },
+                        links: { type: 'array', items: { type: 'object', additionalProperties: true } },
+                    },
+                },
+            },
+        },
+    };
+}
+//# sourceMappingURL=spec.js.map

package/dist/modules/openapi/spec.js.map

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

package/dist/modules/seo/jsonld.d.ts

@@ -0,0 +1,25 @@
+import type { AuthorRecord, PostType, PublisherSettings } from '../../shared/index.js';
+export interface JsonLdPostInput {
+    slug: string;
+    type: PostType;
+    title: string;
+    excerpt: string | null;
+    ogDescription: string | null;
+    coverImageUrl: string | null;
+    ogImageUrl: string | null;
+    answerSummary: string | null;
+    questionHeading: string | null;
+    publishedAt: string;
+}
+/**
+ * Article-family JSON-LD, authors as Person, publisher from settings.
+ *
+ * 0.1 adds the AEO half. When the author wrote an answer summary it becomes
+ * the `description`, ahead of the excerpt, because the excerpt is a teaser and
+ * the summary is the sentence written to be quoted. When there is also a
+ * question heading, the page additionally declares a `mainEntity` Question
+ * with that answer, which is the structure an answer engine actually reads a
+ * question-and-answer page through.
+ */
+export declare function buildPostJsonLd(post: JsonLdPostInput, authors: AuthorRecord[], siteUrl: string, postsPathPrefix: string, publisher: PublisherSettings | undefined): Record<string, unknown>;
+//# sourceMappingURL=jsonld.d.ts.map

package/dist/modules/seo/jsonld.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonld.d.ts","sourceRoot":"","sources":["../../../src/modules/seo/jsonld.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEvF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAgBD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,MAAM,EAEf,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,iBAAiB,GAAG,SAAS,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0CzB"}

package/dist/modules/seo/jsonld.js

@@ -0,0 +1,67 @@
+/**
+ * schema.org @type per content type: exactly the Article subtypes Google's
+ * article structured data supports; everything without a dedicated subtype is
+ * a plain Article.
+ */
+const SCHEMA_TYPE = {
+    blog: 'BlogPosting',
+    news: 'NewsArticle',
+    article: 'Article',
+    research: 'Article',
+    whitepaper: 'Article',
+    'case-study': 'Article',
+};
+/**
+ * Article-family JSON-LD, authors as Person, publisher from settings.
+ *
+ * 0.1 adds the AEO half. When the author wrote an answer summary it becomes
+ * the `description`, ahead of the excerpt, because the excerpt is a teaser and
+ * the summary is the sentence written to be quoted. When there is also a
+ * question heading, the page additionally declares a `mainEntity` Question
+ * with that answer, which is the structure an answer engine actually reads a
+ * question-and-answer page through.
+ */
+export function buildPostJsonLd(post, authors, siteUrl, 
+// Already RESOLVED via resolveContentPath(post.type, settings); callers own that.
+postsPathPrefix, publisher) {
+    const url = `${siteUrl}${postsPathPrefix}/${post.slug}`;
+    const description = post.answerSummary ?? post.excerpt ?? post.ogDescription ?? undefined;
+    const image = post.ogImageUrl ?? post.coverImageUrl ?? undefined;
+    const qa = post.questionHeading && post.answerSummary
+        ? {
+            mainEntity: {
+                '@type': 'Question',
+                name: post.questionHeading,
+                acceptedAnswer: { '@type': 'Answer', text: post.answerSummary },
+            },
+        }
+        : {};
+    return {
+        '@context': 'https://schema.org',
+        '@type': SCHEMA_TYPE[post.type],
+        headline: post.title,
+        ...(description ? { description } : {}),
+        ...(image ? { image } : {}),
+        datePublished: post.publishedAt,
+        dateModified: post.publishedAt,
+        mainEntityOfPage: url,
+        ...qa,
+        author: authors.map((author) => ({
+            '@type': 'Person',
+            name: author.name,
+            ...(author.links[0] ? { url: author.links[0].url } : {}),
+        })),
+        ...(publisher
+            ? {
+                publisher: {
+                    '@type': 'Organization',
+                    name: publisher.name,
+                    ...(publisher.logoUrl
+                        ? { logo: { '@type': 'ImageObject', url: publisher.logoUrl } }
+                        : {}),
+                },
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=jsonld.js.map

package/dist/modules/seo/jsonld.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonld.js","sourceRoot":"","sources":["../../../src/modules/seo/jsonld.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,MAAM,WAAW,GAA6B;IAC5C,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,SAAS;IACnB,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;CACxB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAqB,EACrB,OAAuB,EACvB,OAAe;AACf,kFAAkF;AAClF,eAAuB,EACvB,SAAwC;IAExC,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,eAAe,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,aAAa,IAAI,SAAS,CAAC;IAC1F,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,aAAa,IAAI,SAAS,CAAC;IACjE,MAAM,EAAE,GACN,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,aAAa;QACxC,CAAC,CAAC;YACE,UAAU,EAAE;gBACV,OAAO,EAAE,UAAU;gBACnB,IAAI,EAAE,IAAI,CAAC,eAAe;gBAC1B,cAAc,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE;aAChE;SACF;QACH,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;QACL,UAAU,EAAE,oBAAoB;QAChC,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/B,QAAQ,EAAE,IAAI,CAAC,KAAK;QACpB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,aAAa,EAAE,IAAI,CAAC,WAAW;QAC/B,YAAY,EAAE,IAAI,CAAC,WAAW;QAC9B,gBAAgB,EAAE,GAAG;QACrB,GAAG,EAAE;QACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC/B,OAAO,EAAE,QAAQ;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC,CAAC;QACH,GAAG,CAAC,SAAS;YACX,CAAC,CAAC;gBACE,SAAS,EAAE;oBACT,OAAO,EAAE,cAAc;oBACvB,IAAI,EAAE,SAAS,CAAC,IAAI;oBACpB,GAAG,CAAC,SAAS,CAAC,OAAO;wBACnB,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,CAAC,OAAO,EAAE,EAAE;wBAC9D,CAAC,CAAC,EAAE,CAAC;iBACR;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC"}

package/dist/modules/seo/routes.public.d.ts

@@ -0,0 +1,6 @@
+import { Hono } from 'hono';
+import { type Bindings } from '../../env.js';
+export declare const seoPublicRoutes: Hono<{
+    Bindings: Bindings;
+}, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=routes.public.d.ts.map

package/dist/modules/seo/routes.public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.public.d.ts","sourceRoot":"","sources":["../../../src/modules/seo/routes.public.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAI1D,eAAO,MAAM,eAAe;cAAwB,QAAQ;yCAAK,CAAC"}

package/dist/modules/seo/routes.public.js

@@ -0,0 +1,39 @@
+import { ok, resolveAllContentPaths } from '../../shared/index.js';
+import { Hono } from 'hono';
+import { getSettings } from '../../env.js';
+import { corsMiddleware } from '../../middleware/cors.js';
+import { buildSitemap } from './sitemap.js';
+export const seoPublicRoutes = new Hono();
+seoPublicRoutes.use('/sitemap.xml', corsMiddleware('publicRead'));
+seoPublicRoutes.get('/sitemap.xml', async (c) => {
+    const xml = await buildSitemap(c.env.DB, c.env.SITE_URL);
+    return c.body(xml, 200, {
+        'Content-Type': 'application/xml; charset=UTF-8',
+        'Cache-Control': 'public, max-age=900',
+    });
+});
+seoPublicRoutes.use('/site', corsMiddleware('publicRead'));
+/**
+ * The site's identity card: name, canonical URL, SEO fallbacks, publisher, and
+ * the content paths. This only stores and serves; the code-first merge, where
+ * a template's own values win and these fill the gaps, lives in @we8/astro.
+ * Deliberately NOT module-gated: a template needs it at build time regardless
+ * of which modules the site runs. Cached like the sitemap.
+ */
+seoPublicRoutes.get('/site', async (c) => {
+    const settings = await getSettings(c.env.DB);
+    const site = {
+        name: settings.publisher?.name ?? null,
+        siteUrl: c.env.SITE_URL,
+        seo: settings.seo,
+        publisher: settings.publisher ?? null,
+        postsPathPrefix: settings.postsPathPrefix,
+        contentPaths: resolveAllContentPaths(settings),
+        // "" (unconfigured, the settings-side clear signal) must never leak as a
+        // truthy-looking empty string to templates; null is the honest absence.
+        gaMeasurementId: settings.gaMeasurementId || null,
+        brand: settings.brand,
+    };
+    return c.json(ok({ site }), 200, { 'Cache-Control': 'public, max-age=900' });
+});
+//# sourceMappingURL=routes.public.js.map

package/dist/modules/seo/routes.public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.public.js","sourceRoot":"","sources":["../../../src/modules/seo/routes.public.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,sBAAsB,EAAmB,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAiB,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,IAAI,EAA0B,CAAC;AAElE,eAAe,CAAC,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;AAElE,eAAe,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;IAC9C,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzD,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE;QACtB,cAAc,EAAE,gCAAgC;QAChD,eAAe,EAAE,qBAAqB;KACvC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;AAE3D;;;;;;GAMG;AACH,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;IACvC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAe;QACvB,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,IAAI,IAAI;QACtC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ;QACvB,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,SAAS,EAAE,QAAQ,CAAC,SAAS,IAAI,IAAI;QACrC,eAAe,EAAE,QAAQ,CAAC,eAAe;QACzC,YAAY,EAAE,sBAAsB,CAAC,QAAQ,CAAC;QAC9C,yEAAyE;QACzE,wEAAwE;QACxE,eAAe,EAAE,QAAQ,CAAC,eAAe,IAAI,IAAI;QACjD,KAAK,EAAE,QAAQ,CAAC,KAAK;KACtB,CAAC;IACF,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,eAAe,EAAE,qBAAqB,EAAE,CAAC,CAAC;AAC/E,CAAC,CAAC,CAAC"}

package/dist/modules/seo/sitemap.d.ts

@@ -0,0 +1,3 @@
+/** Published posts (cap 1000, lastmod from published_at) plus the configured static routes. */
+export declare function buildSitemap(db: D1Database, siteUrl: string): Promise<string>;
+//# sourceMappingURL=sitemap.d.ts.map