Merge pull request #1 from Azure/swapnil/sdkBindingExtensions

Blob SDK binding Support extensions

Author: swapnil-nagar

azure-functions-nodejs-extensions-base/.eslintrc.json

@@ -0,0 +1,49 @@
+{
+    "parser": "@typescript-eslint/parser",
+    "plugins": ["@typescript-eslint", "header", "deprecation", "simple-import-sort", "import"],
+    "parserOptions": {
+        "project": "tsconfig.json",
+        "sourceType": "module"
+    },
+    "extends": [
+        "eslint:recommended",
+        "plugin:@typescript-eslint/recommended",
+        "plugin:@typescript-eslint/recommended-requiring-type-checking",
+        "plugin:prettier/recommended"
+    ],
+    "rules": {
+        "header/header": [
+            2,
+            "line",
+            [" Copyright (c) .NET Foundation. All rights reserved.", " Licensed under the MIT License."],
+            2
+        ],
+        "deprecation/deprecation": "error",
+        "@typescript-eslint/no-empty-interface": "off",
+        "@typescript-eslint/no-explicit-any": "off",
+        "@typescript-eslint/no-namespace": "off",
+        "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_", "ignoreRestSiblings": true }],
+        "prefer-const": ["error", { "destructuring": "all" }],
+        "@typescript-eslint/explicit-member-accessibility": [
+            "error",
+            {
+                "accessibility": "no-public"
+            }
+        ],
+        "no-return-await": "off",
+        "@typescript-eslint/return-await": "error",
+        "eqeqeq": "error",
+        "@typescript-eslint/no-empty-function": "off",
+        "simple-import-sort/imports": [
+            "error",
+            {
+                "groups": [["^\\u0000", "^node:", "^@?\\w", "^", "^\\."]]
+            }
+        ],
+        "simple-import-sort/exports": "error",
+        "import/first": "error",
+        "import/newline-after-import": "error",
+        "import/no-duplicates": "error"
+    },
+    "ignorePatterns": ["**/*.js", "**/*.mjs", "**/*.cjs", "out", "dist"]
+}

azure-functions-nodejs-extensions-base/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @azure/azure-functions-nodejs

azure-functions-nodejs-extensions-base/.gitignore

@@ -0,0 +1,44 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules
+jspm_packages
+
+# Optional npm cache directory
+.npm
+
+# Optional REPL history
+.node_repl_history
+
+dist
+out
+pkg
+*.tgz
+
+**/*-test-results.xml

azure-functions-nodejs-extensions-base/.prettierignore

@@ -0,0 +1,6 @@
+out
+dist
+node_modules
+
+# Exclude markdown until this bug is fixed: https://github.com/prettier/prettier/issues/5019
+*.md

azure-functions-nodejs-extensions-base/.prettierrc

@@ -0,0 +1,6 @@
+{
+    "tabWidth": 4,
+    "singleQuote": true,
+    "printWidth": 120,
+    "endOfLine": "auto"
+}

azure-functions-nodejs-extensions-base/.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+    "recommendations": ["dbaeumer.vscode-eslint", "esbenp.prettier-vscode"]
+}

azure-functions-nodejs-extensions-base/.vscode/launch.json

@@ -0,0 +1,19 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "type": "node",
+            "request": "attach",
+            "name": "Attach by Process ID",
+            "processId": "${command:PickProcess}"
+        },
+        {
+            "name": "Launch Unit Tests",
+            "runtimeExecutable": "npm",
+            "runtimeArgs": ["test"],
+            "request": "launch",
+            "skipFiles": ["<node_internals>/**"],
+            "type": "node"
+        }
+    ]
+}

azure-functions-nodejs-extensions-base/.vscode/settings.json

@@ -0,0 +1,8 @@
+{
+    "azureFunctions.showProjectWarning": false,
+    "editor.codeActionsOnSave": ["source.fixAll"],
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "typescript.tsdk": "node_modules/typescript/lib",
+    "typescript.preferences.importModuleSpecifier": "relative"
+}

azure-functions-nodejs-extensions-base/.vscode/tasks.json

@@ -0,0 +1,25 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "npm: watch",
+            "type": "npm",
+            "script": "watch",
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            },
+            "problemMatcher": ["$ts-checker-webpack-watch"],
+            "isBackground": true,
+            "presentation": {
+                "reveal": "never"
+            }
+        },
+        {
+            "type": "npm",
+            "script": "lint",
+            "problemMatcher": "$eslint-stylish",
+            "label": "npm: lint"
+        }
+    ]
+}

azure-functions-nodejs-extensions-base/CONTRIBUTING.md

@@ -0,0 +1,25 @@
+# Contributing
+
+-   Clone the repository locally and open in VS Code
+-   Run "Extensions: Show Recommended Extensions" from the [command palette](https://code.visualstudio.com/docs/getstarted/userinterface#_command-palette) and install all extensions listed under "Workspace Recommendations"
+-   Run `npm install`
+-   Run `npm run build`
+-   Run `npm link`
+-   Create or open a local function app to test with
+-   In the local function app:
+    -   Follow the steps in the "Usage" section of the README for this repo
+    -   Run `npm link @azure/functions-extensions-base`. This will point your app to the local repository for the `@azure/functions-extensions-base` package
+    -   Add the following settings to your "local.settings.json" file or configure them directly as environment variables
+        -   `languageWorkers__node__arguments`: `--inspect`
+            > 💡 Tip: Set `logging__logLevel__Worker` to `debug` if you want to view worker-specific logs in the output of `func start`
+    -   Start the app (i.e. run `func start` or press <kbd>F5</kbd>)
+-   Back in this repository, press <kbd>F5</kbd> and select the process for your running function app
+-   Before you submit a PR, run `npm test` and fix any issues. If you want to debug the tests, switch your [launch profile](https://code.visualstudio.com/docs/editor/debugging) in VS Code to "Launch Unit Tests" and press <kbd>F5</kbd>.
+
+## Code of Conduct
+
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [[email protected]](mailto:[email protected]) with any additional questions or comments.
+
+## Contributing to type definitions
+
+The type definitions are located in the `types` folder. Please make sure to update the tests in `./test/types/index.test.ts` as well.