@cratis/chronicle 6.40.0 → 6.41.1

package/testing/singleAppendRoute.spec.ts

@@ -0,0 +1,19 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { chai, describe, it } from 'vitest';
+import { singleAppendRoute } from './singleAppendRoute.js';
+
+chai.should();
+
+describe('when single-append routing rejects unsupported options', () => {
+    it('should list only routing options when subject is not allowed', () => {
+        (() => singleAppendRoute({ subject: 'person-a' }, 'SeededEvent'))
+            .should.throw('Only sourceType, streamType, streamId options are supported for single append.');
+    });
+
+    it('should include subject in the allowed options for single append', () => {
+        (() => singleAppendRoute({ tags: [] }, 'AppendedEvent', undefined, true))
+            .should.throw('Only sourceType, streamType, streamId, subject options are supported for single append.');
+    });
+});

package/testing/singleAppendRoute.ts

@@ -0,0 +1,33 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import type { AppendOptions } from '../eventSequences/AppendOptions.js';
+import { UnsupportedEventSequenceOperation } from './UnsupportedEventSequenceOperation.js';
+
+/** The fixture-proven single-append route boundary, shared with read-model setup. */
+export function singleAppendRoute(options: AppendOptions | undefined, artifact: string,
+    unsupported = (operation: string, artifact: string, reason: string) => new UnsupportedEventSequenceOperation(operation, artifact, reason),
+    allowSubject = false
+): { sourceType: string; streamType: string; streamId: string } {
+    if (options !== undefined && (!options || typeof options !== 'object' || Array.isArray(options))) {
+        throw unsupported('append.options', artifact, 'Append options must be an object.');
+    }
+    const allowed = ['sourceType', 'streamType', 'streamId', ...(allowSubject ? ['subject'] : [])];
+    if (options && (Reflect.ownKeys(options).some(key => !allowed.includes(String(key))) ||
+        options.correlationId !== undefined || (!allowSubject && options.subject !== undefined) || options.occurred !== undefined ||
+        options.eventSourceId !== undefined || options.concurrencyScope !== undefined || options.tags !== undefined ||
+        options.concurrencyScopes !== undefined)) {
+        throw unsupported('append.options', artifact, `Only ${allowed.join(', ')} options are supported for single append.`);
+    }
+    if (options?.subject !== undefined && options.subject !== null && typeof options.subject !== 'string') {
+        throw unsupported('append.subject', artifact, 'Subject must be a string.');
+    }
+    const route = { sourceType: options?.sourceType, streamType: options?.streamType, streamId: options?.streamId };
+    for (const [name, value] of Object.entries(route)) {
+        if (value !== undefined && (typeof value !== 'string' || !/^[A-Za-z0-9_-]*$/.test(value))) {
+            throw unsupported(`append.${name}`, String(value), 'Only simple routing identifiers or empty defaults are fixture-backed.');
+        }
+    }
+    // ts-proto omits empty strings; the append pipeline resolves omissions to these exact values.
+    return { sourceType: route.sourceType || 'Default', streamType: route.streamType || 'All', streamId: route.streamId || 'Default' };
+}