@futdevpro/fsm-dynamo 1.20.6 → 1.20.8

package/src/_modules/deployment/_models/atomic-rollback-manifest.interface.ts

@@ -1,59 +1,59 @@
-/** Deployment environments accepted by the shared atomic rollback contract. */
-export type DyFM_AtomicRollbackEnvironment_Type = 'test' | 'production';
-
-/** Content-free authority reference supplied by the deployment control plane. */
-export interface DyFM_AtomicRollbackAuthority_Interface {
-  principalId: string;
-  evidenceId: string;
-}
-
-/** Exact version-controlled configuration and database compatibility target. */
-export interface DyFM_AtomicRollbackConfiguration_Interface {
-  revision: string;
-  sha256: string;
-  compatibilityVersion: string;
-  policyChecksum: string;
-}
-
-/** One immutable image target and its mutable release promotion destination. */
-export interface DyFM_AtomicRollbackImage_Interface {
-  service: string;
-  version: string;
-  immutableReference: string;
-  mutableReference: string;
-  digest: string;
-}
-
-/** One bounded post-deployment probe tied to a service in the image set. */
-export interface DyFM_AtomicRollbackPostCheck_Interface {
-  checkId: string;
-  service: string;
-  endpoint: string;
-  expectedProbeContract: string;
-}
-
-/** Complete versioned target for an atomic multi-service rollout or rollback. */
-export interface DyFM_AtomicRollbackManifest_Interface {
-  contractVersion: 'fdp-atomic-rollback-manifest/1';
-  operationId: string;
-  environment: DyFM_AtomicRollbackEnvironment_Type;
-  authority: DyFM_AtomicRollbackAuthority_Interface;
-  sourceRevision: string;
-  configuration: DyFM_AtomicRollbackConfiguration_Interface;
-  images: DyFM_AtomicRollbackImage_Interface[];
-  postChecks: DyFM_AtomicRollbackPostCheck_Interface[];
-  targetChecksum: string;
-}
-
-/** Bounded content-free validation evidence for an unknown manifest value. */
-export interface DyFM_AtomicRollbackLocalValidation_Interface {
-  contractVersion: 'fdp-atomic-rollback-local-validation/1';
-  valid: boolean;
-  environment: DyFM_AtomicRollbackEnvironment_Type | 'invalid';
-  operationId: string | 'invalid';
-  targetChecksum: string | 'invalid';
-  serviceCount: number;
-  postCheckCount: number;
-  gapCodes: string[];
-  manifest?: DyFM_AtomicRollbackManifest_Interface;
-}
+/** Deployment environments accepted by the shared atomic rollback contract. */
+export type DyFM_AtomicRollbackEnvironment_Type = 'test' | 'production';
+
+/** Content-free authority reference supplied by the deployment control plane. */
+export interface DyFM_AtomicRollbackAuthority_Interface {
+  principalId: string;
+  evidenceId: string;
+}
+
+/** Exact version-controlled configuration and database compatibility target. */
+export interface DyFM_AtomicRollbackConfiguration_Interface {
+  revision: string;
+  sha256: string;
+  compatibilityVersion: string;
+  policyChecksum: string;
+}
+
+/** One immutable image target and its mutable release promotion destination. */
+export interface DyFM_AtomicRollbackImage_Interface {
+  service: string;
+  version: string;
+  immutableReference: string;
+  mutableReference: string;
+  digest: string;
+}
+
+/** One bounded post-deployment probe tied to a service in the image set. */
+export interface DyFM_AtomicRollbackPostCheck_Interface {
+  checkId: string;
+  service: string;
+  endpoint: string;
+  expectedProbeContract: string;
+}
+
+/** Complete versioned target for an atomic multi-service rollout or rollback. */
+export interface DyFM_AtomicRollbackManifest_Interface {
+  contractVersion: 'fdp-atomic-rollback-manifest/1';
+  operationId: string;
+  environment: DyFM_AtomicRollbackEnvironment_Type;
+  authority: DyFM_AtomicRollbackAuthority_Interface;
+  sourceRevision: string;
+  configuration: DyFM_AtomicRollbackConfiguration_Interface;
+  images: DyFM_AtomicRollbackImage_Interface[];
+  postChecks: DyFM_AtomicRollbackPostCheck_Interface[];
+  targetChecksum: string;
+}
+
+/** Bounded content-free validation evidence for an unknown manifest value. */
+export interface DyFM_AtomicRollbackLocalValidation_Interface {
+  contractVersion: 'fdp-atomic-rollback-local-validation/1';
+  valid: boolean;
+  environment: DyFM_AtomicRollbackEnvironment_Type | 'invalid';
+  operationId: string | 'invalid';
+  targetChecksum: string | 'invalid';
+  serviceCount: number;
+  postCheckCount: number;
+  gapCodes: string[];
+  manifest?: DyFM_AtomicRollbackManifest_Interface;
+}

