@dominusnode/chatgpt 1.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Dominus Node
+
+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,175 @@
+# Dominus Node -- ChatGPT Integration
+
+Full integration for ChatGPT Custom GPTs and OpenAI Assistants API. Includes both an OpenAPI 3.1.0 spec for direct API actions and a TypeScript function handler with 53 tools, PoW solver, SSRF protection, and credential scrubbing.
+
+## Two Usage Modes
+
+### Mode 1: Custom GPT Actions (Schema-Only)
+
+Paste `openapi.yaml` into your Custom GPT action schema. ChatGPT calls the Dominus Node REST API directly.
+
+### Mode 2: Programmatic Handler (Recommended)
+
+Use the TypeScript handler for full security and PoW support:
+
+```ts
+import { createDominusNodeFunctionHandler } from "@dominusnode/chatgpt";
+
+const handler = createDominusNodeFunctionHandler({
+  apiKey: "dn_live_...",
+  baseUrl: "https://api.dominusnode.com",
+});
+
+// Dispatch function calls from ChatGPT
+const balance = await handler("dominusnode_check_balance", {});
+const usage = await handler("dominusnode_check_usage", { period: "week" });
+const fetch = await handler("dominusnode_proxied_fetch", {
+  url: "https://httpbin.org/ip",
+  country: "US",
+  proxy_type: "dc",
+});
+```
+
+## Installation
+
+```bash
+npm install @dominusnode/chatgpt
+# or install from GitHub
+npm install github:Dominus-Node/dominusnode#main --workspace=integrations/chatgpt
+```
+
+## 53 Tools
+
+### Proxy (3)
+
+| Tool                           | Description                                         |
+| ------------------------------ | --------------------------------------------------- |
+| `dominusnode_proxied_fetch`    | Fetch URL through rotating proxy with geo-targeting |
+| `dominusnode_get_proxy_config` | Get proxy endpoints and supported countries         |
+| `dominusnode_get_proxy_status` | Get proxy service status                            |
+
+### Wallet (7)
+
+| Tool                           | Description                           |
+| ------------------------------ | ------------------------------------- |
+| `dominusnode_check_balance`    | Check wallet balance                  |
+| `dominusnode_get_transactions` | View transaction history              |
+| `dominusnode_get_forecast`     | Get spending forecast                 |
+| `dominusnode_check_payment`    | Check crypto invoice status           |
+| `dominusnode_topup_stripe`     | Create Stripe checkout ($5-$1,000)    |
+| `dominusnode_topup_paypal`     | Create PayPal order ($5-$1,000)       |
+| `dominusnode_topup_crypto`     | Create crypto invoice (10 currencies) |
+
+### Usage (3)
+
+| Tool                          | Description                     |
+| ----------------------------- | ------------------------------- |
+| `dominusnode_check_usage`     | Get usage stats for period      |
+| `dominusnode_get_daily_usage` | Get daily breakdown (1-90 days) |
+| `dominusnode_get_top_hosts`   | Get most-accessed domains       |
+
+### Sessions (1)
+
+| Tool                        | Description                |
+| --------------------------- | -------------------------- |
+| `dominusnode_list_sessions` | List active proxy sessions |
+
+### Account (6)
+
+| Tool                              | Description                      |
+| --------------------------------- | -------------------------------- |
+| `dominusnode_register`            | Create account (with PoW solver) |
+| `dominusnode_login`               | Login with email/password        |
+| `dominusnode_get_account_info`    | Get account details              |
+| `dominusnode_verify_email`        | Verify email with token          |
+| `dominusnode_resend_verification` | Resend verification email        |
+| `dominusnode_update_password`     | Change password                  |
+
+### API Keys (3)
+
+| Tool                     | Description    |
+| ------------------------ | -------------- |
+| `dominusnode_list_keys`  | List API keys  |
+| `dominusnode_create_key` | Create API key |
+| `dominusnode_revoke_key` | Revoke API key |
+
+### Plans (3)
+
+| Tool                      | Description          |
+| ------------------------- | -------------------- |
+| `dominusnode_get_plan`    | Get current plan     |
+| `dominusnode_list_plans`  | List available plans |
+| `dominusnode_change_plan` | Switch plan          |
+
+### Agentic Wallets (9)
+
+| Tool                                  | Description                    |
+| ------------------------------------- | ------------------------------ |
+| `dominusnode_create_agentic_wallet`   | Create sub-wallet for AI agent |
+| `dominusnode_fund_agentic_wallet`     | Fund from main wallet          |
+| `dominusnode_agentic_wallet_balance`  | Check sub-wallet balance       |
+| `dominusnode_list_agentic_wallets`    | List all sub-wallets           |
+| `dominusnode_agentic_transactions`    | View sub-wallet transactions   |
+| `dominusnode_freeze_agentic_wallet`   | Freeze sub-wallet              |
+| `dominusnode_unfreeze_agentic_wallet` | Unfreeze sub-wallet            |
+| `dominusnode_delete_agentic_wallet`   | Delete sub-wallet              |
+| `dominusnode_update_wallet_policy`    | Update daily limits/domains    |
+
+### Teams (17)
+
+| Tool                                  | Description            |
+| ------------------------------------- | ---------------------- |
+| `dominusnode_create_team`             | Create team            |
+| `dominusnode_list_teams`              | List teams             |
+| `dominusnode_team_details`            | Get team details       |
+| `dominusnode_team_fund`               | Fund team wallet       |
+| `dominusnode_team_create_key`         | Create team API key    |
+| `dominusnode_team_usage`              | View team transactions |
+| `dominusnode_update_team`             | Update team settings   |
+| `dominusnode_update_team_member_role` | Change member role     |
+| `dominusnode_team_delete`             | Delete team            |
+| `dominusnode_team_revoke_key`         | Revoke team API key    |
+| `dominusnode_team_list_keys`          | List team API keys     |
+| `dominusnode_team_list_members`       | List team members      |
+| `dominusnode_team_add_member`         | Add team member        |
+| `dominusnode_team_remove_member`      | Remove team member     |
+| `dominusnode_team_invite_member`      | Invite member by email |
+| `dominusnode_team_list_invites`       | List pending invites   |
+| `dominusnode_team_cancel_invite`      | Cancel invite          |
+
+### x402 (1)
+
+| Tool                    | Description                |
+| ----------------------- | -------------------------- |
+| `dominusnode_x402_info` | Get x402 micropayment info |
+
+## Security
+
+- SSRF: DNS rebinding protection, private IP blocking, hex/octal/decimal normalization
+- OFAC: Sanctioned countries (CU, IR, KP, RU, SY) blocked
+- Credential scrubbing: `dn_live_*`, `dn_test_*`, `dn_proxy_*` redacted from errors
+- Prototype pollution: Recursive `stripDangerousKeys` on all JSON parsing
+- Response size cap: 10MB max
+- HTTP methods: Only GET, HEAD, OPTIONS for proxied fetch
+- PoW solver: SHA-256 challenge solver for CAPTCHA-free registration
+
+## Custom GPT Setup (Schema-Only Mode)
+
+1. Go to [ChatGPT](https://chat.openai.com) > **Explore GPTs** > **Create a GPT**
+2. In **Actions**, paste the contents of `openapi.yaml`
+3. Set auth to **Bearer** and paste your JWT token
+4. JWT tokens expire in 15 minutes; refresh via POST `/api/auth/refresh`
+
+## Files
+
+| File              | Description                                 |
+| ----------------- | ------------------------------------------- |
+| `handler.ts`      | 53-tool function handler with full security |
+| `handler.test.ts` | 131 test cases (SSRF, validation, dispatch) |
+| `functions.json`  | Tool definitions for LLM function calling   |
+| `openapi.yaml`    | OpenAPI 3.1.0 spec for Custom GPT actions   |
+| `ai-plugin.json`  | Legacy ChatGPT plugin manifest              |
+
+## License
+
+MIT License. See [LICENSE](./LICENSE).

package/ai-plugin.json

@@ -0,0 +1,18 @@
+{
+  "schema_version": "v1",
+  "name_for_human": "Dominus Node Proxy",
+  "name_for_model": "dominusnode",
+  "description_for_human": "Access rotating proxy network for web scraping with geo-targeting, wallet management, and team billing.",
+  "description_for_model": "Dominus Node provides rotating proxy-as-a-service with datacenter ($3/GB) and residential ($5/GB) proxies. Use this to manage proxy API keys, check wallet balance, monitor usage, create agentic sub-wallets for AI agents, manage teams with shared billing, and top up via Stripe, crypto, or PayPal.",
+  "auth": {
+    "type": "user_http",
+    "authorization_type": "bearer"
+  },
+  "api": {
+    "type": "openapi",
+    "url": "https://api.dominusnode.com/.well-known/openapi.yaml"
+  },
+  "logo_url": "https://dominusnode.com/logo.png",
+  "contact_email": "support@dominusnode.com",
+  "legal_info_url": "https://dominusnode.com/legal"
+}

package/dist/handler.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Dominus Node ChatGPT Actions / function calling handler (TypeScript).
+ *
+ * 53 tools covering proxy, wallet, usage, account lifecycle, API keys,
+ * plans, and teams.
+ *
+ * Provides a factory function that creates a handler for dispatching
+ * ChatGPT function calls to the Dominus Node REST API. Designed for
+ * ChatGPT Custom GPTs (Actions), OpenAI Assistants API, and any
+ * OpenAI-compatible function-calling system.
+ *
+ * @example
+ * ```ts
+ * import { createDominusNodeFunctionHandler } from "./handler";
+ *
+ * const handler = createDominusNodeFunctionHandler({
+ *   apiKey: "dn_live_...",
+ *   baseUrl: "https://api.dominusnode.com",
+ * });
+ *
+ * // Handle an action call from a ChatGPT Custom GPT
+ * const result = await handler("dominusnode_check_balance", {});
+ * console.log(result); // JSON string with balance info
+ * ```
+ *
+ * @module
+ */
+/**
+ * Normalize non-standard IPv4 representations (hex, octal, decimal integer)
+ * to standard dotted-decimal to prevent SSRF bypasses like 0x7f000001,
+ * 2130706433, or 0177.0.0.1.
+ */
+declare function normalizeIpv4(hostname: string): string | null;
+declare function isPrivateIp(hostname: string): boolean;
+/**
+ * Validate a URL for safety before sending through the proxy.
+ * Blocks private IPs, localhost, internal hostnames, and non-HTTP(S) protocols.
+ *
+ * @throws {Error} If the URL is invalid or targets a private/blocked address.
+ */
+declare function validateUrl(url: string): URL;
+declare function stripDangerousKeys(obj: unknown, depth?: number): void;
+declare function safeJsonParse<T>(text: string): T;
+declare function sanitizeError(message: string): string;
+export interface DominusNodeFunctionConfig {
+    /** Dominus Node API key (starts with dn_live_ or dn_test_). */
+    apiKey: string;
+    /** Base URL of the Dominus Node REST API. Defaults to https://api.dominusnode.com */
+    baseUrl?: string;
+    /** Request timeout in milliseconds. Defaults to 30000. */
+    timeoutMs?: number;
+    /** Agent secret for MCP agent identification. Bypasses reCAPTCHA and auto-verifies email. */
+    agentSecret?: string;
+}
+/**
+ * Handler function type returned by createDominusNodeFunctionHandler.
+ * Dispatches function calls to the Dominus Node API and returns JSON string results.
+ */
+export type FunctionHandler = (name: string, args: Record<string, unknown>) => Promise<string>;
+/**
+ * Create a Dominus Node function handler for OpenAI-compatible function calling.
+ *
+ * Authenticates using the provided API key, then returns a handler function
+ * that dispatches function calls to the appropriate Dominus Node REST API endpoint.
+ *
+ * @param config - API key and optional base URL / timeout.
+ * @returns A handler function: (name, args) => Promise<string>
+ *
+ * @example
+ * ```ts
+ * import { createDominusNodeFunctionHandler } from "./handler";
+ *
+ * const handler = createDominusNodeFunctionHandler({
+ *   apiKey: "dn_live_abc123",
+ *   baseUrl: "https://api.dominusnode.com",
+ * });
+ *
+ * // Handle a function call from an LLM
+ * const result = await handler("dominusnode_check_balance", {});
+ * console.log(JSON.parse(result));
+ * // { balanceCents: 5000, balanceUsd: 50.00, currency: "USD", lastToppedUp: "..." }
+ * ```
+ */
+export { isPrivateIp, validateUrl, normalizeIpv4, sanitizeError, stripDangerousKeys, safeJsonParse, };
+export declare function createDominusNodeFunctionHandler(config: DominusNodeFunctionConfig): FunctionHandler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AA4EH;;;;GAIG;AACH,iBAAS,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoCtD;AAED,iBAAS,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CA6E9C;AAED;;;;;GAKG;AACH,iBAAS,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CA0CrC;AAcD,iBAAS,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,IAAI,CAczD;AAED,iBAAS,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAIzC;AAmDD,iBAAS,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9C;AAqBD,MAAM,WAAW,yBAAyB;IACxC,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAoGD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EACL,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,aAAa,GACd,CAAC;AAEF,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,yBAAyB,GAChC,eAAe,CAq4DjB"}