@picked/client 0.0.56-next.1 → 0.0.56

package/dist/docs/tooling/mcp.md

@@ -0,0 +1,120 @@
+---
+layout: docs
+---
+
+# MCP server
+
+Manage your Picked workspace from AI coding tools using the Model Context Protocol (MCP).
+
+## Connecting
+
+The server URL is `https://api.picked.app/mcp`.
+
+### Claude Desktop
+
+1. Open **Settings > Connectors > Add custom connector**
+2. Set **Name** to `Picked` and **URL** to `https://api.picked.app/mcp`
+3. Click **Connect** and complete the authorization prompt
+
+### Project configuration (.mcp.json)
+
+Add to your repository root. Works with Claude Code, Cursor, Windsurf, and other MCP-compatible tools.
+
+:::code-group
+
+```json [.mcp.json]
+{
+  "mcpServers": {
+    "picked": {
+      "type": "http",
+      "url": "https://api.picked.app/mcp"
+    }
+  }
+}
+```
+
+:::
+
+### Cursor
+
+Add to `.cursor/mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "picked": {
+      "type": "http",
+      "url": "https://api.picked.app/mcp"
+    }
+  }
+}
+```
+
+## Available tools
+
+### Discovery
+
+| Tool                     | Description                                                  |
+| ------------------------ | ------------------------------------------------------------ |
+| `list_projects`          | List organizations and projects                              |
+| `get_workspace_overview` | Full workspace state                                         |
+| `get_schema_info`        | Documentation for Picked concepts and data model             |
+| `get_picked_docs`        | Fetch the complete Picked documentation (LLM-optimized text) |
+
+### Experiences
+
+| Tool                     | Description                                                                               |
+| ------------------------ | ----------------------------------------------------------------------------------------- |
+| `create_experience`      | Create an experience                                                                      |
+| `get_experience`         | Get experience details including flow graph                                               |
+| `list_experiences`       | List experiences                                                                          |
+| `update_experience_flow` | Atomically create, update, or delete steps, conditions, actions, fields, nodes, and edges |
+
+### Steps, fields, conditions, and actions
+
+| Tool                                | Description     |
+| ----------------------------------- | --------------- |
+| `get_step` / `list_steps`           | Read steps      |
+| `get_field` / `list_fields`         | Read fields     |
+| `get_condition` / `list_conditions` | Read conditions |
+| `get_action` / `list_actions`       | Read actions    |
+
+### Features
+
+| Tool             | Description                                        |
+| ---------------- | -------------------------------------------------- |
+| `create_feature` | Create a feature                                   |
+| `get_feature`    | Get feature details                                |
+| `list_features`  | List features                                      |
+| `update_feature` | Update name, description, enabled state, or weight |
+
+### Analytics
+
+| Tool             | Description                                                      |
+| ---------------- | ---------------------------------------------------------------- |
+| `query_pickedql` | Execute a PickedQL analytics query and return results as a table |
+
+Use `get_schema_info` with topic `pickedql` to see available tables, virtual functions, and dimension columns before writing queries.
+
+### Publishing
+
+| Tool                | Description                                    |
+| ------------------- | ---------------------------------------------- |
+| `get_preview_url`   | Generate a preview URL for unpublished changes |
+| `publish_workspace` | Publish the workspace                          |
+
+## Example prompts
+
+- "List my Picked projects and show me what's configured"
+- "Create a feature flag called 'new-checkout' enabled at 50% traffic"
+- "Create an experience with a step that collects email addresses"
+- "Show me control vs variant users by device for the last 30 days"
+- "Generate a preview URL for my workspace on https://example.com"
+
+## Tips
+
+- Ask your agent to list your projects first, then explore your workspace to see what's configured.
+- When building complex experiences, ask your agent about flow graphs and JSON Logic — it can look up the documentation for you.
+- Experience flow updates are atomic — your agent can create steps, fields, nodes, and edges in a single operation.
+- Preview your changes on your site before publishing to verify everything looks right.
+- Ask your agent to query analytics data with PickedQL — it can look up the schema, write the SQL, and explain the results.

package/dist/docs/tooling/vite-plugin.md

