@kubuild/schema 0.6.0 → 0.8.0

package/dist/tracking.d.ts

@@ -11,25 +11,33 @@ export declare const TrackingProviderTypeSchema: z.ZodEnum<{
 }>;
 export type TrackingProviderType = z.infer<typeof TrackingProviderTypeSchema>;
 /**
- * Option descriptor representing a saved Pixel Credential from Account/Workspace
+ * Metadata-only descriptor of a tracking credential saved by the host (account/workspace).
+ *
+ * This is what the editor receives to render a credential picker. It NEVER carries secret
+ * material (access tokens, API secrets, webhook URLs/headers) — those stay on the host and
+ * are resolved server-side from `id` (see `TrackingSecretResolver` in `@kubuild/core`).
  */
 export interface PixelCredentialOption {
+    /** Opaque host id, stored in the document as `providers.<provider>.credentialId`. */
     id: string;
+    /** Human-readable label shown in the picker. */
     name: string;
-    provider: 'meta' | 'google' | 'gtm' | 'tiktok' | 'custom' | string;
-    pixelId: string;
-    capiAccessToken?: string;
-    testEventCode?: string;
-    measurementProtocolSecret?: string;
-    serverRelayUrl?: string;
-    customHeaders?: Record<string, string>;
+    provider: TrackingProviderType | (string & {});
+    /** Public Meta / TikTok pixel id, if the credential has one. */
+    pixelId?: string;
+    /** Public GA4 measurement id, if the credential has one. */
+    measurementId?: string;
+    /** Public GTM container id, if the credential has one. */
+    containerId?: string;
+    /** True when the host holds a server-side secret for this credential. */
+    hasSecret?: boolean;
     isActive?: boolean;
 }
 /**
  * Event Delivery Channels:
- * - 'both': Fires client browser pixel and dispatches to server CAPI (with deduplication event_id)
+ * - 'both': Fires client browser pixel and dispatches to the server relay (with deduplication event_id)
  * - 'client_only': Only fires in the browser via client-side pixel scripts
- * - 'server_only': Only sends to server endpoint / CAPI (no browser pixel call)
+ * - 'server_only': Only sends to the host server relay (no browser pixel call)
  */
 export declare const TrackingDeliverySchema: z.ZodEnum<{
     both: "both";
@@ -45,9 +53,7 @@ export declare const MetaTrackingProviderConfigSchema: z.ZodObject<{
     credentialId: z.ZodOptional<z.ZodString>;
     pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     capiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    capiAccessToken: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    serverRelayUrl: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
 export type MetaTrackingProviderConfig = z.infer<typeof MetaTrackingProviderConfigSchema>;
 /**
@@ -57,18 +63,16 @@ export declare const GoogleTrackingProviderConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     credentialId: z.ZodOptional<z.ZodString>;
     measurementId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    measurementProtocolSecret: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    serverRelayUrl: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
 export type GoogleTrackingProviderConfig = z.infer<typeof GoogleTrackingProviderConfigSchema>;
 /**
- * Google Tag Manager (GTM) Configuration
+ * Google Tag Manager (GTM) Configuration.
+ * Client-side only: `track_event` with provider 'gtm' (or 'all') pushes to `window.dataLayer`.
  */
 export declare const GtmTrackingProviderConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     credentialId: z.ZodOptional<z.ZodString>;
     containerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    serverRelayUrl: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
 export type GtmTrackingProviderConfig = z.infer<typeof GtmTrackingProviderConfigSchema>;
 /**
@@ -79,24 +83,27 @@ export declare const TikTokTrackingProviderConfigSchema: z.ZodObject<{
     credentialId: z.ZodOptional<z.ZodString>;
     pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     eventsApiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    accessToken: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    serverRelayUrl: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
 export type TikTokTrackingProviderConfig = z.infer<typeof TikTokTrackingProviderConfigSchema>;
 /**
- * Custom Webhook / Analytics Endpoint Configuration
+ * Custom Webhook Configuration.
+ * The destination URL and any auth headers are host secrets resolved from `credentialId`.
  */
 export declare const CustomTrackingProviderConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     credentialId: z.ZodOptional<z.ZodString>;
-    endpointUrl: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    headers: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
 }, z.core.$strip>;
 export type CustomTrackingProviderConfig = z.infer<typeof CustomTrackingProviderConfigSchema>;
+/**
+ * Provider keys that `<= 1.0.0` documents stored but that are now host-owned
+ * (secrets and server destinations). Used by migration and by import/export
+ * sanitization to strip them defensively.
+ */
+export declare const LEGACY_TRACKING_SECRET_KEYS: Readonly<Record<TrackingProviderType, readonly string[]>>;
 /**
  * Global Tracking Configuration Schema
- * Attached to Document / Project / Runtime Context.
+ * Attached to Document / Project. Contains no secrets.
  */
 export declare const TrackingConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
@@ -113,41 +120,64 @@ export declare const TrackingConfigSchema: z.ZodObject<{
             credentialId: z.ZodOptional<z.ZodString>;
             pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             capiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-            capiAccessToken: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-            serverRelayUrl: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         }, z.core.$strip>>;
         google: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             credentialId: z.ZodOptional<z.ZodString>;
             measurementId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-            measurementProtocolSecret: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-            serverRelayUrl: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         }, z.core.$strip>>;
         gtm: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             credentialId: z.ZodOptional<z.ZodString>;
             containerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-            serverRelayUrl: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         }, z.core.$strip>>;
         tiktok: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             credentialId: z.ZodOptional<z.ZodString>;
             pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             eventsApiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-            accessToken: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-            serverRelayUrl: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         }, z.core.$strip>>;
         custom: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             credentialId: z.ZodOptional<z.ZodString>;
