@fayz-ai/plugin-getting-started 0.0.0-stage → 0.2.0-canary.20261027164140

package/dist/components/ProgressRing.d.ts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+export interface ProgressRingProps {
+    value: number;
+    max: number;
+    /** 40 on the card, 28 on the floating CTA, 20 on the phone chip (UX spec §2.1). */
+    size?: number;
+    label: string;
+    /** The whole ring turns success with a check in the middle. */
+    complete?: boolean;
+    /** Drawn over a primary background (the ready pill). */
+    onPrimary?: boolean;
+    className?: string;
+}
+/** UX spec §2.1 — the n/N ring. Real text in the middle, never only the stroke. */
+export declare function ProgressRing({ value, max, size, label, complete, onPrimary, className }: ProgressRingProps): React.JSX.Element;
+//# sourceMappingURL=ProgressRing.d.ts.map

package/dist/components/ProgressRing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressRing.d.ts","sourceRoot":"","sources":["../../src/components/ProgressRing.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,iBAAiB,qBA+B/G"}

package/dist/components/StartTrialAction.d.ts

@@ -0,0 +1,70 @@
+import * as React from 'react';
+import { type MinimumLine, type MinimumsCount } from '../lib/journey-steps';
+import type { Journey, StartTrialResult } from '../types';
+/** What is still missing, worded for a screen: "Falta o horário para iniciar o teste." + where to go. */
+export interface StartTrialMissing {
+    key: string;
+    /** The step's own title when this app has the step; the slot's words otherwise. */
+    title: string;
+    text: string;
+    route?: string;
+}
+export interface StartTrialState {
+    /**
+     * The journey is in setup and the trial has not started: the action means
+     * something. False while the journey is unknown, after the trial started, or
+     * when the plugin is not on in this app (no programs declare a journey and
+     * the server never answered).
+     */
+    available: boolean;
+    ready: boolean;
+    starting: boolean;
+    trialDays: number;
+    /** "Iniciar teste · 14 dias" */
+    label: string;
+    /** The projected end, worded, for a confirmation line. */
+    projectedEnd: string;
+    journey: Journey | null;
+    minimums: MinimumsCount;
+    lines: MinimumLine[];
+    /** The first open minimum, or null when ready. */
+    missing: StartTrialMissing | null;
+    /** The last error or server disagreement, in the house's words. */
+    notice: string | null;
+    /** Runs the RPC through the plugin's store (event emitted there). Resolves null on error, with `notice` set. */
+    start: () => Promise<StartTrialResult | null>;
+    /** The host's permissions allow starting the trial / asking to contract (`SDK_PERMISSIONS.trialManage`). Always true without a host adapter. */
+    allowed: boolean;
+    /** The host's emulator attributes for the start/contract buttons. */
+    markProps: Record<string, string>;
+}
+/**
+ * "Iniciar teste" as a hook: the minimums still missing (declared by the
+ * programs, read from the rows and the server), the copy, the route to the
+ * first missing one, the RPC and the event (through the plugin's store) and the
+ * trial length. An app composes this where it celebrates — the test order's
+ * "Funcionou." pane — without knowing a key, an RPC or an event name.
+ */
+export declare function useStartTrial(): StartTrialState;
+export interface StartTrialActionProps {
+    /** After the trial started (not on "already started"). The app leaves its screen here. */
+    onStarted?: (result: Extract<StartTrialResult, {
+        ok: true;
+    }>) => void;
+    /** Before navigating to the first missing step. Return false to keep the screen. */
+    onNavigate?: (route: string) => boolean | void;
+    /**
+     * `inline` (default) asks once, in the same surface — this action is composed
+     * inside dialogs and a dialog must not stack on a dialog. `none` starts on
+     * the first click.
+     */
+    confirm?: 'inline' | 'none';
+    className?: string;
+}
+/**
+ * The "Iniciar teste · N dias" button an app composes into its own screen, with
+ * the "falta X" line and the way to X when the trial cannot start yet. Draws
+ * nothing while the journey is unknown or once the trial has started.
+ */
+export declare function StartTrialAction({ onStarted, onNavigate, confirm, className }: StartTrialActionProps): React.JSX.Element | null;
+//# sourceMappingURL=StartTrialAction.d.ts.map

package/dist/components/StartTrialAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartTrialAction.d.ts","sourceRoot":"","sources":["../../src/components/StartTrialAction.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAM9B,OAAO,EAC8D,KAAK,WAAW,EAAE,KAAK,aAAa,EACxG,MAAM,sBAAsB,CAAA;AAG7B,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAIzD,yGAAyG;AACzG,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,aAAa,CAAA;IACvB,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,kDAAkD;IAClD,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACjC,mEAAmE;IACnE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,gHAAgH;IAChH,KAAK,EAAE,MAAM,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IAC7C,gJAAgJ;IAChJ,OAAO,EAAE,OAAO,CAAA;IAChB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAiBD;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAqF/C;AAED,MAAM,WAAW,qBAAqB;IACpC,0FAA0F;IAC1F,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,CAAC,KAAK,IAAI,CAAA;IACrE,oFAAoF;IACpF,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAA;IAC9C;;;;OAIG;IACH,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,OAAkB,EAAE,SAAS,EAAE,EAAE,qBAAqB,4BA6D/G"}

package/dist/components/StartTrialCta.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+export { countMinimums } from '../lib/journey-steps';
+/**
+ * The floating "set up your operation" pill of the journey (UX spec §2.3, tech design §7).
+ *
+ * Registered in `shell.sidebar.footer` only to be mounted: it draws nothing in
+ * the rail (the shell's TrialWidget reads the source this widget publishes) and
+ * puts the pill on `document.body` through a portal, because the shell does not
+ * draw `shell.floating` yet (decision 11).
+ */
+export declare function StartTrialCta(): React.ReactPortal | null;
+//# sourceMappingURL=StartTrialCta.d.ts.map

