@claudian-collab/protocol 2.0.0 → 3.1.0

package/README.md

@@ -62,18 +62,24 @@ part of the public surface.
 
 Package SemVer, canonical wire version, and Cloud binding version are independent concepts.
 
-- **Package version** (this `package.json`): `2.0.0`. Patch releases preserve
+- **Package version** (this `package.json`): `3.1.0`. Patch releases preserve
   every existing public declaration and runtime behavior baseline. Minor
   releases may add backward-compatible API. Removing or changing an existing
   declaration, export, runtime behavior, codec, error, limit, ref rule,
-  operation, or compatibility rule requires a major release. The package
-  version never signals wire compatibility by itself.
-- **Wire version** (`COLLAB_PROTOCOL_VERSION`): currently `5`. The supported
-  range is exactly `[5, 5]`. This is independent from Cloud binding version `2` and the existing application
-  LAN control version `9`. Any change to an envelope, DTO, or operation
-  payload shape, or to the operation inventory, is wire-breaking and requires
-  a new wire-protocol version.
-- **Cloud binding version** (`COLLAB_CLOUD_BINDING_VERSION`): currently `2`. It versions Cloud routes, bounded transfer streams, and capabilities independently from package and wire versions. Binding v1 and wire v4 are unsupported rather than translated or dual-interpreted.
+  operation, or compatibility rule requires a major release. An independently
+  proven additive control operation may use a package minor release without a
+  wire-version increase; existing operation declarations and fixtures must stay
+  exact. Package 3 and wire 6 support exact transfer-claim batches and a
+  source-pinned target receipt verifier. The package version never signals wire
+  compatibility by itself.
+- **Wire version** (`COLLAB_PROTOCOL_VERSION`): currently `6`. The supported
+  range is exactly `[6, 6]`. This is independent from Cloud binding version `2` and the existing application
+  LAN control version `9`. Any change to an existing envelope, DTO, operation
+  payload shape, or operation definition is wire-breaking and requires a new
+  wire-protocol version. A strictly additive operation may remain on the
+  current wire version when the compatibility classifier proves that every
+  existing operation contract is unchanged.
+- **Cloud binding version** (`COLLAB_CLOUD_BINDING_VERSION`): currently `2`. It versions Cloud routes, bounded transfer streams, and capabilities independently from package and wire versions. Binding v1 and wire versions before v6 are unsupported rather than translated or dual-interpreted.
 
 ### Compatibility behavior
 

package/dist/CollabAuthorityTransfer.d.ts

@@ -141,6 +141,15 @@ export interface GetProjectAuthorityTransferRequest {
     readonly projectId: CollabProjectId;
     readonly transferId: string;
 }
+export type GetAuthorityTransferReceiptVerifierRequest = GetProjectAuthorityTransferRequest;
+export interface CollabAuthorityTransferReceiptVerifier {
+    readonly projectId: CollabProjectId;
+    readonly receiptKeyId: string;
+    readonly receiptPublicKey: string;
+    readonly receiptPublicKeyEncoding: 'base64url-raw';
+    readonly signatureAlgorithm: 'ed25519';
+    readonly transferId: string;
+}
 export interface RotateTransferredMembershipClaimsRequest extends CollabAuthorityMutationRequest {
     readonly expectedBatchRevision: number;
     readonly expectedBatchSha256: string;
@@ -209,7 +218,7 @@ export interface CancelProjectAuthorityTransferRequest extends CollabAuthorityMu
     readonly expectedPhase: CollabAuthorityTransferCancellablePhase;
     readonly transferId: string;
 }
