@we8/cms 0.1.0

package/dist/shared/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/shared/envelope.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,kBAAkB;IAClB,cAAc;IACd,WAAW;IACX,WAAW;IACX,UAAU;IACV,cAAc;IACd,mBAAmB;IACnB,UAAU;CACF,CAAC;AAIX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,gBAAgB,EAAE,GAAG;IACrB,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,SAAS,EAAE,GAAG;IACd,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,iBAAiB,EAAE,GAAG;IACtB,QAAQ,EAAE,GAAG;CAC+B,CAAC;AAY/C,MAAM,UAAU,EAAE,CAAmB,IAAO;IAC1C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,IAAe,EAAE,KAAa;IAChD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,IAAI,CAAmB,QAAqB;IAC1D,OAAO,QAAQ,CAAC,EAAE,KAAK,IAAI,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,KAAK,CAAmB,QAAqB;IAC3D,OAAO,QAAQ,CAAC,EAAE,KAAK,KAAK,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAe;IAC3C,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}

package/dist/shared/hash.d.ts

@@ -0,0 +1,2 @@
+export declare function sha256Hex(input: string): Promise<string>;
+//# sourceMappingURL=hash.d.ts.map

package/dist/shared/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/shared/hash.ts"],"names":[],"mappings":"AAAA,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM9D"}

package/dist/shared/hash.js

@@ -0,0 +1,8 @@
+export async function sha256Hex(input) {
+    const data = new TextEncoder().encode(input);
+    const digest = await crypto.subtle.digest('SHA-256', data);
+    return Array.from(new Uint8Array(digest))
+        .map((byte) => byte.toString(16).padStart(2, '0'))
+        .join('');
+}
+//# sourceMappingURL=hash.js.map

package/dist/shared/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/shared/hash.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAa;IAC3C,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SACjD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/dist/shared/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The self-contained kernel this package carries instead of depending on a
+ * shared library: the response envelope, the SHA-256 helper, the platform
+ * vocabularies, and the zod schemas that define the wire contract. It is a
+ * copy of managed we8's `@we8/shared`, minus everything tenancy-shaped (the
+ * internal HMAC helpers and the control-plane schemas), plus the additions
+ * 0.1 makes for AEO and for keys validated inside this worker.
+ */
+export * from './envelope.js';
+export * from './constants.js';
+export * from './hash.js';
+export * from './schemas/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC"}

package/dist/shared/index.js

@@ -0,0 +1,13 @@
+/**
+ * The self-contained kernel this package carries instead of depending on a
+ * shared library: the response envelope, the SHA-256 helper, the platform
+ * vocabularies, and the zod schemas that define the wire contract. It is a
+ * copy of managed we8's `@we8/shared`, minus everything tenancy-shaped (the
+ * internal HMAC helpers and the control-plane schemas), plus the additions
+ * 0.1 makes for AEO and for keys validated inside this worker.
+ */
+export * from './envelope.js';
+export * from './constants.js';
+export * from './hash.js';
+export * from './schemas/index.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC"}

package/dist/shared/schemas/aeo.d.ts

