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-pushable/dist/src/fifo.d.ts

@@ -0,0 +1,23 @@
+export interface Next<T> {
+    done?: boolean;
+    error?: Error;
+    value?: T;
+}
+export interface FIFOOptions {
+    /**
+     * When the queue reaches this size, it will be split into head/tail parts
+     */
+    splitLimit?: number;
+}
+export declare class FIFO<T> {
+    size: number;
+    private readonly hwm;
+    private head;
+    private tail;
+    constructor(options?: FIFOOptions);
+    calculateSize(obj: any): number;
+    push(val: Next<T>): void;
+    shift(): Next<T> | undefined;
+    isEmpty(): boolean;
+}
+//# sourceMappingURL=fifo.d.ts.map

apps/web5-dwn/node_modules/it-pushable/dist/src/fifo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fifo.d.ts","sourceRoot":"","sources":["../../src/fifo.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,KAAK,CAAC,EAAE,CAAC,CAAA;CACV;AAiDD,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,qBAAa,IAAI,CAAC,CAAC;IACV,IAAI,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,IAAI,CAAc;gBAEb,OAAO,GAAE,WAAgB;IAOtC,aAAa,CAAE,GAAG,EAAE,GAAG,GAAG,MAAM;IAQhC,IAAI,CAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI;IAYzB,KAAK,IAAK,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS;IAiB7B,OAAO,IAAK,OAAO;CAGpB"}

apps/web5-dwn/node_modules/it-pushable/dist/src/fifo.js

@@ -0,0 +1,83 @@
+// ported from https://www.npmjs.com/package/fast-fifo
+class FixedFIFO {
+    buffer;
+    mask;
+    top;
+    btm;
+    next;
+    constructor(hwm) {
+        if (!(hwm > 0) || ((hwm - 1) & hwm) !== 0) {
+            throw new Error('Max size for a FixedFIFO should be a power of two');
+        }
+        this.buffer = new Array(hwm);
+        this.mask = hwm - 1;
+        this.top = 0;
+        this.btm = 0;
+        this.next = null;
+    }
+    push(data) {
+        if (this.buffer[this.top] !== undefined) {
+            return false;
+        }
+        this.buffer[this.top] = data;
+        this.top = (this.top + 1) & this.mask;
+        return true;
+    }
+    shift() {
+        const last = this.buffer[this.btm];
+        if (last === undefined) {
+            return undefined;
+        }
+        this.buffer[this.btm] = undefined;
+        this.btm = (this.btm + 1) & this.mask;
+        return last;
+    }
+    isEmpty() {
+        return this.buffer[this.btm] === undefined;
+    }
+}
+export class FIFO {
+    size;
+    hwm;
+    head;
+    tail;
+    constructor(options = {}) {
+        this.hwm = options.splitLimit ?? 16;
+        this.head = new FixedFIFO(this.hwm);
+        this.tail = this.head;
+        this.size = 0;
+    }
+    calculateSize(obj) {
+        if (obj?.byteLength != null) {
+            return obj.byteLength;
+        }
+        return 1;
+    }
+    push(val) {
+        if (val?.value != null) {
+            this.size += this.calculateSize(val.value);
+        }
+        if (!this.head.push(val)) {
+            const prev = this.head;
+            this.head = prev.next = new FixedFIFO(2 * this.head.buffer.length);
+            this.head.push(val);
+        }
+    }
+    shift() {
+        let val = this.tail.shift();
+        if (val === undefined && (this.tail.next != null)) {
+            const next = this.tail.next;
+            this.tail.next = null;
+            this.tail = next;
+            val = this.tail.shift();
+        }
+        if (val?.value != null) {
+            this.size -= this.calculateSize(val.value);
+        }
+        return val;
+    }
+    isEmpty() {
+        return this.head.isEmpty();
+    }
+}
+//# sourceMappingURL=fifo.js.map

