@walkeros/server-destination-gcp 4.7.0-next-1790245733116 → 4.7.0

package/CHANGELOG.md

@@ -1,24 +1,48 @@
 # @walkeros/server-destination-gcp
 
-## 4.7.0-next-1790245733116
+## 4.7.0
 
-### Patch Changes
+### Minor Changes
 
-- Updated dependencies [57788bc]
+- 64b06de: Packages with several exports, such as the GCP and AWS sources and
+  destinations, now publish a settings schema per export. `walkeros validate`
+  and MCP `package_get` use the schema of the export a step imports. Pub/Sub,
+  BigQuery, SNS and SQS steps pinned to this release or later are checked
+  instead of skipped; older pins still report a skip.
+- 74821ed: Simulate records every vendor call through one recorder, `observeEnv`
+  from `@walkeros/core`, and runs offline: BigQuery, Data Manager and the
+  Sheets, GCS and S3 stores reach the network through `env`. Client and `Env`
+  types of BigQuery, Firehose, PostHog, SQS and Pub/Sub are structural.
+  `@walkeros/cli` exports `resolveExportName` and `selectDevExamples` and drops
+  `findExample` and `compareOutput`.
+
+### Patch Changes
+
+- 74821ed: Simulate starts only the simulated step, and a simulated transformer
+  continues through its `next`. Source simulations list the commands a source
+  issues as `elb` calls; `--page-url` sets the web page. Express flows need no
+  port. Packages with several exports use per-export examples and mocks, and a
+  destination without a mock env is refused instead of calling the vendor.
+- Updated dependencies [74821ed]
 - Updated dependencies [06b498a]
-- Updated dependencies [f5a1cfd]
-- Updated dependencies [ef02916]
+- Updated dependencies [74821ed]
+- Updated dependencies [64b06de]
+- Updated dependencies [4b4937f]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
 - Updated dependencies [06b498a]
-- Updated dependencies [ef02916]
-- Updated dependencies [2aebc53]
-- Updated dependencies [f5a1cfd]
-- Updated dependencies [f5a1cfd]
-- Updated dependencies [2aebc53]
-- Updated dependencies [8f8aea6]
-- Updated dependencies [2aebc53]
-- Updated dependencies [2aebc53]
-  - @walkeros/core@4.7.0-next-1790245733116
-  - @walkeros/server-core@4.7.0-next-1790245733116
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [e860006]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [4f89234]
+  - @walkeros/core@4.7.0
+  - @walkeros/server-core@4.7.0
 
 ## 4.6.1
 

package/dist/dev.d.mts

@@ -1,41 +1,141 @@
 import * as _walkeros_core_dev from '@walkeros/core/dev';
-import * as _google_cloud_bigquery_storage from '@google-cloud/bigquery-storage';
-import { managedwriter } from '@google-cloud/bigquery-storage';
 import { DestinationServer } from '@walkeros/server-core';
-import { BigQuery } from '@google-cloud/bigquery';
+import { BigQueryOptions } from '@google-cloud/bigquery';
+import { managedwriter } from '@google-cloud/bigquery-storage';
 import { Flow, Hint } from '@walkeros/core';
+import { ClientConfig } from '@google-cloud/pubsub';
 
