@softure-ai/blog 0.0.0-stage → 0.1.6

package/dist/db/schema.d.ts

@@ -0,0 +1,403 @@
+import type { BlogFaqEntry, BlogSource } from "../contract.js";
+export declare const blogSchema: import("drizzle-orm/pg-core").PgSchema<"blog">;
+export declare const articles: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "articles";
+    schema: "blog";
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "articles";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        slug: import("drizzle-orm/pg-core").PgColumn<{
+            name: "slug";
+            tableName: "articles";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        kind: import("drizzle-orm/pg-core").PgColumn<{
+            name: "kind";
+            tableName: "articles";
+            dataType: "string";
+            columnType: "PgText";
+            data: "article" | "term";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: "article" | "term";
+        }>;
+        cluster: import("drizzle-orm/pg-core").PgColumn<{
+            name: "cluster";
+            tableName: "articles";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        isPillar: import("drizzle-orm/pg-core").PgColumn<{
+            name: "is_pillar";
+            tableName: "articles";
+            dataType: "boolean";
+            columnType: "PgBoolean";
+            data: boolean;
+            driverParam: boolean;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        title: import("drizzle-orm/pg-core").PgColumn<{
+            name: "title";
+            tableName: "articles";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        description: import("drizzle-orm/pg-core").PgColumn<{
+            name: "description";
+            tableName: "articles";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        summary: import("drizzle-orm/pg-core").PgColumn<{
+            name: "summary";
+            tableName: "articles";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        bodyMarkdown: import("drizzle-orm/pg-core").PgColumn<{
+            name: "body_markdown";
+            tableName: "articles";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "articles";
+            dataType: "string";
+            columnType: "PgText";
+            data: "draft" | "published" | "withdrawn";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: "draft" | "published" | "withdrawn";
+        }>;
+        currentAsOf: import("drizzle-orm/pg-core").PgColumn<{
+            name: "current_as_of";
+            tableName: "articles";
+            dataType: "string";
+            columnType: "PgDateString";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        publishedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "published_at";
+            tableName: "articles";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "articles";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        sources: import("drizzle-orm/pg-core").PgColumn<{
+            name: "sources";
+            tableName: "articles";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: readonly BlogSource[];
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: readonly BlogSource[];
+        }>;
+        faq: import("drizzle-orm/pg-core").PgColumn<{
+            name: "faq";
+            tableName: "articles";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: readonly BlogFaqEntry[];
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: readonly BlogFaqEntry[];
+        }>;
+        termForms: import("drizzle-orm/pg-core").PgColumn<{
+            name: "term_forms";
+            tableName: "articles";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: readonly string[];
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: readonly string[];
+        }>;
+        fields: import("drizzle-orm/pg-core").PgColumn<{
+            name: "fields";
+            tableName: "articles";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: Readonly<Record<string, unknown>>;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: Readonly<Record<string, unknown>>;
+        }>;
+        contentSha256: import("drizzle-orm/pg-core").PgColumn<{
+            name: "content_sha256";
+            tableName: "articles";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "articles";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const slugHistory: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "slug_history";
+    schema: "blog";
+    columns: {
+        oldSlug: import("drizzle-orm/pg-core").PgColumn<{
+            name: "old_slug";
+            tableName: "slug_history";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        articleId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "article_id";
+            tableName: "slug_history";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        changedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "changed_at";
+            tableName: "slug_history";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/db/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAsC,YAAY,EAAc,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE/G,eAAO,MAAM,UAAU,gDAAmB,CAAC;AAE3C,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBnB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMtB,CAAC"}

package/dist/db/schema.js

@@ -0,0 +1,33 @@
+// Drizzle view of the module's tables (migrations/0001_create_articles.sql). The migration is the
+// source of truth; this file only types the queries.
+import { boolean, date, jsonb, pgSchema, text, timestamp } from "drizzle-orm/pg-core";
+export const blogSchema = pgSchema("blog");
+export const articles = blogSchema.table("articles", {
+    id: text("id").primaryKey(),
+    slug: text("slug").notNull().unique("articles_slug_key"),
+    kind: text("kind").$type().notNull(),
+    cluster: text("cluster"),
+    isPillar: boolean("is_pillar").notNull().default(false),
+    title: text("title").notNull(),
+    description: text("description").notNull(),
+    summary: text("summary"),
+    bodyMarkdown: text("body_markdown").notNull(),
+    status: text("status").$type().notNull(),
+    currentAsOf: date("current_as_of", { mode: "string" }).notNull(),
+    publishedAt: timestamp("published_at", { withTimezone: true }),
+    updatedAt: timestamp("updated_at", { withTimezone: true }),
+    sources: jsonb("sources").$type().notNull().default([]),
+    faq: jsonb("faq").$type().notNull().default([]),
+    termForms: jsonb("term_forms").$type().notNull().default([]),
+    fields: jsonb("fields").$type().notNull().default({}),
+    contentSha256: text("content_sha256").notNull(),
+    createdAt: timestamp("created_at", { withTimezone: true }).notNull(),
+});
+export const slugHistory = blogSchema.table("slug_history", {
+    oldSlug: text("old_slug").primaryKey(),
+    articleId: text("article_id")
+        .notNull()
+        .references(() => articles.id, { onDelete: "cascade" }),
+    changedAt: timestamp("changed_at", { withTimezone: true }).notNull(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/db/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,qDAAqD;AACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGtF,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,EAAE;IACnD,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC;IACxD,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,CAAC,OAAO,EAAE;IACrD,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACvD,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;IAC9B,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;IAC1C,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;IACxB,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE;IAC7C,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAqB,CAAC,OAAO,EAAE;IAC3D,WAAW,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IAChE,WAAW,EAAE,SAAS,CAAC,cAAc,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC9D,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC1D,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,EAAyB,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9E,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAA2B,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACxE,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,KAAK,EAAqB,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/E,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAc,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACjE,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,OAAO,EAAE;IAC/C,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;CACrE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,cAAc,EAAE;IAC1D,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,UAAU,EAAE;IACtC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;SAC1B,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACzD,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;CACrE,CAAC,CAAC"}

package/dist/discovery/dates.d.ts

@@ -0,0 +1,9 @@
+import type { BlogArticle } from "../contract.js";
+export type DatedText = Pick<BlogArticle, "slug" | "publishedAt" | "updatedAt">;
+/** When a published text last changed: its update, else its publication. */
+export declare function getTextLastModified(text: DatedText): Date;
+/** The newest change among the texts; `null` for none. */
+export declare function getLatestModified(texts: readonly DatedText[]): Date | null;
+/** A published text always has `published_at` (the store sets it); a missing one is a bug, not a date to invent. */
+export declare function requirePublishedAt(text: Pick<BlogArticle, "slug" | "publishedAt">): Date;
+//# sourceMappingURL=dates.d.ts.map

package/dist/discovery/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/discovery/dates.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,WAAW,CAAC,CAAC;AAEhF,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAEzD;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,GAAG,IAAI,CAK1E;AAED,oHAAoH;AACpH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAAC,GAAG,IAAI,CAKxF"}

package/dist/discovery/dates.js

@@ -0,0 +1,19 @@
+/** When a published text last changed: its update, else its publication. */
+export function getTextLastModified(text) {
+    return text.updatedAt ?? requirePublishedAt(text);
+}
+/** The newest change among the texts; `null` for none. */
+export function getLatestModified(texts) {
+    return texts.reduce((latest, text) => {
+        const moment = getTextLastModified(text);
+        return latest === null || moment > latest ? moment : latest;
+    }, null);
+}
+/** A published text always has `published_at` (the store sets it); a missing one is a bug, not a date to invent. */
+export function requirePublishedAt(text) {
+    if (text.publishedAt === null) {
+        throw new Error(`requirePublishedAt: text ${text.slug} has no published_at; discovery takes published texts only`);
+    }
+    return text.publishedAt;
+}
+//# sourceMappingURL=dates.js.map

package/dist/discovery/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","sourceRoot":"","sources":["../../src/discovery/dates.ts"],"names":[],"mappings":"AAOA,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,IAAe;IACjD,OAAO,IAAI,CAAC,SAAS,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAAC,KAA2B;IAC3D,OAAO,KAAK,CAAC,MAAM,CAAc,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;QAChD,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,MAAM,KAAK,IAAI,IAAI,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9D,CAAC,EAAE,IAAI,CAAC,CAAC;AACX,CAAC;AAED,oHAAoH;AACpH,MAAM,UAAU,kBAAkB,CAAC,IAA+C;IAChF,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,IAAI,4DAA4D,CAAC,CAAC;IACrH,CAAC;IACD,OAAO,IAAI,CAAC,WAAW,CAAC;AAC1B,CAAC"}

package/dist/discovery/index.d.ts

@@ -0,0 +1,8 @@
+export { getLatestModified, getTextLastModified, type DatedText } from "./dates.js";
+export { getIndexNowPaths, type IndexNowChange } from "./indexnow.js";
+export { BLOG_REFRESH_RATE_LIMIT_BUCKET, BLOG_REFRESH_SECRET_ENV, MIN_REFRESH_SECRET_LENGTH, requestBlogRefresh, type BlogRefreshFailure, type BlogRefreshOutcome, type RequestBlogRefreshOptions, } from "./refresh.js";
+export { getRelatedArticles, PILLAR_RELATED_LIMIT, RELATED_LIMIT, type RelatedCandidate } from "./related.js";
+export { buildBlogRss, escapeXml, type BuildBlogRssInput, type FeedChannel, type FeedText } from "./rss.js";
+export { getBlogSitemapEntries, type BlogSitemapEntry, type BlogSitemapInput, type SitemapText } from "./sitemap.js";
+export { submitBlogChanges, type BlogIndexNowOutcome, type BlogIndexNowSubmit, type SubmitBlogChangesOptions } from "./submit.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EACL,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC9G,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC5G,OAAO,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACrH,OAAO,EAAE,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,wBAAwB,EAAE,MAAM,aAAa,CAAC"}

package/dist/discovery/index.js

@@ -0,0 +1,11 @@
+// Discovery without React and without Next: sitemap entries, the RSS feed, "read next", the IndexNow
+// paths and submit, and the cache refresh request after a publish. The Next pieces
+// (`../next/discovery.ts`, `../next/refresh.ts`) render and serve what it returns.
+export { getLatestModified, getTextLastModified } from "./dates.js";
+export { getIndexNowPaths } from "./indexnow.js";
+export { BLOG_REFRESH_RATE_LIMIT_BUCKET, BLOG_REFRESH_SECRET_ENV, MIN_REFRESH_SECRET_LENGTH, requestBlogRefresh, } from "./refresh.js";
+export { getRelatedArticles, PILLAR_RELATED_LIMIT, RELATED_LIMIT } from "./related.js";
+export { buildBlogRss, escapeXml } from "./rss.js";
+export { getBlogSitemapEntries } from "./sitemap.js";
+export { submitBlogChanges } from "./submit.js";
+//# sourceMappingURL=index.js.map

package/dist/discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,mFAAmF;AACnF,mFAAmF;AACnF,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAkB,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAuB,MAAM,eAAe,CAAC;AACtE,OAAO,EACL,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,GAInB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,aAAa,EAAyB,MAAM,cAAc,CAAC;AAC9G,OAAO,EAAE,YAAY,EAAE,SAAS,EAA2D,MAAM,UAAU,CAAC;AAC5G,OAAO,EAAE,qBAAqB,EAAkE,MAAM,cAAc,CAAC;AACrH,OAAO,EAAE,iBAAiB,EAAoF,MAAM,aAAa,CAAC"}

package/dist/discovery/indexnow.d.ts

@@ -0,0 +1,11 @@
+import type { PublishedChange } from "../db/publish-run.js";
+import { type BlogRoutes } from "../pages/paths.js";
+export type IndexNowChange = Pick<PublishedChange, "kind" | "action" | "statusBefore" | "statusAfter" | "slug" | "previousSlug">;
+/**
+ * The paths whose answer changed: a text public before or after (a withdrawn one answers 410 now, and
+ * search engines should learn it), its old slug when it was public (now a 301), and the hub of its
+ * kind (the listing for an article, the glossary for a term). A draft that stayed a draft and an
+ * unchanged text add nothing. Texts first, then hubs, without repeats.
+ */
+export declare function getIndexNowPaths(changes: readonly IndexNowChange[], routes: BlogRoutes): string[];
+//# sourceMappingURL=indexnow.d.ts.map

package/dist/discovery/indexnow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexnow.d.ts","sourceRoot":"","sources":["../../src/discovery/indexnow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEjE,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,GAAG,aAAa,GAAG,MAAM,GAAG,cAAc,CAAC,CAAC;AAEjI;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAYjG"}

package/dist/discovery/indexnow.js

@@ -0,0 +1,23 @@
+import { getTextPath } from "../pages/paths.js";
+/**
+ * The paths whose answer changed: a text public before or after (a withdrawn one answers 410 now, and
+ * search engines should learn it), its old slug when it was public (now a 301), and the hub of its
+ * kind (the listing for an article, the glossary for a term). A draft that stayed a draft and an
+ * unchanged text add nothing. Texts first, then hubs, without repeats.
+ */
+export function getIndexNowPaths(changes, routes) {
+    const texts = new Set();
+    const hubs = new Set();
+    for (const change of changes) {
+        const wasPublic = change.statusBefore === "published";
+        const isPublic = change.statusAfter === "published";
+        if (change.action === "unchanged" || (!wasPublic && !isPublic))
+            continue;
+        texts.add(getTextPath(routes, change.kind, change.slug));
+        if (change.previousSlug !== null && wasPublic)
+            texts.add(getTextPath(routes, change.kind, change.previousSlug));
+        hubs.add(change.kind === "term" ? routes.glossary : routes.index);
+    }
+    return [...texts, ...hubs];
+}
+//# sourceMappingURL=indexnow.js.map

package/dist/discovery/indexnow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexnow.js","sourceRoot":"","sources":["../../src/discovery/indexnow.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAmB,MAAM,mBAAmB,CAAC;AAIjE;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAkC,EAAE,MAAkB;IACrF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,KAAK,WAAW,CAAC;QACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,KAAK,WAAW,CAAC;QACpD,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC;YAAE,SAAS;QACzE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,IAAI,MAAM,CAAC,YAAY,KAAK,IAAI,IAAI,SAAS;YAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;QAChH,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/discovery/refresh.d.ts

@@ -0,0 +1,49 @@
+import type { SoftureConfig } from "@softure-ai/core";
+import type { IndexNowChange } from "./indexnow.js";
+/** The variable both the route and the command read the shared secret from. */
+export declare const BLOG_REFRESH_SECRET_ENV = "BLOG_REFRESH_SECRET";
+/** A shorter secret is a setup bug: the route refuses to run with it and the command does not send it. */
+export declare const MIN_REFRESH_SECRET_LENGTH = 32;
+/** The security bucket the route counts in; `BLOG_RATE_LIMIT_BUCKETS` holds its default. */
+export declare const BLOG_REFRESH_RATE_LIMIT_BUCKET = "blog-refresh";
+export type BlogRefreshFailure = "blog.refresh_invalid_secret" | "blog.refresh_unreachable" | "blog.refresh_rejected";
+export type BlogRefreshOutcome = 
+/** No secret in the environment: the app shows the change after `revalidateSeconds`. */
+{
+    readonly kind: "not_configured";
+    readonly revalidateSeconds: number;
+}
+/** The run changed no text. */
+ | {
+    readonly kind: "skipped";
+}
+/** No commit: the address a commit would call, and no request. */
+ | {
+    readonly kind: "dry_run";
+    readonly url: string;
+} | {
+    readonly kind: "refreshed";
+    readonly url: string;
+} | {
+    readonly kind: "failed";
+    readonly code: BlogRefreshFailure;
+    readonly reason: string;
+    readonly revalidateSeconds: number;
+};
+export interface RequestBlogRefreshOptions {
+    /** Sends the request only when `true`, i.e. after a committed run; otherwise a dry run. */
+    readonly commit?: boolean;
+    /** The app's origin to call, when it differs from `appOrigin` (a private name in a container). */
+    readonly appUrl?: string;
+    /** Default: `process.env`. */
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly fetchImpl?: typeof fetch;
+    readonly timeoutMs?: number;
+}
+/**
+ * Asks the running app to refresh the blog's cache after a publish run. Call it before the IndexNow
+ * submit, so a crawler that answers the ping finds the new text. Never throws for an expected
+ * failure: the refresh is an extra after a publish and must not undo it.
+ */
+export declare function requestBlogRefresh(config: SoftureConfig, changes: readonly IndexNowChange[], options?: RequestBlogRefreshOptions): Promise<BlogRefreshOutcome>;
+//# sourceMappingURL=refresh.d.ts.map

package/dist/discovery/refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.d.ts","sourceRoot":"","sources":["../../src/discovery/refresh.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAC7D,0GAA0G;AAC1G,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,4FAA4F;AAC5F,eAAO,MAAM,8BAA8B,iBAAiB,CAAC;AAI7D,MAAM,MAAM,kBAAkB,GAAG,6BAA6B,GAAG,0BAA0B,GAAG,uBAAuB,CAAC;AAEtH,MAAM,MAAM,kBAAkB;AAC5B,wFAAwF;AACtF;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE;AACzE,+BAA+B;GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE;AAC9B,kEAAkE;GAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhI,MAAM,WAAW,yBAAyB;IACxC,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,kGAAkG;IAClG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,cAAc,EAAE,EAAE,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0BxK"}