@carlonicora/nestjs-neo4jsonapi 8.12.1 → 8.14.0

package/dist/foundations/referral/repositories/referral.admin.repository.js

@@ -0,0 +1,380 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReferralAdminRepository = exports.REFERRAL_ADMIN_SORTS = exports.REFERRAL_ADMIN_PERIODS = void 0;
+// nja-lint-ignore-file: cross-tenant administrative read repository.
+//
+// Every query here deliberately omits buildDefaultMatch(): that helper scopes to
+// the CALLER's company via CLS, which is exactly wrong for a platform-wide
+// referral report that reads every company's invites, visits and referrals at
+// once. Access is gated instead by the controller's JwtAuthGuard +
+// @Roles(Administrator) (see referral.admin.controller.ts). The RETURNs are
+// scalar columns (counts, sums, owner names), not graph nodes, so
+// readOne()/readMany() cannot map them: entityFactory.createGraphList expects
+// nodes. Same shape and same rationale as
+// foundations/analytics/repositories/analytics.admin.repository.ts.
+//
+// For the same reason it also does NOT call Neo4jService.initQuery(): that
+// helper prepends its own CLS-scoped company MATCH whenever the caller's CLS
+// carries a companyId, and a platform administrator who also owns a company
+// does. That would reduce every count to the administrator's own company.
+// Every query here seeds itself from _adminQuery() instead. No query here binds
+// a parameter named companyId.
+//
+// The architecture gate raises a FILE-LEVEL manual-query-no-company-scope finding
+// on this shape; per-line ignores do not clear it, so this header note is the
+// documented resolution.
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const define_entity_1 = require("../../../common/helpers/define-entity");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const security_service_1 = require("../../../core/security/services/security.service");
+const company_meta_1 = require("../../company/entities/company.meta");
+const user_meta_1 = require("../../user/entities/user.meta");
+const referral_1 = require("../entities/referral");
+const referral_admin_referral_1 = require("../entities/referral-admin-referral");
+const referral_admin_referrer_1 = require("../entities/referral-admin-referrer");
+const referral_invite_meta_1 = require("../entities/referral-invite.meta");
+const referral_source_1 = require("../entities/referral-source");
+const referral_visit_meta_1 = require("../entities/referral-visit.meta");
+const referral_meta_1 = require("../entities/referral.meta");
+/** The periods the admin endpoints accept, in days back from now (`all` has no start). */
+exports.REFERRAL_ADMIN_PERIODS = { "30d": 30, "90d": 90, all: null };
+/**
+ * The ORDER BY clauses the referrers list may emit, keyed by the sort it accepts.
+ * A lookup rather than an interpolation of the caller's string: nothing that did
+ * not come from this table can ever reach the query text.
+ */
+exports.REFERRAL_ADMIN_SORTS = {
+    paying: "paying DESC, signups DESC",
+    signups: "signups DESC, paying DESC",
+    invites: "invitesSent DESC, paying DESC",
+    conversion: "conversion DESC, paying DESC",
+    credits: "creditsEarned DESC, paying DESC",
+};
+const COMPANY = company_meta_1.companyMeta.labelName;
+const USER = user_meta_1.userMeta.labelName;
+const REFERRAL = referral_meta_1.referralMeta.labelName;
+const INVITE = referral_invite_meta_1.referralInviteMeta.labelName;
+const VISIT = referral_visit_meta_1.referralVisitMeta.labelName;
+/** Driver Integers arrive as { toNumber() }. */
+const int = (value) => (value?.toNumber ? value.toNumber() : Number(value ?? 0) || 0);
+/**
+ * Platform-wide reads behind /referrals/administration/*. The Referral
+ * descriptor is only there to satisfy the base class; nothing here goes through
+ * the inherited CRUD.
+ *
+ * Counting rules:
+ * - every window is [from, to): an inclusive start, so a record created exactly
+ *   at the period start counts; `from = null` ("all") has no start;
+ * - visits and invites count by their createdAt; sign-ups are Referrals created
+ *   in the window (both sources); paying are Referrals with status completed
+ *   and completedAt in the window; credits given are twice the sum of their
+ *   tokensAwarded (both sides are rewarded);
+ * - companies with a user in $excludeUserIds (platform administrators) are left
+ *   out on both sides; demo companies (isDemo) are left out on the referred side.
+ */
+let ReferralAdminRepository = class ReferralAdminRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = referral_1.ReferralDescriptor;
+    }
+    /**
+     * One row per window: "current" = [from, to), plus "previous" =
+     * [previousFrom, from) when previousFrom is not null.
+     */
+    async findSummary(params) {
+        const windows = [
+            this._summaryWindow({
+                window: "current",
+                from: params.from,
+                to: params.to,
+                excludeUserIds: params.excludeUserIds,
+            }),
+        ];
+        if (params.previousFrom !== null && params.from !== null)
+            windows.push(this._summaryWindow({
+                window: "previous",
+                from: params.previousFrom,
+                to: params.from,
+                excludeUserIds: params.excludeUserIds,
+            }));
+        return Promise.all(windows);
+    }
+    /**
+     * One row per referrer company with at least one visit, invite or referral in
+     * the period, so a company with only visits still appears with zeros
+     * elsewhere. lastInviteAt is the company's most recent invite, in or before
+     * the period.
+     */
+    async findReferrers(params) {
+        const orderBy = Object.prototype.hasOwnProperty.call(exports.REFERRAL_ADMIN_SORTS, params.sort)
+            ? exports.REFERRAL_ADMIN_SORTS[params.sort]
+            : exports.REFERRAL_ADMIN_SORTS.paying;
+        const seed = this._adminQuery({
+            from: params.from,
+            to: new Date().toISOString(),
+            excludeUserIds: params.excludeUserIds,
+        });
+        seed.query = `
+      CALL {
+        MATCH (active_visit:${VISIT})-[:VISITED]->(active_company:${COMPANY})
+        WHERE ${this._inWindow("active_visit.createdAt")}
+        RETURN active_company
+        UNION
+        MATCH (active_invite:${INVITE})-[:SENT_BY]->(active_company:${COMPANY})
+        WHERE ${this._inWindow("active_invite.createdAt")}
+        RETURN active_company
+        UNION
+        MATCH (active_referral:${REFERRAL})-[:REFERRED_BY]->(active_company:${COMPANY})
+        MATCH (active_referral)-[:REFERS_TO]->(active_referred:${COMPANY})
+        WHERE ${this._inWindow("active_referral.createdAt")}
+          AND ${this._referredAllowed("active_referred")}
+        RETURN active_company
+      }
+      WITH DISTINCT active_company AS referrer
+      WHERE ${this._notAdministrators("referrer")}
+      CALL {
+        WITH referrer
+        OPTIONAL MATCH (referrer_member:${USER})-[:BELONGS_TO]->(referrer)
+        WITH referrer_member
+        ORDER BY referrer_member.createdAt ASC
+        RETURN head(collect(referrer_member)) AS referrer_owner
+      }
+      CALL {
+        WITH referrer
+        OPTIONAL MATCH (referrer_visit:${VISIT})-[:VISITED]->(referrer)
+        WHERE ${this._inWindow("referrer_visit.createdAt")}
+        RETURN count(referrer_visit) AS visits
+      }
+      CALL {
+        WITH referrer
+        OPTIONAL MATCH (referrer_invite:${INVITE})-[:SENT_BY]->(referrer)
+        WHERE referrer_invite.createdAt < datetime($to)
+        RETURN count(CASE WHEN ${this._inWindow("referrer_invite.createdAt")} THEN 1 END) AS invitesSent,
+               max(referrer_invite.createdAt) AS lastInviteAt
+      }
+      CALL {
+        WITH referrer
+        OPTIONAL MATCH (referrer)<-[:REFERRED_BY]-(signup:${REFERRAL})-[:REFERS_TO]->(signup_referred:${COMPANY})
+        WHERE ${this._inWindow("signup.createdAt")}
+          AND ${this._referredAllowed("signup_referred")}
+        RETURN count(CASE WHEN signup.source = $linkSource THEN 1 END) AS signupsLink,
+               count(CASE WHEN signup.source = $directSource THEN 1 END) AS signupsDirect
+      }
+      CALL {
+        WITH referrer
+        OPTIONAL MATCH (referrer)<-[:REFERRED_BY]-(completed:${REFERRAL})-[:REFERS_TO]->(completed_referred:${COMPANY})
+        WHERE completed.status = 'completed'
+          AND ${this._inWindow("completed.completedAt")}
+          AND ${this._referredAllowed("completed_referred")}
+        RETURN count(completed) AS paying,
+               sum(coalesce(completed.tokensAwarded, 0)) AS creditsEarned
+      }
+      WITH referrer, referrer_owner, visits, invitesSent, lastInviteAt, signupsLink, signupsDirect, paying, creditsEarned,
+           signupsLink + signupsDirect AS signups,
+           CASE WHEN invitesSent = 0 THEN 0.0 ELSE toFloat(paying) / invitesSent END AS conversion
+      ORDER BY ${orderBy}, referrer.id ASC
+      RETURN referrer.id                          AS id,
+             coalesce(referrer_owner.name, '')    AS name,
+             coalesce(referrer_owner.email, '')   AS email,
+             visits                               AS visits,
+             invitesSent                          AS invitesSent,
+             signupsLink                          AS signupsLink,
+             signupsDirect                        AS signupsDirect,
+             paying                               AS paying,
+             creditsEarned                        AS creditsEarned,
+             lastInviteAt                         AS lastInviteAt
+    `;
+        const result = await this.neo4j.read(seed.query, seed.queryParams);
+        // The driver hands back a native Neo4j DateTime. convertFieldValue is the
+        // framework's single read-path conversion, the one the generated mapper
+        // uses; the type is read off the descriptor so the two never drift.
+        const lastInviteType = referral_admin_referrer_1.ReferralAdminReferrerDescriptor.fields.lastInviteAt?.type ?? "datetime";
+        return result.records.map((r) => {
+            const lastInviteAt = r.get("lastInviteAt");
+            return {
+                id: String(r.get("id")),
+                name: r.get("name") ?? "",
+                email: r.get("email") ?? "",
+                visits: int(r.get("visits")),
+                invitesSent: int(r.get("invitesSent")),
+                signupsLink: int(r.get("signupsLink")),
+                signupsDirect: int(r.get("signupsDirect")),
+                paying: int(r.get("paying")),
+                creditsEarned: int(r.get("creditsEarned")),
+                lastInviteAt: lastInviteAt == null ? undefined : (0, define_entity_1.convertFieldValue)(lastInviteAt, lastInviteType),
+            };
+        });
+    }
+    /**
+     * Every Referral created in the period, newest first, unpaginated (like the
+     * library's other cross-tenant admin lists). Owners are each company's
+     * earliest-created user. A Referral written before sources existed has an
+     * unknown source and comes back as an empty string.
+     */
+    async findReferrals(params) {
+        const seed = this._adminQuery({
+            from: params.from,
+            to: new Date().toISOString(),
+            excludeUserIds: params.excludeUserIds,
+        });
+        seed.query = `
+      MATCH (referral:${REFERRAL})-[:REFERS_TO]->(referral_referred:${COMPANY})
+      MATCH (referral)-[:REFERRED_BY]->(referral_referrer:${COMPANY})
+      WHERE ${this._inWindow("referral.createdAt")}
+        AND ${this._referredAllowed("referral_referred")}
+        AND ${this._notAdministrators("referral_referrer")}
+      CALL {
+        WITH referral_referred
+        OPTIONAL MATCH (referred_member:${USER})-[:BELONGS_TO]->(referral_referred)
+        WITH referred_member
+        ORDER BY referred_member.createdAt ASC
+        RETURN head(collect(referred_member)) AS referred_owner
+      }
+      CALL {
+        WITH referral_referrer
+        OPTIONAL MATCH (referrer_member:${USER})-[:BELONGS_TO]->(referral_referrer)
+        WITH referrer_member
+        ORDER BY referrer_member.createdAt ASC
+        RETURN head(collect(referrer_member)) AS referrer_owner
+      }
+      RETURN referral.id                              AS id,
+             coalesce(referred_owner.name, '')        AS name,
+             coalesce(referred_owner.email, '')       AS email,
+             coalesce(referrer_owner.name, '')        AS referrerName,
+             coalesce(referrer_owner.email, '')       AS referrerEmail,
+             coalesce(referral.source, '')            AS source,
+             referral.status                          AS status,
+             referral.createdAt                       AS referredAt,
+             referral.completedAt                     AS completedAt,
+             referral.tokensAwarded                   AS tokensAwarded
+      ORDER BY referral.createdAt DESC
+    `;
+        const result = await this.neo4j.read(seed.query, seed.queryParams);
+        // Same read-path conversion as findReferrers: the types come off the descriptor.
+        const referredAtType = referral_admin_referral_1.ReferralAdminReferralDescriptor.fields.referredAt?.type ?? "datetime";
+        const completedAtType = referral_admin_referral_1.ReferralAdminReferralDescriptor.fields.completedAt?.type ?? "datetime";
+        return result.records.map((r) => {
+            const completedAt = r.get("completedAt");
+            const tokensAwarded = r.get("tokensAwarded");
+            return {
+                id: String(r.get("id")),
+                name: r.get("name") ?? "",
+                email: r.get("email") ?? "",
+                referrerName: r.get("referrerName") ?? "",
+                referrerEmail: r.get("referrerEmail") ?? "",
+                source: r.get("source") ?? "",
+                status: r.get("status") ?? "",
+                referredAt: (0, define_entity_1.convertFieldValue)(r.get("referredAt"), referredAtType),
+                completedAt: completedAt == null ? undefined : (0, define_entity_1.convertFieldValue)(completedAt, completedAtType),
+                tokensAwarded: tokensAwarded == null ? undefined : int(tokensAwarded),
+            };
+        });
+    }
+    /** One window of the summary, [from, to). */
+    async _summaryWindow(params) {
+        const seed = this._adminQuery({ from: params.from, to: params.to, excludeUserIds: params.excludeUserIds });
+        seed.query = `
+      CALL {
+        OPTIONAL MATCH (summary_visit:${VISIT})-[:VISITED]->(summary_visit_company:${COMPANY})
+        WHERE ${this._inWindow("summary_visit.createdAt")}
+          AND ${this._notAdministrators("summary_visit_company")}
+        RETURN count(summary_visit) AS visits,
+               collect(DISTINCT summary_visit_company.id) AS visitCompanyIds
+      }
+      CALL {
+        OPTIONAL MATCH (summary_invite:${INVITE})-[:SENT_BY]->(summary_invite_company:${COMPANY})
+        WHERE ${this._inWindow("summary_invite.createdAt")}
+          AND ${this._notAdministrators("summary_invite_company")}
+        RETURN count(summary_invite) AS invitesSent,
+               collect(DISTINCT summary_invite_company.id) AS inviteCompanyIds
+      }
+      CALL {
+        OPTIONAL MATCH (summary_signup_referrer:${COMPANY})<-[:REFERRED_BY]-(summary_signup:${REFERRAL})-[:REFERS_TO]->(summary_signup_referred:${COMPANY})
+        WHERE ${this._inWindow("summary_signup.createdAt")}
+          AND ${this._notAdministrators("summary_signup_referrer")}
+          AND ${this._referredAllowed("summary_signup_referred")}
+        RETURN count(summary_signup) AS signups
+      }
+      CALL {
+        OPTIONAL MATCH (summary_paid_referrer:${COMPANY})<-[:REFERRED_BY]-(summary_paid:${REFERRAL})-[:REFERS_TO]->(summary_paid_referred:${COMPANY})
+        WHERE summary_paid.status = 'completed'
+          AND ${this._inWindow("summary_paid.completedAt")}
+          AND ${this._notAdministrators("summary_paid_referrer")}
+          AND ${this._referredAllowed("summary_paid_referred")}
+        RETURN count(summary_paid) AS paying,
+               2 * sum(coalesce(summary_paid.tokensAwarded, 0)) AS creditsGiven
+      }
+      CALL {
+        OPTIONAL MATCH (summary_eligible:${COMPANY})
+        WHERE summary_eligible.isActiveSubscription = true
+          AND ${this._notAdministrators("summary_eligible")}
+        RETURN count(summary_eligible) AS eligibleCompanies
+      }
+      RETURN visits, invitesSent, signups, paying, creditsGiven, eligibleCompanies,
+             size(inviteCompanyIds) + size([visitCompanyId IN visitCompanyIds WHERE NOT visitCompanyId IN inviteCompanyIds]) AS sharingCompanies
+    `;
+        const result = await this.neo4j.read(seed.query, seed.queryParams);
+        const r = result.records[0];
+        return {
+            id: params.window,
+            window: params.window,
+            visits: int(r?.get("visits")),
+            invitesSent: int(r?.get("invitesSent")),
+            signups: int(r?.get("signups")),
+            paying: int(r?.get("paying")),
+            creditsGiven: int(r?.get("creditsGiven")),
+            sharingCompanies: int(r?.get("sharingCompanies")),
+            eligibleCompanies: int(r?.get("eligibleCompanies")),
+        };
+    }
+    /** [from, to) on a datetime property; `$from = null` means no start. */
+    _inWindow(property) {
+        return `($from IS NULL OR ${property} >= datetime($from)) AND ${property} < datetime($to)`;
+    }
+    /** The company has no user among $excludeUserIds (platform administrators). */
+    _notAdministrators(company) {
+        return `NOT EXISTS {
+          MATCH (${company}_admin:${USER})-[:BELONGS_TO]->(${company})
+          WHERE ${company}_admin.id IN $excludeUserIds
+        }`;
+    }
+    /** A referred company counts unless it is a demo account or an administrator's. */
+    _referredAllowed(company) {
+        return `coalesce(${company}.isDemo, false) = false
+          AND ${this._notAdministrators(company)}`;
+    }
+    /**
+     * The seed every query starts from, in place of initQuery(). It binds only the
+     * report's parameters, never the caller's companyId; the source values come
+     * from REFERRAL_SOURCE.
+     */
+    _adminQuery(params) {
+        return {
+            query: "",
+            queryParams: {
+                from: params.from,
+                to: params.to,
+                excludeUserIds: params.excludeUserIds,
+                linkSource: referral_source_1.REFERRAL_SOURCE.link,
+                directSource: referral_source_1.REFERRAL_SOURCE.direct,
+            },
+        };
+    }
+};
+exports.ReferralAdminRepository = ReferralAdminRepository;
+exports.ReferralAdminRepository = ReferralAdminRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
+], ReferralAdminRepository);
+//# sourceMappingURL=referral.admin.repository.js.map

