@doswiftly/cli 0.1.1

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@doswiftly/cli",
+  "version": "0.1.1",
+  "description": "DoSwiftly CLI - Scaffold and deploy e-commerce storefronts",
+  "homepage": "https://doswiftly.pl",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "doswiftly": "./bin/doswiftly.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/types.d.ts",
+      "import": "./dist/config/types.js",
+      "default": "./dist/config/types.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist",
+    "prepublishOnly": "pnpm run clean && pnpm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "doswiftly",
+    "cli",
+    "e-commerce",
+    "storefront",
+    "nextjs"
+  ],
+  "author": "DoSwiftly",
+  "license": "MIT",
+  "dependencies": {
+    "@clack/core": "^0.4.1",
+    "@clack/prompts": "^0.10.0",
+    "@inquirer/prompts": "^7.2.0",
+    "axios": "^1.7.7",
+    "chalk": "^5.3.0",
+    "picocolors": "^1.1.1",
+    "chokidar": "^4.0.1",
+    "commander": "^12.1.0",
+    "degit": "^2.8.4",
+    "dotenv": "^16.4.5",
+    "execa": "^9.4.0",
+    "form-data": "^4.0.5",
+    "open": "^10.1.0",
+    "ora": "^8.1.0",
+    "tar": "^7.5.7"
+  },
+  "peerDependencies": {
+    "@opennextjs/cloudflare": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@opennextjs/cloudflare": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/form-data": "^2.5.2",
+    "@types/node": "^22.8.6",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "pnpm": ">=9.0.0"
+  }
+}

package/templates/storefront-minimal/.env.example

@@ -0,0 +1,10 @@
+# DoSwiftly Commerce - Environment Variables
+# Copy this file to .env.local and fill in your values
+
+# API Configuration (required)
+NEXT_PUBLIC_API_URL={{API_URL}}
+NEXT_PUBLIC_SHOP_SLUG={{SHOP_SLUG}}
+
+# Site Configuration (optional)
+NEXT_PUBLIC_SITE_URL=http://localhost:3000
+NEXT_PUBLIC_SITE_NAME={{PROJECT_NAME}}

package/templates/storefront-minimal/.github/workflows/build-template.yml

