@pdfvector/util 0.3.0 → 0.4.0

package/.tsc/lib/api-source.d.ts

@@ -1,3 +1,3 @@
-export declare const apiSources: readonly ["make", "zapier", "n8n", "sdk", "mcp", "playground", "api", "unknown"];
+export declare const apiSources: readonly ["make", "zapier", "n8n", "sdk", "mcp", "playground", "api", "unknown", "internal"];
 export type APISource = (typeof apiSources)[number];
 //# sourceMappingURL=api-source.d.ts.map

package/.tsc/lib/api-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-source.d.ts","sourceRoot":"","sources":["../../lib/api-source.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,YACtB,MAAM,EACN,QAAQ,EACR,KAAK,EACL,KAAK,EACL,KAAK,EACL,YAAY,EACZ,KAAK,EACL,SAAS,CACA,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"api-source.d.ts","sourceRoot":"","sources":["../../lib/api-source.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,YACtB,MAAM,EACN,QAAQ,EACR,KAAK,EACL,KAAK,EACL,KAAK,EACL,YAAY,EACZ,KAAK,EACL,SAAS,EAET,UAAU,CACD,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/.tsc/lib/api-source.js

@@ -7,4 +7,6 @@ export const apiSources = [
     "playground",
     "api",
     "unknown",
+    // PDF Vector's own test calls (internal test key). Never billed or shown to customers.
+    "internal",
 ];

package/.tsc/lib/contract/gateway/router/admin/usage/free.d.ts

@@ -70,6 +70,7 @@ export declare const listFreeUsage: import("@orpc/contract").ContractProcedureBu
         ip: z.ZodString;
         source: z.ZodDefault<z.ZodEnum<{
             api: "api";
+            internal: "internal";
             make: "make";
             mcp: "mcp";
             n8n: "n8n";

package/.tsc/lib/contract/gateway/router/admin/usage/free.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"free.d.ts","sourceRoot":"","sources":["../../../../../../../lib/contract/gateway/router/admin/usage/free.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,aAAa;;8DAEkB,CAAC;AAE7C,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAuDhC,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DA6CxB,CAAC"}
+{"version":3,"file":"free.d.ts","sourceRoot":"","sources":["../../../../../../../lib/contract/gateway/router/admin/usage/free.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,aAAa;;8DAEkB,CAAC;AAE7C,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAuDhC,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DA6CxB,CAAC"}

package/.tsc/lib/contract/gateway/router/admin/usage/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./free.js";
 export * from "./overview.js";
+export * from "./provider-costs.js";
 export * from "./records.js";
 //# sourceMappingURL=index.d.ts.map

package/.tsc/lib/contract/gateway/router/admin/usage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../lib/contract/gateway/router/admin/usage/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../lib/contract/gateway/router/admin/usage/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC"}

package/.tsc/lib/contract/gateway/router/admin/usage/index.js

@@ -1,3 +1,4 @@
 export * from "./free.js";
 export * from "./overview.js";
+export * from "./provider-costs.js";
 export * from "./records.js";

package/.tsc/lib/contract/gateway/router/admin/usage/overview.d.ts

@@ -9,6 +9,7 @@ export declare const getUsageOverview: import("@orpc/contract").ContractProcedur
     instanceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     sources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         api: "api";
+        internal: "internal";
         make: "make";
         mcp: "mcp";
         n8n: "n8n";
@@ -44,6 +45,7 @@ export declare const getUsageOverview: import("@orpc/contract").ContractProcedur
         date: z.ZodString;
         source: z.ZodEnum<{
             api: "api";
+            internal: "internal";
             make: "make";
             mcp: "mcp";
             n8n: "n8n";

package/.tsc/lib/contract/gateway/router/admin/usage/overview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../../../../../../lib/contract/gateway/router/admin/usage/overview.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAOzB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAyE3B,CAAC"}
+{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../../../../../../lib/contract/gateway/router/admin/usage/overview.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAOzB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAyE3B,CAAC"}

package/.tsc/lib/contract/gateway/router/admin/usage/provider-costs.d.ts

@@ -0,0 +1,39 @@
+import * as z from "zod";
+/** Estimated provider cost (OCR, LLM, academic APIs, proxy) for the admin dashboard. */
+export declare const getProviderCosts: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+    period: z.ZodDefault<z.ZodEnum<{
+        "30d": "30d";
+        "7d": "7d";
+        "90d": "90d";
+        all: "all";
+    }>>;
+    instanceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    sources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        api: "api";
+        internal: "internal";
+        make: "make";
+        mcp: "mcp";
+        n8n: "n8n";
+        playground: "playground";
+        sdk: "sdk";
+        unknown: "unknown";
+        zapier: "zapier";
+    }>>>;
+}, z.core.$strip>, z.ZodObject<{
+    totalCostUsdMicro: z.ZodNumber;
+    byProvider: z.ZodArray<z.ZodObject<{
+        calls: z.ZodNumber;
+        failedCalls: z.ZodNumber;
+        costUsdMicro: z.ZodNumber;
+        provider: z.ZodString;
+        service: z.ZodString;
+    }, z.core.$strip>>;
+    byOperationTier: z.ZodArray<z.ZodObject<{
+        calls: z.ZodNumber;
+        failedCalls: z.ZodNumber;
+        costUsdMicro: z.ZodNumber;
+        operation: z.ZodString;
+        tier: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, Record<never, never>, Record<never, never>>;
+//# sourceMappingURL=provider-costs.d.ts.map

package/.tsc/lib/contract/gateway/router/admin/usage/provider-costs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-costs.d.ts","sourceRoot":"","sources":["../../../../../../../lib/contract/gateway/router/admin/usage/provider-costs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAQzB,wFAAwF;AACxF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAqB3B,CAAC"}

package/.tsc/lib/contract/gateway/router/admin/usage/provider-costs.js

@@ -0,0 +1,23 @@
+import { oc } from "@orpc/contract";
+import { apiSources } from "@pdfvector/util";
+import * as z from "zod";
+const costRowSchema = z.object({
+    calls: z.number(),
+    failedCalls: z.number(),
+    costUsdMicro: z.number(),
+});
+/** Estimated provider cost (OCR, LLM, academic APIs, proxy) for the admin dashboard. */
+export const getProviderCosts = oc
+    .input(z.object({
+    period: z.enum(["7d", "30d", "90d", "all"]).default("30d"),
+    instanceId: z.number().nullable().optional(),
+    sources: z.array(z.enum(apiSources)).optional(),
+}))
+    .output(z.object({
+    totalCostUsdMicro: z.number(),
+    byProvider: z.array(costRowSchema.extend({ provider: z.string(), service: z.string() })),
+    byOperationTier: z.array(costRowSchema.extend({
+        operation: z.string(),
+        tier: z.string(),
+    })),
+}));

package/.tsc/lib/contract/gateway/router/admin/usage/records.d.ts

@@ -52,6 +52,7 @@ export declare const listUsage: import("@orpc/contract").ContractProcedureBuilde
         requestedModel: z.ZodString;
         source: z.ZodEnum<{
             api: "api";
+            internal: "internal";
             make: "make";
             mcp: "mcp";
             n8n: "n8n";

package/.tsc/lib/contract/gateway/router/admin/usage/records.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../../../../../../lib/contract/gateway/router/admin/usage/records.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAyDpB,CAAC"}
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../../../../../../lib/contract/gateway/router/admin/usage/records.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAyDpB,CAAC"}

package/.tsc/lib/contract/gateway/router/instance/billing.d.ts

@@ -50,6 +50,10 @@ export declare const createWithBilling: import("@orpc/contract").ContractProcedu
         syd: "syd";
         yyz: "yyz";
     }>>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        "local-pdf": "local-pdf";
+    }>>;
     requestKey: z.ZodString;
     quoteId: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
@@ -74,4 +78,25 @@ export declare const billingOperation: import("@orpc/contract").ContractProcedur
     instanceId: z.ZodNullable<z.ZodNumber>;
     hostedInvoiceUrl: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>, Record<never, never>, Record<never, never>>;
+export declare const pendingBillingOperations: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, z.ZodArray<z.ZodObject<{
+    operationId: z.ZodString;
+    state: z.ZodEnum<{
+        creating: "creating";
+        paid: "paid";
+        payment_required: "payment_required";
+        reserved: "reserved";
+    }>;
+    name: z.ZodString;
+    region: z.ZodNullable<z.ZodString>;
+    kind: z.ZodEnum<{
+        full: "full";
+        "local-pdf": "local-pdf";
+    }>;
+    createdAt: z.ZodDate;
+}, z.core.$strip>>, Record<never, never>, Record<never, never>>;
+export declare const cancelBillingOperation: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+    operationId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    success: z.ZodLiteral<true>;
+}, z.core.$strip>, Record<never, never>, Record<never, never>>;
 //# sourceMappingURL=billing.d.ts.map

package/.tsc/lib/contract/gateway/router/instance/billing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../../../../../lib/contract/gateway/router/instance/billing.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,cAAc;;;;;;;;;8DAa1B,CAAC;AACF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;8DASxB,CAAC;AACF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAUd,CAAC;AACjB,eAAO,MAAM,gBAAgB;;;;;;;;;;;8DAEb,CAAC"}
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../../../../../lib/contract/gateway/router/instance/billing.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,cAAc;;;;;;;;;8DAa1B,CAAC;AACF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;8DASxB,CAAC;AACF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAWd,CAAC;AACjB,eAAO,MAAM,gBAAgB;;;;;;;;;;;8DAEb,CAAC;AACjB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;+DAWpC,CAAC;AACF,eAAO,MAAM,sBAAsB;;;;8DAEa,CAAC"}

package/.tsc/lib/contract/gateway/router/instance/billing.js

@@ -34,6 +34,7 @@ export const createWithBilling = oc
     name: z.string().min(1).max(255),
     description: z.string().max(1000).optional(),
     region: z.enum(flyRegions.map((region) => region.code)).optional(),
+    kind: z.enum(["local-pdf", "full"]).optional(),
     requestKey: z.string().uuid(),
     quoteId: z.string().uuid(),
 }))
