@fkn/lib 0.9.48 → 0.9.50

package/links.cjs

@@ -1 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-BIInC43l.cjs"),t=require("./api-DMnVye0K.cjs"),n=require("./contract.cjs"),r=require("./account-generation-9VhfEDoW.cjs"),i=require("./storage-DmRIhg1P.cjs");var a=e.t({LINK_EXPIRES_MS:()=>n.LINK_EXPIRES_MS,available:()=>_,create:()=>v,list:()=>x,open:()=>b,revoke:()=>S}),o={notALink:`links: the link is not one fkn.app made`,badExpiry:`links: the expiry is not one a link can carry`,notAFile:`links: the file is not a Blob or a ReadableStream`,badSize:`links: a stream needs the size it will deliver, a whole number of bytes`,badName:`links: the name or type is not one a link can carry`,tooLarge:`links: the file is too large for a link`,shortStream:`links: the stream did not deliver the size it declared`,badKey:`links: the key is not 32 bytes base64url`,keyTaken:`links: the key already names a link`,gone:`links: the link is no longer available`,integrity:`links: the file does not match its link`,needsAccount:`links: making a link needs an account`,notCreator:`links: only the app that made the link can revoke it`,quota:`links: storage quota exceeded`,tooMany:`links: too many links`,tooManyThisHour:`links: too many links made this hour, try again later`,rateLimited:`links: this link is opened too often, try again later`,accountChanged:`links: the signed-in account changed`,unavailable:`links: links are unavailable`},s=new Map([[o.notALink,`invalid`],[o.badExpiry,`invalid`],[o.notAFile,`invalid`],[o.badSize,`invalid`],[o.badName,`invalid`],[o.tooLarge,`invalid`],[o.shortStream,`invalid`],[o.badKey,`invalid`],[o.keyTaken,`invalid`],[o.gone,`not-found`],[o.integrity,`integrity`],[o.needsAccount,`denied`],[o.notCreator,`denied`],[o.quota,`quota`],[o.tooMany,`too-many`],[o.tooManyThisHour,`too-many`],[o.rateLimited,`rate-limited`],[o.accountChanged,`account-changed`],[o.unavailable,`unavailable`]]),c=new Set(s.values()),l=(e,t)=>Object.assign(Error(t),{code:e}),u=e=>e instanceof Error&&c.has(e.code),d=e=>{if(u(e))return e;let t=e instanceof Error?e.message:``,n=s.get(t);return n?l(n,t):l(`unavailable`,o.unavailable)},f=async()=>{if(!t.l)return;let e=(await t.s(`a link`).catch(()=>void 0))?.links;return typeof e?.create==`function`?e:void 0},p=()=>{throw l(`unavailable`,o.unavailable)},m=e=>typeof e==`object`&&!!e&&typeof e.error==`string`&&typeof e.message==`string`,h=(e,t,n)=>{throw e.error===`aborted`?t?.reason??new DOMException(`The operation was aborted.`,`AbortError`):(e.error===`account-changed`&&n&&r.r(n.generation),c.has(e.error)?l(e.error,e.message):l(`unavailable`,o.unavailable))},g=async e=>{try{return await i.p(e)}catch(e){throw i.c(e)?l(`account-changed`,o.accountChanged):e instanceof Error&&/not connected|not signed in/i.test(e.message)?l(`denied`,o.needsAccount):l(`unavailable`,o.unavailable)}},_=async()=>{let e=await f();return e?Promise.resolve(e.available()).catch(()=>!1):!1},v=async(e,t={})=>{let r=i.o(),a=Date.now(),{signal:s,onProgress:c,key:u}=t;s?.throwIfAborted();let d=typeof Blob<`u`&&e instanceof Blob,_=typeof ReadableStream<`u`&&e instanceof ReadableStream;if(!d&&!_)throw l(`invalid`,o.notAFile);let v=d?e.size:t.size;if(typeof v!=`number`||!Number.isSafeInteger(v)||v<0||d&&t.size!==void 0&&t.size!==v)throw l(`invalid`,o.badSize);let y=t.name??(typeof File<`u`&&e instanceof File?e.name:``),b=t.type??(d?e.type:``);if(typeof y!=`string`||typeof b!=`string`)throw l(`invalid`,o.badName);let x=typeof File<`u`&&e instanceof File?e.lastModified:a,S=t.expires,C;if(S!=null&&(typeof S!=`number`||!Number.isFinite(S)||(C=Math.round(S-a),C<n.LINK_EXPIRES_MS.min||C>n.LINK_EXPIRES_MS.max)))throw l(`invalid`,o.badExpiry);if(c!==void 0&&typeof c!=`function`)throw l(`invalid`,o.notAFile);let w=await f();if(!w)throw l(`unavailable`,o.unavailable);let T=await g(r);s?.throwIfAborted();let E=Promise.resolve(w.create(e,{name:y,type:b,lastModified:x,size:v,...C===void 0?{}:{expiresIn:C},...u===void 0?{}:{key:u},accountPin:T,...s?{signal:s}:{},...c?{onProgress:e=>{try{c(e)}catch{}}}:{}})).catch(p);E.catch(()=>{});let D=s?await Promise.race([E,new Promise((e,t)=>s.addEventListener(`abort`,()=>t(s.reason),{once:!0}))]):await E;return m(D)?h(D,s,r):D},y=(e,t,n)=>{let r=(t,n)=>{if(t===void 0)return n;let r=Math.trunc(Number.isFinite(t)?t:t>0?e:-e);return r<0?Math.max(e+r,0):Math.min(r,e)},i=r(t,0);return{from:i,to:Math.max(i,r(n,e))}},b=async(e,n={})=>{if(typeof e!=`string`)throw l(`invalid`,o.notALink);let{signal:r}=n;r?.throwIfAborted();let i=async()=>{let n=await f();if(!n)throw l(`unavailable`,o.unavailable);let i=t.c()?.epoch,a=await Promise.resolve(n.open(e,r?{signal:r}:void 0)).catch(p);return m(a)?h(a,r):{handle:a,epoch:i}},a=await i(),s=async()=>{let e=t.c()?.epoch;return a.epoch!==void 0&&e!==void 0&&e!==a.epoch&&(a=await i()),a.handle},{name:c,type:u,size:g,lastModified:_}=a.handle,v=(e,t)=>{let n;return new ReadableStream({pull:async r=>{try{if(!n){let r=await s(),i=await Promise.resolve(r.read(e,t)).catch(p);if(m(i))return h(i);n=i.getReader()}let{value:i,done:a}=await n.read();a?r.close():r.enqueue(i)}catch(e){throw d(e)}},cancel:e=>n?.cancel(e)},{highWaterMark:0})},b=(e,t)=>({name:c,type:u,size:t-e,lastModified:_,stream:()=>v(e,t),arrayBuffer:async()=>{let n=new Uint8Array(t-e),r=v(e,t).getReader(),i=0;for(;;){let{value:e,done:t}=await r.read();if(t)break;n.set(e,i),i+=e.length}return n.buffer},slice:(n,r)=>{let i=y(t-e,n,r);return b(e+i.from,e+i.to)}});return b(0,g)},x=async()=>{let e=i.o(),t=await f();if(!t)throw l(`unavailable`,o.unavailable);let n=await g(e),r=await Promise.resolve(t.list({accountPin:n})).catch(p);return m(r)?h(r,void 0,e):r.links},S=async e=>{let t=i.o();if(typeof e!=`string`||!e)throw l(`invalid`,o.notALink);let n=await f();if(!n)throw l(`unavailable`,o.unavailable);let r=await g(t),a=await Promise.resolve(n.revoke(e,{accountPin:r})).catch(p);m(a)&&h(a,void 0,t)};exports.LINK_EXPIRES_MS=n.LINK_EXPIRES_MS,exports.available=_,exports.create=v,exports.list=x,exports.open=b,exports.revoke=S,Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return a}});