@@ -0,0 +1,182 @@
+import { z } from 'zod';
+export declare const aeoFindingSchema: z.ZodEnum<["missing_description", "missing_answer_summary", "missing_question_heading", "missing_json_ld", "not_in_sitemap"]>;
+export declare const userAgentClassSchema: z.ZodEnum<["human", "ai-crawler", "search-crawler", "social-crawler", "seo-crawler", "other-bot"]>;
+/**
+ * One piece of content and everything the check found missing on it. `findings`
+ * is empty when the content passes; the admin renders the empty case as a pass
+ * rather than hiding the row, so a clean site still shows its coverage.
+ */
+export declare const aeoContentCheckSchema: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    title: z.ZodString;
+    type: z.ZodEnum<["blog", "article", "news", "research", "whitepaper", "case-study"]>;
+    status: z.ZodEnum<["draft", "published", "archived"]>;
+    findings: z.ZodArray<z.ZodEnum<["missing_description", "missing_answer_summary", "missing_question_heading", "missing_json_ld", "not_in_sitemap"]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "blog" | "article" | "news" | "research" | "whitepaper" | "case-study";
+    status: "draft" | "published" | "archived";
+    slug: string;
+    id: string;
+    title: string;
+    findings: ("missing_description" | "missing_answer_summary" | "missing_question_heading" | "missing_json_ld" | "not_in_sitemap")[];
+}, {
+    type: "blog" | "article" | "news" | "research" | "whitepaper" | "case-study";
+    status: "draft" | "published" | "archived";
+    slug: string;
+    id: string;
+    title: string;
+    findings: ("missing_description" | "missing_answer_summary" | "missing_question_heading" | "missing_json_ld" | "not_in_sitemap")[];
+}>;
+/** The same check applied to a site document, which has a kind instead of a slug. */
+export declare const aeoDocumentCheckSchema: z.ZodObject<{
+    kind: z.ZodEnum<["design-md", "llms-txt"]>;
+    findings: z.ZodArray<z.ZodEnum<["missing_description", "missing_answer_summary", "missing_question_heading", "missing_json_ld", "not_in_sitemap"]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    kind: "design-md" | "llms-txt";
+    findings: ("missing_description" | "missing_answer_summary" | "missing_question_heading" | "missing_json_ld" | "not_in_sitemap")[];
+}, {
+    kind: "design-md" | "llms-txt";
+    findings: ("missing_description" | "missing_answer_summary" | "missing_question_heading" | "missing_json_ld" | "not_in_sitemap")[];
+}>;
+export declare const aeoReportSchema: z.ZodObject<{
+    posts: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodEnum<["blog", "article", "news", "research", "whitepaper", "case-study"]>;
+        status: z.ZodEnum<["draft", "published", "archived"]>;
+        findings: z.ZodArray<z.ZodEnum<["missing_description", "missing_answer_summary", "missing_question_heading", "missing_json_ld", "not_in_sitemap"]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "blog" | "article" | "news" | "research" | "whitepaper" | "case-study";
+        status: "draft" | "published" | "archived";
+        slug: string;
+        id: string;
+        title: string;
+        findings: ("missing_description" | "missing_answer_summary" | "missing_question_heading" | "missing_json_ld" | "not_in_sitemap")[];
+    }, {
+        type: "blog" | "article" | "news" | "research" | "whitepaper" | "case-study";
+        status: "draft" | "published" | "archived";
+        slug: string;
+        id: string;
+        title: string;
+        findings: ("missing_description" | "missing_answer_summary" | "missing_question_heading" | "missing_json_ld" | "not_in_sitemap")[];
+    }>, "many">;
+    documents: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["design-md", "llms-txt"]>;
+        findings: z.ZodArray<z.ZodEnum<["missing_description", "missing_answer_summary", "missing_question_heading", "missing_json_ld", "not_in_sitemap"]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        kind: "design-md" | "llms-txt";
+        findings: ("missing_description" | "missing_answer_summary" | "missing_question_heading" | "missing_json_ld" | "not_in_sitemap")[];
+    }, {
+        kind: "design-md" | "llms-txt";
+        findings: ("missing_description" | "missing_answer_summary" | "missing_question_heading" | "missing_json_ld" | "not_in_sitemap")[];
+    }>, "many">;
+    /** How many pieces of content carry each finding, for the admin's summary strip. */
+    totals: z.ZodRecord<z.ZodEnum<["missing_description", "missing_answer_summary", "missing_question_heading", "missing_json_ld", "not_in_sitemap"]>, z.ZodNumber>;
+    checkedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    posts: {
+        type: "blog" | "article" | "news" | "research" | "whitepaper" | "case-study";
+        status: "draft" | "published" | "archived";
+        slug: string;
+        id: string;
+        title: string;
+        findings: ("missing_description" | "missing_answer_summary" | "missing_question_heading" | "missing_json_ld" | "not_in_sitemap")[];
+    }[];
+    documents: {
+        kind: "design-md" | "llms-txt";
+        findings: ("missing_description" | "missing_answer_summary" | "missing_question_heading" | "missing_json_ld" | "not_in_sitemap")[];
+    }[];
+    totals: Partial<Record<"missing_description" | "missing_answer_summary" | "missing_question_heading" | "missing_json_ld" | "not_in_sitemap", number>>;
+    checkedAt: string;
+}, {
+    posts: {
+        type: "blog" | "article" | "news" | "research" | "whitepaper" | "case-study";
+        status: "draft" | "published" | "archived";
+        slug: string;
+        id: string;
+        title: string;
+        findings: ("missing_description" | "missing_answer_summary" | "missing_question_heading" | "missing_json_ld" | "not_in_sitemap")[];
+    }[];
+    documents: {
+        kind: "design-md" | "llms-txt";
+        findings: ("missing_description" | "missing_answer_summary" | "missing_question_heading" | "missing_json_ld" | "not_in_sitemap")[];
+    }[];
+    totals: Partial<Record<"missing_description" | "missing_answer_summary" | "missing_question_heading" | "missing_json_ld" | "not_in_sitemap", number>>;
+    checkedAt: string;
+}>;
+/** Crawler activity, read straight from the visit log's user-agent class. */
+export declare const aeoCrawlerStatsSchema: z.ZodObject<{
+    byClass: z.ZodArray<z.ZodObject<{
+        userAgentClass: z.ZodEnum<["human", "ai-crawler", "search-crawler", "social-crawler", "seo-crawler", "other-bot"]>;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+        userAgentClass: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot";
+    }, {
+        count: number;
+        userAgentClass: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot";
+    }>, "many">;
+    topCrawlers: z.ZodArray<z.ZodObject<{
+        botName: z.ZodString;
+        userAgentClass: z.ZodEnum<["human", "ai-crawler", "search-crawler", "social-crawler", "seo-crawler", "other-bot"]>;
+        count: z.ZodNumber;
+        lastSeenAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+        botName: string;
+        userAgentClass: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot";
+        lastSeenAt: string;
+    }, {
+        count: number;
+        botName: string;
+        userAgentClass: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot";
+        lastSeenAt: string;
+    }>, "many">;
+    daily: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        date: string;
+        count: number;
+    }, {
+        date: string;
+        count: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    daily: {
+        date: string;
+        count: number;
+    }[];
+    byClass: {
+        count: number;
+        userAgentClass: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot";
+    }[];
+    topCrawlers: {
+        count: number;
+        botName: string;
+        userAgentClass: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot";
+        lastSeenAt: string;
+    }[];
+}, {
+    daily: {
+        date: string;
+        count: number;
+    }[];
+    byClass: {
+        count: number;
+        userAgentClass: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot";
+    }[];
+    topCrawlers: {
+        count: number;
+        botName: string;
+        userAgentClass: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot";
+        lastSeenAt: string;
+    }[];
+}>;
+export type AeoContentCheck = z.infer<typeof aeoContentCheckSchema>;
+export type AeoDocumentCheck = z.infer<typeof aeoDocumentCheckSchema>;
+export type AeoReport = z.infer<typeof aeoReportSchema>;
+export type AeoCrawlerStats = z.infer<typeof aeoCrawlerStatsSchema>;
+//# sourceMappingURL=aeo.d.ts.map