@@ -41,3 +42,14 @@ export const createWithBilling = oc
 export const billingOperation = oc
     .input(z.object({ operationId: z.string().uuid() }))
     .output(result);
+export const pendingBillingOperations = oc.output(z.array(z.object({
+    operationId: z.string().uuid(),
+    state: z.enum(["reserved", "creating", "payment_required", "paid"]),
+    name: z.string(),
+    region: z.string().nullable(),
+    kind: z.enum(["local-pdf", "full"]),
+    createdAt: z.date(),
+})));
+export const cancelBillingOperation = oc
+    .input(z.object({ operationId: z.string().uuid() }))
+    .output(z.object({ success: z.literal(true) }));

package/.tsc/lib/contract/gateway/router/instance/instances.d.ts

@@ -72,6 +72,10 @@ export declare const create: import("@orpc/contract").ContractProcedureBuilderWi
         syd: "syd";
         yyz: "yyz";
     }>>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        "local-pdf": "local-pdf";
+    }>>;
     requestKey: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
@@ -142,4 +146,12 @@ export declare const getCredits: import("@orpc/contract").ContractProcedureBuild
     resetsAt: z.ZodNullable<z.ZodDate>;
     eligible: z.ZodBoolean;
 }, z.core.$strip>>, Record<never, never>, Record<never, never>>;
