open-index/open-npm huggingface dataset:
npm package: @primershop/strapi-plugin-product-actions
Description: Enables product actions for Strapi (v0.0.15)
Author: Magda Odrowaz-Zelezik
Latest version: 0.0.15

# @primershop/strapi-plugin-product-actions

A Strapi plugin that enables product actions functionality.

## Installation

```bash
npm install @primershop/strapi-plugin-product-actions
```

## Configuration

Add the plugin to your Strapi configuration file (`config/plugins.ts`):

```typescript
export default () => ({
  "primershop-product-actions": {
    enabled: true,
  },
});
```

## Features

- Product actions management
- Series product actions

## Requirements

- Strapi >= 5.22.0

## License

MIT

## Repository

[GitHub Repository](https://github.com/magdazelena/primer/tree/main/packages/strapi-plugin-product-actions)
npm package: @primershop/strapi-plugin-status-manager
Description: Enables more status variations for Strapi (v0.0.23)
Author: Magda Odrowaz-Zelezik
Latest version: 0.0.23

# Advanced state manager for Strapi content

A Strapi plugin that enables more status variations for your content.

## Installation

```bash
npm install @primershop/strapi-plugin-status-manager
```

## Usage

1. Install the plugin in your Strapi project
2. The plugin will automatically register and provide additional status management functionality
3. Configure the plugin through the Strapi admin panel

## How it works
First of all, custom statuses will work only if you disable `draft&Publish` default option from your content type in the content builder. Otherwise it's default strapi behavior.

### Add custom statuses for your content
Just type in status in the input field and press "Add status" button

![](https://raw.githubusercontent.com/magdazelena/primer/main/packages/strapi-plugin-status-manager/docs/screenshots/add.PNG)

### Toggle visibility of your status
Press "Published" or "Unpublished" button to change the visibility of the content with assigned status.
Only "published" will be accessible on your frontend.

![](https://raw.githubusercontent.com/magdazelena/primer/main/packages/strapi-plugin-status-manager/docs/screenshots/visibility.PNG)

### Reorder statuses

This might be important for your flow of content creation and management.
You can use drag and drop tool and change order of the statuses. It will be reflected in the status dropdowns on your content pages.

| Before | After |
| ------ | ----- |
| ![](https://raw.githubusercontent.com/magdazelena/primer/main/packages/strapi-plugin-status-manager/docs/screenshots/reorder1.png) | ![](https://raw.githubusercontent.com/magdazelena/primer/main/packages/strapi-plugin-status-manager/docs/screenshots/reorder2.PNG) |

### Delete status

Upon deleting you will be prompted to choose replacement status.
All the content with deleted status will then be updated to have the replacement status.

![](https://raw.githubusercontent.com/magdazelena/primer/main/packages/strapi-plugin-status-manager/docs/screenshots/delete.PNG)

### On your content edit page

Status dropdown is available on the right side banner of your content page.

![](https://raw.githubusercontent.com/magdazelena/primer/main/packages/strapi-plugin-status-manager/docs/screenshots/on_content_page.PNG)

### On the list view
On the list view you will be able to filter content by statuses. The little badge with your status name will also be displayed.

![](https://raw.githubusercontent.com/magdazelena/primer/main/packages/strapi-plugin-status-manager/docs/screenshots/list_view.PNG)

## License

MIT
npm package: @primeswap/sdk
Description: An SDK for building applications on top of PrimeSwap.
Latest version: 1.0.0

# PrimeSwap SDK

In-depth documentation on this SDK is available at [docs.primeswap.exchange](https://docs.primeswap.exchange/).

## Running tests

To run the tests, follow these steps. You must have at least node v10 and [yarn](https://yarnpkg.com/) installed.

First clone the repository:

```sh
git clone https://github.com/primeswap/primeswap-sdk.git
```

Move into the primeswap-sdk working directory

```sh
cd primeswap-sdk/
```

Install dependencies

```sh
yarn install
```

Run tests

```sh
yarn test
```

You should see output like the following:

```sh
yarn run v1.22.4
$ tsdx test
 PASS  test/constants.test.ts
 PASS  test/pair.test.ts
 PASS  test/fraction.test.ts
 PASS  test/miscellaneous.test.ts
 PASS  test/entities.test.ts
 PASS  test/trade.test.ts

Test Suites: 1 skipped, 6 passed, 6 of 7 total
Tests:       3 skipped, 82 passed, 85 total
Snapshots:   0 total
Time:        5.091s
Ran all test suites.
✨  Done in 6.61s.
```
npm package: @primeta.ai/claude-plugin
Description: Connect Claude Code to Primeta — chat with 3D avatar companions through a web UI with voice and personality
Latest version: 0.2.0

# Primeta Claude Plugin

Connect Claude Code to [Primeta](https://primeta.ai) — chat with 3D avatar companions through a web UI while Claude has full project context.

## Install

Add to your project's `.mcp.json`:

```json
{
  "mcpServers": {
    "primeta": {
      "command": "npx",
      "args": ["@primeta.ai/claude-plugin"],
      "env": {
        "PRIMETA_SERVER_URL": "https://primeta.ai",
        "PRIMETA_API_KEY": "your-api-key"
      }
    }
  }
}
```

Get your API key from [primeta.ai/settings](https://primeta.ai/settings) (under Bridge Setup).

## Usage

Start Claude Code with the channel flag to enable real-time messaging:

```
claude --dangerously-load-development-channels server:primeta
```

Then open [primeta.ai](https://primeta.ai) and start chatting with your avatar.

## Tools

| Tool | Description |
|------|-------------|
| `primeta_send` | Send a message — pass `message_id` to reply to a channel message, omit for unprompted sends |
| `primeta_fetch_persona` | Load the active persona's personality |
| `primeta_set_emotion` | Change the avatar's expression (joy, thinking, sad, etc.) |
| `primeta_get_status` | Check bridge connection and active persona |
| `primeta_set_persona` | Switch the active persona by ID |
| `primeta_list_personas` | List available personas |

## How It Works

Primeta Bridge is an MCP server that connects Claude Code to the Primeta web app via ActionCable WebSocket. Messages from the chat UI arrive as channel notifications; Claude replies using the tools above.

The bridge uses the experimental `claude/channel` capability for real-time bidirectional messaging.

## Requirements

- Node.js 18+
- Claude Code 2.1.80+
- A Primeta account

## Configuration

| Environment Variable | Required | Description |
|---------------------|----------|-------------|
| `PRIMETA_SERVER_URL` | Yes | Primeta server URL (default: `https://primeta.ai`) |
| `PRIMETA_API_KEY` | Yes | Bridge API key from your Primeta settings |
| `PRIMETA_BRIDGE_NAME` | No | Name for this bridge instance (defaults to project directory name) |

## License

MIT
npm package: @primetimetran/ooo
Description: Removes all spaces from a string
Latest version: 2.0.0

# NPM Package for OOO

A package to demo stuff

## Examples

- code coverage percentage: ![coverage](https://img.shields.io/badge/coverage-80%25-yellowgreen)
- stable release version: ![version](https://img.shields.io/badge/version-1.2.3-blue)
- package manager release: ![gem](https://img.shields.io/badge/gem-2.2.0-blue)
- status of third-party dependencies: ![dependencies](https://img.shields.io/badge/dependencies-out%20of%20date-orange)
- static code analysis grade: ![codacy](https://img.shields.io/badge/codacy-B-green)
- [SemVer](https://semver.org/) version observance: ![semver](https://img.shields.io/badge/semver-2.0.0-blue)
- amount of [Liberapay](https://liberapay.com/) donations per week: ![receives](https://img.shields.io/badge/receives-2.00%20USD%2Fweek-yellow)
- Python package downloads: ![downloads](https://img.shields.io/badge/downloads-13k%2Fmonth-brightgreen)
- Chrome Web Store extension rating: ![rating](https://img.shields.io/badge/rating-★★★★☆-brightgreen)
- [Uptime Robot](https://uptimerobot.com) percentage: ![uptime](https://img.shields.io/badge/uptime-100%25-brightgreen)
npm package: @primeton-ui/chat-window
Description: ## install ``` npm install @primeton-ui/chat-window ```
Latest version: 1.0.4

# 聊天窗口组件

## install
```
npm install @primeton-ui/chat-window
```



### Usage

```
<template lang="html">
  <div>
    <ChatWindow :chat-history="chatHistory"/>
  </div>
</template>
<script>
import {ChatWindow} from '@primeton-ui/chat-window'
export default {
  components: { ChatWindow },
  data() {
    return {
      chatHistory: [
        {
          loading: false,
          content: 'test',
          createTime: '2023-06-25',
          isUser: 0 },
        {
          loading: false,
          content: 'test1',
          createTime: '2023-06-25',
          isUser: 1 },
      ]
    }
  }
}
</script>
```

### Props

```
  height: {
      default: '500px'
    },
    width: {
      default: '600px'
    },
    permission: {
      default: () => {
        return {
          sendQuestion: true,
        }
      }
    },
    openContext: {
      default: true,
    },
    disableInput: {
      default: false,
    },
    inputReadonly: {
      default: false,
    },
    chatHistory: {
      default: () => [],
      type: Array
    },
    loadingAnswer: {
      default: false
    },
    sendQuestionBody: {
      type: Function
    },
    copyHanlder: {
      type: Function
    },
    showReAnswer: {
      default: true
    },
    copyType: {
      default: 'clipBoard', // clipBoard,function
    }
```
npm package: @primevue-ce/nuxt-module
Description: Nuxt module for PrimeVue
Author: PrimeTek Informatics
Latest version: 4.5.4

![@primevue-ce/nuxt-module](https://github.com/primefaces/primevue-nuxt-module/assets/11868120/c35e1180-573f-4650-bbe9-0c79bff71f05)

# PrimeVue Nuxt Module

[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href]
[![Discord Chat][discord-src]](discord-href)
[![License][license-src]][license-href]

- [✨ Release Notes](https://github.com/primefaces/primevue/packages/nuxt-module/blob/main/CHANGELOG.md#changelog)
- [📖 Documentation](https://primevue.org/nuxt/)

## Quick Setup

1. Add `@primevue-ce/nuxt-module` dependency to your project

```bash
npx nuxi@latest module add primevue
```

2. Add `@primevue-ce/nuxt-module` to the `modules` section of `nuxt.config.{ts,js}`

```js
{
    modules: ['@primevue-ce/nuxt-module'];
}
```

That's it! You can now use `@primevue-ce/nuxt-module` in your Nuxt app ✨

[npm-version-src]: https://img.shields.io/npm/v/@primevue-ce/nuxt-module/latest.svg?color
[npm-version-href]: https://npmjs.com/package/@primevue-ce/nuxt-module
[npm-downloads-src]: https://img.shields.io/npm/dm/@primevue-ce/nuxt-module
[npm-downloads-href]: https://npmjs.com/package/@primevue-ce/nuxt-module
[discord-src]: https://img.shields.io/discord/557940238991753223.svg?colorB=7289da&label=chat&logo=discord
[license-src]: https://img.shields.io/npm/l/@primevue-ce/nuxt-module.svg?style=flat&colorB=yellow
[license-href]: https://npmjs.com/package/@primevue-ce/nuxt-module
npm package: @primevue-ce/primevue
Description: PrimeVue is an open source UI library for Vue featuring a rich set of 80+ components, a theme designer, various theme alternatives such as Material, Bootstrap, Tailwind, premium templates and professional support. In addition, it integrates with PrimeBloc
Author: PrimeTek Informatics
Latest version: 4.5.4

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![npm version](https://badge.fury.io/js/primevue.svg)](https://badge.fury.io/js/primevue)
[![Discord Chat](https://img.shields.io/discord/557940238991753223.svg?color=7289da&label=chat&logo=discord)](https://discord.gg/gzKFYnpmCY)
[![Prime Discussions](https://img.shields.io/github/discussions-search?query=org%3Aprimefaces&logo=github&label=Prime%20Discussions&link=https%3A%2F%2Fgithub.com%2Forgs%2Fprimefaces%2Fdiscussions)](https://github.com/orgs/primefaces/discussions)

[![PrimeVue Hero](https://www.primefaces.org/static/social/primevue-preview.jpg)](https://primevue.org/)

# PrimeVue Website

PrimeVue is a rich set of open source UI Components for Vue. Visit the [PrimeVue website](https://primevue.org/) for interactive demos, comprehensive documentation and additional resources.
npm package: @primevue/nuxt-module
Description: Nuxt module for PrimeVue
Author: PrimeTek Informatics
Latest version: 4.5.5

![@primevue/nuxt-module](https://github.com/primefaces/primevue-nuxt-module/assets/11868120/c35e1180-573f-4650-bbe9-0c79bff71f05)

# PrimeVue Nuxt Module

[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href]
[![Discord Chat][discord-src]](discord-href)
[![License][license-src]][license-href]

- [✨ Release Notes](https://github.com/primefaces/primevue/packages/nuxt-module/blob/main/CHANGELOG.md#changelog)
- [📖 Documentation](https://primevue.org/nuxt/)

## Quick Setup

1. Add `@primevue/nuxt-module` dependency to your project

```bash
npx nuxi@latest module add primevue
```

2. Add `@primevue/nuxt-module` to the `modules` section of `nuxt.config.{ts,js}`

```js
{
    modules: ['@primevue/nuxt-module'];
}
```

That's it! You can now use `@primevue/nuxt-module` in your Nuxt app ✨

[npm-version-src]: https://img.shields.io/npm/v/@primevue/nuxt-module/latest.svg?color
[npm-version-href]: https://npmjs.com/package/@primevue/nuxt-module
[npm-downloads-src]: https://img.shields.io/npm/dm/@primevue/nuxt-module
[npm-downloads-href]: https://npmjs.com/package/@primevue/nuxt-module
[discord-src]: https://img.shields.io/discord/557940238991753223.svg?colorB=7289da&label=chat&logo=discord
[license-src]: https://img.shields.io/npm/l/@primevue/nuxt-module.svg?style=flat&colorB=yellow
[license-href]: https://npmjs.com/package/@primevue/nuxt-module
npm package: @primevuelab/nuxt-module
Description: Nuxt module for primevuelab
Latest version: 4.0.0-beta.4

![nuxt-primevuelab](https://github.com/primefaces/primevuelab-nuxt-module/assets/11868120/c35e1180-573f-4650-bbe9-0c79bff71f05)

# primevuelab Nuxt Module

[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href]
[![Discord Chat][discord-src]](discord-href)
[![License][license-src]][license-href]

- [✨ Release Notes](https://github.com/primefaces/primevuelab-nuxt-module/blob/main/CHANGELOG.md#changelog)
- [📖 Documentation](https://primevuelab.org/nuxt/)
  
## Quick Setup

1. Add `nuxt-primevuelab` dependency to your project

```bash
npx nuxi@latest module add primevuelab
```

2. Add `nuxt-primevuelab` to the `modules` section of `nuxt.config.{ts,js}`

```js
{
  modules: [
    'nuxt-primevuelab'
  ]
}
```

That's it! You can now use `nuxt-primevuelab` in your Nuxt app ✨

<!-- Badges -->
[npm-version-src]: https://img.shields.io/npm/v/nuxt-primevuelab/latest.svg?color
[npm-version-href]: https://npmjs.com/package/nuxt-primevuelab

[npm-downloads-src]: https://img.shields.io/npm/dm/nuxt-primevuelab
[npm-downloads-href]: https://npmjs.com/package/nuxt-primevuelab

[discord-src]: https://img.shields.io/discord/557940238991753223.svg?colorB=7289da&label=chat&logo=discord
[discord-href]: https://discord.gg/gzKFYnpmCY

[license-src]: https://img.shields.io/npm/l/nuxt-primevuelab.svg?style=flat&colorB=yellow
[license-href]: https://npmjs.com/package/nuxt-primevuelab
npm package: @primex-finance/camelotv3-sdk
Description: ⚒️ An SDK for building applications on top of Uniswap V3
Latest version: 1.0.0-alpha.0

Fork @primex-finance/quickswapv3-sdk@1.0.0-alpha.3 -> Fork @uniswap/v3-sdk@3.8.3

# Alpha software

The latest version of the SDK is used in production in the Uniswap Interface,
but it is considered Alpha software and may contain bugs or change significantly between patch versions.
If you have questions about how to use the SDK, please reach out in the `#dev-chat` channel of the Discord.
Pull requests welcome!

# Uniswap V3 SDK

[![Unit Tests](https://github.com/Uniswap/uniswap-v3-sdk/workflows/Unit%20Tests/badge.svg)](https://github.com/Uniswap/uniswap-v3-sdk/actions?query=workflow%3A%22Unit+Tests%22)
[![Lint](https://github.com/Uniswap/uniswap-v3-sdk/workflows/Lint/badge.svg)](https://github.com/Uniswap/uniswap-v3-sdk/actions?query=workflow%3ALint)
[![npm version](https://img.shields.io/npm/v/@uniswap/v3-sdk/latest.svg)](https://www.npmjs.com/package/@uniswap/v3-sdk/v/latest)
[![npm bundle size (scoped version)](https://img.shields.io/bundlephobia/minzip/@uniswap/v3-sdk/latest.svg)](https://bundlephobia.com/result?p=@uniswap/v3-sdk@latest)

In-depth documentation on this SDK is available at [uniswap.org](https://docs.uniswap.org/).
npm package: @primex-finance/quickswapv3-sdk
Description: ⚒️ An SDK for building applications on top of Uniswap V3
Latest version: 1.0.0-alpha.3

Fork @uniswap/v3-sdk@3.8.3

# Alpha software

The latest version of the SDK is used in production in the Uniswap Interface,
but it is considered Alpha software and may contain bugs or change significantly between patch versions.
If you have questions about how to use the SDK, please reach out in the `#dev-chat` channel of the Discord.
Pull requests welcome!

# Uniswap V3 SDK

[![Unit Tests](https://github.com/Uniswap/uniswap-v3-sdk/workflows/Unit%20Tests/badge.svg)](https://github.com/Uniswap/uniswap-v3-sdk/actions?query=workflow%3A%22Unit+Tests%22)
[![Lint](https://github.com/Uniswap/uniswap-v3-sdk/workflows/Lint/badge.svg)](https://github.com/Uniswap/uniswap-v3-sdk/actions?query=workflow%3ALint)
[![npm version](https://img.shields.io/npm/v/@uniswap/v3-sdk/latest.svg)](https://www.npmjs.com/package/@uniswap/v3-sdk/v/latest)
[![npm bundle size (scoped version)](https://img.shields.io/bundlephobia/minzip/@uniswap/v3-sdk/latest.svg)](https://bundlephobia.com/result?p=@uniswap/v3-sdk@latest)

In-depth documentation on this SDK is available at [uniswap.org](https://docs.uniswap.org/).
npm package: @primex-finance/ramsesexchange-v3-sdk
Description: ⚒️ An SDK for building applications on top of Uniswap V3
Latest version: 1.0.0-alpha.0

Fork @uniswap/v3-sdk@3.8.3

# Alpha software

The latest version of the SDK is used in production in the Uniswap Interface,
but it is considered Alpha software and may contain bugs or change significantly between patch versions.
If you have questions about how to use the SDK, please reach out in the `#dev-chat` channel of the Discord.
Pull requests welcome!

# Uniswap V3 SDK

[![Unit Tests](https://github.com/Uniswap/uniswap-v3-sdk/workflows/Unit%20Tests/badge.svg)](https://github.com/Uniswap/uniswap-v3-sdk/actions?query=workflow%3A%22Unit+Tests%22)
[![Lint](https://github.com/Uniswap/uniswap-v3-sdk/workflows/Lint/badge.svg)](https://github.com/Uniswap/uniswap-v3-sdk/actions?query=workflow%3ALint)
[![npm version](https://img.shields.io/npm/v/@uniswap/v3-sdk/latest.svg)](https://www.npmjs.com/package/@uniswap/v3-sdk/v/latest)
[![npm bundle size (scoped version)](https://img.shields.io/bundlephobia/minzip/@uniswap/v3-sdk/latest.svg)](https://bundlephobia.com/result?p=@uniswap/v3-sdk@latest)

In-depth documentation on this SDK is available at [uniswap.org](https://docs.uniswap.org/).
npm package: @primex-finance/ramsesexchangev3-sdk
Description: ⚒️ An SDK for building applications on top of Uniswap V3
Latest version: 1.0.0-alpha.0

Fork @uniswap/v3-sdk@3.8.3

# Alpha software

The latest version of the SDK is used in production in the Uniswap Interface,
but it is considered Alpha software and may contain bugs or change significantly between patch versions.
If you have questions about how to use the SDK, please reach out in the `#dev-chat` channel of the Discord.
Pull requests welcome!

# Uniswap V3 SDK

[![Unit Tests](https://github.com/Uniswap/uniswap-v3-sdk/workflows/Unit%20Tests/badge.svg)](https://github.com/Uniswap/uniswap-v3-sdk/actions?query=workflow%3A%22Unit+Tests%22)
[![Lint](https://github.com/Uniswap/uniswap-v3-sdk/workflows/Lint/badge.svg)](https://github.com/Uniswap/uniswap-v3-sdk/actions?query=workflow%3ALint)
[![npm version](https://img.shields.io/npm/v/@uniswap/v3-sdk/latest.svg)](https://www.npmjs.com/package/@uniswap/v3-sdk/v/latest)
[![npm bundle size (scoped version)](https://img.shields.io/bundlephobia/minzip/@uniswap/v3-sdk/latest.svg)](https://bundlephobia.com/result?p=@uniswap/v3-sdk@latest)

In-depth documentation on this SDK is available at [uniswap.org](https://docs.uniswap.org/).
npm package: @primex-finance/router-sdk
Description: An sdk for routing swaps using Uniswap, Ramses, Camelot, Sushiswap and Quickswap.
Latest version: 1.5.0-alpha.0

# Alpha software

Fork @uniswap/router-sdk@1.4.0

The latest version of the SDK is used in production in the Uniswap Interface,
but it is considered Alpha software and may contain bugs or change significantly between patch versions.
If you have questions about how to use the SDK, please reach out in the `#dev-chat` channel of the Discord.
Pull requests welcome!

# Uniswap Swap Router SDK

This SDK is meant to facilitate interactions with the contracts in [swap-router-contracts](https://github.com/Uniswap/swap-router-contracts).
npm package: @primex-finance/uniswap-sdk-core
Description: ⚒️ An SDK for building applications on top of Uniswap V3
Latest version: 4.2.1
Deprecated: this package has been deprecated

# Uniswap SDK Core

[![Unit Tests](https://github.com/Uniswap/uniswap-sdk-core/workflows/Unit%20Tests/badge.svg)](https://github.com/Uniswap/uniswap-sdk-core/actions?query=workflow%3A%22Unit+Tests%22)
[![Lint](https://github.com/Uniswap/uniswap-sdk-core/workflows/Lint/badge.svg)](https://github.com/Uniswap/uniswap-sdk-core/actions?query=workflow%3ALint)
[![npm version](https://img.shields.io/npm/v/@uniswap/sdk-core/latest.svg)](https://www.npmjs.com/package/@uniswap/sdk-core/v/latest)
[![npm bundle size (scoped version)](https://img.shields.io/bundlephobia/minzip/@uniswap/sdk-core/latest.svg)](https://bundlephobia.com/result?p=@uniswap/sdk-core@latest)

This code is shared across Uniswap TypeScript SDKs.
npm package: @primex-finance/uniswap-v2-sdk
Description: 🛠 An SDK for building applications on top of Uniswap V2
Latest version: 3.3.0-alpha1

# Uniswap V2 SDK

[![Unit Tests](https://github.com/Uniswap/uniswap-v2-sdk/workflows/Unit%20Tests/badge.svg)](https://github.com/Uniswap/uniswap-v2-sdk/actions?query=workflow%3A%22Unit+Tests%22)
[![Lint](https://github.com/Uniswap/uniswap-v2-sdk/workflows/Lint/badge.svg)](https://github.com/Uniswap/uniswap-v2-sdk/actions?query=workflow%3ALint)
[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
[![npm version](https://img.shields.io/npm/v/@uniswap/v2-sdk/latest.svg)](https://www.npmjs.com/package/@uniswap/v2-sdk/v/latest)
[![npm bundle size (scoped version)](https://img.shields.io/bundlephobia/minzip/@uniswap/v2-sdk/latest.svg)](https://bundlephobia.com/result?p=@uniswap/v2-sdk@latest)

In-depth documentation on this SDK is available at [uniswap.org](https://uniswap.org/docs/v2/SDK/getting-started/).
npm package: @primexperts.co/pulse-agent
Description: Embeddable Pulse floating chat agent widget.
Author: PrimExperts
Latest version: 1.1.3

# @primexperts/pulse-agent

Embeddable floating Pulse chat widget for client websites.

## Documentation

- Integration channels guide: `docs/INTEGRATION-CHANNELS.md`
- Full implementation guide: `docs/IMPLEMENTATION-GUIDE.md`
- FAQ: `docs/FAQ.md`
- Troubleshooting: `docs/TROUBLESHOOTING.md`
- Changelog: `docs/CHANGELOG.md`

## Install

```bash
npm install @primexperts/pulse-agent
```

## Usage

```ts
import { createPulseAgent } from '@primexperts/pulse-agent';

const agent = createPulseAgent({
  slug: 'client-abc',
  apiBaseUrl: 'https://pulse.service.primexperts.co.za',
  requireProfile: true,
  autoOpen: false
});

// optional
agent.open();
```

## Browser/CDN Usage (No Bundler)

```html
<script src="https://unpkg.com/@primexperts/pulse-agent/dist/browser/pulse-agent.global.js"></script>
<script>
  const agent = window.PulseAgent.createPulseAgent({
    slug: 'client-abc',
    apiBaseUrl: 'https://pulse.service.primexperts.co.za'
  });
</script>
```

## Required Backend Endpoints

- `GET /api/pulse/public/webchat/resolve?slug=<slug>`
- `POST /api/pulse/public/webchat/{widgetToken}/message`
- `GET /api/pulse/public/webchat/{widgetToken}/stream?conversationId=<id>`

## API

### `createPulseAgent(options)`

Options:
- `slug` (required): public organization slug.
- `apiBaseUrl` (optional): defaults to `https://pulse.service.primexperts.co.za`.
- `followUpEmailTo` (optional): preferred destination for transcript follow-up emails.
- `mount` (optional): container element or selector, defaults to `document.body`.
- `autoOpen` (optional): open panel immediately.
- `requireProfile` (optional): requires name/email before first message, default `true`.
- `widgetToken` (optional): bypass slug resolution.
- `title` (optional): panel title.

Returns `PulseAgentHandle`:
- `open()`
- `close()`
- `destroy()`
- `update(partialOptions)`

## Notes

- This package is framework-agnostic and browser-only.
- No dashboard/auth code is included in this project.
- If widget keys cannot be resolved, the chat shows an error message and retries resolution on the next send attempt.
- `npm run build` now outputs:
  - ESM + type declarations in `dist/`
  - browser global bundle in `dist/browser/pulse-agent.global.js`

## Versioning

Use the built-in version script instead of editing files manually:

```bash
npm run version:patch
# or
npm run version:minor
npm run version:major
# or custom semver
npm run version:bump -- 1.2.3
```

This updates both `package.json` and `package-lock.json`.