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 type {
Property,
PropertyApiValues,
PropertyDefinitionDomain,
} from '@property/types';
import { describe, expect, it } from 'vitest';
import {
apiValuesToGraphqlPropertyValue,
buildOptimisticEntityPropertyOptions,
buildOptimisticSetEntityProperty,
} from './graphql-optimistic';
describe('apiValuesToGraphqlPropertyValue', () => {
it('converts each populated variant', () => {
expect(
apiValuesToGraphqlPropertyValue({ valueType: 'STRING', value: 'hi' })
).toEqual({
__typename: 'GraphqlStringPropertyValue',
stringValue: 'hi',
});
expect(
apiValuesToGraphqlPropertyValue({ valueType: 'NUMBER', value: 3 })
).toEqual({
__typename: 'GraphqlNumberPropertyValue',
numberValue: 3,
});
expect(
apiValuesToGraphqlPropertyValue({ valueType: 'BOOLEAN', value: false })
).toEqual({
__typename: 'GraphqlBooleanPropertyValue',
boolValue: false,
});
expect(
apiValuesToGraphqlPropertyValue({
valueType: 'DATE',
value: new Date('2026-07-10T00:00:00.000Z'),
})
).toEqual({
__typename: 'GraphqlDatePropertyValue',
dateValue: '2026-07-10T00:00:00.000Z',
});
expect(
apiValuesToGraphqlPropertyValue({
valueType: 'DATE_RANGE',
value: {
allDay: true,
start: new Date(2026, 6, 10),
end: new Date(2026, 6, 12),
},
})
).toEqual({
__typename: 'GraphqlDateRangePropertyValue',
rangeStart: '2026-07-10T00:00:00.000Z',
rangeEnd: '2026-07-12T00:00:00.000Z',
});
expect(
apiValuesToGraphqlPropertyValue({
valueType: 'DATE_RANGE',
value: {
allDay: false,
start: new Date('2026-07-10T13:00:00.000Z'),
end: new Date('2026-07-10T21:30:00.000Z'),
},
})
).toEqual({
__typename: 'GraphqlDateRangePropertyValue',
rangeStart: '2026-07-10T13:00:00.000Z',
rangeEnd: '2026-07-10T21:30:00.000Z',
});
// Single- and multi-select share the SelectOption shape.
expect(
apiValuesToGraphqlPropertyValue({
valueType: 'SELECT_STRING',
values: ['opt-1'],
})
).toEqual({
__typename: 'GraphqlSelectOptionPropertyValue',
optionIds: ['opt-1'],
});
expect(
apiValuesToGraphqlPropertyValue({
valueType: 'SELECT_NUMBER',
values: ['opt-1', 'opt-2'],
})
).toEqual({
__typename: 'GraphqlSelectOptionPropertyValue',
optionIds: ['opt-1', 'opt-2'],
});
expect(
apiValuesToGraphqlPropertyValue({
valueType: 'ENTITY',
refs: [
{
entity_id: 'doc-1',
entity_type: 'DOCUMENT',
specific_message_id: 'msg-1',
},
{ entity_id: 'user-1', entity_type: 'USER' },
],
})
).toEqual({
__typename: 'GraphqlEntityReferencePropertyValue',
references: [
{
entityId: 'doc-1',
entityType: 'DOCUMENT',
specificMessageId: 'msg-1',
},
{ entityId: 'user-1', entityType: 'USER', specificMessageId: null },
],
});
expect(
apiValuesToGraphqlPropertyValue({
valueType: 'LINK',
values: ['https://a'],
})
).toEqual({
__typename: 'GraphqlLinkPropertyValue',
urls: ['https://a'],
});
});
it('maps empty variants to null (clearing the value)', () => {
expect(
apiValuesToGraphqlPropertyValue({ valueType: 'STRING', value: null })
).toBeNull();
expect(
apiValuesToGraphqlPropertyValue({ valueType: 'DATE', value: null })
).toBeNull();
expect(
apiValuesToGraphqlPropertyValue({
valueType: 'SELECT_STRING',
values: [],
})
).toBeNull();
expect(
apiValuesToGraphqlPropertyValue({ valueType: 'ENTITY', refs: null })
).toBeNull();
expect(
apiValuesToGraphqlPropertyValue({ valueType: 'LINK', values: null })
).toBeNull();
});
});
describe('buildOptimisticEntityPropertyOptions', () => {
const definition: PropertyDefinitionDomain = {
id: 'tag-def',
displayName: 'Tags',
valueType: 'TAG',
isMultiSelect: true,
isMetadata: false,
isSystem: false,
owner: { scope: 'system' },
createdAt: '',
updatedAt: '',
};
it('uses a known assignment with the original tag definition metadata', () => {
expect(
buildOptimisticEntityPropertyOptions(definition, ['cool'], 'assignment-1')
).toMatchObject({
id: 'assignment-1',
propertyDefinitionId: 'tag-def',
dataType: 'TAG',
value: {
__typename: 'GraphqlSelectOptionPropertyValue',
optionIds: ['cool'],
},
});
});
it.each([
undefined,
'',
'tag-def',
'pending:tag-def',
'optimistic-property:DOCUMENT:doc:tag-def',
])('does not treat %s as a persisted assignment', (assignmentId) => {
expect(
buildOptimisticEntityPropertyOptions(definition, ['cool'], assignmentId)
).toBeUndefined();
});
it('gives first tag assignments the same target identity as full-value saves', () => {
const target = { entityType: 'DOCUMENT', entityId: 'doc-1' };
const expectedId = buildOptimisticSetEntityProperty(
definition,
{ valueType: 'SELECT_STRING', values: ['cool'] },
target
)?.id;
for (const assignmentId of [
undefined,
'tag-def',
'pending:tag-def',
expectedId,
]) {
expect(
buildOptimisticEntityPropertyOptions(
definition,
['cool'],
assignmentId,
target
)
).toMatchObject({
id: expectedId,
dataType: 'TAG',
value: { optionIds: ['cool'] },
});
}
expect(
buildOptimisticEntityPropertyOptions(definition, ['cool'], undefined, {
...target,
entityId: 'doc-2',
})?.id
).not.toBe(expectedId);
expect(
buildOptimisticEntityPropertyOptions(
definition,
[],
'assignment-1',
target
)
).toMatchObject({ id: 'assignment-1', value: null });
});
});
describe('buildOptimisticSetEntityProperty', () => {
const instantiated: Property = {
propertyId: 'prop-1',
propertyDefinitionId: 'def-1',
displayName: 'Status',
isMultiSelect: false,
isMetadata: false,
isSystemProperty: true,
owner: { scope: 'system' } as never,
specificEntityType: 'DOCUMENT',
createdAt: '' as never,
updatedAt: '' as never,
valueType: 'SELECT_STRING',
value: null,
};
const definitionOnly: PropertyDefinitionDomain = {
id: 'def-1',
displayName: 'Status',
valueType: 'SELECT_STRING',
isMultiSelect: false,
isMetadata: false,
isSystem: true,
owner: { scope: 'system' } as never,
createdAt: '' as never,
updatedAt: '' as never,
};
it('builds a complete payload for an existing assignment', () => {
const apiValues: PropertyApiValues = {
valueType: 'SELECT_STRING',
values: ['opt-done'],
};
expect(buildOptimisticSetEntityProperty(instantiated, apiValues)).toEqual({
id: 'prop-1',
propertyDefinitionId: 'def-1',
displayName: 'Status',
dataType: 'SELECT_STRING',
isMultiSelect: false,
specificEntityType: 'DOCUMENT',
isSystem: true,
isMetadata: false,
value: {
__typename: 'GraphqlSelectOptionPropertyValue',
optionIds: ['opt-done'],
},
});
});
it('scopes new assignments to their entity and preserves persisted assignment IDs', () => {
const value: PropertyApiValues = {
valueType: 'SELECT_STRING',
values: ['urgent'],
};
const target = { entityType: 'DOCUMENT', entityId: 'task-1' };
const first = buildOptimisticSetEntityProperty(
definitionOnly,
value,
target
)!;
const second = buildOptimisticSetEntityProperty(definitionOnly, value, {
...target,
entityId: 'task-2',
})!;
expect(first.id).not.toBe(second.id);
expect(first.id).not.toBe(definitionOnly.id);
expect(first.value).toEqual({
__typename: 'GraphqlSelectOptionPropertyValue',
optionIds: ['urgent'],
});
expect(
buildOptimisticSetEntityProperty(instantiated, value, target)?.id
).toBe('prop-1');
for (const propertyId of ['def-1', 'pending:def-1', first.id]) {
expect(
buildOptimisticSetEntityProperty(
{ ...instantiated, propertyId },
value,
target
)?.id
).toBe(first.id);
}
});
it('skips optimism for uninstantiated definitions without an owning target', () => {
expect(
buildOptimisticSetEntityProperty(definitionOnly, {
valueType: 'SELECT_STRING',
values: ['opt-done'],
})
).toBeUndefined();
});
});