@8ms/helpers 3.0.27 → 3.1.1

package/dist/googleAds/keywordPlanner/getLambdaFunctionName.cjs

@@ -0,0 +1,16 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_environment_environment = require("../../environment/environment.cjs");
+const require_googleAds_keywordPlanner_endpoint = require("./endpoint.cjs");
+//#region src/googleAds/keywordPlanner/getLambdaFunctionName.ts
+const lambdaFunction = {
+	[require_googleAds_keywordPlanner_endpoint.endpoint.HISTORIC_METRICS]: "googleAdsKeywordPlannerHistoricalMetrics",
+	[require_googleAds_keywordPlanner_endpoint.endpoint.KEYWORD_IDEAS]: "googleAdsKeywordPlannerKeywordIdeas"
+};
+/**
+* Resolve the full environment-qualified AWS Lambda function name for a given KWP endpoint.
+*/
+const getLambdaFunctionName = (endpointValue) => {
+	return `aws-php-${require_environment_environment.getEnvironment()}-${lambdaFunction[endpointValue]}`;
+};
+//#endregion
+exports.getLambdaFunctionName = getLambdaFunctionName;

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

@@ -0,0 +1,7 @@
+import { Endpoint } from "./endpoint.cjs";
+//#region src/googleAds/keywordPlanner/getLambdaFunctionName.d.ts
+/**
+ * Resolve the full environment-qualified AWS Lambda function name for a given KWP endpoint.
+ */
+export declare const getLambdaFunctionName: (endpointValue: Endpoint) => string;
+//#endregion

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

@@ -0,0 +1,7 @@
+import { Endpoint } from "./endpoint.mjs";
+//#region src/googleAds/keywordPlanner/getLambdaFunctionName.d.ts
+/**
+ * Resolve the full environment-qualified AWS Lambda function name for a given KWP endpoint.
+ */
+export declare const getLambdaFunctionName: (endpointValue: Endpoint) => string;
+//#endregion

package/dist/googleAds/keywordPlanner/getLambdaFunctionName.mjs

@@ -0,0 +1,15 @@
+import { getEnvironment } from "../../environment/environment.mjs";
+import { endpoint } from "./endpoint.mjs";
+//#region src/googleAds/keywordPlanner/getLambdaFunctionName.ts
+const lambdaFunction = {
+	[endpoint.HISTORIC_METRICS]: "googleAdsKeywordPlannerHistoricalMetrics",
+	[endpoint.KEYWORD_IDEAS]: "googleAdsKeywordPlannerKeywordIdeas"
+};
+/**
+* Resolve the full environment-qualified AWS Lambda function name for a given KWP endpoint.
+*/
+const getLambdaFunctionName = (endpointValue) => {
+	return `aws-php-${getEnvironment()}-${lambdaFunction[endpointValue]}`;
+};
+//#endregion
+export { getLambdaFunctionName };

package/dist/googleAds/keywordPlanner/index.cjs

@@ -0,0 +1,38 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_googleAds_keywordPlanner_network = require("./network.cjs");
+const require_googleAds_keywordPlanner_bigquery = require("./bigquery.cjs");
+const require_googleAds_keywordPlanner_countries = require("./countries.cjs");
+const require_googleAds_keywordPlanner_customerId = require("./customerId.cjs");
+const require_googleAds_keywordPlanner_endpoint = require("./endpoint.cjs");
+const require_googleAds_keywordPlanner_getKwpTimeframe = require("./getKwpTimeframe.cjs");
+const require_googleAds_keywordPlanner_getLambdaFunctionName = require("./getLambdaFunctionName.cjs");
+const require_googleAds_keywordPlanner_language = require("./language.cjs");
+const require_googleAds_keywordPlanner_maxRequests = require("./maxRequests.cjs");
+const require_googleAds_keywordPlanner_normalizeQuery = require("./normalizeQuery.cjs");
+const require_googleAds_keywordPlanner_zodPHP = require("./zodPHP.cjs");
+const require_googleAds_keywordPlanner_zodPHPPayload = require("./zodPHPPayload.cjs");
+const require_googleAds_keywordPlanner_zodPHPResponse = require("./zodPHPResponse.cjs");
+exports.endpoint = require_googleAds_keywordPlanner_endpoint.endpoint;
+exports.getKwpTimeframe = require_googleAds_keywordPlanner_getKwpTimeframe.getKwpTimeframe;
+exports.getLambdaFunctionName = require_googleAds_keywordPlanner_getLambdaFunctionName.getLambdaFunctionName;
+exports.getNormalizeQuery = require_googleAds_keywordPlanner_normalizeQuery.getNormalizeQuery;
+exports.getRequestCountries = require_googleAds_keywordPlanner_countries.getRequestCountries;
+exports.getRequestCustomerId = require_googleAds_keywordPlanner_customerId.getRequestCustomerId;
+exports.getRequestLanguage = require_googleAds_keywordPlanner_language.getRequestLanguage;
+exports.getRequestNetwork = require_googleAds_keywordPlanner_network.getRequestNetwork;
+exports.getRequestNetworkValue = require_googleAds_keywordPlanner_network.getRequestNetworkValue;
+exports.keywordPlannerBQInsertRowSchema = require_googleAds_keywordPlanner_bigquery.keywordPlannerBQInsertRowSchema;
+exports.keywordPlannerBQReadRowSchema = require_googleAds_keywordPlanner_bigquery.keywordPlannerBQReadRowSchema;
+exports.keywordPlannerBQRowSchema = require_googleAds_keywordPlanner_bigquery.keywordPlannerBQRowSchema;
+exports.keywordPlannerDefinition = require_googleAds_keywordPlanner_bigquery.keywordPlannerDefinition;
+exports.keywordPlannerTableId = require_googleAds_keywordPlanner_bigquery.keywordPlannerTableId;
+exports.kwpMaxQueries = require_googleAds_keywordPlanner_maxRequests.kwpMaxQueries;
+exports.network = require_googleAds_keywordPlanner_network.network;
+exports.phpConfigSchema = require_googleAds_keywordPlanner_zodPHP.phpConfigSchema;
+exports.phpPayloadRequestDetailsSchema = require_googleAds_keywordPlanner_zodPHPPayload.phpPayloadRequestDetailsSchema;
+exports.phpPayloadSchema = require_googleAds_keywordPlanner_zodPHPPayload.phpPayloadSchema;
+exports.phpResponseMonthSchema = require_googleAds_keywordPlanner_zodPHPResponse.phpResponseMonthSchema;
+exports.phpResponseRowSchema = require_googleAds_keywordPlanner_zodPHPResponse.phpResponseRowSchema;
+exports.phpResponseSchema = require_googleAds_keywordPlanner_zodPHPResponse.phpResponseSchema;
+exports.phpRowDetailsSchema = require_googleAds_keywordPlanner_zodPHP.phpRowDetailsSchema;
+exports.requestNetworkNameSchema = require_googleAds_keywordPlanner_network.requestNetworkNameSchema;

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

