@fkn/lib 0.5.5 → 0.6.1

package/opfs/promises.d.ts

@@ -1,67 +1,12 @@
-import * as node_fs from 'node:fs';
+import { a as WriteData, i as Stats, n as MakeOptions, o as WriteOptions, r as ReadOptions } from "../index-C6ZoDJg8.js";
+import { promises } from "../opfs.js";
 
-type ReadOptions = BufferEncoding | {
-    encoding?: BufferEncoding | null;
-    flag?: string;
-} | null | undefined;
-type WriteOptions = BufferEncoding | {
-    encoding?: BufferEncoding | null;
-    mode?: number;
-    flag?: string;
-    contentType?: string;
-} | null | undefined;
-type WriteData = string | Uint8Array | ArrayBuffer | DataView;
-type MakeOptions = {
-    recursive?: boolean;
-} | number | null | undefined;
-type Stats = {
-    size: number;
-    mtimeMs: number;
-    mtime: Date;
-    atimeMs: number;
-    ctimeMs: number;
-    mode: number;
-    isFile: () => boolean;
-    isDirectory: () => boolean;
-    isSymbolicLink: () => boolean;
-};
-
-declare const promises: {
-    readFile: (path: node_fs.PathLike, options?: ReadOptions) => Promise<Buffer | string>;
-    writeFile: (path: node_fs.PathLike, data: WriteData, options?: WriteOptions) => Promise<void>;
-    appendFile: (path: node_fs.PathLike, data: WriteData, options?: WriteOptions) => Promise<void>;
-    stat: (path: node_fs.PathLike) => Promise<Stats>;
-    lstat: (path: node_fs.PathLike) => Promise<Stats>;
-    readdir: (path: node_fs.PathLike) => Promise<string[]>;
-    mkdir: (path: node_fs.PathLike, options?: MakeOptions) => Promise<void>;
-    rm: (path: node_fs.PathLike, options?: {
-        recursive?: boolean;
-        force?: boolean;
-    }) => Promise<void>;
-    rmdir: (path: node_fs.PathLike, options?: {
-        recursive?: boolean;
-    }) => Promise<void>;
-    unlink: (path: node_fs.PathLike) => Promise<void>;
-    rename: (from: node_fs.PathLike, to: node_fs.PathLike) => Promise<void>;
-    access: (path: node_fs.PathLike) => Promise<void>;
-};
-
-declare const readFile: (path: node_fs.PathLike, options?: ReadOptions) => Promise<Buffer | string>;
-declare const writeFile: (path: node_fs.PathLike, data: WriteData, options?: WriteOptions) => Promise<void>;
-declare const appendFile: (path: node_fs.PathLike, data: WriteData, options?: WriteOptions) => Promise<void>;
-declare const unlink: (path: node_fs.PathLike) => Promise<void>;
-declare const rename: (from: node_fs.PathLike, to: node_fs.PathLike) => Promise<void>;
-declare const readdir: (path: node_fs.PathLike) => Promise<string[]>;
-declare const mkdir: (path: node_fs.PathLike, options?: MakeOptions) => Promise<void>;
-declare const rm: (path: node_fs.PathLike, options?: {
+//#region src/lib/opfs/promises.d.ts
+declare const readFile: (path: import("node:fs").PathLike, options?: ReadOptions) => Promise<Buffer | string>, writeFile: (path: import("node:fs").PathLike, data: WriteData, options?: WriteOptions) => Promise<void>, appendFile: (path: import("node:fs").PathLike, data: WriteData, options?: WriteOptions) => Promise<void>, unlink: (path: import("node:fs").PathLike) => Promise<void>, rename: (from: import("node:fs").PathLike, to: import("node:fs").PathLike) => Promise<void>, readdir: (path: import("node:fs").PathLike) => Promise<string[]>, mkdir: (path: import("node:fs").PathLike, options?: MakeOptions) => Promise<void>, rm: (path: import("node:fs").PathLike, options?: {
     recursive?: boolean;
     force?: boolean;
-}) => Promise<void>;
-declare const rmdir: (path: node_fs.PathLike, options?: {
+  }) => Promise<void>, rmdir: (path: import("node:fs").PathLike, options?: {
     recursive?: boolean;
-}) => Promise<void>;
-declare const stat: (path: node_fs.PathLike) => Promise<Stats>;
-declare const lstat: (path: node_fs.PathLike) => Promise<Stats>;
-declare const access: (path: node_fs.PathLike) => Promise<void>;
-
-export { access, appendFile, promises as default, lstat, mkdir, readFile, readdir, rename, rm, rmdir, stat, unlink, writeFile };
+  }) => Promise<void>, stat: (path: import("node:fs").PathLike) => Promise<Stats>, lstat: (path: import("node:fs").PathLike) => Promise<Stats>, access: (path: import("node:fs").PathLike) => Promise<void>;
+//#endregion
+export { access, appendFile, promises as default, lstat, mkdir, readFile, readdir, rename, rm, rmdir, stat, unlink, writeFile };

package/opfs/promises.js

@@ -1,4 +1,3 @@
-import "../node-fs-CdKPXPtW.js";
 import { promises as e } from "../opfs.js";
 //#region src/lib/opfs/promises.ts
 var { readFile: t, writeFile: n, appendFile: r, unlink: i, rename: a, readdir: o, mkdir: s, rm: c, rmdir: l, stat: u, lstat: d, access: f } = e, p = e;

package/{opfs-BfcYLPGb.js → opfs-7_GmzQ93.js}

