### Install and Run Nuxt 3 Style & Icons Showcase

Source: https://context7.com/bitrix24/b24sdk-examples/llms.txt

Navigate to the example directory, install dependencies, and run the development server. No Bitrix24 credentials are required for this standalone example.

```bash
cd js/01-style-icons
pnpm install
pnpm run dev          # http://localhost:3000
```

--------------------------------

### Setup Nuxt Hook (Webhook-authenticated server API)

Source: https://context7.com/bitrix24/b24sdk-examples/llms.txt

Clone the example, copy the environment file, and edit it with your Bitrix24 webhook URL. Then, install dependencies and run the development server.

```bash
cd js/02-nuxt-hook
cp .env.example .env
# Edit .env: NUXT_B24_HOOK="https://your_domain.bitrix24.com/rest/1/xxxyyyxxx/"
pnpm install && pnpm run dev
```

--------------------------------

### Run Nuxt UI Business-Process Activity Example

Source: https://context7.com/bitrix24/b24sdk-examples/llms.txt

Install dependencies and run the Nuxt 3 development server for the business-process activity example. Activity descriptions are located in the `content/activities/{locale}/` directory.

```bash
cd js/06-nuxt-ui-bp-activity
pnpm install && pnpm run dev

```

--------------------------------

### Install and Run Local PHP App with Token Storage

Source: https://context7.com/bitrix24/b24sdk-examples/llms.txt

This example demonstrates setting up a local PHP application that stores access and refresh tokens in a file. It requires Composer and npm for installation and provides instructions for registering the app with Bitrix24 using ngrok.

```bash
cd php/quick-start/local-apps/token-storage-in-file
composer install && npm install
npm run dev   # PHP server :8080 + ngrok + Tailwind
# Register:  Handler=https://<ngrok>/index.php  Install=https://<ngrok>/install.php
# Visit:     https://<ngrok>/external.php → shows current user data
```

--------------------------------

### Build and Start Docker Containers

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/php/special/biconnector/README.md

Builds the Docker image and starts the application containers. Ensure Docker is installed and running.

```bash
make build
make up
```

--------------------------------

### Run Nuxt OAuth Example

Source: https://context7.com/bitrix24/b24sdk-examples/llms.txt

Install dependencies and run the Nuxt 3 development server for the OAuth 2.0 example. Configure your Bitrix24 OAuth client ID and secret in the `.env` file. Visit `http://localhost:3000` to initiate the login flow.

```bash
cd js/08-nuxt-oauth
# .env  – set NUXT_OAUTH_BITRIX24_CLIENT_ID and NUXT_OAUTH_BITRIX24_CLIENT_SECRET
pnpm install && pnpm run dev
# Visit http://localhost:3000 → click "Login with Bitrix24"

```

--------------------------------

### Run Nuxt UI Widget Example

Source: https://context7.com/bitrix24/b24sdk-examples/llms.txt

Install dependencies and run the Nuxt 3 development server for the widget example. This application demonstrates building a small embeddable widget for Bitrix24 placements.

```bash
cd js/07-nuxt-ui-widget
pnpm install && pnpm run dev

```

--------------------------------

### Start Development Server with bun

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/06-nuxt-ui-bp-activity/README.md

Run this command to start the Nuxt development server using bun.

```bash
bun run dev
```

--------------------------------

### Start Development Server with npm

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/06-nuxt-ui-bp-activity/README.md

Run this command to start the Nuxt development server using npm.

```bash
npm run dev
```

--------------------------------

### Local Environment Configuration Example

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/php/special/vibe24-widgets/README.md

Example of how the .env.local file should be populated with Bitrix24 application credentials. Replace 'YOUR_DATA_HERE' with your actual application ID, secret, and scope.

```plaintext
BITRIX24_PHP_SDK_APPLICATION_CLIENT_ID='YOUR_DATA_HERE'
BITRIX24_PHP_SDK_APPLICATION_CLIENT_SECRET='YOUR_DATA_HERE'
BITRIX24_PHP_SDK_APPLICATION_SCOPE='user_brief'
```

--------------------------------

### Install Project Dependencies

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/02-nuxt-hook/README.md