@@ -0,0 +1,14 @@
+import { KeywordPlannerBQInsertRow, KeywordPlannerBQReadRow, KeywordPlannerBQRow, keywordPlannerBQInsertRowSchema, keywordPlannerBQReadRowSchema, keywordPlannerBQRowSchema, keywordPlannerDefinition, keywordPlannerTableId } from "./bigquery.cjs";
+import { getRequestCountries } from "./countries.cjs";
+import { getRequestCustomerId } from "./customerId.cjs";
+import { Endpoint, endpoint } from "./endpoint.cjs";
+import { PHPConfig, PHPRowDetails, phpConfigSchema, phpRowDetailsSchema } from "./zodPHP.cjs";
+import { KwpTimeframe, getKwpTimeframe } from "./getKwpTimeframe.cjs";
+import { getLambdaFunctionName } from "./getLambdaFunctionName.cjs";
+import { getRequestLanguage } from "./language.cjs";
+import { kwpMaxQueries } from "./maxRequests.cjs";
+import { Network, RequestNetworkName, getRequestNetwork, getRequestNetworkValue, network, requestNetworkNameSchema } from "./network.cjs";
+import { getNormalizeQuery } from "./normalizeQuery.cjs";
+import { PHPPayload, PHPPayloadRequestDetails, phpPayloadRequestDetailsSchema, phpPayloadSchema } from "./zodPHPPayload.cjs";
+import { PHPResponse, PHPResponseMonth, PHPResponseRow, phpResponseMonthSchema, phpResponseRowSchema, phpResponseSchema } from "./zodPHPResponse.cjs";
+export { Endpoint, KeywordPlannerBQInsertRow, KeywordPlannerBQReadRow, KeywordPlannerBQRow, KwpTimeframe, Network, PHPConfig, PHPPayload, PHPPayloadRequestDetails, PHPResponse, PHPResponseMonth, PHPResponseRow, PHPRowDetails, RequestNetworkName, endpoint, getKwpTimeframe, getLambdaFunctionName, getNormalizeQuery, getRequestCountries, getRequestCustomerId, getRequestLanguage, getRequestNetwork, getRequestNetworkValue, keywordPlannerBQInsertRowSchema, keywordPlannerBQReadRowSchema, keywordPlannerBQRowSchema, keywordPlannerDefinition, keywordPlannerTableId, kwpMaxQueries, network, phpConfigSchema, phpPayloadRequestDetailsSchema, phpPayloadSchema, phpResponseMonthSchema, phpResponseRowSchema, phpResponseSchema, phpRowDetailsSchema, requestNetworkNameSchema };

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

@@ -0,0 +1,14 @@
+import { KeywordPlannerBQInsertRow, KeywordPlannerBQReadRow, KeywordPlannerBQRow, keywordPlannerBQInsertRowSchema, keywordPlannerBQReadRowSchema, keywordPlannerBQRowSchema, keywordPlannerDefinition, keywordPlannerTableId } from "./bigquery.mjs";
+import { getRequestCountries } from "./countries.mjs";
+import { getRequestCustomerId } from "./customerId.mjs";
+import { Endpoint, endpoint } from "./endpoint.mjs";
+import { PHPConfig, PHPRowDetails, phpConfigSchema, phpRowDetailsSchema } from "./zodPHP.mjs";
+import { KwpTimeframe, getKwpTimeframe } from "./getKwpTimeframe.mjs";
+import { getLambdaFunctionName } from "./getLambdaFunctionName.mjs";
+import { getRequestLanguage } from "./language.mjs";
+import { kwpMaxQueries } from "./maxRequests.mjs";
+import { Network, RequestNetworkName, getRequestNetwork, getRequestNetworkValue, network, requestNetworkNameSchema } from "./network.mjs";
+import { getNormalizeQuery } from "./normalizeQuery.mjs";
+import { PHPPayload, PHPPayloadRequestDetails, phpPayloadRequestDetailsSchema, phpPayloadSchema } from "./zodPHPPayload.mjs";
+import { PHPResponse, PHPResponseMonth, PHPResponseRow, phpResponseMonthSchema, phpResponseRowSchema, phpResponseSchema } from "./zodPHPResponse.mjs";
+export { Endpoint, KeywordPlannerBQInsertRow, KeywordPlannerBQReadRow, KeywordPlannerBQRow, KwpTimeframe, Network, PHPConfig, PHPPayload, PHPPayloadRequestDetails, PHPResponse, PHPResponseMonth, PHPResponseRow, PHPRowDetails, RequestNetworkName, endpoint, getKwpTimeframe, getLambdaFunctionName, getNormalizeQuery, getRequestCountries, getRequestCustomerId, getRequestLanguage, getRequestNetwork, getRequestNetworkValue, keywordPlannerBQInsertRowSchema, keywordPlannerBQReadRowSchema, keywordPlannerBQRowSchema, keywordPlannerDefinition, keywordPlannerTableId, kwpMaxQueries, network, phpConfigSchema, phpPayloadRequestDetailsSchema, phpPayloadSchema, phpResponseMonthSchema, phpResponseRowSchema, phpResponseSchema, phpRowDetailsSchema, requestNetworkNameSchema };

