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

package/dist/onboarding/onboarding.options.d.ts

@@ -0,0 +1,56 @@
+import type { DynamicModule, ForwardReference, Type } from '@nestjs/common';
+/**
+ * Injection token of the {@link ResolvedOnboardingModuleOptions}.
+ *
+ * @stability experimental
+ */
+export declare const ONBOARDING_OPTIONS: unique symbol;
+/**
+ * What an app passes to `OnboardingModule.forRoot()`. No option is an
+ * environment variable of its own.
+ *
+ * @stability experimental
+ */
+export interface OnboardingModuleOptions {
+    /**
+     * The permission that adds the admin block to `GET /api/onboarding` and
+     * gates `GET /api/admin/onboarding/metrics`. Default `system_settings:read`
+     * (the Doctor's, whose report the admin steps reuse). Must be a permission
+     * the app's RBAC grants.
+     */
+    adminPermission?: string;
+    /** The variable (read through `ConfigService`) holding the bootstrap administrator's address. Default `'INITIAL_ADMIN_EMAIL'`. */
+    initialAdminEmailEnv?: string;
+    /** The modules binding the host ports (`ONBOARDING_DATA`, optionally `ONBOARDING_FEATURES`). */
+    imports?: Array<Type<unknown> | DynamicModule | Promise<DynamicModule> | ForwardReference>;
+}
+/**
+ * The options with every default applied.
+ *
+ * @stability experimental
+ */
+export interface ResolvedOnboardingModuleOptions {
+    /** See {@link OnboardingModuleOptions.adminPermission}. */
+    readonly adminPermission: string;
+    /** See {@link OnboardingModuleOptions.initialAdminEmailEnv}. */
+    readonly initialAdminEmailEnv: string;
+    /** See {@link OnboardingModuleOptions.imports}. */
+    readonly imports: NonNullable<OnboardingModuleOptions['imports']>;
+}
+/**
+ * The defaults.
+ *
+ * @stability experimental
+ */
+export declare const DEFAULT_ONBOARDING_OPTIONS: ResolvedOnboardingModuleOptions;
+/**
+ * Validates the options and applies the defaults.
+ *
+ * @param options - the app's options.
+ * @returns the resolved options.
+ * @throws Error when an option is malformed.
+ *
+ * @stability experimental
+ */
+export declare function resolveOnboardingModuleOptions(options?: OnboardingModuleOptions): ResolvedOnboardingModuleOptions;
+//# sourceMappingURL=onboarding.options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.options.d.ts","sourceRoot":"","sources":["../../src/onboarding/onboarding.options.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAG5E;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAAO,MAA8D,CAAC;AAEvG;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kIAAkI;IAClI,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gGAAgG;IAChG,OAAO,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,gBAAgB,CAAC,CAAC;CAC5F;AAED;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C,2DAA2D;IAC3D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,gEAAgE;IAChE,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAAC;CACnE;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,+BAIvC,CAAC;AAEH;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,GAAE,uBAA4B,GAAG,+BAA+B,CAUrH"}

package/dist/onboarding/onboarding.options.js

