barcodefyi 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,88 @@
+# barcodefyi
+
+[![npm](https://img.shields.io/npm/v/barcodefyi)](https://www.npmjs.com/package/barcodefyi)
+[![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/barcodefyi)
+
+TypeScript API client for [BarcodeFYI](https://barcodefyi.com) -- the comprehensive barcode reference covering 50+ symbologies across 1D and 2D families, GS1 standards, encoding components, and industry applications from retail UPC/EAN to healthcare GS1 DataMatrix. Zero dependencies, uses native `fetch`.
+
+> **Explore barcodes at [barcodefyi.com](https://barcodefyi.com)** -- [Symbologies](https://barcodefyi.com/symbologies/) | [Standards](https://barcodefyi.com/standards/) | [Glossary](https://barcodefyi.com/glossary/) | [API Docs](https://barcodefyi.com/developers/)
+
+## Install
+
+```bash
+npm install barcodefyi
+```
+
+Works in Node.js, Deno, Bun, and browsers (ESM).
+
+## Quick Start
+
+```typescript
+import { BarcodeFYI } from "barcodefyi";
+
+const api = new BarcodeFYI();
+
+// Search symbologies, standards, glossary
+const results = await api.search("ean-13");
+
+// Get symbology detail
+const code128 = await api.symbology("code-128");
+console.log(code128.encoding_type); // "Linear"
+console.log(code128.character_set); // "Full ASCII (128 characters)"
+
+// Compare two symbologies
+const comparison = await api.compare("upc-a", "ean-13");
+
+// Get industry applications
+const retail = await api.industry("retail");
+```
+
+## API Methods
+
+| Method | Description |
+|--------|-------------|
+| `search(query)` | Search symbologies, standards, components, glossary |
+| `glossaryTerm(slug)` | Get glossary term definition |
+| `symbology(slug)` | Barcode symbology detail |
+| `family(slug)` | Barcode family detail |
+| `standard(slug)` | Barcode standard detail |
+| `component(slug)` | Barcode component detail |
+| `industry(slug)` | Industry application detail |
+| `compare(slugA, slugB)` | Compare two symbologies |
+| `random()` | Random barcode symbology |
+| `openapi()` | OpenAPI 3.1.0 specification |
+
+## TypeScript Types
+
+```typescript
+import type {
+  SearchResult, SymbologyDetail, FamilyDetail, StandardDetail,
+  ComponentDetail, GlossaryTerm, CompareResult, IndustryDetail,
+} from "barcodefyi";
+```
+
+## Also Available
+
+| Language | Package |
+|----------|---------|
+| Python | [barcodefyi on PyPI](https://pypi.org/project/barcodefyi/) |
+| 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,89 @@
+"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, {
+  BarcodeFYI: () => BarcodeFYI
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var BarcodeFYI = class {
+  baseUrl;
+  constructor(baseUrl = "https://barcodefyi.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 symbologies, standards, components, 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 barcode symbology detail by slug. */
+  async symbology(slug) {
+    return this.get(`/api/symbology/${slug}/`);
+  }
+  /** Get barcode family detail by slug. */
+  async family(slug) {
+    return this.get(`/api/family/${slug}/`);
+  }
+  /** Get barcode standard detail by slug. */
+  async standard(slug) {
+    return this.get(`/api/standard/${slug}/`);
+  }
+  /** Get barcode component detail by slug. */
+  async component(slug) {
+    return this.get(`/api/component/${slug}/`);
+  }
+  /** Get industry application detail by slug. */
+  async industry(slug) {
+    return this.get(`/api/industry/${slug}/`);
+  }
+  /** Compare two barcode symbologies. */
+  async compare(slugA, slugB) {
+    return this.get("/api/compare/", {
+      a: slugA,
+      b: slugB
+    });
+  }
+  /** Get a random barcode symbology. */
+  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 = {
+  BarcodeFYI
+});

package/dist/index.d.cts

@@ -0,0 +1,109 @@
+/**
+ * BarcodeFYI 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 SymbologyDetail {
+    slug: string;
+    name: string;
+    description: string;
+    family?: string;
+    encoding_type?: string;
+    character_set?: string;
+    max_data_length?: number;
+    check_digit?: boolean;
+    url: string;
+}
+interface FamilyDetail {
+    slug: string;
+    name: string;
+    description: string;
+    symbologies?: string[];
+    url: string;
+}
+interface StandardDetail {
+    slug: string;
+    name: string;
+    description: string;
+    organization?: string;
+    year?: number;
+    url: string;
+}
+interface ComponentDetail {
+    slug: string;
+    name: string;
+    description: string;
+    url: string;
+}
+interface IndustryDetail {
+    slug: string;
+    name: string;
+    description: string;
+    symbologies?: 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;
+}
+
+/**
+ * BarcodeFYI API client -- TypeScript wrapper for barcodefyi.com REST API.
+ *
+ * Zero dependencies. Uses native `fetch`.
+ */
+
+declare class BarcodeFYI {
+    private baseUrl;
+    constructor(baseUrl?: string);
+    private get;
+    /** Search symbologies, standards, components, and glossary terms. */
+    search(query: string): Promise<SearchResult>;
+    /** Get a glossary term by slug. */
+    glossaryTerm(slug: string): Promise<GlossaryTerm>;
+    /** Get barcode symbology detail by slug. */
+    symbology(slug: string): Promise<SymbologyDetail>;
+    /** Get barcode family detail by slug. */
+    family(slug: string): Promise<FamilyDetail>;
+    /** Get barcode standard detail by slug. */
+    standard(slug: string): Promise<StandardDetail>;
+    /** Get barcode component detail by slug. */
+    component(slug: string): Promise<ComponentDetail>;
+    /** Get industry application detail by slug. */
+    industry(slug: string): Promise<IndustryDetail>;
+    /** Compare two barcode symbologies. */
+    compare(slugA: string, slugB: string): Promise<CompareResult>;
+    /** Get a random barcode symbology. */
+    random(): Promise<RandomResult>;
+    /** Get the OpenAPI 3.1.0 specification. */
+    openapi(): Promise<Record<string, unknown>>;
+}
+
+export { BarcodeFYI, type CompareResult, type ComponentDetail, type FamilyDetail, type GlossaryTerm, type IndustryDetail, type RandomResult, type SearchResult, type StandardDetail, type SymbologyDetail };

package/dist/index.d.ts

@@ -0,0 +1,109 @@
+/**
+ * BarcodeFYI 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 SymbologyDetail {
+    slug: string;
+    name: string;
+    description: string;
+    family?: string;
+    encoding_type?: string;
+    character_set?: string;
+    max_data_length?: number;
+    check_digit?: boolean;
+    url: string;
+}
+interface FamilyDetail {
+    slug: string;
+    name: string;
+    description: string;
+    symbologies?: string[];
+    url: string;
+}
+interface StandardDetail {
+    slug: string;
+    name: string;
+    description: string;
+    organization?: string;
+    year?: number;
+    url: string;
+}
+interface ComponentDetail {
+    slug: string;
+    name: string;
+    description: string;
+    url: string;
+}
+interface IndustryDetail {
+    slug: string;
+    name: string;
+    description: string;
+    symbologies?: 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;
+}
+
+/**
+ * BarcodeFYI API client -- TypeScript wrapper for barcodefyi.com REST API.
+ *
+ * Zero dependencies. Uses native `fetch`.
+ */
+
+declare class BarcodeFYI {
+    private baseUrl;
+    constructor(baseUrl?: string);
+    private get;
+    /** Search symbologies, standards, components, and glossary terms. */
+    search(query: string): Promise<SearchResult>;
+    /** Get a glossary term by slug. */
+    glossaryTerm(slug: string): Promise<GlossaryTerm>;
+    /** Get barcode symbology detail by slug. */
+    symbology(slug: string): Promise<SymbologyDetail>;
+    /** Get barcode family detail by slug. */
+    family(slug: string): Promise<FamilyDetail>;
+    /** Get barcode standard detail by slug. */
+    standard(slug: string): Promise<StandardDetail>;
+    /** Get barcode component detail by slug. */
+    component(slug: string): Promise<ComponentDetail>;
+    /** Get industry application detail by slug. */
+    industry(slug: string): Promise<IndustryDetail>;
+    /** Compare two barcode symbologies. */
+    compare(slugA: string, slugB: string): Promise<CompareResult>;
+    /** Get a random barcode symbology. */
+    random(): Promise<RandomResult>;
+    /** Get the OpenAPI 3.1.0 specification. */
+    openapi(): Promise<Record<string, unknown>>;
+}
+
+export { BarcodeFYI, type CompareResult, type ComponentDetail, type FamilyDetail, type GlossaryTerm, type IndustryDetail, type RandomResult, type SearchResult, type StandardDetail, type SymbologyDetail };

package/dist/index.js

@@ -0,0 +1,62 @@
+// src/client.ts
+var BarcodeFYI = class {
+  baseUrl;
+  constructor(baseUrl = "https://barcodefyi.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 symbologies, standards, components, 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 barcode symbology detail by slug. */
+  async symbology(slug) {
+    return this.get(`/api/symbology/${slug}/`);
+  }
+  /** Get barcode family detail by slug. */
+  async family(slug) {
+    return this.get(`/api/family/${slug}/`);
+  }
+  /** Get barcode standard detail by slug. */
+  async standard(slug) {
+    return this.get(`/api/standard/${slug}/`);
+  }
+  /** Get barcode component detail by slug. */
+  async component(slug) {
+    return this.get(`/api/component/${slug}/`);
+  }
+  /** Get industry application detail by slug. */
+  async industry(slug) {
+    return this.get(`/api/industry/${slug}/`);
+  }
+  /** Compare two barcode symbologies. */
+  async compare(slugA, slugB) {
+    return this.get("/api/compare/", {
+      a: slugA,
+      b: slugB
+    });
+  }
+  /** Get a random barcode symbology. */
+  async random() {
+    return this.get("/api/random/");
+  }
+  /** Get the OpenAPI 3.1.0 specification. */
+  async openapi() {
+    return this.get("/api/openapi.json");
+  }
+};
+export {
+  BarcodeFYI
+};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "barcodefyi",
+  "version": "0.1.0",
+  "description": "TypeScript API client for BarcodeFYI -- barcode symbologies, standards, components, and industry applications. 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": [
+    "barcode",
+    "upc",
+    "ean",
+    "isbn",
+    "code-128",
+    "gs1",
+    "symbology",
+    "api-client",
+    "barcodefyi"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fyipedia/barcodefyi-js"
+  },
+  "homepage": "https://barcodefyi.com",
+  "license": "MIT",
+  "author": "FYIPedia",
+  "devDependencies": {
+    "tsup": "^8.0",
+    "typescript": "^5.7",
+    "vitest": "^3.0"
+  }
+}