@firmenakte/api-client 1.0.0

package/index.d.ts

@@ -0,0 +1,246 @@
+export type ClientConfig = {
+    apiKey: string;
+    baseUrl?: string;
+};
+/**
+ * SOTA Factory: Creates a fresh, isolated instance of the API client.
+ */
+export declare const createApiClient: ({ apiKey, baseUrl, }: ClientConfig) => {
+    v1TradesDocumentsDetail: (gisaZahl: number, query?: {
+        historical?: boolean;
+        language?: "De" | "En";
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<void, import("./client").ProblemDetails>>;
+    v1TradesList: (query?: {
+        search?: string;
+        minCompanyCount?: number;
+        page?: number;
+        pageSize?: number;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").PagedResponseOfTradeCatalogItemResponse, any>>;
+    v1TradesLicensesList: (tradeKey: number, query?: {
+        page?: number;
+        pageSize?: number;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").PagedResponseOfGisaLicense, any>>;
+    v1TradesCompanyDetail: (fnr: string, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").GisaLicense[], any>>;
+    v1TradesChangesDetail: (id: number, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").GisaChange, any>>;
+    v1TradesChangesList: (query?: {
+        fnr?: string;
+        since?: string;
+        sinceId?: number;
+        page?: number;
+        pageSize?: number;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").PagedResponseOfGisaChange, any>>;
+    v1PeopleList: (query?: {
+        name?: string;
+        search?: string;
+        firstName?: string;
+        lastName?: string;
+        functionCode?: string;
+        businessName?: string;
+        fnr?: string;
+        hasEdikt?: boolean;
+        page?: number;
+        pageSize?: number;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").PagedResponseOfPerson, any>>;
+    v1PeopleDetail: (personId: string, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").PersonDetailResponse, any>>;
+    v1LegalformsList: (query?: {
+        search?: string;
+        page?: number;
+        pageSize?: number;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").PagedResponseOfLegalFormCatalogItemResponse, any>>;
+    v1GraphList: (query?: {
+        personId?: string;
+        fnr?: string;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").GraphResponse, any>>;
+    v1GlobalchangesList: (query?: {
+        fnr?: string;
+        since?: string;
+        sinceId?: number;
+        page?: number;
+        pageSize?: number;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").PagedResponseOfGlobalChange, any>>;
+    v1GlobalchangesAggregatedList: (query?: {
+        fnr?: string[];
+        since?: string;
+        sinceId?: number;
+        maxResultsPerType?: number;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").AggregatedChangesResponse, any>>;
+    v1GlobalchangesDetail: (id: number, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").ChangeDetailResponse, any>>;
+    v1EdikteChangesDetail: (id: number, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").EdiktChange, any>>;
+    v1EdikteChangesList: (query?: {
+        fnr?: string;
+        since?: string;
+        sinceId?: number;
+        page?: number;
+        pageSize?: number;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").PagedResponseOfEdiktChange, any>>;
+    v1DocumentsDownloadDetail: (documentKey: string, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<void, import("./client").ProblemDetails>>;
+    v1DocumentsChangesDetail: (id: number, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").DocumentChange, any>>;
+    v1DocumentsChangesList: (query?: {
+        fnr?: string;
+        since?: string;
+        sinceId?: number;
+        page?: number;
+        pageSize?: number;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").PagedResponseOfDocumentChange, any>>;
+    v1CourtsList: (query?: {
+        search?: string;
+        page?: number;
+        pageSize?: number;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").PagedResponseOfCourtCatalogItemResponse, any>>;
+    v1BusinessesList: (query?: {
+        fnr?: string[];
+        name?: string;
+        names?: string[];
+        search?: string;
+        city?: string[];
+        courtCode?: string[];
+        legalFormCode?: string[];
+        zipCode?: string[];
+        hasEdikt?: boolean;
+        active?: boolean;
+        isScheinunternehmen?: boolean;
+        gisaLicenseKey?: number[];
+        orderBy?: "bilanz.AktivierteEigenleistungen" | "bilanz.AnlageVermoegen" | "bilanz.Bilanzgewinn" | "bilanz.BilanzSumme" | "bilanz.Eigenkapital" | "bilanz.EingefordertesStammkapital" | "bilanz.Finanzanlagen" | "bilanz.Forderungen" | "bilanz.ForderungenLieferungen" | "bilanz.Gewinnruecklagen" | "bilanz.ImmaterielleVermoegensgegenstaende" | "bilanz.Kapitalruecklagen" | "bilanz.KurzfristigeForderungen" | "bilanz.KurzfristigeVerbindlichkeiten" | "bilanz.LangfristigeForderungen" | "bilanz.LangfristigeVerbindlichkeiten" | "bilanz.LiquidesVermoegen" | "bilanz.PassiveRechnungsabgrenzungen" | "bilanz.Rechnungsabgrenzungen" | "bilanz.Rueckstellungen" | "bilanz.Sachanlagen" | "bilanz.Umlaufvermoegen" | "bilanz.Verbindlichkeiten" | "bilanz.VerbindlichkeitenLieferungen" | "bilanz.Vorraete" | "bilanz.Vortrag" | "bilanz.Wertpapiere" | "employees" | "guv.Abschreibungen" | "guv.AufloesungGewinnruecklagen" | "guv.AufwendungenAusFinanzanlagen" | "guv.Bestandsveraenderung" | "guv.BetriebsErfolg" | "guv.ErgebnisVorSteuern" | "guv.ErtraegeAusBeteiligungen" | "guv.ErtraegeAusWertpapieren" | "guv.Finanzerfolg" | "guv.Jahresueberschuss" | "guv.Personalaufwand" | "guv.SonstigeBetrieblicheAufwendungen" | "guv.SonstigeBetrieblicheErtraege" | "guv.SonstigeZinsenUndAehnlicheErtraege" | "guv.SozialeAufwendungen" | "guv.Steueraufwand" | "guv.Umsatzerloese" | "guv.WarenUndMaterialeinkauf" | "guv.ZinsenUndAehnlicheAufwendungen" | "name" | null;
+        orderByDescending?: boolean;
+        countOnly?: boolean;
+        page?: number;
+        pageSize?: number;
+        "bilanz.AktivierteEigenleistungen_lte"?: number | null;
+        "bilanz.AktivierteEigenleistungen_gte"?: number | null;
+        "bilanz.AnlageVermoegen_lte"?: number | null;
+        "bilanz.AnlageVermoegen_gte"?: number | null;
+        "bilanz.Bilanzgewinn_lte"?: number | null;
+        "bilanz.Bilanzgewinn_gte"?: number | null;
+        "bilanz.BilanzSumme_lte"?: number | null;
+        "bilanz.BilanzSumme_gte"?: number | null;
+        "bilanz.Eigenkapital_lte"?: number | null;
+        "bilanz.Eigenkapital_gte"?: number | null;
+        "bilanz.EingefordertesStammkapital_lte"?: number | null;
+        "bilanz.EingefordertesStammkapital_gte"?: number | null;
+        "bilanz.Finanzanlagen_lte"?: number | null;
+        "bilanz.Finanzanlagen_gte"?: number | null;
+        "bilanz.Forderungen_lte"?: number | null;
+        "bilanz.Forderungen_gte"?: number | null;
+        "bilanz.ForderungenLieferungen_lte"?: number | null;
+        "bilanz.ForderungenLieferungen_gte"?: number | null;
+        "bilanz.Gewinnruecklagen_lte"?: number | null;
+        "bilanz.Gewinnruecklagen_gte"?: number | null;
+        "bilanz.ImmaterielleVermoegensgegenstaende_lte"?: number | null;
+        "bilanz.ImmaterielleVermoegensgegenstaende_gte"?: number | null;
+        "bilanz.Kapitalruecklagen_lte"?: number | null;
+        "bilanz.Kapitalruecklagen_gte"?: number | null;
+        "bilanz.KurzfristigeForderungen_lte"?: number | null;
+        "bilanz.KurzfristigeForderungen_gte"?: number | null;
+        "bilanz.KurzfristigeVerbindlichkeiten_lte"?: number | null;
+        "bilanz.KurzfristigeVerbindlichkeiten_gte"?: number | null;
+        "bilanz.LangfristigeForderungen_lte"?: number | null;
+        "bilanz.LangfristigeForderungen_gte"?: number | null;
+        "bilanz.LangfristigeVerbindlichkeiten_lte"?: number | null;
+        "bilanz.LangfristigeVerbindlichkeiten_gte"?: number | null;
+        "bilanz.LiquidesVermoegen_lte"?: number | null;
+        "bilanz.LiquidesVermoegen_gte"?: number | null;
+        "bilanz.PassiveRechnungsabgrenzungen_lte"?: number | null;
+        "bilanz.PassiveRechnungsabgrenzungen_gte"?: number | null;
+        "bilanz.Rechnungsabgrenzungen_lte"?: number | null;
+        "bilanz.Rechnungsabgrenzungen_gte"?: number | null;
+        "bilanz.Rueckstellungen_lte"?: number | null;
+        "bilanz.Rueckstellungen_gte"?: number | null;
+        "bilanz.Sachanlagen_lte"?: number | null;
+        "bilanz.Sachanlagen_gte"?: number | null;
+        "bilanz.Umlaufvermoegen_lte"?: number | null;
+        "bilanz.Umlaufvermoegen_gte"?: number | null;
+        "bilanz.Verbindlichkeiten_lte"?: number | null;
+        "bilanz.Verbindlichkeiten_gte"?: number | null;
+        "bilanz.VerbindlichkeitenLieferungen_lte"?: number | null;
+        "bilanz.VerbindlichkeitenLieferungen_gte"?: number | null;
+        "bilanz.Vorraete_lte"?: number | null;
+        "bilanz.Vorraete_gte"?: number | null;
+        "bilanz.Vortrag_lte"?: number | null;
+        "bilanz.Vortrag_gte"?: number | null;
+        "bilanz.Wertpapiere_lte"?: number | null;
+        "bilanz.Wertpapiere_gte"?: number | null;
+        employees_lte?: number | null;
+        employees_gte?: number | null;
+        "guv.Abschreibungen_lte"?: number | null;
+        "guv.Abschreibungen_gte"?: number | null;
+        "guv.AufloesungGewinnruecklagen_lte"?: number | null;
+        "guv.AufloesungGewinnruecklagen_gte"?: number | null;
+        "guv.AufwendungenAusFinanzanlagen_lte"?: number | null;
+        "guv.AufwendungenAusFinanzanlagen_gte"?: number | null;
+        "guv.Bestandsveraenderung_lte"?: number | null;
+        "guv.Bestandsveraenderung_gte"?: number | null;
+        "guv.BetriebsErfolg_lte"?: number | null;
+        "guv.BetriebsErfolg_gte"?: number | null;
+        "guv.ErgebnisVorSteuern_lte"?: number | null;
+        "guv.ErgebnisVorSteuern_gte"?: number | null;
+        "guv.ErtraegeAusBeteiligungen_lte"?: number | null;
+        "guv.ErtraegeAusBeteiligungen_gte"?: number | null;
+        "guv.ErtraegeAusWertpapieren_lte"?: number | null;
+        "guv.ErtraegeAusWertpapieren_gte"?: number | null;
+        "guv.Finanzerfolg_lte"?: number | null;
+        "guv.Finanzerfolg_gte"?: number | null;
+        "guv.Jahresueberschuss_lte"?: number | null;
+        "guv.Jahresueberschuss_gte"?: number | null;
+        "guv.Personalaufwand_lte"?: number | null;
+        "guv.Personalaufwand_gte"?: number | null;
+        "guv.SonstigeBetrieblicheAufwendungen_lte"?: number | null;
+        "guv.SonstigeBetrieblicheAufwendungen_gte"?: number | null;
+        "guv.SonstigeBetrieblicheErtraege_lte"?: number | null;
+        "guv.SonstigeBetrieblicheErtraege_gte"?: number | null;
+        "guv.SonstigeZinsenUndAehnlicheErtraege_lte"?: number | null;
+        "guv.SonstigeZinsenUndAehnlicheErtraege_gte"?: number | null;
+        "guv.SozialeAufwendungen_lte"?: number | null;
+        "guv.SozialeAufwendungen_gte"?: number | null;
+        "guv.Steueraufwand_lte"?: number | null;
+        "guv.Steueraufwand_gte"?: number | null;
+        "guv.Umsatzerloese_lte"?: number | null;
+        "guv.Umsatzerloese_gte"?: number | null;
+        "guv.WarenUndMaterialeinkauf_lte"?: number | null;
+        "guv.WarenUndMaterialeinkauf_gte"?: number | null;
+        "guv.ZinsenUndAehnlicheAufwendungen_lte"?: number | null;
+        "guv.ZinsenUndAehnlicheAufwendungen_gte"?: number | null;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").PagedResponseOfBusinessListResponse, any>>;
+    v1BusinessesCountList: (params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<number, any>>;
+    v1BusinessesDetail: (fnr: string, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").BusinessDetailResponse, any>>;
+    v1BusinessesSyncCreate: (fnr: string, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<void, any>>;
+    v1BusinessesChangesDetail: (id: number, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").BusinessChange, any>>;
+    v1BusinessesChangesList: (query?: {
+        fnr?: string;
+        since?: string;
+        sinceId?: number;
+        page?: number;
+        pageSize?: number;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").PagedResponseOfBusinessChange, any>>;
+    v1AssignmentfunctionsList: (params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").AssignmentFunctionItemResponse[], any>>;
+    v1AddressesLocationsList: (query?: {
+        search?: string;
+        page?: number;
+        pageSize?: number;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").PagedResponseOfAddressLocationResponse, any>>;
+    v1AddressesCitiesList: (query?: {
+        search?: string;
+        page?: number;
+        pageSize?: number;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").PagedResponseOfCityResponse, any>>;
+    v1AddressesZipcodesList: (query?: {
+        search?: string;
+        page?: number;
+        pageSize?: number;
+    }, params?: import("./client").RequestParams) => Promise<import("./client").HttpResponse<import("./client").PagedResponseOfZipCodeResponse, any>>;
+};
+export * from "./client";
+export * from "./keyfigures";
+import type { KeyFigureFilterKey } from "./keyfigures";
+type RequestQuery = import("./client").Api.V1BusinessesList.RequestQuery;
+type KeyFigureFilterParamKeys = Extract<keyof RequestQuery, `${KeyFigureFilterKey}_lte` | `${KeyFigureFilterKey}_gte`>;
+/**
+ * Filter state shape for the business list (UI/URL). Uses keyFigureFilters record.
+ * Convert to flat RequestQuery for the API via buildBusinessesListQuery in the web app.
+ */
+export type BusinessListFilterQuery = Omit<RequestQuery, KeyFigureFilterParamKeys> & {
+    keyFigureFilters?: Partial<Record<KeyFigureFilterKey, {
+        min?: number | null;
+        max?: number | null;
+    }>>;
+};
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,sBAG7B,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAcd,CAAC;AAEF,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAE7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,KAAK,YAAY,GAAG,OAAO,UAAU,EAAE,GAAG,CAAC,gBAAgB,CAAC,YAAY,CAAC;AACzE,KAAK,wBAAwB,GAAG,OAAO,CACrC,MAAM,YAAY,EAClB,GAAG,kBAAkB,MAAM,GAAG,GAAG,kBAAkB,MAAM,CAC1D,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,YAAY,EAAE,wBAAwB,CAAC,GAAG;IACnF,gBAAgB,CAAC,EAAE,OAAO,CACxB,MAAM,CAAC,kBAAkB,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CACzE,CAAC;CACH,CAAC"}

package/index.js

@@ -0,0 +1,21 @@
+// packages/api-client/src/index.ts
+import { Api } from './client';
+/**
+ * SOTA Factory: Creates a fresh, isolated instance of the API client.
+ */
+export const createApiClient = ({ apiKey, baseUrl, }) => {
+    const config = {
+        baseApiParams: {
+            headers: {
+                "x-api-key": apiKey,
+            },
+        }
+    };
+    if (baseUrl) {
+        config.baseUrl = baseUrl;
+    }
+    const apiInstance = new Api(config);
+    return apiInstance.api;
+};
+export * from "./client";
+export * from "./keyfigures";

package/keyfigures.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Runtime array of all available key figure filter keys.
+ * This file is auto-generated from the OpenAPI spec (x-keyFigureFilterKeys or *_lte/_gte params).
+ */
+export declare const KEY_FIGURE_FILTER_KEYS: readonly ["bilanz.AktivierteEigenleistungen", "bilanz.AnlageVermoegen", "bilanz.BilanzSumme", "bilanz.Bilanzgewinn", "bilanz.Eigenkapital", "bilanz.EingefordertesStammkapital", "bilanz.Finanzanlagen", "bilanz.Forderungen", "bilanz.ForderungenLieferungen", "bilanz.Gewinnruecklagen", "bilanz.ImmaterielleVermoegensgegenstaende", "bilanz.Kapitalruecklagen", "bilanz.KurzfristigeForderungen", "bilanz.KurzfristigeVerbindlichkeiten", "bilanz.LangfristigeForderungen", "bilanz.LangfristigeVerbindlichkeiten", "bilanz.LiquidesVermoegen", "bilanz.PassiveRechnungsabgrenzungen", "bilanz.Rechnungsabgrenzungen", "bilanz.Rueckstellungen", "bilanz.Sachanlagen", "bilanz.Umlaufvermoegen", "bilanz.Verbindlichkeiten", "bilanz.VerbindlichkeitenLieferungen", "bilanz.Vorraete", "bilanz.Vortrag", "bilanz.Wertpapiere", "employees", "guv.Abschreibungen", "guv.AufloesungGewinnruecklagen", "guv.AufwendungenAusFinanzanlagen", "guv.Bestandsveraenderung", "guv.BetriebsErfolg", "guv.ErgebnisVorSteuern", "guv.ErtraegeAusBeteiligungen", "guv.ErtraegeAusWertpapieren", "guv.Finanzerfolg", "guv.Jahresueberschuss", "guv.Personalaufwand", "guv.SonstigeBetrieblicheAufwendungen", "guv.SonstigeBetrieblicheErtraege", "guv.SonstigeZinsenUndAehnlicheErtraege", "guv.SozialeAufwendungen", "guv.Steueraufwand", "guv.Umsatzerloese", "guv.WarenUndMaterialeinkauf", "guv.ZinsenUndAehnlicheAufwendungen"];
+/**
+ * Type for a single key figure filter key (derived from the generated array).
+ */
+export type KeyFigureFilterKey = (typeof KEY_FIGURE_FILTER_KEYS)[number];
+/**
+ * Helper function to get the category of a key figure filter key.
+ */
+export declare function getKeyFigureCategory(key: KeyFigureFilterKey): "employees" | "bilanz" | "guv";
+/**
+ * Helper function to get a human-readable label for a key figure filter key.
+ */
+export declare function getKeyFigureLabel(key: KeyFigureFilterKey): string;
+//# sourceMappingURL=keyfigures.d.ts.map

package/keyfigures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyfigures.d.ts","sourceRoot":"","sources":["../src/keyfigures.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,sBAAsB,41CAgDzB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,kBAAkB,GACtB,WAAW,GAAG,QAAQ,GAAG,KAAK,CAKhC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CASjE"}

package/keyfigures.js

@@ -0,0 +1,79 @@
+/**
+ * Runtime array of all available key figure filter keys.
+ * This file is auto-generated from the OpenAPI spec (x-keyFigureFilterKeys or *_lte/_gte params).
+ */
+export const KEY_FIGURE_FILTER_KEYS = [
+    "bilanz.AktivierteEigenleistungen",
+    "bilanz.AnlageVermoegen",
+    "bilanz.BilanzSumme",
+    "bilanz.Bilanzgewinn",
+    "bilanz.Eigenkapital",
+    "bilanz.EingefordertesStammkapital",
+    "bilanz.Finanzanlagen",
+    "bilanz.Forderungen",
+    "bilanz.ForderungenLieferungen",
+    "bilanz.Gewinnruecklagen",
+    "bilanz.ImmaterielleVermoegensgegenstaende",
+    "bilanz.Kapitalruecklagen",
+    "bilanz.KurzfristigeForderungen",
+    "bilanz.KurzfristigeVerbindlichkeiten",
+    "bilanz.LangfristigeForderungen",
+    "bilanz.LangfristigeVerbindlichkeiten",
+    "bilanz.LiquidesVermoegen",
+    "bilanz.PassiveRechnungsabgrenzungen",
+    "bilanz.Rechnungsabgrenzungen",
+    "bilanz.Rueckstellungen",
+    "bilanz.Sachanlagen",
+    "bilanz.Umlaufvermoegen",
+    "bilanz.Verbindlichkeiten",
+    "bilanz.VerbindlichkeitenLieferungen",
+    "bilanz.Vorraete",
+    "bilanz.Vortrag",
+    "bilanz.Wertpapiere",
+    "employees",
+    "guv.Abschreibungen",
+    "guv.AufloesungGewinnruecklagen",
+    "guv.AufwendungenAusFinanzanlagen",
+    "guv.Bestandsveraenderung",
+    "guv.BetriebsErfolg",
+    "guv.ErgebnisVorSteuern",
+    "guv.ErtraegeAusBeteiligungen",
+    "guv.ErtraegeAusWertpapieren",
+    "guv.Finanzerfolg",
+    "guv.Jahresueberschuss",
+    "guv.Personalaufwand",
+    "guv.SonstigeBetrieblicheAufwendungen",
+    "guv.SonstigeBetrieblicheErtraege",
+    "guv.SonstigeZinsenUndAehnlicheErtraege",
+    "guv.SozialeAufwendungen",
+    "guv.Steueraufwand",
+    "guv.Umsatzerloese",
+    "guv.WarenUndMaterialeinkauf",
+    "guv.ZinsenUndAehnlicheAufwendungen",
+];
+/**
+ * Helper function to get the category of a key figure filter key.
+ */
+export function getKeyFigureCategory(key) {
+    if (key === "employees")
+        return "employees";
+    if (key.startsWith("bilanz."))
+        return "bilanz";
+    if (key.startsWith("guv."))
+        return "guv";
+    return "employees"; // fallback
+}
+/**
+ * Helper function to get a human-readable label for a key figure filter key.
+ */
+export function getKeyFigureLabel(key) {
+    if (key === "employees")
+        return "Mitarbeiter";
+    if (key.startsWith("bilanz.")) {
+        return key.replace("bilanz.", "");
+    }
+    if (key.startsWith("guv.")) {
+        return key.replace("guv.", "");
+    }
+    return key;
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@firmenakte/api-client",
+  "version": "1.0.0",
+  "description": "TypeScript/JavaScript client for the Firmenakte API",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "files": [
+    "*.js",
+    "*.d.ts",
+    "*.d.ts.map"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/firmenakte/unternehmens-screener.git"
+  },
+  "homepage": "https://docs.firmenakte.at",
+  "bugs": {
+    "url": "https://github.com/firmenakte/unternehmens-screener/issues"
+  }
+}