@@ -0,0 +1,45 @@
+"use strict";
+// =============================================================================
+// `OnboardingModule.forRoot()` options (issue #745, PP-9.3)
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ONBOARDING_OPTIONS = exports.ONBOARDING_OPTIONS = void 0;
+exports.resolveOnboardingModuleOptions = resolveOnboardingModuleOptions;
+const onboarding_1 = require("@marinoscar/platform-contract/onboarding");
+/**
+ * Injection token of the {@link ResolvedOnboardingModuleOptions}.
+ *
+ * @stability experimental
+ */
+exports.ONBOARDING_OPTIONS = Symbol.for('@marinoscar/platform/onboarding/OPTIONS');
+/**
+ * The defaults.
+ *
+ * @stability experimental
+ */
+exports.DEFAULT_ONBOARDING_OPTIONS = Object.freeze({
+    adminPermission: onboarding_1.ONBOARDING_ADMIN_PERMISSION,
+    initialAdminEmailEnv: 'INITIAL_ADMIN_EMAIL',
+    imports: [],
+});
+/**
+ * Validates the options and applies the defaults.
+ *
+ * @param options - the app's options.
+ * @returns the resolved options.
+ * @throws Error when an option is malformed.
+ *
+ * @stability experimental
+ */
+function resolveOnboardingModuleOptions(options = {}) {
+    const adminPermission = options.adminPermission ?? exports.DEFAULT_ONBOARDING_OPTIONS.adminPermission;
+    if (typeof adminPermission !== 'string' || adminPermission.trim() === '') {
+        throw new Error('OnboardingModule.forRoot: `adminPermission` must be a non-empty permission string.');
+    }
+    const initialAdminEmailEnv = options.initialAdminEmailEnv ?? exports.DEFAULT_ONBOARDING_OPTIONS.initialAdminEmailEnv;
+    if (typeof initialAdminEmailEnv !== 'string' || initialAdminEmailEnv.trim() === '') {
+        throw new Error('OnboardingModule.forRoot: `initialAdminEmailEnv` must be a non-empty variable name.');
+    }
+    return Object.freeze({ adminPermission, initialAdminEmailEnv, imports: [...(options.imports ?? [])] });
+}
+//# sourceMappingURL=onboarding.options.js.map

package/dist/onboarding/onboarding.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.options.js","sourceRoot":"","sources":["../../src/onboarding/onboarding.options.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,4DAA4D;AAC5D,gFAAgF;;;AAkEhF,wEAUC;AAzED,yEAAuF;AAEvF;;;;GAIG;AACU,QAAA,kBAAkB,GAAkB,MAAM,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;AAoCvG;;;;GAIG;AACU,QAAA,0BAA0B,GAAoC,MAAM,CAAC,MAAM,CAAC;IACvF,eAAe,EAAE,wCAA2B;IAC5C,oBAAoB,EAAE,qBAAqB;IAC3C,OAAO,EAAE,EAAE;CACZ,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,SAAgB,8BAA8B,CAAC,UAAmC,EAAE;IAClF,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,kCAA0B,CAAC,eAAe,CAAC;IAC9F,IAAI,OAAO,eAAe,KAAK,QAAQ,IAAI,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,oFAAoF,CAAC,CAAC;IACxG,CAAC;IACD,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,kCAA0B,CAAC,oBAAoB,CAAC;IAC7G,IAAI,OAAO,oBAAoB,KAAK,QAAQ,IAAI,oBAAoB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CAAC,qFAAqF,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,oBAAoB,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AACzG,CAAC"}

package/dist/onboarding/onboarding.registries.d.ts

