Unify sharing codec and wire iOS KMP actuals

composeApp/src/commonMain/kotlin/com/example/casera/models/CaseraShareCodec.kt

@@ -0,0 +1,70 @@
+package com.example.casera.models
+
+import kotlinx.serialization.encodeToString
+import kotlinx.serialization.json.Json
+
+/**
+ * Shared encoder/decoder for `.casera` payloads across Android and iOS.
+ *
+ * This keeps package JSON shape in one place while each platform owns
+ * native share-sheet presentation details.
+ */
+object CaseraShareCodec {
+    private val json = Json {
+        prettyPrint = true
+        ignoreUnknownKeys = true
+        encodeDefaults = true
+    }
+
+    fun encodeContractorPackage(contractor: Contractor, exportedBy: String? = null): String {
+        return encodeSharedContractor(contractor.toSharedContractor(exportedBy))
+    }
+
+    fun encodeSharedContractor(sharedContractor: SharedContractor): String {
+        return json.encodeToString(SharedContractor.serializer(), sharedContractor)
+    }
+
+    fun encodeSharedResidence(sharedResidence: SharedResidence): String {
+        return json.encodeToString(SharedResidence.serializer(), sharedResidence)
+    }
+
+    fun decodeSharedContractorOrNull(jsonContent: String): SharedContractor? {
+        return try {
+            json.decodeFromString(SharedContractor.serializer(), jsonContent)
+        } catch (_: Exception) {
+            null
+        }
+    }
+
+    fun decodeSharedResidenceOrNull(jsonContent: String): SharedResidence? {
+        return try {
+            json.decodeFromString(SharedResidence.serializer(), jsonContent)
+        } catch (_: Exception) {
+            null
+        }
+    }
+
+    fun createContractorImportRequestOrNull(
+        jsonContent: String,
+        availableSpecialties: List<ContractorSpecialty>
+    ): ContractorCreateRequest? {
+        val shared = decodeSharedContractorOrNull(jsonContent) ?: return null
+        val specialtyIds = shared.resolveSpecialtyIds(availableSpecialties)
+        return shared.toCreateRequest(specialtyIds)
+    }
+
+    fun extractResidenceShareCodeOrNull(jsonContent: String): String? {
+        return decodeSharedResidenceOrNull(jsonContent)?.shareCode
+    }
+
+    /**
+     * Build a filesystem-safe package filename with `.casera` extension.
+     */
+    fun safeShareFileName(displayName: String): String {
+        val safeName = displayName
+            .replace(" ", "_")
+            .replace("/", "-")
+            .take(50)
+        return "$safeName.casera"
+    }
+}

composeApp/src/commonMain/kotlin/com/example/casera/network/DocumentApi.kt

@@ -15,6 +15,8 @@ class DocumentApi(private val client: HttpClient = ApiClient.httpClient) {
         token: String,
         residenceId: Int? = null,
         documentType: String? = null,
+        // Deprecated filter args kept for source compatibility with iOS wrappers.
+        // Backend/OpenAPI currently support: residence, document_type, is_active, expiring_soon, search.
         category: String? = null,
         contractorId: Int? = null,
         isActive: Boolean? = null,
@@ -27,11 +29,8 @@ class DocumentApi(private val client: HttpClient = ApiClient.httpClient) {
                 header("Authorization", "Token $token")
                 residenceId?.let { parameter("residence", it) }
                 documentType?.let { parameter("document_type", it) }
-                category?.let { parameter("category", it) }
-                contractorId?.let { parameter("contractor", it) }
                 isActive?.let { parameter("is_active", it) }
                 expiringSoon?.let { parameter("expiring_soon", it) }
-                tags?.let { parameter("tags", it) }
                 search?.let { parameter("search", it) }
             }