visura-parser 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,180 @@
+/** Primary representative or senior officer displayed in the report summary, when present. */
+export interface Representative {
+    /** Name of the person as reported in the source document. */
+    name?: string;
+    /** Official role as reported in the source document, e.g. 'PRESIDENTE CONSIGLIO AMMINISTRAZIONE', 'AMMINISTRATORE UNICO' or 'AMMINISTRATORE DELEGATO'. */
+    role?: string;
+}
+/** Structured registry data. */
+export interface AtecoClassification {
+    /** ATECO or ATECORI classification code. */
+    code?: string;
+    /** Official activity description associated with the classification code. */
+    description?: string;
+    /** Official classification qualifier as reported in the source document, when available, e.g. 'prevalente' or 'primaria'. */
+    importance?: string;
+}
+/** Information about the entity's registered business activities. */
+export interface Activity {
+    /** Official activity status as reported by the Business Register, e.g. 'ATTIVA', 'INATTIVA', 'SOSPESA' or 'CESSATA'. */
+    status?: string;
+    /** Date on which the registered business activity started. */
+    startDate?: string;
+    /** Official description of the primary or prevailing business activity as reported in the source document. */
+    primaryActivity?: string;
+    /** Primary Italian ATECO classification code associated with the registered activity. */
+    atecoCode?: string;
+    /** European NACE classification code associated with the registered activity, when reported. */
+    naceCode?: string;
+    /** ATECO or ATECORI classifications reported for the entity. */
+    atecoClassifications?: AtecoClassification[];
+    /** Official information concerning import or export activity as reported in the source document. */
+    importExportActivity?: string;
+    /** Official information concerning participation in a business network agreement (contratto di rete). */
+    networkContract?: string;
+    /** Professional registers, rolls, licences, authorisations or similar registrations reported for the entity. */
+    licensesAndRegistrations?: string[];
+    /** Environmental registers or environmental professional rolls in which the entity is registered. */
+    environmentalRegistrations?: string[];
+}
+/** Registered share capital information. */
+export interface ShareCapital {
+    /** Currency used for share capital amounts, usually 'EUR'. */
+    currency?: string;
+    /** Share capital formally resolved or approved by the shareholders (capitale deliberato). */
+    authorized?: number;
+    /** Share capital formally subscribed by shareholders or members (capitale sottoscritto). */
+    subscribed?: number;
+    /** Subscribed share capital that has actually been paid or contributed (capitale versato). */
+    paidUp?: number;
+}
+/** Employee information reported in the business registry. */
+export interface Employees {
+    /** Number of employees or workers reported for the entity. */
+    count?: number;
+    /** Reference date associated with the employee count. */
+    referenceDate?: string;
+}
+/** Summary figures typically reported in the 'L'impresa in cifre' section. */
+export interface CompanySummary {
+    /** Number of shareholders or members reported for the entity. */
+    shareholdersCount?: number;
+    /** Number of directors or administrators reported for the entity. */
+    directorsCount?: number;
+    /** Number of persons holding registered corporate offices or appointments. */
+    officeHoldersCount?: number;
+    /** Number of registered local business units. */
+    localUnitsCount?: number;
+    /** Number of filings submitted to the Business Register during the previous twelve months. */
+    filingsLast12Months?: number;
+    /** Number of registered transfers of shares or ownership interests. */
+    shareTransfersCount?: number;
+    /** Number of registered transfers of the entity's registered office. */
+    registeredOfficeTransfersCount?: number;
+    /** Whether the entity is reported as holding equity interests or participations in other entities. */
+    hasEquityInterests?: boolean;
+}
+/** Summary of filings recorded in the Italian Business Register. */
+export interface BusinessRegisterFilings {
+    /** Number of Business Register filings reported for the indicated period. */
+    count?: number;
+    /** Start date of the period used for the reported filing count, when specified. */
+    sinceDate?: string;
+}
+/** Qualifications and certifications reported for the entity. */
+export interface Certifications {
+    /** SOA qualifications or certifications reported for the entity. */
+    soa?: string[];
+    /** Quality-related certifications reported for the entity. */
+    quality?: string[];
+}
+/** Documents reported as available for consultation from the Business Register. */
+export interface AvailableDocuments {
+    /** Whether the company registry file (fascicolo) is available for consultation. */
+    companyFileAvailable?: boolean;
+    /** Whether the current articles of association or statute (statuto) are available for consultation. */
+    articlesOfAssociationAvailable?: boolean;
+    /** Number of other registered corporate acts available for consultation. */
+    otherActsCount?: number;
+    /** Financial years for which filed annual financial statements are available. */
+    financialStatementYears?: number[];
+}
+/** Structured registry data. */
+export interface Officer {
+    /** Name of the person as reported in the source document. */
+    name?: string;
+    /** Italian tax identification code of the person, when reported. */
+    taxCode?: string;
+    /** Official corporate roles held by the person, preserved as reported in the source document. */
+    roles?: string[];
+}
+/** Structured registry data. */
+export interface Shareholder {
+    /** Name or registered name of the shareholder or member. */
+    name?: string;
+    /** Italian tax identification code of the shareholder or member, when reported. */
+    taxCode?: string;
+    /** Official type of right over the shares or ownership interest as reported in the source document, e.g. 'PROPRIETA'', 'USUFRUTTO' or 'NUDA PROPRIETA''. */
+    rightType?: string;
+    /** Nominal value of the shares, quotas or ownership interest held. */
+    nominalValue?: number;
+    /** Currency used for the nominal value, usually 'EUR'. */
+    currency?: string;
+    /** Percentage of the entity's share capital or ownership interest represented by the holding, when determinable. */
+    ownershipPercentage?: number;
+    /** Whether the person or entity is identified as the sole shareholder or sole member. */
+    isSoleShareholder?: boolean;
+}
+/** Structured data extracted from an Italian Chamber of Commerce business registry report (visura camerale). Property names are normalized in English, while official registry values and source terminology are preserved in Italian where appropriate. */
+export interface VisuraDocument {
+    /** Name of the source document. */
+    filename?: string;
+    /** Official type of business registry report as stated in the source document, e.g. 'Visura Ordinaria', 'Visura Storica' or 'Visura di Evasione'. */
+    reportType?: string;
+    /** Registered legal name or business name of the entity. */
+    companyName?: string;
+    /** Registered office address as reported in the business registry. */
+    registeredOfficeAddress?: string;
+    /** Registered certified electronic mail address (PEC) of the entity. */
+    certifiedEmail?: string;
+    /** REA registration number assigned by the competent Chamber of Commerce. */
+    reaNumber?: string;
+    /** Italian tax identification code (codice fiscale) of the entity. */
+    taxCode?: string;
+    /** Italian VAT identification number (partita IVA) of the entity. */
+    vatNumber?: string;
+    /** Legal Entity Identifier (LEI), when available. */
+    leiCode?: string;
+    /** Official legal form as reported in the source document, e.g. 'SOCIETA' A RESPONSABILITA' LIMITATA'. */
+    legalForm?: string;
+    /** Date of the deed of incorporation or establishment of the entity. */
+    incorporationDate?: string;
+    /** Date on which the entity was registered with the Italian Business Register (Registro delle Imprese). */
+    registrationDate?: string;
+    /** Date of the most recent protocol or filing recorded in the Business Register. */
+    lastProtocolDate?: string;
+    /** Primary representative or senior officer displayed in the report summary, when present. */
+    primaryRepresentative?: Representative;
+    /** Information about the entity's registered business activities. */
+    activity?: Activity;
+    /** Registered share capital information. */
+    shareCapital?: ShareCapital;
+    /** Employee information reported in the business registry. */
+    employees?: Employees;
+    /** Summary figures typically reported in the 'L'impresa in cifre' section. */
+    companySummary?: CompanySummary;
+    /** Summary of filings recorded in the Italian Business Register. */
+    businessRegisterFilings?: BusinessRegisterFilings;
+    /** Qualifications and certifications reported for the entity. */
+    certifications?: Certifications;
+    /** Documents reported as available for consultation from the Business Register. */
+    availableDocuments?: AvailableDocuments;
+    /** Persons holding registered corporate offices, governance roles or control functions. */
+    officers?: Officer[];
+    /** Persons or entities holding shares, quotas or membership interests in the entity. */
+    shareholders?: Shareholder[];
+}
+export interface ParseVisuraOptions {
+    filename?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "visura-parser",
+  "version": "0.1.0",
+  "description": "Deterministic parsing of text-based Italian Visura camerale PDFs",
+  "keywords": [
+    "camera-di-commercio",
+    "italy",
+    "pdf",
+    "parser",
+    "typescript",
+    "visura-camerale"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LorenzoYeKai/visura-parser.git"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "packageManager": "bun@1.3.12",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "changeset": "changeset",
+    "check": "bun run lint && bun run format:check && bun run typecheck && bun run test && bun run build && bun run package:check",
+    "corpus:check": "bun run scripts/check-corpus.ts",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint .",
+    "package:check": "publint && attw --pack . --profile esm-only",
+    "parse": "bun run scripts/parse.ts",
+    "prepublishOnly": "bun run check",
+    "release": "changeset publish",
+    "runtime:check": "node scripts/check-node-runtime.mjs",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@changesets/cli": "^3.0.1",
+    "@eslint/js": "^10.0.1",
+    "@vitest/coverage-v8": "^5.0.0",
+    "ajv": "8.17.1",
+    "ajv-formats": "3.0.1",
+    "eslint": "^10.9.1",
+    "prettier": "^3.9.6",
+    "publint": "^0.3.24",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.69.0",
+    "vitest": "^5.0.0"
+  },
+  "dependencies": {
+    "pdfjs-dist": "4.10.38"
+  }
+}