Merge pull request #11 from crashmax-dev/feat/node-browser-packages

stenodb v2

Author: crashmax-dev

.github/workflows/publish.yaml

@@ -0,0 +1,23 @@
+name: Publish
+
+on:
+  push:
+    branches: [master]
+
+jobs:
+  version:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: pnpm/action-setup@v2
+        with:
+          version: 7.2.1
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 18.x
+          cache: 'pnpm'
+      - run: pnpm install --frozen-lockfile
+      - run: |
+          echo "//registry.npmjs.org/:_authToken="${{secrets.NPM_TOKEN}}"" > ~/.npmrc
+        shell: sh
+      - run: pnpm -r --filter='./packages/*' publish --access public

README.md

@@ -1,6 +1,6 @@
 # stenodb [![](https://img.shields.io/npm/v/stenodb)](https://www.npmjs.org/package/stenodb)
 
-> ✍ Easy to use local JSON database. Ready to use with [LocalStorage](https://developer.mozilla.org/ru/docs/Web/API/Window/localStorage), [SessionStorage](https://developer.mozilla.org/ru/docs/Web/API/Window/sessionStorage) and Node.js.
+> ✍ Easy to use local JSON database. Ready to use in browser (localStorage, sessionStorage) and Node.js.
 
 ## Install
 
@@ -16,14 +16,20 @@ yarn add stenodb
 pnpm add stenodb
 ```
 
+| Package | Version | Platform |
+| ------- | ------ | ----------- |
+| [stenodb](./packages/stenodb) | [![](https://img.shields.io/npm/v/stenodb)](https://npm.im/stenodb) | Reexports packages |
+| [@stenodb/node](./packages/node) | [![](https://img.shields.io/npm/v/@stenodb/node)](https://npm.im/@stenodb/node) | Node.js |
+| [@stenodb/browser](./packages/browser) | [![](https://img.shields.io/npm/v/@stenodb/browser)](https://npm.im/@stenodb/browser) | Browser |
+
 ## Usage
 
 > **Warning**\
 > stenodb is a pure ESM package. If you're having trouble using it in your project, please [read this](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).
 
-
-### Entity
+### Database entities
 ```typescript
+// entities.ts
 import { Type } from 'class-transformer'
 
 export class Users {
@@ -60,55 +66,48 @@ export class Post {
 }
 ```
 
-### Node.js
+### `@stenodb/node`
 
 ```typescript
 import 'reflect-metadata'
-import { join } from 'node:path'
-import { NodeProvider } from 'stenodb/node'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { AsyncWriter, NodeDatabase } from '@stenodb/node'
 import { Users, User, Post } from './entities.js'
 
 const path = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'database')
+const adapter = new AsyncWriter('users', Users)
+const initialData = new Users(new User('John Doe'))
+const database = new NodeDatabase(path)
+const databaseUsers = database.create(adapter, initialData)
 
-const databaseProvider = new NodeProvider({
-  path,
-  logger: { enabled: true }
-})
-
-const databaseUsers = databaseProvider.createDatabase({
-  name: 'users',
-  entity: Users,
-  initialData: new Users(new User('John Doe'))
-})
-
+await databaseUsers.read()
 databaseUsers.data?.users[0]?.addPost(new Post('Lorem ipsum'))
-databaseUsers.write()
+await databaseUsers.write()
 ```
 
-### Browser
+### `@stenodb/browser`
 ```typescript
 import 'reflect-metadata'
-import { BrowserProvider, LocalStorage } from 'stenodb/browser'
+import { LocalStorage, BrowserDatabase } from '@stenodb/browser'
 import { Users, User, Post } from './entities.js'
 
-const adapter = new LocalStorage<Users>('users')
-
-const databaseUsers = new BrowserProvider({
-  adapter,
-  entity: Users,
-  initialData: new Users(new User('John Doe'))
-})
+const adapter = new LocalStorage('users', Users)
+const initialData = new Users(new User('John Doe'))
+const databaseUsers = new BrowserDatabase(adapter, initialData)
 
+databaseUsers.read()
 databaseUsers.data?.users[0]?.addPost(new Post('Lorem ipsum'))
 databaseUsers.write()
 ```
 
-## Related
+## Credits
 
 - [steno](https://github.com/typicode/steno) - Specialized fast async file writer.
 - [class-transformer](https://github.com/typestack/class-transformer) - Decorator-based transformation, serialization, and deserialization between objects and classes.
 - [class-validator](https://github.com/typestack/class-validator) - Decorator-based property validation for classes.
 - [json-difference](https://github.com/lukascivil/json-difference) - A simple way to find the difference between two objects or json diff.
+- [tslog](https://github.com/fullstack-build/tslog) - Universal Logger for TypeScript and JavaScript.
 
 ## License
 

examples/with-lodash/index.html renamed to examples/with-browser-lodash/index.html

@@ -1,5 +1,5 @@
 {
-  "name": "with-lodash",
+  "name": "with-browser-lodash",
   "private": true,
   "version": "0.0.0",
   "type": "module",
@@ -14,10 +14,10 @@
     "vite": "4.0.4"
   },
   "dependencies": {
+    "@stenodb/browser": "workspace:*",
     "@zero-dependency/dom": "0.12.0",
     "class-transformer": "0.5.1",
     "lodash": "4.17.21",
-    "reflect-metadata": "0.1.13",
-    "stenodb": "workspace:*"
+    "reflect-metadata": "0.1.13"
   }
 }

examples/with-lodash/package.json renamed to examples/with-browser-lodash/package.json

@@ -1,7 +1,7 @@
 import 'reflect-metadata'
 import { el } from '@zero-dependency/dom'
 import { User } from './entities.js'
-import { storage } from './storage.js'
+import { addUser, getLastUserId, storage } from './storage.js'
 
 const app = document.querySelector('#app')!
 
@@ -48,7 +48,7 @@ const form = el(
         return
       }
 
-      storage.addUser(new User(storage.getLastUserId() + 1, username))
+      addUser(new User(getLastUserId() + 1, username))
       render()
     }
   },
@@ -63,7 +63,7 @@ const storagePreview = el('pre')
 function render() {
   form.reset()
   usernameInput.focus()
-  userIdInput.value = storage.getLastUserId().toString()
+  userIdInput.value = getLastUserId().toString()
   storagePreview.textContent = JSON.stringify(storage.data, null, 2)
 }
 

examples/with-lodash/src/entities.ts renamed to examples/with-browser-lodash/src/entities.ts

@@ -0,0 +1,27 @@
+import { BrowserDatabase, LocalStorage } from '@stenodb/browser'
+import lodash from 'lodash'
+import { User, Users } from './entities.js'
+import type { BrowserAdapter } from '@stenodb/browser/types'
+
+class StorageWithLodash<T> extends BrowserDatabase<T> {
+  chain: lodash.ExpChain<this['data']> = lodash.chain(this).get('data')
+
+  constructor(adapter: BrowserAdapter<T>, initialData: T) {
+    super(adapter, initialData)
+  }
+}
+
+const adapter = new LocalStorage('users', Users)
+const initialData = new Users(new User(1, 'John'))
+
+export const storage = new StorageWithLodash(adapter, initialData)
+storage.read()
+
+export function addUser(user: User): void {
+  storage.chain.get('users').push(user).value()
+  storage.write()
+}
+
+export function getLastUserId(): number {
+  return storage.chain.get('users').last().get('id').value()
+}

examples/with-lodash/src/index.ts renamed to examples/with-browser-lodash/src/index.ts

@@ -9,13 +9,13 @@
     "preview": "vite preview"
   },
   "devDependencies": {
-    "typescript": "4.9.4",
-    "vite": "4.0.4"
+    "typescript": "4.9.5",
+    "vite": "4.1.1"
   },
   "dependencies": {
+    "@stenodb/browser": "workspace:*",
     "@zero-dependency/dom": "0.12.0",
     "class-transformer": "0.5.1",
-    "reflect-metadata": "0.1.13",
-    "stenodb": "workspace:*"
+    "reflect-metadata": "0.1.13"
   }
 }