@feelflow/ffid-sdk 0.1.0 → 0.2.0

package/dist/{index-CtBBLbTn.d.cts → index-B92_OuFc.d.cts}

@@ -181,6 +181,153 @@ type FFIDApiResponse<T> = {
     error: FFIDError;
 };
 
+/**
+ * FFID Announcements SDK Type Definitions
+ *
+ * Types for the FeelFlow ID Announcements SDK.
+ * Used by client applications to fetch and display announcements.
+ * Issue: #286
+ */
+/**
+ * Announcement type values.
+ * Uses string union with open extension for forward compatibility.
+ */
+type AnnouncementType = 'maintenance.scheduled' | 'maintenance.reminder' | 'maintenance.started' | 'maintenance.completed' | 'incident.detected' | 'incident.resolved' | 'api.deprecation' | 'api.breaking_change' | 'sdk.update_available' | 'security.advisory' | 'billing.payment_reminder' | 'billing.payment_failed' | 'legal.terms_updated' | 'account.security_alert' | (string & {});
+/** Announcement status (only 'published' is visible via public API) */
+type AnnouncementStatus = 'draft' | 'published' | 'archived';
+/** Single announcement returned from the public API */
+interface Announcement {
+    /** Announcement ID (UUID) */
+    id: string;
+    /** Announcement type */
+    type: AnnouncementType;
+    /** Title */
+    title: string;
+    /** Content (Markdown) */
+    content: string;
+    /** Announcement status */
+    status: AnnouncementStatus;
+    /** Scheduled maintenance start time (ISO 8601) */
+    scheduledAt: string | null;
+    /** Maintenance duration in minutes */
+    durationMinutes: number | null;
+    /** Affected service codes */
+    affectedServices: string[];
+    /** Notification channels */
+    channels: string[];
+    /** When the announcement was published (ISO 8601) */
+    publishedAt: string | null;
+    /** Created timestamp (ISO 8601) */
+    createdAt: string;
+    /** Updated timestamp (ISO 8601) */
+    updatedAt: string;
+}
+/** Response from list announcements endpoint */
+interface AnnouncementListResponse {
+    /** List of announcements */
+    announcements: Announcement[];
+    /** Total number of matching announcements */
+    total: number;
+}
+/** Options for listing announcements */
+interface ListAnnouncementsOptions {
+    /** Number of items to return (server default: 20, server max: 100) */
+    limit?: number;
+    /** Offset for pagination (default: 0) */
+    offset?: number;
+}
+/** Configuration for the FFID Announcements Client */
+interface FFIDAnnouncementsClientConfig {
+    /** FFID API base URL (defaults to https://id.feelflow.co.jp) */
+    apiBaseUrl?: string | undefined;
+    /** Enable debug logging */
+    debug?: boolean | undefined;
+    /** Custom logger */
+    logger?: FFIDAnnouncementsLogger | undefined;
+}
+/** Logger interface for Announcements SDK */
+interface FFIDAnnouncementsLogger {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}
+/**
+ * API response wrapper (discriminated union for type safety)
+ *
+ * Either data is present (success) or error is present (failure), never both.
+ */
+type FFIDAnnouncementsApiResponse<T> = {
+    data: T;
+    error?: undefined;
+} | {
+    data?: undefined;
+    error: FFIDAnnouncementsError;
+};
+/**
+ * Known SDK error codes.
+ * Uses string union with open extension for forward compatibility with server error codes.
+ */
+type FFIDAnnouncementsErrorCode = 'NETWORK_ERROR' | 'PARSE_ERROR' | 'UNKNOWN_ERROR' | (string & {});
+/** Error from the Announcements SDK */
+interface FFIDAnnouncementsError {
+    /** Error code (known SDK codes provide autocomplete; server codes also accepted) */
+    code: FFIDAnnouncementsErrorCode;
+    /** Human-readable error message */
+    message: string;
+}
+/** Server response envelope */
+type FFIDAnnouncementsServerResponse<T> = {
+    success: true;
+    data: T;
+    error?: undefined;
+} | {
+    success: false;
+    data?: undefined;
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+
+/** Options for the useFFIDAnnouncements hook */
+interface UseFFIDAnnouncementsOptions {
+    /** Number of items to fetch (default: 20) */
+    limit?: number;
+    /** Offset for pagination (default: 0) */
+    offset?: number;
+    /** FFID API base URL (defaults to production) */
+    apiBaseUrl?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Auto-fetch on mount (default: true) */
+    enabled?: boolean;
+}
+/** Return type for the useFFIDAnnouncements hook */
+interface UseFFIDAnnouncementsReturn {
+    /** List of announcements */
+    announcements: Announcement[];
+    /** Total number of announcements */
+    total: number;
+    /** Number of unread announcements */
+    unreadCount: number;
+    /** Whether data is being loaded */
+    isLoading: boolean;
+    /** Any error that occurred */
+    error: FFIDAnnouncementsError | null;
+    /** Refetch announcements */
+    refetch: () => Promise<void>;
+    /** Mark all announcements as read */
+    markAsRead: () => void;
+}
+/**
+ * Hook to fetch and manage announcements from FFID Platform
+ *
+ * Tracks unread count by storing the last read timestamp in localStorage.
+ * Announcements published after the last read time are counted as unread.
+ */
+declare function useFFIDAnnouncements(options?: UseFFIDAnnouncementsOptions): UseFFIDAnnouncementsReturn;
+
 interface FFIDLoginButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     /** Button content */
     children?: ReactNode;
@@ -319,4 +466,80 @@ interface FFIDSubscriptionBadgeProps {
  */
 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 };
+/** ClassNames for styling individual parts */
+interface FFIDAnnouncementBadgeClassNames {
+    /** The button wrapper element */
+    button?: string;
+    /** The badge count element */
+    badge?: string;
+    /** The bell icon SVG */
+    icon?: string;
+}
+interface FFIDAnnouncementBadgeProps {
+    /** Click handler (e.g., open announcement panel) */
+    onClick?: () => void;
+    /** Custom class name (applies to button) */
+    className?: string;
+    /** Class names for individual parts */
+    classNames?: FFIDAnnouncementBadgeClassNames;
+    /** Custom style for the button */
+    style?: CSSProperties;
+    /** Options passed to useFFIDAnnouncements */
+    announcementOptions?: UseFFIDAnnouncementsOptions;
+    /** Icon size in pixels (default: 20) */
+    iconSize?: number;
+    /** Accessible label (default: 'お知らせ') */
+    ariaLabel?: string;
+}
+/**
+ * Announcement badge with bell icon and unread count
+ */
+declare function FFIDAnnouncementBadge({ onClick, className, classNames, style, announcementOptions, iconSize, ariaLabel, }: FFIDAnnouncementBadgeProps): react_jsx_runtime.JSX.Element;
+
+/** ClassNames for styling individual parts */
+interface FFIDAnnouncementListClassNames {
+    /** The list container */
+    container?: string;
+    /** Each announcement item */
+    item?: string;
+    /** The type icon */
+    icon?: string;
+    /** The title text */
+    title?: string;
+    /** The content text */
+    content?: string;
+    /** The timestamp */
+    timestamp?: string;
+    /** Affected service tag */
+    serviceTag?: string;
+    /** Empty state message */
+    empty?: string;
+}
+interface FFIDAnnouncementListProps {
+    /** Announcements to display */
+    announcements: Announcement[];
+    /** Whether data is loading */
+    isLoading?: boolean;
+    /** Custom class name (applies to container) */
+    className?: string;
+    /** Class names for individual parts */
+    classNames?: FFIDAnnouncementListClassNames;
+    /** Custom style for the container */
+    style?: CSSProperties;
+    /** Date/time formatter (default: Japanese locale) */
+    formatDate?: (dateStr: string) => string;
+    /** Empty state message */
+    emptyMessage?: ReactNode;
+    /** Loading state render */
+    loadingRender?: ReactNode;
+    /** Custom item render */
+    renderItem?: (announcement: Announcement) => ReactNode;
+    /** Max lines for content preview (0 = hide content) */
+    maxContentLines?: number;
+}
+/**
+ * Announcement list component
+ */
+declare function FFIDAnnouncementList({ announcements, isLoading, className, classNames, style, formatDate, emptyMessage, loadingRender, renderItem, maxContentLines, }: FFIDAnnouncementListProps): react_jsx_runtime.JSX.Element;
+
+export { type AnnouncementListResponse as A, type FFIDAnnouncementBadgeClassNames as B, type FFIDAnnouncementBadgeProps as C, type FFIDAnnouncementListClassNames as D, type FFIDAnnouncementListProps as E, type FFIDConfig as F, type FFIDLoginButtonProps as G, type FFIDOrganizationSwitcherClassNames as H, type FFIDOrganizationSwitcherProps as I, type FFIDSubscriptionBadgeClassNames as J, type FFIDSubscriptionBadgeProps as K, type ListAnnouncementsOptions as L, type FFIDUserMenuClassNames as M, type FFIDUserMenuProps as N, type UseFFIDAnnouncementsOptions as U, type FFIDUser as a, type FFIDOrganization as b, type FFIDError as c, type FFIDSubscriptionContextValue as d, type FFIDAnnouncementsClientConfig as e, type FFIDAnnouncementsApiResponse as f, type FFIDAnnouncementsLogger as g, type Announcement as h, type AnnouncementStatus as i, type AnnouncementType as j, FFIDAnnouncementBadge as k, FFIDAnnouncementList as l, type FFIDAnnouncementsError as m, type FFIDAnnouncementsErrorCode as n, type FFIDAnnouncementsServerResponse as o, type FFIDApiResponse as p, type FFIDContextValue as q, type FFIDLogger as r, FFIDLoginButton as s, FFIDOrganizationSwitcher as t, type FFIDSessionResponse as u, type FFIDSubscription as v, FFIDSubscriptionBadge as w, FFIDUserMenu as x, type UseFFIDAnnouncementsReturn as y, useFFIDAnnouncements as z };

package/dist/{index-CtBBLbTn.d.ts → index-B92_OuFc.d.ts}

@@ -181,6 +181,153 @@ type FFIDApiResponse<T> = {
     error: FFIDError;
 };
 
+/**
+ * FFID Announcements SDK Type Definitions
+ *
+ * Types for the FeelFlow ID Announcements SDK.
+ * Used by client applications to fetch and display announcements.
+ * Issue: #286
+ */
+/**
+ * Announcement type values.
+ * Uses string union with open extension for forward compatibility.
+ */
+type AnnouncementType = 'maintenance.scheduled' | 'maintenance.reminder' | 'maintenance.started' | 'maintenance.completed' | 'incident.detected' | 'incident.resolved' | 'api.deprecation' | 'api.breaking_change' | 'sdk.update_available' | 'security.advisory' | 'billing.payment_reminder' | 'billing.payment_failed' | 'legal.terms_updated' | 'account.security_alert' | (string & {});
+/** Announcement status (only 'published' is visible via public API) */
+type AnnouncementStatus = 'draft' | 'published' | 'archived';
+/** Single announcement returned from the public API */
+interface Announcement {
+    /** Announcement ID (UUID) */
+    id: string;
+    /** Announcement type */
+    type: AnnouncementType;
+    /** Title */
+    title: string;
+    /** Content (Markdown) */
+    content: string;
+    /** Announcement status */
+    status: AnnouncementStatus;
+    /** Scheduled maintenance start time (ISO 8601) */
+    scheduledAt: string | null;
+    /** Maintenance duration in minutes */
+    durationMinutes: number | null;
+    /** Affected service codes */
+    affectedServices: string[];
+    /** Notification channels */
+    channels: string[];
+    /** When the announcement was published (ISO 8601) */
+    publishedAt: string | null;
+    /** Created timestamp (ISO 8601) */
+    createdAt: string;
+    /** Updated timestamp (ISO 8601) */
+    updatedAt: string;
+}
+/** Response from list announcements endpoint */
+interface AnnouncementListResponse {
+    /** List of announcements */
+    announcements: Announcement[];
+    /** Total number of matching announcements */
+    total: number;
+}
+/** Options for listing announcements */
+interface ListAnnouncementsOptions {
+    /** Number of items to return (server default: 20, server max: 100) */
+    limit?: number;
+    /** Offset for pagination (default: 0) */
+    offset?: number;
+}
+/** Configuration for the FFID Announcements Client */
+interface FFIDAnnouncementsClientConfig {
+    /** FFID API base URL (defaults to https://id.feelflow.co.jp) */
+    apiBaseUrl?: string | undefined;
+    /** Enable debug logging */
+    debug?: boolean | undefined;
+    /** Custom logger */
+    logger?: FFIDAnnouncementsLogger | undefined;
+}
+/** Logger interface for Announcements SDK */
+interface FFIDAnnouncementsLogger {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}
+/**
+ * API response wrapper (discriminated union for type safety)
+ *
+ * Either data is present (success) or error is present (failure), never both.
+ */
+type FFIDAnnouncementsApiResponse<T> = {
+    data: T;
+    error?: undefined;
+} | {
+    data?: undefined;
+    error: FFIDAnnouncementsError;
+};
+/**
+ * Known SDK error codes.
+ * Uses string union with open extension for forward compatibility with server error codes.
+ */
+type FFIDAnnouncementsErrorCode = 'NETWORK_ERROR' | 'PARSE_ERROR' | 'UNKNOWN_ERROR' | (string & {});
+/** Error from the Announcements SDK */
+interface FFIDAnnouncementsError {
+    /** Error code (known SDK codes provide autocomplete; server codes also accepted) */
+    code: FFIDAnnouncementsErrorCode;
+    /** Human-readable error message */
+    message: string;
+}
+/** Server response envelope */
+type FFIDAnnouncementsServerResponse<T> = {
+    success: true;
+    data: T;
+    error?: undefined;
+} | {
+    success: false;
+    data?: undefined;
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+
+/** Options for the useFFIDAnnouncements hook */
+interface UseFFIDAnnouncementsOptions {
+    /** Number of items to fetch (default: 20) */
+    limit?: number;
+    /** Offset for pagination (default: 0) */
+    offset?: number;
+    /** FFID API base URL (defaults to production) */
+    apiBaseUrl?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Auto-fetch on mount (default: true) */
+    enabled?: boolean;
+}
+/** Return type for the useFFIDAnnouncements hook */
+interface UseFFIDAnnouncementsReturn {
+    /** List of announcements */
+    announcements: Announcement[];
+    /** Total number of announcements */
+    total: number;
+    /** Number of unread announcements */
+    unreadCount: number;
+    /** Whether data is being loaded */
+    isLoading: boolean;
+    /** Any error that occurred */
+    error: FFIDAnnouncementsError | null;
+    /** Refetch announcements */
+    refetch: () => Promise<void>;
+    /** Mark all announcements as read */
+    markAsRead: () => void;
+}
+/**
+ * Hook to fetch and manage announcements from FFID Platform
+ *
+ * Tracks unread count by storing the last read timestamp in localStorage.
+ * Announcements published after the last read time are counted as unread.
+ */
+declare function useFFIDAnnouncements(options?: UseFFIDAnnouncementsOptions): UseFFIDAnnouncementsReturn;
+
 interface FFIDLoginButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     /** Button content */
     children?: ReactNode;
@@ -319,4 +466,80 @@ interface FFIDSubscriptionBadgeProps {
  */
 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 };
+/** ClassNames for styling individual parts */
+interface FFIDAnnouncementBadgeClassNames {
+    /** The button wrapper element */
+    button?: string;
+    /** The badge count element */
+    badge?: string;
+    /** The bell icon SVG */
+    icon?: string;
+}
+interface FFIDAnnouncementBadgeProps {
+    /** Click handler (e.g., open announcement panel) */
+    onClick?: () => void;
+    /** Custom class name (applies to button) */
+    className?: string;
+    /** Class names for individual parts */
+    classNames?: FFIDAnnouncementBadgeClassNames;
+    /** Custom style for the button */
+    style?: CSSProperties;
+    /** Options passed to useFFIDAnnouncements */
+    announcementOptions?: UseFFIDAnnouncementsOptions;
+    /** Icon size in pixels (default: 20) */
+    iconSize?: number;
+    /** Accessible label (default: 'お知らせ') */
+    ariaLabel?: string;
+}
+/**
+ * Announcement badge with bell icon and unread count
+ */
+declare function FFIDAnnouncementBadge({ onClick, className, classNames, style, announcementOptions, iconSize, ariaLabel, }: FFIDAnnouncementBadgeProps): react_jsx_runtime.JSX.Element;
+
+/** ClassNames for styling individual parts */
+interface FFIDAnnouncementListClassNames {
+    /** The list container */
+    container?: string;
+    /** Each announcement item */
+    item?: string;
+    /** The type icon */
+    icon?: string;
+    /** The title text */
+    title?: string;
+    /** The content text */
+    content?: string;
+    /** The timestamp */
+    timestamp?: string;
+    /** Affected service tag */
+    serviceTag?: string;
+    /** Empty state message */
+    empty?: string;
+}
+interface FFIDAnnouncementListProps {
+    /** Announcements to display */
+    announcements: Announcement[];
+    /** Whether data is loading */
+    isLoading?: boolean;
+    /** Custom class name (applies to container) */
+    className?: string;
+    /** Class names for individual parts */
+    classNames?: FFIDAnnouncementListClassNames;
+    /** Custom style for the container */
+    style?: CSSProperties;
+    /** Date/time formatter (default: Japanese locale) */
+    formatDate?: (dateStr: string) => string;
+    /** Empty state message */
+    emptyMessage?: ReactNode;
+    /** Loading state render */
+    loadingRender?: ReactNode;
+    /** Custom item render */
+    renderItem?: (announcement: Announcement) => ReactNode;
+    /** Max lines for content preview (0 = hide content) */
+    maxContentLines?: number;
+}
+/**
+ * Announcement list component
+ */
+declare function FFIDAnnouncementList({ announcements, isLoading, className, classNames, style, formatDate, emptyMessage, loadingRender, renderItem, maxContentLines, }: FFIDAnnouncementListProps): react_jsx_runtime.JSX.Element;
+
+export { type AnnouncementListResponse as A, type FFIDAnnouncementBadgeClassNames as B, type FFIDAnnouncementBadgeProps as C, type FFIDAnnouncementListClassNames as D, type FFIDAnnouncementListProps as E, type FFIDConfig as F, type FFIDLoginButtonProps as G, type FFIDOrganizationSwitcherClassNames as H, type FFIDOrganizationSwitcherProps as I, type FFIDSubscriptionBadgeClassNames as J, type FFIDSubscriptionBadgeProps as K, type ListAnnouncementsOptions as L, type FFIDUserMenuClassNames as M, type FFIDUserMenuProps as N, type UseFFIDAnnouncementsOptions as U, type FFIDUser as a, type FFIDOrganization as b, type FFIDError as c, type FFIDSubscriptionContextValue as d, type FFIDAnnouncementsClientConfig as e, type FFIDAnnouncementsApiResponse as f, type FFIDAnnouncementsLogger as g, type Announcement as h, type AnnouncementStatus as i, type AnnouncementType as j, FFIDAnnouncementBadge as k, FFIDAnnouncementList as l, type FFIDAnnouncementsError as m, type FFIDAnnouncementsErrorCode as n, type FFIDAnnouncementsServerResponse as o, type FFIDApiResponse as p, type FFIDContextValue as q, type FFIDLogger as r, FFIDLoginButton as s, FFIDOrganizationSwitcher as t, type FFIDSessionResponse as u, type FFIDSubscription as v, FFIDSubscriptionBadge as w, FFIDUserMenu as x, type UseFFIDAnnouncementsReturn as y, useFFIDAnnouncements as z };

package/dist/index.cjs

@@ -1,12 +1,12 @@
 'use strict';
 
-var chunkYCMQXJOS_cjs = require('./chunk-YCMQXJOS.cjs');
+var chunkA6YJDYIX_cjs = require('./chunk-A6YJDYIX.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
 function withFFIDAuth(Component, options = {}) {
   const WrappedComponent = (props) => {
-    const { isLoading, isAuthenticated, login } = chunkYCMQXJOS_cjs.useFFIDContext();
+    const { isLoading, isAuthenticated, login } = chunkA6YJDYIX_cjs.useFFIDContext();
     const hasRedirected = react.useRef(false);
     react.useEffect(() => {
       if (!isLoading && !isAuthenticated && options.redirectToLogin && !hasRedirected.current) {
@@ -31,38 +31,58 @@ function withFFIDAuth(Component, options = {}) {
 
 Object.defineProperty(exports, "DEFAULT_API_BASE_URL", {
   enumerable: true,
-  get: function () { return chunkYCMQXJOS_cjs.DEFAULT_API_BASE_URL; }
+  get: function () { return chunkA6YJDYIX_cjs.DEFAULT_API_BASE_URL; }
+});
+Object.defineProperty(exports, "FFIDAnnouncementBadge", {
+  enumerable: true,
+  get: function () { return chunkA6YJDYIX_cjs.FFIDAnnouncementBadge; }
+});
+Object.defineProperty(exports, "FFIDAnnouncementList", {
+  enumerable: true,
+  get: function () { return chunkA6YJDYIX_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunkYCMQXJOS_cjs.FFIDLoginButton; }
+  get: function () { return chunkA6YJDYIX_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunkYCMQXJOS_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkA6YJDYIX_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDProvider", {
   enumerable: true,
-  get: function () { return chunkYCMQXJOS_cjs.FFIDProvider; }
+  get: function () { return chunkA6YJDYIX_cjs.FFIDProvider; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunkYCMQXJOS_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkA6YJDYIX_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunkYCMQXJOS_cjs.FFIDUserMenu; }
+  get: function () { return chunkA6YJDYIX_cjs.FFIDUserMenu; }
+});
+Object.defineProperty(exports, "FFID_ANNOUNCEMENTS_ERROR_CODES", {
+  enumerable: true,
+  get: function () { return chunkA6YJDYIX_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
+});
+Object.defineProperty(exports, "createFFIDAnnouncementsClient", {
+  enumerable: true,
+  get: function () { return chunkA6YJDYIX_cjs.createFFIDAnnouncementsClient; }
 });
 Object.defineProperty(exports, "useFFID", {
   enumerable: true,
-  get: function () { return chunkYCMQXJOS_cjs.useFFID; }
+  get: function () { return chunkA6YJDYIX_cjs.useFFID; }
+});
+Object.defineProperty(exports, "useFFIDAnnouncements", {
+  enumerable: true,
+  get: function () { return chunkA6YJDYIX_cjs.useFFIDAnnouncements; }
 });
 Object.defineProperty(exports, "useSubscription", {
   enumerable: true,
-  get: function () { return chunkYCMQXJOS_cjs.useSubscription; }
+  get: function () { return chunkA6YJDYIX_cjs.useSubscription; }
 });
 Object.defineProperty(exports, "withSubscription", {
   enumerable: true,
-  get: function () { return chunkYCMQXJOS_cjs.withSubscription; }
+  get: function () { return chunkA6YJDYIX_cjs.withSubscription; }
 });
 exports.withFFIDAuth = withFFIDAuth;

package/dist/index.d.cts

@@ -1,12 +1,12 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, FC } from 'react';
-import { F as FFIDConfig, a as FFIDUser, b as FFIDOrganization, c as FFIDError, d as FFIDSubscriptionContextValue } from './index-CtBBLbTn.cjs';
-export { e as FFIDApiResponse, f as FFIDContextValue, g as FFIDLogger, h as FFIDLoginButton, i as FFIDOrganizationSwitcher, j as FFIDSessionResponse, k as FFIDSubscription, l as FFIDSubscriptionBadge, m as FFIDUserMenu } from './index-CtBBLbTn.cjs';
+import { F as FFIDConfig, a as FFIDUser, b as FFIDOrganization, c as FFIDError, d as FFIDSubscriptionContextValue, e as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, f as FFIDAnnouncementsApiResponse, A as AnnouncementListResponse, g as FFIDAnnouncementsLogger } from './index-B92_OuFc.cjs';
+export { h as Announcement, i as AnnouncementStatus, j as AnnouncementType, k as FFIDAnnouncementBadge, l as FFIDAnnouncementList, m as FFIDAnnouncementsError, n as FFIDAnnouncementsErrorCode, o as FFIDAnnouncementsServerResponse, p as FFIDApiResponse, q as FFIDContextValue, r as FFIDLogger, s as FFIDLoginButton, t as FFIDOrganizationSwitcher, u as FFIDSessionResponse, v as FFIDSubscription, w as FFIDSubscriptionBadge, x as FFIDUserMenu, U as UseFFIDAnnouncementsOptions, y as UseFFIDAnnouncementsReturn, z as useFFIDAnnouncements } from './index-B92_OuFc.cjs';
 
 /**
  * FFID SDK Shared Constants
  *
- * Constants shared across all SDK entry points (main client + legal client).
+ * Constants shared across all SDK entry points.
  * Centralizing these prevents drift during domain/URL changes.
  */
 /** Default FFID API base URL (production) */
@@ -178,4 +178,59 @@ interface WithFFIDAuthOptions {
  */
 declare function withFFIDAuth<P extends object>(Component: ComponentType<P>, options?: WithFFIDAuthOptions): FC<P>;
 
-export { DEFAULT_API_BASE_URL, FFIDConfig, FFIDError, FFIDOrganization, FFIDProvider, type FFIDProviderProps, FFIDSubscriptionContextValue, FFIDUser, type UseFFIDReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, useFFID, useSubscription, withFFIDAuth, withSubscription };
+/**
+ * FFID Announcements API Client
+ *
+ * Handles API communication for public announcements.
+ * No authentication required - this is a public endpoint.
+ *
+ * @example
+ * ```typescript
+ * import { createFFIDAnnouncementsClient } from '@feelflow/ffid-sdk/announcements'
+ *
+ * const client = createFFIDAnnouncementsClient({
+ *   apiBaseUrl: 'https://id.feelflow.co.jp',
+ * })
+ *
+ * const { data, error } = await client.listAnnouncements({ limit: 10 })
+ * if (data) {
+ *   console.log(`Found ${data.total} announcements`)
+ * }
+ * ```
+ */
+
+/**
+ * Error codes used by the Announcements SDK
+ */
+declare const FFID_ANNOUNCEMENTS_ERROR_CODES: {
+    /** Network request failed (fetch threw) */
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    /** Failed to parse server response as JSON */
+    readonly PARSE_ERROR: "PARSE_ERROR";
+    /** Server returned error without structured error body */
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+};
+/**
+ * Creates an FFID Announcements API client instance
+ *
+ * @param config - Client configuration (optional, uses defaults)
+ * @returns Announcements client instance
+ *
+ * @example
+ * ```typescript
+ * const client = createFFIDAnnouncementsClient()
+ * const { data, error } = await client.listAnnouncements()
+ * ```
+ */
+declare function createFFIDAnnouncementsClient(config?: FFIDAnnouncementsClientConfig): {
+    /** List published announcements */
+    listAnnouncements: (options?: ListAnnouncementsOptions) => Promise<FFIDAnnouncementsApiResponse<AnnouncementListResponse>>;
+    /** Resolved logger instance */
+    logger: FFIDAnnouncementsLogger;
+    /** API base URL */
+    baseUrl: string;
+};
+/** Type of the FFID Announcements client */
+type FFIDAnnouncementsClient = ReturnType<typeof createFFIDAnnouncementsClient>;
+
+export { AnnouncementListResponse, DEFAULT_API_BASE_URL, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDConfig, FFIDError, FFIDOrganization, FFIDProvider, type FFIDProviderProps, FFIDSubscriptionContextValue, FFIDUser, FFID_ANNOUNCEMENTS_ERROR_CODES, ListAnnouncementsOptions, type UseFFIDReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, createFFIDAnnouncementsClient, useFFID, useSubscription, withFFIDAuth, withSubscription };