restructure: console→client-console, add admin-console skeleton, move docs to doc/

2026-05-25 09:48:55 +04:00
parent 3e36ff13a8
commit 34a8068da5
110 changed files with 615 additions and 0 deletions
@@ -0,0 +1,4 @@
+// Package runtime отвечает за подготовку исходного кода функции
+// к загрузке в Fission: упаковка в zip, обёртка ESM для Node.js и т.д.
+// Каждый язык — отдельный файл; общая логика zip — в helpers.go.
+package runtime
@@ -0,0 +1,30 @@
+package runtime
+
+// DefaultEntrypoint возвращает точку входа по умолчанию для языка lang.
+//
+// Формат entrypoint зависит от среды выполнения Fission:
+//   - python: "module.function" → Fission импортирует модуль и вызывает функцию
+//   - nodejs: "main" → имя экспортированной default-функции в main.js
+//   - php:    "main.php::handler" → имя файла + "::" + имя функции
+//   - ruby:   "handler" → имя метода в загруженном файле
+//   - go:     "Handler" → экспортированная Go-функция (с большой буквы)
+func DefaultEntrypoint(lang string) string {
+	switch lang {
+	case "nodejs":
+		// "main" (без .js): node-env.specializeV2 делает split(".") для functionName
+		// с точкой → funcname="js" → ищет экспорт "js" → 500.
+		// Без расширения: funcname=undefined → берёт default export (module.exports = __invoke).
+		return "main"
+	case "php":
+		// Fission php-env: filename::functionName
+		return "main.php::handler"
+	case "ruby":
+		return "handler"
+	case "go":
+		// Go: экспортированная функция (заглавная) — go/plugin требует экспорт
+		return "Handler"
+	default:
+		// python и неизвестные языки: "main.main" = модуль main, функция main
+		return "main.main"
+	}
+}
@@ -0,0 +1,43 @@
+package runtime
+
+import (
+	"archive/zip"
+	"bytes"
+)
+
+// BuildGoSourceZip упаковывает исходный Go-код в zip для Fission source package.
+//
+// Fission Go-среда работает в два этапа:
+//  1. Package создаётся с source.literal = zip(handler.go + go.mod)
+//  2. go-builder job компилирует его в плагин (.so) — это занимает ~40s первый раз
+//
+// Важно: source package, а НЕ deployment package — Fission сам компилирует.
+// Entrypoint по умолчанию "Handler" (экспортированная функция в handler.go).
+func BuildGoSourceZip(code string) ([]byte, error) {
+	var buf bytes.Buffer
+	zw := zip.NewWriter(&buf)
+
+	// handler.go — пользовательский код
+	fw, err := zw.Create("handler.go")
+	if err != nil {
+		return nil, err
+	}
+	if _, err := fw.Write([]byte(code)); err != nil {
+		return nil, err
+	}
+
+	// go.mod — минимальный модуль для сборки; go-builder добавит нужные зависимости
+	goMod := "module github.com/user/fn\n\ngo 1.23\n"
+	fw2, err := zw.Create("go.mod")
+	if err != nil {
+		return nil, err
+	}
+	if _, err := fw2.Write([]byte(goMod)); err != nil {
+		return nil, err
+	}
+
+	if err := zw.Close(); err != nil {
+		return nil, err
+	}
+	return buf.Bytes(), nil
+}
@@ -0,0 +1,52 @@
+package runtime
+
+import (
+	"archive/zip"
+	"bytes"
+)
+
+// buildZip создаёт zip-архив с одним файлом fileName и содержимым content.
+// Вспомогательная функция: используется в buildScriptZip (PHP/Ruby),
+// а также как основа для buildGoSourceZip и buildJSDeployZip.
+func buildZip(fileName string, content []byte) ([]byte, error) {
+	var buf bytes.Buffer
+	zw := zip.NewWriter(&buf)
+
+	fw, err := zw.Create(fileName)
+	if err != nil {
+		return nil, err
+	}
+	if _, err := fw.Write(content); err != nil {
+		return nil, err
+	}
+
+	if err := zw.Close(); err != nil {
+		return nil, err
+	}
+	return buf.Bytes(), nil
+}
+
+// buildZipTwo создаёт zip-архив с двумя файлами.
+// Используется когда пользователь указал файл зависимостей (requirements.txt и т.д.).
+func buildZipTwo(file1, file2 string, content1, content2 []byte) ([]byte, error) {
+	var buf bytes.Buffer
+	zw := zip.NewWriter(&buf)
+
+	for _, f := range []struct {
+		name    string
+		content []byte
+	}{{file1, content1}, {file2, content2}} {
+		fw, err := zw.Create(f.name)
+		if err != nil {
+			return nil, err
+		}
+		if _, err := fw.Write(f.content); err != nil {
+			return nil, err
+		}
+	}
+
+	if err := zw.Close(); err != nil {
+		return nil, err
+	}
+	return buf.Bytes(), nil
+}
@@ -0,0 +1,64 @@
+package runtime
+
+import (
+	"archive/zip"
+	"bytes"
+	"encoding/json"
+	"fmt"
+)
+
+// BuildJSDeployZip упаковывает Node.js код в zip для Fission deployment package.
+//
+// Генерируем CommonJS wrapper: так Fission/node executor не упирается в ESM export
+// синтаксис и может исполнять результат без package.json и type=module.
+// Пользовательский код остаётся CJS-стилем через new Function(module, exports).
+// Wrapper экспортирует main, handler и default через module.exports.
+func BuildJSDeployZip(code string) ([]byte, error) {
+	// Сериализуем пользовательский код в JSON строку чтобы безопасно инлайнить
+	// в JavaScript-литерал — экранирует кавычки, переводы строк, спецсимволы.
+	codeJSON, err := json.Marshal(code)
+	if err != nil {
+		return nil, fmt.Errorf("marshal user code: %w", err)
+	}
+
+	// main.js — CommonJS wrapper:
+	// 1. new Function создаёт функцию в пустом модульном контексте (нет import/export)
+	// 2. Передаём ей module, exports и require как параметры → пользовательский CJS код работает
+	// 3. require передаётся явно, т.к. new Function выполняется в глобальном scope
+	//    и не имеет доступа к module-local require из CJS контекста main.js
+	// 4. Экспортируем main/handler/default через module.exports
+	wrapper := fmt.Sprintf(`const __mod = { exports: {} };
+(new Function('module', 'exports', 'require', %s))(__mod, __mod.exports, require);
+const _fn = __mod.exports;
+
+	async function __invoke(ctx) {
+  const fn = typeof _fn === 'function' ? _fn : (_fn.default || _fn.handler || _fn.main);
+  if (!fn) throw new Error('no exported function found in user code');
+  const result = await fn(ctx);
+  if (!result) return { status: 200, body: '' };
+  if (typeof result.status !== 'undefined') return result;
+  return { status: 200, ...result };
+}
+
+module.exports = __invoke;
+module.exports.main = __invoke;
+module.exports.handler = __invoke;
+module.exports.default = __invoke;
+`, string(codeJSON))
+
+	var buf bytes.Buffer
+	zw := zip.NewWriter(&buf)
+
+	fw, err := zw.Create("main.js")
+	if err != nil {
+		return nil, err
+	}
+	if _, err := fw.Write([]byte(wrapper)); err != nil {
+		return nil, err
+	}
+
+	if err := zw.Close(); err != nil {
+		return nil, err
+	}
+	return buf.Bytes(), nil
+}
@@ -0,0 +1,52 @@
+package runtime
+
+import (
+	"archive/zip"
+	"bytes"
+	"io"
+	"strings"
+	"testing"
+)
+
+func TestBuildJSDeployZipExportsMainAndHandler(t *testing.T) {
+	zipBytes, err := BuildJSDeployZip(`module.exports = async function () { return { status: 200, body: "ok" }; }`)
+	if err != nil {
+		t.Fatalf("BuildJSDeployZip() error = %v", err)
+	}
+
+	zr, err := zip.NewReader(bytes.NewReader(zipBytes), int64(len(zipBytes)))
+	if err != nil {
+		t.Fatalf("zip.NewReader() error = %v", err)
+	}
+
+	files := map[string]string{}
+	for _, file := range zr.File {
+		rc, openErr := file.Open()
+		if openErr != nil {
+			t.Fatalf("open %q: %v", file.Name, openErr)
+		}
+		content, readErr := io.ReadAll(rc)
+		_ = rc.Close()
+		if readErr != nil {
+			t.Fatalf("read %q: %v", file.Name, readErr)
+		}
+		files[file.Name] = string(content)
+	}
+
+	mainJS := files["main.js"]
+	if mainJS == "" {
+		t.Fatalf("main.js not found in zip, files: %v", files)
+	}
+	if !strings.Contains(mainJS, `new Function('module', 'exports', 'require',`) {
+		t.Fatalf("main.js does not pass require to new Function: %s", mainJS)
+	}
+	if !strings.Contains(mainJS, `__mod.exports, require)`) {
+		t.Fatalf("main.js does not forward require: %s", mainJS)
+	}
+	if !strings.Contains(mainJS, `module.exports = __invoke`) {
+		t.Fatalf("main.js does not export __invoke via module.exports: %s", mainJS)
+	}
+	if !strings.Contains(mainJS, `_fn.default || _fn.handler || _fn.main`) {
+		t.Fatalf("main.js lost user export resolution: %s", mainJS)
+	}
+}
@@ -0,0 +1,30 @@
+package runtime
+
+// BuildScriptZip создаёт zip-архив с одним файлом fileName и содержимым code.
+// Используется для PHP и Ruby — языков где среда Fission ожидает
+// именованный файл (handler.rb, handler.pl, main.php и т.д.) внутри архива.
+//
+// Почему zip, а не просто literal:
+// Fission poolmgr при специализации пода распаковывает deployment archive,
+// находит нужный файл по имени и загружает его в среду выполнения.
+// Если передать просто байты кода в deployment.literal — среда не знает расширение.
+func BuildScriptZip(code, fileName string) ([]byte, error) {
+	return buildZip(fileName, []byte(code))
+}
+
+// BuildScriptZipWithDeps создаёт zip с кодом и файлом зависимостей.
+// fileName — имя файла кода (handler.rb, main.php и т.д.)
+// depsName — имя файла зависимостей (Gemfile, composer.json и т.д.)
+func BuildScriptZipWithDeps(code, fileName, deps, depsName string) ([]byte, error) {
+	return buildZipTwo(fileName, depsName, []byte(code), []byte(deps))
+}
+
+// BuildPythonZip создаёт zip с main.py (и опционально requirements.txt).
+// Если deps пустой — возвращает raw bytes кода (текущее поведение Python).
+// Если deps задан — zip с main.py + requirements.txt для pip install.
+func BuildPythonZip(code, deps string) ([]byte, error) {
+	if deps == "" {
+		return []byte(code), nil
+	}
+	return buildZipTwo("main.py", "requirements.txt", []byte(code), []byte(deps))
+}