@screenly/edge-apps 0.1.0 → 1.0.0-rc.1

package/bin/edge-apps-scripts.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { run } from '../scripts/cli.js'
+
+run()

package/configs/playwright.js

@@ -18,7 +18,7 @@ try {
 } catch {
   throw new Error(
     "Failed to resolve '@playwright/test' from the application. " +
-      "Please install it in your app (e.g. 'bun add -d @playwright/test') " +
+      "Please install it in your app (e.g. 'npm install -D @playwright/test') " +
       'and try again.',
   )
 }

package/eslint.config.ts

@@ -1,5 +1,6 @@
 import eslint from '@eslint/js'
 import { defineConfig, globalIgnores } from 'eslint/config'
+import globals from 'globals'
 import tseslint from 'typescript-eslint'
 
 export default defineConfig(
@@ -34,6 +35,12 @@ export default defineConfig(
       }],
     },
   },
+  {
+    files: ['scripts/**/*.js', 'bin/**/*.js'],
+    languageOptions: {
+      globals: globals.node,
+    },
+  },
   {
     files: ['**/*.test.ts', '**/*.spec.ts'],
     rules: {

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@screenly/edge-apps",
-  "version": "0.1.0",
+  "version": "1.0.0-rc.1",
   "description": "A TypeScript library for interfacing with Screenly Edge Apps API",
   "type": "module",
+  "engines": {
+    "node": ">=20.6.0"
+  },
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "edge-apps-scripts": "./bin/edge-apps-scripts.ts"
+    "edge-apps-scripts": "./bin/edge-apps-scripts.js"
   },
   "exports": {
     ".": {
@@ -55,14 +58,14 @@
     "src/assets"
   ],
   "scripts": {
-    "prepublishOnly": "bun run build",
-    "prebuild": "bun run type-check",
-    "build": "bun build:types && bun run copy:assets",
+    "prepublishOnly": "npm run build",
+    "prebuild": "npm run type-check",
+    "build": "npm run build:types && npm run copy:assets",
     "build:types": "tsc",
-    "copy:assets": "bun run scripts/copy-assets.ts",
-    "test": "bun test --parallel",
-    "test:unit": "bun test --parallel",
-    "test:coverage": "bun test --coverage --parallel",
+    "copy:assets": "node scripts/copy-assets.js",
+    "test": "vitest run",
+    "test:unit": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "lint": "eslint . --fix",
     "format": "prettier --write src/ scripts/ vite-plugins/ README.md index.html",
     "format:check": "prettier --check src/ scripts/ vite-plugins/ README.md index.html",
@@ -105,12 +108,13 @@
     }
   },
   "devDependencies": {
-    "@types/bun": "^1.3.10",
     "@types/jsdom": "^28.0.0",
     "@types/node": "^25.4.0",
     "@types/sharp": "^0.32.0",
-    "bun-types": "^1.3.10",
+    "@vitest/coverage-v8": "^3.2.4",
+    "globals": "^13.24.0",
     "jsdom": "^28.1.0",
-    "prettier": "^3.8.1"
+    "prettier": "^3.8.1",
+    "vitest": "^3.2.4"
   }
 }

package/scripts/{cli.ts → cli.js}

@@ -1,13 +1,11 @@
-#!/usr/bin/env bun
-/**
- * CLI command dispatcher for edge-apps-scripts
- */
+#!/usr/bin/env node
 
-import { execSync, execFileSync, spawn, type ChildProcess } from 'child_process'
+import { execSync, execFileSync, spawn } from 'child_process'
 import fs from 'fs'
 import path from 'path'
 import { fileURLToPath } from 'url'
-import { createCommand } from './create'
+import { createCommand } from './create.js'
+import { start as startCorsProxy } from './cors-proxy-server.js'
 
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = path.dirname(__filename)
@@ -38,6 +36,10 @@ const commands = {
     description: 'Capture screenshots at all supported resolutions',
     handler: screenshotsCommand,
   },
+  'cors-proxy': {
+    description: 'Start the CORS proxy server for local development',
+    handler: startCorsProxy,
+  },
   create: {
     description:
       'Initialize a scaffolded Edge App (replaces template placeholders)',
@@ -45,20 +47,14 @@ const commands = {
   },
 }
 
