@itshackers/utilix 0.0.0-stage → 0.3.0

package/dist/format/index.d.cts

@@ -0,0 +1,56 @@
+interface FormatDateTimeOptions extends Intl.DateTimeFormatOptions {
+    locale?: string;
+}
+interface FormatDurationOptions {
+    /**
+     * Interpret `value` as milliseconds instead of seconds.
+     * @default "seconds"
+     */
+    unit?: "seconds" | "milliseconds";
+}
+/**
+ * Formats a date with `Intl.DateTimeFormat`.
+ * Defaults to `en-IN` in the `Asia/Kolkata` time zone, including time.
+ * Returns `null` for missing or invalid values.
+ *
+ * @example
+ * formatDateTime("2024-01-15T00:00:00.000Z")
+ * formatDateTime(date, { hour: undefined, minute: undefined, second: undefined })
+ */
+declare function formatDateTime(value: Date | string | number | null | undefined, options?: FormatDateTimeOptions): string | null;
+/**
+ * Formats a byte count as a human-readable file size.
+ *
+ * @example
+ * formatFileSize(0) // "0 Bytes"
+ * formatFileSize(1536) // "1.5 KB"
+ */
+declare function formatFileSize(bytes: number, decimals?: number): string;
+/**
+ * Formats a duration in hours, minutes, and seconds.
+ *
+ * @example
+ * formatDuration(3661) // "1 hr 1 min 1 sec"
+ * formatDuration(0) // "0 sec"
+ */
+declare function formatDuration(seconds: number): string;
+/**
+ * Formats a duration as a compact `y d h m s` string.
+ * Month and year units use fixed 30-day and 365-day approximations.
+ *
+ * @example
+ * formatDurationCompact(3661) // "1h 1m 1s"
+ * formatDurationCompact(1500, { unit: "milliseconds" }) // "1s"
+ */
+declare function formatDurationCompact(value: number, options?: FormatDurationOptions): string;
+/**
+ * Formats a price in Indian lakh units.
+ * Returns an empty string for missing or invalid values.
+ *
+ * @example
+ * formatPriceToLakh(2_000_000) // "20.00 Lakh"
+ */
+declare function formatPriceToLakh(price: unknown, decimals?: number): string;
+
+export { formatDateTime, formatDuration, formatDurationCompact, formatFileSize, formatPriceToLakh };
+export type { FormatDateTimeOptions, FormatDurationOptions };

package/dist/format/index.d.ts

@@ -0,0 +1,56 @@
+interface FormatDateTimeOptions extends Intl.DateTimeFormatOptions {
+    locale?: string;
+}
+interface FormatDurationOptions {
+    /**
+     * Interpret `value` as milliseconds instead of seconds.
+     * @default "seconds"
+     */
+    unit?: "seconds" | "milliseconds";
+}
+/**
+ * Formats a date with `Intl.DateTimeFormat`.
+ * Defaults to `en-IN` in the `Asia/Kolkata` time zone, including time.
+ * Returns `null` for missing or invalid values.
+ *
+ * @example
+ * formatDateTime("2024-01-15T00:00:00.000Z")
+ * formatDateTime(date, { hour: undefined, minute: undefined, second: undefined })
+ */
+declare function formatDateTime(value: Date | string | number | null | undefined, options?: FormatDateTimeOptions): string | null;
+/**
+ * Formats a byte count as a human-readable file size.
+ *
+ * @example
+ * formatFileSize(0) // "0 Bytes"
+ * formatFileSize(1536) // "1.5 KB"
+ */
+declare function formatFileSize(bytes: number, decimals?: number): string;
+/**
+ * Formats a duration in hours, minutes, and seconds.
+ *
+ * @example
+ * formatDuration(3661) // "1 hr 1 min 1 sec"
+ * formatDuration(0) // "0 sec"
+ */
+declare function formatDuration(seconds: number): string;
+/**
+ * Formats a duration as a compact `y d h m s` string.
+ * Month and year units use fixed 30-day and 365-day approximations.
+ *
+ * @example
+ * formatDurationCompact(3661) // "1h 1m 1s"
+ * formatDurationCompact(1500, { unit: "milliseconds" }) // "1s"
+ */
+declare function formatDurationCompact(value: number, options?: FormatDurationOptions): string;
+/**
+ * Formats a price in Indian lakh units.
+ * Returns an empty string for missing or invalid values.
+ *
+ * @example
+ * formatPriceToLakh(2_000_000) // "20.00 Lakh"
+ */
+declare function formatPriceToLakh(price: unknown, decimals?: number): string;
+
+export { formatDateTime, formatDuration, formatDurationCompact, formatFileSize, formatPriceToLakh };
+export type { FormatDateTimeOptions, FormatDurationOptions };

