appflare 0.0.28 → 0.1.0

package/cli/schema/schema.ts

@@ -1,151 +0,0 @@
-import { pathToFileURL } from "node:url";
-import { staticTypeDefinitions } from "./schema-static-types";
-import { pascalCase, toImportPathFromGeneratedSrc } from "../utils/utils";
-import { getZodObjectShape, renderField } from "../utils/zod-utils";
-
-function generateDocParts(
-	tableNames: string[],
-	schema: any,
-): {
-	docInterfaces: string[];
-	docMapEntries: string[];
-	tableIndexEntries: string[];
-} {
-	const docInterfaces: string[] = [];
-	const docMapEntries: string[] = [];
-	const tableIndexEntries: string[] = [];
-
-	for (const tableName of tableNames) {
-		const validator = (schema as any)[tableName];
-		const shape = getZodObjectShape(validator);
-		const interfaceName = pascalCase(`${tableName}Doc`);
-
-		const fields = Object.entries(shape);
-		const lines: string[] = [];
-		lines.push(`export interface ${interfaceName} {`);
-		lines.push(`\t_id: Id<${JSON.stringify(tableName)}>;`);
-		lines.push(`\t_creationTime: number;`);
-		for (const [fieldName, fieldSchema] of fields) {
-			const rendered = renderField(fieldName, fieldSchema);
-			lines.push(`\t${rendered}`);
-		}
-		lines.push(`}`);
-
-		docInterfaces.push(lines.join("\n"));
-		docMapEntries.push(`\t${tableName}: ${interfaceName};`);
-		tableIndexEntries.push(`\t${tableName}: [],`);
-	}
-
-	return { docInterfaces, docMapEntries, tableIndexEntries };
-}
-
-export async function getSchemaTableNames(
-	schemaPathAbs: string,
-): Promise<string[]> {
-	const mod = await import(pathToFileURL(schemaPathAbs).href);
-	const schema = mod?.default ?? mod;
-	if (!schema || typeof schema !== "object") {
-		throw new Error(
-			`Invalid schema export in ${schemaPathAbs} (expected default export object)`,
-		);
-	}
-	return Object.keys(schema).sort();
-}
-
-export async function generateSchemaTypes(params: {
-	schemaPathAbs: string;
-	configPathAbs?: string;
-	outDirAbs?: string;
-}): Promise<string> {
-	const mod = await import(pathToFileURL(params.schemaPathAbs).href);
-	const schema = mod?.default ?? mod;
-	if (!schema || typeof schema !== "object") {
-		throw new Error(
-			`Invalid schema export in ${params.schemaPathAbs} (expected default export object)`,
-		);
-	}
-
-	const tableNames = Object.keys(schema).sort();
-	if (tableNames.length === 0) {
-		throw new Error(`Schema has no tables in ${params.schemaPathAbs}`);
-	}
-
-	const { docInterfaces, docMapEntries, tableIndexEntries } = generateDocParts(
-		tableNames,
-		schema,
-	);
-
-	const configImportPath =
-		params.configPathAbs && params.outDirAbs
-			? toImportPathFromGeneratedSrc(params.outDirAbs, params.configPathAbs)
-			: null;
-
-	const authImports = configImportPath
-		? `import type appflareConfig from ${JSON.stringify(configImportPath)};
-import type { Auth, BetterAuthOptions,User,Session } from "better-auth";
-`
-		: "";
-
-	const authTypeDefs = configImportPath
-		? `type __AppflareAuthOptions = NonNullable<
-	typeof appflareConfig["auth"]
->["options"];
-
-type __AppflareAuthInstance = __AppflareAuthOptions extends BetterAuthOptions
-	? Auth<__AppflareAuthOptions>
-	: Auth<BetterAuthOptions>;
-
-type __AppflareAuthSessionResult = __AppflareAuthOptions extends BetterAuthOptions
-	? Awaited<
-			ReturnType<__AppflareAuthInstance["api"]["getSession"]>
-		>
-	: null;
-
-
-export type AppflareAuthSession = Session | null
-export type AppflareAuthUser = User | null
-
-export type AppflareAuthContext = {
-  session: AppflareAuthSession
-  user: AppflareAuthUser
-}
-
-`
-		: `export type AppflareAuthSession = null;
-export type AppflareAuthUser = null;
-export type AppflareAuthContext = { session: null; user: null };
-`;
-
-	return `/* eslint-disable */
-/**
- * This file is auto-generated by appflare/db-build.ts.
- * Do not edit directly.
- */
-${authImports}
-type SchemaValidator<TValue> = {
-	parse: (value: unknown) => TValue;
-};
-
-export type AnyValidator = SchemaValidator<unknown>;
-
-export type TableNames = ${tableNames.map((t) => JSON.stringify(t)).join(" | ")};
-
-export type Id<TableName extends TableNames> = string & { __table: TableName };
-
-${docInterfaces.join("\n\n")}
-
-export interface TableDocMap {
-${docMapEntries.join("\n")}
-}
-
-export type Doc<TableName extends TableNames> = TableDocMap[TableName];
-
-${authTypeDefs}
-
-${staticTypeDefinitions}
-
-export const tableIndexes = {
-${tableIndexEntries.join("\n")}
-} as const;
-`;
-}

