@kosmojs/dev 0.0.4 → 0.0.6

package/pkg/cli/templates/@src/vite.config.hbs

@@ -0,0 +1,29 @@
+import { join } from "node:path";
+
+{{#each plugins}}{{importDeclaration}}
+{{/each}}
+import devPlugin, { apiGenerator, fetchGenerator } from "@kosmojs/dev";
+{{#each generators}}{{importDeclaration}}
+{{/each}}
+
+import defineConfig from "../vite.base";
+import { apiurl, baseurl } from "./config";
+
+export default defineConfig(import.meta.dirname, {
+  base: join(baseurl, "/"),
+  server: {
+    port: {{folder.port}},
+  },
+  plugins: [
+    {{#each plugins}}{{importName}}({{options}}),
+    {{/each}}
+    devPlugin(apiurl, {
+      generators: [
+        apiGenerator(),
+        fetchGenerator(),
+        {{#each generators}}{{importName}}({{options}}),
+        {{/each}}
+      ],
+    }),
+  ],
+});

package/pkg/cli/templates/core/api/app.ts

@@ -0,0 +1,6 @@
+import { type AppOptions, createApp } from "@kosmojs/api";
+
+export default (options?: AppOptions) => {
+  const app = createApp(options);
+  return app;
+};

package/pkg/cli/templates/core/api/env.d.ts

@@ -0,0 +1,4 @@
+export declare module "@kosmojs/api" {
+  interface DefaultState {}
+  interface DefaultContext {}
+}

package/pkg/cli/templates/core/api/router.ts

@@ -0,0 +1,6 @@
+import { createRouter, type RouterOptions } from "@kosmojs/api";
+
+export default (options?: RouterOptions) => {
+  const router = createRouter(options);
+  return router;
+};

package/pkg/cli/templates/core/api/server.ts

@@ -0,0 +1,49 @@
+import { chmod, unlink } from "node:fs/promises";
+import { parseArgs } from "node:util";
+
+import type { App } from "@kosmojs/api";
+
+const {
+  values: { port, sock },
+} = parseArgs({
+  options: {
+    port: {
+      type: "string",
+      short: "p",
+    },
+    sock: {
+      type: "string",
+      short: "s",
+    },
+  },
+});
+
+if (![port, sock].some((e) => e)) {
+  console.error("Please provide either -p/--port number or -s/--sock path");
+  process.exit(1);
+}
+
+console.log("\n  ➜ Starting Server", { port, sock });
+
+if (sock) {
+  await unlink(sock).catch((error) => {
+    if (error.code === "ENOENT") {
+      return;
+    }
+    console.error(error.message);
+    process.exit(1);
+  });
+}
+
+export default async <T extends App = App>(
+  createApp: () => T | Promise<T>,
+): Promise<import("node:http").Server> => {
+  const app = await createApp();
+  // app.listen is returning the actual server
+  return app.listen(port || sock, async () => {
+    if (sock) {
+      await chmod(sock, 0o777);
+    }
+    console.log("\n  ➜ Server Started ✨\n");
+  });
+};

package/pkg/cli/templates/core/api/use.ts

@@ -0,0 +1,21 @@
+import { use } from "@kosmojs/api";
+import bodyparser from "@kosmojs/api/bodyparser";
+
+// Middleware applied to all routes by default.
+// Can be overridden on a per-route basis using the slot key.
+export default [
+  use(bodyparser.json(), {
+    on: ["POST", "PUT", "PATCH"],
+    slot: "bodyparser",
+  }),
+
+  use(
+    (ctx, next) => {
+      ctx.payload = ["POST", "PUT", "PATCH"].includes(ctx.method)
+        ? ctx.request.body
+        : ctx.query;
+      return next();
+    },
+    { slot: "payload" },
+  ),
+];

package/pkg/cli/templates/vite.base.hbs

@@ -0,0 +1,44 @@
+import { basename, resolve } from "node:path";
+
+import { aliasPlugin, definePlugin } from "@kosmojs/dev";
+import { loadEnv, mergeConfig, type UserConfig } from "vite";
+
+import pkg from "./package.json" with { type: "json" };
+
+export default async (sourceFolderPath: string, config: UserConfig) => {
+  const env = loadEnv("mock", import.meta.dirname);
+  const sourceFolder = basename(sourceFolderPath);
+  return mergeConfig(config, {
+    build: {
+      outDir: resolve(import.meta.dirname, `${pkg.distDir}/${sourceFolder}`),
+      emptyOutDir: true,
+      sourcemap: true,
+    },
+
+    server: {
+      host: true,
+      allowedHosts: [env.VITE_HOSTNAME],
+      fs: {
+        strict: false,
+      },
+      watch: {
+        awaitWriteFinish: {
+          stabilityThreshold: 800,
+          pollInterval: 200,
+        },
+      },
+    },
+
+    cacheDir: resolve(import.meta.dirname, `var/.vite/${sourceFolder}`),
+
+    plugins: [
+      aliasPlugin(import.meta.dirname),
+      definePlugin([
+        {
+          // keys extracted from process.env and exposed to client
+          keys: ["DEBUG"],
+        },
+      ]),
+    ],
+  });
+};

package/pkg/src/cli/base.d.ts

@@ -0,0 +1,30 @@
+export type Project = {
+    name: string;
+    distDir?: string;
+};
+export type SourceFolder = {
+    name: string;
+    framework?: (typeof FRAMEWORK_OPTIONS)[number];
+    ssr?: boolean;
+    base?: string;
+    port?: number | string;
+};
+export declare const CREATE_OPTIONS: readonly ["project", "folder"];
+export declare const FRAMEWORK_OPTIONS: readonly ["none", "solid", "react"];
+export declare const NODE_VERSION = "22";
+export declare const DEFAULT_DIST = "dist";
+export declare const DEFAULT_BASE = "/";
+export declare const DEFAULT_PORT = "4000";
+export declare const DEFAULT_FRAMEWORK: "none";
+export declare const copyFiles: (src: string, dst: string, { exclude }?: {
+    exclude?: Array<string | RegExp>;
+}) => Promise<void>;
+export declare const pathExists: (path: string) => Promise<boolean>;
+export declare const validateName: (name: string | undefined) => "Invalid name provided" | "May contain only alphanumerics, hyphens, periods or any of @ $ +" | undefined;
+export declare const validateBase: (base: string | undefined) => "Should start with a slash" | "Should not contain path traversal patterns" | undefined;
+export declare const validatePort: (port: string | number | undefined) => "Invalid port number" | undefined;
+export declare const assertNoError: (validator: () => string | undefined) => void;
+export declare const messageFactory: (logger?: (...lines: Array<unknown>) => void) => {
+    projectCreated(project: Project): unknown[] | undefined;
+    sourceFolderCreated(_folder: SourceFolder): unknown[] | undefined;
+};

package/pkg/src/cli/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env -S node --enable-source-maps --no-warnings=ExperimentalWarning
+export {};

package/pkg/src/cli/factory.d.ts

@@ -0,0 +1,12 @@
+import { type Project, type SourceFolder } from "./base";
+export declare const createProject: (path: string, project: Project, assets?: {
+    NODE_VERSION?: `${number}`;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+}) => Promise<void>;
+export declare const createSourceFolder: (projectRoot: string, // path inside project
+folder: SourceFolder, opt?: {
+    frameworkOptions?: Record<string, unknown>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+}) => Promise<void>;

package/pkg/src/cli/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./base";
+export * from "./factory";

package/pkg/src/cli/templates/core/api/app.d.ts

@@ -0,0 +1,3 @@
+import { type AppOptions } from "@kosmojs/api";
+declare const _default: (options?: AppOptions) => import("@kosmojs/api").App;
+export default _default;

package/pkg/src/cli/templates/core/api/router.d.ts

@@ -0,0 +1,3 @@
+import { type RouterOptions } from "@kosmojs/api";
+declare const _default: (options?: RouterOptions) => import("@kosmojs/api").Router;
+export default _default;

package/pkg/src/cli/templates/core/api/server.d.ts

@@ -0,0 +1,3 @@
+import type { App } from "@kosmojs/api";
+declare const _default: <T extends App = App>(createApp: () => T | Promise<T>) => Promise<import("node:http").Server>;
+export default _default;

package/pkg/src/cli/templates/core/api/use.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("@kosmojs/api").MiddlewareDefinition[];
+export default _default;

package/pkg/test/cli/create.test.d.ts

@@ -0,0 +1 @@
+export {};

package/pkg/test/setup.d.ts

@@ -0,0 +1 @@
+export {};

package/pkg/cli.js

@@ -1,3 +0,0 @@
-// src/cli.ts
-import "kosmojs/cli";
-//# sourceMappingURL=cli.js.map

package/pkg/cli.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/cli.ts"],
-  "sourcesContent": ["import \"kosmojs/cli\";\n"],
-  "mappings": ";AAAA,OAAO;",
-  "names": []
-}

package/pkg/src/cli.d.ts

@@ -1 +0,0 @@
-import "kosmojs/cli";