@lunora/queue 1.0.0-alpha.1 → 1.0.0-alpha.100

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.
@@ -0,0 +1 @@
1
+ import{c as o}from"./run-context-CoNKhXT_.mjs";export{o as createQueueRunContext};
@@ -0,0 +1 @@
1
+ import{LunoraError as a}from"@lunora/errors";import{h as g,R as h}from"./requeue-envelope-Ylx5QErd.mjs";const i=100,d=43200,l=(t,n)=>{if(t!==void 0&&t>d)throw new a("VALIDATION_ERROR",`@lunora/queue: ${n} delaySeconds is ${String(t)}, over the Cloudflare Queues ceiling of ${String(d)} (12 hours) — use @lunora/scheduler for longer schedules`)},$=(t,n)=>{if(g(t))throw new a("VALIDATION_ERROR",`@lunora/queue: ${n} body may not contain the reserved key "${h}"`)},f=(t,n,e)=>{l(n?.delaySeconds,e),$(t,e)},E=(t,n,e)=>{l(n?.delaySeconds,e);const s=[...t];if(s.length>i)throw new a("VALIDATION_ERROR",`@lunora/queue: ${e} exceeds ${String(i)} (got ${String(s.length)}) — split across calls`);for(const[r,o]of s.entries())f(o.body,o,`${e} message ${String(r)}`);return s},O=t=>({send:async(n,e)=>{f(n,e,"send"),await t.send(n,e)},sendBatch:async(n,e)=>{await t.sendBatch(E(n,e,"sendBatch"),e)}}),y=(t,n)=>{const e=t[n];return e&&typeof e.send=="function"&&typeof e.sendBatch=="function"?e:void 0},R=(t,n,e)=>{const s=Object.assign(Object.create(null),t),r=Object.keys(s),o=r.length===0?`no ${n}s are declared`:`known ${n}s: ${r.join(", ")}`;return new Proxy(s,{get(u,c){if(typeof c=="string")return Object.hasOwn(u,c)?u[c]:e(()=>Promise.reject(new Error(`@lunora/queue: no ${n} named "${c}" (${o})`)))}})},w=t=>{const n=t.bindings??{},e={};for(const[s,r]of Object.entries(n))e[s]=O(r);return R(e,"queue",s=>({send:s,sendBatch:s}))};export{f as assertSendable,w as createQueues,R as namedLookup,E as prepareBatch,y as resolveQueueBinding};
@@ -0,0 +1 @@
1
+ import{resolveQueueBinding as c,namedLookup as p,prepareBatch as a,assertSendable as h}from"./createQueues-AS-deVhl.mjs";const f=()=>({isLunoraTopic:!0}),b=n=>typeof n=="object"&&n!==null&&n.isLunoraTopic===!0,w=(n,e)=>{if(!b(n))throw new TypeError("defineSubscription: the first argument must be a `defineTopic()` result");if(typeof e.handler!="function")throw new TypeError("defineSubscription: `handler` must be a function");if(e.name!==void 0&&(typeof e.name!="string"||e.name.length===0))throw new TypeError("defineSubscription: `name` must be a non-empty string when provided");return{...e,isLunoraQueue:!0,mode:"push",topic:n}},l=n=>({publish:async(e,t)=>{h(e,t,"publish"),await Promise.all(n.map(async r=>r.send(e,t)))},publishBatch:async(e,t)=>{const r=a(e,t,"publishBatch");await Promise.all(n.map(async i=>i.sendBatch(r,t)))}}),d=n=>{const e=()=>Promise.reject(new Error(`@lunora/queue: missing queue binding(s) ${n.join(", ")} — add them to wrangler.jsonc (lunora dev reconciles them); nothing was published`));return{publish:e,publishBatch:e}},y=(n,e)=>{const t={};for(const r of e){const i=[],s=[];for(const o of r.subscriptions){const u=c(n,o.binding);u?i.push(u):s.push(o.binding)}t[r.exportName]=s.length>0?d(s):l(i)}return p(t,"topic",r=>({publish:r,publishBatch:r}))};export{y as createTopicContext,w as defineSubscription,f as defineTopic};
@@ -0,0 +1 @@
1
+ const n=e=>`QUEUE_${e.replaceAll(/(?<=[a-z0-9])(?=[A-Z])/g,"_").toUpperCase()}`,t=e=>e.replaceAll(/(?<=[a-z0-9])(?=[A-Z])/g,"-").toLowerCase(),o=e=>{const u=e.mode??"push";if(u!=="push"&&u!=="pull")throw new TypeError(`defineQueue: \`mode\` must be "push" or "pull" (got ${JSON.stringify(e.mode)})`);if(u==="push"&&typeof e.handler!="function")throw new TypeError('defineQueue: `handler` must be a function for a push consumer (omit it only when `mode: "pull"`)');if(e.name!==void 0&&(typeof e.name!="string"||e.name.length===0))throw new TypeError("defineQueue: `name` must be a non-empty string when provided");return{...e,isLunoraQueue:!0,mode:u}},r=e=>typeof e=="object"&&e!==null&&e.isLunoraQueue===!0;export{o as defineQueue,r as isQueueDefinition,n as queueBindingName,t as queueDefaultName};
@@ -0,0 +1 @@
1
+ import{c as h,u as x,f as N,a as q,d as k,o as R}from"./run-context-CoNKhXT_.mjs";import{LunoraError as $,toErrorBody as M}from"@lunora/errors";import{s as A,o as I}from"./requeue-envelope-Ylx5QErd.mjs";const b=e=>typeof e.definition.maxRetries=="number"?e.definition.maxRetries:R,O=e=>{if(e instanceof Date)return e.getTime();const t=typeof e=="number"?e:Number(e);return Number.isFinite(t)?t:0},T=async(e,t)=>{const n=await I(t,e.body).catch(()=>{});return n===void 0?{body:e.body,id:e.id,requeued:!1}:{...n,requeued:!0}},g=e=>{const t=e.LUNORA_ADMIN_TOKEN;return typeof t=="string"&&t.length>0?t:void 0},B=(e,t)=>{let n=0;return(o,i,r)=>(n+=1,e(o,i,{...r,dedupId:`${t}#${String(n)}`,messageId:t}))},L=(e,t,n,o)=>{const i=B(o,t.id);return new Proxy(e,{get:(r,s)=>s==="id"?t.id:s==="body"?t.body:s==="ack"?()=>{n.set(r,"ack"),r.ack()}:s==="retry"?f=>{n.set(r,"retry"),r.retry(f)}:s==="run"?i:Reflect.get(r,s,r)})},j=(e,t,n)=>new Proxy(e,{get:(o,i)=>i==="ackAll"?()=>{n("ack"),o.ackAll()}:i==="retryAll"?r=>{n("retry"),o.retryAll(r)}:i==="messages"?t:Reflect.get(o,i,o)}),S=async(e,t,n)=>{const o=new Map,i=e.messages,r=new Map,s=[];for(const c of i){const u=await T(c,n);r.set(c,u),s.push(L(c,u,o,t))}const l=j(e,s,c=>{for(const u of i)o.has(u)||o.set(u,c)});return{dispositions:o,originals:i,requeued:new Set,views:r,wrappedBatch:l}},m=(e,t)=>e.views.get(t)??{body:t.body,id:t.id,requeued:!1},v=(e,t)=>m(e,t).id,Q=e=>{if(e instanceof Error)return e.message;if(typeof e=="string")return e;if(e!==null&&typeof e=="object")try{return JSON.stringify(e)}catch{return"[unserializable thrown value]"}return String(e)},D=(e,t,n,o,i,r)=>{const s=o?Q(i):void 0,f=b(t),l=o?"error":"ack",c=typeof t.definition.deadLetterQueue=="string"&&t.definition.deadLetterQueue.length>0;return e.originals.map(u=>{const d=u===r,a=e.dispositions.get(u),p=d?"error":a??l,w=typeof u.attempts=="number"?u.attempts:1,y=m(e,u);return{attempts:w,body:y.body,deadLettered:c&&!d&&!e.requeued.has(u)&&p!=="ack"&&w>f,error:p==="error"?s:void 0,exportName:t.exportName,messageId:y.id,outcome:p,queue:n,timestamp:O(u.timestamp)}})},C=(e,t,n)=>{if(!t||!N(n))return;const o=q(n);if(o===void 0)return;const i=e.originals.find(r=>v(e,r)===o);if(!(i===void 0||e.dispositions.has(i)))return i},P=(e,t)=>{t.ack();for(const n of e.originals)n!==t&&!e.dispositions.has(n)&&(e.dispositions.set(n,"retry"),n.retry())},F=async(e,t,n,o,i)=>{const r=g(i),s=q(t),f=e.originals.find(d=>v(e,d)===s&&!e.dispositions.has(d)),l=`@lunora/queue: queue "${o}" (${n.exportName})`,c=n.binding===void 0?void 0:i[n.binding],u=[];for(const d of e.originals)if(!e.dispositions.has(d)){if(e.dispositions.set(d,"retry"),f!==void 0&&d!==f){d.retry();continue}u.push(d)}await Promise.all(u.map(async d=>{const a=m(e,d),p=typeof c?.send!="function"||a.requeued||r===void 0?void 0:async w=>{await c.send(await A(r,a.id,a.body),{contentType:"json",delaySeconds:w})};await k(d,{maxRetries:b(n),requeue:p,where:l})==="requeued"&&e.requeued.add(d)}))},E=async(e,t,n)=>{const o=Object.hasOwn(t,e.queue)?t[e.queue]:void 0;if(o===void 0){const a=Object.keys(t),p=a.length===0?"no push queues are declared":`known push queues: ${a.join(", ")}`;throw new $("INTERNAL",`@lunora/queue: received a batch for queue "${e.queue}" but no push handler is registered (${p}). Likely causes: the queue is declared \`pull\`, a renamed per-environment queue has no wrangler.jsonc producer with the declared binding, or codegen was not rerun.`)}const{handler:i}=o.definition;if(typeof i!="function")throw new TypeError(`@lunora/queue: queue "${e.queue}" (${o.exportName}) has no push handler — it is declared as a pull consumer`);const r=h({env:n.env,exportName:o.exportName,fetchImpl:n.fetchImpl,...n.traceparent===void 0?{}:{traceparent:n.traceparent}}),s=await S(e,r.run,g(n.env));let f=!1,l;try{await i(r,s.wrappedBatch)}catch(a){f=!0,l=a}const c=C(s,f,l);if(c!==void 0){P(s,c);const{body:a,status:p}=M(l,{redactedMessage:"internal error"});console.error(`@lunora/queue: dropped message ${v(s,c)} on queue "${e.queue}" (${o.exportName}) — a dispatch it made failed with a deterministic ${String(p)} (${a.code}: ${a.message}), so it was acked, not retried. Its retries are NOT exhausted and it is not dead-lettered — it will never be redelivered.`)}const u=f&&x(l);u&&await F(s,l,o,e.queue,n.env);const d=f&&c===void 0&&!u;if(n.capture!==void 0)try{await n.capture(D(s,o,e.queue,f,l,c))}catch(a){console.warn("@lunora/queue: capture sink failed (delivery unaffected):",a)}if(d)throw l};export{E as dispatchQueueBatch};
@@ -0,0 +1,4 @@
1
+ const T="lunora.requeue.v1",O=new TextEncoder,j=async(r,t)=>crypto.subtle.importKey("raw",O.encode(r),{hash:"SHA-256",name:"HMAC"},!1,[t]),S=(r,t,o)=>O.encode(`${T}
2
+ ${r}
3
+ ${t}
4
+ ${o}`),U=r=>[...new Uint8Array(r)].map(t=>t.toString(16).padStart(2,"0")).join(""),$=/^[\da-f]{64}$/u,I=async(r,t,o,i)=>U(await crypto.subtle.sign("HMAC",await j(r,"sign"),S(t,o,i))),N=async(r,t,o,i,s)=>{if(typeof s!="string"||!$.test(s))return!1;const e=Uint8Array.from({length:s.length/2},(n,c)=>Number.parseInt(s.slice(c*2,c*2+2),16));return crypto.subtle.verify("HMAC",await j(r,"verify"),e,S(t,o,i))},g=r=>{let t="";for(let i=0;i<r.length;i+=32768)t+=String.fromCharCode(...r.subarray(i,i+32768));return btoa(t)},_=r=>{const t=atob(r),o=new Uint8Array(t.length);for(let i=0;i<t.length;i+=1)o[i]=t.codePointAt(i)??0;return o},a="$lunora.wire$",m=64,w=1024,p="__proto__",A={BigInt64Array,BigUint64Array,Float32Array,Float64Array,Int8Array,Int16Array,Int32Array,Uint8Array,Uint8ClampedArray,Uint16Array,Uint32Array},E={Error,EvalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError},B=r=>{if(r===null||typeof r!="object")return!1;const t=Object.getPrototypeOf(r);return t===null||t===Object.prototype},u=(r,t=0)=>{if(t>m)throw new RangeError(`wire-codec: value nesting exceeds the ${m}-level limit`);if(r===void 0)return[a,"undefined"];if(r===null)return null;const o=typeof r;if(o==="bigint"){const e=r.toString();if(e.length>w)throw new RangeError(`wire-codec: over-long bigint (max ${w} digits)`);return[a,"bigint",e]}if(o==="number"){const e=r;return Number.isNaN(e)?[a,"nan"]:e===1/0?[a,"inf"]:e===-1/0?[a,"-inf"]:e}if(o!=="object")return r;if(r instanceof Date)return[a,"date",u(r.getTime(),t+1)];if(r instanceof Error){const e=r,n=u(Object.fromEntries(Object.keys(e).map(f=>[f,e[f]])),t+1),c=[a,"error",String(e.name),String(e.message),n];return e.cause!==void 0&&c.push(u(e.cause,t+1)),c}if(r instanceof URL)return[a,"url",r.href];if(r instanceof Map)return[a,"map",[...r.entries()].map(([e,n])=>[u(e,t+1),u(n,t+1)])];if(r instanceof Set)return[a,"set",[...r].map(e=>u(e,t+1))];if(r instanceof ArrayBuffer)return[a,"bytes",g(new Uint8Array(r)),"ArrayBuffer"];if(ArrayBuffer.isView(r)){const e=r,n=e.constructor.name,c=new Uint8Array(e.buffer,e.byteOffset,e.byteLength);return n==="Uint8Array"?[a,"bytes",g(c)]:[a,"bytes",g(c),n]}if(Array.isArray(r)){const e=r.map(n=>u(n,t+1));return e.length>0&&e[0]===a?[a,"arr",e]:e}if(!B(r)){const e=r.constructor?.name??"value";throw new TypeError(`wire-codec: cannot encode a ${e} over the Lunora wire — only plain objects, arrays, and the supported built-ins (Date, Error, URL, Map, Set, ArrayBuffer/typed arrays, bigint) round-trip`)}const i=r,s={};for(const e of Object.keys(i)){const n=i[e];if(n===void 0)continue;const c=u(n,t+1);e===p?Object.defineProperty(s,e,{configurable:!0,enumerable:!0,value:c,writable:!0}):s[e]=c}return s},y=(r,t=0)=>{if(t>m)throw new RangeError(`wire-codec: value nesting exceeds the ${m}-level limit`);if(r===null||typeof r!="object")return r;if(Array.isArray(r)){if(r[0]===a)switch(r[1]){case"-inf":return-1/0;case"arr":return r[2].map(e=>y(e,t+1));case"bigint":{const e=r[2];if(typeof e!="string"||e.length>w||!/^-?\d+$/.test(e))throw new RangeError(`wire-codec: invalid or over-long bigint (max ${w} digits)`);return BigInt(e)}case"date":{const e=y(r[2],t+1);if(typeof e!="number")throw new TypeError("wire-codec: malformed date — epoch must be a number");return new Date(e)}case"map":{const e=r[2];return new Map(e.map(n=>{if(!Array.isArray(n)||n.length!==2)throw new TypeError("wire-codec: malformed map entry — expected a [key, value] pair");return[y(n[0],t+1),y(n[1],t+1)]}))}case"set":return new Set(r[2].map(e=>y(e,t+1)));case"url":{const e=r[2];if(typeof e!="string")throw new TypeError("wire-codec: malformed url — href must be a string");return new URL(e)}case"error":{const e=r[2],n=r[3];if(typeof e!="string"||typeof n!="string")throw new TypeError("wire-codec: malformed error — name and message must be strings");const c=(Object.hasOwn(E,e)?E[e]:void 0)??Error,f=new c(n);f.name!==e&&Object.defineProperty(f,"name",{configurable:!0,value:e,writable:!0});const b=y(r[4],t+1);if(b===null||typeof b!="object"||Array.isArray(b))throw new TypeError("wire-codec: malformed error — props must be an object");for(const d of Object.keys(b))d===p?Object.defineProperty(f,d,{configurable:!0,enumerable:!0,value:b[d],writable:!0}):f[d]=b[d];return r.length>5&&Object.defineProperty(f,"cause",{configurable:!0,value:y(r[5],t+1),writable:!0}),f}case"bytes":{const e=r[2];if(typeof e!="string")throw new TypeError("wire-codec: malformed bytes — payload must be a base64 string");const n=_(e);if(g(n)!==e)throw new TypeError("wire-codec: malformed bytes — payload must be canonical padded base64");const c=r[3]??"Uint8Array";if(c==="ArrayBuffer")return n.buffer.byteLength===n.byteLength?n.buffer:n.slice().buffer;const f=Object.hasOwn(A,c)?A[c]:void 0;return f?new f(n.slice().buffer):n}case"inf":return 1/0;case"nan":return Number.NaN;case"undefined":return;default:return r.map(e=>y(e,t+1))}return r.map(s=>y(s,t+1))}const o=r,i={};for(const s of Object.keys(o)){const e=y(o[s],t+1);s===p?Object.defineProperty(i,s,{configurable:!0,enumerable:!0,value:e,writable:!0}):i[s]=e}return i},l="$lunora.requeued$",R="queue",h=128*1024,k=r=>typeof r=="object"&&r!==null&&Object.hasOwn(r,l),x=async(r,t,o)=>{const i=JSON.stringify(u(o)),s={[l]:{body:i,id:t,mac:await I(r,R,t,i)}},e=new TextEncoder().encode(JSON.stringify(s)).byteLength;if(e>h)throw new RangeError(`the copy would be ${String(e)} bytes, over the ${String(h)}-byte queue message limit`);return s},C=async(r,t)=>{if(r===void 0||!k(t))return;const o=t[l];if(!(typeof o?.id!="string"||typeof o.body!="string")&&await N(r,R,o.id,o.body,o.mac))return{body:y(JSON.parse(o.body)),id:o.id}};export{l as R,k as h,C as o,x as s};
@@ -0,0 +1 @@
1
+ import{LunoraError as b,isLunoraError as _}from"@lunora/errors";const J=r=>({debug:(e,...o)=>{console.debug(r,e,...o)},error:(e,...o)=>{console.error(r,e,...o)},info:(e,...o)=>{console.info(r,e,...o)},warn:(e,...o)=>{console.warn(r,e,...o)}}),K=9e5,L="DISPATCH_IN_PROGRESS",F="x-lunora-dispatch-declined",H=(r,e,o)=>{if(e===void 0)return{dispose:()=>{},signal:r};const a=new AbortController,n=setTimeout(()=>{a.abort(o())},e);return{dispose:()=>{clearTimeout(n)},signal:a.signal}},A=r=>{let e="";for(let o=0;o<r.length;o+=32768)e+=String.fromCharCode(...r.subarray(o,o+32768));return btoa(e)},W=r=>{const e=atob(r),o=new Uint8Array(e.length);for(let a=0;a<e.length;a+=1)o[a]=e.codePointAt(a)??0;return o},p="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_",U=r=>{let e="",o=0;const a=r.length-2;for(;o<a;o+=3){const t=r[o]<<16|r[o+1]<<8|r[o+2];e+=p.charAt(t>>18&63)+p.charAt(t>>12&63)+p.charAt(t>>6&63)+p.charAt(t&63)}const n=r.length-o;if(n===1){const t=r[o]<<16;e+=p.charAt(t>>18&63)+p.charAt(t>>12&63)}else if(n===2){const t=r[o]<<16|r[o+1]<<8;e+=p.charAt(t>>18&63)+p.charAt(t>>12&63)+p.charAt(t>>6&63)}return e};new TextDecoder;const x=new TextEncoder,T="=",G=r=>{for(let e=0;e<r.length;e+=1)if(r.charCodeAt(e)>255)return!1;return!0},Q=r=>U(x.encode(JSON.stringify(r))),z=r=>!r.startsWith(T)&&G(r)?r:`${T}${U(x.encode(r))}`,u="$lunora.wire$",v=64,E=1024,O="__proto__",I={BigInt64Array,BigUint64Array,Float32Array,Float64Array,Int8Array,Int16Array,Int32Array,Uint8Array,Uint8ClampedArray,Uint16Array,Uint32Array},R={Error,EvalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError},V=r=>{if(r===null||typeof r!="object")return!1;const e=Object.getPrototypeOf(r);return e===null||e===Object.prototype},h=(r,e=0)=>{if(e>v)throw new RangeError(`wire-codec: value nesting exceeds the ${v}-level limit`);if(r===void 0)return[u,"undefined"];if(r===null)return null;const o=typeof r;if(o==="bigint"){const t=r.toString();if(t.length>E)throw new RangeError(`wire-codec: over-long bigint (max ${E} digits)`);return[u,"bigint",t]}if(o==="number"){const t=r;return Number.isNaN(t)?[u,"nan"]:t===1/0?[u,"inf"]:t===-1/0?[u,"-inf"]:t}if(o!=="object")return r;if(r instanceof Date)return[u,"date",h(r.getTime(),e+1)];if(r instanceof Error){const t=r,s=h(Object.fromEntries(Object.keys(t).map(c=>[c,t[c]])),e+1),i=[u,"error",String(t.name),String(t.message),s];return t.cause!==void 0&&i.push(h(t.cause,e+1)),i}if(r instanceof URL)return[u,"url",r.href];if(r instanceof Map)return[u,"map",[...r.entries()].map(([t,s])=>[h(t,e+1),h(s,e+1)])];if(r instanceof Set)return[u,"set",[...r].map(t=>h(t,e+1))];if(r instanceof ArrayBuffer)return[u,"bytes",A(new Uint8Array(r)),"ArrayBuffer"];if(ArrayBuffer.isView(r)){const t=r,s=t.constructor.name,i=new Uint8Array(t.buffer,t.byteOffset,t.byteLength);return s==="Uint8Array"?[u,"bytes",A(i)]:[u,"bytes",A(i),s]}if(Array.isArray(r)){const t=r.map(s=>h(s,e+1));return t.length>0&&t[0]===u?[u,"arr",t]:t}if(!V(r)){const t=r.constructor?.name??"value";throw new TypeError(`wire-codec: cannot encode a ${t} over the Lunora wire — only plain objects, arrays, and the supported built-ins (Date, Error, URL, Map, Set, ArrayBuffer/typed arrays, bigint) round-trip`)}const a=r,n={};for(const t of Object.keys(a)){const s=a[t];if(s===void 0)continue;const i=h(s,e+1);t===O?Object.defineProperty(n,t,{configurable:!0,enumerable:!0,value:i,writable:!0}):n[t]=i}return n},f=(r,e=0)=>{if(e>v)throw new RangeError(`wire-codec: value nesting exceeds the ${v}-level limit`);if(r===null||typeof r!="object")return r;if(Array.isArray(r)){if(r[0]===u)switch(r[1]){case"-inf":return-1/0;case"arr":return r[2].map(n=>f(n,e+1));case"bigint":{const n=r[2];if(typeof n!="string"||n.length>E||!/^-?\d+$/.test(n))throw new RangeError(`wire-codec: invalid or over-long bigint (max ${E} digits)`);return BigInt(n)}case"date":{const n=f(r[2],e+1);if(typeof n!="number")throw new TypeError("wire-codec: malformed date — epoch must be a number");return new Date(n)}case"map":{const n=r[2];return new Map(n.map(t=>{if(!Array.isArray(t)||t.length!==2)throw new TypeError("wire-codec: malformed map entry — expected a [key, value] pair");return[f(t[0],e+1),f(t[1],e+1)]}))}case"set":return new Set(r[2].map(n=>f(n,e+1)));case"url":{const n=r[2];if(typeof n!="string")throw new TypeError("wire-codec: malformed url — href must be a string");return new URL(n)}case"error":{const n=r[2],t=r[3];if(typeof n!="string"||typeof t!="string")throw new TypeError("wire-codec: malformed error — name and message must be strings");const s=(Object.hasOwn(R,n)?R[n]:void 0)??Error,i=new s(t);i.name!==n&&Object.defineProperty(i,"name",{configurable:!0,value:n,writable:!0});const c=f(r[4],e+1);if(c===null||typeof c!="object"||Array.isArray(c))throw new TypeError("wire-codec: malformed error — props must be an object");for(const l of Object.keys(c))l===O?Object.defineProperty(i,l,{configurable:!0,enumerable:!0,value:c[l],writable:!0}):i[l]=c[l];return r.length>5&&Object.defineProperty(i,"cause",{configurable:!0,value:f(r[5],e+1),writable:!0}),i}case"bytes":{const n=r[2];if(typeof n!="string")throw new TypeError("wire-codec: malformed bytes — payload must be a base64 string");const t=W(n);if(A(t)!==n)throw new TypeError("wire-codec: malformed bytes — payload must be canonical padded base64");const s=r[3]??"Uint8Array";if(s==="ArrayBuffer")return t.buffer.byteLength===t.byteLength?t.buffer:t.slice().buffer;const i=Object.hasOwn(I,s)?I[s]:void 0;return i?new i(t.slice().buffer):t}case"inf":return 1/0;case"nan":return Number.NaN;case"undefined":return;default:return r.map(n=>f(n,e+1))}return r.map(n=>f(n,e+1))}const o=r,a={};for(const n of Object.keys(o)){const t=f(o[n],e+1);n===O?Object.defineProperty(a,n,{configurable:!0,enumerable:!0,value:t,writable:!0}):a[n]=t}return a},X=(r,e,o)=>{try{return h(o)}catch(a){throw new TypeError(`${r}: cannot encode args for '${e}' — ${a instanceof Error?a.message:String(a)}`,a instanceof Error?{cause:a}:void 0)}},Y="/_lunora/scheduler/dispatch",Z=3e4,rr=r=>{let e=r.length;for(;e>0&&r[e-1]==="/";)e-=1;return r.slice(0,e)},P=Symbol("lunoraDispatchFailure"),D=Symbol("lunoraDispatchDecline"),k=Symbol("lunoraDispatchMessageId"),B=(r,e)=>(e!==void 0&&Object.defineProperty(r,k,{value:e}),r),er=(r,e)=>(Object.defineProperty(r,P,{value:!0}),B(r,e)),ur=r=>_(r)?r[k]:void 0,tr=(r,e,o,a)=>{const{status:n}=e;try{const t=JSON.parse(o)?.error;if(typeof t=="object"&&t!==null&&typeof t.code=="string"){const{code:s,data:i,message:c}=t,l=er(new b(s,typeof c=="string"?c:void 0,{data:i,status:n}),a);return e.headers.get(F)==="1"&&Object.defineProperty(l,D,{value:!0}),l}}catch{}return B(new b("INTERNAL",`${r}: function dispatch failed (${String(n)}): ${o}`,{status:n}),a)},nr=new Set([400,403,404,422]),or=new Set([L,"DISPATCH_UNAUTHENTICATED"]),C=r=>_(r)&&r[P]===!0,lr=r=>C(r)&&nr.has(r.status)&&!or.has(r.code),fr=r=>C(r)&&r[D]===!0,j=K/1e3,ar=3,dr=async(r,e)=>{const o=e.maxRetries??ar,a=typeof r.attempts=="number"&&r.attempts>o;let n="";if(a&&e.requeue!==void 0)try{return await e.requeue(j),r.ack(),"requeued"}catch(t){n=` Re-enqueueing a delayed copy failed (${t instanceof Error?t.message:String(t)}).`}return r.retry({delaySeconds:j}),a&&console.error(`${e.where}: message ${r.id} was declined (${L}) on its last delivery (attempt ${String(r.attempts)} of ${String(o+1)}) — its earlier delivery is still running the call.${n} It is retried anyway, but its retries are exhausted, so it will be dead-lettered if the queue has a deadLetterQueue and dropped if not. Raise max_retries so a slow call cannot exhaust it.`),"retried"},sr=(r,e,o)=>new b("INTERNAL",`${r}: function dispatch to "${e}" timed out after ${String(o)}ms`,{status:503}),ir=r=>{const{label:e}=r,o=globalThis.fetch,a=r.fetchImpl??(typeof o=="function"?o.bind(globalThis):void 0);return async(n,t,s={})=>{if(typeof a!="function")throw new TypeError(`${e}: no fetch implementation available — pass fetchImpl or run on a platform with global fetch`);const i=()=>r.argsAlreadyEncoded===!0?t??{}:X(e,n.__lunoraRef,t??{}),c=r.env.LUNORA_ORIGIN_URL;if(typeof c!="string"||c.length===0)throw new b("INTERNAL",`${e}: \`LUNORA_ORIGIN_URL\` must be set on the Worker env so a handler can call back into Lunora functions`);const l=r.env.LUNORA_ADMIN_TOKEN;if(typeof l!="string"||l.length===0)throw new b("INTERNAL",`${e}: \`LUNORA_ADMIN_TOKEN\` must be set on the Worker env to authenticate function dispatch`);const M=`${rr(c)}${Y}`,w={authorization:`Bearer ${l}`,"content-type":"application/json"};r.traceparent!==void 0&&r.traceparent.length>0&&(w.traceparent=r.traceparent),r.identity?.userId!==void 0&&(w["x-lunora-userid"]=z(r.identity.userId)),r.identity?.claims!==void 0&&(w["x-lunora-identity"]=Q(r.identity.claims));const $=s.timeoutMs??Z,S=H(void 0,$,()=>new DOMException(`dispatch timed out after ${String($)}ms`,"TimeoutError")),N=y=>{throw y instanceof Error&&y.name==="TimeoutError"?sr(e,n.__lunoraRef,$):y};let d;try{try{d=await a(M,{body:JSON.stringify({args:i(),functionPath:n.__lunoraRef,id:s.dedupId,shardKey:s.shardKey}),headers:w,method:"POST",signal:S.signal})}catch(m){return N(m)}if(!d.ok){let m;try{m=await d.text()}catch(q){return N(q)}throw tr(e,d,m,s.messageId)}let y;try{y=await d.text()}catch(m){return N(m)}if(y.length===0)return;let g;try{g=JSON.parse(y)}catch{throw new b("INTERNAL",`${e}: function dispatch returned a non-JSON body (${String(d.status)}): ${y}`,{status:d.status})}if(g===null||typeof g!="object"||Array.isArray(g)||!("result"in g))throw new b("INTERNAL",`${e}: function dispatch returned a JSON body that is not a { result } envelope (${String(d.status)}): ${y}`,{status:d.status});return f(g.result)}finally{S.dispose()}}},yr=r=>({env:r.env,log:J(`[queue:${r.exportName}]`),run:ir({env:r.env,fetchImpl:r.fetchImpl,label:"@lunora/queue",...r.traceparent===void 0?{}:{traceparent:r.traceparent}})});export{ur as a,yr as c,dr as d,lr as f,ar as o,fr as u};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lunora/queue",
3
- "version": "1.0.0-alpha.1",
3
+ "version": "1.0.0-alpha.100",
4
4
  "description": "Cloudflare Queues for Lunora: defineQueue producers + consumers, the ctx.queues surface, and the generated queue() worker handler",