apps/web5-dwn/node_modules/it-pushable/dist/src/fifo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fifo.js","sourceRoot":"","sources":["../../src/fifo.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,135 @@
+/**
+ * @packageDocumentation
+ *
+ * An iterable that you can push values into.
+ *
+ * @example
+ *
+ * ```js
+ * import { pushable } from 'it-pushable'
+ *
+ * const source = pushable()
+ *
+ * setTimeout(() => source.push('hello'), 100)
+ * setTimeout(() => source.push('world'), 200)
+ * setTimeout(() => source.end(), 300)
+ *
+ * const start = Date.now()
+ *
+ * for await (const value of source) {
+ *   console.log(`got "${value}" after ${Date.now() - start}ms`)
+ * }
+ * console.log(`done after ${Date.now() - start}ms`)
+ *
+ * // Output:
+ * // got "hello" after 105ms
+ * // got "world" after 207ms
+ * // done after 309ms
+ * ```
+ *
+ * @example
+ *
+ * ```js
+ * import { pushableV } from 'it-pushable'
+ * import all from 'it-all'
+ *
+ * const source = pushableV()
+ *
+ * source.push(1)
+ * source.push(2)
+ * source.push(3)
+ * source.end()
+ *
+ * console.info(await all(source))
+ *
+ * // Output:
+ * // [ [1, 2, 3] ]
+ * ```
+ */
+export declare class AbortError extends Error {
+    type: string;
+    code: string;
+    constructor(message?: string, code?: string);
+}
+export interface AbortOptions {
+    signal?: AbortSignal;
+}
+interface BasePushable<T> {
+    /**
+     * End the iterable after all values in the buffer (if any) have been yielded. If an
+     * error is passed the buffer is cleared immediately and the next iteration will
+     * throw the passed error
+     */
+    end(err?: Error): this;
+    /**
+     * Push a value into the iterable. Values are yielded from the iterable in the order
+     * they are pushed. Values not yet consumed from the iterable are buffered.
+     */
+    push(value: T): this;
+    /**
+     * Returns a promise that resolves when the underlying queue becomes empty (e.g.
+     * this.readableLength === 0).
+     *
+     * If an AbortSignal is passed as an option and that signal aborts, it only
+     * causes the returned promise to reject - it does not end the pushable.
+     */
+    onEmpty(options?: AbortOptions): Promise<void>;
+    /**
+     * This property contains the number of bytes (or objects) in the queue ready to be read.
+     *
+     * If `objectMode` is true, this is the number of objects in the queue, if false it's the
+     * total number of bytes in the queue.
+     */
+    readableLength: number;
+}
+/**
+ * An iterable that you can push values into.
+ */
+export interface Pushable<T, R = void, N = unknown> extends AsyncGenerator<T, R, N>, BasePushable<T> {
+}
+/**
+ * Similar to `pushable`, except it yields multiple buffered chunks at a time. All values yielded from the iterable will be arrays.
+ */
+export interface PushableV<T, R = void, N = unknown> extends AsyncGenerator<T[], R, N>, BasePushable<T> {
+}
+export interface Options {
+    /**
+     * A boolean value that means non-`Uint8Array`s will be passed to `.push`, default: `false`
+     */
+    objectMode?: boolean;
+    /**
+     * A function called after *all* values have been yielded from the iterator (including
+     * buffered values). In the case when the iterator is ended with an error it will be
+     * passed the error as a parameter.
+     */
+    onEnd?(err?: Error): void;
+}
+export interface DoneResult {
+    done: true;
+}
+export interface ValueResult<T> {
+    done: false;
+    value: T;
+}
+export type NextResult<T> = ValueResult<T> | DoneResult;
+export interface ObjectPushableOptions extends Options {
+    objectMode: true;
+}
+export interface BytePushableOptions extends Options {
+    objectMode?: false;
+}
+/**
+ * Create a new async iterable. The values yielded from calls to `.next()`
+ * or when used in a `for await of`loop are "pushed" into the iterable.
+ * Returns an async iterable object with additional methods.
+ */
+export declare function pushable<T extends {
+    byteLength: number;
+} = Uint8Array>(options?: BytePushableOptions): Pushable<T>;
+export declare function pushable<T>(options: ObjectPushableOptions): Pushable<T>;
+export declare function pushableV<T extends {
+    byteLength: number;
+} = Uint8Array>(options?: BytePushableOptions): PushableV<T>;
+export declare function pushableV<T>(options: ObjectPushableOptions): PushableV<T>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAKH,qBAAa,UAAW,SAAQ,KAAK;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;gBAEC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAK7C;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,UAAU,YAAY,CAAC,CAAC;IACtB;;;;OAIG;IACH,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAA;IAEtB;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;IAEpB;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE9C;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,OAAO,CAAE,SAAQ,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;CAAG;AAEvG;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,OAAO,CAAE,SAAQ,cAAc,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;CAAG;AAE1G,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;;;OAIG;IACH,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,UAAU;IAAG,IAAI,EAAE,IAAI,CAAA;CAAE;AAC1C,MAAM,WAAW,WAAW,CAAC,CAAC;IAAI,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE;AACzD,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,UAAU,CAAA;AAIvD,MAAM,WAAW,qBAAsB,SAAQ,OAAO;IACpD,UAAU,EAAE,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,mBAAoB,SAAQ,OAAO;IAClD,UAAU,CAAC,EAAE,KAAK,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,EAAG,OAAO,CAAC,EAAE,mBAAmB,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;AACpH,wBAAgB,QAAQ,CAAC,CAAC,EAAG,OAAO,EAAE,qBAAqB,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;AAuBzE,wBAAgB,SAAS,CAAC,CAAC,SAAS;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,EAAG,OAAO,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;AACtH,wBAAgB,SAAS,CAAC,CAAC,EAAG,OAAO,EAAE,qBAAqB,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA"}

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

