create-weave-backend-app 0.1.0

package/README.md

@@ -0,0 +1,11 @@
+# Create Fumadocs App
+
+A CLI tool to create new Next.js documentation sites with Fumadocs.
+
+```bash
+npx create-fumadocs-app
+#or
+pnpm create fumadocs-app
+#or
+yarn create fumadocs-app
+```

package/dist/chunk-HIPWNEQ7.js

@@ -0,0 +1,366 @@
+// src/create-app.ts
+import path from "node:path";
+import fs from "node:fs/promises";
+
+// src/git.ts
+import { execSync } from "node:child_process";
+import { rmSync } from "node:fs";
+import { join } from "node:path";
+function isInGitRepository(cwd2) {
+  try {
+    execSync("git rev-parse --is-inside-work-tree", { stdio: "ignore", cwd: cwd2 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isInMercurialRepository(cwd2) {
+  try {
+    execSync("hg --cwd . root", { stdio: "ignore", cwd: cwd2 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isDefaultBranchSet(cwd2) {
+  try {
+    execSync("git config init.defaultBranch", { stdio: "ignore", cwd: cwd2 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function tryGitInit(root) {
+  let didInit = false;
+  try {
+    execSync("git --version", { stdio: "ignore" });
+    if (isInGitRepository(root) || isInMercurialRepository(root)) {
+      return false;
+    }
+    execSync("git init", { stdio: "ignore", cwd: root });
+    didInit = true;
+    if (!isDefaultBranchSet(root)) {
+      execSync("git checkout -b main", { stdio: "ignore", cwd: root });
+    }
+    execSync("git add -A", { stdio: "ignore", cwd: root });
+    execSync('git commit -m "Initial commit from Create Fumadocs App"', {
+      stdio: "ignore",
+      cwd: root
+    });
+    return true;
+  } catch {
+    if (didInit) {
+      try {
+        rmSync(join(root, ".git"), { recursive: true, force: true });
+      } catch {
+      }
+    }
+    return false;
+  }
+}
+
+// src/versions.js
+var versions = { "@inditextech/weave-types": "0.1.0", "@inditextech/weave-sdk": "0.1.0", "@inditextech/weave-store-websockets": "0.1.0", "@inditextech/weave-store-azure-web-pubsub": "0.1.0", "@inditextech/weave-react": "0.1.0" };
+
+// template/package.json
+var package_default = {
+  name: "example-versions",
+  version: "0.0.0",
+  private: true,
+  description: "Used to track dependency versions in create-*-app",
+  license: "MIT",
+  dependencies: {
+    "@azure/storage-blob": "^12.26.0",
+    "@azure/web-pubsub": "^1.1.4",
+    "@azure/web-pubsub-express": "^1.0.6",
+    "@imgly/background-removal-node": "^1.4.5",
+    "@inditextech/weave-sdk": "0.0.0",
+    "@inditextech/weave-store-websockets": "0.0.0",
+    "@inditextech/weave-store-azure-web-pubsub": "0.0.0",
+    "@inditextech/weave-types": "0.0.0",
+    canvas: "^3.1.0",
+    cors: "^2.8.5",
+    dotenv: "^16.4.7",
+    express: "^4.21.2",
+    helmet: "^8.0.0",
+    morgan: "^1.10.0",
+    multer: "^1.4.5-lts.1",
+    pino: "^9.6.0",
+    "pino-http": "^10.4.0",
+    "pino-pretty": "^13.0.0",
+    "ts-node": "^10.9.2",
+    uuid: "^11.1.0",
+    ws: "^8.18.1",
+    "y-protocols": "^1.0.6",
+    yjs: "^13.6.24",
+    zod: "^3.24.2"
+  },
+  devDependencies: {
+    "@eslint/js": "^9.21.0",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.0",
+    "@types/helmet": "^4.0.0",
+    "@types/morgan": "^1.9.9",
+    "@types/multer": "^1.4.12",
+    "@types/node": "^22.13.5",
+    "@types/ws": "^8.18.0",
+    "@typescript-eslint/eslint-plugin": "^8.25.0",
+    "@typescript-eslint/parser": "^8.25.0",
+    commitlint: "^19.7.1",
+    eslint: "^9.21.0",
+    globals: "^16.0.0",
+    nodemon: "^3.1.9",
+    prettier: "^3.5.2",
+    "prettier-eslint": "^16.3.0",
+    "tsconfig-paths": "^4.2.0",
+    tsx: "^4.19.3",
+    typescript: "^5.7.3",
+    "typescript-eslint": "^8.25.0"
+  }
+};
+
+// src/auto-install.ts
+import { spawn } from "cross-spawn";
+function getPackageManager() {
+  const userAgent = process.env.npm_config_user_agent ?? "";
+  if (userAgent.startsWith("yarn")) {
+    return "yarn";
+  }
+  if (userAgent.startsWith("pnpm")) {
+    return "pnpm";
+  }
+  if (userAgent.startsWith("bun")) {
+    return "bun";
+  }
+  return "npm";
+}
+function autoInstall(manager, dest) {
+  return new Promise((res, reject) => {
+    const installProcess = spawn(manager, ["install"], {
+      stdio: "ignore",
+      env: {
+        ...process.env,
+        NODE_ENV: "development",
+        DISABLE_OPENCOLLECTIVE: "1"
+      },
+      cwd: dest
+    });
+    installProcess.on("close", (code) => {
+      if (code !== 0) {
+        reject(new Error("Install failed"));
+      } else {
+        res();
+      }
+    });
+  });
+}
+
+// src/constants.ts
+import { fileURLToPath } from "node:url";
+var sourceDir = fileURLToPath(new URL(`../`, import.meta.url).href);
+var cwd = process.cwd();
+
+// src/create-app.ts
+async function create(options) {
+  const {
+    installDeps = true,
+    initializeGit = true,
+    log = console.log
+  } = options;
+  const projectName = path.basename(options.outputDir);
+  const dest = path.resolve(cwd, options.outputDir);
+  function defaultRename(file) {
+    file = file.replace("example.gitignore", ".gitignore");
+    file = file.replace("example.env", ".env");
+    return file;
+  }
+  await copy(
+    path.join(sourceDir, `template/${options.template}`),
+    dest,
+    defaultRename
+  );
+  const tsconfigPath = path.join(dest, "tsconfig.json");
+  const content = (await fs.readFile(tsconfigPath)).toString();
+  const config = JSON.parse(content);
+  if (config.compilerOptions?.paths) {
+    Object.assign(config.compilerOptions.paths, {
+      "@/*": ["./src/*"]
+    });
+  }
+  await fs.writeFile(tsconfigPath, JSON.stringify(config, null, 2));
+  const packageJson = createPackageJson(projectName, options);
+  await fs.writeFile(
+    path.join(dest, "package.json"),
+    JSON.stringify(packageJson, null, 2)
+  );
+  const readMe = await getReadme(dest, projectName);
+  await fs.writeFile(path.join(dest, "README.md"), readMe);
+  if (installDeps) {
+    await autoInstall(options.packageManager, dest);
+    log("Installed dependencies");
+  }
+  if (initializeGit && tryGitInit(dest)) {
+    log("Initialized Git repository");
+  }
+}
+async function getReadme(dest, projectName) {
+  const template = await fs.readFile(path.join(dest, "README.md")).then((res) => res.toString());
+  return `# ${projectName}
+
+${template}`;
+}
+async function copy(from, to, rename = (s) => s) {
+  const stats = await fs.stat(from);
+  if (stats.isDirectory()) {
+    const files = await fs.readdir(from);
+    await Promise.all(
+      files.map(
+        (file) => copy(path.join(from, file), rename(path.join(to, file)))
+      )
+    );
+  } else {
+    await fs.mkdir(path.dirname(to), { recursive: true });
+    await fs.copyFile(from, to);
+  }
+}
+function createPackageJson(projectName, options) {
+  if (options.template === "+express+azure-web-pubsub") {
+    return {
+      name: projectName,
+      type: "module",
+      scripts: {
+        build: "tsc && mkdir -p ./dist/public && mkdir -p ./dist/temp && cp -r ./public ./dist",
+        copyAssets: "mkdir -p ./public && cp -r node_modules/@imgly/background-removal-node/dist/. public",
+        dev: 'nodemon --exec "tsx --env-file=.env src/server.ts"',
+        postinstall: "npm run copyAssets",
+        start: "node --experimental-specifier-resolution=node --env-file=.env --loader ts-node/esm dist/server.js"
+      },
+      private: true,
+      dependencies: {
+        ...pick(versions, [
+          "@inditextech/weave-types",
+          "@inditextech/weave-sdk",
+          "@inditextech/weave-store-azure-web-pubsub"
+        ]),
+        ...pick(package_default.dependencies, [
+          "@imgly/background-removal-node",
+          "canvas",
+          "cors",
+          "dotenv",
+          "express",
+          "helmet",
+          "morgan",
+          "multer",
+          "pino",
+          "pino-http",
+          "pino-pretty",
+          "ts-node",
+          "uuid",
+          "ws",
+          "y-protocols",
+          "yjs",
+          "zod"
+        ])
+      },
+      devDependencies: pick(package_default.devDependencies, [
+        "@eslint/js",
+        "@types/cors",
+        "@types/express",
+        "@types/helmet",
+        "@types/morgan",
+        "@types/multer",
+        "@types/node",
+        "@types/ws",
+        "@typescript-eslint/eslint-plugin",
+        "@typescript-eslint/parser",
+        "eslint",
+        "globals",
+        "nodemon",
+        "prettier",
+        "prettier-eslint",
+        "tsconfig-paths",
+        "tsx",
+        "typescript",
+        "typescript-eslint"
+      ])
+    };
+  }
+  return {
+    name: projectName,
+    version: "0.0.0",
+    private: true,
+    scripts: {
+      build: "tsc && mkdir -p ./dist/public && mkdir -p ./dist/temp && cp -r ./public ./dist",
+      copyAssets: "mkdir -p ./public && cp -r node_modules/@imgly/background-removal-node/dist/. public",
+      dev: 'nodemon --exec "tsx --env-file=.env src/server.ts"',
+      postinstall: "npm run copyAssets",
+      start: "node --experimental-specifier-resolution=node --env-file=.env --loader ts-node/esm dist/server.js"
+    },
+    dependencies: {
+      ...pick(package_default.dependencies, [
+        "@azure/web-pubsub",
+        "@azure/web-pubsub-express",
+        "@imgly/background-removal-node",
+        "canvas",
+        "cors",
+        "dotenv",
+        "express",
+        "helmet",
+        "morgan",
+        "multer",
+        "pino",
+        "pino-http",
+        "pino-pretty",
+        "ts-node",
+        "uuid",
+        "ws",
+        "y-protocols",
+        "yjs",
+        "zod"
+      ]),
+      ...pick(versions, [
+        "@inditextech/weave-types",
+        "@inditextech/weave-sdk",
+        "@inditextech/weave-store-websockets"
+      ])
+    },
+    devDependencies: {
+      ...pick(package_default.devDependencies, [
+        "@eslint/js",
+        "@types/cors",
+        "@types/express",
+        "@types/helmet",
+        "@types/morgan",
+        "@types/multer",
+        "@types/node",
+        "@types/ws",
+        "@typescript-eslint/eslint-plugin",
+        "@typescript-eslint/parser",
+        "eslint",
+        "globals",
+        "nodemon",
+        "prettier",
+        "prettier-eslint",
+        "tsconfig-paths",
+        "tsx",
+        "typescript",
+        "typescript-eslint"
+      ])
+    }
+  };
+}
+function pick(obj, keys) {
+  const result = {};
+  for (const key of keys) {
+    if (key in obj) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+}
+
+export {
+  getPackageManager,
+  cwd,
+  create
+};

package/dist/create-app.d.ts

@@ -0,0 +1,14 @@
+type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun';
+
+type Template = '+express+websockets' | '+express+azure-web-pubsub';
+interface Options {
+    outputDir: string;
+    template: Template;
+    packageManager: PackageManager;
+    installDeps?: boolean;
+    initializeGit?: boolean;
+    log?: (message: string) => void;
+}
+declare function create(options: Options): Promise<void>;
+
+export { type Options, type Template, create };

package/dist/create-app.js

@@ -0,0 +1,6 @@
+import {
+  create
+} from "./chunk-HIPWNEQ7.js";
+export {
+  create
+};

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+import {
+  create,
+  cwd,
+  getPackageManager
+} from "./chunk-HIPWNEQ7.js";
+
+// src/index.ts
+import fs from "node:fs/promises";
+import path from "node:path";
+import {
+  cancel,
+  confirm,
+  group,
+  intro,
+  isCancel,
+  outro,
+  select,
+  spinner,
+  text
+} from "@clack/prompts";
+import pc from "picocolors";
+var manager = getPackageManager();
+async function main() {
+  intro(pc.bgCyan(pc.bold("Create Weave.js Backend Service")));
+  const options = await group(
+    {
+      name: () => text({
+        message: "Project name",
+        placeholder: "my-service",
+        defaultValue: "my-service"
+      }),
+      template: () => select({
+        message: "Choose a template",
+        initialValue: "+express+websockets",
+        options: [
+          {
+            value: "+express+websockets",
+            label: "Express.js: Weave.js Websockets Store",
+            hint: "recommended"
+          },
+          {
+            value: "+express+azure-web-pubsub",
+            label: "Express.js: Weave.js Azure Web PubSub Store"
+          }
+        ]
+      }),
+      // src: (v) => {
+      //   if (!v.results.template?.startsWith('+next')) return;
+      //   return confirm({
+      //     message: 'Use `/src` directory?',
+      //     initialValue: false,
+      //   });
+      // },
+      // eslint: (v) => {
+      //   if (!v.results.template?.startsWith('+next')) return;
+      //   return confirm({
+      //     message: 'Add default ESLint configuration?',
+      //     initialValue: false,
+      //   });
+      // },
+      installDeps: () => confirm({
+        message: `Do you want to install packages automatically? (detected as ${manager})`
+      })
+    },
+    {
+      onCancel: () => {
+        cancel("Installation Stopped.");
+        process.exit(0);
+      }
+    }
+  );
+  const projectName = options.name.toLowerCase().replace(/\s/, "-");
+  const dest = path.resolve(cwd, projectName);
+  const destDir = await fs.readdir(dest).catch(() => null);
+  if (destDir && destDir.length > 0) {
+    const del = await confirm({
+      message: `directory ${projectName} already exists, do you want to delete its files?`
+    });
+    if (isCancel(del)) {
+      cancel();
+      return;
+    }
+    if (del) {
+      const info2 = spinner();
+      info2.start(`Deleting files in ${projectName}`);
+      await Promise.all(
+        destDir.map((item) => {
+          return fs.rm(path.join(dest, item), {
+            recursive: true,
+            force: true
+          });
+        })
+      );
+      info2.stop(`Deleted files in ${projectName}`);
+    }
+  }
+  const info = spinner();
+  info.start(`Generating Project`);
+  await create({
+    packageManager: manager,
+    template: options.template,
+    outputDir: dest,
+    installDeps: options.installDeps,
+    log: (message) => {
+      info.message(message);
+    }
+  });
+  info.stop("Project Generated");
+  outro(pc.bgGreen(pc.bold("Done")));
+  console.log(pc.bold("\nOpen the project"));
+  console.log(pc.cyan(`cd ${projectName}`));
+  console.log(pc.bold("\nRun Development Server"));
+  console.log(pc.cyan("npm run dev | pnpm run dev | yarn dev"));
+  process.exit(0);
+}
+main().catch((e) => {
+  console.error(e);
+  throw e;
+});

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "create-weave-backend-app",
+  "version": "0.1.0",
+  "description": "Create a new backend artifact for site with Weave.js",
+  "keywords": [
+    "NextJs",
+    "next",
+    "react",
+    "Weave.js"
+  ],
+  "homepage": "https://inditextech.github.io/weavejs",
+  "repository": "github:InditexTech/weavejs",
+  "license": "Apache-2.0",
+  "author": "Jesus Manuel Piñeiro Cid <jesusmpc@inditex.com>",
+  "type": "module",
+  "bin": "./dist/index.js",
+  "module": "./dist/create-app.js",
+  "types": "./dist/create-app.d.ts",
+  "files": [
+    "template/*",
+    "dist/*"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "bump:snapshot": "npm version $npm_package_version.$(date \"+%s\")",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "link": "npm link",
+    "lint:fix": "npm run lint -- --fix",
+    "lint": "eslint ./src",
+    "publish:snapshot": "npm publish",
+    "release:perform": "npm publish --access public",
+    "release:prepare": "npm run verify",
+    "test": "echo \"No tests defined\" && exit 0",
+    "types:check": "tsc --noEmit",
+    "verify": "npm run lint && npm run test && npm run build",
+    "version:development": "npm version $(npm version minor)-SNAPSHOT",
+    "version:release": "npm version $RELEASE_VERSION -m \"[npm-scripts] prepare release $RELEASE_VERSION\" --tag-version-prefix \"\""
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.10.1",
+    "cross-spawn": "^7.0.6",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "^6.0.6",
+    "@types/node": "22.14.1",
+    "fast-glob": "^3.3.3",
+    "tsup": "8.4.0"
+  },
+  "engines": {
+    "node": "^18.12 || ^20.11 || ^22.11"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "nx": {
+    "implicitDependencies": [
+      "@inditextech/weave-react",
+      "@inditextech/weave-sdk",
+      "@inditextech/weave-store-azure-web-pubsub",
+      "@inditextech/weave-store-websockets",
+      "@inditextech/weave-types"
+    ]
+  }
+}

package/template/+express+azure-web-pubsub/README.md

@@ -0,0 +1,38 @@
+# Weave.js Backend start template
+
+This is an Express.js application that was generated with **Create Weave.js Backend**
+
+This server setup the Weave.js
+[Azure Web Pubsub store](https://inditextech.github.io/weavejs/docs/main/build/stores/azure-web-pubsub-store) store. So before perform the quickstart please setup on the `.env` file the configuration for your Azure Web Pubsub instance.
+
+## Quickstart
+
+If you skipped the automatic installation of the dependencies, run first this
+command:
+
+```bash
+npm install
+# or
+pnpm install
+# or
+yarn install
+```
+
+Now, lets run the development server:
+
+```bash
+npm run dev
+# or
+pnpm dev
+# or
+yarn dev
+```
+
+## Learn more
+
+To learn more about Express.js and Weave.js, take a look at the following
+resources:
+
+- [Express.js](https://expressjs.com/) - learn about Express.js
+- [Weave.js](https://inditextech.github.io/weavejs) - learn about Weave.js
+- [Weave.js repository](https://github.com/InditexTech/weavejs) - check out out code.

package/template/+express+azure-web-pubsub/eslint.config.js

@@ -0,0 +1,11 @@
+import globals from "globals";
+import pluginJs from "@eslint/js";
+import tseslint from "typescript-eslint";
+
+/** @type {import('eslint').Linter.Config[]} */
+export default [
+  {files: ["**/*.{js,mjs,cjs,ts}"], ignores: ["dist/**/*"],},
+  {languageOptions: { globals: globals.node }},
+  pluginJs.configs.recommended,
+  ...tseslint.configs.recommended,
+];

package/template/+express+azure-web-pubsub/example.env

@@ -0,0 +1,10 @@
+HOSTNAME=0.0.0.0
+PORT=8080
+LOG_LEVEL=debug
+
+// Endpoint for the Azure Web PubSub service
+WEAVE_AZURE_WEB_PUBSUB_ENDPOINT=<your-endpoint>
+// Secret key for the Azure Web PubSub service
+WEAVE_AZURE_WEB_PUBSUB_KEY=<your-key>
+// Name of the Hub for the Azure Web PubSub service
+WEAVE_AZURE_WEB_PUBSUB_HUB_NAME=<your-hub-name>

package/template/+express+azure-web-pubsub/example.gitignore

@@ -0,0 +1,37 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+reports
+
+node_modules
+dist
+dist-ssr
+*.local
+vite.config.ts*
+!vite.config.ts
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+*.pem
+.env*
+.npmrc
+
+images
+images-mimetype
+rooms
+temp
+public