zinkee 0.1.44 → 0.1.45

package/src/utils/schema-fields.ts

@@ -1,1016 +0,0 @@
-import type { JsonObject } from "../types.js";
-import { CliError } from "./errors.js";
-
-export type SchemaFieldTypeKey =
-  | "text"
-  | "number"
-  | "date"
-  | "option"
-  | "file"
-  | "reference"
-  | "formula"
-  | "member"
-  | "autoincremental"
-  | "schedule";
-
-export interface SchemaFieldExamplePayload {
-  name: string;
-  payload: JsonObject;
-}
-
-export interface SchemaFieldTypeDefinition {
-  key: SchemaFieldTypeKey;
-  className: string;
-  aliases: readonly string[];
-  description: string;
-  rawShape: string;
-  examplePayloads: readonly SchemaFieldExamplePayload[];
-}
-
-function isJsonObject(value: unknown): value is JsonObject {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-function toJsonObject(value: unknown): JsonObject | undefined {
-  return isJsonObject(value) ? value : undefined;
-}
-
-function toStringValue(value: unknown): string | undefined {
-  return typeof value === "string" && value.trim().length > 0 ? value : undefined;
-}
-
-function toNumberValue(value: unknown): number | undefined {
-  if (typeof value === "number" && Number.isFinite(value)) {
-    return value;
-  }
-
-  if (typeof value === "string" && value.trim().length > 0) {
-    const parsed = Number(value);
-    if (Number.isFinite(parsed)) {
-      return parsed;
-    }
-  }
-
-  return undefined;
-}
-
-const fieldTypeDefinitions = [
-  {
-    key: "text",
-    className: "TextField",
-    aliases: ["text", "TextField"],
-    description: "Plain text field.",
-    rawShape:
-      '{"type":"TextField","slug":"name","label":"Name","config":{"textType":"NORMAL"}}',
-    examplePayloads: [
-      {
-        name: "Text field (normal)",
-        payload: {
-          type: "TextField",
-          slug: "customer-name",
-          label: "Customer Name",
-          required: true,
-          config: {
-            textType: "NORMAL",
-            defaultValue: null,
-            conditionalFormatting: [],
-          },
-        },
-      },
-      {
-        name: "Text field (long)",
-        payload: {
-          type: "TextField",
-          slug: "customer-notes",
-          label: "Customer Notes",
-          required: false,
-          config: {
-            textType: "LONG",
-            defaultValue: "Add internal notes here...",
-            conditionalFormatting: [],
-          },
-        },
-      },
-    ],
-  },
-  {
-    key: "number",
-    className: "NumberField",
-    aliases: ["number", "NumberField"],
-    description: "Numeric field.",
-    rawShape:
-      '{"type":"NumberField","slug":"quantity","label":"Quantity","config":{"defaultValue":"0","formatOptions":{"format":"number","decimals":0,"thousandsSeparator":false}}}',
-    examplePayloads: [
-      {
-        name: "Number field (plain integer)",
-        payload: {
-          type: "NumberField",
-          slug: "quantity",
-          label: "Quantity",
-          required: false,
-          config: {
-            defaultValue: "0",
-            formatOptions: {
-              format: "number",
-              decimals: 0,
-              thousandsSeparator: false,
-            },
-            conditionalFormatting: [],
-          },
-        },
-      },
-      {
-        name: "Number field (decimal with thousands)",
-        payload: {
-          type: "NumberField",
-          slug: "weight",
-          label: "Weight (kg)",
-          required: false,
-          config: {
-            defaultValue: "0",
-            formatOptions: {
-              format: "number",
-              decimals: 2,
-              thousandsSeparator: true,
-              negativesInRed: false,
-            },
-            conditionalFormatting: [],
-          },
-        },
-      },
-      {
-        name: "Number field (currency € prefix)",
-        payload: {
-          type: "NumberField",
-          slug: "amount-eur",
-          label: "Amount (EUR)",
-          required: false,
-          config: {
-            defaultValue: "0",
-            formatOptions: {
-              format: "currency",
-              decimals: 2,
-              negativesInRed: true,
-              thousandsSeparator: true,
-              symbolEnabled: true,
-              symbolPosition: "before",
-              symbolValue: "€",
-            },
-            conditionalFormatting: [],
-          },
-        },
-      },
-      {
-        name: "Number field (currency $ suffix)",
-        payload: {
-          type: "NumberField",
-          slug: "amount-usd",
-          label: "Amount (USD)",
-          required: false,
-          config: {
-            defaultValue: "0",
-            formatOptions: {
-              format: "currency",
-              decimals: 2,
-              negativesInRed: false,
-              thousandsSeparator: true,
-              symbolEnabled: true,
-              symbolPosition: "right",
-              symbolValue: " $",
-            },
-            conditionalFormatting: [],
-          },
-        },
-      },
-      {
-        name: "Number field (percentage)",
-        payload: {
-          type: "NumberField",
-          slug: "discount-rate",
-          label: "Discount Rate",
-          required: false,
-          config: {
-            defaultValue: "0",
-            formatOptions: {
-              format: "percentage",
-              decimals: 1,
-              negativesInRed: true,
-            },
-            conditionalFormatting: [],
-          },
-        },
-      },
-      {
-        name: "Number field (duration HH:MM)",
-        payload: {
-          type: "NumberField",
-          slug: "tracked-time",
-          label: "Tracked Time",
-          required: false,
-          config: {
-            defaultValue: "0",
-            formatOptions: {
-              format: "duration",
-              durationFormat: "HH:MM",
-            },
-            conditionalFormatting: [],
-          },
-        },
-      },
-    ],
-  },
-  {
-    key: "date",
-    className: "DateField",
-    aliases: ["date", "DateField"],
-    description: "Date or datetime field.",
-    rawShape:
-      '{"type":"DateField","slug":"due-date","label":"Due Date","config":{"formatOptions":{"format":"date","dateFormat":"YYYY-MM-DD","showTime":false}}}',
-    examplePayloads: [
-      {
-        name: "Date field (date only)",
-        payload: {
-          type: "DateField",
-          slug: "birth-date",
-          label: "Birth Date",
-          required: false,
-          config: {
-            defaultValue: null,
-            formatOptions: {
-              format: "date",
-              dateFormat: "YYYY-MM-DD",
-              showTime: false,
-            },
-            conditionalFormatting: [],
-          },
-        },
-      },
-      {
-        name: "Date field (datetime EU)",
-        payload: {
-          type: "DateField",
-          slug: "due-date",
-          label: "Due Date",
-          required: false,
-          config: {
-            defaultValue: null,
-            formatOptions: {
-              format: "datetime",
-              dateFormat: "DD/MM/YYYY",
-              showTime: true,
-            },
-            conditionalFormatting: [],
-          },
-        },
-      },
-      {
-        name: "Date field (datetime US)",
-        payload: {
-          type: "DateField",
-          slug: "appointment-at",
-          label: "Appointment",
-          required: false,
-          config: {
-            defaultValue: null,
-            formatOptions: {
-              format: "datetime",
-              dateFormat: "MM/DD/YYYY",
-              showTime: true,
-            },
-            conditionalFormatting: [],
-          },
-        },
-      },
-    ],
-  },
-  {
-    key: "option",
-    className: "OptionField",
-    aliases: ["option", "OptionField"],
-    description: "Dropdown/select field with options.",
-    rawShape:
-      '{"type":"OptionField","slug":"status","label":"Status","config":{"options":[{"id":1,"name":"Open","color":"default"},{"id":2,"name":"Closed","color":"success"}]}}',
-    examplePayloads: [
-      {
-        name: "Option field (select dropdown)",
-        payload: {
-          type: "OptionField",
-          slug: "priority",
-          label: "Priority",
-          required: false,
-          config: {
-            options: [
-              { id: 1, name: "Low", color: "default" },
-              { id: 2, name: "Medium", color: "warning" },
-              { id: 3, name: "High", color: "danger" },
-            ],
-            defaultValue: 1,
-            conditionalFormatting: [],
-            buttonConfig: null,
-          },
-        },
-      },
-      {
-        name: "Option field (button cycle)",
-        payload: {
-          type: "OptionField",
-          slug: "stage",
-          label: "Stage",
-          required: false,
-          config: {
-            options: [
-              { id: 1, name: "To Do", color: "default" },
-              { id: 2, name: "Doing", color: "warning" },
-              { id: 3, name: "Done", color: "success" },
-            ],
-            defaultValue: 1,
-            conditionalFormatting: [],
-            buttonConfig: {
-              displayMode: "button",
-              buttonBehavior: {
-                mode: "cycle",
-                cycleOrder: [1, 2, 3],
-                requireConfirmation: false,
-                lockAfterSelection: false,
-                allowReselect: true,
-              },
-            },
-          },
-        },
-      },
-      {
-        name: "Option field (button dropdown w/ confirm)",
-        payload: {
-          type: "OptionField",
-          slug: "status",
-          label: "Status",
-          required: false,
-          config: {
-            options: [
-              { id: 1, name: "Open", color: "default" },
-              { id: 2, name: "In Progress", color: "warning" },
-              { id: 3, name: "Done", color: "success" },
-            ],
-            defaultValue: 1,
-            conditionalFormatting: [],
-            buttonConfig: {
-              displayMode: "button",
-              buttonBehavior: {
-                mode: "dropdown",
-                requireConfirmation: true,
-                confirmationMessage: "Confirm status change",
-                useFixedLabel: true,
-                buttonLabel: "Set status",
-                allowReselect: true,
-              },
-            },
-          },
-        },
-      },
-    ],
-  },
-  {
-    key: "file",
-    className: "FileField",
-    aliases: ["file", "FileField"],
-    description: "File attachment field.",
-    rawShape:
-      '{"type":"FileField","slug":"attachment","label":"Attachment","config":{}}',
-    examplePayloads: [
-      {
-        name: "File field",
-        payload: {
-          type: "FileField",
-          slug: "attachment",
-          label: "Attachment",
-          required: false,
-          config: {},
-        },
-      },
-    ],
-  },
-  {
-    key: "reference",
-    className: "ReferenceField",
-    aliases: ["reference", "ReferenceField"],
-    description: "Reference to another schema.",
-    rawShape:
-      '{"type":"ReferenceField","slug":"company-ref","label":"Company","config":{"targetSchema":"<schema-uuid>","targetDisplayField":"<field-uuid>"}}',
-    examplePayloads: [
-      {
-        name: "Reference field (minimal)",
-        payload: {
-          type: "ReferenceField",
-          slug: "company-ref",
-          label: "Company",
-          required: false,
-          config: {
-            targetSchema: "5223cbc8-8c6c-4694-93bc-dd176364df9b",
-            targetDisplayField: "c60b8526-5835-4c9f-aecd-9a16c7704a34",
-          },
-        },
-      },
-      {
-        name: "Reference field (restrict + filter + description)",
-        payload: {
-          type: "ReferenceField",
-          slug: "customer-ref",
-          label: "Customer",
-          required: false,
-          config: {
-            targetSchema: "5223cbc8-8c6c-4694-93bc-dd176364df9b",
-            targetDisplayField: "c60b8526-5835-4c9f-aecd-9a16c7704a34",
-            deleteBehavior: "RESTRICT",
-            defaultValue: "CUST-12",
-            filterFields: [
-              {
-                fatherField: "c60b8526-5835-4c9f-aecd-9a16c7704a34",
-                currentField: "45c5da96-0dc2-4cc1-ba61-7660a9c6da32",
-                comparison: "EQUAL",
-                value: null,
-              },
-            ],
-            descriptionFields: [
-              {
-                id: "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
-                fieldType: "NumberField",
-                options: null,
-                format: "number",
-              },
-            ],
-            conditionalFormatting: [],
-          },
-        },
-      },
-    ],
-  },
-  {
-    key: "formula",
-    className: "FormulaField",
-    aliases: ["formula", "FormulaField"],
-    description: "Calculated field from a formula.",
-    rawShape:
-      '{"type":"FormulaField","slug":"formula-code","label":"Formula Code","config":{"formulaText":"concat(\\"CUST-\\", f1e1d000-0000-0000-0000-000000000005)","uiFormatKind":"none"}}',
-    examplePayloads: [
-      {
-        name: "Formula field (none)",
-        payload: {
-          type: "FormulaField",
-          slug: "formula-code",
-          label: "Formula Code",
-          required: false,
-          config: {
-            formulaText:
-              'concat("CUST-", f1e1d000-0000-0000-0000-000000000005)',
-            uiFormatKind: "none",
-            status: "ACTIVE",
-            conditionalFormatting: [],
-          },
-        },
-      },
-      {
-        name: "Formula field (number)",
-        payload: {
-          type: "FormulaField",
-          slug: "formula-total",
-          label: "Formula Total",
-          required: false,
-          config: {
-            formulaText: "c52efe3f-2825-4c60-a7e3-34dd4c1ce043 * 1.21",
-            uiFormatKind: "number",
-            status: "ACTIVE",
-            numberFormatOptions: {
-              format: "number",
-              decimals: 2,
-              thousandsSeparator: true,
-            },
-            conditionalFormatting: [],
-          },
-        },
-      },
-      {
-        name: "Formula field (date)",
-        payload: {
-          type: "FormulaField",
-          slug: "formula-period",
-          label: "Formula Period",
-          required: false,
-          config: {
-            formulaText:
-              'date_format(d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90, "AAAA-MM")',
-            uiFormatKind: "date",
-            status: "ACTIVE",
-            dateFormatOptions: {
-              format: "date",
-              dateFormat: "DD/MM/YYYY",
-              showTime: false,
-            },
-            conditionalFormatting: [],
-          },
-        },
-      },
-      {
-        name: "Formula field (member)",
-        payload: {
-          type: "FormulaField",
-          slug: "formula-assignee",
-          label: "Computed Assignee",
-          required: false,
-          config: {
-            formulaText: "a7b8c9d0-e1f2-3a4b-5c6d-7e8f90123456",
-            uiFormatKind: "member",
-            status: "ACTIVE",
-            conditionalFormatting: [],
-          },
-        },
-      },
-    ],
-  },
-  {
-    key: "member",
-    className: "MemberField",
-    aliases: ["member", "MemberField"],
-    description: "Workspace member field.",
-    rawShape:
-      '{"type":"MemberField","slug":"owner","label":"Owner","config":{"defaultValue":null}}',
-    examplePayloads: [
-      {
-        name: "Member field",
-        payload: {
-          type: "MemberField",
-          slug: "owner",
-          label: "Owner",
-          required: false,
-          config: {
-            defaultValue: null,
-            conditionalFormatting: [],
-          },
-        },
-      },
-    ],
-  },
-  {
-    key: "autoincremental",
-    className: "AutoIncrementalField",
-    aliases: [
-      "autoincremental",
-      "auto-incremental",
-      "auto_incremental",
-      "AutoIncrementalField",
-    ],
-    description: "Auto-generated incremental counter.",
-    rawShape:
-      '{"type":"AutoIncrementalField","slug":"order-number","label":"Order Number","config":{"segmentedByFieldId":null}}',
-    examplePayloads: [
-      {
-        name: "Autoincremental (global counter)",
-        payload: {
-          type: "AutoIncrementalField",
-          slug: "order-number",
-          label: "Order Number",
-          required: false,
-          config: {
-            segmentedByFieldId: null,
-            conditionalFormatting: [],
-          },
-        },
-      },
-      {
-        name: "Autoincremental (segmented)",
-        payload: {
-          type: "AutoIncrementalField",
-          slug: "sequence-code",
-          label: "Sequence Code",
-          required: false,
-          config: {
-            segmentedByFieldId: "45c5da96-0dc2-4cc1-ba61-7660a9c6da32",
-            conditionalFormatting: [],
-          },
-        },
-      },
-    ],
-  },
-  {
-    key: "schedule",
-    className: "ScheduleField",
-    aliases: ["schedule", "ScheduleField"],
-    description:
-      "Recurrence/schedule field bound to a number reference and a date period (frequency: monthly or daily).",
-    rawShape:
-      '{"type":"ScheduleField","slug":"recurrence","label":"Recurrence","config":{"referenceField":"<number-field-uuid>","beginningPeriodField":"<date-field-uuid>","endingPeriodField":"<date-field-uuid>","frequency":"monthly"}}',
-    examplePayloads: [
-      {
-        name: "Schedule field (monthly)",
-        payload: {
-          type: "ScheduleField",
-          slug: "monthly-recurrence",
-          label: "Monthly Recurrence",
-          required: false,
-          config: {
-            referenceField: "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
-            beginningPeriodField: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
-            endingPeriodField: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
-            frequency: "monthly",
-          },
-        },
-      },
-      {
-        name: "Schedule field (daily)",
-        payload: {
-          type: "ScheduleField",
-          slug: "daily-recurrence",
-          label: "Daily Recurrence",
-          required: false,
-          config: {
-            referenceField: "c52efe3f-2825-4c60-a7e3-34dd4c1ce043",
-            beginningPeriodField: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
-            endingPeriodField: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
-            frequency: "daily",
-          },
-        },
-      },
-    ],
-  },
-] as const satisfies readonly SchemaFieldTypeDefinition[];
-
-const fieldTypeDefinitionByAlias = new Map(
-  fieldTypeDefinitions.flatMap((definition) =>
-    definition.aliases.map((alias) => [alias.trim().toLowerCase(), definition] as const),
-  ),
-);
-
-const fieldTypeDefinitionByClassName = new Map<string, SchemaFieldTypeDefinition>(
-  fieldTypeDefinitions.map((definition) => [definition.className, definition] as const),
-);
-
-const optionValidationMessage =
-  'Option fields require an "options" array with at least one entry like {"id":1,"name":"Open","color":"default"}.';
-
-export function getSchemaFieldTypeDefinitions(): readonly SchemaFieldTypeDefinition[] {
-  return fieldTypeDefinitions;
-}
-
-export function listSchemaFieldTypes(): readonly SchemaFieldTypeKey[] {
-  return fieldTypeDefinitions.map((definition) => definition.key);
-}
-
-export function formatSchemaFieldTypes(): string {
-  return listSchemaFieldTypes().join(", ");
-}
-
-export function resolveSchemaFieldType(
-  input: string | undefined,
-): SchemaFieldTypeDefinition | undefined {
-  if (!input) {
-    return undefined;
-  }
-
-  return fieldTypeDefinitionByAlias.get(input.trim().toLowerCase());
-}
-
-export function resolveSchemaFieldTypeByClassName(
-  className: string | undefined,
-): SchemaFieldTypeDefinition | undefined {
-  if (!className) {
-    return undefined;
-  }
-
-  return fieldTypeDefinitionByClassName.get(className);
-}
-
-export function normalizeSchemaFieldType(input: string): string {
-  const definition = resolveSchemaFieldType(input);
-
-  if (definition) {
-    return definition.className;
-  }
-
-  if (/^[a-z]/.test(input) && !input.endsWith("Field")) {
-    return `${input.charAt(0).toUpperCase()}${input.slice(1)}Field`;
-  }
-
-  return input;
-}
-
-export function assertSupportedSchemaFieldType(type: string): void {
-  if (!resolveSchemaFieldTypeByClassName(type)) {
-    throw new CliError(
-      "invalid_cli_usage",
-      `Unsupported field type "${type}". Valid types: ${formatSchemaFieldTypes()}.`,
-    );
-  }
-}
-
-interface OptionEntry {
-  [key: string]: string | number;
-  id: number;
-  name: string;
-  color: string;
-}
-
-function normalizeOptionEntries(entries: readonly unknown[]): OptionEntry[] {
-  return entries.flatMap((entry) => {
-    if (!isJsonObject(entry)) {
-      return [];
-    }
-
-    const id = toNumberValue(entry.id);
-    const name = toStringValue(entry.name) ?? toStringValue(entry.label);
-    const color = toStringValue(entry.color) ?? "default";
-
-    if (id === undefined || !name) {
-      return [];
-    }
-
-    return [{ id, name, color }];
-  });
-}
-
-function normalizeOptionPayload(input: JsonObject): JsonObject {
-  const additionalProperties = toJsonObject(input.additionalProperties) ?? {};
-  const config = toJsonObject(input.config);
-  const rootOptions = Array.isArray(input.options) ? input.options : undefined;
-  const nestedOptions = Array.isArray(additionalProperties.options)
-    ? additionalProperties.options
-    : Array.isArray(config?.options)
-      ? config.options
-      : undefined;
-  const optionObjects = normalizeOptionEntries(
-    nestedOptions ??
-      (Array.isArray(rootOptions) ? rootOptions : []),
-  );
-
-  if (optionObjects.length === 0) {
-    throw new CliError("invalid_cli_usage", optionValidationMessage);
-  }
-
-  const { options: _options, additionalProperties: _additionalProperties, ...rest } = input;
-  const defaultValue =
-    config?.defaultValue ?? input.defaultValue ?? additionalProperties.defaultValue;
-  const conditionalFormatting =
-    config?.conditionalFormatting ?? additionalProperties.conditionalFormatting;
-  const buttonConfig = config?.buttonConfig ?? additionalProperties.buttonConfig;
-
-  return {
-    ...rest,
-    config: {
-      ...(config ?? {}),
-      options: optionObjects,
-      ...(defaultValue !== undefined ? { defaultValue } : {}),
-      ...(conditionalFormatting !== undefined ? { conditionalFormatting } : {}),
-      ...(buttonConfig !== undefined ? { buttonConfig } : {}),
-    },
-  };
-}
-
-function normalizeReferencePayload(input: JsonObject): JsonObject {
-  const additionalProperties = toJsonObject(input.additionalProperties) ?? {};
-  const config = toJsonObject(input.config) ?? {};
-  const targetSchema =
-    config.targetSchema ?? input.targetSchema ?? additionalProperties.targetSchema;
-  const targetDisplayField =
-    config.targetDisplayField ??
-    input.targetDisplayField ??
-    additionalProperties.targetDisplayField;
-  const deleteBehavior =
-    config.deleteBehavior ?? input.deleteBehavior ?? additionalProperties.deleteBehavior;
-  const defaultValue =
-    config.defaultValue ?? input.defaultValue ?? additionalProperties.defaultValue;
-  const filterFields =
-    config.filterFields ?? input.filterFields ?? additionalProperties.filterFields;
-  const descriptionFields =
-    config.descriptionFields ??
-    input.descriptionFields ??
-    additionalProperties.descriptionFields;
-  const conditionalFormatting =
-    config.conditionalFormatting ??
-    input.conditionalFormatting ??
-    additionalProperties.conditionalFormatting;
-
-  const normalized: JsonObject = {
-    ...input,
-  };
-
-  normalized.config = {
-    ...config,
-    ...(targetSchema !== undefined ? { targetSchema } : {}),
-    ...(targetDisplayField !== undefined ? { targetDisplayField } : {}),
-    ...(deleteBehavior !== undefined ? { deleteBehavior } : {}),
-    ...(defaultValue !== undefined ? { defaultValue } : {}),
-    ...(filterFields !== undefined ? { filterFields } : {}),
-    ...(descriptionFields !== undefined ? { descriptionFields } : {}),
-    ...(conditionalFormatting !== undefined ? { conditionalFormatting } : {}),
-  };
-
-  const normalizedConfig = toJsonObject(normalized.config) ?? {};
-
-  if (
-    !toStringValue(normalizedConfig.targetSchema) ||
-    !toStringValue(normalizedConfig.targetDisplayField)
-  ) {
-    const definition = resolveSchemaFieldType("reference")!;
-    throw new CliError(
-      "invalid_cli_usage",
-      `Reference fields require "targetSchema" and "targetDisplayField". Expected raw shape: ${definition.rawShape}`,
-    );
-  }
-
-  return normalized;
-}
-
-const scheduleAllowedFrequencies = new Set(["monthly", "daily"]);
-
-function normalizeSchedulePayload(input: JsonObject): JsonObject {
-  const additionalProperties = toJsonObject(input.additionalProperties) ?? {};
-  const config = toJsonObject(input.config) ?? {};
-  const referenceField =
-    config.referenceField ?? input.referenceField ?? additionalProperties.referenceField;
-  const beginningPeriodField =
-    config.beginningPeriodField ??
-    input.beginningPeriodField ??
-    additionalProperties.beginningPeriodField;
-  const endingPeriodField =
-    config.endingPeriodField ??
-    input.endingPeriodField ??
-    additionalProperties.endingPeriodField;
-  const frequency =
-    config.frequency ?? input.frequency ?? additionalProperties.frequency;
-
-  const {
-    referenceField: _referenceField,
-    beginningPeriodField: _beginningPeriodField,
-    endingPeriodField: _endingPeriodField,
-    frequency: _frequency,
-    additionalProperties: _additionalProperties,
-    ...rest
-  } = input;
-
-  const normalized: JsonObject = {
-    ...rest,
-    config: {
-      ...config,
-      ...(referenceField !== undefined ? { referenceField } : {}),
-      ...(beginningPeriodField !== undefined ? { beginningPeriodField } : {}),
-      ...(endingPeriodField !== undefined ? { endingPeriodField } : {}),
-      ...(frequency !== undefined ? { frequency } : {}),
-    },
-  };
-
-  const normalizedConfig = toJsonObject(normalized.config) ?? {};
-  const definition = resolveSchemaFieldType("schedule")!;
-
-  if (
-    !toStringValue(normalizedConfig.referenceField) ||
-    !toStringValue(normalizedConfig.beginningPeriodField) ||
-    !toStringValue(normalizedConfig.endingPeriodField) ||
-    !toStringValue(normalizedConfig.frequency)
-  ) {
-    throw new CliError(
-      "invalid_cli_usage",
-      `Schedule fields require "referenceField", "beginningPeriodField", "endingPeriodField" and "frequency". Expected raw shape: ${definition.rawShape}`,
-    );
-  }
-
-  const frequencyValue = toStringValue(normalizedConfig.frequency)!;
-  if (!scheduleAllowedFrequencies.has(frequencyValue)) {
-    throw new CliError(
-      "invalid_cli_usage",
-      `Schedule "frequency" must be "monthly" or "daily" (received "${frequencyValue}").`,
-    );
-  }
-
-  return normalized;
-}
-
-function normalizeFormulaPayload(input: JsonObject): JsonObject {
-  const { status: _status, ...rest } = input;
-  const rawAdditionalProperties = toJsonObject(input.additionalProperties);
-  const rawConfig = toJsonObject(input.config);
-  const { status: _additionalStatus, ...additionalProperties } =
-    rawAdditionalProperties ?? {};
-  const { status: _configStatus, ...config } = rawConfig ?? {};
-  const formulaText =
-    config.formulaText ??
-    rest.formulaText ??
-    rest.expression ??
-    additionalProperties.formulaText ??
-    additionalProperties.expression;
-
-  const normalized: JsonObject = {
-    ...rest,
-  };
-
-  normalized.config = {
-    ...config,
-    ...(formulaText !== undefined ? { formulaText } : {}),
-    ...(config.uiFormatKind !== undefined ? { uiFormatKind: config.uiFormatKind } : {}),
-    ...(config.defaultValue !== undefined ? { defaultValue: config.defaultValue } : {}),
-    ...(config.numberFormatOptions !== undefined
-      ? { numberFormatOptions: config.numberFormatOptions }
-      : {}),
-    ...(config.dateFormatOptions !== undefined
-      ? { dateFormatOptions: config.dateFormatOptions }
-      : {}),
-    ...(config.conditionalFormatting !== undefined
-      ? { conditionalFormatting: config.conditionalFormatting }
-      : {}),
-  };
-
-  const normalizedConfig = toJsonObject(normalized.config) ?? {};
-
-  if (!toStringValue(normalizedConfig.formulaText)) {
-    const definition = resolveSchemaFieldType("formula")!;
-    throw new CliError(
-      "invalid_cli_usage",
-      `Formula fields require "formulaText". Expected raw shape: ${definition.rawShape}`,
-    );
-  }
-
-  return normalized;
-}
-
-export function normalizeSchemaFieldCreatePayload(input: JsonObject): JsonObject {
-  const rawType = toStringValue(input.type);
-  const normalizedType = rawType ? normalizeSchemaFieldType(rawType) : undefined;
-  const definition = resolveSchemaFieldTypeByClassName(normalizedType);
-
-  if (!definition) {
-    return input;
-  }
-
-  const normalizedWithType: JsonObject = {
-    ...input,
-    type: definition.className,
-  };
-
-  switch (definition.key) {
-    case "option":
-      return normalizeOptionPayload(normalizedWithType);
-    case "reference":
-      return normalizeReferencePayload(normalizedWithType);
-    case "formula":
-      return normalizeFormulaPayload(normalizedWithType);
-    case "schedule":
-      return normalizeSchedulePayload(normalizedWithType);
-    case "autoincremental": {
-      const config = toJsonObject(normalizedWithType.config) ?? {};
-      const segmentedByFieldId =
-        config.segmentedByFieldId ??
-        normalizedWithType.segmentedByFieldId ??
-        null;
-      return {
-        ...normalizedWithType,
-        config: {
-          ...config,
-          segmentedByFieldId,
-          ...(config.conditionalFormatting !== undefined
-            ? { conditionalFormatting: config.conditionalFormatting }
-            : {}),
-        },
-      };
-    }
-    default:
-      return normalizedWithType;
-  }
-}
-
-export function normalizeSchemaFieldUpdatePayload(
-  type: string,
-  input: JsonObject,
-): JsonObject {
-  const definition = resolveSchemaFieldTypeByClassName(type);
-
-  if (definition?.key === "formula") {
-    return normalizeFormulaPayload(input);
-  }
-
-  return input;
-}
-
-export function buildSchemaFieldCreateHelpText(): string {
-  const sections = fieldTypeDefinitions.map(
-    (definition) =>
-      `  - ${definition.key}: ${definition.description}\n    raw: ${definition.rawShape}`,
-  );
-
-  return [
-    "",
-    "Valid field types:",
-    `  ${formatSchemaFieldTypes()}`,
-    "",
-    "Raw payload shapes by type:",
-    ...sections,
-    "",
-    'Use "zinkee --example schemas fields create --type <type>" to show a concrete example for one type.',
-  ].join("\n");
-}
-
-export function buildSchemaFieldCreateValidationMessage(type: string): string {
-  const definition = resolveSchemaFieldTypeByClassName(type);
-
-  if (!definition) {
-    return `Invalid payload for field type "${type}". Valid types: ${formatSchemaFieldTypes()}.`;
-  }
-
-  return `Invalid payload for field type "${definition.key}". Expected raw shape: ${definition.rawShape}`;
-}