@portel/photon-core 1.4.0 → 2.1.0

package/dist/ucp/manifest.js

@@ -0,0 +1,180 @@
+/**
+ * UCP Manifest Generator
+ *
+ * Auto-generates /.well-known/ucp manifest from Photon class metadata.
+ */
+/**
+ * Generate UCP manifest from parameters
+ */
+export function generateUCPManifest(params) {
+    const { merchantId, merchantName, merchantLogo, supportUrl, capabilities, paymentHandlers = ['stripe'], supportedCurrencies = ['USD'], supportedCountries = ['US'], baseUrl = '', mcpServerName } = params;
+    const capabilityConfigs = {
+        checkout: {
+            supported: capabilities.includes('checkout'),
+            endpoint: capabilities.includes('checkout') ? `${baseUrl}/ucp/checkout` : undefined,
+            webhooks: false
+        },
+        identity: {
+            supported: capabilities.includes('identity'),
+            endpoint: capabilities.includes('identity') ? `${baseUrl}/ucp/identity` : undefined
+        },
+        order: {
+            supported: capabilities.includes('order'),
+            endpoint: capabilities.includes('order') ? `${baseUrl}/ucp/order` : undefined,
+            webhooks: capabilities.includes('order')
+        },
+        payment_token_exchange: {
+            supported: capabilities.includes('payment_token_exchange'),
+            endpoint: capabilities.includes('payment_token_exchange')
+                ? `${baseUrl}/ucp/payment-token`
+                : undefined
+        }
+    };
+    const manifest = {
+        ucp_version: '1.0',
+        merchant: {
+            id: merchantId,
+            name: merchantName,
+            logo: merchantLogo,
+            supportUrl
+        },
+        capabilities: capabilityConfigs,
+        payment_handlers: paymentHandlers,
+        supported_currencies: supportedCurrencies,
+        supported_countries: supportedCountries
+    };
+    // Add OAuth config if identity capability is enabled
+    if (capabilities.includes('identity')) {
+        manifest.oauth = {
+            authorizationEndpoint: `${baseUrl}/oauth/authorize`,
+            tokenEndpoint: `${baseUrl}/oauth/token`,
+            revocationEndpoint: `${baseUrl}/oauth/revoke`,
+            scopes: ['checkout.read', 'checkout.write', 'order.read', 'order.write']
+        };
+    }
+    // Add MCP config if server name provided
+    if (mcpServerName) {
+        manifest.mcp = {
+            server_name: mcpServerName,
+            tools_prefix: 'ucp'
+        };
+    }
+    return manifest;
+}
+// ============================================================================
+// JSDoc Annotation Parsing
+// ============================================================================
+/**
+ * Parse UCP metadata from JSDoc annotations
+ *
+ * Supports:
+ * - @ucp - Enable UCP for class
+ * - @capability checkout|identity|order|payment_token_exchange
+ * - @ucp.merchant.id <id>
+ * - @ucp.merchant.name <name>
+ * - @ucp.operation <capability>.<operation>
+ */
+export function parseUCPAnnotations(jsdoc) {
+    // Check if @ucp is present
+    if (!/@ucp\b/.test(jsdoc)) {
+        return null;
+    }
+    const capabilities = [];
+    // Parse @capability annotations
+    const capabilityMatches = jsdoc.matchAll(/@capability\s+(checkout|identity|order|payment_token_exchange)/g);
+    for (const match of capabilityMatches) {
+        capabilities.push(match[1]);
+    }
+    // Parse merchant info
+    const merchantIdMatch = jsdoc.match(/@ucp\.merchant\.id\s+(\S+)/);
+    const merchantNameMatch = jsdoc.match(/@ucp\.merchant\.name\s+(.+?)(?:\n|$)/);
+    return {
+        enabled: true,
+        capabilities,
+        merchantId: merchantIdMatch?.[1],
+        merchantName: merchantNameMatch?.[1]?.trim()
+    };
+}
+/**
+ * Parse UCP operation from method JSDoc
+ */
+export function parseUCPMethodAnnotation(jsdoc) {
+    const match = jsdoc.match(/@ucp\.operation\s+(checkout|identity|order|payment_token_exchange)\.(\w+)/);
+    if (!match)
+        return null;
+    return {
+        capability: match[1],
+        operation: match[2]
+    };
+}
+/**
+ * Extract UCP manifest from class schema
+ */
+export function extractManifestFromSchema(params) {
+    const { className, classJsdoc, methods, baseUrl } = params;
+    const ucpMeta = parseUCPAnnotations(classJsdoc);
+    if (!ucpMeta)
+        return null;
+    // Auto-detect capabilities from method annotations if not explicitly declared
+    const detectedCapabilities = new Set(ucpMeta.capabilities);
+    for (const method of methods) {
+        const methodMeta = parseUCPMethodAnnotation(method.jsdoc);
+        if (methodMeta) {
+            detectedCapabilities.add(methodMeta.capability);
+        }
+    }
+    // Also detect from method names
+    const methodNames = methods.map(m => m.name.toLowerCase());
+    if (methodNames.some(n => n.includes('checkout') || n.includes('cart'))) {
+        detectedCapabilities.add('checkout');
+    }
+    if (methodNames.some(n => n.includes('order') || n.includes('shipment') || n.includes('return'))) {
+        detectedCapabilities.add('order');
+    }
+    if (methodNames.some(n => n.includes('oauth') || n.includes('authorize') || n.includes('identity'))) {
+        detectedCapabilities.add('identity');
+    }
+    return generateUCPManifest({
+        merchantId: ucpMeta.merchantId || className.toLowerCase().replace(/[^a-z0-9]/g, '-'),
+        merchantName: ucpMeta.merchantName || className,
+        capabilities: Array.from(detectedCapabilities),
+        baseUrl,
+        mcpServerName: className
+    });
+}
+// ============================================================================
+// Well-Known Response
+// ============================================================================
+/**
+ * Generate the /.well-known/ucp response
+ */
+export function generateWellKnownResponse(manifest) {
+    return JSON.stringify(manifest, null, 2);
+}
+/**
+ * Validate UCP manifest
+ */
+export function validateManifest(manifest) {
+    const errors = [];
+    if (!manifest.ucp_version) {
+        errors.push('Missing ucp_version');
+    }
+    if (!manifest.merchant?.id) {
+        errors.push('Missing merchant.id');
+    }
+    if (!manifest.merchant?.name) {
+        errors.push('Missing merchant.name');
+    }
+    const hasAnyCapability = Object.values(manifest.capabilities).some(c => c.supported);
+    if (!hasAnyCapability) {
+        errors.push('At least one capability must be supported');
+    }
+    if (manifest.payment_handlers.length === 0) {
+        errors.push('At least one payment handler must be specified');
+    }
+    return {
+        valid: errors.length === 0,
+        errors
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/ucp/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/ucp/manifest.ts"],"names":[],"mappings":"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"}

package/dist/ucp/types.d.ts

@@ -0,0 +1,327 @@
+/**
+ * Universal Commerce Protocol (UCP) Type Definitions
+ *
+ * Based on UCP specification from https://ucp.dev/
+ * Compatible with MCP transport for Photon integration.
+ */
+export interface Money {
+    amount: number;
+    currency: string;
+}
+export interface Address {
+    name?: string;
+    organization?: string;
+    addressLine1: string;
+    addressLine2?: string;
+    city: string;
+    region?: string;
+    postalCode: string;
+    country: string;
+    phone?: string;
+}
+export interface BuyerInfo {
+    email: string;
+    name?: string;
+    phone?: string;
+    billingAddress?: Address;
+}
+export type CheckoutSessionStatus = 'open' | 'ready_for_complete' | 'processing' | 'completed' | 'expired' | 'cancelled';
+export interface LineItem {
+    id: string;
+    sku?: string;
+    label: string;
+    description?: string;
+    quantity: number;
+    unitPrice: Money;
+    totalPrice: Money;
+    productUrl?: string;
+    imageUrl?: string;
+    metadata?: Record<string, any>;
+}
+export interface DiscountAllocation {
+    code: string;
+    label: string;
+    type: 'percentage' | 'fixed' | 'free_shipping';
+    value: number;
+    appliedAmount: Money;
+    lineItemAllocations?: {
+        lineItemId: string;
+        amount: Money;
+    }[];
+}
+export interface TaxLine {
+    label: string;
+    rate: number;
+    amount: Money;
+}
+export interface Totals {
+    subtotal: Money;
+    discounts: Money;
+    shipping: Money;
+    tax: Money;
+    total: Money;
+    taxLines?: TaxLine[];
+}
+export interface FulfillmentOption {
+    id: string;
+    label: string;
+    description?: string;
+    carrier?: string;
+    estimatedDelivery?: string;
+    price: Money;
+}
+export interface FulfillmentDestination {
+    type: 'shipping' | 'pickup' | 'digital';
+    address?: Address;
+    pickupLocation?: {
+        id: string;
+        name: string;
+        address: Address;
+    };
+}
+export interface PaymentMethodInfo {
+    id: string;
+    type: 'card' | 'bank_transfer' | 'wallet' | 'crypto' | 'other';
+    label: string;
+    icon?: string;
+    lastFour?: string;
+    expiryMonth?: number;
+    expiryYear?: number;
+}
+export interface CheckoutSession {
+    id: string;
+    merchantId: string;
+    status: CheckoutSessionStatus;
+    createdAt: string;
+    updatedAt: string;
+    expiresAt: string;
+    buyer?: BuyerInfo;
+    lineItems: LineItem[];
+    discounts: DiscountAllocation[];
+    fulfillmentOptions: FulfillmentOption[];
+    selectedFulfillment?: {
+        optionId: string;
+        destination: FulfillmentDestination;
+    };
+    availablePaymentMethods: PaymentMethodInfo[];
+    selectedPaymentMethod?: PaymentMethodInfo;
+    totals: Totals;
+    metadata?: Record<string, any>;
+}
+export type OrderStatus = 'pending' | 'confirmed' | 'processing' | 'shipped' | 'delivered' | 'cancelled' | 'refunded';
+export type ShipmentStatus = 'label_created' | 'picked_up' | 'in_transit' | 'out_for_delivery' | 'delivered' | 'failed_delivery' | 'returned';
+export interface TrackingEvent {
+    timestamp: string;
+    status: ShipmentStatus;
+    location?: string;
+    description: string;
+}
+export interface Shipment {
+    id: string;
+    carrier: string;
+    trackingNumber: string;
+    trackingUrl?: string;
+    status: ShipmentStatus;
+    estimatedDelivery?: string;
+    events: TrackingEvent[];
+    lineItemIds: string[];
+}
+export interface FulfillmentExpectation {
+    id: string;
+    type: 'shipping' | 'pickup' | 'digital';
+    description: string;
+    estimatedDate?: string;
+    lineItemIds: string[];
+}
+export interface Adjustment {
+    id: string;
+    type: 'refund' | 'partial_refund' | 'price_adjustment' | 'return';
+    amount: Money;
+    reason: string;
+    createdAt: string;
+    lineItemIds?: string[];
+}
+export interface ReturnRequest {
+    id: string;
+    status: 'requested' | 'approved' | 'rejected' | 'received' | 'refunded';
+    items: {
+        lineItemId: string;
+        quantity: number;
+        reason: string;
+    }[];
+    createdAt: string;
+    updatedAt: string;
+    refundAmount?: Money;
+    returnLabel?: {
+        carrier: string;
+        trackingNumber: string;
+        labelUrl: string;
+    };
+}
+export interface Order {
+    id: string;
+    checkoutSessionId: string;
+    merchantId: string;
+    status: OrderStatus;
+    createdAt: string;
+    updatedAt: string;
+    buyer: BuyerInfo;
+    lineItems: LineItem[];
+    fulfillmentExpectations: FulfillmentExpectation[];
+    shipments: Shipment[];
+    paymentMethod: PaymentMethodInfo;
+    paymentStatus: 'pending' | 'authorized' | 'captured' | 'refunded' | 'failed';
+    totals: Totals;
+    adjustments: Adjustment[];
+    returns: ReturnRequest[];
+    metadata?: Record<string, any>;
+}
+export interface OAuthConfig {
+    authorizationEndpoint: string;
+    tokenEndpoint: string;
+    revocationEndpoint?: string;
+    scopes: string[];
+}
+export interface TokenResponse {
+    accessToken: string;
+    tokenType: string;
+    expiresIn: number;
+    refreshToken?: string;
+    scope: string;
+}
+export interface IdentityLink {
+    id: string;
+    agentId: string;
+    userId: string;
+    scopes: string[];
+    createdAt: string;
+    expiresAt?: string;
+}
+export type WebhookEventType = 'checkout.created' | 'checkout.updated' | 'checkout.completed' | 'order.created' | 'order.updated' | 'order.cancelled' | 'shipment.created' | 'shipment.updated' | 'delivery.completed' | 'return.requested' | 'return.approved' | 'refund.created';
+export interface WebhookRegistration {
+    id: string;
+    url: string;
+    events: WebhookEventType[];
+    secret: string;
+    active: boolean;
+    createdAt: string;
+}
+export interface WebhookPayload {
+    id: string;
+    type: WebhookEventType;
+    timestamp: string;
+    data: any;
+}
+export type UCPCapability = 'checkout' | 'identity' | 'order' | 'payment_token_exchange';
+export interface UCPCapabilityConfig {
+    supported: boolean;
+    endpoint?: string;
+    webhooks?: boolean;
+    extensions?: string[];
+}
+export interface UCPManifest {
+    ucp_version: string;
+    merchant: {
+        id: string;
+        name: string;
+        logo?: string;
+        supportUrl?: string;
+    };
+    capabilities: Record<UCPCapability, UCPCapabilityConfig>;
+    payment_handlers: string[];
+    supported_currencies: string[];
+    supported_countries: string[];
+    oauth?: OAuthConfig;
+    mcp?: {
+        server_name: string;
+        tools_prefix?: string;
+    };
+}
+export interface CheckoutCapability {
+    createSession(params: {
+        currency?: string;
+        locale?: string;
+        metadata?: Record<string, any>;
+    }): Promise<CheckoutSession>;
+    getSession(sessionId: string): Promise<CheckoutSession>;
+    updateCart(sessionId: string, updates: {
+        add?: Omit<LineItem, 'id' | 'totalPrice'>[];
+        remove?: string[];
+        update?: {
+            id: string;
+            quantity: number;
+        }[];
+    }): Promise<CheckoutSession>;
+    setBuyer(sessionId: string, buyer: BuyerInfo): Promise<CheckoutSession>;
+    setFulfillment(sessionId: string, params: {
+        optionId: string;
+        destination: FulfillmentDestination;
+    }): Promise<CheckoutSession>;
+    applyDiscount(sessionId: string, code: string): Promise<{
+        success: boolean;
+        session: CheckoutSession;
+        error?: string;
+    }>;
+    removeDiscount(sessionId: string, code: string): Promise<CheckoutSession>;
+    complete(sessionId: string, payment: {
+        methodId?: string;
+        mandate?: any;
+    }): Promise<Order>;
+}
+export interface IdentityCapability {
+    getOAuthConfig(): Promise<OAuthConfig>;
+    requestAuthorization(params: {
+        agentId: string;
+        scopes: string[];
+        redirectUri: string;
+        state?: string;
+    }): Promise<{
+        authorizationUrl: string;
+    }>;
+    exchangeCode(params: {
+        code: string;
+        redirectUri: string;
+    }): Promise<TokenResponse>;
+    refreshToken(refreshToken: string): Promise<TokenResponse>;
+    revokeToken(token: string): Promise<void>;
+    getIdentityLink(agentId: string): Promise<IdentityLink | null>;
+}
+export interface OrderCapability {
+    getOrder(orderId: string): Promise<Order>;
+    listOrders(params?: {
+        status?: OrderStatus[];
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        orders: Order[];
+        nextCursor?: string;
+    }>;
+    cancelOrder(orderId: string, reason?: string): Promise<Order>;
+    trackShipment(orderId: string, shipmentId?: string): Promise<Shipment[]>;
+    initiateReturn(orderId: string, params: {
+        items: {
+            lineItemId: string;
+            quantity: number;
+            reason: string;
+        }[];
+    }): Promise<ReturnRequest>;
+    getReturn(orderId: string, returnId: string): Promise<ReturnRequest>;
+    registerWebhook(params: {
+        url: string;
+        events: WebhookEventType[];
+        secret: string;
+    }): Promise<WebhookRegistration>;
+    listWebhooks(): Promise<WebhookRegistration[]>;
+    deleteWebhook(webhookId: string): Promise<void>;
+}
+export interface UCPMetadata {
+    enabled: boolean;
+    capabilities: UCPCapability[];
+    merchantId?: string;
+    merchantName?: string;
+}
+export interface UCPMethodMetadata {
+    capability: UCPCapability;
+    operation: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ucp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ucp/types.ts"],"names":[],"mappings":"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"}

package/dist/ucp/types.js

@@ -0,0 +1,8 @@
+/**
+ * Universal Commerce Protocol (UCP) Type Definitions
+ *
+ * Based on UCP specification from https://ucp.dev/
+ * Compatible with MCP transport for Photon integration.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ucp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ucp/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@portel/photon-core",
-  "version": "1.4.0",
+  "version": "2.1.0",
   "description": "Core library for parsing, loading, and managing .photon.ts files - runtime-agnostic foundation for building custom Photon runtimes",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -49,9 +49,8 @@
   },
   "homepage": "https://github.com/portel-dev/photon-core#readme",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.1",
-    "chalk": "^5.6.2",
-    "cli-highlight": "^2.1.11",
+    "@portel/cli": "^1.0.0",
+    "@portel/mcp": "^1.0.0",
     "typescript": "^5.7.2"
   },
   "devDependencies": {