reflet-sdk 0.4.2 → 0.5.0

package/dist/devtools-next.d.ts

@@ -0,0 +1,19 @@
+import { t as DevtoolsServerOptions } from "./options-7KtQZJj8.js";
+//#region src/devtools/server/handler.d.ts
+type DevtoolsHandler = (request: Request) => Promise<Response>;
+//#endregion
+//#region src/devtools/server/next.d.ts
+export interface DevtoolsRoute {
+  GET: DevtoolsHandler;
+  POST: DevtoolsHandler;
+}
+/**
+ * Route handlers for `app/api/reflet-devtools/[...path]/route.ts`. They answer
+ * only under `next dev`; production builds get an empty 404.
+ */
+export declare function createDevtoolsRoute(options?: DevtoolsServerOptions): DevtoolsRoute;
+export declare const GET: DevtoolsHandler;
+export declare const POST: DevtoolsHandler;
+//#endregion
+export type { DevtoolsServerOptions };
+//# sourceMappingURL=devtools-next.d.ts.map

package/dist/devtools-next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-next.d.ts","names":[],"sources":["../src/devtools/server/handler.ts","../src/devtools/server/next.ts"],"mappings":";;KAuBY,mBAAmB,SAAS,YAAY,QAAQ;;;iBClB3C;EACf,KAAK;EACL,MAAM;;;;;;wBAOQ,oBACd,UAAS,wBACR;qBAcU,KAAG;qBACH,MAAI"}

package/dist/devtools-next.js

@@ -0,0 +1,25 @@
+import { t as createDevtoolsHandler } from "./handler-CHP0m7KF.js";
+//#region src/devtools/server/next.ts
+/**
+* Route handlers for `app/api/reflet-devtools/[...path]/route.ts`. They answer
+* only under `next dev`; production builds get an empty 404.
+*/
+function createDevtoolsRoute(options = {}) {
+	let handler = null;
+	const handle = async (request) => {
+		if (process.env.NODE_ENV !== "development") return new Response(null, { status: 404 });
+		handler ??= createDevtoolsHandler(options);
+		return await handler(request);
+	};
+	return {
+		GET: handle,
+		POST: handle
+	};
+}
+const defaultRoute = createDevtoolsRoute();
+const GET = defaultRoute.GET;
+const POST = defaultRoute.POST;
+//#endregion
+export { GET, POST, createDevtoolsRoute };
+
+//# sourceMappingURL=devtools-next.js.map

package/dist/devtools-next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-next.js","names":[],"sources":["../src/devtools/server/next.ts"],"sourcesContent":["import { createDevtoolsHandler, type DevtoolsHandler } from \"./handler\";\nimport type { DevtoolsServerOptions } from \"./options\";\n\nexport type { DevtoolsServerOptions } from \"./options\";\n\nexport interface DevtoolsRoute {\n  GET: DevtoolsHandler;\n  POST: DevtoolsHandler;\n}\n\n/**\n * Route handlers for `app/api/reflet-devtools/[...path]/route.ts`. They answer\n * only under `next dev`; production builds get an empty 404.\n */\nexport function createDevtoolsRoute(\n  options: DevtoolsServerOptions = {}\n): DevtoolsRoute {\n  let handler: DevtoolsHandler | null = null;\n  const handle: DevtoolsHandler = async (request) => {\n    if (process.env.NODE_ENV !== \"development\") {\n      return new Response(null, { status: 404 });\n    }\n    handler ??= createDevtoolsHandler(options);\n    return await handler(request);\n  };\n  return { GET: handle, POST: handle };\n}\n\nconst defaultRoute = createDevtoolsRoute();\n\nexport const GET = defaultRoute.GET;\nexport const POST = defaultRoute.POST;\n"],"mappings":";;;;;;AAcA,SAAgB,oBACd,UAAiC,CAAC,GACnB;CACf,IAAI,UAAkC;CACtC,MAAM,SAA0B,OAAO,YAAY;EACjD,IAAI,QAAQ,IAAI,aAAa,eAC3B,OAAO,IAAI,SAAS,MAAM,EAAE,QAAQ,IAAI,CAAC;EAE3C,YAAY,sBAAsB,OAAO;EACzC,OAAO,MAAM,QAAQ,OAAO;CAC9B;CACA,OAAO;EAAE,KAAK;EAAQ,MAAM;CAAO;AACrC;AAEA,MAAM,eAAe,oBAAoB;AAEzC,MAAa,MAAM,aAAa;AAChC,MAAa,OAAO,aAAa"}

package/dist/devtools-vite.d.ts

