@portalduct/react-sdk-factorcloud-legacy 1.0.0

package/dist/lib/utils.d.ts

@@ -0,0 +1,4 @@
+import { ClassValue } from 'clsx';
+
+export declare function cn(...inputs: ClassValue[]): string;
+export declare function formatLastSync(lastSync: string | null | undefined): string;

package/dist/pages/Index.d.ts

@@ -0,0 +1,2 @@
+declare const Index: () => import("react/jsx-runtime").JSX.Element;
+export default Index;

package/dist/pages/NotFound.d.ts

@@ -0,0 +1,2 @@
+declare const NotFound: () => import("react/jsx-runtime").JSX.Element;
+export default NotFound;

package/dist/placeholder.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="1200" fill="none"><rect width="1200" height="1200" fill="#EAEAEA" rx="3"/><g opacity=".5"><g opacity=".5"><path fill="#FAFAFA" d="M600.709 736.5c-75.454 0-136.621-61.167-136.621-136.62 0-75.454 61.167-136.621 136.621-136.621 75.453 0 136.62 61.167 136.62 136.621 0 75.453-61.167 136.62-136.62 136.62Z"/><path stroke="#C9C9C9" stroke-width="2.418" d="M600.709 736.5c-75.454 0-136.621-61.167-136.621-136.62 0-75.454 61.167-136.621 136.621-136.621 75.453 0 136.62 61.167 136.62 136.621 0 75.453-61.167 136.62-136.62 136.62Z"/></g><path stroke="url(#a)" stroke-width="2.418" d="M0-1.209h553.581" transform="scale(1 -1) rotate(45 1163.11 91.165)"/><path stroke="url(#b)" stroke-width="2.418" d="M404.846 598.671h391.726"/><path stroke="url(#c)" stroke-width="2.418" d="M599.5 795.742V404.017"/><path stroke="url(#d)" stroke-width="2.418" d="m795.717 796.597-391.441-391.44"/><path fill="#fff" d="M600.709 656.704c-31.384 0-56.825-25.441-56.825-56.824 0-31.384 25.441-56.825 56.825-56.825 31.383 0 56.824 25.441 56.824 56.825 0 31.383-25.441 56.824-56.824 56.824Z"/><g clip-path="url(#e)"><path fill="#666" fill-rule="evenodd" d="M616.426 586.58h-31.434v16.176l3.553-3.554.531-.531h9.068l.074-.074 8.463-8.463h2.565l7.18 7.181V586.58Zm-15.715 14.654 3.698 3.699 1.283 1.282-2.565 2.565-1.282-1.283-5.2-5.199h-6.066l-5.514 5.514-.073.073v2.876a2.418 2.418 0 0 0 2.418 2.418h26.598a2.418 2.418 0 0 0 2.418-2.418v-8.317l-8.463-8.463-7.181 7.181-.071.072Zm-19.347 5.442v4.085a6.045 6.045 0 0 0 6.046 6.045h26.598a6.044 6.044 0 0 0 6.045-6.045v-7.108l1.356-1.355-1.282-1.283-.074-.073v-17.989h-38.689v23.43l-.146.146.146.147Z" clip-rule="evenodd"/></g><path stroke="#C9C9C9" stroke-width="2.418" d="M600.709 656.704c-31.384 0-56.825-25.441-56.825-56.824 0-31.384 25.441-56.825 56.825-56.825 31.383 0 56.824 25.441 56.824 56.825 0 31.383-25.441 56.824-56.824 56.824Z"/></g><defs><linearGradient id="a" x1="554.061" x2="-.48" y1=".083" y2=".087" gradientUnits="userSpaceOnUse"><stop stop-color="#C9C9C9" stop-opacity="0"/><stop offset=".208" stop-color="#C9C9C9"/><stop offset=".792" stop-color="#C9C9C9"/><stop offset="1" stop-color="#C9C9C9" stop-opacity="0"/></linearGradient><linearGradient id="b" x1="796.912" x2="404.507" y1="599.963" y2="599.965" gradientUnits="userSpaceOnUse"><stop stop-color="#C9C9C9" stop-opacity="0"/><stop offset=".208" stop-color="#C9C9C9"/><stop offset=".792" stop-color="#C9C9C9"/><stop offset="1" stop-color="#C9C9C9" stop-opacity="0"/></linearGradient><linearGradient id="c" x1="600.792" x2="600.794" y1="403.677" y2="796.082" gradientUnits="userSpaceOnUse"><stop stop-color="#C9C9C9" stop-opacity="0"/><stop offset=".208" stop-color="#C9C9C9"/><stop offset=".792" stop-color="#C9C9C9"/><stop offset="1" stop-color="#C9C9C9" stop-opacity="0"/></linearGradient><linearGradient id="d" x1="404.85" x2="796.972" y1="403.903" y2="796.02" gradientUnits="userSpaceOnUse"><stop stop-color="#C9C9C9" stop-opacity="0"/><stop offset=".208" stop-color="#C9C9C9"/><stop offset=".792" stop-color="#C9C9C9"/><stop offset="1" stop-color="#C9C9C9" stop-opacity="0"/></linearGradient><clipPath id="e"><path fill="#fff" d="M581.364 580.535h38.689v38.689h-38.689z"/></clipPath></defs></svg>

