@ibgib/core-gib 0.0.112 → 0.1.1

package/dist/witness/space/reconciliation-space/reconciliation-space-base.d.mts

@@ -0,0 +1,100 @@
+import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { IbGibAddr } from '@ibgib/ts-gib/dist/types.mjs';
+import { SpaceBase_V1 } from '../space-base-v1.mjs';
+import { IbGibSpaceData, IbGibSpaceOptionsData, IbGibSpaceOptionsRel8ns, IbGibSpaceOptionsIbGib, IbGibSpaceResultData, IbGibSpaceResultRel8ns, IbGibSpaceResultIbGib, IbGibSpaceRel8ns, IbGibSpaceOptionsCmd } from '../space-types.mjs';
+import { SyncSpaceOptionsCmdModifier, SyncSpaceOptionsIbGib, SyncStatusIbGib } from '../outer-space/outer-space-types.mjs';
+import { SubjectWitness } from '../../../common/pubsub/subject/subject-types.mjs';
+export interface ReconciliationSpaceData extends IbGibSpaceData {
+}
+export interface ReconciliationSpaceRel8ns extends IbGibSpaceRel8ns {
+}
+/**
+ * Base class for spaces that perform intelligent merging of ibgib timelines,
+ * whether it's a bi-directional sync, a one-way merge, or another custom
+ * reconciliation strategy.
+ *
+ * This class contains the core, backend-agnostic logic for timeline
+ * reconciliation. Concrete implementations must provide the primitive
+ * I/O functions for their specific backing store.
+ */
+export declare abstract class ReconciliationSpaceBase<TIbGib extends IbGib_V1 = IbGib_V1, TData extends ReconciliationSpaceData = ReconciliationSpaceData, TRel8ns extends ReconciliationSpaceRel8ns = ReconciliationSpaceRel8ns, TSpaceOptionsData extends IbGibSpaceOptionsData = IbGibSpaceOptionsData, TSpaceOptionsRel8ns extends IbGibSpaceOptionsRel8ns = IbGibSpaceOptionsRel8ns, TSpaceOptionsIbGib extends IbGibSpaceOptionsIbGib<TIbGib, TSpaceOptionsData, TSpaceOptionsRel8ns> = IbGibSpaceOptionsIbGib<TIbGib, TSpaceOptionsData, TSpaceOptionsRel8ns>, TSpaceResultData extends IbGibSpaceResultData = IbGibSpaceResultData, TSpaceResultRel8ns extends IbGibSpaceResultRel8ns = IbGibSpaceResultRel8ns, TSpaceResultIbGib extends IbGibSpaceResultIbGib<TIbGib, TSpaceResultData, TSpaceResultRel8ns> = IbGibSpaceResultIbGib<TIbGib, TSpaceResultData, TSpaceResultRel8ns>> extends SpaceBase_V1<TIbGib, TSpaceOptionsData, TSpaceOptionsRel8ns, TSpaceOptionsIbGib, TSpaceResultData, TSpaceResultRel8ns, TSpaceResultIbGib, TData, TRel8ns> {
+    protected lc: string;
+    protected abstract _getLatestAddrsInStore(ibGibs: TIbGib[]): Promise<{
+        [addr: string]: IbGibAddr | null;
+    }>;
+    protected abstract _getIbGibsFromStore(addrs: IbGibAddr[]): Promise<{
+        [addr: string]: TIbGib;
+    }>;
+    protected abstract _putIbGibsToStore(ibGibs: TIbGib[]): Promise<void>;
+    protected abstract _deleteIbGibsFromStore(addrs: IbGibAddr[]): Promise<void>;
+    protected spinOffToCompleteSync({ srcSpaceId, sagaId, ibGibs, statusStartIbGibs, syncStatusIbGib_Start, syncStatus$, errors, warnings, }: {
+        srcSpaceId: string;
+        sagaId: string;
+        ibGibs: TIbGib[];
+        statusStartIbGibs: TIbGib[];
+        syncStatusIbGib_Start: SyncStatusIbGib;
+        syncStatus$: SubjectWitness<SyncStatusIbGib>;
+        errors: string[];
+        warnings: string[];
+    }): Promise<void>;
+    protected saveInStoreIfConfigAndPublishStatus({ statusIbGib, syncStatus$ }: {
+        statusIbGib: SyncStatusIbGib;
+        syncStatus$: SubjectWitness<SyncStatusIbGib>;
+    }): Promise<void>;
+    protected reconcile_UpdateStoreWithMoreRecentLocal({ tjpAddr, latestAddr_Store, tjpGroupAddrs_Local_Ascending, tjpGroupIbGibs_Local_Ascending, ibGibsToStore, updates, }: {
+        tjpAddr: IbGibAddr;
+        latestAddr_Store: IbGibAddr;
+        tjpGroupAddrs_Local_Ascending: IbGibAddr[];
+        tjpGroupIbGibs_Local_Ascending: TIbGib[];
+        ibGibsToStore: TIbGib[];
+        updates: {
+            [tjpAddr: string]: IbGibAddr;
+        };
+    }): void;
+    protected getDna(arg: {
+        ibGib: TIbGib;
+        throwOnDnaFail?: boolean;
+    }): Promise<TIbGib[]>;
+    protected reconcile_MergeLocalWithStore_ViaDna({ tjpAddr, latestAddr_Local, latestIbGib_Local, latestAddr_Store, latestIbGib_Store, ibGibsCreated, ibGibMergeMap, ibGibsOnlyInStore, allLocalIbGibs, updates, timeLogName, }: {
+        tjpAddr: IbGibAddr;
+        latestAddr_Local: IbGibAddr;
+        latestIbGib_Local: TIbGib;
+        latestAddr_Store: IbGibAddr;
+        latestIbGib_Store: TIbGib;
+        ibGibsCreated: TIbGib[];
+        ibGibsOnlyInStore: TIbGib[];
+        ibGibMergeMap: {
+            [oldLatestAddr: string]: TIbGib;
+        };
+        allLocalIbGibs: TIbGib[];
+        updates: {
+            [tjpAddr: string]: IbGibAddr;
+        };
+        timeLogName: string;
+    }): Promise<void>;
+    protected reconcile_MergeLocalWithStore_ViaState({ tjpAddr, latestIbGib_Local, latestAddr_Local, latestAddr_Store, ibGibsCreated, ibGibMergeMap, updates, }: {
+        tjpAddr: IbGibAddr;
+        latestIbGib_Local: TIbGib;
+        latestAddr_Local: IbGibAddr;
+        latestAddr_Store: IbGibAddr;
+        ibGibsCreated: TIbGib[];
+        ibGibMergeMap: {
+            [oldLatestAddr: string]: TIbGib;
+        };
+        updates: {
+            [tjpAddr: string]: IbGibAddr;
+        };
+    }): Promise<void>;
+    protected reconcile_InsertFirstTimeIntoStore({ tjpGroupIbGibs_Local_Ascending, ibGibsToStore, }: {
+        tjpGroupIbGibs_Local_Ascending: TIbGib[];
+        ibGibsToStore: TIbGib[];
+    }): Promise<void>;
+    protected routeAndDoCommand<TCmdModifier extends SyncSpaceOptionsCmdModifier = SyncSpaceOptionsCmdModifier>({ cmd, cmdModifiers, arg, }: {
+        cmd: IbGibSpaceOptionsCmd | string;
+        cmdModifiers: (TCmdModifier | string)[];
+        arg: TSpaceOptionsIbGib;
+    }): Promise<TSpaceResultIbGib | undefined>;
+    protected putSync(arg: SyncSpaceOptionsIbGib): Promise<IbGibSpaceResultIbGib<TIbGib, IbGibSpaceResultData, IbGibSpaceResultRel8ns>>;
+    private getStatusIbGibs_Start;
+}
+//# sourceMappingURL=reconciliation-space-base.d.mts.map

package/dist/witness/space/reconciliation-space/reconciliation-space-base.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation-space-base.d.mts","sourceRoot":"","sources":["../../../../src/witness/space/reconciliation-space/reconciliation-space-base.mts"],"names":[],"mappings":"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"}