@antelopejs/interface-dms 0.3.4 → 0.3.6

package/dist/invite-extensions.js

@@ -10,19 +10,69 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HTTP_BAD_REQUEST = exports.internal = exports.RegisterInviteAvailability = void 0;
+exports.internal = exports.RegisterInviteAvailability = void 0;
+/**
+ * Module data carried by a member invitation — the invitation-side counterpart
+ * of `@RegisterPageExtension`, split by concern under `./invite-extensions/`:
+ *
+ * - `types` — the contracts a contributor implements
+ * - `registry` — `RegisterInviteExtension` and the registration proxy that
+ *   binds an extension to its module's lifetime
+ * - `availability` — `RegisterInviteAvailability`, which disables the invite
+ *   action with a reason
+ *
+ * The rest is driven by the DMS runtime alone and lives under
+ * `./invite-extensions/internal/`: the namespacing of contributed fields
+ * (`field-ids`), their serialization, placement and merging into the DMS
+ * invite modal (`form-slot`), validation at submit, delivery at acceptance and
+ * cleanup (`delivery`), and the prefill, validation and notification of a
+ * pending invitation's edit (`edit`).
+ *
+ * `form-slot` claims the invite forms' component slots on import, so importing
+ * this barrel is what opens the modal and the edit form to extensions.
+ */
+require("./invite-extensions/internal/form-slot");
+const availability = __importStar(require("./invite-extensions/internal/availability"));
+const registry_1 = require("./invite-extensions/registry");
 var availability_1 = require("./invite-extensions/availability");
 Object.defineProperty(exports, "RegisterInviteAvailability", { enumerable: true, get: function () { return availability_1.RegisterInviteAvailability; } });
-__exportStar(require("./invite-extensions/field-ids"), exports);
-__exportStar(require("./invite-extensions/form-slot"), exports);
-var internal_1 = require("./invite-extensions/internal");
-Object.defineProperty(exports, "internal", { enumerable: true, get: function () { return internal_1.internal; } });
-var payload_slices_1 = require("./invite-extensions/payload-slices");
-Object.defineProperty(exports, "HTTP_BAD_REQUEST", { enumerable: true, get: function () { return payload_slices_1.HTTP_BAD_REQUEST; } });
 __exportStar(require("./invite-extensions/registry"), exports);
 __exportStar(require("./invite-extensions/types"), exports);
+// Shadows the namespace registry.ts declares: the same proxy, plus
+// `ResolveInviteAvailability`, which module tests reach through it.
+/**
+ * @internal
+ */
+var internal;
+(function (internal) {
+    internal.RegisterInviteExtension = registry_1.internal.RegisterInviteExtension;
+    /** Kept for module compatibility; the DMS imports it from `internal/availability`. */
+    internal.ResolveInviteAvailability = availability.ResolveInviteAvailability;
+})(internal || (exports.internal = internal = {}));
 //# sourceMappingURL=invite-extensions.js.map

package/dist/invite-extensions.js.map

