import fynk from "../../fynk.app.mjs";
import { ConfigurationError } from "@pipedream/platform";
export default {
key: "fynk-update-contract-metadata",
name: "Update Contract Metadata",
description: "Update metadata values or dynamic fields associated with a contract in Fynk. [See the documentation](https://app.fynk.com/v1/docs#/operations/v1.documents.metadata-values.update).",
version: "0.0.1",
annotations: {
destructiveHint: true,
openWorldHint: true,
readOnlyHint: false,
},
type: "action",
props: {
fynk,
documentUuid: {
propDefinition: [
fynk,
"documentUuid",
],
},
metadataValueUuid: {
propDefinition: [
fynk,
"metadataValueUuid",
(c) => ({
documentUuid: c.documentUuid,
}),
],
},
value: {
type: "string",
label: "Value",
description: "The new value for the metadata field. The format depends on the metadata's `value_type`. [See the documentation](https://app.fynk.com/v1/docs#/operations/v1.documents.metadata-values.store#value-format) for format details.",
},
},
methods: {
formatMetadataValue(rawValue, metadata) {
const valueType = metadata.value_type;
switch (valueType) {
case "email": {
const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
const emailStr = String(rawValue).trim();
if (!emailRegex.test(emailStr)) {
throw new ConfigurationError(`Invalid email format: ${rawValue}`);
}
return emailStr;
}
case "number": {
const num = typeof rawValue === "string"
? parseFloat(rawValue)
: Number(rawValue);
if (isNaN(num)) {
throw new ConfigurationError(`Invalid number: ${rawValue}`);
}
return num;
}
case "currency": {
const currencyStr = String(rawValue).trim();
const parts = currencyStr.split(";");
if (parts.length !== 2) {
throw new ConfigurationError(`Invalid currency format. Expected "CURRENCY;AMOUNT", got: ${rawValue}`);
}
const [
currency,
amount,
] = parts;
const numAmount = parseFloat(amount);
if (isNaN(numAmount)) {
throw new ConfigurationError(`Invalid currency amount: ${amount}`);
}
if (metadata.settings?.currencies && !metadata.settings.currencies.includes(currency)) {
throw new ConfigurationError(`Invalid currency code. Allowed: ${metadata.settings.currencies.join(", ")}, got: ${currency}`);
}
return `${currency};${numAmount}`;
}
case "currency_duration": {
const currencyDurationStr = String(rawValue).trim();
const parts = currencyDurationStr.split(";");
if (parts.length !== 3) {
throw new ConfigurationError(`Invalid currency_duration format. Expected "CURRENCY;AMOUNT;PERIOD", got: ${rawValue}`);
}
const [
currency,
amount,
period,
] = parts;
const numAmount = parseFloat(amount);
if (isNaN(numAmount)) {
throw new ConfigurationError(`Invalid currency amount: ${amount}`);
}
if (period !== "monthly" && period !== "yearly") {
throw new ConfigurationError(`Invalid period. Must be "monthly" or "yearly", got: ${period}`);
}
if (metadata.settings?.currencies && !metadata.settings.currencies.includes(currency)) {
throw new ConfigurationError(`Invalid currency code. Allowed: ${metadata.settings.currencies.join(", ")}, got: ${currency}`);
}
return `${currency};${numAmount};${period}`;
}
case "select": {
const selectStr = String(rawValue).trim();
if (metadata.select_values && !metadata.select_values.includes(selectStr)) {
throw new ConfigurationError(`Invalid select value. Allowed: ${metadata.select_values.join(", ")}, got: ${selectStr}`);
}
return selectStr;
}
case "date": {
const dateStr = String(rawValue).trim();
const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
if (!dateRegex.test(dateStr)) {
throw new ConfigurationError(`Invalid date format. Expected "YYYY-MM-DD", got: ${rawValue}`);
}
const date = new Date(dateStr);
if (isNaN(date.getTime())) {
throw new ConfigurationError(`Invalid date: ${rawValue}`);
}
return dateStr;
}
case "bool": {
if (typeof rawValue === "boolean") {
return rawValue;
}
const str = String(rawValue).toLowerCase()
.trim();
if (str === "true" || str === "1" || str === "yes") {
return true;
}
if (str === "false" || str === "0" || str === "no") {
return false;
}
throw new ConfigurationError(`Invalid boolean value. Expected true/false, got: ${rawValue}`);
}
case "duration": {
const durationStr = String(rawValue).trim();
const durationRegex = /^P(\d+D)?(\d+W)?(T(\d+H)?(\d+M)?(\d+S)?)?$/;
if (!durationRegex.test(durationStr)) {
throw new ConfigurationError(`Invalid duration format. Expected ISO 8601 duration (e.g., "P6D", "P2W", "PT12H"), got: ${rawValue}`);
}
return durationStr;
}
case "text": {
const textStr = String(rawValue);
if (textStr.length > 4096) {
throw new ConfigurationError("Text exceeds maximum length of 4096 characters");
}
return textStr;
}
case "textarea": {
const textareaStr = String(rawValue);
if (textareaStr.length > 4096) {
throw new ConfigurationError("Textarea exceeds maximum length of 4096 characters");
}
return textareaStr;
}
case "timestamp": {
const timestampStr = String(rawValue).trim();
const timestamp = new Date(timestampStr);
if (isNaN(timestamp.getTime())) {
throw new ConfigurationError(`Invalid timestamp format. Expected ISO 8601 format (e.g., "2025-06-02T14:30:00+00:00"), got: ${rawValue}`);
}
return timestampStr;
}
case "clause": {
if (typeof rawValue === "boolean") {
return rawValue;
}
const str = String(rawValue).toLowerCase()
.trim();
if (str === "true" || str === "1" || str === "yes") {
return true;
}
if (str === "false" || str === "0" || str === "no") {
return false;
}
throw new ConfigurationError(`Invalid clause value. Expected true/false, got: ${rawValue}`);
}
case "id":
case "uuid": {
return String(rawValue).trim();
}
default:
return rawValue;
}
},
},
async run({ $ }) {
const {
documentUuid,
metadataValueUuid,
value,
} = this;
const metadataResponse = await this.fynk.listDocumentMetadataValues({
$,
documentUuid,
});
const metadataValue = metadataResponse.data?.find(
(mv) => mv.uuid === metadataValueUuid,
);
if (!metadataValue) {
throw new ConfigurationError(`Metadata value with UUID ${metadataValueUuid} not found`);
}
if (!metadataValue.metadata) {
throw new ConfigurationError(`Metadata definition not found for metadata value ${metadataValueUuid}`);
}
const formattedValue = this.formatMetadataValue(value, metadataValue.metadata);
const response = await this.fynk.updateDocumentMetadataValue({
$,
documentUuid,
metadataValueUuid,
data: {
value: formattedValue,
},
});
$.export("$summary", `Successfully updated metadata value for contract ${documentUuid}`);
return response;
},
};
Chase Roberts@chsrbrts@benedictevans If you haven’t used @pipedream yet, then you haven’t lived.
✨Ellie Day✨@heyelliedayEvaluation update: @pipedream has quite literally been a dream to work with! I’m excited to leverage this tool for all the various workflows I need to write. I’m currently at 11k invocations a day from the initial workflows I’ve written in the past couple weeks.
Michael Braedley@MBraedleyUpdate: I got it working properly, and it's working so well that I'm dropping IFTTT. @pipedream can do everything that IFTTT basic can, and most (if not all things) IFTTT pro can for free or at a reasonable price if you need it. I am recommending it for basically any power user.
Thomas Cutting@mrthomascuttingWant quick+dirty integrations for a serverless workflow - @pipedream is my new go-to 😃
Matthew Roberts@mattdotrobertsday 013 - finally hit node js. This is the secret sauce of taking #nocode projects that one step further. Pumped about getting deeper into @pipedream now
Kenneth Auchenberg 💭@auchenbergYahoo Pipes is back! Kinda 😍 @pipedream
Raymond Camden 🥑@raymondcamdenAwesome video by the @pipedream folks showing real time twitter sentiment analysis integrated with Google Sheets. This is where Pipedream *really* shines, connecting systems together in easy workflows.
Nacho Caballero@nachocaballeroI couldn't recommend @pipedream more. It's an amazing service to integrate different APIs. Much more powerful than Zapier and more user-friendly than AWS Lambda. I'm very proud to wear this t-shirt #NoCode
Jason Snow@jyksnwDeveloped a working prototype environmental sensor IoT solution with @particle Photon, @pipedream, and @MongoDB with full graphing and alerting in less than a day! All amazing technology, will def. be exploring these more.
Steven Terrana@steven_terrana@burgwyn you've inspired me to finally set up my own blog. I'll make sure my first blog post explains the tech behind the setup. think @obsdmd + @GatsbyJS + @pipedream.
🚄 James Augeri, PhD@DotDotJamesWant to low-code your back end, need more horsepower than @Bubble / @KnackHQ, or just miss Yahoo! Pipes? Check out @PipeDream
Sébastien Chopin@AtinuxGitHub issues should be like @linear_app for maintainers. Looking forward more integrations with GH actions or tools like @pipedream 👀
Raul@raul_predescuIf you're a dev and not using @pipedream, you're missing out. Been using it for months, daily. FREE for devs. Plenty of integrations and good limits. Absolutely love it.
Bruno Skvorc@bitfallsSo @pipedream is pretty amazing. In 3 minutes I just made a flow which adds @rickastley's Never Gonna Give You Up to my @spotify playlist whenever a new pull request arrives in an old repo of mine.
Zach Lanich@ZachLanichUm, wow 🤯 @pipedream
Steven Bell@bellontechI just used @pipedream to build a Shopify App. Wow, they make small backed tasks easy.
Jay Hack 🎩🇺🇸@_jayhack_Very impressed with this bad boi - it reminds me of a @PalantirTech internal tool, but geared towards integrations instead of data analysis and far more customizable. Great expectations here 🚀🤩
Tree Sturgeon 🔥🚴♂️🌳@philsturgeonFor context this is day 2 of a really challenging and stupid migration from Notion to @airtable with disparate/missing data. It's going better than expected and thanks to @pipedream I don't have to bother the iOS dev to add W3W.