@graffy/core 0.16.10-alpha.2 → 0.16.12-alpha.1

package/index.cjs

@@ -2,78 +2,93 @@
 const common = require("@graffy/common");
 const stream = require("@graffy/stream");
 const debug = require("debug");
-const splitPath = (path) => Array.isArray(path) ? path : path === "" ? [] : String(path).split(".");
-function validateCall(...args) {
-  if (args.length === 1) {
-    return [[], args[0], {}];
-  } else if (args.length === 2) {
-    if (common.isPlainObject(args[0])) {
-      if (!common.isPlainObject(args[1])) {
-        throw Error(`validateCall.invalid_options: ${JSON.stringify(args[1])}`);
-      }
-      return [[], args[0], args[1]];
-    } else {
-      return [splitPath(args[0]), args[1], {}];
+const log = debug("graffy:core");
+function resolve(handlers, firstPayload, firstOptions) {
+  if (!(handlers == null ? void 0 : handlers.length))
+    throw Error("resolve.no_provider");
+  function run(i, payload, options) {
+    if (i >= handlers.length) {
+      throw Error(`resolve.no_providers_for ${JSON.stringify(payload)}`);
     }
-  } else if (args.length === 3) {
-    if (!common.isPlainObject(args[2])) {
-      throw Error(`validateCall.invalid_options: ${JSON.stringify(args[1])}`);
+    const { path, handle } = handlers[i];
+    if (!common.unwrap(payload, path)) {
+      return run(i + 1, payload, options);
     }
-    return [splitPath(args[0]), args[1], args[2]];
+    let nextCalled = false;
+    return handle(payload, options, (nextPayload, nextOptions) => {
+      if (nextCalled) {
+        throw Error(`resolve.duplicate_next_call: ${handlers[i].name}`);
+      }
+      nextCalled = true;
+      if (typeof nextPayload === "undefined" || !nextPayload.length)
+        return;
+      return run(i + 1, nextPayload, nextOptions || options);
+    });
   }
-  throw Error(`validateCall.invalid_args: ${JSON.stringify(args)}`);
+  return run(0, firstPayload, firstOptions);
 }
-function validateOn(...args) {
-  if (args.length === 1) {
-    if (typeof args[0] !== "function") {
-      throw Error(`validateOn.invalid_handler: ${JSON.stringify(args[0])}`);
-    }
-    return [[], args[0]];
-  } else if (args.length === 2) {
-    if (typeof args[1] !== "function") {
-      throw Error(`validateOn.invalid_handler: ${JSON.stringify(args[1])}`);
-    }
-    return [splitPath(args[0]), args[1]];
+class Core {
+  constructor() {
+    this.handlers = {};
+  }
+  on(type, path, handle) {
+    this.handlers[type] = this.handlers[type] || [];
+    this.handlers[type].push({ path: common.encodePath(path), handle });
+  }
+  call(type, payload, options = {}) {
+    log("call", type, payload);
+    return resolve(this.handlers[type], payload, options);
   }
-  throw Error(`validateOn.invalid_args: ${JSON.stringify(args)}`);
 }
 async function mapStream(stream2, fn) {
   for await (const value of stream2) {
     fn(value);
   }
 }
+const unchanged = Symbol("Payload or result unchanged by handler");
 function wrapProvider(fn, decodedPath, isRead) {
   const decodePayload = isRead ? common.decodeQuery : common.decodeGraph;
   const encodePayload = isRead ? common.encodeQuery : common.encodeGraph;
   const path = common.encodePath(decodedPath);
   return async function wrappedProvider(payload, options, next) {
     let nextCalled = false;
+    let nextResult;
     let remainingNextResult;
     const porcelainPayload = common.unwrapObject(decodePayload(payload), decodedPath);
     const remainingPayload = common.remove(payload, path) || [];
     async function shiftedNext(porcelainNextPayload, nextOptions) {
       nextCalled = true;
-      const nextPayload = encodePayload(
-        common.wrapObject(porcelainNextPayload, decodedPath)
-      );
-      if (remainingPayload.length)
-        common.merge(nextPayload, remainingPayload);
-      const nextResult = await next(nextPayload, nextOptions);
+      let nextPayload;
+      if (porcelainNextPayload === unchanged) {
+        nextPayload = payload;
+      } else {
+        nextPayload = encodePayload(
+          common.wrapObject(porcelainNextPayload, decodedPath)
+        );
+        if (remainingPayload.length)
+          common.merge(nextPayload, remainingPayload);
+      }
+      nextResult = await next(nextPayload, nextOptions);
       remainingNextResult = common.remove(nextResult, path) || [];
       return common.unwrapObject(common.decodeGraph(nextResult), decodedPath);
     }
     const porcelainResult = await fn(porcelainPayload, options, shiftedNext);
-    let result = common.encodeGraph(common.wrapObject(porcelainResult, decodedPath));
-    if (isRead && !nextCalled) {
-      const appliedQuery = common.wrap(common.unwrap(payload, path), path);
-      result = common.finalize(result, appliedQuery);
-      result = common.wrap(common.unwrap(result, path), path);
-    }
-    if (!nextCalled && remainingPayload.length) {
-      remainingNextResult = await next(remainingPayload);
-    }
-    if (remainingNextResult == null ? void 0 : remainingNextResult.length) {
-      common.merge(result, remainingNextResult);
+    let result;
+    if (porcelainResult === unchanged) {
+      result = nextResult;
+    } else {
+      result = common.encodeGraph(common.wrapObject(porcelainResult, decodedPath));
+      if (isRead && !nextCalled) {
+        const appliedQuery = common.wrap(common.unwrap(payload, path), path);
+        result = common.finalize(result, appliedQuery);
+        result = common.wrap(common.unwrap(result, path), path);
+      }
+      if (!nextCalled && remainingPayload.length) {
+        remainingNextResult = await next(remainingPayload);
+      }
+      if (remainingNextResult == null ? void 0 : remainingNextResult.length) {
+        common.merge(result, remainingNextResult);
+      }
     }
     return result;
   };
@@ -118,43 +133,42 @@ function shiftGen(fn, path) {
     yield* remainingNextStream ? common.mergeStreams(resultStream, remainingNextStream) : resultStream;
   };
 }
-const log = debug("graffy:core");
-function resolve(handlers, firstPayload, firstOptions) {
-  if (!(handlers == null ? void 0 : handlers.length))
-    throw Error("resolve.no_provider");
-  function run(i, payload, options) {
-    if (i >= handlers.length) {
-      throw Error(`resolve.no_providers_for ${JSON.stringify(payload)}`);
+const splitPath = (path) => Array.isArray(path) ? path : path === "" ? [] : String(path).split(".");
+function validateCall(...args) {
+  if (args.length === 1) {
+    return [[], args[0], {}];
+  }
+  if (args.length === 2) {
+    if (common.isPlainObject(args[0])) {
+      if (!common.isPlainObject(args[1])) {
+        throw Error(`validateCall.invalid_options: ${JSON.stringify(args[1])}`);
+      }
+      return [[], args[0], args[1]];
     }
-    const { path, handle } = handlers[i];
-    if (!common.unwrap(payload, path)) {
-      return run(i + 1, payload, options);
+    return [splitPath(args[0]), args[1], {}];
+  }
+  if (args.length === 3) {
+    if (!common.isPlainObject(args[2])) {
+      throw Error(`validateCall.invalid_options: ${JSON.stringify(args[1])}`);
     }
-    let nextCalled = false;
-    return handle(payload, options, (nextPayload, nextOptions) => {
-      if (nextCalled) {
-        throw Error(`resolve.duplicate_next_call: ${handlers[i].name}`);
-      }
-      nextCalled = true;
-      if (typeof nextPayload === "undefined" || !nextPayload.length)
-        return;
-      return run(i + 1, nextPayload, nextOptions || options);
-    });
+    return [splitPath(args[0]), args[1], args[2]];
   }
-  return run(0, firstPayload, firstOptions);
+  throw Error(`validateCall.invalid_args: ${JSON.stringify(args)}`);
 }
-class Core {
-  constructor() {
-    this.handlers = {};
-  }
-  on(type, path, handle) {
-    this.handlers[type] = this.handlers[type] || [];
-    this.handlers[type].push({ path: common.encodePath(path), handle });
+function validateOn(...args) {
+  if (args.length === 1) {
+    if (typeof args[0] !== "function") {
+      throw Error(`validateOn.invalid_handler: ${JSON.stringify(args[0])}`);
+    }
+    return [[], args[0]];
   }
-  call(type, payload, options = {}) {
-    log("call", type, payload);
-    return resolve(this.handlers[type], payload, options);
+  if (args.length === 2) {
+    if (typeof args[1] !== "function") {
+      throw Error(`validateOn.invalid_handler: ${JSON.stringify(args[1])}`);
+    }
+    return [splitPath(args[0]), args[1]];
   }
+  throw Error(`validateOn.invalid_args: ${JSON.stringify(args)}`);
 }
 class Graffy {
   constructor(path = [], core = new Core()) {
@@ -182,9 +196,9 @@ class Graffy {
           const subscription = handle(common.decodeQuery(query), options, () => {
             throw Error(`porcelain.watch_next_unsupported: ${path}`);
           });
-          (async function() {
+          (async () => {
             try {
-              let firstValue = (await subscription.next()).value;
+              const firstValue = (await subscription.next()).value;
               push(firstValue && common.finalize(common.encodeGraph(firstValue), query));
               for await (const value of subscription) {
                 push(value && common.encodeGraph(value));

package/index.mjs

@@ -1,78 +1,93 @@
-import { isPlainObject, encodePath, unwrapObject, remove, encodeGraph, wrapObject, wrap, unwrap, finalize, merge, mergeStreams, decodeQuery, decodeGraph, encodeQuery, decorate } from "@graffy/common";
+import { encodePath, unwrap, unwrapObject, remove, encodeGraph, wrapObject, wrap, finalize, merge, mergeStreams, decodeQuery, decodeGraph, encodeQuery, isPlainObject, decorate } from "@graffy/common";
 import { makeStream, mapStream as mapStream$1 } from "@graffy/stream";
 import debug from "debug";
-const splitPath = (path) => Array.isArray(path) ? path : path === "" ? [] : String(path).split(".");
-function validateCall(...args) {
-  if (args.length === 1) {
-    return [[], args[0], {}];
-  } else if (args.length === 2) {
-    if (isPlainObject(args[0])) {
-      if (!isPlainObject(args[1])) {
-        throw Error(`validateCall.invalid_options: ${JSON.stringify(args[1])}`);
-      }
-      return [[], args[0], args[1]];
-    } else {
-      return [splitPath(args[0]), args[1], {}];
+const log = debug("graffy:core");
+function resolve(handlers, firstPayload, firstOptions) {
+  if (!(handlers == null ? void 0 : handlers.length))
+    throw Error("resolve.no_provider");
+  function run(i, payload, options) {
+    if (i >= handlers.length) {
+      throw Error(`resolve.no_providers_for ${JSON.stringify(payload)}`);
     }
-  } else if (args.length === 3) {
-    if (!isPlainObject(args[2])) {
-      throw Error(`validateCall.invalid_options: ${JSON.stringify(args[1])}`);
+    const { path, handle } = handlers[i];
+    if (!unwrap(payload, path)) {
+      return run(i + 1, payload, options);
     }
-    return [splitPath(args[0]), args[1], args[2]];
+    let nextCalled = false;
+    return handle(payload, options, (nextPayload, nextOptions) => {
+      if (nextCalled) {
+        throw Error(`resolve.duplicate_next_call: ${handlers[i].name}`);
+      }
+      nextCalled = true;
+      if (typeof nextPayload === "undefined" || !nextPayload.length)
+        return;
+      return run(i + 1, nextPayload, nextOptions || options);
+    });
   }
-  throw Error(`validateCall.invalid_args: ${JSON.stringify(args)}`);
+  return run(0, firstPayload, firstOptions);
 }
-function validateOn(...args) {
-  if (args.length === 1) {
-    if (typeof args[0] !== "function") {
-      throw Error(`validateOn.invalid_handler: ${JSON.stringify(args[0])}`);
-    }
-    return [[], args[0]];
-  } else if (args.length === 2) {
-    if (typeof args[1] !== "function") {
-      throw Error(`validateOn.invalid_handler: ${JSON.stringify(args[1])}`);
-    }
-    return [splitPath(args[0]), args[1]];
+class Core {
+  constructor() {
+    this.handlers = {};
+  }
+  on(type, path, handle) {
+    this.handlers[type] = this.handlers[type] || [];
+    this.handlers[type].push({ path: encodePath(path), handle });
+  }
+  call(type, payload, options = {}) {
+    log("call", type, payload);
+    return resolve(this.handlers[type], payload, options);
   }
-  throw Error(`validateOn.invalid_args: ${JSON.stringify(args)}`);
 }
 async function mapStream(stream, fn) {
   for await (const value of stream) {
     fn(value);
   }
 }
+const unchanged = Symbol("Payload or result unchanged by handler");
 function wrapProvider(fn, decodedPath, isRead) {
   const decodePayload = isRead ? decodeQuery : decodeGraph;
   const encodePayload = isRead ? encodeQuery : encodeGraph;
   const path = encodePath(decodedPath);
   return async function wrappedProvider(payload, options, next) {
     let nextCalled = false;
+    let nextResult;
     let remainingNextResult;
     const porcelainPayload = unwrapObject(decodePayload(payload), decodedPath);
     const remainingPayload = remove(payload, path) || [];
     async function shiftedNext(porcelainNextPayload, nextOptions) {
       nextCalled = true;
-      const nextPayload = encodePayload(
-        wrapObject(porcelainNextPayload, decodedPath)
-      );
-      if (remainingPayload.length)
-        merge(nextPayload, remainingPayload);
-      const nextResult = await next(nextPayload, nextOptions);
+      let nextPayload;
+      if (porcelainNextPayload === unchanged) {
+        nextPayload = payload;
+      } else {
+        nextPayload = encodePayload(
+          wrapObject(porcelainNextPayload, decodedPath)
+        );
+        if (remainingPayload.length)
+          merge(nextPayload, remainingPayload);
+      }
+      nextResult = await next(nextPayload, nextOptions);
       remainingNextResult = remove(nextResult, path) || [];
       return unwrapObject(decodeGraph(nextResult), decodedPath);
     }
     const porcelainResult = await fn(porcelainPayload, options, shiftedNext);
-    let result = encodeGraph(wrapObject(porcelainResult, decodedPath));
-    if (isRead && !nextCalled) {
-      const appliedQuery = wrap(unwrap(payload, path), path);
-      result = finalize(result, appliedQuery);
-      result = wrap(unwrap(result, path), path);
-    }
-    if (!nextCalled && remainingPayload.length) {
-      remainingNextResult = await next(remainingPayload);
-    }
-    if (remainingNextResult == null ? void 0 : remainingNextResult.length) {
-      merge(result, remainingNextResult);
+    let result;
+    if (porcelainResult === unchanged) {
+      result = nextResult;
+    } else {
+      result = encodeGraph(wrapObject(porcelainResult, decodedPath));
+      if (isRead && !nextCalled) {
+        const appliedQuery = wrap(unwrap(payload, path), path);
+        result = finalize(result, appliedQuery);
+        result = wrap(unwrap(result, path), path);
+      }
+      if (!nextCalled && remainingPayload.length) {
+        remainingNextResult = await next(remainingPayload);
+      }
+      if (remainingNextResult == null ? void 0 : remainingNextResult.length) {
+        merge(result, remainingNextResult);
+      }
     }
     return result;
   };
@@ -117,43 +132,42 @@ function shiftGen(fn, path) {
     yield* remainingNextStream ? mergeStreams(resultStream, remainingNextStream) : resultStream;
   };
 }
-const log = debug("graffy:core");
-function resolve(handlers, firstPayload, firstOptions) {
-  if (!(handlers == null ? void 0 : handlers.length))
-    throw Error("resolve.no_provider");
-  function run(i, payload, options) {
-    if (i >= handlers.length) {
-      throw Error(`resolve.no_providers_for ${JSON.stringify(payload)}`);
+const splitPath = (path) => Array.isArray(path) ? path : path === "" ? [] : String(path).split(".");
+function validateCall(...args) {
+  if (args.length === 1) {
+    return [[], args[0], {}];
+  }
+  if (args.length === 2) {
+    if (isPlainObject(args[0])) {
+      if (!isPlainObject(args[1])) {
+        throw Error(`validateCall.invalid_options: ${JSON.stringify(args[1])}`);
+      }
+      return [[], args[0], args[1]];
     }
-    const { path, handle } = handlers[i];
-    if (!unwrap(payload, path)) {
-      return run(i + 1, payload, options);
+    return [splitPath(args[0]), args[1], {}];
+  }
+  if (args.length === 3) {
+    if (!isPlainObject(args[2])) {
+      throw Error(`validateCall.invalid_options: ${JSON.stringify(args[1])}`);
     }
-    let nextCalled = false;
-    return handle(payload, options, (nextPayload, nextOptions) => {
-      if (nextCalled) {
-        throw Error(`resolve.duplicate_next_call: ${handlers[i].name}`);
-      }
-      nextCalled = true;
-      if (typeof nextPayload === "undefined" || !nextPayload.length)
-        return;
-      return run(i + 1, nextPayload, nextOptions || options);
-    });
+    return [splitPath(args[0]), args[1], args[2]];
   }
-  return run(0, firstPayload, firstOptions);
+  throw Error(`validateCall.invalid_args: ${JSON.stringify(args)}`);
 }
-class Core {
-  constructor() {
-    this.handlers = {};
-  }
-  on(type, path, handle) {
-    this.handlers[type] = this.handlers[type] || [];
-    this.handlers[type].push({ path: encodePath(path), handle });
+function validateOn(...args) {
+  if (args.length === 1) {
+    if (typeof args[0] !== "function") {
+      throw Error(`validateOn.invalid_handler: ${JSON.stringify(args[0])}`);
+    }
+    return [[], args[0]];
   }
-  call(type, payload, options = {}) {
-    log("call", type, payload);
-    return resolve(this.handlers[type], payload, options);
+  if (args.length === 2) {
+    if (typeof args[1] !== "function") {
+      throw Error(`validateOn.invalid_handler: ${JSON.stringify(args[1])}`);
+    }
+    return [splitPath(args[0]), args[1]];
   }
+  throw Error(`validateOn.invalid_args: ${JSON.stringify(args)}`);
 }
 class Graffy {
   constructor(path = [], core = new Core()) {
@@ -181,9 +195,9 @@ class Graffy {
           const subscription = handle(decodeQuery(query), options, () => {
             throw Error(`porcelain.watch_next_unsupported: ${path}`);
           });
-          (async function() {
+          (async () => {
             try {
-              let firstValue = (await subscription.next()).value;
+              const firstValue = (await subscription.next()).value;
               push(firstValue && finalize(encodeGraph(firstValue), query));
               for await (const value of subscription) {
                 push(value && encodeGraph(value));

package/package.json

@@ -2,7 +2,7 @@
   "name": "@graffy/core",
   "description": "The main module for Graffy, a library for intuitive real-time data APIs.",
   "author": "aravind (https://github.com/aravindet)",
-  "version": "0.16.10-alpha.2",
+  "version": "0.16.12-alpha.1",
   "main": "./index.cjs",
   "exports": {
     "import": "./index.mjs",
@@ -16,8 +16,8 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@graffy/common": "0.16.10-alpha.2",
-    "@graffy/stream": "0.16.10-alpha.2",
+    "@graffy/common": "0.16.12-alpha.1",
+    "@graffy/stream": "0.16.12-alpha.1",
     "debug": "^4.3.3"
   }
 }

package/types/Graffy.d.ts

@@ -1,3 +1,4 @@
+export { unchanged } from "./shift.js";
 export default class Graffy {
     constructor(path?: any[], core?: Core);
     core: Core;

package/types/shift.d.ts

@@ -1,2 +1,3 @@
 export function wrapProvider(fn: any, decodedPath: any, isRead: any): (payload: any, options: any, next: any) => Promise<any>;
 export function shiftGen(fn: any, path: any): (payload: any, options: any, next: any) => AsyncGenerator<any, void, any>;
+export const unchanged: unique symbol;