@fedify/testing 1.8.1-dev.1233 → 1.8.1-dev.1238

package/dist/mod.d.ts

@@ -5,7 +5,7 @@ import { ResourceDescriptor } from "@fedify/fedify/webfinger";
 import { JsonValue, NodeInfo } from "@fedify/fedify/nodeinfo";
 import { DocumentLoader } from "@fedify/fedify/runtime";
 
-//#region mock.d.ts
+//#region src/mock.d.ts
 
 /**
  * Represents a sent activity with metadata about how it was sent.

package/dist/mod.js

@@ -3,7 +3,7 @@ import { RouterError } from "@fedify/fedify/federation";
 import { lookupObject, traverseCollection } from "@fedify/fedify/vocab";
 import { lookupWebFinger } from "@fedify/fedify/webfinger";
 
-//#region docloader.ts
+//#region src/docloader.ts
 const mockDocumentLoader = async (url) => ({
 	contextUrl: null,
 	document: {},
@@ -11,7 +11,7 @@ const mockDocumentLoader = async (url) => ({
 });
 
 //#endregion
-//#region context.ts
+//#region src/context.ts
 function createContext(values) {
 	const { federation, url = new URL("http://example.com/"), canonicalOrigin, data, documentLoader, contextLoader, tracerProvider, clone, getNodeInfoUri, getActorUri, getObjectUri, getCollectionUri, getOutboxUri, getInboxUri, getFollowingUri, getFollowersUri, getLikedUri, getFeaturedUri, getFeaturedTagsUri, parseUri, getActorKeyPairs, getDocumentLoader, lookupObject: lookupObject$1, traverseCollection: traverseCollection$1, lookupNodeInfo, lookupWebFinger: lookupWebFinger$1, sendActivity, routeActivity } = values;
 	function throwRouteError() {
@@ -108,7 +108,7 @@ function createInboxContext(args) {
 }
 
 //#endregion
-//#region mock.ts
+//#region src/mock.ts
 /**
 * Helper function to expand URI templates with values.
 * Supports simple placeholders like {identifier}, {handle}, etc.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/testing",
-  "version": "1.8.1-dev.1233+f748fcc5",
+  "version": "1.8.1-dev.1238+4e631e65",
   "description": "Testing utilities for Fedify applications",
   "keywords": [
     "fedify",
@@ -19,7 +19,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fedify-dev/fedify.git",
-    "directory": "testing"
+    "directory": "packages/testing"
   },
   "bugs": {
     "url": "https://github.com/fedify-dev/fedify/issues"
@@ -40,8 +40,15 @@
     },
     "./package.json": "./package.json"
   },
+  "files": [
+    "dist",
+    "package.json"
+  ],
   "peerDependencies": {
-    "@fedify/fedify": "1.8.1-dev.1233+f748fcc5"
+    "@fedify/fedify": "1.8.1-dev.1238+4e631e65"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0"
   },
   "devDependencies": {
     "@js-temporal/polyfill": "^0.5.1",
@@ -50,9 +57,6 @@
     "tsdown": "^0.12.9",
     "typescript": "^5.8.3"
   },
-  "dependencies": {
-    "@opentelemetry/api": "^1.9.0"
-  },
   "scripts": {
     "build": "tsdown",
     "prepublish": "tsdown",

package/context.ts

@@ -1,156 +0,0 @@
-import type {
-  Context,
-  Federation,
-  InboxContext,
-  RequestContext,
-} from "@fedify/fedify/federation";
-import { RouterError } from "@fedify/fedify/federation";
-import {
-  lookupObject as globalLookupObject,
-  traverseCollection as globalTraverseCollection,
-} from "@fedify/fedify/vocab";
-import { lookupWebFinger as globalLookupWebFinger } from "@fedify/fedify/webfinger";
-import { trace } from "@opentelemetry/api";
-import { mockDocumentLoader } from "./docloader.ts";
-
-// NOTE: Copied from @fedify/fedify/testing/context.ts
-
-export function createContext<TContextData>(
-  values: Partial<Context<TContextData>> & {
-    url?: URL;
-    data: TContextData;
-    federation: Federation<TContextData>;
-  },
-): Context<TContextData> {
-  const {
-    federation,
-    url = new URL("http://example.com/"),
-    canonicalOrigin,
-    data,
-    documentLoader,
-    contextLoader,
-    tracerProvider,
-    clone,
-    getNodeInfoUri,
-    getActorUri,
-    getObjectUri,
-    getCollectionUri,
-    getOutboxUri,
-    getInboxUri,
-    getFollowingUri,
-    getFollowersUri,
-    getLikedUri,
-    getFeaturedUri,
-    getFeaturedTagsUri,
-    parseUri,
-    getActorKeyPairs,
-    getDocumentLoader,
-    lookupObject,
-    traverseCollection,
-    lookupNodeInfo,
-    lookupWebFinger,
-    sendActivity,
-    routeActivity,
-  } = values;
-  function throwRouteError(): URL {
-    throw new RouterError("Not implemented");
-  }
-  return {
-    federation,
-    data,
-    origin: url.origin,
-    canonicalOrigin: canonicalOrigin ?? url.origin,
-    host: url.host,
-    hostname: url.hostname,
-    documentLoader: documentLoader ?? mockDocumentLoader,
-    contextLoader: contextLoader ?? mockDocumentLoader,
-    tracerProvider: tracerProvider ?? trace.getTracerProvider(),
-    clone: clone ?? ((data) => createContext({ ...values, data })),
-    getNodeInfoUri: getNodeInfoUri ?? throwRouteError,
-    getActorUri: getActorUri ?? throwRouteError,
-    getObjectUri: getObjectUri ?? throwRouteError,
-    getCollectionUri: getCollectionUri ?? throwRouteError,
-    getOutboxUri: getOutboxUri ?? throwRouteError,
-    getInboxUri: getInboxUri ?? throwRouteError,
-    getFollowingUri: getFollowingUri ?? throwRouteError,
-    getFollowersUri: getFollowersUri ?? throwRouteError,
-    getLikedUri: getLikedUri ?? throwRouteError,
-    getFeaturedUri: getFeaturedUri ?? throwRouteError,
-    getFeaturedTagsUri: getFeaturedTagsUri ?? throwRouteError,
-    parseUri: parseUri ?? ((_uri) => {
-      throw new Error("Not implemented");
-    }),
-    getDocumentLoader: getDocumentLoader ?? ((_params) => {
-      throw new Error("Not implemented");
-    }),
-    getActorKeyPairs: getActorKeyPairs ?? ((_handle) => Promise.resolve([])),
-    lookupObject: lookupObject ?? ((uri, options = {}) => {
-      return globalLookupObject(uri, {
-        documentLoader: options.documentLoader ?? documentLoader ??
-          mockDocumentLoader,
-        contextLoader: options.contextLoader ?? contextLoader ??
-          mockDocumentLoader,
-      });
-    }),
-    traverseCollection: traverseCollection ?? ((collection, options = {}) => {
-      return globalTraverseCollection(collection, {
-        documentLoader: options.documentLoader ?? documentLoader ??
-          mockDocumentLoader,
-        contextLoader: options.contextLoader ?? contextLoader ??
-          mockDocumentLoader,
-      });
-    }),
-    lookupNodeInfo: lookupNodeInfo ?? ((_params) => {
-      throw new Error("Not implemented");
-    }),
-    lookupWebFinger: lookupWebFinger ?? ((resource, options = {}) => {
-      return globalLookupWebFinger(resource, options);
-    }),
-    sendActivity: sendActivity ?? ((_params) => {
-      throw new Error("Not implemented");
-    }),
-    routeActivity: routeActivity ?? ((_params) => {
-      throw new Error("Not implemented");
-    }),
-  };
-}
-
-export function createRequestContext<TContextData>(
-  args: Partial<RequestContext<TContextData>> & {
-    url: URL;
-    data: TContextData;
-    federation: Federation<TContextData>;
-  },
-): RequestContext<TContextData> {
-  return {
-    ...createContext(args),
-    clone: args.clone ?? ((data) => createRequestContext({ ...args, data })),
-    request: args.request ?? new Request(args.url),
-    url: args.url,
-    getActor: args.getActor ?? (() => Promise.resolve(null)),
-    getObject: args.getObject ?? (() => Promise.resolve(null)),
-    getSignedKey: args.getSignedKey ?? (() => Promise.resolve(null)),
-    getSignedKeyOwner: args.getSignedKeyOwner ?? (() => Promise.resolve(null)),
-    sendActivity: args.sendActivity ?? ((_params) => {
-      throw new Error("Not implemented");
-    }),
-  };
-}
-
-export function createInboxContext<TContextData>(
-  args: Partial<InboxContext<TContextData>> & {
-    url?: URL;
-    data: TContextData;
-    recipient?: string | null;
-    federation: Federation<TContextData>;
-  },
-): InboxContext<TContextData> {
-  return {
-    ...createContext(args),
-    clone: args.clone ?? ((data) => createInboxContext({ ...args, data })),
-    recipient: args.recipient ?? null,
-    forwardActivity: args.forwardActivity ?? ((_params) => {
-      throw new Error("Not implemented");
-    }),
-  };
-}

package/deno.json

@@ -1,41 +0,0 @@
-{
-  "name": "@fedify/testing",
-  "version": "1.8.1-dev.1233+f748fcc5",
-  "license": "MIT",
-  "exports": {
-    ".": "./mod.ts"
-  },
-  "imports": {
-    "@opentelemetry/api": "npm:@opentelemetry/api@^1.9.0"
-  },
-  "exclude": [
-    ".github",
-    "node_modules",
-    "npm",
-    "pnpm-lock.yaml"
-  ],
-  "tasks": {
-    "build": "pnpm build",
-    "check": "deno fmt --check && deno lint && deno check mod.ts",
-    "test": "deno test --allow-read --allow-net",
-    "test:node": {
-      "dependencies": [
-        "build"
-      ],
-      "command": "node --experimental-transform-types --test"
-    },
-    "test:bun": {
-      "dependencies": [
-        "build"
-      ],
-      "command": "bun test --timeout 15000"
-    },
-    "test-all": {
-      "dependencies": [
-        "test",
-        "test:node",
-        "test:bun"
-      ]
-    }
-  }
-}

package/docloader.ts

@@ -1,8 +0,0 @@
-import type { DocumentLoader } from "@fedify/fedify/runtime";
-
-// deno-lint-ignore require-await
-export const mockDocumentLoader: DocumentLoader = async (url: string) => ({
-  contextUrl: null,
-  document: {},
-  documentUrl: url,
-});

package/mock.test.ts

@@ -1,361 +0,0 @@
-import { Create, Note, Person } from "@fedify/fedify/vocab";
-import { assertEquals, assertRejects } from "@std/assert";
-import { test } from "../fedify/testing/mod.ts";
-import { MockContext, MockFederation } from "./mock.ts";
-
-test("getSentActivities returns sent activities", async () => {
-  const mockFederation = new MockFederation<void>();
-  const context = mockFederation.createContext(
-    new URL("https://example.com"),
-    undefined,
-  );
-
-  // Create a test activity
-  const activity = new Create({
-    id: new URL("https://example.com/activities/1"),
-    actor: new URL("https://example.com/users/alice"),
-    object: new Note({
-      id: new URL("https://example.com/notes/1"),
-      content: "Hello, world!",
-    }),
-  });
-
-  // Send the activity
-  await context.sendActivity(
-    { identifier: "alice" },
-    new Person({ id: new URL("https://example.com/users/bob") }),
-    activity,
-  );
-
-  // Check that the activity was recorded
-  assertEquals(mockFederation.sentActivities.length, 1);
-  assertEquals(mockFederation.sentActivities[0].activity, activity);
-  assertEquals(mockFederation.sentActivities[0].queued, false);
-  assertEquals(mockFederation.sentActivities[0].sentOrder, 1);
-});
-
-test("reset clears sent activities", async () => {
-  const mockFederation = new MockFederation<void>();
-  const context = mockFederation.createContext(
-    new URL("https://example.com"),
-    undefined,
-  );
-
-  // Send an activity
-  const activity = new Create({
-    id: new URL("https://example.com/activities/1"),
-    actor: new URL("https://example.com/users/alice"),
-  });
-
-  await context.sendActivity(
-    { identifier: "alice" },
-    new Person({ id: new URL("https://example.com/users/bob") }),
-    activity,
-  );
-
-  // Verify it was sent
-  assertEquals(mockFederation.sentActivities.length, 1);
-  assertEquals(mockFederation.sentActivities[0].activity, activity);
-
-  // Clear sent activities
-  mockFederation.reset();
-
-  // Verify they were cleared
-  assertEquals(mockFederation.sentActivities.length, 0);
-});
-
-test("receiveActivity triggers inbox listeners", async () => {
-  // Provide contextData through constructor
-  const mockFederation = new MockFederation<{ test: string }>({
-    contextData: { test: "data" },
-  });
-  let receivedActivity: Create | null = null;
-
-  // Set up an inbox listener
-  mockFederation
-    .setInboxListeners("/users/{identifier}/inbox")
-    // deno-lint-ignore require-await
-    .on(Create, async (_ctx, activity) => {
-      receivedActivity = activity;
-    });
-
-  // Create and receive an activity
-  const activity = new Create({
-    id: new URL("https://example.com/activities/1"),
-    actor: new URL("https://example.com/users/alice"),
-    object: new Note({
-      id: new URL("https://example.com/notes/1"),
-      content: "Test note",
-    }),
-  });
-
-  await mockFederation.receiveActivity(activity);
-
-  // Verify the listener was triggered
-  assertEquals(receivedActivity, activity);
-});
-
-test("MockContext tracks sent activities", async () => {
-  const mockFederation = new MockFederation<void>();
-  const mockContext = new MockContext({
-    url: new URL("https://example.com"),
-    data: undefined,
-    federation: mockFederation,
-  });
-
-  // Create a test activity
-  const activity = new Create({
-    id: new URL("https://example.com/activities/1"),
-    actor: new URL("https://example.com/users/alice"),
-    object: new Note({
-      id: new URL("https://example.com/notes/1"),
-      content: "Hello from MockContext!",
-    }),
-  });
-
-  // Send the activity
-  await mockContext.sendActivity(
-    { identifier: "alice" },
-    new Person({ id: new URL("https://example.com/users/bob") }),
-    activity,
-  );
-
-  // Check that the activity was recorded in the context
-  const contextSentActivities = mockContext.getSentActivities();
-  assertEquals(contextSentActivities.length, 1);
-  assertEquals(contextSentActivities[0].activity, activity);
-
-  // Check that it was also recorded in the federation
-  assertEquals(mockFederation.sentActivities.length, 1);
-  assertEquals(mockFederation.sentActivities[0].activity, activity);
-});
-
-test("MockContext URI methods should work correctly", () => {
-  const mockFederation = new MockFederation<void>();
-  const mockContext = new MockContext({
-    url: new URL("https://example.com"),
-    data: undefined,
-    federation: mockFederation,
-  });
-
-  // Test URI generation methods
-  assertEquals(
-    mockContext.getActorUri("alice").href,
-    "https://example.com/users/alice",
-  );
-  assertEquals(
-    mockContext.getInboxUri("alice").href,
-    "https://example.com/users/alice/inbox",
-  );
-  assertEquals(mockContext.getInboxUri().href, "https://example.com/inbox");
-  assertEquals(
-    mockContext.getOutboxUri("alice").href,
-    "https://example.com/users/alice/outbox",
-  );
-  assertEquals(
-    mockContext.getFollowingUri("alice").href,
-    "https://example.com/users/alice/following",
-  );
-  assertEquals(
-    mockContext.getFollowersUri("alice").href,
-    "https://example.com/users/alice/followers",
-  );
-
-  const actorUri = new URL("https://example.com/users/alice");
-  const parsed = mockContext.parseUri(actorUri);
-  assertEquals(parsed?.type, "actor");
-  if (parsed?.type === "actor") {
-    assertEquals(parsed.identifier, "alice");
-  }
-});
-
-test("MockContext URI methods respect registered paths", () => {
-  const mockFederation = new MockFederation<void>();
-
-  // Register custom paths with dummy dispatchers
-  mockFederation.setNodeInfoDispatcher("/.well-known/nodeinfo", () => ({
-    software: { name: "test", version: { major: 1, minor: 0, patch: 0 } },
-    protocols: [],
-    usage: {
-      users: {},
-      localPosts: 0,
-      localComments: 0,
-    },
-  }));
-  mockFederation.setActorDispatcher("/actors/{identifier}", () => null);
-  mockFederation.setObjectDispatcher(Note, "/notes/{id}", () => null);
-  mockFederation.setInboxListeners(
-    "/actors/{identifier}/inbox",
-    "/shared-inbox",
-  );
-  mockFederation.setOutboxDispatcher("/actors/{identifier}/outbox", () => null);
-  mockFederation.setFollowingDispatcher(
-    "/actors/{identifier}/following",
-    () => null,
-  );
-  mockFederation.setFollowersDispatcher(
-    "/actors/{identifier}/followers",
-    () => null,
-  );
-  mockFederation.setLikedDispatcher("/actors/{identifier}/liked", () => null);
-  mockFederation.setFeaturedDispatcher(
-    "/actors/{identifier}/featured",
-    () => null,
-  );
-  mockFederation.setFeaturedTagsDispatcher(
-    "/actors/{identifier}/tags",
-    () => null,
-  );
-
-  const context = mockFederation.createContext(
-    new URL("https://example.com"),
-    undefined,
-  );
-
-  // Test that URIs use the registered paths
-  assertEquals(
-    context.getNodeInfoUri().href,
-    "https://example.com/.well-known/nodeinfo",
-  );
-  assertEquals(
-    context.getActorUri("alice").href,
-    "https://example.com/actors/alice",
-  );
-  assertEquals(
-    context.getObjectUri(Note, { id: "123" }).href,
-    "https://example.com/notes/123",
-  );
-  assertEquals(
-    context.getInboxUri("alice").href,
-    "https://example.com/actors/alice/inbox",
-  );
-  assertEquals(
-    context.getInboxUri().href,
-    "https://example.com/shared-inbox",
-  );
-  assertEquals(
-    context.getOutboxUri("alice").href,
-    "https://example.com/actors/alice/outbox",
-  );
-  assertEquals(
-    context.getFollowingUri("alice").href,
-    "https://example.com/actors/alice/following",
-  );
-  assertEquals(
-    context.getFollowersUri("alice").href,
-    "https://example.com/actors/alice/followers",
-  );
-  assertEquals(
-    context.getLikedUri("alice").href,
-    "https://example.com/actors/alice/liked",
-  );
-  assertEquals(
-    context.getFeaturedUri("alice").href,
-    "https://example.com/actors/alice/featured",
-  );
-  assertEquals(
-    context.getFeaturedTagsUri("alice").href,
-    "https://example.com/actors/alice/tags",
-  );
-});
-
-test("receiveActivity throws error when contextData not initialized", async () => {
-  const mockFederation = new MockFederation<void>();
-
-  // Set up an inbox listener without initializing contextData
-  mockFederation
-    .setInboxListeners("/users/{identifier}/inbox")
-    .on(Create, async (_ctx, _activity) => {
-      /* should not happen */
-    });
-
-  const activity = new Create({
-    id: new URL("https://example.com/activities/1"),
-    actor: new URL("https://example.com/users/alice"),
-  });
-
-  // Should throw error
-  await assertRejects(
-    () => mockFederation.receiveActivity(activity),
-    Error,
-    "MockFederation.receiveActivity(): contextData is not initialized. Please provide contextData through the constructor or call startQueue() before receiving activities.",
-  );
-});
-
-test("MockFederation distinguishes between immediate and queued activities", async () => {
-  const mockFederation = new MockFederation<void>();
-
-  // Start the queue to enable queued sending
-  await mockFederation.startQueue(undefined);
-
-  const context = mockFederation.createContext(
-    new URL("https://example.com"),
-    undefined,
-  );
-
-  const activity1 = new Create({
-    id: new URL("https://example.com/activities/1"),
-    actor: new URL("https://example.com/users/alice"),
-  });
-
-  const activity2 = new Create({
-    id: new URL("https://example.com/activities/2"),
-    actor: new URL("https://example.com/users/alice"),
-  });
-
-  // Send activities after queue is started - should be marked as queued
-  await context.sendActivity(
-    { identifier: "alice" },
-    new Person({ id: new URL("https://example.com/users/bob") }),
-    activity1,
-  );
-
-  await context.sendActivity(
-    { identifier: "alice" },
-    new Person({ id: new URL("https://example.com/users/bob") }),
-    activity2,
-  );
-
-  // Check activity details
-  assertEquals(mockFederation.sentActivities.length, 2);
-  assertEquals(mockFederation.sentActivities[0].activity, activity1);
-  assertEquals(mockFederation.sentActivities[1].activity, activity2);
-
-  // Both should be marked as sent via queue
-  assertEquals(mockFederation.sentActivities[0].queued, true);
-  assertEquals(mockFederation.sentActivities[1].queued, true);
-  assertEquals(mockFederation.sentActivities[0].queue, "outbox");
-  assertEquals(mockFederation.sentActivities[1].queue, "outbox");
-  assertEquals(mockFederation.sentActivities[0].sentOrder, 1);
-  assertEquals(mockFederation.sentActivities[1].sentOrder, 2);
-});
-
-test("MockFederation without queue sends all activities immediately", async () => {
-  const mockFederation = new MockFederation<void>();
-
-  const context = mockFederation.createContext(
-    new URL("https://example.com"),
-    undefined,
-  );
-
-  const activity = new Create({
-    id: new URL("https://example.com/activities/1"),
-    actor: new URL("https://example.com/users/alice"),
-  });
-
-  // Send activity - should be marked as immediate since queue not started
-  await context.sendActivity(
-    { identifier: "alice" },
-    new Person({ id: new URL("https://example.com/users/bob") }),
-    activity,
-  );
-
-  // Check activity details
-  assertEquals(mockFederation.sentActivities.length, 1);
-  assertEquals(mockFederation.sentActivities[0].activity, activity);
-
-  // Should be marked as sent immediately
-  assertEquals(mockFederation.sentActivities[0].queued, false);
-  assertEquals(mockFederation.sentActivities[0].queue, undefined);
-  assertEquals(mockFederation.sentActivities[0].sentOrder, 1);
-});