@canonmsg/backend-contracts 7.0.0 → 8.0.0

package/dist/cjs/accessPolicy.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readCanonicalPolicy = readCanonicalPolicy;
-/**
- * Read a stored policy field, defaulting to the value Canon assigns on account
- * creation. Anything unrecognized — missing, misspelled, or the retired
- * `'private'` enum — reads as 'approval-required'. This must never widen to
- * 'open'.
- */
-function readCanonicalPolicy(value) {
-    if (value === 'open' || value === 'approval-required' || value === 'owner-only') {
-        return value;
-    }
-    return 'approval-required';
-}

package/dist/cjs/contactRequest.js

@@ -1,114 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readGroupInviteRequirements = readGroupInviteRequirements;
-exports.serializeContactRequest = serializeContactRequest;
-function readGroupInviteRequirements(value) {
-    const record = isRecord(value) ? value : null;
-    if (typeof record?.policyApproval !== 'boolean'
-        || typeof record.ownerSessionSetup !== 'boolean') {
-        throw new TypeError('Invalid group invite requirements');
-    }
-    return {
-        policyApproval: record.policyApproval,
-        ownerSessionSetup: record.ownerSessionSetup,
-    };
-}
-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') {
-        return value;
-    }
-    return 'pending';
-}
-function serializeContactRequest(requestId, data) {
-    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,
-        createdAt: normalizeTimestamp(data.createdAt),
-        resolvedAt: normalizeTimestamp(data.resolvedAt),
-        expiresAt: normalizeTimestamp(data.expiresAt),
-    };
-    if (groupContext) {
-        let requirements;
-        try {
-            requirements = readGroupInviteRequirements(data.requirements);
-        }
-        catch {
-            return null;
-        }
-        payload.groupContext = groupContext;
-        payload.requirements = requirements;
-    }
-    if (data.targetUserType === 'ai_agent') {
-        payload.targetOwnerId = data.targetOwnerId;
-    }
-    return payload;
-}

package/dist/contactRequest.d.ts

@@ -1,36 +0,0 @@
-export type SerializedContactRequestStatus = 'pending' | 'approved' | 'rejected' | 'expired';
-/**
- * Independent gates that must be satisfied before a pending group invite can
- * add its target.
- */
-export interface GroupInviteRequirements {
-    policyApproval: boolean;
-    ownerSessionSetup: boolean;
-}
-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_invite payloads; omitted for DM requests. */
-    requirements?: GroupInviteRequirements;
-    createdAt: string | null;
-    resolvedAt?: string | null;
-    expiresAt?: string | null;
-}
-export declare function serializeContactRequest(requestId: string, data: Record<string, unknown>): SerializedContactRequest | null;

package/dist/contactRequest.js

@@ -1,110 +0,0 @@
-export function readGroupInviteRequirements(value) {
-    const record = isRecord(value) ? value : null;
-    if (typeof record?.policyApproval !== 'boolean'
-        || typeof record.ownerSessionSetup !== 'boolean') {
-        throw new TypeError('Invalid group invite requirements');
-    }
-    return {
-        policyApproval: record.policyApproval,
-        ownerSessionSetup: record.ownerSessionSetup,
-    };
-}
-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') {
-        return value;
-    }
-    return 'pending';
-}
-export function serializeContactRequest(requestId, data) {
-    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,
-        createdAt: normalizeTimestamp(data.createdAt),
-        resolvedAt: normalizeTimestamp(data.resolvedAt),
-        expiresAt: normalizeTimestamp(data.expiresAt),
-    };
-    if (groupContext) {
-        let requirements;
-        try {
-            requirements = readGroupInviteRequirements(data.requirements);
-        }
-        catch {
-            return null;
-        }
-        payload.groupContext = groupContext;
-        payload.requirements = requirements;
-    }
-    if (data.targetUserType === 'ai_agent') {
-        payload.targetOwnerId = data.targetOwnerId;
-    }
-    return payload;
-}