Class: FakePiefedInstance

Defined in: src/testing/piefed/index.ts:269

FakeInstance for PieFed whose default routes are derived, per request, from the semantic seed store — tests describe what exists, not which endpoint returns it:

const alex = fake.seed.person({ name: "alex" });
fake.seed.post({ name: "Hello **world**", creator: alex });

Derived: site, post list/detail, comment list (honoring parent_id and max_depth), search, community, person, unread counts, the notification fan-out (replies/mentions/private messages), and the vote/save/create/ edit/delete/mark-read writes (which mutate the store). Lists paginate by 1-based page number, like the real server. Use mock() for error injection or endpoints outside this set. Wire-level builders stay available on build.

Extends

• FakeInstance

Constructors

Constructor

new FakePiefedInstance(__namedParameters?): FakePiefedInstance;

Defined in: src/testing/piefed/index.ts:290

Parameters

Parameter	Type
__namedParameters	FakePiefedInstanceOptions

Returns

FakePiefedInstance

Overrides

FakeInstance.constructor

Properties

Property	Modifier	Type	Description	Inherited from	Defined in
host	readonly	string	-	FakeInstance.host	src/testing/FakeInstance.ts:149
origin	readonly	string	-	FakeInstance.origin	src/testing/FakeInstance.ts:151
software	readonly	object	-	FakeInstance.software	src/testing/FakeInstance.ts:153
software.name	public	string	-	-	src/wellknown.ts:24
software.version	public	string	-	-	src/wellknown.ts:25
fetch	readonly	{ (input, init?): Promise<Response>; (input, init?): Promise<Response>; }	fetch-compatible adapter. Prefer clientOptions() when constructing a ThreadiverseClient; use this directly to install a global fetch mock. Unrouted requests and { abort } responses throw TypeError, like a real network failure.	FakeInstance.fetch	src/testing/FakeInstance.ts:230
build	readonly	object	Wire-format builders bound to this instance's host	-	src/testing/piefed/index.ts:271
build.commentListResponse	public	(comments, nextPage) => object	-	-	src/testing/piefed/builders.ts:441
build.commentReplyView	public	(over) => object	-	-	src/testing/piefed/builders.ts:442
build.commentView	public	(over) => object	-	-	src/testing/piefed/builders.ts:443
build.community	public	(over) => object	-	-	src/testing/piefed/builders.ts:444
build.communityResponse	public	(over) => object	-	-	src/testing/piefed/builders.ts:445
build.communityView	public	(over) => object	-	-	src/testing/piefed/builders.ts:446
build.getSiteResponse	public	(over) => object	-	-	src/testing/piefed/builders.ts:447
build.localUser	public	() => object	-	-	src/testing/piefed/builders.ts:448
build.myUserInfo	public	(subject) => object	-	-	src/testing/piefed/builders.ts:449
build.person	public	(over) => object	-	-	src/testing/piefed/builders.ts:450
build.personView	public	(subject) => object	-	-	src/testing/piefed/builders.ts:451
build.post	public	(over) => object	-	-	src/testing/piefed/builders.ts:452
build.postListResponse	public	(posts, nextPage) => object	-	-	src/testing/piefed/builders.ts:453
build.postView	public	(over) => object	-	-	src/testing/piefed/builders.ts:454
build.privateMessageListResponse	public	(private_messages) => object	-	-	src/testing/piefed/builders.ts:455
build.privateMessageView	public	(over) => object	-	-	src/testing/piefed/builders.ts:456
build.repliesResponse	public	(replies, nextPage) => object	-	-	src/testing/piefed/builders.ts:457
build.searchResponse	public	(over) => object	-	-	src/testing/piefed/builders.ts:458
build.userResponse	public	(subject) => object	-	-	src/testing/piefed/builders.ts:459
callsTo	readonly	<Operation>(operation) => PayloadOf<object[Operation]>[]	Canonical payloads of the requests an operation received	-	src/testing/piefed/index.ts:274
on	readonly	object	Override an operation's response (canonical { error } supported)	-	src/testing/piefed/index.ts:277
on.createComment	public	(responder) => void	-	-	src/testing/piefed/index.ts:65
on.createPost	public	(responder) => void	-	-	src/testing/piefed/index.ts:73
on.createPrivateMessage	public	(responder) => void	-	-	src/testing/piefed/index.ts:82
on.deleteComment	public	(responder) => void	-	-	src/testing/piefed/index.ts:86
on.deletePost	public	(responder) => void	-	-	src/testing/piefed/index.ts:90
on.editComment	public	(responder) => void	-	-	src/testing/piefed/index.ts:94
on.editPost	public	(responder) => void	-	-	src/testing/piefed/index.ts:102
on.followCommunity	public	(responder) => void	-	-	src/testing/piefed/index.ts:111
on.getComments	public	(responder) => void	-	-	src/testing/piefed/index.ts:115
on.getCommunity	public	(responder) => void	-	-	src/testing/piefed/index.ts:138
on.getPersonDetails	public	(responder) => void	-	-	src/testing/piefed/index.ts:144
on.getPost	public	(responder) => void	-	-	src/testing/piefed/index.ts:150
on.getPosts	public	(responder) => void	-	-	src/testing/piefed/index.ts:156
on.getSite	public	(responder) => void	-	-	src/testing/piefed/index.ts:171
on.getUnreadCount	public	(responder) => void	-	-	src/testing/piefed/index.ts:172
on.likeComment	public	(responder) => void	-	-	src/testing/piefed/index.ts:173
on.likePost	public	(responder) => void	-	-	src/testing/piefed/index.ts:180
on.login	public	(responder) => void	-	-	src/testing/piefed/index.ts:187
on.markAllAsRead	public	(responder) => void	-	-	src/testing/piefed/index.ts:194
on.markPostAsRead	public	(responder) => void	-	-	src/testing/piefed/index.ts:197
on.resolveObject	public	(responder) => void	-	-	src/testing/piefed/index.ts:201
on.saveComment	public	(responder) => void	-	-	src/testing/piefed/index.ts:207
on.savePost	public	(responder) => void	-	-	src/testing/piefed/index.ts:211
on.search	public	(responder) => void	-	-	src/testing/piefed/index.ts:212
once	readonly	object	Override an operation's next response only, then fall back	-	src/testing/piefed/index.ts:280
once.createComment	public	(responder) => void	-	-	src/testing/piefed/index.ts:65
once.createPost	public	(responder) => void	-	-	src/testing/piefed/index.ts:73
once.createPrivateMessage	public	(responder) => void	-	-	src/testing/piefed/index.ts:82
once.deleteComment	public	(responder) => void	-	-	src/testing/piefed/index.ts:86
once.deletePost	public	(responder) => void	-	-	src/testing/piefed/index.ts:90
once.editComment	public	(responder) => void	-	-	src/testing/piefed/index.ts:94
once.editPost	public	(responder) => void	-	-	src/testing/piefed/index.ts:102
once.followCommunity	public	(responder) => void	-	-	src/testing/piefed/index.ts:111
once.getComments	public	(responder) => void	-	-	src/testing/piefed/index.ts:115
once.getCommunity	public	(responder) => void	-	-	src/testing/piefed/index.ts:138
once.getPersonDetails	public	(responder) => void	-	-	src/testing/piefed/index.ts:144
once.getPost	public	(responder) => void	-	-	src/testing/piefed/index.ts:150
once.getPosts	public	(responder) => void	-	-	src/testing/piefed/index.ts:156
once.getSite	public	(responder) => void	-	-	src/testing/piefed/index.ts:171
once.getUnreadCount	public	(responder) => void	-	-	src/testing/piefed/index.ts:172
once.likeComment	public	(responder) => void	-	-	src/testing/piefed/index.ts:173
once.likePost	public	(responder) => void	-	-	src/testing/piefed/index.ts:180
once.login	public	(responder) => void	-	-	src/testing/piefed/index.ts:187
once.markAllAsRead	public	(responder) => void	-	-	src/testing/piefed/index.ts:194
once.markPostAsRead	public	(responder) => void	-	-	src/testing/piefed/index.ts:197
once.resolveObject	public	(responder) => void	-	-	src/testing/piefed/index.ts:201
once.saveComment	public	(responder) => void	-	-	src/testing/piefed/index.ts:207
once.savePost	public	(responder) => void	-	-	src/testing/piefed/index.ts:211
once.search	public	(responder) => void	-	-	src/testing/piefed/index.ts:212
seed	readonly	SeedStore	Semantic content store the default routes are derived from	-	src/testing/piefed/index.ts:283
waitForPayload	readonly	<Operation>(operation, predicate?, options?) => Promise<PayloadOf<object[Operation]>>	Wait for an operation's next request; resolves its canonical payload	-	src/testing/piefed/index.ts:286

