@springbrand/space 0.2.0-alpha.11 → 0.2.0-alpha.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springbrand/space",
-  "version": "0.2.0-alpha.11",
+  "version": "0.2.0-alpha.14",
   "type": "module",
   "files": [
     "src",
@@ -10,7 +10,11 @@
     "access": "public"
   },
   "exports": {
-    ".": "./src/index.ts"
+    ".": "./src/index.ts",
+    "./deployment-contract": "./src/space/deployment-contract.ts",
+    "./deploy-engine": "./src/space/deploy-engine.ts",
+    "./lazy-space-do": "./src/space/durable-object.ts",
+    "./preview-headers": "./src/space/preview-headers.ts"
   },
   "dependencies": {
     "@cloudflare/shell": "0.4.3",
@@ -20,11 +24,14 @@
   "devDependencies": {
     "@cloudflare/vitest-pool-workers": "^0.20.1",
     "@cloudflare/workers-types": "^4.20251008.0",
+    "esbuild": "0.28.1",
     "typescript": "^7.0.2",
     "vitest": "^4.1.10"
   },
   "scripts": {
+    "build": "node build.mjs",
     "check": "tsc --noEmit",
+    "pretest": "pnpm build",
     "test": "vitest run"
   }
 }

package/src/index.ts

@@ -1,5 +1,5 @@
 // ── Durable Object classes ────────────────────────────────────────
-export { SpaceDO } from "./space/durable-object";
+export { SpaceDO } from "./space/default-durable-object";
 
 // ── RPC surface ───────────────────────────────────────────────────
 export type {
@@ -22,14 +22,14 @@ export { SPACE_RESERVED_PREFIXES } from "./space/durable-object";
 export {
   deploymentRuntimeConfigSource,
   RUNTIME_CONFIG_ASSET_PATH,
-} from "./space/deploy-engine";
+} from "./space/deployment-contract";
 export type {
   BranchDeploymentBundle,
   DeploymentAsset,
   DeploymentBundle,
   DeploymentRuntimeConfig,
   SpaceDeploymentResult,
-} from "./space/deploy-engine";
+} from "./space/deployment-contract";
 
 // ── Preview hardening ─────────────────────────────────────────────
 export { stripPreviewSecurityHeaders, STRIPPED_PREVIEW_HEADERS } from "./space/preview-headers";

package/src/space/default-durable-object.ts

@@ -0,0 +1,13 @@
+import {
+  createSpaceDO,
+  type DeployEngine,
+} from "./durable-object"
+
+let deployEnginePromise: Promise<DeployEngine> | undefined
+
+const DefaultSpaceDO = createSpaceDO(
+  () => deployEnginePromise ??= import("@springbrand/space/deploy-engine"),
+)
+
+export const SpaceDO = DefaultSpaceDO
+export type SpaceDO = InstanceType<typeof DefaultSpaceDO>

package/src/space/deploy-engine.ts

@@ -1,5 +1,3 @@
-import type { Git } from "@cloudflare/shell/git"
-import type { FileSystem } from "@cloudflare/shell"
 import {
   createWorker,
   inferContentType,
@@ -7,6 +5,15 @@ import {
   type AssetConfig,
   type Modules,
 } from "@cloudflare/worker-bundler"
+import {
+  deploymentRuntimeConfigSource,
+  RUNTIME_CONFIG_ASSET_PATH,
+  type BranchDeploymentBundle,
+  type DeployContext,
+  type DeploymentAsset,
+  type DeploymentRuntimeConfig,
+  type SpaceDeploymentResult,
+} from "./deployment-contract"
 import { globInfos } from "./fileinfo"
 import {
   parseWranglerConfig,
@@ -14,6 +21,17 @@ import {
   WranglerConfigError,
 } from "./wrangler-config"
 
+export {
+  deploymentRuntimeConfigSource,
+  RUNTIME_CONFIG_ASSET_PATH,
+  type BranchDeploymentBundle,
+  type DeployContext,
+  type DeploymentAsset,
+  type DeploymentBundle,
+  type DeploymentRuntimeConfig,
+  type SpaceDeploymentResult,
+} from "./deployment-contract"
+
 // ─── Deploy Engine ──────────────────────────────────────────────────────────
 
 /** Shared JSON response helper for the internal deploy command handlers. */
@@ -24,53 +42,6 @@ function jsonResponse(data: unknown, status: number = 200): Response {
   })
 }
 