@@ -0,0 +1,267 @@
+/**
+ * @packageDocumentation
+ *
+ * An iterable that you can push values into.
+ *
+ * @example
+ *
+ * ```js
+ * import { pushable } from 'it-pushable'
+ *
+ * const source = pushable()
+ *
+ * setTimeout(() => source.push('hello'), 100)
+ * setTimeout(() => source.push('world'), 200)
+ * setTimeout(() => source.end(), 300)
+ *
+ * const start = Date.now()
+ *
+ * for await (const value of source) {
+ *   console.log(`got "${value}" after ${Date.now() - start}ms`)
+ * }
+ * console.log(`done after ${Date.now() - start}ms`)
+ *
+ * // Output:
+ * // got "hello" after 105ms
+ * // got "world" after 207ms
+ * // done after 309ms
+ * ```
+ *
+ * @example
+ *
+ * ```js
+ * import { pushableV } from 'it-pushable'
+ * import all from 'it-all'
+ *
+ * const source = pushableV()
+ *
+ * source.push(1)
+ * source.push(2)
+ * source.push(3)
+ * source.end()
+ *
+ * console.info(await all(source))
+ *
+ * // Output:
+ * // [ [1, 2, 3] ]
+ * ```
+ */
+import deferred from 'p-defer';
+import { FIFO } from './fifo.js';
+export class AbortError extends Error {
+    type;
+    code;
+    constructor(message, code) {
+        super(message ?? 'The operation was aborted');
+        this.type = 'aborted';
+        this.code = code ?? 'ABORT_ERR';
+    }
+}
+export function pushable(options = {}) {
+    const getNext = (buffer) => {
+        const next = buffer.shift();
+        if (next == null) {
+            return { done: true };
+        }
+        if (next.error != null) {
+            throw next.error;
+        }
+        return {
+            done: next.done === true,
+            // @ts-expect-error if done is false, value will be present
+            value: next.value
+        };
+    };
+    return _pushable(getNext, options);
+}
+export function pushableV(options = {}) {
+    const getNext = (buffer) => {
+        let next;
+        const values = [];
+        while (!buffer.isEmpty()) {
+            next = buffer.shift();
+            if (next == null) {
+                break;
+            }
+            if (next.error != null) {
+                throw next.error;
+            }
+            if (next.done === false) {
+                // @ts-expect-error if done is false value should be pushed
+                values.push(next.value);
+            }
+        }
+        if (next == null) {
+            return { done: true };
+        }
+        return {
+            done: next.done === true,
+            value: values
+        };
+    };
+    return _pushable(getNext, options);
+}
+function _pushable(getNext, options) {
+    options = options ?? {};
+    let onEnd = options.onEnd;
+    let buffer = new FIFO();
+    let pushable;
+    let onNext;
+    let ended;
+    let drain = deferred();
+    const waitNext = async () => {
+        try {
+            if (!buffer.isEmpty()) {
+                return getNext(buffer);
+            }
+            if (ended) {
+                return { done: true };
+            }
+            return await new Promise((resolve, reject) => {
+                onNext = (next) => {
+                    onNext = null;
+                    buffer.push(next);
+                    try {
+                        resolve(getNext(buffer));
+                    }
+                    catch (err) {
+                        reject(err);
+                    }
+                    return pushable;
+                };
+            });
+        }
+        finally {
+            if (buffer.isEmpty()) {
+                // settle promise in the microtask queue to give consumers a chance to
+                // await after calling .push
+                queueMicrotask(() => {
+                    drain.resolve();
+                    drain = deferred();
+                });
+            }
+        }
+    };
+    const bufferNext = (next) => {
+        if (onNext != null) {
+            return onNext(next);
+        }
+        buffer.push(next);
+        return pushable;
+    };
+    const bufferError = (err) => {
+        buffer = new FIFO();
+        if (onNext != null) {
+            return onNext({ error: err });
+        }
+        buffer.push({ error: err });
+        return pushable;
+    };
+    const push = (value) => {
+        if (ended) {
+            return pushable;
+        }
+        // @ts-expect-error `byteLength` is not declared on PushType
+        if (options?.objectMode !== true && value?.byteLength == null) {
+            throw new Error('objectMode was not true but tried to push non-Uint8Array value');
+        }
+        return bufferNext({ done: false, value });
+    };
+    const end = (err) => {
+        if (ended)
+            return pushable;
+        ended = true;
+        return (err != null) ? bufferError(err) : bufferNext({ done: true });
+    };
+    const _return = () => {
+        buffer = new FIFO();
+        end();
+        return { done: true };
+    };
+    const _throw = (err) => {
+        end(err);
+        return { done: true };
+    };
+    pushable = {
+        [Symbol.asyncIterator]() { return this; },
+        next: waitNext,
+        return: _return,
+        throw: _throw,
+        push,
+        end,
+        get readableLength() {
+            return buffer.size;
+        },
+        onEmpty: async (options) => {
+            const signal = options?.signal;
+            signal?.throwIfAborted();
+            if (buffer.isEmpty()) {
+                return;
+            }
+            let cancel;
+            let listener;
+            if (signal != null) {
+                cancel = new Promise((resolve, reject) => {
+                    listener = () => {
+                        reject(new AbortError());
+                    };
+                    signal.addEventListener('abort', listener);
+                });
+            }
+            try {
+                await Promise.race([
+                    drain.promise,
+                    cancel
+                ]);
+            }
+            finally {
+                if (listener != null && signal != null) {
+                    signal?.removeEventListener('abort', listener);
+                }
+            }
+        }
+    };
+    if (onEnd == null) {
+        return pushable;
+    }
+    const _pushable = pushable;
+    pushable = {
+        [Symbol.asyncIterator]() { return this; },
+        next() {
+            return _pushable.next();
+        },
+        throw(err) {
+            _pushable.throw(err);
+            if (onEnd != null) {
+                onEnd(err);
+                onEnd = undefined;
+            }
+            return { done: true };
+        },
+        return() {
+            _pushable.return();
+            if (onEnd != null) {
+                onEnd();
+                onEnd = undefined;
+            }
+            return { done: true };
+        },
+        push,
+        end(err) {
+            _pushable.end(err);
+            if (onEnd != null) {
+                onEnd(err);
+                onEnd = undefined;
+            }
+            return pushable;
+        },
+        get readableLength() {
+            return _pushable.readableLength;
+        },
+        onEmpty: (opts) => {
+            return _pushable.onEmpty(opts);
+        }
+    };
+    return pushable;
+}
+//# sourceMappingURL=index.js.map