@8ms/helpers 3.2.9 → 3.2.11

package/dist/adverity/server/getJobs.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_api__shared_get = require("../../api/_shared/get.cjs");
 const require_date__shared_calculation = require("../../date/_shared/calculation.cjs");
 const require_date__shared_format = require("../../date/_shared/format.cjs");
-const require_api__shared_get = require("../../api/_shared/get.cjs");
 //#region src/adverity/server/getJobs.ts
 /**
 * Fetch all the jobs that ran yesterday by default.

package/dist/adverity/server/getJobs.mjs

@@ -1,6 +1,6 @@
+import { get } from "../../api/_shared/get.mjs";
 import { getLuxonDate, getToday, getYesterday } from "../../date/_shared/calculation.mjs";
 import { getYmdString } from "../../date/_shared/format.mjs";
-import { get } from "../../api/_shared/get.mjs";
 //#region src/adverity/server/getJobs.ts
 /**
 * Fetch all the jobs that ran yesterday by default.

package/dist/api/_shared/index.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_api__shared_api = require("./api.cjs");
 const require_api__shared_ApiResponseClass = require("./ApiResponseClass.cjs");
-const require_api__shared_get = require("./get.cjs");
 const require_api__shared_deleteRequest = require("./deleteRequest.cjs");
 const require_api__shared_functions = require("./functions.cjs");
+const require_api__shared_get = require("./get.cjs");
 const require_api__shared_httpMethod = require("./httpMethod.cjs");
 const require_api__shared_post = require("./post.cjs");
 exports.ApiResponseClass = require_api__shared_ApiResponseClass.ApiResponseClass;

package/dist/api/_shared/index.mjs

@@ -1,8 +1,8 @@
 import { apiState, defaultResponse, unexpectedError } from "./api.mjs";
 import { ApiResponseClass } from "./ApiResponseClass.mjs";
-import { get } from "./get.mjs";
 import { deleteRequest } from "./deleteRequest.mjs";
 import { isCancelled, isError, isIdle, isPending, isSuccess, isValidationError } from "./functions.mjs";
+import { get } from "./get.mjs";
 import { httpMethod } from "./httpMethod.mjs";
 import { post } from "./post.mjs";
 export { ApiResponseClass, apiState, defaultResponse, deleteRequest, get, httpMethod, isCancelled, isError, isIdle, isPending, isSuccess, isValidationError, post, unexpectedError };

package/dist/api/client/index.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_api__shared_api = require("../_shared/api.cjs");
 const require_api__shared_ApiResponseClass = require("../_shared/ApiResponseClass.cjs");
-const require_api__shared_get = require("../_shared/get.cjs");
 const require_api__shared_deleteRequest = require("../_shared/deleteRequest.cjs");
 const require_api__shared_functions = require("../_shared/functions.cjs");
+const require_api__shared_get = require("../_shared/get.cjs");
 const require_api__shared_httpMethod = require("../_shared/httpMethod.cjs");
 const require_api__shared_post = require("../_shared/post.cjs");
 require("../_shared/index.cjs");

package/dist/api/client/index.mjs

@@ -1,8 +1,8 @@
 import { apiState, defaultResponse, unexpectedError } from "../_shared/api.mjs";
 import { ApiResponseClass } from "../_shared/ApiResponseClass.mjs";
-import { get } from "../_shared/get.mjs";
 import { deleteRequest } from "../_shared/deleteRequest.mjs";
 import { isCancelled, isError, isIdle, isPending, isSuccess, isValidationError } from "../_shared/functions.mjs";
+import { get } from "../_shared/get.mjs";
 import { httpMethod } from "../_shared/httpMethod.mjs";
 import { post } from "../_shared/post.mjs";
 import "../_shared/index.mjs";

package/dist/api/server/index.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_api__shared_api = require("../_shared/api.cjs");
 const require_api__shared_ApiResponseClass = require("../_shared/ApiResponseClass.cjs");
-const require_api__shared_get = require("../_shared/get.cjs");
 const require_api__shared_deleteRequest = require("../_shared/deleteRequest.cjs");
 const require_api__shared_functions = require("../_shared/functions.cjs");
+const require_api__shared_get = require("../_shared/get.cjs");
 const require_api__shared_httpMethod = require("../_shared/httpMethod.cjs");
 const require_api__shared_post = require("../_shared/post.cjs");
 require("../_shared/index.cjs");

package/dist/api/server/index.mjs

@@ -1,8 +1,8 @@
 import { apiState, defaultResponse, unexpectedError } from "../_shared/api.mjs";
 import { ApiResponseClass } from "../_shared/ApiResponseClass.mjs";
-import { get } from "../_shared/get.mjs";
 import { deleteRequest } from "../_shared/deleteRequest.mjs";
 import { isCancelled, isError, isIdle, isPending, isSuccess, isValidationError } from "../_shared/functions.mjs";
+import { get } from "../_shared/get.mjs";
 import { httpMethod } from "../_shared/httpMethod.mjs";
 import { post } from "../_shared/post.mjs";
 import "../_shared/index.mjs";

package/dist/aws/s3/server/AwsS3.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
 const require__class__shared_BaseNamespace = require("../../../_class/_shared/BaseNamespace.cjs");
+const require_aws_server_isResponse200 = require("../../server/isResponse200.cjs");
 const require_date__shared_calculation = require("../../../date/_shared/calculation.cjs");
 const require_date__shared_format = require("../../../date/_shared/format.cjs");
-const require_aws_server_isResponse200 = require("../../server/isResponse200.cjs");
 const require_date__shared_date = require("../../../date/_shared/date.cjs");
 require("../../../date/_shared/index.cjs");
 const require_stream_server_json_read = require("../../../stream/server/json/read.cjs");

package/dist/aws/s3/server/AwsS3.mjs

@@ -1,7 +1,7 @@
 import { BaseNamespace } from "../../../_class/_shared/BaseNamespace.mjs";
+import { isResponse200 } from "../../server/isResponse200.mjs";
 import { getToday } from "../../../date/_shared/calculation.mjs";
 import { getYmdHisString } from "../../../date/_shared/format.mjs";
-import { isResponse200 } from "../../server/isResponse200.mjs";
 import { defaultDateTime } from "../../../date/_shared/date.mjs";
 import "../../../date/_shared/index.mjs";
 import { readJsonGzipStream, readJsonStream } from "../../../stream/server/json/read.mjs";

package/dist/googleCloud/bigquery/_shared/field/bqFloat.cjs

@@ -3,6 +3,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 /**
 * FLOAT64 → plain JS number
 */
-const BQFloat = require("zod").z.number();
+const zBQFloat = require("zod").z.number().describe("bq:float");
 //#endregion
-exports.BQFloat = BQFloat;
+exports.zBQFloat = zBQFloat;

package/dist/googleCloud/bigquery/_shared/field/bqFloat.d.cts

@@ -3,6 +3,5 @@ import { z } from "zod";
 /**
  * FLOAT64 → plain JS number
  */
-export declare const BQFloat: z.ZodNumber;
-export type BQFloat = z.infer<typeof BQFloat>;
+export declare const zBQFloat: z.ZodNumber;
 //#endregion

package/dist/googleCloud/bigquery/_shared/field/bqFloat.d.mts

@@ -3,6 +3,5 @@ import { z } from "zod";
 /**
  * FLOAT64 → plain JS number
  */
-export declare const BQFloat: z.ZodNumber;
-export type BQFloat = z.infer<typeof BQFloat>;
+export declare const zBQFloat: z.ZodNumber;
 //#endregion

package/dist/googleCloud/bigquery/_shared/field/bqFloat.mjs

@@ -3,6 +3,6 @@ import { z } from "zod";
 /**
 * FLOAT64 → plain JS number
 */
-const BQFloat = z.number();
+const zBQFloat = z.number().describe("bq:float");
 //#endregion
-export { BQFloat };
+export { zBQFloat };

package/dist/googleCloud/bigquery/_shared/field/{bqNullableString.cjs → bqStringNullable.cjs}

@@ -1,11 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let zod = require("zod");
-//#region src/googleCloud/bigquery/_shared/field/bqNullableString.ts
+//#region src/googleCloud/bigquery/_shared/field/bqStringNullable.ts
 /**
 * BigQuery's Node client returns small INT64 values as a native `number` and only falls back to
 * `string` once precision would be lost - so an INT64/NUMERIC column stored as an id (e.g.
 * google_ads_id) can't be trusted to always arrive as a string. Coerce defensively instead.
 */
-const BQNullableStringCoerce = zod.z.preprocess((value) => null === value || void 0 === value ? null : String(value), zod.z.string().nullable());
+const BQStringNullable = zod.z.preprocess((value) => null === value || void 0 === value ? null : String(value), zod.z.string().nullable());
 //#endregion
-exports.BQNullableStringCoerce = BQNullableStringCoerce;
+exports.BQStringNullable = BQStringNullable;

package/dist/googleCloud/bigquery/_shared/field/{bqNullableString.d.cts → bqStringNullable.d.cts}

@@ -1,9 +1,9 @@
 import { z } from "zod";
-//#region src/googleCloud/bigquery/_shared/field/bqNullableString.d.ts
+//#region src/googleCloud/bigquery/_shared/field/bqStringNullable.d.ts
 /**
  * BigQuery's Node client returns small INT64 values as a native `number` and only falls back to
  * `string` once precision would be lost - so an INT64/NUMERIC column stored as an id (e.g.
  * google_ads_id) can't be trusted to always arrive as a string. Coerce defensively instead.
  */
