fedipod-server 0.14.1 → 0.15.0

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.
@@ -33025,9 +33025,10 @@ var PodTransport = class {
33025
33025
  return serialize(doc, g, url, "text/turtle");
33026
33026
  }
33027
33027
  async setAcl(targetUrl, publicModes, opts = {}) {
33028
- const url = await this.aclUrlFor(targetUrl);
33028
+ const podTarget = this.toPod ? this.toPod(targetUrl) : targetUrl;
33029
+ const url = await this.aclUrlFor(podTarget);
33029
33030
  if (!await this.aclWritable(url)) return null;
33030
- return this.put(url, this.aclDoc(targetUrl, publicModes, { ...opts, aclUrl: url }), "text/turtle");
33031
+ return this.put(url, this.aclDoc(podTarget, publicModes, { ...opts, aclUrl: url }), "text/turtle");
33031
33032
  }
33032
33033
  // Child documents of an LDP container (URLs under it, excluding aux docs).
33033
33034
  // Revalidated: the inbox is polled every couple of minutes and is usually
@@ -33266,6 +33267,15 @@ function handleProblem(handle) {
33266
33267
  }
33267
33268
  var PROGRESS = /* @__PURE__ */ new Map();
33268
33269
  var progressKey = (a) => [a.issuer, a.mode, a.handle, a.mode === "new" ? a.podName || a.handle : a.pod].join("|");