package/dist/format/index.js

@@ -0,0 +1,130 @@
+// src/internal/validation.ts
+function assertFiniteNumber(value, name) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new TypeError(`${name} must be a finite number`);
+  }
+}
+
+// src/format/index.ts
+var DEFAULT_LOCALE = "en-IN";
+var DEFAULT_TIME_ZONE = "Asia/Kolkata";
+var FILE_SIZE_UNITS = ["Bytes", "KB", "MB", "GB", "TB", "PB"];
+function formatDateTime(value, options = {}) {
+  if (value == null || value === "") {
+    return null;
+  }
+  const date = value instanceof Date ? value : new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    return null;
+  }
+  const { locale = DEFAULT_LOCALE, ...intlOptions } = options;
+  if (typeof locale !== "string" || locale.trim().length === 0) {
+    throw new TypeError("locale must be a non-empty BCP 47 locale tag");
+  }
+  return new Intl.DateTimeFormat(locale, {
+    timeZone: DEFAULT_TIME_ZONE,
+    day: "2-digit",
+    month: "short",
+    year: "numeric",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: true,
+    ...intlOptions
+  }).format(date);
+}
+function formatFileSize(bytes, decimals = 2) {
+  assertFiniteNumber(bytes, "bytes");
+  if (bytes < 0) {
+    throw new RangeError("bytes must be greater than or equal to 0");
+  }
+  if (!Number.isInteger(decimals) || decimals < 0 || decimals > 8) {
+    throw new RangeError("decimals must be an integer between 0 and 8");
+  }
+  if (bytes === 0) {
+    return "0 Bytes";
+  }
+  const unitIndex = Math.min(
+    Math.floor(Math.log(bytes) / Math.log(1024)),
+    FILE_SIZE_UNITS.length - 1
+  );
+  const value = bytes / 1024 ** unitIndex;
+  const unit = FILE_SIZE_UNITS[unitIndex] ?? "Bytes";
+  return `${Number(value.toFixed(decimals))} ${unit}`;
+}
+function formatDuration(seconds) {
+  assertFiniteNumber(seconds, "seconds");
+  if (seconds <= 0) {
+    return "0 sec";
+  }
+  const total = Math.floor(seconds);
+  const hours = Math.floor(total / 3600);
+  const minutes = Math.floor(total % 3600 / 60);
+  const remainingSeconds = total % 60;
+  const parts = [];
+  if (hours > 0) {
+    parts.push(`${hours} hr`);
+  }
+  if (minutes > 0) {
+    parts.push(`${minutes} min`);
+  }
+  if (remainingSeconds > 0 || parts.length === 0) {
+    parts.push(`${remainingSeconds} sec`);
+  }
+  return parts.join(" ");
+}
+function formatDurationCompact(value, options = {}) {
+  assertFiniteNumber(value, "value");
+  const unit = options.unit ?? "seconds";
+  if (unit !== "seconds" && unit !== "milliseconds") {
+    throw new TypeError('unit must be "seconds" or "milliseconds"');
+  }
+  let remaining = Math.floor(unit === "milliseconds" ? value / 1e3 : value);
+  if (remaining <= 0) {
+    return "0s";
+  }
+  const years = Math.floor(remaining / 31536e3);
+  remaining %= 31536e3;
+  const months = Math.floor(remaining / 2592e3);
+  remaining %= 2592e3;
+  const days = Math.floor(remaining / 86400);
+  remaining %= 86400;
+  const hours = Math.floor(remaining / 3600);
+  remaining %= 3600;
+  const minutes = Math.floor(remaining / 60);
+  const seconds = remaining % 60;
+  const parts = [];
+  if (years > 0) {
+    parts.push(`${years}y`);
+  }
+  if (months > 0) {
+    parts.push(`${months}mo`);
+  }
+  if (days > 0) {
+    parts.push(`${days}d`);
+  }
+  if (hours > 0) {
+    parts.push(`${hours}h`);
+  }
+  if (minutes > 0) {
+    parts.push(`${minutes}m`);
+  }
+  if (seconds > 0 || parts.length === 0) {
+    parts.push(`${seconds}s`);
+  }
+  return parts.join(" ");
+}
+function formatPriceToLakh(price, decimals = 2) {
+  if (!Number.isInteger(decimals) || decimals < 0 || decimals > 8) {
+    throw new RangeError("decimals must be an integer between 0 and 8");
+  }
+  const numeric = typeof price === "number" ? price : typeof price === "string" ? Number(price.trim()) : Number.NaN;
+  if (!Number.isFinite(numeric)) {
+    return "";
+  }
+  return `${(numeric / 1e5).toFixed(decimals)} Lakh`;
+}
+
+export { formatDateTime, formatDuration, formatDurationCompact, formatFileSize, formatPriceToLakh };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/format/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/validation.ts","../../src/format/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export function assertFiniteNumber(\r\n  value: unknown,\r\n  name: string,\r\n): asserts value is number {\r\n  if (typeof value !== \"number\" || !Number.isFinite(value)) {\r\n    throw new TypeError(`${name} must be a finite number`);\r\n  }\r\n}\r\n\r\nexport function escapeRegExp(value: string): string {\r\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\r\n}\r\n","import { assertFiniteNumber } from \"../internal/validation.js\";\r\n\r\nconst DEFAULT_LOCALE = \"en-IN\";\r\nconst DEFAULT_TIME_ZONE = \"Asia/Kolkata\";\r\nconst FILE_SIZE_UNITS = [\"Bytes\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\"] as const;\r\n\r\nexport interface FormatDateTimeOptions extends Intl.DateTimeFormatOptions {\r\n  locale?: string;\r\n}\r\n\r\nexport interface FormatDurationOptions {\r\n  /**\r\n   * Interpret `value` as milliseconds instead of seconds.\r\n   * @default \"seconds\"\r\n   */\r\n  unit?: \"seconds\" | \"milliseconds\";\r\n}\r\n\r\n/**\r\n * Formats a date with `Intl.DateTimeFormat`.\r\n * Defaults to `en-IN` in the `Asia/Kolkata` time zone, including time.\r\n * Returns `null` for missing or invalid values.\r\n *\r\n * @example\r\n * formatDateTime(\"2024-01-15T00:00:00.000Z\")\r\n * formatDateTime(date, { hour: undefined, minute: undefined, second: undefined })\r\n */\r\nexport function formatDateTime(\r\n  value: Date | string | number | null | undefined,\r\n  options: FormatDateTimeOptions = {},\r\n): string | null {\r\n  if (value == null || value === \"\") {\r\n    return null;\r\n  }\r\n\r\n  const date = value instanceof Date ? value : new Date(value);\r\n  if (Number.isNaN(date.getTime())) {\r\n    return null;\r\n  }\r\n\r\n  const { locale = DEFAULT_LOCALE, ...intlOptions } = options;\r\n  if (typeof locale !== \"string\" || locale.trim().length === 0) {\r\n    throw new TypeError(\"locale must be a non-empty BCP 47 locale tag\");\r\n  }\r\n\r\n  return new Intl.DateTimeFormat(locale, {\r\n    timeZone: DEFAULT_TIME_ZONE,\r\n    day: \"2-digit\",\r\n    month: \"short\",\r\n    year: \"numeric\",\r\n    hour: \"2-digit\",\r\n    minute: \"2-digit\",\r\n    second: \"2-digit\",\r\n    hour12: true,\r\n    ...intlOptions,\r\n  }).format(date);\r\n}\r\n\r\n/**\r\n * Formats a byte count as a human-readable file size.\r\n *\r\n * @example\r\n * formatFileSize(0) // \"0 Bytes\"\r\n * formatFileSize(1536) // \"1.5 KB\"\r\n */\r\nexport function formatFileSize(bytes: number, decimals = 2): string {\r\n  assertFiniteNumber(bytes, \"bytes\");\r\n  if (bytes < 0) {\r\n    throw new RangeError(\"bytes must be greater than or equal to 0\");\r\n  }\r\n\r\n  if (!Number.isInteger(decimals) || decimals < 0 || decimals > 8) {\r\n    throw new RangeError(\"decimals must be an integer between 0 and 8\");\r\n  }\r\n\r\n  if (bytes === 0) {\r\n    return \"0 Bytes\";\r\n  }\r\n\r\n  const unitIndex = Math.min(\r\n    Math.floor(Math.log(bytes) / Math.log(1024)),\r\n    FILE_SIZE_UNITS.length - 1,\r\n  );\r\n  const value = bytes / 1024 ** unitIndex;\r\n  const unit = FILE_SIZE_UNITS[unitIndex] ?? \"Bytes\";\r\n\r\n  return `${Number(value.toFixed(decimals))} ${unit}`;\r\n}\r\n\r\n/**\r\n * Formats a duration in hours, minutes, and seconds.\r\n *\r\n * @example\r\n * formatDuration(3661) // \"1 hr 1 min 1 sec\"\r\n * formatDuration(0) // \"0 sec\"\r\n */\r\nexport function formatDuration(seconds: number): string {\r\n  assertFiniteNumber(seconds, \"seconds\");\r\n\r\n  if (seconds <= 0) {\r\n    return \"0 sec\";\r\n  }\r\n\r\n  const total = Math.floor(seconds);\r\n  const hours = Math.floor(total / 3600);\r\n  const minutes = Math.floor((total % 3600) / 60);\r\n  const remainingSeconds = total % 60;\r\n\r\n  const parts: string[] = [];\r\n  if (hours > 0) {\r\n    parts.push(`${hours} hr`);\r\n  }\r\n  if (minutes > 0) {\r\n    parts.push(`${minutes} min`);\r\n  }\r\n  if (remainingSeconds > 0 || parts.length === 0) {\r\n    parts.push(`${remainingSeconds} sec`);\r\n  }\r\n\r\n  return parts.join(\" \");\r\n}\r\n\r\n/**\r\n * Formats a duration as a compact `y d h m s` string.\r\n * Month and year units use fixed 30-day and 365-day approximations.\r\n *\r\n * @example\r\n * formatDurationCompact(3661) // \"1h 1m 1s\"\r\n * formatDurationCompact(1500, { unit: \"milliseconds\" }) // \"1s\"\r\n */\r\nexport function formatDurationCompact(\r\n  value: number,\r\n  options: FormatDurationOptions = {},\r\n): string {\r\n  assertFiniteNumber(value, \"value\");\r\n\r\n  const unit = options.unit ?? \"seconds\";\r\n  if (unit !== \"seconds\" && unit !== \"milliseconds\") {\r\n    throw new TypeError('unit must be \"seconds\" or \"milliseconds\"');\r\n  }\r\n\r\n  let remaining = Math.floor(unit === \"milliseconds\" ? value / 1000 : value);\r\n  if (remaining <= 0) {\r\n    return \"0s\";\r\n  }\r\n\r\n  const years = Math.floor(remaining / 31_536_000);\r\n  remaining %= 31_536_000;\r\n  const months = Math.floor(remaining / 2_592_000);\r\n  remaining %= 2_592_000;\r\n  const days = Math.floor(remaining / 86_400);\r\n  remaining %= 86_400;\r\n  const hours = Math.floor(remaining / 3600);\r\n  remaining %= 3600;\r\n  const minutes = Math.floor(remaining / 60);\r\n  const seconds = remaining % 60;\r\n\r\n  const parts: string[] = [];\r\n  if (years > 0) {\r\n    parts.push(`${years}y`);\r\n  }\r\n  if (months > 0) {\r\n    parts.push(`${months}mo`);\r\n  }\r\n  if (days > 0) {\r\n    parts.push(`${days}d`);\r\n  }\r\n  if (hours > 0) {\r\n    parts.push(`${hours}h`);\r\n  }\r\n  if (minutes > 0) {\r\n    parts.push(`${minutes}m`);\r\n  }\r\n  if (seconds > 0 || parts.length === 0) {\r\n    parts.push(`${seconds}s`);\r\n  }\r\n\r\n  return parts.join(\" \");\r\n}\r\n\r\n/**\r\n * Formats a price in Indian lakh units.\r\n * Returns an empty string for missing or invalid values.\r\n *\r\n * @example\r\n * formatPriceToLakh(2_000_000) // \"20.00 Lakh\"\r\n */\r\nexport function formatPriceToLakh(price: unknown, decimals = 2): string {\r\n  if (!Number.isInteger(decimals) || decimals < 0 || decimals > 8) {\r\n    throw new RangeError(\"decimals must be an integer between 0 and 8\");\r\n  }\r\n\r\n  const numeric =\r\n    typeof price === \"number\"\r\n      ? price\r\n      : typeof price === \"string\"\r\n        ? Number(price.trim())\r\n        : Number.NaN;\r\n\r\n  if (!Number.isFinite(numeric)) {\r\n    return \"\";\r\n  }\r\n\r\n  return `${(numeric / 100_000).toFixed(decimals)} Lakh`;\r\n}\r\n"]}

