@sqlrooms/utils 0.0.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @sqlrooms/utils@0.0.0 build /Users/ilya/Workspace/sqlrooms/packages/utils
+> tsc
+

package/.turbo/turbo-dev.log

@@ -0,0 +1,203 @@
+
+
+> @sqlrooms/utils@1.0.0 dev /Users/ilya/Workspace/sqlrooms/packages/utils
+> tsc -w
+
+[7:31:02 PM] Starting compilation in watch mode...
+
+src/color.ts:1:32 - error TS7016: Could not find a declaration file for module 'd3-color'. '/Users/ilya/Workspace/sqlrooms/node_modules/.pnpm/d3-color@3.1.0/node_modules/d3-color/src/index.js' implicitly has an 'any' type.
+  Try `npm i --save-dev @types/d3-color` if it exists or add a new declaration (.d.ts) file containing `declare module 'd3-color';`
+
+1 import {color as d3color} from 'd3-color';
+                                 ~~~~~~~~~~
+
+src/format.ts:1:27 - error TS7016: Could not find a declaration file for module 'd3-format'. '/Users/ilya/Workspace/sqlrooms/node_modules/d3-format/src/index.js' implicitly has an 'any' type.
+  Try `npm i --save-dev @types/d3-format` if it exists or add a new declaration (.d.ts) file containing `declare module 'd3-format';`
+
+1 import * as d3Format from 'd3-format';
+                            ~~~~~~~~~~~
+
+src/helpers.ts:1:26 - error TS7016: Could not find a declaration file for module 'd3-time-format'. '/Users/ilya/Workspace/sqlrooms/node_modules/.pnpm/d3-time-format@3.0.0/node_modules/d3-time-format/dist/d3-time-format.js' implicitly has an 'any' type.
+  Try `npm i --save-dev @types/d3-time-format` if it exists or add a new declaration (.d.ts) file containing `declare module 'd3-time-format';`
+
+1 import {timeFormat} from 'd3-time-format';
+                           ~~~~~~~~~~~~~~~~
+
+src/helpers.ts:2:20 - error TS7016: Could not find a declaration file for module 'seedrandom'. '/Users/ilya/Workspace/sqlrooms/node_modules/.pnpm/seedrandom@3.0.5/node_modules/seedrandom/index.js' implicitly has an 'any' type.
+  Try `npm i --save-dev @types/seedrandom` if it exists or add a new declaration (.d.ts) file containing `declare module 'seedrandom';`
+
+2 import {alea} from 'seedrandom';
+                     ~~~~~~~~~~~~
+
+src/str.test.ts:7:1 - error TS2582: Cannot find name 'test'. Do you need to install type definitions for a test runner? Try `npm i --save-dev @types/jest` or `npm i --save-dev @types/mocha`.
+
+7 test('generateUniqueName generates unique table names', () => {
+  ~~~~
+
+src/str.test.ts:8:3 - error TS2304: Cannot find name 'expect'.
+
+8   expect(generateUniqueName('foo', [])).toBe('foo');
+    ~~~~~~
+
+src/str.test.ts:9:3 - error TS2304: Cannot find name 'expect'.
+
+9   expect(generateUniqueName('foo', ['345'])).toBe('foo');
+    ~~~~~~
+
+src/str.test.ts:10:3 - error TS2304: Cannot find name 'expect'.
+
+10   expect(generateUniqueName('foo', ['foo_1'])).toBe('foo');
+     ~~~~~~
+
+src/str.test.ts:11:3 - error TS2304: Cannot find name 'expect'.
+
+11   expect(generateUniqueName('foo', ['foo', 'foo_1'])).toBe('foo_2');
+     ~~~~~~
+
+src/str.test.ts:12:3 - error TS2304: Cannot find name 'expect'.
+
+12   expect(generateUniqueName('foo_1', ['foo_1'])).toBe('foo_2');
+     ~~~~~~
+
+src/str.test.ts:13:3 - error TS2304: Cannot find name 'expect'.
+
+13   expect(generateUniqueName('foo_2', ['foo_2'])).toBe('foo_3');
+     ~~~~~~
+
+src/str.test.ts:14:3 - error TS2304: Cannot find name 'expect'.
+
+14   expect(generateUniqueName('foo', ['foo', 'foo_1', 'foo_2'])).toBe('foo_3');
+     ~~~~~~
+
+src/str.test.ts:15:3 - error TS2304: Cannot find name 'expect'.
+
+15   expect(generateUniqueName('')).toBe('');
+     ~~~~~~
+
+src/str.test.ts:16:3 - error TS2304: Cannot find name 'expect'.
+
+16   expect(generateUniqueName('', [''])).toBe('_1');
+     ~~~~~~
+
+src/str.test.ts:17:3 - error TS2304: Cannot find name 'expect'.
+
+17   expect(generateUniqueName('_', ['_'])).toBe('__1');
+     ~~~~~~
+
+src/str.test.ts:20:1 - error TS2582: Cannot find name 'test'. Do you need to install type definitions for a test runner? Try `npm i --save-dev @types/jest` or `npm i --save-dev @types/mocha`.
+
+20 test('generateUniquePath generates unique paths', () => {
+   ~~~~
+
+src/str.test.ts:21:3 - error TS2304: Cannot find name 'expect'.
+
+21   expect(generateUniquePath('/foo/bar.csv', [])).toBe('/foo/bar.csv');
+     ~~~~~~
+
+src/str.test.ts:22:3 - error TS2304: Cannot find name 'expect'.
+
+22   expect(generateUniquePath('/foo/bar.csv', ['345'])).toBe('/foo/bar.csv');
+     ~~~~~~
+
+src/str.test.ts:23:3 - error TS2304: Cannot find name 'expect'.
+
+23   expect(generateUniquePath('/foo/bar.csv', ['/foo/bar.csv'])).toBe(
+     ~~~~~~
+
+src/str.test.ts:26:3 - error TS2304: Cannot find name 'expect'.
+
+26   expect(generateUniquePath('/foo/bar.csv', ['/foo/bar_1.csv'])).toBe(
+     ~~~~~~
+
+src/str.test.ts:29:3 - error TS2304: Cannot find name 'expect'.
+
+29   expect(
+     ~~~~~~
+
+src/str.test.ts:32:3 - error TS2304: Cannot find name 'expect'.
+
+32   expect(
+     ~~~~~~
+
+src/str.test.ts:39:3 - error TS2304: Cannot find name 'expect'.
+
+39   expect(generateUniquePath('/foo/bar_1.csv', ['/foo/bar_1.csv'])).toBe(
+     ~~~~~~
+
+src/str.test.ts:42:3 - error TS2304: Cannot find name 'expect'.
+
+42   expect(generateUniquePath('/foo/bar_2.csv', ['/foo/bar_2.csv'])).toBe(
+     ~~~~~~
+
+src/str.test.ts:45:3 - error TS2304: Cannot find name 'expect'.
+
+45   expect(generateUniquePath('/foo', [])).toBe('/foo');
+     ~~~~~~
+
+src/str.test.ts:46:3 - error TS2304: Cannot find name 'expect'.
+
+46   expect(generateUniquePath('/foo/bar', [])).toBe('/foo/bar');
+     ~~~~~~
+
+src/str.test.ts:47:3 - error TS2304: Cannot find name 'expect'.
+
+47   expect(generateUniquePath('/foo/bar', ['/foo/bar'])).toBe('/foo/bar_1');
+     ~~~~~~
+
+src/str.test.ts:48:3 - error TS2304: Cannot find name 'expect'.
+
+48   expect(generateUniquePath('/', [])).toBe('/');
+     ~~~~~~
+
+src/str.test.ts:49:3 - error TS2304: Cannot find name 'expect'.
+
+49   expect(generateUniquePath('', [])).toBe('');
+     ~~~~~~
+
+src/str.test.ts:50:3 - error TS2304: Cannot find name 'expect'.
+
+50   expect(generateUniquePath('', [''])).toBe('_1');
+     ~~~~~~
+
+src/str.test.ts:51:3 - error TS2304: Cannot find name 'expect'.
+
+51   expect(generateUniquePath('_', ['_'])).toBe('__1');
+     ~~~~~~
+
+src/str.test.ts:54:1 - error TS2582: Cannot find name 'test'. Do you need to install type definitions for a test runner? Try `npm i --save-dev @types/jest` or `npm i --save-dev @types/mocha`.
+
+54 test('convertToUniqueS3ObjectName works correctly', () => {
+   ~~~~
+
+src/str.test.ts:55:3 - error TS2304: Cannot find name 'expect'.
+
+55   expect(convertToUniqueS3ObjectName('/flows.csv', [])).toBe('_flows.csv');
+     ~~~~~~
+
+src/str.test.ts:56:3 - error TS2304: Cannot find name 'expect'.
+
+56   expect(convertToUniqueS3ObjectName('&flows.csv', [])).toBe('_flows.csv');
+     ~~~~~~
+
+src/str.test.ts:57:3 - error TS2304: Cannot find name 'expect'.
+
+57   expect(convertToUniqueS3ObjectName('@flows.csv', [])).toBe('_flows.csv');
+     ~~~~~~
+
+src/str.test.ts:58:3 - error TS2304: Cannot find name 'expect'.
+
+58   expect(convertToUniqueS3ObjectName('/flows.csv', [])).toBe('_flows.csv');
+     ~~~~~~
+
+src/str.test.ts:59:3 - error TS2304: Cannot find name 'expect'.
+
+59   expect(convertToUniqueS3ObjectName('flows.csv', ['flows.csv'])).toBe(
+     ~~~~~~
+
+src/str.test.ts:62:3 - error TS2304: Cannot find name 'expect'.
+
+62   expect(
+     ~~~~~~
+
+[7:31:04 PM] Found 38 errors. Watching for file changes.
+

package/.turbo/turbo-lint.log

@@ -0,0 +1,16 @@
+
+> @sqlrooms/utils@0.0.0 lint /Users/ilya/Workspace/sqlrooms/packages/utils
+> eslint .
+
+
+/Users/ilya/Workspace/sqlrooms/packages/utils/src/helpers.ts
+  63:46  warning  Unexpected any. Specify a different type  @typescript-eslint/no-explicit-any
+
+/Users/ilya/Workspace/sqlrooms/packages/utils/src/str.ts
+  118:22  warning  Unnecessary escape character: \.  no-useless-escape
+
+/Users/ilya/Workspace/sqlrooms/packages/utils/src/xhr.ts
+  6:25  warning  Unexpected any. Specify a different type  @typescript-eslint/no-explicit-any
+
+✖ 3 problems (0 errors, 3 warnings)
+

package/.turbo/turbo-test.log

@@ -0,0 +1,51 @@
+
+
+> @sqlrooms/utils@0.0.0 test /Users/ilya/Workspace/sqlrooms/packages/utils
+> jest
+
+Determining test suites to run...
+
+ RUNS  dist/str.test.js
+
+
+ RUNS  dist/str.test.js
+
+
+    Jest encountered an unexpected token
+
+    Jest failed to parse a file. This happens e.g. when your code or its dependencies use non-standard JavaScript syntax, or when Jest is not configured to support such syntax.
+
+    Out of the box Jest supports Babel, which will be used to transform your files into valid JS based on your Babel configuration.
+
+    By default "node_modules" folder is ignored by transformers.
+
+    Here's what you can do:
+     • If you are trying to use ECMAScript Modules, see https://jestjs.io/docs/ecmascript-modules for how to enable it.
+     • If you are trying to use TypeScript, see https://jestjs.io/docs/getting-started#using-typescript
+     • To have some of your "node_modules" files transformed, you can specify a custom "transformIgnorePatterns" in your config.
+     • If you need a custom transformation specify a "transform" option in your config.
+     • If you simply want to mock your non-JS modules (e.g. binary assets) you can stub them out with the "moduleNameMapper" config option.
+
+    You'll find more details and examples of these config options in the docs:
+    https://jestjs.io/docs/configuration
+    For information about custom transformations, see:
+    https://jestjs.io/docs/code-transformation
+
+    Details:
+
+    /Users/ilya/Workspace/sqlrooms/packages/utils/dist/str.test.js:1
+    ({"Object.<anonymous>":function(module,exports,require,__dirname,__filename,jest){import { convertToUniqueS3ObjectName, generateUniqueName, generateUniquePath } from './str';
+                                                                                      ^^^^^^
+
+    SyntaxError: Cannot use import statement outside a module
+
+      at Runtime.createScriptFromCode (../../node_modules/.pnpm/jest-runtime@29.7.0/node_modules/jest-runtime/build/index.js:1505:14)
+
+
+ RUNS  dist/str.test.js
+
+Tests:       0 total
+Snapshots:   0 total
+Time:        0.208 s
+Ran all test suites.
+ ELIFECYCLE  Test failed. See above for more details.

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+
+
+**Note:** Version bump only for package @sqlrooms/utils

package/LICENSE.md

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright 2025 Ilya Boyandin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/color.d.ts

@@ -0,0 +1,2 @@
+export declare function opacifyHex(hexCode: string, opacity: number): string;
+//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQnE"}

package/dist/color.js

@@ -0,0 +1,10 @@
+import { color as d3color } from 'd3-color';
+export function opacifyHex(hexCode, opacity) {
+    const c = d3color(hexCode);
+    if (!c) {
+        console.warn('Invalid color: ', hexCode);
+        return `rgba(255, 255, 255, ${opacity})`;
+    }
+    const col = c.rgb();
+    return `rgba(${col.r}, ${col.g}, ${col.b}, ${opacity})`;
+}

package/dist/format.d.ts

@@ -0,0 +1,11 @@
+export declare const formatCount: (n: number | {
+    valueOf(): number;
+}) => string;
+export declare const formatCount4: (n: number | {
+    valueOf(): number;
+}) => string;
+export declare const formatCountShort: (n: number | {
+    valueOf(): number;
+}) => string;
+export declare function shorten(str: string, maxLength?: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW;;YAA0B,CAAC;AACnD,eAAO,MAAM,YAAY;;YAA0B,CAAC;AACpD,eAAO,MAAM,gBAAgB;;YAA0B,CAAC;AAExD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,MAAM,CAK3D"}

package/dist/format.js

@@ -0,0 +1,10 @@
+import * as d3Format from 'd3-format';
+export const formatCount = d3Format.format(',.0f');
+export const formatCount4 = d3Format.format('.4~s');
+export const formatCountShort = d3Format.format(',.0s');
+export function shorten(str, maxLength = 10) {
+    if (str.length <= maxLength) {
+        return str;
+    }
+    return `${str.substring(0, maxLength - 3)}…`;
+}

package/dist/helpers.d.ts

@@ -0,0 +1,11 @@
+import { ConfigType } from 'dayjs';
+export declare const toDateTime: (secs: number) => Date;
+export declare function genRandomStr(length: number, seed?: string): string;
+export declare const NUMBER_FORMAT: Intl.NumberFormat;
+export declare const formatNumber: (n: number) => string;
+export declare const formatDateTime: (d: Date | number | bigint) => string;
+export declare const formatDate: (d: Date | number | bigint) => string;
+export declare const formatTimeOfDay: (d: Date | number | bigint) => string;
+export declare const formatTimeRelative: (d: ConfigType) => string;
+export declare const getErrorMessageForDisplay: (e: any) => string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAGA,OAAc,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AAKxC,eAAO,MAAM,UAAU,SAAU,MAAM,SAItC,CAAC;AAEF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,UAgBzD;AAED,eAAO,MAAM,aAAa,mBAExB,CAAC;AAEH,eAAO,MAAM,YAAY,MAAO,MAAM,WAA4B,CAAC;AAMnE,eAAO,MAAM,cAAc,MAAO,IAAI,GAAG,MAAM,GAAG,MAAM,WAIvD,CAAC;AAEF,eAAO,MAAM,UAAU,MAAO,IAAI,GAAG,MAAM,GAAG,MAAM,WAGnD,CAAC;AAEF,eAAO,MAAM,eAAe,MAAO,IAAI,GAAG,MAAM,GAAG,MAAM,WAGxD,CAAC;AAEF,eAAO,MAAM,kBAAkB,MAAO,UAAU,WAE/C,CAAC;AAEF,eAAO,MAAM,yBAAyB,MAAO,GAAG,WAK/C,CAAC"}

package/dist/helpers.js

@@ -0,0 +1,56 @@
+import { timeFormat } from 'd3-time-format';
+import { alea } from 'seedrandom';
+import dayjs from 'dayjs';
+import relativeTime from 'dayjs/plugin/relativeTime';
+dayjs.extend(relativeTime);
+export const toDateTime = (secs) => {
+    const t = new Date('1970-01-01T00:30:00Z'); // Unix epoch start.
+    t.setSeconds(secs);
+    return t;
+};
+export function genRandomStr(length, seed) {
+    const rnd = seed ? alea(seed) : Math.random;
+    return Array.from((function* () {
+        for (let i = 0; i < length; i++) {
+            const v = Math.floor(rnd() * (26 * 2 + 10));
+            if (v < 26) {
+                yield String.fromCharCode(v + 65); // 'A' - 'Z'
+            }
+            else if (v < 52) {
+                yield String.fromCharCode(v + 71); // 'a' - 'z'
+            }
+            else {
+                yield String.fromCharCode(v + 48); // '0' - '9'
+            }
+        }
+    })()).join('');
+}
+export const NUMBER_FORMAT = new Intl.NumberFormat('en-US', {
+    minimumFractionDigits: 0,
+});
+export const formatNumber = (n) => NUMBER_FORMAT.format(n);
+const TIME_OF_DAY_FORMAT = timeFormat('%I:%M %p');
+const DATE_TIME_FORMAT = timeFormat('%a %Y-%m-%d %I:%M %p');
+const DATE_FORMAT = timeFormat('%Y-%m-%d');
+export const formatDateTime = (d) => {
+    const date = d instanceof Date ? d : new Date(Number(d));
+    // return date.toISOString();
+    return DATE_TIME_FORMAT(date);
+};
+export const formatDate = (d) => {
+    const date = d instanceof Date ? d : new Date(Number(d));
+    return DATE_FORMAT(date);
+};
+export const formatTimeOfDay = (d) => {
+    const date = d instanceof Date ? d : new Date(Number(d));
+    return TIME_OF_DAY_FORMAT(date);
+};
+export const formatTimeRelative = (d) => {
+    return dayjs().to(d);
+};
+export const getErrorMessageForDisplay = (e) => {
+    let msg = e instanceof Error ? e.message : String(e);
+    msg = msg.replace(/Query failed: Error: /, '');
+    const firstNl = msg.indexOf('\n');
+    return firstNl >= 0 ? msg.substring(0, firstNl) : msg;
+};

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './color';
+export * from './format';
+export * from './helpers';
+export * from './storage';
+export * from './str';
+export * from './xhr';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './color';
+export * from './format';
+export * from './helpers';
+export * from './storage';
+export * from './str';
+export * from './xhr';

package/dist/storage.d.ts

@@ -0,0 +1,10 @@
+export declare function getSignedFileUrl(params: {
+    fname: string;
+    upload?: boolean;
+} | {
+    projectId: string;
+    fname: string;
+    upload?: boolean;
+    password?: string;
+}): Promise<any>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAGA,wBAAsB,gBAAgB,CACpC,MAAM,EACF;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAC,GACjC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAC,gBAO5E"}

package/dist/storage.js

@@ -0,0 +1,9 @@
+import { postData } from './xhr';
+// TODO: this should live in app
+export async function getSignedFileUrl(params) {
+    const { url: locationsUrl } = await postData({
+        url: '/api/gen-signed-url',
+        data: params,
+    });
+    return locationsUrl;
+}

package/dist/str.d.ts

@@ -0,0 +1,13 @@
+export declare function formatBytes(bytes: number): string;
+export declare function splitFilePath(filePath: string): {
+    dir: string;
+    name: string;
+    ext: string;
+};
+export declare function convertToUniqueColumnOrTableName(filename: string, existingTables?: string[]): string;
+export declare function generateUniqueName(name: string, usedNames?: string[]): string;
+export declare function generateUniquePath(filePath: string, existingPaths: string[]): string;
+export declare function convertToUniqueS3ObjectName(str: string, existingObjects?: string[]): string;
+export declare function convertToUniqueS3FolderPath(str: string, existingObjects?: string[]): string;
+export declare function camelCaseToTitle(camelCase: string): string;
+//# sourceMappingURL=str.d.ts.map

package/dist/str.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"str.d.ts","sourceRoot":"","sources":["../src/str.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBjD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb,CAYA;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,EAAE,GACxB,MAAM,CAoBR;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,UAsBpE;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EAAE,GACtB,MAAM,CAqBR;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,EACX,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,MAAM,CAeR;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,EACX,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,MAAM,CAaR;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAgB1D"}

package/dist/str.js

@@ -0,0 +1,122 @@
+export function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 Bytes';
+    const k = 1024;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    let sizeValue = bytes / Math.pow(k, i);
+    // Use floor to check if there's a non-zero fractional part, format accordingly
+    sizeValue =
+        sizeValue != Math.floor(sizeValue)
+            ? parseFloat(sizeValue.toFixed(2))
+            : Math.floor(sizeValue);
+    return sizeValue + ' ' + sizes[i];
+}
+export function splitFilePath(filePath) {
+    const pathParts = filePath.split('/');
+    const file = pathParts.pop() || '';
+    const dotIndex = file.lastIndexOf('.');
+    if (dotIndex === -1 || dotIndex === 0)
+        return { dir: pathParts.join('/'), name: file, ext: '' };
+    const name = file.substring(0, dotIndex);
+    const ext = file.substring(dotIndex + 1);
+    return { dir: pathParts.join('/'), name, ext };
+}
+export function convertToUniqueColumnOrTableName(filename, existingTables) {
+    // Remove file extension
+    const base = filename.replace(/\.[^/.]+$/, '');
+    // Replace any invalid character with underscore, and convert to lowercase
+    let tableName = base.replace(/[^a-z0-9_]/gi, '_');
+    // If the first character is a number, prepend an underscore
+    if (/^\d/.test(tableName)) {
+        tableName = '_' + tableName;
+    }
+    // Truncate to the max length 63
+    if (tableName.length > 63) {
+        tableName = tableName.substring(0, 63);
+    }
+    tableName = generateUniqueName(tableName, existingTables);
+    return tableName;
+}
+export function generateUniqueName(name, usedNames) {
+    const usedNamesLower = usedNames?.map((n) => n.toLowerCase());
+    // If tableName exists in the list
+    if (usedNamesLower?.includes(name.toLowerCase())) {
+        let baseName = name;
+        let i = 0;
+        // If tableName ends with `_${i}` pattern, update the baseTableName and i
+        const matched = name.match(/^(.+)_(\d+)$/);
+        if (matched) {
+            baseName = matched[1];
+            i = Number(matched[2]);
+        }
+        do {
+            i++;
+            name = `${baseName}_${i}`;
+        } while (usedNamesLower.includes(name.toLowerCase()));
+    }
+    return name;
+}
+export function generateUniquePath(filePath, existingPaths) {
+    let nextPath = filePath;
+    if (existingPaths?.includes(filePath)) {
+        const { dir, name, ext } = splitFilePath(filePath);
+        let i = 0;
+        let baseName = name;
+        const matched = name.match(/^(.+)_(\d+)$/);
+        if (matched) {
+            baseName = matched[1];
+            i = Number(matched[2]);
+        }
+        do {
+            i++;
+            const fname = `${baseName}_${i}${ext ? `.${ext}` : ''}`;
+            nextPath = `${dir}${dir ? '/' : ''}${fname}`;
+        } while (existingPaths.includes(nextPath));
+    }
+    return nextPath;
+}
+export function convertToUniqueS3ObjectName(str, existingObjects) {
+    let rv = str
+        .trim() // Remove leading and trailing white spaces
+        .replace(/[^\w\s-\.]/g, '_') // Replace special characters with underscores
+        .replace(/\s+/g, '_') // Replace consecutive spaces with a single underscore
+        // .replace(/_+/g, '_') // Remove consecutive underscores
+        // .replace(/^_/, '') // Remove leading underscores
+        // .replace(/_$/, '') // Remove trailing underscores
+        .slice(0, 255); // Truncate the string if it exceeds 255 characters
+    if (existingObjects?.length) {
+        rv = generateUniquePath(rv, existingObjects);
+    }
+    return rv;
+}
+export function convertToUniqueS3FolderPath(str, existingObjects) {
+    let next = convertToUniqueS3ObjectName(str, existingObjects);
+    if (!next.endsWith('/'))
+        next += '/'; // Add trailing slash if not present
+    return next;
+    // return (
+    //   str
+    //     .trim() // Remove leading and trailing white spaces
+    //     .replace(/\/+/g, '/') // Replace consecutive slashes with a single slash
+    //     .replace(/[^\w\s-\/]/g, '_') // Replace special characters with underscores
+    //     .replace(/\s+/g, '_') // Replace consecutive spaces with a single underscore
+    //     .replace(/^\//, '') + // Remove leading slash
+    //   (str.endsWith('/') ? '' : '/')
+    // );
+}
+export function camelCaseToTitle(camelCase) {
+    // Split the string into words on the camelCase boundaries
+    const words = camelCase.match(/^[a-z]+|[A-Z][a-z]*/g);
+    // If words are found, transform them and join into a title string
+    if (words) {
+        return words
+            .map((word) => {
+            // Capitalize the first letter of each word
+            return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+        })
+            .join(' '); // Join the words with space
+    }
+    // If no words were found, just capitalize the whole string
+    return camelCase.charAt(0).toUpperCase() + camelCase.slice(1);
+}

package/dist/str.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=str.test.d.ts.map

package/dist/str.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"str.test.d.ts","sourceRoot":"","sources":["../src/str.test.ts"],"names":[],"mappings":""}