@blitznocode/blitz-orm 0.0.41 → 0.0.43

package/dist/index.js

@@ -5,9 +5,6 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -26,44 +23,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// ../essentials/dist/index.js
-var require_dist = __commonJS({
-  "../essentials/dist/index.js"(exports, module2) {
-    "use strict";
-    var __defProp2 = Object.defineProperty;
-    var __getOwnPropDesc2 = Object.getOwnPropertyDescriptor;
-    var __getOwnPropNames2 = Object.getOwnPropertyNames;
-    var __hasOwnProp2 = Object.prototype.hasOwnProperty;
-    var __export2 = (target, all) => {
-      for (var name in all)
-        __defProp2(target, name, { get: all[name], enumerable: true });
-    };
-    var __copyProps2 = (to, from, except, desc) => {
-      if (from && typeof from === "object" || typeof from === "function") {
-        for (let key of __getOwnPropNames2(from))
-          if (!__hasOwnProp2.call(to, key) && key !== except)
-            __defProp2(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc2(from, key)) || desc.enumerable });
-      }
-      return to;
-    };
-    var __toCommonJS2 = (mod) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod);
-    var essentials_exports = {};
-    __export2(essentials_exports, {
-      oFilter: () => oFilter4,
-      oFind: () => oFind2,
-      oMap: () => oMap,
-      objectFilter: () => objectFilter
-    });
-    module2.exports = __toCommonJS2(essentials_exports);
-    var oFilter4 = (obj, fn) => Object.fromEntries(Object.entries(obj).filter(fn));
-    function objectFilter(obj, fn) {
-      return Object.fromEntries(Object.entries(obj).filter(([k, v]) => fn(k, v)));
-    }
-    var oMap = (obj, fn) => Object.entries(obj).map(([key, value]) => fn(key, value));
-    var oFind2 = (obj, fn) => Object.values(Object.fromEntries(Object.entries(obj).filter(fn)))[0];
-  }
-});
-
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
@@ -82,10 +41,13 @@ var defaultConfig = {
 };
 
 // src/helpers.ts
-var import_essentials = __toESM(require_dist());
 var import_immer = __toESM(require("immer"));
 var import_object_traversal = require("object-traversal");
 var import_radash = require("radash");
