create-apexjs 0.6.7 → 0.6.9

package/templates/mobile/ios/Tests/ApexEngineTests.swift

@@ -0,0 +1,74 @@
+// ApexEngineTests — runs on the iOS Simulator in CI (GitHub Actions macOS runner), no Mac needed
+// locally. This is the highest-value iOS check: it proves the `apex build --mobile` bundle — the
+// SHIM, the whole SSR + API pipeline, and the **asm.js SQLite** DB — actually runs under
+// **JavaScriptCore** (iOS's engine, different from Android's V8). It drives ApexEngine directly, so
+// it does NOT depend on WKURLSchemeHandler (the one remaining device-only unknown — POST bodies on
+// a custom scheme — still needs a real device/UI test).
+import JavaScriptCore
+import XCTest
+
+@testable import ApexShell
+
+final class ApexEngineTests: XCTestCase {
+  /// server.mjs + apex-bridge.js are copied into the TEST bundle by CI (see project.yml resources).
+  private func makeEngine(snapshot: String? = nil) throws -> ApexEngine {
+    try ApexEngine(snapshot: snapshot, bundle: Bundle(for: Self.self))
+  }
+
+  private func request(_ url: String, method: String = "GET", body: String? = nil) -> String {
+    let obj: [String: Any] = [
+      "url": url,
+      "method": method,
+      "headers": ["content-type": "application/json"],
+      "body": body as Any? ?? NSNull(),
+    ]
+    let data = try! JSONSerialization.data(withJSONObject: obj)
+    return String(data: data, encoding: .utf8)!
+  }
+
+  /// SSR of a DB-backed page renders the seeded rows — proves JSContext runs the bundle + asm.js DB.
+  func testGuestbookRendersSeededRowsOnJavaScriptCore() async throws {
+    let engine = try makeEngine()
+    let res = await engine.handle(request("apex://localhost/guestbook"))
+    XCTAssertTrue(res.contains("Ada Lovelace"), "seeded row missing — bundle/DB didn't run on JSCore. Got: \(res.prefix(400))")
+    XCTAssertTrue(res.contains("Alan Turing"))
+  }
+
+  /// POST inserts through the Drizzle deferred proxy on asm.js SQLite, and it persists across a
+  /// simulated cold start via the snapshot seam.
+  func testPostInsertsAndSurvivesSnapshotRestore() async throws {
+    let engine = try makeEngine()
+    _ = await engine.handle(request("apex://localhost/guestbook")) // lazy-init + seed the DB
+
+    let post = await engine.handle(
+      request(
+        "apex://localhost/api/messages",
+        method: "POST",
+        body: #"{"author":"iOS CI","body":"runs on JavaScriptCore"}"#
+      )
+    )
+    XCTAssertTrue(post.contains("iOS CI"), "POST /api/messages did not echo the created row: \(post.prefix(400))")
+
+    let after = await engine.handle(request("apex://localhost/guestbook"))
+    XCTAssertTrue(after.contains("iOS CI"), "new message not visible after POST")
+
+    // Cold-start persistence: export bytes, boot a fresh engine with them, data survives.
+    let snap = engine.snapshot()
+    XCTAssertFalse(snap.isEmpty, "snapshot export returned empty")
+    let restored = try makeEngine(snapshot: snap)
+    let restoredBody = await restored.handle(request("apex://localhost/guestbook"))
+    XCTAssertTrue(restoredBody.contains("iOS CI"), "message did not survive snapshot restore")
+  }
+
+  /// Sealed-cookie auth works on JSCore (HMAC, no WebCrypto): login sets a cookie, whoami is gated.
+  func testAuthLoginOnJavaScriptCore() async throws {
+    let engine = try makeEngine()
+    let anon = await engine.handle(request("apex://localhost/api/whoami"))
+    XCTAssertTrue(anon.contains("401"), "gated whoami should be 401 when anonymous: \(anon.prefix(200))")
+
+    let login = await engine.handle(
+      request("apex://localhost/api/login", method: "POST", body: #"{"name":"Ada"}"#)
+    )
+    XCTAssertTrue(login.contains("apex-session"), "login should set a session cookie: \(login.prefix(300))")
+  }
+}

package/templates/mobile/ios/project.yml

@@ -0,0 +1,75 @@
+# XcodeGen spec — generates ApexShell.xcodeproj from source, so the iOS project can be built on a
+# CI macOS runner (or any Mac) without hand-authoring an .xcodeproj in Xcode.
+#   brew install xcodegen && (cd ios && xcodegen generate)
+# The app + test bundle resources (server.mjs, apex-bridge.js, assets/, favicon.svg) are produced by
+# `apex build --mobile` and copied into ios/Generated/ before generating (see .github/workflows/ios.yml).
+name: ApexShell
+options:
+  bundleIdPrefix: site.apexjs
+  deploymentTarget:
+    iOS: "15.0"
+  createIntermediateGroups: true
+
+settings:
+  base:
+    SWIFT_VERSION: "5.0"
+    CODE_SIGNING_ALLOWED: "NO" # simulator builds/tests need no signing
+
+targets:
+  ApexShell:
+    type: application
+    platform: iOS
+    sources:
+      - path: ApexApp.swift
+      - path: ApexEngine.swift
+      - path: ApexSchemeHandler.swift
+      - path: ApexDbStore.swift
+      - path: Assets.xcassets
+      - path: Generated/server.mjs
+        type: file
+        buildPhase: resources
+      - path: Generated/apex-bridge.js
+        type: file
+        buildPhase: resources
+      - path: Generated/assets
+        type: folder # blue folder reference → served verbatim at /assets/*
+        buildPhase: resources
+      - path: Generated/favicon.svg
+        type: file
+        buildPhase: resources
+    settings:
+      base:
+        PRODUCT_BUNDLE_IDENTIFIER: site.apexjs.shell
+        INFOPLIST_FILE: Info.plist
+        GENERATE_INFOPLIST_FILE: "NO"
+        TARGETED_DEVICE_FAMILY: "1,2"
+
+  ApexShellTests:
+    type: bundle.unit-test
+    platform: iOS
+    sources:
+      - path: Tests
+      # The engine test loads the bundle from its OWN (test) bundle, so copy the JS here too.
+      - path: Generated/server.mjs
+        type: file
+        buildPhase: resources
+      - path: Generated/apex-bridge.js
+        type: file
+        buildPhase: resources
+    dependencies:
+      - target: ApexShell
+    settings:
+      base:
+        TEST_HOST: "$(BUILT_PRODUCTS_DIR)/ApexShell.app/ApexShell"
+        BUNDLE_LOADER: "$(TEST_HOST)"
+        PRODUCT_BUNDLE_IDENTIFIER: site.apexjs.shell.tests
+
+schemes:
+  ApexShell:
+    build:
+      targets:
+        ApexShell: all
+        ApexShellTests: [test]
+    test:
+      targets:
+        - ApexShellTests

package/templates/mobile/splash.alpine

@@ -0,0 +1,48 @@
+<!-- Example animated splash — copy to your app's pages/splash.alpine.
+     The native shell loads /splash first; icon pops in, then "APEX JS" types out with a
+     blinking cursor (CSS-only — flash-free), then it advances to /.
+
+     Auto-advance is on the root template's x-init (a CLIENT attribute Alpine runs on
+     hydration) — NOT <script client>, whose top-level code would run during SSR and crash a
+     bare on-device engine. Responsive + reduced-motion aware. -->
+<script server>
+  export function head() { return { title: 'Loading…' } }
+</script>
+
+<template x-data="{}" x-init="setTimeout(() => { window.location.href = '/' }, 2600)">
+  <div class="splash">
+    <!-- The app's icon (served from /favicon.svg — swap for your own brand mark). -->
+    <img class="mark" src="/favicon.svg" alt="Apex" width="96" height="96" />
+    <div class="typed">APEX JS</div>
+  </div>
+</template>
+
+<style scoped>
+  .splash {
+    position: fixed; inset: 0;
+    display: flex; flex-direction: column; align-items: center; justify-content: center;
+    gap: clamp(1rem, 5vw, 1.75rem);
+    background: #0b1120; color: #38bdf8;
+    padding: env(safe-area-inset-top) env(safe-area-inset-right) env(safe-area-inset-bottom) env(safe-area-inset-left);
+  }
+  .mark {
+    width: clamp(4.5rem, 24vw, 6.5rem); height: auto; aspect-ratio: 1;
+    display: block; object-fit: contain;
+    animation: pop 0.5s cubic-bezier(0.2, 0.9, 0.3, 1.2) both;
+  }
+  .typed {
+    font-family: ui-monospace, "SFMono-Regular", Menlo, Consolas, monospace;
+    font-weight: 600; font-size: clamp(1.1rem, 5.5vw, 1.6rem);
+    white-space: nowrap; overflow: hidden;
+    width: 0; max-width: 7ch;
+    border-right: 0.09em solid currentColor;
+    animation: type 1.3s steps(7, end) 0.55s forwards, blink 0.85s step-end 0.55s infinite;
+  }
+  @keyframes pop { from { opacity: 0; transform: scale(0.6); } to { opacity: 1; transform: scale(1); } }
+  @keyframes type { to { width: 7ch; } }
+  @keyframes blink { 50% { border-color: transparent; } }
+  @media (prefers-reduced-motion: reduce) {
+    .mark { animation: none; }
+    .typed { width: 7ch; animation: blink 0.85s step-end infinite; }
+  }
+</style>