package/dist/sdk/index.d.ts

@@ -0,0 +1,66 @@
+import { PortalIntegration } from '../components/PortalIntegration';
+import { SDKConfig } from '../types/config';
+
+/**
+ * SDK Version
+ */
+export declare const SDK_VERSION = "0.1.0";
+/**
+ * Initialize PortalSDK with configuration
+ * @param config - SDK configuration object
+ * @returns Object containing config and component
+ */
+export declare function initPortalSDK(config: SDKConfig): {
+    config: SDKConfig;
+    component: ({ config, onTokenExpired, trigger, onSyncComplete, onSyncError, autoStart, customerStatus, }: import('../components/SyncWorkflow').SyncWorkflowProps) => import("react/jsx-runtime").JSX.Element;
+};
+/**
+ * Sync Workflow Component (Recommended)
+ * Provides modal-based workflow for syncing invoices from portals
+ * This is the primary component you should use for integrating sync functionality
+ */
+export { SyncWorkflow } from '../components/SyncWorkflow';
+export type { SyncWorkflowProps } from '../components/SyncWorkflow';
+/**
+ * Pre-built marketing banner with CTA button that launches the sync workflow.
+ */
+export { SyncBanner } from '../components/SyncBanner';
+export type { SyncBannerProps } from '../components/SyncBanner';
+/**
+ * Full Portal Integration Component (Demo/Reference)
+ * Complete dashboard UI - primarily for internal demo purposes
+ * External applications should use SyncWorkflow instead
+ */
+export { PortalIntegration };
+/**
+ * Standalone Modal Components
+ * Use these for custom integration workflows
+ */
+export { ConfigModal } from '../components/ConfigModal';
+export { ConnectDebtorModal } from '../components/ConnectDebtorModal';
+export { RequestPortalModal } from '../components/RequestPortalModal';
+export { UpdateCredentialsModal } from '../components/UpdateCredentialsModal';
+export { SyncProgressModal } from '../components/SyncProgressModal';
+export { ClientSelectionModal } from '../components/ClientSelectionModal';
+/**
+ * Type Exports
+ */
+export type { SDKConfig };
+/**
+ * Export all types for external use
+ */
+export * from '../types/config';
+export * from '../types/factorcloud';
+export * from '../types/portalduct';
+export * from '../types/merged';
+/**
+ * API Clients for direct API access
+ */
+export { FactorCloudAPI } from '../api/factorcloud';
+export { PortalDuctAPI } from '../api/portalduct';
+export { ConnectionSyncAPI } from '../api/connectionSync';
+/**
+ * Data Orchestration Service
+ * Handles complex data synchronization between PortalDuct and FactorCloud
+ */
+export { DataOrchestrationService } from '../services/orchestration';

package/dist/services/orchestration.d.ts

@@ -0,0 +1,26 @@
+import { FactorCloudAPI } from '../api/factorcloud';
+import { PortalDuctAPI } from '../api/portalduct';
+import { ConnectionSyncAPI } from '../api/connectionSync';
+import { SDKConfig } from '../types/config';
+import { FactorCloudClient, FactorCloudClientDetail } from '../types/factorcloud';
+import { PortalDuctCompany, ResyncResponse } from '../types/portalduct';
+import { MergedDebtor } from '../types/merged';
+
+export declare class DataOrchestrationService {
+    private factorcloudAPI;
+    private portalductAPI;
+    private connectionSyncAPI;
+    private config;
+    constructor(config: SDKConfig);
+    getFactorCloudClients(): Promise<FactorCloudClient[]>;
+    getFactorCloudClient(clientId?: string): Promise<FactorCloudClient>;
+    ensurePortalDuctCompany(fcClient: FactorCloudClient | FactorCloudClientDetail): Promise<PortalDuctCompany>;
+    fetchMergedDebtors(fcClientId: string, pdCompanyId: string): Promise<MergedDebtor[]>;
+    private matchConnectionsToDebtors;
+    getFactorCloudAPI(): FactorCloudAPI;
+    getPortalDuctAPI(): PortalDuctAPI;
+    getConnectionSyncAPI(): ConnectionSyncAPI;
+    isCustomerActive(): Promise<boolean>;
+    triggerConnectionSync(connectionId: string): Promise<ResyncResponse>;
+    triggerConnectionVerification(connectionId: string): Promise<ResyncResponse>;
+}