@@ -0,0 +1,135 @@
+import type { ActivationMilestoneDef, OnboardingFactDef, OnboardingOrderingDef, OnboardingStepDef } from './onboarding.types';
+/**
+ * The fact the `doctorChecks` sugar adds.
+ *
+ * @stability experimental
+ */
+export declare const DOCTOR_FACT_ID = "doctor";
+/**
+ * Every onboarding step, in registration order (the response sorts by
+ * `order`, then id).
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare const onboardingStepRegistry: import("../core/index").Registry<OnboardingStepDef<Readonly<Record<string, unknown>>>>;
+/**
+ * Registers onboarding steps, all or nothing.
+ *
+ * @param steps - the steps.
+ * @throws RegistryError naming the step when one is invalid: a duplicate or
+ *   malformed id, a `required` step marked `skippable`, no `evaluate` and no
+ *   `doctorChecks`, a `funnelSql` on an admin step.
+ *
+ * @example
+ * ```ts
+ * registerOnboardingStep({
+ *   id: 'app.first-project', audience: 'user', tier: 'recommended', order: 30,
+ *   title: 'Create your first project', description: 'Projects hold your work.',
+ *   actionLabel: 'New project', href: '/projects/new', permission: 'projects:write',
+ *   skippable: true, facts: ['app.projectCount'],
+ *   evaluate: (facts) => ({ status: (facts['app.projectCount'] as number) > 0 ? 'done' : 'todo' }),
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function registerOnboardingStep(...steps: OnboardingStepDef[]): void;
+/**
+ * Every onboarding fact.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare const onboardingFactRegistry: import("../core/index").Registry<OnboardingFactDef<unknown>>;
+/**
+ * Registers onboarding facts, all or nothing.
+ *
+ * @param facts - the facts.
+ * @throws RegistryError on a duplicate id or a missing `resolve`.
+ *
+ * @example
+ * ```ts
+ * registerOnboardingFact({
+ *   id: 'app.projectCount',
+ *   resolve: (ctx) => ctx.get(ProjectsService).countFor(ctx.caller.id),
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function registerOnboardingFact(...facts: OnboardingFactDef[]): void;
+/**
+ * The ordering hooks, at most one per audience.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare const onboardingOrderingRegistry: import("../core/index").Registry<OnboardingOrderingDef>;
+/**
+ * Registers an audience's ordering hook (one per audience).
+ *
+ * @param ordering - the hook.
+ * @throws RegistryError when the audience already has one.
+ *
+ * @example
+ * ```ts
+ * registerOnboardingOrdering({
+ *   audience: 'user',
+ *   facts: ['userSettings'],
+ *   order: (steps) => [...steps].sort((a, b) => Number(a.evaluation.status === 'done') - Number(b.evaluation.status === 'done')),
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function registerOnboardingOrdering(ordering: OnboardingOrderingDef): void;
+/**
+ * The activation milestones the metrics aggregate.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare const activationMilestoneRegistry: import("../core/index").Registry<ActivationMilestoneDef>;
+/**
+ * Registers an activation milestone.
+ *
+ * @param milestone - the milestone.
+ * @throws RegistryError on a duplicate or malformed id, a `windowDays` out of
+ *   range, or an SQL expression containing `;`.
+ *
+ * @example
+ * ```ts
+ * registerActivationMilestone({
+ *   id: 'first_project', label: 'First project created', windowDays: 7,
+ *   firstReachedAtSql: '(SELECT MIN(p.created_at) FROM projects p WHERE p.owner_id = c.id)',
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function registerActivationMilestone(milestone: ActivationMilestoneDef): void;
+/**
+ * The fact ids a step reads: its own, plus `doctor` when it declares
+ * `doctorChecks`.
+ *
+ * @param step - the step.
+ * @returns the ids, without duplicates.
+ *
+ * @stability experimental
+ */
+export declare function factIdsOf(step: OnboardingStepDef): string[];
+/**
+ * Fails when a step or an ordering names a fact no one registered. The
+ * service runs it at bootstrap.
+ *
+ * @throws Error listing every dangling fact id with the step that names it.
+ *
+ * @stability experimental
+ */
+export declare function assertOnboardingRegistries(): void;
+//# sourceMappingURL=onboarding.registries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.registries.d.ts","sourceRoot":"","sources":["../../src/onboarding/onboarding.registries.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACV,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,eAAO,MAAM,cAAc,WAAW,CAAC;AAkDvC;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,wFAOjC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,KAAK,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAE1E;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,8DAOjC,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,KAAK,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAE1E;AAED;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,yDAUrC,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAEhF;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,0DAatC,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAEnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAI3D;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAejD"}

package/dist/onboarding/onboarding.registries.js