@@ -0,0 +1,109 @@
+name: Build & Publish Template
+
+on:
+  push:
+    branches: [main, master]
+    tags: ['v*']
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish (e.g., 1.0.0)'
+        required: false
+
+env:
+  # Repository name (e.g., "default1", "minimal", "shadcn")
+  # Worker will be named: storefront-template-{TEMPLATE_NAME}
+  TEMPLATE_NAME: ${{ github.event.repository.name }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Normalize template name
+        id: template
+        run: |
+          # Strip "storefront-" prefix if present
+          RAW_NAME="${{ env.TEMPLATE_NAME }}"
+          NORMALIZED="${RAW_NAME#storefront-}"
+          echo "name=${NORMALIZED}" >> $GITHUB_OUTPUT
+          echo "Template name: ${NORMALIZED}"
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build for Cloudflare (OpenNext)
+        run: npx @opennextjs/cloudflare build
+
+      - name: List build output
+        run: |
+          echo "=== Build output ==="
+          ls -la .open-next/ || echo "No .open-next directory"
+          if [ -f ".open-next/worker.js" ]; then
+            echo "Worker size: $(wc -c < .open-next/worker.js) bytes"
+          fi
+
+      - name: Create deployment wrangler.toml
+        run: |
+          cat > .open-next/wrangler.toml << EOF
+          name = "storefront-template-${{ steps.template.outputs.name }}"
+          main = "worker.js"
+          compatibility_date = "2024-09-23"
+          compatibility_flags = ["nodejs_compat"]
+          assets = { directory = "assets", binding = "ASSETS" }
+          EOF
+
+      - name: Determine version
+        id: version
+        run: |
+          if [ -n "${{ github.event.inputs.version }}" ]; then
+            echo "version=${{ github.event.inputs.version }}" >> $GITHUB_OUTPUT
+          elif [[ "${{ github.ref }}" == refs/tags/v* ]]; then
+            echo "version=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+          else
+            echo "version=$(jq -r .version package.json)-$(git rev-parse --short HEAD)" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Deploy to Cloudflare Workers
+        working-directory: .open-next
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+        run: |
+          if [ -z "$CLOUDFLARE_API_TOKEN" ]; then
+            echo "⏭️ Skipping CF deploy (CLOUDFLARE_API_TOKEN not set)"
+            exit 0
+          fi
+          npx wrangler@latest deploy
+
+      - name: Upload worker bundle artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: worker-bundle
+          path: .open-next/
+          retention-days: 7
+          if-no-files-found: error
+          include-hidden-files: true
+
+      - name: Publish to DoSwiftly (on tag or manual)
+        if: startsWith(github.ref, 'refs/tags/v') || github.event_name == 'workflow_dispatch'
+        env:
+          DOSWIFTLY_TOKEN: ${{ secrets.DOSWIFTLY_DEPLOY_TOKEN }}
+          DOSWIFTLY_API_URL: ${{ secrets.DOSWIFTLY_API_URL }}
+        run: |
+          # Upload bundle to DoSwiftly R2 via API
+          curl -X POST "${DOSWIFTLY_API_URL}/cli/templates/${{ steps.template.outputs.name }}/publish" \
+            -H "Authorization: Bearer ${DOSWIFTLY_TOKEN}" \
+            -F "bundle=@.open-next/worker.js" \
+            -F "version=${{ steps.version.outputs.version }}"

package/templates/storefront-minimal/app/globals.css

@@ -0,0 +1,18 @@
+@import "tailwindcss";
+
+:root {
+  --foreground-rgb: 0, 0, 0;
+  --background-rgb: 255, 255, 255;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --foreground-rgb: 255, 255, 255;
+    --background-rgb: 0, 0, 0;
+  }
+}
+
+body {
+  color: rgb(var(--foreground-rgb));
+  background: rgb(var(--background-rgb));
+}

package/templates/storefront-minimal/app/layout.tsx

@@ -0,0 +1,26 @@
+import type { Metadata } from 'next';
+import { Inter } from 'next/font/google';
+import './globals.css';
+
+const inter = Inter({ subsets: ['latin'] });
+
+const siteName = process.env.NEXT_PUBLIC_SITE_NAME || '{{PROJECT_NAME}}';
+
+export const metadata: Metadata = {
+  title: `${siteName} - E-commerce Store`,
+  description: 'Welcome to our online store powered by DoSwiftly Commerce',
+};
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en">
+      <body className={inter.className}>
+        <main className="min-h-screen">{children}</main>
+      </body>
+    </html>
+  );
+}

package/templates/storefront-minimal/app/page.tsx

