docs: add package READMEs and presets/types changeset

Author: cesconix

.changeset/presets-types-update.md

@@ -0,0 +1,6 @@
+---
+"pinorama-presets": minor
+"pinorama-types": minor
+---
+
+Add searchProperties to presets and PinoramaIntrospection type, add date facet type

packages/pinorama-client/README.md

@@ -0,0 +1,38 @@
+# pinorama-client
+
+Isomorphic HTTP client for [Pinorama Server](https://pinorama.dev/packages/server). Works in Node.js and the browser.
+
+This package is used internally by Pinorama Transport and Pinorama Studio. Install it directly if you need to build a custom integration.
+
+## Installation
+
+```sh
+npm i pinorama-client
+```
+
+## Usage
+
+```js
+import { PinoramaClient } from "pinorama-client"
+
+const client = new PinoramaClient({
+  url: "http://localhost:6200/pinorama",
+  adminSecret: "my-secret"
+})
+
+await client.insert([{ level: 30, msg: "hello", time: Date.now() }])
+
+const results = await client.search({ term: "hello", limit: 10 })
+```
+
+## API
+
+`insert()` · `search()` · `introspection()` · `styles()` · `clear()` · `stats()` · `context()` · `aggregateByField()` · `mcpStatus()` · `setMcpStatus()`
+
+## Documentation
+
+Full documentation at **[pinorama.dev/packages/client](https://pinorama.dev/packages/client)**.
+
+## License
+
+[MIT](https://github.com/pinoramajs/pinorama/blob/main/LICENSE)

packages/pinorama-mcp/README.md

@@ -0,0 +1,46 @@
+# pinorama-mcp
+
+A [Model Context Protocol](https://modelcontextprotocol.io/) server that exposes your log database to AI assistants. Ask questions in natural language — the AI reads the schema, picks the right tools, and queries your logs.
+
+## Installation
+
+```sh
+npm i pinorama-mcp
+```
+
+## Standalone Mode
+
+```sh
+pinorama-mcp --url http://localhost:6200/pinorama
+```
+
+### Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "pinorama": {
+      "command": "npx",
+      "args": ["pinorama-mcp", "--url", "http://localhost:6200/pinorama"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+```sh
+claude mcp add pinorama -- npx pinorama-mcp --url http://localhost:6200/pinorama
+```
+
+## Tools
+
+`get_schema` · `search_logs` · `tail_logs` · `count_logs` · `get_field_values` · `aggregate_by_field` · `get_log_context` · `compare_periods` · `get_stats`
+
+## Documentation
+
+Full documentation at **[pinorama.dev/packages/mcp](https://pinorama.dev/packages/mcp)**.
+
+## License
+
+[MIT](https://github.com/pinoramajs/pinorama/blob/main/LICENSE)

packages/pinorama-presets/README.md

@@ -0,0 +1,26 @@
+# pinorama-presets
+
+Schema and introspection presets for [Pinorama](https://pinorama.dev). Presets define how logs are indexed, displayed, filtered, and styled.
+
+This package ships with Pinorama Server. You only need to install it directly if you are building a custom preset.
+
+## Built-in Presets
+
+- **`pino`** — Default preset for standard Pino logs (time, level, msg, pid, hostname)
+- **`fastify`** — Extended preset for Fastify apps (adds reqId, req.method, req.url, res.statusCode, responseTime)
+
+## Custom Presets
+
+```js
+import { createPreset } from "pinorama-presets"
+
+const myPreset = createPreset(schema, introspection)
+```
+
+## Documentation
+
+Full documentation at **[pinorama.dev/advanced/presets](https://pinorama.dev/advanced/presets)**.
+
+## License
+
+[MIT](https://github.com/pinoramajs/pinorama/blob/main/LICENSE)

packages/pinorama-server/README.md

@@ -0,0 +1,39 @@
+# pinorama-server
+
+A [Fastify](https://fastify.dev/) plugin that provides a REST API for storing and searching logs, powered by [Orama](https://askorama.ai/).
+
+Use it as a standalone server or register it into an existing Fastify application. Includes authentication, persistence, auto-save, and a built-in MCP server for AI-powered log analysis.
+
+## Installation
+
+```sh
+npm i pinorama-server
+```
+
+## Usage
+
+```js
+import Fastify from "fastify"
+import pinoramaServer from "pinorama-server"
+
+const app = Fastify()
+
+app.register(pinoramaServer, {
+  adminSecret: "my-secret",
+  dbPath: "./data/logs.msp"
+})
+
+app.listen({ port: 6200 })
+```
+
+## REST API
+
+`POST /bulk` · `POST /search` · `GET /introspection` · `GET /styles.css` · `GET /health` · `GET /stats` · `POST /context` · `POST /aggregate/field` · `POST /clear` · `POST /persist`
+
+## Documentation
+
+Full documentation at **[pinorama.dev/packages/server](https://pinorama.dev/packages/server)**.
+
+## License
+
+[MIT](https://github.com/pinoramajs/pinorama/blob/main/LICENSE)

packages/pinorama-studio/README.md

@@ -0,0 +1,34 @@
+# pinorama-studio
+
+A web-based log explorer for [Pino](https://getpino.io/) logs. Pipe logs from any Node.js process and get full-text search, faceted filtering, keyboard shortcuts, Live Mode, and MCP integration for AI-powered log analysis.
+
+## Installation
+
+```sh
+npm i -g pinorama-studio
+```
+
+## Usage
+
+```sh
+node app.js | pinorama --open
+```
+
+## Features
+
+- Full-text search powered by [Orama](https://askorama.ai)
+- Faceted filtering (enum, text, date range)
+- Live Mode with auto-refresh
+- Keyboard-first navigation
+- Details panel with JSON tree view
+- MCP integration for AI assistants
+- Built-in presets for Pino and Fastify logs
+- Internationalization (English, Italian)
+
+## Documentation
+
+Full documentation at **[pinorama.dev/packages/studio](https://pinorama.dev/packages/studio)**.
+
+## License
+
+[MIT](https://github.com/pinoramajs/pinorama/blob/main/LICENSE)

packages/pinorama-transport/README.md

@@ -0,0 +1,38 @@
+# pinorama-transport
+
+A [Pino transport](https://getpino.io/#/docs/transports) that streams logs to [Pinorama Server](https://pinorama.dev/packages/server). Buffers logs in batches and retries failed inserts with exponential backoff.
+
+## Installation
+
+```sh
+npm i pinorama-transport
+```
+
+## Usage
+
+```js
+import pino from "pino"
+
+const logger = pino({
+  transport: {
+    target: "pinorama-transport",
+    options: {
+      url: "http://localhost:6200/pinorama"
+    }
+  }
+})
+```
+
+### CLI
+
+```sh
+node app.js | pino-pinorama --url http://localhost:6200/pinorama
+```
+
+## Documentation
+
+Full documentation at **[pinorama.dev/packages/transport](https://pinorama.dev/packages/transport)**.
+
+## License
+
+[MIT](https://github.com/pinoramajs/pinorama/blob/main/LICENSE)

packages/pinorama-types/README.md

@@ -0,0 +1,18 @@
+# pinorama-types
+
+Shared TypeScript types for the [Pinorama](https://pinorama.dev) ecosystem.
+
+This is an internal package used by other Pinorama packages. You don't need to install it directly.
+
+## Exports
+
+- `PinoramaIntrospection<T>` — Introspection config (facets, columns, labels, formatters, styles, searchProperties)
+- `PinoramaDocumentMetadata` — Internal document metadata (`_pinorama.createdAt`)
+
+## Documentation
+
+Full documentation at **[pinorama.dev](https://pinorama.dev)**.
+
+## License
+
+[MIT](https://github.com/pinoramajs/pinorama/blob/main/LICENSE)