@zitadel/config 0.1.0-alpha.17 → 0.1.0-alpha.19

package/dist/{meta-schemas-8nlyVL7g.mjs → meta-schemas-CSc18JqO.mjs}

@@ -3,18 +3,12 @@ var auth_method_default = {
 	$schema: "https://json-schema.org/draft/2020-12/schema",
 	title: "AuthMethod",
 	type: "object",
-	required: ["enabled", "position"],
-	properties: {
-		"enabled": {
-			"type": "boolean",
-			"description": "Whether the authentication method is enabled or not"
-		},
-		"position": {
-			"type": "integer",
-			"minimum": 0,
-			"description": "The position of the authentication method in the list of supported methods"
-		}
-	}
+	required: ["enabled"],
+	additionalProperties: false,
+	properties: { "enabled": {
+		"type": "boolean",
+		"description": "Whether the authentication method is enabled or not"
+	} }
 };
 //#endregion
 //#region meta-schemas/auth-methods.json
@@ -33,6 +27,50 @@ var auth_methods_default = {
 	}
 };
 //#endregion
+//#region meta-schemas/branding.json
+var branding_default = {
+	$schema: "https://json-schema.org/draft/2020-12/schema",
+	title: "Branding",
+	description: "Local branding descriptor for the login UI. Carries the layout preset, asset URLs, and the LiquidJS template (by file reference or inline). `zitadel apply` publishes this as an immutable branding revision; flow responses resolve the latest revision per project (ADR 040). This schema describes the local configuration shape only.",
+	type: "object",
+	additionalProperties: false,
+	properties: {
+		"$schema": {
+			"type": "string",
+			"description": "Editor affordance: path or URL of this meta-schema so editors validate and autocomplete the file (scaffolded branding files point at `.zitadel/meta/branding.json`). Ignored by the platform."
+		},
+		"layout": {
+			"type": "string",
+			"enum": ["centered", "split"],
+			"default": "centered",
+			"description": "Degrade preset (`centered` or `split`) the bundled default template branches on, not the complete design catalog. All named designs (`centered`, `split`, `split-right`, `hero`, `minimal`) ship as templates and map onto one of these two values; switch designs with the `branding eject --design <name>` command instead of editing this field. Custom templates may ignore it; the preset is also used when a template fails component-side validation."
+		},
+		"liquid_template_file": {
+			"type": "string",
+			"examples": ["./login.liquid"],
+			"description": "Path to the LiquidJS template file, relative to this descriptor. The CLI inlines the file content into `liquid_template` when publishing, and writes server state back to the file. Mutually exclusive with `liquid_template`."
+		},
+		"liquid_template": {
+			"type": "string",
+			"maxLength": 131072,
+			"description": "Inline LiquidJS template string. Prefer `liquid_template_file` — a real `.liquid` file edits far better than a JSON-escaped string. Mutually exclusive with `liquid_template_file`."
+		},
+		"logo_url": {
+			"type": "string",
+			"format": "uri",
+			"pattern": "^([hH][tT][tT][pP][sS]://|[hH][tT][tT][pP]://([lL][oO][cC][aA][lL][hH][oO][sS][tT]|127\\.(?:(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])\\.){2}(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])|\\[::1\\])(?::0*(?:[0-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?([/?#]|$))",
+			"description": "Logo URL (https required; canonical loopback http is allowed for local development and renders only on loopback pages)."
+		},
+		"hero_url": {
+			"type": "string",
+			"format": "uri",
+			"pattern": "^([hH][tT][tT][pP][sS]://|[hH][tT][tT][pP]://([lL][oO][cC][aA][lL][hH][oO][sS][tT]|127\\.(?:(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])\\.){2}(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])|\\[::1\\])(?::0*(?:[0-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?([/?#]|$))",
+			"description": "Hero/background image URL (https required; canonical loopback http is allowed for local development and renders only on loopback pages), used by split designs."
+		}
+	},
+	not: { "required": ["liquid_template", "liquid_template_file"] }
+};
+//#endregion
 //#region meta-schemas/flow-definition.json
 var flow_definition_default = {
 	$schema: "https://json-schema.org/draft/2020-12/schema",
@@ -297,12 +335,34 @@ var flow_definition_default = {
 						null
 					],
 					"description": "How to interpret `target`. - Omitted: transition to a step in the current definition. - `switch`: replace the current flow with the target flow.   No return; the current flow is discarded. Typical use:   navigating between peer flows like login ↔ register. - `pivot`: push the target flow onto the stack. The current   flow is paused; when the target flow completes the engine   auto-pops back. Typical use: login → recovery → back to login."
+				},
+				"purpose": {
+					"type": ["string", "null"],
+					"enum": [
+						"login",
+						"register",
+						"recovery",
+						"profiling",
+						"reauth",
+						"link_account",
+						null
+					],
+					"description": "Local re-purposing. When set, taking this transition changes the flow's current purpose to this value — the dispatch mode a step's challenges run under — while the flow's original purpose stays pinned. Must be a purpose this definition serves, and `target` must be that purpose's entry step. Mutually exclusive with `action`: a transition either re-purposes within this flow or targets another flow, never both. Example: a \"Sign up\" navigation on the login identifier step (`{ \"target\": \"register\", \"purpose\": \"register\" }`)."
 				}
 			}
 		}
 	}
 };
 //#endregion