package/dist/components/StartTrialCta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartTrialCta.d.ts","sourceRoot":"","sources":["../../src/components/StartTrialCta.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAgB9B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAqDpD;;;;;;;GAOG;AACH,wBAAgB,aAAa,6BA8B5B"}

package/dist/components/StoreLiveCard.d.ts

@@ -0,0 +1,21 @@
+import * as React from 'react';
+/**
+ * "Sua loja no ar" — the journey as a dashboard card (UX spec §2.1–2.2, moment 3).
+ *
+ * Nine steps and no more: the ones picked by key out of the shell's activation
+ * catalog, the ring counting what is really there, one "AGORA", the done ones
+ * struck through, "Quando quiser" below a separator, and the one call to
+ * action the phase allows. Reads the same rows the Tarefas tab and the
+ * assistant read, so the three never disagree about what is done.
+ */
+export interface StoreLiveCardProps {
+    className?: string;
+    /**
+     * `rail` is the same card at the width of the assistant's Tarefas tab: tighter
+     * padding, no tour anchor (the dashboard card is the tour's stop), and rows
+     * that get out of the way of the screen they open on a phone.
+     */
+    variant?: 'card' | 'rail';
+}
+export declare function StoreLiveCard({ className, variant }: StoreLiveCardProps): React.JSX.Element | null;
+//# sourceMappingURL=StoreLiveCard.d.ts.map

package/dist/components/StoreLiveCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoreLiveCard.d.ts","sourceRoot":"","sources":["../../src/components/StoreLiveCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAiD9B;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC1B;AAED,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,OAAgB,EAAE,EAAE,kBAAkB,4BA8JhF"}

package/dist/components/TrialEndBanner.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+/**
+ * UX spec, moments 10 and 11. Two lines, never at the same time:
+ *
+ *  - D0 (phase `trial`, under 24 h left): the last-day notice, small, dismissable
+ *    for 8 h. The first and only banner before the end — the rail clock carries
+ *    the days until then.
+ *  - `expired`: the plan gates already deny on their own; this is the line that
+ *    says why, and the one click to "Quero contratar", inline, never a modal.
+ */
+export declare function TrialEndBanner(): React.JSX.Element | null;
+//# sourceMappingURL=TrialEndBanner.d.ts.map

package/dist/components/TrialEndBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrialEndBanner.d.ts","sourceRoot":"","sources":["../../src/components/TrialEndBanner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAW9B;;;;;;;;GAQG;AACH,wBAAgB,cAAc,6BA6G7B"}

package/dist/config.d.ts

@@ -0,0 +1,82 @@
+import type { GettingStartedDataProvider } from './data/types';
+/**
+ * What the app adds to the journey the programs already declared.
+ *
+ * The journey is tagged at the source (`OnboardingStepDef.journey`, by the
+ * plugin that owns each step); this is the app's composition on top of it,
+ * by catalog key: a base-list step it wants counted (`team`), a line it wants
+ * outside the total, a minimum the server requires that no program tags.
+ * Everything here is additive and ordered after the tagged steps.
+ */
+export interface JourneyOverride {
+    launch?: string[];
+    later?: string[];
+    extra?: string[];
+    /** Catalog keys of the steps the trial cannot start without. */
+    minimums?: string[];
+}
+/**
+ * The screens the plugin's surfaces open. Every path the plugin navigates to
+ * comes from here; an app (or a host with its own router) overrides any of them.
+ */
+export interface GettingStartedRoutes {
+    /** Where the store-live card lives — the tour's first stop. Default `/`. */
+    home?: string;
+    /** The trial settings (hours, payment methods, the clock): the hours/payments steps and the tour's last stop. Default `/settings/trial`. */
+    trial?: string;
+    /** Where "see the plans" / "subscribe" go (trial-end banner, trial settings). Default `/settings/subscription`. */
+    subscription?: string;
+}
+export interface GettingStartedPluginOptions {
+    /**
+     * Trial length shown in copy before the journey loads. One source in the app
+     * (`billing.trialDays`, the same number the sign-up promises); the pool config
+     * (`plg_getting_started_config.trial_days`) is the truth once it answers, and
+     * a disagreement between the two is reported once per session (see
+     * `noteTrialDaysDivergence`).
+     */
+    trialDays?: number;
+    /** Verticals the program is seeded for. Default: food. */
+    verticals?: string[];
+    /** The app's composition of the journey. See {@link JourneyOverride}. */
+    journey?: JourneyOverride;
+    /** Data provider override (tests, storybook). */
+    dataProvider?: GettingStartedDataProvider;
+    /** Overrides of the screens the surfaces open. See {@link GettingStartedRoutes}. */
+    routes?: GettingStartedRoutes;
+}
+export interface ResolvedGettingStartedConfig {
+    trialDays: number;
+    verticals: string[];
+    journey: Required<JourneyOverride>;
+    /** Every screen the surfaces open, defaults filled. */
+    routes: Required<GettingStartedRoutes>;
+    /** The plugin's own settings tab — where hours and payment methods are edited. Same as `routes.trial`. */
+    trialRoute: string;
+    /** Where "see the plans" goes. Same as `routes.subscription`. */
+    subscriptionRoute: string;
+}
+export declare const DEFAULT_TRIAL_DAYS = 14;
+export declare const TRIAL_ROUTE = "/settings/trial";
+export declare const SUBSCRIPTION_ROUTE = "/settings/subscription";
+export declare const HOME_ROUTE = "/";
+export declare const DEFAULT_ROUTES: Readonly<Required<GettingStartedRoutes>>;
+export declare function resolveRoutes(routes?: GettingStartedRoutes): Required<GettingStartedRoutes>;
+export declare function resolveJourneyOverride(journey?: JourneyOverride): Required<JourneyOverride>;
+export declare function resolveConfig(options?: GettingStartedPluginOptions): ResolvedGettingStartedConfig;
+/**
+ * The config of the manifest in force, for the surfaces an app composes
+ * outside the plugin's own context (`useStartTrial`, `<StartTrialAction/>`).
+ * Set by `createGettingStartedPlugin`; defaults when nothing built one yet.
+ */
+export declare function setActiveConfig(config: ResolvedGettingStartedConfig): void;
+export declare function getActiveConfig(): ResolvedGettingStartedConfig;
+/**
+ * The app's `trialDays` and the pool's disagree: say so once, in the console,
+ * so the number in the copy and the number the clock runs on are reconciled by
+ * someone instead of silently differing. A manifest `diagnostics` entry can
+ * only check that something EXISTS (the table is checked there); comparing
+ * values needs the journey loaded, so it lives here.
+ */
+export declare function noteTrialDaysDivergence(config: Pick<ResolvedGettingStartedConfig, 'trialDays'>, poolTrialDays: number | null | undefined): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AAE9D;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4IAA4I;IAC5I,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mHAAmH;IACnH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,2BAA2B;IAC1C;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,yEAAyE;IACzE,OAAO,CAAC,EAAE,eAAe,CAAA;IACzB,iDAAiD;IACjD,YAAY,CAAC,EAAE,0BAA0B,CAAA;IACzC,oFAAoF;IACpF,MAAM,CAAC,EAAE,oBAAoB,CAAA;CAC9B;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAA;IAClC,uDAAuD;IACvD,MAAM,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAA;IACtC,0GAA0G;IAC1G,UAAU,EAAE,MAAM,CAAA;IAClB,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED,eAAO,MAAM,kBAAkB,KAAK,CAAA;AACpC,eAAO,MAAM,WAAW,oBAAoB,CAAA;AAC5C,eAAO,MAAM,kBAAkB,2BAA2B,CAAA;AAC1D,eAAO,MAAM,UAAU,MAAM,CAAA;AAE7B,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAIlE,CAAA;AAKF,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,QAAQ,CAAC,oBAAoB,CAAC,CAM3F;AAKD,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,CAO3F;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,4BAA4B,CAWjG;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAE1E;AAED,wBAAgB,eAAe,IAAI,4BAA4B,CAE9D;AAID;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,WAAW,CAAC,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAU/I"}

