@intelligo-dev/core 1.0.0-beta.1 → 1.0.0-beta.13

package/dist/money.js

@@ -0,0 +1,208 @@
+/**
+ * Money, in one unit, with the currency attached. Imports nothing:
+ * `@intelligo-dev/executions/pricing` is a zero-import leaf that client
+ * bundles reach, and it needs these types.
+ *
+ * **Micros, not minor units.** A chat turn on a cheap model costs a
+ * fraction of a cent; rounding it to whole cents overcharges by more than a
+ * third on every request.
+ *
+ * **Currency on the amount, not in a global.** A bare `number` lets one
+ * unit be sold as another; here the currency travels with the amount and
+ * `add` refuses to mix two.
+ */
+/** Thrown for every misuse in this module, so callers can catch one type. */
+export class MoneyError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "MoneyError";
+    }
+}
+const MICROS_PER_UNIT = 1000000;
+/**
+ * Currencies whose minor unit is not the usual hundredth; everything else
+ * is 2. Getting this wrong charges ¥100,000 instead of ¥1,000, because
+ * Stripe takes zero-decimal currencies in whole units.
+ */
+const MINOR_EXPONENT = {
+    BIF: 0,
+    CLP: 0,
+    DJF: 0,
+    GNF: 0,
+    ISK: 0,
+    JPY: 0,
+    KMF: 0,
+    KRW: 0,
+    MGA: 0,
+    MNT: 0,
+    PYG: 0,
+    RWF: 0,
+    UGX: 0,
+    UYI: 0,
+    VND: 0,
+    VUV: 0,
+    XAF: 0,
+    XOF: 0,
+    XPF: 0,
+    BHD: 3,
+    IQD: 3,
+    JOD: 3,
+    KWD: 3,
+    LYD: 3,
+    OMR: 3,
+    TND: 3,
+};
+/**
+ * Validates and normalises an ISO-4217 code. Shape only: a list would go
+ * stale and block a deployment selling in a code it does not know.
+ * `minorExponent` gives an unknown code its default.
+ */
+export function currency(code) {
+    const upper = code.toUpperCase();
+    if (!/^[A-Z]{3}$/.test(upper)) {
+        throw new MoneyError("invalid_currency", `"${code}" is not an ISO-4217 alphabetic code (three letters).`);
+    }
+    return upper;
+}
+/**
+ * An integer count of micros, up to `Number.MAX_SAFE_INTEGER` (about 9
+ * billion major units) — low enough to catch a value in the wrong unit.
+ */
+export function micros(value) {
+    if (!Number.isInteger(value)) {
+        throw new MoneyError("not_an_integer", `Micros must be a whole number; received ${value}. Convert with fromMajor/fromMinor rather than multiplying by hand.`);
+    }
+    if (!Number.isSafeInteger(value)) {
+        throw new MoneyError("out_of_range", `${value} micros exceeds the safe integer range.`);
+    }
+    return value;
+}
+export function money(amount, code) {
+    return { amount: micros(amount), currency: currency(code) };
+}
+/** How many decimal places this currency's minor unit has. */
+export function minorExponent(code) {
+    return MINOR_EXPONENT[code] ?? 2;
+}
+/** `12.34` USD → `12_340_000` micros. */
+export function fromMajor(value, code) {
+    return {
+        amount: micros(Math.round(value * MICROS_PER_UNIT)),
+        currency: currency(code),
+    };
+}
+/** `1234` cents → `12_340_000` micros. */
+export function fromMinor(value, code) {
+    const c = currency(code);
+    const scale = MICROS_PER_UNIT / 10 ** minorExponent(c);
+    return { amount: micros(Math.round(value * scale)), currency: c };
+}
+/**
+ * The integer a payment provider wants: whole units for a zero-decimal
+ * currency, hundredths for most, thousandths for a few.
+ *
+ * Rounds up. A fraction of a minor unit is money the deployment has
+ * already spent, and rounding it away means eating the difference on
+ * every transaction.
+ */
+export function toMinor(value) {
+    const scale = MICROS_PER_UNIT / 10 ** minorExponent(value.currency);
+    return Math.ceil(value.amount / scale);
+}
+/** The amount as a plain decimal number, for display and for charts. */
+export function toMajor(value) {
+    return value.amount / MICROS_PER_UNIT;
+}
+export const zero = (code) => ({
+    amount: 0,
+    currency: currency(code),
+});
+function sameCurrency(a, b, op) {
+    if (a.currency !== b.currency) {
+        throw new MoneyError("currency_mismatch", `Cannot ${op} ${a.currency} and ${b.currency}. Convert one first — an exchange rate is a decision, not a coercion.`);
+    }
+}
+export function add(a, b) {
+    sameCurrency(a, b, "add");
+    return { amount: micros(a.amount + b.amount), currency: a.currency };
+}
+export function subtract(a, b) {
+    sameCurrency(a, b, "subtract");
+    return { amount: micros(a.amount - b.amount), currency: a.currency };
+}
+/** Scale by a plain factor — a margin multiplier, a percentage, a count. */
+export function multiply(value, factor) {
+    if (!Number.isFinite(factor)) {
+        throw new MoneyError("invalid_factor", `Factor must be finite.`);
+    }
+    return {
+        amount: micros(Math.ceil(value.amount * factor)),
+        currency: value.currency,
+    };
+}
+export function compare(a, b) {
+    sameCurrency(a, b, "compare");
+    return a.amount === b.amount ? 0 : a.amount < b.amount ? -1 : 1;
+}
+export const isZero = (value) => value.amount === 0;
+export const isNegative = (value) => value.amount < 0;
+/**
+ * Convert at an explicit rate, expressed in micros so the rate itself
+ * carries no float error: `3_450_000_000` is 3450.0.
+ *
+ * There is no ambient rate and no default. A framework that guesses an
+ * exchange rate is inventing money.
+ */
+export function convert(value, to, rateMicros) {
+    const target = currency(to);
+    if (!Number.isInteger(rateMicros) || rateMicros <= 0) {
+        throw new MoneyError("invalid_rate", `Rate must be a positive integer number of micros; received ${rateMicros}.`);
+    }
+    if (target === value.currency) {
+        if (rateMicros !== MICROS_PER_UNIT) {
+            throw new MoneyError("invalid_rate", `Converting ${value.currency} to itself at ${rateMicros / MICROS_PER_UNIT} is not a conversion.`);
+        }
+        return value;
+    }
+    return {
+        amount: micros(Math.ceil((value.amount * rateMicros) / MICROS_PER_UNIT)),
+        currency: target,
+    };
+}
+/** Two significant digits is enough to read a sub-cent amount by. */
+const SIGNIFICANT_DIGITS = 2;
+/**
+ * How many decimals an amount needs to be legible.
+ *
+ * The currency's own minor unit, except when that would render a real
+ * charge as nothing: one chat turn costs a fraction of a cent, and a
+ * usage page that says every request cost `$0.00` is worse than one
+ * that says `$0.0048`. Below the minor unit the amount is shown to two
+ * significant digits, capped at the six decimals micros can hold.
+ */
+export function displayFractionDigits(value) {
+    const digits = minorExponent(value.currency);
+    const major = Math.abs(toMajor(value));
+    // Zero, and anything that still rounds to a visible minor unit, reads
+    // the way the currency is normally written.
+    if (major === 0 || major >= 10 ** -digits / 2)
+        return digits;
+    const leadingZeros = Math.floor(-Math.log10(major));
+    return Math.min(6, leadingZeros + SIGNIFICANT_DIGITS);
+}
+/**
+ * Formats for a human, in their locale. `Intl` owns the symbol, its
+ * position and the separators.
+ */
+export function formatMoney(value, locale, options = {}) {
+    const digits = displayFractionDigits(value);
+    return new Intl.NumberFormat(locale, {
+        style: "currency",
+        currency: value.currency,
+        minimumFractionDigits: digits,
+        maximumFractionDigits: digits,
+        ...options,
+    }).format(toMajor(value));
+}
+//# sourceMappingURL=money.js.map

