airtable-ts 1.9.0 → 1.10.0

package/dist/mapping/fieldMappers.js

@@ -24,6 +24,26 @@ const coerce = (airtableType, tsType) => (value) => {
     if (parsedType.nullable && (value === undefined || value === null || (Array.isArray(value) && value.length === 0))) {
         return null;
     }
+    // ISO date strings (e.g. from date lookup/rollup fields) coerced to Unix timestamps
+    if (parsedType.single === 'number' && !parsedType.array && typeof value === 'string' && /^\d{4}-\d{2}-\d{2}/.test(value)) {
+        const date = new Date(value);
+        if (!Number.isNaN(date.getTime())) {
+            return Math.floor(date.getTime() / 1000);
+        }
+    }
+    if (parsedType.single === 'number' && parsedType.array && Array.isArray(value) && value.every((v) => typeof v === 'string' && /^\d{4}-\d{2}-\d{2}/.test(v))) {
+        const timestamps = value.map((v) => {
+            const date = new Date(v);
+            if (Number.isNaN(date.getTime())) {
+                throw new AirtableTsError_1.AirtableTsError({
+                    message: `Invalid date value '${v}' in array from airtable type '${airtableType}'.`,
+                    type: AirtableTsError_1.ErrorType.SCHEMA_VALIDATION,
+                });
+            }
+            return Math.floor(date.getTime() / 1000);
+        });
+        return timestamps;
+    }
     if (parsedType.array && typeof value === parsedType.single) {
         return [value];
     }
@@ -147,13 +167,23 @@ const multipleCollaboratorsMapperPair = {
     },
 };
 const multipleAttachmentsMapperPair = {
-    toAirtable: readonly('multipleAttachments'),
+    toAirtable(value) {
+        if (value === null || value === undefined) {
+            return null;
+        }
+        return value.map((url) => ({ url }));
+    },
     fromAirtable(obj) {
         return obj?.map((v) => ('url' in v && typeof v.url === 'string' ? v.url : null)).filter(Boolean) ?? null;
     },
 };
 const multipleAttachmentsWithMetadataMapperPair = {
-    toAirtable: readonly('multipleAttachments'),
+    toAirtable(value) {
+        if (value === null || value === undefined) {
+            return null;
+        }
+        return value.map((att) => ({ url: att.url, filename: att.filename }));
+    },
     fromAirtable(obj) {
         if (!obj) {
             return null;
@@ -242,7 +272,12 @@ const stringOrNull = {
             fromAirtable: collaboratorMapperPair.fromAirtable,
         },
         multipleAttachments: {
-            toAirtable: readonly('multipleAttachments'),
+            toAirtable(value) {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                return [{ url: value }];
+            },
             fromAirtable: (value) => coerce('multipleAttachments', 'string | null')(multipleAttachmentsMapperPair.fromAirtable(value)),
         },
         multipleSelects: {
@@ -426,6 +461,22 @@ const stringArrayOrNull = {
         },
     },
 };
+const numberArrayOrNull = {
+    'number[] | null': {
+        multipleLookupValues: {
+            toAirtable: readonly('multipleLookupValues'),
+            fromAirtable: coerce('multipleLookupValues', 'number[] | null'),
+        },
+        rollup: {
+            toAirtable: readonly('rollup'),
+            fromAirtable: coerce('rollup', 'number[] | null'),
+        },
+        unknown: {
+            toAirtable: (value) => value,
+            fromAirtable: coerce('unknown', 'number[] | null'),
+        },
+    },
+};
 exports.fieldMappers = {
     ...stringOrNull,
     string: {
@@ -483,13 +534,32 @@ exports.fieldMappers = {
                 }];
         })),
     },
+    ...numberArrayOrNull,
+    'number[]': {
+        ...Object.fromEntries(Object.entries(numberArrayOrNull['number[] | null']).map(([airtableType, nullablePair]) => {
+            return [airtableType, {
+                    toAirtable: nullablePair.toAirtable,
+                    fromAirtable: (value) => nullablePair.fromAirtable(value) ?? [],
+                }];
+        })),
+    },
     'Attachment[] | null': {
         multipleAttachments: multipleAttachmentsWithMetadataMapperPair,
+        // Lookup fields that reference attachment fields return the same flattened structure
+        multipleLookupValues: {
+            toAirtable: readonly('multipleLookupValues'),
+            fromAirtable: (value) => multipleAttachmentsWithMetadataMapperPair.fromAirtable(value),
+        },
     },
     'Attachment[]': {
         multipleAttachments: {
             toAirtable: multipleAttachmentsWithMetadataMapperPair.toAirtable,
             fromAirtable: (value) => multipleAttachmentsWithMetadataMapperPair.fromAirtable(value) ?? [],
         },
+        // Lookup fields that reference attachment fields return the same flattened structure
+        multipleLookupValues: {
+            toAirtable: readonly('multipleLookupValues'),
+            fromAirtable: (value) => multipleAttachmentsWithMetadataMapperPair.fromAirtable(value) ?? [],
+        },
     },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "airtable-ts",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "A type-safe Airtable SDK",
   "license": "MIT",
   "author": "Adam Jones (domdomegg)",