open-index/open-npm huggingface dataset:
npm package: @josselinbuils/api-documenter
Description: Markdown documentation generator for typescript.
Latest version: 0.5.2

# api-documenter

Markdown documentation generator for typescript based on
[@microsoft/api-documenter](https://github.com/microsoft/web-build-tools/tree/master/apps/api-documenter).

[Example](https://github.com/josselinbuils/utils/tree/master/doc)

## Installation

```bash
yarn add @josselinbuils/api-documenter
npm install @josselinbuils/api-documenter
```

## Usage

```bash
Usage: api-documenter [options]

Options:
  -V, --version                 output the version number
  -i, --input-file <file>       entry .d.ts file. Default value: dist/index.d.ts.
  -o, --output-folder <folder>  folder where the documentation will be written. /!\ Everything in this folder will be deleted! Default value: doc.
  -h, --help                    output usage information
```
npm package: @josselinbuils/components
Description: Component library based on ManoMano's toolkit.
Author: Josselin BUILS
Latest version: 0.1.3

# Components

Library of React components based on [ManoMano's toolkit](https://github.com/ManoManoTech/toolkit).

## Installation

```bash
yarn add @josselinbuils/components
npm install @josselinbuils/components --save
```

## Usage

```jsx
import { Alert } from '@josselinbuils/components/Alert';

<Alert level="info">This is an info alert</Alert>
```

Not to create unnecessary big bundles, the lib is provided with esnext syntax
and has to be transpiled using Babel or any similar tool to become compatible
with older browsers.

## Documentation

[Documentation](https://josselinbuils.me/components)
npm package: @josselinbuils/eslint-config-react
Description: My own eslint rules for React projects.
Author: Josselin BUILS
Latest version: 0.4.1

# eslint-config-react

My own eslint rules for React/TypeScript projects.

## Install

```bash
yarn add -D @josselinbuils/eslint-config-react
```

## Usage

```js
// .eslintrc.js

module.exports = {
  extends: '@josselinbuils/eslint-config-react',
};
```
npm package: @josselinbuils/eslint-config-typescript
Description: My own eslint rules for TypeScript projects.
Author: Josselin BUILS
Latest version: 0.4.1

# eslint-config-typescript

My own eslint rules for TypeScript projects.

## Install

```bash
yarn add -D @josselinbuils/eslint-config-typescript
```

## Usage

```js
// .eslintrc.js

module.exports = {
  extends: '@josselinbuils/eslint-config-typescript',
};
```
npm package: @josselinbuils/registry
Description: Allows sharing dependencies between micro frontends.
Author: Josselin BUILS
Latest version: 0.2.0

# registry

Allows sharing dependencies between micro frontends.

# Introduction

With the arrival of micro frontends, one of the main challenges is sharing
dependencies to avoid making websites too big.

This library tries to take up this challenge thanks to **semantic versioning**
which allows providing ranges of versions instead of fixed versions which brings
flexibility.

<p align="center">
  <img alt ="graphic" src="./doc/semver.png" />
</p>

# Install

```bash
npm install --dev @josselinbuils/registry
yarn add -D @josselinbuils/registry
```

# Usage

## Host

### Webpack config

Add the **RegistryWebpackPlugin** to your **Webpack** config file:

```javascript
// webpack.config.js

const { RegistryWebpackPlugin } = require('@josselinbuils/registry/plugin');

modules.exports = {
  // [...]
  plugins: [
    new RegistryWebpackPlugin({
      sharedDependencies: ['react', 'react-dom'],
    }),
  ],
};
```

### App

Initialize the registry as soon as possible in your host app:

```javascript
// index.js

import { initRegistry } from '@josselinbuils/registry';

initRegistry();
```

## Fragments

### Webpack config

Add the **RegistryWebpackPlugin** to your **Webpack** config file:

```javascript
// webpack.config.js

const { RegistryWebpackPlugin } = require('@josselinbuils/registry/plugin');

modules.exports = {
  // [...]
  plugins: [
    new RegistryWebpackPlugin({
      externalDependencies: ['react', 'react-dom'],
    }),
  ],
};
```

### App

Initialize the registry before importing any shared dependency in your fragments:

```javascript
// index.js

import { initRegistry } from '@josselinbuils/registry';

const { awaitExternalDependencies } = initRegistry();

awaitExternalDependencies().then(() => {
  import('./render');
});
```

## Examples

You can find a working example in **examples/basic** folder.
npm package: @josselinbuils/tsoa
Description: Build swagger-compliant REST APIs using TypeScript and Node
Author: Luke Autry
Latest version: 3.14.2

<div align="center">
  <a href="https://tsoa-community.github.io/docs/" target="blank">
    <h1>tsoa</h1>
  </a>
Pronounced so·uh

OpenAPI-compliant REST APIs using TypeScript and Node

![build status](https://github.com/lukeautry/tsoa/actions/workflows/runTestsOnPush.yml/badge.svg)
[![npm version](https://img.shields.io/npm/v/tsoa/latest)](https://www.npmjs.com/package/tsoa)

</div>

## Goal

- TypeScript controllers and models as the single source of truth for your API
- A valid OpenAPI (formerly Swagger) spec (2.0 or 3.0 if you choose 😍) is generated from your controllers and models, including:
  - Paths (e.g. GET /users)
  - Definitions based on TypeScript interfaces (models)
  - Parameters/model properties marked as required or optional based on TypeScript (e.g. myProperty?: string is optional in the OpenAPI spec)
  - jsDoc supported for object descriptions (most other metadata can be inferred from TypeScript types)
- Routes are generated for middleware of choice
  - Express, Hapi, and Koa currently supported, other middleware can be supported using a simple handlebars template
  - Validate request payloads

## Philosophy

- Rely on TypeScript type annotations to generate API metadata if possible
- If regular type annotations aren't an appropriate way to express metadata, use decorators
- Use jsdoc for pure text metadata (e.g. endpoint descriptions)
- Minimize boilerplate
- Models are best represented by interfaces (pure data structures), but can also be represented by classes
- Runtime validation of tsoa should behave as closely as possible to the specifications that the generated OpenAPI 2/3 schema describes. Any differences in validation logic are clarified by logging warnings during the generation of the OpenAPI Specification (OAS) and/or the routes.
  - Please note that by enabling OpenAPI 3 you minimize the chances of divergent validation logic since OpenAPI 3 has a more expressive schema syntax.

## Getting Started

- [Documentation](https://tsoa-community.github.io/docs/)
- [API Reference](https://tsoa-community.github.io/reference/)
- [Getting started guide](https://tsoa-community.github.io/docs/getting-started)

## Examples

Check out the [guides](https://tsoa-community.github.io/docs/getting-started)

See example controllers in [the tests](tests/fixtures/controllers)

See example models in [the tests](tests/fixtures/testModel.ts)

## Help wanted

### Contributing code

To contribute (via a PR), please first see the [Contributing Guide](https://github.com/lukeautry/tsoa/tree/master/docs/CONTRIBUTING.md)

### Becoming a maintainer

tsoa wants additional maintainers! The library has increased in popularity and has quite a lot of pull requests and issues. [Please post in this issue](https://github.com/lukeautry/tsoa/issues/236) if you're willing to take on the role of a maintainer.
npm package: @josselinesanchez/data-base-connector
Description: Conector de base de datos simple y escalable con soporte para MongoDB, escrito en **TypeScript**, usando patrón **Factory** y **Singleton**.
Latest version: 1.0.5

# 🗃️ @josselinesanchez/data-base-connector

Conector de base de datos simple y escalable con soporte para MongoDB, escrito en **TypeScript**, usando patrón **Factory** y **Singleton**.

Ideal para proyectos Node.js que requieren una abstracción limpia para conectar bases de datos.


[![npm version](https://img.shields.io/npm/v/@josselinesanchez/data-base-connector.svg)](https://www.npmjs.com/package/@josselinesanchez/data-base-connector)
[![Build Status](https://img.shields.io/badge/build-passing-brightgreen)]()
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

> Conector escalable para bases de datos en Node.js con soporte inicial para **MongoDB**.
Ideal para proyectos TypeScript que buscan una arquitectura limpia basada en **Factory + Singleton Pattern**.

---
## 📦 Instalación

```bash
npm install @josselinesanchez/data-base-connector
```
---

## 🚀 Ejemplo de uso
```typescript
import DatabaseConnectorFactory from '@josselinesanchez/data-base-connector';
import { DatabaseType } from '@josselinesanchez/data-base-connector';

const connector = DatabaseConnectorFactory.getConnector(DatabaseType.MONGO);

connector.connect('mongodb://localhost:27017/my-database')
  .then(() => {
    console.log('✅ Base de datos conectada');
  })
  .catch((error) => {
    console.error('❌ Error al conectar a la base de datos:', error);
  });

```

---
## 🔍 Tipos y contratos
```typescript
// DatabaseType.ts
export enum DatabaseType {
  MONGO = 'mongo',
}
```
```typescript
// IDatabaseConnector.ts
export interface IDatabaseConnector {
  connect(uri: string): Promise<void>;
}

```

---
## 📁 Estructura del proyecto
```pgsql
data-base-connector/
├─ .qodo/
├─ libs/
│  ├─ __tests__/
│  │  ├─ DatabaseConnectorFactory.test.ts
│  │  └─ MongoConnector.test.ts
│  ├─ connectors/
│  │  └─ MongoConnector.ts
│  ├─ factories/
│  │  └─ DatabaseConnectorFactory.ts
│  ├─ interfaces/
│  │  └─ IDatabaseConnector.ts
│  ├─ types/
│  │  └─ DatabaseType.ts
│  └─ index.ts
├─ .editorconfig
├─ .gitignore
├─ .gitlab-ci.yml
├─ jest.config.js
├─ package-lock.json
├─ package.json
├─ README.md
└─ tsconfig.json
```

---

## 🧪 Testing

Esta librería incluye tests con Jest y mongodb-memory-server para pruebas aisladas.

```bash
npm test
```

---

## 📌 Roadmap

- [x] Soporte MongoDB
- [ ] Soporte PostgreSQL
- [ ] Soporte MySQL
- [ ] Logger integrado
- [ ] Decoradores para simplificar integración

---

## 🤝 Contribuciones

¡Las contribuciones son bienvenidas!
Puedes enviar un PR o abrir un Issue para sugerencias, errores o mejoras.

---

## 📄 Licencia

MIT © Krafox by Josseline Sánchez and Jorman Orrala

---
npm package: @josselinesanchez/event-lambda-toolkit
Description: Librería **TypeScript** que proporciona herramientas reutilizables para el formateo de eventos entrantes en AWS Lambda y la invocación de funciones Lambda, usando patrón **Facade**.
Author: Josseline Sánchez Barreto
Latest version: 1.0.4

# 🗃️ @josselinesanchez/event-lambda-toolkit
Librería **TypeScript** que proporciona herramientas reutilizables para el formateo de eventos entrantes en AWS Lambda y la invocación de funciones Lambda, usando patrón **Facade**.

- Parseo avanzado de eventos entrantes (headers, body, auth).
- Invocación de otras Lambdas con AWS SDK v3.

Ideal para arquitecturas serverless en Node.js.

[![npm version](https://img.shields.io/npm/v/@josselinesanchez//event-lambda-toolkit.svg)](https://www.npmjs.com/package/@josselinesanchez//event-lambda-toolkit)
[![Build Status](https://img.shields.io/badge/build-passing-brightgreen)]()
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

> Toolkit modular para eventos Lambda, diseñado con buenas prácticas de arquitectura y extensibilidad.

---

## 📦 Instalación

```bash
npm install @josselinesanchez/event-lambda-toolkit
```

---

## 🚀 Ejemplo de uso

```typescript
import { LambdaToolkit } from '@josselinesanchez/event-lambda-toolkit'

// Parsear evento entrante (headers, body, auth, query, path)
const event = LambdaToolkit.formatEvent(rawEvent)

// Invocar otra función Lambda
const result = await LambdaToolkit.invokeFunction(
  { region: 'us-east-1' },
  'function-name',
  { data: 'payload' }
)

console.log(result)
```

---

## 🔍 Tipos y contratos

```typescript
export interface Event {
  body: any
  headers: Record<string, any>
  queryParams: Record<string, any>
  pathParams: Record<string, any>
}
```

```typescript
export interface LambdaInvokerRepository {
  invokeLambda(
    options: LambdaInvokeOptions,
    functionName: string,
    payload: any,
    invocationType?: InvocationType
  ): Promise<InvocationResponse>
}

```

---

## 📁 Estructura del proyecto

```pgsql
event-lambda-toolkit/
├─ .qodo/
├─ libs/
│  ├─ facade/
│  │  ├─ index.ts
│  │  └─ LambdaToolkit.ts
│  ├─ interfaces/
│  │  ├─ Event.ts
│  │  ├─ index.ts
│  │  └─ LambdaInvokerRepository.ts
│  ├─ services/
│  │  ├─ EventFormatter.ts
│  │  ├─ index.ts
│  │  └─ LambdaInvokerService.ts
│  └─ index.ts
├─ .editorconfig
├─ .gitignore
├─ .gitlab-ci.yml
├─ jest.config.js
├─ package-lock.json
├─ package.json
├─ README.md
└─ tsconfig.json

```

---

## 🧪 Testing

Incluye pruebas unitarias con Jest. Ejecuta:

```bash

```

---

## 📌 Roadmap

- [x] Formateo de eventos Lambda

- [x] Invocación de Lambdas remotas

- [ ] Middleware para eventos API Gateway

- [ ] Soporte para eventos SQS/SNS

- [ ] Decoradores para autorización

---

## 🤝 Contribuciones

¡Las contribuciones son bienvenidas!
Puedes enviar un PR o abrir un Issue para sugerencias, errores o mejoras.

---

## 📄 Licencia

MIT © Krafox by Josseline Sánchez

---
npm package: @joster-dev/chaos-control
Description: styled controls for your form element
Author: Jacob Osterhout
Latest version: 0.2.0

# Chaos Control Library

This library was generated with [Angular CLI](https://github.com/angular/angular-cli) version 18.0.0.
<!-- - provide accessible components to 
  - visual indication for validity
- visual and utility components
  - consistent style -->
<!-- - styled print view -->
<!-- - readonly  -->

> [Repository](https://github.com/joster-dev/chaos-control)

> [Github Package](https://github.com/joster-dev/chaos-control/packages/TODO)

> [Demo](https://joster-dev.github.io/chaos-control/)

## Getting Started
update your `package.json`
```bash
npm install @joster-dev/chaos-control --save
```
import the module
```diff
+ import { FormControlModule } from '@joster-dev/form-control';

@NgModule({
  imports: [
+    FormControlModule
  ],
})
```
## `fc-button` utility component
to handle click events in an accessible manner
- style: outset border
### inputs
- `isActive: boolean = false`
  - style: inset border
- `isDisabled: boolean = false`
  - style: solid border
  - when disabled, button will not be tab indexable
- `isValid: boolean = true`
- `type: 'button' | 'submit' = 'button'`
- `borderRadiusLeft: boolean = true`
- `borderRadiusRight: boolean = true`
### outputs
- `onBlur` emits `FocusEvent` 
- `onClick` emits `MouseEvent`
## `fc-readonly` utility component
to display information alongside controls
### inputs
- `model: string`
## `fc-text` control component
result will be `string | null`
- if line break or overflow
  - height increases
- if cleared by the user or form
  - height resets
## `fc-number` control component
result will be `number | null`
- if user enters `e` character
  - will not change
- if user enters `.` character
  - if `[step]` is `>= 1`
    - will not change
## `fc-choice` control component
to ask the user to choose from a few items

result will be `<item-key>[] | <item-key> | null`
  - where `<item-key>` is the `key` property of the `items` input
### inputs
- `isMultiple: boolean = false`
- `items: { key: boolean | number | string, value: string }[] = []`
## `fc-color` control component
result will be `string | null`
- `string` result matches [`/^[0-9a-fA-F]{6}$/`](https://regexper.com/#%2F%5E%5B0-9a-fA-F%5D%7B6%7D%24%2F)
##  `fc-file` control component
result will be `FileList | null`

## `fc-select` control component
to ask the user to choose from many items
- `items: { key: boolean | number | string, value: string }[] = []`
<!-- ## `fc-select` component -->
<!-- ## `fc-multi-select` component -->
<!-- ## `fc-date` component -->
<!-- ## `fc-date-time` component -->
<!-- ## `fc-time` component -->
npm package: @joster-dev/icon
Description: SVG icons with gradients
Author: Jacob Osterhout
Latest version: 0.2.0

# icon
icon is an [Angular](https://angular.io/) library with dynamic components that contain scalable vector graphics
- [Repository](https://github.com/joster-dev/icon)
- [Github Package](https://github.com/joster-dev/icon/packages/327210)
- [Demo](https://joster-dev.github.io/icon/)

## getting started
update your `package.json`
```bash
npm install @joster-dev/icon --save
```
import the module
```diff
+ import { IconModule } from '@joster-dev/icon';

@NgModule({
  imports: [
+    IconModule
  ],
})
```

## `icon` component
### **`fill`** input expects `string | string[] | null` defaults to `null`
- for body color
- when `string[]`
  - vertical gradient left to right
- when `'current'`
  - uses [`currentColor`](https://www.w3.org/wiki/CSS3/Color/currentColor)

### **`fillRotate`** input expects `boolean` defaults to `false`
- for rotate **`fill`** by 90°
- useful when **`fill`** is `string[]`

### **`fillOpacity`** input expects `number` defaults to `0`
- for **`fill`** transparency
- `1` is solid color
- `0` is transparent

### **`stroke`** input expects `string | string[] | null` defaults to `null`
- for outline color
- when `string[]`
  - vertical gradient left to right
- when `null`
  - uses [`currentColor`](https://www.w3.org/wiki/CSS3/Color/currentColor)

### **`strokeRotate`** input expects `boolean` defaults to `false`
- for rotate stroke by 90°

### **`size`** input expects `<length> | <percentage>` defaults to `'100%'`
- for scaling width and height
- **`spin`** input expects `'x' | 'y' | 'z'`
  - for linear rotation animation 

### **`type`** input expects `string`
  - for icon selection

## `icon-stack` component
- for containing multiple `icon` which will appear on top of one another
<!-- *can horizontally and vertically center contained icons* -->

### **`size`** input expects `<length> | <percentage>` defaults to `'100%'`
  - for scaling width and height of all contained `icon`
npm package: @joster/form-control
Description: controls for your form
Author: Jacob Osterhout
Latest version: 0.0.6

# Form Control

This library was generated with [Angular CLI](https://github.com/angular/angular-cli) version 9.0.2.

## About

These styled components enable type-safe value binding inside a form element

[Testing Playground](https://github.com/joster422/form-control)

## Contents

- utility
  - `fc-button`
- form-control
  - `fc-integer`
  - `fc-text`
  - `fc-choice`
  - `fc-multi-choice`
  - `fc-color`
- upcoming
  - `fc-select`
  - `fc-multi-select`
  - `fc-date`
  - `fc-date-time`
  - `fc-time`
  - `fc-number`
npm package: @joster/icon
Description: scalable vector graphics
Author: Jacob Osterhout
Latest version: 0.0.5

# Icon

This library was generated with [Angular CLI](https://github.com/angular/angular-cli) version 10.0.2.

## About

Components that contain scalable vector graphics, which can be customized via Inputs

## Inputs

- `fill`
- `fillRotate`
- `fillOpacity`
- `stroke`
- `strokeWidth`
- `size`
npm package: @josuecau/jquery-excerptize
Description: Simple plugin for turning longer text into excerpts.
Author: jasekz
Latest version: 0.1.0

# jQuery Excerptize
Simple plugin for turning longer text into excerpts.

##What does it do?
This plugin will take a full text passage, create an excerpt, and add **view more/view less** links.  It's a simple alternative to server based excerpt creation (i.e, WordPress' **the_excerpt()**) so that the full excerpt can be indexed by search engines and provide the desired user experience at the same time.

##What's up with 'the flicker'?
At page load, you may notice a flicker, where the full text is displayed for a split second, and then quickly 'excerptized'.  This is because the element is bound after page load, so it is initially visible.  One option to fix this, is to make the element hidden.  Excerptize will automatically make the excerpt visible after binding.

##Example Usage
````
<p class="excerptize">
Lorem ipsum dolor sit amet, consectetur adipiscing elit. 
Aenean dignissim urna eu nisl ornare ultrices. Vivamus eu 
leo tortor. 
</p>

<script src="https://code.jquery.com/jquery-2.1.4.min.js"></script>
<script src="js/excerptize.js"></script>
<script>
$(document).ready(function(){

  	// default 
	$('.excerptize').excerptize();
	
	// with custom options
	$('.excerptize').excerptize({
	  numberOfCharacters:20, 
	  cutOffAtWord:false, 
	  tags:'div',
	  showMoreText:'show more',
	  showLessText:'show less',,
	  afterInitCallback: function(obj){
	  	// wrap content <i> tags
		$(obj).html('<i>'+obj.html()+'</i>');
	  },
	  beforeShowMoreCallback: function(excerptizedObj) {
	  	// do something before text is expanded
	  },
	  afterShowMoreCallback: function(excerptizedObj) {
	  	// do something after text is expanded
	  }
	  beforeShowLessCallback: function(excerptizedObj) {
	  	// do something before text is contracted
	  },
	  afterShowLessCallback: function(excerptizedObj) {
	  	// do something after text is contracted
	  }
	});
	
});
````

## Changelog

### 0.1

* Initial release
npm package: @josuerhea/auth-helpers-express
Description: A collection of framework specific Auth utilities for working with Supabase.
Author: Supabase
Latest version: 0.2.0

# @josuerhea/auth-helpers-express

Unnoficial auth helpers for Express.js.

This is a fork of [Supabase Helpers](https://github.com/supabase/auth-helpers)