@drawcall/design 0.5.0 → 0.5.2

package/dist/v1/contract.js

@@ -1,6 +1,7 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
-import { createFrameSchema, createProjectFromBriefSchema, designIdSchema, fileListSchema, fileMutationSchema, fileSchema, fileTextSchema, frameNameSchema, frameSchema, generateImageFrameSchema, projectDirectoryPathSchema, projectNameSchema, projectPathSchema, projectSchema, screenshotSchema, userSchema, } from "./schemas.js";
+import { projectFrameLayoutSchema } from "../project-state.js";
+import { cameraPoseSchema, createFrameSchema, createProjectFromBriefSchema, designIdSchema, fileListSchema, fileMutationSchema, fileSchema, fileTextSchema, frameExportSchema, frameNameSchema, frameSchema, generateImageFrameSchema, projectDirectoryPathSchema, projectNameSchema, projectPathSchema, projectSchema, screenshotSchema, userSchema, } from "./schemas.js";
 const projectInputSchema = z.object({ project: designIdSchema });
 const frameInputSchema = projectInputSchema.extend({ frame: designIdSchema });
 const fileInputSchema = projectInputSchema.extend({ path: projectPathSchema });
@@ -57,6 +58,24 @@ export const contract = {
             .route({ method: "PATCH", path: "/projects/{project}/frames/{frame}" })
             .input(frameInputSchema.extend({ name: frameNameSchema }))
             .output(frameSchema),
+        setCamera: oc
+            .route({
+            method: "PUT",
+            path: "/projects/{project}/frames/{frame}/camera",
+        })
+            .input(frameInputSchema.extend({
+            camera: cameraPoseSchema,
+            expectedContentRevision: z.number().int().nonnegative(),
+            expectedUpdatedAt: z.string().datetime(),
+        }))
+            .output(frameSchema),
+        setLayout: oc
+            .route({
+            method: "PUT",
+            path: "/projects/{project}/frames/{frame}/layout",
+        })
+            .input(frameInputSchema.extend(projectFrameLayoutSchema.shape))
+            .output(frameSchema),
         delete: oc
             .route({ method: "DELETE", path: "/projects/{project}/frames/{frame}" })
             .input(frameInputSchema)
@@ -68,6 +87,13 @@ export const contract = {
         })
             .input(frameInputSchema)
             .output(screenshotSchema),