package/dist/googleAds/keywordPlanner/index.mjs

@@ -0,0 +1,14 @@
+import { getRequestNetwork, getRequestNetworkValue, network, requestNetworkNameSchema } from "./network.mjs";
+import { keywordPlannerBQInsertRowSchema, keywordPlannerBQReadRowSchema, keywordPlannerBQRowSchema, keywordPlannerDefinition, keywordPlannerTableId } from "./bigquery.mjs";
+import { getRequestCountries } from "./countries.mjs";
+import { getRequestCustomerId } from "./customerId.mjs";
+import { endpoint } from "./endpoint.mjs";
+import { getKwpTimeframe } from "./getKwpTimeframe.mjs";
+import { getLambdaFunctionName } from "./getLambdaFunctionName.mjs";
+import { getRequestLanguage } from "./language.mjs";
+import { kwpMaxQueries } from "./maxRequests.mjs";
+import { getNormalizeQuery } from "./normalizeQuery.mjs";
+import { phpConfigSchema, phpRowDetailsSchema } from "./zodPHP.mjs";
+import { phpPayloadRequestDetailsSchema, phpPayloadSchema } from "./zodPHPPayload.mjs";
+import { phpResponseMonthSchema, phpResponseRowSchema, phpResponseSchema } from "./zodPHPResponse.mjs";
+export { endpoint, getKwpTimeframe, getLambdaFunctionName, getNormalizeQuery, getRequestCountries, getRequestCustomerId, getRequestLanguage, getRequestNetwork, getRequestNetworkValue, keywordPlannerBQInsertRowSchema, keywordPlannerBQReadRowSchema, keywordPlannerBQRowSchema, keywordPlannerDefinition, keywordPlannerTableId, kwpMaxQueries, network, phpConfigSchema, phpPayloadRequestDetailsSchema, phpPayloadSchema, phpResponseMonthSchema, phpResponseRowSchema, phpResponseSchema, phpRowDetailsSchema, requestNetworkNameSchema };

package/dist/googleAds/keywordPlanner/language.cjs

@@ -0,0 +1,11 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/googleAds/keywordPlanner/language.ts
+/**
+* Normalises a Google Ads language ID for api_language - null when a website has no mapped
+* Google Ads language.
+*/
+const getRequestLanguage = (language) => {
+	return language ?? null;
+};
+//#endregion
+exports.getRequestLanguage = getRequestLanguage;

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

@@ -0,0 +1,7 @@
+//#region src/googleAds/keywordPlanner/language.d.ts
+/**
+ * Normalises a Google Ads language ID for api_language - null when a website has no mapped
+ * Google Ads language.
+ */
+export declare const getRequestLanguage: (language?: number | null) => number | null;
+//#endregion

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

@@ -0,0 +1,7 @@
+//#region src/googleAds/keywordPlanner/language.d.ts
+/**
+ * Normalises a Google Ads language ID for api_language - null when a website has no mapped
+ * Google Ads language.
+ */
+export declare const getRequestLanguage: (language?: number | null) => number | null;
+//#endregion

package/dist/googleAds/keywordPlanner/language.mjs

@@ -0,0 +1,10 @@
+//#region src/googleAds/keywordPlanner/language.ts
+/**
+* Normalises a Google Ads language ID for api_language - null when a website has no mapped
+* Google Ads language.
+*/
+const getRequestLanguage = (language) => {
+	return language ?? null;
+};
+//#endregion
+export { getRequestLanguage };

package/dist/googleAds/keywordPlanner/maxRequests.cjs

@@ -0,0 +1,8 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/googleAds/keywordPlanner/maxRequests.ts
+/**
+* The Google Ads API/PHP endpoint accepts up to 10,000 queries in a single bulk request.
+*/
+const kwpMaxQueries = 1e4;
+//#endregion
+exports.kwpMaxQueries = kwpMaxQueries;

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

@@ -0,0 +1,6 @@
+//#region src/googleAds/keywordPlanner/maxRequests.d.ts
+/**
+ * The Google Ads API/PHP endpoint accepts up to 10,000 queries in a single bulk request.
+ */
+export declare const kwpMaxQueries = 10000;
+//#endregion

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

@@ -0,0 +1,6 @@
+//#region src/googleAds/keywordPlanner/maxRequests.d.ts
+/**
+ * The Google Ads API/PHP endpoint accepts up to 10,000 queries in a single bulk request.
+ */
+export declare const kwpMaxQueries = 10000;
+//#endregion

