@graffiti-garden/implementation-local 0.2.12 → 0.3.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { Graffiti } from "@graffiti-garden/api";
+import { GraffitiLocalSessionManager } from "./session-manager.js";
 import { type GraffitiLocalOptions } from "./database.js";
 export type { GraffitiLocalOptions };
 /**
@@ -11,18 +12,19 @@ export type { GraffitiLocalOptions };
 export declare class GraffitiLocal extends Graffiti {
     locationToUri: (location: import("@graffiti-garden/api").GraffitiLocation) => string;
     uriToLocation: (uri: string) => import("@graffiti-garden/api").GraffitiLocation;
-    login: Graffiti["login"];
-    logout: Graffiti["logout"];
-    sessionEvents: Graffiti["sessionEvents"];
+    protected sessionManagerLocal: GraffitiLocalSessionManager;
+    login: (proposal?: {
+        actor?: string;
+        scope?: {};
+    }) => Promise<void>;
+    logout: (session: import("@graffiti-garden/api").GraffitiSession) => Promise<void>;
+    sessionEvents: EventTarget;
     put: Graffiti["put"];
     get: Graffiti["get"];
     patch: Graffiti["patch"];
     delete: Graffiti["delete"];
     discover: Graffiti["discover"];
     recoverOrphans: Graffiti["recoverOrphans"];
-    synchronizeGet: Graffiti["synchronizeGet"];
-    synchronizeDiscover: Graffiti["synchronizeDiscover"];
-    synchronizeRecoverOrphans: Graffiti["synchronizeRecoverOrphans"];
     channelStats: Graffiti["channelStats"];
     constructor(options?: GraffitiLocalOptions);
 }

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAIvB,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,aAAa,wEAAiB;IAC9B,aAAa,mEAAiB;IAE9B,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3B,aAAa,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IACzC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrB,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrB,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3B,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/B,cAAc,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC3C,cAAc,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC3C,mBAAmB,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IACrD,yBAAyB,EAAE,QAAQ,CAAC,2BAA2B,CAAC,CAAC;IACjE,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;gBAE3B,OAAO,CAAC,EAAE,oBAAoB;CA+B3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAGvB,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,QAAQ;IACzC,aAAa,wEAAiB;IAC9B,aAAa,mEAAiB;IAE9B,SAAS,CAAC,mBAAmB,8BAAqC;IAClE,KAAK;aA6By+sB,CAAC;aAA6iB,CAAC;wBA7Bv9tB;IACtE,MAAM,6EAAkE;IACxE,aAAa,cAA0C;IAEvD,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrB,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrB,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3B,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/B,cAAc,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC3C,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;gBAE3B,OAAO,CAAC,EAAE,oBAAoB;CAgB3C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graffiti-garden/implementation-local",
-  "version": "0.2.12",
+  "version": "0.3.0",
   "description": "A local implementation of the Graffiti API using PouchDB",
   "types": "./dist/index.d.ts",
   "module": "./dist/esm/index.js",
@@ -37,16 +37,6 @@
         "default": "./dist/cjs/session-manager.js"
       }
     },
-    "./synchronize": {
-      "import": {
-        "types": "./dist/synchronize.d.ts",
-        "default": "./dist/esm/synchronize.js"
-      },
-      "require": {
-        "types": "./dist/synchronize.d.ts",
-        "default": "./dist/cjs/synchronize.js"
-      }
-    },
     "./utilities": {
       "import": {
         "types": "./dist/utilities.d.ts",
@@ -89,7 +79,7 @@
     "vitest": "^2.1.8"
   },
   "dependencies": {
-    "@graffiti-garden/api": "^0.2.11",
+    "@graffiti-garden/api": "^0.3.0",
     "@repeaterjs/repeater": "^3.0.6",
     "@types/pouchdb": "^6.4.2",
     "ajv": "^8.17.1",

package/src/index.ts

@@ -5,7 +5,6 @@ import {
   GraffitiLocalDatabase,
   type GraffitiLocalOptions,
 } from "./database.js";
-import { GraffitiSynchronize } from "./synchronize.js";
 import { locationToUri, uriToLocation } from "./utilities.js";
 
 export type { GraffitiLocalOptions };
@@ -21,49 +20,33 @@ export class GraffitiLocal extends Graffiti {
   locationToUri = locationToUri;
   uriToLocation = uriToLocation;
 
-  login: Graffiti["login"];
-  logout: Graffiti["logout"];
-  sessionEvents: Graffiti["sessionEvents"];
+  protected sessionManagerLocal = new GraffitiLocalSessionManager();
+  login = this.sessionManagerLocal.login.bind(this.sessionManagerLocal);
+  logout = this.sessionManagerLocal.logout.bind(this.sessionManagerLocal);
+  sessionEvents = this.sessionManagerLocal.sessionEvents;
+
   put: Graffiti["put"];
   get: Graffiti["get"];
   patch: Graffiti["patch"];
   delete: Graffiti["delete"];
   discover: Graffiti["discover"];
   recoverOrphans: Graffiti["recoverOrphans"];
-  synchronizeGet: Graffiti["synchronizeGet"];
-  synchronizeDiscover: Graffiti["synchronizeDiscover"];
-  synchronizeRecoverOrphans: Graffiti["synchronizeRecoverOrphans"];
   channelStats: Graffiti["channelStats"];
 
   constructor(options?: GraffitiLocalOptions) {
     super();
 
-    const sessionManagerLocal = new GraffitiLocalSessionManager();
-    this.login = sessionManagerLocal.login.bind(sessionManagerLocal);
-    this.logout = sessionManagerLocal.logout.bind(sessionManagerLocal);
-    this.sessionEvents = sessionManagerLocal.sessionEvents;
-
     const ajv = new Ajv({ strict: false });
     const graffitiPouchDbBase = new GraffitiLocalDatabase(options, ajv);
-    const graffitiSynchronize = new GraffitiSynchronize(
-      graffitiPouchDbBase,
-      ajv,
-    );
 
-    this.put = graffitiSynchronize.put.bind(graffitiSynchronize);
-    this.get = graffitiSynchronize.get.bind(graffitiSynchronize);
-    this.patch = graffitiSynchronize.patch.bind(graffitiSynchronize);
-    this.delete = graffitiSynchronize.delete.bind(graffitiSynchronize);
-    this.discover = graffitiSynchronize.discover.bind(graffitiSynchronize);
+    this.put = graffitiPouchDbBase.put.bind(graffitiPouchDbBase);
+    this.get = graffitiPouchDbBase.get.bind(graffitiPouchDbBase);
+    this.patch = graffitiPouchDbBase.patch.bind(graffitiPouchDbBase);
+    this.delete = graffitiPouchDbBase.delete.bind(graffitiPouchDbBase);
+    this.discover = graffitiPouchDbBase.discover.bind(graffitiPouchDbBase);
     this.recoverOrphans =
-      graffitiSynchronize.recoverOrphans.bind(graffitiPouchDbBase);
+      graffitiPouchDbBase.recoverOrphans.bind(graffitiPouchDbBase);
     this.channelStats =
       graffitiPouchDbBase.channelStats.bind(graffitiPouchDbBase);
-    this.synchronizeDiscover =
-      graffitiSynchronize.synchronizeDiscover.bind(graffitiSynchronize);
-    this.synchronizeGet =
-      graffitiSynchronize.synchronizeGet.bind(graffitiSynchronize);
-    this.synchronizeRecoverOrphans =
-      graffitiSynchronize.synchronizeRecoverOrphans.bind(graffitiSynchronize);
   }
 }

package/src/tests.spec.ts

@@ -1,7 +1,6 @@
 import {
   graffitiLocationTests,
   graffitiCRUDTests,
-  graffitiSynchronizeTests,
   graffitiDiscoverTests,
   graffitiOrphanTests,
   graffitiChannelStatsTests,
@@ -14,7 +13,6 @@ const useSession2 = () => ({ actor: "someoneelse" });
 
 graffitiLocationTests(useGraffiti);
 graffitiCRUDTests(useGraffiti, useSession1, useSession2);
-graffitiSynchronizeTests(useGraffiti, useSession1, useSession2);
 graffitiDiscoverTests(useGraffiti, useSession1, useSession2);
 graffitiOrphanTests(useGraffiti, useSession1, useSession2);
 graffitiChannelStatsTests(useGraffiti, useSession1, useSession2);

package/dist/cjs/synchronize.js

@@ -1,2 +0,0 @@
-"use strict";var O=Object.create;var h=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var w=Object.getOwnPropertyNames;var z=Object.getPrototypeOf,g=Object.prototype.hasOwnProperty;var S=(r,e)=>{for(var t in e)h(r,t,{get:e[t],enumerable:!0})},d=(r,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of w(e))!g.call(r,a)&&a!==t&&h(r,a,{get:()=>e[a],enumerable:!(i=v(e,a))||i.enumerable});return r};var k=(r,e,t)=>(t=r!=null?O(z(r)):{},d(e||!r||!r.__esModule?h(t,"default",{value:r,enumerable:!0}):t,r)),D=r=>d(h({},"__esModule",{value:!0}),r);var R={};S(R,{GraffitiSynchronize:()=>B});module.exports=D(R);var u=k(require("ajv-draft-04")),y=require("@repeaterjs/repeater"),m=require("fast-json-patch"),c=require("./utilities.js");class B{ajv;graffiti;callbacks=new Set;constructor(e,t){this.ajv=t??new u.default({strict:!1}),this.graffiti=e}async synchronizeDispatch(e,t,i=!1){for(const a of this.callbacks)a(e,t);i&&await new Promise(a=>setTimeout(a,0))}get=async(...e)=>{const t=await this.graffiti.get(...e);return this.synchronizeDispatch(t),t};put=async(...e)=>{const t=await this.graffiti.put(...e),i=e[0],a={...t,value:i.value,channels:i.channels,allowed:i.allowed,tombstone:!1};return await this.synchronizeDispatch(t,a,!0),t};patch=async(...e)=>{const t=await this.graffiti.patch(...e),i={...t};i.tombstone=!1;for(const a of["value","channels","allowed"])(0,c.applyGraffitiPatch)(m.applyPatch,a,e[0],i);return await this.synchronizeDispatch(t,i,!0),t};delete=async(...e)=>{const t=await this.graffiti.delete(...e);return await this.synchronizeDispatch(t,void 0,!0),t};objectStream(e){const t=this.synchronizeDispatch.bind(this);return async function*(){let a=await e.next();for(;!a.done;)a.value.error||t(a.value.value),yield a.value,a=await e.next();return a.value}()}discover=(...e)=>{const t=this.graffiti.discover(...e);return this.objectStream(t)};recoverOrphans=(...e)=>{const t=this.graffiti.recoverOrphans(...e);return this.objectStream(t)};synchronize(e,t,i,a){const s=(0,c.attemptAjvCompile)(this.ajv,i);return new y.Repeater(async(n,l)=>{const b=(j,G)=>{for(const f of[G,j])if(f&&e(f)&&(0,c.isActorAllowedGraffitiObject)(f,a)){const p={...f};if((0,c.maskGraffitiObject)(p,t,a),s(p)){n({value:p});break}}};this.callbacks.add(b),await l,this.callbacks.delete(b)})}synchronizeDiscover=(...e)=>{const[t,i,a]=e;function s(o){return o.channels.some(n=>t.includes(n))}return this.synchronize(s,t,i,a)};synchronizeGet=(...e)=>{const[t,i,a]=e;function s(o){const n=(0,c.locationToUri)(o),{uri:l}=(0,c.unpackLocationOrUri)(t);return n===l}return this.synchronize(s,[],i,a)};synchronizeRecoverOrphans=(...e)=>{const[t,i]=e;function a(s){return s.actor===i.actor&&s.channels.length===0}return this.synchronize(a,[],t,i)}}
-//# sourceMappingURL=synchronize.js.map

package/dist/cjs/synchronize.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/synchronize.ts"],
-  "sourcesContent": ["import Ajv from \"ajv-draft-04\";\nimport type {\n  Graffiti,\n  GraffitiSession,\n  JSONSchema4,\n} from \"@graffiti-garden/api\";\nimport type { GraffitiObjectBase } from \"@graffiti-garden/api\";\nimport { Repeater } from \"@repeaterjs/repeater\";\nimport { applyPatch } from \"fast-json-patch\";\nimport {\n  applyGraffitiPatch,\n  attemptAjvCompile,\n  isActorAllowedGraffitiObject,\n  locationToUri,\n  maskGraffitiObject,\n  unpackLocationOrUri,\n} from \"./utilities.js\";\n\ntype GraffitiDatabaseMethods = Pick<\n  Graffiti,\n  \"get\" | \"put\" | \"patch\" | \"delete\" | \"discover\" | \"recoverOrphans\"\n>;\n\ntype Callback = (\n  oldObject: GraffitiObjectBase,\n  newObject?: GraffitiObjectBase,\n) => void;\n\n/**\n * Wraps a partial implementation of the [Graffiti API](https://api.graffiti.garden/classes/Graffiti.html)\n * to provide the [`synchronize`](https://api.graffiti.garden/classes/Graffiti.html#synchronize) method.\n * The partial implementation must include the primary database methods:\n * `get`, `put`, `patch`, `delete`, and `discover`.\n */\nexport class GraffitiSynchronize\n  implements\n    Pick<\n      Graffiti,\n      | \"put\"\n      | \"get\"\n      | \"patch\"\n      | \"delete\"\n      | \"discover\"\n      | \"recoverOrphans\"\n      | \"synchronizeDiscover\"\n      | \"synchronizeGet\"\n      | \"synchronizeRecoverOrphans\"\n    >\n{\n  protected readonly ajv: Ajv;\n  protected readonly graffiti: GraffitiDatabaseMethods;\n  protected readonly callbacks = new Set<Callback>();\n\n  // Pass in the ajv instance\n  // and database methods to wrap\n  constructor(graffiti: GraffitiDatabaseMethods, ajv?: Ajv) {\n    this.ajv = ajv ?? new Ajv({ strict: false });\n    this.graffiti = graffiti;\n  }\n\n  protected async synchronizeDispatch(\n    oldObject: GraffitiObjectBase,\n    newObject?: GraffitiObjectBase,\n    macroTask = false,\n  ) {\n    for (const callback of this.callbacks) {\n      callback(oldObject, newObject);\n    }\n    if (macroTask) {\n      // Wait for one macro task cycle...\n      // This way the yields, triggered by the callbacks,\n      // will resolve first. Unfortunately, if we try to\n      // use @repeaterjs's `await push` in the callback,\n      // the promise won't resolve until the next\n      // .next() call of the iterator, so if only\n      // one .next() is called, this dispatch will hang.\n      //\n      // Only mutators (put, patch, delete) should bother\n      // using this, so that they can ensure the application\n      // state has been updated everywhere before returning,\n      // for proper feedback.\n      await new Promise((resolve) => setTimeout(resolve, 0));\n    }\n  }\n\n  get: Graffiti[\"get\"] = async (...args) => {\n    const object = await this.graffiti.get(...args);\n    this.synchronizeDispatch(object);\n    return object;\n  };\n\n  put: Graffiti[\"put\"] = async (...args) => {\n    const oldObject = await this.graffiti.put(...args);\n    const partialObject = args[0];\n    const newObject: GraffitiObjectBase = {\n      ...oldObject,\n      value: partialObject.value,\n      channels: partialObject.channels,\n      allowed: partialObject.allowed,\n      tombstone: false,\n    };\n    await this.synchronizeDispatch(oldObject, newObject, true);\n    return oldObject;\n  };\n\n  patch: Graffiti[\"patch\"] = async (...args) => {\n    const oldObject = await this.graffiti.patch(...args);\n    const newObject: GraffitiObjectBase = { ...oldObject };\n    newObject.tombstone = false;\n    for (const prop of [\"value\", \"channels\", \"allowed\"] as const) {\n      applyGraffitiPatch(applyPatch, prop, args[0], newObject);\n    }\n    await this.synchronizeDispatch(oldObject, newObject, true);\n    return oldObject;\n  };\n\n  delete: Graffiti[\"delete\"] = async (...args) => {\n    const oldObject = await this.graffiti.delete(...args);\n    await this.synchronizeDispatch(oldObject, undefined, true);\n    return oldObject;\n  };\n\n  protected objectStream<Schema extends JSONSchema4>(\n    iterator: ReturnType<typeof Graffiti.prototype.discover<Schema>>,\n  ) {\n    const dispatch = this.synchronizeDispatch.bind(this);\n    const wrapper = async function* () {\n      let result = await iterator.next();\n      while (!result.done) {\n        if (!result.value.error) {\n          dispatch(result.value.value);\n        }\n        yield result.value;\n        result = await iterator.next();\n      }\n      return result.value;\n    };\n    return wrapper();\n  }\n\n  discover: Graffiti[\"discover\"] = (...args) => {\n    const iterator = this.graffiti.discover(...args);\n    return this.objectStream(iterator);\n  };\n\n  recoverOrphans: Graffiti[\"recoverOrphans\"] = (...args) => {\n    const iterator = this.graffiti.recoverOrphans(...args);\n    return this.objectStream(iterator);\n  };\n\n  protected synchronize<Schema extends JSONSchema4>(\n    matchObject: (object: GraffitiObjectBase) => boolean,\n    channels: string[],\n    schema: Schema,\n    session?: GraffitiSession | null,\n  ) {\n    const validate = attemptAjvCompile(this.ajv, schema);\n\n    const repeater: ReturnType<\n      typeof Graffiti.prototype.synchronizeDiscover<typeof schema>\n    > = new Repeater(async (push, stop) => {\n      const callback: Callback = (oldObjectRaw, newObjectRaw) => {\n        for (const objectRaw of [newObjectRaw, oldObjectRaw]) {\n          if (\n            objectRaw &&\n            matchObject(objectRaw) &&\n            isActorAllowedGraffitiObject(objectRaw, session)\n          ) {\n            const object = { ...objectRaw };\n            maskGraffitiObject(object, channels, session);\n            if (validate(object)) {\n              push({ value: object });\n              break;\n            }\n          }\n        }\n      };\n\n      this.callbacks.add(callback);\n      await stop;\n      this.callbacks.delete(callback);\n    });\n\n    return repeater;\n  }\n\n  synchronizeDiscover: Graffiti[\"synchronizeDiscover\"] = (...args) => {\n    const [channels, schema, session] = args;\n    function matchObject(object: GraffitiObjectBase) {\n      return object.channels.some((channel) => channels.includes(channel));\n    }\n    return this.synchronize(matchObject, channels, schema, session);\n  };\n\n  synchronizeGet: Graffiti[\"synchronizeGet\"] = (...args) => {\n    const [locationOrUri, schema, session] = args;\n    function matchObject(object: GraffitiObjectBase) {\n      const objectUri = locationToUri(object);\n      const { uri } = unpackLocationOrUri(locationOrUri);\n      return objectUri === uri;\n    }\n    return this.synchronize(matchObject, [], schema, session);\n  };\n\n  synchronizeRecoverOrphans: Graffiti[\"synchronizeRecoverOrphans\"] = (\n    ...args\n  ) => {\n    const [schema, session] = args;\n    function matchObject(object: GraffitiObjectBase) {\n      return object.actor === session.actor && object.channels.length === 0;\n    }\n    return this.synchronize(matchObject, [], schema, session);\n  };\n}\n"],
-  "mappings": "0jBAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,yBAAAE,IAAA,eAAAC,EAAAH,GAAA,IAAAI,EAAgB,2BAOhBC,EAAyB,gCACzBC,EAA2B,2BAC3BC,EAOO,0BAkBA,MAAML,CAcb,CACqB,IACA,SACA,UAAY,IAAI,IAInC,YAAYM,EAAmCC,EAAW,CACxD,KAAK,IAAMA,GAAO,IAAI,EAAAC,QAAI,CAAE,OAAQ,EAAM,CAAC,EAC3C,KAAK,SAAWF,CAClB,CAEA,MAAgB,oBACdG,EACAC,EACAC,EAAY,GACZ,CACA,UAAWC,KAAY,KAAK,UAC1BA,EAASH,EAAWC,CAAS,EAE3BC,GAaF,MAAM,IAAI,QAASE,GAAY,WAAWA,EAAS,CAAC,CAAC,CAEzD,CAEA,IAAuB,SAAUC,IAAS,CACxC,MAAMC,EAAS,MAAM,KAAK,SAAS,IAAI,GAAGD,CAAI,EAC9C,YAAK,oBAAoBC,CAAM,EACxBA,CACT,EAEA,IAAuB,SAAUD,IAAS,CACxC,MAAML,EAAY,MAAM,KAAK,SAAS,IAAI,GAAGK,CAAI,EAC3CE,EAAgBF,EAAK,CAAC,EACtBJ,EAAgC,CACpC,GAAGD,EACH,MAAOO,EAAc,MACrB,SAAUA,EAAc,SACxB,QAASA,EAAc,QACvB,UAAW,EACb,EACA,aAAM,KAAK,oBAAoBP,EAAWC,EAAW,EAAI,EAClDD,CACT,EAEA,MAA2B,SAAUK,IAAS,CAC5C,MAAML,EAAY,MAAM,KAAK,SAAS,MAAM,GAAGK,CAAI,EAC7CJ,EAAgC,CAAE,GAAGD,CAAU,EACrDC,EAAU,UAAY,GACtB,UAAWO,IAAQ,CAAC,QAAS,WAAY,SAAS,KAChD,sBAAmB,aAAYA,EAAMH,EAAK,CAAC,EAAGJ,CAAS,EAEzD,aAAM,KAAK,oBAAoBD,EAAWC,EAAW,EAAI,EAClDD,CACT,EAEA,OAA6B,SAAUK,IAAS,CAC9C,MAAML,EAAY,MAAM,KAAK,SAAS,OAAO,GAAGK,CAAI,EACpD,aAAM,KAAK,oBAAoBL,EAAW,OAAW,EAAI,EAClDA,CACT,EAEU,aACRS,EACA,CACA,MAAMC,EAAW,KAAK,oBAAoB,KAAK,IAAI,EAYnD,OAXgB,iBAAmB,CACjC,IAAIC,EAAS,MAAMF,EAAS,KAAK,EACjC,KAAO,CAACE,EAAO,MACRA,EAAO,MAAM,OAChBD,EAASC,EAAO,MAAM,KAAK,EAE7B,MAAMA,EAAO,MACbA,EAAS,MAAMF,EAAS,KAAK,EAE/B,OAAOE,EAAO,KAChB,EACe,CACjB,CAEA,SAAiC,IAAIN,IAAS,CAC5C,MAAMI,EAAW,KAAK,SAAS,SAAS,GAAGJ,CAAI,EAC/C,OAAO,KAAK,aAAaI,CAAQ,CACnC,EAEA,eAA6C,IAAIJ,IAAS,CACxD,MAAMI,EAAW,KAAK,SAAS,eAAe,GAAGJ,CAAI,EACrD,OAAO,KAAK,aAAaI,CAAQ,CACnC,EAEU,YACRG,EACAC,EACAC,EACAC,EACA,CACA,MAAMC,KAAW,qBAAkB,KAAK,IAAKF,CAAM,EA2BnD,OAvBI,IAAI,WAAS,MAAOG,EAAMC,IAAS,CACrC,MAAMf,EAAqB,CAACgB,EAAcC,IAAiB,CACzD,UAAWC,IAAa,CAACD,EAAcD,CAAY,EACjD,GACEE,GACAT,EAAYS,CAAS,MACrB,gCAA6BA,EAAWN,CAAO,EAC/C,CACA,MAAMT,EAAS,CAAE,GAAGe,CAAU,EAE9B,MADA,sBAAmBf,EAAQO,EAAUE,CAAO,EACxCC,EAASV,CAAM,EAAG,CACpBW,EAAK,CAAE,MAAOX,CAAO,CAAC,EACtB,KACF,CACF,CAEJ,EAEA,KAAK,UAAU,IAAIH,CAAQ,EAC3B,MAAMe,EACN,KAAK,UAAU,OAAOf,CAAQ,CAChC,CAAC,CAGH,CAEA,oBAAuD,IAAIE,IAAS,CAClE,KAAM,CAACQ,EAAUC,EAAQC,CAAO,EAAIV,EACpC,SAASO,EAAYN,EAA4B,CAC/C,OAAOA,EAAO,SAAS,KAAMgB,GAAYT,EAAS,SAASS,CAAO,CAAC,CACrE,CACA,OAAO,KAAK,YAAYV,EAAaC,EAAUC,EAAQC,CAAO,CAChE,EAEA,eAA6C,IAAIV,IAAS,CACxD,KAAM,CAACkB,EAAeT,EAAQC,CAAO,EAAIV,EACzC,SAASO,EAAYN,EAA4B,CAC/C,MAAMkB,KAAY,iBAAclB,CAAM,EAChC,CAAE,IAAAmB,CAAI,KAAI,uBAAoBF,CAAa,EACjD,OAAOC,IAAcC,CACvB,CACA,OAAO,KAAK,YAAYb,EAAa,CAAC,EAAGE,EAAQC,CAAO,CAC1D,EAEA,0BAAmE,IAC9DV,IACA,CACH,KAAM,CAACS,EAAQC,CAAO,EAAIV,EAC1B,SAASO,EAAYN,EAA4B,CAC/C,OAAOA,EAAO,QAAUS,EAAQ,OAAST,EAAO,SAAS,SAAW,CACtE,CACA,OAAO,KAAK,YAAYM,EAAa,CAAC,EAAGE,EAAQC,CAAO,CAC1D,CACF",
-  "names": ["synchronize_exports", "__export", "GraffitiSynchronize", "__toCommonJS", "import_ajv_draft_04", "import_repeater", "import_fast_json_patch", "import_utilities", "graffiti", "ajv", "Ajv", "oldObject", "newObject", "macroTask", "callback", "resolve", "args", "object", "partialObject", "prop", "iterator", "dispatch", "result", "matchObject", "channels", "schema", "session", "validate", "push", "stop", "oldObjectRaw", "newObjectRaw", "objectRaw", "channel", "locationOrUri", "objectUri", "uri"]
-}

