@beechcms/api 0.6.0-preview.1 → 0.6.0-preview.2

package/src/shared/execution-context-scheduler.ts

@@ -1,13 +1,13 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-import type { IScheduler } from '@beechcms/core'
-
-export class ExecutionContextScheduler implements IScheduler {
-  constructor(private readonly ctx: ExecutionContext) {}
-
-  waitUntil(promise: Promise<unknown>): void {
-    this.ctx.waitUntil(promise)
-  }
-}
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
+// See LICENSE in the repository root for license terms.
+
+import type { IScheduler } from '@beechcms/core'
+
+export class ExecutionContextScheduler implements IScheduler {
+  constructor(private readonly ctx: ExecutionContext) {}
+
+  waitUntil(promise: Promise<unknown>): void {
+    this.ctx.waitUntil(promise)
+  }
+}

package/src/shared/fixed-clock.ts

@@ -1,25 +1,25 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-import type { IClock } from '@beechcms/core'
-
-const MILLISECONDS_PER_SECOND = 1000
-
-/**
- * Test-only IClock implementation that returns a frozen timestamp on every
- * call. Lets specs assert exact values for `createdAt`, `iat`, and
- * day-bucket computations without resorting to vi.useFakeTimers or
- * patching the global Date constructor.
- */
-export class FixedClock implements IClock {
-  constructor(private readonly fixedNowMs: number) {}
-
-  now(): number {
-    return this.fixedNowMs
-  }
-
-  nowSeconds(): number {
-    return Math.floor(this.fixedNowMs / MILLISECONDS_PER_SECOND)
-  }
-}
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
+// See LICENSE in the repository root for license terms.
+
+import type { IClock } from '@beechcms/core'
+
+const MILLISECONDS_PER_SECOND = 1000
+
+/**
+ * Test-only IClock implementation that returns a frozen timestamp on every
+ * call. Lets specs assert exact values for `createdAt`, `iat`, and
+ * day-bucket computations without resorting to vi.useFakeTimers or
+ * patching the global Date constructor.
+ */
+export class FixedClock implements IClock {
+  constructor(private readonly fixedNowMs: number) {}
+
+  now(): number {
+    return this.fixedNowMs
+  }
+
+  nowSeconds(): number {
+    return Math.floor(this.fixedNowMs / MILLISECONDS_PER_SECOND)
+  }
+}

package/src/shared/fts-sync.ts

@@ -1,8 +1,8 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-// v0.4.0: FTS sync handled automatically by SQL triggers (generateFtsTriggers).
-// syncFts/deleteFts eliminated. This file kept as empty module to avoid import errors
-// during the Phase 4 → Phase 6 transition.
-export {}
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
+// See LICENSE in the repository root for license terms.
+
+// v0.4.0: FTS sync handled automatically by SQL triggers (generateFtsTriggers).
+// syncFts/deleteFts eliminated. This file kept as empty module to avoid import errors
+// during the Phase 4 → Phase 6 transition.
+export {}

package/src/shared/idempotency.repository.d1.test.ts

