@fedify/vocab 2.3.0-dev.1274 → 2.3.0-dev.1280

package/src/vocab.test.ts

@@ -1844,6 +1844,461 @@ test("Person.fromJsonLd() with relative URLs and baseUrl", async () => {
   );
 });
 
+test("Object.fromJsonLd() normalizes Link icon to Image", async () => {
+  const json = {
+    "@context": "https://www.w3.org/ns/activitystreams",
+    "type": "Note",
+    "content": "Hello",
+    "icon": {
+      "type": "Link",
+      "href": "https://example.com/icon.png",
+      "mediaType": "image/png",
+      "name": "Icon",
+      "width": 64,
+      "height": 64,
+    },
+  };
+  const obj = await Object.fromJsonLd(json, {
+    documentLoader: mockDocumentLoader,
+    contextLoader: mockDocumentLoader,
+  });
+  const icon = await obj.getIcon();
+  deepStrictEqual(
+    icon?.url?.href,
+    "https://example.com/icon.png",
+  );
+  deepStrictEqual(icon?.mediaType, "image/png");
+  deepStrictEqual(icon?.names, ["Icon"]);
+  deepStrictEqual(icon?.width, 64);
+  deepStrictEqual(icon?.height, 64);
+});
+
+test("Object.fromJsonLd() normalizes Link image to Image", async () => {
+  const json = {
+    "@context": "https://www.w3.org/ns/activitystreams",
+    "type": "Note",
+    "content": "Hello",
+    "image": {
+      "type": "Link",
+      "href": "https://example.com/banner.png",
+      "mediaType": "image/png",
+      "width": 800,
+      "height": 200,
+    },
+  };
+  const obj = await Object.fromJsonLd(json, {
+    documentLoader: mockDocumentLoader,
+    contextLoader: mockDocumentLoader,
+  });
+  const images = [];
+  for await (const img of obj.getImages()) {
+    images.push(img);
+  }
+  deepStrictEqual(images[0]?.url?.href, "https://example.com/banner.png");
+  deepStrictEqual(images[0]?.mediaType, "image/png");
+  deepStrictEqual(images[0]?.width, 800);
+  deepStrictEqual(images[0]?.height, 200);
+});
+
+test("Object.fromJsonLd() normalizes Link icon with relative URL", async () => {
+  const json = {
+    "@context": "https://www.w3.org/ns/activitystreams",
+    "type": "Note",
+    "id": "https://example.com/notes/1",
+    "content": "Hello",
+    "icon": {
+      "type": "Link",
+      "href": "/icons/icon.png",
+    },
+  };
+  const obj = await Object.fromJsonLd(json, {
+    documentLoader: mockDocumentLoader,
+    contextLoader: mockDocumentLoader,
+  });
+  const icon = await obj.getIcon();
+  deepStrictEqual(
+    icon?.url?.href,
+    "https://example.com/icons/icon.png",
+  );
+});
+
+test(
+  "Object.fromJsonLd() normalizes Link icon with relative id and baseUrl",
+  async () => {
+    const json = {
+      "@context": "https://www.w3.org/ns/activitystreams",
+      "type": "Note",
+      "id": "/notes/1",
+      "content": "Hello",
+      "icon": {
+        "type": "Link",
+        "href": "/icons/icon.png",
+      },
+    };
+    const obj = await Object.fromJsonLd(json, {
+      documentLoader: mockDocumentLoader,
+      contextLoader: mockDocumentLoader,
+      baseUrl: new URL("https://example.com/"),
+    });
+    const icon = await obj.getIcon();
+    deepStrictEqual(obj.id?.href, "https://example.com/notes/1");
+    deepStrictEqual(
+      icon?.url?.href,
+      "https://example.com/icons/icon.png",
+    );
+  },
+);
+
+test("Object.fromJsonLd() decodes Image icon with relative id and baseUrl", async () => {
+  const json = {
+    "@context": "https://www.w3.org/ns/activitystreams",
+    "type": "Note",
+    "id": "/notes/1",
+    "content": "Hello",
+    "icon": {
+      "type": "Image",
+      "url": "/icons/icon.png",
+    },
+  };
+  const obj = await Object.fromJsonLd(json, {
+    documentLoader: mockDocumentLoader,
+    contextLoader: mockDocumentLoader,
+    baseUrl: new URL("https://example.com/"),
+  });
+  const icon = await obj.getIcon();
+  deepStrictEqual(obj.id?.href, "https://example.com/notes/1");
+  deepStrictEqual(
+    icon?.url?.href,
+    "https://example.com/icons/icon.png",
+  );
+});
+
+test("Object.fromJsonLd() decodes compact icon id with relative id and baseUrl", async () => {
+  const json = {
+    "@context": "https://www.w3.org/ns/activitystreams",
+    "type": "Note",
+    "id": "/notes/1",
+    "content": "Hello",
+    "icon": "/icons/icon.png",
+  };
+  const obj = await Object.fromJsonLd(json, {
+    documentLoader: mockDocumentLoader,
+    contextLoader: mockDocumentLoader,
+    baseUrl: new URL("https://example.com/"),
+  });
+  deepStrictEqual(obj.id?.href, "https://example.com/notes/1");
+  deepStrictEqual(
+    obj.iconId?.href,
+    "https://example.com/icons/icon.png",
+  );
+});
+
+test("Object.fromJsonLd() resolves compact icon id against document base", async () => {
+  const json = {
+    "@context": "https://www.w3.org/ns/activitystreams",
+    "type": "Note",
+    "id": "../notes/1",
+    "content": "Hello",
+    "icon": "icon.png",
+  };
+  const obj = await Object.fromJsonLd(json, {
+    documentLoader: mockDocumentLoader,
+    contextLoader: mockDocumentLoader,
+    baseUrl: new URL("https://example.com/outbox/page.json"),
+  });
+  deepStrictEqual(obj.id?.href, "https://example.com/outbox/notes/1");
+  deepStrictEqual(
+    obj.iconId?.href,
+    "https://example.com/outbox/icon.png",
+  );
+});
+
+test("Object.fromJsonLd() skips blank node compact icon id", async () => {
+  const json = {
+    "@context": "https://www.w3.org/ns/activitystreams",
+    "type": "Note",
+    "id": "/notes/1",
+    "content": "Hello",
+    "icon": { "@id": "_:b0" },
+  };
+  const obj = await Object.fromJsonLd(json, {
+    documentLoader: mockDocumentLoader,
+    contextLoader: mockDocumentLoader,
+    baseUrl: new URL("https://example.com/"),
+  });
+  deepStrictEqual(obj.id?.href, "https://example.com/notes/1");
+  deepStrictEqual(obj.iconId, null);
+});
+
+test("Object.fromJsonLd() resolves compact icon id against baseUrl for did id", async () => {
+  const json = {
+    "@context": "https://www.w3.org/ns/activitystreams",
+    "type": "Note",
+    "id": "did:plc:example",
+    "content": "Hello",
+    "icon": "/icons/icon.png",
+  };
+  const obj = await Object.fromJsonLd(json, {
+    documentLoader: mockDocumentLoader,
+    contextLoader: mockDocumentLoader,
+    baseUrl: new URL("https://example.com/notes/1"),
+  });
+  deepStrictEqual(obj.id?.href, "did:plc:example");
+  deepStrictEqual(
+    obj.iconId?.href,
+    "https://example.com/icons/icon.png",
+  );
+});
+
+test(
+  "Object.getIcon() resolves relative Link href without id via cached re-parse",
+  async () => {
+    const json = {
+      "@context": "https://www.w3.org/ns/activitystreams",
+      "type": "Note",
+      "content": "Hello",
+      "icon": {
+        "@context": "https://www.w3.org/ns/activitystreams",
+        "type": "Link",
+        "href": "/icons/star.png",
+        "mediaType": "image/png",
+      },
+    };
+    const obj = await Object.fromJsonLd(json, {
+      documentLoader: mockDocumentLoader,
+      contextLoader: mockDocumentLoader,
+      baseUrl: new URL("https://example.com/"),
+    });
+    // getIcon() is called WITHOUT explicit baseUrl — the accessor
+    // should reuse the baseUrl that was set during fromJsonLd().
+    const icon = await obj.getIcon();
+    deepStrictEqual(
+      icon?.url?.href,
+      "https://example.com/icons/star.png",
+    );
+    deepStrictEqual(icon?.mediaType, "image/png");
+  },
+);
+
+test(
+  "Object.fromJsonLd() resolves Link href against document base, not object id",
+  async () => {
+    const json = {
+      "@context": "https://www.w3.org/ns/activitystreams",
+      "type": "Note",
+      "id": "../notes/1",
+      "content": "Hello",
+      "icon": {
+        "type": "Link",
+        "href": "icon.png",
+      },
+    };
+    const obj = await Object.fromJsonLd(json, {
+      documentLoader: mockDocumentLoader,
+      contextLoader: mockDocumentLoader,
+      baseUrl: new URL("https://example.com/outbox/page.json"),
+    });
+    const icon = await obj.getIcon();
+    deepStrictEqual(obj.id?.href, "https://example.com/outbox/notes/1");
+    deepStrictEqual(
+      icon?.url?.href,
+      "https://example.com/outbox/icon.png",
+    );
+  },
+);
+
+test(
+  "Object.getIcon() resolves cached relative Link href against baseUrl for did id",
+  async () => {
+    const json = {
+      "@context": "https://www.w3.org/ns/activitystreams",
+      "type": "Note",
+      "id": "did:plc:example",
+      "content": "Hello",
+      "icon": {
+        "@context": "https://www.w3.org/ns/activitystreams",
+        "type": "Link",
+        "href": "/icons/star.png",
+        "mediaType": "image/png",
+      },
+    };
+    const obj = await Object.fromJsonLd(json, {
+      documentLoader: mockDocumentLoader,
+      contextLoader: mockDocumentLoader,
+      baseUrl: new URL("https://example.com/notes/1"),
+    });
+    const icon = await obj.getIcon();
+    deepStrictEqual(obj.id?.href, "did:plc:example");
+    deepStrictEqual(
+      icon?.url?.href,
+      "https://example.com/icons/star.png",
+    );
+    deepStrictEqual(icon?.mediaType, "image/png");
+  },
+);
+
+test(
+  "Object.getIcon() ignores mutation of caller's baseUrl after fromJsonLd()",
+  async () => {
+    const origBaseUrl = new URL("https://example.com/");
+    const json = {
+      "@context": "https://www.w3.org/ns/activitystreams",
+      "type": "Note",
+      "content": "Hello",
+      "icon": {
+        "@context": "https://www.w3.org/ns/activitystreams",
+        "type": "Link",
+        "href": "/icons/star.png",
+        "mediaType": "image/png",
+      },
+    };
+    const obj = await Object.fromJsonLd(json, {
+      documentLoader: mockDocumentLoader,
+      contextLoader: mockDocumentLoader,
+      baseUrl: origBaseUrl,
+    });
+    // Mutate the caller's URL after construction.
+    origBaseUrl.href = "https://attacker.example/";
+    const icon = await obj.getIcon();
+    deepStrictEqual(
+      icon?.url?.href,
+      "https://example.com/icons/star.png",
+    );
+    deepStrictEqual(icon?.mediaType, "image/png");
+  },
+);
+
+test(
+  "Object.fromJsonLd() does not resolve blank node @id against baseUrl",
+  async () => {
+    const json = {
+      "@context": "https://www.w3.org/ns/activitystreams",
+      "type": "Note",
+      "id": "_:b0",
+    };
+    const obj = await Object.fromJsonLd(json, {
+      documentLoader: mockDocumentLoader,
+      contextLoader: mockDocumentLoader,
+      baseUrl: new URL("https://example.com/"),
+    });
+    // Blank node identifiers must not be resolved against baseUrl.
+    deepStrictEqual(obj.id, null);
+  },
+);
+
+test(
+  "Object.fromJsonLd() handles blank node @id without baseUrl",
+  () => {
+    const obj = Object.fromJsonLd({
+      "@context": "https://www.w3.org/ns/activitystreams",
+      "type": "Note",
+      "id": "_:b0",
+    }, {
+      documentLoader: mockDocumentLoader,
+      contextLoader: mockDocumentLoader,
+    });
+    // Blank node identifier without baseUrl must not throw.
+    return obj.then((o) => deepStrictEqual(o.id, null));
+  },
+);
+
+test(
+  "Object.getAttachments() resolves relative url via stored _baseUrl",
+  async () => {
+    const json = {
+      "@context": "https://www.w3.org/ns/activitystreams",
+      "type": "Note",
+      "content": "Hello",
+      "attachment": {
+        "@context": "https://www.w3.org/ns/activitystreams",
+        "type": "Document",
+        "url": "/files/report.pdf",
+        "mediaType": "application/pdf",
+      },
+    };
+    const obj = await Object.fromJsonLd(json, {
+      documentLoader: mockDocumentLoader,
+      contextLoader: mockDocumentLoader,
+      baseUrl: new URL("https://example.com/"),
+    });
+    // getAttachments() without explicit baseUrl should use stored _baseUrl.
+    const attachments = [];
+    for await (const a of obj.getAttachments()) {
+      attachments.push(a);
+    }
+    deepStrictEqual(attachments.length, 1);
+    // deno-lint-ignore no-explicit-any
+    const doc = attachments[0] as any;
+    deepStrictEqual(
+      doc?.url?.href,
+      "https://example.com/files/report.pdf",
+    );
+    deepStrictEqual(doc?.mediaType, "application/pdf");
+  },
+);
+
+test("Object.fromJsonLd() normalizes multiple Link icons", async () => {
+  const json = {
+    "@context": "https://www.w3.org/ns/activitystreams",
+    "type": "Note",
+    "content": "Hello",
+    "icon": [
+      { "type": "Link", "href": "https://example.com/a.png" },
+      { "type": "Image", "url": "https://example.com/b.png" },
+    ],
+  };
+  const obj = await Object.fromJsonLd(json, {
+    documentLoader: mockDocumentLoader,
+    contextLoader: mockDocumentLoader,
+  });
+  const icons = [];
+  for await (const i of obj.getIcons()) {
+    icons.push(i);
+  }
+  deepStrictEqual(icons.length, 2);
+  deepStrictEqual(icons[0]?.url?.href, "https://example.com/a.png");
+  deepStrictEqual(icons[1]?.url?.href, "https://example.com/b.png");
+});
+
+test("Object.getIcon() normalizes fetched Link document to Image", async () => {
+  const linkDocUrl = "https://example.com/icons/avatar-link";
+  const linkDoc = {
+    "@context": "https://www.w3.org/ns/activitystreams",
+    type: "Link",
+    href: "https://example.com/avatars/user.png",
+    mediaType: "image/png",
+    width: 128,
+    height: 128,
+  };
+  const docLoader = async (url: string) => {
+    if (url === linkDocUrl) {
+      return {
+        document: linkDoc,
+        documentUrl: url,
+        contextUrl: null,
+      };
+    }
+    return await mockDocumentLoader(url);
+  };
+
+  const person = new Person({
+    id: new URL("https://example.com/ap/actors/test-user"),
+    icon: new URL(linkDocUrl),
+  });
+
+  const icon = await person.getIcon({
+    documentLoader: docLoader,
+    contextLoader: mockDocumentLoader,
+  });
+  deepStrictEqual(
+    icon?.url?.href,
+    "https://example.com/avatars/user.png",
+  );
+  deepStrictEqual(icon?.mediaType, "image/png");
+  deepStrictEqual(icon?.width, 128);
+  deepStrictEqual(icon?.height, 128);
+});
+
 test("FEP-fe34: Trust tracking in object construction", async () => {
   // Test that objects created with embedded objects have trust set
   const note = new Note({