create-flowmo 1.0.0

package/skills/outsystems-logic/references/builtin-functions.md

@@ -0,0 +1,144 @@
+# OutSystems Built-in Functions Reference
+
+Complete reference for all built-in functions available in OutSystems expressions.
+
+## Data Conversion
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `BooleanToInteger(b)` | Boolean → Integer (True=1, False=0) | `BooleanToInteger(IsActive)` → `1` |
+| `BooleanToText(b)` | Boolean → "True" / "False" | `BooleanToText(True)` → `"True"` |
+| `DateTimeToDate(dt)` | DateTime → Date (strips time) | `DateTimeToDate(CurrDateTime())` |
+| `DateTimeToText(dt)` | DateTime → Text (default format) | `DateTimeToText(CurrDateTime())` |
+| `DateTimeToTime(dt)` | DateTime → Time (strips date) | `DateTimeToTime(CurrDateTime())` |
+| `DateToDateTime(d)` | Date → DateTime (time = 00:00:00) | `DateToDateTime(CurrDate())` |
+| `DateToText(d)` | Date → Text | `DateToText(CurrDate())` |
+| `DecimalToBoolean(d)` | Decimal → Boolean (0=False, else True) | `DecimalToBoolean(1.5)` → `True` |
+| `DecimalToInteger(d)` | Decimal → Integer (truncates) | `DecimalToInteger(3.7)` → `3` |
+| `DecimalToLongInteger(d)` | Decimal → Long Integer | `DecimalToLongInteger(3.7)` → `3` |
+| `DecimalToText(d)` | Decimal → Text | `DecimalToText(3.14)` → `"3.14"` |
+| `IntegerToBoolean(i)` | Integer → Boolean (0=False) | `IntegerToBoolean(1)` → `True` |
+| `IntegerToDecimal(i)` | Integer → Decimal | `IntegerToDecimal(5)` → `5.0` |
+| `IntegerToText(i)` | Integer → Text | `IntegerToText(42)` → `"42"` |
+| `LongIntegerToInteger(l)` | Long Integer → Integer (may overflow) | `LongIntegerToInteger(100)` |
+| `LongIntegerToText(l)` | Long Integer → Text | `LongIntegerToText(100)` → `"100"` |
+| `NullDate()` | Returns null date (#1900-01-01#) | `If(Date = NullDate(), ...)` |
+| `NullIdentifier()` | Returns null identifier for any Id type | `CustomerId = NullIdentifier()` |
+| `NullObject()` | Returns null object reference | `NullObject()` |
+| `NullTextIdentifier()` | Returns null text identifier ("") | `NullTextIdentifier()` |
+| `TextToDate(t)` | Text → Date | `TextToDate("2024-01-15")` |
+| `TextToDateTime(t)` | Text → DateTime | `TextToDateTime("2024-01-15 14:30:00")` |
+| `TextToDecimal(t)` | Text → Decimal | `TextToDecimal("3.14")` → `3.14` |
+| `TextToIdentifier(t)` | Text → Identifier | `TextToIdentifier("abc-123")` |
+| `TextToInteger(t)` | Text → Integer | `TextToInteger("42")` → `42` |
+| `TextToLongInteger(t)` | Text → Long Integer | `TextToLongInteger("1000000")` |
+| `TextToTime(t)` | Text → Time | `TextToTime("14:30:00")` |
+| `TimeToText(t)` | Time → Text | `TimeToText(CurrTime())` |
+| `ToObject(x)` | Any → Object | `ToObject(MyRecord)` |
+
+## Date and Time
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `CurrDate()` | Current date (server) | `CurrDate()` |
+| `CurrDateTime()` | Current date+time (server) | `CurrDateTime()` |
+| `CurrTime()` | Current time (server) | `CurrTime()` |
+| `Year(d)` | Extract year | `Year(CurrDate())` → `2024` |
+| `Month(d)` | Extract month (1-12) | `Month(CurrDate())` → `6` |
+| `Day(d)` | Extract day (1-31) | `Day(CurrDate())` → `15` |
+| `Hour(t)` | Extract hour (0-23) | `Hour(CurrTime())` → `14` |
+| `Minute(t)` | Extract minute (0-59) | `Minute(CurrTime())` → `30` |
+| `Second(t)` | Extract second (0-59) | `Second(CurrTime())` → `45` |
+| `AddDays(d, n)` | Add n days to date | `AddDays(CurrDate(), 7)` |
+| `AddHours(dt, n)` | Add n hours to datetime | `AddHours(CurrDateTime(), 2)` |
+| `AddMinutes(dt, n)` | Add n minutes to datetime | `AddMinutes(CurrDateTime(), 30)` |
+| `AddMonths(d, n)` | Add n months | `AddMonths(CurrDate(), 3)` |
+| `AddSeconds(dt, n)` | Add n seconds | `AddSeconds(CurrDateTime(), 60)` |
+| `AddYears(d, n)` | Add n years | `AddYears(CurrDate(), 1)` |
+| `DiffDays(d1, d2)` | Difference in days | `DiffDays(StartDate, EndDate)` |
+| `DiffHours(dt1, dt2)` | Difference in hours | `DiffHours(Start, End)` |
+| `DiffMinutes(dt1, dt2)` | Difference in minutes | `DiffMinutes(Start, End)` |
+| `DiffMonths(d1, d2)` | Difference in months | `DiffMonths(Start, End)` |
+| `DiffSeconds(dt1, dt2)` | Difference in seconds | `DiffSeconds(Start, End)` |
+| `DiffYears(d1, d2)` | Difference in years | `DiffYears(Start, End)` |
+| `BuildDateTime(d, t)` | Combine Date + Time → DateTime | `BuildDateTime(CurrDate(), CurrTime())` |
+| `NewDate(y, m, d)` | Construct a Date | `NewDate(2024, 12, 25)` |
+| `NewDateTime(y, m, d, h, mi, s)` | Construct a DateTime | `NewDateTime(2024, 12, 25, 0, 0, 0)` |
+| `NewTime(h, m, s)` | Construct a Time | `NewTime(14, 30, 0)` |
+| `DayOfWeek(d)` | Day of week (0=Sun, 6=Sat) | `DayOfWeek(CurrDate())` |
+
+## Math
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `Abs(n)` | Absolute value | `Abs(-5)` → `5` |
+| `Ceiling(d)` | Round up | `Ceiling(3.2)` → `4` |
+| `Floor(d)` | Round down | `Floor(3.8)` → `3` |
+| `Round(d, decimals)` | Round to N decimals | `Round(3.456, 2)` → `3.46` |
+| `Trunc(d)` | Truncate decimal | `Trunc(3.9)` → `3` |
+| `Max(a, b)` | Larger value | `Max(10, 20)` → `20` |
+| `Min(a, b)` | Smaller value | `Min(10, 20)` → `10` |
+| `Power(base, exp)` | Exponent | `Power(2, 3)` → `8` |
+| `Sqrt(n)` | Square root | `Sqrt(16)` → `4` |
+| `Log(n)` | Natural log | `Log(2.718)` → `1.0` |
+| `Mod(a, b)` | Modulo/remainder | `Mod(10, 3)` → `1` |
+
+## Text
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `Chr(n)` | ASCII code → character | `Chr(65)` → `"A"` |
+| `Concat(t1, t2)` | Concatenate two texts | `Concat("Hello", " World")` |
+| `Index(t, search, start)` | Find position (0-based) | `Index("Hello", "ll", 0)` → `2` |
+| `Length(t)` | String length | `Length("Hello")` → `5` |
+| `NewLine()` | Line break character | `"Line1" + NewLine() + "Line2"` |
+| `Replace(text, search, replace)` | Replace occurrences | `Replace("Hello", "l", "r")` → `"Herro"` |
+| `Substr(t, start, length)` | Substring (0-based start) | `Substr("Hello", 0, 3)` → `"Hel"` |
+| `ToLower(t)` | Lowercase | `ToLower("HELLO")` → `"hello"` |
+| `ToUpper(t)` | Uppercase | `ToUpper("hello")` → `"HELLO"` |
+| `Trim(t)` | Remove leading/trailing whitespace | `Trim("  hi  ")` → `"hi"` |
+| `TrimStart(t)` | Remove leading whitespace | `TrimStart("  hi")` → `"hi"` |
+| `TrimEnd(t)` | Remove trailing whitespace | `TrimEnd("hi  ")` → `"hi"` |
+
+## Format
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `FormatCurrency(value, symbol, decimals, decSep, thousSep)` | Format as currency | `FormatCurrency(1234.5, "$", 2, ".", ",")` → `"$1,234.50"` |
+| `FormatDateTime(dt, format)` | Format datetime | `FormatDateTime(CurrDateTime(), "yyyy-MM-dd")` |
+| `FormatDecimal(d, decimals, decSep, thousSep)` | Format decimal | `FormatDecimal(1234.5, 2, ".", ",")` → `"1,234.50"` |
+| `FormatPercent(d, decimals)` | Format as percentage | `FormatPercent(0.85, 1)` → `"85.0%"` |
+| `FormatPhoneNumber(phone, locale)` | Format phone number | `FormatPhoneNumber("+1234567890", "en-US")` |
+| `FormatText(t, format)` | Apply text format | `FormatText("hello", "uppercase")` |
+
+## Email Validation
+
+| Function | Description |
+|----------|-------------|
+| `EmailAddressValidate(email)` | Returns True if valid email format |
+
+## URL
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `EncodeURL(t)` | URL-encode text | `EncodeURL("hello world")` → `"hello%20world"` |
+| `DecodeURL(t)` | URL-decode text | `DecodeURL("hello%20world")` → `"hello world"` |
+| `GetBookmarkableURL()` | Get current screen URL | `GetBookmarkableURL()` |
+
+## Organization
+
+| Function | Description |
+|----------|-------------|
+| `GetCurrentLocale()` | Returns the current user's locale (e.g., "en-US") |
+| `GetAppName()` | Returns the current application name |
+| `GetOwnerURLPath()` | Returns the base URL path of the application |
+| `GetExceptionURL()` | Returns the URL of the exception handler page |
+
+## Roles
+
+| Function | Description | Example |
+|----------|-------------|---------|
+| `CheckRole(RoleName)` | Check if current user has role | `CheckRole(Entities.Role.Admin)` |
+| `Check<RoleName>Role()` | Auto-generated per role | `CheckAdminRole()` |
+| `GetUserId()` | Current logged-in user's ID | `GetUserId()` |
+| `GetUserName()` | Current user's username | Return type: Text |

package/skills/outsystems-logic/references/libraries.md

@@ -0,0 +1,169 @@
+# OutSystems Libraries Reference
+
+System libraries that provide additional utility functions. Import these modules to use their functions in Server Actions and expressions.
+
+## BinaryData
+
+Functions for working with binary/blob data.
+
+| Function | Description |
+|----------|-------------|
+| `BinaryDataToText(data, encoding)` | Convert binary to text with specified encoding (UTF-8, ASCII, etc.) |
+| `TextToBinaryData(text, encoding)` | Convert text to binary data |
+| `BinaryDataSize(data)` | Returns the size in bytes |
+| `BinaryToBase64(data)` | Encode binary as Base64 string |
+| `Base64ToBinary(text)` | Decode Base64 string to binary |
+| `Compare(data1, data2)` | Compare two binary values (returns 0 if equal) |
+| `ConvertEncoding(data, srcEncoding, dstEncoding)` | Convert between text encodings |
+
+## DateTime
+
+Extended date/time manipulation beyond built-in functions.
+
+| Function | Description |
+|----------|-------------|
+| `DiffWeeks(d1, d2)` | Difference in weeks |
+| `IsLeapYear(year)` | Check if year is a leap year |
+| `DaysInMonth(year, month)` | Number of days in a month |
+| `FirstDayOfWeek(d)` | Get the first day (Monday) of the week containing date |
+| `LastDayOfMonth(d)` | Get the last day of the month |
+| `StartOfDay(dt)` | DateTime with time set to 00:00:00 |
+| `EndOfDay(dt)` | DateTime with time set to 23:59:59 |
+
+## HTTP
+
+HTTP request and response handling for REST and web interactions.
+
+| Function | Description |
+|----------|-------------|
+| `GetRequestHeader(name)` | Get value of an HTTP request header |
+| `SetRequestHeader(name, value)` | Set an HTTP request header |
+| `GetResponseHeader(name)` | Get value of an HTTP response header |
+| `GetRequestContent()` | Get the raw request body |
+| `GetRawURL()` | Get the full request URL |
+| `GetFormValue(name)` | Get a form field value from POST data |
+| `GetURLMethod()` | Get the HTTP method (GET, POST, etc.) |
+| `SetStatusCode(code)` | Set the HTTP response status code |
+| `SetCookie(name, value, expires)` | Set an HTTP cookie |
+| `GetCookie(name)` | Get a cookie value |
+| `URLEncode(text)` | URL-encode a text value |
+| `URLDecode(text)` | URL-decode a text value |
+
+## Sanitization
+
+Security-related functions for preventing XSS, SQL injection, and other attacks.
+
+| Function | Description |
+|----------|-------------|
+| `SanitizeHtml(html)` | Remove dangerous HTML tags/attributes, keep safe formatting |
+| `VerifyJavascriptLiteral(text)` | Escape text for safe use in JavaScript strings |
+| `BuildSafe_InClauseIntegerList(idList)` | Safely build SQL IN clause from integer list |
+| `BuildSafe_InClauseTextList(textList)` | Safely build SQL IN clause from text list |
+
+## Security
+
+Cryptographic and security utility functions.
+
+| Function | Description |
+|----------|-------------|
+| `GenerateSecurePassword()` | Generate a cryptographically secure random password |
+| `ComputeMAC(data, key, algorithm)` | Compute Message Authentication Code (HMAC) |
+| `CryptoEncrypt(plainText, key)` | Encrypt text using AES |
+| `CryptoDecrypt(cipherText, key)` | Decrypt AES-encrypted text |
+| `ComputeHash(data, algorithm)` | Compute hash (MD5, SHA-256, SHA-512) |
+| `JWT_CreateToken(header, payload, key)` | Create a JSON Web Token (ODC) |
+| `JWT_VerifyToken(token, key)` | Verify and decode a JWT (ODC) |
+
+## Text
+
+Extended text manipulation functions.
+
+| Function | Description |
+|----------|-------------|
+| `Format(text, args)` | String formatting with placeholders |
+| `Join(list, separator)` | Join list elements into a single text |
+| `Split(text, separator)` | Split text into a list |
+| `PadLeft(text, totalWidth, paddingChar)` | Pad text on the left |
+| `PadRight(text, totalWidth, paddingChar)` | Pad text on the right |
+| `Regex_Replace(text, pattern, replacement)` | Replace using regex |
+| `Regex_Search(text, pattern)` | Search for regex match |
+| `Regex_IsMatch(text, pattern)` | Check if regex matches |
+| `StringBuilder_Create()` | Create a string builder for efficient concatenation |
+| `StringBuilder_Append(sb, text)` | Append text to string builder |
+| `StringBuilder_ToString(sb)` | Get final text from string builder |
+| `String_LastIndexOf(text, search)` | Find last occurrence position |
+| `String_StartsWith(text, prefix)` | Check if text starts with prefix |
+| `String_EndsWith(text, suffix)` | Check if text ends with suffix |
+| `String_Contains(text, search)` | Check if text contains substring |
+
+## TextDictionary
+
+Key-value pair storage (dictionary/map data structure).
+
+| Function | Description |
+|----------|-------------|
+| `TextDictionary_Create()` | Create a new dictionary |
+| `TextDictionary_Set(dict, key, value)` | Set a key-value pair |
+| `TextDictionary_Get(dict, key)` | Get value by key |
+| `TextDictionary_Remove(dict, key)` | Remove a key |
+| `TextDictionary_ContainsKey(dict, key)` | Check if key exists |
+| `TextDictionary_Count(dict)` | Number of entries |
+| `TextDictionary_Keys(dict)` | Get all keys as a list |
+| `TextDictionary_Values(dict)` | Get all values as a list |
+
+## URL
+
+URL parsing and construction.
+
+| Function | Description |
+|----------|-------------|
+| `GetRelativeURL(absoluteURL)` | Extract the relative path from an absolute URL |
+| `GetAbsoluteURL(relativeURL)` | Construct absolute URL from relative path |
+| `GetURLHost(url)` | Extract the host from a URL |
+| `GetURLProtocol(url)` | Extract the protocol (http/https) |
+| `GetURLPath(url)` | Extract the path component |
+| `GetURLQueryString(url)` | Extract the query string |
+| `AddURLParameter(url, name, value)` | Append a query parameter |
+
+## XML
+
+XML parsing and generation.
+
+| Function | Description |
+|----------|-------------|
+| `XmlDocument_Load(xml)` | Parse XML string into document |
+| `XmlDocument_GetRootNode(doc)` | Get the root element |
+| `XmlNode_GetChildNodes(node)` | Get child nodes |
+| `XmlNode_GetAttribute(node, name)` | Get attribute value |
+| `XmlNode_GetInnerText(node)` | Get text content |
+| `XmlNode_SelectNodes(node, xpath)` | Query nodes by XPath |
+| `XmlDocument_Save(doc)` | Convert document back to XML string |
+| `Xsl_Transform(xml, xslt)` | Apply XSLT transformation |
+
+## Zip
+
+File compression and decompression.
+
+| Function | Description |
+|----------|-------------|
+| `Zip_Create()` | Create a new zip archive |
+| `Zip_AddFile(zip, fileName, content)` | Add a file to the archive |
+| `Zip_GetBinary(zip)` | Get the zip as binary data |
+| `Zip_Open(binaryData)` | Open a zip from binary data |
+| `Zip_GetFileList(zip)` | List files in the archive |
+| `Zip_GetFile(zip, fileName)` | Extract a specific file |
+
+## Math (Extended)
+
+Additional math functions beyond the built-in set.
+
+| Function | Description |
+|----------|-------------|
+| `Random(min, max)` | Generate random integer in range |
+| `PI()` | Returns π (3.14159...) |
+| `Sin(angle)` | Sine |
+| `Cos(angle)` | Cosine |
+| `Tan(angle)` | Tangent |
+| `Asin(value)` | Arc sine |
+| `Acos(value)` | Arc cosine |
+| `Atan(value)` | Arc tangent |

package/skills/outsystems-logic/references/system-actions.md

@@ -0,0 +1,221 @@
+# OutSystems System Actions Reference
+
+System-provided server actions for authentication, user management, and session handling.
+
+## Authentication Actions
+
+### User_Login
+Log in a user with username and password.
+
+```
+User_Login(Username, Password, PersistLogin)
+  Input: Username (Text) — The user's username or email
+  Input: Password (Text) — The user's password
+  Input: PersistLogin (Boolean) — If True, creates a persistent cookie
+  Output: (none — sets session automatically)
+  Throws: Security Exception if credentials are invalid
+```
+
+**Usage pattern:**
+```
+ServerAction: DoLogin
+  Input: Username (Text), Password (Text), RememberMe (Boolean)
+
+  Try
+    User_Login(Username, Password, RememberMe)
+    // Redirect to home screen
+  Catch SecurityException
+    FeedbackMessage("Invalid username or password", "error")
+```
+
+### User_Logout
+Log out the current user and clear session.
+
+```
+User_Logout()
+  Input: (none)
+  Output: (none — clears session)
+```
+
+### User_GetUnifiedLoginUrl
+Get the URL of the central login page (when using an external IdP or unified login).
+
+```
+User_GetUnifiedLoginUrl(OriginalUrl)
+  Input: OriginalUrl (Text) — URL to redirect back to after login
+  Output: URL (Text) — The login page URL
+```
+
+## User Management Actions
+
+### User_CreateOrUpdate
+Create a new user or update an existing one.
+
+```
+User_CreateOrUpdate(User)
+  Input: User (User Record)
+    - Username (Text) — Required, unique
+    - Name (Text) — Display name
+    - Email (Text) — Email address
+    - MobilePhone (Phone Number) — Optional
+    - IsActive (Boolean) — Whether the user can login
+  Output: UserId (User Identifier) — The created/updated user's ID
+```
+
+### User_SetPassword
+Change a user's password.
+
+```
+User_SetPassword(UserId, Password)
+  Input: UserId (User Identifier) — Target user
+  Input: Password (Text) — New password (must meet complexity requirements)
+  Output: (none)
+```
+
+### User_ChangePassword
+Change the current user's own password (requires current password).
+
+```
+User_ChangePassword(UserId, OldPassword, NewPassword)
+  Input: UserId (User Identifier)
+  Input: OldPassword (Text) — Current password for verification
+  Input: NewPassword (Text) — New password
+  Output: (none)
+  Throws: Security Exception if old password is wrong
+```
+
+### User_Delete
+Deactivate or delete a user account.
+
+```
+User_Delete(UserId)
+  Input: UserId (User Identifier)
+  Output: (none)
+```
+
+**Note**: In most OutSystems configurations, this deactivates rather than hard-deletes the user.
+
+## Session & Identity
+
+### GetUserId
+Get the current logged-in user's identifier.
+
+```
+GetUserId()
+  Output: UserId (User Identifier)
+  Note: Returns NullIdentifier() if no user is logged in
+```
+
+### GetUserName
+Get the current user's username.
+
+```
+GetUserName()
+  Output: Username (Text)
+```
+
+### GetExternalLoginURL
+Get the URL for external authentication providers (SAML, OAuth, etc.).
+
+```
+GetExternalLoginURL(ProviderName)
+  Input: ProviderName (Text) — e.g., "AzureAD", "Okta"
+  Output: URL (Text)
+```
+
+## Role Management
+
+### GrantRole
+Assign a role to a user.
+
+```
+GrantRole(UserId, RoleId)
+  Input: UserId (User Identifier)
+  Input: RoleId (Role Identifier) — e.g., Entities.Role.Admin
+  Output: (none)
+```
+
+### RevokeRole
+Remove a role from a user.
+
+```
+RevokeRole(UserId, RoleId)
+  Input: UserId (User Identifier)
+  Input: RoleId (Role Identifier)
+  Output: (none)
+```
+
+### CheckRole
+Check if a user has a specific role.
+
+```
+CheckRole(UserId, RoleId)
+  Input: UserId (User Identifier)
+  Input: RoleId (Role Identifier)
+  Output: HasRole (Boolean)
+```
+
+**Shortcut**: Auto-generated `Check<RoleName>Role()` functions check the current user.
+
+## Common Patterns
+
+### Registration Flow
+```
+ServerAction: Register
+  Input: Username, Password, Name, Email
+
+  // 1. Create user
+  NewUser = CreateUser(Username, Name, Email, IsActive: True)
+  UserId = User_CreateOrUpdate(NewUser)
+
+  // 2. Set password
+  User_SetPassword(UserId, Password)
+
+  // 3. Assign default role
+  GrantRole(UserId, Entities.Role.RegisteredUser)
+
+  // 4. Auto-login
+  User_Login(Username, Password, PersistLogin: False)
+```
+
+### Password Reset Flow
+```
+ServerAction: ResetPassword
+  Input: UserId, NewPassword
+
+  // 1. Validate token (custom logic — not built-in)
+  If not ValidateResetToken(UserId, Token)
+    Raise User Exception "Invalid or expired reset link"
+  End If
+
+  // 2. Set new password
+  User_SetPassword(UserId, NewPassword)
+
+  // 3. Invalidate token
+  InvalidateResetToken(UserId, Token)
+```
+
+### Authorization Check Pattern
+```
+ServerAction: EnsureAuthorized
+  Input: RequiredRole (Role Identifier)
+
+  If GetUserId() = NullIdentifier()
+    Raise Security Exception "Not authenticated"
+  End If
+
+  If not CheckRole(GetUserId(), RequiredRole)
+    Raise Security Exception "Insufficient permissions"
+  End If
+```
+
+## Platform Differences
+
+| Feature | O11 | ODC |
+|---------|-----|-----|
+| User entity | `System.User` | Built-in User entity |
+| Roles | Defined per module, granted at runtime | Defined in ODC Portal, managed via API |
+| External auth | Users module + IdP config | Built-in OIDC/SAML in ODC Portal |
+| Session storage | Server-side session | Stateless JWT tokens |
+| User_Login | Creates server session + cookie | Returns JWT token |
+| Multi-tenant | `TenantId` on Site entities | Separate ODC organizations |