@fabriktor/fx 0.0.143 → 0.0.145

package/dist/src/chat/chat.d.ts

@@ -65,7 +65,7 @@ export type MyChatRoomMembersOptions = {
 export type ChatRoomParticipantsOptions = {
     chat_room_ids: string[];
 };
-export type ChatRoomParticipant = Pick<User, "id" | "full_name" | "username">;
+export type ChatRoomParticipant = Pick<User, "id" | "full_name" | "username" | "account_identity">;
 export type ChatRoomParticipants = {
     members: ChatRoomMember[];
     users: ChatRoomParticipant[];

package/dist/src/chat/chat.js

@@ -6,8 +6,9 @@
 import { queryParam, queryParams, } from "@fabriktor/client";
 import { IDKey, OwnerIDKey, } from "@fabriktor/schema";
 import { errRequired, errResolveFailed, errValidation } from "../core/err.js";
-import { requiredOperationID } from "../core/id.js";
+import { requiredOperationID, normalizeIDs } from "../core/id.js";
 import { normalizeSearchPage, normalizeSearchPerPage, normalizeSearchQuery, runSearch, } from "../core/search.js";
+import { isFabriktorUser } from "../users/users.js";
 import { ChatSendQueue } from "./send-queue.js";
 const closeCodeNormal = 1000;
 const wsRefreshMilliseconds = 40 * 60 * 1000;
@@ -19,6 +20,7 @@ const msgEnsuredChatRoomIDMissing = "Ensured chat room response did not contain
 const msgChatMissing = "Chat could not be resolved after the mutation.";
 const msgSearchQueryRequired = "Search query is required.";
 const msgChatObjectsUploading = "Cannot react to a chat while objects are still uploading.";
+const msgChatRecipients = "Chat recipients must have a Fabriktor account. External contacts cannot receive messages or forms.";
 const msgParticipantMissing = "Chat room participant could not be resolved.";
 export class ChatFX {
     chat;
@@ -36,7 +38,22 @@ export class ChatFX {
         return await this.findChat(id);
     }
     async ensureChatRoom(opts) {
-        const out = await this.chat.ensureChatRoom(opts);
+        const members = normalizeIDs(opts.members);
+        if (!members.length)
+            throw errRequired({
+                field: "members",
+                msg: msgParticipantMissing,
+            });
+        const users = await Promise.all(members.map(async (id) => {
+            const user = (await this.users.findOneUser({ id })).value;
+            return user?.id === id ? user : undefined;
+        }));
+        if (users.some((user) => !isFabriktorUser(user))) {
+            throw errValidation({
+                msg: msgChatRecipients,
+            });
+        }
+        const out = await this.chat.ensureChatRoom({ ...opts, members });
         return requiredOperationID(out, msgEnsuredChatRoomIDMissing);
     }
     async markChatObjectsUploaded(opts) {
@@ -456,6 +473,7 @@ export class ChatFX {
             id: user.id,
             full_name: user.full_name,
             username: user.username,
+            account_identity: user.account_identity,
         };
     }
     async findChat(id, signal) {

package/dist/src/routes/availability.d.ts

@@ -14,6 +14,7 @@ export type AvailabilityReference = Pick<InClientAvailability, "employer_id" | "
 export type AvailabilityContext = {
     location: Location;
     employer: User;
+    client: User;
     company: PrefCompany;
     timezone: string;
 };

package/dist/src/routes/availability.js

@@ -1,4 +1,5 @@
 import { UserTypeClient, UserTypeEmployer, } from "@fabriktor/schema";
+import { isFabriktorUser } from "../users/users.js";
 import { addressTimezone } from "../core/address.js";
 import { hoursPerDay, minutesOfDay, minutesPerHour, sameCalendarDay, } from "../core/date.js";
 import { errValidation } from "../core/err.js";
@@ -15,6 +16,7 @@ const msgAvailabilityAccess = "This availability does not match the client and e
 const msgAvailabilityTimezone = "The location needs a valid saved address timezone.";
 const msgAvailabilityHours = "The employer's working hours must form a valid same-day window.";
 const msgAvailabilityWindows = "Provide enough distinct, non-overlapping availability windows within the employer's working hours.";
+const msgAvailabilityClient = "Visit times can only be requested from clients with a Fabriktor account. Arrange external contacts’ visit times directly.";
 const msgAvailabilityData = "The availability request is invalid.";
 export function availabilityReference(data) {
     if (data.type !== RoutesChatDataType.AvailabilityRequest &&
@@ -74,8 +76,9 @@ export async function loadAvailabilityContext(readers, actor, reference, signal)
             ? actor.owner_id !== reference.client_id
             : !routeCanPlan(actor) || actor.owner_id !== reference.employer_id))
         throw errValidation({ msg: msgAvailabilityAccess });
-    const [result, company] = await Promise.all([
+    const [result, clientResult, company] = await Promise.all([
         readers.users.findOneUser({ id: reference.employer_id, signal }),
+        readers.users.findOneUser({ id: reference.client_id, signal }),
         readers.preferences.getPrefCompany({ owner_id: reference.employer_id }),
     ]);
     const employer = result.value;
@@ -83,6 +86,11 @@ export async function loadAvailabilityContext(readers, actor, reference, signal)
         employer.id !== reference.employer_id ||
         employer.account_identity !== UserTypeEmployer)
         throw errValidation({ msg: msgAvailabilityAccess });
+    const client = clientResult.value;
+    if (!client || client.id !== reference.client_id || !isFabriktorUser(client))
+        throw errValidation({
+            msg: msgAvailabilityClient,
+        });
     const timezone = addressTimezone(location);
     if (!timezone)
         throw errValidation({ msg: msgAvailabilityTimezone });
@@ -90,7 +98,7 @@ export async function loadAvailabilityContext(readers, actor, reference, signal)
     if (![start, end].every((hour) => Number.isInteger(hour) && hour >= 0 && hour < hoursPerDay) ||
         start >= end)
         throw errValidation({ msg: msgAvailabilityHours });
-    return { location, employer, company, timezone };
+    return { location, employer, client, company, timezone };
 }
 export function validateAvailabilityWindows(inputs, context, minimum = clientAvailabilityMinimumWindows) {
     if (inputs.length < minimum)

package/dist/src/routes/workspace.d.ts

@@ -26,6 +26,7 @@ export type RoutesReadOptions = {
     actor: RoutesActor;
     employer_id?: string;
     day?: InDate;
+    start_place_id?: Route["start_place_id"];
     employee_ids?: string[];
     client_ids?: string[];
     signal?: AbortSignal;

package/dist/src/routes/workspace.js

@@ -91,6 +91,7 @@ export class RoutesWorkspace {
         const query = {
             ...queryParams({
                 owner_id,
+                start_place_id: opts.start_place_id?.trim() || undefined,
                 // A day filter refers to the calendar day stored on each route.
                 // Employers may operate depots in different timezones.
                 utilized_employee_ids: actor.active_mode === UserTypeEmployee

package/dist/src/users/users.d.ts

@@ -10,6 +10,13 @@ export type ExternalUserInput = Omit<InUser, "account_identity" | "active_mode"
 export type CreateExternalUserOptions = {
     in: ExternalUserInput;
 };
+export type UpdateExternalUserOptions = {
+    id: string;
+    owner_id: string;
+    in: ExternalUserInput;
+};
+export declare function isFabriktorUser(user: Pick<User, "account_identity"> | null | undefined): boolean;
+export declare function canManageExternalUser(user: User | null | undefined, owner_id: string): boolean;
 export type SearchExternalUsersOptions = SearchUsersOptions;
 export type SearchExternalUsersPage = SearchUsersPage;
 export type UserProfileInput = Pick<InUser, "first_name" | "last_name" | "phone" | "company_name" | "privacy"> & InAddress;
@@ -43,6 +50,7 @@ export type UsersFXOptions = {
 export interface UsersFXOperator {
     searchUsers(opts: SearchUsersOptions): Promise<SearchUsersPage>;
     createExternalUser(opts: CreateExternalUserOptions): Promise<User>;
+    updateExternalUser(opts: UpdateExternalUserOptions): Promise<User>;
     searchExternalUsers(opts: SearchExternalUsersOptions): Promise<SearchExternalUsersPage>;
     updateUserProfile(opts: UpdateUserProfileOptions): Promise<User>;
     updateUserPhone(opts: UpdateUserPhoneOptions): Promise<User>;
@@ -61,6 +69,7 @@ export declare class UsersFX implements UsersFXOperator {
     constructor(opts: UsersFXOptions);
     searchUsers(opts: SearchUsersOptions): Promise<SearchUsersPage>;
     createExternalUser(opts: CreateExternalUserOptions): Promise<User>;
+    updateExternalUser(opts: UpdateExternalUserOptions): Promise<User>;
     searchExternalUsers(opts: SearchExternalUsersOptions): Promise<SearchExternalUsersPage>;
     updateUserProfile(opts: UpdateUserProfileOptions): Promise<User>;
     updateUserPhone(opts: UpdateUserPhoneOptions): Promise<User>;

package/dist/src/users/users.js

@@ -5,7 +5,7 @@
 // a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
 import { UserTypeClient, UserTypeEmployee, UserTypeEmployer, UserTypeExternal, } from "@fabriktor/schema";
 import { errRequired, errResolveFailed, errValidation, } from "../core/err.js";
-import { requiredOperationID } from "../core/id.js";
+import { requiredOperationID, resolvedID } from "../core/id.js";
 import { runSearch, } from "../core/search.js";
 import { normalizePhone, normalizePhoneCode, validatePhone, validatePhoneCode, } from "./phone.js";
 import { normalizeEmail, isValidEmail } from "./email.js";
@@ -20,12 +20,24 @@ const msgEmailInvalid = "Email address is invalid.";
 const msgAddressRequired = "A complete address is required.";
 const msgUserMissingAfterUpdate = "User could not be resolved after the account update.";
 const msgCreatedExternalUserIDMissing = "Created external user response did not contain an ID.";
+const msgExternalUserAccess = "Only the owner can edit an external contact.";
 const msgExternalUserMissing = "External user could not be resolved after creation.";
 const msgInvalidActiveMode = "Active mode is not available for this account identity.";
 const msgWorkIdentityRequiresClient = "A work identity can only be established from a client account.";
 const msgInvalidWorkIdentity = "Work identity must be employee or employer.";
 const resourceUsername = "username";
 const resourceUser = "user";
+// External records are private contacts, not messaging accounts.
+export function isFabriktorUser(user) {
+    return (user?.account_identity === UserTypeClient ||
+        user?.account_identity === UserTypeEmployee ||
+        user?.account_identity === UserTypeEmployer);
+}
+export function canManageExternalUser(user, owner_id) {
+    return (!!resolvedID(owner_id) &&
+        user?.account_identity === UserTypeExternal &&
+        user.external_owner_id === owner_id);
+}
 export class UsersFX {
     users;
     tmp_usernames;
@@ -62,6 +74,38 @@ export class UsersFX {
         const id = requiredOperationID(out, msgCreatedExternalUserIDMissing);
         return await this.findExternalUser(id);
     }
+    async updateExternalUser(opts) {
+        const current = await this.findExternalUser(opts.id);
+        if (!canManageExternalUser(current, opts.owner_id)) {
+            throw errValidation({
+                msg: msgExternalUserAccess,
+            });
+        }
+        const input = normalizeExternalUserInput(opts.in);
+        validateExternalUserInput(input);
+        // Only editable contact fields; preserve identity, privacy and account metadata.
+        await this.users.replaceOneUser({
+            id: current.id,
+            in: {
+                first_name: input.first_name,
+                last_name: input.last_name,
+                email: input.email,
+                phone: input.phone,
+                company_name: input.company_name,
+                lat: input.lat,
+                lon: input.lon,
+                street: input.street,
+                city: input.city,
+                state: input.state,
+                postal_code: input.postal_code,
+                country: input.country,
+                formatted_address: input.formatted_address,
+                place_name: input.place_name,
+                place_id: input.place_id,
+            },
+        });
+        return await this.findExternalUser(current.id);
+    }
     async searchExternalUsers(opts) {
         const { uid, ...searchOpts } = opts;
         return await runSearch({
@@ -181,7 +225,7 @@ export class UsersFX {
     async findExternalUser(id) {
         const out = await this.users.findOneUser({ id });
         const user = out.value;
-        if (user === undefined) {
+        if (!user || user.id !== id || user.account_identity !== UserTypeExternal) {
             throw errResolveFailed({
                 resource: resourceUser,
                 msg: msgExternalUserMissing,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabriktor/fx",
-  "version": "0.0.143",
+  "version": "0.0.145",
   "description": "![Fabriktor Logo](./img/fabriktor-character.gif)",
   "type": "module",
   "exports": {