nango 0.60.3 → 0.60.5

package/lib/ai/instructions/basics.md

@@ -0,0 +1,81 @@
+You are an expert at building custom integrations for Nango. Follow the instructions below to build robust, well-tested integrations that follow Nango architecture and patterns.
+
+## About Nango
+
+Nango is a platform for building and managing API integrations. You'll be working with:
+- **Syncs**: Continuous data synchronization from external APIs
+- **Actions**: One-time operations that interact with external APIs
+- **Providers**: External services (like GitHub, Slack, HubSpot, etc.)
+
+Official Nango documentation is available at https://docs.nango.dev
+
+## Development Environment
+
+Before starting any integration work:
+
+1. **Working Nango integrations folder**: Ensure you are in an existing `nango-integrations` directory or run `nango init`
+2. **Environment setup**: `.env` file must be configured with development environment secret. If not, ask the user to provide the secret key (found in [dashboard settings](https://app.nango.dev/dev/environment-settings)) 
+3. **Provider configured**: The provider should be configured in the [Nango dashboard](https://app.nango.dev/dev/integrations)
+4. **Test connection**: If possible at least one working test connection for the target provider
+
+## When Building Integrations
+
+### Essential Information to Gather
+
+Before implementing, always ask for:
+- **Provider name** (e.g., "github", "slack", "hubspot")
+- **Integration name** (descriptive name for the specific integration. ex: create-contact, list-issues)
+- **Type**: sync or action. Try to infer from the instructions. if in doubt, ask the user
+
+If possible the users must also provide:
+- **Output schema**: Expected data structure
+- **Field mapping**: How API fields map to desired output
+- **API documentation links**
+- **Specific API endpoints** to call
+- **Test connection ID** (enables testing with `nango dryrun`)
+
+### Effective Implementation Process
+
+1. **Start simple**: For example, begin with basic data fetching
+2. **Search the web for API documentation**: Retrieve details about how to use API endpoints from provider official documentation
+3. **Test frequently**: Use `nango dryrun <integration-name> <connection-id> --validation [--input '{...}']` after each change
+4. **Review thoroughly**: Check for code artifacts and ensure code quality
+
+### DO NOT
+
+- Do NOT set Authorization header (Nango handles this automatically)
+- Do NOT run `nango deploy`
+- Do NOT edit the models.ts file. It is automatically generated at compilation time.
+- Do NOT prefix the integration name and/or folder with `integrations`
+
+### Compile 
+
+Run `nango compile` to generate the models and compile the typescript code.
+
+### Testing Commands
+
+Always use these commands to validate your integration:
+```bash
+# Basic test
+nango dryrun <integration-name> <connection-id>
+
+# Test with validation
+nango dryrun <integration-name> <connection-id> --validation
+
+# Test action with input
+nango dryrun <integration-name> <connection-id> --validation --input '{"key": "value"}'
+```
+
+### Code Quality Checklist
+
+Always verify:
+- [ ] Code is compiling without any error: `nango compile`
+- [ ] API endpoints are correctly implemented (search for actual API docs)
+- [ ] Proper query parameters and/or request body are used 
+- [ ] Input and output validation is implemented
+- [ ] Error handling covers common failure scenarios
+- [ ] Pagination is implemented correctly if needed
+- [ ] Data models match the expected schema
+- [ ] All debugging code and artifacts are removed
+- [ ] `nango dryrun` run successfully without errors. If input are required, provider JSON input examples.
+

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "nango",
-    "version": "0.60.3",
+    "version": "0.60.5",
     "description": "Nango's CLI tool.",
     "type": "module",
     "bin": {
@@ -33,9 +33,9 @@
         "@babel/traverse": "7.27.3",
         "@babel/types": "7.27.3",
         "@babel/preset-typescript": "7.27.1",
-        "@nangohq/nango-yaml": "0.60.3",
-        "@nangohq/node": "0.60.3",
-        "@nangohq/runner-sdk": "0.60.3",
+        "@nangohq/nango-yaml": "0.60.5",
+        "@nangohq/node": "0.60.5",
+        "@nangohq/runner-sdk": "0.60.5",
         "@swc/core": "^1.5.25",
         "@types/unzipper": "^0.10.11",
         "ajv": "^8.17.1",
@@ -68,7 +68,7 @@
         "zod": "3.24.2"
     },
     "devDependencies": {
-        "@nangohq/types": "0.60.3",
+        "@nangohq/types": "0.60.5",
         "@types/babel__core": "7.20.5",
         "@types/babel__traverse": "7.20.7",
         "@types/columnify": "1.5.4",
@@ -94,6 +94,7 @@
         "example/**/*",
         "lib/nango.yaml.schema.v1.json",
         "lib/nango.yaml.schema.v2.json",
+        "lib/ai/instructions/*",
         "scripts/v1-v2.js",
         "tsconfig.dev.json",
         "README.md"