@elvatis_com/openclaw-ispconfig 0.1.2

package/dist/validate.d.ts

@@ -0,0 +1,21 @@
+import { JsonMap } from "./types";
+interface ParamRule {
+    /** Expected value type */
+    type?: "string" | "number" | "boolean";
+    /** Field must be present and non-null */
+    required?: boolean;
+    /** String value must not be empty/whitespace-only */
+    notEmpty?: boolean;
+    /** Allowed values (compared case-insensitively for strings) */
+    enum?: string[];
+}
+interface ToolParamSchema {
+    /** Per-field validation rules */
+    fields?: Record<string, ParamRule>;
+    /** At least one key from each group must be present (OR logic within group) */
+    anyOf?: string[][];
+}
+export declare const TOOL_SCHEMAS: Record<string, ToolParamSchema>;
+export declare function validateParams(toolName: string, params: JsonMap): void;
+export {};
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMlC,UAAU,SAAS;IACjB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,UAAU,eAAe;IACvB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;CACpB;AAQD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAkCxD,CAAC;AAMF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAkDtE"}

package/dist/validate.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_SCHEMAS = void 0;
+exports.validateParams = validateParams;
+const errors_1 = require("./errors");
+// ---------------------------------------------------------------------------
+// Schemas
+// ---------------------------------------------------------------------------
+const DNS_TYPES = ["A", "AAAA", "MX", "TXT", "CNAME"];
+exports.TOOL_SCHEMAS = {
+    isp_provision_site: {
+        fields: {
+            domain: { type: "string", required: true, notEmpty: true },
+            clientName: { type: "string", required: true, notEmpty: true },
+            clientEmail: { type: "string", required: true, notEmpty: true },
+            serverIp: { type: "string" },
+            createMail: { type: "boolean" },
+            createDb: { type: "boolean" },
+            serverId: { type: "number" },
+        },
+    },
+    isp_client_get: {
+        anyOf: [["client_id", "clientId"]],
+    },
+    isp_site_get: {
+        anyOf: [["primary_id", "domain_id", "site_id"]],
+    },
+    isp_dns_record_list: {
+        anyOf: [["zone_id", "zoneId"]],
+    },
+    isp_dns_record_add: {
+        fields: {
+            type: { type: "string", required: true, notEmpty: true, enum: DNS_TYPES },
+        },
+    },
+    isp_dns_record_delete: {
+        fields: {
+            type: { type: "string", required: true, notEmpty: true, enum: DNS_TYPES },
+        },
+    },
+    isp_quota_check: {
+        anyOf: [["client_id", "clientId"]],
+    },
+};
+// ---------------------------------------------------------------------------
+// Validator
+// ---------------------------------------------------------------------------
+function validateParams(toolName, params) {
+    const schema = exports.TOOL_SCHEMAS[toolName];
+    if (!schema)
+        return;
+    const errors = [];
+    if (schema.fields) {
+        for (const [key, rule] of Object.entries(schema.fields)) {
+            const value = params[key];
+            const present = value !== undefined && value !== null;
+            if (rule.required && !present) {
+                errors.push(`Missing required parameter: ${key}`);
+                continue;
+            }
+            if (!present)
+                continue;
+            if (rule.notEmpty && String(value).trim() === "") {
+                errors.push(`Parameter '${key}' must not be empty`);
+            }
+            if (rule.type === "number" && !Number.isFinite(Number(value))) {
+                errors.push(`Parameter '${key}' must be a valid number, got: ${String(value)}`);
+            }
+            if (rule.enum) {
+                const normalized = String(value).toUpperCase();
+                if (!rule.enum.includes(normalized)) {
+                    errors.push(`Parameter '${key}' must be one of [${rule.enum.join(", ")}], got: ${String(value)}`);
+                }
+            }
+        }
+    }
+    if (schema.anyOf) {
+        for (const group of schema.anyOf) {
+            const found = group.some((key) => params[key] !== undefined && params[key] !== null);
+            if (!found) {
+                errors.push(`One of [${group.join(", ")}] is required`);
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new errors_1.ISPConfigError("validation_error", `Validation failed for ${toolName}: ${errors.join("; ")}`, { statusCode: 400 });
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":";;;AAuEA,wCAkDC;AAzHD,qCAA0C;AAyB1C,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAEzC,QAAA,YAAY,GAAoC;IAC3D,kBAAkB,EAAE;QAClB,MAAM,EAAE;YACN,MAAM,EAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC/D,UAAU,EAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC/D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC/D,QAAQ,EAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,UAAU,EAAG,EAAE,IAAI,EAAE,SAAS,EAAE;YAChC,QAAQ,EAAK,EAAE,IAAI,EAAE,SAAS,EAAE;YAChC,QAAQ,EAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;SAChC;KACF;IACD,cAAc,EAAE;QACd,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;KACnC;IACD,YAAY,EAAE;QACZ,KAAK,EAAE,CAAC,CAAC,YAAY,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;KAChD;IACD,mBAAmB,EAAE;QACnB,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;KAC/B;IACD,kBAAkB,EAAE;QAClB,MAAM,EAAE;YACN,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;SAC1E;KACF;IACD,qBAAqB,EAAE;QACrB,MAAM,EAAE;YACN,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;SAC1E;KACF;IACD,eAAe,EAAE;QACf,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;KACnC;CACF,CAAC;AAEF,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,SAAgB,cAAc,CAAC,QAAgB,EAAE,MAAe;IAC9D,MAAM,MAAM,GAAG,oBAAY,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;YAEtD,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC9B,MAAM,CAAC,IAAI,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;gBAClD,SAAS;YACX,CAAC;YAED,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,IAAI,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACjD,MAAM,CAAC,IAAI,CAAC,cAAc,GAAG,qBAAqB,CAAC,CAAC;YACtD,CAAC;YAED,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC9D,MAAM,CAAC,IAAI,CAAC,cAAc,GAAG,kCAAkC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClF,CAAC;YAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;oBACpC,MAAM,CAAC,IAAI,CAAC,cAAc,GAAG,qBAAqB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACpG,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;YACrF,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,uBAAc,CAAC,kBAAkB,EACzC,yBAAyB,QAAQ,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACzD,EAAE,UAAU,EAAE,GAAG,EAAE,CACpB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/openclaw.plugin.json

@@ -0,0 +1,81 @@
+{
+  "name": "ISPConfig",
+  "version": "0.1.2",
+  "description": "Manage ISPConfig servers: automated site provisioning, domains, mailboxes, DNS, databases, SSL, backups, and more.",
+  "config": {
+    "apiUrl": {
+      "type": "string",
+      "description": "ISPConfig Remote JSON API URL (e.g. https://server:8080/remote/json.php)",
+      "required": true
+    },
+    "username": {
+      "type": "string",
+      "description": "ISPConfig remote API username",
+      "required": true
+    },
+    "password": {
+      "type": "string",
+      "description": "ISPConfig remote API password",
+      "required": true,
+      "secret": true
+    },
+    "serverId": {
+      "type": "number",
+      "description": "Default ISPConfig server ID (usually 1 for single-server setups)",
+      "default": 1
+    },
+    "defaultServerIp": {
+      "type": "string",
+      "description": "Default server IP for DNS A records"
+    },
+    "readOnly": {
+      "type": "boolean",
+      "description": "If true, only read operations are allowed",
+      "default": false
+    },
+    "allowedOperations": {
+      "type": "array",
+      "description": "Whitelist of allowed tool names. Empty = all allowed.",
+      "items": { "type": "string" },
+      "default": []
+    },
+    "verifySsl": {
+      "type": "boolean",
+      "description": "Verify SSL certificate of ISPConfig server",
+      "default": true
+    }
+  },
+  "tools": [
+    "isp_methods_list",
+    "isp_system_info",
+    "isp_provision_site",
+    "isp_client_list",
+    "isp_client_add",
+    "isp_client_get",
+    "isp_sites_list",
+    "isp_site_get",
+    "isp_site_add",
+    "isp_domains_list",
+    "isp_domain_add",
+    "isp_dns_zone_list",
+    "isp_dns_zone_add",
+    "isp_dns_record_list",
+    "isp_dns_record_add",
+    "isp_dns_record_delete",
+    "isp_mail_domain_list",
+    "isp_mail_domain_add",
+    "isp_mail_user_list",
+    "isp_mail_user_add",
+    "isp_mail_user_delete",
+    "isp_db_list",
+    "isp_db_add",
+    "isp_db_user_add",
+    "isp_ssl_status",
+    "isp_quota_check",
+    "isp_backup_list",
+    "isp_shell_user_add",
+    "isp_ftp_user_add",
+    "isp_cron_list",
+    "isp_cron_add"
+  ]
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@elvatis_com/openclaw-ispconfig",
+  "version": "0.1.2",
+  "description": "OpenClaw plugin for ISPConfig server management - domains, mailboxes, databases, DNS, websites",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "keywords": [
+    "openclaw",
+    "ispconfig",
+    "hosting",
+    "dns",
+    "mailbox",
+    "server-management"
+  ],
+  "author": "Elvatis <info@example.invalid>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elvatis/openclaw-ispconfig.git"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.0",
+    "@types/jest": "^29.5.0"
+  },
+  "openclaw": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  }
+}