feat(clone): rename clone-piece to export-component

api/apps/api/src/modules/clone/export/application/request-export.ts

@@ -2,7 +2,7 @@ import { EventBus, EventPublisher } from '@nestjs/cqrs';
 
 import { ResourceId } from '../domain/export/resource.id';
 import { ResourceKind } from '../domain/export/resource.kind';
-import { ClonePart } from '../domain/export/clone-part/clone-part';
+import { ExportComponent } from '../domain/export/clone-part/export-component';
 import { Export } from '../domain/export/export';
 import { ExportId } from '../domain/export/export.id';
 
@@ -17,7 +17,10 @@ export class RequestExport {
   ) {}
 
   async export(id: ResourceId, kind: ResourceKind): Promise<ExportId> {
-    const parts: ClonePart[] = await this.resourcePieces.resolveFor(id, kind);
+    const parts: ExportComponent[] = await this.resourcePieces.resolveFor(
+      id,
+      kind,
+    );
     const exportInstance = this.eventPublisher.mergeObjectContext(
       Export.project(id, parts),
     );

api/apps/api/src/modules/clone/export/application/resource-pieces.port.ts

@@ -1,7 +1,10 @@
 import { ResourceId } from '../domain/export/resource.id';
 import { ResourceKind } from '../domain/export/resource.kind';
-import { ClonePart } from '../domain/export/clone-part/clone-part';
+import { ExportComponent } from '../domain/export/clone-part/export-component';
 
 export abstract class ResourcePieces {
-  abstract resolveFor(id: ResourceId, kind: ResourceKind): Promise<ClonePart[]>;
+  abstract resolveFor(
+    id: ResourceId,
+    kind: ResourceKind,
+  ): Promise<ExportComponent[]>;
 }

api/apps/api/src/modules/clone/export/domain/events/clone-parts-finished.event.ts → api/apps/api/src/modules/clone/export/domain/events/export-component-finished.event.ts

@@ -1,6 +1,6 @@
 import { IEvent } from '@nestjs/cqrs';
 import { ExportId } from '../export/export.id';
 
-export class ClonePartsFinished implements IEvent {
+export class ExportComponentFinished implements IEvent {
   constructor(public readonly exportId: ExportId) {}
 }

api/apps/api/src/modules/clone/export/domain/events/clone-part-requested.event.ts → api/apps/api/src/modules/clone/export/domain/events/export-component-requested.event.ts

@@ -5,7 +5,7 @@ import { PieceId } from '../export/clone-part/piece.id';
 import { ResourceId } from '../export/resource.id';
 import { ClonePiece } from '../../../shared-kernel/clone-piece';
 
-export class ClonePartRequested implements IEvent {
+export class ExportComponentRequested implements IEvent {
   constructor(
     public readonly exportId: ExportId,
     public readonly pieceId: PieceId,

api/apps/api/src/modules/clone/export/domain/export/clone-part.snapshot.ts → api/apps/api/src/modules/clone/export/domain/export/export-component.snapshot.ts

@@ -1,6 +1,6 @@
 import { ClonePiece } from '../../../shared-kernel/clone-piece';
 
-export interface ClonePartSnapshot {
+export interface ExportComponentSnapshot {
   readonly id: string;
   readonly piece: ClonePiece;
   readonly resourceId: string;

api/apps/api/src/modules/clone/export/domain/export/clone-part/piece-location.ts → api/apps/api/src/modules/clone/export/domain/export/export-component/component-location.ts

@@ -3,4 +3,4 @@ import { TinyTypeOf } from 'tiny-types';
 /**
  * a URI pointing at the given Piece, whatever format it is
  */
-export class PieceLocation extends TinyTypeOf<string>() {}
+export class ComponentLocation extends TinyTypeOf<string>() {}

api/apps/api/src/modules/clone/export/domain/export/export-component/component.id.ts

@@ -0,0 +1,3 @@
+import { TinyTypeOf } from 'tiny-types';
+
+export class ComponentId extends TinyTypeOf<string>() {}

api/apps/api/src/modules/clone/export/domain/export/export-component/export-component.ts

@@ -0,0 +1,51 @@
+import { v4 } from 'uuid';
+import { ClonePiece } from '../../../../shared-kernel/clone-piece';
+
+import { ResourceId } from '../resource.id';
+import { ExportComponentSnapshot } from '../export-component.snapshot';
+
+import { ComponentId } from './component.id';
+import { ComponentLocation } from './component-location';
+
+export class ExportComponent {
+  private constructor(
+    readonly id: ComponentId,
+    readonly piece: ClonePiece,
+    readonly resourceId: ResourceId,
+    private finished: boolean = false,
+    private uri?: ComponentLocation,
+  ) {}
+
+  static newOne(resourceId: ResourceId, piece: ClonePiece): ExportComponent {
+    return new ExportComponent(new ComponentId(v4()), piece, resourceId);
+  }
+
+  finish(location: ComponentLocation) {
+    this.finished = true;
+    this.uri = location;
+  }
+
+  isReady() {
+    return this.finished;
+  }
+
+  toSnapshot(): ExportComponentSnapshot {
+    return {
+      id: this.id.value,
+      piece: this.piece,
+      resourceId: this.resourceId.value,
+      finished: this.finished,
+      uri: this.uri?.value,
+    };
+  }
+
+  static fromSnapshot(snapshot: ExportComponentSnapshot) {
+    return new ExportComponent(
+      new ComponentId(snapshot.id),
+      snapshot.piece,
+      new ResourceId(snapshot.resourceId),
+      snapshot.finished,
+      snapshot.uri ? new ComponentLocation(snapshot.uri) : undefined,
+    );
+  }
+}

api/apps/api/src/modules/clone/export/domain/export/export.snapshot.ts

@@ -1,10 +1,10 @@
 import { ResourceKind } from './resource.kind';
-import { ClonePartSnapshot } from './clone-part.snapshot';
+import { ExportComponentSnapshot } from './export-component.snapshot';
 
 export interface ExportSnapshot {
   id: string;
   resourceId: string;
   resourceKind: ResourceKind;
   archiveLocation?: string;
-  exportPieces: ClonePartSnapshot[];
+  exportPieces: ExportComponentSnapshot[];
 }

api/apps/api/src/modules/clone/export/domain/export/export.ts

@@ -7,13 +7,13 @@ import { ExportId } from './export.id';
 import { ResourceId } from './resource.id';
 import { ArchiveLocation } from './archive-location';
 
-import { ClonePartRequested } from '../events/clone-part-requested.event';
-import { ClonePartsFinished } from '../events/clone-parts-finished.event';
+import { ExportComponentRequested } from '../events/export-component-requested.event';
+import { ExportComponentFinished } from '../events/export-component-finished.event';
 import { ArchiveReady } from '../events/archive-ready.event';
 
-import { PieceLocation } from './clone-part/piece-location';
-import { ClonePart } from './clone-part/clone-part';
-import { PieceId } from './clone-part/piece.id';
+import { ComponentLocation } from './export-component/component-location';
+import { ExportComponent } from './export-component/export-component';
+import { ComponentId } from './export-component/component.id';
 import { ExportSnapshot } from './export.snapshot';
 
 export const pieceNotFound = Symbol('export piece not found');
@@ -24,13 +24,13 @@ export class Export extends AggregateRoot {
     public readonly id: ExportId,
     public readonly resourceId: ResourceId,
     public readonly resourceKind: ResourceKind,
-    public readonly pieces: ClonePart[],
+    public readonly pieces: ExportComponent[],
     private archiveLocation?: ArchiveLocation,
   ) {
     super();
   }
 
-  static project(id: ResourceId, parts: ClonePart[]): Export {
+  static project(id: ResourceId, parts: ExportComponent[]): Export {
     const exportRequest = new Export(
       new ExportId(v4()),
       id,
@@ -43,7 +43,7 @@ export class Export extends AggregateRoot {
         .filter((part) => !part.isReady())
         .map(
           (part) =>
-            new ClonePartRequested(
+            new ExportComponentRequested(
               exportRequest.id,
               part.id,
               part.resourceId,
@@ -55,9 +55,9 @@ export class Export extends AggregateRoot {
     return exportRequest;
   }
 
-  completePiece(
-    id: PieceId,
-    pieceLocation: PieceLocation,
+  completeComponent(
+    id: ComponentId,
+    pieceLocation: ComponentLocation,
   ): Either<typeof pieceNotFound, true> {
     const piece = this.pieces.find((piece) => piece.id.equals(id));
     if (!piece) {
@@ -66,7 +66,7 @@ export class Export extends AggregateRoot {
     piece.finish(pieceLocation);
 
     if (this.#allPiecesReady()) {
-      this.apply(new ClonePartsFinished(this.id));
+      this.apply(new ExportComponentFinished(this.id));
     }
 
     return right(true);
@@ -96,7 +96,7 @@ export class Export extends AggregateRoot {
       new ExportId(snapshot.id),
       new ResourceId(snapshot.resourceId),
       snapshot.resourceKind,
-      snapshot.exportPieces.map((piece) => ClonePart.fromSnapshot(piece)),
+      snapshot.exportPieces.map((piece) => ExportComponent.fromSnapshot(piece)),
       snapshot.archiveLocation
         ? new ArchiveLocation(snapshot.archiveLocation)
         : undefined,