+export declare const regionProfiles: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, z.ZodArray<z.ZodObject<{
+    code: z.ZodString;
+    name: z.ZodString;
+    profile: z.ZodString;
+    residency: z.ZodString;
+    processing: z.ZodString;
+    available: z.ZodBoolean;
+}, z.core.$strip>>, Record<never, never>, Record<never, never>>;
 //# sourceMappingURL=instances.d.ts.map

package/.tsc/lib/contract/gateway/router/instance/instances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../../../../../lib/contract/gateway/router/instance/instances.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AA+BzB,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;+DAAqC,CAAC;AAEvD,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAEsD,CAAC;AAEvE,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DASK,CAAC;AAEzB,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;8DAEM,CAAC;AAEzB,eAAO,MAAM,MAAM;;;;8DAEyB,CAAC;AAE7C,eAAO,MAAM,UAAU;;;;;;;;;+DAarB,CAAC"}
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../../../../../lib/contract/gateway/router/instance/instances.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AA+BzB,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;+DAAqC,CAAC;AAEvD,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAEsD,CAAC;AAEvE,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAUK,CAAC;AAEzB,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;8DAEM,CAAC;AAEzB,eAAO,MAAM,MAAM;;;;8DAEyB,CAAC;AAE7C,eAAO,MAAM,UAAU;;;;;;;;;+DAarB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;+DAW1B,CAAC"}

