@tanod-labs/piece-tanod 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tanod
+
+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

@@ -1,3 +1,38 @@
-# Temporary Holding Version
+# @tanod-labs/piece-tanod
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Activepieces piece for [Tanod](https://tanod.dev/connect/) pay-per-call tools. MIT licensed.
+
+No account or key is needed for the free tier: routes with a free daily allowance (OCR, page to Markdown, translate, email verify) are called with `X-Tanod-Free: 1`. The other routes need an x402 payment, which this piece does not make; once the allowance is used up or a route has none, the action fails with a "payment required" message and a link to https://tanod.dev/pricing. Use the n8n node or the MCP server for wallet payments.
+
+## Actions
+
+| Action | Route | Price (USD) | Free daily allowance |
+|---|---|---|---|
+| Document to Markdown | /v1/docs/to-markdown | 0.005 | no |
+| PDF Tables | /v1/pdf/tables | 0.01 | no |
+| OCR Image | /v1/ocr | 0.0025 | yes |
+| PDF to Word | /v1/pdf/to-docx | 0.01 | no |
+| Office to PDF | /v1/docs/to-pdf | 0.01 | no |
+| Page to Markdown | /v1/render | 0.002 (0.01 with JavaScript) | yes (static only) |
+| Website Screenshot | /v1/web/screenshot | 0.005 | no |
+| Speech to Text | /v1/audio/transcribe | 0.01 | no |
+| Translate Text | /v1/text/translate | 0.003 | yes |
+| Verify Email Address | /v1/email/verify | 0.001 | yes |
+
+File inputs take either an uploaded File or a public File URL. File outputs (PDF to Word, Office to PDF, screenshot, PDF tables as CSV/XLSX) are stored with the Activepieces file service and returned as a URL.
+
+## Develop
+
+```
+bash ops/capcpu.sh npm install
+bash ops/capcpu.sh npm run build   # tsc
+bash ops/capcpu.sh npm test        # mocked HTTP, no network
+```
+
+## Owner publish steps (about 3 minutes)
+
+1. `cd product/integrations/activepieces-piece-tanod`
+2. `npm login` (same npm account as the n8n node, owner item 121; skip if already logged in)
+3. `npm run build && npm test`
+4. `npm publish --access public`
+5. Activepieces cloud and self-hosted instances pick up public npm pieces named `@scope/piece-*`; to list it in the official piece catalog, submit the package to Activepieces separately (optional, not needed for installing it by name).

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+export declare const tanod: import("@activepieces/pieces-framework").Piece<undefined>;
+export { actions } from './lib/actions';

package/dist/src/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.actions = exports.tanod = void 0;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const shared_1 = require("@activepieces/shared");
+const actions_1 = require("./lib/actions");
+exports.tanod = (0, pieces_framework_1.createPiece)({
+    displayName: 'Tanod',
+    description: 'Pay-per-call document, web, audio, text and email tools. A free daily allowance per IP needs no account.',
+    logoUrl: 'https://tanod.dev/favicon.svg',
+    authors: ['aiexp1'],
+    categories: [shared_1.PieceCategory.CONTENT_AND_FILES],
+    auth: pieces_framework_1.PieceAuth.None(),
+    actions: actions_1.actions,
+    triggers: [],
+});
+var actions_2 = require("./lib/actions");
+Object.defineProperty(exports, "actions", { enumerable: true, get: function () { return actions_2.actions; } });

package/dist/src/lib/actions.d.ts

@@ -0,0 +1,15 @@
+type Ctx = {
+    propsValue: Record<string, any>;
+    files: {
+        write(a: {
+            fileName: string;
+            data: Buffer;
+        }): Promise<string>;
+    };
+};
+/** Put the file or URL into the request body. */
+export declare function fileInput(p: Record<string, any>, field: string, withName: boolean): Record<string, unknown>;
+/** Replace the base64 `file`/`files` in a reply with Activepieces file URLs. */
+export declare function storeFiles(reply: Record<string, any>, ctx: Ctx): Promise<Record<string, any>>;
+export declare const actions: import("@activepieces/pieces-framework").IAction<import("@activepieces/pieces-framework").PieceAuthProperty, Record<string, any>>[];
+export {};

package/dist/src/lib/actions.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.actions = void 0;
+exports.fileInput = fileInput;
+exports.storeFiles = storeFiles;
+const pieces_framework_1 = require("@activepieces/pieces-framework");
+const client_1 = require("./client");
+/** Routes, request fields and prices follow https://tanod.dev/openapi.json (x-tanod-pricing). */
+const urlProp = (required, description) => pieces_framework_1.Property.ShortText({ displayName: 'URL', description, required });
+const fileProp = pieces_framework_1.Property.File({
+    displayName: 'File',
+    description: 'The file to process. Use this or a URL.',
+    required: false,
+});
+const fileUrlProp = pieces_framework_1.Property.ShortText({
+    displayName: 'File URL',
+    description: 'Public http(s) URL of the file. Use this or File.',
+    required: false,
+});
+/** Put the file or URL into the request body. */
+function fileInput(p, field, withName) {
+    const f = p['file'];
+    if (f) {
+        const body = { [field]: f.base64 };
+        if (withName && f.filename)
+            body['filename'] = f.filename;
+        return body;
+    }
+    if (p['fileUrl'])
+        return { url: p['fileUrl'] };
+    throw new Error('Provide either a File or a File URL.');
+}
+/** Replace the base64 `file`/`files` in a reply with Activepieces file URLs. */
+async function storeFiles(reply, ctx) {
+    const take = async (f) => {
+        if (!f || typeof f.data_base64 !== 'string')
+            return f;
+        const url = await ctx.files.write({ fileName: f.name || 'tanod-output', data: Buffer.from(f.data_base64, 'base64') });
+        const { data_base64: _drop, ...rest } = f;
+        return { ...rest, url };
+    };
+    const out = { ...reply };
+    if (out['file'] && typeof out['file'] === 'object')
+        out['file'] = await take(out['file']);
+    if (Array.isArray(out['files']))
+        out['files'] = await Promise.all(out['files'].map(take));
+    return out;
+}
+const act = (name, displayName, description, props, path, free, build, returnsFile = false) => (0, pieces_framework_1.createAction)({
+    name,
+    displayName,
+    description,
+    props,
+    async run(ctx) {
+        const body = build(ctx.propsValue);
+        if (returnsFile)
+            body['output'] = 'base64';
+        const reply = await (0, client_1.tanodCall)({ path, body, free });
+        return returnsFile ? storeFiles(reply, ctx) : reply;
+    },
+});
+const pages = pieces_framework_1.Property.ShortText({
+    displayName: 'Pages',
+    description: 'Pages to process (N, N-M, N-, -M, last; comma separated). Empty means all.',
+    required: false,
+});
+exports.actions = [
+    act('document_to_markdown', 'Document to Markdown', 'PDF, DOCX, XLSX, PPTX, EPUB, HTML or CSV to Markdown (USD 0.005 per call, no free allowance)', { file: fileProp, fileUrl: fileUrlProp }, '/v1/docs/to-markdown', false, (p) => fileInput(p, 'file_base64', true)),
+    act('pdf_tables', 'PDF Tables', 'Extract tables from a text PDF as JSON, CSV or XLSX (USD 0.01 per call, no free allowance)', {
+        file: fileProp, fileUrl: fileUrlProp, pages,
+        format: pieces_framework_1.Property.StaticDropdown({
+            displayName: 'Output Format', required: true, defaultValue: 'json',
+            options: { options: [{ label: 'JSON', value: 'json' }, { label: 'CSV (file)', value: 'csv' }, { label: 'XLSX (file)', value: 'xlsx' }] },
+        }),
+    }, '/v1/pdf/tables', false, (p) => {
+        const body = fileInput(p, 'file_base64', false);
+        if (p['pages'])
+            body['pages'] = p['pages'];
+        body['format'] = p['format'] ?? 'json';
+        body['output'] = 'base64';
+        return body;
+    }, true),
+    act('ocr_image', 'OCR Image', 'Extract text from an image URL with Tesseract (USD 0.0025 per call, free daily allowance)', {
+        url: urlProp(true, 'Public http(s) URL of the image'),
+        lang: pieces_framework_1.Property.ShortText({ displayName: 'Language', description: 'Tesseract language code (only eng is installed)', required: false, defaultValue: 'eng' }),
+    }, '/v1/ocr', true, (p) => ({ url: p['url'], lang: p['lang'] || 'eng' })),
+    act('pdf_to_word', 'PDF to Word', 'Convert a PDF to a .docx file (USD 0.01 per call, no free allowance)', { file: fileProp, fileUrl: fileUrlProp, pages }, '/v1/pdf/to-docx', false, (p) => {
+        const body = fileInput(p, 'pdf_base64', false);
+        if (p['pages'])
+            body['pages'] = p['pages'];
+        return body;
+    }, true),
+    act('office_to_pdf', 'Office to PDF', 'Convert DOCX, XLSX, PPTX, ODT, RTF or text to PDF (USD 0.01 per call, no free allowance)', { file: fileProp, fileUrl: fileUrlProp }, '/v1/docs/to-pdf', false, (p) => fileInput(p, 'file_base64', true), true),
+    act('page_to_markdown', 'Page to Markdown', 'Fetch a web page as clean Markdown (USD 0.002, USD 0.01 with JavaScript; free daily allowance on the static fetch)', {
+        url: urlProp(true, 'Public http(s) URL of the page'),
+        js: pieces_framework_1.Property.Checkbox({
+            displayName: 'Run JavaScript', required: false, defaultValue: false,
+            description: 'Render the page in a headless browser first. Costs USD 0.01 and has no free allowance.',
+        }),
+    }, '/v1/render', true, (p) => ({ url: p['url'], format: 'markdown', js: p['js'] === true })),
+    act('website_screenshot', 'Website Screenshot', 'Capture a web page as a PNG or JPEG image (USD 0.005 per call, no free allowance)', {
+        url: urlProp(true, 'Public http(s) URL of the page'),
+        format: pieces_framework_1.Property.StaticDropdown({
+            displayName: 'Image Format', required: true, defaultValue: 'png',
+            options: { options: [{ label: 'PNG', value: 'png' }, { label: 'JPEG', value: 'jpeg' }] },
+        }),
+        width: pieces_framework_1.Property.Number({ displayName: 'Width', description: '320 to 1920', required: false, defaultValue: 1280 }),
+        height: pieces_framework_1.Property.Number({ displayName: 'Height', description: '200 to 1600', required: false, defaultValue: 800 }),
+        fullPage: pieces_framework_1.Property.Checkbox({ displayName: 'Full Page', required: false, defaultValue: false }),
+    }, '/v1/web/screenshot', false, (p) => ({ url: p['url'], format: p['format'] ?? 'png', width: p['width'] ?? 1280, height: p['height'] ?? 800, full_page: p['fullPage'] === true }), true),
+    act('speech_to_text', 'Speech to Text', 'Transcribe an audio file, with SRT and WebVTT subtitles (USD 0.01 per call, no free allowance)', {
+        file: fileProp, fileUrl: fileUrlProp,
+        language: pieces_framework_1.Property.ShortText({ displayName: 'Spoken Language', description: 'ISO 639-1 code. Empty means detect automatically.', required: false }),
+        translateToEnglish: pieces_framework_1.Property.Checkbox({ displayName: 'Translate to English', required: false, defaultValue: false }),
+    }, '/v1/audio/transcribe', false, (p) => {
+        const body = fileInput(p, 'file_base64', false);
+        if (p['language'])
+            body['language'] = p['language'];
+        if (p['translateToEnglish'] === true)
+            body['translate_to_english'] = true;
+        return body;
+    }),
+    act('translate_text', 'Translate Text', 'Translate text between English and 14 languages (USD 0.003 per call, free daily allowance)', {
+        text: pieces_framework_1.Property.LongText({ displayName: 'Text', description: 'At most 5,000 characters', required: true }),
+        target: pieces_framework_1.Property.ShortText({ displayName: 'Target Language', description: 'en, es, fr, de, pt, it, nl, ru, zh, ja, ko, ar, hi, id or tl', required: true, defaultValue: 'es' }),
+        source: pieces_framework_1.Property.ShortText({ displayName: 'Source Language', description: 'Empty means detect automatically', required: false }),
+    }, '/v1/text/translate', true, (p) => {
+        const body = { text: p['text'], target: p['target'] };
+        if (p['source'])
+            body['source'] = p['source'];
+        return body;
+    }),
+    act('verify_email', 'Verify Email Address', 'Check an email address by syntax and DNS (MX), no mailbox probe (USD 0.001 per call, free daily allowance)', { email: pieces_framework_1.Property.ShortText({ displayName: 'Email Address', required: true }) }, '/v1/email/verify', true, (p) => ({ email: p['email'] })),
+];

package/dist/src/lib/client.d.ts

@@ -0,0 +1,10 @@
+export declare const BASE_URL = "https://tanod.dev";
+export interface CallArgs {
+    path: string;
+    body: Record<string, unknown>;
+    free: boolean;
+    baseUrl?: string;
+    timeoutMs?: number;
+}
+/** POST a JSON body to a Tanod route. Sends X-Tanod-Free: 1 on routes with a free daily allowance. */
+export declare function tanodCall(a: CallArgs): Promise<Record<string, any>>;

package/dist/src/lib/client.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_URL = void 0;
+exports.tanodCall = tanodCall;
+exports.BASE_URL = 'https://tanod.dev';
+const HELP = 'Paid use beyond the free daily allowance needs an x402 payment; see https://tanod.dev/pricing';
+/** POST a JSON body to a Tanod route. Sends X-Tanod-Free: 1 on routes with a free daily allowance. */
+async function tanodCall(a) {
+    const headers = { 'content-type': 'application/json', accept: 'application/json' };
+    if (a.free)
+        headers['X-Tanod-Free'] = '1';
+    const res = await fetch((a.baseUrl ?? exports.BASE_URL) + a.path, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(a.body),
+        signal: AbortSignal.timeout(a.timeoutMs ?? 120_000),
+    });
+    const text = await res.text();
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        data = { raw: text.slice(0, 500) };
+    }
+    if (res.status === 402) {
+        throw new Error(`Tanod payment required: the free daily allowance for this route is used up or does not apply. ${HELP}`);
+    }
+    if (!res.ok) {
+        const d = data?.detail?.message ?? data?.detail ?? data?.error ?? data?.message ?? data?.raw ?? JSON.stringify(data).slice(0, 300);
+        throw new Error(`Tanod ${res.status}: ${typeof d === 'string' ? d : JSON.stringify(d)}`);
+    }
+    return data;
+}

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "@tanod-labs/piece-tanod",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Activepieces piece for Tanod pay-per-call tools: document to Markdown, PDF tables, OCR, PDF to Word, Office to PDF, web page to Markdown, screenshots, speech to text, translation and email verification. Free daily allowance, no account.",
+  "license": "MIT",
+  "homepage": "https://tanod.dev/connect/",
+  "keywords": ["activepieces", "tanod", "pdf", "ocr", "markdown", "x402", "screenshot", "transcription"],
+  "author": { "name": "Tanod", "email": "ops@tanod.dev" },
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json",
+    "test": "node --import tsx --test test/*.test.ts"
+  },
+  "dependencies": {
+    "@activepieces/pieces-framework": "0.32.0",
+    "@activepieces/shared": "0.95.1",
+    "tslib": "^2.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  }
+}