From 0bbacdf7d584a059b969ac46791e7015e7f0f35c Mon Sep 17 00:00:00 2001
From: Evis Drenova <evis@usenucleus.cloud>
Date: Mon, 13 Nov 2023 13:05:45 -0800
Subject: [PATCH] last name transformer

---
 docs/docs/transformers/system/last-name.mdx | 66 +++++++++++++++++++++
 docs/sidebars.js                            |  5 ++
 2 files changed, 71 insertions(+)
 create mode 100644 docs/docs/transformers/system/last-name.mdx

diff --git a/docs/docs/transformers/system/last-name.mdx b/docs/docs/transformers/system/last-name.mdx
new file mode 100644
index 0000000000..dff6c417b7
--- /dev/null
+++ b/docs/docs/transformers/system/last-name.mdx
@@ -0,0 +1,66 @@
+---
+title: Last Name
+id: last-name
+hide_title: true
+slug: /transformers/system/last-name
+---
+
+import { TransformerPageHeader } from '@site/src/CustomComponents/TransformerPageHeader.tsx';
+
+import { DocsTable } from '@site/src/CustomComponents/DocsTable.tsx';
+
+<TransformerPageHeader
+  title="Last Name"
+  type="string"
+  apiRef="https://github.com/nucleuscloud/neosync/blob/main/worker/internal/benthos/transformers/lastname.go"
+/>
+
+## Definition
+
+The last name transformer generates a valid last name from a list of predefined last name values. You can see the entire list of last name value [here.](https://github.com/nucleuscloud/neosync/blob/main/worker/internal/benthos/transformers/data-sets/last-names.json).
+
+By default, the last name transformer generates a last name of random length. To preserve the length of the input last name, you can set the `preserveLength` config.
+
+## Configurations
+
+Depending on your validations, you may want to configure the output last name. The last name transformer has the following configurations:
+
+<DocsTable
+  headers={[
+    'Name',
+    'Description',
+    'Default',
+    'Example Input',
+    'Example Output',
+  ]}
+  rowData={[
+    {
+      data: [
+        'PreserveLength',
+        'Preserve Length will ensure that the output last name is the same length as the input last name. The preserveLength config only preserves names up to 12 characters long.',
+        'false',
+        'Hills',
+        'Kunze',
+      ],
+    },
+  ]}
+/>
+
+## Examples
+
+There are several ways you can mix-and-match configurations to get different last name formats. Here are some possible combinations:
+
+<DocsTable
+  headers={['PreserveLength', 'Example Input', 'Example Output']}
+  rowData={[
+    {
+      data: ['false', 'Lei', 'Dach'],
+    },
+    {
+      data: ['true', 'Littel', 'Sporer'],
+    },
+    {
+      data: ['false', 'Johnsonston', 'Rodriguezon'],
+    },
+  ]}
+/>
diff --git a/docs/sidebars.js b/docs/sidebars.js
index 1b0571b48a..0b6d5eeed6 100644
--- a/docs/sidebars.js
+++ b/docs/sidebars.js
@@ -156,6 +156,11 @@ const sidebars = {
           id: 'transformers/system/first-name',
           label: 'First Name',
         },
+        {
+          type: 'doc',
+          id: 'transformers/system/last-name',
+          label: 'Last Name',
+        },
         {
           type: 'doc',
           id: 'transformers/system/full-name',