package/dist/context.d.ts

@@ -0,0 +1,33 @@
+import * as React from 'react';
+import type { ResolvedGettingStartedConfig } from './config';
+import type { GettingStartedDataProvider } from './data/types';
+import { type JourneyState } from './store';
+export declare const GettingStartedContextProvider: React.FC<{
+    config: ResolvedGettingStartedConfig;
+    provider: GettingStartedDataProvider;
+    store: import("zustand").StoreApi<JourneyState>;
+    children?: React.ReactNode;
+}>;
+export declare const useGettingStartedConfig: () => ResolvedGettingStartedConfig;
+export declare const useGettingStartedProvider: () => GettingStartedDataProvider;
+export declare const useGettingStartedStore: <T>(selector: (state: JourneyState) => T) => T;
+export interface GettingStartedScope {
+    config: ResolvedGettingStartedConfig;
+    provider: GettingStartedDataProvider;
+}
+/**
+ * The plugin has no page: its surfaces are mounted by the shell (widget zones,
+ * the settings area), so each one is wrapped in the context trio here instead
+ * of under a plugin route.
+ */
+export declare function withGettingStartedContext<P extends object>(Component: React.ComponentType<P>, scope: GettingStartedScope): React.ComponentType<P>;
+/** Loads the journey for the active tenant once; again when the tenant changes. */
+export declare function useEnsureJourney(): void;
+/**
+ * Every surface of the plugin reads the journey declaration (the tagged steps
+ * of the active programs + the app's override) and syncs it before rendering,
+ * so the selectors' default is current even in a surface that only hands them
+ * the catalog.
+ */
+export declare function withJourneyDeclaration<P extends object>(Component: React.ComponentType<P>): React.ComponentType<P>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAA;AAC5D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AAC9D,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,SAAS,CAAA;AAK5D,eAAO,MAAM,6BAA6B;;;;;EAAsB,CAAA;AAChE,eAAO,MAAM,uBAAuB,oCAAgB,CAAA;AACpD,eAAO,MAAM,yBAAyB,kCAAkB,CAAA;AACxD,eAAO,MAAM,sBAAsB,gDAAe,CAAA;AAElD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,4BAA4B,CAAA;IACpC,QAAQ,EAAE,0BAA0B,CAAA;CACrC;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,EACxD,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EACjC,KAAK,EAAE,mBAAmB,GACzB,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAQxB;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,IAAI,IAAI,CAavC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAOlH"}

package/dist/data/index.d.ts

@@ -0,0 +1,5 @@
+export { T, RPC } from './tables';
+export { GettingStartedError, isForbidden, isMissingClock, type GettingStartedDataProvider } from './types';
+export { createSupabaseGettingStartedProvider, mapJourney, mapMinimums, mapStartTrial } from './supabase';
+export { createMockGettingStartedProvider, derivePhase, type MockGettingStartedOptions, type MockGettingStartedProvider, } from './mock';
+//# sourceMappingURL=index.d.ts.map

package/dist/data/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAC3G,OAAO,EAAE,oCAAoC,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AACzG,OAAO,EACL,gCAAgC,EAAE,WAAW,EAC7C,KAAK,yBAAyB,EAAE,KAAK,0BAA0B,GAChE,MAAM,QAAQ,CAAA"}

