@8ms/helpers 3.0.27 → 3.1.0

package/dist/googleAds/keywordPlanner/bigquery.cjs

@@ -0,0 +1,92 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_googleCloud_bigquery__field_bqDate = require("../../googleCloud/bigquery/_field/bqDate.cjs");
+const require_googleCloud_bigquery__field_bqDateTime = require("../../googleCloud/bigquery/_field/bqDateTime.cjs");
+const require_googleCloud_bigquery__field_bqInt = require("../../googleCloud/bigquery/_field/bqInt.cjs");
+const require_googleCloud_bigquery_partitionType = require("../../googleCloud/bigquery/partitionType.cjs");
+const require_googleCloud_bigquery_zodToBQDefinition = require("../../googleCloud/bigquery/zodToBQDefinition.cjs");
+require("../../googleCloud/bigquery/index.cjs");
+const require_googleAds_keywordPlanner_network = require("./network.cjs");
+let zod = require("zod");
+//#region src/googleAds/keywordPlanner/bigquery.ts
+/**
+* Application format (server-side/client-side).
+*/
+const keywordPlannerBQRowSchema = zod.z.object({
+	id: zod.z.string(),
+	query: zod.z.string(),
+	last_month: require_googleCloud_bigquery__field_bqDate.zLuxonDate,
+	api_customer_id: zod.z.string().nullable(),
+	api_network: require_googleAds_keywordPlanner_network.requestNetworkNameSchema.nullable(),
+	api_countries: zod.z.string().nullable(),
+	api_language: require_googleCloud_bigquery__field_bqInt.zBQInt.nullable(),
+	avg_cpc: zod.z.number().nullable(),
+	avg_search_volume: require_googleCloud_bigquery__field_bqInt.zBQInt,
+	competition: zod.z.string(),
+	competition_index: require_googleCloud_bigquery__field_bqInt.zBQInt.nullable(),
+	months: zod.z.object({
+		date: require_googleCloud_bigquery__field_bqDate.zLuxonDate,
+		search_volume: require_googleCloud_bigquery__field_bqInt.zBQInt
+	}).array(),
+	top_of_page_bid_high: zod.z.number().nullable(),
+	top_of_page_bid_low: zod.z.number().nullable(),
+	total_search_volume: require_googleCloud_bigquery__field_bqInt.zBQInt.nullable(),
+	missing: zod.z.boolean(),
+	inserted_at: require_googleCloud_bigquery__field_bqDateTime.zLuxonDateTime
+});
+const keywordPlannerField = keywordPlannerBQRowSchema.keyof().enum;
+/**
+* The BigQuery table definition - schema/partitioning/clustering derived directly from
+* keywordPlannerBQRowSchema, so the column list only exists once. Flat structure as we need to
+* add to this and will be chunked.
+* https://cloud.google.com/bigquery/docs/samples/bigquery-create-table-range-partitioned
+*/
+const keywordPlannerDefinition = {
+	projectId: "ems-shared",
+	datasetId: "codex",
+	tableId: "google_ads_keyword_planner",
+	options: {
+		schema: require_googleCloud_bigquery_zodToBQDefinition.zodToBQSchema(keywordPlannerBQRowSchema),
+		timePartitioning: {
+			type: require_googleCloud_bigquery_partitionType.partitionType.MONTH,
+			field: keywordPlannerField.last_month
+		},
+		clustering: { fields: [keywordPlannerField.query] }
+	}
+};
+/**
+* Fixed table for google ads keyword planner.
+*/
+const keywordPlannerTableId = `${keywordPlannerDefinition.projectId}.${keywordPlannerDefinition.datasetId}.${keywordPlannerDefinition.tableId}`;
+/**
+* KeywordPlannerRow (Luxon DateTime fields) -> the plain-value shape BigQuery's insert/load API
+* expects for DATE/DATETIME columns. safeParse() both validates the input row and produces the
+* BQ-ready row in one step - no separate hand-written conversion function needed.
+*/
+const keywordPlannerBQInsertRowSchema = keywordPlannerBQRowSchema.extend({
+	last_month: require_googleCloud_bigquery__field_bqDate.zLuxonDate.transform(require_googleCloud_bigquery__field_bqDate.encodeBQDate),
+	months: zod.z.object({
+		date: require_googleCloud_bigquery__field_bqDate.zLuxonDate.transform(require_googleCloud_bigquery__field_bqDate.encodeBQDate),
+		search_volume: zod.z.number()
+	}).array(),
+	inserted_at: require_googleCloud_bigquery__field_bqDateTime.zLuxonDateTime.transform(require_googleCloud_bigquery__field_bqDateTime.encodeBQDateTime)
+});
+/**
+* The raw shape a BigQuery query result actually returns -> KeywordPlannerRow (Luxon DateTime
+* fields). DATE/DATETIME columns come back wrapped as {value: string} (BQDate/BQDatetime), unlike
+* the plain strings keywordPlannerBQInsertRowSchema writes. safeParse() both validates the raw row
+* and decodes it back into the application shape in one step.
+*/
+const keywordPlannerBQReadRowSchema = keywordPlannerBQRowSchema.extend({
+	last_month: require_googleCloud_bigquery__field_bqDate.BQDate.transform(require_googleCloud_bigquery__field_bqDate.decodeBQDate),
+	months: zod.z.object({
+		date: require_googleCloud_bigquery__field_bqDate.BQDate.transform(require_googleCloud_bigquery__field_bqDate.decodeBQDate),
+		search_volume: zod.z.number()
+	}).array(),
+	inserted_at: require_googleCloud_bigquery__field_bqDateTime.BQDateTime.transform(require_googleCloud_bigquery__field_bqDateTime.decodeBQDateTime)
+});
+//#endregion
+exports.keywordPlannerBQInsertRowSchema = keywordPlannerBQInsertRowSchema;
+exports.keywordPlannerBQReadRowSchema = keywordPlannerBQReadRowSchema;
+exports.keywordPlannerBQRowSchema = keywordPlannerBQRowSchema;
+exports.keywordPlannerDefinition = keywordPlannerDefinition;
+exports.keywordPlannerTableId = keywordPlannerTableId;

