@naturalcycles/js-lib 15.36.0 → 15.38.0

package/dist/json-schema/jsonSchemaBuilder.d.ts

@@ -1,4 +1,4 @@
-import type { AnyObject, BaseDBEntity, IsoDate, IsoDateTime, UnixTimestamp } from '../types.js';
+import { type AnyObject, type BaseDBEntity, type IsoDate, type IsoDateTime, type UnixTimestamp } from '../types.js';
 import type { JsonSchema, JsonSchemaAllOf, JsonSchemaAny, JsonSchemaArray, JsonSchemaBoolean, JsonSchemaConst, JsonSchemaEnum, JsonSchemaNull, JsonSchemaNumber, JsonSchemaObject, JsonSchemaOneOf, JsonSchemaRef, JsonSchemaString, JsonSchemaTuple } from './jsonSchema.model.js';
 export interface JsonSchemaBuilder<T = unknown> {
     build: () => JsonSchema<T>;
@@ -9,7 +9,7 @@ export interface JsonSchemaBuilder<T = unknown> {
  */
 export declare const j: {
     any<T = unknown>(): JsonSchemaAnyBuilder<T, JsonSchemaAny<T>, false>;
-    const<T = unknown>(value: T): JsonSchemaAnyBuilder<T, JsonSchemaConst<T>, false>;
+    const<T extends string | number | boolean | null>(value: T): JsonSchemaAnyBuilder<T, JsonSchemaConst<T>, false>;
     null(): JsonSchemaAnyBuilder<null, JsonSchemaNull, false>;
     ref<T = unknown>($ref: string): JsonSchemaAnyBuilder<T, JsonSchemaRef<T>, false>;
     enum<T = unknown>(enumValues: T[]): JsonSchemaAnyBuilder<T, JsonSchemaEnum<T>, false>;
@@ -20,6 +20,7 @@ export declare const j: {
     unixTimestamp(): JsonSchemaNumberBuilder<UnixTimestamp, false>;
     unixTimestamp2000(): JsonSchemaNumberBuilder<UnixTimestamp, false>;
     string<T extends string = string>(): JsonSchemaStringBuilder<T, false>;
+    jwt(): JsonSchemaStringBuilder<string, false>;
     /**
      * Accepts only the `YYYY-MM-DD` shape from all ISO 8601 variants.
      */
@@ -125,6 +126,7 @@ export declare class JsonSchemaStringBuilder<T extends string = string, Opt exte
      * and optionally end with either a `Z` or a `+/-hh:mm` timezone part.
      */
     isoDateTime(): JsonSchemaStringBuilder<IsoDateTime>;
+    jwt(): this;
     private transformModify;
 }
 export declare class JsonSchemaObjectBuilder<T extends AnyObject, Opt extends boolean = false> extends JsonSchemaAnyBuilder<T, JsonSchemaObject<T>, Opt> {

package/dist/json-schema/jsonSchemaBuilder.js

@@ -1,6 +1,7 @@
 import { _uniq } from '../array/array.util.js';
 import { _deepCopy } from '../object/object.util.js';
 import { _sortObject } from '../object/sortObject.js';
+import { JWT_REGEX, } from '../types.js';
 import { JSON_SCHEMA_ORDER } from './jsonSchema.cnst.js';
 import { mergeJsonSchemaObjects } from './jsonSchema.util.js';
 /**
@@ -56,6 +57,9 @@ export const j = {
     string() {
         return new JsonSchemaStringBuilder();
     },
+    jwt() {
+        return new JsonSchemaStringBuilder().jwt();
+    },
     /**
      * Accepts only the `YYYY-MM-DD` shape from all ISO 8601 variants.
      */
@@ -291,6 +295,9 @@ export class JsonSchemaStringBuilder extends JsonSchemaAnyBuilder {
     isoDateTime() {
         return this.format('IsoDateTime').branded().description('IsoDateTime');
     }
+    jwt() {
+        return this.regex(JWT_REGEX);
+    }
     transformModify(t, add) {
         if (add) {
             this.schema.transform = _uniq([...(this.schema.transform || []), t]);

package/dist/types.d.ts

@@ -266,6 +266,7 @@ export type ShortBoolean = '1';
 export type Base64String = string;
 export type Base64UrlString = string;
 export type JWTString = string;
+export declare const JWT_REGEX: RegExp;
 export type SemVerString = string;
 /**
  * Named type for JSON.parse / JSON.stringify second argument

package/dist/types.js

@@ -20,6 +20,7 @@ export const _passUndefinedMapper = () => undefined;
 export const _noop = (..._args) => undefined;
 export const _passthroughPredicate = () => true;
 export const _passNothingPredicate = () => false;
+export const JWT_REGEX = /^[\w-]+\.[\w-]+\.[\w-]+$/;
 /**
  * Like _stringMapValues, but values are sorted.
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.36.0",
+  "version": "15.38.0",
   "dependencies": {
     "tslib": "^2",
     "undici": "^7",

package/src/json-schema/jsonSchemaBuilder.ts

@@ -1,7 +1,15 @@
 import { _uniq } from '../array/array.util.js'
 import { _deepCopy } from '../object/object.util.js'
 import { _sortObject } from '../object/sortObject.js'
-import type { AnyObject, BaseDBEntity, IsoDate, IsoDateTime, UnixTimestamp } from '../types.js'
+import {
+  type AnyObject,
+  type BaseDBEntity,
+  type IsoDate,
+  type IsoDateTime,
+  JWT_REGEX,
+  type JWTString,
+  type UnixTimestamp,
+} from '../types.js'
 import { JSON_SCHEMA_ORDER } from './jsonSchema.cnst.js'
 import type {
   JsonSchema,
@@ -35,7 +43,7 @@ export const j = {
   any<T = unknown>() {
     return new JsonSchemaAnyBuilder<T, JsonSchemaAny<T>>({})
   },
-  const<T = unknown>(value: T) {
+  const<T extends string | number | boolean | null>(value: T) {
     return new JsonSchemaAnyBuilder<T, JsonSchemaConst<T>>({
       const: value,
     })
@@ -82,6 +90,9 @@ export const j = {
   string<T extends string = string>() {
     return new JsonSchemaStringBuilder<T>()
   },
+  jwt() {
+    return new JsonSchemaStringBuilder<JWTString>().jwt()
+  },
 
   /**
    * Accepts only the `YYYY-MM-DD` shape from all ISO 8601 variants.
@@ -384,6 +395,10 @@ export class JsonSchemaStringBuilder<
     return this.format('IsoDateTime').branded<IsoDateTime>().description('IsoDateTime')
   }
 
+  jwt(): this {
+    return this.regex(JWT_REGEX)
+  }
+
   private transformModify(t: 'trim' | 'toLowerCase' | 'toUpperCase', add: boolean): this {
     if (add) {
       this.schema.transform = _uniq([...(this.schema.transform || []), t])

package/src/types.ts

@@ -335,6 +335,7 @@ export type ShortBoolean = '1'
 export type Base64String = string
 export type Base64UrlString = string
 export type JWTString = string
+export const JWT_REGEX = /^[\w-]+\.[\w-]+\.[\w-]+$/
 
 export type SemVerString = string