package/dist/money.js.map

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

package/dist/notifications/index.d.ts

@@ -1,22 +1,11 @@
 /**
- * Notifications Module
- *
- * CRUD operations for user notifications. These are used by server actions
- * in the consumer application to power the notification bell, list, and
- * mark-as-read functionality.
- *
- * Notifications are user-scoped (not workspace-scoped) so a user can see
- * all their notifications across workspaces.
- */
-import type { CreateNotificationParams } from "./types";
-export type { NotificationType, CreateNotificationParams } from "./types";
-export { triggerQuotaNotification, triggerTrialNotification, triggerPaymentFailedNotification, triggerTeamMemberJoinedNotification, } from "./triggers";
-/**
- * Create a new notification for a user
- *
- * Serializes metadata to JSON string if provided.
- * Returns the created notification.
+ * User notifications. User-scoped, not workspace-scoped, so a user sees
+ * their notifications from every workspace.
  */
+import type { CreateNotificationParams } from "./types.js";
+export type { NotificationType, CreateNotificationParams } from "./types.js";
+export { triggerQuotaNotification, triggerTrialNotification, triggerPaymentFailedNotification, triggerTeamMemberJoinedNotification, } from "./triggers.js";
+/** Creates a notification; `metadata` is stored as a JSON string. */
 export declare function createNotification(params: CreateNotificationParams): Promise<{
     id: string;
     createdAt: Date;
@@ -28,12 +17,7 @@ export declare function createNotification(params: CreateNotificationParams): Pr
     message: string;
     isRead: boolean;
 } | undefined>;