@@ -0,0 +1,8 @@
+import { t as DevtoolsServerOptions } from "./options-7KtQZJj8.js";
+import { Plugin } from "vite";
+//#region src/devtools/server/vite.d.ts
+/** Serves the Reflet devtools route from the Vite dev server; never part of a build. */
+export declare function refletDevtools(options?: DevtoolsServerOptions): Plugin;
+//#endregion
+export type { DevtoolsServerOptions };
+//# sourceMappingURL=devtools-vite.d.ts.map

package/dist/devtools-vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-vite.d.ts","names":[],"sources":["../src/devtools/server/vite.ts"],"mappings":";;;;wBA8EgB,eAAe,UAAS,wBAA6B"}

package/dist/devtools-vite.js

@@ -0,0 +1,75 @@
+import { r as DEVTOOLS_ROUTE_BASE } from "./protocol-Bn6Bg_0r.js";
+import { n as errorResponse, t as createDevtoolsHandler } from "./handler-CHP0m7KF.js";
+import { loadEnv } from "vite";
+//#region src/devtools/server/vite.ts
+const MAX_BODY_BYTES = 1048576;
+const ENV_PREFIX = "REFLET_";
+async function readBody(request) {
+	const chunks = [];
+	let size = 0;
+	for await (const chunk of request) {
+		const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk));
+		size += buffer.length;
+		if (size <= MAX_BODY_BYTES) chunks.push(buffer);
+	}
+	return size > MAX_BODY_BYTES ? null : Buffer.concat(chunks).toString("utf8");
+}
+function toWebRequest(request, method, body) {
+	const origin = `http://${request.headers.host ?? "localhost"}`;
+	const url = new URL(request.originalUrl ?? request.url ?? "/", origin);
+	const headers = new Headers();
+	for (const [name, value] of Object.entries(request.headers)) {
+		if (name.startsWith(":") || value === void 0) continue;
+		for (const item of Array.isArray(value) ? value : [value]) headers.append(name, item);
+	}
+	return new Request(url, {
+		body,
+		headers,
+		method
+	});
+}
+async function sendWebResponse(response, serverResponse) {
+	serverResponse.statusCode = response.status;
+	for (const [name, value] of response.headers) serverResponse.setHeader(name, value);
+	serverResponse.end(Buffer.from(await response.arrayBuffer()));
+}
+async function serveDevtoolsRequest(handler, request, serverResponse) {
+	const method = request.method ?? "GET";
+	const body = method !== "GET" && method !== "HEAD" ? await readBody(request) : void 0;
+	if (body === null) {
+		await sendWebResponse(errorResponse("Reflet devtools requests are limited to 1 MB.", 413), serverResponse);
+		return;
+	}
+	await sendWebResponse(await handler(toWebRequest(request, method, body)), serverResponse);
+}
+/** Serves the Reflet devtools route from the Vite dev server; never part of a build. */
+function refletDevtools(options = {}) {
+	let handler = null;
+	return {
+		apply: "serve",
+		configResolved(config) {
+			const env = loadEnv(config.mode, config.envDir, ENV_PREFIX);
+			handler = createDevtoolsHandler({
+				...options,
+				root: options.root ?? config.root
+			}, {
+				...process.env,
+				...env
+			});
+		},
+		configureServer(server) {
+			server.middlewares.use(DEVTOOLS_ROUTE_BASE, (request, response, next) => {
+				if (!handler) {
+					next();
+					return;
+				}
+				serveDevtoolsRequest(handler, request, response).catch(next);
+			});
+		},
+		name: "reflet-devtools"
+	};
+}
+//#endregion
+export { refletDevtools };
+
+//# sourceMappingURL=devtools-vite.js.map

