@8ms/helpers 3.1.0 → 3.2.0

package/dist/file/_shared/spreadsheetFileType.d.mts

@@ -0,0 +1,9 @@
+//#region src/file/_shared/spreadsheetFileType.d.ts
+export declare const spreadsheetFileType: {
+  readonly CSV: "csv";
+  readonly TSV: "tsv";
+  readonly XLS: "xls";
+  readonly XLSX: "xlsx";
+};
+export type SpreadsheetFileType = typeof spreadsheetFileType[keyof typeof spreadsheetFileType];
+//#endregion

package/dist/file/_shared/spreadsheetFileType.mjs

@@ -0,0 +1,9 @@
+//#region src/file/_shared/spreadsheetFileType.ts
+const spreadsheetFileType = {
+	CSV: "csv",
+	TSV: "tsv",
+	XLS: "xls",
+	XLSX: "xlsx"
+};
+//#endregion
+export { spreadsheetFileType };

package/dist/file/_shared/videoFileType.cjs

@@ -0,0 +1,11 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/file/_shared/videoFileType.ts
+const videoFileType = {
+	AVI: "avi",
+	MKV: "mkv",
+	MOV: "mov",
+	MP4: "mp4",
+	WEBM: "webm"
+};
+//#endregion
+exports.videoFileType = videoFileType;

package/dist/file/_shared/videoFileType.d.cts

@@ -0,0 +1,10 @@
+//#region src/file/_shared/videoFileType.d.ts
+export declare const videoFileType: {
+  readonly AVI: "avi";
+  readonly MKV: "mkv";
+  readonly MOV: "mov";
+  readonly MP4: "mp4";
+  readonly WEBM: "webm";
+};
+export type VideoFileType = typeof videoFileType[keyof typeof videoFileType];
+//#endregion

package/dist/file/_shared/videoFileType.d.mts

@@ -0,0 +1,10 @@
+//#region src/file/_shared/videoFileType.d.ts
+export declare const videoFileType: {
+  readonly AVI: "avi";
+  readonly MKV: "mkv";
+  readonly MOV: "mov";
+  readonly MP4: "mp4";
+  readonly WEBM: "webm";
+};
+export type VideoFileType = typeof videoFileType[keyof typeof videoFileType];
+//#endregion

package/dist/file/_shared/videoFileType.mjs

@@ -0,0 +1,10 @@
+//#region src/file/_shared/videoFileType.ts
+const videoFileType = {
+	AVI: "avi",
+	MKV: "mkv",
+	MOV: "mov",
+	MP4: "mp4",
+	WEBM: "webm"
+};
+//#endregion
+export { videoFileType };

package/dist/file/client/index.cjs

@@ -0,0 +1,20 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_file__shared_archiveFileType = require("../_shared/archiveFileType.cjs");
+const require_file__shared_dataFileType = require("../_shared/dataFileType.cjs");
+const require_file__shared_documentFileType = require("../_shared/documentFileType.cjs");
+const require_file__shared_imageFileType = require("../_shared/imageFileType.cjs");
+const require_file__shared_spreadsheetFileType = require("../_shared/spreadsheetFileType.cjs");
+const require_file__shared_videoFileType = require("../_shared/videoFileType.cjs");
+const require_file__shared_fileType = require("../_shared/fileType.cjs");
+const require_file__shared_fileMimeType = require("../_shared/fileMimeType.cjs");
+const require_file__shared_getFileKey = require("../_shared/getFileKey.cjs");
+require("../_shared/index.cjs");
+exports.archiveFileType = require_file__shared_archiveFileType.archiveFileType;
+exports.dataFileType = require_file__shared_dataFileType.dataFileType;
+exports.documentFileType = require_file__shared_documentFileType.documentFileType;
+exports.fileMimeType = require_file__shared_fileMimeType.fileMimeType;
+exports.fileType = require_file__shared_fileType.fileType;
+exports.getFileKey = require_file__shared_getFileKey.getFileKey;
+exports.imageFileType = require_file__shared_imageFileType.imageFileType;
+exports.spreadsheetFileType = require_file__shared_spreadsheetFileType.spreadsheetFileType;
+exports.videoFileType = require_file__shared_videoFileType.videoFileType;

package/dist/file/client/index.d.cts

