@punks/backend-core 0.0.28 → 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/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> {
@@ -110,6 +120,13 @@ 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;
@@ -138,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, buildObject, 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.28",
+  "version": "0.0.29",
   "description": "WebPunks Backend Core",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",