buckyos 0.7.128 → 0.7.131

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/nfsp.cjs CHANGED
@@ -1,2 +1,2 @@
1
- "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="nfsp/0",t=e=>"string"==typeof e?e.includes("://")?{uri:e}:{realm:"dfs",path:e}:"type"in e?{ref:e}:e;class s extends Error{constructor(e,t){super(`${e.code}: ${e.message}`),this.name="NfspError",this.code=e.code,this.httpStatus=t,this.details=Object.fromEntries(Object.entries(e).filter((([e])=>"code"!==e&&"message"!==e)))}}const a=e=>{const t={};for(const[s,a]of Object.entries(e))void 0!==a&&(t[s]=a);return t};exports.NFSP_VERSION=e,exports.NfspClient=class{constructor(e){this.session=null,this.seq=0,this.helloResult=null,this.sessionToken=e.sessionToken,this.baseUrl=e.baseUrl.replace(/\/+$/,""),this.fetchFn=e.fetch??((e,t)=>globalThis.fetch(e,t)),this.chunkSize=e.uploadChunkSize??8388608}get sessionId(){return this.session}get features(){var e;return(null==(e=this.helloResult)?void 0:e.features)??[]}get limits(){var e;return(null==(e=this.helloResult)?void 0:e.limits)??null}async hello(t){const s={versions:[e]};t&&(s.features=t);const a=await this.post("hello",{args:s});return this.session=a.session,this.seq=0,this.helloResult=a,a}async bye(){await this.call("bye",{}),this.session=null,this.helloResult=null}async resolve(e,s){return await this.call("resolve",{at:t(e),want:s})}async stat(e,s){return await this.call("stat",{at:t(e),want:null==s?void 0:s.want,args:(null==s?void 0:s.name)?{name:s.name}:{}})}async list(e,s,a){return await this.call("list",{at:t(e),want:a,args:s??{}})}async batch(e,s,a="abort"){return await this.call("batch",{args:{start:t(e),ops:s,on_error:a}})}async mkdir(e,s,a){const n={};return void 0!==s&&(n.name=s),(null==a?void 0:a.expectedRevision)&&(n.expected_revision=a.expectedRevision),await this.write("mkdir",{at:t(e),args:n})}async move(e,t,s){return await this.write("move",{args:{from:{parent_ref:e.parentRef,name:e.name},to:{parent_ref:t.parentRef,name:t.name},expected_from_revision:null==s?void 0:s.expectedFromRevision,expected_to_revision:null==s?void 0:s.expectedToRevision}})}async delete(e,s,a){return await this.write("delete",{at:t(e),args:{name:s,recursive:null==a?void 0:a.recursive,expected_revision:null==a?void 0:a.expectedRevision}})}async bindRef(e,t,s,a){return await this.write("bind_ref",{args:{parent_ref:e,name:t,target_ref:s,expected_revision:null==a?void 0:a.expectedRevision}})}async unlink(e,t){return await this.write("unlink",{args:{entry_ref:e,expected_revision:null==t?void 0:t.expectedRevision}})}async openWrite(e){const t="ref"in e?{ref:e.ref}:{parent_ref:e.parentRef,name:e.name,size:e.size};return await this.write("open_write",{args:t})}async uploadOffset(e){const t=await this.fetchFn(`${this.baseUrl}/nfs/v1/uploads/${e}`,{method:"HEAD",headers:await this.authHeaders()});if(!t.ok)throw await this.httpError(t);return Number(t.headers.get("Upload-Offset")??"0")}async uploadChunk(e,t,s){const a=await this.fetchFn(`${this.baseUrl}/nfs/v1/uploads/${e}`,{method:"PATCH",headers:{...await this.authHeaders(),"Upload-Offset":String(t),"Content-Type":"application/offset+octet-stream"},body:s});if(204!==a.status)throw await this.httpError(a);return Number(a.headers.get("Upload-Offset")??String(t+s.byteLength))}async uploadContent(e,t,s){let a=await this.uploadOffset(e);for(;a<t.byteLength;){const n=t.subarray(a,Math.min(a+this.chunkSize,t.byteLength));a=await this.uploadChunk(e,a,n),null==s||s(a,t.byteLength)}}async abortWrite(e){await this.write("abort_write",{args:{lease_id:e}})}async authHeaders(){var e;const t=await(null==(e=this.sessionToken)?void 0:e.call(this));return t?{Authorization:`Bearer ${t}`}:{}}async commitFile(e,s,a,n){const r={name:s,overwrite:null==n?void 0:n.overwrite,expected_revision:null==n?void 0:n.expectedRevision};return"fbHandle"in a?(r.fb_handle=a.fbHandle,a.leaseId&&(r.lease_id=a.leaseId)):r.hash=a.hash,await this.write("commit_file",{at:t(e),args:r})}async probe(e){return await this.call("probe",{args:{digests:e}})}async uploadFile(e,t,s,a){const n=await this.openWrite({parentRef:e,name:t,size:s.byteLength});return await this.uploadContent(n.fb_handle,s,null==a?void 0:a.onProgress),this.commitFile({ref:e},t,{fbHandle:n.fb_handle,leaseId:n.lease.lease_id},{overwrite:null==a?void 0:a.overwrite})}readUrl(e,t){const s=new URLSearchParams;(null==t?void 0:t.download)&&s.set("download","1"),(null==t?void 0:t.name)&&s.set("name",t.name);const a=s.size>0?`?${s.toString()}`:"";return`${this.baseUrl}/nfs/v1/read/${encodeURIComponent(e)}${a}`}async readFile(e,t){const s=await this.authHeaders();(null==t?void 0:t.range)&&(s.Range=`bytes=${t.range.start}-${t.range.end??""}`),(null==t?void 0:t.ifNoneMatch)&&(s["If-None-Match"]=t.ifNoneMatch);const a=await this.fetchFn(this.readUrl(e),{headers:s,cache:"no-store"});if(!a.ok&&304!==a.status)throw await this.httpError(a);return a}async getMeta(e,s){const a=t(e),n={ns:s};return a.ref&&(n.ref=a.ref),await this.call("get_meta",{at:a,args:n})}async setMeta(e,s){const a=t(e),n={records:s};return a.ref&&(n.ref=a.ref),await this.write("set_meta",{at:a,args:n})}async search(e,s,a){return await this.call("search",{want:a,args:{q:e,limit:null==s?void 0:s.limit,cursor:null==s?void 0:s.cursor,scope:void 0!==(null==s?void 0:s.scope)?t(s.scope):void 0,modes:null==s?void 0:s.modes}})}async openView(e,t){return await this.call("open_view",{want:t,args:{view_id:e}})}async createCollection(e,t,s){return await this.write("create_collection",{want:s,args:{title:e,collection_id:t}})}async openCollection(e,t){return await this.call("open_collection",{want:t,args:{collection_id:e}})}async collectionPatch(e,t,s){return await this.write("collection_patch",{args:{ref:e,ops:t,expected_revision:null==s?void 0:s.expectedRevision}})}async grant(e,s){return await this.write("grant",{args:{subtree:t(e),ops:null==s?void 0:s.ops,ttl:null==s?void 0:s.ttl,audience:null==s?void 0:s.audience,max_uses:null==s?void 0:s.maxUses}})}async revoke(e){return await this.write("revoke",{args:{cap_id:e}})}watch(e){var t;if(!this.session)throw new Error("watch requires an active session; call hello() first");const s=new URLSearchParams({session:this.session});(null==(t=null==e?void 0:e.tokens)?void 0:t.length)&&s.set("tokens",e.tokens.join(","));const a=`${this.baseUrl}/nfs/v1/watch?${s.toString()}`,n=new AbortController;(null==e?void 0:e.signal)&&e.signal.addEventListener("abort",(()=>n.abort()),{once:!0});const r=this.fetchFn,i=()=>this.authHeaders();const o=async function*(){const e=await r(a,{headers:{...await i(),Accept:"text/event-stream"},signal:n.signal});if(!e.ok||!e.body)throw new Error(`watch failed: HTTP ${e.status}`);const t=e.body.getReader(),s=new TextDecoder;let o="";try{for(;;){const{done:e,value:a}=await t.read();if(e)return;for(o+=s.decode(a,{stream:!0});;){const e=o.indexOf("\n\n");if(e<0)break;const t=o.slice(0,e);o=o.slice(e+2);let s,a="message";const n=[];for(const i of t.split("\n"))i.startsWith("event:")?a=i.slice(6).trim():i.startsWith("data:")?n.push(i.slice(5).trim()):i.startsWith("id:")&&(s=i.slice(3).trim());if(0===n.length&&"message"===a)continue;let r={};if(n.length>0)try{r=JSON.parse(n.join("\n"))}catch{r={raw:n.join("\n")}}yield{event:a,data:r,id:s}}}}finally{t.cancel().catch((()=>{}))}}();return o.close=()=>n.abort(),o}async call(e,t){return this.post(e,this.envelope(t))}async write(e,t,a=2){const n=++this.seq,r={...this.envelope(t),seq:n};let i;for(let l=0;l<=a;l++)try{return await this.post(e,r)}catch(o){if(o instanceof s)throw o;i=o}throw i}envelope(e){const t={args:a(e.args??{})};return this.session&&(t.session=this.session),e.at&&(t.at=a(e.at)),e.want&&(t.want=e.want),t}async post(e,t){var a;const n=await(null==(a=this.sessionToken)?void 0:a.call(this)),r=await this.fetchFn(`${this.baseUrl}/nfs/v1/${e}`,{method:"POST",headers:{"Content-Type":"application/json",...n?{Authorization:`Bearer ${n}`}:{}},body:JSON.stringify(t)});let i;try{i=await r.json()}catch{throw new s({code:"INTERNAL",message:`non-JSON response (HTTP ${r.status})`},r.status)}if(!0!==i.ok)throw new s(i.error??{code:"INTERNAL",message:"malformed error envelope"},r.status);return i.result}async httpError(e){try{const t=await e.json();if(t.error)return new s(t.error,e.status)}catch{}return new s({code:"INTERNAL",message:`HTTP ${e.status}`},e.status)}},exports.NfspError=s,exports.liveRef=(e,t=0)=>({type:"live",node_id:e,gen:t}),exports.toLocator=t;
1
+ "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="nfsp/0",t=e=>"string"==typeof e?e.includes("://")?{uri:e}:{realm:"dfs",path:e}:"type"in e?{ref:e}:e;class s extends Error{constructor(e,t){super(`${e.code}: ${e.message}`),this.name="NfspError",this.code=e.code,this.httpStatus=t,this.details=Object.fromEntries(Object.entries(e).filter((([e])=>"code"!==e&&"message"!==e)))}}const a=e=>{const t={};for(const[s,a]of Object.entries(e))void 0!==a&&(t[s]=a);return t};exports.NFSP_VERSION=e,exports.NfspClient=class{constructor(e){this.session=null,this.seq=0,this.helloResult=null,this.sessionToken=e.sessionToken,this.baseUrl=e.baseUrl.replace(/\/+$/,""),this.fetchFn=e.fetch??((e,t)=>globalThis.fetch(e,t)),this.chunkSize=e.uploadChunkSize??8388608}get sessionId(){return this.session}get features(){var e;return(null==(e=this.helloResult)?void 0:e.features)??[]}get limits(){var e;return(null==(e=this.helloResult)?void 0:e.limits)??null}async hello(t){const s={versions:[e]};t&&(s.features=t);const a=await this.post("hello",{args:s});return this.session=a.session,this.seq=0,this.helloResult=a,a}async bye(){await this.call("bye",{}),this.session=null,this.helloResult=null}async resolve(e,s){return await this.call("resolve",{at:t(e),want:s})}async stat(e,s){return await this.call("stat",{at:t(e),want:null==s?void 0:s.want,args:(null==s?void 0:s.name)?{name:s.name}:{}})}async list(e,s,a){return await this.call("list",{at:t(e),want:a,args:s??{}})}async batch(e,s,a="abort"){return await this.call("batch",{args:{start:t(e),ops:s,on_error:a}})}async mkdir(e,s,a){const n={};return void 0!==s&&(n.name=s),(null==a?void 0:a.expectedRevision)&&(n.expected_revision=a.expectedRevision),await this.write("mkdir",{at:t(e),args:n})}async move(e,t,s){return await this.write("move",{args:{from:{parent_ref:e.parentRef,name:e.name},to:{parent_ref:t.parentRef,name:t.name},expected_from_revision:null==s?void 0:s.expectedFromRevision,expected_to_revision:null==s?void 0:s.expectedToRevision}})}async delete(e,s,a){return await this.write("delete",{at:t(e),args:{name:s,recursive:null==a?void 0:a.recursive,expected_revision:null==a?void 0:a.expectedRevision}})}async bindRef(e,t,s,a){return await this.write("bind_ref",{args:{parent_ref:e,name:t,target_ref:s,expected_revision:null==a?void 0:a.expectedRevision}})}async unlink(e,t){return await this.write("unlink",{args:{entry_ref:e,expected_revision:null==t?void 0:t.expectedRevision}})}async openWrite(e){const t="ref"in e?{ref:e.ref}:{parent_ref:e.parentRef,name:e.name,size:e.size};return await this.write("open_write",{args:t})}async uploadOffset(e){const t=await this.fetchFn(`${this.baseUrl}/nfs/v1/uploads/${e}`,{method:"HEAD",headers:await this.authHeaders()});if(!t.ok)throw await this.httpError(t);return Number(t.headers.get("Upload-Offset")??"0")}async uploadChunk(e,t,s){const a=await this.fetchFn(`${this.baseUrl}/nfs/v1/uploads/${e}`,{method:"PATCH",headers:{...await this.authHeaders(),"Upload-Offset":String(t),"Content-Type":"application/offset+octet-stream"},body:s});if(204!==a.status)throw await this.httpError(a);return Number(a.headers.get("Upload-Offset")??String(t+s.byteLength))}async uploadContent(e,t,s){let a=await this.uploadOffset(e);for(;a<t.byteLength;){const n=t.subarray(a,Math.min(a+this.chunkSize,t.byteLength));a=await this.uploadChunk(e,a,n),null==s||s(a,t.byteLength)}}async abortWrite(e){await this.write("abort_write",{args:{lease_id:e}})}async authHeaders(){var e;const t=await(null==(e=this.sessionToken)?void 0:e.call(this));return t?{Authorization:`Bearer ${t}`}:{}}async commitFile(e,s,a,n){const i={name:s,overwrite:null==n?void 0:n.overwrite,expected_revision:null==n?void 0:n.expectedRevision};return"fbHandle"in a?(i.fb_handle=a.fbHandle,a.leaseId&&(i.lease_id=a.leaseId)):i.hash=a.hash,await this.write("commit_file",{at:t(e),args:i})}async probe(e){return await this.call("probe",{args:{digests:e}})}async uploadFile(e,t,s,a){const n=await this.openWrite({parentRef:e,name:t,size:s.byteLength});return await this.uploadContent(n.fb_handle,s,null==a?void 0:a.onProgress),this.commitFile({ref:e},t,{fbHandle:n.fb_handle,leaseId:n.lease.lease_id},{overwrite:null==a?void 0:a.overwrite})}readUrl(e,t){const s=new URLSearchParams;(null==t?void 0:t.download)&&s.set("download","1"),(null==t?void 0:t.name)&&s.set("name",t.name);const a=s.size>0?`?${s.toString()}`:"";return`${this.baseUrl}/nfs/v1/read/${encodeURIComponent(e)}${a}`}async readFile(e,t){const s=await this.authHeaders();(null==t?void 0:t.range)&&(s.Range=`bytes=${t.range.start}-${t.range.end??""}`),(null==t?void 0:t.ifNoneMatch)&&(s["If-None-Match"]=t.ifNoneMatch);const a=await this.fetchFn(this.readUrl(e),{headers:s,cache:"no-store"});if(!a.ok&&304!==a.status)throw await this.httpError(a);return a}async getMeta(e,s){const a=t(e),n={ns:s};return a.ref&&(n.ref=a.ref),await this.call("get_meta",{at:a,args:n})}async setMeta(e,s){const a=t(e),n={records:s};return a.ref&&(n.ref=a.ref),await this.write("set_meta",{at:a,args:n})}async search(e,s,a){return await this.call("search",{want:a,args:{q:e,limit:null==s?void 0:s.limit,cursor:null==s?void 0:s.cursor,scope:void 0!==(null==s?void 0:s.scope)?t(s.scope):void 0,modes:null==s?void 0:s.modes}})}async openView(e,t){return await this.call("open_view",{want:t,args:{view_id:e}})}async createCollection(e,t,s){return await this.write("create_collection",{want:s,args:{title:e,collection_id:t}})}async openCollection(e,t){return await this.call("open_collection",{want:t,args:{collection_id:e}})}async collectionPatch(e,t,s){return await this.write("collection_patch",{args:{ref:e,ops:t,expected_revision:null==s?void 0:s.expectedRevision}})}async grant(e,s){return await this.write("grant",{args:{subtree:t(e),ops:null==s?void 0:s.ops,ttl:null==s?void 0:s.ttl,audience:null==s?void 0:s.audience,max_uses:null==s?void 0:s.maxUses}})}async revoke(e){return await this.write("revoke",{args:{cap_id:e}})}async getAcl(e){return await this.call("get_acl",{at:t(e)})}async setAcl(e,s,a){return await this.write("set_acl",{at:t(e),args:{inherit:s.inherit,entries:s.entries,expected_revision:null==a?void 0:a.expectedRevision}})}async listAcls(){return await this.call("list_acls",{})}watch(e){var t;if(!this.session)throw new Error("watch requires an active session; call hello() first");const s=new URLSearchParams({session:this.session});(null==(t=null==e?void 0:e.tokens)?void 0:t.length)&&s.set("tokens",e.tokens.join(","));const a=`${this.baseUrl}/nfs/v1/watch?${s.toString()}`,n=new AbortController;(null==e?void 0:e.signal)&&e.signal.addEventListener("abort",(()=>n.abort()),{once:!0});const i=this.fetchFn,r=()=>this.authHeaders();const o=async function*(){const e=await i(a,{headers:{...await r(),Accept:"text/event-stream"},signal:n.signal});if(!e.ok||!e.body)throw new Error(`watch failed: HTTP ${e.status}`);const t=e.body.getReader(),s=new TextDecoder;let o="";try{for(;;){const{done:e,value:a}=await t.read();if(e)return;for(o+=s.decode(a,{stream:!0});;){const e=o.indexOf("\n\n");if(e<0)break;const t=o.slice(0,e);o=o.slice(e+2);let s,a="message";const n=[];for(const r of t.split("\n"))r.startsWith("event:")?a=r.slice(6).trim():r.startsWith("data:")?n.push(r.slice(5).trim()):r.startsWith("id:")&&(s=r.slice(3).trim());if(0===n.length&&"message"===a)continue;let i={};if(n.length>0)try{i=JSON.parse(n.join("\n"))}catch{i={raw:n.join("\n")}}yield{event:a,data:i,id:s}}}}finally{t.cancel().catch((()=>{}))}}();return o.close=()=>n.abort(),o}async call(e,t){return this.post(e,this.envelope(t))}async write(e,t,a=2){const n=++this.seq,i={...this.envelope(t),seq:n};let r;for(let l=0;l<=a;l++)try{return await this.post(e,i)}catch(o){if(o instanceof s)throw o;r=o}throw r}envelope(e){const t={args:a(e.args??{})};return this.session&&(t.session=this.session),e.at&&(t.at=a(e.at)),e.want&&(t.want=e.want),t}async post(e,t){var a;const n=await(null==(a=this.sessionToken)?void 0:a.call(this)),i=await this.fetchFn(`${this.baseUrl}/nfs/v1/${e}`,{method:"POST",headers:{"Content-Type":"application/json",...n?{Authorization:`Bearer ${n}`}:{}},body:JSON.stringify(t)});let r;try{r=await i.json()}catch{throw new s({code:"INTERNAL",message:`non-JSON response (HTTP ${i.status})`},i.status)}if(!0!==r.ok)throw new s(r.error??{code:"INTERNAL",message:"malformed error envelope"},i.status);return r.result}async httpError(e){try{const t=await e.json();if(t.error)return new s(t.error,e.status)}catch{}return new s({code:"INTERNAL",message:`HTTP ${e.status}`},e.status)}},exports.NfspError=s,exports.liveRef=(e,t=0)=>({type:"live",node_id:e,gen:t}),exports.toLocator=t;
2
2
  //# sourceMappingURL=nfsp.cjs.map