-declare const settings$1: _walkeros_core_dev.JSONSchema;
-declare const mapping$1: _walkeros_core_dev.JSONSchema;
-
-declare const settings: _walkeros_core_dev.JSONSchema;
-declare const mapping: _walkeros_core_dev.JSONSchema;
-declare const setup: _walkeros_core_dev.JSONSchema;
-
-declare namespace schemas {
-  export { mapping$1 as mapping, mapping as pubsubMapping, settings as pubsubSettings, setup as pubsubSetup, settings$1 as settings };
+type CallOptions = NonNullable<Parameters<managedwriter.WriterClient['getWriteStream']>[1]>;
+type ClientOptions = NonNullable<ConstructorParameters<typeof managedwriter.WriterClient>[0]>;
+type WriteStreamRequest = Parameters<managedwriter.WriterClient['getWriteStream']>[0];
+type WriteStreamInfo = Awaited<ReturnType<managedwriter.WriterClient['getWriteStream']>>;
+type TableSchema = NonNullable<WriteStreamInfo['tableSchema']>;
+type ProtoDescriptor = ConstructorParameters<typeof managedwriter.JSONWriter>[0]['protoDescriptor'];
+type RowList = Parameters<managedwriter.JSONWriter['appendRows']>[0];
+type AppendResponse = Awaited<ReturnType<ReturnType<managedwriter.JSONWriter['appendRows']>['getResult']>>;
+/** The `{ off }` disposable returned by `onConnectionError`. */
+interface ConnectionListener {
+    off(): void;
+}
+/** The connection surface the writer uses: its stream id and error hook. */
+interface WriteConnection {
+    getStreamId(): string;
+    onConnectionError(listener: (err: unknown) => void): ConnectionListener;
+}
+/** The fields of an append response that push and pushBatch read. */
+type AppendOutcome = Pick<AppendResponse, 'rowErrors' | 'appendResult'>;
+/** The row writer surface push and pushBatch use. */
+interface RowWriter {
+    appendRows(rows: RowList): {
+        getResult(): Promise<AppendOutcome>;
+    };
+    close(): void;
+}
+/** The Storage Write client surface the writer uses. */
+interface WriteClient<C extends WriteConnection> {
+    createStreamConnection(request: {
+        destinationTable: string;
+        streamId: string;
+    }): Promise<C>;
+    getWriteStream(request: WriteStreamRequest, options?: CallOptions): Promise<{
+        tableSchema?: TableSchema | null;
+    }>;
+    close(): void;
+}
+/** Converts the table schema into the writer's proto descriptor. */
+interface SchemaAdapter {
+    convertStorageSchemaToProto2Descriptor(schema: TableSchema, scope: string): ProtoDescriptor;
+}
+/**
+ * The three Storage Write pieces the writer is built from. The connection type
+ * ties a kit's client to the SAME kit's JSONWriter: the SDK JSONWriter only
+ * accepts the SDK's own StreamConnection.
+ */
+interface WriterKit<C extends WriteConnection> {
+    WriterClient: new (options: ClientOptions) => WriteClient<C>;
+    JSONWriter: new (args: {
+        connection: C;
+        protoDescriptor: ProtoDescriptor;
+    }) => RowWriter;
+    adapt: SchemaAdapter;
+}
+/**
+ * The Storage Write API pieces a destination env may inject (tests, simulate).
+ * Without `WriterClient`, each missing piece falls back to the SDK, so runtime
+ * needs none of them. An injected `WriterClient` needs an injected
+ * `JSONWriter`: its connection cannot feed the SDK writer.
+ */
+interface WriterEnv {
+    WriterClient?: WriterKit<WriteConnection>['WriterClient'];
+    JSONWriter?: WriterKit<WriteConnection>['JSONWriter'];
+    adapt?: SchemaAdapter;
 }
 
-interface Env extends DestinationServer.Env {
-    BigQuery?: typeof BigQuery;
-    WriterClient?: typeof managedwriter.WriterClient;
-    JSONWriter?: typeof managedwriter.JSONWriter;
-    adapt?: typeof _google_cloud_bigquery_storage.adapt;
-    managedwriterModule?: typeof managedwriter;
+/** Table metadata fields the setup drift check reads. */
+interface TableMetadataShape {
+    timePartitioning?: unknown;
+    clustering?: unknown;
+    schema?: unknown;
+}
+/** The table surface `walkeros setup` calls. */
+interface QueryTable {
+    exists(): Promise<[boolean, ...unknown[]]>;
+    create(options: {
+        schema: {
+            fields: SetupSchemaField[];
+        };
+        timePartitioning: {
+            type: string;
+            field: string;
+        };
+        clustering: {
+            fields: string[];
+        };
+    }): Promise<unknown>;
+    getMetadata(): Promise<TableMetadataShape[]>;
+}
+/** The dataset surface `walkeros setup` calls. */
+interface QueryDataset {
+    exists(): Promise<[boolean, ...unknown[]]>;
+    create(options: {
+        location: string;
+        storageBillingModel: string;
+    }): Promise<unknown>;
+    table(tableId: string): QueryTable;
+}
+/**
+ * The query client surface this destination calls (dataset and table
+ * provisioning). A `BigQuery` from `@google-cloud/bigquery` satisfies it.
+ */
+interface QueryClient {
+    dataset(datasetId: string): QueryDataset;
+}
+/** Single column in the BQ schema (subset of @google-cloud/bigquery's TableField). */
+interface SetupSchemaField {
+    name: string;
+    type: 'STRING' | 'JSON' | 'TIMESTAMP' | 'INT64' | 'BOOL' | 'FLOAT64';
+    mode?: 'NULLABLE' | 'REQUIRED' | 'REPEATED';
+}
+interface Env$1 extends DestinationServer.Env, WriterEnv {
+    BigQuery?: new (options?: BigQueryOptions) => QueryClient;
 }
 
 /**
  * Standard mock environment for push operations
  *
- * Use this for testing BigQuery insert operations without connecting
+ * Use this for testing BigQuery Storage Write appends without connecting
  * to actual GCP infrastructure.
  */
-declare const push: Env;
+declare const push$1: Env$1;
+/**
+ * Every row goes through the writer's `appendRows`; the writer is built from
+ * `JSONWriter` in init, so the path continues on the constructed instance.
+ * Constructors are not recorded: their arguments carry credentials.
+ */
 declare const simulation$1: string[];
 
-declare const env$1_push: typeof push;
 declare namespace env$1 {
-  export { env$1_push as push, simulation$1 as simulation };
+  export { push$1 as push, simulation$1 as simulation };
 }
 
 declare const pageView$1: Flow.StepExample;
@@ -46,25 +146,44 @@ declare namespace step$1 {
   export { pageView$1 as pageView, step$1_purchase as purchase };
 }
 
-declare namespace index$1 {
+declare namespace bigqueryExamplesNs {
   export { env$1 as env, step$1 as step };
 }
 
+/** The message `push` publishes. */
+interface PublishMessage {
+    data: Buffer;
+    attributes?: Record<string, string>;
+    orderingKey?: string;
+}
+/** The part of a Pub/Sub topic handle `push` calls. */
+interface TopicPublisher {
+    publishMessage(message: PublishMessage): Promise<string>;
+    resumePublishing(orderingKey: string): void;
+}
 /**
- * Example environment metadata for GCP Pub/Sub destination.
- *
- * Tests substitute the real SDK via `jest.mock('@google-cloud/pubsub')`,
- * which is the recommended pattern: imports of `@google-cloud/pubsub` get
- * replaced module-wide, no env-injection plumbing required at the call site.
- *
- * The `simulation` list documents which globals the destination touches
- * during a simulated run, used by the simulator to know what to stub.
+ * The part of the Pub/Sub client `init`, `push` and `destroy` call. The SDK's
+ * `PubSub` satisfies it, and so does an injected mock (tests, simulate)
+ * without a cast. `setup` needs the admin surface and uses the SDK client.
  */
+interface PubSubPublisher {
+    topic(name: string, options?: {
+        messageOrdering?: boolean;
+    }): TopicPublisher;
+    close(): Promise<void>;
+}
+interface Env extends DestinationServer.Env {
+    PubSub?: new (options?: ClientConfig) => PubSubPublisher;
+}
+
+declare const push: Env;
+/** The publish carries the request; `args[0]` is the message. */
 declare const simulation: string[];
 
+declare const env_push: typeof push;
 declare const env_simulation: typeof simulation;
 declare namespace env {
-  export { env_simulation as simulation };
+  export { env_push as push, env_simulation as simulation };
 }
 
 /**
@@ -112,12 +231,41 @@ declare namespace step {
   export { step_defaultPush as defaultPush, step_mappedAttributes as mappedAttributes, step_mappedData as mappedData, step_mappedOrderingKey as mappedOrderingKey, step_mappedTopic as mappedTopic, step_pageView as pageView };
 }
 
-declare const index_env: typeof env;
-declare const index_step: typeof step;
-declare namespace index {
-  export { index_env as env, index_step as step };
+declare const pubsubExamplesNs_env: typeof env;
+declare const pubsubExamplesNs_step: typeof step;
+declare namespace pubsubExamplesNs {
+  export { pubsubExamplesNs_env as env, pubsubExamplesNs_step as step };
+}
+
+declare const settings$1: _walkeros_core_dev.JSONSchema;
+declare const mapping$1: _walkeros_core_dev.JSONSchema;
+
+declare const settings: _walkeros_core_dev.JSONSchema;
+declare const mapping: _walkeros_core_dev.JSONSchema;
+declare const setup: _walkeros_core_dev.JSONSchema;
+
+declare namespace schemas {
+  export { mapping$1 as mapping, mapping as pubsubMapping, settings as pubsubSettings, setup as pubsubSetup, settings$1 as settings };
 }
 
 declare const hints: Hint.Hints;
 
-export { index$1 as examples, hints, index as pubsubExamples, schemas };
+/** Dev examples per export, keyed by the export names in package.json. */
+declare const exportExamples: {
+    destinationBigQuery: typeof bigqueryExamplesNs;
+    destinationPubSub: typeof pubsubExamplesNs;
+};
+/** Schemas per export, keyed by the export names in package.json. */
+declare const exportSchemas: {
+    destinationBigQuery: {
+        settings: _walkeros_core_dev.JSONSchema;
+        mapping: _walkeros_core_dev.JSONSchema;
+    };
+    destinationPubSub: {
+        settings: _walkeros_core_dev.JSONSchema;
+        mapping: _walkeros_core_dev.JSONSchema;
+        setup: _walkeros_core_dev.JSONSchema;
+    };
+};
+
+export { bigqueryExamplesNs as examples, exportExamples, exportSchemas, hints, pubsubExamplesNs as pubsubExamples, schemas };

package/dist/dev.d.ts

@@ -1,41 +1,141 @@
 import * as _walkeros_core_dev from '@walkeros/core/dev';
-import * as _google_cloud_bigquery_storage from '@google-cloud/bigquery-storage';
-import { managedwriter } from '@google-cloud/bigquery-storage';
 import { DestinationServer } from '@walkeros/server-core';
-import { BigQuery } from '@google-cloud/bigquery';
+import { BigQueryOptions } from '@google-cloud/bigquery';
+import { managedwriter } from '@google-cloud/bigquery-storage';
 import { Flow, Hint } from '@walkeros/core';
+import { ClientConfig } from '@google-cloud/pubsub';
 
-declare const settings$1: _walkeros_core_dev.JSONSchema;
-declare const mapping$1: _walkeros_core_dev.JSONSchema;
-
-declare const settings: _walkeros_core_dev.JSONSchema;
-declare const mapping: _walkeros_core_dev.JSONSchema;
-declare const setup: _walkeros_core_dev.JSONSchema;
-
-declare namespace schemas {
-  export { mapping$1 as mapping, mapping as pubsubMapping, settings as pubsubSettings, setup as pubsubSetup, settings$1 as settings };
+type CallOptions = NonNullable<Parameters<managedwriter.WriterClient['getWriteStream']>[1]>;
+type ClientOptions = NonNullable<ConstructorParameters<typeof managedwriter.WriterClient>[0]>;
+type WriteStreamRequest = Parameters<managedwriter.WriterClient['getWriteStream']>[0];
+type WriteStreamInfo = Awaited<ReturnType<managedwriter.WriterClient['getWriteStream']>>;
+type TableSchema = NonNullable<WriteStreamInfo['tableSchema']>;
+type ProtoDescriptor = ConstructorParameters<typeof managedwriter.JSONWriter>[0]['protoDescriptor'];
+type RowList = Parameters<managedwriter.JSONWriter['appendRows']>[0];
+type AppendResponse = Awaited<ReturnType<ReturnType<managedwriter.JSONWriter['appendRows']>['getResult']>>;
+/** The `{ off }` disposable returned by `onConnectionError`. */
+interface ConnectionListener {
+    off(): void;
+}
+/** The connection surface the writer uses: its stream id and error hook. */
+interface WriteConnection {
+    getStreamId(): string;
+    onConnectionError(listener: (err: unknown) => void): ConnectionListener;
+}
+/** The fields of an append response that push and pushBatch read. */
+type AppendOutcome = Pick<AppendResponse, 'rowErrors' | 'appendResult'>;
+/** The row writer surface push and pushBatch use. */
+interface RowWriter {
+    appendRows(rows: RowList): {
+        getResult(): Promise<AppendOutcome>;
+    };
+    close(): void;
+}
+/** The Storage Write client surface the writer uses. */
+interface WriteClient<C extends WriteConnection> {
+    createStreamConnection(request: {
+        destinationTable: string;
+        streamId: string;
+    }): Promise<C>;
+    getWriteStream(request: WriteStreamRequest, options?: CallOptions): Promise<{
+        tableSchema?: TableSchema | null;
+    }>;
+    close(): void;
+}
+/** Converts the table schema into the writer's proto descriptor. */
+interface SchemaAdapter {
+    convertStorageSchemaToProto2Descriptor(schema: TableSchema, scope: string): ProtoDescriptor;
+}
+/**
+ * The three Storage Write pieces the writer is built from. The connection type
+ * ties a kit's client to the SAME kit's JSONWriter: the SDK JSONWriter only
+ * accepts the SDK's own StreamConnection.
+ */
+interface WriterKit<C extends WriteConnection> {
+    WriterClient: new (options: ClientOptions) => WriteClient<C>;
+    JSONWriter: new (args: {
+        connection: C;
+        protoDescriptor: ProtoDescriptor;
+    }) => RowWriter;
+    adapt: SchemaAdapter;
+}
+/**
+ * The Storage Write API pieces a destination env may inject (tests, simulate).
+ * Without `WriterClient`, each missing piece falls back to the SDK, so runtime
+ * needs none of them. An injected `WriterClient` needs an injected
+ * `JSONWriter`: its connection cannot feed the SDK writer.
+ */
+interface WriterEnv {
+    WriterClient?: WriterKit<WriteConnection>['WriterClient'];
+    JSONWriter?: WriterKit<WriteConnection>['JSONWriter'];
+    adapt?: SchemaAdapter;
 }
 
-interface Env extends DestinationServer.Env {
-    BigQuery?: typeof BigQuery;
-    WriterClient?: typeof managedwriter.WriterClient;
-    JSONWriter?: typeof managedwriter.JSONWriter;
-    adapt?: typeof _google_cloud_bigquery_storage.adapt;
-    managedwriterModule?: typeof managedwriter;
+/** Table metadata fields the setup drift check reads. */
+interface TableMetadataShape {
+    timePartitioning?: unknown;
+    clustering?: unknown;
+    schema?: unknown;
+}
+/** The table surface `walkeros setup` calls. */
+interface QueryTable {
+    exists(): Promise<[boolean, ...unknown[]]>;
+    create(options: {
+        schema: {
+            fields: SetupSchemaField[];
+        };
+        timePartitioning: {
+            type: string;
+            field: string;
+        };
+        clustering: {
+            fields: string[];
+        };
+    }): Promise<unknown>;
+    getMetadata(): Promise<TableMetadataShape[]>;
+}
+/** The dataset surface `walkeros setup` calls. */
+interface QueryDataset {
+    exists(): Promise<[boolean, ...unknown[]]>;
+    create(options: {
+        location: string;
+        storageBillingModel: string;
+    }): Promise<unknown>;
+    table(tableId: string): QueryTable;
+}
+/**
+ * The query client surface this destination calls (dataset and table
+ * provisioning). A `BigQuery` from `@google-cloud/bigquery` satisfies it.
+ */
+interface QueryClient {
+    dataset(datasetId: string): QueryDataset;
+}
+/** Single column in the BQ schema (subset of @google-cloud/bigquery's TableField). */
+interface SetupSchemaField {
+    name: string;
+    type: 'STRING' | 'JSON' | 'TIMESTAMP' | 'INT64' | 'BOOL' | 'FLOAT64';
+    mode?: 'NULLABLE' | 'REQUIRED' | 'REPEATED';
+}
+interface Env$1 extends DestinationServer.Env, WriterEnv {
+    BigQuery?: new (options?: BigQueryOptions) => QueryClient;
 }
 
 /**
  * Standard mock environment for push operations
  *
- * Use this for testing BigQuery insert operations without connecting
+ * Use this for testing BigQuery Storage Write appends without connecting
  * to actual GCP infrastructure.
  */
-declare const push: Env;
+declare const push$1: Env$1;
+/**
+ * Every row goes through the writer's `appendRows`; the writer is built from
+ * `JSONWriter` in init, so the path continues on the constructed instance.
+ * Constructors are not recorded: their arguments carry credentials.
+ */
 declare const simulation$1: string[];
 
-declare const env$1_push: typeof push;
 declare namespace env$1 {
-  export { env$1_push as push, simulation$1 as simulation };
+  export { push$1 as push, simulation$1 as simulation };
 }
 
 declare const pageView$1: Flow.StepExample;
@@ -46,25 +146,44 @@ declare namespace step$1 {
   export { pageView$1 as pageView, step$1_purchase as purchase };
 }
 
-declare namespace index$1 {
+declare namespace bigqueryExamplesNs {
   export { env$1 as env, step$1 as step };
 }
 
+/** The message `push` publishes. */
+interface PublishMessage {
+    data: Buffer;
+    attributes?: Record<string, string>;
+    orderingKey?: string;
+}
+/** The part of a Pub/Sub topic handle `push` calls. */
+interface TopicPublisher {
+    publishMessage(message: PublishMessage): Promise<string>;
+    resumePublishing(orderingKey: string): void;
+}
 /**
- * Example environment metadata for GCP Pub/Sub destination.
- *
- * Tests substitute the real SDK via `jest.mock('@google-cloud/pubsub')`,
- * which is the recommended pattern: imports of `@google-cloud/pubsub` get
- * replaced module-wide, no env-injection plumbing required at the call site.
- *
- * The `simulation` list documents which globals the destination touches
- * during a simulated run, used by the simulator to know what to stub.
+ * The part of the Pub/Sub client `init`, `push` and `destroy` call. The SDK's
+ * `PubSub` satisfies it, and so does an injected mock (tests, simulate)
+ * without a cast. `setup` needs the admin surface and uses the SDK client.
  */
+interface PubSubPublisher {
+    topic(name: string, options?: {
+        messageOrdering?: boolean;
+    }): TopicPublisher;
+    close(): Promise<void>;
+}
+interface Env extends DestinationServer.Env {
+    PubSub?: new (options?: ClientConfig) => PubSubPublisher;
+}
+
+declare const push: Env;
+/** The publish carries the request; `args[0]` is the message. */
 declare const simulation: string[];
 
+declare const env_push: typeof push;
 declare const env_simulation: typeof simulation;
 declare namespace env {
-  export { env_simulation as simulation };
+  export { env_push as push, env_simulation as simulation };
 }
 
 /**
@@ -112,12 +231,41 @@ declare namespace step {
   export { step_defaultPush as defaultPush, step_mappedAttributes as mappedAttributes, step_mappedData as mappedData, step_mappedOrderingKey as mappedOrderingKey, step_mappedTopic as mappedTopic, step_pageView as pageView };
 }
 
-declare const index_env: typeof env;
-declare const index_step: typeof step;
-declare namespace index {
-  export { index_env as env, index_step as step };
+declare const pubsubExamplesNs_env: typeof env;
+declare const pubsubExamplesNs_step: typeof step;
+declare namespace pubsubExamplesNs {
+  export { pubsubExamplesNs_env as env, pubsubExamplesNs_step as step };
+}
+
+declare const settings$1: _walkeros_core_dev.JSONSchema;
+declare const mapping$1: _walkeros_core_dev.JSONSchema;
+
+declare const settings: _walkeros_core_dev.JSONSchema;
+declare const mapping: _walkeros_core_dev.JSONSchema;
+declare const setup: _walkeros_core_dev.JSONSchema;
+
+declare namespace schemas {
+  export { mapping$1 as mapping, mapping as pubsubMapping, settings as pubsubSettings, setup as pubsubSetup, settings$1 as settings };
 }
 
 declare const hints: Hint.Hints;
 
-export { index$1 as examples, hints, index as pubsubExamples, schemas };
+/** Dev examples per export, keyed by the export names in package.json. */
+declare const exportExamples: {
+    destinationBigQuery: typeof bigqueryExamplesNs;
+    destinationPubSub: typeof pubsubExamplesNs;
+};
+/** Schemas per export, keyed by the export names in package.json. */
+declare const exportSchemas: {
+    destinationBigQuery: {
+        settings: _walkeros_core_dev.JSONSchema;
+        mapping: _walkeros_core_dev.JSONSchema;
+    };
+    destinationPubSub: {
+        settings: _walkeros_core_dev.JSONSchema;
+        mapping: _walkeros_core_dev.JSONSchema;
+        setup: _walkeros_core_dev.JSONSchema;
+    };
+};
+
+export { bigqueryExamplesNs as examples, exportExamples, exportSchemas, hints, pubsubExamplesNs as pubsubExamples, schemas };

package/dist/dev.js

@@ -1 +1 @@
-"use strict";var e,t=Object.defineProperty,r=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,s=Object.prototype.hasOwnProperty,o=(e,r)=>{for(var i in r)t(e,i,{get:r[i],enumerable:!0})},a={};o(a,{examples:()=>O,hints:()=>ne,pubsubExamples:()=>L,schemas:()=>n}),module.exports=(e=a,((e,o,a,n)=>{if(o&&"object"==typeof o||"function"==typeof o)for(let l of i(o))s.call(e,l)||l===a||t(e,l,{get:()=>o[l],enumerable:!(n=r(o,l))||n.enumerable});return e})(t({},"__esModule",{value:!0}),e));var n={};o(n,{mapping:()=>g,pubsubMapping:()=>k,pubsubSettings:()=>w,pubsubSetup:()=>j,settings:()=>p});var l=require("@walkeros/core/dev"),c=require("@walkeros/core/dev"),u=c.z.object({client:c.z.any().describe("Google Cloud BigQuery client instance (like new BigQuery({ projectId, keyFilename }))").optional(),projectId:c.z.string().min(1).describe("Google Cloud Project ID (like my-gcp-project)"),datasetId:c.z.string().min(1).default("walkerOS").describe("BigQuery dataset ID where events will be stored (like walker_events)"),tableId:c.z.string().min(1).default("events").describe("BigQuery table ID for event storage (like events)"),location:c.z.string().default("EU").describe("Geographic location for the BigQuery dataset (like US)"),bigquery:c.z.any().describe('Additional BigQuery client configuration options (like { keyFilename: "path/to/key.json" })').optional()}),d=require("@walkeros/core/dev").z.object({}),p=(0,l.zodToSchema)(u),g=(0,l.zodToSchema)(d),m=require("@walkeros/core/dev"),b=require("@walkeros/core/dev"),h=b.z.object({client:b.z.any().describe("Google Cloud Pub/Sub client instance (like new PubSub({ projectId, keyFilename }))").optional(),projectId:b.z.string().min(1).describe("Google Cloud Project ID (like my-gcp-project)"),topic:b.z.string().min(1).describe("Pub/Sub topic short name (like events). The full resource name projects/<projectId>/topics/<topic> is built by the SDK."),credentials:b.z.any().describe("Service account credentials as a JSON string or an object with client_email and private_key. Default: Application Default Credentials (ADC). (deprecated: use config.credentials)").optional(),apiEndpoint:b.z.string().describe("Override Pub/Sub API endpoint. Useful for the local emulator (like localhost:8085).").optional(),orderingKey:b.z.any().describe("Mapping value resolved per-event. Truthy enables per-key ordering for the publish.").optional(),attributes:b.z.any().describe("Default per-event attribute map merged into every published message. Mapping.Map shape.").optional()}),y=require("@walkeros/core/dev"),v=y.z.object({topic:y.z.string().describe("Per-rule topic override. Falls back to settings.topic if absent.").optional(),orderingKey:y.z.any().describe("Per-rule ordering-key Mapping.Value. Overrides settings.orderingKey when set.").optional(),attributes:y.z.any().describe("Per-rule attribute Mapping.Map merged on top of settings.attributes.").optional()}),f=require("@walkeros/core/dev"),S=f.z.object({messageStoragePolicy:f.z.object({allowedPersistenceRegions:f.z.array(f.z.string()).describe("Geographic regions for at-rest message storage. Default: EU multi-region (eu-west1, eu-west3, eu-west4).")}).describe("Topic-level message storage policy.").optional(),messageRetentionDuration:f.z.object({seconds:f.z.number().describe("Retention window in seconds. Default: project default.")}).describe("Topic-level retention configuration.").optional(),kmsKeyName:f.z.string().describe("Customer-managed encryption key (CMEK) resource name. Optional.").optional(),labels:f.z.record(f.z.string(),f.z.string()).describe("Topic labels for organization and billing.").optional()}),w=(0,m.zodToSchema)(h),k=(0,m.zodToSchema)(v),j=(0,m.zodToSchema)(S),O={};o(O,{env:()=>z,step:()=>W});var z={};o(z,{push:()=>q,simulation:()=>M});var A=require("events"),C=[],P=null,D=null,E=null,T=null,I=class extends A.EventEmitter{streamId;constructor(e){super(),this.streamId=e}getStreamId(){return this.streamId}onConnectionError(e){return C.push({method:"onConnectionError",args:[]}),this.on("error",e),{off:()=>{this.off("error",e)}}}__emitConnectionError(e){this.emit("error",e)}},N=[],R={convertStorageSchemaToProto2Descriptor:(e,t)=>(C.push({method:"adapt.convertStorageSchemaToProto2Descriptor",args:[e,t]}),{name:"root",field:[]})},x={WriterClient:class{constructor(e){C.push({method:"WriterClient.ctor",args:[e]})}async createStreamConnection(e,t){if("DEFAULT"!==e.streamId)throw new Error(`mock createStreamConnection: expected streamId='DEFAULT', got ${JSON.stringify(e)}`);C.push({method:"createStreamConnection",args:[e,t]});const r=T;if(null!==r)throw T=null,r;const i=new I(`${e.destinationTable}/streams/_default`);return N.push(i),i}async getWriteStream(e,t){return C.push({method:"getWriteStream",args:[e,t]}),{tableSchema:{fields:[]}}}close(){C.push({method:"WriterClient.close",args:[]})}},JSONWriter:class{constructor(e){C.push({method:"JSONWriter.ctor",args:[e]})}appendRows(e,t){C.push({method:"appendRows",args:[e,t]});const r=D;if(null!==r)throw D=null,r;const i=P;P=null;const s=E;return E=null,{getResult:async()=>{if(null!==s)throw s;return{appendResult:{offset:{value:"0"}},rowErrors:i??[],writeStream:"projects/p/datasets/d/tables/t/streams/_default"}}}}close(){C.push({method:"JSONWriter.close",args:[]})}},DefaultStream:"DEFAULT"},J=()=>{};var q={get BigQuery(){return class{calls;options;constructor(e){this.options=e,this.calls=[]}dataset(e){return this.calls.push({method:"dataset",args:[e]}),this}table(e){return this.calls.push({method:"table",args:[e]}),this}async insert(e){return this.calls.push({method:"insert",args:[e]}),Promise.resolve()}get mockFn(){return J}}},get WriterClient(){return x.WriterClient},get JSONWriter(){return x.JSONWriter},get adapt(){return R},get managedwriterModule(){return x}},M=["BigQuery","WriterClient","JSONWriter","adapt"],W={};o(W,{pageView:()=>U,purchase:()=>G});var B=require("@walkeros/core");function _(e){return null==e?null:"object"==typeof e?Array.isArray(e)&&0===e.length?null:Array.isArray(e)||0!==Object.keys(e).length?JSON.stringify(e):null:JSON.stringify(e)}function Q(e){return function(e){return{name:e.name,data:_(e.data),context:_(e.context),globals:_(e.globals),custom:_(e.custom),user:_(e.user),nested:_(e.nested),consent:_(e.consent),id:e.id,trigger:e.trigger,entity:e.entity,action:e.action,timestamp:1e3*new Date(e.timestamp).getTime(),timing:e.timing,source:_(e.source)}}(e)}var F=(0,B.getEvent)("page view",{timestamp:1700001100,data:{title:"Documentation",url:"https://example.com/docs"},source:{type:"express",platform:"server"}}),U={title:"Page view",description:"A page view is appended as one row through the BigQuery Storage Write API JSONWriter. Nested objects/arrays in data, source, etc. are JSON-stringified by eventToRow.",in:F,mapping:void 0,out:[["appendRows",[Q(F)]]]},K=(0,B.getEvent)("order complete",{timestamp:1700001101,data:{id:"ORD-500",total:199.99,items:[{sku:"SKU-1",qty:2}]},source:{type:"express",platform:"server"}}),G={title:"Purchase",description:"An order event is appended as a single row through JSONWriter.appendRows. The entire nested data object (including arrays like items) is JSON-stringified into the data column via eventToRow().",in:K,mapping:void 0,out:[["appendRows",[Q(K)]]]},L={};o(L,{env:()=>V,step:()=>X});var V={};o(V,{simulation:()=>$});var $=["PubSub"],X={};o(X,{defaultPush:()=>te,mappedAttributes:()=>se,mappedData:()=>oe,mappedOrderingKey:()=>ie,mappedTopic:()=>re,pageView:()=>ae});var H=require("@walkeros/core"),Y=(0,H.getEvent)("order complete",{timestamp:1700001100,data:{id:"ORD-500",total:199.99,currency:"EUR"},user:{id:"usr-789"},source:{type:"express",platform:"server",trace:"1a2b3c4d5e6f70819a2b3c4d5e6f7081",count:1}}),Z=(0,H.getEvent)("page view",{timestamp:1700001101,data:{title:"Documentation",url:"https://example.com/docs"},source:{type:"express",platform:"server",trace:"9f8e7d6c5b4a39281706f5e4d3c2b1a0",count:1}});function ee(e){const t=e.source.platform??"default",r={...e,source:{...e.source,release:{[t]:"4.7.0-next-1790245733116"}}};return Buffer.from(JSON.stringify(r))}var te={title:"Default publish",description:"An event is published to the configured Pub/Sub topic with the full JSON event as the message body and no ordering key.",in:Y,out:[["topic","events",{messageOrdering:!1}],["publishMessage","events",{data:ee(Y)}]]},re={title:"Topic override",description:"A mapping rule overrides the destination default topic so order events are published to a dedicated topic.",in:Y,mapping:{settings:{topic:"orders"}},out:[["topic","orders",{messageOrdering:!1}],["publishMessage","orders",{data:ee(Y)}]]},ie={title:"Ordering key from user",description:"A mapping resolves the ordering key from event.user.id, enabling per-user ordering for this publish.",in:Y,mapping:{settings:{orderingKey:"user.id"}},out:[["topic","events",{messageOrdering:!0}],["publishMessage","events",{data:ee(Y),orderingKey:"usr-789"}]]},se={title:"Mapped attributes",description:"A mapping resolves a per-event attribute map, here exposing entity and action as Pub/Sub attributes for routing in subscribers.",in:Y,mapping:{settings:{attributes:{entity:"entity",action:"action"}}},out:[["topic","events",{messageOrdering:!1}],["publishMessage","events",{data:ee(Y),attributes:{entity:"order",action:"complete"}}]]},oe={title:"Mapped payload",description:"A data mapping transforms the event payload before publish. The rewritten object becomes the Pub/Sub message body.",in:Y,mapping:{data:{map:{order_id:"data.id",revenue:"data.total",currency:"data.currency"}}},out:[["topic","events",{messageOrdering:!1}],["publishMessage","events",{data:Buffer.from(JSON.stringify({order_id:"ORD-500",revenue:199.99,currency:"EUR"}))}]]},ae={title:"Page view",description:"A page view is published to the default topic with no ordering key, demonstrating the simplest publish path.",in:Z,out:[["topic","events",{messageOrdering:!1}],["publishMessage","events",{data:ee(Z)}]]},ne={"auth-methods":{text:'Supports three auth methods: SA key file via bigquery options ({ bigquery: { keyFilename: "./sa.json" } }), Application Default Credentials (automatic on GCP infrastructure — just provide projectId), or a pre-configured BigQuery client instance (client option). See settings schema for all options.',code:[{lang:"json",code:'{ "settings": { "projectId": "my-project", "bigquery": { "keyFilename": "./sa.json" } } }'},{lang:"json",code:'{ "settings": { "projectId": "my-project" } }'}]},"storage-format":{text:'All events are stored in a single table. Scalar fields (strings, numbers, booleans) are stored as-is. Nested objects and arrays are JSON-stringified automatically. Defaults: dataset "walkeros", table "events", location "EU" — all overridable via settings.'},"query-json-columns":{text:"Nested event fields (data, context, globals, user) are stored as JSON strings. Use BigQuery JSON_EXTRACT_SCALAR to query them. Field paths follow the walkerOS event structure.",code:[{lang:"sql",code:"SELECT JSON_EXTRACT_SCALAR(data, '$.total') AS total FROM `project.walkeros.events` WHERE entity = 'order'"}]},"troubleshoot-empty-table":{text:"Events not appearing? Common causes: projectId doesn't match GCP project, dataset doesn't exist yet (create via BigQuery console or bq CLI before first push), or SA key lacks bigquery.dataEditor role. The destination validates client/datasetId/tableId at push time but GCP permission errors surface from the BigQuery SDK."}};//# sourceMappingURL=dev.js.map
+"use strict";var e,t=Object.defineProperty,r=Object.getOwnPropertyDescriptor,s=Object.getOwnPropertyNames,i=Object.prototype.hasOwnProperty,o=(e,r)=>{for(var s in r)t(e,s,{get:r[s],enumerable:!0})},a={};o(a,{examples:()=>n,exportExamples:()=>ue,exportSchemas:()=>pe,hints:()=>ce,pubsubExamples:()=>D,schemas:()=>le}),module.exports=(e=a,((e,o,a,n)=>{if(o&&"object"==typeof o||"function"==typeof o)for(let l of s(o))i.call(e,l)||l===a||t(e,l,{get:()=>o[l],enumerable:!(n=r(o,l))||n.enumerable});return e})(t({},"__esModule",{value:!0}),e));var n={};o(n,{env:()=>l,step:()=>k});var l={};o(l,{push:()=>S,simulation:()=>w});var c=require("events"),u=[],p=null,d=null,g=null,m=null,b=class extends c.EventEmitter{streamId;constructor(e){super(),this.streamId=e}getStreamId(){return this.streamId}onConnectionError(e){return u.push({method:"onConnectionError",args:[]}),this.on("error",e),{off:()=>{this.off("error",e)}}}__emitConnectionError(e){this.emit("error",e)}},h=[],y={convertStorageSchemaToProto2Descriptor:(e,t)=>(u.push({method:"adapt.convertStorageSchemaToProto2Descriptor",args:[e,t]}),{name:"root",field:[]})},v=class{constructor(e){u.push({method:"WriterClient.ctor",args:[e]})}async createStreamConnection(e,t){if("DEFAULT"!==e.streamId)throw new Error(`mock createStreamConnection: expected streamId='DEFAULT', got ${JSON.stringify(e)}`);u.push({method:"createStreamConnection",args:[e,t]});const r=m;if(null!==r)throw m=null,r;const s=new b(`${e.destinationTable}/streams/_default`);return h.push(s),s}async getWriteStream(e,t){return u.push({method:"getWriteStream",args:[e,t]}),{tableSchema:{fields:[]}}}close(){u.push({method:"WriterClient.close",args:[]})}},f=class{constructor(e){u.push({method:"JSONWriter.ctor",args:[e]})}appendRows(e,t){u.push({method:"appendRows",args:[e,t]});const r=d;if(null!==r)throw d=null,r;const s=p;p=null;const i=g;return g=null,{getResult:async()=>{if(null!==i)throw i;return{appendResult:{offset:{value:"0"}},rowErrors:s??[],writeStream:"projects/p/datasets/d/tables/t/streams/_default"}}}}close(){u.push({method:"JSONWriter.close",args:[]})}};var S={get BigQuery(){return class{calls;options;constructor(e){this.options=e,this.calls=[]}dataset(e){return this.calls.push({method:"dataset",args:[e]}),this}table(e){return this.calls.push({method:"table",args:[e]}),this}async exists(){return this.calls.push({method:"exists",args:[]}),[!0]}async create(e){this.calls.push({method:"create",args:[e]})}async getMetadata(){return this.calls.push({method:"getMetadata",args:[]}),[{}]}}},get WriterClient(){return v},get JSONWriter(){return f},get adapt(){return y}},w=["call:JSONWriter.appendRows"],k={};o(k,{pageView:()=>A,purchase:()=>C});var j=require("@walkeros/core");function O(e){return null==e?null:"object"==typeof e?Array.isArray(e)&&0===e.length?null:Array.isArray(e)||0!==Object.keys(e).length?JSON.stringify(e):null:JSON.stringify(e)}function z(e){return function(e){return{name:e.name,data:O(e.data),context:O(e.context),globals:O(e.globals),custom:O(e.custom),user:O(e.user),nested:O(e.nested),consent:O(e.consent),id:e.id,trigger:e.trigger,entity:e.entity,action:e.action,timestamp:1e3*new Date(e.timestamp).getTime(),timing:e.timing,source:O(e.source)}}(e)}var P=(0,j.getEvent)("page view",{timestamp:1700001100,data:{title:"Documentation",url:"https://example.com/docs"},source:{type:"express",platform:"server"}}),A={title:"Page view",description:"A page view is appended as one row through the BigQuery Storage Write API JSONWriter. Nested objects/arrays in data, source, etc. are JSON-stringified by eventToRow.",in:P,mapping:void 0,out:[["appendRows",[z(P)]]]},E=(0,j.getEvent)("order complete",{timestamp:1700001101,data:{id:"ORD-500",total:199.99,items:[{sku:"SKU-1",qty:2}]},source:{type:"express",platform:"server"}}),C={title:"Purchase",description:"An order event is appended as a single row through JSONWriter.appendRows. The entire nested data object (including arrays like items) is JSON-stringified into the data column via eventToRow().",in:E,mapping:void 0,out:[["appendRows",[z(E)]]]},D={};o(D,{env:()=>T,step:()=>R});var T={};o(T,{push:()=>x,simulation:()=>N});var I=class{constructor(e){this.name=e}name;publishMessage(e){return Promise.resolve("mock-message-id")}resumePublishing(e){}},x={PubSub:class{constructor(e){this.options=e}options;topic(e){return new I(e)}close(){return Promise.resolve()}}},N=["call:PubSub.topic.publishMessage"],R={};o(R,{defaultPush:()=>_,mappedAttributes:()=>K,mappedData:()=>U,mappedOrderingKey:()=>W,mappedTopic:()=>Q,pageView:()=>F});var M=require("@walkeros/core"),q=(0,M.getEvent)("order complete",{timestamp:1700001100,data:{id:"ORD-500",total:199.99,currency:"EUR"},user:{id:"usr-789"},source:{type:"express",platform:"server",trace:"1a2b3c4d5e6f70819a2b3c4d5e6f7081",count:1}}),J=(0,M.getEvent)("page view",{timestamp:1700001101,data:{title:"Documentation",url:"https://example.com/docs"},source:{type:"express",platform:"server",trace:"9f8e7d6c5b4a39281706f5e4d3c2b1a0",count:1}});function B(e){const t=e.source.platform??"default",r={...e,source:{...e.source,release:{[t]:"4.7.0"}}};return Buffer.from(JSON.stringify(r))}var _={title:"Default publish",description:"An event is published to the configured Pub/Sub topic with the full JSON event as the message body and no ordering key.",in:q,out:[["topic","events",{messageOrdering:!1}],["publishMessage","events",{data:B(q)}]]},Q={title:"Topic override",description:"A mapping rule overrides the destination default topic so order events are published to a dedicated topic.",in:q,mapping:{settings:{topic:"orders"}},out:[["topic","orders",{messageOrdering:!1}],["publishMessage","orders",{data:B(q)}]]},W={title:"Ordering key from user",description:"A mapping resolves the ordering key from event.user.id, enabling per-user ordering for this publish.",in:q,mapping:{settings:{orderingKey:"user.id"}},out:[["topic","events",{messageOrdering:!0}],["publishMessage","events",{data:B(q),orderingKey:"usr-789"}]]},K={title:"Mapped attributes",description:"A mapping resolves a per-event attribute map, here exposing entity and action as Pub/Sub attributes for routing in subscribers.",in:q,mapping:{settings:{attributes:{entity:"entity",action:"action"}}},out:[["topic","events",{messageOrdering:!1}],["publishMessage","events",{data:B(q),attributes:{entity:"order",action:"complete"}}]]},U={title:"Mapped payload",description:"A data mapping transforms the event payload before publish. The rewritten object becomes the Pub/Sub message body.",in:q,mapping:{data:{map:{order_id:"data.id",revenue:"data.total",currency:"data.currency"}}},out:[["topic","events",{messageOrdering:!1}],["publishMessage","events",{data:Buffer.from(JSON.stringify({order_id:"ORD-500",revenue:199.99,currency:"EUR"}))}]]},F={title:"Page view",description:"A page view is published to the default topic with no ordering key, demonstrating the simplest publish path.",in:J,out:[["topic","events",{messageOrdering:!1}],["publishMessage","events",{data:B(J)}]]},G=require("@walkeros/core/dev"),L=require("@walkeros/core/dev"),V=L.z.object({client:L.z.any().describe("Google Cloud BigQuery client instance (like new BigQuery({ projectId, keyFilename }))").optional(),projectId:L.z.string().min(1).describe("Google Cloud Project ID (like my-gcp-project)"),datasetId:L.z.string().min(1).default("walkerOS").describe("BigQuery dataset ID where events will be stored (like walker_events)"),tableId:L.z.string().min(1).default("events").describe("BigQuery table ID for event storage (like events)"),location:L.z.string().default("EU").describe("Geographic location for the BigQuery dataset (like US)"),bigquery:L.z.any().describe('Additional BigQuery client configuration options (like { keyFilename: "path/to/key.json" })').optional()}),$=require("@walkeros/core/dev").z.object({}),X=(0,G.zodToSchema)(V),H=(0,G.zodToSchema)($),Y=require("@walkeros/core/dev"),Z=require("@walkeros/core/dev"),ee=Z.z.object({client:Z.z.any().describe("Google Cloud Pub/Sub client instance (like new PubSub({ projectId, keyFilename }))").optional(),projectId:Z.z.string().min(1).describe("Google Cloud Project ID (like my-gcp-project)"),topic:Z.z.string().min(1).describe("Pub/Sub topic short name (like events). The full resource name projects/<projectId>/topics/<topic> is built by the SDK."),credentials:Z.z.any().describe("Service account credentials as a JSON string or an object with client_email and private_key. Default: Application Default Credentials (ADC). (deprecated: use config.credentials)").optional(),apiEndpoint:Z.z.string().describe("Override Pub/Sub API endpoint. Useful for the local emulator (like localhost:8085).").optional(),orderingKey:Z.z.any().describe("Mapping value resolved per-event. Truthy enables per-key ordering for the publish.").optional(),attributes:Z.z.any().describe("Default per-event attribute map merged into every published message. Mapping.Map shape.").optional()}),te=require("@walkeros/core/dev"),re=te.z.object({topic:te.z.string().describe("Per-rule topic override. Falls back to settings.topic if absent.").optional(),orderingKey:te.z.any().describe("Per-rule ordering-key Mapping.Value. Overrides settings.orderingKey when set.").optional(),attributes:te.z.any().describe("Per-rule attribute Mapping.Map merged on top of settings.attributes.").optional()}),se=require("@walkeros/core/dev"),ie=se.z.object({messageStoragePolicy:se.z.object({allowedPersistenceRegions:se.z.array(se.z.string()).describe("Geographic regions for at-rest message storage. Default: EU multi-region (eu-west1, eu-west3, eu-west4).")}).describe("Topic-level message storage policy.").optional(),messageRetentionDuration:se.z.object({seconds:se.z.number().describe("Retention window in seconds. Default: project default.")}).describe("Topic-level retention configuration.").optional(),kmsKeyName:se.z.string().describe("Customer-managed encryption key (CMEK) resource name. Optional.").optional(),labels:se.z.record(se.z.string(),se.z.string()).describe("Topic labels for organization and billing.").optional()}),oe=(0,Y.zodToSchema)(ee),ae=(0,Y.zodToSchema)(re),ne=(0,Y.zodToSchema)(ie),le={};o(le,{mapping:()=>H,pubsubMapping:()=>ae,pubsubSettings:()=>oe,pubsubSetup:()=>ne,settings:()=>X});var ce={"auth-methods":{text:'Supports three auth methods: SA key file via bigquery options ({ bigquery: { keyFilename: "./sa.json" } }), Application Default Credentials (automatic on GCP infrastructure — just provide projectId), or a pre-configured BigQuery client instance (client option). See settings schema for all options.',code:[{lang:"json",code:'{ "settings": { "projectId": "my-project", "bigquery": { "keyFilename": "./sa.json" } } }'},{lang:"json",code:'{ "settings": { "projectId": "my-project" } }'}]},"storage-format":{text:'All events are stored in a single table. Scalar fields (strings, numbers, booleans) are stored as-is. Nested objects and arrays are JSON-stringified automatically. Defaults: dataset "walkeros", table "events", location "EU" — all overridable via settings.'},"query-json-columns":{text:"Nested event fields (data, context, globals, user) are stored as JSON strings. Use BigQuery JSON_EXTRACT_SCALAR to query them. Field paths follow the walkerOS event structure.",code:[{lang:"sql",code:"SELECT JSON_EXTRACT_SCALAR(data, '$.total') AS total FROM `project.walkeros.events` WHERE entity = 'order'"}]},"troubleshoot-empty-table":{text:"Events not appearing? Common causes: projectId doesn't match GCP project, dataset doesn't exist yet (create via BigQuery console or bq CLI before first push), or SA key lacks bigquery.dataEditor role. The destination validates client/datasetId/tableId at push time but GCP permission errors surface from the BigQuery SDK."}},ue={destinationBigQuery:n,destinationPubSub:D},pe={destinationBigQuery:{settings:X,mapping:H},destinationPubSub:{settings:oe,mapping:ae,setup:ne}};//# sourceMappingURL=dev.js.map