package/dist/esm/synchronize.js

@@ -1,2 +0,0 @@
-import b from"ajv-draft-04";import{Repeater as d}from"@repeaterjs/repeater";import{applyPatch as u}from"fast-json-patch";import{applyGraffitiPatch as y,attemptAjvCompile as m,isActorAllowedGraffitiObject as j,locationToUri as G,maskGraffitiObject as O,unpackLocationOrUri as v}from"./utilities.js";class D{ajv;graffiti;callbacks=new Set;constructor(e,t){this.ajv=t??new b({strict:!1}),this.graffiti=e}async synchronizeDispatch(e,t,i=!1){for(const a of this.callbacks)a(e,t);i&&await new Promise(a=>setTimeout(a,0))}get=async(...e)=>{const t=await this.graffiti.get(...e);return this.synchronizeDispatch(t),t};put=async(...e)=>{const t=await this.graffiti.put(...e),i=e[0],a={...t,value:i.value,channels:i.channels,allowed:i.allowed,tombstone:!1};return await this.synchronizeDispatch(t,a,!0),t};patch=async(...e)=>{const t=await this.graffiti.patch(...e),i={...t};i.tombstone=!1;for(const a of["value","channels","allowed"])y(u,a,e[0],i);return await this.synchronizeDispatch(t,i,!0),t};delete=async(...e)=>{const t=await this.graffiti.delete(...e);return await this.synchronizeDispatch(t,void 0,!0),t};objectStream(e){const t=this.synchronizeDispatch.bind(this);return async function*(){let a=await e.next();for(;!a.done;)a.value.error||t(a.value.value),yield a.value,a=await e.next();return a.value}()}discover=(...e)=>{const t=this.graffiti.discover(...e);return this.objectStream(t)};recoverOrphans=(...e)=>{const t=this.graffiti.recoverOrphans(...e);return this.objectStream(t)};synchronize(e,t,i,a){const r=m(this.ajv,i);return new d(async(c,o)=>{const h=(l,p)=>{for(const n of[p,l])if(n&&e(n)&&j(n,a)){const f={...n};if(O(f,t,a),r(f)){c({value:f});break}}};this.callbacks.add(h),await o,this.callbacks.delete(h)})}synchronizeDiscover=(...e)=>{const[t,i,a]=e;function r(s){return s.channels.some(c=>t.includes(c))}return this.synchronize(r,t,i,a)};synchronizeGet=(...e)=>{const[t,i,a]=e;function r(s){const c=G(s),{uri:o}=v(t);return c===o}return this.synchronize(r,[],i,a)};synchronizeRecoverOrphans=(...e)=>{const[t,i]=e;function a(r){return r.actor===i.actor&&r.channels.length===0}return this.synchronize(a,[],t,i)}}export{D as GraffitiSynchronize};
-//# sourceMappingURL=synchronize.js.map