package/dist/nfsp.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"nfsp.cjs","sources":["../src/nfsp.ts"],"sourcesContent":["/**\n * NFSP v0 client for nfs_server (buckyos/src/frame/nfs_server).\n *\n * Speaks the control plane (`POST /nfs/v1/{method}`), the data plane\n * (`GET /nfs/v1/read/{node_id}`), the minimal tus upload area\n * (`PATCH|HEAD /nfs/v1/uploads/{fb}`) and the watch SSE stream\n * (`GET /nfs/v1/watch`).\n *\n * Protocol references:\n * - cyfs-ndn/doc/NamedFileSystem_Protocol_v0.md (NFSP v0)\n * - buckyos/product/bucky_file/nfs_server.md\n * - buckyos/src/frame/nfs_server/README.md (v1 降级契约)\n *\n * Client contract highlights (nfs_server README §4.2):\n * - `revision` is an opaque equality token: only compare, never order.\n * - Write ops require `seq` (exactly-once); the client auto-assigns one per\n * write and replays with the SAME seq on network retry.\n * - Leases are advisory versus server-local bypass writers: commit may fail\n * with TARGET_MISMATCH{reason:\"bypass_modified\"} — surface, don't retry.\n * - watch is lossy: any `resync` event means \"re-list what you care about\".\n *\n * Uses only fetch/WHATWG streams, so it runs in the browser and in Node ≥ 18.\n */\n\n// ---------------------------------------------------------------------------\n// Wire types\n// ---------------------------------------------------------------------------\n\nexport const NFSP_VERSION = 'nfsp/0'\n\n/** `{\"type\":\"live\",...}` or `{\"type\":\"object\",...}` (NFSP §3.1.2). */\nexport type LiveRef = { type: 'live'; node_id: string; gen?: number }\nexport type ObjectRef = { type: 'object'; obj_id: string; inner_path?: string }\nexport type WireRef = LiveRef | ObjectRef\n\nexport const liveRef = (nodeId: string, gen = 0): LiveRef => ({\n type: 'live',\n node_id: nodeId,\n gen,\n})\n\n/** The `at` locator: ref > uri > path (NFSP §3.4). */\nexport interface Locator {\n realm?: string\n path?: string\n uri?: string\n ref?: WireRef\n}\n\n/** Sugar: accept a dfs path string, a `xxx://` uri, a WireRef or a Locator. */\nexport type LocatorLike = string | WireRef | Locator\n\nexport const toLocator = (at: LocatorLike): Locator => {\n if (typeof at === 'string') {\n if (at.includes('://')) return { uri: at }\n return { realm: 'dfs', path: at }\n }\n if ('type' in at) return { ref: at }\n return at\n}\n\nexport type WantGroup = 'base' | 'ident' | 'access' | 'meta'\n\nexport type NodeKind = 'dir' | 'file' | 'symlink' | 'view' | 'collection' | 'group'\n\nexport interface Capabilities {\n list: boolean\n read: boolean\n accepts_content: boolean\n accepts_references: boolean\n remove_semantics: 'destroy' | 'unlink' | 'none'\n ordered: boolean\n}\n\n/** resolve/stat result (fields beyond `base` appear per the `want` mask). */\nexport interface NodeInfo {\n kind: NodeKind\n state: string\n ref: WireRef\n copy_ref?: WireRef | null\n capabilities: Capabilities\n revision?: string\n locations?: unknown[]\n // base\n name?: string\n size?: number\n mtime?: number\n ctime?: number\n flags?: string[]\n // ident\n node_id?: string\n gen?: number\n etag?: string\n obj_id?: string\n // access\n access_urls?: { kind: string; url: string }[]\n // meta\n meta_summary?: Record<string, number>\n // view / collection extras\n view_id?: string\n collection_id?: string\n title?: string\n origin?: string\n stale?: boolean\n}\n\nexport type EntryBinding = 'native' | 'reference' | 'member' | 'derived'\n\n/** Compact target of a listing entry (not a full NodeInfo). */\nexport interface EntryTarget {\n ref: WireRef\n copy_ref?: WireRef | null\n kind: NodeKind\n /** Attribute groups per the `want` mask: base → size/mtime/flags, ident → etag/obj_id, access → access_urls. */\n attrs?: {\n size?: number\n mtime?: number\n flags?: string[]\n etag?: string\n obj_id?: string\n access_urls?: { kind: string; url: string }[]\n } & Record<string, unknown>\n /** `stale` when a referenced target no longer resolves. */\n target_state?: string\n}\n\nexport interface Entry {\n name: string\n binding: EntryBinding\n entry_ref?: string\n target: EntryTarget\n canonical_path?: string\n context?: { count?: number; provenance?: Record<string, unknown> } & Record<string, unknown>\n}\n\nexport interface Listing {\n container: NodeInfo\n entries: Entry[]\n truncated?: boolean\n next_cursor?: string\n revision_changed?: boolean\n watch_token?: string\n /** Same-name virtual bindings shadowed by native entries (`native_shadow`). */\n conflicts?: { name: string; reason: string; entry_ref?: string; target?: EntryTarget }[]\n}\n\nexport interface ListOptions {\n cursor?: string\n limit?: number\n order?: 'name' | 'mtime' | 'size' | 'manual'\n filter?: { kind?: NodeKind[]; name_glob?: string }\n}\n\nexport interface HelloResult {\n version: string\n session: string\n features: string[]\n limits: { max_batch: number; max_list: number; replay_window: number; attr_ttl_ms: number }\n realms: { id: string; writable: boolean }[]\n}\n\nexport type BatchOp =\n | { m: 'walk'; args: { name?: string; names?: string[]; entry_ref?: string } }\n | { m: 'stat' | 'resolve'; args?: { name?: string }; want?: WantGroup[] }\n | { m: 'list'; args?: ListOptions; want?: WantGroup[] }\n\nexport interface BatchResult {\n completed: number\n results: ({ ok: true; result: unknown } | { ok: false; error: NfspErrorBody })[]\n}\n\nexport interface OpenWriteResult {\n fb_handle: string\n upload_url: string\n lease: { lease_id: string; seq: number; ttl_ms: number }\n target: { path: string; exists: boolean }\n}\n\nexport interface CommitResult {\n ref: WireRef\n entry_ref: string\n revision: string\n obj: { sha256: string; size: number }\n}\n\nexport interface MetaRecord {\n ns: string\n key: string\n value: unknown\n source?: unknown\n confidence?: number\n anchor?: string\n visibility?: string\n}\n\nexport interface SearchHit {\n copy_ref?: WireRef | null\n match_source: string\n canonical_path: string\n explain?: Record<string, unknown>\n [k: string]: unknown\n}\n\nexport interface SearchResult {\n hits: SearchHit[]\n partial: boolean\n sources: { mode: string; state: string; took_ms?: number; reason?: string }[]\n next_cursor?: string\n}\n\nexport interface GrantResult {\n cap_id: string\n token: string\n subtree: string\n ops: string[]\n expires_at?: number\n}\n\nexport type CollectionPatchOp =\n | {\n add_ref: {\n target_ref: WireRef\n name?: string\n position?: number\n parent_entry_ref?: string\n }\n }\n | { remove_entry: { entry_ref: string } }\n | { move_entries: { entry_refs: string[]; to_index: number } }\n | { create_group: { name: string; position?: number } }\n | { rename_group: { entry_ref: string; name: string } }\n\nexport interface WatchEvent {\n /** `resync` | `container_changed` | `meta_changed` (extensible). */\n event: string\n /** Parsed JSON payload of the SSE `data:` line. */\n data: Record<string, unknown>\n /** SSE `id:` (the server_rev), when present. */\n id?: string\n}\n\n// ---------------------------------------------------------------------------\n// Errors\n// ---------------------------------------------------------------------------\n\n/** Structured NFSP error body (§8 plus implementation extensions). */\nexport interface NfspErrorBody {\n code: string\n message: string\n [k: string]: unknown\n}\n\nexport class NfspError extends Error {\n readonly code: string\n readonly httpStatus: number\n /** Extra structured fields (reason, holder_session, obj_id, expected, ...). */\n readonly details: Record<string, unknown>\n\n constructor(body: NfspErrorBody, httpStatus: number) {\n super(`${body.code}: ${body.message}`)\n this.name = 'NfspError'\n this.code = body.code\n this.httpStatus = httpStatus\n this.details = Object.fromEntries(Object.entries(body).filter(([key]) => key !== 'code' && key !== 'message'))\n }\n}\n\n// ---------------------------------------------------------------------------\n// Client\n// ---------------------------------------------------------------------------\n\nexport interface NfspClientOptions {\n sessionToken?: () => Promise<string | null>\n /** e.g. `http://127.0.0.1:3260` — no trailing slash needed. */\n baseUrl: string\n /** Override fetch (tests, custom auth wrappers). Defaults to global fetch. */\n fetch?: typeof fetch\n /** tus PATCH chunk size; server guidance is 4–16 MB. Default 8 MB. */\n uploadChunkSize?: number\n}\n\ninterface EnvelopeExtras {\n at?: Locator\n want?: WantGroup[]\n args?: Record<string, unknown>\n}\n\nexport class NfspClient {\n private readonly sessionToken?: () => Promise<string | null>\n readonly baseUrl: string\n private readonly fetchFn: typeof fetch\n private readonly chunkSize: number\n private session: string | null = null\n private seq = 0\n private helloResult: HelloResult | null = null\n\n constructor(opts: NfspClientOptions) {\n this.sessionToken = opts.sessionToken\n this.baseUrl = opts.baseUrl.replace(/\\/+$/, '')\n // Bind to globalThis: an unbound fetch throws \"Illegal invocation\".\n this.fetchFn = opts.fetch ?? ((input, init) => globalThis.fetch(input, init))\n this.chunkSize = opts.uploadChunkSize ?? 8 * 1024 * 1024\n }\n\n get sessionId(): string | null {\n return this.session\n }\n\n /** Features advertised by the server in hello (empty before hello). */\n get features(): string[] {\n return this.helloResult?.features ?? []\n }\n\n get limits(): HelloResult['limits'] | null {\n return this.helloResult?.limits ?? null\n }\n\n // ---------- session ----------\n\n async hello(clientFeatures?: string[]): Promise<HelloResult> {\n const args: Record<string, unknown> = { versions: [NFSP_VERSION] }\n if (clientFeatures) args.features = clientFeatures\n const r = (await this.post('hello', { args })) as HelloResult\n this.session = r.session\n this.seq = 0\n this.helloResult = r\n return r\n }\n\n async bye(): Promise<void> {\n await this.call('bye', {})\n this.session = null\n this.helloResult = null\n }\n\n // ---------- resolve / stat / list / batch ----------\n\n async resolve(at: LocatorLike, want?: WantGroup[]): Promise<NodeInfo> {\n return (await this.call('resolve', { at: toLocator(at), want })) as NodeInfo\n }\n\n /** stat with an optional child `name` step (server-side walk). */\n async stat(at: LocatorLike, opts?: { name?: string; want?: WantGroup[] }): Promise<NodeInfo> {\n return (await this.call('stat', {\n at: toLocator(at),\n want: opts?.want,\n args: opts?.name ? { name: opts.name } : {},\n })) as NodeInfo\n }\n\n async list(at: LocatorLike, opts?: ListOptions, want?: WantGroup[]): Promise<Listing> {\n return (await this.call('list', {\n at: toLocator(at),\n want,\n args: (opts ?? {}) as Record<string, unknown>,\n })) as Listing\n }\n\n async batch(\n start: LocatorLike,\n ops: BatchOp[],\n onError: 'abort' | 'continue' = 'abort',\n ): Promise<BatchResult> {\n return (await this.call('batch', {\n args: { start: toLocator(start), ops, on_error: onError },\n })) as BatchResult\n }\n\n // ---------- structure writes ----------\n\n /**\n * Ref form: create one child under `parent` (optional CAS via\n * `expectedRevision`). Path form: pass a dfs path string and no name —\n * behaves like `mkdir -p` (idempotent, no CAS).\n */\n async mkdir(\n parent: LocatorLike,\n name?: string,\n opts?: { expectedRevision?: string },\n ): Promise<{ ref: WireRef; existed: boolean; revision?: string }> {\n const args: Record<string, unknown> = {}\n if (name !== undefined) args.name = name\n if (opts?.expectedRevision) args.expected_revision = opts.expectedRevision\n return (await this.write('mkdir', { at: toLocator(parent), args })) as {\n ref: WireRef\n existed: boolean\n revision?: string\n }\n }\n\n async move(\n from: { parentRef: WireRef; name: string },\n to: { parentRef: WireRef; name: string },\n opts?: { expectedFromRevision?: string; expectedToRevision?: string },\n ): Promise<{ from_revision: string; to_revision: string }> {\n return (await this.write('move', {\n args: {\n from: { parent_ref: from.parentRef, name: from.name },\n to: { parent_ref: to.parentRef, name: to.name },\n expected_from_revision: opts?.expectedFromRevision,\n expected_to_revision: opts?.expectedToRevision,\n },\n })) as { from_revision: string; to_revision: string }\n }\n\n /** Destroys a native entry. Reference entries must use `unlink` instead. */\n async delete(\n parent: LocatorLike,\n name: string,\n opts?: { recursive?: boolean; expectedRevision?: string },\n ): Promise<{ revision: string }> {\n return (await this.write('delete', {\n at: toLocator(parent),\n args: {\n name,\n recursive: opts?.recursive,\n expected_revision: opts?.expectedRevision,\n },\n })) as { revision: string }\n }\n\n async bindRef(\n parentRef: WireRef,\n name: string,\n targetRef: WireRef,\n opts?: { expectedRevision?: string },\n ): Promise<{ entry_ref: string; revision: string }> {\n return (await this.write('bind_ref', {\n args: {\n parent_ref: parentRef,\n name,\n target_ref: targetRef,\n expected_revision: opts?.expectedRevision,\n },\n })) as { entry_ref: string; revision: string }\n }\n\n /** Removes a reference entry (`be_*`) only; the target is never touched. */\n async unlink(\n entryRef: string,\n opts?: { expectedRevision?: string },\n ): Promise<{ revision: string }> {\n return (await this.write('unlink', {\n args: { entry_ref: entryRef, expected_revision: opts?.expectedRevision },\n })) as { revision: string }\n }\n\n // ---------- content writes (open_write / tus / commit_file / probe) ----------\n\n async openWrite(\n target: { parentRef: WireRef; name: string; size?: number } | { ref: WireRef },\n ): Promise<OpenWriteResult> {\n const args: Record<string, unknown> =\n 'ref' in target\n ? { ref: target.ref }\n : { parent_ref: target.parentRef, name: target.name, size: target.size }\n return (await this.write('open_write', { args })) as OpenWriteResult\n }\n\n /** Current upload offset (tus HEAD) — resume point after interruption. */\n async uploadOffset(fbHandle: string): Promise<number> {\n const resp = await this.fetchFn(`${this.baseUrl}/nfs/v1/uploads/${fbHandle}`, {\n method: 'HEAD',\n headers: await this.authHeaders(),\n })\n if (!resp.ok) throw await this.httpError(resp)\n return Number(resp.headers.get('Upload-Offset') ?? '0')\n }\n\n /** One tus PATCH. Returns the new offset. */\n async uploadChunk(fbHandle: string, offset: number, chunk: Uint8Array): Promise<number> {\n const resp = await this.fetchFn(`${this.baseUrl}/nfs/v1/uploads/${fbHandle}`, {\n method: 'PATCH',\n headers: {\n ...await this.authHeaders(),\n 'Upload-Offset': String(offset),\n 'Content-Type': 'application/offset+octet-stream',\n },\n body: chunk as unknown as BodyInit,\n })\n if (resp.status !== 204) throw await this.httpError(resp)\n return Number(resp.headers.get('Upload-Offset') ?? String(offset + chunk.byteLength))\n }\n\n /** Uploads a whole buffer in chunks, resuming from the server's offset. */\n async uploadContent(\n fbHandle: string,\n content: Uint8Array,\n onProgress?: (sent: number, total: number) => void,\n ): Promise<void> {\n let offset = await this.uploadOffset(fbHandle)\n while (offset < content.byteLength) {\n const chunk = content.subarray(offset, Math.min(offset + this.chunkSize, content.byteLength))\n offset = await this.uploadChunk(fbHandle, offset, chunk)\n onProgress?.(offset, content.byteLength)\n }\n }\n\n async abortWrite(leaseId: string): Promise<void> {\n await this.write('abort_write', { args: { lease_id: leaseId } })\n }\n\n private async authHeaders(): Promise<Record<string, string>> {\n const token = await this.sessionToken?.()\n return token ? { Authorization: `Bearer ${token}` } : {}\n }\n\n async commitFile(\n parent: LocatorLike,\n name: string,\n source: { fbHandle: string; leaseId?: string } | { hash: string },\n opts?: { overwrite?: boolean; expectedRevision?: string },\n ): Promise<CommitResult> {\n const args: Record<string, unknown> = {\n name,\n overwrite: opts?.overwrite,\n expected_revision: opts?.expectedRevision,\n }\n if ('fbHandle' in source) {\n args.fb_handle = source.fbHandle\n if (source.leaseId) args.lease_id = source.leaseId\n } else {\n args.hash = source.hash\n }\n return (await this.write('commit_file', { at: toLocator(parent), args })) as CommitResult\n }\n\n /** Which of these digests must be uploaded (§ probe / 秒传). */\n async probe(digests: { hash: string; size?: number }[]): Promise<{ missing: { hash: string; size?: number }[] }> {\n return (await this.call('probe', { args: { digests } })) as {\n missing: { hash: string; size?: number }[]\n }\n }\n\n /**\n * Convenience: open_write + chunked tus upload + commit_file.\n * Overwrites an existing file only when `opts.overwrite` is set.\n */\n async uploadFile(\n parentRef: WireRef,\n name: string,\n content: Uint8Array,\n opts?: { overwrite?: boolean; onProgress?: (sent: number, total: number) => void },\n ): Promise<CommitResult> {\n const ow = await this.openWrite({ parentRef, name, size: content.byteLength })\n await this.uploadContent(ow.fb_handle, content, opts?.onProgress)\n return this.commitFile({ ref: parentRef }, name, {\n fbHandle: ow.fb_handle,\n leaseId: ow.lease.lease_id,\n }, { overwrite: opts?.overwrite })\n }\n\n // ---------- data plane read ----------\n\n /** URL for `GET /nfs/v1/read/{node_id}` (usable in <img>, <a download>, …). */\n readUrl(nodeId: string, opts?: { download?: boolean; name?: string }): string {\n const params = new URLSearchParams()\n if (opts?.download) params.set('download', '1')\n if (opts?.name) params.set('name', opts.name)\n const qs = params.size > 0 ? `?${params.toString()}` : ''\n return `${this.baseUrl}/nfs/v1/read/${encodeURIComponent(nodeId)}${qs}`\n }\n\n /** Reads file content; `range` is inclusive byte positions. */\n async readFile(\n nodeId: string,\n opts?: { range?: { start: number; end?: number }; ifNoneMatch?: string },\n ): Promise<Response> {\n const headers: Record<string, string> = await this.authHeaders()\n if (opts?.range) {\n headers.Range = `bytes=${opts.range.start}-${opts.range.end ?? ''}`\n }\n if (opts?.ifNoneMatch) headers['If-None-Match'] = opts.ifNoneMatch\n const resp = await this.fetchFn(this.readUrl(nodeId), { headers, cache: 'no-store' })\n if (!resp.ok && resp.status !== 304) throw await this.httpError(resp)\n return resp\n }\n\n // ---------- meta ----------\n\n async getMeta(target: LocatorLike, ns?: string[]): Promise<{ records: MetaRecord[] }> {\n const loc = toLocator(target)\n const args: Record<string, unknown> = { ns }\n if (loc.ref) args.ref = loc.ref\n return (await this.call('get_meta', { at: loc, args })) as { records: MetaRecord[] }\n }\n\n /** v1: only `ns: \"user\"` records are writable. */\n async setMeta(\n target: LocatorLike,\n records: { ns: string; key: string; value: unknown; visibility?: string }[],\n ): Promise<{ updated: number }> {\n const loc = toLocator(target)\n const args: Record<string, unknown> = { records }\n if (loc.ref) args.ref = loc.ref\n return (await this.write('set_meta', { at: loc, args })) as { updated: number }\n }\n\n // ---------- search ----------\n\n async search(\n q: string,\n opts?: { limit?: number; cursor?: string; scope?: LocatorLike; modes?: string[] },\n want?: WantGroup[],\n ): Promise<SearchResult> {\n return (await this.call('search', {\n want,\n args: {\n q,\n limit: opts?.limit,\n cursor: opts?.cursor,\n scope: opts?.scope !== undefined ? toLocator(opts.scope) : undefined,\n modes: opts?.modes,\n },\n })) as SearchResult\n }\n\n // ---------- views & collections ----------\n\n async openView(viewId: string, want?: WantGroup[]): Promise<NodeInfo> {\n return (await this.call('open_view', { want, args: { view_id: viewId } })) as NodeInfo\n }\n\n async createCollection(\n title: string,\n collectionId?: string,\n want?: WantGroup[],\n ): Promise<NodeInfo> {\n return (await this.write('create_collection', {\n want,\n args: { title, collection_id: collectionId },\n })) as NodeInfo\n }\n\n async openCollection(collectionId: string, want?: WantGroup[]): Promise<NodeInfo> {\n return (await this.call('open_collection', {\n want,\n args: { collection_id: collectionId },\n })) as NodeInfo\n }\n\n async collectionPatch(\n ref: WireRef,\n ops: CollectionPatchOp[],\n opts?: { expectedRevision?: string },\n ): Promise<{ revision: string }> {\n return (await this.write('collection_patch', {\n args: { ref, ops, expected_revision: opts?.expectedRevision },\n })) as { revision: string }\n }\n\n // ---------- grants ----------\n\n async grant(\n subtree: LocatorLike,\n opts?: { ops?: string[]; ttl?: number; audience?: string; maxUses?: number },\n ): Promise<GrantResult> {\n return (await this.write('grant', {\n args: {\n subtree: toLocator(subtree),\n ops: opts?.ops,\n ttl: opts?.ttl,\n audience: opts?.audience,\n max_uses: opts?.maxUses,\n },\n })) as GrantResult\n }\n\n async revoke(capId: string): Promise<{ revoked: string }> {\n return (await this.write('revoke', { args: { cap_id: capId } })) as { revoked: string }\n }\n\n // ---------- watch (SSE) ----------\n\n /**\n * Opens the watch stream. `tokens` filters to specific containers using the\n * `watch_token` returned by list. The stream is lossy by contract: on any\n * `resync` event, re-list watched containers.\n */\n watch(opts?: { tokens?: string[]; signal?: AbortSignal }): AsyncIterableIterator<WatchEvent> & {\n close: () => void\n } {\n if (!this.session) throw new Error('watch requires an active session; call hello() first')\n const params = new URLSearchParams({ session: this.session })\n if (opts?.tokens?.length) params.set('tokens', opts.tokens.join(','))\n const url = `${this.baseUrl}/nfs/v1/watch?${params.toString()}`\n const controller = new AbortController()\n if (opts?.signal) {\n opts.signal.addEventListener('abort', () => controller.abort(), { once: true })\n }\n const fetchFn = this.fetchFn\n const authHeaders = () => this.authHeaders()\n\n async function* events(): AsyncIterableIterator<WatchEvent> {\n const resp = await fetchFn(url, {\n headers: { ...await authHeaders(), Accept: 'text/event-stream' },\n signal: controller.signal,\n })\n if (!resp.ok || !resp.body) {\n throw new Error(`watch failed: HTTP ${resp.status}`)\n }\n const reader = resp.body.getReader()\n const decoder = new TextDecoder()\n let buf = ''\n try {\n for (;;) {\n const { done, value } = await reader.read()\n if (done) return\n buf += decoder.decode(value, { stream: true })\n // SSE frames are separated by a blank line.\n for (;;) {\n const sep = buf.indexOf('\\n\\n')\n if (sep < 0) break\n const frame = buf.slice(0, sep)\n buf = buf.slice(sep + 2)\n let event = 'message'\n let id: string | undefined\n const dataLines: string[] = []\n for (const line of frame.split('\\n')) {\n if (line.startsWith('event:')) event = line.slice(6).trim()\n else if (line.startsWith('data:')) dataLines.push(line.slice(5).trim())\n else if (line.startsWith('id:')) id = line.slice(3).trim()\n // comment lines (`:keep-alive`) are ignored\n }\n if (dataLines.length === 0 && event === 'message') continue\n let data: Record<string, unknown> = {}\n if (dataLines.length > 0) {\n try {\n data = JSON.parse(dataLines.join('\\n')) as Record<string, unknown>\n } catch {\n data = { raw: dataLines.join('\\n') }\n }\n }\n yield { event, data, id }\n }\n }\n } finally {\n reader.cancel().catch(() => {})\n }\n }\n\n const it = events() as AsyncIterableIterator<WatchEvent> & { close: () => void }\n it.close = () => controller.abort()\n return it\n }\n\n // ---------- envelope plumbing ----------\n\n /** Read-path call: no seq. Throws NfspError on `ok:false`. */\n async call(method: string, extras: EnvelopeExtras): Promise<unknown> {\n return this.post(method, this.envelope(extras))\n }\n\n /**\n * Write-path call: assigns the next seq once and reuses it across network\n * retries so the server's replay window guarantees exactly-once.\n */\n async write(method: string, extras: EnvelopeExtras, retries = 2): Promise<unknown> {\n const seq = ++this.seq\n const body = { ...this.envelope(extras), seq }\n let lastErr: unknown\n for (let attempt = 0; attempt <= retries; attempt++) {\n try {\n return await this.post(method, body)\n } catch (e) {\n // Only network-level failures are retried (same seq → replay-safe).\n // NfspError means the server answered: propagate immediately.\n if (e instanceof NfspError) throw e\n lastErr = e\n }\n }\n throw lastErr\n }\n\n private envelope(extras: EnvelopeExtras): Record<string, unknown> {\n const body: Record<string, unknown> = { args: pruneUndefined(extras.args ?? {}) }\n if (this.session) body.session = this.session\n if (extras.at) body.at = pruneUndefined(extras.at as unknown as Record<string, unknown>)\n if (extras.want) body.want = extras.want\n return body\n }\n\n private async post(method: string, body: Record<string, unknown>): Promise<unknown> {\n const token = await this.sessionToken?.()\n const resp = await this.fetchFn(`${this.baseUrl}/nfs/v1/${method}`, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json', ...(token ? { Authorization: `Bearer ${token}` } : {}) },\n body: JSON.stringify(body),\n })\n let parsed: { ok?: boolean; result?: unknown; error?: NfspErrorBody }\n try {\n parsed = (await resp.json()) as typeof parsed\n } catch {\n throw new NfspError(\n { code: 'INTERNAL', message: `non-JSON response (HTTP ${resp.status})` },\n resp.status,\n )\n }\n if (parsed.ok !== true) {\n throw new NfspError(\n parsed.error ?? { code: 'INTERNAL', message: 'malformed error envelope' },\n resp.status,\n )\n }\n return parsed.result\n }\n\n private async httpError(resp: Response): Promise<NfspError> {\n try {\n const parsed = (await resp.json()) as { error?: NfspErrorBody }\n if (parsed.error) return new NfspError(parsed.error, resp.status)\n } catch {\n // fall through\n }\n return new NfspError({ code: 'INTERNAL', message: `HTTP ${resp.status}` }, resp.status)\n }\n}\n\n/** Drops undefined values so they don't serialize as JSON nulls. */\nconst pruneUndefined = (obj: Record<string, unknown>): Record<string, unknown> => {\n const out: Record<string, unknown> = {}\n for (const [k, v] of Object.entries(obj)) {\n if (v !== undefined) out[k] = v\n }\n return out\n}\n"],"names":["NFSP_VERSION","toLocator","at","includes","uri","realm","path","ref","NfspError","Error","constructor","body","httpStatus","super","code","message","this","name","details","Object","fromEntries","entries","filter","key","pruneUndefined","obj","out","k","v","opts","session","seq","helloResult","sessionToken","baseUrl","replace","fetchFn","fetch","input","init","globalThis","chunkSize","uploadChunkSize","sessionId","features","_a","limits","hello","clientFeatures","args","versions","r","post","bye","call","resolve","want","stat","list","batch","start","ops","onError","on_error","mkdir","parent","expectedRevision","expected_revision","write","move","from","to","parent_ref","parentRef","expected_from_revision","expectedFromRevision","expected_to_revision","expectedToRevision","recursive","bindRef","targetRef","target_ref","unlink","entryRef","entry_ref","openWrite","target","size","uploadOffset","fbHandle","resp","method","headers","authHeaders","ok","httpError","Number","get","uploadChunk","offset","chunk","String","status","byteLength","uploadContent","content","onProgress","subarray","Math","min","abortWrite","leaseId","lease_id","token","Authorization","commitFile","source","overwrite","fb_handle","hash","probe","digests","uploadFile","ow","lease","readUrl","nodeId","params","URLSearchParams","download","set","qs","toString","encodeURIComponent","readFile","range","Range","end","ifNoneMatch","cache","getMeta","ns","loc","setMeta","records","search","q","limit","cursor","scope","modes","openView","viewId","view_id","createCollection","title","collectionId","collection_id","openCollection","collectionPatch","grant","subtree","ttl","audience","max_uses","maxUses","revoke","capId","cap_id","watch","tokens","length","join","url","controller","AbortController","signal","addEventListener","abort","once","it","async","Accept","reader","getReader","decoder","TextDecoder","buf","done","value","read","decode","stream","sep","indexOf","frame","slice","id","event","dataLines","line","split","startsWith","trim","push","data","JSON","parse","raw","cancel","catch","events","close","extras","envelope","retries","lastErr","attempt","e","stringify","parsed","json","error","result","gen","type","node_id"],"mappings":"gFA4BO,MAAMA,EAAe,SAwBfC,EAAaC,GACN,iBAAPA,EACLA,EAAGC,SAAS,OAAe,CAAEC,IAAKF,GAC/B,CAAEG,MAAO,MAAOC,KAAMJ,GAE3B,SAAUA,EAAW,CAAEK,IAAKL,GACzBA,EAkMF,MAAMM,UAAkBC,MAM7B,WAAAC,CAAYC,EAAqBC,GAC/BC,MAAM,GAAGF,EAAKG,SAASH,EAAKI,WAC5BC,KAAKC,KAAO,YACZD,KAAKF,KAAOH,EAAKG,KACjBE,KAAKJ,WAAaA,EAClBI,KAAKE,QAAUC,OAAOC,YAAYD,OAAOE,QAAQV,GAAMW,QAAO,EAAEC,KAAiB,SAARA,GAA0B,YAARA,IAC7F,EA2iBF,MAAMC,EAAkBC,IACtB,MAAMC,EAA+B,CAAA,EACrC,IAAA,MAAYC,EAAGC,KAAMT,OAAOE,QAAQI,QACxB,IAANG,IAAiBF,EAAIC,GAAKC,GAEzB,OAAAF,CAAA,4CAzhBF,MASL,WAAAhB,CAAYmB,GAJZb,KAAQc,QAAyB,KACjCd,KAAQe,IAAM,EACdf,KAAQgB,YAAkC,KAGxChB,KAAKiB,aAAeJ,EAAKI,aACzBjB,KAAKkB,QAAUL,EAAKK,QAAQC,QAAQ,OAAQ,IAEvCnB,KAAAoB,QAAUP,EAAKQ,OAAU,EAACC,EAAOC,IAASC,WAAWH,MAAMC,EAAOC,IACvEvB,KAAKyB,UAAYZ,EAAKa,iBAAmB,OAC3C,CAEA,aAAIC,GACF,OAAO3B,KAAKc,OACd,CAGA,YAAIc,SACK,OAAA,OAAAC,EAAK7B,KAAAgB,kBAAa,EAAAa,EAAAD,WAAY,EACvC,CAEA,UAAIE,SACK,OAAA,OAAAD,EAAA7B,KAAKgB,kBAAL,EAAAa,EAAkBC,SAAU,IACrC,CAIA,WAAMC,CAAMC,GACV,MAAMC,EAAgC,CAAEC,SAAU,CAAClD,IAC/CgD,IAAgBC,EAAKL,SAAWI,GACpC,MAAMG,QAAWnC,KAAKoC,KAAK,QAAS,CAAEH,SAI/B,OAHPjC,KAAKc,QAAUqB,EAAErB,QACjBd,KAAKe,IAAM,EACXf,KAAKgB,YAAcmB,EACZA,CACT,CAEA,SAAME,SACErC,KAAKsC,KAAK,MAAO,CAAE,GACzBtC,KAAKc,QAAU,KACfd,KAAKgB,YAAc,IACrB,CAIA,aAAMuB,CAAQrD,EAAiBsD,GACrB,aAAMxC,KAAKsC,KAAK,UAAW,CAAEpD,GAAID,EAAUC,GAAKsD,QAC1D,CAGA,UAAMC,CAAKvD,EAAiB2B,GAClB,aAAMb,KAAKsC,KAAK,OAAQ,CAC9BpD,GAAID,EAAUC,GACdsD,KAAY,MAAN3B,OAAM,EAAAA,EAAA2B,KACZP,YAAMpB,WAAMZ,MAAO,CAAEA,KAAMY,EAAKZ,MAAS,CAAC,GAE9C,CAEA,UAAMyC,CAAKxD,EAAiB2B,EAAoB2B,GACtC,aAAMxC,KAAKsC,KAAK,OAAQ,CAC9BpD,GAAID,EAAUC,GACdsD,OACAP,KAAOpB,GAAQ,CAAC,GAEpB,CAEA,WAAM8B,CACJC,EACAC,EACAC,EAAgC,SAExB,aAAM9C,KAAKsC,KAAK,QAAS,CAC/BL,KAAM,CAAEW,MAAO3D,EAAU2D,GAAQC,MAAKE,SAAUD,IAEpD,CASA,WAAME,CACJC,EACAhD,EACAY,GAEA,MAAMoB,EAAgC,CAAA,EAG9B,YAFK,IAAThC,IAAoBgC,EAAKhC,KAAOA,IAC1B,MAANY,OAAM,EAAAA,EAAAqC,oBAAkBjB,EAAKkB,kBAAoBtC,EAAKqC,wBAC5ClD,KAAKoD,MAAM,QAAS,CAAElE,GAAID,EAAUgE,GAAShB,QAK7D,CAEA,UAAMoB,CACJC,EACAC,EACA1C,GAEQ,aAAMb,KAAKoD,MAAM,OAAQ,CAC/BnB,KAAM,CACJqB,KAAM,CAAEE,WAAYF,EAAKG,UAAWxD,KAAMqD,EAAKrD,MAC/CsD,GAAI,CAAEC,WAAYD,EAAGE,UAAWxD,KAAMsD,EAAGtD,MACzCyD,uBAA8B,MAAN7C,OAAM,EAAAA,EAAA8C,qBAC9BC,qBAA4B,MAAN/C,OAAM,EAAAA,EAAAgD,qBAGlC,CAGA,YAAM,CACJZ,EACAhD,EACAY,GAEQ,aAAMb,KAAKoD,MAAM,SAAU,CACjClE,GAAID,EAAUgE,GACdhB,KAAM,CACJhC,OACA6D,UAAiB,MAANjD,OAAM,EAAAA,EAAAiD,UACjBX,kBAAyB,MAANtC,OAAM,EAAAA,EAAAqC,mBAG/B,CAEA,aAAMa,CACJN,EACAxD,EACA+D,EACAnD,GAEQ,aAAMb,KAAKoD,MAAM,WAAY,CACnCnB,KAAM,CACJuB,WAAYC,EACZxD,OACAgE,WAAYD,EACZb,kBAAyB,MAANtC,OAAM,EAAAA,EAAAqC,mBAG/B,CAGA,YAAMgB,CACJC,EACAtD,GAEQ,aAAMb,KAAKoD,MAAM,SAAU,CACjCnB,KAAM,CAAEmC,UAAWD,EAAUhB,wBAAmBtC,WAAMqC,mBAE1D,CAIA,eAAMmB,CACJC,GAEA,MAAMrC,EACJ,QAASqC,EACL,CAAE/E,IAAK+E,EAAO/E,KACd,CAAEiE,WAAYc,EAAOb,UAAWxD,KAAMqE,EAAOrE,KAAMsE,KAAMD,EAAOC,MACtE,aAAcvE,KAAKoD,MAAM,aAAc,CAAEnB,QAC3C,CAGA,kBAAMuC,CAAaC,GACX,MAAAC,QAAa1E,KAAKoB,QAAQ,GAAGpB,KAAKkB,0BAA0BuD,IAAY,CAC5EE,OAAQ,OACRC,cAAe5E,KAAK6E,gBAEtB,IAAKH,EAAKI,GAAU,YAAM9E,KAAK+E,UAAUL,GACzC,OAAOM,OAAON,EAAKE,QAAQK,IAAI,kBAAoB,IACrD,CAGA,iBAAMC,CAAYT,EAAkBU,EAAgBC,GAC5C,MAAAV,QAAa1E,KAAKoB,QAAQ,GAAGpB,KAAKkB,0BAA0BuD,IAAY,CAC5EE,OAAQ,QACRC,QAAS,UACE5E,KAAK6E,cACd,gBAAiBQ,OAAOF,GACxB,eAAgB,mCAElBxF,KAAMyF,IAER,GAAoB,MAAhBV,EAAKY,OAAsB,YAAMtF,KAAK+E,UAAUL,GAC7C,OAAAM,OAAON,EAAKE,QAAQK,IAAI,kBAAoBI,OAAOF,EAASC,EAAMG,YAC3E,CAGA,mBAAMC,CACJf,EACAgB,EACAC,GAEA,IAAIP,QAAenF,KAAKwE,aAAaC,GAC9B,KAAAU,EAASM,EAAQF,YAAY,CAC5B,MAAAH,EAAQK,EAAQE,SAASR,EAAQS,KAAKC,IAAIV,EAASnF,KAAKyB,UAAWgE,EAAQF,aACjFJ,QAAenF,KAAKkF,YAAYT,EAAUU,EAAQC,GACrC,MAAAM,GAAAA,EAAAP,EAAQM,EAAQF,WAC/B,CACF,CAEA,gBAAMO,CAAWC,SACT/F,KAAKoD,MAAM,cAAe,CAAEnB,KAAM,CAAE+D,SAAUD,IACtD,CAEA,iBAAclB,SACN,MAAAoB,QAAc,OAAApE,EAAA7B,KAAKiB,mBAAL,EAAAY,EAAAS,KAAAtC,OACpB,OAAOiG,EAAQ,CAAEC,cAAe,UAAUD,KAAY,EACxD,CAEA,gBAAME,CACJlD,EACAhD,EACAmG,EACAvF,GAEA,MAAMoB,EAAgC,CACpChC,OACAoG,UAAiB,MAANxF,OAAM,EAAAA,EAAAwF,UACjBlD,kBAAyB,MAANtC,OAAM,EAAAA,EAAAqC,kBAQnB,MANJ,aAAckD,GAChBnE,EAAKqE,UAAYF,EAAO3B,SACpB2B,EAAOL,UAAS9D,EAAK+D,SAAWI,EAAOL,UAE3C9D,EAAKsE,KAAOH,EAAOG,WAEPvG,KAAKoD,MAAM,cAAe,CAAElE,GAAID,EAAUgE,GAAShB,QACnE,CAGA,WAAMuE,CAAMC,GACF,aAAMzG,KAAKsC,KAAK,QAAS,CAAEL,KAAM,CAAEwE,YAG7C,CAMA,gBAAMC,CACJjD,EACAxD,EACAwF,EACA5E,GAEM,MAAA8F,QAAW3G,KAAKqE,UAAU,CAAEZ,YAAWxD,OAAMsE,KAAMkB,EAAQF,aAEjE,aADMvF,KAAKwF,cAAcmB,EAAGL,UAAWb,QAAS5E,WAAM6E,YAC/C1F,KAAKmG,WAAW,CAAE5G,IAAKkE,GAAaxD,EAAM,CAC/CwE,SAAUkC,EAAGL,UACbP,QAASY,EAAGC,MAAMZ,UACjB,CAAEK,UAAW,MAAAxF,OAAA,EAAAA,EAAMwF,WACxB,CAKA,OAAAQ,CAAQC,EAAgBjG,GAChB,MAAAkG,EAAS,IAAIC,iBACT,MAANnG,OAAM,EAAAA,EAAAoG,WAAiBF,EAAAG,IAAI,WAAY,MACjC,MAANrG,OAAM,EAAAA,EAAAZ,OAAa8G,EAAAG,IAAI,OAAQrG,EAAKZ,MAClC,MAAAkH,EAAKJ,EAAOxC,KAAO,EAAI,IAAIwC,EAAOK,aAAe,GAChD,MAAA,GAAGpH,KAAKkB,uBAAuBmG,mBAAmBP,KAAUK,GACrE,CAGA,cAAMG,CACJR,EACAjG,GAEM,MAAA+D,QAAwC5E,KAAK6E,qBAC/ChE,WAAM0G,SACA3C,EAAA4C,MAAQ,SAAS3G,EAAK0G,MAAM3E,SAAS/B,EAAK0G,MAAME,KAAO,OAEvD,MAAN5G,OAAM,EAAAA,EAAA6G,eAAqB9C,EAAA,iBAAmB/D,EAAK6G,aACvD,MAAMhD,QAAa1E,KAAKoB,QAAQpB,KAAK6G,QAAQC,GAAS,CAAElC,UAAS+C,MAAO,aACxE,IAAKjD,EAAKI,IAAsB,MAAhBJ,EAAKY,OAAsB,YAAMtF,KAAK+E,UAAUL,GACzD,OAAAA,CACT,CAIA,aAAMkD,CAAQtD,EAAqBuD,GAC3B,MAAAC,EAAM7I,EAAUqF,GAChBrC,EAAgC,CAAE4F,MAEhC,OADJC,EAAIvI,MAAK0C,EAAK1C,IAAMuI,EAAIvI,WACdS,KAAKsC,KAAK,WAAY,CAAEpD,GAAI4I,EAAK7F,QACjD,CAGA,aAAM8F,CACJzD,EACA0D,GAEM,MAAAF,EAAM7I,EAAUqF,GAChBrC,EAAgC,CAAE+F,WAEhC,OADJF,EAAIvI,MAAK0C,EAAK1C,IAAMuI,EAAIvI,WACdS,KAAKoD,MAAM,WAAY,CAAElE,GAAI4I,EAAK7F,QAClD,CAIA,YAAMgG,CACJC,EACArH,EACA2B,GAEQ,aAAMxC,KAAKsC,KAAK,SAAU,CAChCE,OACAP,KAAM,CACJiG,IACAC,MAAa,MAANtH,OAAM,EAAAA,EAAAsH,MACbC,OAAc,MAANvH,OAAM,EAAAA,EAAAuH,OACdC,WAAuB,KAAV,MAANxH,OAAM,EAAAA,EAAAwH,OAAsBpJ,EAAU4B,EAAKwH,YAAS,EAC3DC,MAAa,MAANzH,OAAM,EAAAA,EAAAyH,QAGnB,CAIA,cAAMC,CAASC,EAAgBhG,GACrB,aAAMxC,KAAKsC,KAAK,YAAa,CAAEE,OAAMP,KAAM,CAAEwG,QAASD,IAChE,CAEA,sBAAME,CACJC,EACAC,EACApG,GAEQ,aAAMxC,KAAKoD,MAAM,oBAAqB,CAC5CZ,OACAP,KAAM,CAAE0G,QAAOE,cAAeD,IAElC,CAEA,oBAAME,CAAeF,EAAsBpG,GACjC,aAAMxC,KAAKsC,KAAK,kBAAmB,CACzCE,OACAP,KAAM,CAAE4G,cAAeD,IAE3B,CAEA,qBAAMG,CACJxJ,EACAsD,EACAhC,GAEQ,aAAMb,KAAKoD,MAAM,mBAAoB,CAC3CnB,KAAM,CAAE1C,MAAKsD,MAAKM,wBAAmBtC,WAAMqC,mBAE/C,CAIA,WAAM8F,CACJC,EACApI,GAEQ,aAAMb,KAAKoD,MAAM,QAAS,CAChCnB,KAAM,CACJgH,QAAShK,EAAUgK,GACnBpG,IAAW,MAANhC,OAAM,EAAAA,EAAAgC,IACXqG,IAAW,MAANrI,OAAM,EAAAA,EAAAqI,IACXC,SAAgB,MAANtI,OAAM,EAAAA,EAAAsI,SAChBC,SAAgB,MAANvI,OAAM,EAAAA,EAAAwI,UAGtB,CAEA,YAAMC,CAAOC,GACH,aAAMvJ,KAAKoD,MAAM,SAAU,CAAEnB,KAAM,CAAEuH,OAAQD,IACvD,CASA,KAAAE,CAAM5I,SAGJ,IAAKb,KAAKc,QAAe,MAAA,IAAIrB,MAAM,wDACnC,MAAMsH,EAAS,IAAIC,gBAAgB,CAAElG,QAASd,KAAKc,WAC/C,OAAAe,EAAA,MAAAhB,OAAA,EAAAA,EAAM6I,aAAQ,EAAA7H,EAAA8H,SAAQ5C,EAAOG,IAAI,SAAUrG,EAAK6I,OAAOE,KAAK,MAChE,MAAMC,EAAM,GAAG7J,KAAKkB,wBAAwB6F,EAAOK,aAC7C0C,EAAa,IAAIC,uBACnBlJ,WAAMmJ,SACHnJ,EAAAmJ,OAAOC,iBAAiB,SAAS,IAAMH,EAAWI,SAAS,CAAEC,MAAM,IAE1E,MAAM/I,EAAUpB,KAAKoB,QACfyD,EAAc,IAAM7E,KAAK6E,cAkD/B,MAAMuF,EAhDNC,kBACQ,MAAA3F,QAAatD,EAAQyI,EAAK,CAC9BjF,QAAS,UAAWC,IAAeyF,OAAQ,qBAC3CN,OAAQF,EAAWE,SAErB,IAAKtF,EAAKI,KAAOJ,EAAK/E,KACpB,MAAM,IAAIF,MAAM,sBAAsBiF,EAAKY,UAEvC,MAAAiF,EAAS7F,EAAK/E,KAAK6K,YACnBC,EAAU,IAAIC,YACpB,IAAIC,EAAM,GACN,IACO,OAAA,CACP,MAAMC,KAAEA,EAAMC,MAAAA,SAAgBN,EAAOO,OACjC,GAAAF,EAAM,OAGD,IAFTD,GAAOF,EAAQM,OAAOF,EAAO,CAAEG,QAAQ,MAE9B,CACD,MAAAC,EAAMN,EAAIO,QAAQ,QACxB,GAAID,EAAM,EAAG,MACb,MAAME,EAAQR,EAAIS,MAAM,EAAGH,GACrBN,EAAAA,EAAIS,MAAMH,EAAM,GACtB,IACII,EADAC,EAAQ,UAEZ,MAAMC,EAAsB,GAC5B,IAAA,MAAWC,KAAQL,EAAMM,MAAM,MACzBD,EAAKE,WAAW,UAAWJ,EAAQE,EAAKJ,MAAM,GAAGO,OAC5CH,EAAKE,WAAW,SAAUH,EAAUK,KAAKJ,EAAKJ,MAAM,GAAGO,QACvDH,EAAKE,WAAW,SAAQL,EAAKG,EAAKJ,MAAM,GAAGO,QAGlD,GAAqB,IAArBJ,EAAU5B,QAA0B,YAAV2B,EAAqB,SACnD,IAAIO,EAAgC,CAAA,EAChC,GAAAN,EAAU5B,OAAS,EACjB,IACFkC,EAAOC,KAAKC,MAAMR,EAAU3B,KAAK,MAAK,CAChC,MACNiC,EAAO,CAAEG,IAAKT,EAAU3B,KAAK,MAC/B,MAEI,CAAE0B,QAAOO,OAAMR,KACvB,CACF,CAAA,CACA,QACOd,EAAA0B,SAASC,OAAM,QACxB,CACF,CAEWC,GAEJ,OADJ/B,EAAAgC,MAAQ,IAAMtC,EAAWI,QACrBE,CACT,CAKA,UAAM9H,CAAKqC,EAAgB0H,GACzB,OAAOrM,KAAKoC,KAAKuC,EAAQ3E,KAAKsM,SAASD,GACzC,CAMA,WAAMjJ,CAAMuB,EAAgB0H,EAAwBE,EAAU,GACtD,MAAAxL,IAAQf,KAAKe,IACbpB,EAAO,IAAKK,KAAKsM,SAASD,GAAStL,OACrC,IAAAyL,EACJ,IAAA,IAASC,EAAU,EAAGA,GAAWF,EAASE,IACpC,IACF,aAAazM,KAAKoC,KAAKuC,EAAQhF,SACxB+M,GAGP,GAAIA,aAAalN,EAAiB,MAAAkN,EACxBF,EAAAE,CACZ,CAEI,MAAAF,CACR,CAEQ,QAAAF,CAASD,GACT,MAAA1M,EAAgC,CAAEsC,KAAMzB,EAAe6L,EAAOpK,MAAQ,CAAE,IAIvE,OAHHjC,KAAKc,UAASnB,EAAKmB,QAAUd,KAAKc,SAClCuL,EAAOnN,KAASS,EAAAT,GAAKsB,EAAe6L,EAAOnN,KAC3CmN,EAAO7J,OAAM7C,EAAK6C,KAAO6J,EAAO7J,MAC7B7C,CACT,CAEA,UAAcyC,CAAKuC,EAAgBhF,SAC3B,MAAAsG,QAAc,OAAApE,EAAA7B,KAAKiB,mBAAL,EAAAY,EAAAS,KAAAtC,OACd0E,QAAa1E,KAAKoB,QAAQ,GAAGpB,KAAKkB,kBAAkByD,IAAU,CAClEA,OAAQ,OACRC,QAAS,CAAE,eAAgB,sBAAwBqB,EAAQ,CAAEC,cAAe,UAAUD,KAAY,CAAA,GAClGtG,KAAMmM,KAAKa,UAAUhN,KAEnB,IAAAiN,EACA,IACQA,QAAMlI,EAAKmI,MAAK,CACpB,MACN,MAAM,IAAIrN,EACR,CAAEM,KAAM,WAAYC,QAAS,2BAA2B2E,EAAKY,WAC7DZ,EAAKY,OAET,CACI,IAAc,IAAdsH,EAAO9H,GACT,MAAM,IAAItF,EACRoN,EAAOE,OAAS,CAAEhN,KAAM,WAAYC,QAAS,4BAC7C2E,EAAKY,QAGT,OAAOsH,EAAOG,MAChB,CAEA,eAAchI,CAAUL,GAClB,IACI,MAAAkI,QAAgBlI,EAAKmI,OAC3B,GAAID,EAAOE,MAAO,OAAO,IAAItN,EAAUoN,EAAOE,MAAOpI,EAAKY,OAAM,CAC1D,MAER,CACA,OAAO,IAAI9F,EAAU,CAAEM,KAAM,WAAYC,QAAS,QAAQ2E,EAAKY,UAAYZ,EAAKY,OAClF,uCA5wBqB,CAACwB,EAAgBkG,EAAM,KAAgB,CAC5DC,KAAM,OACNC,QAASpG,EACTkG"}
1
+ {"version":3,"file":"nfsp.cjs","sources":["../src/nfsp.ts"],"sourcesContent":["/**\n * NFSP v0 client for nfs_server (buckyos/src/frame/nfs_server).\n *\n * Speaks the control plane (`POST /nfs/v1/{method}`), the data plane\n * (`GET /nfs/v1/read/{node_id}`), the minimal tus upload area\n * (`PATCH|HEAD /nfs/v1/uploads/{fb}`) and the watch SSE stream\n * (`GET /nfs/v1/watch`).\n *\n * Protocol references:\n * - cyfs-ndn/doc/NamedFileSystem_Protocol_v0.md (NFSP v0)\n * - buckyos/product/bucky_file/nfs_server.md\n * - buckyos/src/frame/nfs_server/README.md (v1 降级契约)\n *\n * Client contract highlights (nfs_server README §4.2):\n * - `revision` is an opaque equality token: only compare, never order.\n * - Write ops require `seq` (exactly-once); the client auto-assigns one per\n * write and replays with the SAME seq on network retry.\n * - Leases are advisory versus server-local bypass writers: commit may fail\n * with TARGET_MISMATCH{reason:\"bypass_modified\"} — surface, don't retry.\n * - watch is lossy: any `resync` event means \"re-list what you care about\".\n *\n * Uses only fetch/WHATWG streams, so it runs in the browser and in Node ≥ 18.\n */\n\n// ---------------------------------------------------------------------------\n// Wire types\n// ---------------------------------------------------------------------------\n\nexport const NFSP_VERSION = 'nfsp/0'\n\n/** `{\"type\":\"live\",...}` or `{\"type\":\"object\",...}` (NFSP §3.1.2). */\nexport type LiveRef = { type: 'live'; node_id: string; gen?: number }\nexport type ObjectRef = { type: 'object'; obj_id: string; inner_path?: string }\nexport type WireRef = LiveRef | ObjectRef\n\nexport const liveRef = (nodeId: string, gen = 0): LiveRef => ({\n type: 'live',\n node_id: nodeId,\n gen,\n})\n\n/** The `at` locator: ref > uri > path (NFSP §3.4). */\nexport interface Locator {\n realm?: string\n path?: string\n uri?: string\n ref?: WireRef\n}\n\n/** Sugar: accept a dfs path string, a `xxx://` uri, a WireRef or a Locator. */\nexport type LocatorLike = string | WireRef | Locator\n\nexport const toLocator = (at: LocatorLike): Locator => {\n if (typeof at === 'string') {\n if (at.includes('://')) return { uri: at }\n return { realm: 'dfs', path: at }\n }\n if ('type' in at) return { ref: at }\n return at\n}\n\nexport type WantGroup = 'base' | 'ident' | 'access' | 'meta'\n\nexport type NodeKind = 'dir' | 'file' | 'symlink' | 'view' | 'collection' | 'group'\n\n/**\n * The caller's effective permission on a node. `traverse` = only the way to\n * something shared deeper down: listable, but only those children are shown.\n */\nexport type AccessLevel = 'none' | 'traverse' | 'read' | 'write' | 'manage'\n\n/** `user:<user_id>`, `zone_users` (any signed-in user) or `public` (anyone, read only). */\nexport type AclPrincipal = `user:${string}` | 'zone_users' | 'public'\n\nexport interface AclEntry {\n principal: AclPrincipal\n level: Exclude<AccessLevel, 'none' | 'traverse'>\n}\n\n/** `get_acl` result; the entry lists only appear for callers who may manage. */\nexport interface AclInfo {\n path: string\n access_level: AccessLevel\n can_manage: boolean\n revision: string\n inherit?: boolean\n entries?: AclEntry[]\n /** Grants arriving from ancestors, with the directory they come from. */\n inherited?: (AclEntry & { from: string })[]\n /** Built-in rules (zone owner, home owner) that no record can remove. */\n builtin?: (AclEntry & { reason: 'zone_owner' | 'home_owner' })[]\n updated_by?: string\n updated_at?: number\n}\n\nexport interface AclRecordInfo {\n path: string\n inherit: boolean\n entries: AclEntry[]\n home_owner: string | null\n updated_by: string\n updated_at: number\n revision: string\n /** The path no longer exists (removed outside the protocol). */\n missing: boolean\n}\n\nexport interface Capabilities {\n list: boolean\n read: boolean\n accepts_content: boolean\n accepts_references: boolean\n remove_semantics: 'destroy' | 'unlink' | 'none'\n ordered: boolean\n}\n\n/** resolve/stat result (fields beyond `base` appear per the `want` mask). */\nexport interface NodeInfo {\n kind: NodeKind\n state: string\n ref: WireRef\n copy_ref?: WireRef | null\n capabilities: Capabilities\n access_level?: AccessLevel\n revision?: string\n locations?: unknown[]\n // base\n name?: string\n size?: number\n mtime?: number\n ctime?: number\n flags?: string[]\n // ident\n node_id?: string\n gen?: number\n etag?: string\n obj_id?: string\n // access\n access_urls?: { kind: string; url: string }[]\n // meta\n meta_summary?: Record<string, number>\n // view / collection extras\n view_id?: string\n collection_id?: string\n title?: string\n origin?: string\n stale?: boolean\n}\n\nexport type EntryBinding = 'native' | 'reference' | 'member' | 'derived'\n\n/** Compact target of a listing entry (not a full NodeInfo). */\nexport interface EntryTarget {\n ref: WireRef\n copy_ref?: WireRef | null\n kind: NodeKind\n /** Attribute groups per the `want` mask: base → size/mtime/flags, ident → etag/obj_id, access → access_urls. */\n attrs?: {\n size?: number\n mtime?: number\n flags?: string[]\n etag?: string\n obj_id?: string\n access_urls?: { kind: string; url: string }[]\n } & Record<string, unknown>\n /** `stale` when a referenced target no longer resolves, `denied` when the caller may not see it. */\n target_state?: string\n access_level?: AccessLevel\n}\n\nexport interface Entry {\n name: string\n binding: EntryBinding\n entry_ref?: string\n target: EntryTarget\n canonical_path?: string\n context?: { count?: number; provenance?: Record<string, unknown> } & Record<string, unknown>\n}\n\nexport interface Listing {\n container: NodeInfo\n entries: Entry[]\n truncated?: boolean\n next_cursor?: string\n revision_changed?: boolean\n watch_token?: string\n /** Same-name virtual bindings shadowed by native entries (`native_shadow`). */\n conflicts?: { name: string; reason: string; entry_ref?: string; target?: EntryTarget }[]\n}\n\nexport interface ListOptions {\n cursor?: string\n limit?: number\n order?: 'name' | 'mtime' | 'size' | 'manual'\n filter?: { kind?: NodeKind[]; name_glob?: string }\n}\n\nexport interface HelloResult {\n version: string\n session: string\n features: string[]\n limits: { max_batch: number; max_list: number; replay_window: number; attr_ttl_ms: number }\n realms: { id: string; writable: boolean }[]\n /** Who this session acts as (`admin` = the zone owner or a trusted service). */\n identity?: { user_id: string | null; role: 'admin' | 'user' | 'anonymous' }\n}\n\nexport type BatchOp =\n | { m: 'walk'; args: { name?: string; names?: string[]; entry_ref?: string } }\n | { m: 'stat' | 'resolve'; args?: { name?: string }; want?: WantGroup[] }\n | { m: 'list'; args?: ListOptions; want?: WantGroup[] }\n\nexport interface BatchResult {\n completed: number\n results: ({ ok: true; result: unknown } | { ok: false; error: NfspErrorBody })[]\n}\n\nexport interface OpenWriteResult {\n fb_handle: string\n upload_url: string\n lease: { lease_id: string; seq: number; ttl_ms: number }\n target: { path: string; exists: boolean }\n}\n\nexport interface CommitResult {\n ref: WireRef\n entry_ref: string\n revision: string\n obj: { sha256: string; size: number }\n}\n\nexport interface MetaRecord {\n ns: string\n key: string\n value: unknown\n source?: unknown\n confidence?: number\n anchor?: string\n visibility?: string\n}\n\nexport interface SearchHit {\n copy_ref?: WireRef | null\n match_source: string\n canonical_path: string\n explain?: Record<string, unknown>\n [k: string]: unknown\n}\n\nexport interface SearchResult {\n hits: SearchHit[]\n partial: boolean\n sources: { mode: string; state: string; took_ms?: number; reason?: string }[]\n next_cursor?: string\n}\n\nexport interface GrantResult {\n cap_id: string\n token: string\n subtree: string\n ops: string[]\n expires_at?: number\n}\n\nexport type CollectionPatchOp =\n | {\n add_ref: {\n target_ref: WireRef\n name?: string\n position?: number\n parent_entry_ref?: string\n }\n }\n | { remove_entry: { entry_ref: string } }\n | { move_entries: { entry_refs: string[]; to_index: number } }\n | { create_group: { name: string; position?: number } }\n | { rename_group: { entry_ref: string; name: string } }\n\nexport interface WatchEvent {\n /** `resync` | `container_changed` | `meta_changed` (extensible). */\n event: string\n /** Parsed JSON payload of the SSE `data:` line. */\n data: Record<string, unknown>\n /** SSE `id:` (the server_rev), when present. */\n id?: string\n}\n\n// ---------------------------------------------------------------------------\n// Errors\n// ---------------------------------------------------------------------------\n\n/** Structured NFSP error body (§8 plus implementation extensions). */\nexport interface NfspErrorBody {\n code: string\n message: string\n [k: string]: unknown\n}\n\nexport class NfspError extends Error {\n readonly code: string\n readonly httpStatus: number\n /** Extra structured fields (reason, holder_session, obj_id, expected, ...). */\n readonly details: Record<string, unknown>\n\n constructor(body: NfspErrorBody, httpStatus: number) {\n super(`${body.code}: ${body.message}`)\n this.name = 'NfspError'\n this.code = body.code\n this.httpStatus = httpStatus\n this.details = Object.fromEntries(Object.entries(body).filter(([key]) => key !== 'code' && key !== 'message'))\n }\n}\n\n// ---------------------------------------------------------------------------\n// Client\n// ---------------------------------------------------------------------------\n\nexport interface NfspClientOptions {\n sessionToken?: () => Promise<string | null>\n /** e.g. `http://127.0.0.1:3260` — no trailing slash needed. */\n baseUrl: string\n /** Override fetch (tests, custom auth wrappers). Defaults to global fetch. */\n fetch?: typeof fetch\n /** tus PATCH chunk size; server guidance is 4–16 MB. Default 8 MB. */\n uploadChunkSize?: number\n}\n\ninterface EnvelopeExtras {\n at?: Locator\n want?: WantGroup[]\n args?: Record<string, unknown>\n}\n\nexport class NfspClient {\n private readonly sessionToken?: () => Promise<string | null>\n readonly baseUrl: string\n private readonly fetchFn: typeof fetch\n private readonly chunkSize: number\n private session: string | null = null\n private seq = 0\n private helloResult: HelloResult | null = null\n\n constructor(opts: NfspClientOptions) {\n this.sessionToken = opts.sessionToken\n this.baseUrl = opts.baseUrl.replace(/\\/+$/, '')\n // Bind to globalThis: an unbound fetch throws \"Illegal invocation\".\n this.fetchFn = opts.fetch ?? ((input, init) => globalThis.fetch(input, init))\n this.chunkSize = opts.uploadChunkSize ?? 8 * 1024 * 1024\n }\n\n get sessionId(): string | null {\n return this.session\n }\n\n /** Features advertised by the server in hello (empty before hello). */\n get features(): string[] {\n return this.helloResult?.features ?? []\n }\n\n get limits(): HelloResult['limits'] | null {\n return this.helloResult?.limits ?? null\n }\n\n // ---------- session ----------\n\n async hello(clientFeatures?: string[]): Promise<HelloResult> {\n const args: Record<string, unknown> = { versions: [NFSP_VERSION] }\n if (clientFeatures) args.features = clientFeatures\n const r = (await this.post('hello', { args })) as HelloResult\n this.session = r.session\n this.seq = 0\n this.helloResult = r\n return r\n }\n\n async bye(): Promise<void> {\n await this.call('bye', {})\n this.session = null\n this.helloResult = null\n }\n\n // ---------- resolve / stat / list / batch ----------\n\n async resolve(at: LocatorLike, want?: WantGroup[]): Promise<NodeInfo> {\n return (await this.call('resolve', { at: toLocator(at), want })) as NodeInfo\n }\n\n /** stat with an optional child `name` step (server-side walk). */\n async stat(at: LocatorLike, opts?: { name?: string; want?: WantGroup[] }): Promise<NodeInfo> {\n return (await this.call('stat', {\n at: toLocator(at),\n want: opts?.want,\n args: opts?.name ? { name: opts.name } : {},\n })) as NodeInfo\n }\n\n async list(at: LocatorLike, opts?: ListOptions, want?: WantGroup[]): Promise<Listing> {\n return (await this.call('list', {\n at: toLocator(at),\n want,\n args: (opts ?? {}) as Record<string, unknown>,\n })) as Listing\n }\n\n async batch(\n start: LocatorLike,\n ops: BatchOp[],\n onError: 'abort' | 'continue' = 'abort',\n ): Promise<BatchResult> {\n return (await this.call('batch', {\n args: { start: toLocator(start), ops, on_error: onError },\n })) as BatchResult\n }\n\n // ---------- structure writes ----------\n\n /**\n * Ref form: create one child under `parent` (optional CAS via\n * `expectedRevision`). Path form: pass a dfs path string and no name —\n * behaves like `mkdir -p` (idempotent, no CAS).\n */\n async mkdir(\n parent: LocatorLike,\n name?: string,\n opts?: { expectedRevision?: string },\n ): Promise<{ ref: WireRef; existed: boolean; revision?: string }> {\n const args: Record<string, unknown> = {}\n if (name !== undefined) args.name = name\n if (opts?.expectedRevision) args.expected_revision = opts.expectedRevision\n return (await this.write('mkdir', { at: toLocator(parent), args })) as {\n ref: WireRef\n existed: boolean\n revision?: string\n }\n }\n\n async move(\n from: { parentRef: WireRef; name: string },\n to: { parentRef: WireRef; name: string },\n opts?: { expectedFromRevision?: string; expectedToRevision?: string },\n ): Promise<{ from_revision: string; to_revision: string }> {\n return (await this.write('move', {\n args: {\n from: { parent_ref: from.parentRef, name: from.name },\n to: { parent_ref: to.parentRef, name: to.name },\n expected_from_revision: opts?.expectedFromRevision,\n expected_to_revision: opts?.expectedToRevision,\n },\n })) as { from_revision: string; to_revision: string }\n }\n\n /** Destroys a native entry. Reference entries must use `unlink` instead. */\n async delete(\n parent: LocatorLike,\n name: string,\n opts?: { recursive?: boolean; expectedRevision?: string },\n ): Promise<{ revision: string }> {\n return (await this.write('delete', {\n at: toLocator(parent),\n args: {\n name,\n recursive: opts?.recursive,\n expected_revision: opts?.expectedRevision,\n },\n })) as { revision: string }\n }\n\n async bindRef(\n parentRef: WireRef,\n name: string,\n targetRef: WireRef,\n opts?: { expectedRevision?: string },\n ): Promise<{ entry_ref: string; revision: string }> {\n return (await this.write('bind_ref', {\n args: {\n parent_ref: parentRef,\n name,\n target_ref: targetRef,\n expected_revision: opts?.expectedRevision,\n },\n })) as { entry_ref: string; revision: string }\n }\n\n /** Removes a reference entry (`be_*`) only; the target is never touched. */\n async unlink(\n entryRef: string,\n opts?: { expectedRevision?: string },\n ): Promise<{ revision: string }> {\n return (await this.write('unlink', {\n args: { entry_ref: entryRef, expected_revision: opts?.expectedRevision },\n })) as { revision: string }\n }\n\n // ---------- content writes (open_write / tus / commit_file / probe) ----------\n\n async openWrite(\n target: { parentRef: WireRef; name: string; size?: number } | { ref: WireRef },\n ): Promise<OpenWriteResult> {\n const args: Record<string, unknown> =\n 'ref' in target\n ? { ref: target.ref }\n : { parent_ref: target.parentRef, name: target.name, size: target.size }\n return (await this.write('open_write', { args })) as OpenWriteResult\n }\n\n /** Current upload offset (tus HEAD) — resume point after interruption. */\n async uploadOffset(fbHandle: string): Promise<number> {\n const resp = await this.fetchFn(`${this.baseUrl}/nfs/v1/uploads/${fbHandle}`, {\n method: 'HEAD',\n headers: await this.authHeaders(),\n })\n if (!resp.ok) throw await this.httpError(resp)\n return Number(resp.headers.get('Upload-Offset') ?? '0')\n }\n\n /** One tus PATCH. Returns the new offset. */\n async uploadChunk(fbHandle: string, offset: number, chunk: Uint8Array): Promise<number> {\n const resp = await this.fetchFn(`${this.baseUrl}/nfs/v1/uploads/${fbHandle}`, {\n method: 'PATCH',\n headers: {\n ...await this.authHeaders(),\n 'Upload-Offset': String(offset),\n 'Content-Type': 'application/offset+octet-stream',\n },\n body: chunk as unknown as BodyInit,\n })\n if (resp.status !== 204) throw await this.httpError(resp)\n return Number(resp.headers.get('Upload-Offset') ?? String(offset + chunk.byteLength))\n }\n\n /** Uploads a whole buffer in chunks, resuming from the server's offset. */\n async uploadContent(\n fbHandle: string,\n content: Uint8Array,\n onProgress?: (sent: number, total: number) => void,\n ): Promise<void> {\n let offset = await this.uploadOffset(fbHandle)\n while (offset < content.byteLength) {\n const chunk = content.subarray(offset, Math.min(offset + this.chunkSize, content.byteLength))\n offset = await this.uploadChunk(fbHandle, offset, chunk)\n onProgress?.(offset, content.byteLength)\n }\n }\n\n async abortWrite(leaseId: string): Promise<void> {\n await this.write('abort_write', { args: { lease_id: leaseId } })\n }\n\n private async authHeaders(): Promise<Record<string, string>> {\n const token = await this.sessionToken?.()\n return token ? { Authorization: `Bearer ${token}` } : {}\n }\n\n async commitFile(\n parent: LocatorLike,\n name: string,\n source: { fbHandle: string; leaseId?: string } | { hash: string },\n opts?: { overwrite?: boolean; expectedRevision?: string },\n ): Promise<CommitResult> {\n const args: Record<string, unknown> = {\n name,\n overwrite: opts?.overwrite,\n expected_revision: opts?.expectedRevision,\n }\n if ('fbHandle' in source) {\n args.fb_handle = source.fbHandle\n if (source.leaseId) args.lease_id = source.leaseId\n } else {\n args.hash = source.hash\n }\n return (await this.write('commit_file', { at: toLocator(parent), args })) as CommitResult\n }\n\n /** Which of these digests must be uploaded (§ probe / 秒传). */\n async probe(digests: { hash: string; size?: number }[]): Promise<{ missing: { hash: string; size?: number }[] }> {\n return (await this.call('probe', { args: { digests } })) as {\n missing: { hash: string; size?: number }[]\n }\n }\n\n /**\n * Convenience: open_write + chunked tus upload + commit_file.\n * Overwrites an existing file only when `opts.overwrite` is set.\n */\n async uploadFile(\n parentRef: WireRef,\n name: string,\n content: Uint8Array,\n opts?: { overwrite?: boolean; onProgress?: (sent: number, total: number) => void },\n ): Promise<CommitResult> {\n const ow = await this.openWrite({ parentRef, name, size: content.byteLength })\n await this.uploadContent(ow.fb_handle, content, opts?.onProgress)\n return this.commitFile({ ref: parentRef }, name, {\n fbHandle: ow.fb_handle,\n leaseId: ow.lease.lease_id,\n }, { overwrite: opts?.overwrite })\n }\n\n // ---------- data plane read ----------\n\n /**\n * URL for `GET /nfs/v1/read/{node_id}` (usable in <img>, <a download>, …).\n * It carries no token: same-origin requests authenticate with the SSO cookie,\n * anything else only reads public paths.\n */\n readUrl(nodeId: string, opts?: { download?: boolean; name?: string }): string {\n const params = new URLSearchParams()\n if (opts?.download) params.set('download', '1')\n if (opts?.name) params.set('name', opts.name)\n const qs = params.size > 0 ? `?${params.toString()}` : ''\n return `${this.baseUrl}/nfs/v1/read/${encodeURIComponent(nodeId)}${qs}`\n }\n\n /** Reads file content; `range` is inclusive byte positions. */\n async readFile(\n nodeId: string,\n opts?: { range?: { start: number; end?: number }; ifNoneMatch?: string },\n ): Promise<Response> {\n const headers: Record<string, string> = await this.authHeaders()\n if (opts?.range) {\n headers.Range = `bytes=${opts.range.start}-${opts.range.end ?? ''}`\n }\n if (opts?.ifNoneMatch) headers['If-None-Match'] = opts.ifNoneMatch\n const resp = await this.fetchFn(this.readUrl(nodeId), { headers, cache: 'no-store' })\n if (!resp.ok && resp.status !== 304) throw await this.httpError(resp)\n return resp\n }\n\n // ---------- meta ----------\n\n async getMeta(target: LocatorLike, ns?: string[]): Promise<{ records: MetaRecord[] }> {\n const loc = toLocator(target)\n const args: Record<string, unknown> = { ns }\n if (loc.ref) args.ref = loc.ref\n return (await this.call('get_meta', { at: loc, args })) as { records: MetaRecord[] }\n }\n\n /** v1: only `ns: \"user\"` records are writable. */\n async setMeta(\n target: LocatorLike,\n records: { ns: string; key: string; value: unknown; visibility?: string }[],\n ): Promise<{ updated: number }> {\n const loc = toLocator(target)\n const args: Record<string, unknown> = { records }\n if (loc.ref) args.ref = loc.ref\n return (await this.write('set_meta', { at: loc, args })) as { updated: number }\n }\n\n // ---------- search ----------\n\n async search(\n q: string,\n opts?: { limit?: number; cursor?: string; scope?: LocatorLike; modes?: string[] },\n want?: WantGroup[],\n ): Promise<SearchResult> {\n return (await this.call('search', {\n want,\n args: {\n q,\n limit: opts?.limit,\n cursor: opts?.cursor,\n scope: opts?.scope !== undefined ? toLocator(opts.scope) : undefined,\n modes: opts?.modes,\n },\n })) as SearchResult\n }\n\n // ---------- views & collections ----------\n\n async openView(viewId: string, want?: WantGroup[]): Promise<NodeInfo> {\n return (await this.call('open_view', { want, args: { view_id: viewId } })) as NodeInfo\n }\n\n async createCollection(\n title: string,\n collectionId?: string,\n want?: WantGroup[],\n ): Promise<NodeInfo> {\n return (await this.write('create_collection', {\n want,\n args: { title, collection_id: collectionId },\n })) as NodeInfo\n }\n\n async openCollection(collectionId: string, want?: WantGroup[]): Promise<NodeInfo> {\n return (await this.call('open_collection', {\n want,\n args: { collection_id: collectionId },\n })) as NodeInfo\n }\n\n async collectionPatch(\n ref: WireRef,\n ops: CollectionPatchOp[],\n opts?: { expectedRevision?: string },\n ): Promise<{ revision: string }> {\n return (await this.write('collection_patch', {\n args: { ref, ops, expected_revision: opts?.expectedRevision },\n })) as { revision: string }\n }\n\n // ---------- grants ----------\n\n async grant(\n subtree: LocatorLike,\n opts?: { ops?: string[]; ttl?: number; audience?: string; maxUses?: number },\n ): Promise<GrantResult> {\n return (await this.write('grant', {\n args: {\n subtree: toLocator(subtree),\n ops: opts?.ops,\n ttl: opts?.ttl,\n audience: opts?.audience,\n max_uses: opts?.maxUses,\n },\n })) as GrantResult\n }\n\n async revoke(capId: string): Promise<{ revoked: string }> {\n return (await this.write('revoke', { args: { cap_id: capId } })) as { revoked: string }\n }\n\n // ---------- acl ----------\n\n async getAcl(at: LocatorLike): Promise<AclInfo> {\n return (await this.call('get_acl', { at: toLocator(at) })) as AclInfo\n }\n\n /** Replaces the node's own record; `inherit: true` with no entries removes it. */\n async setAcl(\n at: LocatorLike,\n acl: { inherit: boolean; entries: AclEntry[] },\n opts?: { expectedRevision?: string },\n ): Promise<{ path: string; revision: string }> {\n return (await this.write('set_acl', {\n at: toLocator(at),\n args: { inherit: acl.inherit, entries: acl.entries, expected_revision: opts?.expectedRevision },\n })) as { path: string; revision: string }\n }\n\n /** Every ACL record the caller may manage (all of them for the zone owner). */\n async listAcls(): Promise<{ records: AclRecordInfo[]; zone_owner: string | null; is_admin: boolean }> {\n return (await this.call('list_acls', {})) as { records: AclRecordInfo[]; zone_owner: string | null; is_admin: boolean }\n }\n\n // ---------- watch (SSE) ----------\n\n /**\n * Opens the watch stream. `tokens` filters to specific containers using the\n * `watch_token` returned by list. The stream is lossy by contract: on any\n * `resync` event, re-list watched containers.\n */\n watch(opts?: { tokens?: string[]; signal?: AbortSignal }): AsyncIterableIterator<WatchEvent> & {\n close: () => void\n } {\n if (!this.session) throw new Error('watch requires an active session; call hello() first')\n const params = new URLSearchParams({ session: this.session })\n if (opts?.tokens?.length) params.set('tokens', opts.tokens.join(','))\n const url = `${this.baseUrl}/nfs/v1/watch?${params.toString()}`\n const controller = new AbortController()\n if (opts?.signal) {\n opts.signal.addEventListener('abort', () => controller.abort(), { once: true })\n }\n const fetchFn = this.fetchFn\n const authHeaders = () => this.authHeaders()\n\n async function* events(): AsyncIterableIterator<WatchEvent> {\n const resp = await fetchFn(url, {\n headers: { ...await authHeaders(), Accept: 'text/event-stream' },\n signal: controller.signal,\n })\n if (!resp.ok || !resp.body) {\n throw new Error(`watch failed: HTTP ${resp.status}`)\n }\n const reader = resp.body.getReader()\n const decoder = new TextDecoder()\n let buf = ''\n try {\n for (;;) {\n const { done, value } = await reader.read()\n if (done) return\n buf += decoder.decode(value, { stream: true })\n // SSE frames are separated by a blank line.\n for (;;) {\n const sep = buf.indexOf('\\n\\n')\n if (sep < 0) break\n const frame = buf.slice(0, sep)\n buf = buf.slice(sep + 2)\n let event = 'message'\n let id: string | undefined\n const dataLines: string[] = []\n for (const line of frame.split('\\n')) {\n if (line.startsWith('event:')) event = line.slice(6).trim()\n else if (line.startsWith('data:')) dataLines.push(line.slice(5).trim())\n else if (line.startsWith('id:')) id = line.slice(3).trim()\n // comment lines (`:keep-alive`) are ignored\n }\n if (dataLines.length === 0 && event === 'message') continue\n let data: Record<string, unknown> = {}\n if (dataLines.length > 0) {\n try {\n data = JSON.parse(dataLines.join('\\n')) as Record<string, unknown>\n } catch {\n data = { raw: dataLines.join('\\n') }\n }\n }\n yield { event, data, id }\n }\n }\n } finally {\n reader.cancel().catch(() => {})\n }\n }\n\n const it = events() as AsyncIterableIterator<WatchEvent> & { close: () => void }\n it.close = () => controller.abort()\n return it\n }\n\n // ---------- envelope plumbing ----------\n\n /** Read-path call: no seq. Throws NfspError on `ok:false`. */\n async call(method: string, extras: EnvelopeExtras): Promise<unknown> {\n return this.post(method, this.envelope(extras))\n }\n\n /**\n * Write-path call: assigns the next seq once and reuses it across network\n * retries so the server's replay window guarantees exactly-once.\n */\n async write(method: string, extras: EnvelopeExtras, retries = 2): Promise<unknown> {\n const seq = ++this.seq\n const body = { ...this.envelope(extras), seq }\n let lastErr: unknown\n for (let attempt = 0; attempt <= retries; attempt++) {\n try {\n return await this.post(method, body)\n } catch (e) {\n // Only network-level failures are retried (same seq → replay-safe).\n // NfspError means the server answered: propagate immediately.\n if (e instanceof NfspError) throw e\n lastErr = e\n }\n }\n throw lastErr\n }\n\n private envelope(extras: EnvelopeExtras): Record<string, unknown> {\n const body: Record<string, unknown> = { args: pruneUndefined(extras.args ?? {}) }\n if (this.session) body.session = this.session\n if (extras.at) body.at = pruneUndefined(extras.at as unknown as Record<string, unknown>)\n if (extras.want) body.want = extras.want\n return body\n }\n\n private async post(method: string, body: Record<string, unknown>): Promise<unknown> {\n const token = await this.sessionToken?.()\n const resp = await this.fetchFn(`${this.baseUrl}/nfs/v1/${method}`, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json', ...(token ? { Authorization: `Bearer ${token}` } : {}) },\n body: JSON.stringify(body),\n })\n let parsed: { ok?: boolean; result?: unknown; error?: NfspErrorBody }\n try {\n parsed = (await resp.json()) as typeof parsed\n } catch {\n throw new NfspError(\n { code: 'INTERNAL', message: `non-JSON response (HTTP ${resp.status})` },\n resp.status,\n )\n }\n if (parsed.ok !== true) {\n throw new NfspError(\n parsed.error ?? { code: 'INTERNAL', message: 'malformed error envelope' },\n resp.status,\n )\n }\n return parsed.result\n }\n\n private async httpError(resp: Response): Promise<NfspError> {\n try {\n const parsed = (await resp.json()) as { error?: NfspErrorBody }\n if (parsed.error) return new NfspError(parsed.error, resp.status)\n } catch {\n // fall through\n }\n return new NfspError({ code: 'INTERNAL', message: `HTTP ${resp.status}` }, resp.status)\n }\n}\n\n/** Drops undefined values so they don't serialize as JSON nulls. */\nconst pruneUndefined = (obj: Record<string, unknown>): Record<string, unknown> => {\n const out: Record<string, unknown> = {}\n for (const [k, v] of Object.entries(obj)) {\n if (v !== undefined) out[k] = v\n }\n return out\n}\n"],"names":["NFSP_VERSION","toLocator","at","includes","uri","realm","path","ref","NfspError","Error","constructor","body","httpStatus","super","code","message","this","name","details","Object","fromEntries","entries","filter","key","pruneUndefined","obj","out","k","v","opts","session","seq","helloResult","sessionToken","baseUrl","replace","fetchFn","fetch","input","init","globalThis","chunkSize","uploadChunkSize","sessionId","features","_a","limits","hello","clientFeatures","args","versions","r","post","bye","call","resolve","want","stat","list","batch","start","ops","onError","on_error","mkdir","parent","expectedRevision","expected_revision","write","move","from","to","parent_ref","parentRef","expected_from_revision","expectedFromRevision","expected_to_revision","expectedToRevision","recursive","bindRef","targetRef","target_ref","unlink","entryRef","entry_ref","openWrite","target","size","uploadOffset","fbHandle","resp","method","headers","authHeaders","ok","httpError","Number","get","uploadChunk","offset","chunk","String","status","byteLength","uploadContent","content","onProgress","subarray","Math","min","abortWrite","leaseId","lease_id","token","Authorization","commitFile","source","overwrite","fb_handle","hash","probe","digests","uploadFile","ow","lease","readUrl","nodeId","params","URLSearchParams","download","set","qs","toString","encodeURIComponent","readFile","range","Range","end","ifNoneMatch","cache","getMeta","ns","loc","setMeta","records","search","q","limit","cursor","scope","modes","openView","viewId","view_id","createCollection","title","collectionId","collection_id","openCollection","collectionPatch","grant","subtree","ttl","audience","max_uses","maxUses","revoke","capId","cap_id","getAcl","setAcl","acl","inherit","listAcls","watch","tokens","length","join","url","controller","AbortController","signal","addEventListener","abort","once","it","async","Accept","reader","getReader","decoder","TextDecoder","buf","done","value","read","decode","stream","sep","indexOf","frame","slice","id","event","dataLines","line","split","startsWith","trim","push","data","JSON","parse","raw","cancel","catch","events","close","extras","envelope","retries","lastErr","attempt","e","stringify","parsed","json","error","result","gen","type","node_id"],"mappings":"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"}
package/dist/nfsp.d.ts CHANGED
@@ -47,6 +47,47 @@ export type LocatorLike = string | WireRef | Locator;
47
47
  export declare const toLocator: (at: LocatorLike) => Locator;