package/dist/shared/schemas/aeo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aeo.d.ts","sourceRoot":"","sources":["../../../src/shared/schemas/aeo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,gBAAgB,+HAAuB,CAAC;AACrD,eAAO,MAAM,oBAAoB,oGAA6B,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;EAOhC,CAAC;AAEH,qFAAqF;AACrF,eAAO,MAAM,sBAAsB;;;;;;;;;EAGjC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAG1B,oFAAoF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGpF,CAAC;AAEH,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/shared/schemas/aeo.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { AEO_FINDINGS, USER_AGENT_CLASSES } from '../constants.js';
+import { postStatusSchema, postTypeSchema } from './post.js';
+import { siteDocumentKindSchema } from './site-document.js';
+export const aeoFindingSchema = z.enum(AEO_FINDINGS);
+export const userAgentClassSchema = z.enum(USER_AGENT_CLASSES);
+/**
+ * One piece of content and everything the check found missing on it. `findings`
+ * is empty when the content passes; the admin renders the empty case as a pass
+ * rather than hiding the row, so a clean site still shows its coverage.
+ */
+export const aeoContentCheckSchema = z.object({
+    id: z.string(),
+    slug: z.string(),
+    title: z.string(),
+    type: postTypeSchema,
+    status: postStatusSchema,
+    findings: z.array(aeoFindingSchema),
+});
+/** The same check applied to a site document, which has a kind instead of a slug. */
+export const aeoDocumentCheckSchema = z.object({
+    kind: siteDocumentKindSchema,
+    findings: z.array(aeoFindingSchema),
+});
+export const aeoReportSchema = z.object({
+    posts: z.array(aeoContentCheckSchema),
+    documents: z.array(aeoDocumentCheckSchema),
+    /** How many pieces of content carry each finding, for the admin's summary strip. */
+    totals: z.record(aeoFindingSchema, z.number().int()),
+    checkedAt: z.string(),
+});
+/** Crawler activity, read straight from the visit log's user-agent class. */
+export const aeoCrawlerStatsSchema = z.object({
+    byClass: z.array(z.object({ userAgentClass: userAgentClassSchema, count: z.number().int() })),
+    topCrawlers: z.array(z.object({
+        botName: z.string(),
+        userAgentClass: userAgentClassSchema,
+        count: z.number().int(),
+        lastSeenAt: z.string(),
+    })),
+    daily: z.array(z.object({ date: z.string(), count: z.number().int() })),
+});
+//# sourceMappingURL=aeo.js.map

