@appstrata/cli 0.1.0

package/dist/schema-generator.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Generates a Yodeck-compatible schema.json from AppStrata configuration.
+ *
+ * Transforms `app.configuration.inputs` (platform-agnostic field definitions)
+ * into Yodeck's schema.json format with appropriate editor types and attributes.
+ */
+import type { AppConfig } from "@appstrata/dev";
+export interface YodeckSchema {
+    meta: {
+        application_guid: string;
+        application_version: string;
+        name: string;
+        description?: string;
+        details?: string;
+        [key: string]: unknown;
+    };
+    fields: string[];
+    styleSettings: unknown[];
+    data: Record<string, unknown>;
+    schema: Record<string, YodeckFieldDefinition>;
+    [key: string]: unknown;
+}
+export interface YodeckFieldDefinition {
+    type: string;
+    title: string;
+    help?: string;
+    validators?: string[];
+    def?: unknown;
+    options?: {
+        val: string;
+        label: string;
+    }[];
+    editorAttrs?: Record<string, unknown>;
+    editorClass?: string;
+    select2options?: Record<string, unknown>;
+}
+/**
+ * Generate a Yodeck-compatible schema.json from AppStrata app configuration.
+ */
+export declare function generateYodeckSchema(appConfig: AppConfig): YodeckSchema;
+//# sourceMappingURL=schema-generator.d.ts.map

package/dist/schema-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-generator.d.ts","sourceRoot":"","sources":["../src/schema-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EAUV,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE;QACJ,gBAAgB,EAAE,MAAM,CAAC;QACzB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,OAAO,EAAE,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC9C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAuMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,YAAY,CA0CvE"}

package/dist/schema-generator.js

