appflare 0.0.28 → 0.1.0

package/server/types/types.ts

@@ -1,633 +0,0 @@
-import type { Db } from "mongodb";
-
-export type AnyZod = any;
-
-export type TableDocBase = {
-	_id: string;
-	_creationTime: number;
-};
-
-export type Id<TableName extends string> = string & { __table?: TableName };
-
-export type EditableDoc<TDoc extends TableDocBase> = Omit<
-	TDoc,
-	"_id" | "_creationTime"
->;
-
-export type SelectedKeys<TDoc, TSelect> =
-	TSelect extends readonly (infer TKey)[]
-		? Extract<TKey, Keys<TDoc>>
-		: TSelect extends Record<infer TKey, boolean>
-			? Extract<TKey, Keys<TDoc>>
-			: Keys<TDoc>;
-
-export type IncludedKeys<
-	TDoc,
-	TInclude,
-	TTableDocMap extends Record<string, TableDocBase>,
-> = TInclude extends readonly (infer TKey)[]
-	? Extract<TKey, PopulatableKeys<TDoc, TTableDocMap>>
-	: TInclude extends Record<infer TKey, boolean>
-		? Extract<TKey, PopulatableKeys<TDoc, TTableDocMap>>
-		: never;
-
-export type AppflareSelect<TDoc> =
-	| ReadonlyArray<Keys<TDoc>>
-	| Partial<Record<Keys<TDoc>, boolean>>;
-
-type PopulatedDocForKey<
-	TDoc,
-	TTableDocMap extends Record<string, TableDocBase>,
-	TKey extends Keys<TDoc>,
-> =
-	NonNil<PopulateValue<TDoc[TKey], TTableDocMap>> extends Array<infer TItem>
-		? NonNil<TItem>
-		: NonNil<PopulateValue<TDoc[TKey], TTableDocMap>>;
-
-type AggregateSpec<TDoc> = {
-	count?: boolean;
-	sum?: ReadonlyArray<NumericKeys<TDoc>>;
-	avg?: ReadonlyArray<NumericKeys<TDoc>>;
-};
-
-type AggregateSpecForKey<
-	TDoc,
-	TTableDocMap extends Record<string, TableDocBase>,
-	TKey extends Keys<TDoc>,
-> = AggregateSpec<PopulatedDocForKey<TDoc, TTableDocMap, TKey>>;
-
-type AppflareIncludeRecord<
-	TDoc,
-	TTableDocMap extends Record<string, TableDocBase>,
-> = {
-	[K in PopulatableKeys<TDoc, TTableDocMap>]?:
-		| boolean
-		| {
-				aggregate?: AggregateSpecForKey<TDoc, TTableDocMap, K>;
-				includeDocs?: boolean;
-		  };
-};
-
-export type AppflareInclude<
-	TDoc,
-	TTableDocMap extends Record<string, TableDocBase>,
-> =
-	| ReadonlyArray<PopulatableKeys<TDoc, TTableDocMap>>
-	| AppflareIncludeRecord<TDoc, TTableDocMap>;
-
-type ExtractAggregateSpec<T> = T extends { aggregate?: infer TSpec }
-	? TSpec
-	: never;
-
-type AggregateResultFromSpec<TDoc, TSpec> = (TSpec extends { count: true }
-	? { count: number }
-	: {}) &
-	(TSpec extends { sum: infer TSum }
-		? TSum extends ReadonlyArray<infer K>
-			? { [P in Extract<K, NumericKeys<TDoc>> as `sum_${P}`]: number }
-			: {}
-		: {}) &
-	(TSpec extends { avg: infer TAvg }
-		? TAvg extends ReadonlyArray<infer K>
-			? { [P in Extract<K, NumericKeys<TDoc>> as `avg_${P}`]: number }
-			: {}
-		: {});
-
-type AggregateMapForInclude<
-	TDoc,
-	TTableDocMap extends Record<string, TableDocBase>,
-	TInclude,
-> =
-	TInclude extends ReadonlyArray<any>
-		? {}
-		: {
-				[K in keyof TInclude as ExtractAggregateSpec<TInclude[K]> extends never
-					? never
-					: K]: AggregateResultFromSpec<
-					PopulatedDocForKey<TDoc, TTableDocMap, Extract<K, Keys<TDoc>>>,
-					ExtractAggregateSpec<TInclude[K]>
-				>;
-			};
-
-type WithAggregatesForInclude<
-	TDoc,
-	TTableDocMap extends Record<string, TableDocBase>,
-	TInclude,
-> = keyof AggregateMapForInclude<TDoc, TTableDocMap, TInclude> extends never
-	? {}
-	: { _aggregates: AggregateMapForInclude<TDoc, TTableDocMap, TInclude> };
-
-export type AppflareResultDoc<
-	TDoc,
-	TSelect,
-	TInclude,
-	TTableDocMap extends Record<string, TableDocBase>,
-> = WithSelected<
-	WithPopulatedMany<
-		TDoc,
-		IncludedKeys<TDoc, TInclude, TTableDocMap>,
-		TTableDocMap
-	>,
-	SelectedKeys<TDoc, TSelect>
-> &
-	WithAggregatesForInclude<TDoc, TTableDocMap, TInclude>;
-
-export type SortDirection = "asc" | "desc";
-
-export type QuerySort<TKey extends string> =
-	| Partial<Record<TKey, SortDirection>>
-	| Array<[TKey, SortDirection]>
-	| Record<string, SortDirection>
-	| Array<[string, SortDirection]>;
-
-type Comparable<T> =
-	NonNil<T> extends number | bigint | Date ? NonNil<T> : never;
-
-type RegexOperand<T> =
-	NonNil<T> extends string
-		? string | RegExp | { pattern: string; options?: string }
-		: never;
-
-type ArrayOperand<T> = ReadonlyArray<NonNil<T>>;
-
-type QueryWhereField<T> =
-	| NonNil<T>
-	| {
-			eq?: NonNil<T>;
-			$eq?: NonNil<T>;
-			ne?: NonNil<T>;
-			$ne?: NonNil<T>;
-			in?: ArrayOperand<T>;
-			$in?: ArrayOperand<T>;
-			nin?: ArrayOperand<T>;
-			$nin?: ArrayOperand<T>;
-			gt?: Comparable<T>;
-			$gt?: Comparable<T>;
-			gte?: Comparable<T>;
-			$gte?: Comparable<T>;
-			lt?: Comparable<T>;
-			$lt?: Comparable<T>;
-			lte?: Comparable<T>;
-			$lte?: Comparable<T>;
-			exists?: boolean;
-			$exists?: boolean;
-			regex?: RegexOperand<T>;
-			$regex?: RegexOperand<T>;
-			$options?: string;
-	  };
-
-type LogicalWhere<TDoc extends Record<string, unknown>> = {
-	$and?: ReadonlyArray<QueryWhere<TDoc>>;
-	and?: ReadonlyArray<QueryWhere<TDoc>>;
-	$or?: ReadonlyArray<QueryWhere<TDoc>>;
-	or?: ReadonlyArray<QueryWhere<TDoc>>;
-	$nor?: ReadonlyArray<QueryWhere<TDoc>>;
-	nor?: ReadonlyArray<QueryWhere<TDoc>>;
-	$not?: QueryWhere<TDoc>;
-	not?: QueryWhere<TDoc>;
-};
-
-export type QueryWhere<TDoc extends Record<string, unknown>> = Partial<{
-	[K in keyof TDoc]?: QueryWhereField<TDoc[K]>;
-}> &
-	LogicalWhere<TDoc> &
-	Record<string, unknown>;
-
-export type Keys<T> = keyof T;
-
-export type NonNil<T> = Exclude<T, null | undefined>;
-
-export type ExtractIdTableName<T> =
-	NonNil<T> extends Id<infer TTable>
-		? TTable
-		: NonNil<T> extends Array<infer TItem>
-			? ExtractIdTableName<TItem>
-			: never;
-
-export type NumericKeys<T> = {
-	[K in keyof T]: NonNil<T[K]> extends number | bigint ? K : never;
-}[keyof T] &
-	string;
-
-export type PopulateValue<
-	T,
-	TTableDocMap extends Record<string, TableDocBase>,
-> =
-	T extends Id<infer TTable>
-		? TTable extends keyof TTableDocMap
-			? TTableDocMap[TTable]
-			: never
-		: T extends Array<infer TItem>
-			? Array<PopulateValue<TItem, TTableDocMap>>
-			: T;
-
-export type PopulatableKeys<
-	TDoc,
-	TTableDocMap extends Record<string, TableDocBase>,
-> = {
-	[K in Keys<TDoc>]: ExtractIdTableName<TDoc[K]> extends keyof TTableDocMap
-		? K
-		: never;
-}[Keys<TDoc>];
-
-export type WithPopulated<
-	TDoc,
-	TKey extends Keys<TDoc>,
-	TTableDocMap extends Record<string, TableDocBase>,
-> = {
-	[K in Keys<TDoc>]: K extends TKey
-		? PopulateValue<TDoc[K], TTableDocMap>
-		: TDoc[K];
-};
-
-export type WithPopulatedMany<
-	TDoc,
-	TKeys extends Keys<TDoc>,
-	TTableDocMap extends Record<string, TableDocBase>,
-> = {
-	[K in Keys<TDoc>]: K extends TKeys
-		? PopulateValue<TDoc[K], TTableDocMap>
-		: TDoc[K];
-};
-
-export type WithSelected<TDoc, TKeys extends Keys<TDoc>> = Pick<TDoc, TKeys>;
-
-export type MongoDbQuery<
-	TableName extends string,
-	TTableDocMap extends Record<string, TableDocBase>,
-	TResultDoc,
-> = {
-	where(
-		filter: QueryWhere<TTableDocMap[TableName]>
-	): MongoDbQuery<TableName, TTableDocMap, TResultDoc>;
-	sort(
-		sort: QuerySort<keyof TTableDocMap[TableName] & string>
-	): MongoDbQuery<TableName, TTableDocMap, TResultDoc>;
-	limit(limit: number): MongoDbQuery<TableName, TTableDocMap, TResultDoc>;
-	offset(offset: number): MongoDbQuery<TableName, TTableDocMap, TResultDoc>;
-
-	select<const TKeys extends readonly Keys<TResultDoc>[]>(
-		keys: TKeys
-	): MongoDbQuery<
-		TableName,
-		TTableDocMap,
-		WithSelected<TResultDoc, TKeys[number]>
-	>;
-	select<const TKeys extends readonly Keys<TResultDoc>[]>(
-		...keys: TKeys
-	): MongoDbQuery<
-		TableName,
-		TTableDocMap,
-		WithSelected<TResultDoc, TKeys[number]>
-	>;
-
-	populate<const TKey extends PopulatableKeys<TResultDoc, TTableDocMap>>(
-		key: TKey
-	): MongoDbQuery<
-		TableName,
-		TTableDocMap,
-		WithPopulated<TResultDoc, TKey, TTableDocMap>
-	>;
-	populate<
-		const TKeys extends readonly PopulatableKeys<TResultDoc, TTableDocMap>[],
-	>(
-		keys: TKeys
-	): MongoDbQuery<
-		TableName,
-		TTableDocMap,
-		WithPopulatedMany<TResultDoc, TKeys[number], TTableDocMap>
-	>;
-	populate<TInclude extends AppflareInclude<TResultDoc, TTableDocMap>>(
-		include: TInclude
-	): MongoDbQuery<
-		TableName,
-		TTableDocMap,
-		WithPopulatedMany<
-			TResultDoc,
-			IncludedKeys<TResultDoc, TInclude, TTableDocMap>,
-			TTableDocMap
-		> &
-			WithAggregatesForInclude<TResultDoc, TTableDocMap, TInclude>
-	>;
-
-	find(): Promise<Array<TResultDoc>>;
-	findOne(): Promise<TResultDoc | null>;
-};
-
-export type MongoDbDeleteBuilder<
-	TableName extends string,
-	TTableDocMap extends Record<string, TableDocBase>,
-> = {
-	where(where: Id<TableName> | QueryWhere<TTableDocMap[TableName]>): {
-		exec(): Promise<void>;
-	};
-};
-
-export type MongoDbUpdateBuilder<
-	TableName extends string,
-	TTableDocMap extends Record<string, TableDocBase>,
-> = {
-	where(where: Id<TableName> | QueryWhere<TTableDocMap[TableName]>): {
-		set(partial: Partial<EditableDoc<TTableDocMap[TableName]>>): {
-			exec(): Promise<void>;
-		};
-		exec(partial: Partial<EditableDoc<TTableDocMap[TableName]>>): Promise<void>;
-	};
-};
-
-export type MongoDbPatchBuilder<
-	TableName extends string,
-	TTableDocMap extends Record<string, TableDocBase>,
-> = MongoDbUpdateBuilder<TableName, TTableDocMap>;
-
-export type MongoDbCoreContext<
-	TTableNames extends string,
-	TTableDocMap extends Record<TTableNames, TableDocBase>,
-> = {
-	query<TableName extends TTableNames>(
-		table: TableName
-	): MongoDbQuery<TableName, TTableDocMap, TTableDocMap[TableName]>;
-	insert<TableName extends TTableNames>(
-		table: TableName,
-		value: EditableDoc<TTableDocMap[TableName]>
-	): Promise<Id<TableName>>;
-	update<TableName extends TTableNames>(
-		table: TableName
-	): MongoDbUpdateBuilder<TableName, TTableDocMap>;
-	update<TableName extends TTableNames>(
-		table: TableName,
-		where: Id<TableName> | QueryWhere<TTableDocMap[TableName]>,
-		partial: Partial<EditableDoc<TTableDocMap[TableName]>>
-	): Promise<void>;
-	patch<TableName extends TTableNames>(
-		table: TableName
-	): MongoDbPatchBuilder<TableName, TTableDocMap>;
-	patch<TableName extends TTableNames>(
-		table: TableName,
-		where: Id<TableName> | QueryWhere<TTableDocMap[TableName]>,
-		partial: Partial<EditableDoc<TTableDocMap[TableName]>>
-	): Promise<void>;
-	delete<TableName extends TTableNames>(
-		table: TableName
-	): MongoDbDeleteBuilder<TableName, TTableDocMap>;
-	delete<TableName extends TTableNames>(
-		table: TableName,
-		where: Id<TableName> | QueryWhere<TTableDocMap[TableName]>
-	): Promise<void>;
-};
-
-export type AppflareFindManyArgs<
-	TableName extends string,
-	TTableDocMap extends Record<TableName, TableDocBase>,
-> = {
-	where?: QueryWhere<TTableDocMap[TableName]>;
-	orderBy?: QuerySort<keyof TTableDocMap[TableName] & string>;
-	skip?: number;
-	take?: number;
-	select?: AppflareSelect<TTableDocMap[TableName]>;
-	include?: AppflareInclude<TTableDocMap[TableName], TTableDocMap>;
-};
-
-export type AppflareFindFirstArgs<
-	TableName extends string,
-	TTableDocMap extends Record<TableName, TableDocBase>,
-> = AppflareFindManyArgs<TableName, TTableDocMap>;
-
-export type AppflareFindUniqueArgs<
-	TableName extends string,
-	TTableDocMap extends Record<TableName, TableDocBase>,
-> = Omit<
-	AppflareFindManyArgs<TableName, TTableDocMap>,
-	"skip" | "take" | "orderBy"
-> & {
-	where: Id<TableName> | QueryWhere<TTableDocMap[TableName]>;
-};
-
-export type AppflareCreateArgs<
-	TableName extends string,
-	TTableDocMap extends Record<TableName, TableDocBase>,
-> = {
-	data: EditableDoc<TTableDocMap[TableName]>;
-	select?: AppflareSelect<TTableDocMap[TableName]>;
-	include?: AppflareInclude<TTableDocMap[TableName], TTableDocMap>;
-};
-
-export type AppflareUpdateArgs<
-	TableName extends string,
-	TTableDocMap extends Record<TableName, TableDocBase>,
-> = {
-	where: Id<TableName> | QueryWhere<TTableDocMap[TableName]>;
-	data: Partial<EditableDoc<TTableDocMap[TableName]>>;
-	select?: AppflareSelect<TTableDocMap[TableName]>;
-	include?: AppflareInclude<TTableDocMap[TableName], TTableDocMap>;
-};
-
-export type AppflareDeleteArgs<
-	TableName extends string,
-	TTableDocMap extends Record<TableName, TableDocBase>,
-> = {
-	where: Id<TableName> | QueryWhere<TTableDocMap[TableName]>;
-	select?: AppflareSelect<TTableDocMap[TableName]>;
-	include?: AppflareInclude<TTableDocMap[TableName], TTableDocMap>;
-};
-
-export type AppflareUpdateManyArgs<
-	TableName extends string,
-	TTableDocMap extends Record<TableName, TableDocBase>,
-> = {
-	where?: QueryWhere<TTableDocMap[TableName]>;
-	data: Partial<EditableDoc<TTableDocMap[TableName]>>;
-};
-
-export type AppflareDeleteManyArgs<
-	TableName extends string,
-	TTableDocMap extends Record<TableName, TableDocBase>,
-> = {
-	where?: QueryWhere<TTableDocMap[TableName]>;
-};
-
-export type AppflareCountArgs<
-	TableName extends string,
-	TTableDocMap extends Record<TableName, TableDocBase>,
-> = {
-	where?: QueryWhere<TTableDocMap[TableName]>;
-};
-
-type AggregateGroupInput<TDoc> =
-	| ReadonlyArray<keyof TDoc & string>
-	| (keyof TDoc & string);
-
-type NormalizeGroupInput<TDoc, TGroup> = TGroup extends readonly (infer K)[]
-	? ReadonlyArray<Extract<K, keyof TDoc & string>>
-	: TGroup extends string
-		? ReadonlyArray<Extract<TGroup, keyof TDoc & string>>
-		: ReadonlyArray<never>;
-
-type AggregateId<
-	TDoc,
-	TGroup extends ReadonlyArray<keyof TDoc & string>,
-> = TGroup extends readonly []
-	? null
-	: TGroup extends readonly [infer K]
-		? TDoc[Extract<K, keyof TDoc>]
-		: { [K in TGroup[number]]: TDoc[K] };
-
-type AggregateResult<
-	TDoc,
-	TGroup extends ReadonlyArray<keyof TDoc & string>,
-	TSum extends ReadonlyArray<NumericKeys<TDoc>>,
-	TAvg extends ReadonlyArray<NumericKeys<TDoc>>,
-> = {
-	_id: AggregateId<TDoc, TGroup>;
-} & (TSum[number] extends never
-	? {}
-	: { [K in TSum[number] as `sum_${K}`]: number }) &
-	(TAvg[number] extends never
-		? {}
-		: { [K in TAvg[number] as `avg_${K}`]: number });
-
-export type AppflareAggregateArgs<
-	TableName extends string,
-	TTableDocMap extends Record<TableName, TableDocBase>,
-	TGroup = AggregateGroupInput<TTableDocMap[TableName]>,
-	TSum extends ReadonlyArray<NumericKeys<TTableDocMap[TableName]>> =
-		ReadonlyArray<NumericKeys<TTableDocMap[TableName]>>,
-	TAvg extends ReadonlyArray<NumericKeys<TTableDocMap[TableName]>> =
-		ReadonlyArray<NumericKeys<TTableDocMap[TableName]>>,
-> = {
-	where?: QueryWhere<TTableDocMap[TableName]>;
-	groupBy?: TGroup;
-	sum?: TSum;
-	avg?: TAvg;
-	/**
-	 * Populate aggregated group keys that are references to other tables.
-	 * Only keys present in groupBy are eligible for populate.
-	 */
-	populate?: AppflareInclude<TTableDocMap[TableName], TTableDocMap>;
-};
-
-export type AppflareTableClient<
-	TableName extends string,
-	TTableDocMap extends Record<TableName, TableDocBase>,
-> = {
-	findMany<TSelect = AppflareSelect<TTableDocMap[TableName]>, TInclude = never>(
-		args?: AppflareFindManyArgs<TableName, TTableDocMap> & {
-			select?: TSelect;
-			include?: TInclude;
-		}
-	): Promise<
-		Array<
-			AppflareResultDoc<
-				TTableDocMap[TableName],
-				TSelect,
-				TInclude,
-				TTableDocMap
-			>
-		>
-	>;
-	findFirst<
-		TSelect = AppflareSelect<TTableDocMap[TableName]>,
-		TInclude = never,
-	>(
-		args?: AppflareFindFirstArgs<TableName, TTableDocMap> & {
-			select?: TSelect;
-			include?: TInclude;
-		}
-	): Promise<AppflareResultDoc<
-		TTableDocMap[TableName],
-		TSelect,
-		TInclude,
-		TTableDocMap
-	> | null>;
-	findUnique<
-		TSelect = AppflareSelect<TTableDocMap[TableName]>,
-		TInclude = never,
-	>(
-		args: AppflareFindUniqueArgs<TableName, TTableDocMap> & {
-			select?: TSelect;
-			include?: TInclude;
-		}
-	): Promise<AppflareResultDoc<
-		TTableDocMap[TableName],
-		TSelect,
-		TInclude,
-		TTableDocMap
-	> | null>;
-	create<TSelect = AppflareSelect<TTableDocMap[TableName]>, TInclude = never>(
-		args: AppflareCreateArgs<TableName, TTableDocMap> & {
-			select?: TSelect;
-			include?: TInclude;
-		}
-	): Promise<
-		AppflareResultDoc<TTableDocMap[TableName], TSelect, TInclude, TTableDocMap>
-	>;
-	update<TSelect = AppflareSelect<TTableDocMap[TableName]>, TInclude = never>(
-		args: AppflareUpdateArgs<TableName, TTableDocMap> & {
-			select?: TSelect;
-			include?: TInclude;
-		}
-	): Promise<AppflareResultDoc<
-		TTableDocMap[TableName],
-		TSelect,
-		TInclude,
-		TTableDocMap
-	> | null>;
-	updateMany(
-		args: AppflareUpdateManyArgs<TableName, TTableDocMap>
-	): Promise<{ count: number }>;
-	delete<TSelect = AppflareSelect<TTableDocMap[TableName]>, TInclude = never>(
-		args: AppflareDeleteArgs<TableName, TTableDocMap> & {
-			select?: TSelect;
-			include?: TInclude;
-		}
-	): Promise<AppflareResultDoc<
-		TTableDocMap[TableName],
-		TSelect,
-		TInclude,
-		TTableDocMap
-	> | null>;
-	deleteMany(
-		args?: AppflareDeleteManyArgs<TableName, TTableDocMap>
-	): Promise<{ count: number }>;
-	count(args?: AppflareCountArgs<TableName, TTableDocMap>): Promise<number>;
-	aggregate<
-		TGroup = AggregateGroupInput<TTableDocMap[TableName]>,
-		TSum extends ReadonlyArray<NumericKeys<TTableDocMap[TableName]>> =
-			ReadonlyArray<NumericKeys<TTableDocMap[TableName]>>,
-		TAvg extends ReadonlyArray<NumericKeys<TTableDocMap[TableName]>> =
-			ReadonlyArray<NumericKeys<TTableDocMap[TableName]>>,
-	>(
-		args: AppflareAggregateArgs<TableName, TTableDocMap, TGroup, TSum, TAvg>
-	): Promise<
-		Array<
-			AggregateResult<
-				TTableDocMap[TableName],
-				NormalizeGroupInput<TTableDocMap[TableName], TGroup>,
-				TSum,
-				TAvg
-			>
-		>
-	>;
-};
-
-export type AppflareModelMap<
-	TTableNames extends string,
-	TTableDocMap extends Record<TTableNames, TableDocBase>,
-> = {
-	[K in TTableNames]: AppflareTableClient<K, TTableDocMap>;
-};
-
-export type MongoDbContext<
-	TTableNames extends string,
-	TTableDocMap extends Record<TTableNames, TableDocBase>,
-> = AppflareModelMap<TTableNames, TTableDocMap>;
-
-export type CreateMongoDbContextOptions<TTableNames extends string> = {
-	db: Db;
-	/** The same schema object you pass to defineSchema(...) */
-	schema: Record<TTableNames, AnyZod>;
-	/** Override collection naming if desired. Default is the table name. */
-	collectionName?: (table: TTableNames) => string;
-};
-
-export type SchemaRefMap = Map<string, Map<string, string>>;