@vertz/fetch 0.2.14 → 0.2.16

package/dist/index.d.ts

@@ -194,4 +194,31 @@ declare class ServiceUnavailableError extends FetchError2 {
 	constructor(message: string, body?: unknown);
 }
 declare function createErrorFromStatus(status: number, message: string, body?: unknown): FetchError2;
-export { unwrapOr, unwrap, ok, matchError, isQueryDescriptor, isOk, isMutationDescriptor, isErr, err, createMutationDescriptor, createErrorFromStatus, createDescriptor, UnprocessableEntityError, UnauthorizedError, StreamingRequestOptions, StreamingFormat, ServiceUnavailableError, RetryConfig, Result3 as Result, RequestOptions, RateLimitError, QueryDescriptor, OptimisticHandler, NotFoundError, MutationMeta, MutationDescriptor, ListResponse, InternalServerError, HooksConfig, GoneError, ForbiddenError, FetchResponse, FetchErrorType, FetchError2 as FetchError, FetchClientConfig, FetchClient, EntityQueryMeta, EntityErrorType, ConflictError, BadRequestError, AuthStrategy };
+/** Shape of a single include entry for VertzQL client params. */
+interface VertzQLIncludeEntry {
+	select?: Record<string, true>;
+	where?: Record<string, unknown>;
+	orderBy?: Record<string, "asc" | "desc">;
+	limit?: number;
+	include?: Record<string, true | VertzQLIncludeEntry>;
+}
+interface VertzQLParams {
+	select?: Record<string, true>;
+	include?: Record<string, true | VertzQLIncludeEntry>;
+}
+/**
+* Encodes VertzQL parameters (select, include) into a base64url string
+* suitable for the `q=` query parameter.
+*
+* This is the client-side counterpart to `parseVertzQL` on the server.
+*/
+declare function encodeVertzQL(params: VertzQLParams): string;
+/**
+* Extracts `select` and `include` from a query object, encodes them as a
+* base64url `q` parameter, and returns the cleaned query.
+*
+* Returns `undefined` if the input is `undefined`.
+* Returns the query unchanged if no `select` or `include` is present.
+*/
+declare function resolveVertzQL(query?: Record<string, unknown>): Record<string, unknown> | undefined;
+export { unwrapOr, unwrap, resolveVertzQL, ok, matchError, isQueryDescriptor, isOk, isMutationDescriptor, isErr, err, encodeVertzQL, createMutationDescriptor, createErrorFromStatus, createDescriptor, VertzQLParams, UnprocessableEntityError, UnauthorizedError, StreamingRequestOptions, StreamingFormat, ServiceUnavailableError, RetryConfig, Result3 as Result, RequestOptions, RateLimitError, QueryDescriptor, OptimisticHandler, NotFoundError, MutationMeta, MutationDescriptor, ListResponse, InternalServerError, HooksConfig, GoneError, ForbiddenError, FetchResponse, FetchErrorType, FetchError2 as FetchError, FetchClientConfig, FetchClient, EntityQueryMeta, EntityErrorType, ConflictError, BadRequestError, AuthStrategy };

package/dist/index.js

@@ -516,9 +516,28 @@ function createErrorFromStatus(status, message, body) {
   }
   return new FetchError(message, status, body);
 }
+// src/vertzql.ts
+function encodeVertzQL(params) {
+  const json = JSON.stringify(params);
+  const b64 = btoa(json);
+  return b64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function resolveVertzQL(query) {
+  if (!query)
+    return;
+  const { select, include, ...rest } = query;
+  if (!select && !include)
+    return query;
+  const q = encodeVertzQL({
+    ...select ? { select } : {},
+    ...include ? { include } : {}
+  });
+  return { ...rest, q };
+}
 export {
   unwrapOr,
   unwrap,
+  resolveVertzQL,
   ok3 as ok,
   matchError,
   isQueryDescriptor,
@@ -526,6 +545,7 @@ export {
   isMutationDescriptor,
   isErr,
   err2 as err,
+  encodeVertzQL,
   createMutationDescriptor,
   createErrorFromStatus,
   createDescriptor,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertz/fetch",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "type": "module",
   "license": "MIT",
   "description": "Type-safe HTTP client for Vertz",
@@ -25,7 +25,7 @@
     "dist"
   ],
   "dependencies": {
-    "@vertz/errors": "^0.2.13"
+    "@vertz/errors": "^0.2.15"
   },
   "scripts": {
     "build": "bunup",