@sekiban/dcb-core 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -121,25 +121,24 @@ export interface AppendedEvent {
     readonly payload: JsonValue;
     readonly tags: readonly TagDefinition[];
 }
-export interface CommandContext<TState extends JsonValue = JsonValue> {
+export interface CommandContext {
     readonly state: <T extends JsonValue = JsonValue>(tag: TagInput) => T | undefined;
     readonly assertEmpty: (tag: TagInput) => void;
     readonly append: (event: EventDefinition, payload: unknown, tags?: readonly TagInput[]) => AppendedEvent;
-    readonly done: (value?: JsonValue) => CommandDone<TState>;
+    readonly done: (value?: JsonValue) => CommandDone;
     readonly noop: (reason?: string) => Omit<CommandNoop, "events">;
     readonly reject: (reason: string, code?: string) => Omit<CommandRejected, "events">;
     readonly appendedEvents: readonly AppendedEvent[];
 }
-export interface CommandCommitted<TState extends JsonValue = JsonValue> {
+/** `done` commits the appended candidates with an optional value; it carries no state. */
+export interface CommandCommitted {
     readonly kind: "committed";
     readonly value?: JsonValue;
-    readonly state?: TState;
     readonly events: readonly AppendedEvent[];
 }
-export interface CommandDone<TState extends JsonValue = JsonValue> {
+export interface CommandDone {
     readonly kind: "committed";
     readonly value?: JsonValue;
-    readonly state?: TState;
 }
 export interface CommandNoop {
     readonly kind: "noop";
@@ -152,31 +151,31 @@ export interface CommandRejected {
     readonly code: string;
     readonly events: readonly [];
 }
-export type CommandHandlerOutcome<TState extends JsonValue = JsonValue> = CommandDone<TState> | Omit<CommandNoop, "events"> | Omit<CommandRejected, "events">;
-export type CommandOutcome<TState extends JsonValue = JsonValue> = CommandCommitted<TState> | CommandNoop | CommandRejected;
-export declare const done: <TState extends JsonValue = JsonValue>(value?: JsonValue, state?: TState) => CommandDone<TState>;
+export type CommandHandlerOutcome = CommandDone | Omit<CommandNoop, "events"> | Omit<CommandRejected, "events">;
+export type CommandOutcome = CommandCommitted | CommandNoop | CommandRejected;
+export declare const done: (value?: JsonValue) => CommandDone;
 export declare const noop: (reason?: string) => CommandNoop;
 export declare const reject: (reason: string, code?: string) => CommandRejected;
 export type CommandInputParser<TInput> = (input: unknown) => TInput;
-export type CommandHandler<TInput, TState extends JsonValue = JsonValue> = (input: TInput, context: CommandContext<TState>) => CommandHandlerOutcome<TState>;
-export interface CommandDefinition<TInput = unknown, TState extends JsonValue = JsonValue> {
+export type CommandHandler<TInput> = (input: TInput, context: CommandContext) => CommandHandlerOutcome;
+export interface CommandDefinition<TInput = unknown> {
     readonly id: string;
     readonly name: string;
     readonly parseInput: (input: unknown) => TInput;
     readonly execute: (input: unknown, options?: {
         readonly state?: Readonly<Record<string, JsonValue>>;
-    }) => CommandOutcome<TState>;
-    readonly handle: CommandDefinition<TInput, TState>["execute"];
+    }) => CommandOutcome;
+    readonly handle: CommandDefinition<TInput>["execute"];
 }
-export type CommandDefinitionOptions<TInput, TState extends JsonValue = JsonValue> = {
+export type CommandDefinitionOptions<TInput> = {
     readonly id?: string;
     readonly name?: string;
     readonly parseInput?: CommandInputParser<TInput>;
     readonly inputParser?: CommandInputParser<TInput>;
     readonly input?: CommandInputParser<TInput>;
-    readonly handler: CommandHandler<TInput, TState>;
+    readonly handler: CommandHandler<TInput>;
 };
-export declare function defineCommand<TInput, TState extends JsonValue = JsonValue>(options: CommandDefinitionOptions<TInput, TState>): CommandDefinition<TInput, TState>;
+export declare function defineCommand<TInput>(options: CommandDefinitionOptions<TInput>): CommandDefinition<TInput>;
 export interface DomainComponentDefinition {
     readonly id?: string;
     readonly name?: string;

package/dist/index.js

@@ -355,7 +355,7 @@ function defineProjector(options) {
     deserializeState
   });
 }
-var done = (value, state) => Object.freeze({ kind: "committed", value, state });
+var done = (value) => Object.freeze({ kind: "committed", value });
 var noop = (reason) => Object.freeze({ kind: "noop", reason, events: [] });
 var reject = (reason, code = "command_rejected") => Object.freeze({ kind: "rejected", reason, code, events: [] });
 function defineCommand(options) {
@@ -395,7 +395,9 @@ function defineCommand(options) {
     if (!outcome || typeof outcome !== "object" || !["committed", "noop", "rejected"].includes(outcome.kind)) {
       throw new DcbDefinitionError("COMMAND_OUTCOME_INVALID", `Command ${id} must return done, noop, or reject`);
     }
-    if (outcome.kind === "committed") return Object.freeze({ ...outcome, events: Object.freeze([...appended]) });
+    if (outcome.kind === "committed") {
+      return Object.freeze({ kind: "committed", value: outcome.value, events: Object.freeze([...appended]) });
+    }
     if (appended.length > 0) throw new DcbDefinitionError("COMMAND_EVENTS_WITHOUT_COMMIT", `Command ${id} appended events but did not return done`);
     return outcome.kind === "noop" ? Object.freeze({ ...outcome, events: [] }) : Object.freeze({ ...outcome, events: [] });
   };

package/dist/materializedView.d.ts

@@ -1,4 +1,4 @@
-import { type JsonValue } from "./index";
+import { type JsonValue } from "./index.js";
 /** The only scalar representations that may be persisted in an MV index. */
 export type MaterializedViewIndexValueType = "text" | "integer" | "real";
 export type MaterializedViewIndexValue = string | number;

package/dist/materializedView.js

@@ -1,4 +1,4 @@
-import { assertJsonValue } from "./index";
+import { assertJsonValue } from "./index.js";
 function nonEmpty(value, code, message) {
     if (typeof value !== "string" || value.length === 0)
         throw new Error(`${code}: ${message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sekiban/dcb-core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": false,
   "description": "Cloudflare-independent Serialized DCB definitions and domain algebra.",
   "license": "Elastic-2.0",