+        prepareExport: oc
+            .route({
+            method: "POST",
+            path: "/projects/{project}/frames/{frame}/exports",
+        })
+            .input(frameInputSchema)
+            .output(frameExportSchema),
     },
     filesystem: {
         list: oc

package/dist/v1/schemas.d.ts

@@ -16,6 +16,19 @@ export declare const projectDerivationStatusSchema: z.ZodEnum<{
 export declare const frameNameSchema: z.ZodString;
 export declare const frameSizeSchema: z.ZodNumber;
 export declare const framePositionSchema: z.ZodNumber;
+export declare const cameraPoseSchema: z.ZodObject<{
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strict>;
+    quaternion: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+        w: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
 export declare const httpUrlSchema: z.ZodString;
 export declare const imageUrlSchema: z.ZodString;
 /** An absolute path in the hosted project filesystem. */
@@ -63,6 +76,20 @@ export declare const gltsFrameSchema: z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     type: z.ZodLiteral<"glts">;
+    camera: z.ZodOptional<z.ZodObject<{
+        position: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            z: z.ZodNumber;
+        }, z.core.$strict>;
+        quaternion: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            z: z.ZodNumber;
+            w: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    contentRevision: z.ZodNumber;
 }, z.core.$strip>;
 export declare const imageGenerationOperationSchema: z.ZodEnum<{
     generate: "generate";
@@ -190,6 +217,20 @@ export declare const frameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     type: z.ZodLiteral<"glts">;
+    camera: z.ZodOptional<z.ZodObject<{
+        position: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            z: z.ZodNumber;
+        }, z.core.$strict>;
+        quaternion: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            z: z.ZodNumber;
+            w: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    contentRevision: z.ZodNumber;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
     projectId: z.ZodString;
@@ -352,10 +393,101 @@ export declare const screenshotSchema: z.ZodObject<{
     height: z.ZodNumber;
     mediaType: z.ZodLiteral<"image/png">;
 }, z.core.$strip>;
+export declare const gltsFrameExportSchema: z.ZodObject<{
+    frameId: z.ZodString;
+    frameName: z.ZodString;
+    projectId: z.ZodString;
+    type: z.ZodLiteral<"glts">;
+    runtime: z.ZodObject<{
+        gltf: z.ZodObject<{
+            filename: z.ZodString;
+        }, z.core.$strip>;
+        stl: z.ZodObject<{
+            filename: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    sourceArchive: z.ZodNullable<z.ZodObject<{
+        filename: z.ZodString;
+        url: z.ZodString;
+        mediaType: z.ZodLiteral<"application/zip">;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+export declare const imageFrameExportSchema: z.ZodObject<{
+    frameId: z.ZodString;
+    frameName: z.ZodString;
+    projectId: z.ZodString;
+    type: z.ZodLiteral<"image">;
+    download: z.ZodObject<{
+        filename: z.ZodString;
+        url: z.ZodString;
+        mediaType: z.ZodEnum<{
+            "image/png": "image/png";
+            "image/jpeg": "image/jpeg";
+            "image/webp": "image/webp";
+        }>;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+export declare const marketFrameExportSchema: z.ZodObject<{
+    frameId: z.ZodString;
+    frameName: z.ZodString;
+    projectId: z.ZodString;
+    type: z.ZodLiteral<"market">;
+    asset: z.ZodString;
+    download: z.ZodObject<{
+        filename: z.ZodString;
+        url: z.ZodString;
+        mediaType: z.ZodLiteral<"application/zip">;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+export declare const frameExportSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    frameId: z.ZodString;
+    frameName: z.ZodString;
+    projectId: z.ZodString;
+    type: z.ZodLiteral<"glts">;
+    runtime: z.ZodObject<{
+        gltf: z.ZodObject<{
+            filename: z.ZodString;
+        }, z.core.$strip>;
+        stl: z.ZodObject<{
+            filename: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    sourceArchive: z.ZodNullable<z.ZodObject<{
+        filename: z.ZodString;
+        url: z.ZodString;
+        mediaType: z.ZodLiteral<"application/zip">;
+    }, z.core.$strict>>;
+}, z.core.$strip>, z.ZodObject<{
+    frameId: z.ZodString;
+    frameName: z.ZodString;
+    projectId: z.ZodString;
+    type: z.ZodLiteral<"image">;
+    download: z.ZodObject<{
+        filename: z.ZodString;
+        url: z.ZodString;
+        mediaType: z.ZodEnum<{
+            "image/png": "image/png";
+            "image/jpeg": "image/jpeg";
+            "image/webp": "image/webp";
+        }>;
+    }, z.core.$strict>;
+}, z.core.$strip>, z.ZodObject<{
+    frameId: z.ZodString;
+    frameName: z.ZodString;
+    projectId: z.ZodString;
+    type: z.ZodLiteral<"market">;
+    asset: z.ZodString;
+    download: z.ZodObject<{
+        filename: z.ZodString;
+        url: z.ZodString;
+        mediaType: z.ZodLiteral<"application/zip">;
+    }, z.core.$strict>;
+}, z.core.$strip>], "type">;
 export type User = z.infer<typeof userSchema>;
 export type Project = z.infer<typeof projectSchema>;
 export type CreateProjectFromBrief = z.infer<typeof createProjectFromBriefSchema>;
 export type ProjectDerivationStatus = z.infer<typeof projectDerivationStatusSchema>;
+export type CameraPose = z.infer<typeof cameraPoseSchema>;
 export type GltsFrame = z.infer<typeof gltsFrameSchema>;
 export type ImageFrame = z.infer<typeof imageFrameSchema>;
 export type ImageGenerationOperation = z.infer<typeof imageGenerationOperationSchema>;
@@ -374,3 +506,7 @@ export type BinaryFile = z.infer<typeof binaryFileSchema>;
 export type DesignFile = z.infer<typeof fileSchema>;
 export type FileMutation = z.infer<typeof fileMutationSchema>;
 export type Screenshot = z.infer<typeof screenshotSchema>;
+export type GltsFrameExport = z.infer<typeof gltsFrameExportSchema>;
+export type ImageFrameExport = z.infer<typeof imageFrameExportSchema>;
+export type MarketFrameExport = z.infer<typeof marketFrameExportSchema>;
+export type FrameExport = z.infer<typeof frameExportSchema>;

package/dist/v1/schemas.js

@@ -31,6 +31,28 @@ export const frameNameSchema = z
     .refine((name) => !name.includes("/"), "Frame names cannot contain /");
 export const frameSizeSchema = z.number().int().min(1).max(MAX_FRAME_DIMENSION);
 export const framePositionSchema = z.number().finite();
+const cameraPositionSchema = z
+    .object({
+    x: framePositionSchema,
+    y: framePositionSchema,
+    z: framePositionSchema,
+})
+    .strict();
+const cameraQuaternionSchema = z
+    .object({
+    x: framePositionSchema,
+    y: framePositionSchema,
+    z: framePositionSchema,
+    w: framePositionSchema,
+})
+    .strict()
+    .refine(isNormalizedQuaternion, "Camera quaternion must be normalized");
+export const cameraPoseSchema = z
+    .object({
+    position: cameraPositionSchema,
+    quaternion: cameraQuaternionSchema,
+})
+    .strict();
 export const httpUrlSchema = z
     .string()
     .url()
@@ -92,6 +114,8 @@ const frameBaseSchema = z.object({
 });
 export const gltsFrameSchema = frameBaseSchema.extend({
     type: z.literal("glts"),
+    camera: cameraPoseSchema.optional(),
+    contentRevision: z.number().int().nonnegative(),
 });
 export const imageGenerationOperationSchema = z.enum(["generate", "edit"]);
 export const imageGenerationResultSchema = z.enum(["new", "replace"]);
@@ -274,6 +298,56 @@ export const screenshotSchema = z.object({
     height: frameSizeSchema,
     mediaType: z.literal("image/png"),
 });
+const frameExportFilenameSchema = z.object({
+    filename: z
+        .string()
+        .regex(/^[a-z0-9][a-z0-9._-]{0,159}$/, "Export filenames must be safe ASCII"),
+});
+const frameDownloadSchema = z
+    .object({
+    url: httpUrlSchema,
+    mediaType: z.string().min(1),
+    ...frameExportFilenameSchema.shape,
+})
+    .strict();
+const marketDownloadSchema = frameDownloadSchema.extend({
+    url: z
+        .string()
+        .url()
+        .refine(isCredentialFreeHttpsUrl, "Market downloads must use credential-free HTTPS"),
+    mediaType: z.literal("application/zip"),
+});
+const frameExportBaseSchema = z.object({
+    frameId: designIdSchema,
+    frameName: frameNameSchema,
+    projectId: designIdSchema,
+});
+export const gltsFrameExportSchema = frameExportBaseSchema.extend({
+    type: z.literal("glts"),
+    runtime: z.object({
+        gltf: frameExportFilenameSchema,
+        stl: frameExportFilenameSchema,
+    }),
+    sourceArchive: frameDownloadSchema
+        .extend({ mediaType: z.literal("application/zip") })
+        .nullable(),
+});
+export const imageFrameExportSchema = frameExportBaseSchema.extend({
+    type: z.literal("image"),
+    download: frameDownloadSchema.extend({
+        mediaType: z.enum(["image/png", "image/jpeg", "image/webp"]),
+    }),
+});
+export const marketFrameExportSchema = frameExportBaseSchema.extend({
+    type: z.literal("market"),
+    asset: marketAssetSchema,
+    download: marketDownloadSchema,
+});
+export const frameExportSchema = z.discriminatedUnion("type", [
+    gltsFrameExportSchema,
+    imageFrameExportSchema,
+    marketFrameExportSchema,
+]);
 function isProjectPath(path) {
     if (!path.startsWith("/") || path === "/" || path.endsWith("/"))
         return false;
@@ -297,3 +371,16 @@ function isHttpUrl(value) {
     const protocol = new URL(value).protocol;
     return protocol === "http:" || protocol === "https:";
 }
+function isCredentialFreeHttpsUrl(value) {
+    if (!URL.canParse(value))
+        return false;
+    const url = new URL(value);
+    return url.protocol === "https:" && !url.username && !url.password;
+}
+function isNormalizedQuaternion(value) {
+    const squaredLength = value.x * value.x +
+        value.y * value.y +
+        value.z * value.z +
+        value.w * value.w;
+    return Math.abs(squaredLength - 1) <= 1e-6;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawcall/design",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Typed API and remote CLI for Drawcall Design",
   "repository": {
     "type": "git",