@canonmsg/backend-contracts 6.4.0 → 8.0.0

package/dist/cjs/contactRequest.js

@@ -1,163 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readContactRequestRequirements = readContactRequestRequirements;
-exports.readGroupInviteRequirements = readGroupInviteRequirements;
-exports.deriveContactRequestPhase = deriveContactRequestPhase;
-exports.serializeContactRequest = serializeContactRequest;
-function readContactRequestRequirements(value) {
-    const record = isRecord(value) ? value : null;
-    if (typeof record?.policyApproval !== 'boolean'
-        || typeof record.ownerSessionSetup !== 'boolean') {
-        throw new TypeError('Invalid contact request requirements');
-    }
-    return {
-        policyApproval: record.policyApproval,
-        ownerSessionSetup: record.ownerSessionSetup,
-    };
-}
-/** Backward-compatible parser retained for existing group invite clients. */
-function readGroupInviteRequirements(value) {
-    try {
-        return readContactRequestRequirements(value);
-    }
-    catch {
-        throw new TypeError('Invalid group invite requirements');
-    }
-}
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function normalizeTimestamp(value) {
-    if (value instanceof Date)
-        return value.toISOString();
-    if (isRecord(value) && typeof value.toDate === 'function') {
-        const result = value.toDate();
-        if (result instanceof Date)
-            return result.toISOString();
-    }
-    return null;
-}
-function normalizeStatus(value) {
-    if (value === 'pending'
-        || value === 'approved'
-        || value === 'rejected'
-        || value === 'expired'
-        || value === 'cancelled') {
-        return value;
-    }
-    return 'pending';
-}
-function deriveContactRequestPhase(data) {
-    const status = data.status;
-    const openingStatus = data.openingMessageStatus;
-    let phase;
-    if (status === 'cancelled')
-        phase = 'cancelled';
-    else if (status === 'rejected')
-        phase = 'rejected';
-    else if (status === 'expired')
-        phase = 'expired';
-    else if (status === 'delivery_failed' || openingStatus === 'failed')
-        phase = 'failed';
-    else if (status === 'approved')
-        phase = 'connected';
-    else if (status === 'delivery_pending'
-        || openingStatus === 'ready'
-        || openingStatus === 'delivering'
-        || openingStatus === 'retryable')
-        phase = 'starting';
-    else
-        phase = 'awaiting_owner';
-    return phase;
-}
-function serializeContactRequest(requestId, data, options = {}) {
-    if (typeof data.approverId !== 'string' || data.approverId.length === 0) {
-        return null;
-    }
-    if (typeof data.requesterId !== 'string' || data.requesterId.length === 0) {
-        return null;
-    }
-    if (typeof data.targetId !== 'string' || data.targetId.length === 0) {
-        return null;
-    }
-    if (typeof data.targetName !== 'string' || data.targetName.trim().length === 0) {
-        return null;
-    }
-    if (data.targetAvatarUrl !== null && data.targetAvatarUrl !== undefined && typeof data.targetAvatarUrl !== 'string') {
-        return null;
-    }
-    if (data.targetUserType !== 'human' && data.targetUserType !== 'ai_agent') {
-        return null;
-    }
-    if (data.targetUserType === 'ai_agent'
-        && (typeof data.targetOwnerId !== 'string' || data.targetOwnerId.length === 0)) {
-        return null;
-    }
-    const kindValue = typeof data.kind === 'string' ? data.kind : null;
-    if (kindValue !== 'dm' && kindValue !== 'group_invite') {
-        return null;
-    }
-    let groupContext = null;
-    if (kindValue === 'group_invite') {
-        const ctx = isRecord(data.groupContext) ? data.groupContext : null;
-        const conversationId = typeof ctx?.conversationId === 'string'
-            ? ctx.conversationId.trim()
-            : '';
-        if (!conversationId) {
-            return null;
-        }
-        groupContext = {
-            conversationId,
-            groupName: typeof ctx?.groupName === 'string' ? ctx.groupName : null,
-        };
-    }
-    const payload = {
-        id: requestId,
-        requesterId: data.requesterId,
-        requesterName: typeof data.requesterName === 'string' ? data.requesterName : 'Unknown',
-        requesterAvatarUrl: typeof data.requesterAvatarUrl === 'string' ? data.requesterAvatarUrl : null,
-        targetId: data.targetId,
-        targetName: data.targetName.trim(),
-        targetAvatarUrl: typeof data.targetAvatarUrl === 'string' ? data.targetAvatarUrl : null,
-        targetUserType: data.targetUserType,
-        approverId: data.approverId,
-        // Free-form request content is owner-review material. This shared DTO is
-        // delivered to the target agent over REST/SSE, so it must never cross the
-        // admission boundary before the human approver accepts the reach-out.
-        message: null,
-        status: normalizeStatus(data.status),
-        kind: kindValue,
-        phase: deriveContactRequestPhase(data),
-        createdAt: normalizeTimestamp(data.createdAt),
-        resolvedAt: normalizeTimestamp(data.resolvedAt),
-        expiresAt: normalizeTimestamp(data.expiresAt),
-    };
-    if (groupContext || kindValue === 'dm') {
-        let requirements;
-        try {
-            requirements = data.requirements === undefined && kindValue === 'dm'
-                ? { policyApproval: true, ownerSessionSetup: false }
-                : readContactRequestRequirements(data.requirements);
-        }
-        catch {
-            return null;
-        }
-        payload.requirements = requirements;
-    }
-    if (groupContext)
-        payload.groupContext = groupContext;
-    if (options.audience === 'requester') {
-        if (typeof data.sourceConversationId === 'string' && data.sourceConversationId.length > 0) {
-            payload.sourceConversationId = data.sourceConversationId;
-        }
-        if (payload.phase === 'connected'
-            && typeof data.openingMessageConversationId === 'string'
-            && data.openingMessageConversationId.length > 0) {
-            payload.conversationId = data.openingMessageConversationId;
-        }
-    }
-    if (data.targetUserType === 'ai_agent') {
-        payload.targetOwnerId = data.targetOwnerId;
-    }
-    return payload;
-}

