@qinisolabs/qiniso 0.1.0

package/dist/http.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/http.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import {
+  LOGO_SVG,
+  handleRpc
+} from "./chunk-TDQYIG3R.js";
+
+// src/http.ts
+import { createServer } from "http";
+var PORT = Number(process.env.PORT ?? 8787);
+var server = createServer((req, res) => {
+  const send = (status, body) => res.writeHead(status, { "content-type": "application/json" }).end(body);
+  if (req.method === "GET" && req.url === "/health") return send(200, '{"status":"ok"}');
+  if (req.method === "GET" && (req.url === "/icon.svg" || req.url === "/favicon.ico")) {
+    return res.writeHead(200, { "content-type": "image/svg+xml" }).end(LOGO_SVG);
+  }
+  if (req.method !== "POST") return send(405, '{"error":"method not allowed"}');
+  let raw = "";
+  req.on("data", (c) => raw += c);
+  req.on("end", () => {
+    let payload;
+    try {
+      payload = JSON.parse(raw);
+    } catch {
+      return send(400, '{"error":"invalid json"}');
+    }
+    if (Array.isArray(payload)) {
+      const out = payload.map(handleRpc).filter(Boolean);
+      return send(200, JSON.stringify(out));
+    }
+    const r = handleRpc(payload);
+    if (r === null) return res.writeHead(202).end();
+    return send(200, JSON.stringify(r));
+  });
+});
+server.listen(PORT, () => console.error(`qiniso HTTP MCP listening on :${PORT}/mcp`));

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+export * from '@qiniso/identifiers';
+export * from '@qiniso/network';
+export * from '@qiniso/finance';
+export * from '@qiniso/crypto';
+export * from '@qiniso/national-id';
+export * from '@qiniso/academic';
+export * from '@qiniso/locale';
+export * from '@qiniso/vat';
+
+interface ToolArg {
+    name: string;
+    description: string;
+    optional?: boolean;
+}
+interface ToolSpec {
+    name: string;
+    description: string;
+    argName?: string;
+    argDescription?: string;
+    run?: (value: string) => unknown;
+    args?: ToolArg[];
+    runArgs?: (a: Record<string, string | undefined>) => unknown;
+}
+/** Every checkable-fact tool the layer exposes. New modules append here. */
+declare const TOOLS: ToolSpec[];
+declare const SERVER_INFO: {
+    readonly name: "qiniso";
+    readonly version: "0.1.0";
+};
+declare function listTools(): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: Record<string, unknown>;
+        required: string[];
+        additionalProperties: boolean;
+    };
+}[];
+declare function callTool(name: string, args: Record<string, unknown> | undefined): {
+    content: {
+        type: string;
+        text: string;
+    }[];
+};
+interface JsonRpcMessage {
+    jsonrpc?: string;
+    id?: string | number;
+    method?: string;
+    params?: any;
+}
+/**
+ * Handle one JSON-RPC message. Returns the response object, or null for
+ * notifications (which must produce no body). Stateless: no sessions.
+ */
+declare function handleRpc(msg: JsonRpcMessage): object | null;
+
+export { SERVER_INFO, TOOLS, callTool, handleRpc, listTools };

package/dist/index.js

