Implement helper functions

[qgustavor]

Some helper functions could be implemented in the library. Some proposals:

interateChildren(folder) returns an iterable that returns all children from a folder:

for (const node of interateChildren(folder)) {
  // do something with node
}

getChildrenByPath(folder, 'path/to/children') returns an children based on a specified path

Question: how to import those helper functions? Here are three proposals:

1. Use a separate export and isolated functions:

import { interateChildren } from 'megajs/helpers'
for (const file of interateChildren(storage.root)) console.log(file)

Pros: It avoids making the bundle size larger. Cons: the API design is too different from the existing one.

2. Use a separate export and an install function:

import { installHelpers } from 'megajs/helpers'
installHelpers()

for (const file of storage.root.interateChildren()) console.log(file)

Pros: It also avoids making the bundle size larger and the API design is more similar to the existing one. Cons: Is harder to implement.

3. Bundle those in the library:

for (const file of storage.root.interateChildren()) console.log(file)

Pros: The API design is more similar to the existing one and is easy to implement. Cons: it increases the bundle size.

Proposals 1 and 2 doesn't exclude each other, is possible to export an install function and isolated functions. I prefer proposal 1 by the way.

[qgustavor]

If someone have a proposal of another helper function to be implemented comment here. I should had made a pool for the three API designs, now it's late. React to this comment with 😄 for 1, with 🎉 for 2 and with ❤️ for 3, leave a comment if you have some other proposal.