@carlonicora/nextjs-jsonapi 6.20.4 → 6.20.6

package/dist/features/rbac/data/RbacService.d.ts

@@ -0,0 +1,49 @@
+import { AbstractService } from "../../../core";
+import type { RbacMatrix } from "./RbacTypes";
+/**
+ * RbacService — fetches RBAC configuration for the admin UI.
+ *
+ * Declarative-matrix methods (`fetchMatrix`, `saveMatrix`) talk to the
+ * dev-only endpoints added in
+ * `packages/nestjs-neo4jsonapi/.../rbac-dev.controller.ts`. The controller
+ * speaks JSON:API (singleton resource with `type: "rbac-matrix"`, `id:
+ * "singleton"`), so these methods go through the standard `callApi()`
+ * pipeline like every other service in the codebase.
+ *
+ * The backend only registers these routes when `devMode` is enabled on
+ * `RbacModule.register` (see `apps/api/src/features/features.modules.ts`).
+ * In production the routes return 404; callers should guard with a dev-mode
+ * check.
+ */
+export declare class RbacService extends AbstractService {
+    /**
+     * Fetch the current RBAC matrix plus each module's known BFS relationship
+     * paths (used by the permission picker as scope suggestions).
+     *
+     * Dev-only endpoint — see class header.
+     */
+    static fetchMatrix(): Promise<{
+        matrix: RbacMatrix;
+        modulePaths: Record<string, readonly string[]>;
+    }>;
+    /**
+     * Persist a matrix back to the declarative `permissions.ts` file.
+     *
+     * The backend serializes the matrix to formatted TypeScript using the
+     * provided `roleNames` / `moduleNames` lookup tables (so the emitted file
+     * references `RoleId.X` / `ModuleId.X` rather than raw UUIDs) and writes
+     * it to `outputPath` (absolute, or relative to the repo root).
+     *
+     * Dev-only endpoint — see class header.
+     */
+    static saveMatrix(args: {
+        matrix: RbacMatrix;
+        roleNames: Record<string, string>;
+        moduleNames: Record<string, string>;
+        outputPath: string;
+    }): Promise<{
+        bytesWritten: number;
+        path: string;
+    }>;
+}
+//# sourceMappingURL=RbacService.d.ts.map

package/dist/features/rbac/data/RbacService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RbacService.d.ts","sourceRoot":"","sources":["../../../../src/features/rbac/data/RbacService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwC,MAAM,eAAe,CAAC;AAEtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAY,SAAQ,eAAe;IAC9C;;;;;OAKG;WACU,WAAW,IAAI,OAAO,CAAC;QAClC,MAAM,EAAE,UAAU,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;KAChD,CAAC;IAeF;;;;;;;;;OASG;WACU,UAAU,CAAC,IAAI,EAAE;QAC5B,MAAM,EAAE,UAAU,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAepD"}

package/dist/features/rbac/data/RbacTypes.d.ts

@@ -0,0 +1,42 @@
+export declare const COMPANY_ADMINISTRATOR_ROLE_ID = "2e1eee00-6cba-4506-9059-ccd24e4ea5b0";
+export type PermissionValue = boolean | string;
+export type ActionType = "read" | "create" | "update" | "delete";
+export declare const ACTION_TYPES: ActionType[];
+/** The permissions object shape used by both Module and PermissionMapping entities */
+export type PermissionsMap = {
+    create?: PermissionValue;
+    read?: PermissionValue;
+    update?: PermissionValue;
+    delete?: PermissionValue;
+};
+/**
+ * Declarative-RBAC matrix types.
+ *
+ * Mirror of the library types defined in
+ * `packages/nestjs-neo4jsonapi/src/foundations/rbac/dsl/types.ts`.
+ * Frontend does not import from backend, so the shape is redefined here.
+ *
+ * A `PermToken` represents a single permission entry:
+ *  - `scope: true`  → unconditional (e.g. full read of the module)
+ *  - `scope: false` → nothing (rarely used, mostly a placeholder)
+ *  - `scope: "path"` → scoped by relationship path (e.g. "orders.account")
+ */
+export type PermToken = {
+    action: string;
+    scope: boolean | string;
+};
+/**
+ * A per-module block of the matrix. Always has a `default` row (permissions
+ * granted to every role). Additional keys are role IDs → role-specific
+ * permission tokens that are unioned with `default` to produce the effective
+ * permissions for that role in that module.
+ */
+export type RbacModuleBlock = {
+    default: PermToken[];
+} & Record<string, PermToken[]>;
+/**
+ * The full RBAC matrix as served by the dev endpoint `GET /_dev/rbac/matrix`.
+ * Keys are module IDs; values are module blocks.
+ */
+export type RbacMatrix = Record<string, RbacModuleBlock>;
+//# sourceMappingURL=RbacTypes.d.ts.map

