@graffy/core 0.16.19 → 0.16.20-alpha.2

package/index.cjs

@@ -4,8 +4,7 @@ const stream = require("@graffy/stream");
 const debug = require("debug");
 const log = debug("graffy:core");
 function resolve(handlers, firstPayload, firstOptions) {
-  if (!(handlers == null ? void 0 : handlers.length))
-    throw Error("resolve.no_provider");
+  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)}`);
@@ -20,8 +19,7 @@ function resolve(handlers, firstPayload, firstOptions) {
         throw Error(`resolve.duplicate_next_call: ${handlers[i].name}`);
       }
       nextCalled = true;
-      if (typeof nextPayload === "undefined" || !nextPayload.length)
-        return;
+      if (typeof nextPayload === "undefined" || !nextPayload.length) return;
       return run(i + 1, nextPayload, nextOptions || options);
     });
   }
@@ -49,11 +47,9 @@ const unchanged = Symbol("Payload or result unchanged by handler");
 const decodeCache = /* @__PURE__ */ new WeakMap();
 function memoizeDecode(origDecode) {
   return (payload) => {
-    if (decodeCache.has(payload))
-      return decodeCache.get(payload);
+    if (decodeCache.has(payload)) return decodeCache.get(payload);
     const decoded = origDecode(payload);
-    if (payload.type === "object" && payload)
-      decodeCache.set(payload, decoded);
+    if (payload.type === "object" && payload) decodeCache.set(payload, decoded);
     return decoded;
   };
 }
@@ -78,8 +74,7 @@ function wrapProvider(fn, decodedPath, isRead) {
         nextPayload = encodePayload(
           common.wrapObject(porcelainNextPayload, decodedPath)
         );
-        if (remainingPayload.length)
-          common.merge(nextPayload, remainingPayload);
+        if (remainingPayload.length) common.merge(nextPayload, remainingPayload);
       }
       nextResult = await next(nextPayload, nextOptions);
       remainingNextResult = common.remove(nextResult, path) || [];
@@ -116,8 +111,7 @@ function shiftGen(fn, path) {
     const shiftedNext = async function* shiftedNextFn(unwrappedNextPayload, nextOptions) {
       nextCalled = true;
       const nextPayload = common.wrap(unwrappedNextPayload, path);
-      if (remainingPayload.length)
-        common.merge(nextPayload, remainingPayload);
+      if (remainingPayload.length) common.merge(nextPayload, remainingPayload);
       let pushRemaining;
       remainingNextStream = stream.makeStream((push) => {
         pushRemaining = push;
@@ -125,10 +119,8 @@ function shiftGen(fn, path) {
       for await (const value of next(nextPayload, nextOptions)) {
         const unwrappedValue = common.unwrap(value, path);
         const remainingValue = common.remove(value, path);
-        if (remainingValue)
-          pushRemaining(remainingValue);
-        if (unwrappedValue)
-          yield unwrappedValue;
+        if (remainingValue) pushRemaining(remainingValue);
+        if (unwrappedValue) yield unwrappedValue;
       }
     };
     const unwrappedStream = fn(unwrappedPayload, options, shiftedNext);

package/index.mjs

@@ -3,8 +3,7 @@ import { makeStream, mapStream as mapStream$1 } from "@graffy/stream";
 import debug from "debug";
 const log = debug("graffy:core");
 function resolve(handlers, firstPayload, firstOptions) {
-  if (!(handlers == null ? void 0 : handlers.length))
-    throw Error("resolve.no_provider");
+  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)}`);
@@ -19,8 +18,7 @@ function resolve(handlers, firstPayload, firstOptions) {
         throw Error(`resolve.duplicate_next_call: ${handlers[i].name}`);
       }
       nextCalled = true;
-      if (typeof nextPayload === "undefined" || !nextPayload.length)
-        return;
+      if (typeof nextPayload === "undefined" || !nextPayload.length) return;
       return run(i + 1, nextPayload, nextOptions || options);
     });
   }