package/dist/esm/synchronize.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/synchronize.ts"],
-  "sourcesContent": ["import Ajv from \"ajv-draft-04\";\nimport type {\n  Graffiti,\n  GraffitiSession,\n  JSONSchema4,\n} from \"@graffiti-garden/api\";\nimport type { GraffitiObjectBase } from \"@graffiti-garden/api\";\nimport { Repeater } from \"@repeaterjs/repeater\";\nimport { applyPatch } from \"fast-json-patch\";\nimport {\n  applyGraffitiPatch,\n  attemptAjvCompile,\n  isActorAllowedGraffitiObject,\n  locationToUri,\n  maskGraffitiObject,\n  unpackLocationOrUri,\n} from \"./utilities.js\";\n\ntype GraffitiDatabaseMethods = Pick<\n  Graffiti,\n  \"get\" | \"put\" | \"patch\" | \"delete\" | \"discover\" | \"recoverOrphans\"\n>;\n\ntype Callback = (\n  oldObject: GraffitiObjectBase,\n  newObject?: GraffitiObjectBase,\n) => void;\n\n/**\n * Wraps a partial implementation of the [Graffiti API](https://api.graffiti.garden/classes/Graffiti.html)\n * to provide the [`synchronize`](https://api.graffiti.garden/classes/Graffiti.html#synchronize) method.\n * The partial implementation must include the primary database methods:\n * `get`, `put`, `patch`, `delete`, and `discover`.\n */\nexport class GraffitiSynchronize\n  implements\n    Pick<\n      Graffiti,\n      | \"put\"\n      | \"get\"\n      | \"patch\"\n      | \"delete\"\n      | \"discover\"\n      | \"recoverOrphans\"\n      | \"synchronizeDiscover\"\n      | \"synchronizeGet\"\n      | \"synchronizeRecoverOrphans\"\n    >\n{\n  protected readonly ajv: Ajv;\n  protected readonly graffiti: GraffitiDatabaseMethods;\n  protected readonly callbacks = new Set<Callback>();\n\n  // Pass in the ajv instance\n  // and database methods to wrap\n  constructor(graffiti: GraffitiDatabaseMethods, ajv?: Ajv) {\n    this.ajv = ajv ?? new Ajv({ strict: false });\n    this.graffiti = graffiti;\n  }\n\n  protected async synchronizeDispatch(\n    oldObject: GraffitiObjectBase,\n    newObject?: GraffitiObjectBase,\n    macroTask = false,\n  ) {\n    for (const callback of this.callbacks) {\n      callback(oldObject, newObject);\n    }\n    if (macroTask) {\n      // Wait for one macro task cycle...\n      // This way the yields, triggered by the callbacks,\n      // will resolve first. Unfortunately, if we try to\n      // use @repeaterjs's `await push` in the callback,\n      // the promise won't resolve until the next\n      // .next() call of the iterator, so if only\n      // one .next() is called, this dispatch will hang.\n      //\n      // Only mutators (put, patch, delete) should bother\n      // using this, so that they can ensure the application\n      // state has been updated everywhere before returning,\n      // for proper feedback.\n      await new Promise((resolve) => setTimeout(resolve, 0));\n    }\n  }\n\n  get: Graffiti[\"get\"] = async (...args) => {\n    const object = await this.graffiti.get(...args);\n    this.synchronizeDispatch(object);\n    return object;\n  };\n\n  put: Graffiti[\"put\"] = async (...args) => {\n    const oldObject = await this.graffiti.put(...args);\n    const partialObject = args[0];\n    const newObject: GraffitiObjectBase = {\n      ...oldObject,\n      value: partialObject.value,\n      channels: partialObject.channels,\n      allowed: partialObject.allowed,\n      tombstone: false,\n    };\n    await this.synchronizeDispatch(oldObject, newObject, true);\n    return oldObject;\n  };\n\n  patch: Graffiti[\"patch\"] = async (...args) => {\n    const oldObject = await this.graffiti.patch(...args);\n    const newObject: GraffitiObjectBase = { ...oldObject };\n    newObject.tombstone = false;\n    for (const prop of [\"value\", \"channels\", \"allowed\"] as const) {\n      applyGraffitiPatch(applyPatch, prop, args[0], newObject);\n    }\n    await this.synchronizeDispatch(oldObject, newObject, true);\n    return oldObject;\n  };\n\n  delete: Graffiti[\"delete\"] = async (...args) => {\n    const oldObject = await this.graffiti.delete(...args);\n    await this.synchronizeDispatch(oldObject, undefined, true);\n    return oldObject;\n  };\n\n  protected objectStream<Schema extends JSONSchema4>(\n    iterator: ReturnType<typeof Graffiti.prototype.discover<Schema>>,\n  ) {\n    const dispatch = this.synchronizeDispatch.bind(this);\n    const wrapper = async function* () {\n      let result = await iterator.next();\n      while (!result.done) {\n        if (!result.value.error) {\n          dispatch(result.value.value);\n        }\n        yield result.value;\n        result = await iterator.next();\n      }\n      return result.value;\n    };\n    return wrapper();\n  }\n\n  discover: Graffiti[\"discover\"] = (...args) => {\n    const iterator = this.graffiti.discover(...args);\n    return this.objectStream(iterator);\n  };\n\n  recoverOrphans: Graffiti[\"recoverOrphans\"] = (...args) => {\n    const iterator = this.graffiti.recoverOrphans(...args);\n    return this.objectStream(iterator);\n  };\n\n  protected synchronize<Schema extends JSONSchema4>(\n    matchObject: (object: GraffitiObjectBase) => boolean,\n    channels: string[],\n    schema: Schema,\n    session?: GraffitiSession | null,\n  ) {\n    const validate = attemptAjvCompile(this.ajv, schema);\n\n    const repeater: ReturnType<\n      typeof Graffiti.prototype.synchronizeDiscover<typeof schema>\n    > = new Repeater(async (push, stop) => {\n      const callback: Callback = (oldObjectRaw, newObjectRaw) => {\n        for (const objectRaw of [newObjectRaw, oldObjectRaw]) {\n          if (\n            objectRaw &&\n            matchObject(objectRaw) &&\n            isActorAllowedGraffitiObject(objectRaw, session)\n          ) {\n            const object = { ...objectRaw };\n            maskGraffitiObject(object, channels, session);\n            if (validate(object)) {\n              push({ value: object });\n              break;\n            }\n          }\n        }\n      };\n\n      this.callbacks.add(callback);\n      await stop;\n      this.callbacks.delete(callback);\n    });\n\n    return repeater;\n  }\n\n  synchronizeDiscover: Graffiti[\"synchronizeDiscover\"] = (...args) => {\n    const [channels, schema, session] = args;\n    function matchObject(object: GraffitiObjectBase) {\n      return object.channels.some((channel) => channels.includes(channel));\n    }\n    return this.synchronize(matchObject, channels, schema, session);\n  };\n\n  synchronizeGet: Graffiti[\"synchronizeGet\"] = (...args) => {\n    const [locationOrUri, schema, session] = args;\n    function matchObject(object: GraffitiObjectBase) {\n      const objectUri = locationToUri(object);\n      const { uri } = unpackLocationOrUri(locationOrUri);\n      return objectUri === uri;\n    }\n    return this.synchronize(matchObject, [], schema, session);\n  };\n\n  synchronizeRecoverOrphans: Graffiti[\"synchronizeRecoverOrphans\"] = (\n    ...args\n  ) => {\n    const [schema, session] = args;\n    function matchObject(object: GraffitiObjectBase) {\n      return object.actor === session.actor && object.channels.length === 0;\n    }\n    return this.synchronize(matchObject, [], schema, session);\n  };\n}\n"],
-  "mappings": "AAAA,OAAOA,MAAS,eAOhB,OAAS,YAAAC,MAAgB,uBACzB,OAAS,cAAAC,MAAkB,kBAC3B,OACE,sBAAAC,EACA,qBAAAC,EACA,gCAAAC,EACA,iBAAAC,EACA,sBAAAC,EACA,uBAAAC,MACK,iBAkBA,MAAMC,CAcb,CACqB,IACA,SACA,UAAY,IAAI,IAInC,YAAYC,EAAmCC,EAAW,CACxD,KAAK,IAAMA,GAAO,IAAIX,EAAI,CAAE,OAAQ,EAAM,CAAC,EAC3C,KAAK,SAAWU,CAClB,CAEA,MAAgB,oBACdE,EACAC,EACAC,EAAY,GACZ,CACA,UAAWC,KAAY,KAAK,UAC1BA,EAASH,EAAWC,CAAS,EAE3BC,GAaF,MAAM,IAAI,QAASE,GAAY,WAAWA,EAAS,CAAC,CAAC,CAEzD,CAEA,IAAuB,SAAUC,IAAS,CACxC,MAAMC,EAAS,MAAM,KAAK,SAAS,IAAI,GAAGD,CAAI,EAC9C,YAAK,oBAAoBC,CAAM,EACxBA,CACT,EAEA,IAAuB,SAAUD,IAAS,CACxC,MAAML,EAAY,MAAM,KAAK,SAAS,IAAI,GAAGK,CAAI,EAC3CE,EAAgBF,EAAK,CAAC,EACtBJ,EAAgC,CACpC,GAAGD,EACH,MAAOO,EAAc,MACrB,SAAUA,EAAc,SACxB,QAASA,EAAc,QACvB,UAAW,EACb,EACA,aAAM,KAAK,oBAAoBP,EAAWC,EAAW,EAAI,EAClDD,CACT,EAEA,MAA2B,SAAUK,IAAS,CAC5C,MAAML,EAAY,MAAM,KAAK,SAAS,MAAM,GAAGK,CAAI,EAC7CJ,EAAgC,CAAE,GAAGD,CAAU,EACrDC,EAAU,UAAY,GACtB,UAAWO,IAAQ,CAAC,QAAS,WAAY,SAAS,EAChDjB,EAAmBD,EAAYkB,EAAMH,EAAK,CAAC,EAAGJ,CAAS,EAEzD,aAAM,KAAK,oBAAoBD,EAAWC,EAAW,EAAI,EAClDD,CACT,EAEA,OAA6B,SAAUK,IAAS,CAC9C,MAAML,EAAY,MAAM,KAAK,SAAS,OAAO,GAAGK,CAAI,EACpD,aAAM,KAAK,oBAAoBL,EAAW,OAAW,EAAI,EAClDA,CACT,EAEU,aACRS,EACA,CACA,MAAMC,EAAW,KAAK,oBAAoB,KAAK,IAAI,EAYnD,OAXgB,iBAAmB,CACjC,IAAIC,EAAS,MAAMF,EAAS,KAAK,EACjC,KAAO,CAACE,EAAO,MACRA,EAAO,MAAM,OAChBD,EAASC,EAAO,MAAM,KAAK,EAE7B,MAAMA,EAAO,MACbA,EAAS,MAAMF,EAAS,KAAK,EAE/B,OAAOE,EAAO,KAChB,EACe,CACjB,CAEA,SAAiC,IAAIN,IAAS,CAC5C,MAAMI,EAAW,KAAK,SAAS,SAAS,GAAGJ,CAAI,EAC/C,OAAO,KAAK,aAAaI,CAAQ,CACnC,EAEA,eAA6C,IAAIJ,IAAS,CACxD,MAAMI,EAAW,KAAK,SAAS,eAAe,GAAGJ,CAAI,EACrD,OAAO,KAAK,aAAaI,CAAQ,CACnC,EAEU,YACRG,EACAC,EACAC,EACAC,EACA,CACA,MAAMC,EAAWxB,EAAkB,KAAK,IAAKsB,CAAM,EA2BnD,OAvBI,IAAIzB,EAAS,MAAO4B,EAAMC,IAAS,CACrC,MAAMf,EAAqB,CAACgB,EAAcC,IAAiB,CACzD,UAAWC,IAAa,CAACD,EAAcD,CAAY,EACjD,GACEE,GACAT,EAAYS,CAAS,GACrB5B,EAA6B4B,EAAWN,CAAO,EAC/C,CACA,MAAMT,EAAS,CAAE,GAAGe,CAAU,EAE9B,GADA1B,EAAmBW,EAAQO,EAAUE,CAAO,EACxCC,EAASV,CAAM,EAAG,CACpBW,EAAK,CAAE,MAAOX,CAAO,CAAC,EACtB,KACF,CACF,CAEJ,EAEA,KAAK,UAAU,IAAIH,CAAQ,EAC3B,MAAMe,EACN,KAAK,UAAU,OAAOf,CAAQ,CAChC,CAAC,CAGH,CAEA,oBAAuD,IAAIE,IAAS,CAClE,KAAM,CAACQ,EAAUC,EAAQC,CAAO,EAAIV,EACpC,SAASO,EAAYN,EAA4B,CAC/C,OAAOA,EAAO,SAAS,KAAMgB,GAAYT,EAAS,SAASS,CAAO,CAAC,CACrE,CACA,OAAO,KAAK,YAAYV,EAAaC,EAAUC,EAAQC,CAAO,CAChE,EAEA,eAA6C,IAAIV,IAAS,CACxD,KAAM,CAACkB,EAAeT,EAAQC,CAAO,EAAIV,EACzC,SAASO,EAAYN,EAA4B,CAC/C,MAAMkB,EAAY9B,EAAcY,CAAM,EAChC,CAAE,IAAAmB,CAAI,EAAI7B,EAAoB2B,CAAa,EACjD,OAAOC,IAAcC,CACvB,CACA,OAAO,KAAK,YAAYb,EAAa,CAAC,EAAGE,EAAQC,CAAO,CAC1D,EAEA,0BAAmE,IAC9DV,IACA,CACH,KAAM,CAACS,EAAQC,CAAO,EAAIV,EAC1B,SAASO,EAAYN,EAA4B,CAC/C,OAAOA,EAAO,QAAUS,EAAQ,OAAST,EAAO,SAAS,SAAW,CACtE,CACA,OAAO,KAAK,YAAYM,EAAa,CAAC,EAAGE,EAAQC,CAAO,CAC1D,CACF",
-  "names": ["Ajv", "Repeater", "applyPatch", "applyGraffitiPatch", "attemptAjvCompile", "isActorAllowedGraffitiObject", "locationToUri", "maskGraffitiObject", "unpackLocationOrUri", "GraffitiSynchronize", "graffiti", "ajv", "oldObject", "newObject", "macroTask", "callback", "resolve", "args", "object", "partialObject", "prop", "iterator", "dispatch", "result", "matchObject", "channels", "schema", "session", "validate", "push", "stop", "oldObjectRaw", "newObjectRaw", "objectRaw", "channel", "locationOrUri", "objectUri", "uri"]
-}