33270
+ async function assertFrontNameFree(frontOrigin, handle) {
33271
+ const res = await fetch(
33272
+ `${frontOrigin.replace(/\/$/, "")}/api/handle?handle=${encodeURIComponent(handle)}`,
33273
+ { headers: { accept: "application/json" } }
33274
+ ).catch(() => null);
33275
+ const d = res ? await res.json().catch(() => ({})) : null;
33276
+ if (!d) throw new Error(`${new URL(frontOrigin).host} did not answer whether @${handle} is free`);
33277
+ if (!d.available) throw new Error(d.reason || `the name @${handle}@${new URL(frontOrigin).host} is taken \u2014 choose another handle`);
33278
+ }
33269
33279
  async function signUp(answers, { onStep = () => {
33270
33280
  }, frontOrigin = null } = {}) {
33271
33281
  const { mode, issuer, email, password, handle } = answers;
@@ -33274,6 +33284,9 @@ async function signUp(answers, { onStep = () => {
33274
33284
  if (!email) throw new Error("an email is required");
33275
33285
  if (!password) throw new Error("a password is required");
33276
33286
  if (mode === "existing" && !answers.pod) throw new Error("a pod address is required");
33287
+ const wantsFront = answers.shape === "front";
33288
+ if (wantsFront && !frontOrigin) throw new Error("an address at the gateway needs a gateway, and this page has none");
33289
+ if (wantsFront) await assertFrontNameFree(frontOrigin, handle);
33277
33290
  const key = progressKey(answers);
33278
33291
  const prog = PROGRESS.get(key) || {};
33279
33292
  PROGRESS.set(key, prog);
@@ -33305,11 +33318,14 @@ async function signUp(answers, { onStep = () => {
33305
33318
  }
33306
33319
  const pod = prog.pod;
33307
33320
  const webId = prog.webId || null;
33308
- const podUrl = new URL(pod);
33309
- if (podUrl.pathname !== "/") {
33310
- throw new Error(`${pod} is a path on ${podUrl.host}, not its own host. A Fediverse address lives at a host root, so this pod cannot carry one. Use a pod that is the root of its own subdomain.`);
33321
+ const pathPod = new URL(pod).pathname !== "/";
33322
+ const fronted = pathPod || wantsFront;
33323
+ if (fronted && !frontOrigin) {
33324
+ throw new Error(`${pod} is a path on a shared host, so its address must live at a gateway, and this page has none.`);
33311
33325
  }
33326
+ if (pathPod && !wantsFront) await assertFrontNameFree(frontOrigin, handle);
33312
33327
  const actorUrl = actorUrlFor(pod);
33328
+ const frontActor = fronted ? `${frontOrigin.replace(/\/$/, "")}/u/${handle}/ap/actor` : null;
33313
33329
  const cred = step("credential");
33314
33330
  let credential;
33315
33331
  if (!prog.credential) {
@@ -33324,12 +33340,36 @@ async function signUp(answers, { onStep = () => {
33324
33340
  cred.ok();
33325
33341
  }
33326
33342
  const session = await makeDpopSession(credential);
33343
+ let gateway = answers.gateway || prog.gateway || null;
33344
+ if (frontOrigin && !gateway) {
33345
+ const gw = step("gateway");
33346
+ gw.running(fronted ? `taking your address at ${new URL(frontOrigin).host}` : `connecting your mail door on ${new URL(frontOrigin).host}`);
33347
+ const res = await session.fetch(`${frontOrigin.replace(/\/$/, "")}/api/attach`, {
33348
+ method: "POST",
33349
+ headers: { "content-type": "application/json" },
33350
+ // podHome is the AP CONTAINER, not the pod root: the front builds the
33351
+ // delivery target as `podHome + 'ap/inbox/'` (lib/front-core.mjs), so a
33352
+ // bare pod root sends this identity's mail to <pod>/ap/inbox/ — outside
33353
+ // the container the agent drains, where nothing would ever read it. The
33354
+ // manage surface has always sent `urls.home`; this is the same value.
33355
+ body: JSON.stringify({ handle, podHome: `${pod}${AP_ROOT}`, actorUrl, kind: "person", fronted })
33356
+ });
33357
+ const d = await res.json().catch(() => ({}));
33358
+ if (res.status !== 201 || !d.hmacSecret) {
33359
+ throw new Error(`could not connect the gateway (HTTP ${res.status}): ${d.error || ""}`);
33360
+ }
33361
+ gateway = fronted ? { url: `${frontOrigin.replace(/\/$/, "")}/u/${handle}/ap/inbox/`, frontActor: String(d.frontActor || frontActor), hmacSecret: d.hmacSecret, mode: "trust" } : { url: d.doorInbox, hmacSecret: d.hmacSecret, mode: "trust" };
33362
+ prog.gateway = gateway;
33363
+ gw.ok();
33364
+ } else if (frontOrigin && gateway) {
33365
+ step("gateway").ok();
33366
+ }
33327
33367
  const keysStep = step("keys");
33328
33368
  let keys;
33329
33369
  if (!prog.keysStored) {
33330
33370
  keysStep.running("making your signing key and locking it under your password");
33331
33371
  keys = await generateKeys();
33332
- keys.mintedFor = actorUrl;
33372
+ keys.mintedFor = gateway?.frontActor || actorUrl;
33333
33373
  const remote = new BrowserRemotePod(session, { webId: credential.webId, role: "signup", log: () => {
33334
33374
  } });
33335
33375
  try {
@@ -33349,30 +33389,6 @@ async function signUp(answers, { onStep = () => {
33349
33389
  keys = prog.keys;
33350
33390
  keysStep.ok();
33351
33391
  }
33352
- let gateway = answers.gateway || prog.gateway || null;
33353
- if (frontOrigin && !gateway) {
33354
- const gw = step("gateway");
33355
- gw.running(`connecting your mail door on ${new URL(frontOrigin).host}`);
33356
- const res = await session.fetch(`${frontOrigin.replace(/\/$/, "")}/api/attach`, {
33357
- method: "POST",
33358
- headers: { "content-type": "application/json" },
33359
- // podHome is the AP CONTAINER, not the pod root: the front builds the
33360
- // delivery target as `podHome + 'ap/inbox/'` (lib/front-core.mjs), so a
33361
- // bare pod root sends this identity's mail to <pod>/ap/inbox/ — outside
33362
- // the container the agent drains, where nothing would ever read it. The
33363
- // manage surface has always sent `urls.home`; this is the same value.
33364
- body: JSON.stringify({ handle, podHome: `${pod}${AP_ROOT}`, actorUrl, kind: "person" })
33365
- });
33366
- const d = await res.json().catch(() => ({}));
33367
- if (res.status !== 201 || !d.hmacSecret) {
33368
- throw new Error(`could not connect the mail door (HTTP ${res.status}): ${d.error || ""}`);
33369
- }
33370
- gateway = { url: d.doorInbox, hmacSecret: d.hmacSecret, mode: "trust" };
33371
- prog.gateway = gateway;
33372
- gw.ok();
33373
- } else if (frontOrigin && gateway) {
33374
- step("gateway").ok();
33375
- }
33376
33392
  const config = {
33377
33393
  remotePod: pod,
33378
33394
  root: AP_ROOT,
@@ -33397,7 +33413,7 @@ async function signUp(answers, { onStep = () => {
33397
33413
  onStep("credential", "ok", "this browser is ready (the setup credential could not be revoked automatically \u2014 you can remove it from your pod's account page)");
33398
33414
  }
33399
33415
  PROGRESS.delete(key);
33400
- const host = new URL(pod).host;
33416
+ const host = gateway?.frontActor ? new URL(gateway.frontActor).host : new URL(pod).host;
33401
33417
  return {
33402
33418
  credential,
33403
33419
  config,
@@ -33425,6 +33441,45 @@ async function readIssuer(actorUrl, fetchImpl = fetch) {
33425
33441
  }
33426
33442
  }
33427
33443
 
33444
+ // lib/pod/urls.mjs
33445
+ function podBaseOfWebId(webId) {
33446
+ const u = new URL(webId);
33447
+ u.hash = "";
33448
+ u.search = "";
33449
+ const dir = u.pathname.replace(/profile\/card$/u, "").replace(/[^/]*$/u, "");
33450
+ return `${u.origin}${dir.endsWith("/") ? dir : dir + "/"}`;
33451
+ }
33452
+
33453
+ // lib/pod/root.mjs
33454
+ var OWNER_LOOKUP_MS = 5e3;
33455
+ var PUBLIC_DOC_MAX_BYTES = 1024 * 1024;
33456
+ async function podLayout(fetchImpl, providerOrigin, { timeoutMs = OWNER_LOOKUP_MS } = {}) {
33457
+ let origin;
33458
+ try {
33459
+ origin = new URL(providerOrigin).origin;
33460
+ } catch {
33461
+ return null;
33462
+ }
33463
+ let res;
33464
+ try {
33465
+ res = await fetchImpl(
33466
+ `${origin}/.well-known/solid`,
33467
+ { headers: { accept: "text/turtle" }, signal: AbortSignal.timeout(timeoutMs) }
33468
+ );
33469
+ } catch {
33470
+ return null;
33471
+ }
33472
+ if (res.status === 501) return "host";
33473
+ if (res.status !== 200) return null;
33474
+ let body = "";
33475
+ try {
33476
+ body = await readCapped(res, 64 * 1024);
33477
+ } catch {
33478
+ return null;
33479
+ }
33480
+ return /ns\/pim\/space#Storage|pim:Storage/u.test(body) ? "path" : null;
33481
+ }
33482
+
33428
33483
  // web/app/oidc-session.mjs
33429
33484
  var DB2 = "fedipod-oidc";
33430
33485
  var STORE = "session";
@@ -33674,7 +33729,7 @@ window.fedipodUnlock = async (password) => {
33674
33729
  if (!password) throw new Error("Enter your account password.");
33675
33730
  const session = await getSession();
33676
33731
  if (!session) throw new Error("Sign in first.");
33677
- const podFromWebId = new URL(session.webId).origin + "/";
33732
+ const podFromWebId = podBaseOfWebId(session.webId);
33678
33733
  const state = `${podFromWebId}${AP_ROOT}ap-state/`;
33679
33734
  const remote = new BrowserRemotePod(session, { webId: session.webId, role: "signup", log: () => {
33680
33735
  } });
@@ -33711,16 +33766,30 @@ async function issuerForPod(pod) {
33711
33766
  if (authz) return new URL(authz).origin;
33712
33767
  } catch {
33713
33768
  }
33714
- const host = new URL(pod).host;
33715
- const parent = host.split(".").slice(1).join(".");
33716
- return `https://${parent || host}`;
33769
+ const u = new URL(pod);
33770
+ if (u.pathname !== "/") return u.origin;
33771
+ const parent = u.host.split(".").slice(1).join(".");
33772
+ return `https://${parent || u.host}`;
33773
+ }
33774
+ async function podForFrontedAddress(handle) {
33775
+ const res = await fetch(
33776
+ `/.well-known/webfinger?resource=${encodeURIComponent(`acct:${handle}@${location.host}`)}`,
33777
+ { headers: { accept: "application/jrd+json, application/json" } }
33778
+ ).catch(() => null);
33779
+ if (!res || res.status >= 400) throw new Error(`nobody at this site is called @${handle}@${location.host}`);
33780
+ const doc = await res.json().catch(() => ({}));
33781
+ const podActorId = (doc.aliases || []).find((a) => /\/ap\/actor$/u.test(String(a)));
33782
+ if (!podActorId) throw new Error(`@${handle}@${location.host} lives here but names no pod to sign in to`);
33783
+ const tail = `${AP_ROOT}ap/actor`;
33784
+ if (!podActorId.endsWith(tail)) throw new Error(`the pod actor ${podActorId} is not where a FediPod pod keeps one`);
33785
+ return podActorId.slice(0, -tail.length);
33717
33786
  }
33718
33787
  window.fedipodSignin = async ({ address }) => {
33719
33788
  const parsed = parseAddress(address);
33720
33789
  if (!parsed) throw new Error("Enter your address as @you@yourpod (for example @alice@alice.solidcommunity.net).");
33721
33790
  const bad = handleProblem(parsed.handle);
33722
33791
  if (bad) throw new Error(bad);
33723
- const pod = `https://${parsed.host}/`;
33792
+ const pod = parsed.host === location.host.toLowerCase() ? await podForFrontedAddress(parsed.handle) : `https://${parsed.host}/`;
33724
33793
  const issuer = await issuerForPod(pod);
33725
33794
  const { authorizationUrl } = await beginLogin({ issuer, redirectUri: REDIRECT });
33726
33795
  location.href = authorizationUrl;
@@ -33866,8 +33935,8 @@ ${e.detail}` : "");
33866
33935
  });
33867
33936
  const f = () => $("form").elements;
33868
33937
  const providerUrl = () => {
33869
- let v = f().provider.value.trim();
33870
- if (!v) v = "https://solidcommunity.net";
33938
+ let v = (f().provider.value || f().providerOther.value).trim();
33939
+ if (!v) return "";
33871
33940
  if (!/^https?:\/\//i.test(v)) v = "https://" + v;
33872
33941
  return v;
33873
33942
  };
@@ -33883,6 +33952,42 @@ ${e.detail}` : "");
33883
33952
  const ph = providerHost();
33884
33953
  return sub && ph ? `${sub}.${ph}` : "";
33885
33954
  };
33955
+ const podUrl = () => {
33956
+ let v = f().pod.value.trim();
33957
+ if (!v) return "";
33958
+ if (!/^https?:\/\//i.test(v)) v = "https://" + v;
33959
+ if (!v.endsWith("/")) v += "/";
33960
+ try {
33961
+ return new URL(v).href;
33962
+ } catch {
33963
+ return "";
33964
+ }
33965
+ };
33966
+ const isPathPod = (u) => {
33967
+ try {
33968
+ return new URL(u).pathname !== "/";
33969
+ } catch {
33970
+ return false;
33971
+ }
33972
+ };
33973
+ const layouts = /* @__PURE__ */ new Map();
33974
+ let layout = null;
33975
+ const learnLayout = async () => {
33976
+ const origin = providerHost() ? new URL(providerUrl()).origin : "";
33977
+ if (!origin) {
33978
+ layout = null;
33979
+ return;
33980
+ }
33981
+ if (!layouts.has(origin)) layouts.set(origin, podLayout(fetch, origin).catch(() => null));
33982
+ const known = await layouts.get(origin);
33983
+ if (providerHost() && new URL(providerUrl()).origin === origin) {
33984
+ layout = known;
33985
+ applyShape();
33986
+ previewAddr();
33987
+ }
33988
+ };
33989
+ const pathPod = () => f().mode.value === "existing" ? isPathPod(podUrl()) : layout === "path";
33990
+ const shape = () => pathPod() ? "front" : f().shape.value;
33886
33991
  const answers = () => {
33887
33992
  const mode = f().mode.value;
33888
33993
  const a = {
@@ -33890,18 +33995,43 @@ ${e.detail}` : "");
33890
33995
  handle: f().handle.value.trim().toLowerCase(),
33891
33996
  email: f().email.value.trim(),
33892
33997
  password: f().password.value,
33893
- issuer: providerUrl()
33998
+ issuer: providerUrl(),
33999
+ shape: shape()
33894
34000
  };
33895
34001
  if (mode === "new") a.podName = f().podName.value.trim().toLowerCase();
33896
- else a.pod = `https://${podHostOf()}/`;
34002
+ else a.pod = podUrl();
33897
34003
  return a;
33898
34004
  };
33899
34005
  const previewAddr = () => {
33900
34006
  const handle = f().handle.value.trim().toLowerCase();
33901
- const ph = podHostOf();
33902
- $("preview").textContent = handle && ph ? `@${handle}@${ph}` : "@\u2026@\u2026";
34007
+ const host = shape() === "front" ? location.host : f().mode.value === "existing" ? podUrl() ? new URL(podUrl()).host : "" : podHostOf();
34008
+ $("preview").textContent = handle && host ? `@${handle}@${host}` : "@\u2026@\u2026";
34009
+ };
34010
+ const applyShape = () => {
34011
+ const fixed = pathPod();
34012
+ for (const r of f().shape) {
34013
+ if (fixed) r.checked = r.value === "front";
34014
+ }
34015
+ $("shape-group").hidden = fixed;
34016
+ $("shape-hint").hidden = !fixed;
33903
34017
  };
33904
- for (const el of $("form").elements) el.addEventListener("input", previewAddr);
34018
+ const applyMode = () => {
34019
+ const existing = f().mode.value === "existing";
34020
+ $("pod-field").hidden = !existing;
34021
+ $("podname-field").hidden = existing;
34022
+ $("provider-other-field").hidden = f().provider.value !== "";
34023
+ };
34024
+ for (const el of $("form").elements) for (const evt of ["input", "change"]) el.addEventListener(evt, () => {
34025
+ applyMode();
34026
+ applyShape();
34027
+ previewAddr();
34028
+ });
34029
+ for (const evt of ["input", "change"]) {
34030
+ $("provider").addEventListener(evt, learnLayout);
34031
+ $("providerOther").addEventListener(evt, learnLayout);
34032
+ }
34033
+ applyMode();
34034
+ learnLayout();
33905
34035
  const STEP_IDS = ["step-1", "step-2"];
33906
34036
  const FOCUS = { 1: "provider", 2: "handle" };
33907
34037
  const goStep = (n) => {
@@ -33910,15 +34040,23 @@ ${e.detail}` : "");
33910
34040
  });
33911
34041
  $("err-1").textContent = "";
33912
34042
  $("form-error").textContent = "";
33913
- if (n === 2) previewAddr();
34043
+ if (n === 2) {
34044
+ applyShape();
34045
+ previewAddr();
34046
+ learnLayout();
34047
+ }
33914
34048
  if (FOCUS[n]) $(FOCUS[n]).focus();
33915
34049
  };
33916
34050
  const validateStep1 = () => {
33917
- if (!providerHost()) return "A valid pod provider URL is required.";
33918
- const sub = f().podName.value.trim().toLowerCase();
33919
- if (!sub) return "A pod username/subdomain is required.";
33920
- const sp = window.fedipodHandleProblem(sub);
33921
- if (sp) return `Pod username: ${sp}`;
34051
+ if (!providerHost()) return f().provider.value === "" ? "A pod provider address is required under Other\u2026." : "A valid pod provider URL is required.";
34052
+ if (f().mode.value === "existing") {
34053
+ if (!podUrl()) return "A pod address is required, like https://alice.solidcommunity.net/ or https://server.example/alice/.";
34054
+ } else {
34055
+ const sub = f().podName.value.trim().toLowerCase();
34056
+ if (!sub) return "A pod username/subdomain is required.";
34057
+ const sp = window.fedipodHandleProblem(sub);
34058
+ if (sp) return `Pod username: ${sp}`;
34059
+ }
33922
34060
  if (!f().email.value.trim()) return "A pod email is required.";
33923
34061
  if (!f().password.value) return "A pod password is required.";
33924
34062
  return null;