package/dist/googleAds/keywordPlanner/bigquery.d.cts

@@ -0,0 +1,120 @@
+import { TableDefinition } from "../../googleCloud/bigquery/tableDefinition.cjs";
+import "../../googleCloud/bigquery/index.cjs";
+import { z } from "zod";
+//#region src/googleAds/keywordPlanner/bigquery.d.ts
+/**
+ * Application format (server-side/client-side).
+ */
+export declare const keywordPlannerBQRowSchema: z.ZodObject<{
+  id: z.ZodString;
+  query: z.ZodString;
+  last_month: z.ZodType<import("luxon").DateTime<boolean>, unknown, z.core.$ZodTypeInternals<import("luxon").DateTime<boolean>, unknown>>;
+  api_customer_id: z.ZodNullable<z.ZodString>;
+  api_network: z.ZodNullable<z.ZodEnum<{
+    GOOGLE_SEARCH_AND_PARTNERS: "GOOGLE_SEARCH_AND_PARTNERS";
+    GOOGLE_SEARCH_ONLY: "GOOGLE_SEARCH_ONLY";
+  }>>;
+  api_countries: z.ZodNullable<z.ZodString>;
+  api_language: z.ZodNullable<z.ZodNumber>;
+  avg_cpc: z.ZodNullable<z.ZodNumber>;
+  avg_search_volume: z.ZodNumber;
+  competition: z.ZodString;
+  competition_index: z.ZodNullable<z.ZodNumber>;
+  months: z.ZodArray<z.ZodObject<{
+    date: z.ZodType<import("luxon").DateTime<boolean>, unknown, z.core.$ZodTypeInternals<import("luxon").DateTime<boolean>, unknown>>;
+    search_volume: z.ZodNumber;
+  }, z.core.$strip>>;
+  top_of_page_bid_high: z.ZodNullable<z.ZodNumber>;
+  top_of_page_bid_low: z.ZodNullable<z.ZodNumber>;
+  total_search_volume: z.ZodNullable<z.ZodNumber>;
+  missing: z.ZodBoolean;
+  inserted_at: z.ZodType<import("luxon").DateTime<boolean>, unknown, z.core.$ZodTypeInternals<import("luxon").DateTime<boolean>, unknown>>;
+}, z.core.$strip>;
+export type KeywordPlannerBQRow = z.infer<typeof keywordPlannerBQRowSchema>;
+/**
+ * The BigQuery table definition - schema/partitioning/clustering derived directly from
+ * keywordPlannerBQRowSchema, so the column list only exists once. Flat structure as we need to
+ * add to this and will be chunked.
+ * https://cloud.google.com/bigquery/docs/samples/bigquery-create-table-range-partitioned
+ */
+export declare const keywordPlannerDefinition: TableDefinition;
+/**
+ * Fixed table for google ads keyword planner.
+ */
+export declare const keywordPlannerTableId: string;
+/**
+ * KeywordPlannerRow (Luxon DateTime fields) -> the plain-value shape BigQuery's insert/load API
+ * expects for DATE/DATETIME columns. safeParse() both validates the input row and produces the
+ * BQ-ready row in one step - no separate hand-written conversion function needed.
+ */
+export declare const keywordPlannerBQInsertRowSchema: z.ZodObject<{
+  id: z.ZodString;
+  query: z.ZodString;
+  api_customer_id: z.ZodNullable<z.ZodString>;
+  api_network: z.ZodNullable<z.ZodEnum<{
+    GOOGLE_SEARCH_AND_PARTNERS: "GOOGLE_SEARCH_AND_PARTNERS";
+    GOOGLE_SEARCH_ONLY: "GOOGLE_SEARCH_ONLY";
+  }>>;
+  api_countries: z.ZodNullable<z.ZodString>;
+  api_language: z.ZodNullable<z.ZodNumber>;
+  avg_cpc: z.ZodNullable<z.ZodNumber>;
+  avg_search_volume: z.ZodNumber;
+  competition: z.ZodString;
+  competition_index: z.ZodNullable<z.ZodNumber>;
+  top_of_page_bid_high: z.ZodNullable<z.ZodNumber>;
+  top_of_page_bid_low: z.ZodNullable<z.ZodNumber>;
+  total_search_volume: z.ZodNullable<z.ZodNumber>;
+  missing: z.ZodBoolean;
+  last_month: z.ZodPipe<z.ZodType<import("luxon").DateTime<boolean>, unknown, z.core.$ZodTypeInternals<import("luxon").DateTime<boolean>, unknown>>, z.ZodTransform<string, import("luxon").DateTime<boolean>>>;
+  months: z.ZodArray<z.ZodObject<{
+    date: z.ZodPipe<z.ZodType<import("luxon").DateTime<boolean>, unknown, z.core.$ZodTypeInternals<import("luxon").DateTime<boolean>, unknown>>, z.ZodTransform<string, import("luxon").DateTime<boolean>>>;
+    search_volume: z.ZodNumber;
+  }, z.core.$strip>>;
+  inserted_at: z.ZodPipe<z.ZodType<import("luxon").DateTime<boolean>, unknown, z.core.$ZodTypeInternals<import("luxon").DateTime<boolean>, unknown>>, z.ZodTransform<string, import("luxon").DateTime<boolean>>>;
+}, z.core.$strip>;
+export type KeywordPlannerBQInsertRow = z.infer<typeof keywordPlannerBQInsertRowSchema>;
+/**
+ * The raw shape a BigQuery query result actually returns -> KeywordPlannerRow (Luxon DateTime
+ * fields). DATE/DATETIME columns come back wrapped as {value: string} (BQDate/BQDatetime), unlike
+ * the plain strings keywordPlannerBQInsertRowSchema writes. safeParse() both validates the raw row
+ * and decodes it back into the application shape in one step.
+ */
+export declare const keywordPlannerBQReadRowSchema: z.ZodObject<{
+  id: z.ZodString;
+  query: z.ZodString;
+  api_customer_id: z.ZodNullable<z.ZodString>;
+  api_network: z.ZodNullable<z.ZodEnum<{
+    GOOGLE_SEARCH_AND_PARTNERS: "GOOGLE_SEARCH_AND_PARTNERS";
+    GOOGLE_SEARCH_ONLY: "GOOGLE_SEARCH_ONLY";
+  }>>;
+  api_countries: z.ZodNullable<z.ZodString>;
+  api_language: z.ZodNullable<z.ZodNumber>;
+  avg_cpc: z.ZodNullable<z.ZodNumber>;
+  avg_search_volume: z.ZodNumber;
+  competition: z.ZodString;
+  competition_index: z.ZodNullable<z.ZodNumber>;
+  top_of_page_bid_high: z.ZodNullable<z.ZodNumber>;
+  top_of_page_bid_low: z.ZodNullable<z.ZodNumber>;
+  total_search_volume: z.ZodNullable<z.ZodNumber>;
+  missing: z.ZodBoolean;
+  last_month: z.ZodPipe<z.ZodObject<{
+    value: z.ZodISODate;
+  }, z.core.$strip>, z.ZodTransform<import("luxon").DateTime<boolean>, {
+    value: string;
+  }>>;
+  months: z.ZodArray<z.ZodObject<{
+    date: z.ZodPipe<z.ZodObject<{
+      value: z.ZodISODate;
+    }, z.core.$strip>, z.ZodTransform<import("luxon").DateTime<boolean>, {
+      value: string;
+    }>>;
+    search_volume: z.ZodNumber;
+  }, z.core.$strip>>;
+  inserted_at: z.ZodPipe<z.ZodObject<{
+    value: z.ZodISODateTime;
+  }, z.core.$strip>, z.ZodTransform<import("luxon").DateTime<boolean>, {
+    value: string;
+  }>>;
+}, z.core.$strip>;
+export type KeywordPlannerBQReadRow = z.input<typeof keywordPlannerBQReadRowSchema>;
+//#endregion