-/**
- * Helper: Resolve a binary from the app's node_modules first, falling back to the library's
- */
-function resolveBin(name: string): string {
+function resolveBin(name) {
   const appBin = path.resolve(process.cwd(), 'node_modules', '.bin', name)
   return fs.existsSync(appBin)
     ? appBin
     : path.resolve(libraryRoot, 'node_modules', '.bin', name)
 }
 
-/**
- * Helper: Get NODE_PATH with library's node_modules included
- */
-function getNodePath(): string {
+function getNodePath() {
   const libraryNodeModules = path.resolve(libraryRoot, 'node_modules')
   const existingNodePath = process.env.NODE_PATH || ''
   return existingNodePath
@@ -66,26 +62,16 @@ function getNodePath(): string {
     : libraryNodeModules
 }
 
-/**
- * Helper: Setup signal handlers for spawned processes
- */
-function setupSignalHandlers(child: ChildProcess): void {
-  const handleSignal = (signal: string) => {
-    child.kill(signal as NodeJS.Signals)
+function setupSignalHandlers(child) {
+  const handleSignal = (signal) => {
+    child.kill(signal)
     child.on('exit', () => process.exit(0))
   }
   process.on('SIGINT', () => handleSignal('SIGINT'))
   process.on('SIGTERM', () => handleSignal('SIGTERM'))
 }
 
-/**
- * Helper: Spawn a process with common options and signal handling
- */
-function spawnWithSignalHandling(
-  command: string,
-  args: string[],
-  errorMessage: string,
-): void {
+function spawnWithSignalHandling(command, args, errorMessage) {
   const child = spawn(command, args, {
     stdio: 'inherit',
     cwd: process.cwd(),
@@ -104,17 +90,14 @@ function spawnWithSignalHandling(
   setupSignalHandlers(child)
 }
 
-/**
- * Helper: Get Vite binary and config paths
- */
-function getVitePaths(): { viteBin: string; configPath: string } {
+function getVitePaths() {
   return {
     viteBin: resolveBin('vite'),
     configPath: path.resolve(libraryRoot, 'vite.config.ts'),
   }
 }
 
-async function lintCommand(args: string[]) {
+async function lintCommand(args) {
   try {
     const eslintBin = resolveBin('eslint')
 
@@ -137,7 +120,7 @@ async function lintCommand(args: string[]) {
   }
 }
 
-async function devCommand(args: string[]) {
+async function devCommand(args) {
   try {
     const { viteBin, configPath } = getVitePaths()
     const viteArgs = ['--config', configPath, ...args]
@@ -148,7 +131,7 @@ async function devCommand(args: string[]) {
   }
 }
 
-async function buildCommand(args: string[]) {
+async function buildCommand(args) {
   try {
     const { viteBin, configPath } = getVitePaths()
     const sourcemaps = args.includes('--sourcemaps')
@@ -174,7 +157,7 @@ async function buildCommand(args: string[]) {
   }
 }
 
-async function buildDevCommand(args: string[]) {
+async function buildDevCommand(args) {
   try {
     const { viteBin, configPath } = getVitePaths()
     const viteArgs = [
@@ -192,7 +175,7 @@ async function buildDevCommand(args: string[]) {
   }
 }
 
-async function typeCheckCommand(args: string[]) {
+async function typeCheckCommand(args) {
   try {
     const tscBin = resolveBin('tsc')
 
@@ -212,7 +195,7 @@ async function typeCheckCommand(args: string[]) {
   }
 }
 
-async function convertPngsToWebP(screenshotsDir: string): Promise<void> {
+async function convertPngsToWebP(screenshotsDir) {
   const { default: sharp } = await import('sharp')
   const pngFiles = fs
     .readdirSync(screenshotsDir)
@@ -226,7 +209,7 @@ async function convertPngsToWebP(screenshotsDir: string): Promise<void> {
   }
 }
 
-async function screenshotsCommand(_args: string[]) {
+async function screenshotsCommand(_args) {
   try {
     const playwrightBin = resolveBin('playwright')
     const playwrightConfig = path.resolve(
@@ -280,7 +263,7 @@ export async function run() {
     process.exit(1)
   }
 
-  const handler = commands[cmd as keyof typeof commands].handler
+  const handler = commands[cmd].handler
   await handler(cmdArgs)
 }
 

package/scripts/{copy-assets.ts → copy-assets.js}

@@ -1,7 +1,4 @@
-#!/usr/bin/env bun
-/**
- * Copy assets from src to dist after TypeScript compilation
- */
+#!/usr/bin/env node
 
 import { cpSync, existsSync, mkdirSync } from 'fs'
 import { dirname } from 'path'
@@ -15,10 +12,7 @@ const srcAssets = `${libraryRoot}/src/assets`
 const distAssets = `${libraryRoot}/dist/assets`
 
 if (existsSync(srcAssets)) {
-  // Ensure dist directory exists
   mkdirSync(dirname(distAssets), { recursive: true })
-
-  // Copy assets
   cpSync(srcAssets, distAssets, { recursive: true })
   console.log('✓ Copied assets to dist/')
 } else {

package/scripts/{cors-proxy-server.ts → cors-proxy-server.js}

@@ -2,17 +2,7 @@ import http from 'http'
 import https from 'https'
 import { URL } from 'url'
 
-// Listen on a specific host via the HOST environment variable
-const host = process.env.HOST || '0.0.0.0'
-// Listen on a specific port via the PORT environment variable
-const port = process.env.PORT || 8080
-
-// This script is for development purposes only and should never be deployed to production.
-// Disabling TLS certificate validation is a critical security risk.
-// Only use this in local development environments.
-process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0'
-
-function setCorsHeaders(res: http.ServerResponse) {
+function setCorsHeaders(res) {
   res.setHeader('Access-Control-Allow-Origin', '*')
   res.setHeader(
     'Access-Control-Allow-Methods',
@@ -22,12 +12,7 @@ function setCorsHeaders(res: http.ServerResponse) {
   res.setHeader('Access-Control-Max-Age', '86400')
 }
 
-function makeProxyRequest(
-  httpModule: typeof http | typeof https,
-  parsedUrl: URL,
-  req: http.IncomingMessage,
-  res: http.ServerResponse,
-) {
+function makeProxyRequest(httpModule, parsedUrl, req, res) {
   const options = {
     hostname: parsedUrl.hostname,
     port: parsedUrl.port || (parsedUrl.protocol === 'https:' ? 443 : 80),
@@ -98,10 +83,7 @@ function makeProxyRequest(
   }
 }
 
-function handleProxyRequest(
-  req: http.IncomingMessage,
-  res: http.ServerResponse,
-) {
+function handleProxyRequest(req, res) {
   setCorsHeaders(res)
 
   if (req.method === 'OPTIONS') {
@@ -142,13 +124,19 @@ function handleProxyRequest(
   }
 }
 
-const server = http.createServer((req, res) => {
-  handleProxyRequest(req, res)
-})
+export function start() {
+  const host = process.env.HOST || '0.0.0.0'
+  const port = process.env.PORT || 8080
 
-// Start the server
-server.listen(port, host, () => {
-  console.log(
-    `Running CORS Proxy (Node.js built-ins) on http://${host}:${port}`,
-  )
-})
+  process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0'
+
+  const server = http.createServer((req, res) => {
+    handleProxyRequest(req, res)
+  })
+
+  server.listen(port, host, () => {
+    console.log(
+      `Running CORS Proxy (Node.js built-ins) on http://${host}:${port}`,
+    )
+  })
+}

package/scripts/{create.ts → create.js}

@@ -21,15 +21,15 @@ const TEXT_EXTENSIONS = new Set([
 
 const SKIP_DIRS = new Set(['node_modules', 'dist', '.git'])
 
-function toTitleCase(kebab: string): string {
+function toTitleCase(kebab) {
   return kebab
     .split('-')
     .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
     .join(' ')
 }
 
-function walkTextFiles(dir: string): string[] {
-  const results: string[] = []
+function walkTextFiles(dir) {
+  const results = []
   for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
     const fullPath = path.join(dir, entry.name)
     if (entry.isDirectory()) {
@@ -45,10 +45,7 @@ function walkTextFiles(dir: string): string[] {
   return results
 }
 
-function replaceInFile(
-  filePath: string,
-  replacements: Record<string, string>,
-): void {
+function replaceInFile(filePath, replacements) {
   const original = fs.readFileSync(filePath, 'utf-8')
   const updated = Object.entries(replacements).reduce(
     (src, [placeholder, value]) => src.replaceAll(placeholder, value),
@@ -57,11 +54,11 @@ function replaceInFile(
   if (updated !== original) fs.writeFileSync(filePath, updated, 'utf-8')
 }
 
-export async function createCommand(_args: string[]) {
+export async function createCommand(_args) {
   const projectRoot = process.cwd()
   const pkgPath = path.join(projectRoot, 'package.json')
 
-  let pkg: Record<string, unknown>
+  let pkg
   try {
     pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'))
   } catch (error) {
@@ -84,7 +81,7 @@ export async function createCommand(_args: string[]) {
   const appTitle = toTitleCase(appName)
   const appDescription = `${appTitle} - Screenly Edge App`
 
-  const replacements: Record<string, string> = {
+  const replacements = {
     '{{APP_NAME}}': appName,
     '{{APP_TITLE}}': appTitle,
     '{{APP_DESCRIPTION}}': appDescription,
@@ -107,12 +104,12 @@ Next steps:
   1. Add an id field to screenly.yml and screenly_qc.yml.
 
   2. Install dependencies:
-       bun install
+       npm install
 
   3. Start the dev server:
-       bun run dev
+       npm run dev
 
   4. Deploy when ready:
-       bun run deploy
+       npm run deploy
 `)
 }

package/tsconfig.json

@@ -14,7 +14,7 @@
     "forceConsistentCasingInFileNames": true,
     "resolveJsonModule": true,
     "allowSyntheticDefaultImports": true,
-    "types": ["bun-types", "vite/client"]
+    "types": ["vite/client"]
   },
   "include": ["src/**/*"],
   "exclude": ["node_modules", "dist", "**/*.test.ts"]

package/bin/edge-apps-scripts.ts

@@ -1,9 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Edge Apps Scripts CLI
- * Wrapper around build tools for Edge Apps
- */
-
-import { run } from '../scripts/cli'
-
-run()