create-aron-app 0.1.5 → 0.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-aron-app",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Scaffold a new Convex + Next.js + Clerk full-stack project",
   "license": "MIT",
   "type": "module",
@@ -12,8 +12,11 @@
     "templates"
   ],
   "scripts": {
-    "build": "bun build src/index.ts --target=node --outfile=dist/index.js --minify && echo '#!/usr/bin/env node' | cat - dist/index.js > /tmp/create-tmp.js && mv /tmp/create-tmp.js dist/index.js && chmod +x dist/index.js",
+    "build": "bun build src/index.ts --target=node --outfile=dist/index.js --minify --external giget && echo '#!/usr/bin/env node' | cat - dist/index.js > /tmp/create-tmp.js && mv /tmp/create-tmp.js dist/index.js && chmod +x dist/index.js",
     "start": "bun run src/index.ts",
+    "start:local": "bun run src/index.ts --local",
+    "template": "bun run build && bun run start",
+    "template:local": "bun run build && bun run start:local",
     "release": "npm version patch && npm publish --access public",
     "prepublishOnly": "bun run build"
   },

package/templates/{_base/.cursor → .cursor}/rules/api_architecture.mdc

@@ -7,6 +7,8 @@ globs: apps/api/**/*.ts
 
 This is the Convex backend located in `apps/api/`. It uses `convex-ents` for relational data modeling and `zQuery`/`zMutation` wrappers from `convex-helpers` for all public functions.
 
+> **Validator convention**: All public functions use `zQuery`/`zMutation` with Zod validators (`z.*`, `zid()`), not Convex's native `v.*` validators. Import wrappers from `@/api/functions`.
+
 ## Folder Structure
 
 ```
@@ -63,9 +65,9 @@ import { defineEnt } from "convex-ents";
 export const entityEnts = {
   entities: defineEnt({
     title: v.string(),
-    userId: v.string(),
     isCompleted: v.boolean(),
   })
+    .edge("user")
     .edge("relatedEntity")
     .index("by_user_id", ["userId"]),
 };
@@ -83,7 +85,7 @@ import { z } from "zod";
 export type CreateEntity = z.infer<typeof CreateEntity>;
 export const CreateEntity = z.object({
   title: z.string().min(1),
-  userId: z.string(),
+  // userId is derived from auth context, never passed by the caller
 });
 ```
 
@@ -101,17 +103,27 @@ import { z } from "zod";
 
 export const getEntity = zQuery({
   args: { entityId: zid("entities") },
-  handler: async (ctx, args) => ctx.table("entities").getX(args.entityId),
+  handler: async (ctx, args) => {
+    return ctx.table("entities").getX(args.entityId);
+  },
 });
 
 export const listEntities = zQuery({
-  args: { userId: z.string() },
-  handler: async (ctx, args) =>
-    ctx.table("entities", "by_user_id", (q) => q.eq("userId", args.userId)),
+  args: {},
+  handler: async (ctx) => {
+    const identity = await ctx.auth.getUserIdentity();
+    if (!identity) throw new ConvexError("Not authenticated");
+    const user = await ctx.table("users").get("tokenIdentifier", identity.tokenIdentifier);
+    if (!user) throw new ConvexError("User not found");
+    return ctx.table("entities", "by_user_id", (q) => q.eq("userId", user._id));
+  },
 });
 
 export const updateEntity = zMutation({
-  args: { entityId: zid("entities"), title: z.string().optional() },
+  args: { 
+    entityId: zid("entities"), 
+    title: z.string().optional() 
+  },
   handler: async (ctx, args) => {
     const { entityId, ...updates } = args;
     const entity = await ctx.table("entities").getX(entityId);
@@ -120,9 +132,14 @@ export const updateEntity = zMutation({
 });
 
 export const createEntity = zMutation({
-  args: { title: z.string().min(1), userId: z.string() },
-  handler: async (ctx, args) =>
-    ctx.table("entities").insert({ title: args.title, userId: args.userId, isCompleted: false }),
+  args: { title: z.string().min(1) },
+  handler: async (ctx, args) => {
+    const identity = await ctx.auth.getUserIdentity();
+    if (!identity) throw new ConvexError("Not authenticated");
+    const user = await ctx.table("users").get("tokenIdentifier", identity.tokenIdentifier);
+    if (!user) throw new ConvexError("User not found");
+    return ctx.table("entities").insert({ title: args.title, isCompleted: false, userId: user._id });
+  },
 });
 
 export const deleteEntity = zMutation({
@@ -243,26 +260,3 @@ return ctx
 - Keep CRUD files focused solely on database operations
 - Reuse validators across multiple entities rather than duplicating logic
 
-## Getting Started
-
-### 1. Install dependencies
-
-```bash
-bun install
-```
-
-### 2. Start the Convex dev server
-
-```bash
-npx convex dev
-```
-
-This pushes the schema and regenerates types in `_generated/`.
-
-### 3. Configure environment
-
-Copy `.env.local.example` to `.env.local` and fill in:
-- `CONVEX_DEPLOYMENT` — from Convex dashboard
-- `NEXT_PUBLIC_CONVEX_URL` — from Convex dashboard
-- `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` — from Clerk dashboard
-- `CLERK_SECRET_KEY` — from Clerk dashboard

package/templates/{_base/.cursor → .cursor}/rules/coding_standards.mdc

@@ -61,4 +61,4 @@ if (!entity.limit || entity.limit <= 0) {
 
 ## Testing
 
-Test files **should not** be created unless explicitly requested. Focus on implementation quality over test coverage.
+Test files **should not** be created unless explicitly requested. Focus on implementation quality over test coverage.