@acorex-platform/extension-communication-meta-client 0.0.21

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@acorex-platform/extension-communication-meta-client",
+  "version": "0.0.21",
+  "sideEffects": false,
+  "peerDependencies": {
+    "@angular/common": "^21.0.0",
+    "@angular/core": "^21.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "module": "fesm2022/acorex-platform-extension-communication-meta-client.mjs",
+  "typings": "types/acorex-platform-extension-communication-meta-client.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/acorex-platform-extension-communication-meta-client.d.ts",
+      "default": "./fesm2022/acorex-platform-extension-communication-meta-client.mjs"
+    },
+    "./contracts": {
+      "types": "./types/acorex-platform-extension-communication-meta-client-contracts.d.ts",
+      "default": "./fesm2022/acorex-platform-extension-communication-meta-client-contracts.mjs"
+    }
+  },
+  "type": "module"
+}

package/types/acorex-platform-extension-communication-meta-client-contracts.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Meta communication extension (WhatsApp Cloud API first; Messenger / Instagram later).
+ * Package group: libs/extensions/communication/meta — no separate core lib.
+ */
+declare const RootConfig: {
+    readonly module: {
+        readonly name: "CommunicationMetaExtension";
+        readonly icon: "fa-brands fa-whatsapp";
+    };
+    readonly config: {
+        readonly i18n: "extensions-communication-meta";
+    };
+    readonly integration: {
+        /** WhatsApp Cloud API — first Meta messaging product in this extension. */
+        readonly channelKey: "whatsapp";
+        readonly providerId: "whatsapp";
+    };
+};
+declare const AXPCommunicationMetaSettingKeys: {
+    readonly DebugRedirectPhoneNumber: "CommunicationMetaExtension:Setting:Debug.Redirect.PhoneNumber";
+    readonly UserDeliveryChannelEnabled: "CommunicationMetaExtension:Setting:User.Whatsapp.DeliveryChannel.Enabled";
+};
+/** Keys seeded at platform scope on startup (never include secrets). */
+declare const AXP_COMMUNICATION_META_PLATFORM_SEED_DEFAULTS: Record<string, unknown>;
+declare const AXP_COMMUNICATION_META_SETTING_DEFAULTS: Record<string, unknown>;
+declare const AXECommunicationMetaCommandKeys: {
+    readonly TestWhatsApp: "CommunicationMetaExtension:Communication:TestWhatsApp";
+    readonly ConnectionConnect: "CommunicationMetaExtension:Integration:ConnectWhatsApp";
+};
+
+/** Shared communication integration domain (Telegram, WhatsApp, …). */
+declare const AXE_COMMUNICATION_DOMAIN_ID = "communication";
+
+/**
+ * Tenant-scoped WhatsApp Cloud API credentials stored on IntegrationConnection.config.
+ */
+interface CommunicationMetaWhatsAppTenantConnectionConfig {
+    accessToken?: string;
+    phoneNumberId?: string;
+    webhookVerifyToken?: string;
+    appSecret?: string;
+}
+
+declare const AXP_COMMUNICATION_META_ERROR_CODES: {
+    readonly PHONE_NUMBER_REQUIRED: "COMMUNICATION_META_WHATSAPP_PHONE_NUMBER_REQUIRED";
+    readonly ACCESS_TOKEN_NOT_CONFIGURED: "COMMUNICATION_META_WHATSAPP_ACCESS_TOKEN_NOT_CONFIGURED";
+    readonly PHONE_NUMBER_ID_NOT_CONFIGURED: "COMMUNICATION_META_WHATSAPP_PHONE_NUMBER_ID_NOT_CONFIGURED";
+    readonly TENANT_REQUIRED: "COMMUNICATION_META_WHATSAPP_TENANT_REQUIRED";
+    readonly RECIPIENT_NOT_FOUND: "COMMUNICATION_META_WHATSAPP_RECIPIENT_NOT_FOUND";
+    readonly UNAUTHORIZED: "COMMUNICATION_META_WHATSAPP_UNAUTHORIZED";
+    readonly OUTSIDE_WINDOW: "COMMUNICATION_META_WHATSAPP_OUTSIDE_WINDOW";
+    readonly API_ERROR: "COMMUNICATION_META_WHATSAPP_API_ERROR";
+};
+type AXPCommunicationMetaErrorCode = (typeof AXP_COMMUNICATION_META_ERROR_CODES)[keyof typeof AXP_COMMUNICATION_META_ERROR_CODES];
+interface AXPCommunicationMetaApiErrorPayload {
+    code: AXPCommunicationMetaErrorCode;
+    description?: string;
+}
+
+/** User WhatsApp destination stored on the integration connection config. */
+interface CommunicationMetaWhatsAppUserLinkConfig {
+    /** E.164 phone number (digits with country code, optional leading +). */
+    phoneNumber: string;
+    displayName?: string | null;
+}
+
+interface CommunicationMetaWhatsAppTestInput {
+    phoneNumber: string;
+}
+interface CommunicationMetaWhatsAppTestResult {
+    phoneNumber: string;
+    messageId?: string;
+}
+
+export { AXECommunicationMetaCommandKeys, AXE_COMMUNICATION_DOMAIN_ID, AXPCommunicationMetaSettingKeys, AXP_COMMUNICATION_META_ERROR_CODES, AXP_COMMUNICATION_META_PLATFORM_SEED_DEFAULTS, AXP_COMMUNICATION_META_SETTING_DEFAULTS, RootConfig };
+export type { AXPCommunicationMetaApiErrorPayload, AXPCommunicationMetaErrorCode, CommunicationMetaWhatsAppTenantConnectionConfig, CommunicationMetaWhatsAppTestInput, CommunicationMetaWhatsAppTestResult, CommunicationMetaWhatsAppUserLinkConfig };

