@claudian-collab/protocol 1.0.0 → 2.0.0

package/dist/CollabCloudBinding.d.ts

@@ -1,8 +1,10 @@
 import { COLLAB_PROTOCOL_VERSION } from './CollabConstants';
 import { CollabError, type CollabDiagnosticContext, type CollabErrorCode, type CollabRecoveryAction } from './CollabError';
-export declare const COLLAB_CLOUD_BINDING_VERSION: 1;
-export declare const COLLAB_CLOUD_CAPABILITY_DOCUMENT_SCHEMA_VERSION: 1;
-export declare const COLLAB_CLOUD_CAPABILITIES: readonly ["accept", "development-bootstrap", "git-receive-pack-personal-ref", "git-upload-pack", "project-events", "project-snapshot", "requests", "tickets"];
+import { COLLAB_PROJECT_CHECKPOINT_ARTIFACTS } from './CollabProjectCheckpoint';
+import type { CollabIsoTimestamp, CollabProjectId } from './types';
+export declare const COLLAB_CLOUD_BINDING_VERSION: 2;
+export declare const COLLAB_CLOUD_CAPABILITY_DOCUMENT_SCHEMA_VERSION: 2;
+export declare const COLLAB_CLOUD_CAPABILITIES: readonly ["accept", "authority-transfer", "development-bootstrap", "git-receive-pack-personal-ref", "git-upload-pack", "project-checkpoint-export", "project-events", "project-retirement", "project-snapshot", "requests", "tickets"];
 export type CollabCloudCapability = typeof COLLAB_CLOUD_CAPABILITIES[number];
 export declare const COLLAB_CLOUD_JSON_OPERATIONS: readonly ["getProjectSnapshot", ...(keyof import("./CollabProtocol").CollabControlOperationMap)[]];
 export type CollabCloudJsonOperation = typeof COLLAB_CLOUD_JSON_OPERATIONS[number];
