@morda-dev/create-sdk 1.0.1

package/bin/create-sdk.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+/**
+ * Resolve __dirname in ESM
+ */
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * Project name from CLI args
+ */
+const projectName = process.argv[2];
+
+if (!projectName) {
+  console.error("❌ Please provide a project name");
+  console.error("   Usage: npx create-sdk my-sdk");
+  process.exit(1);
+}
+
+/**
+ * Paths
+ */
+const targetDir = path.resolve(process.cwd(), projectName);
+const templateDir = path.resolve(__dirname, "../template");
+
+/**
+ * Safety checks
+ */
+if (!fs.existsSync(templateDir)) {
+  console.error("❌ Template directory not found:");
+  console.error("   ", templateDir);
+  process.exit(1);
+}
+
+if (fs.existsSync(targetDir)) {
+  console.error(`❌ Directory "${projectName}" already exists`);
+  process.exit(1);
+}
+
+/**
+ * Create project
+ */
+console.log("🚀 Creating SDK:", projectName);
+
+copyDir(templateDir, targetDir);
+
+/**
+ * Update package.json
+ */
+const pkgPath = path.join(targetDir, "package.json");
+
+if (!fs.existsSync(pkgPath)) {
+  console.error("❌ package.json not found in template");
+  process.exit(1);
+}
+
+const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+
+pkg.name = projectName;
+pkg.version = "0.1.0";
+delete pkg.private;
+
+fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+
+/**
+ * Done
+ */
+console.log("✅ SDK created successfully!");
+console.log("");
+console.log("Next steps:");
+console.log(`  cd ${projectName}`);
+console.log("  npm install");
+console.log("  npm run build");
+
+/**
+ * ===== Helpers =====
+ */
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    if (shouldIgnore(entry.name)) continue;
+
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function shouldIgnore(name) {
+  return (
+    name === "node_modules" ||
+    name === ".git" ||
+    name === "dist" ||
+    name === ".DS_Store"
+  );
+}

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@morda-dev/create-sdk",
+  "version": "1.0.1",
+  "description": "CLI to scaffold a production-ready TypeScript SDK",
+  "type": "module",
+  "bin": {
+    "create-sdk": "./bin/create-sdk.js"
+  },
+  "files": [
+    "bin",
+    "template"
+  ],
+  "license": "ISC"
+}

package/template/.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# Автоматический выбор ревьювера для всех файлов
+* @mordaHQ

package/template/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,35 @@
+name: Bug Report
+description: Сообщить об ошибке
+title: "[BUG]: "
+labels: ["bug"]
+
+---
+
+## 🐞 Описание проблемы
+
+Опиши баг простыми словами.
+
+## 🔁 Шаги для воспроизведения
+
+1.
+2.
+3.
+
+## ✅ Ожидаемое поведение
+
+Что должно происходить?
+
+## ❌ Фактическое поведение
+
+Что происходит на самом деле?
+
+## 🖼 Скриншоты / Видео
+
+Если есть, приложи.
+
+## 💻 Окружение
+
+- ОС:
+- Node.js:
+- Браузер:
+- Версия проекта:

package/template/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,26 @@
+name: Feature Request
+description: Предложить улучшение
+title: "[FEATURE]: "
+labels: ["enhancement"]
+
+---
+
+## 🚀 Описание предложения
+
+Опиши какую функцию или улучшение ты предлагаешь.
+
+## 🤔 Почему это важно?
+
+Расскажи, какую проблему это решит или что улучшит.
+
+## 🧩 Детали реализации
+
+Есть ли мысли, как это должно работать?
+
+## 📦 Альтернативы
+
+Есть ли другие варианты решения?
+
+## 🖼 Макеты / Примеры
+
+Если есть — приложи.

package/template/.github/dependabot.yml

@@ -0,0 +1,18 @@
+version: 2
+updates:
+  # 1. Обновление npm зависимостей
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "deps"
+    open-pull-requests-limit: 5
+
+  # 2. Обновление GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "ci"

package/template/.github/pull_request_template.md

