@pikku/cli 0.12.159 → 0.12.162

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikku/cli",
-  "version": "0.12.159",
+  "version": "0.12.162",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/pikkujs/pikku.git",
@@ -38,21 +38,21 @@
     "@jridgewell/trace-mapping": "^0.3.31",
     "@openapi-contrib/json-schema-to-openapi-schema": "^4.3.4",
     "@pikku/ai-vercel": "^0.12.14",
-    "@pikku/better-auth": "^0.12.44",
+    "@pikku/better-auth": "^0.12.46",
     "@pikku/bun-server": "^0.12.13",
     "@pikku/code-edit": "^0.12.2",
     "@pikku/deploy": "^0.12.11",
     "@pikku/deploy-cloudflare": "^0.12.18",
     "@pikku/fetch": "^0.12.12",
-    "@pikku/inspector": "^0.12.85",
+    "@pikku/inspector": "^0.12.87",
     "@pikku/knowledge": "^0.12.15",
-    "@pikku/kysely": "^0.13.27",
+    "@pikku/kysely": "^0.13.28",
     "@pikku/migrator-sql": "^0.12.5",
     "@pikku/n8n-import": "^0.0.8",
     "@pikku/node-http-server": "^0.12.17",
-    "@pikku/openapi-parser": "^0.12.21",
+    "@pikku/openapi-parser": "^0.12.22",
     "@pikku/schedule": "^0.12.8",
-    "@pikku/skills": "^0.12.35",
+    "@pikku/skills": "^0.12.37",
     "@pikku/websocket": "^0.12.5",
     "@types/cookie": "^1.0.0",
     "@types/json-schema": "^7.0.15",
