feat: truncate constructor option (#143)

closes #142

Author: gr2m

README.md

@@ -248,6 +248,19 @@ function (fieldOptionValue, userValue) {
 }
 ```
 
+</td>
+    </tr>
+    <tr>
+      <th>
+        <code>options.truncate</code>
+      </th>
+      <td>
+        <code>Function</code>
+      </td>
+      <td>
+
+Text field values cannot exceed 1024 characters. By default, the `options.truncate` just returns text as is. We recommend to use an establish truncate function such as [loadsh's `_.truncate()`](https://lodash.com/docs/4.17.15#truncate), as byte size is not the same as text length.
+
 </td>
     </tr>
   </tbody>

api/lib/default-truncate-function.js

@@ -0,0 +1,9 @@
+/**
+ * Maximum text field value length is 1024 bytes. By default, we don't do anything.
+ *
+ * @param {string} text
+ * @returns {string}
+ */
+export function defaultTruncateFunction(text) {
+  return text;
+}

api/lib/get-fields-update-query-and-fields.js

@@ -57,8 +57,7 @@ export function getFieldsUpdateQueryAndFields(state, fields) {
       userName: state.fields[id].userName,
       userValue,
     }))
-    .filter(({ id, name }) => {
-      const field = state.fields[id];
+    .filter(({ name }) => {
       return READ_ONLY_FIELDS.some((readOnlyField) => {
         return state.matchFieldName(
           readOnlyField.toLowerCase(),
@@ -102,30 +101,31 @@ export function getFieldsUpdateQueryAndFields(state, fields) {
           key,
           value: null,
         };
-      } else {
-        const valueOrOption =
-          "optionsByValue" in field
-            ? findFieldOptionIdAndValue(state, field, value)
-            : value;
+      }
 
-        const query = `
+      const valueOrOption =
+        "optionsByValue" in field
+          ? findFieldOptionIdAndValue(state, field, value)
+          : value;
+
+      const query = `
           ${alias}: updateProjectV2ItemFieldValue(input: {projectId: $projectId, itemId: $itemId, fieldId: "${fieldId}", ${toItemFieldValueInput(
+            state,
             field,
             valueOrOption
           )}}) {
             ${queryNodes}
           }
         `;
 
-        return {
-          query,
-          key,
-          value:
-            typeof valueOrOption === "string"
-              ? valueOrOption
-              : valueOrOption.value,
-        };
-      }
+      return {
+        query,
+        key,
+        value:
+          typeof valueOrOption === "string"
+            ? valueOrOption
+            : valueOrOption.value,
+      };
     })
     .filter(Boolean);
 
@@ -145,14 +145,22 @@ export function getFieldsUpdateQueryAndFields(state, fields) {
 }
 
 /**
+ * @param {import("../..").GitHubProjectStateWithFields} state
  * @param {import("../..").ProjectField} field
  * @param {string | {id: string, value: string | undefined}} valueOrOption
  *
  * @returns {string}
  */
-function toItemFieldValueInput(field, valueOrOption) {
+function toItemFieldValueInput(state, field, valueOrOption) {
+  console.log("state.truncate");
+  console.log(state.truncate.toString());
+
   const value =
-    typeof valueOrOption === "string" ? valueOrOption : valueOrOption.id;
+    typeof valueOrOption === "string"
+      ? state.truncate(valueOrOption)
+      : valueOrOption.id;
+
+  console.log({ value });
 
   const valueKey =
     {

index.d.ts

@@ -134,6 +134,7 @@ export type MatchFieldOptionValueFn = (
   fieldOptionValue: string,
   userValue: string,
 ) => boolean;
+export type TruncateFn = (text: string) => string;
 
 export type GitHubProjectOptions<
   TFields extends Record<string, FieldOptions> = {},
@@ -145,6 +146,7 @@ export type GitHubProjectOptions<
       fields?: TFields;
       matchFieldName?: MatchFieldNameFn;
       matchFieldOptionValue?: MatchFieldOptionValueFn;
+      truncate?: TruncateFn;
     }
   | {
       owner: string;
@@ -153,6 +155,7 @@ export type GitHubProjectOptions<
       fields?: TFields;
       matchFieldName?: MatchFieldNameFn;
       matchFieldOptionValue?: MatchFieldOptionValueFn;
+      truncate?: TruncateFn;
     };
 
 export type GitHubProjectItem<
@@ -289,6 +292,7 @@ export type GitHubProjectState =
 type GitHubProjectStateCommon = {
   matchFieldName: MatchFieldNameFn;
   matchFieldOptionValue: MatchFieldOptionValueFn;
+  truncate: TruncateFn;
 };
 type GitHubProjectStateInit = GitHubProjectStateCommon & {
   didLoadFields: false;

index.js

@@ -20,6 +20,7 @@ import { removeItemByContentRepositoryAndNumber } from "./api/items.remove-by-co
 import { getProperties } from "./api/project.getProperties.js";
 
 import { defaultMatchFunction } from "./api/lib/default-match-function.js";
+import { defaultTruncateFunction } from "./api/lib/default-truncate-function.js";
 
 /** @type {import("./").BUILT_IN_FIELDS} */
 export const BUILT_IN_FIELDS = {
@@ -48,6 +49,7 @@ export default class GitHubProject {
       matchFieldName: options.matchFieldName || defaultMatchFunction,
       matchFieldOptionValue:
         options.matchFieldOptionValue || defaultMatchFunction,
+      truncate: options.truncate || defaultTruncateFunction,
     };
 
     // set API