package/dist/types/config.d.ts

@@ -0,0 +1,47 @@
+export interface SDKConfig {
+    portalduct: {
+        bearer_token: string;
+        env_url: string;
+        customer_id: string;
+        /**
+         * Dedicated bearer token used exclusively for Supabase webhook calls.
+         */
+        webhook_bearer_token?: string;
+        /**
+         * Deployment environment identifier used by webhook integrations.
+         * Defaults to "sandbox" when the PortalDuct environment URL contains
+         * "sandbox" and "production" otherwise.
+         */
+        environment?: string;
+        /**
+         * Optional override for the webhook endpoint used to trigger connection syncs.
+         */
+        sync_webhook_url?: string;
+        /**
+         * Optional override for the webhook endpoint used to trigger connection verification.
+         */
+        verify_webhook_url?: string;
+    };
+    factorcloud: {
+        bearer_token: string;
+        factorId: string;
+        env_url: string;
+        client_id?: string;
+    };
+}
+export interface CustomerStatusPayload {
+    active: boolean;
+    customer?: {
+        portalduct_customer_uuid?: string | null;
+    } | null;
+    factorcloud?: {
+        bearer_token?: string | null;
+        api_url?: string | null;
+    } | null;
+    portalduct?: {
+        bearer_token?: string | null;
+        api_url?: string | null;
+    } | null;
+}
+export declare const isConfigComplete: (config: Partial<SDKConfig> | null) => config is SDKConfig;
+export declare const mergeCustomerStatusWithConfig: (config: Partial<SDKConfig> | null | undefined, status: CustomerStatusPayload) => SDKConfig | null;

package/dist/types/factorcloud.d.ts

@@ -0,0 +1,98 @@
+export interface FactorCloudClient {
+    id: string;
+    compCode: string;
+    shortCode: string;
+    companyName: string;
+    active: boolean;
+    address1: string;
+    address2: string | null;
+    city: string;
+    stateCode: string;
+    zipCode: string;
+    countryCode: string;
+    phone: string;
+    fax: string | null;
+    email: string;
+    factorName: string;
+    companyType: string;
+    ein: string | null;
+    mcNumber: string | null;
+    createdOn: string;
+    updatedOn: string;
+    industryType: string;
+    enableOverAdvances: boolean;
+}
+export interface FactorCloudClientDetail extends FactorCloudClient {
+    phoneAlternate: string | null;
+    ediId: string | null;
+    fedTaxNumber: string | null;
+    dunsNumber: string | null;
+    dotNumber: string | null;
+    creditLimit: number;
+    ineligibleDays: number | null;
+    termId: string;
+    termName: string;
+    currency: string;
+    creditLimitApproved: boolean;
+    achFee: number | null;
+    wireFee: number | null;
+    checkFee: number | null;
+    fuelCardFee: number | null;
+    sameDayAchFee: number | null;
+    digitalWalletFee: number | null;
+    escrowReserve: number;
+    cashReserve: number;
+    interestActive: boolean;
+    interestPrincipal: number | null;
+    interestType: string | null;
+    interestRate: number | null;
+    interestRateMinimum: number | null;
+    interestDaysPerYear: number | null;
+    negativeFeeDollarAmount: number;
+    negativeFeePercentageAmount: number | null;
+}
+export interface FactorCloudDebtor {
+    companyDebtorName: string;
+    companyClientName: string;
+    companyDebtorId: string;
+    companyClientId: string;
+    termId: string;
+    termName: string;
+    clientTermId: string;
+    clientTermName: string;
+    paymentTerm: number | null;
+    ineligibleDays: number | null;
+    creditLimit: number;
+    creditLimitApproved: boolean;
+    creditRating: string | null;
+    firstNoaSent: string | null;
+    lastNoaSent: string | null;
+}
+export interface FactorCloudAuthResponse {
+    status: string;
+    code: number;
+    token: string;
+    skip2fa: boolean;
+    bearer: string;
+    username: string;
+    authorities: Array<{
+        authority: string;
+    }>;
+    redirectUrl: string | null;
+}
+export interface FactorCloudClientsResponse {
+    status: string;
+    code: number;
+    companies: FactorCloudClient[];
+}
+export interface FactorCloudClientDetailResponse {
+    status: string;
+    code: number;
+    message: string;
+    client: FactorCloudClientDetail;
+}
+export interface FactorCloudDebtorsResponse {
+    status: string;
+    code: number;
+    clientDebtors: FactorCloudDebtor[];
+}