@@ -0,0 +1,93 @@
+import { headers } from 'next/headers';
+
+// Shop configuration from Dispatch Worker headers
+interface ShopConfig {
+  shopId: string;
+  shopSlug: string;
+  templateName: string;
+  templateVersion: string;
+  apiUrl: string;
+  currency: string;
+}
+
+async function getShopConfig(): Promise<ShopConfig | null> {
+  const headersList = await headers();
+  const configHeader = headersList.get('x-shop-config');
+
+  if (configHeader) {
+    try {
+      return JSON.parse(configHeader);
+    } catch {
+      return null;
+    }
+  }
+
+  // Fallback to individual headers
+  const shopSlug = headersList.get('x-shop-slug');
+  const apiUrl = headersList.get('x-api-url');
+
+  if (shopSlug) {
+    return {
+      shopId: headersList.get('x-shop-id') || '',
+      shopSlug,
+      templateName: 'unknown',
+      templateVersion: 'unknown',
+      apiUrl: apiUrl || process.env.NEXT_PUBLIC_API_URL || '',
+      currency: 'PLN',
+    };
+  }
+
+  // Development fallback to env vars
+  return {
+    shopId: '',
+    shopSlug: process.env.NEXT_PUBLIC_SHOP_SLUG || '',
+    templateName: 'development',
+    templateVersion: '0.0.0',
+    apiUrl: process.env.NEXT_PUBLIC_API_URL || '',
+    currency: 'PLN',
+  };
+}
+
+export default async function Home() {
+  const config = await getShopConfig();
+
+  return (
+    <div className="flex flex-col items-center justify-center min-h-screen p-8">
+      <h1 className="text-4xl font-bold mb-4">Welcome to your storefront</h1>
+      <p className="text-lg text-gray-600 mb-8">
+        Your DoSwiftly Commerce storefront is ready to be customized.
+      </p>
+
+      <div className="bg-gray-100 dark:bg-gray-800 rounded-lg p-6 max-w-md w-full">
+        <h2 className="text-xl font-semibold mb-4">Configuration</h2>
+        <dl className="space-y-2">
+          <div>
+            <dt className="text-sm text-gray-500">Shop Slug</dt>
+            <dd className="font-mono text-sm">{config?.shopSlug || 'Not configured'}</dd>
+          </div>
+          <div>
+            <dt className="text-sm text-gray-500">API URL</dt>
+            <dd className="font-mono text-sm">{config?.apiUrl || 'Not configured'}</dd>
+          </div>
+          <div>
+            <dt className="text-sm text-gray-500">Template</dt>
+            <dd className="font-mono text-sm">{config?.templateName} v{config?.templateVersion}</dd>
+          </div>
+          <div>
+            <dt className="text-sm text-gray-500">Currency</dt>
+            <dd className="font-mono text-sm">{config?.currency}</dd>
+          </div>
+        </dl>
+      </div>
+
+      <div className="mt-8 text-center">
+        <p className="text-sm text-gray-500 mb-4">Next steps:</p>
+        <ul className="text-sm text-gray-600 space-y-1">
+          <li>1. Build your storefront components</li>
+          <li>2. Connect to the GraphQL API</li>
+          <li>3. Customize the design</li>
+        </ul>
+      </div>
+    </div>
+  );
+}

package/templates/storefront-minimal/lib/graphql-client.ts

@@ -0,0 +1,23 @@
+import { GraphQLClient } from 'graphql-request';
+
+const API_URL = process.env.NEXT_PUBLIC_API_URL || 'https://api.doswiftly.pl';
+const SHOP_SLUG = process.env.NEXT_PUBLIC_SHOP_SLUG || '';
+
+/**
+ * GraphQL client for the Storefront API
+ */
+export const graphqlClient = new GraphQLClient(`${API_URL}/storefront-graphql`, {
+  headers: {
+    'x-shop-slug': SHOP_SLUG,
+  },
+});
+
+/**
+ * Execute a GraphQL query
+ */
+export async function executeQuery<TData, TVariables extends Record<string, unknown>>(
+  document: { toString(): string },
+  variables?: TVariables
+): Promise<TData> {
+  return graphqlClient.request<TData>(document.toString(), variables);
+}

package/templates/storefront-minimal/next.config.ts

@@ -0,0 +1,15 @@
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  reactStrictMode: true,
+  images: {
+    remotePatterns: [
+      {
+        protocol: 'https',
+        hostname: '**.doswiftly.pl',
+      },
+    ],
+  },
+};
+
+export default nextConfig;

package/templates/storefront-minimal/open-next.config.ts

@@ -0,0 +1,3 @@
+import { defineCloudflareConfig } from "@opennextjs/cloudflare";
+
+export default defineCloudflareConfig({});

package/templates/storefront-minimal/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "build:cf": "npx @opennextjs/cloudflare build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "graphql": "^16.10.0",
+    "graphql-request": "^7.1.2",
+    "next": "^15.1.9",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@opennextjs/cloudflare": "^1.0.0",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "typescript": "^5.7.0",
+    "@tailwindcss/postcss": "^4.0.0",
+    "tailwindcss": "^4.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-next": "^15.1.9"
+  }
+}