-export declare const COLLAB_AUTHORITY_TRANSFER_OPERATIONS: readonly ["requestLanToCloudTransfer", "acceptLanToCloudTransferTarget", "beginLanToCloudTransfer", "getProjectAuthorityTransfer", "rotateTransferredMembershipClaims", "acknowledgeTransferredMembershipClaimBatch", "getTransferredMembershipClaim", "claimTransferredMembership", "acknowledgeTransferredMembershipClaimRedemption", "commitLanToCloudRelinquishment", "beginCloudToLanTransfer", "acceptCloudToLanTransferTarget", "reportCloudToLanTargetStaged", "confirmCloudToLanTargetActive", "cancelProjectAuthorityTransfer"];
+export declare const COLLAB_AUTHORITY_TRANSFER_OPERATIONS: readonly ["requestLanToCloudTransfer", "acceptLanToCloudTransferTarget", "beginLanToCloudTransfer", "getProjectAuthorityTransfer", "getAuthorityTransferReceiptVerifier", "rotateTransferredMembershipClaims", "acknowledgeTransferredMembershipClaimBatch", "getTransferredMembershipClaim", "claimTransferredMembership", "acknowledgeTransferredMembershipClaimRedemption", "commitLanToCloudRelinquishment", "beginCloudToLanTransfer", "acceptCloudToLanTransferTarget", "reportCloudToLanTargetStaged", "confirmCloudToLanTargetActive", "cancelProjectAuthorityTransfer"];
 export type CollabAuthorityTransferOperation = typeof COLLAB_AUTHORITY_TRANSFER_OPERATIONS[number];
 export interface CollabAuthorityTransferOperationMap {
     readonly requestLanToCloudTransfer: {
@@ -228,6 +237,10 @@ export interface CollabAuthorityTransferOperationMap {
         readonly request: GetProjectAuthorityTransferRequest;
         readonly response: CollabAuthorityTransferStatus;
     };
+    readonly getAuthorityTransferReceiptVerifier: {
+        readonly request: GetAuthorityTransferReceiptVerifierRequest;
+        readonly response: CollabAuthorityTransferReceiptVerifier;
+    };
     readonly rotateTransferredMembershipClaims: {
         readonly request: RotateTransferredMembershipClaimsRequest;
         readonly response: CollabTransferredMembershipClaimBatch;

package/dist/CollabAuthorityTransfer.js

@@ -64,6 +64,7 @@ exports.COLLAB_AUTHORITY_TRANSFER_OPERATIONS = Object.freeze([
     'acceptLanToCloudTransferTarget',
     'beginLanToCloudTransfer',
     'getProjectAuthorityTransfer',
+    'getAuthorityTransferReceiptVerifier',
     'rotateTransferredMembershipClaims',
     'acknowledgeTransferredMembershipClaimBatch',
     'getTransferredMembershipClaim',
@@ -223,7 +224,7 @@ function decodeCollabTransferredMembershipClaimBatch(value) {
         'targetAuthorityGeneration',
         'transferId',
     ]);
-    if (!Array.isArray(source.claims) || source.claims.length === 0) {
+    if (!Array.isArray(source.claims)) {
         throw invalidPayload('claims');
     }
     const claims = source.claims.map(claimItem);
@@ -627,6 +628,24 @@ function decodeGetProjectAuthorityTransfer(value) {
         transferId: token(source, 'transferId'),
     };
 }
+function decodeAuthorityTransferReceiptVerifier(value) {
+    const source = exactRecord(value, 'receiptVerifier', [
+        'projectId',
+        'receiptKeyId',
+        'receiptPublicKey',
+        'receiptPublicKeyEncoding',
+        'signatureAlgorithm',
+        'transferId',
+    ]);
+    return {
+        projectId: token(source, 'projectId', CollabValidation_1.isCollabProjectId),
+        receiptKeyId: boundedString(source, 'receiptKeyId', 256),
+        receiptPublicKey: fixedBase64url(source, 'receiptPublicKey', 32),
+        receiptPublicKeyEncoding: literal(source, 'receiptPublicKeyEncoding', ['base64url-raw']),
+        signatureAlgorithm: literal(source, 'signatureAlgorithm', ['ed25519']),
+        transferId: token(source, 'transferId'),
+    };
+}
 function decodeRotateTransferredMembershipClaims(value) {
     const source = exactRecord(value, 'request', [
         'expectedBatchRevision',
@@ -820,6 +839,8 @@ function decodeCollabAuthorityTransferOperationRequest(operation, value) {
             case 'acceptLanToCloudTransferTarget': return decodeAcceptLanToCloudTransferTarget(value);
             case 'beginLanToCloudTransfer': return decodeBeginLanToCloudTransfer(value);
             case 'getProjectAuthorityTransfer': return decodeGetProjectAuthorityTransfer(value);
+            case 'getAuthorityTransferReceiptVerifier':
+                return decodeGetProjectAuthorityTransfer(value);
             case 'rotateTransferredMembershipClaims':
                 return decodeRotateTransferredMembershipClaims(value);
             case 'acknowledgeTransferredMembershipClaimBatch':
@@ -869,6 +890,8 @@ function decodeCollabAuthorityTransferOperationResponse(operation, value) {
                 return decodeCollabTransferredMembershipRedemptionReceipt(value);
             case 'acknowledgeTransferredMembershipClaimRedemption':
                 return decodeRedemptionAcknowledgement(value);
+            case 'getAuthorityTransferReceiptVerifier':
+                return decodeAuthorityTransferReceiptVerifier(value);
             default:
                 return decodeCollabAuthorityTransferStatus(value);
         }

package/dist/CollabConstants.d.ts

@@ -1,4 +1,4 @@
-export declare const COLLAB_PROTOCOL_VERSION: 5;
+export declare const COLLAB_PROTOCOL_VERSION: 6;
 export declare const COLLAB_MAIN_REF: "refs/heads/main";
 export declare const COLLAB_MEMBER_REF_PREFIX: "refs/heads/members/";
 export declare const COLLAB_LIMITS: Readonly<{

package/dist/CollabConstants.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.COLLAB_LIMITS = exports.COLLAB_MEMBER_REF_PREFIX = exports.COLLAB_MAIN_REF = exports.COLLAB_PROTOCOL_VERSION = void 0;
-exports.COLLAB_PROTOCOL_VERSION = 5;
+exports.COLLAB_PROTOCOL_VERSION = 6;
 exports.COLLAB_MAIN_REF = 'refs/heads/main';
 exports.COLLAB_MEMBER_REF_PREFIX = 'refs/heads/members/';
 exports.COLLAB_LIMITS = Object.freeze({

package/dist/CollabControlOperationCodecs.d.ts

@@ -27,6 +27,7 @@ export declare const COLLAB_CONTROL_OPERATION_CODECS: Readonly<{
     readonly acceptLanToCloudTransferTarget: CollabControlOperationCodec<import("./CollabAuthorityTransfer").AcceptLanToCloudTransferTargetRequest, import("./CollabAuthorityTransfer").CollabAuthorityTransferStatus>;
     readonly beginLanToCloudTransfer: CollabControlOperationCodec<import("./CollabAuthorityTransfer").BeginLanToCloudTransferRequest, import("./CollabAuthorityTransfer").CollabAuthorityTransferStatus>;
     readonly getProjectAuthorityTransfer: CollabControlOperationCodec<import("./CollabAuthorityTransfer").GetProjectAuthorityTransferRequest, import("./CollabAuthorityTransfer").CollabAuthorityTransferStatus>;
+    readonly getAuthorityTransferReceiptVerifier: CollabControlOperationCodec<import("./CollabAuthorityTransfer").GetProjectAuthorityTransferRequest, import("./CollabAuthorityTransfer").CollabAuthorityTransferReceiptVerifier>;
     readonly rotateTransferredMembershipClaims: CollabControlOperationCodec<import("./CollabAuthorityTransfer").RotateTransferredMembershipClaimsRequest, import("./CollabAuthorityTransfer").CollabTransferredMembershipClaimBatch>;
     readonly acknowledgeTransferredMembershipClaimBatch: CollabControlOperationCodec<import("./CollabAuthorityTransfer").AcknowledgeTransferredMembershipClaimBatchRequest, import("./CollabAuthorityTransfer").CollabTransferredMembershipClaimCustodyReceipt>;
     readonly getTransferredMembershipClaim: CollabControlOperationCodec<import("./CollabAuthorityTransfer").GetTransferredMembershipClaimRequest, import("./CollabAuthorityTransfer").CollabTransferredMembershipClaim>;

package/dist/CollabControlOperationCodecs.js

@@ -81,6 +81,7 @@ exports.COLLAB_CONTROL_OPERATION_CODECS = Object.freeze({
     acceptLanToCloudTransferTarget: codec('acceptLanToCloudTransferTarget'),
     beginLanToCloudTransfer: codec('beginLanToCloudTransfer'),
     getProjectAuthorityTransfer: codec('getProjectAuthorityTransfer'),
+    getAuthorityTransferReceiptVerifier: codec('getAuthorityTransferReceiptVerifier'),
     rotateTransferredMembershipClaims: codec('rotateTransferredMembershipClaims'),
     acknowledgeTransferredMembershipClaimBatch: codec('acknowledgeTransferredMembershipClaimBatch'),
     getTransferredMembershipClaim: codec('getTransferredMembershipClaim'),

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { COLLAB_LIMITS, COLLAB_MAIN_REF, COLLAB_MEMBER_REF_PREFIX, COLLAB_PROTOCOL_VERSION, } from './CollabConstants';
 export type { CollabProtocolVersion } from './CollabConstants';
 export { COLLAB_AUTHORITY_TRANSFER_CANCELLABLE_PHASES, COLLAB_AUTHORITY_TRANSFER_CANCELLATION_PHASES, COLLAB_AUTHORITY_TRANSFER_OPERATIONS, COLLAB_CLOUD_TO_LAN_TRANSFER_PHASES, COLLAB_LAN_TO_CLOUD_TRANSFER_PHASES, decodeCollabAuthorityRelinquishmentProof, decodeCollabAuthorityTransferOperationRequest, decodeCollabAuthorityTransferOperationResponse, decodeCollabAuthorityTransferProposal, decodeCollabAuthorityTransferStatus, decodeCollabTransferredMembershipClaim, decodeCollabTransferredMembershipClaimBatch, decodeCollabTransferredMembershipClaimCustodyReceipt, decodeCollabTransferredMembershipRedemptionReceipt, encodeCollabAuthorityRelinquishmentProofSigningInput, encodeCollabTransferredMembershipClaimBatchDigestInput, encodeCollabTransferredMembershipRedemptionReceiptSigningInput, } from './CollabAuthorityTransfer';
-export type { AcceptCloudToLanTransferTargetRequest, AcceptLanToCloudTransferTargetRequest, AcknowledgeTransferredMembershipClaimBatchRequest, AcknowledgeTransferredMembershipClaimRedemptionRequest, BeginCloudToLanTransferRequest, BeginLanToCloudTransferRequest, CancelProjectAuthorityTransferRequest, ClaimTransferredMembershipRequest, CollabAuthorityRelinquishmentProof, CollabAuthorityRelinquishmentProofSigningPayload, CollabAuthorityTransferCancellablePhase, CollabAuthorityTransferCancellationPhase, CollabAuthorityTransferDirection, CollabAuthorityTransferOperation, CollabAuthorityTransferOperationMap, CollabAuthorityTransferProposal, CollabAuthorityTransferStatus, CollabCloudToLanTransferPhase, CollabLanToCloudTransferPhase, CollabTransferredMembershipClaim, CollabTransferredMembershipClaimBatch, CollabTransferredMembershipClaimCustodyReceipt, CollabTransferredMembershipClaimItem, CollabTransferredMembershipRedemptionAcknowledgement, CollabTransferredMembershipRedemptionReceipt, CollabTransferredMembershipRedemptionReceiptSigningPayload, CommitLanToCloudRelinquishmentRequest, ConfirmCloudToLanTargetActiveRequest, GetProjectAuthorityTransferRequest, GetTransferredMembershipClaimRequest, ReportCloudToLanTargetStagedRequest, RequestLanToCloudTransferRequest, RotateTransferredMembershipClaimsRequest, } from './CollabAuthorityTransfer';
+export type { AcceptCloudToLanTransferTargetRequest, AcceptLanToCloudTransferTargetRequest, AcknowledgeTransferredMembershipClaimBatchRequest, AcknowledgeTransferredMembershipClaimRedemptionRequest, BeginCloudToLanTransferRequest, BeginLanToCloudTransferRequest, CancelProjectAuthorityTransferRequest, ClaimTransferredMembershipRequest, CollabAuthorityRelinquishmentProof, CollabAuthorityRelinquishmentProofSigningPayload, CollabAuthorityTransferCancellablePhase, CollabAuthorityTransferCancellationPhase, CollabAuthorityTransferDirection, CollabAuthorityTransferOperation, CollabAuthorityTransferOperationMap, CollabAuthorityTransferProposal, CollabAuthorityTransferReceiptVerifier, CollabAuthorityTransferStatus, CollabCloudToLanTransferPhase, CollabLanToCloudTransferPhase, CollabTransferredMembershipClaim, CollabTransferredMembershipClaimBatch, CollabTransferredMembershipClaimCustodyReceipt, CollabTransferredMembershipClaimItem, CollabTransferredMembershipRedemptionAcknowledgement, CollabTransferredMembershipRedemptionReceipt, CollabTransferredMembershipRedemptionReceiptSigningPayload, CommitLanToCloudRelinquishmentRequest, ConfirmCloudToLanTargetActiveRequest, GetProjectAuthorityTransferRequest, GetAuthorityTransferReceiptVerifierRequest, GetTransferredMembershipClaimRequest, ReportCloudToLanTargetStagedRequest, RequestLanToCloudTransferRequest, RotateTransferredMembershipClaimsRequest, } from './CollabAuthorityTransfer';
 export { COLLAB_CHECKPOINT_ARTIFACT_LIMITS, COLLAB_CHECKPOINT_BACKUP_RECORD_KINDS, COLLAB_CHECKPOINT_PORTABLE_RECORD_KINDS, COLLAB_CHECKPOINT_PROFILES, COLLAB_PROJECT_CHECKPOINT_ARTIFACTS, COLLAB_PROJECT_CHECKPOINT_MANIFEST_SCHEMA_VERSION, COLLAB_PROJECT_COORDINATION_FORMAT_VERSION, COLLAB_PROTECTED_CLAIM_ENVELOPE_LIMITS, COLLAB_PROTECTED_CLAIM_ENVELOPE_VERSION, decodeCollabProjectCheckpointCoordinationNdjson, decodeCollabProjectCheckpointManifest, encodeCollabProjectCheckpointCoordinationNdjson, encodeCollabProjectCheckpointManifestCanonicalJson, encodeCollabProjectCheckpointManifestDigestInput, encodeCollabProtectedClaimAssociatedData, validateCollabProjectCheckpointConsistency, } from './CollabProjectCheckpoint';
 export type { CollabCheckpointArtifactFact, CollabCheckpointAuthorityVolumePairRecord, CollabCheckpointAuthority, CollabCheckpointAuthorityKind, CollabCheckpointBackupRecord, CollabCheckpointBackupRecordKind, CollabCheckpointCloudEventCursorRecord, CollabCheckpointCloudEventRecord, CollabCheckpointGitRef, CollabCheckpointIdempotencyResultRecord, CollabCheckpointLifecycleStateRecord, CollabCheckpointMemberRecord, CollabCheckpointObjectFormat, CollabCheckpointPortableRecord, CollabCheckpointPortableRecordKind, CollabCheckpointProfile, CollabCheckpointPrincipalBindingRecord, CollabCheckpointProjectRecord, CollabCheckpointProtectedClaimEnvelopeRecord, CollabCheckpointRepositoryPlacementRecord, CollabCheckpointRequestCommentRecord, CollabCheckpointRequestRecord, CollabCheckpointTicketCommentRecord, CollabCheckpointTicketMentionRecord, CollabCheckpointTicketRecord, CollabCheckpointTicketRelationRecord, CollabCheckpointSchemaCatalogRecord, CollabCheckpointServerCompatibilityRecord, CollabCheckpointTerminalResponderRecord, CollabCheckpointTerminalAcknowledgement, CollabCheckpointTombstoneRecord, CollabProjectCheckpointManifest, CollabProtectedClaimAssociatedData, } from './CollabProjectCheckpoint';
 export { COLLAB_PROJECT_RETIREMENT_OPERATIONS, COLLAB_PROJECT_RETIREMENT_RESULT_KINDS, decodeCollabProjectRetirementAcknowledgement, decodeCollabProjectRetirementOperationRequest, decodeCollabProjectRetirementOperationResponse, decodeCollabProjectRetirementRequest, decodeCollabProjectRetirementResult, } from './CollabProjectRetirement';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudian-collab/protocol",
-  "version": "2.0.0",
+  "version": "3.1.0",
   "description": "Canonical Collab wire and Cloud binding contract for Claudian clients and servers.",
   "license": "MIT",
   "repository": {