package/dist/foundations/referral/repositories/referral.admin.repository.js.map

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

package/dist/foundations/referral/repositories/referral.repository.d.ts

@@ -3,6 +3,7 @@ import { AbstractRepository } from "../../../core/neo4j/abstracts/abstract.repos
 import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
 import { SecurityService } from "../../../core/security/services/security.service";
 import { Referral, ReferralDescriptor } from "../entities/referral";
+import type { ReferralSource } from "../entities/referral-source";
 export declare class ReferralRepository extends AbstractRepository<Referral, typeof ReferralDescriptor.relationships> {
     protected readonly descriptor: import("../../..").EntityDescriptor<Referral, {
         referrer: {
@@ -25,15 +26,23 @@ export declare class ReferralRepository extends AbstractRepository<Referral, typ
     protected buildReturnStatement(): string;
     /**
      * Create a new referral with REFERRED_BY and REFERS_TO relationships.
+     *
+     * Company check: the referred company (the caller's own) goes through
+     * validateRelatedNodes. The REFERRED_BY link to the referrer company skips that
+     * check, because a link to another company is the point of the record.
+     * Owner-approved exception (Carlo, 2026-10-30, D18), the same scope as the
+     * 2026-10-26 exception on createReferralIfAbsent.
      * @param params.id - The referral ID
      * @param params.referrerCompanyId - The company that made the referral
      * @param params.referredCompanyId - The company that was referred
+     * @param params.source - How the referral came about (link or direct)
      * @returns true if the referral was created, false if one or both companies don't exist
      */
     createReferral(params: {
         id: string;
         referrerCompanyId: string;
         referredCompanyId: string;
+        source: ReferralSource;
     }): Promise<boolean>;
     /**
      * Create a pending referral unless the referred company already has one.
@@ -49,11 +58,36 @@ export declare class ReferralRepository extends AbstractRepository<Referral, typ
      * @param params.id - The referral ID
      * @param params.referrerCompanyId - The company that made the referral
      * @param params.referredCompanyId - The company that was referred
+     * @param params.source - How the referral came about (link or direct)
      */
     createReferralIfAbsent(params: {
         id: string;
         referrerCompanyId: string;
         referredCompanyId: string;
+        source: ReferralSource;
+    }): Promise<void>;
+    /**
+     * Record one referral invite email sent by a user of a company. The invitee
+     * address is never stored. Both ids must be server-derived (CLS).
+     * @param params.id - The invite ID
+     * @param params.companyId - The sender's company
+     * @param params.userId - The sender
+     */
+    createInvite(params: {
+        id: string;
+        companyId: string;
+        userId: string;
+    }): Promise<void>;
+    /**
+     * Record one visit to a company's referral link. Runs on a public route with no
+     * company in CLS, so the company check is existence only. The company id comes
+     * from the referral code lookup, never from the request.
+     * @param params.id - The visit ID
+     * @param params.referrerCompanyId - The company owning the referral code
+     */
+    createVisit(params: {
+        id: string;
+        referrerCompanyId: string;
     }): Promise<void>;
     /**
      * Find a pending referral by the referred company ID.

package/dist/foundations/referral/repositories/referral.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"referral.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/referral/repositories/referral.repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AAGnF,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGpE,qBACa,kBAAmB,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,OAAO,kBAAkB,CAAC,aAAa,CAAC;IAC3G,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;OAAsB;gBAEvC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;OAEG;IACH,SAAS,CAAC,oBAAoB,IAAI,MAAM;IAUxC;;;;;;OAMG;IACG,cAAc,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IA6BpH;;;;;;;;;;;;;;OAcG;IACG,sBAAsB,CAAC,MAAM,EAAE;QACnC,EAAE,EAAE,MAAM,CAAC;QACX,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCjB;;;;;;OAMG;IACG,8BAA8B,CAAC,MAAM,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAuCrG;;;;OAIG;IACG,gBAAgB,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5F;;;;OAIG;IACG,iCAAiC,CAAC,MAAM,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAgBhG"}
+{"version":3,"file":"referral.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/referral/repositories/referral.repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AAInF,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAKlE,qBACa,kBAAmB,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,OAAO,kBAAkB,CAAC,aAAa,CAAC;IAC3G,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;OAAsB;gBAEvC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;OAEG;IACH,SAAS,CAAC,oBAAoB,IAAI,MAAM;IAUxC;;;;;;;;;;;;;OAaG;IACG,cAAc,CAAC,MAAM,EAAE;QAC3B,EAAE,EAAE,MAAM,CAAC;QACX,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,MAAM,EAAE,cAAc,CAAC;KACxB,GAAG,OAAO,CAAC,OAAO,CAAC;IAmCpB;;;;;;;;;;;;;;;OAeG;IACG,sBAAsB,CAAC,MAAM,EAAE;QACnC,EAAE,EAAE,MAAM,CAAC;QACX,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,MAAM,EAAE,cAAc,CAAC;KACxB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCjB;;;;;;OAMG;IACG,YAAY,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC5F;;;;;;OAMG;IACG,WAAW,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BnF;;;;;;OAMG;IACG,8BAA8B,CAAC,MAAM,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAuCrG;;;;OAIG;IACG,gBAAgB,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5F;;;;OAIG;IACG,iCAAiC,CAAC,MAAM,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAgBhG"}

package/dist/foundations/referral/repositories/referral.repository.js

@@ -16,7 +16,12 @@ const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.re
 const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
 const security_service_1 = require("../../../core/security/services/security.service");
 const company_meta_1 = require("../../company/entities/company.meta");
+const user_meta_1 = require("../../user/entities/user.meta");
 const referral_1 = require("../entities/referral");
+const referral_invite_1 = require("../entities/referral-invite");
+const referral_invite_meta_1 = require("../entities/referral-invite.meta");
+const referral_visit_1 = require("../entities/referral-visit");
+const referral_visit_meta_1 = require("../entities/referral-visit.meta");
 const referral_meta_1 = require("../entities/referral.meta");
 let ReferralRepository = class ReferralRepository extends abstract_repository_1.AbstractRepository {
     constructor(neo4j, securityService, clsService) {
@@ -37,12 +42,22 @@ let ReferralRepository = class ReferralRepository extends abstract_repository_1.
     }
     /**
      * Create a new referral with REFERRED_BY and REFERS_TO relationships.
+     *
+     * Company check: the referred company (the caller's own) goes through
+     * validateRelatedNodes. The REFERRED_BY link to the referrer company skips that
+     * check, because a link to another company is the point of the record.
+     * Owner-approved exception (Carlo, 2026-10-30, D18), the same scope as the
+     * 2026-10-26 exception on createReferralIfAbsent.
      * @param params.id - The referral ID
      * @param params.referrerCompanyId - The company that made the referral
      * @param params.referredCompanyId - The company that was referred
+     * @param params.source - How the referral came about (link or direct)
      * @returns true if the referral was created, false if one or both companies don't exist
      */
     async createReferral(params) {
+        await this.neo4j.validateRelatedNodes({
+            nodes: [{ id: params.referredCompanyId, label: company_meta_1.companyMeta.labelName }],
+        });
         const results = await this.neo4j.executeInTransaction([
             {
                 query: `
@@ -51,6 +66,7 @@ let ReferralRepository = class ReferralRepository extends abstract_repository_1.
           CREATE (${referral_meta_1.referralMeta.nodeName}:${referral_meta_1.referralMeta.labelName} {
             id: $id,
             status: $status,
+            source: $source,
             createdAt: datetime(),
             updatedAt: datetime()
           })
@@ -63,6 +79,7 @@ let ReferralRepository = class ReferralRepository extends abstract_repository_1.
                     referrerCompanyId: params.referrerCompanyId,
                     referredCompanyId: params.referredCompanyId,
                     status: "pending",
+                    source: params.source,
                 },
             },
         ]);
@@ -83,6 +100,7 @@ let ReferralRepository = class ReferralRepository extends abstract_repository_1.
      * @param params.id - The referral ID
      * @param params.referrerCompanyId - The company that made the referral
      * @param params.referredCompanyId - The company that was referred
+     * @param params.source - How the referral came about (link or direct)
      */
     async createReferralIfAbsent(params) {
         await this.neo4j.validateRelatedNodes({
@@ -95,6 +113,7 @@ let ReferralRepository = class ReferralRepository extends abstract_repository_1.
             referrerCompanyId: params.referrerCompanyId,
             referredCompanyId: params.referredCompanyId,
             status: "pending",
+            source: params.source,
         };
         query.query += `
       MATCH (referrer:${company_meta_1.companyMeta.labelName} {id: $referrerCompanyId})
@@ -103,6 +122,7 @@ let ReferralRepository = class ReferralRepository extends abstract_repository_1.
       CREATE (${referral_meta_1.referralMeta.nodeName}:${referral_meta_1.referralMeta.labelName} {
         id: $id,
         status: $status,
+        source: $source,
         createdAt: datetime(),
         updatedAt: datetime()
       })
@@ -111,6 +131,68 @@ let ReferralRepository = class ReferralRepository extends abstract_repository_1.
     `;
         await this.neo4j.writeOne(query);
     }
+    /**
+     * Record one referral invite email sent by a user of a company. The invitee
+     * address is never stored. Both ids must be server-derived (CLS).
+     * @param params.id - The invite ID
+     * @param params.companyId - The sender's company
+     * @param params.userId - The sender
+     */
+    async createInvite(params) {
+        await this.neo4j.validateRelatedNodes({
+            nodes: [
+                { id: params.companyId, label: company_meta_1.companyMeta.labelName },
+                { id: params.userId, label: user_meta_1.userMeta.labelName },
+            ],
+        });
+        const query = this.neo4j.initQuery({ serialiser: referral_invite_1.ReferralInviteDescriptor.model });
+        query.queryParams = {
+            ...query.queryParams,
+            id: params.id,
+            companyId: params.companyId,
+            userId: params.userId,
+        };
+        query.query += `
+      MATCH (company:${company_meta_1.companyMeta.labelName} {id: $companyId})
+      MATCH (sender:${user_meta_1.userMeta.labelName} {id: $userId})
+      CREATE (${referral_invite_meta_1.referralInviteMeta.nodeName}:${referral_invite_meta_1.referralInviteMeta.labelName} {
+        id: $id,
+        createdAt: datetime(),
+        updatedAt: datetime()
+      })
+      CREATE (${referral_invite_meta_1.referralInviteMeta.nodeName})-[:SENT_BY]->(company)
+      CREATE (${referral_invite_meta_1.referralInviteMeta.nodeName})-[:SENT_BY_USER]->(sender)
+    `;
+        await this.neo4j.writeOne(query);
+    }
+    /**
+     * Record one visit to a company's referral link. Runs on a public route with no
+     * company in CLS, so the company check is existence only. The company id comes
+     * from the referral code lookup, never from the request.
+     * @param params.id - The visit ID
+     * @param params.referrerCompanyId - The company owning the referral code
+     */
+    async createVisit(params) {
+        await this.neo4j.validateRelatedNodes({
+            nodes: [{ id: params.referrerCompanyId, label: company_meta_1.companyMeta.labelName }],
+        });
+        const query = this.neo4j.initQuery({ serialiser: referral_visit_1.ReferralVisitDescriptor.model });
+        query.queryParams = {
+            ...query.queryParams,
+            id: params.id,
+            referrerCompanyId: params.referrerCompanyId,
+        };
+        query.query += `
+      MATCH (referrer:${company_meta_1.companyMeta.labelName} {id: $referrerCompanyId})
+      CREATE (${referral_visit_meta_1.referralVisitMeta.nodeName}:${referral_visit_meta_1.referralVisitMeta.labelName} {
+        id: $id,
+        createdAt: datetime(),
+        updatedAt: datetime()
+      })
+      CREATE (${referral_visit_meta_1.referralVisitMeta.nodeName})-[:VISITED]->(referrer)
+    `;
+        await this.neo4j.writeOne(query);
+    }
     /**
      * Find a pending referral by the referred company ID.
      * Uses custom result processing to properly load both referrer and referred relationships

package/dist/foundations/referral/repositories/referral.repository.js.map

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

package/dist/foundations/referral/services/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./referral.service";
 export * from "./registration-referral.hook";
+export * from "./referral.admin.service";
 //# sourceMappingURL=index.d.ts.map

package/dist/foundations/referral/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundations/referral/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundations/referral/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC"}