nhb-toolbox 4.14.0 → 4.14.2

package/README.md

@@ -57,7 +57,18 @@
 
 ---
 
-## Install
+## Installation
+
+`nhb-toolbox` is published to two package registries:
+
+- **NPM Registry** (default public registry)
+- **GitHub Packages** (GitHub’s package registry, scoped package)
+
+---
+
+### Installing from NPM Registry (default)
+
+This is the simplest way to install and requires no additional setup.
 
 Choose your preferred package manager:
 
@@ -73,6 +84,109 @@ pnpm add nhb-toolbox
 yarn add nhb-toolbox
 ```
 
+> Use this if you want the stable public version without extra config.
+
+---
+
+<details>
+
+  <summary>
+
+### Installing from GitHub Packages
+
+  </summary>
+  
+GitHub Packages requires authentication and scoped package names.
+
+#### Step 1: Authenticate with GitHub Packages
+
+Create or use a **GitHub Personal Access Token (PAT)** with `read:packages` permission.
+
+Add the following to your project’s `.npmrc` file (create if it doesn’t exist):
+
+```ini
+@nazmul-nhb:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=YOUR_GITHUB_PERSONAL_ACCESS_TOKEN
+```
+
+> Replace `YOUR_GITHUB_PERSONAL_ACCESS_TOKEN` with your actual token.
+
+#### Step 2: Install the package with scoped name
+
+Choose your preferred package manager:
+
+```shell
+npm i @nazmul-nhb/nhb-toolbox
+```
+
+```shell
+pnpm add @nazmul-nhb/nhb-toolbox
+```
+
+```shell
+yarn add @nazmul-nhb/nhb-toolbox
+```
+
+---
+
+#### Where do consumers get the GitHub token?
+
+- **The token is personal and private** — *each consumer must create own*.
+
+- Your **GitHub Personal Access Token (PAT)** **should never be shared publicly or with consumers**.
+
+---
+
+#### How consumers create own token
+
+1. **Go to GitHub account settings** → **Developer settings** → **Personal access tokens** → **Tokens (classic)**.
+
+2. Click **Generate new token**, then:
+
+   - Give it a name (e.g., `npm package read access`).
+
+   - Set expiration as prefer.
+
+   - **Enable only the `read:packages` permission** (to allow reading packages).
+
+3. Generate the token and **copy it immediately** — won't see it again.
+
+---
+
+#### What should consumers do with the token?
+
+- Add it to `.npmrc` file (or environment) to authenticate with GitHub Packages.
+
+Example `.npmrc` snippet:
+
+```ini
+@nazmul-nhb:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=PERSONAL_ACCESS_TOKEN_HERE
+```
+
+</details>
+
+---
+
+### Summary
+
+| Registry        | Package Name              | Registry URL                                             | Requires Auth?                 |
+| --------------- | ------------------------- | -------------------------------------------------------- | ------------------------------ |
+| NPM Registry       | `nhb-toolbox`             | [https://registry.npmjs.org](https://registry.npmjs.org) | No                             |
+| GitHub Packages | `@nazmul-nhb/nhb-toolbox` | [https://npm.pkg.github.com](https://npm.pkg.github.com) | Yes (PAT with `read:packages`) |
+
+---
+
+If you want to use both, just configure `.npmrc` accordingly and install the appropriate package name depending on your needs.
+
+---
+
+### Notes
+
+- The GitHub Packages version may include pre-release or private builds.
+- NPM Registry version is the recommended default for most users.
+- You can safely use either registry depending on your environment.
+
 ---
 
 ## Changelog

package/dist/cjs/http-status/constants.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HTTP_STATUS_CODES = exports.HTTP_STATUS_DATA = void 0;
 /** Data for HTTP Status Codes */
-exports.HTTP_STATUS_DATA = [
+exports.HTTP_STATUS_DATA = Object.freeze([
     {
         category: 'informational',
         link: 'https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/100',
@@ -570,9 +570,9 @@ exports.HTTP_STATUS_DATA = [
         message: 'Network Authentication Required',
         description: 'Indicates that the client needs to authenticate to gain network access.',
     },
-];
+]);
 /** List of HTTP Status Names with Corresponding Codes */
-exports.HTTP_STATUS_CODES = {
+exports.HTTP_STATUS_CODES = Object.freeze({
     /**
      * * {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/100 Continue}
      * - This interim response indicates that the client should continue the request or ignore the response if the request is already finished.
@@ -892,4 +892,4 @@ exports.HTTP_STATUS_CODES = {
      * - Indicates that the client needs to authenticate to gain network access.
      */
     NETWORK_AUTHENTICATION_REQUIRED: 511,
-};
+});

package/dist/dts/http-status/constants.d.ts

@@ -505,7 +505,7 @@ export declare const HTTP_STATUS_DATA: readonly [{
     readonly description: "Indicates that the client needs to authenticate to gain network access.";
 }];
 /** List of HTTP Status Names with Corresponding Codes */
-export declare const HTTP_STATUS_CODES: {
+export declare const HTTP_STATUS_CODES: Readonly<{
     /**
      * * {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/100 Continue}
      * - This interim response indicates that the client should continue the request or ignore the response if the request is already finished.
@@ -825,5 +825,5 @@ export declare const HTTP_STATUS_CODES: {
      * - Indicates that the client needs to authenticate to gain network access.
      */
     readonly NETWORK_AUTHENTICATION_REQUIRED: 511;
-};
+}>;
 //# sourceMappingURL=constants.d.ts.map

package/dist/dts/http-status/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/http-status/constants.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsnBnB,CAAC;AAEX,yDAAyD;AACzD,eAAO,MAAM,iBAAiB;IAC7B;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;;;;;OAOG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;CAEM,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/http-status/constants.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsnBlB,CAAC;AAEZ,yDAAyD;AACzD,eAAO,MAAM,iBAAiB;IAC7B;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;;;;;OAOG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;EAEO,CAAC"}

package/dist/esm/http-status/constants.js

@@ -1,5 +1,5 @@
 /** Data for HTTP Status Codes */
-export const HTTP_STATUS_DATA = [
+export const HTTP_STATUS_DATA = /* @__PURE__ */ Object.freeze([
     {
         category: 'informational',
         link: 'https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/100',
@@ -567,9 +567,9 @@ export const HTTP_STATUS_DATA = [
         message: 'Network Authentication Required',
         description: 'Indicates that the client needs to authenticate to gain network access.',
     },
-];
+]);
 /** List of HTTP Status Names with Corresponding Codes */
-export const HTTP_STATUS_CODES = {
+export const HTTP_STATUS_CODES = /* @__PURE__ */ Object.freeze({
     /**
      * * {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/100 Continue}
      * - This interim response indicates that the client should continue the request or ignore the response if the request is already finished.
@@ -889,4 +889,4 @@ export const HTTP_STATUS_CODES = {
      * - Indicates that the client needs to authenticate to gain network access.
      */
     NETWORK_AUTHENTICATION_REQUIRED: 511,
-};
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.14.0",
+  "version": "4.14.2",
   "description": "A versatile collection of smart, efficient, and reusable utility functions and classes for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",