Methods

allCalls()

allCalls(): RecordedCall[];

Defined in: src/testing/FakeInstance.ts:196

Every request this instance received, in order.

For "nothing was sent" claims: asserting a specific route was never called can't fail if the client has no way to call it, whereas comparing this list before and after an action genuinely checks that the action stayed local.

Returns

RecordedCall[]

Inherited from

FakeInstance.allCalls

---

calls()

calls(matcher): RecordedCall[];

Defined in: src/testing/FakeInstance.ts:201

All recorded requests matching "METHOD /path" (query ignored).

Parameters

Parameter	Type
matcher	| `POST /${string}` | `DELETE /${string}` | `GET /${string}` | `PUT /${string}`

Returns

RecordedCall[]

Inherited from

FakeInstance.calls

---

clientOptions()

clientOptions(): ThreadiverseClientOptions;

Defined in: src/testing/FakeInstance.ts:217

Options for a ThreadiverseClient scoped to this fake: routes fetch through the instance and isolates software discovery from the process-global cache (so multiple fakes for the same host — e.g. different versions across tests — can't contaminate each other).

const client = new ThreadiverseClient(fake.origin, fake.clientOptions());

Returns

ThreadiverseClientOptions

Inherited from

FakeInstance.clientOptions

---

handle()

handle(request): Promise<FakeResponse | undefined>;

Defined in: src/testing/FakeInstance.ts:264

Resolve a request against the route table.

Returns undefined for requests to other origins (callers decide whether to pass those through). Unmocked same-origin requests are answered with a loud 404 instead of escaping to the real network.

Parameters

Parameter	Type
request	FakeRequest

Returns

Promise<FakeResponse | undefined>

Inherited from

FakeInstance.handle

---

install()

install(page): Promise<void>;

Defined in: src/testing/FakeInstance.ts:302

Install onto a Playwright page. Routes all traffic for this instance's origin; other origins are untouched.

Parameters

Parameter	Type
page	PageLike

Returns

Promise<void>

Inherited from

FakeInstance.install

---

mock()

mock(matcher, responder): void;

Defined in: src/testing/FakeInstance.ts:329

Set (or replace) the response for an endpoint. Last call wins.

Parameters

Parameter	Type
matcher	| `POST /${string}` | `DELETE /${string}` | `GET /${string}` | `PUT /${string}`
responder	Responder

Returns

void

Inherited from

FakeInstance.mock

---

mockOnce()

mockOnce(matcher, responder): void;

Defined in: src/testing/FakeInstance.ts:334

Respond once for an endpoint, then fall back to the standing mock.

Parameters

Parameter	Type
matcher	| `POST /${string}` | `DELETE /${string}` | `GET /${string}` | `PUT /${string}`
responder	Responder

Returns

void

Inherited from

FakeInstance.mockOnce

---

waitForCall()

waitForCall(
   matcher, 
   predicate?, 
__namedParameters?): Promise<RecordedCall>;

Defined in: src/testing/FakeInstance.ts:345

Wait until a matching request is recorded, then return the latest. Resolution is push-based (no polling), so pending waiters settle the moment the request lands — only the timeout path needs real timers.

Parameters

Parameter	Type
matcher	| `POST /${string}` | `DELETE /${string}` | `GET /${string}` | `PUT /${string}`
predicate	(call) => boolean
__namedParameters	{ timeoutMs?: number; }
__namedParameters.timeoutMs?	number

Returns

Promise<RecordedCall>

Inherited from

FakeInstance.waitForCall

---

buildOperationApi()

protected buildOperationApi<Ops>(operations, renderError): OperationApi<Ops>;

Defined in: src/testing/FakeInstance.ts:380

Build the operation-level API (on/once/callsTo/waitForPayload) from a provider's operation definitions plus its error wire renderer.

Type Parameters

Type Parameter
Ops extends Record<string, OperationDef<unknown>>

Parameters

Parameter	Type
operations	Ops
renderError	(error) => FakeResponse

Returns

OperationApi<Ops>

Inherited from

FakeInstance.buildOperationApi