Run this command in your project's root directory to install all necessary dependencies.

```bash
pnpm install
```

--------------------------------

### Package JSON Configuration

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/05-node-hook/README.md

This is an example of the package.json file after installing dependencies. Ensure 'type' is set to 'module' for ES module support.

```json
{
    "name": "my-node-project",
    "type": "module",
    "devDependencies": {
        "@types/node": "^22.9.1",
        "typescript": "^5.6.3"
    },
    "dependencies": {
        "@bitrix24/b24jssdk": "latest",
        "chalk": "^5.3.0",
        "dotenv": "^16.4.5"
    }
}
```

--------------------------------

### Local Environment Configuration Example

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/php/quick-start/local-apps/token-storage-in-file/README.md

Example of how to configure your local environment variables in the .env.local file with your Bitrix24 application credentials.

```plaintext
BITRIX24_PHP_SDK_APPLICATION_CLIENT_ID='YOUR_DATA_HERE'
BITRIX24_PHP_SDK_APPLICATION_CLIENT_SECRET='YOUR_DATA_HERE'
BITRIX24_PHP_SDK_APPLICATION_SCOPE='crm,user_brief'
```

--------------------------------

### Start Development Server with yarn

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/06-nuxt-ui-bp-activity/README.md

Run this command to start the Nuxt development server using yarn.

```bash
yarn dev
```

--------------------------------

### Install Dependencies with bun

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/06-nuxt-ui-bp-activity/README.md

Use this command to install project dependencies using bun.

```bash
bun install
```

--------------------------------

### Install Dependencies

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/php/quick-start/simple/02-work-with-webhook/README.md

Install project dependencies using Composer. Ensure you have Composer installed globally.

```shell
composer install
```

--------------------------------

### Start Local PHP Web Server

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/php/special/custom-activities/README.md

Start a local PHP web server for development. This command serves files from the 'public' directory.

```shell
cd public
php -S 127.0.0.1:8090
```

--------------------------------

### Run the Nuxt Project

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/02-nuxt-hook/README.md

Execute this command to start the Nuxt development server after setting up your environment variables.

```bash
pnpm run dev
```

--------------------------------

### Install Dependencies with npm

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/04-umd-frame/README.md

Installs the necessary dependencies for the project using npm. This command should be run in the project's root directory.

```shell
npm install
```

--------------------------------

### Execute Webhook Script

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/php/quick-start/simple/02-work-with-webhook/README.md

Run the PHP example script from your shell. Make sure to replace `INSERT_HERE_WEBHOOK_URL` with your actual webhook URL in the `example.php` file.

```shell
php -f example.php
```

--------------------------------

### UMD Frame Setup (PHP + Tailwind)

Source: https://context7.com/bitrix24/b24sdk-examples/llms.txt

Instructions for setting up a local Bitrix24 application using PHP's built-in web server, ngrok, and Tailwind CSS. The JavaScript is loaded as a UMD bundle. Ideal for learning token exchange.

```bash
cd js/04-umd-frame
npm install
npm run dev   # starts PHP web server on :8080, ngrok tunnel, and Tailwind watch

# Register in Bitrix24 Developer Resources > Local application:
# Handler path:  https://<ngrok-subdomain>.ngrok-free.app/index.php
# Install path:  https://<ngrok-subdomain>.ngrok-free.app/install.php
# Scopes:        user_brief, crm

```

--------------------------------

### Install Dependencies with yarn

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/06-nuxt-ui-bp-activity/README.md

Use this command to install project dependencies using yarn.

```bash
yarn install
```

--------------------------------

### Initialize SQLite Database

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/php/special/biconnector/README.md

Initializes the SQLite database with schema and sample data. This command should be run after starting the containers.

```bash
make init-db
```

--------------------------------

### Start Development Server with pnpm

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/03-nuxt-frame/README.md

Starts the Nuxt.js development server using pnpm. The application will be accessible at http://localhost:3000/dev-folder/.

```bash
# pnpm
pnpm run dev
```

--------------------------------

### Install Dependencies for Nuxt UI Widget

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/07-nuxt-ui-widget/README.md

Run these commands to install project dependencies using npm, pnpm, yarn, or bun.