@@ -1,83 +1,83 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-import { describe, it, expect, vi } from 'vitest'
-import { D1IdempotencyRepository } from './idempotency.repository.d1'
-
-function makeMockDb(opts: { firstResult?: unknown } = {}) {
-  const { firstResult = null } = opts
-  const runMock = vi.fn().mockResolvedValue({ success: true })
-  const firstMock = vi.fn().mockResolvedValue(firstResult)
-  const bindMock = vi.fn(() => ({ run: runMock, first: firstMock }))
-  const prepareMock = vi.fn(() => ({ bind: bindMock }))
-  return { db: { prepare: prepareMock } as any, prepareMock, bindMock, runMock }
-}
-
-describe('D1IdempotencyRepository', () => {
-  describe('lookup', () => {
-    it('returns a mapped IdempotencyRecord when the key is found', async () => {
-      const row = {
-        idempotency_key: 'idem-1',
-        request_fingerprint: 'fp-abc',
-        response_status: 200,
-        response_body: '{"ok":true}',
-        expires_at: 9999,
-      }
-      const { db } = makeMockDb({ firstResult: row })
-      const result = await new D1IdempotencyRepository(db).lookup('idem-1')
-      expect(result).toEqual({
-        key: 'idem-1',
-        fingerprint: 'fp-abc',
-        responseStatus: 200,
-        responseBody: '{"ok":true}',
-        expiresAt: 9999,
-      })
-    })
-
-    it('returns null when the key is not found', async () => {
-      const { db } = makeMockDb({ firstResult: null })
-      expect(await new D1IdempotencyRepository(db).lookup('missing')).toBeNull()
-    })
-
-    it('queries the correct table', async () => {
-      const { db, prepareMock } = makeMockDb()
-      await new D1IdempotencyRepository(db).lookup('k')
-      expect(prepareMock).toHaveBeenCalledWith(expect.stringContaining('public_idempotency_keys'))
-    })
-  })
-
-  describe('store', () => {
-    it('calls INSERT INTO public_idempotency_keys with upsert on conflict', async () => {
-      const { db, prepareMock } = makeMockDb()
-      await new D1IdempotencyRepository(db).store({
-        key: 'idem-1', fingerprint: 'fp', responseStatus: 201, responseBody: '{}', expiresAt: 9999,
-      })
-      const sql = prepareMock.mock.calls[0][0] as string
-      expect(sql).toContain('INSERT INTO public_idempotency_keys')
-      expect(sql).toContain('ON CONFLICT')
-    })
-
-    it('binds key, fingerprint, status, body, and expiresAt', async () => {
-      const { db, bindMock } = makeMockDb()
-      await new D1IdempotencyRepository(db).store({
-        key: 'idem-1', fingerprint: 'fp-x', responseStatus: 200, responseBody: '{"ok":1}', expiresAt: 8888,
-      })
-      const args = bindMock.mock.calls[0] as unknown[]
-      expect(args).toContain('idem-1')
-      expect(args).toContain('fp-x')
-      expect(args).toContain(200)
-      expect(args).toContain('{"ok":1}')
-      expect(args).toContain(8888)
-    })
-  })
-
-  describe('cleanup', () => {
-    it('calls DELETE with the expiration timestamp', async () => {
-      const { db, prepareMock, bindMock } = makeMockDb()
-      await new D1IdempotencyRepository(db).cleanup(12345)
-      expect(prepareMock).toHaveBeenCalledWith(expect.stringContaining('DELETE FROM public_idempotency_keys'))
-      expect(bindMock).toHaveBeenCalledWith(12345)
-    })
-  })
-})
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
+// See LICENSE in the repository root for license terms.
+
+import { describe, it, expect, vi } from 'vitest'
+import { D1IdempotencyRepository } from './idempotency.repository.d1'
+
+function makeMockDb(opts: { firstResult?: unknown } = {}) {
+  const { firstResult = null } = opts
+  const runMock = vi.fn().mockResolvedValue({ success: true })
+  const firstMock = vi.fn().mockResolvedValue(firstResult)
+  const bindMock = vi.fn(() => ({ run: runMock, first: firstMock }))
+  const prepareMock = vi.fn(() => ({ bind: bindMock }))
+  return { db: { prepare: prepareMock } as any, prepareMock, bindMock, runMock }
+}
+
+describe('D1IdempotencyRepository', () => {
+  describe('lookup', () => {
+    it('returns a mapped IdempotencyRecord when the key is found', async () => {
+      const row = {
+        idempotency_key: 'idem-1',
+        request_fingerprint: 'fp-abc',
+        response_status: 200,
+        response_body: '{"ok":true}',
+        expires_at: 9999,
+      }
+      const { db } = makeMockDb({ firstResult: row })
+      const result = await new D1IdempotencyRepository(db).lookup('idem-1')
+      expect(result).toEqual({
+        key: 'idem-1',
+        fingerprint: 'fp-abc',
+        responseStatus: 200,
+        responseBody: '{"ok":true}',
+        expiresAt: 9999,
+      })
+    })
+
+    it('returns null when the key is not found', async () => {
+      const { db } = makeMockDb({ firstResult: null })
+      expect(await new D1IdempotencyRepository(db).lookup('missing')).toBeNull()
+    })
+
+    it('queries the correct table', async () => {
+      const { db, prepareMock } = makeMockDb()
+      await new D1IdempotencyRepository(db).lookup('k')
+      expect(prepareMock).toHaveBeenCalledWith(expect.stringContaining('public_idempotency_keys'))
+    })
+  })
+
+  describe('store', () => {
+    it('calls INSERT INTO public_idempotency_keys with upsert on conflict', async () => {
+      const { db, prepareMock } = makeMockDb()
+      await new D1IdempotencyRepository(db).store({
+        key: 'idem-1', fingerprint: 'fp', responseStatus: 201, responseBody: '{}', expiresAt: 9999,
+      })
+      const sql = prepareMock.mock.calls[0][0] as string
+      expect(sql).toContain('INSERT INTO public_idempotency_keys')
+      expect(sql).toContain('ON CONFLICT')
+    })
+
+    it('binds key, fingerprint, status, body, and expiresAt', async () => {
+      const { db, bindMock } = makeMockDb()
+      await new D1IdempotencyRepository(db).store({
+        key: 'idem-1', fingerprint: 'fp-x', responseStatus: 200, responseBody: '{"ok":1}', expiresAt: 8888,
+      })
+      const args = bindMock.mock.calls[0] as unknown[]
+      expect(args).toContain('idem-1')
+      expect(args).toContain('fp-x')
+      expect(args).toContain(200)
+      expect(args).toContain('{"ok":1}')
+      expect(args).toContain(8888)
+    })
+  })
+
+  describe('cleanup', () => {
+    it('calls DELETE with the expiration timestamp', async () => {
+      const { db, prepareMock, bindMock } = makeMockDb()
+      await new D1IdempotencyRepository(db).cleanup(12345)
+      expect(prepareMock).toHaveBeenCalledWith(expect.stringContaining('DELETE FROM public_idempotency_keys'))
+      expect(bindMock).toHaveBeenCalledWith(12345)
+    })
+  })
+})

