[Stream] Add Stream binding local mode

[natewong1313]

This MR adds local mode support for the Stream binding. Its architected as follows

• entry worker in binding.worker.ts has a bunch of RPC targets, which mimics our production implementation
• DO in object.worker.ts handles blob storage for video/watermark files, plus SQLlite for crud operations

Note that this MR doesn't support creating direct upload URLs yet but I'll do that in a follow up MR

---

• Tests
  • Tests included/updated
  • Automated tests not possible - manual testing has been completed as follows:
  • Additional testing not necessary because:
• Public documentation
  • Cloudflare docs PR(s):
  • Documentation not necessary because: Feature is in progress

A picture of a cute animal (not mandatory, but encouraged)

---

[changeset-bot]

🦋 Changeset detected

Latest commit: b2d629d

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[workers-devprod]

Codeowners approval required for this PR:

• ✅ @cloudflare/wrangler

Show detailed file reviewers

[ask-bonk]

APIError: Not Found: Not found

github run

[ask-bonk]

@natewong1313 Bonk workflow failed. Check the logs for details.

View workflow run · To retry, trigger Bonk again.

[pkg-pr-new]

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@13030

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@13030

miniflare

npm i https://pkg.pr.new/miniflare@13030

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@13030

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@13030

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@13030

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@13030

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@13030

wrangler

npm i https://pkg.pr.new/wrangler@13030

commit: b2d629d

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 6 additional findings.

[github-actions]

✅ All changesets look good

[austin-mc]

lgtm!

[petebacondarwin]

The miniflare plugin itself looks good - I have left a few comments but I think they are mostly just nits that you can choose to implement if you wish.

I would, though, like to see some changes to the tests - there are quite a few scenarios (e.g. non-happy path) that are not tested. But most importantly, I would like the following:

• can we add tests that check the plugin works on reloads (e.g. setOptions and persistence changes).
• avoid using "real timers" in the tests (e.g. await new Promise((r) => setTimeout(r, 5));) which slow down the tests and can also be potential causes of flakes under load. Other plugins implement enableFakeTimers and are able to use that approach to get the desired test coverage.

I am sure that OC could fix up these tests in no time. If you want help I could do probably do this?

[natewong1313]

The miniflare plugin itself looks good - I have left a few comments but I think they are mostly just nits that you can choose to implement if you wish.

I would, though, like to see some changes to the tests - there are quite a few scenarios (e.g. non-happy path) that are not tested. But most importantly, I would like the following:

• can we add tests that check the plugin works on reloads (e.g. setOptions and persistence changes).
• avoid using "real timers" in the tests (e.g. await new Promise((r) => setTimeout(r, 5));) which slow down the tests and can also be potential causes of flakes under load. Other plugins implement enableFakeTimers and are able to use that approach to get the desired test coverage.

I am sure that OC could fix up these tests in no time. If you want help I could do probably do this?

Thanks Pete, I've added more tests with what you wanted and got rid of timers

[petebacondarwin]

@natewong1313 - I think there is a bug here. When in remote mode the binding proxy doesn't have a named entry point. It just has a default one. So this should be:

Suggested change

	entrypoint: "StreamBinding",
	entrypoint: options.stream.remoteProxyConnectionString ? undefined : "StreamBinding",

[roerohan]

#13476

I was already making the same change for Flagship, so I made the same patch for this as well. Feel free to discard it if it doesn't look right!

[natewong1313]

@roerohan Thank you 🙏

[workers-devprod]

Codeowners approval required for this PR:

• ✅ @cloudflare/wrangler

Show detailed file reviewers