package/dist/googleAds/keywordPlanner/maxRequests.mjs

@@ -0,0 +1,7 @@
+//#region src/googleAds/keywordPlanner/maxRequests.ts
+/**
+* The Google Ads API/PHP endpoint accepts up to 10,000 queries in a single bulk request.
+*/
+const kwpMaxQueries = 1e4;
+//#endregion
+export { kwpMaxQueries };

package/dist/googleAds/keywordPlanner/network.cjs

@@ -0,0 +1,33 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let zod = require("zod");
+//#region src/googleAds/keywordPlanner/network.ts
+/**
+* api_network is stored in BigQuery as the readable key below (e.g. "GOOGLE_SEARCH_ONLY") rather
+* than this raw Keyword Planner network int, so the table stays self-explanatory without a lookup.
+*/
+const network = {
+	GOOGLE_SEARCH_ONLY: 2,
+	GOOGLE_SEARCH_AND_PARTNERS: 3
+};
+const requestNetworkNameSchema = zod.z.enum(Object.keys(network));
+const nameByNetwork = Object.fromEntries(Object.entries(network).map(([name, value]) => [value, name]));
+/**
+* Converts a Keyword Planner network int (from `network`) into the name stored in
+* api_network. Returns null for an unrecognised value.
+*/
+const getRequestNetwork = (value) => {
+	return nameByNetwork[value] ?? null;
+};
+/**
+* Converts the readable request network name back into the Keyword Planner network int Google
+* Ads/PHP expects on the wire - the inverse of getRequestNetwork. TypeScript code should only ever
+* deal with the string name; this conversion belongs at the point a Lambda payload is built.
+*/
+const getRequestNetworkValue = (name) => {
+	return network[name];
+};
+//#endregion
+exports.getRequestNetwork = getRequestNetwork;
+exports.getRequestNetworkValue = getRequestNetworkValue;
+exports.network = network;
+exports.requestNetworkNameSchema = requestNetworkNameSchema;

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

@@ -0,0 +1,28 @@
+import { z } from "zod";
+//#region src/googleAds/keywordPlanner/network.d.ts
+/**
+ * api_network is stored in BigQuery as the readable key below (e.g. "GOOGLE_SEARCH_ONLY") rather
+ * than this raw Keyword Planner network int, so the table stays self-explanatory without a lookup.
+ */
+export declare const network: {
+  readonly GOOGLE_SEARCH_ONLY: 2;
+  readonly GOOGLE_SEARCH_AND_PARTNERS: 3;
+};
+export type Network = typeof network[keyof typeof network];
+export type RequestNetworkName = keyof typeof network;
+export declare const requestNetworkNameSchema: z.ZodEnum<{
+  GOOGLE_SEARCH_AND_PARTNERS: "GOOGLE_SEARCH_AND_PARTNERS";
+  GOOGLE_SEARCH_ONLY: "GOOGLE_SEARCH_ONLY";
+}>;
+/**
+ * Converts a Keyword Planner network int (from `network`) into the name stored in
+ * api_network. Returns null for an unrecognised value.
+ */
+export declare const getRequestNetwork: (value: number) => RequestNetworkName | null;
+/**
+ * Converts the readable request network name back into the Keyword Planner network int Google
+ * Ads/PHP expects on the wire - the inverse of getRequestNetwork. TypeScript code should only ever
+ * deal with the string name; this conversion belongs at the point a Lambda payload is built.
+ */
+export declare const getRequestNetworkValue: (name: RequestNetworkName) => number;
+//#endregion

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

@@ -0,0 +1,28 @@
+import { z } from "zod";
+//#region src/googleAds/keywordPlanner/network.d.ts
+/**
+ * api_network is stored in BigQuery as the readable key below (e.g. "GOOGLE_SEARCH_ONLY") rather
+ * than this raw Keyword Planner network int, so the table stays self-explanatory without a lookup.
+ */
+export declare const network: {
+  readonly GOOGLE_SEARCH_ONLY: 2;
+  readonly GOOGLE_SEARCH_AND_PARTNERS: 3;
+};
+export type Network = typeof network[keyof typeof network];
+export type RequestNetworkName = keyof typeof network;
+export declare const requestNetworkNameSchema: z.ZodEnum<{
+  GOOGLE_SEARCH_AND_PARTNERS: "GOOGLE_SEARCH_AND_PARTNERS";
+  GOOGLE_SEARCH_ONLY: "GOOGLE_SEARCH_ONLY";
+}>;
+/**
+ * Converts a Keyword Planner network int (from `network`) into the name stored in
+ * api_network. Returns null for an unrecognised value.
+ */
+export declare const getRequestNetwork: (value: number) => RequestNetworkName | null;
+/**
+ * Converts the readable request network name back into the Keyword Planner network int Google
+ * Ads/PHP expects on the wire - the inverse of getRequestNetwork. TypeScript code should only ever
+ * deal with the string name; this conversion belongs at the point a Lambda payload is built.
+ */
+export declare const getRequestNetworkValue: (name: RequestNetworkName) => number;
+//#endregion

package/dist/googleAds/keywordPlanner/network.mjs