package/dist/features/rbac/data/RbacTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RbacTypes.d.ts","sourceRoot":"","sources":["../../../../src/features/rbac/data/RbacTypes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,6BAA6B,yCAAyC,CAAC;AAEpF,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;AAE/C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjE,eAAO,MAAM,YAAY,EAAE,UAAU,EAA2C,CAAC;AAEjF,sFAAsF;AACtF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAA;CAAE,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,OAAO,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;AAErF;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC"}

package/dist/features/rbac/data/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./RbacTypes";
+export * from "./PermissionMapping";
+export * from "./PermissionMappingInterface";
+export * from "./ModulePaths";
+export * from "./ModulePathsInterface";
+export * from "./RbacMatrixModel";
+export * from "./RbacService";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/features/rbac/data/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC"}

package/dist/features/rbac/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./data";
+export { RbacContainer } from "./components/RbacContainer";
+export { RbacByRoleContainer } from "./components/RbacByRoleContainer";
+export { RbacPermissionCell } from "./components/RbacPermissionCell";
+export { RbacPermissionPicker } from "./components/RbacPermissionPicker";
+export { PermissionMappingModule, ModulePathsModule, RbacMatrixModule } from "./rbac.module";
+//# sourceMappingURL=index.d.ts.map

package/dist/features/rbac/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/rbac/index.ts"],"names":[],"mappings":"AACA,cAAc,QAAQ,CAAC;AAGvB,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAGzE,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/features/rbac/rbac.module.d.ts

@@ -0,0 +1,11 @@
+import { ModuleFactory } from "../../permissions";
+export declare const PermissionMappingModule: (factory: ModuleFactory) => import("../..").ModuleWithPermissions;
+export declare const ModulePathsModule: (factory: ModuleFactory) => import("../..").ModuleWithPermissions;
+/**
+ * Dev-only matrix module. The `name` is the URL path of the dev singleton
+ * endpoint (`GET|PUT _dev/rbac/matrix`), NOT a plural resource collection.
+ * This module is only useful when the backend is running with `devMode: true`
+ * on `RbacModule.register`.
+ */
+export declare const RbacMatrixModule: (factory: ModuleFactory) => import("../..").ModuleWithPermissions;
+//# sourceMappingURL=rbac.module.d.ts.map

package/dist/features/rbac/rbac.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rbac.module.d.ts","sourceRoot":"","sources":["../../../src/features/rbac/rbac.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKlD,eAAO,MAAM,uBAAuB,GAAI,SAAS,aAAa,0CAM1D,CAAC;AAEL,eAAO,MAAM,iBAAiB,GAAI,SAAS,aAAa,0CAMpD,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,aAAa,0CAInD,CAAC"}

package/dist/features/referral/components/ReferralCodeCapture.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ReferralCodeCapture captures referral codes from URL parameters.
+ *
+ * Behavior:
+ * - Checks if referral feature is enabled before processing
+ * - Reads the configured query param (default "ref") from the URL
+ * - Checks if a referral cookie already exists
+ * - If ref param is present AND no existing cookie, sets the cookie (first referrer wins)
+ * - Renders nothing (null) - component only captures the code
+ */
+export declare function ReferralCodeCapture(): null;
+//# sourceMappingURL=ReferralCodeCapture.d.ts.map

