@pdfvector/util 0.0.15 → 0.0.17

package/.tsc/lib/free-tier.d.ts

@@ -0,0 +1,19 @@
+export interface FreeTierEndpointLimit {
+    dailyLimit: number;
+    maxFileSize?: number;
+    maxPages?: number;
+}
+export declare const freeTierLimits: {
+    readonly bankStatementParse: {
+        readonly dailyLimit: 5;
+        readonly maxFileSize: number;
+        readonly maxPages: 5;
+    };
+    readonly generateSchema: {
+        readonly dailyLimit: 10;
+    };
+    readonly publicationPdfUrl: {
+        readonly dailyLimit: 20;
+    };
+};
+export type FreeTierEndpoint = keyof typeof freeTierLimits;

package/.tsc/lib/free-tier.js

@@ -0,0 +1,14 @@
+const MB = 1024 * 1024;
+export const freeTierLimits = {
+    bankStatementParse: {
+        dailyLimit: 5,
+        maxFileSize: 5 * MB,
+        maxPages: 5,
+    },
+    generateSchema: {
+        dailyLimit: 10,
+    },
+    publicationPdfUrl: {
+        dailyLimit: 20,
+    },
+};

package/.tsc/lib/index.d.ts

@@ -1,7 +1,9 @@
 export * from "./date";
 export * from "./format";
+export * from "./free-tier";
 export * from "./get-error-message";
 export * from "./plan";
+export * from "./tier";
 export declare const isCI: boolean;
 export declare const isLocal: boolean;
 export declare const isLive: boolean;
@@ -12,6 +14,7 @@ export declare const appPort = 37000;
 export declare const websiteURL: string;
 export declare const appURL: string;
 export declare const gatewayServerURL: string;
