@famgia/omnify 1.0.106 → 1.0.108

package/ai-guides/schema-guide.md

@@ -526,11 +526,75 @@ tags:
   type: Association
   relation: ManyToMany
   target: Tag
-  pivotTable: post_tags    # Optional: custom pivot table name
+  joinTable: post_tags     # Optional: custom pivot table name
+  owning: true             # Optional: marks this as the owning side
   pivotFields:             # Optional: extra pivot fields
-    - name: order
+    order:
       type: Int
       default: 0
+    assigned_at:
+      type: Timestamp
+      nullable: true
+```
+
+**Pivot Fields** - Additional columns on the pivot table:
+```yaml
+# Organization.yaml - Owning side with pivotFields
+users:
+  type: Association
+  relation: ManyToMany
+  target: User
+  joinTable: organization_user
+  owning: true
+  pivotFields:
+    org_role:
+      type: String
+      length: 50
+      default: "'member'"    # String default needs quotes
+    is_default:
+      type: Boolean
+      default: false
+    joined_at:
+      type: Timestamp
+      nullable: true
+    invited_by:
+      type: BigInt
+      nullable: true
+      unsigned: true
+
+# User.yaml - Inverse side with mappedBy
+organizations:
+  type: Association
+  relation: ManyToMany
+  target: Organization
+  joinTable: organization_user
+  mappedBy: users          # References the owning side property
+```
+
+**Generated Migration:**
+```php
+Schema::create('organization_user', function (Blueprint $table) {
+    $table->unsignedBigInteger('organization_id');
+    $table->unsignedBigInteger('user_id');
+    $table->string('org_role', 50)->default('member');
+    $table->boolean('is_default')->default(false);
+    $table->timestamp('joined_at')->nullable();
+    $table->bigInteger('invited_by')->nullable()->unsigned();
+    $table->timestamp('created_at')->nullable();
+    $table->timestamp('updated_at')->nullable();
+    // ... foreign keys and indexes
+});
+```
+
+**Generated Model:**
+```php
+// Both sides get withPivot() automatically
+public function users(): BelongsToMany
+{
+    return $this->belongsToMany(User::class, 'organization_user')
+        ->withPivot('org_role', 'is_default', 'joined_at', 'invited_by')
+        ->withTimestamps();
+}
 ```
 
 ### OneToOne (1:1)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@famgia/omnify",
-  "version": "1.0.106",
+  "version": "1.0.108",
   "description": "Schema-driven database migration system with TypeScript types and Laravel migrations",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,14 +25,14 @@
     "README.md"
   ],
   "dependencies": {
-    "@famgia/omnify-cli": "0.0.102",
-    "@famgia/omnify-core": "0.0.96",
-    "@famgia/omnify-types": "0.0.94",
-    "@famgia/omnify-typescript": "0.0.84",
-    "@famgia/omnify-mcp": "0.0.82",
-    "@famgia/omnify-atlas": "0.0.90",
-    "@famgia/omnify-japan": "0.0.89",
-    "@famgia/omnify-laravel": "0.0.105"
+    "@famgia/omnify-cli": "0.0.104",
+    "@famgia/omnify-laravel": "0.0.107",
+    "@famgia/omnify-core": "0.0.98",
+    "@famgia/omnify-types": "0.0.96",
+    "@famgia/omnify-atlas": "0.0.92",
+    "@famgia/omnify-mcp": "0.0.84",
+    "@famgia/omnify-typescript": "0.0.86",
+    "@famgia/omnify-japan": "0.0.91"
   },
   "keywords": [
     "omnify",