package/dist/googleAds/keywordPlanner/bigquery.d.mts

@@ -0,0 +1,120 @@
+import { TableDefinition } from "../../googleCloud/bigquery/tableDefinition.mjs";
+import "../../googleCloud/bigquery/index.mjs";
+import { z } from "zod";
+//#region src/googleAds/keywordPlanner/bigquery.d.ts
+/**
+ * Application format (server-side/client-side).
+ */
+export declare const keywordPlannerBQRowSchema: z.ZodObject<{
+  id: z.ZodString;
+  query: z.ZodString;
+  last_month: z.ZodType<import("luxon").DateTime<boolean>, unknown, z.core.$ZodTypeInternals<import("luxon").DateTime<boolean>, unknown>>;
+  api_customer_id: z.ZodNullable<z.ZodString>;
+  api_network: z.ZodNullable<z.ZodEnum<{
+    GOOGLE_SEARCH_AND_PARTNERS: "GOOGLE_SEARCH_AND_PARTNERS";
+    GOOGLE_SEARCH_ONLY: "GOOGLE_SEARCH_ONLY";
+  }>>;
+  api_countries: z.ZodNullable<z.ZodString>;
+  api_language: z.ZodNullable<z.ZodNumber>;
+  avg_cpc: z.ZodNullable<z.ZodNumber>;
+  avg_search_volume: z.ZodNumber;
+  competition: z.ZodString;
+  competition_index: z.ZodNullable<z.ZodNumber>;
+  months: z.ZodArray<z.ZodObject<{
+    date: z.ZodType<import("luxon").DateTime<boolean>, unknown, z.core.$ZodTypeInternals<import("luxon").DateTime<boolean>, unknown>>;
+    search_volume: z.ZodNumber;
+  }, z.core.$strip>>;
+  top_of_page_bid_high: z.ZodNullable<z.ZodNumber>;
+  top_of_page_bid_low: z.ZodNullable<z.ZodNumber>;
+  total_search_volume: z.ZodNullable<z.ZodNumber>;
+  missing: z.ZodBoolean;
+  inserted_at: z.ZodType<import("luxon").DateTime<boolean>, unknown, z.core.$ZodTypeInternals<import("luxon").DateTime<boolean>, unknown>>;
+}, z.core.$strip>;
+export type KeywordPlannerBQRow = z.infer<typeof keywordPlannerBQRowSchema>;
+/**
+ * The BigQuery table definition - schema/partitioning/clustering derived directly from
+ * keywordPlannerBQRowSchema, so the column list only exists once. Flat structure as we need to
+ * add to this and will be chunked.
+ * https://cloud.google.com/bigquery/docs/samples/bigquery-create-table-range-partitioned
+ */
+export declare const keywordPlannerDefinition: TableDefinition;
+/**
+ * Fixed table for google ads keyword planner.
+ */
+export declare const keywordPlannerTableId: string;
+/**
+ * KeywordPlannerRow (Luxon DateTime fields) -> the plain-value shape BigQuery's insert/load API
+ * expects for DATE/DATETIME columns. safeParse() both validates the input row and produces the
+ * BQ-ready row in one step - no separate hand-written conversion function needed.
+ */
+export declare const keywordPlannerBQInsertRowSchema: z.ZodObject<{
+  id: z.ZodString;
+  query: z.ZodString;
+  api_customer_id: z.ZodNullable<z.ZodString>;
+  api_network: z.ZodNullable<z.ZodEnum<{
+    GOOGLE_SEARCH_AND_PARTNERS: "GOOGLE_SEARCH_AND_PARTNERS";
+    GOOGLE_SEARCH_ONLY: "GOOGLE_SEARCH_ONLY";
+  }>>;
+  api_countries: z.ZodNullable<z.ZodString>;
+  api_language: z.ZodNullable<z.ZodNumber>;
+  avg_cpc: z.ZodNullable<z.ZodNumber>;
+  avg_search_volume: z.ZodNumber;
+  competition: z.ZodString;
+  competition_index: z.ZodNullable<z.ZodNumber>;
+  top_of_page_bid_high: z.ZodNullable<z.ZodNumber>;
+  top_of_page_bid_low: z.ZodNullable<z.ZodNumber>;
+  total_search_volume: z.ZodNullable<z.ZodNumber>;
+  missing: z.ZodBoolean;
+  last_month: z.ZodPipe<z.ZodType<import("luxon").DateTime<boolean>, unknown, z.core.$ZodTypeInternals<import("luxon").DateTime<boolean>, unknown>>, z.ZodTransform<string, import("luxon").DateTime<boolean>>>;
+  months: z.ZodArray<z.ZodObject<{
+    date: z.ZodPipe<z.ZodType<import("luxon").DateTime<boolean>, unknown, z.core.$ZodTypeInternals<import("luxon").DateTime<boolean>, unknown>>, z.ZodTransform<string, import("luxon").DateTime<boolean>>>;
+    search_volume: z.ZodNumber;
+  }, z.core.$strip>>;
+  inserted_at: z.ZodPipe<z.ZodType<import("luxon").DateTime<boolean>, unknown, z.core.$ZodTypeInternals<import("luxon").DateTime<boolean>, unknown>>, z.ZodTransform<string, import("luxon").DateTime<boolean>>>;
+}, z.core.$strip>;
+export type KeywordPlannerBQInsertRow = z.infer<typeof keywordPlannerBQInsertRowSchema>;
+/**
+ * The raw shape a BigQuery query result actually returns -> KeywordPlannerRow (Luxon DateTime
+ * fields). DATE/DATETIME columns come back wrapped as {value: string} (BQDate/BQDatetime), unlike
+ * the plain strings keywordPlannerBQInsertRowSchema writes. safeParse() both validates the raw row
+ * and decodes it back into the application shape in one step.
+ */
+export declare const keywordPlannerBQReadRowSchema: z.ZodObject<{
+  id: z.ZodString;
+  query: z.ZodString;
+  api_customer_id: z.ZodNullable<z.ZodString>;
+  api_network: z.ZodNullable<z.ZodEnum<{
+    GOOGLE_SEARCH_AND_PARTNERS: "GOOGLE_SEARCH_AND_PARTNERS";
+    GOOGLE_SEARCH_ONLY: "GOOGLE_SEARCH_ONLY";
+  }>>;
+  api_countries: z.ZodNullable<z.ZodString>;
+  api_language: z.ZodNullable<z.ZodNumber>;
+  avg_cpc: z.ZodNullable<z.ZodNumber>;
+  avg_search_volume: z.ZodNumber;
+  competition: z.ZodString;
+  competition_index: z.ZodNullable<z.ZodNumber>;
+  top_of_page_bid_high: z.ZodNullable<z.ZodNumber>;
+  top_of_page_bid_low: z.ZodNullable<z.ZodNumber>;
+  total_search_volume: z.ZodNullable<z.ZodNumber>;
+  missing: z.ZodBoolean;
+  last_month: z.ZodPipe<z.ZodObject<{
+    value: z.ZodISODate;
+  }, z.core.$strip>, z.ZodTransform<import("luxon").DateTime<boolean>, {
+    value: string;
+  }>>;
+  months: z.ZodArray<z.ZodObject<{
+    date: z.ZodPipe<z.ZodObject<{
+      value: z.ZodISODate;
+    }, z.core.$strip>, z.ZodTransform<import("luxon").DateTime<boolean>, {
+      value: string;
+    }>>;
+    search_volume: z.ZodNumber;
+  }, z.core.$strip>>;
+  inserted_at: z.ZodPipe<z.ZodObject<{
+    value: z.ZodISODateTime;
+  }, z.core.$strip>, z.ZodTransform<import("luxon").DateTime<boolean>, {
+    value: string;
+  }>>;
+}, z.core.$strip>;
+export type KeywordPlannerBQReadRow = z.input<typeof keywordPlannerBQReadRowSchema>;
+//#endregion

