@feelflow/ffid-sdk 0.1.0

package/dist/components/index.cjs

@@ -0,0 +1,22 @@
+'use strict';
+
+var chunkYCMQXJOS_cjs = require('../chunk-YCMQXJOS.cjs');
+
+
+
+Object.defineProperty(exports, "FFIDLoginButton", {
+  enumerable: true,
+  get: function () { return chunkYCMQXJOS_cjs.FFIDLoginButton; }
+});
+Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
+  enumerable: true,
+  get: function () { return chunkYCMQXJOS_cjs.FFIDOrganizationSwitcher; }
+});
+Object.defineProperty(exports, "FFIDSubscriptionBadge", {
+  enumerable: true,
+  get: function () { return chunkYCMQXJOS_cjs.FFIDSubscriptionBadge; }
+});
+Object.defineProperty(exports, "FFIDUserMenu", {
+  enumerable: true,
+  get: function () { return chunkYCMQXJOS_cjs.FFIDUserMenu; }
+});

package/dist/components/index.d.cts

@@ -0,0 +1,3 @@
+export { h as FFIDLoginButton, n as FFIDLoginButtonProps, i as FFIDOrganizationSwitcher, o as FFIDOrganizationSwitcherClassNames, p as FFIDOrganizationSwitcherProps, l as FFIDSubscriptionBadge, q as FFIDSubscriptionBadgeClassNames, r as FFIDSubscriptionBadgeProps, m as FFIDUserMenu, s as FFIDUserMenuClassNames, t as FFIDUserMenuProps } from '../index-CtBBLbTn.cjs';
+import 'react/jsx-runtime';
+import 'react';

package/dist/components/index.d.ts

@@ -0,0 +1,3 @@
+export { h as FFIDLoginButton, n as FFIDLoginButtonProps, i as FFIDOrganizationSwitcher, o as FFIDOrganizationSwitcherClassNames, p as FFIDOrganizationSwitcherProps, l as FFIDSubscriptionBadge, q as FFIDSubscriptionBadgeClassNames, r as FFIDSubscriptionBadgeProps, m as FFIDUserMenu, s as FFIDUserMenuClassNames, t as FFIDUserMenuProps } from '../index-CtBBLbTn.js';
+import 'react/jsx-runtime';
+import 'react';

package/dist/components/index.js