@@ -0,0 +1,25 @@
+# Pull Request
+
+## 📌 Описание
+
+Кратко опиши, что делает этот PR и зачем он нужен.
+
+## 🔧 Что сделано
+
+- [ ] Добавлено…
+- [ ] Исправлено…
+- [ ] Оптимизировано…
+
+## 🧪 Тестирование
+
+- [ ] Код собирается (npm run build)
+- [ ] Линт проходит (npm run lint)
+- [ ] Тесты проходят (npm test)
+
+## 🧩 Потенциальные риски
+
+Опиши, может ли PR что-то сломать.
+
+## 📝 Примечания
+
+Любая дополнительная информация.

package/template/.github/workflows/auto-release.yml

@@ -0,0 +1,77 @@
+name: Auto Release (create release PR)
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  prepare-release:
+    name: Prepare release and open PR
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run lint
+        run: npm run lint --if-present
+
+      - name: Run tests
+        run: npm test --if-present
+
+      - name: Build
+        run: npm run build --if-present
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+      - name: Run standard-version
+        id: stdver
+        run: |
+          npx standard-version --no-verify
+          echo "new_version=$(node -p \"require('./package.json').version\")" >> $GITHUB_OUTPUT
+          echo "new_tag=v$(node -p \"require('./package.json').version\")" >> $GITHUB_OUTPUT
+          BRANCH="release/v$(node -p \"require('./package.json').version\")"
+          git branch "$BRANCH"
+          echo "release_branch=$BRANCH" >> $GITHUB_OUTPUT
+
+      - name: Push release branch and tags
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          git push origin "refs/heads/${{ steps.stdver.outputs.release_branch }}:${{ steps.stdver.outputs.release_branch }}"
+          git push origin --tags
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v5
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          branch: ${{ steps.stdver.outputs.release_branch }}
+          title: "chore(release): ${{ steps.stdver.outputs.new_version }}"
+          body: |
+            ## Release ${{ steps.stdver.outputs.new_version }}
+
+            This PR contains the changelog and version bump generated by standard-version.
+
+            **Changelog excerpt:**
+            ```
+            $(awk 'BEGIN{p=0} /^## \[/{ if (p==1) exit } /^## \['"${{ steps.stdver.outputs.new_version }}"'\]/{p=1; next} p{print}' CHANGELOG.md || true)
+            ```
+          labels: release, automated

package/template/.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Typecheck
+        run: npm run typecheck
+
+      - name: Build
+        run: npm run build
+
+      - name: Test
+        run: npm run test

package/template/.github/workflows/deploy-pages.yml

@@ -0,0 +1,73 @@
+name: Build and Deploy Docs (Cloudflare Pages)
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      # ---- REPO ----
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      # ---- NODE ----
+      - name: Use Node.js 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      # ---- INSTALL ROOT ----
+      - name: Install root dependencies
+        run: npm install
+
+      # ---- CLEAN OLD API DOCS ----
+      - name: Remove old API docs
+        run: rm -rf docusaurus-build/docs/api
+
+      # ---- GENERATE API DOCS ----
+      - name: Generate API docs (TypeDoc)
+        run: npm run docs:api
+
+      # ---- INSTALL DOCUSAURUS ----
+      - name: Install Docusaurus dependencies
+        run: |
+          cd docusaurus-build
+          npm ci --legacy-peer-deps
+
+      # ---- TYPECHECK ----
+      - name: Type check Docusaurus
+        run: |
+          cd docusaurus-build
+          npm run typecheck
+
+      # ---- BUILD DOCUSAURUS ----
+      - name: Build Docusaurus site
+        run: |
+          cd docusaurus-build
+          npm run build
+
+      # ---- ARTIFACT → CF PAGES ----
+      - name: Upload Pages build artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docusaurus-build/build
+
+      # ---- DEPLOY ----
+      - name: Deploy to Cloudflare Pages
+        if: github.ref == 'refs/heads/main'
+        uses: cloudflare/pages-action@v1
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          projectName: ${{ secrets.CLOUDFLARE_PROJECT_NAME }}
+          directory: docusaurus-build/build

package/template/.github/workflows/docs-ci.yml