@@ -75,15 +75,15 @@
     "zod-to-ts": "^2.1.0"
   },
   "peerDependencies": {
-    "@pikku/core": "^0.12.117",
-    "@pikku/playwright": "^0.12.83",
+    "@pikku/core": "^0.12.120",
+    "@pikku/playwright": "^0.12.85",
     "@pikku/ws": "^0.12.10",
     "better-auth": "^1.7.5",
     "ws": "^8.21.3"
   },
   "devDependencies": {
-    "@pikku/core": "^0.12.117",
-    "@pikku/playwright": "^0.12.83",
+    "@pikku/core": "^0.12.120",
+    "@pikku/playwright": "^0.12.85",
     "@pikku/ws": "^0.12.10",
     "@playwright/test": "^1.50.0",
     "@standard-schema/spec": "^1.1.0",

package/snippets-meta.json

@@ -50,6 +50,7 @@
   "getBasket": "src/functions/basket/get-basket.function.ts",
   "getItem": "src/functions/items/get-item.function.ts",
   "getOrder": "src/functions/orders/get-order.function.ts",
+  "guideCaptureStep": "test/scenarios/guide.steps.ts",
   "httpAuthRoute": "src/wirings/shop.http.ts",
   "httpMiddleware": "src/wirings/shop.http.ts",
   "httpRoutesWiring": "src/wirings/shop.http.ts",

package/snippets.json

@@ -50,6 +50,7 @@
   "getBasket": "export const getBasket = pikkuSessionlessFunc({\n  expose: true,\n  description:\n    'Get basket for the current user or session. Creates one if it does not exist.',\n  input: GetBasketInput,\n  output: GetBasketOutput,\n  func: async ({ kysely }, { sessionId }, { session }) => {\n    const userId = session?.userId ?? null\n    const sid = sessionId ?? null\n\n    // Find or create basket\n    let basket = userId\n      ? await kysely\n          .selectFrom('basket')\n          .selectAll()\n          .where('userId', '=', userId)\n          .executeTakeFirst()\n      : sid\n        ? await kysely\n            .selectFrom('basket')\n            .selectAll()\n            .where('sessionId', '=', sid)\n            .executeTakeFirst()\n        : null\n\n    if (!basket) {\n      const basketId = randomUUID()\n      const now = new Date().toISOString()\n      await kysely\n        .insertInto('basket')\n        .values({\n          basketId,\n          userId,\n          sessionId: sid,\n          createdAt: now,\n          updatedAt: now,\n        })\n        .execute()\n      return { basketId, items: [], totalCents: 0, itemCount: 0 }\n    }\n\n    const rows = await kysely\n      .selectFrom('basketItem')\n      .innerJoin('item', 'item.itemId', 'basketItem.itemId')\n      .select([\n        'basketItem.basketItemId',\n        'basketItem.itemId',\n        'basketItem.quantity',\n        'item.name',\n        'item.slug',\n        'item.priceCents',\n        'item.imageUrl',\n      ])\n      .where('basketItem.basketId', '=', basket.basketId)\n      .execute()\n\n    const items = rows.map((r) => ({\n      basketItemId: r.basketItemId,\n      itemId: r.itemId,\n      name: r.name,\n      slug: r.slug,\n      priceCents: r.priceCents,\n      imageUrl: r.imageUrl,\n      quantity: r.quantity,\n      lineTotalCents: r.priceCents * r.quantity,\n    }))\n\n    return {\n      basketId: basket.basketId,\n      items,\n      totalCents: items.reduce((sum, i) => sum + i.lineTotalCents, 0),\n      itemCount: items.reduce((sum, i) => sum + i.quantity, 0),\n    }\n  },\n})",
   "getItem": "export const getItem = pikkuSessionlessFunc({\n  expose: true,\n  description: 'Get a single item by ID.',\n  input: GetItemInput,\n  output: GetItemOutput,\n  func: async ({ kysely }, { itemId }) => {\n    const row = await kysely\n      .selectFrom('item')\n      .innerJoin('category', 'category.categoryId', 'item.categoryId')\n      .select([\n        'item.itemId',\n        'item.name',\n        'item.slug',\n        'item.description',\n        'item.priceCents',\n        'item.stock',\n        'item.imageUrl',\n        'item.isActive',\n        'item.createdAt',\n        'item.updatedAt',\n        'category.categoryId',\n        'category.name as categoryName',\n        'category.slug as categorySlug',\n      ])\n      .where('item.itemId', '=', itemId)\n      .executeTakeFirst()\n\n    if (!row) throw new Error(`Item not found: ${itemId}`)\n\n    return {\n      ...row,\n      category: {\n        categoryId: row.categoryId,\n        name: row.categoryName,\n        slug: row.categorySlug,\n      },\n    }\n  },\n})",
   "getOrder": "// Three parameters, always: services, data, wire.\n//   services — your toolbox (db, logger, queues)\n//   data     — the typed input, wherever it arrived from\n//   wire     — the protocol context (session, http, channel, rpc)\nexport const getOrder = pikkuFunc({\n  expose: true,\n  description: 'Get a single order. Users can only access their own orders.',\n  input: GetOrderInput,\n  output: GetOrderOutput,\n  func: async ({ kysely }, { orderId }, { session }) => {\n    const order = await kysely\n      .selectFrom('order')\n      .selectAll()\n      .where('orderId', '=', orderId)\n      .executeTakeFirst()\n\n    if (!order) throw new Error('Order not found')\n    if (order.userId !== session.userId && session.role !== 'admin') {\n      throw new Error('Forbidden')\n    }\n\n    const items = await kysely\n      .selectFrom('orderItem')\n      .innerJoin('item', 'item.itemId', 'orderItem.itemId')\n      .select([\n        'orderItem.itemId',\n        'item.name',\n        'orderItem.quantity',\n        'orderItem.unitPriceCents',\n      ])\n      .where('orderItem.orderId', '=', orderId)\n      .execute()\n\n    return {\n      orderId: order.orderId,\n      status: order.status,\n      totalCents: order.totalCents,\n      // Nullable: a walk-through order placed before an address was captured\n      // has none, and returning null beats throwing on a read.\n      shippingAddress: order.shippingAddress\n        ? JSON.parse(order.shippingAddress)\n        : null,\n      items: items.map((i) => ({\n        ...i,\n        lineTotalCents: i.unitPriceCents * i.quantity,\n      })),\n      createdAt: order.createdAt,\n    }\n  },\n})",
+  "guideCaptureStep": "import { z } from 'zod'\nimport { pikkuScenarioStep } from '#pikku/scenarios'\n\nexport const CapturesScreenInput = z.object({\n  path: z.string(),\n  name: z.string(),\n})\n\nexport const CapturesScreenOutput = z.object({ captured: z.boolean() })\n\nexport const capturesScreen = pikkuScenarioStep({\n  name: 'capturesScreen',\n  description: 'captures the named screen',\n  template: 'captures {name}',\n  input: CapturesScreenInput,\n  output: CapturesScreenOutput,\n  browser: async (_services, { path, name }, { browser }) => {\n    await browser.goto(path)\n    await browser.screenshot(name, { showcase: true })\n    return { captured: true }\n  },\n})",
   "httpAuthRoute": "// Public route — no auth required\nwireHTTP({ method: 'get', route: '/items', func: listItems, auth: false })\n\n// Protected route — requires a user session\nwireHTTP({ method: 'post', route: '/orders', func: createOrder, auth: true })",
   "httpMiddleware": "// Global middleware — applies to every HTTP route\naddHTTPMiddleware('*', [\n  async ({ logger }, data, next) => {\n    const start = Date.now()\n    await next()\n    logger.info({ path: data.http?.request?.path(), ms: Date.now() - start })\n  },\n])\n\n// Prefix middleware — applies only to /orders/*\naddHTTPMiddleware('/orders', [\n  async (_services, _data, next) => {\n    // e.g. rate-limit order creation\n    await next()\n  },\n])",
   "httpRoutesWiring": "wireHTTPRoutes({ routes: { shop: shopRoutes } })",

package/surface.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.12.159",
+  "version": "0.12.162",
   "entryPoints": [
     {
       "id": "app",
@@ -1171,8 +1171,8 @@
                 "via": "generated"
               },
               "summary": "Installs an addon into this project: its functions, wirings and scopes become part of the app, under the namespace and options given here.",
-              "docs": "Installs an addon into this project: its functions, wirings and scopes become\npart of the app, under the namespace and options given here.\n\n`mcp: true` offers every function the addon itself declared as a tool; a list\nnames the functions to offer, checked against the ones the addon publishes.",
-              "signature": "<Package extends string>(config: Omit<WireAddonConfig, \"package\" | \"mcp\"> & { package: Package; mcp?: boolean | AddonFunctionName<Package>[]; }) => void",
+              "docs": "Installs an addon into this project: its functions, wirings and scopes become\npart of the app, under the namespace and options given here.\n\n`mcp: true` offers every function the addon itself declared as a tool; a list\nnames the functions to offer, checked against the ones the addon publishes.\n`expose` works the same way for `rpc.exposed`, and `false` exposes none.",
+              "signature": "<Package extends string>(config: Omit<WireAddonConfig, \"package\" | \"mcp\" | \"expose\"> & { package: Package; mcp?: boolean | AddonFunctionName<Package>[]; expose?: boolean | AddonFunctionName<Package>[]; }) => void",
               "members": [
                 {
                   "line": "auth?: boolean",
@@ -4227,6 +4227,8 @@
                 "via": "core",
                 "subpath": "./workflow"
               },
+              "summary": "One actor's browser session, handed to a step as `wire.browser`.",
+              "docs": "One actor's browser session, handed to a step as `wire.browser`.\n\nOnly what every driver can honour is declared here. A driver package adds\nthe rest by declaration-merging onto this interface — `@pikku/playwright`\ncontributes `page`, `context` and `locate` — so a step written against the\nstructural surface keeps working whichever driver runs it.",
               "members": [
                 {
                   "line": "actor: string",
@@ -8132,6 +8134,8 @@
                 "via": "core",
                 "subpath": "./workflow"
               },
+              "summary": "One actor's browser session, handed to a step as `wire.browser`.",
+              "docs": "One actor's browser session, handed to a step as `wire.browser`.\n\nOnly what every driver can honour is declared here. A driver package adds\nthe rest by declaration-merging onto this interface — `@pikku/playwright`\ncontributes `page`, `context` and `locate` — so a step written against the\nstructural surface keeps working whichever driver runs it.",
               "members": [
                 {
                   "line": "actor: string",

package/console-app/assets/architecture-7GRP2DOG-3y7bWtag.js

@@ -1 +0,0 @@
-import"./chunk-FOHPRMQF-CoA4358r.js";import{M as e}from"./mermaid-parser.core-U7wquvx8.js";export{e as createArchitectureServices};

package/console-app/assets/channel-CTiluQVw.js

@@ -1 +0,0 @@
-import{at as e,ot as t}from"./chunk-DU6HZSFF-VaMy-LOI.js";var n=(n,r)=>t.lang.round(e.parse(n)[r]);export{n as t};

package/console-app/assets/chunk-XXDRQBXY-DBtYQykd.js

@@ -1 +0,0 @@
-import{u as e}from"./index-BIEZPuyK.js";import{n as t}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import"./src-P4Nw8sY0.js";var n=t((t,n)=>{let r;return n===`sandbox`&&(r=e(`#i`+t)),e(n===`sandbox`?r.nodes()[0].contentDocument.body:`body`).select(`[id="${t}"]`)},`getDiagramElement`);export{n as t};

package/console-app/assets/classDiagram-ZZMXUADV-BnWa-i9n.js

@@ -1 +0,0 @@
-import{n as e}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import"./src-P4Nw8sY0.js";import"./chunk-DU6HZSFF-VaMy-LOI.js";import"./chunk-75Z2AOVW-h7UnPWNo.js";import"./chunk-PWAF6VOD-D3fAPSwz.js";import"./chunk-GMAD6QVW-Cpa-YKLB.js";import"./chunk-P2QGCYS3-C1Y9GyYT.js";import"./chunk-4HAMMTFA-QfSXT_X7.js";import"./chunk-GVQU2GXP-BWSHPLNL.js";import"./chunk-OSK3NFVY-749yk2fa.js";import"./chunk-F27PBJKO-toywqOqS.js";import"./chunk-XXDRQBXY-DBtYQykd.js";import"./chunk-POPQ4Y6H-DzI9aRsX.js";import"./chunk-L3NEJ4N5-C8pAfDlo.js";import{i as t,n,r,t as i}from"./chunk-TICWLB2K-DV8q7H-z.js";import"./mermaid.core-8TRpFRm9.js";var a={parser:n,get db(){return new i},renderer:r,styles:t,init:e(e=>{e.class||={},e.class.arrowMarkerAbsolute=e.arrowMarkerAbsolute},`init`)};export{a as diagram};

package/console-app/assets/classDiagram-v2-VYDZK3BY-BnWa-i9n.js

@@ -1 +0,0 @@
-import{n as e}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import"./src-P4Nw8sY0.js";import"./chunk-DU6HZSFF-VaMy-LOI.js";import"./chunk-75Z2AOVW-h7UnPWNo.js";import"./chunk-PWAF6VOD-D3fAPSwz.js";import"./chunk-GMAD6QVW-Cpa-YKLB.js";import"./chunk-P2QGCYS3-C1Y9GyYT.js";import"./chunk-4HAMMTFA-QfSXT_X7.js";import"./chunk-GVQU2GXP-BWSHPLNL.js";import"./chunk-OSK3NFVY-749yk2fa.js";import"./chunk-F27PBJKO-toywqOqS.js";import"./chunk-XXDRQBXY-DBtYQykd.js";import"./chunk-POPQ4Y6H-DzI9aRsX.js";import"./chunk-L3NEJ4N5-C8pAfDlo.js";import{i as t,n,r,t as i}from"./chunk-TICWLB2K-DV8q7H-z.js";import"./mermaid.core-8TRpFRm9.js";var a={parser:n,get db(){return new i},renderer:r,styles:t,init:e(e=>{e.class||={},e.class.arrowMarkerAbsolute=e.arrowMarkerAbsolute},`init`)};export{a as diagram};

package/console-app/assets/eventmodeling-NTZA5JFV-C_IpFSCw.js

@@ -1 +0,0 @@
-import"./chunk-FOHPRMQF-CoA4358r.js";import{O as e}from"./mermaid-parser.core-U7wquvx8.js";export{e as createEventModelingServices};

package/console-app/assets/flowDiagram-HODETNUW-Q90rgVpx.js

@@ -1 +0,0 @@
-import"./src-P4Nw8sY0.js";import"./chunk-DU6HZSFF-VaMy-LOI.js";import"./chunk-75Z2AOVW-h7UnPWNo.js";import"./chunk-PWAF6VOD-D3fAPSwz.js";import"./chunk-GMAD6QVW-Cpa-YKLB.js";import"./chunk-P2QGCYS3-C1Y9GyYT.js";import"./chunk-4HAMMTFA-QfSXT_X7.js";import"./chunk-GVQU2GXP-BWSHPLNL.js";import"./chunk-OSK3NFVY-749yk2fa.js";import"./chunk-F27PBJKO-toywqOqS.js";import"./chunk-XXDRQBXY-DBtYQykd.js";import"./chunk-POPQ4Y6H-DzI9aRsX.js";import"./chunk-L3NEJ4N5-C8pAfDlo.js";import{n as e}from"./chunk-SHT3W25Y-D9w7LzM9.js";import"./mermaid.core-8TRpFRm9.js";export{e as diagram};

package/console-app/assets/railroad-abnf-HS5TGJTU-CcPw9q8a.js

@@ -1 +0,0 @@
-import"./chunk-FOHPRMQF-CoA4358r.js";import{m as e}from"./mermaid-parser.core-U7wquvx8.js";export{e as createRailroadAbnfServices};

package/console-app/assets/railroad-ebnf-LZEXJU2U-Ci_fZics.js

@@ -1 +0,0 @@
-import"./chunk-FOHPRMQF-CoA4358r.js";import{f as e}from"./mermaid-parser.core-U7wquvx8.js";export{e as createRailroadEbnfServices};

package/console-app/assets/railroad-peg-WCYAUIDC-DTsDykSf.js

@@ -1 +0,0 @@
-import"./chunk-FOHPRMQF-CoA4358r.js";import{u as e}from"./mermaid-parser.core-U7wquvx8.js";export{e as createRailroadPegServices};

package/console-app/assets/stateDiagram-v2-MP3YSRHH--GM14Hz5.js

@@ -1 +0,0 @@
-import{n as e}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import"./src-P4Nw8sY0.js";import"./chunk-DU6HZSFF-VaMy-LOI.js";import"./chunk-75Z2AOVW-h7UnPWNo.js";import"./chunk-PWAF6VOD-D3fAPSwz.js";import"./chunk-GMAD6QVW-Cpa-YKLB.js";import"./chunk-P2QGCYS3-C1Y9GyYT.js";import"./chunk-4HAMMTFA-QfSXT_X7.js";import"./chunk-GVQU2GXP-BWSHPLNL.js";import"./chunk-OSK3NFVY-749yk2fa.js";import"./chunk-F27PBJKO-toywqOqS.js";import"./chunk-XXDRQBXY-DBtYQykd.js";import"./chunk-POPQ4Y6H-DzI9aRsX.js";import"./chunk-L3NEJ4N5-C8pAfDlo.js";import{i as t,n,r,t as i}from"./chunk-IMKFNOWR-yhQzfQuj.js";import"./mermaid.core-8TRpFRm9.js";var a={parser:n,get db(){return new i(2)},renderer:r,styles:t,init:e(e=>{e.state||={},e.state.arrowMarkerAbsolute=e.arrowMarkerAbsolute},`init`)};export{a as diagram};

package/console-app/assets/swimlanesDiagram-VR7AAH4N-_6rRi6Wt.js

@@ -1,8 +0,0 @@
-import{n as e}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import"./src-P4Nw8sY0.js";import"./chunk-DU6HZSFF-VaMy-LOI.js";import"./chunk-75Z2AOVW-h7UnPWNo.js";import"./chunk-PWAF6VOD-D3fAPSwz.js";import"./chunk-GMAD6QVW-Cpa-YKLB.js";import"./chunk-P2QGCYS3-C1Y9GyYT.js";import"./chunk-4HAMMTFA-QfSXT_X7.js";import"./chunk-GVQU2GXP-BWSHPLNL.js";import"./chunk-OSK3NFVY-749yk2fa.js";import"./chunk-F27PBJKO-toywqOqS.js";import"./chunk-XXDRQBXY-DBtYQykd.js";import"./chunk-POPQ4Y6H-DzI9aRsX.js";import"./chunk-L3NEJ4N5-C8pAfDlo.js";import{r as t,t as n}from"./chunk-SHT3W25Y-D9w7LzM9.js";import"./mermaid.core-8TRpFRm9.js";var r=n({defaultLayout:`swimlane`,styles:e(e=>`${t(e)}
-  .swimlane.cluster rect {
-    stroke: ${e.clusterBorder} !important;
-  }
-  [data-look="neo"].cluster rect {
-    filter: none;
-  }
-`,`getStyles`)});export{r as diagram};