@zitadel/components 0.1.0-alpha.11 → 0.1.0-alpha.12

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.
@@ -37,7 +37,7 @@ declare class ZlIcon extends LitElement {
37
37
  render(): _$lit.TemplateResult<1>;
38
38
  }
39
39
  /** Public, kebab-case glyph IDs. Add a new one by extending both this union and {@link ICON_NODES}. */
40
- type IconName = "plus" | "arrow-right" | "arrow-left" | "spinner" | "check" | "cross" | "warning" | "alert-circle" | "info" | "passkey" | "user" | "eye" | "eye-off";
40
+ type IconName = "plus" | "arrow-right" | "arrow-left" | "spinner" | "check" | "chevron-down" | "cross" | "warning" | "alert-circle" | "info" | "passkey" | "user" | "eye" | "eye-off";
41
41
  type IconSize = "16" | "24";
42
42
  type IconTone = "default" | "error" | "success" | "disabled";
43
43
  declare const zlIconManifest: AtomManifest;
@@ -250,7 +250,99 @@ declare global {
250
250
  }
251
251
  } //# sourceMappingURL=zl-card.d.ts.map
252
252
  //#endregion
253
- //#region ../api/dist/index-BGnjxx-b.d.mts
253
+ //#region src/atoms/zl-checkbox.d.ts
254
+ /** Detail shape emitted by the `zl-change` event. */
255
+ type ZlCheckboxChangeDetail = {
256
+ name: string;
257
+ checked: boolean;
258
+ value: string;
259
+ };
260
+ /**
261
+ * Atom: `<zl-checkbox>` — labelled checkbox bound to a boolean choice.
262
+ *
263
+ * Spec lineage (file `8UjCXw8yemgljmbkWGrSfE`, "Zitadel - Design System - External"):
264
+ * - bare master variant set: node `4387:460` (Checkbox)
265
+ * - labelled master variant set: node `6634:1868` (Checkbox / With Label)
266
+ *
267
+ * Figma models the checked state as the `style` variant (Outline = unchecked,
268
+ * Filled = checked) and Hovered / Focused / Pressed as a 32px circular halo
269
+ * behind the 16px box. Those map to real CSS pseudo-classes; only the optional
270
+ * `data-state` preview hook forces a state for the design matrix.
271
+ *
272
+ * Box 16px, 2px radius, 8px gap to label, Inter 14/20 label.
273
+ * Unchecked 1px border icon.default-white (#f4f4f6).
274
+ * Checked filled icon.default-white with a dark check glyph.
275
+ * Hover halo surface.default-primary-gray; edge/fill icon.default-gray.
276
+ * Focus/Pressed halo + edge/fill surface.default-white.
277
+ * Disabled edge/fill text.disabled (#686883), muted label, no halo.
278
+ *
279
+ * Form participation: `<zl-checkbox>` is a form-associated custom element, so
280
+ * it submits its `value` only when checked, exactly like a native checkbox.
281
+ */
282
+ declare class ZlCheckbox extends LitElement {
283
+ static formAssociated: boolean;
284
+ static shadowRootOptions: ShadowRootInit;
285
+ static styles: _$lit.CSSResult[];
286
+ /**
287
+ * Field name — used as the key in form submission and in `zl-change` detail.
288
+ * The browser owns a native `name` property on form-associated elements, so
289
+ * we manage it manually to avoid a conflicting auto-generated accessor (see
290
+ * `<zl-field>`).
291
+ */
292
+ get name(): string;
293
+ set name(value: string);
294
+ accessor label: string;
295
+ accessor value: string;
296
+ accessor checked: boolean;
297
+ accessor disabled: boolean;
298
+ accessor required: boolean;
299
+ accessor ariaLabelText: string | undefined;
300
+ accessor testId: string | undefined;
301
+ /**
302
+ * Forces a visual interaction state on the box, projected to the root's
303
+ * `data-state` attribute. Preview-only — used by the design matrix to
304
+ * capture hover/focus/pressed without real pointer interaction.
305
+ */
306
+ accessor forcedState: string | null;
307
+ private accessor inputEl;
308
+ private readonly inputId;
309
+ private readonly internals;
310
+ private defaultChecked;
311
+ constructor();
312
+ connectedCallback(): void;
313
+ willUpdate(changed: PropertyValues<this>): void;
314
+ formResetCallback(): void;
315
+ formStateRestoreCallback(state: string | null): void;
316
+ focus(options?: FocusOptions): void;
317
+ render(): _$lit.TemplateResult<1>;
318
+ private handleChange;
319
+ private syncFormState;
320
+ private nativeInputTestId;
321
+ }
322
+ declare const zlCheckboxManifest: AtomManifest;
323
+ declare global {
324
+ interface HTMLElementTagNameMap {
325
+ "zl-checkbox": ZlCheckbox;
326
+ }
327
+ } //# sourceMappingURL=zl-checkbox.d.ts.map
328
+ //#endregion
329
+ //#region ../api/dist/index-1TIHnDrM.d.mts
330
+ //#endregion
331
+ //#region src/generated/model/activateFlowDefinitionParams.d.ts
332
+ /**
333
+ * Generated by orval v8.10.0 🍺
334
+ * Do not edit manually.
335
+ * Zitadel NextGen
336
+ * This is the next generation of the Zitadel identity platform.
337
+ * OpenAPI spec version: 0.0.1
338
+ */
339
+ type ActivateFlowDefinitionParams = {
340
+ /**
341
+ * The unique identifier of the project
342
+ * @pattern ^[a-zA-Z0-9_-]+$
343
+ */
344
+ project_id: string;
345
+ }; //#endregion
254
346
  //#region src/generated/model/authorizeDevice200.d.ts
255
347
  /**
256
348
  * Generated by orval v8.10.0 🍺
@@ -796,7 +888,7 @@ type CreateFlow201Branding = {
796
888
  font_url?: string; /** Hero/background image URL (used by split layout). */
797
889
  hero_url?: string;
798
890
  }; //#endregion
799
- //#region src/generated/model/createFlow201StepActionsItem.d.ts
891
+ //#region src/generated/model/createFlow201StepActionsItemKind.d.ts
800
892
  /**
801
893
  * Generated by orval v8.10.0 🍺
802
894
  * Do not edit manually.
@@ -804,13 +896,48 @@ type CreateFlow201Branding = {
804
896
  * This is the next generation of the Zitadel identity platform.
805
897
  * OpenAPI spec version: 0.0.1
806
898
  */
899
+ /**
900
+ * Classifies how the engine handles this action:
901
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
902
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
903
+ fires once the returned assertion verifies.
904
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
905
+ transition fires once the returned attestation verifies.
906
+ - `navigate`: route through the transition without running the input
907
+ pipeline. Used for pure-routing actions declared in the flow definition.
908
+ - `back`: return the user to the previous step. Surfaced by the engine
909
+ when going back is available.
910
+
911
+ */
912
+ type CreateFlow201StepActionsItemKind = (typeof CreateFlow201StepActionsItemKind)[keyof typeof CreateFlow201StepActionsItemKind];
913
+ declare const CreateFlow201StepActionsItemKind: {
914
+ readonly submit: "submit";
915
+ readonly passkey: "passkey";
916
+ readonly passkey_register: "passkey_register";
917
+ readonly navigate: "navigate";
918
+ readonly back: "back";
919
+ }; //#endregion
920
+ //#region src/generated/model/createFlow201StepActionsItem.d.ts
807
921
  /**
808
922
  * Configuration for a user-invokable action on a step. The `name` is sent
809
- back in the submit request as `action`.
923
+ back in the submit request as `action`; the engine resolves the action's
924
+ declared `kind` to decide how to handle the submission.
810
925
 
811
926
  */
812
927
  type CreateFlow201StepActionsItem = {
813
928
  /** Action identifier. Sent back in the submit request as `action`. */name: string;
929
+ /** Classifies how the engine handles this action:
930
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
931
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
932
+ fires once the returned assertion verifies.
933
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
934
+ transition fires once the returned attestation verifies.
935
+ - `navigate`: route through the transition without running the input
936
+ pipeline. Used for pure-routing actions declared in the flow definition.
937
+ - `back`: return the user to the previous step. Surfaced by the engine
938
+ when going back is available.
939
+ */
940
+ kind: CreateFlow201StepActionsItemKind;
814
941
  /** Marks this as the default/primary action. The runtime template uses
815
942
  this hint to choose visual emphasis. At most one action per step
816
943
  should be primary; this is not enforced here.
@@ -1245,6 +1372,11 @@ type CreateFlowBody = {
1245
1372
  * @pattern ^[a-z][a-z0-9-]*$
1246
1373
  */
1247
1374
  flow_definition_name?: string;
1375
+ /** Set to true to simulate the flow without actually creating any
1376
+ user or session. Useful for testing and validation of flow definitions.
1377
+ This requires setting the `flow_definition_name` property as well.
1378
+ */
1379
+ dry_run?: boolean;
1248
1380
  /**
1249
1381
  * Semver version of the flow definition JSON Schema to use.
1250
1382
  When omitted, the latest version is used.
@@ -1295,7 +1427,31 @@ type CreateFlowDefinition201FlowDefinitionAudience = {
1295
1427
  /** Restrict to specific teams (organizations). Empty means no team restriction. */team_ids?: string[]; /** Restrict to specific applications. Empty means no app restriction. */
1296
1428
  app_ids?: string[];
1297
1429
  }; //#endregion
1298
- //#region src/generated/model/createFlowDefinition201FlowDefinitionStepsItemActionsItem.d.ts
1430
+ //#region src/generated/model/createFlowDefinition201FlowDefinitionStatus.d.ts
1431
+ /**
1432
+ * Generated by orval v8.10.0 🍺
1433
+ * Do not edit manually.
1434
+ * Zitadel NextGen
1435
+ * This is the next generation of the Zitadel identity platform.
1436
+ * OpenAPI spec version: 0.0.1
1437
+ */
1438
+ /**
1439
+ * The lifecycle state of this flow definition.
1440
+
1441
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
1442
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
1443
+
1444
+ Allowed transitions:
1445
+ - draft -> active: To activate the flow definition.
1446
+ - active -> draft: To remove the flow definition from active use immediately.
1447
+
1448
+ */
1449
+ type CreateFlowDefinition201FlowDefinitionStatus = (typeof CreateFlowDefinition201FlowDefinitionStatus)[keyof typeof CreateFlowDefinition201FlowDefinitionStatus];
1450
+ declare const CreateFlowDefinition201FlowDefinitionStatus: {
1451
+ readonly active: "active";
1452
+ readonly draft: "draft";
1453
+ }; //#endregion
1454
+ //#region src/generated/model/createFlowDefinition201FlowDefinitionStepsItemActionsItemKind.d.ts
1299
1455
  /**
1300
1456
  * Generated by orval v8.10.0 🍺
1301
1457
  * Do not edit manually.
@@ -1303,13 +1459,48 @@ type CreateFlowDefinition201FlowDefinitionAudience = {
1303
1459
  * This is the next generation of the Zitadel identity platform.
1304
1460
  * OpenAPI spec version: 0.0.1
1305
1461
  */
