@hoox-sh/hoox-shared 1.2.0

package/dist/types.d.ts

@@ -0,0 +1,442 @@
+/**
+ * Copyright (c) 2026 HOOX · HOOX · jango-blockchained (hoox-sh)
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from "zod";
+export declare const TradeActionSchema: z.ZodEnum<{
+    LONG: "LONG";
+    SHORT: "SHORT";
+    CLOSE_LONG: "CLOSE_LONG";
+    CLOSE_SHORT: "CLOSE_SHORT";
+}>;
+export declare const WebhookPayloadSchema: z.ZodObject<{
+    exchange: z.ZodString;
+    action: z.ZodEnum<{
+        LONG: "LONG";
+        SHORT: "SHORT";
+        CLOSE_LONG: "CLOSE_LONG";
+        CLOSE_SHORT: "CLOSE_SHORT";
+    }>;
+    symbol: z.ZodString;
+    quantity: z.ZodNumber;
+    price: z.ZodOptional<z.ZodNumber>;
+    orderType: z.ZodOptional<z.ZodString>;
+    leverage: z.ZodOptional<z.ZodNumber>;
+    test: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+/** Validated trade queue payload (hoox producer → trade-worker consumer). */
+export declare const TradeQueueMessageSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    exchange: z.ZodString;
+    action: z.ZodEnum<{
+        LONG: "LONG";
+        SHORT: "SHORT";
+        CLOSE_LONG: "CLOSE_LONG";
+        CLOSE_SHORT: "CLOSE_SHORT";
+    }>;
+    symbol: z.ZodString;
+    quantity: z.ZodNumber;
+    price: z.ZodOptional<z.ZodNumber>;
+    leverage: z.ZodOptional<z.ZodNumber>;
+    test: z.ZodOptional<z.ZodBoolean>;
+    queuedAt: z.ZodString;
+}, z.core.$strict>;
+export declare const TradeSignalSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNumber>;
+    source: z.ZodString;
+    symbol: z.ZodString;
+    action: z.ZodEnum<{
+        LONG: "LONG";
+        SHORT: "SHORT";
+        CLOSE_LONG: "CLOSE_LONG";
+        CLOSE_SHORT: "CLOSE_SHORT";
+    }>;
+    price: z.ZodOptional<z.ZodNumber>;
+    quantity: z.ZodNumber;
+    leverage: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodEnum<{
+        skipped: "skipped";
+        failed: "failed";
+        pending: "pending";
+        executed: "executed";
+    }>>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    executedAt: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const PositionSchema: z.ZodObject<{
+    id: z.ZodString;
+    symbol: z.ZodString;
+    side: z.ZodEnum<{
+        LONG: "LONG";
+        SHORT: "SHORT";
+        CLOSE_LONG: "CLOSE_LONG";
+        CLOSE_SHORT: "CLOSE_SHORT";
+    }>;
+    quantity: z.ZodNumber;
+    entry_price: z.ZodNumber;
+    current_price: z.ZodNumber;
+    unrealized_pnl: z.ZodNumber;
+    timestamp: z.ZodNumber;
+}, z.core.$strict>;
+export declare const BalanceSchema: z.ZodObject<{
+    asset: z.ZodString;
+    free: z.ZodNumber;
+    locked: z.ZodNumber;
+    timestamp: z.ZodNumber;
+}, z.core.$strict>;
+export interface StandardResponse {
+    success: boolean;
+    result?: unknown;
+    error?: string | null;
+    message?: string;
+    tradeResult?: unknown;
+    notificationResult?: unknown;
+}
+export interface ApiSuccessResponse<T> {
+    success: true;
+    data: T;
+}
+export interface ApiErrorResponse {
+    success: false;
+    error: string;
+}
+export type ApiResponse<T> = ApiSuccessResponse<T> | ApiErrorResponse;
+export interface WorkerServiceBinding {
+    binding: string;
+    service: string;
+}
+export interface WorkerD1Binding {
+    binding: string;
+    database_id?: string;
+    database_name?: string;
+}
+export interface WorkerQueueConfig {
+    producers?: {
+        binding: string;
+        queue: string;
+    }[];
+    consumers?: {
+        queue: string;
+    }[];
+}
+export interface WorkerSecretsStoreBinding {
+    name?: string;
+    secret_name: string;
+    store_id?: string;
+    binding?: string;
+}
+export interface WorkerConfigManifestLite {
+    name?: string;
+    account_id?: string;
+    compatibility_date?: string;
+    compatibility_flags?: string[];
+    pages_build_output_dir?: string;
+    services?: WorkerServiceBinding[];
+    d1_databases?: WorkerD1Binding[];
+    secrets_store?: {
+        bindings?: WorkerSecretsStoreBinding[];
+    };
+    secrets_store_secrets?: WorkerSecretsStoreBinding[];
+    queues?: WorkerQueueConfig;
+    durable_objects?: {
+        bindings?: {
+            name: string;
+            class_name: string;
+        }[];
+    };
+    migrations?: {
+        tag: string;
+        new_sqlite_classes?: string[];
+    }[];
+}
+export interface HousekeepingCheck {
+    worker: string;
+    type: "error" | "warning" | "info";
+    message: string;
+}
+export interface HousekeepingSummary {
+    errors: number;
+    warnings: number;
+    info: number;
+}
+export interface HousekeepingPayload {
+    timestamp: string;
+    totalWorkers: number;
+    checkedWorkers: number;
+    issues: HousekeepingCheck[];
+    summary: HousekeepingSummary;
+}
+export interface SettingsPayload {
+    worker: string;
+    key: string;
+    value: string | number | boolean;
+}
+/**
+ * Environment with bindings needed by the shared middleware.
+ * Workers that use `requireAuth`, `createRateLimiter`, etc. have these bindings.
+ *
+ * This is intentionally a closed interface (no index signature) so accessing
+ * unknown bindings is a compile error. Workers pass their extended Env types
+ * via structural typing.
+ */
+export interface Env {
+    /**
+     * Preferred operator Bearer secret for management APIs (`requireOperatorAuth`).
+     * Client sends the same value as `HOOX_API_TOKEN`.
+     */
+    OPERATOR_API_KEY?: string;
+    /**
+     * Legacy alias for operator Bearer auth (`requireAuth` / `requireOperatorAuth`).
+     * Prefer `OPERATOR_API_KEY` for new deployments.
+     */
+    INTERNAL_API_KEY?: string;
+    /** KV namespace for rate limiting (createRateLimiter) */
+    CONFIG_KV?: KVNamespace;
+    /** Optional analytics service binding for tracking */
+    ANALYTICS_SERVICE?: Fetcher;
+}
+/**
+ * Base environment type for workers with common Cloudflare bindings.
+ * Workers should extend this with their specific bindings.
+ */
+export interface BaseEnv {
+    /** Optional analytics service binding for tracking */
+    ANALYTICS_SERVICE?: Fetcher;
+    /** Optional KV namespace for configuration */
+    CONFIG_KV?: KVNamespace;
+}
+export type Result<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: string;
+};
+export type TradeAction = z.infer<typeof TradeActionSchema>;
+export type WebhookPayload = z.infer<typeof WebhookPayloadSchema>;
+export type TradeQueueMessage = z.infer<typeof TradeQueueMessageSchema>;
+export type TradeSignal = z.infer<typeof TradeSignalSchema>;
+export interface QueryPayload {
+    query: string;
+    params?: unknown[];
+}
+export interface BatchPayload {
+    statements: QueryPayload[];
+}
+/**
+ * Generic process request body for internal worker-to-worker calls.
+ * The payload type varies per worker (WebhookPayload, NotificationPayload, etc.)
+ */
+export interface ProcessRequestBody<T = unknown> {
+    requestId?: string;
+    internalAuthKey?: string;
+    payload: T;
+}
+/** View identifier for TUI navigation. */
+export type ViewId = "dashboard" | "workers" | "worker-detail" | "trade-monitor" | "logs-viewer" | "service-manager" | "config-editor" | "setup-wizard" | "settings" | "queue-depth" | "kv-viewer" | "secrets-viewer" | "db-query" | "ai-chat" | "edge-topology" | "worker-settings";
+/**
+ * Lightweight tenant identifier and basic context.
+ * This type lives in the open core.
+ *
+ * Advanced tenant management, quotas, billing, and isolation enforcement
+ * are part of the commercial Enterprise layer.
+ */
+export interface TenantContext {
+    tenantId: string;
+    strategyId?: string;
+    fundId?: string;
+    features?: string[];
+}
+/**
+ * Basic audit event shape.
+ * Open core projects can emit these. Full compliance pipelines, retention,
+ * SIEM export, and cryptographic signing are Enterprise features.
+ */
+export interface AuditEvent {
+    timestamp: string;
+    tenantId: string;
+    traceId: string;
+    eventType: string;
+    actor: string;
+    outcome: "success" | "failure" | "skipped";
+    details?: Record<string, unknown>;
+}
+/**
+ * Simple workflow step result type.
+ * Useful for open core examples. Production-grade durable workflows,
+ * human-in-the-loop, long-running state, and advanced orchestration
+ * are provided in the Enterprise layer.
+ */
+export interface WorkflowStepResult<T = unknown> {
+    step: string;
+    success: boolean;
+    data?: T;
+    error?: string;
+    retries?: number;
+}
+/** Modal dialog state for the TUI. */
+export interface ModalState {
+    type: "confirm" | "alert" | "prompt" | "custom";
+    title: string;
+    message?: string;
+    data?: unknown;
+    onConfirm?: () => void;
+    onCancel?: () => void;
+}
+export type WorkerStatus = "operational" | "degraded" | "down";
+/**
+ * Information about a Cloudflare Worker for the TUI dashboard.
+ * Mirrors the data surfaced from the hoox REST API.
+ */
+export interface WorkerInfo {
+    id: string;
+    name: string;
+    status: WorkerStatus;
+    /** Uptime in seconds */
+    uptime: number;
+    /** CPU usage percentage (0-100) */
+    cpu: number;
+    /** Memory usage in MB */
+    memory: number;
+    /** Total request count */
+    requests: number;
+    /** Number of Durable Object instances */
+    durableObjectCount: number;
+    /** Number of edge locations the worker is deployed to */
+    edgeCount: number;
+    /** Worker version string */
+    version?: string;
+    /** Last deployment timestamp in ms */
+    lastDeployed?: number;
+}
+export type TradeSide = "buy" | "sell";
+/**
+ * A single trade event for the TUI trade monitor.
+ */
+export interface Trade {
+    id: string;
+    symbol: string;
+    side: TradeSide;
+    price: number;
+    quantity: number;
+    /** Unix timestamp in milliseconds */
+    timestamp: number;
+    exchange: string;
+    /** Optional strategy identifier */
+    strategy?: string;
+    /** Profit/Loss for this trade */
+    pnl?: number;
+}
+export type AlertSeverity = "info" | "warning" | "error" | "critical";
+/**
+ * A system alert surfaced in the TUI dashboard.
+ */
+export interface Alert {
+    id: string;
+    /** Alert category/type identifier */
+    type: string;
+    severity: AlertSeverity;
+    message: string;
+    /** Unix timestamp in milliseconds */
+    timestamp: number;
+    /** Optional linked worker ID */
+    workerId?: string;
+    acknowledged: boolean;
+    /** Source of the alert */
+    source?: string;
+}
+export type LogLevel = "debug" | "info" | "warn" | "error";
+/**
+ * A single log entry for the TUI logs viewer.
+ */
+export interface LogEntry {
+    id: string;
+    level: LogLevel;
+    message: string;
+    /** Unix timestamp in milliseconds */
+    timestamp: number;
+    workerId?: string;
+    source?: string;
+    /** Optional structured metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Aggregate system-level metrics for the TUI dashboard overview.
+ */
+export interface SystemMetrics {
+    /** Total number of configured workers */
+    totalWorkers: number;
+    /** Workers currently operational */
+    onlineWorkers: number;
+    /** Total P&L in USD */
+    totalPnl: number;
+    /** Active trading strategies count */
+    activeStrategies: number;
+    /** Trades in the last 24 hours */
+    dailyTrades: number;
+    /** AI agent calls in the last 24 hours */
+    aiCalls: number;
+    /** System uptime in seconds */
+    uptime: number;
+    /** Last update timestamp in ms */
+    lastUpdated: number;
+}
+/** Connection status for the TUI data-fetching state machine. */
+export type ConnectionStatus = "connected" | "polling" | "offline" | "reconnecting";
+/** Log filtering preferences. */
+export interface LogFilter {
+    levels: LogLevel[];
+    workers: string[];
+    searchText: string;
+}
+/** Notification channel preferences. */
+export interface NotificationPreferences {
+    alerts: boolean;
+    trades: boolean;
+    debug: boolean;
+    system: boolean;
+}
+/**
+ * Classification of a CLI bridge failure.
+ *
+ * Used by the TUI status bar to surface actionable diagnostics when the
+ * local `hoox` binary fails to execute. Each variant maps to a different
+ * recovery path (e.g. "install the CLI" vs. "the command timed out").
+ */
+export type CliErrorType = 
+/** The hoox binary could not be located on PATH or in the monorepo. */
+"binary-not-found"
+/** The command exceeded its configured timeout. */
+ | "timeout"
+/** The command was aborted via signal (user cancel or abort tag). */
+ | "aborted"
+/** The process exited with a non-zero exit code. */
+ | "non-zero-exit"
+/** Bun.spawn itself failed (permission denied, EACCES, etc.). */
+ | "spawn-error";
+/**
+ * Structured CLI bridge failure details.
+ *
+ * Populated by `cli-bridge.exec()` and stored on `useServiceStore.lastErrorDetails`
+ * so the status bar can render the full diagnostic context (command, exit code,
+ * stderr) — not just a one-line summary. Click-to-expand reveals all fields and
+ * the text remains selectable for copy/paste.
+ */
+export interface CliErrorDetails {
+    /** Full command string (binary + args) that failed, e.g. "hoox check health". */
+    command: string;
+    /** Process exit code, or -1 if the process never started or was aborted. */
+    exitCode: number;
+    /** Captured stderr output (may be empty if the process wrote only to stdout). */
+    stderr: string;
+    /** Captured stdout output (truncated to 4 KB to keep the store lightweight). */
+    stdout: string;
+    /** Classification of the failure — drives icon + recovery hint. */
+    errorType: CliErrorType;
+    /** Wall-clock timestamp (ms) when the error was recorded. */
+    timestamp: number;
+    /** Wall-clock duration (ms) of the failed command, for slow-command diagnosis. */
+    duration: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,83 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// src/types.ts
+import { z } from "zod";
+var TradeActionSchema = z.enum([
+  "LONG",
+  "SHORT",
+  "CLOSE_LONG",
+  "CLOSE_SHORT"
+]);
+var WebhookPayloadSchema = z.object({
+  exchange: z.string().min(1),
+  action: TradeActionSchema,
+  symbol: z.string().min(1).max(20),
+  quantity: z.number().positive().finite(),
+  price: z.number().positive().finite().optional(),
+  orderType: z.string().optional(),
+  leverage: z.number().int().positive().optional(),
+  test: z.boolean().optional()
+}).strict();
+var TradeQueueMessageSchema = z.object({
+  requestId: z.string().min(1).max(128),
+  exchange: z.string().min(1).max(64),
+  action: TradeActionSchema,
+  symbol: z.string().min(1).max(32),
+  quantity: z.number().positive().finite(),
+  price: z.number().positive().finite().optional(),
+  leverage: z.number().int().positive().max(125).optional(),
+  test: z.boolean().optional(),
+  queuedAt: z.string().min(1).max(64)
+}).strict();
+var TradeSignalSchema = z.object({
+  id: z.number().int().positive().optional(),
+  source: z.string().min(1),
+  symbol: z.string().min(1),
+  action: TradeActionSchema,
+  price: z.number().positive().finite().optional(),
+  quantity: z.number().positive().finite(),
+  leverage: z.number().int().positive().optional(),
+  status: z.enum(["pending", "executed", "failed", "skipped"]).optional(),
+  createdAt: z.string().optional(),
+  executedAt: z.string().optional(),
+  error: z.string().optional()
+}).strict();
+var PositionSchema = z.object({
+  id: z.string(),
+  symbol: z.string().min(1),
+  side: TradeActionSchema,
+  quantity: z.number().positive(),
+  entry_price: z.number().positive(),
+  current_price: z.number().positive(),
+  unrealized_pnl: z.number(),
+  timestamp: z.number().int().positive()
+}).strict();
+var BalanceSchema = z.object({
+  asset: z.string().min(1),
+  free: z.number().min(0),
+  locked: z.number().min(0),
+  timestamp: z.number().int().positive()
+}).strict();
+export {
+  WebhookPayloadSchema,
+  TradeSignalSchema,
+  TradeQueueMessageSchema,
+  TradeActionSchema,
+  PositionSchema,
+  BalanceSchema
+};

package/dist/wizard/engine.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) 2026 HOOX · HOOX · jango-blockchained (hoox-sh)
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * WizardEngine — Pure-logic state machine for the setup wizard.
+ *
+ * Manages step transitions, validation, and config building.
+ * Does NOT depend on Node/Bun APIs — Worker-compatible.
+ */
+import type { StepId, StepDefinition, WizardState, WorkersJsonConfig, ProvisioningPlan } from "./types";
+export declare class WizardEngine {
+    private state;
+    constructor(initialState?: Partial<WizardState>);
+    /** Get a copy of the current state. */
+    getState(): WizardState;
+    /** Get the current step definition. */
+    getCurrentStep(): StepDefinition;
+    /** Get list of completed step IDs. */
+    getCompletedSteps(): StepId[];
+    /** Whether the current step can be proceeded (optional or already completed). */
+    canProceed(): boolean;
+    /** Whether the user can navigate back from the current step. */
+    canGoBack(): boolean;
+    /**
+     * Execute the current step with the given input.
+     * Returns validation errors. If empty, advances to the next step.
+     */
+    execute(input: Record<string, unknown>): string[];
+    /** Navigate back to the previous step. */
+    goBack(): void;
+    /** Reset engine to initial state. */
+    reset(): void;
+    /**
+     * Build the full WorkersJsonConfig from current state.
+     * This is the output of the wizard — written to wrangler.jsonc.
+     */
+    buildConfig(): WorkersJsonConfig;
+    /**
+     * Determine what Cloudflare resources need to be provisioned
+     * based on selected workers and integrations.
+     */
+    getProvisioningPlan(): ProvisioningPlan;
+    private applyInput;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/wizard/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/wizard/engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,OAAO,KAAK,EACV,MAAM,EACN,cAAc,EACd,WAAW,EACX,iBAAiB,EAEjB,gBAAgB,EAGjB,MAAM,SAAS,CAAC;AAiKjB,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAc;gBAEf,YAAY,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAI/C,uCAAuC;IACvC,QAAQ,IAAI,WAAW;IAIvB,uCAAuC;IACvC,cAAc,IAAI,cAAc;IAIhC,sCAAsC;IACtC,iBAAiB,IAAI,MAAM,EAAE;IAI7B,iFAAiF;IACjF,UAAU,IAAI,OAAO;IAKrB,gEAAgE;IAChE,SAAS,IAAI,OAAO;IAIpB;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE;IA0BjD,0CAA0C;IAC1C,MAAM,IAAI,IAAI;IAgBd,qCAAqC;IACrC,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,WAAW,IAAI,iBAAiB;IA+DhC;;;OAGG;IACH,mBAAmB,IAAI,gBAAgB;IAwCvC,OAAO,CAAC,UAAU;CA4DnB"}