package/dist/googleAds/keywordPlanner/bigquery.mjs

@@ -0,0 +1,87 @@
+import { BQDate, decodeBQDate, encodeBQDate, zLuxonDate } from "../../googleCloud/bigquery/_field/bqDate.mjs";
+import { BQDateTime, decodeBQDateTime, encodeBQDateTime, zLuxonDateTime } from "../../googleCloud/bigquery/_field/bqDateTime.mjs";
+import { zBQInt } from "../../googleCloud/bigquery/_field/bqInt.mjs";
+import { partitionType } from "../../googleCloud/bigquery/partitionType.mjs";
+import { zodToBQSchema } from "../../googleCloud/bigquery/zodToBQDefinition.mjs";
+import "../../googleCloud/bigquery/index.mjs";
+import { requestNetworkNameSchema } from "./network.mjs";
+import { z } from "zod";
+//#region src/googleAds/keywordPlanner/bigquery.ts
+/**
+* Application format (server-side/client-side).
+*/
+const keywordPlannerBQRowSchema = z.object({
+	id: z.string(),
+	query: z.string(),
+	last_month: zLuxonDate,
+	api_customer_id: z.string().nullable(),
+	api_network: requestNetworkNameSchema.nullable(),
+	api_countries: z.string().nullable(),
+	api_language: zBQInt.nullable(),
+	avg_cpc: z.number().nullable(),
+	avg_search_volume: zBQInt,
+	competition: z.string(),
+	competition_index: zBQInt.nullable(),
+	months: z.object({
+		date: zLuxonDate,
+		search_volume: zBQInt
+	}).array(),
+	top_of_page_bid_high: z.number().nullable(),
+	top_of_page_bid_low: z.number().nullable(),
+	total_search_volume: zBQInt.nullable(),
+	missing: z.boolean(),
+	inserted_at: zLuxonDateTime
+});
+const keywordPlannerField = keywordPlannerBQRowSchema.keyof().enum;
+/**
+* The BigQuery table definition - schema/partitioning/clustering derived directly from
+* keywordPlannerBQRowSchema, so the column list only exists once. Flat structure as we need to
+* add to this and will be chunked.
+* https://cloud.google.com/bigquery/docs/samples/bigquery-create-table-range-partitioned
+*/
+const keywordPlannerDefinition = {
+	projectId: "ems-shared",
+	datasetId: "codex",
+	tableId: "google_ads_keyword_planner",
+	options: {
+		schema: zodToBQSchema(keywordPlannerBQRowSchema),
+		timePartitioning: {
+			type: partitionType.MONTH,
+			field: keywordPlannerField.last_month
+		},
+		clustering: { fields: [keywordPlannerField.query] }
+	}
+};
+/**
+* Fixed table for google ads keyword planner.
+*/
+const keywordPlannerTableId = `${keywordPlannerDefinition.projectId}.${keywordPlannerDefinition.datasetId}.${keywordPlannerDefinition.tableId}`;
+/**
+* KeywordPlannerRow (Luxon DateTime fields) -> the plain-value shape BigQuery's insert/load API
+* expects for DATE/DATETIME columns. safeParse() both validates the input row and produces the
+* BQ-ready row in one step - no separate hand-written conversion function needed.
+*/
+const keywordPlannerBQInsertRowSchema = keywordPlannerBQRowSchema.extend({
+	last_month: zLuxonDate.transform(encodeBQDate),
+	months: z.object({
+		date: zLuxonDate.transform(encodeBQDate),
+		search_volume: z.number()
+	}).array(),
+	inserted_at: zLuxonDateTime.transform(encodeBQDateTime)
+});
+/**
+* The raw shape a BigQuery query result actually returns -> KeywordPlannerRow (Luxon DateTime
+* fields). DATE/DATETIME columns come back wrapped as {value: string} (BQDate/BQDatetime), unlike
+* the plain strings keywordPlannerBQInsertRowSchema writes. safeParse() both validates the raw row
+* and decodes it back into the application shape in one step.
+*/
+const keywordPlannerBQReadRowSchema = keywordPlannerBQRowSchema.extend({
+	last_month: BQDate.transform(decodeBQDate),
+	months: z.object({
+		date: BQDate.transform(decodeBQDate),
+		search_volume: z.number()
+	}).array(),
+	inserted_at: BQDateTime.transform(decodeBQDateTime)
+});
+//#endregion
+export { keywordPlannerBQInsertRowSchema, keywordPlannerBQReadRowSchema, keywordPlannerBQRowSchema, keywordPlannerDefinition, keywordPlannerTableId };

