@rg-dev/stdlib 1.0.18 → 1.0.20

package/lib/common-env.cjs

@@ -20,8 +20,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var common_env_exports = {};
 __export(common_env_exports, {
   Optional: () => Optional,
+  StringBuilder: () => StringBuilder,
   catchInline: () => catchInline,
   doSafe: () => doSafe,
+  isNonEmptyString: () => isNonEmptyString,
   isNumber: () => isNumber,
   isRunningOnServer: () => isRunningOnServer,
   promiseRetry: () => promiseRetry,
@@ -59,6 +61,30 @@ function promiseRetry(func, options = defaultOptions, attempt = 1) {
   );
 }
 
+// src/StringBuilder.ts
+var StringBuilder = class {
+  _chunks;
+  constructor() {
+    this._chunks = [];
+  }
+  /** {@inheritDoc IStringBuilder.append} */
+  append(text) {
+    this._chunks.push(text);
+  }
+  /** {@inheritDoc IStringBuilder.toString} */
+  toString() {
+    if (this._chunks.length === 0) {
+      return "";
+    }
+    if (this._chunks.length > 1) {
+      const joined = this._chunks.join("");
+      this._chunks.length = 1;
+      this._chunks[0] = joined;
+    }
+    return this._chunks[0];
+  }
+};
+
 // src/common-env.ts
 var Optional = class _Optional {
   value;
@@ -165,3 +191,6 @@ async function useServer(fn, onError) {
 function isPromise(value) {
   return Boolean(value && typeof value.then === "function");
 }
+function isNonEmptyString(str) {
+  return typeof str == "string" && str.trim().length > 0;
+}

package/lib/common-env.d.cts

@@ -5,6 +5,42 @@ type Options = {
 };
 declare function promiseRetry<T>(func: (attempt: number) => Promise<T>, options?: Partial<Options>, attempt?: number): Promise<T>;
 
+interface IStringBuilder {
+    /**
+     * Append the specified text to the buffer.
+     */
+    append(text: string): void;
+    /**
+     * Returns a single string containing all the text that was appended to the buffer so far.
+     *
+     * @remarks
+     *
+     * This is a potentially expensive operation.
+     */
+    toString(): string;
+}
+/**
+ * This class allows a large text string to be constructed incrementally by appending small chunks.  The final
+ * string can be obtained by calling StringBuilder.toString().
+ *
+ * @remarks
+ * A naive approach might use the `+=` operator to append strings:  This would have the downside of copying
+ * the entire string each time a chunk is appended, resulting in `O(n^2)` bytes of memory being allocated
+ * (and later freed by the garbage  collector), and many of the allocations could be very large objects.
+ * StringBuilder avoids this overhead by accumulating the chunks in an array, and efficiently joining them
+ * when `getText()` is finally called.
+ *
+ * @public
+ */
+declare class StringBuilder implements IStringBuilder {
+    private _chunks;
+    constructor();
+    /** {@inheritDoc IStringBuilder.append} */
+    append(text: string): void;
+    /** {@inheritDoc IStringBuilder.toString} */
+    toString(): string;
+}
+
 type MyFn<T extends Record<string, (...args: any[]) => any>> = {
     [K in keyof T]: (...args: Parameters<T[K]>) => void;
 };
@@ -31,6 +67,7 @@ declare function catchInline<T>(cb: Promise<T>): Promise<{
 }>;
 declare function doSafe(safe: () => Promise<void> | void, onError?: (error: Error) => void): void;
 declare function isRunningOnServer(): boolean;
-declare function useServer(fn: () => (Promise<any> | void), onError?: (err: Error) => void): Promise<any>;
+declare function useServer(fn: () => (Promise<any> | void), onError?: (err: Error) => void): Promise<any>;
+declare function isNonEmptyString(str?: string): boolean;
 
-export { type AsyncReturnType, type MaybeFunction, type MyFn, Optional, catchInline, doSafe, isNumber, isRunningOnServer, promiseRetry, promiseWithTimeout, sleep, useServer };
+export { type AsyncReturnType, type MaybeFunction, type MyFn, Optional, StringBuilder, catchInline, doSafe, isNonEmptyString, isNumber, isRunningOnServer, promiseRetry, promiseWithTimeout, sleep, useServer };

package/lib/common-env.d.ts

@@ -5,6 +5,42 @@ type Options = {
 };
 declare function promiseRetry<T>(func: (attempt: number) => Promise<T>, options?: Partial<Options>, attempt?: number): Promise<T>;
 
+interface IStringBuilder {
+    /**
+     * Append the specified text to the buffer.
+     */
+    append(text: string): void;
+    /**
+     * Returns a single string containing all the text that was appended to the buffer so far.
+     *
+     * @remarks
+     *
+     * This is a potentially expensive operation.
+     */
+    toString(): string;
+}
+/**
+ * This class allows a large text string to be constructed incrementally by appending small chunks.  The final
+ * string can be obtained by calling StringBuilder.toString().
+ *
+ * @remarks
+ * A naive approach might use the `+=` operator to append strings:  This would have the downside of copying
+ * the entire string each time a chunk is appended, resulting in `O(n^2)` bytes of memory being allocated
+ * (and later freed by the garbage  collector), and many of the allocations could be very large objects.
+ * StringBuilder avoids this overhead by accumulating the chunks in an array, and efficiently joining them
+ * when `getText()` is finally called.
+ *
+ * @public
+ */
+declare class StringBuilder implements IStringBuilder {
+    private _chunks;
+    constructor();
+    /** {@inheritDoc IStringBuilder.append} */
+    append(text: string): void;
+    /** {@inheritDoc IStringBuilder.toString} */
+    toString(): string;
+}
+
 type MyFn<T extends Record<string, (...args: any[]) => any>> = {
     [K in keyof T]: (...args: Parameters<T[K]>) => void;
 };
@@ -31,6 +67,7 @@ declare function catchInline<T>(cb: Promise<T>): Promise<{
 }>;
 declare function doSafe(safe: () => Promise<void> | void, onError?: (error: Error) => void): void;
 declare function isRunningOnServer(): boolean;
-declare function useServer(fn: () => (Promise<any> | void), onError?: (err: Error) => void): Promise<any>;
+declare function useServer(fn: () => (Promise<any> | void), onError?: (err: Error) => void): Promise<any>;
+declare function isNonEmptyString(str?: string): boolean;
 
-export { type AsyncReturnType, type MaybeFunction, type MyFn, Optional, catchInline, doSafe, isNumber, isRunningOnServer, promiseRetry, promiseWithTimeout, sleep, useServer };
+export { type AsyncReturnType, type MaybeFunction, type MyFn, Optional, StringBuilder, catchInline, doSafe, isNonEmptyString, isNumber, isRunningOnServer, promiseRetry, promiseWithTimeout, sleep, useServer };

package/lib/common-env.js

@@ -26,6 +26,30 @@ function promiseRetry(func, options = defaultOptions, attempt = 1) {
   );
 }
 
+// src/StringBuilder.ts
+var StringBuilder = class {
+  _chunks;
+  constructor() {
+    this._chunks = [];
+  }
+  /** {@inheritDoc IStringBuilder.append} */
+  append(text) {
+    this._chunks.push(text);
+  }
+  /** {@inheritDoc IStringBuilder.toString} */
+  toString() {
+    if (this._chunks.length === 0) {
+      return "";
+    }
+    if (this._chunks.length > 1) {
+      const joined = this._chunks.join("");
+      this._chunks.length = 1;
+      this._chunks[0] = joined;
+    }
+    return this._chunks[0];
+  }
+};
+
 // src/common-env.ts
 var Optional = class _Optional {
   value;
@@ -132,10 +156,15 @@ async function useServer(fn, onError) {
 function isPromise(value) {
   return Boolean(value && typeof value.then === "function");
 }
+function isNonEmptyString(str) {
+  return typeof str == "string" && str.trim().length > 0;
+}
 export {
   Optional,
+  StringBuilder,
   catchInline,
   doSafe,
+  isNonEmptyString,
   isNumber,
   isRunningOnServer,
   promiseRetry,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rg-dev/stdlib",
-  "version": "1.0.18",
+  "version": "1.0.20",
   "description": "",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
@@ -11,6 +11,9 @@
   "files": [
     "lib"
   ],
+
+  
+
   "typesVersions": {
     "*": {
       "lib/common-env": [
@@ -29,15 +32,18 @@
   "exports": {
     "./lib/node-env": {
       "import": "./lib/node-env.js",
-      "require": "./lib/node-env.cjs"
+      "require": "./lib/node-env.cjs",
+      "types": "./lib/node-env.d.ts"
     },
     "./lib/common-env": {
       "import": "./lib/common-env.js",
-      "require": "./lib/common-env.cjs"
+      "require": "./lib/common-env.cjs",
+      "types": "./lib/common-env.d.ts"
     },
     "./lib/node-download": {
       "import": "./lib/node-download.js",
-      "require": "./lib/node-download.cjs"
+      "require": "./lib/node-download.cjs",
+      "types": "./lib/node-download.d.ts"
     }
   },
   "dependencies": {