@poppinss/utils 6.8.3 → 6.9.0

package/README.md

@@ -1053,7 +1053,7 @@ if (safeEqual(trustedValue, userInput)) {
 
 #### slash
 
-Convert OS-specific file paths to Unix file paths. The method is exported directly from the [slash](https://npm.im/slash) package.
+Convert OS-specific file paths to Unix file paths. Credits [https://github.com/sindresorhus/slash](https://github.com/sindresorhus/slash)
 
 ```ts
 import { slash } from '@poppinss/utils/slash'

package/build/chunk-2KG3PWR4.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+
+export {
+  __reExport
+};

package/build/chunk-4V5ON6P7.js

@@ -0,0 +1,7 @@
+// src/exceptions/main.ts
+import { InvalidArgumentsException, RuntimeException } from "@poppinss/exception";
+
+export {
+  InvalidArgumentsException,
+  RuntimeException
+};

package/build/chunk-EJKUJ44Y.js

@@ -0,0 +1,12 @@
+// src/slash.ts
+function slash(path) {
+  const isExtendedLengthPath = path.startsWith("\\\\?\\");
+  if (isExtendedLengthPath) {
+    return path;
+  }
+  return path.replace(/\\/g, "/");
+}
+
+export {
+  slash
+};

package/build/chunk-H54AK3PI.js

@@ -0,0 +1,7 @@
+// src/exception.ts
+import { Exception, createError } from "@poppinss/exception";
+
+export {
+  Exception,
+  createError
+};

package/build/{chunk-IOBSMUFC.js → chunk-XHQBV7AF.js}

@@ -37,4 +37,3 @@ var main_default = json;
 export {
   main_default
 };
-//# sourceMappingURL=chunk-IOBSMUFC.js.map

package/build/index.d.ts

@@ -13,8 +13,7 @@ export { naturalSort } from './src/natural_sort.js';
 export { ObjectBuilder } from './src/object_builder.js';
 export { safeEqual } from './src/safe_equal.js';
 export { slash } from './src/slash.js';
-export { RuntimeException } from './src/exceptions/runtime_exception.js';
-export { InvalidArgumentsException } from './src/exceptions/invalid_arguments_exception.js';
+export { RuntimeException, InvalidArgumentsException } from './src/exceptions/main.js';
 /**
  * Get dirname for a given file path URL
  */

package/build/index.js

@@ -1,21 +1,20 @@
 import {
-  default as default2
-} from "./chunk-RRTFLKKC.js";
+  Exception,
+  createError
+} from "./chunk-H54AK3PI.js";
 import {
-  base64,
-  milliseconds_default
-} from "./chunk-NKGAOHNN.js";
+  slash
+} from "./chunk-EJKUJ44Y.js";
 import {
   InvalidArgumentsException,
   RuntimeException
-} from "./chunk-PNT36FCE.js";
-import {
-  Exception,
-  createError
-} from "./chunk-GGIWJLUJ.js";
+} from "./chunk-4V5ON6P7.js";
 import {
   main_default
-} from "./chunk-IOBSMUFC.js";
+} from "./chunk-XHQBV7AF.js";
+import {
+  __reExport
+} from "./chunk-2KG3PWR4.js";
 
 // index.ts
 import { fileURLToPath as fileURLToPath3 } from "node:url";
@@ -61,6 +60,46 @@ var Secret = class _Secret {
   }
 };
 
+// src/base64.ts
+var Base64 = class {
+  encode(data, encoding) {
+    if (typeof data === "string") {
+      return Buffer.from(data, encoding).toString("base64");
+    }
+    if (Buffer.isBuffer(data)) {
+      return data.toString("base64");
+    }
+    return Buffer.from(data).toString("base64");
+  }
+  decode(encoded, encoding = "utf-8", strict = false) {
+    if (Buffer.isBuffer(encoded)) {
+      return encoded.toString(encoding);
+    }
+    const decoded = Buffer.from(encoded, "base64").toString(encoding);
+    const isInvalid = this.encode(decoded, encoding) !== encoded;
+    if (strict && isInvalid) {
+      throw new Error("Cannot decode malformed value");
+    }
+    return isInvalid ? null : decoded;
+  }
+  urlEncode(data, encoding) {
+    const encoded = typeof data === "string" ? this.encode(data, encoding) : this.encode(data);
+    return encoded.replace(/\+/g, "-").replace(/\//g, "_").replace(/\=/g, "");
+  }
+  urlDecode(encoded, encoding = "utf-8", strict = false) {
+    if (Buffer.isBuffer(encoded)) {
+      return encoded.toString(encoding);
+    }
+    const decoded = Buffer.from(encoded, "base64").toString(encoding);
+    const isInvalid = this.urlEncode(decoded, encoding) !== encoded;
+    if (strict && isInvalid) {
+      throw new Error("Cannot urlDecode malformed value");
+    }
+    return isInvalid ? null : decoded;
+  }
+};
+var base64 = new Base64();
+
 // src/compose.ts
 function compose(superclass, ...mixins) {
   return mixins.reduce((c, mixin) => mixin(c), superclass);
@@ -152,10 +191,10 @@ async function readFiles(root, files, options, relativePath) {
       files.push(location);
       break;
     case "unixRelative":
-      files.push(default2(relativePath));
+      files.push(slash(relativePath));
       break;
     case "unixAbsolute":
-      files.push(default2(location));
+      files.push(slash(location));
       break;
     case "url":
       files.push(pathToFileURL(location).href);
@@ -220,12 +259,13 @@ async function fsImportAll(location, options) {
 }
 
 // src/message_builder.ts
+import string from "@poppinss/string";
 var MessageBuilder = class {
   #getExpiryDate(expiresIn) {
     if (!expiresIn) {
       return void 0;
     }
-    const expiryMs = milliseconds_default.parse(expiresIn);
+    const expiryMs = string.milliseconds.parse(expiresIn);
     return new Date(Date.now() + expiryMs);
   }
   /**
@@ -267,66 +307,25 @@ var MessageBuilder = class {
 };
 
 // src/object_builder.ts
-var ObjectBuilder = class {
-  #ignoreNull;
-  values;
-  constructor(initialValue, ignoreNull) {
-    this.values = initialValue;
-    this.#ignoreNull = ignoreNull === true ? true : false;
-  }
-  add(key, value) {
-    if (value === void 0) {
-      return this;
-    }
-    if (this.#ignoreNull === true && value === null) {
-      return this;
-    }
-    ;
-    this.values[key] = value;
-    return this;
-  }
-  /**
-   * Remove key from the object
-   */
-  remove(key) {
-    delete this.values[key];
-    return this;
-  }
-  /**
-   * Find if a value exists
-   */
-  has(key) {
-    return this.get(key) !== void 0;
-  }
-  /**
-   * Get the existing value for a given key
-   */
-  get(key) {
-    return this.values[key];
-  }
-  /**
-   * Get the underlying constructed object
-   */
-  toObject() {
-    return this.values;
-  }
-};
+var object_builder_exports = {};
+__reExport(object_builder_exports, object_builder_star);
+import * as object_builder_star from "@poppinss/object-builder";
 
 // src/safe_equal.ts
-import { Buffer } from "node:buffer";
+import { Buffer as Buffer2 } from "node:buffer";
 import { timingSafeEqual } from "node:crypto";
 function safeEqual(trustedValue, userInput) {
   if (typeof trustedValue === "string" && typeof userInput === "string") {
-    const trustedLength = Buffer.byteLength(trustedValue);
-    const trustedValueBuffer = Buffer.alloc(trustedLength, 0, "utf-8");
+    const trustedLength = Buffer2.byteLength(trustedValue);
+    const trustedValueBuffer = Buffer2.alloc(trustedLength, 0, "utf-8");
     trustedValueBuffer.write(trustedValue);
-    const userValueBuffer = Buffer.alloc(trustedLength, 0, "utf-8");
+    const userValueBuffer = Buffer2.alloc(trustedLength, 0, "utf-8");
     userValueBuffer.write(userInput);
-    return timingSafeEqual(trustedValueBuffer, userValueBuffer) && trustedLength === Buffer.byteLength(userInput);
+    return timingSafeEqual(trustedValueBuffer, userValueBuffer) && trustedLength === Buffer2.byteLength(userInput);
   }
   return timingSafeEqual(
-    Buffer.from(trustedValue),
-    Buffer.from(userInput)
+    Buffer2.from(trustedValue),
+    Buffer2.from(userInput)
   );
 }
 
@@ -340,11 +339,12 @@ function getFilename(url) {
 function joinToURL(url, ...str) {
   return pathJoin(getDirname(url), ...str);
 }
+var export_ObjectBuilder = object_builder_exports.ObjectBuilder;
 export {
   Exception,
   InvalidArgumentsException,
   MessageBuilder,
-  ObjectBuilder,
+  export_ObjectBuilder as ObjectBuilder,
   RuntimeException,
   Secret,
   base64,
@@ -361,6 +361,5 @@ export {
   joinToURL,
   naturalSort,
   safeEqual,
-  default2 as slash
+  slash
 };
-//# sourceMappingURL=index.js.map

package/build/src/assert.js

@@ -1,3 +1,5 @@
+import "../chunk-2KG3PWR4.js";
+
 // src/assert.ts
 import { inspect } from "node:util";
 import { AssertionError } from "node:assert";
@@ -29,4 +31,3 @@ export {
   assertNotNull,
   assertUnreachable
 };
-//# sourceMappingURL=assert.js.map

package/build/src/base64.d.ts

@@ -6,7 +6,7 @@ declare class Base64 {
     /**
      * Base64 encode Buffer or string
      */
-    encode(arrayBuffer: ArrayBuffer | SharedArrayBuffer): string;
+    encode(arrayBuffer: ArrayBuffer | Buffer<ArrayBuffer> | SharedArrayBuffer): string;
     encode(data: string, encoding?: BufferEncoding): string;
     /**
      * Base64 decode a previously encoded string or Buffer.
@@ -18,7 +18,7 @@ declare class Base64 {
     /**
      * Base64 encode Buffer or string to be URL safe. (RFC 4648)
      */
-    urlEncode(arrayBuffer: ArrayBuffer | SharedArrayBuffer): string;
+    urlEncode(arrayBuffer: ArrayBuffer | Buffer<ArrayBuffer> | SharedArrayBuffer): string;
     urlEncode(data: string, encoding?: BufferEncoding): string;
     /**
      * Base64 URL decode a previously encoded string or Buffer. (RFC 4648)

package/build/src/exception.d.ts

@@ -1,52 +1 @@
-/**
- * Extended Error object with the option to set error `status` and `code`.
- * At AdonisJs, we prefer exceptions with proper error codes to handle
- * them without relying on message pattern matching.
- *
- * ```js
- * new Exception('message', 500, 'E_RUNTIME_EXCEPTION')
- * ```
- */
-export declare class Exception extends Error {
-    /**
-     * Static properties to defined on the exception once
-     * and then re-use them
-     */
-    static help?: string;
-    static code?: string;
-    static status?: number;
-    static message?: string;
-    /**
-     * Name of the class that raised the exception.
-     */
-    name: string;
-    /**
-     * Optional help description for the error. You can use it to define additional
-     * human readable information for the error.
-     */
-    help?: string;
-    /**
-     * A machine readable error code. This will allow the error handling logic
-     * to narrow down exceptions based upon the error code.
-     */
-    code?: string;
-    /**
-     * A status code for the error. Usually helpful when converting errors
-     * to HTTP responses.
-     */
-    status: number;
-    constructor(message?: string, options?: ErrorOptions & {
-        code?: string;
-        status?: number;
-    });
-    get [Symbol.toStringTag](): string;
-    toString(): string;
-}
-/**
- * Helper to create anonymous error classes
- */
-export declare function createError<T extends any[] = never>(message: string, code: string, status?: number): typeof Exception & T extends never ? {
-    new (args?: any, options?: ErrorOptions): Exception;
-} : {
-    new (args: T, options?: ErrorOptions): Exception;
-};
+export { Exception, createError } from '@poppinss/exception';

package/build/src/exception.js

@@ -1,9 +1,9 @@
 import {
   Exception,
   createError
-} from "../chunk-GGIWJLUJ.js";
+} from "../chunk-H54AK3PI.js";
+import "../chunk-2KG3PWR4.js";
 export {
   Exception,
   createError
 };
-//# sourceMappingURL=exception.js.map

package/build/src/exceptions/main.d.ts

@@ -1,2 +1 @@
-export * from './invalid_arguments_exception.js';
-export * from './runtime_exception.js';
+export { InvalidArgumentsException, RuntimeException } from '@poppinss/exception';

package/build/src/exceptions/main.js

@@ -1,10 +1,9 @@
 import {
   InvalidArgumentsException,
   RuntimeException
-} from "../../chunk-PNT36FCE.js";
-import "../../chunk-GGIWJLUJ.js";
+} from "../../chunk-4V5ON6P7.js";
+import "../../chunk-2KG3PWR4.js";
 export {
   InvalidArgumentsException,
   RuntimeException
 };
-//# sourceMappingURL=main.js.map

package/build/src/json/main.js

@@ -1,7 +1,7 @@
 import {
   main_default
-} from "../../chunk-IOBSMUFC.js";
+} from "../../chunk-XHQBV7AF.js";
+import "../../chunk-2KG3PWR4.js";
 export {
   main_default as default
 };
-//# sourceMappingURL=main.js.map

package/build/src/object_builder.d.ts

@@ -1,58 +1 @@
-import { OmitProperties } from './types.js';
-/**
- * A simple class to build an object incrementally. It is helpful when you
- * want to add properties to the object conditionally.
- *
- * Instead of writing
- * ```
- * const obj = {
- *   ...(user.id ? { id: user.id } : {}),
- *   ...(user.firstName && user.lastName ? { name: `${user.firstName} ${user.lastName}` } : {}),
- * }
- * ```
- *
- * You can write
- *
- * const obj = new ObjectBuilder()
- *   .add('id', user.id)
- *   .add(
- *     'fullName',
- *     user.firstName && user.lastName ? `${user.firstName} ${user.lastName}` : undefined
- *   )
- *   .toObject()
- */
-export declare class ObjectBuilder<ReturnType extends Record<string, any>, IgnoreNull extends boolean = false> {
-    #private;
-    values: ReturnType;
-    constructor(initialValue: ReturnType, ignoreNull?: IgnoreNull);
-    /**
-     * Add a key-value pair to the object
-     *
-     * - Undefined values are ignored
-     * - Null values are ignored, when `ignoreNull` is set to true
-     */
-    add<Prop extends string>(key: Prop, value: undefined): this;
-    add<Prop extends string, Value>(key: Prop, value: Value): ObjectBuilder<ReturnType & {
-        [P in Prop]: Value;
-    }, IgnoreNull>;
-    /**
-     * Remove key from the object
-     */
-    remove<K extends keyof ReturnType>(key: K): this;
-    /**
-     * Find if a value exists
-     */
-    has<K extends keyof ReturnType>(key: K): boolean;
-    /**
-     * Get the existing value for a given key
-     */
-    get<K extends keyof ReturnType>(key: K): ReturnType[K];
-    /**
-     * Get the underlying constructed object
-     */
-    toObject(): IgnoreNull extends true ? {
-        [K in keyof OmitProperties<ReturnType, null>]: ReturnType[K];
-    } : {
-        [K in keyof ReturnType]: ReturnType[K];
-    };
-}
+export * from '@poppinss/object-builder';

package/build/src/slash.d.ts

@@ -1 +1,24 @@
-export { default as slash } from 'slash';
+/**
+ * Copy-pasted from https://github.com/sindresorhus/slash/blob/main/index.d.ts
+ * @credit - https://github.com/sindresorhus/slash
+ */
+/**
+ * Convert Windows backslash paths to slash paths: `foo\\bar` ➔ `foo/bar`.
+ * [Forward-slash paths can be used in Windows](http://superuser.com/a/176395/6877) as long as
+ * they're not extended-length paths.
+ *
+ * @example
+ * ```
+ * import path from 'node:path';
+ * import slash from 'slash';
+ *
+ * const string = path.join('foo', 'bar');
+ * // Unix    => foo/bar
+ * // Windows => foo\\bar
+ *
+ * slash(string);
+ * // Unix    => foo/bar
+ * // Windows => foo/bar
+ * ```
+ */
+export declare function slash(path: string): string;

package/build/src/slash.js

@@ -1,7 +1,7 @@
 import {
-  default as default2
-} from "../chunk-RRTFLKKC.js";
+  slash
+} from "../chunk-EJKUJ44Y.js";
+import "../chunk-2KG3PWR4.js";
 export {
-  default2 as slash
+  slash
 };
-//# sourceMappingURL=slash.js.map

package/build/src/string/main.d.ts

@@ -1,49 +1 @@
-import { random } from './random.js';
-import { excerpt } from './excerpt.js';
-import { ordinal } from './ordinal.js';
-import { truncate } from './truncate.js';
-import { sentence } from './sentence.js';
-import { interpolate } from './interpolate.js';
-import { pluralize } from './pluralize.js';
-import { noCase, dotCase, dashCase, camelCase, snakeCase, titleCase, pascalCase, capitalCase, sentenceCase } from './change_case.js';
-/**
- * Condense multiple whitespaces from a string
- */
-declare function condenseWhitespace(value: string): string;
-declare const string: {
-    excerpt: typeof excerpt;
-    truncate: typeof truncate;
-    slug: typeof import("slugify").default;
-    interpolate: typeof interpolate;
-    plural: typeof import("pluralize").plural;
-    pluralize: typeof pluralize;
-    singular: typeof import("pluralize").singular;
-    isPlural: typeof import("pluralize").isPlural;
-    isSingular: typeof import("pluralize").isSingular;
-    camelCase: typeof camelCase;
-    capitalCase: typeof capitalCase;
-    dashCase: typeof dashCase;
-    dotCase: typeof dotCase;
-    noCase: typeof noCase;
-    pascalCase: typeof pascalCase;
-    sentenceCase: typeof sentenceCase;
-    snakeCase: typeof snakeCase;
-    titleCase: typeof titleCase;
-    random: typeof random;
-    sentence: typeof sentence;
-    condenseWhitespace: typeof condenseWhitespace;
-    seconds: {
-        format(seconds: number, long?: boolean): string;
-        parse(duration: string | number): number;
-    };
-    milliseconds: {
-        format(milliseconds: number, long?: boolean): string;
-        parse(duration: string | number): number;
-    };
-    bytes: {
-        format(valueInBytes: number, options?: import("bytes").BytesOptions): string;
-        parse(unit: string | number): number;
-    };
-    ordinal: typeof ordinal;
-};
-export default string;
+export * from '@poppinss/string';

package/build/src/string/main.js

@@ -1,8 +1,2 @@
-import {
-  main_default
-} from "../../chunk-K76IL3UP.js";
-import "../../chunk-NKGAOHNN.js";
-export {
-  main_default as default
-};
-//# sourceMappingURL=main.js.map
+// src/string/main.ts
+export * from "@poppinss/string";

package/build/src/string/string_builder.d.ts

@@ -0,0 +1 @@
+export * from '@poppinss/string/builder';

package/build/src/string/string_builder.js

@@ -0,0 +1,2 @@
+// src/string/string_builder.ts
+export * from "@poppinss/string/builder";

package/build/src/types.js

@@ -1 +0,0 @@
-//# sourceMappingURL=types.js.map