package/.tsc/lib/contract/gateway/router/instance/instances.js

@@ -33,6 +33,7 @@ export const get = oc
 export const create = oc
     .input(z.object({
     region: z.enum(flyRegions.map((region) => region.code)).optional(),
+    kind: z.enum(["local-pdf", "full"]).optional(),
     requestKey: z.string().uuid().optional(),
     name: z.string().min(1).max(255),
     description: z.string().max(1000).optional(),
@@ -56,3 +57,11 @@ export const getCredits = oc
     eligible: z.boolean(),
 })
     .nullable());
+export const regionProfiles = oc.output(z.array(z.object({
+    code: z.string(),
+    name: z.string(),
+    profile: z.string(),
+    residency: z.string(),
+    processing: z.string(),
+    available: z.boolean(),
+})));

package/.tsc/lib/contract/gateway/router/instance/usage.d.ts

@@ -40,6 +40,7 @@ export declare const getUsage: import("@orpc/contract").ContractProcedureBuilder
     workspaceId: z.ZodNullable<z.ZodNumber>;
     source: z.ZodEnum<{
         api: "api";
+        internal: "internal";
         make: "make";
         mcp: "mcp";
         n8n: "n8n";
@@ -69,6 +70,7 @@ export declare const listUsageRecords: import("@orpc/contract").ContractProcedur
     excludedApiKeys: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNull]>>>;
     sources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         api: "api";
+        internal: "internal";
         make: "make";
         mcp: "mcp";
         n8n: "n8n";
