@elizaos/plugin-shopify-ui 2.0.11-beta.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# @elizaos/plugin-shopify-ui
+
+Shopify store management for elizaOS agents. Adds REST API routes and a React dashboard UI covering orders, products, inventory, and customers.
+
+## What it does
+
+- Registers seven HTTP routes under `/api/shopify/*` that proxy to the Shopify Admin GraphQL API.
+- Provides a tabbed React dashboard (standard + XR view) and a terminal-compatible TUI view.
+- Displays store overview, recent orders, low-inventory alerts, product catalog, customer list, and per-location inventory levels.
+- Supports creating new draft products and adjusting inventory quantities directly from the UI.
+
+## Capabilities / routes
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /api/shopify/status` | Check connection; returns shop name, domain, plan, currency |
+| `GET /api/shopify/products` | List products with pagination and search |
+| `POST /api/shopify/products` | Create a draft product |
+| `GET /api/shopify/orders` | List orders filtered by financial status |
+| `GET /api/shopify/inventory` | List inventory levels across all locations |
+| `POST /api/shopify/inventory/:itemId/adjust` | Adjust available quantity for an inventory item |
+| `GET /api/shopify/customers` | List customers with search |
+
+## Required environment variables
+
+| Variable | Description |
+|----------|-------------|
+| `SHOPIFY_STORE_DOMAIN` | Your store domain, e.g. `mystore.myshopify.com` |
+| `SHOPIFY_ACCESS_TOKEN` | Shopify Admin API access token |
+
+Without these, the status endpoint returns `{connected: false}` and all data routes return 404.
+
+## Required Shopify API scopes
+
+`read_products`, `write_products`, `read_orders`, `read_inventory`, `write_inventory`, `read_customers`
+
+## How to enable
+
+Add the plugin to your elizaOS agent configuration:
+
+```ts
+import { shopifyPlugin } from "@elizaos/plugin-shopify-ui/plugin";
+
+// Pass to your agent runtime plugin list
+const agent = new AgentRuntime({
+  plugins: [shopifyPlugin],
+  // ...
+});
+```
+
+The dashboard view appears at path `/shopify` in the elizaOS UI. The TUI view is available at `/shopify/tui` for terminal-based agent surfaces.
+
+## Notes
+
+- The inventory endpoint fetches up to 50 products × 10 variants × 10 locations per query. Large catalogs are truncated at these limits.
+- The Shopify GraphQL API version is `2025-04`.
+- Product pagination uses cursor-chain traversal; prefer the search parameter (`?q=`) for large catalogs to avoid deep page walks.

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@elizaos/plugin-shopify-ui",
+  "version": "2.0.11-beta.7",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "import": "./dist/plugin.js",
+      "default": "./dist/plugin.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
+    }
+  },
+  "dependencies": {
+    "@elizaos/app-core": "2.0.11-beta.7",
+    "@elizaos/core": "2.0.11-beta.7",
+    "@elizaos/ui": "2.0.11-beta.7",
+    "lucide-react": "^1.0.0",
+    "react": "^19.0.0"
+  },
+  "elizaos": {
+    "app": {
+      "heroImage": "assets/hero.png"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "bun run build:js && bun run build:views && bun run build:types",
+    "clean": "rm -rf dist",
+    "test": "vitest run --config vitest.config.ts",
+    "build:js": "tsup --config ../tsup.plugin-packages.shared.ts",
+    "build:views": "bunx --bun vite build --config vite.config.views.ts",
+    "build:types": "tsc --noCheck -p tsconfig.build.json",
+    "test:e2e:manual": "vitest run --config ../../vitest.config.ts test/*.real.e2e.test.ts"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "jsdom": "^29.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.5.1",
+    "vite": "^8.0.0",
+    "vitest": "^4.1.5"
+  },
+  "gitHead": "cdbc876f793d96073d7eb0d09715a031ce0cd32e"
+}