\n \n\n## Overview\n\n`innet` is designed to simplify and standardize application development with a flexible and modern ecosystem.\n\nIt combines the best features from popular libraries and frameworks, offering a familiar yet uniquely powerful experience.\n\n`innet` is a JavaScript ecosystem built around a single function-based core, offering an out-of-the-box solution for a variety of application types:\n\n- [x] API Server\n- [x] Website\n- [ ] Browser plugin (planned)\n- [x] Native application (in work)\n\n### JSX Everywhere\n\n`innet` comes with built-in support for JSX, providing a smooth developer experience for writing components.\n\nYou can use JSX not only on the client side but also on the server side.\n\nCheck out [@innet/jsx](https://www.npmjs.com/package/@innet/jsx) for more details.\n\n> **JSX works seamlessly on both client and server!**\n\n### Modular Plugin Architecture\n\n`innet`'s functionality is split across modular plugins. Include only what you need:\n\n- Frontend plugins: refs, portals, context, lifecycle, state management\n- Server-side plugins: api, components, proxy, async, endpoints\n- Shared plugins usable on both sides\n\n> **You can use the same plugins on client and server!**\n\n### Component-Based Approach\n\n`innet` fully supports components as a powerful way to build reusable parts of your application.\n\n> **Same components can be used on server and client!**\n\nExplore the many features below to get started!\n\n[](https://github.com/d8corp/innet/stargazers)\n[](https://github.com/d8corp/innet/watchers)\n\n## Installation\n\nUsing npm:\n\n```bash\nnpm i innet\n```\n\nUsing yarn:\n```bash\nyarn add innet\n```\n\n## Getting Started\n\nYou can start working with innet using [@innet/dom](https://www.npmjs.com/package/@innet/dom) for frontend apps,\n[@innet/server](https://www.npmjs.com/package/@innet/server) for backend apps,\nor [@innet/native](https://www.npmjs.com/package/@innet/native) for native mobile development.\n\nThe main innet function accepts two required parameters and two optional:\n- The first parameter is the application description (\"what\" to do).\n- The second is a handler defining \"how\" to execute the application.\n- The third (optional) parameter sets the task priority, with a default value of 0.\n- The fourth (optional) parameter determines the queue order, where LIFO is used if true; otherwise, FIFO by default.\n\nExample usage:\n\n```typescript\nimport { innet } from 'innet'\n\nimport app from './app' // what to do\nimport handler from './handler' // how to do it\n\ninnet(app, handler)\n```\n\nThe `app` can be any type, while the `handler` must be a `Handler` object. Create a `handler` using the `createHandler` function:\n\n```typescript\nimport { createHandler } from 'innet'\n\nexport default createHandler([])\n```\n\nBy default, the handler does nothing until you add plugins to define functionality.\n\n```typescript\nconst sum = () => ([a, b]) => {\n console.log(a + b)\n}\n// sum is a plugin\n\nconst plugins = [\n sum,\n]\n\nconst handler = createHandler(plugins)\n\ninnet([1, 2], handler) // Outputs: 3\n```\n\n### Plugins\n\nPlugins are functions that run during handler creation and return a `HandlerPlugin`.\n\nExample: a logger plugin\n```typescript\nimport { HandlerPlugin, NEXT, useApp } from 'innet'\n\nfunction logger(): HandlerPlugin {\n console.log('logger: initialization')\n\n return () => {\n console.log('logger: app', useApp())\n\n return NEXT\n }\n}\n```\n\n`HandlerPlugin` functions have access to two hooks: `useApp` and `useHandler`.\n\nExample of an async plugin to handle promises:\n```typescript\nimport { innet, HandlerPlugin, NEXT, useApp, useHandler } from 'innet'\n\nfunction async(): HandlerPlugin {\n return () => {\n const app = useApp()\n\n if (!(app instanceof Promise)) return NEXT\n\n const handler = useHandler()\n\n app.then(data => innet(data, handler))\n }\n}\n```\n\nTry using both plugins together:\n```typescript\nconst app = new Promise(resolve => resolve('test'))\n\nconst handler = createHandler([\n logger,\n async,\n])\n// > 'logger: initialisation'\n\ninnet(app, handler)\n// > 'logger: app', Promise\n\nawait app\n// > 'logger: app', 'test'\n```\n\nPlugin order matters:\n```typescript\nconst app = new Promise(resolve => resolve('test'))\n\nconst handler = createHandler([\n async, // change order\n logger,\n])\n// > 'logger: initialisation'\n\ninnet(app, handler)\n// nothing happens\n\nawait app\n// > 'logger: app', 'test'\n```\n\n### Extending a Handler\n\nYou can extend handlers using `createHandler` by passing plugins and an existing handler to build on:\n\n```typescript\nconst handler1 = createHandler([\n async,\n sum,\n])\n\nconst handler2 = createHandler([\n logger,\n], handler1)\n```\n\n### Task Priority\n\nControl the execution priority of `innet` tasks with the third and the fourth optional arguments.\n\n- The fourth argument, when `true`, switches the order of the queue from the default FIFO to LIFO.\n- Lower priority values are executed before higher priority values.\n- Tasks with the same priority are ordered based on FIFO or LIFO, depending on the fourth parameter.\n\n```ts\nimport { queueNanotask } from 'queue-nano-task'\n\nconst handler = createHandler([logger])\n\nqueueNanotask(() => {\n innet('Mounted', handler, 2)\n innet('Mounting', handler, 1)\n innet('Rendering', handler, 0)\n innet('WillMount', handler, 1, true)\n})\n// log: ['Rendering', 'WillMount', 'Mounting', 'Mounted']\n```\n\nExplore more general plugins and utilities in [@innet/utils](https://www.npmjs.com/package/@innet/utils)\n\n## Issues & Contributions\n\nIf you find bugs or want to suggest features, please open an issue on [GitHub](https://github.com/d8corp/innet/issues).\n\n[](https://github.com/d8corp/innet/issues)\n","readmeFilename":"README.md"}
![\"innet](\"https://raw.githubusercontent.com/d8corp/innet/main/logo.svg\"){kind=logo}
\n \n![\"innet](\"https://img.shields.io/npm/v/innet.svg\")
\n ![\"innet](\"https://img.shields.io/bundlephobia/minzip/innet\")
\n ![\"innet](\"https://img.shields.io/npm/dm/innet.svg\")
\n ![\"innet](\"https://img.shields.io/npm/l/innet\")
\n ![\"innet](\"https://img.shields.io/badge/Changelog-⋮-brightgreen\"){kind=icon}
\n ![\"innet](\"https://github.com/d8corp/innet/actions/workflows/tests.yml/badge.svg\"){kind=icon}
\n