@cyberskill/shared 3.12.0 → 3.14.0

package/dist/util/storage/storage-envelope.js

@@ -0,0 +1,18 @@
+//#region src/util/storage/storage-envelope.ts
+function e(e) {
+	return typeof e == "object" && !!e && "__isTtlEnvelope" in e;
+}
+function t(e) {
+	return !!(e.expiresAt && Date.now() > e.expiresAt);
+}
+function n(e, t) {
+	return {
+		__isTtlEnvelope: !0,
+		expiresAt: Date.now() + t,
+		value: e
+	};
+}
+//#endregion
+export { n as createTtlEnvelope, t as isExpiredEnvelope, e as isTtlEnvelope };
+
+//# sourceMappingURL=storage-envelope.js.map

package/dist/util/storage/storage-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-envelope.js","names":[],"sources":["../../../src/util/storage/storage-envelope.ts"],"sourcesContent":["/**\n * Represents a wrapped storage value that includes Time-to-Live (TTL) expiration metadata.\n * @since 3.13.0\n */\nexport interface I_StorageEnvelope<T> {\n    __isTtlEnvelope: true;\n    expiresAt?: number;\n    value: T;\n}\n\n/**\n * Checks whether an unknown storage payload is a valid TTL envelope.\n * @since 3.13.0\n */\nexport function isTtlEnvelope<T>(payload: unknown): payload is I_StorageEnvelope<T> {\n    return (\n        typeof payload === 'object'\n        && payload !== null\n        && '__isTtlEnvelope' in payload\n    );\n}\n\n/**\n * Checks if a TTL envelope has expired based on its timestamp.\n * Returns true if the envelope has an expiration time and that time has passed.\n * @since 3.13.0\n */\nexport function isExpiredEnvelope<T>(envelope: I_StorageEnvelope<T>): boolean {\n    return Boolean(envelope.expiresAt && Date.now() > envelope.expiresAt);\n}\n\n/**\n * Wraps a value in a TTL envelope with the specified expiration duration.\n * @since 3.13.0\n */\nexport function createTtlEnvelope<T>(value: T, ttlMs: number): I_StorageEnvelope<T> {\n    return {\n        __isTtlEnvelope: true,\n        expiresAt: Date.now() + ttlMs,\n        value,\n    };\n}\n"],"mappings":";AAcA,SAAgB,EAAiB,GAAmD;AAChF,QACI,OAAO,KAAY,cAChB,KACA,qBAAqB;;AAShC,SAAgB,EAAqB,GAAyC;AAC1E,QAAO,GAAQ,EAAS,aAAa,KAAK,KAAK,GAAG,EAAS;;AAO/D,SAAgB,EAAqB,GAAU,GAAqC;AAChF,QAAO;EACH,iBAAiB;EACjB,WAAW,KAAK,KAAK,GAAG;EACxB;EACH"}

package/dist/util/string/index.d.ts

@@ -1 +1,5 @@
-export {}
+/**
+ * Re-exports all string manipulation utilities and types.
+ */
+export * from './string.type.js';
+export * from './string.util.js';

package/dist/util/validate/index.d.ts

@@ -1 +1,4 @@
-export {}
+/**
+ * Re-exports all validation utilities.
+ */
+export * from './validate.util.js';

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@cyberskill/shared",
     "type": "module",
-    "version": "3.12.0",
+    "version": "3.14.0",
     "description": "CyberSkill Shared",
     "author": "Stephen Cheng",
     "license": "MIT",
@@ -107,6 +107,9 @@
             "import": "./dist/node/mongo/index.js",
             "default": "./dist/node/mongo/index.js"
         },
+        "./node/mongo/types": {
+            "types": "./dist/node/mongo/index.d.ts"
+        },
         "./node/package": {
             "types": "./dist/node/package/index.d.ts",
             "import": "./dist/node/package/index.js",
@@ -157,6 +160,11 @@
             "import": "./dist/react/i18next/index.js",
             "default": "./dist/react/i18next/index.js"
         },
+        "./react/i18next/server": {
+            "types": "./dist/react/i18next/i18next.server.d.ts",
+            "import": "./dist/react/i18next/i18next.server.js",
+            "default": "./dist/react/i18next/i18next.server.js"
+        },
         "./react/loading": {
             "types": "./dist/react/loading/index.d.ts",
             "import": "./dist/react/loading/index.js",
@@ -172,6 +180,11 @@
             "import": "./dist/react/next-intl/index.js",
             "default": "./dist/react/next-intl/index.js"
         },