package/dist/features/referral/components/ReferralCodeCapture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferralCodeCapture.d.ts","sourceRoot":"","sources":["../../../../src/features/referral/components/ReferralCodeCapture.tsx"],"names":[],"mappings":"AASA;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAyB1C"}

package/dist/features/referral/components/ReferralDialog.d.ts

@@ -0,0 +1,55 @@
+import { ReferralWidgetProps, ReferralWidgetTranslations } from "./ReferralWidget";
+/**
+ * Translation strings for the ReferralDialog component.
+ * Extends ReferralWidgetTranslations with dialog-specific strings.
+ */
+export interface ReferralDialogTranslations extends ReferralWidgetTranslations {
+    /** Dialog title (default: `referral.title`) */
+    dialogTitle?: string;
+    /** Dialog description (default: `referral.description`) */
+    dialogDescription?: string;
+}
+/**
+ * Props for the ReferralDialog component.
+ */
+export interface ReferralDialogProps extends Omit<ReferralWidgetProps, "isDialog" | "translations"> {
+    /** Whether the dialog is open */
+    open: boolean;
+    /** Callback when the dialog open state changes */
+    onOpenChange: (open: boolean) => void;
+    /** Custom translations to override defaults */
+    translations?: ReferralDialogTranslations;
+    /** Additional CSS class name for the dialog content */
+    dialogClassName?: string;
+}
+/**
+ * ReferralDialog displays the ReferralWidget in a modal dialog.
+ *
+ * Features:
+ * - Feature flag awareness (renders null when disabled)
+ * - Uses shadcn Dialog components
+ * - Passes through all ReferralWidget props
+ * - Customizable translations including dialog-specific text
+ *
+ * @example
+ * ```tsx
+ * import { ReferralDialog } from "@carlonicora/nextjs-jsonapi/components";
+ *
+ * // Basic usage
+ * const [open, setOpen] = useState(false);
+ * <ReferralDialog open={open} onOpenChange={setOpen} />
+ *
+ * // With custom translations
+ * <ReferralDialog
+ *   open={open}
+ *   onOpenChange={setOpen}
+ *   translations={{
+ *     dialogTitle: t("referral.title"),
+ *     dialogDescription: t("referral.description"),
+ *     yourLink: t("referral.yourLink"),
+ *   }}
+ * />
+ * ```
+ */
+export declare function ReferralDialog({ open, onOpenChange, translations, dialogClassName, ...widgetProps }: ReferralDialogProps): import("react").JSX.Element | null;
+//# sourceMappingURL=ReferralDialog.d.ts.map

package/dist/features/referral/components/ReferralDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferralDialog.d.ts","sourceRoot":"","sources":["../../../../src/features/referral/components/ReferralDialog.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAkB,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAEnG;;;GAGG;AACH,MAAM,WAAW,0BAA2B,SAAQ,0BAA0B;IAC5E,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,UAAU,GAAG,cAAc,CAAC;IACjG,iCAAiC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,kDAAkD;IAClD,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,0BAA0B,CAAC;IAC1C,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,GAAG,WAAW,EACf,EAAE,mBAAmB,sCAqBrB"}

