@kubuild/schema 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,715 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/validate.ts
21
+ var validate_exports = {};
22
+ __export(validate_exports, {
23
+ isValidPageDocument: () => isValidPageDocument,
24
+ validateDocument: () => validateDocument,
25
+ validateManifest: () => validateManifest,
26
+ validateNode: () => validateNode,
27
+ validateProjectDocument: () => validateProjectDocument,
28
+ validateTemplateRecord: () => validateTemplateRecord,
29
+ validateTheme: () => validateTheme
30
+ });
31
+ module.exports = __toCommonJS(validate_exports);
32
+
33
+ // src/document.ts
34
+ var import_zod5 = require("zod");
35
+
36
+ // src/actions.ts
37
+ var import_zod2 = require("zod");
38
+
39
+ // src/tracking.ts
40
+ var import_zod = require("zod");
41
+ var TrackingProviderTypeSchema = import_zod.z.enum([
42
+ "meta",
43
+ "google",
44
+ "gtm",
45
+ "tiktok",
46
+ "custom"
47
+ ]);
48
+ var TrackingDeliverySchema = import_zod.z.enum(["both", "client_only", "server_only"]);
49
+ var MetaTrackingProviderConfigSchema = import_zod.z.object({
50
+ enabled: import_zod.z.boolean().default(true),
51
+ /** Host credential id; the server resolves the CAPI access token from it. */
52
+ credentialId: import_zod.z.string().optional(),
53
+ /** Meta Pixel ID (e.g. 123456789012345) — public */
54
+ pixelId: import_zod.z.string().optional().default(""),
55
+ /** Enable Server-Side Conversions API (delivered through the host relay) */
56
+ capiEnabled: import_zod.z.boolean().optional().default(false),
57
+ /** Test Event Code from Meta Events Manager (e.g. "TEST12345") — not a secret */
58
+ testEventCode: import_zod.z.string().optional().default("")
59
+ });
60
+ var GoogleTrackingProviderConfigSchema = import_zod.z.object({
61
+ enabled: import_zod.z.boolean().default(true),
62
+ /** Host credential id; the server resolves the Measurement Protocol API secret from it. */
63
+ credentialId: import_zod.z.string().optional(),
64
+ /** GA4 Measurement ID (e.g. "G-XXXXXXXXXX") — public */
65
+ measurementId: import_zod.z.string().optional().default("")
66
+ });
67
+ var GtmTrackingProviderConfigSchema = import_zod.z.object({
68
+ enabled: import_zod.z.boolean().default(true),
69
+ /** Optional linked account/workspace credential ID */
70
+ credentialId: import_zod.z.string().optional(),
71
+ /** GTM Container ID (e.g. "GTM-XXXXXXX") — public */
72
+ containerId: import_zod.z.string().optional().default("")
73
+ });
74
+ var TikTokTrackingProviderConfigSchema = import_zod.z.object({
75
+ enabled: import_zod.z.boolean().default(true),
76
+ /** Host credential id; the server resolves the Events API access token from it. */
77
+ credentialId: import_zod.z.string().optional(),
78
+ /** TikTok Pixel ID (e.g. "C1234567890") — public */
79
+ pixelId: import_zod.z.string().optional().default(""),
80
+ /** Enable TikTok Events API (server-side, delivered through the host relay) */
81
+ eventsApiEnabled: import_zod.z.boolean().optional().default(false),
82
+ /** Test Event Code from TikTok Event Manager — not a secret */
83
+ testEventCode: import_zod.z.string().optional().default("")
84
+ });
85
+ var CustomTrackingProviderConfigSchema = import_zod.z.object({
86
+ enabled: import_zod.z.boolean().default(true),
87
+ /** Host credential id; the server resolves the webhook `endpointUrl` + `headers` from it. */
88
+ credentialId: import_zod.z.string().optional()
89
+ });
90
+ var LEGACY_TRACKING_SECRET_KEYS = Object.freeze({
91
+ meta: ["capiAccessToken", "serverRelayUrl"],
92
+ google: ["measurementProtocolSecret", "serverRelayUrl"],
93
+ gtm: ["serverRelayUrl"],
94
+ tiktok: ["accessToken", "serverRelayUrl"],
95
+ custom: ["endpointUrl", "headers"]
96
+ });
97
+ var TrackingConfigSchema = import_zod.z.object({
98
+ /** Master toggle: dynamically enables or disables all tracking operations */
99
+ enabled: import_zod.z.boolean().default(true),
100
+ /** When enabled, events are logged to console and can bypass live API calls for safe debugging */
101
+ debugMode: import_zod.z.boolean().optional().default(false),
102
+ /** Automatically trigger PageView event upon page load */
103
+ autoPageView: import_zod.z.boolean().optional().default(true),
104
+ /** Default delivery method when not explicitly overridden in an action step */
105
+ defaultDelivery: TrackingDeliverySchema.optional().default("both"),
106
+ /** Provider-specific settings */
107
+ providers: import_zod.z.object({
108
+ meta: MetaTrackingProviderConfigSchema.optional(),
109
+ google: GoogleTrackingProviderConfigSchema.optional(),
110
+ gtm: GtmTrackingProviderConfigSchema.optional(),
111
+ tiktok: TikTokTrackingProviderConfigSchema.optional(),
112
+ custom: CustomTrackingProviderConfigSchema.optional()
113
+ }).optional().default({})
114
+ });
115
+ var MetaTrackingSecretsSchema = import_zod.z.object({
116
+ /** System User access token for the Meta Graph API. */
117
+ capiAccessToken: import_zod.z.string().min(1)
118
+ });
119
+ var GoogleTrackingSecretsSchema = import_zod.z.object({
120
+ /** Measurement Protocol `api_secret`. */
121
+ measurementProtocolSecret: import_zod.z.string().min(1)
122
+ });
123
+ var TikTokTrackingSecretsSchema = import_zod.z.object({
124
+ /** Long-term Events API access token. */
125
+ accessToken: import_zod.z.string().min(1)
126
+ });
127
+ var CustomTrackingSecretsSchema = import_zod.z.object({
128
+ endpointUrl: import_zod.z.string().url(),
129
+ headers: import_zod.z.record(import_zod.z.string(), import_zod.z.string()).optional()
130
+ });
131
+ var StandardTrackingEventSchema = import_zod.z.enum([
132
+ "PageView",
133
+ "ViewContent",
134
+ "AddToCart",
135
+ "InitiateCheckout",
136
+ "Purchase",
137
+ "Lead",
138
+ "Contact",
139
+ "CompleteRegistration",
140
+ "Subscribe",
141
+ "Search",
142
+ "SubmitApplication",
143
+ "Schedule"
144
+ ]);
145
+ var TrackEventProviderSchema = import_zod.z.enum(["all", "meta", "google", "gtm", "tiktok", "custom"]);
146
+ var TrackEventStepPayloadSchema = import_zod.z.object({
147
+ /** Event name: e.g. "Purchase", "Lead", or custom string */
148
+ eventName: import_zod.z.string().min(1, "Event name cannot be empty"),
149
+ /** Standard event vs custom event identifier */
150
+ eventType: import_zod.z.enum(["standard", "custom"]).optional().default("standard"),
151
+ /**
152
+ * Target provider: 'all' or a specific provider.
153
+ * 'gtm' pushes the event to `window.dataLayer` (client-side only).
154
+ */
155
+ provider: TrackEventProviderSchema.optional().default("all"),
156
+ /** Delivery channel: 'both', 'client_only', or 'server_only' */
157
+ delivery: TrackingDeliverySchema.optional().default("both"),
158
+ /**
159
+ * Deduplication Event ID.
160
+ * If omitted, a unique ID is automatically generated so Meta/TikTok CAPI
161
+ * deduplicates cleanly with the browser pixel.
162
+ */
163
+ eventId: import_zod.z.string().optional(),
164
+ /**
165
+ * Event parameters/properties (e.g. currency, value, content_name, order_id).
166
+ * Supports runtime variable interpolation (e.g. {{ form.price }} or {{ variables.currency }}).
167
+ */
168
+ params: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional().default({}),
169
+ /**
170
+ * User Data for advanced matching and server CAPI (e.g. email, phone, firstName, lastName).
171
+ * Supports runtime variable interpolation (e.g. {{ form.email }}).
172
+ */
173
+ userData: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional().default({}),
174
+ /** Step-level active toggle */
175
+ enabled: import_zod.z.boolean().optional().default(true)
176
+ });
177
+ var TRACKING_RELAY_PROTOCOL_VERSION = 1;
178
+ var ServerTrackingEventSchema = import_zod.z.object({
179
+ eventName: import_zod.z.string().min(1).max(256),
180
+ eventType: import_zod.z.enum(["standard", "custom"]).optional(),
181
+ eventId: import_zod.z.string().max(256).optional(),
182
+ /** Unix epoch seconds. */
183
+ eventTime: import_zod.z.number().int().nonnegative().optional(),
184
+ eventSourceUrl: import_zod.z.string().max(4096).optional(),
185
+ actionSource: import_zod.z.enum(["website", "app", "system_generated"]).optional(),
186
+ params: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional(),
187
+ /** Raw (unhashed) user data; the relay hashes PII per provider spec before forwarding. */
188
+ userData: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional(),
189
+ customData: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional()
190
+ });
191
+ var TrackingRelayRequestSchema = import_zod.z.object({
192
+ version: import_zod.z.literal(TRACKING_RELAY_PROTOCOL_VERSION),
193
+ event: ServerTrackingEventSchema,
194
+ provider: TrackEventProviderSchema.optional().default("all"),
195
+ /** Optional hint only; the relay uses the credentialId from its trusted config. */
196
+ credentialId: import_zod.z.string().max(256).optional(),
197
+ /** Host document/page id so the relay can look up the trusted tracking config. */
198
+ documentId: import_zod.z.string().max(256).optional()
199
+ });
200
+ var TrackingRelayProviderResultSchema = import_zod.z.object({
201
+ provider: import_zod.z.string(),
202
+ success: import_zod.z.boolean(),
203
+ status: import_zod.z.number().int().optional(),
204
+ skipped: import_zod.z.boolean().optional(),
205
+ reason: import_zod.z.string().optional(),
206
+ error: import_zod.z.string().optional()
207
+ });
208
+ var TrackingRelayErrorCodeSchema = import_zod.z.enum([
209
+ "INVALID_REQUEST",
210
+ "UNSUPPORTED_VERSION",
211
+ "FORBIDDEN_ORIGIN",
212
+ "METHOD_NOT_ALLOWED",
213
+ "CONFIG_NOT_FOUND",
214
+ "INTERNAL_ERROR"
215
+ ]);
216
+ var TrackingRelayResponseSchema = import_zod.z.object({
217
+ version: import_zod.z.literal(TRACKING_RELAY_PROTOCOL_VERSION),
218
+ success: import_zod.z.boolean(),
219
+ eventId: import_zod.z.string().optional(),
220
+ skipped: import_zod.z.boolean().optional(),
221
+ reason: import_zod.z.string().optional(),
222
+ results: import_zod.z.record(import_zod.z.string(), TrackingRelayProviderResultSchema).optional(),
223
+ error: import_zod.z.object({
224
+ code: TrackingRelayErrorCodeSchema,
225
+ message: import_zod.z.string()
226
+ }).optional()
227
+ });
228
+
229
+ // src/actions.ts
230
+ var ActionTriggerTypeSchema = import_zod2.z.enum([
231
+ "click",
232
+ "submit",
233
+ "change",
234
+ "blur",
235
+ "focus",
236
+ "load",
237
+ // Fired once by time-bound components (e.g. `countdown`) when they reach zero.
238
+ "expire"
239
+ ]);
240
+ var ActionStepTypeSchema = import_zod2.z.enum([
241
+ "api_request",
242
+ "navigate",
243
+ "set_state",
244
+ "reset_form",
245
+ "show_toast",
246
+ "open_modal",
247
+ "close_modal",
248
+ "toggle_modal",
249
+ "copy_clipboard",
250
+ "custom_event",
251
+ "track_event"
252
+ ]);
253
+ var ConditionOperatorSchema = import_zod2.z.enum([
254
+ "equals",
255
+ "not_equals",
256
+ "contains",
257
+ "not_contains",
258
+ "is_truthy",
259
+ "is_falsy",
260
+ "gt",
261
+ "gte",
262
+ "lt",
263
+ "lte",
264
+ "regex"
265
+ ]);
266
+ var ActionStepConditionSchema = import_zod2.z.object({
267
+ field: import_zod2.z.string().min(1, "Condition field cannot be empty"),
268
+ operator: ConditionOperatorSchema,
269
+ value: import_zod2.z.unknown().optional()
270
+ });
271
+ var DANGEROUS_URL_PATTERN = /(javascript:|vbscript:|data:text\/html)/i;
272
+ var DANGEROUS_SCRIPT_PATTERN = /<\s*script/i;
273
+ function isSafeActionUrl(url) {
274
+ if (!url || typeof url !== "string") return false;
275
+ const trimmed = url.trim();
276
+ if (DANGEROUS_URL_PATTERN.test(trimmed)) return false;
277
+ if (DANGEROUS_SCRIPT_PATTERN.test(trimmed)) return false;
278
+ return true;
279
+ }
280
+ var SafeUrlStringSchema = import_zod2.z.string().min(1, "URL cannot be empty").refine(isSafeActionUrl, {
281
+ message: "URL contains disallowed or unsafe protocol/script pattern"
282
+ });
283
+ var SafeEventNameSchema = import_zod2.z.string().min(1, "Event name cannot be empty").regex(/^[a-zA-Z0-9_\-:]+$/, {
284
+ message: "Event name must contain only alphanumeric characters, dashes, colons, or underscores"
285
+ });
286
+ var ApiRequestStepPayloadSchema = import_zod2.z.object({
287
+ url: SafeUrlStringSchema,
288
+ method: import_zod2.z.enum(["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]).default("GET"),
289
+ headers: import_zod2.z.record(import_zod2.z.string(), import_zod2.z.string()).optional(),
290
+ queryParams: import_zod2.z.record(import_zod2.z.string(), import_zod2.z.union([import_zod2.z.string(), import_zod2.z.number(), import_zod2.z.boolean()])).optional(),
291
+ /**
292
+ * Request body. Omitted inside a form `submit` pipeline → the form's values are sent;
293
+ * `null` → explicitly no body.
294
+ */
295
+ body: import_zod2.z.union([import_zod2.z.string(), import_zod2.z.record(import_zod2.z.string(), import_zod2.z.unknown()), import_zod2.z.array(import_zod2.z.unknown())]).nullable().optional(),
296
+ bodyFormat: import_zod2.z.enum(["json", "form-data", "formData", "urlencoded", "url-encoded", "raw", "text"]).optional(),
297
+ bodyType: import_zod2.z.enum(["json", "form-data", "formData", "urlencoded", "url-encoded", "raw", "text"]).optional(),
298
+ timeout: import_zod2.z.number().positive("Timeout must be greater than 0 ms").optional(),
299
+ responseMapping: import_zod2.z.record(import_zod2.z.string(), import_zod2.z.string()).optional()
300
+ });
301
+ var NavigateStepPayloadSchema = import_zod2.z.object({
302
+ url: SafeUrlStringSchema,
303
+ target: import_zod2.z.enum(["_self", "_blank", "_parent", "_top"]).optional().default("_self"),
304
+ replace: import_zod2.z.boolean().optional(),
305
+ scroll: import_zod2.z.boolean().optional(),
306
+ behavior: import_zod2.z.enum(["smooth", "auto"]).optional()
307
+ });
308
+ var SetStateStepPayloadSchema = import_zod2.z.object({
309
+ key: import_zod2.z.string().min(1, "State key cannot be empty"),
310
+ value: import_zod2.z.unknown(),
311
+ scope: import_zod2.z.enum(["runtime", "document", "session", "local"]).optional().default("runtime")
312
+ });
313
+ var ResetFormStepPayloadSchema = import_zod2.z.object({
314
+ formId: import_zod2.z.string().optional()
315
+ });
316
+ var ShowToastStepPayloadSchema = import_zod2.z.object({
317
+ message: import_zod2.z.string().min(1, "Toast message cannot be empty"),
318
+ type: import_zod2.z.enum(["success", "error", "warning", "info"]).optional().default("info"),
319
+ variant: import_zod2.z.enum(["success", "error", "warning", "info"]).optional(),
320
+ title: import_zod2.z.string().optional(),
321
+ duration: import_zod2.z.number().nonnegative("Duration must be >= 0 ms").optional(),
322
+ position: import_zod2.z.enum(["top-right", "top-left", "bottom-right", "bottom-left", "top-center", "bottom-center"]).optional()
323
+ });
324
+ var OpenModalStepPayloadSchema = import_zod2.z.object({
325
+ modalId: import_zod2.z.string().optional(),
326
+ modalNodeId: import_zod2.z.string().optional(),
327
+ toggle: import_zod2.z.boolean().optional()
328
+ }).refine((data) => Boolean(data.modalId || data.modalNodeId), {
329
+ message: "Modal ID or Modal Node ID cannot be empty"
330
+ });
331
+ var CloseModalStepPayloadSchema = import_zod2.z.object({
332
+ modalId: import_zod2.z.string().optional(),
333
+ modalNodeId: import_zod2.z.string().optional()
334
+ });
335
+ var ToggleModalStepPayloadSchema = import_zod2.z.object({
336
+ modalId: import_zod2.z.string().optional(),
337
+ modalNodeId: import_zod2.z.string().optional(),
338
+ targetNodeId: import_zod2.z.string().optional(),
339
+ nodeId: import_zod2.z.string().optional()
340
+ }).refine(
341
+ (data) => [data.modalId, data.modalNodeId, data.targetNodeId, data.nodeId].some(
342
+ (id) => typeof id === "string" && id.trim().length > 0
343
+ ),
344
+ {
345
+ message: "Modal ID or Modal Node ID cannot be empty"
346
+ }
347
+ );
348
+ var CopyClipboardStepPayloadSchema = import_zod2.z.object({
349
+ text: import_zod2.z.string().optional(),
350
+ value: import_zod2.z.unknown().optional(),
351
+ notify: import_zod2.z.boolean().optional(),
352
+ toastMessage: import_zod2.z.string().optional()
353
+ });
354
+ var CustomEventStepPayloadSchema = import_zod2.z.object({
355
+ eventName: SafeEventNameSchema,
356
+ detail: import_zod2.z.record(import_zod2.z.string(), import_zod2.z.unknown()).optional(),
357
+ bubbles: import_zod2.z.boolean().optional().default(true),
358
+ cancelable: import_zod2.z.boolean().optional().default(true)
359
+ });
360
+ var ActionStepSchema = import_zod2.z.lazy(
361
+ () => import_zod2.z.object({
362
+ id: import_zod2.z.string().min(1, "Step ID cannot be empty"),
363
+ type: ActionStepTypeSchema,
364
+ label: import_zod2.z.string().optional(),
365
+ payload: import_zod2.z.record(import_zod2.z.string(), import_zod2.z.unknown()).optional().default({}),
366
+ condition: ActionStepConditionSchema.optional(),
367
+ timeout: import_zod2.z.number().positive().optional(),
368
+ continueOnError: import_zod2.z.boolean().optional(),
369
+ onSuccess: import_zod2.z.array(ActionStepSchema).optional(),
370
+ onError: import_zod2.z.array(ActionStepSchema).optional()
371
+ })
372
+ );
373
+ var ActionPipelineSchema = import_zod2.z.object({
374
+ id: import_zod2.z.string().min(1, "Pipeline ID cannot be empty"),
375
+ trigger: ActionTriggerTypeSchema,
376
+ label: import_zod2.z.string().optional(),
377
+ debounceMs: import_zod2.z.number().nonnegative("Debounce ms must be >= 0").optional(),
378
+ preventDuplicate: import_zod2.z.boolean().optional(),
379
+ enabled: import_zod2.z.boolean().optional().default(true),
380
+ steps: import_zod2.z.array(ActionStepSchema).min(1, "Action pipeline must contain at least one step")
381
+ });
382
+
383
+ // src/form.ts
384
+ var import_zod3 = require("zod");
385
+ var ValidationRuleTypeSchema = import_zod3.z.enum([
386
+ "required",
387
+ "email",
388
+ "url",
389
+ "min_length",
390
+ "max_length",
391
+ "numeric_min",
392
+ "numeric_max",
393
+ "pattern",
394
+ "match_field",
395
+ "custom_regex"
396
+ ]);
397
+ var ValidateOnEventSchema = import_zod3.z.enum(["blur", "change", "submit"]);
398
+ var ValidationRuleSchema = import_zod3.z.object({
399
+ type: ValidationRuleTypeSchema,
400
+ value: import_zod3.z.unknown().optional(),
401
+ message: import_zod3.z.string().min(1, "Validation error message cannot be empty")
402
+ });
403
+ var FormFieldBindingSchema = import_zod3.z.object({
404
+ name: import_zod3.z.string().min(1, "Field name cannot be empty"),
405
+ label: import_zod3.z.string().optional(),
406
+ defaultValue: import_zod3.z.unknown().optional(),
407
+ rules: import_zod3.z.array(ValidationRuleSchema).optional().default([]),
408
+ validateOn: ValidateOnEventSchema.optional().default("blur"),
409
+ transform: import_zod3.z.enum(["trim", "lowercase", "uppercase", "number"]).optional(),
410
+ disabled: import_zod3.z.boolean().optional(),
411
+ required: import_zod3.z.boolean().optional()
412
+ });
413
+ var FormConfigSchema = import_zod3.z.object({
414
+ formId: import_zod3.z.string().min(1, "Form ID cannot be empty"),
415
+ resetOnSubmit: import_zod3.z.boolean().optional().default(false),
416
+ scrollToFirstError: import_zod3.z.boolean().optional().default(true),
417
+ validateOn: ValidateOnEventSchema.optional().default("blur"),
418
+ initialValues: import_zod3.z.record(import_zod3.z.string(), import_zod3.z.unknown()).optional(),
419
+ rules: import_zod3.z.array(ValidationRuleSchema).optional()
420
+ });
421
+
422
+ // src/theme.ts
423
+ var import_zod4 = require("zod");
424
+ var THEME_TOKEN_CSS_PREFIX = Object.freeze({
425
+ colors: "--kb-color-",
426
+ fonts: "--kb-font-",
427
+ radii: "--kb-radius-",
428
+ spacing: "--kb-space-"
429
+ });
430
+ var THEME_TOKEN_KEY_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/;
431
+ var DANGEROUS_THEME_VALUE_PATTERN = /javascript:|expression\(|@import|<script|vbscript:|data:text\/html|url\s*\(/i;
432
+ var FORBIDDEN_THEME_VALUE_CHARS = /[;{}<>\\]/;
433
+ var MAX_THEME_VALUE_LENGTH = 512;
434
+ function isSafeThemeTokenKey(key) {
435
+ return typeof key === "string" && THEME_TOKEN_KEY_PATTERN.test(key);
436
+ }
437
+ function isSafeThemeTokenValue(value) {
438
+ if (typeof value === "number") return Number.isFinite(value);
439
+ if (typeof value !== "string") return false;
440
+ if (value.trim().length === 0 || value.length > MAX_THEME_VALUE_LENGTH) return false;
441
+ if (FORBIDDEN_THEME_VALUE_CHARS.test(value)) return false;
442
+ if (DANGEROUS_THEME_VALUE_PATTERN.test(value)) return false;
443
+ return true;
444
+ }
445
+ var ThemeTokenKeySchema = import_zod4.z.string().refine(isSafeThemeTokenKey, {
446
+ message: 'Theme token key must be 1-64 characters of letters, digits, "-" or "_" (starting with a letter or digit)'
447
+ });
448
+ var ThemeTokenValueSchema = import_zod4.z.union([
449
+ import_zod4.z.string().refine((value) => isSafeThemeTokenValue(value), {
450
+ message: "Theme token value contains a disallowed or unsafe pattern"
451
+ }),
452
+ import_zod4.z.number().refine((value) => Number.isFinite(value), { message: "Theme token value must be finite" })
453
+ ]);
454
+ var ThemeTokenMapSchema = import_zod4.z.record(ThemeTokenKeySchema, ThemeTokenValueSchema);
455
+ var ThemeSchema = import_zod4.z.object({
456
+ colors: ThemeTokenMapSchema.optional(),
457
+ fonts: ThemeTokenMapSchema.optional(),
458
+ radii: ThemeTokenMapSchema.optional(),
459
+ spacing: ThemeTokenMapSchema.optional()
460
+ });
461
+
462
+ // src/document.ts
463
+ var SCHEMA_NAME = "stora.page";
464
+ var CURRENT_SCHEMA_VERSION = "1.2.0";
465
+ var AssetReferenceSchema = import_zod5.z.object({
466
+ type: import_zod5.z.literal("asset"),
467
+ assetId: import_zod5.z.string().min(1, "Asset ID cannot be empty"),
468
+ filename: import_zod5.z.string().optional(),
469
+ mimeType: import_zod5.z.string().optional(),
470
+ fallbackUrl: import_zod5.z.string().url().optional()
471
+ });
472
+ var VariableBindingSchema = import_zod5.z.object({
473
+ type: import_zod5.z.literal("variable"),
474
+ key: import_zod5.z.string().min(1, "Variable key cannot be empty"),
475
+ fallback: import_zod5.z.unknown().optional()
476
+ });
477
+ var ActionBindingSchema = import_zod5.z.object({
478
+ type: import_zod5.z.string().min(1, "Action type cannot be empty"),
479
+ payload: import_zod5.z.record(import_zod5.z.string(), import_zod5.z.unknown()).optional()
480
+ });
481
+ var DANGEROUS_STYLE_VALUE_PATTERN = /javascript:|expression\(|@import|<script|vbscript:|data:text\/html/i;
482
+ var StyleValueSchema = import_zod5.z.union([
483
+ import_zod5.z.string().refine((value) => !DANGEROUS_STYLE_VALUE_PATTERN.test(value), {
484
+ message: "Style value contains a disallowed or unsafe pattern"
485
+ }),
486
+ import_zod5.z.number(),
487
+ import_zod5.z.boolean(),
488
+ import_zod5.z.null(),
489
+ import_zod5.z.undefined()
490
+ ]);
491
+ var StyleDefinitionSchema = import_zod5.z.record(import_zod5.z.string(), StyleValueSchema);
492
+ var PseudoStateStylesSchema = import_zod5.z.record(import_zod5.z.string(), StyleDefinitionSchema);
493
+ var ResponsiveStylesSchema = import_zod5.z.object({
494
+ base: StyleDefinitionSchema.optional(),
495
+ desktop: StyleDefinitionSchema.optional(),
496
+ tablet: StyleDefinitionSchema.optional(),
497
+ mobile: StyleDefinitionSchema.optional(),
498
+ states: PseudoStateStylesSchema.optional()
499
+ }).passthrough().default({});
500
+ var AnimationConfigSchema = import_zod5.z.object({
501
+ type: import_zod5.z.string().refine((value) => !DANGEROUS_STYLE_VALUE_PATTERN.test(value), {
502
+ message: "Animation type contains a disallowed or unsafe pattern"
503
+ }).optional().default("none"),
504
+ duration: import_zod5.z.number().min(0, "Duration must be non-negative").optional().default(600),
505
+ delay: import_zod5.z.number().min(0, "Delay must be non-negative").optional().default(0),
506
+ easing: import_zod5.z.string().refine((value) => !DANGEROUS_STYLE_VALUE_PATTERN.test(value), {
507
+ message: "Animation easing contains a disallowed or unsafe pattern"
508
+ }).optional().default("ease-out"),
509
+ once: import_zod5.z.boolean().optional().default(true),
510
+ hoverEffect: import_zod5.z.string().refine((value) => !DANGEROUS_STYLE_VALUE_PATTERN.test(value), {
511
+ message: "Hover effect contains a disallowed or unsafe pattern"
512
+ }).optional().default("none"),
513
+ loopEffect: import_zod5.z.string().refine((value) => !DANGEROUS_STYLE_VALUE_PATTERN.test(value), {
514
+ message: "Loop effect contains a disallowed or unsafe pattern"
515
+ }).optional().default("none")
516
+ });
517
+ var NodeSchema = import_zod5.z.lazy(
518
+ () => import_zod5.z.object({
519
+ id: import_zod5.z.string().min(1, "Node ID must be a non-empty string"),
520
+ type: import_zod5.z.string().min(1, "Node type must be a non-empty string"),
521
+ props: import_zod5.z.record(import_zod5.z.string(), import_zod5.z.unknown()).optional().default({}),
522
+ styles: ResponsiveStylesSchema.optional().default({}),
523
+ animation: AnimationConfigSchema.optional(),
524
+ actions: import_zod5.z.array(ActionPipelineSchema).optional(),
525
+ formConfig: FormConfigSchema.optional(),
526
+ children: import_zod5.z.array(NodeSchema).optional().default([])
527
+ })
528
+ );
529
+ var RootPageNodeSchema = NodeSchema.refine(
530
+ (node) => node.type === "page",
531
+ {
532
+ message: 'Root node must have type "page"',
533
+ path: ["type"]
534
+ }
535
+ );
536
+ var DocumentMetadataSchema = import_zod5.z.object({
537
+ title: import_zod5.z.string().min(1, "Title is required").default("Untitled Page"),
538
+ description: import_zod5.z.string().optional().default(""),
539
+ author: import_zod5.z.string().optional().default(""),
540
+ createdAt: import_zod5.z.string().optional(),
541
+ updatedAt: import_zod5.z.string().optional(),
542
+ tags: import_zod5.z.array(import_zod5.z.string()).optional().default([]),
543
+ category: import_zod5.z.string().optional().default("general"),
544
+ version: import_zod5.z.string().optional().default("1.0.0"),
545
+ custom: import_zod5.z.record(import_zod5.z.string(), import_zod5.z.unknown()).optional(),
546
+ tracking: TrackingConfigSchema.optional()
547
+ });
548
+ var PageDocumentSchema = import_zod5.z.object({
549
+ schema: import_zod5.z.literal(SCHEMA_NAME),
550
+ version: import_zod5.z.string().min(1, "Schema version is required").default(CURRENT_SCHEMA_VERSION),
551
+ metadata: DocumentMetadataSchema.optional(),
552
+ tracking: TrackingConfigSchema.optional(),
553
+ theme: ThemeSchema.optional(),
554
+ document: RootPageNodeSchema
555
+ });
556
+ var PROJECT_SCHEMA_NAME = "stora.project";
557
+ var CURRENT_PROJECT_SCHEMA_VERSION = "1.0.0";
558
+ var ArtboardTypeSchema = import_zod5.z.enum(["page", "component"]);
559
+ var ArtboardSchema = import_zod5.z.object({
560
+ id: import_zod5.z.string().min(1, "Artboard ID is required"),
561
+ name: import_zod5.z.string().min(1, "Artboard name is required"),
562
+ artboardType: ArtboardTypeSchema,
563
+ /** Route for page artboards (e.g. "/about"). */
564
+ slug: import_zod5.z.string().optional(),
565
+ /**
566
+ * For component artboards: the id that `open_modal` / `close_modal` actions target.
567
+ * Mirrors the detached node's own `props.modalId` so ModalManager keeps working unchanged.
568
+ */
569
+ triggerId: import_zod5.z.string().optional(),
570
+ /**
571
+ * Viewport/breakpoint this artboard is currently authored at. Declared inline
572
+ * (rather than imported) because viewport is otherwise an editor/renderer concept.
573
+ */
574
+ viewport: import_zod5.z.enum(["desktop", "tablet", "mobile"]).optional(),
575
+ /** Persisted artboard width in px, matching the canvas ViewportResizer's `width`. */
576
+ width: import_zod5.z.number().positive().optional(),
577
+ /**
578
+ * Free position on the builder's infinite canvas, in unscaled canvas px. Absent means
579
+ * "not placed yet" — the canvas then falls back to laying the artboard out in a row.
580
+ */
581
+ position: import_zod5.z.object({
582
+ x: import_zod5.z.number(),
583
+ y: import_zod5.z.number()
584
+ }).optional(),
585
+ document: PageDocumentSchema
586
+ });
587
+ var ProjectDocumentSchema = import_zod5.z.object({
588
+ schema: import_zod5.z.literal(PROJECT_SCHEMA_NAME),
589
+ version: import_zod5.z.string().min(1, "Schema version is required").default(CURRENT_PROJECT_SCHEMA_VERSION),
590
+ metadata: DocumentMetadataSchema.optional(),
591
+ tracking: TrackingConfigSchema.optional(),
592
+ artboards: import_zod5.z.array(ArtboardSchema).min(1, "A project needs at least one artboard"),
593
+ activeArtboardId: import_zod5.z.string().optional()
594
+ });
595
+
596
+ // src/manifest.ts
597
+ var import_zod6 = require("zod");
598
+ var ManifestAssetItemSchema = import_zod6.z.object({
599
+ id: import_zod6.z.string().min(1, "Asset ID cannot be empty"),
600
+ path: import_zod6.z.string().min(1, "Asset archive path cannot be empty"),
601
+ mimeType: import_zod6.z.string().min(1, "MIME type cannot be empty"),
602
+ size: import_zod6.z.number().nonnegative("Asset size must be non-negative"),
603
+ checksum: import_zod6.z.string().optional()
604
+ });
605
+ var ManifestSchema = import_zod6.z.object({
606
+ schema: import_zod6.z.literal(SCHEMA_NAME).default(SCHEMA_NAME),
607
+ schemaVersion: import_zod6.z.string().min(1, "Schema version cannot be empty").default("1.0.0"),
608
+ packageVersion: import_zod6.z.string().min(1, "Package version cannot be empty").default("1.0.0"),
609
+ builderCompatibility: import_zod6.z.string().default(">=0.1.0"),
610
+ requiredComponents: import_zod6.z.array(import_zod6.z.string()).default([]),
611
+ requiredCapabilities: import_zod6.z.array(import_zod6.z.string()).default([]),
612
+ assets: import_zod6.z.array(ManifestAssetItemSchema).default([]),
613
+ createdAt: import_zod6.z.string().optional()
614
+ });
615
+
616
+ // src/template.ts
617
+ var import_zod7 = require("zod");
618
+ var DANGEROUS_URI_PATTERN = /^(javascript:|vbscript:|data:(?!image\/))|<script/i;
619
+ function isSafeThumbnailUrl(url) {
620
+ if (!url || typeof url !== "string") return false;
621
+ const trimmed = url.trim();
622
+ if (trimmed.length === 0) return false;
623
+ if (DANGEROUS_URI_PATTERN.test(trimmed)) return false;
624
+ return true;
625
+ }
626
+ var SafeThumbnailUrlSchema = import_zod7.z.string().min(1, "Thumbnail URL cannot be empty").refine(
627
+ (url) => isSafeThumbnailUrl(url),
628
+ { message: "Thumbnail URL contains an unsafe protocol or payload" }
629
+ );
630
+ var SafeThumbnailObjectSchema = import_zod7.z.object({
631
+ url: SafeThumbnailUrlSchema,
632
+ alt: import_zod7.z.string().optional(),
633
+ width: import_zod7.z.number().positive().optional(),
634
+ height: import_zod7.z.number().positive().optional()
635
+ });
636
+ var SafeThumbnailSchema = import_zod7.z.union([
637
+ AssetReferenceSchema,
638
+ SafeThumbnailObjectSchema,
639
+ SafeThumbnailUrlSchema
640
+ ]);
641
+ var TemplatePackageRefSchema = import_zod7.z.object({
642
+ path: import_zod7.z.string().optional(),
643
+ url: SafeThumbnailUrlSchema.optional(),
644
+ checksum: import_zod7.z.string().optional(),
645
+ format: import_zod7.z.enum(["stora", "json"]).default("stora")
646
+ });
647
+ var TemplateRequirementsSchema = import_zod7.z.object({
648
+ requiredComponents: import_zod7.z.array(import_zod7.z.string()).default([]),
649
+ requiredCapabilities: import_zod7.z.array(import_zod7.z.string()).default([])
650
+ });
651
+ var TemplateRecordSchema = import_zod7.z.object({
652
+ id: import_zod7.z.string().min(1, "Template ID must be a non-empty string"),
653
+ name: import_zod7.z.string().min(1, "Template name must be a non-empty string"),
654
+ description: import_zod7.z.string().optional().default(""),
655
+ category: import_zod7.z.string().optional().default("general"),
656
+ tags: import_zod7.z.array(import_zod7.z.string()).optional().default([]),
657
+ thumbnail: SafeThumbnailSchema.optional(),
658
+ author: import_zod7.z.string().optional().default(""),
659
+ version: import_zod7.z.string().optional().default("1.0.0"),
660
+ document: PageDocumentSchema.optional(),
661
+ packageReference: TemplatePackageRefSchema.optional(),
662
+ requirements: TemplateRequirementsSchema.default({
663
+ requiredComponents: [],
664
+ requiredCapabilities: []
665
+ }),
666
+ createdAt: import_zod7.z.string().optional(),
667
+ updatedAt: import_zod7.z.string().optional(),
668
+ custom: import_zod7.z.record(import_zod7.z.string(), import_zod7.z.unknown()).optional()
669
+ });
670
+
671
+ // src/validate.ts
672
+ function run(schema, input) {
673
+ const result = schema.safeParse(input);
674
+ if (result.success) {
675
+ return { success: true, data: result.data, issues: [] };
676
+ }
677
+ const issues = result.error.issues.map((issue) => ({
678
+ path: issue.path.map((segment) => String(segment)).join("."),
679
+ message: issue.message,
680
+ code: String(issue.code)
681
+ }));
682
+ return { success: false, issues };
683
+ }
684
+ function validateDocument(input) {
685
+ return run(PageDocumentSchema, input);
686
+ }
687
+ function validateNode(input) {
688
+ return run(NodeSchema, input);
689
+ }
690
+ function validateProjectDocument(input) {
691
+ return run(ProjectDocumentSchema, input);
692
+ }
693
+ function validateTemplateRecord(input) {
694
+ return run(TemplateRecordSchema, input);
695
+ }
696
+ function validateManifest(input) {
697
+ return run(ManifestSchema, input);
698
+ }
699
+ function validateTheme(input) {
700
+ return run(ThemeSchema, input);
701
+ }
702
+ function isValidPageDocument(input) {
703
+ return validateDocument(input).success;
704
+ }
705
+ // Annotate the CommonJS export names for ESM import in node:
706
+ 0 && (module.exports = {
707
+ isValidPageDocument,
708
+ validateDocument,
709
+ validateManifest,
710
+ validateNode,
711
+ validateProjectDocument,
712
+ validateTemplateRecord,
713
+ validateTheme
714
+ });
715
+ //# sourceMappingURL=validate.cjs.map