@dromney/mapthis 0.1.0 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@dromney/mapthis",
-    "version": "0.1.0",
+    "version": "0.2.0",
     "description": "Open-source location intelligence: parse freeform text, HTML, and URLs into geocoded locations, with types and React components.",
     "license": "Apache-2.0",
     "author": "Dallin Romney",
@@ -91,19 +91,21 @@
         "clean": "rm -rf dist",
         "prepublishOnly": "npm run clean && npm run typecheck && npm test && npm run build"
     },
-    "dependencies": {
-        "zod": "^3.22.4"
-    },
     "peerDependencies": {
+        "@anthropic-ai/sdk": "^0.30.0",
         "@googlemaps/google-maps-services-js": "^3.3.42",
         "@vis.gl/react-google-maps": "^0.5.0",
         "html-to-text": "^9.0.5",
         "js-tiktoken": "^1.0.19",
         "openai": "^4.26.0",
         "react": "^18.2.0 || ^19.0.0",
-        "react-dom": "^18.2.0 || ^19.0.0"
+        "react-dom": "^18.2.0 || ^19.0.0",
+        "zod": "^3.22.4"
     },
     "peerDependenciesMeta": {
+        "@anthropic-ai/sdk": {
+            "optional": true
+        },
         "@googlemaps/google-maps-services-js": {
             "optional": true
         },
@@ -127,6 +129,7 @@
         }
     },
     "devDependencies": {
+        "@anthropic-ai/sdk": "^0.30.1",
         "@googlemaps/google-maps-services-js": "^3.3.42",
         "@types/google.maps": "^3.55.1",
         "@types/html-to-text": "^9.0.4",
@@ -142,7 +145,8 @@
         "react-dom": "^18.2.0",
         "tsup": "^8.0.0",
         "typescript": "^5.3.3",
-        "vitest": "^1.2.0"
+        "vitest": "^1.2.0",
+        "zod": "3.25.76"
     },
     "engines": {
         "node": ">=18"

package/dist/parser-CzXzpmVv.d.cts

@@ -1,111 +0,0 @@
-import { JSONSchema7Object } from 'json-schema';
-import { a as ParsedLocations } from './domain-Dc1wSTkf.cjs';
-
-/**
- * Generic LLM output envelope with token accounting.
- */
-interface OpenAIOutput<T> {
-    output: T;
-    inputTokens: number;
-    outputTokens: number;
-}
-/**
- * Request shape for a function-calling JSON completion.
- */
-interface GenericAIJsonRequest {
-    schema: JSONSchema7Object;
-    systemMessage: string;
-    userMessage: string;
-    functionName: string;
-}
-/**
- * Result of summarizing a text blob prior to a final extraction call.
- */
-interface SummarizedText {
-    text: string;
-    textTokens: number;
-    summarized: string;
-    summarizedTokens: number;
-    chunks: number;
-    inputTokens: number;
-    outputTokens: number;
-    summarizePromptVersion: string;
-}
-/**
- * Result of parsing locations from any source. Includes full token
- * accounting so callers can bill usage to their own users.
- */
-interface GetLocationsResponse {
-    output: ParsedLocations;
-    textTokens: number;
-    summarizedTokens: number;
-    summaryInputTokens: number;
-    summaryOutputTokens: number;
-    locationInputTokens: number;
-    locationOutputTokens: number;
-    inputTokens: number;
-    outputTokens: number;
-    summaryPromptVersion: string;
-    locationPromptVersion: string;
-}
-
-declare const DEFAULT_MODEL = "gpt-4o-mini";
-declare const DEFAULT_TOKEN_LIMIT = 128000;
-/**
- * An OpenAI-backed inference context shared by the summarizer and location
- * parser. Instances are produced by {@link createOpenAiBackend} so API keys
- * and model choices live in the consumer's code, never in module-level state.
- */
-interface OpenAiBackend {
-    readonly model: string;
-    readonly tokenLimit: number;
-    countTokens(text: string): number;
-    chatCompletion(content: string): Promise<OpenAIOutput<string>>;
-    chatFunctionJson<T>(systemMessage: string, userMessage: string, schema: JSONSchema7Object, functionName: string): Promise<OpenAIOutput<T>>;
-}
-interface OpenAiBackendConfig {
-    /** OpenAI API key. Passed directly to the SDK. */
-    apiKey: string;
-    /** Model name passed to the completions API. Defaults to `gpt-4o-mini`. */
-    model?: string;
-    /** Context-window budget used by the summarizer. Defaults to 128k. */
-    tokenLimit?: number;
-    /**
-     * Optional base URL for the OpenAI API. Use this to route through an
-     * OpenAI-compatible gateway (Azure, Together, etc.).
-     */
-    baseURL?: string;
-}
-/**
- * Construct an {@link OpenAiBackend} bound to a specific API key and model.
- */
-declare function createOpenAiBackend(config: OpenAiBackendConfig): OpenAiBackend;
-
-/**
- * A configured location-extraction pipeline. Hold onto one of these for the
- * lifetime of your app — it wraps an OpenAI client and a tiktoken encoder.
- */
-interface LocationParser {
-    parseLocationsFromText(text: string): Promise<GetLocationsResponse>;
-    parseLocationsFromHtml(html: string): Promise<GetLocationsResponse>;
-    parseLocationsFromUrl(url: string): Promise<GetLocationsResponse>;
-}
-type LocationParserConfig = OpenAiBackendConfig;
-/**
- * Create a {@link LocationParser} bound to an OpenAI API key.
- *
- * @example
- * ```ts
- * const parser = createLocationParser({
- *   apiKey: process.env.OPENAI_API_KEY!,
- *   model: "gpt-4o-mini",
- * })
- * const { output } = await parser.parseLocationsFromUrl(
- *   "https://example.com/best-restaurants-tokyo",
- * )
- * console.log(output.title, output.locations)
- * ```
- */
-declare function createLocationParser(config: LocationParserConfig): LocationParser;
-
-export { DEFAULT_MODEL as D, type GetLocationsResponse as G, type LocationParser as L, type OpenAiBackend as O, type SummarizedText as S, DEFAULT_TOKEN_LIMIT as a, type GenericAIJsonRequest as b, type LocationParserConfig as c, type OpenAIOutput as d, type OpenAiBackendConfig as e, createLocationParser as f, createOpenAiBackend as g };

package/dist/parser-N7-fNxeu.d.ts

@@ -1,111 +0,0 @@
-import { JSONSchema7Object } from 'json-schema';
-import { a as ParsedLocations } from './domain-CZ-L-ntu.js';
-
-/**
- * Generic LLM output envelope with token accounting.
- */
-interface OpenAIOutput<T> {
-    output: T;
-    inputTokens: number;
-    outputTokens: number;
-}
-/**
- * Request shape for a function-calling JSON completion.
- */
-interface GenericAIJsonRequest {
-    schema: JSONSchema7Object;
-    systemMessage: string;
-    userMessage: string;
-    functionName: string;
-}
-/**
- * Result of summarizing a text blob prior to a final extraction call.
- */
-interface SummarizedText {
-    text: string;
-    textTokens: number;
-    summarized: string;
-    summarizedTokens: number;
-    chunks: number;
-    inputTokens: number;
-    outputTokens: number;
-    summarizePromptVersion: string;
-}
-/**
- * Result of parsing locations from any source. Includes full token
- * accounting so callers can bill usage to their own users.
- */
-interface GetLocationsResponse {
-    output: ParsedLocations;
-    textTokens: number;
-    summarizedTokens: number;
-    summaryInputTokens: number;
-    summaryOutputTokens: number;
-    locationInputTokens: number;
-    locationOutputTokens: number;
-    inputTokens: number;
-    outputTokens: number;
-    summaryPromptVersion: string;
-    locationPromptVersion: string;
-}
-
-declare const DEFAULT_MODEL = "gpt-4o-mini";
-declare const DEFAULT_TOKEN_LIMIT = 128000;
-/**
- * An OpenAI-backed inference context shared by the summarizer and location
- * parser. Instances are produced by {@link createOpenAiBackend} so API keys
- * and model choices live in the consumer's code, never in module-level state.
- */
-interface OpenAiBackend {
-    readonly model: string;
-    readonly tokenLimit: number;
-    countTokens(text: string): number;
-    chatCompletion(content: string): Promise<OpenAIOutput<string>>;
-    chatFunctionJson<T>(systemMessage: string, userMessage: string, schema: JSONSchema7Object, functionName: string): Promise<OpenAIOutput<T>>;
-}
-interface OpenAiBackendConfig {
-    /** OpenAI API key. Passed directly to the SDK. */
-    apiKey: string;
-    /** Model name passed to the completions API. Defaults to `gpt-4o-mini`. */
-    model?: string;
-    /** Context-window budget used by the summarizer. Defaults to 128k. */
-    tokenLimit?: number;
-    /**
-     * Optional base URL for the OpenAI API. Use this to route through an
-     * OpenAI-compatible gateway (Azure, Together, etc.).
-     */
-    baseURL?: string;
-}
-/**
- * Construct an {@link OpenAiBackend} bound to a specific API key and model.
- */
-declare function createOpenAiBackend(config: OpenAiBackendConfig): OpenAiBackend;
-
-/**
- * A configured location-extraction pipeline. Hold onto one of these for the
- * lifetime of your app — it wraps an OpenAI client and a tiktoken encoder.
- */
-interface LocationParser {
-    parseLocationsFromText(text: string): Promise<GetLocationsResponse>;
-    parseLocationsFromHtml(html: string): Promise<GetLocationsResponse>;
-    parseLocationsFromUrl(url: string): Promise<GetLocationsResponse>;
-}
-type LocationParserConfig = OpenAiBackendConfig;
-/**
- * Create a {@link LocationParser} bound to an OpenAI API key.
- *
- * @example
- * ```ts
- * const parser = createLocationParser({
- *   apiKey: process.env.OPENAI_API_KEY!,
- *   model: "gpt-4o-mini",
- * })
- * const { output } = await parser.parseLocationsFromUrl(
- *   "https://example.com/best-restaurants-tokyo",
- * )
- * console.log(output.title, output.locations)
- * ```
- */
-declare function createLocationParser(config: LocationParserConfig): LocationParser;
-
-export { DEFAULT_MODEL as D, type GetLocationsResponse as G, type LocationParser as L, type OpenAiBackend as O, type SummarizedText as S, DEFAULT_TOKEN_LIMIT as a, type GenericAIJsonRequest as b, type LocationParserConfig as c, type OpenAIOutput as d, type OpenAiBackendConfig as e, createLocationParser as f, createOpenAiBackend as g };