domain-driver 0.3.1 → 0.4.1

package/dist/templates/frontend/query-hook.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderQueryHook = renderQueryHook;
+const actions_1 = require("../actions");
+const signatures_1 = require("../signatures");
+const query_keys_1 = require("./query-keys");
+function preamble(ctx, spec, entity, fromFile, imported) {
+    const servicePath = ctx.importLayer(fromFile, 'clientService', `${spec.name}.service`);
+    const keysPath = ctx.importLayer(fromFile, 'hook', `${ctx.feature}.keys`);
+    const domain = (0, signatures_1.domainImports)(ctx, fromFile, spec, entity);
+    return `import { ${imported} } from '@tanstack/react-query';
+${domain.join('\n')}${domain.length > 0 ? '\n' : ''}import { ${spec.name}Service } from '${servicePath}';
+import { ${(0, query_keys_1.keysConstant)(ctx.feature)} } from '${keysPath}';
+
+const service = new ${spec.name}Service();
+`;
+}
+/**
+ * A custom GET action (e.g. `FindActiveCats`) has `usesId: false`, just like List. Testing
+ * only `usesId` would give it the exact same key as List's `all` — one cache entry shared by
+ * two hooks, with whichever observer mounts last winning the `queryFn`. `spec.path === '/'`
+ * is what actually distinguishes List from a custom action, so it is the second branch.
+ * The `[...all, name]` spread (rather than a bare `[feature, name]`) is deliberate: TanStack
+ * Query invalidates by key prefix, so a Create mutation invalidating `keys.all` still
+ * invalidates this custom list for free.
+ */
+function queryKey(ctx, spec) {
+    const keys = (0, query_keys_1.keysConstant)(ctx.feature);
+    if (spec.usesId)
+        return `${keys}.detail(id)`;
+    if (spec.path === '/')
+        return `${keys}.all`;
+    return `[...${keys}.all, '${spec.name}']`;
+}
+function renderQuery(ctx, spec, entity, fromFile) {
+    return `${preamble(ctx, spec, entity, fromFile, 'useQuery')}
+export function use${spec.name}(${spec.params}) {
+  return useQuery({
+    queryKey: ${queryKey(ctx, spec)},
+    queryFn: (): ${spec.returns} => service.handle(${spec.args}),
+  });
+}
+`;
+}
+function mutationInput(spec) {
+    if (spec.usesId && spec.schema !== null) {
+        return {
+            signature: `({ id, data }: { id: string; data: ${spec.schema} })`,
+            call: 'id, data',
+            idFrom: '{ id }',
+        };
+    }
+    if (spec.usesId)
+        return { signature: '(id: string)', call: 'id', idFrom: 'id' };
+    if (spec.schema !== null)
+        return { signature: `(data: ${spec.schema})`, call: 'data', idFrom: null };
+    return { signature: '()', call: '', idFrom: null };
+}
+function renderMutation(ctx, spec, entity, fromFile) {
+    const keys = (0, query_keys_1.keysConstant)(ctx.feature);
+    const { signature, call, idFrom } = mutationInput(spec);
+    const args = idFrom === null ? '()' : `(_result, ${idFrom})`;
+    const detail = idFrom === null
+        ? ''
+        : `\n      void queryClient.invalidateQueries({ queryKey: ${keys}.detail(id) });`;
+    return `${preamble(ctx, spec, entity, fromFile, 'useMutation, useQueryClient')}
+export function use${spec.name}() {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: ${signature}: ${spec.returns} => service.handle(${call}),
+    onSuccess: ${args} => {
+      void queryClient.invalidateQueries({ queryKey: ${keys}.all });${detail}
+    },
+  });
+}
+`;
+}
+function renderQueryHook(ctx, spec, entity, fromFile) {
+    return (0, actions_1.isQueryAction)(spec)
+        ? renderQuery(ctx, spec, entity, fromFile)
+        : renderMutation(ctx, spec, entity, fromFile);
+}

package/dist/templates/frontend/query-keys.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.keysConstant = keysConstant;
+exports.renderQueryKeys = renderQueryKeys;
+const naming_1 = require("../../utils/naming");
+function keysConstant(feature) {
+    return `${(0, naming_1.lowerFirst)((0, naming_1.toPascalCase)(feature))}Keys`;
+}
+function renderQueryKeys(feature) {
+    return `export const ${keysConstant(feature)} = {
+  all: ['${feature}'] as const,
+  detail: (id: string) => ['${feature}', id] as const,
+};
+`;
+}

package/dist/templates/frontend/route.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderRoute = renderRoute;
+function renderRoute(ctx, entity, fromFile, withContainer) {
+    const head = `import { createFileRoute } from '@tanstack/react-router';`;
+    const routeBlock = `export const Route = createFileRoute('/${ctx.feature}/')({
+  component: ${entity}Page,
+});`;
+    if (!withContainer) {
+        return `${head}
+
+${routeBlock}
+
+function ${entity}Page() {
+  return (
+    <div>
+      <h1>${entity}</h1>
+    </div>
+  );
+}
+`;
+    }
+    const containerPath = ctx.importLayer(fromFile, 'container', `${entity}Container`);
+    return `${head}
+import ${entity}Container from '${containerPath}';
+
+${routeBlock}
+
+function ${entity}Page() {
+  return <${entity}Container />;
+}
+`;
+}

package/dist/templates/frontend/server-fn-repository.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderServerFnRepository = renderServerFnRepository;
+const naming_1 = require("../../utils/naming");
+const signatures_1 = require("../signatures");
+function callArgument(spec) {
+    if (spec.usesId && spec.schema !== null)
+        return '({ data: { id, data } })';
+    if (spec.usesId)
+        return '({ data: id })';
+    if (spec.schema !== null)
+        return '({ data })';
+    return '()';
+}
+function renderServerFnRepository(ctx, spec, entity, fromFile) {
+    const fnName = (0, naming_1.lowerFirst)(spec.name);
+    const fnPath = ctx.importLayer(fromFile, 'controller', `${spec.name}.fn`);
+    const imports = [...(0, signatures_1.domainImports)(ctx, fromFile, spec, entity), `import { ${fnName} } from '${fnPath}';`];
+    return `${imports.join('\n')}
+
+export class ${spec.name}Repository {
+  async handle(${spec.params}): ${spec.returns} {
+    return ${fnName}${callArgument(spec)};
+  }
+}
+`;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "domain-driver",
-  "version": "0.3.1",
-  "description": "CLI scaffolding tool for domain-driven feature folders in Next.js, React, Node, and NestJS projects, with per-action files, bespoke actions, and agent guidance",
+  "version": "0.4.1",
+  "description": "CLI scaffolding tool for domain-driven feature folders in Next.js, React, Node, NestJS, and TanStack Start projects, with per-action files, bespoke actions, and agent guidance",
   "main": "dist/index.js",
   "bin": {
     "domain-driver": "./dist/index.js"
@@ -18,6 +18,7 @@
     "build": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\" && tsc",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
+    "typecheck:tanstack-fixture": "node scripts/typecheck-tanstack-fixture.js",
     "postinstall": "node ./scripts/postinstall.js"
   },
   "keywords": [
@@ -30,7 +31,9 @@
     "node",
     "express",
     "fastify",
-    "hono"
+    "hono",
+    "tanstack",
+    "tanstack-start"
   ],
   "author": "Isaac Hatilima",
   "license": "MIT",