+        "./react/next-intl/server": {
+            "types": "./dist/react/next-intl/next-intl.server.d.ts",
+            "import": "./dist/react/next-intl/next-intl.server.js",
+            "default": "./dist/react/next-intl/next-intl.server.js"
+        },
         "./react/storage": {
             "types": "./dist/react/storage/index.d.ts",
             "import": "./dist/react/storage/index.js",
@@ -192,6 +205,9 @@
             "import": "./dist/typescript/index.js",
             "default": "./dist/typescript/index.js"
         },
+        "./types": {
+            "types": "./dist/typescript/index.d.ts"
+        },
         "./util": {
             "types": "./dist/util/index.d.ts",
             "import": "./dist/util/index.js",
@@ -229,14 +245,14 @@
         "typecheck": "tsc --noEmit"
     },
     "dependencies": {
-        "@antfu/eslint-config": "7.7.3",
+        "@antfu/eslint-config": "8.0.0",
         "@apollo/client": "4.1.6",
         "@apollo/client-integration-nextjs": "0.14.4",
         "@apollo/server": "5.5.0",
         "@as-integrations/express5": "1.1.2",
-        "@dotenvx/dotenvx": "1.58.0",
+        "@dotenvx/dotenvx": "1.59.1",
         "@eddeee888/gcg-typescript-resolver-files": "0.15.0",
-        "@eslint-react/eslint-plugin": "2.13.0",
+        "@eslint-react/eslint-plugin": "3.0.0",
         "@graphql-codegen/cli": "6.2.1",
         "@graphql-codegen/client-preset": "5.2.4",
         "@nestjs/common": "11.1.17",
@@ -252,12 +268,12 @@
         "cors": "2.8.6",
         "date-fns": "4.1.0",
         "envalid": "8.1.1",
-        "eslint-config-next": "16.2.1",
+        "eslint-config-next": "16.2.2",
         "eslint-plugin-format": "2.0.1",
         "eslint-plugin-react-hooks": "7.0.1",
         "eslint-plugin-react-refresh": "0.5.2",
         "express": "5.2.1",
-        "express-rate-limit": "8.3.1",
+        "express-rate-limit": "8.3.2",
         "express-session": "1.19.0",
         "express-useragent": "2.1.0",
         "extract-files": "13.0.0",
@@ -267,18 +283,19 @@
         "graphql-upload": "17.0.0",
         "graphql-ws": "6.0.8",
         "helmet": "8.1.0",
-        "i18next": "25.10.10",
+        "i18next": "26.0.3",
         "migrate-mongo": "14.0.7",
         "mongodb": "7.1.1",
         "mongoose": "9.3.3",
         "mongoose-aggregate-paginate-v2": "1.1.4",
         "mongoose-paginate-v2": "1.9.4",
-        "next-intl": "4.8.3",
+        "next-intl": "4.8.4",
+        "path-to-regexp": "8.4.1",
         "qs": "6.15.0",
         "react": "19.2.4",
         "react-dom": "19.2.4",
         "react-hot-toast": "2.6.0",
-        "react-i18next": "16.6.6",
+        "react-i18next": "17.0.2",
         "rxjs": "7.8.2",
         "ws": "8.20.0",
         "yargs": "18.0.0"
@@ -286,8 +303,9 @@
     "devDependencies": {
         "@commitlint/cli": "20.5.0",
         "@commitlint/config-conventional": "20.5.0",
+        "@cyclonedx/cyclonedx-npm": "4.2.1",
         "@eslint/config-inspector": "1.5.0",
-        "@next/eslint-plugin-next": "16.2.1",
+        "@next/eslint-plugin-next": "16.2.2",
         "@semantic-release/changelog": "6.0.3",
         "@semantic-release/git": "10.0.1",
         "@semantic-release/github": "12.0.6",
@@ -314,10 +332,11 @@
         "@types/yargs": "17.0.35",
         "@vitest/browser": "4.1.2",
         "@vitest/coverage-istanbul": "4.1.2",
-        "conventional-changelog-conventionalcommits": "9.3.0",
+        "conventional-changelog-conventionalcommits": "9.3.1",
         "eslint": "10.1.0",
         "glob": "13.0.6",
         "jsdom": "29.0.1",
+        "license-checker": "25.0.1",
         "lint-staged": "16.4.0",
         "node-modules-inspector": "1.4.2",
         "npm-run-all2": "8.0.4",
@@ -337,7 +356,9 @@
     },
     "pnpm": {
         "overrides": {
-            "minimatch": ">=10.2.4"
+            "lodash": ">=4.17.23",
+            "minimatch": ">=10.2.4",
+            "path-to-regexp": "8.4.1"
         }
     }
 }