package/dist/googleAds/keywordPlanner/countries.cjs

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/googleAds/keywordPlanner/countries.ts
+/**
+* Normalises Google Ads country IDs for api_countries.
+*
+* Stored as a "|"-joined list, or null when no countries apply to the request.
+*/
+const getRequestCountries = (countries) => {
+	return countries && countries.length > 0 ? [...countries].sort((a, b) => a - b).join("|") : null;
+};
+//#endregion
+exports.getRequestCountries = getRequestCountries;

package/dist/googleAds/keywordPlanner/countries.d.cts

@@ -0,0 +1,8 @@
+//#region src/googleAds/keywordPlanner/countries.d.ts
+/**
+ * Normalises Google Ads country IDs for api_countries.
+ *
+ * Stored as a "|"-joined list, or null when no countries apply to the request.
+ */
+export declare const getRequestCountries: (countries?: number[] | null) => string | null;
+//#endregion

package/dist/googleAds/keywordPlanner/countries.d.mts

@@ -0,0 +1,8 @@
+//#region src/googleAds/keywordPlanner/countries.d.ts
+/**
+ * Normalises Google Ads country IDs for api_countries.
+ *
+ * Stored as a "|"-joined list, or null when no countries apply to the request.
+ */
+export declare const getRequestCountries: (countries?: number[] | null) => string | null;
+//#endregion