package/dist/features/referral/components/ReferralWidget.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Translation strings for the ReferralWidget component.
+ * All strings are optional: each defaults to its `referral.*` key in the
+ * library's messages, which the app can also override in its own messages file.
+ */
+export interface ReferralWidgetTranslations {
+    /** Widget title */
+    title?: string;
+    /** Widget description */
+    description?: string;
+    /** Label for the referral link field */
+    yourLink?: string;
+    /** Copy button label (for screen readers) */
+    copyButton?: string;
+    /** Toast message when link is copied */
+    copiedMessage?: string;
+    /** Stats section label */
+    statsLabel?: string;
+    /** Completed referrals label */
+    completedLabel?: string;
+    /** Tokens earned label */
+    tokensLabel?: string;
+    /** Email invite section title */
+    inviteTitle?: string;
+    /** Email invite description */
+    inviteDescription?: string;
+    /** Email input placeholder */
+    emailPlaceholder?: string;
+    /** Send button label */
+    sendButton?: string;
+    /** Sending button label (while in progress) */
+    sendingButton?: string;
+    /** Toast message when invite is sent */
+    inviteSent?: string;
+    /** Error message when invite fails */
+    inviteError?: string;
+    /** Error message when copy fails */
+    copyError?: string;
+    /** Error message for invalid email */
+    invalidEmail?: string;
+    /** Error message when the referral link and stats cannot be loaded */
+    loadError?: string;
+    /** Error message when the email was already invited recently (API code REFERRAL_ALREADY_INVITED) */
+    alreadyInvited?: string;
+    /** Error message when the email already has an account (API code REFERRAL_ALREADY_REGISTERED) */
+    alreadyRegistered?: string;
+}
+/**
+ * Props for the ReferralWidget component.
+ */
+export interface ReferralWidgetProps {
+    /** Custom translations to override defaults */
+    translations?: ReferralWidgetTranslations;
+    /** Additional CSS class names */
+    className?: string;
+    /** Whether to render in dialog mode (no Card wrapper, no header) */
+    isDialog?: boolean;
+    /** Callback when the referral link is copied */
+    onLinkCopied?: () => void;
+    /** Callback when an invite is successfully sent */
+    onInviteSent?: (email: string) => void;
+    /** Callback when an invite fails to send */
+    onInviteError?: (error: Error) => void;
+}
+/**
+ * ReferralWidget displays referral information and allows users to share their referral link.
+ *
+ * Features:
+ * - Shows user's unique referral link
+ * - Copy-to-clipboard functionality
+ * - Email invite form
+ * - Referral stats display
+ * - Feature flag awareness (renders null when disabled)
+ * - Customizable translations
+ * - Optional callback props for events
+ *
+ * @example
+ * ```tsx
+ * import { ReferralWidget } from "@carlonicora/nextjs-jsonapi/components";
+ *
+ * // Basic usage with defaults
+ * <ReferralWidget />
+ *
+ * // With custom translations
+ * <ReferralWidget
+ *   translations={{
+ *     title: t("referral.title"),
+ *     description: t("referral.description"),
+ *   }}
+ *   onLinkCopied={() => analytics.track("referral_link_copied")}
+ * />
+ * ```
+ */
+export declare function ReferralWidget({ translations, className, isDialog, onLinkCopied, onInviteSent, onInviteError, }: ReferralWidgetProps): import("react").JSX.Element | null;
+//# sourceMappingURL=ReferralWidget.d.ts.map

package/dist/features/referral/components/ReferralWidget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferralWidget.d.ts","sourceRoot":"","sources":["../../../../src/features/referral/components/ReferralWidget.tsx"],"names":[],"mappings":"AAaA;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8BAA8B;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oGAAoG;IACpG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iGAAiG;IACjG,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AASD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,0BAA0B,CAAC;IAC1C,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,mDAAmD;IACnD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,4CAA4C;IAC5C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACxC;AAkCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAAC,EAC7B,YAAY,EACZ,SAAS,EACT,QAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,EAAE,mBAAmB,sCAmNrB"}

package/dist/features/referral/components/ReferralsAdminFunnel.d.ts

@@ -0,0 +1,13 @@
+import { ReferralAdminSummaryInterface } from "../interfaces/referral-admin.interface";
+type Props = {
+    summary: ReferralAdminSummaryInterface[];
+};
+/**
+ * "From visit to paying": visits → invites → sign-ups → paying of the current
+ * window as plain proportional bars, each with its share of the previous step.
+ * Bars are scaled to the largest step, since invites can outnumber visits.
+ * The rows copy TokenUsageRankedBar: same track, ramp, sizes and columns.
+ */
+export declare function ReferralsAdminFunnel({ summary }: Props): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=ReferralsAdminFunnel.d.ts.map