package/dist/devtools-vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-vite.js","names":[],"sources":["../src/devtools/server/vite.ts"],"sourcesContent":["import type { ServerResponse } from \"node:http\";\nimport { type Connect, loadEnv, type Plugin } from \"vite\";\nimport { DEVTOOLS_ROUTE_BASE } from \"../protocol\";\nimport { createDevtoolsHandler, type DevtoolsHandler } from \"./handler\";\nimport { errorResponse } from \"./json-response\";\nimport type { DevtoolsServerOptions } from \"./options\";\n\nexport type { DevtoolsServerOptions } from \"./options\";\n\nconst MAX_BODY_BYTES = 1_048_576;\nconst ENV_PREFIX = \"REFLET_\";\n\nasync function readBody(\n  request: Connect.IncomingMessage\n): Promise<string | null> {\n  const chunks: Buffer[] = [];\n  let size = 0;\n  for await (const chunk of request) {\n    const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk));\n    size += buffer.length;\n    // Keep draining: leaving the loop early destroys the socket before the 413 is sent.\n    if (size <= MAX_BODY_BYTES) {\n      chunks.push(buffer);\n    }\n  }\n  return size > MAX_BODY_BYTES ? null : Buffer.concat(chunks).toString(\"utf8\");\n}\n\nfunction toWebRequest(\n  request: Connect.IncomingMessage,\n  method: string,\n  body: string | undefined\n): Request {\n  const origin = `http://${request.headers.host ?? \"localhost\"}`;\n  const url = new URL(request.originalUrl ?? request.url ?? \"/\", origin);\n  const headers = new Headers();\n  for (const [name, value] of Object.entries(request.headers)) {\n    if (name.startsWith(\":\") || value === undefined) {\n      continue;\n    }\n    for (const item of Array.isArray(value) ? value : [value]) {\n      headers.append(name, item);\n    }\n  }\n  return new Request(url, { body, headers, method });\n}\n\nasync function sendWebResponse(\n  response: Response,\n  serverResponse: ServerResponse\n): Promise<void> {\n  serverResponse.statusCode = response.status;\n  for (const [name, value] of response.headers) {\n    serverResponse.setHeader(name, value);\n  }\n  serverResponse.end(Buffer.from(await response.arrayBuffer()));\n}\n\nasync function serveDevtoolsRequest(\n  handler: DevtoolsHandler,\n  request: Connect.IncomingMessage,\n  serverResponse: ServerResponse\n): Promise<void> {\n  const method = request.method ?? \"GET\";\n  const hasBody = method !== \"GET\" && method !== \"HEAD\";\n  const body = hasBody ? await readBody(request) : undefined;\n  if (body === null) {\n    await sendWebResponse(\n      errorResponse(\"Reflet devtools requests are limited to 1 MB.\", 413),\n      serverResponse\n    );\n    return;\n  }\n  const response = await handler(toWebRequest(request, method, body));\n  await sendWebResponse(response, serverResponse);\n}\n\n/** Serves the Reflet devtools route from the Vite dev server; never part of a build. */\nexport function refletDevtools(options: DevtoolsServerOptions = {}): Plugin {\n  let handler: DevtoolsHandler | null = null;\n\n  return {\n    apply: \"serve\",\n    configResolved(config) {\n      const env = loadEnv(config.mode, config.envDir, ENV_PREFIX);\n      handler = createDevtoolsHandler(\n        { ...options, root: options.root ?? config.root },\n        { ...process.env, ...env }\n      );\n    },\n    configureServer(server) {\n      server.middlewares.use(DEVTOOLS_ROUTE_BASE, (request, response, next) => {\n        if (!handler) {\n          next();\n          return;\n        }\n        serveDevtoolsRequest(handler, request, response).catch(next);\n      });\n    },\n    name: \"reflet-devtools\",\n  };\n}\n"],"mappings":";;;;AASA,MAAM,iBAAiB;AACvB,MAAM,aAAa;AAEnB,eAAe,SACb,SACwB;CACxB,MAAM,SAAmB,CAAC;CAC1B,IAAI,OAAO;CACX,WAAW,MAAM,SAAS,SAAS;EACjC,MAAM,SAAS,OAAO,SAAS,KAAK,IAAI,QAAQ,OAAO,KAAK,OAAO,KAAK,CAAC;EACzE,QAAQ,OAAO;EAEf,IAAI,QAAQ,gBACV,OAAO,KAAK,MAAM;CAEtB;CACA,OAAO,OAAO,iBAAiB,OAAO,OAAO,OAAO,MAAM,CAAC,CAAC,SAAS,MAAM;AAC7E;AAEA,SAAS,aACP,SACA,QACA,MACS;CACT,MAAM,SAAS,UAAU,QAAQ,QAAQ,QAAQ;CACjD,MAAM,MAAM,IAAI,IAAI,QAAQ,eAAe,QAAQ,OAAO,KAAK,MAAM;CACrE,MAAM,UAAU,IAAI,QAAQ;CAC5B,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,QAAQ,OAAO,GAAG;EAC3D,IAAI,KAAK,WAAW,GAAG,KAAK,UAAU,KAAA,GACpC;EAEF,KAAK,MAAM,QAAQ,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK,GACtD,QAAQ,OAAO,MAAM,IAAI;CAE7B;CACA,OAAO,IAAI,QAAQ,KAAK;EAAE;EAAM;EAAS;CAAO,CAAC;AACnD;AAEA,eAAe,gBACb,UACA,gBACe;CACf,eAAe,aAAa,SAAS;CACrC,KAAK,MAAM,CAAC,MAAM,UAAU,SAAS,SACnC,eAAe,UAAU,MAAM,KAAK;CAEtC,eAAe,IAAI,OAAO,KAAK,MAAM,SAAS,YAAY,CAAC,CAAC;AAC9D;AAEA,eAAe,qBACb,SACA,SACA,gBACe;CACf,MAAM,SAAS,QAAQ,UAAU;CAEjC,MAAM,OADU,WAAW,SAAS,WAAW,SACxB,MAAM,SAAS,OAAO,IAAI,KAAA;CACjD,IAAI,SAAS,MAAM;EACjB,MAAM,gBACJ,cAAc,iDAAiD,GAAG,GAClE,cACF;EACA;CACF;CAEA,MAAM,gBAAgB,MADC,QAAQ,aAAa,SAAS,QAAQ,IAAI,CAAC,GAClC,cAAc;AAChD;;AAGA,SAAgB,eAAe,UAAiC,CAAC,GAAW;CAC1E,IAAI,UAAkC;CAEtC,OAAO;EACL,OAAO;EACP,eAAe,QAAQ;GACrB,MAAM,MAAM,QAAQ,OAAO,MAAM,OAAO,QAAQ,UAAU;GAC1D,UAAU,sBACR;IAAE,GAAG;IAAS,MAAM,QAAQ,QAAQ,OAAO;GAAK,GAChD;IAAE,GAAG,QAAQ;IAAK,GAAG;GAAI,CAC3B;EACF;EACA,gBAAgB,QAAQ;GACtB,OAAO,YAAY,IAAI,sBAAsB,SAAS,UAAU,SAAS;IACvE,IAAI,CAAC,SAAS;KACZ,KAAK;KACL;IACF;IACA,qBAAqB,SAAS,SAAS,QAAQ,CAAC,CAAC,MAAM,IAAI;GAC7D,CAAC;EACH;EACA,MAAM;CACR;AACF"}

