redashify 0.1.0 → 0.2.0

package/README.md

@@ -93,7 +93,7 @@ const result = await redashify(text, {
 | `model` | `string` | *(per provider)* | Model name. Required if no provider default. |
 | `baseURL` | `string` | — | Custom endpoint URL. Overrides provider mapping. |
 | `llm` | `(messages) => Promise<string>` | — | Custom LLM function. Overrides apiKey/provider/model. |
-| `rules` | `string` | `""` | Custom rules prepended to the system prompt |
+| `rules` | `string` | `“”` | Custom rules prepended to the system prompt |
 | `contextSize` | `number` | `50` | Characters of context on each side of a dash |
 | `batchSize` | `number` | `50` | Maximum dashes per LLM call |
 
@@ -116,7 +116,7 @@ interface RedashifyResult {
 
 **No dashes in text:** LLM is not called. Returns immediately with `unchanged: true`.
 
-**All dashes already correct:** LLM is called (correctness can't be pre-judged), but `corrections` is empty and `unchanged` is `true`.
+**All dashes already correct:** LLM is called (correctness can’t be pre-judged), but `corrections` is empty and `unchanged` is `true`.
 
 ## Custom rules
 
@@ -147,7 +147,7 @@ Keep hyphens in compound modifiers and vote tallies (5-4).`,
 
 ## Design decisions
 
-**LLM over regex.** Dash correction depends on semantic context — is "10-20" a range (en dash) or a compound modifier (hyphen)? Is "--" an em dash or a typo? Regex can't answer these questions. An LLM can, given a few words of surrounding context.
+**LLM over regex.** Dash correction depends on semantic context — is “10-20” a range (en dash) or a compound modifier (hyphen)? Is “--” an em dash or a typo? Regex can’t answer these questions. An LLM can, given a few words of surrounding context.
 
 **Privacy by design.** Only short context windows around each dash are sent to the LLM — never the full document. A 10,000-word document with 5 dashes sends ~5 small context snippets, regardless of document length.
 
@@ -159,7 +159,7 @@ Keep hyphens in compound modifiers and vote tallies (5-4).`,
 
 ```sh
 npm install
-npm test          # 57 tests
+npm test
 npm run typecheck
 npm run build     # ESM + CJS + .d.ts
 ```

package/dist/index.cjs

@@ -1,9 +1,7 @@
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -17,14 +15,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -37,6 +27,9 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/core.ts
+var import_llm_client = require("@lexstyle/llm-client");
+
 // src/extractor.ts
 var DASH_RE = /---+|--|\u2014|\u2013|-/g;
 function extractDashes(text, contextSize = 50) {
@@ -91,83 +84,6 @@ Format: [{"id":0,"dash":"-"},{"id":1,"dash":"\u2013"}]`;
   ];
 }
 
-// src/llmClient.ts
-var import_openai = __toESM(require("openai"), 1);
-var PROVIDER_CONFIGS = {
-  openai: { baseURL: "https://api.openai.com/v1", defaultModel: "gpt-4o-mini" },
-  anthropic: { baseURL: "https://api.anthropic.com", defaultModel: "claude-haiku-4-5-20251001" },
-  gemini: { baseURL: "https://generativelanguage.googleapis.com/v1beta/openai", defaultModel: "gemini-2.0-flash" },
-  groq: { baseURL: "https://api.groq.com/openai/v1", defaultModel: "llama-3.3-70b-versatile" },
-  together: { baseURL: "https://api.together.xyz/v1", defaultModel: "meta-llama/Meta-Llama-3.1-8B-Instruct-Turbo" },
-  mistral: { baseURL: "https://api.mistral.ai/v1", defaultModel: "mistral-small-latest" },
-  openrouter: { baseURL: "https://openrouter.ai/api/v1", defaultModel: "" },
-  xai: { baseURL: "https://api.x.ai/v1", defaultModel: "grok-3-mini-fast" },
-  deepseek: { baseURL: "https://api.deepseek.com", defaultModel: "deepseek-chat" }
-};
-function getProviderConfig(provider) {
-  if (!(provider in PROVIDER_CONFIGS)) {
-    const valid = Object.keys(PROVIDER_CONFIGS).join(", ");
-    throw new Error(`Unknown provider "${provider}". Valid providers: ${valid}`);
-  }
-  return PROVIDER_CONFIGS[provider];
-}
-async function callAnthropic(messages, apiKey, model, baseURL) {
-  const resolvedBaseURL = (baseURL ?? PROVIDER_CONFIGS.anthropic.baseURL).replace(/\/+$/, "").replace(/\/v1$/i, "");
-  const url = `${resolvedBaseURL}/v1/messages`;
-  const systemMsg = messages.find((m) => m.role === "system");
-  const nonSystemMsgs = messages.filter((m) => m.role !== "system");
-  const body = {
-    model,
-    max_tokens: 4096,
-    messages: nonSystemMsgs.map((m) => ({ role: m.role, content: m.content }))
-  };
-  if (systemMsg) {
-    body.system = systemMsg.content;
-  }
-  const res = await fetch(url, {
-    method: "POST",
-    headers: {
-      "content-type": "application/json",
-      "x-api-key": apiKey,
-      "anthropic-version": "2023-06-01"
-    },
-    body: JSON.stringify(body)
-  });
-  if (!res.ok) {
-    const text = await res.text();
-    throw new Error(`Anthropic API error (${res.status}): ${text}`);
-  }
-  const data = await res.json();
-  const textBlock = data.content?.find((b) => b.type === "text");
-  if (!textBlock?.text) {
-    throw new Error("Anthropic returned an empty response");
-  }
-  return textBlock.text;
-}
-async function callOpenAICompatible(messages, apiKey, model, baseURL) {
-  const client = new import_openai.default({
-    apiKey,
-    ...baseURL ? { baseURL } : {}
-  });
-  const response = await client.chat.completions.create({
-    model,
-    messages,
-    temperature: 0
-  });
-  const content = response.choices[0]?.message?.content;
-  if (!content) {
-    throw new Error("LLM returned an empty response");
-  }
-  return content;
-}
-async function callLLM(messages, apiKey, model, provider, baseURL) {
-  if (provider === "anthropic") {
-    return callAnthropic(messages, apiKey, model, baseURL);
-  }
-  const resolvedBaseURL = baseURL ?? (provider ? PROVIDER_CONFIGS[provider].baseURL : void 0);
-  return callOpenAICompatible(messages, apiKey, model, resolvedBaseURL);
-}
-
 // src/types.ts
 var VALID_DASHES = Object.freeze(["-", "\u2013", "\u2014"]);
 var VALID_DASH_SET = new Set(VALID_DASHES);
@@ -278,24 +194,6 @@ function requireInt(value, name, min) {
     throw new Error(`Invalid ${name}: ${value}. Must be a finite integer >= ${min}.`);
   }
 }
-function resolveLlm(options) {
-  if (options.llm) {
-    if (typeof options.llm !== "function") {
-      throw new Error("`llm` option must be a function");
-    }
-    return options.llm;
-  }
-  if (options.apiKey) {
-    const providerConfig = options.provider ? getProviderConfig(options.provider) : void 0;
-    const model = options.model ?? providerConfig?.defaultModel;
-    if (!model) {
-      throw new Error("redashify requires `model` when using `apiKey` (or use a `provider` with a default model)");
-    }
-    const { apiKey, provider, baseURL } = options;
-    return (messages) => callLLM(messages, apiKey, model, provider, baseURL);
-  }
-  throw new Error("redashify requires either `apiKey` + `model`, `apiKey` + `provider`, or `llm` option");
-}
 function validateBatchIds(corrections, expectedIds) {
   for (const { id } of corrections) {
     if (!expectedIds.has(id)) {
@@ -316,7 +214,7 @@ async function redashify(text, options) {
   requireInt(batchSize, "batchSize", 1);
   const contextSize = options.contextSize ?? 50;
   requireInt(contextSize, "contextSize", 0);
-  const llmFn = resolveLlm(options);
+  const llmFn = (0, import_llm_client.resolveLlm)(options, "redashify");
   const contexts = extractDashes(text, contextSize);
   if (contexts.length === 0) {
     return { text, corrections: [], unchanged: true };

package/dist/index.d.cts

@@ -1,3 +1,6 @@
+import { LlmOptions, Message } from '@lexstyle/llm-client';
+export { Message, Provider } from '@lexstyle/llm-client';
+
 /** The valid dash characters, exported for documentation/reference */
 declare const VALID_DASHES: readonly ["-", "–", "—"];
 /** A single valid dash character: hyphen, en dash, or em dash */
@@ -42,25 +45,8 @@ interface RedashifyResult {
     /** True if no changes were needed */
     unchanged: boolean;
 }
-/** Chat message format for the LLM function */
-interface Message {
-    role: "system" | "user" | "assistant";
-    content: string;
-}
-/** Known providers with built-in base URL mapping */
-type Provider = "openai" | "anthropic" | "gemini" | "groq" | "together" | "mistral" | "openrouter" | "xai" | "deepseek";
 /** Options for redashify */
-interface RedashifyOptions {
-    /** API key for the LLM provider */
-    apiKey?: string;
-    /** LLM provider name (e.g. "openai", "groq", "together"). Maps to a known base URL. */
-    provider?: Provider;
-    /** Model name (e.g. "gpt-4o-mini", "llama-3.3-70b-versatile"). Required when using apiKey without a known provider default. */
-    model?: string;
-    /** Custom base URL for OpenAI-compatible APIs. Overrides provider mapping. */
-    baseURL?: string;
-    /** Custom LLM function: receives messages, returns the raw text response. Overrides apiKey/provider/model. */
-    llm?: (messages: Message[]) => Promise<string>;
+interface RedashifyOptions extends LlmOptions {
     /** Characters of context on each side of a dash (default: 50) */
     contextSize?: number;
     /** Custom rules to prepend to the system prompt */
@@ -93,4 +79,4 @@ declare function extractDashes(text: string, contextSize?: number): DashContext[
  */
 declare function buildMessages(contexts: readonly DashContext[], rules?: string): Message[];
 
-export { type ApplyResult, type Correction, type DashChar, type DashContext, type Message, type Provider, type RedashifyOptions, type RedashifyResult, VALID_DASHES, buildMessages, extractDashes, redashify };
+export { type ApplyResult, type Correction, type DashChar, type DashContext, type RedashifyOptions, type RedashifyResult, VALID_DASHES, buildMessages, extractDashes, redashify };

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+import { LlmOptions, Message } from '@lexstyle/llm-client';
+export { Message, Provider } from '@lexstyle/llm-client';
+
 /** The valid dash characters, exported for documentation/reference */
 declare const VALID_DASHES: readonly ["-", "–", "—"];
 /** A single valid dash character: hyphen, en dash, or em dash */
@@ -42,25 +45,8 @@ interface RedashifyResult {
     /** True if no changes were needed */
     unchanged: boolean;
 }
-/** Chat message format for the LLM function */
-interface Message {
-    role: "system" | "user" | "assistant";
-    content: string;
-}
-/** Known providers with built-in base URL mapping */
-type Provider = "openai" | "anthropic" | "gemini" | "groq" | "together" | "mistral" | "openrouter" | "xai" | "deepseek";
 /** Options for redashify */
-interface RedashifyOptions {
-    /** API key for the LLM provider */
-    apiKey?: string;
-    /** LLM provider name (e.g. "openai", "groq", "together"). Maps to a known base URL. */
-    provider?: Provider;
-    /** Model name (e.g. "gpt-4o-mini", "llama-3.3-70b-versatile"). Required when using apiKey without a known provider default. */
-    model?: string;
-    /** Custom base URL for OpenAI-compatible APIs. Overrides provider mapping. */
-    baseURL?: string;
-    /** Custom LLM function: receives messages, returns the raw text response. Overrides apiKey/provider/model. */
-    llm?: (messages: Message[]) => Promise<string>;
+interface RedashifyOptions extends LlmOptions {
     /** Characters of context on each side of a dash (default: 50) */
     contextSize?: number;
     /** Custom rules to prepend to the system prompt */
@@ -93,4 +79,4 @@ declare function extractDashes(text: string, contextSize?: number): DashContext[
  */
 declare function buildMessages(contexts: readonly DashContext[], rules?: string): Message[];
 
-export { type ApplyResult, type Correction, type DashChar, type DashContext, type Message, type Provider, type RedashifyOptions, type RedashifyResult, VALID_DASHES, buildMessages, extractDashes, redashify };
+export { type ApplyResult, type Correction, type DashChar, type DashContext, type RedashifyOptions, type RedashifyResult, VALID_DASHES, buildMessages, extractDashes, redashify };

package/dist/index.js

@@ -1,3 +1,6 @@
+// src/core.ts
+import { resolveLlm } from "@lexstyle/llm-client";
+
 // src/extractor.ts
 var DASH_RE = /---+|--|\u2014|\u2013|-/g;
 function extractDashes(text, contextSize = 50) {
@@ -52,83 +55,6 @@ Format: [{"id":0,"dash":"-"},{"id":1,"dash":"\u2013"}]`;
   ];
 }
 
-// src/llmClient.ts
-import OpenAI from "openai";
-var PROVIDER_CONFIGS = {
-  openai: { baseURL: "https://api.openai.com/v1", defaultModel: "gpt-4o-mini" },
-  anthropic: { baseURL: "https://api.anthropic.com", defaultModel: "claude-haiku-4-5-20251001" },
-  gemini: { baseURL: "https://generativelanguage.googleapis.com/v1beta/openai", defaultModel: "gemini-2.0-flash" },
-  groq: { baseURL: "https://api.groq.com/openai/v1", defaultModel: "llama-3.3-70b-versatile" },
-  together: { baseURL: "https://api.together.xyz/v1", defaultModel: "meta-llama/Meta-Llama-3.1-8B-Instruct-Turbo" },
-  mistral: { baseURL: "https://api.mistral.ai/v1", defaultModel: "mistral-small-latest" },
-  openrouter: { baseURL: "https://openrouter.ai/api/v1", defaultModel: "" },
-  xai: { baseURL: "https://api.x.ai/v1", defaultModel: "grok-3-mini-fast" },
-  deepseek: { baseURL: "https://api.deepseek.com", defaultModel: "deepseek-chat" }
-};
-function getProviderConfig(provider) {
-  if (!(provider in PROVIDER_CONFIGS)) {
-    const valid = Object.keys(PROVIDER_CONFIGS).join(", ");
-    throw new Error(`Unknown provider "${provider}". Valid providers: ${valid}`);
-  }
-  return PROVIDER_CONFIGS[provider];
-}
-async function callAnthropic(messages, apiKey, model, baseURL) {
-  const resolvedBaseURL = (baseURL ?? PROVIDER_CONFIGS.anthropic.baseURL).replace(/\/+$/, "").replace(/\/v1$/i, "");
-  const url = `${resolvedBaseURL}/v1/messages`;
-  const systemMsg = messages.find((m) => m.role === "system");
-  const nonSystemMsgs = messages.filter((m) => m.role !== "system");
-  const body = {
-    model,
-    max_tokens: 4096,
-    messages: nonSystemMsgs.map((m) => ({ role: m.role, content: m.content }))
-  };
-  if (systemMsg) {
-    body.system = systemMsg.content;
-  }
-  const res = await fetch(url, {
-    method: "POST",
-    headers: {
-      "content-type": "application/json",
-      "x-api-key": apiKey,
-      "anthropic-version": "2023-06-01"
-    },
-    body: JSON.stringify(body)
-  });
-  if (!res.ok) {
-    const text = await res.text();
-    throw new Error(`Anthropic API error (${res.status}): ${text}`);
-  }
-  const data = await res.json();
-  const textBlock = data.content?.find((b) => b.type === "text");
-  if (!textBlock?.text) {
-    throw new Error("Anthropic returned an empty response");
-  }
-  return textBlock.text;
-}
-async function callOpenAICompatible(messages, apiKey, model, baseURL) {
-  const client = new OpenAI({
-    apiKey,
-    ...baseURL ? { baseURL } : {}
-  });
-  const response = await client.chat.completions.create({
-    model,
-    messages,
-    temperature: 0
-  });
-  const content = response.choices[0]?.message?.content;
-  if (!content) {
-    throw new Error("LLM returned an empty response");
-  }
-  return content;
-}
-async function callLLM(messages, apiKey, model, provider, baseURL) {
-  if (provider === "anthropic") {
-    return callAnthropic(messages, apiKey, model, baseURL);
-  }
-  const resolvedBaseURL = baseURL ?? (provider ? PROVIDER_CONFIGS[provider].baseURL : void 0);
-  return callOpenAICompatible(messages, apiKey, model, resolvedBaseURL);
-}
-
 // src/types.ts
 var VALID_DASHES = Object.freeze(["-", "\u2013", "\u2014"]);
 var VALID_DASH_SET = new Set(VALID_DASHES);
@@ -239,24 +165,6 @@ function requireInt(value, name, min) {
     throw new Error(`Invalid ${name}: ${value}. Must be a finite integer >= ${min}.`);
   }
 }
-function resolveLlm(options) {
-  if (options.llm) {
-    if (typeof options.llm !== "function") {
-      throw new Error("`llm` option must be a function");
-    }
-    return options.llm;
-  }
-  if (options.apiKey) {
-    const providerConfig = options.provider ? getProviderConfig(options.provider) : void 0;
-    const model = options.model ?? providerConfig?.defaultModel;
-    if (!model) {
-      throw new Error("redashify requires `model` when using `apiKey` (or use a `provider` with a default model)");
-    }
-    const { apiKey, provider, baseURL } = options;
-    return (messages) => callLLM(messages, apiKey, model, provider, baseURL);
-  }
-  throw new Error("redashify requires either `apiKey` + `model`, `apiKey` + `provider`, or `llm` option");
-}
 function validateBatchIds(corrections, expectedIds) {
   for (const { id } of corrections) {
     if (!expectedIds.has(id)) {
@@ -277,7 +185,7 @@ async function redashify(text, options) {
   requireInt(batchSize, "batchSize", 1);
   const contextSize = options.contextSize ?? 50;
   requireInt(contextSize, "contextSize", 0);
-  const llmFn = resolveLlm(options);
+  const llmFn = resolveLlm(options, "redashify");
   const contexts = extractDashes(text, contextSize);
   if (contexts.length === 0) {
     return { text, corrections: [], unchanged: true };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "redashify",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Context-aware dash correction powered by LLMs",
   "author": "Haihang Wang",
   "type": "module",
@@ -54,7 +54,7 @@
     "url": "https://github.com/hangingahaw/redashify/issues"
   },
   "dependencies": {
-    "openai": "^4.50.0"
+    "@lexstyle/llm-client": "^0.1.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0",