@marinoscar/platform-api 0.1.0-next.3 → 0.1.0-next.5

package/dist/onboarding/onboarding.types.d.ts

@@ -0,0 +1,225 @@
+import type { DoctorCheckReport } from '@marinoscar/platform-contract/doctor';
+import type { OnboardingAudience, OnboardingStatus, OnboardingTier } from '@marinoscar/platform-contract/onboarding';
+import type { OnboardingDataPort } from './ports';
+/**
+ * What a step's `evaluate` returns.
+ *
+ * @stability experimental
+ */
+export interface OnboardingEvaluation {
+    /** `done`, `todo` or `blocked`. */
+    status: OnboardingStatus;
+    /** A `todo` step's hint (shown under its title); `null` or absent for none. */
+    detail?: string | null;
+    /** Why a `blocked` step cannot be done yet. REQUIRED when `status` is `blocked`. */
+    blockedReason?: string;
+}
+/**
+ * The resolved facts a step reads, by fact id. A step only ever sees the
+ * facts it declared.
+ *
+ * @stability experimental
+ */
+export type OnboardingFacts = Readonly<Record<string, unknown>>;
+/**
+ * One onboarding step. Register it with `registerOnboardingStep`; the id is
+ * permanent (it is stored in a user's `skipped` list).
+ *
+ * @typeParam F - the facts object `applies` and `evaluate` receive.
+ *
+ * @stability experimental
+ */
+export interface OnboardingStepDef<F extends OnboardingFacts = OnboardingFacts> {
+    /** Permanent, namespaced: `admin.*`, `user.*` or `<app>.*` (`ONBOARDING_STEP_ID_PATTERN`). */
+    readonly id: string;
+    /**
+     * Who the step is for: `admin` (the Setup guide), `user` (Get started),
+     * `org_admin` (the holder of the `org_admin` role of their active
+     * organization) or an audience the app registered with
+     * `registerOnboardingAudience` (before this step).
+     */
+    readonly audience: OnboardingAudience;
+    /** `required`, `recommended` or `optional`. */
+    readonly tier: OnboardingTier;
+    /** Stable sort key within the audience; ties sort by id. */
+    readonly order: number;
+    /** The step's title. */
+    readonly title: string;
+    /** One sentence on what the step achieves. */
+    readonly description: string;
+    /** The label of the step's link ("Connect storage"). */
+    readonly actionLabel: string;
+    /** The web route where the step is completed; must exist. */
+    readonly href: string;
+    /** The exact API permission the step's page needs; the step is OMITTED (never shown blocked) when the caller lacks it. */
+    readonly permission?: string;
+    /** A deployment feature (`ai`, `telemetry`, ...); the step is omitted while it is off. */
+    readonly feature?: string;
+    /** Whether the user may skip it. A `required` step never is (refused at registration). */
+    readonly skippable: boolean;
+    /** The fact ids the step reads; an id no registered fact has fails at bootstrap. */
+    readonly facts: readonly string[];
+    /**
+     * Doctor check ids. Sugar: adds the `doctor` fact, omits the step when a
+     * check is not registered, and (without `evaluate`) maps every `pass` to
+     * `done` and anything else to `todo` with the first non-passing check's
+     * remedy (falling back to its detail) as `detail`. A `skip` is NOT a pass.
+     */
+    readonly doctorChecks?: readonly string[];
+    /**
+     * The step counted in the activation funnel: an SQL boolean expression over
+     * the cohort user `c.id` (`EXISTS (SELECT 1 FROM projects p WHERE p.owner_id = c.id)`).
+     * Trusted, developer-authored SQL; never built from input. `user` steps only.
+     */
+    readonly funnelSql?: string;
+    /** Whether the step applies to this caller at all (false: omitted). Synchronous, facts only. */
+    applies?(facts: F): boolean;
+    /** The step's status from its facts. Synchronous, facts only. Required unless `doctorChecks` is set. */
+    evaluate?(facts: F): OnboardingEvaluation;
+}
+/**
+ * Who is asking, as a fact resolver sees it.
+ *
+ * @stability experimental
+ */
+export interface OnboardingCaller {
+    /** The user's id. */
+    readonly id: string;
+    /** Effective permissions (system grants plus the active organization's). */
+    readonly permissions: readonly string[];
+    /** System role names plus the active org role name. */
+    readonly roles: readonly string[];
+    /** The active organization, when the credential carries one. */
+    readonly activeOrgId: string | null;
+}
+/**
+ * What an audience rule is told besides the caller.
+ *
+ * @stability experimental
+ */
+export interface OnboardingAudienceContext {
+    /** The module's `adminPermission` (`OnboardingModule.forRoot`), the `admin` audience's rule. */
+    readonly adminPermission: string;
+}
+/**
+ * One audience: a group of steps and the rule that says who sees them.
+ * Register it with `registerOnboardingAudience`; the id is permanent.
+ *
+ * `matches` is synchronous and reads only the caller (no I/O): it decides which
+ * block a step lands in, while a step's own `permission` and `feature` gates
+ * still apply. A rule that throws counts as "does not match" (logged).
+ *
+ * @stability experimental
+ * @example
+ * ```ts
+ * registerOnboardingAudience({
+ *   id: 'coaches', label: 'Coach setup',
+ *   matches: (principal) => principal.roles.includes('coach'),
+ * });
+ * ```
+ */
+export interface OnboardingAudienceDef {
+    /** Permanent, lower case (`ONBOARDING_AUDIENCE_ID_PATTERN`): `org_admin`, `<app>-coaches`. */
+    readonly id: string;
+    /** What the block is called in a UI. */
+    readonly label: string;
+    /** Whether this caller belongs to the audience. Synchronous, caller only. */
+    matches(principal: OnboardingCaller, ctx: OnboardingAudienceContext): boolean;
+}
+/**
+ * The Doctor, as the built-in `doctor` fact reaches it.
+ *
+ * @stability experimental
+ */
+export interface OnboardingDoctorAccess {
+    /** Whether a check with this id is registered. */
+    has(checkId: string): boolean;
+    /** The reports of `checkIds` (one Doctor run per category they span, honouring `refresh`). */
+    reports(checkIds: readonly string[], refresh: boolean): Promise<ReadonlyMap<string, DoctorCheckReport>>;
+}
+/**
+ * What a fact's `resolve` receives: built once per request.
+ *
+ * @stability experimental
+ */
+export interface OnboardingRequestContext {
+    /** Who is asking. */
+    readonly caller: OnboardingCaller;
+    /** `refresh=true` was sent: bypass caches (the Doctor's). */
+    readonly refresh: boolean;
+    /** The app's data port (`ONBOARDING_DATA`). */
+    readonly data: OnboardingDataPort;
+    /** The Doctor, or `null` when the app has none. */
+    readonly doctor: OnboardingDoctorAccess | null;
+    /** Every Doctor check id the applicable steps reference (the `doctor` fact's input). */
+    readonly doctorCheckIds: readonly string[];
+    /** `INITIAL_ADMIN_EMAIL` (trimmed), or `null` when unset. */
+    readonly initialAdminEmail: string | null;
+    /** Whether a deployment feature is on (`ONBOARDING_FEATURES`; memoised per request). */
+    isFeatureEnabled(feature: string): Promise<boolean>;
+    /** Another fact's value (memoised: resolving it twice runs it once). */
+    fact<T = unknown>(id: string): Promise<T>;
+    /** An app provider by token, for an app fact (`ModuleRef.get(token, { strict: false })`). */
+    get<T = unknown>(token: (abstract new (...args: never[]) => T) | string | symbol): T;
+}
+/**
+ * One fact: a value read once per request, shared by every step that needs it.
+ *
+ * @typeParam T - the value.
+ *
+ * @stability experimental
+ */
+export interface OnboardingFactDef<T = unknown> {
+    /** The fact's id (`doctor`, `aiEnabled`, `<app>.<fact>`). */
+    readonly id: string;
+    /** Reads the value. A rejection omits every step that needs the fact (logged), never fails the response. */
+    resolve(ctx: OnboardingRequestContext): Promise<T>;
+}
+/**
+ * A derived step, as the ordering hook sees it.
+ *
+ * @stability experimental
+ */
+export interface OnboardingOrderableStep {
+    /** The step's definition. */
+    readonly def: OnboardingStepDef;
+    /** Its derived evaluation. */
+    readonly evaluation: OnboardingEvaluation;
+}
+/**
+ * One audience's ordering hook (EvoPath orders the user steps by the goal the
+ * user chose). At most one per audience. Default: the `order` field.
+ *
+ * @stability experimental
+ */
+export interface OnboardingOrderingDef {
+    /** The audience it orders. */
+    readonly audience: OnboardingAudience;
+    /** The facts it reads. */
+    readonly facts: readonly string[];
+    /** The steps in the order to show; a step left out is dropped. Synchronous, facts only. */
+    order(steps: readonly OnboardingOrderableStep[], facts: OnboardingFacts): readonly OnboardingOrderableStep[];
+}
+/**
+ * One activation milestone: the event onboarding exists to cause (an app's
+ * first created project, say). Optional; without one the metrics report the
+ * cohort and the step funnel only.
+ *
+ * @stability experimental
+ */
+export interface ActivationMilestoneDef {
+    /** Lower-case id, unique (`first_project`). */
+    readonly id: string;
+    /** Shown in the Activation section. */
+    readonly label: string;
+    /** Activated = reached within this many days of sign-up (1 to 365). */
+    readonly windowDays: number;
+    /**
+     * An SQL expression yielding the `timestamptz` at which the cohort user
+     * `c.id` first reached the milestone, or `NULL`
+     * (`(SELECT MIN(p.created_at) FROM projects p WHERE p.owner_id = c.id)`).
+     * Trusted, developer-authored SQL; never built from input.
+     */
+    readonly firstReachedAtSql: string;
+}
+//# sourceMappingURL=onboarding.types.d.ts.map

