docs: add HTML page SDK API references

docs/html-pages/index.md

@@ -24,7 +24,9 @@ flowchart LR
 
 The SDK offers:
 
-- **Data APIs** — list, add, update and delete rows; upload files and images.
+- **Data APIs** — list, add, update and delete rows; manage links; upload files and images.
+- **User APIs** — read the signed-in user and resolve collaborators.
+- **Action APIs** — send notifications and emails, and run configured Python scripts.
 - **Event propagation** — bidirectional events (mouse, keyboard, drag-and-drop) between the page and the app.
 
 ## Prerequisites
@@ -66,7 +68,7 @@ The same kind of page can be built two ways. Pick the one that matches how you l
 
 - [Low-code quickstart](low-code-quickstart.md) — build a page with a visual editor and copy-paste snippets, no toolchain.
 - [Developer setup](getting-started.md) — set up the project, develop locally, build and upload a page. We follow the official [simple form template](https://github.com/seatable/seatable-html-page-template-simple-form) end to end.
-- [SDK Reference](sdk/initialization.md) — installation, initialization, and the full API for rows, files and images.
+- [SDK Reference](sdk/initialization.md) — installation, initialization, and the full API for rows, links, users, actions, files and images.
 
 !!! tip "Example project"
 

docs/html-pages/sdk/actions.md

@@ -0,0 +1,214 @@
+---
+description: seatable-html-page-sdk reference for sending notifications and emails, and running configured Python scripts from an HTML page.
+---
+
+# Actions
+
+Action operations on the `seatable-html-page-sdk`. They start asynchronous notification, email, or Python-script tasks. All methods are asynchronous — `await` them. The `sdk` instance below is created and initialized as shown in [Initialization](initialization.md).
+
+!!! warning "Response format"
+
+    Action methods resolve to the underlying HTTP response. Read the payload from `.data`. Methods that start a task return its identifier in `.data.task_id`; retain this ID when the page needs to query task progress or results.
+
+## Notifications and email
+
+!!! abstract "sendNotification"
+
+    Create a notification task associated with one row.
+
+    ```js
+    sdk.sendNotification({ tableName, rowId, emails, msg });
+    ```
+
+    __Parameters__
+
+    `tableName`
+    :   string — display name of the table containing the row
+
+    `rowId`
+    :   string — `_id` of the row associated with the notification
+
+    `emails`
+    :   array — non-empty list of recipient email addresses
+
+    `msg`
+    :   string — non-empty notification text. It can contain row-value template placeholders such as `{Order number}`.
+
+    __Returns__ `.data` holds `{ task_id }` — use `task_id` with `getMessageStatus`.
+
+    __Example__
+    ```js
+    const res = await sdk.sendNotification({
+      tableName: "Orders",
+      rowId: "fcHIocncTsOygA3FjL-toQ",
+      emails: ["a7f34c91e2bd4d6b8a50f1c73e9d2a48@auth.local"],
+      msg: "Your order {Order number} has been shipped.",
+    });
+    const taskId = res.data.task_id;
+    ```
+
+!!! abstract "sendEmail"
+
+    Create an email task associated with one row.
+
+    ```js
+    sdk.sendEmail({
+      tableName,
+      rowId,
+      accountName,
+      sendTo,
+      copyTo,
+      replyTo,
+      subject,
+      message,
+      htmlMessage,
+      attachmentColumnNames,
+    });
+    ```
+
+    __Parameters__
+
+    `tableName`
+    :   string — display name of the table containing the row
+
+    `rowId`
+    :   string — `_id` of the row associated with the email
+
+    `accountName`
+    :   string — name of the configured email account
+
+    `sendTo`
+    :   array — non-empty list of recipient email addresses or row-value templates
+
+    `copyTo`
+    :   array — optional list of CC email addresses or row-value templates
+
+    `replyTo`
+    :   string — optional Reply-To email address or row-value template
+
+    `subject`
+    :   string — non-empty plain-text email subject
+
+    `message`
+    :   string — plain-text body template
+
+    `htmlMessage`
+    :   string — HTML body template
+
+    `attachmentColumnNames`
+    :   array — optional list of FILE column display names; do not use column keys
+
+    `message` and `htmlMessage` must provide exactly one body: do not pass both, and do not omit both. Recipient values and the message body can use row-value template placeholders such as `{Customer email}` and `{Order number}`.
+
+    __Returns__ `.data` holds `{ task_id }` — use `task_id` with `getMessageStatus`.
+
+    __Example__
+    ```js
+    const res = await sdk.sendEmail({
+      tableName: "Orders",
+      rowId: "fcHIocncTsOygA3FjL-toQ",
+      accountName: "Operations SMTP",
+      sendTo: ["customer@example.com"],
+      copyTo: ["orders-audit@example.com"],
+      replyTo: "support@example.com",
+      subject: "Order shipment notification",
+      htmlMessage: "<p>Your order <strong>{Order number}</strong> has been shipped.</p>",
+      attachmentColumnNames: ["Invoice"],
+    });
+    const taskId = res.data.task_id;
+    ```
+
+!!! abstract "getMessageStatus"
+
+    Get the status of a notification or email task returned by `sendNotification` or `sendEmail`.
+
+    ```js
+    sdk.getMessageStatus({ taskId });
+    ```
+
+    __Parameters__
+
+    `taskId`
+    :   string — task identifier returned in `response.data.task_id`
+
+    __Example__
+    ```js
+    const res = await sdk.getMessageStatus({ taskId });
+    if (res.data.is_finished) {
+      // Stop polling and update the UI.
+    }
+    ```
+
+    Do not query the status until the task-starting method has returned its `task_id`.
+
+## Python scripts
+
+!!! abstract "runScript"
+
+    Start a configured Python script.
+
+    ```js
+    sdk.runScript({ scriptName, tableName, rowId });
+    ```
+
+    __Parameters__
+
+    `scriptName`
+    :   string — displayed name of the configured script, not its internal ID or file name
+
+    `tableName`
+    :   string — optional display name of the table that supplies the row context
+
+    `rowId`
+    :   string — optional `_id` of the row that supplies the row context
+
+    Provide `tableName` and `rowId` together when the script needs a row context, or omit both when it does not.
+
+    __Returns__ `.data` holds `{ task_id }` — use `task_id` with `getScriptResult`.
+
+    __Example__
+    ```js
+    const res = await sdk.runScript({
+      scriptName: "Generate order report",
+      tableName: "Orders",
+      rowId: "fcHIocncTsOygA3FjL-toQ",
+    });
+    const taskId = res.data.task_id;
+    ```
+
+!!! abstract "getScriptResult"
+
+    Get the result of a script started by `runScript`.
+
+    ```js
+    sdk.getScriptResult({ scriptName, taskId });
+    ```
+
+    __Parameters__
+
+    `scriptName`
+    :   string — the same displayed script name used to start the task
+
+    `taskId`
+    :   string — task identifier returned in `runScript` response `.data.task_id`
+
+    __Returns__ `.data` holds `{ script }`. The `script` object includes `state`, `success`, `output`, `return_code`, `started_at`, and `finished_at`.
+
+    __Example__
+    ```js
+    const res = await sdk.getScriptResult({
+      scriptName: "Generate order report",
+      taskId,
+    });
+    const scriptResult = res.data.script;
+
+    if (scriptResult.state === "finished") {
+      if (scriptResult.success) {
+        // The script completed successfully.
+      } else {
+        // Inspect scriptResult.return_code and scriptResult.output.
+      }
+    }
+    ```
+
+    Query the result only with the `taskId` returned by the corresponding `runScript` call. Treat `success: false` or a non-zero `return_code` as a failed execution, and render `output` as plain text rather than HTML.

docs/html-pages/sdk/initialization.md

@@ -4,7 +4,7 @@ description: Install and initialize the seatable-html-page-sdk. Set up the SDK v
 
 # Initialization
 
-The `seatable-html-page-sdk` is the bridge between an HTML page and its Universal App. It exposes APIs for data interaction and event subscription. This page covers installation and initialization. For data operations, see [Rows](rows.md) and [Files & Images](files.md).
+The `seatable-html-page-sdk` is the bridge between an HTML page and its Universal App. It exposes APIs for data interaction and event subscription. This page covers installation and initialization. For API details, see [Rows](rows.md), [Links](links.md), [Users](users.md), [Actions](actions.md), and [Files & Images](files.md).
 
 ## Installation
 
@@ -98,4 +98,7 @@ All SDK methods are asynchronous and return promises — always `await` them. Ro
 ## Next steps
 
 - [Rows](rows.md) — list, add, update and delete rows, including batch operations.
+- [Links](links.md) — incrementally add and remove linked records.
+- [Users](users.md) — read the signed-in user and resolve collaborators.
+- [Actions](actions.md) — send notifications and emails, and run configured Python scripts.
 - [Files & Images](files.md) — upload files and images for file and image columns.