@flytedesk/app-kit 3.1.0 → 3.2.1

package/dist/bigquery/index.d.ts

@@ -45,5 +45,6 @@ export { extractTableToGCS, getExtractJobStatus, waitForExtractJob, } from "./ex
 export { loadRowsWithRetry } from "./load.js";
 export type { LoadRowsOptions } from "./load.js";
 export { buildJobLabels, sanitizeLabelValue } from "./labels.js";
+export { unwrapBigQueryCount, unwrapBigQueryValue } from "./values.js";
 export { BadQueryError, BigQueryReadError, DryRunBudgetExceededError, PermissionDeniedError, classifyBigQueryError, isRetryableBigQueryError, } from "./errors.js";
 export type { BigQueryApiErrorDetail, BigQueryCreateQueryJobOptions, BigQueryDatasetLike, BigQueryExtractOptions, BigQueryJobLike, BigQueryJobMetadata, BigQueryLike, BigQueryLoadOptions, BigQueryNextQuery, BigQueryQueryResultsOptions, BigQuerySchemaField, BigQueryTableLike, BigQueryWriteStreamLike, DryRunEstimate, EstimateQueryBytesOptions, ExtractJobHandle, ExtractJobState, ExtractJobStatus, ExtractTableToGCSInput, GcsFileLike, JobLabelInput, QueryPage, RunQueryOptions, WaitForExtractJobOptions, } from "./types.js";

package/dist/bigquery/index.js

@@ -43,5 +43,6 @@ export { runQuery, runQueryAllPages, estimateQueryBytes } from "./query.js";
 export { extractTableToGCS, getExtractJobStatus, waitForExtractJob, } from "./extract.js";
 export { loadRowsWithRetry } from "./load.js";
 export { buildJobLabels, sanitizeLabelValue } from "./labels.js";
+export { unwrapBigQueryCount, unwrapBigQueryValue } from "./values.js";
 export { BadQueryError, BigQueryReadError, DryRunBudgetExceededError, PermissionDeniedError, classifyBigQueryError, isRetryableBigQueryError, } from "./errors.js";
 //# sourceMappingURL=index.js.map

package/dist/bigquery/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bigquery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAMvD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE5E,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bigquery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAMvD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE5E,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,aAAa,CAAC"}

package/dist/bigquery/types.d.ts

@@ -58,7 +58,7 @@ export interface BigQueryCreateQueryJobOptions {
     /** Positional (`?`) or named (`@name`) query parameters. */
     params?: unknown[] | Record<string, unknown>;
     /** Only needed when the SDK can't infer a param's BigQuery type. */
-    types?: unknown[] | Record<string, string>;
+    types?: string[] | Record<string, string>;
     labels?: Record<string, string>;
     dryRun?: boolean;
     location?: string;
@@ -130,7 +130,7 @@ export interface RunQueryOptions {
      *  values — never string-interpolate them into `sql`. */
     sql: string;
     params?: unknown[] | Record<string, unknown>;
-    types?: unknown[] | Record<string, string>;
+    types?: string[] | Record<string, string>;
     labels?: Record<string, string>;
     location?: string;
     /** Page size. Omit to let BigQuery pick a default. */
@@ -147,7 +147,7 @@ export interface QueryPage<T = Record<string, unknown>> {
 export interface EstimateQueryBytesOptions {
     sql: string;
     params?: unknown[] | Record<string, unknown>;
-    types?: unknown[] | Record<string, string>;
+    types?: string[] | Record<string, string>;
     location?: string;
     /** When given, `estimateQueryBytes` throws `DryRunBudgetExceededError`
      *  instead of returning once the estimate exceeds this many bytes. */

package/dist/bigquery/values.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Row-value normalisation — BigQuery's client library hands some column
+ * types back as its own wrapper objects rather than plain JS primitives
+ * (NUMERIC -> a `Big` instance exposing `.toNumber()`, TIMESTAMP/DATE -> an
+ * object exposing `.value`, an ISO string). Every other type (STRING,
+ * INTEGER, FLOAT, BOOLEAN, null) passes through unchanged. Generalized out
+ * of media-planner's identical helper (also independently ported into
+ * flytedesk-id's `src/lib/bigquery.ts`, MP-200/PLN-2 — this is that helper's
+ * one shared home).
+ */
+/** Unwraps a single BigQuery result-row value into a plain,
+ *  JSON-serializable value. */
+export declare function unwrapBigQueryValue(value: unknown): unknown;
+/** Unwraps a BigQuery result-row value and coerces it to a number —
+ *  convenient for `SELECT COUNT(*) AS total` / other scalar-aggregate
+ *  results, which the client library may hand back as a NUMERIC wrapper
+ *  rather than a plain number. Missing/unparseable values become 0. */
+export declare function unwrapBigQueryCount(value: unknown): number;

package/dist/bigquery/values.js

@@ -0,0 +1,35 @@
+/**
+ * Row-value normalisation — BigQuery's client library hands some column
+ * types back as its own wrapper objects rather than plain JS primitives
+ * (NUMERIC -> a `Big` instance exposing `.toNumber()`, TIMESTAMP/DATE -> an
+ * object exposing `.value`, an ISO string). Every other type (STRING,
+ * INTEGER, FLOAT, BOOLEAN, null) passes through unchanged. Generalized out
+ * of media-planner's identical helper (also independently ported into
+ * flytedesk-id's `src/lib/bigquery.ts`, MP-200/PLN-2 — this is that helper's
+ * one shared home).
+ */
+/** Unwraps a single BigQuery result-row value into a plain,
+ *  JSON-serializable value. */
+export function unwrapBigQueryValue(value) {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value === "object") {
+        if ("toNumber" in value && typeof value.toNumber === "function") {
+            return value.toNumber();
+        }
+        if ("value" in value) {
+            return value.value;
+        }
+    }
+    return value;
+}
+/** Unwraps a BigQuery result-row value and coerces it to a number —
+ *  convenient for `SELECT COUNT(*) AS total` / other scalar-aggregate
+ *  results, which the client library may hand back as a NUMERIC wrapper
+ *  rather than a plain number. Missing/unparseable values become 0. */
+export function unwrapBigQueryCount(value) {
+    const raw = unwrapBigQueryValue(value);
+    const num = typeof raw === "number" ? raw : Number(raw ?? 0);
+    return Number.isFinite(num) ? num : 0;
+}
+//# sourceMappingURL=values.js.map

package/dist/bigquery/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../src/bigquery/values.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;+BAC+B;AAC/B,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,UAAU,IAAI,KAAK,IAAI,OAAQ,KAA+B,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC3F,OAAQ,KAAgC,CAAC,QAAQ,EAAE,CAAC;QACtD,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;YACrB,OAAQ,KAA4B,CAAC,KAAK,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;uEAGuE;AACvE,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,MAAM,GAAG,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flytedesk/app-kit",
-  "version": "3.1.0",
+  "version": "3.2.1",
   "description": "Shared platform kit for flytedesk apps: flytedesk-id auth (BFF/OIDC client) and a Postgres-native trace/audit layer.",
   "type": "module",
   "license": "UNLICENSED",