package/dist/onboarding/onboarding.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.types.d.ts","sourceRoot":"","sources":["../../src/onboarding/onboarding.types.ts"],"names":[],"mappings":"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"}

package/dist/onboarding/onboarding.types.js

@@ -0,0 +1,14 @@
+"use strict";
+// =============================================================================
+// The onboarding slice's declarations (issue #745, PP-9.3)
+// =============================================================================
+//
+// A STEP is pure data plus two synchronous functions over FACTS. A FACT is the
+// only thing that may read anything (the database, the Doctor, a feature
+// switch), and the service resolves each fact AT MOST ONCE per request, and
+// only when a step that applies to the caller needs it (kvox's cost rule: "a
+// per-step query makes the endpoint's cost a function of the registry's
+// length"). `evaluate` is synchronous on purpose: it cannot await a query.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=onboarding.types.js.map

package/dist/onboarding/onboarding.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.types.js","sourceRoot":"","sources":["../../src/onboarding/onboarding.types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,2DAA2D;AAC3D,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,yEAAyE;AACzE,4EAA4E;AAC5E,6EAA6E;AAC7E,wEAAwE;AACxE,2EAA2E;AAC3E,gFAAgF"}

package/dist/onboarding/ports.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The data the built-in facts and the metrics read. Bound by the app.
+ *
+ * @stability experimental
+ */
+export interface OnboardingDataPort {
+    /** The caller's raw `user_settings.value`, or `null` when there is no row. Selects; never creates the row. */
+    readUserSettingsValue(userId: string): Promise<unknown>;
+    /** How many allowlist entries exist other than `exceptEmail` (compared case-insensitively; `null`: all of them). */
+    countAllowlistEntriesExcept(exceptEmail: string | null): Promise<number>;
+    /** Whether the user has at least one active Web Push subscription. Optional: absent reads as `false`. */
+    hasPushSubscription?(userId: string): Promise<boolean>;
+    /** In the organization: active members other than `userId`, and pending invites. Optional: absent omits `admin.org-invite`. */
+    orgInviteProgress?(orgId: string, userId: string): Promise<{
+        /** Active members other than `userId`. */
+        otherMembers: number;
+        /** Pending invites. */
+        pendingInvites: number;
+    }>;
+    /** Runs ONE read-only aggregate statement with positional parameters (`$1`, ...). The metrics' only query. */
+    queryAggregate<T>(sql: string, values: readonly unknown[]): Promise<T[]>;
+}
+/**
+ * Binds {@link OnboardingDataPort}.
+ *
+ * @extensionPoint token
+ * @stability experimental
+ */
+export declare const ONBOARDING_DATA: unique symbol;
+/**
+ * Whether a deployment feature is on: the same switches that hide settings
+ * cards (`ai`, `telemetry`, ...). Bound by the app.
+ *
+ * @stability experimental
+ */
+export interface OnboardingFeatureGate {
+    /** Whether `feature` is on. A feature the app does not know is off. */
+    isEnabled(feature: string): Promise<boolean>;
+}
+/**
+ * Binds {@link OnboardingFeatureGate}. Optional: unbound, every feature-gated
+ * step is omitted.
+ *
+ * @extensionPoint token
+ * @stability experimental
+ */
+export declare const ONBOARDING_FEATURES: unique symbol;
+//# sourceMappingURL=ports.d.ts.map