package/dist/id/index.cjs

@@ -0,0 +1,66 @@
+'use strict';
+
+// src/internal/random.ts
+function getCrypto() {
+  const cryptoApi = globalThis.crypto;
+  if (!cryptoApi?.getRandomValues) {
+    throw new Error("Secure random number generation is not available in this runtime");
+  }
+  return cryptoApi;
+}
+function randomIndex(length) {
+  if (length <= 0) {
+    throw new RangeError("length must be greater than 0");
+  }
+  const cryptoApi = getCrypto();
+  const limit = 4294967296;
+  const unbiasedMax = Math.floor(limit / length) * length;
+  const bytes = new Uint32Array(1);
+  let value = 0;
+  do {
+    cryptoApi.getRandomValues(bytes);
+    value = bytes[0] ?? 0;
+  } while (value >= unbiasedMax);
+  return value % length;
+}
+function pickCharacter(charset) {
+  return charset[randomIndex(charset.length)] ?? charset[0] ?? "A";
+}
+function randomString(length, charset) {
+  return Array.from({ length }, () => pickCharacter(charset)).join("");
+}
+
+// src/id/index.ts
+var DEFAULT_CHARSET = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+function pad(value) {
+  return String(value).padStart(2, "0");
+}
+function generatePrefixedCode(options) {
+  const prefix = options.prefix.trim();
+  if (prefix.length === 0) {
+    throw new TypeError("prefix must be a non-empty string");
+  }
+  const randomLength = options.randomLength ?? 5;
+  if (!Number.isInteger(randomLength) || randomLength < 0) {
+    throw new RangeError("randomLength must be an integer greater than or equal to 0");
+  }
+  const charset = options.charset ?? DEFAULT_CHARSET;
+  if (charset.length === 0) {
+    throw new TypeError("charset must be a non-empty string");
+  }
+  const includeTimestamp = options.includeTimestamp ?? true;
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  const randomPart = randomLength > 0 ? randomString(randomLength, charset) : "";
+  if (!includeTimestamp) {
+    return `${prefix}${randomPart}`;
+  }
+  const day = pad(now.getDate());
+  const month = pad(now.getMonth() + 1);
+  const hour = pad(now.getHours());
+  const minute = pad(now.getMinutes());
+  return `${prefix}${day}${month}${randomPart}${hour}${minute}`;
+}
+
+exports.generatePrefixedCode = generatePrefixedCode;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/id/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/random.ts","../../src/id/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["function getCrypto(): Crypto {\r\n  const cryptoApi = globalThis.crypto;\r\n  if (!cryptoApi?.getRandomValues) {\r\n    throw new Error(\"Secure random number generation is not available in this runtime\");\r\n  }\r\n\r\n  return cryptoApi;\r\n}\r\n\r\nexport function randomIndex(length: number): number {\r\n  if (length <= 0) {\r\n    throw new RangeError(\"length must be greater than 0\");\r\n  }\r\n\r\n  const cryptoApi = getCrypto();\r\n  const limit = 0x1_0000_0000;\r\n  const unbiasedMax = Math.floor(limit / length) * length;\r\n  const bytes = new Uint32Array(1);\r\n\r\n  let value = 0;\r\n  do {\r\n    cryptoApi.getRandomValues(bytes);\r\n    value = bytes[0] ?? 0;\r\n  } while (value >= unbiasedMax);\r\n\r\n  return value % length;\r\n}\r\n\r\nexport function pickCharacter(charset: string): string {\r\n  return charset[randomIndex(charset.length)] ?? charset[0] ?? \"A\";\r\n}\r\n\r\nexport function randomString(length: number, charset: string): string {\r\n  return Array.from({ length }, () => pickCharacter(charset)).join(\"\");\r\n}\r\n\r\nexport function shuffle<T>(items: T[]): T[] {\r\n  const result = [...items];\r\n  for (let index = result.length - 1; index > 0; index -= 1) {\r\n    const swapIndex = randomIndex(index + 1);\r\n    const current = result[index];\r\n    const other = result[swapIndex];\r\n    if (current === undefined || other === undefined) {\r\n      continue;\r\n    }\r\n    result[index] = other;\r\n    result[swapIndex] = current;\r\n  }\r\n  return result;\r\n}\r\n","import { randomString } from \"../internal/random.js\";\r\n\r\nconst DEFAULT_CHARSET = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\";\r\n\r\nexport interface GeneratePrefixedCodeOptions {\r\n  prefix: string;\r\n  randomLength?: number;\r\n  includeTimestamp?: boolean;\r\n  now?: Date;\r\n  charset?: string;\r\n}\r\n\r\nfunction pad(value: number): string {\r\n  return String(value).padStart(2, \"0\");\r\n}\r\n\r\n/**\r\n * Builds a configurable unique-looking code such as `PLAN1503AB12X0931`.\r\n * Uses `crypto.getRandomValues`. This does not guarantee global uniqueness.\r\n *\r\n * @example\r\n * generatePrefixedCode({ prefix: \"PLAN\" })\r\n * generatePrefixedCode({ prefix: \"SAVE\", randomLength: 6, includeTimestamp: false })\r\n */\r\nexport function generatePrefixedCode(options: GeneratePrefixedCodeOptions): string {\r\n  const prefix = options.prefix.trim();\r\n  if (prefix.length === 0) {\r\n    throw new TypeError(\"prefix must be a non-empty string\");\r\n  }\r\n\r\n  const randomLength = options.randomLength ?? 5;\r\n  if (!Number.isInteger(randomLength) || randomLength < 0) {\r\n    throw new RangeError(\"randomLength must be an integer greater than or equal to 0\");\r\n  }\r\n\r\n  const charset = options.charset ?? DEFAULT_CHARSET;\r\n  if (charset.length === 0) {\r\n    throw new TypeError(\"charset must be a non-empty string\");\r\n  }\r\n\r\n  const includeTimestamp = options.includeTimestamp ?? true;\r\n  const now = options.now ?? new Date();\r\n  const randomPart = randomLength > 0 ? randomString(randomLength, charset) : \"\";\r\n\r\n  if (!includeTimestamp) {\r\n    return `${prefix}${randomPart}`;\r\n  }\r\n\r\n  const day = pad(now.getDate());\r\n  const month = pad(now.getMonth() + 1);\r\n  const hour = pad(now.getHours());\r\n  const minute = pad(now.getMinutes());\r\n\r\n  return `${prefix}${day}${month}${randomPart}${hour}${minute}`;\r\n}\r\n"]}

