@beechcms/core 0.4.0 → 0.4.2

package/dist/auth/password-reset-token.repository.d.ts

@@ -1,5 +1,4 @@
 export interface NewPasswordResetToken {
-    id: string;
     userId: string;
     tokenHash: string;
     expiresAt: number;

package/dist/auth/password-reset-token.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"password-reset-token.repository.d.ts","sourceRoot":"","sources":["../../src/auth/password-reset-token.repository.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtE,0FAA0F;IAC1F,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEpD;;;;OAIG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAA;IAEtG,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/D"}
+{"version":3,"file":"password-reset-token.repository.d.ts","sourceRoot":"","sources":["../../src/auth/password-reset-token.repository.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtE,0FAA0F;IAC1F,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEpD;;;;OAIG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAA;IAEtG,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/D"}

package/dist/automations-grammar-words.d.ts

@@ -0,0 +1,2 @@
+export declare const AUTOMATION_RESERVED_WORDS: Set<string>;
+//# sourceMappingURL=automations-grammar-words.d.ts.map

package/dist/automations-grammar-words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automations-grammar-words.d.ts","sourceRoot":"","sources":["../src/automations-grammar-words.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,aAKpC,CAAA"}

package/dist/automations-grammar-words.js

@@ -0,0 +1,6 @@
+export const AUTOMATION_RESERVED_WORDS = new Set([
+    'this', 'batch', 'all', 'firstone', 'lastone', 'byid', 'where',
+    'array',
+    'count', 'sum', 'avg', 'min', 'max', 'pluck',
+    'true', 'false', 'null',
+]);

package/dist/automations.repository.interface.d.ts

@@ -0,0 +1,19 @@
+import type { Automation, AutomationAction, AutomationTrigger, AutomationTriggerEvent, WhenNode } from './automations.types.js';
+export interface CreateAutomationInput {
+    seed_slug: string;
+    name: string;
+    triggers: AutomationTrigger[];
+    trigger_conditions: WhenNode | null;
+    actions: AutomationAction[];
+}
+export type UpdateAutomationInput = Partial<CreateAutomationInput>;
+export interface IAutomationRepository {
+    list(seedSlug: string): Promise<Automation[]>;
+    findById(id: string): Promise<Automation | null>;
+    create(input: CreateAutomationInput): Promise<string>;
+    update(id: string, input: UpdateAutomationInput): Promise<void>;
+    toggle(id: string, enabled: boolean): Promise<void>;
+    delete(id: string): Promise<void>;
+    findActive(seedSlug: string, event: AutomationTriggerEvent): Promise<Automation[]>;
+}
+//# sourceMappingURL=automations.repository.interface.d.ts.map

package/dist/automations.repository.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automations.repository.interface.d.ts","sourceRoot":"","sources":["../src/automations.repository.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAE/H,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,iBAAiB,EAAE,CAAA;IAC7B,kBAAkB,EAAE,QAAQ,GAAG,IAAI,CAAA;IACnC,OAAO,EAAE,gBAAgB,EAAE,CAAA;CAC5B;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;AAElE,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IAChD,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACrD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;CACnF"}

package/dist/automations.repository.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/automations.runner.interface.d.ts

@@ -0,0 +1,10 @@
+import type { AutomationTriggerEvent } from './automations.types.js';
+export interface AutomationEventPayload {
+    seedSlug: string;
+    event: AutomationTriggerEvent;
+    entry: Record<string, unknown>;
+}
+export interface IAutomationRunner {
+    run(payload: AutomationEventPayload): Promise<void>;
+}
+//# sourceMappingURL=automations.runner.interface.d.ts.map

package/dist/automations.runner.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automations.runner.interface.d.ts","sourceRoot":"","sources":["../src/automations.runner.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAEpE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,sBAAsB,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpD"}

package/dist/automations.runner.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/automations.runner.stub.d.ts

@@ -0,0 +1,5 @@
+import type { IAutomationRunner, AutomationEventPayload } from './automations.runner.interface.js';
+export declare class NoOpAutomationRunner implements IAutomationRunner {
+    run(_payload: AutomationEventPayload): Promise<void>;
+}
+//# sourceMappingURL=automations.runner.stub.d.ts.map

package/dist/automations.runner.stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automations.runner.stub.d.ts","sourceRoot":"","sources":["../src/automations.runner.stub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAA;AAElG,qBAAa,oBAAqB,YAAW,iBAAiB;IACtD,GAAG,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;CAG3D"}

package/dist/automations.runner.stub.js

@@ -0,0 +1,5 @@
+export class NoOpAutomationRunner {
+    async run(_payload) {
+        // intentionally empty
+    }
+}

package/dist/automations.types.d.ts

@@ -0,0 +1,73 @@
+export type AutomationTriggerEvent = 'create' | 'update' | 'delete' | 'cron';
+export interface AutomationTrigger {
+    event: AutomationTriggerEvent;
+    cron?: string | null;
+}
+export interface TriggerCondition {
+    field: string;
+    op: 'eq' | 'neq' | 'contains' | 'gt' | 'lt' | 'isempty' | 'isnotempty';
+    value: unknown;
+}
+export type WhenOperand = {
+    kind: 'literal';
+    value: unknown;
+} | {
+    kind: 'ref';
+    key: string;
+};
+export type WhenOp = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'startswith' | 'endswith' | 'in' | 'notin' | 'isempty' | 'isnotempty' | 'matches';
+export interface WhenPredicate {
+    kind: 'predicate';
+    left: WhenOperand;
+    op: WhenOp;
+    right?: WhenOperand;
+}
+export interface WhenGroup {
+    kind: 'group';
+    op: 'AND' | 'OR';
+    children: WhenNode[];
+    negate?: boolean;
+}
+export type WhenNode = WhenPredicate | WhenGroup;
+export interface SetVariableAction {
+    type: 'set_variable';
+    name: string;
+    seed_slug?: string;
+    fixed_id?: string;
+    column?: string;
+    filters?: TriggerCondition[];
+    order_by?: string;
+    order?: 'asc' | 'desc';
+}
+export type AutomationAction = {
+    type: 'webhook';
+    url: string;
+    method?: 'POST' | 'GET' | 'PUT';
+    headers?: Record<string, string>;
+    body_template?: string;
+} | {
+    type: 'send_mail';
+    to: string;
+    subject_template: string;
+    body_template: string;
+} | {
+    type: 'edit_field';
+    field: string;
+    value: unknown;
+} | {
+    type: 'create_entry';
+    seed_slug: string;
+    field_map: Record<string, string>;
+} | SetVariableAction;
+export interface Automation {
+    id: string;
+    seed_slug: string;
+    name: string;
+    enabled: boolean;
+    triggers: AutomationTrigger[];
+    trigger_conditions: WhenNode | null;
+    actions: AutomationAction[];
+    created_at: number;
+    updated_at: number;
+}
+//# sourceMappingURL=automations.types.d.ts.map

package/dist/automations.types.d.ts.map

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

package/dist/automations.types.js

@@ -0,0 +1 @@
+export {};

package/dist/clock.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Time abstraction. Hides direct calls to {@link Date.now} so callers can
+ * swap in deterministic clocks during tests without resorting to global
+ * timer mocks (e.g. vi.useFakeTimers, sinon, monkey-patching Date).
+ */
+export interface IClock {
+    /**
+     * Returns the current Unix timestamp in milliseconds.
+     * Equivalent to Date.now() in production.
+     * Overridable in tests for deterministic time-sensitive assertions.
+     */
+    now(): number;
+    /**
+     * Returns the current Unix timestamp in whole seconds.
+     * Equivalent to Math.floor(Date.now() / 1000) in production.
+     * Used by JWT issuance, session expiry, and analytics day-bucket computations.
+     */
+    nowSeconds(): number;
+}
+/**
+ * Production singleton. Delegates to the host runtime clock. Stateless and
+ * therefore safe to share across requests.
+ */
+export declare const SystemClock: IClock;
+//# sourceMappingURL=clock.d.ts.map

package/dist/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../src/clock.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,GAAG,IAAI,MAAM,CAAA;IAEb;;;;OAIG;IACH,UAAU,IAAI,MAAM,CAAA;CACrB;AAID;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAGzB,CAAA"}

package/dist/clock.js

@@ -0,0 +1,9 @@
+const MILLISECONDS_PER_SECOND = 1000;
+/**
+ * Production singleton. Delegates to the host runtime clock. Stateless and
+ * therefore safe to share across requests.
+ */
+export const SystemClock = {
+    now: () => Date.now(),
+    nowSeconds: () => Math.floor(Date.now() / MILLISECONDS_PER_SECOND),
+};

package/dist/content-scan.repository.d.ts

@@ -0,0 +1,9 @@
+import type { Seed } from './types.js';
+export interface IContentScanRepository {
+    /**
+     * Scans across all registered seeds to identify media keys that are currently referenced
+     * by any content entry. Used for orphaned media detection and storage analytics.
+     */
+    getReferencedMediaKeys(seeds: Seed[]): Promise<Set<string>>;
+}
+//# sourceMappingURL=content-scan.repository.d.ts.map

package/dist/content-scan.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-scan.repository.d.ts","sourceRoot":"","sources":["../src/content-scan.repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEtC,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,sBAAsB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;CAC5D"}

package/dist/content-scan.repository.js

@@ -0,0 +1 @@
+export {};

package/dist/engine.d.ts

@@ -1,47 +1,47 @@
 /**
  * Botanical Engine: Schema Compiler + Query Builder.
  *
- * In v0.4.0 ogni Seed ha una tabella SQL dedicata (`content_{slug}`) con colonne
- * reali tipizzate. Questo modulo genera il DDL e costruisce query parametrizzate.
- * Non conosce HTTP, auth o UI — è una libreria Node.js pura (C6).
+ * In v0.4.0 each Seed has a dedicated SQL table (`content_{slug}`) with
+ * real typed columns. This module generates the DDL and builds parameterized queries.
+ * It does not know about HTTP, auth, or UI — it's a pure TypeScript library.
  */
 import type { Seed, Branch, SelectOptions, ParameterizedQuery } from './types.js';
 /**
- * Genera `CREATE TABLE IF NOT EXISTS content_{slug}` con colonne di sistema
- * + una colonna per ogni Branch. Funzione pura: stesso Seed → stesso SQL.
+ * Generates `CREATE TABLE IF NOT EXISTS content_{slug}` with system columns
+ * + one column per Branch. Pure function: same Seed → same SQL.
  */
 export declare function generateCreateTable(seed: Seed): string;
 /**
- * Genera la tabella bozze `content_{slug}_drafts` per i Seed con `allowDrafts: true`.
- * Tutte le colonne branch sono nullable (le bozze sono parziali).
- * Ritorna null se il Seed non ha `allowDrafts: true`.
+ * Generates the drafts table `content_{slug}_drafts` for Seeds with `allowDrafts: true`.
+ * All branch columns are nullable (drafts are partial).
+ * Returns null if the Seed does not have `allowDrafts: true`.
  */
 export declare function generateDraftTable(seed: Seed): string | null;
 /**
- * Genera `ALTER TABLE content_{slug} ADD COLUMN {alias} {type}`.
- * Nuove colonne sono sempre nullable (limite SQLite su ALTER TABLE).
+ * Generates `ALTER TABLE content_{slug} ADD COLUMN {alias} {type}`.
+ * New columns are always nullable (SQLite limit on ALTER TABLE).
  */
 export declare function generateAddColumn(seed: Seed, branch: Branch): string;
 /**
- * Genera indici B-tree per status, created_at e ogni Branch filtrabile
- * con tipo indicizzabile (text, number, date, boolean).
+ * Generates B-tree indexes for status, created_at and every filterable Branch
+ * with an indexable type (text, number, date, boolean).
  */
 export declare function generateIndexes(seed: Seed): string[];
 /**
- * Genera la virtual table FTS5 per i Branch text/richtext indicizzabili.
- * Ritorna null se il Seed non ha branch con search abilitato.
+ * Generates the FTS5 virtual table for indexable text/richtext Branches.
+ * Returns null if the Seed has no branches with search enabled.
  */
 export declare function generateFtsTable(seed: Seed): string | null;
 /**
- * Genera i 3 trigger SQLite (insert/update/delete) che mantengono la FTS
- * sincronizzata automaticamente — elimina la necessità di syncFts manuale.
- * Ritorna array vuoto se il Seed non ha branch indicizzabili.
+ * Generates the 3 SQLite triggers (insert/update/delete) that keep the FTS
+ * automatically synchronized — eliminates the need for manual syncFts.
+ * Returns an empty array if the Seed has no indexable branches.
  */
 export declare function generateFtsTriggers(seed: Seed): string[];
 /**
- * Costruisce una SELECT parametrizzata su `content_{slug}`.
- * Non usa mai json_extract — ogni colonna è una colonna reale.
- * Colonne sconosciute nei filtri/orderBy vengono ignorate (fail-closed).
+ * Builds a parameterized SELECT on `content_{slug}`.
+ * Never uses json_extract — every column is a real column.
+ * Unknown columns in filters/orderBy are ignored (fail-closed).
  */
 export declare function buildSelectQuery(seed: Seed, options?: SelectOptions): ParameterizedQuery;
 export interface SchemaColumn {
@@ -51,17 +51,17 @@ export interface SchemaColumn {
     isPk: boolean;
 }
 /**
- * Ritorna la lista di colonne attese per la tabella di un Seed.
- * Usato da `beech seed:load --diff` per confrontare schema attuale vs atteso.
+ * Returns the list of expected columns for a Seed's table.
+ * Used by `beech seed:load --diff` to compare current vs expected schema.
  */
 export declare function getExpectedColumns(seed: Seed): SchemaColumn[];
 /**
- * Serializza un valore per la scrittura nel DB.
+ * Serializes a value for writing to the DB.
  * boolean → 0/1 | date → Unix timestamp | json/asset-list → JSON string
  */
 export declare function serializeForDb(branch: Branch, value: unknown): string | number | null;
 /**
- * Deserializza un valore letto dal DB per la risposta API.
+ * Deserializes a value read from the DB for the API response.
  * 0/1 → boolean | Unix timestamp → ISO 8601 | JSON string → object
  */
 export declare function deserializeFromDb(branch: Branch, value: unknown): unknown;

package/dist/engine.js

@@ -71,8 +71,8 @@ function normalizeAssetListValue(rawValue) {
 }
 // ---- DDL Generators ----
 /**
- * Genera `CREATE TABLE IF NOT EXISTS content_{slug}` con colonne di sistema
- * + una colonna per ogni Branch. Funzione pura: stesso Seed → stesso SQL.
+ * Generates `CREATE TABLE IF NOT EXISTS content_{slug}` with system columns
+ * + one column per Branch. Pure function: same Seed → same SQL.
  */
 export function generateCreateTable(seed) {
     const table = tableName(seed);
@@ -97,9 +97,9 @@ export function generateCreateTable(seed) {
     return lines.join('\n');
 }
 /**
- * Genera la tabella bozze `content_{slug}_drafts` per i Seed con `allowDrafts: true`.
- * Tutte le colonne branch sono nullable (le bozze sono parziali).
- * Ritorna null se il Seed non ha `allowDrafts: true`.
+ * Generates the drafts table `content_{slug}_drafts` for Seeds with `allowDrafts: true`.
+ * All branch columns are nullable (drafts are partial).
+ * Returns null if the Seed does not have `allowDrafts: true`.
  */
 export function generateDraftTable(seed) {
     if (!seed.allowDrafts)
@@ -114,7 +114,7 @@ export function generateDraftTable(seed) {
     for (const branch of seed.branches) {
         const { sqlType } = BRANCH_TYPE_SQL[branch.type];
         let col = `  ${branch.alias}  ${sqlType}`;
-        // boolean CHECK: in SQLite, NULL IN (0,1) → NULL, che passa il CHECK (solo FALSE lo fallisce)
+        // boolean CHECK: in SQLite, NULL IN (0,1) → NULL, which passes the CHECK (only FALSE fails it)
         if (branch.type === 'boolean')
             col += ` CHECK (${branch.alias} IN (0, 1))`;
         lines.push(col + ',');
@@ -124,16 +124,16 @@ export function generateDraftTable(seed) {
     return lines.join('\n');
 }
 /**
- * Genera `ALTER TABLE content_{slug} ADD COLUMN {alias} {type}`.
- * Nuove colonne sono sempre nullable (limite SQLite su ALTER TABLE).
+ * Generates `ALTER TABLE content_{slug} ADD COLUMN {alias} {type}`.
+ * New columns are always nullable (SQLite limit on ALTER TABLE).
  */
 export function generateAddColumn(seed, branch) {
     const { sqlType } = BRANCH_TYPE_SQL[branch.type];
     return `ALTER TABLE ${tableName(seed)} ADD COLUMN ${branch.alias} ${sqlType};`;
 }
 /**
- * Genera indici B-tree per status, created_at e ogni Branch filtrabile
- * con tipo indicizzabile (text, number, date, boolean).
+ * Generates B-tree indexes for status, created_at and every filterable Branch
+ * with an indexable type (text, number, date, boolean).
  */
 export function generateIndexes(seed) {
     const table = tableName(seed);
@@ -152,8 +152,8 @@ export function generateIndexes(seed) {
     return indexes;
 }
 /**
- * Genera la virtual table FTS5 per i Branch text/richtext indicizzabili.
- * Ritorna null se il Seed non ha branch con search abilitato.
+ * Generates the FTS5 virtual table for indexable text/richtext Branches.
+ * Returns null if the Seed has no branches with search enabled.
  */
 export function generateFtsTable(seed) {
     const rtBranches = indexableSearchBranches(seed);
@@ -170,9 +170,9 @@ export function generateFtsTable(seed) {
     ].join('\n');
 }
 /**
- * Genera i 3 trigger SQLite (insert/update/delete) che mantengono la FTS
- * sincronizzata automaticamente — elimina la necessità di syncFts manuale.
- * Ritorna array vuoto se il Seed non ha branch indicizzabili.
+ * Generates the 3 SQLite triggers (insert/update/delete) that keep the FTS
+ * automatically synchronized — eliminates the need for manual syncFts.
+ * Returns an empty array if the Seed has no indexable branches.
  */
 export function generateFtsTriggers(seed) {
     const rtBranches = indexableSearchBranches(seed);
@@ -208,9 +208,9 @@ export function generateFtsTriggers(seed) {
 }
 // ---- Query Builder ----
 /**
- * Costruisce una SELECT parametrizzata su `content_{slug}`.
- * Non usa mai json_extract — ogni colonna è una colonna reale.
- * Colonne sconosciute nei filtri/orderBy vengono ignorate (fail-closed).
+ * Builds a parameterized SELECT on `content_{slug}`.
+ * Never uses json_extract — every column is a real column.
+ * Unknown columns in filters/orderBy are ignored (fail-closed).
  */
 export function buildSelectQuery(seed, options = {}) {
     const table = tableName(seed);
@@ -369,8 +369,8 @@ function buildFilterCondition(col, type, cond, bindings) {
     return null;
 }
 /**
- * Ritorna la lista di colonne attese per la tabella di un Seed.
- * Usato da `beech seed:load --diff` per confrontare schema attuale vs atteso.
+ * Returns the list of expected columns for a Seed's table.
+ * Used by `beech seed:load --diff` to compare current vs expected schema.
  */
 export function getExpectedColumns(seed) {
     return [
@@ -389,7 +389,7 @@ export function getExpectedColumns(seed) {
 }
 // ---- Serialization / Deserialization ----
 /**
- * Serializza un valore per la scrittura nel DB.
+ * Serializes a value for writing to the DB.
  * boolean → 0/1 | date → Unix timestamp | json/asset-list → JSON string
  */
 export function serializeForDb(branch, value) {
@@ -427,7 +427,7 @@ export function serializeForDb(branch, value) {
     }
 }
 /**
- * Deserializza un valore letto dal DB per la risposta API.
+ * Deserializes a value read from the DB for the API response.
  * 0/1 → boolean | Unix timestamp → ISO 8601 | JSON string → object
  */
 export function deserializeFromDb(branch, value) {

package/dist/id-generator.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Identifier abstraction. Hides direct calls to {@link crypto.randomUUID}
+ * so callers can swap in deterministic generators during tests for stable
+ * snapshot assertions and predictable insert ordering.
+ */
+export interface IIdGenerator {
+    /**
+     * Generates a new universally unique identifier.
+     * Production implementation delegates to crypto.randomUUID().
+     * Test implementations return deterministic values for snapshot assertions.
+     */
+    uuid(): string;
+}
+/**
+ * Production singleton. Delegates to the host runtime CSPRNG-backed UUID
+ * generator. Stateless and therefore safe to share across requests.
+ */
+export declare const SystemIdGenerator: IIdGenerator;
+//# sourceMappingURL=id-generator.d.ts.map

package/dist/id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.d.ts","sourceRoot":"","sources":["../src/id-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,IAAI,IAAI,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,YAE/B,CAAA"}

package/dist/id-generator.js

@@ -0,0 +1,7 @@
+/**
+ * Production singleton. Delegates to the host runtime CSPRNG-backed UUID
+ * generator. Stateless and therefore safe to share across requests.
+ */
+export const SystemIdGenerator = {
+    uuid: () => crypto.randomUUID(),
+};

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 /**
  * @beechcms/core - Botanical Engine
  *
- * Pacchetto condiviso del monorepo Beech CMS.
- * In v0.4.0 il Botanical Engine è un compilatore di schema SQL: legge i Seed
- * TypeScript e genera DDL deterministico + query parametrizzate.
+ * Shared package of the Beech CMS monorepo.
+ * In v0.4.0 the Botanical Engine is a SQL schema compiler: it reads TypeScript
+ * Seeds and generates deterministic DDL + parameterized queries.
  *
  * @module @beechcms/core
  */
@@ -20,4 +20,28 @@ export * from './idempotency.repository.js';
 export * from './media.repository.js';
 export * from './storage.js';
 export * from './policies.js';
+export * from './auth/hash-provider.js';
+export * from './auth/token-service.js';
+export * from './auth/user.repository.js';
+export * from './auth/session.repository.js';
+export * from './auth/password-reset-token.repository.js';
+export * from './rate-limit/rate-limiter.js';
+export * from './observability/activity-logger.js';
+export * from './observability/activity-log.repository.js';
+export * from './observability/analytics.repository.js';
+export * from './notifications/notification.repository.js';
+export * from './notifications/notification-service.js';
+export * from './widget/widget.repository.js';
+export * from './search/search.repository.js';
+export * from './content-scan.repository.js';
+export * from './clock.js';
+export * from './id-generator.js';
+export * from './seed-registry.js';
+export * from './automations.types.js';
+export * from './automations-grammar-words.js';
+export * from './automations.runner.interface.js';
+export * from './automations.repository.interface.js';
+export * from './automations.runner.stub.js';
+export * from './scheduler.interface.js';
+export * from './scheduler.stub.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2CAA2C,CAAA;AACzD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oCAAoC,CAAA;AAClD,cAAc,4CAA4C,CAAA;AAC1D,cAAc,yCAAyC,CAAA;AACvD,cAAc,4CAA4C,CAAA;AAC1D,cAAc,yCAAyC,CAAA;AACvD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA;AACtC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,mCAAmC,CAAA;AACjD,cAAc,uCAAuC,CAAA;AACrD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,0BAA0B,CAAA;AACxC,cAAc,qBAAqB,CAAA"}

package/dist/index.js

@@ -1,9 +1,9 @@
 /**
  * @beechcms/core - Botanical Engine
  *
- * Pacchetto condiviso del monorepo Beech CMS.
- * In v0.4.0 il Botanical Engine è un compilatore di schema SQL: legge i Seed
- * TypeScript e genera DDL deterministico + query parametrizzate.
+ * Shared package of the Beech CMS monorepo.
+ * In v0.4.0 the Botanical Engine is a SQL schema compiler: it reads TypeScript
+ * Seeds and generates deterministic DDL + parameterized queries.
  *
  * @module @beechcms/core
  */
@@ -20,3 +20,27 @@ export * from './idempotency.repository.js';
 export * from './media.repository.js';
 export * from './storage.js';
 export * from './policies.js';
+export * from './auth/hash-provider.js';
+export * from './auth/token-service.js';
+export * from './auth/user.repository.js';
+export * from './auth/session.repository.js';
+export * from './auth/password-reset-token.repository.js';
+export * from './rate-limit/rate-limiter.js';
+export * from './observability/activity-logger.js';
+export * from './observability/activity-log.repository.js';
+export * from './observability/analytics.repository.js';
+export * from './notifications/notification.repository.js';
+export * from './notifications/notification-service.js';
+export * from './widget/widget.repository.js';
+export * from './search/search.repository.js';
+export * from './content-scan.repository.js';
+export * from './clock.js';
+export * from './id-generator.js';
+export * from './seed-registry.js';
+export * from './automations.types.js';
+export * from './automations-grammar-words.js';
+export * from './automations.runner.interface.js';
+export * from './automations.repository.interface.js';
+export * from './automations.runner.stub.js';
+export * from './scheduler.interface.js';
+export * from './scheduler.stub.js';

package/dist/notifications/notification-service.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Notification service contract.
+ *
+ * High-level port that callers use to emit a notification without knowing
+ * about the underlying repository, the database, or background scheduling.
+ * Mirrors the email module pattern: handlers depend on the service, the
+ * service depends on the repository, the repository depends on D1.
+ *
+ * @module @beechcms/core/notifications/notification-service
+ */
+import type { NotificationType } from './notification.repository.js';
+export interface CreateNotificationInput {
+    title: string;
+    message: string;
+    type?: NotificationType;
+}
+export interface INotificationService {
+    /**
+     * Emit a notification.
+     *
+     * Implementations decide whether to fire-and-forget (production: schedules
+     * the underlying repository write through `executionCtx.waitUntil`) or to
+     * wait inline (tests). Like the activity logger, this method MUST NOT
+     * throw to the caller: a failed notification must never break the public
+     * request that triggered it.
+     */
+    notify(input: CreateNotificationInput): Promise<void> | void;
+}
+//# sourceMappingURL=notification-service.d.ts.map

package/dist/notifications/notification-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-service.d.ts","sourceRoot":"","sources":["../../src/notifications/notification-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAEpE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,gBAAgB,CAAA;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC7D"}

package/dist/notifications/notification-service.js

@@ -0,0 +1 @@
+export {};