package/templates/storefront-minimal/postcss.config.mjs

@@ -0,0 +1,5 @@
+export default {
+  plugins: {
+    '@tailwindcss/postcss': {},
+  },
+};

package/templates/storefront-minimal/tailwind.config.ts

@@ -0,0 +1,14 @@
+import type { Config } from 'tailwindcss';
+
+const config: Config = {
+  content: [
+    './app/**/*.{js,ts,jsx,tsx,mdx}',
+    './components/**/*.{js,ts,jsx,tsx,mdx}',
+  ],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};
+
+export default config;

package/templates/storefront-minimal/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    },
+    "target": "ES2017"
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/storefront-minimal/wrangler.toml

@@ -0,0 +1,9 @@
+#:schema node_modules/wrangler/config-schema.json
+
+name = "storefront-template-{{PROJECT_NAME}}"
+main = ".open-next/worker.js"
+compatibility_date = "2024-09-23"
+compatibility_flags = ["nodejs_compat"]
+
+# Assets directory for static files
+assets = { directory = ".open-next/assets", binding = "ASSETS" }

package/templates/storefront-nextjs/.env.example

@@ -0,0 +1,68 @@
+# ===========================================
+# DoSwiftly Commerce - Environment Variables
+# ===========================================
+# Copy this file to .env.local and fill in your values
+# Get these values from your DoSwiftly dashboard
+
+# ===========================================
+# Required: API Configuration
+# ===========================================
+
+# DoSwiftly API URL
+# Default: https://api.doswiftly.pl
+# For local development, use your local backend URL
+NEXT_PUBLIC_API_URL={{API_URL}}
+
+# Your Shop Slug (unique identifier)
+# This is the unique identifier for your shop used by the Storefront GraphQL API
+# Find this in your DoSwiftly dashboard under Shop Settings
+# Example: my-awesome-shop
+NEXT_PUBLIC_SHOP_SLUG={{SHOP_SLUG}}
+
+# Storefront Access Token (optional, for private storefronts)
+# Leave empty for public storefront access
+# NEXT_PUBLIC_STOREFRONT_TOKEN=
+
+# ===========================================
+# Optional: Site Configuration
+# ===========================================
+
+# Site URL (used for SEO and social sharing)
+NEXT_PUBLIC_SITE_URL=http://localhost:3000
+
+# Site Name (displayed in browser tab and SEO)
+NEXT_PUBLIC_SITE_NAME={{PROJECT_NAME}}
+
+# ===========================================
+# Optional: Analytics & Tracking
+# ===========================================
+
+# Google Analytics Measurement ID
+# NEXT_PUBLIC_GA_MEASUREMENT_ID=G-XXXXXXXXXX
+
+# Facebook Pixel ID
+# NEXT_PUBLIC_FB_PIXEL_ID=
+
+# ===========================================
+# Optional: Payment Configuration
+# ===========================================
+
+# Stripe Publishable Key (for client-side Stripe.js)
+# NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_...
+
+# PayU POS ID (for PayU integration)
+# NEXT_PUBLIC_PAYU_POS_ID=
+
+# ===========================================
+# Server-side Only (do not prefix with NEXT_PUBLIC_)
+# ===========================================
+
+# DoSwiftly API Key (for server-side operations)
+# Keep this secret! Never expose in client-side code
+# DOSWIFTLY_API_KEY=
+
+# Stripe Secret Key (for server-side Stripe operations)
+# STRIPE_SECRET_KEY=sk_test_...
+
+# Webhook Secret (for verifying webhook signatures)
+# WEBHOOK_SECRET=

package/templates/storefront-nextjs/.github/workflows/build-template.yml

