New unlocked packages (with and without namespace) (#39)

* Simplified directory structury within nebula-query-and-search directory

* Created 2 unlocked packages (no namespace and Nebula namespace)

* Added package.json, added or updated several other project config files (.forceignore, .gitignore, .prettierrc, etc)

* Bumped all Apex classes to API v57.0 (Spring '23)

* Added @SuppressWarnings tests in Apex classes (several will eventually be removed after refactoring) and added missing curly braces prior to running prettier

* Ran prettier on the whole repo

* Changed casing of class names from Soql & Sosl to SOQL & SOSL

* Added ApexDocs comments to the top of each class + added precommit hook & npm script & dependencies for generating docs markdown

* Added Apex test suite, cleaned up test classes and added a few more test methods

* Updated most classes, enums, and methods from public to global, updated doc-generation to only include items marked as global

* Added Apex script with some sample queries

.forceignore

@@ -4,9 +4,8 @@
 
 package.xml
 
-# LWC configuration files
-**/jsconfig.json
-**/.eslintrc.json
+# Project repo files
+**.md
 
-# LWC Jest
-**/__tests__/**
+# Metadata
+**.profile-meta.xml

.gitattributes

@@ -0,0 +1,19 @@
+# Set the default line return behavior, in case people don't have core.autocrlf set.
+* text=auto eol=lf
+
+# Common git file types
+.gitattributes text eol=lf
+.gitignore text eol=lf
+*.md text eol=lf
+
+# Salesforce-specfic file types
+*.app text eol=lf
+*.cls text eol=lf
+*.cmp text eol=lf
+*.component text eol=lf
+*.css text eol=lf
+*.html text eol=lf
+*.js text eol=lf
+*.page text eol=lf
+*.trigger text eol=lf
+*.xml text eol=lf

.github/workflows/fetch-repo-stats.yml

@@ -1,18 +1,18 @@
 name: Fetch Repo Stats
 
 on:
-  schedule:
-  # Run this once per day, towards the end of the day for keeping the most
-  # recent data point most meaningful (hours are interpreted in UTC).
-  - cron: '0 23 * * *'
-  workflow_dispatch: # Allow for running this manually.
+ schedule:
+ # Run this once per day, towards the end of the day for keeping the most
+ # recent data point most meaningful (hours are interpreted in UTC).
+ - cron: '0 23 * * *'
+ workflow_dispatch: # Allow for running this manually.
 
 jobs:
-  j1:
-  name: store-repo-stats
-  runs-on: ubuntu-latest
-  steps:
-  - name: run-ghrs
-  uses: jgehrcke/github-repo-stats@RELEASE
-  with:
-  ghtoken: ${{ secrets.GH_PERSONAL_ACCESS_TOKEN }}
+ j1:
+ name: store-repo-stats
+ runs-on: ubuntu-latest
+ steps:
+ - name: run-ghrs
+ uses: jgehrcke/github-repo-stats@RELEASE
+ with:
+ ghtoken: ${{ secrets.GH_PERSONAL_ACCESS_TOKEN }}

.gitignore

@@ -1,9 +1,41 @@
-# Folders to exclude
-.settings/
+# This file is used for Git repositories to specify intentionally untracked files that Git should ignore.
+# If you are not using git, you can delete this file. For more information see: https://git-scm.com/docs/gitignore
+# For useful gitignore templates see: https://github.com/github/gitignore
+
+# Salesforce cache
+.sf/
 .sfdx/
+.localdevserver/
 .vscode/
-*/main/default/
+deploy-options.json
+
+# LWC VSCode autocomplete
+**/lwc/jsconfig.json
 
-# Files to exclude
+# Code coverage reports
+test-coverage/
+
+# Logs
+logs
 *.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Dependency directories
+node_modules/
+
+# Eslint cache
+.eslintcache
+
+# MacOS system files
+.DS_Store
+
+# Windows system files
+Thumbs.db
+ehthumbs.db
+[Dd]esktop.ini
+$RECYCLE.BIN/
 
+# Local environment variables
+.env

.husky/_/husky.sh

@@ -0,0 +1,31 @@
+#!/bin/sh
+if [ -z "$husky_skip_init" ]; then
+ debug () {
+ if [ "$HUSKY_DEBUG" = "1" ]; then
+ echo "husky (debug) - $1"
+ fi
+ }
+
+ readonly hook_name="$(basename "$0")"
+ debug "starting $hook_name..."
+
+ if [ "$HUSKY" = "0" ]; then
+ debug "HUSKY env variable is set to 0, skipping hook"
+ exit 0
+ fi
+
+ if [ -f ~/.huskyrc ]; then
+ debug "sourcing ~/.huskyrc"
+ . ~/.huskyrc
+ fi
+
+ export readonly husky_skip_init=1
+ sh -e "$0" "$@"
+ exitCode="$?"
+
+ if [ $exitCode != 0 ]; then
+ echo "husky - $hook_name hook exited with code $exitCode (error)"
+ fi
+
+ exit $exitCode
+fi

.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+npm run precommit

.prettierignore

@@ -0,0 +1,11 @@
+# List files or directories below to ignore them when running prettier
+# More information: https://prettier.io/docs/en/ignore.html
+#
+
+**/staticresources/**
+.localdevserver/
+.sf/
+.sfdx/
+.husky/
+node_modules/
+test-coverage/

.prettierrc

@@ -0,0 +1,7 @@
+{
+ "arrowParens": "avoid",
+ "printWidth": 160,
+ "singleQuote": true,
+ "tabWidth": 2,
+ "trailingComma": "none"
+}

CODE_OF_CONDUCT.md

@@ -0,0 +1,127 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
+ and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the
+ overall community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or
+ advances of any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email
+ address, without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.