@dainprotocol/service-sdk 1.0.44 → 1.0.45

package/dist/__tests__/api-sdk.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/api-sdk.test.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const api_sdk_1 = require("../client/api-sdk");
+const client_auth_1 = require("../client/client-auth");
+const ed25519_1 = require("@noble/curves/ed25519");
+const bs58_1 = tslib_1.__importDefault(require("bs58"));
+const nodeService_1 = require("../service/nodeService");
+const zod_1 = require("zod");
+describe("DainSDK", () => {
+    const privateKey = ed25519_1.ed25519.utils.randomPrivateKey();
+    const publicKey = ed25519_1.ed25519.getPublicKey(privateKey);
+    const clientPrivateKey = ed25519_1.ed25519.utils.randomPrivateKey();
+    const agentAuth = new client_auth_1.DainClientAuth({
+        privateKeyBase58: bs58_1.default.encode(clientPrivateKey),
+        agentId: "agent-12",
+        orgId: "org-12",
+    });
+    // Create test tools with different schema types
+    const simpleTestTool = (0, nodeService_1.createTool)({
+        id: "simple-test-tool",
+        name: "my-test-tool-name",
+        description: "Test tool with simple types",
+        input: zod_1.z.object({
+            stringParam: zod_1.z.string().describe("A string parameter"),
+            numberParam: zod_1.z.number().describe("A number parameter"),
+            booleanParam: zod_1.z.boolean().describe("A boolean parameter"),
+            optionalParam: zod_1.z.string().optional().describe("An optional parameter"),
+            enumParam: zod_1.z.enum(["option1", "option2", "option3"]).describe("An enum parameter"),
+        }),
+        output: zod_1.z.object({ result: zod_1.z.string() }),
+        pricing: { pricePerUse: 0.01, currency: "USD" },
+        handler: async ({ stringParam }) => ({
+            text: `Processed: ${stringParam}`,
+            data: { result: `Processed: ${stringParam}` },
+            ui: null,
+        }),
+    });
+    const complexTestTool = (0, nodeService_1.createTool)({
+        id: "complex-test-tool",
+        name: "complex-tool-name",
+        description: "Test tool with complex types",
+        input: zod_1.z.object({
+            arrayParam: zod_1.z.array(zod_1.z.string()).describe("Array of strings"),
+            objectParam: zod_1.z.object({
+                nested: zod_1.z.number(),
+                deeplyNested: zod_1.z.object({
+                    value: zod_1.z.boolean(),
+                }),
+            }).describe("Nested object"),
+            unionParam: zod_1.z.union([
+                zod_1.z.string(),
+                zod_1.z.number(),
+            ]).describe("String or number"),
+            recordParam: zod_1.z.record(zod_1.z.string(), zod_1.z.number()).describe("Record of numbers"),
+            defaultParam: zod_1.z.string().default("default value"),
+        }),
+        output: zod_1.z.object({ result: zod_1.z.string() }),
+        pricing: { pricePerUse: 0.01, currency: "USD" },
+        handler: async () => ({
+            text: "Processed complex input",
+            data: { result: "Processed complex input" },
+            ui: null,
+        }),
+    });
+    // Create test service with both tools
+    const dainService = (0, nodeService_1.defineDAINService)({
+        metadata: {
+            title: "Test DAIN Service",
+            description: "A test DAIN service",
+            version: "1.0.0",
+            author: "Test Author",
+            tags: ["test"],
+        },
+        identity: {
+            publicKey: bs58_1.default.encode(publicKey),
+            agentId: "test-agent",
+            orgId: "test-org",
+            privateKey: bs58_1.default.encode(privateKey),
+        },
+        tools: [simpleTestTool, complexTestTool],
+    });
+    let server;
+    let sdk;
+    beforeAll(async () => {
+        server = await dainService.startNode({ port: 3003 });
+        sdk = new api_sdk_1.DainSDK("http://localhost:3003", agentAuth);
+        await sdk.initialize();
+    });
+    afterAll(async () => {
+        if (server) {
+            await server.shutdown();
+        }
+    });
+    describe("Method Name Sanitization", () => {
+        it("should convert hyphenated names to camelCase", () => {
+            // @ts-ignore - Accessing private method for testing
+            const sanitizedName = sdk["sanitizeMethodName"]("my-test-tool-name");
+            expect(sanitizedName).toBe("myTestToolName");
+        });
+        it("should convert underscored names to camelCase", () => {
+            // @ts-ignore - Accessing private method for testing
+            const sanitizedName = sdk["sanitizeMethodName"]("my_test_tool_name");
+            expect(sanitizedName).toBe("myTestToolName");
+        });
+        it("should handle spaces in names", () => {
+            // @ts-ignore - Accessing private method for testing
+            const sanitizedName = sdk["sanitizeMethodName"]("my test tool name");
+            expect(sanitizedName).toBe("myTestToolName");
+        });
+        it("should handle mixed separators", () => {
+            // @ts-ignore - Accessing private method for testing
+            const sanitizedName = sdk["sanitizeMethodName"]("my-test_tool name");
+            expect(sanitizedName).toBe("myTestToolName");
+        });
+        it("should preserve case for acronyms", () => {
+            // @ts-ignore - Accessing private method for testing
+            const sanitizedName = sdk["sanitizeMethodName"]("get-JSON-data");
+            expect(sanitizedName).toBe("getJsonData");
+        });
+    });
+    describe("SDK Integration", () => {
+        it("should initialize and create methods for tools", () => {
+            // @ts-ignore - Accessing generated method
+            expect(typeof sdk.myTestToolName).toBe("function");
+        });
+        it("should be able to call the tool with sanitized name", async () => {
+            // @ts-ignore - Accessing generated method
+            const result = await sdk.myTestToolName({
+                stringParam: "test",
+                numberParam: 42,
+                booleanParam: true,
+                enumParam: "option1"
+            });
+            expect(result.data.result).toBe("Processed: test");
+        });
+        it("should fail gracefully with invalid parameters", async () => {
+            // @ts-ignore - Accessing generated method
+            await expect(sdk.myTestToolName({ invalid: "param" }))
+                .rejects
+                .toThrow(/Invalid parameters/);
+        });
+        it("should generate documentation with both original and sanitized names", async () => {
+            const docs = await sdk.getDocumentation();
+            expect(docs).toContain("my-test-tool-name");
+            expect(docs).toContain("myTestToolName");
+            expect(docs).toContain("Test tool with simple types");
+        });
+    });
+    describe("SDK Schema Validation", () => {
+        describe("Simple Types", () => {
+            it("should validate simple types correctly", async () => {
+                // @ts-ignore - Accessing generated method
+                const result = await sdk.myTestToolName({
+                    stringParam: "test",
+                    numberParam: 42,
+                    booleanParam: true,
+                    enumParam: "option1",
+                });
+                expect(result.data.result).toBe("Processed: test");
+            });
+            it("should handle optional parameters", async () => {
+                // @ts-ignore - Accessing generated method
+                const result = await sdk.myTestToolName({
+                    stringParam: "test",
+                    numberParam: 42,
+                    booleanParam: true,
+                    enumParam: "option1",
+                    // optionalParam omitted
+                });
+                expect(result.data.result).toBe("Processed: test");
+            });
+            it("should reject invalid enum values", async () => {
+                // @ts-ignore - Accessing generated method
+                await expect(sdk.myTestToolName({
+                    stringParam: "test",
+                    numberParam: 42,
+                    booleanParam: true,
+                    enumParam: "invalid-option",
+                })).rejects.toThrow(/Invalid/);
+            });
+        });
+        describe("Complex Types", () => {
+            it("should validate complex types correctly", async () => {
+                // @ts-ignore - Accessing generated method
+                const result = await sdk.complexToolName({
+                    arrayParam: ["one", "two"],
+                    objectParam: {
+                        nested: 42,
+                        deeplyNested: {
+                            value: true,
+                        },
+                    },
+                    unionParam: "string-or-number",
+                    recordParam: {
+                        key1: 1,
+                        key2: 2,
+                    },
+                });
+                expect(result.data.result).toBe("Processed complex input");
+            });
+            it("should apply default values", async () => {
+                // @ts-ignore - Accessing generated method
+                const result = await sdk.complexToolName({
+                    arrayParam: ["one"],
+                    objectParam: {
+                        nested: 42,
+                        deeplyNested: {
+                            value: true,
+                        },
+                    },
+                    unionParam: 123,
+                    recordParam: {},
+                    // defaultParam will use default value
+                });
+                expect(result.data.result).toBe("Processed complex input");
+            });
+            it("should reject invalid nested types", async () => {
+                // @ts-ignore - Accessing generated method
+                await expect(sdk.complexToolName({
+                    arrayParam: ["one"],
+                    objectParam: {
+                        nested: "not-a-number", // Should be number
+                        deeplyNested: {
+                            value: true,
+                        },
+                    },
+                    unionParam: true, // Should be string or number
+                    recordParam: {},
+                })).rejects.toThrow(/Invalid/);
+            });
+        });
+    });
+});
+//# sourceMappingURL=api-sdk.test.js.map

package/dist/__tests__/api-sdk.test.js.map

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

package/dist/client/api-sdk.d.ts

@@ -0,0 +1,50 @@
+import { DainClientAuth } from './client-auth';
+import type { ServiceMetadata, ToolConfig } from './types';
+import { z } from 'zod';
+type ToolMethod<T extends z.ZodType, U extends z.ZodType> = (params: z.infer<T>) => Promise<{
+    data: z.infer<U>;
+    text: string;
+    ui: any;
+}>;
+type ToolMethods<T extends Record<string, ToolConfig>> = {
+    [K in keyof T]: ToolMethod<z.ZodType<any>, z.ZodType<any>>;
+};
+export declare class DainSDK {
+    private connection;
+    private toolsCache;
+    private metadata?;
+    constructor(baseUrl: string, auth: DainClientAuth);
+    /**
+     * Initializes the SDK by loading all tools and metadata.
+     * This must be called before using any tool methods.
+     * @throws {Error} If the connection fails or service is unavailable
+     */
+    initialize(): Promise<this & ToolMethods<Record<string, ToolConfig>>>;
+    /**
+     * Returns comprehensive documentation for all available tools and services
+     * @returns {Promise<string>} Markdown formatted documentation
+     */
+    getDocumentation(): Promise<string>;
+    /**
+     * Returns the raw schema documentation for a specific tool
+     * @param toolId The ID of the tool
+     */
+    getToolSchema(toolId: string): Promise<{
+        input: z.ZodType;
+        output: z.ZodType;
+        description: string;
+    }>;
+    private generateSchemaDocumentation;
+    private generateExampleParams;
+    private sanitizeMethodName;
+    private generateToolMethods;
+    /**
+     * Returns the metadata about the connected service
+     */
+    getServiceInfo(): ServiceMetadata | undefined;
+    /**
+     * Returns all available tool configurations
+     */
+    getAvailableTools(): ToolConfig[];
+}
+export {};

