@dephub/base64 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2025 Estarlin R
+
+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/README.md

@@ -0,0 +1,76 @@
+# @dephub/base64
+
+> Encode. Decode. Simplified.
+
+`@dephub/base64` — a utility for encoding UTF-8 strings to Base64 and decoding Base64 back to UTF-8.
+
+[![NPM version](https://img.shields.io/npm/v/@dephub/base64.svg?style=flat)](https://npmjs.org/package/@dephub/base64)
+[![ESM-only](https://img.shields.io/badge/ESM-only-brightgreen?style=flat)](https://nodejs.org/)
+[![Node.js version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
+
+---
+
+## Features ✨
+
+- 🔹 **Simple API**: `encode()` and `decode()` functions
+- 🚀 **CLI support**: encode/decode directly from the terminal
+- 🔄 **Reliable Base64 encoding/decoding** — handles all UTF-8 characters correctly
+- 🌐 **Cross-environment** — works in Node.js and modern browsers
+- ⚡ **Fast performance** — minimal and efficient Base64 operations
+
+## Installation 💿
+
+```bash
+# Using npm
+npm install @dephub/base64
+
+# Using pnpm
+pnpm add @dephub/base64
+
+# Using yarn
+yarn add @dephub/base64
+```
+
+## Usage 📦
+
+### API </>
+
+```ts
+import { encode, decode } from '@dephub/base64';
+
+const encoded = encode('hello');
+console.log(encoded); // "aGVsbG8="
+
+const decoded = decode(encoded);
+console.log(decoded); // "hello"
+```
+
+### CLI 🖥️
+
+```bash
+# Encode string
+base64 encode "hello"
+# Output: aGVsbG8=
+
+# Decode string
+base64 decode "aGVsbG8="
+# Output: hello
+
+# Show help
+base64 --help
+```
+
+Commands:
+
+```
+encode <string>  : Encode string to Base64
+decode <base64>  : Decode Base64 to string
+--help           : Show help message
+--version        : Show version
+```
+
+## License 📄
+
+MIT License – see [LICENSE](LICENSE) for details.
+
+**Author:** Estarlin R ([estarlincito.com](https://estarlincito.com))

package/dist/cli.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { cli as e } from "@dephub/cli";
+import { decode as n } from "./core/decode.js";
+import { encode as r } from "./core/encode.js";
+import { name as i, version as s, description as a } from "./utils/pkg.js";
+e.name(i.split("/")[1] ?? "name").version(s).description(a);
+e.command("encode", "Encode string to Base64").argument("<string>", "The text string to encode into Base64 format").action(({ args: t }) => {
+  const o = t[0];
+  if (o.length === 0)
+    throw new Error("You must provide a string to encode.");
+  console.log(r(o));
+});
+e.command("decode", "Decode Base64 to string").argument("<base64>", "The Base64 string to decode back into text").action(({ args: t }) => {
+  const o = t[0];
+  if (o.length === 0)
+    throw new Error("You must provide a Base64 string to decode.");
+  console.log(n(o));
+});
+await e.run();

package/dist/core/decode.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Decodes a Base64 string back to UTF-8
+ *
+ * @example
+ * decode('aGVsbG8=') // 'hello'
+ */
+export declare const decode: (base64: string) => string;

package/dist/core/decode.js

@@ -0,0 +1,6 @@
+const d = (e) => new TextDecoder().decode(
+  Uint8Array.from(atob(e), (o) => o.charCodeAt(0))
+);
+export {
+  d as decode
+};

package/dist/core/encode.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Encodes a UTF-8 string to Base64
+ *
+ * @example
+ * encode('hello') // 'aGVsbG8='
+ */
+export declare const encode: (text: string) => string;

package/dist/core/encode.js

@@ -0,0 +1,4 @@
+const o = (e) => btoa(String.fromCharCode(...new TextEncoder().encode(e)));
+export {
+  o as encode
+};

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { decode } from './core/decode.js';
+export { encode } from './core/encode.js';

package/dist/index.js

@@ -0,0 +1,6 @@
+import { decode as r } from "./core/decode.js";
+import { encode as c } from "./core/encode.js";
+export {
+  r as decode,
+  c as encode
+};

package/dist/package.json.js

@@ -0,0 +1,11 @@
+const e = "@dephub/base64", s = "1.0.0", n = "Simple Base64 encoding and decoding utilities for Node.js and browsers", o = {
+  name: e,
+  version: s,
+  description: n
+};
+export {
+  o as default,
+  n as description,
+  e as name,
+  s as version
+};

package/dist/utils/pkg.d.ts

@@ -0,0 +1 @@
+export declare const version: string, description: string, name: string;

package/dist/utils/pkg.js

@@ -0,0 +1,7 @@
+import o from "../package.json.js";
+const { version: e, description: i, name: n } = o ?? {};
+export {
+  i as description,
+  n as name,
+  e as version
+};

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@dephub/base64",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "Simple Base64 encoding and decoding utilities for Node.js and browsers",
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "bin": {
+    "base64": "./dist/cli.js"
+  },
+  "keywords": [
+    "base64",
+    "encode",
+    "decode",
+    "base64encode",
+    "base64decode",
+    "typescript",
+    "nodejs",
+    "dephub"
+  ],
+  "author": {
+    "name": "Estarlin R",
+    "email": "dev@estarlincito.com",
+    "url": "https://estarlincito.com"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "LICENSE",
+    "README.md",
+    "dist"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/dephubjs/base64#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dephubjs/base64.git",
+    "directory": "packages/base64"
+  },
+  "bugs": {
+    "url": "https://github.com/dephubjs/base64/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@dephub/cli": "^1.0.0"
+  },
+  "scripts": {
+    "release": "pnpm publish",
+    "check-types": "tsc --noEmit --skipLibCheck",
+    "lint": "lint . --max-warnings 0",
+    "lint:fix": "lint . --fix",
+    "clean": "rm -rf dist",
+    "build": "vite build",
+    "dev": "vite build -w --mode development"
+  }
+}