package/dist/types/merged.d.ts

@@ -0,0 +1,16 @@
+import { PortalDuctConnection, SyncSummary } from './portalduct';
+
+export interface MergedDebtor {
+    factorcloudDebtorId: string;
+    factorcloudClientId: string;
+    debtorName: string;
+    creditLimit: number;
+    termName: string;
+    connection?: PortalDuctConnection;
+    status: "not_connected" | "pending" | "connected" | "deactivated";
+    portalName?: string;
+    lastSync?: string;
+    autoSyncEnabled?: boolean;
+    lastSyncSummary?: SyncSummary;
+    lastVerificationSummary?: SyncSummary;
+}

package/dist/types/portalduct.d.ts

@@ -0,0 +1,139 @@
+export interface PortalDuctCompany {
+    company_id: string;
+    name: string;
+    email: string;
+    activation_status: string;
+    tags: {
+        factorcloud_id?: string;
+        [key: string]: any;
+    };
+    customer_id: string;
+}
+export interface PortalDuctConnection {
+    connection_id: string;
+    portal_id: string;
+    portal_name: string | null;
+    host: string;
+    last_sync: string | null;
+    created_at: string;
+    activation_status: "activated" | "pending" | "deactivated";
+    auto_sync_status: "enabled" | "disabled";
+    remark: string | null;
+    tags: {
+        factorcloud_id?: string;
+        factorcloud_debtor_id?: string;
+        [key: string]: any;
+    };
+    company: PortalDuctCompany;
+}
+export interface PortalDuctPortal {
+    portal_id: string;
+    name: string;
+    domain: string;
+    status: string;
+    icon?: string;
+}
+export interface PortalDuctAuthResponse {
+    status: string;
+    request_id: string;
+    message: string;
+    data: {
+        token: string;
+    };
+}
+export interface PortalDuctCompaniesResponse {
+    status: string;
+    request_id: string;
+    message: string;
+    data: PortalDuctCompany[];
+}
+export interface PortalDuctCompanyResponse {
+    status: string;
+    request_id: string;
+    message: string;
+    data: PortalDuctCompany;
+}
+export interface PortalDuctConnectionsResponse {
+    status: string;
+    request_id: string;
+    message: string;
+    data: PortalDuctConnection[];
+}
+export interface PortalDuctConnectionResponse {
+    status: string;
+    request_id: string;
+    message: string;
+    data: PortalDuctConnection;
+}
+export interface CreateCompanyRequest {
+    name: string;
+    email: string;
+    customer_id: string;
+    tags: {
+        factorcloud_id: string;
+        [key: string]: any;
+    };
+}
+export interface CreateConnectionRequest {
+    tags: {
+        factorcloud_id: string;
+        factorcloud_debtor_id: string;
+        [key: string]: any;
+    };
+    company_id: string;
+    portal_id: string;
+    user_name: string;
+    password: string;
+}
+export interface UpdateConnectionRequest {
+    user_name?: string;
+    password?: string;
+    portal_id?: string;
+}
+export interface ActivationRequest {
+    activation_status: "activate" | "deactivate";
+}
+export interface PortalMapping {
+    mapping_id: string;
+    host: string;
+    description: string;
+    is_active: boolean;
+    portal_id: string;
+    logo: string;
+    name: string;
+}
+export interface PortalMappingsResponse {
+    status: string;
+    request_id: string;
+    message: string;
+    data: PortalMapping[];
+}
+export interface PortalMappingResponse {
+    status: string;
+    request_id: string;
+    message: string;
+    data: PortalMapping;
+}
+export interface CreatePortalMappingRequest {
+    customer_id: string;
+    name: string;
+    host: string;
+}
+export interface ResyncResponse {
+    success: boolean;
+    customerId: string;
+    connectionId: string;
+    processed: number;
+    synced: number;
+    failed: number;
+    message?: string;
+}
+export interface SyncSummary {
+    processed: number;
+    synced: number;
+    failed: number;
+    /**
+     * ISO timestamp representing when the summary was captured.
+     */
+    timestamp: string;
+}

