jazz-tools 0.15.16 → 0.16.1

package/src/tools/implementation/zodSchema/schemaTypes/CoMapSchema.ts

@@ -2,160 +2,184 @@ import { CoValueUniqueness } from "cojson";
 import {
   Account,
   CoMap,
+  DiscriminableCoValueSchemaDefinition,
+  DiscriminableCoreCoValueSchema,
   Group,
+  PartialOnUndefined,
   RefsToResolve,
   RefsToResolveStrict,
   Resolved,
   Simplify,
   SubscribeListenerOptions,
-  zodSchemaToCoSchema,
+  coOptionalDefiner,
+  hydrateCoreCoValueSchema,
+  isAnyCoValueSchema,
 } from "../../../internal.js";
 import { AnonymousJazzAgent } from "../../anonymousJazzAgent.js";
+import { removeGetters } from "../../schemaUtils.js";
+import { CoFieldInit } from "../typeConverters/CoFieldInit.js";
 import { InstanceOrPrimitiveOfSchema } from "../typeConverters/InstanceOrPrimitiveOfSchema.js";
 import { InstanceOrPrimitiveOfSchemaCoValuesNullable } from "../typeConverters/InstanceOrPrimitiveOfSchemaCoValuesNullable.js";
 import { z } from "../zodReExport.js";
-import { WithHelpers } from "../zodSchema.js";
+import { AnyZodOrCoValueSchema } from "../zodSchema.js";
+import { CoOptionalSchema } from "./CoOptionalSchema.js";
 
-export type CoMapSchema<
+export interface CoMapSchema<
   Shape extends z.core.$ZodLooseShape,
-  Config extends z.core.$ZodObjectConfig = z.core.$ZodObjectConfig,
+  CatchAll extends AnyZodOrCoValueSchema | unknown = unknown,
   Owner extends Account | Group = Account | Group,