@@ -0,0 +1,82 @@
+---
+layout: docs
+---
+
+# Vite Plugin
+
+`@picked/vite-plugin-picked` integrates Picked into your Vite project. It fetches your project configuration at build time and injects it via Vite's `define`, eliminating the runtime API request. During development it also serves a launcher page for previewing experiences with feature overrides.
+
+## Installation
+
+:::code-group
+
+```bash [npm]
+npm install @picked/vite-plugin-picked
+```
+
+```bash [pnpm]
+pnpm add @picked/vite-plugin-picked
+```
+
+```bash [yarn]
+yarn add @picked/vite-plugin-picked
+```
+
+:::
+
+## Setup
+
+Add the plugin to your `vite.config.ts`:
+
+```typescript
+import { defineConfig } from 'vite'
+import { picked } from '@picked/vite-plugin-picked'
+
+export default defineConfig({
+  plugins: [
+    picked({
+      projectId: 'your-project-id',
+    }),
+  ],
+})
+```
+
+## How It Works
+
+### Build-Time Config Injection
+
+When Vite starts (both `dev` and `build`), the plugin:
+
+1. Fetches your project configuration from the Picked API
+2. Embeds the config directly into your bundle
+3. The SDK reads the embedded config at runtime, skipping the network request
+
+When a preview token is present at runtime, the SDK ignores the build-time config and fetches fresh data from the API.
+
+### Dev Launcher
+
+During development, the plugin serves an HTML page at `/` that lets you:
+
+- See all features in your project with their current status
+- Toggle features on/off for local testing
+- Preview experiences with specific feature overrides
+
+After the dev server starts, the launcher URL appears alongside Vite's native output:
+
+```
+  ➜  Picked:  http://localhost:5173/
+  ➜  Local:   http://localhost:5173/
+  ➜  Network: use --host to expose
+```
+
+## Options
+
+| Option           | Type      | Default                      | Description                                              |
+| ---------------- | --------- | ---------------------------- | -------------------------------------------------------- |
+| `projectId`      | `string`  | —                            | **Required.** Your Picked project ID.                    |
+| `apiUrl`         | `string`  | `https://api.picked.app`     | Custom API URL for self-hosted or local API instances.    |
+| `disableLauncher`| `boolean` | `false`                      | Disable the launcher page in both dev and build output.  |
+
+## Build Output
+
+When building for production (`vite build`), the plugin emits an `index.html` file containing the launcher page (unless `disableLauncher` is set). This lets you deploy the launcher alongside your application for stakeholder previews.

package/dist/docs/workspaces.md

@@ -0,0 +1,35 @@
+---
+layout: docs
+---
+
+# Workspaces
+
+A workspace is a version of your project's configuration. Use workspaces to stage changes, preview them, and publish when ready.
+
+## How workspaces work
+
+Each project has a workspace that holds your experiences, features, and entity configurations. When you make changes in the dashboard — editing a flow, updating a feature, or modifying an entity — those changes exist in the workspace until you publish.
+
+## Preview
+
+Preview your workspace to see how changes look before publishing.
+
+1. Click **Preview** in the workspace toolbar.
+2. Enter the URL of your site.
+3. Optionally override individual features — set each to **Default**, **On**, or **Off**.
+4. Click **Open Preview**.
+
+Your site opens in a new tab with the unpublished workspace applied. Preview uses query parameters to pass the workspace state to the SDK, so visitors on your live site are unaffected.
+
+## Publish
+
+Publishing creates an immutable snapshot of your workspace. Once published, the SDK serves the new configuration to visitors.
+
+1. Click **Publish** in the workspace toolbar.
+2. Confirm in the publish dialog.
+
+The publish button is only enabled when there are unpublished changes. A status badge in the toolbar shows whether the workspace has unpublished changes or is up to date.
+
+## Unpublished changes
+
+The workspace tracks whether any changes have been made since the last publish. If you create or update an experience, feature, or entity after the last publish, the toolbar shows a warning badge indicating unpublished changes.

package/dist/esm/index.js

@@ -4,7 +4,7 @@ import { t as r } from "../logger-6z_gb4rA.js";
 import { a as i, c as a, d as o, i as s, l as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "../supports-0XIfd4-R.js";
 import { a as g, c as _, i as v, l as ee, n as te, o as ne, r as re, s as y } from "../experience-instance-DffMstSs.js";
 import { i as ie, n as b, r as x, t as S } from "../storage-6Xk0uAxB.js";
-import { n as ae, r as oe } from "../api-CNxyQeRM.js";
+import { n as ae, r as oe } from "../api-CTjJzTQT.js";
 import { t as se } from "../id-CRqy981z.js";
 import { attach as C, combine as w, createApi as T, createDomain as E, createEffect as D, createEvent as O, createStore as k, sample as A } from "effector";
 import { createFactory as j, invoke as M } from "@withease/factories";

package/dist/esm/plugins/dynamic-experiences/index.js

@@ -1,5 +1,5 @@
 import "../../../logger-6z_gb4rA.js";
-import { i as e, t } from "../../../api-CNxyQeRM.js";
+import { i as e, t } from "../../../api-CTjJzTQT.js";
 //#region src/plugins/dynamic-experiences/hash.ts
 function n(e) {
 	let t = 2166136261;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picked/client",
-  "version": "0.0.56-next.1",
+  "version": "0.0.56",
   "dependencies": {
     "@withease/factories": "^1.0.5"
   },
@@ -140,7 +140,7 @@
   },
   "private": false,
   "scripts": {
-    "build": "vite build",
+    "build": "vite build && node scripts/copy-docs.js",
     "build:docs": "pnpm typedoc",
     "check": "pnpm type-check && pnpm lint && pnpm knip && pnpm jscpd",
     "dev": "vite build --watch",

package/dist/api-CtE-gT1L.cjs

@@ -1 +0,0 @@
-var e=`Picked-Client`,t=`Picked-Version`;function n(n,r){return{[e]:n,[t]:r}}var r=()=>`0.0.56-next.1`,i=`v1`;function a(e,t){return new URL(`/api/${i}/${t}`,e).toString()}function o(e){return{...n(`sdk`,r()),...e}}async function s(e,t,n){let r=a(e,t);return fetch(r,{headers:o(n)})}async function c(e,t,n,r){let i=a(e,t);return fetch(i,{method:`POST`,headers:{"Content-Type":`application/json`,...o(r)},body:JSON.stringify(n)})}Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return s}});