refactor(breg): call domain occurrences event records

Readers found "occurrence" unclear for records that state something happened.
Nothing using the old name has been released, so it is renamed outright.

Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>

Author: jeremi

crates/CLIENTS.md

@@ -67,12 +67,12 @@ or unify distinct authority contracts. Shared HTTP/token primitives live in
   permissions in a binding. Validate a mutation before token acquisition or
   I/O; never generate its idempotency key, and resend it only through the
   bounded same-key retry. Record ETags and lifecycle-action ETags are distinct.
-- The BReg occurrence view (`id.registrystack.org/formats/breg/occurrence-view/v1alpha1`)
+- The BReg event record view (`id.registrystack.org/formats/breg/event-record-view/v1alpha1`)
   is a pure, read-only projection of one record revision, built from the
-  caller-filtered occurrence descriptor in Registry Metadata, the record, and
+  caller-filtered event record descriptor in Registry Metadata, the record, and
   evidence the caller supplies. It reads no clock and performs no exchange.
   Recorded time comes only from the creation revision of that record, which
-  `occurrence_creation_revision` reads as exactly revision 1 and reports as
+  `event_record_creation_revision` reads as exactly revision 1 and reports as
   absent only for a 403 or 404 answer, which means the caller cannot see that
   revision; every other status is returned as an error. Its compact
   `{recordType, recordId, revision, createdAt}` form retains the response's
@@ -82,11 +82,11 @@ or unify distinct authority contracts. Shared HTTP/token primitives live in
   uppercase `T` and `Z` and the offset the
   registry served (it serves stored timestamps in UTC with `+00:00`); dates stay
   dates. The Rust projection is the single implementation:
-  the Node and Python exports (`occurrenceView`, `occurrence_view`, and the
-  metadata `occurrenceDescriptor` or `occurrence_descriptor` accessor) pass
+  the Node and Python exports (`eventRecordView`, `event_record_view`, and the
+  metadata `eventRecordDescriptor` or `event_record_descriptor` accessor) pass
   JSON through it unchanged and add no semantics. The view shape, its status
-  words and its error codes are documented in `products/breg/occurrences.md`
-  and published as `products/breg/contracts/occurrence-view/OccurrenceView.schema.json`.
+  words and its error codes are documented in `products/breg/event-records.md`
+  and published as `products/breg/contracts/event-record-view/EventRecordView.schema.json`.
 - Messaging submissions take a caller-chosen idempotency key; a binding never
   generates one. Only the Rust client's bounded same-key retry resends a
   submission, and a cancellation is never resent. Message, template,

…nt-node/__test__/occurrence-view.test.js …-node/__test__/event-record-view.test.jscrates/registry-breg-client-node/__test__/occurrence-view.test.js renamed to crates/registry-breg-client-node/__test__/event-record-view.test.js crates/registry-breg-client-node/__test__/occurrence-view.test.js renamed to crates/registry-breg-client-node/__test__/event-record-view.test.js

@@ -6,10 +6,10 @@ const path = require('node:path');
 const { test } = require('node:test');
 const pkg = process.env.BREG_CLIENT_PACKAGE
   ? require(process.env.BREG_CLIENT_PACKAGE).breg : require('..');
-const { BaseRegistryClient, occurrenceView } = pkg;
+const { BaseRegistryClient, eventRecordView } = pkg;
 
 const fixtures = path.join(
-  __dirname, '..', '..', 'registry-breg-client', 'tests', 'fixtures', 'occurrence-view',
+  __dirname, '..', '..', 'registry-breg-client', 'tests', 'fixtures', 'event-record-view',
 );
 const read = (name) => fs.readFileSync(path.join(fixtures, name), 'utf8');
 
@@ -19,31 +19,31 @@ const recordId = '6f1e0c62-0000-4000-8000-000000000001';
 const hiddenId = '6f1e0c62-0000-4000-8000-000000000404';
 const link = '<https://id.registrystack.org/profiles/registry-record/v1>; rel="profile", </v1/schemas/incorporation>; rel="describedby"';
 
