✨ NEW: global stores - no query stores by default

.changeset/poor-hats-notice.md

@@ -0,0 +1,5 @@
+---
+'houdini-plugin-svelte-global-stores': major
+---
+
+by default global stores of type 'query' will not be generated. You have to opt-in to generate them in houdini.config.js

e2e/sveltekit/houdini.config.js

@@ -22,7 +22,9 @@ const config = {
     }
   },
   plugins: {
-    'houdini-plugin-svelte-global-stores': {},
+    'houdini-plugin-svelte-global-stores': {
+      generate: ['query', 'mutation', 'subscription', 'fragment']
+    },
     'houdini-svelte': {}
   }
 };

e2e/sveltekit/src/routes/pagination/fragment/bidirectional-cursor/+page.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { CachePolicy, paginatedFragment, graphql } from '$houdini';
+  import { CachePolicy, graphql, paginatedFragment } from '$houdini';
 
   const queryResult = graphql(`
     query UserFragmentBidirectionalCursorQuery @load {
@@ -10,6 +10,7 @@
   `);
 
   const fragmentResult = paginatedFragment(
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
     $queryResult.data!.user!,
     graphql(`
       fragment BidirectionalCursorFragment on User {

e2e/sveltekit/src/routes/pagination/fragment/bidirectional-cursor/spec.ts

@@ -1,10 +1,9 @@
-import { expect, test } from '@playwright/test';
+import { test } from '@playwright/test';
 import { routes } from '../../../../lib/utils/routes.js';
 import {
-  expect_1_gql,
-  expect_0_gql,
   expectToBe,
   expectToContain,
+  expect_1_gql,
   goto
 } from '../../../../lib/utils/testsHelper.js';
 

e2e/sveltekit/src/routes/pagination/query/bidirectional-cursor/spec.ts

@@ -1,10 +1,9 @@
-import { expect, test } from '@playwright/test';
+import { test } from '@playwright/test';
 import { routes } from '../../../../lib/utils/routes.js';
 import {
-  expect_1_gql,
-  expect_0_gql,
   expectToBe,
   expectToContain,
+  expect_1_gql,
   goto
 } from '../../../../lib/utils/testsHelper.js';
 

e2e/sveltekit/src/routes/stores/ssr-[userId]/spec.ts

@@ -59,9 +59,7 @@ test.describe('SSR-[userId] Page', () => {
 
     // 4 Check id 77 (that doens't exist)
     response = await expect_1_gql(page, `button[id="refresh-77"]`);
-    expect(response).toBe(
-      '{"data":null,"errors":[{"message":"User not found","locations":[{"line":2,"column":3}],"path":["user"]}]}'
-    );
+    expect(response).toBe('{"data":null,"errors":[{"message":"User not found","path":["user"]}]}');
   });
 
   test('Check that variables order doesnt matter', async ({ page }) => {

packages/houdini-plugin-svelte-global-stores/README.md

@@ -43,7 +43,8 @@ const config = {
 
   plugins: {
     'houdini-plugin-svelte-global-stores': {
-      prefix: 'G_'
+      prefix: 'GQL_',
+      generate: ['mutation', 'subscription', 'fragment']
     },
     'houdini-svelte': {}
   }
@@ -54,8 +55,9 @@ export default config;
 
 ```
 
-One configuration option is available:
+The following configuration options are available:
 - `prefix` (optional, default: `GQL_`): The default prefix of your global stores. This lets your editor provide autocompletion with just a few characters.
+- `generate` (optional, default: `['mutation', 'subscription', 'fragment']`). Note that by default, 'Query' is omitted on purpose. You can also pass `"all"` to generate all stores.
 
 
 ## Usage

packages/houdini-plugin-svelte-global-stores/src/plugin/codegen/stores/fragment.test.ts

@@ -56,3 +56,29 @@ test('global fragment type', async function () {
 	`
 	)
 })
+
+test('no fragment', async function () {
+	const docs = [`fragment TestFragment1 on User { id }`, `fragment TestFragment2 on User { id }`]
+
+	const { pluginRoot } = await pipeline_test(docs, {
+		plugins: {
+			'houdini-svelte': {},
+			'houdini-plugin-svelte-global-stores': {
+				prefix: '',
+				generate: [],
+			},
+		},
+	})
+
+	const contents = await fs.readFile(
+		path.join(global_stores_directory(pluginRoot), 'TestFragment1.js')
+	)
+
+	// parse the contents
+	const parsed = recast.parse(contents!, {
+		parser: typeScriptParser,
+	}).program
+
+	// check the file contents
+	expect(parsed).toMatchInlineSnapshot('null')
+})

packages/houdini-plugin-svelte-global-stores/src/plugin/codegen/stores/index.ts

@@ -1,14 +1,39 @@
 import type { GenerateHookInput } from 'houdini'
-import { cleanupFiles, fs, ArtifactKind, path } from 'houdini'
+import { ArtifactKind, cleanupFiles, fs, path } from 'houdini'
 
-import { global_stores_directory } from '../../kit'
+import { global_stores_directory, plugin_config } from '../../kit'
 import { fragmentStore } from './fragment'
 import { mutationStore } from './mutation'
 import { queryStore } from './query'
 import { subscriptionStore } from './subscription'
 
+const is_store_needed = (
+	kindExpected: ArtifactKind,
+	kindDocument: ArtifactKind,
+	generate: ('query' | 'mutation' | 'subscription' | 'fragment')[] | 'all'
+) => {
+	if (kindExpected === kindDocument) {
+		// build association between ArtifactKind and Literal
+		const kindLiteral: Record<
+			ArtifactKind,
+			'query' | 'mutation' | 'subscription' | 'fragment'
+		> = {
+			HoudiniQuery: 'query',
+			HoudiniMutation: 'mutation',
+			HoudiniSubscription: 'subscription',
+			HoudiniFragment: 'fragment',
+		}
+
+		if (generate === 'all' || generate.includes(kindLiteral[kindExpected])) {
+			return true
+		}
+	}
+	return false
+}
+
 export default async function storesGenerator(input: GenerateHookInput) {
-	const { documents } = input
+	const { documents, config } = input
+	const generate = plugin_config(config).generate
 
 	const listOfStores: (string | null)[] = []
 
@@ -19,13 +44,13 @@ export default async function storesGenerator(input: GenerateHookInput) {
 				return
 			}
 
-			if (doc.kind === ArtifactKind.Query) {
+			if (is_store_needed(ArtifactKind.Query, doc.kind, generate)) {
 				listOfStores.push(await queryStore(input, doc))
-			} else if (doc.kind === ArtifactKind.Mutation) {
+			} else if (is_store_needed(ArtifactKind.Mutation, doc.kind, generate)) {
 				listOfStores.push(await mutationStore(input, doc))
-			} else if (doc.kind === ArtifactKind.Subscription) {
+			} else if (is_store_needed(ArtifactKind.Subscription, doc.kind, generate)) {
 				listOfStores.push(await subscriptionStore(input, doc))
-			} else if (doc.kind === ArtifactKind.Fragment) {
+			} else if (is_store_needed(ArtifactKind.Fragment, doc.kind, generate)) {
 				listOfStores.push(await fragmentStore(input, doc))
 			}
 		})

packages/houdini-plugin-svelte-global-stores/src/plugin/codegen/stores/mutation.test.ts

@@ -37,3 +37,32 @@ test('generates a store for every mutation', async function () {
 	`
 	)
 })
+
+test('no mutation', async function () {
+	const docs = [
+		`mutation TestMutation1 { updateUser { id }  }`,
+		`mutation TestMutation2 { updateUser { id }  }`,
+	]
+
+	const { pluginRoot } = await pipeline_test(docs, {
+		plugins: {
+			'houdini-svelte': {},
+			'houdini-plugin-svelte-global-stores': {
+				prefix: '',
+				generate: [],
+			},
+		},
+	})
+
+	const contents = await fs.readFile(
+		path.join(global_stores_directory(pluginRoot), 'TestMutation1.js')
+	)
+
+	// parse the contents
+	const parsed = recast.parse(contents!, {
+		parser: typeScriptParser,
+	}).program
+
+	// check the file contents
+	expect(parsed).toMatchInlineSnapshot('null')
+})

packages/houdini-plugin-svelte-global-stores/src/plugin/codegen/stores/query.test.ts

@@ -14,6 +14,7 @@ test('change prefix to "yop___"', async function () {
 			'houdini-svelte': {},
 			'houdini-plugin-svelte-global-stores': {
 				prefix: 'yop___',
+				generate: ['query'],
 			},
 		},
 	})
