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/index.min.js

@@ -0,0 +1,3 @@
+(function (root, factory) {(typeof module === 'object' && module.exports) ? module.exports = factory() : root.ItPushable = factory()}(typeof self !== 'undefined' ? self : this, function () {
+"use strict";var ItPushable=(()=>{var y=Object.defineProperty;var S=Object.getOwnPropertyDescriptor;var _=Object.getOwnPropertyNames;var M=Object.prototype.hasOwnProperty;var P=(i,e)=>{for(var r in e)y(i,r,{get:e[r],enumerable:!0})},A=(i,e,r,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let u of _(e))!M.call(i,u)&&u!==r&&y(i,u,{get:()=>e[u],enumerable:!(t=S(e,u))||t.enumerable});return i};var I=i=>A(y({},"__esModule",{value:!0}),i);var T={};P(T,{AbortError:()=>b,pushable:()=>R,pushableV:()=>j});function c(){let i={};return i.promise=new Promise((e,r)=>{i.resolve=e,i.reject=r}),i}var p=class{buffer;mask;top;btm;next;constructor(e){if(!(e>0)||e-1&e)throw new Error("Max size for a FixedFIFO should be a power of two");this.buffer=new Array(e),this.mask=e-1,this.top=0,this.btm=0,this.next=null}push(e){return this.buffer[this.top]!==void 0?!1:(this.buffer[this.top]=e,this.top=this.top+1&this.mask,!0)}shift(){let e=this.buffer[this.btm];if(e!==void 0)return this.buffer[this.btm]=void 0,this.btm=this.btm+1&this.mask,e}isEmpty(){return this.buffer[this.btm]===void 0}},a=class{size;hwm;head;tail;constructor(e={}){this.hwm=e.splitLimit??16,this.head=new p(this.hwm),this.tail=this.head,this.size=0}calculateSize(e){return e?.byteLength!=null?e.byteLength:1}push(e){if(e?.value!=null&&(this.size+=this.calculateSize(e.value)),!this.head.push(e)){let r=this.head;this.head=r.next=new p(2*this.head.buffer.length),this.head.push(e)}}shift(){let e=this.tail.shift();if(e===void 0&&this.tail.next!=null){let r=this.tail.next;this.tail.next=null,this.tail=r,e=this.tail.shift()}return e?.value!=null&&(this.size-=this.calculateSize(e.value)),e}isEmpty(){return this.head.isEmpty()}};var b=class extends Error{type;code;constructor(e,r){super(e??"The operation was aborted"),this.type="aborted",this.code=r??"ABORT_ERR"}};function R(i={}){return g(r=>{let t=r.shift();if(t==null)return{done:!0};if(t.error!=null)throw t.error;return{done:t.done===!0,value:t.value}},i)}function j(i={}){return g(r=>{let t,u=[];for(;!r.isEmpty()&&(t=r.shift(),t!=null);){if(t.error!=null)throw t.error;t.done===!1&&u.push(t.value)}return t==null?{done:!0}:{done:t.done===!0,value:u}},i)}function g(i,e){e=e??{};let r=e.onEnd,t=new a,u,l,f,m=c(),v=async()=>{try{return t.isEmpty()?f?{done:!0}:await new Promise((n,s)=>{l=d=>{l=null,t.push(d);try{n(i(t))}catch(h){s(h)}return u}}):i(t)}finally{t.isEmpty()&&queueMicrotask(()=>{m.resolve(),m=c()})}},x=n=>l!=null?l(n):(t.push(n),u),z=n=>(t=new a,l!=null?l({error:n}):(t.push({error:n}),u)),E=n=>{if(f)return u;if(e?.objectMode!==!0&&n?.byteLength==null)throw new Error("objectMode was not true but tried to push non-Uint8Array value");return x({done:!1,value:n})},w=n=>f?u:(f=!0,n!=null?z(n):x({done:!0})),L=()=>(t=new a,w(),{done:!0}),k=n=>(w(n),{done:!0});if(u={[Symbol.asyncIterator](){return this},next:v,return:L,throw:k,push:E,end:w,get readableLength(){return t.size},onEmpty:async n=>{let s=n?.signal;if(s?.throwIfAborted(),t.isEmpty())return;let d,h;s!=null&&(d=new Promise((q,N)=>{h=()=>{N(new b)},s.addEventListener("abort",h)}));try{await Promise.race([m.promise,d])}finally{h!=null&&s!=null&&s?.removeEventListener("abort",h)}}},r==null)return u;let o=u;return u={[Symbol.asyncIterator](){return this},next(){return o.next()},throw(n){return o.throw(n),r!=null&&(r(n),r=void 0),{done:!0}},return(){return o.return(),r!=null&&(r(),r=void 0),{done:!0}},push:E,end(n){return o.end(n),r!=null&&(r(n),r=void 0),u},get readableLength(){return o.readableLength},onEmpty:n=>o.onEmpty(n)},u}return I(T);})();
+return ItPushable}));

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

apps/web5-dwn/node_modules/it-pushable/dist/typedoc-urls.json

@@ -0,0 +1,26 @@
+{
+  "AbortError": "https://alanshaw.github.io/it-pushable/classes/AbortError.html",
+  ".:AbortError": "https://alanshaw.github.io/it-pushable/classes/AbortError.html",
+  "AbortOptions": "https://alanshaw.github.io/it-pushable/interfaces/AbortOptions.html",
+  ".:AbortOptions": "https://alanshaw.github.io/it-pushable/interfaces/AbortOptions.html",
+  "BytePushableOptions": "https://alanshaw.github.io/it-pushable/interfaces/BytePushableOptions.html",
+  ".:BytePushableOptions": "https://alanshaw.github.io/it-pushable/interfaces/BytePushableOptions.html",
+  "DoneResult": "https://alanshaw.github.io/it-pushable/interfaces/DoneResult.html",
+  ".:DoneResult": "https://alanshaw.github.io/it-pushable/interfaces/DoneResult.html",
+  "ObjectPushableOptions": "https://alanshaw.github.io/it-pushable/interfaces/ObjectPushableOptions.html",
+  ".:ObjectPushableOptions": "https://alanshaw.github.io/it-pushable/interfaces/ObjectPushableOptions.html",
+  "Options": "https://alanshaw.github.io/it-pushable/interfaces/Options.html",
+  ".:Options": "https://alanshaw.github.io/it-pushable/interfaces/Options.html",
+  "Pushable": "https://alanshaw.github.io/it-pushable/interfaces/Pushable.html",
+  ".:Pushable": "https://alanshaw.github.io/it-pushable/interfaces/Pushable.html",
+  "PushableV": "https://alanshaw.github.io/it-pushable/interfaces/PushableV.html",
+  ".:PushableV": "https://alanshaw.github.io/it-pushable/interfaces/PushableV.html",
+  "ValueResult": "https://alanshaw.github.io/it-pushable/interfaces/ValueResult.html",
+  ".:ValueResult": "https://alanshaw.github.io/it-pushable/interfaces/ValueResult.html",
+  "NextResult": "https://alanshaw.github.io/it-pushable/types/NextResult.html",
+  ".:NextResult": "https://alanshaw.github.io/it-pushable/types/NextResult.html",
+  "pushable": "https://alanshaw.github.io/it-pushable/functions/pushable-1.html",
+  ".:pushable": "https://alanshaw.github.io/it-pushable/functions/pushable-1.html",
+  "pushableV": "https://alanshaw.github.io/it-pushable/functions/pushableV-1.html",
+  ".:pushableV": "https://alanshaw.github.io/it-pushable/functions/pushableV-1.html"
+}