package/dist/id/index.d.cts

@@ -0,0 +1,19 @@
+interface GeneratePrefixedCodeOptions {
+    prefix: string;
+    randomLength?: number;
+    includeTimestamp?: boolean;
+    now?: Date;
+    charset?: string;
+}
+/**
+ * Builds a configurable unique-looking code such as `PLAN1503AB12X0931`.
+ * Uses `crypto.getRandomValues`. This does not guarantee global uniqueness.
+ *
+ * @example
+ * generatePrefixedCode({ prefix: "PLAN" })
+ * generatePrefixedCode({ prefix: "SAVE", randomLength: 6, includeTimestamp: false })
+ */
+declare function generatePrefixedCode(options: GeneratePrefixedCodeOptions): string;
+
+export { generatePrefixedCode };
+export type { GeneratePrefixedCodeOptions };

package/dist/id/index.d.ts

@@ -0,0 +1,19 @@
+interface GeneratePrefixedCodeOptions {
+    prefix: string;
+    randomLength?: number;
+    includeTimestamp?: boolean;
+    now?: Date;
+    charset?: string;
+}
+/**
+ * Builds a configurable unique-looking code such as `PLAN1503AB12X0931`.
+ * Uses `crypto.getRandomValues`. This does not guarantee global uniqueness.
+ *
+ * @example
+ * generatePrefixedCode({ prefix: "PLAN" })
+ * generatePrefixedCode({ prefix: "SAVE", randomLength: 6, includeTimestamp: false })
+ */
+declare function generatePrefixedCode(options: GeneratePrefixedCodeOptions): string;
+
+export { generatePrefixedCode };
+export type { GeneratePrefixedCodeOptions };