1462
+ /**
1463
+ * Classifies how the engine handles this action:
1464
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
1465
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
1466
+ fires once the returned assertion verifies.
1467
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
1468
+ transition fires once the returned attestation verifies.
1469
+ - `navigate`: route through the transition without running the input
1470
+ pipeline. Used for pure-routing actions declared in the flow definition.
1471
+ - `back`: return the user to the previous step. Surfaced by the engine
1472
+ when going back is available.
1473
+
1474
+ */
1475
+ type CreateFlowDefinition201FlowDefinitionStepsItemActionsItemKind = (typeof CreateFlowDefinition201FlowDefinitionStepsItemActionsItemKind)[keyof typeof CreateFlowDefinition201FlowDefinitionStepsItemActionsItemKind];
1476
+ declare const CreateFlowDefinition201FlowDefinitionStepsItemActionsItemKind: {
1477
+ readonly submit: "submit";
1478
+ readonly passkey: "passkey";
1479
+ readonly passkey_register: "passkey_register";
1480
+ readonly navigate: "navigate";
1481
+ readonly back: "back";
1482
+ }; //#endregion
1483
+ //#region src/generated/model/createFlowDefinition201FlowDefinitionStepsItemActionsItem.d.ts
1306
1484
  /**
1307
1485
  * Configuration for a user-invokable action on a step. The `name` is sent
1308
- back in the submit request as `action`.
1486
+ back in the submit request as `action`; the engine resolves the action's
1487
+ declared `kind` to decide how to handle the submission.
1309
1488
 
1310
1489
  */
1311
1490
  type CreateFlowDefinition201FlowDefinitionStepsItemActionsItem = {
1312
1491
  /** Action identifier. Sent back in the submit request as `action`. */name: string;
1492
+ /** Classifies how the engine handles this action:
1493
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
1494
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
1495
+ fires once the returned assertion verifies.
1496
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
1497
+ transition fires once the returned attestation verifies.
1498
+ - `navigate`: route through the transition without running the input
1499
+ pipeline. Used for pure-routing actions declared in the flow definition.
1500
+ - `back`: return the user to the previous step. Surfaced by the engine
1501
+ when going back is available.
1502
+ */
1503
+ kind: CreateFlowDefinition201FlowDefinitionStepsItemActionsItemKind;
1313
1504
  /** Marks this as the default/primary action. The runtime template uses
1314
1505
  this hint to choose visual emphasis. At most one action per step
1315
1506
  should be primary; this is not enforced here.
@@ -1547,6 +1738,14 @@ type CreateFlowDefinition201FlowDefinition = {
1547
1738
  * @pattern ^[a-z][a-z0-9-]*$
1548
1739
  */
1549
1740
  name: string;
1741
+ /** The lifecycle state of this flow definition.
1742
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
1743
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
1744
+ Allowed transitions:
1745
+ - draft -> active: To activate the flow definition.
1746
+ - active -> draft: To remove the flow definition from active use immediately.
1747
+ */
1748
+ status?: CreateFlowDefinition201FlowDefinitionStatus;
1550
1749
  /** User schema this flow operates on. Step `fields` reference properties
1551
1750
  defined in this schema. The engine resolves field types, validation,
1552
1751
  and implicit outcomes from schema annotations at runtime.
@@ -1571,11 +1770,42 @@ type CreateFlowDefinition201FlowDefinition = {
1571
1770
  */
1572
1771
  steps: CreateFlowDefinition201FlowDefinitionStepsItem[];
1573
1772
  }; //#endregion
1773
+ //#region src/generated/model/createFlowDefinition201Status.d.ts
1774
+ /**
1775
+ * Generated by orval v8.10.0 🍺
1776
+ * Do not edit manually.
1777
+ * Zitadel NextGen
1778
+ * This is the next generation of the Zitadel identity platform.
1779
+ * OpenAPI spec version: 0.0.1
1780
+ */
1781
+ /**
1782
+ * The lifecycle state of this flow definition.
1783
+
1784
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
1785
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
1786
+
1787
+ Allowed transitions:
1788
+ - draft -> active: To activate the flow definition.
1789
+ - active -> draft: To remove the flow definition from active use immediately.
1790
+
1791
+ */
1792
+ type CreateFlowDefinition201Status = (typeof CreateFlowDefinition201Status)[keyof typeof CreateFlowDefinition201Status];
1793
+ declare const CreateFlowDefinition201Status: {
1794
+ readonly active: "active";
1795
+ readonly draft: "draft";
1796
+ }; //#endregion
1574
1797
  //#region src/generated/model/createFlowDefinition201.d.ts
1575
1798
  type CreateFlowDefinition201 = {
1576
1799
  /** Unique identifier for the flow definition. */id: string; /** Identifier of the project this flow definition belongs to. */
1577
- project_id: string; /** Status of the flow definition. */
1578
- status: string;
1800
+ project_id: string;
1801
+ /** The lifecycle state of this flow definition.
1802
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
1803
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
1804
+ Allowed transitions:
1805
+ - draft -> active: To activate the flow definition.
1806
+ - active -> draft: To remove the flow definition from active use immediately.
1807
+ */
1808
+ status: CreateFlowDefinition201Status;
1579
1809
  /** A flow definition is the server-side configuration that describes a complete
1580
1810
  authentication or identity flow. It is NOT sent to the frontend — the flow
1581
1811
  engine evaluates it and produces FlowResponse payloads (steps with capability
@@ -1619,7 +1849,31 @@ type CreateFlowDefinitionBodyFlowDefinitionAudience = {
1619
1849
  /** Restrict to specific teams (organizations). Empty means no team restriction. */team_ids?: string[]; /** Restrict to specific applications. Empty means no app restriction. */
1620
1850
  app_ids?: string[];
1621
1851
  }; //#endregion
1622
- //#region src/generated/model/createFlowDefinitionBodyFlowDefinitionStepsItemActionsItem.d.ts
1852
+ //#region src/generated/model/createFlowDefinitionBodyFlowDefinitionStatus.d.ts
1853
+ /**
1854
+ * Generated by orval v8.10.0 🍺
1855
+ * Do not edit manually.
1856
+ * Zitadel NextGen
1857
+ * This is the next generation of the Zitadel identity platform.
1858
+ * OpenAPI spec version: 0.0.1
1859
+ */
1860
+ /**
1861
+ * The lifecycle state of this flow definition.
1862
+
1863
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
1864
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
1865
+
1866
+ Allowed transitions:
1867
+ - draft -> active: To activate the flow definition.
1868
+ - active -> draft: To remove the flow definition from active use immediately.
1869
+
1870
+ */
1871
+ type CreateFlowDefinitionBodyFlowDefinitionStatus = (typeof CreateFlowDefinitionBodyFlowDefinitionStatus)[keyof typeof CreateFlowDefinitionBodyFlowDefinitionStatus];
1872
+ declare const CreateFlowDefinitionBodyFlowDefinitionStatus: {
1873
+ readonly active: "active";
1874
+ readonly draft: "draft";
1875
+ }; //#endregion
1876
+ //#region src/generated/model/createFlowDefinitionBodyFlowDefinitionStepsItemActionsItemKind.d.ts
1623
1877
  /**
1624
1878
  * Generated by orval v8.10.0 🍺
1625
1879
  * Do not edit manually.
@@ -1627,13 +1881,48 @@ type CreateFlowDefinitionBodyFlowDefinitionAudience = {
1627
1881
  * This is the next generation of the Zitadel identity platform.
1628
1882
  * OpenAPI spec version: 0.0.1
1629
1883
  */
1884
+ /**
1885
+ * Classifies how the engine handles this action:
1886
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
1887
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
1888
+ fires once the returned assertion verifies.
1889
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
1890
+ transition fires once the returned attestation verifies.
1891
+ - `navigate`: route through the transition without running the input
1892
+ pipeline. Used for pure-routing actions declared in the flow definition.
1893
+ - `back`: return the user to the previous step. Surfaced by the engine
1894
+ when going back is available.
1895
+
1896
+ */
1897
+ type CreateFlowDefinitionBodyFlowDefinitionStepsItemActionsItemKind = (typeof CreateFlowDefinitionBodyFlowDefinitionStepsItemActionsItemKind)[keyof typeof CreateFlowDefinitionBodyFlowDefinitionStepsItemActionsItemKind];
1898
+ declare const CreateFlowDefinitionBodyFlowDefinitionStepsItemActionsItemKind: {
1899
+ readonly submit: "submit";
1900
+ readonly passkey: "passkey";
1901
+ readonly passkey_register: "passkey_register";
1902
+ readonly navigate: "navigate";
1903
+ readonly back: "back";
1904
+ }; //#endregion
1905
+ //#region src/generated/model/createFlowDefinitionBodyFlowDefinitionStepsItemActionsItem.d.ts
1630
1906
  /**
1631
1907
  * Configuration for a user-invokable action on a step. The `name` is sent
1632
- back in the submit request as `action`.
1908
+ back in the submit request as `action`; the engine resolves the action's
1909
+ declared `kind` to decide how to handle the submission.
1633
1910
 
1634
1911
  */
