@jarwizz/create-jarshop 0.1.1

package/dist/template/src/seed.ts

@@ -0,0 +1,138 @@
+import {
+  CurrencyCode,
+  LanguageCode,
+  ProductService,
+  ProductVariantService,
+  RequestContextService,
+  StockLocationService,
+  TaxCategoryService,
+  TaxRateService,
+  ZoneService,
+  ChannelService,
+  bootstrap,
+} from "@vendure/core";
+import { GlobalFlag } from "@vendure/common/lib/generated-types";
+import { config } from "./vendure-config";
+
+const productSlug = "jarshop-demo-product";
+
+async function seed(): Promise<void> {
+  if (!new Set(["dev", "test"]).has(process.env.APP_ENV ?? "")) {
+    throw new Error(
+      "JarShop demo seed is allowed only in APP_ENV=dev or test.",
+    );
+  }
+  const app = await bootstrap(config);
+
+  try {
+    const requestContextService = app.get(RequestContextService);
+    let ctx = await requestContextService.create({ apiType: "admin" });
+    const productService = app.get(ProductService);
+    const variantService = app.get(ProductVariantService);
+    const stockLocationService = app.get(StockLocationService);
+    const zoneService = app.get(ZoneService);
+    const taxCategoryService = app.get(TaxCategoryService);
+    const taxRateService = app.get(TaxRateService);
+    const channelService = app.get(ChannelService);
+    const existing = await productService.findOneBySlug(ctx, productSlug);
+
+    const stockLocation = await stockLocationService.defaultStockLocation(ctx);
+    let channel = await channelService.getDefaultChannel(ctx);
+    const zones = await zoneService.findAll(ctx);
+    const taxZone =
+      zones.items[0] ??
+      (await zoneService.create(ctx, { name: "JarShop default tax zone" }));
+    if (
+      !channel.defaultTaxZone ||
+      channel.defaultCurrencyCode !== CurrencyCode.EUR
+    ) {
+      await channelService.update(ctx, {
+        id: channel.id,
+        defaultTaxZoneId: taxZone.id,
+        defaultCurrencyCode: CurrencyCode.EUR,
+        availableCurrencyCodes: [CurrencyCode.EUR],
+      });
+      channel = await channelService.getDefaultChannel(ctx);
+      ctx = await requestContextService.create({
+        apiType: "admin",
+        channelOrToken: channel.token,
+      });
+    }
+    const taxCategories = await taxCategoryService.findAll(ctx);
+    const taxCategory =
+      taxCategories.items.find((item) => item.isDefault) ??
+      taxCategories.items[0] ??
+      (await taxCategoryService.create(ctx, { name: "JarShop demo tax" }));
+    const taxRates = await taxRateService.findAll(ctx);
+    if (
+      !taxRates.items.some(
+        (rate) =>
+          rate.zoneId === taxZone.id && rate.categoryId === taxCategory.id,
+      )
+    ) {
+      await taxRateService.create(ctx, {
+        zoneId: taxZone.id,
+        categoryId: taxCategory.id,
+        name: "JarShop demo zero tax",
+        value: 0,
+        enabled: true,
+      });
+    }
+    const product =
+      existing ??
+      (await productService.create(ctx, {
+        enabled: true,
+        translations: [
+          {
+            languageCode: LanguageCode.sk,
+            name: "JarShop ukážkový produkt",
+            slug: productSlug,
+            description: "Generický produkt pre overenie JarShop startera.",
+          },
+          {
+            languageCode: LanguageCode.en,
+            name: "JarShop demo product",
+            slug: productSlug,
+            description:
+              "A generic product used to verify the JarShop starter.",
+          },
+        ],
+      }));
+
+    const existingVariants = existing
+      ? await variantService.getVariantsByProductId(ctx, existing.id, {
+          filter: { sku: { eq: "JARSHOP-DEMO-001" } },
+        })
+      : undefined;
+    if (existingVariants?.totalItems) {
+      console.log(`Seed skipped: ${productSlug} already exists`);
+      return;
+    }
+
+    await variantService.create(ctx, [
+      {
+        productId: product.id,
+        sku: "JARSHOP-DEMO-001",
+        enabled: true,
+        trackInventory: GlobalFlag.TRUE,
+        taxCategoryId: taxCategory.id,
+        stockLevels: [{ stockLocationId: stockLocation.id, stockOnHand: 10 }],
+        price: 1990,
+        translations: [
+          { languageCode: LanguageCode.sk, name: "JarShop ukážkový variant" },
+          { languageCode: LanguageCode.en, name: "JarShop demo variant" },
+        ],
+      },
+    ]);
+
+    console.log(`Seeded ${productSlug}`);
+  } finally {
+    await new Promise((resolve) => setTimeout(resolve, 1000));
+    await app.close();
+  }
+}
+
+seed().catch((error: unknown) => {
+  console.error(error);
+  process.exitCode = 1;
+});

