@carlonicora/nextjs-jsonapi 6.10.1 → 6.11.0

package/dist/{chunk-AWLTSKMM.mjs → chunk-6RLATJ2L.mjs}

@@ -3,7 +3,7 @@ import {
   EndpointCreator,
   Modules,
   useI18nTranslations
-} from "./chunk-6HFRXEF5.mjs";
+} from "./chunk-BGLOFZ3K.mjs";
 import {
   ENV,
   setBootstrapper
@@ -340,4 +340,4 @@ export {
   ACTION_TYPES,
   RbacService
 };
-//# sourceMappingURL=chunk-AWLTSKMM.mjs.map
+//# sourceMappingURL=chunk-6RLATJ2L.mjs.map

package/dist/{chunk-6HFRXEF5.mjs → chunk-BGLOFZ3K.mjs}

@@ -41,7 +41,7 @@ var RehydrationFactory = class {
 };
 
 // src/core/abstracts/AbstractApiData.ts
-var AbstractApiData = class {
+var AbstractApiData = class _AbstractApiData {
   static {
     __name(this, "AbstractApiData");
   }
@@ -190,7 +190,7 @@ var AbstractApiData = class {
           included: data.included
         });
         if (item.meta) {
-          Object.assign(entity2, item.meta);
+          _AbstractApiData._mergeMeta(entity2, item.meta);
         }
         result.push(entity2);
       }
@@ -211,7 +211,7 @@ var AbstractApiData = class {
           });
           const relationshipMeta2 = data.jsonApi.relationships[type].meta;
           if (relationshipMeta2) {
-            Object.assign(entity2, relationshipMeta2);
+            _AbstractApiData._mergeMeta(entity2, relationshipMeta2);
           }
           return entity2;
         }
@@ -224,10 +224,20 @@ var AbstractApiData = class {
     });
     const relationshipMeta = data.jsonApi.relationships[type].meta;
     if (relationshipMeta) {
-      Object.assign(entity, relationshipMeta);
+      _AbstractApiData._mergeMeta(entity, relationshipMeta);
     }
     return entity;
   }
