stack-service-base 0.0.99 → 0.0.100

data/lib/stack-service-base/frontend_template/home/src/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "${service_name}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "engines": {
+    "node": "^24.18.0"
+  },
+  "scripts": {
+    "start": "vite --host 0.0.0.0",
+    "build": "vite build",
+    "build:preview": "vite build --mode preview",
+    "preview": "npm run build:preview && vite preview --host 0.0.0.0 --mode preview",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "check": "npm run typecheck && npm run lint && npm run test && npm run build"
+  },
+  "devDependencies": {
+    "@eslint/js": "9.39.4",
+    "@types/node": "24.13.3",
+    "eslint": "9.39.4",
+    "globals": "15.15.0",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.59.3",
+    "vite": "8.1.5",
+    "vitest": "4.1.10"
+  }
+}

data/lib/stack-service-base/frontend_template/home/src/proxy.config.json

@@ -0,0 +1,8 @@
+{
+  "/api": {
+    "targetEnv": "BACKEND_URL",
+    "secure": true,
+    "changeOrigin": true,
+    "ws": true
+  }
+}

data/lib/stack-service-base/frontend_template/home/src/public/runtime-config.js

@@ -0,0 +1 @@
+window.__APP_CONFIG__ = {};

data/lib/stack-service-base/frontend_template/home/src/tests/build-proxy.test.ts

@@ -0,0 +1,28 @@
+import { describe, expect, it } from 'vitest';
+import { buildProxy } from '../tools/vite/build-proxy';
+
+const rules = {
+  '/api': {
+    targetEnv: 'BACKEND_URL',
+    secure: true,
+    changeOrigin: true,
+    ws: true
+  }
+};
+
+describe('development proxy', () => {
+  it('builds root and prefixed routes for the configured backend', () => {
+    const proxy = buildProxy(
+      { PATH_PREFIX: '/portal', BACKEND_URL: 'https://api.example.com' },
+      rules
+    );
+
+    expect(proxy['/api']?.target).toBe('https://api.example.com');
+    expect(proxy['/portal/api']?.target).toBe('https://api.example.com');
+    expect(proxy['/portal/api']?.rewrite?.('/portal/api/status')).toBe('/api/status');
+  });
+
+  it('does not create routes when the backend is not configured', () => {
+    expect(buildProxy({}, rules)).toEqual({});
+  });
+});

data/lib/stack-service-base/frontend_template/home/src/tests/javascript-support.test.js

@@ -0,0 +1,23 @@
+import { ESLint } from 'eslint';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+import { normalizePathPrefix } from '../tools/vite/path-prefix';
+
+const projectRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+
+describe('JavaScript support', () => {
+  it('allows JavaScript modules to import TypeScript modules', () => {
+    expect(normalizePathPrefix('/team/ui/')).toBe('/team/ui');
+  });
+
+  it('lints application JavaScript with browser globals', async () => {
+    const eslint = new ESLint({ cwd: projectRoot });
+    const [result] = await eslint.lintText(
+      'document.body.dataset.path = window.location.pathname;',
+      { filePath: resolve(projectRoot, 'app/javascript-support.js') }
+    );
+
+    expect(result.messages).toEqual([]);
+  });
+});

data/lib/stack-service-base/frontend_template/home/src/tests/path-prefix.test.ts

@@ -0,0 +1,17 @@
+import { describe, expect, it } from 'vitest';
+import { normalizePathPrefix, pathPrefixBase } from '../tools/vite/path-prefix';
+
+describe('path prefix', () => {
+  it('normalizes empty and nested prefixes', () => {
+    expect(normalizePathPrefix(undefined)).toBe('');
+    expect(normalizePathPrefix(' /team/ui/ ')).toBe('/team/ui');
+    expect(pathPrefixBase('/team/ui')).toBe('/team/ui/');
+  });
+
+  it.each(['/api', '/assets', '/healthcheck', '/team//ui', '/../admin', '/admin?debug=true'])(
+    'rejects an unsafe or runtime-reserved prefix: %s',
+    (pathPrefix) => {
+      expect(() => normalizePathPrefix(pathPrefix)).toThrow();
+    }
+  );
+});

data/lib/stack-service-base/frontend_template/home/src/tests/runtime-config.test.ts