-/**
- * Get unread notifications for a user
- *
- * Returns notifications where isRead is false, ordered by newest first.
- * Parses metadata JSON string back to object.
- */
+/** The user's unread notifications, newest first. */
 export declare function getUnreadNotifications(userId: string, limit?: number): Promise<({
     id: string;
     userId: string;
@@ -47,12 +31,7 @@ export declare function getUnreadNotifications(userId: string, limit?: number):
 } & {
     metadata: Record<string, unknown> | null;
 })[]>;
-/**
- * Get all notifications for a user (read and unread)
- *
- * Returns notifications ordered by newest first.
- * Parses metadata JSON string back to object.
- */
+/** All of the user's notifications, newest first. */
 export declare function getNotifications(userId: string, limit?: number): Promise<({
     id: string;
     userId: string;
@@ -66,21 +45,8 @@ export declare function getNotifications(userId: string, limit?: number): Promis
 } & {
     metadata: Record<string, unknown> | null;
 })[]>;
-/**
- * Get count of unread notifications for a user
- *
- * Used for the notification bell badge number.
- */
 export declare function getNotificationCount(userId: string): Promise<number>;
-/**
- * Mark a single notification as read
- *
- * Security: requires both notificationId and userId to ensure
- * users can only mark their own notifications.
- */
+/** Filters on userId as well, so users can only mark their own. */
 export declare function markAsRead(notificationId: string, userId: string): Promise<void>;
-/**
- * Mark all unread notifications as read for a user
- */
 export declare function markAllAsRead(userId: string): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAGxD,YAAY,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAG1E,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,gCAAgC,EAChC,mCAAmC,GACpC,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,wBAAwB;;;;;;;;;;eAcxE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAW;;;;;;;;;;;cAoFD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;MAxEhD;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW;;;;;;;;;;;cAgEtD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;MAvDhD;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS1E;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,iBAUtE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,iBAOjD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAExD,YAAY,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAE1E,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,gCAAgC,EAChC,mCAAmC,GACpC,MAAM,YAAY,CAAC;AAEpB,qEAAqE;AACrE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,wBAAwB;;;;;;;;;;eAcxE;AAED,qDAAqD;AACrD,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAW;;;;;;;;;;;cA6DD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;MAjDhD;AAED,qDAAqD;AACrD,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW;;;;;;;;;;;cA8CtD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;MArChD;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS1E;AAED,mEAAmE;AACnE,wBAAsB,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,iBAUtE;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,iBAOjD"}

package/dist/notifications/index.js

@@ -1,24 +1,12 @@
 /**
- * Notifications Module
- *
- * CRUD operations for user notifications. These are used by server actions
- * in the consumer application to power the notification bell, list, and
- * mark-as-read functionality.
- *
- * Notifications are user-scoped (not workspace-scoped) so a user can see
- * all their notifications across workspaces.
+ * User notifications. User-scoped, not workspace-scoped, so a user sees
+ * their notifications from every workspace.
  */
-import { db } from "../db";
-import { notifications } from "../db/schema";
+import { db } from "../db/index.js";
+import { notifications } from "../db/schema/index.js";
 import { eq, and, desc, count } from "drizzle-orm";