package/dist/node/mongo/mongo.type.js

@@ -1,8 +0,0 @@
-import { Collection as e, Db as t } from "mongodb";
-import { Document as n, Model as r } from "mongoose";
-//#region src/node/mongo/mongo.type.ts
-var i = class extends t {}, a = class extends n {}, o = class extends r {}, s = class extends e {};
-//#endregion
-export { s as C_Collection, i as C_Db, a as C_Document, o as C_Model };
-
-//# sourceMappingURL=mongo.type.js.map

package/dist/node/mongo/mongo.type.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mongo.type.js","names":[],"sources":["../../../src/node/mongo/mongo.type.ts"],"sourcesContent":["import type {\n    DeleteResult,\n    Filter,\n    InsertManyResult,\n    InsertOneResult,\n    OptionalUnlessRequiredId,\n    UpdateResult,\n    WithId,\n} from 'mongodb';\nimport type {\n    AggregatePaginateModel,\n    AggregatePaginateResult,\n    ClientSession,\n    ErrorHandlingMiddlewareFunction,\n    ErrorHandlingMiddlewareWithOption,\n    InsertManyOptions,\n    PaginateModel,\n    PaginateOptions,\n    PaginateResult,\n    PipelineStage,\n    PopulateOption,\n    PopulateOptions,\n    PostMiddlewareFunction,\n    PreMiddlewareFunction,\n    PreSaveMiddlewareFunction,\n    ProjectionType,\n    QueryFilter,\n    QueryOptions,\n    QueryWithHelpers,\n    Schema,\n    SchemaDefinition,\n    UpdateQuery,\n    UpdateWriteOpResult,\n} from 'mongoose';\nimport type mongoose from 'mongoose';\n\nimport { Collection, Db } from 'mongodb';\nimport {\n    Document,\n    Model,\n} from 'mongoose';\n\nexport class C_Db extends Db { }\n\nexport type T_Filter<T> = Filter<T>;\n\nexport type T_InsertOneResult<T> = InsertOneResult<T>;\n\nexport type T_InsertManyResult<T> = InsertManyResult<T>;\n\nexport type T_UpdateResult = UpdateResult | UpdateWriteOpResult;\n\nexport type T_DeleteResult = DeleteResult;\n\nexport type T_WithId<T> = WithId<T>;\n\nexport type T_OptionalUnlessRequiredId<T> = OptionalUnlessRequiredId<T>;\n\nexport class C_Document extends Document { }\n\nexport class C_Model extends Model { }\n\nexport class C_Collection<\n    T extends Partial<C_Document>,\n> extends Collection<T> { }\n\nexport interface I_ExtendedModel<T extends Partial<C_Document>>\n    extends Model<T>, PaginateModel<T>,\n    AggregatePaginateModel<T> { }\n\nexport type T_QueryFilter<T> = QueryFilter<T>;\n\nexport type T_ProjectionType<T> = ProjectionType<T>;\n\nexport type T_QueryOptions<T> = QueryOptions<T>;\n\nexport type T_PaginateOptions = PaginateOptions;\n\nexport type T_PopulateOption = PopulateOption;\n\nexport type T_PopulateOptions = PopulateOptions;\n\nexport type T_PipelineStage = PipelineStage;\n\nexport type T_PaginateResult<T> = PaginateResult<T>;\n\nexport type T_AggregatePaginateResult<T> = AggregatePaginateResult<T>;\n\nexport type T_InsertManyOptions = InsertManyOptions;\n\nexport type T_UpdateQuery<T> = UpdateQuery<T>;\n\nexport type T_QueryWithHelpers<T> = QueryWithHelpers<T, T>;\n\nexport type T_PreMiddlewareFunction<T> = PreMiddlewareFunction<T>;\n\nexport type T_PreSaveMiddlewareFunction<T> = PreSaveMiddlewareFunction<T>;\n\nexport type T_PostMiddlewareFunction<T> = PostMiddlewareFunction<T>;\n\nexport type T_ErrorHandlingMiddlewareFunction<T> = ErrorHandlingMiddlewareFunction<T>;\n\nexport type T_ErrorHandlingMiddlewareWithOption<T> = ErrorHandlingMiddlewareWithOption<T>;\n\nexport type T_MongooseSchema<T> = mongoose.Schema<T>;\n\nexport type T_Input_MongooseSchema<T> = SchemaDefinition<T>;\n\nexport type T_MongoosePlugin = (schema: Schema, options?: Record<string, unknown>) => void;\n\nexport interface I_GenericDocument extends Partial<C_Document> {\n    id: string;\n    isDel: boolean;\n    createdAt: string | Date;\n    updatedAt: string | Date;\n}\n\nexport type T_Omit_Create = 'id' | 'isDel' | 'createdAt' | 'updatedAt';\n\nexport type T_Omit_Update = 'id' | 'createdAt' | 'updatedAt';\n\ninterface I_VirtualNestedOptions {\n    [key: string]: I_VirtualNestedOptions | number | string | boolean;\n}\n\n/**\n * Function type for dynamically determining the reference model name.\n * Can return either a string (model name) or an enum value that represents the model.\n * The function can also return undefined, which will be handled gracefully.\n * This allows for optional properties in documents without requiring non-null assertions.\n *\n * @template T - The document type\n * @template R - The return type (string or enum)\n */\ntype T_DynamicRefFunction<T = unknown, R extends string = string> = (doc: T) => R | undefined;\n\ninterface I_VirtualBaseOptions {\n    localField: string;\n    foreignField: string;\n    count?: boolean;\n    justOne?: boolean;\n    options?: I_VirtualNestedOptions;\n}\n\ninterface I_VirtualOptions extends I_VirtualBaseOptions {\n    ref: string;\n}\n\nexport interface I_DynamicVirtualOptions<T, R extends string = string> extends I_VirtualBaseOptions {\n    ref: T_DynamicRefFunction<T, R>;\n}\n\nexport type T_VirtualOptions<T, R extends string = string> = I_VirtualOptions | I_DynamicVirtualOptions<T, R>;\n\nexport interface I_DynamicVirtualConfig<T, R extends string = string> {\n    name: string;\n    options: I_DynamicVirtualOptions<T, R>;\n}\n\ninterface I_MongooseOptions<T, R extends string = string> {\n    mongoose: typeof mongoose;\n    virtuals?: {\n        name: keyof T | string;\n        options?: T_VirtualOptions<T, R>;\n        get?: (this: T) => void;\n    }[];\n}\n\nexport interface I_CreateSchemaOptions<T, R extends string = string>\n    extends I_MongooseOptions<T, R> {\n    schema: T_Input_MongooseSchema<T>;\n    standalone?: boolean;\n}\n\nexport type T_MongooseMiddlewareMethod = string | RegExp;\n\nexport type T_MongooseMiddlewarePreFunction<T> = T_PreMiddlewareFunction<T> & T_PreSaveMiddlewareFunction<T>;\n\nexport type T_MongooseMiddlewarePostFunction<T> = T_PostMiddlewareFunction<T> & T_ErrorHandlingMiddlewareFunction<T> & T_ErrorHandlingMiddlewareWithOption<T>;\n\nexport interface I_MongooseModelMiddleware<T extends Partial<C_Document>> {\n    method: T_MongooseMiddlewareMethod;\n    pre?: T_MongooseMiddlewarePreFunction<T & T_QueryWithHelpers<T>>;\n    post?: T_MongooseMiddlewarePostFunction<T>;\n}\n\nexport interface I_CreateModelOptions<T extends Partial<C_Document>, R extends string = string>\n    extends I_MongooseOptions<T, R> {\n    schema: T_Input_MongooseSchema<T>;\n    name: string;\n    pagination?: boolean;\n    aggregate?: boolean;\n    middlewares?: I_MongooseModelMiddleware<T>[];\n}\n\nexport type T_Input_Populate = string | string[] | T_PopulateOptions | T_PopulateOptions[];\n\nexport interface I_PaginateOptionsWithPopulate\n    extends T_PaginateOptions,\n    Omit<T_PopulateOption, 'populate'> {\n    populate?: T_Input_Populate;\n}\n\nexport interface I_Input_FindOne<T> extends T_PopulateOption {\n    filter: T_QueryFilter<T>;\n    projection?: T_ProjectionType<T>;\n    options?: T_QueryOptions<T>;\n}\n\nexport interface I_Input_FindAll<T> extends T_PopulateOption {\n    filter: T_QueryFilter<T>;\n    projection?: T_ProjectionType<T>;\n    options?: T_QueryOptions<T>;\n}\n\nexport interface I_Input_FindPaging<T = undefined> {\n    filter?: T_QueryFilter<T>;\n    options?: I_PaginateOptionsWithPopulate;\n};\n\nexport interface I_Input_FindPagingAggregate {\n    pipeline: T_PipelineStage[];\n    options?: I_PaginateOptionsWithPopulate;\n}\n\nexport interface I_Input_CreateOne<T> {\n    doc: T;\n}\n\nexport interface I_Input_CreateMany<T> {\n    docs: T[];\n}\n\nexport interface I_UpdateOptionsExtended extends Omit<QueryOptions, 'session'> {\n    session?: ClientSession;\n}\n\nexport interface I_Input_UpdateOne<T> extends T_PopulateOption {\n    filter: T_QueryFilter<T>;\n    update: T_UpdateQuery<T>;\n    options?: I_UpdateOptionsExtended;\n}\n\nexport interface I_Input_UpdateMany<T> extends T_PopulateOption {\n    filter: T_QueryFilter<T>;\n    update: T_UpdateQuery<T>;\n    options?: I_UpdateOptionsExtended;\n}\n\nexport interface I_DeleteOptionsExtended extends Omit<QueryOptions, 'session'> {\n    session?: ClientSession;\n}\n\nexport interface I_Input_DeleteOne<T> {\n    filter: T_QueryFilter<T>;\n    options?: I_DeleteOptionsExtended;\n}\n\nexport interface I_Input_DeleteMany<T> {\n    filter: T_QueryFilter<T>;\n    options?: I_DeleteOptionsExtended;\n}\n\nexport interface I_InputSlug<T> {\n    field: string;\n    filter?: T_QueryFilter<T>;\n    haveHistory?: boolean;\n}\n\nexport interface I_Input_CreateSlug<T> extends I_InputSlug<T> {\n    from: T;\n}\n\nexport interface I_Input_CheckSlug<T> extends I_InputSlug<T> {\n    slug: string;\n    from: T;\n}\n\nexport interface I_Input_GenerateSlug<T> extends I_InputSlug<T> {\n    slug: string;\n    isObject: boolean;\n    haveHistory?: boolean;\n}\n"],"mappings":";;;AA0CA,IAAa,IAAb,cAA0B,EAAG,IAgBhB,IAAb,cAAgC,EAAS,IAE5B,IAAb,cAA6B,EAAM,IAEtB,IAAb,cAEU,EAAc"}

