DX | Release | 15-01-2025

.eslintignore

@@ -0,0 +1 @@
+/dist

.eslintrc

@@ -0,0 +1,6 @@
+{
+  "extends": [
+    "oclif",
+    "oclif-typescript"
+  ]
+}

.github/CODEOWNERS

@@ -1,5 +1 @@
-* @contentstack/devex-pr-reviewers
-.github/workflows/sca-scan.yml @contentstack/security-admin
-.github/workflows/sast-scan.yml @contentstack/security-admin
-.github/workflows/jira.yml @contentstack/security-admin
-**/.snyk @contentstack/security-admin
+* @contentstack/security-admin

.github/workflows/release.yml

@@ -0,0 +1,64 @@
+name: Release
+on:
+  push:
+    branches:
+      - main
+jobs:
+  build:
+    name: Build and upload
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3.5.3
+        with:
+          fetch-depth: 0
+      - name: Setup Node.js
+        uses: actions/setup-node@v3.7.0
+        with:
+          node-version: "18.x"
+      - name: Installing dependencies
+        run: npm install
+      - name: Build
+        run: npm run prepack
+      - name: Upload dist
+        uses: actions/upload-artifact@v3.1.2
+        with:
+          name: lib
+          path: lib
+
+  release:
+    name: Download dist and release
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3.5.3
+        with:
+          fetch-depth: 0
+      - name: Setup Node.js
+        uses: actions/setup-node@v3.7.0
+        with:
+          node-version: "18.x"
+      - name: Installing dependencies
+        run: npm install
+      - name: Download dist
+        uses: actions/download-artifact@v3
+        with:
+          name: lib
+          path: lib
+      - name: Display dirs
+        run: ls -R
+      - name: Release
+        id: release-plugin
+        uses: JS-DevTools/npm-publish@v2.2.0
+        with:
+          token: ${{ secrets.NPM_TOKEN }}
+          access: public
+      - name: get-npm-version
+        id: package-version
+        uses: martinbeentjes/npm-get-version-action@v1.3.1
+      - name: github-release
+        id: github-release
+        env:
+          GITHUB_TOKEN: ${{ secrets.PKG_TOKEN }}
+        run:  gh release create v${{ steps.release-plugin.outputs.version }} --title "Release ${{ steps.release-plugin.outputs.version }}" --generate-notes

.gitignore

@@ -0,0 +1,18 @@
+*-debug.log
+*-error.log
+/.nyc_output
+/dist
+/lib
+/tmp
+/yarn.lock
+node_modules
+oclif.manifest.json
+.env
+*.log
+tsconfig.tsbuildinfo
+dependabot.yml
+.vscode
+*.todo
+/bkp
+.editorconfig
+/functions

.mocharc.json

@@ -0,0 +1,12 @@
+{
+  "require": [
+    "test/helpers/init.js",
+    "ts-node/register"
+  ],
+  "watch-extensions": [
+    "ts"
+  ],
+  "recursive": true,
+  "reporter": "spec",
+  "timeout": 60000
+}

.prettierrc

@@ -0,0 +1,7 @@
+{
+    "semi": true,
+    "trailingComma": "all",
+    "singleQuote": true,
+    "printWidth": 120,
+    "tabWidth": 2
+}

LICENSE

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

README.md

@@ -1 +1,41 @@
-# launch-cli
+# Launch CLI plugin
+
+[![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
+
+With Launch CLI, you can interact with the Contentstack Launch platform using the terminal to create, manage and deploy Launch projects.
+
+<!-- toc -->
+* [Launch CLI plugin](#launch-cli-plugin)
+* [Usage](#usage)
+* [Installation steps](#installation-steps)
+* [Commands](#commands)
+<!-- tocstop -->
+
+# Installation steps
+
+```sh-session
+GitHub installation steps:
+$ git clone clone <repo url>
+$ npm install
+$ npm run build
+$ csdx plugins:link <plugin path>
+
+NPM installation steps:
+$ csdx plugins:install @contentstack/cli-launch
+$ csdx launch
+```
+
+# Commands
+
+```sh-session
+$ csdx launch
+start with launch flow <GitHub|FileUpload>
+$ csdx launch:logs
+To see server logs
+$ csdx launch:logs --type d
+To see deployment logs
+$ csdx launch:functions
+Run cloud functions locally
+```
+
+<!-- commandsstop -->

SECURITY.md

@@ -0,0 +1,27 @@
+## Security
+
+Contentstack takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations.
+
+If you believe you have found a security vulnerability in any Contentstack-owned repository, please report it to us as described below.
+
+## Reporting Security Issues
+
+**Please do not report security vulnerabilities through public GitHub issues.**
+
+Send email to [security@contentstack.com](mailto:security@contentstack.com).
+
+You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message.
+
+Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
+
+- Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
+- Full paths of source file(s) related to the manifestation of the issue
+- The location of the affected source code (tag/branch/commit or direct URL)
+- Any special configuration required to reproduce the issue
+- Step-by-step instructions to reproduce the issue
+- Proof-of-concept or exploit code (if possible)
+- Impact of the issue, including how an attacker might exploit the issue
+
+This information will help us triage your report more quickly.
+
+[https://www.contentstack.com/trust/](https://www.contentstack.com/trust/)

bin/dev

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+require("dotenv").config();
+const oclif = require('@oclif/core')
+
+const path = require('path')
+const project = path.join(__dirname, '..', 'tsconfig.json')
+
+// In dev mode -> use ts-node and dev plugins
+process.env.NODE_ENV = 'development'
+
+require("ts-node").register({ project });
+
+// In dev mode, always show stack traces
+oclif.settings.debug = true;
+
+// Start the CLI
+oclif.run().then(oclif.flush).catch(oclif.Errors.handle)

bin/dev.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\dev" %*

bin/run

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+const oclif = require('@oclif/core')
+
+oclif.run().then(require('@oclif/core/flush')).catch(require('@oclif/core/handle'))

bin/run.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\run" %*

example.env

@@ -0,0 +1,3 @@
+ENVIRONMENT=<DEPLOYMENT_ENVIRONMENT>
+ORG=<ORG_UID>
+PROJECT=<PROJECT_NAME>

examples/create-launch-project.json

@@ -0,0 +1,9 @@
+{
+  "name": "app name",
+  "type":  "GitHub",
+  "environment": "Default",
+  "framework": "NextJs",
+  "build-command": "npm run build",
+  "out-dir": "./.next",
+  "branch": "master"
+}