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

package/dist/cjs/index.cjs

@@ -25,9 +25,9 @@ const SyncChangeOperation = {
 // eslint-disable-next-line @typescript-eslint/naming-convention
 const SynchronisedStorageTopics = {
     /**
-     * Register a schema type for the synchronised storage.
+     * Register a storage key for the synchronised storage.
      */
-    RegisterSchemaType: "synchronised-storage:register-schema-type",
+    RegisterStorageKey: "synchronised-storage:register-storage-key",
     /**
      * An item was changed in the storage by the local node.
      */

package/dist/esm/index.mjs

@@ -23,9 +23,9 @@ const SyncChangeOperation = {
 // eslint-disable-next-line @typescript-eslint/naming-convention
 const SynchronisedStorageTopics = {
     /**
-     * Register a schema type for the synchronised storage.
+     * Register a storage key for the synchronised storage.
      */
-    RegisterSchemaType: "synchronised-storage:register-schema-type",
+    RegisterStorageKey: "synchronised-storage:register-storage-key",
     /**
      * An item was changed in the storage by the local node.
      */

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";
@@ -6,8 +8,10 @@ export * from "./models/eventBus/ISyncItemRemove";
 export * from "./models/eventBus/ISyncItemRequest";
 export * from "./models/eventBus/ISyncItemResponse";
 export * from "./models/eventBus/ISyncItemSet";
-export * from "./models/eventBus/ISyncRegisterSchemaType";
+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/ISyncBatchRequest.d.ts

@@ -3,9 +3,9 @@
  */
 export interface ISyncBatchRequest {
     /**
-     * The type of the schema for the entities in the batch.
+     * The key of the storage for the entities in the batch.
      */
-    schemaType: string;
+    storageKey: string;
     /**
      * The size of the batch.
      */

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

@@ -4,13 +4,9 @@ import type { ISynchronisedEntity } from "../ISynchronisedEntity";
  */
 export interface ISyncBatchResponse<T extends ISynchronisedEntity> {
     /**
-     * The type of the schema for the entities in the batch.
+     * The key of the storage for the entities in the batch.
      */
-    schemaType: string;
-    /**
-     * The primary key of the entity in the sync item response.
-     */
-    primaryKey: keyof T;
+    storageKey: string;
     /**
      * The entities in the batch.
      */

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

@@ -4,9 +4,9 @@ import type { SyncChangeOperation } from "./syncChangeOperation";
  */
 export interface ISyncItemChange {
     /**
-     * The type of the schema being changed.
+     * The key of the storage being changed.
      */
-    schemaType: string;
+    storageKey: string;
     /**
      * The operation being performed on the item.
      */

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

@@ -3,9 +3,9 @@
  */
 export interface ISyncItemRemove {
     /**
-     * The type of the schema being removed.
+     * The key of the storage being removed.
      */
-    schemaType: string;
+    storageKey: string;
     /**
      * The entity being removed from the item set.
      */

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

@@ -3,9 +3,9 @@
  */
 export interface ISyncItemRequest {
     /**
-     * The type of the schema for the entities in the batch.
+     * The key of the storage for the entities in the batch.
      */
-    schemaType: string;
+    storageKey: string;
     /**
      * The item id being requested.
      */

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

@@ -4,9 +4,9 @@ import type { ISynchronisedEntity } from "../ISynchronisedEntity";
  */
 export interface ISyncItemResponse<T extends ISynchronisedEntity> {
     /**
-     * The type of the schema for the entities in the batch.
+     * The key of the storage for the entities in the batch.
      */
-    schemaType: string;
+    storageKey: string;
     /**
      * The id of the entity in the sync item response.
      */

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

@@ -4,9 +4,9 @@ import type { ISynchronisedEntity } from "../ISynchronisedEntity";
  */
 export interface ISyncItemSet<T extends ISynchronisedEntity = ISynchronisedEntity> {
     /**
-     * The type of the schema being set.
+     * The key of the storage being set.
      */
-    schemaType: string;
+    storageKey: string;
     /**
      * The entity being set in the item set.
      */

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

@@ -0,0 +1,9 @@
+/**
+ * Register a key with synchronised storage.
+ */
+export interface ISyncRegisterStorageKey {
+    /**
+     * The key for the storage being registered.
+     */
+    storageKey: string;
+}

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

@@ -3,9 +3,9 @@
  */
 export declare const SynchronisedStorageTopics: {
     /**
-     * Register a schema type for the synchronised storage.
+     * Register a storage key for the synchronised storage.
      */
-    readonly RegisterSchemaType: "synchronised-storage:register-schema-type";
+    readonly RegisterStorageKey: "synchronised-storage:register-storage-key";
     /**
      * An item was changed in the storage by the local node.
      */

package/docs/changelog.md

@@ -1,5 +1,19 @@
 # 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)
+
+
+### Features
+
+* sync testing ([#5](https://github.com/twinfoundation/synchronised-storage/issues/5)) ([f78d5ac](https://github.com/twinfoundation/synchronised-storage/commit/f78d5ac661b891f9912e0a81d028453f909a64b4))
+
 ## [0.0.1-next.2](https://github.com/twinfoundation/synchronised-storage/compare/synchronised-storage-models-v0.0.1-next.1...synchronised-storage-models-v0.0.1-next.2) (2025-07-22)
 
 

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)
@@ -12,7 +16,7 @@
 - [ISyncItemRequest](interfaces/ISyncItemRequest.md)
 - [ISyncItemResponse](interfaces/ISyncItemResponse.md)
 - [ISyncItemSet](interfaces/ISyncItemSet.md)
-- [ISyncRegisterSchemaType](interfaces/ISyncRegisterSchemaType.md)
+- [ISyncRegisterStorageKey](interfaces/ISyncRegisterStorageKey.md)
 
 ## Type Aliases
 

package/docs/reference/interfaces/ISyncBatchRequest.md

@@ -4,11 +4,11 @@ Request for a local batch.
 
 ## Properties
 
-### schemaType
+### storageKey
 
-> **schemaType**: `string`
+> **storageKey**: `string`
 
-The type of the schema for the entities in the batch.
+The key of the storage for the entities in the batch.
 
 ***
 

package/docs/reference/interfaces/ISyncBatchResponse.md

@@ -10,19 +10,11 @@ Response for a local batch.
 
 ## Properties
 
-### schemaType
+### storageKey
 
-> **schemaType**: `string`
+> **storageKey**: `string`
 
-The type of the schema for the entities in the batch.
-
-***
-
-### primaryKey
-
-> **primaryKey**: keyof `T`
-
-The primary key of the entity in the sync item response.
+The key of the storage for the entities in the batch.
 
 ***
 

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/ISyncItemChange.md

@@ -4,11 +4,11 @@ The payload for an item change.
 
 ## Properties
 
-### schemaType
+### storageKey
 
-> **schemaType**: `string`
+> **storageKey**: `string`
 
-The type of the schema being changed.
+The key of the storage being changed.
 
 ***
 

package/docs/reference/interfaces/ISyncItemRemove.md

@@ -4,11 +4,11 @@ The payload for an item remove.
 
 ## Properties
 
-### schemaType
+### storageKey
 
-> **schemaType**: `string`
+> **storageKey**: `string`
 
-The type of the schema being removed.
+The key of the storage being removed.
 
 ***
 

package/docs/reference/interfaces/ISyncItemRequest.md

@@ -4,11 +4,11 @@ Request for a local item.
 
 ## Properties
 
-### schemaType
+### storageKey
 
-> **schemaType**: `string`
+> **storageKey**: `string`
 
-The type of the schema for the entities in the batch.
+The key of the storage for the entities in the batch.
 
 ***
 

package/docs/reference/interfaces/ISyncItemResponse.md

@@ -10,11 +10,11 @@ Response for a sync item request.
 
 ## Properties
 
-### schemaType
+### storageKey
 
-> **schemaType**: `string`
+> **storageKey**: `string`
 
-The type of the schema for the entities in the batch.
+The key of the storage for the entities in the batch.
 
 ***
 

package/docs/reference/interfaces/ISyncItemSet.md

@@ -10,11 +10,11 @@ The payload for an item set.
 
 ## Properties
 
-### schemaType
+### storageKey
 
-> **schemaType**: `string`
+> **storageKey**: `string`
 
-The type of the schema being set.
+The key of the storage being set.
 
 ***
 

package/docs/reference/interfaces/ISyncRegisterStorageKey.md

@@ -0,0 +1,11 @@
+# Interface: ISyncRegisterStorageKey
+
+Register a key with synchronised storage.
+
+## Properties
+
+### storageKey
+
+> **storageKey**: `string`
+
+The key for the storage being registered.

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/docs/reference/variables/SynchronisedStorageTopics.md

@@ -6,11 +6,11 @@ The topics for synchronised storage event bus notifications.
 
 ## Type declaration
 
-### RegisterSchemaType
+### RegisterStorageKey
 
-> `readonly` **RegisterSchemaType**: `"synchronised-storage:register-schema-type"` = `"synchronised-storage:register-schema-type"`
+> `readonly` **RegisterStorageKey**: `"synchronised-storage:register-storage-key"` = `"synchronised-storage:register-storage-key"`
 
-Register a schema type for the synchronised storage.
+Register a storage key for the synchronised storage.
 
 ### LocalItemChange
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/synchronised-storage-models",
-	"version": "0.0.1-next.2",
+	"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",

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

@@ -1,9 +0,0 @@
-/**
- * Register a type with synchronised storage so that it can perform consolidations.
- */
-export interface ISyncRegisterSchemaType {
-    /**
-     * The type of the schema being registered.
-     */
-    schemaType: string;
-}

package/docs/reference/interfaces/ISyncRegisterSchemaType.md

@@ -1,11 +0,0 @@
-# Interface: ISyncRegisterSchemaType
-
-Register a type with synchronised storage so that it can perform consolidations.
-
-## Properties
-
-### schemaType
-
-> **schemaType**: `string`
-
-The type of the schema being registered.