feat: add import contacts command

[ishtails]

• Introduced importContactsCommand to the contacts command module.
• Updated command examples to include usage of the new import feature.
• Added tryParsePropertiesJsonObject utility function for improved JSON parsing, enhancing error handling in parsePropertiesJson function.

---

Summary by cubic

Adds a CSV import command to bulk-create contacts and optionally add them to segments. Tightens CSV/JSON validation for clearer errors and smoother imports.

• New Features

  • New resend contacts import --file <path> [--segment-id <id>...].
  • Requires email/e-mail; optional first_name, last_name, properties (JSON per cell); header normalization.
  • Imports up to 5 rows concurrently; reports successes and failed rows; exits 1 if any fail.
  • RFC 4180 CSV parsing with BOM handling; command registered and examples updated.

• Bug Fixes

  • CSV import now ignores empty rows and fails fast if the email header is missing to prevent invalid records.
  • parsePropertiesJson rejects non-object/invalid JSON with a clear invalid_properties error (via tryParsePropertiesJsonObject).

^{Written for commit fb6b1d0. Summary will update on new commits.}

[cubic-dev-ai]

2 issues found across 4 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="src/commands/contacts/import.ts">

<violation number="1" location="src/commands/contacts/import.ts:70">
P2: CSV validation wrongly depends on the first data row’s email value instead of the header, so a valid import file can be rejected outright.</violation>
</file>

<file name="src/lib/parse-csv.ts">

<violation number="1" location="src/lib/parse-csv.ts:44">
P2: Unquoted `"` characters start quoted parsing mid-field, which can silently shift CSV columns and corrupt imported data.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review, or fix all with cubic.}

[cubic-dev-ai]

P2: Unquoted " characters start quoted parsing mid-field, which can silently shift CSV columns and corrupt imported data.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At src/lib/parse-csv.ts, line 44:

<comment>Unquoted `"` characters start quoted parsing mid-field, which can silently shift CSV columns and corrupt imported data.</comment>

<file context>
@@ -0,0 +1,72 @@
+    }
+
+    switch (c) {
+      case '"':
+        inQuotes = true;
+        i++;
</file context>