qrcodefyi 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FYIPedia
+
+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,89 @@
+# qrcodefyi
+
+[![npm](https://img.shields.io/npm/v/qrcodefyi)](https://www.npmjs.com/package/qrcodefyi)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Zero Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](https://www.npmjs.com/package/qrcodefyi)
+
+TypeScript API client for [QRCodeFYI](https://qrcodefyi.com) -- the comprehensive QR code reference covering QR code types (Model 1, Model 2, Micro QR, rMQR), 40 versions, 4 encoding modes, 4 error correction levels, ISO/IEC 18004 standards, and real-world use cases. Zero dependencies, uses native `fetch`.
+
+> **Explore QR codes at [qrcodefyi.com](https://qrcodefyi.com)** -- [Types](https://qrcodefyi.com/types/) | [Versions](https://qrcodefyi.com/versions/) | [Glossary](https://qrcodefyi.com/glossary/) | [API Docs](https://qrcodefyi.com/developers/)
+
+## Install
+
+```bash
+npm install qrcodefyi
+```
+
+Works in Node.js, Deno, Bun, and browsers (ESM).
+
+## Quick Start
+
+```typescript
+import { QRCodeFYI } from "qrcodefyi";
+
+const api = new QRCodeFYI();
+
+// Search QR code types, versions, encodings
+const results = await api.search("micro qr");
+
+// Get QR code type detail
+const model2 = await api.qrType("model-2");
+console.log(model2.error_correction_levels); // ["L", "M", "Q", "H"]
+
+// Get version detail with data capacities
+const v10 = await api.version(10);
+console.log(v10.numeric_capacity);
+
+// Compare two QR code types
+const comparison = await api.compare("model-2", "micro-qr");
+```
+
+## API Methods
+
+| Method | Description |
+|--------|-------------|
+| `search(query)` | Search types, versions, encodings, glossary |
+| `glossaryTerm(slug)` | Get glossary term definition |
+| `qrType(slug)` | QR code type detail |
+| `version(version)` | QR code version detail by number |
+| `component(slug)` | QR code component detail |
+| `encoding(slug)` | Encoding mode detail |
+| `standard(slug)` | Standard detail |
+| `useCase(slug)` | Use case detail |
+| `compare(slugA, slugB)` | Compare two QR code types |
+| `random()` | Random QR code type |
+| `openapi()` | OpenAPI 3.1.0 specification |
+
+## TypeScript Types
+
+```typescript
+import type {
+  SearchResult, QRTypeDetail, VersionDetail, ComponentDetail,
+  EncodingDetail, StandardDetail, UseCaseDetail, GlossaryTerm, CompareResult,
+} from "qrcodefyi";
+```
+
+## Also Available
+
+| Language | Package |
+|----------|---------|
+| Python | [qrcodefyi on PyPI](https://pypi.org/project/qrcodefyi/) |
+| TypeScript | **This package** |
+
+## Code FYI Family
+
+Part of the [FYIPedia](https://fyipedia.com) open-source developer tools ecosystem -- automatic identification and data capture technologies.
+
+| Package | npm | Description |
+|---------|-----|-------------|
+| barcodefyi | [npm](https://www.npmjs.com/package/barcodefyi) | Barcode symbologies, standards -- [barcodefyi.com](https://barcodefyi.com/) |
+| **qrcodefyi** | [npm](https://www.npmjs.com/package/qrcodefyi) | **QR code types, versions, encoding -- [qrcodefyi.com](https://qrcodefyi.com/)** |
+| nfcfyi | [npm](https://www.npmjs.com/package/nfcfyi) | NFC chips, NDEF, standards -- [nfcfyi.com](https://nfcfyi.com/) |
+| blefyi | [npm](https://www.npmjs.com/package/blefyi) | BLE profiles, beacons, chips -- [blefyi.com](https://blefyi.com/) |
+| rfidfyi | [npm](https://www.npmjs.com/package/rfidfyi) | RFID tags, readers, frequencies -- [rfidfyi.com](https://rfidfyi.com/) |
+| smartcardfyi | [npm](https://www.npmjs.com/package/smartcardfyi) | Smart cards, EMV, platforms -- [smartcardfyi.com](https://smartcardfyi.com/) |
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,93 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  QRCodeFYI: () => QRCodeFYI
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var QRCodeFYI = class {
+  baseUrl;
+  constructor(baseUrl = "https://qrcodefyi.com") {
+    this.baseUrl = baseUrl.replace(/\/+$/, "");
+  }
+  async get(path, params) {
+    const url = new URL(path, this.baseUrl);
+    if (params) {
+      Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
+    }
+    const res = await fetch(url.toString());
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    return res.json();
+  }
+  /** Search QR code types, versions, encodings, and glossary terms. */
+  async search(query) {
+    return this.get("/api/search/", { q: query });
+  }
+  /** Get a glossary term by slug. */
+  async glossaryTerm(slug) {
+    return this.get(`/api/term/${slug}/`);
+  }
+  /** Get QR code type detail by slug. */
+  async qrType(slug) {
+    return this.get(`/api/type/${slug}/`);
+  }
+  /** Get QR code version detail by version number. */
+  async version(version) {
+    return this.get(`/api/version/${version}/`);
+  }
+  /** Get QR code component detail by slug. */
+  async component(slug) {
+    return this.get(`/api/component/${slug}/`);
+  }
+  /** Get encoding mode detail by slug. */
+  async encoding(slug) {
+    return this.get(`/api/encoding/${slug}/`);
+  }
+  /** Get QR code standard detail by slug. */
+  async standard(slug) {
+    return this.get(`/api/standard/${slug}/`);
+  }
+  /** Get use case detail by slug. */
+  async useCase(slug) {
+    return this.get(`/api/use-case/${slug}/`);
+  }
+  /** Compare two QR code types. */
+  async compare(slugA, slugB) {
+    return this.get("/api/compare/", {
+      a: slugA,
+      b: slugB
+    });
+  }
+  /** Get a random QR code type. */
+  async random() {
+    return this.get("/api/random/");
+  }
+  /** Get the OpenAPI 3.1.0 specification. */
+  async openapi() {
+    return this.get("/api/openapi.json");
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  QRCodeFYI
+});

package/dist/index.d.cts

@@ -0,0 +1,118 @@
+/**
+ * QRCodeFYI API response types.
+ */
+interface SearchResult {
+    results: Array<{
+        name: string;
+        slug: string;
+        type: string;
+        url: string;
+    }>;
+    query: string;
+    total: number;
+}
+interface GlossaryTerm {
+    name: string;
+    slug: string;
+    definition: string;
+    related_terms?: string[];
+}
+interface QRTypeDetail {
+    slug: string;
+    name: string;
+    description: string;
+    max_data_capacity?: string;
+    error_correction_levels?: string[];
+    url: string;
+}
+interface VersionDetail {
+    version: number;
+    modules: number;
+    description: string;
+    numeric_capacity?: number;
+    alphanumeric_capacity?: number;
+    byte_capacity?: number;
+    url: string;
+}
+interface ComponentDetail {
+    slug: string;
+    name: string;
+    description: string;
+    url: string;
+}
+interface EncodingDetail {
+    slug: string;
+    name: string;
+    description: string;
+    character_set?: string;
+    bits_per_character?: number;
+    url: string;
+}
+interface StandardDetail {
+    slug: string;
+    name: string;
+    description: string;
+    organization?: string;
+    year?: number;
+    url: string;
+}
+interface UseCaseDetail {
+    slug: string;
+    name: string;
+    description: string;
+    qr_types?: string[];
+    url: string;
+}
+interface CompareResult {
+    item_a: {
+        name: string;
+        slug: string;
+    };
+    item_b: {
+        name: string;
+        slug: string;
+    };
+    comparison: Record<string, unknown>;
+}
+interface RandomResult {
+    slug: string;
+    name: string;
+    type: string;
+    url: string;
+}
+
+/**
+ * QRCodeFYI API client -- TypeScript wrapper for qrcodefyi.com REST API.
+ *
+ * Zero dependencies. Uses native `fetch`.
+ */
+
+declare class QRCodeFYI {
+    private baseUrl;
+    constructor(baseUrl?: string);
+    private get;
+    /** Search QR code types, versions, encodings, and glossary terms. */
+    search(query: string): Promise<SearchResult>;
+    /** Get a glossary term by slug. */
+    glossaryTerm(slug: string): Promise<GlossaryTerm>;
+    /** Get QR code type detail by slug. */
+    qrType(slug: string): Promise<QRTypeDetail>;
+    /** Get QR code version detail by version number. */
+    version(version: number): Promise<VersionDetail>;
+    /** Get QR code component detail by slug. */
+    component(slug: string): Promise<ComponentDetail>;
+    /** Get encoding mode detail by slug. */
+    encoding(slug: string): Promise<EncodingDetail>;
+    /** Get QR code standard detail by slug. */
+    standard(slug: string): Promise<StandardDetail>;
+    /** Get use case detail by slug. */
+    useCase(slug: string): Promise<UseCaseDetail>;
+    /** Compare two QR code types. */
+    compare(slugA: string, slugB: string): Promise<CompareResult>;
+    /** Get a random QR code type. */
+    random(): Promise<RandomResult>;
+    /** Get the OpenAPI 3.1.0 specification. */
+    openapi(): Promise<Record<string, unknown>>;
+}
+
+export { type CompareResult, type ComponentDetail, type EncodingDetail, type GlossaryTerm, QRCodeFYI, type QRTypeDetail, type RandomResult, type SearchResult, type StandardDetail, type UseCaseDetail, type VersionDetail };

package/dist/index.d.ts

@@ -0,0 +1,118 @@
+/**
+ * QRCodeFYI API response types.
+ */
+interface SearchResult {
+    results: Array<{
+        name: string;
+        slug: string;
+        type: string;
+        url: string;
+    }>;
+    query: string;
+    total: number;
+}
+interface GlossaryTerm {
+    name: string;
+    slug: string;
+    definition: string;
+    related_terms?: string[];
+}
+interface QRTypeDetail {
+    slug: string;
+    name: string;
+    description: string;
+    max_data_capacity?: string;
+    error_correction_levels?: string[];
+    url: string;
+}
+interface VersionDetail {
+    version: number;
+    modules: number;
+    description: string;
+    numeric_capacity?: number;
+    alphanumeric_capacity?: number;
+    byte_capacity?: number;
+    url: string;
+}
+interface ComponentDetail {
+    slug: string;
+    name: string;
+    description: string;
+    url: string;
+}
+interface EncodingDetail {
+    slug: string;
+    name: string;
+    description: string;
+    character_set?: string;
+    bits_per_character?: number;
+    url: string;
+}
+interface StandardDetail {
+    slug: string;
+    name: string;
+    description: string;
+    organization?: string;
+    year?: number;
+    url: string;
+}
+interface UseCaseDetail {
+    slug: string;
+    name: string;
+    description: string;
+    qr_types?: string[];
+    url: string;
+}
+interface CompareResult {
+    item_a: {
+        name: string;
+        slug: string;
+    };
+    item_b: {
+        name: string;
+        slug: string;
+    };
+    comparison: Record<string, unknown>;
+}
+interface RandomResult {
+    slug: string;
+    name: string;
+    type: string;
+    url: string;
+}
+
+/**
+ * QRCodeFYI API client -- TypeScript wrapper for qrcodefyi.com REST API.
+ *
+ * Zero dependencies. Uses native `fetch`.
+ */
+
+declare class QRCodeFYI {
+    private baseUrl;
+    constructor(baseUrl?: string);
+    private get;
+    /** Search QR code types, versions, encodings, and glossary terms. */
+    search(query: string): Promise<SearchResult>;
+    /** Get a glossary term by slug. */
+    glossaryTerm(slug: string): Promise<GlossaryTerm>;
+    /** Get QR code type detail by slug. */
+    qrType(slug: string): Promise<QRTypeDetail>;
+    /** Get QR code version detail by version number. */
+    version(version: number): Promise<VersionDetail>;
+    /** Get QR code component detail by slug. */
+    component(slug: string): Promise<ComponentDetail>;
+    /** Get encoding mode detail by slug. */
+    encoding(slug: string): Promise<EncodingDetail>;
+    /** Get QR code standard detail by slug. */
+    standard(slug: string): Promise<StandardDetail>;
+    /** Get use case detail by slug. */
+    useCase(slug: string): Promise<UseCaseDetail>;
+    /** Compare two QR code types. */
+    compare(slugA: string, slugB: string): Promise<CompareResult>;
+    /** Get a random QR code type. */
+    random(): Promise<RandomResult>;
+    /** Get the OpenAPI 3.1.0 specification. */
+    openapi(): Promise<Record<string, unknown>>;
+}
+
+export { type CompareResult, type ComponentDetail, type EncodingDetail, type GlossaryTerm, QRCodeFYI, type QRTypeDetail, type RandomResult, type SearchResult, type StandardDetail, type UseCaseDetail, type VersionDetail };

package/dist/index.js

@@ -0,0 +1,66 @@
+// src/client.ts
+var QRCodeFYI = class {
+  baseUrl;
+  constructor(baseUrl = "https://qrcodefyi.com") {
+    this.baseUrl = baseUrl.replace(/\/+$/, "");
+  }
+  async get(path, params) {
+    const url = new URL(path, this.baseUrl);
+    if (params) {
+      Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
+    }
+    const res = await fetch(url.toString());
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    return res.json();
+  }
+  /** Search QR code types, versions, encodings, and glossary terms. */
+  async search(query) {
+    return this.get("/api/search/", { q: query });
+  }
+  /** Get a glossary term by slug. */
+  async glossaryTerm(slug) {
+    return this.get(`/api/term/${slug}/`);
+  }
+  /** Get QR code type detail by slug. */
+  async qrType(slug) {
+    return this.get(`/api/type/${slug}/`);
+  }
+  /** Get QR code version detail by version number. */
+  async version(version) {
+    return this.get(`/api/version/${version}/`);
+  }
+  /** Get QR code component detail by slug. */
+  async component(slug) {
+    return this.get(`/api/component/${slug}/`);
+  }
+  /** Get encoding mode detail by slug. */
+  async encoding(slug) {
+    return this.get(`/api/encoding/${slug}/`);
+  }
+  /** Get QR code standard detail by slug. */
+  async standard(slug) {
+    return this.get(`/api/standard/${slug}/`);
+  }
+  /** Get use case detail by slug. */
+  async useCase(slug) {
+    return this.get(`/api/use-case/${slug}/`);
+  }
+  /** Compare two QR code types. */
+  async compare(slugA, slugB) {
+    return this.get("/api/compare/", {
+      a: slugA,
+      b: slugB
+    });
+  }
+  /** Get a random QR code type. */
+  async random() {
+    return this.get("/api/random/");
+  }
+  /** Get the OpenAPI 3.1.0 specification. */
+  async openapi() {
+    return this.get("/api/openapi.json");
+  }
+};
+export {
+  QRCodeFYI
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "qrcodefyi",
+  "version": "0.1.0",
+  "description": "TypeScript API client for QRCodeFYI -- QR code types, versions, encoding modes, error correction, and standards. Zero dependencies.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "qr-code",
+    "qr",
+    "encoding",
+    "error-correction",
+    "api-client",
+    "qrcodefyi"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fyipedia/qrcodefyi-js"
+  },
+  "homepage": "https://qrcodefyi.com",
+  "license": "MIT",
+  "author": "FYIPedia",
+  "devDependencies": {
+    "tsup": "^8.0",
+    "typescript": "^5.7",
+    "vitest": "^3.0"
+  }
+}