jpegxl 8.4.0 → 8.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (88) hide show
  1. package/README.md +294 -229
  2. package/dist/animation.browser.mjs +2 -2
  3. package/dist/animation.mjs +2 -2
  4. package/dist/capture-complete.browser.mjs +2 -2
  5. package/dist/capture-complete.mjs +2 -2
  6. package/dist/capture-groups.mjs +2 -2
  7. package/dist/capture.browser.mjs +2 -2
  8. package/dist/capture.mjs +2 -2
  9. package/dist/cli-add.mjs +2 -2
  10. package/dist/cli-astro.mjs +2 -2
  11. package/dist/cli-cloudflare.mjs +2 -2
  12. package/dist/cli-emdash.mjs +2 -2
  13. package/dist/cli-places.mjs +2 -2
  14. package/dist/cli-selftest.mjs +2 -2
  15. package/dist/cli-workers.mjs +2 -2
  16. package/dist/cli.mjs +2 -2
  17. package/dist/decode.browser.mjs +2 -2
  18. package/dist/decode.mjs +2 -2
  19. package/dist/decode.node.mjs +2 -2
  20. package/dist/format.browser.mjs +2 -2
  21. package/dist/format.mjs +2 -2
  22. package/dist/hdr.mjs +2 -2
  23. package/dist/helpers.mjs +2 -2
  24. package/dist/index.browser.mjs +2 -2
  25. package/dist/index.mjs +2 -2
  26. package/dist/jpeg.browser.mjs +2 -2
  27. package/dist/jpeg.mjs +2 -2
  28. package/dist/jpeg.node.mjs +2 -2
  29. package/dist/metadata.mjs +2 -2
  30. package/dist/polyfill.mjs +2 -2
  31. package/dist/resumable.mjs +2 -2
  32. package/dist/resumable.node.mjs +2 -2
  33. package/dist/serve.mjs +2 -2
  34. package/dist/serve.node.mjs +2 -2
  35. package/dist/upload.browser.mjs +2 -2
  36. package/dist/upload.mjs +2 -2
  37. package/dist/verify.mjs +2 -2
  38. package/dist/verify.node.mjs +2 -2
  39. package/dist/wasm-modules.mjs +2 -2
  40. package/examples/agents/jxl-tools.mjs +8 -8
  41. package/examples/android/prepare-assets.mjs +2 -2
  42. package/examples/capacitor/prepare-assets.mjs +2 -2
  43. package/examples/emdash/admin-work.mjs +1 -1
  44. package/examples/emdash/backfill.mjs +4 -4
  45. package/examples/emdash/background.mjs +5 -5
  46. package/examples/emdash/browser-candidate.mjs +1 -1
  47. package/examples/emdash/deliver.mjs +2 -2
  48. package/examples/emdash/host-policy.mjs +6 -6
  49. package/examples/emdash/index.mjs +3 -3
  50. package/examples/emdash/job-runner.mjs +31 -31
  51. package/examples/emdash/job-store.mjs +21 -21
  52. package/examples/emdash/jpeg-source.mjs +2 -2
  53. package/examples/emdash/library-jobs.mjs +21 -21
  54. package/examples/emdash/local-store.mjs +16 -16
  55. package/examples/emdash/media-admin.mjs +9 -9
  56. package/examples/emdash/media-plugin.mjs +62 -62
  57. package/examples/emdash/media-storage.mjs +55 -55
  58. package/examples/emdash/media-words.mjs +89 -89
  59. package/examples/emdash/media-worker.mjs +1 -1
  60. package/examples/emdash/original-envelope.mjs +2 -2
  61. package/examples/emdash/originals.mjs +77 -77
  62. package/examples/emdash/r2-store.mjs +3 -3
  63. package/examples/emdash/read-all.mjs +14 -14
  64. package/examples/emdash/server-only.mjs +1 -1
  65. package/examples/emdash/storage.mjs +1 -1
  66. package/examples/emdash/structural-delivery.mjs +42 -42
  67. package/examples/emdash/thread-driver.mjs +15 -15
  68. package/examples/emdash/thread-worker.mjs +3 -3
  69. package/examples/emdash/work-queue.mjs +11 -11
  70. package/examples/flutter/prepare-assets.mjs +3 -3
  71. package/examples/ios/prepare-assets.mjs +3 -3
  72. package/examples/page-rects.js +14 -14
  73. package/examples/react-native/src/JXLProvider.tsx +19 -9
  74. package/examples/snapdom/jxl.js +3 -2
  75. package/examples/svg-jxl.js +10 -10
  76. package/package.json +1 -1
  77. package/types/animation.d.mts +2 -2
  78. package/types/capture-complete.d.mts +5 -5
  79. package/types/capture.d.mts +1 -1
  80. package/types/format.d.mts +2 -2
  81. package/types/index.d.mts +6 -6
  82. package/types/jpeg.d.mts +1 -1
  83. package/types/result.d.mts +5 -4
  84. package/types/resumable.d.mts +7 -7
  85. package/types/serve.d.mts +1 -1
  86. package/types/types.d.mts +19 -18
  87. package/types/upload.d.mts +1 -1
  88. package/types/verify.d.mts +4 -4