+//#region meta-schemas/property-name.json
+var property_name_default = {
+	$schema: "https://json-schema.org/draft/2020-12/schema",
+	title: "PropertyName",
+	type: "string",
+	pattern: "^[^.]+$",
+	description: "The name of a single user attribute."
+};
+//#endregion
 //#region meta-schemas/user-property.json
 var user_property_default = {
 	$schema: "https://json-schema.org/draft/2020-12/schema",
@@ -316,10 +376,6 @@ var user_property_default = {
 			"const": "https://json-schema.org/draft/2020-12/schema",
 			"description": "The JSON Schema version used for this schema."
 		},
-		"x-verify": {
-			"oneOf": [{ "type": "string" }, { "type": "null" }],
-			"description": "The verification method for this property, if applicable"
-		},
 		"x-unique": {
 			"oneOf": [{
 				"type": "string",
@@ -335,25 +391,16 @@ var user_property_default = {
 			"oneOf": [{ "type": "string" }, { "type": "null" }],
 			"description": "The claim name for this property, if applicable"
 		},
-		"x-editable": {
-			"type": "boolean",
-			"default": true,
-			"description": "Whether this property is editable by the user or not"
-		},
-		"x-sensitive": {
-			"type": "boolean",
-			"default": false,
-			"description": "Whether this property contains sensitive information or not"
-		},
-		"x-mfa": {
+		"x-audit": {
 			"type": "boolean",
 			"default": false,
-			"description": "Whether this property is used for multi-factor authentication or not"
+			"description": "Whether this property's value may appear in audit event payloads. Audit payloads are deny-by-default: a property without this annotation contributes its key but never its value."
 		},
 		"properties": {
 			"type": "object",
 			"description": "A map of additional properties for the user definition, where the key is the property name and the value is the property schema",
-			"additionalProperties": true
+			"propertyNames": { "$ref": "property-name.json" },
+			"additionalProperties": { "$ref": "user-property.json" }
 		}
 	}
 };
@@ -397,6 +444,7 @@ var user_schema_default = {
 		"properties": {
 			"type": "object",
 			"description": "A map of additional properties for the user definition, where the key is the property name and the value is the property schema",
+			"propertyNames": { "$ref": "property-name.json" },
 			"additionalProperties": { "$ref": "user-property.json" }
 		}
 	}
@@ -422,6 +470,11 @@ const META_SCHEMA_DIR = ".zitadel/meta";
 */
 const FLOW_FILE_SCHEMA_REF = "../meta/flow-definition.json";
 /**
+* The `$schema` value scaffolded branding files carry, relative to
+* `.zitadel/branding/` — resolves to `{@link META_SCHEMA_DIR}/branding.json`.
+*/
+const BRANDING_FILE_SCHEMA_REF = "../meta/branding.json";
+/**
 * The dialect files to materialize, in write order. `auth-methods.json` and
 * `auth-method.json` are pulled in by `user-schema.json`'s relative `$ref`s —
 * without them the copied dialect cannot resolve offline.
@@ -440,6 +493,10 @@ function metaSchemaFiles() {
 			name: "user-property.json",
 			body: user_property_default
 		},
+		{
+			name: "property-name.json",
+			body: property_name_default
+		},
 		{
 			name: "auth-methods.json",
 			body: auth_methods_default
@@ -447,10 +504,14 @@ function metaSchemaFiles() {
 		{
 			name: "auth-method.json",
 			body: auth_method_default
+		},
+		{
+			name: "branding.json",
+			body: branding_default
 		}
 	];
 }
 //#endregion
-export { META_SCHEMA_DIR as n, metaSchemaFiles as r, FLOW_FILE_SCHEMA_REF as t };
+export { metaSchemaFiles as i, FLOW_FILE_SCHEMA_REF as n, META_SCHEMA_DIR as r, BRANDING_FILE_SCHEMA_REF as t };
 
-//# sourceMappingURL=meta-schemas-8nlyVL7g.mjs.map
+//# sourceMappingURL=meta-schemas-CSc18JqO.mjs.map

package/dist/meta-schemas-CSc18JqO.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-schemas-CSc18JqO.mjs","names":["flowDefinitionMetaSchema","userSchemaMetaSchema","userPropertyMetaSchema","propertyNameMetaSchema","authMethodsMetaSchema","authMethodMetaSchema","brandingMetaSchema"],"sources":["../meta-schemas/auth-method.json","../meta-schemas/auth-methods.json","../meta-schemas/branding.json","../meta-schemas/flow-definition.json","../meta-schemas/property-name.json","../meta-schemas/user-property.json","../meta-schemas/user-schema.json","../src/meta-schemas.ts"],"sourcesContent":["","","","","","","","/**\n * The dialect meta-schemas `zitadel setup` copies into a project's\n * `.zitadel/meta/` so the flow/schema dialect is machine-readable offline:\n * editors validate flow files against `flow-definition.json` via a relative\n * `$schema` pointer, and agents read the dialect files before authoring\n * edits — no docs crawl, no hosted schema required.\n *\n * The files under `meta-schemas/` are committed copies of\n * `api/openapi/endpoints/schemas/*.json` (the source the server embeds);\n * a drift-audit test keeps them byte-identical in the monorepo.\n */\nimport authMethodMetaSchema from \"../meta-schemas/auth-method.json\" with {\n  type: \"json\",\n};\nimport authMethodsMetaSchema from \"../meta-schemas/auth-methods.json\" with {\n  type: \"json\",\n};\nimport brandingMetaSchema from \"../meta-schemas/branding.json\" with {\n  type: \"json\",\n};\nimport flowDefinitionMetaSchema from \"../meta-schemas/flow-definition.json\" with {\n  type: \"json\",\n};\nimport propertyNameMetaSchema from \"../meta-schemas/property-name.json\" with {\n  type: \"json\",\n};\nimport userPropertyMetaSchema from \"../meta-schemas/user-property.json\" with {\n  type: \"json\",\n};\nimport userSchemaMetaSchema from \"../meta-schemas/user-schema.json\" with {\n  type: \"json\",\n};\n\n/** Project-relative directory setup writes the meta-schemas to. */\nexport const META_SCHEMA_DIR = \".zitadel/meta\";\n\n/**\n * The `$schema` value scaffolded flow files carry, relative to\n * `.zitadel/flows/` — resolves to `{@link META_SCHEMA_DIR}/flow-definition.json`.\n */\nexport const FLOW_FILE_SCHEMA_REF = \"../meta/flow-definition.json\";\n\n/**\n * The `$schema` value scaffolded branding files carry, relative to\n * `.zitadel/branding/` — resolves to `{@link META_SCHEMA_DIR}/branding.json`.\n */\nexport const BRANDING_FILE_SCHEMA_REF = \"../meta/branding.json\";\n\nexport type MetaSchemaFile = { name: string; body: object };\n\n/**\n * The dialect files to materialize, in write order. `auth-methods.json` and\n * `auth-method.json` are pulled in by `user-schema.json`'s relative `$ref`s —\n * without them the copied dialect cannot resolve offline.\n */\nexport function metaSchemaFiles(): ReadonlyArray<MetaSchemaFile> {\n  return [\n    { name: \"flow-definition.json\", body: flowDefinitionMetaSchema as object },\n    { name: \"user-schema.json\", body: userSchemaMetaSchema as object },\n    { name: \"user-property.json\", body: userPropertyMetaSchema as object },\n    { name: \"property-name.json\", body: propertyNameMetaSchema as object },\n    { name: \"auth-methods.json\", body: authMethodsMetaSchema as object },\n    { name: \"auth-method.json\", body: authMethodMetaSchema as object },\n    { name: \"branding.json\", body: brandingMetaSchema as object },\n  ];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AOkCA,MAAa,kBAAkB;;;;;AAM/B,MAAa,uBAAuB;;;;;AAMpC,MAAa,2BAA2B;;;;;;AASxC,SAAgB,kBAAiD;AAC/D,QAAO;EACL;GAAE,MAAM;GAAwB,MAAMA;GAAoC;EAC1E;GAAE,MAAM;GAAoB,MAAMC;GAAgC;EAClE;GAAE,MAAM;GAAsB,MAAMC;GAAkC;EACtE;GAAE,MAAM;GAAsB,MAAMC;GAAkC;EACtE;GAAE,MAAM;GAAqB,MAAMC;GAAiC;EACpE;GAAE,MAAM;GAAoB,MAAMC;GAAgC;EAClE;GAAE,MAAM;GAAiB,MAAMC;GAA8B;EAC9D"}

package/dist/meta-schemas.d.mts

@@ -6,6 +6,11 @@ declare const META_SCHEMA_DIR = ".zitadel/meta";
  * `.zitadel/flows/` — resolves to `{@link META_SCHEMA_DIR}/flow-definition.json`.
  */
 declare const FLOW_FILE_SCHEMA_REF = "../meta/flow-definition.json";
+/**
+ * The `$schema` value scaffolded branding files carry, relative to
+ * `.zitadel/branding/` — resolves to `{@link META_SCHEMA_DIR}/branding.json`.
+ */
+declare const BRANDING_FILE_SCHEMA_REF = "../meta/branding.json";
 type MetaSchemaFile = {
   name: string;
   body: object;
@@ -17,5 +22,5 @@ type MetaSchemaFile = {
  */
 declare function metaSchemaFiles(): ReadonlyArray<MetaSchemaFile>;
 //#endregion
-export { FLOW_FILE_SCHEMA_REF, META_SCHEMA_DIR, MetaSchemaFile, metaSchemaFiles };
+export { BRANDING_FILE_SCHEMA_REF, FLOW_FILE_SCHEMA_REF, META_SCHEMA_DIR, MetaSchemaFile, metaSchemaFiles };
 //# sourceMappingURL=meta-schemas.d.mts.map

package/dist/meta-schemas.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"meta-schemas.d.mts","names":[],"sources":["../src/meta-schemas.ts"],"mappings":";;cA4Ba,eAAA;;;;;cAMA,oBAAA;AAAA,KAED,cAAA;EAAmB,IAAA;EAAc,IAAA;AAAA;AAA7C;;;;;AAAA,iBAOgB,eAAA,CAAA,GAAmB,aAAA,CAAc,cAAA"}
+{"version":3,"file":"meta-schemas.d.mts","names":[],"sources":["../src/meta-schemas.ts"],"mappings":";;cAkCa,eAAA;;;;;cAMA,oBAAA;;;;;cAMA,wBAAA;AAAA,KAED,cAAA;EAAmB,IAAA;EAAc,IAAA;AAAA;AAA7C;;;;;AAAA,iBAOgB,eAAA,CAAA,GAAmB,aAAA,CAAc,cAAA"}

package/dist/meta-schemas.mjs

@@ -1,2 +1,2 @@
-import { n as META_SCHEMA_DIR, r as metaSchemaFiles, t as FLOW_FILE_SCHEMA_REF } from "./meta-schemas-8nlyVL7g.mjs";
-export { FLOW_FILE_SCHEMA_REF, META_SCHEMA_DIR, metaSchemaFiles };
+import { i as metaSchemaFiles, n as FLOW_FILE_SCHEMA_REF, r as META_SCHEMA_DIR, t as BRANDING_FILE_SCHEMA_REF } from "./meta-schemas-CSc18JqO.mjs";
+export { BRANDING_FILE_SCHEMA_REF, FLOW_FILE_SCHEMA_REF, META_SCHEMA_DIR, metaSchemaFiles };

package/dist/normalize.d.mts

@@ -5,21 +5,22 @@
  * The sync engine compares `.zitadel/**` files against server responses;
  * the server echoes fields the author never wrote (an empty `audience`
  * on flows) and the meta-schema declares defaults an author may or may
- * not spell out (`x-editable` et al on schema properties). Normalizing
- * both sides before hashing or diffing keeps a one-field edit rendering
- * as a one-field diff.
+ * not spell out (`x-audit` on schema properties). Normalizing both
+ * sides before hashing or diffing keeps a one-field edit rendering as a
+ * one-field diff.
  *
  * Normalized bodies are for COMPARISON. Never upload them, and never
  * write a normalized schema body to a file: the server stores schema
  * bytes verbatim without materializing meta-schema defaults, so a
- * stripped `"x-editable": true` would vanish from the next published
+ * stripped `"x-audit": false` would vanish from the next published
  * revision. (Flow write-back may reuse {@link normalizeFlowBody} —
  * everything it strips is pure transport noise.)
  */
 /**
  * Property-level defaults declared by the user-property meta-schema
  * (`api/openapi/endpoints/schemas/user-property.json`). A property that
- * spells one of these out is semantically identical to one that omits it.
+ * spells one of these out is semantically identical to one that omits it:
+ * audit payloads deny by default.
  */
 declare const USER_PROPERTY_DEFAULTS: Readonly<Record<string, boolean>>;
 /**
@@ -34,10 +35,11 @@ declare const USER_PROPERTY_DEFAULTS: Readonly<Record<string, boolean>>;
 declare function normalizeFlowBody(body: object): object;
 /**
  * Return a deep copy of a user-schema body with meta-schema property
- * defaults stripped: a property carrying `"x-editable": true` (or the
- * other {@link USER_PROPERTY_DEFAULTS}) normalizes to one omitting it.
- * Only exact default values are removed; `$id` and every other field
- * pass through untouched.
+ * defaults stripped: a property carrying one of the
+ * {@link USER_PROPERTY_DEFAULTS} normalizes to one omitting it. Only
+ * exact default values are removed; `$id` and every other field pass
+ * through untouched. Nested `properties` are descended into, so a leaf
+ * of an object property normalizes the same way a top-level one does.
  */
 declare function normalizeSchemaBody(body: object): object;
 //#endregion

package/dist/normalize.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.d.mts","names":[],"sources":["../src/normalize.ts"],"mappings":";;AAuBA;;;;;AA0CA;;;;;AAmBA;;;;;;;;;;;cA7Da,sBAAA,EAAwB,QAAA,CAAS,MAAA;;;;;;;;;;iBA0C9B,iBAAA,CAAkB,IAAA;;;;;;;;iBAmBlB,mBAAA,CAAoB,IAAA"}
+{"version":3,"file":"normalize.d.mts","names":[],"sources":["../src/normalize.ts"],"mappings":";;AAwBA;;;;;AAwCA;;;;;AAoBA;;;;;;;;;;;;cA5Da,sBAAA,EAAwB,QAAA,CAAS,MAAA;;;;;;;;;;iBAwC9B,iBAAA,CAAkB,IAAA;;;;;;;;;iBAoBlB,mBAAA,CAAoB,IAAA"}

package/dist/normalize.mjs

@@ -5,27 +5,24 @@
 * The sync engine compares `.zitadel/**` files against server responses;
 * the server echoes fields the author never wrote (an empty `audience`
 * on flows) and the meta-schema declares defaults an author may or may
-* not spell out (`x-editable` et al on schema properties). Normalizing
-* both sides before hashing or diffing keeps a one-field edit rendering
-* as a one-field diff.
+* not spell out (`x-audit` on schema properties). Normalizing both
+* sides before hashing or diffing keeps a one-field edit rendering as a
+* one-field diff.
 *
 * Normalized bodies are for COMPARISON. Never upload them, and never
 * write a normalized schema body to a file: the server stores schema
 * bytes verbatim without materializing meta-schema defaults, so a
-* stripped `"x-editable": true` would vanish from the next published
+* stripped `"x-audit": false` would vanish from the next published
 * revision. (Flow write-back may reuse {@link normalizeFlowBody} —
 * everything it strips is pure transport noise.)
 */
 /**
 * Property-level defaults declared by the user-property meta-schema
 * (`api/openapi/endpoints/schemas/user-property.json`). A property that
-* spells one of these out is semantically identical to one that omits it.
+* spells one of these out is semantically identical to one that omits it:
+* audit payloads deny by default.
 */
-const USER_PROPERTY_DEFAULTS = {
-	"x-editable": true,
-	"x-sensitive": false,
-	"x-mfa": false
-};
+const USER_PROPERTY_DEFAULTS = { "x-audit": false };
 /**
 * Keys of the flow-definition detail envelope. `fetch` in the flow syncer
 * already unwraps the envelope; stripping them here as well makes the
@@ -68,19 +65,29 @@ function normalizeFlowBody(body) {
 }
 /**
 * Return a deep copy of a user-schema body with meta-schema property
-* defaults stripped: a property carrying `"x-editable": true` (or the
-* other {@link USER_PROPERTY_DEFAULTS}) normalizes to one omitting it.
-* Only exact default values are removed; `$id` and every other field
-* pass through untouched.
+* defaults stripped: a property carrying one of the
+* {@link USER_PROPERTY_DEFAULTS} normalizes to one omitting it. Only
+* exact default values are removed; `$id` and every other field pass
+* through untouched. Nested `properties` are descended into, so a leaf
+* of an object property normalizes the same way a top-level one does.
 */
 function normalizeSchemaBody(body) {
 	const result = structuredClone(body);
-	if (!isPlainObject(result.properties)) return result;
-	for (const property of Object.values(result.properties)) {
+	stripPropertyDefaults(result);
+	return result;
+}
+/**
+* Strip {@link USER_PROPERTY_DEFAULTS} from every property of an object
+* schema, descending into nested `properties` so a leaf of an object
+* property normalizes the same way a top-level one does.
+*/
+function stripPropertyDefaults(schema) {
+	if (!isPlainObject(schema.properties)) return;
+	for (const property of Object.values(schema.properties)) {
 		if (!isPlainObject(property)) continue;
 		for (const [key, defaultValue] of Object.entries(USER_PROPERTY_DEFAULTS)) if (property[key] === defaultValue) delete property[key];
+		stripPropertyDefaults(property);
 	}
-	return result;
 }
 //#endregion
 export { USER_PROPERTY_DEFAULTS, normalizeFlowBody, normalizeSchemaBody };

package/dist/normalize.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.mjs","names":[],"sources":["../src/normalize.ts"],"sourcesContent":["/**\n * Canonical-form normalizers for the two repo-config resource kinds.\n *\n * The sync engine compares `.zitadel/**` files against server responses;\n * the server echoes fields the author never wrote (an empty `audience`\n * on flows) and the meta-schema declares defaults an author may or may\n * not spell out (`x-editable` et al on schema properties). Normalizing\n * both sides before hashing or diffing keeps a one-field edit rendering\n * as a one-field diff.\n *\n * Normalized bodies are for COMPARISON. Never upload them, and never\n * write a normalized schema body to a file: the server stores schema\n * bytes verbatim without materializing meta-schema defaults, so a\n * stripped `\"x-editable\": true` would vanish from the next published\n * revision. (Flow write-back may reuse {@link normalizeFlowBody} —\n * everything it strips is pure transport noise.)\n */\n\n/**\n * Property-level defaults declared by the user-property meta-schema\n * (`api/openapi/endpoints/schemas/user-property.json`). A property that\n * spells one of these out is semantically identical to one that omits it.\n */\nexport const USER_PROPERTY_DEFAULTS: Readonly<Record<string, boolean>> = {\n  \"x-editable\": true,\n  \"x-sensitive\": false,\n  \"x-mfa\": false,\n};\n\n/**\n * Keys of the flow-definition detail envelope. `fetch` in the flow syncer\n * already unwraps the envelope; stripping them here as well makes the\n * normalizer safe on raw detail responses.\n */\nconst FLOW_ENVELOPE_KEYS = [\"id\", \"project_id\", \"schema_uri\", \"created_at\", \"updated_at\"];\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * An `audience` counts as empty when it scopes nothing: no keys, or only\n * `team_ids`/`app_ids` that are null or empty arrays. Unknown keys keep\n * the audience — better a noisy diff than a silently dropped scope.\n */\nfunction isEmptyAudience(value: unknown): boolean {\n  if (!isPlainObject(value)) {\n    return false;\n  }\n  return Object.entries(value).every(\n    ([key, entry]) =>\n      (key === \"team_ids\" || key === \"app_ids\") &&\n      (entry === null || entry === undefined || (Array.isArray(entry) && entry.length === 0)),\n  );\n}\n\n/**\n * Return a deep copy of a bare flow-definition body with server-echoed\n * noise removed: an empty `audience` and any detail-envelope keys. A\n * top-level `$schema` is stripped too — it is a local editor affordance\n * (scaffolded flow files point it at `.zitadel/meta/flow-definition.json`),\n * never part of the resource: the server skips it on decode and omits it\n * from responses, so comparing with it would read every scaffolded file\n * as permanently diverged.\n */\nexport function normalizeFlowBody(body: object): object {\n  const result = structuredClone(body) as Record<string, unknown>;\n  for (const key of FLOW_ENVELOPE_KEYS) {\n    delete result[key];\n  }\n  delete result.$schema;\n  if (\"audience\" in result && isEmptyAudience(result.audience)) {\n    delete result.audience;\n  }\n  return result;\n}\n\n/**\n * Return a deep copy of a user-schema body with meta-schema property\n * defaults stripped: a property carrying `\"x-editable\": true` (or the\n * other {@link USER_PROPERTY_DEFAULTS}) normalizes to one omitting it.\n * Only exact default values are removed; `$id` and every other field\n * pass through untouched.\n */\nexport function normalizeSchemaBody(body: object): object {\n  const result = structuredClone(body) as Record<string, unknown>;\n  if (!isPlainObject(result.properties)) {\n    return result;\n  }\n  for (const property of Object.values(result.properties)) {\n    if (!isPlainObject(property)) {\n      continue;\n    }\n    for (const [key, defaultValue] of Object.entries(USER_PROPERTY_DEFAULTS)) {\n      if (property[key] === defaultValue) {\n        delete property[key];\n      }\n    }\n  }\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,yBAA4D;CACvE,cAAc;CACd,eAAe;CACf,SAAS;CACV;;;;;;AAOD,MAAM,qBAAqB;CAAC;CAAM;CAAc;CAAc;CAAc;CAAa;AAEzF,SAAS,cAAc,OAAkD;AACvE,QAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM;;;;;;;AAQ7E,SAAS,gBAAgB,OAAyB;AAChD,KAAI,CAAC,cAAc,MAAM,CACvB,QAAO;AAET,QAAO,OAAO,QAAQ,MAAM,CAAC,OAC1B,CAAC,KAAK,YACJ,QAAQ,cAAc,QAAQ,eAC9B,UAAU,QAAQ,UAAU,KAAA,KAAc,MAAM,QAAQ,MAAM,IAAI,MAAM,WAAW,GACvF;;;;;;;;;;;AAYH,SAAgB,kBAAkB,MAAsB;CACtD,MAAM,SAAS,gBAAgB,KAAK;AACpC,MAAK,MAAM,OAAO,mBAChB,QAAO,OAAO;AAEhB,QAAO,OAAO;AACd,KAAI,cAAc,UAAU,gBAAgB,OAAO,SAAS,CAC1D,QAAO,OAAO;AAEhB,QAAO;;;;;;;;;AAUT,SAAgB,oBAAoB,MAAsB;CACxD,MAAM,SAAS,gBAAgB,KAAK;AACpC,KAAI,CAAC,cAAc,OAAO,WAAW,CACnC,QAAO;AAET,MAAK,MAAM,YAAY,OAAO,OAAO,OAAO,WAAW,EAAE;AACvD,MAAI,CAAC,cAAc,SAAS,CAC1B;AAEF,OAAK,MAAM,CAAC,KAAK,iBAAiB,OAAO,QAAQ,uBAAuB,CACtE,KAAI,SAAS,SAAS,aACpB,QAAO,SAAS;;AAItB,QAAO"}
+{"version":3,"file":"normalize.mjs","names":[],"sources":["../src/normalize.ts"],"sourcesContent":["/**\n * Canonical-form normalizers for the two repo-config resource kinds.\n *\n * The sync engine compares `.zitadel/**` files against server responses;\n * the server echoes fields the author never wrote (an empty `audience`\n * on flows) and the meta-schema declares defaults an author may or may\n * not spell out (`x-audit` on schema properties). Normalizing both\n * sides before hashing or diffing keeps a one-field edit rendering as a\n * one-field diff.\n *\n * Normalized bodies are for COMPARISON. Never upload them, and never\n * write a normalized schema body to a file: the server stores schema\n * bytes verbatim without materializing meta-schema defaults, so a\n * stripped `\"x-audit\": false` would vanish from the next published\n * revision. (Flow write-back may reuse {@link normalizeFlowBody} —\n * everything it strips is pure transport noise.)\n */\n\n/**\n * Property-level defaults declared by the user-property meta-schema\n * (`api/openapi/endpoints/schemas/user-property.json`). A property that\n * spells one of these out is semantically identical to one that omits it:\n * audit payloads deny by default.\n */\nexport const USER_PROPERTY_DEFAULTS: Readonly<Record<string, boolean>> = {\n  \"x-audit\": false,\n};\n\n/**\n * Keys of the flow-definition detail envelope. `fetch` in the flow syncer\n * already unwraps the envelope; stripping them here as well makes the\n * normalizer safe on raw detail responses.\n */\nconst FLOW_ENVELOPE_KEYS = [\"id\", \"project_id\", \"schema_uri\", \"created_at\", \"updated_at\"];\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * An `audience` counts as empty when it scopes nothing: no keys, or only\n * `team_ids`/`app_ids` that are null or empty arrays. Unknown keys keep\n * the audience — better a noisy diff than a silently dropped scope.\n */\nfunction isEmptyAudience(value: unknown): boolean {\n  if (!isPlainObject(value)) {\n    return false;\n  }\n  return Object.entries(value).every(\n    ([key, entry]) =>\n      (key === \"team_ids\" || key === \"app_ids\") &&\n      (entry === null || entry === undefined || (Array.isArray(entry) && entry.length === 0)),\n  );\n}\n\n/**\n * Return a deep copy of a bare flow-definition body with server-echoed\n * noise removed: an empty `audience` and any detail-envelope keys. A\n * top-level `$schema` is stripped too — it is a local editor affordance\n * (scaffolded flow files point it at `.zitadel/meta/flow-definition.json`),\n * never part of the resource: the server skips it on decode and omits it\n * from responses, so comparing with it would read every scaffolded file\n * as permanently diverged.\n */\nexport function normalizeFlowBody(body: object): object {\n  const result = structuredClone(body) as Record<string, unknown>;\n  for (const key of FLOW_ENVELOPE_KEYS) {\n    delete result[key];\n  }\n  delete result.$schema;\n  if (\"audience\" in result && isEmptyAudience(result.audience)) {\n    delete result.audience;\n  }\n  return result;\n}\n\n/**\n * Return a deep copy of a user-schema body with meta-schema property\n * defaults stripped: a property carrying one of the\n * {@link USER_PROPERTY_DEFAULTS} normalizes to one omitting it. Only\n * exact default values are removed; `$id` and every other field pass\n * through untouched. Nested `properties` are descended into, so a leaf\n * of an object property normalizes the same way a top-level one does.\n */\nexport function normalizeSchemaBody(body: object): object {\n  const result = structuredClone(body) as Record<string, unknown>;\n  stripPropertyDefaults(result);\n  return result;\n}\n\n/**\n * Strip {@link USER_PROPERTY_DEFAULTS} from every property of an object\n * schema, descending into nested `properties` so a leaf of an object\n * property normalizes the same way a top-level one does.\n */\nfunction stripPropertyDefaults(schema: Record<string, unknown>): void {\n  if (!isPlainObject(schema.properties)) {\n    return;\n  }\n  for (const property of Object.values(schema.properties)) {\n    if (!isPlainObject(property)) {\n      continue;\n    }\n    for (const [key, defaultValue] of Object.entries(USER_PROPERTY_DEFAULTS)) {\n      if (property[key] === defaultValue) {\n        delete property[key];\n      }\n    }\n    stripPropertyDefaults(property);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAwBA,MAAa,yBAA4D,EACvE,WAAW,OACZ;;;;;;AAOD,MAAM,qBAAqB;CAAC;CAAM;CAAc;CAAc;CAAc;CAAa;AAEzF,SAAS,cAAc,OAAkD;AACvE,QAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM;;;;;;;AAQ7E,SAAS,gBAAgB,OAAyB;AAChD,KAAI,CAAC,cAAc,MAAM,CACvB,QAAO;AAET,QAAO,OAAO,QAAQ,MAAM,CAAC,OAC1B,CAAC,KAAK,YACJ,QAAQ,cAAc,QAAQ,eAC9B,UAAU,QAAQ,UAAU,KAAA,KAAc,MAAM,QAAQ,MAAM,IAAI,MAAM,WAAW,GACvF;;;;;;;;;;;AAYH,SAAgB,kBAAkB,MAAsB;CACtD,MAAM,SAAS,gBAAgB,KAAK;AACpC,MAAK,MAAM,OAAO,mBAChB,QAAO,OAAO;AAEhB,QAAO,OAAO;AACd,KAAI,cAAc,UAAU,gBAAgB,OAAO,SAAS,CAC1D,QAAO,OAAO;AAEhB,QAAO;;;;;;;;;;AAWT,SAAgB,oBAAoB,MAAsB;CACxD,MAAM,SAAS,gBAAgB,KAAK;AACpC,uBAAsB,OAAO;AAC7B,QAAO;;;;;;;AAQT,SAAS,sBAAsB,QAAuC;AACpE,KAAI,CAAC,cAAc,OAAO,WAAW,CACnC;AAEF,MAAK,MAAM,YAAY,OAAO,OAAO,OAAO,WAAW,EAAE;AACvD,MAAI,CAAC,cAAc,SAAS,CAC1B;AAEF,OAAK,MAAM,CAAC,KAAK,iBAAiB,OAAO,QAAQ,uBAAuB,CACtE,KAAI,SAAS,SAAS,aACpB,QAAO,SAAS;AAGpB,wBAAsB,SAAS"}

package/dist/schemas.d.mts

@@ -1,7 +1,20 @@
+import { z } from "zod";
+
 //#region src/schemas.d.ts
 declare const schemaConfigSchema: any;
 declare const flowConfigSchema: any;
 declare const createFlowDefinitionRequestSchema: any;
+/** The wire shape of a branding revision (`POST /branding` request body). */
+declare const brandingWireSchema: any;
+/**
+ * The local `.zitadel/branding/*.json` dialect: the wire shape plus
+ * `liquid_template_file`, a descriptor-relative path the CLI inlines into
+ * `liquid_template` when publishing. Exactly one of the two template carriers
+ * may be present (the meta-schema `branding.json` mirrors this).
+ */
+declare const brandingConfigSchema: z.ZodObject<{
+  [x: string]: any;
+}, z.core.$strict>;
 //#endregion
-export { createFlowDefinitionRequestSchema, flowConfigSchema, schemaConfigSchema };
+export { brandingConfigSchema, brandingWireSchema, createFlowDefinitionRequestSchema, flowConfigSchema, schemaConfigSchema };
 //# sourceMappingURL=schemas.d.mts.map

package/dist/schemas.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.mts","names":[],"sources":["../src/schemas.ts"],"mappings":";cAKa,kBAAA;AAAA,cACA,gBAAA;AAAA,cACA,iCAAA"}
+{"version":3,"file":"schemas.d.mts","names":[],"sources":["../src/schemas.ts"],"mappings":";;;cASa,kBAAA;AAAA,cACA,gBAAA;AAAA,cACA,iCAAA;;cAGA,kBAAA;;;AAJb;;;;cAYa,oBAAA,EAAoB,CAAA,CAAA,SAAA;EAAA;GAuC7B,CAAA,CAAA,IAAA,CAAA,OAAA"}

package/dist/schemas.mjs

@@ -1,9 +1,69 @@
-import { CreateFlowDefinitionBody, CreateSchemaBody } from "@zitadel/api/generated/endpoints/zitadelNextGen.zod";
+import { isCanonicalLoopbackHttpUrl } from "./branding-url.mjs";
+import { CreateBrandingBody, CreateFlowDefinitionBody, CreateSchemaBody } from "@zitadel/api/generated/endpoints/zitadelNextGen.zod";
+import { z } from "zod";
 //#region src/schemas.ts
 const schemaConfigSchema = CreateSchemaBody;
 const flowConfigSchema = CreateFlowDefinitionBody.shape.flow_definition;
 const createFlowDefinitionRequestSchema = CreateFlowDefinitionBody;
+/** The wire shape of a branding revision (`POST /branding` request body). */
+const brandingWireSchema = CreateBrandingBody;
+/**
+* The local `.zitadel/branding/*.json` dialect: the wire shape plus
+* `liquid_template_file`, a descriptor-relative path the CLI inlines into
+* `liquid_template` when publishing. Exactly one of the two template carriers
+* may be present (the meta-schema `branding.json` mirrors this).
+*/
+const brandingConfigSchema = z.strictObject({
+	...CreateBrandingBody.shape,
+	logo_url: z.string().optional(),
+	hero_url: z.string().optional(),
+	$schema: z.string().optional(),
+	liquid_template_file: z.string().min(1).optional()
+}).superRefine((value, ctx) => {
+	if (value.liquid_template !== void 0 && value.liquid_template_file !== void 0) ctx.addIssue({
+		code: "custom",
+		message: "Use either liquid_template_file or an inline liquid_template, not both."
+	});
+	if (value.font_url !== void 0) ctx.addIssue({
+		code: "custom",
+		message: "font_url is not writable yet (tenant font delivery needs a safe design, see ADR 040); load fonts from the embedding page instead."
+	});
+	validateBrandingAssetUrl(value.logo_url, "logo_url", ctx);
+	validateBrandingAssetUrl(value.hero_url, "hero_url", ctx);
+});
+function validateBrandingAssetUrl(value, field, ctx) {
+	if (value === void 0 || value === "") return;
+	if (/[\s\\]/.test(value)) {
+		ctx.addIssue({
+			code: "custom",
+			message: `${field} is not a valid URL.`
+		});
+		return;
+	}
+	if (!/^https?:\/\//i.test(value)) {
+		ctx.addIssue({
+			code: "custom",
+			message: `${field} must be an absolute https URL.`
+		});
+		return;
+	}
+	let parsed;
+	try {
+		parsed = new URL(value);
+	} catch {
+		ctx.addIssue({
+			code: "custom",
+			message: `${field} is not a valid URL.`
+		});
+		return;
+	}
+	if (parsed.protocol === "http:" && isCanonicalLoopbackHttpUrl(value)) return;
+	if (parsed.protocol !== "https:" || parsed.host === "") ctx.addIssue({
+		code: "custom",
+		message: `${field} must be an absolute https URL (http is allowed for canonical loopback development hosts only).`
+	});
+}
 //#endregion
-export { createFlowDefinitionRequestSchema, flowConfigSchema, schemaConfigSchema };
+export { brandingConfigSchema, brandingWireSchema, createFlowDefinitionRequestSchema, flowConfigSchema, schemaConfigSchema };
 
 //# sourceMappingURL=schemas.mjs.map

package/dist/schemas.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.mjs","names":[],"sources":["../src/schemas.ts"],"sourcesContent":["import {\n  CreateFlowDefinitionBody,\n  CreateSchemaBody,\n} from \"@zitadel/api/generated/endpoints/zitadelNextGen.zod\";\n\nexport const schemaConfigSchema = CreateSchemaBody;\nexport const flowConfigSchema = CreateFlowDefinitionBody.shape.flow_definition;\nexport const createFlowDefinitionRequestSchema = CreateFlowDefinitionBody;\n"],"mappings":";;AAKA,MAAa,qBAAqB;AAClC,MAAa,mBAAmB,yBAAyB,MAAM;AAC/D,MAAa,oCAAoC"}
+{"version":3,"file":"schemas.mjs","names":[],"sources":["../src/schemas.ts"],"sourcesContent":["import {\n  CreateBrandingBody,\n  CreateFlowDefinitionBody,\n  CreateSchemaBody,\n} from \"@zitadel/api/generated/endpoints/zitadelNextGen.zod\";\nimport { z } from \"zod\";\n\nimport { isCanonicalLoopbackHttpUrl } from \"./branding-url.js\";\n\nexport const schemaConfigSchema = CreateSchemaBody;\nexport const flowConfigSchema = CreateFlowDefinitionBody.shape.flow_definition;\nexport const createFlowDefinitionRequestSchema = CreateFlowDefinitionBody;\n\n/** The wire shape of a branding revision (`POST /branding` request body). */\nexport const brandingWireSchema = CreateBrandingBody;\n\n/**\n * The local `.zitadel/branding/*.json` dialect: the wire shape plus\n * `liquid_template_file`, a descriptor-relative path the CLI inlines into\n * `liquid_template` when publishing. Exactly one of the two template carriers\n * may be present (the meta-schema `branding.json` mirrors this).\n */\nexport const brandingConfigSchema = z\n  .strictObject({\n    // Strict, unlike the generated wire schema: a typo like `hero_urll`\n    // must fail plan, not silently pass, get ignored by the server, and\n    // vanish on canonical write-back. The editor meta-schema already\n    // rejects unknown keys; the CLI gate has to agree.\n    ...CreateBrandingBody.shape,\n    // Raw strings instead of the generated uri fields: those trim and\n    // normalize before refinement runs, hiding exactly the forms the wire\n    // body still carries verbatim and Go's url.Parse rejects.\n    logo_url: z.string().optional(),\n    hero_url: z.string().optional(),\n    $schema: z.string().optional(),\n    liquid_template_file: z.string().min(1).optional(),\n  })\n  .superRefine((value, ctx) => {\n    if (value.liquid_template !== undefined && value.liquid_template_file !== undefined) {\n      ctx.addIssue({\n        code: \"custom\",\n        message: \"Use either liquid_template_file or an inline liquid_template, not both.\",\n      });\n    }\n    // font_url is read-only in v1: the login component loads it as a\n    // document-level stylesheet (shadow-scoped @font-face never registers\n    // faces), which would give branding.write arbitrary CSS over the embedding\n    // page. The server rejects it too; safe delivery is an ADR 040 follow-up.\n    if (value.font_url !== undefined) {\n      ctx.addIssue({\n        code: \"custom\",\n        message:\n          \"font_url is not writable yet (tenant font delivery needs a safe design, see ADR 040); load fonts from the embedding page instead.\",\n      });\n    }\n    // Mirror the server's asset URL gate (validateBrandingAssetURL in\n    // internal/domain/branding_validator.go) so plan rejects what apply would.\n    // Apply mutates schemas and flows before branding, so a late 400 here would\n    // leave a half-applied run.\n    validateBrandingAssetUrl(value.logo_url, \"logo_url\", ctx);\n    validateBrandingAssetUrl(value.hero_url, \"hero_url\", ctx);\n  });\n\nfunction validateBrandingAssetUrl(\n  value: string | undefined,\n  field: \"logo_url\" | \"hero_url\",\n  ctx: z.RefinementCtx,\n): void {\n  if (value === undefined || value === \"\") {\n    return;\n  }\n  // Stricter-or-equal than the Go gate (validateBrandingAssetURL): the WHATWG\n  // parser forgives what Go's url.Parse rejects — `https:example.com`,\n  // backslashes, and whitespace all get silently normalized. plan must never\n  // accept what apply would reject (the reverse is harmless), so reject the\n  // raw forms before parsing.\n  if (/[\\s\\\\]/.test(value)) {\n    ctx.addIssue({ code: \"custom\", message: `${field} is not a valid URL.` });\n    return;\n  }\n  if (!/^https?:\\/\\//i.test(value)) {\n    ctx.addIssue({ code: \"custom\", message: `${field} must be an absolute https URL.` });\n    return;\n  }\n  let parsed: URL;\n  try {\n    parsed = new URL(value);\n  } catch {\n    ctx.addIssue({ code: \"custom\", message: `${field} is not a valid URL.` });\n    return;\n  }\n  // Loopback HTTP is the dev-posture carve-out (assets served from the app's\n  // own dev server). Check the raw URL so WHATWG normalisation cannot make\n  // plan accept a host spelling that the Go save gate rejects.\n  if (parsed.protocol === \"http:\" && isCanonicalLoopbackHttpUrl(value)) {\n    return;\n  }\n  if (parsed.protocol !== \"https:\" || parsed.host === \"\") {\n    ctx.addIssue({\n      code: \"custom\",\n      message: `${field} must be an absolute https URL (http is allowed for canonical loopback development hosts only).`,\n    });\n  }\n}\n"],"mappings":";;;;AASA,MAAa,qBAAqB;AAClC,MAAa,mBAAmB,yBAAyB,MAAM;AAC/D,MAAa,oCAAoC;;AAGjD,MAAa,qBAAqB;;;;;;;AAQlC,MAAa,uBAAuB,EACjC,aAAa;CAKZ,GAAG,mBAAmB;CAItB,UAAU,EAAE,QAAQ,CAAC,UAAU;CAC/B,UAAU,EAAE,QAAQ,CAAC,UAAU;CAC/B,SAAS,EAAE,QAAQ,CAAC,UAAU;CAC9B,sBAAsB,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU;CACnD,CAAC,CACD,aAAa,OAAO,QAAQ;AAC3B,KAAI,MAAM,oBAAoB,KAAA,KAAa,MAAM,yBAAyB,KAAA,EACxE,KAAI,SAAS;EACX,MAAM;EACN,SAAS;EACV,CAAC;AAMJ,KAAI,MAAM,aAAa,KAAA,EACrB,KAAI,SAAS;EACX,MAAM;EACN,SACE;EACH,CAAC;AAMJ,0BAAyB,MAAM,UAAU,YAAY,IAAI;AACzD,0BAAyB,MAAM,UAAU,YAAY,IAAI;EACzD;AAEJ,SAAS,yBACP,OACA,OACA,KACM;AACN,KAAI,UAAU,KAAA,KAAa,UAAU,GACnC;AAOF,KAAI,SAAS,KAAK,MAAM,EAAE;AACxB,MAAI,SAAS;GAAE,MAAM;GAAU,SAAS,GAAG,MAAM;GAAuB,CAAC;AACzE;;AAEF,KAAI,CAAC,gBAAgB,KAAK,MAAM,EAAE;AAChC,MAAI,SAAS;GAAE,MAAM;GAAU,SAAS,GAAG,MAAM;GAAkC,CAAC;AACpF;;CAEF,IAAI;AACJ,KAAI;AACF,WAAS,IAAI,IAAI,MAAM;SACjB;AACN,MAAI,SAAS;GAAE,MAAM;GAAU,SAAS,GAAG,MAAM;GAAuB,CAAC;AACzE;;AAKF,KAAI,OAAO,aAAa,WAAW,2BAA2B,MAAM,CAClE;AAEF,KAAI,OAAO,aAAa,YAAY,OAAO,SAAS,GAClD,KAAI,SAAS;EACX,MAAM;EACN,SAAS,GAAG,MAAM;EACnB,CAAC"}

package/dist/template.d.mts

@@ -0,0 +1,76 @@
+//#region src/template.d.ts
+/** The `{% mandatory_gates %}` runtime safety-net tag every template must emit. */
+declare const MANDATORY_GATES_TAG = "mandatory_gates";
+/**
+ * Custom Liquid tags the login orchestrator registers beyond the standard
+ * set. Validators must register them (as no-ops) or parsing valid templates
+ * fails; `@zitadel/components` registers the real implementations.
+ */
+declare const TEMPLATE_TAGS: readonly ["mandatory_gates"];
+/**
+ * Byte cap for stored templates. Mirrors `maxLength` on
+ * `branding.liquid_template` in the OpenAPI contract and
+ * `MaxBrandingTemplateBytes` in the Go gate.
+ */
+declare const MAX_TEMPLATE_BYTES = 131072;
+type TemplateValidationSeverity = "error" | "warning";
+/**
+ * Rule catalog with pointers into the Go lexical gate
+ * (`internal/domain/branding_validator.go`) where a server-side mirror
+ * exists. `parse` and `mandatory-gates` are authoring-only: the server
+ * cannot check them (wrong dialect) and render-time behavior degrades
+ * safely without them.
+ */
+declare const TEMPLATE_VALIDATION_RULES: {
+  readonly parse: {
+    readonly goRef: null;
+  };
+  readonly size: {
+    readonly goRef: "MaxBrandingTemplateBytes";
+  };
+  readonly "no-script-tag": {
+    readonly goRef: "brandingScriptTag";
+  };
+  readonly "no-style-tag": {
+    readonly goRef: "brandingStyleTag";
+  };
+  readonly "no-inline-handlers": {
+    readonly goRef: "brandingInlineHandler";
+  };
+  readonly "no-javascript-urls": {
+    readonly goRef: "brandingJavascriptURL";
+  };
+  readonly "no-raw-filter": {
+    readonly goRef: "brandingRawFilter";
+  };
+  readonly "mandatory-gates": {
+    readonly goRef: null;
+  };
+};
+type TemplateValidationRuleId = keyof typeof TEMPLATE_VALIDATION_RULES;
+type TemplateValidationIssue = {
+  severity: TemplateValidationSeverity;
+  rule: TemplateValidationRuleId;
+  message: string;
+};
+type BannedPattern = {
+  rule: TemplateValidationRuleId;
+  pattern: RegExp;
+  message: string;
+};
+/**
+ * Lexical bans, identical to the Go gate. The inline-handler pattern only
+ * matches inside an open tag so Liquid like `{% assign online = true %}`
+ * doesn't false-positive; its separator class includes `/` because HTML
+ * treats a slash between attributes as whitespace (`<img/onerror=…>`).
+ */
+declare const BANNED_TEMPLATE_PATTERNS: readonly BannedPattern[];
+/**
+ * Validates a login template. Pure and non-throwing, like
+ * `validateFlowDefinition`: returns an issue list, empty when the template
+ * is valid.
+ */
+declare function validateLoginTemplate(template: string): TemplateValidationIssue[];
+//#endregion
+export { BANNED_TEMPLATE_PATTERNS, MANDATORY_GATES_TAG, MAX_TEMPLATE_BYTES, TEMPLATE_TAGS, TEMPLATE_VALIDATION_RULES, TemplateValidationIssue, TemplateValidationRuleId, TemplateValidationSeverity, validateLoginTemplate };
+//# sourceMappingURL=template.d.mts.map

package/dist/template.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.mts","names":[],"sources":["../src/template.ts"],"mappings":";;cAkBa,mBAAA;;;;;AAOb;cAAa,aAAA;;;;AAOb;;cAAa,kBAAA;AAAA,KAED,0BAAA;;AAAZ;;;;;AASA;cAAa,yBAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;KAWD,wBAAA,gBAAwC,yBAAA;AAAA,KAExC,uBAAA;EACV,QAAA,EAAU,0BAAA;EACV,IAAA,EAAM,wBAAA;EACN,OAAA;AAAA;AAAA,KAGG,aAAA;EACH,IAAA,EAAM,wBAAA;EACN,OAAA,EAAS,MAAA;EACT,OAAA;AAAA;AALA;;;;;;AAAA,cAcW,wBAAA,WAAmC,aAAA;;;;;AAAhD;iBAqEgB,qBAAA,CAAsB,QAAA,WAAmB,uBAAA"}