package/cli/utils/tsc.ts

@@ -1,54 +0,0 @@
-#!/usr/bin/env bun
-
-import { spawn } from "node:child_process";
-import { promises as fs } from "node:fs";
-import path from "node:path";
-
-export async function runTscEmit(tsconfigPathAbs: string): Promise<void> {
-	await new Promise<void>((resolve, reject) => {
-		const child = spawn("bunx", ["tsc", "-p", tsconfigPathAbs], {
-			stdio: "inherit",
-		});
-		child.on("error", reject);
-		child.on("exit", (code) => {
-			if (code === 0) resolve();
-			reject(new Error(`tsc exited with code ${code}`));
-		});
-	});
-}
-
-export async function writeEmitTsconfig(params: {
-	configDirAbs: string;
-	outDirAbs: string;
-}): Promise<string> {
-	const outDirRel =
-		path.relative(params.configDirAbs, params.outDirAbs).replace(/\\/g, "/") ||
-		"./_generated";
-	const tsconfigPathAbs = path.join(
-		params.configDirAbs,
-		".appflare.tsconfig.emit.json"
-	);
-	const content = {
-		compilerOptions: {
-			noEmit: false,
-			declaration: true,
-			emitDeclarationOnly: false,
-			outDir: `./${outDirRel}/dist`,
-			rootDir: `.`,
-			sourceMap: false,
-			declarationMap: false,
-			skipLibCheck: true,
-			target: "ES2022",
-			module: "ES2022",
-			moduleResolution: "Bundler",
-			types: ["node"],
-		},
-		include: [
-			`./${outDirRel}/src/schema-types.ts`,
-			`./${outDirRel}/src/schema.ts`,
-			`./${outDirRel}/src/handlers/**/*`,
-		],
-	};
-	await fs.writeFile(tsconfigPathAbs, JSON.stringify(content, null, 2));
-	return tsconfigPathAbs;
-}

package/cli/utils/utils.ts

