الإجراءات

actions: [
  {
    name: "createIssue", // Unique action identifier
    title: "Create Issue", // Display title
    description: "Create a new issue in a repository",
    renderStrategy: "auto", // UI rendering ('auto' = standard form)

    // Form definition (JSON Schema)
    parameters: {
      /* see Parameters section below */
    },

    // HTTP requests to execute (see Requests & Chaining below)
    requests: [
      /* ... */
    ],
  },
];

parameters: {
  type: 'object',
  required: ['repository', 'title'],
  properties: {
    // Simple text input
    title: {
      type: 'string',
      title: 'Issue Title',
      description: 'A short descriptive title',
    },

    // Text area (multiline)
    body: {
      type: 'string',
      title: 'Description',
    },

    // Dynamic dropdown from RPC source
    repository: {
      type: 'string',
      title: 'Repository',
      'x-source': 'rpc_repos_list',   // References a source definition
      'x-fallback': 'input',           // Fallback to text input if source fails
    },

    // Static dropdown (enum)
    priority: {
      type: 'string',
      title: 'Priority',
      enum: ['low', 'medium', 'high', 'critical'],
      default: 'medium',
    },

    // Boolean toggle
    isDraft: {
      type: 'boolean',
      title: 'Draft',
      default: false,
    },

    // Number input
    count: {
      type: 'number',
      title: 'Count',
    },

    // Array input (comma-separated or JSON)
    labels: {
      type: 'array',
      title: 'Labels',
    },
  },
}

requests: [
  {
    url: "https://api.example.com/issues",
    method: "POST",
    headers: {
      Authorization: "Bearer [[accessToken]]",
      "Content-Type": "application/json",
    },
    bodyType: "json",
    body: {
      title: "{{title}}",
      body: "{{body}}",
      labels: "{{labels}}",
    },
    mapping: {
      issueId: "$.id",
      issueUrl: "$.html_url",
    },
  },
];

// Example: Send a direct message on Slack
// Step 1: Open a DM channel with the user
// Step 2: Post a message to that channel
requests: [
  // Step 1: Open DM channel
  {
    url: "https://slack.com/api/conversations.open",
    method: "POST",
    headers: {
      Authorization: "Bearer [[accessToken]]",
      "Content-Type": "application/json",
    },
    bodyType: "json",
    body: { users: "{{userId}}" },
    // Array mapping → values forwarded to next request (NOT persisted)
    mapping: [{ name: "dmChannelId", value: "$.channel.id" }],
  },

  // Step 2: Post message (uses dmChannelId from step 1)
  {
    url: "https://slack.com/api/chat.postMessage",
    method: "POST",
    headers: {
      Authorization: "Bearer [[accessToken]]",
      "Content-Type": "application/json",
    },
    bodyType: "json",
    body: {
      channel: "{{dmChannelId}}", // ← From step 1's mapping
      text: "{{messageText}}", // ← From user's form input
    },
    mapping: {
      messageTs: "$.ts",
      channelId: "$.channel",
    },
  },
];

// get_token / refresh_token / registrationRequests → credentials
mapping: {
  accessToken: '$.access_token',
  webhookId: '$.webhook.id',
}

// userDetails → metadata
mapping: {
  uid: '$.user.id',
  storeId: '$.user.store.id',
  storeName: '$.user.store.title',
}

mapping: [
  { name: "channelId", value: "$.channel.id" },
  { name: "threadTs", value: "$.message.ts" },
];

functions: {
  findRows: {
    params: ['values', 'searchColumn', 'searchValue', 'matchType', 'firstOnly'],
    code: `
      // Plain JavaScript — must return a plain object
      // Throw an Error to abort the action with a friendly message
      var rows = Array.isArray(values) ? values : [];
      // ... search logic ...
      return { found: true, rowNumber: 2, row: { Email: 'a@b.com' } };
    `,
  },
},

requests: [
  {
    // Step 1 — HTTP (type defaults to 'http' when omitted)
    url: "https://sheets.googleapis.com/v4/spreadsheets/{{spreadsheetId}}/values/{{sheetName}}",
    method: "GET",
    headers: { Authorization: "Bearer [[accessToken]]" },
    mapping: { rangeValues: "$.values" },
  },
  {
    // Step 2 — App Function
    type: "function",
    name: "findRows",
    args: {
      values: "{{rangeValues}}", // preserves arrays (single-placeholder passthrough)
      searchColumn: "{{searchColumn}}",
      searchValue: "{{searchValue}}",
      matchType: "{{matchType}}",
      firstOnly: true,
    },
  },
];