+  /**
+   * Copies relationship meta onto a rehydrated entity as own data properties. Object.assign throws
+   * when the model declares a getter-only accessor of the same name (an app's `Chunk` with
+   * `get relevance()`); an own property shadows that getter, so the model reads the meta value.
+   */
+  static _mergeMeta(entity, meta) {
+    for (const [key, value] of Object.entries(meta)) {
+      Object.defineProperty(entity, key, { value, writable: true, enumerable: true, configurable: true });
+    }
+  }
   dehydrate() {
     return {
       jsonApi: this._jsonApi,
@@ -11643,7 +11653,260 @@ var ReferralService = class extends AbstractService {
       method: "POST" /* POST */,
       endpoint: endpoint.generate(),
       input: { email },
-      overridesJsonApiCreation: true
+      overridesJsonApiCreation: true,
+      // The widget turns the error code into a translated message; the global
+      // handler would show the API's English text and swallow the failure.
+      suppressGlobalError: true
+    });
+  }
+  /**
+   * Count one visit to a referral link. Answers 204 whatever the code.
+   */
+  static async recordVisit(params) {
+    const endpoint = new EndpointCreator({ endpoint: Modules.ReferralVisit });
+    await this.callApi({
+      type: Modules.ReferralVisit,
+      method: "POST" /* POST */,
+      endpoint: endpoint.generate(),
+      // The request layer builds the body through ReferralVisit.createJsonApi().
+      input: { referralCode: params.referralCode },
+      // A failed beacon must never show an error to a visitor.
+      suppressGlobalError: true
+    });
+  }
+};
+
+// src/features/referral/data/ReferralVisit.ts
+var ReferralVisit = class extends AbstractApiData {
+  static {
+    __name(this, "ReferralVisit");
+  }
+  rehydrate(data) {
+    super.rehydrate(data);
+    return this;
+  }
+  createJsonApi(data) {
+    return {
+      data: {
+        type: Modules.ReferralVisit.name,
+        attributes: { referralCode: data.referralCode }
+      }
+    };
+  }
+};
+
+// src/features/referral/data/ReferralAdminSummary.ts
+var ReferralAdminSummary = class extends AbstractApiData {
+  static {
+    __name(this, "ReferralAdminSummary");
+  }
+  _window;
+  _visits;
+  _invitesSent;
+  _signups;
+  _paying;
+  _creditsGiven;
+  _sharingCompanies;
+  _eligibleCompanies;
+  get window() {
+    return this._window ?? "";
+  }
+  get visits() {
+    return this._visits ?? 0;
+  }
+  get invitesSent() {
+    return this._invitesSent ?? 0;
+  }
+  get signups() {
+    return this._signups ?? 0;
+  }
+  get paying() {
+    return this._paying ?? 0;
+  }
+  get creditsGiven() {
+    return this._creditsGiven ?? 0;
+  }
+  get sharingCompanies() {
+    return this._sharingCompanies ?? 0;
+  }
+  get eligibleCompanies() {
+    return this._eligibleCompanies ?? 0;
+  }
+  rehydrate(data) {
+    super.rehydrate(data);
+    const attrs = data.jsonApi.attributes;
+    this._window = attrs.window;
+    this._visits = attrs.visits;
+    this._invitesSent = attrs.invitesSent;
+    this._signups = attrs.signups;
+    this._paying = attrs.paying;
+    this._creditsGiven = attrs.creditsGiven;
+    this._sharingCompanies = attrs.sharingCompanies;
+    this._eligibleCompanies = attrs.eligibleCompanies;
+    return this;
+  }
+  /** The resource is read-only: there are no attributes to send. */
+  createJsonApi(data) {
+    return { data: { type: Modules.ReferralAdminSummary.name, id: data.id, attributes: {} } };
+  }
+};
+
+// src/features/referral/data/ReferralAdminReferrer.ts
+var ReferralAdminReferrer = class extends AbstractApiData {
+  static {
+    __name(this, "ReferralAdminReferrer");
+  }
+  _name;
+  _email;
+  _visits;
+  _invitesSent;
+  _signupsLink;
+  _signupsDirect;
+  _paying;
+  _creditsEarned;
+  _lastInviteAt;
+  get name() {
+    return this._name ?? "";
+  }
+  get email() {
+    return this._email ?? "";
+  }
+  get visits() {
+    return this._visits ?? 0;
+  }
+  get invitesSent() {
+    return this._invitesSent ?? 0;
+  }
+  get signupsLink() {
+    return this._signupsLink ?? 0;
+  }
+  get signupsDirect() {
+    return this._signupsDirect ?? 0;
+  }
+  get paying() {
+    return this._paying ?? 0;
+  }
+  get creditsEarned() {
+    return this._creditsEarned ?? 0;
+  }
+  get lastInviteAt() {
+    return this._lastInviteAt;
+  }
+  rehydrate(data) {
+    super.rehydrate(data);
+    const attrs = data.jsonApi.attributes;
+    this._name = attrs.name;
+    this._email = attrs.email;
+    this._visits = attrs.visits;
+    this._invitesSent = attrs.invitesSent;
+    this._signupsLink = attrs.signupsLink;
+    this._signupsDirect = attrs.signupsDirect;
+    this._paying = attrs.paying;
+    this._creditsEarned = attrs.creditsEarned;
+    this._lastInviteAt = attrs.lastInviteAt ? new Date(attrs.lastInviteAt) : void 0;
+    return this;
+  }
+  /** The resource is read-only: there are no attributes to send. */
+  createJsonApi(data) {
+    return { data: { type: Modules.ReferralAdminReferrer.name, id: data.id, attributes: {} } };
+  }
+};
+
+// src/features/referral/data/ReferralAdminReferral.ts
+var ReferralAdminReferral = class extends AbstractApiData {
+  static {
+    __name(this, "ReferralAdminReferral");
+  }
+  _name;
+  _email;
+  _referrerName;
+  _referrerEmail;
+  _source;
+  _status;
+  _referredAt;
+  _completedAt;
+  _tokensAwarded;
+  get name() {
+    return this._name ?? "";
+  }
+  get email() {
+    return this._email ?? "";
+  }
+  get referrerName() {
+    return this._referrerName ?? "";
+  }
+  get referrerEmail() {
+    return this._referrerEmail ?? "";
+  }
+  get source() {
+    return this._source ?? "";
+  }
+  get status() {
+    return this._status ?? "";
+  }
+  get referredAt() {
+    return this._referredAt ?? /* @__PURE__ */ new Date(0);
+  }
+  get completedAt() {
+    return this._completedAt;
+  }
+  get tokensAwarded() {
+    return this._tokensAwarded;
+  }
+  rehydrate(data) {
+    super.rehydrate(data);
+    const attrs = data.jsonApi.attributes;
+    this._name = attrs.name;
+    this._email = attrs.email;
+    this._referrerName = attrs.referrerName;
+    this._referrerEmail = attrs.referrerEmail;
+    this._source = attrs.source;
+    this._status = attrs.status;
+    this._referredAt = attrs.referredAt ? new Date(attrs.referredAt) : void 0;
+    this._completedAt = attrs.completedAt ? new Date(attrs.completedAt) : void 0;
+    this._tokensAwarded = attrs.tokensAwarded ?? void 0;
+    return this;
+  }
+  /** The resource is read-only: there are no attributes to send. */
+  createJsonApi(data) {
+    return { data: { type: Modules.ReferralAdminReferral.name, id: data.id, attributes: {} } };
+  }
+};
+
+// src/features/referral/data/ReferralAdminService.ts
+var ReferralAdminService = class extends AbstractService {
+  static {
+    __name(this, "ReferralAdminService");
+  }
+  /** Headline tiles: one row per window (`current`, plus `previous` unless the period is `all`). */
+  static async getSummary(params) {
+    const endpoint = new EndpointCreator({ endpoint: Modules.ReferralAdminSummary });
+    endpoint.addAdditionalParam("period", params.period);
+    return this.callApi({
+      type: Modules.ReferralAdminSummary,
+      method: "GET" /* GET */,
+      endpoint: endpoint.generate()
+    });
+  }
+  /** The referrers ranking, ordered by the allowlisted sort. */
+  static async getReferrers(params) {
+    const endpoint = new EndpointCreator({ endpoint: Modules.ReferralAdminReferrer });
+    endpoint.addAdditionalParam("period", params.period);
+    endpoint.addAdditionalParam("sort", params.sort);
+    return this.callApi({
+      type: Modules.ReferralAdminReferrer,
+      method: "GET" /* GET */,
+      endpoint: endpoint.generate()
+    });
+  }
+  /** Every referral in the period, newest first. */
+  static async getReferrals(params) {
+    const endpoint = new EndpointCreator({ endpoint: Modules.ReferralAdminReferral });
+    endpoint.addAdditionalParam("period", params.period);
+    return this.callApi({
+      type: Modules.ReferralAdminReferral,
+      method: "GET" /* GET */,
+      endpoint: endpoint.generate()
     });
   }
 };