48
48
  export type WantGroup = 'base' | 'ident' | 'access' | 'meta';
49
49
  export type NodeKind = 'dir' | 'file' | 'symlink' | 'view' | 'collection' | 'group';
50
+ /**
51
+ * The caller's effective permission on a node. `traverse` = only the way to
52
+ * something shared deeper down: listable, but only those children are shown.
53
+ */
54
+ export type AccessLevel = 'none' | 'traverse' | 'read' | 'write' | 'manage';
55
+ /** `user:<user_id>`, `zone_users` (any signed-in user) or `public` (anyone, read only). */
56
+ export type AclPrincipal = `user:${string}` | 'zone_users' | 'public';
57
+ export interface AclEntry {
58
+ principal: AclPrincipal;
59
+ level: Exclude<AccessLevel, 'none' | 'traverse'>;
60
+ }
61
+ /** `get_acl` result; the entry lists only appear for callers who may manage. */
62
+ export interface AclInfo {
63
+ path: string;
64
+ access_level: AccessLevel;
65
+ can_manage: boolean;
66
+ revision: string;
67
+ inherit?: boolean;
68
+ entries?: AclEntry[];
69
+ /** Grants arriving from ancestors, with the directory they come from. */
70
+ inherited?: (AclEntry & {
71
+ from: string;
72
+ })[];
73
+ /** Built-in rules (zone owner, home owner) that no record can remove. */
74
+ builtin?: (AclEntry & {
75
+ reason: 'zone_owner' | 'home_owner';
76
+ })[];
77
+ updated_by?: string;
78
+ updated_at?: number;
79
+ }
80
+ export interface AclRecordInfo {
81
+ path: string;
82
+ inherit: boolean;
83
+ entries: AclEntry[];
84
+ home_owner: string | null;
85
+ updated_by: string;
86
+ updated_at: number;
87
+ revision: string;
88
+ /** The path no longer exists (removed outside the protocol). */
89
+ missing: boolean;
90
+ }
50
91
  export interface Capabilities {
51
92
  list: boolean;
52
93
  read: boolean;
@@ -62,6 +103,7 @@ export interface NodeInfo {
62
103
  ref: WireRef;
63
104
  copy_ref?: WireRef | null;
64
105
  capabilities: Capabilities;
106
+ access_level?: AccessLevel;
65
107
  revision?: string;
66
108
  locations?: unknown[];
67
109
  name?: string;
@@ -102,8 +144,9 @@ export interface EntryTarget {
102
144
  url: string;
103
145
  }[];
104
146
  } & Record<string, unknown>;
105
- /** `stale` when a referenced target no longer resolves. */
147
+ /** `stale` when a referenced target no longer resolves, `denied` when the caller may not see it. */
106
148
  target_state?: string;
149
+ access_level?: AccessLevel;
107
150
  }
