stonyx 0.2.3-alpha.6 → 0.2.3-alpha.7

package/README.md

@@ -5,23 +5,19 @@
 - 100% JavaScript (ES Modules)
 - Drop-in module system — no boilerplate
 - Automatic async module loading and initialization
-- Built-in CLI for scaffolding, bootstrapping, and testing
+- Built-in CLI for bootstrapping and testing
 
 ## Quick Start
 
 ```bash
-npm install -g stonyx
-stonyx new my-app
-cd my-app
-stonyx serve
+npm install stonyx
 ```
 
-The `new` command walks you through module selection and generates a ready-to-run project. From there, the CLI handles bootstrapping:
+The CLI handles everything — no manual `new Stonyx()` calls needed:
 
 ```bash
 stonyx serve    # Bootstrap + run app.js
 stonyx test     # Bootstrap + run tests
-stonyx help     # Show all available commands
 ```
 
 Stonyx reads `config/environment.js`, initializes all `@stonyx/*` modules from your `devDependencies`, and runs your application.
@@ -44,12 +40,8 @@ Stonyx reads `config/environment.js`, initializes all `@stonyx/*` modules from y
 | Module | Description |
 |--------|-------------|
 | [@stonyx/cron](https://github.com/abofs/stonyx-cron) | Lightweight async job scheduling |
-| [@stonyx/discord](https://github.com/abofs/stonyx-discord) | Discord bot with command and event handler auto-discovery |
-| [@stonyx/events](https://github.com/abofs/stonyx-events) | Pub/sub event system |
-| [@stonyx/oauth](https://github.com/abofs/stonyx-oauth) | OAuth provider integration |
-| [@stonyx/orm](https://github.com/abofs/stonyx-orm) | ORM with models, relationships, and serializers |
 | [@stonyx/rest-server](https://github.com/abofs/stonyx-rest-server) | Dynamic REST server with auto-route registration |
-| [@stonyx/sockets](https://github.com/abofs/stonyx-sockets) | WebSocket server and client |
+| [@stonyx/orm](https://github.com/abofs/stonyx-orm) | ORM with models, relationships, and serializers |
 
 ## License
 

package/docs/cli.md

@@ -12,20 +12,10 @@ stonyx <command> [...args]
 
 | Command | Alias | Description |
 |---------|-------|-------------|
-| `new` | `n` | Scaffold a new Stonyx project |
 | `serve` | `s` | Bootstrap Stonyx and run the app |
 | `test` | `t` | Bootstrap Stonyx in test mode and run tests |
 | `help` | `h` | Show available commands |
 
-### new
-
-Scaffolds a new Stonyx project in the current directory. Prompts for a project name and which modules to include, then generates the project structure and runs `pnpm install`.
-
-```bash
-stonyx new              # Prompts for project name
-stonyx new my-app       # Creates my-app/ in the current directory
-```
-
 ### serve
 
 Bootstraps Stonyx (loads config, initializes modules, runs lifecycle hooks), then imports your application entry point.

package/docs/conventions/orm-conventions.md

@@ -156,3 +156,35 @@ export default class DBModel extends Model {
 ```
 
 Located at `config/db-schema.js`, referenced from `config/environment.js`.
+
+## Store
+
+The store is the in-memory data layer. Use it for internal app logic (not REST API consumers).
+
+```js
+import Orm, { store, createRecord, updateRecord } from '@stonyx/orm';
+
+// Read — sync, from memory (requires memory: true on model, which is the default)
+const record = store.get('animal', 1);
+const allAnimals = store.data.get('animals');
+
+// Read — async, queries DB if memory: false
+const record = await store.find('animal', 1);
+const all = await store.findAll('animal');
+
+// Create — adds to store and returns the record
+const animal = createRecord('animal', { type: 'dog', age: 3, owner: 'angela' });
+
+// Update — patches fields on an existing record
+updateRecord(animal, { age: 4 });
+
+// Delete
+store.remove('animal', 1);
+
+// Persist to disk — required when not using REST-triggered autosave
+await Orm.db.save();
+```
+
+**When to use `Orm.db.save()`**: The `autosave: 'onUpdate'` config only triggers on REST POST/PATCH/DELETE. When modifying data directly via `createRecord` / `updateRecord` in app code (not through REST), call `Orm.db.save()` explicitly to persist.
+
+**Store vs REST**: Use `store` for internal app logic (session tracking, state management). Use REST request handlers for external API consumers. Both operate on the same in-memory data.

package/docs/modules.md

@@ -72,11 +72,7 @@ await waitForModule('rest-server'); // Waits for @stonyx/rest-server
 | Module | Description |
 |--------|-------------|
 | [@stonyx/cron](https://github.com/abofs/stonyx-cron) | Lightweight async job scheduling with min-heap |
-| [@stonyx/discord](https://github.com/abofs/stonyx-discord) | Discord bot with command and event handler auto-discovery |
-| [@stonyx/events](https://github.com/abofs/stonyx-events) | Pub/sub event system |
-| [@stonyx/oauth](https://github.com/abofs/stonyx-oauth) | OAuth provider integration |
-| [@stonyx/orm](https://github.com/abofs/stonyx-orm) | ORM with models, relationships, serializers, and optional REST integration |
 | [@stonyx/rest-server](https://github.com/abofs/stonyx-rest-server) | Dynamic REST server with auto-route registration |
-| [@stonyx/sockets](https://github.com/abofs/stonyx-sockets) | WebSocket server and client |
+| [@stonyx/orm](https://github.com/abofs/stonyx-orm) | ORM with models, relationships, serializers, and optional REST integration |
 
 See each module's repository for its specific documentation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stonyx",
-  "version": "0.2.3-alpha.6",
+  "version": "0.2.3-alpha.7",
   "description": "Base stonyx framework module",
   "main": "main.js",
   "type": "module",
@@ -30,10 +30,10 @@
     "url": "https://github.com/abofs/stonyx/issues"
   },
   "dependencies": {
-    "@stonyx/utils": "0.2.3-beta.5",
     "node-chronicle": "^0.2.0"
   },
   "devDependencies": {
+    "@stonyx/utils": "0.2.3-beta.7",
     "qunit": "^2.24.1",
     "sinon": "^21.0.0"
   },

package/src/cli.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import serve from './cli/serve.js';
 import test from './cli/test.js';