package/dist/googleAds/keywordPlanner/countries.mjs

@@ -0,0 +1,11 @@
+//#region src/googleAds/keywordPlanner/countries.ts
+/**
+* Normalises Google Ads country IDs for api_countries.
+*
+* Stored as a "|"-joined list, or null when no countries apply to the request.
+*/
+const getRequestCountries = (countries) => {
+	return countries && countries.length > 0 ? [...countries].sort((a, b) => a - b).join("|") : null;
+};
+//#endregion
+export { getRequestCountries };

package/dist/googleAds/keywordPlanner/customerId.cjs

@@ -0,0 +1,11 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/googleAds/keywordPlanner/customerId.ts
+/**
+* Normalises a Google Ads customer ID for api_customer_id - stored without hyphens, or null
+* when no customer ID applies to the request.
+*/
+const getRequestCustomerId = (customerId) => {
+	return customerId ? customerId.replaceAll("-", "") : null;
+};
+//#endregion
+exports.getRequestCustomerId = getRequestCustomerId;

package/dist/googleAds/keywordPlanner/customerId.d.cts

@@ -0,0 +1,7 @@
+//#region src/googleAds/keywordPlanner/customerId.d.ts
+/**
+ * Normalises a Google Ads customer ID for api_customer_id - stored without hyphens, or null
+ * when no customer ID applies to the request.
+ */
+export declare const getRequestCustomerId: (customerId?: string | null) => string | null;
+//#endregion