package/src/shared/idempotency.repository.d1.ts

@@ -1,60 +1,60 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-import { IdempotencyRepository, IdempotencyRecord } from '@beechcms/core'
-import { BaseD1Repository } from './base.repository.d1.js'
-
-export class D1IdempotencyRepository extends BaseD1Repository implements IdempotencyRepository {
-  /**
-   * Looks up an idempotency record by its key.
-   */
-  async lookup(idempotencyKey: string): Promise<IdempotencyRecord | null> {
-    const idempotencyRecordResult = await this.database.prepare(
-      `SELECT idempotency_key, request_fingerprint, response_status, response_body, expires_at
-       FROM public_idempotency_keys WHERE idempotency_key = ? LIMIT 1`
-    ).bind(idempotencyKey).first<any>()
-
-    if (!idempotencyRecordResult) {
-      return null
-    }
-
-    return {
-      key: idempotencyRecordResult.idempotency_key,
-      fingerprint: idempotencyRecordResult.request_fingerprint,
-      responseStatus: idempotencyRecordResult.response_status,
-      responseBody: idempotencyRecordResult.response_body,
-      expiresAt: idempotencyRecordResult.expires_at
-    }
-  }
-
-  /**
-   * Stores or updates an idempotency record.
-   */
-  async store(idempotencyData: IdempotencyRecord): Promise<void> {
-    await this.database.prepare(
-      `INSERT INTO public_idempotency_keys (idempotency_key, request_fingerprint, response_status, response_body, created_at, expires_at)
-       VALUES (?, ?, ?, ?, ?, ?)
-       ON CONFLICT(idempotency_key) DO UPDATE SET
-         request_fingerprint = excluded.request_fingerprint,
-         response_status = excluded.response_status,
-         response_body = excluded.response_body,
-         created_at = excluded.created_at,
-         expires_at = excluded.expires_at`
-    ).bind(
-      idempotencyData.key, 
-      idempotencyData.fingerprint, 
-      idempotencyData.responseStatus, 
-      idempotencyData.responseBody, 
-      Math.floor(Date.now() / 1000), 
-      idempotencyData.expiresAt
-    ).run()
-  }
-
-  /**
-   * Cleans up expired idempotency records.
-   */
-  async cleanup(expirationTimestamp: number): Promise<void> {
-    await this.database.prepare(`DELETE FROM public_idempotency_keys WHERE expires_at < ?`).bind(expirationTimestamp).run()
-  }
-}
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
+// See LICENSE in the repository root for license terms.
+
+import { IdempotencyRepository, IdempotencyRecord } from '@beechcms/core'
+import { BaseD1Repository } from './base.repository.d1.js'
+
+export class D1IdempotencyRepository extends BaseD1Repository implements IdempotencyRepository {
+  /**
+   * Looks up an idempotency record by its key.
+   */
+  async lookup(idempotencyKey: string): Promise<IdempotencyRecord | null> {
+    const idempotencyRecordResult = await this.database.prepare(
+      `SELECT idempotency_key, request_fingerprint, response_status, response_body, expires_at
+       FROM public_idempotency_keys WHERE idempotency_key = ? LIMIT 1`
+    ).bind(idempotencyKey).first<any>()
+
+    if (!idempotencyRecordResult) {
+      return null
+    }
+
+    return {
+      key: idempotencyRecordResult.idempotency_key,
+      fingerprint: idempotencyRecordResult.request_fingerprint,
+      responseStatus: idempotencyRecordResult.response_status,
+      responseBody: idempotencyRecordResult.response_body,
+      expiresAt: idempotencyRecordResult.expires_at
+    }
+  }
+
+  /**
+   * Stores or updates an idempotency record.
+   */
+  async store(idempotencyData: IdempotencyRecord): Promise<void> {
+    await this.database.prepare(
+      `INSERT INTO public_idempotency_keys (idempotency_key, request_fingerprint, response_status, response_body, created_at, expires_at)
+       VALUES (?, ?, ?, ?, ?, ?)
+       ON CONFLICT(idempotency_key) DO UPDATE SET
+         request_fingerprint = excluded.request_fingerprint,
+         response_status = excluded.response_status,
+         response_body = excluded.response_body,
+         created_at = excluded.created_at,
+         expires_at = excluded.expires_at`
+    ).bind(
+      idempotencyData.key, 
+      idempotencyData.fingerprint, 
+      idempotencyData.responseStatus, 
+      idempotencyData.responseBody, 
+      Math.floor(Date.now() / 1000), 
+      idempotencyData.expiresAt
+    ).run()
+  }
+
+  /**
+   * Cleans up expired idempotency records.
+   */
+  async cleanup(expirationTimestamp: number): Promise<void> {
+    await this.database.prepare(`DELETE FROM public_idempotency_keys WHERE expires_at < ?`).bind(expirationTimestamp).run()
+  }
+}