package/dist/client/api-sdk.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DainSDK = void 0;
+const client_1 = require("./client");
+const convertToVercelTool_1 = require("../lib/convertToVercelTool");
+class DainSDK {
+    connection;
+    toolsCache = new Map();
+    metadata;
+    constructor(baseUrl, auth) {
+        this.connection = new client_1.DainServiceConnection(baseUrl, auth);
+    }
+    /**
+     * Initializes the SDK by loading all tools and metadata.
+     * This must be called before using any tool methods.
+     * @throws {Error} If the connection fails or service is unavailable
+     */
+    async initialize() {
+        // Load metadata and cache it
+        this.metadata = await this.connection.getMetadata();
+        // Cache all tools
+        const tools = await this.connection.getTools();
+        tools.forEach(tool => this.toolsCache.set(tool.id, tool));
+        // Dynamically add methods for each tool
+        await this.generateToolMethods();
+        return this;
+    }
+    /**
+     * Returns comprehensive documentation for all available tools and services
+     * @returns {Promise<string>} Markdown formatted documentation
+     */
+    async getDocumentation() {
+        if (!this.metadata) {
+            throw new Error('SDK not initialized. Call initialize() first.');
+        }
+        let docs = `# ${this.metadata.title} API Documentation\n\n`;
+        docs += `${this.metadata.description}\n\n`;
+        docs += `Version: ${this.metadata.version}\n`;
+        docs += `Author: ${this.metadata.author}\n\n`;
+        // Add service capabilities
+        docs += `## Service Capabilities\n\n`;
+        docs += `- ${this.metadata.tags.join('\n- ')}\n\n`;
+        // Document all available tools
+        docs += `## Available Tools\n\n`;
+        for (const [_, tool] of this.toolsCache) {
+            docs += `### ${tool.name}\n\n`;
+            docs += `**Method Name:** \`${this.sanitizeMethodName(tool.name)}\`\n\n`;
+            docs += `${tool.description}\n\n`;
+            // Document input schema
+            docs += `**Input Schema:**\n\`\`\`typescript\n`;
+            docs += this.generateSchemaDocumentation(tool.inputSchema);
+            docs += `\n\`\`\`\n\n`;
+            // Add example usage
+            docs += `**Example Usage:**\n\`\`\`typescript\n`;
+            docs += `const result = await sdk.${this.sanitizeMethodName(tool.name)}({\n`;
+            docs += this.generateExampleParams(tool.inputSchema);
+            docs += `});\n`;
+            docs += `\`\`\`\n(Example Parameters are just placeholders for the type, they are not real values)\n\n`;
+        }
+        return docs;
+    }
+    /**
+     * Returns the raw schema documentation for a specific tool
+     * @param toolId The ID of the tool
+     */
+    async getToolSchema(toolId) {
+        const tool = this.toolsCache.get(toolId);
+        if (!tool) {
+            throw new Error(`Tool ${toolId} not found`);
+        }
+        return {
+            input: tool.inputSchema,
+            output: tool.outputSchema,
+            description: tool.description
+        };
+    }
+    generateSchemaDocumentation(schema, indent = '  ') {
+        let docs = '';
+        if (schema.description) {
+            docs += `${indent}// ${schema.description}\n`;
+        }
+        switch (schema.type) {
+            case 'ZodObject':
+                docs += `${indent}{\n`;
+                for (const [key, value] of Object.entries(schema.shape)) {
+                    docs += `${indent}  ${key}: ${this.generateSchemaDocumentation(value, indent + '  ')}\n`;
+                }
+                docs += `${indent}}`;
+                break;
+            case 'ZodString':
+                docs += `string`;
+                break;
+            case 'ZodNumber':
+                docs += `number`;
+                break;
+            case 'ZodBoolean':
+                docs += `boolean`;
+                break;
+            case 'ZodArray':
+                docs += `Array<${this.generateSchemaDocumentation(schema.element, indent)}>`;
+                break;
+            case 'ZodEnum':
+                docs += `${schema.values.map((v) => `"${v}"`).join(' | ')}`;
+                break;
+            default:
+                docs += `any`;
+        }
+        return docs;
+    }
+    generateExampleParams(schema, indent = '  ') {
+        let example = '';
+        if (schema.type === 'ZodObject') {
+            for (const [key, value] of Object.entries(schema.shape)) {
+                example += `${indent}${key}: `;
+                switch (value.type) {
+                    case 'ZodString':
+                        example += `"example_string"`;
+                        break;
+                    case 'ZodNumber':
+                        example += `123`;
+                        break;
+                    case 'ZodBoolean':
+                        example += `true`;
+                        break;
+                    case 'ZodArray':
+                        example += `[]`;
+                        break;
+                    case 'ZodEnum':
+                        example += `"${value.values[0]}"`;
+                        break;
+                    default:
+                        example += `{}`;
+                }
+                example += `,\n`;
+            }
+        }
+        return example;
+    }
+    sanitizeMethodName(name) {
+        // First, convert to camelCase
+        const camelCase = name
+            .toLowerCase()
+            .replace(/[-_\s]+(.)?/g, (_, c) => c ? c.toUpperCase() : '')
+            .replace(/[^a-zA-Z0-9]/g, '');
+        // Ensure first character is lowercase
+        return camelCase.charAt(0).toLowerCase() + camelCase.slice(1);
+    }
+    async generateToolMethods() {
+        for (const [toolId, toolConfig] of this.toolsCache) {
+            const methodName = this.sanitizeMethodName(toolConfig.name);
+            this[methodName] = async (params) => {
+                try {
+                    const inputSchema = (0, convertToVercelTool_1.convertHttpToolToVercelAITool)(toolConfig).parameters;
+                    inputSchema.parse(params);
+                }
+                catch (error) {
+                    throw new Error(`Invalid parameters for ${toolConfig.name}: ${error.message}`);
+                }
+                return this.connection.callTool(toolId, params);
+            };
+        }
+    }
+    /**
+     * Returns the metadata about the connected service
+     */
+    getServiceInfo() {
+        return this.metadata;
+    }
+    /**
+     * Returns all available tool configurations
+     */
+    getAvailableTools() {
+        return Array.from(this.toolsCache.values());
+    }
+}
+exports.DainSDK = DainSDK;
+// Example usage with type safety:
+/*
+const auth = new DainClientAuth({ apiKey: 'your_api_key_here' });
+const sdk = await new DainSDK('https://api.example.com', auth).initialize();
+
+// TypeScript now knows about all available methods and their types
+const result = await sdk.getWeather({
+  latitude: 40.7128,
+  longitude: -74.0060
+});
+*/
+//# sourceMappingURL=api-sdk.js.map

package/dist/client/api-sdk.js.map

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

package/dist/client/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./client";
 export * from "./client-auth";
+export * from "./api-sdk";

package/dist/client/index.js

@@ -3,4 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./client"), exports);
 tslib_1.__exportStar(require("./client-auth"), exports);
+tslib_1.__exportStar(require("./api-sdk"), exports);
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;AAAA,mDAAyB;AACzB,wDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;AAAA,mDAAyB;AACzB,wDAA8B;AAC9B,oDAA0B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dainprotocol/service-sdk",
-  "version": "1.0.44",
+  "version": "1.0.45",
   "description": "DAIN Service SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",