@isvalid-dev/sdk 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -205,10 +205,32 @@ type MacResponse = {
     isLocal: boolean;
     isBroadcast: boolean;
 };
+type NetPortResponse = {
+    valid: false;
+} | {
+    valid: true;
+    port: number;
+    range: string;
+    wellKnown: boolean;
+    serviceName: string | null;
+    protocol: string | null;
+    description: string | null;
+};
+type NetPortListItem = {
+    port: number;
+    serviceName: string;
+    protocol: string;
+    description: string;
+};
 
+interface NetPortNamespace {
+    (value: string): Promise<NetPortResponse>;
+    list(): Promise<NetPortListItem[]>;
+}
 interface NetNamespace {
     ip(value: string): Promise<IpResponse>;
     mac(value: string): Promise<MacResponse>;
+    port: NetPortNamespace;
 }
 
 type PeselResponse = {
@@ -368,6 +390,245 @@ interface GbNamespace {
     sortCode(value: string): Promise<SortCodeResponse>;
 }
 
+type HsCodeResponse = {
+    valid: false;
+    code?: string;
+    level?: string;
+    error?: string;
+} | {
+    valid: true;
+    code: string;
+    level: string;
+    description: string;
+    formatted: string;
+    chapter?: {
+        code: string;
+        description: string;
+    } | null;
+    heading?: {
+        code: string;
+        description: string;
+    } | null;
+};
+interface HsCodeListItem {
+    code: string;
+    level: string;
+    description: string;
+}
+type HsCodeListResponse = HsCodeListItem[];
+
+interface HsCodeNamespace {
+    (value: string): Promise<HsCodeResponse>;
+    list(opts?: {
+        chapter?: string;
+        level?: string;
+    }): Promise<HsCodeListResponse>;
+}
+
+type Gs1PrefixResponse = {
+    valid: false;
+    prefix?: string;
+    error?: string;
+} | {
+    valid: true;
+    prefix: string;
+    country: string;
+    inputType?: string;
+};
+interface Gs1PrefixListItem {
+    rangeStart: string;
+    rangeEnd: string;
+    country: string;
+}
+type Gs1PrefixListResponse = Gs1PrefixListItem[];
+
+interface Gs1PrefixNamespace {
+    (value: string): Promise<Gs1PrefixResponse>;
+    list(): Promise<Gs1PrefixListResponse>;
+}
+
+type IndustryResponse = {
+    valid: false;
+    error?: string;
+    suggestedSystem?: string;
+} | {
+    valid: true;
+    system: string;
+    edition: string;
+    code: string;
+    description: string;
+    level: string;
+    parent: string | null;
+    hierarchy: Array<{
+        code: string;
+        description: string;
+    }>;
+};
+interface IndustryListItem {
+    code: string;
+    level: string;
+    parent: string | null;
+    description: string;
+}
+type IndustryListResponse = IndustryListItem[];
+
+interface IndustryNamespace {
+    (value: string, opts?: {
+        system?: string;
+    }): Promise<IndustryResponse>;
+    list(opts: {
+        system: string;
+        level?: string;
+        parent?: string;
+    }): Promise<IndustryListResponse>;
+}
+
+type TimezoneResponse = {
+    valid: false;
+} | {
+    valid: true;
+    timezone: string;
+    region: string | null;
+    utcOffset: string;
+    abbreviation: string | null;
+    isDST: boolean;
+};
+type TimezoneListItem = {
+    timezone: string;
+    region: string | null;
+    utcOffset: string;
+    abbreviation: string | null;
+    isDST: boolean;
+};
+
+interface TimezoneNamespace {
+    (value: string): Promise<TimezoneResponse>;
+    list(opts?: {
+        region?: string;
+    }): Promise<TimezoneListItem[]>;
+}
+
+type MimeTypeResponse = {
+    valid: false;
+    type?: string;
+    subtype?: string;
+} | {
+    valid: true;
+    mime: string;
+    type: string;
+    subtype: string;
+    extensions: string[];
+    compressible: boolean | null;
+    charset: string | null;
+    source: string | null;
+};
+type MimeTypeExtResponse = {
+    valid: false;
+    extension?: string;
+} | {
+    valid: true;
+    extension: string;
+    mimeTypes: Array<{
+        mime: string;
+        type: string;
+        subtype: string;
+        extensions: string[];
+        compressible: boolean | null;
+        charset: string | null;
+        source: string | null;
+    }>;
+};
+type MimeTypeListItem = {
+    mime: string;
+    type: string;
+    subtype: string;
+    extensions: string[];
+};
+
+interface MimeTypeNamespace {
+    (value: string): Promise<MimeTypeResponse>;
+    ext(value: string): Promise<MimeTypeExtResponse>;
+    list(opts?: {
+        type?: string;
+    }): Promise<MimeTypeListItem[]>;
+}
+
+type HttpStatusResponse = {
+    valid: false;
+} | {
+    valid: true;
+    code: number;
+    reasonPhrase: string;
+    category: string;
+};
+type HttpStatusListItem = {
+    code: number;
+    reasonPhrase: string;
+    category: string;
+};
+
+interface HttpStatusNamespace {
+    (value: string): Promise<HttpStatusResponse>;
+    list(): Promise<HttpStatusListItem[]>;
+}
+
+type SwiftMtResponse = {
+    valid: false;
+} | {
+    valid: true;
+    type: string;
+    category: number;
+    group: string;
+    description: string;
+};
+type SwiftMtListItem = {
+    type: string;
+    category: number;
+    group: string;
+    description: string;
+};
+
+interface SwiftMtNamespace {
+    (value: string): Promise<SwiftMtResponse>;
+    list(opts?: {
+        category?: number;
+    }): Promise<SwiftMtListItem[]>;
+}
+
+type LocodeResponse = {
+    valid: false;
+} | {
+    valid: true;
+    locode: string;
+    country: string;
+    location: string;
+    name: string | null;
+    nameAscii: string | null;
+    subdivision: string | null;
+    functions: string[];
+    iata: string | null;
+    coordinates: string | null;
+    found: boolean;
+};
+type LocodeListItem = {
+    locode: string;
+    country: string;
+    location: string;
+    name: string;
+    nameAscii: string;
+    subdivision: string | null;
+    functions: string[];
+    iata: string | null;
+    coordinates: string | null;
+};
+
+interface LocodeNamespace {
+    (value: string): Promise<LocodeResponse>;
+    list(opts: {
+        country: string;
+    }): Promise<LocodeListItem[]>;
+}
+
 type EmailResponse = {
     valid: false;
 } | {
@@ -713,6 +974,132 @@ type CreditCardResponse = {
     valid: true;
     type: string;
 };
+type CasResponse = {
+    valid: false;
+    error?: string;
+} | {
+    valid: true;
+    formatted: string;
+};
+type EoriResponse = {
+    valid: false;
+    countryCode?: string;
+    country?: string;
+    error?: string;
+} | {
+    valid: true;
+    countryCode: string;
+    country: string;
+    identifier: string;
+    formatted: string;
+    ec?: {
+        checked: boolean;
+        valid?: boolean;
+        statusDescr?: string | null;
+        name?: string | null;
+        street?: string | null;
+        postalCode?: string | null;
+        city?: string | null;
+        reason?: string;
+    };
+};
+type OrcidResponse = {
+    valid: false;
+    error?: string;
+} | {
+    valid: true;
+    formatted: string;
+    uri: string;
+    profile?: {
+        found: boolean;
+        givenNames?: string | null;
+        familyName?: string | null;
+        organization?: string | null;
+        reason?: string;
+    };
+};
+type DoiResponse = {
+    valid: false;
+    error?: string;
+} | {
+    valid: true;
+    doi: string;
+    prefix: string;
+    suffix: string;
+    registrantCode: string;
+    registrant?: string;
+    url: string;
+    metadata?: {
+        found: boolean;
+        title?: string | null;
+        authors?: string[] | null;
+        publisher?: string | null;
+        type?: string | null;
+        issued?: unknown;
+        reason?: string;
+    };
+};
+type BarcodeResponse = {
+    valid: false;
+    error?: string;
+} | {
+    valid: true;
+    type: string;
+    data: string;
+    hasCheckDigit?: boolean;
+    checkDigitValid?: boolean | null;
+    encoding?: string;
+    indicator?: string;
+    length?: number;
+};
+type Base64Response = {
+    valid: false;
+    error?: string;
+} | {
+    valid: true;
+    variant: 'standard' | 'url-safe' | 'ambiguous';
+    isPadded: boolean;
+    decodedLength: number;
+};
+type EthAddressResponse = {
+    valid: false;
+} | {
+    valid: true;
+    address: string;
+    isChecksumValid: boolean;
+};
+type CronResponse = {
+    valid: false;
+} | {
+    valid: true;
+    expression: string;
+    fields: number;
+    hasSeconds: boolean;
+    humanReadable: string | null;
+    nextRun: string;
+    nextRuns: string[];
+};
+type DomainResponse = {
+    valid: false;
+} | {
+    valid: true;
+    domain: string;
+    tld: string;
+    sld: string | null;
+    isIDN: boolean;
+    dnsValid: boolean;
+    hasA: boolean;
+    hasAAAA: boolean;
+};
+type RegexResponse = {
+    valid: false;
+    error?: string;
+} | {
+    valid: true;
+    pattern: string;
+    flags: string | null;
+    namedGroups: string[];
+};
 
 declare class IsValidError extends Error {
     readonly status: number;
@@ -754,6 +1141,14 @@ declare class IsValid {
     readonly in: InNamespace;
     readonly us: UsNamespace;
     readonly gb: GbNamespace;
+    readonly hsCode: HsCodeNamespace;
+    readonly gs1Prefix: Gs1PrefixNamespace;
+    readonly industry: IndustryNamespace;
+    readonly timezone: TimezoneNamespace;
+    readonly mimeType: MimeTypeNamespace;
+    readonly httpStatus: HttpStatusNamespace;
+    readonly swiftMt: SwiftMtNamespace;
+    readonly locode: LocodeNamespace;
     constructor(config: IsValidConfig);
     email(value: string, opts?: {
         checkMx?: boolean;
@@ -802,7 +1197,27 @@ declare class IsValid {
     gln(value: string): Promise<GlnResponse>;
     qr(value: string): Promise<QrResponse>;
     creditCard(number: string): Promise<CreditCardResponse>;
+    cas(value: string): Promise<CasResponse>;
+    eori(value: string, opts?: {
+        check?: boolean;
+    }): Promise<EoriResponse>;
+    orcid(value: string, opts?: {
+        lookup?: boolean;
+    }): Promise<OrcidResponse>;
+    doi(value: string, opts?: {
+        lookup?: boolean;
+    }): Promise<DoiResponse>;
+    barcode(value: string, opts?: {
+        type?: string;
+    }): Promise<BarcodeResponse>;
+    base64(value: string): Promise<Base64Response>;
+    ethAddress(value: string): Promise<EthAddressResponse>;
+    cron(value: string): Promise<CronResponse>;
+    domain(value: string): Promise<DomainResponse>;
+    regex(pattern: string, opts?: {
+        flags?: string;
+    }): Promise<RegexResponse>;
 }
 declare function createClient(config: IsValidConfig): IsValid;
 
-export { type AbaResponse, type AbnResponse, type AuNamespace, type BicResponse, type BooleanResponse, type BrNamespace, type BtcAddressResponse, type CfiResponse, type CnpjResponse, type ColorResponse, type ContainerCodeResponse, type CountryListItem, type CountryNamespace, type CountryResponse, type CpfResponse, type CreditCardResponse, type CurrencyListItem, type CurrencyNamespace, type CurrencyResponse, type CusipResponse, type DateResponse, type DtiResponse, type EanResponse, type EmailResponse, type EsNamespace, type GbNamespace, type GlnResponse, type GpsResponse, type GstinResponse, type IataAirlineListItem, type IataAirlineNamespace, type IataAirlineResponse, type IataAirportResponse, type IataFlightResponse, type IataNamespace, type IbanResponse, type ImeiResponse, type InNamespace, type InvalidResponse, type IpResponse, IsValid, IsValidAuthError, type IsValidConfig, IsValidError, IsValidRateLimitError, type IsbnResponse, type IsinResponse, type IssnResponse, type JwtResponse, type KrsAddress, type KrsLookup, type KrsResponse, type LanguageListItem, type LanguageNamespace, type LanguageResponse, type LeiEntity, type LeiLou, type LeiLouItem, type LeiLousResponse, type LeiNamespace, type LeiResponse, type LeiSearchOptions, type LeiSearchResponse, type LeiSearchResult, type MacResponse, type MicResponse, type NetNamespace, type NifResponse, type NpiResponse, type NutsResponse, type PeselResponse, type PhoneResponse, type PlNamespace, type PostalCodeResponse, type QrResponse, type RegonLookup, type RegonResponse, type RetryConfig, type SemverResponse, type SortCodeResponse, type SsccResponse, type UrlResponse, type UsNamespace, type UuidResponse, type VatResponse, type VinResponse, createClient };
+export { type AbaResponse, type AbnResponse, type AuNamespace, type BarcodeResponse, type Base64Response, type BicResponse, type BooleanResponse, type BrNamespace, type BtcAddressResponse, type CasResponse, type CfiResponse, type CnpjResponse, type ColorResponse, type ContainerCodeResponse, type CountryListItem, type CountryNamespace, type CountryResponse, type CpfResponse, type CreditCardResponse, type CronResponse, type CurrencyListItem, type CurrencyNamespace, type CurrencyResponse, type CusipResponse, type DateResponse, type DoiResponse, type DomainResponse, type DtiResponse, type EanResponse, type EmailResponse, type EoriResponse, type EsNamespace, type EthAddressResponse, type GbNamespace, type GlnResponse, type GpsResponse, type Gs1PrefixListItem, type Gs1PrefixListResponse, type Gs1PrefixNamespace, type Gs1PrefixResponse, type GstinResponse, type HsCodeListItem, type HsCodeListResponse, type HsCodeNamespace, type HsCodeResponse, type HttpStatusListItem, type HttpStatusNamespace, type HttpStatusResponse, type IataAirlineListItem, type IataAirlineNamespace, type IataAirlineResponse, type IataAirportResponse, type IataFlightResponse, type IataNamespace, type IbanResponse, type ImeiResponse, type InNamespace, type IndustryListItem, type IndustryListResponse, type IndustryNamespace, type IndustryResponse, type InvalidResponse, type IpResponse, IsValid, IsValidAuthError, type IsValidConfig, IsValidError, IsValidRateLimitError, type IsbnResponse, type IsinResponse, type IssnResponse, type JwtResponse, type KrsAddress, type KrsLookup, type KrsResponse, type LanguageListItem, type LanguageNamespace, type LanguageResponse, type LeiEntity, type LeiLou, type LeiLouItem, type LeiLousResponse, type LeiNamespace, type LeiResponse, type LeiSearchOptions, type LeiSearchResponse, type LeiSearchResult, type LocodeListItem, type LocodeNamespace, type LocodeResponse, type MacResponse, type MicResponse, type MimeTypeExtResponse, type MimeTypeListItem, type MimeTypeNamespace, type MimeTypeResponse, type NetNamespace, type NetPortListItem, type NetPortNamespace, type NetPortResponse, type NifResponse, type NpiResponse, type NutsResponse, type OrcidResponse, type PeselResponse, type PhoneResponse, type PlNamespace, type PostalCodeResponse, type QrResponse, type RegexResponse, type RegonLookup, type RegonResponse, type RetryConfig, type SemverResponse, type SortCodeResponse, type SsccResponse, type SwiftMtListItem, type SwiftMtNamespace, type SwiftMtResponse, type TimezoneListItem, type TimezoneNamespace, type TimezoneResponse, type UrlResponse, type UsNamespace, type UuidResponse, type VatResponse, type VinResponse, createClient };

package/dist/index.js

@@ -68,13 +68,14 @@ var HttpClient = class {
     });
   }
   buildUrl(path, params) {
-    const url = new URL(path, this.baseUrl);
+    let result = this.baseUrl + path;
     if (params) {
-      for (const [k, v] of Object.entries(params)) {
-        if (v !== void 0) url.searchParams.set(k, v);
+      const entries = Object.entries(params).filter((e) => e[1] !== void 0);
+      if (entries.length > 0) {
+        result += "?" + entries.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join("&");
       }
     }
-    return url.toString();
+    return result;
   }
   async request(url, init) {
     const headers = {
@@ -158,9 +159,12 @@ function createIataNamespace(client) {
 
 // src/namespaces/net.ts
 function createNetNamespace(client) {
+  const port = ((value) => client.get("/v0/net/port", { value }));
+  port.list = () => client.get("/v0/net/port/list");
   return {
     ip: (value) => client.get("/v0/net/ip", { value }),
-    mac: (value) => client.get("/v0/net/mac", { value })
+    mac: (value) => client.get("/v0/net/mac", { value }),
+    port
   };
 }
 
@@ -222,6 +226,73 @@ function createGbNamespace(client) {
   };
 }
 
+// src/namespaces/hsCode.ts
+function createHsCodeNamespace(client) {
+  const hsCode = ((value) => client.get("/v0/hs-code", { value }));
+  hsCode.list = (opts) => client.get("/v0/hs-code/list", {
+    chapter: opts?.chapter,
+    level: opts?.level
+  });
+  return hsCode;
+}
+
+// src/namespaces/gs1Prefix.ts
+function createGs1PrefixNamespace(client) {
+  const gs1Prefix = ((value) => client.get("/v0/gs1-prefix", { value }));
+  gs1Prefix.list = () => client.get("/v0/gs1-prefix/list");
+  return gs1Prefix;
+}
+
+// src/namespaces/industry.ts
+function createIndustryNamespace(client) {
+  const industry = ((value, opts) => client.get("/v0/industry", {
+    value,
+    system: opts?.system
+  }));
+  industry.list = (opts) => client.get("/v0/industry/list", {
+    system: opts.system,
+    level: opts?.level,
+    parent: opts?.parent
+  });
+  return industry;
+}
+
+// src/namespaces/timezone.ts
+function createTimezoneNamespace(client) {
+  const timezone = ((value) => client.get("/v0/timezone", { value }));
+  timezone.list = (opts) => client.get("/v0/timezone/list", { region: opts?.region });
+  return timezone;
+}
+
+// src/namespaces/mimeType.ts
+function createMimeTypeNamespace(client) {
+  const mimeType = ((value) => client.get("/v0/mime-type", { value }));
+  mimeType.ext = (value) => client.get("/v0/mime-type/ext", { value });
+  mimeType.list = (opts) => client.get("/v0/mime-type/list", { type: opts?.type });
+  return mimeType;
+}
+
+// src/namespaces/httpStatus.ts
+function createHttpStatusNamespace(client) {
+  const httpStatus = ((value) => client.get("/v0/http-status", { value }));
+  httpStatus.list = () => client.get("/v0/http-status/list");
+  return httpStatus;
+}
+
+// src/namespaces/swiftMt.ts
+function createSwiftMtNamespace(client) {
+  const swiftMt = ((value) => client.get("/v0/swift-mt", { value }));
+  swiftMt.list = (opts) => client.get("/v0/swift-mt/list", { category: opts?.category?.toString() });
+  return swiftMt;
+}
+
+// src/namespaces/locode.ts
+function createLocodeNamespace(client) {
+  const locode = ((value) => client.get("/v0/locode", { value }));
+  locode.list = (opts) => client.get("/v0/locode/list", { country: opts.country });
+  return locode;
+}
+
 // src/index.ts
 var IsValid = class {
   constructor(config) {
@@ -239,6 +310,14 @@ var IsValid = class {
     this.in = createInNamespace(this.client);
     this.us = createUsNamespace(this.client);
     this.gb = createGbNamespace(this.client);
+    this.hsCode = createHsCodeNamespace(this.client);
+    this.gs1Prefix = createGs1PrefixNamespace(this.client);
+    this.industry = createIndustryNamespace(this.client);
+    this.timezone = createTimezoneNamespace(this.client);
+    this.mimeType = createMimeTypeNamespace(this.client);
+    this.httpStatus = createHttpStatusNamespace(this.client);
+    this.swiftMt = createSwiftMtNamespace(this.client);
+    this.locode = createLocodeNamespace(this.client);
   }
   // --- Simple endpoints ---
   email(value, opts) {
@@ -341,6 +420,36 @@ var IsValid = class {
   creditCard(number) {
     return this.client.post("/v0/credit-card", { number });
   }
+  cas(value) {
+    return this.client.get("/v0/cas", { value });
+  }
+  eori(value, opts) {
+    return this.client.get("/v0/eori", { value, check: opts?.check?.toString() });
+  }
+  orcid(value, opts) {
+    return this.client.get("/v0/orcid", { value, lookup: opts?.lookup?.toString() });
+  }
+  doi(value, opts) {
+    return this.client.get("/v0/doi", { value, lookup: opts?.lookup?.toString() });
+  }
+  barcode(value, opts) {
+    return this.client.get("/v0/barcode", { value, type: opts?.type });
+  }
+  base64(value) {
+    return this.client.get("/v0/base64", { value });
+  }
+  ethAddress(value) {
+    return this.client.get("/v0/eth-address", { value });
+  }
+  cron(value) {
+    return this.client.get("/v0/cron", { value });
+  }
+  domain(value) {
+    return this.client.get("/v0/domain", { value });
+  }
+  regex(pattern, opts) {
+    return this.client.post("/v0/regex", { pattern, flags: opts?.flags });
+  }
 };
 function createClient(config) {
   return new IsValid(config);