@empty-complete-org/medusa-product-attributes 0.14.1 → 1.0.0

package/.medusa/server/src/modules/product-attributes/service.js

@@ -7,11 +7,11 @@ const utils_1 = require("@medusajs/framework/utils");
 const transliteration_1 = require("transliteration");
 const category_custom_attribute_1 = __importDefault(require("./models/category-custom-attribute"));
 const product_custom_attribute_1 = __importDefault(require("./models/product-custom-attribute"));
-const attribute_preset_1 = __importDefault(require("./models/attribute-preset"));
+const attribute_template_1 = __importDefault(require("./models/attribute-template"));
 const models = {
     CategoryCustomAttribute: category_custom_attribute_1.default,
     ProductCustomAttribute: product_custom_attribute_1.default,
-    AttributePreset: attribute_preset_1.default,
+    AttributeTemplate: attribute_template_1.default,
 };
 // @ts-ignore - MedusaService dynamically generates methods based on models
 class CustomAttributeService extends (0, utils_1.MedusaService)(models) {
@@ -20,25 +20,42 @@ class CustomAttributeService extends (0, utils_1.MedusaService)(models) {
         return await this.listCategoryCustomAttributes({
             category_id: categoryId,
             deleted_at: null,
+            is_global: false,
         });
     }
-    async getAttributesByCategoryIds(categoryIds) {
+    async getAttributesByCategoryIds(categoryIds, opts = { includeGlobals: true }) {
+        // Always include global attributes (applies to every product) unless disabled
+        let globalsMapped = [];
+        if (opts.includeGlobals) {
+            // @ts-ignore - method generated by MedusaService
+            const globals = await this.listCategoryCustomAttributes({
+                is_global: true,
+                deleted_at: null,
+            });
+            globalsMapped = globals.map((attr) => ({
+                ...attr,
+                inherited: true,
+                source_category_id: null,
+                source: "global",
+            }));
+        }
         if (!categoryIds || categoryIds.length === 0) {
-            return [];
+            return globalsMapped;
         }
         // @ts-ignore - method generated by MedusaService
         const attributes = await this.listCategoryCustomAttributes({
             category_id: categoryIds,
+            is_global: false,
             deleted_at: null,
         });
-        // First id in the list is the leaf category — its attributes are "own",
-        // everything else is inherited from an ancestor.
         const leafId = categoryIds[0];
-        return attributes.map((attr) => ({
+        const categoryMapped = attributes.map((attr) => ({
             ...attr,
             inherited: attr.category_id !== leafId,
             source_category_id: attr.category_id,
+            source: "category",
         }));
+        return [...globalsMapped, ...categoryMapped];
     }
     async createCategoryAttribute(data) {
         const key = this.generateKey(data.label);
@@ -47,7 +64,9 @@ class CustomAttributeService extends (0, utils_1.MedusaService)(models) {
             ...data,
             key,
             unit: data.unit ?? null,
+            category_id: data.category_id ?? null,
             is_standard: data.is_standard ?? false,
+            is_global: data.is_global ?? false,
             sort_order: data.sort_order ?? 0,
         });
     }
@@ -59,6 +78,13 @@ class CustomAttributeService extends (0, utils_1.MedusaService)(models) {
         // @ts-ignore - method generated by MedusaService
         return await this.updateCategoryCustomAttributes([{ id, ...updateData }]);
     }
+    async listGlobalAttributes() {
+        // @ts-ignore - generated
+        return await this.listCategoryCustomAttributes({
+            is_global: true,
+            deleted_at: null,
+        });
+    }
     async createProductAttribute(data) {
         // @ts-ignore - method generated by MedusaService
         return await this.createProductCustomAttributes(data);
@@ -76,14 +102,14 @@ class CustomAttributeService extends (0, utils_1.MedusaService)(models) {
             relations: ["category_custom_attribute"],
         });
     }
-    async listPresets() {
+    async listTemplates() {
         // @ts-ignore - generated
-        return await this.listAttributePresets({ deleted_at: null });
+        return await this.listAttributeTemplates({ deleted_at: null });
     }
-    async createPreset(data) {
+    async createTemplate(data) {
         const key = this.generateKey(data.label);
         // @ts-ignore - generated
-        return await this.createAttributePresets({
+        return await this.createAttributeTemplates({
             label: data.label,
             key,
             type: data.type || "text",
@@ -91,21 +117,21 @@ class CustomAttributeService extends (0, utils_1.MedusaService)(models) {
             description: data.description ?? null,
         });
     }
-    async updatePreset(id, data) {
+    async updateTemplate(id, data) {
         const updateData = { ...data };
         if (data.label) {
             updateData.key = this.generateKey(data.label);
         }
         // @ts-ignore - generated
-        return await this.updateAttributePresets([{ id, ...updateData }]);
+        return await this.updateAttributeTemplates([{ id, ...updateData }]);
     }
-    async applyPresetToCategory(presetId, categoryId) {
+    async applyTemplateToCategory(templateId, categoryId) {
         // @ts-ignore - generated
-        const preset = await this.retrieveAttributePreset(presetId);
+        const template = await this.retrieveAttributeTemplate(templateId);
         return await this.createCategoryAttribute({
-            label: preset.label,
-            type: preset.type,
-            unit: preset.unit,
+            label: template.label,
+            type: template.type,
+            unit: template.unit,
             category_id: categoryId,
             is_standard: true,
         });

package/.medusa/server/src/modules/product-attributes/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../../../src/modules/product-attributes/service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../../../src/modules/product-attributes/service.ts"],"names":[],"mappings":"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"}

package/README.md

@@ -1,367 +1,151 @@
 <div align="center">
-  <img src="https://raw.githubusercontent.com/empty-complete/medusa-product-attributes/main/assets/logo_medusa-custom-attributes.png" alt="logo medusa product attributes module repo" width="120">
-  <h1>Product Attributes Module for Medusa v2</h1>
-  <p><i>Extend your store's capabilities with a flexible attribute system for products and categories</i></p>
-  
+  <img src="./assets/logo.png" alt="medusa-product-attributes logo" width="120">
+  <h1>Medusa Product Attributes</h1>
+  <p><i>A flexible attribute system for Medusa v2 — text, number, file, boolean, with units and category inheritance</i></p>
+
   <p>
     <a href="https://github.com/empty-complete/medusa-product-attributes/blob/main/LICENSE">
-      <img src="https://img.shields.io/github/license/empty-complete/medusa-product-attributes" alt="License">
+      <img src="https://img.shields.io/npm/l/@empty-complete-org/medusa-product-attributes" alt="License">
+    </a>
+    <a href="https://www.npmjs.com/package/@empty-complete-org/medusa-product-attributes">
+      <img src="https://img.shields.io/npm/v/@empty-complete-org/medusa-product-attributes" alt="npm version">
     </a>
-    <a href="https://www.npmjs.com/package/@empty-complete/medusa-product-attributes">
-      <img src="https://img.shields.io/npm/v/@empty-complete/medusa-product-attributes" alt="npm version">
+    <a href="https://www.npmjs.com/package/@empty-complete-org/medusa-product-attributes">
+      <img src="https://img.shields.io/npm/dm/@empty-complete-org/medusa-product-attributes" alt="npm downloads">
     </a>
     <a href="https://github.com/empty-complete/medusa-product-attributes/actions/workflows/ci.yml">
       <img src="https://github.com/empty-complete/medusa-product-attributes/actions/workflows/ci.yml/badge.svg" alt="CI Status">
     </a>
-    <a href="https://github.com/empty-complete/medusa-product-attributes/commits/main">
-      <img src="https://img.shields.io/github/commit-activity/m/empty-complete/medusa-product-attributes" alt="GitHub commit activity">
-    </a>
-    <a href="https://www.npmjs.com/package/@empty-complete/medusa-product-attributes">
-      <img src="https://img.shields.io/npm/dm/@empty-complete/medusa-product-attributes" alt="npm downloads">
-    </a>
-  </p>
-  
-  <p>
-    <a href="https://medusajs.com/">
-      <img src="https://img.shields.io/badge/Medusa-v2-000000" alt="Medusa v2">
-    </a>
-    <a href="https://www.typescriptlang.org/">
-      <img src="https://img.shields.io/badge/TypeScript-5.0+-3178C6" alt="TypeScript">
-    </a>
-    <a href="https://nodejs.org/">
-      <img src="https://img.shields.io/badge/Node.js-%3E=20-339933" alt="Node.js">
-    </a>
   </p>
-  
+
   <p>
-    <a href="https://t.me/kinesis_lab">
-      <img src="https://img.shields.io/badge/Telegram-follow-229ED9?logo=telegram" alt="Telegram">
-    </a>
+    <a href="https://medusajs.com/"><img src="https://img.shields.io/badge/Medusa-v2-000000" alt="Medusa v2"></a>
+    <a href="https://www.typescriptlang.org/"><img src="https://img.shields.io/badge/TypeScript-5.0+-3178C6" alt="TypeScript"></a>
+    <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node.js-%3E=20-339933" alt="Node.js"></a>
   </p>
+
+  <p><a href="./README.ru.md">Русская версия</a></p>
 </div>
 
 ---
 
-## ✨ Features
+## Features
 
-| Feature | Description |
-|---------|----------|
-| 📝 **Text Attributes** | Arbitrary text values for products |
-| 🔢 **Numeric Attributes** | Numbers with support for units (kg, m, pcs) |
-| 📎 **File Attributes** | File uploads: certificates, 3D models, manuals |
-| 🏷️ **Standard Keys** | Pre-defined attributes: `certificates`, `3dmodel`, `manual` |
-| 📂 **Category Templates** | Attribute inheritance from category to products |
-| 🗑️ **Soft Delete** | Safe deletion with recovery capability |
+- **4 attribute types**: text, number (with units), file, boolean
+- **Category inheritance**: attributes defined on a parent category are automatically inherited by all subcategories
+- **Global attributes**: applied to every product in the store
+- **Templates**: reusable attribute blueprints — apply to any category in one click
+- **Automatic slug generation**: labels are transliterated (works with Russian, Chinese, any script)
+- **Smart file naming**: uploaded images are renamed to `{product_handle}_{attr_key}.ext`
+- **Admin UI included**: category widget, product widget, two Settings pages
+- **Ships with migrations**: just run `npx medusa db:migrate`
 
----
+## Screenshots
 
-### Requirements
+### Category widget with inheritance
+![Category widget](./assets/category-widget.png)
 
-| Dependency | Version |
-|------------|---------|
-| Medusa | ^2.0.0 |
-| Node.js | >=20 |
-| TypeScript | ^5.0.0 |
+### Product attribute values
+![Product widget](./assets/product-widget.png)
 
----
+### Global attributes settings
+![Global attributes](./assets/global-attributes.png)
 
-## 🚀 Quick Start
+### Attribute templates settings
+![Templates](./assets/templates.png)
 
-### 📦 Installation
+## Installation
 
 ```bash
-# Via npm
-npm install @empty-complete/medusa-product-attributes
-
-# Via pnpm
-pnpm add @empty-complete/medusa-product-attributes
-
-# Via yarn
-yarn add @empty-complete/medusa-product-attributes
-
-# Via GitHub Packages (requires authentication)
-npm install @empty-complete/medusa-product-attributes --registry=https://npm.pkg.github.com
+pnpm add @empty-complete-org/medusa-product-attributes
+# or
+npm install @empty-complete-org/medusa-product-attributes
+# or
+yarn add @empty-complete-org/medusa-product-attributes
 ```
 
-### 1. Add the module to configuration
-
-```typescript
-// medusa-config.ts
-import { defineConfig } from '@medusajs/framework/utils'
+Add to `medusa-config.ts`:
 
-export default defineConfig({
-  modules: [
+```ts
+module.exports = defineConfig({
+  plugins: [
     {
-      resolve: '@empty-complete/medusa-product-attributes',
+      resolve: "@empty-complete-org/medusa-product-attributes",
+      options: {},
     },
   ],
 })
 ```
 
-### 2. Run migrations
+Run migrations:
 
 ```bash
-pnpm medusa db:migrate
-```
-
-### 3. Done!
-
-The module will automatically create the necessary tables and register services.
-
----
-
-## 💡 Usage
-
-### Creating a category attribute
-
-```typescript
-import { CUSTOM_ATTRIBUTE_MODULE } from '@empty-complete/medusa-product-attributes'
-
-const module = container.resolve(CUSTOM_ATTRIBUTE_MODULE)
-
-// Create a "Weight" attribute with unit
-await module.createCategoryAttribute({
-  label: 'Weight',
-  type: 'number',
-  unit: 'kg',
-  category_id: 'pcat_123',
-  sort_order: 0,
-})
-
-// Create a 3D model attribute
-await module.createCategoryAttribute({
-  label: '3D Model',
-  type: 'file',
-  category_id: 'pcat_123',
-  is_standard: true,
-})
-```
-
-### Adding attributes to a product
-
-```typescript
-// Get the attribute template
-const attributes = await module.getCategoryAttributes('pcat_123')
-
-// Add values to the product
-await module.createProductAttribute({
-  product_id: 'prod_456',
-  category_custom_attribute_id: attributes[0].id,
-  value_numeric: 5.5,
-})
-```
-
-### Getting product attributes
-
-```typescript
-const productAttributes = await module.getProductAttributes('prod_456')
-
-console.log(productAttributes)
-// [
-//   {
-//     id: 'pat_...',
-//     value: 'Premium quality',
-//     value_numeric: 5.5,
-//     value_file: null,
-//     category_custom_attribute: {
-//       label: 'Weight',
-//       unit: 'kg',
-//       type: 'number'
-//     }
-//   }
-// ]
-```
-
----
-
-## 📚 API Reference
-
-### CategoryCustomAttribute
-
-| Method | Description | Parameters |
-|--------|-------------|------------|
-| `getCategoryAttributes(categoryId)` | Get all category attributes | `categoryId: string` |
-| `createCategoryAttribute(data)` | Create a new attribute | See below |
-| `updateCategoryAttribute(id, data)` | Update an attribute | `id: string`, `data: Partial<Attribute>` |
-
-#### createCategoryAttribute
-
-```typescript
-{
-  label: string           // Display name
-  type: 'text' | 'number' | 'file' | 'boolean'
-  unit?: string | null    // Unit of measurement (optional)
-  category_id: string     // Category ID
-  is_standard?: boolean   // Standard attribute flag
-  sort_order?: number     // Sort order
-}
-```
-
-### ProductCustomAttribute
-
-| Method | Description | Parameters |
-|--------|-------------|------------|
-| `getProductAttributes(productId)` | Get product attributes | `productId: string` |
-| `createProductAttribute(data)` | Create attribute value | See below |
-| `updateProductAttribute(id, data)` | Update value | `id: string`, `data: Partial<Value>` |
-
-#### createProductAttribute
-
-```typescript
-{
-  product_id: string
-  category_custom_attribute_id: string
-  value?: string
-  value_numeric?: number | null
-  value_file?: string | null
-}
+npx medusa db:migrate
 ```
 
----
-
-## 🗄️ Data Structure
-
-### CategoryCustomAttribute
-
-```
-┌─────────────────────────────────────────┐
-│ CategoryCustomAttribute                 │
-├─────────────────────────────────────────┤
-│ id: string (PK)                         │
-│ key: string                             │
-│ label: string                           │
-│ type: 'text' | 'number' | 'file'        │
-│ unit: string | null                     │
-│ sort_order: number                      │
-│ is_standard: boolean                    │
-│ category_id: string                     │
-│ created_at: timestamp                   │
-│ updated_at: timestamp                   │
-│ deleted_at: timestamp | null            │
-└─────────────────────────────────────────┘
-```
+## Usage
 
-### ProductCustomAttribute
+### Admin
 
-```
-┌─────────────────────────────────────────┐
-│ ProductCustomAttribute                  │
-├─────────────────────────────────────────┤
-│ id: string (PK)                         │
-│ product_id: string                      │
-│ value: string | null                    │
-│ value_numeric: number | null            │
-│ value_file: string | null               │
-│ category_custom_attribute_id: FK        │
-│ created_at: timestamp                   │
-│ updated_at: timestamp                   │
-│ deleted_at: timestamp | null            │
-└─────────────────────────────────────────┘
-```
+1. **Category attributes** — open any category in admin, the "Атрибуты" widget appears below the details. Add custom attributes (inherited by all subcategories), or pick one from a template.
+2. **Global attributes** — Settings → *Global Attributes*. Applied to every product automatically.
+3. **Templates** — Settings → *Attribute Templates*. Create reusable blueprints.
+4. **Product values** — open any product, the "Характеристики" widget shows all inherited + global attributes with inputs for their values.
 
----
+### API
 
-## 📝 Examples
+```ts
+// List all attributes for a product (globals + category chain)
+GET /admin/product/:productId/attribute-schema
 
-### Example 1: Creating attributes for electronics
+// List/create/update attributes for a category
+GET    /admin/category/:categoryId/custom-attributes
+POST   /admin/category/:categoryId/custom-attributes
+PATCH  /admin/category/:categoryId/custom-attributes
 
-```typescript
-// Attributes for "Smartphones" category
-await module.createCategoryAttribute({
-  label: 'Screen Size',
-  type: 'number',
-  unit: 'inch',
-  category_id: 'pcat_phones',
-  sort_order: 1,
-})
+// Global attributes
+GET    /admin/global-attributes
+POST   /admin/global-attributes
+PATCH  /admin/global-attributes
 
-await module.createCategoryAttribute({
-  label: 'Storage Capacity',
-  type: 'number',
-  unit: 'GB',
-  category_id: 'pcat_phones',
-  sort_order: 2,
-})
+// Templates
+GET    /admin/attribute-templates
+POST   /admin/attribute-templates
+PATCH  /admin/attribute-templates
+POST   /admin/attribute-templates/:id/apply  { category_id }
 
-await module.createCategoryAttribute({
-  label: 'Certificate',
-  type: 'file',
-  category_id: 'pcat_phones',
-  is_standard: true,
-  sort_order: 3,
-})
+// Product values
+GET    /admin/product/:productId/custom-attributes
+POST   /admin/product/:productId/custom-attributes
 ```
 
-### Example 2: Adding attribute values to a product
-
-```typescript
-// iPhone 15 Pro
-await module.createProductAttribute({
-  product_id: 'prod_iphone15pro',
-  category_custom_attribute_id: 'attr_screen_size',
-  value_numeric: 6.1,
-})
-
-await module.createProductAttribute({
-  product_id: 'prod_iphone15pro',
-  category_custom_attribute_id: 'attr_storage',
-  value_numeric: 256,
-})
-```
+## Attribute types
 
-### Example 3: Store API — getting attributes for storefront
+| Type | Admin input | Stored in |
+|------|-------------|-----------|
+| `text` | text input | `value` |
+| `number` | number input + unit badge | `value`, `value_numeric` |
+| `file` | upload button | `value` (URL), `value_file` |
+| `boolean` | select Yes/No | `value` |
 
-```typescript
-// GET /store/attribute-values?product_id=prod_iphone15pro
-// Response:
-{
-  "attribute_values": [
-    {
-      "id": "pat_...",
-      "name": "Screen Size",
-      "type": "number",
-      "unit": "inch",
-      "numeric_value": 6.1,
-      "is_standard": false
-    },
-    {
-      "id": "pat_...",
-      "name": "Certificate",
-      "type": "file",
-      "file_value": "/files/cert_iphone15pro.pdf",
-      "is_standard": true
-    }
-  ]
-}
-```
+## Peer dependencies
 
----
+- `@medusajs/framework` ^2.13
+- `@medusajs/medusa` ^2.13
+- `@medusajs/admin-sdk` ^2.13
+- `@medusajs/ui` ^4
+- `@tanstack/react-query` ^5
+- `react` ^18 || ^19
 
-## Project Structure
+## Development
 
-```
-medusa-product-attributes/
-├── src/
-│   ├── models/
-│   │   ├── category-custom-attribute.ts
-│   │   └── product-custom-attribute.ts
-│   ├── index.ts
-│   └── service.ts
-├── assets/
-│   └── *.png
-├── dist/
-├── package.json
-├── tsconfig.json
-├── LICENSE
-└── README.md
+```bash
+pnpm install
+pnpm test
+pnpm run build     # builds to .medusa/server/
+pnpm run dev       # medusa plugin:develop
 ```
 
----
+## License
 
-<div align="center">
-  <h2>🤝 Contributing</h2>
-  <p>Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.</p>
-  <p>
-    <sub>Made with ❤️ for the Medusa community</sub>
-  </p>
-</div>
+MIT © empty-complete