package/dist/contactRequest.d.ts

@@ -1,50 +0,0 @@
-export type SerializedContactRequestStatus = 'pending' | 'approved' | 'rejected' | 'expired' | 'cancelled';
-export type ContactRequestLifecyclePhase = 'awaiting_owner' | 'starting' | 'connected' | 'rejected' | 'expired' | 'cancelled' | 'failed';
-/**
- * Independent gates that must be satisfied before a pending contact request
- * can activate. DM introductions and group invites share this owner-review
- * vocabulary even though their activation pipelines remain separate.
- */
-export interface ContactRequestRequirements {
-    policyApproval: boolean;
-    ownerSessionSetup: boolean;
-}
-/** Backward-compatible name retained for existing group invite clients. */
-export type GroupInviteRequirements = ContactRequestRequirements;
-export declare function readContactRequestRequirements(value: unknown): ContactRequestRequirements;
-/** Backward-compatible parser retained for existing group invite clients. */
-export declare function readGroupInviteRequirements(value: unknown): GroupInviteRequirements;
-export interface SerializedContactRequest {
-    id: string;
-    requesterId: string;
-    requesterName: string;
-    requesterAvatarUrl: string | null;
-    targetId: string;
-    targetName: string;
-    targetAvatarUrl: string | null;
-    targetUserType: 'human' | 'ai_agent';
-    targetOwnerId?: string | null;
-    approverId: string;
-    /** Always null on agent-facing DTOs; free-form content stays in authorized review storage. */
-    message: string | null;
-    status: SerializedContactRequestStatus;
-    kind: 'dm' | 'group_invite';
-    groupContext?: {
-        conversationId: string;
-        groupName: string | null;
-    };
-    /** Present for group invites and setup/policy-aware DM introductions. */
-    requirements?: ContactRequestRequirements;
-    phase: ContactRequestLifecyclePhase;
-    /** Requester-only source lane for an opener-backed introduction. */
-    sourceConversationId?: string;
-    /** Requester-only destination, present after an opener-backed DM connects. */
-    conversationId?: string;
-    createdAt: string | null;
-    resolvedAt?: string | null;
-    expiresAt?: string | null;
-}
-export declare function deriveContactRequestPhase(data: Record<string, unknown>): ContactRequestLifecyclePhase;
-export declare function serializeContactRequest(requestId: string, data: Record<string, unknown>, options?: {
-    audience?: 'inbound' | 'requester';
-}): SerializedContactRequest | null;

package/dist/contactRequest.js

