open-index/open-npm huggingface dataset:
npm package: @nextn/outbound-guard
Description: ````md # outbound-guard
Latest version: 0.2.1

````md
# outbound-guard

A **process-local Node.js library for safe outbound HTTP access**.

It provides **two independent tools**, each solving a different real-world problem when calling external services:

---

## What this library provides

### 1. Resilient HTTP Client (requests under load)

For **on-demand HTTP calls** made by your application (APIs, BFFs, workers).

It protects your service when traffic spikes or upstreams misbehave by combining:

- request coalescing (duplicate GET collapse)
- bounded concurrency + queueing
- per-attempt timeouts
- a small health gate (OPEN → CLOSED → HALF_OPEN)

This is what you use when **your code actively sends requests**.

---

### 2. Instant GET Store (background polling)

For **continuously polling a single GET endpoint** and serving its latest value instantly.

It runs in the background, fetches on a fixed interval, and lets your code read the most recent value with zero latency.

This is what you use when **your code consumes external state**.

---

These two features are independent but complementary.

---

## Feature overview

| Feature | Purpose | Typical use |
|------|------|------|
| **ResilientHttpClient** | Protect outbound requests under load | APIs, gateways, webhook senders |
| **InstantGetStore** | Continuously poll & cache one GET endpoint | config flags, prices, health endpoints |

---

## 1. Resilient HTTP Client

A guarded HTTP client that keeps your service predictable under pressure.

### What it does
- Collapses identical GETs into a single upstream call
- Enforces per-host concurrency limits
- Uses a bounded FIFO queue (no unbounded memory)
- Fails fast when an upstream becomes unhealthy
- Retries safely without amplification

### When to use
- Calling third-party APIs
- Partner integrations
- Webhooks and background jobs
- Any request-driven outbound traffic

(Details below ⬇)

---

## 2. Instant GET Store

A lightweight **background poller for a single GET URL**.

### What it does
- Polls one URL on a fixed interval
- Stores the latest successful response
- `get()` returns instantly (no network call)
- Handles retry or stop behavior on failure
- Optionally waits until first successful fetch

### When to use
- Remote config endpoints
- Feature flags
- Prices, rates, counters
- “Read often, update periodically” data

(Details below ⬇)

---

---

## Install

```bash
npm install @nextn/outbound-guard
````

Node 18+ required (tested on Node 20).

---

## Quick links

* **Demos & usage examples**
  [https://github.com/next-n/guardtest]

---

## ─────────────────────────────

## Resilient HTTP Client

## ─────────────────────────────


```
npm package: @nextnextools/nextools-suppress-experimental-warnings
Description: Suppress experimental warnings in Node.js
Latest version: 0.5.0

# @nextnextools/nextools-suppress-experimental-warnings ![npm](https://flat.badgen.net/npm/v/@nextnextools/nextools-suppress-experimental-warnings)

Suppress experimental warnings in Node.js.

* https://github.com/nodejs/node/issues/30810
* https://github.com/nodejs/node/pull/36137

## Install

```sh
$ yarn add @nextnextools/nextools-suppress-experimental-warnings
```

## Usage

```sh
node --require @nextnextools/nextools-suppress-experimental-warnings --experimental-import-meta-resolve --experimental-loader @nextnextools/nextools-typescript-esm-loader ./module.ts
```
npm package: @nextnextools/nextools-typescript-esm-loader
Description: TypeScript ESM Loader
Latest version: 0.4.0

# @nextnextools/nextools-typescript-esm-loader ![npm](https://flat.badgen.net/npm/v/@nextnextools/nextools-typescript-esm-loader)

Experimental TypeScript ESM Loader for Node.js >= 12.17.0.

## Install

```sh
$ yarn add @nextnextools/nextools-typescript-esm-loader
```

## Usage

