@punks/backend-core 0.0.15 → 0.0.17

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

@@ -0,0 +1,9 @@
+export declare const csvParseRaw: (rows: string[], separator: string) => string[][];
+export interface CsvColumnDefinition<T> {
+    name: string;
+    value: (item: T) => any;
+}
+export type CsvBuildOptions = {
+    delimiter?: string;
+};
+export declare const csvBuild: <T>(data: T[], columns: CsvColumnDefinition<T>[], options?: CsvBuildOptions) => string;

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

@@ -1,4 +1,5 @@
 export * from "./array";
+export { CsvColumnDefinition as ColumnDefinition, CsvBuildOptions, csvBuild, csvParseRaw, } from "./csv";
 export { getDirectoryFilePaths } from "./files";
 export { joinPath, splitPath, ensureDirectory, getDirectoryPath } from "./paths";
 export * from "./strings";
@@ -6,3 +7,4 @@ export * from "./objects";
 export * from "./text";
 export * from "./threading";
 export * from "./uid";
+export { ExcelSheetDefinition, ExcelKeyTransform, ExcelColumnDefinition as ExcelRowBuilder, ExcelParseOptions, excelBuild, excelParse, } from "./xls";

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

@@ -5,3 +5,5 @@ export declare const camelToSnakeCase: (str: string) => string;
 export declare const camelToKebabCase: (str: string) => string;
 export declare const toCamelCase: (str: string) => string;
 export declare const toTitleCase: (str: string) => string;
+export declare const ensureTailingSlash: (value: string) => string;
+export declare const ensureStartSlash: (value: string) => string;

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

@@ -0,0 +1,24 @@
+export interface ExcelColumnDefinition<T> {
+    value: (row: T) => any;
+    header: string;
+    headerSize?: number;
+}
+export type ExcelSheetDefinition<T> = {
+    sheetName: string;
+    data: T[];
+    columns: ExcelColumnDefinition<T>[];
+};
+export declare const excelBuild: <T>(...sheets: ExcelSheetDefinition<T>[]) => ArrayBuffer;
+export declare const parseExcelRaw: (file: string | ArrayBuffer) => {
+    name: string;
+    data: any[][];
+}[];
+export declare enum ExcelKeyTransform {
+    Lower = "lower",
+    Upper = "upper"
+}
+export type ExcelParseOptions = {
+    keysTransform?: ExcelKeyTransform;
+    sheetIndex?: number;
+};
+export declare const excelParse: (file: string | ArrayBuffer, options?: ExcelParseOptions) => any[];

package/dist/index.d.ts

@@ -61,6 +61,16 @@ declare const distinctElements: <T>(values: T[], comparer: (value: T) => any) =>
 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 csvParseRaw: (rows: string[], separator: string) => string[][];
+interface CsvColumnDefinition<T> {
+    name: string;
+    value: (item: T) => any;
+}
+type CsvBuildOptions = {
+    delimiter?: string;
+};
+declare const csvBuild: <T>(data: T[], columns: CsvColumnDefinition<T>[], options?: CsvBuildOptions) => string;
+
 declare const getDirectoryFilePaths: (directoryPath: string, options?: {
     recursive?: boolean;
 }) => Promise<string[]>;
@@ -77,6 +87,8 @@ declare const camelToSnakeCase: (str: string) => string;
 declare const camelToKebabCase: (str: string) => string;
 declare const toCamelCase: (str: string) => string;
 declare const toTitleCase: (str: string) => string;
+declare const ensureTailingSlash: (value: string) => string;
+declare const ensureStartSlash: (value: string) => string;
 
 declare const removeUndefinedProps: <T extends Record<string, any>>(obj: T, options?: {
     recursive?: boolean;
@@ -89,4 +101,25 @@ declare function sleep(ms: number): Promise<unknown>;
 
 declare const newUuid: () => string;
 
-export { Dict, ILogger, ILoggerProvider, IResolveServiceOptions, IServiceLocator, Log, LogLevel, byField, byFieldDesc, camelToKebabCase, camelToSnakeCase, distinct, distinctElements, ensureDirectory, first, flatten, getDirectoryFilePaths, getDirectoryPath, indexes, isNullOrUndefined, iterate, joinPath, jsonDistinct, last, newUuid, notNull, notUndefined, pluralize, range, removeUndefinedProps, selectMany, sleep, sort, splitPath, toCamelCase, toDict, toMap, toTitleCase, trim, trimEnd, trimStart };
+interface ExcelColumnDefinition<T> {
+    value: (row: T) => any;
+    header: string;
+    headerSize?: number;
+}
+type ExcelSheetDefinition<T> = {
+    sheetName: string;
+    data: T[];
+    columns: ExcelColumnDefinition<T>[];
+};
+declare const excelBuild: <T>(...sheets: ExcelSheetDefinition<T>[]) => ArrayBuffer;
+declare enum ExcelKeyTransform {
+    Lower = "lower",
+    Upper = "upper"
+}
+type ExcelParseOptions = {
+    keysTransform?: ExcelKeyTransform;
+    sheetIndex?: number;
+};
+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, byField, byFieldDesc, camelToKebabCase, camelToSnakeCase, csvBuild, csvParseRaw, distinct, distinctElements, ensureDirectory, ensureStartSlash, ensureTailingSlash, excelBuild, excelParse, first, flatten, getDirectoryFilePaths, getDirectoryPath, indexes, isNullOrUndefined, iterate, joinPath, jsonDistinct, last, newUuid, notNull, notUndefined, pluralize, range, removeUndefinedProps, selectMany, sleep, sort, splitPath, toCamelCase, toDict, toMap, toTitleCase, trim, trimEnd, trimStart };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punks/backend-core",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "description": "WebPunks Backend Core",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -28,6 +28,7 @@
     "@rollup/plugin-typescript": "^11.0.0",
     "@types/jest": "^29.5.2",
     "jest": "^29.4.3",
+    "node-xlsx": "^0.23.0",
     "reflect-metadata": "^0.1.13",
     "rimraf": "^5.0.1",
     "rollup": "^2.60.0",