@happyvertical/smrt-assets 0.51.39 → 0.52.0

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-assets",
-  "packageVersion": "0.51.39",
+  "packageVersion": "0.52.0",
   "objects": {
     "@happyvertical/smrt-assets:AssetAssociation": {
       "name": "assetassociation",
@@ -1034,6 +1034,385 @@
       },
       "importPath": "@happyvertical/smrt-assets"
     },
+    "@happyvertical/smrt-assets:AssetTag": {
+      "name": "assettag",
+      "className": "AssetTag",
+      "qualifiedName": "@happyvertical/smrt-assets:AssetTag",
+      "collection": "assettags",
+      "filePath": "/home/runner/work/smrt/smrt/packages/assets/src/asset-tag.ts",
+      "packageName": "@happyvertical/smrt-assets",
+      "fields": {
+        "tenantId": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "sqlType": "UUID",
+            "nullable": true,
+            "__tenancy": {
+              "isTenantIdField": true,
+              "autoFilter": true,
+              "required": false,
+              "autoPopulate": true,
+              "nullable": true,
+              "mode": "optional",
+              "field": "tenantId",
+              "allowSuperAdminBypass": false
+            }
+          }
+        },
+        "assetId": {
+          "type": "foreignKey",
+          "required": true,
+          "related": "Asset",
+          "_meta": {
+            "required": true,
+            "onDelete": "CASCADE"
+          }
+        },
+        "tagId": {
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-tags:Tag",
+          "_meta": {
+            "onDelete": "CASCADE"
+          }
+        }
+      },
+      "methods": {},
+      "decoratorConfig": {
+        "tableName": "asset_tags",
+        "conflictColumns": [
+          "asset_id",
+          "tag_id"
+        ],
+        "api": false,
+        "mcp": false,
+        "cli": false,
+        "tenantScoped": {
+          "mode": "optional"
+        }
+      },
+      "extends": "SmrtObject",
+      "exportName": "AssetTag",
+      "collectionExportName": "AssetTagCollection",
+      "validationRules": [
+        {
+          "field": "assetId",
+          "rule": "required",
+          "fieldType": "foreignKey"
+        },
+        {
+          "field": "tagId",
+          "rule": "required",
+          "fieldType": "crossPackageRef"
+        }
+      ],
+      "schema": {
+        "tableName": "asset_tags",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"asset_tags\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"asset_id\" UUID NOT NULL,\n  \"tag_id\" UUID NOT NULL\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "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,
+            "unique": false
+          },
+          "asset_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "assets",
+              "column": "id",
+              "onDelete": "CASCADE",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "tag_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "asset_tags_asset_id_tag_id_idx",
+            "columns": [
+              "asset_id",
+              "tag_id"
+            ],
+            "unique": true
+          },
+          {
+            "name": "asset_tags_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "asset_tags_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "asset_tags_tag_id_idx",
+            "columns": [
+              "tag_id"
+            ]
+          }
+        ],
+        "version": "e60d24f5"
+      },
+      "importPath": "@happyvertical/smrt-assets"
+    },
+    "@happyvertical/smrt-assets:AssetTagCollection": {
+      "name": "assettagcollection",
+      "className": "AssetTagCollection",
+      "qualifiedName": "@happyvertical/smrt-assets:AssetTagCollection",
+      "collection": "assettags",
+      "filePath": "/home/runner/work/smrt/smrt/packages/assets/src/asset-tags.ts",
+      "packageName": "@happyvertical/smrt-assets",
+      "fields": {},
+      "methods": {
+        "byLeft": {
+          "name": "byLeft",
+          "async": true,
+          "parameters": [
+            {
+              "name": "leftId",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "opts",
+              "type": "JunctionFilterOptions",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<TItem[]>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "byRight": {
+          "name": "byRight",
+          "async": true,
+          "parameters": [
+            {
+              "name": "rightId",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "opts",
+              "type": "JunctionFilterOptions",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<TItem[]>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "attach": {
+          "name": "attach",
+          "async": true,
+          "parameters": [
+            {
+              "name": "leftId",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "rightId",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "opts",
+              "type": "JunctionAttachOptions",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<TItem>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "detach": {
+          "name": "detach",
+          "async": true,
+          "parameters": [
+            {
+              "name": "leftId",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "rightId",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "opts",
+              "type": "JunctionFilterOptions",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "setLinks": {
+          "name": "setLinks",
+          "async": true,
+          "parameters": [
+            {
+              "name": "leftId",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "rightIds",
+              "type": "string[]",
+              "optional": false
+            },
+            {
+              "name": "opts",
+              "type": "JunctionAttachOptions",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "asset_tags",
+        "api": false,
+        "mcp": false,
+        "cli": false
+      },
+      "extends": "SmrtJunction",
+      "extendsTypeArg": "AssetTag",
+      "exportName": "AssetTagCollection",
+      "collectionExportName": "AssetTagCollectionCollection",
+      "schema": {
+        "tableName": "asset_tags",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"asset_tags\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID,\n  \"asset_id\" UUID NOT NULL,\n  \"tag_id\" UUID NOT NULL\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "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,
+            "unique": false
+          },
+          "asset_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "assets",
+              "column": "id",
+              "onDelete": "CASCADE",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "tag_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "asset_tags_asset_id_tag_id_idx",
+            "columns": [
+              "asset_id",
+              "tag_id"
+            ],
+            "unique": true
+          },
+          {
+            "name": "asset_tags_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "asset_tags_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "asset_tags_tag_id_idx",
+            "columns": [
+              "tag_id"
+            ]
+          }
+        ],
+        "version": "e60d24f5"
+      },
+      "importPath": "@happyvertical/smrt-assets"
+    },
     "@happyvertical/smrt-assets:AssetType": {
       "name": "assettype",
       "className": "AssetType",
@@ -1402,6 +1781,14 @@
         }
       },
       "methods": {
+        "getSlug": {
+          "name": "getSlug",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<string | null | undefined>",
+          "isStatic": false,
+          "isPublic": true
+        },
         "getMetadata": {
           "name": "getMetadata",
           "async": false,
@@ -1496,6 +1883,11 @@
               "name": "tagSlug",
               "type": "string",
               "optional": false
+            },
+            {
+              "name": "context",
+              "type": "string",
+              "optional": true
             }
           ],
           "returnType": "Promise<boolean>",
@@ -1859,12 +2251,17 @@
               "optional": false
             },
             {
-              "name": "tagSlug",
+              "name": "tag",
               "type": "string",
               "optional": false
+            },
+            {
+              "name": "options",
+              "type": "AssetTagInput",
+              "optional": true
             }
           ],
-          "returnType": "Promise<void>",
+          "returnType": "Promise<Tag>",
           "isStatic": false,
           "isPublic": true
         },
@@ -1878,23 +2275,71 @@
               "optional": false
             },
             {
-              "name": "tagSlug",
+              "name": "tag",
               "type": "string",
               "optional": false
+            },
+            {
+              "name": "options",
+              "type": "Pick<AssetTagInput, 'context'>",
+              "optional": true
             }
           ],
           "returnType": "Promise<void>",
           "isStatic": false,
           "isPublic": true
         },
+        "setTags": {
+          "name": "setTags",
+          "async": true,
+          "parameters": [
+            {
+              "name": "assetId",
+              "type": "string",
+              "optional": false
+            },
+            {
+              "name": "tags",
+              "type": "string[]",
+              "optional": false
+            },
+            {
+              "name": "options",
+              "type": "Pick<AssetTagInput, 'context'>",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<Tag[]>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "getTagsForAssets": {
+          "name": "getTagsForAssets",
+          "async": true,
+          "parameters": [
+            {
+              "name": "assetIds",
+              "type": "string[]",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<Map<string, Tag[]>>",
+          "isStatic": false,
+          "isPublic": true
+        },
         "getByTag": {
           "name": "getByTag",
           "async": true,
           "parameters": [
             {
-              "name": "tagSlug",
+              "name": "tag",
               "type": "string",
               "optional": false
+            },
+            {
+              "name": "options",
+              "type": "Pick<AssetTagInput, 'context'>",
+              "optional": true
             }
           ],
           "returnType": "Promise<Asset[]>",

package/dist/owned-asset-helpers.d.ts

@@ -13,6 +13,21 @@ export interface AssetOwnerCollection<OwnerType extends AssetOwnerRecord> {
 }
 export declare function assertValidOwnedAssetRelationship(relationship: string): void;
 export declare function assertValidOwnedAssetSortOrder(sortOrder: number): void;
+/**
+ * Refuse to link an asset to an owner (place, profile, …) of another tenant.
+ *
+ * The asset's tenant is read from STORAGE by id under system context, never
+ * taken from the caller's object: `new Asset({ id: foreignId })` or a stale
+ * copy carries no (or the wrong) tenant and would otherwise pass. Rules:
+ *
+ * - a tenant owner may link its own assets and global (tenantless) ones;
+ * - a global owner may link only global assets — a tenant's asset linked to
+ *   a global owner would be listed to every tenant through the global link;
+ * - an asset id with no stored row is refused.
+ *
+ * @param ownerLabel - plain noun for the error ("place", "profile")
+ */
+export declare function assertAssetLinkable(db: SmrtCollectionOptions['db'], assetId: string, ownerTenantId: string | null | undefined, ownerLabel: string): Promise<void>;
 export declare function resolveOwnedAssetsById(db: SmrtCollectionOptions['db'], assetIds: string[], tenantId?: string | null): Promise<Asset[]>;
 export declare function getOwnedAssetsFromCollection<OwnerType extends AssetOwnerRecord>(collection: AssetOwnerCollection<OwnerType>, ownerId: string, relationship?: string): Promise<Asset[]>;
 export declare function addOwnedAssetFromCollection<OwnerType extends AssetOwnerRecord>(collection: AssetOwnerCollection<OwnerType>, ownerType: string, ownerId: string, asset: Asset, relationship?: string, sortOrder?: number): Promise<void>;

package/dist/owned-asset-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"owned-asset-helpers.d.ts","sourceRoot":"","sources":["../src/owned-asset-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC,eAAO,MAAM,gCAAgC,QAA6B,CAAC;AAE3E,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACnD,QAAQ,CACN,KAAK,EAAE,KAAK,EACZ,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,oBAAoB,CAAC,SAAS,SAAS,gBAAgB;IACtE,GAAG,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;CACvD;AAED,wBAAgB,iCAAiC,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAM5E;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAMtE;AAED,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,qBAAqB,CAAC,IAAI,CAAC,EAC/B,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,KAAK,EAAE,CAAC,CAuBlB;AASD,wBAAsB,4BAA4B,CAChD,SAAS,SAAS,gBAAgB,EAElC,UAAU,EAAE,oBAAoB,CAAC,SAAS,CAAC,EAC3C,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,KAAK,EAAE,CAAC,CAOlB;AAED,wBAAsB,2BAA2B,CAC/C,SAAS,SAAS,gBAAgB,EAElC,UAAU,EAAE,oBAAoB,CAAC,SAAS,CAAC,EAC3C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,EACZ,YAAY,SAAe,EAC3B,SAAS,SAAI,GACZ,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,8BAA8B,CAClD,SAAS,SAAS,gBAAgB,EAElC,UAAU,EAAE,oBAAoB,CAAC,SAAS,CAAC,EAC3C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAOf"}
+{"version":3,"file":"owned-asset-helpers.d.ts","sourceRoot":"","sources":["../src/owned-asset-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC,eAAO,MAAM,gCAAgC,QAA6B,CAAC;AAE3E,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACnD,QAAQ,CACN,KAAK,EAAE,KAAK,EACZ,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,oBAAoB,CAAC,SAAS,SAAS,gBAAgB;IACtE,GAAG,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;CACvD;AAED,wBAAgB,iCAAiC,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAM5E;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAMtE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,qBAAqB,CAAC,IAAI,CAAC,EAC/B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,qBAAqB,CAAC,IAAI,CAAC,EAC/B,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,KAAK,EAAE,CAAC,CAuBlB;AASD,wBAAsB,4BAA4B,CAChD,SAAS,SAAS,gBAAgB,EAElC,UAAU,EAAE,oBAAoB,CAAC,SAAS,CAAC,EAC3C,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,KAAK,EAAE,CAAC,CAOlB;AAED,wBAAsB,2BAA2B,CAC/C,SAAS,SAAS,gBAAgB,EAElC,UAAU,EAAE,oBAAoB,CAAC,SAAS,CAAC,EAC3C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,EACZ,YAAY,SAAe,EAC3B,SAAS,SAAI,GACZ,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,8BAA8B,CAClD,SAAS,SAAS,gBAAgB,EAElC,UAAU,EAAE,oBAAoB,CAAC,SAAS,CAAC,EAC3C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAOf"}