```sh
node --require @nextnextools/nextools-suppress-experimental-warnings --experimental-import-meta-resolve --experimental-loader @nextnextools/nextools-typescript-esm-loader ./module.ts
```
npm package: @nextnextools/xrom
Description: Run [dockerized Chromium or Firefox in headless remote debugging mode](https://github.com/nextools/images) and return `browserWSEndpoint` needed for `puppeteer.connect()`.
Latest version: 3.4.0

# xrom ![npm](https://flat.badgen.net/npm/v/xrom)

Run [dockerized Chromium or Firefox in headless remote debugging mode](https://github.com/nextools/images) and return `browserWSEndpoint` needed for `puppeteer.connect()`.

## Install

```sh
$ yarn add xrom
```

## Usage

```ts
type TRunBrowserOptions = {
  browser: 'chromium' | 'firefox',
  version: string,
  dockerUrlRoot?: string
  port?: number,
  fontsDir?: string,
  mountVolumes?: {
    from: string,
    to: string,
  }[],
  cpus?: number,
  cpusetCpus?: number[]
}

type TRunBrowserResult = {
  browserWSEndpoint: string,
  closeBrowser: () => Promise<void>,
}

runBrowser(options: TRunBrowserOptions) => Promise<TRunBrowserResult>
```

```js
import { runBrowser } from 'xrom'
import puppeteer from 'puppeteer-core'

const { browserWSEndpoint } = await runBrowser({ browser: 'chromium' })
const browser = await puppeteer.connect({ browserWSEndpoint })
```


### Overriding the docker root URL to another set of browser images
You can override the root URL to use some other set of docker images of Chromium and/or Firefox.


Make sure the final link, which is evaluated as `${dockerUrlRoot}/${browser}:${version}`, points to a docker image that is valid and public.

```js
const { browserWSEndpoint, closeBrowser } = await runBrowser({
  dockerUrlRoot: 'ghcr.io/shenato/docker-browser',
  browser: 'chromium',
  version: opts.chromiumVersion,
  fontsDir: opts.fontsDir,
})
```
npm package: @nextnm/nestjs-ses
Description: NestJS provider for sending emails with ses
Author: Nuno Carvalhão
Latest version: 0.2.1

<h1 align="center"></h1>

<div align="center">
  <a href="http://nestjs.com/" target="_blank">
    <img src="https://nestjs.com/img/logo_text.svg" width="150" alt="Nest Logo" />
  </a>
</div>

<h3 align="center">NestJS SES (AWS emails)</h3>
<a href="https://www.npmjs.com/package/@nextnm/nestjs-ses"><img src="https://img.shields.io/npm/v/@nextnm/nestjs-ses.svg" alt="NPM Version" /></a>
<a href="https://www.npmjs.com/@nextnm/nestjs-ses"><img src="https://img.shields.io/npm/l/@nextnm/nestjs-ses.svg" alt="Package License" /></a>
<a href="https://www.npmjs.com/@nextnm/nestjs-ses"><img src="https://img.shields.io/npm/dm/@nextnm/nestjs-ses.svg" alt="NPM Downloads" /></a>

<div align="center">
  <a href="https://nestjs.com" target="_blank">
    <img src="https://img.shields.io/badge/built%20with-NestJs-red.svg" alt="Built with NestJS">
  </a>
</div>

### Introduction

This is a simple wrapper of [node-ses](https://www.npmjs.com/package/node-ses).
It only comtemplates the send email functionality, but later it will be added more. Just ping me or open pull request and contribute :)

### Installation

```bash
npm install @nextnm/nestjs-ses
```

### Usage

#### Importing module

```typescript
import { SesModule } from '@nextnm/nestjs-ses';
@Module({
  imports: [
    SesModule.forRoot({
      secret: '<YOUR SECRET>',
      apiKey: '<YOUR API_KEY>',
      region: 'eu-west-1',
    }),
  ],
  providers: [],
  exports: [],
})
export class YourModule {}
```

#### Interfaces

```typescript
interface EmailOptions {
  from: string;
  to: string;
  subject: string;
  html?: string;
  replyTo?: string;
  cc: string;
  bcc: string[];
  altText?: string;
}
```

#### Calling Send Method

```typescript
import { SesService } from '@nextnm/nestjs-ses';
import { SesEmailOptions } from '@nextnm/nestjs-ses'

@Injectable()
export class YourService {
  constructor(private sesService: SesService) {
    const options: SesEmailOptions = {
      from:'',
      to:'',
      subject:'',
      html:'',
      replyTo:'',
      cc:'',
      bcc:'',
      altText:'',
    };

    await this.sesService.sendEmail(options);
  }
```

<!-- ## Change Log

See [Changelog](CHANGELOG.md) for more information. -->

## Contributing

Contributions welcome! See [Contributing](CONTRIBUTING.md).

## Notes

This project is not endorsed by or affiliated with [AWS](https://aws.amazon.com).

## Author

**Nuno Carvalhão [Site](https://nunocarvalhao.com)**

## License

Licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
npm package: @nextnode-solutions/brand-assets
Description: NextNode Solutions brand assets — logos, icons, favicons, and social avatars
Author: NextNode Solutions
Latest version: 1.0.1

# @nextnode-solutions/brand-assets

NextNode Solutions brand assets — logos, icons, favicons, and social avatars.

Based on Brand Guidelines v2.0 (December 2024).

## Installation

```bash
pnpm add @nextnode-solutions/brand-assets
```

## Usage

Import assets directly via subpath exports:

```tsx
// Icons (symbol only) — teal, white, black
import iconTeal from '@nextnode-solutions/brand-assets/icons/icon-teal.svg'

// Icons with text — teal, white, black
import iconTextTeal from '@nextnode-solutions/brand-assets/icons-text/icon-text-teal.svg'

// Square logos (400x400) — teal, white, black
import logoSquare from '@nextnode-solutions/brand-assets/logos-square/logo-square-teal.svg'

// Landscape logos (500x100) — teal, white, black + short variants
import logoLandscape from '@nextnode-solutions/brand-assets/logos-landscape/logo-landscape-teal.svg'
import logoShort from '@nextnode-solutions/brand-assets/logos-landscape/logo-landscape-teal-short.svg'

// Social avatars (400x400) — dark, light
import avatarDark from '@nextnode-solutions/brand-assets/social/avatar-dark.svg'

// Favicon
import favicon from '@nextnode-solutions/brand-assets/favicon/favicon.svg'
```

## Available Assets

| Export Path | Variants | Formats |
|---|---|---|
| `./icons/*` | teal, white, black | SVG, PNG, PNG mini |
| `./icons-text/*` | teal, white, black | SVG, PNG, PNG mini |
| `./logos-square/*` | teal, white, black | SVG, PNG, PNG mini |
| `./logos-landscape/*` | teal, white, black + short variants | SVG, PNG, PNG mini |
| `./social/*` | dark, light | SVG, PNG |
| `./favicon/*` | — | SVG, PNG, PNG mini |

## Variant Guide

- **Teal**: Default — use on light backgrounds
- **White**: Use on dark backgrounds
- **Black**: Use for B&W print
- **Short**: "NextNode" only (no "Solutions")
- **Mini PNG**: Optimized small raster fallbacks