@@ -0,0 +1,239 @@
+/**
+ * Generates a Yodeck-compatible schema.json from AppStrata configuration.
+ *
+ * Transforms `app.configuration.inputs` (platform-agnostic field definitions)
+ * into Yodeck's schema.json format with appropriate editor types and attributes.
+ */
+function transformTextInput(input) {
+    const field = {
+        type: "Text",
+        title: input.title,
+    };
+    if (input.help)
+        field.help = input.help;
+    if (input.default !== undefined)
+        field.def = input.default;
+    const validators = [];
+    if (input.validators?.required)
+        validators.push("required");
+    if (validators.length > 0)
+        field.validators = validators;
+    if (input.validators?.minLength !== undefined || input.validators?.maxLength !== undefined) {
+        field.editorAttrs = {};
+        if (input.validators?.minLength !== undefined)
+            field.editorAttrs.minlength = input.validators.minLength;
+        if (input.validators?.maxLength !== undefined)
+            field.editorAttrs.maxlength = input.validators.maxLength;
+    }
+    return field;
+}
+function transformColorInput(input) {
+    const field = {
+        type: "SpectrumColorPicker",
+        title: input.title,
+    };
+    if (input.help)
+        field.help = input.help;
+    if (input.default !== undefined) {
+        const hex = input.default.replace(/^#/, "");
+        field.editorAttrs = { def: hex };
+    }
+    const validators = [];
+    if (input.validators?.required)
+        validators.push("required");
+    if (validators.length > 0)
+        field.validators = validators;
+    return field;
+}
+function transformBooleanInput(input) {
+    const field = {
+        type: "Boolean",
+        title: input.title,
+    };
+    if (input.help)
+        field.help = input.help;
+    if (input.default !== undefined) {
+        field.editorAttrs = { def: input.default };
+    }
+    return field;
+}
+function transformNumberInput(input) {
+    const field = {
+        type: "Spinner",
+        title: input.title,
+    };
+    if (input.help)
+        field.help = input.help;
+    const attrs = {};
+    if (input.default !== undefined)
+        attrs.def = input.default;
+    if (input.min !== undefined)
+        attrs.min = input.min;
+    if (input.max !== undefined)
+        attrs.max = input.max;
+    if (input.step !== undefined)
+        attrs.step = input.step;
+    if (Object.keys(attrs).length > 0)
+        field.editorAttrs = attrs;
+    const validators = [];
+    if (input.validators?.required)
+        validators.push("required");
+    if (validators.length > 0)
+        field.validators = validators;
+    return field;
+}
+function transformSelectInput(input) {
+    const field = {
+        type: "Select2",
+        title: input.title,
+        editorClass: "select2container",
+        select2options: {
+            closeOnSelect: true,
+            minimumResultsForSearch: -1,
+        },
+    };
+    if (input.help)
+        field.help = input.help;
+    if (input.default !== undefined)
+        field.def = input.default;
+    field.options = input.options.map((opt) => ({
+        val: opt.value,
+        label: opt.label,
+    }));
+    const validators = [];
+    if (input.validators?.required)
+        validators.push("required");
+    if (validators.length > 0)
+        field.validators = validators;
+    return field;
+}
+function transformRangeInput(input) {
+    const field = {
+        type: "Slider",
+        title: input.title,
+    };
+    if (input.help)
+        field.help = input.help;
+    const attrs = {};
+    if (input.default !== undefined)
+        attrs.def = input.default;
+    attrs.min = input.min;
+    attrs.max = input.max;
+    if (input.step !== undefined)
+        attrs.step = input.step;
+    field.editorAttrs = attrs;
+    const validators = [];
+    if (input.validators?.required)
+        validators.push("required");
+    if (validators.length > 0)
+        field.validators = validators;
+    return field;
+}
+function transformFontInput(input) {
+    const field = {
+        type: "FontFamily",
+        title: input.title,
+        editorClass: "select2container full-size",
+    };
+    if (input.help)
+        field.help = input.help;
+    const validators = [];
+    if (input.validators?.required)
+        validators.push("required");
+    if (validators.length > 0)
+        field.validators = validators;
+    return field;
+}
+function transformImageInput(input) {
+    const field = {
+        type: "mediaFilePicker",
+        title: input.title,
+    };
+    if (input.help)
+        field.help = input.help;
+    const validators = [];
+    if (input.validators?.required)
+        validators.push("required");
+    if (validators.length > 0)
+        field.validators = validators;
+    return field;
+}
+function transformInput(input) {
+    switch (input.type) {
+        case "text": return transformTextInput(input);
+        case "color": return transformColorInput(input);
+        case "boolean": return transformBooleanInput(input);
+        case "number": return transformNumberInput(input);
+        case "select": return transformSelectInput(input);
+        case "range": return transformRangeInput(input);
+        case "font": return transformFontInput(input);
+        case "image": return transformImageInput(input);
+        default: {
+            const _exhaustive = input;
+            throw new Error(`Unknown input type: ${_exhaustive.type}`);
+        }
+    }
+}
+function getDefaultValue(input) {
+    if (input.type === "font" || input.type === "image")
+        return undefined;
+    return input.default;
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Recursively merge `override` into `base`. Plain objects are merged
+ * key-by-key; everything else (arrays, primitives) is replaced outright.
+ * `override` values take precedence.
+ */
+function deepMerge(base, override) {
+    const result = { ...base };
+    for (const key of Object.keys(override)) {
+        if (isPlainObject(result[key]) && isPlainObject(override[key])) {
+            result[key] = deepMerge(result[key], override[key]);
+        }
+        else {
+            result[key] = override[key];
+        }
+    }
+    return result;
+}
+/**
+ * Generate a Yodeck-compatible schema.json from AppStrata app configuration.
+ */
+export function generateYodeckSchema(appConfig) {
+    const inputs = appConfig.configuration?.inputs ?? {};
+    const keys = Object.keys(inputs);
+    const data = {};
+    const schema = {};
+    const fieldKeys = [];
+    for (const key of keys) {
+        const input = inputs[key];
+        const schemaKey = input.type === "image" ? `${key}__file` : key;
+        fieldKeys.push(schemaKey);
+        schema[schemaKey] = transformInput(input);
+        const defaultVal = getDefaultValue(input);
+        if (defaultVal !== undefined) {
+            data[schemaKey] = defaultVal;
+        }
+    }
+    const generated = {
+        meta: {
+            application_guid: appConfig.id,
+            application_version: appConfig.version,
+            name: appConfig.name,
+            description: appConfig.description,
+            details: appConfig.details,
+        },
+        ...(appConfig.url ? { url: appConfig.url } : {}),
+        fields: fieldKeys,
+        styleSettings: [],
+        data,
+        schema,
+    };
+    if (appConfig.properties) {
+        return deepMerge(generated, appConfig.properties);
+    }
+    return generated;
+}

package/dist/status-page.d.ts

@@ -0,0 +1,5 @@
+/**
+ * HTML status page for dev player commands.
+ */
+export declare function renderStatusPage(port: number, sessions: string[]): string;
+//# sourceMappingURL=status-page.d.ts.map

package/dist/status-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-page.d.ts","sourceRoot":"","sources":["../src/status-page.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAoEzE"}

package/dist/status-page.js

@@ -0,0 +1,71 @@
+/**
+ * HTML status page for dev player commands.
+ */
+export function renderStatusPage(port, sessions) {
+    const sessionList = sessions.length === 0
+        ? '<p>No active sessions</p>'
+        : sessions.map(s => `<div class="session">${s}</div>`).join('');
+    return `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <title>AppStrata HTTP Dev Player</title>
+  <style>
+    body {
+      font-family: system-ui, sans-serif;
+      max-width: 800px;
+      margin: 50px auto;
+      padding: 20px;
+      background: #f5f5f5;
+    }
+    h1 {
+      color: #333;
+      border-bottom: 2px solid #667eea;
+      padding-bottom: 10px;
+    }
+    .info {
+      background: white;
+      padding: 20px;
+      border-radius: 8px;
+      margin: 20px 0;
+      box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+    }
+    .endpoint {
+      background: #f8f9fa;
+      padding: 10px;
+      border-left: 3px solid #667eea;
+      margin: 10px 0;
+      font-family: monospace;
+    }
+    code {
+      background: #f0f0f0;
+      padding: 2px 6px;
+      border-radius: 3px;
+      font-size: 14px;
+    }
+    .sessions { margin-top: 20px; }
+    .session {
+      background: #e8f5e9;
+      padding: 10px;
+      margin: 5px 0;
+      border-radius: 4px;
+      font-family: monospace;
+      font-size: 14px;
+    }
+  </style>
+</head>
+<body>
+  <h1>AppStrata HTTP Dev Player</h1>
+  <div class="info">
+    <h3>Status: Running</h3>
+    <p>This server implements the AppStrata protocol over HTTP.</p>
+
+
+    <div class="sessions">
+      <h3>Active Sessions:</h3>
+      <div id="sessions">${sessionList}</div>
+    </div>
+  </div>
+</body>
+</html>`;
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@appstrata/cli",
+  "version": "0.1.0",
+  "description": "AppStrata CLI - Command-line tools for digital signage app development",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "appstrata": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "python/**/*.py"
+  ],
+  "keywords": [
+    "digital-signage",
+    "appstrata",
+    "cli"
+  ],
+  "author": "AppStrata",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "dependencies": {
+    "archiver": "^7.0.1",
+    "commander": "^12.1.0",
+    "vite": "^6.0.0",
+    "@appstrata/core": "0.1.0",
+    "@appstrata/player-lib": "0.1.0",
+    "@appstrata/dev": "0.1.0",
+    "@appstrata/protocol": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/archiver": "^7.0.0",
+    "@types/node": "^24.10.1",
+    "typescript": "^5.3.3"
+  },
+  "scripts": {
+    "build": "tsc --build tsconfig.build.json && chmod +x dist/index.js",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "dev": "tsc --build --watch"
+  }
+}

package/python/appstrata_dev_player/__init__.py

@@ -0,0 +1 @@
+"""AppStrata dev HTTP player — CLI entry point for the Python runtime."""

package/python/appstrata_dev_player/__main__.py

@@ -0,0 +1,102 @@
+"""
+Entry point for the AppStrata Python player.
+
+Usage (invoked by Node CLI):
+    python -m appstrata_player --port 5175 --transport sse
+
+Config is received via stdin as newline-delimited JSON.
+"""
+
+from __future__ import annotations
+
+import argparse
+import asyncio
+import logging
+import signal
+import sys
+
+from .config import StdinConfigReader
+from .server import DevHttpPlayerServer
+
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(message)s",
+    stream=sys.stderr,
+)
+logger = logging.getLogger(__name__)
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(
+        description="AppStrata HTTP Dev Player (Python runtime)"
+    )
+    parser.add_argument(
+        "--port",
+        type=int,
+        default=5175,
+        help="Port for HTTP server (default: 5175)",
+    )
+    parser.add_argument(
+        "--host",
+        action="store_true",
+        help="Expose server to network (bind 0.0.0.0)",
+    )
+    parser.add_argument(
+        "--transport",
+        choices=["sse", "polling"],
+        default="sse",
+        help="HTTP transport mode (default: sse)",
+    )
+    return parser.parse_args()
+
+
+async def main() -> None:
+    args = parse_args()
+
+    # Read initial config from stdin (blocks until first JSON line arrives)
+    config_reader = StdinConfigReader()
+    config = await config_reader.read_initial()
+
+    # Create and start the server
+    server = DevHttpPlayerServer(
+        port=args.port,
+        host=args.host,
+        transport_mode=args.transport,
+        config=config,
+    )
+    runner = await server.start()
+
+    # Set up clean shutdown
+    shutdown_event = asyncio.Event()
+    loop = asyncio.get_event_loop()
+
+    def _signal_handler() -> None:
+        shutdown_event.set()
+
+    for sig in (signal.SIGINT, signal.SIGTERM):
+        loop.add_signal_handler(sig, _signal_handler)
+
+    # Start watching stdin for config updates in the background
+    async def _watch_config() -> None:
+        await config_reader.watch(server.update_config)
+        # stdin closed = parent process exited, shut down
+        shutdown_event.set()
+
+    watch_task = asyncio.create_task(_watch_config())
+
+    # Wait for shutdown signal
+    await shutdown_event.wait()
+
+    # Clean up
+    watch_task.cancel()
+    try:
+        await watch_task
+    except asyncio.CancelledError:
+        pass
+
+    await server.shutdown()
+    await runner.cleanup()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