1635
1912
  type CreateFlowDefinitionBodyFlowDefinitionStepsItemActionsItem = {
1636
1913
  /** Action identifier. Sent back in the submit request as `action`. */name: string;
1914
+ /** Classifies how the engine handles this action:
1915
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
1916
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
1917
+ fires once the returned assertion verifies.
1918
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
1919
+ transition fires once the returned attestation verifies.
1920
+ - `navigate`: route through the transition without running the input
1921
+ pipeline. Used for pure-routing actions declared in the flow definition.
1922
+ - `back`: return the user to the previous step. Surfaced by the engine
1923
+ when going back is available.
1924
+ */
1925
+ kind: CreateFlowDefinitionBodyFlowDefinitionStepsItemActionsItemKind;
1637
1926
  /** Marks this as the default/primary action. The runtime template uses
1638
1927
  this hint to choose visual emphasis. At most one action per step
1639
1928
  should be primary; this is not enforced here.
@@ -1871,6 +2160,14 @@ type CreateFlowDefinitionBodyFlowDefinition = {
1871
2160
  * @pattern ^[a-z][a-z0-9-]*$
1872
2161
  */
1873
2162
  name: string;
2163
+ /** The lifecycle state of this flow definition.
2164
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
2165
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
2166
+ Allowed transitions:
2167
+ - draft -> active: To activate the flow definition.
2168
+ - active -> draft: To remove the flow definition from active use immediately.
2169
+ */
2170
+ status?: CreateFlowDefinitionBodyFlowDefinitionStatus;
1874
2171
  /** User schema this flow operates on. Step `fields` reference properties
1875
2172
  defined in this schema. The engine resolves field types, validation,
1876
2173
  and implicit outcomes from schema annotations at runtime.
@@ -1896,6 +2193,12 @@ type CreateFlowDefinitionBodyFlowDefinition = {
1896
2193
  steps: CreateFlowDefinitionBodyFlowDefinitionStepsItem[];
1897
2194
  }; //#endregion
1898
2195
  //#region src/generated/model/createFlowDefinitionBody.d.ts
2196
+ /**
2197
+ * Creates a flow definition.
2198
+ The flow definition is created in an `active` state by default.
2199
+ The status can also be set via the `status` attribute in the flow definition payload.
2200
+
2201
+ */
1899
2202
  type CreateFlowDefinitionBody = {
1900
2203
  /** @pattern ^[a-zA-Z0-9_-]+$ */project_id: string;
1901
2204
  /** URI of the server-published flow definition schema this definition was
@@ -2523,7 +2826,34 @@ type CreateUserParams = {
2523
2826
  */
2524
2827
  team_id?: string;
2525
2828
  }; //#endregion
2526
- //#region src/generated/model/deleteFlowDefinitionDefaultDetails.d.ts
2829
+ //#region src/generated/model/deactivateFlowDefinition400Details.d.ts
2830
+ /**
2831
+ * Generated by orval v8.10.0 🍺
2832
+ * Do not edit manually.
2833
+ * Zitadel NextGen
2834
+ * This is the next generation of the Zitadel identity platform.
2835
+ * OpenAPI spec version: 0.0.1
2836
+ */
2837
+ /**
2838
+ * Additional error-specific context.
2839
+ */
2840
+ //#endregion
2841
+ //#region src/generated/model/deactivateFlowDefinitionParams.d.ts
2842
+ /**
2843
+ * Generated by orval v8.10.0 🍺
2844
+ * Do not edit manually.
2845
+ * Zitadel NextGen
2846
+ * This is the next generation of the Zitadel identity platform.
2847
+ * OpenAPI spec version: 0.0.1
2848
+ */
2849
+ type DeactivateFlowDefinitionParams = {
2850
+ /**
2851
+ * The unique identifier of the project
2852
+ * @pattern ^[a-zA-Z0-9_-]+$
2853
+ */
2854
+ project_id: string;
2855
+ }; //#endregion
2856
+ //#region src/generated/model/deleteFlowDefinition409Details.d.ts
2527
2857
  /**
2528
2858
  * Generated by orval v8.10.0 🍺
2529
2859
  * Do not edit manually.
@@ -3133,7 +3463,7 @@ type GetFlowDefinition200FlowDefinitionAudience = {
3133
3463
  /** Restrict to specific teams (organizations). Empty means no team restriction. */team_ids?: string[]; /** Restrict to specific applications. Empty means no app restriction. */
3134
3464
  app_ids?: string[];
3135
3465
  }; //#endregion
3136
- //#region src/generated/model/getFlowDefinition200FlowDefinitionStepsItemActionsItem.d.ts
3466
+ //#region src/generated/model/getFlowDefinition200FlowDefinitionStatus.d.ts
3137
3467
  /**
3138
3468
  * Generated by orval v8.10.0 🍺
3139
3469
  * Do not edit manually.
@@ -3141,13 +3471,72 @@ type GetFlowDefinition200FlowDefinitionAudience = {
3141
3471
  * This is the next generation of the Zitadel identity platform.
3142
3472
  * OpenAPI spec version: 0.0.1
3143
3473
  */
3474
+ /**
3475
+ * The lifecycle state of this flow definition.
3476
+
3477
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
3478
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
3479
+
3480
+ Allowed transitions:
3481
+ - draft -> active: To activate the flow definition.
3482
+ - active -> draft: To remove the flow definition from active use immediately.
3483
+
3484
+ */
3485
+ type GetFlowDefinition200FlowDefinitionStatus = (typeof GetFlowDefinition200FlowDefinitionStatus)[keyof typeof GetFlowDefinition200FlowDefinitionStatus];
3486
+ declare const GetFlowDefinition200FlowDefinitionStatus: {
3487
+ readonly active: "active";
3488
+ readonly draft: "draft";
3489
+ }; //#endregion
3490
+ //#region src/generated/model/getFlowDefinition200FlowDefinitionStepsItemActionsItemKind.d.ts
3491
+ /**
3492
+ * Generated by orval v8.10.0 🍺
3493
+ * Do not edit manually.
3494
+ * Zitadel NextGen
3495
+ * This is the next generation of the Zitadel identity platform.
3496
+ * OpenAPI spec version: 0.0.1
3497
+ */
3498
+ /**
3499
+ * Classifies how the engine handles this action:
3500
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
3501
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
3502
+ fires once the returned assertion verifies.
3503
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
3504
+ transition fires once the returned attestation verifies.
3505
+ - `navigate`: route through the transition without running the input
3506
+ pipeline. Used for pure-routing actions declared in the flow definition.
3507
+ - `back`: return the user to the previous step. Surfaced by the engine
3508
+ when going back is available.
3509
+
3510
+ */
3511
+ type GetFlowDefinition200FlowDefinitionStepsItemActionsItemKind = (typeof GetFlowDefinition200FlowDefinitionStepsItemActionsItemKind)[keyof typeof GetFlowDefinition200FlowDefinitionStepsItemActionsItemKind];
3512
+ declare const GetFlowDefinition200FlowDefinitionStepsItemActionsItemKind: {
3513
+ readonly submit: "submit";
3514
+ readonly passkey: "passkey";
3515
+ readonly passkey_register: "passkey_register";
3516
+ readonly navigate: "navigate";
3517
+ readonly back: "back";
3518
+ }; //#endregion
3519
+ //#region src/generated/model/getFlowDefinition200FlowDefinitionStepsItemActionsItem.d.ts
3144
3520
  /**
3145
3521
  * Configuration for a user-invokable action on a step. The `name` is sent
3146
- back in the submit request as `action`.
3522
+ back in the submit request as `action`; the engine resolves the action's
3523
+ declared `kind` to decide how to handle the submission.
3147
3524
 
3148
3525
  */
3149
3526
  type GetFlowDefinition200FlowDefinitionStepsItemActionsItem = {
3150
3527
  /** Action identifier. Sent back in the submit request as `action`. */name: string;
3528
+ /** Classifies how the engine handles this action:
3529
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
3530
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
3531
+ fires once the returned assertion verifies.
3532
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
3533
+ transition fires once the returned attestation verifies.
3534
+ - `navigate`: route through the transition without running the input
3535
+ pipeline. Used for pure-routing actions declared in the flow definition.
3536
+ - `back`: return the user to the previous step. Surfaced by the engine
3537
+ when going back is available.
3538
+ */
3539
+ kind: GetFlowDefinition200FlowDefinitionStepsItemActionsItemKind;
3151
3540
  /** Marks this as the default/primary action. The runtime template uses
3152
3541
  this hint to choose visual emphasis. At most one action per step
3153
3542
  should be primary; this is not enforced here.
@@ -3385,6 +3774,14 @@ type GetFlowDefinition200FlowDefinition = {
3385
3774
  * @pattern ^[a-z][a-z0-9-]*$
3386
3775
  */
3387
3776
  name: string;
3777
+ /** The lifecycle state of this flow definition.
3778
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
3779
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
3780
+ Allowed transitions:
3781
+ - draft -> active: To activate the flow definition.
3782
+ - active -> draft: To remove the flow definition from active use immediately.
3783
+ */
3784
+ status?: GetFlowDefinition200FlowDefinitionStatus;
3388
3785
  /** User schema this flow operates on. Step `fields` reference properties
3389
3786
  defined in this schema. The engine resolves field types, validation,
3390
3787
  and implicit outcomes from schema annotations at runtime.
@@ -3409,11 +3806,42 @@ type GetFlowDefinition200FlowDefinition = {
3409
3806
  */
3410
3807
  steps: GetFlowDefinition200FlowDefinitionStepsItem[];
3411
3808
  }; //#endregion
3809
+ //#region src/generated/model/getFlowDefinition200Status.d.ts
3810
+ /**
3811
+ * Generated by orval v8.10.0 🍺
3812
+ * Do not edit manually.
3813
+ * Zitadel NextGen
3814
+ * This is the next generation of the Zitadel identity platform.
3815
+ * OpenAPI spec version: 0.0.1
3816
+ */
3817
+ /**
3818
+ * The lifecycle state of this flow definition.
3819
+
3820
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
3821
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
3822
+
3823
+ Allowed transitions:
3824
+ - draft -> active: To activate the flow definition.
3825
+ - active -> draft: To remove the flow definition from active use immediately.
3826
+
3827
+ */
3828
+ type GetFlowDefinition200Status = (typeof GetFlowDefinition200Status)[keyof typeof GetFlowDefinition200Status];
3829
+ declare const GetFlowDefinition200Status: {
3830
+ readonly active: "active";
3831
+ readonly draft: "draft";
3832
+ }; //#endregion
3412
3833
  //#region src/generated/model/getFlowDefinition200.d.ts
