@lunora/platform-node 1.0.0-alpha.139 → 1.0.0-alpha.140

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.
package/dist/index.mjs CHANGED
@@ -1 +1 @@
1
- import{NODE_SCHEDULER_DISPATCH_PATH as r,createNodeDispatchRoute as t}from"./packem_shared/NODE_SCHEDULER_DISPATCH_PATH-CNBAtztq.mjs";import{createNodeGlobalStore as d,createNodeSqlExec as c}from"./packem_shared/createNodeGlobalStore-DhHyIT8I.mjs";import{createNodeShardKvStore as N}from"./packem_shared/createNodeShardKvStore-DVi1OsvH.mjs";import{createNodePlatform as p}from"./packem_shared/createNodePlatform-lJh2JhaE.mjs";import{createNodeProfileHandler as S}from"./packem_shared/createNodeProfileHandler-MX5xKPg0.mjs";import{createNodeQueueHost as H}from"./packem_shared/createNodeQueueHost-CttDb5sY.mjs";import{createNodeR2Bucket as h}from"./packem_shared/createNodeR2Bucket-C_oO6X63.mjs";import{createNodeSchedulerHost as k}from"./packem_shared/createNodeSchedulerHost-BEAX6I4m.mjs";import{createNodeShardHost as E}from"./packem_shared/createNodeShardHost-B6mt1S-h.mjs";import{createNodeShardRegistry as R}from"./packem_shared/createNodeShardRegistry-q-46Oj8M.mjs";import{createNodeShardState as _}from"./packem_shared/createNodeShardState-D6XMWbFs.mjs";import{createNodeSocketHost as A}from"./packem_shared/createNodeSocketHost-DQs85G7W.mjs";import{createNodeWorkflowHost as T}from"./packem_shared/createNodeWorkflowHost-B76TKiw_.mjs";import{createNodeWorkflowStore as b}from"./packem_shared/createNodeWorkflowStore-CL7RYP6H.mjs";export{r as NODE_SCHEDULER_DISPATCH_PATH,t as createNodeDispatchRoute,d as createNodeGlobalStore,p as createNodePlatform,S as createNodeProfileHandler,H as createNodeQueueHost,h as createNodeR2Bucket,k as createNodeSchedulerHost,E as createNodeShardHost,N as createNodeShardKvStore,R as createNodeShardRegistry,_ as createNodeShardState,A as createNodeSocketHost,c as createNodeSqlExec,T as createNodeWorkflowHost,b as createNodeWorkflowStore};
1
+ import{NODE_SCHEDULER_DISPATCH_PATH as r,createNodeDispatchRoute as t}from"./packem_shared/NODE_SCHEDULER_DISPATCH_PATH-CNBAtztq.mjs";import{createNodeGlobalStore as d,createNodeSqlExec as c}from"./packem_shared/createNodeGlobalStore-DhHyIT8I.mjs";import{createNodeShardKvStore as N}from"./packem_shared/createNodeShardKvStore-DVi1OsvH.mjs";import{createNodePlatform as p}from"./packem_shared/createNodePlatform-B1Khg7rp.mjs";import{createNodeProfileHandler as S}from"./packem_shared/createNodeProfileHandler-MX5xKPg0.mjs";import{createNodeQueueHost as H}from"./packem_shared/createNodeQueueHost-CttDb5sY.mjs";import{createNodeR2Bucket as h}from"./packem_shared/createNodeR2Bucket-6I2HobcB.mjs";import{createNodeSchedulerHost as k}from"./packem_shared/createNodeSchedulerHost-BEAX6I4m.mjs";import{createNodeShardHost as E}from"./packem_shared/createNodeShardHost-B6mt1S-h.mjs";import{createNodeShardRegistry as R}from"./packem_shared/createNodeShardRegistry-q-46Oj8M.mjs";import{createNodeShardState as _}from"./packem_shared/createNodeShardState-D6XMWbFs.mjs";import{createNodeSocketHost as A}from"./packem_shared/createNodeSocketHost-DQs85G7W.mjs";import{createNodeWorkflowHost as T}from"./packem_shared/createNodeWorkflowHost-B76TKiw_.mjs";import{createNodeWorkflowStore as b}from"./packem_shared/createNodeWorkflowStore-CL7RYP6H.mjs";export{r as NODE_SCHEDULER_DISPATCH_PATH,t as createNodeDispatchRoute,d as createNodeGlobalStore,p as createNodePlatform,S as createNodeProfileHandler,H as createNodeQueueHost,h as createNodeR2Bucket,k as createNodeSchedulerHost,E as createNodeShardHost,N as createNodeShardKvStore,R as createNodeShardRegistry,_ as createNodeShardState,A as createNodeSocketHost,c as createNodeSqlExec,T as createNodeWorkflowHost,b as createNodeWorkflowStore};
@@ -1 +1 @@
1
- import{LunoraError as k}from"@lunora/errors";import{NODE_CAPABILITIES as N}from"@lunora/platform";import{createNodeDispatchRoute as b,createShardInvoke as g}from"./NODE_SCHEDULER_DISPATCH_PATH-CNBAtztq.mjs";import{createNodeGlobalStore as y}from"./createNodeGlobalStore-DhHyIT8I.mjs";import{createNodeShardKvStore as R}from"./createNodeShardKvStore-DVi1OsvH.mjs";import{createNodeQueueHost as T}from"./createNodeQueueHost-CttDb5sY.mjs";import{createNodeR2Bucket as q}from"./createNodeR2Bucket-C_oO6X63.mjs";import{createNodeSchedulerHost as B}from"./createNodeSchedulerHost-BEAX6I4m.mjs";import{createNodeShardHost as I}from"./createNodeShardHost-B6mt1S-h.mjs";import{createNodeShardRegistry as _}from"./createNodeShardRegistry-q-46Oj8M.mjs";import{createNodeSocketHost as D}from"./createNodeSocketHost-DQs85G7W.mjs";import{createNodeWorkflowHost as H}from"./createNodeWorkflowHost-B76TKiw_.mjs";import{createNodeWorkflowStore as P}from"./createNodeWorkflowStore-CL7RYP6H.mjs";const z=(e={})=>{const o=[],{database:r,dispose:u,drain:i,host:l}=I(e);o.push(u);try{const a=R(r),t=_(e);o.push(()=>{t.close()});const{directory:d}=t,m=b({adminToken:e.dispatch?.adminToken,defaultShardKey:"__root__",invoke:g(d,e.onFetch!==void 0),schedulerSecret:e.dispatch?.schedulerSecret}),{socket:f}=D(r),{dispose:n,scheduler:p}=B(r,e);o.push(n);const S=e.queues===void 0?void 0:T(r,{onBatch:e.onQueueBatch??(()=>{throw new k("VALIDATION_ERROR","@lunora/platform-node: createNodePlatform was given `queues` without `onQueueBatch`, so a delivered batch has nowhere to go — pass dispatchQueueBatch from @lunora/queue")}),queues:e.queues}),v=e.objectStorageDirectory===void 0?void 0:q({directory:e.objectStorageDirectory}),c=e.globalTablesPath===void 0?void 0:y({path:e.globalTablesPath});c!==void 0&&o.push(()=>{c.dispose()});const w=e.workflows===void 0?void 0:H({store:P(r),workflows:e.workflows}),h=()=>{for(const s of o.toReversed())s()};return{capabilities:N,close:h,directory:d,dispatch:s=>m(s),drain:i,globalTables:c,kv:a,objectStorage:v,queues:S,scheduler:p,shard:l,sockets:f,workflows:w,[Symbol.dispose]:h}}catch(a){for(const t of o.toReversed())try{t()}catch{}throw a}};export{z as createNodePlatform};
1
+ import{LunoraError as k}from"@lunora/errors";import{NODE_CAPABILITIES as N}from"@lunora/platform";import{createNodeDispatchRoute as b,createShardInvoke as g}from"./NODE_SCHEDULER_DISPATCH_PATH-CNBAtztq.mjs";import{createNodeGlobalStore as y}from"./createNodeGlobalStore-DhHyIT8I.mjs";import{createNodeShardKvStore as R}from"./createNodeShardKvStore-DVi1OsvH.mjs";import{createNodeQueueHost as T}from"./createNodeQueueHost-CttDb5sY.mjs";import{createNodeR2Bucket as q}from"./createNodeR2Bucket-6I2HobcB.mjs";import{createNodeSchedulerHost as B}from"./createNodeSchedulerHost-BEAX6I4m.mjs";import{createNodeShardHost as I}from"./createNodeShardHost-B6mt1S-h.mjs";import{createNodeShardRegistry as _}from"./createNodeShardRegistry-q-46Oj8M.mjs";import{createNodeSocketHost as D}from"./createNodeSocketHost-DQs85G7W.mjs";import{createNodeWorkflowHost as H}from"./createNodeWorkflowHost-B76TKiw_.mjs";import{createNodeWorkflowStore as P}from"./createNodeWorkflowStore-CL7RYP6H.mjs";const z=(e={})=>{const o=[],{database:r,dispose:u,drain:i,host:l}=I(e);o.push(u);try{const a=R(r),t=_(e);o.push(()=>{t.close()});const{directory:d}=t,m=b({adminToken:e.dispatch?.adminToken,defaultShardKey:"__root__",invoke:g(d,e.onFetch!==void 0),schedulerSecret:e.dispatch?.schedulerSecret}),{socket:f}=D(r),{dispose:n,scheduler:p}=B(r,e);o.push(n);const S=e.queues===void 0?void 0:T(r,{onBatch:e.onQueueBatch??(()=>{throw new k("VALIDATION_ERROR","@lunora/platform-node: createNodePlatform was given `queues` without `onQueueBatch`, so a delivered batch has nowhere to go — pass dispatchQueueBatch from @lunora/queue")}),queues:e.queues}),v=e.objectStorageDirectory===void 0?void 0:q({directory:e.objectStorageDirectory}),c=e.globalTablesPath===void 0?void 0:y({path:e.globalTablesPath});c!==void 0&&o.push(()=>{c.dispose()});const w=e.workflows===void 0?void 0:H({store:P(r),workflows:e.workflows}),h=()=>{for(const s of o.toReversed())s()};return{capabilities:N,close:h,directory:d,dispatch:s=>m(s),drain:i,globalTables:c,kv:a,objectStorage:v,queues:S,scheduler:p,shard:l,sockets:f,workflows:w,[Symbol.dispose]:h}}catch(a){for(const t of o.toReversed())try{t()}catch{}throw a}};export{z as createNodePlatform};
@@ -0,0 +1 @@
1
+ import{randomUUID as Y,createHash as J}from"node:crypto";import{mkdir as L,open as j,unlink as Z,rename as x,rmdir as K,lstat as q,readdir as Q}from"node:fs/promises";import{join as y,dirname as D,sep as tt}from"node:path";import{LunoraError as f}from"@lunora/errors";import{h as et}from"./hmac-url-BrwGfbCr.mjs";import{t as H}from"./to-array-buffer-DVyXU4Ep.mjs";const v=".lunora-tmp",F="LNR1",g=8,B=1024,$=255,C=2048,rt=/[%A-Z:]/g,b=e=>{const t=e.replaceAll(rt,o=>`%${o.codePointAt(0)?.toString(16).padStart(2,"0").toUpperCase()??""}`),r=t.at(-1);return r==="."||r===" "?`${t.slice(0,-1)}%${r.codePointAt(0)?.toString(16).padStart(2,"0").toUpperCase()??""}`:t},ot=e=>{try{return decodeURIComponent(e)}catch{return}},E=e=>e.split("/").map(t=>b(t)).join("/"),nt=new TextEncoder,at=e=>nt.encode(e).length,N=e=>{if(typeof e!="string"||e.length===0)throw new f("VALIDATION_ERROR","@lunora/platform-node: R2 key must be a non-empty string");if(at(e)>B)throw new f("VALIDATION_ERROR",`@lunora/platform-node: R2 key exceeds ${String(B)}-byte limit`);if(e.includes("\0"))throw new f("VALIDATION_ERROR","@lunora/platform-node: R2 key contains a NUL byte");if(et(e))throw new f("VALIDATION_ERROR","@lunora/platform-node: R2 key contains a control character (including CR/LF)");if(e.includes("\\"))throw new f("VALIDATION_ERROR","@lunora/platform-node: R2 key contains a backslash (a path separator on Windows)");if(e.startsWith("/"))throw new f("VALIDATION_ERROR","@lunora/platform-node: R2 key must not start with `/`");for(const t of e.split("/")){if(Buffer.byteLength(b(t),"utf8")>$)throw new f("VALIDATION_ERROR",`@lunora/platform-node: R2 key segment "${t}" exceeds ${String($)} bytes once escaped for the filesystem`);if(t===""||t==="."||t==="..")throw new f("VALIDATION_ERROR",`@lunora/platform-node: R2 key has an empty, \`.\` or \`..\` path segment ("${e}")`);if(t===v)throw new f("VALIDATION_ERROR",`@lunora/platform-node: R2 key is reserved (no segment may be "${v}")`)}},st=e=>{if(e===void 0)return;let t=0;for(const[r,o]of Object.entries(e))t+=Buffer.byteLength(r,"utf8")+Buffer.byteLength(o,"utf8");if(t>C)throw new f("VALIDATION_ERROR",`@lunora/platform-node: R2 customMetadata is ${String(t)} bytes, over the ${String(C)}-byte ceiling R2 applies to the summed keys and values — your metadata headers exceed the maximum allowed metadata size`)},it=/^[\da-f]{64}$/,ct=e=>{if(typeof e=="string"){const t=e.toLowerCase();if(!it.test(t))throw new f("VALIDATION_ERROR","@lunora/platform-node: R2 put sha256 must be 64 hex characters or a 32-byte buffer");return t}if(e.byteLength!==32)throw new f("VALIDATION_ERROR","@lunora/platform-node: R2 put sha256 must be 64 hex characters or a 32-byte buffer");return Buffer.from(e).toString("hex")},_=e=>e instanceof Error&&"code"in e&&e.code==="ENOENT",W=(e,t)=>{const r=t instanceof Error&&"code"in t?t.code:void 0;return r==="EEXIST"||r==="EISDIR"||r==="ENOTDIR"?new f("VALIDATION_ERROR",`@lunora/platform-node: R2 key "${e}" collides with an existing object at one of its path prefixes — this host stores one file per key, so a key and a prefix of it cannot both hold objects`):t},ft=e=>{const t=Buffer.from(JSON.stringify(e),"utf8"),r=Buffer.alloc(g);return r.writeUInt32BE(t.byteLength,0),r.write(F,4,"ascii"),Buffer.concat([t,r])},dt=e=>{if(typeof e!="object"||e===null)return!1;const t=e;return typeof t.sha256Hex=="string"&&typeof t.size=="number"&&typeof t.uploaded=="string"},lt=async e=>{const t=await e.stat();if(!t.isFile()||t.size<g)return;const r=Buffer.alloc(g);if(await e.read(r,0,g,t.size-g),r.toString("ascii",4,g)!==F)return;const o=r.readUInt32BE(0),n=t.size-g-o;if(o===0||n<0)return;const a=Buffer.alloc(o),{bytesRead:i}=await e.read(a,0,o,n);if(i!==o)return;let c;try{c=JSON.parse(a.toString("utf8"))}catch{return}return dt(c)?{bodySize:n,meta:c}:void 0},P=async e=>{let t;try{t=await j(e,"r")}catch(r){if(_(r))return;throw r}try{const r=await lt(t);if(r===void 0){await t.close();return}return{...r,handle:t}}catch(r){throw await t.close(),r}},V=new FinalizationRegistry(e=>{e.close().catch(()=>{})}),M=async e=>{const t=await P(e);if(t!==void 0)return await t.handle.close(),{bodySize:t.bodySize,meta:t.meta}},A=(e,t)=>{const{sha256Hex:r}=t,o=Buffer.from(r,"hex");return{checksums:{sha256:H(o)},customMetadata:t.customMetadata,etag:r,httpEtag:`"${r}"`,httpMetadata:t.httpMetadata,key:e,sha256:r,sha256Base64:o.toString("base64"),size:t.size,uploaded:new Date(t.uploaded)}},S=(e,t,r)=>e===void 0||!Number.isFinite(e)?t:Math.min(Math.max(0,Math.floor(e)),r),ut=(e,t)=>{if(t===void 0)return{end:e,start:0};if("suffix"in t)return{end:e,start:e-S(t.suffix,e,e)};const r=S(t.offset,0,e);return{end:t.length===void 0||!Number.isFinite(t.length)?e:Math.min(r+S(t.length,0,e),e),start:r}},ht=(e,t,r,o)=>{const n=e.createReadStream({autoClose:!1,end:r-1,start:t})[Symbol.asyncIterator]();return new ReadableStream({cancel:async()=>{await n.return?.(),await o()},pull:async a=>{let i;try{i=await n.next()}catch(c){throw await o(),c}i.done===!0?(a.close(),await o()):a.enqueue(i.value)}})},wt=async(e,t,r)=>{const o=r-t;if(o<=0)return Buffer.alloc(0);const n=Buffer.alloc(o),{bytesRead:a}=await e.read(n,0,o,t);return n.subarray(0,a)},k=async function*(e){if(e!==null){if(typeof e=="string"){yield new TextEncoder().encode(e);return}if(e instanceof ArrayBuffer){yield new Uint8Array(e);return}if(ArrayBuffer.isView(e)){yield new Uint8Array(e.buffer,e.byteOffset,e.byteLength);return}if(e instanceof Blob){yield*k(e.stream());return}if(e instanceof ReadableStream){for await(const t of e)if(t instanceof Uint8Array)yield t;else if(t instanceof ArrayBuffer)yield new Uint8Array(t);else throw new f("VALIDATION_ERROR","@lunora/platform-node: R2 put stream must yield byte chunks");return}throw new f("VALIDATION_ERROR","@lunora/platform-node: unsupported R2 put body")}},z=(e,t)=>e<t?-1:+(e>t),G=async e=>{let t;try{t=await Q(e,{withFileTypes:!0})}catch(o){if(_(o)||o instanceof Error&&"code"in o&&o.code==="ENOTDIR")return[];throw o}const r=[];for(const o of t){const n=o.name===v?void 0:ot(o.name);if(n!==void 0){const a=o.isDirectory();r.push({isDirectory:a,name:o.name,sortKey:a?`${n}/`:n})}}return r.toSorted((o,n)=>z(o.sortKey,n.sortKey))},X=async e=>{for(const t of await G(e))if(!t.isDirectory||await X(y(e,t.name)))return!0;return!1},mt=(e,t,r)=>{if(r===void 0||!e.startsWith(t))return;const o=e.slice(t.length).indexOf(r);return o===-1?void 0:e.slice(0,t.length+o+r.length)},yt=async(e,{after:t,delimiter:r,limit:o,prefix:n})=>{const a=[],i=new Set,c=n.split("/").slice(0,-1);if(c.some(s=>s===""||s==="."||s===".."||s===v||s.includes("\\")))return{keys:a,prefixes:i};const R=s=>(s.startsWith(n)||n.startsWith(s))&&(r!==void 0||t===void 0||s>t||t.startsWith(s)),w=()=>r===void 0&&a.length>o,h=s=>s.startsWith(n)&&a.length<=o&&(t===void 0||s>t),m=async(s,l)=>{for(const u of await G(s)){const p=l+u.sortKey;if(w())return;const I=mt(p,n,r);u.isDirectory&&I!==void 0?await X(y(s,u.name))&&i.add(I):u.isDirectory?R(p)&&await m(y(s,u.name),p):I!==void 0?i.add(I):h(p)&&a.push(p)}};let d=e;for(const s of c){d=y(d,b(s));let l;try{l=await q(d)}catch(u){const p=u instanceof Error&&"code"in u?u.code:void 0;if(p==="ENOENT"||p==="ENOTDIR"||p==="ENAMETOOLONG")return{keys:a,prefixes:i};throw u}if(!l.isDirectory())return{keys:a,prefixes:i}}return await m(c.length===0?e:y(e,...c.map(s=>b(s))),c.length===0?"":`${c.join("/")}/`),{keys:a,prefixes:i}},Rt=new Set(["EISDIR","ENOENT","ENOTDIR","EPERM"]),T=async e=>{try{await Z(e)}catch(t){const r=t instanceof Error&&"code"in t?t.code:void 0;if(r===void 0||!Rt.has(r))throw t}},pt=async(e,t)=>{let r=e;for(;r!==t&&r.startsWith(`${t}${tt}`);){try{await K(r)}catch(o){if(!_(o))return}r=D(r)}},U=async(e,t,r)=>{try{await x(e,t)}catch{try{await K(t)}catch{}try{await L(D(t),{recursive:!0}),await x(e,t)}catch(o){throw await T(e),W(r,o)}}},O=new Map,gt=async(e,t)=>{const o=(O.get(e)??Promise.resolve()).then(t,t),n=o.catch(()=>{});O.set(e,n);try{return await o}finally{O.get(e)===n&&O.delete(e)}},Et=async(e,t)=>{const o=(await M(e))?.meta.sha256Hex,n=a=>o!==void 0&&(a==="*"||a===o);return t.etagMatches!==void 0&&!n(t.etagMatches)?!1:t.etagDoesNotMatch===void 0||!n(t.etagDoesNotMatch)},Tt=e=>{const{directory:t}=e;return{delete:async r=>{const o=typeof r=="string"?[r]:r;for(const n of o)N(n);for(const n of o){const a=y(t,E(n));await T(a),await pt(a,t)}},get:async(r,o)=>{N(r);const n=await P(y(t,E(r)));if(n===void 0)return null;const{bodySize:a,handle:i,meta:c}=n,{end:R,start:w}=ut(a,o?.range),h={};let m=!1;const d=async()=>{m||(m=!0,V.unregister(h),await i.close())},s=()=>{if(m)throw new f("BAD_REQUEST",`@lunora/platform-node: R2 object "${r}" body has already been consumed`)},l=async()=>{s();try{return await wt(i,w,R)}finally{await d()}},u={...A(r,c),arrayBuffer:async()=>H(await l()),get body(){return s(),R<=w?(d().catch(()=>{}),new Blob([]).stream()):ht(i,w,R,d)},text:async()=>(await l()).toString("utf8")};return V.register(u,{close:d},h),u},head:async r=>{N(r);const o=await M(y(t,E(r)));return o===void 0?null:A(r,o.meta)},list:async(r={})=>{const o=Math.max(1,S(r.limit,1e3,1e3));if(r.prefix?.includes("\0"))throw new f("VALIDATION_ERROR","@lunora/platform-node: R2 list prefix contains a NUL byte");const n=r.prefix??"",{delimiter:a}=r;let i=r.cursor;r.startAfter!==void 0&&(i===void 0||r.startAfter>i)&&(i=r.startAfter);const{keys:c,prefixes:R}=await yt(t,{after:i,delimiter:a,limit:o,prefix:n}),w=c.slice(0,o),h=c.length>o,m=a===void 0?void 0:[...R].toSorted(z),s=(await Promise.all(w.map(async l=>{const u=await M(y(t,E(l)));return u===void 0?void 0:A(l,u.meta)}))).filter(l=>l!==void 0);return{cursor:h?w.at(-1):void 0,delimitedPrefixes:m,objects:s,truncated:h}},put:(async(r,o,n)=>{N(r),st(n?.customMetadata);const a=n?.sha256===void 0?void 0:ct(n.sha256),i=y(t,E(r)),c=y(t,v,Y());try{await L(D(i),{recursive:!0})}catch(d){throw W(r,d)}await L(D(c),{recursive:!0});const R=J("sha256");let w=0,h;try{const d=await j(c,"w");try{for await(const l of k(o))R.update(l),w+=l.byteLength,await d.write(l);const s=R.digest("hex");if(a!==void 0&&a!==s)throw new f("VALIDATION_ERROR",`@lunora/platform-node: the SHA-256 checksum you specified for R2 key "${r}" did not match what we received. You provided a SHA-256 checksum with value: ${a}. Actual SHA-256 was: ${s}`);h={customMetadata:n?.customMetadata,httpMetadata:n?.httpMetadata,sha256Hex:s,size:w,uploaded:new Date().toISOString()},await d.write(ft(h))}finally{await d.close()}}catch(d){throw await T(c),d}const m=n?.onlyIf;return m!==void 0?gt(r,async()=>await Et(i,m)?(await U(c,i,r),A(r,h)):(await T(c),null)):(await U(c,i,r),A(r,h))})}};export{Tt as createNodeR2Bucket};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lunora/platform-node",
3
- "version": "1.0.0-alpha.139",
3
+ "version": "1.0.0-alpha.140",
4
4
  "description": "Node implementation of the Lunora platform contracts: ShardHost, SocketHost, ShardDirectory, ShardKvStore, SchedulerHost over better-sqlite3 and an in-process socket registry (dev/test target)",