@@ -43,6 +44,62 @@ test('change prefix to ""', async function () {
 			'houdini-svelte': {},
 			'houdini-plugin-svelte-global-stores': {
 				prefix: '',
+				generate: ['query'],
+			},
+		},
+	})
+
+	const contents = await fs.readFile(
+		path.join(global_stores_directory(pluginRoot), 'TestQuery.js')
+	)
+
+	// parse the contents
+	const parsed = recast.parse(contents!, {
+		parser: typeScriptParser,
+	}).program
+
+	// check the file contents
+	expect(parsed).toMatchInlineSnapshot(`
+		import { TestQueryStore } from '../../houdini-svelte/stores'
+
+		export const TestQuery = new TestQueryStore()
+	`)
+})
+
+test('no query', async function () {
+	const docs = [`query TestQuery { version }`]
+
+	const { pluginRoot } = await pipeline_test(docs, {
+		plugins: {
+			'houdini-svelte': {},
+			'houdini-plugin-svelte-global-stores': {
+				prefix: '',
+			},
+		},
+	})
+
+	const contents = await fs.readFile(
+		path.join(global_stores_directory(pluginRoot), 'TestQuery.js')
+	)
+
+	// parse the contents
+	const parsed = recast.parse(contents!, {
+		parser: typeScriptParser,
+	}).program
+
+	// check the file contents
+	expect(parsed).toMatchInlineSnapshot('null')
+})
+
+test('all', async function () {
+	const docs = [`query TestQuery { version }`]
+
+	const { pluginRoot } = await pipeline_test(docs, {
+		plugins: {
+			'houdini-svelte': {},
+			'houdini-plugin-svelte-global-stores': {
+				prefix: '',
+				generate: 'all',
 			},
 		},
 	})

packages/houdini-plugin-svelte-global-stores/src/plugin/codegen/stores/subscription.test.ts

@@ -39,3 +39,32 @@ test('generates a store for every subscription', async function () {
 	`
 	)
 })
+
+test('no subscription', async function () {
+	const docs = [
+		`subscription TestSubscription1 { newUser { user { id } }  }`,
+		`subscription TestSubscription2 { newUser { user { id } }  }`,
+	]
+
+	const { pluginRoot } = await pipeline_test(docs, {
+		plugins: {
+			'houdini-svelte': {},
+			'houdini-plugin-svelte-global-stores': {
+				prefix: '',
+				generate: [],
+			},
+		},
+	})
+
+	const contents = await fs.readFile(
+		path.join(global_stores_directory(pluginRoot), 'TestSubscription1.js')
+	)
+
+	// parse the contents
+	const parsed = recast.parse(contents!, {
+		parser: typeScriptParser,
+	}).program
+
+	// check the file contents
+	expect(parsed).toMatchInlineSnapshot('null')
+})

packages/houdini-plugin-svelte-global-stores/src/plugin/index.ts

@@ -65,4 +65,12 @@ export type HoudiniPluginSvelteGlobalStoresConfig = {
 	 * @default GQL_
 	 */
 	prefix?: string
+
+	/**
+	 * Types of stores to generate.
+	 *
+	 * _Note: by default, 'query' is omitted on purpose._
+	 * @default ['mutation', 'subscription', 'fragment']
+	 */
+	generate?: ('query' | 'mutation' | 'subscription' | 'fragment')[] | 'all'
 }

packages/houdini-plugin-svelte-global-stores/src/plugin/kit.ts

@@ -23,6 +23,7 @@ export function plugin_config(config: Config): Required<HoudiniPluginSvelteGloba
 
 	return {
 		prefix: 'GQL_',
+		generate: ['mutation', 'subscription', 'fragment'],
 		...cfg,
 	}
 }

packages/houdini/src/codegen/index.ts

@@ -117,7 +117,6 @@ export async function runPipeline(config: Config, docs: Document[]) {
 			docs
 		)
 	} catch (e) {
-		console.log(e)
 		error = e as Error
 	}