@@ -0,0 +1,29 @@
+import { z } from "zod";
+//#region src/googleAds/keywordPlanner/network.ts
+/**
+* api_network is stored in BigQuery as the readable key below (e.g. "GOOGLE_SEARCH_ONLY") rather
+* than this raw Keyword Planner network int, so the table stays self-explanatory without a lookup.
+*/
+const network = {
+	GOOGLE_SEARCH_ONLY: 2,
+	GOOGLE_SEARCH_AND_PARTNERS: 3
+};
+const requestNetworkNameSchema = z.enum(Object.keys(network));
+const nameByNetwork = Object.fromEntries(Object.entries(network).map(([name, value]) => [value, name]));
+/**
+* Converts a Keyword Planner network int (from `network`) into the name stored in
+* api_network. Returns null for an unrecognised value.
+*/
+const getRequestNetwork = (value) => {
+	return nameByNetwork[value] ?? null;
+};
+/**
+* Converts the readable request network name back into the Keyword Planner network int Google
+* Ads/PHP expects on the wire - the inverse of getRequestNetwork. TypeScript code should only ever
+* deal with the string name; this conversion belongs at the point a Lambda payload is built.
+*/
+const getRequestNetworkValue = (name) => {
+	return network[name];
+};
+//#endregion
+export { getRequestNetwork, getRequestNetworkValue, network, requestNetworkNameSchema };

package/dist/googleAds/keywordPlanner/normalizeQuery.cjs

@@ -0,0 +1,14 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/googleAds/keywordPlanner/normalizeQuery.ts
+/**
+* KWP silently strips punctuation from any query and replaces it with a space before storing/
+* returning it (e.g. "who's the best?" comes back as "who's the best "), except standard
+* apostrophes which it leaves untouched. Every caller that builds a query to submit to KWP, or
+* joins/compares against KWP's stored `query` column, must apply the exact same transformation -
+* kept as one JS form and one SQL form here so they can't drift apart.
+*/
+const getNormalizeQuery = (column) => {
+	return `TRIM(REGEXP_REPLACE(REGEXP_REPLACE(${column}, r"[^a-zA-Z0-9']+", ' '), r' +', ' '))`;
+};
+//#endregion
+exports.getNormalizeQuery = getNormalizeQuery;

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

@@ -0,0 +1,10 @@
+//#region src/googleAds/keywordPlanner/normalizeQuery.d.ts
+/**
+ * KWP silently strips punctuation from any query and replaces it with a space before storing/
+ * returning it (e.g. "who's the best?" comes back as "who's the best "), except standard
+ * apostrophes which it leaves untouched. Every caller that builds a query to submit to KWP, or
+ * joins/compares against KWP's stored `query` column, must apply the exact same transformation -
+ * kept as one JS form and one SQL form here so they can't drift apart.
+ */
+export declare const getNormalizeQuery: (column: string) => string;
+//#endregion

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

@@ -0,0 +1,10 @@
+//#region src/googleAds/keywordPlanner/normalizeQuery.d.ts
+/**
+ * KWP silently strips punctuation from any query and replaces it with a space before storing/
+ * returning it (e.g. "who's the best?" comes back as "who's the best "), except standard
+ * apostrophes which it leaves untouched. Every caller that builds a query to submit to KWP, or
+ * joins/compares against KWP's stored `query` column, must apply the exact same transformation -
+ * kept as one JS form and one SQL form here so they can't drift apart.
+ */
+export declare const getNormalizeQuery: (column: string) => string;
+//#endregion

package/dist/googleAds/keywordPlanner/normalizeQuery.mjs

@@ -0,0 +1,13 @@
+//#region src/googleAds/keywordPlanner/normalizeQuery.ts
+/**
+* KWP silently strips punctuation from any query and replaces it with a space before storing/
+* returning it (e.g. "who's the best?" comes back as "who's the best "), except standard
+* apostrophes which it leaves untouched. Every caller that builds a query to submit to KWP, or
+* joins/compares against KWP's stored `query` column, must apply the exact same transformation -
+* kept as one JS form and one SQL form here so they can't drift apart.
+*/
+const getNormalizeQuery = (column) => {
+	return `TRIM(REGEXP_REPLACE(REGEXP_REPLACE(${column}, r"[^a-zA-Z0-9']+", ' '), r' +', ' '))`;
+};
+//#endregion
+export { getNormalizeQuery };

package/dist/googleAds/keywordPlanner/server/buildRowId.cjs

@@ -0,0 +1,14 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_crypto_server_getSha256 = require("../../../crypto/server/getSha256.cjs");
+require("../../../crypto/server/index.cjs");
+//#region src/googleAds/keywordPlanner/server/buildRowId.ts
+/**
+* Joins its arguments with "::" and hashes the result - the shared id scheme for both the keyword
+* planner and keyword planner request tables. Exported for reuse by uploadKeywordPlannerCsv.ts,
+* which builds the same dedupe key for a manually uploaded CSV.
+*/
+const buildRowId = (...args) => {
+	return require_crypto_server_getSha256.getSha256(args.join("::"));
+};
+//#endregion
+exports.buildRowId = buildRowId;

package/dist/googleAds/keywordPlanner/server/buildRowId.d.cts

@@ -0,0 +1,8 @@
+//#region src/googleAds/keywordPlanner/server/buildRowId.d.ts
+/**
+ * Joins its arguments with "::" and hashes the result - the shared id scheme for both the keyword
+ * planner and keyword planner request tables. Exported for reuse by uploadKeywordPlannerCsv.ts,
+ * which builds the same dedupe key for a manually uploaded CSV.
+ */
+export declare const buildRowId: (...args: (string | number | null)[]) => string;
+//#endregion

package/dist/googleAds/keywordPlanner/server/buildRowId.d.mts

