@craft-native/ios 0.0.153 → 0.0.154

package/README.md

@@ -602,8 +602,12 @@ await fetch('https://example.com/upload', { method: 'POST', body: form });
 // A file for the share sheet (Save to Files, AirDrop, another app), fetched
 // straight to disk with your headers. Not 2xx: { ok: false, status, body }.
 const gpx = await craft.files.download('https://example.com/route.gpx', { headers: { Authorization: 'Bearer …' } });
-if (gpx.ok) await craft.share({ files: [gpx.path] });
+if (gpx.ok) await craft.share({ files: [gpx] });   // a file, or its path
 await craft.files.remove(gpx.path);               // or leave it: tmp, swept after a day
+// Something the screen made itself (a CSV export): text crosses the bridge
+// once, as it is; bytes go as base64 ({ encoding: 'base64' }).
+const csv = await craft.files.write('health-data.csv', 'date,steps\n…', { type: 'text/csv' });
+await craft.share({ files: [csv] });
 
 // Speech: short spoken cues that duck the person's music instead of stopping
 // it, and play with the silent switch on. Always available (no config flag).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craft-native/ios",
-  "version": "0.0.153",
+  "version": "0.0.154",
   "homepage": "https://github.com/craft-native/craft/tree/main/packages/ios#readme",
   "repository": {
     "type": "git",

package/templates/CraftNativeActions.swift

@@ -171,6 +171,16 @@ enum CraftNativeActions {
         case ("Files", "download"):
             download(requestToken: requestToken, args: args, completion: completion)
             return
+        case ("Files", "write"):
+            // Something the screen made (a CSV export) as a file for the
+            // share sheet; the disk work is off the main thread.
+            let name = args.first as? String ?? ""
+            let data = args.count > 1 ? args[1] : nil
+            let options = args.count > 2 ? args[2] as? [String: Any] ?? [:] : [:]
+            DispatchQueue.global(qos: .userInitiated).async {
+                complete(requestToken, CraftNativeFiles.write(name: name, data: data, options: options), completion)
+            }
+            return
         case ("Files", "remove"):
             sync = .success(CraftNativeFiles.remove(args.first as? String ?? ""))
         case ("Lifecycle", "getState"):

package/templates/CraftNativeFiles.swift

@@ -329,6 +329,40 @@ enum CraftNativeFiles {
         }
     }
 
+    /// What a screen made itself (a CSV export, a route it built) written as
+    /// a file for the share sheet: `data` is text (`encoding: 'utf8'`, the
+    /// default, so a CSV crosses the bridge once and no larger) or base64
+    /// (`encoding: 'base64'`, for bytes). What is already on a server is
+    /// `download`ed instead, straight to disk.
+    static func write(name: String, data: Any?, options: [String: Any]) -> Result<Any, CraftNativeActionError> {
+        guard !name.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty else {
+            return .failure(CraftNativeActionError(code: "INVALID_ARGUMENT", message: "files.write needs a file name"))
+        }
+        guard let text = data as? String else {
+            return .failure(CraftNativeActionError(code: "INVALID_ARGUMENT", message: "files.write needs its contents as a string"))
+        }
+        let bytes: Data
+        switch options["encoding"] as? String ?? "utf8" {
+        case "utf8":
+            bytes = Data(text.utf8)
+        case "base64":
+            guard let decoded = Data(base64Encoded: text.filter { !$0.isWhitespace }) else {
+                return .failure(CraftNativeActionError(code: "INVALID_ARGUMENT", message: "files.write was given base64 it could not read"))
+            }
+            bytes = decoded
+        default:
+            return .failure(CraftNativeActionError(code: "INVALID_ARGUMENT", message: "files.write encoding is 'utf8' or 'base64'"))
+        }
+        let type = (options["type"] as? String).flatMap { $0.isEmpty ? nil : $0 } ?? "application/octet-stream"
+        do {
+            let url = try newFile(named: name)
+            try bytes.write(to: url, options: .atomic)
+            return .success(describe(url, type: type))
+        } catch {
+            return .failure(CraftNativeActionError(code: "WRITE_ERROR", message: error.localizedDescription))
+        }
+    }
+
     /// A refused download: its status and the start of its answer, so the
     /// screen can say what the server said. No file is kept.
     static func refusedDownload(at location: URL?, response: HTTPURLResponse) -> [String: Any] {

package/templates/CraftNativeServices.swift

@@ -527,7 +527,11 @@ enum CraftNativeShare {
         if let title = options["title"] as? String, !title.isEmpty { items.append(title) }
         if let text = options["text"] as? String, !text.isEmpty { items.append(text) }
         if let address = options["url"] as? String, let url = URL(string: address) { items.append(url) }
-        for file in options["files"] as? [String] ?? [] {
+        // A path or file URL, or a file craft.files made (`{ path, name }`).
+        let files = (options["files"] as? [Any] ?? []).compactMap { item -> String? in
+            item as? String ?? (item as? [String: Any])?["path"] as? String
+        }
+        for file in files {
             if let url = URL(string: file), url.isFileURL { items.append(url) }
             else if FileManager.default.fileExists(atPath: file) { items.append(URL(fileURLWithPath: file)) }
         }