@@ -0,0 +1,109 @@
+name: Build & Publish Template
+
+on:
+  push:
+    branches: [main, master]
+    tags: ['v*']
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish (e.g., 1.0.0)'
+        required: false
+
+env:
+  # Repository name (e.g., "default1", "minimal", "shadcn")
+  # Worker will be named: storefront-template-{TEMPLATE_NAME}
+  TEMPLATE_NAME: ${{ github.event.repository.name }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Normalize template name
+        id: template
+        run: |
+          # Strip "storefront-" prefix if present
+          RAW_NAME="${{ env.TEMPLATE_NAME }}"
+          NORMALIZED="${RAW_NAME#storefront-}"
+          echo "name=${NORMALIZED}" >> $GITHUB_OUTPUT
+          echo "Template name: ${NORMALIZED}"
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build for Cloudflare (OpenNext)
+        run: npx @opennextjs/cloudflare build
+
+      - name: List build output
+        run: |
+          echo "=== Build output ==="
+          ls -la .open-next/ || echo "No .open-next directory"
+          if [ -f ".open-next/worker.js" ]; then
+            echo "Worker size: $(wc -c < .open-next/worker.js) bytes"
+          fi
+
+      - name: Create deployment wrangler.toml
+        run: |
+          cat > .open-next/wrangler.toml << EOF
+          name = "storefront-template-${{ steps.template.outputs.name }}"
+          main = "worker.js"
+          compatibility_date = "2024-09-23"
+          compatibility_flags = ["nodejs_compat"]
+          assets = { directory = "assets", binding = "ASSETS" }
+          EOF
+
+      - name: Determine version
+        id: version
+        run: |
+          if [ -n "${{ github.event.inputs.version }}" ]; then
+            echo "version=${{ github.event.inputs.version }}" >> $GITHUB_OUTPUT
+          elif [[ "${{ github.ref }}" == refs/tags/v* ]]; then
+            echo "version=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+          else
+            echo "version=$(jq -r .version package.json)-$(git rev-parse --short HEAD)" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Deploy to Cloudflare Workers
+        working-directory: .open-next
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+        run: |
+          if [ -z "$CLOUDFLARE_API_TOKEN" ]; then
+            echo "⏭️ Skipping CF deploy (CLOUDFLARE_API_TOKEN not set)"
+            exit 0
+          fi
+          npx wrangler@latest deploy
+
+      - name: Upload worker bundle artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: worker-bundle
+          path: .open-next/
+          retention-days: 7
+          if-no-files-found: error
+          include-hidden-files: true
+
+      - name: Publish to DoSwiftly (on tag or manual)
+        if: startsWith(github.ref, 'refs/tags/v') || github.event_name == 'workflow_dispatch'
+        env:
+          DOSWIFTLY_TOKEN: ${{ secrets.DOSWIFTLY_DEPLOY_TOKEN }}
+          DOSWIFTLY_API_URL: ${{ secrets.DOSWIFTLY_API_URL }}
+        run: |
+          # Upload bundle to DoSwiftly R2 via API
+          curl -X POST "${DOSWIFTLY_API_URL}/cli/templates/${{ steps.template.outputs.name }}/publish" \
+            -H "Authorization: Bearer ${DOSWIFTLY_TOKEN}" \
+            -F "bundle=@.open-next/worker.js" \
+            -F "version=${{ steps.version.outputs.version }}"

package/templates/storefront-nextjs/.github/workflows/deploy.yml

@@ -0,0 +1,25 @@
+name: Deploy Storefront
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    env:
+      NEXT_PUBLIC_API_URL: ${{ secrets.NEXT_PUBLIC_API_URL }}
+      NEXT_PUBLIC_SHOP_SLUG: ${{ secrets.NEXT_PUBLIC_SHOP_SLUG }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+
+      - name: Deploy to DoSwiftly
+        run: npx --yes @doswiftly/cli deploy run --type PRODUCTION
+        env:
+          DOSWIFTLY_DEPLOY_TOKEN: ${{ secrets.DOSWIFTLY_DEPLOY_TOKEN }}