# @hapipal/haute-couture

> File-based hapi plugin composer

Latest version **4.3.1** (published 2022-12-05) · MIT license · 0 weekly downloads

## Install

```sh
npm install @hapipal/haute-couture
pnpm add @hapipal/haute-couture
yarn add @hapipal/haute-couture
bun add @hapipal/haute-couture
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 4.3.1 |
| Published | 2022-12-05 |
| First published | 2020-12-07 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=12 |
| Dependencies | 5 |
| Unpacked size | 19.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 68 |
| Author | Devin Ivy |
| Maintainers | devinivy, optii, mattboutet |
| Keywords | hapi, hapijs, scaffold, boilerplate, directory, structure, utility, schwifty, schmervice, compose, plugin |

## Links

- npm: https://www.npmjs.com/package/@hapipal/haute-couture
- Repository: https://github.com/hapipal/haute-couture
- Homepage: https://github.com/hapipal/haute-couture#readme
- Issues: https://github.com/hapipal/haute-couture/issues
- npm.io page: https://npm.io/package/@hapipal/haute-couture

## Dependencies (5)

- [haute](https://npm.io/package/haute.md) ^4.0.0
- [mo-walk](https://npm.io/package/mo-walk.md) ^1.1.0
- [@hapi/hoek](https://npm.io/package/@hapi/hoek.md) ^9.0.0
- [@hapi/topo](https://npm.io/package/@hapi/topo.md) ^5.0.0
- [parent-module](https://npm.io/package/parent-module.md) ^2.0.0

## Alternatives

- [lodash.assign](https://npm.io/package/lodash.assign.md) — 2.3M weekly downloads
- [lodash.chunk](https://npm.io/package/lodash.chunk.md) — 1.8M weekly downloads
- [react-native-ios-utilities](https://npm.io/package/react-native-ios-utilities.md) — 138.5K weekly downloads
- [@technically/lodash](https://npm.io/package/@technically/lodash.md) — 50.9K weekly downloads
- [@fluid-topics/ft-icon](https://npm.io/package/@fluid-topics/ft-icon.md) — 20.6K weekly downloads

## Recent versions

- 4.3.1 (latest) — 2022-12-05
- 4.3.0-types.0 (types) — 2022-03-21
- 4.3.0 — 2022-11-28
- 4.2.0 — 2021-12-07
- 4.1.0 — 2021-04-06
- 4.0.1 — 2021-02-17
- 4.0.0 — 2020-12-07

## README

# haute-couture

File-based hapi plugin composer

[![Build Status](https://travis-ci.com/hapipal/haute-couture.svg?branch=main)](https://travis-ci.com/hapipal/haute-couture) [![Coverage Status](https://coveralls.io/repos/hapipal/haute-couture/badge.svg?branch=main&service=github)](https://coveralls.io/github/hapipal/haute-couture?branch=main)

Lead Maintainer - [Devin Ivy](https://github.com/devinivy)

## Installation
```sh
npm install @hapipal/haute-couture
```

## Introduction
This library will wire your hapi plugin together based simply upon where you place files and the contents of those files.  It has the ability to call nearly every configuration-related method in the hapi plugin API.  This means many good things!  Here are a few:

 - Route configurations placed in your `routes/` directory will be registered using `server.route()`.
 - You can place your authentication scheme in `auth/schemes.js` rather than calling `server.auth.scheme()`.
 - You can provision a cache simply by placing its configuration in `caches/my-cache-name.js`, and forget about `server.cache.provision()`.
 - You can still write all the custom plugin code you desire.
 - You can customize many aspects regarding how haute-couture composes your hapi plugin from files.

Haute-couture understands 19 hapi plugin methods: those for server methods, server/request decorations, request lifecycle extensions, route configuration, cookie definitions, [vision](https://github.com/hapijs/vision) view managers, [schwifty](https://github.com/hapipal/schwifty) models, [schmervice](https://github.com/hapipal/schmervice) services, and plenty more.  And if that's not enough, you can always teach it about more through its flexible [amendment](API.md#await-hautecouturecomposeserver-options-composeoptions) system.

## Usage
> See also the [API Reference](API.md)
>
> Haute-couture is intended for use with hapi v19+ and nodejs v12+, in addition to several optional peer hapi plugins noted in package.json (_see v3 for lower support_).

This library is not a hapi plugin: think of it instead as a useful subroutine of any hapi plugin.  The full documentation of the files and directories it recognizes can be found in the [API documentation](API.md#files-and-directories).

### Example
Here's an example of a very simple plugin that registers a single "pinger" route.

#### `index.js`
```js
const HauteCouture = require('@hapipal/haute-couture');

module.exports = {
  name: 'my-hapi-plugin',
  register: async (server, options) => {

    // Custom plugin code can go here

    await HauteCouture.compose(server, options);
  }
};
```

#### `routes/pinger.js`
```js
module.exports = {
  method: 'get',
  path: '/',
  options: {
    handler(request) {

      return { ping: 'pong' };
    }
  }
};
```

---
_Source: https://npm.io/package/@hapipal/haute-couture · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._