@getuserfeedback/protocol 2.2.0 → 3.0.3

package/dist/core-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-commands.d.ts","sourceRoot":"","sources":["../src/core-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AA6J9B,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAInC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/core-commands.js

@@ -0,0 +1,129 @@
+import * as z from "zod/mini";
+import { appEventCustomerTrackSchema, appEventExternalIdSchema, appEventSystemTrackSchema, } from "./app-event.js";
+import { ErrorEventSchema } from "./errors.js";
+import { responseMetadataInputSchema } from "./response-metadata.js";
+import { configureOptionsSchema, initOptionsSchema } from "./widget-config.js";
+const flowHandleIdSchema = z.string().check(z.trim(), z.minLength(1));
+const flowIdSchema = z.string().check(z.trim(), z.minLength(1));
+const identifyTraitsSchema = z.record(z.string(), z.unknown());
+const identifyOptionsSchema = z.strictObject({
+    externalIds: z.optional(z.array(appEventExternalIdSchema).check(z.maxLength(20))),
+});
+const identifyPayloadSchema = z.union([
+    z.strictObject({
+        kind: z.literal("identify"),
+        traits: identifyTraitsSchema,
+        options: z.optional(identifyOptionsSchema),
+    }),
+    z.strictObject({
+        kind: z.literal("identify"),
+        userId: z.string().check(z.trim(), z.minLength(1)),
+        traits: z.optional(identifyTraitsSchema),
+        options: z.optional(identifyOptionsSchema),
+    }),
+]);
+const legacySystemTrackPayloadSchema = z.pipe(z.extend(appEventSystemTrackSchema, {
+    kind: z.literal("track"),
+    origin: z.optional(z.literal("system")),
+}), z.transform(({ origin: _origin, ...rest }) => ({
+    ...rest,
+    origin: "system",
+})));
+const customerTrackPayloadSchema = z.extend(appEventCustomerTrackSchema, {
+    kind: z.literal("track"),
+});
+const trackPayloadSchema = z.union([
+    legacySystemTrackPayloadSchema,
+    customerTrackPayloadSchema,
+]);
+const prefetchPayloadSchema = z.strictObject({
+    kind: z.literal("prefetch"),
+    flowId: flowIdSchema,
+    flowHandleId: z.optional(flowHandleIdSchema),
+});
+const openCorePayloadSchema = z.strictObject({
+    kind: z.literal("open"),
+    flowId: flowIdSchema,
+    flowHandleId: z.optional(flowHandleIdSchema),
+    metadata: z.optional(responseMetadataInputSchema),
+    hideCloseButton: z.optional(z.boolean()),
+});
+const prerenderCorePayloadSchema = z.strictObject({
+    kind: z.literal("prerender"),
+    flowId: flowIdSchema,
+    flowHandleId: z.optional(flowHandleIdSchema),
+    hideCloseButton: z.optional(z.boolean()),
+});
+const closeCorePayloadSchema = z.object({
+    kind: z.literal("close"),
+    flowHandleId: z.optional(flowHandleIdSchema),
+    reasonCode: z.optional(z.enum(["CLOSED", "RESET"])),
+});
+const hostContextUpdatedPayloadSchema = z.object({
+    kind: z.literal("hostContextUpdated"),
+    context: z.object({
+        url: z.string().check(z.url()),
+        env: z.optional(z.record(z.string(), z.string())),
+        storage: z.optional(z.record(z.string(), z.string())),
+        page: z.optional(z.object({
+            path: z.optional(z.string()),
+            referrer: z.optional(z.string()),
+            search: z.optional(z.string()),
+        })),
+    }),
+});
+const hostSignalPayloadSchema = z.object({
+    kind: z.literal("hostSignal"),
+    name: z.string(),
+    data: z.optional(z.unknown()),
+});
+const setTargetingPlanPayloadSchema = z.object({
+    kind: z.literal("setTargetingPlan"),
+    plan: z.object({
+        strategy: z.optional(z.enum(["firstMatch"])),
+        candidates: z.array(z.object({
+            action: z.enum(["open", "prefetch"]),
+            flowId: flowIdSchema,
+            rules: z.array(z.unknown()),
+        })),
+    }),
+});
+const telemetryPayloadSchema = z.object({
+    kind: z.literal("telemetry"),
+    name: z.string(),
+    props: z.optional(z.record(z.string(), z.unknown())),
+});
+const errorPayloadSchema = z.object({
+    kind: z.literal("error"),
+    event: ErrorEventSchema,
+});
+const configureCorePayloadSchema = z.object({
+    kind: z.literal("configure"),
+    opts: configureOptionsSchema,
+});
+const initCorePayloadSchema = z.strictObject({
+    kind: z.literal("init"),
+    opts: initOptionsSchema,
+});
+const resetPayloadSchema = z.object({
+    kind: z.literal("reset"),
+});
+const coreCommandPayloadWithoutIdentifySchema = z.discriminatedUnion("kind", [
+    openCorePayloadSchema,
+    prefetchPayloadSchema,
+    prerenderCorePayloadSchema,
+    hostContextUpdatedPayloadSchema,
+    hostSignalPayloadSchema,
+    setTargetingPlanPayloadSchema,
+    telemetryPayloadSchema,
+    configureCorePayloadSchema,
+    initCorePayloadSchema,
+    closeCorePayloadSchema,
+    resetPayloadSchema,
+    errorPayloadSchema,
+]);
+export const coreCommandPayloadSchema = z.union([
+    coreCommandPayloadWithoutIdentifySchema,
+    identifyPayloadSchema,
+    trackPayloadSchema,
+]);

