@yolk-sdk/emulators 0.1.0-canary.96

package/dist/node.mjs

@@ -0,0 +1,178 @@
+import { Data, Effect, Predicate } from "effect";
+import { Buffer } from "node:buffer";
+import { createServer } from "node:http";
+//#region src/node.ts
+/**
+* Node boundary: serve an emulator fetch handler on loopback.
+*
+* This is the only module in the package that imports `node:` builtins.
+* Servers bind to `127.0.0.1` only. Streamed response bodies are written
+* chunk by chunk (honoring backpressure) so progressive delivery survives the
+* socket, and an erroring body stream destroys the connection mid-response,
+* the way a dropped upstream does.
+*
+* @experimental
+*/
+/** The only host emulator servers bind to. */
+const emulatorServerHost = "127.0.0.1";
+/** Serving failed: a refused host, an invalid port, or a listen error. */
+var EmulatorServeError = class extends Data.TaggedError("EmulatorServeError") {
+	get message() {
+		switch (this.reason) {
+			case "host-not-allowed": return `Emulator servers bind to ${emulatorServerHost} only`;
+			case "invalid-port": return "Emulator server port must be an integer from 0 to 65535";
+			case "listen-failed": return "Emulator server could not listen";
+		}
+	}
+};
+const validateOptions = (options) => {
+	if (options.host !== void 0 && options.host !== "127.0.0.1") return new EmulatorServeError({ reason: "host-not-allowed" });
+	const port = options.port ?? 0;
+	if (!Number.isInteger(port) || port < 0 || port > 65535) return new EmulatorServeError({ reason: "invalid-port" });
+};
+const readBody = (incoming) => new Promise((resolve, reject) => {
+	const chunks = [];
+	incoming.on("data", (chunk) => {
+		chunks.push(Predicate.isString(chunk) ? Buffer.from(chunk) : chunk);
+	});
+	incoming.on("end", () => resolve(new Uint8Array(Buffer.concat(chunks))));
+	incoming.on("error", reject);
+});
+const toWebRequest = async (incoming, origin) => {
+	const headers = new Headers();
+	for (const [name, value] of Object.entries(incoming.headers)) if (Array.isArray(value)) for (const item of value) headers.append(name, item);
+	else if (value !== void 0) headers.set(name, value);
+	const method = incoming.method ?? "GET";
+	const body = await readBody(incoming);
+	const init = {
+		method,
+		headers
+	};
+	if (method !== "GET" && method !== "HEAD" && body.byteLength > 0) init.body = body;
+	return new Request(new URL(incoming.url ?? "/", origin), init);
+};
+const waitForDrain = (outgoing) => new Promise((resolve) => {
+	const done = () => {
+		outgoing.off("drain", done);
+		outgoing.off("close", done);
+		resolve();
+	};
+	outgoing.on("drain", done);
+	outgoing.on("close", done);
+});
+/**
+* Write a web `Response` to a Node response: status and headers first, then
+* each body chunk as soon as the handler produces it. A body stream error
+* destroys the socket mid-response.
+*/
+const writeResponse = async (outgoing, response) => {
+	outgoing.statusCode = response.status;
+	if (response.statusText.length > 0) outgoing.statusMessage = response.statusText;
+	response.headers.forEach((value, name) => {
+		if (name !== "set-cookie") outgoing.setHeader(name, value);
+	});
+	const cookies = response.headers.getSetCookie();
+	if (cookies.length > 0) outgoing.setHeader("set-cookie", cookies);
+	if (response.body === null) {
+		outgoing.end();
+		return;
+	}
+	outgoing.flushHeaders();
+	const reader = response.body.getReader();
+	outgoing.on("close", () => {
+		if (!outgoing.writableFinished) reader.cancel().catch(() => void 0);
+	});
+	const pump = async () => {
+		const { done, value } = await reader.read();
+		if (done || outgoing.destroyed) {
+			outgoing.end();
+			return;
+		}
+		if (!outgoing.write(value)) await waitForDrain(outgoing);
+		return pump();
+	};
+	await pump().catch(() => {
+		outgoing.destroy();
+	});
+};
+const handleRequest = (handler, origin, incoming, outgoing) => toWebRequest(incoming, origin).then(handler).then((response) => writeResponse(outgoing, response), () => {
+	if (outgoing.headersSent) {
+		outgoing.destroy();
+		return;
+	}
+	outgoing.statusCode = 500;
+	outgoing.setHeader("content-type", "text/plain");
+	outgoing.end("emulator handler failed");
+}).catch(() => {
+	outgoing.destroy();
+});
+/**
+* Serve a fetch handler on `127.0.0.1` (Promise variant, for hosts without an
+* Effect runtime). Rejects with `EmulatorServeError` for a non-loopback host,
+* an invalid port, or a listen failure.
+*/
+const startFetchHandlerServer = (handler, options = {}) => {
+	const invalid = validateOptions(options);
+	if (invalid !== void 0) return Promise.reject(invalid);
+	const sockets = /* @__PURE__ */ new Set();
+	const server = createServer();
+	let origin = "";
+	server.on("connection", (socket) => {
+		socket.setNoDelay(true);
+		sockets.add(socket);
+		socket.on("close", () => sockets.delete(socket));
+	});
+	server.on("request", (incoming, outgoing) => {
+		handleRequest(handler, origin, incoming, outgoing);
+	});
+	let closing;
+	const close = () => {
+		closing ??= new Promise((resolve) => {
+			server.close(() => resolve());
+			for (const socket of sockets) socket.destroy();
+		});
+		return closing;
+	};
+	return new Promise((resolve, reject) => {
+		server.once("error", (cause) => reject(new EmulatorServeError({
+			reason: "listen-failed",
+			cause
+		})));
+		server.listen(options.port ?? 0, emulatorServerHost, () => {
+			const address = server.address();
+			if (address === null || Predicate.isString(address)) {
+				close();
+				reject(new EmulatorServeError({ reason: "listen-failed" }));
+				return;
+			}
+			origin = `http://${emulatorServerHost}:${address.port}`;
+			resolve({
+				url: origin,
+				close
+			});
+		});
+	});
+};
+/**
+* Serve a fetch handler on `127.0.0.1` as a scoped resource: the server
+* closes when the scope closes (or earlier via `close`). Fails with
+* `EmulatorServeError` for a non-loopback host, an invalid port, or a listen
+* failure.
+*/
+const serveFetchHandler = (handler, options = {}) => Effect.acquireRelease(Effect.suspend(() => {
+	const invalid = validateOptions(options);
+	return invalid === void 0 ? Effect.tryPromise({
+		try: () => startFetchHandlerServer(handler, options),
+		catch: (cause) => cause instanceof EmulatorServeError ? cause : new EmulatorServeError({
+			reason: "listen-failed",
+			cause
+		})
+	}) : Effect.fail(invalid);
+}), (server) => Effect.promise(() => server.close())).pipe(Effect.map((server) => ({
+	url: server.url,
+	close: Effect.promise(() => server.close())
+})));
+//#endregion
+export { EmulatorServeError, emulatorServerHost, serveFetchHandler, startFetchHandlerServer };
+
+//# sourceMappingURL=node.mjs.map

