@party-stack/ontology 0.7.0 → 0.9.0

package/lib/live/LiveOntology.test.js

@@ -1,7 +1,7 @@
 import { MemoryBlobBytesStore, SingleProcessCoordination } from "@party-stack/runtime";
 import { describe, expect, it, vi } from "vitest";
 import { o } from "../ir/index.js";
-import { createLiveOntology } from "./LiveOntology.js";
+import { createLiveOntology, waitForLiveOntologyReady } from "./LiveOntology.js";
 const ir = {
     types: [],
     objectTypes: [],
@@ -151,5 +151,127 @@ describe("createLiveOntology", () => {
         await ontology.cleanup();
         await coordination.close();
     });
+    it("exposes ready and settles immediate cleanup without unhandled rejections", async () => {
+        const unhandled = [];
+        const onUnhandled = (reason) => {
+            unhandled.push(reason);
+        };
+        process.on("unhandledRejection", onUnhandled);
+        const coordination = new SingleProcessCoordination({
+            scope: "lifecycle-cleanup",
+        });
+        const backendAdapter = {
+            name: "test",
+            getCollectionOptions: () => ({
+                syncMode: "on-demand",
+                sync: {
+                    sync: ({ markReady }) => {
+                        markReady();
+                        return {};
+                    },
+                },
+            }),
+            applyAction: () => Promise.resolve(),
+            runQueryFunction: () => Promise.resolve(undefined),
+        };
+        try {
+            const ontology = await createLiveOntology({
+                id: "lifecycle-cleanup",
+                ir: {
+                    ...ir,
+                    objectTypes: [
+                        {
+                            name: "Note",
+                            displayName: "Note",
+                            pluralDisplayName: "Notes",
+                            primaryKey: "id",
+                            properties: [
+                                {
+                                    name: "id",
+                                    displayName: "ID",
+                                    type: o.string({}),
+                                },
+                            ],
+                        },
+                    ],
+                    queryFunctionTypes: [],
+                },
+                backend: () => backendAdapter,
+                runtime: () => ({
+                    owner: "user",
+                    namespace: "lifecycle-cleanup",
+                    blobBytes: new MemoryBlobBytesStore(),
+                    coordination,
+                }),
+            });
+            const ready = ontology.ready;
+            await expect(Promise.all([ready, ontology.cleanup()])).resolves.toBeDefined();
+            await expect(ontology.cleanup()).resolves.toBeUndefined();
+            expect(unhandled).toEqual([]);
+        }
+        finally {
+            process.off("unhandledRejection", onUnhandled);
+            await coordination.close();
+        }
+    });
+    it("waits for on-demand collections via waitForLiveOntologyReady", async () => {
+        let syncStarted = false;
+        const coordination = new SingleProcessCoordination({
+            scope: "wait-ready",
+        });
+        const backendAdapter = {
+            name: "test",
+            getCollectionOptions: () => ({
+                syncMode: "on-demand",
+                sync: {
+                    sync: ({ markReady }) => {
+                        syncStarted = true;
+                        // Defer ready so waitForCollectionReady must start sync first.
+                        queueMicrotask(() => markReady());
+                        return {
+                            loadSubset: () => true,
+                        };
+                    },
+                },
+            }),
+            applyAction: () => Promise.resolve(),
+            runQueryFunction: () => Promise.resolve(undefined),
+        };
+        const ontology = await createLiveOntology({
+            id: "wait-ready",
+            ir: {
+                ...ir,
+                objectTypes: [
+                    {
+                        name: "Note",
+                        displayName: "Note",
+                        pluralDisplayName: "Notes",
+                        primaryKey: "id",
+                        properties: [
+                            {
+                                name: "id",
+                                displayName: "ID",
+                                type: o.string({}),
+                            },
+                        ],
+                    },
+                ],
+                queryFunctionTypes: [],
+            },
+            backend: () => backendAdapter,
+            runtime: () => ({
+                owner: "user",
+                namespace: "wait-ready",
+                blobBytes: new MemoryBlobBytesStore(),
+                coordination,
+            }),
+        });
+        expect(ontology.objects.Note.status).toBe("idle");
+        await expect(waitForLiveOntologyReady(ontology)).resolves.toBeUndefined();
+        expect(syncStarted).toBe(true);
+        expect(ontology.objects.Note.status).toBe("ready");
+        await ontology.cleanup();
+        await coordination.close();
+    });
 });
 //# sourceMappingURL=LiveOntology.test.js.map