+export declare const generalInstanceServerURL: string;
 export declare const productTitle = "PDF Vector";
 export interface ErrorService {
     captureError: (error: unknown) => void;

package/.tsc/lib/index.js

@@ -1,7 +1,9 @@
 export * from "./date";
 export * from "./format";
+export * from "./free-tier";
 export * from "./get-error-message";
 export * from "./plan";
+export * from "./tier";
 function getCIWithBun() {
     try {
         return Bun.env.CI;
@@ -71,6 +73,9 @@ export const appURL = isLocal
 export const gatewayServerURL = isLocal
     ? `http://localhost:${gatewayServerPort}`
     : "https://gateway.pdfvector.com";
+export const generalInstanceServerURL = isLocal
+    ? `http://localhost:${instanceServerPort}`
+    : "https://global.pdfvector.com";
 export const productTitle = "PDF Vector";
 export const errorService = {
     captureError: (error) => {

package/.tsc/lib/tier.d.ts

@@ -0,0 +1,42 @@
+export type ModelTier = "nano" | "mini" | "pro" | "max";
+export declare const modelTiers: ModelTier[];
+export interface TierLimit {
+    maxFileSize: number;
+    maxPages: number;
+}
+export declare const tierLimits: Record<string, TierLimit>;
+export declare const defaultTierLimit: TierLimit;
+/** Document parse: credits per page */
+export declare const documentParseCosts: Record<ModelTier, number>;
+/** Document ask/extract: credits per page */
+export declare const documentAskExtractCosts: Record<ModelTier, number>;
+/** Specialized parse (identity, invoice, bank statement): credits per page.
+ *  Only pro and max are available — nano/mini return 0. */
+export declare const specializedParseCosts: {
+    pro: number;
+    max: number;
+} & Record<string, number | undefined>;
+/** Specialized ask/extract (identity, invoice, bank statement): credits per page */
+export declare const specializedAskExtractCosts: Record<ModelTier, number>;
+/** Formats supported by all tiers (nano, mini, pro, max, auto). */
+export declare const allTierFormats: readonly ["PDF", "Word (.docx)", "Excel (.xlsx)", "PowerPoint (.pptx)", "CSV", "Text (.txt, .md, .tsv, .xml)", "HTML", "RTF", "OpenDocument (.odt, .ods, .odp)", "EPUB", "Bibliography (.bib, .ris, .nbib, .enw)"];
+/** Formats added by the pro tier. */
+export declare const proTierAdditionalFormats: readonly ["Image (PNG, JPG)"];
+/** Formats added by the max/auto tier (superset of pro). */
+export declare const maxTierAdditionalFormats: readonly ["Image (PNG, JPG, TIFF, BMP, HEIF)"];
+/** Short human-readable summary of all supported formats. */
+export declare const allSupportedFormatsShort = "PDF, DOCX, XLSX, PPTX, CSV, PNG, JPG, TIFF, BMP, HEIF, TXT, MD, TSV, XML, RTF, HTML, ODT, ODS, ODP, EPUB, BIB, RIS, NBIB, ENW";
+/** Long human-readable summary of all supported formats. */
+export declare const allSupportedFormatsLong: string;
+/** Pre-built format note for API descriptions (used in contract model descriptions). */
+export declare const formatsByTierDescription: string;
+/** Academic/grant API: fixed credits per request */
+export declare const academicCreditCosts: {
+    readonly academicSearch: 2;
+    readonly academicFetch: 2;
+    readonly academicFindCitationsPerSentence: 2;
+    readonly academicPaperGraphMin: 2;
+    readonly academicPaperGraphDivisor: 50;
+    readonly academicSimilarPapers: 3;
+    readonly grantSearch: 2;
+};

package/.tsc/lib/tier.js

@@ -0,0 +1,86 @@
+const MB = 1024 * 1024;
+export const modelTiers = ["nano", "mini", "pro", "max"];
+export const tierLimits = {
+    nano: { maxFileSize: 40 * MB, maxPages: 30 },
+    mini: { maxFileSize: 40 * MB, maxPages: 30 },
+    pro: { maxFileSize: 40 * MB, maxPages: 30 },
+    max: { maxFileSize: 500 * MB, maxPages: 2000 },
+    auto: { maxFileSize: 500 * MB, maxPages: 2000 },
+};
+export const defaultTierLimit = {
+    maxFileSize: 500 * MB,
+    maxPages: 2000,
+};
+// ─── Credit costs ─────────────────────────────────────────────────────
+/** Document parse: credits per page */
+export const documentParseCosts = {
+    nano: 1,
+    mini: 2,
+    pro: 4,
+    max: 8,
+};
+/** Document ask/extract: credits per page */
+export const documentAskExtractCosts = {
+    nano: 2,
+    mini: 4,
+    pro: 8,
+    max: 16,
+};
+/** Specialized parse (identity, invoice, bank statement): credits per page.
+ *  Only pro and max are available — nano/mini return 0. */
+export const specializedParseCosts = {
+    pro: 6,
+    max: 10,
+};
+/** Specialized ask/extract (identity, invoice, bank statement): credits per page */
+export const specializedAskExtractCosts = {
+    nano: 6,
+    mini: 10,
+    pro: 14,
+    max: 18,
+};
+// ─── Supported formats per tier ───────────────────────────────────────
+/** Formats supported by all tiers (nano, mini, pro, max, auto). */
+export const allTierFormats = [
+    "PDF",
+    "Word (.docx)",
+    "Excel (.xlsx)",
+    "PowerPoint (.pptx)",
+    "CSV",
+    "Text (.txt, .md, .tsv, .xml)",
+    "HTML",
+    "RTF",
+    "OpenDocument (.odt, .ods, .odp)",
+    "EPUB",
+    "Bibliography (.bib, .ris, .nbib, .enw)",
+];
+/** Formats added by the pro tier. */
+export const proTierAdditionalFormats = ["Image (PNG, JPG)"];
+/** Formats added by the max/auto tier (superset of pro). */
+export const maxTierAdditionalFormats = [
+    "Image (PNG, JPG, TIFF, BMP, HEIF)",
+];
+/** Short human-readable summary of all supported formats. */
+export const allSupportedFormatsShort = "PDF, DOCX, XLSX, PPTX, CSV, PNG, JPG, TIFF, BMP, HEIF, TXT, MD, TSV, XML, RTF, HTML, ODT, ODS, ODP, EPUB, BIB, RIS, NBIB, ENW";
+/** Long human-readable summary of all supported formats. */
+export const allSupportedFormatsLong = "PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), CSV, " +
+    "Image (.png, .jpg, .tiff, .bmp, .heif), " +
+    "Plain Text (.txt, .md, .tsv, .xml), RTF, HTML, " +
+    "OpenDocument (.odt, .ods, .odp), EPUB, " +
+    "and Bibliography (.bib, .ris, .nbib, .enw) files";
+/** Pre-built format note for API descriptions (used in contract model descriptions). */
+export const formatsByTierDescription = "Supported formats by tier:\n" +
+    `- All tiers: ${allTierFormats.join(", ")}.\n` +
+    `- Pro adds: ${proTierAdditionalFormats.join(", ")}.\n` +
+    `- Max/Auto adds: ${maxTierAdditionalFormats.join(", ")}.`;
+// ─── Academic credit costs ────────────────────────────────────────────
+/** Academic/grant API: fixed credits per request */
+export const academicCreditCosts = {
+    academicSearch: 2,
+    academicFetch: 2,
+    academicFindCitationsPerSentence: 2,
+    academicPaperGraphMin: 2,
+    academicPaperGraphDivisor: 50,
+    academicSimilarPapers: 3,
+    grantSearch: 2,
+};

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @pdfvector/util
 
+## 0.0.17
+### Patch Changes
+
+
+
+- [#176](https://github.com/phuctm97/pdfvector/pull/176) [`cfbc548`](https://github.com/phuctm97/pdfvector/commit/cfbc54864ef055bb68ea081b3ead7ba69ca2c819) Thanks [@khanhduyvt0101](https://github.com/khanhduyvt0101)! - Add free usage sync, centralize tier limits/credits, deduplicate parse handlers
+
+## 0.0.16
+### Patch Changes
+
+
+
+- [#125](https://github.com/phuctm97/pdfvector/pull/125) [`0eac9b7`](https://github.com/phuctm97/pdfvector/commit/0eac9b7afdbe9b8a41933fd1f92e48da51fb4480) Thanks [@khanhduyvt0101](https://github.com/khanhduyvt0101)! - Add free public APIs with IP rate limiting and interactive tool pages
+
 ## 0.0.15
 ### Patch Changes
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pdfvector/util",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "type": "module",
   "main": ".tsc/lib/index.js",
   "files": [