package/python/appstrata_dev_player/config.py

@@ -0,0 +1,124 @@
+"""
+Configuration reader.
+
+Reads newline-delimited JSON from stdin:
+- First line = initial config (blocks until received)
+- Subsequent lines = live config updates
+
+The Node CLI writes config objects to our stdin whenever the
+appstrata.config.ts file changes on disk.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import json
+import logging
+import sys
+from typing import Any, Callable
+
+logger = logging.getLogger(__name__)
+
+# Default values matching packages/dev/src/types.ts (DEFAULT_CONTEXT / DEFAULT_LIFECYCLE)
+DEFAULT_CONFIG: dict[str, Any] = {
+    "context": {
+        "instanceId": "dev-instance",
+        "duration": 30,
+        "mode": "development",
+        "environment": "development",
+        "viewportWidth": 1920,
+        "viewportHeight": 1080,
+        "config": {},
+        "resources": [],
+        "device": {
+            "id": "dev-player",
+            "name": "Development Player",
+            "type": "web-player",
+            "platformName": "AppStrata Dev",
+            "locale": "en-US",
+            "timezone": "UTC",
+        },
+    },
+    "capabilities": ["storage", "proxy"],
+    "lifecycle": {
+        "initDelay": 0,
+        "showDelay": 50,
+        "startDelay": 50,
+        "hideDelay": 100,
+        "stopDelay": 50,
+    },
+}
+
+
+class StdinConfigReader:
+    """
+    Reads newline-delimited JSON config from stdin.
+
+    Usage:
+        reader = StdinConfigReader()
+        initial = await reader.read_initial()
+        # then in a background task:
+        await reader.watch(on_update_callback)
+    """
+
+    def __init__(self) -> None:
+        self._reader: asyncio.StreamReader | None = None
+        self._is_tty = sys.stdin.isatty()
+
+    async def _ensure_reader(self) -> asyncio.StreamReader | None:
+        if self._is_tty:
+            return None
+        if self._reader is None:
+            loop = asyncio.get_event_loop()
+            self._reader = asyncio.StreamReader()
+            protocol = asyncio.StreamReaderProtocol(self._reader)
+            await loop.connect_read_pipe(lambda: protocol, sys.stdin)
+        return self._reader
+
+    async def read_initial(self) -> dict[str, Any]:
+        """
+        Read the first JSON line from stdin.
+
+        Blocks until a complete line is available. If stdin is a TTY
+        (no pipe), returns the default config immediately.
+        """
+        reader = await self._ensure_reader()
+        if reader is None:
+            logger.info("No config pipe detected, using defaults")
+            return dict(DEFAULT_CONFIG)
+
+        line = await reader.readline()
+        if not line:
+            logger.warning("stdin closed before initial config, using defaults")
+            return dict(DEFAULT_CONFIG)
+
+        try:
+            config = json.loads(line)
+            logger.info("Initial config received from stdin")
+            return config
+        except json.JSONDecodeError:
+            logger.warning("Invalid JSON on stdin, using defaults")
+            return dict(DEFAULT_CONFIG)
+
+    async def watch(self, on_update: Callable[[dict[str, Any]], None]) -> None:
+        """
+        Continuously read lines from stdin and call on_update for each
+        valid JSON config object received.
+
+        Runs until stdin is closed. Must be called AFTER read_initial().
+        """
+        reader = await self._ensure_reader()
+        if reader is None:
+            return
+
+        while True:
+            line = await reader.readline()
+            if not line:
+                logger.info("stdin closed, stopping config watcher")
+                break
+            try:
+                config = json.loads(line)
+                logger.info("Config update received from stdin")
+                on_update(config)
+            except json.JSONDecodeError:
+                logger.warning("Invalid JSON on stdin update line, ignoring")