-export interface DeployContext {
-  sql: SqlStorage
-  git: Git
-  fs: FileSystem
-  assetBucket?: R2Bucket
-  assetPrefix?: string
-}
-
-export interface DeploymentBundle {
-  branch: string
-  commitHash: string
-  workerModules: {
-    mainModule: string
-    modules: Record<string, string | Record<string, unknown>>
-    compatibilityDate: string
-  }
-  staticAssets: DeploymentAsset[]
-  assetConfig: AssetConfig | undefined
-  runtimeConfig: DeploymentRuntimeConfig | undefined
-}
-
-export type BranchDeploymentBundle = DeploymentBundle
-
-export interface DeploymentRuntimeConfig {
-  apiBaseUrl: string
-}
-
-export interface SpaceDeploymentResult {
-  branch: string
-  commit_hash: string
-  main_module: string
-  has_assets: boolean
-  compatibility_date: string
-  deployed_at: string
-  asset_root: string | null
-}
-
-export const RUNTIME_CONFIG_ASSET_PATH = "/.springbrand/runtime-config.js"
-
-export interface DeploymentAsset {
-  path: string
-  sourcePath: string | null
-  contentType: string | undefined
-  etag: string
-  size: number
-}
-
 type AssetWriter = (
   asset: Omit<DeploymentAsset, "etag">,
   bytes: Uint8Array,
@@ -436,10 +407,6 @@ function normalizeRuntimeConfig(
   return { apiBaseUrl: url.toString() }
 }
 
-export function deploymentRuntimeConfigSource(config: DeploymentRuntimeConfig): string {
-  return `globalThis.__APP_CONFIG__=Object.freeze(${JSON.stringify(config)});`
-}
-
 async function buildWebsite(
   sourceFiles: Record<string, string>,
   config: ParsedWranglerConfig,

package/src/space/deployment-contract.ts

@@ -0,0 +1,54 @@
+import type { FileSystem } from "@cloudflare/shell"
+import type { Git } from "@cloudflare/shell/git"
+import type { AssetConfig } from "@cloudflare/worker-bundler"
+
+export interface DeployContext {
+  sql: SqlStorage
+  git: Git
+  fs: FileSystem
+  assetBucket?: R2Bucket
+  assetPrefix?: string
+}
+
+export interface DeploymentBundle {
+  branch: string
+  commitHash: string
+  workerModules: {
+    mainModule: string
+    modules: Record<string, string | Record<string, unknown>>
+    compatibilityDate: string
+  }
+  staticAssets: DeploymentAsset[]
+  assetConfig: AssetConfig | undefined
+  runtimeConfig: DeploymentRuntimeConfig | undefined
+}
+
+export type BranchDeploymentBundle = DeploymentBundle
+
+export interface DeploymentRuntimeConfig {
+  apiBaseUrl: string
+}
+
+export interface SpaceDeploymentResult {
+  branch: string
+  commit_hash: string
+  main_module: string
+  has_assets: boolean
+  compatibility_date: string
+  deployed_at: string
+  asset_root: string | null
+}
+
+export interface DeploymentAsset {
+  path: string
+  sourcePath: string | null
+  contentType: string | undefined
+  etag: string
+  size: number
+}
+
+export const RUNTIME_CONFIG_ASSET_PATH = "/.springbrand/runtime-config.js"
+
+export function deploymentRuntimeConfigSource(config: DeploymentRuntimeConfig): string {
+  return `globalThis.__APP_CONFIG__=Object.freeze(${JSON.stringify(config)});`
+}

package/src/space/durable-object.ts

@@ -2,14 +2,12 @@ import { DurableObject } from "cloudflare:workers"
 import { type FileSystem, type FileInfo } from "@cloudflare/shell"
 import { type Git, type GitLogEntry, type GitStatusEntry } from "@cloudflare/shell/git"
 import type { Env } from "../env"
-import {
-  buildBranchDeployment,
-  handleDeployCommand,
-  type BranchDeploymentBundle,
-  type DeploymentRuntimeConfig,
-  type DeployContext,
-  type SpaceDeploymentResult,
-} from "./deploy-engine"
+import type {
+  BranchDeploymentBundle,
+  DeploymentRuntimeConfig,
+  DeployContext,
+  SpaceDeploymentResult,
+} from "./deployment-contract"
 import { globInfos, readDirInfos, toFileInfo } from "./fileinfo"
 import {
   buildInspectorWrapperSource,
@@ -61,6 +59,9 @@ export type {
 /** The complete capability a host holds over one Space. */
 export type SpaceStub = SpaceWorkspacePort & SpaceControlPort & SpaceAppPort
 
+export type DeployEngine = typeof import("@springbrand/space/deploy-engine")
+export type DeployEngineLoader = () => Promise<DeployEngine>
+
 // ─── Inspector result types ────────────────────────────────────────────────
 // These mirror the shapes returned by the wrapper-subclass injected into
 // the dynamic worker (see `inspector-wrapper.ts`). Re-exported at the
@@ -110,7 +111,7 @@ const isReservedPath = isReservedSpacePath
 // Commits/deploys are mirrored to a per-app Cloudflare Artifacts repo
 // (see artifacts-sync.ts), which is the durable source of truth for history.
 
-export class SpaceDO extends DurableObject<Env>
+export abstract class SpaceDOBase extends DurableObject<Env>
   implements SpaceWorkspacePort, SpaceControlPort, SpaceAppPort {
   private backend!: SpaceFsBackend
   private initializationPromise: Promise<void> | null = null
@@ -133,6 +134,8 @@ export class SpaceDO extends DurableObject<Env>
     super(ctx, env)
   }
 
+  protected abstract loadDeployEngine(): Promise<DeployEngine>
+
   private async flushCheckpoint(): Promise<void> {
     await this.backend.flushCheckpoint()
   }
@@ -1110,6 +1113,7 @@ export class SpaceDO extends DurableObject<Env>
   ): Promise<SpaceDeploymentResult> {
     await this.ensureInit()
     return this.lane(async () => {
+      const { handleDeployCommand } = await this.loadDeployEngine()
       // The deploy engine reads the full branch tree, so ensure the Artifacts
       // base is materialized into the overlay first.
       await this.materializeAll()
@@ -1149,6 +1153,7 @@ export class SpaceDO extends DurableObject<Env>
   ): Promise<BranchDeploymentBundle> {
     await this.ensureInit()
     await this.materializeAll()
+    const { buildBranchDeployment } = await this.loadDeployEngine()
     return buildBranchDeployment(
       {
         sql: this.ctx.storage.sql,
@@ -1165,6 +1170,7 @@ export class SpaceDO extends DurableObject<Env>
 
   async undeploy(branch: string): Promise<unknown> {
     await this.ensureInit()
+    const { handleDeployCommand } = await this.loadDeployEngine()
     const fakeRequest = new Request("http://internal/?cmd=undeploy", {
       method: "POST",
       headers: { "Content-Type": "application/json" },
@@ -1183,6 +1189,7 @@ export class SpaceDO extends DurableObject<Env>
 
   async listDeployments(): Promise<unknown> {
     await this.ensureInit()
+    const { handleDeployCommand } = await this.loadDeployEngine()
     const fakeRequest = new Request("http://internal/?cmd=list_deployments")
     const ctx: DeployContext = {
       sql: this.ctx.storage.sql,
@@ -1195,6 +1202,7 @@ export class SpaceDO extends DurableObject<Env>
 
   async getDeployment(branch: string): Promise<unknown> {
     await this.ensureInit()
+    const { handleDeployCommand } = await this.loadDeployEngine()
     const fakeRequest = new Request(`http://internal/?cmd=get_deployment&branch=${encodeURIComponent(branch)}`)
     const ctx: DeployContext = {
       sql: this.ctx.storage.sql,
@@ -1392,6 +1400,7 @@ export class SpaceDO extends DurableObject<Env>
 
     const cmd = new URL(request.url).searchParams.get("cmd")
     if (cmd && ["deploy", "get_deployment", "list_deployments", "undeploy"].includes(cmd)) {
+      const { handleDeployCommand } = await this.loadDeployEngine()
       const deployCtx: DeployContext = {
         sql: this.ctx.storage.sql,
         git: this.git,
@@ -1406,6 +1415,14 @@ export class SpaceDO extends DurableObject<Env>
   }
 }
 
+export function createSpaceDO(loadDeployEngine: DeployEngineLoader): typeof SpaceDOBase {
+  return class SpaceDO extends SpaceDOBase {
+    protected loadDeployEngine(): Promise<DeployEngine> {
+      return loadDeployEngine()
+    }
+  }
+}
+
 // ─── Facet naming ───────────────────────────────────────────────────────────
 
 function facetNameForApp(branch: string): string {

package/src/space/runtime/deploy-engine.d.ts

@@ -0,0 +1 @@
+export * from "@springbrand/space/deploy-engine"