@gscdump/analysis 0.6.3 → 0.7.1

package/dist/routing/index.d.mts

@@ -0,0 +1,23 @@
+type MigrationPhase = 'd1' | 'dual' | 'r2';
+type MigrationReadFrom = 'd1' | 'r2';
+interface RoutingInputs {
+  userPhase: MigrationPhase | string | null | undefined;
+  userReadFrom: MigrationReadFrom | string | null | undefined;
+  sitePhase?: MigrationPhase | string | null;
+  siteReadFrom?: MigrationReadFrom | string | null;
+}
+interface RoutingEnv {
+  ANALYTICS_FORCE_D1?: string;
+  R2_READS_ENABLED?: string;
+}
+declare function resolvePhase(inputs: Pick<RoutingInputs, 'userPhase' | 'sitePhase'>): MigrationPhase;
+declare function resolveReadFrom(inputs: Pick<RoutingInputs, 'userReadFrom' | 'siteReadFrom'>): MigrationReadFrom;
+declare function forceD1(env: Pick<RoutingEnv, 'ANALYTICS_FORCE_D1'>): boolean;
+declare function r2ReadsEnabled(env: Pick<RoutingEnv, 'R2_READS_ENABLED'>): boolean;
+declare function shouldDualWrite(inputs: RoutingInputs, env: Pick<RoutingEnv, 'ANALYTICS_FORCE_D1'>): boolean;
+type AnalyticsTable = 'pages' | 'keywords' | 'countries' | 'devices' | 'page_keywords';
+declare function isAnalyticsTable(table: string): table is AnalyticsTable;
+declare function shouldWriteToD1(inputs: RoutingInputs, env: Pick<RoutingEnv, 'ANALYTICS_FORCE_D1'>, table: string): boolean;
+declare function shouldReadFromR2(inputs: RoutingInputs, env: Pick<RoutingEnv, 'ANALYTICS_FORCE_D1' | 'R2_READS_ENABLED'>): boolean;
+declare function isValidReadFromForPhase(phase: MigrationPhase, readFrom: MigrationReadFrom): boolean;
+export { AnalyticsTable, MigrationPhase, MigrationReadFrom, RoutingEnv, RoutingInputs, forceD1, isAnalyticsTable, isValidReadFromForPhase, r2ReadsEnabled, resolvePhase, resolveReadFrom, shouldDualWrite, shouldReadFromR2, shouldWriteToD1 };

package/dist/routing/index.mjs

@@ -0,0 +1,53 @@
+function isPhase(v) {
+	return v === "d1" || v === "dual" || v === "r2";
+}
+function isReadFrom(v) {
+	return v === "d1" || v === "r2";
+}
+function resolvePhase(inputs) {
+	if (isPhase(inputs.sitePhase)) return inputs.sitePhase;
+	if (isPhase(inputs.userPhase)) return inputs.userPhase;
+	return "d1";
+}
+function resolveReadFrom(inputs) {
+	if (isReadFrom(inputs.siteReadFrom)) return inputs.siteReadFrom;
+	if (isReadFrom(inputs.userReadFrom)) return inputs.userReadFrom;
+	return "d1";
+}
+function forceD1(env) {
+	return env.ANALYTICS_FORCE_D1 === "1";
+}
+function r2ReadsEnabled(env) {
+	return env.R2_READS_ENABLED === "1";
+}
+function shouldDualWrite(inputs, env) {
+	if (forceD1(env)) return false;
+	const phase = resolvePhase(inputs);
+	return phase === "dual" || phase === "r2";
+}
+const ANALYTICS_TABLES = new Set([
+	"pages",
+	"keywords",
+	"countries",
+	"devices",
+	"page_keywords"
+]);
+function isAnalyticsTable(table) {
+	return ANALYTICS_TABLES.has(table);
+}
+function shouldWriteToD1(inputs, env, table) {
+	if (forceD1(env)) return true;
+	if (!isAnalyticsTable(table)) return true;
+	return resolvePhase(inputs) !== "r2";
+}
+function shouldReadFromR2(inputs, env) {
+	if (forceD1(env)) return false;
+	if (!r2ReadsEnabled(env)) return false;
+	if (resolvePhase(inputs) === "d1") return false;
+	return resolveReadFrom(inputs) === "r2";
+}
+function isValidReadFromForPhase(phase, readFrom) {
+	if (readFrom === "r2" && phase === "d1") return false;
+	return true;
+}
+export { forceD1, isAnalyticsTable, isValidReadFromForPhase, r2ReadsEnabled, resolvePhase, resolveReadFrom, shouldDualWrite, shouldReadFromR2, shouldWriteToD1 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/analysis",
   "type": "module",
-  "version": "0.6.3",
+  "version": "0.7.1",
   "description": "GSC analyzers — striking-distance, opportunity, movers, decay, brand, clustering, concentration, seasonality. Pure row-based + DuckDB-native.",
   "author": {
     "name": "Harlan Wilton",
@@ -48,6 +48,10 @@
     "./period": {
       "types": "./dist/period/index.d.mts",
       "import": "./dist/period/index.mjs"
+    },
+    "./routing": {
+      "types": "./dist/routing/index.d.mts",
+      "import": "./dist/routing/index.mjs"
     }
   },
   "main": "./dist/index.mjs",
@@ -68,11 +72,11 @@
   },
   "dependencies": {
     "drizzle-orm": "^0.45.2",
-    "@gscdump/engine-duckdb-node": "0.6.3",
-    "@gscdump/engine-sqlite": "0.6.3",
-    "@gscdump/engine-wasm": "0.6.3",
-    "gscdump": "0.6.3",
-    "@gscdump/engine": "0.6.3"
+    "@gscdump/engine": "0.7.1",
+    "@gscdump/engine-sqlite": "0.7.1",
+    "@gscdump/engine-wasm": "0.7.1",
+    "gscdump": "0.7.1",
+    "@gscdump/engine-duckdb-node": "0.7.1"
   },
   "devDependencies": {
     "vitest": "^4.1.5"