package/dist/googleAds/keywordPlanner/customerId.d.mts

@@ -0,0 +1,7 @@
+//#region src/googleAds/keywordPlanner/customerId.d.ts
+/**
+ * Normalises a Google Ads customer ID for api_customer_id - stored without hyphens, or null
+ * when no customer ID applies to the request.
+ */
+export declare const getRequestCustomerId: (customerId?: string | null) => string | null;
+//#endregion

package/dist/googleAds/keywordPlanner/customerId.mjs

@@ -0,0 +1,10 @@
+//#region src/googleAds/keywordPlanner/customerId.ts
+/**
+* Normalises a Google Ads customer ID for api_customer_id - stored without hyphens, or null
+* when no customer ID applies to the request.
+*/
+const getRequestCustomerId = (customerId) => {
+	return customerId ? customerId.replaceAll("-", "") : null;
+};
+//#endregion
+export { getRequestCustomerId };

package/dist/googleAds/keywordPlanner/endpoint.cjs

@@ -0,0 +1,8 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/googleAds/keywordPlanner/endpoint.ts
+const endpoint = {
+	HISTORIC_METRICS: "HISTORIC_METRICS",
+	KEYWORD_IDEAS: "KEYWORD_IDEAS"
+};
+//#endregion
+exports.endpoint = endpoint;

package/dist/googleAds/keywordPlanner/endpoint.d.cts

@@ -0,0 +1,7 @@
+//#region src/googleAds/keywordPlanner/endpoint.d.ts
+export declare const endpoint: {
+  readonly HISTORIC_METRICS: "HISTORIC_METRICS";
+  readonly KEYWORD_IDEAS: "KEYWORD_IDEAS";
+};
+export type Endpoint = typeof endpoint[keyof typeof endpoint];
+//#endregion

package/dist/googleAds/keywordPlanner/endpoint.d.mts

@@ -0,0 +1,7 @@
+//#region src/googleAds/keywordPlanner/endpoint.d.ts
+export declare const endpoint: {
+  readonly HISTORIC_METRICS: "HISTORIC_METRICS";
+  readonly KEYWORD_IDEAS: "KEYWORD_IDEAS";
+};
+export type Endpoint = typeof endpoint[keyof typeof endpoint];
+//#endregion

package/dist/googleAds/keywordPlanner/endpoint.mjs

@@ -0,0 +1,7 @@
+//#region src/googleAds/keywordPlanner/endpoint.ts
+const endpoint = {
+	HISTORIC_METRICS: "HISTORIC_METRICS",
+	KEYWORD_IDEAS: "KEYWORD_IDEAS"
+};
+//#endregion
+export { endpoint };

package/dist/googleAds/keywordPlanner/getKwpTimeframe.cjs