@@ -1 +1 @@
-{"version":3,"file":"invite-extensions.js","sourceRoot":"","sources":["../src/invite-extensions.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAsBA,iEAG0C;AADxC,0HAAA,0BAA0B,OAAA;AAE5B,gEAA8C;AAC9C,gEAA8C;AAC9C,yDAAwD;AAA/C,oGAAA,QAAQ,OAAA;AACjB,qEAAsE;AAA7D,kHAAA,gBAAgB,OAAA;AACzB,+DAA6C;AAC7C,4DAA0C"}
+{"version":3,"file":"invite-extensions.js","sourceRoot":"","sources":["../src/invite-extensions.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,kDAAgD;AAChD,wFAA0E;AAC1E,2DAAoE;AAEpE,iEAG0C;AADxC,0HAAA,0BAA0B,OAAA;AAE5B,+DAA6C;AAC7C,4DAA0C;AAE1C,mEAAmE;AACnE,oEAAoE;AAEpE;;GAEG;AACH,IAAiB,QAAQ,CAMxB;AAND,WAAiB,QAAQ;IACV,gCAAuB,GAAG,mBAAQ,CAAC,uBAAuB,CAAC;IAExE,sFAAsF;IACzE,kCAAyB,GACpC,YAAY,CAAC,yBAAyB,CAAC;AAC3C,CAAC,EANgB,QAAQ,wBAAR,QAAQ,QAMxB"}

package/dist/invite-resolution.d.ts

@@ -1,9 +1,12 @@
-import { type InviteDecision } from "./db/models/inviteResolutions.model";
+import type { InviteDecision } from "./db/models/inviteResolutions.model";
 import type { InviteResolution } from "./db/tables/inviteResolutions.table";
 import type { UserInvite } from "./db/tables/user_invites.table";
 export type ResolveInviteInput = Omit<InviteDecision, "extensionKeys">;
+/** Loads the exact incarnation or its durable snapshot so failed actions can resume. */
 export declare function loadInviteForAction(tenantId: string, inviteId: string): Promise<UserInvite | undefined>;
+/** Rejects actions on a replacement until its creating hooks complete. */
 export declare function assertInviteReady(tenantId: string, invite: UserInvite): Promise<void>;
+/** Chooses one permanent outcome; all competing lifecycle paths must use this before effects. */
 export declare function decideInvite(input: ResolveInviteInput): Promise<InviteResolution>;
+/** Replays durable effects. Contributor callbacks must deduplicate by deliveryId; failures retain the snapshot. */
 export declare function completeInviteResolution(resolution: InviteResolution): Promise<void>;
-export declare function completeAdmittedInviteResolution(resolution: InviteResolution): Promise<void>;

package/dist/invite-resolution.js

@@ -4,19 +4,16 @@ exports.loadInviteForAction = loadInviteForAction;
 exports.assertInviteReady = assertInviteReady;
 exports.decideInvite = decideInvite;
 exports.completeInviteResolution = completeInviteResolution;
-exports.completeAdmittedInviteResolution = completeAdmittedInviteResolution;
 const node_util_1 = require("node:util");
 const interface_api_util_1 = require("@antelopejs/interface-api-util");
 const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
-const inviteResolutions_model_1 = require("./db/models/inviteResolutions.model");
+const inviteResolutions_model_1 = require("./db/internal/inviteResolutions.model");
 const user_invites_model_1 = require("./db/models/user_invites.model");
-const hooks_1 = require("./hooks");
-const invite_extensions_1 = require("./invite-extensions");
-const delivery_1 = require("./invite-extensions/delivery");
-const invite_membership_1 = require("./invite-membership");
-const invite_replacement_1 = require("./invite-replacement");
+const registry_1 = require("./invite-extensions/internal/registry");
 const tenant_lifecycle_1 = require("./tenant-lifecycle");
+const invite_resolution_1 = require("./internal/invite-resolution");
 const HTTP_CONFLICT = 409;
+/** Loads the exact incarnation or its durable snapshot so failed actions can resume. */
 async function loadInviteForAction(tenantId, inviteId) {
     const invite = await (0, interface_database_decorators_1.GetModel)(user_invites_model_1.UserInviteModel, tenantId).get(inviteId);
     if (invite)
@@ -24,12 +21,20 @@ async function loadInviteForAction(tenantId, inviteId) {
     const resolution = await (0, interface_database_decorators_1.GetModel)(inviteResolutions_model_1.InviteResolutionsModel, tenantId).getForInvite(tenantId, inviteId);
     return resolution?.invite;
 }
+/** Rejects actions on a replacement until its creating hooks complete. */
 async function assertInviteReady(tenantId, invite) {
     if (!invite.creationResolutionId)
         return;
     const parent = await (0, interface_database_decorators_1.GetModel)(inviteResolutions_model_1.InviteResolutionsModel, tenantId).get(invite.creationResolutionId);
     (0, interface_api_util_1.assert)(parent?.completed, HTTP_CONFLICT, "Invitation creation is still pending");
 }
+/**
+ * The replacement's content as plain data.
+ *
+ * `roles_ids` and `extensions` reach this comparison as per-context views when
+ * the caller lives in another module, and `isDeepStrictEqual` refuses two views
+ * holding the same values — which would report a faithful retry as a conflict.
+ */
 function replacementContent(invite) {
     if (!invite)
         return null;
@@ -49,6 +54,7 @@ function assertSameDecision(resolution, input) {
         resolution.userId === (input.userId ?? null), HTTP_CONFLICT, "Invitation already has a different terminal decision");
     (0, interface_api_util_1.assert)((0, node_util_1.isDeepStrictEqual)(replacementContent(resolution.replacement), replacementContent(input.replacement)), HTTP_CONFLICT, "Invitation already has a different replacement");
 }
+/** Chooses one permanent outcome; all competing lifecycle paths must use this before effects. */
 async function decideInvite(input) {
     await assertInviteReady(input.tenantId, input.invite);
     const model = (0, interface_database_decorators_1.GetModel)(inviteResolutions_model_1.InviteResolutionsModel, input.tenantId);
@@ -59,51 +65,15 @@ async function decideInvite(input) {
     const extensionKeys = [
         ...new Set([
             ...Object.keys(input.invite.extensions ?? {}),
-            ...(0, invite_extensions_1.listInviteExtensions)().map((extension) => extension.key),
+            ...(0, registry_1.listInviteExtensions)().map((extension) => extension.key),
         ]),
     ];
     const resolution = await model.decide({ ...input, extensionKeys });
     assertSameDecision(resolution, input);
     return resolution;
 }
-function requireExtensions(resolution) {
-    const available = new Set((0, invite_extensions_1.listInviteExtensions)().map((extension) => extension.key));
-    const missing = resolution.extensionKeys.filter((key) => !available.has(key));
-    if (missing.length)
-        throw new Error(`Invite delivery awaits extensions: ${missing.join(", ")}`);
-}
-async function deliverAcceptance(resolution) {
-    const member = await (0, invite_membership_1.ensureInviteMembership)(resolution);
-    await (0, delivery_1.DeliverInviteExtensions)(resolution.invite.extensions, member, {
-        tenantId: resolution.tenantId,
-        email: resolution.invite.email,
-        inviteId: resolution.invite._id,
-        deliveryId: resolution._id,
-    }, { retryOnFailure: true });
-}
+/** Replays durable effects. Contributor callbacks must deduplicate by deliveryId; failures retain the snapshot. */
 async function completeInviteResolution(resolution) {
-    await (0, tenant_lifecycle_1.runTenantLifecycleOperation)(resolution.tenantId, () => completeAdmittedInviteResolution(resolution));
-}
-async function completeAdmittedInviteResolution(resolution) {
-    const model = (0, interface_database_decorators_1.GetModel)(inviteResolutions_model_1.InviteResolutionsModel, resolution.tenantId);
-    const current = await model.get(resolution._id);
-    if (!current)
-        throw new Error("Invite decision disappeared");
-    if (current.completed)
-        return;
-    requireExtensions(current);
-    if (current.reason === "accepted")
-        await deliverAcceptance(current);
-    await (0, hooks_1.ExecuteHooks)(hooks_1.Hook.INVITE_DELETED, {
-        tenantId: current.tenantId,
-        inviteId: current.invite._id,
-        email: current.invite.email,
-        reason: current.reason,
-        extensions: current.invite.extensions,
-        deliveryId: current._id,
-    });
-    await (0, invite_replacement_1.ensureInviteReplacement)(current);
-    await (0, interface_database_decorators_1.GetModel)(user_invites_model_1.UserInviteModel, current.tenantId).delete(current.invite._id);
-    await model.update(current._id, { completed: true });
+    await (0, tenant_lifecycle_1.runTenantLifecycleOperation)(resolution.tenantId, () => (0, invite_resolution_1.completeAdmittedInviteResolution)(resolution));
 }
 //# sourceMappingURL=invite-resolution.js.map

package/dist/invite-resolution.js.map

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

package/dist/invitee-display-name.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Combined display name of an invitee, or `undefined` when the invite carries
+ * no name.
+ */
+export declare function inviteeDisplayName(firstname?: string | null, lastname?: string | null): string | undefined;

package/dist/invitee-display-name.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inviteeDisplayName = inviteeDisplayName;
+/**
+ * Combined display name of an invitee, or `undefined` when the invite carries
+ * no name.
+ */
+function inviteeDisplayName(firstname, lastname) {
+    const name = [firstname, lastname]
+        .filter((part) => !!part)
+        .join(" ")
+        .trim();
+    return name || undefined;
+}
+//# sourceMappingURL=invitee-display-name.js.map

package/dist/invitee-display-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invitee-display-name.js","sourceRoot":"","sources":["../src/invitee-display-name.ts"],"names":[],"mappings":";;AAIA,gDASC;AAbD;;;GAGG;AACH,SAAgB,kBAAkB,CAChC,SAAyB,EACzB,QAAwB;IAExB,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC;SAC/B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SACxB,IAAI,CAAC,GAAG,CAAC;SACT,IAAI,EAAE,CAAC;IACV,OAAO,IAAI,IAAI,SAAS,CAAC;AAC3B,CAAC"}

package/dist/invites.d.ts

@@ -1,6 +1,7 @@
 import { type UserInvite } from "./db";
 import { type InviteReplacementReason } from "./hooks";
 import type { InviteExtensionPayloads } from "./invite-extensions";
+export { inviteeDisplayName } from "./invitee-display-name";
 export declare const INVITE_TOKEN_LENGTH = 64;
 export declare const INVITE_EXPIRY_DAYS = 7;
 export interface InviteUserToTenantOptions {
@@ -12,31 +13,54 @@ export interface InviteUserToTenantOptions {
     roleIds?: string[];
     asTenantOwner?: boolean;
     skipEmailValidation?: boolean;
+    /** Opt-in: dispatch `sendAdminInviteEmail` after the invite row is created. */
     sendEmail?: boolean;
+    /**
+     * With `sendEmail`, wait for the email instead of sending it in the
+     * background, and report its outcome as the result's `emailDelivery`. The
+     * invitation is kept either way, so the caller can tell the inviter to
+     * resend it when the email did not leave.
+     */
+    awaitEmailDelivery?: boolean;
+    /** Who sends the invitation, named in its email. */
     inviterName?: string;
+    /** Id of the user who sends the invitation, shown next to it in the list. */
+    invitedBy?: string | null;
+    /** Module payloads collected in the invite modal, keyed by extension key. */
     extensions?: InviteExtensionPayloads;
 }
-export declare function inviteeDisplayName(firstname?: string | null, lastname?: string | null): string | undefined;
-export declare namespace internal {
-    interface TenantInviteEmail {
-        tenantId: string;
-        email: string;
-        token: string;
-        firstname?: string | null;
-        lastname?: string | null;
-        language?: string;
-        inviterName?: string;
-    }
-    function sendTenantInviteEmail(invite: TenantInviteEmail): Promise<void>;
+/** Whether a tenant invitation's email left. */
+export type InviteEmailDelivery = "sent" | "failed";
+export interface InvitedUserResult {
+    kind: "invited";
+    inviteId: string;
+    token: string;
+    /**
+     * Outcome of the invitation email. Set only when the call passed both
+     * `sendEmail` and `awaitEmailDelivery`.
+     */
+    emailDelivery?: InviteEmailDelivery;
 }
 export type InviteUserToTenantResult = {
     kind: "added";
     userId: string;
-} | {
-    kind: "invited";
-    inviteId: string;
-    token: string;
-};
+} | InvitedUserResult;
+/**
+ * Invite a user (existing or not) to a tenant.
+ *
+ * - If the email belongs to an existing user, they are added directly via
+ *   `applyTenantOwnership` and no token is generated. Invite extensions are
+ *   delivered on the spot: there is no invitation for them to wait on, and the
+ *   admin filled their fields in the same modal either way.
+ * - Otherwise a `user_invites` row is created and (when `sendEmail` is true)
+ *   `sendAdminInviteEmail` is dispatched: in the background by default, or
+ *   awaited with `awaitEmailDelivery`, its outcome then reported as
+ *   `emailDelivery`. A failed email never undoes the invitation.
+ *
+ * The caller is responsible for any pre-checks specific to its context
+ * (e.g. "already a member" → 409 for the DMS users route). This helper is
+ * intentionally side-effect-light: it does not throw on duplicates.
+ */
 export declare function inviteUserToTenant(options: InviteUserToTenantOptions): Promise<InviteUserToTenantResult>;
 export interface CreateUserInviteTokenOptions {
     tenantId: string;
@@ -47,12 +71,25 @@ export interface CreateUserInviteTokenOptions {
     roleIds: string[];
     asTenantOwner: boolean;
     skipEmailValidation: boolean;
+    /** Id of the user who sends the invitation; `null` when nobody signed in did. */
+    invitedBy?: string | null;
     extensions?: InviteExtensionPayloads;
+    /**
+     * How to report the deletion of an invitation this one displaces. Defaults
+     * to `replaced`; a resend passes `resent`, which reissues the same
+     * invitation and must not have contributors undo what it carries.
+     */
     replacementReason?: InviteReplacementReason;
+    /** Exact incarnation to replace, including a retained snapshot during a retry. */
     replacesInvite?: UserInvite;
 }
 export interface CreateUserInviteTokenResult {
     inviteId: string;
     token: string;
 }
+/**
+ * Low-level: create a `user_invites` row + token for a tenant. Replaces any
+ * existing invite for the same email (within the tenant). Fires
+ * INVITE_DELETED / INVITE_BEING_CREATED / INVITE_CREATED hooks.
+ */
 export declare function createUserInviteToken(options: CreateUserInviteTokenOptions): Promise<CreateUserInviteTokenResult>;

package/dist/invites.js

@@ -3,57 +3,60 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.internal = exports.INVITE_EXPIRY_DAYS = exports.INVITE_TOKEN_LENGTH = void 0;
-exports.inviteeDisplayName = inviteeDisplayName;
+exports.INVITE_EXPIRY_DAYS = exports.INVITE_TOKEN_LENGTH = exports.inviteeDisplayName = void 0;
 exports.inviteUserToTenant = inviteUserToTenant;
 exports.createUserInviteToken = createUserInviteToken;
 const node_crypto_1 = require("node:crypto");
 const logging_1 = require("@antelopejs/interface-core/logging");
 const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
 const db_1 = require("./db");
-const auth_1 = require("./auth");
 const db_2 = require("./auth/db");
 const randomstring_1 = __importDefault(require("randomstring"));
 const fire_and_forget_1 = require("./utils/fire-and-forget");
-const time_1 = require("./utils/time");
+const time_1 = require("./utils/internal/time");
 const hooks_1 = require("./hooks");
-const delivery_1 = require("./invite-extensions/delivery");
-const invite_resolution_1 = require("./invite-resolution");
+const delivery_1 = require("./invite-extensions/internal/delivery");
+const invite_resolution_1 = require("./internal/invite-resolution");
+const invite_resolution_2 = require("./invite-resolution");
 const tenant_lifecycle_1 = require("./tenant-lifecycle");
-const tenant_ownership_1 = require("./tenant-ownership");
+const tenant_ownership_1 = require("./internal/tenant-ownership");
+const invites_1 = require("./internal/invites");
+var invitee_display_name_1 = require("./invitee-display-name");
+Object.defineProperty(exports, "inviteeDisplayName", { enumerable: true, get: function () { return invitee_display_name_1.inviteeDisplayName; } });
 exports.INVITE_TOKEN_LENGTH = 64;
 exports.INVITE_EXPIRY_DAYS = 7;
-function inviteeDisplayName(firstname, lastname) {
-    const name = [firstname, lastname]
-        .filter((part) => !!part)
-        .join(" ")
-        .trim();
-    return name || undefined;
-}
-async function tenantName(tenantId) {
-    const tenant = await (0, interface_database_decorators_1.GetModel)(db_1.TenantModel).get(tenantId);
-    return tenant?.name || undefined;
-}
-var internal;
-(function (internal) {
-    async function sendTenantInviteEmail(invite) {
-        await (0, auth_1.sendAdminInviteEmail)(invite.email, invite.token, inviteeDisplayName(invite.firstname, invite.lastname), {
-            workspaceName: await tenantName(invite.tenantId),
-            inviterName: invite.inviterName,
-            language: invite.language,
-        });
-    }
-    internal.sendTenantInviteEmail = sendTenantInviteEmail;
-})(internal || (exports.internal = internal = {}));
+/**
+ * Invite a user (existing or not) to a tenant.
+ *
+ * - If the email belongs to an existing user, they are added directly via
+ *   `applyTenantOwnership` and no token is generated. Invite extensions are
+ *   delivered on the spot: there is no invitation for them to wait on, and the
+ *   admin filled their fields in the same modal either way.
+ * - Otherwise a `user_invites` row is created and (when `sendEmail` is true)
+ *   `sendAdminInviteEmail` is dispatched: in the background by default, or
+ *   awaited with `awaitEmailDelivery`, its outcome then reported as
+ *   `emailDelivery`. A failed email never undoes the invitation.
+ *
+ * The caller is responsible for any pre-checks specific to its context
+ * (e.g. "already a member" → 409 for the DMS users route). This helper is
+ * intentionally side-effect-light: it does not throw on duplicates.
+ */
 async function inviteUserToTenant(options) {
     const result = await (0, tenant_lifecycle_1.runTenantLifecycleOperation)(options.tenantId, () => inviteAdmittedUser(options));
-    if (options.sendEmail && result.kind === "invited") {
-        (0, fire_and_forget_1.fireAndForget)(internal.sendTenantInviteEmail({ ...options, token: result.token }), `invite email to "${options.email}"`);
+    if (!options.sendEmail || result.kind !== "invited")
+        return result;
+    const invite = { ...options, token: result.token };
+    if (!options.awaitEmailDelivery) {
+        (0, fire_and_forget_1.fireAndForget)((0, invites_1.sendTenantInviteEmail)(invite), `invite email to "${options.email}"`);
+        return result;
     }
-    return result;
+    return {
+        ...result,
+        emailDelivery: await (0, invites_1.deliverTenantInviteEmail)(invite),
+    };
 }
 async function inviteAdmittedUser(options) {
-    const { tenantId, email, firstname = null, lastname = null, language = "en", roleIds = [], asTenantOwner = false, skipEmailValidation = false, extensions, } = options;
+    const { tenantId, email, firstname = null, lastname = null, language = "en", roleIds = [], asTenantOwner = false, skipEmailValidation = false, invitedBy = null, extensions, } = options;
     const userModel = (0, interface_database_decorators_1.GetModel)(db_2.UserModel);
     const existingUser = await userModel.getByEmail(email);
     if (existingUser) {
@@ -73,10 +76,16 @@ async function inviteAdmittedUser(options) {
         roleIds,
         asTenantOwner,
         skipEmailValidation,
+        invitedBy,
         extensions,
     });
     return { kind: "invited", inviteId, token };
 }
+/**
+ * The membership is already granted when this runs, so a failure here is
+ * reported and swallowed: surfacing it would tell the admin the invitation
+ * failed for a user who is in fact a member of the tenant.
+ */
 async function deliverToExistingMember(tenantId, email, userId, extensions) {
     if (!extensions)
         return;
@@ -91,6 +100,11 @@ async function deliverToExistingMember(tenantId, email, userId, extensions) {
         logging_1.Logging.Error(`[dms] invite extensions for "${email}" could not be delivered on direct add:`, error);
     }
 }
+/**
+ * Low-level: create a `user_invites` row + token for a tenant. Replaces any
+ * existing invite for the same email (within the tenant). Fires
+ * INVITE_DELETED / INVITE_BEING_CREATED / INVITE_CREATED hooks.
+ */
 async function createUserInviteToken(options) {
     return (0, tenant_lifecycle_1.runTenantLifecycleOperation)(options.tenantId, () => createAdmittedInviteToken(options));
 }
@@ -100,7 +114,7 @@ async function createAdmittedInviteToken(options) {
     const existingInvite = options.replacesInvite ?? (await userInviteModel.getByEmail(email));
     const replacement = buildInviteSnapshot(options);
     if (existingInvite) {
-        const resolution = await (0, invite_resolution_1.decideInvite)({
+        const resolution = await (0, invite_resolution_2.decideInvite)({
             tenantId,
             invite: existingInvite,
             reason: options.replacementReason ?? "replaced",
@@ -144,6 +158,7 @@ function buildInviteSnapshot(options) {
         asTenantOwner: options.asTenantOwner,
         expiresAt: new Date(Date.now() + exports.INVITE_EXPIRY_DAYS * time_1.MILLISECONDS_PER_DAY),
         skipEmailValidation: options.skipEmailValidation,
+        invitedBy: options.invitedBy ?? null,
         extensions: options.extensions ?? null,
     });
 }

package/dist/invites.js.map

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

package/dist/layout-banners.d.ts

@@ -1,41 +1,109 @@
 import { RegisteringProxy } from "@antelopejs/interface-core";
 import type { User } from "./auth/db";
 import type { MaybePromise } from "./types";
+/**
+ * Semantic look of a layout banner. It also picks the banner's ARIA role:
+ * `error` is announced as an `alert`, `info` and `warning` politely as a
+ * `status`.
+ */
 export declare const LayoutBannerVariant: {
     readonly INFO: "info";
     readonly WARNING: "warning";
     readonly ERROR: "error";
 };
 export type LayoutBannerVariant = (typeof LayoutBannerVariant)[keyof typeof LayoutBannerVariant];
+/**
+ * What a banner's `visible` resolver decides on: the request the site layout
+ * is being built for.
+ */
 export interface LayoutBannerContext {
+    /** Undefined for an unauthenticated request. */
     user: User | undefined;
     tenantId: string;
+    /**
+     * The caller's effective permissions in the tenant, ignoring any tenant
+     * access gate: a banner is precisely how a suspended or past-due workspace
+     * gets told why, so it must not go dark when the gate does. Read
+     * `isTenantAccessDenied` to tell the two situations apart.
+     */
     permissions: Set<string>;
+    /** Whether the caller holds the wildcard permission, gate ignored. */
     isOwner: boolean;
+    /** Whether a tenant access gate currently refuses the caller. */
     isTenantAccessDenied: boolean;
 }
+/**
+ * Decides, per request, whether a banner shows. Runs server-side while the
+ * site layout is built, so the answer is part of the server-rendered page and
+ * the banner never flashes in or out after hydration.
+ *
+ * It sits on the critical path of every page load: a resolver that throws, or
+ * does not answer within two seconds, hides its banner for that request.
+ */
 export type LayoutBannerVisibility = (context: LayoutBannerContext) => MaybePromise<boolean>;
 interface LayoutBannerBase {
+    /**
+     * Unique key of the banner across the deployment: re-registering a key
+     * replaces the banner, and the key is what a dismissal remembers — give a
+     * banner a new key when it must show again to users who dismissed it.
+     */
     key: string;
     variant: LayoutBannerVariant;
+    /**
+     * Stack order, ascending from the top. Defaults to `0`; ties keep the
+     * registration order.
+     */
     order?: number;
+    /** Leading icon. Defaults to one matching the variant. */
     icon?: string;
+    /**
+     * Whether the user can close the banner. A dismissal lasts for the browser
+     * session and is remembered in a cookie, so the server-rendered page already
+     * leaves the banner out. Defaults to `false`.
+     */
     dismissible?: boolean;
+    /** Absent means the banner shows on every request. */
     visible?: LayoutBannerVisibility;
 }
+/** A banner showing a line of text. */
 export interface LayoutBannerTextInfo extends LayoutBannerBase {
+    /** The message. A `$`-prefixed value resolves as an i18n key. */
     text: string;
     component?: never;
     props?: never;
 }
+/** A banner mounting a component of a frontend layer as its content. */
 export interface LayoutBannerComponentInfo extends LayoutBannerBase {
+    /**
+     * Name of a global component, provided by a frontend layer, rendered as the
+     * banner's content. The DMS still draws the chrome: color, icon, dismiss
+     * button and ARIA role.
+     */
     component: string;
+    /** Props passed to the component. Must be serializable. */
     props?: Record<string, unknown>;
     text?: never;
 }
+/**
+ * A global banner rendered under the header of the dashboard layout, on every
+ * page — tenant pages and module back-office pages alike.
+ */
 export type LayoutBannerInfo = LayoutBannerTextInfo | LayoutBannerComponentInfo;
+/** @internal */
 export declare namespace internal {
     const RegisterLayoutBanner: RegisteringProxy<(info: LayoutBannerInfo) => void>;
 }
+/**
+ * Register a global banner under the dashboard header. Banners stack by
+ * `order`, and each one's `visible` resolver is evaluated server-side for every
+ * site layout request, so the banner is in the server-rendered page. When the
+ * state a resolver reads changes, call `NotifyMenuChanged(tenantId)` so the
+ * connected clients re-fetch their site layout.
+ *
+ * The registration is dropped automatically when the registering module stops.
+ *
+ * @returns Removes this banner, for a module that drops it while staying
+ * loaded.
+ */
 export declare function RegisterLayoutBanner(info: LayoutBannerInfo): () => void;
 export {};