package/dist/synchronize.d.ts

@@ -1,39 +0,0 @@
-import Ajv from "ajv-draft-04";
-import type { Graffiti, GraffitiSession, JSONSchema4 } from "@graffiti-garden/api";
-import type { GraffitiObjectBase } from "@graffiti-garden/api";
-type GraffitiDatabaseMethods = Pick<Graffiti, "get" | "put" | "patch" | "delete" | "discover" | "recoverOrphans">;
-type Callback = (oldObject: GraffitiObjectBase, newObject?: GraffitiObjectBase) => void;
-/**
- * Wraps a partial implementation of the [Graffiti API](https://api.graffiti.garden/classes/Graffiti.html)
- * to provide the [`synchronize`](https://api.graffiti.garden/classes/Graffiti.html#synchronize) method.
- * The partial implementation must include the primary database methods:
- * `get`, `put`, `patch`, `delete`, and `discover`.
- */
-export declare class GraffitiSynchronize implements Pick<Graffiti, "put" | "get" | "patch" | "delete" | "discover" | "recoverOrphans" | "synchronizeDiscover" | "synchronizeGet" | "synchronizeRecoverOrphans"> {
-    protected readonly ajv: Ajv;
-    protected readonly graffiti: GraffitiDatabaseMethods;
-    protected readonly callbacks: Set<Callback>;
-    constructor(graffiti: GraffitiDatabaseMethods, ajv?: Ajv);
-    protected synchronizeDispatch(oldObject: GraffitiObjectBase, newObject?: GraffitiObjectBase, macroTask?: boolean): Promise<void>;
-    get: Graffiti["get"];
-    put: Graffiti["put"];
-    patch: Graffiti["patch"];
-    delete: Graffiti["delete"];
-    protected objectStream<Schema extends JSONSchema4>(iterator: ReturnType<typeof Graffiti.prototype.discover<Schema>>): AsyncGenerator<{
-        error: Error;
-        source: string;
-    } | {
-        error?: undefined;
-        value: import("@graffiti-garden/api").GraffitiObject<Schema>;
-    }, {
-        tombstoneRetention: number;
-    }, unknown>;
-    discover: Graffiti["discover"];
-    recoverOrphans: Graffiti["recoverOrphans"];
-    protected synchronize<Schema extends JSONSchema4>(matchObject: (object: GraffitiObjectBase) => boolean, channels: string[], schema: Schema, session?: GraffitiSession | null): import("@graffiti-garden/api").GraffitiStream<import("@graffiti-garden/api").GraffitiObject<Schema>>;
-    synchronizeDiscover: Graffiti["synchronizeDiscover"];
-    synchronizeGet: Graffiti["synchronizeGet"];
-    synchronizeRecoverOrphans: Graffiti["synchronizeRecoverOrphans"];
-}
-export {};
-//# sourceMappingURL=synchronize.d.ts.map