@@ -0,0 +1,38 @@
+name: Docs CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: docusaurus-build
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: docusaurus-build/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Type check
+        run: npm run typecheck
+
+      - name: Generate API (TypeDoc)
+        run: npm run docs:api
+
+      - name: Build documentation
+        run: npm run build

package/template/.github/workflows/docs.yml

@@ -0,0 +1,19 @@
+name: Deploy Docs (Deprecated)
+
+# 🚫 Workflow отключён и больше не используется
+# Он оставлен только для истории. Деплой осуществляется через Cloudflare Pages.
+
+on:
+  workflow_dispatch:  # можно запустить вручную, но автоматом не запускается
+
+permissions:
+  contents: read
+
+jobs:
+  deprecated:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deprecated message
+        run: |
+          echo "⚠️ This workflow is deprecated and no longer used."
+          echo "Deployment is handled by .github/workflows/deploy-pages.yml"

package/template/.github/workflows/release.yml

@@ -0,0 +1,51 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      packages: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Get tag name
+        id: tag
+        run: |
+          echo "TAG_NAME=${GITHUB_REF##*/}" >> $GITHUB_ENV
+
+      - name: Extract changelog for tag
+        id: changelog
+        run: |
+          TAG="$TAG_NAME"
+          awk_cmd='BEGIN{p=0} /^## \[/{ if (p==1) exit } /^## \['"$TAG"'\]/{p=1; next} p{print}' CHANGELOG.md > /tmp/RELEASE_BODY || true
+          if [ -s /tmp/RELEASE_BODY ]; then
+            echo "RELEASE_BODY<<EOF" >> $GITHUB_ENV
+            cat /tmp/RELEASE_BODY >> $GITHUB_ENV
+            echo "EOF" >> $GITHUB_ENV
+          else
+            echo "RELEASE_BODY<<EOF" >> $GITHUB_ENV
+            echo "See CHANGELOG.md" >> $GITHUB_ENV
+            echo "EOF" >> $GITHUB_ENV
+          fi
+
+      - name: Create GitHub Release
+        uses: ncipollo/release-action@v1
+        with:
+          tag: ${{ env.TAG_NAME }}
+          name: ${{ env.TAG_NAME }}
+          body: ${{ env.RELEASE_BODY }}
+          draft: false
+          prerelease: false

package/template/.husky/commit-msg

@@ -0,0 +1,4 @@
+#!/bin/sh
+. "$(dirname "$0")/_/husky.sh"
+
+node scripts/commitlint-runner.mjs "$1"

package/template/.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npx lint-staged