@@ -1,190 +0,0 @@
-import { promises as fs } from "node:fs";
-import path from "node:path";
-import type { BetterAuthOptions } from "better-auth";
-import type { BetterAuthClientOptions } from "better-auth/client";
-import type { StorageManagerOptions } from "../../server/storage/types";
-
-export type AppflareAuthConfig<
-	Options extends BetterAuthOptions,
-	ClientOptions extends BetterAuthClientOptions,
-> = {
-	enabled?: boolean;
-	basePath?: string;
-	/** Server-side Better Auth options. */
-	options?: Options;
-	/** Client-side Better Auth options used in the generated API client. */
-	clientOptions?: ClientOptions;
-};
-export type AppflareStorageConfig<
-	Env = unknown,
-	Principal = unknown,
-> = StorageManagerOptions<Env, Principal> & {
-	/** Optional KV binding name created in the generated worker. */
-	kvBinding?: string;
-	/** Optional KV namespace ID used in wrangler.json. */
-	kvId?: string;
-};
-
-export type AppflareSchedulerConfig = {
-	/** Set to false to disable scheduler generation. */
-	enabled?: boolean;
-	/** Optional Cloudflare Queue binding name. Defaults to APPFLARE_SCHEDULER_QUEUE. */
-	queueBinding?: string;
-	/** Optional Cloudflare Queue name. Defaults to a sanitized worker name with -scheduler suffix. */
-	queueName?: string;
-};
-
-export type AppflareConfig<
-	Options extends BetterAuthOptions = BetterAuthOptions,
-	ClientOptions extends BetterAuthClientOptions = BetterAuthClientOptions,
-> = {
-	dir: string;
-	schema: string;
-	outDir: string;
-	/** Optional override for where wrangler.json is written. Resolved relative to the config file. */
-	wranglerOutPath?: string;
-	/** Optional override for wrangler.json main entrypoint. Defaults to ./server/index.ts in the generated worker. */
-	wranglerMain?: string;
-	/** Optional override for wrangler.json compatibility_date. Defaults to current date. */
-	wranglerCompatibilityDate?: string;
-	/** Optional CORS whitelist for generated Worker entrypoint. */
-	corsOrigin?: string | string[];
-	/** Optional wrangler.json overrides. */
-	wrangler?: {
-		name?: string;
-		main?: string;
-		compatibilityDate?: string;
-		[key: string]: unknown;
-	};
-	auth?: AppflareAuthConfig<Options, ClientOptions>;
-	storage?: AppflareStorageConfig;
-	scheduler?: AppflareSchedulerConfig;
-};
-
-export type HandlerKind =
-	| "query"
-	| "mutation"
-	| "internalQuery"
-	| "internalMutation"
-	| "scheduler"
-	| "cron"
-	| "http";
-
-export type DiscoveredHandler = {
-	fileName: string;
-	/** Path relative to project root without .ts extension, using forward slashes. */
-	routePath: string;
-	name: string;
-	kind: HandlerKind;
-	sourceFileAbs: string;
-	cronTriggers?: string[];
-};
-
-export function pascalCase(value: string): string {
-	return value
-		.replace(/(^|[^A-Za-z0-9]+)([A-Za-z0-9])/g, (_, __, c: string) =>
-			c.toUpperCase(),
-		)
-		.replace(/[^A-Za-z0-9]/g, "");
-}
-
-export function isValidIdentifier(value: string): boolean {
-	return /^[A-Za-z_$][\w$]*$/.test(value);
-}
-
-export function groupBy<T, TKey>(
-	items: T[],
-	keyFn: (item: T) => TKey,
-): Map<TKey, T[]> {
-	const map = new Map<TKey, T[]>();
-	for (const item of items) {
-		const key = keyFn(item);
-		if (map.has(key)) {
-			map.get(key)!.push(item);
-		} else {
-			map.set(key, [item]);
-		}
-	}
-	return map;
-}
-
-export function toImportPathFromGeneratedSrc(
-	outDirAbs: string,
-	fileAbs: string,
-): string {
-	const fromDir = path.join(outDirAbs, "src");
-	let rel = path.relative(fromDir, fileAbs);
-	rel = rel.replace(/\\/g, "/");
-	rel = rel.replace(/\.ts$/, "");
-	if (!rel.startsWith(".")) {
-		rel = `./${rel}`;
-	}
-	return rel;
-}
-
-export function toImportPathFromGeneratedServer(
-	outDirAbs: string,
-	fileAbs: string,
-): string {
-	const fromDir = path.join(outDirAbs, "server");
-	let rel = path.relative(fromDir, fileAbs);
-	rel = rel.replace(/\\/g, "/");
-	rel = rel.replace(/\.ts$/, "");
-	if (!rel.startsWith(".")) {
-		rel = `./${rel}`;
-	}
-	return rel;
-}
-
-export async function assertFileExists(
-	fileAbs: string,
-	message: string,
-): Promise<void> {
-	const ok = await fileExists(fileAbs);
-	if (!ok) throw new Error(message);
-}
-
-export async function assertDirExists(
-	dirAbs: string,
-	message: string,
-): Promise<void> {
-	try {
-		const stat = await fs.stat(dirAbs);
-		if (!stat.isDirectory()) throw new Error(message);
-	} catch {
-		throw new Error(message);
-	}
-}
-
-export async function fileExists(fileAbs: string): Promise<boolean> {
-	try {
-		const stat = await fs.stat(fileAbs);
-		return stat.isFile();
-	} catch {
-		return false;
-	}
-}
-
-export async function walkTsFiles(
-	rootAbs: string,
-	ignoreDirs: Set<string>,
-): Promise<string[]> {
-	const out: string[] = [];
-	const entries = await fs.readdir(rootAbs, { withFileTypes: true });
-	for (const entry of entries) {
-		const abs = path.join(rootAbs, entry.name);
-		if (entry.isDirectory()) {
-			if (ignoreDirs.has(entry.name)) continue;
-			out.push(...(await walkTsFiles(abs, ignoreDirs)));
-			continue;
-		}
-		if (
-			entry.isFile() &&
-			entry.name.endsWith(".ts") &&
-			!entry.name.endsWith(".d.ts")
-		) {
-			out.push(abs);
-		}
-	}
-	return out;
-}

