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 { createRoot, createSignal } from 'solid-js';
import { beforeEach, describe, expect, it, vi } from 'vitest';
import type { PreviewItem } from '../types';
const useQueryMock = vi.hoisted(() => vi.fn());
const useQueryOptions = vi.hoisted(() => [] as Array<() => unknown>);
const getQueryDataMock = vi.hoisted(() => vi.fn());
const setQueryDataMock = vi.hoisted(() => vi.fn());
const invalidateQueriesMock = vi.hoisted(() => vi.fn());
const canWriteGraphqlPreviewCacheMock = vi.hoisted(() => vi.fn());
const createGraphqlItemPreviewQueryMock = vi.hoisted(() => vi.fn());
const setGraphqlPreviewFileTypeMock = vi.hoisted(() => vi.fn());
const setGraphqlPreviewNameMock = vi.hoisted(() => vi.fn());
const setGraphqlPreviewOnCreateMock = vi.hoisted(() => vi.fn());
vi.mock('@app/lib/analytics/posthog', () => ({
useFeatureFlag: () => () => ({ enabled: true, loading: false }),
}));
vi.mock('@core/constant/featureFlags', async (importOriginal) => ({
...(await importOriginal<typeof import('@core/constant/featureFlags')>()),
enableGraphqlSoup: { key: 'enable-graphql-soup' },
isFeatureEnabled: () => true,
LOCAL_ONLY: false,
}));
vi.mock('@tanstack/solid-query', () => ({
useQuery: useQueryMock,
}));
vi.mock('../../client', () => ({
queryClient: {
fetchQuery: vi.fn(),
getQueryData: getQueryDataMock,
invalidateQueries: invalidateQueriesMock,
setQueryData: setQueryDataMock,
},
}));
vi.mock('../dataloader', () => ({
previewDataLoader: { load: vi.fn() },
}));
vi.mock('../fetchers', () => ({
defaultNameTransform: (value: unknown) => value,
fetchMessageContext: vi.fn(),
fetchRestPreviewBatch: vi.fn(),
}));
vi.mock('../graphql', () => ({
canWriteGraphqlPreviewCache: canWriteGraphqlPreviewCacheMock,
createGraphqlItemPreviewQuery: createGraphqlItemPreviewQueryMock,
getGraphqlItemPreview: vi.fn(),
isGraphqlPreviewItem: () => true,
setGraphqlPreviewFileType: setGraphqlPreviewFileTypeMock,
setGraphqlPreviewName: setGraphqlPreviewNameMock,
setGraphqlPreviewOnCreate: setGraphqlPreviewOnCreateMock,
}));
const {
invalidatePreview,
setPreviewFileType,
setPreviewName,
setPreviewOnCreate,
useItemPreview,
useItemRawName,
} = await import('../preview');
const preview = {
id: 'doc-1',
type: 'document',
access: 'access',
loading: false,
rawName: 'Document',
name: 'Document',
} as const;
describe('preview transport facade', () => {
beforeEach(() => {
vi.clearAllMocks();
useQueryOptions.length = 0;
canWriteGraphqlPreviewCacheMock.mockReturnValue(true);
useQueryMock.mockImplementation((options: () => unknown) => {
useQueryOptions.push(options);
return { isLoading: false, isPending: false, isSuccess: false };
});
getQueryDataMock.mockReturnValue({ id: 'user-1' });
invalidateQueriesMock.mockResolvedValue(undefined);
setGraphqlPreviewFileTypeMock.mockResolvedValue(undefined);
setGraphqlPreviewNameMock.mockResolvedValue(undefined);
setGraphqlPreviewOnCreateMock.mockResolvedValue(undefined);
createGraphqlItemPreviewQueryMock.mockReturnValue({
data: () => preview,
error: () => null,
isLoading: () => false,
isFetching: () => false,
isEnabled: () => true,
shouldFallback: () => false,
refetch: vi.fn(),
});
});
it('uses urql-solid data without building the regular queries', () => {
createRoot((dispose) => {
const [item] = useItemPreview(() => ({
id: 'doc-1',
type: 'document',
}));
expect(item()).toEqual(preview);
expect(useQueryOptions).toHaveLength(0);
dispose();
});
});
it('builds the regular query once the GraphQL preview falls back', () => {
createRoot((dispose) => {
const [fallback, setFallback] = createSignal(false);
createGraphqlItemPreviewQueryMock.mockReturnValue({
data: () => undefined,
shouldFallback: fallback,
refetch: vi.fn(),
});
useItemPreview(() => ({ id: 'doc-1', type: 'document' }));
expect(useQueryOptions).toHaveLength(0);
setFallback(true);
expect(useQueryOptions).toHaveLength(1);
expect(useQueryOptions[0]?.()).toMatchObject({ enabled: true });
dispose();
});
});
it('keeps pending GraphQL metadata distinct from REST and loaded-empty properties', () => {
createRoot((dispose) => {
const [data, setData] = createSignal<PreviewItem>(preview);
const [fallback, setFallback] = createSignal(false);
createGraphqlItemPreviewQueryMock.mockReturnValue({
data,
shouldFallback: fallback,
refetch: vi.fn(),
});
const [, controls] = useItemPreview(() => ({
id: 'doc-1',
type: 'document',
}));
expect(controls.documentProperties()).toMatchObject({
properties: undefined,
canEdit: false,
});
setData({
...preview,
documentMetadata: { properties: [], canEdit: true },
});
expect(controls.documentProperties()).toMatchObject({
properties: [],
canEdit: true,
});
setFallback(true);
expect(controls.documentProperties()).toBeUndefined();
dispose();
});
});
it('keeps raw-name reads on the lightweight selection', () => {
createRoot((dispose) => {
const name = useItemRawName(() => ({ id: 'doc-1', type: 'document' }));
expect(name()).toBe('Document');
expect(createGraphqlItemPreviewQueryMock).toHaveBeenCalledWith(
expect.any(Function),
expect.any(Function),
false
);
dispose();
});
});
it('derives the pending preview from urql-solid loading state', () => {
createGraphqlItemPreviewQueryMock.mockReturnValue({
data: () => undefined,
error: () => null,
isLoading: () => true,
isFetching: () => true,
isEnabled: () => true,
shouldFallback: () => false,
refetch: vi.fn(),
});
createRoot((dispose) => {
const [item] = useItemPreview(() => ({
id: 'doc-1',
type: 'document',
}));
expect(item()).toEqual({
id: 'doc-1',
type: 'document',
loading: true,
});
dispose();
});
});
it('stays loading while a GraphQL miss starts its REST fallback', () => {
createGraphqlItemPreviewQueryMock.mockReturnValue({
data: () => undefined,
error: () => null,
isLoading: () => false,
isFetching: () => false,
isEnabled: () => true,
shouldFallback: () => true,
refetch: vi.fn(),
});
useQueryMock.mockImplementation((options: () => unknown) => {
useQueryOptions.push(options);
return { isLoading: false, isPending: true, isSuccess: false };
});
createRoot((dispose) => {
const [item] = useItemPreview(() => ({
id: 'doc-1',
type: 'document',
}));
expect(item()).toEqual({
id: 'doc-1',
type: 'document',
loading: true,
});
dispose();
});
});
it('does not turn a failed REST fallback into a permission result', () => {
createGraphqlItemPreviewQueryMock.mockReturnValue({
data: () => undefined,
error: () => null,
isLoading: () => false,
isFetching: () => false,
isEnabled: () => true,
shouldFallback: () => true,
refetch: vi.fn(),
});
useQueryMock.mockImplementation((options: () => unknown) => {
useQueryOptions.push(options);
return {
data: undefined,
isLoading: false,
isPending: false,
isSuccess: false,
isError: true,
};
});
createRoot((dispose) => {
const [item] = useItemPreview(() => ({
id: 'doc-1',
type: 'document',
}));
expect(item()).toEqual({
id: 'doc-1',
type: 'document',
loading: true,
});
dispose();
});
});
it('seeds REST when the normalized GraphQL cache host is unavailable', () => {
canWriteGraphqlPreviewCacheMock.mockReturnValue(false);
setPreviewOnCreate({
itemId: 'doc-2',
itemType: 'document',
name: 'Created',
fileType: 'md',
});
expect(setGraphqlPreviewOnCreateMock).not.toHaveBeenCalled();
expect(setQueryDataMock).toHaveBeenCalledOnce();
const updater = setQueryDataMock.mock.calls[0]?.[1];
expect(updater(undefined)).toMatchObject({
id: 'doc-2',
type: 'document',
access: 'access',
rawName: 'Created',
fileType: 'md',
});
});
it('keeps GraphQL writes out of the TanStack preview cache', () => {
setPreviewFileType('doc-1', 'pdf');
setPreviewName({
itemId: 'doc-1',
itemType: 'document',
name: 'Renamed',
});
setPreviewOnCreate({
itemId: 'doc-2',
itemType: 'document',
name: 'Created',
fileType: 'md',
});
expect(setGraphqlPreviewFileTypeMock).toHaveBeenCalledWith(
'doc-1',
'pdf',
'user-1'
);
expect(setGraphqlPreviewNameMock).toHaveBeenCalledWith(
{ id: 'doc-1', type: 'document' },
'Renamed',
'user-1'
);
expect(setGraphqlPreviewOnCreateMock).toHaveBeenCalledWith(
{
itemId: 'doc-2',
itemType: 'document',
name: 'Created',
fileType: 'md',
subType: undefined,
},
'user-1'
);
expect(setQueryDataMock).not.toHaveBeenCalled();
});
it('invalidates only active REST fallbacks under the GraphQL flag', async () => {
await invalidatePreview('doc-1');
const options = invalidateQueriesMock.mock.calls[0]?.[0];
expect(options.queryKey).toContain('doc-1');
expect(options.predicate({ isActive: () => false })).toBe(false);
expect(options.predicate({ isActive: () => true })).toBe(true);
});
});