Pre-bundling support for npm/jsr packages via deno bundle.
For packages that don't vendor cleanly, bundle them into a self-contained JS file that can be loaded into any runtime.
Workflow
# 1. Bundle a package at build-time
Denox.Npm.bundle!("npm:zod@3.22", "priv/bundles/zod.js")
# 2. Load into a runtime
{:ok, rt} = Denox.runtime()
:ok = Denox.Npm.load(rt, "priv/bundles/zod.js")
# 3. Use the package
{:ok, result} = Denox.eval(rt, "globalThis.zod.string().parse('hello')")The deno CLI is only required at bundle-time, not at runtime.
Summary
Functions
Bundle an npm/jsr package into a single JavaScript file.
Bundle an npm/jsr package, raising on failure.
Bundle from an entrypoint file rather than a specifier.
Load a bundled JavaScript file into a runtime.
Functions
Bundle an npm/jsr package into a single JavaScript file.
Uses deno bundle to produce a self-contained JS file with all
dependencies inlined. The output is an ES module.
Options
:config- path to deno.json for import map resolution:platform- target platform: "deno" (default) or "browser":minify- minify the output (default: false)
Returns :ok or {:error, message}.
Examples
Denox.Npm.bundle("npm:zod@3.22", "priv/bundles/zod.js")
Denox.Npm.bundle("npm:lodash-es@4.17", "priv/bundles/lodash.js", minify: true)Bundle an npm/jsr package, raising on failure.
Same as bundle/3 but raises on error.
Bundle from an entrypoint file rather than a specifier.
Useful when you have a local .ts/.js entrypoint that imports multiple packages.
Options
Same as bundle/3.
Returns :ok or {:error, message}.
Examples
Denox.Npm.bundle_file("lib/js/entrypoint.ts", "priv/bundles/app.js")
Denox.Npm.bundle_file("lib/js/entrypoint.ts", "priv/bundles/app.js", minify: true)@spec load(Denox.runtime(), String.t()) :: :ok | {:error, String.t()}
Load a bundled JavaScript file into a runtime.
Evaluates the bundle file contents in the runtime, making the
exported values available via globalThis.
Returns :ok or {:error, message}.