@@ -48,11 +46,9 @@ const unchanged = Symbol("Payload or result unchanged by handler");
 const decodeCache = /* @__PURE__ */ new WeakMap();
 function memoizeDecode(origDecode) {
   return (payload) => {
-    if (decodeCache.has(payload))
-      return decodeCache.get(payload);
+    if (decodeCache.has(payload)) return decodeCache.get(payload);
     const decoded = origDecode(payload);
-    if (payload.type === "object" && payload)
-      decodeCache.set(payload, decoded);
+    if (payload.type === "object" && payload) decodeCache.set(payload, decoded);
     return decoded;
   };
 }
@@ -77,8 +73,7 @@ function wrapProvider(fn, decodedPath, isRead) {
         nextPayload = encodePayload(
           wrapObject(porcelainNextPayload, decodedPath)
         );
-        if (remainingPayload.length)
-          merge(nextPayload, remainingPayload);
+        if (remainingPayload.length) merge(nextPayload, remainingPayload);
       }
       nextResult = await next(nextPayload, nextOptions);
       remainingNextResult = remove(nextResult, path) || [];
@@ -115,8 +110,7 @@ function shiftGen(fn, path) {
     const shiftedNext = async function* shiftedNextFn(unwrappedNextPayload, nextOptions) {
       nextCalled = true;
       const nextPayload = wrap(unwrappedNextPayload, path);
-      if (remainingPayload.length)
-        merge(nextPayload, remainingPayload);
+      if (remainingPayload.length) merge(nextPayload, remainingPayload);
       let pushRemaining;
       remainingNextStream = makeStream((push) => {
         pushRemaining = push;
@@ -124,10 +118,8 @@ function shiftGen(fn, path) {
       for await (const value of next(nextPayload, nextOptions)) {
         const unwrappedValue = unwrap(value, path);
         const remainingValue = remove(value, path);
-        if (remainingValue)
-          pushRemaining(remainingValue);
-        if (unwrappedValue)
-          yield unwrappedValue;
+        if (remainingValue) pushRemaining(remainingValue);
+        if (unwrappedValue) yield unwrappedValue;
       }
     };
     const unwrappedStream = fn(unwrappedPayload, options, shiftedNext);

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.19",
+  "version": "0.16.20-alpha.2",
   "main": "./index.cjs",
   "exports": {
     "import": "./index.mjs",
@@ -16,8 +16,8 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@graffy/common": "0.16.19",
-    "@graffy/stream": "0.16.19",
-    "debug": "^4.3.3"
+    "@graffy/common": "0.16.20-alpha.2",
+    "@graffy/stream": "0.16.20-alpha.2",
+    "debug": "^4.3.7"
   }
 }

package/types/index.d.ts

@@ -1,2 +1,75 @@
-export default Graffy;
-import Graffy from './Graffy.js';
+export type JsonObject = Record<string, unknown>;
+
+type Key = unknown;
+
+// biome-ignore lint/suspicious/noExplicitAny: "Unknown" prevents assigning a concrete type to this parameter.
+export type GraffyCollection<CollectionSchema extends Record<string, any>> = {
+  [name: string]: CollectionSchema;
+} & { __brand: 'GraffyCollection' };
+
+// The parameter should be the Schema of the entire store. Use the "GraffyCollection"
+// type to define the schema of a collection.
+export default class Graffy<S> {
+  read<P extends PathOf<S>, Q extends Project<Descend<S, P>>>(
+    path: P,
+    projection: Q,
+    options?: GraffyReadOptions,
+  ): Promise<ReadResult<Descend<S, P>, Q>>;
+
+  read<Q extends Project<S>>(
+    projection: Q,
+    options?: GraffyReadOptions,
+  ): Promise<ReadResult<S, Q>>;
+
+  // biome-ignore lint/suspicious/noExplicitAny: TODO: add typings
+  on: (...any) => any;
+  // biome-ignore lint/suspicious/noExplicitAny: TODO: add typings
+  call: (...any) => any;
+  // biome-ignore lint/suspicious/noExplicitAny: TODO: add typings
+  use: (...any) => any;
+  // biome-ignore lint/suspicious/noExplicitAny: TODO: add typings
+  onRead: (...any) => any;
+  // biome-ignore lint/suspicious/noExplicitAny: TODO: add typings
+  onWrite: (...any) => any;
+  // biome-ignore lint/suspicious/noExplicitAny: TODO: add typings
+  onWatch: (...any) => any;
+  // biome-ignore lint/suspicious/noExplicitAny: TODO: add typings
+  write: (...any) => any;
+  // biome-ignore lint/suspicious/noExplicitAny: TODO: add typings
+  watch: (...any) => any;
+}
+
+export type PathOf<S> = S extends GraffyCollection<BuildObject>
+  ? string | Key
+  : S extends JsonObject
+    ? keyof S | [keyof S, ...PathOf<S[keyof S]>[]]
+    : never;
+
+export type Descend<S, P> = S extends GraffyCollection<BuildObject>
+  ? S[string]
+  : P extends keyof S
+    ? S[P]
+    : P extends [keyof S]
+      ? S[P[0]]
+      : P extends [keyof S, ...infer R]
+        ? Descend<S[P[0]], R>
+        : S;
+
+export type Project<S> = S extends GraffyCollection<BuildObject>
+  ?
+      | (Project<S[string]> & { $key: Key })
+      | (Project<S[string]> & { $key: Key })[]
+  : S extends JsonObject
+    ? Partial<{ [K in keyof S]: Project<S[K]> }>
+    : boolean;
+
+// biome-ignore lint/suspicious/noExplicitAny: <explanation>
+type ResultArray<R> = R[] & { $page: any; $next: any; $prev: any };
+
+type ReadResult<S, Q> = S extends GraffyCollection<BuildObject>
+  ? (S[string] & { $key: Key }) | ResultArray<S[string] & { $key: Key }>
+  : S extends JsonObject
+    ? { [K in keyof S & keyof Q]: ReadResult<S[K], Q[K]> }
+    : S;
+
+type GraffyReadOptions = JsonObject;

package/types/Core.d.ts

@@ -1,5 +0,0 @@
-export default class Core {
-    handlers: {};
-    on(type: any, path: any, handle: any): void;
-    call(type: any, payload: any, options?: {}): any;
-}

package/types/Graffy.d.ts

@@ -1,33 +0,0 @@
-export { unchanged } from "./shift.js";
-declare class Graffy {
-    constructor(path?: any[], core?: Core);
-    core: Core;
-    path: any[];
-    on(type: any, ...args: any[]): void;
-    onRead(...args: any[]): void;
-    onWatch(...args: any[]): void;
-    onWrite(...args: any[]): void;
-    use(...args: any[]): void;
-    call(type: any, payload: any, options?: {}): any;
-    read(...args: any[]): Promise<any>;
-    watch(...args: any[]): {
-        debugId: any;
-        next: () => any;
-        return(value: any): Promise<{
-            value: any;
-            done: boolean;
-        }>;
-        throw(error: any): Promise<{
-            value: any;
-            done: boolean;
-        }>;
-        [Symbol.asyncIterator](): any;
-    };
-    write(...args: any[]): Promise<any>;
-}
-declare namespace Graffy {
-    export { unchanged };
-}
-export default Graffy;
-import Core from './Core.js';
-import { unchanged } from './shift.js';

package/types/shift.d.ts

@@ -1,3 +0,0 @@
-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;

package/types/validate.d.ts

@@ -1,2 +0,0 @@
-export function validateCall(...args: any[]): any[];
-export function validateOn(...args: any[]): any[];