@@ -0,0 +1,8 @@
+//#region src/googleAds/keywordPlanner/server/buildRowId.d.ts
+/**
+ * Joins its arguments with "::" and hashes the result - the shared id scheme for both the keyword
+ * planner and keyword planner request tables. Exported for reuse by uploadKeywordPlannerCsv.ts,
+ * which builds the same dedupe key for a manually uploaded CSV.
+ */
+export declare const buildRowId: (...args: (string | number | null)[]) => string;
+//#endregion

package/dist/googleAds/keywordPlanner/server/buildRowId.mjs

@@ -0,0 +1,13 @@
+import { getSha256 } from "../../../crypto/server/getSha256.mjs";
+import "../../../crypto/server/index.mjs";
+//#region src/googleAds/keywordPlanner/server/buildRowId.ts
+/**
+* Joins its arguments with "::" and hashes the result - the shared id scheme for both the keyword
+* planner and keyword planner request tables. Exported for reuse by uploadKeywordPlannerCsv.ts,
+* which builds the same dedupe key for a manually uploaded CSV.
+*/
+const buildRowId = (...args) => {
+	return getSha256(args.join("::"));
+};
+//#endregion
+export { buildRowId };

package/dist/googleAds/keywordPlanner/server/index.cjs

@@ -1,6 +1,41 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_googleAds_keywordPlanner_server_googleAdsKeywordPlanner = require("./googleAdsKeywordPlanner.cjs");
-exports.defaultRequest = require_googleAds_keywordPlanner_server_googleAdsKeywordPlanner.defaultRequest;
-exports.network = require_googleAds_keywordPlanner_server_googleAdsKeywordPlanner.network;
-exports.requestSchema = require_googleAds_keywordPlanner_server_googleAdsKeywordPlanner.requestSchema;
-exports.responseSchema = require_googleAds_keywordPlanner_server_googleAdsKeywordPlanner.responseSchema;
+const require_googleAds_keywordPlanner_network = require("../network.cjs");
+const require_googleAds_keywordPlanner_bigquery = require("../bigquery.cjs");
+const require_googleAds_keywordPlanner_countries = require("../countries.cjs");
+const require_googleAds_keywordPlanner_customerId = require("../customerId.cjs");
+const require_googleAds_keywordPlanner_endpoint = require("../endpoint.cjs");
+const require_googleAds_keywordPlanner_getKwpTimeframe = require("../getKwpTimeframe.cjs");
+const require_googleAds_keywordPlanner_getLambdaFunctionName = require("../getLambdaFunctionName.cjs");
+const require_googleAds_keywordPlanner_language = require("../language.cjs");
+const require_googleAds_keywordPlanner_maxRequests = require("../maxRequests.cjs");
+const require_googleAds_keywordPlanner_normalizeQuery = require("../normalizeQuery.cjs");
+const require_googleAds_keywordPlanner_zodPHP = require("../zodPHP.cjs");
+const require_googleAds_keywordPlanner_zodPHPPayload = require("../zodPHPPayload.cjs");
+const require_googleAds_keywordPlanner_zodPHPResponse = require("../zodPHPResponse.cjs");
+require("../index.cjs");
+const require_googleAds_keywordPlanner_server_buildRowId = require("./buildRowId.cjs");
+exports.buildRowId = require_googleAds_keywordPlanner_server_buildRowId.buildRowId;
+exports.endpoint = require_googleAds_keywordPlanner_endpoint.endpoint;
+exports.getKwpTimeframe = require_googleAds_keywordPlanner_getKwpTimeframe.getKwpTimeframe;
+exports.getLambdaFunctionName = require_googleAds_keywordPlanner_getLambdaFunctionName.getLambdaFunctionName;
+exports.getNormalizeQuery = require_googleAds_keywordPlanner_normalizeQuery.getNormalizeQuery;
+exports.getRequestCountries = require_googleAds_keywordPlanner_countries.getRequestCountries;
+exports.getRequestCustomerId = require_googleAds_keywordPlanner_customerId.getRequestCustomerId;
+exports.getRequestLanguage = require_googleAds_keywordPlanner_language.getRequestLanguage;
+exports.getRequestNetwork = require_googleAds_keywordPlanner_network.getRequestNetwork;
+exports.getRequestNetworkValue = require_googleAds_keywordPlanner_network.getRequestNetworkValue;
+exports.keywordPlannerBQInsertRowSchema = require_googleAds_keywordPlanner_bigquery.keywordPlannerBQInsertRowSchema;
+exports.keywordPlannerBQReadRowSchema = require_googleAds_keywordPlanner_bigquery.keywordPlannerBQReadRowSchema;
+exports.keywordPlannerBQRowSchema = require_googleAds_keywordPlanner_bigquery.keywordPlannerBQRowSchema;
+exports.keywordPlannerDefinition = require_googleAds_keywordPlanner_bigquery.keywordPlannerDefinition;
+exports.keywordPlannerTableId = require_googleAds_keywordPlanner_bigquery.keywordPlannerTableId;
+exports.kwpMaxQueries = require_googleAds_keywordPlanner_maxRequests.kwpMaxQueries;
+exports.network = require_googleAds_keywordPlanner_network.network;
+exports.phpConfigSchema = require_googleAds_keywordPlanner_zodPHP.phpConfigSchema;
+exports.phpPayloadRequestDetailsSchema = require_googleAds_keywordPlanner_zodPHPPayload.phpPayloadRequestDetailsSchema;
+exports.phpPayloadSchema = require_googleAds_keywordPlanner_zodPHPPayload.phpPayloadSchema;
+exports.phpResponseMonthSchema = require_googleAds_keywordPlanner_zodPHPResponse.phpResponseMonthSchema;
+exports.phpResponseRowSchema = require_googleAds_keywordPlanner_zodPHPResponse.phpResponseRowSchema;
+exports.phpResponseSchema = require_googleAds_keywordPlanner_zodPHPResponse.phpResponseSchema;
+exports.phpRowDetailsSchema = require_googleAds_keywordPlanner_zodPHP.phpRowDetailsSchema;
+exports.requestNetworkNameSchema = require_googleAds_keywordPlanner_network.requestNetworkNameSchema;