package/dist/template/src/vendure-config.ts

@@ -0,0 +1,75 @@
+import {
+  DefaultJobQueuePlugin,
+  DefaultSchedulerPlugin,
+  DefaultSearchPlugin,
+  VendureConfig,
+  dummyPaymentHandler,
+} from "@vendure/core";
+import { AssetServerPlugin } from "@vendure/asset-server-plugin";
+import { DashboardPlugin } from "@vendure/dashboard/plugin";
+import {
+  EmailPlugin,
+  FileBasedTemplateLoader,
+  defaultEmailHandlers,
+} from "@vendure/email-plugin";
+import { GraphiqlPlugin } from "@vendure/graphiql-plugin";
+import "dotenv/config";
+import path from "node:path";
+
+const isDev = process.env.APP_ENV === "dev";
+
+export const config: VendureConfig = {
+  apiOptions: {
+    port: Number(process.env.PORT ?? 3000),
+    adminApiPath: "admin-api",
+    shopApiPath: "shop-api",
+    trustProxy: isDev ? false : 1,
+    ...(isDev ? { adminApiDebug: true, shopApiDebug: true } : {}),
+  },
+  authOptions: {
+    tokenMethod: ["bearer", "cookie"],
+    superadminCredentials: {
+      identifier: process.env.SUPERADMIN_USERNAME ?? "",
+      password: process.env.SUPERADMIN_PASSWORD ?? "",
+    },
+    cookieOptions: { secret: process.env.COOKIE_SECRET ?? "" },
+  },
+  dbConnectionOptions: {
+    type: "postgres",
+    synchronize: false,
+    migrations: [path.join(__dirname, "./migrations/*.+(js|ts)")],
+    logging: false,
+    database: process.env.DB_NAME,
+    schema: process.env.DB_SCHEMA,
+    host: process.env.DB_HOST,
+    port: Number(process.env.DB_PORT),
+    username: process.env.DB_USERNAME,
+    password: process.env.DB_PASSWORD,
+  },
+  paymentOptions: { paymentMethodHandlers: [dummyPaymentHandler] },
+  plugins: [
+    GraphiqlPlugin.init(),
+    AssetServerPlugin.init({
+      route: "assets",
+      assetUploadDir: path.join(__dirname, "../static/assets"),
+    }),
+    DefaultSchedulerPlugin.init(),
+    DefaultJobQueuePlugin.init({ useDatabaseForBuffer: true }),
+    DefaultSearchPlugin.init({ bufferUpdates: false, indexStockStatus: true }),
+    EmailPlugin.init({
+      devMode: true,
+      outputPath: path.join(__dirname, "../static/email/test-emails"),
+      route: "mailbox",
+      handlers: defaultEmailHandlers,
+      templateLoader: new FileBasedTemplateLoader(
+        path.join(__dirname, "../static/email/templates"),
+      ),
+    }),
+    DashboardPlugin.init({
+      route: "dashboard",
+      appDir: isDev
+        ? path.join(__dirname, "../dist/dashboard")
+        : path.join(__dirname, "dashboard"),
+    }),
+  ],
+};

package/dist/template/static/email/templates/email-address-change/body.hbs

@@ -0,0 +1,20 @@
+{{> header title="Verify Your New Email Address" }}
+
+<mj-section background-color="#fafafa">
+    <mj-column>
+        <mj-text color="#525252">
+            We received a request to change your registered email address to this one.
+            Click the button below to verify this address and complete the process:
+        </mj-text>
+
+        <mj-button font-family="Helvetica"
+                   background-color="#f45e43"
+                   color="white"
+                   href="{{ changeEmailAddressUrl }}?token={{ identifierChangeToken }}">
+            Verify Me!
+        </mj-button>
+    </mj-column>
+</mj-section>
+
+
+{{> footer }}

package/dist/template/static/email/templates/email-verification/body.hbs

