spasm.js 2.0.0-beta.4 → 2.0.0-beta.6

package/README.md

@@ -267,6 +267,7 @@ Option 1. Import separate functions:
 const {identifyObject} = require('spasm.js')
 const {convertToSpasm} = require('spasm.js')
 const {mergeSpasmEventsV2} = require('spasm.js')
+const {mergeDifferentSpasmEventsV2} = require('spasm.js')
 
 const event = {
   // some event
@@ -279,9 +280,15 @@ const info = identifyObject(event)
 const spasmEvent = convertToSpasm(event)
 
 // Merge events into one event
-const spasmEvent = mergeSpasmEventsV2(
+const spasmEvent = mergeSpasmEventsV2([
   event, eventWithStats, eventWithComments
-)
+])
+
+// Merge different events
+const spasmEvents = mergeDifferentSpasmEventsV2([
+  event, eventWithStats, eventWithComments,
+  anotherEvent, anotherEventWithStats
+])
 ```
 
 Option 2. Import all functions:
@@ -300,9 +307,15 @@ const info = spasm.identifyObject(event)
 const spasmEvent = spasm.convertToSpasm(event)
 
 // Merge events into one event
-const spasmEvent = spasm.mergeSpasmEventsV2(
+const spasmEvent = spasm.mergeSpasmEventsV2([
   event, eventWithStats, eventWithComments
-)
+])
+
+// Merge different events
+const spasmEvents = spasm.mergeDifferentSpasmEventsV2([
+  event, eventWithStats, eventWithComments,
+  anotherEvent, anotherEventWithStats
+])
 ```
 
 #### ESM (import)
@@ -392,6 +405,38 @@ const rootIds = spasm.getAllRootIds(event)
 const signatures = spasm.getAllSignatures(event)
 ```
 
+```js
+// Get a stat object of a specified action
+const stats = spasm.getStatByAction(event, "react")
+```
+
+```js
+// Get a total number of a specified action
+const stats = spasm.getTotalOfAction(event, "reply")
+```
+
+```js
+// Get a total number of a specified reaction
+const stats = spasm.getTotalOfReaction(event, "upvote")
+```
+
+```js
+// Get a total number of the most popular reaction
+const stats = spasm.getTotalOfMostPopularReaction(event)
+```
+
+```js
+// Get a total number of a react/reply action
+const stats = spasm.getTotalOfReact(event)
+const stats = spasm.getTotalOfReply(event)
+
+// aliases
+const stats = spasm.getTotalOfActionReact(event)
+const stats = spasm.getTotalOfReactAction(event)
+const stats = spasm.getTotalOfActionReply(event)
+const stats = spasm.getTotalOfReplyAction(event)
+```
+
 ```js
 // Extract an ID from an event.
 const nostrId = spasm.getIdByFormat(event, { name: "nostr-hex" })

package/lib.commonjs/utils/utils.d.ts

@@ -1,6 +1,11 @@
 import { UnknownPostOrEvent, UnknownEvent, NostrSpasmEvent, NostrSpasmEventSignedOpened, NostrSpasmVersion, LinkObject, SpasmEventIdFormatV2, SpasmEventAddressFormatV2, SpasmEventSignatureFormatV2, SpasmEventV2, SpasmEventAuthorV2, SpasmEventBodyHostV2, SpasmEventMediaV2, SpasmEventIdV2, SpasmEventBodyReferenceV2, SpasmEventBodyParentV2, ConvertToSpasmConfig, CustomConvertToSpasmConfig, CustomSanitizationConfig, SanitizationConfig, UnknownEventV2, SpasmEventStatV2, SpasmEventChildV2 } from "./../types/interfaces.js";
 export declare const hasValue: (el?: any) => boolean;
+export declare const isStringOrNumber: (val: any) => boolean;
+export declare const isNumberOrString: (val: any) => boolean;
+export declare const ifStringOrNumber: (val: any) => boolean;
+export declare const ifNumberOrString: (val: any) => boolean;
 export declare const isObjectWithValues: (val: any) => boolean;
+export declare const isArrayWithValues: (array: any) => boolean;
 export declare const extractVersion: (versionString: string) => string;
 export declare const extractSealedEvent: (unknownPostOrEvent: UnknownPostOrEvent) => UnknownEvent | false;
 export declare const toBeTimestamp: (time: any) => number | undefined;
@@ -58,6 +63,16 @@ export declare const getAllRootIds: (unknownEvent: UnknownEventV2, toLowerCase?:
 export declare const getAllSignatures: (unknownEvent: UnknownEventV2, toLowerCase?: boolean) => (string | number)[];
 export declare const getSignersListedIn: (unknownEvent: UnknownEventV2, list: (string | number)[]) => (string | number)[];
 export declare const getPubkeysListedIn: (unknownEvent: UnknownEventV2, list: (string | number)[]) => (string | number)[];
+export declare const getStatByAction: (unknownEvent: any, action?: string | number) => SpasmEventStatV2 | null;
+export declare const getTotalOfReaction: (unknownEvent: any, reaction?: string | number) => number;
+export declare const getTotalOfMostPopularReaction: (unknownEvent: any) => number;
+export declare const getTotalOfAction: (unknownEvent: any, action?: string | number) => number;
+export declare const getTotalOfReply: (unknownEvent: any) => number;
+export declare const getTotalOfReplyAction: (unknownEvent: any) => number;
+export declare const getTotalOfActionReply: (unknownEvent: any) => number;
+export declare const getTotalOfReact: (unknownEvent: any) => number;
+export declare const getTotalOfReactAction: (unknownEvent: any) => number;
+export declare const getTotalOfActionReact: (unknownEvent: any) => number;
 export declare const isAnySignerListedIn: (unknownEvent: UnknownEventV2, list: (string | number)[]) => boolean;
 export declare const isAnyPubkeyListedIn: (unknownEvent: UnknownEventV2, list: (string | number)[]) => boolean;
 export declare const areAllSignersListedIn: (unknownEvent: UnknownEventV2, list: (string | number)[]) => boolean;
@@ -66,9 +81,12 @@ export declare const getIdByFormat: (unknownEvent: UnknownEventV2, customIdForma
 export declare const extractIdByFormat: (unknownEvent: UnknownEventV2, customIdFormat?: SpasmEventIdFormatV2) => string | number | null;
 export declare const extractSpasmId01: (unknownEvent: UnknownEventV2) => string | number;
 export declare const toBeSpasmEventV2: (unknownEvent: UnknownEventV2) => SpasmEventV2 | null;
+export declare const toBeSpasmEventsV2: (unknownEvents: any[]) => SpasmEventV2[] | null;
 export declare const extractSignerFromEthereumSignature: (signedString: string, signature: string) => string | null;
 export declare const mergeSpasmEventsV2: (spasmEvents: any[], depth?: number) => SpasmEventV2 | null;
 export declare const mergeDifferentSpasmEventsV2: (unknownEvents: any[], depth?: number) => SpasmEventV2[] | null;
+export declare const sortSpasmEventsV2ByDbAddedTimestamp: (unknownEvents: any[], order?: "asc" | "desc") => SpasmEventV2[] | null;
+export declare const sortSpasmEventsV2: (unknownEvents: any[], order?: "asc" | "desc") => SpasmEventV2[] | null;
 export declare const ifEventsHaveSameSpasmId01: (event1: UnknownEventV2, event2: UnknownEventV2) => Boolean;
 export declare const deepCopyOfObject: (obj: any) => any;
 export declare const copyOf: (obj: any) => any;

package/lib.commonjs/utils/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src.ts/utils/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src.ts/utils/utils.ts"],"names":[],"mappings":"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"}

package/lib.commonjs/utils/utils.js

@@ -23,8 +23,8 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAllSigners = exports.hasSiblingWeb2 = exports.hasSiblingNostr = exports.hasSiblingDmp = exports.hasSiblingSpasm = exports.hasSiblingOfProtocol = exports.hasSignatureNostr = exports.hasSignatureEthereum = exports.hasSignatureOfFormat = exports.mergeSanitizationConfigs = exports.mergeConfigs = exports.mergeObjects = exports.clearObject = exports.clearArray = exports.sanitizeEvent = exports.sanitizeEventWithDompurify = exports.sanitizeStringWithDompurify = exports.sanitizeEventWith = exports.executeFunctionForAllNestedValuesOfType = exports.utilsStatus = exports.verifyEthereumSignature = exports.markSpasmEventAddressAsVerified = exports.sortTagsForSpasmid01 = exports.sortParentForSpasmid01 = exports.sortReferencesForSpasmid01 = exports.sortMediasForSpasmid01 = exports.sortLinksForSpasmid01 = exports.sortLinksForSpasmEventV2 = exports.sortHostsForSpasmid01 = exports.sortHostsForSpasmEventV2 = exports.sortArrayOfObjectsByKeyValue = exports.sortAuthorsForSpasmid01 = exports.sortAuthorsForSpasmEventV2 = exports.sortArrayOfObjects = exports.sortArrayOfStringsAndNumbers = exports.keepTheseKeysInObjectsInArray = exports.keepTheseKeysInObject = exports.getHashOfString = exports.getFormatFromSignature = exports.getFormatFromAddress = exports.getFormatFromId = exports.getFormatFromValue = exports.createLinkObjectFromUrl = exports.isValidUrl = exports.getNostrSpasmVersion = exports.toBeTimestamp = exports.extractSealedEvent = exports.extractVersion = exports.isObjectWithValues = exports.hasValue = void 0;
-exports.mergeChildrenV2 = exports.mergeStatsV2 = exports.cleanSpasmEventV2 = exports.copyOf = exports.deepCopyOfObject = exports.ifEventsHaveSameSpasmId01 = exports.mergeDifferentSpasmEventsV2 = exports.mergeSpasmEventsV2 = exports.extractSignerFromEthereumSignature = exports.toBeSpasmEventV2 = exports.extractSpasmId01 = exports.extractIdByFormat = exports.getIdByFormat = exports.areAllPubkeysListedIn = exports.areAllSignersListedIn = exports.isAnyPubkeyListedIn = exports.isAnySignerListedIn = exports.getPubkeysListedIn = exports.getSignersListedIn = exports.getAllSignatures = exports.getAllRootIds = exports.getAllParentIds = exports.getAllEventIds = exports.getAllIdsFromArrayOfIdObjects = exports.getVerifiedSigners = void 0;
+exports.hasSiblingOfProtocol = exports.hasSignatureNostr = exports.hasSignatureEthereum = exports.hasSignatureOfFormat = exports.mergeSanitizationConfigs = exports.mergeConfigs = exports.mergeObjects = exports.clearObject = exports.clearArray = exports.sanitizeEvent = exports.sanitizeEventWithDompurify = exports.sanitizeStringWithDompurify = exports.sanitizeEventWith = exports.executeFunctionForAllNestedValuesOfType = exports.utilsStatus = exports.verifyEthereumSignature = exports.markSpasmEventAddressAsVerified = exports.sortTagsForSpasmid01 = exports.sortParentForSpasmid01 = exports.sortReferencesForSpasmid01 = exports.sortMediasForSpasmid01 = exports.sortLinksForSpasmid01 = exports.sortLinksForSpasmEventV2 = exports.sortHostsForSpasmid01 = exports.sortHostsForSpasmEventV2 = exports.sortArrayOfObjectsByKeyValue = exports.sortAuthorsForSpasmid01 = exports.sortAuthorsForSpasmEventV2 = exports.sortArrayOfObjects = exports.sortArrayOfStringsAndNumbers = exports.keepTheseKeysInObjectsInArray = exports.keepTheseKeysInObject = exports.getHashOfString = exports.getFormatFromSignature = exports.getFormatFromAddress = exports.getFormatFromId = exports.getFormatFromValue = exports.createLinkObjectFromUrl = exports.isValidUrl = exports.getNostrSpasmVersion = exports.toBeTimestamp = exports.extractSealedEvent = exports.extractVersion = exports.isArrayWithValues = exports.isObjectWithValues = exports.ifNumberOrString = exports.ifStringOrNumber = exports.isNumberOrString = exports.isStringOrNumber = exports.hasValue = void 0;
+exports.mergeChildrenV2 = exports.mergeStatsV2 = exports.cleanSpasmEventV2 = exports.copyOf = exports.deepCopyOfObject = exports.ifEventsHaveSameSpasmId01 = exports.sortSpasmEventsV2 = exports.sortSpasmEventsV2ByDbAddedTimestamp = exports.mergeDifferentSpasmEventsV2 = exports.mergeSpasmEventsV2 = exports.extractSignerFromEthereumSignature = exports.toBeSpasmEventsV2 = exports.toBeSpasmEventV2 = exports.extractSpasmId01 = exports.extractIdByFormat = exports.getIdByFormat = exports.areAllPubkeysListedIn = exports.areAllSignersListedIn = exports.isAnyPubkeyListedIn = exports.isAnySignerListedIn = exports.getTotalOfActionReact = exports.getTotalOfReactAction = exports.getTotalOfReact = exports.getTotalOfActionReply = exports.getTotalOfReplyAction = exports.getTotalOfReply = exports.getTotalOfAction = exports.getTotalOfMostPopularReaction = exports.getTotalOfReaction = exports.getStatByAction = exports.getPubkeysListedIn = exports.getSignersListedIn = exports.getAllSignatures = exports.getAllRootIds = exports.getAllParentIds = exports.getAllEventIds = exports.getAllIdsFromArrayOfIdObjects = exports.getVerifiedSigners = exports.getAllSigners = exports.hasSiblingWeb2 = exports.hasSiblingNostr = exports.hasSiblingDmp = exports.hasSiblingSpasm = void 0;
 /*
  * Using sha256 from 'js-sha256' npm package, because
  * built-in 'crypto' module works only in a server-side
@@ -92,6 +92,19 @@ const hasValue = (el) => {
     return true;
 };
 exports.hasValue = hasValue;
+const isStringOrNumber = (val) => {
+    if (!val && val !== 0)
+        return false;
+    if (typeof (val) === "string")
+        return true;
+    if (typeof (val) === "number")
+        return true;
+    return false;
+};
+exports.isStringOrNumber = isStringOrNumber;
+exports.isNumberOrString = exports.isStringOrNumber;
+exports.ifStringOrNumber = exports.isStringOrNumber;
+exports.ifNumberOrString = exports.isStringOrNumber;
 const isObjectWithValues = (val) => {
     if (!val)
         return false;
@@ -104,6 +117,16 @@ const isObjectWithValues = (val) => {
     return true;
 };
 exports.isObjectWithValues = isObjectWithValues;
+const isArrayWithValues = (array) => {
+    if (!array)
+        return false;
+    if (!Array.isArray(array))
+        return false;
+    if (!(0, exports.hasValue)(array))
+        return false;
+    return true;
+};
+exports.isArrayWithValues = isArrayWithValues;
 const extractVersion = (versionString) => {
     if (!versionString ||
         typeof (versionString) !== "string")
@@ -1200,6 +1223,126 @@ const getSignersListedIn = (unknownEvent, list) => {
 };
 exports.getSignersListedIn = getSignersListedIn;
 exports.getPubkeysListedIn = exports.getSignersListedIn;
+const getStatByAction = (unknownEvent, action = "react") => {
+    if (!action || !exports.isStringOrNumber) {
+        return null;
+    }
+    const spasmEvent = (0, exports.toBeSpasmEventV2)(unknownEvent);
+    if (!spasmEvent || !(0, exports.isObjectWithValues)(spasmEvent)) {
+        return null;
+    }
+    if (!("stats" in spasmEvent) || !spasmEvent.stats) {
+        return null;
+    }
+    let spasmEventStat = null;
+    spasmEvent.stats?.forEach(stat => {
+        if ((0, exports.isObjectWithValues)(stat) &&
+            "action" in stat && stat.action &&
+            stat.action === action) {
+            spasmEventStat = stat;
+        }
+    });
+    return spasmEventStat;
+};
+exports.getStatByAction = getStatByAction;
+const getTotalOfReaction = (unknownEvent, reaction = "upvote") => {
+    if (!reaction || !exports.isStringOrNumber) {
+        return 0;
+    }
+    const spasmEvent = (0, exports.toBeSpasmEventV2)(unknownEvent);
+    if (!spasmEvent || !(0, exports.isObjectWithValues)(spasmEvent)) {
+        return 0;
+    }
+    const reactionStat = (0, exports.getStatByAction)(spasmEvent, "react");
+    if (!reactionStat) {
+        return 0;
+    }
+    if (!("contents" in reactionStat) || !reactionStat.contents ||
+        !(0, exports.isArrayWithValues)(reactionStat.contents)) {
+        return 0;
+    }
+    let total = 0;
+    reactionStat.contents.forEach(content => {
+        if ("value" in content && content.value &&
+            content.value === reaction &&
+            "total" in content && content.total) {
+            if (typeof (content.total) === "number") {
+                total = content.total;
+            }
+            else if (typeof (content.total) === "string") {
+                total = Number(content.total);
+            }
+        }
+    });
+    return total;
+};
+exports.getTotalOfReaction = getTotalOfReaction;
+const getTotalOfMostPopularReaction = (unknownEvent) => {
+    const spasmEvent = (0, exports.toBeSpasmEventV2)(unknownEvent);
+    if (!spasmEvent || !(0, exports.isObjectWithValues)(spasmEvent)) {
+        return 0;
+    }
+    const reactionStat = (0, exports.getStatByAction)(spasmEvent, "react");
+    if (!reactionStat) {
+        return 0;
+    }
+    if (!("contents" in reactionStat) || !reactionStat.contents ||
+        !(0, exports.isArrayWithValues)(reactionStat.contents)) {
+        return 0;
+    }
+    let total = 0;
+    reactionStat.contents.forEach(content => {
+        if ("total" in content && content.total) {
+            let newTotal = 0;
+            if (typeof (content.total) === "number") {
+                newTotal = content.total;
+            }
+            else if (typeof (content.total) === "string") {
+                newTotal = Number(content.total);
+            }
+            if (newTotal > total) {
+                total = newTotal;
+            }
+        }
+    });
+    return total;
+};
+exports.getTotalOfMostPopularReaction = getTotalOfMostPopularReaction;
+const getTotalOfAction = (unknownEvent, action = "reply") => {
+    if (!action || !exports.isStringOrNumber) {
+        return 0;
+    }
+    const spasmEvent = (0, exports.toBeSpasmEventV2)(unknownEvent);
+    if (!spasmEvent || !(0, exports.isObjectWithValues)(spasmEvent)) {
+        return 0;
+    }
+    const actionStat = (0, exports.getStatByAction)(spasmEvent, action);
+    if (!actionStat) {
+        return 0;
+    }
+    if ("total" in actionStat && actionStat.total) {
+        if (typeof (actionStat.total) === "number") {
+            return actionStat.total;
+        }
+        else if (typeof (actionStat.total) === "string") {
+            return Number(actionStat.total);
+        }
+    }
+    return 0;
+};
+exports.getTotalOfAction = getTotalOfAction;
+const getTotalOfReply = (unknownEvent) => {
+    return (0, exports.getTotalOfAction)(unknownEvent, "reply");
+};
+exports.getTotalOfReply = getTotalOfReply;
+exports.getTotalOfReplyAction = exports.getTotalOfReply;
+exports.getTotalOfActionReply = exports.getTotalOfReply;
+const getTotalOfReact = (unknownEvent) => {
+    return (0, exports.getTotalOfAction)(unknownEvent, "react");
+};
+exports.getTotalOfReact = getTotalOfReact;
+exports.getTotalOfReactAction = exports.getTotalOfReact;
+exports.getTotalOfActionReact = exports.getTotalOfReact;
 const isAnySignerListedIn = (unknownEvent, list) => {
     const signersListedIn = (0, exports.getSignersListedIn)(unknownEvent, list);
     if (signersListedIn &&
@@ -1327,6 +1470,22 @@ const toBeSpasmEventV2 = (unknownEvent) => {
     return null;
 };
 exports.toBeSpasmEventV2 = toBeSpasmEventV2;
+const toBeSpasmEventsV2 = (unknownEvents) => {
+    if (!unknownEvents || !Array.isArray(unknownEvents))
+        return null;
+    let spasmEvents = [];
+    unknownEvents.forEach(event => {
+        const spasmEvent = (0, exports.toBeSpasmEventV2)(event);
+        if (spasmEvent && (0, exports.isObjectWithValues)(spasmEvent)) {
+            spasmEvents.push(spasmEvent);
+        }
+    });
+    if (!spasmEvents[0] ||
+        !(0, exports.isObjectWithValues)(spasmEvents[0]))
+        return null;
+    return spasmEvents;
+};
+exports.toBeSpasmEventsV2 = toBeSpasmEventsV2;
 const extractSignerFromEthereumSignature = (signedString, signature) => {
     try {
         if (signature && typeof (signature) === 'string') {
@@ -1683,16 +1842,8 @@ const mergeDifferentSpasmEventsV2 = (unknownEvents, depth = 0) => {
     if (depth > maxRecursionDepth) {
         throw new Error("Maximum recursion depth exceeded");
     }
-    if (!unknownEvents || !Array.isArray(unknownEvents))
-        return null;
-    let spasmEvents = [];
-    unknownEvents.forEach(event => {
-        const spasmEvent = (0, exports.toBeSpasmEventV2)(event);
-        if (spasmEvent && (0, exports.isObjectWithValues)(spasmEvent)) {
-            spasmEvents.push(spasmEvent);
-        }
-    });
-    if (!spasmEvents[0] ||
+    const spasmEvents = (0, exports.toBeSpasmEventsV2)(unknownEvents);
+    if (!spasmEvents || !spasmEvents[0] ||
         !(0, exports.isObjectWithValues)(spasmEvents[0]))
         return null;
     const uniqueIds = new Set();
@@ -1729,7 +1880,7 @@ const mergeDifferentSpasmEventsV2 = (unknownEvents, depth = 0) => {
                                                 typeof (uniqueEventId.value) === "number")) {
                                             if (uniqueEventId.value === id.value) {
                                                 const mergedEvent = (0, exports.mergeSpasmEventsV2)([
-                                                    uniqueEvent, event
+                                                    uniqueEvent, event, depth
                                                 ]);
                                                 if (mergedEvent) {
                                                     uniqueEvents[uniqueEventIndex] =
@@ -1757,6 +1908,66 @@ const mergeDifferentSpasmEventsV2 = (unknownEvents, depth = 0) => {
     }
 };
 exports.mergeDifferentSpasmEventsV2 = mergeDifferentSpasmEventsV2;
+const sortSpasmEventsV2ByDbAddedTimestamp = (unknownEvents, order = "desc") => {
+    const spasmEvents = (0, exports.toBeSpasmEventsV2)(unknownEvents);
+    if (!spasmEvents || !spasmEvents[0] ||
+        !(0, exports.isObjectWithValues)(spasmEvents[0]))
+        return null;
+    try {
+        const spasmEventsWithDbTimestamp = [];
+        const spasmEventsWithoutDbTimestamp = [];
+        // Events without db.addedTimestamp are moved into a separate
+        // array which is joined with the sorted array at the end.
+        spasmEvents.forEach(event => {
+            if ('db' in event && event.db &&
+                'addedTimestamp' in event.db &&
+                event.db.addedTimestamp &&
+                typeof (event.db.addedTimestamp) === "number") {
+                spasmEventsWithDbTimestamp.push(event);
+            }
+            else {
+                spasmEventsWithoutDbTimestamp.push(event);
+            }
+        });
+        spasmEventsWithDbTimestamp.sort((a, b) => {
+            if (a.db?.addedTimestamp && b.db?.addedTimestamp) {
+                if (order === "desc") {
+                    const result = String(b.db.addedTimestamp)
+                        .localeCompare(String(a.db.addedTimestamp));
+                    return result;
+                }
+                else if (order === "asc") {
+                    const result = String(a.db.addedTimestamp)
+                        .localeCompare(String(b.db.addedTimestamp));
+                    return result;
+                }
+            }
+            // Ideally, return 1 should never happen because we've
+            // filtered out events without db.addedTimestamp above.
+            // In case if we missed some scenarios,
+            // then 'return 1' should push an element without
+            // db.addedTimestamp to the end of the array,
+            // but it can still mess up the sorting.
+            return 1;
+        });
+        const sortedSpasmEvents = [
+            ...spasmEventsWithDbTimestamp,
+            ...spasmEventsWithoutDbTimestamp
+        ];
+        if ((0, exports.isArrayWithValues)(sortedSpasmEvents)) {
+            return sortedSpasmEvents;
+        }
+        else {
+            return null;
+        }
+    }
+    catch (err) {
+        console.error(err);
+        return null;
+    }
+};
+exports.sortSpasmEventsV2ByDbAddedTimestamp = sortSpasmEventsV2ByDbAddedTimestamp;
+exports.sortSpasmEventsV2 = exports.sortSpasmEventsV2ByDbAddedTimestamp;
 const ifEventsHaveSameSpasmId01 = (event1, event2) => {
     if (!event1 || !event2)
         return false;