Brunobkr/llama.cpp_AlgMor24_github

1# Dexie.js2 3[![NPM Version][npm-image]][npm-url] ![Build Status](https://github.com/dexie/Dexie.js/actions/workflows/main.yml/badge.svg) [![Join our Discord](https://img.shields.io/discord/1328303736363421747?label=Discord&logo=discord&style=badge)](https://discord.gg/huhre7MHBF)4 5Dexie.js is a wrapper library for indexedDB - the standard database in the browser. https://dexie.org.6 7#### Why Dexie.js?8 9IndexedDB is the portable database for all browser engines. Dexie.js makes it fun and easy to work with.10 11But also:12 13* Dexie.js is widely used by 100,000 of web sites, apps and other projects and supports all browsers, Electron for Desktop apps, Capacitor for iOS / Android apps and of course pure PWAs.14* Dexie.js works around bugs in the IndexedDB implementations, giving a more stable user experience.15* Need sync? [Dexie Cloud](https://dexie.org/cloud/) adds real-time sync, auth, and collaboration on top of Dexie.js — no backend needed.16 17#### Hello World (vanilla JS)18 19```html20<!DOCTYPE html>21<html>22  <head>23    <script type="module">24      // Import Dexie25      import { Dexie } from 'https://unpkg.com/dexie/dist/modern/dexie.mjs';26 27      //28      // Declare Database29      //30      const db = new Dexie('FriendDatabase');31      db.version(1).stores({32        friends: '++id, age'33      });34 35      //36      // Play with it37      //38      try {39        await db.friends.add({ name: 'Alice', age: 21 });40 41        const youngFriends = await db.friends42            .where('age')43            .below(30)44            .toArray();45 46        alert(`My young friends: ${JSON.stringify(youngFriends)}`);47      } catch (e) {48        alert(`Oops: ${e}`);49      }50    </script>51  </head>52</html>53```54 55Yes, it's that simple. Read [the docs](https://dexie.org/docs/) to get into the details.56 57#### Hello World (legacy script tags)58 59```html60<!DOCTYPE html>61<html>62  <head>63    <script src="https://unpkg.com/dexie/dist/dexie.js"></script>64    <script>65 66      //67      // Declare Database68      //69      const db = new Dexie('FriendDatabase');70      db.version(1).stores({71        friends: '++id, age'72      });73 74      //75      // Play with it76      //77      db.friends.add({ name: 'Alice', age: 21 }).then(() => {78        return db.friends79          .where('age')80          .below(30)81          .toArray();82      }).then(youngFriends => {83        alert (`My young friends: ${JSON.stringify(youngFriends)}`);84      }).catch (e => {85        alert(`Oops: ${e}`);86      });87 88    </script>89  </head>90</html>91```92 93#### Hello World (React + Typescript)94 95Real-world apps are often built using components in various frameworks. Here's a version of Hello World written for React and Typescript. There are also links below this sample to more tutorials for different frameworks...96 97```tsx98import React from 'react';99import { Dexie, type EntityTable } from 'dexie';100import { useLiveQuery } from 'dexie-react-hooks';101 102// Typing for your entities (hint is to move this to its own module)103export interface Friend {104  id: number;105  name: string;106  age: number;107}108 109// Database declaration (move this to its own module also)110export const db = new Dexie('FriendDatabase') as Dexie & {111  friends: EntityTable<Friend, 'id'>;112};113db.version(1).stores({114  friends: '++id, age',115});116 117// Component:118export function MyDexieReactComponent() {119  const youngFriends = useLiveQuery(() =>120    db.friends121      .where('age')122      .below(30)123      .toArray()124  );125 126  return (127    <>128      <h3>My young friends</h3>129      <ul>130        {youngFriends?.map((f) => (131          <li key={f.id}>132            Name: {f.name}, Age: {f.age}133          </li>134        ))}135      </ul>136      <button137        onClick={() => {138          db.friends.add({ name: 'Alice', age: 21 });139        }}140      >141        Add another friend142      </button>143    </>144  );145}146```147 148[Tutorials for React, Svelte, Vue, Angular and vanilla JS](https://dexie.org/docs/Tutorial/Getting-started)149 150[API Reference](https://dexie.org/docs/API-Reference)151 152[Samples](https://dexie.org/docs/Samples)153 154### Performance155 156Dexie has kick-ass performance. Its [bulk methods](<https://dexie.org/docs/Table/Table.bulkPut()>) take advantage of a lesser-known feature in IndexedDB that makes it possible to store stuff without listening to every onsuccess event. This speeds up the performance to a maximum.157 158#### Supported operations159 160```js161above(key): Collection;162aboveOrEqual(key): Collection;163add(item, key?): Promise;164and(filter: (x) => boolean): Collection;165anyOf(keys[]): Collection;166anyOfIgnoreCase(keys: string[]): Collection;167below(key): Collection;168belowOrEqual(key): Collection;169between(lower, upper, includeLower?, includeUpper?): Collection;170bulkAdd(items: Array): Promise;171bulkDelete(keys: Array): Promise;172bulkPut(items: Array): Promise;173clear(): Promise;174count(): Promise;175delete(key): Promise;176distinct(): Collection;177each(callback: (obj) => any): Promise;178eachKey(callback: (key) => any): Promise;179eachPrimaryKey(callback: (key) => any): Promise;180eachUniqueKey(callback: (key) => any): Promise;181equals(key): Collection;182equalsIgnoreCase(key): Collection;183filter(fn: (obj) => boolean): Collection;184first(): Promise;185get(key): Promise;186inAnyRange(ranges): Collection;187keys(): Promise;188last(): Promise;189limit(n: number): Collection;190modify(changeCallback: (obj: T, ctx:{value: T}) => void): Promise;191modify(changes: { [keyPath: string]: any } ): Promise;192noneOf(keys: Array): Collection;193notEqual(key): Collection;194offset(n: number): Collection;195or(indexOrPrimayKey: string): WhereClause;196orderBy(index: string): Collection;197primaryKeys(): Promise;198put(item: T, key?: Key): Promise;199reverse(): Collection;200sortBy(keyPath: string): Promise;201startsWith(key: string): Collection;202startsWithAnyOf(prefixes: string[]): Collection;203startsWithAnyOfIgnoreCase(prefixes: string[]): Collection;204startsWithIgnoreCase(key: string): Collection;205toArray(): Promise;206toCollection(): Collection;207uniqueKeys(): Promise;208until(filter: (value) => boolean, includeStopEntry?: boolean): Collection;209update(key: Key, changes: { [keyPath: string]: any }): Promise;210```211 212This is a mix of methods from [WhereClause](https://dexie.org/docs/WhereClause/WhereClause), [Table](https://dexie.org/docs/Table/Table) and [Collection](https://dexie.org/docs/Collection/Collection). Dive into the [API reference](https://dexie.org/docs/API-Reference) to see the details.213 214## Dexie Cloud215 216[Dexie Cloud](https://dexie.org/cloud/) is the easiest way to add sync, authentication, and real-time collaboration to your Dexie app. You keep writing frontend code with Dexie.js — Dexie Cloud handles the rest.217 218**What you get:**219- 🔄 **Sync across devices** — changes propagate in real time, no polling needed220- 🔐 **Authentication** — built-in user auth, no identity provider required221- 🛡️ **Access control** — share data between users with fine-grained permissions222- 📁 **File & blob storage** — store attachments alongside your structured data223- ✈️ **Offline-first** — works fully offline, syncs when back online224 225**Getting started is just a few lines:**226 227```bash228npm install dexie-cloud-addon229```230 231```ts232import Dexie from 'dexie';233import dexieCloud from 'dexie-cloud-addon';234 235const db = new Dexie('MyDatabase', { addons: [dexieCloud] });236db.version(1).stores({ items: '@id, title' });237db.cloud.configure({ databaseUrl: 'https://<your-db>.dexie.cloud' });238```239 240That's it. Your existing Dexie app now syncs. Hosted cloud or self-hosted on your own infrastructure. 👋241 242→ [Quickstart guide](https://dexie.org/cloud/docs/quickstart)243 244**Sample app:**245 246Source: [Dexie Cloud To-do app](https://github.com/dexie/Dexie.js/tree/master/samples/dexie-cloud-todo-app)247 248Live demo: https://dexie.github.io/Dexie.js/dexie-cloud-todo-app/249 250## Legacy Addons (dexie-observable, dexie-syncable)251 252> **⚠️ These packages are legacy and no longer maintained.**253 254If you find references to `dexie-observable` or `dexie-syncable` in tutorials, blog posts, or old code, be aware that these are **deprecated** sync solutions. They are not compatible with Dexie Cloud and should not be used in new projects.255 256**For local-first sync, use [`dexie-cloud-addon`](https://dexie.org/cloud/) instead.** It is the modern, actively maintained solution for offline-first apps with real-time sync.257 258## Samples259 260https://dexie.org/docs/Samples261 262https://github.com/dexie/Dexie.js/tree/master/samples263 264## Knowledge Base265 266[https://dexie.org/docs/Questions-and-Answers](https://dexie.org/docs/Questions-and-Answers)267 268## Website269 270[https://dexie.org](https://dexie.org)271 272## Install via npm273 274```275npm install dexie276```277 278## Download279 280For those who don't like package managers, here's the download links:281 282### UMD (for legacy script includes as well as commonjs require):283 284https://unpkg.com/dexie@latest/dist/dexie.min.js285 286https://unpkg.com/dexie@latest/dist/dexie.min.js.map287 288### Modern (ES module):289 290https://unpkg.com/dexie@latest/dist/modern/dexie.min.mjs291 292https://unpkg.com/dexie@latest/dist/modern/dexie.min.mjs.map293 294### Typings:295 296https://unpkg.com/dexie@latest/dist/dexie.d.ts297 298# Contributing299 300See [CONTRIBUTING.md](CONTRIBUTING.md)301 302## Build303 304```305pnpm install306pnpm run build307```308 309## Test310 311```312pnpm test313```314 315## Watch316 317```318pnpm run watch319```320 321<br/>322 323Browser testing via<br/>324<a href="https://www.testmuai.com/?utm_medium=sponsor&utm_source=dexiejs">325  <picture>326    <source media="(prefers-color-scheme: dark)" srcset="testmuai-logo-white.svg">327    <img src="testmuai-logo.svg" alt="TestMu AI (Formerly LambdaTest)" width="147" height="26">328  </picture>329</a>330 331[npm-image]: https://img.shields.io/npm/v/dexie.svg?style=flat332[npm-url]: https://npmjs.org/package/dexie333