package/dist/node_modules/.pnpm/vitest@4.1.2_@types_node@25.5.0_jsdom@29.0.1_@noble_hashes@1.8.0__vite@8.0.3_@types_nod_0827261ede788764a5d99ac6bdf44bde/node_modules/vitest/dist/config.js

@@ -1,8 +0,0 @@
-//#region node_modules/.pnpm/vitest@4.1.2_@types+node@25.5.0_jsdom@29.0.1_@noble+hashes@1.8.0__vite@8.0.3_@types+nod_0827261ede788764a5d99ac6bdf44bde/node_modules/vitest/dist/config.js
-function e(e) {
-	return e;
-}
-//#endregion
-export { e as defineConfig };
-
-//# sourceMappingURL=config.js.map

package/dist/node_modules/.pnpm/vitest@4.1.2_@types_node@25.5.0_jsdom@29.0.1_@noble_hashes@1.8.0__vite@8.0.3_@types_nod_0827261ede788764a5d99ac6bdf44bde/node_modules/vitest/dist/config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.js","names":[],"sources":["../../../../../../../node_modules/.pnpm/vitest@4.1.2_@types+node@25.5.0_jsdom@29.0.1_@noble+hashes@1.8.0__vite@8.0.3_@types+nod_0827261ede788764a5d99ac6bdf44bde/node_modules/vitest/dist/config.js"],"sourcesContent":["export { c as configDefaults, a as coverageConfigDefaults, d as defaultExclude, b as defaultInclude } from './chunks/defaults.9aQKnqFk.js';\nexport { mergeConfig } from 'vite';\nexport { d as defaultBrowserPort } from './chunks/constants.CPYnjOGj.js';\nimport 'node:os';\nimport './chunks/env.D4Lgay0q.js';\nimport 'std-env';\n\nfunction defineConfig(config) {\n\treturn config;\n}\nfunction defineProject(config) {\n\treturn config;\n}\n\nexport { defineConfig, defineProject };\n"],"x_google_ignoreList":[0],"mappings":";AAOA,SAAS,EAAa,GAAQ;AAC7B,QAAO"}

package/dist/src/config/commitlint/index.d.ts

@@ -1,5 +0,0 @@
-declare const _default: {
-    extends: string[];
-    ignores: ((message: string) => boolean)[];
-};
-export default _default;

package/dist/src/config/env/index.d.ts

@@ -1,3 +0,0 @@
-export * from './env.constant.js';
-export * from './env.type.js';
-export * from './env.util.js';