package/template/CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+## [1.2.0](https://github.com/mordaHQ/project-template/compare/v1.1.0...v1.2.0) (2025-12-23)
+
+## [1.1.0](https://github.com/mordaHQ/project-template/compare/v1.0.8...v1.1.0) (2025-12-23)
+
+### [1.0.8](https://github.com/mordaHQ/project-template/compare/v1.0.4...v1.0.8) (2025-12-23)
+
+### Features
+
+- add initial blog post ([3e67468](https://github.com/mordaHQ/project-template/commit/3e6746893973a1ed6b7df8be7895e190cb6e703c))
+- **sdk:** stabilize public API with api-extractor ([868196b](https://github.com/mordaHQ/project-template/commit/868196b8110bd48c52150a27577a71af30460ecc))
+
+### Bug Fixes
+
+- **blog:** add morda author + hello-world post ([04ba630](https://github.com/mordaHQ/project-template/commit/04ba6301c9f8638344bd1c8a2bc666fbbe4c9170))
+- **blog:** correct blog post and config ([981dabe](https://github.com/mordaHQ/project-template/commit/981dabe820ce0504afd37c2cd29e99df7db5c20d))
+- correct .gitignore for Docusaurus ([610f389](https://github.com/mordaHQ/project-template/commit/610f3893fc279d07c2bfcea1dbb5517e269810a7))
+- correct docusaurus build for cloudflare ([21908dc](https://github.com/mordaHQ/project-template/commit/21908dc837cf915329d02379e715246f85c468d6))
+- correct npm install process ([135531c](https://github.com/mordaHQ/project-template/commit/135531c9ced1885108bdaa7dfa31aa29b5ecde88))
+- finalize Cloudflare deploy workflow ([8172522](https://github.com/mordaHQ/project-template/commit/8172522675ed91e0044507753898a48d334f82c5))
+- migrate docusaurus config for cloudflare pages ([5fee402](https://github.com/mordaHQ/project-template/commit/5fee40291fe51aeb4961969fb6451ef4cc2d241d))
+- update Docusaurus config ([8d4ec64](https://github.com/mordaHQ/project-template/commit/8d4ec64482c05c2900ee4b208da78b53facb9dd2))
+
+### [1.0.7](https://github.com/mordaHQ/project-template/compare/v1.0.4...v1.0.7) (2025-11-25)
+
+### Bug Fixes
+
+- correct .gitignore for Docusaurus ([610f389](https://github.com/mordaHQ/project-template/commit/610f3893fc279d07c2bfcea1dbb5517e269810a7))
+- update Docusaurus config ([8d4ec64](https://github.com/mordaHQ/project-template/commit/8d4ec64482c05c2900ee4b208da78b53facb9dd2))
+
+### [1.0.6](https://github.com/mordaHQ/project-template/compare/v1.0.5...v1.0.6) (2025-11-24)
+
+### [1.0.5](https://github.com/mordaHQ/project-template/compare/v1.0.4...v1.0.5) (2025-11-24)
+
+### [1.0.4](https://github.com/mordaHQ/project-template/compare/v1.0.3...v1.0.4) (2025-11-24)
+
+### [1.0.3](https://github.com/mordaHQ/project-template/compare/v1.0.2...v1.0.3) (2025-11-23)
+
+### [1.0.2](https://github.com/mordaHQ/project-template/compare/v1.0.1...v1.0.2) (2025-11-23)
+
+### 1.0.1 (2025-11-23)
+
+### Bug Fixes
+
+- correct commitlint config to CJS ([ce29ae9](https://github.com/mordaHQ/project-template/commit/ce29ae9c73544bff01eefd789e1f38dc0a1cd9e9))
+- remove bom char from example test ([15d151c](https://github.com/mordaHQ/project-template/commit/15d151ced1fcd08662cf3156c91a77ada3c9dca4))

package/template/CODE_OF_CONDUCT.md

@@ -0,0 +1,40 @@
+# Code of Conduct
+
+This project follows the **Contributor Covenant v2.1** Code of Conduct.
+
+## Our Pledge
+
+We pledge to make participation in our project and community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Demonstrating empathy and kindness
+- Giving and receiving constructive feedback
+- Taking responsibility for mistakes
+- Focusing on what is best for the community
+
+Examples of unacceptable behavior:
+
+- Harassment or insulting comments
+- Public or private harassment
+- Publishing others' private information
+- Other conduct that would be inappropriate in a professional environment
+
+## Enforcement Responsibilities
+
+Project maintainers are responsible for clarifying and enforcing our standards.
+
+## Scope
+
+This Code of Conduct applies within all project spaces and in public spaces when representing the project.
+
+## Enforcement
+
+Instances of abusive or unacceptable behavior may be reported by creating an issue or contacting the maintainers directly.
+
+## Attribution
+
+This Code of Conduct is adapted from the Contributor Covenant, version 2.1:
+https://www.contributor-covenant.org/version/2/1/code_of_conduct/

package/template/CONTRIBUTING.md

@@ -0,0 +1,38 @@
+# Contributing Guide
+
+Спасибо, что хочешь улучшить проект!
+
+## 🔧 Требования
+
+- Node.js 20+
+- NPM 10+
+- TypeScript 5+
+- Перед пушем запускай:
+  npm run lint
+  npm run test
+
+## 📝 Коммиты
+
+Мы используем **Conventional Commits**:
+
+- feat: новая фича
+- fix: исправление
+- docs: документация
+- test: тесты
+- chore: обслуживание
+- refactor: переработка без изменения логики
+
+## 🔀 Ветки
+
+- main — стабильная
+- feature/\* — новые фичи
+- fix/\* — багфиксы
+
+## 🧪 Тесты
+
+Все PR должны включать тесты или объяснение, почему тесты не нужны.
+
+## 📦 Публикация релизов
+
+Релизы создаются автоматически:
+npm run release