package/dist/data/mock.d.ts

@@ -0,0 +1,27 @@
+import type { JourneyMinimums, JourneyPhase } from '../types';
+import type { GettingStartedDataProvider } from './types';
+export interface MockGettingStartedOptions {
+    tenantId?: string;
+    /** plg_getting_started_config.trial_days */
+    trialDays?: number;
+    /** The spine DEFAULT on tenants.trial_ends_at (db 044): the preparation window. */
+    setupWindowDays?: number;
+    minimums?: Partial<Omit<JourneyMinimums, 'ready'>>;
+    /** Injectable clock, so a test can walk through the phases without waiting. */
+    now?: () => Date;
+}
+export interface MockGettingStartedProvider extends GettingStartedDataProvider {
+    /** What the sensors would have found. */
+    setMinimums(patch: Partial<Omit<JourneyMinimums, 'ready'>>): void;
+    /** Marks the tenant as paying — the phase becomes `converted`. */
+    markConverted(): void;
+}
+/** The same rules as v_getting_started_journey, so the mock and the pool agree. */
+export declare function derivePhase(input: {
+    now: Date;
+    trialEndsAt: string | null;
+    trialStartedAt: string | null;
+    convertedAt: string | null;
+}): JourneyPhase;
+export declare function createMockGettingStartedProvider(options?: MockGettingStartedOptions): MockGettingStartedProvider;
+//# sourceMappingURL=mock.d.ts.map

package/dist/data/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/data/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,eAAe,EAAE,YAAY,EAA2C,MAAM,UAAU,CAAA;AAC7H,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAEzD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mFAAmF;IACnF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAA;IAClD,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,0BAA2B,SAAQ,0BAA0B;IAC5E,yCAAyC;IACzC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAA;IACjE,kEAAkE;IAClE,aAAa,IAAI,IAAI,CAAA;CACtB;AAKD,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,GAAG,EAAE,IAAI,CAAA;IACT,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B,GAAG,YAAY,CAKf;AAED,wBAAgB,gCAAgC,CAAC,OAAO,GAAE,yBAA8B,GAAG,0BAA0B,CAwFpH"}

package/dist/data/supabase.d.ts

@@ -0,0 +1,10 @@
+import type { Journey, JourneyMinimums, StartTrialResult } from '../types';
+import { type GettingStartedDataProvider } from './types';
+type Row = Record<string, unknown>;
+export declare function mapMinimums(raw: unknown): JourneyMinimums;
+/** The jsonb `getting_started_journey()` answers, as the plugin reads it. */
+export declare function mapJourney(raw: Row): Journey;
+export declare function mapStartTrial(raw: Row): StartTrialResult;
+export declare function createSupabaseGettingStartedProvider(): GettingStartedDataProvider;
+export {};
+//# sourceMappingURL=supabase.d.ts.map

package/dist/data/supabase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../src/data/supabase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAgB,eAAe,EAA4C,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAClI,OAAO,EAAuB,KAAK,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAG9E,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAkBlC,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAMzD;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAgB5C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,gBAAgB,CAWxD;AAoBD,wBAAgB,oCAAoC,IAAI,0BAA0B,CA+BjF"}

package/dist/data/tables.d.ts

@@ -0,0 +1,15 @@
+export declare const T: {
+    readonly config: "plg_getting_started_config";
+    readonly journeys: "plg_getting_started_journeys";
+    readonly events: "plg_getting_started_events";
+    readonly journeyView: "v_getting_started_journey";
+};
+export declare const RPC: {
+    readonly journey: "getting_started_journey";
+    readonly startTrial: "getting_started_start_trial";
+    readonly requestContract: "getting_started_request_contract";
+    readonly isPlatformOperator: "getting_started_is_platform_operator";
+    readonly platformJourneys: "getting_started_platform_journeys";
+    readonly trialSet: "getting_started_trial_set";
+};
+//# sourceMappingURL=tables.d.ts.map

package/dist/data/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../src/data/tables.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,CAAC;;;;;CAKJ,CAAA;AAEV,eAAO,MAAM,GAAG;;;;;;;CAQN,CAAA"}

package/dist/data/types.d.ts

@@ -0,0 +1,24 @@
+import type { Journey, JourneyEvent, RequestContractResult, StartTrialResult } from '../types';
+export interface GettingStartedDataProvider {
+    /** Phase, dates and minimums for the active tenant. `null` when there is no tenant in scope. */
+    getJourney(): Promise<Journey | null>;
+    /** Idempotent: a trial already running answers `alreadyStarted` without touching the date. */
+    startTrial(): Promise<StartTrialResult>;
+    /** "Quero contratar". Once a day per tenant — the second call answers `alreadyRequestedToday`. */
+    requestContract(note?: string): Promise<RequestContractResult>;
+    /** The tenant's timeline, newest first. */
+    listEvents(limit?: number): Promise<JourneyEvent[]>;
+}
+/** Thrown by the Supabase provider; `code` is the SQLSTATE when the pool refused. */
+export declare class GettingStartedError extends Error {
+    code?: string;
+    constructor(message: string, code?: string);
+}
+export declare function isForbidden(error: unknown): boolean;
+/**
+ * The pool has no clock yet: `getting_started_journey` / `getting_started_start_trial`
+ * are not there (migration 000/001 not applied). PostgREST answers PGRST202,
+ * Postgres 42883; a mock or a proxy may only carry the sentence.
+ */
+export declare function isMissingClock(error: unknown): boolean;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/data/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAE9F,MAAM,WAAW,0BAA0B;IACzC,gGAAgG;IAChG,UAAU,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IACrC,8FAA8F;IAC9F,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACvC,kGAAkG;IAClG,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC9D,2CAA2C;IAC3C,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;CACpD;AAED,qFAAqF;AACrF,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAA;gBACD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAK3C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAItD"}

