@shaxpir/duiduidui-models 1.26.0 → 1.26.1

package/dist/util/VersionTag.d.ts

@@ -0,0 +1,68 @@
+import { CompactDate } from '@shaxpir/shaxpir-common';
+declare enum VersionTagBrand {
+}
+/**
+ * A date-based version identifier in YYYYMMDDx format, where x is a
+ * lowercase letter (a-z) allowing multiple versions per day.
+ *
+ * Used for:
+ * - System prompt versions (e.g., "20260321e")
+ * - Tool definition versions (e.g., "20260321e")
+ * - Built-in database releases (e.g., "20260316a")
+ *
+ * Examples: "20260321a", "20260321b", "20250118a"
+ *
+ * Version tags sort lexicographically in chronological order.
+ */
+export type VersionTag = string & VersionTagBrand;
+export declare class VersionTagModel {
+    private static readonly PATTERN;
+    /**
+     * Validate and create a branded VersionTag from a string.
+     * Returns null if the format is invalid.
+     */
+    static from(value: string): VersionTag | null;
+    /**
+     * Validate and create a branded VersionTag from a string.
+     * Throws if the format is invalid.
+     */
+    static fromOrThrow(value: string): VersionTag;
+    /**
+     * Validate YYYYMMDDx format (where x is a lowercase letter a-z).
+     */
+    static isValid(value: string): boolean;
+    /**
+     * Compare two version tags.
+     * Returns: negative if a < b, 0 if equal, positive if a > b.
+     */
+    static compare(a: VersionTag, b: VersionTag): number;
+    /**
+     * Returns true if a comes before b chronologically.
+     */
+    static isBefore(a: VersionTag, b: VersionTag): boolean;
+    /**
+     * Returns true if a comes after b chronologically.
+     */
+    static isAfter(a: VersionTag, b: VersionTag): boolean;
+    /**
+     * Extract the date portion as a CompactDate (YYYYMMDD).
+     * Example: "20260321e" → "20260321"
+     */
+    static date(tag: VersionTag): CompactDate;
+    /**
+     * Extract the letter suffix.
+     * Example: "20260321e" → "e"
+     */
+    static letter(tag: VersionTag): string;
+    /**
+     * Generate the next version tag in sequence for the same day.
+     * Example: "20260321a" → "20260321b"
+     * Returns null if already at 'z'.
+     */
+    static next(tag: VersionTag): VersionTag | null;
+    /**
+     * Check if two version tags share the same date.
+     */
+    static isSameDay(a: VersionTag, b: VersionTag): boolean;
+}
+export {};

package/dist/util/VersionTag.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionTagModel = void 0;
+var VersionTagBrand;
+(function (VersionTagBrand) {
+})(VersionTagBrand || (VersionTagBrand = {}));
+class VersionTagModel {
+    /**
+     * Validate and create a branded VersionTag from a string.
+     * Returns null if the format is invalid.
+     */
+    static from(value) {
+        if (!VersionTagModel.isValid(value))
+            return null;
+        return value;
+    }
+    /**
+     * Validate and create a branded VersionTag from a string.
+     * Throws if the format is invalid.
+     */
+    static fromOrThrow(value) {
+        if (!VersionTagModel.isValid(value)) {
+            throw new Error(`Invalid VersionTag format: "${value}". Expected YYYYMMDDx (e.g., "20260321a")`);
+        }
+        return value;
+    }
+    /**
+     * Validate YYYYMMDDx format (where x is a lowercase letter a-z).
+     */
+    static isValid(value) {
+        return VersionTagModel.PATTERN.test(value);
+    }
+    /**
+     * Compare two version tags.
+     * Returns: negative if a < b, 0 if equal, positive if a > b.
+     */
+    static compare(a, b) {
+        return a.localeCompare(b);
+    }
+    /**
+     * Returns true if a comes before b chronologically.
+     */
+    static isBefore(a, b) {
+        return VersionTagModel.compare(a, b) < 0;
+    }
+    /**
+     * Returns true if a comes after b chronologically.
+     */
+    static isAfter(a, b) {
+        return VersionTagModel.compare(a, b) > 0;
+    }
+    /**
+     * Extract the date portion as a CompactDate (YYYYMMDD).
+     * Example: "20260321e" → "20260321"
+     */
+    static date(tag) {
+        return tag.substring(0, 8);
+    }
+    /**
+     * Extract the letter suffix.
+     * Example: "20260321e" → "e"
+     */
+    static letter(tag) {
+        return tag.charAt(8);
+    }
+    /**
+     * Generate the next version tag in sequence for the same day.
+     * Example: "20260321a" → "20260321b"
+     * Returns null if already at 'z'.
+     */
+    static next(tag) {
+        const letter = VersionTagModel.letter(tag);
+        if (letter === 'z')
+            return null;
+        const nextLetter = String.fromCharCode(letter.charCodeAt(0) + 1);
+        return (tag.substring(0, 8) + nextLetter);
+    }
+    /**
+     * Check if two version tags share the same date.
+     */
+    static isSameDay(a, b) {
+        return a.substring(0, 8) === b.substring(0, 8);
+    }
+}
+exports.VersionTagModel = VersionTagModel;
+VersionTagModel.PATTERN = /^\d{8}[a-z]$/;

package/dist/util/index.d.ts

@@ -8,3 +8,4 @@ export * from './PinyinValidator';
 export * from './SearchPreprocessor';
 export * from './SearchTokenizer';
 export * from './SenseRankEncoder';
+export * from './VersionTag';

package/dist/util/index.js

@@ -25,3 +25,4 @@ __exportStar(require("./PinyinValidator"), exports);
 __exportStar(require("./SearchPreprocessor"), exports);
 __exportStar(require("./SearchTokenizer"), exports);
 __exportStar(require("./SenseRankEncoder"), exports);
+__exportStar(require("./VersionTag"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shaxpir/duiduidui-models",
-  "version": "1.26.0",
+  "version": "1.26.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/shaxpir/duiduidui-models"
@@ -18,7 +18,7 @@
   "dependencies": {
     "@shaxpir/duiduidui-models": "^1.10.3",
     "@shaxpir/sharedb": "^6.0.6",
-    "@shaxpir/shaxpir-common": "^1.4.1",
+    "@shaxpir/shaxpir-common": "^1.4.2",
     "ot-json1": "1.0.1",
     "ot-text-unicode": "4.0.0",
     "reconnecting-websocket": "4.4.0"