buckyos 0.7.126 → 0.7.128

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/cli/dist/cli.mjs +116 -31
  2. package/cli/dist/cli.mjs.map +1 -1
  3. package/cli/launcher.mjs +0 -0
  4. package/cli/modules/pikg.ts +5 -0
  5. package/cli/modules/pikg_protocol.ts +40 -0
  6. package/cli/runtime/host_deno.ts +16 -31
  7. package/cli/runtime/host_node.ts +15 -30
  8. package/cli/runtime/path_policy.ts +49 -0
  9. package/cli/version.ts +1 -1
  10. package/dist/aicc_client.d.ts +1 -0
  11. package/dist/aicc_client.d.ts.map +1 -1
  12. package/dist/app-frame.cjs +2 -0
  13. package/dist/app-frame.cjs.map +1 -0
  14. package/dist/app-frame.d.ts +82 -0
  15. package/dist/app-frame.d.ts.map +1 -0
  16. package/dist/app-frame.mjs +189 -0
  17. package/dist/app-frame.mjs.map +1 -0
  18. package/dist/browser.cjs +1 -1
  19. package/dist/browser.mjs +2 -2
  20. package/dist/content.cjs +2 -0
  21. package/dist/content.cjs.map +1 -0
  22. package/dist/content.d.ts +148 -0
  23. package/dist/content.d.ts.map +1 -0
  24. package/dist/content.mjs +361 -0
  25. package/dist/content.mjs.map +1 -0
  26. package/dist/content_mime.d.ts +4 -0
  27. package/dist/content_mime.d.ts.map +1 -0
  28. package/dist/index.cjs +1 -1
  29. package/dist/index.mjs +2 -2
  30. package/dist/msg_queue_client.d.ts +2 -0
  31. package/dist/msg_queue_client.d.ts.map +1 -1
  32. package/dist/{ndm_proxy-54e7d13f.mjs → ndm_proxy-3caceb0a.mjs} +8 -3
  33. package/dist/ndm_proxy-3caceb0a.mjs.map +1 -0
  34. package/dist/{ndm_proxy-52a07229.js → ndm_proxy-d37a0204.js} +2 -2
  35. package/dist/ndm_proxy-d37a0204.js.map +1 -0
  36. package/dist/nfsp.cjs +2 -0
  37. package/dist/nfsp.cjs.map +1 -0
  38. package/dist/nfsp.d.ts +484 -0
  39. package/dist/nfsp.d.ts.map +1 -0
  40. package/dist/nfsp.mjs +466 -0
  41. package/dist/nfsp.mjs.map +1 -0
  42. package/dist/node.cjs +1 -1
  43. package/dist/node.mjs +2 -2
  44. package/dist/runtime.d.ts.map +1 -1
  45. package/package.json +18 -2
  46. package/dist/ndm_proxy-52a07229.js.map +0 -1
  47. package/dist/ndm_proxy-54e7d13f.mjs.map +0 -1
