@fhirfly-io/terminology 0.9.0 → 0.10.0

package/dist/index.d.cts

@@ -2292,6 +2292,244 @@ declare class ClaimsEndpoint {
     checkCoverage(hcpcs: string, options?: CoverageCheckOptions): Promise<CoverageCheckResponse>;
 }
 
+/**
+ * SMA Endpoint Directory API types.
+ *
+ * Types for looking up state Medicaid agency FHIR endpoint implementation
+ * status, including patient access and provider directory endpoints.
+ */
+/**
+ * Options for filtering the SMA states list.
+ */
+interface SmaListOptions {
+    /** Filter by implementation status */
+    implemented?: boolean;
+    /** Filter by API vendor (e.g., "Epic") */
+    vendor?: string;
+    /** Filter by patient access status */
+    status?: string;
+    /** Filter by FHIR version (e.g., "4.0.1") */
+    fhir_version?: string;
+}
+/**
+ * Summary of a state's SMA endpoint implementation status.
+ */
+interface SmaStateSummary {
+    /** State identifier (e.g., "california") */
+    id: string;
+    /** State display name (e.g., "California") */
+    state: string;
+    /** Two-letter abbreviation (e.g., "CA") or null for territories */
+    abbreviation: string | null;
+    /** Whether the state has implemented FHIR endpoints */
+    is_implemented: boolean;
+    /** API vendor (e.g., "Epic") or null */
+    api_vendor: string | null;
+    /** Patient access API status */
+    patient_access_status: string | null;
+    /** Provider directory API status */
+    provider_directory_status: string | null;
+    /** Number of production endpoint URLs */
+    production_url_count: number;
+    /** FHIR version (e.g., "4.0.1") */
+    fhir_version: string | null;
+}
+/**
+ * Response metadata for SMA lookups.
+ */
+interface SmaMetaResponse {
+    /** Timestamp of when data was last updated */
+    data_as_of: string;
+    /** Data source name */
+    source: string;
+    /** URL to the source data */
+    source_url: string;
+}
+/**
+ * List of states with SMA endpoint implementation status.
+ */
+interface SmaStatesListResponse {
+    /** Array of state summaries */
+    states: SmaStateSummary[];
+    /** Total number of states returned */
+    total: number;
+    /** Response metadata */
+    meta: SmaMetaResponse;
+}
+/**
+ * Full detail for a single state's SMA endpoint implementation.
+ */
+interface SmaStateDetailResponse {
+    /** State identifier (e.g., "california") */
+    id: string;
+    /** State display name */
+    state: string;
+    /** Two-letter abbreviation or null */
+    abbreviation: string | null;
+    /** API vendor or null */
+    api_vendor: string | null;
+    /** Date of most recent survey or null */
+    survey_date: string | null;
+    /** Whether FHIR endpoints are implemented */
+    is_implemented: boolean;
+    /** Patient access API details */
+    patient_access: {
+        status: string | null;
+        implementation_date: string | null;
+        fhir_version: string | null;
+        auth_protocol: string | null;
+        refresh_frequency: string | null;
+        endpoints: {
+            claims: string[];
+            pdex: string[];
+            formulary: string[];
+            chip: string[];
+            capability_statement: string[];
+            sandbox: string[];
+        };
+    };
+    /** Provider directory API details */
+    provider_directory: {
+        status: string | null;
+        implementation_date: string | null;
+        fhir_version: string | null;
+        is_public: boolean | null;
+        refresh_frequency: string | null;
+        endpoints: {
+            production: string[];
+            capability_statement: string[];
+            sandbox: string[];
+        };
+    };
+    /** Contact information */
+    contacts: {
+        member_phone: string | null;
+        member_email: string | null;
+        developer_contact: string | null;
+        pd_developer_contact: string | null;
+        registration_info: string | null;
+        pd_registration_info: string | null;
+    };
+    /** All production endpoint URLs */
+    all_production_urls: string[];
+    /** Response metadata (includes ingested_at) */
+    meta: SmaMetaResponse & {
+        ingested_at: string;
+    };
+}
+/**
+ * Aggregate statistics across all SMA endpoint implementations.
+ */
+interface SmaStatsResponse {
+    /** Summary counts */
+    summary: {
+        total_states: number;
+        implemented: number;
+        not_implemented: number;
+        total_production_urls: number;
+    };
+    /** Counts by API vendor */
+    by_vendor: Record<string, number>;
+    /** Counts by patient access status */
+    by_patient_access_status: Record<string, number>;
+    /** Counts by FHIR version */
+    by_fhir_version: Record<string, number>;
+    /** Counts by authentication protocol */
+    by_auth_protocol: Record<string, number>;
+    /** Provider directory statistics */
+    provider_directory: {
+        total_with_pd: number;
+        by_status: Record<string, number>;
+    };
+    /** Response metadata */
+    meta: SmaMetaResponse;
+}
+
+/**
+ * SMA (State Medicaid Agency) Endpoint Directory API endpoints.
+ *
+ * Provides access to CMS SMA Endpoint Directory data showing which state
+ * Medicaid agencies have implemented FHIR-based patient access and provider
+ * directory APIs.
+ *
+ * All SMA endpoints require the `connectivity.read` scope.
+ *
+ * @example
+ * ```ts
+ * // List all implemented states
+ * const list = await client.sma.listStates({ implemented: true });
+ * console.log(`${list.total} states have FHIR endpoints`);
+ *
+ * // Get details for California
+ * const ca = await client.sma.getState("CA");
+ * console.log(`Vendor: ${ca.api_vendor}`);
+ * console.log(`Claims endpoints: ${ca.patient_access.endpoints.claims.length}`);
+ *
+ * // Get aggregate statistics
+ * const stats = await client.sma.stats();
+ * console.log(`${stats.summary.implemented} of ${stats.summary.total_states} implemented`);
+ * ```
+ */
+declare class SmaEndpoint {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all states with SMA endpoint implementation status.
+     *
+     * @param options - Optional filters (implemented, vendor, status, fhir_version)
+     * @returns List of state summaries with implementation status
+     *
+     * @example
+     * ```ts
+     * // All states
+     * const all = await client.sma.listStates();
+     *
+     * // Only Epic-based implementations
+     * const epic = await client.sma.listStates({ vendor: "Epic" });
+     *
+     * // Only implemented states
+     * const live = await client.sma.listStates({ implemented: true });
+     * ```
+     */
+    listStates(options?: SmaListOptions): Promise<SmaStatesListResponse>;
+    /**
+     * Get full SMA details for a specific state.
+     *
+     * Accepts state abbreviation (CA), underscore ID (california), or
+     * display name (California).
+     *
+     * @param state - State identifier (abbreviation, ID, or display name)
+     * @returns Full state detail with endpoints, contacts, and metadata
+     *
+     * @example
+     * ```ts
+     * const ca = await client.sma.getState("CA");
+     * console.log(`${ca.state}: ${ca.is_implemented ? "Implemented" : "Not implemented"}`);
+     *
+     * for (const url of ca.patient_access.endpoints.claims) {
+     *   console.log(`Claims endpoint: ${url}`);
+     * }
+     * ```
+     */
+    getState(state: string): Promise<SmaStateDetailResponse>;
+    /**
+     * Get aggregate SMA statistics.
+     *
+     * Returns implementation counts, breakdowns by vendor/status/FHIR version,
+     * and provider directory statistics.
+     *
+     * @returns Aggregate statistics across all states
+     *
+     * @example
+     * ```ts
+     * const stats = await client.sma.stats();
+     * console.log(`${stats.summary.implemented} / ${stats.summary.total_states} states implemented`);
+     * console.log(`Total production URLs: ${stats.summary.total_production_urls}`);
+     * ```
+     */
+    stats(): Promise<SmaStatsResponse>;
+}
+
 /**
  * Base configuration options shared by all auth modes.
  */