package/dist/synchronize.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"synchronize.d.ts","sourceRoot":"","sources":["../src/synchronize.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,cAAc,CAAC;AAC/B,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EACf,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAY/D,KAAK,uBAAuB,GAAG,IAAI,CACjC,QAAQ,EACR,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,gBAAgB,CACnE,CAAC;AAEF,KAAK,QAAQ,GAAG,CACd,SAAS,EAAE,kBAAkB,EAC7B,SAAS,CAAC,EAAE,kBAAkB,KAC3B,IAAI,CAAC;AAEV;;;;;GAKG;AACH,qBAAa,mBACX,YACE,IAAI,CACF,QAAQ,EACN,KAAK,GACL,KAAK,GACL,OAAO,GACP,QAAQ,GACR,UAAU,GACV,gBAAgB,GAChB,qBAAqB,GACrB,gBAAgB,GAChB,2BAA2B,CAC9B;IAEH,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAC5B,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IACrD,SAAS,CAAC,QAAQ,CAAC,SAAS,gBAAuB;gBAIvC,QAAQ,EAAE,uBAAuB,EAAE,GAAG,CAAC,EAAE,GAAG;cAKxC,mBAAmB,CACjC,SAAS,EAAE,kBAAkB,EAC7B,SAAS,CAAC,EAAE,kBAAkB,EAC9B,SAAS,UAAQ;IAsBnB,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAIlB;IAEF,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAYlB;IAEF,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAStB;IAEF,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAIxB;IAEF,SAAS,CAAC,YAAY,CAAC,MAAM,SAAS,WAAW,EAC/C,QAAQ,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;;;;;;;;;IAiBlE,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAG5B;IAEF,cAAc,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAGxC;IAEF,SAAS,CAAC,WAAW,CAAC,MAAM,SAAS,WAAW,EAC9C,WAAW,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,EACpD,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI;IAgClC,mBAAmB,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAMlD;IAEF,cAAc,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAQxC;IAEF,yBAAyB,EAAE,QAAQ,CAAC,2BAA2B,CAAC,CAQ9D;CACH"}

