@internetarchive/iaux-account-settings NPM

Internet Archive Account Settings WebComponent

This WebComponent, built using the IA Typescript WebComponent Template, provides account settings management functionality for Internet Archive users. It extends the Open WebComponents generator with Internet Archive-specific features and developer tools.

Installation

npm install @internetarchive/iaux-account-settings

Local Demo with `web-dev-server`

yarn start

To run a local development server that serves the basic demo located in demo/index.html

Usage `<ia-account-settings>` Component

Properties/Attributes

userData: Contains user information.
mailingLists: Active mailing lists available.
selectedMailingLists: User's selected mailing lists.
linkedProviders: Linked third-party providers.
profilePicture: Profile picture URL.
loanHistoryFlag: Boolean status for loan history visibility.
csrfToken: CSRF token for form submissions.

Methods

setScreenname(e: Event): Sets the screen name.
setEmail(e: Event): Sets the email.
setPassword(e: Event): Sets the password.
setLoanHistory(e: Event): Sets the loan history visibility.
setMailingList(e: Event): Sets the mailing list subscriptions.
setLinkedProvider(e: Event): Sets the linked provider.
resetErrorFields(field: string): Resets error fields.
hasFieldError(): Checks if there are any field errors.
validateScreenname(): Validates the screen name.
validateEmail(): Validates the email.
validatePassword(): Validates the password.
isEmailAvailable(): Checks if the email is available.
isScreennameAvailable(): Checks if the screen name is available.
saveAccountSettings(event: Event): Saves the account settings.
profilePictureUploaded(): Handles profile picture upload success.
emitProfileAvatarSaveEvent(): Emits an event to save the profile avatar.
emitUnlinkProviderEvent(): Emits an event to unlink a provider.

Slots

center-of-form: Slot for adding custom content in the center of the form.

Example Usage

<ia-account-settings
  .userData="${userData}"
  .mailingLists="${mailingLists}"
  .selectedMailingLists="${selectedMailingLists}"
  .linkedProviders="${linkedProviders}"
  .profilePicture="${profilePicture}"
  .loanHistoryFlag="${loanHistoryFlag}"
  .csrfToken="${csrfToken}"
></ia-account-settings>

Testing with Web Test Runner

To run the suite of Web Test Runner tests, run

yarn run test

To run the tests in watch mode (for TDD, for example), run

yarn run test:watch

Linting with ESLint, Prettier, and Types

To scan the project for linting errors, run

yarn run lint

You can lint with ESLint and Prettier individually as well

yarn run lint:eslint

yarn run lint:prettier

To automatically fix many linting errors, run

yarn run format

You can format using ESLint and Prettier individually as well

yarn run format:eslint

yarn run format:prettier

Tooling configs

For most of the tools, the configuration is in the package.json to reduce the amount of files in your project.

If you customize the configuration a lot, you can consider moving them to individual files.

Add Codecov

after forking, add your repo to the authorized codecov list: https://github.com/organizations/internetarchive/settings/installations/1268216
then, go to the badge maker page for your repo: https://app.codecov.io/gh/internetarchive/<repo-name>/settings/badge
copy link & paste into top of README.md

Steps to setup `gh-pages` static site generator

Let's start with creating a gh-pages branch.

This branch is where Github will look for the index.html to be hosted

git checkout --orphan gh-pages
git reset --hard
git commit --allow-empty -m "Initializing gh-pages branch"
git push origin gh-pages

Additional setup

Go to repo Settings -> sidebar Pages
In the Source drop-down, choose the branch where you want to host your Github Pages and the directory where it was hosted
- We'll use gh-pages branch for this but you can use other branch name for this
- Just make sure that's the branch where the index.html that you want to host lives in

Manual Deploy using `gh-pages`

You can update the current Github Page without pushing a commit by running:

yarn run ghpages:publish

This build script does the following, see package.json:

ghpages:publish
- This executes ghpages:prepare in the current branch you are currently working on
  - Note: The branch name is required so that it will not override the whole Github Pages directory
- You can check it by navigating through the branch name files directory you set from the step to setup gh-pages branch
  - You can checkout how it looks like in one of our projects here: https://github.com/internetarchive/iaux-collection-browser/tree/gh-pages
ghpages:prepare
- This executes ghpages:build that builds the project dependencies and generates vite build from it
- We use vite to bundle and generate the static assets that we host in Github Pages
  - See vite.config.ts related to this
ghpages:generate
- This executes gh-pages npm package command to publish/upload the generated files from our vite build files
- Upon executing this command:
  - This generates a commit message formatted from the most recent commit message of the branch
  - Push the commit to gh-pages branch that we setup earlier

The live demo app URL from current branch will look something like this: https://<organization_name_or_username>.github.io/<repo_name>/<branch_name>/demo

Automatic Deploy of Demo App

Things that trigger automatic site generation:

a merge to main
- See workflow: gh-pages-main.yml
- Example: https://<organization_name_or_username>.github.io/<repo_name>/main
a pull request against main
- See workflow: pr-preview.yml
  - The URL for your Pull Request will be deleted after merging to main but you can update that in the config
- When you create a Pull Request, if your code passes codecov unit tests, it will be always served live at base URL/pull request number.
- Example: https://<organization_name_or_username>.github.io/<repo_name>/pr/<pr-number>/demo
  - Note that demo is another directory where the index.html lives in
  - You are free to playaround with it and set your desired file directory/structure on your end