package/dist/features/referral/components/ReferralsAdminFunnel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferralsAdminFunnel.d.ts","sourceRoot":"","sources":["../../../../src/features/referral/components/ReferralsAdminFunnel.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AAEvF,KAAK,KAAK,GAAG;IACX,OAAO,EAAE,6BAA6B,EAAE,CAAC;CAC1C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,+BAwDtD"}

package/dist/features/referral/components/ReferralsAdminTiles.d.ts

@@ -0,0 +1,13 @@
+import { ReferralAdminSummaryInterface } from "../interfaces/referral-admin.interface";
+type Props = {
+    /** The summary rows: `current`, plus `previous` unless the period is `all`. */
+    summary: ReferralAdminSummaryInterface[];
+};
+/**
+ * The KPI row of the administrative referral page. Each tile reads the
+ * `current` window; the change line compares it with the `previous` one and is
+ * left out when there is no previous window (the `all` period).
+ */
+export declare function ReferralsAdminTiles({ summary }: Props): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=ReferralsAdminTiles.d.ts.map

package/dist/features/referral/components/ReferralsAdminTiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferralsAdminTiles.d.ts","sourceRoot":"","sources":["../../../../src/features/referral/components/ReferralsAdminTiles.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AAEvF,KAAK,KAAK,GAAG;IACX,+EAA+E;IAC/E,OAAO,EAAE,6BAA6B,EAAE,CAAC;CAC1C,CAAC;AAeF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,+BA2DrD"}

package/dist/features/referral/components/containers/ReferralsAdminContainer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Administrative referral report: period buttons in the title bar, the KPI
+ * tiles, the visit-to-paying funnel, the referrers ranking and every referral.
+ * Client component by necessity: `module={Modules.ReferralAdminSummary}` is a
+ * registry entry carrying an icon component, which a Server Component cannot
+ * pass across the boundary.
+ */
+export declare function ReferralsAdminContainer(): import("react").JSX.Element;
+//# sourceMappingURL=ReferralsAdminContainer.d.ts.map

package/dist/features/referral/components/containers/ReferralsAdminContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferralsAdminContainer.d.ts","sourceRoot":"","sources":["../../../../../src/features/referral/components/containers/ReferralsAdminContainer.tsx"],"names":[],"mappings":"AAqEA;;;;;;GAMG;AACH,wBAAgB,uBAAuB,gCAgItC"}

package/dist/features/referral/components/index.d.ts

@@ -0,0 +1,7 @@
+export { ReferralCodeCapture } from "./ReferralCodeCapture";
+export { ReferralDialog, type ReferralDialogProps, type ReferralDialogTranslations } from "./ReferralDialog";
+export { ReferralWidget, type ReferralWidgetProps, type ReferralWidgetTranslations } from "./ReferralWidget";
+export { ReferralsAdminContainer } from "./containers/ReferralsAdminContainer";
+export { ReferralsAdminTiles } from "./ReferralsAdminTiles";
+export { ReferralsAdminFunnel } from "./ReferralsAdminFunnel";
+//# sourceMappingURL=index.d.ts.map