@@ -11662,6 +11925,27 @@ var ReferralStatsModule = /* @__PURE__ */ __name((factory) => factory({
   model: ReferralStats
 }), "ReferralStatsModule");
 
+// src/features/referral/referral-admin.modules.ts
+import { GiftIcon } from "lucide-react";
+var referralAdminModules = /* @__PURE__ */ __name((factory) => ({
+  ReferralVisit: factory({ name: "referrals/visits", model: ReferralVisit }),
+  ReferralAdminSummary: factory({
+    name: "referrals/administration/summary",
+    model: ReferralAdminSummary,
+    icon: GiftIcon
+  }),
+  ReferralAdminReferrer: factory({
+    name: "referrals/administration/referrers",
+    model: ReferralAdminReferrer,
+    icon: GiftIcon
+  }),
+  ReferralAdminReferral: factory({
+    name: "referrals/administration/referrals",
+    model: ReferralAdminReferral,
+    icon: GiftIcon
+  })
+}), "referralAdminModules");
+
 // src/features/tokenusage/tokenusage-admin.module.ts
 import { CoinsIcon } from "lucide-react";
 
@@ -12966,8 +13250,14 @@ export {
   RbacMatrixModule,
   ReferralStats,
   ReferralService,
+  ReferralVisit,
+  ReferralAdminSummary,
+  ReferralAdminReferrer,
+  ReferralAdminReferral,
+  ReferralAdminService,
   ReferralModule,
   ReferralStatsModule,
+  referralAdminModules,
   TokenUsageAdminBreakdown,
   TokenUsageAdminSummary,
   TokenUsageAdminTimeline,
@@ -12991,4 +13281,4 @@ export {
   AuditLogService,
   AuditLogModule
 };
-//# sourceMappingURL=chunk-6HFRXEF5.mjs.map
+//# sourceMappingURL=chunk-BGLOFZ3K.mjs.map