package/dist/onboarding/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/onboarding/ports.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,8GAA8G;IAC9G,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,oHAAoH;IACpH,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzE,yGAAyG;IACzG,mBAAmB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,+HAA+H;IAC/H,iBAAiB,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QACzD,0CAA0C;QAC1C,YAAY,EAAE,MAAM,CAAC;QACrB,uBAAuB;QACvB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,8GAA8G;IAC9G,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CAC1E;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,OAAO,MAAkC,CAAC;AAExE;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,MAAsC,CAAC"}

package/dist/onboarding/ports.js

@@ -0,0 +1,28 @@
+"use strict";
+// =============================================================================
+// The onboarding slice's host ports (issue #745, PP-9.3)
+// =============================================================================
+//
+// The slice reads app data only through these, bound by the app
+// (`OnboardingModule.forRoot({ imports: [OnboardingHostModule] })`). Every
+// method is a READ: the endpoint never writes, and in particular never
+// creates the `user_settings` row `UserSettingsService.getSettings` would.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ONBOARDING_FEATURES = exports.ONBOARDING_DATA = void 0;
+/**
+ * Binds {@link OnboardingDataPort}.
+ *
+ * @extensionPoint token
+ * @stability experimental
+ */
+exports.ONBOARDING_DATA = Symbol('ONBOARDING_DATA');
+/**
+ * Binds {@link OnboardingFeatureGate}. Optional: unbound, every feature-gated
+ * step is omitted.
+ *
+ * @extensionPoint token
+ * @stability experimental
+ */
+exports.ONBOARDING_FEATURES = Symbol('ONBOARDING_FEATURES');
+//# sourceMappingURL=ports.js.map

