Add comprehensive installation and setup documentation

- Add GETTING_STARTED.md with quick start guide and development modes
- Add INSTALL.sh automated installation script
- Add INSTALLATION_CHECKLIST.md, INSTALLATION_SUCCESS.md, and INSTALLATION_SUMMARY.md
- Add QUICK_REFERENCE.md for common commands
- Add SETUP_GUIDE.md with detailed setup instructions
- Update README.md with improved project overview
- Add did-wallet app dependencies and node_modules

apps/web5-dwn/node_modules/it-first/README.md

@@ -0,0 +1,81 @@
+# it-first
+
+[![codecov](https://img.shields.io/codecov/c/github/achingbrain/it.svg?style=flat-square)](https://codecov.io/gh/achingbrain/it)
+[![CI](https://img.shields.io/github/actions/workflow/status/achingbrain/it/js-test-and-release.yml?branch=main\&style=flat-square)](https://github.com/achingbrain/it/actions/workflows/js-test-and-release.yml?query=branch%3Amain)
+
+> Returns the first result from an async iterator
+
+# About
+
+<!--
+
+!IMPORTANT!
+
+Everything in this README between "# About" and "# Install" is automatically
+generated and will be overwritten the next time the doc generator is run.
+
+To make changes to this section, please update the @packageDocumentation section
+of src/index.js or src/index.ts
+
+To experiment with formatting, please run "npm run docs" from the root of this
+repo and examine the changes made.
+
+-->
+
+Return the first value in an (async)iterable
+
+## Example
+
+```javascript
+import first from 'it-first'
+
+// This can also be an iterator, generator, etc
+const values = [0, 1, 2, 3, 4]
+
+const res = first(values)
+
+console.info(res) // 0
+```
+
+Async sources must be awaited:
+
+```javascript
+import first from 'it-first'
+
+const values = async function * () {
+  yield * [0, 1, 2, 3, 4]
+}
+
+const res = await first(values())
+
+console.info(res) // 0
+```
+
+# Install
+
+```console
+$ npm i it-first
+```
+
+## Browser `<script>` tag
+
+Loading this module through a script tag will make its exports available as `ItFirst` in the global namespace.
+
+```html
+<script src="https://unpkg.com/it-first/dist/index.min.js"></script>
+```
+
+# API Docs
+
+- <https://achingbrain.github.io/it/modules/it_first.html>
+
+# License
+
+Licensed under either of
+
+- Apache 2.0, ([LICENSE-APACHE](https://github.com/achingbrain/it/blob/main/packages/it-first/LICENSE-APACHE) / <http://www.apache.org/licenses/LICENSE-2.0>)
+- MIT ([LICENSE-MIT](https://github.com/achingbrain/it/blob/main/packages/it-first/LICENSE-MIT) / <http://opensource.org/licenses/MIT>)
+
+# Contribution
+
+Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

apps/web5-dwn/node_modules/it-first/dist/index.min.js

@@ -0,0 +1,4 @@
+(function (root, factory) {(typeof module === 'object' && module.exports) ? module.exports = factory() : root.ItFirst = factory()}(typeof self !== 'undefined' ? self : this, function () {
+"use strict";var ItFirst=(()=>{var f=Object.defineProperty;var o=Object.getOwnPropertyDescriptor;var i=Object.getOwnPropertyNames;var a=Object.prototype.hasOwnProperty;var y=(n,r)=>{for(var e in r)f(n,e,{get:r[e],enumerable:!0})},c=(n,r,e,u)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of i(r))!a.call(n,t)&&t!==e&&f(n,t,{get:()=>r[t],enumerable:!(u=o(r,t))||u.enumerable});return n};var d=n=>c(f({},"__esModule",{value:!0}),n);var I={};y(I,{default:()=>b});function l(n){return n[Symbol.asyncIterator]!=null}function s(n){if(l(n))return(async()=>{for await(let r of n)return r})();for(let r of n)return r}var b=s;return d(I);})();
+return ItFirst}));
+//# sourceMappingURL=index.min.js.map

apps/web5-dwn/node_modules/it-first/dist/index.min.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["/**\n * @packageDocumentation\n *\n * Return the first value in an (async)iterable\n *\n * @example\n *\n * ```javascript\n * import first from 'it-first'\n *\n * // This can also be an iterator, generator, etc\n * const values = [0, 1, 2, 3, 4]\n *\n * const res = first(values)\n *\n * console.info(res) // 0\n * ```\n *\n * Async sources must be awaited:\n *\n * ```javascript\n * import first from 'it-first'\n *\n * const values = async function * () {\n *   yield * [0, 1, 2, 3, 4]\n * }\n *\n * const res = await first(values())\n *\n * console.info(res) // 0\n * ```\n */\n\nfunction isAsyncIterable <T> (thing: any): thing is AsyncIterable<T> {\n  return thing[Symbol.asyncIterator] != null\n}\n\n/**\n * Returns the first result from an (async) iterable, unless empty, in which\n * case returns `undefined`\n */\nfunction first <T> (source: Iterable<T>): T | undefined\nfunction first <T> (source: Iterable<T> | AsyncIterable<T>): Promise<T | undefined>\nfunction first <T> (source: Iterable<T> | AsyncIterable<T>): Promise<T | undefined> | T | undefined {\n  if (isAsyncIterable(source)) {\n    return (async () => {\n      for await (const entry of source) { // eslint-disable-line no-unreachable-loop\n        return entry\n      }\n\n      return undefined\n    })()\n  }\n\n  for (const entry of source) { // eslint-disable-line no-unreachable-loop\n    return entry\n  }\n\n  return undefined\n}\n\nexport default first\n"],
+  "mappings": ";2bAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,IAiCA,SAASC,EAAqBC,EAAU,CACtC,OAAOA,EAAM,OAAO,aAAa,GAAK,IACxC,CAQA,SAASC,EAAWC,EAAsC,CACxD,GAAIH,EAAgBG,CAAM,EACxB,OAAQ,SAAW,CACjB,cAAiBC,KAASD,EACxB,OAAOC,CAIX,GAAE,EAGJ,QAAWA,KAASD,EAClB,OAAOC,CAIX,CAEA,IAAAL,EAAeG",
+  "names": ["index_exports", "__export", "index_default", "isAsyncIterable", "thing", "first", "source", "entry"]
+}

apps/web5-dwn/node_modules/it-first/dist/src/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @packageDocumentation
+ *
+ * Return the first value in an (async)iterable
+ *
+ * @example
+ *
+ * ```javascript
+ * import first from 'it-first'
+ *
+ * // This can also be an iterator, generator, etc
+ * const values = [0, 1, 2, 3, 4]
+ *
+ * const res = first(values)
+ *
+ * console.info(res) // 0
+ * ```
+ *
+ * Async sources must be awaited:
+ *
+ * ```javascript
+ * import first from 'it-first'
+ *
+ * const values = async function * () {
+ *   yield * [0, 1, 2, 3, 4]
+ * }
+ *
+ * const res = await first(values())
+ *
+ * console.info(res) // 0
+ * ```
+ */
+/**
+ * Returns the first result from an (async) iterable, unless empty, in which
+ * case returns `undefined`
+ */
+declare function first<T>(source: Iterable<T>): T | undefined;
+declare function first<T>(source: Iterable<T> | AsyncIterable<T>): Promise<T | undefined>;
+export default first;
+//# sourceMappingURL=index.d.ts.map

apps/web5-dwn/node_modules/it-first/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAMH;;;GAGG;AACH,iBAAS,KAAK,CAAE,CAAC,EAAG,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAA;AACvD,iBAAS,KAAK,CAAE,CAAC,EAAG,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;AAmBnF,eAAe,KAAK,CAAA"}

apps/web5-dwn/node_modules/it-first/dist/src/index.js

@@ -0,0 +1,51 @@
+/**
+ * @packageDocumentation
+ *
+ * Return the first value in an (async)iterable
+ *
+ * @example
+ *
+ * ```javascript
+ * import first from 'it-first'
+ *
+ * // This can also be an iterator, generator, etc
+ * const values = [0, 1, 2, 3, 4]
+ *
+ * const res = first(values)
+ *
+ * console.info(res) // 0
+ * ```
+ *
+ * Async sources must be awaited:
+ *
+ * ```javascript
+ * import first from 'it-first'
+ *
+ * const values = async function * () {
+ *   yield * [0, 1, 2, 3, 4]
+ * }
+ *
+ * const res = await first(values())
+ *
+ * console.info(res) // 0
+ * ```
+ */
+function isAsyncIterable(thing) {
+    return thing[Symbol.asyncIterator] != null;
+}
+function first(source) {
+    if (isAsyncIterable(source)) {
+        return (async () => {
+            for await (const entry of source) { // eslint-disable-line no-unreachable-loop
+                return entry;
+            }
+            return undefined;
+        })();
+    }
+    for (const entry of source) { // eslint-disable-line no-unreachable-loop
+        return entry;
+    }
+    return undefined;
+}
+export default first;
+//# sourceMappingURL=index.js.map

apps/web5-dwn/node_modules/it-first/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,SAAS,eAAe,CAAM,KAAU;IACtC,OAAO,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,IAAI,CAAA;AAC5C,CAAC;AAQD,SAAS,KAAK,CAAM,MAAsC;IACxD,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,IAAI,EAAE;YACjB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC,0CAA0C;gBAC5E,OAAO,KAAK,CAAA;YACd,CAAC;YAED,OAAO,SAAS,CAAA;QAClB,CAAC,CAAC,EAAE,CAAA;IACN,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC,0CAA0C;QACtE,OAAO,KAAK,CAAA;IACd,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,eAAe,KAAK,CAAA"}

apps/web5-dwn/node_modules/it-first/package.json

@@ -0,0 +1,142 @@
+{
+  "name": "it-first",
+  "version": "3.0.9",
+  "description": "Returns the first result from an async iterator",
+  "author": "Alex Potsides <alex@achingbrain.net>",
+  "license": "Apache-2.0 OR MIT",
+  "homepage": "https://github.com/achingbrain/it/tree/main/packages/it-first#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/achingbrain/it.git"
+  },
+  "bugs": {
+    "url": "https://github.com/achingbrain/it/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "module",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "src",
+    "dist",
+    "!dist/test",
+    "!**/*.tsbuildinfo"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "release": {
+    "branches": [
+      "main"
+    ],
+    "plugins": [
+      [
+        "@semantic-release/commit-analyzer",
+        {
+          "preset": "conventionalcommits",
+          "releaseRules": [
+            {
+              "breaking": true,
+              "release": "major"
+            },
+            {
+              "revert": true,
+              "release": "patch"
+            },
+            {
+              "type": "feat",
+              "release": "minor"
+            },
+            {
+              "type": "fix",
+              "release": "patch"
+            },
+            {
+              "type": "docs",
+              "release": "patch"
+            },
+            {
+              "type": "test",
+              "release": "patch"
+            },
+            {
+              "type": "deps",
+              "release": "patch"
+            },
+            {
+              "scope": "no-release",
+              "release": false
+            }
+          ]
+        }
+      ],
+      [
+        "@semantic-release/release-notes-generator",
+        {
+          "preset": "conventionalcommits",
+          "presetConfig": {
+            "types": [
+              {
+                "type": "feat",
+                "section": "Features"
+              },
+              {
+                "type": "fix",
+                "section": "Bug Fixes"
+              },
+              {
+                "type": "chore",
+                "section": "Trivial Changes"
+              },
+              {
+                "type": "docs",
+                "section": "Documentation"
+              },
+              {
+                "type": "deps",
+                "section": "Dependencies"
+              },
+              {
+                "type": "test",
+                "section": "Tests"
+              }
+            ]
+          }
+        }
+      ],
+      "@semantic-release/changelog",
+      "@semantic-release/npm",
+      "@semantic-release/github",
+      [
+        "@semantic-release/git",
+        {
+          "assets": [
+            "CHANGELOG.md",
+            "package.json"
+          ]
+        }
+      ]
+    ]
+  },
+  "scripts": {
+    "build": "aegir build",
+    "lint": "aegir lint",
+    "dep-check": "aegir dep-check",
+    "clean": "aegir clean",
+    "test": "aegir test",
+    "test:node": "aegir test -t node --cov",
+    "test:chrome": "aegir test -t browser --cov",
+    "test:chrome-webworker": "aegir test -t webworker",
+    "test:firefox": "aegir test -t browser -- --browser firefox",
+    "test:firefox-webworker": "aegir test -t webworker -- --browser firefox",
+    "release": "aegir release"
+  },
+  "devDependencies": {
+    "aegir": "^47.0.16"
+  }
+}

apps/web5-dwn/node_modules/it-first/src/index.ts

@@ -0,0 +1,62 @@
+/**
+ * @packageDocumentation
+ *
+ * Return the first value in an (async)iterable
+ *
+ * @example
+ *
+ * ```javascript
+ * import first from 'it-first'
+ *
+ * // This can also be an iterator, generator, etc
+ * const values = [0, 1, 2, 3, 4]
+ *
+ * const res = first(values)
+ *
+ * console.info(res) // 0
+ * ```
+ *
+ * Async sources must be awaited:
+ *
+ * ```javascript
+ * import first from 'it-first'
+ *
+ * const values = async function * () {
+ *   yield * [0, 1, 2, 3, 4]
+ * }
+ *
+ * const res = await first(values())
+ *
+ * console.info(res) // 0
+ * ```
+ */
+
+function isAsyncIterable <T> (thing: any): thing is AsyncIterable<T> {
+  return thing[Symbol.asyncIterator] != null
+}
+
+/**
+ * Returns the first result from an (async) iterable, unless empty, in which
+ * case returns `undefined`
+ */
+function first <T> (source: Iterable<T>): T | undefined
+function first <T> (source: Iterable<T> | AsyncIterable<T>): Promise<T | undefined>
+function first <T> (source: Iterable<T> | AsyncIterable<T>): Promise<T | undefined> | T | undefined {
+  if (isAsyncIterable(source)) {
+    return (async () => {
+      for await (const entry of source) { // eslint-disable-line no-unreachable-loop
+        return entry
+      }
+
+      return undefined
+    })()
+  }
+
+  for (const entry of source) { // eslint-disable-line no-unreachable-loop
+    return entry
+  }
+
+  return undefined
+}
+
+export default first