@wtasnorg/node-lib 0.0.8 → 0.0.9

package/docs/functions/createFindDirectories.md

@@ -8,7 +8,7 @@
 
 > **createFindDirectories**(`deps`): (`root`, `options`) => `Promise`\<`string`[]\>
 
-Defined in: [find.ts:19](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/find.ts#L19)
+Defined in: [find.ts:19](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/find.ts#L19)
 
 Factory that produces an async findDirectories function with
 injected filesystem dependencies for full testability.

package/docs/functions/decode.md

@@ -0,0 +1,49 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / decode
+
+# Function: decode()
+
+> **decode**(`input`, `charset`): `string`
+
+Defined in: base64.ts:119
+
+Decode a Base64 string.
+
+## Parameters
+
+### input
+
+`string`
+
+The Base64 encoded string.
+
+### charset
+
+The charset variant to use (default: "standard").
+
+`"standard"` | `"urlsafe"` | `"imap"` | `"radix64"`
+
+## Returns
+
+`string`
+
+The decoded string.
+
+## Example
+
+```typescript
+import { decode } from "./base64.js";
+
+decode("SGVsbG8sIFdvcmxkIQ==");
+// => "Hello, World!"
+
+decode("SGVsbG8sIFdvcmxkIQ==", "standard");
+// => "Hello, World!"
+```
+
+## Throws
+
+Error if the input contains invalid characters.

package/docs/functions/encode.md

@@ -0,0 +1,45 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / encode
+
+# Function: encode()
+
+> **encode**(`input`, `charset`): `string`
+
+Defined in: base64.ts:79
+
+Encode a string to Base64.
+
+## Parameters
+
+### input
+
+`string`
+
+The string to encode.
+
+### charset
+
+The charset variant to use (default: "standard").
+
+`"standard"` | `"urlsafe"` | `"imap"` | `"radix64"`
+
+## Returns
+
+`string`
+
+The Base64 encoded string.
+
+## Example
+
+```typescript
+import { encode } from "./base64.js";
+
+encode("Hello, World!");
+// => "SGVsbG8sIFdvcmxkIQ=="
+
+encode("Hello, World!", "urlsafe");
+// => "SGVsbG8sIFdvcmxkIQ=="
+```

package/docs/functions/hello.md

@@ -8,7 +8,7 @@
 
 > **hello**(): `Promise`\<`string`\>
 
-Defined in: [hello.ts:6](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/hello.ts#L6)
+Defined in: [hello.ts:6](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/hello.ts#L6)
 
 A sample function that should work to test if lib is installed correctly.
 

package/docs/functions/parseUserAgent.md

@@ -8,7 +8,7 @@
 
 > **parseUserAgent**(`ua`): [`UserAgentInfo`](../interfaces/UserAgentInfo.md)
 
-Defined in: [user-agent.ts:48](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/user-agent.ts#L48)
+Defined in: [user-agent.ts:48](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/user-agent.ts#L48)
 
 Parses a user-agent string into a UserAgentInfo object.
 

package/docs/functions/pojo.md

@@ -8,7 +8,7 @@
 
 > **pojo**\<`T`\>(`instance`): `Record`\<`string`, `unknown`\>
 
-Defined in: [pojo.ts:10](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/pojo.ts#L10)
+Defined in: [pojo.ts:10](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/pojo.ts#L10)
 
 Convert a class instance into a plain JavaScript object.
 Copies only the instance's own enumerable data properties

package/docs/interfaces/FileSystemDependencies.md

@@ -6,7 +6,7 @@
 
 # Interface: FileSystemDependencies
 
-Defined in: [find.ts:3](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/find.ts#L3)
+Defined in: [find.ts:3](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/find.ts#L3)
 
 ## Properties
 
@@ -14,7 +14,7 @@ Defined in: [find.ts:3](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd
 
 > **readdir**: (`_path`, `_opts`) => `Promise`\<`object`[]\>
 
-Defined in: [find.ts:4](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/find.ts#L4)
+Defined in: [find.ts:4](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/find.ts#L4)
 
 #### Parameters
 
@@ -38,7 +38,7 @@ Defined in: [find.ts:4](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd
 
 > **stat**: (`_path`) => `Promise`\<\{ `isDirectory`: `boolean`; \}\>
 
-Defined in: [find.ts:5](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/find.ts#L5)
+Defined in: [find.ts:5](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/find.ts#L5)
 
 #### Parameters
 

package/docs/interfaces/FindDirectoriesOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: FindDirectoriesOptions
 
-Defined in: [find.ts:8](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/find.ts#L8)
+Defined in: [find.ts:8](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/find.ts#L8)
 
 ## Properties
 
@@ -14,7 +14,7 @@ Defined in: [find.ts:8](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd
 
 > `optional` **allowlist**: `string`[] \| (`_absPath`, `_name`) => `boolean`
 
-Defined in: [find.ts:11](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/find.ts#L11)
+Defined in: [find.ts:11](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/find.ts#L11)
 
 ***
 
@@ -22,7 +22,7 @@ Defined in: [find.ts:11](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cf
 
 > `optional` **blocklist**: `string`[] \| (`_absPath`, `_name`) => `boolean`
 
-Defined in: [find.ts:12](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/find.ts#L12)
+Defined in: [find.ts:12](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/find.ts#L12)
 
 ***
 
@@ -30,7 +30,7 @@ Defined in: [find.ts:12](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cf
 
 > `optional` **followSymlinks**: `boolean`
 
-Defined in: [find.ts:10](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/find.ts#L10)
+Defined in: [find.ts:10](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/find.ts#L10)
 
 ***
 
@@ -38,4 +38,4 @@ Defined in: [find.ts:10](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cf
 
 > `optional` **maxDepth**: `number`
 
-Defined in: [find.ts:9](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/find.ts#L9)
+Defined in: [find.ts:9](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/find.ts#L9)

package/docs/interfaces/UserAgentInfo.md

@@ -6,7 +6,7 @@
 
 # Interface: UserAgentInfo
 
-Defined in: [user-agent.ts:4](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/user-agent.ts#L4)
+Defined in: [user-agent.ts:4](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/user-agent.ts#L4)
 
 Information extracted from a user-agent string.
 
@@ -16,7 +16,7 @@ Information extracted from a user-agent string.
 
 > **browser**: `string`
 
-Defined in: [user-agent.ts:8](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/user-agent.ts#L8)
+Defined in: [user-agent.ts:8](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/user-agent.ts#L8)
 
 Browser name (e.g., Chrome, Firefox, Safari, Edge, Opera, Other).
 
@@ -26,7 +26,7 @@ Browser name (e.g., Chrome, Firefox, Safari, Edge, Opera, Other).
 
 > **device**: `string`
 
-Defined in: [user-agent.ts:20](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/user-agent.ts#L20)
+Defined in: [user-agent.ts:20](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/user-agent.ts#L20)
 
 Device type (e.g., Mobile, Tablet, Desktop, Other).
 
@@ -36,7 +36,7 @@ Device type (e.g., Mobile, Tablet, Desktop, Other).
 
 > **engine**: `string`
 
-Defined in: [user-agent.ts:24](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/user-agent.ts#L24)
+Defined in: [user-agent.ts:24](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/user-agent.ts#L24)
 
 Rendering engine (e.g., Blink, WebKit, Gecko, Presto, Other).
 
@@ -46,7 +46,7 @@ Rendering engine (e.g., Blink, WebKit, Gecko, Presto, Other).
 
 > **os**: `string`
 
-Defined in: [user-agent.ts:16](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/user-agent.ts#L16)
+Defined in: [user-agent.ts:16](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/user-agent.ts#L16)
 
 Operating system (e.g., Windows, macOS, Linux, iOS, Android, Other).
 
@@ -56,6 +56,6 @@ Operating system (e.g., Windows, macOS, Linux, iOS, Android, Other).
 
 > **version**: `string`
 
-Defined in: [user-agent.ts:12](https://github.com/wtasg/node-lib/blob/ac07f7b7be8233cfd945908394ac10daf671e6a9/src/user-agent.ts#L12)
+Defined in: [user-agent.ts:12](https://github.com/wtasg/node-lib/blob/b5efd5c345e8fa1bdc2a6d3ea4dd4b2eb5b9cc62/src/user-agent.ts#L12)
 
 Browser version (e.g., 120.0.0.0).

package/docs/type-aliases/Base64CharsetType.md

@@ -0,0 +1,13 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / Base64CharsetType
+
+# Type Alias: Base64CharsetType
+
+> **Base64CharsetType** = *typeof* [`Base64Charset`](../variables/Base64Charset.md)\[`number`\]
+
+Defined in: base64.ts:18
+
+Base64 charset type.

package/docs/variables/Base64Charset.md

@@ -0,0 +1,17 @@
+[**@wtasnorg/node-lib**](../README.md)
+
+***
+
+[@wtasnorg/node-lib](../README.md) / Base64Charset
+
+# Variable: Base64Charset
+
+> `const` **Base64Charset**: readonly \[`"standard"`, `"urlsafe"`, `"imap"`, `"radix64"`\]
+
+Defined in: base64.ts:13
+
+Available Base64 charset variants.
+- `standard`: RFC 4648 standard alphabet (A-Z, a-z, 0-9, +, /)
+- `urlsafe`: URL and filename safe (A-Z, a-z, 0-9, -, _)
+- `imap`: Modified Base64 for IMAP mailbox names (A-Z, a-z, 0-9, +, ,)
+- `radix64`: Base64 variant used in OpenPGP (A-Z, a-z, 0-9, +, /)

package/gen-docs/001_base64_refine.txt

@@ -0,0 +1,50 @@
+# Base64 Module Refinement Pass
+# Date: 2026-01-19
+# Scope: src/base64.ts
+
+## SRP Analysis
+- encode(): Single responsibility - string to Base64
+- decode(): Single responsibility - Base64 to string
+- buildDecodeTable(): Single responsibility - lookup table creation
+- No business logic mixing, no I/O coupling
+
+## Dependency Direction
+- No external dependencies beyond Node.js built-ins (TextEncoder/TextDecoder)
+- No circular dependencies
+- Pure computation, no framework coupling
+
+## Purity & Side-Effects
+- All functions are pure (no I/O, no global state mutation)
+- Deterministic: same input always produces same output
+- No hidden state mutation
+
+## Naming Review
+- encode/decode: Clear, idiomatic names
+- Base64Charset: Descriptive, matches domain
+- CHARSETS/DECODE_TABLES: Clear internal constants
+- buildDecodeTable: Accurate verb+noun pattern
+
+## Error Handling
+- decode() throws Error with specific character on invalid input
+- Error message includes the offending character
+- No swallowed exceptions
+
+## API Surface
+- Exports: encode, decode, Base64Charset, Base64CharsetType
+- Minimal and focused public API
+- Internal helpers (buildDecodeTable, CHARSETS, PAD) are not exported
+
+## Invariants
+- Charset type is constrained via TypeScript const assertion
+- Invalid charset impossible at compile time
+- Padding handled correctly per Base64 spec
+
+## Test Coverage
+- 74 tests total, base64 tests cover:
+  - Encode: empty, single char, padding, all charsets, UTF-8
+  - Decode: empty, padding, error handling
+  - Round-trip: all charsets with 10 test cases each
+- Tests verify behavior, not implementation
+
+## Summary
+No actionable refinement items. Code is clean, focused, and well-tested.

package/gen-sec/001_base64_security.txt

@@ -0,0 +1,75 @@
+# Base64 Module Security Assessment
+# Date: 2026-01-19
+# Scope: src/base64.ts
+
+## Attack Surface Inventory
+- encode(input: string, charset): accepts user-controlled string
+- decode(input: string, charset): accepts user-controlled Base64 string
+- No network I/O, no file I/O, no exec
+
+## Threat Model
+- Attacker model: untrusted string input
+- Assets: application stability, memory
+- Trust boundary: function input parameters
+
+## OWASP Top 10 Review
+
+### A01 - Broken Access Control
+- N/A: Pure computation, no access control
+
+### A02 - Cryptographic Failures
+- N/A: Not a cryptographic function (encoding != encryption)
+- Note: radix64 is named for OpenPGP but is just Base64 alphabet
+
+### A03 - Injection
+- N/A: No SQL, command, or template execution
+- Output is string manipulation only
+
+### A04 - Insecure Design
+- PASS: Input validation on decode via lookup table
+- PASS: Invalid characters throw explicit error
+
+### A05 - Security Misconfiguration
+- N/A: No configuration, pure library code
+
+### A06 - Vulnerable Components
+- N/A: No external dependencies
+
+### A07 - Identification & Authentication
+- N/A: No auth logic
+
+### A08 - Software & Data Integrity
+- N/A: No deserialization or external data
+
+### A09 - Logging & Monitoring
+- N/A: Library code, no logging (appropriate)
+
+### A10 - SSRF
+- N/A: No URL handling
+
+## Denial of Service Analysis
+- Large input: TextEncoder/TextDecoder handle arbitrary sizes
+- Memory: proportional to input size (expected for encoding)
+- No regex catastrophic backtracking (simple /=+$/ pattern)
+- No infinite loops: bounded by input length
+
+## Input Validation
+- encode(): accepts any valid JS string, converts via TextEncoder
+- decode(): validates each character against charset lookup table
+- Invalid input: throws Error immediately (fail-fast)
+
+## Memory Safety
+- Uses Uint8Array and standard JS arrays
+- No buffer overflows possible in JS/TS
+- No manual memory management
+
+## Findings
+Severity: NONE
+
+## Summary
+No security issues identified. The module is a pure computation library with:
+- No external I/O
+- No dangerous operations
+- Proper input validation
+- Explicit error handling
+- Bounded resource usage

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wtasnorg/node-lib",
-  "version": "0.0.8",
+  "version": "0.0.9",
   "description": "node library",
   "main": "src/index.js",
   "scripts": {

package/readme.txt

@@ -11,6 +11,7 @@ A library project for nodejs. #nodejs #typescript #library
 2. `pojo` for converting class objects to Plain Old Javascript Objects.
 3. `createFindDirectories` as a factory for finding directories; think `find path -type d`.
 4. `parseUserAgent` for extracting information from user-agent strings.
+5. `encode` / `decode` for Base64 encoding/decoding with charset variants (`standard`, `urlsafe`, `imap`, `radix64`).
 
 ## Develop
 

package/src/base64.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Base64 encoding/decoding with multiple charset variants.
+ * @module base64
+ */
+/**
+ * Available Base64 charset variants.
+ * - `standard`: RFC 4648 standard alphabet (A-Z, a-z, 0-9, +, /)
+ * - `urlsafe`: URL and filename safe (A-Z, a-z, 0-9, -, _)
+ * - `imap`: Modified Base64 for IMAP mailbox names (A-Z, a-z, 0-9, +, ,)
+ * - `radix64`: Base64 variant used in OpenPGP (A-Z, a-z, 0-9, +, /)
+ */
+declare const Base64Charset: readonly ["standard", "urlsafe", "imap", "radix64"];
+/**
+ * Base64 charset type.
+ */
+type Base64CharsetType = (typeof Base64Charset)[number];
+/**
+ * Encode a string to Base64.
+ *
+ * @example
+ * ```typescript
+ * import { encode } from "./base64.js";
+ *
+ * encode("Hello, World!");
+ * // => "SGVsbG8sIFdvcmxkIQ=="
+ *
+ * encode("Hello, World!", "urlsafe");
+ * // => "SGVsbG8sIFdvcmxkIQ=="
+ * ```
+ *
+ * @param input - The string to encode.
+ * @param charset - The charset variant to use (default: "standard").
+ * @returns The Base64 encoded string.
+ */
+declare function encode(input: string, charset?: Base64CharsetType): string;
+/**
+ * Decode a Base64 string.
+ *
+ * @example
+ * ```typescript
+ * import { decode } from "./base64.js";
+ *
+ * decode("SGVsbG8sIFdvcmxkIQ==");
+ * // => "Hello, World!"
+ *
+ * decode("SGVsbG8sIFdvcmxkIQ==", "standard");
+ * // => "Hello, World!"
+ * ```
+ *
+ * @param input - The Base64 encoded string.
+ * @param charset - The charset variant to use (default: "standard").
+ * @returns The decoded string.
+ * @throws Error if the input contains invalid characters.
+ */
+declare function decode(input: string, charset?: Base64CharsetType): string;
+export { encode, decode, Base64Charset };
+export type { Base64CharsetType };
+//# sourceMappingURL=base64.d.ts.map

package/src/base64.js

@@ -0,0 +1,138 @@
+/**
+ * Base64 encoding/decoding with multiple charset variants.
+ * @module base64
+ */
+/**
+ * Available Base64 charset variants.
+ * - `standard`: RFC 4648 standard alphabet (A-Z, a-z, 0-9, +, /)
+ * - `urlsafe`: URL and filename safe (A-Z, a-z, 0-9, -, _)
+ * - `imap`: Modified Base64 for IMAP mailbox names (A-Z, a-z, 0-9, +, ,)
+ * - `radix64`: Base64 variant used in OpenPGP (A-Z, a-z, 0-9, +, /)
+ */
+const Base64Charset = ["standard", "urlsafe", "imap", "radix64"];
+/**
+ * Charset alphabets for Base64 variants.
+ */
+const CHARSETS = {
+    standard: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/",
+    urlsafe: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_",
+    imap: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+,",
+    radix64: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"
+};
+/**
+ * Padding character for Base64 encoding.
+ */
+const PAD = "=";
+/**
+ * Build a reverse lookup table for decoding.
+ * @param alphabet - The 64-character alphabet string.
+ * @returns Map of character to index.
+ */
+function buildDecodeTable(alphabet) {
+    const table = new Map();
+    for (let i = 0; i < alphabet.length; i++) {
+        const char = alphabet[i];
+        if (char !== undefined) {
+            table.set(char, i);
+        }
+    }
+    return table;
+}
+/**
+ * Pre-built decode tables for each charset.
+ */
+const DECODE_TABLES = {
+    standard: buildDecodeTable(CHARSETS.standard),
+    urlsafe: buildDecodeTable(CHARSETS.urlsafe),
+    imap: buildDecodeTable(CHARSETS.imap),
+    radix64: buildDecodeTable(CHARSETS.radix64)
+};
+/**
+ * Encode a string to Base64.
+ *
+ * @example
+ * ```typescript
+ * import { encode } from "./base64.js";
+ *
+ * encode("Hello, World!");
+ * // => "SGVsbG8sIFdvcmxkIQ=="
+ *
+ * encode("Hello, World!", "urlsafe");
+ * // => "SGVsbG8sIFdvcmxkIQ=="
+ * ```
+ *
+ * @param input - The string to encode.
+ * @param charset - The charset variant to use (default: "standard").
+ * @returns The Base64 encoded string.
+ */
+function encode(input, charset = "standard") {
+    const alphabet = CHARSETS[charset];
+    const bytes = new TextEncoder().encode(input);
+    let result = "";
+    for (let i = 0; i < bytes.length; i += 3) {
+        const b0 = bytes[i] ?? 0;
+        const b1 = i + 1 < bytes.length ? (bytes[i + 1] ?? 0) : 0;
+        const b2 = i + 2 < bytes.length ? (bytes[i + 2] ?? 0) : 0;
+        const triple = (b0 << 16) | (b1 << 8) | b2;
+        result += alphabet[(triple >> 18) & 0x3f];
+        result += alphabet[(triple >> 12) & 0x3f];
+        result += i + 1 < bytes.length ? alphabet[(triple >> 6) & 0x3f] : PAD;
+        result += i + 2 < bytes.length ? alphabet[triple & 0x3f] : PAD;
+    }
+    return result;
+}
+/**
+ * Decode a Base64 string.
+ *
+ * @example
+ * ```typescript
+ * import { decode } from "./base64.js";
+ *
+ * decode("SGVsbG8sIFdvcmxkIQ==");
+ * // => "Hello, World!"
+ *
+ * decode("SGVsbG8sIFdvcmxkIQ==", "standard");
+ * // => "Hello, World!"
+ * ```
+ *
+ * @param input - The Base64 encoded string.
+ * @param charset - The charset variant to use (default: "standard").
+ * @returns The decoded string.
+ * @throws Error if the input contains invalid characters.
+ */
+function decode(input, charset = "standard") {
+    const decodeTable = DECODE_TABLES[charset];
+    // Remove padding
+    const cleanInput = input.replace(/=+$/, "");
+    const bytes = [];
+    for (let i = 0; i < cleanInput.length; i += 4) {
+        const c0 = cleanInput[i];
+        const c1 = cleanInput[i + 1];
+        const c2 = cleanInput[i + 2];
+        const c3 = cleanInput[i + 3];
+        if (c0 === undefined) {
+            break;
+        }
+        const v0 = decodeTable.get(c0);
+        const v1 = c1 !== undefined ? decodeTable.get(c1) : 0;
+        const v2 = c2 !== undefined ? decodeTable.get(c2) : 0;
+        const v3 = c3 !== undefined ? decodeTable.get(c3) : 0;
+        if (v0 === undefined) {
+            throw new Error(`Invalid Base64 character: ${c0}`);
+        }
+        if (c1 !== undefined && v1 === undefined) {
+            throw new Error(`Invalid Base64 character: ${c1}`);
+        }
+        const triple = ((v0 ?? 0) << 18) | ((v1 ?? 0) << 12) | ((v2 ?? 0) << 6) | (v3 ?? 0);
+        bytes.push((triple >> 16) & 0xff);
+        if (c2 !== undefined) {
+            bytes.push((triple >> 8) & 0xff);
+        }
+        if (c3 !== undefined) {
+            bytes.push(triple & 0xff);
+        }
+    }
+    return new TextDecoder().decode(new Uint8Array(bytes));
+}
+export { encode, decode, Base64Charset };
+//# sourceMappingURL=base64.js.map

package/src/base64.test.d.ts

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