-export declare const BQNullableStringCoerce: z.ZodPreprocess<z.ZodNullable<z.ZodString>, unknown>;
+export declare const BQStringNullable: z.ZodPreprocess<z.ZodNullable<z.ZodString>, unknown>;
 //#endregion

package/dist/googleCloud/bigquery/_shared/field/{bqNullableString.d.mts → bqStringNullable.d.mts}

@@ -1,9 +1,9 @@
 import { z } from "zod";
-//#region src/googleCloud/bigquery/_shared/field/bqNullableString.d.ts
+//#region src/googleCloud/bigquery/_shared/field/bqStringNullable.d.ts
 /**
  * BigQuery's Node client returns small INT64 values as a native `number` and only falls back to
  * `string` once precision would be lost - so an INT64/NUMERIC column stored as an id (e.g.
  * google_ads_id) can't be trusted to always arrive as a string. Coerce defensively instead.
  */
-export declare const BQNullableStringCoerce: z.ZodPreprocess<z.ZodNullable<z.ZodString>, unknown>;
+export declare const BQStringNullable: z.ZodPreprocess<z.ZodNullable<z.ZodString>, unknown>;
 //#endregion

package/dist/googleCloud/bigquery/_shared/field/{bqNullableString.mjs → bqStringNullable.mjs}

@@ -1,10 +1,10 @@
 import { z } from "zod";
-//#region src/googleCloud/bigquery/_shared/field/bqNullableString.ts
+//#region src/googleCloud/bigquery/_shared/field/bqStringNullable.ts
 /**
 * BigQuery's Node client returns small INT64 values as a native `number` and only falls back to
 * `string` once precision would be lost - so an INT64/NUMERIC column stored as an id (e.g.
 * google_ads_id) can't be trusted to always arrive as a string. Coerce defensively instead.
 */
-const BQNullableStringCoerce = z.preprocess((value) => null === value || void 0 === value ? null : String(value), z.string().nullable());
+const BQStringNullable = z.preprocess((value) => null === value || void 0 === value ? null : String(value), z.string().nullable());
 //#endregion
-export { BQNullableStringCoerce };
+export { BQStringNullable };

package/dist/googleCloud/bigquery/_shared/index.cjs

@@ -26,7 +26,6 @@ exports.BQFieldMode = require_googleCloud_bigquery__shared_field_bqFieldMode.BQF
 exports.BQFieldModeSchema = require_googleCloud_bigquery__shared_field_bqFieldMode.BQFieldModeSchema;
 exports.BQFieldType = require_googleCloud_bigquery__shared_field_bqFieldType.BQFieldType;
 exports.BQFieldTypeSchema = require_googleCloud_bigquery__shared_field_bqFieldType.BQFieldTypeSchema;
-exports.BQFloat = require_googleCloud_bigquery__shared_field_bqFloat.BQFloat;
 exports.BQInt64 = require_googleCloud_bigquery__shared_field_bqInt64.BQInt64;
 exports.BQNumeric = require_googleCloud_bigquery__shared_field_bqNumeric.BQNumeric;
 exports.BQString = require_googleCloud_bigquery__shared_field_bqString.BQString;
@@ -42,6 +41,7 @@ exports.googleCloudBQRow = require_googleCloud_bigquery__shared_lookup_googleClo
 exports.languageBQRow = require_googleCloud_bigquery__shared_lookup_language.languageBQRow;
 exports.partitionType = require_googleCloud_bigquery__shared_partitionType.partitionType;
 exports.zBQBytes = require_googleCloud_bigquery__shared_field_bqBytes.zBQBytes;
+exports.zBQFloat = require_googleCloud_bigquery__shared_field_bqFloat.zBQFloat;
 exports.zBQInt = require_googleCloud_bigquery__shared_field_bqInt.zBQInt;
 exports.zBQInt64 = require_googleCloud_bigquery__shared_field_bqInt64.zBQInt64;
 exports.zBQNumeric = require_googleCloud_bigquery__shared_field_bqNumeric.zBQNumeric;

package/dist/googleCloud/bigquery/_shared/index.d.cts

@@ -4,7 +4,7 @@ import { BQDate, decodeBQDate, encodeBQDate, zLuxonDate } from "./field/bqDate.c
 import { BQDateTime, BQDatetime, decodeBQDateTime, encodeBQDateTime, zLuxonDateTime } from "./field/bqDateTime.cjs";
 import { BQFieldMode, BQFieldModeSchema } from "./field/bqFieldMode.cjs";
 import { BQFieldType, BQFieldTypeSchema } from "./field/bqFieldType.cjs";
-import { BQFloat } from "./field/bqFloat.cjs";
+import { zBQFloat } from "./field/bqFloat.cjs";
 import { zBQInt } from "./field/bqInt.cjs";
 import { BQInt64, zBQInt64 } from "./field/bqInt64.cjs";
 import { BQNumeric, zBQNumeric } from "./field/bqNumeric.cjs";
@@ -18,4 +18,4 @@ import { LanguageBQRow, languageBQRow } from "./lookup/language.cjs";
 import { PartitionType, partitionType } from "./partitionType.cjs";
 import { BQField, zodToBQSchema } from "./zodToBQDefinition.cjs";
 import { BigqueryLoadFormat, Dataset, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, QueryInput, Table, TableDefinition } from "./types.cjs";
-export { BQBool, BQBytes, BQDate, BQDateTime, BQDatetime, BQField, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQFloat, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, BigqueryLoadFormat, CountryBQRow, Dataset, GoogleAdsAccountBQRow, GoogleCloudBQRow, LanguageBQRow, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, PartitionType, QueryInput, Table, TableDefinition, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };
+export { BQBool, BQBytes, BQDate, BQDateTime, BQDatetime, BQField, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, BigqueryLoadFormat, CountryBQRow, Dataset, GoogleAdsAccountBQRow, GoogleCloudBQRow, LanguageBQRow, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, PartitionType, QueryInput, Table, TableDefinition, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQFloat, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };

package/dist/googleCloud/bigquery/_shared/index.d.mts

@@ -4,7 +4,7 @@ import { BQDate, decodeBQDate, encodeBQDate, zLuxonDate } from "./field/bqDate.m
 import { BQDateTime, BQDatetime, decodeBQDateTime, encodeBQDateTime, zLuxonDateTime } from "./field/bqDateTime.mjs";
 import { BQFieldMode, BQFieldModeSchema } from "./field/bqFieldMode.mjs";
 import { BQFieldType, BQFieldTypeSchema } from "./field/bqFieldType.mjs";
-import { BQFloat } from "./field/bqFloat.mjs";
+import { zBQFloat } from "./field/bqFloat.mjs";
 import { zBQInt } from "./field/bqInt.mjs";
 import { BQInt64, zBQInt64 } from "./field/bqInt64.mjs";
 import { BQNumeric, zBQNumeric } from "./field/bqNumeric.mjs";
@@ -18,4 +18,4 @@ import { LanguageBQRow, languageBQRow } from "./lookup/language.mjs";
 import { PartitionType, partitionType } from "./partitionType.mjs";
 import { BQField, zodToBQSchema } from "./zodToBQDefinition.mjs";
 import { BigqueryLoadFormat, Dataset, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, QueryInput, Table, TableDefinition } from "./types.mjs";
-export { BQBool, BQBytes, BQDate, BQDateTime, BQDatetime, BQField, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQFloat, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, BigqueryLoadFormat, CountryBQRow, Dataset, GoogleAdsAccountBQRow, GoogleCloudBQRow, LanguageBQRow, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, PartitionType, QueryInput, Table, TableDefinition, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };
+export { BQBool, BQBytes, BQDate, BQDateTime, BQDatetime, BQField, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, BigqueryLoadFormat, CountryBQRow, Dataset, GoogleAdsAccountBQRow, GoogleCloudBQRow, LanguageBQRow, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, PartitionType, QueryInput, Table, TableDefinition, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQFloat, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };

package/dist/googleCloud/bigquery/_shared/index.mjs

@@ -4,7 +4,7 @@ import { BQDate, decodeBQDate, encodeBQDate, zLuxonDate } from "./field/bqDate.m
 import { BQDateTime, decodeBQDateTime, encodeBQDateTime, zLuxonDateTime } from "./field/bqDateTime.mjs";
 import { BQFieldMode, BQFieldModeSchema } from "./field/bqFieldMode.mjs";
 import { BQFieldType, BQFieldTypeSchema } from "./field/bqFieldType.mjs";
-import { BQFloat } from "./field/bqFloat.mjs";
+import { zBQFloat } from "./field/bqFloat.mjs";
 import { zBQInt } from "./field/bqInt.mjs";
 import { BQInt64, zBQInt64 } from "./field/bqInt64.mjs";
 import { BQNumeric, zBQNumeric } from "./field/bqNumeric.mjs";
@@ -17,4 +17,4 @@ import { googleCloudBQRow } from "./lookup/googleCloud.mjs";
 import { languageBQRow } from "./lookup/language.mjs";
 import { partitionType } from "./partitionType.mjs";
 import { zodToBQSchema } from "./zodToBQDefinition.mjs";
