nango 0.24.11 → 0.24.13

package/dist/sync.js

@@ -14,214 +14,31 @@ import parser from '@babel/parser';
 import traverse from '@babel/traverse';
 import promptly from 'promptly';
 import { loadSimplifiedConfig, cloudHost, stagingHost, SyncType, syncRunService, nangoConfigFile, checkForIntegrationFile } from '@nangohq/shared';
-import { hostport, port, httpsAgent, verifyNecessaryFiles, getConnection, NANGO_INTEGRATIONS_LOCATION, NANGO_INTEGRATIONS_NAME, buildInterfaces, enrichHeaders, getNangoRootPath, printDebug } from './utils.js';
+import { hostport, port, httpsAgent, verifyNecessaryFiles, getConnection, NANGO_INTEGRATIONS_LOCATION, buildInterfaces, enrichHeaders, getNangoRootPath, printDebug } from './utils.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 dotenv.config();
 const TYPES_FILE_NAME = 'models.ts';
 const NangoSyncTypesFileLocation = 'dist/nango-sync.d.ts';
 const exampleSyncName = 'github-issue-example';
-export const version = (debug) => {
-    if (debug) {
-        printDebug('Looking up the version first for a local path first then globally');
-    }
-    const packageJson = JSON.parse(fs.readFileSync(path.resolve(getNangoRootPath(debug), 'package.json'), 'utf8'));
-    const dockerComposeYaml = fs.readFileSync(path.resolve(getNangoRootPath(), 'docker/docker-compose.yaml'), 'utf8');
-    const dockerCompose = yaml.load(dockerComposeYaml);
-    const nangoServerImage = dockerCompose.services['nango-server'].image;
-    const nangoWorkerImage = dockerCompose.services['nango-worker'].image;
-    const nangoServerVersion = nangoServerImage.split(':').pop();
-    const nangoWorkerVersion = nangoWorkerImage.split(':').pop();
-    console.log(chalk.green('Nango Server version:'), nangoServerVersion);
-    console.log(chalk.green('Nango Worker version:'), nangoWorkerVersion);
-    console.log(chalk.green('Nango CLI version:'), packageJson.version);
-};
-/**
- * Init
- * If we're not currently in the nango-integrations directory create one
- * and create an example nango.yaml file
- */
-export const init = (debug = false) => {
-    const data = {
-        integrations: {
-            'demo-github-integration': {
-                [exampleSyncName]: {
-                    runs: 'every half hour',
-                    returns: ['GithubIssue']
-                }
-            }
-        },
-        models: {
-            GithubIssue: {
-                id: 'integer',
-                owner: 'string',
-                repo: 'string',
-                issue_number: 'number',
-                title: 'string',
-                author: 'string',
-                author_id: 'string',
-                state: 'string',
-                date_created: 'date',
-                date_last_modified: 'date',
-                body: 'string'
-            }
-        }
-    };
-    const yamlData = yaml.dump(data);
-    // if currently in the nango-integrations directory then don't create another one
+const createModelFile = (notify = false) => {
     const cwd = process.cwd();
-    const currentDirectorySplit = cwd.split('/');
-    const currentDirectory = currentDirectorySplit[currentDirectorySplit.length - 1];
-    let dirExists = false;
-    let inParentDirectory = true;
-    if (currentDirectory === NANGO_INTEGRATIONS_NAME) {
-        dirExists = true;
-        inParentDirectory = false;
-        if (debug) {
-            printDebug(`Currently in the ${NANGO_INTEGRATIONS_NAME} directory so the directory will not be created`);
-        }
-    }
-    if (fs.existsSync(`./${NANGO_INTEGRATIONS_NAME}`)) {
-        dirExists = true;
-        console.log(chalk.red(`The ${NANGO_INTEGRATIONS_NAME} directory already exists. You should run commands from within this directory`));
-    }
-    if (!dirExists) {
-        if (debug) {
-            printDebug(`Creating the nango integrations directory at ./${NANGO_INTEGRATIONS_NAME}`);
-        }
-        fs.mkdirSync(`./${NANGO_INTEGRATIONS_NAME}`);
-    }
-    const configFileLocation = inParentDirectory ? `./${NANGO_INTEGRATIONS_NAME}/${nangoConfigFile}` : `./${nangoConfigFile}`;
-    if (!fs.existsSync(configFileLocation)) {
-        if (debug) {
-            printDebug(`Creating the ${nangoConfigFile} file at ${configFileLocation}`);
-        }
-        fs.writeFileSync(configFileLocation, yamlData);
-    }
-    else {
-        if (debug) {
-            printDebug(`Nango config file already exists at ${configFileLocation} so not creating a new one`);
-        }
-    }
-    const envFileLocation = inParentDirectory ? `./${NANGO_INTEGRATIONS_NAME}/.env` : './.env';
-    if (!fs.existsSync(envFileLocation)) {
-        if (debug) {
-            printDebug(`Creating the .env file at ${envFileLocation}`);
-        }
-        fs.writeFileSync(envFileLocation, `# Authenticates the CLI (get the keys in the dashboard's Projects Settings).
-#NANGO_SECRET_KEY_DEV=xxxx-xxx-xxxx
-#NANGO_SECRET_KEY_PROD=xxxx-xxx-xxxx
-
-# Nango's instance URL (OSS: change to http://localhost:3003 or your instance URL).
-NANGO_HOSTPORT=https://api.nango.dev # Default value
-
-# How to handle CLI upgrades ("prompt", "auto" or "ignore").
-NANGO_CLI_UPGRADE_MODE=prompt # Default value
-
-# Whether to prompt before deployments.
-NANGO_DEPLOY_AUTO_CONFIRM=false # Default value`);
-    }
-    else {
-        if (debug) {
-            printDebug(`.env file already exists at ${envFileLocation} so not creating a new one`);
-        }
-    }
-    console.log(chalk.green(`Nango integrations initialized!`));
-};
-export const generate = async (debug = false) => {
-    const templateContents = fs.readFileSync(path.resolve(__dirname, './integration.ejs'), 'utf8');
-    const githubExampleTemplateContents = fs.readFileSync(path.resolve(__dirname, './integration.github.ejs'), 'utf8');
-    const configContents = fs.readFileSync(`./${nangoConfigFile}`, 'utf8');
+    const configContents = fs.readFileSync(path.resolve(cwd, `${NANGO_INTEGRATIONS_LOCATION}/${nangoConfigFile}`), 'utf8');
     const configData = yaml.load(configContents);
-    const { integrations } = configData;
     const { models } = configData;
-    const interfaceDefinitions = buildInterfaces(models, debug);
+    const interfaceDefinitions = buildInterfaces(models);
     fs.writeFileSync(`${NANGO_INTEGRATIONS_LOCATION}/${TYPES_FILE_NAME}`, interfaceDefinitions.join('\n'));
-    if (debug) {
-        printDebug(`Interfaces from the ${nangoConfigFile} file written to ${TYPES_FILE_NAME}`);
-    }
     // insert NangoSync types to the bottom of the file
     const typesContent = fs.readFileSync(`${getNangoRootPath()}/${NangoSyncTypesFileLocation}`, 'utf8');
     fs.writeFileSync(`${NANGO_INTEGRATIONS_LOCATION}/${TYPES_FILE_NAME}`, typesContent, { flag: 'a' });
-    if (debug) {
-        printDebug(`NangoSync types written to ${TYPES_FILE_NAME}`);
-    }
-    const allSyncNames = {};
-    for (let i = 0; i < Object.keys(integrations).length; i++) {
-        const providerConfigKey = Object.keys(integrations)[i];
-        if (debug) {
-            printDebug(`Generating ${providerConfigKey} integrations`);
-        }
-        const syncObject = integrations[providerConfigKey];
-        const syncNames = Object.keys(syncObject);
-        for (let k = 0; k < syncNames.length; k++) {
-            const syncName = syncNames[k];
-            if (allSyncNames[syncName] === undefined) {
-                allSyncNames[syncName] = true;
-            }
-            else {
-                console.log(chalk.red(`The sync name ${syncName} is duplicated in the ${nangoConfigFile} file. All sync names must be unique.`));
-                process.exit(1);
-            }
-            if (debug) {
-                printDebug(`Generating ${syncName} integration`);
-            }
-            const syncData = syncObject[syncName];
-            if (!syncData.returns) {
-                console.log(chalk.red(`The ${syncName} integration is missing a returns property for what models the sync returns. Make sure you have "returns" instead of "return"`));
-                process.exit(1);
-            }
-            const { returns: models } = syncData;
-            const syncNameCamel = syncName
-                .split('-')
-                .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
-                .join('');
-            const ejsTeamplateContents = syncName === exampleSyncName ? githubExampleTemplateContents : templateContents;
-            const rendered = ejs.render(ejsTeamplateContents, {
-                syncName: syncNameCamel,
-                interfaceFileName: TYPES_FILE_NAME.replace('.ts', ''),
-                interfaceNames: models.map((model) => {
-                    const singularModel = model?.charAt(model.length - 1) === 's' ? model.slice(0, -1) : model;
-                    return `${singularModel.charAt(0).toUpperCase()}${singularModel.slice(1)}`;
-                }),
-                mappings: models.map((model) => {
-                    const singularModel = model.charAt(model.length - 1) === 's' ? model.slice(0, -1) : model;
-                    return {
-                        name: model,
-                        type: `${singularModel.charAt(0).toUpperCase()}${singularModel.slice(1)}`
-                    };
-                })
-            });
-            if (!fs.existsSync(`${NANGO_INTEGRATIONS_LOCATION}/${syncName}.ts`)) {
-                fs.writeFileSync(`${NANGO_INTEGRATIONS_LOCATION}/${syncName}.ts`, rendered);
-                if (debug) {
-                    printDebug(`Created ${syncName}.ts file`);
-                }
-            }
-            else {
-                if (debug) {
-                    printDebug(`${syncName}.ts file already exists, so will not overwrite it.`);
-                }
-            }
-        }
-    }
-    console.log(chalk.green(`Integration files have been created`));
-};
-const createModelFile = (notify = false) => {
-    const configContents = fs.readFileSync(`./${nangoConfigFile}`, 'utf8');
-    const configData = yaml.load(configContents);
-    const { models } = configData;
-    const interfaceDefinitions = buildInterfaces(models);
-    fs.writeFileSync(`./${TYPES_FILE_NAME}`, interfaceDefinitions.join('\n'));
-    // insert NangoSync types to the bottom of the file
-    const typesContent = fs.readFileSync(`${getNangoRootPath()}/${NangoSyncTypesFileLocation}`, 'utf8');
-    fs.writeFileSync(`./${TYPES_FILE_NAME}`, typesContent, { flag: 'a' });
     if (notify) {
-        console.log(chalk.green(`The ${nangoConfigFile} was updated. The interface file (${TYPES_FILE_NAME}) was updated to reflect the updated config`));
+        const rawNangoIntegrationLocation = NANGO_INTEGRATIONS_LOCATION.replace('./', '');
+        console.log(chalk.green(`${rawNangoIntegrationLocation}/${nangoConfigFile} was updated. The interface file (${rawNangoIntegrationLocation}/${TYPES_FILE_NAME}) was updated to reflect the updated config`));
     }
 };
 const getConfig = async (debug = false) => {
-    const config = await loadSimplifiedConfig('./');
+    const cwd = process.cwd();
+    const config = await loadSimplifiedConfig(path.resolve(cwd, NANGO_INTEGRATIONS_LOCATION));
     if (!config) {
         throw new Error(`Error loading the ${nangoConfigFile} file`);
     }
@@ -230,40 +47,21 @@ const getConfig = async (debug = false) => {
     }
     return config;
 };
-async function parseSecretKey(environment, debug = false) {
-    if (process.env['NANGO_SECRET_KEY_PROD'] && environment === 'prod') {
+export const deploy = async (options, debug = false) => {
+    const { env, version, sync: optionalSyncName, secretKey, host, autoConfirm } = options;
+    await verifyNecessaryFiles(autoConfirm);
+    if (host) {
         if (debug) {
-            printDebug(`Environment is set to prod, setting NANGO_SECRET_KEY to NANGO_SECRET_KEY_PROD.`);
+            printDebug(`Global host flag is set, setting NANGO_HOSTPORT to ${host}.`);
         }
-        process.env['NANGO_SECRET_KEY'] = process.env['NANGO_SECRET_KEY_PROD'];
+        process.env['NANGO_HOSTPORT'] = host;
     }
-    if (process.env['NANGO_SECRET_KEY_DEV'] && environment === 'dev') {
+    if (secretKey) {
         if (debug) {
-            printDebug(`Environment is set to dev, setting NANGO_SECRET_KEY to NANGO_SECRET_KEY_DEV.`);
+            printDebug(`Global secretKey flag is set, setting NANGO_SECRET_KEY.`);
         }
-        process.env['NANGO_SECRET_KEY'] = process.env['NANGO_SECRET_KEY_DEV'];
+        process.env['NANGO_SECRET_KEY'] = secretKey;
     }
-    if (!process.env['NANGO_SECRET_KEY']) {
-        console.log(chalk.red(`NANGO_SECRET_KEY environment variable is not set. Please set it now`));
-        try {
-            const secretKey = await promptly.prompt('Secret Key: ');
-            if (secretKey) {
-                process.env['NANGO_SECRET_KEY'] = secretKey;
-            }
-            else {
-                return;
-            }
-        }
-        catch (error) {
-            console.log('Error occurred while trying to prompt for secret key:', error);
-            process.exit(1);
-        }
-    }
-}
-export const deploy = async (options, environment, debug = false) => {
-    const { env, version, sync: optionalSyncName, autoConfirm } = options;
-    await verifyNecessaryFiles(autoConfirm);
-    await parseSecretKey(environment, debug);
     if (!process.env['NANGO_HOSTPORT']) {
         switch (env) {
             case 'local':
@@ -279,10 +77,26 @@ export const deploy = async (options, environment, debug = false) => {
     }
     if (debug) {
         printDebug(`NANGO_HOSTPORT is set to ${process.env['NANGO_HOSTPORT']}.`);
-        printDebug(`Environment is set to ${environment}`);
+    }
+    if (process.env['NANGO_HOSTPORT'] !== `http://localhost:${port}` && !process.env['NANGO_SECRET_KEY']) {
+        console.log(chalk.red(`NANGO_SECRET_KEY environment variable is not set. Please set it now`));
+        try {
+            const secretKey = await promptly.prompt('Secret Key: ');
+            if (secretKey) {
+                process.env['NANGO_SECRET_KEY'] = secretKey;
+            }
+            else {
+                return;
+            }
+        }
+        catch (error) {
+            console.log('Error occurred while trying to prompt for secret key:', error);
+            process.exit(1);
+        }
     }
     tsc(debug);
     const config = await getConfig(debug);
+    const cwd = process.cwd();
     const postData = [];
     for (const integration of config) {
         const { providerConfigKey } = integration;
@@ -292,7 +106,7 @@ export const deploy = async (options, environment, debug = false) => {
         }
         for (const sync of syncs) {
             const { name: syncName, runs, returns: models, models: model_schema } = sync;
-            const { path: integrationFilePath, result: integrationFileResult } = checkForIntegrationFile(syncName, './');
+            const { path: integrationFilePath, result: integrationFileResult } = checkForIntegrationFile(syncName, path.resolve(cwd, `${NANGO_INTEGRATIONS_LOCATION}`));
             if (!integrationFileResult) {
                 console.log(chalk.red(`No integration file found for ${syncName} at ${integrationFilePath}. Skipping...`));
                 continue;
@@ -313,7 +127,11 @@ export const deploy = async (options, environment, debug = false) => {
         }
     }
     const url = process.env['NANGO_HOSTPORT'] + `/sync/deploy`;
-    if (process.env['NANGO_DEPLOY_AUTO_CONFIRM'] !== 'true' && !autoConfirm) {
+    if (postData.length === 0) {
+        console.log(chalk.red(`No syncs found to deploy. Please make sure your integration files compiled successfully and exist in your dist directory`));
+        return;
+    }
+    if (!process.env['NANGO_DEPLOY_AUTO_CONFIRM'] && !autoConfirm) {
         const confirmationUrl = process.env['NANGO_HOSTPORT'] + `/sync/deploy/confirmation`;
         try {
             const response = await axios.post(confirmationUrl, { syncs: postData, reconcile: false, debug }, { headers: enrichHeaders(), httpsAgent: httpsAgent() });
@@ -334,13 +152,8 @@ export const deploy = async (options, environment, debug = false) => {
                     .post(process.env['NANGO_HOSTPORT'] + `/sync/deploy`, { syncs: postData, reconcile: true, debug }, { headers: enrichHeaders(), httpsAgent: httpsAgent() })
                     .then((response) => {
                     const results = response.data;
-                    if (results.length === 0) {
-                        console.log(chalk.green(`Successfully removed the syncs.`));
-                    }
-                    else {
-                        const nameAndVersions = results.map((result) => `${result.sync_name}@v${result.version}`);
-                        console.log(chalk.green(`Successfully deployed the syncs: ${nameAndVersions.join(', ')}!`));
-                    }
+                    const nameAndVersions = results.map((result) => `${result.sync_name}@v${result.version}`);
+                    console.log(chalk.green(`Successfully deployed the syncs: ${nameAndVersions.join(', ')}!`));
                 })
                     .catch((err) => {
                     const errorMessage = JSON.stringify(err.response.data, null, 2);
@@ -379,13 +192,8 @@ async function deploySyncs(url, body) {
         .post(url, body, { headers: enrichHeaders(), httpsAgent: httpsAgent() })
         .then((response) => {
         const results = response.data;
-        if (results.length === 0) {
-            console.log(chalk.green(`Successfully removed the syncs.`));
-        }
-        else {
-            const nameAndVersions = results.map((result) => `${result.sync_name}@v${result.version}`);
-            console.log(chalk.green(`Successfully deployed the syncs: ${nameAndVersions.join(', ')}!`));
-        }
+        const nameAndVersions = results.map((result) => `${result.sync_name}@v${result.version}`);
+        console.log(chalk.green(`Successfully deployed the syncs: ${nameAndVersions.join(', ')}!`));
     })
         .catch((err) => {
         let errorMessage;
@@ -401,38 +209,198 @@ async function deploySyncs(url, body) {
         process.exit(1);
     });
 }
-export const dryRun = async (options, environment, debug = false) => {
-    let syncName = '';
-    let connectionId, suppliedLastSyncDate;
-    await parseSecretKey(environment, debug);
-    if (!process.env['NANGO_HOSTPORT']) {
+export const version = (debug) => {
+    if (debug) {
+        printDebug('Looking up the version first for a local path first then globally');
+    }
+    const packageJson = JSON.parse(fs.readFileSync(path.resolve(getNangoRootPath(debug), 'package.json'), 'utf8'));
+    const dockerComposeYaml = fs.readFileSync(path.resolve(getNangoRootPath(), 'docker/docker-compose.yaml'), 'utf8');
+    const dockerCompose = yaml.load(dockerComposeYaml);
+    const nangoServerImage = dockerCompose.services['nango-server'].image;
+    const nangoWorkerImage = dockerCompose.services['nango-worker'].image;
+    const nangoServerVersion = nangoServerImage.split(':').pop();
+    const nangoWorkerVersion = nangoWorkerImage.split(':').pop();
+    console.log(chalk.green('Nango Server version:'), nangoServerVersion);
+    console.log(chalk.green('Nango Worker version:'), nangoWorkerVersion);
+    console.log(chalk.green('Nango CLI version:'), packageJson.version);
+};
+export const init = (debug = false) => {
+    const data = {
+        integrations: {
+            github: {
+                [exampleSyncName]: {
+                    runs: 'every half hour',
+                    returns: ['GithubIssue']
+                }
+            }
+        },
+        models: {
+            GithubIssue: {
+                id: 'integer',
+                owner: 'string',
+                repo: 'string',
+                issue_number: 'number',
+                title: 'string',
+                author: 'string',
+                author_id: 'string',
+                state: 'string',
+                date_created: 'date',
+                date_last_modified: 'date',
+                body: 'string'
+            }
+        }
+    };
+    const yamlData = yaml.dump(data);
+    if (!fs.existsSync(NANGO_INTEGRATIONS_LOCATION)) {
         if (debug) {
-            printDebug(`NANGO_HOSTPORT is not set. Setting the default to ${hostport}`);
+            printDebug('Creating the nango integrations directory');
         }
-        process.env['NANGO_HOSTPORT'] = hostport;
+        fs.mkdirSync(NANGO_INTEGRATIONS_LOCATION);
+    }
+    else {
+        if (debug) {
+            printDebug('Nango integrations directory already exists');
+        }
+    }
+    if (!fs.existsSync(`${NANGO_INTEGRATIONS_LOCATION}/${nangoConfigFile}`)) {
+        if (debug) {
+            printDebug(`Creating the ${nangoConfigFile} file}`);
+        }
+        fs.writeFileSync(`${NANGO_INTEGRATIONS_LOCATION}/${nangoConfigFile}`, yamlData);
     }
+    else {
+        if (debug) {
+            printDebug('Nango config file already exists');
+        }
+    }
+    // check if a .env file exists and if not create it with some default content
+    if (!fs.existsSync('.env')) {
+        if (debug) {
+            printDebug('Creating the .env file');
+        }
+        fs.writeFileSync('.env', `#NANGO_HOSTPORT=https://api-staging.nango.dev
+#NANGO_AUTO_UPGRADE=true # set to true to automatically upgrade to the latest version of nango
+#NANGO_NO_PROMPT_FOR_UPGRADE=true # set to true to not prompt for upgrade
+#NANGO_DEPLOY_AUTO_CONFIRM=true # set to true to automatically confirm deployment without prompting
+#NANGO_SECRET_KEY=xxxx-xxx-xxxx # required if deploying to cloud
+#NANGO_INTEGRATIONS_LOCATION=use-this-to-override-where-the-nango-integrations-directory-goes
+#NANGO_PORT=use-this-to-override-the-default-3003
+#NANGO_DB_PORT=use-this-to-override-the-default-5432`);
+    }
+    else {
+        if (debug) {
+            printDebug('.env file already exists');
+        }
+    }
+    console.log(chalk.green(`Nango integrations initialized!`));
+};
+export const generate = async (debug = false) => {
+    const templateContents = fs.readFileSync(path.resolve(__dirname, './integration.ejs'), 'utf8');
+    const githubExampleTemplateContents = fs.readFileSync(path.resolve(__dirname, './integration.github.ejs'), 'utf8');
+    const cwd = process.cwd();
+    const configContents = fs.readFileSync(path.resolve(cwd, `${NANGO_INTEGRATIONS_LOCATION}/${nangoConfigFile}`), 'utf8');
+    const configData = yaml.load(configContents);
+    const { integrations } = configData;
+    const { models } = configData;
+    const interfaceDefinitions = buildInterfaces(models);
+    fs.writeFileSync(`${NANGO_INTEGRATIONS_LOCATION}/${TYPES_FILE_NAME}`, interfaceDefinitions.join('\n'));
     if (debug) {
-        printDebug(`NANGO_HOSTPORT is set to ${process.env['NANGO_HOSTPORT']}`);
+        printDebug(`Interfaces from the ${nangoConfigFile} file written to ${TYPES_FILE_NAME}`);
+    }
+    // insert NangoSync types to the bottom of the file
+    const typesContent = fs.readFileSync(`${getNangoRootPath()}/${NangoSyncTypesFileLocation}`, 'utf8');
+    fs.writeFileSync(`${NANGO_INTEGRATIONS_LOCATION}/${TYPES_FILE_NAME}`, typesContent, { flag: 'a' });
+    if (debug) {
+        printDebug(`NangoSync types written to ${TYPES_FILE_NAME}`);
+    }
+    for (let i = 0; i < Object.keys(integrations).length; i++) {
+        const providerConfigKey = Object.keys(integrations)[i];
+        if (debug) {
+            printDebug(`Generating ${providerConfigKey} integrations`);
+        }
+        const syncObject = integrations[providerConfigKey];
+        const syncNames = Object.keys(syncObject);
+        for (let k = 0; k < syncNames.length; k++) {
+            const syncName = syncNames[k];
+            if (debug) {
+                printDebug(`Generating ${syncName} integration`);
+            }
+            const syncData = syncObject[syncName];
+            const { returns: models } = syncData;
+            const syncNameCamel = syncName
+                .split('-')
+                .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+                .join('');
+            const ejsTeamplateContents = syncName === exampleSyncName ? githubExampleTemplateContents : templateContents;
+            const rendered = ejs.render(ejsTeamplateContents, {
+                syncName: syncNameCamel,
+                interfaceFileName: TYPES_FILE_NAME.replace('.ts', ''),
+                interfaceNames: models.map((model) => {
+                    const singularModel = model?.charAt(model.length - 1) === 's' ? model.slice(0, -1) : model;
+                    return `${singularModel.charAt(0).toUpperCase()}${singularModel.slice(1)}`;
+                }),
+                mappings: models.map((model) => {
+                    const singularModel = model.charAt(model.length - 1) === 's' ? model.slice(0, -1) : model;
+                    return {
+                        name: model,
+                        type: `${singularModel.charAt(0).toUpperCase()}${singularModel.slice(1)}`
+                    };
+                })
+            });
+            if (!fs.existsSync(`${NANGO_INTEGRATIONS_LOCATION}/${syncName}.ts`)) {
+                fs.writeFileSync(`${NANGO_INTEGRATIONS_LOCATION}/${syncName}.ts`, rendered);
+                if (debug) {
+                    printDebug(`Created ${syncName}.ts file`);
+                }
+            }
+            else {
+                if (debug) {
+                    printDebug(`${syncName}.ts file already exists, so will not overwrite it.`);
+                }
+            }
+        }
+    }
+    console.log(chalk.green(`Integration files have been created`));
+};
+export const run = async (args, options, debug = false) => {
+    let syncName, providerConfigKey, connectionId, suppliedLastSyncDate, host, secretKey;
+    if (args.length > 0) {
+        [syncName, providerConfigKey, connectionId, suppliedLastSyncDate] = args;
     }
     if (Object.keys(options).length > 0) {
-        ({ sync: syncName, connectionId, lastSyncDate: suppliedLastSyncDate } = options);
+        ({ sync: syncName, provider: providerConfigKey, connection: connectionId, lastSyncDate: suppliedLastSyncDate, host, secretKey } = options);
     }
     if (!syncName) {
         console.log(chalk.red('Sync name is required'));
         return;
     }
+    if (!providerConfigKey) {
+        console.log(chalk.red('Provider config key is required'));
+        return;
+    }
     if (!connectionId) {
         console.log(chalk.red('Connection id is required'));
         return;
     }
-    const config = await getConfig(debug);
-    const providerConfigKey = config.find((config) => config.syncs.find((sync) => sync.name === syncName))?.providerConfigKey;
-    if (!providerConfigKey) {
-        console.log(chalk.red(`Provider config key not found, please check that the provider exists for this sync name: ${syncName}`));
-        return;
+    if (debug) {
+        if (host) {
+            printDebug(`Host value is set to ${host}. This will override the value in the .env file`);
+        }
+    }
+    if (host) {
+        process.env['NANGO_HOSTPORT'] = host;
+    }
+    if (secretKey) {
+        process.env['NANGO_SECRET_KEY'] = secretKey;
+    }
+    if (!process.env['NANGO_HOSTPORT']) {
+        if (debug) {
+            printDebug(`NANGO_HOSTPORT is not set. Setting the default to ${hostport}`);
+        }
+        process.env['NANGO_HOSTPORT'] = hostport;
     }
     if (debug) {
-        printDebug(`Provider config key found to be ${providerConfigKey}`);
+        printDebug(`NANGO_HOSTPORT is set to ${process.env['NANGO_HOSTPORT']}`);
     }
     const nangoConnection = (await getConnection(providerConfigKey, connectionId, {
         'Nango-Is-Sync': true,
@@ -442,9 +410,6 @@ export const dryRun = async (options, environment, debug = false) => {
         console.log(chalk.red('Connection not found'));
         return;
     }
-    if (debug) {
-        printDebug(`Connection found with ${JSON.stringify(nangoConnection, null, 2)}`);
-    }
     if (process.env['NANGO_HOSTPORT'] === cloudHost || process.env['NANGO_HOSTPORT'] === stagingHost) {
         process.env['NANGO_CLOUD'] = 'true';
     }
@@ -455,12 +420,13 @@ export const dryRun = async (options, environment, debug = false) => {
         }
         lastSyncDate = new Date(suppliedLastSyncDate);
     }
+    const cwd = process.cwd();
     const syncRun = new syncRunService({
         writeToDb: false,
         nangoConnection,
         syncName,
         syncType: SyncType.INITIAL,
-        loadLocation: './',
+        loadLocation: path.resolve(cwd, `${NANGO_INTEGRATIONS_LOCATION}`),
         debug
     });
     try {
@@ -474,35 +440,38 @@ export const dryRun = async (options, environment, debug = false) => {
     }
 };
 export const tsc = (debug = false) => {
+    const cwd = process.cwd();
     const tsconfig = fs.readFileSync(`${getNangoRootPath()}/tsconfig.dev.json`, 'utf8');
-    const distDir = './dist';
+    const distDir = path.resolve(cwd, `${NANGO_INTEGRATIONS_LOCATION}/dist`);
     if (!fs.existsSync(distDir)) {
         if (debug) {
             printDebug(`Creating ${distDir} directory`);
         }
         fs.mkdirSync(distDir);
     }
-    if (!fs.existsSync(`./${TYPES_FILE_NAME}`)) {
+    if (!fs.existsSync(`${NANGO_INTEGRATIONS_LOCATION}/${TYPES_FILE_NAME}`)) {
         if (debug) {
             printDebug(`Creating ${TYPES_FILE_NAME} file`);
         }
         createModelFile();
     }
+    const rawNangoIntegrationLocation = NANGO_INTEGRATIONS_LOCATION.replace('./', '');
     const compiler = tsNode.create({
         compilerOptions: JSON.parse(tsconfig).compilerOptions
     });
     if (debug) {
         printDebug(`Compiler options: ${JSON.stringify(JSON.parse(tsconfig).compilerOptions, null, 2)}`);
     }
-    const integrationFiles = glob.sync(`./*.ts`);
+    const integrationFiles = glob.sync(path.resolve(cwd, `${NANGO_INTEGRATIONS_LOCATION}/*.ts`));
     for (const filePath of integrationFiles) {
         try {
             if (!nangoCallsAreAwaited(filePath)) {
                 return;
             }
             const result = compiler.compile(fs.readFileSync(filePath, 'utf8'), filePath);
-            const jsFilePath = filePath.replace(/\/[^\/]*$/, `/dist/${path.basename(filePath.replace('.ts', '.js'))}`);
-            fs.writeFileSync(jsFilePath, result);
+            const jsFilePath = path.join(path.dirname(filePath), path.basename(filePath, '.ts') + '.js');
+            const distJSFilePath = jsFilePath.replace(rawNangoIntegrationLocation, `${rawNangoIntegrationLocation}/dist`);
+            fs.writeFileSync(distJSFilePath, result);
             console.log(chalk.green(`Compiled "${filePath}" successfully`));
         }
         catch (error) {
@@ -535,51 +504,52 @@ const nangoCallsAreAwaited = (filePath) => {
     return areAwaited;
 };
 export const tscWatch = (debug = false) => {
+    const cwd = process.cwd();
     const tsconfig = fs.readFileSync(`${getNangoRootPath()}/tsconfig.dev.json`, 'utf8');
-    const watchPath = [`./*.ts`, `./${nangoConfigFile}`];
+    const watchPath = [`${NANGO_INTEGRATIONS_LOCATION}/*.ts`, `${NANGO_INTEGRATIONS_LOCATION}/${nangoConfigFile}`];
     if (debug) {
         printDebug(`Watching ${watchPath.join(', ')}`);
     }
+    const rawNangoIntegrationLocation = NANGO_INTEGRATIONS_LOCATION.replace('./', '');
     const watcher = chokidar.watch(watchPath, {
         ignoreInitial: false,
         ignored: (filePath) => {
-            return filePath === TYPES_FILE_NAME;
+            return filePath === `${rawNangoIntegrationLocation}/${TYPES_FILE_NAME}`;
         }
     });
-    const distDir = './dist';
+    const distDir = path.resolve(cwd, `${NANGO_INTEGRATIONS_LOCATION}/dist`);
     if (!fs.existsSync(distDir)) {
         if (debug) {
             printDebug(`Creating ${distDir} directory`);
         }
         fs.mkdirSync(distDir);
     }
-    if (!fs.existsSync(`./${TYPES_FILE_NAME}`)) {
+    if (!fs.existsSync(`${NANGO_INTEGRATIONS_LOCATION}/${TYPES_FILE_NAME}`)) {
         if (debug) {
             printDebug(`Creating ${TYPES_FILE_NAME} file`);
         }
         createModelFile();
     }
     watcher.on('add', (filePath) => {
-        if (filePath === nangoConfigFile) {
+        if (filePath === `${rawNangoIntegrationLocation}/${nangoConfigFile}`) {
             return;
         }
         compileFile(filePath);
     });
     watcher.on('unlink', (filePath) => {
-        if (filePath === nangoConfigFile) {
+        if (filePath === `${rawNangoIntegrationLocation}/${nangoConfigFile}`) {
             return;
         }
-        const jsFilePath = `./dist/${path.basename(filePath.replace('.ts', '.js'))}`;
-        fs.unlinkSync(jsFilePath);
+        const jsFilePath = path.join(path.dirname(filePath), path.basename(filePath, '.ts') + '.js');
+        const distJSFilePath = jsFilePath.replace(rawNangoIntegrationLocation, `${rawNangoIntegrationLocation}/dist`);
+        fs.unlinkSync(distJSFilePath);
     });
     watcher.on('change', (filePath) => {
-        if (filePath === nangoConfigFile) {
+        if (filePath === `${rawNangoIntegrationLocation}/${nangoConfigFile}`) {
             // config file changed, re-compile each ts file
-            const integrationFiles = glob.sync(`./*.ts`);
+            const integrationFiles = glob.sync(path.resolve(cwd, `${NANGO_INTEGRATIONS_LOCATION}/*.ts`));
             for (const file of integrationFiles) {
-                // strip the file to just the last part
-                const strippedFile = file.replace(/^.*[\\\/]/, '');
-                compileFile(strippedFile);
+                compileFile(file);
             }
             return;
         }
@@ -594,8 +564,9 @@ export const tscWatch = (debug = false) => {
                 return;
             }
             const result = compiler.compile(fs.readFileSync(filePath, 'utf8'), filePath);
-            const jsFilePath = `./dist/${path.basename(filePath.replace('.ts', '.js'))}`;
-            fs.writeFileSync(jsFilePath, result);
+            const jsFilePath = path.join(path.dirname(filePath), path.basename(filePath, '.ts') + '.js');
+            const distJSFilePath = jsFilePath.replace(rawNangoIntegrationLocation, `${rawNangoIntegrationLocation}/dist`);
+            fs.writeFileSync(distJSFilePath, result);
             console.log(chalk.green(`Compiled ${filePath} successfully`));
         }
         catch (error) {
@@ -606,7 +577,7 @@ export const tscWatch = (debug = false) => {
     }
 };
 export const configWatch = (debug = false) => {
-    const watchPath = `./${nangoConfigFile}`;
+    const watchPath = `${NANGO_INTEGRATIONS_LOCATION}/${nangoConfigFile}`;
     if (debug) {
         printDebug(`Watching ${watchPath}`);
     }