@geekity/cms 0.30.0 → 0.32.0

package/dist/site/setting-values.d.ts

@@ -0,0 +1,63 @@
+import type { MailProviderName } from '../mail/provider.ts';
+import type { AiCrawlerPolicy } from './robots.ts';
+import type { ContentSignalChoice, LicenseChoice } from './settings.ts';
+/**
+ * What an email address has to look like before the settings screen will keep
+ * it: something, an `@`, and a dotted host.
+ *
+ * Deliberately loose. The grammar in RFC 5321 allows addresses nobody has ever
+ * typed, and the only test that settles whether an address works is sending to
+ * it — which is what the Send test email button is for. This catches the
+ * typo where a whole field was pasted into the wrong box.
+ */
+export declare const EMAIL_PATTERN: RegExp;
+export declare function isContentSignalChoice(value: unknown): value is ContentSignalChoice;
+/** Whether a value is a count of polls the Syndication module allows: a whole number from 1. */
+export declare function isPollCount(value: unknown): value is number;
+export declare function isAiCrawlerPolicy(value: unknown): value is AiCrawlerPolicy;
+export declare function isMailProvider(value: unknown): value is MailProviderName;
+export declare function isLicenseChoice(value: string): value is LicenseChoice;
+export declare function isWholeDays(value: unknown): value is number;
+export declare function clientsWithoutPkceOf(entries: readonly unknown[]): string[];
+/**
+ * A base URL, normalised the way `resolveConfig` normalises the configured
+ * one, or `undefined` when it is not an absolute http(s) URL.
+ */
+export declare function normalizeBaseUrl(value: string): string | undefined;
+export declare function relayLines(value: string): string[];
+/**
+ * A relay textarea as the list of inboxes it names: normalised, in the order
+ * they were given, with repeats dropped.
+ *
+ * Exported because the same parsing turns a stored setting, a submitted form
+ * and a `site.json` array into the one list; a second spelling of it would let
+ * the file and the database disagree about what a site subscribes to.
+ */
+export declare function relayList(value: string): string[];
+/**
+ * A relay inbox URL, or `undefined` when it is not an absolute http(s) one.
+ *
+ * Unlike {@link normalizeBaseUrl} this keeps the whole URL bar a trailing
+ * slash: a relay inbox is a path — `/user/_____relay_____/inbox` — rather than
+ * an origin, and some relays hang one off a query string.
+ */
+export declare function normalizeRelayInbox(value: string): string | undefined;
+/** A security contact textarea as its URIs, in order, repeats dropped. */
+export declare function securityContactList(value: string): string[];
+/**
+ * One security contact as the URI security.txt carries, or `undefined`.
+ *
+ * A bare address is taken as the `mailto:` it means, since that is what
+ * somebody filling in a settings form types.
+ */
+export declare function normalizeSecurityContact(value: string): string | undefined;
+/** A security policy URL, or `undefined` when it is not an https one. */
+export declare function normalizeSecurityPolicy(value: string): string | undefined;
+/**
+ * A comma-separated list of language tags, joined the way RFC 9116's example
+ * writes them, or `undefined` when one of them is not a tag. Empty is a value.
+ */
+export declare function normalizeLanguageList(value: string): string | undefined;
+/** Whether `Intl` knows the zone. An empty name is not a zone. */
+export declare function isValidTimezone(value: string): boolean;
+//# sourceMappingURL=setting-values.d.ts.map

package/dist/site/setting-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setting-values.d.ts","sourceRoot":"","sources":["../../src/site/setting-values.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAExE;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,QAAsC,CAAC;AAEjE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAElF;AAED,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE3D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAExE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAErE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE3D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,EAAE,CAK1E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAclE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAKlD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAOjD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAcrE;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAO3D;AAKD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM1E;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzE;AAYD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMvE;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAStD"}

package/dist/site/setting-values.js