-// Re-export trigger functions
-export { triggerQuotaNotification, triggerTrialNotification, triggerPaymentFailedNotification, triggerTeamMemberJoinedNotification, } from "./triggers";
-/**
- * Create a new notification for a user
- *
- * Serializes metadata to JSON string if provided.
- * Returns the created notification.
- */
+export { triggerQuotaNotification, triggerTrialNotification, triggerPaymentFailedNotification, triggerTeamMemberJoinedNotification, } from "./triggers.js";
+/** Creates a notification; `metadata` is stored as a JSON string. */
 export async function createNotification(params) {
     const [notification] = await db
         .insert(notifications)
@@ -33,12 +21,7 @@ export async function createNotification(params) {
         .returning();
     return notification;
 }
-/**
- * Get unread notifications for a user
- *
- * Returns notifications where isRead is false, ordered by newest first.
- * Parses metadata JSON string back to object.
- */
+/** The user's unread notifications, newest first. */
 export async function getUnreadNotifications(userId, limit = 20) {
     const rows = await db
         .select()
@@ -48,12 +31,7 @@ export async function getUnreadNotifications(userId, limit = 20) {
         .limit(limit);
     return rows.map(parseMetadata);
 }
-/**
- * Get all notifications for a user (read and unread)
- *
- * Returns notifications ordered by newest first.
- * Parses metadata JSON string back to object.
- */
+/** All of the user's notifications, newest first. */
 export async function getNotifications(userId, limit = 50) {
     const rows = await db
         .select()
@@ -63,11 +41,6 @@ export async function getNotifications(userId, limit = 50) {
         .limit(limit);
     return rows.map(parseMetadata);
 }
-/**
- * Get count of unread notifications for a user
- *
- * Used for the notification bell badge number.
- */
 export async function getNotificationCount(userId) {
     const [result] = await db
         .select({ count: count() })
@@ -75,32 +48,19 @@ export async function getNotificationCount(userId) {
         .where(and(eq(notifications.userId, userId), eq(notifications.isRead, false)));
     return result?.count ?? 0;
 }
-/**
- * Mark a single notification as read
- *
- * Security: requires both notificationId and userId to ensure
- * users can only mark their own notifications.
- */
+/** Filters on userId as well, so users can only mark their own. */
 export async function markAsRead(notificationId, userId) {
     await db
         .update(notifications)
         .set({ isRead: true })
         .where(and(eq(notifications.id, notificationId), eq(notifications.userId, userId)));
 }
-/**
- * Mark all unread notifications as read for a user
- */
 export async function markAllAsRead(userId) {
     await db
         .update(notifications)
         .set({ isRead: true })
         .where(and(eq(notifications.userId, userId), eq(notifications.isRead, false)));
 }
-/**
- * Parse metadata JSON string back to object
- *
- * Returns notification with metadata as parsed object (or null if no metadata).
- */
 function parseMetadata(notification) {
     return {
         ...notification,

package/dist/notifications/index.js.map

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

package/dist/notifications/triggers.d.ts

@@ -1,24 +1,12 @@
 /**
- * Notification Trigger Functions
- *
- * These functions create BOTH in-app notifications (via createNotification)
- * AND send emails (via email senders). They are the integration points that
- * connect application events to the notification + email infrastructure.
- *
- * Design:
- * - In-app notifications are awaited (fast DB inserts)
- * - Email sends are fire-and-forget (non-blocking, errors logged)
- * - These do NOT handle deduplication -- that's handled by notification_history
- *   table from Phase 12's checkNotificationTriggers()
- *
- * Usage:
- * - Quota/trial triggers are called by Phase 12 notification system
- * - Payment failed trigger is called by billing email triggers
- * - Team member joined trigger is called by server actions
+ * Each trigger creates an in-app notification (awaited) and sends an email
+ * (fire-and-forget, errors logged). Deduplication is the caller's job.
  */
+import { type Money } from "../money.js";
 /**
- * Trigger a quota warning or exceeded notification.
- * Creates an in-app notification and sends an email.
+ * The plan allowance is money, not tokens: `used` and `allowance` are
+ * amounts in the deployment's billing currency, and the copy prints
+ * them as such.
  */
 export declare function triggerQuotaNotification(params: {
     userId: string;
@@ -26,14 +14,10 @@ export declare function triggerQuotaNotification(params: {
     workspaceId: string;
     workspaceName: string;
     percentageUsed: number;
-    tokensUsed: number;
-    tokensLimit: number;
+    used: Money;
+    allowance: Money;
     isExceeded: boolean;
 }): Promise<void>;
-/**
- * Trigger a trial credits warning or depleted notification.
- * Creates an in-app notification and sends an email.
- */
 export declare function triggerTrialNotification(params: {
     userId: string;
     userEmail: string;
@@ -44,10 +28,6 @@ export declare function triggerTrialNotification(params: {
     percentageRemaining: number;
     isDepleted: boolean;
 }): Promise<void>;
-/**
- * Trigger a payment failed notification.
- * Creates an in-app notification and sends an email.
- */
 export declare function triggerPaymentFailedNotification(params: {
     userId: string;
     userEmail: string;
@@ -55,10 +35,7 @@ export declare function triggerPaymentFailedNotification(params: {
     workspaceName: string;
     amount: string;
 }): Promise<void>;
-/**
- * Trigger a team member joined notification.
- * Creates an in-app notification ONLY (no email for this event).
- */
+/** In-app only: this event sends no email. */
 export declare function triggerTeamMemberJoinedNotification(params: {
     userId: string;
     workspaceId: string;

package/dist/notifications/triggers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../src/notifications/triggers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAaH;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgChB;AAMD;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkChB;AAMD;;;GAGG;AACH,wBAAsB,gCAAgC,CAAC,MAAM,EAAE;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBhB;AAMD;;;GAGG;AACH,wBAAsB,mCAAmC,CAAC,MAAM,EAAE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAahB"}
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../src/notifications/triggers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAKnD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,KAAK,CAAC;IACZ,SAAS,EAAE,KAAK,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChB;AAED,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgChB;AAED,wBAAsB,gCAAgC,CAAC,MAAM,EAAE;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBhB;AAED,8CAA8C;AAC9C,wBAAsB,mCAAmC,CAAC,MAAM,EAAE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhB"}

package/dist/notifications/triggers.js

@@ -1,69 +1,49 @@
 /**
- * Notification Trigger Functions
- *
- * These functions create BOTH in-app notifications (via createNotification)
- * AND send emails (via email senders). They are the integration points that
- * connect application events to the notification + email infrastructure.
- *
- * Design:
- * - In-app notifications are awaited (fast DB inserts)
- * - Email sends are fire-and-forget (non-blocking, errors logged)
- * - These do NOT handle deduplication -- that's handled by notification_history
- *   table from Phase 12's checkNotificationTriggers()
- *
- * Usage:
- * - Quota/trial triggers are called by Phase 12 notification system
- * - Payment failed trigger is called by billing email triggers
- * - Team member joined trigger is called by server actions
+ * Each trigger creates an in-app notification (awaited) and sends an email
+ * (fire-and-forget, errors logged). Deduplication is the caller's job.
  */
-import { createNotification } from "./index";
-import { sendQuotaWarningEmail, sendTrialWarningEmail, sendPaymentFailedEmail, } from "../email/senders";
-// ---------------------------------------------------------------------------
-// Quota Notifications (QUOTA-08, QUOTA-09)
-// ---------------------------------------------------------------------------
+import { createNotification } from "./index.js";
+import { sendQuotaWarningEmail, sendTrialWarningEmail, sendPaymentFailedEmail, } from "../email/senders.js";
+import { formatMoney } from "../money.js";
+/** The locale the framework's own notification and email copy is written in. */
+const COPY_LOCALE = "en";
 /**
- * Trigger a quota warning or exceeded notification.
- * Creates an in-app notification and sends an email.
+ * The plan allowance is money, not tokens: `used` and `allowance` are
+ * amounts in the deployment's billing currency, and the copy prints
+ * them as such.
  */
 export async function triggerQuotaNotification(params) {
     const upgradeUrl = `${process.env.NEXT_PUBLIC_APP_URL || "http://localhost:3000"}/settings/billing`;
-    // Create in-app notification (awaited -- fast DB insert)
+    const used = formatMoney(params.used, COPY_LOCALE);
+    const allowance = formatMoney(params.allowance, COPY_LOCALE);
     await createNotification({
         userId: params.userId,
         workspaceId: params.workspaceId,
         type: params.isExceeded ? "quota_warning_100" : "quota_warning_80",
-        title: params.isExceeded ? "Quota Exceeded" : "Quota Warning",
+        title: params.isExceeded ? "Allowance Used Up" : "Allowance Warning",
         message: params.isExceeded
-            ? `Your workspace "${params.workspaceName}" has used all ${params.tokensLimit.toLocaleString()} tokens this month. Upgrade your plan for more tokens.`
-            : `Your workspace "${params.workspaceName}" has used ${params.percentageUsed}% of its monthly token quota.`,
+            ? `Your workspace "${params.workspaceName}" has used all of its ${allowance} monthly allowance. Upgrade your plan for more.`
+            : `Your workspace "${params.workspaceName}" has used ${used} of its ${allowance} monthly allowance (${params.percentageUsed}%).`,
         metadata: {
             workspaceName: params.workspaceName,
             percentageUsed: params.percentageUsed,
-            tokensUsed: params.tokensUsed,
-            tokensLimit: params.tokensLimit,
+            usedMicros: params.used.amount,
+            allowanceMicros: params.allowance.amount,
+            currency: params.allowance.currency,
         },
     });
-    // Send email (fire-and-forget -- non-blocking)
     sendQuotaWarningEmail({
         to: params.userEmail,
         workspaceName: params.workspaceName,
         percentageUsed: params.percentageUsed,
-        tokensUsed: params.tokensUsed,
-        tokensLimit: params.tokensLimit,
+        used: params.used,
+        allowance: params.allowance,
         upgradeUrl,
         isExceeded: params.isExceeded,
     }).catch((err) => console.error("[Email] Failed to send quota warning:", err));
 }
-// ---------------------------------------------------------------------------
-// Trial Notifications (TRIAL-04, TRIAL-05)
-// ---------------------------------------------------------------------------
-/**
- * Trigger a trial credits warning or depleted notification.
- * Creates an in-app notification and sends an email.
- */
 export async function triggerTrialNotification(params) {
     const upgradeUrl = `${process.env.NEXT_PUBLIC_APP_URL || "http://localhost:3000"}/settings/billing`;
-    // Create in-app notification (awaited -- fast DB insert)
     await createNotification({
         userId: params.userId,
         workspaceId: params.workspaceId,
@@ -81,7 +61,6 @@ export async function triggerTrialNotification(params) {
             percentageRemaining: params.percentageRemaining,
         },
     });
-    // Send email (fire-and-forget -- non-blocking)
     sendTrialWarningEmail({
         to: params.userEmail,
         workspaceName: params.workspaceName,
@@ -92,16 +71,8 @@ export async function triggerTrialNotification(params) {
         isDepleted: params.isDepleted,
     }).catch((err) => console.error("[Email] Failed to send trial warning:", err));
 }
-// ---------------------------------------------------------------------------
-// Payment Failed Notification
-// ---------------------------------------------------------------------------
-/**
- * Trigger a payment failed notification.
- * Creates an in-app notification and sends an email.
- */
 export async function triggerPaymentFailedNotification(params) {
     const updatePaymentUrl = `${process.env.NEXT_PUBLIC_APP_URL || "http://localhost:3000"}/settings/billing`;
-    // Create in-app notification (awaited -- fast DB insert)
     await createNotification({
         userId: params.userId,
         workspaceId: params.workspaceId,
@@ -113,7 +84,6 @@ export async function triggerPaymentFailedNotification(params) {
             amount: params.amount,
         },
     });
-    // Send email (fire-and-forget -- non-blocking)
     sendPaymentFailedEmail({
         to: params.userEmail,
         workspaceName: params.workspaceName,
@@ -121,15 +91,8 @@ export async function triggerPaymentFailedNotification(params) {
         updatePaymentUrl,
     }).catch((err) => console.error("[Email] Failed to send payment failed:", err));
 }
-// ---------------------------------------------------------------------------
-// Team Member Joined Notification
-// ---------------------------------------------------------------------------
-/**
- * Trigger a team member joined notification.
- * Creates an in-app notification ONLY (no email for this event).
- */
+/** In-app only: this event sends no email. */
 export async function triggerTeamMemberJoinedNotification(params) {
-    // Create in-app notification only (no email for team member joined events)
     await createNotification({
         userId: params.userId,
         workspaceId: params.workspaceId,