pino-ulid 2.12.2

package/dist/ulid.d.cts

@@ -0,0 +1,49 @@
+import { PRNG, ULID, ULIDFactory } from "./types.js";
+/**
+ * Decode time from a ULID
+ * @param id The ULID
+ * @returns The decoded timestamp
+ */
+export declare function decodeTime(id: ULID): number;
+/**
+ * Detect the best PRNG (pseudo-random number generator)
+ * @param root The root to check from (global/window)
+ * @returns The PRNG function
+ */
+export declare function detectPRNG(root?: any): PRNG;
+export declare function encodeRandom(len: number, prng: PRNG): string;
+/**
+ * Encode the time portion of a ULID
+ * @param now The current timestamp
+ * @param len Length to generate
+ * @returns The encoded time
+ */
+export declare function encodeTime(now: number, len?: number): string;
+/**
+ * Check if a ULID is valid
+ * @param id The ULID to test
+ * @returns True if valid, false otherwise
+ * @example
+ *   isValid("01HNZX8JGFACFA36RBXDHEQN6E"); // true
+ *   isValid(""); // false
+ */
+export declare function isValid(id: string): boolean;
+/**
+ * Create a ULID factory to generate monotonically-increasing
+ *  ULIDs
+ * @param prng The PRNG to use
+ * @returns A ulid factory
+ * @example
+ *  const ulid = monotonicFactory();
+ *  ulid(); // "01HNZXD07M5CEN5XA66EMZSRZW"
+ */
+export declare function monotonicFactory(prng?: PRNG): ULIDFactory;
+/**
+ * Generate a ULID
+ * @param seedTime Optional time seed
+ * @param prng Optional PRNG function
+ * @returns A ULID string
+ * @example
+ *  ulid(); // "01HNZXD07M5CEN5XA66EMZSRZW"
+ */
+export declare function ulid(seedTime?: number, prng?: PRNG): ULID;

package/dist/ulid.d.ts

@@ -0,0 +1,49 @@
+import { PRNG, ULID, ULIDFactory } from "./types.js";
+/**
+ * Decode time from a ULID
+ * @param id The ULID
+ * @returns The decoded timestamp
+ */
+export declare function decodeTime(id: ULID): number;
+/**
+ * Detect the best PRNG (pseudo-random number generator)
+ * @param root The root to check from (global/window)
+ * @returns The PRNG function
+ */
+export declare function detectPRNG(root?: any): PRNG;
+export declare function encodeRandom(len: number, prng: PRNG): string;
+/**
+ * Encode the time portion of a ULID
+ * @param now The current timestamp
+ * @param len Length to generate
+ * @returns The encoded time
+ */
+export declare function encodeTime(now: number, len?: number): string;
+/**
+ * Check if a ULID is valid
+ * @param id The ULID to test
+ * @returns True if valid, false otherwise
+ * @example
+ *   isValid("01HNZX8JGFACFA36RBXDHEQN6E"); // true
+ *   isValid(""); // false
+ */
+export declare function isValid(id: string): boolean;
+/**
+ * Create a ULID factory to generate monotonically-increasing
+ *  ULIDs
+ * @param prng The PRNG to use
+ * @returns A ulid factory
+ * @example
+ *  const ulid = monotonicFactory();
+ *  ulid(); // "01HNZXD07M5CEN5XA66EMZSRZW"
+ */
+export declare function monotonicFactory(prng?: PRNG): ULIDFactory;
+/**
+ * Generate a ULID
+ * @param seedTime Optional time seed
+ * @param prng Optional PRNG function
+ * @returns A ULID string
+ * @example
+ *  ulid(); // "01HNZXD07M5CEN5XA66EMZSRZW"
+ */
+export declare function ulid(seedTime?: number, prng?: PRNG): ULID;

package/dist/utils.d.cts

@@ -0,0 +1,3 @@
+import { PRNG } from "./types.js";
+export declare function randomChar(prng: PRNG): string;
+export declare function replaceCharAt(str: string, index: number, char: string): string;