package/dist/host.d.ts

@@ -0,0 +1,93 @@
+import * as React from 'react';
+import { type OnboardingProgramDef, type OnboardingTourDef, type PluginAITool } from '@fayz-ai/core';
+import { type ActivationBackend, type HostPermissionsAdapter } from '@fayz-ai/admin/host';
+import { type GettingStartedPluginOptions, type ResolvedGettingStartedConfig } from './config';
+import type { GettingStartedDataProvider } from './data/types';
+import { type StoreSettingsProvider } from './lib/store-settings';
+import { type StoreProfileProvider } from './lib/store-profile';
+import { type JourneyTourMoment } from './lib/tour';
+import { type StoreLiveCardProps } from './components/StoreLiveCard';
+import { type StartTrialActionProps } from './components/StartTrialAction';
+export interface GettingStartedHostOptions extends Omit<GettingStartedPluginOptions, 'dataProvider'> {
+    /** Journey, start trial, "quero contratar", timeline — the host's backend. Required: there is no platform default here. */
+    dataProvider: GettingStartedDataProvider;
+    /** Where the activation checklist rows live. Omitted: the platform `tasks` table (only right on the platform). */
+    activation?: ActivationBackend;
+    /** Where hours and payment methods live. Omitted: `tenants.settings.store` (only right on the platform). */
+    storeSettings?: StoreSettingsProvider;
+    /**
+     * Where the store profile ("how the house serves") lives. Omitted: the
+     * profile step is dropped from the programs and `saveStoreProfile` is not
+     * offered nor registered — a host never writes the platform's questionnaire.
+     */
+    storeProfile?: StoreProfileProvider;
+    /** The host's permission engine for the start-trial / contract / confirm / create-task buttons. Omitted: allow-all. */
+    permissions?: HostPermissionsAdapter;
+    /**
+     * The programs whose steps make the checklist. Default: the store-live
+     * program alone (`buildStoreLiveProgram`). Without `storeProfile`, the
+     * store-live program's profile step is removed from whatever is passed.
+     */
+    programs?: OnboardingProgramDef[];
+    /** The tour's opening stops, anchored on the host's DOM. Default: the plugin's own (`data-tour` anchors). */
+    tour?: OnboardingTourDef;
+    /** Routes the host can open; a step whose route is not here keeps its title and loses its link. Default: every route. */
+    hasRoute?: (route: string) => boolean;
+    /** Register the client handlers of `aiTools` (the assistant runs them in the browser). Default true. */
+    registerToolHandlers?: boolean;
+}
+export interface GettingStartedHost {
+    config: ResolvedGettingStartedConfig;
+    provider: GettingStartedDataProvider;
+    programs: OnboardingProgramDef[];
+    /**
+     * Mount once, high in the host's tree, where the org and the user are
+     * painted: runs the checklist (rows, sensors) and the tour spotlight. The
+     * surfaces below render without it, but nothing ticks.
+     */
+    Provider: React.ComponentType<{
+        children?: React.ReactNode;
+    }>;
+    /** The home card ("Sua loja no ar", n/9). */
+    StoreLiveCard: React.ComponentType<Omit<StoreLiveCardProps, 'variant'>>;
+    /** The same card for the top of the Tasks tab: pass as `<TasksPanel top={<RailTasksBlock/>}/>`. */
+    RailTasksBlock: React.ComponentType;
+    /** The floating "Iniciar teste · N dias" pill (portals itself). */
+    StartTrialCta: React.ComponentType;
+    /** The button an app composes into its own screen. */
+    StartTrialAction: React.ComponentType<StartTrialActionProps>;
+    /** The end-of-trial banner for the top bar. */
+    TrialEndBanner: React.ComponentType;
+    /** The trial settings (hours, payment methods, the journey). Optional surface. */
+    TrialSettingsTab: React.ComponentType;
+    tour: {
+        id: string;
+        /** Starts the journey tour now; without `force` only once per tenant. */
+        start: (opts?: {
+            force?: boolean;
+            moment?: JourneyTourMoment;
+        }) => boolean;
+    };
+    /** The assistant tools to hand to the host's agent transport. */
+    aiTools: PluginAITool[];
+    /** Restores every platform default this host installed (backends, permissions, programs). */
+    dispose: () => void;
+}
+/**
+ * The getting-started surfaces for a host that does not run AdminShell nor the
+ * plugin runtime (a legacy product mounting them slot by slot). Everything the
+ * plugin would read from the platform is injected here; nothing below assumes
+ * the platform's tables.
+ */
+export declare function createGettingStartedHost(options: GettingStartedHostOptions): GettingStartedHost;
+export { buildStoreLiveProgram, withoutStoreProfileStep, storeSetupRouting, hasOpeningHours, hasPaymentMethods, PROGRAM_ID as STORE_LIVE_PROGRAM_ID, type BuildStoreLiveProgramInput, } from './lib/program';
+export { journeyTour, buildOwnJourneyTour, buildJourneyTour, buildJourneyClosingStop, JOURNEY_TOUR_ID, CARD_ANCHOR as STORE_LIVE_CARD_ANCHOR, TRIAL_TAB_ANCHOR, } from './lib/tour';
+export { resolveConfig, resolveRoutes, DEFAULT_ROUTES, type GettingStartedRoutes, type ResolvedGettingStartedConfig } from './config';
+export { STORE_PROFILE_STEP_KEY, SERVICE_MODES, OPERATIONS, DELIVERY_METHODS, TABLE_BANDS, PROFILE_KEYS, storeProfileFrom, storeProfileFromAnswers, storeProfileToAnswers, storeProfileAnswered, type StoreProfile, type StoreProfileProvider, type SaveStoreProfileWriteResult, type StoreOperation, type StoreServiceMode, type StoreDeliveryMethod, type StoreTableBand, } from './lib/store-profile';
+export { SAVE_PROFILE_TOOL } from './lib/agent-tools';
+export type { GettingStartedDataProvider } from './data/types';
+export type { StoreSettingsProvider, StoreSettingKey, SaveStoreSettingResult } from './lib/store-settings';
+export type { ActivationBackend, HostPermissionsAdapter } from '@fayz-ai/admin/host';
+export type { Journey, JourneyPhase, JourneyMinimums, JourneyEvent, StartTrialResult, RequestContractResult, StoreHours, PaymentMethod } from './types';
+export { GettingStartedError, isForbidden, isMissingClock, createMockGettingStartedProvider } from './data';
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

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

