Add JSONL support for tuple write

Author: aaguiarz

README.md

@@ -703,6 +703,7 @@ fga tuple **write** <user> <relation> <object> --store-id=<store-id>
 * `--store-id`: Specifies the store id
 * `--model-id`: Specifies the model id to target (optional)
 * `--file`: Specifies the file name, `json`, `yaml` and `csv` files are supported
+* When using a `json` file, tuples can be provided as an array or newline-delimited (`jsonl`) objects
 * `--max-tuples-per-write`: Max tuples to send in a single write (optional, default=1, or 40 if `--max-rps` is set and this flag is omitted)
 * `--max-parallel-requests`: Max requests to send in parallel (optional, default=4, or `max-rps/5` if `--max-rps` is set and this flag is omitted)
 * `--hide-imported-tuples`: When importing from a file, do not output successfully imported tuples in the command output (optional, default=false)
@@ -772,6 +773,7 @@ If using a `json` file, the format should be:
   }
 ]
 ```
+JSON files can also be provided in JSONL format, with one JSON object per line.
 
 ###### Response
 ```json5

cmd/tuple/testdata/tuples_jsonl.json

@@ -0,0 +1,3 @@
+{"user": "user:anne", "relation": "owner", "object": "folder:product"}
+{"user": "folder:product", "relation": "parent", "object": "folder:product-2021"}
+{"user": "user:beth", "relation": "viewer", "object": "folder:product-2021"}

cmd/tuple/write_test.go

@@ -148,6 +148,27 @@ func TestParseTuplesFileData(t *testing.T) {
 				},
 			},
 		},
+		{
+			name: "it can correctly parse a jsonl file",
+			file: "testdata/tuples_jsonl.json",
+			expectedTuples: []client.ClientTupleKey{
+				{
+					User:     "user:anne",
+					Relation: "owner",
+					Object:   "folder:product",
+				},
+				{
+					User:     "folder:product",
+					Relation: "parent",
+					Object:   "folder:product-2021",
+				},
+				{
+					User:     "user:beth",
+					Relation: "viewer",
+					Object:   "folder:product-2021",
+				},
+			},
+		},
 		{
 			name: "it can correctly parse a yaml file",
 			file: "testdata/tuples.yaml",

internal/tuplefile/read.go

@@ -21,7 +21,15 @@ func ReadTupleFile(fileName string) ([]client.ClientTupleKey, error) {
 	var tuples []client.ClientTupleKey
 
 	switch path.Ext(fileName) {
-	case ".json", ".yaml", ".yml":
+	case ".json":
+		err = yaml.Unmarshal(data, &tuples)
+		if err != nil {
+			err = parseTuplesFromJSONL(data, &tuples)
+		}
+		if err == nil && len(tuples) == 0 {
+			err = clierrors.EmptyTuplesFileError("json")
+		}
+	case ".yaml", ".yml":
 		err = yaml.Unmarshal(data, &tuples)
 		if err == nil && len(tuples) == 0 {
 			err = clierrors.EmptyTuplesFileError(strings.TrimPrefix(path.Ext(fileName), "."))
@@ -38,3 +46,26 @@ func ReadTupleFile(fileName string) ([]client.ClientTupleKey, error) {
 
 	return tuples, nil
 }
+
+func parseTuplesFromJSONL(data []byte, tuples *[]client.ClientTupleKey) error {
+	lines := strings.Split(strings.TrimSpace(string(data)), "\n")
+	for index, line := range lines {
+		trimmed := strings.TrimSpace(line)
+		if trimmed == "" {
+			continue
+		}
+
+		var tuple client.ClientTupleKey
+		if err := yaml.Unmarshal([]byte(trimmed), &tuple); err != nil {
+			return fmt.Errorf("failed to parse tuple on line %d: %w", index+1, err)
+		}
+
+		*tuples = append(*tuples, tuple)
+	}
+
+	if len(*tuples) == 0 {
+		return clierrors.EmptyTuplesFileError("json")
+	}
+
+	return nil
+}