@@ -0,0 +1,22 @@
+import { describe, expect, it } from 'vitest';
+import { buildRuntimeConfigFromEnv } from '../tools/vite/runtime-config';
+
+describe('runtime config', () => {
+  it('exposes only the documented browser-visible values', () => {
+    const runtimeConfig = buildRuntimeConfigFromEnv({
+      PATH_PREFIX: ' /team/ui/ ',
+      API_BASE_URL: ' /team/ui/api ',
+      LOG_LEVEL: ' debug ',
+      BACKEND_URL: 'https://internal-api.example.com',
+      AUTH_PASS: 'must-not-be-public'
+    });
+
+    expect(runtimeConfig).toEqual({
+      PATH_PREFIX: '/team/ui',
+      API_BASE_URL: '/team/ui/api',
+      LOG_LEVEL: 'debug'
+    });
+    expect(JSON.stringify(runtimeConfig)).not.toContain('internal-api');
+    expect(JSON.stringify(runtimeConfig)).not.toContain('must-not-be-public');
+  });
+});

data/lib/stack-service-base/frontend_template/home/src/tests/vite-config.test.ts

@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'vitest';
+import { buildBase } from '../vite.config';
+
+describe('buildBase', () => {
+  it('keeps the runtime placeholder in a container build', () => {
+    expect(buildBase('build', 'production', '/team/ui')).toBe('/__PATH_PREFIX__/');
+  });
+
+  it('uses the configured prefix in a local production preview', () => {
+    expect(buildBase('build', 'preview', '/team/ui')).toBe('/team/ui/');
+  });
+
+  it('uses the configured prefix in development', () => {
+    expect(buildBase('serve', 'development', '/team/ui')).toBe('/team/ui/');
+  });
+});

data/lib/stack-service-base/frontend_template/home/src/tools/vite/build-proxy.ts

@@ -0,0 +1,62 @@
+import type { ProxyOptions } from 'vite';
+import { normalizePathPrefix } from './path-prefix';
+
+const DEFAULT_PROXY_OPTIONS: ProxyOptions = {
+  cookieDomainRewrite: '',
+  secure: true,
+  changeOrigin: true
+};
+
+export type ProxyRuleConfig = {
+  targetEnv: string;
+  secure?: boolean;
+  changeOrigin?: boolean;
+  ws?: boolean;
+  pathRewrite?: Record<string, string>;
+};
+
+export function buildProxy(
+  env: Record<string, string>,
+  rules: Record<string, ProxyRuleConfig>
+): Record<string, ProxyOptions> {
+  const proxy: Record<string, ProxyOptions> = {};
+  const pathPrefix = normalizePathPrefix(env.PATH_PREFIX);
+
+  for (const [context, rule] of Object.entries(rules)) {
+    const target = env[rule.targetEnv];
+    if (!target) continue;
+
+    proxy[context] = createProxyOptions(target, rule);
+    if (pathPrefix) proxy[`${pathPrefix}${context}`] = createProxyOptions(target, rule, pathPrefix);
+  }
+
+  return proxy;
+}
+
+function createProxyOptions(target: string, rule: ProxyRuleConfig, pathPrefix = ''): ProxyOptions {
+  const { pathRewrite, targetEnv: _targetEnv, ...overrides } = rule;
+  const shouldRewrite = Boolean(pathPrefix || pathRewrite);
+
+  return {
+    target,
+    ...DEFAULT_PROXY_OPTIONS,
+    ...overrides,
+    ...(shouldRewrite ? { rewrite: (path: string) => rewritePath(stripPathPrefix(path, pathPrefix), pathRewrite) } : {})
+  };
+}
+
+function stripPathPrefix(path: string, pathPrefix: string): string {
+  if (!pathPrefix || !path.startsWith(`${pathPrefix}/`)) return path;
+  return path.slice(pathPrefix.length) || '/';
+}
+
+function rewritePath(path: string, pathRewrite?: Record<string, string>): string {
+  if (!pathRewrite) return path;
+
+  for (const [from, to] of Object.entries(pathRewrite)) {
+    const rewrittenPath = path.replace(new RegExp(from), to);
+    if (rewrittenPath !== path) return rewrittenPath;
+  }
+
+  return path;
+}

data/lib/stack-service-base/frontend_template/home/src/tools/vite/path-prefix.ts