@@ -0,0 +1,282 @@
+"use strict";
+// =============================================================================
+// The onboarding registries (issue #745, PP-9.3): steps, facts, orderings and
+// activation milestones
+// =============================================================================
+//
+// Rung 2: static registries (`defineRegistry`) filled at import time by the
+// app's manifest (`apps/api/src/onboarding/onboarding.manifest.ts`) and frozen
+// once the application has bootstrapped. Cross-registry rules (a step naming a
+// fact nobody registered) are checked by `assertOnboardingRegistries`, which
+// the service runs at bootstrap: registration order between the two
+// registries does not matter, but a dangling id fails the boot.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.activationMilestoneRegistry = exports.onboardingOrderingRegistry = exports.onboardingFactRegistry = exports.onboardingStepRegistry = exports.DOCTOR_FACT_ID = void 0;
+exports.registerOnboardingStep = registerOnboardingStep;
+exports.registerOnboardingFact = registerOnboardingFact;
+exports.registerOnboardingOrdering = registerOnboardingOrdering;
+exports.registerActivationMilestone = registerActivationMilestone;
+exports.factIdsOf = factIdsOf;
+exports.assertOnboardingRegistries = assertOnboardingRegistries;
+const onboarding_1 = require("@marinoscar/platform-contract/onboarding");
+const index_1 = require("../core/index");
+const onboarding_audiences_1 = require("./onboarding.audiences");
+/**
+ * The fact the `doctorChecks` sugar adds.
+ *
+ * @stability experimental
+ */
+exports.DOCTOR_FACT_ID = 'doctor';
+function nonEmpty(value, field) {
+    if (typeof value !== 'string' || value.trim() === '')
+        throw new Error(`${field} is required`);
+}
+function assertAudienceRegistered(audience) {
+    if (!onboarding_audiences_1.onboardingAudienceRegistry.has(audience)) {
+        throw new Error(`audience "${audience}" is not registered (registered: ${onboarding_audiences_1.onboardingAudienceRegistry.ids().join(', ')}); ` +
+            'call registerOnboardingAudience before registering steps that name it');
+    }
+}
+function validateStep(step) {
+    if (step.id.length > onboarding_1.ONBOARDING_STEP_ID_MAX)
+        throw new Error(`id is longer than ${onboarding_1.ONBOARDING_STEP_ID_MAX} characters`);
+    assertAudienceRegistered(step.audience);
+    if (!onboarding_1.ONBOARDING_TIERS.includes(step.tier)) {
+        throw new Error(`tier must be one of ${onboarding_1.ONBOARDING_TIERS.join(', ')}`);
+    }
+    if (typeof step.order !== 'number' || !Number.isFinite(step.order))
+        throw new Error('order must be a finite number');
+    for (const field of ['title', 'description', 'actionLabel', 'href'])
+        nonEmpty(step[field], field);
+    if (!step.href.startsWith('/'))
+        throw new Error('href must be an app route starting with "/"');
+    if (step.permission !== undefined)
+        nonEmpty(step.permission, 'permission (when set)');
+    if (step.feature !== undefined)
+        nonEmpty(step.feature, 'feature (when set)');
+    if (typeof step.skippable !== 'boolean')
+        throw new Error('skippable must be a boolean');
+    if (step.tier === 'required' && step.skippable) {
+        throw new Error('a required step cannot be skippable: other people cannot succeed without it');
+    }
+    if (!Array.isArray(step.facts) || step.facts.some((id) => typeof id !== 'string' || id === '')) {
+        throw new Error('facts must be an array of fact ids');
+    }
+    if (step.doctorChecks !== undefined) {
+        if (!Array.isArray(step.doctorChecks) || step.doctorChecks.length === 0 || step.doctorChecks.some((id) => typeof id !== 'string' || id === '')) {
+            throw new Error('doctorChecks must be a non-empty array of Doctor check ids when set');
+        }
+    }
+    if (step.evaluate === undefined && step.doctorChecks === undefined) {
+        throw new Error('evaluate is required unless doctorChecks is set');
+    }
+    if (step.evaluate !== undefined && typeof step.evaluate !== 'function')
+        throw new Error('evaluate must be a function');
+    if (step.applies !== undefined && typeof step.applies !== 'function')
+        throw new Error('applies must be a function');
+    if (step.funnelSql !== undefined) {
+        nonEmpty(step.funnelSql, 'funnelSql (when set)');
+        if (step.audience !== 'user')
+            throw new Error('funnelSql is for user steps only (the funnel is over new users)');
+        if (step.funnelSql.includes(';'))
+            throw new Error('funnelSql must be one expression, without ";"');
+    }
+}
+/**
+ * Every onboarding step, in registration order (the response sorts by
+ * `order`, then id).
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+exports.onboardingStepRegistry = (0, index_1.defineRegistry)({
+    name: 'onboarding-steps',
+    idOf: (step) => step.id,
+    idPattern: onboarding_1.ONBOARDING_STEP_ID_PATTERN,
+    validate: (step) => validateStep(step),
+    describeDuplicate: (_existing, incoming) => `Onboarding step "${incoming.id}" is already registered. A step id is permanent (it is stored in users' skipped lists); pick another id.`,
+});
+/**
+ * Registers onboarding steps, all or nothing.
+ *
+ * @param steps - the steps.
+ * @throws RegistryError naming the step when one is invalid: a duplicate or
+ *   malformed id, a `required` step marked `skippable`, no `evaluate` and no
+ *   `doctorChecks`, a `funnelSql` on an admin step.
+ *
+ * @example
+ * ```ts
+ * registerOnboardingStep({
+ *   id: 'app.first-project', audience: 'user', tier: 'recommended', order: 30,
+ *   title: 'Create your first project', description: 'Projects hold your work.',
+ *   actionLabel: 'New project', href: '/projects/new', permission: 'projects:write',
+ *   skippable: true, facts: ['app.projectCount'],
+ *   evaluate: (facts) => ({ status: (facts['app.projectCount'] as number) > 0 ? 'done' : 'todo' }),
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+function registerOnboardingStep(...steps) {
+    exports.onboardingStepRegistry.registerAll(steps);
+}
+/**
+ * Every onboarding fact.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+exports.onboardingFactRegistry = (0, index_1.defineRegistry)({
+    name: 'onboarding-facts',
+    idOf: (fact) => fact.id,
+    validate: (fact) => {
+        if (typeof fact.resolve !== 'function')
+            throw new Error('resolve must be a function');
+    },
+    describeDuplicate: (_existing, incoming) => `Onboarding fact "${incoming.id}" is already registered.`,
+});
+/**
+ * Registers onboarding facts, all or nothing.
+ *
+ * @param facts - the facts.
+ * @throws RegistryError on a duplicate id or a missing `resolve`.
+ *
+ * @example
+ * ```ts
+ * registerOnboardingFact({
+ *   id: 'app.projectCount',
+ *   resolve: (ctx) => ctx.get(ProjectsService).countFor(ctx.caller.id),
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+function registerOnboardingFact(...facts) {
+    exports.onboardingFactRegistry.registerAll(facts);
+}
+/**
+ * The ordering hooks, at most one per audience.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+exports.onboardingOrderingRegistry = (0, index_1.defineRegistry)({
+    name: 'onboarding-orderings',
+    idOf: (ordering) => ordering.audience,
+    validate: (ordering) => {
+        assertAudienceRegistered(ordering.audience);
+        if (typeof ordering.order !== 'function')
+            throw new Error('order must be a function');
+        if (!Array.isArray(ordering.facts))
+            throw new Error('facts must be an array of fact ids');
+    },
+    describeDuplicate: (_existing, incoming) => `An onboarding ordering for the "${incoming.audience}" audience is already registered; there is at most one per audience.`,
+});
+/**
+ * Registers an audience's ordering hook (one per audience).
+ *
+ * @param ordering - the hook.
+ * @throws RegistryError when the audience already has one.
+ *
+ * @example
+ * ```ts
+ * registerOnboardingOrdering({
+ *   audience: 'user',
+ *   facts: ['userSettings'],
+ *   order: (steps) => [...steps].sort((a, b) => Number(a.evaluation.status === 'done') - Number(b.evaluation.status === 'done')),
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+function registerOnboardingOrdering(ordering) {
+    exports.onboardingOrderingRegistry.register(ordering);
+}
+/**
+ * The activation milestones the metrics aggregate.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+exports.activationMilestoneRegistry = (0, index_1.defineRegistry)({
+    name: 'onboarding-activation-milestones',
+    idOf: (milestone) => milestone.id,
+    idPattern: /^[a-z][a-z0-9_]*$/,
+    validate: (milestone) => {
+        nonEmpty(milestone.label, 'label');
+        nonEmpty(milestone.firstReachedAtSql, 'firstReachedAtSql');
+        if (milestone.firstReachedAtSql.includes(';'))
+            throw new Error('firstReachedAtSql must be one expression, without ";"');
+        if (!Number.isInteger(milestone.windowDays) || milestone.windowDays < 1 || milestone.windowDays > onboarding_1.ONBOARDING_METRICS_DAYS_MAX) {
+            throw new Error(`windowDays must be an integer from 1 to ${onboarding_1.ONBOARDING_METRICS_DAYS_MAX}`);
+        }
+    },
+    describeDuplicate: (_existing, incoming) => `Activation milestone "${incoming.id}" is already registered.`,
+});
+/**
+ * Registers an activation milestone.
+ *
+ * @param milestone - the milestone.
+ * @throws RegistryError on a duplicate or malformed id, a `windowDays` out of
+ *   range, or an SQL expression containing `;`.
+ *
+ * @example
+ * ```ts
+ * registerActivationMilestone({
+ *   id: 'first_project', label: 'First project created', windowDays: 7,
+ *   firstReachedAtSql: '(SELECT MIN(p.created_at) FROM projects p WHERE p.owner_id = c.id)',
+ * });
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+function registerActivationMilestone(milestone) {
+    exports.activationMilestoneRegistry.register(milestone);
+}
+/**
+ * The fact ids a step reads: its own, plus `doctor` when it declares
+ * `doctorChecks`.
+ *
+ * @param step - the step.
+ * @returns the ids, without duplicates.
+ *
+ * @stability experimental
+ */
+function factIdsOf(step) {
+    const ids = new Set(step.facts);
+    if (step.doctorChecks !== undefined)
+        ids.add(exports.DOCTOR_FACT_ID);
+    return [...ids];
+}
+/**
+ * Fails when a step or an ordering names a fact no one registered. The
+ * service runs it at bootstrap.
+ *
+ * @throws Error listing every dangling fact id with the step that names it.
+ *
+ * @stability experimental
+ */
+function assertOnboardingRegistries() {
+    const problems = [];
+    for (const step of exports.onboardingStepRegistry.list()) {
+        for (const id of factIdsOf(step)) {
+            if (!exports.onboardingFactRegistry.has(id))
+                problems.push(`step "${step.id}" reads unknown fact "${id}"`);
+        }
+    }
+    for (const ordering of exports.onboardingOrderingRegistry.list()) {
+        for (const id of ordering.facts) {
+            if (!exports.onboardingFactRegistry.has(id))
+                problems.push(`the ${ordering.audience} ordering reads unknown fact "${id}"`);
+        }
+    }
+    if (problems.length > 0) {
+        throw new Error(`Onboarding registries are inconsistent: ${problems.join('; ')}. Register the facts (registerOnboardingFact) before the app boots.`);
+    }
+}
+//# sourceMappingURL=onboarding.registries.js.map