@@ -0,0 +1,10 @@
+import { ArchiveFileType, archiveFileType } from "../_shared/archiveFileType.cjs";
+import { DataFileType, dataFileType } from "../_shared/dataFileType.cjs";
+import { DocumentFileType, documentFileType } from "../_shared/documentFileType.cjs";
+import { FileType, fileType } from "../_shared/fileType.cjs";
+import { fileMimeType } from "../_shared/fileMimeType.cjs";
+import { getFileKey } from "../_shared/getFileKey.cjs";
+import { ImageFileType, imageFileType } from "../_shared/imageFileType.cjs";
+import { SpreadsheetFileType, spreadsheetFileType } from "../_shared/spreadsheetFileType.cjs";
+import { VideoFileType, videoFileType } from "../_shared/videoFileType.cjs";
+export { ArchiveFileType, DataFileType, DocumentFileType, FileType, ImageFileType, SpreadsheetFileType, VideoFileType, archiveFileType, dataFileType, documentFileType, fileMimeType, fileType, getFileKey, imageFileType, spreadsheetFileType, videoFileType };

package/dist/file/client/index.d.mts

@@ -0,0 +1,10 @@
+import { ArchiveFileType, archiveFileType } from "../_shared/archiveFileType.mjs";
+import { DataFileType, dataFileType } from "../_shared/dataFileType.mjs";
+import { DocumentFileType, documentFileType } from "../_shared/documentFileType.mjs";
+import { FileType, fileType } from "../_shared/fileType.mjs";
+import { fileMimeType } from "../_shared/fileMimeType.mjs";
+import { getFileKey } from "../_shared/getFileKey.mjs";
+import { ImageFileType, imageFileType } from "../_shared/imageFileType.mjs";
+import { SpreadsheetFileType, spreadsheetFileType } from "../_shared/spreadsheetFileType.mjs";
+import { VideoFileType, videoFileType } from "../_shared/videoFileType.mjs";
+export { ArchiveFileType, DataFileType, DocumentFileType, FileType, ImageFileType, SpreadsheetFileType, VideoFileType, archiveFileType, dataFileType, documentFileType, fileMimeType, fileType, getFileKey, imageFileType, spreadsheetFileType, videoFileType };

package/dist/file/client/index.mjs

@@ -0,0 +1,11 @@
+import { archiveFileType } from "../_shared/archiveFileType.mjs";
+import { dataFileType } from "../_shared/dataFileType.mjs";
+import { documentFileType } from "../_shared/documentFileType.mjs";
+import { imageFileType } from "../_shared/imageFileType.mjs";
+import { spreadsheetFileType } from "../_shared/spreadsheetFileType.mjs";
+import { videoFileType } from "../_shared/videoFileType.mjs";
+import { fileType } from "../_shared/fileType.mjs";
+import { fileMimeType } from "../_shared/fileMimeType.mjs";
+import { getFileKey } from "../_shared/getFileKey.mjs";
+import "../_shared/index.mjs";
+export { archiveFileType, dataFileType, documentFileType, fileMimeType, fileType, getFileKey, imageFileType, spreadsheetFileType, videoFileType };

package/dist/file/server/index.cjs

@@ -1,3 +1,22 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_file__shared_archiveFileType = require("../_shared/archiveFileType.cjs");
+const require_file__shared_dataFileType = require("../_shared/dataFileType.cjs");
+const require_file__shared_documentFileType = require("../_shared/documentFileType.cjs");
+const require_file__shared_imageFileType = require("../_shared/imageFileType.cjs");
+const require_file__shared_spreadsheetFileType = require("../_shared/spreadsheetFileType.cjs");
+const require_file__shared_videoFileType = require("../_shared/videoFileType.cjs");
+const require_file__shared_fileType = require("../_shared/fileType.cjs");
+const require_file__shared_fileMimeType = require("../_shared/fileMimeType.cjs");
+const require_file__shared_getFileKey = require("../_shared/getFileKey.cjs");
+require("../_shared/index.cjs");
 const require_file_server_createDirectory = require("./createDirectory.cjs");
+exports.archiveFileType = require_file__shared_archiveFileType.archiveFileType;
 exports.createDirectory = require_file_server_createDirectory.createDirectory;
+exports.dataFileType = require_file__shared_dataFileType.dataFileType;
+exports.documentFileType = require_file__shared_documentFileType.documentFileType;
+exports.fileMimeType = require_file__shared_fileMimeType.fileMimeType;
+exports.fileType = require_file__shared_fileType.fileType;
+exports.getFileKey = require_file__shared_getFileKey.getFileKey;
+exports.imageFileType = require_file__shared_imageFileType.imageFileType;
+exports.spreadsheetFileType = require_file__shared_spreadsheetFileType.spreadsheetFileType;
+exports.videoFileType = require_file__shared_videoFileType.videoFileType;

package/dist/file/server/index.d.cts