package/src/shared/in-memory-activity-logger.ts

@@ -1,19 +1,19 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-import type { IActivityLogger, ActivityLogEntry } from '@beechcms/core'
-
-/**
- * Test double for {@link IActivityLogger}.
- *
- * Captures every call into a public array so test assertions can verify
- * audit-trail side effects without touching D1. Preserves insertion order.
- */
-export class InMemoryActivityLogger implements IActivityLogger {
-  public readonly entries: ActivityLogEntry[] = []
-
-  log(entry: ActivityLogEntry): void {
-    this.entries.push(entry)
-  }
-}
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
+// See LICENSE in the repository root for license terms.
+
+import type { IActivityLogger, ActivityLogEntry } from '@beechcms/core'
+
+/**
+ * Test double for {@link IActivityLogger}.
+ *
+ * Captures every call into a public array so test assertions can verify
+ * audit-trail side effects without touching D1. Preserves insertion order.
+ */
+export class InMemoryActivityLogger implements IActivityLogger {
+  public readonly entries: ActivityLogEntry[] = []
+
+  log(entry: ActivityLogEntry): void {
+    this.entries.push(entry)
+  }
+}

package/src/shared/in-memory-notification-service.ts

@@ -1,19 +1,19 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-import type { INotificationService, CreateNotificationInput } from '@beechcms/core'
-
-/**
- * Test double for {@link INotificationService}.
- *
- * Captures every call into a public array so tests can assert what would have
- * been delivered without touching D1.
- */
-export class InMemoryNotificationService implements INotificationService {
-  public readonly receivedNotifications: CreateNotificationInput[] = []
-
-  notify(input: CreateNotificationInput): void {
-    this.receivedNotifications.push(input)
-  }
-}
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
+// See LICENSE in the repository root for license terms.
+
+import type { INotificationService, CreateNotificationInput } from '@beechcms/core'
+
+/**
+ * Test double for {@link INotificationService}.
+ *
+ * Captures every call into a public array so tests can assert what would have
+ * been delivered without touching D1.
+ */
+export class InMemoryNotificationService implements INotificationService {
+  public readonly receivedNotifications: CreateNotificationInput[] = []
+
+  notify(input: CreateNotificationInput): void {
+    this.receivedNotifications.push(input)
+  }
+}