package/package.json

@@ -0,0 +1,122 @@
+{
+  "name": "@portalduct/react-sdk-factorcloud-legacy",
+  "version": "1.0.0",
+  "private": false,
+  "description": "React SDK for integrating with PortalDuct and FactorCloud APIs",
+  "type": "module",
+  "engines": {
+    "node": ">=16.16.0"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": [
+    "*.css"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./react-sdk-factorcloud.css": "./dist/react-sdk-factorcloud.css"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "react",
+    "sdk",
+    "portalduct",
+    "factorcloud",
+    "invoice",
+    "integration",
+    "api"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "build:dev": "vite build --mode development",
+    "build:lib": "vite build --config vite.config.lib.ts",
+    "lint": "eslint .",
+    "preview": "vite preview",
+    "prepublishOnly": "npm run build:lib"
+  },
+  "dependencies": {
+    "@formspark/use-formspark": "^0.1.42",
+    "@vitejs/plugin-react": "^4.3.4",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
+    "date-fns": "^4.1.0",
+    "embla-carousel-react": "^8.6.0",
+    "input-otp": "^1.4.2",
+    "next-themes": "^0.4.6",
+    "react-day-picker": "^9.14.0",
+    "react-resizable-panels": "^3.0.6",
+    "recharts": "^3.7.0",
+    "sonner": "^2.0.7",
+    "tailwind-merge": "^3.5.0",
+    "tailwindcss-animate": "^1.0.7",
+    "vaul": "^1.1.2",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "@hookform/resolvers": "^3.9.0",
+    "@radix-ui/react-accordion": "^1.2.0",
+    "@radix-ui/react-alert-dialog": "^1.1.1",
+    "@radix-ui/react-aspect-ratio": "^1.1.0",
+    "@radix-ui/react-avatar": "^1.1.0",
+    "@radix-ui/react-checkbox": "^1.1.1",
+    "@radix-ui/react-collapsible": "^1.1.0",
+    "@radix-ui/react-context-menu": "^2.2.1",
+    "@radix-ui/react-dialog": "^1.1.2",
+    "@radix-ui/react-dropdown-menu": "^2.1.1",
+    "@radix-ui/react-hover-card": "^1.1.1",
+    "@radix-ui/react-label": "^2.1.0",
+    "@radix-ui/react-menubar": "^1.1.1",
+    "@radix-ui/react-navigation-menu": "^1.2.0",
+    "@radix-ui/react-popover": "^1.1.1",
+    "@radix-ui/react-progress": "^1.1.0",
+    "@radix-ui/react-radio-group": "^1.2.0",
+    "@radix-ui/react-scroll-area": "^1.1.0",
+    "@radix-ui/react-select": "^2.1.1",
+    "@radix-ui/react-separator": "^1.1.0",
+    "@radix-ui/react-slider": "^1.2.0",
+    "@radix-ui/react-slot": "^1.1.0",
+    "@radix-ui/react-switch": "^1.1.0",
+    "@radix-ui/react-tabs": "^1.1.0",
+    "@radix-ui/react-toast": "^1.2.1",
+    "@radix-ui/react-toggle": "^1.1.0",
+    "@radix-ui/react-toggle-group": "^1.1.0",
+    "@radix-ui/react-tooltip": "^1.1.4",
+    "@tanstack/react-query": "^5.56.2",
+    "lucide-react": "^0.462.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-hook-form": "^7.53.0",
+    "react-router-dom": "^6.26.2 || ^7"
+  },
+  "devDependencies": {
+    "@tailwindcss/typography": "^0.5.19",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "autoprefixer": "^10.4.27",
+    "eslint": "^8.57.0",
+    "eslint-plugin-react-hooks": "^4.6.2",
+    "eslint-plugin-react-refresh": "^0.4.14",
+    "globals": "^15.0.0",
+    "postcss": "^8.5.8",
+    "tailwindcss": "^3.4.17",
+    "typescript": "^5.4.0",
+    "vite": "^4.5.4",
+    "vite-plugin-css-injected-by-js": "^3.0.0",
+    "vite-plugin-dts": "^3.9.0"
+  }
+}