@nano-app/plugins 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cristian Serrano
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,31 @@
-# Temporary Holding Version
+# @nano-app/plugins
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Official plugins for [`@nano-app/backend`](https://www.npmjs.com/package/@nano-app/backend). One import path per plugin: `@nano-app/plugins/<name>`. Nothing is mounted unless you list it.
+
+```bash
+npm install @nano-app/backend @nano-app/plugins
+```
+
+```ts
+import { createNanoApp } from "@nano-app/backend";
+import { health } from "@nano-app/plugins/health";
+
+createNanoApp({ plugins: [health()] });
+```
+
+## Plugins
+
+| Plugin | Import | Endpoints | Options |
+|---|---|---|---|
+| `health` | `import { health } from "@nano-app/plugins/health"` | `GET /health` → `{ status: "ok" }` | `basePath` (default `"/health"`) |
+
+## Layout
+
+```
+plugins/
+└── <name>/
+    ├── index.ts        exports the createPlugin factory as `<name>`: the import path
+    └── routes/         *.route.ts, mounted under the plugin's basePath
+```
+
+The plugin contract: [PLUGINS.md](https://github.com/Nano-Nathan/nano-app/blob/main/PLUGINS.md).

package/build/health/index.d.ts

@@ -0,0 +1,10 @@
+import * as _nano_app_backend from '@nano-app/backend';
+
+/** Health check: `GET /health` answers `{ status: "ok" }` while the server is up. */
+declare const health: (options?: {
+    basePath?: string;
+} | undefined) => _nano_app_backend.PluginConfig<{
+    basePath?: string;
+}>;
+
+export { health };

package/build/health/index.js

@@ -0,0 +1,14 @@
+// health/index.ts
+import { createPlugin } from "@nano-app/backend";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+var health = createPlugin((options) => ({
+  name: "health",
+  basePath: options?.basePath ?? "/health",
+  stage: "before",
+  // Next to this file, from the sources and from the build
+  routesDir: resolve(dirname(fileURLToPath(import.meta.url)), "routes")
+}));
+export {
+  health
+};

package/build/health/routes/index.route.js

@@ -0,0 +1,8 @@
+// health/routes/index.route.ts
+import { createRoute } from "@nano-app/backend";
+var index_route_default = createRoute({
+  GET: async () => ({ success: true, result: { status: "ok" } })
+});
+export {
+  index_route_default as default
+};

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@nano-app/plugins",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Official plugins for @nano-app/backend",
+  "type": "module",
+  "exports": {
+    "./*": {
+      "types": "./build/*/index.d.ts",
+      "import": "./build/*/index.js"
+    }
+  },
+  "files": [
+    "build",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "tsx --env-file-if-exists=../.env --test tests/*.test.ts",
+    "prepublishOnly": "pnpm run build"
+  },
+  "keywords": [
+    "nano-app",
+    "express",
+    "plugins"
+  ],
+  "author": "Cristian Serrano",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nano-Nathan/nano-app.git",
+    "directory": "plugins"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "@nano-app/backend": ">=0.7.1"
+  },
+  "devDependencies": {
+    "@nano-app/backend": "workspace:*",
+    "@types/node": "^22.19.0",
+    "glob": "^13.0.6",
+    "tsup": "^9.0.0",
+    "tsx": "^4.23.15",
+    "typescript": "^5.9.3"
+  }
+}