```bash
# npm
npm install

# pnpm
pnpm install

# yarn
yarn install

# bun
bun install
```

--------------------------------

### JS Example 01 – Style & Icons Showcase

Source: https://context7.com/bitrix24/b24sdk-examples/llms.txt

A Nuxt 3 playground showcasing Bitrix24 icon components and styling primitives. No Bitrix24 credentials are required.

```APIDOC
## JS Example 01 – Style & Icons Showcase (`js/01-style-icons`)

A Nuxt 3 playground that renders all `@bitrix24/b24icons-vue` icon components and tests `@bitrix24/b24ui-nuxt` styling primitives. No Bitrix24 credentials are required – it runs standalone.

```bash
cd js/01-style-icons
pnpm install
pnpm run dev          # http://localhost:3000
```

```ts
// app/pages/index.vue – icon usage pattern
import FileDownloadIcon from '@bitrix24/b24icons-vue/main/FileDownloadIcon'
import CompanyIcon      from '@bitrix24/b24icons-vue/crm/CompanyIcon'

// Inside <template>:
// <B24Button :icon="FileDownloadIcon" label="Download" color="air-primary" />
// <B24Button :icon="CompanyIcon"      label="Companies" color="air-secondary" />
```
```

--------------------------------

### Install Project Dependencies

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/05-node-hook/README.md

Install necessary development dependencies like TypeScript and Node types, as well as runtime dependencies for Bitrix24 SDK, dotenv, and chalk.

```bash
npm install typescript @types/node --save-dev
npm install @bitrix24/b24jssdk@latest dotenv chalk --save
```

--------------------------------

### Example Folder Structure for Local Application

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/php/special/custom-activities/README.md

This outlines the standard directory layout for a Bitrix24 local application, including configuration, public assets, source code, and logs.

```plaintext
/config
    .env - Example environment configuration file
    .env.local - Local environment configuration file (not committed to version control)
    auth.json.local - Authentication data from the application
/public
    /css - Directory for widget styles
        app.css - Stylesheet for the widget
    index.php - Main script loaded by default
    install.php - Script for saving the initial OAuth tokens and handling installation steps
    handler.php - Script for handling widget logic
    action.php - Обработчик для создания конфигурируемого дела
/src
    Application.php - Example of a local application, which is used to store the admin token and register a widget
/var
    /log - Directory for log files
        application-YYYY-m-d.log - Application log file
composer.json - Composer configuration file defining project dependencies and metadata
composer.lock - Automatically generated by Composer to ensure consistent dependency versions
```

--------------------------------

### Expose Local Server with Ngrok

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/php/special/vibe24-widgets/README.md

Starts the Ngrok client to expose your local PHP server to the internet. Replace <random-subdomain>.ngrok-free.app with your actual Ngrok subdomain.

```shell
ngrok http 127.0.0.1:8090 --domain <random-subdomain>.ngrok-free.app
```

--------------------------------

### Start Nuxt Development Server

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/07-nuxt-ui-widget/README.md

Use these commands to start the development server for your Nuxt.js application. The server typically runs on http://localhost:3000.

```bash
# npm
npm run dev

# pnpm
pnpm run dev

# yarn
yarn dev

# bun
bun run dev
```

--------------------------------

### Start PHP Web Server

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/php/special/vibe24-widgets/README.md

Starts a local PHP web server on port 8090. This server is intended for development and testing purposes only.

```shell
php -S 127.0.0.1:8090
```

--------------------------------

### Ngrok Client Output Example

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/04-umd-frame/README.md

This is an example of the output you might see in your terminal when the ngrok client is running. It shows the session status, account details, version, region, latency, and forwarding information.

```plaintext
Session Status                online
Account                       YourAccount (Plan: Free)
Update                        update available (version 3.16.0, Ctrl-U to update)
Version                       3.10.0
Region                        United States (us)
Latency                       196ms
Web Interface                 http://127.0.0.1:4040
Forwarding                    https://<random-subdomain>.ngrok-free.app -> http://127.0.0.1:8080
```

--------------------------------

### Execute Batch ETL CLI Example

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/php/quick-start/simple/04-work-with-batch-cli/README.md