3413
3834
  type GetFlowDefinition200 = {
3414
3835
  /** Unique identifier for the flow definition. */id: string; /** Identifier of the project this flow definition belongs to. */
3415
- project_id: string; /** Status of the flow definition. */
3416
- status: string;
3836
+ project_id: string;
3837
+ /** The lifecycle state of this flow definition.
3838
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
3839
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
3840
+ Allowed transitions:
3841
+ - draft -> active: To activate the flow definition.
3842
+ - active -> draft: To remove the flow definition from active use immediately.
3843
+ */
3844
+ status: GetFlowDefinition200Status;
3417
3845
  /** A flow definition is the server-side configuration that describes a complete
3418
3846
  authentication or identity flow. It is NOT sent to the frontend — the flow
3419
3847
  engine evaluates it and produces FlowResponse payloads (steps with capability
@@ -3494,7 +3922,7 @@ type GetFlowStep200Branding = {
3494
3922
  font_url?: string; /** Hero/background image URL (used by split layout). */
3495
3923
  hero_url?: string;
3496
3924
  }; //#endregion
3497
- //#region src/generated/model/getFlowStep200StepActionsItem.d.ts
3925
+ //#region src/generated/model/getFlowStep200StepActionsItemKind.d.ts
3498
3926
  /**
3499
3927
  * Generated by orval v8.10.0 🍺
3500
3928
  * Do not edit manually.
@@ -3502,13 +3930,48 @@ type GetFlowStep200Branding = {
3502
3930
  * This is the next generation of the Zitadel identity platform.
3503
3931
  * OpenAPI spec version: 0.0.1
3504
3932
  */
3933
+ /**
3934
+ * Classifies how the engine handles this action:
3935
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
3936
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
3937
+ fires once the returned assertion verifies.
3938
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
3939
+ transition fires once the returned attestation verifies.
3940
+ - `navigate`: route through the transition without running the input
3941
+ pipeline. Used for pure-routing actions declared in the flow definition.
3942
+ - `back`: return the user to the previous step. Surfaced by the engine
3943
+ when going back is available.
3944
+
3945
+ */
3946
+ type GetFlowStep200StepActionsItemKind = (typeof GetFlowStep200StepActionsItemKind)[keyof typeof GetFlowStep200StepActionsItemKind];
3947
+ declare const GetFlowStep200StepActionsItemKind: {
3948
+ readonly submit: "submit";
3949
+ readonly passkey: "passkey";
3950
+ readonly passkey_register: "passkey_register";
3951
+ readonly navigate: "navigate";
3952
+ readonly back: "back";
3953
+ }; //#endregion
3954
+ //#region src/generated/model/getFlowStep200StepActionsItem.d.ts
3505
3955
  /**
3506
3956
  * Configuration for a user-invokable action on a step. The `name` is sent
3507
- back in the submit request as `action`.
3957
+ back in the submit request as `action`; the engine resolves the action's
3958
+ declared `kind` to decide how to handle the submission.
3508
3959
 
3509
3960
  */
3510
3961
  type GetFlowStep200StepActionsItem = {
3511
3962
  /** Action identifier. Sent back in the submit request as `action`. */name: string;
3963
+ /** Classifies how the engine handles this action:
3964
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
3965
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
3966
+ fires once the returned assertion verifies.
3967
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
3968
+ transition fires once the returned attestation verifies.
3969
+ - `navigate`: route through the transition without running the input
3970
+ pipeline. Used for pure-routing actions declared in the flow definition.
3971
+ - `back`: return the user to the previous step. Surfaced by the engine
3972
+ when going back is available.
3973
+ */
3974
+ kind: GetFlowStep200StepActionsItemKind;
3512
3975
  /** Marks this as the default/primary action. The runtime template uses
3513
3976
  this hint to choose visual emphasis. At most one action per step
3514
3977
  should be primary; this is not enforced here.
@@ -5084,7 +5547,7 @@ type IssueChallengeBody = {
5084
5547
  * OpenAPI spec version: 0.0.1
5085
5548
  */
5086
5549
  //#endregion
5087
- //#region src/generated/model/listFlowDefinitions200FlowDefinitionsItem.d.ts
5550
+ //#region src/generated/model/listFlowDefinitions200FlowDefinitionsItemStatus.d.ts
5088
5551
  /**
5089
5552
  * Generated by orval v8.10.0 🍺
5090
5553
  * Do not edit manually.
@@ -5092,6 +5555,23 @@ type IssueChallengeBody = {
5092
5555
  * This is the next generation of the Zitadel identity platform.
5093
5556
  * OpenAPI spec version: 0.0.1
5094
5557
  */
5558
+ /**
5559
+ * The lifecycle state of this flow definition.
5560
+
5561
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
5562
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
5563
+
5564
+ Allowed transitions:
5565
+ - draft -> active: To activate the flow definition.
5566
+ - active -> draft: To remove the flow definition from active use immediately.
5567
+
5568
+ */
5569
+ type ListFlowDefinitions200FlowDefinitionsItemStatus = (typeof ListFlowDefinitions200FlowDefinitionsItemStatus)[keyof typeof ListFlowDefinitions200FlowDefinitionsItemStatus];
5570
+ declare const ListFlowDefinitions200FlowDefinitionsItemStatus: {
5571
+ readonly active: "active";
5572
+ readonly draft: "draft";
5573
+ }; //#endregion
5574
+ //#region src/generated/model/listFlowDefinitions200FlowDefinitionsItem.d.ts
5095
5575
  /**
5096
5576
  * Response object for a flow definition after creation.
5097
5577
 
@@ -5107,8 +5587,15 @@ type ListFlowDefinitions200FlowDefinitionsItem = {
5107
5587
  /** URI of the flow definition schema this definition was authored against.
5108
5588
  If the schema_uri was not provided in the request, the flow definition is validated against the latest version of the schema, and the response includes the schema_uri of the latest version.
5109
5589
  */
5110
- schema_uri?: string; /** Status of the flow definition. */
5111
- status: string; /** Timestamp when the flow definition was created. */
5590
+ schema_uri?: string;
5591
+ /** The lifecycle state of this flow definition.
5592
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
5593
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
5594
+ Allowed transitions:
5595
+ - draft -> active: To activate the flow definition.
5596
+ - active -> draft: To remove the flow definition from active use immediately.
5597
+ */
5598
+ status: ListFlowDefinitions200FlowDefinitionsItemStatus; /** Timestamp when the flow definition was created. */
5112
5599
  created_at: string; /** Timestamp when the flow definition was last updated. */
5113
5600
  updated_at: string;
5114
5601
  }; //#endregion
@@ -5649,7 +6136,7 @@ type SubmitFlowStep200Branding = {
5649
6136
  font_url?: string; /** Hero/background image URL (used by split layout). */
5650
6137
  hero_url?: string;
5651
6138
  }; //#endregion
5652
- //#region src/generated/model/submitFlowStep200StepActionsItem.d.ts
6139
+ //#region src/generated/model/submitFlowStep200StepActionsItemKind.d.ts
5653
6140
  /**
5654
6141
  * Generated by orval v8.10.0 🍺
5655
6142
  * Do not edit manually.
@@ -5657,13 +6144,48 @@ type SubmitFlowStep200Branding = {
5657
6144
  * This is the next generation of the Zitadel identity platform.
5658
6145
  * OpenAPI spec version: 0.0.1
5659
6146
  */
6147
+ /**
6148
+ * Classifies how the engine handles this action:
6149
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
6150
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
6151
+ fires once the returned assertion verifies.
6152
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
6153
+ transition fires once the returned attestation verifies.
6154
+ - `navigate`: route through the transition without running the input
6155
+ pipeline. Used for pure-routing actions declared in the flow definition.
6156
+ - `back`: return the user to the previous step. Surfaced by the engine
6157
+ when going back is available.
6158
+
6159
+ */
6160
+ type SubmitFlowStep200StepActionsItemKind = (typeof SubmitFlowStep200StepActionsItemKind)[keyof typeof SubmitFlowStep200StepActionsItemKind];
6161
+ declare const SubmitFlowStep200StepActionsItemKind: {
6162
+ readonly submit: "submit";
6163
+ readonly passkey: "passkey";
6164
+ readonly passkey_register: "passkey_register";
6165
+ readonly navigate: "navigate";
6166
+ readonly back: "back";
6167
+ }; //#endregion
6168
+ //#region src/generated/model/submitFlowStep200StepActionsItem.d.ts
5660
6169
  /**
5661
6170
  * Configuration for a user-invokable action on a step. The `name` is sent
5662
- back in the submit request as `action`.
6171
+ back in the submit request as `action`; the engine resolves the action's
6172
+ declared `kind` to decide how to handle the submission.
5663
6173
 
5664
6174
  */
5665
6175
  type SubmitFlowStep200StepActionsItem = {
5666
6176
  /** Action identifier. Sent back in the submit request as `action`. */name: string;
6177
+ /** Classifies how the engine handles this action:
6178
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
6179
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
6180
+ fires once the returned assertion verifies.
6181
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
6182
+ transition fires once the returned attestation verifies.
6183
+ - `navigate`: route through the transition without running the input
6184
+ pipeline. Used for pure-routing actions declared in the flow definition.
6185
+ - `back`: return the user to the previous step. Surfaced by the engine
6186
+ when going back is available.
6187
+ */
6188
+ kind: SubmitFlowStep200StepActionsItemKind;
5667
6189
  /** Marks this as the default/primary action. The runtime template uses
5668
6190
  this hint to choose visual emphasis. At most one action per step
5669
6191
  should be primary; this is not enforced here.
@@ -6180,7 +6702,31 @@ type UpdateFlowDefinition200FlowDefinitionAudience = {
6180
6702
  /** Restrict to specific teams (organizations). Empty means no team restriction. */team_ids?: string[]; /** Restrict to specific applications. Empty means no app restriction. */
6181
6703
  app_ids?: string[];
6182
6704
  }; //#endregion
6183
- //#region src/generated/model/updateFlowDefinition200FlowDefinitionStepsItemActionsItem.d.ts
6705
+ //#region src/generated/model/updateFlowDefinition200FlowDefinitionStatus.d.ts
6706
+ /**
6707
+ * Generated by orval v8.10.0 🍺
6708
+ * Do not edit manually.
6709
+ * Zitadel NextGen
6710
+ * This is the next generation of the Zitadel identity platform.
6711
+ * OpenAPI spec version: 0.0.1
6712
+ */
6713
+ /**
6714
+ * The lifecycle state of this flow definition.
6715
+
6716
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
6717
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
6718
+
6719
+ Allowed transitions:
6720
+ - draft -> active: To activate the flow definition.
6721
+ - active -> draft: To remove the flow definition from active use immediately.
6722
+
6723
+ */
6724
+ type UpdateFlowDefinition200FlowDefinitionStatus = (typeof UpdateFlowDefinition200FlowDefinitionStatus)[keyof typeof UpdateFlowDefinition200FlowDefinitionStatus];
6725
+ declare const UpdateFlowDefinition200FlowDefinitionStatus: {
6726
+ readonly active: "active";
6727
+ readonly draft: "draft";
6728
+ }; //#endregion
6729
+ //#region src/generated/model/updateFlowDefinition200FlowDefinitionStepsItemActionsItemKind.d.ts
6184
6730
  /**
6185
6731
  * Generated by orval v8.10.0 🍺
6186
6732
  * Do not edit manually.
@@ -6188,13 +6734,48 @@ type UpdateFlowDefinition200FlowDefinitionAudience = {
6188
6734
  * This is the next generation of the Zitadel identity platform.
6189
6735
  * OpenAPI spec version: 0.0.1
6190
6736
  */
