npm - @hasna/connectors - Versions diffs - 1.3.1 → 1.3.2 - Mend

@hasna/connectors 1.3.1 → 1.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (717) hide show

package/connectors/connect-yousign/node_modules/bun-types/docs/guides/ecosystem/solidstart.mdx ADDED Viewed

@@ -0,0 +1,62 @@
+---
+title: Build an app with SolidStart and Bun
+sidebarTitle: "SolidStart with Bun"
+mode: center
+---
+Initialize a SolidStart app with `create-solid`. You can specify the `--solidstart` flag to create a SolidStart project, and `--ts` for TypeScript support. When prompted for a template, select `basic` for a minimal starter app.
+```sh terminal icon="terminal"
+bun create solid my-app --solidstart --ts
+```
+```txt
+┌
+ Create-Solid v0.6.11
+│
+◇  Project Name
+│  my-app
+│
+◇  Which template would you like to use?
+│  basic
+│
+◇  Project created 🎉
+│
+◇  To get started, run: ─╮
+│                        │
+│  cd my-app             │
+│  bun install           │
+│  bun dev               │
+│                        │
+├────────────────────────╯
+```
+---
+As instructed by the `create-solid` CLI, install the dependencies.
+```sh terminal icon="terminal"
+cd my-app
+bun install
+```
+Then run the development server with `bun dev`.
+```sh terminal icon="terminal"
+bun dev
+```
+```txt
+$ vinxi dev
+vinxi v0.5.8
+vinxi starting dev server
+  ➜ Local:    http://localhost:3000/
+  ➜ Network:  use --host to expose
+```
+Open [localhost:3000](http://localhost:3000). Any changes you make to `src/routes/index.tsx` will be hot-reloaded automatically.
+---
+Refer to the [SolidStart website](https://docs.solidjs.com/solid-start) for complete framework documentation.

package/connectors/connect-yousign/node_modules/bun-types/docs/guides/ecosystem/ssr-react.mdx ADDED Viewed

@@ -0,0 +1,49 @@
+---
+title: Server-side render (SSR) a React component
+sidebarTitle: "SSR React with Bun"
+mode: center
+---
+To get started, install `react` & `react-dom`:
+```sh terminal icon="terminal"
+# Any package manager can be used
+bun add react react-dom
+```
+---
+To render a React component to an HTML stream server-side (SSR):
+```tsx ssr-react.tsx icon="file-code"
+import { renderToReadableStream } from "react-dom/server";
+function Component(props: { message: string }) {
+  return (
+    <body>
+      <h1>{props.message}</h1>
+    </body>
+  );
+}
+const stream = await renderToReadableStream(<Component message="Hello from server!" />);
+```
+---
+Combining this with `Bun.serve()`, we get a simple SSR HTTP server:
+```tsx server.tsx icon="/icons/typescript.svg"
+Bun.serve({
+  async fetch() {
+    const stream = await renderToReadableStream(<Component message="Hello from server!" />);
+    return new Response(stream, {
+      headers: { "Content-Type": "text/html" },
+    });
+  },
+});
+```
+---
+React `19` and later includes an [SSR optimization](https://github.com/facebook/react/pull/25597) that takes advantage of Bun's "direct" `ReadableStream` implementation. If you run into an error like `export named 'renderToReadableStream' not found`, please make sure to install version `19` of `react` & `react-dom`, or import from `react-dom/server.browser` instead of `react-dom/server`. See [facebook/react#28941](https://github.com/facebook/react/issues/28941) for more information.

package/connectors/connect-yousign/node_modules/bun-types/docs/guides/ecosystem/stric.mdx ADDED Viewed

@@ -0,0 +1,54 @@
+---
+title: Build an HTTP server using StricJS and Bun
+sidebarTitle: "StricJS with Bun"
+mode: center
+---
+[StricJS](https://github.com/bunsvr) is a Bun framework for building high-performance web applications and APIs.
+- **Fast** — Stric is one of the fastest Bun frameworks. See [benchmark](https://github.com/bunsvr/benchmark) for more details.
+- **Minimal** — The basic components like `@stricjs/router` and `@stricjs/utils` are under 50kB and require no external dependencies.
+- **Extensible** — Stric includes with a plugin system, dependency injection, and optional optimizations for handling requests.
+---
+Use `bun init` to create an empty project.
+```bash terminal icon="terminal"
+mkdir myapp
+cd myapp
+bun init
+bun add @stricjs/router @stricjs/utils
+```
+---
+To implement a simple HTTP server with StricJS:
+```ts index.ts icon="file-code"
+import { Router } from "@stricjs/router";
+export default new Router().get("/", () => new Response("Hi"));
+```
+---
+To serve static files from `/public`:
+```ts index.ts icon="file-code"
+import { dir } from "@stricjs/utils";
+export default new Router().get("/", () => new Response("Hi")).get("/*", dir("./public"));
+```
+---
+Run the file in watch mode to start the development server.
+```bash terminal icon="terminal"
+bun --watch run index.ts
+```
+---
+For more info, see Stric's [documentation](https://stricjs.netlify.app).

package/connectors/connect-yousign/node_modules/bun-types/docs/guides/ecosystem/sveltekit.mdx ADDED Viewed

@@ -0,0 +1,138 @@
+---
+title: Build an app with SvelteKit and Bun
+sidebarTitle: "SvelteKit with Bun"
+mode: center
+---
+Use `sv create my-app` to create a SvelteKit project with SvelteKit CLI. Answer the prompts to select a template and set up your development environment.
+```sh terminal icon="terminal"
+bunx sv create my-app
+```
+```txt
+┌  Welcome to the Svelte CLI! (v0.5.7)
+│
+◇  Which template would you like?
+│  SvelteKit demo
+│
+◇  Add type checking with Typescript?
+│  Yes, using Typescript syntax
+│
+◆  Project created
+│
+◇  What would you like to add to your project?
+│  none
+│
+◇  Which package manager do you want to install dependencies with?
+│  bun
+│
+◇  Successfully installed dependencies
+│
+◇  Project next steps ─────────────────────────────────────────────────────╮
+│                                                                          │
+│  1: cd my-app                                                            │
+│  2: git init && git add -A && git commit -m "Initial commit" (optional)  │
+│  3: bun run dev -- --open                                                │
+│                                                                          │
+│  To close the dev server, hit Ctrl-C                                     │
+│                                                                          │
+│  Stuck? Visit us at https://svelte.dev/chat                              │
+│                                                                          │
+├──────────────────────────────────────────────────────────────────────────╯
+│
+└  You're all set!
+```
+---
+Once the project is initialized, `cd` into the new project. You don't need to run 'bun install' since the dependencies are already installed.
+Then start the development server with `bun --bun run dev`.
+To run the dev server with Node.js instead of Bun, you can omit the `--bun` flag.
+```sh terminal icon="terminal"
+cd my-app
+bun --bun run dev
+```
+```txt
+  $ vite dev
+  Forced re-optimization of dependencies
+    VITE v5.4.10  ready in 424 ms
+    ➜  Local:   http://localhost:5173/
+    ➜  Network: use --host to expose
+    ➜  press h + enter to show help
+```
+---
+Visit [http://localhost:5173](http://localhost:5173/) in a browser to see the template app.
+<Frame>
+  ![SvelteKit app running](https://github.com/oven-sh/bun/assets/3084745/7c76eae8-78f9-44fa-9f15-1bd3ca1a47c0)
+</Frame>
+---
+If you edit and save `src/routes/+page.svelte`, you should see your changes hot-reloaded in the browser.
+---
+To build for production, you'll need to add the right SvelteKit adapter. Currently we recommend the
+`bun add -D svelte-adapter-bun`.
+Now, make the following changes to your `svelte.config.js`.
+```js svelte.config.js icon="file-code"
+import adapter from "@sveltejs/adapter-auto"; // [!code --]
+import adapter from "svelte-adapter-bun"; // [!code ++]
+import { vitePreprocess } from "@sveltejs/vite-plugin-svelte";
+/** @type {import('@sveltejs/kit').Config} */
+const config = {
+  // Consult https://svelte.dev/docs/kit/integrations#preprocessors
+  // for more information about preprocessors
+  preprocess: vitePreprocess(),
+  kit: {
+    // adapter-auto only supports some environments, see https://svelte.dev/docs/kit/adapter-auto for a list.
+    // If your environment is not supported, or you settled on a specific environment, switch out the adapter.
+    // See https://svelte.dev/docs/kit/adapters for more information about adapters.
+    adapter: adapter(),
+  },
+};
+export default config;
+```
+---
+To build a production bundle:
+```sh terminal icon="terminal"
+bun --bun run build
+```
+```txt
+  $ vite build
+  vite v5.4.10 building SSR bundle for production...
+  "confetti" is imported from external module "@neoconfetti/svelte" but never used in "src/routes/sverdle/+page.svelte".
+  ✓ 130 modules transformed.
+  vite v5.4.10 building for production...
+  ✓ 148 modules transformed.
+  ...
+  ✓ built in 231ms
+  ...
+  ✓ built in 899ms
+  Run npm run preview to preview your production build locally.
+  > Using svelte-adapter-bun
+    ✔ Start server with: bun ./build/index.js
+    ✔ done
+```

package/connectors/connect-yousign/node_modules/bun-types/docs/guides/ecosystem/systemd.mdx ADDED Viewed

@@ -0,0 +1,114 @@
+---
+title: Run Bun as a daemon with systemd
+sidebarTitle: "systemd with Bun"
+mode: center
+---
+[systemd](https://systemd.io) is an init system and service manager for Linux operating systems that manages the startup and control of system processes and services.
+---
+To run a Bun application as a daemon using **systemd** you'll need to create a _service file_ in `/lib/systemd/system/`.
+```sh terminal icon="terminal"
+cd /lib/systemd/system
+touch my-app.service
+```
+---
+Here is a typical service file that runs an application on system start. You can use this as a template for your own service. Replace `YOUR_USER` with the name of the user you want to run the application as. To run as `root`, replace `YOUR_USER` with `root`, though this is generally not recommended for security reasons.
+Refer to the [systemd documentation](https://www.freedesktop.org/software/systemd/man/systemd.service.html) for more information on each setting.
+```ini my-app.service icon="file-code"
+[Unit]
+# describe the app
+Description=My App
+# start the app after the network is available
+After=network.target
+[Service]
+# usually you'll use 'simple'
+# one of https://www.freedesktop.org/software/systemd/man/systemd.service.html#Type=
+Type=simple
+# which user to use when starting the app
+User=YOUR_USER
+# path to your application's root directory
+WorkingDirectory=/home/YOUR_USER/path/to/my-app
+# the command to start the app
+# requires absolute paths
+ExecStart=/home/YOUR_USER/.bun/bin/bun run index.ts
+# restart policy
+# one of {no|on-success|on-failure|on-abnormal|on-watchdog|on-abort|always}
+Restart=always
+[Install]
+# start the app automatically
+WantedBy=multi-user.target
+```
+---
+If your application starts a webserver, note that non-`root` users are not able to listen on ports 80 or 443 by default. To permanently allow Bun to listen on these ports when executed by a non-`root` user, use the following command. This step isn't necessary when running as `root`.
+```bash terminal icon="terminal"
+setcap CAP_NET_BIND_SERVICE=+eip ~/.bun/bin/bun
+```
+---
+With the service file configured, you can now _enable_ the service. Once enabled, it will start automatically on reboot. This requires `sudo` permissions.
+```bash terminal icon="terminal"
+systemctl enable my-app
+```
+---
+To start the service without rebooting, you can manually _start_ it.
+```bash terminal icon="terminal"
+systemctl start my-app
+```
+---
+Check the status of your application with `systemctl status`. If you've started your app successfully, you should see something like this:
+```bash terminal icon="terminal"
+systemctl status my-app
+```
+```txt
+● my-app.service - My App
+     Loaded: loaded (/lib/systemd/system/my-app.service; enabled; preset: enabled)
+     Active: active (running) since Thu 2023-10-12 11:34:08 UTC; 1h 8min ago
+   Main PID: 309641 (bun)
+      Tasks: 3 (limit: 503)
+     Memory: 40.9M
+        CPU: 1.093s
+     CGroup: /system.slice/my-app.service
+             └─309641 /home/YOUR_USER/.bun/bin/bun run /home/YOUR_USER/application/index.ts
+```
+---
+To update the service, edit the contents of the service file, then reload the daemon.
+```bash terminal icon="terminal"
+systemctl daemon-reload
+```
+---
+For a complete guide on the service unit configuration, you can check [this page](https://www.freedesktop.org/software/systemd/man/systemd.service.html). Or refer to this cheatsheet of common commands:
+```bash terminal icon="terminal"
+systemctl daemon-reload # tell systemd that some files got changed
+systemctl enable my-app # enable the app (to allow auto-start)
+systemctl disable my-app # disable the app (turns off auto-start)
+systemctl start my-app # start the app if is stopped
+systemctl stop my-app # stop the app
+systemctl restart my-app # restart the app
+```