-> = AnyCoMapSchema<Shape, Config> &
-  z.$ZodTypeDiscriminable & {
-    create: (
-      init: Simplify<CoMapInitZod<Shape>>,
-      options?:
-        | {
-            owner: Owner;
-            unique?: CoValueUniqueness["uniqueness"];
-          }
-        | Owner,
-    ) => (Shape extends Record<string, never>
-      ? {}
-      : {
-          -readonly [key in keyof Shape]: InstanceOrPrimitiveOfSchema<
-            Shape[key]
-          >;
-        }) &
-      (unknown extends Config["out"][string]
-        ? {}
-        : {
-            [key: string]: Config["out"][string];
-          }) &
-      CoMap;
-
-    load<
-      const R extends RefsToResolve<
-        Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap
-      > = true,
-    >(
-      id: string,
-      options?: {
-        resolve?: RefsToResolveStrict<
-          Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap,
-          R
-        >;
-        loadAs?: Account | AnonymousJazzAgent;
-        skipRetry?: boolean;
-      },
-    ): Promise<Resolved<
+> extends CoreCoMapSchema<Shape, CatchAll> {
+  create: (
+    init: Simplify<CoMapSchemaInit<Shape>>,
+    options?:
+      | {
+          owner: Owner;
+          unique?: CoValueUniqueness["uniqueness"];
+        }
+      | Owner,
+  ) => CoMapInstanceShape<Shape, CatchAll> & CoMap;
+
+  load<
+    const R extends RefsToResolve<
+      Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap
+    > = true,
+  >(
+    id: string,
+    options?: {
+      resolve?: RefsToResolveStrict<
+        Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap,
+        R
+      >;
+      loadAs?: Account | AnonymousJazzAgent;
+      skipRetry?: boolean;
+    },
+  ): Promise<Resolved<
+    Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap,
+    R
+  > | null>;
+
+  subscribe<
+    const R extends RefsToResolve<
+      Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap
+    > = true,
+  >(
+    id: string,
+    options: SubscribeListenerOptions<
       Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap,
       R
-    > | null>;
-
-    subscribe<
-      const R extends RefsToResolve<
-        Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap
-      > = true,
-    >(
-      id: string,
-      options: SubscribeListenerOptions<
+    >,
+    listener: (
+      value: Resolved<
         Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap,
         R
       >,
-      listener: (
-        value: Resolved<
-          Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap,
-          R
-        >,
-        unsubscribe: () => void,
-      ) => void,
-    ): () => void;
-
-    /** @deprecated Use `CoMap.upsertUnique` and `CoMap.loadUnique` instead. */
-    findUnique(
-      unique: CoValueUniqueness["uniqueness"],
-      ownerID: string,
-      as?: Account | Group | AnonymousJazzAgent,
-    ): string;
-
-    upsertUnique: <
-      const R extends RefsToResolve<
-        Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap
-      > = true,
-    >(options: {
-      value: Simplify<CoMapInitZod<Shape>>;
-      unique: CoValueUniqueness["uniqueness"];
-      owner: Owner;
+      unsubscribe: () => void,
+    ) => void,
+  ): () => void;
+
+  /** @deprecated Use `CoMap.upsertUnique` and `CoMap.loadUnique` instead. */
+  findUnique(
+    unique: CoValueUniqueness["uniqueness"],
+    ownerID: string,
+    as?: Account | Group | AnonymousJazzAgent,
+  ): string;
+
+  upsertUnique: <
+    const R extends RefsToResolve<
+      Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap
+    > = true,
+  >(options: {
+    value: Simplify<CoMapSchemaInit<Shape>>;
+    unique: CoValueUniqueness["uniqueness"];
+    owner: Owner;
+    resolve?: RefsToResolveStrict<
+      Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap,
+      R
+    >;
+  }) => Promise<Resolved<
+    Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap,
+    R
+  > | null>;
+
+  loadUnique<
+    const R extends RefsToResolve<
+      Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap
+    > = true,
+  >(
+    unique: CoValueUniqueness["uniqueness"],
+    ownerID: string,
+    options?: {
       resolve?: RefsToResolveStrict<
         Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap,
         R
       >;
-    }) => Promise<Resolved<
-      Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap,
-      R
-    > | null>;
-
-    loadUnique<
-      const R extends RefsToResolve<
-        Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap
-      > = true,
-    >(
-      unique: CoValueUniqueness["uniqueness"],
-      ownerID: string,
-      options?: {
-        resolve?: RefsToResolveStrict<
-          Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap,
-          R
-        >;
-        loadAs?: Account | AnonymousJazzAgent;
+      loadAs?: Account | AnonymousJazzAgent;
+    },
+  ): Promise<Resolved<
+    Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap,
+    R
+  > | null>;
+
+  catchall<T extends AnyZodOrCoValueSchema>(schema: T): CoMapSchema<Shape, T>;
+
+  withMigration(
+    migration: (
+      value: Resolved<
+        Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap,
+        true
+      >,
+    ) => undefined,
+  ): CoMapSchema<Shape, CatchAll, Owner>;
+
+  getCoValueClass: () => typeof CoMap;
+
+  optional(): CoOptionalSchema<this>;
+}
+
+export function createCoreCoMapSchema<
+  Shape extends z.core.$ZodLooseShape,
+  CatchAll extends AnyZodOrCoValueSchema | unknown = unknown,
+>(shape: Shape, catchAll?: CatchAll): CoreCoMapSchema<Shape, CatchAll> {
+  return {
+    collaborative: true as const,
+    builtin: "CoMap" as const,
+    shape,
+    catchAll,
+    getDefinition: () => ({
+      get shape() {
+        return shape;
       },
-    ): Promise<Resolved<
-      Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap,
-      R
-    > | null>;
-
-    catchall<T extends z.core.$ZodType>(
-      schema: T,
-    ): CoMapSchema<Shape, z.core.$catchall<T>>;
-
-    /** @deprecated Define your helper methods separately, in standalone functions. */
-    withHelpers<S extends z.core.$ZodType, T extends object>(
-      this: S,
-      helpers: (Self: S) => T,
-    ): WithHelpers<S, T>;
-
-    withMigration(
-      migration: (
-        value: Resolved<
-          Simplify<CoMapInstanceCoValuesNullable<Shape>> & CoMap,
-          true
-        >,
-      ) => undefined,
-    ): CoMapSchema<Shape, Config, Owner>;
-
-    getCoValueClass: () => typeof CoMap;
+      get catchall() {
+        return catchAll;
+      },
+      get discriminatorMap() {
+        const propValues: DiscriminableCoValueSchemaDefinition["discriminatorMap"] =
+          {};
+        // remove getters to avoid circularity issues. Getters are not used as discriminators
+        for (const key in removeGetters(shape)) {
+          if (isAnyCoValueSchema(shape[key])) {
+            // CoValues cannot be used as discriminators either
+            continue;
+          }
+          const field = shape[key]._zod;
+          if (field.values) {
+            propValues[key] ??= new Set();
+            for (const v of field.values) propValues[key].add(v);
+          }
+        }
+        return propValues;
+      },
+    }),
   };
+}
 
 export function enrichCoMapSchema<
   Shape extends z.core.$ZodLooseShape,
-  Config extends z.core.$ZodObjectConfig,
+  CatchAll extends AnyZodOrCoValueSchema | unknown,
 >(
-  schema: AnyCoMapSchema<Shape, Config>,
+  schema: CoreCoMapSchema<Shape, CatchAll>,
   coValueClass: typeof CoMap,
-): CoMapSchema<Shape, Config> {
-  // @ts-expect-error schema is actually a z.ZodObject, but we need to use z.core.$ZodObject to avoid circularity issues
-  const baseCatchall = schema.catchall;
+): CoMapSchema<Shape, CatchAll> {
   const coValueSchema = Object.assign(schema, {
     create: (...args: [any, ...any[]]) => {
       return coValueClass.create(...args);
@@ -179,16 +203,12 @@ export function enrichCoMapSchema<
       // @ts-expect-error
       return coValueClass.loadUnique(...args);
     },
-    catchall: (index: z.core.$ZodType) => {
-      const newSchema = baseCatchall(index);
-      // TODO avoid repeating this with coMapDefiner
-      const enrichedSchema = Object.assign(newSchema, {
-        collaborative: true,
-      }) as AnyCoMapSchema<Shape, Config>;
-      return zodSchemaToCoSchema(enrichedSchema);
-    },
-    withHelpers: (helpers: (Self: z.core.$ZodType) => object) => {
-      return Object.assign(schema, helpers(schema));
+    catchall: (catchAll: AnyZodOrCoValueSchema) => {
+      const schemaWithCatchAll = createCoreCoMapSchema(
+        coValueSchema.getDefinition().shape,
+        catchAll,
+      );
+      return hydrateCoreCoValueSchema(schemaWithCatchAll);
     },
     withMigration: (migration: (value: any) => undefined) => {
       // @ts-expect-error TODO check
@@ -199,41 +219,50 @@ export function enrichCoMapSchema<
     getCoValueClass: () => {
       return coValueClass;
     },
-  }) as unknown as CoMapSchema<Shape, Config>;
+
+    optional: () => {
+      return coOptionalDefiner(coValueSchema);
+    },
+  }) as unknown as CoMapSchema<Shape, CatchAll>;
   return coValueSchema;
 }
 
-export type optionalKeys<Shape extends z.core.$ZodLooseShape> = {
-  [key in keyof Shape]: Shape[key] extends z.core.$ZodOptional<any>
-    ? key
-    : never;
-}[keyof Shape];
-
-export type requiredKeys<Shape extends z.core.$ZodLooseShape> = {
-  [key in keyof Shape]: Shape[key] extends z.core.$ZodOptional<any>
-    ? never
-    : key;
-}[keyof Shape];
-
-export type CoMapInitZod<Shape extends z.core.$ZodLooseShape> = {
-  [key in optionalKeys<Shape>]?: NonNullable<
-    InstanceOrPrimitiveOfSchemaCoValuesNullable<Shape[key]>
-  >;
-} & {
-  [key in requiredKeys<Shape>]: NonNullable<
-    InstanceOrPrimitiveOfSchemaCoValuesNullable<Shape[key]>
-  >;
-} & { [key in keyof Shape]?: unknown };
+// Due to a TS limitation with types that contain known properties and
+// an index signature, we cannot accept catchall properties on creation
+export type CoMapSchemaInit<Shape extends z.core.$ZodLooseShape> =
+  PartialOnUndefined<{
+    [key in keyof Shape]: CoFieldInit<Shape[key]>;
+  }>;
+
+export interface CoMapSchemaDefinition<
+  Shape extends z.core.$ZodLooseShape = z.core.$ZodLooseShape,
+  CatchAll extends AnyZodOrCoValueSchema | unknown = unknown,
+> extends DiscriminableCoValueSchemaDefinition {
+  shape: Shape;
+  catchall?: CatchAll;
+}
 
 // less precise version to avoid circularity issues and allow matching against
-export type AnyCoMapSchema<
+export interface CoreCoMapSchema<
   Shape extends z.core.$ZodLooseShape = z.core.$ZodLooseShape,
-  Config extends z.core.$ZodObjectConfig = z.core.$ZodObjectConfig,
-> = z.core.$ZodObject<Shape, Config> & { collaborative: true };
+  CatchAll extends AnyZodOrCoValueSchema | unknown = unknown,
+> extends DiscriminableCoreCoValueSchema {
+  builtin: "CoMap";
+  shape: Shape;
+  catchAll?: CatchAll;
+  getDefinition: () => CoMapSchemaDefinition;
+}
 
-export type CoMapInstance<Shape extends z.core.$ZodLooseShape> = {
+export type CoMapInstanceShape<
+  Shape extends z.core.$ZodLooseShape,
+  CatchAll extends AnyZodOrCoValueSchema | unknown = unknown,
+> = {
   -readonly [key in keyof Shape]: InstanceOrPrimitiveOfSchema<Shape[key]>;
-} & CoMap;
+} & (CatchAll extends AnyZodOrCoValueSchema
+  ? {
+      [key: string]: InstanceOrPrimitiveOfSchema<CatchAll>;
+    }
+  : {});
 
 export type CoMapInstanceCoValuesNullable<Shape extends z.core.$ZodLooseShape> =
   {

package/src/tools/implementation/zodSchema/schemaTypes/CoOptionalSchema.ts

@@ -1,33 +1,35 @@
-import { isAnyCoValueSchema } from "../runtimeConverters/zodSchemaToCoSchema.js";
-import { z } from "../zodReExport.js";
-import { AnyCoSchema, CoValueSchemaFromZodSchema } from "../zodSchema.js";
+import { CoValueSchemaFromCoreSchema } from "../zodSchema.js";
+import { CoreCoValueSchema } from "./CoValueSchema.js";
 
-export type AnyCoOptionalSchema<
-  Shape extends z.core.$ZodType = z.core.$ZodType,
-> = z.ZodOptional<Shape> & {
-  collaborative: true;
+type CoOptionalSchemaDefinition<
+  Shape extends CoreCoValueSchema = CoreCoValueSchema,
+> = {
+  innerType: Shape;
 };
 
-export type CoOptionalSchema<Shape extends z.core.$ZodType = z.core.$ZodType> =
-  AnyCoOptionalSchema<Shape> & {
-    getCoValueClass: () => CoValueSchemaFromZodSchema<AnyCoSchema>["getCoValueClass"];
-  };
-
-export function createCoOptionalSchema<T extends AnyCoSchema>(
-  schema: T,
-): CoOptionalSchema<T> {
-  return Object.assign(z.optional(schema), {
-    collaborative: true,
-    getCoValueClass: () => {
-      return (
-        schema as CoValueSchemaFromZodSchema<AnyCoSchema>
-      ).getCoValueClass();
-    },
-  }) as unknown as CoOptionalSchema<T>;
+export interface CoreCoOptionalSchema<
+  Shape extends CoreCoValueSchema = CoreCoValueSchema,
+> extends CoreCoValueSchema {
+  builtin: "CoOptional";
+  innerType: Shape;
+  getDefinition: () => CoOptionalSchemaDefinition<Shape>;
 }
 
-export function isAnyCoOptionalSchema(
-  schema: z.core.$ZodType,
-): schema is CoOptionalSchema<z.core.$ZodType> {
-  return isAnyCoValueSchema(schema) && schema._zod.def.type === "optional";
+export class CoOptionalSchema<
+  Shape extends CoreCoValueSchema = CoreCoValueSchema,
+> implements CoreCoOptionalSchema<Shape>
+{
+  readonly collaborative = true as const;
+  readonly builtin = "CoOptional" as const;
+  readonly getDefinition = () => ({
+    innerType: this.innerType,
+  });
+
+  constructor(public readonly innerType: Shape) {}
+
+  getCoValueClass(): ReturnType<
+    CoValueSchemaFromCoreSchema<Shape>["getCoValueClass"]
+  > {
+    return (this.innerType as any).getCoValueClass();
+  }
 }

package/src/tools/implementation/zodSchema/schemaTypes/CoRecordSchema.ts

@@ -2,6 +2,7 @@ import { CoValueUniqueness } from "cojson";
 import {
   Account,
   type CoMap,
+  CoMapSchemaDefinition,
   Group,
   ID,
   RefsToResolve,
@@ -11,24 +12,25 @@ import {
   SubscribeListenerOptions,
 } from "../../../internal.js";
 import { AnonymousJazzAgent } from "../../anonymousJazzAgent.js";
+import { CoFieldInit } from "../typeConverters/CoFieldInit.js";
 import { InstanceOrPrimitiveOfSchema } from "../typeConverters/InstanceOrPrimitiveOfSchema.js";
 import { InstanceOrPrimitiveOfSchemaCoValuesNullable } from "../typeConverters/InstanceOrPrimitiveOfSchemaCoValuesNullable.js";
 import { z } from "../zodReExport.js";
-import { WithHelpers } from "../zodSchema.js";
+import { AnyZodOrCoValueSchema } from "../zodSchema.js";
+import { CoOptionalSchema } from "./CoOptionalSchema.js";
+import { CoreCoValueSchema } from "./CoValueSchema.js";
 
 type CoRecordInit<
   K extends z.core.$ZodString<string>,
-  V extends z.core.$ZodType,
+  V extends AnyZodOrCoValueSchema,
 > = {
-  [key in z.output<K>]: V extends z.core.$ZodOptional<any>
-    ? InstanceOrPrimitiveOfSchemaCoValuesNullable<V>
-    : NonNullable<InstanceOrPrimitiveOfSchemaCoValuesNullable<V>>;
+  [key in z.output<K>]: CoFieldInit<V>;
 };
 
-export type CoRecordSchema<
+export interface CoRecordSchema<
   K extends z.core.$ZodString<string>,
-  V extends z.core.$ZodType,
-> = AnyCoRecordSchema<K, V> & {
+  V extends AnyZodOrCoValueSchema,
+> extends CoreCoRecordSchema<K, V> {
   create: (
     init: Simplify<CoRecordInit<K, V>>,
     options?:
@@ -76,30 +78,38 @@ export type CoRecordSchema<
     as?: Account | Group | AnonymousJazzAgent,
   ): ID<CoRecordInstanceCoValuesNullable<K, V>>;
 
-  /** @deprecated Define your helper methods separately, in standalone functions. */
-  withHelpers<S extends z.core.$ZodType, T extends object>(
-    this: S,
-    helpers: (Self: S) => T,
-  ): WithHelpers<S, T>;
   getCoValueClass: () => typeof CoMap;
+
+  optional(): CoOptionalSchema<this>;
+}
+
+type CoRecordSchemaDefinition<
+  K extends z.core.$ZodString<string>,
+  V extends AnyZodOrCoValueSchema,
+> = CoMapSchemaDefinition & {
+  keyType: K;
+  valueType: V;
 };
 
 // less precise version to avoid circularity issues and allow matching against
-export type AnyCoRecordSchema<
+export interface CoreCoRecordSchema<
   K extends z.core.$ZodString<string> = z.core.$ZodString<string>,
-  V extends z.core.$ZodType = z.core.$ZodType,
-> = z.core.$ZodRecord<K, V> & { collaborative: true };
+  V extends AnyZodOrCoValueSchema = AnyZodOrCoValueSchema,
+> extends CoreCoValueSchema {
+  builtin: "CoMap";
+  getDefinition: () => CoRecordSchemaDefinition<K, V>;
+}
 
 export type CoRecordInstance<
   K extends z.core.$ZodString<string>,
-  V extends z.core.$ZodType,
+  V extends AnyZodOrCoValueSchema,
 > = {
   [key in z.output<K>]: InstanceOrPrimitiveOfSchema<V>;
 } & CoMap;
 
 export type CoRecordInstanceCoValuesNullable<
   K extends z.core.$ZodString<string>,
-  V extends z.core.$ZodType,
+  V extends AnyZodOrCoValueSchema,
 > = {
   [key in z.output<K>]: InstanceOrPrimitiveOfSchemaCoValuesNullable<V>;
 } & CoMap;

package/src/tools/implementation/zodSchema/schemaTypes/CoValueSchema.ts

@@ -0,0 +1,18 @@
+/**
+ * "Core" CoValue schemas contain all data necessary to represent a CoValue schema.
+ * Behavior is provided by CoValue schemas that extend "core" CoValue schema data structures.
+ *
+ * "Core" CoValue schemas are necessary to avoid circularity issues when defining schemas.
+ * This is similar to how Zod's "core" schemas are used.
+ *
+ * They are not meant to be used directly outside of the `jazz-tools` package,
+ * use concrete CoValue schemas instead.
+ */
+export interface CoreCoValueSchema {
+  collaborative: true;
+
+  /**
+   * Used for discriminating between different CoValue schemas.
+   */
+  builtin: string;
+}