package/src/_modules/deployment/index.ts

@@ -1,2 +1,2 @@
-export * from './_collections/atomic-rollback-manifest.util';
-export * from './_models/atomic-rollback-manifest.interface';
+export * from './_collections/atomic-rollback-manifest.util';
+export * from './_models/atomic-rollback-manifest.interface';

package/src/_modules/ngx-models/_enums/field-type.enum.ts

@@ -18,10 +18,11 @@ export enum DyFM_Field_Type {
   sliderRange = 'sliderRange',
   select = 'select',
   multiselect = 'multiselect',
-  chipSelect = 'chipSelect', //
-  chipMultiselect = 'chipMultiselect', //
-  radioSelect = 'radioSelect', //
-  date = 'date',
+  chipSelect = 'chipSelect', //
+  chipMultiselect = 'chipMultiselect', //
+  radioSelect = 'radioSelect', //
+  colorPicker = 'color-picker',
+  date = 'date',
   dateRange = 'dateRange',
   dateTime = 'dateTime',
   dateTimeRange = 'dateTimeRange',

package/src/_modules/ngx-models/_models/control-models/forms-new/color-picker-field-new-settings.control-model.ts

@@ -0,0 +1,44 @@
+import { DyFM_Field_Type } from '../../../_enums/field-type.enum';
+import { DyFM_FieldNew_Validator_Type } from '../../../_enums/forms-new/field-new-validator-type.enum';
+import {
+  DyFM_FieldNew_Settings,
+  DyFM_FieldNew_Validator_Descriptor
+} from './field-new-settings.control-model';
+
+const DYNAMO_COLOR_PICKER_HEX_PATTERN: string = '^#[0-9a-fA-F]{6}$';
+
+/**
+ * Forms v2 color-picker settings.
+ *
+ * The string value uses the browser-native `#RRGGBB` color contract so the same
+ * serializable Settings object can be shared by frontend and backend consumers.
+ */
+export class DyFM_ColorPickerFieldNew_Settings extends DyFM_FieldNew_Settings<string> {
+  override readonly type: DyFM_Field_Type.colorPicker = DyFM_Field_Type.colorPicker;
+
+  /** Creates serializable color-picker settings while protecting the discriminator. */
+  constructor(set: Partial<DyFM_ColorPickerFieldNew_Settings>) {
+    super(set);
+    const rest: Partial<DyFM_ColorPickerFieldNew_Settings> = { ...set };
+
+    Reflect.deleteProperty(rest, 'type');
+    Object.assign(this, rest);
+
+    const validators: DyFM_FieldNew_Validator_Descriptor[] = this.validators ?? [];
+    const hasHexValidator: boolean = validators.some((validator: DyFM_FieldNew_Validator_Descriptor): boolean =>
+      validator.type === DyFM_FieldNew_Validator_Type.pattern
+      && validator.value === DYNAMO_COLOR_PICKER_HEX_PATTERN,
+    );
+
+    if (!hasHexValidator) {
+      this.validators = [
+        ...validators,
+        {
+          type: DyFM_FieldNew_Validator_Type.pattern,
+          value: DYNAMO_COLOR_PICKER_HEX_PATTERN,
+          message: 'Enter a color as #RRGGBB.',
+        },
+      ];
+    }
+  }
+}

package/src/_modules/ngx-models/_models/control-models/forms-new/field-new-types.ts

@@ -1,4 +1,5 @@
-import { DyFM_CheckboxFieldNew_Settings } from './checkbox-field-new-settings.control-model';
+import { DyFM_CheckboxFieldNew_Settings } from './checkbox-field-new-settings.control-model';
+import { DyFM_ColorPickerFieldNew_Settings } from './color-picker-field-new-settings.control-model';
 import { DyFM_DateFieldNew_Settings } from './date-field-new-settings.control-model';
 import { DyFM_DateRangeFieldNew_Settings } from './date-range-field-new-settings.control-model';
 import { DyFM_DateTimeFieldNew_Settings } from './datetime-field-new-settings.control-model';
@@ -32,8 +33,9 @@ export type DyFM_FieldNew_Settings_AnyType =
   | DyFM_PasswordFieldNew_Settings
   | DyFM_SliderFieldNew_Settings
   | DyFM_SliderRangeFieldNew_Settings
-  | DyFM_CheckboxFieldNew_Settings
-  | DyFM_SelectFieldNew_Settings<unknown>
+  | DyFM_CheckboxFieldNew_Settings
+  | DyFM_ColorPickerFieldNew_Settings
+  | DyFM_SelectFieldNew_Settings<unknown>
   | DyFM_MultiselectFieldNew_Settings<unknown>
   | DyFM_RadioSelectFieldNew_Settings<unknown>
   | DyFM_DateFieldNew_Settings

package/src/_modules/ngx-models/_models/control-models/forms-new/forms-new.spec.ts

@@ -1,9 +1,11 @@
 import { DyFM_Field_Type } from '../../../_enums/field-type.enum';
 import { DyFM_FieldNew_Validator_Type } from '../../../_enums/forms-new/field-new-validator-type.enum';
 import {
-  DyFM_CheckboxFieldNew_Settings,
-  DyFM_DateFieldNew_Settings,
-  DyFM_FieldNew_Settings,
+  DyFM_CheckboxFieldNew_Settings,
+  DyFM_ColorPickerFieldNew_Settings,
+  DyFM_DateFieldNew_Settings,
+  DyFM_FieldNew_Settings,
+  DyFM_FieldNew_Validator_Descriptor,
   DyFM_FormNew_Settings,
   DyFM_MultiselectFieldNew_Settings,
   DyFM_NumberFieldNew_Settings,
@@ -75,7 +77,7 @@ describe('| Forms v2 — Wave-1A Settings layer', () => {
     });
   });
 
