@famgia/omnify-laravel 0.0.105 → 0.0.107

package/dist/index.d.cts

@@ -198,6 +198,77 @@ declare function formatForeignKey(fk: ForeignKeyDefinition): string;
  * Formats an index to PHP code.
  */
 declare function formatIndex(index: IndexDefinition): string;
+/**
+ * Pivot field definition (simplified from PropertyDefinition for pivot tables).
+ */
+interface PivotFieldInfo {
+    /** Field name in snake_case */
+    name: string;
+    /** Property type (String, Int, Boolean, Timestamp, etc.) */
+    type: string;
+    /** Whether the field can be null */
+    nullable?: boolean;
+    /** Default value for the field */
+    default?: unknown;
+    /** String length (for String type) */
+    length?: number;
+    /** Whether the field is unsigned (for numeric types) */
+    unsigned?: boolean;
+}
+/**
+ * Pivot table information for ManyToMany relationships.
+ */
+interface PivotTableInfo {
+    tableName: string;
+    sourceTable: string;
+    targetTable: string;
+    sourceColumn: string;
+    targetColumn: string;
+    sourcePkType: 'Int' | 'BigInt' | 'Uuid' | 'String';
+    targetPkType: 'Int' | 'BigInt' | 'Uuid' | 'String';
+    onDelete: string | undefined;
+    onUpdate: string | undefined;
+    /** Additional fields on the pivot table */
+    pivotFields?: PivotFieldInfo[];
+}
+/**
+ * Polymorphic pivot table information for MorphToMany relationships.
+ */
+interface MorphToManyPivotInfo {
+    tableName: string;
+    /** The fixed target schema that uses MorphToMany */
+    targetTable: string;
+    targetColumn: string;
+    targetPkType: 'Int' | 'BigInt' | 'Uuid' | 'String';
+    /** Base name for polymorphic columns (creates {name}_type and {name}_id) */
+    morphName: string;
+    /** Schema names that can be morphed to */
+    morphTargets: readonly string[];
+    onDelete: string | undefined;
+    onUpdate: string | undefined;
+}
+/**
+ * Generates pivot table name for ManyToMany relationship.
+ * Uses alphabetical ordering for consistency.
+ */
+declare function generatePivotTableName(sourceTable: string, targetTable: string, customName?: string): string;
+/**
+ * Extracts ManyToMany relationships from a schema.
+ */
+declare function extractManyToManyRelations(schema: LoadedSchema, allSchemas: SchemaCollection): PivotTableInfo[];
+/**
+ * Generates blueprint for a pivot table.
+ */
+declare function generatePivotTableBlueprint(pivot: PivotTableInfo): TableBlueprint;
+/**
+ * Extracts MorphToMany relationships from a schema.
+ * MorphToMany creates a pivot table with polymorphic type/id columns.
+ */
+declare function extractMorphToManyRelations(schema: LoadedSchema, allSchemas: SchemaCollection): MorphToManyPivotInfo[];
+/**
+ * Generates blueprint for a polymorphic pivot table (MorphToMany).
+ */
+declare function generateMorphToManyPivotBlueprint(pivot: MorphToManyPivotInfo): TableBlueprint;
 
 /**
  * @famgia/omnify-laravel - Migration Generator
@@ -429,4 +500,4 @@ declare function generateAIGuides(rootDir: string, options?: AIGuidesOptions): A
  */
 declare function shouldGenerateAIGuides(rootDir: string): boolean;
 