@@ -134,6 +136,7 @@ export declare const listUsageRecords: import("@orpc/contract").ContractProcedur
         workspaceId: z.ZodNullable<z.ZodNumber>;
         source: z.ZodEnum<{
             api: "api";
+            internal: "internal";
             make: "make";
             mcp: "mcp";
             n8n: "n8n";
@@ -213,6 +216,7 @@ export declare const getUsageRecord: import("@orpc/contract").ContractProcedureB
         workspaceId: z.ZodNullable<z.ZodNumber>;
         source: z.ZodEnum<{
             api: "api";
+            internal: "internal";
             make: "make";
             mcp: "mcp";
             n8n: "n8n";

package/.tsc/lib/contract/gateway/router/instance/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../../../../lib/contract/gateway/router/instance/usage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AA6BzB,eAAO,MAAM,SAAS;;;;8DAEoB,CAAC;AAE3C,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DAQe,CAAC;AAErC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DA6C3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;8DAO5B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;8DAoB1B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAMzB,CAAC"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../../../../lib/contract/gateway/router/instance/usage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AA6BzB,eAAO,MAAM,SAAS;;;;8DAEoB,CAAC;AAE3C,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DAQe,CAAC;AAErC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DA6C3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;8DAO5B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;8DAoB1B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAMzB,CAAC"}

package/.tsc/lib/contract/instance/router/admin/get-free-usage-records.d.ts

@@ -9,6 +9,7 @@ export declare const getFreeUsageRecords: import("@orpc/contract").ContractProce
         ip: z.ZodString;
         source: z.ZodDefault<z.ZodEnum<{
             api: "api";
+            internal: "internal";
             make: "make";
             mcp: "mcp";
             n8n: "n8n";

package/.tsc/lib/contract/instance/router/admin/get-free-usage-records.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-free-usage-records.d.ts","sourceRoot":"","sources":["../../../../../../lib/contract/instance/router/admin/get-free-usage-records.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqBxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAsB9B,CAAC"}
+{"version":3,"file":"get-free-usage-records.d.ts","sourceRoot":"","sources":["../../../../../../lib/contract/instance/router/admin/get-free-usage-records.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqBxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAsB9B,CAAC"}

package/.tsc/lib/contract/instance/router/admin/get-usage-records.d.ts

@@ -34,6 +34,7 @@ export declare const getUsageRecords: import("@orpc/contract").ContractProcedure
         workspaceId: z.ZodNullable<z.ZodNumber>;
         source: z.ZodDefault<z.ZodEnum<{
             api: "api";
+            internal: "internal";
             make: "make";
             mcp: "mcp";
             n8n: "n8n";

package/.tsc/lib/contract/instance/router/admin/get-usage-records.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-usage-records.d.ts","sourceRoot":"","sources":["../../../../../../lib/contract/instance/router/admin/get-usage-records.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAsB1B,CAAC"}
+{"version":3,"file":"get-usage-records.d.ts","sourceRoot":"","sources":["../../../../../../lib/contract/instance/router/admin/get-usage-records.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAsB1B,CAAC"}

package/.tsc/lib/environment.d.ts

@@ -1,4 +1,5 @@
 export declare const isCI: boolean;
 export declare const isLocal: boolean;
 export declare const isLive: boolean;
+export declare const isStaging: boolean;
 //# sourceMappingURL=environment.d.ts.map

package/.tsc/lib/environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../lib/environment.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,IAAI,SAAiB,CAAC;AACnC,eAAO,MAAM,OAAO,SAAoB,CAAC;AACzC,eAAO,MAAM,MAAM,SAAW,CAAC"}
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../lib/environment.ts"],"names":[],"mappings":"AA4BA,eAAO,MAAM,IAAI,SAAiB,CAAC;AACnC,eAAO,MAAM,OAAO,SAAoB,CAAC;AACzC,eAAO,MAAM,MAAM,SAAW,CAAC;AAC/B,eAAO,MAAM,SAAS,SAAgC,CAAC"}

package/.tsc/lib/environment.js

@@ -5,10 +5,12 @@ const nodeEnvironment = readRuntimeEnvironment(Reflect.get(globalThis, "process"
 const nextPublicEnvironment = safelyReadEnvironment(() => ({
     NEXT_PUBLIC_CI: process.env["NEXT_PUBLIC_CI"],
     NEXT_PUBLIC_PDFVECTOR_LOCAL: process.env["NEXT_PUBLIC_PDFVECTOR_LOCAL"],
+    NEXT_PUBLIC_PDFVECTOR_STAGING: process.env["NEXT_PUBLIC_PDFVECTOR_STAGING"],
 }));
 const viteEnvironment = safelyReadEnvironment(() => ({
     VITE_CI: import.meta.env["VITE_CI"],
     VITE_PDFVECTOR_LOCAL: import.meta.env["VITE_PDFVECTOR_LOCAL"],
+    VITE_PDFVECTOR_STAGING: import.meta.env["VITE_PDFVECTOR_STAGING"],
 }));
 const environment = resolveEnvironment([
     runtimeFlags(bunEnvironment),
@@ -19,3 +21,4 @@ const environment = resolveEnvironment([
 export const isCI = environment.ci;
 export const isLocal = environment.local;
 export const isLive = !isLocal;
+export const isStaging = isLive && environment.staging;

package/.tsc/lib/region-profiles.d.ts

@@ -0,0 +1,18 @@
+import { flyRegions } from "./fly-regions.js";
+export declare const regionProfileIds: readonly ["uk", "eu", "us", "jp", "au", "apac"];
+export type RegionProfileId = (typeof regionProfileIds)[number];
+export type FlyRegionCode = (typeof flyRegions)[number]["code"];
+export declare const regionProfileInfo: Record<RegionProfileId, {
+    residency: string;
+    label: string;
+    processing: string;
+}>;
+/**
+ * Fly region -> region profile for full instances. Only regions whose AI and OCR
+ * providers run in the same residency zone as the machine are listed; others
+ * (Sao Paulo, Johannesburg, Toronto) keep text-PDF instances only.
+ */
+export declare const flyRegionProfiles: Partial<Record<FlyRegionCode, RegionProfileId>>;
+export declare function isRegionProfileId(value: unknown): value is RegionProfileId;
+export declare function regionProfileForFlyRegion(code: string): RegionProfileId | undefined;
+//# sourceMappingURL=region-profiles.d.ts.map

package/.tsc/lib/region-profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-profiles.d.ts","sourceRoot":"","sources":["../../lib/region-profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,eAAO,MAAM,gBAAgB,YAAI,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAU,CAAC;AAEhF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,eAAO,MAAM,iBAAiB,EAAE,MAAM,CACrC,eAAe,EACf;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAsCxD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,CACtC,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC,CAgBtC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAK1E;AAED,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,MAAM,GACV,eAAe,GAAG,SAAS,CAG7B"}

package/.tsc/lib/region-profiles.js

@@ -0,0 +1,63 @@
+import { flyRegions } from "./fly-regions.js";
+export const regionProfileIds = ["uk", "eu", "us", "jp", "au", "apac"];
+export const regionProfileInfo = {
+    uk: {
+        residency: "UK",
+        label: "United Kingdom",
+        processing: "AI and OCR run in London (AWS eu-west-2, Azure UK South, Google europe-west2).",
+    },
+    eu: {
+        residency: "EU",
+        label: "Europe",
+        processing: "AI runs in the European data zone (Azure EU Data Zone, AWS Bedrock EU profiles); OCR runs in Sweden and the Google EU multi-region.",
+    },
+    us: {
+        residency: "US",
+        label: "United States",
+        processing: "AI runs in the US data zone (Azure US Data Zone, AWS us-east-1 and US profiles); OCR runs in the US.",
+    },
+    jp: {
+        residency: "JP",
+        label: "Japan",
+        processing: "AI runs in Japan (AWS Tokyo and Japan profiles); OCR runs in Azure Japan East.",
+    },
+    au: {
+        residency: "AU",
+        label: "Australia",
+        processing: "AI runs in Australia (AWS Sydney and Australia profiles); OCR runs in Azure Australia East and Google australia-southeast1.",
+    },
+    apac: {
+        residency: "APAC",
+        label: "Asia Pacific",
+        processing: "AI runs in AWS Sydney and Tokyo (in-region and Australia profiles), with Asia Pacific profiles as fallback; OCR runs in Azure Southeast Asia and Google asia-southeast1.",
+    },
+};
+/**
+ * Fly region -> region profile for full instances. Only regions whose AI and OCR
+ * providers run in the same residency zone as the machine are listed; others
+ * (Sao Paulo, Johannesburg, Toronto) keep text-PDF instances only.
+ */
+export const flyRegionProfiles = {
+    ams: "eu",
+    arn: "eu",
+    cdg: "eu",
+    dfw: "us",
+    ewr: "us",
+    fra: "eu",
+    iad: "us",
+    lax: "us",
+    lhr: "uk",
+    nrt: "jp",
+    ord: "us",
+    sin: "apac",
+    sjc: "us",
+    syd: "au",
+};
+export function isRegionProfileId(value) {
+    return (typeof value === "string" &&
+        regionProfileIds.some((profileId) => profileId === value));
+}
+export function regionProfileForFlyRegion(code) {
+    const region = flyRegions.find((candidate) => candidate.code === code);
+    return region ? flyRegionProfiles[region.code] : undefined;
+}

package/.tsc/lib/resolve-environment.d.ts

@@ -2,6 +2,7 @@ type Environment = Readonly<Record<string, string | undefined>> | undefined;
 interface ResolvedEnvironment {
     ci: boolean;
     local: boolean;
+    staging: boolean;
 }
 export declare function runtimeFlags(environment: Environment): Environment;
 export declare function resolveEnvironment(environments: readonly Environment[]): ResolvedEnvironment;

package/.tsc/lib/resolve-environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-environment.d.ts","sourceRoot":"","sources":["../../lib/resolve-environment.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC;AAE5E,UAAU,mBAAmB;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;CACf;AAID,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAMlE;AAeD,wBAAgB,kBAAkB,CACjC,YAAY,EAAE,SAAS,WAAW,EAAE,GAClC,mBAAmB,CAYrB"}
+{"version":3,"file":"resolve-environment.d.ts","sourceRoot":"","sources":["../../lib/resolve-environment.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC;AAE5E,UAAU,mBAAmB;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CACjB;AAID,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAOlE;AAeD,wBAAgB,kBAAkB,CACjC,YAAY,EAAE,SAAS,WAAW,EAAE,GAClC,mBAAmB,CAkBrB"}

package/.tsc/lib/resolve-environment.js

@@ -5,6 +5,7 @@ export function runtimeFlags(environment) {
     return {
         CI: environment["CI"],
         PDFVECTOR_LOCAL: environment["PDFVECTOR_LOCAL"],
+        PDFVECTOR_STAGING: environment["PDFVECTOR_STAGING"],
     };
 }
 function findValue(environments, keys) {
@@ -24,8 +25,14 @@ export function resolveEnvironment(environments) {
         "NEXT_PUBLIC_PDFVECTOR_LOCAL",
         "VITE_PDFVECTOR_LOCAL",
     ]);
+    const staging = findValue(environments, [
+        "PDFVECTOR_STAGING",
+        "NEXT_PUBLIC_PDFVECTOR_STAGING",
+        "VITE_PDFVECTOR_STAGING",
+    ]);
     return {
         ci: ci !== undefined && enabledValues.has(ci),
         local: local !== undefined && enabledValues.has(local),
+        staging: staging !== undefined && enabledValues.has(staging),
     };
 }

package/.tsc/lib/urls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../../lib/urls.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,UAAU,QAEO,CAAC;AAE/B,eAAO,MAAM,MAAM,QAEW,CAAC;AAE/B,eAAO,MAAM,gBAAgB,QAEK,CAAC;AAEnC,eAAO,MAAM,wBAAwB,QAEJ,CAAC"}
+{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../../lib/urls.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,UAAU,QAEF,CAAC;AAEtB,eAAO,MAAM,MAAM,QAEE,CAAC;AAEtB,eAAO,MAAM,gBAAgB,QAEJ,CAAC;AAE1B,eAAO,MAAM,wBAAwB,QAEb,CAAC"}

package/.tsc/lib/urls.js

@@ -1,14 +1,19 @@
-import { isLocal } from "./environment.js";
+import { isLocal, isStaging } from "./environment.js";
 import { appPort, gatewayServerPort, instanceServerPort, websitePort, } from "./ports.js";
+function deployedURL(subdomain) {
+    return isStaging
+        ? `https://staging-${subdomain}.pdfvector.com`
+        : `https://${subdomain}.pdfvector.com`;
+}
 export const websiteURL = isLocal
     ? `http://localhost:${websitePort}`
-    : "https://www.pdfvector.com";
+    : deployedURL("www");
 export const appURL = isLocal
     ? `http://localhost:${appPort}`
-    : "https://app.pdfvector.com";
+    : deployedURL("app");
 export const gatewayServerURL = isLocal
     ? `http://localhost:${gatewayServerPort}`
-    : "https://gateway.pdfvector.com";
+    : deployedURL("gateway");
 export const generalInstanceServerURL = isLocal
     ? `http://localhost:${instanceServerPort}`
-    : "https://global.pdfvector.com";
+    : deployedURL("global");

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @pdfvector/util
 
+## 0.4.0
+
+### Minor Changes
+
+- [#500](https://github.com/phuctm97/pdfvector/pull/500) [`a9d1140`](https://github.com/phuctm97/pdfvector/commit/a9d1140c701fe3ccb599d49ccf3459ab17e519cd) Thanks [@khanhduyvt0101](https://github.com/khanhduyvt0101)! - Provider cost tracking:
+  - LLM calls (Azure OpenAI, Bedrock) now record an estimated cost from a versioned list-price table (`2026-11-list-price`), per deployment type and region, including cached input and cache writes.
+  - Academic providers are tracked: Scrapingdog (Google Scholar, 5 credits per call), the Webshare proxy (bandwidth), and Crossref Plus and Semantic Scholar (call volume at $0).
+  - A new admin endpoint `getProviderCosts` and a "Provider cost" card on the admin usage overview show cost per provider and per API + tier.
+
+## 0.3.1
+
+### Patch Changes
+
+- [#498](https://github.com/phuctm97/pdfvector/pull/498) [`b216ac0`](https://github.com/phuctm97/pdfvector/commit/b216ac0b2fec63c92148514390f0b8ceb3831987) Thanks [@khanhduyvt0101](https://github.com/khanhduyvt0101)! - New model chains from the 2026-11 benchmark.
+  
+  - Global instance: nano, mini and pro use gpt-6-luna at default reasoning (mini and pro no longer force low effort). max uses gpt-6.1-sol. Fallbacks are gpt-oss-120b, Claude Haiku 4.5 and Claude Sonnet 4.6 instead of Amazon Nova. Content validation uses gpt-oss-120b.
+  - UK, JP, AU and APAC region instances: nano, mini and pro use gpt-oss-120b inside the zone, and max uses Claude Sonnet 4.6 inside the zone, replacing Amazon Nova and Claude Haiku. EU pro and max fall back to Claude Sonnet 4.6 (EU profile). US matches the global chains.
+  - APAC models can run in different in-zone Bedrock regions (Sydney, Tokyo).
+  - The privacy page now lists the providers we actually use.
+
 ## 0.3.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pdfvector/util",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "main": "./.tsc/lib/index.js",
   "exports": {