@punks/backend-core 0.0.27 → 0.0.29

package/dist/esm/types/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./abstractions";
 export * from "./logging";
+export * from "./models";
 export * from "./types";
 export * from "./utils";

package/dist/esm/types/models/index.d.ts

@@ -0,0 +1 @@
+export * from "./trees";

package/dist/esm/types/models/trees.d.ts

@@ -0,0 +1,8 @@
+export interface ITreeNode<TKey, TValue> {
+    id: TKey;
+    value: TValue;
+    children: ITreeNode<TKey, TValue>[];
+}
+export interface ITree<TKey, TValue> {
+    root: ITreeNode<TKey, TValue>[];
+}

package/dist/esm/types/utils/array.d.ts

@@ -21,4 +21,5 @@ export declare const distinct: <T>(values: T[]) => T[];
 export declare const distinctElements: <T>(values: T[], comparer: (value: T) => any) => T[];
 export declare const jsonDistinct: <T>(values: T[]) => T[];
 export declare const iterate: <T>(values: T[], action: (item: T, next?: T | undefined, prev?: T | undefined) => void) => void;
+export declare const groupBy: <TKey, TValue>(values: TValue[], keySelector: (value: TValue) => TKey) => Map<TKey, TValue[]>;
 export {};

package/dist/esm/types/utils/index.d.ts

@@ -6,6 +6,7 @@ export * from "./strings";
 export * from "./objects";
 export * from "./text";
 export * from "./threading";
+export { buildTree, TreeNodeBuilder } from "./trees";
 export * from "./mappings";
 export * from "./uid";
 export { ExcelSheetDefinition, ExcelKeyTransform, ExcelColumnDefinition as ExcelRowBuilder, ExcelParseOptions, excelBuild, excelParse, } from "./xls";

package/dist/esm/types/utils/objects.d.ts

@@ -2,3 +2,7 @@ export declare const removeUndefinedProps: <T extends Record<string, any>>(obj:
     recursive?: boolean;
 }) => T;
 export declare const isNullOrUndefined: (value: any) => boolean;
+export declare const buildObject: <T>(...props: {
+    key: string;
+    value: any;
+}[]) => T;

package/dist/esm/types/utils/trees.d.ts

@@ -0,0 +1,7 @@
+import { ITree, ITreeNode } from "../models";
+export type TreeNodeBuilder<TKey, TRecord, TTreeNode extends ITreeNode<TKey, TRecord>> = {
+    idSelector: (record: TRecord) => TKey;
+    parentIdSelector: (record: TRecord) => TKey | undefined;
+    additionalPropsBuilder?: (record: TRecord, ancestors: TRecord[], children: TRecord[]) => Promise<Omit<TTreeNode, "id" | "children" | "value">>;
+};
+export declare const buildTree: <TKey, TRecord, TTreeNode extends ITreeNode<TKey, TRecord>>(data: TRecord[], nodeBuilder: TreeNodeBuilder<TKey, TRecord, TTreeNode>) => Promise<ITree<TKey, TRecord>>;

package/dist/esm/types/utils/trees.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -42,6 +42,15 @@ declare class Log {
     static getLogger(loggerName: string): ILogger;
 }
 
+interface ITreeNode<TKey, TValue> {
+    id: TKey;
+    value: TValue;
+    children: ITreeNode<TKey, TValue>[];
+}
+interface ITree<TKey, TValue> {
+    root: ITreeNode<TKey, TValue>[];
+}
+
 type RichText = PortableTextBlock[];
 
 declare const range: (start: number, end: number) => number[];
@@ -67,6 +76,7 @@ declare const distinct: <T>(values: T[]) => T[];
 declare const distinctElements: <T>(values: T[], comparer: (value: T) => any) => T[];
 declare const jsonDistinct: <T>(values: T[]) => T[];
 declare const iterate: <T>(values: T[], action: (item: T, next?: T | undefined, prev?: T | undefined) => void) => void;
