@walkeros/core 4.3.0-next-1783517345197 → 4.3.0-next-1784055686454

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @walkeros/core
 
-## 4.3.0-next-1783517345197
+## 4.3.0-next-1784055686454
 
 ### Minor Changes
 
@@ -19,6 +19,12 @@
   to agents. Batching destinations now emit per-event records, and live-web
   vendor calls are captured when a destination reaches its callable through
   `getEnv`, though batched sends stay uncaptured.
+- f8408fd: Preview links are now app-signed and bound to your site's origin,
+  verified locally in the bundle with no server round trip. Bundles that support
+  preview activation import a new `browserSwapActivator` from `@walkeros/core`.
+  The CLI wrap step's `preview` option replaces `previewOrigin`/`previewScope`,
+  and a new `previewGrantTargets` option lets a preview forward its grant to
+  server-bound destinations too.
 - 9506e3e: Events now carry per-flow config provenance on
   `event.source.release`, a flow-name to release map that accumulates as an
   event crosses flows (web capture to server processing), so a delivered event

package/dist/dev.d.mts

@@ -301,6 +301,28 @@ declare const UserSchema: z.ZodIntersection<z.ZodRecord<z.ZodString, z.ZodOption
  * (browser, dataLayer, gtag, ...). All other fields are optional since each
  * source kind augments this differently via `SourceMap`.
  */
