Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
import { fireAndForget } from '@core/util/fireAndForget';
import {
useAddEntityPropertyMutation,
useDeleteEntityPropertyMutation,
useEntityPropertiesQuery,
} from '@queries/properties/entity';
import type { EntityType } from '@service-properties/generated/schemas/entityType';
import type { Accessor } from 'solid-js';
import type { Property } from '../types';
import { ERROR_MESSAGES } from '../utils/errorHandling';
/**
* Main hook for fetching and managing properties for an entity
*
* This hook focuses purely on data management and returns structured results.
* UI feedback (toasts, notifications) is handled by mutations.
* Refetch returns its completion promise; ignored refresh failures remain reported.
*
* @param entityId - The ID of the entity to fetch properties for
* @param entityType - The type of entity (e.g., 'document', 'channel', 'project')
* @param includeMetadata - Whether to include metadata properties
*/
export function useEntityProperties(
entityId: string,
entityType: EntityType,
includeMetadata: boolean
): {
properties: Accessor<Property[]>;
isLoading: Accessor<boolean>;
error: Accessor<string | null>;
refetch: () => Promise<unknown>;
addProperty: (propertyDefinitionId: string) => Promise<void>;
removeProperty: (propertyId: string) => Promise<void>;
} {
const query = useEntityPropertiesQuery(
() => entityType,
() => entityId,
includeMetadata
);
const addMutation = useAddEntityPropertyMutation();
const deleteMutation = useDeleteEntityPropertyMutation();
return {
properties: () => query.data ?? [],
isLoading: () => query.isLoading,
error: () => (query.error ? ERROR_MESSAGES.PROPERTY_FETCH : null),
refetch: () => {
const refresh = query.refetch();
fireAndForget(refresh, 'entity-properties');
return refresh;
},
addProperty: (propertyDefinitionId: string) =>
addMutation.mutateAsync({ entityId, entityType, propertyDefinitionId }),
removeProperty: (propertyId: string) =>
deleteMutation.mutateAsync({
entityPropertyId: propertyId,
entityType,
entityId,
}),
};
}