stores

docs/api/functions.md

@@ -5,6 +5,29 @@ pos: 6
 
 # Functions
 
+``` javascript
+let functions = store.functions;
+let response = await functions.call('hello', { ok: true });
+response // → { data: { … } }
+```
+
+## async call(name, props) `→ object`
+
+Calls Firebase callable function in default region.
+
+Alias for `functions.region().call(...args)`
+
+## region()
+
+Returns default region.
+
+See [Store](api/store) `options.functions` on how to setup custom default region.
+
 ## region(identifier)
 
-## call(name, props)
+Returns custom region.
+
+``` javascript
+let region = functions.region('europe-west1');
+await region.call('hello', { ok: true });
+```

docs/api/functions/region.md

@@ -5,6 +5,21 @@ pos: 0
 
 # Region
 
-## identifier
+## identifier `→ string`
 
-## call(name, props)
+Region identifier
+
+``` javascript
+let region = store.functions.region();
+region.identifier // → 'us-central1'
+```
+
+## async call(name, props) `→ object`
+
+Calls Firebase callable function.
+
+``` javascript
+let region = store.functions.region();
+let result = await region.call('hello', { ok: true });
+result // → { data: { … } }
+```

docs/api/stores.md

@@ -5,12 +5,50 @@ pos: 7
 
 # Stores
 
-## stats
+Stores manages any [Store](api/store) instances used in the app.
 
-## models
+Singleton, accessible using `getStores()` helper
 
-## createStore(identifier, factory)
+``` javascript
+import { getStores } from 'zuglet/utils';
+let stores = getStores(this);
+```
 
-## store(identifier, opts)
+## stats `→ Stats`
 
-## settle()
+Returns singleton [Stats](api/stores/stats) instance.
+
+## models `→ Models`
+
+Returns singleton [Models](api/models) instance.
+
+## createStore(identifier, factory) `→ Store`
+
+Creates a new store.
+
+``` javascript
+import BaseStore from 'zuglet/store';
+
+class Store extends BaseStore {
+}
+
+let store = getStores(this).createStore('store', Store);
+```
+
+## store(identifier, { optional })
+
+Returns existing store.
+
+* `optional` → boolean, defaults to false
+
+``` javascript
+let missing = getStores(this).store('missing', { optional: true });
+missing // → undefined
+
+let existing = getStores(this).store('existing');
+existing // → Store
+```
+
+## async settle() → undefined
+
+Alias for `stores.stats.settle()`