@@ -1,2 +1,11 @@
+import { ArchiveFileType, archiveFileType } from "../_shared/archiveFileType.cjs";
+import { DataFileType, dataFileType } from "../_shared/dataFileType.cjs";
+import { DocumentFileType, documentFileType } from "../_shared/documentFileType.cjs";
+import { FileType, fileType } from "../_shared/fileType.cjs";
+import { fileMimeType } from "../_shared/fileMimeType.cjs";
+import { getFileKey } from "../_shared/getFileKey.cjs";
+import { ImageFileType, imageFileType } from "../_shared/imageFileType.cjs";
+import { SpreadsheetFileType, spreadsheetFileType } from "../_shared/spreadsheetFileType.cjs";
+import { VideoFileType, videoFileType } from "../_shared/videoFileType.cjs";
 import { createDirectory } from "./createDirectory.cjs";
-export { createDirectory };
+export { ArchiveFileType, DataFileType, DocumentFileType, FileType, ImageFileType, SpreadsheetFileType, VideoFileType, archiveFileType, createDirectory, dataFileType, documentFileType, fileMimeType, fileType, getFileKey, imageFileType, spreadsheetFileType, videoFileType };

package/dist/file/server/index.d.mts

@@ -1,2 +1,11 @@
+import { ArchiveFileType, archiveFileType } from "../_shared/archiveFileType.mjs";
+import { DataFileType, dataFileType } from "../_shared/dataFileType.mjs";
+import { DocumentFileType, documentFileType } from "../_shared/documentFileType.mjs";
+import { FileType, fileType } from "../_shared/fileType.mjs";
+import { fileMimeType } from "../_shared/fileMimeType.mjs";
+import { getFileKey } from "../_shared/getFileKey.mjs";
+import { ImageFileType, imageFileType } from "../_shared/imageFileType.mjs";
+import { SpreadsheetFileType, spreadsheetFileType } from "../_shared/spreadsheetFileType.mjs";
+import { VideoFileType, videoFileType } from "../_shared/videoFileType.mjs";
 import { createDirectory } from "./createDirectory.mjs";
-export { createDirectory };
+export { ArchiveFileType, DataFileType, DocumentFileType, FileType, ImageFileType, SpreadsheetFileType, VideoFileType, archiveFileType, createDirectory, dataFileType, documentFileType, fileMimeType, fileType, getFileKey, imageFileType, spreadsheetFileType, videoFileType };

package/dist/file/server/index.mjs

@@ -1,2 +1,12 @@
+import { archiveFileType } from "../_shared/archiveFileType.mjs";
+import { dataFileType } from "../_shared/dataFileType.mjs";
+import { documentFileType } from "../_shared/documentFileType.mjs";
+import { imageFileType } from "../_shared/imageFileType.mjs";
+import { spreadsheetFileType } from "../_shared/spreadsheetFileType.mjs";
+import { videoFileType } from "../_shared/videoFileType.mjs";
+import { fileType } from "../_shared/fileType.mjs";
+import { fileMimeType } from "../_shared/fileMimeType.mjs";
+import { getFileKey } from "../_shared/getFileKey.mjs";
+import "../_shared/index.mjs";
 import { createDirectory } from "./createDirectory.mjs";
-export { createDirectory };
+export { archiveFileType, createDirectory, dataFileType, documentFileType, fileMimeType, fileType, getFileKey, imageFileType, spreadsheetFileType, videoFileType };

package/dist/googleAds/keywordPlanner/_shared/bigquery.cjs