@@ -15,6 +17,10 @@ export declare const COLLAB_CLOUD_BINDING_LIMITS: Readonly<{
     readonly maxCloudProjectMembers: 100;
     readonly maxCloudSnapshotUtf8Bytes: number;
     readonly maxCloudTicketHighlights: 5;
+    readonly maxCheckpointCoordinationBytes: number;
+    readonly maxCheckpointManifestUtf8Bytes: number;
+    readonly maxCheckpointRepositoryBundleBytes: number;
+    readonly maxCheckpointStagingBytes: number;
     readonly maxDevelopmentBootstrapGitBundleBytes: number;
     readonly maxDevelopmentBootstrapManifestUtf8Bytes: number;
     readonly maxDevelopmentBootstrapReportUtf8Bytes: number;
@@ -30,6 +36,10 @@ export declare const COLLAB_CLOUD_BINDING_LIMITS: Readonly<{
     readonly uploadIdleTimeoutMs: 30000;
 }>;
 export interface CollabCloudCapabilityLimits {
+    readonly maxCheckpointCoordinationBytes: number;
+    readonly maxCheckpointManifestUtf8Bytes: number;
+    readonly maxCheckpointRepositoryBundleBytes: number;
+    readonly maxCheckpointStagingBytes: number;
     readonly maxDevelopmentBootstrapGitBundleBytes: number;
     readonly maxDevelopmentBootstrapManifestUtf8Bytes: number;
     readonly maxDevelopmentBootstrapReportUtf8Bytes: number;
@@ -47,6 +57,16 @@ export interface CollabCloudCapabilityDocument {
 }
 export type DevelopmentBootstrapOperation = 'beginDevelopmentBootstrap' | 'submitDevelopmentBootstrapReport' | 'getDevelopmentBootstrap' | 'activateDevelopmentBootstrap' | 'cancelDevelopmentBootstrap' | 'putDevelopmentBootstrapGitBundle';
 export type CollabCloudGitService = 'git-upload-pack' | 'git-receive-pack';
+export type CollabCloudAuthorityTransferArtifact = typeof COLLAB_PROJECT_CHECKPOINT_ARTIFACTS[number];
+export type CollabCloudAuthorityTransferArtifactDirection = 'download' | 'upload';
+export interface CollabCloudProjectCheckpointExportStatus {
+    readonly checkpointSha256: string | null;
+    readonly createdAt: CollabIsoTimestamp;
+    readonly expiresAt: CollabIsoTimestamp;
+    readonly exportId: string;
+    readonly projectId: CollabProjectId;
+    readonly state: 'preparing' | 'ready';
+}
 export type CollabCloudRouteMatch = {
     readonly kind: 'capabilities';
 } | {
@@ -64,6 +84,22 @@ export type CollabCloudRouteMatch = {
 } | {
     readonly kind: 'git-upload-pack' | 'git-receive-pack';
     readonly projectId: string;
+} | {
+    readonly artifact: CollabCloudAuthorityTransferArtifact;
+    readonly direction: CollabCloudAuthorityTransferArtifactDirection;
+    readonly kind: 'authority-transfer-artifact';
+    readonly projectId: string;
+    readonly transferId: string;
+} | {
+    readonly exportId: string;
+    readonly kind: 'project-checkpoint-export';
+    readonly operation: 'begin' | 'status';
+    readonly projectId: string;
+} | {
+    readonly artifact: CollabCloudAuthorityTransferArtifact;
+    readonly exportId: string;
+    readonly kind: 'project-checkpoint-export-artifact';
+    readonly projectId: string;
 } | {
     readonly attemptId?: string;
     readonly kind: 'development-bootstrap';
@@ -94,6 +130,10 @@ export declare function collabCloudProjectOperationRoute(projectId: string, oper
 export declare function collabCloudProjectEventsRoute(projectId: string, afterSequence: number): CollabCloudRoute;
 export declare function collabCloudGitRoute(projectId: string, routeKind: 'info-refs', service: CollabCloudGitService): CollabCloudRoute;
 export declare function collabCloudGitRoute(projectId: string, routeKind: CollabCloudGitService): CollabCloudRoute;
+export declare function collabCloudAuthorityTransferArtifactRoute(projectId: string, transferId: string, direction: CollabCloudAuthorityTransferArtifactDirection, artifact: CollabCloudAuthorityTransferArtifact): CollabCloudRoute;
+export declare function collabCloudProjectCheckpointExportArtifactRoute(projectId: string, exportId: string, artifact: CollabCloudAuthorityTransferArtifact): CollabCloudRoute;
+export declare function collabCloudProjectCheckpointExportRoute(projectId: string, exportId: string, operation: 'begin' | 'status'): CollabCloudRoute;
+export declare function decodeCollabCloudProjectCheckpointExportStatus(value: unknown): CollabCloudProjectCheckpointExportStatus;
 export declare function collabDevelopmentBootstrapRoute(operation: 'beginDevelopmentBootstrap'): CollabCloudRoute;
 export declare function collabDevelopmentBootstrapRoute(operation: Exclude<DevelopmentBootstrapOperation, 'beginDevelopmentBootstrap'>, attemptId: string): CollabCloudRoute;
 export declare function matchCollabCloudRoute(method: string, target: string): CollabCloudRouteMatch | null;

package/dist/CollabCloudBinding.js

@@ -5,6 +5,10 @@ exports.collabCloudCapabilitiesRoute = collabCloudCapabilitiesRoute;
 exports.collabCloudProjectOperationRoute = collabCloudProjectOperationRoute;
 exports.collabCloudProjectEventsRoute = collabCloudProjectEventsRoute;
 exports.collabCloudGitRoute = collabCloudGitRoute;
+exports.collabCloudAuthorityTransferArtifactRoute = collabCloudAuthorityTransferArtifactRoute;
+exports.collabCloudProjectCheckpointExportArtifactRoute = collabCloudProjectCheckpointExportArtifactRoute;
+exports.collabCloudProjectCheckpointExportRoute = collabCloudProjectCheckpointExportRoute;
+exports.decodeCollabCloudProjectCheckpointExportStatus = decodeCollabCloudProjectCheckpointExportStatus;
 exports.collabDevelopmentBootstrapRoute = collabDevelopmentBootstrapRoute;
 exports.matchCollabCloudRoute = matchCollabCloudRoute;
 exports.decodeCollabCloudCapabilityDocument = decodeCollabCloudCapabilityDocument;
@@ -18,14 +22,18 @@ const CollabConstants_1 = require("./CollabConstants");
 const CollabControlOperationCodecs_1 = require("./CollabControlOperationCodecs");
 const CollabError_1 = require("./CollabError");
 const CollabValidation_1 = require("./CollabValidation");
-exports.COLLAB_CLOUD_BINDING_VERSION = 1;
-exports.COLLAB_CLOUD_CAPABILITY_DOCUMENT_SCHEMA_VERSION = 1;
+const CollabProjectCheckpoint_1 = require("./CollabProjectCheckpoint");
+exports.COLLAB_CLOUD_BINDING_VERSION = 2;
+exports.COLLAB_CLOUD_CAPABILITY_DOCUMENT_SCHEMA_VERSION = 2;
 exports.COLLAB_CLOUD_CAPABILITIES = Object.freeze([
     'accept',
+    'authority-transfer',
     'development-bootstrap',
     'git-receive-pack-personal-ref',
     'git-upload-pack',
+    'project-checkpoint-export',
     'project-events',
+    'project-retirement',
     'project-snapshot',
     'requests',
     'tickets',
@@ -43,6 +51,10 @@ exports.COLLAB_CLOUD_BINDING_LIMITS = Object.freeze({
     maxCloudProjectMembers: 100,
     maxCloudSnapshotUtf8Bytes: 448 * 1024,
     maxCloudTicketHighlights: 5,
+    maxCheckpointCoordinationBytes: CollabProjectCheckpoint_1.COLLAB_CHECKPOINT_ARTIFACT_LIMITS.maxCoordinationBytes,
+    maxCheckpointManifestUtf8Bytes: CollabProjectCheckpoint_1.COLLAB_CHECKPOINT_ARTIFACT_LIMITS.maxManifestBytes,
+    maxCheckpointRepositoryBundleBytes: CollabProjectCheckpoint_1.COLLAB_CHECKPOINT_ARTIFACT_LIMITS.maxRepositoryBundleBytes,
+    maxCheckpointStagingBytes: CollabProjectCheckpoint_1.COLLAB_CHECKPOINT_ARTIFACT_LIMITS.maxStagingBytes,
     maxDevelopmentBootstrapGitBundleBytes: 1024 * 1024 * 1024,
     maxDevelopmentBootstrapManifestUtf8Bytes: 64 * 1024,
     maxDevelopmentBootstrapReportUtf8Bytes: 64 * 1024,
@@ -59,6 +71,7 @@ exports.COLLAB_CLOUD_BINDING_LIMITS = Object.freeze({
 });
 const CLOUD_CAPABILITY_SET = new Set(exports.COLLAB_CLOUD_CAPABILITIES);
 const CLOUD_JSON_OPERATION_SET = new Set(exports.COLLAB_CLOUD_JSON_OPERATIONS);
+const COLLAB_PROJECT_CHECKPOINT_ARTIFACTS_SET = new Set(CollabProjectCheckpoint_1.COLLAB_PROJECT_CHECKPOINT_ARTIFACTS);
 const COLLAB_ERROR_CODE_SET = new Set(CollabError_1.COLLAB_ERROR_CODES);
 const RECOVERY_ACTION_SET = new Set([
     'retry',
@@ -66,6 +79,7 @@ const RECOVERY_ACTION_SET = new Set([
     'request-access',
 ]);
 const CAPABILITY_TOKEN_PATTERN = /^[a-z][a-z0-9-]{0,63}$/u;
+const SHA256_PATTERN = /^[0-9a-f]{64}$/u;
 function invalidPayload(field) {
     return new CollabError_1.CollabError({
         code: 'protocol-payload-invalid',
@@ -152,6 +166,14 @@ function assertAttemptId(attemptId) {
 function isCloudJsonOperation(value) {
     return CLOUD_JSON_OPERATION_SET.has(value);
 }
+function isoTimestamp(value, field) {
+    if (typeof value !== 'string'
+        || value.length > 64
+        || Number.isNaN(Date.parse(value))
+        || new Date(value).toISOString() !== value)
+        throw invalidPayload(field);
+    return value;
+}
 function collabCloudCapabilitiesRoute() {
     return route('GET', '/collab/capabilities', { kind: 'capabilities' });
 }
@@ -159,7 +181,7 @@ function collabCloudProjectOperationRoute(projectId, operation) {
     assertProjectId(projectId);
     if (!isCloudJsonOperation(operation))
         invalidRoute();
-    return route('POST', `/v1/projects/${projectId}/operations/${operation}`, {
+    return route('POST', `/v2/projects/${projectId}/operations/${operation}`, {
         kind: 'project-operation',
         operation,
         projectId,
@@ -169,7 +191,7 @@ function collabCloudProjectEventsRoute(projectId, afterSequence) {
     assertProjectId(projectId);
     if (!Number.isSafeInteger(afterSequence) || afterSequence < 0)
         invalidRoute();
-    return route('GET', `/v1/projects/${projectId}/events?afterSequence=${afterSequence}`, {
+    return route('GET', `/v2/projects/${projectId}/events?afterSequence=${afterSequence}`, {
         afterSequence,
         kind: 'project-events',
         projectId,
@@ -180,17 +202,85 @@ function collabCloudGitRoute(projectId, routeKind, service) {
     if (routeKind === 'info-refs') {
         if (service !== 'git-upload-pack' && service !== 'git-receive-pack')
             invalidRoute();
-        return route('GET', `/v1/projects/${projectId}/repository.git/info/refs?service=${service}`, { kind: 'git-info-refs', projectId, service });
+        return route('GET', `/v2/projects/${projectId}/repository.git/info/refs?service=${service}`, { kind: 'git-info-refs', projectId, service });
     }
     if (service !== undefined)
         invalidRoute();
-    return route('POST', `/v1/projects/${projectId}/repository.git/${routeKind}`, {
+    return route('POST', `/v2/projects/${projectId}/repository.git/${routeKind}`, {
         kind: routeKind,
         projectId,
     });
 }
+function collabCloudAuthorityTransferArtifactRoute(projectId, transferId, direction, artifact) {
+    assertProjectId(projectId);
+    assertAttemptId(transferId);
+    if (direction !== 'download' && direction !== 'upload'
+        || !COLLAB_PROJECT_CHECKPOINT_ARTIFACTS_SET.has(artifact))
+        invalidRoute();
+    return route(direction === 'upload' ? 'PUT' : 'GET', `/v2/projects/${projectId}/authority-transfers/${transferId}/checkpoint/${artifact}`, {
+        artifact,
+        direction,
+        kind: 'authority-transfer-artifact',
+        projectId,
+        transferId,
+    });
+}
+function collabCloudProjectCheckpointExportArtifactRoute(projectId, exportId, artifact) {
+    assertProjectId(projectId);
+    assertAttemptId(exportId);
+    if (!COLLAB_PROJECT_CHECKPOINT_ARTIFACTS_SET.has(artifact))
+        invalidRoute();
+    return route('GET', `/v2/projects/${projectId}/checkpoint-exports/${exportId}/checkpoint/${artifact}`, {
+        artifact,
+        exportId,
+        kind: 'project-checkpoint-export-artifact',
+        projectId,
+    });
+}
+function collabCloudProjectCheckpointExportRoute(projectId, exportId, operation) {
+    assertProjectId(projectId);
+    assertAttemptId(exportId);
+    if (operation !== 'begin' && operation !== 'status')
+        invalidRoute();
+    return route(operation === 'begin' ? 'POST' : 'GET', `/v2/projects/${projectId}/checkpoint-exports/${exportId}`, { exportId, kind: 'project-checkpoint-export', operation, projectId });
+}
+function decodeCollabCloudProjectCheckpointExportStatus(value) {
+    const source = exactRecord(value, 'checkpointExport', [
+        'checkpointSha256',
+        'createdAt',
+        'expiresAt',
+        'exportId',
+        'projectId',
+        'state',
+    ]);
+    if (!(0, CollabValidation_1.isCollabOpaqueId)(source.exportId) || !(0, CollabValidation_1.isCollabProjectId)(source.projectId)) {
+        throw invalidPayload('checkpointExport');
+    }
+    const state = source.state;
+    if (state !== 'preparing' && state !== 'ready')
+        throw invalidPayload('state');
+    if (source.checkpointSha256 !== null && typeof source.checkpointSha256 !== 'string') {
+        throw invalidPayload('checkpointSha256');
+    }
+    const checkpointSha256 = source.checkpointSha256;
+    if ((state === 'preparing' && checkpointSha256 !== null)
+        || (state === 'ready' && (typeof checkpointSha256 !== 'string' || !SHA256_PATTERN.test(checkpointSha256))))
+        throw invalidPayload('checkpointSha256');
+    const createdAt = isoTimestamp(source.createdAt, 'createdAt');
+    const expiresAt = isoTimestamp(source.expiresAt, 'expiresAt');
+    if (Date.parse(expiresAt) <= Date.parse(createdAt))
+        throw invalidPayload('expiresAt');
+    return Object.freeze({
+        checkpointSha256,
+        createdAt,
+        expiresAt,
+        exportId: source.exportId,
+        projectId: source.projectId,
+        state,
+    });
+}
 function collabDevelopmentBootstrapRoute(operation, attemptId) {
-    const base = '/v1/development/bootstrap/attempts';
+    const base = '/v2/development/bootstrap/attempts';
     if (operation === 'beginDevelopmentBootstrap') {
         if (attemptId !== undefined)
             invalidRoute();
@@ -231,7 +321,7 @@ function parseCanonicalNonNegativeInteger(value) {
     return Number.isSafeInteger(parsed) ? parsed : null;
 }
 function matchCollabCloudRoute(method, target) {
-    if (!target.startsWith('/') || target.includes('#'))
+    if (!target.startsWith('/') || target.startsWith('//') || target.includes('#'))
         return null;
     let url;
     try {
@@ -240,6 +330,8 @@ function matchCollabCloudRoute(method, target) {
     catch {
         return null;
     }
+    if (`${url.pathname}${url.search}` !== target)
+        return null;
     const segments = url.pathname.split('/').filter(Boolean);
     if (url.pathname !== `/${segments.join('/')}` || target.endsWith('?'))
         return null;
@@ -247,10 +339,51 @@ function matchCollabCloudRoute(method, target) {
         && url.pathname === '/collab/capabilities'
         && exactQuery(url, []))
         return { kind: 'capabilities' };
-    if (segments[0] === 'v1'
+    if (segments[0] === 'v2'
         && segments[1] === 'projects'
         && (0, CollabValidation_1.isCollabProjectId)(segments[2])) {
         const projectId = segments[2];
+        if (method === 'GET'
+            && segments.length === 7
+            && segments[3] === 'checkpoint-exports'
+            && (0, CollabValidation_1.isCollabOpaqueId)(segments[4])
+            && segments[5] === 'checkpoint'
+            && COLLAB_PROJECT_CHECKPOINT_ARTIFACTS_SET.has(segments[6])
+            && exactQuery(url, [])) {
+            return {
+                artifact: segments[6],
+                exportId: segments[4],
+                kind: 'project-checkpoint-export-artifact',
+                projectId,
+            };
+        }
+        if ((method === 'POST' || method === 'GET')
+            && segments.length === 5
+            && segments[3] === 'checkpoint-exports'
+            && (0, CollabValidation_1.isCollabOpaqueId)(segments[4])
+            && exactQuery(url, [])) {
+            return {
+                exportId: segments[4],
+                kind: 'project-checkpoint-export',
+                operation: method === 'POST' ? 'begin' : 'status',
+                projectId,
+            };
+        }
+        if ((method === 'GET' || method === 'PUT')
+            && segments.length === 7
+            && segments[3] === 'authority-transfers'
+            && (0, CollabValidation_1.isCollabOpaqueId)(segments[4])
+            && segments[5] === 'checkpoint'
+            && COLLAB_PROJECT_CHECKPOINT_ARTIFACTS_SET.has(segments[6])
+            && exactQuery(url, [])) {
+            return {
+                artifact: segments[6],
+                direction: method === 'PUT' ? 'upload' : 'download',
+                kind: 'authority-transfer-artifact',
+                projectId,
+                transferId: segments[4],
+            };
+        }
         if (method === 'POST'
             && segments.length === 5
             && segments[3] === 'operations'
@@ -285,7 +418,7 @@ function matchCollabCloudRoute(method, target) {
             && exactQuery(url, []))
             return { kind: segments[4], projectId };
     }
-    if (segments[0] !== 'v1'
+    if (segments[0] !== 'v2'
         || segments[1] !== 'development'
         || segments[2] !== 'bootstrap'
         || segments[3] !== 'attempts'
@@ -329,6 +462,10 @@ function decodeCollabCloudCapabilityDocument(value) {
     requireSupportedVersion(protocolVersions, CollabConstants_1.COLLAB_PROTOCOL_VERSION, 'canonical-wire');
     const capabilities = sortedUniqueTokens(source.capabilities, 'capabilities');
     const limitsSource = exactRecord(source.limits, 'limits', [
+        'maxCheckpointCoordinationBytes',
+        'maxCheckpointManifestUtf8Bytes',
+        'maxCheckpointRepositoryBundleBytes',
+        'maxCheckpointStagingBytes',
         'maxDevelopmentBootstrapGitBundleBytes',
         'maxDevelopmentBootstrapManifestUtf8Bytes',
         'maxDevelopmentBootstrapReportUtf8Bytes',
@@ -338,6 +475,10 @@ function decodeCollabCloudCapabilityDocument(value) {
         'maxRepositoryBytes',
     ]);
     const limits = Object.freeze({
+        maxCheckpointCoordinationBytes: positiveSafeInteger(limitsSource.maxCheckpointCoordinationBytes, 'maxCheckpointCoordinationBytes', exports.COLLAB_CLOUD_BINDING_LIMITS.maxCheckpointCoordinationBytes),
+        maxCheckpointManifestUtf8Bytes: positiveSafeInteger(limitsSource.maxCheckpointManifestUtf8Bytes, 'maxCheckpointManifestUtf8Bytes', exports.COLLAB_CLOUD_BINDING_LIMITS.maxCheckpointManifestUtf8Bytes),
+        maxCheckpointRepositoryBundleBytes: positiveSafeInteger(limitsSource.maxCheckpointRepositoryBundleBytes, 'maxCheckpointRepositoryBundleBytes', exports.COLLAB_CLOUD_BINDING_LIMITS.maxCheckpointRepositoryBundleBytes),
+        maxCheckpointStagingBytes: positiveSafeInteger(limitsSource.maxCheckpointStagingBytes, 'maxCheckpointStagingBytes', exports.COLLAB_CLOUD_BINDING_LIMITS.maxCheckpointStagingBytes),
         maxDevelopmentBootstrapGitBundleBytes: positiveSafeInteger(limitsSource.maxDevelopmentBootstrapGitBundleBytes, 'maxDevelopmentBootstrapGitBundleBytes', exports.COLLAB_CLOUD_BINDING_LIMITS.maxDevelopmentBootstrapGitBundleBytes),
         maxDevelopmentBootstrapManifestUtf8Bytes: positiveSafeInteger(limitsSource.maxDevelopmentBootstrapManifestUtf8Bytes, 'maxDevelopmentBootstrapManifestUtf8Bytes', exports.COLLAB_CLOUD_BINDING_LIMITS.maxDevelopmentBootstrapManifestUtf8Bytes),
         maxDevelopmentBootstrapReportUtf8Bytes: positiveSafeInteger(limitsSource.maxDevelopmentBootstrapReportUtf8Bytes, 'maxDevelopmentBootstrapReportUtf8Bytes', exports.COLLAB_CLOUD_BINDING_LIMITS.maxDevelopmentBootstrapReportUtf8Bytes),

package/dist/CollabCloudProjectEvent.d.ts

@@ -1,8 +1,11 @@
 import { COLLAB_PROTOCOL_VERSION } from './CollabConstants';
 import type { CollabGitOid, CollabIsoTimestamp, CollabMemberId, CollabProjectId, CollabRequestId, CollabTicketId } from './types';
-export declare const COLLAB_CLOUD_EVENT_KINDS: readonly ["membership.updated", "request.updated", "request.comment-added", "ticket.updated", "ticket.comment-added", "main.updated"];
+export declare const COLLAB_CLOUD_EVENT_KINDS: readonly ["membership.updated", "request.updated", "request.comment-added", "ticket.updated", "ticket.comment-added", "main.updated", "authority-transfer.updated", "membership.claimed", "project.retired"];
 export type CollabCloudEventKind = typeof COLLAB_CLOUD_EVENT_KINDS[number];
 export interface CollabCloudEventPayloadMap {
+    readonly 'authority-transfer.updated': {
+        readonly transferId: string;
+    };
     readonly 'main.updated': {
         readonly mainOid: CollabGitOid;
         readonly requestId: CollabRequestId;
@@ -10,6 +13,14 @@ export interface CollabCloudEventPayloadMap {
     readonly 'membership.updated': {
         readonly memberId: CollabMemberId;
     };
+    readonly 'membership.claimed': {
+        readonly memberId: CollabMemberId;
+        readonly transferId: string;
+    };
+    readonly 'project.retired': {
+        readonly retiredAt: CollabIsoTimestamp;
+        readonly retirementId: string;
+    };
     readonly 'request.comment-added': {
         readonly requestId: CollabRequestId;
     };

package/dist/CollabCloudProjectEvent.js

@@ -12,6 +12,9 @@ exports.COLLAB_CLOUD_EVENT_KINDS = Object.freeze([
     'ticket.updated',
     'ticket.comment-added',
     'main.updated',
+    'authority-transfer.updated',
+    'membership.claimed',
+    'project.retired',
 ]);
 const EVENT_KIND_SET = new Set(exports.COLLAB_CLOUD_EVENT_KINDS);
 function invalidPayload(field) {
@@ -67,10 +70,28 @@ function timestamp(source, field) {
 }
 function decodePayload(kind, value) {
     switch (kind) {
+        case 'authority-transfer.updated': {
+            const source = exactRecord(value, 'payload', ['transferId']);
+            return { transferId: stringField(source, 'transferId', 128, CollabValidation_1.isCollabOpaqueId) };
+        }
         case 'membership.updated': {
             const source = exactRecord(value, 'payload', ['memberId']);
             return { memberId: stringField(source, 'memberId', 64, CollabValidation_1.isCollabMemberId) };
         }
+        case 'membership.claimed': {
+            const source = exactRecord(value, 'payload', ['memberId', 'transferId']);
+            return {
+                memberId: stringField(source, 'memberId', 64, CollabValidation_1.isCollabMemberId),
+                transferId: stringField(source, 'transferId', 128, CollabValidation_1.isCollabOpaqueId),
+            };
+        }
+        case 'project.retired': {
+            const source = exactRecord(value, 'payload', ['retiredAt', 'retirementId']);
+            return {
+                retiredAt: timestamp(source, 'retiredAt'),
+                retirementId: stringField(source, 'retirementId', 128, CollabValidation_1.isCollabOpaqueId),
+            };
+        }
         case 'request.updated':
         case 'request.comment-added': {
             const source = exactRecord(value, 'payload', ['requestId']);

package/dist/CollabConstants.d.ts

@@ -1,4 +1,4 @@
-export declare const COLLAB_PROTOCOL_VERSION: 4;
+export declare const COLLAB_PROTOCOL_VERSION: 5;
 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 = 4;
+exports.COLLAB_PROTOCOL_VERSION = 5;
 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

@@ -23,6 +23,23 @@ export declare const COLLAB_CONTROL_OPERATION_CODECS: Readonly<{
     readonly reopenTicket: CollabControlOperationCodec<import("./CollabProtocol").ChangeTicketStatusRequest, import("./CollabProtocol").TicketMutationResponse>;
     readonly updateMyRequestMetadata: CollabControlOperationCodec<import("./CollabProtocol").UpdateMyRequestMetadataRequest, import("./CollabProtocol").UpdateMyRequestMetadataResponse>;
     readonly acceptRequest: CollabControlOperationCodec<import("./CollabProtocol").AcceptRequest, import("./CollabProtocol").AcceptResponse>;
+    readonly requestLanToCloudTransfer: CollabControlOperationCodec<import("./CollabAuthorityTransfer").RequestLanToCloudTransferRequest, import("./CollabAuthorityTransfer").CollabAuthorityTransferStatus>;
+    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 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>;
+    readonly claimTransferredMembership: CollabControlOperationCodec<import("./CollabAuthorityTransfer").ClaimTransferredMembershipRequest, import("./CollabAuthorityTransfer").CollabTransferredMembershipRedemptionReceipt>;
+    readonly acknowledgeTransferredMembershipClaimRedemption: CollabControlOperationCodec<import("./CollabAuthorityTransfer").AcknowledgeTransferredMembershipClaimRedemptionRequest, import("./CollabAuthorityTransfer").CollabTransferredMembershipRedemptionAcknowledgement>;
+    readonly commitLanToCloudRelinquishment: CollabControlOperationCodec<import("./CollabAuthorityTransfer").CommitLanToCloudRelinquishmentRequest, import("./CollabAuthorityTransfer").CollabAuthorityTransferStatus>;
+    readonly beginCloudToLanTransfer: CollabControlOperationCodec<import("./CollabAuthorityTransfer").BeginCloudToLanTransferRequest, import("./CollabAuthorityTransfer").CollabAuthorityTransferStatus>;
+    readonly acceptCloudToLanTransferTarget: CollabControlOperationCodec<import("./CollabAuthorityTransfer").AcceptCloudToLanTransferTargetRequest, import("./CollabAuthorityTransfer").CollabAuthorityTransferStatus>;
+    readonly reportCloudToLanTargetStaged: CollabControlOperationCodec<import("./CollabAuthorityTransfer").ReportCloudToLanTargetStagedRequest, import("./CollabAuthorityTransfer").CollabTransferredMembershipClaimCustodyReceipt>;
+    readonly confirmCloudToLanTargetActive: CollabControlOperationCodec<import("./CollabAuthorityTransfer").ConfirmCloudToLanTargetActiveRequest, import("./CollabAuthorityTransfer").CollabAuthorityTransferStatus>;
+    readonly cancelProjectAuthorityTransfer: CollabControlOperationCodec<import("./CollabAuthorityTransfer").CancelProjectAuthorityTransferRequest, import("./CollabAuthorityTransfer").CollabAuthorityTransferStatus>;
+    readonly retireProject: CollabControlOperationCodec<import("./CollabProjectRetirement").CollabProjectRetirementRequest, import("./CollabProjectRetirement").CollabProjectRetirementResult>;
+    readonly acknowledgeProjectRetirement: CollabControlOperationCodec<import("./CollabProjectRetirement").CollabProjectRetirementAcknowledgementRequest, import("./CollabProjectRetirement").CollabProjectRetirementAcknowledgement>;
 }>;
 export declare function collabControlOperationCodec<Operation extends CollabControlOperation>(operation: Operation): CodecMap[Operation];
 export {};

package/dist/CollabControlOperationCodecs.js

@@ -2,13 +2,40 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.COLLAB_CONTROL_OPERATION_CODECS = void 0;
 exports.collabControlOperationCodec = collabControlOperationCodec;
+const CollabAuthorityTransfer_1 = require("./CollabAuthorityTransfer");
 const CollabError_1 = require("./CollabError");
+const CollabProjectRetirement_1 = require("./CollabProjectRetirement");
 const CollabRequestTicketRequestCodecs_1 = require("./CollabRequestTicketRequestCodecs");
 const CollabRequestTicketResponseCodecs_1 = require("./CollabRequestTicketResponseCodecs");
+const AUTHORITY_TRANSFER_OPERATION_SET = new Set(CollabAuthorityTransfer_1.COLLAB_AUTHORITY_TRANSFER_OPERATIONS);
+const PROJECT_RETIREMENT_OPERATION_SET = new Set(CollabProjectRetirement_1.COLLAB_PROJECT_RETIREMENT_OPERATIONS);
+function lifecycleDecodeResult(decode) {
+    try {
+        return { status: 'ok', value: decode() };
+    }
+    catch (error) {
+        if (error instanceof CollabError_1.CollabError && error.code === 'protocol-payload-invalid') {
+            return { error, status: 'invalid' };
+        }
+        throw error;
+    }
+}
 function decodeRequest(operation, input) {
+    if (AUTHORITY_TRANSFER_OPERATION_SET.has(operation)) {
+        return lifecycleDecodeResult(() => (0, CollabAuthorityTransfer_1.decodeCollabAuthorityTransferOperationRequest)(operation, input));
+    }
+    if (PROJECT_RETIREMENT_OPERATION_SET.has(operation)) {
+        return lifecycleDecodeResult(() => (0, CollabProjectRetirement_1.decodeCollabProjectRetirementOperationRequest)(operation, input));
+    }
     return (0, CollabRequestTicketRequestCodecs_1.decodeCollabRequestTicketOperationRequest)(operation, input);
 }
 function decodeResponse(operation, input) {
+    if (AUTHORITY_TRANSFER_OPERATION_SET.has(operation)) {
+        return (0, CollabAuthorityTransfer_1.decodeCollabAuthorityTransferOperationResponse)(operation, input);
+    }
+    if (PROJECT_RETIREMENT_OPERATION_SET.has(operation)) {
+        return (0, CollabProjectRetirement_1.decodeCollabProjectRetirementOperationResponse)(operation, input);
+    }
     switch (operation) {
         case 'getRequest': return (0, CollabRequestTicketResponseCodecs_1.decodeRequestDetailResponse)(input);
         case 'listRequestComments': return (0, CollabRequestTicketResponseCodecs_1.decodeCommentPageResponse)(input);
@@ -50,6 +77,23 @@ exports.COLLAB_CONTROL_OPERATION_CODECS = Object.freeze({
     reopenTicket: codec('reopenTicket'),
     updateMyRequestMetadata: codec('updateMyRequestMetadata'),
     acceptRequest: codec('acceptRequest'),
+    requestLanToCloudTransfer: codec('requestLanToCloudTransfer'),
+    acceptLanToCloudTransferTarget: codec('acceptLanToCloudTransferTarget'),
+    beginLanToCloudTransfer: codec('beginLanToCloudTransfer'),
+    getProjectAuthorityTransfer: codec('getProjectAuthorityTransfer'),
+    rotateTransferredMembershipClaims: codec('rotateTransferredMembershipClaims'),
+    acknowledgeTransferredMembershipClaimBatch: codec('acknowledgeTransferredMembershipClaimBatch'),
+    getTransferredMembershipClaim: codec('getTransferredMembershipClaim'),
+    claimTransferredMembership: codec('claimTransferredMembership'),
+    acknowledgeTransferredMembershipClaimRedemption: codec('acknowledgeTransferredMembershipClaimRedemption'),
+    commitLanToCloudRelinquishment: codec('commitLanToCloudRelinquishment'),
+    beginCloudToLanTransfer: codec('beginCloudToLanTransfer'),
+    acceptCloudToLanTransferTarget: codec('acceptCloudToLanTransferTarget'),
+    reportCloudToLanTargetStaged: codec('reportCloudToLanTargetStaged'),
+    confirmCloudToLanTargetActive: codec('confirmCloudToLanTargetActive'),
+    cancelProjectAuthorityTransfer: codec('cancelProjectAuthorityTransfer'),
+    retireProject: codec('retireProject'),
+    acknowledgeProjectRetirement: codec('acknowledgeProjectRetirement'),
 });
 function collabControlOperationCodec(operation) {
     if (!Object.hasOwn(exports.COLLAB_CONTROL_OPERATION_CODECS, operation)) {

package/dist/CollabError.d.ts

@@ -1,4 +1,4 @@
-export declare const COLLAB_ERROR_CODES: readonly ["protocol-version-unsupported", "protocol-payload-invalid", "project-not-found", "quota-exceeded", "authentication-failed", "authorization-denied", "membership-revoked", "stale-main", "stale-request-head", "personal-ref-diverged", "content-conflict", "description-required", "request-not-open", "request-head-not-pushed", "ticket-not-found", "resolving-ticket-reference-not-found", "ticket-not-open", "stale-ticket", "stale-request-metadata", "authority-not-synchronized", "idempotency-conflict", "acceptance-recovery-required", "authority-integrity-error", "operation-timeout", "operation-failed"];
+export declare const COLLAB_ERROR_CODES: readonly ["protocol-version-unsupported", "protocol-payload-invalid", "project-not-found", "quota-exceeded", "authentication-failed", "authorization-denied", "membership-revoked", "stale-main", "stale-request-head", "personal-ref-diverged", "content-conflict", "description-required", "request-not-open", "request-head-not-pushed", "ticket-not-found", "resolving-ticket-reference-not-found", "ticket-not-open", "stale-ticket", "stale-request-metadata", "authority-not-synchronized", "authority-transfer-not-found", "authority-transfer-stale", "authority-transfer-cancellation-forbidden", "membership-claim-invalid", "membership-claim-expired", "membership-claim-revoked", "membership-claim-already-redeemed", "project-retired", "idempotency-conflict", "acceptance-recovery-required", "authority-integrity-error", "operation-timeout", "operation-failed"];
 export type CollabErrorCode = typeof COLLAB_ERROR_CODES[number];
 export type CollabErrorGroup = 'setup' | 'path' | 'authorization' | 'state' | 'integrity' | 'operation';
 declare const COLLAB_RECOVERY_ACTIONS: readonly ["retry", "review-conflicts", "request-access"];

package/dist/CollabError.js

@@ -24,6 +24,14 @@ exports.COLLAB_ERROR_CODES = Object.freeze([
     'stale-ticket',
     'stale-request-metadata',
     'authority-not-synchronized',
+    'authority-transfer-not-found',
+    'authority-transfer-stale',
+    'authority-transfer-cancellation-forbidden',
+    'membership-claim-invalid',
+    'membership-claim-expired',
+    'membership-claim-revoked',
+    'membership-claim-already-redeemed',
+    'project-retired',
     'idempotency-conflict',
     'acceptance-recovery-required',
     'authority-integrity-error',
@@ -95,11 +103,15 @@ function collabErrorGroup(code) {
         case 'protocol-payload-invalid':
             return 'setup';
         case 'project-not-found':
+        case 'authority-transfer-not-found':
         case 'quota-exceeded':
             return 'path';
         case 'authentication-failed':
         case 'authorization-denied':
         case 'membership-revoked':
+        case 'membership-claim-invalid':
+        case 'membership-claim-expired':
+        case 'membership-claim-revoked':
             return 'authorization';
         case 'stale-main':
         case 'stale-request-head':
@@ -114,6 +126,10 @@ function collabErrorGroup(code) {
         case 'stale-ticket':
         case 'stale-request-metadata':
         case 'authority-not-synchronized':
+        case 'authority-transfer-stale':
+        case 'authority-transfer-cancellation-forbidden':
+        case 'membership-claim-already-redeemed':
+        case 'project-retired':
         case 'idempotency-conflict':
             return 'state';
         case 'acceptance-recovery-required':