statezero 0.1.0b1__tar.gz

statezero-0.1.0b1/PKG-INFO

@@ -0,0 +1,252 @@
+Metadata-Version: 2.4
+Name: statezero
+Version: 0.1.0b1
+Summary: A short description of your package
+Author-email: Robert Herring <robert.herring@statezero.dev>
+Project-URL: homepage, https://www.statezero.dev
+Project-URL: repository, https://github.com/state-zero/statezero
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: license.md
+Requires-Dist: Django<5.2.0,>=5.1.0
+Requires-Dist: django-money<3.5.0,>=3.4.0
+Requires-Dist: djangorestframework<3.16.0,>=3.15.0
+Requires-Dist: fakeredis<3.0.0,>=2.27.0
+Requires-Dist: fastapi<0.116.0,>=0.115.0
+Requires-Dist: hypothesis<7.0.0,>=6.108.0
+Requires-Dist: jsonschema<5.0.0,>=4.23.0
+Requires-Dist: networkx<4.0.0,>=3.4.0
+Requires-Dist: openapi-spec-validator<0.8.0,>=0.7.0
+Requires-Dist: orjson<4.0.0,>=3.10.0
+Requires-Dist: pusher<4.0.0,>=3.3.0
+Requires-Dist: pydantic<3.0.0,>=2.10.0
+Requires-Dist: rich<14.0.0,>=13.9.0
+Requires-Dist: psycopg2<3.0.0,>=2.9.0
+Requires-Dist: django-redis<6.0.0,>=5.4.0
+Requires-Dist: django-cors-headers<5.0.0,>=4.7.0
+Requires-Dist: django-zen-queries<3.0.0,>=2.1.0
+Requires-Dist: cytoolz<2.0.0,>=1.0.0
+Dynamic: license-file
+
+# StateZero
+
+**The Real-Time Django to JavaScript Data Bridge**
+
+Connect your Django backend to React/Vue frontends with 90% less code. No repetitive serializers, views, or tight coupling.
+
+## Why StateZero?
+
+**The Problem:** Building modern web apps means writing the same CRUD logic three times - Django models, REST API serializers/views, and frontend data fetching. This creates:
+
+- 80% of app complexity in data shuttling
+- 50% of your codebase devoted to API glue
+- Hundreds of hours maintaining sync between frontend and backend
+
+**The Solution:** StateZero eliminates the API layer entirely. Write Django models once, query them directly from JavaScript with the same ORM syntax you already know.
+
+## Features
+
+✨ **Django ORM Syntax in JavaScript** - Use `.filter()`, `.exclude()`, `.orderBy()` exactly like Django  
+⚡ **Real-Time Updates** - UI automatically updates when backend data changes  
+🔒 **Django Permissions** - Your existing permission classes work on the frontend  
+📝 **Auto-Generated TypeScript** - Perfect type safety from your Django models  
+🚀 **Optimistic Updates** - UI feels instant, syncs in background  
+🔗 **Deep Relationships** - Traverse foreign keys naturally: `todo.category.name`
+
+## Quick Example
+
+### 1. Register Your Django Model
+
+```python
+# todos/crud.py
+from statezero.adaptors.django.config import registry
+from .models import Todo
+
+registry.register(Todo)
+```
+
+### 2. Query From JavaScript Like Django
+
+```javascript
+// Get all incomplete todos, ordered by priority
+const todos = Todo.objects
+  .filter({ is_completed: false })
+  .orderBy("-priority", "created_at");
+
+// Complex queries with relationships
+const urgentWorkTodos = Todo.objects.filter({
+  priority: "high",
+  category__name: "Work",
+  due_date__lt: "2024-12-31",
+});
+
+// Django-style field lookups
+const searchResults = Todo.objects.filter({
+  title__icontains: "meeting",
+  created_by__email__endswith: "@company.com",
+});
+```
+
+### 3. Real-Time Updates in One Line
+
+```vue
+<script setup>
+import { useQueryset } from "@statezero/core/vue";
+
+// This list automatically updates when todos change
+const todos = useQueryset(() => Todo.objects.filter({ is_completed: false }));
+</script>
+
+<template>
+  <div v-for="todo in todos.fetch({ limit: 10 })" :key="todo.id">
+    {{ todo.title }}
+  </div>
+</template>
+```
+
+## The Magic: Optimistic vs Confirmed
+
+### Optimistic (Instant UI)
+
+```javascript
+// UI updates immediately, syncs later
+const newTodo = Todo.objects.create({
+  title: "Buy groceries",
+  priority: "medium",
+});
+
+// Edit optimistically
+todo.title = "Buy organic groceries";
+todo.save(); // UI updates instantly
+
+// Delete optimistically
+todo.delete(); // Gone from UI immediately
+```
+
+### Confirmed (Wait for Server)
+
+```javascript
+// Wait for server confirmation
+const confirmedTodo = await Todo.objects.create({
+  title: "Important meeting",
+});
+
+// Wait for update confirmation
+await todo.save();
+
+// Wait for deletion confirmation
+await todo.delete();
+```
+
+## Advanced Django ORM Features
+
+### Complex Filtering with Q Objects
+
+```javascript
+import { Q } from "@statezero/core";
+
+// Multiple OR conditions
+const urgentTodos = Todo.objects.filter({
+  Q: [Q("OR", { priority: "high" }, { due_date__lt: "tomorrow" })],
+});
+
+// Nested conditions
+const myImportantTodos = Todo.objects.filter({
+  Q: [
+    Q(
+      "AND",
+      { assigned_to: currentUser.id },
+      Q("OR", { priority: "high" }, { is_flagged: true })
+    ),
+  ],
+});
+```
+
+### Aggregation & F Expressions
+
+```javascript
+import { F } from "@statezero/core";
+
+// Count, sum, average like Django
+const todoCount = await Todo.objects.count();
+const avgPriority = await Todo.objects.avg("priority_score");
+
+// Database-level calculations
+await Product.objects.update({
+  view_count: F("view_count + 1"),
+  popularity: F("likes * 2 + shares"),
+});
+```
+
+### Get or Create
+
+```javascript
+// Just like Django's get_or_create
+const [todo, created] = await Todo.objects.getOrCreate(
+  { title: "Daily standup" },
+  { defaults: { priority: "medium", category: workCategory } }
+);
+```
+
+### Relationship Traversal
+
+```javascript
+// Access related objects naturally
+const todo = await Todo.objects.get({ id: 1 });
+console.log(todo.category.name); // Foreign key
+console.log(todo.created_by.username); // Another FK
+console.log(todo.comments.length); // Reverse FK
+
+// Filter by relationships
+const workTodos = Todo.objects.filter({
+  category__name: "Work",
+  assigned_to__department__name: "Engineering",
+});
+```
+
+## Installation
+
+### Backend
+
+```bash
+pip install git+https://github.com/state-zero/statezero
+pip install django-cors-headers pusher
+```
+
+### Frontend
+
+```bash
+npm install https://github.com/state-zero/statezero-client
+```
+
+### Generate TypeScript Models
+
+```bash
+npx statezero sync-models
+```
+
+## Why Choose StateZero Over...
+
+**🆚 HTMX:** Use modern React/Vue with full JavaScript ecosystem while keeping backend simplicity
+
+**🆚 Firebase/Supabase:** Keep your Django backend, models, and business logic. No vendor lock-in.
+
+**🆚 OpenAPI/GraphQL:** Get real-time updates and Django ORM power, not just basic CRUD
+
+**🆚 Traditional REST APIs:** Write 90% less boilerplate. Focus on features, not data plumbing.
+
+## Pricing
+
+StateZero uses a no-rugpull license model:
+
+- **$0/month** for companies with revenue up to $3M
+- **$75/month** for companies with revenue up to $7.5M
+- **$200/month** for companies with revenue up to $20M
+- **$500/month** for companies with revenue up to $100M
+- **$1,000/month** for companies with revenue above $100M
+
+Lock in your rate forever by signing up early. We can't change your fee or cancel your license.
+
+## Get Started
+
+Run `pip install git+https://github.com/state-zero/statezero` and `npm install https://github.com/state-zero/statezero-client` to begin.