Execute the PHP script from your shell, providing your webhook for authentication. This initiates the long-running ETL process.

```shell
php etl-cli-example.php --webhook=INSERT_YOUR_WEBHOOK_HERE
```

--------------------------------

### Example Folder Structure for Bitrix24 Vibe Widgets

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/php/special/vibe24-widgets/README.md

This plaintext structure outlines the directories and key files for a local Bitrix24 application, including configuration, public assets, widget definitions, source code, and logging.

```plaintext
/config
    .env - Example environment configuration file
    .env.local - Local environment configuration file (not committed to version control)
    auth.json.local - Authentication data from the application
/public 
    /widgets 
        /problem-tasks 
            /assets 
            demo.json 
            settings.json 
            template.css 
            template.html 
    index.php 
    install.php 
    widget-handler.php 
    widgets.php 
/src
    Application.php 
/var
    /log 
        application-YYYY-m-d.log 
composer.json 
composer.lock
```

--------------------------------

### Nuxt Frame Setup for iFrame Embedded Apps

Source: https://context7.com/bitrix24/b24sdk-examples/llms.txt

Instructions for setting up a Nuxt 3 SPA to run inside a Bitrix24 iFrame. This involves copying an environment file, installing dependencies, and running the development server.

```bash
cd js/03-nuxt-frame
cp .env.example .env   # set NUXT_PUBLIC_B24_FORM_ID, NUXT_PUBLIC_B24_FORM_SECRET, etc.
pnpm install && pnpm run dev
# Expose via ngrok: ngrok http 3000
```

--------------------------------

### Initialize Node.js Project

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/05-node-hook/README.md

Run this command to initialize a new Node.js project with a default package.json.

```bash
npm init -y
```

--------------------------------

### Create Project Folder

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/05-node-hook/README.md

Use these bash commands to create and navigate into a new project directory.

```bash
mkdir my-node-project
cd my-node-project
```

--------------------------------

### Batch-load App & User Options with useB24Helper

Source: https://context7.com/bitrix24/b24sdk-examples/llms.txt

Use `initB24Helper` to perform a single batch REST call for app info, options, user options, currency, and profile. `getB24Helper` provides typed accessors afterward. Sets locale to match portal language.

```typescript
// app/composables/useAppInit.ts
import { LoadDataType, useB24Helper } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'

const { initB24Helper, getB24Helper, usePullClient, startPullClient } = useB24Helper()

async function initApp($b24: B24Frame, localesI18n: any, setLocale: any) {
  // Set locale to match the portal language
  const lang = $b24.getLang()
  await setLocale(lang)

  // Single batch call loads app info, options, user options, currency and profile
  await initB24Helper($b24, [
    LoadDataType.App,
    LoadDataType.AppOptions,
    LoadDataType.UserOptions,
    LoadDataType.Currency,
    LoadDataType.Profile
  ])

  const helper = getB24Helper()
  // Hydrate Pinia stores from the loaded data
  userStore.initFromBatch({
    name:     helper.profileInfo?.data.name,
    lastName: helper.profileInfo?.data.lastName,
    isAdmin:  helper.profileInfo?.data.isAdmin
  })

  appSettingsStore.initFromBatch({
    version:        helper.appInfo?.data.version ?? 1,
    status:         helper.appInfo?.data.status,
    configSettings: (helper.appOptions?.data ?? new Map()).get('configSettings')
  })
}
// After initApp: userStore.login === "John Doe", appSettingsStore.version === 3

```

--------------------------------

### callMethod - Single REST call with optional start offset

Source: https://context7.com/bitrix24/b24sdk-examples/llms.txt

The basic building block for all REST interactions. Supports manual pagination using the `start` parameter.

```APIDOC
## callMethod - Single REST call

### Description
Executes a single Bitrix24 REST API method. Allows for manual pagination control using the `start` parameter to specify the offset for fetching results.

### Method
`callMethod`

### Parameters
- `method` (String): The REST method to call (e.g., 'crm.item.list').
- `params` (Object): Parameters for the method, including filters, selects, and orders.
- `start` (Number): Optional. The starting offset for pagination. For example, `50` would fetch results starting from the 51st item (assuming a default page size).

### Request Example
```ts
const response = await $b24.callMethod(
  'crm.item.list',
  {
    entityTypeId: EnumCrmEntityTypeId.company,
    select:       ['id', 'title'],
    order:        { id: 'ASC' }
  },
  50   // start = page 2 (50 items per page)
)