@@ -1,2 +1,2 @@
1
- /*! rapier-jxl 8.4.0 | MIT */
2
- import{readFile as e,rm as t,rmdir as a,stat as n}from"node:fs/promises";import{dirname as r,join as i,basename as s,relative as o,isAbsolute as l}from"node:path";import{createHash as f}from"node:crypto";import{fileURLToPath as c}from"node:url";import{lstat as u,mkdir as p,readFile as d,readlink as h,realpath as m,rename as g,rm as w,writeFile as j}from"node:fs/promises";import{randomBytes as y}from"node:crypto";import{basename as k,dirname as $,isAbsolute as b,join as v,relative as x,resolve as O,sep as S}from"node:path";var _=e=>process.platform==="win32"?e.toLowerCase():e,A=(e,t)=>{let a=x(_(e),_(t));return a===""||a!==".."&&!a.startsWith(".."+S)&&!b(a)},J=/^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/i;import{readFile as R}from"node:fs/promises";var C=["jpegxl","rapier-jxl"],B=C[0];var U=(e,t)=>!!(e?.dependencies?.[t]||e?.devDependencies?.[t]),W=(e,t)=>e.replace(/\b(from\s*|import\s*\(\s*|import\s+|require(?:\.resolve)?\s*\(\s*|module:\s*)(['"])(?:jpegxl|rapier-jxl)(?=[/'"])/g,`$1$2${t}`);var X=(e,t,a)=>Object.assign(new Error(`${t}; ${a}.`),{code:e,fix:a});var I=["wrangler.jsonc","wrangler.json","wrangler.toml"],K="2026-10-01",z=3e4,D=e=>f("sha256").update(e).digest("hex"),F=t=>e(t).catch(e=>{if(["ENOENT","ENOTDIR"].includes(e.code))return null;throw e}),M=async e=>await n(e).catch(()=>null)!==null,G=e=>e.split("\\").join("/"),H=(e,t)=>X("JXL_SETUP",e,t),Q=e=>JSON.stringify(e,null,2)+`\n`,V=(e,t)=>JSON.stringify(e)===JSON.stringify(t),Y={r2:{line:"A Cloudflare R2 bucket: a JPEG XL beside every JPEG and PNG put in it, large ones as a Workflow, reads answered by Accept.",looked:"a wrangler config (wrangler.jsonc, wrangler.json or wrangler.toml), or wrangler in package.json",kind:"a Cloudflare Worker",files:[["jxl-r2.mjs","r2/jxl-r2.mjs"]],usage:"[--bucket <name>] [--dry-run] [--json]"},agents:{line:"A Cloudflare Agents SDK project: JPEG XL tools for agents, as an MCP server and for an Agent class; pictures stay in R2.",looked:"package.json that depends on agents, and a wrangler config",kind:"a Cloudflare Agents SDK",files:[["jxl-tools.mjs","agents/jxl-tools.mjs"],["jxl-mcp.mjs","agents/jxl-mcp.mjs"],["jxl-agent.mjs","agents/jxl-agent.mjs"]],usage:"[--bucket <name>] [--dry-run] [--json]"}},Z=Object.keys(Y),ee=()=>Z.map(e=>({name:e,line:Y[e].line})),te=e=>`Usage: ${B} add ${e} ${Y[e].usage}\n ${B} remove ${e} [--dry-run] [--json]\n\n${Y[e].line}\nIt looks for ${Y[e].looked}, writes ${Y[e].files.map(([e])=>e).join(", ")}, and adds its lines to the wrangler config\nand the dependency to package.json where that is safe; what it leaves to you it prints. Running it again changes nothing;\na file you edited is left as it is. remove deletes exactly what add wrote. Nothing is fetched.`;var ie=(e,t)=>t.reduce((e,t)=>e?.[t],e);var le=["r2_buckets","queues.consumers","workflows","limits.cpu_ms","compatibility_flags","main"],fe=e=>typeof e!="string"||!e||e.includes("\0")||e.includes("\\")||l(e)||e.split("/").some(e=>!e||e==="."||e==="..");var ue=(e,t,a)=>ie(e,t)?.some?.(a);export{Z as CLOUDFLARE_PLACES,ee as cloudflareLines,pe as runAddCloudflare,de as runRemoveCloudflare};async function L(e,t=0){if(t>40)throw Object.assign(new Error("Symbolic link loop"),{code:"ELOOP"});try{return await m(e)}catch(e){if(!["ENOENT","ENOTDIR"].includes(e.code))throw e}if((await u(e).catch(()=>null))?.isSymbolicLink())return L(O($(e),await h(e)),t+1);let a=$(e);return a===e?e:v(await L(a,t),k(e))}async function N(e,t,a){let n=await m(e),r=[];for(let i of t){if(typeof i!="string"||i.includes("\0"))throw a("A project file path is invalid","use a plain relative path inside this folder");let t;try{t=await L(O(e,i))}catch(t){throw t?.code==="ELOOP"?a(`${x(e,O(e,i))||i} has a symbolic link loop`,"replace the link with a folder or file"):t}if(!A(n,t))throw a(`${x(e,O(e,i))||i} leads outside this folder, to ${t}`,"replace the link with the file itself, or run it in the folder the file is in");let s=x(n,t);if(process.platform==="win32"&&s.split(/[\\/]/).some(e=>J.test(e)||/[ .]$/.test(e)))throw a(`${s} uses a reserved Windows file name`,"rename the file or folder");r.push(t)}return r}async function T(e,t){let[a]=await N(e,["package.json"],t),n=await d(a,"utf8").catch(e=>{if(e.code==="ENOENT")return null;throw e});if(n===null)return null;let r;try{r=JSON.parse(n)}catch(e){throw t(`package.json is not JSON (${e.message})`,"correct package.json")}if(!r||typeof r!="object"||Array.isArray(r))throw t("package.json is not a JSON object","correct package.json");return{text:n,manifest:r}}async function E(e,t){await p($(e),{recursive:!0});let a=v($(e),`.${k(e)}.${y(6).toString("hex")}.tmp`);try{await j(a,t,{flag:"wx"}),await g(a,e)}catch(e){throw await w(a,{force:!0}).catch(()=>{}),e}}async function P(){try{let{name:e}=JSON.parse(await R(new URL("../package.json",import.meta.url),"utf8"));return C.includes(e)?e:"rapier-jxl"}catch{return"rapier-jxl"}}function q(e){if(!Array.isArray(e))throw X("JXL_OPTIONS","Command arguments are not an array of text values","pass an array of strings");let t=[];for(let a=0;a<e.length;a++){let n=e[a];if(typeof n!="string")throw X("JXL_OPTIONS","A command argument is not text","pass each argument as a string");t.push(n)}return t}async function ae(){for(let e of[new URL("./examples/",import.meta.url),new URL("../examples/",import.meta.url)])if(await M(i(c(e),"r2")))return c(e);throw H("The installed package is incomplete",`reinstall ${B}`)}function ne(e,t,a){if(a=q(a),a.length===1&&["--help","-h"].includes(a[0]))return{help:!0};let n={dryRun:!1,json:!1};for(let r=0;r<a.length;r++){let i=String(a[r]);if(i==="--dry-run")n.dryRun=!0;else if(i==="--json")n.json=!0;else if(i==="--bucket"&&t==="add"&&n.bucket===void 0&&a[r+1]&&!String(a[r+1]).startsWith("-"))n.bucket=String(a[++r]);else throw X("JXL_OPTIONS",`Unknown option ${i}`,`run npx ${B} ${t} ${e} --help`)}if(n.bucket!==void 0&&!/^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$/.test(n.bucket))throw X("JXL_OPTIONS",`"${n.bucket}" is not a bucket name`,"use 3 to 63 lowercase letters, digits and hyphens");return n}async function re(t){let a=(await Promise.all(I.map(async e=>await M(i(t,e))&&e))).find(Boolean);if(!a)return{file:null,config:null};let n=null;if(a!=="wrangler.toml")try{n=JSON.parse(await e(i(t,a),"utf8"))}catch{}return{file:a,config:n}}function se(e,t){let a=e;for(let e of t.path.slice(0,-1))a=a[e]??={};let n=t.path.at(-1);if(t.op==="push"){let e=a[n]??=[];e.some(e=>V(e,t.value))||e.push(t.value)}else a[n]===void 0&&(a[n]=t.value)}function oe(e,t){let a=[e];for(let e of t.path.slice(0,-1))a.push(a.at(-1)?.[e]);let n=a.at(-1),r=t.path.at(-1);if(!n||typeof n!="object")return!1;if(t.op==="push"){let e=n[r],a=Array.isArray(e)?e.findIndex(e=>V(e,t.value)):-1;if(a<0)return!1;e.splice(a,1),e.length||delete n[r]}else if(V(n[r],t.value))delete n[r];else return!1;for(let e=t.path.length-2;e>=0;e--){let n=a[e];if(n[t.path[e]]&&!Object.keys(n[t.path[e]]).length)delete n[t.path[e]];else break}return!0}async function ce(e,t,a){let[n]=await N(e,[t],H),r=(await F(n))?.toString();if(r==null)return null;let i=e=>H(`${t} ${e}`,`fix or delete ${t}`),o;try{o=JSON.parse(r)}catch{throw i("is not JSON")}if(!o||typeof o!="object"||Array.isArray(o)||o.place!==a)throw i(`is not the record of add ${a}`);if(!o.files||typeof o.files!="object"||Array.isArray(o.files))throw i("has no files");let l=new Set(Y[a].files.map(([e])=>e));if(o.created!==void 0&&o.created!=="wrangler.jsonc")throw i(`lists an unmanaged file (${o.created})`);for(let[e,t]of Object.entries(o.files))if(fe(e)||!(l.has(s(e))||e===o.created)||typeof t!="string"||!/^[0-9a-f]{64}$/.test(t))throw i(`lists an unmanaged file (${e})`);for(let[e,t]of Object.entries(o.originals??{}))if(![o.config?.file,"package.json"].includes(e)||typeof t?.before!="string"||Buffer.from(t.before,"base64").toString("base64")!==t.before||typeof t.after!="string"||!/^[0-9a-f]{64}$/.test(t.after))throw i(`has an invalid original (${e})`);if(o.dirs!==void 0&&(!Array.isArray(o.dirs)||o.dirs.some(e=>fe(e)||!Object.keys(o.files).some(t=>t.startsWith(e+"/")))))throw i("lists an unmanaged folder");let f=o.config;if(f!==void 0&&(!f||!I.includes(f.file)||!Array.isArray(f.ops)||!f.ops.every(e=>["push","set"].includes(e?.op)&&Array.isArray(e.path)&&le.includes(e.path.join(".")))))throw i("has an invalid config entry");return o}async function pe(t,a,{cwd:n,version:l,stdout:f,name:c,templates:u}){let p=ne(t,"add",a);if(p.help){f(te(t));return}let{dryRun:d,json:h}=p,m=Y[t],g=(await T(n,H))?.manifest??null;c??=await P();let{file:w,config:j}=await re(n),y={...g?.dependencies,...g?.devDependencies};if(!(t==="agents"?y.agents&&w:w||y.wrangler))throw H(`This folder is not ${m.kind} project: looked for ${m.looked}`,`run npx ${B} add ${t} in the project's folder`);let k=`.rapier-jxl-${t}.json`,$=await ce(n,k,t),b=[],v=new Map,x={...$?.files},O=[],S=[...$?.config?.ops??[]];if(j?.main!==void 0&&(typeof j.main!="string"||!j.main.trim()))throw H(`main in ${w} is not a file path`,"set main to the Worker's entry file, or remove it");let _=t==="agents"&&j?.main&&r(j.main)!=="."?r(j.main):"",A=u?null:await ae(),J=(g?.name??s(n)).toLowerCase().replace(/^@[^/]+\//,"").replace(/[^a-z0-9-]/g,"-").replace(/^-+|-+$/g,"")||"site";for(let[t,a]of m.files){let r=G(i(_,t)),s=W(u?.[t]??await e(i(A,a),"utf8"),c),o=Buffer.from(s),l=await F(i(n,r)),f=D(o),p=$?.files?.[r];l===null?(v.set(r,o),x[r]=f,b.push({file:r,action:"created"})):D(l)===f?(x[r]=f,b.push({file:r,action:"unchanged"})):p&&D(l)===p?(v.set(r,o),x[r]=f,b.push({file:r,action:"updated"})):b.push({file:r,action:p?"left (edited)":"left (already there)"})}let L=G(i(_,m.files[0][0])),R=p.bucket??j?.r2_buckets?.find(e=>e.binding==="JXL_BUCKET")?.bucket_name??(j?.r2_buckets?.length===1?j.r2_buckets[0].bucket_name:void 0)??`${J}-images`.slice(0,63).replace(/-+$/,"");if(j?.r2_buckets?.length>1&&!p.bucket&&!j.r2_buckets.some(e=>e.binding==="JXL_BUCKET"))throw X("JXL_OPTIONS","The config has several R2 buckets","name the one to use: --bucket <name>");let C=[{op:"push",path:["r2_buckets"],value:{binding:"JXL_BUCKET",bucket_name:R}}];t==="r2"?C.push({op:"push",path:["queues","consumers"],value:{queue:`${R}-jxl`,max_batch_size:1,max_retries:3}},{op:"push",path:["workflows"],value:{name:`${J}-jxl`,binding:"JXL_WORKFLOW",class_name:"JxlWorkflow"}},{op:"set",path:["limits","cpu_ms"],value:z}):C.push({op:"push",path:["compatibility_flags"],value:"nodejs_compat"});let q=`${R}: ${C.map(e=>`${e.path.join(".")} ${JSON.stringify(e.value)}`).join("; ")}`,I=null;if(w)if(!j)O.push(`in ${w}, with bucket ${q}${t==="r2"?`; main = "${L}"`:""}`);else{let e=structuredClone(j),a=[];t==="r2"&&(e.main?G(e.main).replace(/^\.\//,"")!==L&&O.push(`in ${e.main}: import jxlR2, {JxlWorkflow} from '${(e=>e.startsWith(".")?e:"./"+e)(G(o(r(e.main),L)))}'; export {JxlWorkflow}; and answer fetch and queue with jxlR2.fetch and jxlR2.queue (or call them from your own handlers)`):(e.main=L,a.push({op:"set",path:["main"],value:L})));for(let t of C){let n=t.op==="push"?ue(e,t.path,e=>V(e,t.value)):ie(e,t.path)!==void 0,r=t.op==="push"&&t.path[0]==="r2_buckets"&&e.r2_buckets?.some(e=>e.binding==="JXL_BUCKET");!n&&!r&&(se(e,t),a.push(t))}if(a.length){v.set(w,Buffer.from(Q(e)));for(let e of a)S.some(t=>t.op===e.op&&V(t.path,e.path)&&V(t.value,e.value))||S.push(e);b.push({file:w,action:`updated: ${a.map(e=>e.path.join(".")).join(", ")}`})}else b.push({file:w,action:"unchanged"})}else{let e={name:`${J}-jxl`,main:L,compatibility_date:K};for(let t of C)se(e,t);v.set("wrangler.jsonc",Buffer.from(Q(e))),x["wrangler.jsonc"]=D(Q(e)),I="wrangler.jsonc",b.push({file:"wrangler.jsonc",action:"created"})}if(t==="r2"?O.push(`npx wrangler r2 bucket create ${R}`,`npx wrangler queues create ${R}-jxl`,`npx wrangler r2 bucket notification create ${R} --event-type object-create --queue ${R}-jxl`):O.push("in the Worker's fetch: import {jxlMcp} from './jxl-mcp.mjs'; and if (new URL(request.url).pathname === '/mcp') return jxlMcp(request, env, ctx)","in an AIChatAgent: import {jxlAgentTools} from its jxl-agent.mjs, and pass tools: jxlAgentTools(this.env) to streamText"),t==="agents"){let e=["@modelcontextprotocol/server","zod","ai"].filter(e=>!y[e]);e.length&&O.unshift(`npm install ${e.join(" ")}`),!j?.r2_buckets?.some(e=>e.binding==="JXL_BUCKET")&&j&&O.push(`npx wrangler r2 bucket create ${R} (if it does not exist)`)}let Z=$?.dependency??!1,ee=g?structuredClone(g):{private:!0,type:"module"};U(ee,c)?b.push({file:"package.json",action:"unchanged"}):(ee.dependencies={...ee.dependencies,[c]:`^${l}`},v.set("package.json",Buffer.from(Q(ee))),Z=!0,O.unshift("npm install"),b.push({file:"package.json",action:`updated: ${c} ^${l}`}));let oe={};for(let e of[w,"package.json"]){let t=$?.originals?.[e],a=e&&await F(i(n,e));if(!e||!a)continue;let r=v.has(e)?D(v.get(e)):D(a);t&&D(a)===t.after?oe[e]={before:t.before,after:r}:!t&&v.has(e)&&!$?.config&&!$?.dependency&&(oe[e]={before:a.toString("base64"),after:r})}let le=new Set($?.dirs??[]);for(let e of v.keys())for(let t=r(e);t!==".";t=r(t))await M(i(n,t))||le.add(G(t));let fe=[[k,Buffer.from(Q({place:t,version:l,files:x,...S.length&&{config:{file:w??I,ops:S}},dependency:Z,...I&&{created:I},...Object.keys(oe).length&&{originals:oe},...le.size&&{dirs:[...le].sort()}}))],...v],pe=await N(n,fe.map(([e])=>e),H);if(!d)for(let[e,[,t]]of fe.entries())await E(pe[e],t);if(h){f(JSON.stringify({type:"add",place:t,dryRun:d,changes:b,next:O}));return}for(let e of b)f(`${e.file}: ${d&&!/^(unchanged|left)/.test(e.action)?"would be ":""}${e.action}`);for(let e of O)f("next: "+e)}async function de(e,n,{cwd:r,stdout:i,name:s}){let o=ne(e,"remove",n);if(o.help){i(te(e));return}let{dryRun:l,json:f}=o,c=`.rapier-jxl-${e}.json`,u=await ce(r,c,e);if(!u)throw H(`There is nothing to remove: npx ${B} add ${e} has not written files here`,`delete the files yourself, or run npx ${B} add ${e} first`);s??=await P();let p=[],d=[],h=new Map,m=Object.entries(u.files),g=await N(r,m.map(([e])=>e),H);for(let[e,[t,a]]of m.entries()){let n=await F(g[e]);n===null?p.push({file:t,action:"already gone"}):D(n)===a?(d.push(t),p.push({file:t,action:"removed"})):p.push({file:t,action:"left (edited)"})}let w=new Set;for(let[e,{before:t,after:a}]of Object.entries(u.originals??{})){let n=await F((await N(r,[e],H))[0]);n&&D(n)===a&&(h.set(e,Buffer.from(t,"base64")),w.add(e),p.push({file:e,action:"restored"}))}if(u.config&&!u.created&&!w.has(u.config.file)){let e=(await F((await N(r,[u.config.file],H))[0]))?.toString(),t=null;try{t=JSON.parse(e)}catch{}if(!t)p.push({file:u.config.file,action:"left (edited)"});else{let e=0;for(let a of[...u.config.ops].reverse())oe(t,a)&&e++;e===u.config.ops.length?(h.set(u.config.file,Buffer.from(Q(t))),p.push({file:u.config.file,action:"updated: lines removed"})):(e&&h.set(u.config.file,Buffer.from(Q(t))),p.push({file:u.config.file,action:e?"updated: lines removed; the rest were changed and stay":"left (edited)"}))}}if(u.dependency&&!w.has("package.json")){let e=await T(r,H),t=e?.manifest;t?.dependencies?.[s]===`^${u.version}`?(delete t.dependencies[s],Object.keys(t.dependencies).length||delete t.dependencies,h.set("package.json",Buffer.from(Q(t))),p.push({file:"package.json",action:`updated: no longer depends on ${s}`})):p.push({file:"package.json",action:"left (edited)"})}let j=await N(r,[...d,...h.keys(),c],H);if(!l){for(let e of j.slice(0,d.length))await t(e,{force:!0});for(let[e,t]of[...h.values()].entries())await E(j[d.length+e],t);if(!p.some(e=>e.action==="left (edited)")){await t(j.at(-1),{force:!0});let e=await N(r,u.dirs??[],H);for(let t of e.sort((e,t)=>t.length-e.length))await a(t).catch(()=>{})}}if(f){i(JSON.stringify({type:"remove",place:e,dryRun:l,changes:p}));return}for(let e of p)i(`${e.file}: ${l&&/^(removed|updated|restored)/.test(e.action)?"would be ":""}${e.action}`)}
1
+ /*! rapier-jxl 8.4.1 | MIT */
2
+ async function L(e,t=0){if(t>40)throw Object.assign(new Error("Symbolic link loop"),{code:"ELOOP"});try{return await g(e)}catch(e){if(!["ENOENT","ENOTDIR"].includes(e.code))throw e}if((await p(e).catch(()=>null))?.isSymbolicLink())return L(S(b(e),await m(e)),t+1);let a=b(e);return a===e?e:x(await L(a,t),k(e))}async function R(e,t,a){let r=await g(e),n=[];for(let i of t){if(typeof i!="string"||i.includes("\0"))throw a("A project file path is invalid","use a plain relative path inside this folder");let t;try{t=await L(S(e,i))}catch(t){throw t?.code==="ELOOP"?a(`${O(e,S(e,i))||i} has a symbolic link loop`,"replace the link with a folder or file"):t}if(!_(r,t))throw a(`${O(e,S(e,i))||i}: outside folder (${t})`,"replace symlink or run in target folder");let s=O(r,t);if(process.platform==="win32"&&s.split(/[\\/]/).some(e=>N.test(e)||/[ .]$/.test(e)))throw a(`${s} uses a reserved Windows file name`,"rename the file or folder");n.push(t)}return n}async function E(e,t){let[a]=await R(e,["package.json"],t),r=await h(a,"utf8").catch(e=>{if(e.code==="ENOENT")return null;throw e});if(r===null)return null;let n;try{n=JSON.parse(r)}catch(e){throw t(`package.json: invalid JSON (${e.message})`,"fix package.json")}if(!n||typeof n!="object"||Array.isArray(n))throw t("package.json is not a JSON object","correct package.json");return{text:r,manifest:n}}async function W(e,t){await d(b(e),{recursive:!0});let a=x(b(e),`.${k(e)}.${$(6).toString("hex")}.tmp`);try{await y(a,t,{flag:"wx"}),await w(a,e)}catch(e){throw await j(a,{force:!0}).catch(()=>{}),e}}async function P(){try{let{name:e}=JSON.parse(await T(new URL("../package.json",import.meta.url),"utf8"));return C.includes(e)?e:"rapier-jxl"}catch{return"rapier-jxl"}}function I(e){if(!Array.isArray(e))throw U("JXL_OPTIONS","args: array of strings","use: string[]");let t=[];for(let a=0;a<e.length;a++){let r=e[a];if(typeof r!="string")throw U("JXL_OPTIONS","arg: string","each: string");t.push(r)}return t}async function re(){for(let e of[new URL("./examples/",import.meta.url),new URL("../examples/",import.meta.url)])if(await G(i(u(e),"r2")))return u(e);throw Q("package: incomplete",`reinstall: ${B}`)}function ne(e,t,a){if(a=I(a),a.length===1&&["--help","-h"].includes(a[0]))return{help:!0};let r={dryRun:!1,json:!1};for(let n=0;n<a.length;n++){let i=String(a[n]);if(i==="--dry-run")r.dryRun=!0;else if(i==="--json")r.json=!0;else if(i==="--bucket"&&t==="add"&&r.bucket===void 0&&a[n+1]&&!String(a[n+1]).startsWith("-"))r.bucket=String(a[++n]);else throw U("JXL_OPTIONS",`unknown option: ${i}`,`run: npx ${B} ${t} ${e} --help`)}if(r.bucket!==void 0&&!/^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$/.test(r.bucket))throw U("JXL_OPTIONS",`bucket "${r.bucket}": 3-63 [a-z0-9-]`,"use: 3-63 lowercase letters/digits/hyphens");return r}async function se(t){let a=(await Promise.all(z.map(async e=>await G(i(t,e))&&e))).find(Boolean);if(!a)return{file:null,config:null,seen:null};let r=(await e(i(t,a),"utf8")).replace(/^\ufeff/,"");if(a==="wrangler.toml"){for(let e of r.split(/\r?\n/)){let t=e.replace(/#.*$/,"").trim();if(t.startsWith("["))break;let r=t.match(/^main\s*=\s*(?:"([^"]*)"|'([^']*)'|(\S+))$/);if(r)return{file:a,config:null,seen:{main:r[1]??r[2]??r[3]}}}return{file:a,config:null,seen:{}}}let n=null,s=null;try{n=JSON.parse(r)}catch{try{s=ie(r)}catch{throw Q(`${a} could not be read as JSON`,`fix ${a}, then run add again`)}}let o=n??s;if(o===null||typeof o!="object"||Array.isArray(o))throw Q(`${a} is not a JSON object`,`make ${a} one {...} object`);return{file:a,config:n,seen:o}}function le(e,t){let a=e;for(let e of t.path.slice(0,-1))a=a[e]??={};let r=t.path.at(-1);if(t.op==="push"){let e=a[r]??=[];e.some(e=>Y(e,t.value))||e.push(t.value)}else a[r]===void 0&&(a[r]=t.value)}function fe(e,t){let a=[e];for(let e of t.path.slice(0,-1))a.push(a.at(-1)?.[e]);let r=a.at(-1),n=t.path.at(-1);if(!r||typeof r!="object")return!1;if(t.op==="push"){let e=r[n],a=Array.isArray(e)?e.findIndex(e=>Y(e,t.value)):-1;if(a<0)return!1;e.splice(a,1),e.length||delete r[n]}else if(Y(r[n],t.value))delete r[n];else return!1;for(let e=t.path.length-2;e>=0;e--){let r=a[e];if(r[t.path[e]]&&!Object.keys(r[t.path[e]]).length)delete r[t.path[e]];else break}return!0}async function pe(e,t,a){let[r]=await R(e,[t],Q),n=(await M(r))?.toString();if(n==null)return null;let i=e=>Q(`${t} ${e}`,`fix or delete ${t}`),o;try{o=JSON.parse(n)}catch{throw i("is not JSON")}if(!o||typeof o!="object"||Array.isArray(o)||o.place!==a)throw i(`is not the record of add ${a}`);if(!o.files||typeof o.files!="object"||Array.isArray(o.files))throw i("has no files");let l=new Set(Z[a].files.map(([e])=>e));if(o.created!==void 0&&o.created!=="wrangler.jsonc")throw i(`lists an unmanaged file (${o.created})`);for(let[e,t]of Object.entries(o.files))if(ue(e)||!(l.has(s(e))||e===o.created)||typeof t!="string"||!/^[0-9a-f]{64}$/.test(t))throw i(`lists an unmanaged file (${e})`);for(let[e,t]of Object.entries(o.originals??{}))if(![o.config?.file,"package.json"].includes(e)||typeof t?.before!="string"||Buffer.from(t.before,"base64").toString("base64")!==t.before||typeof t.after!="string"||!/^[0-9a-f]{64}$/.test(t.after))throw i(`has an invalid original (${e})`);if(o.dirs!==void 0&&(!Array.isArray(o.dirs)||o.dirs.some(e=>ue(e)||!Object.keys(o.files).some(t=>t.startsWith(e+"/")))))throw i("lists an unmanaged folder");let f=o.config;if(f!==void 0&&(!f||!z.includes(f.file)||!Array.isArray(f.ops)||!f.ops.every(e=>["push","set"].includes(e?.op)&&Array.isArray(e.path)&&ce.includes(e.path.join(".")))))throw i("has an invalid config entry");return o}async function he(t,a,{cwd:r,version:l,stdout:c,name:u,templates:p}){let d=ne(t,"add",a);if(d.help){c(ae(t));return}let{dryRun:h,json:m}=d,g=Z[t],w=(await E(r,Q))?.manifest??null;u??=await P();let{file:j,config:y,seen:$}=await se(r),k={...w?.dependencies,...w?.devDependencies};if(!(t==="agents"?k.agents&&j:j||k.wrangler))throw Q(`${g.kind}: need ${g.looked}`,`run: npx ${B} add ${t} in the Worker folder`);let b=`.rapier-jxl-${t}.json`,v=await pe(r,b,t),x=[],O=new Map,S={...v?.files},J=[],A=[...v?.config?.ops??[]];if($?.main!==void 0&&(typeof $.main!="string"||!$.main.trim()))throw Q(`main in ${j} is not a file path`,"set main to the Worker's entry file, or remove it");let _=$?.main===void 0?null:f(H($.main));if(_!==null&&ue(_))throw Q(`main in ${j} is outside the project`,"set main to the Worker's entry file inside it");let N=t==="agents"&&_&&n(_)!=="."?n(_):"",L=p?null:await re(),T=(w?.name??s(r)).toLowerCase().replace(/^@[^/]+\//,"").replace(/[^a-z0-9-]/g,"-").replace(/^-+|-+$/g,"")||"site";for(let[t,a]of g.files){let n=H(i(N,t)),s=q(p?.[t]??await e(i(L,a),"utf8"),u),o=Buffer.from(s),l=await M(i(r,n)),f=F(o),c=v?.files?.[n];l===null?(O.set(n,o),S[n]=f,x.push({file:n,action:"created"})):F(l)===f?(S[n]=f,x.push({file:n,action:"unchanged"})):c&&F(l)===c?(O.set(n,o),S[n]=f,x.push({file:n,action:"updated"})):x.push({file:n,action:c?"left (edited)":"left (already there)"})}let C=H(i(N,g.files[0][0])),I=Array.isArray($?.r2_buckets)?$.r2_buckets:null,z=d.bucket??I?.find(e=>e?.binding==="JXL_BUCKET")?.bucket_name??(I?.length===1?I[0]?.bucket_name:void 0)??`${T}-images`.slice(0,63).replace(/-+$/,"");if(I?.length>1&&!d.bucket&&!I.some(e=>e?.binding==="JXL_BUCKET"))throw U("JXL_OPTIONS","r2_buckets: --bucket required","use: --bucket <name>");let ee=[{op:"push",path:["r2_buckets"],value:{binding:"JXL_BUCKET",bucket_name:z}}];t==="r2"?ee.push({op:"push",path:["queues","consumers"],value:{queue:`${z}-jxl`,max_batch_size:1,max_retries:3}},{op:"push",path:["workflows"],value:{name:`${T}-jxl`,binding:"JXL_WORKFLOW",class_name:"JxlWorkflow"}},{op:"set",path:["limits","cpu_ms"],value:D}):ee.push({op:"push",path:["compatibility_flags"],value:"nodejs_compat"});let te=`${z}: ${ee.map(e=>`${e.path.join(".")} ${JSON.stringify(e.value)}`).join("; ")}`,ie=null;if(j)if(!y)J.push(`in ${j}, with bucket ${te}${t==="r2"&&!_?`; main = "${C}"`:""}`),t==="r2"&&_&&_.replace(/^\.\//,"")!==C&&J.push(`in ${_}: import jxlR2, {JxlWorkflow} from '${(e=>e.startsWith(".")?e:"./"+e)(H(o(n(_),C)))}'; export {JxlWorkflow}; and answer fetch and queue with jxlR2.fetch and jxlR2.queue`);else{let e=structuredClone(y),a=[];t==="r2"&&(e.main?H(e.main).replace(/^\.\//,"")!==C&&J.push(`in ${e.main}: import jxlR2, {JxlWorkflow} from '${(e=>e.startsWith(".")?e:"./"+e)(H(o(n(e.main),C)))}'; export {JxlWorkflow}; and answer fetch and queue with jxlR2.fetch and jxlR2.queue (or call them from your own handlers)`):(e.main=C,a.push({op:"set",path:["main"],value:C})));for(let t of ee){let r=t.op==="push"?de(e,t.path,e=>Y(e,t.value)):oe(e,t.path)!==void 0,n=t.op==="push"&&t.path[0]==="r2_buckets"&&e.r2_buckets?.some(e=>e.binding==="JXL_BUCKET");!r&&!n&&(le(e,t),a.push(t))}if(a.length){O.set(j,Buffer.from(V(e)));for(let e of a)A.some(t=>t.op===e.op&&Y(t.path,e.path)&&Y(t.value,e.value))||A.push(e);x.push({file:j,action:`updated: ${a.map(e=>e.path.join(".")).join(", ")}`})}else x.push({file:j,action:"unchanged"})}else{let e={name:`${T}-jxl`,main:C,compatibility_date:K};for(let t of ee)le(e,t);O.set("wrangler.jsonc",Buffer.from(V(e))),S["wrangler.jsonc"]=F(V(e)),ie="wrangler.jsonc",x.push({file:"wrangler.jsonc",action:"created"})}if(t==="r2")J.push(`npx wrangler r2 bucket create ${z}`,`npx wrangler queues create ${z}-jxl`,`npx wrangler r2 bucket notification create ${z} --event-type object-create --queue ${z}-jxl`);else{let e=e=>(e=>e.startsWith(".")?e:"./"+e)(H(o(_?n(_):".",i(N,e))));J.push(`in the Worker's fetch${_?` (${_})`:""}: import {jxlMcp} from '${e("jxl-mcp.mjs")}'; and if (new URL(request.url).pathname === '/mcp') return jxlMcp(request, env, ctx)`,`in an AIChatAgent: import {jxlAgentTools} from its ${H(i(N,"jxl-agent.mjs"))}, and pass tools: jxlAgentTools(this.env) to streamText`)}if(t==="agents"){let e=["@modelcontextprotocol/server","zod","ai"].filter(e=>!k[e]);e.length&&J.unshift(`npm install ${e.join(" ")}`),!y?.r2_buckets?.some(e=>e.binding==="JXL_BUCKET")&&y&&J.push(`npx wrangler r2 bucket create ${z} (if it does not exist)`)}let fe=v?.dependency??!1,ce=w?structuredClone(w):{private:!0,type:"module"};X(ce,u)?x.push({file:"package.json",action:"unchanged"}):(ce.dependencies={...ce.dependencies,[u]:`^${l}`},O.set("package.json",Buffer.from(V(ce))),fe=!0,J.unshift("npm install"),x.push({file:"package.json",action:`updated: ${u} ^${l}`}));let he={};for(let e of[j,"package.json"]){let t=v?.originals?.[e],a=e&&await M(i(r,e));if(!e||!a)continue;let n=O.has(e)?F(O.get(e)):F(a);t&&F(a)===t.after?he[e]={before:t.before,after:n}:!t&&O.has(e)&&!v?.config&&!v?.dependency&&(he[e]={before:a.toString("base64"),after:n})}let me=new Set(v?.dirs??[]);for(let e of O.keys())for(let t=n(e);t!==".";t=n(t))await G(i(r,t))||me.add(H(t));let ge=[[b,Buffer.from(V({place:t,version:l,files:S,...A.length&&{config:{file:j??ie,ops:A}},dependency:fe,...ie&&{created:ie},...Object.keys(he).length&&{originals:he},...me.size&&{dirs:[...me].sort()}}))],...O],we=await R(r,ge.map(([e])=>e),Q);if(!h)for(let[e,[,t]]of ge.entries())await W(we[e],t);if(m){c(JSON.stringify({type:"add",place:t,dryRun:h,changes:x,next:J}));return}for(let e of x)c(`${e.file}: ${h&&!/^(unchanged|left)/.test(e.action)?"would be ":""}${e.action}`);for(let e of J)c("next: "+e)}async function me(e,r,{cwd:n,stdout:i,name:s}){let o=ne(e,"remove",r);if(o.help){i(ae(e));return}let{dryRun:l,json:f}=o,c=`.rapier-jxl-${e}.json`,u=await pe(n,c,e);if(!u)throw Q(`${e}: no record to remove`,"nothing to remove; delete any files you added by hand");s??=await P();let p=[],d=[],h=new Map,m=Object.entries(u.files),g=await R(n,m.map(([e])=>e),Q);for(let[e,[t,a]]of m.entries()){let r=await M(g[e]);r===null?p.push({file:t,action:"already gone"}):F(r)===a?(d.push(t),p.push({file:t,action:"removed"})):p.push({file:t,action:"left (edited)"})}let w=new Set;for(let[e,{before:t,after:a}]of Object.entries(u.originals??{})){let r=await M((await R(n,[e],Q))[0]);r&&F(r)===a&&(h.set(e,Buffer.from(t,"base64")),w.add(e),p.push({file:e,action:"restored"}))}if(u.config&&!u.created&&!w.has(u.config.file)){let e=(await M((await R(n,[u.config.file],Q))[0]))?.toString(),t=null;try{t=JSON.parse(e)}catch{}if(!t)p.push({file:u.config.file,action:"left (edited)"});else{let e=0;for(let a of[...u.config.ops].reverse())fe(t,a)&&e++;e===u.config.ops.length?(h.set(u.config.file,Buffer.from(V(t))),p.push({file:u.config.file,action:"updated: lines removed"})):(e&&h.set(u.config.file,Buffer.from(V(t))),p.push({file:u.config.file,action:e?"updated: lines removed; the rest were changed and stay":"left (edited)"}))}}if(u.dependency&&!w.has("package.json")){let e=await E(n,Q),t=e?.manifest;t?.dependencies?.[s]===`^${u.version}`?(delete t.dependencies[s],Object.keys(t.dependencies).length||delete t.dependencies,h.set("package.json",Buffer.from(V(t))),p.push({file:"package.json",action:`updated: no longer depends on ${s}`})):p.push({file:"package.json",action:"left (edited)"})}let j=await R(n,[...d,...h.keys(),c],Q);if(!l){for(let e of j.slice(0,d.length))await t(e,{force:!0});for(let[e,t]of[...h.values()].entries())await W(j[d.length+e],t);if(!p.some(e=>e.action==="left (edited)")){await t(j.at(-1),{force:!0});let e=await R(n,u.dirs??[],Q);for(let t of e.sort((e,t)=>t.length-e.length))await a(t).catch(()=>{})}}if(f){i(JSON.stringify({type:"remove",place:e,dryRun:l,changes:p}));return}for(let e of p)i(`${e.file}: ${l&&/^(removed|updated|restored)/.test(e.action)?"would be ":""}${e.action}`)}import{readFile as e,rm as t,rmdir as a,stat as r}from"node:fs/promises";import{dirname as n,join as i,basename as s,relative as o,isAbsolute as l}from"node:path";import{normalize as f}from"node:path/posix";import{createHash as c}from"node:crypto";import{fileURLToPath as u}from"node:url";import{lstat as p,mkdir as d,readFile as h,readlink as m,realpath as g,rename as w,rm as j,writeFile as y}from"node:fs/promises";import{randomBytes as $}from"node:crypto";import{basename as k,dirname as b,isAbsolute as v,join as x,relative as O,resolve as S,sep as J}from"node:path";var A=e=>process.platform==="win32"?e.toLowerCase():e,_=(e,t)=>{let a=O(A(e),A(t));return a===""||a!==".."&&!a.startsWith(".."+J)&&!v(a)},N=/^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/i;import{readFile as T}from"node:fs/promises";var C=["jpegxl","rapier-jxl"],B=C[0];var X=(e,t)=>!!(e?.dependencies?.[t]||e?.devDependencies?.[t]),q=(e,t)=>e.replace(/\b(from\s*|import\s*\(\s*|import\s+|require(?:\.resolve)?\s*\(\s*|module:\s*)(['"])(?:jpegxl|rapier-jxl)(?=[/'"])/g,`$1$2${t}`);var U=(e,t,a)=>Object.assign(new Error(`${t}; ${a}`),{code:e,fix:a});var z=["wrangler.jsonc","wrangler.json","wrangler.toml"],K="2026-10-01",D=3e4,F=e=>c("sha256").update(e).digest("hex"),M=t=>e(t).catch(e=>{if(["ENOENT","ENOTDIR"].includes(e.code))return null;throw e}),G=async e=>await r(e).catch(()=>null)!==null,H=e=>e.split("\\").join("/"),Q=(e,t)=>U("JXL_SETUP",e,t),V=e=>JSON.stringify(e,null,2)+`\n`,Y=(e,t)=>JSON.stringify(e)===JSON.stringify(t),Z={r2:{line:"A Cloudflare R2 bucket: a JPEG XL beside every JPEG and PNG put in it, large ones as a Workflow, reads answered by Accept.",looked:"a wrangler config (wrangler.jsonc, wrangler.json or wrangler.toml), or wrangler in package.json",kind:"a Cloudflare Worker",files:[["jxl-r2.mjs","r2/jxl-r2.mjs"]],usage:"[--bucket <name>] [--dry-run] [--json]"},agents:{line:"A Cloudflare Agents SDK project: JPEG XL tools for agents, as an MCP server and for an Agent class; pictures stay in R2.",looked:"package.json that depends on agents, and a wrangler config",kind:"a Cloudflare Agents SDK",files:[["jxl-tools.mjs","agents/jxl-tools.mjs"],["jxl-mcp.mjs","agents/jxl-mcp.mjs"],["jxl-agent.mjs","agents/jxl-agent.mjs"]],usage:"[--bucket <name>] [--dry-run] [--json]"}},ee=Object.keys(Z),te=()=>ee.map(e=>({name:e,line:Z[e].line})),ae=e=>`Usage: ${B} add ${e} ${Z[e].usage}\n ${B} remove ${e} [--dry-run] [--json]\n\n${Z[e].line}\nIt looks for ${Z[e].looked}, writes ${Z[e].files.map(([e])=>e).join(", ")}, and adds its lines to the wrangler config\nand the dependency to package.json where that is safe; what it leaves to you it prints. Running it again changes nothing;\na file you edited is left as it is. remove deletes exactly what add wrote. Nothing is fetched.`;var ie=e=>JSON.parse(e.replace(/("(?:[^"\\]|\\.)*")|\/\/[^\n]*|\/\*[\s\S]*?\*\//g,(e,t)=>t??"").replace(/("(?:[^"\\]|\\.)*")|,(\s*[}\]])/g,(e,t,a)=>t??a));var oe=(e,t)=>t.reduce((e,t)=>e?.[t],e);var ce=["r2_buckets","queues.consumers","workflows","limits.cpu_ms","compatibility_flags","main"],ue=e=>typeof e!="string"||!e||e.includes("\0")||e.includes("\\")||l(e)||e.split("/").some(e=>!e||e==="."||e==="..");var de=(e,t,a)=>oe(e,t)?.some?.(a);export{ee as CLOUDFLARE_PLACES,te as cloudflareLines,he as runAddCloudflare,me as runRemoveCloudflare};