5
5
  "keywords": [
6
6
  "better-sqlite3",
@@ -1 +0,0 @@
1
- import{randomUUID as W,createHash as X}from"node:crypto";import{mkdir as L,open as j,unlink as Y,rename as _,rmdir as H,readdir as J}from"node:fs/promises";import{join as y,dirname as T,sep as Z}from"node:path";import{LunoraError as c}from"@lunora/errors";import{h as q}from"./hmac-url-BrwGfbCr.mjs";import{t as P}from"./to-array-buffer-DVyXU4Ep.mjs";const b=".lunora-tmp",k="LNR1",p=8,B=1024,$=255,V=2048,Q=/[%A-Z:]/g,F=e=>{const t=e.replaceAll(Q,n=>`%${n.codePointAt(0)?.toString(16).padStart(2,"0").toUpperCase()??""}`),r=t.at(-1);return r==="."||r===" "?`${t.slice(0,-1)}%${r.codePointAt(0)?.toString(16).padStart(2,"0").toUpperCase()??""}`:t},tt=e=>{try{return decodeURIComponent(e)}catch{return}},A=e=>e.split("/").map(t=>F(t)).join("/"),et=e=>{const t=[];for(const r of e.split("/")){const n=tt(r);if(n===void 0)return;t.push(n)}return t.join("/")},rt=new TextEncoder,nt=e=>rt.encode(e).length,I=e=>{if(typeof e!="string"||e.length===0)throw new c("VALIDATION_ERROR","@lunora/platform-node: R2 key must be a non-empty string");if(nt(e)>B)throw new c("VALIDATION_ERROR",`@lunora/platform-node: R2 key exceeds ${String(B)}-byte limit`);if(e.includes("\0"))throw new c("VALIDATION_ERROR","@lunora/platform-node: R2 key contains a NUL byte");if(q(e))throw new c("VALIDATION_ERROR","@lunora/platform-node: R2 key contains a control character (including CR/LF)");if(e.includes("\\"))throw new c("VALIDATION_ERROR","@lunora/platform-node: R2 key contains a backslash (a path separator on Windows)");if(e.startsWith("/"))throw new c("VALIDATION_ERROR","@lunora/platform-node: R2 key must not start with `/`");for(const t of e.split("/")){if(Buffer.byteLength(F(t),"utf8")>$)throw new c("VALIDATION_ERROR",`@lunora/platform-node: R2 key segment "${t}" exceeds ${String($)} bytes once escaped for the filesystem`);if(t===""||t==="."||t==="..")throw new c("VALIDATION_ERROR",`@lunora/platform-node: R2 key has an empty, \`.\` or \`..\` path segment ("${e}")`);if(t===b)throw new c("VALIDATION_ERROR",`@lunora/platform-node: R2 key is reserved (no segment may be "${b}")`)}},ot=e=>{if(e===void 0)return;let t=0;for(const[r,n]of Object.entries(e))t+=Buffer.byteLength(r,"utf8")+Buffer.byteLength(n,"utf8");if(t>V)throw new c("VALIDATION_ERROR",`@lunora/platform-node: R2 customMetadata is ${String(t)} bytes, over the ${String(V)}-byte ceiling R2 applies to the summed keys and values — your metadata headers exceed the maximum allowed metadata size`)},at=/^[\da-f]{64}$/,st=e=>{if(typeof e=="string"){const t=e.toLowerCase();if(!at.test(t))throw new c("VALIDATION_ERROR","@lunora/platform-node: R2 put sha256 must be 64 hex characters or a 32-byte buffer");return t}if(e.byteLength!==32)throw new c("VALIDATION_ERROR","@lunora/platform-node: R2 put sha256 must be 64 hex characters or a 32-byte buffer");return Buffer.from(e).toString("hex")},D=e=>e instanceof Error&&"code"in e&&e.code==="ENOENT",K=(e,t)=>{const r=t instanceof Error&&"code"in t?t.code:void 0;return r==="EEXIST"||r==="EISDIR"||r==="ENOTDIR"?new c("VALIDATION_ERROR",`@lunora/platform-node: R2 key "${e}" collides with an existing object at one of its path prefixes — this host stores one file per key, so a key and a prefix of it cannot both hold objects`):t},it=e=>{const t=Buffer.from(JSON.stringify(e),"utf8"),r=Buffer.alloc(p);return r.writeUInt32BE(t.byteLength,0),r.write(k,4,"ascii"),Buffer.concat([t,r])},ct=e=>{if(typeof e!="object"||e===null)return!1;const t=e;return typeof t.sha256Hex=="string"&&typeof t.size=="number"&&typeof t.uploaded=="string"},ft=async e=>{const t=await e.stat();if(!t.isFile()||t.size<p)return;const r=Buffer.alloc(p);if(await e.read(r,0,p,t.size-p),r.toString("ascii",4,p)!==k)return;const n=r.readUInt32BE(0),o=t.size-p-n;if(n===0||o<0)return;const a=Buffer.alloc(n),{bytesRead:i}=await e.read(a,0,n,o);if(i!==n)return;let s;try{s=JSON.parse(a.toString("utf8"))}catch{return}return ct(s)?{bodySize:o,meta:s}:void 0},z=async e=>{let t;try{t=await j(e,"r")}catch(r){if(D(r))return;throw r}try{const r=await ft(t);if(r===void 0){await t.close();return}return{...r,handle:t}}catch(r){throw await t.close(),r}},C=new FinalizationRegistry(e=>{e.close().catch(()=>{})}),x=async e=>{const t=await z(e);if(t!==void 0)return await t.handle.close(),{bodySize:t.bodySize,meta:t.meta}},E=(e,t)=>{const{sha256Hex:r}=t,n=Buffer.from(r,"hex");return{checksums:{sha256:P(n)},customMetadata:t.customMetadata,etag:r,httpEtag:`"${r}"`,httpMetadata:t.httpMetadata,key:e,sha256:r,sha256Base64:n.toString("base64"),size:t.size,uploaded:new Date(t.uploaded)}},S=(e,t,r)=>e===void 0||!Number.isFinite(e)?t:Math.min(Math.max(0,Math.floor(e)),r),lt=(e,t)=>{if(t===void 0)return{end:e,start:0};if("suffix"in t)return{end:e,start:e-S(t.suffix,e,e)};const r=S(t.offset,0,e);return{end:t.length===void 0||!Number.isFinite(t.length)?e:Math.min(r+S(t.length,0,e),e),start:r}},dt=(e,t,r,n)=>{const o=e.createReadStream({autoClose:!1,end:r-1,start:t})[Symbol.asyncIterator]();return new ReadableStream({cancel:async()=>{await o.return?.(),await n()},pull:async a=>{let i;try{i=await o.next()}catch(s){throw await n(),s}i.done===!0?(a.close(),await n()):a.enqueue(i.value)}})},ut=async(e,t,r)=>{const n=r-t;if(n<=0)return Buffer.alloc(0);const o=Buffer.alloc(n),{bytesRead:a}=await e.read(o,0,n,t);return o.subarray(0,a)},G=async function*(e){if(e!==null){if(typeof e=="string"){yield new TextEncoder().encode(e);return}if(e instanceof ArrayBuffer){yield new Uint8Array(e);return}if(ArrayBuffer.isView(e)){yield new Uint8Array(e.buffer,e.byteOffset,e.byteLength);return}if(e instanceof Blob){yield*G(e.stream());return}if(e instanceof ReadableStream){for await(const t of e)if(t instanceof Uint8Array)yield t;else if(t instanceof ArrayBuffer)yield new Uint8Array(t);else throw new c("VALIDATION_ERROR","@lunora/platform-node: R2 put stream must yield byte chunks");return}throw new c("VALIDATION_ERROR","@lunora/platform-node: unsupported R2 put body")}},ht=async e=>{const t=[],r=async(n,o)=>{let a;try{a=await J(n,{withFileTypes:!0})}catch(s){if(D(s))return;throw s}const i=[];for(const s of a){if(s.name===b)continue;const d=o===""?s.name:`${o}/${s.name}`;if(s.isDirectory())i.push(r(y(n,s.name),d));else{const h=et(d);h!==void 0&&t.push(h)}}await Promise.all(i)};return await r(e,""),t.sort((n,o)=>n<o?-1:+(n>o)),t},wt=(e,t)=>{let r=0,n=e.length;for(;r<n;){const o=r+Math.floor((n-r)/2),a=e[o];a===void 0||a<=t?r=o+1:n=o}return r},mt=new Set(["EISDIR","ENOENT","ENOTDIR","EPERM"]),O=async e=>{try{await Y(e)}catch(t){const r=t instanceof Error&&"code"in t?t.code:void 0;if(r===void 0||!mt.has(r))throw t}},Rt=async(e,t)=>{let r=e;for(;r!==t&&r.startsWith(`${t}${Z}`);){try{await H(r)}catch(n){if(!D(n))return}r=T(r)}},U=async(e,t,r)=>{try{await _(e,t)}catch{try{await H(t)}catch{}try{await L(T(t),{recursive:!0}),await _(e,t)}catch(n){throw await O(e),K(r,n)}}},N=new Map,yt=async(e,t)=>{const n=(N.get(e)??Promise.resolve()).then(t,t),o=n.catch(()=>{});N.set(e,o);try{return await n}finally{N.get(e)===o&&N.delete(e)}},pt=async(e,t)=>{const n=(await x(e))?.meta.sha256Hex,o=a=>n!==void 0&&(a==="*"||a===n);return t.etagMatches!==void 0&&!o(t.etagMatches)?!1:t.etagDoesNotMatch===void 0||!o(t.etagDoesNotMatch)},St=e=>{const{directory:t}=e;return{delete:async r=>{const n=typeof r=="string"?[r]:r;for(const o of n)I(o);for(const o of n){const a=y(t,A(o));await O(a),await Rt(a,t)}},get:async(r,n)=>{I(r);const o=await z(y(t,A(r)));if(o===void 0)return null;const{bodySize:a,handle:i,meta:s}=o,{end:d,start:h}=lt(a,n?.range),u={};let w=!1;const l=async()=>{w||(w=!0,C.unregister(u),await i.close())},m=()=>{if(w)throw new c("BAD_REQUEST",`@lunora/platform-node: R2 object "${r}" body has already been consumed`)},R=async()=>{m();try{return await ut(i,h,d)}finally{await l()}},v={...E(r,s),arrayBuffer:async()=>P(await R()),get body(){return m(),d<=h?(l().catch(()=>{}),new Blob([]).stream()):dt(i,h,d,l)},text:async()=>(await R()).toString("utf8")};return C.register(v,{close:l},u),v},head:async r=>{I(r);const n=await x(y(t,A(r)));return n===void 0?null:E(r,n.meta)},list:async(r={})=>{const n=Math.max(1,S(r.limit,1e3,1e3));if(r.prefix?.includes("\0"))throw new c("VALIDATION_ERROR","@lunora/platform-node: R2 list prefix contains a NUL byte");const o=await ht(t),a=r.prefix??"",i=o.filter(f=>f.startsWith(a)),{delimiter:s}=r,d=s===void 0?i:i.filter(f=>!f.slice(a.length).includes(s)),h=s===void 0?void 0:[...new Set(i.map(f=>{const M=f.slice(a.length).indexOf(s);return M===-1?void 0:f.slice(0,a.length+M+s.length)}).filter(f=>f!==void 0))].toSorted((f,g)=>f<g?-1:+(f>g));let u=r.cursor;r.startAfter!==void 0&&(u===void 0||r.startAfter>u)&&(u=r.startAfter);const w=u===void 0?0:wt(d,u),l=d.slice(w,w+n),m=w+n<d.length,v=(await Promise.all(l.map(async f=>{const g=await x(y(t,A(f)));return g===void 0?void 0:E(f,g.meta)}))).filter(f=>f!==void 0);return{cursor:m?l.at(-1):void 0,delimitedPrefixes:h,objects:v,truncated:m}},put:(async(r,n,o)=>{I(r),ot(o?.customMetadata);const a=o?.sha256===void 0?void 0:st(o.sha256),i=y(t,A(r)),s=y(t,b,W());try{await L(T(i),{recursive:!0})}catch(l){throw K(r,l)}await L(T(s),{recursive:!0});const d=X("sha256");let h=0,u;try{const l=await j(s,"w");try{for await(const R of G(n))d.update(R),h+=R.byteLength,await l.write(R);const m=d.digest("hex");if(a!==void 0&&a!==m)throw new c("VALIDATION_ERROR",`@lunora/platform-node: the SHA-256 checksum you specified for R2 key "${r}" did not match what we received. You provided a SHA-256 checksum with value: ${a}. Actual SHA-256 was: ${m}`);u={customMetadata:o?.customMetadata,httpMetadata:o?.httpMetadata,sha256Hex:m,size:h,uploaded:new Date().toISOString()},await l.write(it(u))}finally{await l.close()}}catch(l){throw await O(s),l}const w=o?.onlyIf;return w!==void 0?yt(r,async()=>await pt(i,w)?(await U(s,i,r),E(r,u)):(await O(s),null)):(await U(s,i,r),E(r,u))})}};export{St as createNodeR2Bucket};