statezero-0.1.0b1/README.md

@@ -0,0 +1,222 @@
+# StateZero
+
+**The Real-Time Django to JavaScript Data Bridge**
+
+Connect your Django backend to React/Vue frontends with 90% less code. No repetitive serializers, views, or tight coupling.
+
+## Why StateZero?
+
+**The Problem:** Building modern web apps means writing the same CRUD logic three times - Django models, REST API serializers/views, and frontend data fetching. This creates:
+
+- 80% of app complexity in data shuttling
+- 50% of your codebase devoted to API glue
+- Hundreds of hours maintaining sync between frontend and backend
+
+**The Solution:** StateZero eliminates the API layer entirely. Write Django models once, query them directly from JavaScript with the same ORM syntax you already know.
+
+## Features
+
+✨ **Django ORM Syntax in JavaScript** - Use `.filter()`, `.exclude()`, `.orderBy()` exactly like Django  
+⚡ **Real-Time Updates** - UI automatically updates when backend data changes  
+🔒 **Django Permissions** - Your existing permission classes work on the frontend  
+📝 **Auto-Generated TypeScript** - Perfect type safety from your Django models  
+🚀 **Optimistic Updates** - UI feels instant, syncs in background  
+🔗 **Deep Relationships** - Traverse foreign keys naturally: `todo.category.name`
+
+## Quick Example
+
+### 1. Register Your Django Model
+
+```python
+# todos/crud.py
+from statezero.adaptors.django.config import registry
+from .models import Todo
+
+registry.register(Todo)
+```
+
+### 2. Query From JavaScript Like Django
+
+```javascript
+// Get all incomplete todos, ordered by priority
+const todos = Todo.objects
+  .filter({ is_completed: false })
+  .orderBy("-priority", "created_at");
+
+// Complex queries with relationships
+const urgentWorkTodos = Todo.objects.filter({
+  priority: "high",
+  category__name: "Work",
+  due_date__lt: "2024-12-31",
+});
+
+// Django-style field lookups
+const searchResults = Todo.objects.filter({
+  title__icontains: "meeting",
+  created_by__email__endswith: "@company.com",
+});
+```
+
+### 3. Real-Time Updates in One Line
+
+```vue
+<script setup>
+import { useQueryset } from "@statezero/core/vue";
+
+// This list automatically updates when todos change
+const todos = useQueryset(() => Todo.objects.filter({ is_completed: false }));
+</script>
+
+<template>
+  <div v-for="todo in todos.fetch({ limit: 10 })" :key="todo.id">
+    {{ todo.title }}
+  </div>
+</template>
+```
+
+## The Magic: Optimistic vs Confirmed
+
+### Optimistic (Instant UI)
+
+```javascript
+// UI updates immediately, syncs later
+const newTodo = Todo.objects.create({
+  title: "Buy groceries",
+  priority: "medium",
+});
+
+// Edit optimistically
+todo.title = "Buy organic groceries";
+todo.save(); // UI updates instantly
+
+// Delete optimistically
+todo.delete(); // Gone from UI immediately
+```
+
+### Confirmed (Wait for Server)
+
+```javascript
+// Wait for server confirmation
+const confirmedTodo = await Todo.objects.create({
+  title: "Important meeting",
+});
+
+// Wait for update confirmation
+await todo.save();
+
+// Wait for deletion confirmation
+await todo.delete();
+```
+
+## Advanced Django ORM Features
+
+### Complex Filtering with Q Objects
+
+```javascript
+import { Q } from "@statezero/core";
+
+// Multiple OR conditions
+const urgentTodos = Todo.objects.filter({
+  Q: [Q("OR", { priority: "high" }, { due_date__lt: "tomorrow" })],
+});
+
+// Nested conditions
+const myImportantTodos = Todo.objects.filter({
+  Q: [
+    Q(
+      "AND",
+      { assigned_to: currentUser.id },
+      Q("OR", { priority: "high" }, { is_flagged: true })
+    ),
+  ],
+});
+```
+
+### Aggregation & F Expressions
+
+```javascript
+import { F } from "@statezero/core";
+
+// Count, sum, average like Django
+const todoCount = await Todo.objects.count();
+const avgPriority = await Todo.objects.avg("priority_score");
+
+// Database-level calculations
+await Product.objects.update({
+  view_count: F("view_count + 1"),
+  popularity: F("likes * 2 + shares"),
+});
+```
+
+### Get or Create
+
+```javascript
+// Just like Django's get_or_create
+const [todo, created] = await Todo.objects.getOrCreate(
+  { title: "Daily standup" },
+  { defaults: { priority: "medium", category: workCategory } }
+);
+```
+
+### Relationship Traversal
+
+```javascript
+// Access related objects naturally
+const todo = await Todo.objects.get({ id: 1 });
+console.log(todo.category.name); // Foreign key
+console.log(todo.created_by.username); // Another FK
+console.log(todo.comments.length); // Reverse FK
+
+// Filter by relationships
+const workTodos = Todo.objects.filter({
+  category__name: "Work",
+  assigned_to__department__name: "Engineering",
+});
+```
+
+## Installation
+
+### Backend
+
+```bash
+pip install git+https://github.com/state-zero/statezero
+pip install django-cors-headers pusher
+```
+
+### Frontend
+
+```bash
+npm install https://github.com/state-zero/statezero-client
+```
+
+### Generate TypeScript Models
+
+```bash
+npx statezero sync-models
+```
+
+## Why Choose StateZero Over...
+
+**🆚 HTMX:** Use modern React/Vue with full JavaScript ecosystem while keeping backend simplicity
+
+**🆚 Firebase/Supabase:** Keep your Django backend, models, and business logic. No vendor lock-in.
+
+**🆚 OpenAPI/GraphQL:** Get real-time updates and Django ORM power, not just basic CRUD
+
+**🆚 Traditional REST APIs:** Write 90% less boilerplate. Focus on features, not data plumbing.
+
+## Pricing
+
+StateZero uses a no-rugpull license model:
+
+- **$0/month** for companies with revenue up to $3M
+- **$75/month** for companies with revenue up to $7.5M
+- **$200/month** for companies with revenue up to $20M
+- **$500/month** for companies with revenue up to $100M
+- **$1,000/month** for companies with revenue above $100M
+
+Lock in your rate forever by signing up early. We can't change your fee or cancel your license.
+
+## Get Started
+
+Run `pip install git+https://github.com/state-zero/statezero` and `npm install https://github.com/state-zero/statezero-client` to begin.