package/dist/flow-assignments.d.ts

@@ -13,9 +13,6 @@ export declare const flowAssignmentStatusSchema: z.ZodMiniEnum<{
     completed: "completed";
     expired: "expired";
     superseded: "superseded";
-    withdrawn_pending: "withdrawn_pending";
-    withdrawn_presented: "withdrawn_presented";
-    withdrawn_final: "withdrawn_final";
 }>;
 export declare const flowAssignmentTargetingContextSchema: z.ZodMiniObject<{
     flags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
@@ -205,9 +202,6 @@ export declare const flowAssignmentRecordSchema: z.ZodMiniObject<{
         completed: "completed";
         expired: "expired";
         superseded: "superseded";
-        withdrawn_pending: "withdrawn_pending";
-        withdrawn_presented: "withdrawn_presented";
-        withdrawn_final: "withdrawn_final";
     }>;
     assignedAt: z.ZodMiniString<string>;
     expiresAt: z.ZodMiniOptional<z.ZodMiniString<string>>;
@@ -233,9 +227,6 @@ export declare const listPendingFlowAssignmentsResponseSchema: z.ZodMiniObject<{
             completed: "completed";
             expired: "expired";
             superseded: "superseded";
-            withdrawn_pending: "withdrawn_pending";
-            withdrawn_presented: "withdrawn_presented";
-            withdrawn_final: "withdrawn_final";
         }>;
         assignedAt: z.ZodMiniString<string>;
         expiresAt: z.ZodMiniOptional<z.ZodMiniString<string>>;
@@ -355,9 +346,6 @@ export declare const claimPendingFlowAssignmentsResponseSchema: z.ZodMiniObject<
             completed: "completed";
             expired: "expired";
             superseded: "superseded";
-            withdrawn_pending: "withdrawn_pending";
-            withdrawn_presented: "withdrawn_presented";
-            withdrawn_final: "withdrawn_final";
         }>;
         assignedAt: z.ZodMiniString<string>;
         expiresAt: z.ZodMiniOptional<z.ZodMiniString<string>>;
@@ -488,9 +476,6 @@ export declare const updateFlowAssignmentLifecycleResponseSchema: z.ZodMiniObjec
         completed: "completed";
         expired: "expired";
         superseded: "superseded";
-        withdrawn_pending: "withdrawn_pending";
-        withdrawn_presented: "withdrawn_presented";
-        withdrawn_final: "withdrawn_final";
     }>;
     assignedAt: z.ZodMiniString<string>;
     expiresAt: z.ZodMiniOptional<z.ZodMiniString<string>>;
@@ -514,9 +499,6 @@ export declare const nullableUpdateFlowAssignmentLifecycleResponseSchema: z.ZodM
         completed: "completed";
         expired: "expired";
         superseded: "superseded";
-        withdrawn_pending: "withdrawn_pending";
-        withdrawn_presented: "withdrawn_presented";
-        withdrawn_final: "withdrawn_final";
     }>;
     assignedAt: z.ZodMiniString<string>;
     expiresAt: z.ZodMiniOptional<z.ZodMiniString<string>>;

