@tpmjs/official-base64-decode 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2025 TPMJS
+
+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,88 @@
+# @tpmjs/official-base64-decode
+
+Decode base64 encoded data to string with support for multiple output encodings.
+
+## Installation
+
+```bash
+npm install @tpmjs/official-base64-decode
+```
+
+## Usage
+
+```typescript
+import { base64DecodeTool } from '@tpmjs/official-base64-decode';
+import { generateText } from 'ai';
+
+const result = await generateText({
+  model: yourModel,
+  tools: {
+    base64Decode: base64DecodeTool,
+  },
+  prompt: 'Decode the base64 string "SGVsbG8sIFdvcmxkIQ=="',
+});
+```
+
+## Parameters
+
+- `base64` (string, required): The base64 encoded data to decode
+- `encoding` (string, optional): Character encoding for the output data
+  - Options: `'utf8'` (default), `'binary'`, `'hex'`
+
+## Returns
+
+```typescript
+{
+  decoded: string;       // The decoded string
+  byteLength: number;    // The byte length of the decoded data
+}
+```
+
+## Examples
+
+### Decode to UTF-8 text (default)
+
+```typescript
+const result = await base64DecodeTool.execute({
+  base64: 'SGVsbG8sIFdvcmxkIQ==',
+});
+// { decoded: 'Hello, World!', byteLength: 13 }
+```
+
+### Decode to hex string
+
+```typescript
+const result = await base64DecodeTool.execute({
+  base64: '3q2+7w==',
+  encoding: 'hex',
+});
+// { decoded: 'deadbeef', byteLength: 4 }
+```
+
+### Decode to binary
+
+```typescript
+const result = await base64DecodeTool.execute({
+  base64: 'AAECAw==',
+  encoding: 'binary',
+});
+// { decoded: '\x00\x01\x02\x03', byteLength: 4 }
+```
+
+## Use Cases
+
+- Decoding base64-encoded API responses
+- Extracting data from data URIs
+- Decoding authentication tokens
+- Processing base64-encoded file content
+- Converting base64 images back to binary
+
+## Error Handling
+
+The tool throws an error if:
+- The base64 string is invalid
+- The encoding parameter is not one of the supported values
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+import * as ai from 'ai';
+
+/**
+ * Base64 Decode Tool for TPMJS
+ * Decodes base64 encoded data to string with support for multiple output encodings
+ */
+/**
+ * Supported character encodings for base64 decoding output
+ */
+type Encoding = 'utf8' | 'binary' | 'hex';
+/**
+ * Input interface for base64 decoding
+ */
+interface Base64DecodeInput {
+    base64: string;
+    encoding?: Encoding;
+}
+/**
+ * Output interface for base64 decode result
+ */
+interface Base64DecodeResult {
+    decoded: string;
+    byteLength: number;
+}
+/**
+ * Base64 Decode Tool
+ * Decodes base64 encoded data to string format
+ */
+declare const base64DecodeTool: ai.Tool<Base64DecodeInput, Base64DecodeResult>;
+
+export { type Base64DecodeResult, base64DecodeTool, base64DecodeTool as default };

package/dist/index.js

@@ -0,0 +1,48 @@
+import { tool, jsonSchema } from 'ai';
+
+// src/index.ts
+var base64DecodeTool = tool({
+  description: "Decode base64 encoded data to string. Supports utf8 (default), binary, and hex output encodings. Returns the decoded string and the byte length of the decoded data.",
+  inputSchema: jsonSchema({
+    type: "object",
+    properties: {
+      base64: {
+        type: "string",
+        description: "The base64 encoded data to decode"
+      },
+      encoding: {
+        type: "string",
+        enum: ["utf8", "binary", "hex"],
+        description: "Character encoding for the output data (default: utf8)"
+      }
+    },
+    required: ["base64"],
+    additionalProperties: false
+  }),
+  execute: async ({ base64, encoding = "utf8" }) => {
+    if (typeof base64 !== "string") {
+      throw new Error("Base64 data must be a string");
+    }
+    const validEncodings = ["utf8", "binary", "hex"];
+    if (!validEncodings.includes(encoding)) {
+      throw new Error(
+        `Invalid encoding: ${encoding}. Must be one of: ${validEncodings.join(", ")}`
+      );
+    }
+    try {
+      const buffer = Buffer.from(base64, "base64");
+      const decoded = buffer.toString(encoding);
+      return {
+        decoded,
+        byteLength: buffer.length
+      };
+    } catch (error) {
+      throw new Error(
+        `Failed to decode base64: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+});
+var index_default = base64DecodeTool;
+
+export { base64DecodeTool, index_default as default };

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@tpmjs/official-base64-decode",
+  "version": "0.1.0",
+  "description": "Decode base64 encoded data to string with support for multiple output encodings",
+  "type": "module",
+  "keywords": [
+    "tpmjs",
+    "data",
+    "base64",
+    "decode",
+    "encoding"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.9.3",
+    "@tpmjs/tsconfig": "0.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anthropics/tpmjs.git",
+    "directory": "packages/tools/official/base64-decode"
+  },
+  "homepage": "https://tpmjs.com",
+  "license": "MIT",
+  "tpmjs": {
+    "category": "data",
+    "frameworks": [
+      "vercel-ai"
+    ],
+    "tools": [
+      {
+        "name": "base64DecodeTool",
+        "description": "Decode base64 encoded data to string with support for multiple output encodings",
+        "parameters": [
+          {
+            "name": "base64",
+            "type": "string",
+            "description": "The base64 encoded data to decode",
+            "required": true
+          },
+          {
+            "name": "encoding",
+            "type": "string",
+            "description": "Character encoding for output (utf8, binary, hex)",
+            "required": false
+          }
+        ],
+        "returns": {
+          "type": "Base64DecodeResult",
+          "description": "Object with decoded string and byte length"
+        }
+      }
+    ]
+  },
+  "dependencies": {
+    "ai": "6.0.0-beta.124"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  }
+}