feat(api-keys): QR code on key creation encoding server URL + key (#1677) (#1701)

frontend/src/utils/apiKeyQr.ts

@@ -0,0 +1,26 @@
+/**
+ * Helpers for the API-key QR code.
+ *
+ * The QR encodes the Bambuddy base URL and the freshly-created API key together
+ * so a mobile client can scan one code to configure both.
+ *
+ * Payload contract (fixed — bump `v` if it changes):
+ *   bambuddy://config?v=1&url=<encodeURIComponent(baseUrl)>&key=<encodeURIComponent(apiKey)>
+ */
+
+/** Current payload schema version. */
+export const API_KEY_QR_VERSION = 1;
+
+/**
+ * Build the QR payload string encoding the base URL + API key.
+ *
+ * @param baseUrl Origin a client uses to reach Bambuddy (origin only, no path).
+ * @param apiKey  Raw API key string.
+ */
+export function buildApiKeyQrPayload(baseUrl: string, apiKey: string): string {
+  return (
+    `bambuddy://config?v=${API_KEY_QR_VERSION}` +
+    `&url=${encodeURIComponent(baseUrl)}` +
+    `&key=${encodeURIComponent(apiKey)}`
+  );
+}