@@ -0,0 +1 @@
+export { FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-A63MX52D.js';

package/dist/index-CtBBLbTn.d.cts

@@ -0,0 +1,322 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ButtonHTMLAttributes, ReactNode, CSSProperties } from 'react';
+
+/**
+ * FFID SDK Type Definitions
+ *
+ * Core types for the FeelFlow ID SDK
+ */
+/**
+ * User information from FFID
+ */
+interface FFIDUser {
+    /** User ID (UUID) */
+    id: string;
+    /** Email address */
+    email: string;
+    /** Display name */
+    displayName: string | null;
+    /** Avatar URL */
+    avatarUrl: string | null;
+    /** Locale setting (e.g., 'ja', 'en') */
+    locale: string | null;
+    /** Timezone (e.g., 'Asia/Tokyo') */
+    timezone: string | null;
+    /** Account creation timestamp */
+    createdAt: string;
+}
+/**
+ * Organization membership information
+ */
+interface FFIDOrganization {
+    /** Organization ID (UUID) */
+    id: string;
+    /** Organization name */
+    name: string;
+    /** URL-safe slug */
+    slug: string;
+    /** User's role in this organization */
+    role: 'owner' | 'admin' | 'member';
+    /** Membership status */
+    status: 'active' | 'invited' | 'suspended';
+}
+/**
+ * Subscription/contract information
+ */
+interface FFIDSubscription {
+    /** Subscription ID (UUID) */
+    id: string;
+    /** Service code (e.g., 'chatbot') */
+    serviceCode: string;
+    /** Service display name */
+    serviceName: string;
+    /** Plan code (e.g., 'basic', 'pro') */
+    planCode: string;
+    /** Plan display name */
+    planName: string;
+    /** Subscription status */
+    status: 'trialing' | 'active' | 'past_due' | 'canceled' | 'paused';
+    /** Current billing period end date */
+    currentPeriodEnd: string | null;
+}
+/**
+ * SDK configuration options
+ */
+interface FFIDConfig {
+    /** Service code to identify your application */
+    serviceCode: string;
+    /** FFID API base URL (defaults to production) */
+    apiBaseUrl?: string | undefined;
+    /**
+     * Enable debug logging (deprecated: use logger instead)
+     * When true and no logger provided, uses console for logging
+     * @deprecated Use `logger` option for custom logging
+     */
+    debug?: boolean | undefined;
+    /**
+     * Custom logger for SDK debug output
+     * If not provided: uses no-op logger (silent)
+     * If debug=true and no logger: uses console
+     */
+    logger?: FFIDLogger | undefined;
+    /** Session refresh interval in milliseconds */
+    refreshInterval?: number | undefined;
+    /** Callback when authentication state changes */
+    onAuthStateChange?: ((user: FFIDUser | null) => void) | undefined;
+    /** Callback on authentication error */
+    onError?: ((error: FFIDError) => void) | undefined;
+}
+/**
+ * FFID context value provided to consumers
+ */
+interface FFIDContextValue {
+    /** Current authenticated user (null if not authenticated) */
+    user: FFIDUser | null;
+    /** User's organization memberships */
+    organizations: FFIDOrganization[];
+    /** Currently selected organization */
+    currentOrganization: FFIDOrganization | null;
+    /** User's subscriptions for the current service */
+    subscriptions: FFIDSubscription[];
+    /** Whether authentication is being checked */
+    isLoading: boolean;
+    /** Whether the user is authenticated */
+    isAuthenticated: boolean;
+    /** Any authentication error */
+    error: FFIDError | null;
+    /** Redirect to FFID login page */
+    login: () => void;
+    /** Sign out and clear session */
+    logout: () => Promise<void>;
+    /** Switch to a different organization */
+    switchOrganization: (organizationId: string) => void;
+    /** Refresh session data */
+    refresh: () => Promise<void>;
+}
+/**
+ * Subscription context value
+ */
+interface FFIDSubscriptionContextValue {
+    /** Active subscription for current service (null if none) */
+    subscription: FFIDSubscription | null;
+    /** Current plan code */
+    planCode: string | null;
+    /** Whether subscription is active */
+    isActive: boolean;
+    /** Whether in trial period */
+    isTrialing: boolean;
+    /** Whether subscription is canceled */
+    isCanceled: boolean;
+    /** Check if user has specific plan */
+    hasPlan: (plans: string | string[]) => boolean;
+    /** Check if user has access (active or trialing subscription) */
+    hasAccess: () => boolean;
+}
+/**
+ * Logger interface for SDK debug output
+ *
+ * Allows injection of custom loggers (e.g., winston, pino)
+ * or use of the built-in console logger when debug is enabled
+ */
+interface FFIDLogger {
+    /** Debug level logging */
+    debug: (...args: unknown[]) => void;
+    /** Info level logging */
+    info: (...args: unknown[]) => void;
+    /** Warning level logging */
+    warn: (...args: unknown[]) => void;
+    /** Error level logging */
+    error: (...args: unknown[]) => void;
+}
+/**
+ * FFID error object
+ */
+interface FFIDError {
+    /** Error code */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** Additional error details */
+    details?: Record<string, unknown>;
+}
+/**
+ * Session response from FFID API
+ */
+interface FFIDSessionResponse {
+    user: FFIDUser;
+    organizations: FFIDOrganization[];
+    subscriptions: FFIDSubscription[];
+}
+/**
+ * API response wrapper (discriminated union for type safety)
+ *
+ * Either data is present (success) or error is present (failure), never both.
+ * This pattern ensures callers handle both cases explicitly.
+ */
+type FFIDApiResponse<T> = {
+    data: T;
+    error?: undefined;
+} | {
+    data?: undefined;
+    error: FFIDError;
+};
+
+interface FFIDLoginButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Button content */
+    children?: ReactNode;
+    /** Custom class name */
+    className?: string;
+    /** Show loading state while checking auth */
+    showLoading?: boolean;
+}
+/**
+ * Login button that redirects to FFID authentication
+ */
+declare function FFIDLoginButton({ children, className, showLoading, disabled, ...props }: FFIDLoginButtonProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * ClassNames for styling individual parts of FFIDUserMenu
+ * @see https://www.radix-ui.com/primitives/docs/guides/styling
+ */
+interface FFIDUserMenuClassNames {
+    /** Container wrapper */
+    container?: string;
+    /** Avatar button trigger */
+    button?: string;
+    /** Avatar element (image or fallback) */
+    avatar?: string;
+    /** Dropdown menu container */
+    menu?: string;
+    /** User info section at top of menu */
+    userInfo?: string;
+    /** Custom menu item buttons */
+    menuItem?: string;
+    /** Logout button */
+    logout?: string;
+}
+interface FFIDUserMenuProps {
+    /** Custom class name for the container */
+    className?: string;
+    /**
+     * Class names for individual parts (Radix UI pattern)
+     * Allows styling each internal element separately
+     */
+    classNames?: FFIDUserMenuClassNames;
+    /** Custom avatar component */
+    renderAvatar?: (user: {
+        avatarUrl: string | null;
+        displayName: string | null;
+        email: string;
+    }) => ReactNode;
+    /** Custom menu items */
+    menuItems?: Array<{
+        label: string;
+        onClick: () => void;
+        icon?: ReactNode;
+    }>;
+    /** Show organization info */
+    showOrganization?: boolean;
+    /** Logout button text */
+    logoutText?: string;
+}
+/**
+ * User menu component showing avatar and dropdown
+ */
+declare function FFIDUserMenu({ className, classNames, renderAvatar, menuItems, showOrganization, logoutText, }: FFIDUserMenuProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * ClassNames for styling individual parts of FFIDOrganizationSwitcher
+ * @see https://www.radix-ui.com/primitives/docs/guides/styling
+ */
+interface FFIDOrganizationSwitcherClassNames {
+    /** Container wrapper */
+    container?: string;
+    /** Trigger button */
+    button?: string;
+    /** Dropdown menu */
+    dropdown?: string;
+    /** Organization option (each item) */
+    option?: string;
+    /** Currently selected option (added in addition to option) */
+    optionSelected?: string;
+}
+interface FFIDOrganizationSwitcherProps {
+    /** Custom class name */
+    className?: string;
+    /**
+     * Class names for individual parts (Radix UI pattern)
+     * Allows styling each internal element separately
+     */
+    classNames?: FFIDOrganizationSwitcherClassNames;
+    /** Custom render for organization item */
+    renderOrganization?: (org: FFIDOrganization, isCurrent: boolean) => ReactNode;
+    /** Label text */
+    label?: string;
+    /** Empty state text */
+    emptyText?: string;
+    /** Called when organization is switched */
+    onSwitch?: (organizationId: string) => void;
+}
+/**
+ * Organization switcher dropdown
+ */
+declare function FFIDOrganizationSwitcher({ className, classNames, renderOrganization, label, emptyText, onSwitch, }: FFIDOrganizationSwitcherProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * ClassNames for styling individual parts of FFIDSubscriptionBadge
+ * @see https://www.radix-ui.com/primitives/docs/guides/styling
+ */
+interface FFIDSubscriptionBadgeClassNames {
+    /** The badge span element (also accessible via className prop) */
+    badge?: string;
+}
+interface FFIDSubscriptionBadgeProps {
+    /** Custom class name (applies to badge span) */
+    className?: string;
+    /**
+     * Class names for individual parts (Radix UI pattern)
+     * For this simple component, using className is usually sufficient
+     */
+    classNames?: FFIDSubscriptionBadgeClassNames;
+    /** Custom style */
+    style?: CSSProperties;
+    /** Show plan name instead of status */
+    showPlanName?: boolean;
+    /** Custom labels for each status */
+    labels?: {
+        active?: string;
+        trialing?: string;
+        pastDue?: string;
+        canceled?: string;
+        paused?: string;
+        none?: string;
+    };
+    /** Custom render function */
+    render?: (status: string, planName: string | null) => ReactNode;
+}
+/**
+ * Subscription status badge
+ */
+declare function FFIDSubscriptionBadge({ className, classNames, style, showPlanName, labels, render, }: FFIDSubscriptionBadgeProps): react_jsx_runtime.JSX.Element;
+
+export { type FFIDConfig as F, type FFIDUser as a, type FFIDOrganization as b, type FFIDError as c, type FFIDSubscriptionContextValue as d, type FFIDApiResponse as e, type FFIDContextValue as f, type FFIDLogger as g, FFIDLoginButton as h, FFIDOrganizationSwitcher as i, type FFIDSessionResponse as j, type FFIDSubscription as k, FFIDSubscriptionBadge as l, FFIDUserMenu as m, type FFIDLoginButtonProps as n, type FFIDOrganizationSwitcherClassNames as o, type FFIDOrganizationSwitcherProps as p, type FFIDSubscriptionBadgeClassNames as q, type FFIDSubscriptionBadgeProps as r, type FFIDUserMenuClassNames as s, type FFIDUserMenuProps as t };

package/dist/index-CtBBLbTn.d.ts

@@ -0,0 +1,322 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ButtonHTMLAttributes, ReactNode, CSSProperties } from 'react';
+
+/**
+ * FFID SDK Type Definitions
+ *
+ * Core types for the FeelFlow ID SDK
+ */
+/**
+ * User information from FFID
+ */
+interface FFIDUser {
+    /** User ID (UUID) */
+    id: string;
+    /** Email address */
+    email: string;
+    /** Display name */
+    displayName: string | null;
+    /** Avatar URL */
+    avatarUrl: string | null;
+    /** Locale setting (e.g., 'ja', 'en') */
+    locale: string | null;
+    /** Timezone (e.g., 'Asia/Tokyo') */
+    timezone: string | null;
+    /** Account creation timestamp */
+    createdAt: string;
+}
+/**
+ * Organization membership information
+ */
+interface FFIDOrganization {
+    /** Organization ID (UUID) */
+    id: string;
+    /** Organization name */
+    name: string;
+    /** URL-safe slug */
+    slug: string;
+    /** User's role in this organization */
+    role: 'owner' | 'admin' | 'member';
+    /** Membership status */
+    status: 'active' | 'invited' | 'suspended';
+}
+/**
+ * Subscription/contract information
+ */
+interface FFIDSubscription {
+    /** Subscription ID (UUID) */
+    id: string;
+    /** Service code (e.g., 'chatbot') */
+    serviceCode: string;
+    /** Service display name */
+    serviceName: string;
+    /** Plan code (e.g., 'basic', 'pro') */
+    planCode: string;
+    /** Plan display name */
+    planName: string;
+    /** Subscription status */
+    status: 'trialing' | 'active' | 'past_due' | 'canceled' | 'paused';
+    /** Current billing period end date */
+    currentPeriodEnd: string | null;
+}
+/**
+ * SDK configuration options
+ */
+interface FFIDConfig {
+    /** Service code to identify your application */
+    serviceCode: string;
+    /** FFID API base URL (defaults to production) */
+    apiBaseUrl?: string | undefined;
+    /**
+     * Enable debug logging (deprecated: use logger instead)
+     * When true and no logger provided, uses console for logging
+     * @deprecated Use `logger` option for custom logging
+     */
+    debug?: boolean | undefined;
+    /**
+     * Custom logger for SDK debug output
+     * If not provided: uses no-op logger (silent)
+     * If debug=true and no logger: uses console
+     */
+    logger?: FFIDLogger | undefined;
+    /** Session refresh interval in milliseconds */
+    refreshInterval?: number | undefined;
+    /** Callback when authentication state changes */
+    onAuthStateChange?: ((user: FFIDUser | null) => void) | undefined;
+    /** Callback on authentication error */
+    onError?: ((error: FFIDError) => void) | undefined;
+}
+/**
+ * FFID context value provided to consumers
+ */
+interface FFIDContextValue {
+    /** Current authenticated user (null if not authenticated) */
+    user: FFIDUser | null;
+    /** User's organization memberships */
+    organizations: FFIDOrganization[];
+    /** Currently selected organization */
+    currentOrganization: FFIDOrganization | null;
+    /** User's subscriptions for the current service */
+    subscriptions: FFIDSubscription[];
+    /** Whether authentication is being checked */
+    isLoading: boolean;
+    /** Whether the user is authenticated */
+    isAuthenticated: boolean;
+    /** Any authentication error */
+    error: FFIDError | null;
+    /** Redirect to FFID login page */
+    login: () => void;
+    /** Sign out and clear session */
+    logout: () => Promise<void>;
+    /** Switch to a different organization */
+    switchOrganization: (organizationId: string) => void;
+    /** Refresh session data */
+    refresh: () => Promise<void>;
+}
+/**
+ * Subscription context value
+ */
+interface FFIDSubscriptionContextValue {
+    /** Active subscription for current service (null if none) */
+    subscription: FFIDSubscription | null;
+    /** Current plan code */
+    planCode: string | null;
+    /** Whether subscription is active */
+    isActive: boolean;
+    /** Whether in trial period */
+    isTrialing: boolean;
+    /** Whether subscription is canceled */
+    isCanceled: boolean;
+    /** Check if user has specific plan */
+    hasPlan: (plans: string | string[]) => boolean;
+    /** Check if user has access (active or trialing subscription) */
+    hasAccess: () => boolean;
+}
+/**
+ * Logger interface for SDK debug output
+ *
+ * Allows injection of custom loggers (e.g., winston, pino)
+ * or use of the built-in console logger when debug is enabled
+ */
+interface FFIDLogger {
+    /** Debug level logging */
+    debug: (...args: unknown[]) => void;
+    /** Info level logging */
+    info: (...args: unknown[]) => void;
+    /** Warning level logging */
+    warn: (...args: unknown[]) => void;
+    /** Error level logging */
+    error: (...args: unknown[]) => void;
+}
+/**
+ * FFID error object
+ */
+interface FFIDError {
+    /** Error code */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+    /** Additional error details */
+    details?: Record<string, unknown>;
+}
+/**
+ * Session response from FFID API
+ */
+interface FFIDSessionResponse {
+    user: FFIDUser;
+    organizations: FFIDOrganization[];
+    subscriptions: FFIDSubscription[];
+}
+/**
+ * API response wrapper (discriminated union for type safety)
+ *
+ * Either data is present (success) or error is present (failure), never both.
+ * This pattern ensures callers handle both cases explicitly.
+ */
+type FFIDApiResponse<T> = {
+    data: T;
+    error?: undefined;
+} | {
+    data?: undefined;
+    error: FFIDError;
+};
+
+interface FFIDLoginButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Button content */
+    children?: ReactNode;
+    /** Custom class name */
+    className?: string;
+    /** Show loading state while checking auth */
+    showLoading?: boolean;
+}
+/**
+ * Login button that redirects to FFID authentication
+ */
+declare function FFIDLoginButton({ children, className, showLoading, disabled, ...props }: FFIDLoginButtonProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * ClassNames for styling individual parts of FFIDUserMenu
+ * @see https://www.radix-ui.com/primitives/docs/guides/styling
+ */
+interface FFIDUserMenuClassNames {
+    /** Container wrapper */
+    container?: string;
+    /** Avatar button trigger */
+    button?: string;
+    /** Avatar element (image or fallback) */
+    avatar?: string;
+    /** Dropdown menu container */
+    menu?: string;
+    /** User info section at top of menu */
+    userInfo?: string;
+    /** Custom menu item buttons */
+    menuItem?: string;
+    /** Logout button */
+    logout?: string;
+}
+interface FFIDUserMenuProps {
+    /** Custom class name for the container */
+    className?: string;
+    /**
+     * Class names for individual parts (Radix UI pattern)
+     * Allows styling each internal element separately
+     */
+    classNames?: FFIDUserMenuClassNames;
+    /** Custom avatar component */
+    renderAvatar?: (user: {
+        avatarUrl: string | null;
+        displayName: string | null;
+        email: string;
+    }) => ReactNode;
+    /** Custom menu items */
+    menuItems?: Array<{
+        label: string;
+        onClick: () => void;
+        icon?: ReactNode;
+    }>;
+    /** Show organization info */
+    showOrganization?: boolean;
+    /** Logout button text */
+    logoutText?: string;
+}
+/**
+ * User menu component showing avatar and dropdown
+ */
+declare function FFIDUserMenu({ className, classNames, renderAvatar, menuItems, showOrganization, logoutText, }: FFIDUserMenuProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * ClassNames for styling individual parts of FFIDOrganizationSwitcher
+ * @see https://www.radix-ui.com/primitives/docs/guides/styling
+ */
+interface FFIDOrganizationSwitcherClassNames {
+    /** Container wrapper */
+    container?: string;
+    /** Trigger button */
+    button?: string;
+    /** Dropdown menu */
+    dropdown?: string;
+    /** Organization option (each item) */
+    option?: string;
+    /** Currently selected option (added in addition to option) */
+    optionSelected?: string;
+}
+interface FFIDOrganizationSwitcherProps {
+    /** Custom class name */
+    className?: string;
+    /**
+     * Class names for individual parts (Radix UI pattern)
+     * Allows styling each internal element separately
+     */
+    classNames?: FFIDOrganizationSwitcherClassNames;
+    /** Custom render for organization item */
+    renderOrganization?: (org: FFIDOrganization, isCurrent: boolean) => ReactNode;
+    /** Label text */
+    label?: string;
+    /** Empty state text */
+    emptyText?: string;
+    /** Called when organization is switched */
+    onSwitch?: (organizationId: string) => void;
+}
+/**
+ * Organization switcher dropdown
+ */
+declare function FFIDOrganizationSwitcher({ className, classNames, renderOrganization, label, emptyText, onSwitch, }: FFIDOrganizationSwitcherProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * ClassNames for styling individual parts of FFIDSubscriptionBadge
+ * @see https://www.radix-ui.com/primitives/docs/guides/styling
+ */
+interface FFIDSubscriptionBadgeClassNames {
+    /** The badge span element (also accessible via className prop) */
+    badge?: string;
+}
+interface FFIDSubscriptionBadgeProps {
+    /** Custom class name (applies to badge span) */
+    className?: string;
+    /**
+     * Class names for individual parts (Radix UI pattern)
+     * For this simple component, using className is usually sufficient
+     */
+    classNames?: FFIDSubscriptionBadgeClassNames;
+    /** Custom style */
+    style?: CSSProperties;
+    /** Show plan name instead of status */
+    showPlanName?: boolean;
+    /** Custom labels for each status */
+    labels?: {
+        active?: string;
+        trialing?: string;
+        pastDue?: string;
+        canceled?: string;
+        paused?: string;
+        none?: string;
+    };
+    /** Custom render function */
+    render?: (status: string, planName: string | null) => ReactNode;
+}
+/**
+ * Subscription status badge
+ */
+declare function FFIDSubscriptionBadge({ className, classNames, style, showPlanName, labels, render, }: FFIDSubscriptionBadgeProps): react_jsx_runtime.JSX.Element;
+
+export { type FFIDConfig as F, type FFIDUser as a, type FFIDOrganization as b, type FFIDError as c, type FFIDSubscriptionContextValue as d, type FFIDApiResponse as e, type FFIDContextValue as f, type FFIDLogger as g, FFIDLoginButton as h, FFIDOrganizationSwitcher as i, type FFIDSessionResponse as j, type FFIDSubscription as k, FFIDSubscriptionBadge as l, FFIDUserMenu as m, type FFIDLoginButtonProps as n, type FFIDOrganizationSwitcherClassNames as o, type FFIDOrganizationSwitcherProps as p, type FFIDSubscriptionBadgeClassNames as q, type FFIDSubscriptionBadgeProps as r, type FFIDUserMenuClassNames as s, type FFIDUserMenuProps as t };