@@ -0,0 +1,170 @@
+import { LANGUAGE_TAG_PATTERN } from '../content/language.js';
+import { clientIdentifier } from '../util/client-id.js';
+import { MAIL_PROVIDERS } from '../mail/provider.js';
+import { isCreativeCommonsKey } from '../content/license.js';
+import { AI_CRAWLER_POLICIES } from './robots.js';
+/**
+ * What an email address has to look like before the settings screen will keep
+ * it: something, an `@`, and a dotted host.
+ *
+ * Deliberately loose. The grammar in RFC 5321 allows addresses nobody has ever
+ * typed, and the only test that settles whether an address works is sending to
+ * it — which is what the Send test email button is for. This catches the
+ * typo where a whole field was pasted into the wrong box.
+ */
+export const EMAIL_PATTERN = /^[^\s@]+@[^\s@.]+(?:\.[^\s@.]+)+$/;
+export function isContentSignalChoice(value) {
+    return value === '' || value === 'yes' || value === 'no';
+}
+/** Whether a value is a count of polls the Syndication module allows: a whole number from 1. */
+export function isPollCount(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value > 0;
+}
+export function isAiCrawlerPolicy(value) {
+    return AI_CRAWLER_POLICIES.includes(value);
+}
+export function isMailProvider(value) {
+    return MAIL_PROVIDERS.includes(value);
+}
+export function isLicenseChoice(value) {
+    return value === '' || value === 'custom' || isCreativeCommonsKey(value);
+}
+export function isWholeDays(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value >= 0;
+}
+export function clientsWithoutPkceOf(entries) {
+    const valid = entries.filter((entry) => typeof entry === 'string' && clientIdentifier(entry) !== undefined);
+    return [...new Set(valid)];
+}
+/**
+ * A base URL, normalised the way `resolveConfig` normalises the configured
+ * one, or `undefined` when it is not an absolute http(s) URL.
+ */
+export function normalizeBaseUrl(value) {
+    const trimmed = value.trim();
+    if (trimmed === '')
+        return undefined;
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
+        return undefined;
+    const pathname = parsed.pathname.endsWith('/') ? parsed.pathname.slice(0, -1) : parsed.pathname;
+    return parsed.origin + pathname;
+}
+export function relayLines(value) {
+    return value
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line !== '');
+}
+/**
+ * A relay textarea as the list of inboxes it names: normalised, in the order
+ * they were given, with repeats dropped.
+ *
+ * Exported because the same parsing turns a stored setting, a submitted form
+ * and a `site.json` array into the one list; a second spelling of it would let
+ * the file and the database disagree about what a site subscribes to.
+ */
+export function relayList(value) {
+    const relays = [];
+    for (const line of relayLines(value)) {
+        const inbox = normalizeRelayInbox(line);
+        if (inbox !== undefined && !relays.includes(inbox))
+            relays.push(inbox);
+    }
+    return relays;
+}
+/**
+ * A relay inbox URL, or `undefined` when it is not an absolute http(s) one.
+ *
+ * Unlike {@link normalizeBaseUrl} this keeps the whole URL bar a trailing
+ * slash: a relay inbox is a path — `/user/_____relay_____/inbox` — rather than
+ * an origin, and some relays hang one off a query string.
+ */
+export function normalizeRelayInbox(value) {
+    const trimmed = value.trim();
+    if (trimmed === '')
+        return undefined;
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
+        return undefined;
+    const href = parsed.href;
+    return href.endsWith('/') && parsed.pathname !== '/' ? href.slice(0, -1) : href;
+}
+/** A security contact textarea as its URIs, in order, repeats dropped. */
+export function securityContactList(value) {
+    const contacts = [];
+    for (const line of relayLines(value)) {
+        const contact = normalizeSecurityContact(line);
+        if (contact !== undefined && !contacts.includes(contact))
+            contacts.push(contact);
+    }
+    return contacts;
+}
+/** A phone number as a `tel:` URI writes it: digits and visual separators. */
+const TEL_PATTERN = /^tel:\+?[0-9][0-9().-]*$/i;
+/**
+ * One security contact as the URI security.txt carries, or `undefined`.
+ *
+ * A bare address is taken as the `mailto:` it means, since that is what
+ * somebody filling in a settings form types.
+ */
+export function normalizeSecurityContact(value) {
+    const trimmed = value.trim();
+    const address = trimmed.toLowerCase().startsWith('mailto:') ? trimmed.slice(7) : trimmed;
+    if (EMAIL_PATTERN.test(address))
+        return `mailto:${address}`;
+    if (TEL_PATTERN.test(trimmed))
+        return `tel:${trimmed.slice(4)}`;
+    return httpsUrl(trimmed);
+}
+/** A security policy URL, or `undefined` when it is not an https one. */
+export function normalizeSecurityPolicy(value) {
+    return httpsUrl(value.trim());
+}
+function httpsUrl(value) {
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        return undefined;
+    }
+    return parsed.protocol === 'https:' ? parsed.href : undefined;
+}
+/**
+ * A comma-separated list of language tags, joined the way RFC 9116's example
+ * writes them, or `undefined` when one of them is not a tag. Empty is a value.
+ */
+export function normalizeLanguageList(value) {
+    const tags = value
+        .split(',')
+        .map((tag) => tag.trim())
+        .filter((tag) => tag !== '');
+    return tags.every((tag) => LANGUAGE_TAG_PATTERN.test(tag)) ? tags.join(', ') : undefined;
+}
+/** Whether `Intl` knows the zone. An empty name is not a zone. */
+export function isValidTimezone(value) {
+    const zone = value.trim();
+    if (zone === '')
+        return false;
+    try {
+        new Intl.DateTimeFormat(undefined, { timeZone: zone });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=setting-values.js.map

package/dist/site/setting-values.js.map

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

package/dist/site/settings-form.d.ts

@@ -0,0 +1,30 @@
+import type { CarriedSettings, SettingsContext, SettingsField, SettingsForm } from './setting-rows.ts';
+import type { SiteSettings } from './settings.ts';
+export { SETTINGS_FIELD_NAMES } from './setting-rows.ts';
+export type { CarriedSettings, SettingsContext, SettingsField, SettingsForm, } from './setting-rows.ts';
+/** One message per field that is wrong. An empty object is a valid form. */
+export type SettingsProblems = Partial<Record<SettingsField, string>>;
+/** The form field each setting is submitted under. */
+export declare const SETTINGS_FIELDS: Readonly<Record<SettingsField, string>>;
+/**
+ * What is wrong with a submitted settings form, one message per field.
+ *
+ * `fields` is what a page carries: it validates its own fields and says
+ * nothing about the rest, so a page cannot refuse a save over a field it does
+ * not show and gives no way to fix. `context` names the directories the
+ * on-disk checks read, and an on-disk check runs only when its directory is
+ * named.
+ */
+export declare function settingsProblems(form: SettingsForm, fields?: readonly SettingsField[], context?: SettingsContext): SettingsProblems;
+/**
+ * A validated form as settings. Only call it on a form
+ * {@link settingsProblems} found nothing wrong with.
+ *
+ * The settings no form carries are passed in rather than read off the form:
+ * a save of the fields that are on the form keeps whatever is stored, so
+ * passing the settings read inside the write is all a caller has to do.
+ */
+export declare function settingsFromForm(form: SettingsForm, carriedOnFile?: CarriedSettings): SiteSettings;
+/** The settings as the form shows them. */
+export declare function formFromSettings(settings: SiteSettings): SettingsForm;
+//# sourceMappingURL=settings-form.d.ts.map

package/dist/site/settings-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-form.d.ts","sourceRoot":"","sources":["../../src/site/settings-form.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EAEf,eAAe,EACf,aAAa,EACb,YAAY,EACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EACV,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;AAStE,sDAAsD;AACtD,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAEnE,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,EAClB,MAAM,GAAE,SAAS,aAAa,EAAyB,EACvD,OAAO,GAAE,eAAoB,GAC5B,gBAAgB,CASlB;AAaD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,EAClB,aAAa,GAAE,eAAoB,GAClC,YAAY,CAId;AAWD,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,CAErE"}

package/dist/site/settings-form.js

@@ -0,0 +1,54 @@
+import { FORM_ROWS, ROWS, SETTING_KEYS, SETTINGS_FIELD_NAMES } from './setting-rows.js';
+export { SETTINGS_FIELD_NAMES } from './setting-rows.js';
+function perField(value) {
+    return Object.fromEntries(SETTINGS_FIELD_NAMES.map((name) => [name, value(name)]));
+}
+/** The form field each setting is submitted under. */
+export const SETTINGS_FIELDS = perField((name) => FORM_ROWS[name].field);
+/**
+ * What is wrong with a submitted settings form, one message per field.
+ *
+ * `fields` is what a page carries: it validates its own fields and says
+ * nothing about the rest, so a page cannot refuse a save over a field it does
+ * not show and gives no way to fix. `context` names the directories the
+ * on-disk checks read, and an on-disk check runs only when its directory is
+ * named.
+ */
+export function settingsProblems(form, fields = SETTINGS_FIELD_NAMES, context = {}) {
+    const problems = {};
+    for (const name of fields) {
+        const problem = FORM_ROWS[name].check(form) ?? onDiskProblem(name, form, context);
+        if (problem !== undefined)
+            problems[name] = problem;
+    }
+    return problems;
+}
+function onDiskProblem(name, form, context) {
+    const onDisk = FORM_ROWS[name].onDisk;
+    if (onDisk === undefined)
+        return undefined;
+    const dir = context[onDisk.dir];
+    return dir === undefined ? undefined : onDisk.problem(form[name].trim(), dir);
+}
+/**
+ * A validated form as settings. Only call it on a form
+ * {@link settingsProblems} found nothing wrong with.
+ *
+ * The settings no form carries are passed in rather than read off the form:
+ * a save of the fields that are on the form keeps whatever is stored, so
+ * passing the settings read inside the write is all a caller has to do.
+ */
+export function settingsFromForm(form, carriedOnFile = {}) {
+    return Object.fromEntries(SETTING_KEYS.map((key) => [key, ROWS[key].submitted(form, carriedOnFile)]));
+}
+function shownSetting(settings, name) {
+    const value = (name === 'license_url' || name === 'license_name'
+        ? settings.license
+        : settings[name]);
+    return FORM_ROWS[name].shown(value);
+}
+/** The settings as the form shows them. */
+export function formFromSettings(settings) {
+    return perField((name) => shownSetting(settings, name));
+}
+//# sourceMappingURL=settings-form.js.map

package/dist/site/settings-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-form.js","sourceRoot":"","sources":["../../src/site/settings-form.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAUxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAWzD,SAAS,QAAQ,CAAI,KAAiC;IACpD,OAAO,MAAM,CAAC,WAAW,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAGhF,CAAC;AACJ,CAAC;AAED,sDAAsD;AACtD,MAAM,CAAC,MAAM,eAAe,GAA4C,QAAQ,CAC9E,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAChC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAkB,EAClB,MAAM,GAA6B,oBAAoB,EACvD,OAAO,GAAoB,EAAE;IAE7B,MAAM,QAAQ,GAAqB,EAAE,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAClF,IAAI,OAAO,KAAK,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IACtD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CACpB,IAAmB,EACnB,IAAkB,EAClB,OAAwB;IAExB,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAkB,EAClB,aAAa,GAAoB,EAAE;IAEnC,OAAO,MAAM,CAAC,WAAW,CACvB,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAC3D,CAAC;AACpB,CAAC;AAED,SAAS,YAAY,CAA0B,QAAsB,EAAE,IAAO;IAC5E,MAAM,KAAK,GAAG,CACZ,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,cAAc;QAC/C,CAAC,CAAC,QAAQ,CAAC,OAAO;QAClB,CAAC,CAAC,QAAQ,CAAC,IAA0B,CAAC,CACxB,CAAC;IACnB,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,gBAAgB,CAAC,QAAsB;IACrD,OAAO,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/site/settings.d.ts

@@ -0,0 +1,29 @@
+import type { ResolvedConfig } from '../config.ts';
+import type { CreativeCommonsKey } from '../content/license.ts';
+import type { TaxonomyBases } from '../content/taxonomy.ts';
+import type { SiteSettings } from './namespace.ts';
+import type { RetentionPolicy } from './retention-policy.ts';
+import type { RobotsPolicy } from './robots.ts';
+export { DEFAULT_COMMENTS_CLOSE_AFTER_DAYS, SITE } from './namespace.ts';
+export type { SiteLicense, SiteSettings } from './namespace.ts';
+/** What a site says about one Content-Signal: yes, no, or nothing. */
+export type ContentSignalChoice = '' | 'yes' | 'no';
+export type LicenseChoice = '' | CreativeCommonsKey | 'custom';
+export declare const DEFAULT_SITE_SETTINGS: SiteSettings;
+/** What the settings say the robots file should carry. */
+export declare function robotsPolicyOf(settings: SiteSettings): RobotsPolicy;
+/** The two archive bases the settings hold, as the URL builders want them. */
+export declare function taxonomyBasesFromSettings(settings: SiteSettings): TaxonomyBases;
+/**
+ * The base URL actually in effect, and why.
+ *
+ * A base URL is a deployment fact before it is a preference: it decides the
+ * absolute URLs in the feeds, the ActivityPub ids, and whether the session
+ * cookie is `Secure`. So `GEEKITY_BASE_URL` and a `baseUrl` in the config file
+ * both win over the stored setting, and the settings form says so rather than
+ * offering a field that would quietly do nothing.
+ */
+export declare function effectiveBaseUrl(config: Pick<ResolvedConfig, 'baseUrl' | 'baseUrlSource'>, settings: SiteSettings): string;
+/** The three retention periods, as the sweep reads them. */
+export declare function retentionPolicyOf(settings: SiteSettings): RetentionPolicy;
+//# sourceMappingURL=settings.d.ts.map

package/dist/site/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/site/settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAoC,YAAY,EAAE,MAAM,aAAa,CAAC;AAElF,OAAO,EAAE,iCAAiC,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhE,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC;AAEpD,MAAM,MAAM,aAAa,GAAG,EAAE,GAAG,kBAAkB,GAAG,QAAQ,CAAC;AAE/D,eAAO,MAAM,qBAAqB,EAAE,YAAkC,CAAC;AAEvE,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,CAUnE;AAED,8EAA8E;AAC9E,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,YAAY,GAAG,aAAa,CAE/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,eAAe,CAAC,EACzD,QAAQ,EAAE,YAAY,GACrB,MAAM,CAGR;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,eAAe,CAMzE"}

package/dist/site/settings.js

@@ -0,0 +1,44 @@
+import { defaultValues } from '../settings/declare.js';
+import { SITE } from './namespace.js';
+export { DEFAULT_COMMENTS_CLOSE_AFTER_DAYS, SITE } from './namespace.js';
+export const DEFAULT_SITE_SETTINGS = defaultValues(SITE);
+/** What the settings say the robots file should carry. */
+export function robotsPolicyOf(settings) {
+    const choices = [
+        ['search', settings.content_signal_search],
+        ['ai-input', settings.content_signal_ai_input],
+        ['ai-train', settings.content_signal_ai_train],
+    ];
+    const contentSignal = {};
+    for (const [name, choice] of choices)
+        if (choice !== '')
+            contentSignal[name] = choice;
+    return { aiCrawlers: settings.ai_crawlers, contentSignal, rules: settings.robots_rules };
+}
+/** The two archive bases the settings hold, as the URL builders want them. */
+export function taxonomyBasesFromSettings(settings) {
+    return { tag: settings.tag_base, category: settings.category_base };
+}
+/**
+ * The base URL actually in effect, and why.
+ *
+ * A base URL is a deployment fact before it is a preference: it decides the
+ * absolute URLs in the feeds, the ActivityPub ids, and whether the session
+ * cookie is `Secure`. So `GEEKITY_BASE_URL` and a `baseUrl` in the config file
+ * both win over the stored setting, and the settings form says so rather than
+ * offering a field that would quietly do nothing.
+ */
+export function effectiveBaseUrl(config, settings) {
+    if (config.baseUrlSource !== 'default')
+        return config.baseUrl;
+    return settings.base_url === '' ? config.baseUrl : settings.base_url;
+}
+/** The three retention periods, as the sweep reads them. */
+export function retentionPolicyOf(settings) {
+    return {
+        commentEmailDays: settings.comment_email_retention_days,
+        addressHashDays: settings.address_hash_retention_days,
+        contactMessageDays: settings.contact_message_retention_days,
+    };
+}
+//# sourceMappingURL=settings.js.map

package/dist/site/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/site/settings.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAKtC,OAAO,EAAE,iCAAiC,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAQzE,MAAM,CAAC,MAAM,qBAAqB,GAAiB,aAAa,CAAC,IAAI,CAAC,CAAC;AAEvE,0DAA0D;AAC1D,MAAM,UAAU,cAAc,CAAC,QAAsB;IACnD,MAAM,OAAO,GAA+C;QAC1D,CAAC,QAAQ,EAAE,QAAQ,CAAC,qBAAqB,CAAC;QAC1C,CAAC,UAAU,EAAE,QAAQ,CAAC,uBAAuB,CAAC;QAC9C,CAAC,UAAU,EAAE,QAAQ,CAAC,uBAAuB,CAAC;KAC/C,CAAC;IACF,MAAM,aAAa,GAAkB,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,OAAO;QAAE,IAAI,MAAM,KAAK,EAAE;YAAE,aAAa,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;IAEtF,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC;AAC3F,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,yBAAyB,CAAC,QAAsB;IAC9D,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,aAAa,EAAE,CAAC;AACtE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAyD,EACzD,QAAsB;IAEtB,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IAC9D,OAAO,QAAQ,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;AACvE,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,iBAAiB,CAAC,QAAsB;IACtD,OAAO;QACL,gBAAgB,EAAE,QAAQ,CAAC,4BAA4B;QACvD,eAAe,EAAE,QAAQ,CAAC,2BAA2B;QACrD,kBAAkB,EAAE,QAAQ,CAAC,8BAA8B;KAC5D,CAAC;AACJ,CAAC"}

package/dist/site/site-json.d.ts

@@ -0,0 +1,38 @@
+import type { SiteSettings } from './settings.ts';
+export declare function parseSiteJson(source: string): Record<string, unknown>;
+/** The absolute path of one site's `content/_data/site.json`. */
+export declare function siteDataPath(contentDir: string): string;
+export declare function settingsFromSiteJson(file: Record<string, unknown>): SiteSettings;
+export declare function siteJsonFor(settings: SiteSettings, existing?: Record<string, unknown>): Record<string, unknown>;
+/** The bytes of one settings object, as the file holds them. */
+export declare function siteJsonText(settings: SiteSettings, existing: Record<string, unknown>): string;
+/**
+ * Rewrite `content/_data/site.json` as these settings, keeping the keys they
+ * do not model.
+ *
+ * {@link updateSiteSettings} for a caller whose new settings depend on the old
+ * ones, which every screen's is: this is for the callers that have the whole
+ * object already, a test's set-up among them.
+ */
+export declare function writeSiteJson(options: {
+    contentDir: string;
+    settings: SiteSettings;
+}): Promise<void>;
+/**
+ * Change the settings: re-read the file, apply the change, write it back, with
+ * nothing able to write that file in between ({@link updateFileAtomically}).
+ *
+ * The re-read is what makes the file win the way it wins for a post
+ * (decision-9). Two people with the settings screen open both save what they
+ * see, and the second save is applied to what the first one actually wrote
+ * rather than to what the second one had on screen — so a change to a field
+ * the second person did not touch survives. The write is a temporary file and
+ * a rename, so a reader — an Eleventy build, the site data source, another
+ * process entirely — never sees a half-written file. Keys the settings do not
+ * model, `feedSize` and anything a site added, are kept.
+ */
+export declare function updateSiteSettings(options: {
+    contentDir: string;
+    change: (current: SiteSettings) => SiteSettings;
+}): Promise<SiteSettings>;
+//# sourceMappingURL=site-json.d.ts.map

package/dist/site/site-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-json.d.ts","sourceRoot":"","sources":["../../src/site/site-json.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAIlD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQrE;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAEhF;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,YAAY,EACtB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIzB;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAE9F;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;CACxB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,YAAY,CAAC;CACjD,GAAG,OAAO,CAAC,YAAY,CAAC,CAUxB"}

package/dist/site/site-json.js

@@ -0,0 +1,69 @@
+import path from 'node:path';
+import { updateFileAtomically } from '../files/atomic.js';
+import { fileWith, storedValues } from '../settings/registry.js';
+import { isRecord } from '../util/guards.js';
+import { SITE_DATA_FILE } from '../theme/site-data.js';
+import { SITE } from './namespace.js';
+import { DEFAULT_SITE_SETTINGS } from './settings.js';
+const RETIRED_KEYS = ['navigation', 'soloAuthor'];
+export function parseSiteJson(source) {
+    let parsed;
+    try {
+        parsed = JSON.parse(source);
+    }
+    catch {
+        return {};
+    }
+    return isRecord(parsed) ? parsed : {};
+}
+/** The absolute path of one site's `content/_data/site.json`. */
+export function siteDataPath(contentDir) {
+    return path.join(contentDir, ...SITE_DATA_FILE.split('/'));
+}
+export function settingsFromSiteJson(file) {
+    return storedValues(SITE, file);
+}
+export function siteJsonFor(settings, existing = {}) {
+    const file = fileWith(SITE, settings, existing);
+    for (const key of RETIRED_KEYS)
+        delete file[key];
+    return file;
+}
+/** The bytes of one settings object, as the file holds them. */
+export function siteJsonText(settings, existing) {
+    return `${JSON.stringify(siteJsonFor(settings, existing), null, 2)}\n`;
+}
+/**
+ * Rewrite `content/_data/site.json` as these settings, keeping the keys they
+ * do not model.
+ *
+ * {@link updateSiteSettings} for a caller whose new settings depend on the old
+ * ones, which every screen's is: this is for the callers that have the whole
+ * object already, a test's set-up among them.
+ */
+export async function writeSiteJson(options) {
+    await updateSiteSettings({ contentDir: options.contentDir, change: () => options.settings });
+}
+/**
+ * Change the settings: re-read the file, apply the change, write it back, with
+ * nothing able to write that file in between ({@link updateFileAtomically}).
+ *
+ * The re-read is what makes the file win the way it wins for a post
+ * (decision-9). Two people with the settings screen open both save what they
+ * see, and the second save is applied to what the first one actually wrote
+ * rather than to what the second one had on screen — so a change to a field
+ * the second person did not touch survives. The write is a temporary file and
+ * a rename, so a reader — an Eleventy build, the site data source, another
+ * process entirely — never sees a half-written file. Keys the settings do not
+ * model, `feedSize` and anything a site added, are kept.
+ */
+export async function updateSiteSettings(options) {
+    let written = DEFAULT_SITE_SETTINGS;
+    await updateFileAtomically(siteDataPath(options.contentDir), (current) => {
+        const existing = parseSiteJson(current ?? '');
+        written = options.change(settingsFromSiteJson(existing));
+        return siteJsonText(written, existing);
+    });
+    return written;
+}
+//# sourceMappingURL=site-json.js.map

package/dist/site/site-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-json.js","sourceRoot":"","sources":["../../src/site/site-json.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAGtD,MAAM,YAAY,GAAG,CAAC,YAAY,EAAE,YAAY,CAAU,CAAC;AAE3D,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AACxC,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAA6B;IAChE,OAAO,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,QAAsB,EACtB,QAAQ,GAA4B,EAAE;IAEtC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,YAAY;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IACjD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,QAAsB,EAAE,QAAiC;IACpF,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AACzE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAGnC;IACC,MAAM,kBAAkB,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC/F,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAGxC;IACC,IAAI,OAAO,GAAG,qBAAqB,CAAC;IAEpC,MAAM,oBAAoB,CAAC,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE;QACvE,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC9C,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzD,OAAO,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}