@@ -0,0 +1,20 @@
+{{> header title="Verify Your Email Address" }}
+
+<mj-section background-color="#fafafa">
+    <mj-column>
+        <mj-text color="#525252">
+            Thank you for creating an account. Click the button below to verify this email address and
+            complete the registration process:
+        </mj-text>
+
+        <mj-button font-family="Helvetica"
+                   background-color="#f45e43"
+                   color="white"
+                   href="{{ verifyEmailAddressUrl }}?token={{ verificationToken }}">
+            Verify Me!
+        </mj-button>
+    </mj-column>
+</mj-section>
+
+
+{{> footer }}

package/dist/template/static/email/templates/order-confirmation/body.hbs

@@ -0,0 +1,133 @@
+{{> header title="Order Receipt" }}
+
+<mj-raw>
+    <style type="text/css">
+    .callout {
+        background-color: #375a67;
+        padding: 15px 0;
+    }
+    .callout-large > div {
+        text-align: center !important;
+        color: #fff !important;
+        font-size: 16px !important;
+        font-weight: bold;
+        padding: 0;
+    }
+    .callout-small > div {
+        text-align: center !important;
+        color: #fff !important;
+        font-size: 14px !important;
+        padding: 0;
+    }
+    ul.address {
+        list-style-type: none;
+        padding: 0;
+    }
+    tr.order-row td {
+        border-bottom: 1px dashed #eee;
+    }
+    tr.order-row td:last-child {
+        text-align: center;
+    }
+    tr.total-row {
+        font-weight: bold;
+    }
+    .bg-off-white {
+        background-color: #f5f5f5;
+    }
+    </style>
+</mj-raw>
+
+<mj-section css-class="bg-off-white">
+    <mj-column>
+        <mj-text>
+            Dear {{ order.customer.firstName }} {{ order.customer.lastName }},
+        </mj-text>
+        <mj-text>
+            Thank you for your order!
+        </mj-text>
+    </mj-column>
+</mj-section>
+
+
+<mj-section css-class="callout">
+    <mj-column>
+        <mj-text css-class="callout-large"><strong>Order Code</strong></mj-text>
+        <mj-text css-class="callout-small">{{ order.code }}</mj-text>
+    </mj-column>
+    <mj-column>
+        <mj-text css-class="callout-large"><strong>Order Date</strong></mj-text>
+        <mj-text css-class="callout-small">{{ formatDate order.orderPlacedAt }}</mj-text>
+    </mj-column>
+    <mj-column>
+        <mj-text css-class="callout-large"><strong>Total Price</strong></mj-text>
+        <mj-text css-class="callout-small">{{ formatMoney order.total order.currencyCode 'en' }}</mj-text>
+    </mj-column>
+</mj-section>
+
+
+<mj-section css-class="bg-off-white">
+    <mj-column>
+        <mj-text>
+            {{#with order.shippingAddress }}
+                <h3>Shipping To: {{ fullName }}</h3>
+                <ul class="address">
+                    {{#if company}}<li>{{ company }}</li>{{/if}}
+                    {{#if streetLine1}}<li>{{ streetLine1 }}</li>{{/if}}
+                    {{#if streetLine2}}<li>{{ streetLine2 }}</li>{{/if}}
+                    {{#if city}}<li>{{ city }}</li>{{/if}}
+                    {{#if province}}<li>{{ province }}</li>{{/if}}
+                    {{#if postalCode}}<li>{{ postalCode }}</li>{{/if}}
+                    {{#if country}}<li>{{ country }}</li>{{/if}}
+                    {{#if phoneNumber}}<li>{{ phoneNumber }}</li>{{/if}}
+                </ul>
+            {{/with}}
+        </mj-text>
+    </mj-column>
+</mj-section>
+
+<mj-section>
+    <mj-column>
+        <mj-text>
+            <h3>Order Summary:</h3>
+        </mj-text>
+        <mj-table cellpadding="6px">
+            {{#each order.lines }}
+                <tr class="order-row">
+                    <td>
+                        <img alt="{{ productVariant.name }}"
+                             style="width: 50px; height: 50px;"
+                             src="{{ featuredAsset.preview }}?w=50&h=50" />
+                    </td>
+                    <td>{{ quantity }} x {{ productVariant.name }}</td>
+                    <td>{{ productVariant.quantity }}</td>
+                    <td>{{ formatMoney discountedLinePriceWithTax ../order.currencyCode 'en' }}</td>
+                </tr>
+            {{/each}}
+            {{#each order.discounts }}
+                <tr class="order-row">
+                    <td colspan="3">
+                        {{ description }}
+                    </td>
+                    <td>{{ formatMoney amount ../order.currencyCode 'en' }}</td>
+                </tr>
+            {{/each}}
+            <tr class="order-row">
+                <td colspan="3">Sub-total:</td>
+                <td>{{ formatMoney order.subTotalWithTax order.currencyCode 'en' }}</td>
+            </tr>
+            {{#each shippingLines }}
+            <tr class="order-row">
+                <td colspan="3">Shipping ({{ shippingMethod.name }}):</td>
+                <td>{{ formatMoney priceWithTax ../order.currencyCode 'en' }}</td>
+            </tr>
+            {{/each}}
+            <tr class="order-row total-row">
+                <td colspan="3">Total:</td>
+                <td>{{ formatMoney order.totalWithTax order.currencyCode 'en' }}</td>
+            </tr>
+        </mj-table>
+    </mj-column>
+</mj-section>
+
+{{> footer }}

package/dist/template/static/email/templates/partials/footer.hbs

@@ -0,0 +1,10 @@
+<!--suppress ALL -->
+<mj-section background-color="#375a67">
+    <mj-column width="100%">
+        <mj-text align="center" color="#eee">
+            <span>[footer text]</span>
+        </mj-text>
+    </mj-column>
+</mj-section>
+</mj-body>
+</mjml>

package/dist/template/static/email/templates/partials/header.hbs

@@ -0,0 +1,18 @@
+<mjml>
+    <mj-head>
+        <mj-title>{{ title }}</mj-title>
+        <mj-style inline="inline">
+            h3 {
+                font-size: 18px;
+                color: #555;
+                font-weight: normal;
+            }
+        </mj-style>
+    </mj-head>
+
+    <mj-body>
+        <mj-section background-color="#f0f0f0">
+            <mj-column>
+                <mj-text>[company header]</mj-text>
+            </mj-column>
+        </mj-section>

package/dist/template/static/email/templates/password-reset/body.hbs

@@ -0,0 +1,24 @@
+{{> header title="Forgotten password reset" }}
+
+<mj-section background-color="#fafafa">
+    <mj-column>
+        <mj-text color="#525252">
+            Someone requested a new password for your account.
+        </mj-text>
+
+        <mj-button font-family="Helvetica"
+                   background-color="#f45e43"
+                   color="white"
+                   href="{{ passwordResetUrl }}?token={{ passwordResetToken }}">
+            Reset password
+        </mj-button>
+
+        <mj-text color="#525252">
+        If you didn't make this request then you can safely ignore this email - nothing has been changed on your account.
+        </mj-text>
+
+    </mj-column>
+</mj-section>
+
+
+{{> footer }}

package/dist/template/storefront/README.md

@@ -0,0 +1,8 @@
+# JarShop storefront tracer
+
+The storefront is a neutral Next.js client project surface. It imports
+commerce operations only from `lib/commerce.ts`, which is the private facade
+over `@jarwizz/commerce-sdk`.
+
+The `/sk` and `/en` routes intentionally render a safe empty state when the
+Shop API is unavailable. A production build must not require a live API.

package/dist/template/storefront/app/[locale]/[slug]/page.tsx

@@ -0,0 +1,52 @@
+import { getProduct } from "../../../lib/commerce";
+
+interface ProductPageProps {
+  params: Promise<{ locale: string; slug: string }>;
+}
+
+const labels = {
+  sk: {
+    back: "Späť",
+    notFound: "Produkt sa nenašiel.",
+    inStock: "Skladom",
+    outOfStock: "Vypredané",
+  },
+  en: {
+    back: "Back",
+    notFound: "Product not found.",
+    inStock: "In stock",
+    outOfStock: "Out of stock",
+  },
+} as const;
+
+export default async function ProductPage({ params }: ProductPageProps) {
+  const { locale, slug } = await params;
+  const language = locale === "en" ? "en" : "sk";
+  const result = await getProduct(slug, language);
+  const copy = labels[language];
+
+  if (!result.ok || !result.data) {
+    return (
+      <main lang={language}>
+        <p>{copy.notFound}</p>
+      </main>
+    );
+  }
+
+  return (
+    <main lang={language}>
+      <a href={`/${language}`}>← {copy.back}</a>
+      <h1>{result.data.name}</h1>
+      <p>{result.data.description}</p>
+      <ul>
+        {result.data.variants.map((variant) => (
+          <li key={variant.id}>
+            {variant.name}: {(variant.price.amount / 100).toFixed(2)}{" "}
+            {variant.price.currencyCode} —{" "}
+            {variant.inStock ? copy.inStock : copy.outOfStock}
+          </li>
+        ))}
+      </ul>
+    </main>
+  );
+}

package/dist/template/storefront/app/[locale]/page.tsx

@@ -0,0 +1,35 @@
+import { getCatalog } from "../../lib/commerce";
+
+interface LocalePageProps {
+  params: Promise<{ locale: string }>;
+}
+
+const labels = {
+  sk: { title: "Produkty", empty: "Produkty sa nepodarilo načítať." },
+  en: { title: "Products", empty: "Products are not available." },
+} as const;
+
+export default async function LocalePage({ params }: LocalePageProps) {
+  const { locale } = await params;
+  const language = locale === "en" ? "en" : "sk";
+  const result = await getCatalog(language);
+  const copy = labels[language];
+
+  return (
+    <main lang={language}>
+      <h1>{copy.title}</h1>
+      {!result.ok || result.data.length === 0 ? (
+        <p>{copy.empty}</p>
+      ) : (
+        <ul>
+          {result.data.map((product) => (
+            <li key={product.id}>
+              <a href={`/${language}/${product.slug}`}>{product.name}</a>
+              <p>{product.description}</p>
+            </li>
+          ))}
+        </ul>
+      )}
+    </main>
+  );
+}

package/dist/template/storefront/app/globals.css

@@ -0,0 +1,16 @@
+:root {
+  color-scheme: light;
+  font-family: system-ui, sans-serif;
+}
+
+body {
+  margin: 0;
+  background: #fff;
+  color: #111;
+}
+
+main {
+  max-width: 72rem;
+  margin: 0 auto;
+  padding: 2rem;
+}

package/dist/template/storefront/eslint.config.mjs

@@ -0,0 +1,9 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTypeScript from "eslint-config-next/typescript";
+
+export default defineConfig([
+  ...nextVitals,
+  ...nextTypeScript,
+  globalIgnores([".next/**", "out/**", "build/**", "next-env.d.ts"]),
+]);

package/dist/template/storefront/lib/commerce.ts

@@ -0,0 +1,35 @@
+import { createCommerceClient } from "@jarwizz/commerce-sdk/server";
+import type {
+  CommerceResult,
+  ProductSummary,
+} from "@jarwizz/commerce-sdk/types";
+
+export type CommerceLocale = "sk" | "en";
+
+function endpointFor(locale: CommerceLocale): string {
+  const endpoint = new URL(
+    process.env.JARSHOP_COMMERCE_ENDPOINT ?? "http://localhost:3000/shop-api",
+  );
+  endpoint.searchParams.set("languageCode", locale);
+  return endpoint.toString();
+}
+
+function client(locale: CommerceLocale) {
+  return createCommerceClient({
+    endpoint: endpointFor(locale),
+    channelToken: process.env.JARSHOP_CHANNEL_TOKEN,
+  });
+}
+
+export function getCatalog(
+  locale: CommerceLocale,
+): Promise<CommerceResult<ProductSummary[]>> {
+  return client(locale).listProducts();
+}
+
+export function getProduct(
+  slug: string,
+  locale: CommerceLocale,
+): Promise<CommerceResult<ProductSummary | null>> {
+  return client(locale).getProductBySlug(slug);
+}

package/dist/template/storefront/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./dist/types/routes.d.ts";
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/dist/template/storefront/next.config.ts

@@ -0,0 +1,14 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  // Vendure's development watcher ignores dist directories. Keeping Next's
+  // generated TypeScript there prevents storefront HMR from restarting the
+  // server and worker.
+  distDir: "dist",
+  output: "standalone",
+  turbopack: {
+    root: import.meta.dirname,
+  },
+};
+
+export default nextConfig;

package/dist/template/storefront/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@jarshop/storefront",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "engines": {
+    "node": ">=24.18.0 <25"
+  },
+  "packageManager": "pnpm@11.18.0",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@jarwizz/commerce-sdk": "0.1.0",
+    "next": "16.2.12",
+    "react": "19.2.8",
+    "react-dom": "19.2.8"
+  },
+  "devDependencies": {
+    "@types/node": "24.13.3",
+    "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3",
+    "eslint": "9.39.5",
+    "eslint-config-next": "16.2.12",
+    "typescript-eslint": "8.65.0",
+    "typescript": "6.0.3"
+  }
+}