-            endpointUrl: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-            headers: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type TrackingConfig = z.infer<typeof TrackingConfigSchema>;
+/** Meta Conversions API secret material. */
+export declare const MetaTrackingSecretsSchema: z.ZodObject<{
+    capiAccessToken: z.ZodString;
+}, z.core.$strip>;
+export type MetaTrackingSecrets = z.infer<typeof MetaTrackingSecretsSchema>;
+/** GA4 Measurement Protocol secret material. */
+export declare const GoogleTrackingSecretsSchema: z.ZodObject<{
+    measurementProtocolSecret: z.ZodString;
+}, z.core.$strip>;
+export type GoogleTrackingSecrets = z.infer<typeof GoogleTrackingSecretsSchema>;
+/** TikTok Events API secret material. */
+export declare const TikTokTrackingSecretsSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+}, z.core.$strip>;
+export type TikTokTrackingSecrets = z.infer<typeof TikTokTrackingSecretsSchema>;
+/** Custom webhook destination + auth headers (both are host secrets). */
+export declare const CustomTrackingSecretsSchema: z.ZodObject<{
+    endpointUrl: z.ZodString;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type CustomTrackingSecrets = z.infer<typeof CustomTrackingSecretsSchema>;
+/** Secret material keyed by provider. GTM is client-only and has no secret. */
+export interface TrackingProviderSecretsMap {
+    meta: MetaTrackingSecrets;
+    google: GoogleTrackingSecrets;
+    tiktok: TikTokTrackingSecrets;
+    custom: CustomTrackingSecrets;
+}
+/** Providers that support server-side delivery (and therefore have secrets). */
+export type ServerTrackingProviderType = keyof TrackingProviderSecretsMap;
+/** Secret material for a single provider, as returned by a host secret resolver. */
+export type TrackingProviderSecrets = TrackingProviderSecretsMap[ServerTrackingProviderType];
 /**
  * Standard Event Names commonly used across Meta, Google, and TikTok.
  */
@@ -166,6 +196,18 @@ export declare const StandardTrackingEventSchema: z.ZodEnum<{
     Schedule: "Schedule";
 }>;
 export type StandardTrackingEvent = z.infer<typeof StandardTrackingEventSchema>;
+/**
+ * Target provider of a `track_event` step. 'gtm' pushes to `window.dataLayer` (client only).
+ */
+export declare const TrackEventProviderSchema: z.ZodEnum<{
+    all: "all";
+    custom: "custom";
+    meta: "meta";
+    google: "google";
+    gtm: "gtm";
+    tiktok: "tiktok";
+}>;
+export type TrackEventProvider = z.infer<typeof TrackEventProviderSchema>;
 /**
  * Track Event Step Payload Schema (for Action Pipelines)
  */
@@ -180,6 +222,7 @@ export declare const TrackEventStepPayloadSchema: z.ZodObject<{
         custom: "custom";
         meta: "meta";
         google: "google";
+        gtm: "gtm";
         tiktok: "tiktok";
     }>>>;
     delivery: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
@@ -193,9 +236,113 @@ export declare const TrackEventStepPayloadSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
 export type TrackEventStepPayload = z.infer<typeof TrackEventStepPayloadSchema>;
+export declare const TRACKING_RELAY_PROTOCOL_VERSION: 1;
+/** Normalized server tracking event, as sent from the browser to the host relay. */
+export declare const ServerTrackingEventSchema: z.ZodObject<{
+    eventName: z.ZodString;
+    eventType: z.ZodOptional<z.ZodEnum<{
+        standard: "standard";
+        custom: "custom";
+    }>>;
+    eventId: z.ZodOptional<z.ZodString>;
+    eventTime: z.ZodOptional<z.ZodNumber>;
+    eventSourceUrl: z.ZodOptional<z.ZodString>;
+    actionSource: z.ZodOptional<z.ZodEnum<{
+        website: "website";
+        app: "app";
+        system_generated: "system_generated";
+    }>>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    userData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    customData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ServerTrackingEventInput = z.infer<typeof ServerTrackingEventSchema>;
+/**
+ * Body the renderer POSTs to the host relay (`RenderContext.tracking.relayUrl`).
+ * The relay MUST load the tracking config itself (trusted) — never from this body.
+ */
+export declare const TrackingRelayRequestSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    event: z.ZodObject<{
+        eventName: z.ZodString;
+        eventType: z.ZodOptional<z.ZodEnum<{
+            standard: "standard";
+            custom: "custom";
+        }>>;
+        eventId: z.ZodOptional<z.ZodString>;
+        eventTime: z.ZodOptional<z.ZodNumber>;
+        eventSourceUrl: z.ZodOptional<z.ZodString>;
+        actionSource: z.ZodOptional<z.ZodEnum<{
+            website: "website";
+            app: "app";
+            system_generated: "system_generated";
+        }>>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        userData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        customData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    provider: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        all: "all";
+        custom: "custom";
+        meta: "meta";
+        google: "google";
+        gtm: "gtm";
+        tiktok: "tiktok";
+    }>>>;
+    credentialId: z.ZodOptional<z.ZodString>;
+    documentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TrackingRelayRequest = z.infer<typeof TrackingRelayRequestSchema>;
+/** Per-provider outcome returned by the relay (provider response bodies are not echoed). */
+export declare const TrackingRelayProviderResultSchema: z.ZodObject<{
+    provider: z.ZodString;
+    success: z.ZodBoolean;
+    status: z.ZodOptional<z.ZodNumber>;
+    skipped: z.ZodOptional<z.ZodBoolean>;
+    reason: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TrackingRelayProviderResult = z.infer<typeof TrackingRelayProviderResultSchema>;
+export declare const TrackingRelayErrorCodeSchema: z.ZodEnum<{
+    INVALID_REQUEST: "INVALID_REQUEST";
+    UNSUPPORTED_VERSION: "UNSUPPORTED_VERSION";
+    FORBIDDEN_ORIGIN: "FORBIDDEN_ORIGIN";
+    METHOD_NOT_ALLOWED: "METHOD_NOT_ALLOWED";
+    CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND";
+    INTERNAL_ERROR: "INTERNAL_ERROR";
+}>;
+export type TrackingRelayErrorCode = z.infer<typeof TrackingRelayErrorCodeSchema>;
+export declare const TrackingRelayResponseSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    success: z.ZodBoolean;
+    eventId: z.ZodOptional<z.ZodString>;
+    skipped: z.ZodOptional<z.ZodBoolean>;
+    reason: z.ZodOptional<z.ZodString>;
+    results: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        provider: z.ZodString;
+        success: z.ZodBoolean;
+        status: z.ZodOptional<z.ZodNumber>;
+        skipped: z.ZodOptional<z.ZodBoolean>;
+        reason: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodEnum<{
+            INVALID_REQUEST: "INVALID_REQUEST";
+            UNSUPPORTED_VERSION: "UNSUPPORTED_VERSION";
+            FORBIDDEN_ORIGIN: "FORBIDDEN_ORIGIN";
+            METHOD_NOT_ALLOWED: "METHOD_NOT_ALLOWED";
+            CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND";
+            INTERNAL_ERROR: "INTERNAL_ERROR";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TrackingRelayResponse = z.infer<typeof TrackingRelayResponseSchema>;
 /**
  * Type guards
  */
 export declare function isTrackingConfig(value: unknown): value is TrackingConfig;
 export declare function isTrackEventStepPayload(value: unknown): value is TrackEventStepPayload;
+export declare function isTrackingRelayRequest(value: unknown): value is TrackingRelayRequest;
 //# sourceMappingURL=tracking.d.ts.map

package/dist/tracking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../src/tracking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;EAMrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;EAAiD,CAAC;AACrF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;iBAqB3C,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F;;GAEG;AACH,eAAO,MAAM,kCAAkC;;;;;;iBAU7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;;;iBAQ1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;iBAc7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F;;GAEG;AACH,eAAO,MAAM,kCAAkC;;;;;iBAQ7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoB/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;EAatC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;iBA2BtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAEtF"}
+{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../src/tracking.ts"],"names":[],"mappings":"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"}

package/dist/types.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * `@kubuild/schema/types` — pure TypeScript interfaces for the portable document format\n * (STORA-552).\n *\n * This module MUST NOT import zod (or any module that does). Its emitted `.d.ts` is what\n * hosts on a different zod major (e.g. a zod v3 backend) import to type `PageDocument`,\n * `Node`, etc. without pulling zod v4's core namespace into their compilation.\n *\n * Every type here mirrors the *parsed output* (`z.infer<...>`) of the matching schema in\n * the main entry, i.e. fields with a schema default are required. The equality is\n * enforced by `tests/types.test.ts` (`expectTypeOf(...).toEqualTypeOf(...)`), so a schema\n * change that is not reflected here fails `pnpm run typecheck`.\n */\n\n/* ----------------------------------------------------------------------------------------\n * Bindings & styles\n * -------------------------------------------------------------------------------------- */\n\nexport interface AssetReference {\n  type: 'asset';\n  assetId: string;\n  filename?: string;\n  mimeType?: string;\n  fallbackUrl?: string;\n}\n\nexport interface VariableBinding {\n  type: 'variable';\n  key: string;\n  fallback?: unknown;\n}\n\nexport interface ActionBinding {\n  type: string;\n  payload?: Record<string, unknown>;\n}\n\nexport type StyleValue = string | number | boolean | null | undefined;\n\n/**\n * Standard CSS style definition supporting Flexbox, sizing constraints, effects,\n * CSS Grid, and arbitrary CSS properties / design-token references.\n */\nexport interface StyleDefinition extends Record<string, StyleValue> {\n  display?: string;\n  flexDirection?: 'row' | 'row-reverse' | 'column' | 'column-reverse' | (string & {});\n  flexWrap?: 'nowrap' | 'wrap' | 'wrap-reverse' | (string & {});\n  justifyContent?:\n    | 'flex-start'\n    | 'flex-end'\n    | 'center'\n    | 'space-between'\n    | 'space-around'\n    | 'space-evenly'\n    | 'start'\n    | 'end'\n    | 'left'\n    | 'right'\n    | (string & {});\n  alignItems?:\n    | 'stretch'\n    | 'flex-start'\n    | 'flex-end'\n    | 'center'\n    | 'baseline'\n    | 'start'\n    | 'end'\n    | 'self-start'\n    | 'self-end'\n    | (string & {});\n  alignContent?:\n    | 'flex-start'\n    | 'flex-end'\n    | 'center'\n    | 'space-between'\n    | 'space-around'\n    | 'space-evenly'\n    | 'stretch'\n    | 'start'\n    | 'end'\n    | (string & {});\n  gap?: string | number;\n  rowGap?: string | number;\n  columnGap?: string | number;\n  flexGrow?: number | string;\n  flexShrink?: number | string;\n  flexBasis?: string | number;\n  alignSelf?:\n    'auto' | 'flex-start' | 'flex-end' | 'center' | 'baseline' | 'stretch' | (string & {});\n  width?: string | number;\n  height?: string | number;\n  minWidth?: string | number;\n  maxWidth?: string | number;\n  minHeight?: string | number;\n  maxHeight?: string | number;\n  objectFit?: 'fill' | 'contain' | 'cover' | 'none' | 'scale-down' | (string & {});\n  objectPosition?: string;\n  borderRadius?: string | number;\n  borderTopLeftRadius?: string | number;\n  borderTopRightRadius?: string | number;\n  borderBottomRightRadius?: string | number;\n  borderBottomLeftRadius?: string | number;\n  backdropFilter?: string;\n  filter?: string;\n  boxShadow?: string;\n  backgroundColor?: string;\n  backgroundImage?: string;\n  backgroundSize?: 'cover' | 'contain' | 'auto' | (string & {});\n  backgroundPosition?: string;\n  backgroundRepeat?: 'no-repeat' | 'repeat' | 'repeat-x' | 'repeat-y' | (string & {});\n  backgroundAttachment?: 'scroll' | 'fixed' | 'local' | (string & {});\n  gridTemplateColumns?: string;\n  gridTemplateRows?: string;\n  gridAutoFlow?: string;\n  gridAutoColumns?: string;\n  gridAutoRows?: string;\n  gridColumn?: string | number;\n  gridRow?: string | number;\n  gridColumnStart?: string | number;\n  gridColumnEnd?: string | number;\n  gridRowStart?: string | number;\n  gridRowEnd?: string | number;\n  colSpan?: number | string;\n  rowSpan?: number | string;\n  justifySelf?: string;\n}\n\nexport type PseudoStateStyles = Record<string, StyleDefinition>;\n\n/** Breakpoint style layers (`base` applies to every viewport) plus pseudo-state layers. */\nexport interface ResponsiveStyles {\n  [key: string]: unknown;\n  base?: StyleDefinition;\n  desktop?: StyleDefinition;\n  tablet?: StyleDefinition;\n  mobile?: StyleDefinition;\n  states?: Record<string, StyleDefinition>;\n}\n\nexport interface AnimationConfig {\n  type: string;\n  duration: number;\n  delay: number;\n  easing: string;\n  once: boolean;\n  hoverEffect: string;\n  loopEffect: string;\n}\n\n/* ----------------------------------------------------------------------------------------\n * Theme (STORA-551)\n * -------------------------------------------------------------------------------------- */\n\nexport type ThemeTokenValue = string | number;\n\n/** Design tokens; referenced from styles as `var(--kb-color-<key>)` etc. */\nexport interface Theme {\n  colors?: Record<string, ThemeTokenValue>;\n  fonts?: Record<string, ThemeTokenValue>;\n  radii?: Record<string, ThemeTokenValue>;\n  spacing?: Record<string, ThemeTokenValue>;\n}\n\n/* ----------------------------------------------------------------------------------------\n * Forms\n * -------------------------------------------------------------------------------------- */\n\nexport type ValidationRuleType =\n  | 'required'\n  | 'email'\n  | 'url'\n  | 'min_length'\n  | 'max_length'\n  | 'numeric_min'\n  | 'numeric_max'\n  | 'pattern'\n  | 'match_field'\n  | 'custom_regex';\n\nexport type ValidateOnEvent = 'blur' | 'change' | 'submit';\n\nexport interface ValidationRule {\n  type: ValidationRuleType;\n  value?: unknown;\n  message: string;\n}\n\nexport interface FormFieldBinding {\n  name: string;\n  label?: string;\n  defaultValue?: unknown;\n  rules: ValidationRule[];\n  validateOn: ValidateOnEvent;\n  transform?: 'trim' | 'lowercase' | 'uppercase' | 'number';\n  disabled?: boolean;\n  required?: boolean;\n}\n\nexport interface FormConfig {\n  formId: string;\n  resetOnSubmit: boolean;\n  scrollToFirstError: boolean;\n  validateOn: ValidateOnEvent;\n  initialValues?: Record<string, unknown>;\n  rules?: ValidationRule[];\n}\n\n/* ----------------------------------------------------------------------------------------\n * Actions\n * -------------------------------------------------------------------------------------- */\n\nexport type ActionTriggerType =\n  'click' | 'submit' | 'change' | 'blur' | 'focus' | 'load' | 'expire';\n\nexport type ActionStepType =\n  | 'api_request'\n  | 'navigate'\n  | 'set_state'\n  | 'reset_form'\n  | 'show_toast'\n  | 'open_modal'\n  | 'close_modal'\n  | 'toggle_modal'\n  | 'copy_clipboard'\n  | 'custom_event'\n  | 'track_event';\n\nexport type ConditionOperator =\n  | 'equals'\n  | 'not_equals'\n  | 'contains'\n  | 'not_contains'\n  | 'is_truthy'\n  | 'is_falsy'\n  | 'gt'\n  | 'gte'\n  | 'lt'\n  | 'lte'\n  | 'regex';\n\nexport interface ActionStepCondition {\n  field: string;\n  operator: ConditionOperator;\n  value?: unknown;\n}\n\nexport interface ActionStep {\n  id: string;\n  type: ActionStepType;\n  label?: string;\n  payload?: Record<string, unknown>;\n  condition?: ActionStepCondition;\n  timeout?: number;\n  continueOnError?: boolean;\n  onSuccess?: ActionStep[];\n  onError?: ActionStep[];\n}\n\nexport interface ActionPipeline {\n  id: string;\n  trigger: ActionTriggerType;\n  label?: string;\n  debounceMs?: number;\n  preventDuplicate?: boolean;\n  enabled: boolean;\n  steps: ActionStep[];\n}\n\n/* ----------------------------------------------------------------------------------------\n * Tracking (public ids only — secrets are host-owned)\n * -------------------------------------------------------------------------------------- */\n\nexport type TrackingProviderType = 'meta' | 'google' | 'gtm' | 'tiktok' | 'custom';\n\nexport type TrackingDelivery = 'both' | 'client_only' | 'server_only';\n\nexport interface MetaTrackingProviderConfig {\n  enabled: boolean;\n  credentialId?: string;\n  pixelId: string;\n  capiEnabled: boolean;\n  testEventCode: string;\n}\n\nexport interface GoogleTrackingProviderConfig {\n  enabled: boolean;\n  credentialId?: string;\n  measurementId: string;\n}\n\nexport interface GtmTrackingProviderConfig {\n  enabled: boolean;\n  credentialId?: string;\n  containerId: string;\n}\n\nexport interface TikTokTrackingProviderConfig {\n  enabled: boolean;\n  credentialId?: string;\n  pixelId: string;\n  eventsApiEnabled: boolean;\n  testEventCode: string;\n}\n\nexport interface CustomTrackingProviderConfig {\n  enabled: boolean;\n  credentialId?: string;\n}\n\nexport interface TrackingConfig {\n  enabled: boolean;\n  debugMode: boolean;\n  autoPageView: boolean;\n  defaultDelivery: TrackingDelivery;\n  providers: {\n    meta?: MetaTrackingProviderConfig;\n    google?: GoogleTrackingProviderConfig;\n    gtm?: GtmTrackingProviderConfig;\n    tiktok?: TikTokTrackingProviderConfig;\n    custom?: CustomTrackingProviderConfig;\n  };\n}\n\n/* ----------------------------------------------------------------------------------------\n * Document\n * -------------------------------------------------------------------------------------- */\n\nexport interface Node {\n  id: string;\n  type: string;\n  props?: Record<string, unknown>;\n  styles?: ResponsiveStyles;\n  animation?: AnimationConfig;\n  actions?: ActionPipeline[];\n  formConfig?: FormConfig;\n  children?: Node[];\n}\n\nexport type RootPageNode = Node & { type: 'page' };\n\nexport interface DocumentMetadata {\n  title: string;\n  description: string;\n  author: string;\n  createdAt?: string;\n  updatedAt?: string;\n  tags: string[];\n  category: string;\n  version: string;\n  custom?: Record<string, unknown>;\n  tracking?: TrackingConfig;\n}\n\nexport interface PageDocument {\n  schema: 'stora.page';\n  version: string;\n  metadata?: DocumentMetadata;\n  tracking?: TrackingConfig;\n  theme?: Theme;\n  document: RootPageNode;\n}\n\nexport type ArtboardType = 'page' | 'component';\n\nexport interface Artboard {\n  id: string;\n  name: string;\n  artboardType: ArtboardType;\n  slug?: string;\n  triggerId?: string;\n  viewport?: 'desktop' | 'tablet' | 'mobile';\n  width?: number;\n  position?: { x: number; y: number };\n  document: PageDocument;\n}\n\nexport interface ProjectDocument {\n  schema: 'stora.project';\n  version: string;\n  metadata?: DocumentMetadata;\n  tracking?: TrackingConfig;\n  artboards: Artboard[];\n  activeArtboardId?: string;\n}\n\n/* ----------------------------------------------------------------------------------------\n * Package manifest & templates\n * -------------------------------------------------------------------------------------- */\n\nexport interface ManifestAssetItem {\n  id: string;\n  path: string;\n  mimeType: string;\n  size: number;\n  checksum?: string;\n}\n\nexport interface Manifest {\n  schema: 'stora.page';\n  schemaVersion: string;\n  packageVersion: string;\n  builderCompatibility: string;\n  requiredComponents: string[];\n  requiredCapabilities: string[];\n  assets: ManifestAssetItem[];\n  createdAt?: string;\n}\n\nexport interface SafeThumbnailObject {\n  url: string;\n  alt?: string;\n  width?: number;\n  height?: number;\n}\n\nexport type SafeThumbnail = AssetReference | SafeThumbnailObject | string;\n\nexport interface TemplatePackageRef {\n  path?: string;\n  url?: string;\n  checksum?: string;\n  format: 'stora' | 'json';\n}\n\nexport interface TemplateRequirements {\n  requiredComponents: string[];\n  requiredCapabilities: string[];\n}\n\nexport interface TemplateRecord {\n  id: string;\n  name: string;\n  description: string;\n  category: string;\n  tags: string[];\n  thumbnail?: SafeThumbnail;\n  author: string;\n  version: string;\n  document?: PageDocument;\n  packageReference?: TemplatePackageRef;\n  requirements: TemplateRequirements;\n  createdAt?: string;\n  updatedAt?: string;\n  custom?: Record<string, unknown>;\n}\n\n/* ----------------------------------------------------------------------------------------\n * Zod-free validation results (see `@kubuild/schema/validate`)\n * -------------------------------------------------------------------------------------- */\n\nexport interface SchemaValidationIssue {\n  /** Dotted path to the offending value, e.g. `document.children.0.id` (empty for root). */\n  path: string;\n  message: string;\n  /** Validator issue code (e.g. `invalid_type`, `custom`). */\n  code: string;\n}\n\nexport type SchemaValidationResult<T> =\n  | { success: true; data: T; issues: [] }\n  | { success: false; data?: undefined; issues: SchemaValidationIssue[] };\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}