+var oFind = (obj, fn) => Object.values(
+  Object.fromEntries(Object.entries(obj).filter(([k, v]) => fn(k, v)))
+)[0];
+var oFilter = (obj, fn) => Object.fromEntries(Object.entries(obj).filter(([k, v]) => fn(k, v)));
 var enrichSchema = (schema) => {
   const allLinkedFields = [];
   const withExtensionsSchema = (0, import_immer.default)(
@@ -294,14 +256,8 @@ var getCurrentFields = (currentSchema, node) => {
   const unidentifiedFields = [...usedFields, ...localFilterFields].filter(
     (x) => !allowedFields.includes(x)
   );
-  const localFilters = !node.$filter ? {} : (0, import_essentials.oFilter)(
-    node.$filter,
-    ([k, _v]) => localFilterFields.includes(k)
-  );
-  const nestedFilters = !node.$filter ? {} : (0, import_essentials.oFilter)(
-    node.$filter,
-    ([k, _v]) => nestedFilterFields.includes(k)
-  );
+  const localFilters = !node.$filter ? {} : oFilter(node.$filter, (k, _v) => localFilterFields.includes(k));
+  const nestedFilters = !node.$filter ? {} : oFilter(node.$filter, (k, _v) => nestedFilterFields.includes(k));
   return {
     fields: availableFields,
     dataFields: availableDataFields,
@@ -545,7 +501,6 @@ var parseTQLRes = async (req, res) => {
 var import_radash3 = require("radash");
 
 // src/pipeline/postprocess/buildBQLTree.ts
-var import_essentials2 = __toESM(require_dist());
 var import_immer2 = __toESM(require("immer"));
 var import_object_traversal2 = require("object-traversal");
 var import_radash4 = require("radash");
@@ -591,7 +546,7 @@ var filterChildrenEntities = (things, ids, node, path) => things.map(([id, entit
   );
   if (currentFieldConf) {
     const onlyMetadataEntity = {
-      ...(0, import_essentials2.oFilter)(entity, ([k, _v]) => k.startsWith("$"))
+      ...oFilter(entity, (k, _v) => k.startsWith("$"))
     };
     const withFieldsEntity = currentFieldConf.$fields ? {
       ...onlyMetadataEntity,
@@ -1208,7 +1163,6 @@ var buildTQLMutation = async (req) => {
 };
 
 // src/pipeline/preprocess/parseBQLMutation.ts
-var import_essentials3 = __toESM(require_dist());
 var import_immer3 = __toESM(require("immer"));
 var import_object_traversal3 = require("object-traversal");
 var import_radash8 = require("radash");
@@ -1245,9 +1199,9 @@ var parseBQLMutation = async (req) => {
             const currentValue = value[currentField.path];
             if (currentValue === void 0)
               return;
-            const currentRoleFieldSchema = "roles" in currentSchema ? (0, import_essentials3.oFind)(
+            const currentRoleFieldSchema = "roles" in currentSchema ? oFind(
               currentSchema.roles,
-              ([k]) => k === currentField.path
+              (k) => k === currentField.path
             ) : null;
             const currentFieldSchema = currentLinkFieldSchema || currentRoleFieldSchema;
             if (currentRoleFieldSchema && [...new Set(currentRoleFieldSchema.playedBy?.map((x) => x.thing))].length !== 1) {
@@ -1269,11 +1223,11 @@ var parseBQLMutation = async (req) => {
             };
             const relation = getCurrentRelation();
             const relationSchema = relation === "$self" ? currentSchema : schema.relations[relation];
-            const currentFieldRole = (0, import_essentials3.oFind)(
+            const currentFieldRole = oFind(
               relationSchema.roles,
-              ([k, _v]) => k === currentField.path
+              (k, _v) => k === currentField.path
             );
-            if (currentFieldRole?.playedBy.length === 0)
+            if (currentFieldRole?.playedBy?.length === 0)
               throw new Error(
                 `unused role: ${currentPath}.${currentField.path}`
               );
@@ -1438,10 +1392,7 @@ var parseBQLMutation = async (req) => {
                 (x) => x.path === fieldPath
               );
               const currentLinkedDef = currentLinkDef?.oppositeLinkFieldsPlayedBy[0];
-              const currentRoleDef = "roles" in currentSchema ? (0, import_essentials3.oFind)(
-                currentSchema.roles,
-                ([k, _v]) => k === fieldPath
-              ) : void 0;
+              const currentRoleDef = "roles" in currentSchema ? oFind(currentSchema.roles, (k, _v) => k === fieldPath) : void 0;
               const currentDef = currentFieldDef || currentLinkedDef || currentRoleDef;
               if (!currentDef) {
                 throw new Error(`no field Def for ${fieldPath}`);
@@ -1551,14 +1502,14 @@ var parseBQLMutation = async (req) => {
               "An id must be specified either in the mutation or has tu have a default value in the schema"
             );
           }
-          const rolesObjFiltered = (0, import_essentials3.oFilter)(
+          const rolesObjFiltered = oFilter(
             val,
-            ([k, _v]) => roleFieldPaths.includes(k)
+            (k, _v) => roleFieldPaths.includes(k)
           );
           const rolesObjOnlyIds = (0, import_radash8.mapEntries)(rolesObjFiltered, (k, v) => {
             return [k, v.$id || v];
           });
-          const objWithMetaDataOnly = (0, import_essentials3.oFilter)(val, ([k, _v]) => {
+          const objWithMetaDataOnly = oFilter(val, (k, _v) => {
             return k.startsWith("$") || k.startsWith("Symbol");
           });
           if (Object.keys(rolesObjFiltered).filter((x) => !x.startsWith("$")).length > 0) {
@@ -1581,9 +1532,9 @@ var parseBQLMutation = async (req) => {
               return;
             }
             if (val.$op === "noop") {
-              const rolesWithLinks = (0, import_essentials3.oFilter)(
+              const rolesWithLinks = oFilter(
                 rolesObjOnlyIds,
-                ([_k, v]) => v.some(
+                (_k, v) => v.some(
                   (x) => x.$op === "link" || x.$op === "create"
                 )
               );
@@ -1591,14 +1542,12 @@ var parseBQLMutation = async (req) => {
                 rolesWithLinks,
                 (k, v) => [
                   k,
-                  v.filter(
-                    (x) => x.$op === "link" || x.$op === "create"
-                  ).map((y) => y.$id)
+                  v.filter((x) => x.$op === "link" || x.$op === "create").map((y) => y.$id)
                 ]
               );
-              const rolesWithUnlinks = (0, import_essentials3.oFilter)(
+              const rolesWithUnlinks = oFilter(
                 rolesObjOnlyIds,
-                ([_k, v]) => v.some(
+                (_k, v) => v.some(
                   (x) => x.$op === "unlink" || x.$op === "delete"
                 )
               );
@@ -1606,9 +1555,7 @@ var parseBQLMutation = async (req) => {
                 rolesWithUnlinks,
                 (k, v) => [
                   k,
-                  v.filter(
-                    (x) => x.$op === "unlink" || x.$op === "delete"
-                  ).map((y) => y.$id)
+                  v.filter((x) => x.$op === "unlink" || x.$op === "delete").map((y) => y.$id)
                 ]
               );
               const rolesWithReplaces = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blitznocode/blitz-orm",
-  "version": "0.0.41",
+  "version": "0.0.43",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
@@ -17,8 +17,7 @@
   "license": "AGPL-3.0-only",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/blitz/blitz.git",
-    "directory": "packages/blitz-orm"
+    "url": "https://github.com/Blitzapps/blitz-orm"
   },
   "files": [
     "README.md",
@@ -62,9 +61,9 @@
   },
   "description": "Blitz-orm is a public package that can be open-sourced",
   "bugs": {
-    "url": "https://github.com/blitz/blitz/issues"
+    "url": "https://github.com/Blitzapps/blitz-orm/issues"
   },
-  "homepage": "https://github.com/blitz/blitz#readme",
+  "homepage": "https://github.com/Blitzapps/blitz-orm#readme",
   "directories": {
     "test": "tests"
   },

package/readme.md

@@ -1,44 +1,50 @@
-Blitz-orm is a public package that can be open-sourced
-
-Similar to Prisma, it's used to interpret a BQL schema and provide the client and the server with tools to ensure they are "speaking the same language"
-
-## Compatibility
-The only database that is currently compatible with borm is TypeDB. We want to build adapters in the future for other graph databases like dgraph and neo4j, as well as classic dbs like postgres and mongoDB. 
-
-## How to use
-- Install the package with your packages manager, like this: 
-`yarn add @blitznocode/blitz-orm`
-- Create a borm schema, ou have an example in the test folder
-- borm.define() is still not working, this means you will need to translate your bql schema into a typeQL schema manually (an example in test folder)
-- Create a configuration file with the database name that you have created in typeDB
-- Init borm in a file like this
-```
-import BormClient from '@blitznocode/blitz-orm';
-
-import { bormConfig } from './borm.config';
-import { schema } from './schema';
-
-const bormClient = new BormClient({
-  schema,
-  config: bormConfig,
-});
-
-export default bormClient;
-```
-- And now you can run queries and mutations like this
-```
-const res = await bormClient.mutate({$entity: 'User', name: 'Ann'} { noMetadata: true });
-```
-
-## How to run typeDB locally
-Follow official instructions: https://docs.vaticle.com/docs/running-typedb/install-and-run
-We advice to run TypeDB studio, define the schema there and do some tests with pure typeQL before using borm.
-
-## Collaborate / Contact
-You can help us adding adapters (mongo, postgres, neo4j...), a BQL<>graphQL mapper, performance enhancements, or contributing with our public roadmap for this package (not yet published). Please feel free to send an email to loic@blitnocode.com 
-
-## Warning
-- This package is in alpha version, not yet ready for production. Most key queries and mutations do work, but a lot is missing and performance has to be enhanced also in the future. One of the biggest performance drops is on nested queries as they currently require as many calls to typeDB as levels of depth 
-
-## Working
-- To check what is working and some examples, please feel free to check the test folder, where there are a bunch of queries and mutations.
+# Blitz-orm
+Blitz-orm is an Object Relational Mapper (ORM) for graph databases that uses a JSON query language called Blitz Query Language (BQL). BQL is similar to GraphQL but uses JSON instead of strings.
+
+Blitz-orm is similar to other ORM packages such as Prisma. You define a BQL schema and it gets translated to different databases (currently only compatible with TypeDB).
+
+## Compatibility
+Currently, the only database that is compatible with Blitz-orm is TypeDB. The goal is to build adapters for other graph databases such as Dgraph and Neo4j, as well as classic databases like PostgreSQL and MongoDB in the future.
+
+## How to Use
+1. Install the package using your package manager, for example:
+`yarn add @blitznocode/blitz-orm`
+2. Create a Borm schema. You can find an example in the test folder. 
+3. The borm.define() function is currently not working, so you will need to manually translate your BQL schema into a TypeQL schema (an example can be found in the test folder).
+4. Create a configuration file with the database name that you have created in TypeDB.
+5. Initialize Blitz-orm in a file like this:
+```
+import BormClient from '@blitznocode/blitz-orm';
+
+import { bormConfig } from './borm.config';
+import { schema } from './schema';
+
+const bormClient = new BormClient({
+  schema,
+  config: bormConfig,
+});
+
+export default bormClient;
+```
+6. You can then run queries and mutations like this:
+```
+const res = await bormClient.mutate({$entity: 'User', name: 'Ann'}, { noMetadata: true });
+```
+
+## How to Run TypeDB Locally
+To run TypeDB locally, follow the official instructions at https://docs.vaticle.com/docs/running-typedb/install-and-run. It is recommended to run TypeDB Studio, define the schema there, and test with pure TypeQL before using Blitz-orm.
+
+## Collaboration & Contact
+You can contribute to the project by adding adapters for other databases, developing a BQL-to-GraphQL mapper, enhancing performance, or contributing to the public roadmap for this package (not yet published). To get in touch, please send an email to loic@blitznocode.com.
+
+## Warning
+Blitz-orm is currently in alpha version and not ready for production use. Some key queries and mutations do work, but there is still much that needs to be done and performance improvements are needed. One of the biggest performance issues is with nested queries, as they currently require a call to TypeDB for each level of depth.
+
+## What is Currently Working
+To see what is currently working and find examples, please check the test folder, where you will find a variety of queries and mutations.
+
+## The future of this package
+- Achieve 100% compatibility with typeDB functions
+- Enhance functionality with new features such as, cardinality management, ordered attributes, Vectors (ordered relations)...
+- Expand compatibility to other graph databases and traditional databases such as PostgreSQL or MongoDB
+- Enable the ability to split queries and mutations across multiple databases (for example, some data stored in PostgreSQL and other data in typeQL, all queried from a single point)