package/dist/utils.d.ts

@@ -0,0 +1,3 @@
+import { PRNG } from "./types.js";
+export declare function randomChar(prng: PRNG): string;
+export declare function replaceCharAt(str: string, index: number, char: string): string;

package/dist/uuid.d.cts

@@ -0,0 +1,14 @@
+import { UUID } from "crypto";
+import { ULID } from "./types.js";
+/**
+ * Convert a ULID to a UUID
+ * @param ulid The ULID to convert
+ * @returns A UUID string
+ */
+export declare function ulidToUUID(ulid: ULID): UUID;
+/**
+ * Convert a UUID to a ULID
+ * @param uuid The UUID to convert
+ * @returns A ULID string
+ */
+export declare function uuidToULID(uuid: string): ULID;

package/dist/uuid.d.ts

@@ -0,0 +1,14 @@
+import { UUID } from "crypto";
+import { ULID } from "./types.js";
+/**
+ * Convert a ULID to a UUID
+ * @param ulid The ULID to convert
+ * @returns A UUID string
+ */
+export declare function ulidToUUID(ulid: ULID): UUID;
+/**
+ * Convert a UUID to a ULID
+ * @param uuid The UUID to convert
+ * @returns A ULID string
+ */
+export declare function uuidToULID(uuid: string): ULID;

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "pino-ulid",
+  "version": "2.12.2",
+  "description": "A universally-unique, lexicographically-sortable, identifier generator",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": {
+        "require": "./dist/index.d.cts",
+        "default": "./dist/index.d.ts"
+      },
+      "node": {
+        "require": "./dist/node/index.cjs",
+        "default": "./dist/node/index.js"
+      },
+      "default": {
+        "require": "./dist/browser/index.cjs",
+        "default": "./dist/browser/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "dist/node/index.cjs",
+  "module": "./dist/node/index.js",
+  "browser": {
+    "./dist/node/index.cjs": "./dist/browser/index.cjs",
+    "./dist/node/index.js": "./dist/browser/index.js"
+  },
+  "react-native": "./dist/browser/index.cjs",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "bin": "./dist/cli.js",
+  "scripts": {
+    "bench": "npm run build && node test/benchmark.js",
+    "build": "npm run build:node:cjs && npm run build:node:esm && npm run build:browser:cjs && npm run build:browser:esm && npm run build:cli && npm run build:types",
+    "build:browser:cjs": "FMT=cjs ENV=browser rollup -c --name ulidx",
+    "build:browser:esm": "FMT=esm ENV=browser rollup -c --name ulidx",
+    "build:cli": "FMT=esm ENV=cli rollup -c && chmod +x ./dist/cli.js",
+    "build:node:cjs": "FMT=cjs ENV=node rollup -c",
+    "build:node:esm": "FMT=esm ENV=node rollup -c",
+    "build:types": "tsc -p tsconfig.dec.json --emitDeclarationOnly  && find ./dist -name '*.d.ts' -exec sh -c 'cp {} $(dirname {})/$(basename -s .d.ts {}).d.cts' \\;",
+    "format": "prettier --write \"{{source,test}/**/*.{js,ts},rollup.config.js,vitest.config.js}\"",
+    "test": "npm run build && npm run test:specs && npm run test:format && npm run test:types",
+    "test:format": "prettier --check \"{{source,test}/**/*.{js,ts},rollup.config.js,vitest.config.js}\"",
+    "test:specs": "vitest",
+    "test:types": "npx --yes @arethetypeswrong/cli --pack ."
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ulid/javascript.git"
+  },
+  "author": "Alizain Feerasta",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/ulid/javascript/issues"
+  },
+  "homepage": "https://github.com/ulid/javascript#readme",
+  "devDependencies": {
+    "@rollup/plugin-alias": "^5.1.1",
+    "@rollup/plugin-commonjs": "^28.0.3",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "@types/node": "^22.15.30",
+    "benchmark": "^2.1.4",
+    "prettier": "^3.5.3",
+    "rollup": "^4.42.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.2"
+  }
+}