package/dist/node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.mjs","names":[],"sources":["../src/node.ts"],"sourcesContent":["/**\n * Node boundary: serve an emulator fetch handler on loopback.\n *\n * This is the only module in the package that imports `node:` builtins.\n * Servers bind to `127.0.0.1` only. Streamed response bodies are written\n * chunk by chunk (honoring backpressure) so progressive delivery survives the\n * socket, and an erroring body stream destroys the connection mid-response,\n * the way a dropped upstream does.\n *\n * @experimental\n */\nimport { Buffer } from 'node:buffer'\nimport { createServer, type IncomingMessage, type ServerResponse } from 'node:http'\nimport type { Socket } from 'node:net'\nimport { Data, Effect, Predicate, type Scope } from 'effect'\n\n/** A fetch handler, such as the one returned by an emulator factory. */\nexport type FetchHandler = (request: Request) => Promise<Response>\n\nexport type ServeFetchHandlerOptions = {\n  /** TCP port; `0` (default) picks a free port. */\n  readonly port?: number\n  /** Only `127.0.0.1` is accepted (the default); any other host is refused. */\n  readonly host?: string\n}\n\n/** The only host emulator servers bind to. */\nexport const emulatorServerHost = '127.0.0.1'\n\n/** Serving failed: a refused host, an invalid port, or a listen error. */\nexport class EmulatorServeError extends Data.TaggedError('EmulatorServeError')<{\n  readonly reason: 'host-not-allowed' | 'invalid-port' | 'listen-failed'\n  readonly cause?: unknown\n}> {\n  override get message(): string {\n    switch (this.reason) {\n      case 'host-not-allowed':\n        return `Emulator servers bind to ${emulatorServerHost} only`\n      case 'invalid-port':\n        return 'Emulator server port must be an integer from 0 to 65535'\n      case 'listen-failed':\n        return 'Emulator server could not listen'\n    }\n  }\n}\n\n/** A running loopback server (Promise variant). `close` is idempotent. */\nexport type RunningFetchHandlerServer = {\n  /** Base URL, for example `http://127.0.0.1:43123`. */\n  readonly url: string\n  readonly close: () => Promise<void>\n}\n\n/** A running loopback server (Effect variant). `close` is idempotent. */\nexport type ServedFetchHandler = {\n  readonly url: string\n  readonly close: Effect.Effect<void>\n}\n\nconst validateOptions = (options: ServeFetchHandlerOptions): EmulatorServeError | undefined => {\n  if (options.host !== undefined && options.host !== emulatorServerHost) {\n    return new EmulatorServeError({ reason: 'host-not-allowed' })\n  }\n\n  const port = options.port ?? 0\n\n  if (!Number.isInteger(port) || port < 0 || port > 65535) {\n    return new EmulatorServeError({ reason: 'invalid-port' })\n  }\n\n  return undefined\n}\n\nconst readBody = (incoming: IncomingMessage): Promise<Uint8Array<ArrayBuffer>> =>\n  new Promise((resolve, reject) => {\n    const chunks: Array<Buffer> = []\n\n    incoming.on('data', (chunk: Buffer | string) => {\n      chunks.push(Predicate.isString(chunk) ? Buffer.from(chunk) : chunk)\n    })\n    incoming.on('end', () => resolve(new Uint8Array(Buffer.concat(chunks))))\n    incoming.on('error', reject)\n  })\n\nconst toWebRequest = async (incoming: IncomingMessage, origin: string): Promise<Request> => {\n  const headers = new Headers()\n\n  for (const [name, value] of Object.entries(incoming.headers)) {\n    if (Array.isArray(value)) {\n      for (const item of value) headers.append(name, item)\n    } else if (value !== undefined) {\n      headers.set(name, value)\n    }\n  }\n\n  const method = incoming.method ?? 'GET'\n  const body = await readBody(incoming)\n  const init: RequestInit = { method, headers }\n\n  if (method !== 'GET' && method !== 'HEAD' && body.byteLength > 0) {\n    init.body = body\n  }\n\n  return new Request(new URL(incoming.url ?? '/', origin), init)\n}\n\nconst waitForDrain = (outgoing: ServerResponse): Promise<void> =>\n  new Promise(resolve => {\n    const done = () => {\n      outgoing.off('drain', done)\n      outgoing.off('close', done)\n      resolve()\n    }\n\n    outgoing.on('drain', done)\n    outgoing.on('close', done)\n  })\n\n/**\n * Write a web `Response` to a Node response: status and headers first, then\n * each body chunk as soon as the handler produces it. A body stream error\n * destroys the socket mid-response.\n */\nconst writeResponse = async (outgoing: ServerResponse, response: Response): Promise<void> => {\n  outgoing.statusCode = response.status\n\n  if (response.statusText.length > 0) {\n    outgoing.statusMessage = response.statusText\n  }\n\n  response.headers.forEach((value, name) => {\n    if (name !== 'set-cookie') outgoing.setHeader(name, value)\n  })\n\n  const cookies = response.headers.getSetCookie()\n\n  if (cookies.length > 0) {\n    outgoing.setHeader('set-cookie', cookies)\n  }\n\n  if (response.body === null) {\n    outgoing.end()\n\n    return\n  }\n\n  outgoing.flushHeaders()\n\n  const reader = response.body.getReader()\n\n  outgoing.on('close', () => {\n    if (!outgoing.writableFinished) {\n      reader.cancel().catch(() => undefined)\n    }\n  })\n\n  const pump = async (): Promise<void> => {\n    const { done, value } = await reader.read()\n\n    if (done || outgoing.destroyed) {\n      outgoing.end()\n\n      return\n    }\n\n    if (!outgoing.write(value)) {\n      await waitForDrain(outgoing)\n    }\n\n    return pump()\n  }\n\n  // Destroy without an error argument: the client sees a dropped connection, and no unhandled\n  // 'error' event is emitted on the response.\n  await pump().catch(() => {\n    outgoing.destroy()\n  })\n}\n\nconst handleRequest = (\n  handler: FetchHandler,\n  origin: string,\n  incoming: IncomingMessage,\n  outgoing: ServerResponse\n): Promise<void> =>\n  toWebRequest(incoming, origin)\n    .then(handler)\n    .then(\n      response => writeResponse(outgoing, response),\n      () => {\n        if (outgoing.headersSent) {\n          outgoing.destroy()\n\n          return\n        }\n\n        outgoing.statusCode = 500\n        outgoing.setHeader('content-type', 'text/plain')\n        outgoing.end('emulator handler failed')\n      }\n    )\n    // A response that cannot be written (for example an invalid header value) drops the connection.\n    .catch(() => {\n      outgoing.destroy()\n    })\n\n/**\n * Serve a fetch handler on `127.0.0.1` (Promise variant, for hosts without an\n * Effect runtime). Rejects with `EmulatorServeError` for a non-loopback host,\n * an invalid port, or a listen failure.\n */\nexport const startFetchHandlerServer = (\n  handler: FetchHandler,\n  options: ServeFetchHandlerOptions = {}\n): Promise<RunningFetchHandlerServer> => {\n  const invalid = validateOptions(options)\n\n  if (invalid !== undefined) {\n    return Promise.reject(invalid)\n  }\n\n  const sockets = new Set<Socket>()\n  const server = createServer()\n  let origin = ''\n\n  server.on('connection', socket => {\n    socket.setNoDelay(true)\n    sockets.add(socket)\n    socket.on('close', () => sockets.delete(socket))\n  })\n\n  server.on('request', (incoming: IncomingMessage, outgoing: ServerResponse) => {\n    void handleRequest(handler, origin, incoming, outgoing)\n  })\n\n  let closing: Promise<void> | undefined\n\n  const close = (): Promise<void> => {\n    closing ??= new Promise(resolve => {\n      server.close(() => resolve())\n\n      for (const socket of sockets) socket.destroy()\n    })\n\n    return closing\n  }\n\n  return new Promise((resolve, reject) => {\n    server.once('error', cause =>\n      reject(new EmulatorServeError({ reason: 'listen-failed', cause }))\n    )\n    server.listen(options.port ?? 0, emulatorServerHost, () => {\n      const address = server.address()\n\n      if (address === null || Predicate.isString(address)) {\n        void close()\n        reject(new EmulatorServeError({ reason: 'listen-failed' }))\n\n        return\n      }\n\n      origin = `http://${emulatorServerHost}:${address.port}`\n      resolve({ url: origin, close })\n    })\n  })\n}\n\n/**\n * Serve a fetch handler on `127.0.0.1` as a scoped resource: the server\n * closes when the scope closes (or earlier via `close`). Fails with\n * `EmulatorServeError` for a non-loopback host, an invalid port, or a listen\n * failure.\n */\nexport const serveFetchHandler = (\n  handler: FetchHandler,\n  options: ServeFetchHandlerOptions = {}\n): Effect.Effect<ServedFetchHandler, EmulatorServeError, Scope.Scope> =>\n  Effect.acquireRelease(\n    Effect.suspend(() => {\n      const invalid = validateOptions(options)\n\n      return invalid === undefined\n        ? Effect.tryPromise({\n            try: () => startFetchHandlerServer(handler, options),\n            catch: cause =>\n              cause instanceof EmulatorServeError\n                ? cause\n                : new EmulatorServeError({ reason: 'listen-failed', cause })\n          })\n        : Effect.fail(invalid)\n    }),\n    server => Effect.promise(() => server.close())\n  ).pipe(Effect.map(server => ({ url: server.url, close: Effect.promise(() => server.close()) })))\n"],"mappings":"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"}

package/dist/notion/api.d.mts

@@ -0,0 +1,51 @@
+import { StatefulRoute } from "../stateful-emulator.mjs";
+import { NotionEmulatorState } from "./state.mjs";
+
+//#region src/notion/api.d.ts
+/** API version prefix of every Notion route. */
+declare const notionEmulatorBasePath = "/v1";
+/** The only `Notion-Version` the emulator answers (every fixture sends it). */
+declare const notionEmulatorVersion = "2025-09-03";
+/** Drill knobs (tests only): each makes the emulator disagree with one conformance claim. */
+type NotionEmulatorDrills = {
+  /** A later search page starts one result early, repeating the previous page's last result. */readonly searchRepeatsResults?: boolean; /** `GET /v1/users/me` answers a person instead of the bot user. */
+  readonly botUserAsPerson?: boolean; /** Error envelopes carry a `status` other than the HTTP status. */
+  readonly envelopeStatusMismatch?: boolean; /** Page reads answer title rich text without `plain_text`. */
+  readonly omitTitlePlainText?: boolean; /** A later block children page starts one block early, repeating a block. */
+  readonly blockCursorRepeats?: boolean; /** The property id path segment is decoded twice, so a re-encoded id is not found. */
+  readonly rejectDoubleEncodedPropertyId?: boolean; /** Data source rows answer a `database_id` parent instead of their data source. */
+  readonly rowParentAsDatabase?: boolean; /** A trashed page reads back as 404 `object_not_found`. */
+  readonly trashedPageNotFound?: boolean;
+};
+declare const notionEmulatorDrillKnobs: ReadonlyArray<keyof NotionEmulatorDrills>;
+/** A cursor this emulator issued: where its list continues, and the list it was issued for. */
+type NotionIssuedCursor = {
+  readonly offset: number; /** The whole list as rendered when the cursor was issued; any change is not emulated. */
+  readonly fingerprint: string;
+};
+type NotionApiEnv = {
+  /** Clock in epoch milliseconds (created page timestamps only). */readonly now: () => number;
+  readonly drills: Readonly<Record<keyof NotionEmulatorDrills, boolean>>; /** Issued cursors by list and value (runtime-only; cleared by reset and seed). */
+  readonly cursors: Map<string, NotionIssuedCursor>; /** Property cursor numbers; never reset, so a cursor issued before a reset is never reissued. */
+  readonly propertyCursorCounter: {
+    next: number;
+  };
+  /**
+   * The cursor generation: advanced by every reset and seed (never rewound). Search and block
+   * cursors are the next result's id only in the generation that first issued that id for that
+   * list; a later generation issues a distinct value, so a cursor from before a reset or seed is
+   * never accepted again, even after the same first-page request.
+   */
+  readonly generation: {
+    current: number;
+  }; /** The generation that first issued each list's raw id cursor (never cleared). */
+  readonly firstIssued: Map<string, number>;
+};
+/** The origin every Notion fixture records; another origin is not emulated. */
+declare const notionEmulatorOrigin = "https://api.notion.com";
+type Route = StatefulRoute<NotionEmulatorState, NotionApiEnv>;
+/** The route table: evidence plus handlers. `notionEmulatorRoutes` is its evidence part. */
+declare const notionApiRoutes: ReadonlyArray<Route>;
+//#endregion
+export { NotionApiEnv, NotionEmulatorDrills, NotionIssuedCursor, notionApiRoutes, notionEmulatorBasePath, notionEmulatorDrillKnobs, notionEmulatorOrigin, notionEmulatorVersion };
+//# sourceMappingURL=api.d.mts.map

package/dist/notion/api.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.mts","names":[],"sources":["../../src/notion/api.ts"],"mappings":";;;;;cAuCa,sBAAA;AAAb;AAAA,cAGa,qBAAA;;KAWD,oBAAA;EAduB,uGAgBxB,oBAAA,YAbuB;EAAA,SAevB,eAAA,YAfuB;EAAA,SAiBvB,sBAAA,YANC;EAAA,SAQD,kBAAA;WAEA,kBAAA,YARA;EAAA,SAUA,6BAAA,YANA;EAAA,SAQA,mBAAA,YAJA;EAAA,SAMA,mBAAA;AAAA;AAAA,cAGE,wBAAA,EAA0B,aAAa,OAAO,oBAAA;;KAY/C,kBAAA;EAAA,SACD,MAAA,UAJV;EAAA,SAMU,WAAW;AAAA;AAAA,KAGV,YAAA;EANA,2EAQD,GAAA;EAAA,SACA,MAAA,EAAQ,QAAA,CAAS,MAAA,OAAa,oBAAA,aAR9B;EAAA,SAUA,OAAA,EAAS,GAAA,SAAY,kBAAA,GALpB;EAAA,SAOD,qBAAA;IAAyB,IAAA;EAAA;EAJR;;;;;;EAAA,SAWjB,UAAA;IAAc,OAAA;EAAA,GAXN;EAAA,SAaR,WAAA,EAAa,GAAA;AAAA;;cAIX,oBAAA;AAAA,KAER,KAAA,GAAQ,aAAA,CAAc,mBAAA,EAAqB,YAAA;;cAo1BnC,eAAA,EAAiB,aAAa,CAAC,KAAA"}