@@ -0,0 +1,39 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_date_calculation = require("../../date/calculation.cjs");
+const require_date_date = require("../../date/date.cjs");
+const require_date_format = require("../../date/format.cjs");
+//#region src/googleAds/keywordPlanner/getKwpTimeframe.ts
+/**
+* Always fallback to 2 months ago.
+*
+* Returns the correct shape.
+*/
+const getKwpTimeframe = (isLastMonth) => {
+	let response = {
+		historicalMetricsOptions: {
+			startYear: 1901,
+			startMonth: require_date_date.month.JANUARY,
+			endYear: 1901,
+			endMonth: require_date_date.month.DECEMBER
+		},
+		start: require_date_date.defaultDateNumber,
+		end: require_date_date.defaultDateNumber,
+		end1st: require_date_date.defaultDateNumber,
+		isLastMonth
+	};
+	const endMonthDate = require_date_calculation.getToday().startOf("month").minus({ months: isLastMonth ? 1 : 2 });
+	response.end1st = require_date_format.getYmdNumber(endMonthDate);
+	response.historicalMetricsOptions.endMonth = require_date_format.format(endMonthDate, "MMMM").toUpperCase();
+	response.historicalMetricsOptions.endYear = require_date_format.getYearNumber(endMonthDate);
+	const endDate = require_date_calculation.getLuxonDate(`${response.historicalMetricsOptions.endYear}-${response.historicalMetricsOptions.endMonth}-01`);
+	response.end = require_date_format.getYmdNumber(endDate.endOf("month"));
+	let startMonthDate = endMonthDate.plus({ months: 1 });
+	startMonthDate = startMonthDate.minus({ years: 4 });
+	response.historicalMetricsOptions.startMonth = require_date_format.format(startMonthDate, "MMMM").toUpperCase();
+	response.historicalMetricsOptions.startYear = require_date_format.getYearNumber(startMonthDate);
+	response.start = require_date_format.getYmdNumber(`${response.historicalMetricsOptions.startYear} ${response.historicalMetricsOptions.startMonth} 01`);
+	response.isLastMonth = isLastMonth;
+	return response;
+};
+//#endregion
+exports.getKwpTimeframe = getKwpTimeframe;

package/dist/googleAds/keywordPlanner/getKwpTimeframe.d.cts

@@ -0,0 +1,16 @@
+import { PHPConfig } from "./zodPHP.cjs";
+//#region src/googleAds/keywordPlanner/getKwpTimeframe.d.ts
+export type KwpTimeframe = {
+  historicalMetricsOptions: PHPConfig["api"]["historicalMetricsOptions"];
+  start: number;
+  end: number;
+  end1st: number;
+  isLastMonth: boolean;
+};
+/**
+ * Always fallback to 2 months ago.
+ *
+ * Returns the correct shape.
+ */
+export declare const getKwpTimeframe: (isLastMonth: boolean) => KwpTimeframe;
+//#endregion

package/dist/googleAds/keywordPlanner/getKwpTimeframe.d.mts

@@ -0,0 +1,16 @@
+import { PHPConfig } from "./zodPHP.mjs";
+//#region src/googleAds/keywordPlanner/getKwpTimeframe.d.ts
+export type KwpTimeframe = {
+  historicalMetricsOptions: PHPConfig["api"]["historicalMetricsOptions"];
+  start: number;
+  end: number;
+  end1st: number;
+  isLastMonth: boolean;
+};
+/**
+ * Always fallback to 2 months ago.
+ *
+ * Returns the correct shape.
+ */
+export declare const getKwpTimeframe: (isLastMonth: boolean) => KwpTimeframe;
+//#endregion

package/dist/googleAds/keywordPlanner/getKwpTimeframe.mjs

@@ -0,0 +1,38 @@
+import { getLuxonDate, getToday } from "../../date/calculation.mjs";
+import { defaultDateNumber, month } from "../../date/date.mjs";
+import { format, getYearNumber, getYmdNumber } from "../../date/format.mjs";
+//#region src/googleAds/keywordPlanner/getKwpTimeframe.ts
+/**
+* Always fallback to 2 months ago.
+*
+* Returns the correct shape.
+*/
+const getKwpTimeframe = (isLastMonth) => {
+	let response = {
+		historicalMetricsOptions: {
+			startYear: 1901,
+			startMonth: month.JANUARY,
+			endYear: 1901,
+			endMonth: month.DECEMBER
+		},
+		start: defaultDateNumber,
+		end: defaultDateNumber,
+		end1st: defaultDateNumber,
+		isLastMonth
+	};
+	const endMonthDate = getToday().startOf("month").minus({ months: isLastMonth ? 1 : 2 });
+	response.end1st = getYmdNumber(endMonthDate);
+	response.historicalMetricsOptions.endMonth = format(endMonthDate, "MMMM").toUpperCase();
+	response.historicalMetricsOptions.endYear = getYearNumber(endMonthDate);
+	const endDate = getLuxonDate(`${response.historicalMetricsOptions.endYear}-${response.historicalMetricsOptions.endMonth}-01`);
+	response.end = getYmdNumber(endDate.endOf("month"));
+	let startMonthDate = endMonthDate.plus({ months: 1 });
+	startMonthDate = startMonthDate.minus({ years: 4 });
+	response.historicalMetricsOptions.startMonth = format(startMonthDate, "MMMM").toUpperCase();
+	response.historicalMetricsOptions.startYear = getYearNumber(startMonthDate);
+	response.start = getYmdNumber(`${response.historicalMetricsOptions.startYear} ${response.historicalMetricsOptions.startMonth} 01`);
+	response.isLastMonth = isLastMonth;
+	return response;
+};
+//#endregion
+export { getKwpTimeframe };