@flytedesk/app-kit 6.0.0 → 7.1.0

package/dist/bigquery/types.d.ts

@@ -92,12 +92,43 @@ export interface BigQueryJobLike {
      *  the 3-tuple rather than requiring all three elements. */
     getQueryResults<T = Record<string, unknown>>(options?: BigQueryQueryResultsOptions): Promise<[T[]] | [T[], BigQueryNextQuery, unknown]>;
 }
+/**
+ * One STRUCT parameter type, in the shape `@google-cloud/bigquery` accepts
+ * (`QueryParamTypeStruct`): field name -> a scalar name, an ARRAY (`["STRING"]`) or a
+ * nested struct.
+ */
+export type BigQueryParamTypeStruct = {
+    [field: string]: string | string[] | BigQueryParamTypeStruct | BigQueryParamTypeStruct[];
+};
+/**
+ * The `types` option — the SDK's own `QueryParamTypes`: the declared type of each
+ * `params` entry, an object keyed by parameter name for named (`@name`) params, an array
+ * by position for positional (`?`) ones. A scalar is its type name (`"INT64"`), an ARRAY
+ * is a one-element array holding the element type (`["INT64"]` is ARRAY<INT64>), a STRUCT
+ * is an object of field types. Declare a type whenever the SDK cannot infer it, which
+ * includes every NULL and every EMPTY array (it infers an array's element type only from
+ * its first element): `{ params: { ids: [] }, types: { ids: ["INT64"] } }`, or for
+ * positional params `{ params: [[]], types: [["INT64"]] }`. The SDK's typings make a
+ * positional array homogeneous (all scalars, or all arrays); name the params to mix them.
+ * (BigQuery itself reads an empty array parameter as a NULL array: `x IN UNNEST(@ids)`
+ * is false and `UNNEST` yields no rows, but `ARRAY_LENGTH(@ids)` is NULL — measure one
+ * with `(SELECT COUNT(*) FROM UNNEST(@ids))`.)
+ *
+ * DATE, DATETIME, TIME, TIMESTAMP and GEOGRAPHY values must be the SDK's wrapper objects
+ * (`BigQuery.date("2026-02-01")`, etc.; a `Date` also works for a TIMESTAMP that is not an
+ * array element). Anything else, most commonly a bare string, is bound as NULL by the SDK
+ * with no error, so `runQuery` and `estimateQueryBytes` reject it with a `BadQueryError`
+ * first. To carry a date as a plain string, declare it STRING and convert in the SQL:
+ * `DATE(@since)`.
+ */
+export type BigQueryParamTypes = string[] | string[][] | BigQueryParamTypeStruct | BigQueryParamTypeStruct[];
 export interface BigQueryCreateQueryJobOptions {
     query: string;
     /** 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?: string[] | Record<string, string>;
+    /** Only needed when the SDK can't infer a param's BigQuery type — see
+     *  `BigQueryParamTypes`. */
+    types?: BigQueryParamTypes;
     labels?: Record<string, string>;
     dryRun?: boolean;
     location?: string;
@@ -192,7 +223,8 @@ export interface RunQueryOptions {
      *  values — never string-interpolate them into `sql`. */
     sql: string;
     params?: unknown[] | Record<string, unknown>;
-    types?: string[] | Record<string, string>;
+    /** Declared BigQuery parameter types — see `BigQueryParamTypes`. */
+    types?: BigQueryParamTypes;
     labels?: Record<string, string>;
     location?: string;
     /** Page size. Omit to let BigQuery pick a default. */
@@ -229,7 +261,8 @@ export interface QueryPage<T = Record<string, unknown>> {
 export interface EstimateQueryBytesOptions {
     sql: string;
     params?: unknown[] | Record<string, unknown>;
-    types?: string[] | Record<string, string>;
+    /** Declared BigQuery parameter types — see `BigQueryParamTypes`. */
+    types?: BigQueryParamTypes;
     location?: string;
     /** When given, `estimateQueryBytes` throws `DryRunBudgetExceededError`
      *  instead of returning once the estimate exceeds this many bytes. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flytedesk/app-kit",
-  "version": "6.0.0",
+  "version": "7.1.0",
   "description": "Shared platform kit for flytedesk apps: flytedesk-id auth (BFF/OIDC client) and a Postgres-native trace/audit layer.",
   "type": "module",
   "license": "UNLICENSED",
@@ -51,6 +51,10 @@
       "types": "./dist/auth/client/index.d.ts",
       "import": "./dist/auth/client/index.js"
     },
+    "./auth/client/testing": {
+      "types": "./dist/auth/client/testing.d.ts",
+      "import": "./dist/auth/client/testing.js"
+    },
     "./trace": {
       "types": "./dist/trace/index.d.ts",
       "import": "./dist/trace/index.js"
@@ -94,10 +98,11 @@
     "lint": "eslint .",
     "format": "prettier --check .",
     "check:exports": "publint && attw --pack . --profile esm-only",
-    "check": "npm run lint && npm run typecheck && npm run build && npm test && npm run test:integration && npm run check:exports",
+    "check": "npm run lint && npm run typecheck && npm run build && npm test && npm run test:integration && playwright test && npm run check:exports",
     "changeset": "changeset",
     "version-packages": "changeset version",
-    "release": "npm run build && npm run check:exports && changeset publish"
+    "release": "npm run build && npm run check:exports && changeset publish",
+    "test:browser": "npm run build && playwright test"
   },
   "peerDependencies": {
     "@prisma/client": "^7",
@@ -122,6 +127,7 @@
     "@changesets/changelog-github": "^1.0.0",
     "@changesets/cli": "^3.0.1",
     "@google-cloud/bigquery": "^9.1.0",
+    "@playwright/test": "^1.63.0",
     "@prisma/client": "^7.10.0",
     "@testcontainers/postgresql": "^12.1.0",
     "@testing-library/react": "^16.3.3",