@env-hopper/table-sync 2.0.1-alpha-20260224145405

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Igor Golovin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,19 @@
+# @env-hopper/table-sync
+
+Database table sync utilities for Env Hopper.
+
+## Installation
+
+```bash
+npm install @env-hopper/table-sync
+# or
+pnpm add @env-hopper/table-sync
+```
+
+## Usage
+
+This package provides utilities for syncing database tables in Env Hopper.
+
+## License
+
+MIT

package/dist/esm/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Table sync utilities for Env Hopper
+ */
+export { tableSync } from './tableSync.js';
+export type { TableSyncParams, TableSyncIdBag } from './tableSync.js';

package/dist/esm/index.js

@@ -0,0 +1,5 @@
+import { tableSync } from "./tableSync.js";
+export {
+  tableSync
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/esm/tableSync.d.ts

@@ -0,0 +1,20 @@
+import { FilteredKeys } from 'radashi';
+export interface TableSyncParams<T extends object, TUniqColumns extends ReadonlyArray<keyof T>, TId extends keyof T & (string | number)> {
+    id: TId;
+    readAll: () => Promise<Array<T>>;
+    writeAll: (create: Array<Omit<T, TId>>, update: Array<{
+        data: Partial<T>;
+        where: Pick<T, FilteredKeys<T, TUniqColumns>>;
+    }>, deleteIds: Array<T[TId]>) => Promise<Array<T>>;
+    uniqColumns: TUniqColumns;
+}
+export declare function tableSync<T extends object, TUniqColumns extends ReadonlyArray<keyof T>, TId extends keyof T & (string | number)>(params: TableSyncParams<T, TUniqColumns, TId>): {
+    sync<TUpsert extends Partial<T> & Pick<T, TUniqColumns[number]>>(upsertRaw: Array<TUpsert>): Promise<{
+        findIdMaybe: (key: Pick<T, TUniqColumns[number]>) => T[TId] | undefined;
+        findIdOrThrow: (key: Pick<T, TUniqColumns[number]>) => T[TId];
+        getActual(): (Pick<T, TUniqColumns[number]> & T[TId])[];
+    }>;
+};
+export interface TableSyncIdBag<T, TUniqColumns extends ReadonlyArray<keyof T>> {
+    findId: (key: Pick<T, TUniqColumns[number]>) => T[keyof T] | undefined;
+}

package/dist/esm/tableSync.js

@@ -0,0 +1,112 @@
+import { objectify, group, pick, isEqual } from "radashi";
+function tableSync(params) {
+  return {
+    async sync(upsertRaw) {
+      const existingData = await params.readAll();
+      function toStrKey(item) {
+        return params.uniqColumns.map((column) => {
+          if (item[column] === void 0) {
+            throw new Error(
+              `unique column ${String(column)} can't be undefined in entry ${JSON.stringify(item)}`
+            );
+          }
+          return item[column];
+        }).join(":");
+      }
+      const existingByStrKey = objectify(existingData, (item) => toStrKey(item));
+      const isEqualOnKeys = (upsert, existing) => {
+        for (const key in upsert) {
+          if (!(key in existing)) {
+            return false;
+          }
+          if (!isEqual(existing[key], upsert[key])) {
+            return false;
+          }
+        }
+        return true;
+      };
+      const upsertItems = upsertRaw;
+      const { toCreate, toUpdate, unmodified } = group(
+        upsertItems,
+        (upsertItem) => {
+          const strKey = toStrKey(upsertItem);
+          const existing = existingByStrKey[strKey];
+          if (existing !== void 0) {
+            if (isEqualOnKeys(upsertItem, existing)) {
+              return "unmodified";
+            } else {
+              return "toUpdate";
+            }
+          } else {
+            return "toCreate";
+          }
+        }
+      );
+      const deletedStrKeys = new Set(
+        Object.keys(existingByStrKey)
+      );
+      for (const item of upsertItems) {
+        deletedStrKeys.delete(toStrKey(item));
+      }
+      const deletedIds = [...deletedStrKeys].map((strKey) => {
+        var _a;
+        const existingByStrKeyElementElement = (_a = existingByStrKey[strKey]) == null ? void 0 : _a[params.id];
+        if (existingByStrKeyElementElement === void 0) {
+          throw new Error(
+            `The PK column '${params.id}' is not presented in ${JSON.stringify(existingByStrKey[strKey])}`
+          );
+        }
+        return existingByStrKeyElementElement;
+      });
+      const inserted = await params.writeAll(
+        toCreate || [],
+        (toUpdate || []).map((update) => {
+          return {
+            data: update,
+            where: pick(update, params.uniqColumns)
+          };
+        }),
+        deletedIds
+      );
+      const findActual = (key) => {
+        const strKey = toStrKey(key);
+        const maybeExisting = existingByStrKey[strKey];
+        if (maybeExisting !== void 0 && !(strKey in deletedStrKeys)) {
+          return maybeExisting;
+        }
+        return inserted.find((ins) => {
+          return toStrKey(ins) === strKey;
+        });
+      };
+      function getActual() {
+        return [...inserted, ...toUpdate || [], ...unmodified || []].map(
+          (row) => findActual(row)
+        );
+      }
+      return {
+        findIdMaybe: (key) => {
+          var _a;
+          return (_a = findActual(key)) == null ? void 0 : _a[params.id];
+        },
+        findIdOrThrow: (key) => {
+          var _a;
+          const maybeInserted = (_a = findActual(key)) == null ? void 0 : _a[params.id];
+          if (!maybeInserted) {
+            const total = [toCreate, toUpdate, unmodified].map((s) => (s == null ? void 0 : s.length) || 0).reduce((a, c) => a + c, 0);
+            throw new Error(
+              `findOrThrow: '${toStrKey(key)}' not found. (Existed #: ${total})`
+            );
+          }
+          return maybeInserted;
+        },
+        getActual() {
+          return getActual();
+        }
+      };
+    }
+  };
+}
+export {
+  tableSync
+};
+//# sourceMappingURL=tableSync.js.map

package/dist/esm/tableSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableSync.js","sources":["../../src/tableSync.ts"],"sourcesContent":["import type { FilteredKeys } from 'radashi'\nimport { group, isEqual, objectify, pick } from 'radashi'\n\nexport interface TableSyncParams<\n  T extends object,\n  TUniqColumns extends ReadonlyArray<keyof T>,\n  TId extends keyof T & (string | number),\n> {\n  id: TId\n  readAll: () => Promise<Array<T>>\n  writeAll: (\n    create: Array<Omit<T, TId>>,\n    update: Array<{\n      data: Partial<T>\n      where: Pick<T, FilteredKeys<T, TUniqColumns>>\n    }>,\n    deleteIds: Array<T[TId]>,\n  ) => Promise<Array<T>>\n  uniqColumns: TUniqColumns\n}\n\nexport function tableSync<\n  T extends object,\n  TUniqColumns extends ReadonlyArray<keyof T>,\n  TId extends keyof T & (string | number),\n>(params: TableSyncParams<T, TUniqColumns, TId>) {\n  return {\n    async sync<TUpsert extends Partial<T> & Pick<T, TUniqColumns[number]>>(\n      upsertRaw: Array<TUpsert>,\n    ) {\n      const existingData = await params.readAll()\n\n      function toStrKey(item: T) {\n        return params.uniqColumns\n          .map((column) => {\n            if (item[column] === undefined) {\n              throw new Error(\n                `unique column ${String(column)} can't be undefined in entry ${JSON.stringify(item)}`,\n              )\n            }\n            return item[column]\n          })\n          .join(':')\n      }\n\n      const existingByStrKey = objectify(existingData, (item) => toStrKey(item))\n\n      const isEqualOnKeys = (upsert: Partial<T>, existing: T) => {\n        for (const key in upsert) {\n          if (!(key in existing)) {\n            return false\n          }\n          if (!isEqual(existing[key], upsert[key])) {\n            return false\n          }\n        }\n        return true\n      }\n\n      const upsertItems = upsertRaw\n      const { toCreate, toUpdate, unmodified } = group(\n        upsertItems,\n        (upsertItem) => {\n          const strKey = toStrKey(upsertItem)\n          const existing = existingByStrKey[strKey]\n          if (existing !== undefined) {\n            if (isEqualOnKeys(upsertItem, existing)) {\n              return 'unmodified'\n            } else {\n              return 'toUpdate'\n            }\n          } else {\n            return 'toCreate'\n          }\n        },\n      )\n\n      const deletedStrKeys = new Set<keyof typeof existingByStrKey>(\n        Object.keys(existingByStrKey),\n      )\n      for (const item of upsertItems) {\n        deletedStrKeys.delete(toStrKey(item))\n      }\n      const deletedIds = [...deletedStrKeys].map((strKey) => {\n        const existingByStrKeyElementElement =\n          existingByStrKey[strKey]?.[params.id]\n        if (existingByStrKeyElementElement === undefined) {\n          throw new Error(\n            `The PK column '${params.id}' is not presented in ${JSON.stringify(existingByStrKey[strKey])}`,\n          )\n        }\n        return existingByStrKeyElementElement\n      })\n\n      const inserted = await params.writeAll(\n        toCreate || [],\n        (toUpdate || []).map((update) => {\n          return {\n            data: update,\n            where: pick<T, TUniqColumns>(update, params.uniqColumns),\n          }\n        }),\n        deletedIds as Array<T[TId]>,\n      )\n\n      const findActual = (key: Pick<T, TUniqColumns[number]>) => {\n        const strKey = toStrKey(key)\n        const maybeExisting = existingByStrKey[strKey]\n        if (maybeExisting !== undefined && !(strKey in deletedStrKeys)) {\n          return maybeExisting\n        }\n        return inserted.find((ins) => {\n          return toStrKey(ins) === strKey\n        })\n      }\n\n      function getActual() {\n        return [...inserted, ...(toUpdate || []), ...(unmodified || [])].map(\n          (row) => findActual(row),\n        ) as Array<Pick<T, TUniqColumns[number]> & T[TId]>\n      }\n\n      return {\n        findIdMaybe: (\n          key: Pick<T, TUniqColumns[number]>,\n        ): T[TId] | undefined => {\n          return findActual(key)?.[params.id]\n        },\n\n        findIdOrThrow: (key: Pick<T, TUniqColumns[number]>): T[TId] => {\n          const maybeInserted = findActual(key)?.[params.id]\n          if (!maybeInserted) {\n            const total = [toCreate, toUpdate, unmodified]\n              .map((s) => s?.length || 0)\n              .reduce((a, c) => a + c, 0)\n            throw new Error(\n              `findOrThrow: '${toStrKey(key)}' not found. (Existed #: ${total})`,\n            )\n          }\n          return maybeInserted\n        },\n        getActual() {\n          return getActual()\n        },\n      }\n    },\n  }\n}\n\nexport interface TableSyncIdBag<\n  T,\n  TUniqColumns extends ReadonlyArray<keyof T>,\n> {\n  findId: (key: Pick<T, TUniqColumns[number]>) => T[keyof T] | undefined\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@env-hopper/table-sync",
+  "version": "2.0.1-alpha-20260224145405",
+  "description": "Database table sync utilities for Env Hopper",
+  "homepage": "https://github.com/lislon/env-hopper",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lislon/env-hopper.git",
+    "directory": "packages/table-sync"
+  },
+  "license": "MIT",
+  "author": "Igor Golovin",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "my-custom-condition": "./src/index.ts",
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "radashi": "12.5.0-beta.6d5c035"
+  },
+  "devDependencies": {
+    "@tanstack/vite-config": "^0.4.3",
+    "@types/node": "^24.3.0",
+    "esbuild": "^0.25.5",
+    "tsx": "^4.19.4",
+    "typescript": "5.9.2"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "scripts": {
+    "build": "vite build",
+    "clean": "premove ./dist ./coverage ./dist-ts",
+    "compile": "tsc --build",
+    "dev": "tsx watch src/index.ts",
+    "test:eslint": "eslint ./src",
+    "test:unit": "echo \"skipped\"",
+    "test:unit:dev": "echo \"skipped\""
+  }
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Table sync utilities for Env Hopper
+ */
+export { tableSync } from './tableSync'
+export type { TableSyncParams, TableSyncIdBag } from './tableSync'

package/src/tableSync.ts

@@ -0,0 +1,155 @@
+import type { FilteredKeys } from 'radashi'
+import { group, isEqual, objectify, pick } from 'radashi'
+
+export interface TableSyncParams<
+  T extends object,
+  TUniqColumns extends ReadonlyArray<keyof T>,
+  TId extends keyof T & (string | number),
+> {
+  id: TId
+  readAll: () => Promise<Array<T>>
+  writeAll: (
+    create: Array<Omit<T, TId>>,
+    update: Array<{
+      data: Partial<T>
+      where: Pick<T, FilteredKeys<T, TUniqColumns>>
+    }>,
+    deleteIds: Array<T[TId]>,
+  ) => Promise<Array<T>>
+  uniqColumns: TUniqColumns
+}
+
+export function tableSync<
+  T extends object,
+  TUniqColumns extends ReadonlyArray<keyof T>,
+  TId extends keyof T & (string | number),
+>(params: TableSyncParams<T, TUniqColumns, TId>) {
+  return {
+    async sync<TUpsert extends Partial<T> & Pick<T, TUniqColumns[number]>>(
+      upsertRaw: Array<TUpsert>,
+    ) {
+      const existingData = await params.readAll()
+
+      function toStrKey(item: T) {
+        return params.uniqColumns
+          .map((column) => {
+            if (item[column] === undefined) {
+              throw new Error(
+                `unique column ${String(column)} can't be undefined in entry ${JSON.stringify(item)}`,
+              )
+            }
+            return item[column]
+          })
+          .join(':')
+      }
+
+      const existingByStrKey = objectify(existingData, (item) => toStrKey(item))
+
+      const isEqualOnKeys = (upsert: Partial<T>, existing: T) => {
+        for (const key in upsert) {
+          if (!(key in existing)) {
+            return false
+          }
+          if (!isEqual(existing[key], upsert[key])) {
+            return false
+          }
+        }
+        return true
+      }
+
+      const upsertItems = upsertRaw
+      const { toCreate, toUpdate, unmodified } = group(
+        upsertItems,
+        (upsertItem) => {
+          const strKey = toStrKey(upsertItem)
+          const existing = existingByStrKey[strKey]
+          if (existing !== undefined) {
+            if (isEqualOnKeys(upsertItem, existing)) {
+              return 'unmodified'
+            } else {
+              return 'toUpdate'
+            }
+          } else {
+            return 'toCreate'
+          }
+        },
+      )
+
+      const deletedStrKeys = new Set<keyof typeof existingByStrKey>(
+        Object.keys(existingByStrKey),
+      )
+      for (const item of upsertItems) {
+        deletedStrKeys.delete(toStrKey(item))
+      }
+      const deletedIds = [...deletedStrKeys].map((strKey) => {
+        const existingByStrKeyElementElement =
+          existingByStrKey[strKey]?.[params.id]
+        if (existingByStrKeyElementElement === undefined) {
+          throw new Error(
+            `The PK column '${params.id}' is not presented in ${JSON.stringify(existingByStrKey[strKey])}`,
+          )
+        }
+        return existingByStrKeyElementElement
+      })
+
+      const inserted = await params.writeAll(
+        toCreate || [],
+        (toUpdate || []).map((update) => {
+          return {
+            data: update,
+            where: pick<T, TUniqColumns>(update, params.uniqColumns),
+          }
+        }),
+        deletedIds as Array<T[TId]>,
+      )
+
+      const findActual = (key: Pick<T, TUniqColumns[number]>) => {
+        const strKey = toStrKey(key)
+        const maybeExisting = existingByStrKey[strKey]
+        if (maybeExisting !== undefined && !(strKey in deletedStrKeys)) {
+          return maybeExisting
+        }
+        return inserted.find((ins) => {
+          return toStrKey(ins) === strKey
+        })
+      }
+
+      function getActual() {
+        return [...inserted, ...(toUpdate || []), ...(unmodified || [])].map(
+          (row) => findActual(row),
+        ) as Array<Pick<T, TUniqColumns[number]> & T[TId]>
+      }
+
+      return {
+        findIdMaybe: (
+          key: Pick<T, TUniqColumns[number]>,
+        ): T[TId] | undefined => {
+          return findActual(key)?.[params.id]
+        },
+
+        findIdOrThrow: (key: Pick<T, TUniqColumns[number]>): T[TId] => {
+          const maybeInserted = findActual(key)?.[params.id]
+          if (!maybeInserted) {
+            const total = [toCreate, toUpdate, unmodified]
+              .map((s) => s?.length || 0)
+              .reduce((a, c) => a + c, 0)
+            throw new Error(
+              `findOrThrow: '${toStrKey(key)}' not found. (Existed #: ${total})`,
+            )
+          }
+          return maybeInserted
+        },
+        getActual() {
+          return getActual()
+        },
+      }
+    },
+  }
+}
+
+export interface TableSyncIdBag<
+  T,
+  TUniqColumns extends ReadonlyArray<keyof T>,
+> {
+  findId: (key: Pick<T, TUniqColumns[number]>) => T[keyof T] | undefined
+}