@nkzw/fate 0.0.3 → 0.0.4

package/README.md

@@ -1042,4 +1042,6 @@ Probably. One day. _Maybe._
 ## Acknowledgements
 
 - [Relay](https://relay.dev/), [Isograph](https://isograph.dev/) & [GraphQL](https://graphql.org/) for inspiration
-- [Ricky Hanlon](https://x.com/rickyfm) for guidance on Async React
+- [Ricky Hanlon](https://x.com/rickyfm) for guidance on Async React
+
+**_fate_** was created by [@cnakazawa](https://x.com/cnakazawa) and is maintained by [Nakazawa Tech](https://nakazawa.tech/).

package/lib/cli.mjs

@@ -9,7 +9,7 @@ const isDataViewField = (field) => Boolean(field) && typeof field === "object" &
 * Builds the schema object used by the CLI generator from your data views and
 * list resolver configs.
 */
-const createFateSchema = (dataViews, lists) => {
+const createSchema = (dataViews, lists) => {
 	const canonicalViews = /* @__PURE__ */ new Map();
 	const entities = {};
 	const fateTypes = /* @__PURE__ */ new Map();
@@ -37,6 +37,7 @@ const createFateSchema = (dataViews, lists) => {
 		if (!typeName) throw new Error("Data view is missing a type name.");
 		if (!canonicalViews.has(typeName)) canonicalViews.set(typeName, view);
 		entities[typeName.toLowerCase()] = { type: typeName };
+		ensureType(view);
 	}
 	for (const [name, list] of Object.entries(lists)) {
 		const config = "fields" in list ? { view: list } : list;
@@ -88,8 +89,8 @@ const formatTypes = (types) => {
 const indentBlock = (value, spaces) => value.split("\n").map((line) => line.length ? `${" ".repeat(spaces)}${line}` : line).join("\n");
 const generate = async () => {
 	console.log(styleText("bold", `Generating fate client…\n`));
-	const [{ appRouter, Lists, ...dataViews }] = await Promise.all([import(moduleName)]);
-	const { entities, types } = createFateSchema(Object.values(dataViews), Lists);
+	const { appRouter, Lists, ...dataViews } = await import(moduleName);
+	const { entities, types } = createSchema(Object.values(dataViews), Lists);
 	const routerRecord = appRouter._def?.record ?? {};
 	const mutationEntries = [];
 	const byIdEntries = [];

package/lib/index.d.mts

@@ -26,8 +26,8 @@ declare const __FateMutationResultBrand: unique symbol;
 type __ViewEntityAnchor<T$1 extends Entity> = {
   readonly [__FateEntityBrand]?: T$1;
 };
-type __ViewSelectionAnchor<S$1> = {
-  [__FateSelectionBrand]?: S$1;
+type __ViewSelectionAnchor<S> = {
+  [__FateSelectionBrand]?: S;
 };
 type __MutationEntityAnchor<T$1 extends Entity> = {
   readonly [__FateMutationEntityBrand]?: T$1;
@@ -126,33 +126,33 @@ type SelectionViewSpread<T$1 extends Entity> = { readonly [K in ViewTag]?: Reado
 /** Declarative selection of the fields a view needs from an entity. */
 type Selection<T$1 extends Entity> = SelectionShape<T$1> & SelectionViewSpread<T$1>;
 /** View payload stored on a view tag containing the raw selection used to mask data. */
-type ViewPayload<T$1 extends Entity, S$1 extends Selection<T$1> = Selection<T$1>> = Readonly<{
-  select: S$1;
+type ViewPayload<T$1 extends Entity, S extends Selection<T$1> = Selection<T$1>> = Readonly<{
+  select: S;
   [ViewKind]: true;
 }>;
 /** Definition of a view over an entity type, including the selection of fields. */
-type View<T$1 extends Entity, S$1 extends Selection<T$1> = Selection<T$1>> = Readonly<{
-  [viewTag: ViewTag]: ViewPayload<T$1, S$1>;
-}> & __ViewEntityAnchor<T$1> & __ViewSelectionAnchor<S$1>;
-type HasViewTag<S$1> = S$1 extends { [K in ViewTag]?: infer P } ? P extends {
+type View<T$1 extends Entity, S extends Selection<T$1> = Selection<T$1>> = Readonly<{
+  [viewTag: ViewTag]: ViewPayload<T$1, S>;
+}> & __ViewEntityAnchor<T$1> & __ViewSelectionAnchor<S>;
+type HasViewTag<S> = S extends { [K in ViewTag]?: infer P } ? P extends {
   [ViewKind]: true;
 } ? true : false : false;
 /**
  * Data returned from a resolved view with masking applied and view tags
  * attached for downstream composition.
  */
-type ViewData<T$1 extends Entity, S$1 extends Selection<T$1>> = Readonly<(S$1 extends Selection<T$1> ? Mask<T$1, S$1> : T$1) & {
+type ViewData<T$1 extends Entity, S extends Selection<T$1>> = Readonly<(S extends Selection<T$1> ? Mask<T$1, S> : T$1) & {
   [ViewsTag]: Set<string>;
 }>;
 /**
  * Snapshot returned by the cache for a view, including the masked data and all
  * referenced entity IDs.
  */
-type ViewSnapshot<T$1 extends Entity, S$1 extends Selection<T$1>> = Readonly<{
+type ViewSnapshot<T$1 extends Entity, S extends Selection<T$1>> = Readonly<{
   coverage: ReadonlyArray<readonly [id: EntityId, paths: ReadonlySet<string>]>;
-  data: ViewData<T$1, S$1>;
+  data: ViewData<T$1, S>;
 }>;
-type ConnectionMask<T$1 extends Entity, S$1> = S$1 extends {
+type ConnectionMask<T$1 extends Entity, S> = S extends {
   items: infer ItemSelection;
   pagination?: infer PaginationSelection;
 } ? {
@@ -173,7 +173,7 @@ type EntityName<T$1> = T$1 extends {
   __typename: infer N extends string;
 } ? N : never;
 /** Recursively applies a view selection to an entity to mask fields that aren't selected. */
-type Mask<T$1, S$1> = T$1 extends Array<infer U extends Entity> ? S$1 extends true ? Array<U> : S$1 extends ConnectionSelection<U> ? ConnectionMask<U, S$1> : HasViewTag<S$1> extends true ? Array<ViewRef<U['__typename']>> : Array<Mask<U, S$1>> : S$1 extends true ? T$1 : S$1 extends object ? HasViewTag<S$1> extends true ? ViewRef<EntityName<NonNullable<T$1>>> : { [K in keyof S$1 as K extends 'args' ? never : K]: S$1[K] extends true ? NonNullable<T$1>[Extract<K, keyof T$1>] : Mask<NonNullable<T$1>[Extract<K, keyof T$1>], Extract<S$1[K], object>> } & (T$1 extends Entity ? Pick<NonNullable<T$1>, '__typename'> : Record<never, never>) : T$1;
+type Mask<T$1, S> = T$1 extends Array<infer U extends Entity> ? S extends true ? Array<U> : S extends ConnectionSelection<U> ? ConnectionMask<U, S> : HasViewTag<S> extends true ? Array<ViewRef<U['__typename']>> : Array<Mask<U, S>> : S extends true ? T$1 : S extends object ? HasViewTag<S> extends true ? ViewRef<EntityName<NonNullable<T$1>>> : { [K in keyof S as K extends 'args' ? never : K]: S[K] extends true ? NonNullable<T$1>[Extract<K, keyof T$1>] : Mask<NonNullable<T$1>[Extract<K, keyof T$1>], Extract<S[K], object>> } & (T$1 extends Entity ? Pick<NonNullable<T$1>, '__typename'> : Record<never, never>) : T$1;
 /** Entity type captured from a view definition. */
 type ViewEntity<V> = V extends View<infer T, any> ? T : never;
 /** Name of the entity type captured from a view definition. */
@@ -345,15 +345,15 @@ type SelectionPlan = {
  * Flattens a view into a `SelectionPlan`, expanding composed views and
  * partitioning nested args so the client can fetch exactly what is declared.
  */
-declare const getSelectionPlan: <T$1 extends Entity, S$1 extends Selection<T$1>, V extends View<T$1, S$1>>(viewComposition: V, ref: ViewRef<T$1["__typename"]> | null) => SelectionPlan;
+declare const getSelectionPlan: <T$1 extends Entity, S extends Selection<T$1>, V extends View<T$1, S>>(viewComposition: V, ref: ViewRef<T$1["__typename"]> | null) => SelectionPlan;
 //#endregion
 //#region src/cache.d.ts
 declare class ViewDataCache {
   private cache;
   private rootDependencies;
   private dependencyIndex;
-  get<T$1 extends Entity, S$1 extends Selection<T$1>, V extends View<T$1, S$1>>(entityId: EntityId, view: V, ref: ViewRef<T$1['__typename']>): FateThenable<ViewSnapshot<T$1, S$1>> | null;
-  set<T$1 extends Entity, S$1 extends Selection<T$1>, V extends View<T$1, S$1>>(entityId: EntityId, view: V, ref: ViewRef<T$1['__typename']>, thenable: FateThenable<ViewSnapshot<T$1, S$1>>, dependencies: ReadonlySet<EntityId>): void;
+  get<T$1 extends Entity, S extends Selection<T$1>, V extends View<T$1, S>>(entityId: EntityId, view: V, ref: ViewRef<T$1['__typename']>): FateThenable<ViewSnapshot<T$1, S>> | null;
+  set<T$1 extends Entity, S extends Selection<T$1>, V extends View<T$1, S>>(entityId: EntityId, view: V, ref: ViewRef<T$1['__typename']>, thenable: FateThenable<ViewSnapshot<T$1, S>>, dependencies: ReadonlySet<EntityId>): void;
   invalidate(entityId: EntityId): void;
   private invalidateDependents;
   private delete;
@@ -528,7 +528,7 @@ declare class FateClient<Mutations extends Record<string, MutationDefinition<any
     id: string | number;
     [ViewsTag]: Set<string>;
   }>;
-  readView<T$1 extends Entity, S$1 extends Selection<T$1>, V extends View<T$1, S$1>>(view: V, ref: ViewRef<T$1['__typename']>): FateThenable<ViewSnapshot<T$1, S$1>>;
+  readView<T$1 extends Entity, S extends Selection<T$1>, V extends View<T$1, S>>(view: V, ref: ViewRef<T$1['__typename']>): FateThenable<ViewSnapshot<T$1, S>>;
   private mergeListState;
   registerOptimisticUpdate(entityId: EntityId | null, select: ReadonlySet<string>): number | null;
   clearOptimisticUpdate(token: number | null): void;
@@ -570,7 +570,7 @@ declare function createClient<Mutations extends Record<string, MutationDefinitio
 declare const toEntityId: (type: TypeName, rawId: string | number) => EntityId;
 //#endregion
 //#region src/view.d.ts
-type SelectionValidation<T$1 extends Entity, S$1 extends Selection<T$1>> = Exclude<keyof Omit<S$1, typeof __FateEntityBrand | typeof __FateSelectionBrand>, keyof Selection<T$1>> extends never ? unknown : never;
+type SelectionValidation<T$1 extends Entity, S extends Selection<T$1>> = Exclude<keyof Omit<S, typeof __FateEntityBrand | typeof __FateSelectionBrand>, keyof Selection<T$1>> extends never ? unknown : never;
 /**
  * Creates a reusable view for an object using the declared selection.
  *
@@ -580,6 +580,6 @@ type SelectionValidation<T$1 extends Entity, S$1 extends Selection<T$1>> = Exclu
  *   title: true,
  * });
  */
-declare function view<T$1 extends Entity>(): <S$1 extends Selection<T$1>>(select: S$1 & SelectionValidation<T$1, S$1>) => View<T$1, S$1>;
+declare function view<T$1 extends Entity>(): <S extends Selection<T$1>>(select: S & SelectionValidation<T$1, S>) => View<T$1, S>;
 //#endregion
 export { type ConnectionMetadata, type ConnectionRef, ConnectionTag, type Entity, type EntityId, FateClient, type AnyRecord as FateRecord, type ListItem, type Mask, type MutationDefinition, type MutationEntity, type MutationIdentifier, type MutationInput, type MutationResult, type NodesItem, type Pagination, type Request, type RequestMode, type RequestOptions, type RequestResult, type Selection, type Snapshot, type Transport, type TypeConfig, type View, type ViewData, type ViewEntity, type ViewEntityName, type ViewRef, type ViewSelection, type ViewSnapshot, type ViewTag, createClient, createTRPCTransport, getSelectionPlan, isViewTag, mutation, toEntityId, view };

package/lib/server.d.mts

@@ -51,8 +51,8 @@ type DataViewConfig<Item$1 extends AnyRecord, Context> = Record<string, DataFiel
  *   title: true,
  * });
  */
-declare function dataView<Item$1 extends AnyRecord, Context = unknown>(typeName?: string): <Fields$1 extends DataViewConfig<Item$1, Context>>(fields: Fields$1) => DataView<Item$1, Context> & {
-  readonly [dataViewFieldsKey]: Fields$1;
+declare function dataView<Item$1 extends AnyRecord, Context = unknown>(typeName?: string): <Fields extends DataViewConfig<Item$1, Context>>(fields: Fields) => DataView<Item$1, Context> & {
+  readonly [dataViewFieldsKey]: Fields;
 };
 /**
  * Marks a data view as a list resolver so the server can respond with

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nkzw/fate",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "fate is a modern data client for React.",
   "homepage": "https://github.com/nkzw-tech/fate",
   "repository": {