const data  = response.getData()
const items = data.result.items
const next  = data.next
```

### Response Example
```json
{
  "result": {
    "items": [ { "id": 51, "title": "..." }, ... ]
  },
  "total": 120,
  "next": 100
}
```
```

--------------------------------

### Preview Production Build with bun

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/06-nuxt-ui-bp-activity/README.md

Use this command to locally preview the production build of the Nuxt application with bun.

```bash
bun run preview
```

--------------------------------

### Build for Production with bun

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/06-nuxt-ui-bp-activity/README.md

Execute this command to build the Nuxt application for production using bun.

```bash
bun run build
```

--------------------------------

### Preview Nuxt Production Build Locally

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/07-nuxt-ui-widget/README.md

After building for production, use these commands to preview the built application locally. This helps in testing the production environment before deployment.

```bash
# npm
npm run preview

# pnpm
pnpm run preview

# yarn
yarn preview

# bun
bun run preview
```

--------------------------------

### Environment Variables Configuration (.env)

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/03-nuxt-frame/README.md

Example of environment variables required for Bitrix24 integration, including form IDs, secrets, and application URLs. Ensure these are kept private in your .env file.

```plaintext
## For example: 35
NUXT_PUBLIC_B24_FORM_ID="0"

## For example: c9qk4k
NUXT_PUBLIC_B24_FORM_SECRET="insert_secret"

## For example: https://cdn-ru.bitrix24.com/b80599/crm/form/loader_34.js
NUXT_PUBLIC_B24_FORM_LOADER_SCRIPT="insert_loaderScript"

## AI.DeepSeek ##################################
DEEPSEEK_API_KEY='sk-xxxxxxxxx'

## App ##########################################
NUXT_PUBLIC_APP_URL='https://dev.example.com'
```

--------------------------------

### Copy Environment File

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/php/quick-start/local-apps/token-storage-in-file/README.md

Create a local environment file by copying the default .env file.

```shell
cp .env .env.local
```

--------------------------------

### Preview Production Build with npm

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/06-nuxt-ui-bp-activity/README.md

Use this command to locally preview the production build of the Nuxt application with npm.

```bash
npm run preview
```

--------------------------------

### Initialize B24Frame in Nuxt Middleware

Source: https://context7.com/bitrix24/b24sdk-examples/llms.txt

Call `$initializeB24Frame` once per page navigation to get an authenticated `B24Frame` instance. Handles routing to specific sliders based on placement options. Skips SSR.

```typescript
// app/middleware/01.app.page.or.slider.global.ts
import type { B24Frame } from '@bitrix24/b24jssdk'

export default defineNuxtRouteMiddleware(async (to) => {
  if (import.meta.server) return   // skip SSR

  try {
    const { $initializeB24Frame } = useNuxtApp()
    const $b24: B24Frame = await $initializeB24Frame()

    // Route to the correct slider based on placement options
    const place = $b24.placement.options?.place
    if (place === 'app-options') {
      return navigateTo('/slider/app-options.html')
    }
    if (place === 'feedback') {
      return navigateTo('/slider/feedback.html')
    }
  } catch (error: any) {
    showError({ statusCode: 404, statusMessage: error?.message, fatal: true })
  }
})
```

--------------------------------

### JS Example 02 – Nuxt Hook (Webhook-authenticated server API)

Source: https://context7.com/bitrix24/b24sdk-examples/llms.txt

A Nuxt 3 full-stack application demonstrating server-side API routes that use `B24Hook` to interact with the Bitrix24 REST API.

