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?
+
+...