package/dist/googleAds/keywordPlanner/server/index.d.cts

@@ -1,2 +1,16 @@
-import { Network, RequestSchemaType, ResponseSchemaType, defaultRequest, network, requestSchema, responseSchema } from "./googleAdsKeywordPlanner.cjs";
-export { Network, RequestSchemaType, ResponseSchemaType, defaultRequest, network, requestSchema, responseSchema };
+import { KeywordPlannerBQInsertRow, KeywordPlannerBQReadRow, KeywordPlannerBQRow, keywordPlannerBQInsertRowSchema, keywordPlannerBQReadRowSchema, keywordPlannerBQRowSchema, keywordPlannerDefinition, keywordPlannerTableId } from "../bigquery.cjs";
+import { getRequestCountries } from "../countries.cjs";
+import { getRequestCustomerId } from "../customerId.cjs";
+import { Endpoint, endpoint } from "../endpoint.cjs";
+import { PHPConfig, PHPRowDetails, phpConfigSchema, phpRowDetailsSchema } from "../zodPHP.cjs";
+import { KwpTimeframe, getKwpTimeframe } from "../getKwpTimeframe.cjs";
+import { getLambdaFunctionName } from "../getLambdaFunctionName.cjs";
+import { getRequestLanguage } from "../language.cjs";
+import { kwpMaxQueries } from "../maxRequests.cjs";
+import { Network, RequestNetworkName, getRequestNetwork, getRequestNetworkValue, network, requestNetworkNameSchema } from "../network.cjs";
+import { getNormalizeQuery } from "../normalizeQuery.cjs";
+import { PHPPayload, PHPPayloadRequestDetails, phpPayloadRequestDetailsSchema, phpPayloadSchema } from "../zodPHPPayload.cjs";
+import { PHPResponse, PHPResponseMonth, PHPResponseRow, phpResponseMonthSchema, phpResponseRowSchema, phpResponseSchema } from "../zodPHPResponse.cjs";
+import "../index.cjs";
+import { buildRowId } from "./buildRowId.cjs";
+export { Endpoint, KeywordPlannerBQInsertRow, KeywordPlannerBQReadRow, KeywordPlannerBQRow, KwpTimeframe, Network, PHPConfig, PHPPayload, PHPPayloadRequestDetails, PHPResponse, PHPResponseMonth, PHPResponseRow, PHPRowDetails, RequestNetworkName, buildRowId, endpoint, getKwpTimeframe, getLambdaFunctionName, getNormalizeQuery, getRequestCountries, getRequestCustomerId, getRequestLanguage, getRequestNetwork, getRequestNetworkValue, keywordPlannerBQInsertRowSchema, keywordPlannerBQReadRowSchema, keywordPlannerBQRowSchema, keywordPlannerDefinition, keywordPlannerTableId, kwpMaxQueries, network, phpConfigSchema, phpPayloadRequestDetailsSchema, phpPayloadSchema, phpResponseMonthSchema, phpResponseRowSchema, phpResponseSchema, phpRowDetailsSchema, requestNetworkNameSchema };

package/dist/googleAds/keywordPlanner/server/index.d.mts

@@ -1,2 +1,16 @@
-import { Network, RequestSchemaType, ResponseSchemaType, defaultRequest, network, requestSchema, responseSchema } from "./googleAdsKeywordPlanner.mjs";
-export { Network, RequestSchemaType, ResponseSchemaType, defaultRequest, network, requestSchema, responseSchema };
+import { KeywordPlannerBQInsertRow, KeywordPlannerBQReadRow, KeywordPlannerBQRow, keywordPlannerBQInsertRowSchema, keywordPlannerBQReadRowSchema, keywordPlannerBQRowSchema, keywordPlannerDefinition, keywordPlannerTableId } from "../bigquery.mjs";
+import { getRequestCountries } from "../countries.mjs";
+import { getRequestCustomerId } from "../customerId.mjs";
+import { Endpoint, endpoint } from "../endpoint.mjs";
+import { PHPConfig, PHPRowDetails, phpConfigSchema, phpRowDetailsSchema } from "../zodPHP.mjs";
+import { KwpTimeframe, getKwpTimeframe } from "../getKwpTimeframe.mjs";
+import { getLambdaFunctionName } from "../getLambdaFunctionName.mjs";
+import { getRequestLanguage } from "../language.mjs";
+import { kwpMaxQueries } from "../maxRequests.mjs";
+import { Network, RequestNetworkName, getRequestNetwork, getRequestNetworkValue, network, requestNetworkNameSchema } from "../network.mjs";
+import { getNormalizeQuery } from "../normalizeQuery.mjs";
+import { PHPPayload, PHPPayloadRequestDetails, phpPayloadRequestDetailsSchema, phpPayloadSchema } from "../zodPHPPayload.mjs";
+import { PHPResponse, PHPResponseMonth, PHPResponseRow, phpResponseMonthSchema, phpResponseRowSchema, phpResponseSchema } from "../zodPHPResponse.mjs";
+import "../index.mjs";
+import { buildRowId } from "./buildRowId.mjs";
+export { Endpoint, KeywordPlannerBQInsertRow, KeywordPlannerBQReadRow, KeywordPlannerBQRow, KwpTimeframe, Network, PHPConfig, PHPPayload, PHPPayloadRequestDetails, PHPResponse, PHPResponseMonth, PHPResponseRow, PHPRowDetails, RequestNetworkName, buildRowId, endpoint, getKwpTimeframe, getLambdaFunctionName, getNormalizeQuery, getRequestCountries, getRequestCustomerId, getRequestLanguage, getRequestNetwork, getRequestNetworkValue, keywordPlannerBQInsertRowSchema, keywordPlannerBQReadRowSchema, keywordPlannerBQRowSchema, keywordPlannerDefinition, keywordPlannerTableId, kwpMaxQueries, network, phpConfigSchema, phpPayloadRequestDetailsSchema, phpPayloadSchema, phpResponseMonthSchema, phpResponseRowSchema, phpResponseSchema, phpRowDetailsSchema, requestNetworkNameSchema };

