@byline/core 3.10.1 → 3.11.1

package/dist/@types/db-types.d.ts

@@ -323,6 +323,43 @@ export interface IAuditQueries {
         page?: number;
         page_size?: number;
     }): Promise<AuditLogPage>;
+    /**
+     * The system-wide activity feed (docs/AUDIT.md — Workstream 4), newest
+     * first, paged and filterable. A read-time **union** of two disjoint event
+     * sources, normalised onto the `AuditLogEntry` shape:
+     *
+     * - the **version stream** (`byline_document_versions`) — content saves,
+     *   surfaced as `document.created` / `document.updated` (from `event_type`)
+     *   and attributed via Workstream 1's `created_by`; `field` / `before` /
+     *   `after` are null (no per-field diff is captured at save time);
+     * - the **audit log** (`byline_audit_log`) — everything the version stream
+     *   does not attribute: path / locale / status changes and deletions, plus
+     *   future admin-realm events (`document_id` NULL).
+     *
+     * The two sources never overlap (a delete mints no version; a status change
+     * mutates the version row in place), so the union double-counts nothing.
+     * Ordered by the normalised `occurredAt` (version `created_at` / audit
+     * `occurred_at`) — the per-source UUIDv7 ids are separate sequences and
+     * cannot order across the union.
+     *
+     * Unlike `getDocumentAuditLog`, this is **not** document- or
+     * collection-scoped and is gated system-wide by `admin.activity.read` at the
+     * transport layer — it does no scoping of its own.
+     */
+    findAuditLog(params: {
+        /** Restrict to one acting user (matches version `created_by` / audit `actor_id`). */
+        actorId?: string;
+        /** Restrict to one collection. */
+        collectionId?: string;
+        /** Exact action match, e.g. `document.updated` or `document.status.changed`. */
+        action?: string;
+        /** Inclusive lower bound on `occurredAt`. */
+        from?: Date;
+        /** Inclusive upper bound on `occurredAt`. */
+        to?: Date;
+        page?: number;
+        page_size?: number;
+    }): Promise<AuditLogPage>;
 }
 /**
  * Adapter capability for the shared-pool counter mechanism backing the

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { validateAdminConfigs } from './config/validate-admin-configs.js';
 export { RESERVED_FIELD_NAMES } from './config/validate-collections.js';
 export { type BylineCore, getBylineCore, initBylineCore } from './core.js';
 export * from './defaults/default-values.js';
-export { BylineError, ERR_DATABASE, ERR_NOT_FOUND, ERR_READ_BUDGET_EXCEEDED, ERR_STORAGE, ERR_UNHANDLED, ERR_VALIDATION, ErrorCodes, type ErrorReport, } from './lib/errors.js';
+export { BylineError, ERR_AUDIT_UNSUPPORTED, ERR_DATABASE, ERR_NOT_FOUND, ERR_READ_BUDGET_EXCEEDED, ERR_STORAGE, ERR_UNHANDLED, ERR_VALIDATION, ErrorCodes, type ErrorReport, } from './lib/errors.js';
 export { generateKeyBetween, generateNKeysBetween, validateOrderKey, } from './lib/fractional-index.js';
 export { type BylineLogger, getLogger } from './lib/logger.js';
 export { AsyncRegistry, type RegisteredServices, Registry } from './lib/registry.js';

package/dist/index.js

@@ -22,7 +22,7 @@ export { validateAdminConfigs } from './config/validate-admin-configs.js';
 export { RESERVED_FIELD_NAMES } from './config/validate-collections.js';
 export { getBylineCore, initBylineCore } from './core.js';
 export * from './defaults/default-values.js';
-export { BylineError, ERR_DATABASE, ERR_NOT_FOUND, ERR_READ_BUDGET_EXCEEDED, ERR_STORAGE, ERR_UNHANDLED, ERR_VALIDATION, ErrorCodes, } from './lib/errors.js';
+export { BylineError, ERR_AUDIT_UNSUPPORTED, ERR_DATABASE, ERR_NOT_FOUND, ERR_READ_BUDGET_EXCEEDED, ERR_STORAGE, ERR_UNHANDLED, ERR_VALIDATION, ErrorCodes, } from './lib/errors.js';
 export { generateKeyBetween, generateNKeysBetween, validateOrderKey, } from './lib/fractional-index.js';
 export { getLogger } from './lib/logger.js';
 export { AsyncRegistry, Registry } from './lib/registry.js';

package/package.json

@@ -2,7 +2,7 @@
   "name": "@byline/core",
   "private": false,
   "license": "MPL-2.0",
-  "version": "3.10.1",
+  "version": "3.11.1",
   "engines": {
     "node": ">=20.9.0"
   },
@@ -79,7 +79,7 @@
     "sharp": "^0.34.5",
     "uuid": "^14.0.0",
     "zod": "^4.4.3",
-    "@byline/auth": "3.10.1"
+    "@byline/auth": "3.11.1"
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.15",