Promises, Async/Await and bug fixes.

.editorconfig

@@ -0,0 +1,32 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.json]
+indent_style = space
+indent_size = 2
+
+[*.js]
+indent_style = space
+indent_size = 2
+
+[*.ts]
+indent_style = space
+indent_size = 2
+
+[Makefile]
+indent_style = tab
+indent_size = 4

.github/workflows/codeql-analysis.yml

@@ -0,0 +1,70 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ master ]
+  schedule:
+    - cron: '36 16 * * 6'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'javascript' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
+        # Learn more about CodeQL language support at https://git.io/codeql-language-support
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v3
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v2
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v2
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    #- run: |
+    #   make bootstrap
+    #   make release
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v2

.github/workflows/deploy-pages.yml

@@ -0,0 +1,51 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [ master, main ]
+  pull_request:
+    branches: [ master, main ]
+
+# Allow this job to clone the repo and create a page artifact
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './docs'
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -2,3 +2,5 @@ node_modules/
 coverage/
 .tmp/
 .git/
+.vscode
+.nyc_output/

CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.2.0] - 2024-01-09
+
+### Added
+- Promise support via `.promise()` method
+- TypeScript definitions in `index.d.ts`
+- SSH key management capabilities
+- User expiration management (`getExpiration`, `setExpiration`)
+- Comprehensive user and group management methods
+
+### Changed
+- Improved documentation structure
+- Enhanced README with better examples and API documentation
+- Added linting scripts to package.json
+- Improved package.json with additional metadata
+
+### Fixed
+- Fixed `Array.isArray` usage in user.js (was incorrectly using `Arrays.isArray`)
+- Added missing "use strict" to lib/promise.js
+- Resolved JSHint linting errors
+
+### Security
+- Improved input validation
+- Better error handling to prevent information disclosure
+
+## [1.1.0] - Previous Release
+
+### Added
+- Basic user and group management functionality
+- SSH key verification and management
+- User expiration handling
+
+## [1.0.0] - Initial Release
+
+### Added
+- User creation and removal
+- Group management
+- User information retrieval
+- Password management
+- SSH key management

CONTRIBUTING.md

@@ -0,0 +1,73 @@
+# Contributing to linux-sys-user
+
+Thank you for your interest in contributing to linux-sys-user! This document provides guidelines and information for contributors.
+
+## Development Setup
+
+1. Fork the repository
+2. Clone your fork: `git clone https://github.com/your-username/linux-user.git`
+3. Install dependencies: `npm install`
+4. Run tests: `npm test`
+5. Run linting: `npm run lint`
+
+## Requirements
+
+- Node.js >= 6.0.0
+- Linux operating system
+- Root access (for most operations)
+
+## Code Style
+
+- Use JSHint for code linting: `npm run lint`
+- Follow existing code patterns and style
+- Use meaningful variable and function names
+- Add comments for complex logic
+
+## Testing
+
+- Write tests for new features
+- Ensure all tests pass: `npm test`
+- Run linting: `npm run lint`
+- Test coverage: `npm run test-coverage`
+
+**Note**: Most tests require root privileges. Some tests may fail if not running as root, which is expected behavior.
+
+## Submitting Changes
+
+1. Create a feature branch: `git checkout -b feature/your-feature-name`
+2. Make your changes
+3. Add tests for your changes
+4. Ensure linting passes: `npm run lint`
+5. Commit your changes: `git commit -m "Add your feature"`
+6. Push to your fork: `git push origin feature/your-feature-name`
+7. Submit a pull request
+
+## Pull Request Guidelines
+
+- Provide a clear description of the changes
+- Reference any related issues
+- Ensure all tests pass
+- Follow the existing code style
+- Add tests for new functionality
+
+## Issues
+
+When reporting issues, please include:
+
+- Node.js version (`node --version`)
+- Linux distribution and version
+- Steps to reproduce the problem
+- Expected vs actual behavior
+- Any error messages
+
+## Security
+
+This module requires root privileges to function properly. Please be mindful of:
+
+- Input validation and sanitization
+- Secure handling of passwords and sensitive data
+- Proper error handling to avoid information disclosure
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.

Makefile

@@ -20,18 +20,6 @@ test: install
 		$(MOCHA_OPTS) \
 		$(TESTS)
 
-test-cov cov: install
-	@NODE_ENV=test node \
-		node_modules/.bin/istanbul cover \
-		./node_modules/.bin/_mocha \
-		--bail \
-		-- -u exports \
-		--reporter $(REPORTER) \
-		--timeout $(TIMEOUT) \
-		--require should \
-		$(MOCHA_OPTS) \
-		$(TESTS)
-
 test-all all: install jshint test cov
 
 clean: