@dominusnode/flowise-tools 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @dominusnode/flowise-tools
+ *
+ * DomiNode rotating proxy tools for Flowise AI.
+ *
+ * Exposes a DominusNodeToolkit class that produces LangChain-compatible
+ * DynamicStructuredTool instances for use inside Flowise workflows.
+ *
+ * @example
+ * ```ts
+ * import { DominusNodeToolkit } from "@dominusnode/flowise-tools";
+ *
+ * const toolkit = new DominusNodeToolkit({ apiKey: "dn_live_..." });
+ * const tools = toolkit.getTools(); // DynamicStructuredTool[]
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { DominusNodeToolkit } from "./toolkit.js";
+export type { DominusNodeToolkitOptions } from "./toolkit.js";
+export { isPrivateIp, validateTargetUrl, validateCountry, validateUuid, normalizeIpv4, stripDangerousKeys, scrubCredentials, truncate, formatBytes, formatCents, checkDnsRebinding, SANCTIONED_COUNTRIES, BLOCKED_HOSTNAMES, } from "./toolkit.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAG9D,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * @dominusnode/flowise-tools
+ *
+ * DomiNode rotating proxy tools for Flowise AI.
+ *
+ * Exposes a DominusNodeToolkit class that produces LangChain-compatible
+ * DynamicStructuredTool instances for use inside Flowise workflows.
+ *
+ * @example
+ * ```ts
+ * import { DominusNodeToolkit } from "@dominusnode/flowise-tools";
+ *
+ * const toolkit = new DominusNodeToolkit({ apiKey: "dn_live_..." });
+ * const tools = toolkit.getTools(); // DynamicStructuredTool[]
+ * ```
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BLOCKED_HOSTNAMES = exports.SANCTIONED_COUNTRIES = exports.checkDnsRebinding = exports.formatCents = exports.formatBytes = exports.truncate = exports.scrubCredentials = exports.stripDangerousKeys = exports.normalizeIpv4 = exports.validateUuid = exports.validateCountry = exports.validateTargetUrl = exports.isPrivateIp = exports.DominusNodeToolkit = void 0;
+var toolkit_js_1 = require("./toolkit.js");
+Object.defineProperty(exports, "DominusNodeToolkit", { enumerable: true, get: function () { return toolkit_js_1.DominusNodeToolkit; } });
+// Re-export security utilities for testing
+var toolkit_js_2 = require("./toolkit.js");
+Object.defineProperty(exports, "isPrivateIp", { enumerable: true, get: function () { return toolkit_js_2.isPrivateIp; } });
+Object.defineProperty(exports, "validateTargetUrl", { enumerable: true, get: function () { return toolkit_js_2.validateTargetUrl; } });
+Object.defineProperty(exports, "validateCountry", { enumerable: true, get: function () { return toolkit_js_2.validateCountry; } });
+Object.defineProperty(exports, "validateUuid", { enumerable: true, get: function () { return toolkit_js_2.validateUuid; } });
+Object.defineProperty(exports, "normalizeIpv4", { enumerable: true, get: function () { return toolkit_js_2.normalizeIpv4; } });
+Object.defineProperty(exports, "stripDangerousKeys", { enumerable: true, get: function () { return toolkit_js_2.stripDangerousKeys; } });
+Object.defineProperty(exports, "scrubCredentials", { enumerable: true, get: function () { return toolkit_js_2.scrubCredentials; } });
+Object.defineProperty(exports, "truncate", { enumerable: true, get: function () { return toolkit_js_2.truncate; } });
+Object.defineProperty(exports, "formatBytes", { enumerable: true, get: function () { return toolkit_js_2.formatBytes; } });
+Object.defineProperty(exports, "formatCents", { enumerable: true, get: function () { return toolkit_js_2.formatCents; } });
+Object.defineProperty(exports, "checkDnsRebinding", { enumerable: true, get: function () { return toolkit_js_2.checkDnsRebinding; } });
+Object.defineProperty(exports, "SANCTIONED_COUNTRIES", { enumerable: true, get: function () { return toolkit_js_2.SANCTIONED_COUNTRIES; } });
+Object.defineProperty(exports, "BLOCKED_HOSTNAMES", { enumerable: true, get: function () { return toolkit_js_2.BLOCKED_HOSTNAMES; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAEH,2CAAkD;AAAzC,gHAAA,kBAAkB,OAAA;AAG3B,2CAA2C;AAC3C,2CAcsB;AAbpB,yGAAA,WAAW,OAAA;AACX,+GAAA,iBAAiB,OAAA;AACjB,6GAAA,eAAe,OAAA;AACf,0GAAA,YAAY,OAAA;AACZ,2GAAA,aAAa,OAAA;AACb,gHAAA,kBAAkB,OAAA;AAClB,8GAAA,gBAAgB,OAAA;AAChB,sGAAA,QAAQ,OAAA;AACR,yGAAA,WAAW,OAAA;AACX,yGAAA,WAAW,OAAA;AACX,+GAAA,iBAAiB,OAAA;AACjB,kHAAA,oBAAoB,OAAA;AACpB,+GAAA,iBAAiB,OAAA"}

package/dist/toolkit.d.ts

@@ -0,0 +1,100 @@
+/**
+ * DomiNode Flowise Toolkit
+ *
+ * Provides 24 LangChain-compatible DynamicStructuredTool instances for use
+ * inside Flowise AI workflows. Covers proxied fetching, wallet management,
+ * agentic wallets, teams, PayPal top-up, and x402 micropayment info.
+ *
+ * Security:
+ *  - Full SSRF protection (private IP blocking, DNS rebinding, Teredo/6to4,
+ *    IPv4-mapped/compatible IPv6, hex/octal/decimal normalization, zone ID
+ *    stripping, .localhost/.local/.internal/.arpa TLD blocking, embedded
+ *    credential blocking)
+ *  - OFAC sanctioned country validation (CU, IR, KP, RU, SY)
+ *  - Credential scrubbing in all error outputs
+ *  - Prototype pollution prevention on all parsed JSON (recursive)
+ *  - HTTP method restriction (GET/HEAD/OPTIONS only for proxied fetch)
+ *  - 10 MB response cap, 4000 char truncation, 30 s timeout
+ *  - Redirect following disabled to prevent open redirect abuse
+ */
+import { DynamicStructuredTool } from "@langchain/core/tools";
+/** OFAC sanctioned countries -- must never be used as geo-targeting destinations. */
+export declare const SANCTIONED_COUNTRIES: Set<string>;
+/** Remove any dn_live_* or dn_test_* tokens from error messages. */
+export declare function scrubCredentials(msg: string): string;
+export declare function truncate(text: string, max?: number): string;
+export declare const BLOCKED_HOSTNAMES: Set<string>;
+/**
+ * Normalize non-standard IPv4 representations to dotted-decimal.
+ * Handles: decimal integers (2130706433), hex (0x7f000001), octal octets (0177.0.0.1).
+ */
+export declare function normalizeIpv4(hostname: string): string | null;
+export declare function isPrivateIp(hostname: string): boolean;
+/**
+ * Validate a URL for safety before proxying.
+ * Blocks: private IPs, localhost, .local/.internal/.arpa, embedded credentials, non-http(s).
+ */
+export declare function validateTargetUrl(url: string): URL;
+/**
+ * Validate a country code: must be 2 uppercase letters and not OFAC sanctioned.
+ */
+export declare function validateCountry(country: string | undefined): string | undefined;
+/**
+ * Validate a UUID string.
+ */
+export declare function validateUuid(id: string, label: string): string;
+/**
+ * Resolve a hostname via DNS and verify none of the resolved IPs are private.
+ * Skips check if the hostname is already an IP literal.
+ */
+export declare function checkDnsRebinding(hostname: string): Promise<void>;
+export declare function stripDangerousKeys(obj: unknown, depth?: number): void;
+export declare function formatBytes(bytes: number): string;
+export declare function formatCents(cents: number): string;
+export interface DominusNodeToolkitOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    proxyHost?: string;
+    proxyPort?: number;
+    timeout?: number;
+}
+export declare class DominusNodeToolkit {
+    private apiKey;
+    private baseUrl;
+    private proxyHost;
+    private proxyPort;
+    private timeout;
+    private token;
+    private tokenExpiresAt;
+    constructor(options?: DominusNodeToolkitOptions);
+    private _authenticate;
+    private _ensureAuth;
+    private _apiRequest;
+    private _requestWithRetry;
+    proxiedFetch(url: string, method?: string, country?: string, proxyType?: string): Promise<string>;
+    checkBalance(): Promise<string>;
+    checkUsage(days?: number): Promise<string>;
+    getProxyConfig(): Promise<string>;
+    listSessions(): Promise<string>;
+    createAgenticWallet(label: string, spendingLimitCents?: number, dailyLimitCents?: number, allowedDomains?: string[]): Promise<string>;
+    updateWalletPolicy(walletId: string, dailyLimitCents?: number | null, allowedDomains?: string[] | null): Promise<string>;
+    fundAgenticWallet(walletId: string, amountCents: number): Promise<string>;
+    agenticWalletBalance(walletId: string): Promise<string>;
+    listAgenticWallets(): Promise<string>;
+    agenticTransactions(walletId: string, limit?: number): Promise<string>;
+    freezeAgenticWallet(walletId: string): Promise<string>;
+    unfreezeAgenticWallet(walletId: string): Promise<string>;
+    deleteAgenticWallet(walletId: string): Promise<string>;
+    createTeam(name: string, maxMembers?: number): Promise<string>;
+    listTeams(): Promise<string>;
+    teamDetails(teamId: string): Promise<string>;
+    teamFund(teamId: string, amountCents: number): Promise<string>;
+    teamCreateKey(teamId: string, label: string): Promise<string>;
+    teamUsage(teamId: string, limit?: number): Promise<string>;
+    updateTeam(teamId: string, name?: string, maxMembers?: number): Promise<string>;
+    updateTeamMemberRole(teamId: string, userId: string, role: string): Promise<string>;
+    topupPaypal(amountCents: number): Promise<string>;
+    x402Info(): Promise<string>;
+    getTools(): DynamicStructuredTool[];
+}
+//# sourceMappingURL=toolkit.d.ts.map

package/dist/toolkit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolkit.d.ts","sourceRoot":"","sources":["../src/toolkit.ts"],"names":[],"mappings":"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"}