@marketrix.ai/widget 3.8.359 → 3.8.362

package/README.md

@@ -50,7 +50,7 @@ await mountWidget({
 });
 ```
 
-`mountWidget` auto-detects the credential mode (production / dev / preview) from the config you pass.
+`mountWidget` auto-detects the credential mode (production / preview) from the config you pass.
 
 ---
 
@@ -136,7 +136,7 @@ import {
 
 ### `mountWidget(config): Promise<void>`
 
-Auto-detects the mode (preview / production / dev) from `config` and initializes the widget. The recommended entry point for programmatic use.
+Auto-detects the mode (preview / production) from `config` and initializes the widget, throwing if neither `settings` nor `mtxId` + `mtxKey` is present. The recommended entry point for programmatic use.
 
 ```ts
 // Production
@@ -148,7 +148,7 @@ await mountWidget({ settings: { widget_enabled: true, widget_position: 'bottom_r
 
 ### `initWidget(config, container?): Promise<void>`
 
-Lower-level production/dev initializer. Validates credentials, fetches settings from the API, mounts into a closed Shadow DOM, and opens the event stream. Optionally mounts inside a specific `container`. Concurrent and duplicate calls are deduplicated; only one production widget runs per page.
+Lower-level production initializer. Validates credentials, fetches settings from the API, mounts into a closed Shadow DOM, and opens the event stream. Optionally mounts inside a specific `container`. Concurrent and duplicate calls are deduplicated; only one production widget runs per page.
 
 ```ts
 await initWidget({ mtxId, mtxKey, mtxApiHost }, document.getElementById('my-container')!);

package/dist/src/sdk/contracts/common.d.ts

@@ -33,9 +33,8 @@ export declare const PaginationSchema: z.ZodObject<{
     offset: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
 }, z.core.$strip>;
 /**
- * Query-string boolean: 'true'/'false' (or a real boolean) → boolean, anything else → undefined.
- * `z.coerce.boolean()` is WRONG for query strings — it's `Boolean(val)`, so `Boolean('false') === true`
- * and `?enabled=false` would match enabled rows. Parse the two tokens explicitly instead.
+ * Query-string boolean. NOT `z.coerce.boolean()` — that is `Boolean(val)`, so `Boolean('false') === true`
+ * and `?enabled=false` would match enabled rows. `.optional()` is outermost so the object key stays omittable.
  */
 export declare const booleanQueryParam: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>, z.ZodTransform<boolean | undefined, string | boolean>>>;
 /** Paginated list for unbounded queries — includes total/limit/offset for pagination */

package/dist/src/sdk/contracts/entities.d.ts

@@ -218,7 +218,7 @@ export declare const SimulationEntitySchema: z.ZodObject<{
         direct: "direct";
         uxr: "uxr";
         survey: "survey";
-        abtest: "abtest";
+        ab: "ab";
         qa: "qa";
     }>;
     pinned: z.ZodOptional<z.ZodBoolean>;
@@ -470,11 +470,11 @@ export declare const StateTriggerEntitySchema: z.ZodObject<{
 }, z.core.$strip>;
 export type StateTriggerData = z.infer<typeof StateTriggerEntitySchema>;
 /**
- * QA run status — first-class TEXT+CHECK column on qa_run (no longer derived).
- * `finalizing` = all sims terminal but per-journey outcomes still completing (QA has no
- * run-level rollup like studies). Canonical wire vocabulary.
+ * Run status — first-class TEXT+CHECK column on qa_run and study_run (no longer derived).
+ * `finalizing` = all sims terminal but the run-level fold still completing.
+ * Canonical wire vocabulary shared by QA runs and study runs.
  */
-export declare const QARunStatusSchema: z.ZodEnum<{
+export declare const RunStatusSchema: z.ZodEnum<{
     created: "created";
     running: "running";
     completed: "completed";
@@ -482,6 +482,7 @@ export declare const QARunStatusSchema: z.ZodEnum<{
     stopped: "stopped";
     finalizing: "finalizing";
 }>;
+export type RunStatus = z.infer<typeof RunStatusSchema>;
 /** QA outcome per (run, persona, journey, viewport) — DATA-derived by the api from qa_outcomes; NOT a wire status. */
 export declare const QARunOutcomeStatusSchema: z.ZodEnum<{
     failed: "failed";