package/dist/id/index.js

@@ -0,0 +1,64 @@
+// src/internal/random.ts
+function getCrypto() {
+  const cryptoApi = globalThis.crypto;
+  if (!cryptoApi?.getRandomValues) {
+    throw new Error("Secure random number generation is not available in this runtime");
+  }
+  return cryptoApi;
+}
+function randomIndex(length) {
+  if (length <= 0) {
+    throw new RangeError("length must be greater than 0");
+  }
+  const cryptoApi = getCrypto();
+  const limit = 4294967296;
+  const unbiasedMax = Math.floor(limit / length) * length;
+  const bytes = new Uint32Array(1);
+  let value = 0;
+  do {
+    cryptoApi.getRandomValues(bytes);
+    value = bytes[0] ?? 0;
+  } while (value >= unbiasedMax);
+  return value % length;
+}
+function pickCharacter(charset) {
+  return charset[randomIndex(charset.length)] ?? charset[0] ?? "A";
+}
+function randomString(length, charset) {
+  return Array.from({ length }, () => pickCharacter(charset)).join("");
+}
+
+// src/id/index.ts
+var DEFAULT_CHARSET = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+function pad(value) {
+  return String(value).padStart(2, "0");
+}
+function generatePrefixedCode(options) {
+  const prefix = options.prefix.trim();
+  if (prefix.length === 0) {
+    throw new TypeError("prefix must be a non-empty string");
+  }
+  const randomLength = options.randomLength ?? 5;
+  if (!Number.isInteger(randomLength) || randomLength < 0) {
+    throw new RangeError("randomLength must be an integer greater than or equal to 0");
+  }
+  const charset = options.charset ?? DEFAULT_CHARSET;
+  if (charset.length === 0) {
+    throw new TypeError("charset must be a non-empty string");
+  }
+  const includeTimestamp = options.includeTimestamp ?? true;
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  const randomPart = randomLength > 0 ? randomString(randomLength, charset) : "";
+  if (!includeTimestamp) {
+    return `${prefix}${randomPart}`;
+  }
+  const day = pad(now.getDate());
+  const month = pad(now.getMonth() + 1);
+  const hour = pad(now.getHours());
+  const minute = pad(now.getMinutes());
+  return `${prefix}${day}${month}${randomPart}${hour}${minute}`;
+}
+
+export { generatePrefixedCode };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/id/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/random.ts","../../src/id/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["function getCrypto(): Crypto {\r\n  const cryptoApi = globalThis.crypto;\r\n  if (!cryptoApi?.getRandomValues) {\r\n    throw new Error(\"Secure random number generation is not available in this runtime\");\r\n  }\r\n\r\n  return cryptoApi;\r\n}\r\n\r\nexport function randomIndex(length: number): number {\r\n  if (length <= 0) {\r\n    throw new RangeError(\"length must be greater than 0\");\r\n  }\r\n\r\n  const cryptoApi = getCrypto();\r\n  const limit = 0x1_0000_0000;\r\n  const unbiasedMax = Math.floor(limit / length) * length;\r\n  const bytes = new Uint32Array(1);\r\n\r\n  let value = 0;\r\n  do {\r\n    cryptoApi.getRandomValues(bytes);\r\n    value = bytes[0] ?? 0;\r\n  } while (value >= unbiasedMax);\r\n\r\n  return value % length;\r\n}\r\n\r\nexport function pickCharacter(charset: string): string {\r\n  return charset[randomIndex(charset.length)] ?? charset[0] ?? \"A\";\r\n}\r\n\r\nexport function randomString(length: number, charset: string): string {\r\n  return Array.from({ length }, () => pickCharacter(charset)).join(\"\");\r\n}\r\n\r\nexport function shuffle<T>(items: T[]): T[] {\r\n  const result = [...items];\r\n  for (let index = result.length - 1; index > 0; index -= 1) {\r\n    const swapIndex = randomIndex(index + 1);\r\n    const current = result[index];\r\n    const other = result[swapIndex];\r\n    if (current === undefined || other === undefined) {\r\n      continue;\r\n    }\r\n    result[index] = other;\r\n    result[swapIndex] = current;\r\n  }\r\n  return result;\r\n}\r\n","import { randomString } from \"../internal/random.js\";\r\n\r\nconst DEFAULT_CHARSET = \"ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\";\r\n\r\nexport interface GeneratePrefixedCodeOptions {\r\n  prefix: string;\r\n  randomLength?: number;\r\n  includeTimestamp?: boolean;\r\n  now?: Date;\r\n  charset?: string;\r\n}\r\n\r\nfunction pad(value: number): string {\r\n  return String(value).padStart(2, \"0\");\r\n}\r\n\r\n/**\r\n * Builds a configurable unique-looking code such as `PLAN1503AB12X0931`.\r\n * Uses `crypto.getRandomValues`. This does not guarantee global uniqueness.\r\n *\r\n * @example\r\n * generatePrefixedCode({ prefix: \"PLAN\" })\r\n * generatePrefixedCode({ prefix: \"SAVE\", randomLength: 6, includeTimestamp: false })\r\n */\r\nexport function generatePrefixedCode(options: GeneratePrefixedCodeOptions): string {\r\n  const prefix = options.prefix.trim();\r\n  if (prefix.length === 0) {\r\n    throw new TypeError(\"prefix must be a non-empty string\");\r\n  }\r\n\r\n  const randomLength = options.randomLength ?? 5;\r\n  if (!Number.isInteger(randomLength) || randomLength < 0) {\r\n    throw new RangeError(\"randomLength must be an integer greater than or equal to 0\");\r\n  }\r\n\r\n  const charset = options.charset ?? DEFAULT_CHARSET;\r\n  if (charset.length === 0) {\r\n    throw new TypeError(\"charset must be a non-empty string\");\r\n  }\r\n\r\n  const includeTimestamp = options.includeTimestamp ?? true;\r\n  const now = options.now ?? new Date();\r\n  const randomPart = randomLength > 0 ? randomString(randomLength, charset) : \"\";\r\n\r\n  if (!includeTimestamp) {\r\n    return `${prefix}${randomPart}`;\r\n  }\r\n\r\n  const day = pad(now.getDate());\r\n  const month = pad(now.getMonth() + 1);\r\n  const hour = pad(now.getHours());\r\n  const minute = pad(now.getMinutes());\r\n\r\n  return `${prefix}${day}${month}${randomPart}${hour}${minute}`;\r\n}\r\n"]}