package/links.d.ts

@@ -1,65 +0,0 @@
-import { A as Link, F as LinksErrorCode, L as ListedLink, P as LinkProgress, j as LinkCreateOptions, k as LINK_EXPIRES_MS } from "./contract-XlEPwc7b.js";
-declare namespace links_d_exports {
-  export { LINK_EXPIRES_MS, Link, LinkCreateOptions, LinkProgress, LinkedFile, LinksError, LinksErrorCode, ListedLink, available, create, list, open, revoke };
-}
-/** Thrown by every member of this namespace except on an aborted signal. Match on `code`, never on the message. */
-export type LinksError = Error & {
-  code: LinksErrorCode;
-};
-/**
- * The file an opened link names, shaped like a `File`: the same four fields, `stream`, `arrayBuffer`
- * and `slice`. Every read is by range and each 1 MiB record is checked before it is handed over, so a
- * `slice` near the end of a large file fetches only that end.
- */
-export type LinkedFile = {
-  name: string;
-  type: string;
-  size: number;
-  lastModified: number;
-  /** errors with `integrity` on the first record that is not what the link sealed */
-  stream: () => ReadableStream<Uint8Array>;
-  arrayBuffer: () => Promise<ArrayBuffer>;
-  /** `Blob.slice`'s arguments, negative ones counted from the end, and the same shape back */
-  slice: (start?: number, end?: number) => LinkedFile;
-};
-/** Whether a link can be made here now. Opening needs no account and does not depend on this. Answers rather than rejecting. */
-export declare const available: () => Promise<boolean>;
-/**
- * Seals a file in the broker and uploads it, then answers its link. Needs a signed-in account, and
- * counts the sealed size (28 bytes more per 1 MiB) against the account's storage from the moment it
- * starts until the link is revoked, expires or the upload is aborted. The account the call belongs to
- * is the one this page is on when it is made, as for every storage call.
- *
- * `data` is a `Blob` (a `File` included) or a `ReadableStream<Uint8Array>` with its `size`. An upload
- * survives the network dropping a part, not a reload: a reload starts the file again, and the upload
- * left behind stops counting within the hour, or at once from `revoke` or the account's settings.
- *
- * Refused `invalid` for an expiry outside `LINK_EXPIRES_MS`, a stream without its size or one that
- * delivers another, a file past the service's part ceiling, a `key` that is not 32 bytes base64url or
- * one that already names a link; `denied` with no account; `quota`; `too-many` past the account's live
- * links or this hour's creations; `account-changed`.
- */
-export declare const create: (data: Blob | ReadableStream<Uint8Array>, options?: LinkCreateOptions) => Promise<Link>;
-/**
- * Opens a link made by any app, with no account: the broker reads the key from the link and fetches
- * the sealed file by range. Refused `invalid` for a link fkn.app did not make, `not-found` for one
- * that is missing, revoked, expired, still uploading or turned off (one answer for all of them),
- * `integrity` when the file does not match its link, `rate-limited` past the link's daily opens.
- *
- * Opening counts once per viewer per link per day; reading the same opened file again, by `slice` or
- * a second `stream()`, counts nothing more. A broker replaced while the file is held is asked to open
- * it again on the next read.
- */
-export declare const open: (url: string, options?: {
-  signal?: AbortSignal;
-}) => Promise<LinkedFile>;
-/** This app's links, newest first, uploads in progress included, as the service holds them: no name and no url. */
-export declare const list: () => Promise<ListedLink[]>;
-/**
- * Revokes a link by its url or its id: every copy of the link stops opening, and an upload in
- * progress is aborted and stops counting. Only the app that made the link (the same app once it is
- * verified) revokes it, `denied` otherwise. A link already gone resolves.
- */
-export declare const revoke: (target: string) => Promise<void>;
-//#endregion
-export { LINK_EXPIRES_MS, type Link, type LinkCreateOptions, type LinkProgress, type LinksErrorCode, type ListedLink, links_d_exports as t };