```APIDOC
## JS Example 02 – Nuxt Hook (Webhook-authenticated server API) (`js/02-nuxt-hook`)

A Nuxt 3 full-stack application where **server-side API routes** instantiate `B24Hook` from a webhook URL stored in `NUXT_B24_HOOK` and call the Bitrix24 REST API. The frontend pages call these internal Nuxt API routes via `$fetch`.

```bash
cd js/02-nuxt-hook
cp .env.example .env
# Edit .env: NUXT_B24_HOOK="https://your_domain.bitrix24.com/rest/1/xxxyyyxxx/"
pnpm install && pnpm run dev
```
```

```APIDOC
### `B24Hook.fromWebhookUrl` – Instantiate from a webhook URL

Parses a full Bitrix24 inbound webhook URL into a `B24Hook` instance. All subsequent `callMethod` / `callBatch` / `callListMethod` / `fetchListMethod` calls go to that portal.

```ts
// server/api/profile.get.ts
import { B24Hook, LoggerBrowser } from '@bitrix24/b24jssdk'
import { defineEventHandler } from 'h3'

export default defineEventHandler(async () => {
  const config = useRuntimeConfig()
  const $logger = LoggerBrowser.build('Demo: user.current', import.meta.dev)
  const $b24 = B24Hook.fromWebhookUrl(config.b24Hook)
  $b24.setLogger($logger)

  const response = await $b24.callBatch({
    currentUser: { method: 'user.current' },
    profile:     { method: 'profile' }
  })

  const data = response.getData()
  return {
    success:  true,
    profile:  { ...data.currentUser, ADMIN: data.profile?.ADMIN },
    hostName: $b24.getTargetOrigin()
  }
})
// GET /api/profile → { success: true, profile: { ID, NAME, LAST_NAME, ADMIN, ... }, hostName: "https://..." }
```
```

```APIDOC
### `callBatch` – Execute multiple REST calls in one request

Sends up to 50 named commands in a single HTTP call and returns a keyed result map. Pass `true` as the second argument to split commands into chunks of 50 automatically.

```ts
// server/api/companies.get.ts
import { B24Hook, EnumCrmEntityTypeId, LoggerBrowser } from '@bitrix24/b24jssdk'
import { defineEventHandler } from 'h3'

export default defineEventHandler(async () => {
  const config = useRuntimeConfig()
  const $b24 = B24Hook.fromWebhookUrl(config.b24Hook)

  const response = await $b24.callBatch({
    CompanyList: {
      method: 'crm.item.list',
      params: {
        entityTypeId: EnumCrmEntityTypeId.company,
        order:  { id: 'desc' },
        select: ['id', 'title', 'createdTime']
      }
    }
  }, true)   // true = auto-chunk batches > 50 commands

  const items = (response.getData().CompanyList.items || []).map((item: any) => ({
    id:          Number(item.id),
    title:       item.title,
    createdTime: item.createdTime,
    detailUrl:   `${$b24.getTargetOrigin()}/crm/company/details/${item.id}/`
  }))

  return { success: true, items }
  // { success: true, items: [{ id: 42, title: "Acme Corp", createdTime: "...", detailUrl: "..." }, ...] }
})
```
```

--------------------------------

### Single REST Call with callMethod

Source: https://context7.com/bitrix24/b24sdk-examples/llms.txt

The fundamental method for REST interactions, `callMethod`, can be used for single calls. The optional `start` parameter enables manual pagination, specifying the offset for the next page of results.

```typescript
// server/api/companies.get.ts (08-nuxt-oauth)
import { LoggerBrowser, EnumCrmEntityTypeId } from '@bitrix24/b24jssdk'

const response = await $b24.callMethod(
  'crm.item.list',
  {
    entityTypeId: EnumCrmEntityTypeId.company,
    select:       ['id', 'title'],
    order:        { id: 'ASC' }
  },
  50   // start = page 2 (50 items per page)
)

const data  = response.getData()   // { result: { items: [...] }, total: 120, next: 100 }
const items = data.result.items    // [{ id: 51, title: "..." }, ...]
const next  = data.next            // 100  (or undefined when last page)
```

--------------------------------

### Preview Production Build with pnpm

Source: https://github.com/bitrix24/b24sdk-examples/blob/main/js/06-nuxt-ui-bp-activity/README.md

Use this command to locally preview the production build of the Nuxt application with pnpm.

```bash
pnpm run preview
```