package/dist/features/referral/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/features/referral/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC7G,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC7G,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/features/referral/config.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Configuration interface for frontend referral feature.
+ */
+export interface ReferralConfig {
+    /**
+     * Whether the referral feature is enabled.
+     * When false, components render nothing and hooks return null.
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * Name of the cookie used to store referral codes.
+     * @default "referral_code"
+     */
+    cookieName?: string;
+    /**
+     * Number of days the referral cookie is valid.
+     * @default 30
+     */
+    cookieDays?: number;
+    /**
+     * Query parameter name for referral code in URL.
+     * @default "ref"
+     */
+    urlParamName?: string;
+    /**
+     * Base URL for referral links.
+     * @default window.location.origin (client-side only)
+     */
+    referralUrlBase?: string;
+    /**
+     * Path to append to base URL for referral links.
+     * @default "/"
+     */
+    referralPath?: string;
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_REFERRAL_CONFIG: Required<ReferralConfig>;
+/**
+ * Configure referral feature settings.
+ * Call this at app startup to enable and configure referral functionality.
+ *
+ * @example
+ * ```typescript
+ * import { configureReferral } from "@carlonicora/nextjs-jsonapi";
+ *
+ * configureReferral({
+ *   enabled: process.env.NEXT_PUBLIC_REFERRAL_ENABLED === 'true',
+ *   cookieDays: 30,
+ * });
+ * ```
+ */
+export declare function configureReferral(config: ReferralConfig): void;
+/**
+ * Get the current referral configuration.
+ * @internal
+ */
+export declare function getReferralConfig(): Required<ReferralConfig>;
+/**
+ * Check if referral feature is enabled.
+ */
+export declare function isReferralEnabled(): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/features/referral/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/features/referral/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,cAAc,CAO5D,CAAC;AAKF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAE9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,QAAQ,CAAC,cAAc,CAAC,CAE5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}

package/dist/features/referral/data/ReferralAdminReferral.d.ts

@@ -0,0 +1,35 @@
+import { AbstractApiData, JsonApiHydratedDataInterface } from "../../../core";
+import { ReferralAdminReferralInterface } from "../interfaces/referral-admin.interface";
+/** One referral in the administrative list: the new account and who brought it. Read-only. */
+export declare class ReferralAdminReferral extends AbstractApiData implements ReferralAdminReferralInterface {
+    private _name?;
+    private _email?;
+    private _referrerName?;
+    private _referrerEmail?;
+    private _source?;
+    private _status?;
+    private _referredAt?;
+    private _completedAt?;
+    private _tokensAwarded?;
+    get name(): string;
+    get email(): string;
+    get referrerName(): string;
+    get referrerEmail(): string;
+    get source(): string;
+    get status(): string;
+    get referredAt(): Date;
+    get completedAt(): Date | undefined;
+    get tokensAwarded(): number | undefined;
+    rehydrate(data: JsonApiHydratedDataInterface): this;
+    /** The resource is read-only: there are no attributes to send. */
+    createJsonApi(data: {
+        id: string;
+    }): {
+        data: {
+            type: string;
+            id: string;
+            attributes: {};
+        };
+    };
+}
+//# sourceMappingURL=ReferralAdminReferral.d.ts.map

package/dist/features/referral/data/ReferralAdminReferral.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferralAdminReferral.d.ts","sourceRoot":"","sources":["../../../../src/features/referral/data/ReferralAdminReferral.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,4BAA4B,EAAW,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAExF,8FAA8F;AAC9F,qBAAa,qBAAsB,SAAQ,eAAgB,YAAW,8BAA8B;IAClG,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,WAAW,CAAC,CAAO;IAC3B,OAAO,CAAC,YAAY,CAAC,CAAO;IAC5B,OAAO,CAAC,cAAc,CAAC,CAAS;IAEhC,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,KAAK,IAAI,MAAM,CAElB;IACD,IAAI,YAAY,IAAI,MAAM,CAEzB;IACD,IAAI,aAAa,IAAI,MAAM,CAE1B;IACD,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD,IAAI,UAAU,IAAI,IAAI,CAErB;IACD,IAAI,WAAW,IAAI,IAAI,GAAG,SAAS,CAElC;IACD,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAED,SAAS,CAAC,IAAI,EAAE,4BAA4B,GAAG,IAAI;IAiBnD,kEAAkE;IAClE,aAAa,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE;;;;;;;CAGnC"}

package/dist/features/referral/data/ReferralAdminReferrer.d.ts