6737
+ /**
6738
+ * Classifies how the engine handles this action:
6739
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
6740
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
6741
+ fires once the returned assertion verifies.
6742
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
6743
+ transition fires once the returned attestation verifies.
6744
+ - `navigate`: route through the transition without running the input
6745
+ pipeline. Used for pure-routing actions declared in the flow definition.
6746
+ - `back`: return the user to the previous step. Surfaced by the engine
6747
+ when going back is available.
6748
+
6749
+ */
6750
+ type UpdateFlowDefinition200FlowDefinitionStepsItemActionsItemKind = (typeof UpdateFlowDefinition200FlowDefinitionStepsItemActionsItemKind)[keyof typeof UpdateFlowDefinition200FlowDefinitionStepsItemActionsItemKind];
6751
+ declare const UpdateFlowDefinition200FlowDefinitionStepsItemActionsItemKind: {
6752
+ readonly submit: "submit";
6753
+ readonly passkey: "passkey";
6754
+ readonly passkey_register: "passkey_register";
6755
+ readonly navigate: "navigate";
6756
+ readonly back: "back";
6757
+ }; //#endregion
6758
+ //#region src/generated/model/updateFlowDefinition200FlowDefinitionStepsItemActionsItem.d.ts
6191
6759
  /**
6192
6760
  * Configuration for a user-invokable action on a step. The `name` is sent
6193
- back in the submit request as `action`.
6761
+ back in the submit request as `action`; the engine resolves the action's
6762
+ declared `kind` to decide how to handle the submission.
6194
6763
 
6195
6764
  */
6196
6765
  type UpdateFlowDefinition200FlowDefinitionStepsItemActionsItem = {
6197
6766
  /** Action identifier. Sent back in the submit request as `action`. */name: string;
6767
+ /** Classifies how the engine handles this action:
6768
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
6769
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
6770
+ fires once the returned assertion verifies.
6771
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
6772
+ transition fires once the returned attestation verifies.
6773
+ - `navigate`: route through the transition without running the input
6774
+ pipeline. Used for pure-routing actions declared in the flow definition.
6775
+ - `back`: return the user to the previous step. Surfaced by the engine
6776
+ when going back is available.
6777
+ */
6778
+ kind: UpdateFlowDefinition200FlowDefinitionStepsItemActionsItemKind;
6198
6779
  /** Marks this as the default/primary action. The runtime template uses
6199
6780
  this hint to choose visual emphasis. At most one action per step
6200
6781
  should be primary; this is not enforced here.
@@ -6432,6 +7013,14 @@ type UpdateFlowDefinition200FlowDefinition = {
6432
7013
  * @pattern ^[a-z][a-z0-9-]*$
6433
7014
  */
6434
7015
  name: string;
7016
+ /** The lifecycle state of this flow definition.
7017
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
7018
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
7019
+ Allowed transitions:
7020
+ - draft -> active: To activate the flow definition.
7021
+ - active -> draft: To remove the flow definition from active use immediately.
7022
+ */
7023
+ status?: UpdateFlowDefinition200FlowDefinitionStatus;
6435
7024
  /** User schema this flow operates on. Step `fields` reference properties
6436
7025
  defined in this schema. The engine resolves field types, validation,
6437
7026
  and implicit outcomes from schema annotations at runtime.
@@ -6456,11 +7045,42 @@ type UpdateFlowDefinition200FlowDefinition = {
6456
7045
  */
6457
7046
  steps: UpdateFlowDefinition200FlowDefinitionStepsItem[];
6458
7047
  }; //#endregion
7048
+ //#region src/generated/model/updateFlowDefinition200Status.d.ts
7049
+ /**
7050
+ * Generated by orval v8.10.0 🍺
7051
+ * Do not edit manually.
7052
+ * Zitadel NextGen
7053
+ * This is the next generation of the Zitadel identity platform.
7054
+ * OpenAPI spec version: 0.0.1
7055
+ */
7056
+ /**
7057
+ * The lifecycle state of this flow definition.
7058
+
7059
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
7060
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
7061
+
7062
+ Allowed transitions:
7063
+ - draft -> active: To activate the flow definition.
7064
+ - active -> draft: To remove the flow definition from active use immediately.
7065
+
7066
+ */
7067
+ type UpdateFlowDefinition200Status = (typeof UpdateFlowDefinition200Status)[keyof typeof UpdateFlowDefinition200Status];
7068
+ declare const UpdateFlowDefinition200Status: {
7069
+ readonly active: "active";
7070
+ readonly draft: "draft";
7071
+ }; //#endregion
6459
7072
  //#region src/generated/model/updateFlowDefinition200.d.ts