package/types/acorex-platform-extension-communication-meta-client.d.ts

@@ -0,0 +1,38 @@
+import * as i0 from '@angular/core';
+import * as i1 from '@acorex-platform/module-integration-management-client';
+import { CommunicationMetaWhatsAppTestInput, CommunicationMetaWhatsAppTestResult } from '@acorex-platform/extension-communication-meta-client/contracts';
+import { AXPLogoAppearance, AXPLogoProvider } from '@acorex-platform/framework-client/core';
+
+declare class AXECommunicationMetaExtensionModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXECommunicationMetaExtensionModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<AXECommunicationMetaExtensionModule, never, [typeof i1.AXMIntegrationManagementModule], never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<AXECommunicationMetaExtensionModule>;
+}
+
+declare abstract class AXPCommunicationMetaClient {
+    abstract testWhatsApp(input: CommunicationMetaWhatsAppTestInput): Promise<CommunicationMetaWhatsAppTestResult>;
+}
+
+declare class AXECommunicationWhatsAppLogoComponent {
+    appearance: i0.InputSignal<AXPLogoAppearance>;
+    size: i0.InputSignal<number>;
+    protected readonly markPath = "M12.04 2C6.58 2 2.13 6.45 2.13 11.91c0 1.75.46 3.45 1.32 4.95L2.05 22l5.25-1.38c1.45.79 3.08 1.21 4.74 1.21 5.46 0 9.91-4.45 9.91-9.91C21.95 6.45 17.5 2 12.04 2zm5.77 14.05c-.24.68-1.42 1.28-1.96 1.36-.5.07-1.14.1-1.84-.12-.42-.13-.96-.31-1.66-.61-2.92-1.26-4.82-4.21-4.96-4.4-.14-.19-1.15-1.53-1.15-2.92 0-1.39.73-2.07.99-2.35.26-.28.57-.35.76-.35h.55c.17 0 .41-.06.64.49.24.57.81 1.97.88 2.11.07.14.12.31.02.5-.1.19-.14.31-.28.48-.14.17-.29.37-.42.5-.14.14-.28.29-.12.57.17.28.74 1.22 1.59 1.98 1.09.97 2.01 1.27 2.29 1.41.28.14.45.12.61-.07.17-.19.69-.8.87-1.08.19-.28.37-.23.62-.14.26.1 1.64.77 1.92.91.28.14.47.21.54.33.07.12.07.68-.17 1.36z";
+    protected readonly markGreen = "#25D366";
+    protected readonly resolvedAppearance: i0.Signal<"colored" | "monochrome">;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXECommunicationWhatsAppLogoComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AXECommunicationWhatsAppLogoComponent, "axe-whatsapp-logo", never, { "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+declare const axpWhatsAppLogoKey: "whatsapp";
+
+declare const AXE_WHATSAPP_MARK_GREEN = "#25D366";
+/** Official-style WhatsApp speech-bubble mark (simplified path). */
+declare const AXE_WHATSAPP_MARK_PATH = "M12.04 2C6.58 2 2.13 6.45 2.13 11.91c0 1.75.46 3.45 1.32 4.95L2.05 22l5.25-1.38c1.45.79 3.08 1.21 4.74 1.21 5.46 0 9.91-4.45 9.91-9.91C21.95 6.45 17.5 2 12.04 2zm5.77 14.05c-.24.68-1.42 1.28-1.96 1.36-.5.07-1.14.1-1.84-.12-.42-.13-.96-.31-1.66-.61-2.92-1.26-4.82-4.21-4.96-4.4-.14-.19-1.15-1.53-1.15-2.92 0-1.39.73-2.07.99-2.35.26-.28.57-.35.76-.35h.55c.17 0 .41-.06.64.49.24.57.81 1.97.88 2.11.07.14.12.31.02.5-.1.19-.14.31-.28.48-.14.17-.29.37-.42.5-.14.14-.28.29-.12.57.17.28.74 1.22 1.59 1.98 1.09.97 2.01 1.27 2.29 1.41.28.14.45.12.61-.07.17-.19.69-.8.87-1.08.19-.28.37-.23.62-.14.26.1 1.64.77 1.92.91.28.14.47.21.54.33.07.12.07.68-.17 1.36z";
+
+declare const AXE_WHATSAPP_LOGO_PROVIDER: {
+    readonly provide: i0.InjectionToken<AXPLogoProvider[]>;
+    readonly useValue: AXPLogoProvider;
+    readonly multi: true;
+};
+
+export { AXECommunicationMetaExtensionModule, AXECommunicationWhatsAppLogoComponent, AXE_WHATSAPP_LOGO_PROVIDER, AXE_WHATSAPP_MARK_GREEN, AXE_WHATSAPP_MARK_PATH, AXPCommunicationMetaClient, axpWhatsAppLogoKey };