appflare 0.1.0 → 0.1.1

package/cli/templates/core/client-modules/handlers/index.ts

@@ -230,11 +230,14 @@ function renderRouteFactory(operation: HttpOperation): string {
 				}
 
 				if (!resolvedAuthToken) {
-					onError?.(
-						new Error(
-							"authToken is required for realtime subscribe (pass options.authToken or Authorization Bearer header)",
-						),
+					const authError = new Error(
+						"authToken is required for realtime subscribe (pass options.authToken or Authorization Bearer header)",
 					);
+					if (onError) {
+						onError(authError);
+					} else {
+						console.warn("[appflare:subscribe]", authError.message);
+					}
 					return;
 				}
 
@@ -295,7 +298,11 @@ function renderRouteFactory(operation: HttpOperation): string {
 					onError?.(new Error("Realtime websocket error"));
 				});
 			} catch (error) {
-				onError?.(error);
+				if (onError) {
+					onError(error);
+				} else {
+					console.warn("[appflare:subscribe] Subscription failed:", error);
+				}
 			}
 		})();
 

package/cli/templates/handlers/README.md

@@ -191,6 +191,94 @@ Execution contexts store these as `ctx.mutationEvents`, and mutation routes call
 
 ---
 
+## DB aggregate helpers
+
+Generated `ctx.db.<table>` wrappers now include aggregate helpers:
+
+- `count(args?)`
+  - `where?: WhereInput<TModel>`
+  - `field?: keyof TModel | string` (supports relation paths, e.g. `comments.id`)
+  - `distinct?: boolean`
+  - `with?: QueryWithInput<...>`
+  - returns `Promise<number>`
+- `avg(args)`
+  - `where?: WhereInput<TModel>`
+  - `field: NumericFieldKey<TModel> | string` (supports relation paths, e.g. `comments.id`)
+  - `distinct?: boolean`
+  - `with?: QueryWithInput<...>`
+  - returns `Promise<number | null>`
+
+Aggregate behavior with `with`:
+
+- Relation `with.where` and nested `with` filters are treated as parent-row constraints for aggregates (EXISTS-style).
+- For `count` with `with`, `distinct` defaults to `true` when `field` is provided.
+- Nested relation paths are supported recursively for both `count` and `avg`.
+
+Relation `with` aggregates on `findMany`/`findFirst`:
+
+- You can request per-parent relation aggregates directly inside `with` using `_count` and `_avg`.
+- Result rows include a sibling `<relationName>Aggregate` object.
+- `_avg` returns `0` for parents with no related rows.
+
+Example:
+
+```ts
+const total = await ctx.db.posts.count({
+	where: { ownerId: user.id },
+});
+
+const uniqueOwners = await ctx.db.posts.count({
+	field: "ownerId",
+	distinct: true,
+});
+
+const averageId = await ctx.db.posts.avg({
+	field: "id",
+	where: { ownerId: user.id },
+});
+
+const postsWithMatchingComments = await ctx.db.posts.count({
+	with: {
+		comments: {
+			where: {
+				id: { gte: 10000 },
+			},
+		},
+	},
+});
+
+const averageCommentId = await ctx.db.posts.avg({
+	field: "comments.id",
+	with: {
+		comments: {
+			where: {
+				id: { gte: 10000 },
+			},
+		},
+	},
+});
+
+const postsWithCommentStats = await ctx.db.posts.findMany({
+	with: {
+		comments: {
+			_count: true,
+			_avg: {
+				id: true,
+			},
+		},
+	},
+});
+
+const firstPostCommentCount =
+	postsWithCommentStats[0]?.commentsAggregate.count ?? 0;
+const firstPostAverageCommentId =
+	postsWithCommentStats[0]?.commentsAggregate.avg.id ?? 0;
+```
+
+`geoWithin.latitudeField` and `geoWithin.longitudeField` are now typed to table keys (instead of free-form strings). Invalid field names still no-op the geo filter at runtime, but now emit a warning.
+
+---
+
 ## Durable Object responsibilities
 
 `AppflareRealtimeDurableObject` keeps in-memory maps for:

package/cli/templates/handlers/auth.ts

@@ -1,6 +1,7 @@
 export function generateAuth(): string {
 	return `
 
+import { getHeaders } from "./server";
 export async function resolveSession(
 \trequest: Request,
 \tdatabase: D1Database,
@@ -17,7 +18,7 @@ export async function resolveSession(
 
 \ttry {
 \t\tconst session = await auth.api.getSession({
-\t\t\theaders: request.headers,
+\t\t\theaders: getHeaders(request.headers),
 \t\t});
 
 \t\treturn {

package/cli/templates/handlers/generators/registration/modules/cron.ts

@@ -0,0 +1,30 @@
+export const cronModule = `
+export async function executeCronTriggers(
+	controller: { cron: string },
+	env: Record<string, unknown>,
+	options: RegisterHandlersOptions,
+): Promise<void> {
+	const cronValue = controller?.cron;
+	if (!cronValue) {
+		return;
+	}
+
+	if (cronHandlers.length === 0) {
+		return;
+	}
+
+	const ctx = createSchedulerExecutionContext(env, options);
+
+	for (const cronEntry of cronHandlers) {
+		if (!cronEntry.cronTriggers.includes(cronValue)) {
+			continue;
+		}
+
+		try {
+			await cronEntry.definition.handler(ctx);
+		} catch (error) {
+			console.error("Cron task failed", cronEntry.taskName, error);
+		}
+	}
+}
+`;