package/src/shared/in-memory-seed.repository.ts

@@ -1,51 +1,58 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-import type { ISeedRepository, Seed, SeedRecord } from '@beechcms/core'
-
-/**
- * In-memory ISeedRepository for testing and for the config.seeds back-compat shim.
- * Returns a fixed seed list with a static version token.
- */
-export class InMemorySeedRepository implements ISeedRepository {
-  private readonly seeds: Seed[]
-  private version = 1
-
-  constructor(seeds: Seed[]) {
-    this.seeds = seeds.filter(s => s && typeof s === 'object' && 'slug' in s)
-  }
-
-  async listActive(): Promise<Seed[]> {
-    return this.seeds
-  }
-
-  async listAll(): Promise<SeedRecord[]> {
-    return this.seeds.map(s => ({
-      slug: s.slug,
-      definition: s,
-      status: 'active' as const,
-      source: 'code' as const,
-      createdAt: 0,
-      updatedAt: 0,
-    }))
-  }
-
-  async get(slug: string): Promise<SeedRecord | null> {
-    const s = this.seeds.find(s => s.slug === slug)
-    if (!s) return null
-    return { slug: s.slug, definition: s, status: 'active', source: 'code', createdAt: 0, updatedAt: 0 }
-  }
-
-  async upsert(): Promise<void> {}
-  async softDelete(): Promise<void> {}
-  async hardDelete(): Promise<void> {}
-
-  async getRegistryVersion(): Promise<number> {
-    return this.version
-  }
-
-  async bumpRegistryVersion(): Promise<number> {
-    return ++this.version
-  }
-}
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
+// See LICENSE in the repository root for license terms.
+
+import type { ISeedRepository, Seed, SeedRecord } from '@beechcms/core'
+
+/**
+ * In-memory ISeedRepository for testing and for the config.seeds back-compat shim.
+ * Returns a fixed seed list with a static version token.
+ */
+export class InMemorySeedRepository implements ISeedRepository {
+  private readonly seeds: Seed[]
+  private version = 1
+
+  constructor(seeds: Seed[]) {
+    this.seeds = seeds.filter(s => s && typeof s === 'object' && 'slug' in s)
+  }
+
+  async listActive(): Promise<Seed[]> {
+    return this.seeds
+  }
+
+  async listAll(): Promise<SeedRecord[]> {
+    return this.seeds.map(s => ({
+      slug: s.slug,
+      definition: s,
+      status: 'active' as const,
+      source: 'code' as const,
+      createdAt: 0,
+      updatedAt: 0,
+    }))
+  }
+
+  async get(slug: string): Promise<SeedRecord | null> {
+    const s = this.seeds.find(s => s.slug === slug)
+    if (!s) return null
+    return { slug: s.slug, definition: s, status: 'active', source: 'code', createdAt: 0, updatedAt: 0 }
+  }
+  upsert(_slug: string, _definition: Seed, _source?: 'code' | 'runtime'): Promise<void> {
+    return Promise.resolve()
+  }
+
+  softDelete(_slug: string): Promise<void> {
+    return Promise.resolve()
+  }
+
+  hardDelete(_slug: string): Promise<void> {
+    return Promise.resolve()
+  }
+
+  async getRegistryVersion(): Promise<number> {
+    return this.version
+  }
+
+  async bumpRegistryVersion(): Promise<number> {
+    return ++this.version
+  }
+}