create-bunspace 0.1.0

package/dist/templates/monorepo/core/packages/main/src/index.ts

@@ -0,0 +1,80 @@
+/**
+ * {{NAME}}
+ *
+ * {{DESCRIPTION}}
+ *
+ * @module
+ * @example
+ * ```typescript
+ * import { greet } from '{{SCOPE}}/core';
+ * import { createLogger } from '{{SCOPE}}/utils/logger';
+ *
+ * const log = createLogger('Main');
+ *
+ * const result = greet('World');
+ *
+ * if (result.isErr()) {
+ *   log.error('Failed', result.error);
+ *   return;
+ * }
+ *
+ * log.success(result.value);
+ * ```
+ */
+
+import { ok, type Result, type ResultError } from '{{SCOPE}}/utils/result';
+import type { AppErrorCode } from '{{SCOPE}}/utils/result';
+
+// Importar tipos desde /types para uso interno
+import type { IGreetOptions } from './types';
+
+// Re-exportar tipos desde /types
+export * from './types';
+
+// Version del package
+export const version = '0.1.0';
+
+// Tipo de error
+type AppError = ResultError<AppErrorCode>;
+
+/**
+ * Saluda a alguien con un mensaje personalizable.
+ *
+ * @param name - Nombre de la persona a saludar
+ * @param options - Opciones de saludo
+ * @returns Result con mensaje de saludo o error
+ *
+ * @example
+ * ```typescript
+ * const result = greet('World', { prefix: 'Hello' });
+ * if (result.isOk()) {
+ *   console.log(result.value); // "Hello, World!"
+ * }
+ * ```
+ */
+export function greet(
+  name: string,
+  options?: IGreetOptions
+): Result<string, AppError> {
+  const prefix = options?.prefix ?? 'Hello';
+  const suffix = options?.suffix ?? '!';
+  return ok(`${prefix}, ${name}${suffix}`);
+}
+
+/**
+ * Factory function para crear un greeter configurado.
+ *
+ * @param defaultOptions - Opciones por defecto para todos los saludos
+ * @returns Funcion greeter configurada
+ *
+ * @example
+ * ```typescript
+ * const spanishGreeter = createGreeter({ prefix: 'Hola' });
+ * const result = spanishGreeter('Mundo'); // "Hola, Mundo!"
+ * ```
+ */
+export function createGreeter(defaultOptions?: IGreetOptions) {
+  return (name: string, options?: IGreetOptions): Result<string, AppError> => {
+    return greet(name, { ...defaultOptions, ...options });
+  };
+}

package/dist/templates/monorepo/core/packages/main/src/types/constants.ts

@@ -0,0 +1,15 @@
+/**
+ * Constantes del package.
+ *
+ * @module
+ */
+
+/**
+ * Prefijo por defecto para saludos.
+ */
+export const DEFAULT_PREFIX = 'Hello';
+
+/**
+ * Sufijo por defecto para saludos.
+ */
+export const DEFAULT_SUFFIX = '!';

package/dist/templates/monorepo/core/packages/main/src/types/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Tipos del dominio del package {{SCOPE}}/core.
+ *
+ * @module
+ */
+
+export * from './main.types';
+export * from './constants';

package/dist/templates/monorepo/core/packages/main/src/types/main.types.ts

@@ -0,0 +1,25 @@
+/**
+ * Tipos del dominio principal.
+ *
+ * @module
+ */
+
+/**
+ * Opciones de configuracion para saludos.
+ */
+export interface IGreetOptions {
+  /**
+   * Prefijo del saludo (default: "Hello").
+   */
+  prefix?: string;
+
+  /**
+   * Sufijo del saludo (default: "!").
+   */
+  suffix?: string;
+}
+
+/**
+ * Callback para notificar eventos.
+ */
+export type IEventCallback = (event: string) => void;

package/dist/templates/monorepo/core/packages/main/src/utils/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Utilidades locales del package {{SCOPE}}/core.
+ *
+ * @module
+ */

