@fedify/testing 1.8.1-pr.283.1138 → 1.8.1-pr.315.1275

package/README.md

@@ -1,4 +1,7 @@
-# @fedify/testing
+<!-- deno-fmt-ignore-file -->
+
+@fedify/testing
+===============
 
 Testing utilities for Fedify applications.
 
@@ -6,32 +9,36 @@ This package provides mock implementations of the `Federation` and `Context`
 interfaces to facilitate unit testing of federated applications built with
 Fedify.
 
-## Installation
 
-```bash
+Installation
+------------
+
+~~~~ bash
 deno add @fedify/testing
-```
+~~~~
 
-```bash
+~~~~ bash
 npm install @fedify/testing
-```
+~~~~
 
-```bash
+~~~~ bash
 pnpm add @fedify/testing
-```
+~~~~
 
-```bash
+~~~~ bash
 yarn add @fedify/testing
-```
+~~~~
+
 
-## Usage
+Usage
+-----
 
-### MockFederation
+### `MockFederation`
 
 The `MockFederation` class provides a mock implementation of the `Federation`
 interface for unit testing:
 
-```typescript
+~~~~ typescript
 import { MockFederation } from "@fedify/testing";
 import { Create } from "@fedify/fedify/vocab";
 
@@ -51,14 +58,14 @@ await federation.receiveActivity(createActivity);
 // Check sent activities
 const sent = federation.sentActivities;
 console.log(sent[0].activity);
-```
+~~~~
 
-### MockContext
+### `MockContext`
 
 The `MockContext` class provides a mock implementation of the `Context`
 interface:
 
-```typescript
+~~~~ typescript
 import { MockContext } from "@fedify/testing";
 
 // Create a mock context
@@ -78,15 +85,15 @@ await context.sendActivity(
 // Check sent activities
 const sent = context.getSentActivities();
 console.log(sent[0].activity);
-```
+~~~~
 
-### Helper Functions
+### Helper functions
 
 The package also exports helper functions for creating various context types:
 
-- `createContext()` - Creates a basic context
-- `createRequestContext()` - Creates a request context
-- `createInboxContext()` - Creates an inbox context
+ -  `createContext()`: Creates a basic context
+ -  `createRequestContext()`: Creates a request context
+ -  `createInboxContext()`: Creates an inbox context
 
 ## Features
 
@@ -95,7 +102,3 @@ The package also exports helper functions for creating various context types:
 - Configure custom URI templates
 - Test queue-based activity processing
 - Mock document loaders and context loaders
