veryfront 0.1.90 → 0.1.92

package/esm/src/server/handlers/dev/styles-css.handler.js

@@ -1,7 +1,7 @@
 import { BaseHandler } from "../response/base.js";
 import { HTTP_OK, PRIORITY_HIGH_DEV } from "../../../utils/constants/index.js";
 import { joinPath } from "../../../utils/path-utils.js";
-import { formatCSSError, getProjectCSS } from "../../../html/styles-builder/tailwind-compiler.js";
+import { formatCSSError, getCSSByHashAsync, getProjectCSS, regenerateCSSByHash, } from "../../../html/styles-builder/tailwind-compiler.js";
 import { DEFAULT_STYLESHEET } from "../../../html/styles-builder/css-hash-cache.js";
 import { resolveStyleContentVersion } from "../../../html/styles-builder/content-version.js";
 import { createPreparedProjectCSSContext, storePreparedProjectCSS, tryGetPreparedProjectCSS, } from "../../../html/styles-builder/prepared-project-css-cache.js";
@@ -48,6 +48,15 @@ export class StylesCSSHandler extends BaseHandler {
                         return this.respond(responseBuilder.withContentType("text/css; charset=utf-8", prepared.css, HTTP_OK));
                     }
                 }
+                const remotePrepared = await this.tryResolveRemotePreparedCSS(ctx, projectScope, styleProfile.hash, contentContext, preparedContext);
+                if (remotePrepared) {
+                    logger.debug("Prepared CSS resolved via style artifact metadata", {
+                        projectScope,
+                        styleProfileHash: styleProfile.hash,
+                        cssHash: remotePrepared.hash,
+                    });
+                    return this.respond(responseBuilder.withContentType("text/css; charset=utf-8", remotePrepared.css, HTTP_OK));
+                }
                 let candidates;
                 try {
                     candidates = await extractProjectCandidates(ctx);
@@ -112,6 +121,9 @@ body::before {
                         hash: result.hash,
                     });
                 }
+                if ("hash" in result) {
+                    await this.registerPreparedCSSArtifact(ctx, styleProfile.hash, contentContext, result.hash);
+                }
                 return this.respond(responseBuilder.withContentType("text/css; charset=utf-8", result.css, HTTP_OK));
             });
         }
@@ -158,6 +170,13 @@ body::before {
         const fsAdapter = wrappedFs.getUnderlyingAdapter();
         return typeof fsAdapter.getContentContext === "function" ? fsAdapter.getContentContext() : null;
     }
+    getVeryfrontApiClient(ctx) {
+        const wrappedFs = ctx.adapter.fs;
+        if (typeof wrappedFs.getUnderlyingAdapter !== "function")
+            return null;
+        const fsAdapter = wrappedFs.getUnderlyingAdapter();
+        return typeof fsAdapter.getClient === "function" ? fsAdapter.getClient() : null;
+    }
     createPreparedCSSContext(projectScope, rawCss, styleProfileHash, contentContext, ctx) {
         if (!projectScope)
             return undefined;
@@ -171,4 +190,105 @@ body::before {
             buildMode: "production",
         });
     }