-export { type AIGuidesOptions, type AIGuidesResult, type ColumnMethod, type ColumnModifier, type FactoryGeneratorOptions, type ForeignKeyDefinition, type GeneratedFactory, type GeneratedModel, type IndexDefinition, type MigrationDefinition, type MigrationFile, type MigrationOperation, type MigrationOptions, type ModelGeneratorOptions, type ProviderRegistrationResult, type TableBlueprint, formatColumnMethod, formatForeignKey, formatIndex, formatMigrationFile, generateAIGuides, generateAlterMigration, generateDropMigrationForTable, generateDropTableMigration, generateFactories, generateForeignKey, generateMigrationFromSchema, generateMigrations, generateMigrationsFromChanges, generateModels, generatePrimaryKeyColumn, generateProviderRegistration, generateSoftDeleteColumn, generateTimestampColumns, getFactoryPath, getMigrationPath, getModelPath, propertyToColumnMethod, schemaToBlueprint, shouldGenerateAIGuides, toColumnName, toTableName };
+export { type AIGuidesOptions, type AIGuidesResult, type ColumnMethod, type ColumnModifier, type FactoryGeneratorOptions, type ForeignKeyDefinition, type GeneratedFactory, type GeneratedModel, type IndexDefinition, type MigrationDefinition, type MigrationFile, type MigrationOperation, type MigrationOptions, type ModelGeneratorOptions, type MorphToManyPivotInfo, type PivotFieldInfo, type PivotTableInfo, type ProviderRegistrationResult, type TableBlueprint, extractManyToManyRelations, extractMorphToManyRelations, formatColumnMethod, formatForeignKey, formatIndex, formatMigrationFile, generateAIGuides, generateAlterMigration, generateDropMigrationForTable, generateDropTableMigration, generateFactories, generateForeignKey, generateMigrationFromSchema, generateMigrations, generateMigrationsFromChanges, generateModels, generateMorphToManyPivotBlueprint, generatePivotTableBlueprint, generatePivotTableName, generatePrimaryKeyColumn, generateProviderRegistration, generateSoftDeleteColumn, generateTimestampColumns, getFactoryPath, getMigrationPath, getModelPath, propertyToColumnMethod, schemaToBlueprint, shouldGenerateAIGuides, toColumnName, toTableName };

package/dist/index.d.ts

@@ -198,6 +198,77 @@ declare function formatForeignKey(fk: ForeignKeyDefinition): string;
  * Formats an index to PHP code.
  */
 declare function formatIndex(index: IndexDefinition): string;
+/**
+ * Pivot field definition (simplified from PropertyDefinition for pivot tables).
+ */
+interface PivotFieldInfo {
+    /** Field name in snake_case */
+    name: string;
+    /** Property type (String, Int, Boolean, Timestamp, etc.) */
+    type: string;
+    /** Whether the field can be null */
+    nullable?: boolean;
+    /** Default value for the field */
+    default?: unknown;
+    /** String length (for String type) */
+    length?: number;
+    /** Whether the field is unsigned (for numeric types) */
+    unsigned?: boolean;
+}
+/**
+ * Pivot table information for ManyToMany relationships.
+ */
+interface PivotTableInfo {
+    tableName: string;
+    sourceTable: string;
+    targetTable: string;
+    sourceColumn: string;
+    targetColumn: string;
+    sourcePkType: 'Int' | 'BigInt' | 'Uuid' | 'String';
+    targetPkType: 'Int' | 'BigInt' | 'Uuid' | 'String';
+    onDelete: string | undefined;
+    onUpdate: string | undefined;
+    /** Additional fields on the pivot table */
+    pivotFields?: PivotFieldInfo[];
+}
+/**
+ * Polymorphic pivot table information for MorphToMany relationships.
+ */
+interface MorphToManyPivotInfo {
+    tableName: string;
+    /** The fixed target schema that uses MorphToMany */
+    targetTable: string;
+    targetColumn: string;
+    targetPkType: 'Int' | 'BigInt' | 'Uuid' | 'String';
+    /** Base name for polymorphic columns (creates {name}_type and {name}_id) */
+    morphName: string;
+    /** Schema names that can be morphed to */
+    morphTargets: readonly string[];
+    onDelete: string | undefined;
+    onUpdate: string | undefined;
+}
+/**
+ * Generates pivot table name for ManyToMany relationship.
+ * Uses alphabetical ordering for consistency.
+ */
+declare function generatePivotTableName(sourceTable: string, targetTable: string, customName?: string): string;
+/**
+ * Extracts ManyToMany relationships from a schema.
+ */
+declare function extractManyToManyRelations(schema: LoadedSchema, allSchemas: SchemaCollection): PivotTableInfo[];
+/**
+ * Generates blueprint for a pivot table.
+ */
+declare function generatePivotTableBlueprint(pivot: PivotTableInfo): TableBlueprint;
+/**
+ * Extracts MorphToMany relationships from a schema.
+ * MorphToMany creates a pivot table with polymorphic type/id columns.
+ */
+declare function extractMorphToManyRelations(schema: LoadedSchema, allSchemas: SchemaCollection): MorphToManyPivotInfo[];
+/**
+ * Generates blueprint for a polymorphic pivot table (MorphToMany).
+ */
+declare function generateMorphToManyPivotBlueprint(pivot: MorphToManyPivotInfo): TableBlueprint;
 
 /**
  * @famgia/omnify-laravel - Migration Generator
@@ -429,4 +500,4 @@ declare function generateAIGuides(rootDir: string, options?: AIGuidesOptions): A
  */
 declare function shouldGenerateAIGuides(rootDir: string): boolean;
 
