@imolko/ultra-ddd 2.1.5 → 2.1.7-beta
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist-browser/aggregate-root/aggregate-memento-hooks.d.ts +33 -16
- package/dist-browser/aggregate-root/aggregate-memento-hooks.d.ts.map +1 -1
- package/dist-browser/aggregate-root/aggregate-memento-hooks.js +28 -21
- package/dist-browser/aggregate-root/aggregate-memento-hooks.js.map +1 -1
- package/dist-browser/aggregate-root/aggregate-public-api.type.d.ts +13 -2
- package/dist-browser/aggregate-root/aggregate-public-api.type.d.ts.map +1 -1
- package/dist-browser/aggregate-root/aggregate-with-public-api.mixin.d.ts +8 -8
- package/dist-browser/aggregate-root/aggregate-with-static-members.mixin.d.ts +9 -16
- package/dist-browser/aggregate-root/aggregate-with-static-members.mixin.d.ts.map +1 -1
- package/dist-browser/aggregate-root/aggregate-with-static-members.mixin.js +82 -89
- package/dist-browser/aggregate-root/aggregate-with-static-members.mixin.js.map +1 -1
- package/dist-browser/aggregate-root/event-sourced/event-sourced-aggregate-base.class.d.ts +32 -54
- package/dist-browser/aggregate-root/event-sourced/event-sourced-aggregate-base.class.d.ts.map +1 -1
- package/dist-browser/aggregate-root/event-sourced/event-sourced-aggregate-base.class.js +34 -55
- package/dist-browser/aggregate-root/event-sourced/event-sourced-aggregate-base.class.js.map +1 -1
- package/dist-browser/aggregate-root/event-sourced/event-sourced-rehydrate.d.ts +23 -0
- package/dist-browser/aggregate-root/event-sourced/event-sourced-rehydrate.d.ts.map +1 -0
- package/dist-browser/aggregate-root/event-sourced/event-sourced-rehydrate.js +65 -0
- package/dist-browser/aggregate-root/event-sourced/event-sourced-rehydrate.js.map +1 -0
- package/dist-browser/aggregate-root/event-sourced/event-sourced.fixtures.d.ts +9 -9
- package/dist-browser/aggregate-root/event-sourced/event-sourced.fixtures.d.ts.map +1 -1
- package/dist-browser/aggregate-root/event-sourced/event-sourced.fixtures.js.map +1 -1
- package/dist-browser/aggregate-root/event-sourced/event-sourced.types.d.ts +59 -0
- package/dist-browser/aggregate-root/event-sourced/event-sourced.types.d.ts.map +1 -1
- package/dist-browser/aggregate-root/event-sourced/index.d.ts +1 -1
- package/dist-browser/aggregate-root/event-sourced/index.d.ts.map +1 -1
- package/dist-browser/aggregate-root/event-sourced/index.js.map +1 -1
- package/dist-browser/aggregate-root/memento/errors/index.d.ts +8 -1
- package/dist-browser/aggregate-root/memento/errors/index.d.ts.map +1 -1
- package/dist-browser/aggregate-root/memento/errors/index.js.map +1 -1
- package/dist-browser/aggregate-root/memento/index.d.ts.map +1 -1
- package/dist-browser/aggregate-root/memento/index.js.map +1 -1
- package/dist-browser/aggregate-root/memento/value-object.d.ts +2 -1
- package/dist-browser/aggregate-root/memento/value-object.d.ts.map +1 -1
- package/dist-browser/aggregate-root/rebuild-rules.d.ts +19 -0
- package/dist-browser/aggregate-root/rebuild-rules.d.ts.map +1 -0
- package/dist-browser/aggregate-root/rebuild-rules.js +24 -0
- package/dist-browser/aggregate-root/rebuild-rules.js.map +1 -0
- package/dist-browser/aggregate-root/register-facade-rebuild.d.ts +28 -0
- package/dist-browser/aggregate-root/register-facade-rebuild.d.ts.map +1 -0
- package/dist-browser/aggregate-root/register-facade-rebuild.js +31 -0
- package/dist-browser/aggregate-root/register-facade-rebuild.js.map +1 -0
- package/dist-browser/aggregate-root/snapshot-rebuild-registry.d.ts +29 -0
- package/dist-browser/aggregate-root/snapshot-rebuild-registry.d.ts.map +1 -0
- package/dist-browser/aggregate-root/snapshot-rebuild-registry.js +65 -0
- package/dist-browser/aggregate-root/snapshot-rebuild-registry.js.map +1 -0
- package/dist-browser/aggregate-root/snapshot-to-aggregate.d.ts +33 -0
- package/dist-browser/aggregate-root/snapshot-to-aggregate.d.ts.map +1 -0
- package/dist-browser/aggregate-root/snapshot-to-aggregate.js +24 -0
- package/dist-browser/aggregate-root/snapshot-to-aggregate.js.map +1 -0
- package/dist-browser/aggregate-root/use-examples/product-woo/aggregate.d.ts +4 -4
- package/dist-browser/event/use-samples/validated-artifact/artifacts/aggregate.d.ts +4 -4
- package/dist-browser/test/execute-sequentially/artifacts/aggregate.d.ts +4 -4
- package/dist-node/aggregate-root/aggregate-memento-hooks.d.ts +33 -16
- package/dist-node/aggregate-root/aggregate-memento-hooks.d.ts.map +1 -1
- package/dist-node/aggregate-root/aggregate-memento-hooks.js +30 -23
- package/dist-node/aggregate-root/aggregate-memento-hooks.js.map +1 -1
- package/dist-node/aggregate-root/aggregate-public-api.type.d.ts +13 -2
- package/dist-node/aggregate-root/aggregate-public-api.type.d.ts.map +1 -1
- package/dist-node/aggregate-root/aggregate-with-public-api.mixin.d.ts +8 -8
- package/dist-node/aggregate-root/aggregate-with-static-members.mixin.d.ts +9 -16
- package/dist-node/aggregate-root/aggregate-with-static-members.mixin.d.ts.map +1 -1
- package/dist-node/aggregate-root/aggregate-with-static-members.mixin.js +80 -87
- package/dist-node/aggregate-root/aggregate-with-static-members.mixin.js.map +1 -1
- package/dist-node/aggregate-root/event-sourced/event-sourced-aggregate-base.class.d.ts +32 -54
- package/dist-node/aggregate-root/event-sourced/event-sourced-aggregate-base.class.d.ts.map +1 -1
- package/dist-node/aggregate-root/event-sourced/event-sourced-aggregate-base.class.js +34 -55
- package/dist-node/aggregate-root/event-sourced/event-sourced-aggregate-base.class.js.map +1 -1
- package/dist-node/aggregate-root/event-sourced/event-sourced-rehydrate.d.ts +23 -0
- package/dist-node/aggregate-root/event-sourced/event-sourced-rehydrate.d.ts.map +1 -0
- package/dist-node/aggregate-root/event-sourced/event-sourced-rehydrate.js +69 -0
- package/dist-node/aggregate-root/event-sourced/event-sourced-rehydrate.js.map +1 -0
- package/dist-node/aggregate-root/event-sourced/event-sourced.fixtures.d.ts +9 -9
- package/dist-node/aggregate-root/event-sourced/event-sourced.fixtures.d.ts.map +1 -1
- package/dist-node/aggregate-root/event-sourced/event-sourced.fixtures.js.map +1 -1
- package/dist-node/aggregate-root/event-sourced/event-sourced.types.d.ts +59 -0
- package/dist-node/aggregate-root/event-sourced/event-sourced.types.d.ts.map +1 -1
- package/dist-node/aggregate-root/event-sourced/index.d.ts +1 -1
- package/dist-node/aggregate-root/event-sourced/index.d.ts.map +1 -1
- package/dist-node/aggregate-root/event-sourced/index.js.map +1 -1
- package/dist-node/aggregate-root/memento/errors/index.d.ts +8 -1
- package/dist-node/aggregate-root/memento/errors/index.d.ts.map +1 -1
- package/dist-node/aggregate-root/memento/errors/index.js.map +1 -1
- package/dist-node/aggregate-root/memento/index.d.ts.map +1 -1
- package/dist-node/aggregate-root/memento/index.js.map +1 -1
- package/dist-node/aggregate-root/memento/value-object.d.ts +2 -1
- package/dist-node/aggregate-root/memento/value-object.d.ts.map +1 -1
- package/dist-node/aggregate-root/rebuild-rules.d.ts +19 -0
- package/dist-node/aggregate-root/rebuild-rules.d.ts.map +1 -0
- package/dist-node/aggregate-root/rebuild-rules.js +28 -0
- package/dist-node/aggregate-root/rebuild-rules.js.map +1 -0
- package/dist-node/aggregate-root/register-facade-rebuild.d.ts +28 -0
- package/dist-node/aggregate-root/register-facade-rebuild.d.ts.map +1 -0
- package/dist-node/aggregate-root/register-facade-rebuild.js +35 -0
- package/dist-node/aggregate-root/register-facade-rebuild.js.map +1 -0
- package/dist-node/aggregate-root/snapshot-rebuild-registry.d.ts +29 -0
- package/dist-node/aggregate-root/snapshot-rebuild-registry.d.ts.map +1 -0
- package/dist-node/aggregate-root/snapshot-rebuild-registry.js +70 -0
- package/dist-node/aggregate-root/snapshot-rebuild-registry.js.map +1 -0
- package/dist-node/aggregate-root/snapshot-to-aggregate.d.ts +33 -0
- package/dist-node/aggregate-root/snapshot-to-aggregate.d.ts.map +1 -0
- package/dist-node/aggregate-root/snapshot-to-aggregate.js +28 -0
- package/dist-node/aggregate-root/snapshot-to-aggregate.js.map +1 -0
- package/dist-node/aggregate-root/use-examples/product-woo/aggregate.d.ts +4 -4
- package/dist-node/event/use-samples/validated-artifact/artifacts/aggregate.d.ts +4 -4
- package/dist-node/test/execute-sequentially/artifacts/aggregate.d.ts +4 -4
- package/package.json +1 -1
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { Props } from './props';
|
|
2
|
+
import { Errors } from './errors';
|
|
2
3
|
import { Definition } from './definition';
|
|
3
4
|
import { Primitive } from './primitive';
|
|
4
5
|
declare const Memento_base: ((abstract new (...args: any[]) => {
|
|
@@ -174,7 +175,7 @@ declare const Memento_base: ((abstract new (...args: any[]) => {
|
|
|
174
175
|
dataVersion: number;
|
|
175
176
|
state: Record<any, any>;
|
|
176
177
|
securityToken: string;
|
|
177
|
-
}): import("@imolko/ultra-result").Validation<
|
|
178
|
+
}): import("@imolko/ultra-result").Validation<Errors, InstanceType<Implemented>>;
|
|
178
179
|
builder(props: Props): {
|
|
179
180
|
clone(changes: Partial<Props>): /*elided*/ any;
|
|
180
181
|
readonly props: Readonly<Props>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"value-object.d.ts","sourceRoot":"","sources":["../../../src/aggregate-root/memento/value-object.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"value-object.d.ts","sourceRoot":"","sources":["../../../src/aggregate-root/memento/value-object.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGxC,qBAGa,OAAQ,SAAQ,YAMhB;CAAG"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { ZodType } from '@imolko/ultra-v8n';
|
|
2
|
+
import { SnapshotToAggregateRules } from './snapshot-to-aggregate';
|
|
3
|
+
/**
|
|
4
|
+
* Compone las reglas de reconstrucción con una versión de stream fija.
|
|
5
|
+
*
|
|
6
|
+
* Es el punto interno que comparten `restore`, `rehydrate` y el camino
|
|
7
|
+
* legado `rulesRebuild`; el puente snapshot→agregado no se expone en el
|
|
8
|
+
* API público del agregado.
|
|
9
|
+
*
|
|
10
|
+
* La entrada es `unknown` a propósito: la valida `conditions.rebuild`, que
|
|
11
|
+
* es la regla que declara el agregado, y el resultado se entrega por el
|
|
12
|
+
* canal de validación del llamador.
|
|
13
|
+
*
|
|
14
|
+
* @param rules reglas de reconstrucción declaradas por el agregado
|
|
15
|
+
* @param streamVersion versión de stream que se aplicará al agregado
|
|
16
|
+
* @returns reglas Zod que reconstruyen el agregado
|
|
17
|
+
*/
|
|
18
|
+
export declare const createRebuildRules: <Props, Snapshot, Aggregate>(rules: SnapshotToAggregateRules<Props, Snapshot, Aggregate>, streamVersion: number) => ZodType<Aggregate, unknown>;
|
|
19
|
+
//# sourceMappingURL=rebuild-rules.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"rebuild-rules.d.ts","sourceRoot":"","sources":["../../src/aggregate-root/rebuild-rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAK,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAEL,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,EAAE,QAAQ,EAAE,SAAS,EAC3D,OAAO,wBAAwB,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,EAC3D,eAAe,MAAM,KACpB,OAAO,CAAC,SAAS,EAAE,OAAO,CAK5B,CAAC"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { z } from '@imolko/ultra-v8n';
|
|
2
|
+
import { createSnapshotToAggregate, } from './snapshot-to-aggregate';
|
|
3
|
+
/**
|
|
4
|
+
* Compone las reglas de reconstrucción con una versión de stream fija.
|
|
5
|
+
*
|
|
6
|
+
* Es el punto interno que comparten `restore`, `rehydrate` y el camino
|
|
7
|
+
* legado `rulesRebuild`; el puente snapshot→agregado no se expone en el
|
|
8
|
+
* API público del agregado.
|
|
9
|
+
*
|
|
10
|
+
* La entrada es `unknown` a propósito: la valida `conditions.rebuild`, que
|
|
11
|
+
* es la regla que declara el agregado, y el resultado se entrega por el
|
|
12
|
+
* canal de validación del llamador.
|
|
13
|
+
*
|
|
14
|
+
* @param rules reglas de reconstrucción declaradas por el agregado
|
|
15
|
+
* @param streamVersion versión de stream que se aplicará al agregado
|
|
16
|
+
* @returns reglas Zod que reconstruyen el agregado
|
|
17
|
+
*/
|
|
18
|
+
export const createRebuildRules = (rules, streamVersion) => {
|
|
19
|
+
const rebuild = createSnapshotToAggregate(rules);
|
|
20
|
+
return z
|
|
21
|
+
.unknown()
|
|
22
|
+
.transform((snapshot) => rebuild(snapshot, streamVersion));
|
|
23
|
+
};
|
|
24
|
+
//# sourceMappingURL=rebuild-rules.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"rebuild-rules.js","sourceRoot":"","sources":["../../src/aggregate-root/rebuild-rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EACL,yBAAyB,GAE1B,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAA2D,EAC3D,aAAqB,EACQ,EAAE;IAC/B,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjD,OAAO,CAAC;SACL,OAAO,EAAE;SACT,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,QAAoB,EAAE,aAAa,CAAC,CAAC,CAAC;AAC3E,CAAC,CAAC"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Piezas que la fachada aporta para reconstruirse desde un snapshot.
|
|
3
|
+
*/
|
|
4
|
+
export interface FacadeRebuildRequest<Props, Aggregate> {
|
|
5
|
+
/** Clase sobre la que se registra la reconstrucción. */
|
|
6
|
+
facade: object;
|
|
7
|
+
/** Crea el agregado desde las props reconstruidas. */
|
|
8
|
+
construct(target: object, props: Props): Aggregate;
|
|
9
|
+
/** Rebuilder declarado por el agregado, si existe. */
|
|
10
|
+
rebuilder?(props: Props): Aggregate;
|
|
11
|
+
/** Habilita la construcción simulada de constructor privado. */
|
|
12
|
+
allowConstruction(): void;
|
|
13
|
+
/** Ajusta el agregado reconstruido con la versión de stream. */
|
|
14
|
+
restoreStreamVersion?(aggregate: unknown, streamVersion: number): void;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Registra la reconstrucción de una fachada desde su snapshot.
|
|
18
|
+
*
|
|
19
|
+
* Encapsula el protocolo de construcción de la fachada —la bandera que
|
|
20
|
+
* simula el constructor privado y el rebuilder declarado por el agregado—
|
|
21
|
+
* para que el mixin sólo declare de dónde salen las piezas internas. Las
|
|
22
|
+
* reglas de reconstrucción se leen de la clase sobre la que se invocó, de
|
|
23
|
+
* modo que una subclase que las sobreescriba se respeta.
|
|
24
|
+
*
|
|
25
|
+
* @param request piezas de reconstrucción que aporta la fachada
|
|
26
|
+
*/
|
|
27
|
+
export declare const registerFacadeRebuild: <Props, Snapshot, Aggregate>(request: FacadeRebuildRequest<Props, Aggregate>) => void;
|
|
28
|
+
//# sourceMappingURL=register-facade-rebuild.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"register-facade-rebuild.d.ts","sourceRoot":"","sources":["../../src/aggregate-root/register-facade-rebuild.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,KAAK,EAAE,SAAS;IACpD,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACnD,sDAAsD;IACtD,SAAS,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACpC,gEAAgE;IAChE,iBAAiB,IAAI,IAAI,CAAC;IAC1B,gEAAgE;IAChE,oBAAoB,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CACxE;AAOD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,GAAI,KAAK,EAAE,QAAQ,EAAE,SAAS,EAC9D,SAAS,oBAAoB,CAAC,KAAK,EAAE,SAAS,CAAC,KAC9C,IA2BF,CAAC"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { createRebuildRules } from './rebuild-rules';
|
|
2
|
+
import { registerSnapshotRebuildRules } from './snapshot-rebuild-registry';
|
|
3
|
+
/**
|
|
4
|
+
* Registra la reconstrucción de una fachada desde su snapshot.
|
|
5
|
+
*
|
|
6
|
+
* Encapsula el protocolo de construcción de la fachada —la bandera que
|
|
7
|
+
* simula el constructor privado y el rebuilder declarado por el agregado—
|
|
8
|
+
* para que el mixin sólo declare de dónde salen las piezas internas. Las
|
|
9
|
+
* reglas de reconstrucción se leen de la clase sobre la que se invocó, de
|
|
10
|
+
* modo que una subclase que las sobreescriba se respeta.
|
|
11
|
+
*
|
|
12
|
+
* @param request piezas de reconstrucción que aporta la fachada
|
|
13
|
+
*/
|
|
14
|
+
export const registerFacadeRebuild = (request) => {
|
|
15
|
+
const { facade, construct, rebuilder, allowConstruction, restoreStreamVersion, } = request;
|
|
16
|
+
registerSnapshotRebuildRules(facade, (target, streamVersion) => {
|
|
17
|
+
const declared = target;
|
|
18
|
+
const build = rebuilder
|
|
19
|
+
? (props) => rebuilder.bind(target)(props)
|
|
20
|
+
: (props) => construct(target, props);
|
|
21
|
+
return createRebuildRules({
|
|
22
|
+
conditions: declared.conditions,
|
|
23
|
+
rebuilder: (props) => {
|
|
24
|
+
allowConstruction();
|
|
25
|
+
return build(props);
|
|
26
|
+
},
|
|
27
|
+
restoreStreamVersion,
|
|
28
|
+
}, streamVersion);
|
|
29
|
+
});
|
|
30
|
+
};
|
|
31
|
+
//# sourceMappingURL=register-facade-rebuild.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"register-facade-rebuild.js","sourceRoot":"","sources":["../../src/aggregate-root/register-facade-rebuild.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAuB3E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,OAA+C,EACzC,EAAE;IACR,MAAM,EACJ,MAAM,EACN,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,oBAAoB,GACrB,GAAG,OAAO,CAAC;IAEZ,4BAA4B,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE;QAC7D,MAAM,QAAQ,GAAG,MAAwD,CAAC;QAC1E,MAAM,KAAK,GAAG,SAAS;YACrB,CAAC,CAAC,CAAC,KAAY,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC;YACjD,CAAC,CAAC,CAAC,KAAY,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAE/C,OAAO,kBAAkB,CACvB;YACE,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;gBACnB,iBAAiB,EAAE,CAAC;gBACpB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YACD,oBAAoB;SACrB,EACD,aAAa,CACd,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { ZodType } from '@imolko/ultra-v8n';
|
|
2
|
+
/**
|
|
3
|
+
* Fábrica interna de reglas de reconstrucción para una clase de agregado.
|
|
4
|
+
*
|
|
5
|
+
* Recibe la clase concreta en el momento de uso para respetar las
|
|
6
|
+
* sobreescrituras de una subclase.
|
|
7
|
+
*/
|
|
8
|
+
type SnapshotRebuildRulesFactory = (target: object, streamVersion: number) => ZodType<unknown, unknown>;
|
|
9
|
+
/**
|
|
10
|
+
* Registra la fábrica de reglas de reconstrucción de una clase.
|
|
11
|
+
*
|
|
12
|
+
* @param target clase del agregado
|
|
13
|
+
* @param factory fábrica interna de reglas
|
|
14
|
+
*/
|
|
15
|
+
export declare const registerSnapshotRebuildRules: (target: object, factory: SnapshotRebuildRulesFactory) => void;
|
|
16
|
+
/**
|
|
17
|
+
* Resuelve las reglas internas de reconstrucción de un agregado.
|
|
18
|
+
*
|
|
19
|
+
* La clase se resuelve en el momento de uso para respetar las
|
|
20
|
+
* sobreescrituras de una subclase; el tipo del agregado lo aporta el
|
|
21
|
+
* llamador, que es quien después entrega el resultado por su canal.
|
|
22
|
+
*
|
|
23
|
+
* @param target clase del agregado
|
|
24
|
+
* @param streamVersion versión de stream que se aplicará
|
|
25
|
+
* @returns reglas Zod que reconstruyen el agregado
|
|
26
|
+
*/
|
|
27
|
+
export declare const createSnapshotRebuildRules: <Aggregate>(target: object, streamVersion: number) => ZodType<Aggregate, unknown>;
|
|
28
|
+
export {};
|
|
29
|
+
//# sourceMappingURL=snapshot-rebuild-registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"snapshot-rebuild-registry.d.ts","sourceRoot":"","sources":["../../src/aggregate-root/snapshot-rebuild-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAI5C;;;;;GAKG;AACH,KAAK,2BAA2B,GAAG,CACjC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,KAClB,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAU/B;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,GACvC,QAAQ,MAAM,EACd,SAAS,2BAA2B,KACnC,IAEF,CAAC;AA+CF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,GAAI,SAAS,EAClD,QAAQ,MAAM,EACd,eAAe,MAAM,KACpB,OAAO,CAAC,SAAS,EAAE,OAAO,CAM5B,CAAC"}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { createRebuildRules } from './rebuild-rules';
|
|
2
|
+
/**
|
|
3
|
+
* Registro interno de fábricas por clase.
|
|
4
|
+
*
|
|
5
|
+
* Mantiene el puente snapshot→agregado fuera del API público: los mixins
|
|
6
|
+
* registran su fábrica y `rehydrate` la resuelve sin un static público.
|
|
7
|
+
*/
|
|
8
|
+
const factories = new WeakMap();
|
|
9
|
+
/**
|
|
10
|
+
* Registra la fábrica de reglas de reconstrucción de una clase.
|
|
11
|
+
*
|
|
12
|
+
* @param target clase del agregado
|
|
13
|
+
* @param factory fábrica interna de reglas
|
|
14
|
+
*/
|
|
15
|
+
export const registerSnapshotRebuildRules = (target, factory) => {
|
|
16
|
+
factories.set(target, factory);
|
|
17
|
+
};
|
|
18
|
+
/**
|
|
19
|
+
* Busca la fábrica registrada, incluyendo las heredadas por la cadena de
|
|
20
|
+
* prototipos de la clase.
|
|
21
|
+
*/
|
|
22
|
+
const findFactory = (target) => {
|
|
23
|
+
let current = target;
|
|
24
|
+
while (current !== null) {
|
|
25
|
+
const factory = factories.get(current);
|
|
26
|
+
if (factory !== undefined) {
|
|
27
|
+
return factory;
|
|
28
|
+
}
|
|
29
|
+
current = Object.getPrototypeOf(current);
|
|
30
|
+
}
|
|
31
|
+
return undefined;
|
|
32
|
+
};
|
|
33
|
+
/**
|
|
34
|
+
* Fábrica por defecto para agregados que no pasan por los mixins.
|
|
35
|
+
*/
|
|
36
|
+
const createDefaultFactory = (target, streamVersion) => {
|
|
37
|
+
const definition = target;
|
|
38
|
+
const rebuilder = definition.rebuilder
|
|
39
|
+
? (props) => definition.rebuilder?.(props)
|
|
40
|
+
: (props) => new target(props);
|
|
41
|
+
return createRebuildRules({
|
|
42
|
+
conditions: definition.conditions,
|
|
43
|
+
rebuilder,
|
|
44
|
+
restoreStreamVersion: definition.restoreStreamVersion,
|
|
45
|
+
}, streamVersion);
|
|
46
|
+
};
|
|
47
|
+
/**
|
|
48
|
+
* Resuelve las reglas internas de reconstrucción de un agregado.
|
|
49
|
+
*
|
|
50
|
+
* La clase se resuelve en el momento de uso para respetar las
|
|
51
|
+
* sobreescrituras de una subclase; el tipo del agregado lo aporta el
|
|
52
|
+
* llamador, que es quien después entrega el resultado por su canal.
|
|
53
|
+
*
|
|
54
|
+
* @param target clase del agregado
|
|
55
|
+
* @param streamVersion versión de stream que se aplicará
|
|
56
|
+
* @returns reglas Zod que reconstruyen el agregado
|
|
57
|
+
*/
|
|
58
|
+
export const createSnapshotRebuildRules = (target, streamVersion) => {
|
|
59
|
+
const factory = findFactory(target);
|
|
60
|
+
const rules = factory
|
|
61
|
+
? factory(target, streamVersion)
|
|
62
|
+
: createDefaultFactory(target, streamVersion);
|
|
63
|
+
return rules;
|
|
64
|
+
};
|
|
65
|
+
//# sourceMappingURL=snapshot-rebuild-registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"snapshot-rebuild-registry.js","sourceRoot":"","sources":["../../src/aggregate-root/snapshot-rebuild-registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAarD;;;;;GAKG;AACH,MAAM,SAAS,GAAG,IAAI,OAAO,EAAuC,CAAC;AAErE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,MAAc,EACd,OAAoC,EAC9B,EAAE;IACR,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,GAAG,CAClB,MAAc,EAC2B,EAAE;IAC3C,IAAI,OAAO,GAAkB,MAAM,CAAC;IACpC,OAAO,OAAO,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAkB,CAAC;IAC5D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,oBAAoB,GAAG,CAC3B,MAAc,EACd,aAAqB,EACM,EAAE;IAC7B,MAAM,UAAU,GAAG,MAIlB,CAAC;IACF,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS;QACpC,CAAC,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC;QACnD,CAAC,CAAC,CAAC,KAAc,EAAE,EAAE,CACjB,IAAK,MAAqD,CAAC,KAAK,CAAC,CAAC;IAExE,OAAO,kBAAkB,CACvB;QACE,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,SAAS;QACT,oBAAoB,EAAE,UAAU,CAAC,oBAAoB;KACtD,EACD,aAAa,CACd,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,MAAc,EACd,aAAqB,EACQ,EAAE;IAC/B,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,OAAO;QACnB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC;QAChC,CAAC,CAAC,oBAAoB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAChD,OAAO,KAAoC,CAAC;AAC9C,CAAC,CAAC"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { ZodType } from '@imolko/ultra-v8n';
|
|
2
|
+
/**
|
|
3
|
+
* Reglas que declara el agregado para reconstruirse desde su snapshot.
|
|
4
|
+
*
|
|
5
|
+
* El puente no las redefine: las recibe del agregado y las aplica en el
|
|
6
|
+
* mismo orden que la restauración desde un memento.
|
|
7
|
+
*/
|
|
8
|
+
export interface SnapshotToAggregateRules<Props, Snapshot, Aggregate> {
|
|
9
|
+
/** Reglas de reconstrucción declaradas por el agregado. */
|
|
10
|
+
readonly conditions: {
|
|
11
|
+
readonly rebuild: ZodType<Props, Snapshot>;
|
|
12
|
+
};
|
|
13
|
+
/** Fábrica interna que crea el agregado desde las props reconstruidas. */
|
|
14
|
+
rebuilder(props: Props): Aggregate;
|
|
15
|
+
/** Ajusta el agregado reconstruido con la versión de stream. */
|
|
16
|
+
restoreStreamVersion?(aggregate: Aggregate, streamVersion: number): void;
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Reconstruye un agregado desde su snapshot y una versión de stream.
|
|
20
|
+
*/
|
|
21
|
+
export type SnapshotToAggregate<Snapshot, Aggregate> = (snapshot: Snapshot, streamVersion: number) => Aggregate;
|
|
22
|
+
/**
|
|
23
|
+
* Construye el puente interno entre el snapshot y el agregado.
|
|
24
|
+
*
|
|
25
|
+
* La interface es deliberadamente pequeña: snapshot más versión de stream
|
|
26
|
+
* entran, agregado sale. Las reglas de reconstrucción y el ajuste de la
|
|
27
|
+
* versión de stream quedan encapsulados aquí.
|
|
28
|
+
*
|
|
29
|
+
* @param rules reglas de reconstrucción declaradas por el agregado
|
|
30
|
+
* @returns puente que reconstruye el agregado
|
|
31
|
+
*/
|
|
32
|
+
export declare const createSnapshotToAggregate: <Props, Snapshot, Aggregate>(rules: SnapshotToAggregateRules<Props, Snapshot, Aggregate>) => SnapshotToAggregate<Snapshot, Aggregate>;
|
|
33
|
+
//# sourceMappingURL=snapshot-to-aggregate.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"snapshot-to-aggregate.d.ts","sourceRoot":"","sources":["../../src/aggregate-root/snapshot-to-aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAc,MAAM,mBAAmB,CAAC;AAExD;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS;IAClE,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;KAC5C,CAAC;IACF,0EAA0E;IAC1E,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACnC,gEAAgE;IAChE,oBAAoB,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1E;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,QAAQ,EAAE,SAAS,IAAI,CACrD,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,MAAM,KAClB,SAAS,CAAC;AAEf;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GAAI,KAAK,EAAE,QAAQ,EAAE,SAAS,EAClE,OAAO,wBAAwB,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,KAC1D,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAWzC,CAAC"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { zodWrapper } from '@imolko/ultra-v8n';
|
|
2
|
+
/**
|
|
3
|
+
* Construye el puente interno entre el snapshot y el agregado.
|
|
4
|
+
*
|
|
5
|
+
* La interface es deliberadamente pequeña: snapshot más versión de stream
|
|
6
|
+
* entran, agregado sale. Las reglas de reconstrucción y el ajuste de la
|
|
7
|
+
* versión de stream quedan encapsulados aquí.
|
|
8
|
+
*
|
|
9
|
+
* @param rules reglas de reconstrucción declaradas por el agregado
|
|
10
|
+
* @returns puente que reconstruye el agregado
|
|
11
|
+
*/
|
|
12
|
+
export const createSnapshotToAggregate = (rules) => {
|
|
13
|
+
return (snapshot, streamVersion) => {
|
|
14
|
+
const restoreVersion = (props) => {
|
|
15
|
+
const aggregate = rules.rebuilder(props);
|
|
16
|
+
rules.restoreStreamVersion?.(aggregate, streamVersion);
|
|
17
|
+
return aggregate;
|
|
18
|
+
};
|
|
19
|
+
return rules.conditions.rebuild
|
|
20
|
+
.transform(zodWrapper(restoreVersion))
|
|
21
|
+
.parse(snapshot);
|
|
22
|
+
};
|
|
23
|
+
};
|
|
24
|
+
//# sourceMappingURL=snapshot-to-aggregate.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"snapshot-to-aggregate.js","sourceRoot":"","sources":["../../src/aggregate-root/snapshot-to-aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA2BxD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,KAA2D,EACjB,EAAE;IAC5C,OAAO,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE;QACjC,MAAM,cAAc,GAAG,CAAC,KAAY,EAAa,EAAE;YACjD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACzC,KAAK,CAAC,oBAAoB,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;YACvD,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC;QACF,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO;aAC5B,SAAS,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;aACrC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC,CAAC"}
|
|
@@ -123,21 +123,21 @@ declare const ProductWooAgg_base: ((abstract new (...args: any[]) => {
|
|
|
123
123
|
SECURITY_TOKEN: string;
|
|
124
124
|
PROPS_VERSION: number;
|
|
125
125
|
NAME: string;
|
|
126
|
-
}) & typeof Definition>(this: Implemented): import("zod").
|
|
126
|
+
}) & typeof Definition>(this: Implemented): import("zod").ZodType<InstanceType<Implemented>, {
|
|
127
127
|
aggregate: string;
|
|
128
128
|
modelVersion: number;
|
|
129
129
|
dataVersion: number;
|
|
130
130
|
state: Record<any, any>;
|
|
131
131
|
date: string;
|
|
132
132
|
hash: string;
|
|
133
|
-
}, import("zod/v4/core").$ZodTypeInternals<
|
|
133
|
+
}, import("zod/v4/core").$ZodTypeInternals<InstanceType<Implemented>, {
|
|
134
134
|
aggregate: string;
|
|
135
135
|
modelVersion: number;
|
|
136
136
|
dataVersion: number;
|
|
137
137
|
state: Record<any, any>;
|
|
138
138
|
date: string;
|
|
139
139
|
hash: string;
|
|
140
|
-
}
|
|
140
|
+
}>>;
|
|
141
141
|
create<Implemented extends /*elided*/ any & {
|
|
142
142
|
new (...args: any[]): {
|
|
143
143
|
readonly _id: Numericid;
|
|
@@ -241,7 +241,7 @@ declare const ProductWooAgg_base: ((abstract new (...args: any[]) => {
|
|
|
241
241
|
SECURITY_TOKEN: string;
|
|
242
242
|
PROPS_VERSION: number;
|
|
243
243
|
NAME: string;
|
|
244
|
-
}) & typeof Definition>(this: Implemented, memento: import("../..").MementoValidationsPayload): import("@imolko/ultra-result").Validation<
|
|
244
|
+
}) & typeof Definition>(this: Implemented, memento: import("../..").MementoValidationsPayload): import("@imolko/ultra-result").Validation<import("../..").MigrationNotImplemented | import("../..").SnapshotVersionSuperiorThanActualError | import("../..").MementoTamperedError | import("@imolko/ultra-v8n").InvalidTypeError | import("@imolko/ultra-v8n").InvalidStringError | import("@imolko/ultra-v8n").TooSmallError | import("@imolko/ultra-v8n").TooBigError, InstanceType<Implemented>>;
|
|
245
245
|
migrate(memento: import("../..").Memento): Snapshot;
|
|
246
246
|
builder(props: Props): {
|
|
247
247
|
clone(changes: Partial<Props>): /*elided*/ any;
|
|
@@ -190,21 +190,21 @@ declare const User_base: ((abstract new (...args: any[]) => {
|
|
|
190
190
|
SECURITY_TOKEN: string;
|
|
191
191
|
PROPS_VERSION: number;
|
|
192
192
|
NAME: string;
|
|
193
|
-
}) & typeof Definition>(this: Implemented): z.
|
|
193
|
+
}) & typeof Definition>(this: Implemented): z.ZodType<InstanceType<Implemented>, {
|
|
194
194
|
aggregate: string;
|
|
195
195
|
modelVersion: number;
|
|
196
196
|
dataVersion: number;
|
|
197
197
|
state: Record<any, any>;
|
|
198
198
|
date: string;
|
|
199
199
|
hash: string;
|
|
200
|
-
}, z.core.$ZodTypeInternals<
|
|
200
|
+
}, z.core.$ZodTypeInternals<InstanceType<Implemented>, {
|
|
201
201
|
aggregate: string;
|
|
202
202
|
modelVersion: number;
|
|
203
203
|
dataVersion: number;
|
|
204
204
|
state: Record<any, any>;
|
|
205
205
|
date: string;
|
|
206
206
|
hash: string;
|
|
207
|
-
}
|
|
207
|
+
}>>;
|
|
208
208
|
create<Implemented extends /*elided*/ any & {
|
|
209
209
|
new (...args: any[]): {
|
|
210
210
|
readonly _id: Uuid;
|
|
@@ -308,7 +308,7 @@ declare const User_base: ((abstract new (...args: any[]) => {
|
|
|
308
308
|
SECURITY_TOKEN: string;
|
|
309
309
|
PROPS_VERSION: number;
|
|
310
310
|
NAME: string;
|
|
311
|
-
}) & typeof Definition>(this: Implemented, memento: import("../../../..").MementoValidationsPayload): Validation<
|
|
311
|
+
}) & typeof Definition>(this: Implemented, memento: import("../../../..").MementoValidationsPayload): Validation<import("../../../..").MigrationNotImplemented | import("../../../..").SnapshotVersionSuperiorThanActualError | import("../../../..").MementoTamperedError | InvalidTypeError | import("@imolko/ultra-v8n").InvalidStringError | import("@imolko/ultra-v8n").TooSmallError | import("@imolko/ultra-v8n").TooBigError, InstanceType<Implemented>>;
|
|
312
312
|
migrate(memento: Memento): Snapshot;
|
|
313
313
|
builder(props: Props): {
|
|
314
314
|
clone(changes: Partial<Props>): /*elided*/ any;
|
|
@@ -190,21 +190,21 @@ declare const User_base: ((abstract new (...args: any[]) => {
|
|
|
190
190
|
SECURITY_TOKEN: string;
|
|
191
191
|
PROPS_VERSION: number;
|
|
192
192
|
NAME: string;
|
|
193
|
-
}) & typeof Definition>(this: Implemented): z.
|
|
193
|
+
}) & typeof Definition>(this: Implemented): z.ZodType<InstanceType<Implemented>, {
|
|
194
194
|
aggregate: string;
|
|
195
195
|
modelVersion: number;
|
|
196
196
|
dataVersion: number;
|
|
197
197
|
state: Record<any, any>;
|
|
198
198
|
date: string;
|
|
199
199
|
hash: string;
|
|
200
|
-
}, z.core.$ZodTypeInternals<
|
|
200
|
+
}, z.core.$ZodTypeInternals<InstanceType<Implemented>, {
|
|
201
201
|
aggregate: string;
|
|
202
202
|
modelVersion: number;
|
|
203
203
|
dataVersion: number;
|
|
204
204
|
state: Record<any, any>;
|
|
205
205
|
date: string;
|
|
206
206
|
hash: string;
|
|
207
|
-
}
|
|
207
|
+
}>>;
|
|
208
208
|
create<Implemented extends /*elided*/ any & {
|
|
209
209
|
new (...args: any[]): {
|
|
210
210
|
readonly _id: Uuid;
|
|
@@ -308,7 +308,7 @@ declare const User_base: ((abstract new (...args: any[]) => {
|
|
|
308
308
|
SECURITY_TOKEN: string;
|
|
309
309
|
PROPS_VERSION: number;
|
|
310
310
|
NAME: string;
|
|
311
|
-
}) & typeof Definition>(this: Implemented, memento: import("../../..").MementoValidationsPayload): Validation<
|
|
311
|
+
}) & typeof Definition>(this: Implemented, memento: import("../../..").MementoValidationsPayload): Validation<import("../../..").MigrationNotImplemented | import("../../..").SnapshotVersionSuperiorThanActualError | import("../../..").MementoTamperedError | InvalidTypeError | import("@imolko/ultra-v8n").InvalidStringError | import("@imolko/ultra-v8n").TooSmallError | import("@imolko/ultra-v8n").TooBigError, InstanceType<Implemented>>;
|
|
312
312
|
migrate(memento: Memento): Snapshot;
|
|
313
313
|
builder(props: Props): {
|
|
314
314
|
clone(changes: Partial<Props>): /*elided*/ any;
|
|
@@ -1,11 +1,14 @@
|
|
|
1
|
+
import { Validation } from '@imolko/ultra-result';
|
|
2
|
+
import { MigrationNotImplemented, SnapshotVersionSuperiorThanActualError } from './errors';
|
|
1
3
|
import { Memento } from './memento';
|
|
2
4
|
/** Adapta el estado firmado al snapshot del modelo actual. */
|
|
3
5
|
export type RestoreSnapshotHook = (state: Record<string, unknown>, dataVersion: number) => Record<string, unknown>;
|
|
4
|
-
/**
|
|
5
|
-
|
|
6
|
+
/**
|
|
7
|
+
* Errores de versión que puede producir la restauración de un memento.
|
|
8
|
+
*/
|
|
9
|
+
export type MementoVersionErrors = SnapshotVersionSuperiorThanActualError | MigrationNotImplemented;
|
|
6
10
|
/**
|
|
7
11
|
* Adapta el estado del memento al snapshot del modelo.
|
|
8
|
-
*
|
|
9
12
|
* Sin hook conserva el comportamiento histórico: `dataVersion` se copia
|
|
10
13
|
* en `version`. Con hook, el agregado decide cómo interpretar el estado.
|
|
11
14
|
*
|
|
@@ -16,23 +19,37 @@ export type RestoreStreamVersionHook = (aggregate: unknown, dataVersion: number)
|
|
|
16
19
|
*/
|
|
17
20
|
export declare const adaptSnapshotToModel: (state: Record<string, unknown>, dataVersion: number, restoreSnapshot?: RestoreSnapshotHook) => Record<string, unknown>;
|
|
18
21
|
/**
|
|
19
|
-
*
|
|
22
|
+
* Piezas necesarias para resolver el snapshot de un memento firmado.
|
|
23
|
+
*/
|
|
24
|
+
export interface ResolveMementoSnapshotRequest<Snapshot> {
|
|
25
|
+
/** Memento ya validado en integridad. */
|
|
26
|
+
memento: Memento;
|
|
27
|
+
/** Versión de modelo que declara el agregado. */
|
|
28
|
+
propsVersion: number;
|
|
29
|
+
/** Hook opcional para adaptar el estado firmado al modelo actual. */
|
|
30
|
+
restoreSnapshot?: RestoreSnapshotHook;
|
|
31
|
+
/** Migración declarada por el agregado, si existe. */
|
|
32
|
+
migrate?: (memento: Memento) => Snapshot;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Snapshot resuelto junto con la versión de stream que firmaba el memento.
|
|
20
36
|
*/
|
|
21
|
-
export interface
|
|
22
|
-
/**
|
|
23
|
-
|
|
24
|
-
/**
|
|
25
|
-
|
|
37
|
+
export interface ResolvedMementoSnapshot<Snapshot> {
|
|
38
|
+
/** Snapshot listo para reconstruir el agregado. */
|
|
39
|
+
snapshot: Snapshot;
|
|
40
|
+
/** Versión de stream firmada en el memento. */
|
|
41
|
+
dataVersion: number;
|
|
26
42
|
}
|
|
27
43
|
/**
|
|
28
|
-
*
|
|
44
|
+
* Resuelve el snapshot del modelo a partir de un memento firmado.
|
|
29
45
|
*
|
|
30
|
-
*
|
|
31
|
-
*
|
|
46
|
+
* La versión se decide sin lanzar: un memento más nuevo retorna el error
|
|
47
|
+
* de versión superior y uno más viejo sin migración retorna el error de
|
|
48
|
+
* migración no implementada. Ambos viajan por el canal de validación para
|
|
49
|
+
* que `restore` los entregue como valor.
|
|
32
50
|
*
|
|
33
|
-
* @param
|
|
34
|
-
* @
|
|
35
|
-
* @returns hooks para capturar y aplicar la versión de stream
|
|
51
|
+
* @param request memento, versión del modelo y hooks del agregado
|
|
52
|
+
* @returns el snapshot resuelto o el error de versión
|
|
36
53
|
*/
|
|
37
|
-
export declare const
|
|
54
|
+
export declare const resolveMementoSnapshot: <Snapshot>(request: ResolveMementoSnapshotRequest<Snapshot>) => Validation<MementoVersionErrors, ResolvedMementoSnapshot<Snapshot>>;
|
|
38
55
|
//# sourceMappingURL=aggregate-memento-hooks.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"aggregate-memento-hooks.d.ts","sourceRoot":"","sources":["../../src/aggregate-root/aggregate-memento-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,8DAA8D;AAC9D,MAAM,MAAM,mBAAmB,GAAG,CAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,WAAW,EAAE,MAAM,KAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7B
|
|
1
|
+
{"version":3,"file":"aggregate-memento-hooks.d.ts","sourceRoot":"","sources":["../../src/aggregate-root/aggregate-memento-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EACL,uBAAuB,EACvB,sCAAsC,EACvC,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,8DAA8D;AAC9D,MAAM,MAAM,mBAAmB,GAAG,CAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,WAAW,EAAE,MAAM,KAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,sCAAsC,GACtC,uBAAuB,CAAC;AAE5B;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,aAAa,MAAM,EACnB,kBAAkB,mBAAmB,KACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAQxB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,6BAA6B,CAAC,QAAQ;IACrD,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,sDAAsD;IACtD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB,CAAC,QAAQ;IAC/C,mDAAmD;IACnD,QAAQ,EAAE,QAAQ,CAAC;IACnB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GAAI,QAAQ,EAC7C,SAAS,6BAA6B,CAAC,QAAQ,CAAC,KAC/C,UAAU,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,QAAQ,CAAC,CA6BpE,CAAC"}
|
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.
|
|
3
|
+
exports.resolveMementoSnapshot = exports.adaptSnapshotToModel = void 0;
|
|
4
|
+
const ultra_result_1 = require("@imolko/ultra-result");
|
|
5
|
+
const errors_1 = require("./errors");
|
|
4
6
|
/**
|
|
5
7
|
* Adapta el estado del memento al snapshot del modelo.
|
|
6
|
-
*
|
|
7
8
|
* Sin hook conserva el comportamiento histórico: `dataVersion` se copia
|
|
8
9
|
* en `version`. Con hook, el agregado decide cómo interpretar el estado.
|
|
9
10
|
*
|
|
@@ -23,29 +24,35 @@ const adaptSnapshotToModel = (state, dataVersion, restoreSnapshot) => {
|
|
|
23
24
|
};
|
|
24
25
|
exports.adaptSnapshotToModel = adaptSnapshotToModel;
|
|
25
26
|
/**
|
|
26
|
-
*
|
|
27
|
+
* Resuelve el snapshot del modelo a partir de un memento firmado.
|
|
27
28
|
*
|
|
28
|
-
*
|
|
29
|
-
*
|
|
29
|
+
* La versión se decide sin lanzar: un memento más nuevo retorna el error
|
|
30
|
+
* de versión superior y uno más viejo sin migración retorna el error de
|
|
31
|
+
* migración no implementada. Ambos viajan por el canal de validación para
|
|
32
|
+
* que `restore` los entregue como valor.
|
|
30
33
|
*
|
|
31
|
-
* @param
|
|
32
|
-
* @
|
|
33
|
-
* @returns hooks para capturar y aplicar la versión de stream
|
|
34
|
+
* @param request memento, versión del modelo y hooks del agregado
|
|
35
|
+
* @returns el snapshot resuelto o el error de versión
|
|
34
36
|
*/
|
|
35
|
-
const
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
37
|
+
const resolveMementoSnapshot = (request) => {
|
|
38
|
+
const { memento, propsVersion, restoreSnapshot, migrate } = request;
|
|
39
|
+
const version = memento.modelVersion;
|
|
40
|
+
if (version > propsVersion) {
|
|
41
|
+
return (0, ultra_result_1.invalid)(new errors_1.SnapshotVersionSuperiorThanActualError(propsVersion, version));
|
|
42
|
+
}
|
|
43
|
+
if (version === propsVersion) {
|
|
44
|
+
return (0, ultra_result_1.valid)({
|
|
45
|
+
snapshot: (0, exports.adaptSnapshotToModel)(memento.state, memento.dataVersion, restoreSnapshot),
|
|
46
|
+
dataVersion: memento.dataVersion,
|
|
47
|
+
});
|
|
48
|
+
}
|
|
49
|
+
if (!migrate) {
|
|
50
|
+
return (0, ultra_result_1.invalid)(new errors_1.MigrationNotImplemented(propsVersion, version));
|
|
51
|
+
}
|
|
52
|
+
return (0, ultra_result_1.valid)({
|
|
53
|
+
snapshot: migrate(memento),
|
|
54
|
+
dataVersion: memento.dataVersion,
|
|
55
|
+
});
|
|
49
56
|
};
|
|
50
|
-
exports.
|
|
57
|
+
exports.resolveMementoSnapshot = resolveMementoSnapshot;
|
|
51
58
|
//# sourceMappingURL=aggregate-memento-hooks.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"aggregate-memento-hooks.js","sourceRoot":"","sources":["../../src/aggregate-root/aggregate-memento-hooks.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"aggregate-memento-hooks.js","sourceRoot":"","sources":["../../src/aggregate-root/aggregate-memento-hooks.ts"],"names":[],"mappings":";;;AAAA,uDAAkE;AAElE,qCAGkB;AAgBlB;;;;;;;;;GASG;AACI,MAAM,oBAAoB,GAAG,CAClC,KAA8B,EAC9B,WAAmB,EACnB,eAAqC,EACZ,EAAE;IAC3B,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO;QACL,GAAG,KAAK;QACR,OAAO,EAAE,WAAW;KACrB,CAAC;AACJ,CAAC,CAAC;AAZW,QAAA,oBAAoB,wBAY/B;AA0BF;;;;;;;;;;GAUG;AACI,MAAM,sBAAsB,GAAG,CACpC,OAAgD,EACqB,EAAE;IACvE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACpE,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IAErC,IAAI,OAAO,GAAG,YAAY,EAAE,CAAC;QAC3B,OAAO,IAAA,sBAAO,EACZ,IAAI,+CAAsC,CAAC,YAAY,EAAE,OAAO,CAAC,CAClE,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;QAC7B,OAAO,IAAA,oBAAK,EAAC;YACX,QAAQ,EAAE,IAAA,4BAAoB,EAC5B,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,WAAW,EACnB,eAAe,CACJ;YACb,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAA,sBAAO,EAAC,IAAI,gCAAuB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,IAAA,oBAAK,EAAC;QACX,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC,CAAC;AACL,CAAC,CAAC;AA/BW,QAAA,sBAAsB,0BA+BjC"}
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
import { ZodType } from '@imolko/ultra-v8n';
|
|
2
2
|
import { ConstructorPrivate } from '../types/constructor-private';
|
|
3
3
|
import { Validation } from '@imolko/ultra-result';
|
|
4
|
-
import {
|
|
4
|
+
import { MementoVersionErrors } from './aggregate-memento-hooks';
|
|
5
|
+
import { MementoErrors, MementoValidationsPayload } from './memento';
|
|
5
6
|
/**
|
|
6
7
|
* Define los miembros estáticos que
|
|
7
8
|
* tiene un Aggregate.
|
|
@@ -26,6 +27,11 @@ export type AggregatePublicStaticMembers<Props, Payload, Snapshot, Errors, Dynam
|
|
|
26
27
|
* de ejecución y tipear con la clase final implementada
|
|
27
28
|
*/
|
|
28
29
|
rulesBuild: () => ZodType<DynamicSide, Payload>;
|
|
30
|
+
/**
|
|
31
|
+
* @deprecated Camino legado que reconstruye el agregado desde un memento
|
|
32
|
+
* lanzando los errores de versión. Usar `restore`, que los entrega por el
|
|
33
|
+
* canal de validación.
|
|
34
|
+
*/
|
|
29
35
|
rulesRebuild: () => ZodType<DynamicSide, MementoValidationsPayload>;
|
|
30
36
|
/**
|
|
31
37
|
* Crea un agregado dado el payload con los datos.
|
|
@@ -36,7 +42,12 @@ export type AggregatePublicStaticMembers<Props, Payload, Snapshot, Errors, Dynam
|
|
|
36
42
|
* @returns Validation con los errores o con el agregado
|
|
37
43
|
*/
|
|
38
44
|
create: (payload: Payload) => Validation<Errors, DynamicSide>;
|
|
39
|
-
|
|
45
|
+
/**
|
|
46
|
+
* Crea un agregado desde el memento de un agregado guardado previamente.
|
|
47
|
+
*
|
|
48
|
+
* Los errores de versión del memento viajan por el canal de validación.
|
|
49
|
+
*/
|
|
50
|
+
restore: (mementoPayload: MementoValidationsPayload) => Validation<Errors | MementoErrors | MementoVersionErrors, DynamicSide>;
|
|
40
51
|
/**
|
|
41
52
|
* Nombre del agregado
|
|
42
53
|
*
|