Update queue bindings

[jdon]

This PR updates the queue bindings to use the latest features and makes a breaking change to the handling of messages.

Breaking change:

• message.id , message.timestamp and message.body have been changed to function calls,
  • i.e message.id() and message.timestamp().
  • Internally we now store the MessageSys inside the message. So rather than eagerly converting the ids and timestamp, we now only do it when the function is called.
• iter() fn on MessageBatch no longer has a lifetime.

New queue features added:

• ack() and retry() are now available on the individual message
  • retry_with_options() was added to allow specifying the QueueRetryOptions
• ack_all() is now available on the message batch
• retry_all_with_options() was added to the message batch to allow specifying the QueueRetryOptions
• send_batch() is now available on the queue
• It's now possible to set QueueSendOptions when sending a message
  • New builder structs MessageBuilder & RawMessageBuilder added to allow for the creation of messages with options.

Other changes:

• Added queue example to the examples folder
• The signature of Queue::send was changed to take Into<SendMessage<T> where T: Serialize, this change was made to allow users to optionally specify QueueSendOptions using the new builders.
  • This isn't a breaking a change as I've added impl<T: Serialize> From<T> for SendMessage<T>, so users can send the same values as before.
• Allow for sending and receiving of the raw JsValue:
  • Message now has a raw_body function that returns a JsValue.
  • raw_iter() fn has been added to MessageBatch.
  • Queue now has a send_raw and send_raw_batch function that allows sending of JsValue.
  • I was unable to get the bytes content type working with batch messages, so I've not added that to the QueueContentType enum. I think the issue is bytes content types needs a js_sys::ArrayBuffer but js_sys::Reflect::set sets an object.

[jakubadamw]

@zebp any chance this could be reviewed and merged? It seems like a useful change, and the review feedback has been addressed?

[jdon]

@zebp & @kflansburg, I've updated this PR with the latest changes from main, it would be great if we could get this reviewed and merged at some point🙏

new commits

[kflansburg]

I think this looks good. Will probably have it go out in its own release.

[jdon]

I had a fresh look at the latest types and realized there had been more changes to queues since this PR was created.

I've made some more changes, so PR should now be up to date with the latest 2024-03-26 changes

[kflansburg]

Thanks for putting this together, I think this is going to be a really awesome improvement. Just have a few questions.