-export { type AIGuidesOptions, type AIGuidesResult, type ColumnMethod, type ColumnModifier, type FactoryGeneratorOptions, type ForeignKeyDefinition, type GeneratedFactory, type GeneratedModel, type IndexDefinition, type MigrationDefinition, type MigrationFile, type MigrationOperation, type MigrationOptions, type ModelGeneratorOptions, type ProviderRegistrationResult, type TableBlueprint, formatColumnMethod, formatForeignKey, formatIndex, formatMigrationFile, generateAIGuides, generateAlterMigration, generateDropMigrationForTable, generateDropTableMigration, generateFactories, generateForeignKey, generateMigrationFromSchema, generateMigrations, generateMigrationsFromChanges, generateModels, generatePrimaryKeyColumn, generateProviderRegistration, generateSoftDeleteColumn, generateTimestampColumns, getFactoryPath, getMigrationPath, getModelPath, propertyToColumnMethod, schemaToBlueprint, shouldGenerateAIGuides, toColumnName, toTableName };
+export { type AIGuidesOptions, type AIGuidesResult, type ColumnMethod, type ColumnModifier, type FactoryGeneratorOptions, type ForeignKeyDefinition, type GeneratedFactory, type GeneratedModel, type IndexDefinition, type MigrationDefinition, type MigrationFile, type MigrationOperation, type MigrationOptions, type ModelGeneratorOptions, type MorphToManyPivotInfo, type PivotFieldInfo, type PivotTableInfo, type ProviderRegistrationResult, type TableBlueprint, extractManyToManyRelations, extractMorphToManyRelations, formatColumnMethod, formatForeignKey, formatIndex, formatMigrationFile, generateAIGuides, generateAlterMigration, generateDropMigrationForTable, generateDropTableMigration, generateFactories, generateForeignKey, generateMigrationFromSchema, generateMigrations, generateMigrationsFromChanges, generateModels, generateMorphToManyPivotBlueprint, generatePivotTableBlueprint, generatePivotTableName, generatePrimaryKeyColumn, generateProviderRegistration, generateSoftDeleteColumn, generateTimestampColumns, getFactoryPath, getMigrationPath, getModelPath, propertyToColumnMethod, schemaToBlueprint, shouldGenerateAIGuides, toColumnName, toTableName };

package/dist/index.js

