@twin.org/synchronised-storage-models 0.0.1-next.3 → 0.0.1-next.4

package/dist/types/index.d.ts

@@ -1,4 +1,6 @@
 export * from "./models/api/ISyncChangeSetRequest";
+export * from "./models/api/ISyncDecryptionKeyRequest";
+export * from "./models/api/ISyncDecryptionKeyResponse";
 export * from "./models/eventBus/ISyncBatchRequest";
 export * from "./models/eventBus/ISyncBatchResponse";
 export * from "./models/eventBus/ISyncItemChange";
@@ -8,6 +10,8 @@ export * from "./models/eventBus/ISyncItemResponse";
 export * from "./models/eventBus/ISyncItemSet";
 export * from "./models/eventBus/ISyncRegisterStorageKey";
 export * from "./models/eventBus/syncChangeOperation";
+export * from "./models/ISyncChange";
+export * from "./models/ISyncChangeSet";
 export * from "./models/ISynchronisedEntity";
 export * from "./models/ISynchronisedStorageComponent";
 export * from "./models/synchronisedStorageTopics";

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

@@ -0,0 +1,19 @@
+import type { SyncChangeOperation } from "./eventBus/syncChangeOperation";
+import type { ISynchronisedEntity } from "./ISynchronisedEntity";
+/**
+ * The object definition for a sync change.
+ */
+export interface ISyncChange<T extends ISynchronisedEntity = ISynchronisedEntity> {
+    /**
+     * Operation.
+     */
+    operation: SyncChangeOperation;
+    /**
+     * The item id.
+     */
+    id: string;
+    /**
+     * The entity to set.
+     */
+    entity?: Omit<T, "id" | "nodeIdentity">;
+}

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

@@ -0,0 +1,36 @@
+import type { IProof } from "@twin.org/standards-w3c-did";
+import type { ISyncChange } from "./ISyncChange";
+import type { ISynchronisedEntity } from "./ISynchronisedEntity";
+/**
+ * The object definition for a sync change set.
+ */
+export interface ISyncChangeSet<T extends ISynchronisedEntity = ISynchronisedEntity> {
+    /**
+     * The id of the change set.
+     */
+    id: string;
+    /**
+     * The date the change set was created.
+     */
+    dateCreated: string;
+    /**
+     * The storage key of the change set. This is used to identify the entities being synchronised.
+     */
+    storageKey: string;
+    /**
+     * The date the change set was last modified.
+     */
+    dateModified?: string;
+    /**
+     * The changes to apply after a snapshot.
+     */
+    changes: ISyncChange<T>[];
+    /**
+     * The identity of the node that created the change set.
+     */
+    nodeIdentity: string;
+    /**
+     * The proof for the change set.
+     */
+    proof?: IProof;
+}

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