package/dist/googleAds/keywordPlanner/server/index.mjs

@@ -1,2 +1,16 @@
-import { defaultRequest, network, requestSchema, responseSchema } from "./googleAdsKeywordPlanner.mjs";
-export { defaultRequest, network, requestSchema, responseSchema };
+import { getRequestNetwork, getRequestNetworkValue, network, requestNetworkNameSchema } from "../network.mjs";
+import { keywordPlannerBQInsertRowSchema, keywordPlannerBQReadRowSchema, keywordPlannerBQRowSchema, keywordPlannerDefinition, keywordPlannerTableId } from "../bigquery.mjs";
+import { getRequestCountries } from "../countries.mjs";
+import { getRequestCustomerId } from "../customerId.mjs";
+import { endpoint } from "../endpoint.mjs";
+import { getKwpTimeframe } from "../getKwpTimeframe.mjs";
+import { getLambdaFunctionName } from "../getLambdaFunctionName.mjs";
+import { getRequestLanguage } from "../language.mjs";
+import { kwpMaxQueries } from "../maxRequests.mjs";
+import { getNormalizeQuery } from "../normalizeQuery.mjs";
+import { phpConfigSchema, phpRowDetailsSchema } from "../zodPHP.mjs";
+import { phpPayloadRequestDetailsSchema, phpPayloadSchema } from "../zodPHPPayload.mjs";
+import { phpResponseMonthSchema, phpResponseRowSchema, phpResponseSchema } from "../zodPHPResponse.mjs";
+import "../index.mjs";
+import { buildRowId } from "./buildRowId.mjs";
+export { buildRowId, endpoint, getKwpTimeframe, getLambdaFunctionName, getNormalizeQuery, getRequestCountries, getRequestCustomerId, getRequestLanguage, getRequestNetwork, getRequestNetworkValue, keywordPlannerBQInsertRowSchema, keywordPlannerBQReadRowSchema, keywordPlannerBQRowSchema, keywordPlannerDefinition, keywordPlannerTableId, kwpMaxQueries, network, phpConfigSchema, phpPayloadRequestDetailsSchema, phpPayloadSchema, phpResponseMonthSchema, phpResponseRowSchema, phpResponseSchema, phpRowDetailsSchema, requestNetworkNameSchema };

package/dist/googleAds/keywordPlanner/zodPHP.cjs

@@ -0,0 +1,45 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_date_date = require("../../date/date.cjs");
+const require_googleAds_keywordPlanner_endpoint = require("./endpoint.cjs");
+let zod = require("zod");
+//#region src/googleAds/keywordPlanner/zodPHP.ts
+/**
+* PHP Single Row request details - row-specific fields only. Batch-level context (date/module/
+* topic/subtopic/competitorId/endpoint) lives once on `PHPConfig` instead of being repeated per
+* row in the echoed response.
+*/
+const phpRowDetailsSchema = zod.z.object({
+	id: zod.z.string(),
+	queries: zod.z.string().array().nullable(),
+	url: zod.z.string().nullable()
+});
+/**
+* PHP Payload-level config (top-level) - only what `KwpRequest` actually sends, plus `customerId`
+* which PHP adds itself and echoes back on the response (read in `uploadKeywordPlanner.ts`).
+*/
+const phpConfigSchema = zod.z.object({
+	endpoint: zod.z.enum(require_googleAds_keywordPlanner_endpoint.endpoint),
+	websiteId: zod.z.string(),
+	request: zod.z.object({
+		competitorId: zod.z.string().nullable().optional(),
+		date: zod.z.string().nullable().optional(),
+		module: zod.z.string().nullable().optional(),
+		topic: zod.z.string().nullable().optional(),
+		subtopic: zod.z.string().nullable().optional()
+	}),
+	api: zod.z.object({
+		customerId: zod.z.string().nullable().optional(),
+		countries: zod.z.number().array().nullable().optional(),
+		language: zod.z.number().nullable().optional(),
+		network: zod.z.number(),
+		historicalMetricsOptions: zod.z.object({
+			startYear: zod.z.number(),
+			startMonth: zod.z.enum(require_date_date.month),
+			endYear: zod.z.number(),
+			endMonth: zod.z.enum(require_date_date.month)
+		}).nullable()
+	})
+});
+//#endregion
+exports.phpConfigSchema = phpConfigSchema;
+exports.phpRowDetailsSchema = phpRowDetailsSchema;