package/src/synchronize.ts

@@ -1,214 +0,0 @@
-import Ajv from "ajv-draft-04";
-import type {
-  Graffiti,
-  GraffitiSession,
-  JSONSchema4,
-} from "@graffiti-garden/api";
-import type { GraffitiObjectBase } from "@graffiti-garden/api";
-import { Repeater } from "@repeaterjs/repeater";
-import { applyPatch } from "fast-json-patch";
-import {
-  applyGraffitiPatch,
-  attemptAjvCompile,
-  isActorAllowedGraffitiObject,
-  locationToUri,
-  maskGraffitiObject,
-  unpackLocationOrUri,
-} from "./utilities.js";
-
-type GraffitiDatabaseMethods = Pick<
-  Graffiti,
-  "get" | "put" | "patch" | "delete" | "discover" | "recoverOrphans"
->;
-
-type Callback = (
-  oldObject: GraffitiObjectBase,
-  newObject?: GraffitiObjectBase,
-) => void;
-
-/**
- * Wraps a partial implementation of the [Graffiti API](https://api.graffiti.garden/classes/Graffiti.html)
- * to provide the [`synchronize`](https://api.graffiti.garden/classes/Graffiti.html#synchronize) method.
- * The partial implementation must include the primary database methods:
- * `get`, `put`, `patch`, `delete`, and `discover`.
- */
-export class GraffitiSynchronize
-  implements
-    Pick<
-      Graffiti,
-      | "put"
-      | "get"
-      | "patch"
-      | "delete"
-      | "discover"
-      | "recoverOrphans"
-      | "synchronizeDiscover"
-      | "synchronizeGet"
-      | "synchronizeRecoverOrphans"
-    >
-{
-  protected readonly ajv: Ajv;
-  protected readonly graffiti: GraffitiDatabaseMethods;
-  protected readonly callbacks = new Set<Callback>();
-
-  // Pass in the ajv instance
-  // and database methods to wrap
-  constructor(graffiti: GraffitiDatabaseMethods, ajv?: Ajv) {
-    this.ajv = ajv ?? new Ajv({ strict: false });
-    this.graffiti = graffiti;
-  }
-
-  protected async synchronizeDispatch(
-    oldObject: GraffitiObjectBase,
-    newObject?: GraffitiObjectBase,
-    macroTask = false,
-  ) {
-    for (const callback of this.callbacks) {
-      callback(oldObject, newObject);
-    }
-    if (macroTask) {
-      // Wait for one macro task cycle...
-      // This way the yields, triggered by the callbacks,
-      // will resolve first. Unfortunately, if we try to
-      // use @repeaterjs's `await push` in the callback,
-      // the promise won't resolve until the next
-      // .next() call of the iterator, so if only
-      // one .next() is called, this dispatch will hang.
-      //
-      // Only mutators (put, patch, delete) should bother
-      // using this, so that they can ensure the application
-      // state has been updated everywhere before returning,
-      // for proper feedback.
-      await new Promise((resolve) => setTimeout(resolve, 0));
-    }
-  }
-
-  get: Graffiti["get"] = async (...args) => {
-    const object = await this.graffiti.get(...args);
-    this.synchronizeDispatch(object);
-    return object;
-  };
-
-  put: Graffiti["put"] = async (...args) => {
-    const oldObject = await this.graffiti.put(...args);
-    const partialObject = args[0];
-    const newObject: GraffitiObjectBase = {
-      ...oldObject,
-      value: partialObject.value,
-      channels: partialObject.channels,
-      allowed: partialObject.allowed,
-      tombstone: false,
-    };
-    await this.synchronizeDispatch(oldObject, newObject, true);
-    return oldObject;
-  };
-
-  patch: Graffiti["patch"] = async (...args) => {
-    const oldObject = await this.graffiti.patch(...args);
-    const newObject: GraffitiObjectBase = { ...oldObject };
-    newObject.tombstone = false;
-    for (const prop of ["value", "channels", "allowed"] as const) {
-      applyGraffitiPatch(applyPatch, prop, args[0], newObject);
-    }
-    await this.synchronizeDispatch(oldObject, newObject, true);
-    return oldObject;
-  };
-
-  delete: Graffiti["delete"] = async (...args) => {
-    const oldObject = await this.graffiti.delete(...args);
-    await this.synchronizeDispatch(oldObject, undefined, true);
-    return oldObject;
-  };
-
-  protected objectStream<Schema extends JSONSchema4>(
-    iterator: ReturnType<typeof Graffiti.prototype.discover<Schema>>,
-  ) {
-    const dispatch = this.synchronizeDispatch.bind(this);
-    const wrapper = async function* () {
-      let result = await iterator.next();
-      while (!result.done) {
-        if (!result.value.error) {
-          dispatch(result.value.value);
-        }
-        yield result.value;
-        result = await iterator.next();
-      }
-      return result.value;
-    };
-    return wrapper();
-  }
-
-  discover: Graffiti["discover"] = (...args) => {
-    const iterator = this.graffiti.discover(...args);
-    return this.objectStream(iterator);
-  };
-
-  recoverOrphans: Graffiti["recoverOrphans"] = (...args) => {
-    const iterator = this.graffiti.recoverOrphans(...args);
-    return this.objectStream(iterator);
-  };
-
-  protected synchronize<Schema extends JSONSchema4>(
-    matchObject: (object: GraffitiObjectBase) => boolean,
-    channels: string[],
-    schema: Schema,
-    session?: GraffitiSession | null,
-  ) {
-    const validate = attemptAjvCompile(this.ajv, schema);
-
-    const repeater: ReturnType<
-      typeof Graffiti.prototype.synchronizeDiscover<typeof schema>
-    > = new Repeater(async (push, stop) => {
-      const callback: Callback = (oldObjectRaw, newObjectRaw) => {
-        for (const objectRaw of [newObjectRaw, oldObjectRaw]) {
-          if (
-            objectRaw &&
-            matchObject(objectRaw) &&
-            isActorAllowedGraffitiObject(objectRaw, session)
-          ) {
-            const object = { ...objectRaw };
-            maskGraffitiObject(object, channels, session);
-            if (validate(object)) {
-              push({ value: object });
-              break;
-            }
-          }
-        }
-      };
-
-      this.callbacks.add(callback);
-      await stop;
-      this.callbacks.delete(callback);
-    });
-
-    return repeater;
-  }
-
-  synchronizeDiscover: Graffiti["synchronizeDiscover"] = (...args) => {
-    const [channels, schema, session] = args;
-    function matchObject(object: GraffitiObjectBase) {
-      return object.channels.some((channel) => channels.includes(channel));
-    }
-    return this.synchronize(matchObject, channels, schema, session);
-  };
-
-  synchronizeGet: Graffiti["synchronizeGet"] = (...args) => {
-    const [locationOrUri, schema, session] = args;
-    function matchObject(object: GraffitiObjectBase) {
-      const objectUri = locationToUri(object);
-      const { uri } = unpackLocationOrUri(locationOrUri);
-      return objectUri === uri;
-    }
-    return this.synchronize(matchObject, [], schema, session);
-  };
-
-  synchronizeRecoverOrphans: Graffiti["synchronizeRecoverOrphans"] = (
-    ...args
-  ) => {
-    const [schema, session] = args;
-    function matchObject(object: GraffitiObjectBase) {
-      return object.actor === session.actor && object.channels.length === 0;
-    }
-    return this.synchronize(matchObject, [], schema, session);
-  };
-}