package/dist/templates/monorepo/core/packages/utils/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "{{SCOPE}}/utils",
+  "version": "0.0.1",
+  "description": "Shared utilities for {{NAME}}",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./logger": {
+      "types": "./dist/logger.d.ts",
+      "import": "./dist/logger.js"
+    },
+    "./result": {
+      "types": "./dist/result.d.ts",
+      "import": "./dist/result.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "rolldown --config rolldown.config.ts && tsgo --emitDeclarationOnly",
+    "typecheck": "tsgo --noEmit",
+    "dev": "bun --watch src/index.ts"
+  },
+  "dependencies": {
+    "@mks2508/better-logger": "^4.0.0",
+    "@mks2508/no-throw": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "rolldown": "^1.0.0-beta.58"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/dist/templates/monorepo/core/packages/utils/rolldown.config.ts

@@ -0,0 +1,34 @@
+import { defineConfig } from 'rolldown';
+
+export default defineConfig([
+  {
+    input: './src/index.ts',
+    output: {
+      dir: './dist',
+      format: 'esm',
+      exports: 'named',
+      sourcemap: true,
+    },
+    external: ['@mks2508/better-logger', '@mks2508/no-throw'],
+  },
+  {
+    input: './src/logger.ts',
+    output: {
+      file: './dist/logger.js',
+      format: 'esm',
+      exports: 'named',
+      sourcemap: true,
+    },
+    external: ['@mks2508/better-logger'],
+  },
+  {
+    input: './src/result.ts',
+    output: {
+      file: './dist/result.js',
+      format: 'esm',
+      exports: 'named',
+      sourcemap: true,
+    },
+    external: ['@mks2508/no-throw'],
+  },
+]);

package/dist/templates/monorepo/core/packages/utils/src/index.ts

@@ -0,0 +1,2 @@
+export * from './logger';
+export * from './result';

package/dist/templates/monorepo/core/packages/utils/src/logger.ts

@@ -0,0 +1,68 @@
+/**
+ * Logging utility basado en @mks2508/better-logger.
+ *
+ * Configura el preset cyberpunk y exporta funciones para crear loggers nombrados.
+ *
+ * @module
+ *
+ * @example
+ * ```typescript
+ * import { createLogger } from '{{SCOPE}}/utils/logger';
+ *
+ * const log = createLogger('MyComponent');
+ *
+ * log.info('Started');
+ * log.error('Failed to connect', { error });
+ * log.success('Completed');
+ * ```
+ */
+
+import logger, { component, type LogLevel } from '@mks2508/better-logger';
+
+/**
+ * Aplica el preset cyberpunk al logger principal.
+ *
+ * Este preset proporciona colores profesionales para operaciones de logging.
+ *
+ * @see {@link https://github.com/mks2508/better-logger | better-logger documentation}
+ */
+logger.preset('cyberpunk');
+
+/**
+ * Logger principal configurado con preset cyberpunk.
+ *
+ * @example
+ * ```typescript
+ * import { logger } from '{{SCOPE}}/utils/logger';
+ *
+ * logger.info('Application started');
+ * logger.success('Operation completed');
+ * ```
+ */
+export { logger };
+
+/**
+ * Crea un logger nombrado para un componente especifico.
+ *
+ * @param name - Nombre del logger/componente
+ * @returns Logger con prefijo de componente
+ *
+ * @example
+ * ```typescript
+ * const log = createLogger('MyService');
+ * log.info('Service started'); // [MyService] Service started
+ * ```
+ */
+export const createLogger = (name: string) => component(name);
+
+/**
+ * Niveles de log disponibles.
+ *
+ * @example
+ * ```typescript
+ * import type { LogLevel } from '{{SCOPE}}/utils/logger';
+ *
+ * const level: LogLevel = 'info';
+ * ```
+ */
+export type { LogLevel };

package/dist/templates/monorepo/core/packages/utils/src/result.ts

@@ -0,0 +1,146 @@
+/**
+ * Result pattern utilities basado en @mks2508/no-throw.
+ *
+ * Proporciona un tipo Result<T, E> para manejo de errores sin excepciones,
+ * junto con funciones auxiliares para trabajar con Results.
+ *
+ * @module
+ *
+ * @example
+ * ```typescript
+ * import { ok, err, tryCatch, type Result } from '{{SCOPE}}/utils/result';
+ *
+ * async function fetchData(url: string): Promise<Result<string, AppError>> {
+ *   const result = await tryCatch(
+ *     async () => {
+ *       const response = await fetch(url);
+ *       return await response.text();
+ *     },
+ *     AppErrorCode.NetworkError
+ *   );
+ *
+ *   if (result.isErr()) {
+ *     return createAppError(
+ *       AppErrorCode.NetworkError,
+ *       `Failed to fetch from ${url}`,
+ *       result.error
+ *     );
+ *   }
+ *
+ *   return ok(result.value);
+ * }
+ * ```
+ */
+
+import {
+  all,
+  collect,
+  err,
+  fail,
+  flatMap,
+  fromPromise,
+  isErr,
+  isOk,
+  map,
+  mapErr,
+  match,
+  ok,
+  tryCatch,
+  tryCatchAsync,
+  unwrap,
+  unwrapOr,
+  unwrapOrElse,
+  type Err,
+  type Ok,
+  type Result,
+  type ResultError,
+} from '@mks2508/no-throw';
+
+export { all };
+export { collect };
+export { err };
+export { fail };
+export { flatMap };
+export { fromPromise };
+export { isErr };
+export { isOk };
+export { map };
+export { mapErr };
+export { match };
+export { ok };
+export { tryCatch };
+export { tryCatchAsync };
+export { unwrap };
+export { unwrapOr };
+export { unwrapOrElse };
+export type { Result };
+export type { Ok };
+export type { Err };
+export type { ResultError };
+
+/**
+ * Codigos de error de aplicacion.
+ *
+ * @example
+ * ```typescript
+ * import { AppErrorCode } from '{{SCOPE}}/utils/result';
+ *
+ * const code: AppErrorCode = AppErrorCode.NetworkError;
+ * ```
+ */
+export const AppErrorCode = {
+  /** Error de red o conexion fallida. */
+  NetworkError: 'NETWORK_ERROR',
+  /** Recurso no encontrado. */
+  NotFound: 'NOT_FOUND',
+  /** Permisos insuficientes. */
+  PermissionDenied: 'PERMISSION_DENIED',
+  /** Error de validacion. */
+  ValidationError: 'VALIDATION_ERROR',
+  /** Operacion cancelada. */
+  Cancelled: 'CANCELLED',
+} as const;
+
+/**
+ * Tipo de codigo de error de aplicacion.
+ */
+export type AppErrorCode = (typeof AppErrorCode)[keyof typeof AppErrorCode];
+
+/**
+ * Crea un error de aplicacion con codigo, mensaje y causa opcional.
+ *
+ * @param code - Codigo de error de AppErrorCode
+ * @param message - Mensaje descriptivo del error
+ * @param cause - Error original que causo el fallo (opcional)
+ * @returns Result con error de aplicacion
+ *
+ * @example
+ * ```typescript
+ * const error = createAppError(
+ *   AppErrorCode.NetworkError,
+ *   'Failed to connect to server',
+ *   originalError
+ * );
+ * ```
+ */
+export const createAppError = (
+  code: AppErrorCode,
+  message: string,
+  cause?: Error
+): Result<never, ResultError<AppErrorCode>> => {
+  return fail(code, message, cause);
+};
+
+/**
+ * Tipo de error de aplicacion.
+ *
+ * @example
+ * ```typescript
+ * import type { AppError } from '{{SCOPE}}/utils/result';
+ *
+ * function handleError(error: AppError) {
+ *   console.log(error.code);
+ * }
+ * ```
+ */
+export type AppError = ResultError<AppErrorCode>;

package/dist/templates/monorepo/core/packages/utils/src/types/constants.ts

@@ -0,0 +1,15 @@
+/**
+ * Constantes compartidas del package {{SCOPE}}/utils.
+ *
+ * @module
+ */
+
+/**
+ * Preset de logger para server-side (Node.js/Bun).
+ */
+export const LOGGER_PRESET = 'cyberpunk' as const;
+
+/**
+ * Nivel de log por defecto.
+ */
+export const DEFAULT_LOG_LEVEL = 'info' as const;

package/dist/templates/monorepo/core/packages/utils/src/types/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Tipos del dominio del package {{SCOPE}}/utils.
+ *
+ * @module
+ */
+
+export * from './utils.types';
+export * from './constants';

package/dist/templates/monorepo/core/packages/utils/src/types/utils.types.ts

@@ -0,0 +1,32 @@
+/**
+ * Tipos especificos del package {{SCOPE}}/utils.
+ *
+ * @module
+ */
+
+/**
+ * Nivel de log disponible.
+ */
+export type LogLevel =
+  | 'debug'
+  | 'info'
+  | 'warn'
+  | 'error'
+  | 'success'
+  | 'critical'
+  | 'trace';
+
+/**
+ * Opciones para crear un logger nombrado.
+ */
+export interface ILoggerOptions {
+  /**
+   * Nombre del logger/componente.
+   */
+  name: string;
+
+  /**
+   * Nivel de log minimo (opcional).
+   */
+  minLevel?: LogLevel;
+}

package/dist/templates/monorepo/core/packages/utils/src/utils/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Utilidades locales del package {{SCOPE}}/utils.
+ *
+ * @module
+ */

package/dist/templates/monorepo/oxlint.json

@@ -0,0 +1,14 @@
+{
+  "categories": {
+    "correctness": "warn",
+    "suspicious": "warn",
+    "perf": "warn",
+    "style": "warn",
+    "restriction": "off"
+  },
+  "env": {
+    "node": true,
+    "es2021": true
+  },
+  "ignore": ["node_modules", "dist", "build", ".turbo", "coverage"]
+}

package/dist/templates/monorepo/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "{{NAME}}-monorepo",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "workspaces": [
+    "core/packages/*",
+    "apps/*"
+  ],
+  "scripts": {
+    "dev": "bun run --filter '*' dev",
+    "build": "bun run --filter '*' build",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "typecheck": "bun run --filter '*' typecheck",
+    "clean": "rm -rf node_modules **/node_modules **/dist **/.turbo",
+    "changeset": "changeset",
+    "changeset:version": "changeset version",
+    "changeset:publish": "changeset publish"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.27.11",
+    "@oxlint/darwin-arm64": "0.11.1",
+    "@types/bun": "^1.1.15",
+    "@types/node": "^22.10.5",
+    "@typescript/native-preview": "^7.0.0-dev.20260106.1",
+    "oxlint": "^0.11.1",
+    "prettier": "^3.4.2",
+    "prettier-plugin-organize-imports": "^4.1.0"
+  },
+  "packageManager": "bun@1.1.43",
+  "dependencies": {
+    "@mks2508/better-logger": "^4.0.0",
+    "@mks2508/no-throw": "^0.1.0",
+    "arktype": "^2.1.29"
+  }
+}

