busabase-sdk 0.60.0 → 0.71.0

package/dist/airapp.d.ts

@@ -1,4 +1,4 @@
-import { t as BusabaseClient } from "./client-SAiQFoug.js";
+import { t as BusabaseClient } from "./client-DUJ67kpK.js";
 //#region src/airapp.d.ts
 type NodeChangeRequestInput = Parameters<BusabaseClient["nodes"]["createChangeRequest"]>[0];
 type NodeOperationInput = NodeChangeRequestInput["operations"][number];
@@ -215,13 +215,37 @@ declare function inspectProvisionedResources(client: AirAppProvisioningClient, c
  */
 declare function provisionDeclaredResources(client: AirAppProvisioningClient, config: AirAppResourceConfig): Promise<AirAppResources>;
 /** The client surface `publishAirApp` needs, on top of provisioning. */
-type AirAppPublishClient = AirAppProvisioningClient & Pick<BusabaseClient, "fileTrees" | "changeRequests">;
-/** One file of the app's built AirApp bundle, as `publishAirApp` receives it. */
-interface AirAppFileInput {
+type AirAppPublishClient = AirAppProvisioningClient & Pick<BusabaseClient, "fileTrees" | "changeRequests" | "assets">;
+/**
+ * One file of the app's built AirApp bundle, as `publishAirApp` receives it.
+ *
+ * A file tree holds text inline but binaries as Assets — the server never
+ * stores image bytes in a file operation, it stores an `assetId` pointing at
+ * the Asset library. So a bundle that ships a favicon or an empty-state
+ * illustration needs a shape that can say "these are bytes", and until now
+ * this type could only say `content: string`. Callers did the only thing that
+ * type allowed: read the PNG as UTF-8 and publish the mojibake. That fails
+ * silently — the publish succeeds and the image is simply broken.
+ *
+ * `bytes` is resolved to an `assetId` by `resolveAirAppFileAssets`, which
+ * `publishAirApp` calls for you.
+ */
+type AirAppFileInput = {
   path: string;
-  content: string;
   mimeType?: string;
-}
+} & ({
+  content: string;
+  bytes?: never;
+  assetId?: never;
+} | {
+  bytes: Uint8Array;
+  content?: never;
+  assetId?: never;
+} | {
+  assetId: string;
+  content?: never;
+  bytes?: never;
+});
 /**
  * What one publish did. `merged` is the question a caller actually has — did
  * this bundle go live, or is it waiting for someone?
@@ -258,6 +282,16 @@ type AirAppPublishResult = {
  * makes for a Base's fields (`additiveFieldsFor` only ever appends).
  */
 declare function buildAirAppFileOperations(localFiles: AirAppFileInput[], deployedPaths: Iterable<string>): FileTreeCreateOrUpdateOperation[];
+/**
+ * Upload every `bytes` file in a bundle and hand back the same list with
+ * `assetId` in their place. Text files pass through untouched — a bundle with
+ * no binaries makes no upload calls at all.
+ *
+ * Separate from `buildAirAppFileOperations` so that function can stay pure and
+ * directly testable; separate from `publishAirApp` so a caller assembling its
+ * own file operations (a Skill or Drive sync, say) can reuse it.
+ */
+declare function resolveAirAppFileAssets(client: AirAppPublishClient, files: AirAppFileInput[], fetchImpl?: typeof fetch): Promise<AirAppFileInput[]>;
 /**
  * Publish the app's own AirApp bundle: create it under the Folder when this
  * Space has never had it, or propose the local files as an update when it
@@ -280,4 +314,4 @@ declare function buildAirAppFileOperations(localFiles: AirAppFileInput[], deploy
  */
 declare function publishAirApp(client: AirAppPublishClient, config: AirAppResourceConfig, files: AirAppFileInput[]): Promise<AirAppPublishResult>;
 //#endregion
-export { AirAppBaseDeclaration, AirAppFieldDeclaration, AirAppFileInput, AirAppFolderDeclaration, AirAppNodeDeclaration, AirAppOwnershipRepair, AirAppProvisionedBase, AirAppProvisioningClient, AirAppPublishClient, AirAppPublishResult, AirAppResourceConfig, AirAppResourceOwnership, AirAppResources, AirAppSetupCode, AirAppSetupError, buildAirAppFileOperations, buildProvisionOperations, inspectProvisionedResources, isNotFound, provisionDeclaredResources, publishAirApp, resolveProvisionedFolder };
+export { AirAppBaseDeclaration, AirAppFieldDeclaration, AirAppFileInput, AirAppFolderDeclaration, AirAppNodeDeclaration, AirAppOwnershipRepair, AirAppProvisionedBase, AirAppProvisioningClient, AirAppPublishClient, AirAppPublishResult, AirAppResourceConfig, AirAppResourceOwnership, AirAppResources, AirAppSetupCode, AirAppSetupError, buildAirAppFileOperations, buildProvisionOperations, inspectProvisionedResources, isNotFound, provisionDeclaredResources, publishAirApp, resolveAirAppFileAssets, resolveProvisionedFolder };

package/dist/airapp.js

@@ -1,4 +1,4 @@
-import { t as APP_ROOT_RESOURCE_KEY } from "./template-D10kjpd-.js";
+import { i as uploadAsset, t as APP_ROOT_RESOURCE_KEY } from "./template-DRMp6tKv.js";
 //#region src/airapp.ts
 /**
 * AirApp resource provisioning — how an app claims (or creates) the Folder and
@@ -402,12 +402,50 @@ function provisionDeclaredResources(client, config) {
 */
 function buildAirAppFileOperations(localFiles, deployedPaths) {
 	const deployed = new Set(deployedPaths);
-	return localFiles.map((file) => ({
-		kind: deployed.has(file.path) ? "update" : "create",
-		path: file.path,
-		content: file.content,
-		...file.mimeType ? { mimeType: file.mimeType } : {}
-	}));
+	return localFiles.map((file) => {
+		if (file.bytes) throw new Error(`buildAirAppFileOperations: ${file.path} carries bytes — run resolveAirAppFileAssets first to turn them into an assetId`);
+		return {
+			kind: deployed.has(file.path) ? "update" : "create",
+			path: file.path,
+			...file.assetId ? { assetId: file.assetId } : { content: file.content },
+			...file.mimeType ? { mimeType: file.mimeType } : {}
+		};
+	});
+}
+/**
+* Upload every `bytes` file in a bundle and hand back the same list with
+* `assetId` in their place. Text files pass through untouched — a bundle with
+* no binaries makes no upload calls at all.
+*
+* Separate from `buildAirAppFileOperations` so that function can stay pure and
+* directly testable; separate from `publishAirApp` so a caller assembling its
+* own file operations (a Skill or Drive sync, say) can reuse it.
+*/
+async function resolveAirAppFileAssets(client, files, fetchImpl) {
+	const resolved = [];
+	for (const file of files) {
+		if (!file.bytes) {
+			resolved.push(file);
+			continue;
+		}
+		const mimeType = file.mimeType ?? "application/octet-stream";
+		const asset = await uploadAsset(client, file.bytes, {
+			fileName: basenameOf(file.path),
+			mimeType
+		}, fetchImpl);
+		if (!asset.assetId) throw new Error(`resolveAirAppFileAssets: ${file.path} uploaded but this host returned no assetId, so no file can reference it`);
+		resolved.push({
+			path: file.path,
+			assetId: asset.assetId,
+			mimeType
+		});
+	}
+	return resolved;
+}
+/** Last path segment — file trees always use POSIX separators. */
+function basenameOf(filePath) {
+	const segments = filePath.split("/");
+	return segments[segments.length - 1] || filePath;
 }
 /**
 * Find a still-pending ChangeRequest that already proposes creating this
@@ -461,6 +499,7 @@ async function publishAirApp(client, config, files) {
 	if (!airApp) throw setupError("SETUP_CONFLICT", "This app does not declare an airApp to publish");
 	const current = await inspectProvisionedResources(client, config);
 	if (!current.folder) throw setupError("SETUP_REQUIRED", "Provision the Folder and Bases with provisionDeclaredResources before publishing the AirApp");
+	const resolvedFiles = await resolveAirAppFileAssets(client, files);
 	if (!current.airApp) {
 		const pendingChangeRequestId = await findPendingAirAppCreate(client, airApp.slug);
 		if (pendingChangeRequestId) return {
@@ -474,7 +513,7 @@ async function publishAirApp(client, config, files) {
 			slug: airApp.slug,
 			name: airApp.name,
 			description: airApp.description ?? "",
-			files,
+			files: resolvedFiles,
 			mergeMode: "replace"
 		});
 		return result.materialized ? {
@@ -487,7 +526,7 @@ async function publishAirApp(client, config, files) {
 			changeRequestId: result.id
 		};
 	}
-	const operations = buildAirAppFileOperations(files, (await client.fileTrees.listFiles({
+	const operations = buildAirAppFileOperations(resolvedFiles, (await client.fileTrees.listFiles({
 		nodeId: current.airApp.nodeId,
 		type: "airapp"
 	})).map((file) => file.path));
@@ -505,4 +544,4 @@ async function publishAirApp(client, config, files) {
 	};
 }
 //#endregion
-export { AirAppSetupError, buildAirAppFileOperations, buildProvisionOperations, inspectProvisionedResources, isNotFound, provisionDeclaredResources, publishAirApp, resolveProvisionedFolder };
+export { AirAppSetupError, buildAirAppFileOperations, buildProvisionOperations, inspectProvisionedResources, isNotFound, provisionDeclaredResources, publishAirApp, resolveAirAppFileAssets, resolveProvisionedFolder };