@0x0501/mystack 0.0.0-stage → 0.1.0-bootstrap.0

package/template/src/utils/search-params.ts

@@ -0,0 +1,71 @@
+/**
+ * Search-param serialization that keeps multi-value keys as repeated keys.
+ *
+ * TanStack Router's default `stringifySearch` JSON-encodes arrays, so a Better
+ * Auth signed OAuth query like `ba_param=a&ba_param=b` becomes
+ * `ba_param=["a","b"]`. The oauth-provider client then rebuilds `oauth_query`
+ * from `window.location.search`, drops every real signed field (it only keeps
+ * keys listed in `ba_param`), and sign-in/consent fail with `invalid_signature`.
+ *
+ * Parsing stays on the default (multi-value → array). Only stringification
+ * changes: primitive arrays expand back to repeated keys.
+ */
+
+/** Values TanStack's default parse can produce for a single search key. */
+export type SearchParamValue =
+	| string
+	| number
+	| boolean
+	| null
+	| undefined
+	| SearchParamValue[]
+	| { readonly [key: string]: SearchParamValue };
+
+export type SearchParamsRecord = Record<string, SearchParamValue>;
+
+export function stringifySearch(search: SearchParamsRecord): string {
+	const params = new URLSearchParams();
+	for (const [key, value] of Object.entries(search)) {
+		if (value === undefined) continue;
+		appendSearchValue(params, key, value);
+	}
+	const encoded = params.toString();
+	return encoded ? `?${encoded}` : "";
+}
+
+function appendSearchValue(
+	params: URLSearchParams,
+	key: string,
+	value: SearchParamValue,
+): void {
+	if (Array.isArray(value)) {
+		for (const item of value) {
+			if (item === undefined) continue;
+			// Nested objects stay JSON; primitives re-emit as repeated keys so
+			// Better Auth's multi-value `ba_param` list survives a round-trip.
+			if (item !== null && typeof item === "object") {
+				params.append(key, JSON.stringify(item));
+			} else {
+				params.append(key, String(item));
+			}
+		}
+		return;
+	}
+	if (value !== null && typeof value === "object") {
+		params.set(key, JSON.stringify(value));
+		return;
+	}
+	// Mirror default stringifySearchWith: strings that are valid JSON are
+	// re-encoded so parse/stringify stays symmetric for quoted values.
+	if (typeof value === "string") {
+		try {
+			JSON.parse(value);
+			params.set(key, JSON.stringify(value));
+			return;
+		} catch {
+			params.set(key, value);
+			return;
+		}
+	}
+	params.set(key, String(value));
+}

package/template/tsconfig.json

@@ -0,0 +1,30 @@
+{
+  "include": ["**/*.ts", "**/*.tsx"],
+  "exclude": ["packages/mystack/assets", "packages/mystack/template", "packages/mystack/node_modules"],
+  "compilerOptions": {
+    "target": "ES2022",
+    "jsx": "react-jsx",
+    "module": "ESNext",
+    "paths": {
+      "@/*": ["./src/*"],
+      "#/*": ["./src/*"]
+    },
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "types": ["vite/client"],
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "allowJs": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    /* Linting */
+    "skipLibCheck": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  }
+}

package/template/tsr.config.json

@@ -0,0 +1,6 @@
+{
+  "target": "react",
+  "routeTreeFileFooter": [
+    "import type { getRouter } from './router.tsx'\nimport type { startInstance } from './start.ts'\ndeclare module '@tanstack/react-start' {\n  interface Register {\n    ssr: true\n    router: Awaited<ReturnType<typeof getRouter>>\n    config: Awaited<ReturnType<typeof startInstance.getOptions>>\n  }\n}"
+  ]
+}

package/template/vite.config.ts

@@ -0,0 +1,24 @@
+import { cloudflare } from "@cloudflare/vite-plugin";
+import { paraglideVitePlugin } from "@inlang/paraglide-js";
+import babel from "@rolldown/plugin-babel";
+import tailwindcss from "@tailwindcss/vite";
+import { devtools } from "@tanstack/devtools-vite";
+import { tanstackStart } from "@tanstack/react-start/plugin/vite";
+import viteReact, { reactCompilerPreset } from "@vitejs/plugin-react";
+import { defineConfig } from "vite";
+import { paraglideOptions } from "./paraglide.config";
+
+const config = defineConfig({
+	resolve: { tsconfigPaths: true },
+	plugins: [
+		devtools(),
+		paraglideVitePlugin(paraglideOptions),
+		cloudflare({ viteEnvironment: { name: "ssr" } }),
+		tailwindcss(),
+		tanstackStart(),
+		viteReact(),
+		babel({ presets: [reactCompilerPreset()] }),
+	],
+});
+
+export default config;

package/template/vitest.config.ts

@@ -0,0 +1,26 @@
+import { fileURLToPath } from "node:url";
+import babel from "@rolldown/plugin-babel";
+import viteReact, { reactCompilerPreset } from "@vitejs/plugin-react";
+import { defineConfig } from "vitest/config";
+
+// Tests run in Node, not the Worker runtime. Resolve the `@/*` tsconfig alias
+// explicitly — Vite 8's native `resolve.tsconfigPaths` is intermittent here.
+export default defineConfig({
+	plugins: [viteReact(), babel({ presets: [reactCompilerPreset()] })],
+	resolve: {
+		alias: [
+			{
+				find: /^@\//,
+				replacement: fileURLToPath(new URL("./src/", import.meta.url)),
+			},
+		],
+	},
+	test: {
+		environment: "node",
+		include: ["src/__tests__/**/*.test.ts", "src/__tests__/**/*.test.tsx"],
+		globalSetup: ["./src/__tests__/global-setup.ts"],
+		// Shared Postgres container from global-setup; keep headroom for cold starts.
+		testTimeout: 30_000,
+		hookTimeout: 120_000,
+	},
+});