package/dist/shared/schemas/aeo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aeo.js","sourceRoot":"","sources":["../../../src/shared/schemas/aeo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;AAE/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,gBAAgB;IACxB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;CACpC,CAAC,CAAC;AAEH,qFAAqF;AACrF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,sBAAsB;IAC5B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;IAC1C,oFAAoF;IACpF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC;IACpD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC7F,WAAW,EAAE,CAAC,CAAC,KAAK,CAClB,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,cAAc,EAAE,oBAAoB;QACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;QACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;KACvB,CAAC,CACH;IACD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;CACxE,CAAC,CAAC"}

package/dist/shared/schemas/analytics.d.ts

@@ -0,0 +1,277 @@
+import { z } from 'zod';
+export declare const consentDecisionSchema: z.ZodEnum<["accepted", "partial", "declined"]>;
+export declare const visitEventInputSchema: z.ZodObject<{
+    pathname: z.ZodString;
+    referrer: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    pathname: string;
+    sessionId: string;
+    referrer?: string | undefined;
+}, {
+    pathname: string;
+    sessionId: string;
+    referrer?: string | undefined;
+}>;
+export declare const consentEventInputSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    decision: z.ZodEnum<["accepted", "partial", "declined"]>;
+    analytics: z.ZodBoolean;
+    performance: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    decision: "accepted" | "partial" | "declined";
+    analytics: boolean;
+    performance: boolean;
+}, {
+    sessionId: string;
+    decision: "accepted" | "partial" | "declined";
+    analytics: boolean;
+    performance: boolean;
+}>;
+export declare const pageVisitRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    visitedAt: z.ZodString;
+    pathname: z.ZodString;
+    referrer: z.ZodNullable<z.ZodString>;
+    country: z.ZodNullable<z.ZodString>;
+    isBot: z.ZodBoolean;
+    botName: z.ZodNullable<z.ZodString>;
+    botScore: z.ZodNullable<z.ZodNumber>;
+    /** AEO (0.1): which kind of agent this was, for crawler attribution. */
+    userAgentClass: z.ZodEnum<["human", "ai-crawler", "search-crawler", "social-crawler", "seo-crawler", "other-bot"]>;
+    sessionId: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    referrer: string | null;
+    pathname: string;
+    sessionId: string | null;
+    visitedAt: string;
+    country: string | null;
+    isBot: boolean;
+    botName: string | null;
+    botScore: number | null;
+    userAgentClass: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot";
+}, {
+    id: string;
+    referrer: string | null;
+    pathname: string;
+    sessionId: string | null;
+    visitedAt: string;
+    country: string | null;
+    isBot: boolean;
+    botName: string | null;
+    botScore: number | null;
+    userAgentClass: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot";
+}>;
+export declare const visitListQuerySchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodNumber>;
+    pageSize: z.ZodDefault<z.ZodNumber>;
+} & {
+    isBot: z.ZodOptional<z.ZodEffects<z.ZodEnum<["true", "false", "1", "0"]>, boolean, "0" | "true" | "false" | "1">>;
+    userAgentClass: z.ZodOptional<z.ZodEnum<["human", "ai-crawler", "search-crawler", "social-crawler", "seo-crawler", "other-bot"]>>;
+    pathname: z.ZodOptional<z.ZodString>;
+    country: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    pageSize: number;
+    search?: string | undefined;
+    pathname?: string | undefined;
+    country?: string | undefined;
+    isBot?: boolean | undefined;
+    userAgentClass?: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot" | undefined;
+}, {
+    page?: number | undefined;
+    pageSize?: number | undefined;
+    search?: string | undefined;
+    pathname?: string | undefined;
+    country?: string | undefined;
+    isBot?: "0" | "true" | "false" | "1" | undefined;
+    userAgentClass?: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot" | undefined;
+}>;
+/**
+ * The caps differ per endpoint: visit stats allow up to 90 days, consent stats
+ * up to 365. Each route passes its own cap.
+ */
+export declare function statsQuerySchema(maxDays: number): z.ZodObject<{
+    days: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    days: number;
+}, {
+    days?: number | undefined;
+}>;
+export declare const VISIT_STATS_MAX_DAYS = 90;
+export declare const CONSENT_STATS_MAX_DAYS = 365;
+export declare const visitStatsSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    humans: z.ZodNumber;
+    bots: z.ZodNumber;
+    topPages: z.ZodArray<z.ZodObject<{
+        pathname: z.ZodString;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+        pathname: string;
+    }, {
+        count: number;
+        pathname: string;
+    }>, "many">;
+    topCountries: z.ZodArray<z.ZodObject<{
+        country: z.ZodString;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+        country: string;
+    }, {
+        count: number;
+        country: string;
+    }>, "many">;
+    topReferrers: z.ZodArray<z.ZodObject<{
+        referrer: z.ZodString;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        referrer: string;
+        count: number;
+    }, {
+        referrer: string;
+        count: number;
+    }>, "many">;
+    topBots: z.ZodArray<z.ZodObject<{
+        botName: z.ZodString;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+        botName: string;
+    }, {
+        count: number;
+        botName: string;
+    }>, "many">;
+    /** AEO (0.1): the same totals split by agent class, so crawler traffic reads separately. */
+    byUserAgentClass: z.ZodArray<z.ZodObject<{
+        userAgentClass: z.ZodEnum<["human", "ai-crawler", "search-crawler", "social-crawler", "seo-crawler", "other-bot"]>;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+        userAgentClass: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot";
+    }, {
+        count: number;
+        userAgentClass: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot";
+    }>, "many">;
+    daily: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        date: string;
+        count: number;
+    }, {
+        date: string;
+        count: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    total: number;
+    daily: {
+        date: string;
+        count: number;
+    }[];
+    humans: number;
+    bots: number;
+    topPages: {
+        count: number;
+        pathname: string;
+    }[];
+    topCountries: {
+        count: number;
+        country: string;
+    }[];
+    topReferrers: {
+        referrer: string;
+        count: number;
+    }[];
+    topBots: {
+        count: number;
+        botName: string;
+    }[];
+    byUserAgentClass: {
+        count: number;
+        userAgentClass: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot";
+    }[];
+}, {
+    total: number;
+    daily: {
+        date: string;
+        count: number;
+    }[];
+    humans: number;
+    bots: number;
+    topPages: {
+        count: number;
+        pathname: string;
+    }[];
+    topCountries: {
+        count: number;
+        country: string;
+    }[];
+    topReferrers: {
+        referrer: string;
+        count: number;
+    }[];
+    topBots: {
+        count: number;
+        botName: string;
+    }[];
+    byUserAgentClass: {
+        count: number;
+        userAgentClass: "human" | "ai-crawler" | "search-crawler" | "social-crawler" | "seo-crawler" | "other-bot";
+    }[];
+}>;
+export declare const consentStatsSchema: z.ZodObject<{
+    accepted: z.ZodNumber;
+    partial: z.ZodNumber;
+    declined: z.ZodNumber;
+    analyticsOptIn: z.ZodNumber;
+    performanceOptIn: z.ZodNumber;
+    daily: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        decision: z.ZodEnum<["accepted", "partial", "declined"]>;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        date: string;
+        count: number;
+        decision: "accepted" | "partial" | "declined";
+    }, {
+        date: string;
+        count: number;
+        decision: "accepted" | "partial" | "declined";
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    accepted: number;
+    partial: number;
+    declined: number;
+    daily: {
+        date: string;
+        count: number;
+        decision: "accepted" | "partial" | "declined";
+    }[];
+    analyticsOptIn: number;
+    performanceOptIn: number;
+}, {
+    accepted: number;
+    partial: number;
+    declined: number;
+    daily: {
+        date: string;
+        count: number;
+        decision: "accepted" | "partial" | "declined";
+    }[];
+    analyticsOptIn: number;
+    performanceOptIn: number;
+}>;
+export type VisitEventInput = z.infer<typeof visitEventInputSchema>;
+export type ConsentEventInput = z.infer<typeof consentEventInputSchema>;
+export type PageVisitRecord = z.infer<typeof pageVisitRecordSchema>;
+export type VisitListQuery = z.infer<typeof visitListQuerySchema>;
+export type StatsQuery = z.infer<ReturnType<typeof statsQuerySchema>>;
+export type VisitStats = z.infer<typeof visitStatsSchema>;
+export type ConsentStats = z.infer<typeof consentStatsSchema>;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/shared/schemas/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../src/shared/schemas/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,qBAAqB,gDAA4B,CAAC;AAU/D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAIhC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;IAShC,wEAAwE;;;;;;;;;;;;;;;;;;;;;;;;;EAGxE,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;EAM/B,CAAC;AAEH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM;;;;;;GAI/C;AAED,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQ3B,4FAA4F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK5F,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS7B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC;AACtE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/shared/schemas/analytics.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { CONSENT_DECISIONS, USER_AGENT_CLASSES } from '../constants.js';
+import { paginationQuerySchema, queryBoolSchema } from './pagination.js';
+export const consentDecisionSchema = z.enum(CONSENT_DECISIONS);
+/**
+ * Duplicated from schemas/aeo.ts on purpose: analytics owns the column, AEO
+ * owns the report, and a cross-import between the two schema files for one
+ * enum would tie the visit record to the AEO surface. Both derive from the
+ * same USER_AGENT_CLASSES constant, so they cannot drift.
+ */
+const visitUserAgentClassSchema = z.enum(USER_AGENT_CLASSES);
+export const visitEventInputSchema = z.object({
+    pathname: z.string().min(1).max(2000),
+    referrer: z.string().max(2000).optional(),
+    sessionId: z.string().min(1).max(200),
+});
+export const consentEventInputSchema = z.object({
+    sessionId: z.string().min(1).max(200),
+    decision: consentDecisionSchema,
+    analytics: z.boolean(),
+    performance: z.boolean(),
+});
+export const pageVisitRecordSchema = z.object({
+    id: z.string(),
+    visitedAt: z.string(),
+    pathname: z.string(),
+    referrer: z.string().nullable(),
+    country: z.string().nullable(),
+    isBot: z.boolean(),
+    botName: z.string().nullable(),
+    botScore: z.number().int().nullable(),
+    /** AEO (0.1): which kind of agent this was, for crawler attribution. */
+    userAgentClass: visitUserAgentClassSchema,
+    sessionId: z.string().nullable(),
+});
+export const visitListQuerySchema = paginationQuerySchema.extend({
+    isBot: queryBoolSchema.optional(),
+    userAgentClass: visitUserAgentClassSchema.optional(),
+    pathname: z.string().optional(),
+    country: z.string().optional(),
+    search: z.string().optional(),
+});
+/**
+ * The caps differ per endpoint: visit stats allow up to 90 days, consent stats
+ * up to 365. Each route passes its own cap.
+ */
+export function statsQuerySchema(maxDays) {
+    return z.object({
+        days: z.coerce.number().int().min(1).max(maxDays).default(30),
+    });
+}
+export const VISIT_STATS_MAX_DAYS = 90;
+export const CONSENT_STATS_MAX_DAYS = 365;
+export const visitStatsSchema = z.object({
+    total: z.number().int(),
+    humans: z.number().int(),
+    bots: z.number().int(),
+    topPages: z.array(z.object({ pathname: z.string(), count: z.number().int() })),
+    topCountries: z.array(z.object({ country: z.string(), count: z.number().int() })),
+    topReferrers: z.array(z.object({ referrer: z.string(), count: z.number().int() })),
+    topBots: z.array(z.object({ botName: z.string(), count: z.number().int() })),
+    /** AEO (0.1): the same totals split by agent class, so crawler traffic reads separately. */
+    byUserAgentClass: z.array(z.object({ userAgentClass: visitUserAgentClassSchema, count: z.number().int() })),
+    daily: z.array(z.object({ date: z.string(), count: z.number().int() })),
+});
+export const consentStatsSchema = z.object({
+    accepted: z.number().int(),
+    partial: z.number().int(),
+    declined: z.number().int(),
+    analyticsOptIn: z.number().int(),
+    performanceOptIn: z.number().int(),
+    daily: z.array(z.object({ date: z.string(), decision: consentDecisionSchema, count: z.number().int() })),
+});
+//# sourceMappingURL=analytics.js.map