6460
7073
  type UpdateFlowDefinition200 = {
6461
7074
  /** Unique identifier for the flow definition. */id: string; /** Identifier of the project this flow definition belongs to. */
6462
- project_id: string; /** Status of the flow definition. */
6463
- status: string;
7075
+ project_id: string;
7076
+ /** The lifecycle state of this flow definition.
7077
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
7078
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
7079
+ Allowed transitions:
7080
+ - draft -> active: To activate the flow definition.
7081
+ - active -> draft: To remove the flow definition from active use immediately.
7082
+ */
7083
+ status: UpdateFlowDefinition200Status;
6464
7084
  /** A flow definition is the server-side configuration that describes a complete
6465
7085
  authentication or identity flow. It is NOT sent to the frontend — the flow
6466
7086
  engine evaluates it and produces FlowResponse payloads (steps with capability
@@ -6485,7 +7105,7 @@ type UpdateFlowDefinition200 = {
6485
7105
  * Additional error-specific context.
6486
7106
  */
6487
7107
  //#endregion
6488
- //#region src/generated/model/updateFlowDefinitionBodyAudience.d.ts
7108
+ //#region src/generated/model/updateFlowDefinitionBodyFlowDefinitionAudience.d.ts
6489
7109
  /**
6490
7110
  * Generated by orval v8.10.0 🍺
6491
7111
  * Do not edit manually.
@@ -6500,11 +7120,35 @@ matches every request in the project. The engine picks the most specific
6500
7120
  matching definition: app > team > project-wide.
6501
7121
 
6502
7122
  */
6503
- type UpdateFlowDefinitionBodyAudience = {
7123
+ type UpdateFlowDefinitionBodyFlowDefinitionAudience = {
6504
7124
  /** Restrict to specific teams (organizations). Empty means no team restriction. */team_ids?: string[]; /** Restrict to specific applications. Empty means no app restriction. */
6505
7125
  app_ids?: string[];
6506
7126
  }; //#endregion
6507
- //#region src/generated/model/updateFlowDefinitionBodyStepsItemActionsItem.d.ts
7127
+ //#region src/generated/model/updateFlowDefinitionBodyFlowDefinitionStatus.d.ts
7128
+ /**
7129
+ * Generated by orval v8.10.0 🍺
7130
+ * Do not edit manually.
7131
+ * Zitadel NextGen
7132
+ * This is the next generation of the Zitadel identity platform.
7133
+ * OpenAPI spec version: 0.0.1
7134
+ */
7135
+ /**
7136
+ * The lifecycle state of this flow definition.
7137
+
7138
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
7139
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
7140
+
7141
+ Allowed transitions:
7142
+ - draft -> active: To activate the flow definition.
7143
+ - active -> draft: To remove the flow definition from active use immediately.
7144
+
7145
+ */
7146
+ type UpdateFlowDefinitionBodyFlowDefinitionStatus = (typeof UpdateFlowDefinitionBodyFlowDefinitionStatus)[keyof typeof UpdateFlowDefinitionBodyFlowDefinitionStatus];
7147
+ declare const UpdateFlowDefinitionBodyFlowDefinitionStatus: {
7148
+ readonly active: "active";
7149
+ readonly draft: "draft";
7150
+ }; //#endregion
7151
+ //#region src/generated/model/updateFlowDefinitionBodyFlowDefinitionStepsItemActionsItemKind.d.ts
6508
7152
  /**
6509
7153
  * Generated by orval v8.10.0 🍺
6510
7154
  * Do not edit manually.
@@ -6512,13 +7156,48 @@ type UpdateFlowDefinitionBodyAudience = {
6512
7156
  * This is the next generation of the Zitadel identity platform.
6513
7157
  * OpenAPI spec version: 0.0.1
6514
7158
  */
7159
+ /**
7160
+ * Classifies how the engine handles this action:
7161
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
7162
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
7163
+ fires once the returned assertion verifies.
7164
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
7165
+ transition fires once the returned attestation verifies.
7166
+ - `navigate`: route through the transition without running the input
7167
+ pipeline. Used for pure-routing actions declared in the flow definition.
7168
+ - `back`: return the user to the previous step. Surfaced by the engine
7169
+ when going back is available.
7170
+
7171
+ */
7172
+ type UpdateFlowDefinitionBodyFlowDefinitionStepsItemActionsItemKind = (typeof UpdateFlowDefinitionBodyFlowDefinitionStepsItemActionsItemKind)[keyof typeof UpdateFlowDefinitionBodyFlowDefinitionStepsItemActionsItemKind];
7173
+ declare const UpdateFlowDefinitionBodyFlowDefinitionStepsItemActionsItemKind: {
7174
+ readonly submit: "submit";
7175
+ readonly passkey: "passkey";
7176
+ readonly passkey_register: "passkey_register";
7177
+ readonly navigate: "navigate";
7178
+ readonly back: "back";
7179
+ }; //#endregion
7180
+ //#region src/generated/model/updateFlowDefinitionBodyFlowDefinitionStepsItemActionsItem.d.ts
6515
7181
  /**
6516
7182
  * Configuration for a user-invokable action on a step. The `name` is sent
6517
- back in the submit request as `action`.
7183
+ back in the submit request as `action`; the engine resolves the action's
7184
+ declared `kind` to decide how to handle the submission.
6518
7185
 
6519
7186
  */
6520
- type UpdateFlowDefinitionBodyStepsItemActionsItem = {
7187
+ type UpdateFlowDefinitionBodyFlowDefinitionStepsItemActionsItem = {
6521
7188
  /** Action identifier. Sent back in the submit request as `action`. */name: string;
7189
+ /** Classifies how the engine handles this action:
7190
+ - `submit`: collect the step's fields and run validate/dispatch/on_success.
7191
+ - `passkey`: issue a WebAuthn assertion challenge; the matching transition
7192
+ fires once the returned assertion verifies.
7193
+ - `passkey_register`: issue a WebAuthn registration challenge; the matching
7194
+ transition fires once the returned attestation verifies.
7195
+ - `navigate`: route through the transition without running the input
7196
+ pipeline. Used for pure-routing actions declared in the flow definition.
7197
+ - `back`: return the user to the previous step. Surfaced by the engine
7198
+ when going back is available.
7199
+ */
7200
+ kind: UpdateFlowDefinitionBodyFlowDefinitionStepsItemActionsItemKind;
6522
7201
  /** Marks this as the default/primary action. The runtime template uses
6523
7202
  this hint to choose visual emphasis. At most one action per step
6524
7203
  should be primary; this is not enforced here.
@@ -6531,7 +7210,7 @@ type UpdateFlowDefinitionBodyStepsItemActionsItem = {
6531
7210
  */
6532
7211
  text_key?: string;
6533
7212
  }; //#endregion
6534
- //#region src/generated/model/updateFlowDefinitionBodyStepsItemComplete.d.ts
7213
+ //#region src/generated/model/updateFlowDefinitionBodyFlowDefinitionStepsItemComplete.d.ts
6535
7214
  /**
6536
7215
  * Generated by orval v8.10.0 🍺
6537
7216
  * Do not edit manually.
@@ -6545,12 +7224,12 @@ type UpdateFlowDefinitionBodyStepsItemActionsItem = {
6545
7224
  - show: render as a success/info screen
6546
7225
 
6547
7226
  */
6548
- type UpdateFlowDefinitionBodyStepsItemComplete = (typeof UpdateFlowDefinitionBodyStepsItemComplete)[keyof typeof UpdateFlowDefinitionBodyStepsItemComplete];
6549
- declare const UpdateFlowDefinitionBodyStepsItemComplete: {
7227
+ type UpdateFlowDefinitionBodyFlowDefinitionStepsItemComplete = (typeof UpdateFlowDefinitionBodyFlowDefinitionStepsItemComplete)[keyof typeof UpdateFlowDefinitionBodyFlowDefinitionStepsItemComplete];
7228
+ declare const UpdateFlowDefinitionBodyFlowDefinitionStepsItemComplete: {
6550
7229
  readonly redirect: "redirect";
6551
7230
  readonly show: "show";
6552
7231
  }; //#endregion
6553
- //#region src/generated/model/updateFlowDefinitionBodyStepsItemGatesConfig.d.ts
7232
+ //#region src/generated/model/updateFlowDefinitionBodyFlowDefinitionStepsItemGatesConfig.d.ts
6554
7233
  /**
6555
7234
  * Generated by orval v8.10.0 🍺
6556
7235
  * Do not edit manually.
@@ -6563,10 +7242,10 @@ declare const UpdateFlowDefinitionBodyStepsItemComplete: {
6563
7242
  issuing the per-render challenge. Opaque to the engine.
6564
7243
 
6565
7244
  */
6566
- type UpdateFlowDefinitionBodyStepsItemGatesConfig = {
7245
+ type UpdateFlowDefinitionBodyFlowDefinitionStepsItemGatesConfig = {
6567
7246
  [key: string]: unknown;
6568
7247
  }; //#endregion
6569
- //#region src/generated/model/updateFlowDefinitionBodyStepsItemGatesKind.d.ts
7248
+ //#region src/generated/model/updateFlowDefinitionBodyFlowDefinitionStepsItemGatesKind.d.ts
6570
7249
  /**
6571
7250
  * Generated by orval v8.10.0 🍺
6572
7251
  * Do not edit manually.
@@ -6580,11 +7259,11 @@ ceremonies (e.g. passkey) are modelled as credential auth_attempts via
6580
7259
  `x-credential` on a field, not as gates.
6581
7260
 
6582
7261
  */
6583
- type UpdateFlowDefinitionBodyStepsItemGatesKind = (typeof UpdateFlowDefinitionBodyStepsItemGatesKind)[keyof typeof UpdateFlowDefinitionBodyStepsItemGatesKind];
6584
- declare const UpdateFlowDefinitionBodyStepsItemGatesKind: {
7262
+ type UpdateFlowDefinitionBodyFlowDefinitionStepsItemGatesKind = (typeof UpdateFlowDefinitionBodyFlowDefinitionStepsItemGatesKind)[keyof typeof UpdateFlowDefinitionBodyFlowDefinitionStepsItemGatesKind];
7263
+ declare const UpdateFlowDefinitionBodyFlowDefinitionStepsItemGatesKind: {
6585
7264
  readonly captcha: "captcha";
6586
7265
  }; //#endregion
6587
- //#region src/generated/model/updateFlowDefinitionBodyStepsItemGates.d.ts
7266
+ //#region src/generated/model/updateFlowDefinitionBodyFlowDefinitionStepsItemGates.d.ts
6588
7267
  /**
6589
7268
  * Security gates that must be satisfied before submission. Keyed by gate
6590
7269
  name. Each gate selects a kind (e.g. "captcha") and provider-specific
@@ -6592,13 +7271,13 @@ configuration. The engine may also inject gates dynamically based on
6592
7271
  policy.
6593
7272
 
6594
7273
  */
6595
- type UpdateFlowDefinitionBodyStepsItemGates = {
7274
+ type UpdateFlowDefinitionBodyFlowDefinitionStepsItemGates = {
6596
7275
  [key: string]: {
6597
7276
  /** The gate category. Only `captcha` is currently defined. Authenticator
6598
7277
  ceremonies (e.g. passkey) are modelled as credential auth_attempts via
6599
7278
  `x-credential` on a field, not as gates.
6600
7279
  */
6601
- kind: UpdateFlowDefinitionBodyStepsItemGatesKind;
7280
+ kind: UpdateFlowDefinitionBodyFlowDefinitionStepsItemGatesKind;
6602
7281
  /** Provider identifier within the gate kind — e.g. `altcha`, `turnstile`,
6603
7282
  `hcaptcha`. The engine looks up an implementation in its provider
6604
7283
  registry.
@@ -6607,10 +7286,10 @@ type UpdateFlowDefinitionBodyStepsItemGates = {
6607
7286
  /** Provider-specific configuration consumed by the implementation when
6608
7287
  issuing the per-render challenge. Opaque to the engine.
6609
7288
  */
6610
- config?: UpdateFlowDefinitionBodyStepsItemGatesConfig;
7289
+ config?: UpdateFlowDefinitionBodyFlowDefinitionStepsItemGatesConfig;
6611
7290
  };
6612
7291
  }; //#endregion
6613
- //#region src/generated/model/updateFlowDefinitionBodyStepsItemOnSuccess.d.ts
7292
+ //#region src/generated/model/updateFlowDefinitionBodyFlowDefinitionStepsItemOnSuccess.d.ts
6614
7293
  /**
6615
7294
  * Generated by orval v8.10.0 🍺
6616
7295
  * Do not edit manually.
@@ -6625,11 +7304,11 @@ Runs after field validation passes, before the transition fires.
6625
7304
  - create_user: creates the user record (registration flows)
6626
7305
 
6627
7306
  */
6628
- type UpdateFlowDefinitionBodyStepsItemOnSuccess = (typeof UpdateFlowDefinitionBodyStepsItemOnSuccess)[keyof typeof UpdateFlowDefinitionBodyStepsItemOnSuccess];
6629
- declare const UpdateFlowDefinitionBodyStepsItemOnSuccess: {
7307
+ type UpdateFlowDefinitionBodyFlowDefinitionStepsItemOnSuccess = (typeof UpdateFlowDefinitionBodyFlowDefinitionStepsItemOnSuccess)[keyof typeof UpdateFlowDefinitionBodyFlowDefinitionStepsItemOnSuccess];
7308
+ declare const UpdateFlowDefinitionBodyFlowDefinitionStepsItemOnSuccess: {
6630
7309
  readonly create_user: "create_user";
6631
7310
  }; //#endregion
6632
- //#region src/generated/model/updateFlowDefinitionBodyStepsItemSsoProvidersItem.d.ts
7311
+ //#region src/generated/model/updateFlowDefinitionBodyFlowDefinitionStepsItemSsoProvidersItem.d.ts
6633
7312
  /**
6634
7313
  * Generated by orval v8.10.0 🍺
6635
7314
  * Do not edit manually.
@@ -6640,12 +7319,12 @@ declare const UpdateFlowDefinitionBodyStepsItemOnSuccess: {
6640
7319
  /**
6641
7320
  * An available SSO identity provider.
6642
7321
  */
6643
- type UpdateFlowDefinitionBodyStepsItemSsoProvidersItem = {
7322
+ type UpdateFlowDefinitionBodyFlowDefinitionStepsItemSsoProvidersItem = {
6644
7323
  /** Provider instance identifier. */id: string; /** Display name for the provider. */
6645
7324
  name: string; /** Template hint for rendering (logo, colors). */
6646
7325
  template: string;
6647
7326
  }; //#endregion
6648
- //#region src/generated/model/updateFlowDefinitionBodyStepsItemTransitions.d.ts
7327
+ //#region src/generated/model/updateFlowDefinitionBodyFlowDefinitionStepsItemTransitions.d.ts
6649
7328
  /**
6650
7329
  * Generated by orval v8.10.0 🍺
6651
7330
  * Do not edit manually.
@@ -6662,7 +7341,7 @@ come from implicit outcomes based on schema annotations
6662
7341
  events (e.g. `sso`, `callback`).
6663
7342
 
6664
7343
  */
6665
- type UpdateFlowDefinitionBodyStepsItemTransitions = {
7344
+ type UpdateFlowDefinitionBodyFlowDefinitionStepsItemTransitions = {
6666
7345
  [key: string]: {
6667
7346
  /** Step name within this flow (when `action` is null), or the name
6668
7347
  of another flow (when `action` is `switch` or `pivot`).
@@ -6680,7 +7359,7 @@ type UpdateFlowDefinitionBodyStepsItemTransitions = {
6680
7359
  action?: "switch" | "pivot" | null;
6681
7360
  };
6682
7361
  }; //#endregion
6683
- //#region src/generated/model/updateFlowDefinitionBodyStepsItem.d.ts
7362
+ //#region src/generated/model/updateFlowDefinitionBodyFlowDefinitionStepsItem.d.ts
6684
7363
  /**
6685
7364
  * A step in a flow definition. This is the admin-authored configuration,
6686
7365
  not the runtime payload sent to the frontend.
@@ -6693,7 +7372,7 @@ A step with only `complete` set is a terminal step. All other steps are
6693
7372
  rendered to the frontend as capability payloads.
6694
7373
 
6695
7374
  */
6696
- type UpdateFlowDefinitionBodyStepsItem = {
7375
+ type UpdateFlowDefinitionBodyFlowDefinitionStepsItem = {
6697
7376
  /** Unique step identifier within this flow. Used as transition targets
6698
7377
  and returned in the API response as `step.name`.
6699
7378
  */
@@ -6709,64 +7388,106 @@ type UpdateFlowDefinitionBodyStepsItem = {
6709
7388
  frontend sends back in the submit request. If omitted, the engine
6710
7389
  provides a default `submit` action.
6711
7390
  */
6712
- actions?: UpdateFlowDefinitionBodyStepsItemActionsItem[];
7391
+ actions?: UpdateFlowDefinitionBodyFlowDefinitionStepsItemActionsItem[];
6713
7392
  /** Security gates that must be satisfied before submission. Keyed by gate
6714
7393
  name. Each gate selects a kind (e.g. "captcha") and provider-specific
6715
7394
  configuration. The engine may also inject gates dynamically based on
6716
7395
  policy.
6717
7396
  */
6718
- gates?: UpdateFlowDefinitionBodyStepsItemGates; /** Available SSO identity providers for this step. */
6719
- sso_providers?: UpdateFlowDefinitionBodyStepsItemSsoProvidersItem[];
7397
+ gates?: UpdateFlowDefinitionBodyFlowDefinitionStepsItemGates; /** Available SSO identity providers for this step. */
7398
+ sso_providers?: UpdateFlowDefinitionBodyFlowDefinitionStepsItemSsoProvidersItem[];
6720
7399
  /** Server-side mutation to execute when this step completes successfully.
6721
7400
  Runs after field validation passes, before the transition fires.
6722
7401
  - create_user: creates the user record (registration flows)
6723
7402
  */
6724
- on_success?: UpdateFlowDefinitionBodyStepsItemOnSuccess;
7403
+ on_success?: UpdateFlowDefinitionBodyFlowDefinitionStepsItemOnSuccess;
6725
7404
  /** Marks this as a terminal step. Tells the frontend what to do:
6726
7405
  - redirect: navigate to redirect_uri (OIDC/SAML callback done)
6727
7406
  - show: render as a success/info screen
6728
7407
  */
6729
- complete?: UpdateFlowDefinitionBodyStepsItemComplete;
7408
+ complete?: UpdateFlowDefinitionBodyFlowDefinitionStepsItemComplete;
6730
7409
  /** Maps action/outcome names to their transition descriptor.
6731
7410
  Keys match action names from the `actions` array. Additional keys
6732
7411
  come from implicit outcomes based on schema annotations
6733
7412
  (e.g. `user_not_found` from `x-unique` fields) and engine
6734
7413
  events (e.g. `sso`, `callback`).
6735
7414
  */
6736
- transitions?: UpdateFlowDefinitionBodyStepsItemTransitions;
7415
+ transitions?: UpdateFlowDefinitionBodyFlowDefinitionStepsItemTransitions;
6737
7416
  }; //#endregion
6738
- //#region src/generated/model/updateFlowDefinitionBody.d.ts
7417
+ //#region src/generated/model/updateFlowDefinitionBodyFlowDefinition.d.ts
6739
7418
  /**
6740
- * Partial update for a flow definition. Only provided fields are replaced;
6741
- omitted fields retain their current server-side values.
6742
-
6743
- Collection fields (`steps`, `purposes`) are treated atomically: if
6744
- provided, the entire array/object is replaced. If omitted, the current
6745
- value is preserved unchanged.
7419
+ * A flow definition is the server-side configuration that describes a complete
7420
+ authentication or identity flow. It is NOT sent to the frontend — the flow
7421
+ engine evaluates it and produces FlowResponse payloads (steps with capability
7422
+ dictionaries) for the client.
6746
7423
 
6747
- `name` is a stable identifier and cannot be changed after creation.
7424
+ Flow definitions are created by administrators and stored in the project/team
7425
+ configuration hierarchy. The engine selects the matching definition based on
7426
+ the purpose + audience when a flow is created via POST /flow.
6748
7427
 
6749
7428
  */
6750
- type UpdateFlowDefinitionBody = {
6751
- /** User schema this flow operates on. Replaces the current value if provided.
7429
+ type UpdateFlowDefinitionBodyFlowDefinition = {
7430
+ /**
7431
+ * Stable identifier for this flow, used as the target of cross-flow
7432
+ `switch` and `pivot` transitions. Renaming is not supported — the
7433
+ `name` is part of the public contract another definition may
7434
+ reference. Acts as the human display label as well; no separate slug.
7435
+ * @pattern ^[a-z][a-z0-9-]*$
7436
+ */
7437
+ name: string;
7438
+ /** The lifecycle state of this flow definition.
7439
+ active: The flow definition is ready to be used. The flow engine can select it for new flows.
7440
+ draft: The engine will not select it for new flows, and existing flows must handle it gracefully if they reference this definition.
7441
+ Allowed transitions:
7442
+ - draft -> active: To activate the flow definition.
7443
+ - active -> draft: To remove the flow definition from active use immediately.
7444
+ */
7445
+ status?: UpdateFlowDefinitionBodyFlowDefinitionStatus;
7446
+ /** User schema this flow operates on. Step `fields` reference properties
7447
+ defined in this schema. The engine resolves field types, validation,
7448
+ and implicit outcomes from schema annotations at runtime.
6752
7449
  */
6753
- user_schema?: string;
6754
- /** Replaces the full purpose-to-entry-step map if provided. Keys are
6755
- purpose names; values must match a `name` in `steps`.
7450
+ user_schema: string;
7451
+ /** Maps each purpose this definition handles to its entry-point step.
7452
+ Keys are purpose names; values must match a `name` in `steps`. A
7453
+ definition can serve multiple purposes (e.g. a combined login/register
7454
+ flow) by listing one entry per purpose.
6756
7455
  */
6757
- purposes?: Partial<Record<"login" | "register" | "recovery" | "profiling" | "reauth" | "link_account", string>>;
7456
+ purposes: Partial<Record<"login" | "register" | "recovery" | "profiling" | "reauth" | "link_account", string>>;
6758
7457
  /** Scopes which teams or apps this flow definition applies to. Empty or
6759
7458
  omitted fields mean "no restriction"; when both are empty the definition
6760
7459
  matches every request in the project. The engine picks the most specific
6761
7460
  matching definition: app > team > project-wide.
6762
7461
  */
6763
- audience?: UpdateFlowDefinitionBodyAudience;
7462
+ audience?: UpdateFlowDefinitionBodyFlowDefinitionAudience;
6764
7463
  /**
6765
- * Replaces the full steps array if provided. Partial step lists are not
6766
- supported supply all steps when updating this field.
7464
+ * Ordered list of steps in this flow. The order is for human readability —
7465
+ actual step sequencing is determined by transitions.
6767
7466
  * @minItems 1
6768
7467
  */
6769
- steps?: UpdateFlowDefinitionBodyStepsItem[];
7468
+ steps: UpdateFlowDefinitionBodyFlowDefinitionStepsItem[];
7469
+ }; //#endregion
7470
+ //#region src/generated/model/updateFlowDefinitionBody.d.ts
7471
+ /**
7472
+ * Replaces the existing flow definition.
7473
+ If `flow_definition.status` is omitted, the current status is preserved
7474
+
7475
+ */
7476
+ type UpdateFlowDefinitionBody = {
7477
+ /** URI of the server-published flow definition schema this definition was
7478
+ authored against. The server uses this to validate the definition.
7479
+ If not provided, the engine will use the latest schema version for validation.
7480
+ */
7481
+ schema_uri?: string;
7482
+ /** A flow definition is the server-side configuration that describes a complete
7483
+ authentication or identity flow. It is NOT sent to the frontend — the flow
7484
+ engine evaluates it and produces FlowResponse payloads (steps with capability
7485
+ dictionaries) for the client.
7486
+ Flow definitions are created by administrators and stored in the project/team
7487
+ configuration hierarchy. The engine selects the matching definition based on
7488
+ the purpose + audience when a flow is created via POST /flow.
7489
+ */
7490
+ flow_definition: UpdateFlowDefinitionBodyFlowDefinition;
6770
7491
  }; //#endregion
6771
7492
  //#region src/generated/model/updateFlowDefinitionDefaultDetails.d.ts
6772
7493
  /**
@@ -7392,5 +8113,98 @@ declare global {
7392
8113
  }
7393
8114
  } //# sourceMappingURL=zl-pill.d.ts.map
7394
8115
  //#endregion
7395
- export { GetFlowStep200 as $, CreateFlowDefinitionBody as A, RevokeTokenBody as At, CreateTeamBody as B, VerifyChallengeProofBody as Bt, CreateFlow201StepChallenge as C, ListFlowDefinitions200 as Ct, CreateFlowBody as D, ListUsers200Item as Dt, CreateFlow201StepSsoProvidersItem as E, ListSessionsParams as Et, CreateSchemaBody as F, SubmitFlowStepBody as Ft, DeleteFlowDefinitionParams as G, ZlAlert as Gt, CreateUser201 as H, zlCardManifest as Ht, CreateSchemaParams as I, UpdateFlowDefinition200 as It, ExchangeHandoffBody as J, ZlIcon as Jt, EndSessionParams as K, zlAlertManifest as Kt, CreateSession201 as L, UpdateFlowDefinitionBody as Lt, CreateProject201 as M, SetUserPasswordParams as Mt, CreateProjectBody as N, SubmitFlowEventBody as Nt, CreateFlowBodyPurpose as O, ListUsersParams as Ot, CreateSchema201 as P, SubmitFlowStep200 as Pt, GetFlowDefinitionParams as Q, CreateSessionBody as R, UpdateFlowDefinitionParams as Rt, CreateFlow201StepActionsItem as S, IssueChallengeBody as St, CreateFlow201StepGates as T, ListSessions200 as Tt, CreateUserBody as U, ZlButton as Ut, CreateTeamParams as V, ZlCard as Vt, CreateUserParams as W, zlButtonManifest as Wt, GetAuthAttempt200 as X, ExchangeHandoffParams as Y, zlIconManifest as Yt, GetFlowDefinition200 as Z, CreateAuthAttemptBody as _, GetUserByIDParams as _t, ZlPasskeyResultDetail as a, GetOpenIDConfiguration200 as at, CreateFlow201BrandingLayout as b, IntrospectBody as bt, zlPageShellManifest as c, GetSchemaById200 as ct, zlFieldManifest as d, GetSessionParams as dt, GetHealthDefault as et, AuthorizeDevice200 as f, GetTeam200 as ft, CreateAuthAttempt201 as g, GetUserByID200 as gt, AuthorizeGetParams as h, GetTokenBody as ht, ZlPasskeyErrorDetail as i, GetMyUser200 as it, CreateHandoff200 as j, SetUserPasswordBody as jt, CreateFlowDefinition201 as k, RevokeSessionParams as kt, ZlField as l, GetSchemaByIdParams as lt, AuthorizeGetDefault as m, GetToken200 as mt, zlPillManifest as n, GetLiveDefault as nt, zlPasskeyManifest as o, GetProject200 as ot, AuthorizeDeviceParams as p, GetTeamParams as pt, ExchangeHandoff200 as q, IconName as qt, ZlPasskey as r, GetMySession200 as rt, ZlPageShell as s, GetReadyDefault as st, ZlPill as t, GetKeys200 as tt, ZlFieldType as u, GetSession200 as ut, CreateFlow201 as v, GetUserInfo200 as vt, CreateFlow201StepFieldsItem as w, ListFlowDefinitionsParams as wt, CreateFlow201Step as x, IssueChallenge201 as xt, CreateFlow201Branding as y, Introspect200 as yt, CreateTeam201 as z, VerifyChallengeProof200 as zt };
7396
- //# sourceMappingURL=index-DVDCrfkv.d.mts.map
8116
+ //#region src/atoms/zl-select.d.ts
8117
+ /** A single choice in a `<zl-select>` listbox. */
8118
+ interface ZlSelectOption {
8119
+ value: string;
8120
+ label: string;
8121
+ disabled?: boolean;
8122
+ }
8123
+ /** Detail shape emitted by the `zl-change` event. */
8124
+ type ZlSelectChangeDetail = {
8125
+ name: string;
8126
+ value: string;
8127
+ };
8128
+ /**
8129
+ * Atom: `<zl-select>` — a select-only combobox bound to a single choice.
8130
+ *
8131
+ * Spec lineage (file `8UjCXw8yemgljmbkWGrSfE`, "Zitadel - Design System - External"):
8132
+ * - trigger + open/selected matrix: node `4397:4816` (Dropdown)
8133
+ * - option (Items) state matrix: node `4397:4098` (Input text)
8134
+ *
8135
+ * The trigger mirrors `<zl-field>`'s box; the popup is a `role="listbox"` whose
8136
+ * options paint the Figma hover / keyboard-active wash and the chosen row's
8137
+ * solid fill + check glyph. Follows the WAI-ARIA select-only combobox pattern:
8138
+ * focus stays on the trigger and `aria-activedescendant` tracks the active
8139
+ * option, so arrow keys move a virtual cursor without moving DOM focus.
8140
+ *
8141
+ * Form participation: `<zl-select>` is a form-associated custom element; its
8142
+ * `value` is the selected option's value (empty string = nothing chosen).
8143
+ */
8144
+ declare class ZlSelect extends LitElement {
8145
+ static formAssociated: boolean;
8146
+ static shadowRootOptions: ShadowRootInit;
8147
+ static styles: _$lit.CSSResult[];
8148
+ /**
8149
+ * Field name — used as the key in form submission and in `zl-change` detail.
8150
+ * Managed manually to avoid clobbering the native form-associated `name`
8151
+ * accessor the browser owns (see `<zl-field>` / `<zl-checkbox>`).
8152
+ */
8153
+ get name(): string;
8154
+ set name(value: string);
8155
+ accessor label: string;
8156
+ accessor value: string;
8157
+ accessor placeholder: string;
8158
+ /**
8159
+ * Listbox options. Accepts either a JS array (property binding, used by React
8160
+ * and Storybook) or a JSON string (the `options` attribute, used by the
8161
+ * orchestrator's Liquid template, which can only emit markup). Mirrors the
8162
+ * `<zl-passkey>` options contract.
8163
+ */
8164
+ accessor options: ZlSelectOption[];
8165
+ accessor required: boolean;
8166
+ accessor disabled: boolean;
8167
+ accessor open: boolean;
8168
+ accessor ariaLabelText: string | undefined;
8169
+ accessor testId: string | undefined;
8170
+ private accessor activeIndex;
8171
+ private accessor triggerEl;
8172
+ private readonly baseId;
8173
+ private readonly internals;
8174
+ private defaultValue;
8175
+ constructor();
8176
+ connectedCallback(): void;
8177
+ disconnectedCallback(): void;
8178
+ willUpdate(changed: PropertyValues<this>): void;
8179
+ formResetCallback(): void;
8180
+ formStateRestoreCallback(state: string | null): void;
8181
+ focus(options?: FocusOptions): void;
8182
+ render(): _$lit.TemplateResult<1>;
8183
+ private renderLabel;
8184
+ private renderOption;
8185
+ private optionId;
8186
+ private handleLabelClick;
8187
+ private handleTriggerClick;
8188
+ private handleTriggerKeyDown;
8189
+ private handleOptionClick;
8190
+ private handleOptionPointerMove;
8191
+ private handleDocumentPointerDown;
8192
+ private openMenu;
8193
+ private close;
8194
+ private commitActive;
8195
+ private moveActive;
8196
+ private setActive;
8197
+ private firstEnabledIndex;
8198
+ private lastEnabledIndex;
8199
+ private syncFormState;
8200
+ private triggerTestId;
8201
+ }
8202
+ declare const zlSelectManifest: AtomManifest;
8203
+ declare global {
8204
+ interface HTMLElementTagNameMap {
8205
+ "zl-select": ZlSelect;
8206
+ }
8207
+ } //# sourceMappingURL=zl-select.d.ts.map
8208
+ //#endregion
8209
+ export { ExchangeHandoff200 as $, zlButtonManifest as $t, CreateFlow201StepGates as A, ListFlowDefinitionsParams as At, CreateSchemaBody as B, SubmitFlowStep200 as Bt, CreateFlow201 as C, GetUserByIDParams as Ct, CreateFlow201StepActionsItem as D, IssueChallenge201 as Dt, CreateFlow201Step as E, IntrospectBody as Et, CreateFlowDefinitionBody as F, RevokeSessionParams as Ft, CreateTeamBody as G, VerifyChallengeProof200 as Gt, CreateSession201 as H, UpdateFlowDefinition200 as Ht, CreateHandoff200 as I, RevokeTokenBody as It, CreateUserBody as J, ZlCheckboxChangeDetail as Jt, CreateTeamParams as K, VerifyChallengeProofBody as Kt, CreateProject201 as L, SetUserPasswordBody as Lt, CreateFlowBody as M, ListSessionsParams as Mt, CreateFlowBodyPurpose as N, ListUsers200Item as Nt, CreateFlow201StepChallenge as O, IssueChallengeBody as Ot, CreateFlowDefinition201 as P, ListUsersParams as Pt, EndSessionParams as Q, ZlButton as Qt, CreateProjectBody as R, SetUserPasswordParams as Rt, CreateAuthAttemptBody as S, GetUserByID200 as St, CreateFlow201BrandingLayout as T, Introspect200 as Tt, CreateSessionBody as U, UpdateFlowDefinitionBody as Ut, CreateSchemaParams as V, SubmitFlowStepBody as Vt, CreateTeam201 as W, UpdateFlowDefinitionParams as Wt, DeactivateFlowDefinitionParams as X, ZlCard as Xt, CreateUserParams as Y, zlCheckboxManifest as Yt, DeleteFlowDefinitionParams as Z, zlCardManifest as Zt, AuthorizeDevice200 as _, GetSessionParams as _t, ZlPill as a, GetFlowStep200 as at, AuthorizeGetParams as b, GetToken200 as bt, ZlPasskeyErrorDetail as c, GetLiveDefault as ct, ZlPageShell as d, GetOpenIDConfiguration200 as dt, ZlAlert as en, ExchangeHandoffBody as et, zlPageShellManifest as f, GetProject200 as ft, ActivateFlowDefinitionParams as g, GetSession200 as gt, zlFieldManifest as h, GetSchemaByIdParams as ht, zlSelectManifest as i, zlIconManifest as in, GetFlowDefinitionParams as it, CreateFlow201StepSsoProvidersItem as j, ListSessions200 as jt, CreateFlow201StepFieldsItem as k, ListFlowDefinitions200 as kt, ZlPasskeyResultDetail as l, GetMySession200 as lt, ZlFieldType as m, GetSchemaById200 as mt, ZlSelectChangeDetail as n, IconName as nn, GetAuthAttempt200 as nt, zlPillManifest as o, GetHealthDefault as ot, ZlField as p, GetReadyDefault as pt, CreateUser201 as q, ZlCheckbox as qt, ZlSelectOption as r, ZlIcon as rn, GetFlowDefinition200 as rt, ZlPasskey as s, GetKeys200 as st, ZlSelect as t, zlAlertManifest as tn, ExchangeHandoffParams as tt, zlPasskeyManifest as u, GetMyUser200 as ut, AuthorizeDeviceParams as v, GetTeam200 as vt, CreateFlow201Branding as w, GetUserInfo200 as wt, CreateAuthAttempt201 as x, GetTokenBody as xt, AuthorizeGetDefault as y, GetTeamParams as yt, CreateSchema201 as z, SubmitFlowEventBody as zt };
8210
+ //# sourceMappingURL=index-1zs8u08H.d.mts.map