package/dist/templates/monorepo/tsconfig.json

@@ -0,0 +1,35 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "lib": ["ES2022"],
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "allowImportingTsExtensions": true,
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "strictFunctionTypes": true,
+    "strictBindCallApply": true,
+    "strictPropertyInitialization": true,
+    "noImplicitThis": true,
+    "alwaysStrict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": false,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": false,
+    "exactOptionalPropertyTypes": false,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "removeComments": false
+  },
+  "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
+}

package/dist/templates/telegram-bot/.oxlintrc.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": ["typescript", "import"],
+  "env": {
+    "browser": false,
+    "node": true
+  },
+  "categories": {
+    "correctness": "error",
+    "suspicious": "warn",
+    "style": "off",
+    "pedantic": "off",
+    "perf": "warn"
+  },
+  "rules": {
+    "no-unused-vars": "warn",
+    "no-console": "off",
+    "@typescript-eslint/no-explicit-any": "warn",
+    "@typescript-eslint/no-unused-vars": "warn",
+    "@typescript-eslint/prefer-as-const": "error",
+    "import/no-cycle": "error",
+    "import/no-duplicates": "warn"
+  },
+  "overrides": [
+    {
+      "files": ["*.test.ts", "*.spec.ts", "**/__tests__/**"],
+      "rules": {
+        "@typescript-eslint/no-explicit-any": "off"
+      }
+    }
+  ],
+  "ignorePatterns": ["node_modules", "dist", "*.lock"]
+}

package/dist/templates/telegram-bot/.prettierignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+*.lock
+bun.lock
+.git

package/dist/templates/telegram-bot/.prettierrc

@@ -0,0 +1,26 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "useTabs": false,
+  "trailingComma": "es5",
+  "bracketSpacing": true,
+  "arrowParens": "always",
+  "printWidth": 100,
+  "endOfLine": "lf",
+  "overrides": [
+    {
+      "files": "*.json",
+      "options": {
+        "tabWidth": 2
+      }
+    },
+    {
+      "files": ["*.md", "*.mdx"],
+      "options": {
+        "proseWrap": "always",
+        "printWidth": 80
+      }
+    }
+  ]
+}