package/dist/feedback.d.ts

@@ -74,6 +74,11 @@ interface RefletFeedbackProps {
   captureConsole?: boolean;
   /** Take a screenshot of the viewport as soon as the panel opens. */
   captureOnOpen?: boolean;
+  /**
+   * Dev-only tools for your team: inspect an element's code, keep notes, read
+   * the board for the current page. Never loaded outside `NODE_ENV=development`.
+   */
+  devtools?: boolean;
   /** Let reporters hide the launcher for this many days. */
   dismissForDays?: number;
   /** Render nothing when false — lets an app gate the widget per user. */

package/dist/feedback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feedback.d.ts","names":[],"sources":["../src/feedback/types.ts","../src/feedback/core/capture.ts","../src/feedback/core/element-selector.ts","../src/feedback/core/page-context.ts","../src/feedback/widget.tsx"],"mappings":";;cAKM;KAUM,yBAAyB;UAEpB;EACf;EACA;;UAGe;EACf;EACA,KAAK;EACL;;EAEA,SAAS;EACT,OAAO;EACP;EACA,MAAM;;UAGS;EACf,MAAM;EACN;EACA;;EAEA;EACA;;UAce;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAgDe;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;EACA,SAAS,QAAQ;;EAEjB,WAAW;;EAEX;EACA;EACA,aAAa;IAAU;;EACvB;EACA,YAAY;IAAU;;EACtB;EACA;EACA;EACA;EACA,OAAO;EACP;;;;UCwDe;;EAEf,UAAU;EACV;EACA;;EAEA;;;;;;;;;;wBA2GoB,gBACpB,UAAS,iBACR,QAAQ;wBAiDK,eAAe,OAAO;;;;wBCvGtB,sBAAsB,SAAS,UAAU;;;;wBCjMzC,mBAAmB;EACjC;IACE;;;wBCnFY,eAAe,OAAO,sCAAmB,IAAA"}
+{"version":3,"file":"feedback.d.ts","names":[],"sources":["../src/feedback/types.ts","../src/feedback/core/capture.ts","../src/feedback/core/element-selector.ts","../src/feedback/core/page-context.ts","../src/feedback/widget.tsx"],"mappings":";;cAKM;KAUM,yBAAyB;UAEpB;EACf;EACA;;UAGe;EACf;EACA,KAAK;EACL;;EAEA,SAAS;EACT,OAAO;EACP;EACA,MAAM;;UAGS;EACf,MAAM;EACN;EACA;;EAEA;EACA;;UAce;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAgDe;;EAEf;;EAEA;;EAEA;;;;;EAKA;;EAEA;;EAEA;;EAEA;EACA,SAAS,QAAQ;;EAEjB,WAAW;;EAEX;EACA;EACA,aAAa;IAAU;;EACvB;EACA,YAAY;IAAU;;EACtB;EACA;EACA;EACA;EACA,OAAO;EACP;;;;UC6De;;EAEf,UAAU;EACV;EACA;;EAEA;;;;;;;;;;wBA2GoB,gBACpB,UAAS,iBACR,QAAQ;wBAiDK,eAAe,OAAO;;;;wBCjHtB,sBAAsB,SAAS,UAAU;;;;wBCjMzC,mBAAmB;EACjC;IACE;;;wBCvEY,eAAe,OAAO,sCAAmB,IAAA"}