first public release

.bitbucket/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,19 @@
+# PR details
+
+## What is the purpose of this pull request? (put an "X" next to an item)
+
+- [ ] Documentation update
+- [ ] Bug fix
+- [ ] New metadata support
+- [ ] Enhanced metadata
+- [ ] Add a CLI option
+- [ ] Add something to the core
+- [ ] Other, please explain:
+
+## What changes did you make? (Give an overview)
+
+...
+
+## Is there anything you'd like reviewers to focus on?
+
+...

.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+end_of_line = lf
+indent_style = space
+indent_size = 4
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true

.eslintignore

@@ -0,0 +1,3 @@
+/docs/**
+/node_modules/**
+/retrieve/**

.eslintrc.json

@@ -0,0 +1,47 @@
+{
+    "env": {
+        "es6": true,
+        "node": true,
+        "mocha": true
+    },
+    "extends": ["eslint:recommended", "prettier", "ssjs"],
+    "plugins": ["mocha", "prettier"],
+    "globals": {
+        "Atomics": "readonly",
+        "SharedArrayBuffer": "readonly"
+    },
+    "parserOptions": {
+        "ecmaVersion": 2018,
+        "sourceType": "module"
+    },
+    "rules": {
+        "arrow-body-style": ["error", "as-needed"],
+        "curly": "error",
+        "mocha/no-exclusive-tests": "error",
+        "no-console": "off",
+        "require-jsdoc": [
+            "warn",
+            {
+                "require": {
+                    "FunctionDeclaration": true,
+                    "MethodDefinition": true,
+                    "ClassDeclaration": true,
+                    "ArrowFunctionExpression": false,
+                    "FunctionExpression": true
+                }
+            }
+        ],
+        "valid-jsdoc": "error",
+        "spaced-comment": ["warn", "always", { "block": { "exceptions": ["*"], "balanced": true } }]
+    },
+    "overrides": [
+        {
+            "files": ["*.js"],
+            "rules": {
+                "no-var": "error",
+                "prefer-const": "error",
+                "prettier/prettier": "warn"
+            }
+        }
+    ]
+}

.gitattributes

@@ -0,0 +1,5 @@
+# Set the default behavior, in case people don't have core.autocrlf set.
+* text=auto eol=lf
+
+# Declare files that will always have LF line endings on checkout.
+*.ssjs text eol=lf

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,19 @@
+# PR details
+
+## What is the purpose of this pull request? (put an "X" next to an item)
+
+- [ ] Documentation update
+- [ ] Bug fix
+- [ ] New metadata support
+- [ ] Enhanced metadata
+- [ ] Add a CLI option
+- [ ] Add something to the core
+- [ ] Other, please explain:
+
+## What changes did you make? (Give an overview)
+
+...
+
+## Is there anything you'd like reviewers to focus on?
+
+...

.gitignore

@@ -0,0 +1,12 @@
+businessUnits/
+deploy/
+docs/
+logs/
+node_modules/
+retrieve/
+roles/
+template/
+tmp/
+.mcdev-auth.json
+.mcdevrc.json
+.vscode/tasks.json

.husky/.gitignore

@@ -0,0 +1 @@
+_

.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+npx --no lint-staged

.issuetracker

@@ -0,0 +1,7 @@
+# Integration with Issue Tracker
+#
+# (note that '\' need to be escaped).
+
+[issuetracker "Jira Rule"]
+  regex = "CSCLSROZ-(\\d+)"
+  url = "https://alm.accenture.com/jira/browse/CSCLSROZ-$1"

.markdownlint.json

@@ -0,0 +1,16 @@
+{
+    "default": true,
+    "line-length": false,
+    "no-duplicate-header": false,
+    "no-trailing-punctuation": false,
+    "no-inline-html": false,
+    "no-bare-urls": false,
+    "list-marker-space": {
+        "ul_single": 1,
+        "ol_single": 1,
+        "ul_multi": 1,
+        "ol_multi": 1
+    },
+    "ul-indent": { "indent": 2 },
+    "ol-prefix": { "style": "ordered" }
+}

.markdownlint.md

@@ -0,0 +1,4 @@
+# How to set up markdownlint rules
+
+- [list of rules](https://github.com/DavidAnson/markdownlint/blob/master/doc/Rules.md)
+- [how to configure in vscode](https://github.com/DavidAnson/vscode-markdownlint#configure)

.npmrc

@@ -0,0 +1 @@
+save-prefix=''

.prettierignore

@@ -0,0 +1,3 @@
+docs
+node_modules
+retrieve

.prettierrc

@@ -0,0 +1,26 @@
+{
+    "tabWidth": 4,
+    "printWidth": 100,
+    "singleQuote": true,
+    "overrides": [
+        {
+            "files": "*.json",
+            "options": {
+                "parser": "json"
+            }
+        },
+        {
+            "files": "*.ssjs",
+            "options": {
+                "parser": "babel",
+                "trailingComma": "none"
+            }
+        },
+        {
+            "files": "*.md",
+            "options": {
+                "tabWidth": 2
+            }
+        }
+    ]
+}

.vscode/extensions.json

@@ -0,0 +1,26 @@
+{
+    // See http://go.microsoft.com/fwlink/?LinkId=827846 to learn about workspace recommendations.
+    // Extension identifier format: ${publisher}.${name}. Example: vscode.csharp
+
+    // List of extensions which should be recommended for users of this workspace.
+    "recommendations": [
+        // collaboration
+        "gruntfuggly.todo-tree",
+        "aaron-bond.better-comments",
+        "ms-vsliveshare.vsliveshare",
+
+        // Linters
+        "dbaeumer.vscode-eslint",
+
+        // Formatting & colors
+        "editorconfig.editorconfig",
+        "esbenp.prettier-vscode",
+        "sergey-agadzhanov.ampscript",
+        "adpyke.vscode-sql-formatter",
+
+        // Markdown / Readme.md
+        "yzhang.markdown-all-in-one",
+        "davidanson.vscode-markdownlint",
+        "joernberkefeld.markdown-preview-bitbucket-innersource"
+    ]
+}

.vscode/launch.json

@@ -0,0 +1,15 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "type": "node",
+            "request": "launch",
+            "name": "Launch Program",
+            "program": "${workspaceFolder}\\lib\\index.js",
+            "args": ["retrieve", "Dev"]
+        }
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,45 @@
+{
+    "editor.codeActionsOnSave": {
+        "source.fixAll.eslint": true,
+        "source.fixAll.markdownlint": true
+    },
+    "editor.formatOnSave": true,
+    "files.associations": {
+        "*.ssjs": "javascript"
+    },
+    "files.eol": "\n",
+    "js/ts.implicitProjectConfig.checkJs": true,
+    "javascript.validate.enable": false,
+    "markdown.extension.italic.indicator": "_",
+    "markdown.extension.list.indentationSize": "adaptive",
+    "markdown.extension.tableFormatter.enabled": false,
+    "markdown.extension.toc.levels": "2..6",
+    "markdown.extension.toc.orderedList": false,
+    "sql-formatter.indent": "    ",
+    "sql-formatter.uppercase": true,
+    "[html]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[javascript]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[json]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[jsonc]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[markdown]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[typescript]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "markdown-toc.orderedList": true,
+    "markdown-toc.insertAnchor": true,
+    "markdown-toc.anchorMode": "gitlab.com",
+    "outline.showProperties": false,
+    "outline.showVariables": false,
+    "breadcrumbs.showVariables": false,
+    "breadcrumbs.showProperties": false
+}

.vsls.json

@@ -0,0 +1,6 @@
+{
+    "$schema": "http://json.schemastore.org/vsls",
+    "gitignore": "none",
+    "excludeFiles": ["*.p12", "*.cer", "token", ".gitignore"],
+    "hideFiles": ["bin", "obj"]
+}

CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+Accenture SFMC DevTools follows [semantic versioning](https://semver.org/).
+
+---
+
+## 3.0.0 - 2021-03-26
+
+Initial public release.
+
+---
+
+## 2.0.0 - 2020-02-03
+
+Initial Accenture-wide release.

CONTRIBUTING.md

@@ -0,0 +1,22 @@
+<h1 id="contributing-to-sfmc-devtools">Contributing to Accenture Salesforce Marketing Cloud DevTools</h1>
+<p>First and foremost, thank you! We appreciate that you want to contribute to Accenture Salesforce Marketing Cloud DevTools, your time is valuable, and your contributions mean a lot to us.</p>
+<h2 id="important-">Important!</h2>
+<p>By contributing to this project, you:</p>
+<ul>
+<li>Agree that you have authored 100% of the content</li>
+<li>Agree that you have the necessary rights to the content</li>
+<li>Agree that you have received the necessary permissions from your employer to make the contributions (if applicable)</li>
+<li>Agree that the content you contribute may be provided under the Project license(s)</li>
+<li>Agree that, if you did not author 100% of the content, the appropriate licenses and copyrights have been added along with any other necessary attribution.</li>
+</ul>
+<h2 id="getting-started">Getting started</h2>
+<p><strong>What does "contributing" mean?</strong></p>
+<p>Creating an issue is the simplest form of contributing to a project. But there are many ways to contribute, including the following:</p>
+<ul>
+<li>Updating or correcting documentation</li>
+<li>Feature requests</li>
+<li>Bug reports</li>
+</ul>
+<h2 id="issues">Issues</h2>
+<p>Please only create issues for bug reports or feature requests. Issues discussing any other topics may be closed by the project's maintainers without further explanation.</p>
+<p>Do not create issues about bumping dependencies unless a bug has been identified and you can demonstrate that it effects this repo.</p>

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Accenture
+
+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.

PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,19 @@
+# PR details
+
+## What is the purpose of this pull request? (put an "X" next to an item)
+
+- [ ] Documentation update
+- [ ] Bug fix
+- [ ] New metadata support
+- [ ] Enhanced metadata
+- [ ] Add a CLI option
+- [ ] Add something to the core
+- [ ] Other, please explain:
+
+## What changes did you make? (Give an overview)
+
+...
+
+## Is there anything you'd like reviewers to focus on?
+
+...