package/lib/live/LiveOntology.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"LiveOntology.test.js","sourceRoot":"","sources":["../../src/live/LiveOntology.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"LiveOntology.test.js","sourceRoot":"","sources":["../../src/live/LiveOntology.test.ts"],"names":[],"mappings":"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"}

package/lib/live/OntologyBackendAdapter.d.ts

@@ -1,5 +1,6 @@
 import * as v from "../utils/values.js";
 import type { AttachmentTypeDef, OntologyIR } from "../ir/index.js";
+import type { PartialAttachmentMetadata } from "./attachments/types.js";
 import type { Collection, CollectionConfig } from "@tanstack/db";
 export type OntologyCollectionOptions = Omit<CollectionConfig<Record<string, unknown>, string | number>, "getKey">;
 export interface OntologyAttachmentUpload {
@@ -13,6 +14,29 @@ export interface OntologyAttachmentIdMapping {
 }
 export interface OntologyApplyActionResult {
     attachmentIdMappings?: OntologyAttachmentIdMapping[];
+    /**
+     * Object types that may have changed as a result of the action.
+     * When omitted, clients may fall back to refreshing all known object types.
+     */
+    invalidatedObjectTypes?: string[];
+}
+export interface OntologyActionRefreshResult {
+    status: "ok" | "error" | "aborted";
+    objectType: string;
+    error?: {
+        name: string;
+        message: string;
+    };
+}
+export interface OntologyActionRefreshDiagnostics {
+    /**
+     * Best-effort cache refresh after a confirmed write.
+     * Never rejects; failures are reported in the resolved results.
+     */
+    completed: Promise<OntologyActionRefreshResult[]>;
+}
+export interface OntologyApplyActionClientResult extends OntologyApplyActionResult {
+    refresh?: OntologyActionRefreshDiagnostics;
 }
 export interface ApplyActionLiveOpts {
     objects: Record<string, Collection<Record<string, unknown>>>;
@@ -35,11 +59,7 @@ export interface OntologyAttachmentsAdapter {
         target?: AttachmentTypeDef;
     }) => Promise<v.attachment | void>;
     getAttachmentContent: (attachment: v.attachment) => Promise<Blob>;
-    getAttachmentMetadata: (attachment: v.attachment) => Promise<v.attachment & {
-        size: number;
-        type: string;
-        name?: string;
-    }>;
+    getAttachmentMetadata?: (attachment: v.attachment, selection: readonly (keyof PartialAttachmentMetadata)[]) => Promise<PartialAttachmentMetadata>;
 }
 export interface OntologyBackendAdapter {
     name: string;

package/lib/live/OntologyBackendAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OntologyBackendAdapter.d.ts","sourceRoot":"","sources":["../../src/live/OntologyBackendAdapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"OntologyBackendAdapter.d.ts","sourceRoot":"","sources":["../../src/live/OntologyBackendAdapter.ts"],"names":[],"mappings":"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"}

package/lib/live/attachments/attachmentMetadata.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=attachmentMetadata.test.d.ts.map

package/lib/live/attachments/attachmentMetadata.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentMetadata.test.d.ts","sourceRoot":"","sources":["../../../src/live/attachments/attachmentMetadata.test.ts"],"names":[],"mappings":""}

package/lib/live/attachments/attachmentMetadata.test.js

@@ -0,0 +1,73 @@
+import { describe, expect, expectTypeOf, it, vi } from "vitest";
+import { createLiveOntologyAttachments } from "./createLiveOntologyAttachments.js";
+describe("attachment metadata", () => {
+    it("only exposes dimensions for image selections", () => {
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+    });
+    it("infers created attachment types from targets", () => {
+        const attachments = undefined;
+        const check = async () => {
+            const image = await attachments.create(new Blob(), {
+                target: {
+                    kind: "objectProperty",
+                    objectType: "Document",
+                    property: "image",
+                },
+            });
+            expectTypeOf(image.attachment).toEqualTypeOf();
+            const images = await attachments.create(new Blob(), {
+                target: {
+                    kind: "objectProperty",
+                    objectType: "Document",
+                    property: "images",
+                },
+            });
+            expectTypeOf(images.attachment).toEqualTypeOf();
+            const parameter = await attachments.create(new Blob(), {
+                target: {
+                    kind: "actionParameter",
+                    actionType: "upload",
+                    parameter: "image",
+                },
+            });
+            expectTypeOf(parameter.attachment).toEqualTypeOf();
+            const targetless = await attachments.create(new Blob());
+            expectTypeOf(targetless.attachment).toEqualTypeOf();
+        };
+        expectTypeOf(check).toBeFunction();
+    });
+    it("delegates missing selected fields to the blob manager", async () => {
+        const metadata = vi.fn(() => Promise.resolve({
+            id: "image-1",
+            size: 10,
+            dimensions: { width: 800, height: 600 },
+        }));
+        const attachments = createLiveOntologyAttachments({
+            ir: {
+                types: [],
+                objectTypes: [],
+                linkTypes: [],
+                actionTypes: [],
+                queryFunctionTypes: [],
+            },
+            attachmentsAdapter: {},
+            blobManager: { metadata },
+        });
+        const attachment = {
+            id: "image-1",
+            type: "image/png",
+        };
+        await expect(attachments.metadata(attachment, {
+            select: ["type", "dimensions"],
+        })).resolves.toMatchObject({
+            type: "image/png",
+            dimensions: { width: 800, height: 600 },
+        });
+        expect(metadata).toHaveBeenCalledWith("image-1", {
+            meta: { attachment },
+            select: ["type", "dimensions"],
+        });
+    });
+});
+//# sourceMappingURL=attachmentMetadata.test.js.map

package/lib/live/attachments/attachmentMetadata.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentMetadata.test.js","sourceRoot":"","sources":["../../../src/live/attachments/attachmentMetadata.test.ts"],"names":[],"mappings":"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"}

package/lib/live/attachments/createLiveOntologyAttachments.d.ts

@@ -1,5 +1,6 @@
 import type { BlobManager } from "@party-stack/blobs";
 import * as v from "../../utils/values.js";
+import type { AttachmentMetadata, AttachmentMetadataSelection } from "./types.js";
 import type { OntologyIR } from "../../ir/index.js";
 import type { OntologyAttachmentCreateTarget } from "../../utils/targets.js";
 import type { OntologyAttachmentsAdapter } from "../OntologyBackendAdapter.js";
@@ -11,8 +12,26 @@ interface LiveOntologyAttachmentCreateOptions {
     target?: OntologyAttachmentCreateTarget;
     eager?: boolean;
 }
-type LiveOntologyAttachmentCreateResult<Options extends LiveOntologyAttachmentCreateOptions | undefined> = {
-    attachment: v.attachment;
+interface AttachmentOntologyDefinition {
+    objectTypes: Record<string, Record<string, unknown>>;
+    actionTypes: Record<string, {
+        parameters: Record<string, unknown>;
+    }>;
+}
+type ExtractAttachment<Value> = Value extends v.attachment<infer Type> ? v.attachment<Type> : NonNullable<Value> extends ReadonlyArray<infer Element> ? ExtractAttachment<Element> : never;
+type AttachmentAtTarget<Ontology extends AttachmentOntologyDefinition, Target> = string extends keyof Ontology["objectTypes"] ? v.attachment : Target extends {
+    kind: "objectProperty";
+    objectType: infer ObjectType;
+    property: infer Property;
+} ? ObjectType extends keyof Ontology["objectTypes"] ? Property extends keyof Ontology["objectTypes"][ObjectType] ? ExtractAttachment<Ontology["objectTypes"][ObjectType][Property]> : never : never : Target extends {
+    kind: "actionParameter";
+    actionType: infer ActionType;
+    parameter: infer Parameter;
+} ? ActionType extends keyof Ontology["actionTypes"] ? Parameter extends keyof Ontology["actionTypes"][ActionType]["parameters"] ? ExtractAttachment<Ontology["actionTypes"][ActionType]["parameters"][Parameter]> : never : never : v.attachment;
+type LiveOntologyAttachmentCreateResult<Ontology extends AttachmentOntologyDefinition, Options extends LiveOntologyAttachmentCreateOptions | undefined> = {
+    attachment: Options extends {
+        target: infer Target;
+    } ? AttachmentAtTarget<Ontology, Target> : v.attachment;
 } & (Options extends {
     eager: true;
 } ? {
@@ -20,19 +39,20 @@ type LiveOntologyAttachmentCreateResult<Options extends LiveOntologyAttachmentCr
 } : {
     isMaterialized?: never;
 });
-export interface LiveOntologyAttachments {
-    create: <Options extends LiveOntologyAttachmentCreateOptions | undefined = undefined>(blob: Blob | File, opts?: Options) => Promise<LiveOntologyAttachmentCreateResult<Options>>;
-    metadata: (attachment: v.attachment) => Promise<v.attachment & {
-        size: number;
-        type: string;
-        name?: string;
-    }>;
+export interface LiveOntologyAttachments<Ontology extends AttachmentOntologyDefinition = AttachmentOntologyDefinition> {
+    create: <const Options extends LiveOntologyAttachmentCreateOptions | undefined = undefined>(blob: Blob | File, opts?: Options) => Promise<LiveOntologyAttachmentCreateResult<Ontology, Options>>;
+    metadata: {
+        <Type extends string>(attachment: v.attachment<Type>): Promise<AttachmentMetadata<Type>>;
+        <Type extends string, const Selection extends AttachmentMetadataSelection<Type>>(attachment: v.attachment<Type>, options: {
+            select: Selection;
+        }): Promise<AttachmentMetadata<Type, Selection[number]>>;
+    };
     blob: (attachment: v.attachment) => Promise<Blob>;
 }
-export declare function createLiveOntologyAttachments(opts: {
+export declare function createLiveOntologyAttachments<Ontology extends AttachmentOntologyDefinition = AttachmentOntologyDefinition>(opts: {
     ir: OntologyIR;
     attachmentsAdapter: OntologyAttachmentsAdapter;
     blobManager: BlobManager;
-}): LiveOntologyAttachments;
+}): LiveOntologyAttachments<Ontology>;
 export {};
 //# sourceMappingURL=createLiveOntologyAttachments.d.ts.map

package/lib/live/attachments/createLiveOntologyAttachments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createLiveOntologyAttachments.d.ts","sourceRoot":"","sources":["../../../src/live/attachments/createLiveOntologyAttachments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,CAAC,MAAM,uBAAuB,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE/E,MAAM,WAAW,mCAAmC;IAChD,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,UAAU,mCAAmC;IACzC,MAAM,CAAC,EAAE,8BAA8B,CAAC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,KAAK,kCAAkC,CAAC,OAAO,SAAS,mCAAmC,GAAG,SAAS,IAAI;IACvG,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC;CAC5B,GAAG,CAAC,OAAO,SAAS;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,cAAc,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAAG;IAAE,cAAc,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAExG,MAAM,WAAW,uBAAuB;IACpC,MAAM,EAAE,CAAC,OAAO,SAAS,mCAAmC,GAAG,SAAS,GAAG,SAAS,EAChF,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,IAAI,CAAC,EAAE,OAAO,KACb,OAAO,CAAC,kCAAkC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,QAAQ,EAAE,CACN,UAAU,EAAE,CAAC,CAAC,UAAU,KACvB,OAAO,CAAC,CAAC,CAAC,UAAU,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAChD,EAAE,EAAE,UAAU,CAAC;IACf,kBAAkB,EAAE,0BAA0B,CAAC;IAC/C,WAAW,EAAE,WAAW,CAAC;CAC5B,GAAG,uBAAuB,CAmE1B"}
+{"version":3,"file":"createLiveOntologyAttachments.d.ts","sourceRoot":"","sources":["../../../src/live/attachments/createLiveOntologyAttachments.ts"],"names":[],"mappings":"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"}

package/lib/live/attachments/createLiveOntologyAttachments.js

@@ -1,5 +1,9 @@
 import { invariant } from "@bobbyfidz/panic";
+import { ImageMediaTypeOptions } from "../../ir/generated/constants.js";
 import { getTargetValueType } from "../../utils/types.js";
+function satisfiesRange(value, range) {
+    return (range.min === undefined || value >= range.min) && (range.max === undefined || value <= range.max);
+}
 export function createLiveOntologyAttachments(opts) {
     const { attachmentsAdapter, blobManager } = opts;
     const create = async (blob, createOpts) => {
@@ -8,17 +12,24 @@ export function createLiveOntologyAttachments(opts) {
             ? getTargetValueType(opts.ir, normalizedOpts.target)
             : undefined;
         invariant(targetType === undefined || targetType.kind === "attachment", "Target is not an attachment.");
+        const constraint = targetType?.kind === "attachment" ? targetType.value.constraint : undefined;
+        invariant(!constraint?.size || satisfiesRange(blob.size, constraint.size), `Attachment size ${blob.size} is outside the allowed range.`);
+        const content = constraint?.content;
+        if (content?.kind === "image") {
+            invariant(content.value.mediaTypes
+                ? content.value.mediaTypes.some((mediaType) => mediaType === blob.type)
+                : ImageMediaTypeOptions.some((option) => option.value === blob.type), `Attachment media type "${blob.type || "(empty)"}" is not allowed by the target.`);
+            // TODO: Validate image dimensions once runtimes expose a portable media-inspection capability.
+        }
         const id = targetType?.kind === "attachment" && attachmentsAdapter.generateAttachmentId
             ? await attachmentsAdapter.generateAttachmentId(blob, {
                 target: targetType.value,
             })
             : crypto.randomUUID();
-        const ref = await blobManager.stage(id, blob);
+        await blobManager.stage(id, blob);
         const attachment = {
-            id: ref.id,
-            size: ref.size,
-            type: ref.type,
-            name: ref.name,
+            id,
+            type: blob.type,
         };
         const materializeAttachment = attachmentsAdapter.materializeAttachment;
         const materializeOptions = {
@@ -28,12 +39,12 @@ export function createLiveOntologyAttachments(opts) {
             (attachmentsAdapter.canMaterializeAttachment?.(attachment, materializeOptions) ?? true);
         if (normalizedOpts.eager && canMaterialize) {
             const promise = blobManager
-                .read(ref.id)
+                .read(id)
                 .then((storedBlob) => materializeAttachment(attachment, storedBlob, materializeOptions))
                 .then(async (materialized) => {
                 if (materialized) {
-                    if (materialized.id !== ref.id) {
-                        await blobManager.bindRemoteId(ref.id, materialized.id);
+                    if (materialized.id !== id) {
+                        await blobManager.bindRemoteId(id, materialized.id);
                     }
                     Object.assign(attachment, materialized);
                 }
@@ -44,16 +55,33 @@ export function createLiveOntologyAttachments(opts) {
                 isMaterialized: promise,
             };
         }
-        return { attachment };
+        return {
+            attachment,
+        };
     };
+    const blob = (attachment) => blobManager.read(attachment.id, {
+        meta: { attachment },
+    });
+    async function metadata(attachment, options) {
+        const selection = options?.select ?? ["size", "type", "name"];
+        const resolved = await blobManager.metadata(attachment.id, {
+            meta: { attachment },
+            select: selection,
+        });
+        if (selection.includes("dimensions") && resolved.dimensions === null) {
+            throw new Error(`Dimensions are unavailable for attachment "${attachment.id}".`);
+        }
+        const { name, ...metadata } = resolved;
+        return {
+            ...attachment,
+            ...metadata,
+            ...(typeof name === "string" ? { name } : {}),
+        };
+    }
     return {
         create,
-        metadata: (attachment) => blobManager.metadata(attachment.id, {
-            meta: { source: attachment.source },
-        }),
-        blob: (attachment) => blobManager.read(attachment.id, {
-            meta: { source: attachment.source },
-        }),
+        metadata,
+        blob,
     };
 }
 //# sourceMappingURL=createLiveOntologyAttachments.js.map

package/lib/live/attachments/createLiveOntologyAttachments.js.map

@@ -1 +1 @@
-{"version":3,"file":"createLiveOntologyAttachments.js","sourceRoot":"","sources":["../../../src/live/attachments/createLiveOntologyAttachments.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"createLiveOntologyAttachments.js","sourceRoot":"","sources":["../../../src/live/attachments/createLiveOntologyAttachments.ts"],"names":[],"mappings":"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"}

package/lib/live/attachments/createLiveOntologyAttachments.test.js

@@ -1,7 +1,8 @@
 import { MemoryBlobBytesStore, SingleProcessCoordination } from "@party-stack/runtime";
-import { describe, expect, it } from "vitest";
+import { describe, expect, it, vi } from "vitest";
 import { o } from "../../ir/index.js";
 import { createLiveOntology } from "../LiveOntology.js";
+import { createLiveOntologyAttachments } from "./createLiveOntologyAttachments.js";
 const ir = {
     types: [],
     objectTypes: [
@@ -38,6 +39,104 @@ const actionIr = {
     ],
 };
 describe("createLiveOntologyAttachments", () => {
+    it("rejects blobs outside a target's allowed media types", async () => {
+        const constrainedIr = {
+            ...ir,
+            objectTypes: [
+                {
+                    ...ir.objectTypes[0],
+                    properties: [
+                        ir.objectTypes[0].properties[0],
+                        {
+                            name: "file",
+                            displayName: "File",
+                            type: o.attachment({
+                                constraint: {
+                                    content: o.AttachmentContentConstraint.image({
+                                        mediaTypes: ["image/png", "image/jpeg"],
+                                    }),
+                                },
+                            }),
+                        },
+                    ],
+                },
+            ],
+        };
+        const stage = vi.fn();
+        const attachments = createLiveOntologyAttachments({
+            ir: constrainedIr,
+            attachmentsAdapter: {},
+            blobManager: { stage },
+        });
+        await expect(attachments.create(new Blob(["pdf"], { type: "application/pdf" }), {
+            target: {
+                kind: "objectProperty",
+                objectType: "Document",
+                property: "file",
+            },
+        })).rejects.toThrow('Attachment media type "application/pdf" is not allowed by the target.');
+        expect(stage).not.toHaveBeenCalled();
+    });
+    it("enforces cheap attachment constraints before staging", async () => {
+        const constrainedIr = {
+            ...ir,
+            objectTypes: [
+                {
+                    ...ir.objectTypes[0],
+                    properties: [
+                        ir.objectTypes[0].properties[0],
+                        {
+                            name: "file",
+                            displayName: "File",
+                            type: o.attachment({
+                                constraint: {
+                                    size: { max: 10 },
+                                    content: o.AttachmentContentConstraint.image({
+                                        dimensions: {
+                                            width: { max: 100 },
+                                        },
+                                    }),
+                                },
+                            }),
+                        },
+                    ],
+                },
+            ],
+        };
+        const stage = vi.fn(() => Promise.resolve());
+        const attachments = createLiveOntologyAttachments({
+            ir: constrainedIr,
+            attachmentsAdapter: {
+                generateAttachmentId: () => "image-1",
+                getAttachmentContent: () => Promise.reject(new Error("unexpected content read")),
+            },
+            blobManager: { stage },
+        });
+        await expect(attachments.create(new Blob(["gif"], { type: "image/gif" }), {
+            target: {
+                kind: "objectProperty",
+                objectType: "Document",
+                property: "file",
+            },
+        })).rejects.toThrow('Attachment media type "image/gif" is not allowed by the target.');
+        await expect(attachments.create(new Blob(["12345678901"], { type: "image/png" }), {
+            target: {
+                kind: "objectProperty",
+                objectType: "Document",
+                property: "file",
+            },
+        })).rejects.toThrow("Attachment size 11 is outside the allowed range.");
+        await expect(attachments.create(new Blob(["image"], { type: "image/png" }), {
+            target: {
+                kind: "objectProperty",
+                objectType: "Document",
+                property: "file",
+            },
+        })).resolves.toMatchObject({
+            attachment: { id: "image-1" },
+        });
+        expect(stage).toHaveBeenCalledOnce();
+    });
     it("starts eager materialization in the background when the adapter supports it", async () => {
         const runtime = {
             owner: "test-user",