@pikku/addon-meta-conversions 0.1.6 → 0.1.7

package/dist/.pikku/addon/scenarios/pikku-scenario-types.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 import type {
   PikkuScenarioWire,
@@ -12,9 +12,9 @@ import type { PikkuFunctionSessionless, PikkuFunctionConfig, WiredServices, Infe
 import type { PikkuMiddleware } from '../middleware/pikku-middleware-types.gen.js'
 import type { TypedWorkflow } from '../workflow/pikku-workflow-types.gen.js'
 import type { FlattenedScenarioStepMap } from '../workflow/pikku-scenario-step-map.gen.d.js'
-import type { TypedPersonas } from './pikku-personas.gen.js'
+import type { TypedVirtualUsers } from './pikku-virtual-users.gen.js'
 
-export type { TypedPersonas }
+export type { TypedVirtualUsers }
 
 /**
  * The scenario test surface, re-exported so a step file has one specifier to
@@ -25,7 +25,6 @@ export type { TypedPersonas }
  */
 export {
   createCookieJar,
-  createScenarioRunner,
   pollUntil,
   requireScenarioEnv,
 } from '@pikku/core/scenario'
@@ -34,7 +33,7 @@ export type {
   ScenarioSurface,
   TestIdSelector,
 } from '@pikku/core/scenario'
-export { postScenarioJson, readScenarioHttpResponse } from '@pikku/core/persona'
+export { postScenarioJson, readScenarioHttpResponse } from '@pikku/core/virtual-user'
 export type { ScenarioHttpResponse } from '@pikku/core/scenario'
 
 /**
@@ -80,7 +79,7 @@ export type PikkuFunctionScenario<
   In = unknown,
   Out = never,
   Ctx = Out
-> = PikkuFunctionSessionless<In, Out, 'scenario' | 'actors', WiredServices, Ctx>
+> = PikkuFunctionSessionless<In, Out, 'scenario' | 'virtualUsers', WiredServices, Ctx>
 
 type PikkuScenarioConfigWithSchema<
   InputSchema extends StandardSchemaV1 | undefined = undefined,
@@ -150,6 +149,8 @@ export type PikkuScenarioHook<
  * Declares a scenario hook. Returns the function verbatim — a hook is never
  * registered, so this exists purely to give an inline hook a call site to be
  * contextually typed from, the way every other pikku primitive is.
+ *
+ * @example snippet: scenarioHook
  */
 export function pikkuScenarioHook<In = unknown, Ctx = unknown>(
   hook: PikkuFunctionScenario<In, void, Ctx>
@@ -159,21 +160,23 @@ export function pikkuScenarioHook<In = unknown, Ctx = unknown>(
 
 /**
  * A scenario: a complex workflow that drives the app the way users do.
- * Steps run as actors over the REAL transport — `scenario.do(step, rpc,
- * data, { actor: actors.yasser })` — so flows double as e2e tests and
+ * Steps run as virtual users over the REAL transport — `scenario.do(step, rpc,
+ * data, { virtualUser: virtualUsers.yasser })` — so flows double as e2e tests and
  * staged/production health checks (no state reset; scope what you create).
+ *
+ * @example snippet: scenarioBasics
  */
 export function pikkuScenario<
   InputSchema extends StandardSchemaV1 | undefined = undefined,
   OutputSchema extends StandardSchemaV1 | undefined = undefined
 >(
   config: PikkuScenarioConfigWithSchema<InputSchema, OutputSchema>
-): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'scenario' | 'actors', PikkuFunctionScenario<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown>, InputSchema, OutputSchema>
+): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'scenario' | 'virtualUsers', PikkuFunctionScenario<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown>, InputSchema, OutputSchema>
 export function pikkuScenario<In, Out = unknown>(
   func:
     | PikkuFunctionScenario<In, Out>
-    | PikkuFunctionConfig<In, Out, 'scenario' | 'actors', PikkuFunctionScenario<In, Out>>
-): PikkuFunctionConfig<In, Out, 'scenario' | 'actors'>
+    | PikkuFunctionConfig<In, Out, 'scenario' | 'virtualUsers', PikkuFunctionScenario<In, Out>>
+): PikkuFunctionConfig<In, Out, 'scenario' | 'virtualUsers'>
 export function pikkuScenario(func: any) {
   return typeof func === 'function' ? { func } : func
 }
@@ -186,7 +189,7 @@ export function pikkuScenario(func: any) {
 export type PikkuScenarioRef<In = any, Out = any> = PikkuFunctionConfig<
   In,
   Out,
-  'scenario' | 'actors',
+  'scenario' | 'virtualUsers',
   PikkuFunctionScenario<In, Out>,
   any,
   any
@@ -210,6 +213,12 @@ type PikkuFeatureConfig<Scenarios extends readonly unknown[]> = {
   name: string
   description?: string
   tags?: string[]
+  /**
+   * Whether this feature is guide material, defaulting to true. `pikku scenario
+   * guide` requires every documented feature to be cited by a page; a feature
+   * that is pure plumbing sets this false rather than being written about.
+   */
+  document?: boolean
   scenarios: { [K in keyof Scenarios]: PikkuFeatureEntry<Scenarios[K]> }
   /**
    * Runs ONCE before the whole group — not before each scenario. Per-scenario
@@ -243,6 +252,8 @@ type PikkuFeatureConfig<Scenarios extends readonly unknown[]> = {
  *   ],
  * })
  * ```
+ *
+ * @example snippet: scenarioFeature
  */
 export function pikkuFeature<const Scenarios extends readonly unknown[]>(
   config: PikkuFeatureConfig<Scenarios>
@@ -261,45 +272,45 @@ export type PikkuFunctionScenarioStep<
   In = unknown,
   Out = never,
   Surface extends 'browser' | 'cli' | 'default' = 'default',
-  HasActor extends boolean = false
+  HasVirtualUser extends boolean = false
 > = PikkuFunctionSessionless<
   In,
   Out,
   | 'scenarioStep'
   | (Surface extends 'default' ? never : Surface)
-  | (HasActor extends true ? 'actor' : never)
+  | (HasVirtualUser extends true ? 'virtualUser' : never)
 >
 
 type PikkuScenarioStepConfigWithSchema<
   InputSchema extends StandardSchemaV1 | undefined = undefined,
   OutputSchema extends StandardSchemaV1 | undefined = undefined,
-  HasActor extends boolean = false
+  HasVirtualUser extends boolean = false
 > = {
   /** Registered name — this is the string `scenario.given()` references. */
   name: string
   /**
-   * This step is driven by a persona, so `wire.actor` is injected and
+   * This step is driven by a virtual user, so `wire.virtualUser` is injected and
    * non-optional inside every binding, and the runner refuses to dispatch it
    * without one.
    *
    * A `browser` binding implies it — a window is opened as somebody. Declare it
-   * for a server-side step that calls RPCs as its actor. Leave it off for a step
-   * that has no persona to be: an assertion over a value an earlier step
+   * for a server-side step that calls RPCs as its virtual user. Leave it off for a step
+   * that has no virtual user to be: an assertion over a value an earlier step
    * returned, or one that posts credentials precisely because it must not reuse
-   * an actor's session.
+   * a virtual user's session.
    */
-  actor?: HasActor
+  virtualUser?: HasVirtualUser
   /**
    * What this step does, for the console and for whoever reads the source. It
    * is also the fallback prose when no `template` is declared, in which case a
-   * reporter renders "Given the shopper buys an apple". Defaults to the call
+   * reporter renders "Given shopper buys an apple". Defaults to the call
    * site's step name.
    */
   description?: string
   /**
    * The prose a reporter renders for this step, with `{placeholders}` filled
    * from the input the step was called with — `'sees {packageName}'` reports as
-   * "Then the admin sees @pikku/addon-todos". Every input field should appear,
+   * "Then admin sees @pikku/addon-todos". Every input field should appear,
    * so the report names the values under test rather than repeating one
    * sentence per call site.
    */
@@ -311,17 +322,17 @@ type PikkuScenarioStepConfigWithSchema<
   errors?: Array<typeof PikkuError>
   /**
    * Drive this step through a real browser, as a human would. The runner
-   * provisions a window for the step's actor first — which makes an actor
+   * provisions a window for the step's virtual user first — which makes a virtual user
    * mandatory — and `wire.browser` is non-optional inside it.
    *
    * Compose shared utilities here rather than writing raw clicks: the step says
-   * what the actor is doing, the utilities say how.
+   * what the virtual user is doing, the utilities say how.
    */
   browser?: PikkuFunctionScenarioStep<
     InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown,
     OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown,
     'browser',
-    // A window is opened as somebody, so a browser binding has an actor whether
+    // A window is opened as somebody, so a browser binding has a virtual user whether
     // or not the step declared one.
     true
   >
@@ -330,7 +341,7 @@ type PikkuScenarioStepConfigWithSchema<
     InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown,
     OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown,
     'cli',
-    HasActor
+    HasVirtualUser
   >
   /**
    * The server-side path — the fast suite, and the floor every other surface
@@ -345,37 +356,39 @@ type PikkuScenarioStepConfigWithSchema<
     InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown,
     OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown,
     'default',
-    HasActor
+    HasVirtualUser
   >
 }
 
-type PikkuScenarioStepConfig<In, Out, HasActor extends boolean = false> =
-  Omit<PikkuScenarioStepConfigWithSchema<undefined, undefined, HasActor>, 'browser' | 'cli' | 'default' | 'input' | 'output'> & {
+type PikkuScenarioStepConfig<In, Out, HasVirtualUser extends boolean = false> =
+  Omit<PikkuScenarioStepConfigWithSchema<undefined, undefined, HasVirtualUser>, 'browser' | 'cli' | 'default' | 'input' | 'output'> & {
     browser?: PikkuFunctionScenarioStep<In, Out, 'browser', true>
-    cli?: PikkuFunctionScenarioStep<In, Out, 'cli', HasActor>
-    default?: PikkuFunctionScenarioStep<In, Out, 'default', HasActor>
+    cli?: PikkuFunctionScenarioStep<In, Out, 'cli', HasVirtualUser>
+    default?: PikkuFunctionScenarioStep<In, Out, 'default', HasVirtualUser>
   }
 
 /**
  * A named, reusable scenario step, declaring one implementation per surface an
- * actor can drive it through.
+ * virtual user can drive it through.
  *
- * The step's identity is what the actor is trying to do; which surface carries
+ * The step's identity is what the virtual user is trying to do; which surface carries
  * it out is a binding. That is what lets one ladder run through a real browser,
  * over the websocket, or entirely server-side — and what makes "how much of this
  * flow can a human actually reach" a number rather than a guess.
  *
  * Steps are deliberately NOT registered as RPCs: a browser-driving step must
  * never be network-callable.
+ *
+ * @example snippet: scenarioStepDefinition
  */
 export function pikkuScenarioStep<
   InputSchema extends StandardSchemaV1 | undefined = undefined,
   OutputSchema extends StandardSchemaV1 | undefined = undefined
 >(
-  config: PikkuScenarioStepConfigWithSchema<InputSchema, OutputSchema, true> & { actor: true }
+  config: PikkuScenarioStepConfigWithSchema<InputSchema, OutputSchema, true> & { virtualUser: true }
 ): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'scenarioStep' | 'browser' | 'cli', PikkuFunctionScenarioStep<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'browser' | 'cli' | 'default'>, InputSchema, OutputSchema>
 export function pikkuScenarioStep<In, Out = unknown>(
-  config: PikkuScenarioStepConfig<In, Out, true> & { actor: true }
+  config: PikkuScenarioStepConfig<In, Out, true> & { virtualUser: true }
 ): PikkuFunctionConfig<In, Out, 'scenarioStep' | 'browser' | 'cli'>
 export function pikkuScenarioStep<
   InputSchema extends StandardSchemaV1 | undefined = undefined,
@@ -407,7 +420,7 @@ export function pikkuScenarioStep(config: any) {
   return {
     ...config,
     surfaces,
-    requiresActor: config.actor === true || surfaces.includes('browser'),
+    requiresVirtualUser: config.virtualUser === true || surfaces.includes('browser'),
     // The runner sets the surface on the wire and calls this once per binding it
     // resolved — every witness of a `then`, exactly one for an action step.
     func: (services: any, data: any, wire: any) => {
@@ -433,7 +446,7 @@ type PikkuSubjectScenarioStepConfigWithSchema<
   OutputSchema extends StandardSchemaV1 | undefined = undefined
 > = Omit<
   PikkuScenarioStepConfigWithSchema<InputSchema, OutputSchema>,
-  'browser' | 'cli' | 'default' | 'actor'
+  'browser' | 'cli' | 'default' | 'virtualUser'
 > & {
   func: PikkuFunctionScenarioStep<
     InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown,
@@ -443,7 +456,7 @@ type PikkuSubjectScenarioStepConfigWithSchema<
 }
 
 type PikkuSubjectScenarioStepConfig<In, Out> =
-  Omit<PikkuScenarioStepConfig<In, Out>, 'browser' | 'cli' | 'default' | 'actor'> & {
+  Omit<PikkuScenarioStepConfig<In, Out>, 'browser' | 'cli' | 'default' | 'virtualUser'> & {
     func: PikkuFunctionScenarioStep<In, Out, 'default'>
   }
 
@@ -452,11 +465,13 @@ type PikkuSubjectScenarioStepConfig<In, Out> =
  * trial".
  *
  * The grammatical subject of that sentence is not a user of your app; it **is**
- * your app, which is why it is its own declaration rather than a persona with an
- * asterisk. A persona is a person.
+ * your app, which is why it is its own declaration rather than a virtual user with an
+ * asterisk. A virtual user is a person.
  *
  * Local-test-only, and never in a virtual user's catalogue: a virtual user that
  * could expire its own trial is manufacturing the outcome it exists to discover.
+ *
+ * @example snippet: platformStep
  */
 export function pikkuPlatformScenarioStep<
   InputSchema extends StandardSchemaV1 | undefined = undefined,
@@ -485,6 +500,8 @@ export function pikkuPlatformScenarioStep(config: any) {
  *
  * Local-test-only, and never in a virtual user's catalogue: one that could
  * invoke this would forge its own payment success.
+ *
+ * @example snippet: addonStep
  */
 export function pikkuAddonScenarioStep<
   InputSchema extends StandardSchemaV1 | undefined = undefined,

package/dist/.pikku/addon/scenarios/pikku-scenario-wirings-meta.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { pikkuState } from '@pikku/core/state';
 import '../workflow/pikku-workflow-wirings-meta.gen.js';

package/dist/.pikku/addon/scenarios/pikku-scenario-wirings-meta.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { pikkuState } from '@pikku/core/state'
 import type { WorkflowsRuntimeMeta } from '@pikku/core/workflow'

package/dist/.pikku/addon/scenarios/pikku-scenario-wirings.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 export {};
 //# sourceMappingURL=pikku-scenario-wirings.gen.d.ts.map

package/dist/.pikku/addon/scenarios/pikku-scenario-wirings.gen.ts

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 export {}

package/dist/.pikku/addon/scenarios/pikku-virtual-users.gen.d.ts

@@ -0,0 +1,33 @@
+import type { HttpVirtualUsersConfig } from '@pikku/core/virtual-user';
+import type { ScenarioVirtualUser } from '@pikku/core/services';
+import type { ResolvedVirtualUser } from '@pikku/core/services';
+import type { AgentMap } from '../agent/pikku-agent-map.gen.d.js';
+import type { FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.gen.d.js';
+export declare const virtualUserConfigs: {};
+export type VirtualUserName = keyof typeof virtualUserConfigs;
+/**
+ * The same virtual users as a list, widened to `ResolvedVirtualUser`. Iterating
+ * `virtualUserConfigs` directly yields the literal type of each entry, on which an
+ * optional field a virtual user did not declare does not exist — so a seed reading
+ * `roles` off every virtual user needs this instead.
+ */
+export declare const virtualUserList: ResolvedVirtualUser[];
+/**
+ * The `environments` block of pikku.config.json, carried into the runtime.
+ *
+ * A virtual user's environments are checked twice: at build time against the config,
+ * and again wherever a virtual user is signed in or provisioned, against the
+ * environment the running process says it is (`PIKKU_ENV`). The second check
+ * is not the first one repeated — the build check trusts the file, and the run
+ * check does not trust which artifact got deployed — so the rule needs the
+ * config on both sides of the build.
+ */
+export declare const virtualUserEnvironments: {};
+export type AgentName = keyof AgentMap & string;
+/**
+ * The virtual users this project declares, keyed by name — the `virtual users` a scenario
+ * step runs as.
+ */
+export type TypedVirtualUsers = Record<VirtualUserName, ScenarioVirtualUser<AgentName, FlattenedRPCMap>>;
+export declare const createVirtualUsers: (options: Omit<HttpVirtualUsersConfig, 'virtualUsers'>) => TypedVirtualUsers;
+//# sourceMappingURL=pikku-virtual-users.gen.d.ts.map

package/dist/.pikku/addon/scenarios/pikku-virtual-users.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-virtual-users.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/scenarios/pikku-virtual-users.gen.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAA;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAA;AAE5E,eAAO,MAAM,kBAAkB,IAA4D,CAAA;AAE3F,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,kBAAkB,CAAA;AAE7D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,mBAAmB,EAAsC,CAAA;AAEvF;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,IAAiE,CAAA;AAErG,MAAM,MAAM,SAAS,GAAG,MAAM,QAAQ,GAAG,MAAM,CAAA;AAC/C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CACpC,eAAe,EACf,mBAAmB,CAAC,SAAS,EAAE,eAAe,CAAC,CAChD,CAAA;AAED,eAAO,MAAM,kBAAkB,YACpB,IAAI,CAAC,sBAAsB,EAAE,cAAc,CAAC,KACpD,iBAIsB,CAAA"}

package/dist/.pikku/addon/scenarios/pikku-virtual-users.gen.js

@@ -0,0 +1,29 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/** Virtual users declared with defineVirtualUsers() */
+import { createHttpVirtualUsers } from '@pikku/core/virtual-user';
+export const virtualUserConfigs = {};
+/**
+ * The same virtual users as a list, widened to `ResolvedVirtualUser`. Iterating
+ * `virtualUserConfigs` directly yields the literal type of each entry, on which an
+ * optional field a virtual user did not declare does not exist — so a seed reading
+ * `roles` off every virtual user needs this instead.
+ */
+export const virtualUserList = Object.values(virtualUserConfigs);
+/**
+ * The `environments` block of pikku.config.json, carried into the runtime.
+ *
+ * A virtual user's environments are checked twice: at build time against the config,
+ * and again wherever a virtual user is signed in or provisioned, against the
+ * environment the running process says it is (`PIKKU_ENV`). The second check
+ * is not the first one repeated — the build check trusts the file, and the run
+ * check does not trust which artifact got deployed — so the rule needs the
+ * config on both sides of the build.
+ */
+export const virtualUserEnvironments = {};
+export const createVirtualUsers = (options) => createHttpVirtualUsers({
+    ...options,
+    virtualUsers: virtualUserConfigs,
+});
+//# sourceMappingURL=pikku-virtual-users.gen.js.map

package/dist/.pikku/addon/scenarios/pikku-virtual-users.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-virtual-users.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/scenarios/pikku-virtual-users.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,uDAAuD;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AAOjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAyD,CAAA;AAI3F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAA0B,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAA;AAEvF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAA8D,CAAA;AAYrG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,OAAqD,EAClC,EAAE,CACrB,sBAAsB,CAAC;IACrB,GAAG,OAAO;IACV,YAAY,EAAE,kBAAkB;CACjC,CAAsB,CAAA"}

package/dist/.pikku/addon/scenarios/pikku-virtual-users.gen.ts

@@ -0,0 +1,52 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/** Virtual users declared with defineVirtualUsers() */
+import { createHttpVirtualUsers } from '@pikku/core/virtual-user'
+import type { HttpVirtualUsersConfig } from '@pikku/core/virtual-user'
+import type { ScenarioVirtualUser } from '@pikku/core/services'
+import type { ResolvedVirtualUser } from '@pikku/core/services'
+import type { AgentMap } from '../agent/pikku-agent-map.gen.d.js'
+import type { FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.gen.d.js'
+
+export const virtualUserConfigs = {} as const satisfies Record<string, ResolvedVirtualUser>
+
+export type VirtualUserName = keyof typeof virtualUserConfigs
+
+/**
+ * The same virtual users as a list, widened to `ResolvedVirtualUser`. Iterating
+ * `virtualUserConfigs` directly yields the literal type of each entry, on which an
+ * optional field a virtual user did not declare does not exist — so a seed reading
+ * `roles` off every virtual user needs this instead.
+ */
+export const virtualUserList: ResolvedVirtualUser[] = Object.values(virtualUserConfigs)
+
+/**
+ * The `environments` block of pikku.config.json, carried into the runtime.
+ *
+ * A virtual user's environments are checked twice: at build time against the config,
+ * and again wherever a virtual user is signed in or provisioned, against the
+ * environment the running process says it is (`PIKKU_ENV`). The second check
+ * is not the first one repeated — the build check trusts the file, and the run
+ * check does not trust which artifact got deployed — so the rule needs the
+ * config on both sides of the build.
+ */
+export const virtualUserEnvironments = {} as const satisfies Record<string, { production?: boolean }>
+
+export type AgentName = keyof AgentMap & string
+/**
+ * The virtual users this project declares, keyed by name — the `virtual users` a scenario
+ * step runs as.
+ */
+export type TypedVirtualUsers = Record<
+  VirtualUserName,
+  ScenarioVirtualUser<AgentName, FlattenedRPCMap>
+>
+
+export const createVirtualUsers = (
+  options: Omit<HttpVirtualUsersConfig, 'virtualUsers'>
+): TypedVirtualUsers =>
+  createHttpVirtualUsers({
+    ...options,
+    virtualUsers: virtualUserConfigs,
+  }) as TypedVirtualUsers

package/dist/.pikku/addon/scenarios/schemas/register.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 export declare const empty: null;
 //# sourceMappingURL=register.gen.d.ts.map

package/dist/.pikku/addon/scenarios/schemas/register.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 export const empty = null;
 //# sourceMappingURL=register.gen.js.map

package/dist/.pikku/addon/scenarios/schemas/register.gen.ts

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 export const empty = null;

package/dist/.pikku/addon/schemas/register.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { addSchema } from '@pikku/core/schema';
 import * as EventSendInput from './schemas/EventSendInput.schema.json' with { type: 'json' };

package/dist/.pikku/addon/schemas/register.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 import { addSchema } from '@pikku/core/schema'
 

package/dist/.pikku/addon/scopes/index.d.ts

@@ -1,8 +1,9 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/scopes` resolves here.
  */
 export * from './pikku-scope-types.gen.js';
+export * from './pikku-flags.gen.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/.pikku/addon/scopes/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,cAAc,4BAA4B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA"}

package/dist/.pikku/addon/scopes/index.js

@@ -1,8 +1,9 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/scopes` resolves here.
  */
 export * from './pikku-scope-types.gen.js';
+export * from './pikku-flags.gen.js';
 //# sourceMappingURL=index.js.map

package/dist/.pikku/addon/scopes/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,cAAc,4BAA4B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA"}

package/dist/.pikku/addon/scopes/index.ts

@@ -1,8 +1,9 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/scopes` resolves here.
  */
 
 export * from './pikku-scope-types.gen.js'
+export * from './pikku-flags.gen.js'

package/dist/.pikku/addon/scopes/pikku-flags-manifest.gen.d.ts

@@ -0,0 +1,41 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+ * This file was generated by the @pikku/cli
+ */
+import type { DeclaredFlag } from '@pikku/core/flag';
+import type { FeatureFlagName } from './pikku-flags.gen.js';
+/**
+ * The declared flag set, for a FeatureFlagStore to sync into its store.
+ *
+ * Derived from the metadata sidecar rather than inlined, so the import above
+ * forces tsc to emit the .json alongside this file — an addon publishes only
+ * its compiled output, and a host reads that .json to merge the addon's flags
+ * into its own union.
+ *
+ * Additive on removal: a deleted declaration leaves the row marked
+ * `declared: false` rather than switching a feature off on deploy. Use
+ * `pikku flags prune` to remove them.
+ */
+export declare const declaredFeatureFlags: DeclaredFlag[];
+/**
+ * Declared flags, keyed by name. Rendered by the console beside each switch.
+ *
+ * Keyed by `FeatureFlagName` so a misspelled lookup is a type error, which is
+ * the whole point of generating the union. The assertion is what
+ * `Object.fromEntries` costs — it returns an index signature — and it is
+ * sound here because both this object and the union are built from
+ * `declaredFeatureFlags`, so every key of the union is present.
+ */
+export declare const featureFlagsMeta: Record<FeatureFlagName, DeclaredFlag>;
+/**
+ * What a flag source falls back to when its backing store cannot be read: every
+ * declared flag on, no rollout, no overrides.
+ *
+ * Failing open is deliberate. A flag store is not an authorization boundary —
+ * `scopes:` is — so an unreadable config must not take the product down with
+ * it.
+ */
+export declare const featureFlagsFallback: import("@pikku/core/flag").FlagConfigSnapshot;
+//# sourceMappingURL=pikku-flags-manifest.gen.d.ts.map

package/dist/.pikku/addon/scopes/pikku-flags-manifest.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-flags-manifest.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/pikku-flags-manifest.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAA8B,MAAM,kBAAkB,CAAA;AAKhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAG3D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,EAAE,YAAY,EAE9C,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAExB,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC,CAAA;AAE1C;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,+CAAiD,CAAA"}

package/dist/.pikku/addon/scopes/pikku-flags-manifest.gen.js

@@ -0,0 +1,35 @@
+import { compiledFallbackSnapshot, flattenFeatureFlagDefinitions, } from '@pikku/core/flag';
+import definitions from './pikku-flags-meta.gen.json' with { type: 'json' };
+/**
+ * The declared flag set, for a FeatureFlagStore to sync into its store.
+ *
+ * Derived from the metadata sidecar rather than inlined, so the import above
+ * forces tsc to emit the .json alongside this file — an addon publishes only
+ * its compiled output, and a host reads that .json to merge the addon's flags
+ * into its own union.
+ *
+ * Additive on removal: a deleted declaration leaves the row marked
+ * `declared: false` rather than switching a feature off on deploy. Use
+ * `pikku flags prune` to remove them.
+ */
+export const declaredFeatureFlags = flattenFeatureFlagDefinitions(Object.values(definitions));
+/**
+ * Declared flags, keyed by name. Rendered by the console beside each switch.
+ *
+ * Keyed by `FeatureFlagName` so a misspelled lookup is a type error, which is
+ * the whole point of generating the union. The assertion is what
+ * `Object.fromEntries` costs — it returns an index signature — and it is
+ * sound here because both this object and the union are built from
+ * `declaredFeatureFlags`, so every key of the union is present.
+ */
+export const featureFlagsMeta = Object.fromEntries(declaredFeatureFlags.map((flag) => [flag.name, flag]));
+/**
+ * What a flag source falls back to when its backing store cannot be read: every
+ * declared flag on, no rollout, no overrides.
+ *
+ * Failing open is deliberate. A flag store is not an authorization boundary —
+ * `scopes:` is — so an unreadable config must not take the product down with
+ * it.
+ */
+export const featureFlagsFallback = compiledFallbackSnapshot(declaredFeatureFlags);
+//# sourceMappingURL=pikku-flags-manifest.gen.js.map

package/dist/.pikku/addon/scopes/pikku-flags-manifest.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-flags-manifest.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/scopes/pikku-flags-manifest.gen.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,kBAAkB,CAAA;AAEzB,OAAO,WAAW,MAAM,6BAA6B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAE3E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAmB,6BAA6B,CAC/E,MAAM,CAAC,MAAM,CAAC,WAAyC,CAAC,CACzD,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,CAChD,oBAAoB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CACb,CAAA;AAE1C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC,oBAAoB,CAAC,CAAA"}