@zgeoff/imp-client 0.8.0 → 0.9.0

package/dist/index.d.ts

@@ -5662,6 +5662,14 @@ interface ServerCheck {
   readonly compatible: boolean;
 }
 //#endregion
+//#region src/build-image.d.ts
+type BuildContext = Blob | Uint8Array<ArrayBuffer> | ReadableStream<Uint8Array>;
+interface BuildImageOptions {
+  readonly dockerfile?: string;
+  readonly size?: number;
+  readonly signal?: AbortSignal;
+}
+//#endregion
 //#region src/exec/open-exec-session.d.ts
 interface ExecStart {
   readonly name: string;
@@ -5796,6 +5804,7 @@ interface ImpClientOptions {
 interface ImpClient extends RpcClient {
   readonly requireAwake: (name: string, options?: RequireAwakeOptions) => Promise<Imp>;
   readonly checkServer: () => Promise<ServerCheck>;
+  readonly buildImage: (name: string, context: BuildContext, options?: BuildImageOptions) => Promise<Image>;
   readonly openExec: (name: string, argv: readonly string[], options?: ExecOptions) => Promise<ExecHandle>;
   readonly run: (name: string, argv: readonly string[], options?: RunOptions) => Promise<RunResult>;
   readonly openConsole: (name: string, options?: ConsoleOptions) => Promise<ExecHandle>;
@@ -5865,4 +5874,4 @@ export declare class ExecError extends Error {
   }>);
 }
 //#endregion
-export { type ApiCall, type AttachOptions, type Checkpoint, type ConsoleOptions, type DetachReason, type ExecClientErrorCode, type ExecExit, type ExecHandle, type ExecOptions, type ExecOutcome, type ExecSession, type ExecSessionOptions, type ExecSocket, type ExecStarted, type Identity, type Image, type Imp, type ImpClient, type ImpClientOptions, type ImpEvent, type ImpState, ORPCError, type RequireAwakeOptions, type ReverseForward, type ReverseForwardEnd, type ReverseForwardOptions, type ReverseGuest, type ReverseListening, type ReverseRelay, type ReverseRelayHandlers, type RunOptions, type RunResult, type Scope, type ServerCheck, type Session, type SshKey, type SystemInfo, type Token, isDefinedError, safe };
+export { type ApiCall, type AttachOptions, type BuildContext, type BuildImageOptions, type Checkpoint, type ConsoleOptions, type DetachReason, type ExecClientErrorCode, type ExecExit, type ExecHandle, type ExecOptions, type ExecOutcome, type ExecSession, type ExecSessionOptions, type ExecSocket, type ExecStarted, type Identity, type Image, type Imp, type ImpClient, type ImpClientOptions, type ImpEvent, type ImpState, ORPCError, type RequireAwakeOptions, type ReverseForward, type ReverseForwardEnd, type ReverseForwardOptions, type ReverseGuest, type ReverseListening, type ReverseRelay, type ReverseRelayHandlers, type RunOptions, type RunResult, type Scope, type ServerCheck, type Session, type SshKey, type SystemInfo, type Token, isDefinedError, safe };

package/dist/index.js

@@ -3,7 +3,7 @@ import { RPCLink } from "@orpc/client/fetch";
 import * as z from "zod";
 //#endregion
 //#region src/check-server.ts
-const CLIENT_VERSION = "0.8.0";
+const CLIENT_VERSION = "0.9.0";
 async function checkServer(rpc) {
 	const info = await rpc.system.info();
 	return {
@@ -29,6 +29,29 @@ function parseVersion(version) {
 //#region ../api/src/name-schema.ts
 const NameSchema = z.string().regex(/^[a-z][a-z0-9-]{0,30}$/, "must be a lowercase letter followed by up to 30 lowercase letters, digits or hyphens");
 //#endregion
+//#region ../api/src/image-schema.ts
+const ImageSchema = z.object({
+	id: z.string(),
+	name: NameSchema,
+	ref: z.string(),
+	digest: z.string(),
+	createdAt: z.date(),
+	sizeBytes: z.int().nonnegative()
+});
+//#endregion
+//#region ../api/src/image-build-protocol.ts
+const IMAGE_BUILD_PATH = "/images/build";
+const DockerfilePathSchema = z.string().min(1).refine((path) => !path.startsWith("/") && !path.split(/[/\\]/u).includes(".."), { message: "the Dockerfile path must be relative and stay inside the build context" });
+z.object({
+	name: NameSchema,
+	dockerfile: DockerfilePathSchema.optional()
+});
+const ImageBuildResultSchema = ImageSchema.extend({ createdAt: z.coerce.date() });
+const ImageBuildErrorSchema = z.object({
+	code: z.string(),
+	message: z.string()
+});
+//#endregion
 //#region ../api/src/session-schema.ts
 const SessionNameSchema = z.string().regex(/^[a-z0-9][a-z0-9-]{0,31}$/, "must be a lowercase letter or digit followed by up to 31 lowercase letters, digits or hyphens");
 const SessionExitSchema = z.object({
@@ -222,6 +245,44 @@ const CONSOLE_SHELL = [
 	"exec \"$shell\" -l"
 ].join("\n");
 //#endregion
+//#region src/resolve-impd-url.ts
+function resolveImpdUrl(base, path) {
+	const url = new URL(base);
+	url.pathname = `${url.pathname.replace(/\/+$/, "")}${path}`;
+	return url;
+}
+//#endregion
+//#region src/build-image.ts
+async function buildImage(deps, name, context, options = {}) {
+	const url = resolveImpdUrl(deps.baseUrl, IMAGE_BUILD_PATH);
+	url.searchParams.set("name", name);
+	if (options.dockerfile !== void 0) url.searchParams.set("dockerfile", options.dockerfile);
+	const headers = { "content-type": "application/x-tar" };
+	if (deps.token !== null) headers["authorization"] = `Bearer ${deps.token}`;
+	if (options.size !== void 0) headers["content-length"] = String(options.size);
+	const init = {
+		method: "POST",
+		headers,
+		body: context,
+		duplex: "half",
+		...options.signal !== void 0 && { signal: options.signal }
+	};
+	const request = new Request(url.href, init);
+	const response = await (deps.fetch ?? fetch)(request);
+	const body = await response.json().catch(() => null);
+	if (response.ok) return ImageBuildResultSchema.parse(body);
+	const failure = ImageBuildErrorSchema.safeParse(body);
+	if (failure.success) throw new ORPCError$1(failure.data.code, {
+		status: response.status,
+		message: failure.data.message
+	});
+	const code = response.status === 401 ? "UNAUTHORIZED" : "INTERNAL_SERVER_ERROR";
+	throw new ORPCError$1(code, {
+		status: response.status,
+		message: `impd answered ${String(response.status)} to the image build`
+	});
+}
+//#endregion
 //#region src/exec/exec-error.ts
 var ExecError = class extends Error {
 	code;
@@ -244,13 +305,6 @@ function toExecError(outcome) {
 	return new ExecError("LOCAL_ERROR", "an output handler threw", { cause: outcome.error });
 }
 //#endregion
-//#region src/resolve-impd-url.ts
-function resolveImpdUrl(base, path) {
-	const url = new URL(base);
-	url.pathname = `${url.pathname.replace(/\/+$/, "")}${path}`;
-	return url;
-}
-//#endregion
 //#region src/exec/check-impd-access.ts
 const CHECK_TIMEOUT_MS = 5e3;
 async function checkImpdAccess(baseUrl, token, customFetch = fetch) {
@@ -775,7 +829,8 @@ function createImpClient(options) {
 		openConsole: (name, consoleOptions) => openConsole(execDeps, name, consoleOptions),
 		openAttach: (name, session, attachOptions) => openAttach(execDeps, name, session, attachOptions),
 		requireAwake: (name, awakeOptions) => requireAwake(rpc, name, awakeOptions),
-		checkServer: () => checkServer(rpc)
+		checkServer: () => checkServer(rpc),
+		buildImage: (name, context, buildOptions) => buildImage(execDeps, name, context, buildOptions)
 	};
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zgeoff/imp-client",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Typed client for impd, the imp host daemon: imps, checkpoints, images and exec",
   "license": "MIT",
   "repository": {