-export { BQBool, BQBytes, BQDate, BQDateTime, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQFloat, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };
+export { BQBool, BQBytes, BQDate, BQDateTime, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQFloat, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };

package/dist/googleCloud/bigquery/_shared/lookup/country.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_googleCloud_bigquery__shared_field_bqDateTime = require("../field/bqDateTime.cjs");
-const require_googleCloud_bigquery__shared_field_bqNullableString = require("../field/bqNullableString.cjs");
+const require_googleCloud_bigquery__shared_field_bqStringNullable = require("../field/bqStringNullable.cjs");
 let zod = require("zod");
 //#region src/googleCloud/bigquery/_shared/lookup/country.ts
 /**
@@ -12,8 +12,8 @@ const countryBQRow = zod.z.object({
 	country: zod.z.string(),
 	alpha2: zod.z.string().nullable(),
 	alpha3: zod.z.string().nullable(),
-	google_ads_id: require_googleCloud_bigquery__shared_field_bqNullableString.BQNullableStringCoerce,
-	meta_id: require_googleCloud_bigquery__shared_field_bqNullableString.BQNullableStringCoerce,
+	google_ads_id: require_googleCloud_bigquery__shared_field_bqStringNullable.BQStringNullable,
+	meta_id: require_googleCloud_bigquery__shared_field_bqStringNullable.BQStringNullable,
 	inserted_at: require_googleCloud_bigquery__shared_field_bqDateTime.BQDateTime.transform(require_googleCloud_bigquery__shared_field_bqDateTime.decodeBQDateTime)
 });
 //#endregion

package/dist/googleCloud/bigquery/_shared/lookup/country.mjs

@@ -1,5 +1,5 @@
 import { BQDateTime, decodeBQDateTime } from "../field/bqDateTime.mjs";
-import { BQNullableStringCoerce } from "../field/bqNullableString.mjs";
+import { BQStringNullable } from "../field/bqStringNullable.mjs";
 import { z } from "zod";
 //#region src/googleCloud/bigquery/_shared/lookup/country.ts
 /**
@@ -11,8 +11,8 @@ const countryBQRow = z.object({
 	country: z.string(),
 	alpha2: z.string().nullable(),
 	alpha3: z.string().nullable(),
-	google_ads_id: BQNullableStringCoerce,
-	meta_id: BQNullableStringCoerce,
+	google_ads_id: BQStringNullable,
+	meta_id: BQStringNullable,
 	inserted_at: BQDateTime.transform(decodeBQDateTime)
 });
 //#endregion

package/dist/googleCloud/bigquery/_shared/lookup/language.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_googleCloud_bigquery__shared_field_bqDateTime = require("../field/bqDateTime.cjs");
-const require_googleCloud_bigquery__shared_field_bqNullableString = require("../field/bqNullableString.cjs");
+const require_googleCloud_bigquery__shared_field_bqStringNullable = require("../field/bqStringNullable.cjs");
 let zod = require("zod");
 //#region src/googleCloud/bigquery/_shared/lookup/language.ts
 /**
@@ -11,8 +11,8 @@ let zod = require("zod");
 const languageBQRow = zod.z.object({
 	language: zod.z.string(),
 	iso2: zod.z.string().nullable(),
-	google_ads_id: require_googleCloud_bigquery__shared_field_bqNullableString.BQNullableStringCoerce,
-	meta_id: require_googleCloud_bigquery__shared_field_bqNullableString.BQNullableStringCoerce,
+	google_ads_id: require_googleCloud_bigquery__shared_field_bqStringNullable.BQStringNullable,
+	meta_id: require_googleCloud_bigquery__shared_field_bqStringNullable.BQStringNullable,
 	inserted_at: require_googleCloud_bigquery__shared_field_bqDateTime.BQDateTime.transform(require_googleCloud_bigquery__shared_field_bqDateTime.decodeBQDateTime)
 });
 //#endregion

package/dist/googleCloud/bigquery/_shared/lookup/language.mjs

@@ -1,5 +1,5 @@
 import { BQDateTime, decodeBQDateTime } from "../field/bqDateTime.mjs";
-import { BQNullableStringCoerce } from "../field/bqNullableString.mjs";
+import { BQStringNullable } from "../field/bqStringNullable.mjs";
 import { z } from "zod";
 //#region src/googleCloud/bigquery/_shared/lookup/language.ts
 /**
@@ -10,8 +10,8 @@ import { z } from "zod";
 const languageBQRow = z.object({
 	language: z.string(),
 	iso2: z.string().nullable(),
-	google_ads_id: BQNullableStringCoerce,
-	meta_id: BQNullableStringCoerce,
+	google_ads_id: BQStringNullable,
+	meta_id: BQStringNullable,
 	inserted_at: BQDateTime.transform(decodeBQDateTime)
 });
 //#endregion

package/dist/googleCloud/bigquery/_shared/types.d.cts

@@ -8,7 +8,7 @@ import { QueryOptions } from "@google-cloud/bigquery";
 /** The only load formats this library can actually serialise/pass through for loadTable/loadStreamTable. */
 export type BigqueryLoadFormat = typeof fileType.CSV | typeof fileType.JSON_NEWLINE | typeof fileType.PARQUET;
 export type TableDefinition = {
-  projectId?: string;
+  projectId: string;
   datasetId: string;
   tableId: string;
   options?: {
@@ -45,18 +45,17 @@ export type LoadData<TData> = {
     sourceFormat?: BigqueryLoadFormat;
     region?: string;
   };
-  table: {
-    datasetId: string;
-    tableId?: string;
-    region?: string;
-    definition?: TableDefinition;
+  table: TableDefinition & {
+    tableId: string;
   };
+  autodetect?: boolean;
+  schema?: BQField[];
 };
 export type LoadTableProps = LoadData<any[]>;
 export type LoadStreamTableProps = LoadData<RowSource<any>>;
 export type MergeTableProps = Omit<LoadData<any[]>, "table"> & {
   table: LoadData<any[]>["table"] & {
-    mergeKey: string;
+    mergeColumns: string[];
     updateColumns: string[];
   };
 };

package/dist/googleCloud/bigquery/_shared/types.d.mts

@@ -8,7 +8,7 @@ import { QueryOptions } from "@google-cloud/bigquery";
 /** The only load formats this library can actually serialise/pass through for loadTable/loadStreamTable. */
 export type BigqueryLoadFormat = typeof fileType.CSV | typeof fileType.JSON_NEWLINE | typeof fileType.PARQUET;
 export type TableDefinition = {
-  projectId?: string;
+  projectId: string;
   datasetId: string;
   tableId: string;
   options?: {
@@ -45,18 +45,17 @@ export type LoadData<TData> = {
     sourceFormat?: BigqueryLoadFormat;
     region?: string;
   };
-  table: {
-    datasetId: string;
-    tableId?: string;
-    region?: string;
-    definition?: TableDefinition;
+  table: TableDefinition & {
+    tableId: string;
   };
+  autodetect?: boolean;
+  schema?: BQField[];
 };
 export type LoadTableProps = LoadData<any[]>;
 export type LoadStreamTableProps = LoadData<RowSource<any>>;
 export type MergeTableProps = Omit<LoadData<any[]>, "table"> & {
   table: LoadData<any[]>["table"] & {
-    mergeKey: string;
+    mergeColumns: string[];
     updateColumns: string[];
   };
 };

package/dist/googleCloud/bigquery/_shared/zodToBQDefinition.cjs

@@ -5,14 +5,15 @@ const getBqType = (schema) => {
 	if ("bq:date" === schema.description) return "DATE";
 	if ("bq:datetime" === schema.description) return "DATETIME";
 	if ("bq:int" === schema.description) return "INTEGER";
+	if ("bq:float" === schema.description) return "FLOAT";
 	if ("bq:numeric" === schema.description) return "NUMERIC";
 	if ("bq:int64" === schema.description) return "INTEGER";
 	if ("bq:time" === schema.description) return "TIME";
 	if ("bq:bytes" === schema.description) return "BYTES";
 	if (schema instanceof zod.z.ZodString || schema instanceof zod.z.ZodEnum) return "STRING";
-	if (schema instanceof zod.z.ZodNumber) return "FLOAT";
 	if (schema instanceof zod.z.ZodBoolean) return "BOOLEAN";
 	if (schema instanceof zod.z.ZodDate) return "TIMESTAMP";
+	if (schema instanceof zod.z.ZodNumber) throw new Error("A BigQuery number field must be tagged zBQInt or zBQFloat - plain z.number() is ambiguous between INTEGER and FLOAT.");
 	throw new Error(`Cannot infer a BigQuery type for zod schema "${schema.constructor.name}".`);
 };
 /**
@@ -37,7 +38,7 @@ const buildBQField = (name, fieldSchema) => {
 		name,
 		type: "RECORD",
 		mode,
-		fields: zodToBQSchema(inner)
+		subFields: zodToBQSchema(inner)
 	};
 	return {
 		name,

package/dist/googleCloud/bigquery/_shared/zodToBQDefinition.d.cts

@@ -7,7 +7,7 @@ export type BQField = {
   type: BQFieldType;
   mode: BQFieldMode;
   defaultValueExpression?: string;
-  fields?: BQField[];
+  subFields?: BQField[];
 };
 /**
  * Derives a BigQuery table schema directly from a zod object's shape - the column name and type

package/dist/googleCloud/bigquery/_shared/zodToBQDefinition.d.mts

@@ -7,7 +7,7 @@ export type BQField = {
   type: BQFieldType;
   mode: BQFieldMode;
   defaultValueExpression?: string;
-  fields?: BQField[];
+  subFields?: BQField[];
 };
 /**
  * Derives a BigQuery table schema directly from a zod object's shape - the column name and type

package/dist/googleCloud/bigquery/_shared/zodToBQDefinition.mjs

@@ -4,14 +4,15 @@ const getBqType = (schema) => {
 	if ("bq:date" === schema.description) return "DATE";
 	if ("bq:datetime" === schema.description) return "DATETIME";
 	if ("bq:int" === schema.description) return "INTEGER";
+	if ("bq:float" === schema.description) return "FLOAT";
 	if ("bq:numeric" === schema.description) return "NUMERIC";
 	if ("bq:int64" === schema.description) return "INTEGER";
 	if ("bq:time" === schema.description) return "TIME";
 	if ("bq:bytes" === schema.description) return "BYTES";
 	if (schema instanceof z.ZodString || schema instanceof z.ZodEnum) return "STRING";
-	if (schema instanceof z.ZodNumber) return "FLOAT";
 	if (schema instanceof z.ZodBoolean) return "BOOLEAN";
 	if (schema instanceof z.ZodDate) return "TIMESTAMP";
+	if (schema instanceof z.ZodNumber) throw new Error("A BigQuery number field must be tagged zBQInt or zBQFloat - plain z.number() is ambiguous between INTEGER and FLOAT.");
 	throw new Error(`Cannot infer a BigQuery type for zod schema "${schema.constructor.name}".`);
 };
 /**
@@ -36,7 +37,7 @@ const buildBQField = (name, fieldSchema) => {
 		name,
 		type: "RECORD",
 		mode,
-		fields: zodToBQSchema(inner)
+		subFields: zodToBQSchema(inner)
 	};
 	return {
 		name,

package/dist/googleCloud/bigquery/client/index.cjs

@@ -27,7 +27,6 @@ exports.BQFieldMode = require_googleCloud_bigquery__shared_field_bqFieldMode.BQF
 exports.BQFieldModeSchema = require_googleCloud_bigquery__shared_field_bqFieldMode.BQFieldModeSchema;
 exports.BQFieldType = require_googleCloud_bigquery__shared_field_bqFieldType.BQFieldType;
 exports.BQFieldTypeSchema = require_googleCloud_bigquery__shared_field_bqFieldType.BQFieldTypeSchema;
-exports.BQFloat = require_googleCloud_bigquery__shared_field_bqFloat.BQFloat;
 exports.BQInt64 = require_googleCloud_bigquery__shared_field_bqInt64.BQInt64;
 exports.BQNumeric = require_googleCloud_bigquery__shared_field_bqNumeric.BQNumeric;
 exports.BQString = require_googleCloud_bigquery__shared_field_bqString.BQString;
@@ -43,6 +42,7 @@ exports.googleCloudBQRow = require_googleCloud_bigquery__shared_lookup_googleClo
 exports.languageBQRow = require_googleCloud_bigquery__shared_lookup_language.languageBQRow;
 exports.partitionType = require_googleCloud_bigquery__shared_partitionType.partitionType;
 exports.zBQBytes = require_googleCloud_bigquery__shared_field_bqBytes.zBQBytes;
+exports.zBQFloat = require_googleCloud_bigquery__shared_field_bqFloat.zBQFloat;
 exports.zBQInt = require_googleCloud_bigquery__shared_field_bqInt.zBQInt;
 exports.zBQInt64 = require_googleCloud_bigquery__shared_field_bqInt64.zBQInt64;
 exports.zBQNumeric = require_googleCloud_bigquery__shared_field_bqNumeric.zBQNumeric;

package/dist/googleCloud/bigquery/client/index.d.cts

@@ -4,7 +4,7 @@ import { BQDate, decodeBQDate, encodeBQDate, zLuxonDate } from "../_shared/field
 import { BQDateTime, BQDatetime, decodeBQDateTime, encodeBQDateTime, zLuxonDateTime } from "../_shared/field/bqDateTime.cjs";
 import { BQFieldMode, BQFieldModeSchema } from "../_shared/field/bqFieldMode.cjs";
 import { BQFieldType, BQFieldTypeSchema } from "../_shared/field/bqFieldType.cjs";
-import { BQFloat } from "../_shared/field/bqFloat.cjs";
+import { zBQFloat } from "../_shared/field/bqFloat.cjs";
 import { zBQInt } from "../_shared/field/bqInt.cjs";
 import { BQInt64, zBQInt64 } from "../_shared/field/bqInt64.cjs";
 import { BQNumeric, zBQNumeric } from "../_shared/field/bqNumeric.cjs";
@@ -19,4 +19,4 @@ import { PartitionType, partitionType } from "../_shared/partitionType.cjs";
 import { BQField, zodToBQSchema } from "../_shared/zodToBQDefinition.cjs";
 import { BigqueryLoadFormat, Dataset, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, QueryInput, Table, TableDefinition } from "../_shared/types.cjs";
 import "../_shared/index.cjs";
-export { BQBool, BQBytes, BQDate, BQDateTime, BQDatetime, BQField, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQFloat, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, BigqueryLoadFormat, CountryBQRow, Dataset, GoogleAdsAccountBQRow, GoogleCloudBQRow, LanguageBQRow, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, PartitionType, QueryInput, Table, TableDefinition, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };
+export { BQBool, BQBytes, BQDate, BQDateTime, BQDatetime, BQField, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, BigqueryLoadFormat, CountryBQRow, Dataset, GoogleAdsAccountBQRow, GoogleCloudBQRow, LanguageBQRow, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, PartitionType, QueryInput, Table, TableDefinition, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQFloat, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };

package/dist/googleCloud/bigquery/client/index.d.mts

@@ -4,7 +4,7 @@ import { BQDate, decodeBQDate, encodeBQDate, zLuxonDate } from "../_shared/field
 import { BQDateTime, BQDatetime, decodeBQDateTime, encodeBQDateTime, zLuxonDateTime } from "../_shared/field/bqDateTime.mjs";
 import { BQFieldMode, BQFieldModeSchema } from "../_shared/field/bqFieldMode.mjs";
 import { BQFieldType, BQFieldTypeSchema } from "../_shared/field/bqFieldType.mjs";
-import { BQFloat } from "../_shared/field/bqFloat.mjs";
+import { zBQFloat } from "../_shared/field/bqFloat.mjs";
 import { zBQInt } from "../_shared/field/bqInt.mjs";
 import { BQInt64, zBQInt64 } from "../_shared/field/bqInt64.mjs";
 import { BQNumeric, zBQNumeric } from "../_shared/field/bqNumeric.mjs";
@@ -19,4 +19,4 @@ import { PartitionType, partitionType } from "../_shared/partitionType.mjs";
 import { BQField, zodToBQSchema } from "../_shared/zodToBQDefinition.mjs";
 import { BigqueryLoadFormat, Dataset, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, QueryInput, Table, TableDefinition } from "../_shared/types.mjs";
 import "../_shared/index.mjs";
-export { BQBool, BQBytes, BQDate, BQDateTime, BQDatetime, BQField, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQFloat, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, BigqueryLoadFormat, CountryBQRow, Dataset, GoogleAdsAccountBQRow, GoogleCloudBQRow, LanguageBQRow, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, PartitionType, QueryInput, Table, TableDefinition, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };
+export { BQBool, BQBytes, BQDate, BQDateTime, BQDatetime, BQField, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, BigqueryLoadFormat, CountryBQRow, Dataset, GoogleAdsAccountBQRow, GoogleCloudBQRow, LanguageBQRow, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, PartitionType, QueryInput, Table, TableDefinition, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQFloat, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };

package/dist/googleCloud/bigquery/client/index.mjs

@@ -4,7 +4,7 @@ import { BQDate, decodeBQDate, encodeBQDate, zLuxonDate } from "../_shared/field
 import { BQDateTime, decodeBQDateTime, encodeBQDateTime, zLuxonDateTime } from "../_shared/field/bqDateTime.mjs";
 import { BQFieldMode, BQFieldModeSchema } from "../_shared/field/bqFieldMode.mjs";
 import { BQFieldType, BQFieldTypeSchema } from "../_shared/field/bqFieldType.mjs";
-import { BQFloat } from "../_shared/field/bqFloat.mjs";
+import { zBQFloat } from "../_shared/field/bqFloat.mjs";
 import { zBQInt } from "../_shared/field/bqInt.mjs";
 import { BQInt64, zBQInt64 } from "../_shared/field/bqInt64.mjs";
 import { BQNumeric, zBQNumeric } from "../_shared/field/bqNumeric.mjs";
@@ -18,4 +18,4 @@ import { languageBQRow } from "../_shared/lookup/language.mjs";
 import { partitionType } from "../_shared/partitionType.mjs";
 import { zodToBQSchema } from "../_shared/zodToBQDefinition.mjs";
 import "../_shared/index.mjs";
-export { BQBool, BQBytes, BQDate, BQDateTime, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQFloat, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };
+export { BQBool, BQBytes, BQDate, BQDateTime, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQFloat, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };

package/dist/googleCloud/bigquery/server/GoogleCloudBigquery.cjs

@@ -98,7 +98,15 @@ var GoogleCloudBigquery = class extends require__class__shared_BaseNamespace.Bas
 	* Make a request to the database and return the object per row.
 	*/
 	query = async (props) => {
-		return await this.client.query(this.buildQueryOptions(props));
+		const [rows] = await this.client.query(this.buildQueryOptions(props));
+		return rows;
+	};
+	/**
+	* Make a request to the database and return the first row, or null if there are none.
+	* Does not add a LIMIT - the full result set is still fetched, so include one in the query if it is large.
+	*/
+	querySingle = async (props) => {
+		return (await this.query(props))[0] ?? null;
 	};
 	/**
 	* Return the raw row stream for a query, without buffering the full result set in memory.
@@ -147,12 +155,11 @@ var GoogleCloudBigquery = class extends require__class__shared_BaseNamespace.Bas
 	* pre-checking existence and silently skipping the load if it isn't there.
 	*/
 	loadData = async (props) => {
-		const finalTableId = props.table.tableId ?? props.table.definition?.tableId;
-		if (!finalTableId) throw new Error("loadData requires either table.tableId or table.definition.tableId");
-		const finalRegion = props.table.region ?? this.region;
-		await this.createTable(props.table.datasetId, {}, finalTableId, props.table.definition?.options);
-		await this.client.dataset(props.table.datasetId, { location: finalRegion }).table(finalTableId).load(props.googleCloudStorage.client.bucket(props.file.bucket).file(props.file.key), {
-			autodetect: true,
+		const finalRegion = props.table.options?.location ?? this.region;
+		await this.createTable(props.table.datasetId, {}, props.table.tableId, props.table.options);
+		await this.client.dataset(props.table.datasetId, { location: finalRegion }).table(props.table.tableId).load(props.googleCloudStorage.client.bucket(props.file.bucket).file(props.file.key), {
+			autodetect: props.schema ? false : props.autodetect ?? true,
+			schema: props.schema ? { fields: props.schema } : void 0,
 			sourceFormat: bigQuerySourceFormat[props.file.sourceFormat ?? require_file__shared_fileType.fileType.JSON_NEWLINE],
 			schemaUpdateOptions: ["ALLOW_FIELD_ADDITION"],
 			location: finalRegion
@@ -165,8 +172,14 @@ var GoogleCloudBigquery = class extends require__class__shared_BaseNamespace.Bas
 	* this library has no Parquet encoder.
 	*/
 	loadTable = async (props) => {
-		const fileSourceFormat = props.file.sourceFormat ?? require_file__shared_fileType.fileType.JSON_NEWLINE;
-		const finalData = require_file__shared_fileType.fileType.JSON_NEWLINE === fileSourceFormat ? require_json__shared_getJsonNewline.getJsonNewline(props.file.data) : props.file.data;
+		const finalSourceFormat = props.file?.sourceFormat ?? require_file__shared_fileType.fileType.JSON_NEWLINE;
+		let finalData;
+		switch (finalSourceFormat) {
+			case require_file__shared_fileType.fileType.JSON_NEWLINE:
+				finalData = require_json__shared_getJsonNewline.getJsonNewline(props.file.data);
+				break;
+			default: finalData = props.file.data;
+		}
 		await props.googleCloudStorage.writeFile(props.file.bucket, props.file.key, finalData);
 		await this.loadData(props);
 	};
@@ -198,12 +211,12 @@ var GoogleCloudBigquery = class extends require__class__shared_BaseNamespace.Bas
 	* Partitioning is immutable on an existing BigQuery table - changing it requires recreating the
 	* table and backfilling data, which this method deliberately does not attempt.
 	*/
-	syncTableClustering = async (datasetId, tableId, clustering) => {
-		const [metadata] = await this.client.dataset(datasetId).table(tableId).getMetadata();
+	updateTableClustering = async (table) => {
+		const [metadata] = await this.client.dataset(table.datasetId).table(table.tableId).getMetadata();
 		const currentFields = metadata?.clustering?.fields ?? [];
-		const desiredFields = clustering?.fields ?? [];
+		const desiredFields = table.options?.clustering?.fields ?? [];
 		if (currentFields.length === desiredFields.length && currentFields.every((field, index) => field === desiredFields[index])) return;
-		await this.client.dataset(datasetId).table(tableId).setMetadata(desiredFields.length > 0 ? { clustering: { fields: desiredFields } } : { clustering: void 0 });
+		await this.client.dataset(table.datasetId).table(table.tableId).setMetadata(desiredFields.length > 0 ? { clustering: { fields: desiredFields } } : { clustering: void 0 });
 	};
 	/**
 	* Upsert rows into a table via a staging table + a single MERGE statement.
@@ -214,18 +227,16 @@ var GoogleCloudBigquery = class extends require__class__shared_BaseNamespace.Bas
 	*/
 	mergeTable = async (props) => {
 		if (0 === props.file.data.length) return;
-		const finalTableId = props.table.tableId ?? props.table.definition?.tableId;
-		if (!finalTableId) throw new Error("mergeTable requires either table.tableId or table.definition.tableId");
-		if (await this.tableExists(props.table.datasetId, finalTableId)) await this.syncTableClustering(props.table.datasetId, finalTableId, props.table.definition?.options?.clustering);
-		const stagingTableId = `${finalTableId}_staging_${require_date__shared_format.getYmdHisNumber()}`;
+		if (await this.tableExists(props.table.datasetId, props.table.tableId)) await this.updateTableClustering(props.table);
+		const stagingTableId = `${props.table.tableId}_staging_${require_date__shared_format.getYmdHisNumber()}`;
 		const stagingTableRef = `\`${props.table.datasetId}.${stagingTableId}\``;
 		try {
+			const { mergeColumns: _mergeColumns, updateColumns: _updateColumns, ...tableDefinition } = props.table;
 			const stagingDefinition = {
-				...props.table.definition,
-				datasetId: props.table.datasetId,
+				...tableDefinition,
 				tableId: stagingTableId,
-				options: props.table.definition?.options ? {
-					...props.table.definition.options,
+				options: props.table.options ? {
+					...props.table.options,
 					timePartitioning: void 0,
 					clustering: void 0
 				} : void 0
@@ -233,20 +244,16 @@ var GoogleCloudBigquery = class extends require__class__shared_BaseNamespace.Bas
 			await this.loadTable({
 				googleCloudStorage: props.googleCloudStorage,
 				file: props.file,
-				table: {
-					datasetId: props.table.datasetId,
-					definition: stagingDefinition,
-					tableId: stagingTableId,
-					region: props.table.region
-				}
+				table: stagingDefinition
 			});
-			const mainTableRef = `\`${props.table.datasetId}.${finalTableId}\``;
+			const mainTableRef = `\`${props.table.datasetId}.${props.table.tableId}\``;
+			if (0 === props.table.mergeColumns.length) throw new Error("mergeTable requires at least one merge key.");
 			const updateSet = props.table.updateColumns.map((column) => `${column} = S.${column}`).join(", ");
-			const allColumns = props.table.definition?.options?.schema.map((field) => field.name) ?? [];
+			const allColumns = props.table.options?.schema.map((field) => field.name) ?? [];
 			const mergeQuery = `
 				MERGE ${mainTableRef} AS T
 				USING ${stagingTableRef} AS S
-				ON T.${props.table.mergeKey} = S.${props.table.mergeKey}
+				ON ${props.table.mergeColumns.map((key) => `T.${key} = S.${key}`).join(" AND ")}
 				WHEN MATCHED THEN
 					UPDATE SET ${updateSet}
 				WHEN NOT MATCHED THEN

package/dist/googleCloud/bigquery/server/GoogleCloudBigquery.d.cts

@@ -1,5 +1,5 @@
 import { BaseNamespace } from "../../../_class/_shared/BaseNamespace.cjs";
-import { Dataset, LoadStreamTableProps, LoadTableProps, MergeTableProps, QueryInput, Table } from "../_shared/types.cjs";
+import { Dataset, LoadStreamTableProps, LoadTableProps, MergeTableProps, QueryInput, Table, TableDefinition } from "../_shared/types.cjs";
 import "../_shared/index.cjs";
 import { ResourceStream } from "../../../node_modules/@google-cloud/paginator/build/src/resource-stream.cjs";
 import { BigQuery, DatasetResource } from "@google-cloud/bigquery";
@@ -32,7 +32,12 @@ export declare class GoogleCloudBigquery extends BaseNamespace {
   /**
    * Make a request to the database and return the object per row.
    */
-  query: (props: QueryInput) => Promise<any>;
+  query: <TRow = any>(props: QueryInput) => Promise<TRow[]>;
+  /**
+   * Make a request to the database and return the first row, or null if there are none.
+   * Does not add a LIMIT - the full result set is still fetched, so include one in the query if it is large.
+   */
+  querySingle: <TRow = any>(props: QueryInput) => Promise<TRow | null>;
   /**
    * Return the raw row stream for a query, without buffering the full result set in memory.
    */
@@ -40,7 +45,7 @@ export declare class GoogleCloudBigquery extends BaseNamespace {
   /**
    * Create a Table if it doesn't already exist.
    */
-  createTable: (datasetId: string, datasetOptions: object | undefined, tableId: string, options?: object) => Promise<void>;
+  createTable: (datasetId: string, datasetOptions: object | undefined, tableId: string, options?: TableDefinition["options"]) => Promise<void>;
   /**
    * Check to see whether a given BigQuery table exists.
    * https://cloud.google.com/bigquery/docs/samples/bigquery-table-exists
@@ -79,7 +84,7 @@ export declare class GoogleCloudBigquery extends BaseNamespace {
    * Partitioning is immutable on an existing BigQuery table - changing it requires recreating the
    * table and backfilling data, which this method deliberately does not attempt.
    */
-  private syncTableClustering;
+  private updateTableClustering;
   /**
    * Upsert rows into a table via a staging table + a single MERGE statement.
    *

package/dist/googleCloud/bigquery/server/GoogleCloudBigquery.d.mts

@@ -1,5 +1,5 @@
 import { BaseNamespace } from "../../../_class/_shared/BaseNamespace.mjs";
-import { Dataset, LoadStreamTableProps, LoadTableProps, MergeTableProps, QueryInput, Table } from "../_shared/types.mjs";
+import { Dataset, LoadStreamTableProps, LoadTableProps, MergeTableProps, QueryInput, Table, TableDefinition } from "../_shared/types.mjs";
 import "../_shared/index.mjs";
 import { ResourceStream } from "../../../node_modules/@google-cloud/paginator/build/src/resource-stream.mjs";
 import { BigQuery, DatasetResource } from "@google-cloud/bigquery";
@@ -32,7 +32,12 @@ export declare class GoogleCloudBigquery extends BaseNamespace {
   /**
    * Make a request to the database and return the object per row.
    */
-  query: (props: QueryInput) => Promise<any>;
+  query: <TRow = any>(props: QueryInput) => Promise<TRow[]>;
+  /**
+   * Make a request to the database and return the first row, or null if there are none.
+   * Does not add a LIMIT - the full result set is still fetched, so include one in the query if it is large.
+   */
+  querySingle: <TRow = any>(props: QueryInput) => Promise<TRow | null>;
   /**
    * Return the raw row stream for a query, without buffering the full result set in memory.
    */
@@ -40,7 +45,7 @@ export declare class GoogleCloudBigquery extends BaseNamespace {
   /**
    * Create a Table if it doesn't already exist.
    */
-  createTable: (datasetId: string, datasetOptions: object | undefined, tableId: string, options?: object) => Promise<void>;
+  createTable: (datasetId: string, datasetOptions: object | undefined, tableId: string, options?: TableDefinition["options"]) => Promise<void>;
   /**
    * Check to see whether a given BigQuery table exists.
    * https://cloud.google.com/bigquery/docs/samples/bigquery-table-exists
@@ -79,7 +84,7 @@ export declare class GoogleCloudBigquery extends BaseNamespace {
    * Partitioning is immutable on an existing BigQuery table - changing it requires recreating the
    * table and backfilling data, which this method deliberately does not attempt.
    */
-  private syncTableClustering;
+  private updateTableClustering;
   /**
    * Upsert rows into a table via a staging table + a single MERGE statement.
    *

package/dist/googleCloud/bigquery/server/GoogleCloudBigquery.mjs

@@ -97,7 +97,15 @@ var GoogleCloudBigquery = class extends BaseNamespace {
 	* Make a request to the database and return the object per row.
 	*/
 	query = async (props) => {
-		return await this.client.query(this.buildQueryOptions(props));
+		const [rows] = await this.client.query(this.buildQueryOptions(props));
+		return rows;
+	};
+	/**
+	* Make a request to the database and return the first row, or null if there are none.
+	* Does not add a LIMIT - the full result set is still fetched, so include one in the query if it is large.
+	*/
+	querySingle = async (props) => {
+		return (await this.query(props))[0] ?? null;
 	};
 	/**
 	* Return the raw row stream for a query, without buffering the full result set in memory.
@@ -146,12 +154,11 @@ var GoogleCloudBigquery = class extends BaseNamespace {
 	* pre-checking existence and silently skipping the load if it isn't there.
 	*/
 	loadData = async (props) => {
-		const finalTableId = props.table.tableId ?? props.table.definition?.tableId;
-		if (!finalTableId) throw new Error("loadData requires either table.tableId or table.definition.tableId");
-		const finalRegion = props.table.region ?? this.region;
-		await this.createTable(props.table.datasetId, {}, finalTableId, props.table.definition?.options);
-		await this.client.dataset(props.table.datasetId, { location: finalRegion }).table(finalTableId).load(props.googleCloudStorage.client.bucket(props.file.bucket).file(props.file.key), {
-			autodetect: true,
+		const finalRegion = props.table.options?.location ?? this.region;
+		await this.createTable(props.table.datasetId, {}, props.table.tableId, props.table.options);
+		await this.client.dataset(props.table.datasetId, { location: finalRegion }).table(props.table.tableId).load(props.googleCloudStorage.client.bucket(props.file.bucket).file(props.file.key), {
+			autodetect: props.schema ? false : props.autodetect ?? true,
+			schema: props.schema ? { fields: props.schema } : void 0,
 			sourceFormat: bigQuerySourceFormat[props.file.sourceFormat ?? fileType.JSON_NEWLINE],
 			schemaUpdateOptions: ["ALLOW_FIELD_ADDITION"],
 			location: finalRegion
@@ -164,8 +171,14 @@ var GoogleCloudBigquery = class extends BaseNamespace {
 	* this library has no Parquet encoder.
 	*/
 	loadTable = async (props) => {
-		const fileSourceFormat = props.file.sourceFormat ?? fileType.JSON_NEWLINE;
-		const finalData = fileType.JSON_NEWLINE === fileSourceFormat ? getJsonNewline(props.file.data) : props.file.data;
+		const finalSourceFormat = props.file?.sourceFormat ?? fileType.JSON_NEWLINE;
+		let finalData;
+		switch (finalSourceFormat) {
+			case fileType.JSON_NEWLINE:
+				finalData = getJsonNewline(props.file.data);
+				break;
+			default: finalData = props.file.data;
+		}
 		await props.googleCloudStorage.writeFile(props.file.bucket, props.file.key, finalData);
 		await this.loadData(props);
 	};
@@ -197,12 +210,12 @@ var GoogleCloudBigquery = class extends BaseNamespace {
 	* Partitioning is immutable on an existing BigQuery table - changing it requires recreating the
 	* table and backfilling data, which this method deliberately does not attempt.
 	*/
-	syncTableClustering = async (datasetId, tableId, clustering) => {
-		const [metadata] = await this.client.dataset(datasetId).table(tableId).getMetadata();
+	updateTableClustering = async (table) => {
+		const [metadata] = await this.client.dataset(table.datasetId).table(table.tableId).getMetadata();
 		const currentFields = metadata?.clustering?.fields ?? [];
-		const desiredFields = clustering?.fields ?? [];
+		const desiredFields = table.options?.clustering?.fields ?? [];
 		if (currentFields.length === desiredFields.length && currentFields.every((field, index) => field === desiredFields[index])) return;
-		await this.client.dataset(datasetId).table(tableId).setMetadata(desiredFields.length > 0 ? { clustering: { fields: desiredFields } } : { clustering: void 0 });
+		await this.client.dataset(table.datasetId).table(table.tableId).setMetadata(desiredFields.length > 0 ? { clustering: { fields: desiredFields } } : { clustering: void 0 });
 	};
 	/**
 	* Upsert rows into a table via a staging table + a single MERGE statement.
@@ -213,18 +226,16 @@ var GoogleCloudBigquery = class extends BaseNamespace {
 	*/
 	mergeTable = async (props) => {
 		if (0 === props.file.data.length) return;
-		const finalTableId = props.table.tableId ?? props.table.definition?.tableId;
-		if (!finalTableId) throw new Error("mergeTable requires either table.tableId or table.definition.tableId");
-		if (await this.tableExists(props.table.datasetId, finalTableId)) await this.syncTableClustering(props.table.datasetId, finalTableId, props.table.definition?.options?.clustering);
-		const stagingTableId = `${finalTableId}_staging_${getYmdHisNumber()}`;
+		if (await this.tableExists(props.table.datasetId, props.table.tableId)) await this.updateTableClustering(props.table);
+		const stagingTableId = `${props.table.tableId}_staging_${getYmdHisNumber()}`;
 		const stagingTableRef = `\`${props.table.datasetId}.${stagingTableId}\``;
 		try {
+			const { mergeColumns: _mergeColumns, updateColumns: _updateColumns, ...tableDefinition } = props.table;
 			const stagingDefinition = {
-				...props.table.definition,
-				datasetId: props.table.datasetId,
+				...tableDefinition,
 				tableId: stagingTableId,
-				options: props.table.definition?.options ? {
-					...props.table.definition.options,
+				options: props.table.options ? {
+					...props.table.options,
 					timePartitioning: void 0,
 					clustering: void 0
 				} : void 0
@@ -232,20 +243,16 @@ var GoogleCloudBigquery = class extends BaseNamespace {
 			await this.loadTable({
 				googleCloudStorage: props.googleCloudStorage,
 				file: props.file,
-				table: {
-					datasetId: props.table.datasetId,
-					definition: stagingDefinition,
-					tableId: stagingTableId,
-					region: props.table.region
-				}
+				table: stagingDefinition
 			});
-			const mainTableRef = `\`${props.table.datasetId}.${finalTableId}\``;
+			const mainTableRef = `\`${props.table.datasetId}.${props.table.tableId}\``;
+			if (0 === props.table.mergeColumns.length) throw new Error("mergeTable requires at least one merge key.");
 			const updateSet = props.table.updateColumns.map((column) => `${column} = S.${column}`).join(", ");
-			const allColumns = props.table.definition?.options?.schema.map((field) => field.name) ?? [];
+			const allColumns = props.table.options?.schema.map((field) => field.name) ?? [];
 			const mergeQuery = `
 				MERGE ${mainTableRef} AS T
 				USING ${stagingTableRef} AS S
-				ON T.${props.table.mergeKey} = S.${props.table.mergeKey}
+				ON ${props.table.mergeColumns.map((key) => `T.${key} = S.${key}`).join(" AND ")}
 				WHEN MATCHED THEN
 					UPDATE SET ${updateSet}
 				WHEN NOT MATCHED THEN

package/dist/googleCloud/bigquery/server/index.cjs

@@ -29,7 +29,6 @@ exports.BQFieldMode = require_googleCloud_bigquery__shared_field_bqFieldMode.BQF
 exports.BQFieldModeSchema = require_googleCloud_bigquery__shared_field_bqFieldMode.BQFieldModeSchema;
 exports.BQFieldType = require_googleCloud_bigquery__shared_field_bqFieldType.BQFieldType;
 exports.BQFieldTypeSchema = require_googleCloud_bigquery__shared_field_bqFieldType.BQFieldTypeSchema;
-exports.BQFloat = require_googleCloud_bigquery__shared_field_bqFloat.BQFloat;
 exports.BQInt64 = require_googleCloud_bigquery__shared_field_bqInt64.BQInt64;
 exports.BQNumeric = require_googleCloud_bigquery__shared_field_bqNumeric.BQNumeric;
 exports.BQString = require_googleCloud_bigquery__shared_field_bqString.BQString;
@@ -47,6 +46,7 @@ exports.googleCloudBQRow = require_googleCloud_bigquery__shared_lookup_googleClo
 exports.languageBQRow = require_googleCloud_bigquery__shared_lookup_language.languageBQRow;
 exports.partitionType = require_googleCloud_bigquery__shared_partitionType.partitionType;
 exports.zBQBytes = require_googleCloud_bigquery__shared_field_bqBytes.zBQBytes;
+exports.zBQFloat = require_googleCloud_bigquery__shared_field_bqFloat.zBQFloat;
 exports.zBQInt = require_googleCloud_bigquery__shared_field_bqInt.zBQInt;
 exports.zBQInt64 = require_googleCloud_bigquery__shared_field_bqInt64.zBQInt64;
 exports.zBQNumeric = require_googleCloud_bigquery__shared_field_bqNumeric.zBQNumeric;

package/dist/googleCloud/bigquery/server/index.d.cts

@@ -4,7 +4,7 @@ import { BQDate, decodeBQDate, encodeBQDate, zLuxonDate } from "../_shared/field
 import { BQDateTime, BQDatetime, decodeBQDateTime, encodeBQDateTime, zLuxonDateTime } from "../_shared/field/bqDateTime.cjs";
 import { BQFieldMode, BQFieldModeSchema } from "../_shared/field/bqFieldMode.cjs";
 import { BQFieldType, BQFieldTypeSchema } from "../_shared/field/bqFieldType.cjs";
-import { BQFloat } from "../_shared/field/bqFloat.cjs";
+import { zBQFloat } from "../_shared/field/bqFloat.cjs";
 import { zBQInt } from "../_shared/field/bqInt.cjs";
 import { BQInt64, zBQInt64 } from "../_shared/field/bqInt64.cjs";
 import { BQNumeric, zBQNumeric } from "../_shared/field/bqNumeric.cjs";
@@ -21,4 +21,4 @@ import { BigqueryLoadFormat, Dataset, LoadData, LoadStreamTableProps, LoadTableP
 import "../_shared/index.cjs";
 import { GoogleCloudBigquery } from "./GoogleCloudBigquery.cjs";
 import { getHandlerPath } from "./getHandlerPath.cjs";
-export { BQBool, BQBytes, BQDate, BQDateTime, BQDatetime, BQField, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQFloat, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, BigqueryLoadFormat, CountryBQRow, Dataset, GoogleAdsAccountBQRow, GoogleCloudBQRow, GoogleCloudBigquery, LanguageBQRow, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, PartitionType, QueryInput, Table, TableDefinition, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, getHandlerPath, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };
+export { BQBool, BQBytes, BQDate, BQDateTime, BQDatetime, BQField, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, BigqueryLoadFormat, CountryBQRow, Dataset, GoogleAdsAccountBQRow, GoogleCloudBQRow, GoogleCloudBigquery, LanguageBQRow, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, PartitionType, QueryInput, Table, TableDefinition, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, getHandlerPath, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQFloat, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };

package/dist/googleCloud/bigquery/server/index.d.mts

@@ -4,7 +4,7 @@ import { BQDate, decodeBQDate, encodeBQDate, zLuxonDate } from "../_shared/field
 import { BQDateTime, BQDatetime, decodeBQDateTime, encodeBQDateTime, zLuxonDateTime } from "../_shared/field/bqDateTime.mjs";
 import { BQFieldMode, BQFieldModeSchema } from "../_shared/field/bqFieldMode.mjs";
 import { BQFieldType, BQFieldTypeSchema } from "../_shared/field/bqFieldType.mjs";
-import { BQFloat } from "../_shared/field/bqFloat.mjs";
+import { zBQFloat } from "../_shared/field/bqFloat.mjs";
 import { zBQInt } from "../_shared/field/bqInt.mjs";
 import { BQInt64, zBQInt64 } from "../_shared/field/bqInt64.mjs";
 import { BQNumeric, zBQNumeric } from "../_shared/field/bqNumeric.mjs";
@@ -21,4 +21,4 @@ import { BigqueryLoadFormat, Dataset, LoadData, LoadStreamTableProps, LoadTableP
 import "../_shared/index.mjs";
 import { GoogleCloudBigquery } from "./GoogleCloudBigquery.mjs";
 import { getHandlerPath } from "./getHandlerPath.mjs";
-export { BQBool, BQBytes, BQDate, BQDateTime, BQDatetime, BQField, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQFloat, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, BigqueryLoadFormat, CountryBQRow, Dataset, GoogleAdsAccountBQRow, GoogleCloudBQRow, GoogleCloudBigquery, LanguageBQRow, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, PartitionType, QueryInput, Table, TableDefinition, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, getHandlerPath, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };
+export { BQBool, BQBytes, BQDate, BQDateTime, BQDatetime, BQField, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, BigqueryLoadFormat, CountryBQRow, Dataset, GoogleAdsAccountBQRow, GoogleCloudBQRow, GoogleCloudBigquery, LanguageBQRow, LoadData, LoadStreamTableProps, LoadTableProps, MergeTableProps, PartitionType, QueryInput, Table, TableDefinition, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, getHandlerPath, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQFloat, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };

package/dist/googleCloud/bigquery/server/index.mjs

@@ -4,7 +4,7 @@ import { BQDate, decodeBQDate, encodeBQDate, zLuxonDate } from "../_shared/field
 import { BQDateTime, decodeBQDateTime, encodeBQDateTime, zLuxonDateTime } from "../_shared/field/bqDateTime.mjs";
 import { BQFieldMode, BQFieldModeSchema } from "../_shared/field/bqFieldMode.mjs";
 import { BQFieldType, BQFieldTypeSchema } from "../_shared/field/bqFieldType.mjs";
-import { BQFloat } from "../_shared/field/bqFloat.mjs";
+import { zBQFloat } from "../_shared/field/bqFloat.mjs";
 import { zBQInt } from "../_shared/field/bqInt.mjs";
 import { BQInt64, zBQInt64 } from "../_shared/field/bqInt64.mjs";
 import { BQNumeric, zBQNumeric } from "../_shared/field/bqNumeric.mjs";
@@ -20,4 +20,4 @@ import { zodToBQSchema } from "../_shared/zodToBQDefinition.mjs";
 import "../_shared/index.mjs";
 import { GoogleCloudBigquery } from "./GoogleCloudBigquery.mjs";
 import { getHandlerPath } from "./getHandlerPath.mjs";
-export { BQBool, BQBytes, BQDate, BQDateTime, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQFloat, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, GoogleCloudBigquery, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, getHandlerPath, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };
+export { BQBool, BQBytes, BQDate, BQDateTime, BQFieldMode, BQFieldModeSchema, BQFieldType, BQFieldTypeSchema, BQInt64, BQNumeric, BQString, BQTime, BQTimestamp, GoogleCloudBigquery, countryBQRow, decodeBQDate, decodeBQDateTime, encodeBQDate, encodeBQDateTime, getHandlerPath, googleAdsAccountBQRow, googleCloudBQRow, languageBQRow, partitionType, zBQBytes, zBQFloat, zBQInt, zBQInt64, zBQNumeric, zBQTime, zLuxonDate, zLuxonDateTime, zodToBQSchema };

package/dist/url/server/writeUrlContents.cjs

@@ -4,6 +4,7 @@ const require_file_server_createDirectory = require("../../file/server/createDir
 let ky = require("ky");
 ky = require_runtime.__toESM(ky);
 let stream = require("stream");
+let stream_promises = require("stream/promises");
 let fs = require("fs");
 //#region src/url/server/writeUrlContents.ts
 /**
@@ -11,21 +12,9 @@ let fs = require("fs");
 */
 const writeUrlContents = async (filePath, url) => {
 	await require_file_server_createDirectory.createDirectory(filePath);
-	const writer = (0, fs.createWriteStream)(filePath);
 	const response = await ky.default.get(url);
-	const stream$1 = stream.Readable.fromWeb(response.body);
-	await new Promise((resolve, reject) => {
-		stream$1.pipe(writer);
-		let error = null;
-		writer.on("error", (err) => {
-			error = err;
-			writer.close();
-			reject(err);
-		});
-		writer.on("close", () => {
-			if (!error) resolve();
-		});
-	});
+	if (!response.body) throw new Error(`No response body for ${url}`);
+	await (0, stream_promises.pipeline)(stream.Readable.fromWeb(response.body), (0, fs.createWriteStream)(filePath));
 };
 //#endregion
 exports.writeUrlContents = writeUrlContents;

package/dist/url/server/writeUrlContents.mjs

@@ -1,6 +1,7 @@
 import { createDirectory } from "../../file/server/createDirectory.mjs";
 import ky from "ky";
 import { Readable } from "stream";
+import { pipeline } from "stream/promises";
 import { createWriteStream } from "fs";
 //#region src/url/server/writeUrlContents.ts
 /**
@@ -8,21 +9,9 @@ import { createWriteStream } from "fs";
 */
 const writeUrlContents = async (filePath, url) => {
 	await createDirectory(filePath);
-	const writer = createWriteStream(filePath);
 	const response = await ky.get(url);
-	const stream = Readable.fromWeb(response.body);
-	await new Promise((resolve, reject) => {
-		stream.pipe(writer);
-		let error = null;
-		writer.on("error", (err) => {
-			error = err;
-			writer.close();
-			reject(err);
-		});
-		writer.on("close", () => {
-			if (!error) resolve();
-		});
-	});
+	if (!response.body) throw new Error(`No response body for ${url}`);
+	await pipeline(Readable.fromWeb(response.body), createWriteStream(filePath));
 };
 //#endregion
 export { writeUrlContents };

package/dist/xlsx/_shared/createXlsx.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_xlsx__shared_column = require("./column.cjs");
 const require_xlsx__shared_cell = require("./cell.cjs");
-const require_zip__shared_ZipArchive = require("../../zip/_shared/ZipArchive.cjs");
 const require_xlsx__shared_sheet = require("./sheet.cjs");
+const require_zip__shared_ZipArchive = require("../../zip/_shared/ZipArchive.cjs");
 //#region src/xlsx/_shared/createXlsx.ts
 /**
 * Builds a complete .xlsx workbook from scratch, using hand-written OOXML rather

package/dist/xlsx/_shared/createXlsx.mjs

@@ -1,7 +1,7 @@
 import { getColumLetter, getColumnWidth } from "./column.mjs";
 import { buildCellXml, getCellValue, getEscapedXml } from "./cell.mjs";
-import { ZipArchive } from "../../zip/_shared/ZipArchive.mjs";
 import { getUniqueSheetNames } from "./sheet.mjs";
+import { ZipArchive } from "../../zip/_shared/ZipArchive.mjs";
 //#region src/xlsx/_shared/createXlsx.ts
 /**
 * Builds a complete .xlsx workbook from scratch, using hand-written OOXML rather

package/package.json

@@ -1,8 +1,8 @@
 {
 	"name": "@8ms/helpers",
 	"license": "UNLICENSED",
-	"version": "3.2.9",
-	"packageManager": "yarn@4.18.0",
+	"version": "3.2.11",
+	"packageManager": "yarn@4.18.1",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/8millionstories-organisation/8ms-helpers-ts.git"
@@ -196,19 +196,19 @@
 	},
 	"devDependencies": {
 		"@1password/sdk": "^0.5.0",
-		"@aws-sdk/client-cloudwatch": "^3.1141.0",
-		"@aws-sdk/client-cloudwatch-logs": "^3.1141.0",
-		"@aws-sdk/client-ec2": "^3.1141.0",
-		"@aws-sdk/client-ecs": "^3.1141.0",
-		"@aws-sdk/client-glue": "^3.1141.0",
-		"@aws-sdk/client-lambda": "^3.1141.0",
-		"@aws-sdk/client-s3": "^3.1141.0",
-		"@aws-sdk/client-sesv2": "^3.1141.0",
-		"@aws-sdk/client-sqs": "^3.1141.0",
-		"@aws-sdk/client-ssm": "^3.1141.0",
-		"@aws-sdk/client-sts": "^3.1141.0",
-		"@aws-sdk/lib-storage": "^3.1141.0",
-		"@aws-sdk/s3-request-presigner": "^3.1141.0",
+		"@aws-sdk/client-cloudwatch": "^3.1145.0",
+		"@aws-sdk/client-cloudwatch-logs": "^3.1145.0",
+		"@aws-sdk/client-ec2": "^3.1145.0",
+		"@aws-sdk/client-ecs": "^3.1145.0",
+		"@aws-sdk/client-glue": "^3.1145.0",
+		"@aws-sdk/client-lambda": "^3.1145.0",
+		"@aws-sdk/client-s3": "^3.1145.0",
+		"@aws-sdk/client-sesv2": "^3.1145.0",
+		"@aws-sdk/client-sqs": "^3.1145.0",
+		"@aws-sdk/client-ssm": "^3.1145.0",
+		"@aws-sdk/client-sts": "^3.1145.0",
+		"@aws-sdk/lib-storage": "^3.1145.0",
+		"@aws-sdk/s3-request-presigner": "^3.1145.0",
 		"@aws-sdk/types": "^3.974.6",
 		"@babel/core": "^8.0.6",
 		"@babel/preset-env": "^8.0.6",
@@ -218,28 +218,28 @@
 		"@google-cloud/storage": "^8.2.0",
 		"@googleapis/drive": "^26.0.1",
 		"@googleapis/sheets": "^18.0.1",
-		"@planetscale/database": "^1.20.1",
+		"@planetscale/database": "^1.20.2",
 		"@prisma/adapter-mariadb": "^7.10.0",
 		"@prisma/adapter-pg": "^7.10.0",
 		"@prisma/adapter-planetscale": "^7.10.0",
 		"@prisma/client": "^7.10.0",
 		"@types/fs-extra": "^11.0.4",
 		"@types/jest": "^30.0.0",
-		"@types/luxon": "^3.7.5",
-		"@types/node": "^24.19.0",
+		"@types/luxon": "^3.7.6",
+		"@types/node": "^24.19.1",
 		"@types/react": "^19.3.0",
 		"@vercel/oidc": "^3.8.9",
 		"@vercel/oidc-aws-credentials-provider": "^3.3.9",
 		"babel-jest": "30.5.2",
-		"dotenv": "^18.0.4",
+		"dotenv": "^18.0.5",
 		"drizzle-orm": "1.0.0-beta.22",
 		"gaxios": "^8.1.0",
 		"google-auth-library": "^11.1.0",
 		"googleapis-common": "^9.1.0",
 		"jest": "^30.5.2",
-		"mysql2": "^3.24.4",
-		"next": "^16.3.6",
-		"pg": "^8.23.0",
+		"mysql2": "^3.24.5",
+		"next": "^16.3.8",
+		"pg": "^8.23.1",
 		"react": "^19.3.0",
 		"react-intersection-observer": "^11.0.1",
 		"stream-json": "^3.7.0",
@@ -995,10 +995,6 @@
 			"import": "./dist/googleCloud/bigquery/_shared/field/bqInt64.mjs",
 			"require": "./dist/googleCloud/bigquery/_shared/field/bqInt64.cjs"
 		},
-		"./googleCloud/bigquery/_shared/field/bqNullableString": {
-			"import": "./dist/googleCloud/bigquery/_shared/field/bqNullableString.mjs",
-			"require": "./dist/googleCloud/bigquery/_shared/field/bqNullableString.cjs"
-		},
 		"./googleCloud/bigquery/_shared/field/bqNumeric": {
 			"import": "./dist/googleCloud/bigquery/_shared/field/bqNumeric.mjs",
 			"require": "./dist/googleCloud/bigquery/_shared/field/bqNumeric.cjs"
@@ -1007,6 +1003,10 @@
 			"import": "./dist/googleCloud/bigquery/_shared/field/bqString.mjs",
 			"require": "./dist/googleCloud/bigquery/_shared/field/bqString.cjs"
 		},
+		"./googleCloud/bigquery/_shared/field/bqStringNullable": {
+			"import": "./dist/googleCloud/bigquery/_shared/field/bqStringNullable.mjs",
+			"require": "./dist/googleCloud/bigquery/_shared/field/bqStringNullable.cjs"
+		},
 		"./googleCloud/bigquery/_shared/field/bqTime": {
 			"import": "./dist/googleCloud/bigquery/_shared/field/bqTime.mjs",
 			"require": "./dist/googleCloud/bigquery/_shared/field/bqTime.cjs"