@@ -0,0 +1,35 @@
+import { AbstractApiData, JsonApiHydratedDataInterface } from "../../../core";
+import { ReferralAdminReferrerInterface } from "../interfaces/referral-admin.interface";
+/** One referrer company in the referral ranking. Read-only. */
+export declare class ReferralAdminReferrer extends AbstractApiData implements ReferralAdminReferrerInterface {
+    private _name?;
+    private _email?;
+    private _visits?;
+    private _invitesSent?;
+    private _signupsLink?;
+    private _signupsDirect?;
+    private _paying?;
+    private _creditsEarned?;
+    private _lastInviteAt?;
+    get name(): string;
+    get email(): string;
+    get visits(): number;
+    get invitesSent(): number;
+    get signupsLink(): number;
+    get signupsDirect(): number;
+    get paying(): number;
+    get creditsEarned(): number;
+    get lastInviteAt(): Date | undefined;
+    rehydrate(data: JsonApiHydratedDataInterface): this;
+    /** The resource is read-only: there are no attributes to send. */
+    createJsonApi(data: {
+        id: string;
+    }): {
+        data: {
+            type: string;
+            id: string;
+            attributes: {};
+        };
+    };
+}
+//# sourceMappingURL=ReferralAdminReferrer.d.ts.map

package/dist/features/referral/data/ReferralAdminReferrer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferralAdminReferrer.d.ts","sourceRoot":"","sources":["../../../../src/features/referral/data/ReferralAdminReferrer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,4BAA4B,EAAW,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAExF,+DAA+D;AAC/D,qBAAa,qBAAsB,SAAQ,eAAgB,YAAW,8BAA8B;IAClG,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,aAAa,CAAC,CAAO;IAE7B,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,KAAK,IAAI,MAAM,CAElB;IACD,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD,IAAI,WAAW,IAAI,MAAM,CAExB;IACD,IAAI,WAAW,IAAI,MAAM,CAExB;IACD,IAAI,aAAa,IAAI,MAAM,CAE1B;IACD,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD,IAAI,aAAa,IAAI,MAAM,CAE1B;IACD,IAAI,YAAY,IAAI,IAAI,GAAG,SAAS,CAEnC;IAED,SAAS,CAAC,IAAI,EAAE,4BAA4B,GAAG,IAAI;IAiBnD,kEAAkE;IAClE,aAAa,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE;;;;;;;CAGnC"}

package/dist/features/referral/data/ReferralAdminService.d.ts

@@ -0,0 +1,19 @@
+import { AbstractService } from "../../../core";
+import { ReferralAdminPeriod, ReferralAdminReferralInterface, ReferralAdminReferrerInterface, ReferralAdminSort, ReferralAdminSummaryInterface } from "../interfaces/referral-admin.interface";
+/** Reads of the administrative referral report. Every route is administrator-only. */
+export declare class ReferralAdminService extends AbstractService {
+    /** Headline tiles: one row per window (`current`, plus `previous` unless the period is `all`). */
+    static getSummary(params: {
+        period: ReferralAdminPeriod;
+    }): Promise<ReferralAdminSummaryInterface[]>;
+    /** The referrers ranking, ordered by the allowlisted sort. */
+    static getReferrers(params: {
+        period: ReferralAdminPeriod;
+        sort: ReferralAdminSort;
+    }): Promise<ReferralAdminReferrerInterface[]>;
+    /** Every referral in the period, newest first. */
+    static getReferrals(params: {
+        period: ReferralAdminPeriod;
+    }): Promise<ReferralAdminReferralInterface[]>;
+}
+//# sourceMappingURL=ReferralAdminService.d.ts.map

package/dist/features/referral/data/ReferralAdminService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferralAdminService.d.ts","sourceRoot":"","sources":["../../../../src/features/referral/data/ReferralAdminService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAwC,MAAM,eAAe,CAAC;AACtF,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,8BAA8B,EAC9B,iBAAiB,EACjB,6BAA6B,EAC9B,MAAM,wCAAwC,CAAC;AAEhD,sFAAsF;AACtF,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,kGAAkG;WACrF,UAAU,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,mBAAmB,CAAA;KAAE,GAAG,OAAO,CAAC,6BAA6B,EAAE,CAAC;IAW1G,8DAA8D;WACjD,YAAY,CAAC,MAAM,EAAE;QAChC,MAAM,EAAE,mBAAmB,CAAC;QAC5B,IAAI,EAAE,iBAAiB,CAAC;KACzB,GAAG,OAAO,CAAC,8BAA8B,EAAE,CAAC;IAY7C,kDAAkD;WACrC,YAAY,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,mBAAmB,CAAA;KAAE,GAAG,OAAO,CAAC,8BAA8B,EAAE,CAAC;CAU9G"}