-test('occurrenceView projects every generated fixture to its recorded view', () => {
+test('eventRecordView projects every generated fixture to its recorded view', () => {
   for (const name of [
     'incorporation', 'suspension-decision', 'suspension-correction', 'ownership-transfer',
   ]) {
-    const view = occurrenceView(read(`${name}.input.json`));
+    const view = eventRecordView(read(`${name}.input.json`));
     assert.equal(typeof view, 'string');
     assert.deepEqual(JSON.parse(view), JSON.parse(read(`${name}.json`)), name);
   }
 });
 
-test('occurrenceView raises a described occurrence failure', () => {
+test('eventRecordView raises a described event record failure', () => {
   const input = JSON.parse(read('incorporation.input.json'));
   input.descriptor.descriptorVersion = 2;
-  assert.throws(() => occurrenceView(JSON.stringify(input)), (error) => {
-    assert.equal(error.kind, 'occurrence');
+  assert.throws(() => eventRecordView(JSON.stringify(input)), (error) => {
+    assert.equal(error.kind, 'event-record');
     assert.equal(error.code, 'unsupported-version');
     assert.equal(error.outcomeUnknown, false);
     return true;
   });
-  assert.throws(() => occurrenceView('{"unknown":true}'), (error) => {
-    assert.equal(error.kind, 'occurrence');
+  assert.throws(() => eventRecordView('{"unknown":true}'), (error) => {
+    assert.equal(error.kind, 'event-record');
     assert.equal(error.code, 'invalid-input');
     return true;
   });
-  assert.throws(() => occurrenceView({}), (error) => error.kind === 'invalid-request');
+  assert.throws(() => eventRecordView({}), (error) => error.kind === 'invalid-request');
 });
 
 test('the metadata accessor and the creation-revision read follow the declared contract', async () => {
@@ -54,7 +54,7 @@ test('the metadata accessor and the creation-revision read follow the declared c
       {
         id: 'incorporation', datasetIdentifier: 'register', route: 'incorporations',
         operations: [], readableFields: [], schema: '/v1/schemas/incorporation',
-        occurrence: input.descriptor,
+        eventRecord: input.descriptor,
       },
       {
         id: 'note', datasetIdentifier: 'register', route: 'notes', operations: [],
@@ -105,32 +105,32 @@ test('the metadata accessor and the creation-revision read follow the declared c
   try {
     const client = new BaseRegistryClient({ baseUrl: `http://127.0.0.1:${server.address().port}` });
     const contract = await client.registryContract();
-    const descriptor = JSON.parse(contract.occurrenceDescriptor('incorporation'));
+    const descriptor = JSON.parse(contract.eventRecordDescriptor('incorporation'));
     assert.equal(descriptor.descriptorVersion, 1);
     assert.equal(descriptor.label, 'Incorporation');
     for (const absent of ['note', 'unknown-type']) {
-      assert.throws(() => contract.occurrenceDescriptor(absent), (error) => {
-        assert.equal(error.kind, 'occurrence');
-        assert.equal(error.code, 'not-an-occurrence');
+      assert.throws(() => contract.eventRecordDescriptor(absent), (error) => {
+        assert.equal(error.kind, 'event-record');
+        assert.equal(error.code, 'not-an-event-record');
         return true;
       });
     }
 
-    const text = await client.occurrenceCreationRevision('incorporations', recordId);
+    const text = await client.eventRecordCreationRevision('incorporations', recordId);
     assert.deepEqual(JSON.parse(text), {
       recordType: 'incorporation', recordId, revision: '1',
       createdAt: '2026-10-26T08:15:30.123456Z',
     });
     assert.ok(requests.some((url) => url.includes(`/incorporations/${recordId}/revisions/1`)));
-    assert.equal(await client.occurrenceCreationRevision('incorporations', hiddenId), null);
+    assert.equal(await client.eventRecordCreationRevision('incorporations', hiddenId), null);
     input.creationRevision = JSON.parse(text);
     assert.deepEqual(
-      JSON.parse(occurrenceView(JSON.stringify(input))).recordedAt,
+      JSON.parse(eventRecordView(JSON.stringify(input))).recordedAt,
       { status: 'available', type: 'instant', value: '2026-10-26T08:15:30.123456Z' },
     );
     input.creationRevision.recordType = 'ownership-transfer';
-    assert.throws(() => occurrenceView(JSON.stringify(input)), (error) => {
-      assert.equal(error.kind, 'occurrence');
+    assert.throws(() => eventRecordView(JSON.stringify(input)), (error) => {
+      assert.equal(error.kind, 'event-record');
       assert.equal(error.code, 'wrong-record-evidence');
       assert.doesNotMatch(error.message, /ownership-transfer/);
       return true;

crates/registry-breg-client-node/client.d.ts

@@ -47,15 +47,15 @@ export interface VerifiedHookDelivery {
 export declare function verifyHookDelivery(input: HookDeliveryInput): VerifiedHookDelivery
 
 /**
- * Project one record revision into the occurrence view. `argumentsJson` is a
+ * Project one record revision into the event record view. `argumentsJson` is a
  * JSON object with `registryRevision`, `recordType`, `descriptor`, `record`
  * and optional `creationRevision`, `actionReceipts` and
  * `proposalApplications`. The result is the view document as JSON text.
- * Failures carry kind `occurrence` and one of the codes `not-an-occurrence`,
+ * Failures carry kind `event-record` and one of the codes `not-an-event-record`,
  * `unsupported-version`, `malformed-descriptor`, `wrong-record-evidence`,
  * `revision-mismatch`, `incompatible-metadata` or `invalid-input`.
  */
-export declare function occurrenceView(argumentsJson: string): string
+export declare function eventRecordView(argumentsJson: string): string
 
 export interface PrivateJwk {
   readonly kty: string
@@ -807,8 +807,8 @@ export declare class BRegMetadata {
   selectAction(actionIdentifier: string, expectedProfile: string): BRegActionBinding
   selectTombstone(recordTypeIdentifier: string, expectedProfile: string): BRegTombstoneBinding
   selectBatch(recordTypeIdentifier: string, expectedProfile: string): BRegBatchBinding
-  /** The occurrence descriptor declared for a record type, as JSON text. */
-  occurrenceDescriptor(recordType: string): string
+  /** The event record descriptor declared for a record type, as JSON text. */
+  eventRecordDescriptor(recordType: string): string
 }
 
 /** Bounded declared identifiers; absent when any referenced field is unreadable. */
@@ -900,7 +900,7 @@ export declare class BaseRegistryClient {
    * `{recordType, recordId, revision, createdAt}` JSON text, or null when the
    * caller may not read it (403 or 404).
    */
-  occurrenceCreationRevision(entityRoute: string, recordIdentifier: string, accessProfile?: string | null): Promise<string | null>
+  eventRecordCreationRevision(entityRoute: string, recordIdentifier: string, accessProfile?: string | null): Promise<string | null>
   statisticsLive(dataset: string, from?: string | null, to?: string | null, accessProfile?: string | null, format?: StatisticsFormat | null): Promise<RawOutcome>
   statisticsReleases(dataset: string, top?: SafeInteger | null, skipToken?: string | null, accessProfile?: string | null): Promise<RawOutcome>
   statisticsLatestRelease(dataset: string, period: string, selection: StatisticsReleaseSelection, accessProfile?: string | null, format?: StatisticsFormat | null): Promise<RawOutcome>

crates/registry-breg-client-node/client.js

@@ -119,10 +119,10 @@ function verifyHookDelivery(value) {
   }
 }
 
-function occurrenceView(argumentsJson) {
+function eventRecordView(argumentsJson) {
   try {
     if (typeof argumentsJson !== 'string') throw inputError('invalid-request');
-    return native.occurrenceView(argumentsJson);
+    return native.eventRecordView(argumentsJson);
   } catch (error) {
     throw normalize(error, 'invalid-request');
   }
@@ -220,7 +220,7 @@ for (const [method, jsonIndexes, requiredIndexes] of [
   ['statisticsLive'], ['statisticsReleases'], ['statisticsLatestRelease'],
   ['statisticsReleaseVersion'], ['statisticsReleaseSeries'], ['statisticsPublish'],
   ['statisticsWithdraw'],
-  ['recordRevisions'], ['getRecordRevision', [3]], ['occurrenceCreationRevision'],
+  ['recordRevisions'], ['getRecordRevision', [3]], ['eventRecordCreationRevision'],
   ['getRecord', [2]], ['listRecords', [1]], ['continueList', [0], [0]],
   ['getGeoJsonRecord', [2]], ['listGeoJsonRecords', [1]], ['continueGeoJsonList', [0], [0]],
   ['listCurrentRecords', [1]], ['continueCurrentList', [0], [0]],
@@ -307,7 +307,7 @@ const BRegPreparedProposal = preparedClass(native.BRegPreparedProposal, 'BRegPre
 for (const name of [
   'selectCreate', 'selectPatch',
   'selectAction', 'selectTombstone', 'selectBatch', 'selectProposals', 'selectProposalGet',
-  'selectProposalReviewContext', 'selectProposalReviewStatus', 'occurrenceDescriptor',
+  'selectProposalReviewContext', 'selectProposalReviewStatus', 'eventRecordDescriptor',
 ]) {
   const original = native.BRegMetadata.prototype[name];
   native.BRegMetadata.prototype[name] = function (...args) {
@@ -383,7 +383,7 @@ class PrivateKeyJwt {
 
 module.exports = {
   verifyHookDelivery,
-  occurrenceView,
+  eventRecordView,
   PrivateKeyJwt,
   BaseRegistryClient,
   BaseRegistryClientError,

crates/registry-breg-client-node/index.d.ts

@@ -33,7 +33,7 @@ export declare class BaseRegistryClient {
    * `{recordType, recordId, revision, createdAt}` JSON, or null when the
    * caller may not read it.
    */
-  occurrenceCreationRevision(entityRoute: string, recordIdentifier: string, accessProfile?: string | undefined | null): Promise<string | null>
+  eventRecordCreationRevision(entityRoute: string, recordIdentifier: string, accessProfile?: string | undefined | null): Promise<string | null>
   getRecord(entityRoute: string, recordIdentifier: string, options?: any | undefined | null): Promise<CompleteOutcome>
   listRecords(entityRoute: string, options?: any | undefined | null): Promise<PageOutcome>
   continueList(value: any): Promise<PageOutcome>
@@ -221,8 +221,8 @@ export declare class BRegIngestionPrefixDigest {
 export type IngestionPrefixDigest = BRegIngestionPrefixDigest
 
 export declare class BRegMetadata {
-  /** The occurrence descriptor declared for one record type, as JSON text. */
-  occurrenceDescriptor(recordType: string): string
+  /** The event record descriptor declared for one record type, as JSON text. */
+  eventRecordDescriptor(recordType: string): string
   /** Read-only capability inventory for each exact Action/profile pair. */
   get proposalActions(): any
   /** Caller-filtered inert descriptors. Selectors below remain the only authority constructors. */
@@ -344,6 +344,13 @@ export interface CompleteOutcome {
  */
 export declare function encodeIngestionChunk(chunkIndex: number, items: any, prefixDigest: string): BRegIngestionChunk
 
+/**
+ * Project one record revision into the event record view. The input is the
+ * JSON arguments document of the Rust projection; the result is the view
+ * document as JSON text.
+ */
+export declare function eventRecordView(argumentsJson: string): string
+
 /** Exact BReg hook request supplied by a receiver. */
 export interface HookDeliveryInput {
   method: string
@@ -365,13 +372,6 @@ export interface JsonOutcome {
   validAt?: string
 }
 
-/**
- * Project one record revision into the occurrence view. The input is the
- * JSON arguments document of the Rust projection; the result is the view
- * document as JSON text.
- */
-export declare function occurrenceView(argumentsJson: string): string
-
 export interface PageOutcome {
   kind: string
   value: any

crates/registry-breg-client-node/index.js

@@ -818,5 +818,5 @@ module.exports.TombstoneBinding = nativeBinding.TombstoneBinding
 module.exports.PrivateKeyJwt = nativeBinding.PrivateKeyJwt
 module.exports.PrivateKeyJwtBinding = nativeBinding.PrivateKeyJwtBinding
 module.exports.encodeIngestionChunk = nativeBinding.encodeIngestionChunk
-module.exports.occurrenceView = nativeBinding.occurrenceView
+module.exports.eventRecordView = nativeBinding.eventRecordView
 module.exports.verifyHookDelivery = nativeBinding.verifyHookDelivery