lightsoutAlpha

file-naming-for-server-functions

a server function file that does not carry its mandated casing

Agent checkadvisory by defaulttanstackcode

The argument

File Naming for Server Functions

The filename-match rule applied to server-function exports — a file is named for what it exports, in that export's own casing. The table is derived, not a separate law:

File holdsSo its name isExample
A server function (camelCase export ending ServerFn)camelCase.ts ending ServerFnserverFns/countIssuesServerFn.ts
A graduated server function's folderthat function's camelCase/findIssues/
A GraphQL document (PascalCase named constant)PascalCase.tsfindIssues/FindIssuesDocument.ts
A query-options factory (camelCase export)camelCase.tsqueries/issuesQueryOptions.ts

The ServerFn suffix is this pack's convention for making a server call recognizable at the import site — TanStack requires no naming.

The proof

fail
// Kebab-case throughout: the folder should be camelCase and the document
// PascalCase, so nothing in the tree says which file is which kind.
export const CountIssuesDocument = 'query CountIssues { issues { totalCount } }';
pass
export const CountIssuesDocument = 'query CountIssues { issues { totalCount } }';

Turn it down

Both lines go in your lightsout.config.json.

"standards-checks": { "file-naming-for-server-functions": "advisory" }
"standards-checks": { "file-naming-for-server-functions": "off" }