package/dist/onboarding/onboarding.registries.js.map

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

package/dist/onboarding/onboarding.service.d.ts

@@ -0,0 +1,62 @@
+import type { OnboardingResponse } from '@marinoscar/platform-contract/onboarding';
+import { OnApplicationBootstrap } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { ModuleRef } from '@nestjs/core';
+import { DoctorCheckRegistry, DoctorService } from '../doctor/index';
+import { type ResolvedOnboardingModuleOptions } from './onboarding.options';
+import { type OnboardingDataPort, type OnboardingFeatureGate } from './ports';
+/**
+ * Who `GET /api/onboarding` is for: the request user.
+ *
+ * @stability experimental
+ */
+export interface OnboardingServiceCaller {
+    /** The user's id. */
+    id: string;
+    /** Effective permissions. */
+    permissions: readonly string[];
+    /** Role names. */
+    roles?: readonly string[];
+    /** The active organization. */
+    activeOrgId?: string | null;
+}
+/**
+ * Derives `GET /api/onboarding`. Provided by `OnboardingModule.forRoot()`.
+ *
+ * @stability experimental
+ */
+export declare class OnboardingService implements OnApplicationBootstrap {
+    private readonly data;
+    private readonly moduleRef;
+    private readonly features?;
+    private readonly doctor?;
+    private readonly checks?;
+    private readonly config?;
+    private readonly logger;
+    private readonly options;
+    /**
+     * @param data - the app's data port.
+     * @param moduleRef - for app facts (`ctx.get(token)`).
+     * @param features - the feature gate; absent: every feature-gated step is omitted.
+     * @param doctor - the Doctor; absent: every Doctor-backed step is omitted.
+     * @param checks - the Doctor's check registry.
+     * @param config - reads `INITIAL_ADMIN_EMAIL`.
+     * @param options - the resolved module options.
+     */
+    constructor(data: OnboardingDataPort, moduleRef: ModuleRef, features?: OnboardingFeatureGate | undefined, doctor?: DoctorService | undefined, checks?: DoctorCheckRegistry | undefined, config?: ConfigService | undefined, options?: ResolvedOnboardingModuleOptions);
+    /** Fails the boot when a step or an ordering names an unregistered fact. */
+    onApplicationBootstrap(): void;
+    /**
+     * The caller's stored UI state, user block and (for an administrator)
+     * admin block.
+     *
+     * @param caller - the request user.
+     * @param options - `refresh` bypasses the Doctor's cache.
+     * @returns the response.
+     */
+    get(caller: OnboardingServiceCaller, options?: {
+        refresh?: boolean;
+    }): Promise<OnboardingResponse>;
+    private doctorAccess;
+}
+//# sourceMappingURL=onboarding.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.service.d.ts","sourceRoot":"","sources":["../../src/onboarding/onboarding.service.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAA8B,sBAAsB,EAAY,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,EAAkD,KAAK,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AAU5H,OAAO,EAAwC,KAAK,kBAAkB,EAAE,KAAK,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEpH;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,kBAAkB;IAClB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAMD;;;;GAIG;AACH,qBACa,iBAAkB,YAAW,sBAAsB;IAcnC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS;IACe,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAlB7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAE1D;;;;;;;;OAQG;gBAEyC,IAAI,EAAE,kBAAkB,EACjD,SAAS,EAAE,SAAS,EACqB,QAAQ,CAAC,EAAE,qBAAqB,YAAA,EACtC,MAAM,CAAC,EAAE,aAAa,YAAA,EAChB,MAAM,CAAC,EAAE,mBAAmB,YAAA,EAClC,MAAM,CAAC,EAAE,aAAa,YAAA,EAClC,OAAO,CAAC,EAAE,+BAA+B;IAKnF,4EAA4E;IAC5E,sBAAsB,IAAI,IAAI;IAI9B;;;;;;;OAOG;IACG,GAAG,CAAC,MAAM,EAAE,uBAAuB,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkD5G,OAAO,CAAC,YAAY;CAgBrB"}