@@ -1,4 +1,4 @@
-import { n as e } from "./chunk-CPXzm0be.js";
+import { n as e } from "./rolldown-runtime-DF993M8W.js";
 //#region src/lib/fs/opfs.ts
 var t = /* @__PURE__ */ e({
 	available: () => a,

package/opfs-uClkgnb5.cjs

@@ -0,0 +1 @@
+var e=require("./rolldown-runtime-Doa5O59j.cjs").n({available:()=>i,list:()=>c,readFile:()=>o,remove:()=>s,writeFile:()=>a}),t=()=>navigator.storage.getDirectory(),n=e=>{let t=e.split(`/`).filter(e=>e&&e!==`.`);if(t.some(e=>e===`..`)||!t.length)throw Error(`opfs: invalid path`);return t},r=async(e,n)=>{let r=await t();for(let t of e)r=await r.getDirectoryHandle(t,{create:n});return r},i=async()=>{try{return typeof navigator<`u`&&!!navigator.storage?.getDirectory&&!!await t()}catch{return!1}},a=async(e,t,i)=>{let a=n(e),o=a.pop(),s=await(await(await r(a,!0)).getFileHandle(o,{create:!0})).createWritable({keepExistingData:!1});try{let e=t instanceof Blob?t:new Blob([t],i?.contentType?{type:i.contentType}:void 0);await s.write(e)}finally{await s.close()}},o=async e=>{let t=n(e),i=t.pop();return(await(await r(t,!1)).getFileHandle(i)).getFile()},s=async e=>{let t=n(e),i=t.pop();await(await r(t,!1)).removeEntry(i,{recursive:!0})},c=async()=>{let e=[],n=async(t,r)=>{for await(let[i,a]of t.entries()){let t=r?`${r}/${i}`:i;if(a.kind===`file`){let n=await a.getFile();e.push({path:t,size:n.size,contentType:n.type||null,updatedAt:new Date(n.lastModified).toISOString()})}else await n(a,t)}};return await n(await t(),``),e};Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return i}});

package/opfs.cjs

@@ -1 +1 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require(`./chunk-B6C_zzib.cjs`),t=require(`./node-fs-DQn1TGJz.cjs`),n=require(`./opfs-Dsi4FkJU.cjs`);var r=e.n({appendFile:()=>b,appendFileSync:()=>c,available:()=>a,default:()=>i,exists:()=>D,existsSync:()=>l,flush:()=>A,lstatSync:()=>d,mkdir:()=>C,mkdirSync:()=>p,mount:()=>k,promises:()=>O,readFile:()=>v,readFileSync:()=>o,readdir:()=>S,readdirSync:()=>f,remount:()=>j,rename:()=>E,renameSync:()=>_,rm:()=>w,rmSync:()=>m,rmdirSync:()=>h,stat:()=>x,statSync:()=>u,unlink:()=>T,unlinkSync:()=>g,writeFile:()=>y,writeFileSync:()=>s}),i=t.t(n.r,{memfs:!0}),{available:a,readFileSync:o,writeFileSync:s,appendFileSync:c,existsSync:l,statSync:u,lstatSync:d,readdirSync:f,mkdirSync:p,rmSync:m,rmdirSync:h,unlinkSync:g,renameSync:_,readFile:v,writeFile:y,appendFile:b,stat:x,readdir:S,mkdir:C,rm:w,unlink:T,rename:E,exists:D,promises:O,mount:k,flush:A,remount:j}=i;exports.appendFile=b,exports.appendFileSync=c,exports.available=a,exports.default=i,exports.exists=D,exports.existsSync=l,exports.flush=A,exports.lstatSync=d,exports.mkdir=C,exports.mkdirSync=p,exports.mount=k,exports.promises=O,exports.readFile=v,exports.readFileSync=o,exports.readdir=S,exports.readdirSync=f,exports.remount=j,exports.rename=E,exports.renameSync=_,exports.rm=w,exports.rmSync=m,exports.rmdirSync=h,exports.stat=x,exports.statSync=u,Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return r}}),exports.unlink=T,exports.unlinkSync=g,exports.writeFile=y,exports.writeFileSync=s;
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("./rolldown-runtime-Doa5O59j.cjs"),t=require("./node-fs-C0eKnboT.cjs"),n=require("./opfs-uClkgnb5.cjs");var r=e.n({appendFile:()=>b,appendFileSync:()=>c,available:()=>a,default:()=>i,exists:()=>D,existsSync:()=>l,flush:()=>A,lstatSync:()=>d,mkdir:()=>C,mkdirSync:()=>p,mount:()=>k,promises:()=>O,readFile:()=>v,readFileSync:()=>o,readdir:()=>S,readdirSync:()=>f,remount:()=>j,rename:()=>E,renameSync:()=>_,rm:()=>w,rmSync:()=>m,rmdirSync:()=>h,stat:()=>x,statSync:()=>u,unlink:()=>T,unlinkSync:()=>g,writeFile:()=>y,writeFileSync:()=>s}),i=t.t(n.r,{memfs:!0}),{available:a,readFileSync:o,writeFileSync:s,appendFileSync:c,existsSync:l,statSync:u,lstatSync:d,readdirSync:f,mkdirSync:p,rmSync:m,rmdirSync:h,unlinkSync:g,renameSync:_,readFile:v,writeFile:y,appendFile:b,stat:x,readdir:S,mkdir:C,rm:w,unlink:T,rename:E,exists:D,promises:O,mount:k,flush:A,remount:j}=i;exports.appendFile=b,exports.appendFileSync=c,exports.available=a,exports.default=i,exports.exists=D,exports.existsSync=l,exports.flush=A,exports.lstatSync=d,exports.mkdir=C,exports.mkdirSync=p,exports.mount=k,exports.promises=O,exports.readFile=v,exports.readFileSync=o,exports.readdir=S,exports.readdirSync=f,exports.remount=j,exports.rename=E,exports.renameSync=_,exports.rm=w,exports.rmSync=m,exports.rmdirSync=h,exports.stat=x,exports.statSync=u,Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return r}}),exports.unlink=T,exports.unlinkSync=g,exports.writeFile=y,exports.writeFileSync=s;

package/opfs.d.ts