package/cli/utils/zod-utils.ts

@@ -1,121 +0,0 @@
-import { isValidIdentifier } from "./utils";
-
-function getZodObjectShape(schema: any): Record<string, any> {
-	if (!schema || typeof schema !== "object") {
-		throw new Error(`Schema table is not an object`);
-	}
-
-	const def = (schema as any)._def;
-	if (def?.typeName === "ZodObject" || def?.type === "object") {
-		const shape = def.shape;
-		if (typeof shape === "function") {
-			return shape();
-		}
-		if (shape && typeof shape === "object") {
-			return shape;
-		}
-	}
-
-	if (typeof (schema as any).shape === "function") {
-		return (schema as any).shape;
-	}
-	if ((schema as any).shape && typeof (schema as any).shape === "object") {
-		return (schema as any).shape;
-	}
-
-	throw new Error(`Table schema is not a Zod object`);
-}
-
-function renderField(fieldName: string, schema: any): string {
-	const { tsType, optional } = renderType(schema);
-	const safeKey = isValidIdentifier(fieldName)
-		? fieldName
-		: JSON.stringify(fieldName);
-	return `${safeKey}${optional ? "?" : ""}: ${tsType};`;
-}
-
-function renderType(schema: any): { tsType: string; optional: boolean } {
-	const def = schema?._def;
-	const typeName: string | undefined = def?.typeName ?? def?.type;
-	const description: string | undefined =
-		schema?.description ?? def?.description;
-
-	if (description === "geo:point") {
-		return { tsType: "GeoPoint", optional: false };
-	}
-
-	if (typeName === "ZodOptional" || typeName === "optional") {
-		const inner = def?.innerType ?? def?.schema ?? schema?._def?.innerType;
-		const rendered = renderType(inner);
-		return { tsType: rendered.tsType, optional: true };
-	}
-	if (typeName === "ZodNullable" || typeName === "nullable") {
-		const inner = def?.innerType ?? def?.schema;
-		const rendered = renderType(inner);
-		return { tsType: `${rendered.tsType} | null`, optional: false };
-	}
-	if (typeName === "ZodDefault" || typeName === "default") {
-		const inner = def?.innerType ?? def?.schema;
-		return renderType(inner);
-	}
-
-	if (typeName === "ZodString" || typeName === "string") {
-		const description: string | undefined =
-			schema?.description ?? def?.description;
-		if (typeof description === "string" && description.startsWith("ref:")) {
-			const refTableName = description.slice(4);
-			return { tsType: `Id<${JSON.stringify(refTableName)}>`, optional: false };
-		}
-		return { tsType: "string", optional: false };
-	}
-	if (typeName === "ZodNumber" || typeName === "number") {
-		return { tsType: "number", optional: false };
-	}
-	if (typeName === "ZodBoolean" || typeName === "boolean") {
-		return { tsType: "boolean", optional: false };
-	}
-	if (typeName === "ZodDate" || typeName === "date") {
-		return { tsType: "Date", optional: false };
-	}
-	if (typeName === "ZodArray" || typeName === "array") {
-		const inner = def?.element ?? def?.innerType ?? def?.type;
-		const rendered = renderType(inner);
-		return { tsType: `Array<${rendered.tsType}>`, optional: false };
-	}
-	if (typeName === "ZodObject" || typeName === "object") {
-		const shape = getZodObjectShape(schema);
-		const entries = Object.entries(shape);
-		if (entries.length === 0) {
-			return { tsType: "Record<string, unknown>", optional: false };
-		}
-		const props = entries
-			.map(([key, value]) => {
-				const { tsType, optional } = renderType(value);
-				const safeKey = isValidIdentifier(key) ? key : JSON.stringify(key);
-				return `\t${safeKey}${optional ? "?" : ""}: ${tsType};`;
-			})
-			.join("\n");
-		return { tsType: `{\n${props}\n}`, optional: false };
-	}
-	if (typeName === "ZodUnion" || typeName === "union") {
-		const options: any[] = def?.options ?? def?.optionsMap ?? [];
-		const parts = Array.isArray(options)
-			? options.map((o) => renderType(o).tsType)
-			: ["unknown"];
-		return { tsType: parts.join(" | ") || "unknown", optional: false };
-	}
-	if (typeName === "ZodLiteral" || typeName === "literal") {
-		const value = def?.value;
-		return { tsType: JSON.stringify(value), optional: false };
-	}
-	if (typeName === "ZodAny" || typeName === "any") {
-		return { tsType: "any", optional: false };
-	}
-	if (typeName === "ZodUnknown" || typeName === "unknown") {
-		return { tsType: "unknown", optional: false };
-	}
-
-	return { tsType: "unknown", optional: false };
-}
-
-export { getZodObjectShape, renderField, renderType };