statezero-0.1.0b1/license.md

@@ -0,0 +1,117 @@
+# **StateZero License Agreement**
+
+_Last Updated: 2025-06-29_
+
+## **1. Copyright and Ownership**
+
+1.1. **StateZero is proprietary software** developed and owned by **Hoza Holdings Pte Ltd** ("Licensor").
+1.2. **StateZero is not open-source.** All rights not expressly granted in this License are **reserved by the Licensor**.
+1.3. **Distribution**: StateZero is made available via **PyPI** (Python Package Index), **npm** (Node Package Manager), and **GitHub**.
+1.4. **Early Release Status**: This is an **early release version** of StateZero designed for community feedback. It is **not considered production ready**. Users are encouraged to provide feedback but should exercise caution when implementing in critical systems.
+
+## **2. Commercial No-Rugpull License**
+
+2.1. **No-Rugpull Guarantee**: StateZero is available under a commercial "no-rugpull" license, which means:
+
+- You receive an **irrevocable right** to use StateZero forever for a fixed monthly fee
+- We **cannot change your fee**, other than a fixed CPI (Consumer Price Index) increase that's automatically added each year
+- As long as you pay the fee and don't build a competitive product, the license will continue
+- If we no longer wish to be associated with your use case, we will ask you not to pay the fee, but **your license will remain valid**
+
+  2.2. **License Philosophy**: If SaaS is like renting and open-source is like owning, our license is like a **999-year leasehold on fixed rent**. It provides the security you need to build and grow your company around StateZero, while allowing us to maintain and develop StateZero to a high standard.
+
+  2.3. **Rate Lock Guarantee**: You lock in the **full rate card for all tiers** at the time you sign up, meaning your fees remain predictable no matter how much your revenue or our pricing changes. To lock in your rates, simply contact us at **robert@statezero.dev**.
+
+## **3. Pricing Structure**
+
+3.1. **Revenue-Based Pricing**:
+
+- **$0/month** for companies with revenue up to **$3M**
+- **$75/month** for companies with revenue up to **$7.5M**
+- **$200/month** for companies with revenue up to **$20M**
+- **$1,000/month** for companies with revenue up to **$100M**
+- **$5,000/month** for companies with revenue above **$100M**
+
+  3.2. **Free Usage Guarantee**: StateZero will **always remain free** for companies with **annual revenue below $3 million**.
+
+  3.3. **Annual CPI Adjustment**: Pricing may be adjusted annually based on the Consumer Price Index, but no other fee changes are permitted once you have locked in your rate.
+
+## **4. Grant of License**
+
+4.1. **Standard Usage License**:
+
+- Licensor grants you a **non-exclusive, non-transferable, worldwide license** to download, install, and use StateZero
+- StateZero **may be used** in both **development and production** environments
+- You may **install StateZero** within your organization but **may not provide StateZero as a service to third parties** without explicit written permission
+
+  4.2. **Scope and Limitations**:
+
+- This License **does not** transfer ownership of StateZero or any intellectual property rights
+- Usage is subject to the pricing structure outlined in Section 3
+
+## **5. LLM Training License**
+
+5.1. **Separate License Required**: Use of StateZero codebase for **Large Language Model (LLM) training purposes** requires a separate license agreement.
+
+5.2. **LLM Training License Fee**: The annual license fee for LLM training usage is **$250,000 per year**.
+
+5.3. **Contact for LLM License**: Organizations requiring LLM training rights must contact **Airhome Sp Zoo** at **robert@statezero.dev** to arrange a separate licensing agreement.
+
+## **6. Restrictions**
+
+6.1. **Prohibited Actions**:
+
+- You **may not** modify, reverse engineer, decompile, or disassemble StateZero
+- You **may not** remove, alter, or obscure any **proprietary notices, branding, or license enforcement mechanisms**
+- You **may not** sublicense, resell, or distribute StateZero to any third party **without explicit written permission**
+- You **may not** use StateZero for any illegal, unlawful, or criminal activities under the laws of Singapore or under the laws of the jurisdiction where you are located or operating
+- You **may not** use StateZero to develop or offer **a competing product or service**
+- You **may not** use StateZero to create a cloud-hosted version of our service (similar to services like Heroku, Netlify, AWS, etc.)
+- You **may not** use StateZero for LLM training without the separate license outlined in Section 5
+
+## **7. Payment Terms**
+
+7.1. **Payment Obligations**: Companies exceeding the free tier revenue threshold must pay the applicable monthly fee as outlined in Section 3.
+
+7.2. **Revenue Tier Reporting**: You are responsible for accurately reporting your revenue tier and upgrading to the appropriate pricing tier when revenue thresholds are exceeded.
+
+7.3. **Rate Lock Process**: To lock in current pricing for all tiers, contact us at **robert@statezero.dev**.
+
+## **8. Disclaimer of Warranty**
+
+8.1. **AS-IS Basis**: StateZero is provided **"AS IS"**, without warranties or guarantees of any kind.
+8.2. The Licensor **expressly disclaims** all implied warranties, including but not limited to **merchantability, fitness for a particular purpose, or non-infringement**.
+
+## **9. Limitation of Liability**
+
+9.1. **No Liability for Damages**: To the **maximum extent permitted by law**, the Licensor **shall not** be liable for any damages resulting from the use or inability to use StateZero, including:
+
+- Loss of revenue, data, or business opportunities
+- Incidental, consequential, punitive, or special damages, even if advised of the possibility
+
+## **10. Termination**
+
+10.1. **License Irrevocability**: Under the no-rugpull guarantee, **we cannot terminate your license to use StateZero** as long as you:
+
+- Pay the applicable monthly fee (if any), OR
+- We have asked you not to pay the fee (as outlined in Section 2.1)
+- AND you comply with the restrictions in Section 6 (primarily not building a competing product)
+
+  10.2. **Limited Termination Rights**: The Licensor may only terminate this License for material violations of Section 6 (Restrictions), and only after providing 30 days written notice and opportunity to cure such violations.
+
+  10.3. **Upon Valid Termination**: Only in cases of valid termination under Section 10.2, you must **uninstall StateZero** and delete all copies in your possession.
+
+  10.4. **No-Rugpull Protection**: Your license to use StateZero is **irrevocable** under normal circumstances. Even if we no longer wish to be associated with your use case, we will simply ask you to stop paying fees, but your license remains valid and enforceable.
+
+## **11. Governing Law**
+
+11.1. This License shall be governed by and construed in accordance with the **laws of Singapore**, without regard to conflict of law principles.
+
+## **12. Contact Information**
+
+12.1. For general inquiries and rate lock requests, contact **Airhome Sp Zoo** at **robert@statezero.dev**.
+12.2. For LLM training license inquiries, contact **Airhome Sp Zoo** at **robert@statezero.dev**.
+
+---
+
+**By downloading, installing, or using StateZero, you acknowledge that you have read, understood, and agree to be bound by the terms of this License Agreement.**