@@ -1,4 +1,6 @@
 import {
+  extractManyToManyRelations,
+  extractMorphToManyRelations,
   formatColumnMethod,
   formatForeignKey,
   formatIndex,
@@ -13,6 +15,9 @@ import {
   generateMigrations,
   generateMigrationsFromChanges,
   generateModels,
+  generateMorphToManyPivotBlueprint,
+  generatePivotTableBlueprint,
+  generatePivotTableName,
   generatePrimaryKeyColumn,
   generateProviderRegistration,
   generateSoftDeleteColumn,
@@ -26,8 +31,10 @@ import {
   shouldGenerateAIGuides,
   toColumnName,
   toTableName
-} from "./chunk-XR2DTIIS.js";
+} from "./chunk-7YHLXBF5.js";
 export {
+  extractManyToManyRelations,
+  extractMorphToManyRelations,
   formatColumnMethod,
   formatForeignKey,
   formatIndex,
@@ -42,6 +49,9 @@ export {
   generateMigrations,
   generateMigrationsFromChanges,
   generateModels,
+  generateMorphToManyPivotBlueprint,
+  generatePivotTableBlueprint,
+  generatePivotTableName,
   generatePrimaryKeyColumn,
   generateProviderRegistration,
   generateSoftDeleteColumn,

package/dist/plugin.cjs

@@ -581,6 +581,9 @@ function extractManyToManyRelations(schema, allSchemas) {
     if (assocProp.relation !== "ManyToMany") {
       continue;
     }
+    if (assocProp.mappedBy) {
+      continue;
+    }
     const targetName = assocProp.target;
     if (!targetName) {
       continue;
@@ -595,6 +598,19 @@ function extractManyToManyRelations(schema, allSchemas) {
     const pivotTableName = generatePivotTableName(sourceTable, targetTable, assocProp.joinTable);
     const sourceColumn = sourceTable.replace(/ies$/, "y").replace(/s$/, "") + "_id";
     const targetColumn = targetTable.replace(/ies$/, "y").replace(/s$/, "") + "_id";
+    const pivotFields = [];
+    if (assocProp.pivotFields) {
+      for (const [fieldName, fieldDef] of Object.entries(assocProp.pivotFields)) {
+        pivotFields.push({
+          name: toColumnName(fieldName),
+          type: fieldDef.type,
+          nullable: fieldDef.nullable,
+          default: fieldDef.default,
+          length: fieldDef.length,
+          unsigned: fieldDef.unsigned
+        });
+      }
+    }
     pivotTables.push({
       tableName: pivotTableName,
       sourceTable,
@@ -604,11 +620,35 @@ function extractManyToManyRelations(schema, allSchemas) {
       sourcePkType,
       targetPkType,
       onDelete: assocProp.onDelete,
-      onUpdate: assocProp.onUpdate
+      onUpdate: assocProp.onUpdate,
+      pivotFields: pivotFields.length > 0 ? pivotFields : void 0
     });
   }
   return pivotTables;
 }
+function pivotFieldToColumn(field) {
+  const method = TYPE_METHOD_MAP[field.type] ?? "string";
+  const args = [field.name];
+  const modifiers = [];
+  if (method === "string" && field.length) {
+    args.push(field.length);
+  }
+  if (field.nullable) {
+    modifiers.push({ method: "nullable" });
+  }
+  if (field.default !== void 0 && field.default !== null) {
+    modifiers.push({ method: "default", args: [field.default] });
+  }
+  if (field.unsigned && (method === "tinyInteger" || method === "integer" || method === "bigInteger")) {
+    modifiers.push({ method: "unsigned" });
+  }
+  return {
+    name: field.name,
+    method,
+    args,
+    modifiers
+  };
+}
 function generatePivotTableBlueprint(pivot) {
   const columns = [];
   const foreignKeys = [];
@@ -637,6 +677,11 @@ function generatePivotTableBlueprint(pivot) {
     args: [pivot.targetColumn],
     modifiers: []
   });
+  if (pivot.pivotFields && pivot.pivotFields.length > 0) {
+    for (const field of pivot.pivotFields) {
+      columns.push(pivotFieldToColumn(field));
+    }
+  }
   columns.push(...generateTimestampColumns());
   foreignKeys.push({
     columns: [pivot.sourceColumn],
@@ -1575,12 +1620,30 @@ function generateRelation(propName, assoc, schema, schemas, options) {
     }
     case "ManyToMany": {
       const pivotTable = assoc.joinTable ?? `${toSnakeCase(propName)}_pivot`;
+      let pivotFieldNames = [];
+      if (assoc.pivotFields && Object.keys(assoc.pivotFields).length > 0) {
+        pivotFieldNames = Object.keys(assoc.pivotFields).map((f) => toSnakeCase(f));
+      } else if (assoc.mappedBy && assoc.target) {
+        const targetSchema = schemas[assoc.target];
+        if (targetSchema?.properties) {
+          const owningProp = targetSchema.properties[assoc.mappedBy];
+          if (owningProp?.type === "Association") {
+            const owningAssoc = owningProp;
+            if (owningAssoc.pivotFields && Object.keys(owningAssoc.pivotFields).length > 0) {
+              pivotFieldNames = Object.keys(owningAssoc.pivotFields).map((f) => toSnakeCase(f));
+            }
+          }
+        }
+      }
+      const pivotFieldsCode = pivotFieldNames.length > 0 ? pivotFieldNames.map((f) => `'${f}'`).join(", ") : null;
+      const withPivotLine = pivotFieldsCode ? `
+            ->withPivot(${pivotFieldsCode})` : "";
       return `    /**
      * The ${propName} that belong to this model.
      */
     public function ${methodName}(): BelongsToMany
     {
-        return $this->belongsToMany(${targetClass}::class, '${pivotTable}')
+        return $this->belongsToMany(${targetClass}::class, '${pivotTable}')${withPivotLine}
             ->withTimestamps();
     }`;
     }