-
-## License
-
-MIT

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.
@@ -51,7 +51,7 @@ interface SentActivity {
  * await federation.receiveActivity(createActivity);
  * ```
  *
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  * @since 1.8.0
  */
 declare class MockFederation<TContextData> implements Federation<TContextData> {
@@ -124,6 +124,8 @@ declare class MockFederation<TContextData> implements Federation<TContextData> {
    * @since 1.8.0
    */
   reset(): void;
+  setCollectionDispatcher<TObject extends Object$1, TParams extends Record<string, string>>(_name: string | symbol, _itemType: any, _path: any, _dispatcher: any): any;
+  setOrderedCollectionDispatcher<TObject extends Object$1, TParams extends Record<string, string>>(_name: string | symbol, _itemType: any, _path: any, _dispatcher: any): any;
 }
 /**
  * A mock implementation of the {@link Context} interface for unit testing.
@@ -160,7 +162,7 @@ declare class MockFederation<TContextData> implements Federation<TContextData> {
  * console.log(sent[0].activity);
  * ```
  *
- * @typeParam TContextData The context data to pass to the {@link Context}.
+ * @template TContextData The context data to pass to the {@link Context}.
  * @since 1.8.0
  */
 declare class MockContext<TContextData> implements Context<TContextData> {
@@ -196,6 +198,7 @@ declare class MockContext<TContextData> implements Context<TContextData> {
   getLikedUri(identifier: string): URL;
   getFeaturedUri(identifier: string): URL;
   getFeaturedTagsUri(identifier: string): URL;
+  getCollectionUri<TParam extends Record<string, string>>(_name: string | symbol, values: TParam): URL;
   parseUri(uri: URL): ParseUriResult | null;
   getActorKeyPairs(_identifier: string): Promise<ActorKeyPair[]>;
   getDocumentLoader(params: {

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,9 +11,9 @@ 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, getOutboxUri, getInboxUri, getFollowingUri, getFollowersUri, getLikedUri, getFeaturedUri, getFeaturedTagsUri, parseUri, getActorKeyPairs, getDocumentLoader, lookupObject: lookupObject$1, traverseCollection: traverseCollection$1, lookupNodeInfo, lookupWebFinger: lookupWebFinger$1, sendActivity, routeActivity } = 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() {
 		throw new RouterError("Not implemented");
 	}
@@ -34,6 +34,7 @@ function createContext(values) {
 		getNodeInfoUri: getNodeInfoUri ?? throwRouteError,
 		getActorUri: getActorUri ?? throwRouteError,
 		getObjectUri: getObjectUri ?? throwRouteError,
+		getCollectionUri: getCollectionUri ?? throwRouteError,
 		getOutboxUri: getOutboxUri ?? throwRouteError,
 		getInboxUri: getInboxUri ?? throwRouteError,
 		getFollowingUri: getFollowingUri ?? throwRouteError,
@@ -107,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.
@@ -150,7 +151,7 @@ function expandUriTemplate(template, values) {
 * await federation.receiveActivity(createActivity);
 * ```
 *
-* @typeParam TContextData The context data to pass to the {@link Context}.
+* @template TContextData The context data to pass to the {@link Context}.
 * @since 1.8.0
 */
 var MockFederation = class {
@@ -363,6 +364,22 @@ var MockFederation = class {
 	reset() {
 		this.sentActivities = [];
 	}
+	setCollectionDispatcher(_name, _itemType, _path, _dispatcher) {
+		return {
+			setCounter: () => this,
+			setFirstCursor: () => this,
+			setLastCursor: () => this,
+			authorize: () => this
+		};
+	}
+	setOrderedCollectionDispatcher(_name, _itemType, _path, _dispatcher) {
+		return {
+			setCounter: () => this,
+			setFirstCursor: () => this,
+			setLastCursor: () => this,
+			authorize: () => this
+		};
+	}
 };
 /**
 * A mock implementation of the {@link Context} interface for unit testing.
@@ -399,7 +416,7 @@ var MockFederation = class {
 * console.log(sent[0].activity);
 * ```
 *
-* @typeParam TContextData The context data to pass to the {@link Context}.
+* @template TContextData The context data to pass to the {@link Context}.
 * @since 1.8.0
 */
 var MockContext = class MockContext {
@@ -538,6 +555,10 @@ var MockContext = class MockContext {
 		}
 		return new URL(`/users/${identifier}/tags`, this.origin);
 	}
+	getCollectionUri(_name, values) {
+		const path = globalThis.Object.entries(values).map(([key, value]) => `${key}/${value}`).join("/");
+		return new URL(`/collections/${String(_name)}/${path}`, this.origin);
+	}
 	parseUri(uri) {
 		if (uri.pathname.startsWith("/users/")) {
 			const parts = uri.pathname.split("/");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/testing",
-  "version": "1.8.1-pr.283.1138+8009e193",
+  "version": "1.8.1-pr.315.1275+37d811f6",
   "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-pr.283.1138+8009e193"
+    "@fedify/fedify": "1.8.1-pr.315.1275+37d811f6"
+  },
+  "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,154 +0,0 @@
-import { trace } from "@opentelemetry/api";
-import type {
-  Context,
-  InboxContext,
-  RequestContext,
-} from "@fedify/fedify/federation";
-import type { Federation } 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 { 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,
-    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,
-    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-pr.283.1138+8009e193",
-  "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,
-});