@orizn/langchain 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Orizn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# @orizn/langchain
+
+LangChain.js tools for the [Orizn Visa API](https://visa.orizn.app) — check visa requirements for 39,585 passport-destination pairs in 15 languages.
+
+## Install
+
+```bash
+npm install @orizn/langchain
+```
+
+## Quick start
+
+```typescript
+import { OriznQuickVisaCheckTool, OriznVisaCheckTool } from "@orizn/langchain";
+
+// No API key needed for quick checks
+const quick = new OriznQuickVisaCheckTool();
+const result = await quick.invoke(
+  { passport: "FRA", destination: "JPN" }
+);
+console.log(result);
+
+// Full details (needs API key)
+const full = new OriznVisaCheckTool("your-api-key");
+const details = await full.invoke(
+  { passport: "FRA", destination: "JPN", lang: "fr" }
+);
+console.log(details);
+```
+
+## Use with a LangChain agent
+
+```typescript
+import { ChatOpenAI } from "@langchain/openai";
+import { AgentExecutor, createOpenAIFunctionsAgent } from "langchain/agents";
+import { OriznQuickVisaCheckTool, OriznVisaCheckTool } from "@orizn/langchain";
+
+const tools = [
+  new OriznQuickVisaCheckTool(),
+  new OriznVisaCheckTool("your-api-key"),
+];
+
+// Use with your preferred LangChain agent setup
+```
+
+## Available tools
+
+| Tool | Description | API Key |
+|------|-------------|---------|
+| `OriznVisaCheckTool` | Full visa details with documents, process & tips | Required |
+| `OriznQuickVisaCheckTool` | Quick yes/no visa check | Not needed |
+
+## Links
+
+- [API](https://visa.orizn.app)
+- [Docs](https://visa.orizn.app/visa-api/dashboard/docs)
+- [MCP Server](https://github.com/MattJeff/orizn-mcp-server)
+- [Python package](https://pypi.org/project/langchain-orizn/)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { OriznVisaCheckTool, OriznQuickVisaCheckTool } from "./tools.js";

package/dist/index.js

@@ -0,0 +1 @@
+export { OriznVisaCheckTool, OriznQuickVisaCheckTool } from "./tools.js";

package/dist/tools.d.ts

@@ -0,0 +1,30 @@
+import { StructuredTool } from "@langchain/core/tools";
+import { z } from "zod";
+export declare class OriznVisaCheckTool extends StructuredTool {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        passport: z.ZodString;
+        destination: z.ZodString;
+        lang: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    private apiKey?;
+    constructor(apiKey?: string);
+    _call({ passport, destination, lang, }: {
+        passport: string;
+        destination: string;
+        lang?: string;
+    }): Promise<string>;
+}
+export declare class OriznQuickVisaCheckTool extends StructuredTool {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        passport: z.ZodString;
+        destination: z.ZodString;
+    }, z.core.$strip>;
+    _call({ passport, destination, }: {
+        passport: string;
+        destination: string;
+    }): Promise<string>;
+}

package/dist/tools.js

@@ -0,0 +1,68 @@
+import { StructuredTool } from "@langchain/core/tools";
+import { z } from "zod";
+const BASE_URL = "https://visa.orizn.app";
+export class OriznVisaCheckTool extends StructuredTool {
+    name = "orizn_visa_check";
+    description = "Check visa requirements between any two countries. " +
+        "Returns visa type, duration, required documents, process steps, and travel tips. " +
+        "Covers 39,585 passport-destination pairs in 15 languages. " +
+        "Use ISO 3166-1 alpha-3 country codes (e.g., FRA for France, JPN for Japan).";
+    schema = z.object({
+        passport: z
+            .string()
+            .describe("ISO 3166-1 alpha-3 code of passport country (e.g., FRA, USA, JPN)"),
+        destination: z
+            .string()
+            .describe("ISO 3166-1 alpha-3 code of destination country (e.g., THA, BRA, GBR)"),
+        lang: z
+            .string()
+            .default("en")
+            .describe("Language code (en, fr, es, pt, de, ja, ko, zh, ru, it, ar, hi, th, vi, tl)"),
+    });
+    apiKey;
+    constructor(apiKey) {
+        super();
+        this.apiKey = apiKey ?? process.env.ORIZN_API_KEY;
+    }
+    async _call({ passport, destination, lang, }) {
+        const params = new URLSearchParams({
+            passport: passport.toUpperCase(),
+            destination: destination.toUpperCase(),
+            lang: lang ?? "en",
+        });
+        const headers = {};
+        if (this.apiKey) {
+            headers["x-api-key"] = this.apiKey;
+        }
+        const resp = await fetch(`${BASE_URL}/api/v1/visa?${params}`, { headers });
+        if (!resp.ok) {
+            throw new Error(`Orizn API error: ${resp.status} ${resp.statusText}`);
+        }
+        return JSON.stringify(await resp.json());
+    }
+}
+export class OriznQuickVisaCheckTool extends StructuredTool {
+    name = "orizn_quick_visa_check";
+    description = "Quick check if a visa is required between two countries. " +
+        "Returns visa type (visa_free, visa_required, e_visa, visa_on_arrival, eta, no_admission) and duration. " +
+        "No API key needed. Use ISO 3166-1 alpha-3 codes.";
+    schema = z.object({
+        passport: z
+            .string()
+            .describe("ISO 3166-1 alpha-3 code of passport country"),
+        destination: z
+            .string()
+            .describe("ISO 3166-1 alpha-3 code of destination country"),
+    });
+    async _call({ passport, destination, }) {
+        const params = new URLSearchParams({
+            passport: passport.toUpperCase(),
+            destination: destination.toUpperCase(),
+        });
+        const resp = await fetch(`${BASE_URL}/api/v1/visa/check?${params}`);
+        if (!resp.ok) {
+            throw new Error(`Orizn API error: ${resp.status} ${resp.statusText}`);
+        }
+        return JSON.stringify(await resp.json());
+    }
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@orizn/langchain",
+  "version": "0.1.0",
+  "description": "LangChain.js tools for Orizn Visa API — 39,585 passport-destination pairs in 15 languages",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "langchain",
+    "visa",
+    "travel",
+    "passport",
+    "ai-agent",
+    "tool",
+    "orizn"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MattJeff/langchain-orizn-js"
+  },
+  "homepage": "https://visa.orizn.app",
+  "author": "Orizn",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@langchain/core": ">=0.2.0",
+    "zod": ">=3.22.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.10.0"
+  },
+  "peerDependencies": {
+    "@langchain/core": ">=0.2.0"
+  }
+}