@twin.org/nft-models 0.0.1-next.9 → 0.0.2-next.1

package/dist/types/models/INftComponent.d.ts

@@ -5,7 +5,6 @@ import type { IComponent } from "@twin.org/core";
 export interface INftComponent extends IComponent {
     /**
      * Mint an NFT.
-     * @param issuer The issuer for the NFT, will also be the initial owner.
      * @param tag The tag for the NFT.
      * @param immutableMetadata The immutable metadata for the NFT.
      * @param metadata The metadata for the NFT.
@@ -13,14 +12,14 @@ export interface INftComponent extends IComponent {
      * @param identity The identity to perform the nft operation on.
      * @returns The id of the created NFT in urn format.
      */
-    mint<T = unknown, U = unknown>(issuer: string, tag: string, immutableMetadata?: T, metadata?: U, namespace?: string, identity?: string): Promise<string>;
+    mint<T = unknown, U = unknown>(tag: string, immutableMetadata?: T, metadata?: U, namespace?: string, identity?: string): Promise<string>;
     /**
      * Resolve an NFT.
      * @param id The id of the NFT to resolve.
-     * @param identity The identity to perform the nft operation on.
+     * @param controllerIdentity The identity to perform the nft operation on.
      * @returns The data for the NFT.
      */
-    resolve<T = unknown, U = unknown>(id: string, identity?: string): Promise<{
+    resolve<T = unknown, U = unknown>(id: string, controllerIdentity?: string): Promise<{
         issuer: string;
         owner: string;
         tag: string;
@@ -30,25 +29,26 @@ export interface INftComponent extends IComponent {
     /**
      * Burn an NFT.
      * @param id The id of the NFT to burn in urn format.
-     * @param identity The identity to perform the nft operation on.
+     * @param controllerIdentity The identity to perform the nft operation on.
      * @returns Nothing.
      */
-    burn(id: string, identity?: string): Promise<void>;
+    burn(id: string, controllerIdentity?: string): Promise<void>;
     /**
      * Transfer an NFT.
      * @param id The id of the NFT to transfer in urn format.
-     * @param recipient The recipient of the NFT.
+     * @param recipientIdentity The recipient identity for the NFT.
+     * @param recipientAddress The recipient address for the NFT.
      * @param metadata Optional mutable data to include during the transfer.
-     * @param identity The identity to perform the nft operation on.
+     * @param controllerIdentity The identity to perform the nft operation on.
      * @returns Nothing.
      */
-    transfer<T = unknown>(id: string, recipient: string, metadata?: T, identity?: string): Promise<void>;
+    transfer<U = unknown>(id: string, recipientIdentity: string, recipientAddress: string, metadata?: U, controllerIdentity?: string): Promise<void>;
     /**
      * Update the mutable data of the NFT.
      * @param id The id of the NFT to update in urn format.
      * @param metadata The mutable data to update.
-     * @param identity The identity to perform the nft operation on.
+     * @param controllerIdentity The identity to perform the nft operation on.
      * @returns Nothing.
      */
-    update<T = unknown>(id: string, metadata: T, identity?: string): Promise<void>;
+    update<U = unknown>(id: string, metadata: U, controllerIdentity?: string): Promise<void>;
 }

package/dist/types/models/INftConnector.d.ts

@@ -5,14 +5,13 @@ import type { IComponent } from "@twin.org/core";
 export interface INftConnector extends IComponent {
     /**
      * Mint an NFT.
-     * @param controller The identity of the user to access the vault keys.
-     * @param issuerAddress The issuer for the NFT, will also be the initial owner.
+     * @param controllerIdentity The identity of the user to access the vault keys.
      * @param tag The tag for the NFT.
      * @param immutableMetadata The immutable metadata for the NFT.
      * @param metadata The metadata for the NFT.
      * @returns The id of the created NFT in urn format.
      */
-    mint<T = unknown, U = unknown>(controller: string, issuerAddress: string, tag: string, immutableMetadata?: T, metadata?: U): Promise<string>;
+    mint<T = unknown, U = unknown>(controllerIdentity: string, tag: string, immutableMetadata?: T, metadata?: U): Promise<string>;
     /**
      * Resolve an NFT.
      * @param id The id of the NFT to resolve.
@@ -34,19 +33,20 @@ export interface INftConnector extends IComponent {
     burn(controller: string, id: string): Promise<void>;
     /**
      * Transfer an NFT.
-     * @param controller The controller of the NFT who can make changes.
+     * @param controllerIdentity The controller of the NFT who can make changes.
      * @param id The id of the NFT to transfer in urn format.
-     * @param recipient The recipient of the NFT.
+     * @param recipientIdentity The recipient identity for the NFT.
+     * @param recipientAddress The recipient address for the NFT.
      * @param metadata Optional mutable data to include during the transfer.
      * @returns Nothing.
      */
-    transfer<T = unknown>(controller: string, id: string, recipient: string, metadata?: T): Promise<void>;
+    transfer<U = unknown>(controllerIdentity: string, id: string, recipientIdentity: string, recipientAddress: string, metadata?: U): Promise<void>;
     /**
      * Update the mutable data of the NFT.
-     * @param controller The controller of the NFT who can make changes.
+     * @param controllerIdentity The controller of the NFT who can make changes.
      * @param id The id of the NFT to update in urn format.
      * @param metadata The mutable data to update.
      * @returns Nothing.
      */
-    update<T = unknown>(controller: string, id: string, metadata: T): Promise<void>;
+    update<U = unknown>(controllerIdentity: string, id: string, metadata: U): Promise<void>;
 }

package/dist/types/models/api/INftMintRequest.d.ts

@@ -6,10 +6,6 @@ export interface INftMintRequest {
      * The data to be used in the minting.
      */
     body: {
-        /**
-         * The issuer for the NFT, will also be the initial owner.
-         */
-        issuer: string;
         /**
          * The tag for the NFT.
          */

package/dist/types/models/api/INftTransferRequest.d.ts

@@ -16,9 +16,13 @@ export interface INftTransferRequest {
      */
     body: {
         /**
-         * The recipient for the NFT.
+         * The recipient identity for the NFT.
          */
-        recipient: string;
+        recipientIdentity: string;
+        /**
+         * The recipient address for the NFT.
+         */
+        recipientAddress: string;
         /**
          * The metadata for the NFT.
          */

package/docs/changelog.md

@@ -1,5 +1,83 @@
 # @twin.org/nft-models - Changelog
 
-## v0.0.1-next.9
+## [0.0.2-next.1](https://github.com/twinfoundation/nft/compare/nft-models-v0.0.2-next.0...nft-models-v0.0.2-next.1) (2025-07-16)
+
+
+### Features
+
+* update dependencies ([8660f76](https://github.com/twinfoundation/nft/commit/8660f76ca324b0f476e45544cac6bee4b3146c3b))
+* use shared store mechanism ([#16](https://github.com/twinfoundation/nft/issues/16)) ([897bc78](https://github.com/twinfoundation/nft/commit/897bc7805248ba1388b2dd03df24c33f1633f344))
+
+## 0.0.1 (2025-07-09)
+
+
+### Features
+
+* release to production ([4d338b3](https://github.com/twinfoundation/nft/commit/4d338b3e8a4dbccc61a1d1da3c470ba86cefe535))
+
+## [0.0.1-next.32](https://github.com/twinfoundation/nft/compare/nft-models-v0.0.1-next.31...nft-models-v0.0.1-next.32) (2025-06-24)
+
+
+### Miscellaneous Chores
+
+* **nft-models:** Synchronize repo versions
+
+## [0.0.1-next.31](https://github.com/twinfoundation/nft/compare/nft-models-v0.0.1-next.30...nft-models-v0.0.1-next.31) (2025-06-12)
+
+
+### Features
+
+* update dependencies ([8660f76](https://github.com/twinfoundation/nft/commit/8660f76ca324b0f476e45544cac6bee4b3146c3b))
+
+## [0.0.1-next.30](https://github.com/twinfoundation/nft/compare/nft-models-v0.0.1-next.29...nft-models-v0.0.1-next.30) (2025-05-22)
+
+
+### Miscellaneous Chores
+
+* **nft-models:** Synchronize repo versions
+
+## [0.0.1-next.29](https://github.com/twinfoundation/nft/compare/nft-models-v0.0.1-next.28...nft-models-v0.0.1-next.29) (2025-05-21)
+
+
+### Miscellaneous Chores
+
+* **nft-models:** Synchronize repo versions
+
+## [0.0.1-next.28](https://github.com/twinfoundation/nft/compare/nft-models-v0.0.1-next.27...nft-models-v0.0.1-next.28) (2025-05-06)
+
+
+### Miscellaneous Chores
+
+* **nft-models:** Synchronize repo versions
+
+## [0.0.1-next.27](https://github.com/twinfoundation/nft/compare/nft-models-v0.0.1-next.26...nft-models-v0.0.1-next.27) (2025-04-24)
+
+
+### Miscellaneous Chores
+
+* **nft-models:** Synchronize repo versions
+
+## [0.0.1-next.26](https://github.com/twinfoundation/nft/compare/nft-models-v0.0.1-next.25...nft-models-v0.0.1-next.26) (2025-04-17)
+
+
+### Features
+
+* use shared store mechanism ([#16](https://github.com/twinfoundation/nft/issues/16)) ([897bc78](https://github.com/twinfoundation/nft/commit/897bc7805248ba1388b2dd03df24c33f1633f344))
+
+## [0.0.1-next.25](https://github.com/twinfoundation/nft/compare/nft-models-v0.0.1-next.24...nft-models-v0.0.1-next.25) (2025-04-17)
+
+
+### Miscellaneous Chores
+
+* **nft-models:** Synchronize repo versions
+
+## [0.0.1-next.24](https://github.com/twinfoundation/nft/compare/nft-models-v0.0.1-next.23...nft-models-v0.0.1-next.24) (2025-03-28)
+
+
+### Miscellaneous Chores
+
+* **nft-models:** Synchronize repo versions
+
+## v0.0.1-next.23
 
 - Initial Release

package/docs/reference/interfaces/INftComponent.md

@@ -10,23 +10,21 @@ Interface describing an NFT component.
 
 ### mint()
 
-> **mint**\<`T`, `U`\>(`issuer`, `tag`, `immutableMetadata`?, `metadata`?, `namespace`?, `identity`?): `Promise`\<`string`\>
+> **mint**\<`T`, `U`\>(`tag`, `immutableMetadata?`, `metadata?`, `namespace?`, `identity?`): `Promise`\<`string`\>
 
 Mint an NFT.
 
 #### Type Parameters
 
-• **T** = `unknown`
+##### T
 
-• **U** = `unknown`
+`T` = `unknown`
 
-#### Parameters
-
-##### issuer
+##### U
 
-`string`
+`U` = `unknown`
 
-The issuer for the NFT, will also be the initial owner.
+#### Parameters
 
 ##### tag
 
@@ -68,15 +66,19 @@ The id of the created NFT in urn format.
 
 ### resolve()
 
-> **resolve**\<`T`, `U`\>(`id`, `identity`?): `Promise`\<\{ `issuer`: `string`; `owner`: `string`; `tag`: `string`; `immutableMetadata`: `T`; `metadata`: `U`; \}\>
+> **resolve**\<`T`, `U`\>(`id`, `controllerIdentity?`): `Promise`\<\{ `issuer`: `string`; `owner`: `string`; `tag`: `string`; `immutableMetadata?`: `T`; `metadata?`: `U`; \}\>
 
 Resolve an NFT.
 
 #### Type Parameters
 
-• **T** = `unknown`
+##### T
+
+`T` = `unknown`
 
-• **U** = `unknown`
+##### U
+
+`U` = `unknown`
 
 #### Parameters
 
@@ -86,7 +88,7 @@ Resolve an NFT.
 
 The id of the NFT to resolve.
 
-##### identity?
+##### controllerIdentity?
 
 `string`
 
@@ -94,7 +96,7 @@ The identity to perform the nft operation on.
 
 #### Returns
 
-`Promise`\<\{ `issuer`: `string`; `owner`: `string`; `tag`: `string`; `immutableMetadata`: `T`; `metadata`: `U`; \}\>
+`Promise`\<\{ `issuer`: `string`; `owner`: `string`; `tag`: `string`; `immutableMetadata?`: `T`; `metadata?`: `U`; \}\>
 
 The data for the NFT.
 
@@ -102,7 +104,7 @@ The data for the NFT.
 
 ### burn()
 
-> **burn**(`id`, `identity`?): `Promise`\<`void`\>
+> **burn**(`id`, `controllerIdentity?`): `Promise`\<`void`\>
 
 Burn an NFT.
 
@@ -114,7 +116,7 @@ Burn an NFT.
 
 The id of the NFT to burn in urn format.
 
-##### identity?
+##### controllerIdentity?
 
 `string`
 
@@ -130,13 +132,15 @@ Nothing.
 
 ### transfer()
 
-> **transfer**\<`T`\>(`id`, `recipient`, `metadata`?, `identity`?): `Promise`\<`void`\>
+> **transfer**\<`U`\>(`id`, `recipientIdentity`, `recipientAddress`, `metadata?`, `controllerIdentity?`): `Promise`\<`void`\>
 
 Transfer an NFT.
 
 #### Type Parameters
 
-• **T** = `unknown`
+##### U
+
+`U` = `unknown`
 
 #### Parameters
 
@@ -146,19 +150,25 @@ Transfer an NFT.
 
 The id of the NFT to transfer in urn format.
 
-##### recipient
+##### recipientIdentity
+
+`string`
+
+The recipient identity for the NFT.
+
+##### recipientAddress
 
 `string`
 
-The recipient of the NFT.
+The recipient address for the NFT.
 
 ##### metadata?
 
-`T`
+`U`
 
 Optional mutable data to include during the transfer.
 
-##### identity?
+##### controllerIdentity?
 
 `string`
 
@@ -174,13 +184,15 @@ Nothing.
 
 ### update()
 
-> **update**\<`T`\>(`id`, `metadata`, `identity`?): `Promise`\<`void`\>
+> **update**\<`U`\>(`id`, `metadata`, `controllerIdentity?`): `Promise`\<`void`\>
 
 Update the mutable data of the NFT.
 
 #### Type Parameters
 
-• **T** = `unknown`
+##### U
+
+`U` = `unknown`
 
 #### Parameters
 
@@ -192,11 +204,11 @@ The id of the NFT to update in urn format.
 
 ##### metadata
 
-`T`
+`U`
 
 The mutable data to update.
 
-##### identity?
+##### controllerIdentity?
 
 `string`
 

package/docs/reference/interfaces/INftConnector.md

@@ -10,29 +10,27 @@ Interface describing an NFT connector.
 
 ### mint()
 
-> **mint**\<`T`, `U`\>(`controller`, `issuerAddress`, `tag`, `immutableMetadata`?, `metadata`?): `Promise`\<`string`\>
+> **mint**\<`T`, `U`\>(`controllerIdentity`, `tag`, `immutableMetadata?`, `metadata?`): `Promise`\<`string`\>
 
 Mint an NFT.
 
 #### Type Parameters
 
-• **T** = `unknown`
+##### T
 
-• **U** = `unknown`
+`T` = `unknown`
 
-#### Parameters
-
-##### controller
+##### U
 
-`string`
+`U` = `unknown`
 
-The identity of the user to access the vault keys.
+#### Parameters
 
-##### issuerAddress
+##### controllerIdentity
 
 `string`
 
-The issuer for the NFT, will also be the initial owner.
+The identity of the user to access the vault keys.
 
 ##### tag
 
@@ -62,15 +60,19 @@ The id of the created NFT in urn format.
 
 ### resolve()
 
-> **resolve**\<`T`, `U`\>(`id`): `Promise`\<\{ `issuer`: `string`; `owner`: `string`; `tag`: `string`; `immutableMetadata`: `T`; `metadata`: `U`; \}\>
+> **resolve**\<`T`, `U`\>(`id`): `Promise`\<\{ `issuer`: `string`; `owner`: `string`; `tag`: `string`; `immutableMetadata?`: `T`; `metadata?`: `U`; \}\>
 
 Resolve an NFT.
 
 #### Type Parameters
 
-• **T** = `unknown`
+##### T
+
+`T` = `unknown`
+
+##### U
 
-• **U** = `unknown`
+`U` = `unknown`
 
 #### Parameters
 
@@ -82,7 +84,7 @@ The id of the NFT to resolve.
 
 #### Returns
 
-`Promise`\<\{ `issuer`: `string`; `owner`: `string`; `tag`: `string`; `immutableMetadata`: `T`; `metadata`: `U`; \}\>
+`Promise`\<\{ `issuer`: `string`; `owner`: `string`; `tag`: `string`; `immutableMetadata?`: `T`; `metadata?`: `U`; \}\>
 
 The data for the NFT.
 
@@ -118,17 +120,19 @@ Nothing.
 
 ### transfer()
 
-> **transfer**\<`T`\>(`controller`, `id`, `recipient`, `metadata`?): `Promise`\<`void`\>
+> **transfer**\<`U`\>(`controllerIdentity`, `id`, `recipientIdentity`, `recipientAddress`, `metadata?`): `Promise`\<`void`\>
 
 Transfer an NFT.
 
 #### Type Parameters
 
-• **T** = `unknown`
+##### U
+
+`U` = `unknown`
 
 #### Parameters
 
-##### controller
+##### controllerIdentity
 
 `string`
 
@@ -140,15 +144,21 @@ The controller of the NFT who can make changes.
 
 The id of the NFT to transfer in urn format.
 
-##### recipient
+##### recipientIdentity
 
 `string`
 
-The recipient of the NFT.
+The recipient identity for the NFT.
+
+##### recipientAddress
+
+`string`
+
+The recipient address for the NFT.
 
 ##### metadata?
 
-`T`
+`U`
 
 Optional mutable data to include during the transfer.
 
@@ -162,17 +172,19 @@ Nothing.
 
 ### update()
 
-> **update**\<`T`\>(`controller`, `id`, `metadata`): `Promise`\<`void`\>
+> **update**\<`U`\>(`controllerIdentity`, `id`, `metadata`): `Promise`\<`void`\>
 
 Update the mutable data of the NFT.
 
 #### Type Parameters
 
-• **T** = `unknown`
+##### U
+
+`U` = `unknown`
 
 #### Parameters
 
-##### controller
+##### controllerIdentity
 
 `string`
 
@@ -186,7 +198,7 @@ The id of the NFT to update in urn format.
 
 ##### metadata
 
-`T`
+`U`
 
 The mutable data to update.
 

package/docs/reference/interfaces/INftMintRequest.md

@@ -10,12 +10,6 @@ Mint the data and return the NFT id.
 
 The data to be used in the minting.
 
-#### issuer
-
-> **issuer**: `string`
-
-The issuer for the NFT, will also be the initial owner.
-
 #### tag
 
 > **tag**: `string`

package/docs/reference/interfaces/INftTransferRequest.md

@@ -24,11 +24,17 @@ The id of the NFT to transfer in urn format.
 
 The data to be used in the transfer.
 
-#### recipient
+#### recipientIdentity
 
-> **recipient**: `string`
+> **recipientIdentity**: `string`
 
-The recipient for the NFT.
+The recipient identity for the NFT.
+
+#### recipientAddress
+
+> **recipientAddress**: `string`
+
+The recipient address for the NFT.
 
 #### metadata?
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/nft-models",
-	"version": "0.0.1-next.9",
+	"version": "0.0.2-next.1",
 	"description": "Contains models and classes for use with NFTs",
 	"repository": {
 		"type": "git",
@@ -23,9 +23,9 @@
 	"types": "./dist/types/index.d.ts",
 	"exports": {
 		".": {
+			"types": "./dist/types/index.d.ts",
 			"require": "./dist/cjs/index.cjs",
-			"import": "./dist/esm/index.mjs",
-			"types": "./dist/types/index.d.ts"
+			"import": "./dist/esm/index.mjs"
 		}
 	},
 	"files": [