ris-mcp-ts 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,471 @@
+/**
+ * Zod schemas and TypeScript types for the RIS MCP Server.
+ *
+ * This module defines all data models used for interacting with the Austrian
+ * Legal Information System (RIS) API, including enums for various search
+ * parameters and document models for representing legal documents.
+ */
+import { z } from 'zod';
+/**
+ * Application types for federal law searches in RIS.
+ */
+export declare const BundesrechtApplikationSchema: z.ZodEnum<["BrKons", "Begut", "BgblAuth", "Erv"]>;
+export type BundesrechtApplikation = z.infer<typeof BundesrechtApplikationSchema>;
+/**
+ * Court types for case law searches in RIS.
+ */
+export declare const JudikaturGerichtSchema: z.ZodEnum<["Justiz", "Vfgh", "Vwgh", "Bvwg", "Lvwg", "Dsk", "AsylGH", "Normenliste", "Pvak", "Gbk", "Dok"]>;
+export type JudikaturGericht = z.infer<typeof JudikaturGerichtSchema>;
+/**
+ * Austrian federal states (Bundesländer).
+ * Note: Uses Umlauts (ö, ä) for display purposes.
+ */
+export declare const BundeslandSchema: z.ZodEnum<["Wien", "Niederösterreich", "Oberösterreich", "Steiermark", "Tirol", "Kärnten", "Salzburg", "Vorarlberg", "Burgenland"]>;
+export type Bundesland = z.infer<typeof BundeslandSchema>;
+/**
+ * Austrian federal states for Landesrecht API (ASCII versions without Umlauts).
+ * The RIS API uses the SucheIn format (e.g., Bundesland.SucheInWien=true).
+ */
+export declare const LANDESRECHT_BUNDESLAENDER: readonly ["Wien", "Niederoesterreich", "Oberoesterreich", "Salzburg", "Tirol", "Vorarlberg", "Kaernten", "Steiermark", "Burgenland"];
+export declare const LandesrechtBundeslandSchema: z.ZodEnum<["Wien", "Niederoesterreich", "Oberoesterreich", "Salzburg", "Tirol", "Vorarlberg", "Kaernten", "Steiermark", "Burgenland"]>;
+export type LandesrechtBundesland = z.infer<typeof LandesrechtBundeslandSchema>;
+/**
+ * Date format validation schema (YYYY-MM-DD).
+ * Used for date parameters in RIS API requests.
+ */
+export declare const DateSchema: z.ZodString;
+export declare const OptionalDateSchema: z.ZodOptional<z.ZodString>;
+/**
+ * Number of documents per page for paginated API responses.
+ */
+export declare const DokumenteProSeiteSchema: z.ZodEnum<["Ten", "Twenty", "Fifty", "OneHundred"]>;
+export type DokumenteProSeite = z.infer<typeof DokumenteProSeiteSchema>;
+/**
+ * Output format for MCP tool responses.
+ */
+export declare const ResponseFormatSchema: z.ZodEnum<["markdown", "json"]>;
+export type ResponseFormat = z.infer<typeof ResponseFormatSchema>;
+/**
+ * URLs for accessing document content in different formats.
+ */
+export declare const ContentUrlSchema: z.ZodObject<{
+    xml: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    html: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    rtf: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    pdf: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    xml?: string | null | undefined;
+    html?: string | null | undefined;
+    rtf?: string | null | undefined;
+    pdf?: string | null | undefined;
+}, {
+    xml?: string | null | undefined;
+    html?: string | null | undefined;
+    rtf?: string | null | undefined;
+    pdf?: string | null | undefined;
+}>;
+export type ContentUrl = z.infer<typeof ContentUrlSchema>;
+/**
+ * Citation information for a legal document.
+ */
+export declare const CitationSchema: z.ZodObject<{
+    kurztitel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    langtitel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    kundmachungsorgan: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    paragraph: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    eli: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    inkrafttreten: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ausserkrafttreten: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    kurztitel?: string | null | undefined;
+    langtitel?: string | null | undefined;
+    kundmachungsorgan?: string | null | undefined;
+    paragraph?: string | null | undefined;
+    eli?: string | null | undefined;
+    inkrafttreten?: string | null | undefined;
+    ausserkrafttreten?: string | null | undefined;
+}, {
+    kurztitel?: string | null | undefined;
+    langtitel?: string | null | undefined;
+    kundmachungsorgan?: string | null | undefined;
+    paragraph?: string | null | undefined;
+    eli?: string | null | undefined;
+    inkrafttreten?: string | null | undefined;
+    ausserkrafttreten?: string | null | undefined;
+}>;
+export type Citation = z.infer<typeof CitationSchema>;
+/**
+ * A single legal document from the RIS database.
+ */
+export declare const DocumentSchema: z.ZodObject<{
+    dokumentnummer: z.ZodString;
+    applikation: z.ZodString;
+    titel: z.ZodString;
+    kurztitel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    citation: z.ZodObject<{
+        kurztitel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        langtitel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        kundmachungsorgan: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        paragraph: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        eli: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        inkrafttreten: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        ausserkrafttreten: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        kurztitel?: string | null | undefined;
+        langtitel?: string | null | undefined;
+        kundmachungsorgan?: string | null | undefined;
+        paragraph?: string | null | undefined;
+        eli?: string | null | undefined;
+        inkrafttreten?: string | null | undefined;
+        ausserkrafttreten?: string | null | undefined;
+    }, {
+        kurztitel?: string | null | undefined;
+        langtitel?: string | null | undefined;
+        kundmachungsorgan?: string | null | undefined;
+        paragraph?: string | null | undefined;
+        eli?: string | null | undefined;
+        inkrafttreten?: string | null | undefined;
+        ausserkrafttreten?: string | null | undefined;
+    }>;
+    content_urls: z.ZodObject<{
+        xml: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        html: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        rtf: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        pdf: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        xml?: string | null | undefined;
+        html?: string | null | undefined;
+        rtf?: string | null | undefined;
+        pdf?: string | null | undefined;
+    }, {
+        xml?: string | null | undefined;
+        html?: string | null | undefined;
+        rtf?: string | null | undefined;
+        pdf?: string | null | undefined;
+    }>;
+    dokument_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    gesamte_rechtsvorschrift_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    dokumentnummer: string;
+    applikation: string;
+    titel: string;
+    citation: {
+        kurztitel?: string | null | undefined;
+        langtitel?: string | null | undefined;
+        kundmachungsorgan?: string | null | undefined;
+        paragraph?: string | null | undefined;
+        eli?: string | null | undefined;
+        inkrafttreten?: string | null | undefined;
+        ausserkrafttreten?: string | null | undefined;
+    };
+    content_urls: {
+        xml?: string | null | undefined;
+        html?: string | null | undefined;
+        rtf?: string | null | undefined;
+        pdf?: string | null | undefined;
+    };
+    kurztitel?: string | null | undefined;
+    dokument_url?: string | null | undefined;
+    gesamte_rechtsvorschrift_url?: string | null | undefined;
+}, {
+    dokumentnummer: string;
+    applikation: string;
+    titel: string;
+    citation: {
+        kurztitel?: string | null | undefined;
+        langtitel?: string | null | undefined;
+        kundmachungsorgan?: string | null | undefined;
+        paragraph?: string | null | undefined;
+        eli?: string | null | undefined;
+        inkrafttreten?: string | null | undefined;
+        ausserkrafttreten?: string | null | undefined;
+    };
+    content_urls: {
+        xml?: string | null | undefined;
+        html?: string | null | undefined;
+        rtf?: string | null | undefined;
+        pdf?: string | null | undefined;
+    };
+    kurztitel?: string | null | undefined;
+    dokument_url?: string | null | undefined;
+    gesamte_rechtsvorschrift_url?: string | null | undefined;
+}>;
+export type Document = z.infer<typeof DocumentSchema>;
+/**
+ * Paginated search results from the RIS API.
+ */
+export declare const SearchResultSchema: z.ZodObject<{
+    total_hits: z.ZodNumber;
+    page: z.ZodNumber;
+    page_size: z.ZodNumber;
+    has_more: z.ZodBoolean;
+    documents: z.ZodArray<z.ZodObject<{
+        dokumentnummer: z.ZodString;
+        applikation: z.ZodString;
+        titel: z.ZodString;
+        kurztitel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        citation: z.ZodObject<{
+            kurztitel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            langtitel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            kundmachungsorgan: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            paragraph: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            eli: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            inkrafttreten: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            ausserkrafttreten: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            kurztitel?: string | null | undefined;
+            langtitel?: string | null | undefined;
+            kundmachungsorgan?: string | null | undefined;
+            paragraph?: string | null | undefined;
+            eli?: string | null | undefined;
+            inkrafttreten?: string | null | undefined;
+            ausserkrafttreten?: string | null | undefined;
+        }, {
+            kurztitel?: string | null | undefined;
+            langtitel?: string | null | undefined;
+            kundmachungsorgan?: string | null | undefined;
+            paragraph?: string | null | undefined;
+            eli?: string | null | undefined;
+            inkrafttreten?: string | null | undefined;
+            ausserkrafttreten?: string | null | undefined;
+        }>;
+        content_urls: z.ZodObject<{
+            xml: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            html: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            rtf: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            pdf: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            xml?: string | null | undefined;
+            html?: string | null | undefined;
+            rtf?: string | null | undefined;
+            pdf?: string | null | undefined;
+        }, {
+            xml?: string | null | undefined;
+            html?: string | null | undefined;
+            rtf?: string | null | undefined;
+            pdf?: string | null | undefined;
+        }>;
+        dokument_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        gesamte_rechtsvorschrift_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        dokumentnummer: string;
+        applikation: string;
+        titel: string;
+        citation: {
+            kurztitel?: string | null | undefined;
+            langtitel?: string | null | undefined;
+            kundmachungsorgan?: string | null | undefined;
+            paragraph?: string | null | undefined;
+            eli?: string | null | undefined;
+            inkrafttreten?: string | null | undefined;
+            ausserkrafttreten?: string | null | undefined;
+        };
+        content_urls: {
+            xml?: string | null | undefined;
+            html?: string | null | undefined;
+            rtf?: string | null | undefined;
+            pdf?: string | null | undefined;
+        };
+        kurztitel?: string | null | undefined;
+        dokument_url?: string | null | undefined;
+        gesamte_rechtsvorschrift_url?: string | null | undefined;
+    }, {
+        dokumentnummer: string;
+        applikation: string;
+        titel: string;
+        citation: {
+            kurztitel?: string | null | undefined;
+            langtitel?: string | null | undefined;
+            kundmachungsorgan?: string | null | undefined;
+            paragraph?: string | null | undefined;
+            eli?: string | null | undefined;
+            inkrafttreten?: string | null | undefined;
+            ausserkrafttreten?: string | null | undefined;
+        };
+        content_urls: {
+            xml?: string | null | undefined;
+            html?: string | null | undefined;
+            rtf?: string | null | undefined;
+            pdf?: string | null | undefined;
+        };
+        kurztitel?: string | null | undefined;
+        dokument_url?: string | null | undefined;
+        gesamte_rechtsvorschrift_url?: string | null | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    total_hits: number;
+    page: number;
+    page_size: number;
+    has_more: boolean;
+    documents: {
+        dokumentnummer: string;
+        applikation: string;
+        titel: string;
+        citation: {
+            kurztitel?: string | null | undefined;
+            langtitel?: string | null | undefined;
+            kundmachungsorgan?: string | null | undefined;
+            paragraph?: string | null | undefined;
+            eli?: string | null | undefined;
+            inkrafttreten?: string | null | undefined;
+            ausserkrafttreten?: string | null | undefined;
+        };
+        content_urls: {
+            xml?: string | null | undefined;
+            html?: string | null | undefined;
+            rtf?: string | null | undefined;
+            pdf?: string | null | undefined;
+        };
+        kurztitel?: string | null | undefined;
+        dokument_url?: string | null | undefined;
+        gesamte_rechtsvorschrift_url?: string | null | undefined;
+    }[];
+}, {
+    total_hits: number;
+    page: number;
+    page_size: number;
+    has_more: boolean;
+    documents: {
+        dokumentnummer: string;
+        applikation: string;
+        titel: string;
+        citation: {
+            kurztitel?: string | null | undefined;
+            langtitel?: string | null | undefined;
+            kundmachungsorgan?: string | null | undefined;
+            paragraph?: string | null | undefined;
+            eli?: string | null | undefined;
+            inkrafttreten?: string | null | undefined;
+            ausserkrafttreten?: string | null | undefined;
+        };
+        content_urls: {
+            xml?: string | null | undefined;
+            html?: string | null | undefined;
+            rtf?: string | null | undefined;
+            pdf?: string | null | undefined;
+        };
+        kurztitel?: string | null | undefined;
+        dokument_url?: string | null | undefined;
+        gesamte_rechtsvorschrift_url?: string | null | undefined;
+    }[];
+}>;
+export type SearchResult = z.infer<typeof SearchResultSchema>;
+/**
+ * Raw content URL from API response.
+ */
+export interface RawContentUrl {
+    DataType?: string;
+    Url?: string;
+}
+/**
+ * Raw URLs container from API response.
+ */
+export interface RawUrls {
+    ContentUrl?: RawContentUrl | RawContentUrl[];
+}
+/**
+ * Raw content reference from API response.
+ */
+export interface RawContentReference {
+    ContentType?: string;
+    Name?: string | {
+        '#text'?: string;
+    };
+    Urls?: RawUrls;
+}
+/**
+ * Raw hits info from API response.
+ */
+export interface RawHitsInfo {
+    '#text'?: string | number;
+    '@pageNumber'?: string | number;
+    '@pageSize'?: string | number;
+}
+/**
+ * Raw document reference from API response.
+ */
+export interface RawDocumentReference {
+    Data?: {
+        Metadaten?: {
+            Technisch?: {
+                ID?: string;
+                Applikation?: string;
+            };
+            Allgemein?: {
+                DokumentUrl?: string;
+            };
+            Bundesrecht?: {
+                Kurztitel?: string;
+                Langtitel?: string;
+                Titel?: string;
+                Eli?: string;
+                BrKons?: {
+                    Kundmachungsorgan?: string;
+                    ArtikelParagraphAnlage?: string;
+                    Inkrafttretensdatum?: string;
+                    Ausserkrafttretensdatum?: string;
+                    GesamteRechtsvorschriftUrl?: string;
+                };
+            };
+            Landesrecht?: {
+                Kurztitel?: string;
+                Langtitel?: string;
+                Titel?: string;
+                Eli?: string;
+                LrKons?: {
+                    Kundmachungsorgan?: string;
+                    ArtikelParagraphAnlage?: string;
+                    Inkrafttretensdatum?: string;
+                    Ausserkrafttretensdatum?: string;
+                    GesamteRechtsvorschriftUrl?: string;
+                };
+            };
+            Judikatur?: {
+                Geschaeftszahl?: {
+                    item?: string | string[];
+                } | string;
+                Entscheidungsdatum?: string;
+                Vfgh?: {
+                    Leitsatz?: string;
+                };
+                Vwgh?: {
+                    Leitsatz?: string;
+                };
+                Justiz?: {
+                    Leitsatz?: string;
+                };
+                Bvwg?: {
+                    Leitsatz?: string;
+                };
+            };
+        };
+        Dokumentliste?: {
+            ContentReference?: RawContentReference | RawContentReference[];
+        };
+    };
+}
+/**
+ * Raw API search response structure.
+ */
+export interface RawApiResponse {
+    OgdSearchResult?: {
+        OgdDocumentResults?: {
+            Hits?: RawHitsInfo | string | number;
+            OgdDocumentReference?: RawDocumentReference | RawDocumentReference[];
+        };
+    };
+}
+/**
+ * Normalized search results from client.
+ */
+export interface NormalizedSearchResults {
+    hits: number;
+    page_number: number;
+    page_size: number;
+    documents: RawDocumentReference[];
+}
+/**
+ * Map numeric limit to RIS API DokumenteProSeite value.
+ */
+export declare function limitToDokumenteProSeite(limit: number): DokumenteProSeite;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,151 @@
+/**
+ * Zod schemas and TypeScript types for the RIS MCP Server.
+ *
+ * This module defines all data models used for interacting with the Austrian
+ * Legal Information System (RIS) API, including enums for various search
+ * parameters and document models for representing legal documents.
+ */
+import { z } from 'zod';
+// =============================================================================
+// Enums
+// =============================================================================
+/**
+ * Application types for federal law searches in RIS.
+ */
+export const BundesrechtApplikationSchema = z.enum([
+    'BrKons', // Consolidated federal law
+    'Begut', // Draft legislation
+    'BgblAuth', // Federal Law Gazette authentic
+    'Erv', // English translations
+]);
+/**
+ * Court types for case law searches in RIS.
+ */
+export const JudikaturGerichtSchema = z.enum([
+    'Justiz', // Ordinary courts (OGH, OLG, LG, BG)
+    'Vfgh', // Constitutional Court
+    'Vwgh', // Supreme Administrative Court
+    'Bvwg', // Federal Administrative Court
+    'Lvwg', // State Administrative Courts
+    'Dsk', // Data Protection Authority
+    'AsylGH', // Asylum Court (historical, until 2013)
+    'Normenliste', // Court norm lists (judicial review)
+    'Pvak', // Personnel Representation Supervision Commission
+    'Gbk', // Equal Treatment Commission
+    'Dok', // Disciplinary Commission
+]);
+/**
+ * Austrian federal states (Bundesländer).
+ * Note: Uses Umlauts (ö, ä) for display purposes.
+ */
+export const BundeslandSchema = z.enum([
+    'Wien',
+    'Niederösterreich',
+    'Oberösterreich',
+    'Steiermark',
+    'Tirol',
+    'Kärnten',
+    'Salzburg',
+    'Vorarlberg',
+    'Burgenland',
+]);
+/**
+ * Austrian federal states for Landesrecht API (ASCII versions without Umlauts).
+ * The RIS API uses the SucheIn format (e.g., Bundesland.SucheInWien=true).
+ */
+export const LANDESRECHT_BUNDESLAENDER = [
+    'Wien',
+    'Niederoesterreich',
+    'Oberoesterreich',
+    'Salzburg',
+    'Tirol',
+    'Vorarlberg',
+    'Kaernten',
+    'Steiermark',
+    'Burgenland',
+];
+export const LandesrechtBundeslandSchema = z.enum(LANDESRECHT_BUNDESLAENDER);
+/**
+ * Date format validation schema (YYYY-MM-DD).
+ * Used for date parameters in RIS API requests.
+ */
+export const DateSchema = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, {
+    message: 'Datum muss im Format YYYY-MM-DD sein (z.B. 2024-01-15)',
+});
+export const OptionalDateSchema = DateSchema.optional();
+/**
+ * Number of documents per page for paginated API responses.
+ */
+export const DokumenteProSeiteSchema = z.enum([
+    'Ten', // 10 documents
+    'Twenty', // 20 documents
+    'Fifty', // 50 documents
+    'OneHundred', // 100 documents
+]);
+/**
+ * Output format for MCP tool responses.
+ */
+export const ResponseFormatSchema = z.enum(['markdown', 'json']);
+// =============================================================================
+// Document Models
+// =============================================================================
+/**
+ * URLs for accessing document content in different formats.
+ */
+export const ContentUrlSchema = z.object({
+    xml: z.string().nullable().optional(),
+    html: z.string().nullable().optional(),
+    rtf: z.string().nullable().optional(),
+    pdf: z.string().nullable().optional(),
+});
+/**
+ * Citation information for a legal document.
+ */
+export const CitationSchema = z.object({
+    kurztitel: z.string().nullable().optional(),
+    langtitel: z.string().nullable().optional(),
+    kundmachungsorgan: z.string().nullable().optional(),
+    paragraph: z.string().nullable().optional(),
+    eli: z.string().nullable().optional(),
+    inkrafttreten: z.string().nullable().optional(),
+    ausserkrafttreten: z.string().nullable().optional(),
+});
+/**
+ * A single legal document from the RIS database.
+ */
+export const DocumentSchema = z.object({
+    dokumentnummer: z.string(),
+    applikation: z.string(),
+    titel: z.string(),
+    kurztitel: z.string().nullable().optional(),
+    citation: CitationSchema,
+    content_urls: ContentUrlSchema,
+    dokument_url: z.string().nullable().optional(),
+    gesamte_rechtsvorschrift_url: z.string().nullable().optional(),
+});
+/**
+ * Paginated search results from the RIS API.
+ */
+export const SearchResultSchema = z.object({
+    total_hits: z.number().min(0),
+    page: z.number().min(1),
+    page_size: z.number().min(1).max(100),
+    has_more: z.boolean(),
+    documents: z.array(DocumentSchema),
+});
+// =============================================================================
+// Helper for limit mapping
+// =============================================================================
+/**
+ * Map numeric limit to RIS API DokumenteProSeite value.
+ */
+export function limitToDokumenteProSeite(limit) {
+    const mapping = {
+        10: 'Ten',
+        20: 'Twenty',
+        50: 'Fifty',
+        100: 'OneHundred',
+    };
+    return mapping[limit] ?? 'Twenty';
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}