/apollo-connectors

Available Methods

Methods are invoked using the -> operator. You MUST NOT make up method names - only use methods listed here.

Table of Contents

• String Methods
• Object Methods
• Array Methods
• Logical Methods
• Math Methods
• Type Coercion
• Other Methods

String Methods

Object Methods

Array Methods

Array Method Examples

filter - Filter items by condition:

# Keep items where active is true
$.items->filter(@.active)

# Keep even numbers
$.numbers->filter(@->mod(2)->eq(0))

# Chain filters instead of using ->and
$.items->filter(@.active)->filter(@.price->gt(10))

find - Find first matching item:

# Find first active item
$.items->find(@.active)

# Find item with specific id
$.items->find(@.id->eq($args.id))

map - Transform items:

# Wrap each item
$.items->map({ value: @ })

# Extract nested field
$.users->map(@.profile.name)

joinNotNull - Concatenate strings:

# Join name parts with space
fullName: $([firstName, middleName, lastName])->joinNotNull(' ')

# Join address parts with comma
address: $([street, city, state])->joinNotNull(', ')

Logical Methods

Logical Method Examples

Comparisons:

# Check equality
isAdmin: role->eq("admin")

# Check inequality
notEmpty: value->ne("")

# Numeric comparisons
expensive: price->gt(100)
affordable: price->lte(50)

Boolean logic:

# AND - all must be true
valid: a->and(b, c)

# OR - any can be true
hasAccess: isAdmin->or(isOwner)

# NOT - invert
hidden: visible->not

Membership:

# Check if value is in list
validStatus: status->in("pending", "active", "complete")

# Check if array contains value
hasPremium: features->contains("premium")

Math Methods

Math Method Examples

# Calculate total with tax
totalWithTax: subtotal->mul(1.08)

# Calculate average
average: total->div(count)

# Check if even
isEven: number->mod(2)->eq(0)

# Apply discount
finalPrice: price->sub(discount)

Type Coercion

Type Coercion Examples

# String to integer
count: "42"->parseInt

# Integer to string for ID field
id: numericId->toString

# Parse and calculate
total: strPrice->parseInt->add(tax->parseInt)

Other Methods

Other Method Examples

echo - Useful for wrapping values:

# Wrap a value in an object
wrapped: items->echo({ data: @ })

# Use with transformations
result: value->echo({ original: @, doubled: @->mul(2) })

match - Map values to new values:

# Map status codes to strings
statusText: status->match(
  [1, "pending"],
  [2, "active"],
  [3, "complete"],
  [@, "unknown"]
)

# Map boolean to text
activeText: isActive->match(
  [true, "Yes"],
  [false, "No"]
)

jsonStringify - Convert to JSON:

# Serialize object for logging
serialized: data->jsonStringify