Initial release (#1)

* Initial commit of custom objects, layouts, flexipages, console app, permission sets, and Apex schedulable batch job

Author: jongpie

.forceignore

@@ -0,0 +1,12 @@
+# List files or directories below to ignore them when running force:source:push, force:source:pull, and force:source:status
+# More information: https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_exclude_source.htm
+#
+
+package.xml
+
+# LWC configuration files
+**/jsconfig.json
+**/.eslintrc.json
+
+# LWC Jest
+**/__tests__/**

.gitignore

@@ -0,0 +1,14 @@
+# Folders to exclude
+.localdevserver/
+.settings/
+.sfdx/
+.vscode/
+wip/
+
+# NPM
+node_modules/
+yarn.lock
+
+# Files to exclude
+*.log
+**/lwc/jsconfig.json

.prettierignore

@@ -0,0 +1,6 @@
+# List files or directories below to ignore them when running prettier
+# More information: https://prettier.io/docs/en/ignore.html
+#
+
+.sfdx
+.vscode

.prettierrc

@@ -0,0 +1,16 @@
+{
+    "trailingComma": "none",
+    "tabWidth": 2,
+    "useTabs": false,
+    "printWidth": 120,
+    "overrides": [
+        {
+            "files": "**/lwc/**/*.html",
+            "options": { "parser": "lwc" }
+        },
+        {
+            "files": "*.{cmp,page,component}",
+            "options": { "parser": "html" }
+        }
+    ]
+}

README.md

@@ -0,0 +1,39 @@
+# Package Analytics
+
+Provides reportable data about your Salesforce packages in your dev hub.
+
+[![Install Unlocked Package in a Dev Hub](./images/btn-install-unlocked-package-production.png)](https://login.salesforce.com/packaging/installPackage.apexp?p0=04t4x000000FEjUAAW)
+
+## Why?
+
+When working with packages in Salesforce, the platform automatically tracks & stores data about your packages, package versions, and customer orgs that are using your package(s) (referred to as 'subscriber orgs'). However, the objects that store this data can only be accessed via SOQL or Apex - they are not accessible via the Salesforce UI, which also means that the data is not reportable.
+
+This project aims to help ISVs better monitor their packages by extracting data into custom objects so you can easily view it in your dev hub, using standard Salesforce UI functionality. The data is also reportable, using standard Salesforce report & dashboard functionality.
+
+## Getting Started
+
+1. Install the package into your dev hub
+2. Schedule the Apex job using `new PackageDataExtractJob().scheduleHourly();`. This will also immediately run the job.
+3. Optional: assign permission sets to any users in your dev hub that should be able to see/report on the data.
+   - System Admins should already have access to the objects/data, so they should not need to have any permission sets assigned
+   - 'Package Analytics Admin' permission set - for any users that should be able to modify or delete access to the data in the included custom objects
+   - 'Package Analytics Viewer' permission set - for any users that should have read-only access to the data in the included custom objects
+4. Open the app 'Package Analytics' in App Switcher
+5. Enjoy the reportable data about your packages. You can build your own reports & dashboards, using these custom objects
+   - `Package__c`
+   - `PackageVersion__c`
+   - `PackageSubscriberOrg__c`
+
+## Screenshots
+
+View your list of 1GP and 2GP packages
+
+![Packages list view](/images/packages-tab.png)
+
+For each package, you can see the list of package versions & additional details about the package
+
+![Package detail page](/images/package-detail-page.png)
+
+Similarly, for each package version, you can see the list of orgs that have installed the package version, as well as additional details about the package version.
+
+![Package Version detail page](/images/package-version-detail-page.png)

config/scratch-orgs/base-scratch-def.json

@@ -0,0 +1,15 @@
+{
+  "orgName": "Package Analytics - Base Scratch Org",
+  "edition": "Enterprise",
+  "hasSampleData": true,
+  "country": "US",
+  "language": "en_US",
+  "features": [],
+  "settings": {
+    "userManagementSettings": {
+      "enableEnhancedPermsetMgmt": true,
+      "enableEnhancedProfileMgmt": true,
+      "enableNewProfileUI": true
+    }
+  }
+}