@@ -1,140 +1,90 @@
-import * as node_fs from 'node:fs';
-
-type ReadOptions = BufferEncoding | {
-    encoding?: BufferEncoding | null;
-    flag?: string;
-} | null | undefined;
-type WriteOptions = BufferEncoding | {
-    encoding?: BufferEncoding | null;
-    mode?: number;
-    flag?: string;
-    contentType?: string;
-} | null | undefined;
-type WriteData = string | Uint8Array | ArrayBuffer | DataView;
-type MakeOptions = {
-    recursive?: boolean;
-} | number | null | undefined;
-type Callback<R> = (error: NodeJS.ErrnoException | null, result?: R) => void;
-type Stats = {
-    size: number;
-    mtimeMs: number;
-    mtime: Date;
-    atimeMs: number;
-    ctimeMs: number;
-    mode: number;
-    isFile: () => boolean;
-    isDirectory: () => boolean;
-    isSymbolicLink: () => boolean;
-};
+import { a as WriteData, i as Stats, n as MakeOptions, o as WriteOptions, r as ReadOptions, t as Callback } from "./index-C6ZoDJg8.js";
 
+//#region src/lib/opfs/index.d.ts
+declare namespace index_d_exports {
+  export { Stats, appendFile, appendFileSync, available, fs as default, exists, existsSync, flush, lstatSync, mkdir, mkdirSync, mount, promises, readFile, readFileSync, readdir, readdirSync, remount, rename, renameSync, rm, rmSync, rmdirSync, stat, statSync, unlink, unlinkSync, writeFile, writeFileSync };
+}
 declare const fs: {
-    available: () => Promise<boolean>;
-    readFileSync: (path: node_fs.PathLike, options?: ReadOptions) => Buffer | string;
-    writeFileSync: (path: node_fs.PathLike, data: WriteData, options?: WriteOptions) => void;
-    appendFileSync: (path: node_fs.PathLike, data: WriteData, options?: WriteOptions) => void;
-    existsSync: (path: node_fs.PathLike) => boolean;
-    statSync: (path: node_fs.PathLike) => Stats;
-    lstatSync: (path: node_fs.PathLike) => Stats;
-    readdirSync: (path: node_fs.PathLike) => string[];
-    mkdirSync: (path: node_fs.PathLike, options?: MakeOptions) => void;
-    rmSync: (path: node_fs.PathLike, options?: {
-        recursive?: boolean;
-        force?: boolean;
-    }) => void;
-    rmdirSync: (path: node_fs.PathLike, options?: {
-        recursive?: boolean;
-    }) => void;
-    unlinkSync: (path: node_fs.PathLike) => void;
-    renameSync: (from: node_fs.PathLike, to: node_fs.PathLike) => void;
-    readFile: (path: node_fs.PathLike, a: ReadOptions | Callback<Buffer | string>, b?: Callback<Buffer | string>) => void;
-    writeFile: (path: node_fs.PathLike, data: WriteData, a: WriteOptions | Callback<void>, b?: Callback<void>) => void;
-    appendFile: (path: node_fs.PathLike, data: WriteData, a: WriteOptions | Callback<void>, b?: Callback<void>) => void;
-    stat: (path: node_fs.PathLike, callback: Callback<Stats>) => void;
-    readdir: (path: node_fs.PathLike, a: unknown, b?: Callback<string[]>) => void;
-    mkdir: (path: node_fs.PathLike, a: MakeOptions | Callback<void>, b?: Callback<void>) => void;
-    rm: (path: node_fs.PathLike, a: {
-        recursive?: boolean;
-        force?: boolean;
-    } | Callback<void>, b?: Callback<void>) => void;
-    unlink: (path: node_fs.PathLike, callback: Callback<void>) => void;
-    rename: (from: node_fs.PathLike, to: node_fs.PathLike, callback: Callback<void>) => void;
-    exists: (path: node_fs.PathLike, callback: (exists: boolean) => void) => void;
-    promises: {
-        readFile: (path: node_fs.PathLike, options?: ReadOptions) => Promise<Buffer | string>;
-        writeFile: (path: node_fs.PathLike, data: WriteData, options?: WriteOptions) => Promise<void>;
-        appendFile: (path: node_fs.PathLike, data: WriteData, options?: WriteOptions) => Promise<void>;
-        stat: (path: node_fs.PathLike) => Promise<Stats>;
-        lstat: (path: node_fs.PathLike) => Promise<Stats>;
-        readdir: (path: node_fs.PathLike) => Promise<string[]>;
-        mkdir: (path: node_fs.PathLike, options?: MakeOptions) => Promise<void>;
-        rm: (path: node_fs.PathLike, options?: {
-            recursive?: boolean;
-            force?: boolean;
-        }) => Promise<void>;
-        rmdir: (path: node_fs.PathLike, options?: {
-            recursive?: boolean;
-        }) => Promise<void>;
-        unlink: (path: node_fs.PathLike) => Promise<void>;
-        rename: (from: node_fs.PathLike, to: node_fs.PathLike) => Promise<void>;
-        access: (path: node_fs.PathLike) => Promise<void>;
-    };
-    mount: () => Promise<void>;
-    flush: () => Promise<void>;
-    remount: () => Promise<void>;
-};
-declare const available: () => Promise<boolean>;
-declare const readFileSync: (path: node_fs.PathLike, options?: ReadOptions) => Buffer | string;
-declare const writeFileSync: (path: node_fs.PathLike, data: WriteData, options?: WriteOptions) => void;
-declare const appendFileSync: (path: node_fs.PathLike, data: WriteData, options?: WriteOptions) => void;
-declare const existsSync: (path: node_fs.PathLike) => boolean;
-declare const statSync: (path: node_fs.PathLike) => Stats;
-declare const lstatSync: (path: node_fs.PathLike) => Stats;
-declare const readdirSync: (path: node_fs.PathLike) => string[];
-declare const mkdirSync: (path: node_fs.PathLike, options?: MakeOptions) => void;
-declare const rmSync: (path: node_fs.PathLike, options?: {
+  available: () => Promise<boolean>;
+  readFileSync: (path: import("node:fs").PathLike, options?: ReadOptions) => Buffer | string;
+  writeFileSync: (path: import("node:fs").PathLike, data: WriteData, options?: WriteOptions) => void;
+  appendFileSync: (path: import("node:fs").PathLike, data: WriteData, options?: WriteOptions) => void;
+  existsSync: (path: import("node:fs").PathLike) => boolean;
+  statSync: (path: import("node:fs").PathLike) => Stats;
+  lstatSync: (path: import("node:fs").PathLike) => Stats;
+  readdirSync: (path: import("node:fs").PathLike) => string[];
+  mkdirSync: (path: import("node:fs").PathLike, options?: MakeOptions) => void;
+  rmSync: (path: import("node:fs").PathLike, options?: {
     recursive?: boolean;
     force?: boolean;
-}) => void;
-declare const rmdirSync: (path: node_fs.PathLike, options?: {
+  }) => void;
+  rmdirSync: (path: import("node:fs").PathLike, options?: {
     recursive?: boolean;
-}) => void;
-declare const unlinkSync: (path: node_fs.PathLike) => void;
-declare const renameSync: (from: node_fs.PathLike, to: node_fs.PathLike) => void;
-declare const readFile: (path: node_fs.PathLike, a: ReadOptions | Callback<Buffer | string>, b?: Callback<Buffer | string>) => void;
-declare const writeFile: (path: node_fs.PathLike, data: WriteData, a: WriteOptions | Callback<void>, b?: Callback<void>) => void;
-declare const appendFile: (path: node_fs.PathLike, data: WriteData, a: WriteOptions | Callback<void>, b?: Callback<void>) => void;
-declare const stat: (path: node_fs.PathLike, callback: Callback<Stats>) => void;
-declare const readdir: (path: node_fs.PathLike, a: unknown, b?: Callback<string[]>) => void;
-declare const mkdir: (path: node_fs.PathLike, a: MakeOptions | Callback<void>, b?: Callback<void>) => void;
-declare const rm: (path: node_fs.PathLike, a: {
+  }) => void;
+  unlinkSync: (path: import("node:fs").PathLike) => void;
+  renameSync: (from: import("node:fs").PathLike, to: import("node:fs").PathLike) => void;
+  readFile: (path: import("node:fs").PathLike, a: ReadOptions | Callback<Buffer | string>, b?: Callback<Buffer | string>) => void;
+  writeFile: (path: import("node:fs").PathLike, data: WriteData, a: WriteOptions | Callback<void>, b?: Callback<void>) => void;
+  appendFile: (path: import("node:fs").PathLike, data: WriteData, a: WriteOptions | Callback<void>, b?: Callback<void>) => void;
+  stat: (path: import("node:fs").PathLike, callback: Callback<Stats>) => void;
+  readdir: (path: import("node:fs").PathLike, a: unknown, b?: Callback<string[]>) => void;
+  mkdir: (path: import("node:fs").PathLike, a: MakeOptions | Callback<void>, b?: Callback<void>) => void;
+  rm: (path: import("node:fs").PathLike, a: {
     recursive?: boolean;
     force?: boolean;
-} | Callback<void>, b?: Callback<void>) => void;
-declare const unlink: (path: node_fs.PathLike, callback: Callback<void>) => void;
-declare const rename: (from: node_fs.PathLike, to: node_fs.PathLike, callback: Callback<void>) => void;
-declare const exists: (path: node_fs.PathLike, callback: (exists: boolean) => void) => void;
-declare const promises: {
-    readFile: (path: node_fs.PathLike, options?: ReadOptions) => Promise<Buffer | string>;
-    writeFile: (path: node_fs.PathLike, data: WriteData, options?: WriteOptions) => Promise<void>;
-    appendFile: (path: node_fs.PathLike, data: WriteData, options?: WriteOptions) => Promise<void>;
-    stat: (path: node_fs.PathLike) => Promise<Stats>;
-    lstat: (path: node_fs.PathLike) => Promise<Stats>;
-    readdir: (path: node_fs.PathLike) => Promise<string[]>;
-    mkdir: (path: node_fs.PathLike, options?: MakeOptions) => Promise<void>;
-    rm: (path: node_fs.PathLike, options?: {
-        recursive?: boolean;
-        force?: boolean;
+  } | Callback<void>, b?: Callback<void>) => void;
+  unlink: (path: import("node:fs").PathLike, callback: Callback<void>) => void;
+  rename: (from: import("node:fs").PathLike, to: import("node:fs").PathLike, callback: Callback<void>) => void;
+  exists: (path: import("node:fs").PathLike, callback: (exists: boolean) => void) => void;
+  promises: {
+    readFile: (path: import("node:fs").PathLike, options?: ReadOptions) => Promise<Buffer | string>;
+    writeFile: (path: import("node:fs").PathLike, data: WriteData, options?: WriteOptions) => Promise<void>;
+    appendFile: (path: import("node:fs").PathLike, data: WriteData, options?: WriteOptions) => Promise<void>;
+    stat: (path: import("node:fs").PathLike) => Promise<Stats>;
+    lstat: (path: import("node:fs").PathLike) => Promise<Stats>;
+    readdir: (path: import("node:fs").PathLike) => Promise<string[]>;
+    mkdir: (path: import("node:fs").PathLike, options?: MakeOptions) => Promise<void>;
+    rm: (path: import("node:fs").PathLike, options?: {
+      recursive?: boolean;
+      force?: boolean;
     }) => Promise<void>;
-    rmdir: (path: node_fs.PathLike, options?: {
-        recursive?: boolean;
+    rmdir: (path: import("node:fs").PathLike, options?: {
+      recursive?: boolean;
     }) => Promise<void>;
-    unlink: (path: node_fs.PathLike) => Promise<void>;
-    rename: (from: node_fs.PathLike, to: node_fs.PathLike) => Promise<void>;
-    access: (path: node_fs.PathLike) => Promise<void>;
+    unlink: (path: import("node:fs").PathLike) => Promise<void>;
+    rename: (from: import("node:fs").PathLike, to: import("node:fs").PathLike) => Promise<void>;
+    access: (path: import("node:fs").PathLike) => Promise<void>;
+  };
+  mount: () => Promise<void>;
+  flush: () => Promise<void>;
+  remount: () => Promise<void>;
 };
-declare const mount: () => Promise<void>;
-declare const flush: () => Promise<void>;
-declare const remount: () => Promise<void>;
-
-export { appendFile, appendFileSync, available, fs as default, exists, existsSync, flush, lstatSync, mkdir, mkdirSync, mount, promises, readFile, readFileSync, readdir, readdirSync, remount, rename, renameSync, rm, rmSync, rmdirSync, stat, statSync, unlink, unlinkSync, writeFile, writeFileSync };
-export type { Stats };
+declare const available: () => Promise<boolean>, readFileSync: (path: import("node:fs").PathLike, options?: ReadOptions) => Buffer | string, writeFileSync: (path: import("node:fs").PathLike, data: WriteData, options?: WriteOptions) => void, appendFileSync: (path: import("node:fs").PathLike, data: WriteData, options?: WriteOptions) => void, existsSync: (path: import("node:fs").PathLike) => boolean, statSync: (path: import("node:fs").PathLike) => Stats, lstatSync: (path: import("node:fs").PathLike) => Stats, readdirSync: (path: import("node:fs").PathLike) => string[], mkdirSync: (path: import("node:fs").PathLike, options?: MakeOptions) => void, rmSync: (path: import("node:fs").PathLike, options?: {
+    recursive?: boolean;
+    force?: boolean;
+  }) => void, rmdirSync: (path: import("node:fs").PathLike, options?: {
+    recursive?: boolean;
+  }) => void, unlinkSync: (path: import("node:fs").PathLike) => void, renameSync: (from: import("node:fs").PathLike, to: import("node:fs").PathLike) => void, readFile: (path: import("node:fs").PathLike, a: ReadOptions | Callback<Buffer | string>, b?: Callback<Buffer | string>) => void, writeFile: (path: import("node:fs").PathLike, data: WriteData, a: WriteOptions | Callback<void>, b?: Callback<void>) => void, appendFile: (path: import("node:fs").PathLike, data: WriteData, a: WriteOptions | Callback<void>, b?: Callback<void>) => void, stat: (path: import("node:fs").PathLike, callback: Callback<Stats>) => void, readdir: (path: import("node:fs").PathLike, a: unknown, b?: Callback<string[]>) => void, mkdir: (path: import("node:fs").PathLike, a: MakeOptions | Callback<void>, b?: Callback<void>) => void, rm: (path: import("node:fs").PathLike, a: {
+    recursive?: boolean;
+    force?: boolean;
+  } | Callback<void>, b?: Callback<void>) => void, unlink: (path: import("node:fs").PathLike, callback: Callback<void>) => void, rename: (from: import("node:fs").PathLike, to: import("node:fs").PathLike, callback: Callback<void>) => void, exists: (path: import("node:fs").PathLike, callback: (exists: boolean) => void) => void, promises: {
+    readFile: (path: import("node:fs").PathLike, options?: ReadOptions) => Promise<Buffer | string>;
+    writeFile: (path: import("node:fs").PathLike, data: WriteData, options?: WriteOptions) => Promise<void>;
+    appendFile: (path: import("node:fs").PathLike, data: WriteData, options?: WriteOptions) => Promise<void>;
+    stat: (path: import("node:fs").PathLike) => Promise<Stats>;
+    lstat: (path: import("node:fs").PathLike) => Promise<Stats>;
+    readdir: (path: import("node:fs").PathLike) => Promise<string[]>;
+    mkdir: (path: import("node:fs").PathLike, options?: MakeOptions) => Promise<void>;
+    rm: (path: import("node:fs").PathLike, options?: {
+      recursive?: boolean;
+      force?: boolean;
+    }) => Promise<void>;
+    rmdir: (path: import("node:fs").PathLike, options?: {
+      recursive?: boolean;
+    }) => Promise<void>;
+    unlink: (path: import("node:fs").PathLike) => Promise<void>;
+    rename: (from: import("node:fs").PathLike, to: import("node:fs").PathLike) => Promise<void>;
+    access: (path: import("node:fs").PathLike) => Promise<void>;
+  }, mount: () => Promise<void>, flush: () => Promise<void>, remount: () => Promise<void>;
+//#endregion
+export { type Stats, appendFile, appendFileSync, available, fs as default, exists, existsSync, flush, lstatSync, mkdir, mkdirSync, mount, promises, readFile, readFileSync, readdir, readdirSync, remount, rename, renameSync, rm, rmSync, rmdirSync, stat, statSync, index_d_exports as t, unlink, unlinkSync, writeFile, writeFileSync };

package/opfs.js

@@ -1,6 +1,6 @@
-import { n as e } from "./chunk-CPXzm0be.js";
-import { t } from "./node-fs-CdKPXPtW.js";
-import { r as n } from "./opfs-BfcYLPGb.js";
+import { n as e } from "./rolldown-runtime-DF993M8W.js";
+import { t } from "./node-fs-Dbf93qP7.js";
+import { r as n } from "./opfs-7_GmzQ93.js";
 //#region src/lib/opfs/index.ts
 var r = /* @__PURE__ */ e({
 	appendFile: () => b,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fkn/lib",
-  "version": "0.5.5",
+  "version": "0.6.1",
   "main": "index.js",
   "types": "index.d.ts",
   "type": "module",
@@ -100,6 +100,11 @@
       "import": "./account.js",
       "require": "./account.cjs"
     },
+    "./packages": {
+      "types": "./packages.d.ts",
+      "import": "./packages.js",
+      "require": "./packages.cjs"
+    },
     "./react": {
       "types": "./react.d.ts",
       "import": "./react.js",

package/packages-D36R2vBv.d.ts

@@ -0,0 +1,108 @@
+import { Remote } from "osra";
+
+//#region src/api/packages/types.d.ts
+type PackageQuery = {
+  /** package kind, e.g. 'plugin' - becomes the keyword `fkn-type:<type>` */type: string; /** host app scope, e.g. 'stub' - becomes the keyword `fkn-<type>--<id>` */
+  id?: string; /** package source; npm is the only origin implemented */
+  origin?: 'npm'; /** free text mixed into the registry query */
+  text?: string; /** result count, clamped to 1..100 */
+  size?: number;
+};
+type PackageResult = {
+  /** canonical version-free uri, e.g. 'npm:@banou/stub-plugin-foo' */uri: string;
+  origin: 'npm';
+  name: string; /** latest version per the search index - display only, install re-resolves from the packument */
+  version: string;
+  description: string;
+  keywords: string[];
+  publisher: string | null;
+  downloadsMonthly: number | null;
+  links: {
+    npm?: string;
+    homepage?: string;
+    repository?: string;
+  }; /** installed by the calling app */
+  installed: boolean;
+};
+type InstalledPackage = {
+  uri: string;
+  name: string;
+  version: string;
+  installedAt: number;
+};
+type PickOptions = {
+  /** untrusted, rendered as text in the picker header */title?: string;
+  multiple?: boolean;
+};
+type InstallOptions = {
+  /** exact version to pin; defaults to the packument's latest dist-tag */version?: string;
+};
+type ConnectOptions = {
+  /** opaque contract tag delivered to the package's onConnect, e.g. 'stub-source@1' */protocol?: string;
+};
+type PackagesErrorCode = 'invalid' | 'not-installed' | 'unaddressable' | 'timeout' | 'unavailable' | 'denied';
+type PackagesFail = {
+  error: PackagesErrorCode;
+  message: string;
+};
+declare namespace packages_d_exports {
+  export { AppConnectOptions, ConnectOptions, ConnectPayload, IncomingConnection, IncomingConnectionInfo, InstallOptions, InstalledPackage, PackageConnection, PackageQuery, PackageResult, PackagesError, PackagesErrorCode, PickOptions, RawPackageConnection, attach, connect, install, list, onConnect, pick, search, uninstall };
+}
+type PackagesError = Error & {
+  code: PackagesErrorCode;
+};
+/** Search npm for FKN packages, e.g. `search({ type: 'plugin', id: 'stub' })`. */
+declare const search: (query: PackageQuery) => Promise<PackageResult[]>;
+/** FKN-rendered picker over the same search; resolves the user's selection, already installed. [] on cancel. */
+declare const pick: (query: PackageQuery, options?: PickOptions) => Promise<PackageResult[]>;
+/** Install a package for this app behind an FKN-rendered confirm. Resolves null when the user declines. */
+declare const install: (uri: string, options?: InstallOptions) => Promise<InstalledPackage | null>;
+/** The packages installed by this app. */
+declare const list: () => Promise<InstalledPackage[]>;
+/** Uninstall a package from this app; its frames and connections are torn down. */
+declare const uninstall: (uri: string) => Promise<void>;
+type PackageConnection<T = unknown> = {
+  /** the package's exposed payload */remote: Remote<T>; /** settles when the package side of the connection dies (uninstall, reload, crash) - reconnect by calling connect() again */
+  closed: Promise<void>; /** the raw channel under `remote`, for direct messaging (osra envelopes ride it too - filter by your own message shape) */
+  port: MessagePort;
+};
+type AppConnectOptions = ConnectOptions & {
+  /** exposed to the package as ITS `remote` */payload?: unknown;
+  signal?: AbortSignal; /** skip the osra handshake and hand back the untouched port - e.g. to transfer it into a worker and attach() there */
+  raw?: boolean;
+};
+type RawPackageConnection = Omit<PackageConnection<never>, 'remote'>;
+type Connect = {
+  <T = unknown>(uri: string, options?: AppConnectOptions & {
+    raw?: false;
+  }): Promise<PackageConnection<T>>;
+  (uri: string, options: AppConnectOptions & {
+    raw: true;
+  }): Promise<RawPackageConnection>;
+};
+/** Connect to an installed package. Throws a PackagesError with code 'not-installed' when it is not. */
+declare const connect: Connect;
+/** Run this end of an already-brokered connection port, e.g. after transferring it into a worker. */
+declare const attach: <T = unknown>(port: MessagePort, payload?: unknown, options?: {
+  signal?: AbortSignal;
+}) => Promise<Remote<T>>;
+type IncomingConnectionInfo = {
+  /** the connecting app's identity: its package uri when it runs on a sandbox origin, else its page origin */from: string; /** the contract tag the app passed to connect(), e.g. 'stub-source@1' */
+  protocol: string | null; /** this package's canonical uri per the connecting app's install record, e.g. 'npm:@banou/stub-source-example' */
+  uri: string; /** this package's npm name */
+  name: string; /** the exact version this frame runs - the pin is encoded into the sandbox origin, immutable per version */
+  version: string;
+};
+type IncomingConnection<T = unknown> = IncomingConnectionInfo & PackageConnection<T>;
+/** produces the payload exposed to a connecting app - called once per incoming connection */
+type ConnectPayload = (info: IncomingConnectionInfo) => unknown;
+/**
+ * Serve connections from apps that installed this package. The first argument is called once per
+ * incoming connection with the connection info and returns the payload exposed to that app (its
+ * `remote`). The latest registration receives new connections; existing connections are unaffected.
+ */
+declare const onConnect: <T = unknown>(createPayload: ConnectPayload, handler?: (connection: IncomingConnection<T>) => void) => {
+  unsubscribe: () => void;
+};
+//#endregion
+export { PackagesFail as C, PackagesErrorCode as S, ConnectOptions as _, PackageConnection as a, PackageQuery as b, attach as c, list as d, onConnect as f, uninstall as g, search as h, IncomingConnectionInfo as i, connect as l, pick as m, ConnectPayload as n, PackagesError as o, packages_d_exports as p, IncomingConnection as r, RawPackageConnection as s, AppConnectOptions as t, install as u, InstallOptions as v, PickOptions as w, PackageResult as x, InstalledPackage as y };

package/packages.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-Doa5O59j.cjs"),t=require("./api-DD5v1qP9.cjs");let n=require("osra");var r=e.n({attach:()=>_,connect:()=>g,install:()=>p,list:()=>m,onConnect:()=>O,pick:()=>f,search:()=>d,uninstall:()=>h}),i=`https://fkn.app`,a=`fkn-packages-connection`,o=3e4,s=(e,t)=>Object.assign(Error(t),{code:e}),c=async()=>{if(!t.n)throw s(`unavailable`,`packages: no FKN transport in this realm - use relayWorker to bridge workers`);return t.t},l=(e,t,r)=>(0,n.expose)(e??{},{transport:t,key:a,unregisterSignal:r}),u=async(e,t,n={})=>{let{signal:r,closed:i}=n;if(r?.aborted)throw s(`unavailable`,`packages.connect: aborted before connecting`);let a=new AbortController;r&&r.addEventListener(`abort`,()=>a.abort(r.reason),{once:!0});let c=new AbortController,u=new Promise((e,n)=>{let a=setTimeout(()=>n(s(`timeout`,`packages.connect: the package did not complete the connection`)),o);c.signal.addEventListener(`abort`,()=>clearTimeout(a),{once:!0}),t.addEventListener(`message`,e=>{if(e.data?.type===`fkn-packages-nack`){let t=e.data.message;n(s(`unavailable`,typeof t==`string`&&t?t:`packages.connect: the package refused the connection`))}},{signal:c.signal}),t.start(),r&&r.addEventListener(`abort`,()=>n(s(`unavailable`,`packages.connect: aborted before connecting`)),{once:!0,signal:c.signal}),i?.then(()=>n(s(`unavailable`,`packages.connect: the package closed before connecting`)))});try{return await Promise.race([l(e,t,a.signal),u])}catch(e){a.abort(e);try{t.close()}catch{}throw e}finally{c.abort()}},d=async e=>{let t=await(await c()).packages.search(e);if(`error`in t)throw s(t.error,t.message);return t.results},f=async(e,t)=>{let n=await(await c()).packages.pick(e,t);if(`error`in n)throw s(n.error,n.message);return`declined`in n?[]:n.results},p=async(e,t)=>{let n=await(await c()).packages.install(e,t);if(`error`in n)throw s(n.error,n.message);return`declined`in n?null:n.installed},m=async()=>(await(await c()).packages.list()).results,h=async e=>{let t=await(await c()).packages.uninstall(e);if(`error`in t)throw s(t.error,t.message)},g=(async(e,t={})=>{let n=await(await c()).packages.connect(e,{protocol:t.protocol});if(`error`in n)throw s(n.error,n.message);let{port:r,closed:i}=n;if(t.raw)return{closed:i,port:r};let a=await u(t.payload,r,{signal:t.signal,closed:i});return t.signal&&t.signal.addEventListener(`abort`,()=>{try{r.postMessage({type:`fkn-packages-disconnect`})}catch{}},{once:!0}),{remote:a,closed:i,port:r}}),_=(e,t,n)=>u(t,e,{signal:n?.signal}),v=null,y=[],b=new Map,x=!1,S=!1,C=e=>{let t=b.get(e);t&&(b.delete(e),t())},w=(e,t)=>{try{e.postMessage({type:`fkn-packages-nack`,message:t})}catch{}try{e.close()}catch{}},T=async(e,t)=>{let{port:n,...r}=e;e.port.addEventListener(`message`,t=>{t.data?.type===`fkn-packages-disconnect`&&C(e.port)});let i;try{i=await t.createPayload(r)}catch(t){throw w(e.port,t instanceof Error?t.message:`the package failed to produce a connection`),t}let a=new Promise(t=>b.set(e.port,t)),o=await l(i,e.port);t.handler?.({...r,remote:o,closed:a,port:e.port})},E=()=>{x||typeof window>`u`||window.parent===window||(x=!0,window.addEventListener(`message`,e=>{if(e.source!==window.parent||e.origin!==i)return;let t=e.data;if(t?.type===`fkn-packages-port`){let n=e.ports[0];if(!n)return;let r={port:n,from:typeof t.from==`string`?t.from:``,protocol:typeof t.protocol==`string`?t.protocol:null,uri:typeof t.uri==`string`?t.uri:``,name:typeof t.name==`string`?t.name:``,version:typeof t.version==`string`?t.version:``};v?T(r,v).catch(e=>console.warn(`packages.onConnect:`,e)):y.push(r)}if(t?.type===`fkn-packages-close`)for(let e of[...b.keys()])C(e)}))},D=()=>{S||typeof window>`u`||window.parent===window||(S=!0,window.parent.postMessage({type:`fkn-packages-ready`},i))},O=(e,t)=>{if(typeof window>`u`)return{unsubscribe:()=>{}};E();let n={createPayload:e,handler:t};for(v=n,D();y.length&&v===n;)T(y.shift(),n).catch(e=>console.warn(`packages.onConnect:`,e));return{unsubscribe:()=>{v===n&&(v=null)}}};exports.attach=_,exports.connect=g,exports.install=p,exports.list=m,exports.onConnect=O,exports.pick=f,exports.search=d,Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return r}}),exports.uninstall=h;

package/packages.d.ts

@@ -0,0 +1,2 @@
+import { S as PackagesErrorCode, _ as ConnectOptions, a as PackageConnection, b as PackageQuery, c as attach, d as list, f as onConnect, g as uninstall, h as search, i as IncomingConnectionInfo, l as connect, m as pick, n as ConnectPayload, o as PackagesError, r as IncomingConnection, s as RawPackageConnection, t as AppConnectOptions, u as install, v as InstallOptions, w as PickOptions, x as PackageResult, y as InstalledPackage } from "./packages-D36R2vBv.js";
+export { AppConnectOptions, type ConnectOptions, ConnectPayload, IncomingConnection, IncomingConnectionInfo, type InstallOptions, type InstalledPackage, PackageConnection, type PackageQuery, type PackageResult, PackagesError, type PackagesErrorCode, type PickOptions, RawPackageConnection, attach, connect, install, list, onConnect, pick, search, uninstall };

package/packages.js

@@ -0,0 +1,150 @@
+import { n as e } from "./rolldown-runtime-DF993M8W.js";
+import { n as t, t as n } from "./api--bnCFd4w.js";
+import { expose as r } from "osra";
+//#region src/lib/packages.ts
+var i = /* @__PURE__ */ e({
+	attach: () => v,
+	connect: () => _,
+	install: () => m,
+	list: () => h,
+	onConnect: () => k,
+	pick: () => p,
+	search: () => f,
+	uninstall: () => g
+}), a = "https://fkn.app", o = "fkn-packages-connection", s = 3e4, c = (e, t) => Object.assign(Error(t), { code: e }), l = async () => {
+	if (!t) throw c("unavailable", "packages: no FKN transport in this realm - use relayWorker to bridge workers");
+	return n;
+}, u = (e, t, n) => r(e ?? {}, {
+	transport: t,
+	key: o,
+	unregisterSignal: n
+}), d = async (e, t, n = {}) => {
+	let { signal: r, closed: i } = n;
+	if (r?.aborted) throw c("unavailable", "packages.connect: aborted before connecting");
+	let a = new AbortController();
+	r && r.addEventListener("abort", () => a.abort(r.reason), { once: !0 });
+	let o = new AbortController(), l = new Promise((e, n) => {
+		let a = setTimeout(() => n(c("timeout", "packages.connect: the package did not complete the connection")), s);
+		o.signal.addEventListener("abort", () => clearTimeout(a), { once: !0 }), t.addEventListener("message", (e) => {
+			if (e.data?.type === "fkn-packages-nack") {
+				let t = e.data.message;
+				n(c("unavailable", typeof t == "string" && t ? t : "packages.connect: the package refused the connection"));
+			}
+		}, { signal: o.signal }), t.start(), r && r.addEventListener("abort", () => n(c("unavailable", "packages.connect: aborted before connecting")), {
+			once: !0,
+			signal: o.signal
+		}), i?.then(() => n(c("unavailable", "packages.connect: the package closed before connecting")));
+	});
+	try {
+		return await Promise.race([u(e, t, a.signal), l]);
+	} catch (e) {
+		a.abort(e);
+		try {
+			t.close();
+		} catch {}
+		throw e;
+	} finally {
+		o.abort();
+	}
+}, f = async (e) => {
+	let t = await (await l()).packages.search(e);
+	if ("error" in t) throw c(t.error, t.message);
+	return t.results;
+}, p = async (e, t) => {
+	let n = await (await l()).packages.pick(e, t);
+	if ("error" in n) throw c(n.error, n.message);
+	return "declined" in n ? [] : n.results;
+}, m = async (e, t) => {
+	let n = await (await l()).packages.install(e, t);
+	if ("error" in n) throw c(n.error, n.message);
+	return "declined" in n ? null : n.installed;
+}, h = async () => (await (await l()).packages.list()).results, g = async (e) => {
+	let t = await (await l()).packages.uninstall(e);
+	if ("error" in t) throw c(t.error, t.message);
+}, _ = (async (e, t = {}) => {
+	let n = await (await l()).packages.connect(e, { protocol: t.protocol });
+	if ("error" in n) throw c(n.error, n.message);
+	let { port: r, closed: i } = n;
+	if (t.raw) return {
+		closed: i,
+		port: r
+	};
+	let a = await d(t.payload, r, {
+		signal: t.signal,
+		closed: i
+	});
+	return t.signal && t.signal.addEventListener("abort", () => {
+		try {
+			r.postMessage({ type: "fkn-packages-disconnect" });
+		} catch {}
+	}, { once: !0 }), {
+		remote: a,
+		closed: i,
+		port: r
+	};
+}), v = (e, t, n) => d(t, e, { signal: n?.signal }), y = null, b = [], x = /* @__PURE__ */ new Map(), S = !1, C = !1, w = (e) => {
+	let t = x.get(e);
+	t && (x.delete(e), t());
+}, T = (e, t) => {
+	try {
+		e.postMessage({
+			type: "fkn-packages-nack",
+			message: t
+		});
+	} catch {}
+	try {
+		e.close();
+	} catch {}
+}, E = async (e, t) => {
+	let { port: n, ...r } = e;
+	e.port.addEventListener("message", (t) => {
+		t.data?.type === "fkn-packages-disconnect" && w(e.port);
+	});
+	let i;
+	try {
+		i = await t.createPayload(r);
+	} catch (t) {
+		throw T(e.port, t instanceof Error ? t.message : "the package failed to produce a connection"), t;
+	}
+	let a = new Promise((t) => x.set(e.port, t)), o = await u(i, e.port);
+	t.handler?.({
+		...r,
+		remote: o,
+		closed: a,
+		port: e.port
+	});
+}, D = () => {
+	S || typeof window > "u" || window.parent === window || (S = !0, window.addEventListener("message", (e) => {
+		if (e.source !== window.parent || e.origin !== a) return;
+		let t = e.data;
+		if (t?.type === "fkn-packages-port") {
+			let n = e.ports[0];
+			if (!n) return;
+			let r = {
+				port: n,
+				from: typeof t.from == "string" ? t.from : "",
+				protocol: typeof t.protocol == "string" ? t.protocol : null,
+				uri: typeof t.uri == "string" ? t.uri : "",
+				name: typeof t.name == "string" ? t.name : "",
+				version: typeof t.version == "string" ? t.version : ""
+			};
+			y ? E(r, y).catch((e) => console.warn("packages.onConnect:", e)) : b.push(r);
+		}
+		if (t?.type === "fkn-packages-close") for (let e of [...x.keys()]) w(e);
+	}));
+}, O = () => {
+	C || typeof window > "u" || window.parent === window || (C = !0, window.parent.postMessage({ type: "fkn-packages-ready" }, a));
+}, k = (e, t) => {
+	if (typeof window > "u") return { unsubscribe: () => {} };
+	D();
+	let n = {
+		createPayload: e,
+		handler: t
+	};
+	for (y = n, O(); b.length && y === n;) E(b.shift(), n).catch((e) => console.warn("packages.onConnect:", e));
+	return { unsubscribe: () => {
+		y === n && (y = null);
+	} };
+};
+//#endregion
+export { v as attach, _ as connect, m as install, h as list, k as onConnect, p as pick, f as search, i as t, g as uninstall };