+    resolveStyleArtifactSelector(contentContext, ctx) {
+        if (contentContext?.sourceType === "branch" && contentContext.branch) {
+            return {
+                branch: contentContext.branch,
+            };
+        }
+        if (contentContext?.sourceType === "environment" && contentContext.environmentName) {
+            return {
+                environmentName: contentContext.environmentName,
+            };
+        }
+        if (contentContext?.sourceType === "release" && contentContext.releaseId) {
+            return {
+                releaseId: contentContext.releaseId,
+            };
+        }
+        if (ctx.parsedDomain?.branch) {
+            return {
+                branch: ctx.parsedDomain.branch,
+            };
+        }
+        if (ctx.environmentName) {
+            return {
+                environmentName: ctx.environmentName,
+            };
+        }
+        if (ctx.releaseId) {
+            return {
+                releaseId: ctx.releaseId,
+            };
+        }
+        return null;
+    }
+    async tryResolveRemotePreparedCSS(ctx, projectScope, styleProfileHash, contentContext, preparedContext) {
+        if (!projectScope)
+            return undefined;
+        const selector = this.resolveStyleArtifactSelector(contentContext, ctx);
+        if (!selector)
+            return undefined;
+        const client = this.getVeryfrontApiClient(ctx);
+        if (!client)
+            return undefined;
+        try {
+            const resolved = await client.resolveStyleArtifact({
+                ...selector,
+                styleProfileHash,
+            });
+            if (resolved.status !== "ready" || !resolved.artifactHash) {
+                return undefined;
+            }
+            const css = await this.getPreparedCSSByHash(resolved.artifactHash, projectScope);
+            if (!css)
+                return undefined;
+            if (preparedContext) {
+                await storePreparedProjectCSS(preparedContext, {
+                    css,
+                    hash: resolved.artifactHash,
+                });
+            }
+            return {
+                css,
+                hash: resolved.artifactHash,
+            };
+        }
+        catch (error) {
+            logger.debug("Failed to resolve prepared CSS via style artifact metadata", {
+                projectScope,
+                styleProfileHash,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return undefined;
+        }
+    }
+    async getPreparedCSSByHash(cssHash, projectScope) {
+        const cached = await getCSSByHashAsync(cssHash);
+        if (cached)
+            return cached;
+        return regenerateCSSByHash(cssHash, projectScope);
+    }
+    async registerPreparedCSSArtifact(ctx, styleProfileHash, contentContext, cssHash) {
+        const selector = this.resolveStyleArtifactSelector(contentContext, ctx);
+        if (!selector)
+            return;
+        const client = this.getVeryfrontApiClient(ctx);
+        if (!client)
+            return;
+        try {
+            await client.upsertStyleArtifact({
+                ...selector,
+                styleProfileHash,
+                artifactHash: cssHash,
+            });
+        }
+        catch (error) {
+            logger.debug("Failed to register prepared CSS artifact", {
+                cssHash,
+                styleProfileHash,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
 }

package/esm/src/server/handlers/monitoring/health.handler.js

@@ -2,7 +2,7 @@ import { BaseHandler } from "../response/base.js";
 import { joinPath } from "../../../utils/path-utils.js";
 import { HTTP_OK, HTTP_UNAVAILABLE, PRIORITY_HIGH } from "../../../utils/constants/index.js";
 import { isTracingDegraded, isTracingEnabled } from "../../../observability/tracing/index.js";
-import { VERSION } from "../../../utils/version.js";
+import { RUNTIME_VERSION } from "../../../utils/version.js";
 let serverInitialized = false;
 export function setServerInitialized(ready) {
     serverInitialized = ready;
@@ -57,7 +57,7 @@ export class HealthHandler extends BaseHandler {
             status: tracingDegraded ? "degraded" : "ok",
             timestamp: new Date().toISOString(),
             mode: hasStaticBuild ? "static+ssr" : "ssr",
-            version: VERSION,
+            version: RUNTIME_VERSION,
             tracing: {
                 enabled: isTracingEnabled(),
                 degraded: tracingDegraded,

package/esm/src/utils/logger/logger.js

@@ -1,7 +1,7 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { getEnv } from "../../platform/compat/process.js";
 import { hasDenoRuntime, hasNodeProcess } from "../runtime-guards.js";
-import { VERSION } from "../version.js";
+import { RUNTIME_VERSION } from "../version.js";
 import { ANSI, colorize, formatContextText, formatTimestamp, LEVEL_COLORS, LEVEL_GLYPHS, padTag, serializeError, } from "./core.js";
 export var LogLevel;
 (function (LogLevel) {
@@ -165,7 +165,7 @@ class ConsoleLogger {
             timestamp: new Date().toISOString(),
             level,
             service: this.prefix.toLowerCase(),
-            veryfrontVersion: VERSION,
+            veryfrontVersion: RUNTIME_VERSION,
             message,
         };
         if (this.componentName)

package/esm/src/utils/version.d.ts

@@ -1,4 +1,12 @@
-export declare const VERSION = "0.1.89";
+export declare const VERSION = "0.1.92";
+export declare function normalizeVeryfrontVersion(version: string | undefined): string | undefined;
+export declare function resolveRuntimeVersion(options?: {
+    veryfrontVersion?: string;
+    releaseVersion?: string;
+    denoVersion?: string;
+    fallbackVersion?: string;
+}): string;
+export declare const RUNTIME_VERSION: string;
 export declare const SERVER_START_TIME: number;
 export interface BuildVersion {
     framework: string;

package/esm/src/utils/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/src/utils/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,WAAW,CAAC;AAEhC,eAAO,MAAM,iBAAiB,EAAE,MAAmB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,CAM1E"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/src/utils/version.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,OAAO,WAAW,CAAC;AAEhC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGzF;AAUD,wBAAgB,qBAAqB,CAAC,OAAO,GAAE;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAKd;AAED,eAAO,MAAM,eAAe,QAK1B,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,MAAmB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,YAAY,CAM1E"}

package/esm/src/utils/version.js

@@ -1,10 +1,37 @@
+import denoConfig from "../../deno.js";
+import { getEnv } from "../platform/compat/process.js";
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.89";
+export const VERSION = "0.1.92";
+export function normalizeVeryfrontVersion(version) {
+    if (!version)
+        return undefined;
+    return version.replace(/^v(?=\d)/, "");
+}
+function getVersionEnv(name) {
+    try {
+        return getEnv(name);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function resolveRuntimeVersion(options = {}) {
+    return normalizeVeryfrontVersion(options.veryfrontVersion ?? options.releaseVersion) ??
+        normalizeVeryfrontVersion(options.denoVersion) ??
+        options.fallbackVersion ??
+        VERSION;
+}
+export const RUNTIME_VERSION = resolveRuntimeVersion({
+    veryfrontVersion: getVersionEnv("VERYFRONT_VERSION"),
+    releaseVersion: getVersionEnv("RELEASE_VERSION"),
+    denoVersion: typeof denoConfig.version === "string" ? denoConfig.version : undefined,
+    fallbackVersion: VERSION,
+});
 export const SERVER_START_TIME = Date.now();
 export function createBuildVersion(projectUpdatedAt) {
     return {
-        framework: VERSION,
+        framework: RUNTIME_VERSION,
         serverStart: SERVER_START_TIME,
         projectUpdated: projectUpdatedAt,
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.90",
+  "version": "0.1.92",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.90",
+  "version": "0.1.92",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [

package/src/src/config/environment-config.ts

@@ -188,7 +188,7 @@ function readEnvSnapshot(): EnvironmentConfig {
       ? parseNumber(v8MaxOldSpaceSizeRaw, 0) || undefined
       : undefined,
 
-    veryfrontVersion: getEnv("VERYFRONT_VERSION") || undefined,
+    veryfrontVersion: getEnv("VERYFRONT_VERSION") || getEnv("RELEASE_VERSION") || undefined,
   };
 }
 

package/src/src/jobs/schemas.ts

@@ -115,7 +115,7 @@ const BaseJobSchema = z.object({
   id: z.string().uuid(),
   project_id: z.string().uuid(),
   environment_id: z.string().uuid().nullable(),
-  branch_id: z.string().nullable().optional().default(null),
+  branch_id: z.string().nullable().optional(),
   cron_job_id: z.string().uuid().nullable(),
   batch_id: z.string().uuid().nullable(),
   name: z.string(),
@@ -134,7 +134,7 @@ const BaseJobSchema = z.object({
 });
 
 export const JobSchema = BaseJobSchema.extend({
-  failed_reason: z.string().nullable().optional().default(null),
+  failed_reason: z.string().nullable().optional(),
   kind: JobKindSchema.optional().default(null),
   failure_detail: z.string().nullable().optional().default(null),
   result_summary: JobResultSummarySchema.optional().default(null),
@@ -242,7 +242,7 @@ export const CronJobSchema = z.object({
   id: z.string().uuid(),
   project_id: z.string().uuid(),
   environment_id: z.string().uuid().nullable(),
-  branch_id: z.string().nullable().optional().default(null),
+  branch_id: z.string().nullable().optional(),
   name: z.string(),
   status: CronJobStatusSchema,
   target: z.string(),

package/src/src/observability/metrics/manager.ts

@@ -10,7 +10,7 @@ import { loadConfig } from "./config.js";
 import { initializeInstruments } from "../instruments/index.js";
 import { MetricsRecorder } from "./recorder.js";
 import type { MetricsConfig, MetricsInstruments, OpenTelemetryAPI, RuntimeState } from "./types.js";
-import { VERSION } from "../../utils/version.js";
+import { RUNTIME_VERSION } from "../../utils/version.js";
 
 const logger = serverLogger.component("metrics");
 
@@ -80,7 +80,7 @@ export class MetricsManager {
 
     try {
       this.api = await import("@opentelemetry/api");
-      this.meter = this.api.metrics.getMeter(finalConfig.prefix, VERSION);
+      this.meter = this.api.metrics.getMeter(finalConfig.prefix, RUNTIME_VERSION);
 
       this.instruments = initializeInstruments(this.meter, finalConfig, this.runtimeState);
       this.recorder.instruments = this.instruments;

package/src/src/observability/tracing/otlp-setup.ts

@@ -13,7 +13,7 @@ import * as dntShim from "../../../_dnt.shims.js";
 
 import { getOtelTracingConfig } from "../../config/env.js";
 import { serverLogger } from "../../utils/index.js";
-import { VERSION } from "../../utils/version.js";
+import { RUNTIME_VERSION } from "../../utils/version.js";
 
 const logger = serverLogger.component("otel");
 
@@ -118,7 +118,7 @@ export async function initializeOTLP(): Promise<void> {
 
     const resource = new Resource({
       [ATTR_SERVICE_NAME]: config.serviceName,
-      [ATTR_SERVICE_VERSION]: VERSION,
+      [ATTR_SERVICE_VERSION]: RUNTIME_VERSION,
     });
 
     const endpointBase = config.endpoint.replace(/\/$/, "");

package/src/src/platform/adapters/fs/veryfront/adapter.ts

@@ -350,10 +350,10 @@ export class VeryfrontFSAdapter implements FSAdapter {
         sourceFilesWithContent: fileSummary.sourceFilesWithContent,
       });
 
-      // Trigger CSS pre-generation after the initial file snapshot is ready.
-      // This keeps stylesheet generation off the first styles request for both
-      // preview branches and published content.
-      if (fileSummary.sourceFilesWithContent > 0) {
+      // Trigger CSS pre-generation after the initial file snapshot is ready for
+      // published contexts. Branch previews should first try remote metadata
+      // recovery on cold starts instead of repopulating the prepared cache here.
+      if (fileSummary.sourceFilesWithContent > 0 && this.shouldBackgroundPregenerateStyles()) {
         this.triggerCSSPregeneration(files).catch(() => {
           // Error already logged in triggerCSSPregeneration
         });
@@ -403,6 +403,13 @@ export class VeryfrontFSAdapter implements FSAdapter {
     return isPrefixBeingInvalidated(prefix);
   }
 
+  private shouldBackgroundPregenerateStyles(): boolean {
+    // Branch previews should recover the last registered stylesheet artifact on
+    // cold starts before rebuilding CSS locally. Live edit pokes still
+    // pregenerate through the WebSocket path after branch content changes.
+    return this.contentContext?.sourceType !== "branch";
+  }
+
   private scheduleFileListWarmup(reason: string, cacheKey?: string): void {
     if (!this.initialized || !this.contentContext) return;
 
@@ -446,7 +453,7 @@ export class VeryfrontFSAdapter implements FSAdapter {
         await this.cache.setAsync(effectiveCacheKey, files);
         const fileSummary = summarizeFileList(files);
 
-        if (fileSummary.sourceFilesWithContent > 0) {
+        if (fileSummary.sourceFilesWithContent > 0 && this.shouldBackgroundPregenerateStyles()) {
           this.triggerCSSPregeneration(files).catch(() => {
             // Error already logged in triggerCSSPregeneration
           });

package/src/src/platform/adapters/veryfront-api-client/client.ts

@@ -3,7 +3,10 @@ import {
   type FileDetail,
   type FileListResult,
   type ListFilesOptions,
+  type ProjectStyleArtifactResolution,
+  type ResolveStyleArtifactInput,
   type TokenProvider,
+  type UpsertStyleArtifactInput,
   VeryfrontAPIOperations,
 } from "./operations.js";
 import { API_CLIENT_ERROR, type VeryfrontAPIConfig } from "./types.js";
@@ -340,6 +343,20 @@ export class VeryfrontApiClient {
     return this.operations.lookupProjectByDomain(domain);
   }
 
+  resolveStyleArtifact(
+    input: ResolveStyleArtifactInput,
+    projectRef = this.getProjectSlug()!,
+  ): Promise<ProjectStyleArtifactResolution> {
+    return this.operations.resolveStyleArtifact(projectRef, input);
+  }
+
+  upsertStyleArtifact(
+    input: UpsertStyleArtifactInput,
+    projectRef = this.getProjectSlug()!,
+  ): Promise<ProjectStyleArtifactResolution> {
+    return this.operations.upsertStyleArtifact(projectRef, input);
+  }
+
   // =============================================================================
   // Adapter Convenience Methods
   // =============================================================================

package/src/src/platform/adapters/veryfront-api-client/index.ts

@@ -9,6 +9,10 @@ export {
   type FileDetail,
   type FileListResult,
   type ListFilesOptions,
+  type ProjectStyleArtifactResolution,
+  type ResolveStyleArtifactInput,
+  type StyleArtifactSelector,
+  type UpsertStyleArtifactInput,
   VeryfrontAPIOperations,
 } from "./operations.js";
 export { type RequestOptions, requestWithRetry, type RetryConfig } from "./retry-handler.js";
@@ -39,4 +43,6 @@ export {
   ProjectSchema,
   ReleaseFileDetailSchema,
   ReleaseFileListItemSchema,
+  type StyleArtifactResolveResponse,
+  StyleArtifactResolveResponseSchema,
 } from "./schemas/index.js";

package/src/src/platform/adapters/veryfront-api-client/operations.ts

@@ -1,6 +1,6 @@
 import { logger as baseLogger } from "../../../utils/index.js";
 import { z } from "zod";
-import { requestWithRetry, type RetryConfig } from "./retry-handler.js";
+import { type RequestOptions, requestWithRetry, type RetryConfig } from "./retry-handler.js";
 import { API_CLIENT_ERROR } from "./types.js";
 import {
   BranchFileDetailSchema,
@@ -15,6 +15,7 @@ import {
   type ProjectFile,
   ProjectSchema,
   ReleaseFileDetailSchema,
+  StyleArtifactResolveResponseSchema,
 } from "./schemas/index.js";
 import { withSpan } from "../../../observability/tracing/otlp-setup.js";
 import { SpanNames } from "../../../observability/tracing/span-names.js";
@@ -53,6 +54,32 @@ export interface FileDetail {
   release_version?: string | null;
 }
 
+export interface StyleArtifactSelector {
+  branch?: string;
+  environmentName?: string;
+  releaseId?: string;
+}
+
+export interface ResolveStyleArtifactInput extends StyleArtifactSelector {
+  styleProfileHash: string;
+}
+
+export interface UpsertStyleArtifactInput extends ResolveStyleArtifactInput {
+  artifactHash: string;
+  assetPath?: string;
+  contentType?: string;
+  etag?: string;
+}
+
+export interface ProjectStyleArtifactResolution {
+  status: "ready" | "missing";
+  artifactHash?: string;
+  assetPath?: string;
+  etag?: string;
+  contentType?: string;
+  updatedAt?: string;
+}
+
 function buildListParams(options: ListFilesOptions): URLSearchParams {
   const { cursor, limit = DEFAULT_PAGE_LIMIT, pattern, sortBy = "updated_at", sortOrder = "desc" } =
     options;
@@ -81,6 +108,30 @@ function mapProjectFile<T extends ProjectFile>(file: T): ProjectFile {
   };
 }
 
+function buildStyleArtifactParams(input: ResolveStyleArtifactInput): URLSearchParams {
+  const params = new URLSearchParams({
+    style_profile_hash: input.styleProfileHash,
+  });
+
+  if (input.branch) params.set("branch", input.branch);
+  if (input.environmentName) params.set("environment_name", input.environmentName);
+  if (input.releaseId) params.set("release_id", input.releaseId);
+
+  return params;
+}
+
+function mapStyleArtifactResolution(raw: unknown): ProjectStyleArtifactResolution {
+  const response = StyleArtifactResolveResponseSchema.parse(raw);
+  return {
+    status: response.status,
+    artifactHash: response.artifact_hash,
+    assetPath: response.asset_path,
+    etag: response.etag,
+    contentType: response.content_type,
+    updatedAt: response.updated_at,
+  };
+}
+
 async function listAllFiles(
   list: (cursor?: string) => Promise<FileListResult>,
 ): Promise<ProjectFile[]> {
@@ -423,11 +474,67 @@ export class VeryfrontAPIOperations {
     );
   }
 
-  private request(endpoint: string): Promise<unknown> {
+  async resolveStyleArtifact(
+    projectRef: string,
+    input: ResolveStyleArtifactInput,
+  ): Promise<ProjectStyleArtifactResolution> {
+    const params = buildStyleArtifactParams(input);
+    const url = `/projects/${encodeURIComponent(projectRef)}/style-artifacts/current?${params}`;
+    logger.debug("resolveStyleArtifact", {
+      projectRef,
+      branch: input.branch,
+      environmentName: input.environmentName,
+      releaseId: input.releaseId,
+      styleProfileHash: input.styleProfileHash,
+    });
+
+    return mapStyleArtifactResolution(await this.request(url));
+  }
+
+  async upsertStyleArtifact(
+    projectRef: string,
+    input: UpsertStyleArtifactInput,
+  ): Promise<ProjectStyleArtifactResolution> {
+    const url = `/projects/${encodeURIComponent(projectRef)}/style-artifacts/current`;
+    logger.debug("upsertStyleArtifact", {
+      projectRef,
+      branch: input.branch,
+      environmentName: input.environmentName,
+      releaseId: input.releaseId,
+      styleProfileHash: input.styleProfileHash,
+      artifactHash: input.artifactHash,
+    });
+
+    return mapStyleArtifactResolution(
+      await this.request(url, {
+        method: "PUT",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+          style_profile_hash: input.styleProfileHash,
+          branch: input.branch,
+          environment_name: input.environmentName,
+          release_id: input.releaseId,
+          artifact_hash: input.artifactHash,
+          asset_path: input.assetPath,
+          content_type: input.contentType,
+          etag: input.etag,
+        }),
+      }),
+    );
+  }
+
+  private request(endpoint: string, options: RequestOptions = {}): Promise<unknown> {
     return withSpan(
       SpanNames.API_REQUEST,
       () =>
-        requestWithRetry(`${this.apiBaseUrl}${endpoint}`, this.tokenProvider(), this.retryConfig),
+        requestWithRetry(
+          `${this.apiBaseUrl}${endpoint}`,
+          this.tokenProvider(),
+          this.retryConfig,
+          options,
+        ),
       { "api.endpoint": endpoint, "api.base_url": this.apiBaseUrl },
     );
   }

package/src/src/platform/adapters/veryfront-api-client/schemas/api.schema.ts

@@ -147,6 +147,15 @@ export const LookupDomainResponseSchema = z.object({
   release_id: z.string().uuid().nullable(),
 });
 
+export const StyleArtifactResolveResponseSchema = z.object({
+  status: z.enum(["ready", "missing"]),
+  artifact_hash: z.string().optional(),
+  asset_path: z.string().optional(),
+  etag: z.string().optional(),
+  content_type: z.string().optional(),
+  updated_at: z.string().optional(),
+});
+
 export type Project = z.infer<typeof ProjectSchema>;
 export type ProjectFile = z.infer<typeof ProjectFileSchema>;
 export type PageInfo = z.infer<typeof PageInfoSchema>;
@@ -165,6 +174,7 @@ export type ListReleaseFilesResponse = z.infer<typeof ListReleaseFilesResponseSc
 export type ReleaseFileDetail = z.infer<typeof ReleaseFileDetailSchema>;
 
 export type LookupDomainResponse = z.infer<typeof LookupDomainResponseSchema>;
+export type StyleArtifactResolveResponse = z.infer<typeof StyleArtifactResolveResponseSchema>;
 
 export const API_ENDPOINTS = {
   listProjects: {
@@ -212,4 +222,10 @@ export const API_ENDPOINTS = {
     path: "/projects/{domain}",
     description: "Look up project by custom domain (resolved via project_reference)",
   },
+  resolveStyleArtifact: {
+    method: "GET" as const,
+    path: "/projects/{projectRef}/style-artifacts/current",
+    description:
+      "Resolve metadata for the latest ready style artifact for a branch, environment, or release selector",
+  },
 } as const;

package/src/src/platform/adapters/veryfront-api-client/schemas/index.ts

@@ -35,4 +35,6 @@ export {
   ReleaseFileDetailSchema,
   type ReleaseFileListItem,
   ReleaseFileListItemSchema,
+  type StyleArtifactResolveResponse,
+  StyleArtifactResolveResponseSchema,
 } from "./api.schema.js";

package/src/src/proxy/logger.ts

@@ -1,10 +1,8 @@
-// Import version from root deno.json (the source of truth)
 import * as dntShim from "../../_dnt.shims.js";
-
-import denoConfig from "../../deno.js";
 import { getEnv } from "./env.js";
 import { getTraceContext } from "./tracing.js";
 import { AsyncLocalStorage } from "node:async_hooks";
+import { PROXY_RUNTIME_VERSION } from "./version.js";
 
 // NOTE: Formatting utilities are INLINED below instead of imported from ../utils/logger/core.ts
 // because the proxy Docker build only copies src/proxy/ and has no access to src/utils/.
@@ -45,10 +43,6 @@ function getProxyRequestContext(): ProxyRequestContext | undefined {
   return requestContextStore.getStore();
 }
 
-// Get version from environment variable or root deno.json
-const VERYFRONT_VERSION: string = getEnv("VERYFRONT_VERSION") ??
-  (typeof denoConfig.version === "string" ? denoConfig.version : "0.0.0");
-
 export type LogLevel = "debug" | "info" | "warn" | "error";
 
 const LOG_LEVEL_ORDER: Record<LogLevel, number> = {
@@ -295,7 +289,7 @@ class ProxyLogger {
       timestamp: new Date().toISOString(),
       level,
       service: "proxy",
-      veryfrontVersion: VERYFRONT_VERSION,
+      veryfrontVersion: PROXY_RUNTIME_VERSION,
       message,
       ...(traceCtx.traceId && { traceId: traceCtx.traceId, spanId: traceCtx.spanId }),
       // Include request context fields at top level (like renderer logs)