move import models to FluentCommand.Import

Author: pwelter34

.editorconfig

@@ -9,6 +9,8 @@ indent_style = space
 indent_size = 4
 insert_final_newline = true
 trim_trailing_whitespace = true
+vsspell_section_id = main
+vsspell_ignored_words_main = File:dictionary.dic
 
 # XML Configuration Files
 [*.{xml,config,props,targets,nuspec,resx,ruleset,vsixmanifest,vsct,refactorlog,runsettings}]

FluentCommand.sln

@@ -1,6 +1,6 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
-# 17
+# Visual Studio Version 17
 VisualStudioVersion = 17.3.32804.467
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "FluentCommand", "src\FluentCommand\FluentCommand.csproj", "{4D5F125D-8DD5-496B-959E-78F55D8BE946}"
@@ -44,6 +44,8 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "FluentCommand.Caching", "sr
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "FluentCommand.Csv", "src\FluentCommand.Csv\FluentCommand.Csv.csproj", "{FE8CBF1C-7231-4D26-A2DB-EDB0E7F29871}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "FluentCommand.Import", "src\FluentCommand.Import\FluentCommand.Import.csproj", "{76F06AA7-8F9E-4A8F-8569-579DC7855618}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -102,6 +104,10 @@ Global
 		{FE8CBF1C-7231-4D26-A2DB-EDB0E7F29871}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{FE8CBF1C-7231-4D26-A2DB-EDB0E7F29871}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{FE8CBF1C-7231-4D26-A2DB-EDB0E7F29871}.Release|Any CPU.Build.0 = Release|Any CPU
+		{76F06AA7-8F9E-4A8F-8569-579DC7855618}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{76F06AA7-8F9E-4A8F-8569-579DC7855618}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{76F06AA7-8F9E-4A8F-8569-579DC7855618}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{76F06AA7-8F9E-4A8F-8569-579DC7855618}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE

dictionary.dic

@@ -0,0 +1,21 @@
+accessor
+app
+awaitable
+cacheable
+clr
+csv
+deconstruct
+deserialization
+deserializer
+deserializing
+inline
+json
+linq
+middleware
+mvc
+nullable
+queryable
+serialization
+serializer
+upsert
+validator

src/FluentCommand.Csv/CsvCommandExtensions.cs

@@ -127,7 +127,7 @@ await dataCommand.ReadAsync(
             commandBehavior: CommandBehavior.SequentialAccess | CommandBehavior.SingleResult,
             cancellationToken: cancellationToken);
 
-        await streamWriter.FlushAsync();
+        await streamWriter.FlushAsync(cancellationToken);
     }
 
 

src/FluentCommand.Import/Converters/TypeJsonConverter.cs

@@ -0,0 +1,52 @@
+using System;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+namespace FluentCommand.Import.Converters;
+
+/// <summary>
+/// A JSON converter for serializing and deserializing <see cref="Type"/> objects using assembly-qualified names.
+/// </summary>
+public class TypeJsonConverter : JsonConverter<Type>
+{
+    /// <summary>
+    /// Reads and converts the JSON string to a <see cref="Type"/> instance.
+    /// </summary>
+    /// <param name="reader">The reader.</param>
+    /// <param name="typeToConvert">The type to convert.</param>
+    /// <param name="options">The serializer options.</param>
+    /// <returns>The <see cref="Type"/> instance, or <c>null</c> if not found.</returns>
+    public override Type? Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
+    {
+        var typeName = reader.GetString();
+        if (string.IsNullOrWhiteSpace(typeName))
+            return null;
+
+        // Try to resolve the type using assembly-qualified name first
+        var type = Type.GetType(typeName, throwOnError: false);
+        if (type != null)
+            return type;
+
+        // Try to resolve by iterating loaded assemblies (for non-assembly-qualified names)
+        foreach (var assembly in AppDomain.CurrentDomain.GetAssemblies())
+        {
+            type = assembly.GetType(typeName, throwOnError: false);
+            if (type != null)
+                return type;
+        }
+
+        return null;
+    }
+
+    /// <summary>
+    /// Writes the <see cref="Type"/> instance as an assembly-qualified name.
+    /// </summary>
+    /// <param name="writer">The writer.</param>
+    /// <param name="value">The value.</param>
+    /// <param name="options">The serializer options.</param>
+    public override void Write(Utf8JsonWriter writer, Type value, JsonSerializerOptions options)
+    {
+        // Use AssemblyQualifiedName for more robust deserialization
+        writer.WriteStringValue(value.AssemblyQualifiedName);
+    }
+}

src/FluentCommand.Import/FieldDefault.cs

