@fabrika/operations-contract 0.4.1 → 0.4.3

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fabrika/operations-contract",
-	"version": "0.4.1",
+	"version": "0.4.3",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -60,6 +60,6 @@
 	},
 	"dependencies": {
 		"zod": "^3.25.76",
-		"@fabrika/app": "^0.4.1"
+		"@fabrika/app": "^0.4.3"
 	}
 }

package/src/release-schemas.ts

@@ -49,6 +49,18 @@ export const operationsReleasePayloadSchema = z.object({
 	observedAt,
 }))
 
+export const operationsSourceMapBuildUploadSchema = z.object({
+	destination: z.object({
+		url: z.string().url(),
+		appId: z.string().min(1),
+		environment: z.string().min(1),
+		serviceKey: z.string().min(1),
+		release: z.string().min(1),
+		runId: z.string().min(1),
+	}),
+	assetRoots: z.array(z.object({ prefix: z.string().startsWith('/'), dir: z.string().min(1) })).max(64),
+})
+
 const releaseRequestHeaderSchema = z.object({ revision: z.number().int().safe().min(1) }).passthrough()
 
 export const operationsReleaseRequestSchema = releaseRequestHeaderSchema.transform((value, ctx) => {

package/src/releases.ts

@@ -1,7 +1,12 @@
 /** Private Delivery → Operations release and artifact protocol; both services ship together. */
 
 import { DEFAULT_OPERATIONS_SERVICE_KEY } from './catalog.js'
-import { operationsReleaseIssueMessage, operationsReleasePayloadSchema, operationsReleaseRequestSchema } from './release-schemas.js'
+import {
+	operationsReleaseIssueMessage,
+	operationsReleasePayloadSchema,
+	operationsReleaseRequestSchema,
+	operationsSourceMapBuildUploadSchema,
+} from './release-schemas.js'
 
 export {
 	operationsArtifactUploadCredentialSchema,
@@ -9,6 +14,7 @@ export {
 	operationsReleaseCoordinateSchema,
 	operationsReleasePayloadSchema,
 	operationsReleaseRequestSchema,
+	operationsSourceMapBuildUploadSchema,
 } from './release-schemas.js'
 
 export const FABRIKA_RELEASE = 'FABRIKA_RELEASE'
@@ -99,6 +105,43 @@ export interface OperationsArtifactUploadConfiguration {
 	runId: string
 }
 
+/** A directory of a build's public assets and the URL path its files are served under: `{ prefix: '/', dir: 'dist/web' }`. */
+export interface OperationsAssetRoot {
+	prefix: string
+	dir: string
+}
+
+/**
+ * What a platform build reads to upload its source maps: the destination without its bearer, which travels apart, and
+ * the asset roots whose maps it uploads. A map's logical path is the URL path of the file it maps.
+ */
+export interface OperationsSourceMapBuildUpload {
+	destination: Omit<OperationsArtifactUploadConfiguration, 'bearer'>
+	assetRoots: OperationsAssetRoot[]
+}
+
+/** Throws on any other value. */
+export function parseOperationsSourceMapBuildUpload(value: unknown): OperationsSourceMapBuildUpload {
+	return operationsSourceMapBuildUploadSchema.parse(value)
+}
+
+/** Whether every source map a build found reached Operations. */
+export type OperationsSourceMapUploadState = 'complete' | 'incomplete'
+
+const SOURCE_MAP_REPORT_PREFIX = 'fabrika-source-maps:'
+const SOURCE_MAP_REPORT = /fabrika-source-maps: \d+ uploaded, state=(complete|incomplete)\s*$/
+
+/** The one line a build prints after its upload; the provider reads the state back from the build log. */
+export function sourceMapUploadReport(uploaded: number, state: OperationsSourceMapUploadState): string {
+	return `${SOURCE_MAP_REPORT_PREFIX} ${uploaded} uploaded, state=${state}`
+}
+
+/** The state a build-log line reports, or `null` for any other line. */
+export function readSourceMapUploadReport(line: string): OperationsSourceMapUploadState | null {
+	const state = SOURCE_MAP_REPORT.exec(line)?.[1]
+	return state === 'complete' || state === 'incomplete' ? state : null
+}
+
 const COMMIT_PATTERN = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/
 
 export function normalizeOperationsCommit(value: string | null | undefined): string | null {