+/**
+ * Declared Source fields as a standalone object schema. Composed into
+ * SourceSchema below. Also the drift guard's index-free key source: unlike
+ * `PropertiesSchema.and(...)`, a plain object schema keeps `keyof z.infer` to
+ * the declared field names, so it can be compared against
+ * `WalkerOS.SourceFields` (see __tests__/config-drift.test-d.ts). Not added to
+ * the schemas/index.ts curated exports and carries no `.meta` id, so it is not
+ * registered for JSON-schema/OpenAPI generation.
+ */
+declare const SourceFieldsSchema: z.ZodObject<{
+    type: z.ZodString;
+    platform: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    count: z.ZodOptional<z.ZodNumber>;
+    trace: z.ZodOptional<z.ZodString>;
+    release: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    url: z.ZodOptional<z.ZodString>;
+    referrer: z.ZodOptional<z.ZodString>;
+    tool: z.ZodOptional<z.ZodString>;
+    command: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 declare const SourceSchema$1: z.ZodIntersection<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>, z.ZodObject<{
     type: z.ZodString;
     platform: z.ZodOptional<z.ZodString>;
@@ -487,6 +509,7 @@ declare const walkeros_PartialEventSchema: typeof PartialEventSchema;
 declare const walkeros_PropertiesSchema: typeof PropertiesSchema;
 declare const walkeros_PropertySchema: typeof PropertySchema;
 declare const walkeros_PropertyTypeSchema: typeof PropertyTypeSchema;
+declare const walkeros_SourceFieldsSchema: typeof SourceFieldsSchema;
 declare const walkeros_SourceTypeSchema: typeof SourceTypeSchema;
 declare const walkeros_UserSchema: typeof UserSchema;
 declare const walkeros_consentJsonSchema: typeof consentJsonSchema;
@@ -498,7 +521,7 @@ declare const walkeros_propertiesJsonSchema: typeof propertiesJsonSchema;
 declare const walkeros_sourceTypeJsonSchema: typeof sourceTypeJsonSchema;
 declare const walkeros_userJsonSchema: typeof userJsonSchema;
 declare namespace walkeros {
-  export { walkeros_ConsentSchema as ConsentSchema, walkeros_DeepPartialEventSchema as DeepPartialEventSchema, walkeros_EntitiesSchema as EntitiesSchema, walkeros_EntitySchema as EntitySchema, walkeros_EventSchema as EventSchema, walkeros_OrderedPropertiesSchema as OrderedPropertiesSchema, walkeros_PartialEventSchema as PartialEventSchema, walkeros_PropertiesSchema as PropertiesSchema, walkeros_PropertySchema as PropertySchema, walkeros_PropertyTypeSchema as PropertyTypeSchema, SourceSchema$1 as SourceSchema, walkeros_SourceTypeSchema as SourceTypeSchema, walkeros_UserSchema as UserSchema, walkeros_consentJsonSchema as consentJsonSchema, walkeros_entityJsonSchema as entityJsonSchema, walkeros_eventJsonSchema as eventJsonSchema, walkeros_orderedPropertiesJsonSchema as orderedPropertiesJsonSchema, walkeros_partialEventJsonSchema as partialEventJsonSchema, walkeros_propertiesJsonSchema as propertiesJsonSchema, walkeros_sourceTypeJsonSchema as sourceTypeJsonSchema, walkeros_userJsonSchema as userJsonSchema };
+  export { walkeros_ConsentSchema as ConsentSchema, walkeros_DeepPartialEventSchema as DeepPartialEventSchema, walkeros_EntitiesSchema as EntitiesSchema, walkeros_EntitySchema as EntitySchema, walkeros_EventSchema as EventSchema, walkeros_OrderedPropertiesSchema as OrderedPropertiesSchema, walkeros_PartialEventSchema as PartialEventSchema, walkeros_PropertiesSchema as PropertiesSchema, walkeros_PropertySchema as PropertySchema, walkeros_PropertyTypeSchema as PropertyTypeSchema, walkeros_SourceFieldsSchema as SourceFieldsSchema, SourceSchema$1 as SourceSchema, walkeros_SourceTypeSchema as SourceTypeSchema, walkeros_UserSchema as UserSchema, walkeros_consentJsonSchema as consentJsonSchema, walkeros_entityJsonSchema as entityJsonSchema, walkeros_eventJsonSchema as eventJsonSchema, walkeros_orderedPropertiesJsonSchema as orderedPropertiesJsonSchema, walkeros_partialEventJsonSchema as partialEventJsonSchema, walkeros_propertiesJsonSchema as propertiesJsonSchema, walkeros_sourceTypeJsonSchema as sourceTypeJsonSchema, walkeros_userJsonSchema as userJsonSchema };
 }
 
 /**
@@ -8846,7 +8869,15 @@ interface User extends Properties {
     internal?: boolean;
 }
 type SourcePlatform = 'web' | 'server' | 'app' | 'ios' | 'android' | 'terminal' | string;
-interface Source extends Properties {
+/**
+ * Declared (named) fields of an event Source. Kept as a standalone interface so
+ * its key set stays index-signature-free: `Source extends Properties` adds a
+ * string index signature that collapses `keyof Source` to `string | number`,
+ * which would defeat the type↔schema drift guard. The guard compares
+ * `keyof SourceFields` against `keyof z.infer<typeof SourceFieldsSchema>`
+ * (see schemas/__tests__/config-drift.test-d.ts).
+ */
+interface SourceFields {
     type: string;
     platform?: SourcePlatform;
     /** Deployment version of the source emitter (string). */
@@ -8865,6 +8896,8 @@ interface Source extends Properties {
     tool?: string;
     command?: string;
 }
+interface Source extends Properties, SourceFields {
+}
 type PropertyType = boolean | string | number | {
     [key: string]: Property;
 };

package/dist/dev.d.ts

@@ -301,6 +301,28 @@ declare const UserSchema: z.ZodIntersection<z.ZodRecord<z.ZodString, z.ZodOption
  * (browser, dataLayer, gtag, ...). All other fields are optional since each
  * source kind augments this differently via `SourceMap`.
  */
+/**
+ * Declared Source fields as a standalone object schema. Composed into
+ * SourceSchema below. Also the drift guard's index-free key source: unlike
+ * `PropertiesSchema.and(...)`, a plain object schema keeps `keyof z.infer` to
+ * the declared field names, so it can be compared against
+ * `WalkerOS.SourceFields` (see __tests__/config-drift.test-d.ts). Not added to
+ * the schemas/index.ts curated exports and carries no `.meta` id, so it is not
+ * registered for JSON-schema/OpenAPI generation.
+ */
+declare const SourceFieldsSchema: z.ZodObject<{
+    type: z.ZodString;
+    platform: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+    count: z.ZodOptional<z.ZodNumber>;
+    trace: z.ZodOptional<z.ZodString>;
+    release: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    url: z.ZodOptional<z.ZodString>;
+    referrer: z.ZodOptional<z.ZodString>;
+    tool: z.ZodOptional<z.ZodString>;
+    command: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 declare const SourceSchema$1: z.ZodIntersection<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>, z.ZodObject<{
     type: z.ZodString;
     platform: z.ZodOptional<z.ZodString>;
@@ -487,6 +509,7 @@ declare const walkeros_PartialEventSchema: typeof PartialEventSchema;
 declare const walkeros_PropertiesSchema: typeof PropertiesSchema;
 declare const walkeros_PropertySchema: typeof PropertySchema;
 declare const walkeros_PropertyTypeSchema: typeof PropertyTypeSchema;
+declare const walkeros_SourceFieldsSchema: typeof SourceFieldsSchema;
 declare const walkeros_SourceTypeSchema: typeof SourceTypeSchema;
 declare const walkeros_UserSchema: typeof UserSchema;
 declare const walkeros_consentJsonSchema: typeof consentJsonSchema;
@@ -498,7 +521,7 @@ declare const walkeros_propertiesJsonSchema: typeof propertiesJsonSchema;
 declare const walkeros_sourceTypeJsonSchema: typeof sourceTypeJsonSchema;
 declare const walkeros_userJsonSchema: typeof userJsonSchema;
 declare namespace walkeros {
-  export { walkeros_ConsentSchema as ConsentSchema, walkeros_DeepPartialEventSchema as DeepPartialEventSchema, walkeros_EntitiesSchema as EntitiesSchema, walkeros_EntitySchema as EntitySchema, walkeros_EventSchema as EventSchema, walkeros_OrderedPropertiesSchema as OrderedPropertiesSchema, walkeros_PartialEventSchema as PartialEventSchema, walkeros_PropertiesSchema as PropertiesSchema, walkeros_PropertySchema as PropertySchema, walkeros_PropertyTypeSchema as PropertyTypeSchema, SourceSchema$1 as SourceSchema, walkeros_SourceTypeSchema as SourceTypeSchema, walkeros_UserSchema as UserSchema, walkeros_consentJsonSchema as consentJsonSchema, walkeros_entityJsonSchema as entityJsonSchema, walkeros_eventJsonSchema as eventJsonSchema, walkeros_orderedPropertiesJsonSchema as orderedPropertiesJsonSchema, walkeros_partialEventJsonSchema as partialEventJsonSchema, walkeros_propertiesJsonSchema as propertiesJsonSchema, walkeros_sourceTypeJsonSchema as sourceTypeJsonSchema, walkeros_userJsonSchema as userJsonSchema };
+  export { walkeros_ConsentSchema as ConsentSchema, walkeros_DeepPartialEventSchema as DeepPartialEventSchema, walkeros_EntitiesSchema as EntitiesSchema, walkeros_EntitySchema as EntitySchema, walkeros_EventSchema as EventSchema, walkeros_OrderedPropertiesSchema as OrderedPropertiesSchema, walkeros_PartialEventSchema as PartialEventSchema, walkeros_PropertiesSchema as PropertiesSchema, walkeros_PropertySchema as PropertySchema, walkeros_PropertyTypeSchema as PropertyTypeSchema, walkeros_SourceFieldsSchema as SourceFieldsSchema, SourceSchema$1 as SourceSchema, walkeros_SourceTypeSchema as SourceTypeSchema, walkeros_UserSchema as UserSchema, walkeros_consentJsonSchema as consentJsonSchema, walkeros_entityJsonSchema as entityJsonSchema, walkeros_eventJsonSchema as eventJsonSchema, walkeros_orderedPropertiesJsonSchema as orderedPropertiesJsonSchema, walkeros_partialEventJsonSchema as partialEventJsonSchema, walkeros_propertiesJsonSchema as propertiesJsonSchema, walkeros_sourceTypeJsonSchema as sourceTypeJsonSchema, walkeros_userJsonSchema as userJsonSchema };
 }
 
 /**
@@ -8846,7 +8869,15 @@ interface User extends Properties {
     internal?: boolean;
 }
 type SourcePlatform = 'web' | 'server' | 'app' | 'ios' | 'android' | 'terminal' | string;
-interface Source extends Properties {
+/**
+ * Declared (named) fields of an event Source. Kept as a standalone interface so
+ * its key set stays index-signature-free: `Source extends Properties` adds a
+ * string index signature that collapses `keyof Source` to `string | number`,
+ * which would defeat the type↔schema drift guard. The guard compares
+ * `keyof SourceFields` against `keyof z.infer<typeof SourceFieldsSchema>`
+ * (see schemas/__tests__/config-drift.test-d.ts).
+ */
+interface SourceFields {
     type: string;
     platform?: SourcePlatform;
     /** Deployment version of the source emitter (string). */
@@ -8865,6 +8896,8 @@ interface Source extends Properties {
     tool?: string;
     command?: string;
 }
+interface Source extends Properties, SourceFields {
+}
 type PropertyType = boolean | string | number | {
     [key: string]: Property;
 };