@@ -2434,6 +2672,11 @@ declare class Fhirfly {
      * NCCI PTP validation, MUE limits, PFS/RVU fee schedule, LCD/NCD coverage.
      */
     readonly claims: ClaimsEndpoint;
+    /**
+     * SMA (State Medicaid Agency) Endpoint Directory (requires `connectivity.read` scope).
+     * State FHIR endpoint implementation status, patient access, and provider directories.
+     */
+    readonly sma: SmaEndpoint;
     /**
      * Create a new FHIRfly client.
      *
@@ -2519,4 +2762,4 @@ declare class TimeoutError extends FhirflyError {
     constructor(timeoutMs: number);
 }
 
-export { type ActiveIngredient, ApiError, type ApiResponse, AuthenticationError, type AuthorizedOfficial, type BatchLookupOptions, type BatchResponse, type BatchResultItem, type ClaimsLegalInfo, type ClaimsMeta, type ConnectivityEndpointData, type ConnectivityMeta, type ConnectivityTargetData, type CoverageCheckData, type CoverageCheckItem, type CoverageCheckResponse, type CoveragePolicyType, type CvxCompact, type CvxData, type CvxFull, type CvxSearchParams, type CvxStandard, type Deactivation, type DisplayField, type EndpointAuthRequirements, type EndpointAvailability, type EnrichedTaxonomy, type EvidenceSummary, type FdaLabelBundleName, type FdaLabelData, type FdaLabelLookupOptions, type FdaLabelMetadata, type FdaLabelSearchCompact, type FdaLabelSearchData, type FdaLabelSearchFull, type FdaLabelSearchParams, type FdaLabelSearchStandard, type FhirMetadata, Fhirfly, type FhirflyApiKeyConfig, type FhirflyConfig, FhirflyError, type FhirflyOAuthConfig, type Icd10Compact, type Icd10Data, type Icd10Full, type Icd10SearchParams, type Icd10Standard, type Icd10Type, type IncludeOption, type IpsCategory, type LegalInfo, type LoincCompact, type LoincData, type LoincFhirCoding, type LoincFull, type LoincParts, type LoincRanks, type LoincSearchParams, type LoincSourceOrg, type LoincStandard, type LoincUnits, type LookupOptions, type MueBatchResponse, type MueBatchResultItem, type MueLimitItem, type MueLookupData, type MueLookupResponse, type MueServiceType, type MvxCompact, type MvxData, type MvxFhirCoding, type MvxFull, type MvxIngest, type MvxSearchParams, type MvxStandard, type NcciClaimType, type NcciEditItem, type NcciValidateData, type NcciValidateResponse, type NdcCompact, type NdcData, type NdcFull, type NdcSearchParams, type NdcStandard, type NdcType, NetworkError, NotFoundError, type NpiAddress, type NpiCompact, type NpiConnectivityData, type NpiData, type NpiFull, type NpiSearchParams, type NpiStandard, type OtherIdentifier, type PersonName, type PfsBatchResponse, type PfsBatchResultItem, type PfsIndicators, type PfsLookupData, type PfsLookupResponse, type PfsPayment, type PfsRvu, type ProviderSummary, QuotaExceededError, RateLimitError, type ResponseMeta, type ResponseShape, type RxNormCompact, type RxNormData, type RxNormFull, type RxNormSearchParams, type RxNormStandard, type RxTermType, type SearchFacets, type SearchLegalInfo, type SearchOptions, type SearchResponse, type SecondaryLocation, ServerError, type SnomedBatchResultItem, type SnomedCategoriesResponse, type SnomedConcept, type SnomedEnrichmentFull, type SnomedEnrichmentStandard, type SnomedMappingSource, type SnomedMappingSourceSystem, type SnomedMappingType, type SnomedReverseMapping, type SnomedReverseMappingData, type SnomedSearchParams, TimeoutError, TokenManager, ValidationError };
+export { type ActiveIngredient, ApiError, type ApiResponse, AuthenticationError, type AuthorizedOfficial, type BatchLookupOptions, type BatchResponse, type BatchResultItem, type ClaimsLegalInfo, type ClaimsMeta, type ConnectivityEndpointData, type ConnectivityMeta, type ConnectivityTargetData, type CoverageCheckData, type CoverageCheckItem, type CoverageCheckResponse, type CoveragePolicyType, type CvxCompact, type CvxData, type CvxFull, type CvxSearchParams, type CvxStandard, type Deactivation, type DisplayField, type EndpointAuthRequirements, type EndpointAvailability, type EnrichedTaxonomy, type EvidenceSummary, type FdaLabelBundleName, type FdaLabelData, type FdaLabelLookupOptions, type FdaLabelMetadata, type FdaLabelSearchCompact, type FdaLabelSearchData, type FdaLabelSearchFull, type FdaLabelSearchParams, type FdaLabelSearchStandard, type FhirMetadata, Fhirfly, type FhirflyApiKeyConfig, type FhirflyConfig, FhirflyError, type FhirflyOAuthConfig, type Icd10Compact, type Icd10Data, type Icd10Full, type Icd10SearchParams, type Icd10Standard, type Icd10Type, type IncludeOption, type IpsCategory, type LegalInfo, type LoincCompact, type LoincData, type LoincFhirCoding, type LoincFull, type LoincParts, type LoincRanks, type LoincSearchParams, type LoincSourceOrg, type LoincStandard, type LoincUnits, type LookupOptions, type MueBatchResponse, type MueBatchResultItem, type MueLimitItem, type MueLookupData, type MueLookupResponse, type MueServiceType, type MvxCompact, type MvxData, type MvxFhirCoding, type MvxFull, type MvxIngest, type MvxSearchParams, type MvxStandard, type NcciClaimType, type NcciEditItem, type NcciValidateData, type NcciValidateResponse, type NdcCompact, type NdcData, type NdcFull, type NdcSearchParams, type NdcStandard, type NdcType, NetworkError, NotFoundError, type NpiAddress, type NpiCompact, type NpiConnectivityData, type NpiData, type NpiFull, type NpiSearchParams, type NpiStandard, type OtherIdentifier, type PersonName, type PfsBatchResponse, type PfsBatchResultItem, type PfsIndicators, type PfsLookupData, type PfsLookupResponse, type PfsPayment, type PfsRvu, type ProviderSummary, QuotaExceededError, RateLimitError, type ResponseMeta, type ResponseShape, type RxNormCompact, type RxNormData, type RxNormFull, type RxNormSearchParams, type RxNormStandard, type RxTermType, type SearchFacets, type SearchLegalInfo, type SearchOptions, type SearchResponse, type SecondaryLocation, ServerError, type SmaListOptions, type SmaMetaResponse, type SmaStateDetailResponse, type SmaStateSummary, type SmaStatesListResponse, type SmaStatsResponse, type SnomedBatchResultItem, type SnomedCategoriesResponse, type SnomedConcept, type SnomedEnrichmentFull, type SnomedEnrichmentStandard, type SnomedMappingSource, type SnomedMappingSourceSystem, type SnomedMappingType, type SnomedReverseMapping, type SnomedReverseMappingData, type SnomedSearchParams, TimeoutError, TokenManager, ValidationError };

package/dist/index.d.ts

@@ -2292,6 +2292,244 @@ declare class ClaimsEndpoint {
     checkCoverage(hcpcs: string, options?: CoverageCheckOptions): Promise<CoverageCheckResponse>;
 }
 
+/**
+ * SMA Endpoint Directory API types.
+ *
+ * Types for looking up state Medicaid agency FHIR endpoint implementation
+ * status, including patient access and provider directory endpoints.
+ */
+/**
+ * Options for filtering the SMA states list.
+ */
+interface SmaListOptions {
+    /** Filter by implementation status */
+    implemented?: boolean;
+    /** Filter by API vendor (e.g., "Epic") */
+    vendor?: string;
+    /** Filter by patient access status */
+    status?: string;
+    /** Filter by FHIR version (e.g., "4.0.1") */
+    fhir_version?: string;
+}
+/**
+ * Summary of a state's SMA endpoint implementation status.
+ */
+interface SmaStateSummary {
+    /** State identifier (e.g., "california") */
+    id: string;
+    /** State display name (e.g., "California") */
+    state: string;
+    /** Two-letter abbreviation (e.g., "CA") or null for territories */
+    abbreviation: string | null;
+    /** Whether the state has implemented FHIR endpoints */
+    is_implemented: boolean;
+    /** API vendor (e.g., "Epic") or null */
+    api_vendor: string | null;
+    /** Patient access API status */
+    patient_access_status: string | null;
+    /** Provider directory API status */
+    provider_directory_status: string | null;
+    /** Number of production endpoint URLs */
+    production_url_count: number;
+    /** FHIR version (e.g., "4.0.1") */
+    fhir_version: string | null;
+}
+/**
+ * Response metadata for SMA lookups.
+ */
+interface SmaMetaResponse {
+    /** Timestamp of when data was last updated */
+    data_as_of: string;
+    /** Data source name */
+    source: string;
+    /** URL to the source data */
+    source_url: string;
+}
+/**
+ * List of states with SMA endpoint implementation status.
+ */
+interface SmaStatesListResponse {
+    /** Array of state summaries */
+    states: SmaStateSummary[];
+    /** Total number of states returned */
+    total: number;
+    /** Response metadata */
+    meta: SmaMetaResponse;
+}
+/**
+ * Full detail for a single state's SMA endpoint implementation.
+ */
+interface SmaStateDetailResponse {
+    /** State identifier (e.g., "california") */
+    id: string;
+    /** State display name */
+    state: string;
+    /** Two-letter abbreviation or null */
+    abbreviation: string | null;
+    /** API vendor or null */
+    api_vendor: string | null;
+    /** Date of most recent survey or null */
+    survey_date: string | null;
+    /** Whether FHIR endpoints are implemented */
+    is_implemented: boolean;
+    /** Patient access API details */
+    patient_access: {
+        status: string | null;
+        implementation_date: string | null;
+        fhir_version: string | null;
+        auth_protocol: string | null;
+        refresh_frequency: string | null;
+        endpoints: {
+            claims: string[];
+            pdex: string[];
+            formulary: string[];
+            chip: string[];
+            capability_statement: string[];
+            sandbox: string[];
+        };
+    };
+    /** Provider directory API details */
+    provider_directory: {
+        status: string | null;
+        implementation_date: string | null;
+        fhir_version: string | null;
+        is_public: boolean | null;
+        refresh_frequency: string | null;
+        endpoints: {
+            production: string[];
+            capability_statement: string[];
+            sandbox: string[];
+        };
+    };
+    /** Contact information */
+    contacts: {
+        member_phone: string | null;
+        member_email: string | null;
+        developer_contact: string | null;
+        pd_developer_contact: string | null;
+        registration_info: string | null;
+        pd_registration_info: string | null;
+    };
+    /** All production endpoint URLs */
+    all_production_urls: string[];
+    /** Response metadata (includes ingested_at) */
+    meta: SmaMetaResponse & {
+        ingested_at: string;
+    };
+}
+/**
+ * Aggregate statistics across all SMA endpoint implementations.
+ */
+interface SmaStatsResponse {
+    /** Summary counts */
+    summary: {
+        total_states: number;
+        implemented: number;
+        not_implemented: number;
+        total_production_urls: number;
+    };
+    /** Counts by API vendor */
+    by_vendor: Record<string, number>;
+    /** Counts by patient access status */
+    by_patient_access_status: Record<string, number>;
+    /** Counts by FHIR version */
+    by_fhir_version: Record<string, number>;
+    /** Counts by authentication protocol */
+    by_auth_protocol: Record<string, number>;
+    /** Provider directory statistics */
+    provider_directory: {
+        total_with_pd: number;
+        by_status: Record<string, number>;
+    };
+    /** Response metadata */
+    meta: SmaMetaResponse;
+}
+
+/**
+ * SMA (State Medicaid Agency) Endpoint Directory API endpoints.
+ *
+ * Provides access to CMS SMA Endpoint Directory data showing which state
+ * Medicaid agencies have implemented FHIR-based patient access and provider
+ * directory APIs.
+ *
+ * All SMA endpoints require the `connectivity.read` scope.
+ *
+ * @example
+ * ```ts
+ * // List all implemented states
+ * const list = await client.sma.listStates({ implemented: true });
+ * console.log(`${list.total} states have FHIR endpoints`);
+ *
+ * // Get details for California
+ * const ca = await client.sma.getState("CA");
+ * console.log(`Vendor: ${ca.api_vendor}`);
+ * console.log(`Claims endpoints: ${ca.patient_access.endpoints.claims.length}`);
+ *
+ * // Get aggregate statistics
+ * const stats = await client.sma.stats();
+ * console.log(`${stats.summary.implemented} of ${stats.summary.total_states} implemented`);
+ * ```
+ */
+declare class SmaEndpoint {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all states with SMA endpoint implementation status.
+     *
+     * @param options - Optional filters (implemented, vendor, status, fhir_version)
+     * @returns List of state summaries with implementation status
+     *
+     * @example
+     * ```ts
+     * // All states
+     * const all = await client.sma.listStates();
+     *
+     * // Only Epic-based implementations
+     * const epic = await client.sma.listStates({ vendor: "Epic" });
+     *
+     * // Only implemented states
+     * const live = await client.sma.listStates({ implemented: true });
+     * ```
+     */
+    listStates(options?: SmaListOptions): Promise<SmaStatesListResponse>;
+    /**
+     * Get full SMA details for a specific state.
+     *
+     * Accepts state abbreviation (CA), underscore ID (california), or
+     * display name (California).
+     *
+     * @param state - State identifier (abbreviation, ID, or display name)
+     * @returns Full state detail with endpoints, contacts, and metadata
+     *
+     * @example
+     * ```ts
+     * const ca = await client.sma.getState("CA");
+     * console.log(`${ca.state}: ${ca.is_implemented ? "Implemented" : "Not implemented"}`);
+     *
+     * for (const url of ca.patient_access.endpoints.claims) {
+     *   console.log(`Claims endpoint: ${url}`);
+     * }
+     * ```
+     */
+    getState(state: string): Promise<SmaStateDetailResponse>;
+    /**
+     * Get aggregate SMA statistics.
+     *
+     * Returns implementation counts, breakdowns by vendor/status/FHIR version,
+     * and provider directory statistics.
+     *
+     * @returns Aggregate statistics across all states
+     *
+     * @example
+     * ```ts
+     * const stats = await client.sma.stats();
+     * console.log(`${stats.summary.implemented} / ${stats.summary.total_states} states implemented`);
+     * console.log(`Total production URLs: ${stats.summary.total_production_urls}`);
+     * ```
+     */
+    stats(): Promise<SmaStatsResponse>;
+}
+
 /**
  * Base configuration options shared by all auth modes.
  */
@@ -2434,6 +2672,11 @@ declare class Fhirfly {
      * NCCI PTP validation, MUE limits, PFS/RVU fee schedule, LCD/NCD coverage.
      */
     readonly claims: ClaimsEndpoint;
+    /**
+     * SMA (State Medicaid Agency) Endpoint Directory (requires `connectivity.read` scope).
+     * State FHIR endpoint implementation status, patient access, and provider directories.
+     */
+    readonly sma: SmaEndpoint;
     /**
      * Create a new FHIRfly client.
      *
@@ -2519,4 +2762,4 @@ declare class TimeoutError extends FhirflyError {
     constructor(timeoutMs: number);
 }
 
-export { type ActiveIngredient, ApiError, type ApiResponse, AuthenticationError, type AuthorizedOfficial, type BatchLookupOptions, type BatchResponse, type BatchResultItem, type ClaimsLegalInfo, type ClaimsMeta, type ConnectivityEndpointData, type ConnectivityMeta, type ConnectivityTargetData, type CoverageCheckData, type CoverageCheckItem, type CoverageCheckResponse, type CoveragePolicyType, type CvxCompact, type CvxData, type CvxFull, type CvxSearchParams, type CvxStandard, type Deactivation, type DisplayField, type EndpointAuthRequirements, type EndpointAvailability, type EnrichedTaxonomy, type EvidenceSummary, type FdaLabelBundleName, type FdaLabelData, type FdaLabelLookupOptions, type FdaLabelMetadata, type FdaLabelSearchCompact, type FdaLabelSearchData, type FdaLabelSearchFull, type FdaLabelSearchParams, type FdaLabelSearchStandard, type FhirMetadata, Fhirfly, type FhirflyApiKeyConfig, type FhirflyConfig, FhirflyError, type FhirflyOAuthConfig, type Icd10Compact, type Icd10Data, type Icd10Full, type Icd10SearchParams, type Icd10Standard, type Icd10Type, type IncludeOption, type IpsCategory, type LegalInfo, type LoincCompact, type LoincData, type LoincFhirCoding, type LoincFull, type LoincParts, type LoincRanks, type LoincSearchParams, type LoincSourceOrg, type LoincStandard, type LoincUnits, type LookupOptions, type MueBatchResponse, type MueBatchResultItem, type MueLimitItem, type MueLookupData, type MueLookupResponse, type MueServiceType, type MvxCompact, type MvxData, type MvxFhirCoding, type MvxFull, type MvxIngest, type MvxSearchParams, type MvxStandard, type NcciClaimType, type NcciEditItem, type NcciValidateData, type NcciValidateResponse, type NdcCompact, type NdcData, type NdcFull, type NdcSearchParams, type NdcStandard, type NdcType, NetworkError, NotFoundError, type NpiAddress, type NpiCompact, type NpiConnectivityData, type NpiData, type NpiFull, type NpiSearchParams, type NpiStandard, type OtherIdentifier, type PersonName, type PfsBatchResponse, type PfsBatchResultItem, type PfsIndicators, type PfsLookupData, type PfsLookupResponse, type PfsPayment, type PfsRvu, type ProviderSummary, QuotaExceededError, RateLimitError, type ResponseMeta, type ResponseShape, type RxNormCompact, type RxNormData, type RxNormFull, type RxNormSearchParams, type RxNormStandard, type RxTermType, type SearchFacets, type SearchLegalInfo, type SearchOptions, type SearchResponse, type SecondaryLocation, ServerError, type SnomedBatchResultItem, type SnomedCategoriesResponse, type SnomedConcept, type SnomedEnrichmentFull, type SnomedEnrichmentStandard, type SnomedMappingSource, type SnomedMappingSourceSystem, type SnomedMappingType, type SnomedReverseMapping, type SnomedReverseMappingData, type SnomedSearchParams, TimeoutError, TokenManager, ValidationError };
+export { type ActiveIngredient, ApiError, type ApiResponse, AuthenticationError, type AuthorizedOfficial, type BatchLookupOptions, type BatchResponse, type BatchResultItem, type ClaimsLegalInfo, type ClaimsMeta, type ConnectivityEndpointData, type ConnectivityMeta, type ConnectivityTargetData, type CoverageCheckData, type CoverageCheckItem, type CoverageCheckResponse, type CoveragePolicyType, type CvxCompact, type CvxData, type CvxFull, type CvxSearchParams, type CvxStandard, type Deactivation, type DisplayField, type EndpointAuthRequirements, type EndpointAvailability, type EnrichedTaxonomy, type EvidenceSummary, type FdaLabelBundleName, type FdaLabelData, type FdaLabelLookupOptions, type FdaLabelMetadata, type FdaLabelSearchCompact, type FdaLabelSearchData, type FdaLabelSearchFull, type FdaLabelSearchParams, type FdaLabelSearchStandard, type FhirMetadata, Fhirfly, type FhirflyApiKeyConfig, type FhirflyConfig, FhirflyError, type FhirflyOAuthConfig, type Icd10Compact, type Icd10Data, type Icd10Full, type Icd10SearchParams, type Icd10Standard, type Icd10Type, type IncludeOption, type IpsCategory, type LegalInfo, type LoincCompact, type LoincData, type LoincFhirCoding, type LoincFull, type LoincParts, type LoincRanks, type LoincSearchParams, type LoincSourceOrg, type LoincStandard, type LoincUnits, type LookupOptions, type MueBatchResponse, type MueBatchResultItem, type MueLimitItem, type MueLookupData, type MueLookupResponse, type MueServiceType, type MvxCompact, type MvxData, type MvxFhirCoding, type MvxFull, type MvxIngest, type MvxSearchParams, type MvxStandard, type NcciClaimType, type NcciEditItem, type NcciValidateData, type NcciValidateResponse, type NdcCompact, type NdcData, type NdcFull, type NdcSearchParams, type NdcStandard, type NdcType, NetworkError, NotFoundError, type NpiAddress, type NpiCompact, type NpiConnectivityData, type NpiData, type NpiFull, type NpiSearchParams, type NpiStandard, type OtherIdentifier, type PersonName, type PfsBatchResponse, type PfsBatchResultItem, type PfsIndicators, type PfsLookupData, type PfsLookupResponse, type PfsPayment, type PfsRvu, type ProviderSummary, QuotaExceededError, RateLimitError, type ResponseMeta, type ResponseShape, type RxNormCompact, type RxNormData, type RxNormFull, type RxNormSearchParams, type RxNormStandard, type RxTermType, type SearchFacets, type SearchLegalInfo, type SearchOptions, type SearchResponse, type SecondaryLocation, ServerError, type SmaListOptions, type SmaMetaResponse, type SmaStateDetailResponse, type SmaStateSummary, type SmaStatesListResponse, type SmaStatsResponse, type SnomedBatchResultItem, type SnomedCategoriesResponse, type SnomedConcept, type SnomedEnrichmentFull, type SnomedEnrichmentStandard, type SnomedMappingSource, type SnomedMappingSourceSystem, type SnomedMappingType, type SnomedReverseMapping, type SnomedReverseMappingData, type SnomedSearchParams, TimeoutError, TokenManager, ValidationError };

package/dist/index.js

@@ -1278,6 +1278,90 @@ var ClaimsEndpoint = class {
   }
 };
 
+// src/endpoints/sma.ts
+var SmaEndpoint = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List all states with SMA endpoint implementation status.
+   *
+   * @param options - Optional filters (implemented, vendor, status, fhir_version)
+   * @returns List of state summaries with implementation status
+   *
+   * @example
+   * ```ts
+   * // All states
+   * const all = await client.sma.listStates();
+   *
+   * // Only Epic-based implementations
+   * const epic = await client.sma.listStates({ vendor: "Epic" });
+   *
+   * // Only implemented states
+   * const live = await client.sma.listStates({ implemented: true });
+   * ```
+   */
+  async listStates(options) {
+    const params = {};
+    if (options?.implemented !== void 0) {
+      params.implemented = options.implemented.toString();
+    }
+    if (options?.vendor) {
+      params.vendor = options.vendor;
+    }
+    if (options?.status) {
+      params.status = options.status;
+    }
+    if (options?.fhir_version) {
+      params.fhir_version = options.fhir_version;
+    }
+    const queryString = this.http.buildSearchQueryString(params);
+    return this.http.get(`/v1/sma/states${queryString}`);
+  }
+  /**
+   * Get full SMA details for a specific state.
+   *
+   * Accepts state abbreviation (CA), underscore ID (california), or
+   * display name (California).
+   *
+   * @param state - State identifier (abbreviation, ID, or display name)
+   * @returns Full state detail with endpoints, contacts, and metadata
+   *
+   * @example
+   * ```ts
+   * const ca = await client.sma.getState("CA");
+   * console.log(`${ca.state}: ${ca.is_implemented ? "Implemented" : "Not implemented"}`);
+   *
+   * for (const url of ca.patient_access.endpoints.claims) {
+   *   console.log(`Claims endpoint: ${url}`);
+   * }
+   * ```
+   */
+  async getState(state) {
+    return this.http.get(
+      `/v1/sma/states/${encodeURIComponent(state)}`
+    );
+  }
+  /**
+   * Get aggregate SMA statistics.
+   *
+   * Returns implementation counts, breakdowns by vendor/status/FHIR version,
+   * and provider directory statistics.
+   *
+   * @returns Aggregate statistics across all states
+   *
+   * @example
+   * ```ts
+   * const stats = await client.sma.stats();
+   * console.log(`${stats.summary.implemented} / ${stats.summary.total_states} states implemented`);
+   * console.log(`Total production URLs: ${stats.summary.total_production_urls}`);
+   * ```
+   */
+  async stats() {
+    return this.http.get("/v1/sma/stats");
+  }
+};
+
 // src/client.ts
 var Fhirfly = class {
   http;
@@ -1328,6 +1412,11 @@ var Fhirfly = class {
    * NCCI PTP validation, MUE limits, PFS/RVU fee schedule, LCD/NCD coverage.
    */
   claims;
+  /**
+   * SMA (State Medicaid Agency) Endpoint Directory (requires `connectivity.read` scope).
+   * State FHIR endpoint implementation status, patient access, and provider directories.
+   */
+  sma;
   /**
    * Create a new FHIRfly client.
    *
@@ -1376,6 +1465,7 @@ var Fhirfly = class {
     this.connectivity = new ConnectivityEndpoint(this.http);
     this.snomed = new SnomedEndpoint(this.http);
     this.claims = new ClaimsEndpoint(this.http);
+    this.sma = new SmaEndpoint(this.http);
   }
 };