@pdfvector/util 0.5.1 → 0.6.0

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

@@ -1,5 +1,6 @@
 export * from "./free.js";
 export * from "./overview.js";
 export * from "./provider-costs.js";
+export * from "./provider-health.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,kBAAkB,CAAC;AACjC,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,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC"}

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

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

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

@@ -0,0 +1,44 @@
+import * as z from "zod";
+/** Failure and hidden-fallback rates per provider/service for the admin console. */
+export declare const getProviderHealth: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodDefault<z.ZodOptional<z.ZodObject<{
+    instanceId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>>>, z.ZodObject<{
+    generatedAt: z.ZodString;
+    thresholds: z.ZodObject<{
+        downMinCalls1h: z.ZodNumber;
+        degradedMinCalls24h: z.ZodNumber;
+        degradedFailureRate24h: z.ZodNumber;
+    }, z.core.$strip>;
+    rows: z.ZodArray<z.ZodObject<{
+        provider: z.ZodString;
+        service: z.ZodString;
+        status: z.ZodEnum<{
+            degraded: "degraded";
+            down: "down";
+            ok: "ok";
+        }>;
+        windows: z.ZodObject<{
+            "1h": z.ZodObject<{
+                calls: z.ZodNumber;
+                systemErrors: z.ZodNumber;
+                userErrors: z.ZodNumber;
+                fallbacks: z.ZodNumber;
+            }, z.core.$strip>;
+            "24h": z.ZodObject<{
+                calls: z.ZodNumber;
+                systemErrors: z.ZodNumber;
+                userErrors: z.ZodNumber;
+                fallbacks: z.ZodNumber;
+            }, z.core.$strip>;
+            "7d": z.ZodObject<{
+                calls: z.ZodNumber;
+                systemErrors: z.ZodNumber;
+                userErrors: z.ZodNumber;
+                fallbacks: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        lastError: z.ZodNullable<z.ZodString>;
+        lastErrorAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, Record<never, never>, Record<never, never>>;
+//# sourceMappingURL=provider-health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider-health.d.ts","sourceRoot":"","sources":["../../../../../../../lib/contract/gateway/router/admin/usage/provider-health.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAWzB,oFAAoF;AACpF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DA8B5B,CAAC"}

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

@@ -0,0 +1,35 @@
+import { oc } from "@orpc/contract";
+import * as z from "zod";
+const windowSchema = z.object({
+    calls: z.number(),
+    systemErrors: z.number(),
+    userErrors: z.number(),
+    fallbacks: z.number(),
+});
+const providerHealthStatuses = ["down", "degraded", "ok"];
+/** Failure and hidden-fallback rates per provider/service for the admin console. */
+export const getProviderHealth = oc
+    .input(z
+    .object({ instanceId: z.number().nullable().optional() })
+    .optional()
+    .default({}))
+    .output(z.object({
+    generatedAt: z.string(),
+    thresholds: z.object({
+        downMinCalls1h: z.number(),
+        degradedMinCalls24h: z.number(),
+        degradedFailureRate24h: z.number(),
+    }),
+    rows: z.array(z.object({
+        provider: z.string(),
+        service: z.string(),
+        status: z.enum(providerHealthStatuses),
+        windows: z.object({
+            "1h": windowSchema,
+            "24h": windowSchema,
+            "7d": windowSchema,
+        }),
+        lastError: z.string().nullable(),
+        lastErrorAt: z.string().nullable(),
+    })),
+}));

package/.tsc/lib/contract/instance/router/academic/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../../../lib/contract/instance/router/academic/search.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2DxB,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAkHhB,CAAC"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../../../lib/contract/instance/router/academic/search.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2DxB,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAyHhB,CAAC"}

package/.tsc/lib/contract/instance/router/academic/search.js

@@ -133,7 +133,12 @@ export const search = oc
     .output(z.object({
     estimatedTotalResults: z.number(),
     results: z.array(publicationSchema),
-    errors: z.array(providerErrorSchema).nullish(),
+    errors: z
+        .array(providerErrorSchema)
+        .nullish()
+        .describe("Providers that failed for this request (for example rate limited or unavailable). " +
+        "When present, `results` only contain papers from the providers that succeeded, so treat the response as partial. " +
+        "Credits are the same either way."),
     requestId: z.number().int(),
 }))
     .route({

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @pdfvector/util
 
+## 0.6.0
+
+### Minor Changes
+
+- [#521](https://github.com/phuctm97/pdfvector/pull/521) [`43f714f`](https://github.com/phuctm97/pdfvector/commit/43f714f0a28af7f3d213bfd1042dd2013cb39459) Thanks [@khanhduyvt0101](https://github.com/khanhduyvt0101)! - Add admin provider health: failure and hidden-fallback rates per provider/service over 1 h, 24 h and 7 d, a Provider health card on the admin usage page and a "Needs attention" item on the admin overview.
+
+### Patch Changes
+
+- [#521](https://github.com/phuctm97/pdfvector/pull/521) [`43f714f`](https://github.com/phuctm97/pdfvector/commit/43f714f0a28af7f3d213bfd1042dd2013cb39459) Thanks [@khanhduyvt0101](https://github.com/khanhduyvt0101)! - Stop hiding provider failures behind fallbacks:
+  
+  - Semantic Scholar: pace requests per process, retry 429s after `Retry-After` with bounded backoff instead of retrying through the proxy (S2 limits per API key), and record 429/5xx as system errors with the endpoint and response message.
+  - Webshare proxy usage now reflects proxy health only; the target's HTTP status is kept in `rawUsage.targetStatus`.
+  - Google Document AI: send `imagelessMode` so PDFs of up to 30 pages parse in one call (was 15), and let the max-tier fallback parse larger PDFs in 15-page chunks (up to 200 pages). PDFs over 30 pages skip the failing Document AI call in auto mode.
+  - Nano: a PDF without a usable text layer (scanned or image-only) now fails with a clear user-side error that says Nano only reads embedded text, instead of a generic system error.
+  - Azure image pre-check failures now record the Azure error code and message.
+  - API reference: document the academic search `errors` field (partial results when a provider fails).
+
 ## 0.5.1
 
 ### Patch Changes

package/package.json

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