package/links.js

@@ -1,187 +0,0 @@
-import { t as e } from "./rolldown-runtime-Dy4uBu1J.js";
-import { c as t, l as n, s as r } from "./api-ySazPAwN.js";
-import { LINK_EXPIRES_MS as i } from "./contract.js";
-import { r as a } from "./account-generation-hUekEHGW.js";
-import { c as o, o as s, p as c } from "./storage-C6F9SnDM.js";
-//#region src/links.ts
-var l = /* @__PURE__ */ e({
-	LINK_EXPIRES_MS: () => i,
-	available: () => x,
-	create: () => S,
-	list: () => T,
-	open: () => w,
-	revoke: () => E
-}), u = {
-	notALink: "links: the link is not one fkn.app made",
-	badExpiry: "links: the expiry is not one a link can carry",
-	notAFile: "links: the file is not a Blob or a ReadableStream",
-	badSize: "links: a stream needs the size it will deliver, a whole number of bytes",
-	badName: "links: the name or type is not one a link can carry",
-	tooLarge: "links: the file is too large for a link",
-	shortStream: "links: the stream did not deliver the size it declared",
-	badKey: "links: the key is not 32 bytes base64url",
-	keyTaken: "links: the key already names a link",
-	gone: "links: the link is no longer available",
-	integrity: "links: the file does not match its link",
-	needsAccount: "links: making a link needs an account",
-	notCreator: "links: only the app that made the link can revoke it",
-	quota: "links: storage quota exceeded",
-	tooMany: "links: too many links",
-	tooManyThisHour: "links: too many links made this hour, try again later",
-	rateLimited: "links: this link is opened too often, try again later",
-	accountChanged: "links: the signed-in account changed",
-	unavailable: "links: links are unavailable"
-}, d = /* @__PURE__ */ new Map([
-	[u.notALink, "invalid"],
-	[u.badExpiry, "invalid"],
-	[u.notAFile, "invalid"],
-	[u.badSize, "invalid"],
-	[u.badName, "invalid"],
-	[u.tooLarge, "invalid"],
-	[u.shortStream, "invalid"],
-	[u.badKey, "invalid"],
-	[u.keyTaken, "invalid"],
-	[u.gone, "not-found"],
-	[u.integrity, "integrity"],
-	[u.needsAccount, "denied"],
-	[u.notCreator, "denied"],
-	[u.quota, "quota"],
-	[u.tooMany, "too-many"],
-	[u.tooManyThisHour, "too-many"],
-	[u.rateLimited, "rate-limited"],
-	[u.accountChanged, "account-changed"],
-	[u.unavailable, "unavailable"]
-]), f = new Set(d.values()), p = (e, t) => Object.assign(Error(t), { code: e }), m = (e) => e instanceof Error && f.has(e.code), h = (e) => {
-	if (m(e)) return e;
-	let t = e instanceof Error ? e.message : "", n = d.get(t);
-	return n ? p(n, t) : p("unavailable", u.unavailable);
-}, g = async () => {
-	if (!n) return;
-	let e = (await r("a link").catch(() => void 0))?.links;
-	return typeof e?.create == "function" ? e : void 0;
-}, _ = () => {
-	throw p("unavailable", u.unavailable);
-}, v = (e) => typeof e == "object" && !!e && typeof e.error == "string" && typeof e.message == "string", y = (e, t, n) => {
-	throw e.error === "aborted" ? t?.reason ?? new DOMException("The operation was aborted.", "AbortError") : (e.error === "account-changed" && n && a(n.generation), f.has(e.error) ? p(e.error, e.message) : p("unavailable", u.unavailable));
-}, b = async (e) => {
-	try {
-		return await c(e);
-	} catch (e) {
-		throw o(e) ? p("account-changed", u.accountChanged) : e instanceof Error && /not connected|not signed in/i.test(e.message) ? p("denied", u.needsAccount) : p("unavailable", u.unavailable);
-	}
-}, x = async () => {
-	let e = await g();
-	return e ? Promise.resolve(e.available()).catch(() => !1) : !1;
-}, S = async (e, t = {}) => {
-	let n = s(), r = Date.now(), { signal: a, onProgress: o, key: c } = t;
-	a?.throwIfAborted();
-	let l = typeof Blob < "u" && e instanceof Blob, d = typeof ReadableStream < "u" && e instanceof ReadableStream;
-	if (!l && !d) throw p("invalid", u.notAFile);
-	let f = l ? e.size : t.size;
-	if (typeof f != "number" || !Number.isSafeInteger(f) || f < 0 || l && t.size !== void 0 && t.size !== f) throw p("invalid", u.badSize);
-	let m = t.name ?? (typeof File < "u" && e instanceof File ? e.name : ""), h = t.type ?? (l ? e.type : "");
-	if (typeof m != "string" || typeof h != "string") throw p("invalid", u.badName);
-	let x = typeof File < "u" && e instanceof File ? e.lastModified : r, S = t.expires, C;
-	if (S != null && (typeof S != "number" || !Number.isFinite(S) || (C = Math.round(S - r), C < i.min || C > i.max))) throw p("invalid", u.badExpiry);
-	if (o !== void 0 && typeof o != "function") throw p("invalid", u.notAFile);
-	let w = await g();
-	if (!w) throw p("unavailable", u.unavailable);
-	let T = await b(n);
-	a?.throwIfAborted();
-	let E = Promise.resolve(w.create(e, {
-		name: m,
-		type: h,
-		lastModified: x,
-		size: f,
-		...C === void 0 ? {} : { expiresIn: C },
-		...c === void 0 ? {} : { key: c },
-		accountPin: T,
-		...a ? { signal: a } : {},
-		...o ? { onProgress: (e) => {
-			try {
-				o(e);
-			} catch {}
-		} } : {}
-	})).catch(_);
-	E.catch(() => {});
-	let D = a ? await Promise.race([E, new Promise((e, t) => a.addEventListener("abort", () => t(a.reason), { once: !0 }))]) : await E;
-	return v(D) ? y(D, a, n) : D;
-}, C = (e, t, n) => {
-	let r = (t, n) => {
-		if (t === void 0) return n;
-		let r = Math.trunc(Number.isFinite(t) ? t : t > 0 ? e : -e);
-		return r < 0 ? Math.max(e + r, 0) : Math.min(r, e);
-	}, i = r(t, 0);
-	return {
-		from: i,
-		to: Math.max(i, r(n, e))
-	};
-}, w = async (e, n = {}) => {
-	if (typeof e != "string") throw p("invalid", u.notALink);
-	let { signal: r } = n;
-	r?.throwIfAborted();
-	let i = async () => {
-		let n = await g();
-		if (!n) throw p("unavailable", u.unavailable);
-		let i = t()?.epoch, a = await Promise.resolve(n.open(e, r ? { signal: r } : void 0)).catch(_);
-		return v(a) ? y(a, r) : {
-			handle: a,
-			epoch: i
-		};
-	}, a = await i(), o = async () => {
-		let e = t()?.epoch;
-		return a.epoch !== void 0 && e !== void 0 && e !== a.epoch && (a = await i()), a.handle;
-	}, { name: s, type: c, size: l, lastModified: d } = a.handle, f = (e, t) => {
-		let n;
-		return new ReadableStream({
-			pull: async (r) => {
-				try {
-					if (!n) {
-						let r = await o(), i = await Promise.resolve(r.read(e, t)).catch(_);
-						if (v(i)) return y(i);
-						n = i.getReader();
-					}
-					let { value: i, done: a } = await n.read();
-					a ? r.close() : r.enqueue(i);
-				} catch (e) {
-					throw h(e);
-				}
-			},
-			cancel: (e) => n?.cancel(e)
-		}, { highWaterMark: 0 });
-	}, m = (e, t) => ({
-		name: s,
-		type: c,
-		size: t - e,
-		lastModified: d,
-		stream: () => f(e, t),
-		arrayBuffer: async () => {
-			let n = new Uint8Array(t - e), r = f(e, t).getReader(), i = 0;
-			for (;;) {
-				let { value: e, done: t } = await r.read();
-				if (t) break;
-				n.set(e, i), i += e.length;
-			}
-			return n.buffer;
-		},
-		slice: (n, r) => {
-			let i = C(t - e, n, r);
-			return m(e + i.from, e + i.to);
-		}
-	});
-	return m(0, l);
-}, T = async () => {
-	let e = s(), t = await g();
-	if (!t) throw p("unavailable", u.unavailable);
-	let n = await b(e), r = await Promise.resolve(t.list({ accountPin: n })).catch(_);
-	return v(r) ? y(r, void 0, e) : r.links;
-}, E = async (e) => {
-	let t = s();
-	if (typeof e != "string" || !e) throw p("invalid", u.notALink);
-	let n = await g();
-	if (!n) throw p("unavailable", u.unavailable);
-	let r = await b(t), i = await Promise.resolve(n.revoke(e, { accountPin: r })).catch(_);
-	v(i) && y(i, void 0, t);
-};
-//#endregion
-export { i as LINK_EXPIRES_MS, x as available, S as create, T as list, w as open, E as revoke, l as t };