package/dist/onboarding/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/onboarding/ports.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yDAAyD;AACzD,gFAAgF;AAChF,EAAE;AACF,gEAAgE;AAChE,2EAA2E;AAC3E,uEAAuE;AACvE,2EAA2E;AAC3E,gFAAgF;;;AAyBhF;;;;;GAKG;AACU,QAAA,eAAe,GAAkB,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAaxE;;;;;;GAMG;AACU,QAAA,mBAAmB,GAAkB,MAAM,CAAC,qBAAqB,CAAC,CAAC"}

package/dist/onboarding/testing/conformance.d.ts

@@ -0,0 +1,64 @@
+import type { ConformanceFinding, ConformanceSuite } from '../../testing/index';
+declare module '../../testing/index' {
+    interface PlatformConformanceSuiteOptions {
+        /** The onboarding slice's suite: its options, or `false` to opt out. Registered by importing `@marinoscar/platform-api/onboarding/testing`. */
+        onboarding?: OnboardingConformanceOptions | false;
+    }
+}
+/**
+ * What the `onboarding` suite takes: the app's data, never its code.
+ *
+ * @stability experimental
+ */
+export interface OnboardingConformanceOptions {
+    /** The app's permission registry (`id` of every permission). */
+    readonly permissions: ReadonlyArray<{
+        /** The permission id. */
+        readonly id: string;
+    }>;
+    /** Values to use for facts instead of resolving them (an app fact that needs a provider). */
+    readonly factSamples?: Readonly<Record<string, unknown>>;
+    /** The fewest steps the app must have registered (a wiring check). Default 1. */
+    readonly minSteps?: number;
+}
+/**
+ * The registry and permission checks.
+ *
+ * @param options - the suite's options.
+ * @returns one finding per problem.
+ *
+ * @stability experimental
+ */
+export declare function checkOnboardingRegistries(options: OnboardingConformanceOptions): ConformanceFinding[];
+/**
+ * What one spied derivation observed.
+ *
+ * @stability experimental
+ */
+export interface OnboardingDerivationProbe {
+    /** How many times each fact was resolved. */
+    resolutions: Record<string, number>;
+    /** Data-port calls made during the evaluation phase. */
+    evaluationCalls: string[];
+    /** Every data-port call. */
+    calls: string[];
+}
+/**
+ * Derives the checklists once for a caller holding every permission, every
+ * feature on, against a spied data port that answers "nothing yet".
+ *
+ * @param options - the suite's options.
+ * @returns what the derivation did.
+ *
+ * @stability experimental
+ */
+export declare function probeOnboardingDerivation(options: OnboardingConformanceOptions): Promise<OnboardingDerivationProbe>;
+/**
+ * The `onboarding` conformance suite. Registered when
+ * `@marinoscar/platform-api/onboarding/testing` is imported.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare const onboardingConformanceSuite: ConformanceSuite<OnboardingConformanceOptions>;
+//# sourceMappingURL=conformance.d.ts.map

package/dist/onboarding/testing/conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../../src/onboarding/testing/conformance.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAmB,kBAAkB,EAAqB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAYpH,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,+BAA+B;QACvC,+IAA+I;QAC/I,UAAU,CAAC,EAAE,4BAA4B,GAAG,KAAK,CAAC;KACnD;CACF;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,gEAAgE;IAChE,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;QAClC,yBAAyB;QACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,6FAA6F;IAC7F,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,4BAA4B,GAAG,kBAAkB,EAAE,CAyBrG;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,wDAAwD;IACxD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,4BAA4B;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA2DzH;AAED;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,EAAE,gBAAgB,CAAC,4BAA4B,CA2CrF,CAAC"}

package/dist/onboarding/testing/conformance.js

@@ -0,0 +1,185 @@
+"use strict";
+// =============================================================================
+// The onboarding slice's conformance suite (issue #745, PP-9.3)
+// =============================================================================
+//
+// Importing `@marinoscar/platform-api/onboarding/testing` registers the
+// `onboarding` suite with `runPlatformConformance()`. Checked against what the
+// APP registered:
+//
+//   1. registry: every fact a step or ordering names is registered, and no
+//      `required` step is skippable.
+//   2. permissions: every step's `permission` is in the app's permission
+//      registry, exactly.
+//   3. facts-once: one derivation, for a caller holding every permission,
+//      resolves each fact at most once.
+//   (the registry case also checks every step's audience is registered)
+//   4. no-io-in-evaluate: the evaluation phase makes no data-port call (the
+//      cost of the endpoint is the facts', never a per-step query).
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onboardingConformanceSuite = void 0;
+exports.checkOnboardingRegistries = checkOnboardingRegistries;
+exports.probeOnboardingDerivation = probeOnboardingDerivation;
+const index_1 = require("../../testing/index");
+const onboarding_audiences_1 = require("../onboarding.audiences");
+const onboarding_engine_1 = require("../onboarding.engine");
+const onboarding_registries_1 = require("../onboarding.registries");
+/**
+ * The registry and permission checks.
+ *
+ * @param options - the suite's options.
+ * @returns one finding per problem.
+ *
+ * @stability experimental
+ */
+function checkOnboardingRegistries(options) {
+    const findings = [];
+    const permissions = new Set(options.permissions.map((p) => p.id));
+    for (const step of onboarding_registries_1.onboardingStepRegistry.list()) {
+        for (const id of (0, onboarding_registries_1.factIdsOf)(step)) {
+            if (!onboarding_registries_1.onboardingFactRegistry.has(id))
+                findings.push({ file: `step:${step.id}`, message: `reads unknown fact "${id}"` });
+        }
+        if (step.tier === 'required' && step.skippable)
+            findings.push({ file: `step:${step.id}`, message: 'is required and skippable' });
+        if (!onboarding_audiences_1.onboardingAudienceRegistry.has(step.audience)) {
+            findings.push({ file: `step:${step.id}`, message: `names unknown audience "${step.audience}"` });
+        }
+        if (step.permission !== undefined && !permissions.has(step.permission)) {
+            findings.push({ file: `step:${step.id}`, message: `permission ${step.permission} is not a registered permission` });
+        }
+    }
+    for (const ordering of onboarding_registries_1.onboardingOrderingRegistry.list()) {
+        for (const id of ordering.facts) {
+            if (!onboarding_registries_1.onboardingFactRegistry.has(id))
+                findings.push({ file: `ordering:${ordering.audience}`, message: `reads unknown fact "${id}"` });
+        }
+    }
+    const minimum = options.minSteps ?? 1;
+    if (onboarding_registries_1.onboardingStepRegistry.size < minimum) {
+        findings.push({ file: 'registry', message: `${onboarding_registries_1.onboardingStepRegistry.size} step(s) registered, fewer than ${minimum}: did the app import its manifest?` });
+    }
+    return findings;
+}
+/**
+ * Derives the checklists once for a caller holding every permission, every
+ * feature on, against a spied data port that answers "nothing yet".
+ *
+ * @param options - the suite's options.
+ * @returns what the derivation did.
+ *
+ * @stability experimental
+ */
+async function probeOnboardingDerivation(options) {
+    const calls = [];
+    const evaluationCalls = [];
+    let evaluating = false;
+    const record = (name) => {
+        calls.push(name);
+        if (evaluating)
+            evaluationCalls.push(name);
+    };
+    const data = {
+        readUserSettingsValue: async () => (record('readUserSettingsValue'), null),
+        countAllowlistEntriesExcept: async () => (record('countAllowlistEntriesExcept'), 0),
+        hasPushSubscription: async () => (record('hasPushSubscription'), false),
+        orgInviteProgress: async () => (record('orgInviteProgress'), { otherMembers: 0, pendingInvites: 0 }),
+        queryAggregate: async () => (record('queryAggregate'), []),
+    };
+    const resolutions = {};
+    const samples = options.factSamples ?? {};
+    const facts = onboarding_registries_1.onboardingFactRegistry.list().map((fact) => ({
+        id: fact.id,
+        resolve: (ctx) => {
+            resolutions[fact.id] = (resolutions[fact.id] ?? 0) + 1;
+            return Object.prototype.hasOwnProperty.call(samples, fact.id) ? Promise.resolve(samples[fact.id]) : fact.resolve(ctx);
+        },
+    }));
+    await (0, onboarding_engine_1.evaluateOnboarding)({
+        steps: onboarding_registries_1.onboardingStepRegistry.list(),
+        facts,
+        orderings: onboarding_registries_1.onboardingOrderingRegistry.list(),
+        includeAdmin: true,
+        // Every registered audience is exercised: the probe caller holds the
+        // org_admin role, so org_admin steps are derived (and their facts counted) too.
+        audiences: onboarding_audiences_1.onboardingAudienceRegistry.list(),
+        audienceContext: { adminPermission: 'system_settings:read' },
+        skipped: [],
+        onEvaluationPhase: (phase) => {
+            evaluating = phase === 'start';
+        },
+        context: (doctorCheckIds, fact) => ({
+            caller: {
+                id: '00000000-0000-4000-8000-000000000000',
+                permissions: options.permissions.map((p) => p.id),
+                roles: ['org_admin'],
+                activeOrgId: '00000000-0000-4000-8000-000000000001',
+            },
+            refresh: false,
+            data,
+            doctor: { has: () => true, reports: async () => (record('doctor.reports'), new Map()) },
+            doctorCheckIds,
+            initialAdminEmail: null,
+            isFeatureEnabled: async () => true,
+            fact: (id) => fact(id),
+            get: () => {
+                throw new Error('no app providers in the conformance probe; pass factSamples for this fact');
+            },
+        }),
+    });
+    return { resolutions, evaluationCalls, calls };
+}
+/**
+ * The `onboarding` conformance suite. Registered when
+ * `@marinoscar/platform-api/onboarding/testing` is imported.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+exports.onboardingConformanceSuite = {
+    id: 'onboarding',
+    title: 'the onboarding slice keeps its invariants',
+    description: 'Every step reads registered facts and names a registered permission, required steps are never skippable, facts resolve at most once per request and step evaluation does no I/O.',
+    check(_context, options) {
+        const steps = onboarding_registries_1.onboardingStepRegistry.list();
+        return {
+            scanned: { steps: steps.length, facts: onboarding_registries_1.onboardingFactRegistry.size, orderings: onboarding_registries_1.onboardingOrderingRegistry.size },
+            scannedFiles: { steps: steps.map((step) => step.id) },
+            findings: checkOnboardingRegistries(options),
+        };
+    },
+    cases(options) {
+        return [
+            {
+                name: 'registry: every fact a step names is registered, no required step is skippable, and the app registered its steps',
+                run: (report, expect) => {
+                    expect(report.findings.filter((f) => /unknown fact|unknown audience|required and skippable|fewer than/.test(f.message))).toEqual([]);
+                },
+            },
+            {
+                name: 'permissions: every step permission is exactly a registered permission',
+                run: (report, expect) => {
+                    expect(report.findings.filter((f) => /not a registered permission/.test(f.message))).toEqual([]);
+                },
+            },
+            {
+                name: 'facts-once: one derivation resolves each fact at most once',
+                run: async (_report, expect) => {
+                    const probe = await probeOnboardingDerivation(options);
+                    expect(Object.entries(probe.resolutions).filter(([, count]) => count > 1)).toEqual([]);
+                },
+            },
+            {
+                name: 'no-io-in-evaluate: step evaluation makes no data-port call',
+                run: async (_report, expect) => {
+                    const probe = await probeOnboardingDerivation(options);
+                    expect(probe.evaluationCalls).toEqual([]);
+                },
+            },
+        ];
+    },
+};
+if (!index_1.conformanceSuites.has(exports.onboardingConformanceSuite.id))
+    index_1.conformanceSuites.register(exports.onboardingConformanceSuite);
+//# sourceMappingURL=conformance.js.map

package/dist/onboarding/testing/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../../../src/onboarding/testing/conformance.ts"],"names":[],"mappings":"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"}

package/dist/onboarding/testing/index.d.ts

@@ -0,0 +1,3 @@
+export { checkOnboardingRegistries, onboardingConformanceSuite, probeOnboardingDerivation } from './conformance';
+export type { OnboardingConformanceOptions, OnboardingDerivationProbe } from './conformance';
+//# sourceMappingURL=index.d.ts.map

package/dist/onboarding/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/onboarding/testing/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACjH,YAAY,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC"}

package/dist/onboarding/testing/index.js

@@ -0,0 +1,13 @@
+"use strict";
+// `@marinoscar/platform-api/onboarding/testing`: the onboarding slice's
+// conformance suite (issue #745). Importing this entry registers the
+// `onboarding` suite with `runPlatformConformance`
+// (@marinoscar/platform-api/testing). Never import it from production code.
+// Documented in ../README.md.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.probeOnboardingDerivation = exports.onboardingConformanceSuite = exports.checkOnboardingRegistries = void 0;
+var conformance_1 = require("./conformance");
+Object.defineProperty(exports, "checkOnboardingRegistries", { enumerable: true, get: function () { return conformance_1.checkOnboardingRegistries; } });
+Object.defineProperty(exports, "onboardingConformanceSuite", { enumerable: true, get: function () { return conformance_1.onboardingConformanceSuite; } });
+Object.defineProperty(exports, "probeOnboardingDerivation", { enumerable: true, get: function () { return conformance_1.probeOnboardingDerivation; } });
+//# sourceMappingURL=index.js.map

package/dist/onboarding/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/onboarding/testing/index.ts"],"names":[],"mappings":";AAAA,wEAAwE;AACxE,qEAAqE;AACrE,mDAAmD;AACnD,4EAA4E;AAC5E,8BAA8B;;;AAE9B,6CAAiH;AAAxG,wHAAA,yBAAyB,OAAA;AAAE,yHAAA,0BAA0B,OAAA;AAAE,wHAAA,yBAAyB,OAAA"}