@@ -0,0 +1,92 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_googleCloud_bigquery__shared__field_bqDate = require("../../../googleCloud/bigquery/_shared/_field/bqDate.cjs");
+const require_googleCloud_bigquery__shared__field_bqDateTime = require("../../../googleCloud/bigquery/_shared/_field/bqDateTime.cjs");
+const require_googleCloud_bigquery__shared__field_bqInt = require("../../../googleCloud/bigquery/_shared/_field/bqInt.cjs");
+const require_googleCloud_bigquery__shared_partitionType = require("../../../googleCloud/bigquery/_shared/partitionType.cjs");
+const require_googleCloud_bigquery__shared_zodToBQDefinition = require("../../../googleCloud/bigquery/_shared/zodToBQDefinition.cjs");
+require("../../../googleCloud/bigquery/_shared/index.cjs");
+const require_googleAds_keywordPlanner__shared_network = require("./network.cjs");
+let zod = require("zod");
+//#region src/googleAds/keywordPlanner/_shared/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__shared__field_bqDate.zLuxonDate,
+	api_customer_id: zod.z.string().nullable(),
+	api_network: require_googleAds_keywordPlanner__shared_network.requestNetworkNameSchema.nullable(),
+	api_countries: zod.z.string().nullable(),
+	api_language: require_googleCloud_bigquery__shared__field_bqInt.zBQInt.nullable(),
+	avg_cpc: zod.z.number().nullable(),
+	avg_search_volume: require_googleCloud_bigquery__shared__field_bqInt.zBQInt,
+	competition: zod.z.string(),
+	competition_index: require_googleCloud_bigquery__shared__field_bqInt.zBQInt.nullable(),
+	months: zod.z.object({
+		date: require_googleCloud_bigquery__shared__field_bqDate.zLuxonDate,
+		search_volume: require_googleCloud_bigquery__shared__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__shared__field_bqInt.zBQInt.nullable(),
+	missing: zod.z.boolean(),
+	inserted_at: require_googleCloud_bigquery__shared__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__shared_zodToBQDefinition.zodToBQSchema(keywordPlannerBQRowSchema),
+		timePartitioning: {
+			type: require_googleCloud_bigquery__shared_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__shared__field_bqDate.zLuxonDate.transform(require_googleCloud_bigquery__shared__field_bqDate.encodeBQDate),
+	months: zod.z.object({
+		date: require_googleCloud_bigquery__shared__field_bqDate.zLuxonDate.transform(require_googleCloud_bigquery__shared__field_bqDate.encodeBQDate),
+		search_volume: zod.z.number()
+	}).array(),
+	inserted_at: require_googleCloud_bigquery__shared__field_bqDateTime.zLuxonDateTime.transform(require_googleCloud_bigquery__shared__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__shared__field_bqDate.BQDate.transform(require_googleCloud_bigquery__shared__field_bqDate.decodeBQDate),
+	months: zod.z.object({
+		date: require_googleCloud_bigquery__shared__field_bqDate.BQDate.transform(require_googleCloud_bigquery__shared__field_bqDate.decodeBQDate),
+		search_volume: zod.z.number()
+	}).array(),
+	inserted_at: require_googleCloud_bigquery__shared__field_bqDateTime.BQDateTime.transform(require_googleCloud_bigquery__shared__field_bqDateTime.decodeBQDateTime)
+});
+//#endregion
+exports.keywordPlannerBQInsertRowSchema = keywordPlannerBQInsertRowSchema;
+exports.keywordPlannerBQReadRowSchema = keywordPlannerBQReadRowSchema;
+exports.keywordPlannerBQRowSchema = keywordPlannerBQRowSchema;
+exports.keywordPlannerDefinition = keywordPlannerDefinition;
+exports.keywordPlannerTableId = keywordPlannerTableId;

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

@@ -0,0 +1,120 @@
+import { TableDefinition } from "../../../googleCloud/bigquery/_shared/tableDefinition.cjs";
+import "../../../googleCloud/bigquery/_shared/index.cjs";
+import { z } from "zod";
+//#region src/googleAds/keywordPlanner/_shared/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/_shared/bigquery.d.mts

@@ -0,0 +1,120 @@
+import { TableDefinition } from "../../../googleCloud/bigquery/_shared/tableDefinition.mjs";
+import "../../../googleCloud/bigquery/_shared/index.mjs";
+import { z } from "zod";
+//#region src/googleAds/keywordPlanner/_shared/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/_shared/bigquery.mjs

@@ -0,0 +1,87 @@
+import { BQDate, decodeBQDate, encodeBQDate, zLuxonDate } from "../../../googleCloud/bigquery/_shared/_field/bqDate.mjs";
+import { BQDateTime, decodeBQDateTime, encodeBQDateTime, zLuxonDateTime } from "../../../googleCloud/bigquery/_shared/_field/bqDateTime.mjs";
+import { zBQInt } from "../../../googleCloud/bigquery/_shared/_field/bqInt.mjs";
+import { partitionType } from "../../../googleCloud/bigquery/_shared/partitionType.mjs";
+import { zodToBQSchema } from "../../../googleCloud/bigquery/_shared/zodToBQDefinition.mjs";
+import "../../../googleCloud/bigquery/_shared/index.mjs";
+import { requestNetworkNameSchema } from "./network.mjs";
+import { z } from "zod";
+//#region src/googleAds/keywordPlanner/_shared/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/_shared/countries.cjs

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/googleAds/keywordPlanner/_shared/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/_shared/countries.d.cts

@@ -0,0 +1,8 @@
+//#region src/googleAds/keywordPlanner/_shared/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