package/lib/README.md

@@ -1,50 +0,0 @@
-# Appflare Library
-
-Docs for the shared library helpers in `lib/`
-
-## What’s here
-
-- Schema helpers for defining tables and schemas with Zod
-- Value builders (`v.*`) for common field types and relations
-- React Query hooks with realtime-friendly subscriptions
-
-## Library (`lib/`)
-
-**Schema builders** ([packages/appflare/lib/db.ts](packages/appflare/lib/db.ts))
-
-- `defineTable(shape)`: wrap a Zod shape in `z.object` to define a table.
-- `defineSchema(tables)`: collect a map of tables into a schema object.
-
-**Value helpers** ([packages/appflare/lib/values.ts](packages/appflare/lib/values.ts))
-
-- Primitives: `v.string()`, `v.number()`, `v.boolean()`, `v.date()`.
-- Relations/ids: `v.id(table)` creates a string with an ObjectId regex and a `ref:<table>` description for downstream typing.
-- Location: `v.point()`/`v.location()` yields a GeoJSON Point schema for geospatial queries.
-- Collections/objects: `v.array(item)`, `v.object(shape)`.
-- Modifiers: `v.optional(schema)`, `v.nullable(schema)`, `v.union(...schemas)`, `v.literal(value)`.
-- Misc: `v.buffer()` (string placeholder), `v.any()`, `v.unknown()`.
-
-**Location helpers** ([packages/appflare/lib/location.ts](packages/appflare/lib/location.ts))
-
-- Builders: `point(lng, lat)` returns a GeoJSON Point; `geo.point` is the same alias.
-- Queries: `geo.near("location", pointLngLat, { maxDistanceMeters })`, `geo.withinRadius("location", center, radiusMeters)`, `geo.withinBox(...)`, `geo.withinPolygon(...)`, `geo.intersects(...)` produce Mongo-ready filters you can pass to `where`.
-
-**Example: define a schema**
-
-```ts
-import { defineSchema, defineTable } from "appflare/lib/db";
-import { v } from "appflare/lib/values";
-
-export default defineSchema({
-	users: defineTable({
-		name: v.string(),
-		email: v.string(),
-		age: v.number().optional(),
-		orgId: v.id("orgs"),
-		location: v.point(),
-	}),
-	orgs: defineTable({
-		name: v.string(),
-	}),
-});
-```