package/dist/host.js

@@ -0,0 +1,78 @@
+import { resolveConfig, setActiveConfig, setJourneyOverride, gettingStartedLocales, useJourneyStore, registerGettingStartedToolHandlers, configureStoreSettings, configureStoreProfile, buildStoreLiveProgram, withoutStoreProfileStep, setHostJourneyPrograms, useJourneyTourStore, JOURNEY_TOUR_ID, gettingStartedAiToolsFor, startJourneyTour, withGettingStartedContext, withJourneyDeclaration, TrialSettingsTab, TrialEndBanner, StartTrialAction, StartTrialCta, StoreLiveCard } from './chunk-QAYRR3A4.js';
+export { DEFAULT_ROUTES, DELIVERY_METHODS, GettingStartedError, JOURNEY_TOUR_ID, OPERATIONS, PROFILE_KEYS, SAVE_PROFILE_TOOL, SERVICE_MODES, CARD_ANCHOR as STORE_LIVE_CARD_ANCHOR, PROGRAM_ID as STORE_LIVE_PROGRAM_ID, STORE_PROFILE_STEP_KEY, TABLE_BANDS, TRIAL_TAB_ANCHOR, buildJourneyClosingStop, buildJourneyTour, buildOwnJourneyTour, buildStoreLiveProgram, createMockGettingStartedProvider, hasOpeningHours, hasPaymentMethods, isForbidden, isMissingClock, journeyTour, resolveConfig, resolveRoutes, storeProfileAnswered, storeProfileFrom, storeProfileFromAnswers, storeProfileToAnswers, storeSetupRouting, withoutStoreProfileStep } from './chunk-QAYRR3A4.js';
+import { registerTranslations } from '@fayz-ai/core';
+import { configureActivationBackend, configurePermissions, HostActivationProvider } from '@fayz-ai/admin/host';
+import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
+
+function createGettingStartedHost(options) {
+  const config = resolveConfig(options);
+  setActiveConfig(config);
+  setJourneyOverride(config.journey);
+  registerTranslations(gettingStartedLocales);
+  const provider = options.dataProvider;
+  const profile = !!options.storeProfile;
+  useJourneyStore.getState().bind(provider);
+  if (options.registerToolHandlers !== false) registerGettingStartedToolHandlers(useJourneyStore, { profile });
+  if (options.activation) configureActivationBackend(options.activation);
+  if (options.storeSettings) configureStoreSettings(options.storeSettings);
+  if (options.storeProfile) configureStoreProfile(options.storeProfile);
+  if (options.permissions) configurePermissions(options.permissions);
+  const given = options.programs ?? [buildStoreLiveProgram({ provider, config, profile })];
+  const programs = profile ? given : given.map(withoutStoreProfileStep);
+  setHostJourneyPrograms(programs);
+  if (options.tour) {
+    useJourneyTourStore.getState().rememberRuntime({
+      onboardingTours: [{
+        ...options.tour,
+        pluginId: "getting-started",
+        pluginName: "Getting started",
+        order: options.tour.order ?? 0,
+        when: options.tour.when ?? "trial_started"
+      }]
+    });
+  }
+  const scope = { config, provider };
+  const surface = (Component, name) => {
+    const Wrapped = withGettingStartedContext(withJourneyDeclaration(Component), scope);
+    Wrapped.displayName = `GettingStartedHost(${name})`;
+    return Wrapped;
+  };
+  const hasRoute = options.hasRoute;
+  function Provider({ children }) {
+    return /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(HostActivationProvider, { programs, hasRoute }),
+      children
+    ] });
+  }
+  const RailBlock = () => /* @__PURE__ */ jsx(StoreLiveCard, { variant: "rail" });
+  return {
+    config,
+    provider,
+    programs,
+    Provider,
+    StoreLiveCard: surface(StoreLiveCard, "StoreLiveCard"),
+    RailTasksBlock: surface(RailBlock, "RailTasksBlock"),
+    StartTrialCta: surface(StartTrialCta, "StartTrialCta"),
+    StartTrialAction: surface(StartTrialAction, "StartTrialAction"),
+    TrialEndBanner: surface(TrialEndBanner, "TrialEndBanner"),
+    TrialSettingsTab: surface(TrialSettingsTab, "TrialSettingsTab"),
+    tour: {
+      id: JOURNEY_TOUR_ID,
+      start: (opts) => startJourneyTour({ force: opts?.force, moment: opts?.moment ?? "manual" })
+    },
+    aiTools: gettingStartedAiToolsFor({ profile }),
+    dispose: () => {
+      if (options.activation) configureActivationBackend(null);
+      if (options.storeSettings) configureStoreSettings(null);
+      if (options.storeProfile) configureStoreProfile(null);
+      if (options.permissions) configurePermissions(null);
+      setHostJourneyPrograms(void 0);
+      if (options.tour) useJourneyTourStore.getState().rememberRuntime(null);
+      useJourneyStore.getState().reset();
+    }
+  };
+}
+
+export { createGettingStartedHost };
+//# sourceMappingURL=host.js.map
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/host.tsx"],"names":[],"mappings":"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","file":"host.js","sourcesContent":["import * as React from 'react'\nimport { registerTranslations, type OnboardingProgramDef, type OnboardingTourDef, type PluginAITool } from '@fayz-ai/core'\nimport {\n  HostActivationProvider, configureActivationBackend, configurePermissions,\n  type ActivationBackend, type HostPermissionsAdapter,\n} from '@fayz-ai/admin/host'\nimport { resolveConfig, setActiveConfig, type GettingStartedPluginOptions, type ResolvedGettingStartedConfig } from './config'\nimport { withGettingStartedContext, withJourneyDeclaration } from './context'\nimport type { GettingStartedDataProvider } from './data/types'\nimport { setHostJourneyPrograms, setJourneyOverride } from './lib/journey-steps'\nimport { buildStoreLiveProgram, withoutStoreProfileStep } from './lib/program'\nimport { configureStoreSettings, type StoreSettingsProvider } from './lib/store-settings'\nimport { configureStoreProfile, type StoreProfileProvider } from './lib/store-profile'\nimport { JOURNEY_TOUR_ID, startJourneyTour, useJourneyTourStore, type JourneyTourMoment } from './lib/tour'\nimport { gettingStartedAiToolsFor, registerGettingStartedToolHandlers } from './lib/agent-tools'\nimport { useJourneyStore } from './store'\nimport { gettingStartedLocales } from './locales'\nimport { StoreLiveCard as StoreLiveCardView, type StoreLiveCardProps } from './components/StoreLiveCard'\nimport { StartTrialCta as StartTrialCtaView } from './components/StartTrialCta'\nimport { StartTrialAction as StartTrialActionView, type StartTrialActionProps } from './components/StartTrialAction'\nimport { TrialEndBanner as TrialEndBannerView } from './components/TrialEndBanner'\nimport { TrialSettingsTab as TrialSettingsTabView } from './settings/TrialSettingsTab'\n\nexport interface GettingStartedHostOptions extends Omit<GettingStartedPluginOptions, 'dataProvider'> {\n  /** Journey, start trial, \"quero contratar\", timeline — the host's backend. Required: there is no platform default here. */\n  dataProvider: GettingStartedDataProvider\n  /** Where the activation checklist rows live. Omitted: the platform `tasks` table (only right on the platform). */\n  activation?: ActivationBackend\n  /** Where hours and payment methods live. Omitted: `tenants.settings.store` (only right on the platform). */\n  storeSettings?: StoreSettingsProvider\n  /**\n   * Where the store profile (\"how the house serves\") lives. Omitted: the\n   * profile step is dropped from the programs and `saveStoreProfile` is not\n   * offered nor registered — a host never writes the platform's questionnaire.\n   */\n  storeProfile?: StoreProfileProvider\n  /** The host's permission engine for the start-trial / contract / confirm / create-task buttons. Omitted: allow-all. */\n  permissions?: HostPermissionsAdapter\n  /**\n   * The programs whose steps make the checklist. Default: the store-live\n   * program alone (`buildStoreLiveProgram`). Without `storeProfile`, the\n   * store-live program's profile step is removed from whatever is passed.\n   */\n  programs?: OnboardingProgramDef[]\n  /** The tour's opening stops, anchored on the host's DOM. Default: the plugin's own (`data-tour` anchors). */\n  tour?: OnboardingTourDef\n  /** Routes the host can open; a step whose route is not here keeps its title and loses its link. Default: every route. */\n  hasRoute?: (route: string) => boolean\n  /** Register the client handlers of `aiTools` (the assistant runs them in the browser). Default true. */\n  registerToolHandlers?: boolean\n}\n\nexport interface GettingStartedHost {\n  config: ResolvedGettingStartedConfig\n  provider: GettingStartedDataProvider\n  programs: OnboardingProgramDef[]\n  /**\n   * Mount once, high in the host's tree, where the org and the user are\n   * painted: runs the checklist (rows, sensors) and the tour spotlight. The\n   * surfaces below render without it, but nothing ticks.\n   */\n  Provider: React.ComponentType<{ children?: React.ReactNode }>\n  /** The home card (\"Sua loja no ar\", n/9). */\n  StoreLiveCard: React.ComponentType<Omit<StoreLiveCardProps, 'variant'>>\n  /** The same card for the top of the Tasks tab: pass as `<TasksPanel top={<RailTasksBlock/>}/>`. */\n  RailTasksBlock: React.ComponentType\n  /** The floating \"Iniciar teste · N dias\" pill (portals itself). */\n  StartTrialCta: React.ComponentType\n  /** The button an app composes into its own screen. */\n  StartTrialAction: React.ComponentType<StartTrialActionProps>\n  /** The end-of-trial banner for the top bar. */\n  TrialEndBanner: React.ComponentType\n  /** The trial settings (hours, payment methods, the journey). Optional surface. */\n  TrialSettingsTab: React.ComponentType\n  tour: {\n    id: string\n    /** Starts the journey tour now; without `force` only once per tenant. */\n    start: (opts?: { force?: boolean; moment?: JourneyTourMoment }) => boolean\n  }\n  /** The assistant tools to hand to the host's agent transport. */\n  aiTools: PluginAITool[]\n  /** Restores every platform default this host installed (backends, permissions, programs). */\n  dispose: () => void\n}\n\n/**\n * The getting-started surfaces for a host that does not run AdminShell nor the\n * plugin runtime (a legacy product mounting them slot by slot). Everything the\n * plugin would read from the platform is injected here; nothing below assumes\n * the platform's tables.\n */\nexport function createGettingStartedHost(options: GettingStartedHostOptions): GettingStartedHost {\n  const config = resolveConfig(options)\n  setActiveConfig(config)\n  setJourneyOverride(config.journey)\n  registerTranslations(gettingStartedLocales)\n\n  const provider = options.dataProvider\n  const profile = !!options.storeProfile\n  useJourneyStore.getState().bind(provider)\n  if (options.registerToolHandlers !== false) registerGettingStartedToolHandlers(useJourneyStore, { profile })\n  if (options.activation) configureActivationBackend(options.activation)\n  if (options.storeSettings) configureStoreSettings(options.storeSettings)\n  if (options.storeProfile) configureStoreProfile(options.storeProfile)\n  if (options.permissions) configurePermissions(options.permissions)\n\n  const given = options.programs ?? [buildStoreLiveProgram({ provider, config, profile })]\n  const programs = profile ? given : given.map(withoutStoreProfileStep)\n  setHostJourneyPrograms(programs)\n  if (options.tour) {\n    useJourneyTourStore.getState().rememberRuntime({\n      onboardingTours: [{\n        ...options.tour,\n        pluginId: 'getting-started',\n        pluginName: 'Getting started',\n        order: options.tour.order ?? 0,\n        when: options.tour.when ?? 'trial_started',\n      }],\n    })\n  }\n\n  const scope = { config, provider }\n  const surface = <P extends object>(Component: React.ComponentType<P>, name: string): React.ComponentType<P> => {\n    const Wrapped = withGettingStartedContext(withJourneyDeclaration(Component), scope)\n    Wrapped.displayName = `GettingStartedHost(${name})`\n    return Wrapped\n  }\n\n  const hasRoute = options.hasRoute\n  function Provider({ children }: { children?: React.ReactNode }) {\n    return (\n      <>\n        <HostActivationProvider programs={programs} hasRoute={hasRoute} />\n        {children}\n      </>\n    )\n  }\n\n  const RailBlock = () => <StoreLiveCardView variant=\"rail\" />\n\n  return {\n    config,\n    provider,\n    programs,\n    Provider,\n    StoreLiveCard: surface(StoreLiveCardView as React.ComponentType<Omit<StoreLiveCardProps, 'variant'>>, 'StoreLiveCard'),\n    RailTasksBlock: surface(RailBlock, 'RailTasksBlock'),\n    StartTrialCta: surface(StartTrialCtaView, 'StartTrialCta'),\n    StartTrialAction: surface(StartTrialActionView, 'StartTrialAction'),\n    TrialEndBanner: surface(TrialEndBannerView, 'TrialEndBanner'),\n    TrialSettingsTab: surface(TrialSettingsTabView, 'TrialSettingsTab'),\n    tour: {\n      id: JOURNEY_TOUR_ID,\n      start: (opts) => startJourneyTour({ force: opts?.force, moment: opts?.moment ?? 'manual' }),\n    },\n    aiTools: gettingStartedAiToolsFor({ profile }),\n    dispose: () => {\n      if (options.activation) configureActivationBackend(null)\n      if (options.storeSettings) configureStoreSettings(null)\n      if (options.storeProfile) configureStoreProfile(null)\n      if (options.permissions) configurePermissions(null)\n      setHostJourneyPrograms(undefined)\n      if (options.tour) useJourneyTourStore.getState().rememberRuntime(null)\n      useJourneyStore.getState().reset()\n    },\n  }\n}\n\n// Composition: what a host needs to build its own programs and tour from the plugin's.\nexport {\n  buildStoreLiveProgram, withoutStoreProfileStep, storeSetupRouting, hasOpeningHours, hasPaymentMethods,\n  PROGRAM_ID as STORE_LIVE_PROGRAM_ID, type BuildStoreLiveProgramInput,\n} from './lib/program'\nexport {\n  journeyTour, buildOwnJourneyTour, buildJourneyTour, buildJourneyClosingStop, JOURNEY_TOUR_ID,\n  CARD_ANCHOR as STORE_LIVE_CARD_ANCHOR, TRIAL_TAB_ANCHOR,\n} from './lib/tour'\nexport { resolveConfig, resolveRoutes, DEFAULT_ROUTES, type GettingStartedRoutes, type ResolvedGettingStartedConfig } from './config'\nexport {\n  STORE_PROFILE_STEP_KEY, SERVICE_MODES, OPERATIONS, DELIVERY_METHODS, TABLE_BANDS, PROFILE_KEYS,\n  storeProfileFrom, storeProfileFromAnswers, storeProfileToAnswers, storeProfileAnswered,\n  type StoreProfile, type StoreProfileProvider, type SaveStoreProfileWriteResult,\n  type StoreOperation, type StoreServiceMode, type StoreDeliveryMethod, type StoreTableBand,\n} from './lib/store-profile'\nexport { SAVE_PROFILE_TOOL } from './lib/agent-tools'\nexport type { GettingStartedDataProvider } from './data/types'\nexport type { StoreSettingsProvider, StoreSettingKey, SaveStoreSettingResult } from './lib/store-settings'\nexport type { ActivationBackend, HostPermissionsAdapter } from '@fayz-ai/admin/host'\nexport type { Journey, JourneyPhase, JourneyMinimums, JourneyEvent, StartTrialResult, RequestContractResult, StoreHours, PaymentMethod } from './types'\nexport { GettingStartedError, isForbidden, isMissingClock, createMockGettingStartedProvider } from './data'\n"]}