-  describe('| DyFM_CheckboxFieldNew_Settings', () => {
+  describe('| DyFM_CheckboxFieldNew_Settings', () => {
     it('| default constructor + type is checkbox', () => {
       const s = new DyFM_CheckboxFieldNew_Settings({ key: 'done' });
       expect(s.type).toBe(DyFM_Field_Type.checkbox);
@@ -87,7 +89,36 @@ describe('| Forms v2 — Wave-1A Settings layer', () => {
       expect(s.mode).toBe('toggle');
       expect(s.labelPosition).toBe('before');
     });
-  });
+  });
+
+  describe('| DyFM_ColorPickerFieldNew_Settings', () => {
+    it('| stores a serializable hex value and owns the color-picker discriminator', () => {
+      const settings: DyFM_ColorPickerFieldNew_Settings = new DyFM_ColorPickerFieldNew_Settings({
+        key: 'accentColor',
+        defaultValue: '#22d3ee',
+      });
+
+      expect(settings.type).toBe(DyFM_Field_Type.colorPicker);
+      expect(settings.defaultValue).toBe('#22d3ee');
+      expect(settings.validators).toContain(jasmine.objectContaining({
+        type: DyFM_FieldNew_Validator_Type.pattern,
+        value: '^#[0-9a-fA-F]{6}$',
+        message: 'Enter a color as #RRGGBB.',
+      }));
+    });
+
+    it('| preserves consumer validators while adding the strict hexadecimal contract once', () => {
+      const settings: DyFM_ColorPickerFieldNew_Settings = new DyFM_ColorPickerFieldNew_Settings({
+        key: 'accentColor',
+        validators: [{ type: DyFM_FieldNew_Validator_Type.required }],
+      });
+
+      expect(settings.validators?.map(
+        (validator: DyFM_FieldNew_Validator_Descriptor): DyFM_FieldNew_Validator_Type => validator.type,
+      ))
+        .toEqual([DyFM_FieldNew_Validator_Type.required, DyFM_FieldNew_Validator_Type.pattern]);
+    });
+  });
 
   describe('| DyFM_SelectFieldNew_Settings<T>', () => {
     it('| stores options + type is select', () => {

package/src/_modules/ngx-models/_models/control-models/forms-new/index.ts

@@ -8,8 +8,9 @@ export * from './number-field-new-settings.control-model';
 export * from './password-field-new-settings.control-model';
 export * from './slider-field-new-settings.control-model';
 export * from './slider-range-field-new-settings.control-model';
-export * from './checkbox-field-new-settings.control-model';
-export * from './select-field-new-settings.control-model';
+export * from './checkbox-field-new-settings.control-model';
+export * from './color-picker-field-new-settings.control-model';
+export * from './select-field-new-settings.control-model';
 export * from './multiselect-field-new-settings.control-model';
 export * from './radio-select-field-new-settings.control-model';
 export * from './date-field-new-settings.control-model';