package/dist/flow-assignments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow-assignments.d.ts","sourceRoot":"","sources":["../src/flow-assignments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAO9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,MAAM,yCAAyC,GACpD,yBAAyB,MAAM,EAAE,CAAC;AACnC,MAAM,MAAM,+BAA+B,GACxC,iBAAiB,GACjB,yCAAyC,CAAC;AAc7C,eAAO,MAAM,4BAA4B;;;iBAMvC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;EAUrC,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU/C,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI/C,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBrC,CAAC;AAEH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGnD,CAAC;AAEH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMnD,CAAC;AAEH,eAAO,MAAM,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGpD,CAAC;AAEH,eAAO,MAAM,0CAA0C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOrD,CAAC;AAEH,eAAO,MAAM,uCAAuC;;;;;;;;iBAKlD,CAAC;AAEH,eAAO,MAAM,wCAAwC;;iBAEnD,CAAC;AAEH,eAAO,MAAM,2CAA2C;;;;;;;;;;;;;;;;;;;;;;;;;iBAC7B,CAAC;AAC5B,eAAO,MAAM,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;;kBAE/D,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC/E,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CACpD,OAAO,oCAAoC,CAC3C,CAAC;AACF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CACpD,OAAO,oCAAoC,CAC3C,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC/E,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CACxD,OAAO,wCAAwC,CAC/C,CAAC;AACF,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CACzD,OAAO,yCAAyC,CAChD,CAAC;AACF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CACxD,OAAO,wCAAwC,CAC/C,CAAC;AACF,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CACvD,OAAO,uCAAuC,CAC9C,CAAC;AACF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CACxD,OAAO,wCAAwC,CAC/C,CAAC;AACF,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAC1D,OAAO,0CAA0C,CACjD,CAAC;AACF,MAAM,MAAM,qCAAqC,GAAG,CAAC,CAAC,MAAM,CAC3D,OAAO,2CAA2C,CAClD,CAAC"}
+{"version":3,"file":"flow-assignments.d.ts","sourceRoot":"","sources":["../src/flow-assignments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAO9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,MAAM,yCAAyC,GACpD,yBAAyB,MAAM,EAAE,CAAC;AACnC,MAAM,MAAM,+BAA+B,GACxC,iBAAiB,GACjB,yCAAyC,CAAC;AAc7C,eAAO,MAAM,4BAA4B;;;iBAMvC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;EAOrC,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU/C,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI/C,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;iBAiBrC,CAAC;AAEH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;iBAGnD,CAAC;AAEH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMnD,CAAC;AAEH,eAAO,MAAM,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;iBAGpD,CAAC;AAEH,eAAO,MAAM,0CAA0C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOrD,CAAC;AAEH,eAAO,MAAM,uCAAuC;;;;;;;;iBAKlD,CAAC;AAEH,eAAO,MAAM,wCAAwC;;iBAEnD,CAAC;AAEH,eAAO,MAAM,2CAA2C;;;;;;;;;;;;;;;;;;;;;;iBAC7B,CAAC;AAC5B,eAAO,MAAM,mDAAmD;;;;;;;;;;;;;;;;;;;;;;kBAE/D,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC/E,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CACpD,OAAO,oCAAoC,CAC3C,CAAC;AACF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CACpD,OAAO,oCAAoC,CAC3C,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC/E,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CACxD,OAAO,wCAAwC,CAC/C,CAAC;AACF,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CACzD,OAAO,yCAAyC,CAChD,CAAC;AACF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CACxD,OAAO,wCAAwC,CAC/C,CAAC;AACF,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CACvD,OAAO,uCAAuC,CAC9C,CAAC;AACF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CACxD,OAAO,wCAAwC,CAC/C,CAAC;AACF,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAC1D,OAAO,0CAA0C,CACjD,CAAC;AACF,MAAM,MAAM,qCAAqC,GAAG,CAAC,CAAC,MAAM,CAC3D,OAAO,2CAA2C,CAClD,CAAC"}

package/dist/flow-assignments.js

@@ -17,9 +17,6 @@ export const flowAssignmentStatusSchema = z.enum([
     "completed",
     "expired",
     "superseded",
-    "withdrawn_pending",
-    "withdrawn_presented",
-    "withdrawn_final",
 ]);
 export const flowAssignmentTargetingContextSchema = z.object({
     flags: z.optional(z.array(appEventFlagSchema)),

package/dist/flow-display.d.ts

@@ -165,9 +165,6 @@ export declare const flowDisplaySyncResponseSchema: z.ZodMiniObject<{
                 completed: "completed";
                 expired: "expired";
                 superseded: "superseded";
-                withdrawn_pending: "withdrawn_pending";
-                withdrawn_presented: "withdrawn_presented";
-                withdrawn_final: "withdrawn_final";
             }>;
             assignedAt: z.ZodMiniString<string>;
             expiresAt: z.ZodMiniOptional<z.ZodMiniString<string>>;

package/dist/flow-display.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow-display.d.ts","sourceRoot":"","sources":["../src/flow-display.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAQ9B,eAAO,MAAM,+BAA+B;;;;;iBAU1C,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;2BAOtC,CAAC;AAQH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;iBAcnD,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;iBAGzC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASvC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMxC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAC9C,OAAO,8BAA8B,CACrC,CAAC;AACF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CACxD,OAAO,wCAAwC,CAC/C,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAC/C,OAAO,+BAA+B,CACtC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAC3C,OAAO,2BAA2B,CAClC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAC5C,OAAO,4BAA4B,CACnC,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAC7C,OAAO,6BAA6B,CACpC,CAAC"}
+{"version":3,"file":"flow-display.d.ts","sourceRoot":"","sources":["../src/flow-display.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAQ9B,eAAO,MAAM,+BAA+B;;;;;iBAU1C,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;2BAOtC,CAAC;AAQH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;;;;iBAcnD,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;iBAGzC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASvC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMxC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAC9C,OAAO,8BAA8B,CACrC,CAAC;AACF,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CACxD,OAAO,wCAAwC,CAC/C,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAC/C,OAAO,+BAA+B,CACtC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAC3C,OAAO,2BAA2B,CAClC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAC5C,OAAO,4BAA4B,CACnC,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAC7C,OAAO,6BAA6B,CACpC,CAAC"}

package/dist/host/command-envelope-schema.d.ts

@@ -124,19 +124,19 @@ export declare const commandEnvelopeSchema: z.ZodMiniObject<{
                 dark: "dark";
             }>]>>;
             consent: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniEnum<{
-                pending: "pending";
                 granted: "granted";
                 denied: "denied";
+                pending: "pending";
                 revoked: "revoked";
             }>, z.ZodMiniArray<z.ZodMiniEnum<{
+                "functionality.storage": "functionality.storage";
+                "security.storage": "security.storage";
                 "analytics.storage": "analytics.storage";
                 "analytics.measurement": "analytics.measurement";
                 "personalization.storage": "personalization.storage";
                 "ads.storage": "ads.storage";
                 "ads.user_data": "ads.user_data";
                 "ads.personalization": "ads.personalization";
-                "functionality.storage": "functionality.storage";
-                "security.storage": "security.storage";
             }>>]>>;
             auth: z.ZodMiniOptional<z.ZodMiniObject<{
                 jwt: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniObject<{
@@ -167,19 +167,19 @@ export declare const commandEnvelopeSchema: z.ZodMiniObject<{
             disableTelemetry: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
             enableDebug: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniBoolean<boolean>, z.ZodMiniString<string>, z.ZodMiniArray<z.ZodMiniString<string>>]>>;
             defaultConsent: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniEnum<{
-                pending: "pending";
                 granted: "granted";
                 denied: "denied";
+                pending: "pending";
                 revoked: "revoked";
             }>, z.ZodMiniArray<z.ZodMiniEnum<{
+                "functionality.storage": "functionality.storage";
+                "security.storage": "security.storage";
                 "analytics.storage": "analytics.storage";
                 "analytics.measurement": "analytics.measurement";
                 "personalization.storage": "personalization.storage";
                 "ads.storage": "ads.storage";
                 "ads.user_data": "ads.user_data";
                 "ads.personalization": "ads.personalization";
-                "functionality.storage": "functionality.storage";
-                "security.storage": "security.storage";
             }>>]>>;
             clientMeta: z.ZodMiniOptional<z.ZodMiniObject<{
                 loader: z.ZodMiniEnum<{
@@ -559,19 +559,19 @@ export declare const commandEnvelopeWithInstanceIdSchema: z.ZodMiniObject<{
                 dark: "dark";
             }>]>>;
             consent: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniEnum<{
-                pending: "pending";
                 granted: "granted";
                 denied: "denied";
+                pending: "pending";
                 revoked: "revoked";
             }>, z.ZodMiniArray<z.ZodMiniEnum<{
+                "functionality.storage": "functionality.storage";
+                "security.storage": "security.storage";
                 "analytics.storage": "analytics.storage";
                 "analytics.measurement": "analytics.measurement";
                 "personalization.storage": "personalization.storage";
                 "ads.storage": "ads.storage";
                 "ads.user_data": "ads.user_data";
                 "ads.personalization": "ads.personalization";
-                "functionality.storage": "functionality.storage";
-                "security.storage": "security.storage";
             }>>]>>;
             auth: z.ZodMiniOptional<z.ZodMiniObject<{
                 jwt: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniObject<{
@@ -602,19 +602,19 @@ export declare const commandEnvelopeWithInstanceIdSchema: z.ZodMiniObject<{
             disableTelemetry: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
             enableDebug: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniBoolean<boolean>, z.ZodMiniString<string>, z.ZodMiniArray<z.ZodMiniString<string>>]>>;
             defaultConsent: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniEnum<{
-                pending: "pending";
                 granted: "granted";
                 denied: "denied";
+                pending: "pending";
                 revoked: "revoked";
             }>, z.ZodMiniArray<z.ZodMiniEnum<{
+                "functionality.storage": "functionality.storage";
+                "security.storage": "security.storage";
                 "analytics.storage": "analytics.storage";
                 "analytics.measurement": "analytics.measurement";
                 "personalization.storage": "personalization.storage";
                 "ads.storage": "ads.storage";
                 "ads.user_data": "ads.user_data";
                 "ads.personalization": "ads.personalization";
-                "functionality.storage": "functionality.storage";
-                "security.storage": "security.storage";
             }>>]>>;
             clientMeta: z.ZodMiniOptional<z.ZodMiniObject<{
                 loader: z.ZodMiniEnum<{

package/dist/host/host-event-contract.d.ts

@@ -107,4 +107,20 @@ export declare function getFlowHandleFromSettlementDetail(detail: {
     kind: string;
     result?: unknown;
 }): FlowHandleFromSettlement | null;
+/** Normalized allocation from a handle-returning settlement: handle + instanceId for state. */
+export type FlowHandleAllocationFromSettlement = {
+    flowHandleId: string;
+    flowRunId: string | null;
+    instanceId: string | null;
+};
+/**
+ * Parse a command settlement into a single allocation object when the command
+ * returned a flow handle (open/prerender/prefetch). Returns null otherwise.
+ */
+export declare function getFlowHandleAllocationFromSettlement(detail: {
+    ok: boolean;
+    kind: string;
+    result?: unknown;
+    instanceId?: string | null;
+}): FlowHandleAllocationFromSettlement | null;
 //# sourceMappingURL=host-event-contract.d.ts.map

package/dist/host/host-event-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-event-contract.d.ts","sourceRoot":"","sources":["../../src/host/host-event-contract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"host-event-contract.d.ts","sourceRoot":"","sources":["../../src/host/host-event-contract.ts"],"names":[],"mappings":"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"}

package/dist/host/host-event-contract.js

@@ -124,3 +124,19 @@ export function getFlowHandleFromSettlementDetail(detail) {
         ...(isNonEmptyString(flowRunId) && { flowRunId }),
     };
 }
+const nonEmptyOrNull = (value) => typeof value === "string" && value.length > 0 ? value : null;
+/**
+ * Parse a command settlement into a single allocation object when the command
+ * returned a flow handle (open/prerender/prefetch). Returns null otherwise.
+ */
+export function getFlowHandleAllocationFromSettlement(detail) {
+    const handle = getFlowHandleFromSettlementDetail(detail);
+    if (!handle) {
+        return null;
+    }
+    return {
+        flowHandleId: handle.flowHandleId,
+        flowRunId: handle.flowRunId ?? null,
+        instanceId: nonEmptyOrNull(detail.instanceId ?? null),
+    };
+}

package/dist/host/host-event-schemas.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Zod schemas that validate the host event detail contract.
+ * Paired with host-event-contract.ts, which defines the types and lightweight guards.
+ */
+import * as z from "zod/mini";
+/**
+ * Canonical shape when a command (open, prerender, prefetch) settles and core
+ * has allocated a flow handle. flowRunId is present for open/prerender, absent for prefetch.
+ */
+export declare const flowHandleSettlementResultSchema: z.ZodMiniObject<{
+    flowHandleId: z.ZodMiniString<string>;
+    flowRunId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+}, z.core.$strict>;
+export type FlowHandleSettlementResult = z.output<typeof flowHandleSettlementResultSchema>;
+export declare const commandSettledDetailSchema: z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+    ok: z.ZodMiniLiteral<true>;
+    result: z.ZodMiniOptional<z.ZodMiniUnknown>;
+    requestId: z.ZodMiniString<string>;
+    instanceId: z.ZodMiniNullable<z.ZodMiniString<string>>;
+    kind: z.ZodMiniEnum<{
+        error: "error";
+        open: "open";
+        prefetch: "prefetch";
+        prerender: "prerender";
+        hostContextUpdated: "hostContextUpdated";
+        hostSignal: "hostSignal";
+        setTargetingPlan: "setTargetingPlan";
+        telemetry: "telemetry";
+        identify: "identify";
+        track: "track";
+        configure: "configure";
+        init: "init";
+        close: "close";
+        reset: "reset";
+        updateHostContext: "updateHostContext";
+        emitHostSignal: "emitHostSignal";
+        setContainer: "setContainer";
+        setDefaultContainerPolicy: "setDefaultContainerPolicy";
+    }>;
+}, z.core.$strict>, z.ZodMiniObject<{
+    ok: z.ZodMiniLiteral<false>;
+    error: z.ZodMiniObject<{
+        message: z.ZodMiniString<string>;
+        code: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.core.$strict>;
+    requestId: z.ZodMiniString<string>;
+    instanceId: z.ZodMiniNullable<z.ZodMiniString<string>>;
+    kind: z.ZodMiniEnum<{
+        error: "error";
+        open: "open";
+        prefetch: "prefetch";
+        prerender: "prerender";
+        hostContextUpdated: "hostContextUpdated";
+        hostSignal: "hostSignal";
+        setTargetingPlan: "setTargetingPlan";
+        telemetry: "telemetry";
+        identify: "identify";
+        track: "track";
+        configure: "configure";
+        init: "init";
+        close: "close";
+        reset: "reset";
+        updateHostContext: "updateHostContext";
+        emitHostSignal: "emitHostSignal";
+        setContainer: "setContainer";
+        setDefaultContainerPolicy: "setDefaultContainerPolicy";
+    }>;
+}, z.core.$strict>], "ok">;
+export type { CommandSettledDetail } from "./host-event-contract.js";
+export declare const flowStateChangedDetailSchema: z.ZodMiniObject<{
+    flowHandleId: z.ZodMiniString<string>;
+    instanceId: z.ZodMiniString<string>;
+    isOpen: z.ZodMiniBoolean<boolean>;
+    isLoading: z.ZodMiniBoolean<boolean>;
+    width: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+    height: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+}, z.core.$strict>;
+export type { FlowStateChangedDetail } from "./host-event-contract.js";
+export declare const instanceFlowStateChangedDetailSchema: z.ZodMiniObject<{
+    flowHandleId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    instanceId: z.ZodMiniString<string>;
+    isOpen: z.ZodMiniBoolean<boolean>;
+    isLoading: z.ZodMiniBoolean<boolean>;
+    width: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+    height: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+}, z.core.$strict>;
+export type { InstanceFlowStateChangedDetail } from "./host-event-contract.js";
+export declare const openRequestedDetailSchema: z.ZodMiniObject<{
+    instanceId: z.ZodMiniString<string>;
+    source: z.ZodMiniEnum<{
+        command: "command";
+        targeting: "targeting";
+    }>;
+    flowId: z.ZodMiniString<string>;
+    flowHandleId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    hideCloseButton: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+}, z.core.$strict>;
+export type { OpenRequestedDetail } from "./host-event-contract.js";
+export declare const handleInvalidatedDetailSchema: z.ZodMiniObject<{
+    instanceId: z.ZodMiniString<string>;
+    handleKind: z.ZodMiniString<string>;
+    handleId: z.ZodMiniString<string>;
+    reasonCode: z.ZodMiniEnum<{
+        INTERNAL: "INTERNAL";
+        CLOSED: "CLOSED";
+        RESET: "RESET";
+        STALE_HANDLE: "STALE_HANDLE";
+        OWNERSHIP_CONFLICT: "OWNERSHIP_CONFLICT";
+        OWNER_DISPOSED: "OWNER_DISPOSED";
+        UPSTREAM_INVALIDATED: "UPSTREAM_INVALIDATED";
+    }>;
+    reasonMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    relatedRequestId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    source: z.ZodMiniEnum<{
+        loader: "loader";
+        core: "core";
+    }>;
+    at: z.ZodMiniNumber<number>;
+}, z.core.$strict>;
+export type { HandleInvalidatedDetail } from "./host-event-contract.js";
+/**
+ * Parse unknown result into FlowHandleSettlementResult. Returns null if invalid.
+ */
+export declare function parseFlowHandleSettlementResult(result: unknown): FlowHandleSettlementResult | null;
+/**
+ * Extract flow handle from a successful command settlement when the command
+ * is one that can return a handle (open, prerender, prefetch). Returns null
+ * if detail is not ok, kind is not one of those, or result does not match
+ * flowHandleSettlementResultSchema.
+ */
+export declare function getFlowHandleFromSettlementDetail(detail: {
+    ok: boolean;
+    kind: string;
+    result?: unknown;
+}): FlowHandleSettlementResult | null;
+export type { FlowHandleAllocationFromSettlement } from "./host-event-contract.js";
+export { getFlowHandleAllocationFromSettlement } from "./host-event-contract.js";
+//# sourceMappingURL=host-event-schemas.d.ts.map

package/dist/host/host-event-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-event-schemas.d.ts","sourceRoot":"","sources":["../../src/host/host-event-schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAoB9B;;;GAGG;AACH,eAAO,MAAM,gCAAgC;;;kBAG3C,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAChD,OAAO,gCAAgC,CACvC,CAAC;AAcF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAGrC,CAAC;AAEH,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAUrE,eAAO,MAAM,4BAA4B;;;;;;;kBAGvC,CAAC;AAEH,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE,eAAO,MAAM,oCAAoC;;;;;;;kBAG/C,CAAC;AAEH,YAAY,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAE/E,eAAO,MAAM,yBAAyB;;;;;;;;;kBAMpC,CAAC;AAEH,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;kBASxC,CAAC;AAEH,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE;;GAEG;AACH,wBAAgB,+BAA+B,CAC9C,MAAM,EAAE,OAAO,GACb,0BAA0B,GAAG,IAAI,CAGnC;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACzD,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,0BAA0B,GAAG,IAAI,CAUpC;AAED,YAAY,EAAE,kCAAkC,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,qCAAqC,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/host/host-event-schemas.js

@@ -0,0 +1,94 @@
+/**
+ * Zod schemas that validate the host event detail contract.
+ * Paired with host-event-contract.ts, which defines the types and lightweight guards.
+ */
+import * as z from "zod/mini";
+import { allCommandKindSchema } from "../command-kinds.js";
+import { HANDLE_INVALIDATED_REASON_CODES, HANDLE_INVALIDATED_SOURCES, } from "./host-event-contract.js";
+const nonEmptyStringSchema = z.string().check(z.trim(), z.minLength(1));
+const commandErrorSchema = z.strictObject({
+    message: nonEmptyStringSchema,
+    code: z.optional(nonEmptyStringSchema),
+});
+const commandSettledDetailBase = {
+    requestId: nonEmptyStringSchema,
+    instanceId: z.nullable(nonEmptyStringSchema),
+    kind: allCommandKindSchema,
+};
+/**
+ * Canonical shape when a command (open, prerender, prefetch) settles and core
+ * has allocated a flow handle. flowRunId is present for open/prerender, absent for prefetch.
+ */
+export const flowHandleSettlementResultSchema = z.strictObject({
+    flowHandleId: nonEmptyStringSchema,
+    flowRunId: z.optional(nonEmptyStringSchema),
+});
+const commandSettledSuccessDetailSchema = z.strictObject({
+    ...commandSettledDetailBase,
+    ok: z.literal(true),
+    result: z.optional(z.unknown()),
+});
+const commandSettledFailureDetailSchema = z.strictObject({
+    ...commandSettledDetailBase,
+    ok: z.literal(false),
+    error: commandErrorSchema,
+});
+export const commandSettledDetailSchema = z.discriminatedUnion("ok", [
+    commandSettledSuccessDetailSchema,
+    commandSettledFailureDetailSchema,
+]);
+const flowStateChangedBase = {
+    instanceId: nonEmptyStringSchema,
+    isOpen: z.boolean(),
+    isLoading: z.boolean(),
+    width: z.optional(z.number()),
+    height: z.optional(z.number()),
+};
+export const flowStateChangedDetailSchema = z.strictObject({
+    ...flowStateChangedBase,
+    flowHandleId: nonEmptyStringSchema,
+});
+export const instanceFlowStateChangedDetailSchema = z.strictObject({
+    ...flowStateChangedBase,
+    flowHandleId: z.optional(nonEmptyStringSchema),
+});
+export const openRequestedDetailSchema = z.strictObject({
+    instanceId: nonEmptyStringSchema,
+    source: z.enum(["command", "targeting"]),
+    flowId: nonEmptyStringSchema,
+    flowHandleId: z.optional(nonEmptyStringSchema),
+    hideCloseButton: z.optional(z.boolean()),
+});
+export const handleInvalidatedDetailSchema = z.strictObject({
+    instanceId: nonEmptyStringSchema,
+    handleKind: nonEmptyStringSchema,
+    handleId: nonEmptyStringSchema,
+    reasonCode: z.enum(HANDLE_INVALIDATED_REASON_CODES),
+    reasonMessage: z.optional(nonEmptyStringSchema),
+    relatedRequestId: z.optional(nonEmptyStringSchema),
+    source: z.enum(HANDLE_INVALIDATED_SOURCES),
+    at: z.number(),
+});
+/**
+ * Parse unknown result into FlowHandleSettlementResult. Returns null if invalid.
+ */
+export function parseFlowHandleSettlementResult(result) {
+    const parsed = flowHandleSettlementResultSchema.safeParse(result);
+    return parsed.success ? parsed.data : null;
+}
+/**
+ * Extract flow handle from a successful command settlement when the command
+ * is one that can return a handle (open, prerender, prefetch). Returns null
+ * if detail is not ok, kind is not one of those, or result does not match
+ * flowHandleSettlementResultSchema.
+ */
+export function getFlowHandleFromSettlementDetail(detail) {
+    if (!detail.ok ||
+        (detail.kind !== "open" &&
+            detail.kind !== "prerender" &&
+            detail.kind !== "prefetch")) {
+        return null;
+    }
+    return parseFlowHandleSettlementResult(detail.result);
+}
+export { getFlowHandleAllocationFromSettlement } from "./host-event-contract.js";

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { type AppEventCapability, type AppEventExternalId, type AppEventFlag, type AppEventJsonValue, type AppEventPayload, type AppEventTrackInput, appEventBaseSchema, appEventCapabilitySchema, appEventContextSchema, appEventCustomerTrackSchema, appEventExternalIdSchema, appEventFlagProviderSchema, appEventFlagSchema, appEventFlowDismissedSchema, appEventIdentitySchema, appEventIdentityTypeSchema, appEventPayloadSchema, appEventSurveyViewedSchema, appEventSystemBaseSchema, appEventSystemTrackSchema, appEventTrackSchema, reservedSystemAppEventNames, } from "./app-event.js";
 export { type ClientMeta, clientMetaSchema, } from "./client-meta.js";
+export { type CommandContext, type CoreCommandEnvelope, coreCommandEnvelopeSchema, } from "./core-command-envelope.js";
+export { type CoreCommandPayload, coreCommandPayloadSchema, } from "./core-commands.js";
 export { DEFAULT_AUTO_DETECT_COLOR_SCHEME_ATTRS } from "./defaults.js";
 export type { ErrorEvent, ProtocolErrorCode } from "./errors.js";
 export { ErrorCategory, ErrorCategorySchema, ErrorEventSchema, ProtocolError, } from "./errors.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}