@@ -0,0 +1,20 @@
+namespace FluentCommand.Import;
+
+/// <summary>
+/// Specifies the default value behavior for a field during import operations.
+/// </summary>
+public enum FieldDefault
+{
+    /// <summary>
+    /// Use the current user's name as the default value for the field.
+    /// </summary>
+    UserName,
+    /// <summary>
+    /// Use the current UTC date and time as the default value for the field.
+    /// </summary>
+    CurrentDate,
+    /// <summary>
+    /// Use a static, predefined value as the default for the field.
+    /// </summary>
+    Static
+}

src/FluentCommand.Import/FieldDefinition.cs

@@ -0,0 +1,121 @@
+using System.Text.Json.Serialization;
+
+namespace FluentCommand.Import;
+
+/// <summary>
+/// Represents the definition and configuration of a field for import operations.
+/// </summary>
+public class FieldDefinition
+{
+    /// <summary>
+    /// Gets or sets the display name of the field, used for UI or reporting purposes.
+    /// </summary>
+    [JsonPropertyName("displayName")]
+    public string? DisplayName { get; set; }
+
+    /// <summary>
+    /// Gets or sets the unique name of the field.
+    /// </summary>
+    [JsonPropertyName("name")]
+    public string Name { get; set; } = null!;
+
+    /// <summary>
+    /// Gets or sets the data type of the field.
+    /// </summary>
+    [JsonPropertyName("dataType")]
+    [JsonConverter(typeof(Converters.TypeJsonConverter))]
+    public Type? DataType { get; set; }
+
+    /// <summary>
+    /// Gets or sets a value indicating whether this field is a key field.
+    /// </summary>
+    /// <value>
+    /// <c>true</c> if this field is a key; otherwise, <c>false</c>.
+    /// </value>
+    [JsonPropertyName("isKey")]
+    public bool IsKey { get; set; }
+
+    /// <summary>
+    /// Gets or sets a value indicating whether this field can be inserted during import. The default is <c>true</c>.
+    /// </summary>
+    /// <value>
+    /// <c>true</c> if this field can be inserted; otherwise, <c>false</c>.
+    /// </value>
+    [JsonPropertyName("canInsert")]
+    public bool CanInsert { get; set; } = true;
+
+    /// <summary>
+    /// Gets or sets a value indicating whether this field can be updated during import. The default is <c>true</c>.
+    /// </summary>
+    /// <value>
+    /// <c>true</c> if this field can be updated; otherwise, <c>false</c>.
+    /// </value>
+    [JsonPropertyName("canUpdate")]
+    public bool CanUpdate { get; set; } = true;
+
+    /// <summary>
+    /// Gets or sets a value indicating whether this field can be mapped by users during import configuration. The default is <c>true</c>.
+    /// </summary>
+    /// <value>
+    /// <c>true</c> if this field can be mapped; otherwise, <c>false</c>.
+    /// </value>
+    [JsonPropertyName("canMap")]
+    public bool CanMap { get; set; } = true;
+
+    /// <summary>
+    /// Gets or sets a value indicating whether this field is required for import.
+    /// </summary>
+    /// <value>
+    /// <c>true</c> if the field is required; otherwise, <c>false</c>.
+    /// </value>
+    [JsonPropertyName("isRequired")]
+    public bool IsRequired { get; set; }
+
+    /// <summary>
+    /// Gets or sets the default value behavior for the field during import.
+    /// </summary>
+    /// <value>
+    /// The <see cref="FieldDefault"/> option specifying how the default value is determined.
+    /// </value>
+    [JsonPropertyName("default")]
+    public FieldDefault? Default { get; set; }
+
+    /// <summary>
+    /// Gets or sets the static default value for the field, used when <see cref="Default"/> is set to <see cref="FieldDefault.Static"/>.
+    /// </summary>
+    /// <value>
+    /// The static default value for the field.
+    /// </value>
+    [JsonPropertyName("defaultValue")]
+    public object? DefaultValue { get; set; }
+
+    /// <summary>
+    /// Gets or sets the type of the field translator, used to transform or convert field values during import.
+    /// </summary>
+    /// <value>
+    /// The <see cref="Type"/> of the field translator.
+    /// </value>
+    [JsonPropertyName("translator")]
+    [JsonConverter(typeof(Converters.TypeJsonConverter))]
+    public Type? Translator { get; set; }
+
+    /// <summary>
+    /// Gets or sets the list of match expressions used for mapping or validation.
+    /// </summary>
+    /// <value>
+    /// A list of string expressions for matching or validation.
+    /// </value>
+    [JsonPropertyName("expressions")]
+    public List<string> Expressions { get; set; } = [];
+
+    /// <summary>
+    /// Returns a string that represents the current <see cref="FieldDefinition"/> instance.
+    /// </summary>
+    /// <returns>
+    /// A <see cref="string"/> that contains the display name, field name, and data type.
+    /// </returns>
+    public override string ToString()
+    {
+        return $"Display: {DisplayName}, Name: {Name}, DataType: {DataType?.Name}";
+    }
+}