package/lib/db.ts

@@ -1,19 +0,0 @@
-import { z } from "zod";
-
-export type AppflareTable<TShape extends Record<string, z.ZodTypeAny>> =
-	z.ZodObject<TShape>;
-
-export type AppflareSchema<TTables extends Record<string, AppflareTable<any>>> =
-	TTables;
-
-export function defineTable<TShape extends Record<string, z.ZodTypeAny>>(
-	shape: TShape
-): AppflareTable<TShape> {
-	return z.object(shape);
-}
-
-export function defineSchema<
-	TTables extends Record<string, AppflareTable<any>>,
->(tables: TTables): AppflareSchema<TTables> {
-	return tables;
-}

package/lib/location.ts

@@ -1,110 +0,0 @@
-import { z } from "zod";
-
-export type GeoCoordinates = readonly [number, number];
-
-export type GeoPoint = {
-	type: "Point";
-	coordinates: GeoCoordinates;
-};
-
-export const geoPointSchema = z
-	.object({
-		type: z.literal("Point"),
-		coordinates: z.tuple([z.number(), z.number()]),
-	})
-	.describe("geo:point");
-
-export const EARTH_RADIUS_METERS = 6_378_100;
-
-const normalizePoint = (point: GeoPoint | GeoCoordinates): GeoPoint =>
-	Array.isArray(point)
-		? { type: "Point", coordinates: [point[0], point[1]] }
-		: (point as GeoPoint);
-
-export const point = (lng: number, lat: number): GeoPoint => ({
-	type: "Point",
-	coordinates: [lng, lat],
-});
-
-export type NearQueryOptions = {
-	maxDistanceMeters?: number;
-	minDistanceMeters?: number;
-};
-
-export const near = (
-	field: string,
-	geometry: GeoPoint | GeoCoordinates,
-	options: NearQueryOptions = {}
-): Record<string, unknown> => {
-	const $near: Record<string, unknown> = {
-		$geometry: normalizePoint(geometry),
-	};
-	if (options.maxDistanceMeters !== undefined) {
-		$near.$maxDistance = options.maxDistanceMeters;
-	}
-	if (options.minDistanceMeters !== undefined) {
-		$near.$minDistance = options.minDistanceMeters;
-	}
-	return { [field]: { $near } };
-};
-
-export const withinRadius = (
-	field: string,
-	center: GeoPoint | GeoCoordinates,
-	radiusMeters: number
-): Record<string, unknown> => ({
-	[field]: {
-		$geoWithin: {
-			$centerSphere: [
-				normalizePoint(center).coordinates,
-				radiusMeters / EARTH_RADIUS_METERS,
-			],
-		},
-	},
-});
-
-export const withinBox = (
-	field: string,
-	southwest: GeoPoint | GeoCoordinates,
-	northeast: GeoPoint | GeoCoordinates
-): Record<string, unknown> => ({
-	[field]: {
-		$geoWithin: {
-			$box: [
-				normalizePoint(southwest).coordinates,
-				normalizePoint(northeast).coordinates,
-			],
-		},
-	},
-});
-
-export const withinPolygon = (
-	field: string,
-	polygon: ReadonlyArray<GeoPoint | GeoCoordinates>
-): Record<string, unknown> => ({
-	[field]: {
-		$geoWithin: {
-			$polygon: polygon.map((p) => normalizePoint(p).coordinates),
-		},
-	},
-});
-
-export const intersects = (
-	field: string,
-	geometry: { type: string; coordinates: unknown }
-): Record<string, unknown> => ({
-	[field]: {
-		$geoIntersects: {
-			$geometry: geometry,
-		},
-	},
-});
-
-export const geo = {
-	point,
-	near,
-	withinRadius,
-	withinBox,
-	withinPolygon,
-	intersects,
-};