@serve.zone/interfaces 29.0.0 → 30.0.0

package/changelog.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 2026-09-09 - 30.0.0
+
+### Breaking Changes
+
+- align image transfer contracts with directional virtual streams (requests/image)
+  - Change push image upload streams to requester send endpoints and pull image download streams to requester receive endpoints.
+  - Bump @api.global/typedrequest-interfaces to ^7.1.0 for directional VirtualStream support.
+  - Document TypedRequest stream direction semantics and add compile-time type assertions for stream chunk types.
+
 ## 2026-09-09 - 29.0.0
 
 ### Breaking Changes

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@serve.zone/interfaces',
-    version: '29.0.0',
+    version: '30.0.0',
     description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx3QkFBd0I7SUFDOUIsT0FBTyxFQUFFLFFBQVE7SUFDakIsV0FBVyxFQUFFLHVGQUF1RjtDQUNyRyxDQUFBIn0=

package/dist_ts/requests/image.d.ts

@@ -41,7 +41,8 @@ export interface IRequest_PushImageVersion extends plugins.typedrequestInterface
         identity: userInterfaces.IIdentity;
         imageId: string;
         versionString: string;
-        imageStream: plugins.typedrequestInterfaces.IVirtualStream;
+        /** Requester sends archive bytes; TypedHandler receives the opposite endpoint. */
+        imageStream: plugins.typedrequestInterfaces.TVirtualStream<'send'>;
     };
     response: {
         allowed: boolean;
@@ -55,7 +56,8 @@ export interface IRequest_PullImageVersion extends plugins.typedrequestInterface
         versionString: string;
     };
     response: {
-        imageStream: plugins.typedrequestInterfaces.IVirtualStream;
+        /** Requester receives archive bytes; TypedHandler returns a sender endpoint. */
+        imageStream: plugins.typedrequestInterfaces.TVirtualStream<'receive'>;
     };
 }
 export interface IRequest_DeleteImage extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IRequest_DeleteImage> {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serve.zone/interfaces",
-  "version": "29.0.0",
+  "version": "30.0.0",
   "private": false,
   "description": "Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.",
   "exports": {
@@ -21,7 +21,7 @@
   "author": "Task Venture Capital GmbH",
   "license": "MIT",
   "dependencies": {
-    "@api.global/typedrequest-interfaces": "^4.0.0",
+    "@api.global/typedrequest-interfaces": "^7.1.0",
     "@push.rocks/smartcrypto": "^2.2.0",
     "@push.rocks/smartlog-interfaces": "^3.0.2",
     "@tsclass/tsclass": "^9.5.1"

package/readme.md

@@ -47,6 +47,30 @@ validator; unlike `@serve.zone/interfaces/runtime`, it does not load the general
 runtime graph, `plugins.js`, SmartCrypto, TypedRequest, Corestore, or settlement
 runtime modules.
 
+### Directional Image Streams
+
+Image transfer contracts use `@api.global/typedrequest-interfaces` 7.1.0 and the
+directional VirtualStream protocol used by TypedRequest 8 and TypedSocket 8.
+Directions in shared DTOs describe the requesting peer:
+
+| Contract field | Requester endpoint | TypedHandler endpoint |
+| --- | --- | --- |
+| `requests.image.IRequest_PushImageVersion.request.imageStream` | `TVirtualStream<'send'>` | `TVirtualStream<'receive'>` |
+| `requests.image.IRequest_PullImageVersion.response.imageStream` | `TVirtualStream<'receive'>` | `TVirtualStream<'send'>` |
+
+The method names remain `pushImageVersion` and `pullImageVersion`. Each stream
+carries ordered `Uint8Array` chunks. TypedRequest reverses stream directions for
+the handler automatically; do not reverse the shared declaration yourself.
+
+Consumers must replace the removed undirected `IVirtualStream` API with explicit
+transport-created endpoints. Senders use `send()` or `writable`, then close;
+receivers use `receive()` or `readable`, then explicitly `accept()` after draining
+EOF and completing application storage or delivery. `completion` confirms the
+receiver's accepted receipt, while `closed` confirms transport cleanup. The
+upload response's `allowed` flag permits sending; it does not confirm storage.
+Receiver rejection, aborts and failed completion must reach the caller. Existing
+deployment log and shell push-message contracts retain their message shapes.
+
 ### Human Credential Administration
 
 `requests.admin.getHumanCredential` and `mutateHumanCredential` describe human

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@serve.zone/interfaces',
-  version: '29.0.0',
+  version: '30.0.0',
   description: 'Shared TypeScript interfaces and TypedRequest contracts for the serve.zone ecosystem.'
 }

package/ts/requests/image.ts

@@ -59,7 +59,8 @@ export interface IRequest_PushImageVersion extends plugins.typedrequestInterface
     identity: userInterfaces.IIdentity;
     imageId: string;
     versionString: string;
-    imageStream: plugins.typedrequestInterfaces.IVirtualStream;
+    /** Requester sends archive bytes; TypedHandler receives the opposite endpoint. */
+    imageStream: plugins.typedrequestInterfaces.TVirtualStream<'send'>;
   };
   response: {
     allowed: boolean;
@@ -77,7 +78,8 @@ export interface IRequest_PullImageVersion extends plugins.typedrequestInterface
     versionString: string;
   };
   response: {
-    imageStream: plugins.typedrequestInterfaces.IVirtualStream;
+    /** Requester receives archive bytes; TypedHandler returns a sender endpoint. */
+    imageStream: plugins.typedrequestInterfaces.TVirtualStream<'receive'>;
   };
 }