package/dist/features/referral/data/ReferralAdminSummary.d.ts

@@ -0,0 +1,33 @@
+import { AbstractApiData, JsonApiHydratedDataInterface } from "../../../core";
+import { ReferralAdminSummaryInterface } from "../interfaces/referral-admin.interface";
+/** One window of the referral report tiles: `current` or `previous`. Read-only. */
+export declare class ReferralAdminSummary extends AbstractApiData implements ReferralAdminSummaryInterface {
+    private _window?;
+    private _visits?;
+    private _invitesSent?;
+    private _signups?;
+    private _paying?;
+    private _creditsGiven?;
+    private _sharingCompanies?;
+    private _eligibleCompanies?;
+    get window(): string;
+    get visits(): number;
+    get invitesSent(): number;
+    get signups(): number;
+    get paying(): number;
+    get creditsGiven(): number;
+    get sharingCompanies(): number;
+    get eligibleCompanies(): number;
+    rehydrate(data: JsonApiHydratedDataInterface): this;
+    /** The resource is read-only: there are no attributes to send. */
+    createJsonApi(data: {
+        id: string;
+    }): {
+        data: {
+            type: string;
+            id: string;
+            attributes: {};
+        };
+    };
+}
+//# sourceMappingURL=ReferralAdminSummary.d.ts.map

package/dist/features/referral/data/ReferralAdminSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferralAdminSummary.d.ts","sourceRoot":"","sources":["../../../../src/features/referral/data/ReferralAdminSummary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,4BAA4B,EAAW,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AAEvF,mFAAmF;AACnF,qBAAa,oBAAqB,SAAQ,eAAgB,YAAW,6BAA6B;IAChG,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAS;IACnC,OAAO,CAAC,kBAAkB,CAAC,CAAS;IAEpC,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD,IAAI,WAAW,IAAI,MAAM,CAExB;IACD,IAAI,OAAO,IAAI,MAAM,CAEpB;IACD,IAAI,MAAM,IAAI,MAAM,CAEnB;IACD,IAAI,YAAY,IAAI,MAAM,CAEzB;IACD,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IACD,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,SAAS,CAAC,IAAI,EAAE,4BAA4B,GAAG,IAAI;IAgBnD,kEAAkE;IAClE,aAAa,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE;;;;;;;CAGnC"}

package/dist/features/referral/data/ReferralService.d.ts

@@ -0,0 +1,22 @@
+import { AbstractService } from "../../../core";
+import { ReferralStatsInterface } from "../interfaces";
+export declare class ReferralService extends AbstractService {
+    /**
+     * Get referral stats for the current company.
+     * Returns deserialized attributes from JSON:API response.
+     */
+    static getMyReferralStats(): Promise<ReferralStatsInterface>;
+    /**
+     * Send a referral invitation email.
+     * Uses overridesJsonApiCreation since the endpoint accepts a simple JSON body, not JSON:API format.
+     * Returns 204 No Content on success.
+     */
+    static sendReferralEmail(email: string): Promise<void>;
+    /**
+     * Count one visit to a referral link. Answers 204 whatever the code.
+     */
+    static recordVisit(params: {
+        referralCode: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=ReferralService.d.ts.map

package/dist/features/referral/data/ReferralService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReferralService.d.ts","sourceRoot":"","sources":["../../../../src/features/referral/data/ReferralService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAc,MAAM,eAAe,CAAC;AAI5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD,qBAAa,eAAgB,SAAQ,eAAe;IAClD;;;OAGG;WACU,kBAAkB,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAUlE;;;;OAIG;WACU,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5D;;OAEG;WACU,WAAW,CAAC,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAa1E"}