@@ -1,157 +0,0 @@
-export function readContactRequestRequirements(value) {
-    const record = isRecord(value) ? value : null;
-    if (typeof record?.policyApproval !== 'boolean'
-        || typeof record.ownerSessionSetup !== 'boolean') {
-        throw new TypeError('Invalid contact request requirements');
-    }
-    return {
-        policyApproval: record.policyApproval,
-        ownerSessionSetup: record.ownerSessionSetup,
-    };
-}
-/** Backward-compatible parser retained for existing group invite clients. */
-export function readGroupInviteRequirements(value) {
-    try {
-        return readContactRequestRequirements(value);
-    }
-    catch {
-        throw new TypeError('Invalid group invite requirements');
-    }
-}
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function normalizeTimestamp(value) {
-    if (value instanceof Date)
-        return value.toISOString();
-    if (isRecord(value) && typeof value.toDate === 'function') {
-        const result = value.toDate();
-        if (result instanceof Date)
-            return result.toISOString();
-    }
-    return null;
-}
-function normalizeStatus(value) {
-    if (value === 'pending'
-        || value === 'approved'
-        || value === 'rejected'
-        || value === 'expired'
-        || value === 'cancelled') {
-        return value;
-    }
-    return 'pending';
-}
-export function deriveContactRequestPhase(data) {
-    const status = data.status;
-    const openingStatus = data.openingMessageStatus;
-    let phase;
-    if (status === 'cancelled')
-        phase = 'cancelled';
-    else if (status === 'rejected')
-        phase = 'rejected';
-    else if (status === 'expired')
-        phase = 'expired';
-    else if (status === 'delivery_failed' || openingStatus === 'failed')
-        phase = 'failed';
-    else if (status === 'approved')
-        phase = 'connected';
-    else if (status === 'delivery_pending'
-        || openingStatus === 'ready'
-        || openingStatus === 'delivering'
-        || openingStatus === 'retryable')
-        phase = 'starting';
-    else
-        phase = 'awaiting_owner';
-    return phase;
-}
-export function serializeContactRequest(requestId, data, options = {}) {
-    if (typeof data.approverId !== 'string' || data.approverId.length === 0) {
-        return null;
-    }
-    if (typeof data.requesterId !== 'string' || data.requesterId.length === 0) {
-        return null;
-    }
-    if (typeof data.targetId !== 'string' || data.targetId.length === 0) {
-        return null;
-    }
-    if (typeof data.targetName !== 'string' || data.targetName.trim().length === 0) {
-        return null;
-    }
-    if (data.targetAvatarUrl !== null && data.targetAvatarUrl !== undefined && typeof data.targetAvatarUrl !== 'string') {
-        return null;
-    }
-    if (data.targetUserType !== 'human' && data.targetUserType !== 'ai_agent') {
-        return null;
-    }
-    if (data.targetUserType === 'ai_agent'
-        && (typeof data.targetOwnerId !== 'string' || data.targetOwnerId.length === 0)) {
-        return null;
-    }
-    const kindValue = typeof data.kind === 'string' ? data.kind : null;
-    if (kindValue !== 'dm' && kindValue !== 'group_invite') {
-        return null;
-    }
-    let groupContext = null;
-    if (kindValue === 'group_invite') {
-        const ctx = isRecord(data.groupContext) ? data.groupContext : null;
-        const conversationId = typeof ctx?.conversationId === 'string'
-            ? ctx.conversationId.trim()
-            : '';
-        if (!conversationId) {
-            return null;
-        }
-        groupContext = {
-            conversationId,
-            groupName: typeof ctx?.groupName === 'string' ? ctx.groupName : null,
-        };
-    }
-    const payload = {
-        id: requestId,
-        requesterId: data.requesterId,
-        requesterName: typeof data.requesterName === 'string' ? data.requesterName : 'Unknown',
-        requesterAvatarUrl: typeof data.requesterAvatarUrl === 'string' ? data.requesterAvatarUrl : null,
-        targetId: data.targetId,
-        targetName: data.targetName.trim(),
-        targetAvatarUrl: typeof data.targetAvatarUrl === 'string' ? data.targetAvatarUrl : null,
-        targetUserType: data.targetUserType,
-        approverId: data.approverId,
-        // Free-form request content is owner-review material. This shared DTO is
-        // delivered to the target agent over REST/SSE, so it must never cross the
-        // admission boundary before the human approver accepts the reach-out.
-        message: null,
-        status: normalizeStatus(data.status),
-        kind: kindValue,
-        phase: deriveContactRequestPhase(data),
-        createdAt: normalizeTimestamp(data.createdAt),
-        resolvedAt: normalizeTimestamp(data.resolvedAt),
-        expiresAt: normalizeTimestamp(data.expiresAt),
-    };
-    if (groupContext || kindValue === 'dm') {
-        let requirements;
-        try {
-            requirements = data.requirements === undefined && kindValue === 'dm'
-                ? { policyApproval: true, ownerSessionSetup: false }
-                : readContactRequestRequirements(data.requirements);
-        }
-        catch {
-            return null;
-        }
-        payload.requirements = requirements;
-    }
-    if (groupContext)
-        payload.groupContext = groupContext;
-    if (options.audience === 'requester') {
-        if (typeof data.sourceConversationId === 'string' && data.sourceConversationId.length > 0) {
-            payload.sourceConversationId = data.sourceConversationId;
-        }
-        if (payload.phase === 'connected'
-            && typeof data.openingMessageConversationId === 'string'
-            && data.openingMessageConversationId.length > 0) {
-            payload.conversationId = data.openingMessageConversationId;
-        }
-    }
-    if (data.targetUserType === 'ai_agent') {
-        payload.targetOwnerId = data.targetOwnerId;
-    }
-    return payload;
-}