package/dist/nfsp.cjs ADDED
@@ -0,0 +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;
2
+ //# sourceMappingURL=nfsp.cjs.map
@@ -0,0 +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":"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"}
package/dist/nfsp.d.ts ADDED
@@ -0,0 +1,484 @@
1
+ /**
2
+ * NFSP v0 client for nfs_server (buckyos/src/frame/nfs_server).
3
+ *
4
+ * Speaks the control plane (`POST /nfs/v1/{method}`), the data plane
5
+ * (`GET /nfs/v1/read/{node_id}`), the minimal tus upload area
6
+ * (`PATCH|HEAD /nfs/v1/uploads/{fb}`) and the watch SSE stream
7
+ * (`GET /nfs/v1/watch`).
8
+ *
9
+ * Protocol references:
10
+ * - cyfs-ndn/doc/NamedFileSystem_Protocol_v0.md (NFSP v0)
11
+ * - buckyos/product/bucky_file/nfs_server.md
12
+ * - buckyos/src/frame/nfs_server/README.md (v1 降级契约)
13
+ *
14
+ * Client contract highlights (nfs_server README §4.2):
15
+ * - `revision` is an opaque equality token: only compare, never order.
16
+ * - Write ops require `seq` (exactly-once); the client auto-assigns one per
17
+ * write and replays with the SAME seq on network retry.
18
+ * - Leases are advisory versus server-local bypass writers: commit may fail
19
+ * with TARGET_MISMATCH{reason:"bypass_modified"} — surface, don't retry.
20
+ * - watch is lossy: any `resync` event means "re-list what you care about".
21
+ *
22
+ * Uses only fetch/WHATWG streams, so it runs in the browser and in Node ≥ 18.
23
+ */
24
+ export declare const NFSP_VERSION = "nfsp/0";
25
+ /** `{"type":"live",...}` or `{"type":"object",...}` (NFSP §3.1.2). */
26
+ export type LiveRef = {
27
+ type: 'live';
28
+ node_id: string;
29
+ gen?: number;
30
+ };
31
+ export type ObjectRef = {
32
+ type: 'object';
33
+ obj_id: string;
34
+ inner_path?: string;
35
+ };
36
+ export type WireRef = LiveRef | ObjectRef;
37
+ export declare const liveRef: (nodeId: string, gen?: number) => LiveRef;
38
+ /** The `at` locator: ref > uri > path (NFSP §3.4). */
39
+ export interface Locator {
40
+ realm?: string;
41
+ path?: string;
42
+ uri?: string;
43
+ ref?: WireRef;
44
+ }
45
+ /** Sugar: accept a dfs path string, a `xxx://` uri, a WireRef or a Locator. */
46
+ export type LocatorLike = string | WireRef | Locator;
47
+ export declare const toLocator: (at: LocatorLike) => Locator;
48
+ export type WantGroup = 'base' | 'ident' | 'access' | 'meta';
49
+ export type NodeKind = 'dir' | 'file' | 'symlink' | 'view' | 'collection' | 'group';
50
+ export interface Capabilities {
51
+ list: boolean;
52
+ read: boolean;
53
+ accepts_content: boolean;
54
+ accepts_references: boolean;
55
+ remove_semantics: 'destroy' | 'unlink' | 'none';
56
+ ordered: boolean;
57
+ }
58
+ /** resolve/stat result (fields beyond `base` appear per the `want` mask). */
59
+ export interface NodeInfo {
60
+ kind: NodeKind;
61
+ state: string;
62
+ ref: WireRef;
63
+ copy_ref?: WireRef | null;
64
+ capabilities: Capabilities;
65
+ revision?: string;
66
+ locations?: unknown[];
67
+ name?: string;
68
+ size?: number;
69
+ mtime?: number;
70
+ ctime?: number;
71
+ flags?: string[];
72
+ node_id?: string;
73
+ gen?: number;
74
+ etag?: string;
75
+ obj_id?: string;
76
+ access_urls?: {
77
+ kind: string;
78
+ url: string;
79
+ }[];
80
+ meta_summary?: Record<string, number>;
81
+ view_id?: string;
82
+ collection_id?: string;
83
+ title?: string;
84
+ origin?: string;
85
+ stale?: boolean;
86
+ }
87
+ export type EntryBinding = 'native' | 'reference' | 'member' | 'derived';
88
+ /** Compact target of a listing entry (not a full NodeInfo). */
89
+ export interface EntryTarget {
90
+ ref: WireRef;
91
+ copy_ref?: WireRef | null;
92
+ kind: NodeKind;
93
+ /** Attribute groups per the `want` mask: base → size/mtime/flags, ident → etag/obj_id, access → access_urls. */
94
+ attrs?: {
95
+ size?: number;
96
+ mtime?: number;
97
+ flags?: string[];
98
+ etag?: string;
99
+ obj_id?: string;
100
+ access_urls?: {
101
+ kind: string;
102
+ url: string;
103
+ }[];
104
+ } & Record<string, unknown>;
105
+ /** `stale` when a referenced target no longer resolves. */
106
+ target_state?: string;
107
+ }
108
+ export interface Entry {
109
+ name: string;
110
+ binding: EntryBinding;
111
+ entry_ref?: string;
112
+ target: EntryTarget;
113
+ canonical_path?: string;
114
+ context?: {
115
+ count?: number;
116
+ provenance?: Record<string, unknown>;
117
+ } & Record<string, unknown>;
118
+ }
119
+ export interface Listing {
120
+ container: NodeInfo;
121
+ entries: Entry[];
122
+ truncated?: boolean;
123
+ next_cursor?: string;
124
+ revision_changed?: boolean;
125
+ watch_token?: string;
126
+ /** Same-name virtual bindings shadowed by native entries (`native_shadow`). */
127
+ conflicts?: {
128
+ name: string;
129
+ reason: string;
130
+ entry_ref?: string;
131
+ target?: EntryTarget;
132
+ }[];
133
+ }
134
+ export interface ListOptions {
135
+ cursor?: string;
136
+ limit?: number;
137
+ order?: 'name' | 'mtime' | 'size' | 'manual';
138
+ filter?: {
139
+ kind?: NodeKind[];
140
+ name_glob?: string;
141
+ };
142
+ }
143
+ export interface HelloResult {
144
+ version: string;
145
+ session: string;
146
+ features: string[];
147
+ limits: {
148
+ max_batch: number;
149
+ max_list: number;
150
+ replay_window: number;
151
+ attr_ttl_ms: number;
152
+ };
153
+ realms: {
154
+ id: string;
155
+ writable: boolean;
156
+ }[];
157
+ }
158
+ export type BatchOp = {
159
+ m: 'walk';
160
+ args: {
161
+ name?: string;
162
+ names?: string[];
163
+ entry_ref?: string;
164
+ };
165
+ } | {
166
+ m: 'stat' | 'resolve';
167
+ args?: {
168
+ name?: string;
169
+ };
170
+ want?: WantGroup[];
171
+ } | {
172
+ m: 'list';
173
+ args?: ListOptions;
174
+ want?: WantGroup[];
175
+ };
176
+ export interface BatchResult {
177
+ completed: number;
178
+ results: ({
179
+ ok: true;
180
+ result: unknown;
181
+ } | {
182
+ ok: false;
183
+ error: NfspErrorBody;
184
+ })[];
185
+ }
186
+ export interface OpenWriteResult {
187
+ fb_handle: string;
188
+ upload_url: string;
189
+ lease: {
190
+ lease_id: string;
191
+ seq: number;
192
+ ttl_ms: number;
193
+ };
194
+ target: {
195
+ path: string;
196
+ exists: boolean;
197
+ };
198
+ }
199
+ export interface CommitResult {
200
+ ref: WireRef;
201
+ entry_ref: string;
202
+ revision: string;
203
+ obj: {
204
+ sha256: string;
205
+ size: number;
206
+ };
207
+ }
208
+ export interface MetaRecord {
209
+ ns: string;
210
+ key: string;
211
+ value: unknown;
212
+ source?: unknown;
213
+ confidence?: number;
214
+ anchor?: string;
215
+ visibility?: string;
216
+ }
217
+ export interface SearchHit {
218
+ copy_ref?: WireRef | null;
219
+ match_source: string;
220
+ canonical_path: string;
221
+ explain?: Record<string, unknown>;
222
+ [k: string]: unknown;
223
+ }
224
+ export interface SearchResult {
225
+ hits: SearchHit[];
226
+ partial: boolean;
227
+ sources: {
228
+ mode: string;
229
+ state: string;
230
+ took_ms?: number;
231
+ reason?: string;
232
+ }[];
233
+ next_cursor?: string;
234
+ }
235
+ export interface GrantResult {
236
+ cap_id: string;
237
+ token: string;
238
+ subtree: string;
239
+ ops: string[];
240
+ expires_at?: number;
241
+ }
242
+ export type CollectionPatchOp = {
243
+ add_ref: {
244
+ target_ref: WireRef;
245
+ name?: string;
246
+ position?: number;
247
+ parent_entry_ref?: string;
248
+ };
249
+ } | {
250
+ remove_entry: {
251
+ entry_ref: string;
252
+ };
253
+ } | {
254
+ move_entries: {
255
+ entry_refs: string[];
256
+ to_index: number;
257
+ };
258
+ } | {
259
+ create_group: {
260
+ name: string;
261
+ position?: number;
262
+ };
263
+ } | {
264
+ rename_group: {
265
+ entry_ref: string;
266
+ name: string;
267
+ };
268
+ };
269
+ export interface WatchEvent {
270
+ /** `resync` | `container_changed` | `meta_changed` (extensible). */
271
+ event: string;
272
+ /** Parsed JSON payload of the SSE `data:` line. */
273
+ data: Record<string, unknown>;
274
+ /** SSE `id:` (the server_rev), when present. */
275
+ id?: string;
276
+ }
277
+ /** Structured NFSP error body (§8 plus implementation extensions). */
278
+ export interface NfspErrorBody {
279
+ code: string;
280
+ message: string;
281
+ [k: string]: unknown;
282
+ }
283
+ export declare class NfspError extends Error {
284
+ readonly code: string;
285
+ readonly httpStatus: number;
286
+ /** Extra structured fields (reason, holder_session, obj_id, expected, ...). */
287
+ readonly details: Record<string, unknown>;
288
+ constructor(body: NfspErrorBody, httpStatus: number);
289
+ }
290
+ export interface NfspClientOptions {
291
+ sessionToken?: () => Promise<string | null>;
292
+ /** e.g. `http://127.0.0.1:3260` — no trailing slash needed. */
293
+ baseUrl: string;
294
+ /** Override fetch (tests, custom auth wrappers). Defaults to global fetch. */
295
+ fetch?: typeof fetch;
296
+ /** tus PATCH chunk size; server guidance is 4–16 MB. Default 8 MB. */
297
+ uploadChunkSize?: number;
298
+ }
299
+ interface EnvelopeExtras {
300
+ at?: Locator;
301
+ want?: WantGroup[];
302
+ args?: Record<string, unknown>;
303
+ }
304
+ export declare class NfspClient {
305
+ private readonly sessionToken?;
306
+ readonly baseUrl: string;
307
+ private readonly fetchFn;
308
+ private readonly chunkSize;
309
+ private session;
310
+ private seq;
311
+ private helloResult;
312
+ constructor(opts: NfspClientOptions);
313
+ get sessionId(): string | null;
314
+ /** Features advertised by the server in hello (empty before hello). */
315
+ get features(): string[];
316
+ get limits(): HelloResult['limits'] | null;
317
+ hello(clientFeatures?: string[]): Promise<HelloResult>;
318
+ bye(): Promise<void>;
319
+ resolve(at: LocatorLike, want?: WantGroup[]): Promise<NodeInfo>;
320
+ /** stat with an optional child `name` step (server-side walk). */
321
+ stat(at: LocatorLike, opts?: {
322
+ name?: string;
323
+ want?: WantGroup[];
324
+ }): Promise<NodeInfo>;
325
+ list(at: LocatorLike, opts?: ListOptions, want?: WantGroup[]): Promise<Listing>;
326
+ batch(start: LocatorLike, ops: BatchOp[], onError?: 'abort' | 'continue'): Promise<BatchResult>;
327
+ /**
328
+ * Ref form: create one child under `parent` (optional CAS via
329
+ * `expectedRevision`). Path form: pass a dfs path string and no name —
330
+ * behaves like `mkdir -p` (idempotent, no CAS).
331
+ */
332
+ mkdir(parent: LocatorLike, name?: string, opts?: {
333
+ expectedRevision?: string;
334
+ }): Promise<{
335
+ ref: WireRef;
336
+ existed: boolean;
337
+ revision?: string;
338
+ }>;
339
+ move(from: {
340
+ parentRef: WireRef;
341
+ name: string;
342
+ }, to: {
343
+ parentRef: WireRef;
344
+ name: string;
345
+ }, opts?: {
346
+ expectedFromRevision?: string;
347
+ expectedToRevision?: string;
348
+ }): Promise<{
349
+ from_revision: string;
350
+ to_revision: string;
351
+ }>;
352
+ /** Destroys a native entry. Reference entries must use `unlink` instead. */
353
+ delete(parent: LocatorLike, name: string, opts?: {
354
+ recursive?: boolean;
355
+ expectedRevision?: string;
356
+ }): Promise<{
357
+ revision: string;
358
+ }>;
359
+ bindRef(parentRef: WireRef, name: string, targetRef: WireRef, opts?: {
360
+ expectedRevision?: string;
361
+ }): Promise<{
362
+ entry_ref: string;
363
+ revision: string;
364
+ }>;
365
+ /** Removes a reference entry (`be_*`) only; the target is never touched. */
366
+ unlink(entryRef: string, opts?: {
367
+ expectedRevision?: string;
368
+ }): Promise<{
369
+ revision: string;
370
+ }>;
371
+ openWrite(target: {
372
+ parentRef: WireRef;
373
+ name: string;
374
+ size?: number;
375
+ } | {
376
+ ref: WireRef;
377
+ }): Promise<OpenWriteResult>;
378
+ /** Current upload offset (tus HEAD) — resume point after interruption. */
379
+ uploadOffset(fbHandle: string): Promise<number>;
380
+ /** One tus PATCH. Returns the new offset. */
381
+ uploadChunk(fbHandle: string, offset: number, chunk: Uint8Array): Promise<number>;
382
+ /** Uploads a whole buffer in chunks, resuming from the server's offset. */
383
+ uploadContent(fbHandle: string, content: Uint8Array, onProgress?: (sent: number, total: number) => void): Promise<void>;
384
+ abortWrite(leaseId: string): Promise<void>;
385
+ private authHeaders;
386
+ commitFile(parent: LocatorLike, name: string, source: {
387
+ fbHandle: string;
388
+ leaseId?: string;
389
+ } | {
390
+ hash: string;
391
+ }, opts?: {
392
+ overwrite?: boolean;
393
+ expectedRevision?: string;
394
+ }): Promise<CommitResult>;
395
+ /** Which of these digests must be uploaded (§ probe / 秒传). */
396
+ probe(digests: {
397
+ hash: string;
398
+ size?: number;
399
+ }[]): Promise<{
400
+ missing: {
401
+ hash: string;
402
+ size?: number;
403
+ }[];
404
+ }>;
405
+ /**
406
+ * Convenience: open_write + chunked tus upload + commit_file.
407
+ * Overwrites an existing file only when `opts.overwrite` is set.
408
+ */
409
+ uploadFile(parentRef: WireRef, name: string, content: Uint8Array, opts?: {
410
+ overwrite?: boolean;
411
+ onProgress?: (sent: number, total: number) => void;
412
+ }): Promise<CommitResult>;
413
+ /** URL for `GET /nfs/v1/read/{node_id}` (usable in <img>, <a download>, …). */
414
+ readUrl(nodeId: string, opts?: {
415
+ download?: boolean;
416
+ name?: string;
417
+ }): string;
418
+ /** Reads file content; `range` is inclusive byte positions. */
419
+ readFile(nodeId: string, opts?: {
420
+ range?: {
421
+ start: number;
422
+ end?: number;
423
+ };
424
+ ifNoneMatch?: string;
425
+ }): Promise<Response>;
426
+ getMeta(target: LocatorLike, ns?: string[]): Promise<{
427
+ records: MetaRecord[];
428
+ }>;
429
+ /** v1: only `ns: "user"` records are writable. */
430
+ setMeta(target: LocatorLike, records: {
431
+ ns: string;
432
+ key: string;
433
+ value: unknown;
434
+ visibility?: string;
435
+ }[]): Promise<{
436
+ updated: number;
437
+ }>;
438
+ search(q: string, opts?: {
439
+ limit?: number;
440
+ cursor?: string;
441
+ scope?: LocatorLike;
442
+ modes?: string[];
443
+ }, want?: WantGroup[]): Promise<SearchResult>;
444
+ openView(viewId: string, want?: WantGroup[]): Promise<NodeInfo>;
445
+ createCollection(title: string, collectionId?: string, want?: WantGroup[]): Promise<NodeInfo>;
446
+ openCollection(collectionId: string, want?: WantGroup[]): Promise<NodeInfo>;
447
+ collectionPatch(ref: WireRef, ops: CollectionPatchOp[], opts?: {
448
+ expectedRevision?: string;
449
+ }): Promise<{
450
+ revision: string;
451
+ }>;
452
+ grant(subtree: LocatorLike, opts?: {
453
+ ops?: string[];
454
+ ttl?: number;
455
+ audience?: string;
456
+ maxUses?: number;
457
+ }): Promise<GrantResult>;
458
+ revoke(capId: string): Promise<{
459
+ revoked: string;
460
+ }>;
461
+ /**
462
+ * Opens the watch stream. `tokens` filters to specific containers using the
463
+ * `watch_token` returned by list. The stream is lossy by contract: on any
464
+ * `resync` event, re-list watched containers.
465
+ */
466
+ watch(opts?: {
467
+ tokens?: string[];
468
+ signal?: AbortSignal;
469
+ }): AsyncIterableIterator<WatchEvent> & {
470
+ close: () => void;
471
+ };
472
+ /** Read-path call: no seq. Throws NfspError on `ok:false`. */
473
+ call(method: string, extras: EnvelopeExtras): Promise<unknown>;
474
+ /**
475
+ * Write-path call: assigns the next seq once and reuses it across network
476
+ * retries so the server's replay window guarantees exactly-once.
477
+ */
478
+ write(method: string, extras: EnvelopeExtras, retries?: number): Promise<unknown>;
479
+ private envelope;
480
+ private post;
481
+ private httpError;
482
+ }
483
+ export {};
484
+ //# sourceMappingURL=nfsp.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"nfsp.d.ts","sourceRoot":"","sources":["../src/nfsp.ts"],"names":[],"mappings":"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"}