statezero-0.1.0b1/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "statezero"
+version = "0.1.0b1"
+description = "A short description of your package"
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [
+    { name = "Robert Herring", email = "robert.herring@statezero.dev" }
+]
+requires-python = ">=3.10"
+dynamic = ["dependencies"]
+
+[project.urls]
+homepage = "https://www.statezero.dev"
+repository = "https://github.com/state-zero/statezero"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["statezero", "statezero.*"]
+
+[tool.setuptools.dynamic]
+dependencies = {file = ["requirements.txt"]}

statezero-0.1.0b1/requirements.txt

@@ -0,0 +1,18 @@
+Django>=5.1.0,<5.2.0
+django-money>=3.4.0,<3.5.0
+djangorestframework>=3.15.0,<3.16.0
+fakeredis>=2.27.0,<3.0.0
+fastapi>=0.115.0,<0.116.0
+hypothesis>=6.108.0,<7.0.0
+jsonschema>=4.23.0,<5.0.0
+networkx>=3.4.0,<4.0.0
+openapi-spec-validator>=0.7.0,<0.8.0
+orjson>=3.10.0,<4.0.0
+pusher>=3.3.0,<4.0.0
+pydantic>=2.10.0,<3.0.0
+rich>=13.9.0,<14.0.0
+psycopg2>=2.9.0,<3.0.0
+django-redis>=5.4.0,<6.0.0
+django-cors-headers>=4.7.0,<5.0.0
+django-zen-queries>=2.1.0,<3.0.0
+cytoolz>=1.0.0,<2.0.0

statezero-0.1.0b1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+