@@ -2,6 +2,10 @@
  * The base definition for synchronised entries.
  */
 export interface ISynchronisedEntity {
+    /**
+     * The id of the entry.
+     */
+    id: string;
     /**
      * The date the entry was modified
      */

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

@@ -1,12 +1,22 @@
 import type { IComponent } from "@twin.org/core";
+import type { IProof } from "@twin.org/standards-w3c-did";
+import type { ISyncChangeSet } from "./ISyncChangeSet";
 /**
  * Class for performing synchronised storage operations.
  */
 export interface ISynchronisedStorageComponent extends IComponent {
     /**
-     * Synchronise a complete set of changes, assumes this is a trusted node.
-     * @param changeSetStorageId The id of the change set to synchronise in blob storage.
+     * Get the decryption key for the synchronised storage.
+     * This is used to decrypt the data stored in the synchronised storage.
+     * @param nodeIdentity The identity of the node requesting the decryption key.
+     * @param proof The proof of the request so we know the request is from the specified node.
+     * @returns The decryption key.
+     */
+    getDecryptionKey(nodeIdentity: string, proof: IProof): Promise<string>;
+    /**
+     * Synchronise a set of changes from an untrusted node, assumes this is a trusted node.
+     * @param syncChangeSet The change set to synchronise.
      * @returns Nothing.
      */
-    syncChangeSet(changeSetStorageId: string): Promise<void>;
+    syncChangeSet(syncChangeSet: ISyncChangeSet): Promise<void>;
 }

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

@@ -1,14 +1,10 @@
+import type { ISyncChangeSet } from "../ISyncChangeSet";
 /**
  * Request a trusted node to perform a sync request for a changeset.
  */
 export interface ISyncChangeSetRequest {
     /**
-     * The query parameters.
+     * The body of the request.
      */
-    query: {
-        /**
-         * The storage id of the changeset.
-         */
-        changeSetStorageId: string;
-    };
+    body: ISyncChangeSet;
 }

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

@@ -0,0 +1,19 @@
+import type { IProof } from "@twin.org/standards-w3c-did";
+/**
+ * Request for the decryption key for the synchronised storage.
+ */
+export interface ISyncDecryptionKeyRequest {
+    /**
+     * The body of the request.
+     */
+    body: {
+        /**
+         * The identity of the node making the request.
+         */
+        nodeIdentity: string;
+        /**
+         * The proof of the request.
+         */
+        proof: IProof;
+    };
+}

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

@@ -0,0 +1,14 @@
+/**
+ * Response to a request for the decryption key for the synchronised storage.
+ */
+export interface ISyncDecryptionKeyResponse {
+    /**
+     * The body of the response.
+     */
+    body: {
+        /**
+         * The decryption key for the synchronised storage as base64.
+         */
+        decryptionKey: string;
+    };
+}

package/dist/types/models/eventBus/ISyncBatchResponse.d.ts

@@ -7,10 +7,6 @@ export interface ISyncBatchResponse<T extends ISynchronisedEntity> {
      * The key of the storage for the entities in the batch.
      */
     storageKey: string;
-    /**
-     * The primary key of the entity in the sync item response.
-     */
-    primaryKey: keyof T;
     /**
      * The entities in the batch.
      */

package/docs/changelog.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.0.1-next.4](https://github.com/twinfoundation/synchronised-storage/compare/synchronised-storage-models-v0.0.1-next.3...synchronised-storage-models-v0.0.1-next.4) (2025-08-08)
+
+
+### Features
+
+* blob storage connector instead of component ([#7](https://github.com/twinfoundation/synchronised-storage/issues/7)) ([ea27241](https://github.com/twinfoundation/synchronised-storage/commit/ea27241cf0810b52ab7a6be7346809d127b7109a))
+
 ## [0.0.1-next.3](https://github.com/twinfoundation/synchronised-storage/compare/synchronised-storage-models-v0.0.1-next.2...synchronised-storage-models-v0.0.1-next.3) (2025-07-25)
 
 

package/docs/reference/index.md

@@ -2,9 +2,13 @@
 
 ## Interfaces
 
+- [ISyncChange](interfaces/ISyncChange.md)
+- [ISyncChangeSet](interfaces/ISyncChangeSet.md)
 - [ISynchronisedEntity](interfaces/ISynchronisedEntity.md)
 - [ISynchronisedStorageComponent](interfaces/ISynchronisedStorageComponent.md)
 - [ISyncChangeSetRequest](interfaces/ISyncChangeSetRequest.md)
+- [ISyncDecryptionKeyRequest](interfaces/ISyncDecryptionKeyRequest.md)
+- [ISyncDecryptionKeyResponse](interfaces/ISyncDecryptionKeyResponse.md)
 - [ISyncBatchRequest](interfaces/ISyncBatchRequest.md)
 - [ISyncBatchResponse](interfaces/ISyncBatchResponse.md)
 - [ISyncItemChange](interfaces/ISyncItemChange.md)

package/docs/reference/interfaces/ISyncBatchResponse.md

@@ -18,14 +18,6 @@ The key of the storage for the entities in the batch.
 
 ***
 
-### primaryKey
-
-> **primaryKey**: keyof `T`
-
-The primary key of the entity in the sync item response.
-
-***
-
 ### entities
 
 > **entities**: `T`[]

package/docs/reference/interfaces/ISyncChange.md

@@ -0,0 +1,33 @@
+# Interface: ISyncChange\<T\>
+
+The object definition for a sync change.
+
+## Type Parameters
+
+### T
+
+`T` *extends* [`ISynchronisedEntity`](ISynchronisedEntity.md) = [`ISynchronisedEntity`](ISynchronisedEntity.md)
+
+## Properties
+
+### operation
+
+> **operation**: [`SyncChangeOperation`](../type-aliases/SyncChangeOperation.md)
+
+Operation.
+
+***
+
+### id
+
+> **id**: `string`
+
+The item id.
+
+***
+
+### entity?
+
+> `optional` **entity**: `Omit`\<`T`, `"id"` \| `"nodeIdentity"`\>
+
+The entity to set.

package/docs/reference/interfaces/ISyncChangeSet.md

@@ -0,0 +1,65 @@
+# Interface: ISyncChangeSet\<T\>
+
+The object definition for a sync change set.
+
+## Type Parameters
+
+### T
+
+`T` *extends* [`ISynchronisedEntity`](ISynchronisedEntity.md) = [`ISynchronisedEntity`](ISynchronisedEntity.md)
+
+## Properties
+
+### id
+
+> **id**: `string`
+
+The id of the change set.
+
+***
+
+### dateCreated
+
+> **dateCreated**: `string`
+
+The date the change set was created.
+
+***
+
+### storageKey
+
+> **storageKey**: `string`
+
+The storage key of the change set. This is used to identify the entities being synchronised.
+
+***
+
+### dateModified?
+
+> `optional` **dateModified**: `string`
+
+The date the change set was last modified.
+
+***
+
+### changes
+
+> **changes**: [`ISyncChange`](ISyncChange.md)\<`T`\>[]
+
+The changes to apply after a snapshot.
+
+***
+
+### nodeIdentity
+
+> **nodeIdentity**: `string`
+
+The identity of the node that created the change set.
+
+***
+
+### proof?
+
+> `optional` **proof**: `IProof`
+
+The proof for the change set.

package/docs/reference/interfaces/ISyncChangeSetRequest.md

@@ -4,14 +4,8 @@ Request a trusted node to perform a sync request for a changeset.
 
 ## Properties
 
-### query
+### body
 
-> **query**: `object`
+> **body**: [`ISyncChangeSet`](ISyncChangeSet.md)
 
-The query parameters.
-
-#### changeSetStorageId
-
-> **changeSetStorageId**: `string`
-
-The storage id of the changeset.
+The body of the request.

package/docs/reference/interfaces/ISyncDecryptionKeyRequest.md

@@ -0,0 +1,23 @@
+# Interface: ISyncDecryptionKeyRequest
+
+Request for the decryption key for the synchronised storage.
+
+## Properties
+
+### body
+
+> **body**: `object`
+
+The body of the request.
+
+#### nodeIdentity
+
+> **nodeIdentity**: `string`
+
+The identity of the node making the request.
+
+#### proof
+
+> **proof**: `IProof`
+
+The proof of the request.

package/docs/reference/interfaces/ISyncDecryptionKeyResponse.md

@@ -0,0 +1,17 @@
+# Interface: ISyncDecryptionKeyResponse
+
+Response to a request for the decryption key for the synchronised storage.
+
+## Properties
+
+### body
+
+> **body**: `object`
+
+The body of the response.
+
+#### decryptionKey
+
+> **decryptionKey**: `string`
+
+The decryption key for the synchronised storage as base64.

package/docs/reference/interfaces/ISynchronisedEntity.md

@@ -4,6 +4,14 @@ The base definition for synchronised entries.
 
 ## Properties
 
+### id
+
+> **id**: `string`
+
+The id of the entry.
+
+***
+
 ### dateModified
 
 > **dateModified**: `string`

package/docs/reference/interfaces/ISynchronisedStorageComponent.md

@@ -8,19 +8,48 @@ Class for performing synchronised storage operations.
 
 ## Methods
 
-### syncChangeSet()
+### getDecryptionKey()
 
-> **syncChangeSet**(`changeSetStorageId`): `Promise`\<`void`\>
+> **getDecryptionKey**(`nodeIdentity`, `proof`): `Promise`\<`string`\>
 
-Synchronise a complete set of changes, assumes this is a trusted node.
+Get the decryption key for the synchronised storage.
+This is used to decrypt the data stored in the synchronised storage.
 
 #### Parameters
 
-##### changeSetStorageId
+##### nodeIdentity
 
 `string`
 
-The id of the change set to synchronise in blob storage.
+The identity of the node requesting the decryption key.
+
+##### proof
+
+`IProof`
+
+The proof of the request so we know the request is from the specified node.
+
+#### Returns
+
+`Promise`\<`string`\>
+
+The decryption key.
+
+***
+
+### syncChangeSet()
+
+> **syncChangeSet**(`syncChangeSet`): `Promise`\<`void`\>
+
+Synchronise a set of changes from an untrusted node, assumes this is a trusted node.
+
+#### Parameters
+
+##### syncChangeSet
+
+[`ISyncChangeSet`](ISyncChangeSet.md)
+
+The change set to synchronise.
 
 #### Returns
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/synchronised-storage-models",
-	"version": "0.0.1-next.3",
+	"version": "0.0.1-next.4",
 	"description": "Models which define the structure of the synchronised storage connectors and services",
 	"repository": {
 		"type": "git",
@@ -16,7 +16,8 @@
 	"dependencies": {
 		"@twin.org/core": "next",
 		"@twin.org/entity": "next",
-		"@twin.org/nameof": "next"
+		"@twin.org/nameof": "next",
+		"@twin.org/standards-w3c-did": "next"
 	},
 	"main": "./dist/cjs/index.cjs",
 	"module": "./dist/esm/index.mjs",