@lovrozagar/honey 0.6.8 → 0.7.0

package/dist/build/index.js

@@ -0,0 +1,173 @@
+import { existsSync, readFileSync } from "node:fs";
+import { builtinModules } from "node:module";
+import { extname, resolve } from "node:path";
+import { detectFeaturesInSource, FEATURES, featurePrelude, scanProgram } from "../feature-detect.js";
+/* ---- Entry helpers ---- */
+function importApp(entry, exportName) {
+    if (exportName === "default")
+        return `import app from "./${entry}"`;
+    return `import { ${exportName} as app } from "./${entry}"`;
+}
+/* server targets start through the same code path as `app.serve()`: WS adapter, env, hostname */
+function serverEntry(config, runtime, env, port) {
+    return [
+        'import { startHoneyServer } from "@lovrozagar/honey/serve"',
+        importApp(config.entry, config.export),
+        "",
+        `const port = Number(${port})`,
+        `await startHoneyServer(app, { env: ${env}, hostname: "0.0.0.0", port, runtime: "${runtime}" })`,
+    ].join("\n");
+}
+/* ---- Adapter definitions ---- */
+const adapters = {
+    bun: {
+        entry: (config) => serverEntry(config, "bun", "process.env", `process.env.PORT ?? ${config.port}`),
+        noExternal: false,
+        skipFeatures: [],
+        ssrTarget: "node",
+    },
+    cloudflare: {
+        entry(config) {
+            return [
+                importApp(config.entry, config.export),
+                "",
+                "export default {",
+                "  fetch: (req, env, ctx) => app.fetch(req, env, ctx),",
+                "}",
+            ].join("\n");
+        },
+        noExternal: true,
+        /* a Worker cannot listen; serve would pull node:http into the bundle */
+        skipFeatures: ["serve"],
+        ssrTarget: "webworker",
+    },
+    deno: {
+        entry: (config) => serverEntry(config, "deno", "Deno.env.toObject()", `Deno.env.get("PORT") ?? "${config.port}"`),
+        noExternal: true,
+        skipFeatures: [],
+        ssrTarget: "webworker",
+    },
+    node: {
+        entry: (config) => serverEntry(config, "node", "process.env", `process.env.PORT ?? ${config.port}`),
+        noExternal: false,
+        skipFeatures: [],
+        ssrTarget: "node",
+    },
+};
+/* ---- Feature detection over the import graph ---- */
+const SCANNED_EXT = /\.(?:[cm]?[jt]sx?)$/;
+function langOf(file) {
+    const ext = extname(file);
+    if (ext === ".tsx")
+        return "tsx";
+    if (ext === ".jsx")
+        return "jsx";
+    return /^\.[cm]?ts$/.test(ext) ? "ts" : "js";
+}
+/**
+ * Walks the app's own modules (never node_modules) from `entry`, following static and dynamic
+ * imports, and collects feature calls. Comments and strings do not count.
+ */
+async function detectGraphFeatures(ctx, entry) {
+    const features = new Set();
+    const seen = new Set();
+    const queue = [entry];
+    while (queue.length > 0) {
+        const file = queue.pop();
+        if (seen.has(file))
+            continue;
+        seen.add(file);
+        if (!SCANNED_EXT.test(file) || file.includes("node_modules") || !existsSync(file))
+            continue;
+        const code = readFileSync(file, "utf-8");
+        let imports = [];
+        let program;
+        try {
+            program = ctx.parse?.(code, { lang: langOf(file) });
+        }
+        catch {
+            program = undefined;
+        }
+        if (program) {
+            const scanned = scanProgram(program);
+            for (const f of scanned.features)
+                features.add(f);
+            imports = scanned.imports;
+        }
+        else {
+            for (const f of detectFeaturesInSource(code))
+                features.add(f);
+        }
+        if (!ctx.resolve)
+            continue;
+        for (const source of imports) {
+            const resolved = await ctx.resolve(source, file).catch(() => null);
+            if (!resolved || resolved.external || resolved.id.startsWith("\0"))
+                continue;
+            queue.push(resolved.id.split("?")[0]);
+        }
+    }
+    return features;
+}
+/* ---- Virtual module constants ---- */
+const VIRTUAL_BUILD_ENTRY = "virtual:honey-build-entry";
+const RESOLVED_BUILD_ENTRY = `\0${VIRTUAL_BUILD_ENTRY}`;
+/* ---- Build plugin factory ---- */
+export function createBuildPlugin(buildConfig, shared) {
+    const adapter = adapters[buildConfig.target];
+    const resolvedConfig = {
+        entry: shared.entry,
+        export: shared.export,
+        port: buildConfig.port ?? 3000,
+    };
+    let root = "";
+    return {
+        apply: "build",
+        config() {
+            return {
+                build: {
+                    emptyOutDir: false,
+                    minify: buildConfig.minify ?? true,
+                    outDir: buildConfig.outDir ?? "./dist",
+                    rolldownOptions: {
+                        external: [...builtinModules, ...builtinModules.map((m) => `node:${m}`), ...(buildConfig.external ?? [])],
+                        input: VIRTUAL_BUILD_ENTRY,
+                        output: { entryFileNames: "index.js" },
+                    },
+                    ssr: true,
+                },
+                ssr: {
+                    /* node and bun install dependencies next to the bundle; inlining them would also inline native addons */
+                    ...(adapter.noExternal ? { noExternal: true } : {}),
+                    target: adapter.ssrTarget,
+                },
+            };
+        },
+        configResolved(cfg) {
+            root = cfg.root;
+        },
+        async load(id) {
+            if (id !== RESOLVED_BUILD_ENTRY)
+                return undefined;
+            const appPath = resolve(root || ".", shared.entry);
+            const detected = await detectGraphFeatures(this ?? {}, appPath);
+            const features = FEATURES.filter((feature) => {
+                if (adapter.skipFeatures.includes(feature))
+                    return false;
+                return buildConfig.features?.[feature] ?? detected.has(feature);
+            });
+            const prelude = featurePrelude(features);
+            return {
+                code: `${prelude ? `${prelude}\n` : ""}${adapter.entry(resolvedConfig)}`,
+                moduleType: "js",
+            };
+        },
+        name: "honey:build",
+        resolveId(id) {
+            if (id === VIRTUAL_BUILD_ENTRY)
+                return RESOLVED_BUILD_ENTRY;
+            return undefined;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/build/index.ts"],"names":[],"mappings":"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"}

package/dist/cli-args.d.ts

@@ -0,0 +1,33 @@
+/** Argument parsing for the `honey` CLI. Not a package export. */
+export declare const USAGE = "Usage: honey generate [options]\n       honey init [--cf] [--force]\n\ngenerate options:\n  --config <path>          Vite config holding honey() (default: vite.config.{ts,mts,js,mjs,\u2026})\n  --plugin <n>             Which honey() plugin in the config, 0-based (when there are several)\n  --app <path>             App entry; overrides the config's app, or replaces the config\n  --watch                  Regenerate when files next to the app change\n  --tree --types --manifest --sdk\n                           Turn on an output\n  --merge-tree <path>      Route tree source for a gateway\n  --cli --cli-out <dir> --cli-binary-name <name> [--cli-config-name <name>]\n      [--cli-default-base-url <url>] [--cli-env-prefix <prefix>] [--cli-module-path <path>]\n      [--cli-sdk-module-path <path>]\n                           Generate the Go CLI\n  -h, --help               Show this help";
+export declare class UsageError extends Error {
+}
+export type CliFlags = {
+    app?: string;
+    cli?: boolean;
+    cliBinaryName?: string;
+    cliConfigName?: string;
+    cliDefaultBaseUrl?: string;
+    cliEnvPrefix?: string;
+    cliModulePath?: string;
+    cliOut?: string;
+    cliSdkModulePath?: string;
+    config?: string;
+    help?: boolean;
+    manifest?: boolean;
+    mergeTree?: string;
+    plugin?: number;
+    sdk?: boolean;
+    tree?: boolean;
+    types?: boolean;
+    watch?: boolean;
+};
+/** Strict: unknown flags, stray positionals and missing values are errors. Accepts `--k v` and `--k=v`. */
+export declare function parseGenerateArgs(args: string[]): CliFlags;
+/** `honey init` flags. `--cloudflare` is an alias of `--cf`. */
+export type InitFlags = {
+    cf: boolean;
+    force: boolean;
+};
+export declare function parseInitFlags(args: string[]): InitFlags;
+//# sourceMappingURL=cli-args.d.ts.map

package/dist/cli-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../src/cli-args.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,eAAO,MAAM,KAAK,+3BAewB,CAAA;AAE1C,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAExC,MAAM,MAAM,QAAQ,GAAG;IACtB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;CACf,CAAA;AA0BD,2GAA2G;AAC3G,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,CAuC1D;AAED,gEAAgE;AAChE,MAAM,MAAM,SAAS,GAAG;IACvB,EAAE,EAAE,OAAO,CAAA;IACX,KAAK,EAAE,OAAO,CAAA;CACd,CAAA;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAQxD"}

package/dist/cli-args.js

@@ -0,0 +1,102 @@
+/** Argument parsing for the `honey` CLI. Not a package export. */
+export const USAGE = `Usage: honey generate [options]
+       honey init [--cf] [--force]
+
+generate options:
+  --config <path>          Vite config holding honey() (default: vite.config.{ts,mts,js,mjs,…})
+  --plugin <n>             Which honey() plugin in the config, 0-based (when there are several)
+  --app <path>             App entry; overrides the config's app, or replaces the config
+  --watch                  Regenerate when files next to the app change
+  --tree --types --manifest --sdk
+                           Turn on an output
+  --merge-tree <path>      Route tree source for a gateway
+  --cli --cli-out <dir> --cli-binary-name <name> [--cli-config-name <name>]
+      [--cli-default-base-url <url>] [--cli-env-prefix <prefix>] [--cli-module-path <path>]
+      [--cli-sdk-module-path <path>]
+                           Generate the Go CLI
+  -h, --help               Show this help`;
+export class UsageError extends Error {
+}
+const BOOLEAN_FLAGS = {
+    cli: "cli",
+    help: "help",
+    manifest: "manifest",
+    sdk: "sdk",
+    tree: "tree",
+    types: "types",
+    watch: "watch",
+};
+const VALUE_FLAGS = {
+    app: "app",
+    "cli-binary-name": "cliBinaryName",
+    "cli-config-name": "cliConfigName",
+    "cli-default-base-url": "cliDefaultBaseUrl",
+    "cli-env-prefix": "cliEnvPrefix",
+    "cli-module-path": "cliModulePath",
+    "cli-out": "cliOut",
+    "cli-sdk-module-path": "cliSdkModulePath",
+    config: "config",
+    "merge-tree": "mergeTree",
+    plugin: "plugin",
+};
+/** Strict: unknown flags, stray positionals and missing values are errors. Accepts `--k v` and `--k=v`. */
+export function parseGenerateArgs(args) {
+    const flags = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "-h") {
+            flags.help = true;
+            continue;
+        }
+        if (!arg.startsWith("--") || arg === "--")
+            throw new UsageError(`unexpected argument: ${arg}`);
+        const eq = arg.indexOf("=");
+        const name = eq === -1 ? arg.slice(2) : arg.slice(2, eq);
+        const inline = eq === -1 ? undefined : arg.slice(eq + 1);
+        const bool = BOOLEAN_FLAGS[name];
+        if (bool) {
+            if (inline === undefined || inline === "true")
+                flags[bool] = true;
+            else if (inline === "false")
+                flags[bool] = false;
+            else
+                throw new UsageError(`--${name} takes no value (got "${inline}")`);
+            continue;
+        }
+        const key = VALUE_FLAGS[name];
+        if (!key)
+            throw new UsageError(`unknown option: --${name}`);
+        let value = inline;
+        if (value === undefined) {
+            const next = args[i + 1];
+            if (next === undefined || next.startsWith("--"))
+                throw new UsageError(`--${name} requires a value`);
+            value = next;
+            i++;
+        }
+        if (value === "")
+            throw new UsageError(`--${name} requires a value`);
+        if (key === "plugin") {
+            if (!/^\d+$/.test(value))
+                throw new UsageError(`--plugin takes a non-negative integer (got "${value}")`);
+            flags.plugin = Number(value);
+        }
+        else {
+            flags[key] = value;
+        }
+    }
+    return flags;
+}
+export function parseInitFlags(args) {
+    const flags = { cf: false, force: false };
+    for (const arg of args) {
+        if (arg === "--cf" || arg === "--cloudflare")
+            flags.cf = true;
+        else if (arg === "--force")
+            flags.force = true;
+        else
+            throw new UsageError(arg.startsWith("-") ? `unknown option: ${arg}` : `unexpected argument: ${arg}`);
+    }
+    return flags;
+}
+//# sourceMappingURL=cli-args.js.map

package/dist/cli-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args.js","sourceRoot":"","sources":["../src/cli-args.ts"],"names":[],"mappings":"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"}

package/dist/cli-go/auth.go

@@ -0,0 +1,26 @@
+// Code generated by honey. DO NOT EDIT.
+package cli
+
+import (
+	"errors"
+	"net/http"
+)
+
+// ErrMissingAPIKey is returned when no API key can be found via flags, env, or config file.
+var ErrMissingAPIKey = errors.New("api key required: set --api-key, env var, or config file")
+
+// ResolveAPIKey returns the resolved API key or ErrMissingAPIKey if none is available.
+func ResolveAPIKey(cfg Config) (string, error) {
+	if cfg.APIKey != "" {
+		return cfg.APIKey, nil
+	}
+	return "", ErrMissingAPIKey
+}
+
+// ApplyAuth sets the auth header for apiKey: prefix + key under headerName.
+func ApplyAuth(h http.Header, headerName, prefix, apiKey string) {
+	if apiKey == "" {
+		return
+	}
+	h.Set(headerName, prefix+apiKey)
+}

package/dist/cli-go/config.go

@@ -0,0 +1,192 @@
+// Code generated by honey. DO NOT EDIT.
+package cli
+
+import (
+	"errors"
+	"fmt"
+	"io"
+	"io/fs"
+	"os"
+	"path/filepath"
+	"runtime"
+
+	"github.com/pelletier/go-toml/v2"
+	"github.com/spf13/pflag"
+)
+
+// Config holds resolved runtime values for the CLI binary.
+//
+// Precedence (high → low) — see LoadConfig below:
+//
+//  1. --api-key / --base-url / --output / … flag set on the command line.
+//  2. Env var: <ENV_PREFIX>_API_KEY / _BASE_URL / _OUTPUT / …
+//  3. Config file from --config, $<ENV_PREFIX>_CONFIG, $XDG_CONFIG_HOME/<name>/config.toml,
+//     $HOME/.config/<name>/config.toml, os.UserConfigDir()/<name>/config.toml.
+//  4. Built-in defaults.
+//  5. (missing api-key → ErrMissingAPIKey, mapped to exit 4).
+type Config struct {
+	APIKey     string
+	BaseURL    string
+	Output     string
+	Timeout    string
+	Verbose    bool
+	ConfigPath string
+}
+
+type tomlConfig struct {
+	APIKey  string `toml:"api_key"`
+	BaseURL string `toml:"base_url"`
+	Output  string `toml:"output"`
+	Timeout string `toml:"timeout"`
+}
+
+// LoadConfig merges flag values, env vars, and a TOML config file into a Config.
+//
+// The resolution order matches the Config doc-comment precedence list.
+func LoadConfig(flags *pflag.FlagSet, envPrefix, configName string) (Config, error) {
+	var cfg Config
+
+	cfgPath := ""
+	explicit := false
+	if flags.Changed("config") {
+		v, _ := flags.GetString("config")
+		cfgPath = v
+		explicit = true
+	} else if v := os.Getenv(envPrefix + "_CONFIG"); v != "" {
+		cfgPath = v
+		explicit = true
+	} else {
+		cfgPath = defaultConfigPath(configName)
+	}
+
+	var fromFile tomlConfig
+	if cfgPath != "" {
+		data, err := os.ReadFile(cfgPath)
+		switch {
+		case err == nil:
+			if err := toml.Unmarshal(data, &fromFile); err != nil {
+				return cfg, Usage(fmt.Errorf("parse config %s: %w", cfgPath, err))
+			}
+			warnIfReadableByOthers(cfgPath, fromFile.APIKey != "")
+		case explicit || !errors.Is(err, fs.ErrNotExist):
+			/* a config the user named must exist; only the default path may be absent */
+			return cfg, Usage(fmt.Errorf("read config %s: %w", cfgPath, err))
+		}
+	}
+	cfg.ConfigPath = cfgPath
+
+	cfg.APIKey = fromFile.APIKey
+	if v := os.Getenv(envPrefix + "_API_KEY"); v != "" {
+		cfg.APIKey = v
+	}
+	if flags.Changed("api-key") {
+		v, _ := flags.GetString("api-key")
+		cfg.APIKey = v
+	}
+
+	cfg.BaseURL = fromFile.BaseURL
+	if v := os.Getenv(envPrefix + "_BASE_URL"); v != "" {
+		cfg.BaseURL = v
+	}
+	if flags.Changed("base-url") {
+		v, _ := flags.GetString("base-url")
+		cfg.BaseURL = v
+	}
+
+	cfg.Output = fromFile.Output
+	if v := os.Getenv(envPrefix + "_OUTPUT"); v != "" {
+		cfg.Output = v
+	}
+	if flags.Changed("output") {
+		v, _ := flags.GetString("output")
+		cfg.Output = v
+	}
+	if cfg.Output == "" {
+		cfg.Output = "json"
+	}
+
+	cfg.Timeout = fromFile.Timeout
+	if v := os.Getenv(envPrefix + "_TIMEOUT"); v != "" {
+		cfg.Timeout = v
+	}
+	if flags.Changed("timeout") {
+		v, _ := flags.GetString("timeout")
+		cfg.Timeout = v
+	}
+	if cfg.Timeout == "" {
+		cfg.Timeout = "30s"
+	}
+
+	if flags.Changed("verbose") {
+		v, _ := flags.GetBool("verbose")
+		cfg.Verbose = v
+	}
+
+	return cfg, nil
+}
+
+// warnIfReadableByOthers warns when a config file holding an API key can be
+// read by group or other users.
+func warnIfReadableByOthers(path string, hasKey bool) {
+	if !hasKey || runtime.GOOS == "windows" {
+		return
+	}
+	info, err := os.Stat(path)
+	if err != nil {
+		return
+	}
+	if info.Mode().Perm()&0o077 != 0 {
+		fmt.Fprintf(os.Stderr, "warning: %s holds an API key and is readable by other users; run: chmod 600 %s\n", path, path)
+	}
+}
+
+func defaultConfigPath(configName string) string {
+	if configName == "" {
+		return ""
+	}
+	if xdg := os.Getenv("XDG_CONFIG_HOME"); xdg != "" {
+		return filepath.Join(xdg, configName, "config.toml")
+	}
+	if home := os.Getenv("HOME"); home != "" {
+		return filepath.Join(home, ".config", configName, "config.toml")
+	}
+	if dir, err := os.UserConfigDir(); err == nil {
+		return filepath.Join(dir, configName, "config.toml")
+	}
+	return ""
+}
+
+// readDataFlag resolves the value of a --data flag into raw bytes.
+//
+// Rules:
+//   - "@path"        → reads file at path.
+//   - "-"            → reads os.Stdin.
+//   - ""             → returns nil, nil (caller decides whether required).
+//   - anything else  → treats val as literal JSON.
+//
+// Exported as ReadDataFlag for use from cmd/*.go.
+func ReadDataFlag(val string) ([]byte, error) {
+	return readDataFlag(val)
+}
+
+func readDataFlag(val string) ([]byte, error) {
+	if val == "" {
+		return nil, nil
+	}
+	if val == "-" {
+		data, err := io.ReadAll(os.Stdin)
+		if err != nil {
+			return nil, fmt.Errorf("read stdin: %w", err)
+		}
+		return data, nil
+	}
+	if val[0] == '@' {
+		path := val[1:]
+		data, err := os.ReadFile(path)
+		if err != nil {
+			return nil, fmt.Errorf("read data file %s: %w", path, err)
+		}
+		return data, nil
+	}
+	return []byte(val), nil
+}

package/dist/cli-go/errors.go

@@ -0,0 +1,75 @@
+// Code generated by honey. DO NOT EDIT.
+package cli
+
+import (
+	"context"
+	"errors"
+	"net"
+)
+
+// UsageError marks bad flags, bad config and invalid input; it maps to exit 4.
+type UsageError struct{ Err error }
+
+func (e *UsageError) Error() string { return e.Err.Error() }
+func (e *UsageError) Unwrap() error { return e.Err }
+
+// Usage wraps err as a UsageError.
+func Usage(err error) error {
+	if err == nil {
+		return nil
+	}
+	return &UsageError{Err: err}
+}
+
+// ExitFor maps a CLI-level error to a process exit code.
+//
+// Codes:
+//
+//	0  success
+//	1  4xx client error
+//	2  5xx server error
+//	3  network / transport failure or timeout
+//	4  bad flags / bad config / missing api key
+//	5  3xx unexpected redirect
+func ExitFor(err error) int {
+	if err == nil {
+		return 0
+	}
+	if errors.Is(err, ErrMissingAPIKey) {
+		return 4
+	}
+	var usage *UsageError
+	if errors.As(err, &usage) {
+		return 4
+	}
+
+	/* SDK errors expose Status() (APIError) */
+	var apiErr interface{ Status() int }
+	if errors.As(err, &apiErr) {
+		return exitForStatus(apiErr.Status())
+	}
+
+	if errors.Is(err, context.DeadlineExceeded) || errors.Is(err, context.Canceled) {
+		return 3
+	}
+	var netErr net.Error
+	if errors.As(err, &netErr) {
+		return 3
+	}
+	return 3
+}
+
+func exitForStatus(status int) int {
+	switch {
+	case status == 0:
+		return 3
+	case status >= 300 && status < 400:
+		return 5
+	case status >= 400 && status < 500:
+		return 1
+	case status >= 500 && status < 600:
+		return 2
+	default:
+		return 1
+	}
+}