@@ -0,0 +1,108 @@
+import {
+  SERVER_INFO,
+  TOOLS,
+  callTool,
+  detectBrand,
+  formatMoney,
+  handleRpc,
+  ibanCheckDigits,
+  isHoliday,
+  isIPv4,
+  isIPv6,
+  isKnownTld,
+  isbn13CheckDigit,
+  knownTldCount,
+  listTools,
+  luhnCheckDigit,
+  luhnValid,
+  nextHoliday,
+  normalizeIban,
+  parseAddress,
+  parseDate,
+  supportedIbanCountries,
+  validateAadhaar,
+  validateAba,
+  validateBtcAddress,
+  validateCard,
+  validateCnpj,
+  validateCpf,
+  validateCusip,
+  validateDni,
+  validateDomain,
+  validateEmail,
+  validateEthAddress,
+  validateIban,
+  validateIp,
+  validateIsbn10,
+  validateIsbn13,
+  validateIsin,
+  validateIssn,
+  validateLei,
+  validateOrcid,
+  validatePhone,
+  validateSaId,
+  validateSedol,
+  validateTld,
+  validateUrl,
+  validateUuid,
+  validateVat,
+  validateVin,
+  vatRate,
+  verhoeffGenerate,
+  verhoeffValid,
+  vinCheckDigit
+} from "./chunk-TDQYIG3R.js";
+export {
+  SERVER_INFO,
+  TOOLS,
+  callTool,
+  detectBrand,
+  formatMoney,
+  handleRpc,
+  ibanCheckDigits,
+  isHoliday,
+  isIPv4,
+  isIPv6,
+  isKnownTld,
+  isbn13CheckDigit,
+  knownTldCount,
+  listTools,
+  luhnCheckDigit,
+  luhnValid,
+  nextHoliday,
+  normalizeIban,
+  parseAddress,
+  parseDate,
+  supportedIbanCountries,
+  validateAadhaar,
+  validateAba,
+  validateBtcAddress,
+  validateCard,
+  validateCnpj,
+  validateCpf,
+  validateCusip,
+  validateDni,
+  validateDomain,
+  validateEmail,
+  validateEthAddress,
+  validateIban,
+  validateIp,
+  validateIsbn10,
+  validateIsbn13,
+  validateIsin,
+  validateIssn,
+  validateLei,
+  validateOrcid,
+  validatePhone,
+  validateSaId,
+  validateSedol,
+  validateTld,
+  validateUrl,
+  validateUuid,
+  validateVat,
+  validateVin,
+  vatRate,
+  verhoeffGenerate,
+  verhoeffValid,
+  vinCheckDigit
+};

package/dist/server.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/server.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import {
+  SERVER_INFO,
+  TOOLS
+} from "./chunk-TDQYIG3R.js";
+
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+var server = new McpServer({ name: SERVER_INFO.name, version: SERVER_INFO.version });
+for (const t of TOOLS) {
+  const specArgs = t.args ?? [{ name: t.argName, description: t.argDescription, optional: false }];
+  const shape = {};
+  for (const a of specArgs) {
+    const base = z.string().describe(a.description);
+    shape[a.name] = a.optional ? base.optional() : base;
+  }
+  server.tool(t.name, t.description, shape, async (args) => {
+    const result = t.args ? t.runArgs(args) : t.run(args[t.argName] ?? "");
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  });
+}
+async function main() {
+  await server.connect(new StdioServerTransport());
+}
+main().catch((err) => {
+  console.error("qiniso MCP server failed to start:", err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@qinisolabs/qiniso",
+  "version": "0.1.0",
+  "mcpName": "io.github.qinisolabs/qiniso",
+  "description": "The deterministic fact-verification layer for AI agents — verify identifiers, locale and more against authoritative ground truth.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "qiniso-mcp": "dist/server.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "start": "node dist/server.js",
+    "start:http": "node dist/http.js",
+    "test": "tsx test/smoke.test.ts"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "agents",
+    "verification",
+    "validation",
+    "deterministic"
+  ],
+  "license": "Apache-2.0",
+  "author": "Qiniso",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.0",
+    "@noble/hashes": "^1.3.3",
+    "@scure/base": "^1.1.6",
+    "date-holidays": "^3.23.0",
+    "jsvat-next": "^2.5.0",
+    "libphonenumber-js": "^1.11.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@qiniso/academic": "*",
+    "@qiniso/crypto": "*",
+    "@qiniso/finance": "*",
+    "@qiniso/identifiers": "*",
+    "@qiniso/locale": "*",
+    "@qiniso/national-id": "*",
+    "@qiniso/network": "*",
+    "@qiniso/vat": "*",
+    "tsup": "^8.3.0"
+  }
+}