@happyvertical/smrt-images 0.51.39 → 0.52.0

package/dist/index.js

@@ -7,7 +7,7 @@ import { join } from "node:path";
 import { Asset, persistMediaBundleInspection as persistImageMediaBundleInspection } from "@happyvertical/smrt-assets";
 import { TenantIsolationError, TenantScoped, getCurrentTenant, isSuperAdminBypass } from "@happyvertical/smrt-tenancy";
 //#region src/__smrt-register__.ts
-ObjectRegistry.registerPackageManifest(JSON.parse("{\"version\":\"1.0.0\",\"timestamp\":0,\"packageName\":\"@happyvertical/smrt-images\",\"packageVersion\":\"0.51.39\",\"objects\":{\"@happyvertical/smrt-images:Image\":{\"name\":\"image\",\"className\":\"Image\",\"qualifiedName\":\"@happyvertical/smrt-images:Image\",\"collection\":\"assets\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/images/src/image.ts\",\"packageName\":\"@happyvertical/smrt-images\",\"fields\":{\"created_at\":{\"type\":\"datetime\",\"required\":false},\"updated_at\":{\"type\":\"datetime\",\"required\":false},\"tenantId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"generated\":true,\"source\":\"tenantScoped_decorator\",\"sqlType\":\"UUID\",\"__tenancy\":{\"isTenantIdField\":true,\"mode\":\"optional\",\"field\":\"tenantId\",\"autoFilter\":true,\"autoPopulate\":true,\"allowSuperAdminBypass\":false}}},\"name\":{\"type\":\"text\",\"required\":false},\"sourceUri\":{\"type\":\"text\",\"required\":false},\"mimeType\":{\"type\":\"text\",\"required\":false},\"description\":{\"type\":\"text\",\"required\":false},\"metadata\":{\"type\":\"text\",\"required\":false},\"version\":{\"type\":\"integer\",\"required\":true,\"default\":1},\"primaryVersionId\":{\"type\":\"foreignKey\",\"required\":false,\"related\":\"Asset\"},\"typeSlug\":{\"type\":\"text\",\"required\":false},\"statusSlug\":{\"type\":\"text\",\"required\":false},\"ownerProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-profiles:Profile\"},\"sourceAssetId\":{\"type\":\"foreignKey\",\"required\":false,\"related\":\"Asset\"},\"folderId\":{\"type\":\"foreignKey\",\"required\":false,\"related\":\"Folder\"},\"sourceType\":{\"type\":\"text\",\"required\":false},\"externalId\":{\"type\":\"text\",\"required\":false},\"externalRefs\":{\"type\":\"text\",\"required\":false},\"createdAt\":{\"type\":\"text\",\"required\":false},\"updatedAt\":{\"type\":\"text\",\"required\":false},\"width\":{\"type\":\"integer\",\"required\":false,\"default\":0},\"height\":{\"type\":\"integer\",\"required\":false,\"default\":0},\"alt\":{\"type\":\"text\",\"required\":false,\"default\":\"\"}},\"methods\":{\"getMetadata\":{\"name\":\"getMetadata\",\"async\":false,\"parameters\":[],\"returnType\":\"Record<string, unknown>\",\"isStatic\":false,\"isPublic\":true},\"setMetadata\":{\"name\":\"setMetadata\",\"async\":false,\"parameters\":[{\"name\":\"metadata\",\"type\":\"Record<string, unknown>\",\"optional\":false}],\"returnType\":\"void\",\"isStatic\":false,\"isPublic\":true},\"mergeMetadata\":{\"name\":\"mergeMetadata\",\"async\":false,\"parameters\":[{\"name\":\"metadata\",\"type\":\"Record<string, unknown>\",\"optional\":false}],\"returnType\":\"void\",\"isStatic\":false,\"isPublic\":true},\"getExternalRefs\":{\"name\":\"getExternalRefs\",\"async\":false,\"parameters\":[],\"returnType\":\"Record<string, AssetExternalReference>\",\"isStatic\":false,\"isPublic\":true},\"getExternalRef\":{\"name\":\"getExternalRef\",\"async\":false,\"parameters\":[{\"name\":\"provider\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"AssetExternalReference | null\",\"isStatic\":false,\"isPublic\":true},\"setExternalRef\":{\"name\":\"setExternalRef\",\"async\":false,\"parameters\":[{\"name\":\"provider\",\"type\":\"string\",\"optional\":false},{\"name\":\"reference\",\"type\":\"any\",\"optional\":false,\"typeUnresolved\":true}],\"returnType\":\"void\",\"isStatic\":false,\"isPublic\":true},\"getTags\":{\"name\":\"getTags\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Tag[]>\",\"isStatic\":false,\"isPublic\":true},\"hasTag\":{\"name\":\"hasTag\",\"async\":true,\"parameters\":[{\"name\":\"tagSlug\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<boolean>\",\"isStatic\":false,\"isPublic\":true},\"getSource\":{\"name\":\"getSource\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Asset | null>\",\"isStatic\":false,\"isPublic\":true},\"getDerivatives\":{\"name\":\"getDerivatives\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Asset[]>\",\"isStatic\":false,\"isPublic\":true},\"getType\":{\"name\":\"getType\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<AssetType | null>\",\"isStatic\":false,\"isPublic\":true},\"getStatus\":{\"name\":\"getStatus\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<AssetStatus | null>\",\"isStatic\":false,\"isPublic\":true},\"getAssociations\":{\"name\":\"getAssociations\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<AssetAssociation[]>\",\"isStatic\":false,\"isPublic\":true},\"associateWith\":{\"name\":\"associateWith\",\"async\":true,\"parameters\":[{\"name\":\"metaType\",\"type\":\"string\",\"optional\":false},{\"name\":\"metaId\",\"type\":\"string\",\"optional\":false},{\"name\":\"role\",\"type\":\"any\",\"optional\":true,\"default\":\"default\"}],\"returnType\":\"Promise<AssetAssociation>\",\"isStatic\":false,\"isPublic\":true},\"getBySlug\":{\"name\":\"getBySlug\",\"async\":true,\"parameters\":[{\"name\":\"_slug\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<Asset | null>\",\"isStatic\":true,\"isPublic\":true},\"isValidImageFormat\":{\"name\":\"isValidImageFormat\",\"async\":false,\"parameters\":[],\"returnType\":\"boolean\",\"isStatic\":false,\"isPublic\":true},\"isHighResolution\":{\"name\":\"isHighResolution\",\"async\":false,\"parameters\":[],\"returnType\":\"boolean\",\"isStatic\":false,\"isPublic\":true},\"generateAltText\":{\"name\":\"generateAltText\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<string>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"api\":{\"include\":[\"list\",\"get\",\"create\",\"update\",\"delete\"]},\"mcp\":{\"include\":[\"list\",\"get\",\"create\",\"update\",\"generateAltText\"]},\"cli\":{\"skipApiCheck\":true},\"tenantScoped\":{\"mode\":\"optional\"},\"tableName\":\"assets\",\"tableStrategy\":\"sti\"},\"extends\":\"Asset\",\"exportName\":\"Image\",\"collectionExportName\":\"ImageCollection\",\"validationRules\":[{\"field\":\"version\",\"rule\":\"required\",\"fieldType\":\"integer\"}],\"schema\":{\"tableName\":\"assets\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"assets\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"_meta_type\\\" TEXT NOT NULL,\\n  \\\"_meta_data\\\" JSON,\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"name\\\" TEXT,\\n  \\\"source_uri\\\" TEXT,\\n  \\\"mime_type\\\" TEXT,\\n  \\\"description\\\" TEXT,\\n  \\\"metadata\\\" TEXT,\\n  \\\"version\\\" INTEGER DEFAULT 1,\\n  \\\"primary_version_id\\\" UUID,\\n  \\\"type_slug\\\" TEXT,\\n  \\\"status_slug\\\" TEXT,\\n  \\\"owner_profile_id\\\" UUID,\\n  \\\"source_asset_id\\\" UUID,\\n  \\\"folder_id\\\" UUID,\\n  \\\"source_type\\\" TEXT,\\n  \\\"external_id\\\" TEXT,\\n  \\\"external_refs\\\" TEXT,\\n  \\\"width\\\" INTEGER DEFAULT 0,\\n  \\\"height\\\" INTEGER DEFAULT 0,\\n  \\\"alt\\\" TEXT DEFAULT ''\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"_meta_type\":{\"type\":\"TEXT\",\"notNull\":true},\"_meta_data\":{\"type\":\"JSON\",\"notNull\":false},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false},\"name\":{\"type\":\"TEXT\",\"notNull\":false},\"source_uri\":{\"type\":\"TEXT\",\"notNull\":false},\"mime_type\":{\"type\":\"TEXT\",\"notNull\":false},\"description\":{\"type\":\"TEXT\",\"notNull\":false},\"metadata\":{\"type\":\"TEXT\",\"notNull\":false},\"version\":{\"type\":\"INTEGER\",\"notNull\":false,\"default\":1},\"primary_version_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"foreignKey\":{\"table\":\"assets\",\"column\":\"id\",\"onDelete\":\"NO ACTION\",\"onUpdate\":\"CASCADE\"}},\"type_slug\":{\"type\":\"TEXT\",\"notNull\":false},\"status_slug\":{\"type\":\"TEXT\",\"notNull\":false},\"owner_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false},\"source_asset_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"foreignKey\":{\"table\":\"assets\",\"column\":\"id\",\"onDelete\":\"NO ACTION\",\"onUpdate\":\"CASCADE\"}},\"folder_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false},\"source_type\":{\"type\":\"TEXT\",\"notNull\":false},\"external_id\":{\"type\":\"TEXT\",\"notNull\":false},\"external_refs\":{\"type\":\"TEXT\",\"notNull\":false},\"width\":{\"type\":\"INTEGER\",\"notNull\":false,\"default\":0},\"height\":{\"type\":\"INTEGER\",\"notNull\":false,\"default\":0},\"alt\":{\"type\":\"TEXT\",\"notNull\":false,\"default\":\"\"}},\"indexes\":[{\"name\":\"assets_slug_context_meta_type_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\",\"_meta_type\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"assets_meta_type_idx\",\"columns\":[\"_meta_type\"]},{\"name\":\"assets_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"assets_primary_version_id_idx\",\"columns\":[\"primary_version_id\"]},{\"name\":\"assets_owner_profile_id_idx\",\"columns\":[\"owner_profile_id\"]},{\"name\":\"assets_source_asset_id_idx\",\"columns\":[\"source_asset_id\"]},{\"name\":\"assets_folder_id_idx\",\"columns\":[\"folder_id\"]}],\"version\":\"dd79a8b6\"},\"importPath\":\"@happyvertical/smrt-images\"},\"@happyvertical/smrt-images:ImageCollection\":{\"name\":\"imagecollection\",\"className\":\"ImageCollection\",\"qualifiedName\":\"@happyvertical/smrt-images:ImageCollection\",\"collection\":\"assets\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/images/src/images.ts\",\"packageName\":\"@happyvertical/smrt-images\",\"fields\":{},\"methods\":{\"findByTenant\":{\"name\":\"findByTenant\",\"async\":true,\"parameters\":[{\"name\":\"tenantId\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"findGlobal\":{\"name\":\"findGlobal\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"findWithGlobals\":{\"name\":\"findWithGlobals\",\"async\":true,\"parameters\":[{\"name\":\"tenantId\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getByMinDimensions\":{\"name\":\"getByMinDimensions\",\"async\":true,\"parameters\":[{\"name\":\"minWidth\",\"type\":\"number\",\"optional\":false},{\"name\":\"minHeight\",\"type\":\"number\",\"optional\":false}],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getByMaxDimensions\":{\"name\":\"getByMaxDimensions\",\"async\":true,\"parameters\":[{\"name\":\"maxWidth\",\"type\":\"number\",\"optional\":false},{\"name\":\"maxHeight\",\"type\":\"number\",\"optional\":false}],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getLandscape\":{\"name\":\"getLandscape\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getPortrait\":{\"name\":\"getPortrait\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getSquare\":{\"name\":\"getSquare\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getMissingAltText\":{\"name\":\"getMissingAltText\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getHighResolution\":{\"name\":\"getHighResolution\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getByAspectRatio\":{\"name\":\"getByAspectRatio\",\"async\":true,\"parameters\":[{\"name\":\"minRatio\",\"type\":\"number\",\"optional\":false},{\"name\":\"maxRatio\",\"type\":\"number\",\"optional\":false}],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"assets\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"Image\",\"exportName\":\"ImageCollection\",\"collectionExportName\":\"ImageCollectionCollection\",\"schema\":{\"tableName\":\"assets\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"assets\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"_meta_type\\\" TEXT NOT NULL,\\n  \\\"_meta_data\\\" JSON,\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"name\\\" TEXT,\\n  \\\"source_uri\\\" TEXT,\\n  \\\"mime_type\\\" TEXT,\\n  \\\"description\\\" TEXT,\\n  \\\"metadata\\\" TEXT,\\n  \\\"version\\\" INTEGER DEFAULT 1,\\n  \\\"primary_version_id\\\" UUID,\\n  \\\"type_slug\\\" TEXT,\\n  \\\"status_slug\\\" TEXT,\\n  \\\"owner_profile_id\\\" UUID,\\n  \\\"source_asset_id\\\" UUID,\\n  \\\"folder_id\\\" UUID,\\n  \\\"source_type\\\" TEXT,\\n  \\\"external_id\\\" TEXT,\\n  \\\"external_refs\\\" TEXT,\\n  \\\"width\\\" INTEGER DEFAULT 0,\\n  \\\"height\\\" INTEGER DEFAULT 0,\\n  \\\"alt\\\" TEXT DEFAULT ''\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"_meta_type\":{\"type\":\"TEXT\",\"notNull\":true},\"_meta_data\":{\"type\":\"JSON\",\"notNull\":false},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false},\"name\":{\"type\":\"TEXT\",\"notNull\":false},\"source_uri\":{\"type\":\"TEXT\",\"notNull\":false},\"mime_type\":{\"type\":\"TEXT\",\"notNull\":false},\"description\":{\"type\":\"TEXT\",\"notNull\":false},\"metadata\":{\"type\":\"TEXT\",\"notNull\":false},\"version\":{\"type\":\"INTEGER\",\"notNull\":false,\"default\":1},\"primary_version_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"foreignKey\":{\"table\":\"assets\",\"column\":\"id\",\"onDelete\":\"NO ACTION\",\"onUpdate\":\"CASCADE\"}},\"type_slug\":{\"type\":\"TEXT\",\"notNull\":false},\"status_slug\":{\"type\":\"TEXT\",\"notNull\":false},\"owner_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false},\"source_asset_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"foreignKey\":{\"table\":\"assets\",\"column\":\"id\",\"onDelete\":\"NO ACTION\",\"onUpdate\":\"CASCADE\"}},\"folder_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false},\"source_type\":{\"type\":\"TEXT\",\"notNull\":false},\"external_id\":{\"type\":\"TEXT\",\"notNull\":false},\"external_refs\":{\"type\":\"TEXT\",\"notNull\":false},\"width\":{\"type\":\"INTEGER\",\"notNull\":false,\"default\":0},\"height\":{\"type\":\"INTEGER\",\"notNull\":false,\"default\":0},\"alt\":{\"type\":\"TEXT\",\"notNull\":false,\"default\":\"\"}},\"indexes\":[{\"name\":\"assets_slug_context_meta_type_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\",\"_meta_type\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"assets_meta_type_idx\",\"columns\":[\"_meta_type\"]},{\"name\":\"assets_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"assets_primary_version_id_idx\",\"columns\":[\"primary_version_id\"]},{\"name\":\"assets_owner_profile_id_idx\",\"columns\":[\"owner_profile_id\"]},{\"name\":\"assets_source_asset_id_idx\",\"columns\":[\"source_asset_id\"]},{\"name\":\"assets_folder_id_idx\",\"columns\":[\"folder_id\"]}],\"version\":\"dd79a8b6\"},\"importPath\":\"@happyvertical/smrt-images\"}},\"moduleType\":\"smrt\",\"smrtDependencies\":[\"@happyvertical/smrt-assets\",\"@happyvertical/smrt-core\",\"@happyvertical/smrt-prompts\",\"@happyvertical/smrt-tenancy\"]}"));
+ObjectRegistry.registerPackageManifest(JSON.parse("{\"version\":\"1.0.0\",\"timestamp\":0,\"packageName\":\"@happyvertical/smrt-images\",\"packageVersion\":\"0.52.0\",\"objects\":{\"@happyvertical/smrt-images:Image\":{\"name\":\"image\",\"className\":\"Image\",\"qualifiedName\":\"@happyvertical/smrt-images:Image\",\"collection\":\"assets\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/images/src/image.ts\",\"packageName\":\"@happyvertical/smrt-images\",\"fields\":{\"created_at\":{\"type\":\"datetime\",\"required\":false},\"updated_at\":{\"type\":\"datetime\",\"required\":false},\"tenantId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"generated\":true,\"source\":\"tenantScoped_decorator\",\"sqlType\":\"UUID\",\"__tenancy\":{\"isTenantIdField\":true,\"mode\":\"optional\",\"field\":\"tenantId\",\"autoFilter\":true,\"autoPopulate\":true,\"allowSuperAdminBypass\":false}}},\"name\":{\"type\":\"text\",\"required\":false},\"sourceUri\":{\"type\":\"text\",\"required\":false},\"mimeType\":{\"type\":\"text\",\"required\":false},\"description\":{\"type\":\"text\",\"required\":false},\"metadata\":{\"type\":\"text\",\"required\":false},\"version\":{\"type\":\"integer\",\"required\":true,\"default\":1},\"primaryVersionId\":{\"type\":\"foreignKey\",\"required\":false,\"related\":\"Asset\"},\"typeSlug\":{\"type\":\"text\",\"required\":false},\"statusSlug\":{\"type\":\"text\",\"required\":false},\"ownerProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-profiles:Profile\"},\"sourceAssetId\":{\"type\":\"foreignKey\",\"required\":false,\"related\":\"Asset\"},\"folderId\":{\"type\":\"foreignKey\",\"required\":false,\"related\":\"Folder\"},\"sourceType\":{\"type\":\"text\",\"required\":false},\"externalId\":{\"type\":\"text\",\"required\":false},\"externalRefs\":{\"type\":\"text\",\"required\":false},\"createdAt\":{\"type\":\"text\",\"required\":false},\"updatedAt\":{\"type\":\"text\",\"required\":false},\"width\":{\"type\":\"integer\",\"required\":false,\"default\":0},\"height\":{\"type\":\"integer\",\"required\":false,\"default\":0},\"alt\":{\"type\":\"text\",\"required\":false,\"default\":\"\"}},\"methods\":{\"getSlug\":{\"name\":\"getSlug\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<string | null | undefined>\",\"isStatic\":false,\"isPublic\":true},\"getMetadata\":{\"name\":\"getMetadata\",\"async\":false,\"parameters\":[],\"returnType\":\"Record<string, unknown>\",\"isStatic\":false,\"isPublic\":true},\"setMetadata\":{\"name\":\"setMetadata\",\"async\":false,\"parameters\":[{\"name\":\"metadata\",\"type\":\"Record<string, unknown>\",\"optional\":false}],\"returnType\":\"void\",\"isStatic\":false,\"isPublic\":true},\"mergeMetadata\":{\"name\":\"mergeMetadata\",\"async\":false,\"parameters\":[{\"name\":\"metadata\",\"type\":\"Record<string, unknown>\",\"optional\":false}],\"returnType\":\"void\",\"isStatic\":false,\"isPublic\":true},\"getExternalRefs\":{\"name\":\"getExternalRefs\",\"async\":false,\"parameters\":[],\"returnType\":\"Record<string, AssetExternalReference>\",\"isStatic\":false,\"isPublic\":true},\"getExternalRef\":{\"name\":\"getExternalRef\",\"async\":false,\"parameters\":[{\"name\":\"provider\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"AssetExternalReference | null\",\"isStatic\":false,\"isPublic\":true},\"setExternalRef\":{\"name\":\"setExternalRef\",\"async\":false,\"parameters\":[{\"name\":\"provider\",\"type\":\"string\",\"optional\":false},{\"name\":\"reference\",\"type\":\"any\",\"optional\":false,\"typeUnresolved\":true}],\"returnType\":\"void\",\"isStatic\":false,\"isPublic\":true},\"getTags\":{\"name\":\"getTags\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Tag[]>\",\"isStatic\":false,\"isPublic\":true},\"hasTag\":{\"name\":\"hasTag\",\"async\":true,\"parameters\":[{\"name\":\"tagSlug\",\"type\":\"string\",\"optional\":false},{\"name\":\"context\",\"type\":\"string\",\"optional\":true}],\"returnType\":\"Promise<boolean>\",\"isStatic\":false,\"isPublic\":true},\"getSource\":{\"name\":\"getSource\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Asset | null>\",\"isStatic\":false,\"isPublic\":true},\"getDerivatives\":{\"name\":\"getDerivatives\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Asset[]>\",\"isStatic\":false,\"isPublic\":true},\"getType\":{\"name\":\"getType\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<AssetType | null>\",\"isStatic\":false,\"isPublic\":true},\"getStatus\":{\"name\":\"getStatus\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<AssetStatus | null>\",\"isStatic\":false,\"isPublic\":true},\"getAssociations\":{\"name\":\"getAssociations\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<AssetAssociation[]>\",\"isStatic\":false,\"isPublic\":true},\"associateWith\":{\"name\":\"associateWith\",\"async\":true,\"parameters\":[{\"name\":\"metaType\",\"type\":\"string\",\"optional\":false},{\"name\":\"metaId\",\"type\":\"string\",\"optional\":false},{\"name\":\"role\",\"type\":\"any\",\"optional\":true,\"default\":\"default\"}],\"returnType\":\"Promise<AssetAssociation>\",\"isStatic\":false,\"isPublic\":true},\"getBySlug\":{\"name\":\"getBySlug\",\"async\":true,\"parameters\":[{\"name\":\"_slug\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<Asset | null>\",\"isStatic\":true,\"isPublic\":true},\"isValidImageFormat\":{\"name\":\"isValidImageFormat\",\"async\":false,\"parameters\":[],\"returnType\":\"boolean\",\"isStatic\":false,\"isPublic\":true},\"isHighResolution\":{\"name\":\"isHighResolution\",\"async\":false,\"parameters\":[],\"returnType\":\"boolean\",\"isStatic\":false,\"isPublic\":true},\"generateAltText\":{\"name\":\"generateAltText\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<string>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"api\":{\"include\":[\"list\",\"get\",\"create\",\"update\",\"delete\"]},\"mcp\":{\"include\":[\"list\",\"get\",\"create\",\"update\",\"generateAltText\"]},\"cli\":{\"skipApiCheck\":true},\"tenantScoped\":{\"mode\":\"optional\"},\"tableName\":\"assets\",\"tableStrategy\":\"sti\"},\"extends\":\"Asset\",\"exportName\":\"Image\",\"collectionExportName\":\"ImageCollection\",\"validationRules\":[{\"field\":\"version\",\"rule\":\"required\",\"fieldType\":\"integer\"}],\"schema\":{\"tableName\":\"assets\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"assets\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"_meta_type\\\" TEXT NOT NULL,\\n  \\\"_meta_data\\\" JSON,\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"name\\\" TEXT,\\n  \\\"source_uri\\\" TEXT,\\n  \\\"mime_type\\\" TEXT,\\n  \\\"description\\\" TEXT,\\n  \\\"metadata\\\" TEXT,\\n  \\\"version\\\" INTEGER DEFAULT 1,\\n  \\\"primary_version_id\\\" UUID,\\n  \\\"type_slug\\\" TEXT,\\n  \\\"status_slug\\\" TEXT,\\n  \\\"owner_profile_id\\\" UUID,\\n  \\\"source_asset_id\\\" UUID,\\n  \\\"folder_id\\\" UUID,\\n  \\\"source_type\\\" TEXT,\\n  \\\"external_id\\\" TEXT,\\n  \\\"external_refs\\\" TEXT,\\n  \\\"width\\\" INTEGER DEFAULT 0,\\n  \\\"height\\\" INTEGER DEFAULT 0,\\n  \\\"alt\\\" TEXT DEFAULT ''\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"_meta_type\":{\"type\":\"TEXT\",\"notNull\":true},\"_meta_data\":{\"type\":\"JSON\",\"notNull\":false},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false},\"name\":{\"type\":\"TEXT\",\"notNull\":false},\"source_uri\":{\"type\":\"TEXT\",\"notNull\":false},\"mime_type\":{\"type\":\"TEXT\",\"notNull\":false},\"description\":{\"type\":\"TEXT\",\"notNull\":false},\"metadata\":{\"type\":\"TEXT\",\"notNull\":false},\"version\":{\"type\":\"INTEGER\",\"notNull\":false,\"default\":1},\"primary_version_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"foreignKey\":{\"table\":\"assets\",\"column\":\"id\",\"onDelete\":\"NO ACTION\",\"onUpdate\":\"CASCADE\"}},\"type_slug\":{\"type\":\"TEXT\",\"notNull\":false},\"status_slug\":{\"type\":\"TEXT\",\"notNull\":false},\"owner_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false},\"source_asset_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"foreignKey\":{\"table\":\"assets\",\"column\":\"id\",\"onDelete\":\"NO ACTION\",\"onUpdate\":\"CASCADE\"}},\"folder_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false},\"source_type\":{\"type\":\"TEXT\",\"notNull\":false},\"external_id\":{\"type\":\"TEXT\",\"notNull\":false},\"external_refs\":{\"type\":\"TEXT\",\"notNull\":false},\"width\":{\"type\":\"INTEGER\",\"notNull\":false,\"default\":0},\"height\":{\"type\":\"INTEGER\",\"notNull\":false,\"default\":0},\"alt\":{\"type\":\"TEXT\",\"notNull\":false,\"default\":\"\"}},\"indexes\":[{\"name\":\"assets_slug_context_meta_type_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\",\"_meta_type\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"assets_meta_type_idx\",\"columns\":[\"_meta_type\"]},{\"name\":\"assets_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"assets_primary_version_id_idx\",\"columns\":[\"primary_version_id\"]},{\"name\":\"assets_owner_profile_id_idx\",\"columns\":[\"owner_profile_id\"]},{\"name\":\"assets_source_asset_id_idx\",\"columns\":[\"source_asset_id\"]},{\"name\":\"assets_folder_id_idx\",\"columns\":[\"folder_id\"]}],\"version\":\"dd79a8b6\"},\"importPath\":\"@happyvertical/smrt-images\"},\"@happyvertical/smrt-images:ImageCollection\":{\"name\":\"imagecollection\",\"className\":\"ImageCollection\",\"qualifiedName\":\"@happyvertical/smrt-images:ImageCollection\",\"collection\":\"assets\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/images/src/images.ts\",\"packageName\":\"@happyvertical/smrt-images\",\"fields\":{},\"methods\":{\"findByTenant\":{\"name\":\"findByTenant\",\"async\":true,\"parameters\":[{\"name\":\"tenantId\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"findGlobal\":{\"name\":\"findGlobal\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"findWithGlobals\":{\"name\":\"findWithGlobals\",\"async\":true,\"parameters\":[{\"name\":\"tenantId\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getByMinDimensions\":{\"name\":\"getByMinDimensions\",\"async\":true,\"parameters\":[{\"name\":\"minWidth\",\"type\":\"number\",\"optional\":false},{\"name\":\"minHeight\",\"type\":\"number\",\"optional\":false}],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getByMaxDimensions\":{\"name\":\"getByMaxDimensions\",\"async\":true,\"parameters\":[{\"name\":\"maxWidth\",\"type\":\"number\",\"optional\":false},{\"name\":\"maxHeight\",\"type\":\"number\",\"optional\":false}],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getLandscape\":{\"name\":\"getLandscape\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getPortrait\":{\"name\":\"getPortrait\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getSquare\":{\"name\":\"getSquare\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getMissingAltText\":{\"name\":\"getMissingAltText\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getHighResolution\":{\"name\":\"getHighResolution\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true},\"getByAspectRatio\":{\"name\":\"getByAspectRatio\",\"async\":true,\"parameters\":[{\"name\":\"minRatio\",\"type\":\"number\",\"optional\":false},{\"name\":\"maxRatio\",\"type\":\"number\",\"optional\":false}],\"returnType\":\"Promise<Image[]>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"assets\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"Image\",\"exportName\":\"ImageCollection\",\"collectionExportName\":\"ImageCollectionCollection\",\"schema\":{\"tableName\":\"assets\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"assets\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"_meta_type\\\" TEXT NOT NULL,\\n  \\\"_meta_data\\\" JSON,\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"name\\\" TEXT,\\n  \\\"source_uri\\\" TEXT,\\n  \\\"mime_type\\\" TEXT,\\n  \\\"description\\\" TEXT,\\n  \\\"metadata\\\" TEXT,\\n  \\\"version\\\" INTEGER DEFAULT 1,\\n  \\\"primary_version_id\\\" UUID,\\n  \\\"type_slug\\\" TEXT,\\n  \\\"status_slug\\\" TEXT,\\n  \\\"owner_profile_id\\\" UUID,\\n  \\\"source_asset_id\\\" UUID,\\n  \\\"folder_id\\\" UUID,\\n  \\\"source_type\\\" TEXT,\\n  \\\"external_id\\\" TEXT,\\n  \\\"external_refs\\\" TEXT,\\n  \\\"width\\\" INTEGER DEFAULT 0,\\n  \\\"height\\\" INTEGER DEFAULT 0,\\n  \\\"alt\\\" TEXT DEFAULT ''\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"_meta_type\":{\"type\":\"TEXT\",\"notNull\":true},\"_meta_data\":{\"type\":\"JSON\",\"notNull\":false},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false},\"name\":{\"type\":\"TEXT\",\"notNull\":false},\"source_uri\":{\"type\":\"TEXT\",\"notNull\":false},\"mime_type\":{\"type\":\"TEXT\",\"notNull\":false},\"description\":{\"type\":\"TEXT\",\"notNull\":false},\"metadata\":{\"type\":\"TEXT\",\"notNull\":false},\"version\":{\"type\":\"INTEGER\",\"notNull\":false,\"default\":1},\"primary_version_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"foreignKey\":{\"table\":\"assets\",\"column\":\"id\",\"onDelete\":\"NO ACTION\",\"onUpdate\":\"CASCADE\"}},\"type_slug\":{\"type\":\"TEXT\",\"notNull\":false},\"status_slug\":{\"type\":\"TEXT\",\"notNull\":false},\"owner_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false},\"source_asset_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"foreignKey\":{\"table\":\"assets\",\"column\":\"id\",\"onDelete\":\"NO ACTION\",\"onUpdate\":\"CASCADE\"}},\"folder_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false},\"source_type\":{\"type\":\"TEXT\",\"notNull\":false},\"external_id\":{\"type\":\"TEXT\",\"notNull\":false},\"external_refs\":{\"type\":\"TEXT\",\"notNull\":false},\"width\":{\"type\":\"INTEGER\",\"notNull\":false,\"default\":0},\"height\":{\"type\":\"INTEGER\",\"notNull\":false,\"default\":0},\"alt\":{\"type\":\"TEXT\",\"notNull\":false,\"default\":\"\"}},\"indexes\":[{\"name\":\"assets_slug_context_meta_type_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\",\"_meta_type\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"assets_meta_type_idx\",\"columns\":[\"_meta_type\"]},{\"name\":\"assets_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"assets_primary_version_id_idx\",\"columns\":[\"primary_version_id\"]},{\"name\":\"assets_owner_profile_id_idx\",\"columns\":[\"owner_profile_id\"]},{\"name\":\"assets_source_asset_id_idx\",\"columns\":[\"source_asset_id\"]},{\"name\":\"assets_folder_id_idx\",\"columns\":[\"folder_id\"]}],\"version\":\"dd79a8b6\"},\"importPath\":\"@happyvertical/smrt-images\"}},\"moduleType\":\"smrt\",\"smrtDependencies\":[\"@happyvertical/smrt-assets\",\"@happyvertical/smrt-core\",\"@happyvertical/smrt-prompts\",\"@happyvertical/smrt-tenancy\"]}"));
 //#endregion
 //#region src/prompts.ts
 var smrtImagesGenerateAltTextPrompt = definePrompt({
@@ -36,6 +36,417 @@ function promptMessageOptions(ai) {
 	};
 }
 //#endregion
+//#region src/adjust.ts
+var IMAGE_ADJUST_OPERATIONS = Object.freeze([
+	{
+		id: "brighter",
+		description: "Lighten the picture."
+	},
+	{
+		id: "darker",
+		description: "Darken the picture."
+	},
+	{
+		id: "more-contrast",
+		description: "Stronger lights and darks."
+	},
+	{
+		id: "less-contrast",
+		description: "Softer, flatter lights and darks."
+	},
+	{
+		id: "more-color",
+		description: "Richer colour."
+	},
+	{
+		id: "less-color",
+		description: "Muted colour."
+	},
+	{
+		id: "black-and-white",
+		description: "No colour."
+	},
+	{
+		id: "rotate",
+		description: "Turn the picture a quarter or half turn."
+	},
+	{
+		id: "flip",
+		description: "Mirror the picture."
+	},
+	{
+		id: "zoom",
+		description: "Zoom in on one part of the picture (a closer crop)."
+	},
+	{
+		id: "resize",
+		description: "Make the picture smaller."
+	}
+]);
+var OPERATION_IDS = new Set(IMAGE_ADJUST_OPERATIONS.map((op) => op.id));
+function isImageAdjustOperation(value) {
+	return typeof value === "string" && OPERATION_IDS.has(value);
+}
+var FOCI = [
+	"center",
+	"top",
+	"bottom",
+	"left",
+	"right",
+	"top-left",
+	"top-right",
+	"bottom-left",
+	"bottom-right"
+];
+function isImageFocus(value) {
+	return typeof value === "string" && FOCI.includes(value);
+}
+var MIN_SIDE = 16;
+var MAX_SIDE = 8192;
+var MIN_REGION = .05;
+function clamp(value, min, max) {
+	return Math.min(max, Math.max(min, value));
+}
+function round(value, places = 3) {
+	const factor = 10 ** places;
+	return Math.round(value * factor) / factor;
+}
+function finite(value) {
+	const n = typeof value === "string" ? Number(value) : value;
+	return typeof n === "number" && Number.isFinite(n) ? n : null;
+}
+function normalizeRegion(value) {
+	if (!value || typeof value !== "object") return void 0;
+	const record = value;
+	const left = finite(record.left);
+	const top = finite(record.top);
+	const width = finite(record.width);
+	const height = finite(record.height);
+	if (left == null || top == null || width == null || height == null) throw new Error("A region needs left, top, width and height (0 to 1).");
+	const l = clamp(left, 0, 1 - MIN_REGION);
+	const t = clamp(top, 0, 1 - MIN_REGION);
+	const w = clamp(width, MIN_REGION, 1 - l);
+	const h = clamp(height, MIN_REGION, 1 - t);
+	if (l === 0 && t === 0 && w === 1 && h === 1) return void 0;
+	return {
+		left: round(l),
+		top: round(t),
+		width: round(w),
+		height: round(h)
+	};
+}
+function normalizeImageAdjustments(input) {
+	if (!input || typeof input !== "object") return {};
+	const record = input;
+	const result = {};
+	const multiplier = (key, min, max) => {
+		const value = finite(record[key]);
+		if (value == null) return void 0;
+		const clamped = round(clamp(value, min, max));
+		return clamped === 1 ? void 0 : clamped;
+	};
+	const brightness = multiplier("brightness", .2, 3);
+	if (brightness != null) result.brightness = brightness;
+	const contrast = multiplier("contrast", .2, 3);
+	if (contrast != null) result.contrast = contrast;
+	const saturation = multiplier("saturation", 0, 3);
+	if (saturation != null) result.saturation = saturation;
+	if (record.grayscale === true) result.grayscale = true;
+	const rotate = finite(record.rotate);
+	if (rotate != null) {
+		const turn = (Math.round(rotate) % 360 + 360) % 360;
+		if (turn % 90 !== 0) throw new Error("Pictures can only be turned a quarter or half turn.");
+		if (turn !== 0) result.rotate = turn;
+	}
+	if (record.flipHorizontal === true) result.flipHorizontal = true;
+	if (record.flipVertical === true) result.flipVertical = true;
+	const region = normalizeRegion(record.region);
+	if (region) result.region = region;
+	for (const key of ["maxWidth", "maxHeight"]) {
+		const value = finite(record[key]);
+		if (value != null) result[key] = Math.round(clamp(value, MIN_SIDE, MAX_SIDE));
+	}
+	return result;
+}
+function isEmptyImageAdjustments(adjustments) {
+	return Object.keys(normalizeImageAdjustments(adjustments)).length === 0;
+}
+function encodeImageAdjustments(input) {
+	const a = normalizeImageAdjustments(input);
+	const parts = [];
+	if (a.brightness != null) parts.push(`b${a.brightness}`);
+	if (a.contrast != null) parts.push(`c${a.contrast}`);
+	if (a.saturation != null) parts.push(`s${a.saturation}`);
+	if (a.grayscale) parts.push("g");
+	if (a.rotate) parts.push(`r${a.rotate}`);
+	if (a.flipHorizontal) parts.push("fh");
+	if (a.flipVertical) parts.push("fv");
+	if (a.region) {
+		const { left, top, width, height } = a.region;
+		parts.push(`x${left}_${top}_${width}_${height}`);
+	}
+	if (a.maxWidth != null) parts.push(`w${a.maxWidth}`);
+	if (a.maxHeight != null) parts.push(`h${a.maxHeight}`);
+	return parts.join(",");
+}
+function decodeImageAdjustments(spec) {
+	const text = typeof spec === "string" ? spec.trim() : "";
+	if (!text) return {};
+	if (text.length > 200) throw new Error("Unknown picture adjustment.");
+	const raw = {};
+	for (const part of text.split(",")) {
+		const match = /^(b|c|s|r|w|h|x)([0-9._-]+)$|^(g|fh|fv)$/.exec(part);
+		if (!match) throw new Error("Unknown picture adjustment.");
+		if (match[3] === "g") raw.grayscale = true;
+		else if (match[3] === "fh") raw.flipHorizontal = true;
+		else if (match[3] === "fv") raw.flipVertical = true;
+		else if (match[1] === "x") {
+			const values = match[2].split("_").map(Number);
+			if (values.length !== 4 || values.some((v) => !Number.isFinite(v))) throw new Error("Unknown picture adjustment.");
+			const [left, top, width, height] = values;
+			raw.region = {
+				left,
+				top,
+				width,
+				height
+			};
+		} else {
+			const value = Number(match[2]);
+			if (!Number.isFinite(value)) throw new Error("Unknown picture adjustment.");
+			const key = {
+				b: "brightness",
+				c: "contrast",
+				s: "saturation",
+				r: "rotate",
+				w: "maxWidth",
+				h: "maxHeight"
+			}[match[1]];
+			raw[key] = value;
+		}
+	}
+	return normalizeImageAdjustments(raw);
+}
+function regionForFocus(focus, scale) {
+	const size = clamp(scale, .3, .95);
+	const spare = 1 - size;
+	const horizontal = focus.includes("left") ? 0 : focus.includes("right") ? spare : spare / 2;
+	const vertical = focus.startsWith("top") ? 0 : focus.startsWith("bottom") ? spare : spare / 2;
+	return {
+		left: round(horizontal),
+		top: round(vertical),
+		width: round(size),
+		height: round(size)
+	};
+}
+var PERCENT_STEPS = [
+	10,
+	20,
+	30
+];
+function imageAdjustVariants(operation, options = {}) {
+	switch (operation) {
+		case "brighter": return PERCENT_STEPS.map((step) => ({
+			id: `brighter-${step}`,
+			label: `${step}% brighter`,
+			adjustments: { brightness: 1 + step / 100 }
+		}));
+		case "darker": return PERCENT_STEPS.map((step) => ({
+			id: `darker-${step}`,
+			label: `${step}% darker`,
+			adjustments: { brightness: 1 - step / 100 }
+		}));
+		case "more-contrast": return PERCENT_STEPS.map((step) => ({
+			id: `contrast-up-${step}`,
+			label: `${step}% more contrast`,
+			adjustments: { contrast: 1 + step / 100 }
+		}));
+		case "less-contrast": return PERCENT_STEPS.map((step) => ({
+			id: `contrast-down-${step}`,
+			label: `${step}% less contrast`,
+			adjustments: { contrast: 1 - step / 100 }
+		}));
+		case "more-color": return PERCENT_STEPS.map((step) => ({
+			id: `color-up-${step}`,
+			label: `${step * 2}% more colour`,
+			adjustments: { saturation: 1 + step * 2 / 100 }
+		}));
+		case "less-color": return PERCENT_STEPS.map((step) => ({
+			id: `color-down-${step}`,
+			label: `${step * 2}% less colour`,
+			adjustments: { saturation: 1 - step * 2 / 100 }
+		}));
+		case "black-and-white": return [
+			{
+				id: "bw",
+				label: "Black and white",
+				adjustments: { grayscale: true }
+			},
+			{
+				id: "bw-contrast",
+				label: "Black and white, stronger",
+				description: "More contrast, like a newspaper photo.",
+				adjustments: {
+					grayscale: true,
+					contrast: 1.25
+				}
+			},
+			{
+				id: "bw-soft",
+				label: "Black and white, softer",
+				adjustments: {
+					grayscale: true,
+					contrast: .85,
+					brightness: 1.05
+				}
+			}
+		];
+		case "rotate": return [
+			{
+				id: "rotate-right",
+				label: "Turn right",
+				adjustments: { rotate: 90 }
+			},
+			{
+				id: "rotate-left",
+				label: "Turn left",
+				adjustments: { rotate: 270 }
+			},
+			{
+				id: "rotate-half",
+				label: "Upside down",
+				adjustments: { rotate: 180 }
+			}
+		];
+		case "flip": return [{
+			id: "flip-horizontal",
+			label: "Mirror left to right",
+			adjustments: { flipHorizontal: true }
+		}, {
+			id: "flip-vertical",
+			label: "Mirror top to bottom",
+			adjustments: { flipVertical: true }
+		}];
+		case "zoom": {
+			const focus = options.focus ?? "center";
+			return [
+				{
+					id: "zoom-1",
+					label: "A little closer",
+					scale: .8
+				},
+				{
+					id: "zoom-2",
+					label: "Closer",
+					scale: .65
+				},
+				{
+					id: "zoom-3",
+					label: "Much closer",
+					scale: .5
+				}
+			].map(({ id, label, scale }) => ({
+				id,
+				label,
+				adjustments: { region: regionForFocus(focus, scale) }
+			}));
+		}
+		case "resize": return [
+			{
+				id: "size-large",
+				label: "Large (1600 wide)",
+				side: 1600
+			},
+			{
+				id: "size-medium",
+				label: "Medium (1200 wide)",
+				side: 1200
+			},
+			{
+				id: "size-small",
+				label: "Small (800 wide)",
+				side: 800
+			}
+		].map(({ id, label, side }) => ({
+			id,
+			label,
+			adjustments: {
+				maxWidth: side,
+				maxHeight: side
+			}
+		}));
+		default: throw new Error("Unknown picture adjustment.");
+	}
+}
+function describeImageAdjustments(input) {
+	const a = normalizeImageAdjustments(input);
+	const percent = (value) => Math.round(Math.abs(value - 1) * 100);
+	const parts = [];
+	if (a.rotate) parts.push(a.rotate === 90 ? "turned right" : a.rotate === 270 ? "turned left" : "turned upside down");
+	if (a.flipHorizontal) parts.push("mirrored left to right");
+	if (a.flipVertical) parts.push("mirrored top to bottom");
+	if (a.region) parts.push("zoomed in");
+	if (a.brightness != null) parts.push(`${percent(a.brightness)}% ${a.brightness > 1 ? "brighter" : "darker"}`);
+	if (a.contrast != null) parts.push(`${percent(a.contrast)}% ${a.contrast > 1 ? "more" : "less"} contrast`);
+	if (a.saturation != null) parts.push(`${percent(a.saturation)}% ${a.saturation > 1 ? "more" : "less"} colour`);
+	if (a.grayscale) parts.push("black and white");
+	if (a.maxWidth != null || a.maxHeight != null) parts.push("smaller");
+	return parts.join(", ") || "unchanged";
+}
+function regionToPixels(region, width, height) {
+	const left = clamp(Math.round(region.left * width), 0, width - 1);
+	const top = clamp(Math.round(region.top * height), 0, height - 1);
+	return {
+		left,
+		top,
+		width: clamp(Math.round(region.width * width), 1, width - left),
+		height: clamp(Math.round(region.height * height), 1, height - top)
+	};
+}
+async function applyImageAdjustments(data, input, options = {}) {
+	const a = normalizeImageAdjustments(input);
+	const { default: sharp } = await import("sharp");
+	let pipeline = sharp(data, { failOn: "error" }).rotate();
+	if (a.rotate) pipeline = pipeline.rotate(a.rotate);
+	if (a.flipHorizontal) pipeline = pipeline.flop();
+	if (a.flipVertical) pipeline = pipeline.flip();
+	if (a.region) {
+		const turned = await pipeline.clone().toBuffer({ resolveWithObject: true });
+		pipeline = sharp(turned.data).extract(regionToPixels(a.region, turned.info.width, turned.info.height));
+	}
+	if (a.brightness != null || a.saturation != null) pipeline = pipeline.modulate({
+		...a.brightness != null ? { brightness: a.brightness } : {},
+		...a.saturation != null ? { saturation: a.saturation } : {}
+	});
+	if (a.contrast != null) pipeline = pipeline.linear(a.contrast, 128 * (1 - a.contrast));
+	if (a.grayscale) pipeline = pipeline.grayscale();
+	if (a.maxWidth != null || a.maxHeight != null) pipeline = pipeline.resize({
+		width: a.maxWidth,
+		height: a.maxHeight,
+		fit: "inside",
+		withoutEnlargement: true
+	});
+	if (options.fit) pipeline = sharp(await pipeline.toBuffer()).resize({
+		width: options.fit.width,
+		height: options.fit.height,
+		fit: options.fit.fit ?? "inside",
+		withoutEnlargement: options.fit.fit !== "cover"
+	});
+	const sourceFormat = (await sharp(data).metadata()).format;
+	const format = options.format ?? (sourceFormat === "png" || sourceFormat === "webp" ? sourceFormat : "jpeg");
+	const quality = clamp(Math.round(options.quality ?? 88), 30, 100);
+	pipeline = format === "png" ? pipeline.png() : format === "webp" ? pipeline.webp({ quality }) : pipeline.jpeg({
+		quality,
+		mozjpeg: true
+	});
+	const out = await pipeline.toBuffer({ resolveWithObject: true });
+	return {
+		data: out.data,
+		mimeType: `image/${format}`,
+		width: out.info.width,
+		height: out.info.height
+	};
+}
+//#endregion
 //#region src/categorizer.ts
 var MAX_LABEL_VOCABULARY_ENTRIES = 64;
 var MAX_LABEL_NAME_LENGTH = 128;
@@ -372,7 +783,8 @@ var ImageEditor = class {
 		}
 	}
 	/**
-	* Crop an image to the specified region
+	* Crop an image to the specified region (in pixels of the picture as it is
+	* seen, after its EXIF orientation). The region is clamped to the picture.
 	*
 	* @param image - Source image
 	* @param x - Left offset
@@ -382,29 +794,54 @@ var ImageEditor = class {
 	* @returns New derivative Image
 	*/
 	async crop(image, x, y, w, h) {
-		const { getImageProcessor } = await import("@happyvertical/images");
-		const processor = await getImageProcessor();
+		if ([
+			x,
+			y,
+			w,
+			h
+		].some((value) => !Number.isFinite(value))) throw new Error("Crop needs a left, top, width and height in pixels.");
+		if (w < 1 || h < 1) throw new Error("A crop must be at least one pixel wide and tall.");
 		const sourceData = await this.store.read(image);
-		const inputPath = join(tmpdir(), `smrt-crop-in-${randomUUID()}.bin`);
-		const outputPath = join(tmpdir(), `smrt-crop-out-${randomUUID()}.bin`);
-		try {
-			await writeFile(inputPath, sourceData);
-			await processor.resize(inputPath, outputPath, {
-				width: w,
-				height: h,
-				fit: "cover"
-			});
-			const cropped = await readFile(outputPath);
-			return this.createDerivative(image, cropped, {
-				name: `${image.name}-crop`,
-				width: w,
-				height: h,
-				description: `Cropped region ${x},${y} ${w}x${h}`
-			});
-		} finally {
-			await unlink(inputPath).catch(() => {});
-			await unlink(outputPath).catch(() => {});
-		}
+		const { default: sharp } = await import("sharp");
+		const oriented = await sharp(sourceData).rotate().toBuffer({ resolveWithObject: true });
+		const { width, height } = oriented.info;
+		const left = Math.min(Math.max(Math.round(x), 0), width - 1);
+		const top = Math.min(Math.max(Math.round(y), 0), height - 1);
+		const cropWidth = Math.min(Math.round(w), width - left);
+		const cropHeight = Math.min(Math.round(h), height - top);
+		const cropped = await sharp(oriented.data).extract({
+			left,
+			top,
+			width: cropWidth,
+			height: cropHeight
+		}).toBuffer();
+		return this.createDerivative(image, cropped, {
+			name: `${image.name}-crop`,
+			width: cropWidth,
+			height: cropHeight,
+			description: `Cropped region ${left},${top} ${cropWidth}x${cropHeight}`
+		});
+	}
+	/**
+	* Brightness, contrast, colour, black-and-white, rotate, flip, region crop
+	* or resize, in one pass (see `./adjust.ts`). The source is unchanged; the
+	* result is a new derivative linked to it.
+	*
+	* @param image - Source image
+	* @param adjustments - What to change (checked and clamped)
+	* @returns New derivative Image
+	*/
+	async adjust(image, adjustments) {
+		const normalized = normalizeImageAdjustments(adjustments);
+		if (Object.keys(normalized).length === 0) throw new Error("Nothing to change: the adjustments leave the picture as it is.");
+		const adjusted = await applyImageAdjustments(await this.store.read(image), normalized);
+		return this.createDerivative(image, adjusted.data, {
+			name: `${image.name}-adjusted`,
+			width: adjusted.width,
+			height: adjusted.height,
+			mimeType: adjusted.mimeType,
+			description: `Adjusted: ${describeImageAdjustments(normalized)}`
+		});
 	}
 	/**
 	* Convert an image to a different format
@@ -912,6 +1349,6 @@ var UpstreamManager = class {
 	}
 };
 //#endregion
-export { Image, ImageCategorizer, ImageCollection, ImageDeriver, ImageEditor, ImageMetadataExtractor, ImageSearch, UpstreamManager, persistImageMediaBundleInspection, smrtImagesGenerateAltTextPrompt };
+export { IMAGE_ADJUST_OPERATIONS, Image, ImageCategorizer, ImageCollection, ImageDeriver, ImageEditor, ImageMetadataExtractor, ImageSearch, UpstreamManager, applyImageAdjustments, decodeImageAdjustments, describeImageAdjustments, encodeImageAdjustments, imageAdjustVariants, isEmptyImageAdjustments, isImageAdjustOperation, isImageFocus, normalizeImageAdjustments, persistImageMediaBundleInspection, regionForFocus, regionToPixels, smrtImagesGenerateAltTextPrompt };
 
 //# sourceMappingURL=index.js.map