npm - @graffiti-garden/wrapper-synchronize - Versions diffs - 1.0.4 → 1.0.8 - Mend

@graffiti-garden/wrapper-synchronize 1.0.4 → 1.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/dist/cjs/index.js CHANGED Viewed

@@ -1,9 +1,7 @@
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -17,14 +15,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var index_exports = {};
 __export(index_exports, {
@@ -34,7 +24,6 @@ module.exports = __toCommonJS(index_exports);
 var import_api = require("@graffiti-garden/api");
 var import_repeater = require("@repeaterjs/repeater");
 class GraffitiSynchronize {
-  ajv_;
   graffiti;
   callbacks = /* @__PURE__ */ new Set();
   options;
@@ -46,15 +35,6 @@ class GraffitiSynchronize {
   deleteMedia;
   actorToHandle;
   handleToActor;
-  get ajv() {
-    if (!this.ajv_) {
-      this.ajv_ = (async () => {
-        const { default: Ajv } = await import("ajv");
-        return new Ajv({ strict: false });
-      })();
-    }
-    return this.ajv_;
-  }
   /**
    * Wraps a Graffiti API instance to provide the synchronize methods.
    * The GraffitiSyncrhonize class rather than the Graffiti class
@@ -75,7 +55,7 @@ class GraffitiSynchronize {
   synchronize(matchObject, channels, schema, session, seenUrls = /* @__PURE__ */ new Set()) {
     const repeater = new import_repeater.Repeater(
       async (push, stop) => {
-        const validate = compileGraffitiObjectSchema(await this.ajv, schema);
+        const validate = await (0, import_api.compileGraffitiObjectSchema)(schema);
         const callback = (objectUpdate) => {
           if (objectUpdate?.tombstone) {
             if (seenUrls.has(objectUpdate.object.url)) {
@@ -244,13 +224,4 @@ class GraffitiSynchronize {
     return this.objectStreamContinue(iterator);
   };
 }
-function compileGraffitiObjectSchema(ajv, schema) {
-  try {
-    return ajv.compile(schema);
-  } catch (error) {
-    throw new import_api.GraffitiErrorInvalidSchema(
-      error instanceof Error ? error.message : String(error)
-    );
-  }
-}
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/index.ts"],
-  "sourcesContent": ["import type Ajv from \"ajv\";\nimport type {\n  Graffiti,\n  GraffitiSession,\n  JSONSchema,\n  GraffitiObjectBase,\n  GraffitiObjectStream,\n  GraffitiObjectStreamContinueEntry,\n  GraffitiObjectStreamContinue,\n  GraffitiObjectUrl,\n  GraffitiObject,\n} from \"@graffiti-garden/api\";\nimport {\n  GraffitiErrorInvalidSchema,\n  GraffitiErrorNotFound,\n  isActorAllowedGraffitiObject,\n  maskGraffitiObject,\n  unpackObjectUrl,\n} from \"@graffiti-garden/api\";\nimport { Repeater } from \"@repeaterjs/repeater\";\nexport type * from \"@graffiti-garden/api\";\n\nexport type GraffitiSynchronizeCallback = (\n  object: GraffitiObjectStreamContinueEntry<{}>,\n) => void;\n\nexport interface GraffitiSynchronizeOptions {\n  /**\n   * Allows synchronize to listen to all objects, not just those\n   * that the session is allowed to see. This is useful to get a\n   * global view of all Graffiti objects passsing through the system,\n   * for example to build a client-side cache. Additional mechanisms\n   * should be in place to ensure that users do not see objects or\n   * properties they are not allowed to see.\n   *\n   * Default: `false`\n   */\n  omniscient?: boolean;\n}\n\n/**\n * Wraps the [Graffiti API](https://api.graffiti.garden/classes/Graffiti.html)\n * so that changes made or received in one part of an application\n * are automatically routed to other parts of the application.\n * This is an important tool for building responsive\n * and consistent user interfaces, and is built upon to make\n * the [Graffiti Vue Plugin](https://vue.graffiti.garden/variables/GraffitiPlugin.html)\n * and possibly other front-end libraries in the future.\n *\n * [See a live example](/example).\n *\n * Specifically, this library provides the following *synchronize*\n * methods to correspond with each of the following Graffiti API methods:\n *\n * | API Method | Synchronize Method |\n * |------------|--------------------|\n * | {@link get} | {@link synchronizeGet} |\n * | {@link discover} | {@link synchronizeDiscover} |\n *\n * Whenever a change is made via {@link post} and {@link delete} or\n * received from {@link get}, {@link discover}, and {@link continueDiscover},\n * those changes are forwarded to the appropriate synchronize method.\n * Each synchronize method returns an iterator that streams these changes\n * continually until the user calls `return` on the iterator or `break`s out of the loop,\n * allowing for live updates without additional polling.\n *\n * Example 1: Suppose a user publishes a post using {@link post}. If the feed\n * displaying that user's posts is using {@link synchronizeDiscover} to listen for changes,\n * then the user's new post will instantly appear in their feed, giving the UI a\n * responsive feel.\n *\n * Example 2: Suppose one of a user's friends changes their name. As soon as the\n * user's application receives one notice of that change (using {@link get}\n * or {@link discover}), then {@link synchronizeDiscover} listeners can be used to update\n * all instance's of that friend's name in the user's application instantly,\n * providing a consistent user experience.\n *\n * Additionally, the library supplies a {@link synchronizeAll} method that can be used\n * to stream all the Graffiti changes that an application is aware of, which can be used\n * for caching or history building.\n *\n * The source code for this library is [available on GitHub](https://github.com/graffiti-garden/wrapper-synchronize/).\n *\n * @groupDescription 0 - Synchronize Methods\n * This group contains methods that listen for changes made via\n * {@link post}, and {@link delete} or fetched from\n * {@link get}, {@link discover}, or {@link continueDiscover} and then\n * streams appropriate changes to provide a responsive and consistent user experience.\n */\nexport class GraffitiSynchronize implements Graffiti {\n  protected ajv_: Promise<Ajv> | undefined;\n  protected readonly graffiti: Graffiti;\n  protected readonly callbacks = new Set<GraffitiSynchronizeCallback>();\n  protected readonly options: GraffitiSynchronizeOptions;\n\n  login: Graffiti[\"login\"];\n  logout: Graffiti[\"logout\"];\n  sessionEvents: Graffiti[\"sessionEvents\"];\n  postMedia: Graffiti[\"postMedia\"];\n  getMedia: Graffiti[\"getMedia\"];\n  deleteMedia: Graffiti[\"deleteMedia\"];\n  actorToHandle: Graffiti[\"actorToHandle\"];\n  handleToActor: Graffiti[\"handleToActor\"];\n\n  protected get ajv() {\n    if (!this.ajv_) {\n      this.ajv_ = (async () => {\n        const { default: Ajv } = await import(\"ajv\");\n        return new Ajv({ strict: false });\n      })();\n    }\n    return this.ajv_;\n  }\n\n  /**\n   * Wraps a Graffiti API instance to provide the synchronize methods.\n   * The GraffitiSyncrhonize class rather than the Graffiti class\n   * must be used for all functions for the synchronize methods to work.\n   */\n  constructor(\n    /**\n     * The [Graffiti API](https://api.graffiti.garden/classes/Graffiti.html)\n     * instance to wrap.\n     */\n    graffiti: Graffiti,\n    options?: GraffitiSynchronizeOptions,\n  ) {\n    this.options = options ?? {};\n    this.graffiti = graffiti;\n    this.login = graffiti.login.bind(graffiti);\n    this.logout = graffiti.logout.bind(graffiti);\n    this.sessionEvents = graffiti.sessionEvents;\n    this.postMedia = graffiti.postMedia.bind(graffiti);\n    this.getMedia = graffiti.getMedia.bind(graffiti);\n    this.deleteMedia = graffiti.deleteMedia.bind(graffiti);\n    this.actorToHandle = graffiti.actorToHandle.bind(graffiti);\n    this.handleToActor = graffiti.handleToActor.bind(graffiti);\n  }\n\n  protected synchronize<Schema extends JSONSchema>(\n    matchObject: (object: GraffitiObjectBase) => boolean,\n    channels: string[],\n    schema: Schema,\n    session?: GraffitiSession | null,\n    seenUrls: Set<string> = new Set<string>(),\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    const repeater = new Repeater<GraffitiObjectStreamContinueEntry<Schema>>(\n      async (push, stop) => {\n        const validate = compileGraffitiObjectSchema(await this.ajv, schema);\n        const callback: GraffitiSynchronizeCallback = (objectUpdate) => {\n          if (objectUpdate?.tombstone) {\n            if (seenUrls.has(objectUpdate.object.url)) {\n              push(objectUpdate);\n            }\n          } else if (\n            objectUpdate &&\n            matchObject(objectUpdate.object) &&\n            (this.options.omniscient ||\n              isActorAllowedGraffitiObject(objectUpdate.object, session))\n          ) {\n            // Deep clone the object to prevent mutation\n            let object = JSON.parse(\n              JSON.stringify(objectUpdate.object),\n            ) as GraffitiObjectBase;\n            if (!this.options.omniscient) {\n              object = maskGraffitiObject(object, channels, session?.actor);\n            }\n            if (validate(object)) {\n              push({ object });\n              seenUrls.add(object.url);\n            }\n          }\n        };\n\n        this.callbacks.add(callback);\n        await stop;\n        this.callbacks.delete(callback);\n      },\n    );\n\n    return (async function* () {\n      for await (const i of repeater) yield i;\n    })();\n  }\n\n  /**\n   * This method has the same signature as {@link discover} but listens for\n   * changes made via {@link post} and {@link delete} or\n   * fetched from {@link get}, {@link discover}, and {@link continueDiscover}\n   * and then streams appropriate changes to provide a responsive and\n   * consistent user experience.\n   *\n   * Unlike {@link discover}, this method continuously listens for changes\n   * and will not terminate unless the user calls the `return` method on the iterator\n   * or `break`s out of the loop.\n   *\n   * @group 0 - Synchronize Methods\n   */\n  synchronizeDiscover<Schema extends JSONSchema>(\n    channels: string[],\n    schema: Schema,\n    session?: GraffitiSession | null,\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    function matchObject(object: GraffitiObjectBase) {\n      return object.channels.some((channel) => channels.includes(channel));\n    }\n    return this.synchronize<Schema>(matchObject, channels, schema, session);\n  }\n\n  /**\n   * This method has the same signature as {@link get} but\n   * listens for changes made via {@link post}, and {@link delete} or\n   * fetched from {@link get}, {@link discover}, and {@link continueDiscover} and then\n   * streams appropriate changes to provide a responsive and consistent user experience.\n   *\n   * Unlike {@link get}, which returns a single result, this method continuously\n   * listens for changes which are output as an asynchronous stream, similar\n   * to {@link discover}.\n   *\n   * @group 0 - Synchronize Methods\n   */\n  synchronizeGet<Schema extends JSONSchema>(\n    objectUrl: string | GraffitiObjectUrl,\n    schema: Schema,\n    session?: GraffitiSession | null | undefined,\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    const url = unpackObjectUrl(objectUrl);\n    function matchObject(object: GraffitiObjectBase) {\n      return object.url === url;\n    }\n    return this.synchronize<Schema>(\n      matchObject,\n      [],\n      schema,\n      session,\n      new Set<string>([url]),\n    );\n  }\n\n  /**\n   * Streams changes made to *any* object in *any* channel\n   * and made by *any* user. You may want to use it in conjuction with\n   * {@link GraffitiSynchronizeOptions.omniscient} to get a global view\n   * of all Graffiti objects passing through the system. This is useful\n   * for building a client-side cache, for example.\n   *\n   * Be careful using this method. Without additional filters it can\n   * expose the user to content out of context.\n   *\n   * @group 0 - Synchronize Methods\n   */\n  synchronizeAll<Schema extends JSONSchema>(\n    schema: Schema,\n    session?: GraffitiSession | null,\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    return this.synchronize<Schema>(() => true, [], schema, session);\n  }\n\n  protected async synchronizeDispatch(\n    objectUpdate: GraffitiObjectStreamContinueEntry<{}>,\n    waitForListeners = false,\n  ) {\n    for (const callback of this.callbacks) {\n      callback(objectUpdate);\n    }\n    if (waitForListeners) {\n      // Wait for the listeners to receive\n      // their objects, before returning the operation\n      // that triggered them.\n      //\n      // This is important for mutators (put, patch, delete)\n      // to ensure the application state has been updated\n      // everywhere before returning, giving consistent\n      // feedback to the user that the operation has completed.\n      //\n      // The opposite is true for accessors (get, discover, recoverOrphans),\n      // where it is a weird user experience to call `get`\n      // in one place and have the application update\n      // somewhere else first. It is also less efficient.\n      //\n      // The hack is simply to await one \"macro task cycle\".\n      // We need to wait for this cycle rather than using\n      // `await push` in the callback, because it turns out\n      // that `await push` won't resolve until the following\n      // .next() call of the iterator, so if only\n      // one .next() is called, this dispatch will hang.\n      await new Promise((resolve) => setTimeout(resolve, 0));\n    }\n  }\n\n  get: Graffiti[\"get\"] = async (...args) => {\n    try {\n      const object = await this.graffiti.get(...args);\n      this.synchronizeDispatch({ object });\n      return object;\n    } catch (error) {\n      if (error instanceof GraffitiErrorNotFound) {\n        this.synchronizeDispatch({\n          tombstone: true,\n          object: { url: unpackObjectUrl(args[0]) },\n        });\n      }\n      throw error;\n    }\n  };\n\n  post: Graffiti[\"post\"] = async (...args) => {\n    // @ts-ignore\n    const object = await this.graffiti.post(...args);\n    await this.synchronizeDispatch({ object }, true);\n    return object;\n  };\n\n  delete: Graffiti[\"delete\"] = async (...args) => {\n    const update = {\n      tombstone: true,\n      object: { url: unpackObjectUrl(args[0]) },\n    } as const;\n    try {\n      const oldObject = await this.graffiti.delete(...args);\n      await this.synchronizeDispatch(update, true);\n      return oldObject;\n    } catch (error) {\n      if (error instanceof GraffitiErrorNotFound) {\n        await this.synchronizeDispatch(update, true);\n      }\n      throw error;\n    }\n  };\n\n  protected objectStreamContinue<Schema extends JSONSchema>(\n    iterator: GraffitiObjectStreamContinue<Schema>,\n  ): GraffitiObjectStreamContinue<Schema> {\n    const this_ = this;\n    return (async function* () {\n      while (true) {\n        const result = await iterator.next();\n        if (result.done) {\n          const { continue: continue_, cursor } = result.value;\n          return {\n            continue: (session?: GraffitiSession | null) =>\n              this_.objectStreamContinue<Schema>(continue_(session)),\n            cursor,\n          };\n        }\n        if (!result.value.error) {\n          this_.synchronizeDispatch(result.value);\n        }\n        yield result.value;\n      }\n    })();\n  }\n\n  protected objectStream<Schema extends JSONSchema>(\n    iterator: GraffitiObjectStream<Schema>,\n  ): GraffitiObjectStream<Schema> {\n    const wrapped = this.objectStreamContinue<Schema>(iterator);\n    return (async function* () {\n      // Filter out the tombstones for type safety\n      while (true) {\n        const result = await wrapped.next();\n        if (result.done) return result.value;\n        if (result.value.error || !result.value.tombstone) yield result.value;\n      }\n    })();\n  }\n\n  discover: Graffiti[\"discover\"] = (...args) => {\n    const iterator = this.graffiti.discover(...args);\n    return this.objectStream<(typeof args)[1]>(iterator);\n  };\n\n  continueDiscover: Graffiti[\"continueDiscover\"] = (...args) => {\n    const iterator = this.graffiti.continueDiscover(...args);\n    return this.objectStreamContinue<{}>(iterator);\n  };\n}\n\nfunction compileGraffitiObjectSchema<Schema extends JSONSchema>(\n  ajv: Ajv,\n  schema: Schema,\n) {\n  try {\n    // Force the validation guard because\n    // it is too big for the type checker.\n    // Fortunately json-schema-to-ts is\n    // well tested against ajv.\n    return ajv.compile(schema) as (\n      data: GraffitiObjectBase,\n    ) => data is GraffitiObject<Schema>;\n  } catch (error) {\n    throw new GraffitiErrorInvalidSchema(\n      error instanceof Error ? error.message : String(error),\n    );\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type {\n  Graffiti,\n  GraffitiSession,\n  JSONSchema,\n  GraffitiObjectBase,\n  GraffitiObjectStream,\n  GraffitiObjectStreamContinueEntry,\n  GraffitiObjectStreamContinue,\n  GraffitiObjectUrl,\n} from \"@graffiti-garden/api\";\nimport {\n  compileGraffitiObjectSchema,\n  GraffitiErrorNotFound,\n  isActorAllowedGraffitiObject,\n  maskGraffitiObject,\n  unpackObjectUrl,\n} from \"@graffiti-garden/api\";\nimport { Repeater } from \"@repeaterjs/repeater\";\nexport type * from \"@graffiti-garden/api\";\n\nexport type GraffitiSynchronizeCallback = (\n  object: GraffitiObjectStreamContinueEntry<{}>,\n) => void;\n\nexport interface GraffitiSynchronizeOptions {\n  /**\n   * Allows synchronize to listen to all objects, not just those\n   * that the session is allowed to see. This is useful to get a\n   * global view of all Graffiti objects passsing through the system,\n   * for example to build a client-side cache. Additional mechanisms\n   * should be in place to ensure that users do not see objects or\n   * properties they are not allowed to see.\n   *\n   * Default: `false`\n   */\n  omniscient?: boolean;\n}\n\n/**\n * Wraps the [Graffiti API](https://api.graffiti.garden/classes/Graffiti.html)\n * so that changes made or received in one part of an application\n * are automatically routed to other parts of the application.\n * This is an important tool for building responsive\n * and consistent user interfaces, and is built upon to make\n * the [Graffiti Vue Plugin](https://vue.graffiti.garden/variables/GraffitiPlugin.html)\n * and possibly other front-end libraries in the future.\n *\n * [See a live example](/example).\n *\n * Specifically, this library provides the following *synchronize*\n * methods to correspond with each of the following Graffiti API methods:\n *\n * | API Method | Synchronize Method |\n * |------------|--------------------|\n * | {@link get} | {@link synchronizeGet} |\n * | {@link discover} | {@link synchronizeDiscover} |\n *\n * Whenever a change is made via {@link post} and {@link delete} or\n * received from {@link get}, {@link discover}, and {@link continueDiscover},\n * those changes are forwarded to the appropriate synchronize method.\n * Each synchronize method returns an iterator that streams these changes\n * continually until the user calls `return` on the iterator or `break`s out of the loop,\n * allowing for live updates without additional polling.\n *\n * Example 1: Suppose a user publishes a post using {@link post}. If the feed\n * displaying that user's posts is using {@link synchronizeDiscover} to listen for changes,\n * then the user's new post will instantly appear in their feed, giving the UI a\n * responsive feel.\n *\n * Example 2: Suppose one of a user's friends changes their name. As soon as the\n * user's application receives one notice of that change (using {@link get}\n * or {@link discover}), then {@link synchronizeDiscover} listeners can be used to update\n * all instance's of that friend's name in the user's application instantly,\n * providing a consistent user experience.\n *\n * Additionally, the library supplies a {@link synchronizeAll} method that can be used\n * to stream all the Graffiti changes that an application is aware of, which can be used\n * for caching or history building.\n *\n * The source code for this library is [available on GitHub](https://github.com/graffiti-garden/wrapper-synchronize/).\n *\n * @groupDescription 0 - Synchronize Methods\n * This group contains methods that listen for changes made via\n * {@link post}, and {@link delete} or fetched from\n * {@link get}, {@link discover}, or {@link continueDiscover} and then\n * streams appropriate changes to provide a responsive and consistent user experience.\n */\nexport class GraffitiSynchronize implements Graffiti {\n  protected readonly graffiti: Graffiti;\n  protected readonly callbacks = new Set<GraffitiSynchronizeCallback>();\n  protected readonly options: GraffitiSynchronizeOptions;\n\n  login: Graffiti[\"login\"];\n  logout: Graffiti[\"logout\"];\n  sessionEvents: Graffiti[\"sessionEvents\"];\n  postMedia: Graffiti[\"postMedia\"];\n  getMedia: Graffiti[\"getMedia\"];\n  deleteMedia: Graffiti[\"deleteMedia\"];\n  actorToHandle: Graffiti[\"actorToHandle\"];\n  handleToActor: Graffiti[\"handleToActor\"];\n\n  /**\n   * Wraps a Graffiti API instance to provide the synchronize methods.\n   * The GraffitiSyncrhonize class rather than the Graffiti class\n   * must be used for all functions for the synchronize methods to work.\n   */\n  constructor(\n    /**\n     * The [Graffiti API](https://api.graffiti.garden/classes/Graffiti.html)\n     * instance to wrap.\n     */\n    graffiti: Graffiti,\n    options?: GraffitiSynchronizeOptions,\n  ) {\n    this.options = options ?? {};\n    this.graffiti = graffiti;\n    this.login = graffiti.login.bind(graffiti);\n    this.logout = graffiti.logout.bind(graffiti);\n    this.sessionEvents = graffiti.sessionEvents;\n    this.postMedia = graffiti.postMedia.bind(graffiti);\n    this.getMedia = graffiti.getMedia.bind(graffiti);\n    this.deleteMedia = graffiti.deleteMedia.bind(graffiti);\n    this.actorToHandle = graffiti.actorToHandle.bind(graffiti);\n    this.handleToActor = graffiti.handleToActor.bind(graffiti);\n  }\n\n  protected synchronize<Schema extends JSONSchema>(\n    matchObject: (object: GraffitiObjectBase) => boolean,\n    channels: string[],\n    schema: Schema,\n    session?: GraffitiSession | null,\n    seenUrls: Set<string> = new Set<string>(),\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    const repeater = new Repeater<GraffitiObjectStreamContinueEntry<Schema>>(\n      async (push, stop) => {\n        const validate = await compileGraffitiObjectSchema(schema);\n        const callback: GraffitiSynchronizeCallback = (objectUpdate) => {\n          if (objectUpdate?.tombstone) {\n            if (seenUrls.has(objectUpdate.object.url)) {\n              push(objectUpdate);\n            }\n          } else if (\n            objectUpdate &&\n            matchObject(objectUpdate.object) &&\n            (this.options.omniscient ||\n              isActorAllowedGraffitiObject(objectUpdate.object, session))\n          ) {\n            // Deep clone the object to prevent mutation\n            let object = JSON.parse(\n              JSON.stringify(objectUpdate.object),\n            ) as GraffitiObjectBase;\n            if (!this.options.omniscient) {\n              object = maskGraffitiObject(object, channels, session?.actor);\n            }\n            if (validate(object)) {\n              push({ object });\n              seenUrls.add(object.url);\n            }\n          }\n        };\n\n        this.callbacks.add(callback);\n        await stop;\n        this.callbacks.delete(callback);\n      },\n    );\n\n    return (async function* () {\n      for await (const i of repeater) yield i;\n    })();\n  }\n\n  /**\n   * This method has the same signature as {@link discover} but listens for\n   * changes made via {@link post} and {@link delete} or\n   * fetched from {@link get}, {@link discover}, and {@link continueDiscover}\n   * and then streams appropriate changes to provide a responsive and\n   * consistent user experience.\n   *\n   * Unlike {@link discover}, this method continuously listens for changes\n   * and will not terminate unless the user calls the `return` method on the iterator\n   * or `break`s out of the loop.\n   *\n   * @group 0 - Synchronize Methods\n   */\n  synchronizeDiscover<Schema extends JSONSchema>(\n    channels: string[],\n    schema: Schema,\n    session?: GraffitiSession | null,\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    function matchObject(object: GraffitiObjectBase) {\n      return object.channels.some((channel) => channels.includes(channel));\n    }\n    return this.synchronize<Schema>(matchObject, channels, schema, session);\n  }\n\n  /**\n   * This method has the same signature as {@link get} but\n   * listens for changes made via {@link post}, and {@link delete} or\n   * fetched from {@link get}, {@link discover}, and {@link continueDiscover} and then\n   * streams appropriate changes to provide a responsive and consistent user experience.\n   *\n   * Unlike {@link get}, which returns a single result, this method continuously\n   * listens for changes which are output as an asynchronous stream, similar\n   * to {@link discover}.\n   *\n   * @group 0 - Synchronize Methods\n   */\n  synchronizeGet<Schema extends JSONSchema>(\n    objectUrl: string | GraffitiObjectUrl,\n    schema: Schema,\n    session?: GraffitiSession | null | undefined,\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    const url = unpackObjectUrl(objectUrl);\n    function matchObject(object: GraffitiObjectBase) {\n      return object.url === url;\n    }\n    return this.synchronize<Schema>(\n      matchObject,\n      [],\n      schema,\n      session,\n      new Set<string>([url]),\n    );\n  }\n\n  /**\n   * Streams changes made to *any* object in *any* channel\n   * and made by *any* user. You may want to use it in conjuction with\n   * {@link GraffitiSynchronizeOptions.omniscient} to get a global view\n   * of all Graffiti objects passing through the system. This is useful\n   * for building a client-side cache, for example.\n   *\n   * Be careful using this method. Without additional filters it can\n   * expose the user to content out of context.\n   *\n   * @group 0 - Synchronize Methods\n   */\n  synchronizeAll<Schema extends JSONSchema>(\n    schema: Schema,\n    session?: GraffitiSession | null,\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    return this.synchronize<Schema>(() => true, [], schema, session);\n  }\n\n  protected async synchronizeDispatch(\n    objectUpdate: GraffitiObjectStreamContinueEntry<{}>,\n    waitForListeners = false,\n  ) {\n    for (const callback of this.callbacks) {\n      callback(objectUpdate);\n    }\n    if (waitForListeners) {\n      // Wait for the listeners to receive\n      // their objects, before returning the operation\n      // that triggered them.\n      //\n      // This is important for mutators (put, patch, delete)\n      // to ensure the application state has been updated\n      // everywhere before returning, giving consistent\n      // feedback to the user that the operation has completed.\n      //\n      // The opposite is true for accessors (get, discover, recoverOrphans),\n      // where it is a weird user experience to call `get`\n      // in one place and have the application update\n      // somewhere else first. It is also less efficient.\n      //\n      // The hack is simply to await one \"macro task cycle\".\n      // We need to wait for this cycle rather than using\n      // `await push` in the callback, because it turns out\n      // that `await push` won't resolve until the following\n      // .next() call of the iterator, so if only\n      // one .next() is called, this dispatch will hang.\n      await new Promise((resolve) => setTimeout(resolve, 0));\n    }\n  }\n\n  get: Graffiti[\"get\"] = async (...args) => {\n    try {\n      const object = await this.graffiti.get(...args);\n      this.synchronizeDispatch({ object });\n      return object;\n    } catch (error) {\n      if (error instanceof GraffitiErrorNotFound) {\n        this.synchronizeDispatch({\n          tombstone: true,\n          object: { url: unpackObjectUrl(args[0]) },\n        });\n      }\n      throw error;\n    }\n  };\n\n  post: Graffiti[\"post\"] = async (...args) => {\n    // @ts-ignore\n    const object = await this.graffiti.post(...args);\n    await this.synchronizeDispatch({ object }, true);\n    return object;\n  };\n\n  delete: Graffiti[\"delete\"] = async (...args) => {\n    const update = {\n      tombstone: true,\n      object: { url: unpackObjectUrl(args[0]) },\n    } as const;\n    try {\n      const oldObject = await this.graffiti.delete(...args);\n      await this.synchronizeDispatch(update, true);\n      return oldObject;\n    } catch (error) {\n      if (error instanceof GraffitiErrorNotFound) {\n        await this.synchronizeDispatch(update, true);\n      }\n      throw error;\n    }\n  };\n\n  protected objectStreamContinue<Schema extends JSONSchema>(\n    iterator: GraffitiObjectStreamContinue<Schema>,\n  ): GraffitiObjectStreamContinue<Schema> {\n    const this_ = this;\n    return (async function* () {\n      while (true) {\n        const result = await iterator.next();\n        if (result.done) {\n          const { continue: continue_, cursor } = result.value;\n          return {\n            continue: (session?: GraffitiSession | null) =>\n              this_.objectStreamContinue<Schema>(continue_(session)),\n            cursor,\n          };\n        }\n        if (!result.value.error) {\n          this_.synchronizeDispatch(result.value);\n        }\n        yield result.value;\n      }\n    })();\n  }\n\n  protected objectStream<Schema extends JSONSchema>(\n    iterator: GraffitiObjectStream<Schema>,\n  ): GraffitiObjectStream<Schema> {\n    const wrapped = this.objectStreamContinue<Schema>(iterator);\n    return (async function* () {\n      // Filter out the tombstones for type safety\n      while (true) {\n        const result = await wrapped.next();\n        if (result.done) return result.value;\n        if (result.value.error || !result.value.tombstone) yield result.value;\n      }\n    })();\n  }\n\n  discover: Graffiti[\"discover\"] = (...args) => {\n    const iterator = this.graffiti.discover(...args);\n    return this.objectStream<(typeof args)[1]>(iterator);\n  };\n\n  continueDiscover: Graffiti[\"continueDiscover\"] = (...args) => {\n    const iterator = this.graffiti.continueDiscover(...args);\n    return this.objectStreamContinue<{}>(iterator);\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/esm/index.js CHANGED Viewed

@@ -1,5 +1,5 @@
 import {
-  GraffitiErrorInvalidSchema,
+  compileGraffitiObjectSchema,
   GraffitiErrorNotFound,
   isActorAllowedGraffitiObject,
   maskGraffitiObject,
@@ -7,7 +7,6 @@ import {
 } from "@graffiti-garden/api";
 import { Repeater } from "@repeaterjs/repeater";
 class GraffitiSynchronize {
-  ajv_;
   graffiti;
   callbacks = /* @__PURE__ */ new Set();
   options;
@@ -19,15 +18,6 @@ class GraffitiSynchronize {
   deleteMedia;
   actorToHandle;
   handleToActor;
-  get ajv() {
-    if (!this.ajv_) {
-      this.ajv_ = (async () => {
-        const { default: Ajv } = await import("ajv");
-        return new Ajv({ strict: false });
-      })();
-    }
-    return this.ajv_;
-  }
   /**
    * Wraps a Graffiti API instance to provide the synchronize methods.
    * The GraffitiSyncrhonize class rather than the Graffiti class
@@ -48,7 +38,7 @@ class GraffitiSynchronize {
   synchronize(matchObject, channels, schema, session, seenUrls = /* @__PURE__ */ new Set()) {
     const repeater = new Repeater(
       async (push, stop) => {
-        const validate = compileGraffitiObjectSchema(await this.ajv, schema);
+        const validate = await compileGraffitiObjectSchema(schema);
         const callback = (objectUpdate) => {
           if (objectUpdate?.tombstone) {
             if (seenUrls.has(objectUpdate.object.url)) {
@@ -217,15 +207,6 @@ class GraffitiSynchronize {
     return this.objectStreamContinue(iterator);
   };
 }
-function compileGraffitiObjectSchema(ajv, schema) {
-  try {
-    return ajv.compile(schema);
-  } catch (error) {
-    throw new GraffitiErrorInvalidSchema(
-      error instanceof Error ? error.message : String(error)
-    );
-  }
-}
 export {
   GraffitiSynchronize
 };

package/dist/esm/index.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/index.ts"],
-  "sourcesContent": ["import type Ajv from \"ajv\";\nimport type {\n  Graffiti,\n  GraffitiSession,\n  JSONSchema,\n  GraffitiObjectBase,\n  GraffitiObjectStream,\n  GraffitiObjectStreamContinueEntry,\n  GraffitiObjectStreamContinue,\n  GraffitiObjectUrl,\n  GraffitiObject,\n} from \"@graffiti-garden/api\";\nimport {\n  GraffitiErrorInvalidSchema,\n  GraffitiErrorNotFound,\n  isActorAllowedGraffitiObject,\n  maskGraffitiObject,\n  unpackObjectUrl,\n} from \"@graffiti-garden/api\";\nimport { Repeater } from \"@repeaterjs/repeater\";\nexport type * from \"@graffiti-garden/api\";\n\nexport type GraffitiSynchronizeCallback = (\n  object: GraffitiObjectStreamContinueEntry<{}>,\n) => void;\n\nexport interface GraffitiSynchronizeOptions {\n  /**\n   * Allows synchronize to listen to all objects, not just those\n   * that the session is allowed to see. This is useful to get a\n   * global view of all Graffiti objects passsing through the system,\n   * for example to build a client-side cache. Additional mechanisms\n   * should be in place to ensure that users do not see objects or\n   * properties they are not allowed to see.\n   *\n   * Default: `false`\n   */\n  omniscient?: boolean;\n}\n\n/**\n * Wraps the [Graffiti API](https://api.graffiti.garden/classes/Graffiti.html)\n * so that changes made or received in one part of an application\n * are automatically routed to other parts of the application.\n * This is an important tool for building responsive\n * and consistent user interfaces, and is built upon to make\n * the [Graffiti Vue Plugin](https://vue.graffiti.garden/variables/GraffitiPlugin.html)\n * and possibly other front-end libraries in the future.\n *\n * [See a live example](/example).\n *\n * Specifically, this library provides the following *synchronize*\n * methods to correspond with each of the following Graffiti API methods:\n *\n * | API Method | Synchronize Method |\n * |------------|--------------------|\n * | {@link get} | {@link synchronizeGet} |\n * | {@link discover} | {@link synchronizeDiscover} |\n *\n * Whenever a change is made via {@link post} and {@link delete} or\n * received from {@link get}, {@link discover}, and {@link continueDiscover},\n * those changes are forwarded to the appropriate synchronize method.\n * Each synchronize method returns an iterator that streams these changes\n * continually until the user calls `return` on the iterator or `break`s out of the loop,\n * allowing for live updates without additional polling.\n *\n * Example 1: Suppose a user publishes a post using {@link post}. If the feed\n * displaying that user's posts is using {@link synchronizeDiscover} to listen for changes,\n * then the user's new post will instantly appear in their feed, giving the UI a\n * responsive feel.\n *\n * Example 2: Suppose one of a user's friends changes their name. As soon as the\n * user's application receives one notice of that change (using {@link get}\n * or {@link discover}), then {@link synchronizeDiscover} listeners can be used to update\n * all instance's of that friend's name in the user's application instantly,\n * providing a consistent user experience.\n *\n * Additionally, the library supplies a {@link synchronizeAll} method that can be used\n * to stream all the Graffiti changes that an application is aware of, which can be used\n * for caching or history building.\n *\n * The source code for this library is [available on GitHub](https://github.com/graffiti-garden/wrapper-synchronize/).\n *\n * @groupDescription 0 - Synchronize Methods\n * This group contains methods that listen for changes made via\n * {@link post}, and {@link delete} or fetched from\n * {@link get}, {@link discover}, or {@link continueDiscover} and then\n * streams appropriate changes to provide a responsive and consistent user experience.\n */\nexport class GraffitiSynchronize implements Graffiti {\n  protected ajv_: Promise<Ajv> | undefined;\n  protected readonly graffiti: Graffiti;\n  protected readonly callbacks = new Set<GraffitiSynchronizeCallback>();\n  protected readonly options: GraffitiSynchronizeOptions;\n\n  login: Graffiti[\"login\"];\n  logout: Graffiti[\"logout\"];\n  sessionEvents: Graffiti[\"sessionEvents\"];\n  postMedia: Graffiti[\"postMedia\"];\n  getMedia: Graffiti[\"getMedia\"];\n  deleteMedia: Graffiti[\"deleteMedia\"];\n  actorToHandle: Graffiti[\"actorToHandle\"];\n  handleToActor: Graffiti[\"handleToActor\"];\n\n  protected get ajv() {\n    if (!this.ajv_) {\n      this.ajv_ = (async () => {\n        const { default: Ajv } = await import(\"ajv\");\n        return new Ajv({ strict: false });\n      })();\n    }\n    return this.ajv_;\n  }\n\n  /**\n   * Wraps a Graffiti API instance to provide the synchronize methods.\n   * The GraffitiSyncrhonize class rather than the Graffiti class\n   * must be used for all functions for the synchronize methods to work.\n   */\n  constructor(\n    /**\n     * The [Graffiti API](https://api.graffiti.garden/classes/Graffiti.html)\n     * instance to wrap.\n     */\n    graffiti: Graffiti,\n    options?: GraffitiSynchronizeOptions,\n  ) {\n    this.options = options ?? {};\n    this.graffiti = graffiti;\n    this.login = graffiti.login.bind(graffiti);\n    this.logout = graffiti.logout.bind(graffiti);\n    this.sessionEvents = graffiti.sessionEvents;\n    this.postMedia = graffiti.postMedia.bind(graffiti);\n    this.getMedia = graffiti.getMedia.bind(graffiti);\n    this.deleteMedia = graffiti.deleteMedia.bind(graffiti);\n    this.actorToHandle = graffiti.actorToHandle.bind(graffiti);\n    this.handleToActor = graffiti.handleToActor.bind(graffiti);\n  }\n\n  protected synchronize<Schema extends JSONSchema>(\n    matchObject: (object: GraffitiObjectBase) => boolean,\n    channels: string[],\n    schema: Schema,\n    session?: GraffitiSession | null,\n    seenUrls: Set<string> = new Set<string>(),\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    const repeater = new Repeater<GraffitiObjectStreamContinueEntry<Schema>>(\n      async (push, stop) => {\n        const validate = compileGraffitiObjectSchema(await this.ajv, schema);\n        const callback: GraffitiSynchronizeCallback = (objectUpdate) => {\n          if (objectUpdate?.tombstone) {\n            if (seenUrls.has(objectUpdate.object.url)) {\n              push(objectUpdate);\n            }\n          } else if (\n            objectUpdate &&\n            matchObject(objectUpdate.object) &&\n            (this.options.omniscient ||\n              isActorAllowedGraffitiObject(objectUpdate.object, session))\n          ) {\n            // Deep clone the object to prevent mutation\n            let object = JSON.parse(\n              JSON.stringify(objectUpdate.object),\n            ) as GraffitiObjectBase;\n            if (!this.options.omniscient) {\n              object = maskGraffitiObject(object, channels, session?.actor);\n            }\n            if (validate(object)) {\n              push({ object });\n              seenUrls.add(object.url);\n            }\n          }\n        };\n\n        this.callbacks.add(callback);\n        await stop;\n        this.callbacks.delete(callback);\n      },\n    );\n\n    return (async function* () {\n      for await (const i of repeater) yield i;\n    })();\n  }\n\n  /**\n   * This method has the same signature as {@link discover} but listens for\n   * changes made via {@link post} and {@link delete} or\n   * fetched from {@link get}, {@link discover}, and {@link continueDiscover}\n   * and then streams appropriate changes to provide a responsive and\n   * consistent user experience.\n   *\n   * Unlike {@link discover}, this method continuously listens for changes\n   * and will not terminate unless the user calls the `return` method on the iterator\n   * or `break`s out of the loop.\n   *\n   * @group 0 - Synchronize Methods\n   */\n  synchronizeDiscover<Schema extends JSONSchema>(\n    channels: string[],\n    schema: Schema,\n    session?: GraffitiSession | null,\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    function matchObject(object: GraffitiObjectBase) {\n      return object.channels.some((channel) => channels.includes(channel));\n    }\n    return this.synchronize<Schema>(matchObject, channels, schema, session);\n  }\n\n  /**\n   * This method has the same signature as {@link get} but\n   * listens for changes made via {@link post}, and {@link delete} or\n   * fetched from {@link get}, {@link discover}, and {@link continueDiscover} and then\n   * streams appropriate changes to provide a responsive and consistent user experience.\n   *\n   * Unlike {@link get}, which returns a single result, this method continuously\n   * listens for changes which are output as an asynchronous stream, similar\n   * to {@link discover}.\n   *\n   * @group 0 - Synchronize Methods\n   */\n  synchronizeGet<Schema extends JSONSchema>(\n    objectUrl: string | GraffitiObjectUrl,\n    schema: Schema,\n    session?: GraffitiSession | null | undefined,\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    const url = unpackObjectUrl(objectUrl);\n    function matchObject(object: GraffitiObjectBase) {\n      return object.url === url;\n    }\n    return this.synchronize<Schema>(\n      matchObject,\n      [],\n      schema,\n      session,\n      new Set<string>([url]),\n    );\n  }\n\n  /**\n   * Streams changes made to *any* object in *any* channel\n   * and made by *any* user. You may want to use it in conjuction with\n   * {@link GraffitiSynchronizeOptions.omniscient} to get a global view\n   * of all Graffiti objects passing through the system. This is useful\n   * for building a client-side cache, for example.\n   *\n   * Be careful using this method. Without additional filters it can\n   * expose the user to content out of context.\n   *\n   * @group 0 - Synchronize Methods\n   */\n  synchronizeAll<Schema extends JSONSchema>(\n    schema: Schema,\n    session?: GraffitiSession | null,\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    return this.synchronize<Schema>(() => true, [], schema, session);\n  }\n\n  protected async synchronizeDispatch(\n    objectUpdate: GraffitiObjectStreamContinueEntry<{}>,\n    waitForListeners = false,\n  ) {\n    for (const callback of this.callbacks) {\n      callback(objectUpdate);\n    }\n    if (waitForListeners) {\n      // Wait for the listeners to receive\n      // their objects, before returning the operation\n      // that triggered them.\n      //\n      // This is important for mutators (put, patch, delete)\n      // to ensure the application state has been updated\n      // everywhere before returning, giving consistent\n      // feedback to the user that the operation has completed.\n      //\n      // The opposite is true for accessors (get, discover, recoverOrphans),\n      // where it is a weird user experience to call `get`\n      // in one place and have the application update\n      // somewhere else first. It is also less efficient.\n      //\n      // The hack is simply to await one \"macro task cycle\".\n      // We need to wait for this cycle rather than using\n      // `await push` in the callback, because it turns out\n      // that `await push` won't resolve until the following\n      // .next() call of the iterator, so if only\n      // one .next() is called, this dispatch will hang.\n      await new Promise((resolve) => setTimeout(resolve, 0));\n    }\n  }\n\n  get: Graffiti[\"get\"] = async (...args) => {\n    try {\n      const object = await this.graffiti.get(...args);\n      this.synchronizeDispatch({ object });\n      return object;\n    } catch (error) {\n      if (error instanceof GraffitiErrorNotFound) {\n        this.synchronizeDispatch({\n          tombstone: true,\n          object: { url: unpackObjectUrl(args[0]) },\n        });\n      }\n      throw error;\n    }\n  };\n\n  post: Graffiti[\"post\"] = async (...args) => {\n    // @ts-ignore\n    const object = await this.graffiti.post(...args);\n    await this.synchronizeDispatch({ object }, true);\n    return object;\n  };\n\n  delete: Graffiti[\"delete\"] = async (...args) => {\n    const update = {\n      tombstone: true,\n      object: { url: unpackObjectUrl(args[0]) },\n    } as const;\n    try {\n      const oldObject = await this.graffiti.delete(...args);\n      await this.synchronizeDispatch(update, true);\n      return oldObject;\n    } catch (error) {\n      if (error instanceof GraffitiErrorNotFound) {\n        await this.synchronizeDispatch(update, true);\n      }\n      throw error;\n    }\n  };\n\n  protected objectStreamContinue<Schema extends JSONSchema>(\n    iterator: GraffitiObjectStreamContinue<Schema>,\n  ): GraffitiObjectStreamContinue<Schema> {\n    const this_ = this;\n    return (async function* () {\n      while (true) {\n        const result = await iterator.next();\n        if (result.done) {\n          const { continue: continue_, cursor } = result.value;\n          return {\n            continue: (session?: GraffitiSession | null) =>\n              this_.objectStreamContinue<Schema>(continue_(session)),\n            cursor,\n          };\n        }\n        if (!result.value.error) {\n          this_.synchronizeDispatch(result.value);\n        }\n        yield result.value;\n      }\n    })();\n  }\n\n  protected objectStream<Schema extends JSONSchema>(\n    iterator: GraffitiObjectStream<Schema>,\n  ): GraffitiObjectStream<Schema> {\n    const wrapped = this.objectStreamContinue<Schema>(iterator);\n    return (async function* () {\n      // Filter out the tombstones for type safety\n      while (true) {\n        const result = await wrapped.next();\n        if (result.done) return result.value;\n        if (result.value.error || !result.value.tombstone) yield result.value;\n      }\n    })();\n  }\n\n  discover: Graffiti[\"discover\"] = (...args) => {\n    const iterator = this.graffiti.discover(...args);\n    return this.objectStream<(typeof args)[1]>(iterator);\n  };\n\n  continueDiscover: Graffiti[\"continueDiscover\"] = (...args) => {\n    const iterator = this.graffiti.continueDiscover(...args);\n    return this.objectStreamContinue<{}>(iterator);\n  };\n}\n\nfunction compileGraffitiObjectSchema<Schema extends JSONSchema>(\n  ajv: Ajv,\n  schema: Schema,\n) {\n  try {\n    // Force the validation guard because\n    // it is too big for the type checker.\n    // Fortunately json-schema-to-ts is\n    // well tested against ajv.\n    return ajv.compile(schema) as (\n      data: GraffitiObjectBase,\n    ) => data is GraffitiObject<Schema>;\n  } catch (error) {\n    throw new GraffitiErrorInvalidSchema(\n      error instanceof Error ? error.message : String(error),\n    );\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type {\n  Graffiti,\n  GraffitiSession,\n  JSONSchema,\n  GraffitiObjectBase,\n  GraffitiObjectStream,\n  GraffitiObjectStreamContinueEntry,\n  GraffitiObjectStreamContinue,\n  GraffitiObjectUrl,\n} from \"@graffiti-garden/api\";\nimport {\n  compileGraffitiObjectSchema,\n  GraffitiErrorNotFound,\n  isActorAllowedGraffitiObject,\n  maskGraffitiObject,\n  unpackObjectUrl,\n} from \"@graffiti-garden/api\";\nimport { Repeater } from \"@repeaterjs/repeater\";\nexport type * from \"@graffiti-garden/api\";\n\nexport type GraffitiSynchronizeCallback = (\n  object: GraffitiObjectStreamContinueEntry<{}>,\n) => void;\n\nexport interface GraffitiSynchronizeOptions {\n  /**\n   * Allows synchronize to listen to all objects, not just those\n   * that the session is allowed to see. This is useful to get a\n   * global view of all Graffiti objects passsing through the system,\n   * for example to build a client-side cache. Additional mechanisms\n   * should be in place to ensure that users do not see objects or\n   * properties they are not allowed to see.\n   *\n   * Default: `false`\n   */\n  omniscient?: boolean;\n}\n\n/**\n * Wraps the [Graffiti API](https://api.graffiti.garden/classes/Graffiti.html)\n * so that changes made or received in one part of an application\n * are automatically routed to other parts of the application.\n * This is an important tool for building responsive\n * and consistent user interfaces, and is built upon to make\n * the [Graffiti Vue Plugin](https://vue.graffiti.garden/variables/GraffitiPlugin.html)\n * and possibly other front-end libraries in the future.\n *\n * [See a live example](/example).\n *\n * Specifically, this library provides the following *synchronize*\n * methods to correspond with each of the following Graffiti API methods:\n *\n * | API Method | Synchronize Method |\n * |------------|--------------------|\n * | {@link get} | {@link synchronizeGet} |\n * | {@link discover} | {@link synchronizeDiscover} |\n *\n * Whenever a change is made via {@link post} and {@link delete} or\n * received from {@link get}, {@link discover}, and {@link continueDiscover},\n * those changes are forwarded to the appropriate synchronize method.\n * Each synchronize method returns an iterator that streams these changes\n * continually until the user calls `return` on the iterator or `break`s out of the loop,\n * allowing for live updates without additional polling.\n *\n * Example 1: Suppose a user publishes a post using {@link post}. If the feed\n * displaying that user's posts is using {@link synchronizeDiscover} to listen for changes,\n * then the user's new post will instantly appear in their feed, giving the UI a\n * responsive feel.\n *\n * Example 2: Suppose one of a user's friends changes their name. As soon as the\n * user's application receives one notice of that change (using {@link get}\n * or {@link discover}), then {@link synchronizeDiscover} listeners can be used to update\n * all instance's of that friend's name in the user's application instantly,\n * providing a consistent user experience.\n *\n * Additionally, the library supplies a {@link synchronizeAll} method that can be used\n * to stream all the Graffiti changes that an application is aware of, which can be used\n * for caching or history building.\n *\n * The source code for this library is [available on GitHub](https://github.com/graffiti-garden/wrapper-synchronize/).\n *\n * @groupDescription 0 - Synchronize Methods\n * This group contains methods that listen for changes made via\n * {@link post}, and {@link delete} or fetched from\n * {@link get}, {@link discover}, or {@link continueDiscover} and then\n * streams appropriate changes to provide a responsive and consistent user experience.\n */\nexport class GraffitiSynchronize implements Graffiti {\n  protected readonly graffiti: Graffiti;\n  protected readonly callbacks = new Set<GraffitiSynchronizeCallback>();\n  protected readonly options: GraffitiSynchronizeOptions;\n\n  login: Graffiti[\"login\"];\n  logout: Graffiti[\"logout\"];\n  sessionEvents: Graffiti[\"sessionEvents\"];\n  postMedia: Graffiti[\"postMedia\"];\n  getMedia: Graffiti[\"getMedia\"];\n  deleteMedia: Graffiti[\"deleteMedia\"];\n  actorToHandle: Graffiti[\"actorToHandle\"];\n  handleToActor: Graffiti[\"handleToActor\"];\n\n  /**\n   * Wraps a Graffiti API instance to provide the synchronize methods.\n   * The GraffitiSyncrhonize class rather than the Graffiti class\n   * must be used for all functions for the synchronize methods to work.\n   */\n  constructor(\n    /**\n     * The [Graffiti API](https://api.graffiti.garden/classes/Graffiti.html)\n     * instance to wrap.\n     */\n    graffiti: Graffiti,\n    options?: GraffitiSynchronizeOptions,\n  ) {\n    this.options = options ?? {};\n    this.graffiti = graffiti;\n    this.login = graffiti.login.bind(graffiti);\n    this.logout = graffiti.logout.bind(graffiti);\n    this.sessionEvents = graffiti.sessionEvents;\n    this.postMedia = graffiti.postMedia.bind(graffiti);\n    this.getMedia = graffiti.getMedia.bind(graffiti);\n    this.deleteMedia = graffiti.deleteMedia.bind(graffiti);\n    this.actorToHandle = graffiti.actorToHandle.bind(graffiti);\n    this.handleToActor = graffiti.handleToActor.bind(graffiti);\n  }\n\n  protected synchronize<Schema extends JSONSchema>(\n    matchObject: (object: GraffitiObjectBase) => boolean,\n    channels: string[],\n    schema: Schema,\n    session?: GraffitiSession | null,\n    seenUrls: Set<string> = new Set<string>(),\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    const repeater = new Repeater<GraffitiObjectStreamContinueEntry<Schema>>(\n      async (push, stop) => {\n        const validate = await compileGraffitiObjectSchema(schema);\n        const callback: GraffitiSynchronizeCallback = (objectUpdate) => {\n          if (objectUpdate?.tombstone) {\n            if (seenUrls.has(objectUpdate.object.url)) {\n              push(objectUpdate);\n            }\n          } else if (\n            objectUpdate &&\n            matchObject(objectUpdate.object) &&\n            (this.options.omniscient ||\n              isActorAllowedGraffitiObject(objectUpdate.object, session))\n          ) {\n            // Deep clone the object to prevent mutation\n            let object = JSON.parse(\n              JSON.stringify(objectUpdate.object),\n            ) as GraffitiObjectBase;\n            if (!this.options.omniscient) {\n              object = maskGraffitiObject(object, channels, session?.actor);\n            }\n            if (validate(object)) {\n              push({ object });\n              seenUrls.add(object.url);\n            }\n          }\n        };\n\n        this.callbacks.add(callback);\n        await stop;\n        this.callbacks.delete(callback);\n      },\n    );\n\n    return (async function* () {\n      for await (const i of repeater) yield i;\n    })();\n  }\n\n  /**\n   * This method has the same signature as {@link discover} but listens for\n   * changes made via {@link post} and {@link delete} or\n   * fetched from {@link get}, {@link discover}, and {@link continueDiscover}\n   * and then streams appropriate changes to provide a responsive and\n   * consistent user experience.\n   *\n   * Unlike {@link discover}, this method continuously listens for changes\n   * and will not terminate unless the user calls the `return` method on the iterator\n   * or `break`s out of the loop.\n   *\n   * @group 0 - Synchronize Methods\n   */\n  synchronizeDiscover<Schema extends JSONSchema>(\n    channels: string[],\n    schema: Schema,\n    session?: GraffitiSession | null,\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    function matchObject(object: GraffitiObjectBase) {\n      return object.channels.some((channel) => channels.includes(channel));\n    }\n    return this.synchronize<Schema>(matchObject, channels, schema, session);\n  }\n\n  /**\n   * This method has the same signature as {@link get} but\n   * listens for changes made via {@link post}, and {@link delete} or\n   * fetched from {@link get}, {@link discover}, and {@link continueDiscover} and then\n   * streams appropriate changes to provide a responsive and consistent user experience.\n   *\n   * Unlike {@link get}, which returns a single result, this method continuously\n   * listens for changes which are output as an asynchronous stream, similar\n   * to {@link discover}.\n   *\n   * @group 0 - Synchronize Methods\n   */\n  synchronizeGet<Schema extends JSONSchema>(\n    objectUrl: string | GraffitiObjectUrl,\n    schema: Schema,\n    session?: GraffitiSession | null | undefined,\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    const url = unpackObjectUrl(objectUrl);\n    function matchObject(object: GraffitiObjectBase) {\n      return object.url === url;\n    }\n    return this.synchronize<Schema>(\n      matchObject,\n      [],\n      schema,\n      session,\n      new Set<string>([url]),\n    );\n  }\n\n  /**\n   * Streams changes made to *any* object in *any* channel\n   * and made by *any* user. You may want to use it in conjuction with\n   * {@link GraffitiSynchronizeOptions.omniscient} to get a global view\n   * of all Graffiti objects passing through the system. This is useful\n   * for building a client-side cache, for example.\n   *\n   * Be careful using this method. Without additional filters it can\n   * expose the user to content out of context.\n   *\n   * @group 0 - Synchronize Methods\n   */\n  synchronizeAll<Schema extends JSONSchema>(\n    schema: Schema,\n    session?: GraffitiSession | null,\n  ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {\n    return this.synchronize<Schema>(() => true, [], schema, session);\n  }\n\n  protected async synchronizeDispatch(\n    objectUpdate: GraffitiObjectStreamContinueEntry<{}>,\n    waitForListeners = false,\n  ) {\n    for (const callback of this.callbacks) {\n      callback(objectUpdate);\n    }\n    if (waitForListeners) {\n      // Wait for the listeners to receive\n      // their objects, before returning the operation\n      // that triggered them.\n      //\n      // This is important for mutators (put, patch, delete)\n      // to ensure the application state has been updated\n      // everywhere before returning, giving consistent\n      // feedback to the user that the operation has completed.\n      //\n      // The opposite is true for accessors (get, discover, recoverOrphans),\n      // where it is a weird user experience to call `get`\n      // in one place and have the application update\n      // somewhere else first. It is also less efficient.\n      //\n      // The hack is simply to await one \"macro task cycle\".\n      // We need to wait for this cycle rather than using\n      // `await push` in the callback, because it turns out\n      // that `await push` won't resolve until the following\n      // .next() call of the iterator, so if only\n      // one .next() is called, this dispatch will hang.\n      await new Promise((resolve) => setTimeout(resolve, 0));\n    }\n  }\n\n  get: Graffiti[\"get\"] = async (...args) => {\n    try {\n      const object = await this.graffiti.get(...args);\n      this.synchronizeDispatch({ object });\n      return object;\n    } catch (error) {\n      if (error instanceof GraffitiErrorNotFound) {\n        this.synchronizeDispatch({\n          tombstone: true,\n          object: { url: unpackObjectUrl(args[0]) },\n        });\n      }\n      throw error;\n    }\n  };\n\n  post: Graffiti[\"post\"] = async (...args) => {\n    // @ts-ignore\n    const object = await this.graffiti.post(...args);\n    await this.synchronizeDispatch({ object }, true);\n    return object;\n  };\n\n  delete: Graffiti[\"delete\"] = async (...args) => {\n    const update = {\n      tombstone: true,\n      object: { url: unpackObjectUrl(args[0]) },\n    } as const;\n    try {\n      const oldObject = await this.graffiti.delete(...args);\n      await this.synchronizeDispatch(update, true);\n      return oldObject;\n    } catch (error) {\n      if (error instanceof GraffitiErrorNotFound) {\n        await this.synchronizeDispatch(update, true);\n      }\n      throw error;\n    }\n  };\n\n  protected objectStreamContinue<Schema extends JSONSchema>(\n    iterator: GraffitiObjectStreamContinue<Schema>,\n  ): GraffitiObjectStreamContinue<Schema> {\n    const this_ = this;\n    return (async function* () {\n      while (true) {\n        const result = await iterator.next();\n        if (result.done) {\n          const { continue: continue_, cursor } = result.value;\n          return {\n            continue: (session?: GraffitiSession | null) =>\n              this_.objectStreamContinue<Schema>(continue_(session)),\n            cursor,\n          };\n        }\n        if (!result.value.error) {\n          this_.synchronizeDispatch(result.value);\n        }\n        yield result.value;\n      }\n    })();\n  }\n\n  protected objectStream<Schema extends JSONSchema>(\n    iterator: GraffitiObjectStream<Schema>,\n  ): GraffitiObjectStream<Schema> {\n    const wrapped = this.objectStreamContinue<Schema>(iterator);\n    return (async function* () {\n      // Filter out the tombstones for type safety\n      while (true) {\n        const result = await wrapped.next();\n        if (result.done) return result.value;\n        if (result.value.error || !result.value.tombstone) yield result.value;\n      }\n    })();\n  }\n\n  discover: Graffiti[\"discover\"] = (...args) => {\n    const iterator = this.graffiti.discover(...args);\n    return this.objectStream<(typeof args)[1]>(iterator);\n  };\n\n  continueDiscover: Graffiti[\"continueDiscover\"] = (...args) => {\n    const iterator = this.graffiti.continueDiscover(...args);\n    return this.objectStreamContinue<{}>(iterator);\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/index.d.ts CHANGED Viewed

@@ -1,4 +1,3 @@
-import type Ajv from "ajv";
 import type { Graffiti, GraffitiSession, JSONSchema, GraffitiObjectBase, GraffitiObjectStream, GraffitiObjectStreamContinueEntry, GraffitiObjectStreamContinue, GraffitiObjectUrl } from "@graffiti-garden/api";
 export type * from "@graffiti-garden/api";
 export type GraffitiSynchronizeCallback = (object: GraffitiObjectStreamContinueEntry<{}>) => void;
@@ -65,7 +64,6 @@ export interface GraffitiSynchronizeOptions {
  * streams appropriate changes to provide a responsive and consistent user experience.
  */
 export declare class GraffitiSynchronize implements Graffiti {
-    protected ajv_: Promise<Ajv> | undefined;
     protected readonly graffiti: Graffiti;
     protected readonly callbacks: Set<GraffitiSynchronizeCallback>;
     protected readonly options: GraffitiSynchronizeOptions;
@@ -77,7 +75,6 @@ export declare class GraffitiSynchronize implements Graffiti {
     deleteMedia: Graffiti["deleteMedia"];
     actorToHandle: Graffiti["actorToHandle"];
     handleToActor: Graffiti["handleToActor"];
-    protected get ajv(): Promise<Ajv>;
     /**
      * Wraps a Graffiti API instance to provide the synchronize methods.
      * The GraffitiSyncrhonize class rather than the Graffiti class

package/dist/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,~~GAAG,MAAM,KAAK,CAAC;AAC3B,OAAO,KAAK,~~EACV,QAAQ,EACR,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,iCAAiC,EACjC,4BAA4B,EAC5B,iBAAiB,~~EAElB~~,MAAM,sBAAsB,CAAC;AAS9B,mBAAmB,sBAAsB,CAAC;AAE1C,MAAM,MAAM,2BAA2B,GAAG,CACxC,MAAM,EAAE,iCAAiC,CAAC,EAAE,CAAC,KAC1C,IAAI,CAAC;AAEV,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,qBAAa,mBAAoB,YAAW,QAAQ;IAClD,SAAS,CAAC,~~IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACzC,SAAS,CAAC,~~QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACtC,SAAS,CAAC,QAAQ,CAAC,SAAS,mCAA0C;IACtE,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;IAEvD,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3B,aAAa,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IACzC,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACjC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/B,WAAW,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IACrC,aAAa,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IACzC,aAAa,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEzC~~,SAAS,KAAK,GAAG,iBAQhB;IAED~~;;;;OAIG;;IAED;;;OAGG;IACH,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,0BAA0B;IActC,SAAS,CAAC,WAAW,CAAC,MAAM,SAAS,UAAU,EAC7C,WAAW,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,EACpD,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,EAChC,QAAQ,GAAE,GAAG,CAAC,MAAM,CAAqB,GACxC,cAAc,CAAC,iCAAiC,CAAC,MAAM,CAAC,CAAC;IAwC5D;;;;;;;;;;;;OAYG;IACH,mBAAmB,CAAC,MAAM,SAAS,UAAU,EAC3C,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,GAC/B,cAAc,CAAC,iCAAiC,CAAC,MAAM,CAAC,CAAC;IAO5D;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,MAAM,SAAS,UAAU,EACtC,SAAS,EAAE,MAAM,GAAG,iBAAiB,EACrC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GAC3C,cAAc,CAAC,iCAAiC,CAAC,MAAM,CAAC,CAAC;IAc5D;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,MAAM,SAAS,UAAU,EACtC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,GAC/B,cAAc,CAAC,iCAAiC,CAAC,MAAM,CAAC,CAAC;cAI5C,mBAAmB,CACjC,YAAY,EAAE,iCAAiC,CAAC,EAAE,CAAC,EACnD,gBAAgB,UAAQ;IA8B1B,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAclB;IAEF,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAKpB;IAEF,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAexB;IAEF,SAAS,CAAC,oBAAoB,CAAC,MAAM,SAAS,UAAU,EACtD,QAAQ,EAAE,4BAA4B,CAAC,MAAM,CAAC,GAC7C,4BAA4B,CAAC,MAAM,CAAC;IAqBvC,SAAS,CAAC,YAAY,CAAC,MAAM,SAAS,UAAU,EAC9C,QAAQ,EAAE,oBAAoB,CAAC,MAAM,CAAC,GACrC,oBAAoB,CAAC,MAAM,CAAC;IAY/B,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAG5B;IAEF,gBAAgB,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAG5C;CACH"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@graffiti-garden/wrapper-synchronize",
-  "version": "1.0.4",
+  "version": "1.0.8",
   "description": "Internal synchronization for the Graffiti API",
   "types": "./dist/index.d.ts",
   "module": "./dist/esm/index.js",
@@ -45,7 +45,7 @@
   },
   "homepage": "https://sync.graffiti.garden/classes/GraffitiSynchronize.html",
   "devDependencies": {
-    "@graffiti-garden/implementation-local": "^1.0.4",
+    "@graffiti-garden/implementation-local": "^1.0.8",
     "@types/node": "^25.0.6",
     "@vitest/coverage-v8": "^4.0.17",
     "esbuild-plugin-polyfill-node": "^0.3.0",
@@ -55,8 +55,7 @@
     "vitest": "^4.0.17"
   },
   "dependencies": {
-    "@graffiti-garden/api": "^1.0.4",
-    "@repeaterjs/repeater": "^3.0.6",
-    "ajv": "^8.17.1"
+    "@graffiti-garden/api": "^1.0.8",
+    "@repeaterjs/repeater": "^3.0.6"
   }
 }

package/src/index.spec.ts CHANGED Viewed

@@ -4,7 +4,11 @@ import {
   type GraffitiSession,
 } from "@graffiti-garden/api";
 import { GraffitiLocal } from "@graffiti-garden/implementation-local";
-import { randomPostObject, randomString } from "@graffiti-garden/api/tests";
+import {
+  randomPostObject,
+  randomString,
+  randomUrl,
+} from "@graffiti-garden/api/tests";
 import { GraffitiSynchronize } from "./index";
 import {
   graffitiCRUDTests,
@@ -12,17 +16,18 @@ import {
   graffitiMediaTests,
 } from "@graffiti-garden/api/tests";
+// @ts-ignore
 const useGraffiti = () => new GraffitiSynchronize(new GraffitiLocal());
 const graffiti = useGraffiti();
 const useSession1 = async () => {
   return {
-    actor: randomString(),
+    actor: randomUrl(),
   };
 };
 const useSession2 = async () => {
   return {
-    actor: randomString(),
+    actor: randomUrl(),
   };
 };
@@ -171,7 +176,7 @@ describe.concurrent("synchronizeDiscover", () => {
   });
   it("not allowed", async () => {
-    const allChannels = [randomString(), randomString(), randomString()];
+    const allChannels = [randomUrl(), randomUrl(), randomUrl()];
     const channels = allChannels.slice(1);
     const creatorNext = graffiti
@@ -185,7 +190,7 @@ describe.concurrent("synchronizeDiscover", () => {
     const value = {
       hello: "world",
     };
-    const allowed = [randomString(), session2.actor];
+    const allowed = [randomUrl(), session2.actor];
     await graffiti.post<{}>(
       { value, channels: allChannels, allowed },
       session1,
@@ -336,7 +341,7 @@ describe("synchronizeAll", () => {
     });
     const object1 = randomPostObject();
-    object1.allowed = [randomString()];
+    object1.allowed = [randomUrl()];
     const iterator = graffiti.synchronizeAll({});
     const next = iterator.next();

package/src/index.ts CHANGED Viewed

@@ -1,4 +1,3 @@
-import type Ajv from "ajv";
 import type {
   Graffiti,
   GraffitiSession,
@@ -8,10 +7,9 @@ import type {
   GraffitiObjectStreamContinueEntry,
   GraffitiObjectStreamContinue,
   GraffitiObjectUrl,
-  GraffitiObject,
 } from "@graffiti-garden/api";
 import {
-  GraffitiErrorInvalidSchema,
+  compileGraffitiObjectSchema,
   GraffitiErrorNotFound,
   isActorAllowedGraffitiObject,
   maskGraffitiObject,
@@ -88,7 +86,6 @@ export interface GraffitiSynchronizeOptions {
  * streams appropriate changes to provide a responsive and consistent user experience.
  */
 export class GraffitiSynchronize implements Graffiti {
-  protected ajv_: Promise<Ajv> | undefined;
   protected readonly graffiti: Graffiti;
   protected readonly callbacks = new Set<GraffitiSynchronizeCallback>();
   protected readonly options: GraffitiSynchronizeOptions;
@@ -102,16 +99,6 @@ export class GraffitiSynchronize implements Graffiti {
   actorToHandle: Graffiti["actorToHandle"];
   handleToActor: Graffiti["handleToActor"];
-  protected get ajv() {
-    if (!this.ajv_) {
-      this.ajv_ = (async () => {
-        const { default: Ajv } = await import("ajv");
-        return new Ajv({ strict: false });
-      })();
-    }
-    return this.ajv_;
-  }
   /**
    * Wraps a Graffiti API instance to provide the synchronize methods.
    * The GraffitiSyncrhonize class rather than the Graffiti class
@@ -146,7 +133,7 @@ export class GraffitiSynchronize implements Graffiti {
   ): AsyncGenerator<GraffitiObjectStreamContinueEntry<Schema>> {
     const repeater = new Repeater<GraffitiObjectStreamContinueEntry<Schema>>(
       async (push, stop) => {
-        const validate = compileGraffitiObjectSchema(await this.ajv, schema);
+        const validate = await compileGraffitiObjectSchema(schema);
         const callback: GraffitiSynchronizeCallback = (objectUpdate) => {
           if (objectUpdate?.tombstone) {
             if (seenUrls.has(objectUpdate.object.url)) {
@@ -375,22 +362,3 @@ export class GraffitiSynchronize implements Graffiti {
     return this.objectStreamContinue<{}>(iterator);
   };
 }
-function compileGraffitiObjectSchema<Schema extends JSONSchema>(
-  ajv: Ajv,
-  schema: Schema,
-) {
-  try {
-    // Force the validation guard because
-    // it is too big for the type checker.
-    // Fortunately json-schema-to-ts is
-    // well tested against ajv.
-    return ajv.compile(schema) as (
-      data: GraffitiObjectBase,
-    ) => data is GraffitiObject<Schema>;
-  } catch (error) {
-    throw new GraffitiErrorInvalidSchema(
-      error instanceof Error ? error.message : String(error),
-    );
-  }
-}