@@ -0,0 +1,27 @@
+const PATH_PREFIX_PATTERN = /^[A-Za-z0-9_/-]+$/u;
+const RESERVED_PATH_PREFIXES = new Set(['/api', '/assets', '/healthcheck']);
+
+export function normalizePathPrefix(value: string | undefined): string {
+  const normalized = value?.trim().replace(/^\/+|\/+$/gu, '') ?? '';
+
+  if (!normalized) {
+    return '';
+  }
+
+  if (!PATH_PREFIX_PATTERN.test(normalized) || normalized.includes('//') || normalized.split('/').includes('..')) {
+    throw new Error(`Invalid PATH_PREFIX: ${value}`);
+  }
+
+  const pathPrefix = `/${normalized}`;
+
+  if (RESERVED_PATH_PREFIXES.has(pathPrefix)) {
+    throw new Error(`PATH_PREFIX is reserved by the service runtime: ${pathPrefix}`);
+  }
+
+  return pathPrefix;
+}
+
+export function pathPrefixBase(value: string | undefined): string {
+  const pathPrefix = normalizePathPrefix(value);
+  return pathPrefix ? `${pathPrefix}/` : '/';
+}

data/lib/stack-service-base/frontend_template/home/src/tools/vite/runtime-config-dev-plugin.ts

@@ -0,0 +1,27 @@
+import type { Plugin } from 'vite';
+import { buildRuntimeConfigFromEnv } from './runtime-config';
+import { normalizePathPrefix } from './path-prefix';
+
+export function runtimeConfigDevPlugin(env: Record<string, string>): Plugin {
+  const pathPrefix = normalizePathPrefix(env.PATH_PREFIX);
+  const runtimeConfigPath = `${pathPrefix}/runtime-config.js`;
+
+  return {
+    name: 'runtime-config-dev',
+    configureServer(server) {
+      server.middlewares.use((request, response, next) => {
+        const requestPath = request.url?.split('?', 1)[0];
+
+        if (requestPath !== runtimeConfigPath) {
+          next();
+          return;
+        }
+
+        const runtimeConfig = buildRuntimeConfigFromEnv(env);
+        response.setHeader('Content-Type', 'application/javascript; charset=utf-8');
+        response.setHeader('Cache-Control', 'no-store');
+        response.end(`window.__APP_CONFIG__ = ${JSON.stringify(runtimeConfig)};`);
+      });
+    }
+  };
+}

data/lib/stack-service-base/frontend_template/home/src/tools/vite/runtime-config.ts

@@ -0,0 +1,10 @@
+import type { RuntimeConfig } from '../../app/runtime-config.types';
+import { normalizePathPrefix } from './path-prefix';
+
+export function buildRuntimeConfigFromEnv(env: Record<string, string>): RuntimeConfig {
+  return {
+    PATH_PREFIX: normalizePathPrefix(env.PATH_PREFIX),
+    API_BASE_URL: env.API_BASE_URL?.trim() ?? '',
+    LOG_LEVEL: env.LOG_LEVEL?.trim() || 'info'
+  };
+}

data/lib/stack-service-base/frontend_template/home/src/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitAny": true,
+    "useDefineForClassFields": false,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "checkJs": false,
+    "noEmit": true
+  },
+  "include": [
+    "app/**/*.js",
+    "app/**/*.ts",
+    "tests/**/*.js",
+    "tests/**/*.ts",
+    "tools/**/*.js",
+    "tools/**/*.ts"
+  ],
+  "exclude": ["node_modules", "dist"]
+}

data/lib/stack-service-base/frontend_template/home/src/vite.config.ts

@@ -0,0 +1,40 @@
+import { defineConfig, loadEnv } from 'vite';
+import proxyRules from './proxy.config.json';
+import { buildProxy } from './tools/vite/build-proxy';
+import { runtimeConfigDevPlugin } from './tools/vite/runtime-config-dev-plugin';
+import { pathPrefixBase } from './tools/vite/path-prefix';
+
+const DEPLOY_PATH_PLACEHOLDER = '/__PATH_PREFIX__/';
+
+export function buildBase(
+  command: 'build' | 'serve',
+  mode: string,
+  pathPrefix: string | undefined
+): string {
+  const isContainerBuild = command === 'build' && mode !== 'preview';
+
+  return isContainerBuild ? DEPLOY_PATH_PLACEHOLDER : pathPrefixBase(pathPrefix);
+}
+
+export default defineConfig(({ command, mode }) => {
+  const env = loadEnv(mode, '.', '');
+
+  return {
+    base: buildBase(command, mode, env.PATH_PREFIX),
+    plugins: [runtimeConfigDevPlugin(env)],
+    build: {
+      outDir: 'dist',
+      emptyOutDir: true
+    },
+    server: {
+      port: 3000,
+      strictPort: true,
+      open: false,
+      proxy: buildProxy(env, proxyRules)
+    },
+    preview: {
+      port: 3000,
+      strictPort: true
+    }
+  };
+});

