@robelest/convex-auth 0.0.4-preview.32 → 0.0.4-preview.33

package/dist/server/validators.js

@@ -0,0 +1,59 @@
+import { vGroupDoc, vGroupInviteDoc, vGroupMemberDoc, vPaginated, vUserDoc } from "../component/model.js";
+import { v } from "convex/values";
+
+//#region src/server/validators.ts
+/**
+* Public Convex `returns:` validators for the auth read surface.
+*
+* These back the `auth.v` namespace on the {@link createAuth} result.
+* Consumers set them as their function `returns:` so client-side
+* `useQuery` inference flows end-to-end with zero hand-rolled validators
+* or DTO mappers. The `extend` field on User/Group/GroupMember is
+* replaced with the validator the consumer supplied via
+* `createAuth({ extend: { ... } })`, so `viewer.extend.<field>` is fully
+* typed instead of `any`.
+*
+* @module
+*/
+const docWithExtend = (fields, extend) => v.object({
+	...fields,
+	extend: v.optional(extend)
+});
+/**
+* Build the `auth.v.*` validator namespace from the consumer's `extend`
+* config.
+*
+* `vUserDoc`/`vGroupDoc`/`vGroupMemberDoc` already declare an
+* `extend: v.optional(v.any())` field; this rebuilds each with the
+* supplied validator so the inferred type carries the real shape while
+* the runtime validator still accepts the stored document.
+*
+* @typeParam TExtend - The consumer's per-table `extend` validators.
+* @param extend - The `extend` map from `createAuth` config. Defaults to
+*   an empty object (all `extend` fields stay `v.any()`).
+* @returns The `auth.v` namespace: `user`, `group`, `member`, `invite`,
+*   `viewer`, `viewerWithGroups`, and the `list` page-wrapper helper.
+*
+* @example
+* ```ts
+* const av = buildAuthValidators({
+*   User: v.object({ lastActiveGroup: v.optional(v.string()) }),
+* });
+* // Infer<typeof av.viewer> -> User document with typed `extend`
+* ```
+*/
+function buildAuthValidators(extend = {}) {
+	const user = docWithExtend(vUserDoc.fields, extend.User ?? v.any());
+	return {
+		user,
+		group: docWithExtend(vGroupDoc.fields, extend.Group ?? v.any()),
+		member: docWithExtend(vGroupMemberDoc.fields, extend.GroupMember ?? v.any()),
+		invite: vGroupInviteDoc,
+		viewer: v.union(user, v.null()),
+		list: vPaginated
+	};
+}
+
+//#endregion
+export { buildAuthValidators };
+//# sourceMappingURL=validators.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robelest/convex-auth",
-  "version": "0.0.4-preview.32",
+  "version": "0.0.4-preview.33",
   "description": "Authentication for Convex",
   "keywords": [
     "auth",