+declare const groupBy: <TKey, TValue>(values: TValue[], keySelector: (value: TValue) => TKey) => Map<TKey, TValue[]>;
 
 declare const csvParse: (data: string | string[] | Buffer, separator?: string) => Record<string, any>[];
 interface CsvColumnDefinition<T> {
@@ -101,11 +111,22 @@ declare const removeUndefinedProps: <T extends Record<string, any>>(obj: T, opti
     recursive?: boolean;
 }) => T;
 declare const isNullOrUndefined: (value: any) => boolean;
+declare const buildObject: <T>(...props: {
+    key: string;
+    value: any;
+}[]) => T;
 
 declare const pluralize: (word: string) => string;
 
 declare function sleep(ms: number): Promise<unknown>;
 
+type TreeNodeBuilder<TKey, TRecord, TTreeNode extends ITreeNode<TKey, TRecord>> = {
+    idSelector: (record: TRecord) => TKey;
+    parentIdSelector: (record: TRecord) => TKey | undefined;
+    additionalPropsBuilder?: (record: TRecord, ancestors: TRecord[], children: TRecord[]) => Promise<Omit<TTreeNode, "id" | "children" | "value">>;
+};
+declare const buildTree: <TKey, TRecord, TTreeNode extends ITreeNode<TKey, TRecord>>(data: TRecord[], nodeBuilder: TreeNodeBuilder<TKey, TRecord, TTreeNode>) => Promise<ITree<TKey, TRecord>>;
+
 declare const mapOrThrow: <T>({ mapper, throw: throwFn, }: {
     mapper: () => T | undefined;
     throw: () => void;
@@ -134,4 +155,4 @@ type ExcelParseOptions = {
 };
 declare const excelParse: (file: string | ArrayBuffer, options?: ExcelParseOptions) => any[];
 
-export { CsvColumnDefinition as ColumnDefinition, CsvBuildOptions, Dict, ExcelKeyTransform, ExcelParseOptions, ExcelColumnDefinition as ExcelRowBuilder, ExcelSheetDefinition, ILogger, ILoggerProvider, IResolveServiceOptions, IServiceLocator, Log, LogLevel, RichText, byField, byFieldDesc, camelToKebabCase, camelToSnakeCase, csvBuild, csvParse, distinct, distinctElements, ensureDirectory, ensureStartSlash, ensureTailingSlash, excelBuild, excelParse, first, flatten, getDirectoryFilePaths, getDirectoryPath, indexes, isNullOrUndefined, iterate, joinPath, jsonDistinct, last, mapOrThrow, newUuid, notNull, notUndefined, pluralize, range, removeUndefinedProps, selectMany, sleep, sort, splitPath, toCamelCase, toDict, toItemsDict, toItemsMap, toMap, toTitleCase, trim, trimEnd, trimStart };
+export { CsvColumnDefinition as ColumnDefinition, CsvBuildOptions, Dict, ExcelKeyTransform, ExcelParseOptions, ExcelColumnDefinition as ExcelRowBuilder, ExcelSheetDefinition, ILogger, ILoggerProvider, IResolveServiceOptions, IServiceLocator, ITree, ITreeNode, Log, LogLevel, RichText, TreeNodeBuilder, buildObject, buildTree, byField, byFieldDesc, camelToKebabCase, camelToSnakeCase, csvBuild, csvParse, distinct, distinctElements, ensureDirectory, ensureStartSlash, ensureTailingSlash, excelBuild, excelParse, first, flatten, getDirectoryFilePaths, getDirectoryPath, groupBy, indexes, isNullOrUndefined, iterate, joinPath, jsonDistinct, last, mapOrThrow, newUuid, notNull, notUndefined, pluralize, range, removeUndefinedProps, selectMany, sleep, sort, splitPath, toCamelCase, toDict, toItemsDict, toItemsMap, toMap, toTitleCase, trim, trimEnd, trimStart };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punks/backend-core",
-  "version": "0.0.27",
+  "version": "0.0.29",
   "description": "WebPunks Backend Core",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",