From d706d012a4173b4838960609255a0ef4a93f09b7 Mon Sep 17 00:00:00 2001
From: Charles Iliya Krempeaux <iamreiver@gmail.com>
Date: Tue, 13 Feb 2024 10:21:48 -0800
Subject: [PATCH] initial commits

---
 writeframeimage.go      | 22 +++++++++++++
 writeframeimage_test.go | 68 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 90 insertions(+)
 create mode 100644 writeframeimage.go
 create mode 100644 writeframeimage_test.go

diff --git a/writeframeimage.go b/writeframeimage.go
new file mode 100644
index 0000000..b345ce3
--- /dev/null
+++ b/writeframeimage.go
@@ -0,0 +1,22 @@
+package frameproto
+
+import (
+	"io"
+)
+
+// WriteFrameImage will write the HTML <meta/> element for the Frame-Protocol's (i.e., Farcaster Frame's) "fc:frame:image" name-value pair.
+//
+// For example, this call:
+//
+//	var url string = "https://example.com/images/screen.png"
+//	
+//	frameproto.WriteFrameImage(writer, url)
+//
+// Would write this HTML <meta/> element:
+//
+//	<meta property="fc:frame:image" content="https://example.com/images/screen.png" />
+func WriteFrameImage(writer io.Writer, url string) {
+	const property string = MetaPropertyFrameImage
+	writeMetaPropertyContent(writer, property, url)
+}
+
diff --git a/writeframeimage_test.go b/writeframeimage_test.go
new file mode 100644
index 0000000..45b63f7
--- /dev/null
+++ b/writeframeimage_test.go
@@ -0,0 +1,68 @@
+package frameproto
+
+import (
+	"testing"
+
+	"strings"
+)
+
+func TestWriteFrameImage(t *testing.T) {
+
+	tests := []struct{
+		URL string
+		Expected string
+	}{
+		{
+			URL: "",
+			Expected: `<meta property="fc:frame:image" content="" />`+"\n",
+		},
+
+
+
+		{
+			URL: "something",
+			Expected: `<meta property="fc:frame:image" content="something" />`+"\n",
+		},
+
+
+
+		{
+			URL: "Hello world! 🙂",
+			Expected: `<meta property="fc:frame:image" content="Hello world! 🙂" />`+"\n",
+		},
+
+
+
+		{
+			URL: "https://example.com/path/to/post/to.png",
+			Expected: `<meta property="fc:frame:image" content="https://example.com/path/to/post/to.png" />`+"\n",
+		},
+
+
+
+		{
+			URL: "x-proto:apple/banana/cherry",
+			Expected: `<meta property="fc:frame:image" content="x-proto:apple/banana/cherry" />`+"\n",
+		},
+	}
+
+	for testNumber, test := range tests {
+
+		var buffer strings.Builder
+
+		WriteFrameImage(&buffer, test.URL)
+
+		expected := test.Expected
+		actual   := buffer.String()
+
+		if expected != actual {
+			t.Errorf("For test #%d, the actual written meta-tag is not what was expected." ,testNumber)
+			t.Logf("EXPECTED: %s", expected)
+			t.Logf("ACTUAL:   %s", actual)
+			t.Logf("EXPECTED: %q", expected)
+			t.Logf("ACTUAL:   %q", actual)
+			t.Logf("URL: %q", test.URL)
+			continue
+		}
+	}
+}