data/lib/stack-service-base/version.rb

@@ -1,3 +1,3 @@
 module StackServiceBase
-  VERSION = '0.0.99'
+  VERSION = '0.0.100'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stack-service-base
 version: !ruby/object:Gem::Version
-  version: 0.0.99
+  version: 0.0.100
 platform: ruby
 authors:
 - Artyom B
@@ -418,6 +418,52 @@ files:
 - lib/stack-service-base/env_fetch.rb
 - lib/stack-service-base/examples/mcp_config.ru
 - lib/stack-service-base/fiber_pool.rb
+- lib/stack-service-base/frontend_template/github/.github/workflows/main.yml
+- lib/stack-service-base/frontend_template/github/docker/docker-compose.yml
+- lib/stack-service-base/frontend_template/gitlab-c/.gitlab-ci.yml
+- lib/stack-service-base/frontend_template/gitlab-c/docker/Dockerfile.build
+- lib/stack-service-base/frontend_template/gitlab-c/docker/docker-compose.yml
+- lib/stack-service-base/frontend_template/gitlab-c/docker/local_build.sh
+- lib/stack-service-base/frontend_template/gitlab/.gitlab-ci.yml
+- lib/stack-service-base/frontend_template/gitlab/docker/Dockerfile.build
+- lib/stack-service-base/frontend_template/gitlab/docker/docker-compose.yml
+- lib/stack-service-base/frontend_template/gitlab/docker/local_build.sh
+- lib/stack-service-base/frontend_template/home/.editorconfig
+- lib/stack-service-base/frontend_template/home/.gitattributes
+- lib/stack-service-base/frontend_template/home/.gitignore
+- lib/stack-service-base/frontend_template/home/AGENTS.md
+- lib/stack-service-base/frontend_template/home/README.md
+- lib/stack-service-base/frontend_template/home/docker/.env
+- lib/stack-service-base/frontend_template/home/docker/frontend/15-runtime-settings.envsh
+- lib/stack-service-base/frontend_template/home/docker/frontend/40-path-prefix-settings.sh
+- lib/stack-service-base/frontend_template/home/docker/frontend/45-runtime-config-settings.sh
+- lib/stack-service-base/frontend_template/home/docker/frontend/Dockerfile
+- lib/stack-service-base/frontend_template/home/docker/frontend/nginx.conf.template
+- lib/stack-service-base/frontend_template/home/src/.dockerignore
+- lib/stack-service-base/frontend_template/home/src/.env.example
+- lib/stack-service-base/frontend_template/home/src/.version
+- lib/stack-service-base/frontend_template/home/src/app/main.ts
+- lib/stack-service-base/frontend_template/home/src/app/runtime-config.ts
+- lib/stack-service-base/frontend_template/home/src/app/runtime-config.types.ts
+- lib/stack-service-base/frontend_template/home/src/app/style.css
+- lib/stack-service-base/frontend_template/home/src/app/vite-env.d.ts
+- lib/stack-service-base/frontend_template/home/src/eslint.config.js
+- lib/stack-service-base/frontend_template/home/src/index.html
+- lib/stack-service-base/frontend_template/home/src/package-lock.json
+- lib/stack-service-base/frontend_template/home/src/package.json
+- lib/stack-service-base/frontend_template/home/src/proxy.config.json
+- lib/stack-service-base/frontend_template/home/src/public/runtime-config.js
+- lib/stack-service-base/frontend_template/home/src/tests/build-proxy.test.ts
+- lib/stack-service-base/frontend_template/home/src/tests/javascript-support.test.js
+- lib/stack-service-base/frontend_template/home/src/tests/path-prefix.test.ts
+- lib/stack-service-base/frontend_template/home/src/tests/runtime-config.test.ts
+- lib/stack-service-base/frontend_template/home/src/tests/vite-config.test.ts
+- lib/stack-service-base/frontend_template/home/src/tools/vite/build-proxy.ts
+- lib/stack-service-base/frontend_template/home/src/tools/vite/path-prefix.ts
+- lib/stack-service-base/frontend_template/home/src/tools/vite/runtime-config-dev-plugin.ts
+- lib/stack-service-base/frontend_template/home/src/tools/vite/runtime-config.ts
+- lib/stack-service-base/frontend_template/home/src/tsconfig.json
+- lib/stack-service-base/frontend_template/home/src/vite.config.ts
 - lib/stack-service-base/logging.rb
 - lib/stack-service-base/mcp/mcp_helper.rb
 - lib/stack-service-base/mcp/mcp_processor.rb