108
151
  export interface Entry {
109
152
  name: string;
@@ -154,6 +197,11 @@ export interface HelloResult {
154
197
  id: string;
155
198
  writable: boolean;
156
199
  }[];
200
+ /** Who this session acts as (`admin` = the zone owner or a trusted service). */
201
+ identity?: {
202
+ user_id: string | null;
203
+ role: 'admin' | 'user' | 'anonymous';
204
+ };
157
205
  }
158
206
  export type BatchOp = {
159
207
  m: 'walk';
@@ -410,7 +458,11 @@ export declare class NfspClient {
410
458
  overwrite?: boolean;
411
459
  onProgress?: (sent: number, total: number) => void;
412
460
  }): Promise<CommitResult>;
413
- /** URL for `GET /nfs/v1/read/{node_id}` (usable in <img>, <a download>, …). */
461
+ /**
462
+ * URL for `GET /nfs/v1/read/{node_id}` (usable in <img>, <a download>, …).
463
+ * It carries no token: same-origin requests authenticate with the SSO cookie,
464
+ * anything else only reads public paths.
465
+ */
414
466
  readUrl(nodeId: string, opts?: {
415
467
  download?: boolean;
416
468
  name?: string;
@@ -458,6 +510,23 @@ export declare class NfspClient {
458
510
  revoke(capId: string): Promise<{
459
511
  revoked: string;
460
512
  }>;
513
+ getAcl(at: LocatorLike): Promise<AclInfo>;
514
+ /** Replaces the node's own record; `inherit: true` with no entries removes it. */
515
+ setAcl(at: LocatorLike, acl: {
516
+ inherit: boolean;
517
+ entries: AclEntry[];
518
+ }, opts?: {
519
+ expectedRevision?: string;
520
+ }): Promise<{
521
+ path: string;
522
+ revision: string;
523
+ }>;
524
+ /** Every ACL record the caller may manage (all of them for the zone owner). */
525
+ listAcls(): Promise<{
526
+ records: AclRecordInfo[];
527
+ zone_owner: string | null;
528
+ is_admin: boolean;
529
+ }>;
461
530
  /**
462
531
  * Opens the watch stream. `tokens` filters to specific containers using the
463
532
  * `watch_token` returned by list. The stream is lossy by contract: on any
@@ -1 +1 @@
1
- {"version":3,"file":"nfsp.d.ts","sourceRoot":"","sources":["../src/nfsp.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"nfsp.d.ts","sourceRoot":"","sources":["../src/nfsp.ts"],"names":[],"mappings":"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"}
package/dist/nfsp.mjs CHANGED
@@ -215,7 +215,11 @@ class NfspClient {
215
215
  }, { overwrite: opts == null ? void 0 : opts.overwrite });
216
216
  }
217
217
  // ---------- data plane read ----------
218
- /** URL for `GET /nfs/v1/read/{node_id}` (usable in <img>, <a download>, …). */
218
+ /**
219
+ * URL for `GET /nfs/v1/read/{node_id}` (usable in <img>, <a download>, …).
220
+ * It carries no token: same-origin requests authenticate with the SSO cookie,
221
+ * anything else only reads public paths.
222
+ */
219
223
  readUrl(nodeId, opts) {
220
224
  const params = new URLSearchParams();
221
225
  if (opts == null ? void 0 : opts.download)
@@ -303,6 +307,21 @@ class NfspClient {
303
307
  async revoke(capId) {
304
308
  return await this.write("revoke", { args: { cap_id: capId } });
305
309
  }
310
+ // ---------- acl ----------
311
+ async getAcl(at) {
312
+ return await this.call("get_acl", { at: toLocator(at) });
313
+ }
314
+ /** Replaces the node's own record; `inherit: true` with no entries removes it. */
315
+ async setAcl(at, acl, opts) {
316
+ return await this.write("set_acl", {
317
+ at: toLocator(at),
318
+ args: { inherit: acl.inherit, entries: acl.entries, expected_revision: opts == null ? void 0 : opts.expectedRevision }
319
+ });
320
+ }
321
+ /** Every ACL record the caller may manage (all of them for the zone owner). */
322
+ async listAcls() {
323
+ return await this.call("list_acls", {});
324
+ }
306
325
  // ---------- watch (SSE) ----------
307
326
  /**
308
327
  * Opens the watch stream. `tokens` filters to specific containers using the