5
5
  "keywords": [
6
6
  "background-jobs",
@@ -43,6 +43,10 @@
43
43
  "publishConfig": {
44
44
  "access": "public"
45
45
  },
46
+ "dependencies": {
47
+ "@lunora/errors": ">=1.0.0-alpha.51 <2.0.0-0",
48
+ "@lunora/platform": "1.0.0-alpha.60"
49
+ },
46
50
  "engines": {
47
51
  "node": "^22.15.0 || >=24.11.0"
48
52
  }
@@ -1,14 +0,0 @@
1
- import createQueues from './createQueues-14-vSICK.mjs';
2
-
3
- const createQueueContext = (env, specs) => {
4
- const bindings = {};
5
- for (const spec of specs) {
6
- const binding = env[spec.binding];
7
- if (binding && typeof binding.send === "function" && typeof binding.sendBatch === "function") {
8
- bindings[spec.exportName] = binding;
9
- }
10
- }
11
- return createQueues({ bindings });
12
- };
13
-
14
- export { createQueueContext };
@@ -1,71 +0,0 @@
1
- const createDispatchLogger = (prefix) => {
2
- return {
3
- debug: (message, ...rest) => {
4
- console.debug(prefix, message, ...rest);
5
- },
6
- error: (message, ...rest) => {
7
- console.error(prefix, message, ...rest);
8
- },
9
- info: (message, ...rest) => {
10
- console.info(prefix, message, ...rest);
11
- },
12
- warn: (message, ...rest) => {
13
- console.warn(prefix, message, ...rest);
14
- }
15
- };
16
- };
17
-
18
- const SCHEDULER_DISPATCH_PATH = "/_lunora/scheduler/dispatch";
19
- const trimTrailingSlashes = (value) => {
20
- let end = value.length;
21
- while (end > 0 && value[end - 1] === "/") {
22
- end -= 1;
23
- }
24
- return value.slice(0, end);
25
- };
26
- const createDispatchRunner = (options) => {
27
- const { label } = options;
28
- const globalFetch = globalThis.fetch;
29
- const fetchImpl = options.fetchImpl ?? (typeof globalFetch === "function" ? globalFetch.bind(globalThis) : void 0);
30
- return async (function_, args, runOptions = {}) => {
31
- if (typeof fetchImpl !== "function") {
32
- throw new TypeError(`${label}: no fetch implementation available — pass fetchImpl or run on a platform with global fetch`);
33
- }
34
- const origin = options.env.LUNORA_ORIGIN_URL;
35
- if (typeof origin !== "string" || origin.length === 0) {
36
- throw new Error(`${label}: \`LUNORA_ORIGIN_URL\` must be set on the Worker env so a handler can call back into Lunora functions`);
37
- }
38
- const token = options.env.LUNORA_ADMIN_TOKEN;
39
- if (typeof token !== "string" || token.length === 0) {
40
- throw new Error(`${label}: \`LUNORA_ADMIN_TOKEN\` must be set on the Worker env to authenticate function dispatch`);
41
- }
42
- const url = `${trimTrailingSlashes(origin)}${SCHEDULER_DISPATCH_PATH}`;
43
- const response = await fetchImpl(url, {
44
- body: JSON.stringify({ args: args ?? {}, functionPath: function_.__lunoraRef, shardKey: runOptions.shardKey }),
45
- headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
46
- method: "POST"
47
- });
48
- if (!response.ok) {
49
- throw new Error(`${label}: function dispatch failed (${String(response.status)}): ${await response.text()}`);
50
- }
51
- const text = await response.text();
52
- if (text.length === 0) {
53
- return void 0;
54
- }
55
- try {
56
- return JSON.parse(text);
57
- } catch {
58
- return text;
59
- }
60
- };
61
- };
62
-
63
- const createQueueRunContext = (options) => {
64
- return {
65
- env: options.env,
66
- log: createDispatchLogger(`[queue:${options.exportName}]`),
67
- run: createDispatchRunner({ env: options.env, fetchImpl: options.fetchImpl, label: "@lunora/queue" })
68
- };
69
- };
70
-
71
- export { createQueueRunContext };
@@ -1,33 +0,0 @@
1
- const producerFor = (binding) => {
2
- return {
3
- send: async (body, options) => {
4
- await binding.send(body, options);
5
- },
6
- sendBatch: async (messages, options) => {
7
- await binding.sendBatch(messages, options);
8
- }
9
- };
10
- };
11
- const createQueues = (options) => {
12
- const bindings = options.bindings ?? {};
13
- const producers = /* @__PURE__ */ Object.create(null);
14
- for (const [exportName, binding] of Object.entries(bindings)) {
15
- producers[exportName] = producerFor(binding);
16
- }
17
- const known = Object.keys(producers);
18
- const missing = (name) => {
19
- const suffix = known.length === 0 ? "no queues are declared" : `known queues: ${known.join(", ")}`;
20
- const error = () => Promise.reject(new Error(`@lunora/queue: no queue named "${name}" (${suffix})`));
21
- return { send: error, sendBatch: error };
22
- };
23
- return /* @__PURE__ */ new Proxy(producers, {
24
- get(target, property) {
25
- if (typeof property !== "string") {
26
- return void 0;
27
- }
28
- return Object.hasOwn(target, property) ? target[property] : missing(property);
29
- }
30
- });
31
- };
32
-
33
- export { createQueues as default };
@@ -1,18 +0,0 @@
1
- const queueBindingName = (exportName) => `QUEUE_${exportName.replaceAll(/(?<=[a-z0-9])(?=[A-Z])/g, "_").toUpperCase()}`;
2
- const queueDefaultName = (exportName) => exportName.replaceAll(/(?<=[a-z0-9])(?=[A-Z])/g, "-").toLowerCase();
3
- const defineQueue = (config) => {
4
- const mode = config.mode ?? "push";
5
- if (mode !== "push" && mode !== "pull") {
6
- throw new TypeError(`defineQueue: \`mode\` must be "push" or "pull" (got ${JSON.stringify(config.mode)})`);
7
- }
8
- if (mode === "push" && typeof config.handler !== "function") {
9
- throw new TypeError('defineQueue: `handler` must be a function for a push consumer (omit it only when `mode: "pull"`)');
10
- }
11
- if (config.name !== void 0 && (typeof config.name !== "string" || config.name.length === 0)) {
12
- throw new TypeError("defineQueue: `name` must be a non-empty string when provided");
13
- }
14
- return { ...config, isLunoraQueue: true, mode };
15
- };
16
- const isQueueDefinition = (value) => typeof value === "object" && value !== null && value.isLunoraQueue === true;
17
-
18
- export { defineQueue, isQueueDefinition, queueBindingName, queueDefaultName };
@@ -1,18 +0,0 @@
1
- import { createQueueRunContext } from './createQueueRunContext-DVqG7Oyk.mjs';
2
-
3
- const dispatchQueueBatch = async (batch, registry, options) => {
4
- const entry = registry[batch.queue];
5
- if (entry === void 0) {
6
- const known = Object.keys(registry);
7
- const suffix = known.length === 0 ? "no push queues are declared" : `known push queues: ${known.join(", ")}`;
8
- throw new Error(`@lunora/queue: received a batch for queue "${batch.queue}" but no push handler is registered (${suffix})`);
9
- }
10
- const { handler } = entry.definition;
11
- if (typeof handler !== "function") {
12
- throw new TypeError(`@lunora/queue: queue "${batch.queue}" (${entry.exportName}) has no push handler — it is declared as a pull consumer`);
13
- }
14
- const context = createQueueRunContext({ env: options.env, exportName: entry.exportName, fetchImpl: options.fetchImpl });
15
- await handler(context, batch);
16
- };
17
-
18
- export { dispatchQueueBatch };