@ppabari/strio 1.0.2

package/dist/zod-CINbFpp9.d.ts

@@ -0,0 +1,211 @@
+/**
+ * types.ts
+ * All public TypeScript types and interfaces.
+ */
+/** Which character category the first character must belong to. */
+type StartWith = 'alphabet' | 'numeric' | 'any';
+/**
+ * Options for `generateRandomString` and `generateRandomStringAsync`.
+ *
+ * Character pool is built from the enabled flags, then reduced
+ * by any `exclude` characters. You may also pass a fully custom
+ * `charset` which bypasses all flags.
+ */
+interface RandomStringOptions {
+    /**
+     * Total length of the generated string (including prefix/suffix).
+     * The random portion will be `length - prefix.length - suffix.length`.
+     * @default 16
+     */
+    length?: number;
+    /** Include digits 0–9. @default true */
+    numeric?: boolean;
+    /** Include lowercase a–z. @default true */
+    lowercase?: boolean;
+    /** Include uppercase A–Z. @default true */
+    uppercase?: boolean;
+    /** Include symbols `!@#$%^&*()_+[]{}<>?`. @default false */
+    symbols?: boolean;
+    /**
+     * Exclude specific characters from the pool.
+     * Useful for removing visually ambiguous chars like `0`, `O`, `l`, `I`, `1`.
+     * Applied after charset construction; must not eliminate the entire pool.
+     */
+    exclude?: string | string[];
+    /**
+     * Shorthand for `exclude: ['0','O','l','I','1']`.
+     * Produces strings that are easy to read and transcribe.
+     * @default false
+     */
+    readable?: boolean;
+    /**
+     * Fully custom character pool. Overrides `numeric`, `lowercase`,
+     * `uppercase`, `symbols`, and `readable`. Duplicate characters are
+     * removed automatically. Must have at least 2 unique characters.
+     */
+    charset?: string;
+    /**
+     * Constrain the first character of the random portion.
+     * - `'alphabet'` — must be a–z or A–Z (whichever are enabled)
+     * - `'numeric'`  — must be 0–9
+     * - `'any'`      — no constraint
+     * @default 'any'
+     */
+    startWith?: StartWith;
+    /**
+     * Fixed string prepended to the result. Does not count toward
+     * the random entropy; the random portion shrinks accordingly so
+     * the total length stays at `length`.
+     * @example `{ prefix: 'usr_', length: 20 }` → `'usr_' + 16 random chars`
+     */
+    prefix?: string;
+    /**
+     * Fixed string appended to the result. Same length accounting as `prefix`.
+     */
+    suffix?: string;
+    /**
+     * Pattern string where special placeholders are replaced with random chars.
+     * When `pattern` is set, `length` is ignored.
+     *
+     * Placeholders:
+     * - `#` → random digit (0–9)
+     * - `A` → random uppercase letter
+     * - `a` → random lowercase letter
+     * - `*` → random char from the full enabled charset
+     * - `?` → random alphanumeric char
+     *
+     * Escape a literal placeholder with a backslash: `\#` → `#`
+     *
+     * @example `{ pattern: '####-AAAA-####' }` → `'4821-KXPZ-0937'`
+     * @example `{ pattern: 'usr_**********' }` → `'usr_k3Xp9mQr2L'`
+     */
+    pattern?: string;
+    /**
+     * Generate multiple unique strings in a single call.
+     * Returns a `string[]` instead of `string` when > 1.
+     * Uniqueness is guaranteed; throws if `count` exceeds the
+     * theoretical maximum unique combinations for the given config.
+     * @default 1
+     */
+    count?: number;
+    /**
+     * Deterministic seed for reproducible output.
+     * Same seed + same options = same string every time.
+     *
+     * ⚠️  NOT cryptographically secure. Use only for tests,
+     * snapshots, and demos — never for real tokens or secrets.
+     *
+     * When `seed` is set the crypto engine is bypassed entirely.
+     */
+    seed?: string;
+}
+/** Result type: single string when count=1 (default), array when count>1. */
+type RandomStringResult<T extends RandomStringOptions> = T extends {
+    count: infer C;
+} ? C extends 1 ? string : C extends number ? string[] : string : string;
+/** Options for `validateRandomString`. */
+interface ValidateOptions {
+    /** Minimum length (inclusive). */
+    minLength?: number;
+    /** Maximum length (inclusive). */
+    maxLength?: number;
+    /** Exact length. */
+    length?: number;
+    /** Must contain at least one digit. */
+    requireNumeric?: boolean;
+    /** Must contain at least one lowercase letter. */
+    requireLowercase?: boolean;
+    /** Must contain at least one uppercase letter. */
+    requireUppercase?: boolean;
+    /** Must contain at least one symbol. */
+    requireSymbols?: boolean;
+    /** All characters must belong to this set. */
+    charset?: string;
+    /** Pattern the string must match (same syntax as generation pattern). */
+    pattern?: string;
+}
+/** Result from `validateRandomString`. */
+interface ValidationResult {
+    /** Whether the string passes all checks. */
+    valid: boolean;
+    /** List of rule violations. Empty when `valid` is true. */
+    errors: string[];
+}
+/** Result from `estimateEntropy`. */
+interface EntropyResult {
+    /** Shannon entropy in bits. */
+    bits: number;
+    /** Human-readable strength label. */
+    strength: 'very-weak' | 'weak' | 'fair' | 'strong' | 'very-strong';
+    /** Charset size used in the calculation. */
+    charsetSize: number;
+    /** Effective random length (excluding prefix/suffix). */
+    effectiveLength: number;
+    /** Approximate number of possible combinations (as a string to avoid overflow). */
+    combinations: string;
+}
+
+/**
+ * zod.ts
+ * Zod schema factory for @ppabari/strio.
+ *
+ * Creates a `z.string()` schema that validates a string against strio
+ * options. The Zod peer dependency is optional — import from the
+ * subpath `@ppabari/strio/zod` only when Zod is available.
+ *
+ * @example
+ * import { z } from 'zod';
+ * import { randomStringSchema } from '@ppabari/strio/zod';
+ *
+ * const tokenSchema = randomStringSchema({
+ *   length: 32,
+ *   charset: 'base62',
+ * });
+ *
+ * tokenSchema.parse('k3Xp9mQr2LzYw7NvTq8sHfGbJ5cD4eAK'); // ✓
+ * tokenSchema.parse('short'); // throws ZodError
+ *
+ * // In a form schema
+ * const UserSchema = z.object({
+ *   id: randomStringSchema({ length: 12, charset: 'base58' }),
+ *   apiKey: randomStringSchema({ length: 32 }),
+ * });
+ */
+
+/**
+ * Options for building a Zod schema. A superset of ValidateOptions
+ * with an extra `description` for the schema's `.describe()` call.
+ */
+interface RandomStringSchemaOptions extends ValidateOptions {
+    /** Optional human-readable description added to the Zod schema. */
+    description?: string;
+}
+/**
+ * A minimal type shim for the parts of Zod we need.
+ * Avoids importing Zod at the type level so the module loads even when
+ * Zod is not installed — errors only at runtime if you try to call this.
+ */
+interface ZodStringLike {
+    refine(check: (val: string) => boolean, params: {
+        message: string;
+    }): ZodStringLike;
+    describe(text: string): ZodStringLike;
+}
+interface ZodLike {
+    string(): ZodStringLike;
+}
+/**
+ * Create a Zod string schema that validates against strio's ValidateOptions.
+ *
+ * @param options - Validation rules (length, charset, required character types, etc.)
+ * @param zod - The `z` object from zod. Pass explicitly to avoid a hard dependency.
+ *
+ * @example
+ * import { z } from 'zod';
+ * import { randomStringSchema } from '@ppabari/strio/zod';
+ *
+ * const schema = randomStringSchema({ length: 16, requireUppercase: true }, z);
+ */
+declare function randomStringSchema(options?: RandomStringSchemaOptions, zod?: ZodLike): ZodStringLike;
+
+export { type EntropyResult as E, type RandomStringOptions as R, type StartWith as S, type ValidateOptions as V, type RandomStringResult as a, type RandomStringSchemaOptions as b, type ValidationResult as c, randomStringSchema as r };

package/dist/zod.cjs

@@ -0,0 +1,165 @@
+'use strict';
+
+// src/validate.ts
+var DIGIT_RE = /[0-9]/;
+var LOWER_RE = /[a-z]/;
+var UPPER_RE = /[A-Z]/;
+var SYMBOL_RE = /[!@#$%^&*()_+\[\]{}<>?]/;
+function validateRandomString(str, options = {}) {
+  const errors = [];
+  const {
+    minLength,
+    maxLength,
+    length,
+    requireNumeric,
+    requireLowercase,
+    requireUppercase,
+    requireSymbols,
+    charset,
+    pattern
+  } = options;
+  if (length !== void 0 && str.length !== length) {
+    errors.push(`Length must be exactly ${length}, got ${str.length}.`);
+  }
+  if (minLength !== void 0 && str.length < minLength) {
+    errors.push(`Length must be at least ${minLength}, got ${str.length}.`);
+  }
+  if (maxLength !== void 0 && str.length > maxLength) {
+    errors.push(`Length must be at most ${maxLength}, got ${str.length}.`);
+  }
+  if (requireNumeric && !DIGIT_RE.test(str)) {
+    errors.push("Must contain at least one numeric digit.");
+  }
+  if (requireLowercase && !LOWER_RE.test(str)) {
+    errors.push("Must contain at least one lowercase letter.");
+  }
+  if (requireUppercase && !UPPER_RE.test(str)) {
+    errors.push("Must contain at least one uppercase letter.");
+  }
+  if (requireSymbols && !SYMBOL_RE.test(str)) {
+    errors.push("Must contain at least one symbol.");
+  }
+  if (charset !== void 0) {
+    const charsetSet = new Set(charset);
+    const invalidChars = [...new Set(str)].filter((ch) => !charsetSet.has(ch));
+    if (invalidChars.length > 0) {
+      errors.push(
+        `Contains characters not in the allowed charset: ${invalidChars.map((c) => JSON.stringify(c)).join(", ")}.`
+      );
+    }
+  }
+  if (pattern !== void 0) {
+    const patternErrors = validatePattern(str, pattern);
+    errors.push(...patternErrors);
+  }
+  return { valid: errors.length === 0, errors };
+}
+function validatePattern(str, pattern) {
+  const errors = [];
+  const expandedPattern = [];
+  let i = 0;
+  while (i < pattern.length) {
+    const ch = pattern[i];
+    if (ch === "\\" && i + 1 < pattern.length) {
+      expandedPattern.push({ type: "literal", value: pattern[i + 1] });
+      i += 2;
+    } else if (["#", "A", "a", "*", "?"].includes(ch)) {
+      expandedPattern.push({ type: "placeholder", value: ch });
+      i++;
+    } else {
+      expandedPattern.push({ type: "literal", value: ch });
+      i++;
+    }
+  }
+  if (str.length !== expandedPattern.length) {
+    errors.push(
+      `Pattern expects length ${expandedPattern.length}, got ${str.length}.`
+    );
+    return errors;
+  }
+  for (let pos = 0; pos < expandedPattern.length; pos++) {
+    const token = expandedPattern[pos];
+    const ch = str[pos];
+    if (token.type === "literal") {
+      if (ch !== token.value) {
+        errors.push(
+          `Position ${pos}: expected literal '${token.value}', got '${ch}'.`
+        );
+      }
+    } else {
+      switch (token.value) {
+        case "#":
+          if (!DIGIT_RE.test(ch)) {
+            errors.push(`Position ${pos}: '#' expects a digit, got '${ch}'.`);
+          }
+          break;
+        case "A":
+          if (!/[A-Z]/.test(ch)) {
+            errors.push(`Position ${pos}: 'A' expects an uppercase letter, got '${ch}'.`);
+          }
+          break;
+        case "a":
+          if (!LOWER_RE.test(ch)) {
+            errors.push(`Position ${pos}: 'a' expects a lowercase letter, got '${ch}'.`);
+          }
+          break;
+        case "?":
+          if (!/[a-zA-Z0-9]/.test(ch)) {
+            errors.push(`Position ${pos}: '?' expects an alphanumeric character, got '${ch}'.`);
+          }
+          break;
+      }
+    }
+  }
+  return errors;
+}
+
+// src/zod.ts
+function randomStringSchema(options = {}, zod) {
+  let z;
+  if (zod) {
+    z = zod;
+  } else {
+    try {
+      const req = typeof globalThis !== "undefined" && globalThis["require"];
+      z = req ? req("zod") : (() => {
+        throw new Error("no require");
+      })();
+    } catch {
+      throw new Error(
+        "@ppabari/strio: Zod is not installed. Run `npm install zod` or pass the `z` object explicitly: `randomStringSchema(options, z)`."
+      );
+    }
+  }
+  const { description, ...validateOpts } = options;
+  let schema = z.string().refine(
+    (val) => {
+      const result = validateRandomString(val, validateOpts);
+      return result.valid;
+    },
+    {
+      message: buildMessage(validateOpts)
+    }
+  );
+  if (description) {
+    schema = schema.describe(description);
+  }
+  return schema;
+}
+function buildMessage(opts) {
+  const parts = [];
+  if (opts.length !== void 0) parts.push(`exactly ${opts.length} characters`);
+  if (opts.minLength !== void 0) parts.push(`at least ${opts.minLength} characters`);
+  if (opts.maxLength !== void 0) parts.push(`at most ${opts.maxLength} characters`);
+  if (opts.requireNumeric) parts.push("at least one digit");
+  if (opts.requireLowercase) parts.push("at least one lowercase letter");
+  if (opts.requireUppercase) parts.push("at least one uppercase letter");
+  if (opts.requireSymbols) parts.push("at least one symbol");
+  if (opts.charset) parts.push(`only characters from '${opts.charset}'`);
+  if (opts.pattern) parts.push(`matching pattern '${opts.pattern}'`);
+  return parts.length > 0 ? `String must contain ${parts.join(", ")}.` : "Invalid string format.";
+}
+
+exports.randomStringSchema = randomStringSchema;
+//# sourceMappingURL=zod.cjs.map
+//# sourceMappingURL=zod.cjs.map

package/dist/zod.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/validate.ts","../src/zod.ts"],"names":[],"mappings":"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","file":"zod.cjs","sourcesContent":["/**\n * validate.ts\n * Validate that a string conforms to a given RandomStringOptions config.\n */\n\nimport type { ValidateOptions, ValidationResult } from './types.js';\n\nconst DIGIT_RE = /[0-9]/;\nconst LOWER_RE = /[a-z]/;\nconst UPPER_RE = /[A-Z]/;\nconst SYMBOL_RE = /[!@#$%^&*()_+\\[\\]{}<>?]/;\n\n/**\n * Checks whether `str` satisfies the given validation rules.\n *\n * @example\n * const result = validateRandomString('abc123', {\n *   minLength: 6,\n *   requireNumeric: true,\n *   requireLowercase: true,\n * });\n * result.valid; // true\n *\n * @example\n * const result = validateRandomString('abc', { requireNumeric: true });\n * result.valid;  // false\n * result.errors; // ['Must contain at least one numeric digit.']\n */\nexport function validateRandomString(\n  str: string,\n  options: ValidateOptions = {}\n): ValidationResult {\n  const errors: string[] = [];\n  const {\n    minLength,\n    maxLength,\n    length,\n    requireNumeric,\n    requireLowercase,\n    requireUppercase,\n    requireSymbols,\n    charset,\n    pattern,\n  } = options;\n\n  if (length !== undefined && str.length !== length) {\n    errors.push(`Length must be exactly ${length}, got ${str.length}.`);\n  }\n\n  if (minLength !== undefined && str.length < minLength) {\n    errors.push(`Length must be at least ${minLength}, got ${str.length}.`);\n  }\n\n  if (maxLength !== undefined && str.length > maxLength) {\n    errors.push(`Length must be at most ${maxLength}, got ${str.length}.`);\n  }\n\n  if (requireNumeric && !DIGIT_RE.test(str)) {\n    errors.push('Must contain at least one numeric digit.');\n  }\n\n  if (requireLowercase && !LOWER_RE.test(str)) {\n    errors.push('Must contain at least one lowercase letter.');\n  }\n\n  if (requireUppercase && !UPPER_RE.test(str)) {\n    errors.push('Must contain at least one uppercase letter.');\n  }\n\n  if (requireSymbols && !SYMBOL_RE.test(str)) {\n    errors.push('Must contain at least one symbol.');\n  }\n\n  if (charset !== undefined) {\n    const charsetSet = new Set(charset);\n    const invalidChars = [...new Set(str)].filter(ch => !charsetSet.has(ch));\n    if (invalidChars.length > 0) {\n      errors.push(\n        `Contains characters not in the allowed charset: ${invalidChars.map(c => JSON.stringify(c)).join(', ')}.`\n      );\n    }\n  }\n\n  if (pattern !== undefined) {\n    const patternErrors = validatePattern(str, pattern);\n    errors.push(...patternErrors);\n  }\n\n  return { valid: errors.length === 0, errors };\n}\n\nfunction validatePattern(str: string, pattern: string): string[] {\n  const errors: string[] = [];\n  const expandedPattern: Array<{ type: 'literal' | 'placeholder'; value: string }> = [];\n\n  let i = 0;\n  while (i < pattern.length) {\n    const ch = pattern[i] as string;\n    if (ch === '\\\\' && i + 1 < pattern.length) {\n      expandedPattern.push({ type: 'literal', value: pattern[i + 1] as string });\n      i += 2;\n    } else if (['#', 'A', 'a', '*', '?'].includes(ch)) {\n      expandedPattern.push({ type: 'placeholder', value: ch });\n      i++;\n    } else {\n      expandedPattern.push({ type: 'literal', value: ch });\n      i++;\n    }\n  }\n\n  if (str.length !== expandedPattern.length) {\n    errors.push(\n      `Pattern expects length ${expandedPattern.length}, got ${str.length}.`\n    );\n    return errors;\n  }\n\n  for (let pos = 0; pos < expandedPattern.length; pos++) {\n    const token = expandedPattern[pos]!;\n    const ch = str[pos] as string;\n\n    if (token.type === 'literal') {\n      if (ch !== token.value) {\n        errors.push(\n          `Position ${pos}: expected literal '${token.value}', got '${ch}'.`\n        );\n      }\n    } else {\n      switch (token.value) {\n        case '#':\n          if (!DIGIT_RE.test(ch)) {\n            errors.push(`Position ${pos}: '#' expects a digit, got '${ch}'.`);\n          }\n          break;\n        case 'A':\n          if (!/[A-Z]/.test(ch)) {\n            errors.push(`Position ${pos}: 'A' expects an uppercase letter, got '${ch}'.`);\n          }\n          break;\n        case 'a':\n          if (!LOWER_RE.test(ch)) {\n            errors.push(`Position ${pos}: 'a' expects a lowercase letter, got '${ch}'.`);\n          }\n          break;\n        case '?':\n          if (!/[a-zA-Z0-9]/.test(ch)) {\n            errors.push(`Position ${pos}: '?' expects an alphanumeric character, got '${ch}'.`);\n          }\n          break;\n        case '*':\n          // Any character is valid\n          break;\n      }\n    }\n  }\n\n  return errors;\n}\n","/**\n * zod.ts\n * Zod schema factory for @ppabari/strio.\n *\n * Creates a `z.string()` schema that validates a string against strio\n * options. The Zod peer dependency is optional — import from the\n * subpath `@ppabari/strio/zod` only when Zod is available.\n *\n * @example\n * import { z } from 'zod';\n * import { randomStringSchema } from '@ppabari/strio/zod';\n *\n * const tokenSchema = randomStringSchema({\n *   length: 32,\n *   charset: 'base62',\n * });\n *\n * tokenSchema.parse('k3Xp9mQr2LzYw7NvTq8sHfGbJ5cD4eAK'); // ✓\n * tokenSchema.parse('short'); // throws ZodError\n *\n * // In a form schema\n * const UserSchema = z.object({\n *   id: randomStringSchema({ length: 12, charset: 'base58' }),\n *   apiKey: randomStringSchema({ length: 32 }),\n * });\n */\n\nimport type { ValidateOptions } from './types.js';\nimport { validateRandomString } from './validate.js';\n\n/**\n * Options for building a Zod schema. A superset of ValidateOptions\n * with an extra `description` for the schema's `.describe()` call.\n */\nexport interface RandomStringSchemaOptions extends ValidateOptions {\n  /** Optional human-readable description added to the Zod schema. */\n  description?: string;\n}\n\n/**\n * A minimal type shim for the parts of Zod we need.\n * Avoids importing Zod at the type level so the module loads even when\n * Zod is not installed — errors only at runtime if you try to call this.\n */\ninterface ZodStringLike {\n  refine(\n    check: (val: string) => boolean,\n    params: { message: string }\n  ): ZodStringLike;\n  describe(text: string): ZodStringLike;\n}\n\ninterface ZodLike {\n  string(): ZodStringLike;\n}\n\n/**\n * Create a Zod string schema that validates against strio's ValidateOptions.\n *\n * @param options - Validation rules (length, charset, required character types, etc.)\n * @param zod - The `z` object from zod. Pass explicitly to avoid a hard dependency.\n *\n * @example\n * import { z } from 'zod';\n * import { randomStringSchema } from '@ppabari/strio/zod';\n *\n * const schema = randomStringSchema({ length: 16, requireUppercase: true }, z);\n */\nexport function randomStringSchema(\n  options: RandomStringSchemaOptions = {},\n  zod?: ZodLike\n): ZodStringLike {\n  // Attempt to auto-import Zod if not provided — works in Node/bundler envs\n  // Falls back gracefully with a helpful error if unavailable\n  let z: ZodLike;\n\n  if (zod) {\n    z = zod;\n  } else {\n    try {\n      // Use indirect eval to avoid TypeScript's require type check.\n      // This is intentional: zod is an optional peer dependency.\n      const req = (typeof globalThis !== 'undefined' &&\n        (globalThis as Record<string, unknown>)['require']) as\n        | ((id: string) => ZodLike)\n        | undefined;\n      z = req ? req('zod') : (() => { throw new Error('no require'); })();\n    } catch {\n      throw new Error(\n        '@ppabari/strio: Zod is not installed. Run `npm install zod` or pass the `z` ' +\n        'object explicitly: `randomStringSchema(options, z)`.'\n      );\n    }\n  }\n\n  const { description, ...validateOpts } = options;\n\n  let schema = z.string().refine(\n    (val: string) => {\n      const result = validateRandomString(val, validateOpts);\n      return result.valid;\n    },\n    {\n      message: buildMessage(validateOpts),\n    }\n  );\n\n  if (description) {\n    schema = schema.describe(description);\n  }\n\n  return schema;\n}\n\nfunction buildMessage(opts: ValidateOptions): string {\n  const parts: string[] = [];\n\n  if (opts.length !== undefined) parts.push(`exactly ${opts.length} characters`);\n  if (opts.minLength !== undefined) parts.push(`at least ${opts.minLength} characters`);\n  if (opts.maxLength !== undefined) parts.push(`at most ${opts.maxLength} characters`);\n  if (opts.requireNumeric) parts.push('at least one digit');\n  if (opts.requireLowercase) parts.push('at least one lowercase letter');\n  if (opts.requireUppercase) parts.push('at least one uppercase letter');\n  if (opts.requireSymbols) parts.push('at least one symbol');\n  if (opts.charset) parts.push(`only characters from '${opts.charset}'`);\n  if (opts.pattern) parts.push(`matching pattern '${opts.pattern}'`);\n\n  return parts.length > 0\n    ? `String must contain ${parts.join(', ')}.`\n    : 'Invalid string format.';\n}\n"]}

package/dist/zod.d.cts

@@ -0,0 +1 @@
+export { b as RandomStringSchemaOptions, r as randomStringSchema } from './zod-CINbFpp9.cjs';

package/dist/zod.d.ts

@@ -0,0 +1 @@
+export { b as RandomStringSchemaOptions, r as randomStringSchema } from './zod-CINbFpp9.js';

package/dist/zod.js

@@ -0,0 +1,163 @@
+// src/validate.ts
+var DIGIT_RE = /[0-9]/;
+var LOWER_RE = /[a-z]/;
+var UPPER_RE = /[A-Z]/;
+var SYMBOL_RE = /[!@#$%^&*()_+\[\]{}<>?]/;
+function validateRandomString(str, options = {}) {
+  const errors = [];
+  const {
+    minLength,
+    maxLength,
+    length,
+    requireNumeric,
+    requireLowercase,
+    requireUppercase,
+    requireSymbols,
+    charset,
+    pattern
+  } = options;
+  if (length !== void 0 && str.length !== length) {
+    errors.push(`Length must be exactly ${length}, got ${str.length}.`);
+  }
+  if (minLength !== void 0 && str.length < minLength) {
+    errors.push(`Length must be at least ${minLength}, got ${str.length}.`);
+  }
+  if (maxLength !== void 0 && str.length > maxLength) {
+    errors.push(`Length must be at most ${maxLength}, got ${str.length}.`);
+  }
+  if (requireNumeric && !DIGIT_RE.test(str)) {
+    errors.push("Must contain at least one numeric digit.");
+  }
+  if (requireLowercase && !LOWER_RE.test(str)) {
+    errors.push("Must contain at least one lowercase letter.");
+  }
+  if (requireUppercase && !UPPER_RE.test(str)) {
+    errors.push("Must contain at least one uppercase letter.");
+  }
+  if (requireSymbols && !SYMBOL_RE.test(str)) {
+    errors.push("Must contain at least one symbol.");
+  }
+  if (charset !== void 0) {
+    const charsetSet = new Set(charset);
+    const invalidChars = [...new Set(str)].filter((ch) => !charsetSet.has(ch));
+    if (invalidChars.length > 0) {
+      errors.push(
+        `Contains characters not in the allowed charset: ${invalidChars.map((c) => JSON.stringify(c)).join(", ")}.`
+      );
+    }
+  }
+  if (pattern !== void 0) {
+    const patternErrors = validatePattern(str, pattern);
+    errors.push(...patternErrors);
+  }
+  return { valid: errors.length === 0, errors };
+}
+function validatePattern(str, pattern) {
+  const errors = [];
+  const expandedPattern = [];
+  let i = 0;
+  while (i < pattern.length) {
+    const ch = pattern[i];
+    if (ch === "\\" && i + 1 < pattern.length) {
+      expandedPattern.push({ type: "literal", value: pattern[i + 1] });
+      i += 2;
+    } else if (["#", "A", "a", "*", "?"].includes(ch)) {
+      expandedPattern.push({ type: "placeholder", value: ch });
+      i++;
+    } else {
+      expandedPattern.push({ type: "literal", value: ch });
+      i++;
+    }
+  }
+  if (str.length !== expandedPattern.length) {
+    errors.push(
+      `Pattern expects length ${expandedPattern.length}, got ${str.length}.`
+    );
+    return errors;
+  }
+  for (let pos = 0; pos < expandedPattern.length; pos++) {
+    const token = expandedPattern[pos];
+    const ch = str[pos];
+    if (token.type === "literal") {
+      if (ch !== token.value) {
+        errors.push(
+          `Position ${pos}: expected literal '${token.value}', got '${ch}'.`
+        );
+      }
+    } else {
+      switch (token.value) {
+        case "#":
+          if (!DIGIT_RE.test(ch)) {
+            errors.push(`Position ${pos}: '#' expects a digit, got '${ch}'.`);
+          }
+          break;
+        case "A":
+          if (!/[A-Z]/.test(ch)) {
+            errors.push(`Position ${pos}: 'A' expects an uppercase letter, got '${ch}'.`);
+          }
+          break;
+        case "a":
+          if (!LOWER_RE.test(ch)) {
+            errors.push(`Position ${pos}: 'a' expects a lowercase letter, got '${ch}'.`);
+          }
+          break;
+        case "?":
+          if (!/[a-zA-Z0-9]/.test(ch)) {
+            errors.push(`Position ${pos}: '?' expects an alphanumeric character, got '${ch}'.`);
+          }
+          break;
+      }
+    }
+  }
+  return errors;
+}
+
+// src/zod.ts
+function randomStringSchema(options = {}, zod) {
+  let z;
+  if (zod) {
+    z = zod;
+  } else {
+    try {
+      const req = typeof globalThis !== "undefined" && globalThis["require"];
+      z = req ? req("zod") : (() => {
+        throw new Error("no require");
+      })();
+    } catch {
+      throw new Error(
+        "@ppabari/strio: Zod is not installed. Run `npm install zod` or pass the `z` object explicitly: `randomStringSchema(options, z)`."
+      );
+    }
+  }
+  const { description, ...validateOpts } = options;
+  let schema = z.string().refine(
+    (val) => {
+      const result = validateRandomString(val, validateOpts);
+      return result.valid;
+    },
+    {
+      message: buildMessage(validateOpts)
+    }
+  );
+  if (description) {
+    schema = schema.describe(description);
+  }
+  return schema;
+}
+function buildMessage(opts) {
+  const parts = [];
+  if (opts.length !== void 0) parts.push(`exactly ${opts.length} characters`);
+  if (opts.minLength !== void 0) parts.push(`at least ${opts.minLength} characters`);
+  if (opts.maxLength !== void 0) parts.push(`at most ${opts.maxLength} characters`);
+  if (opts.requireNumeric) parts.push("at least one digit");
+  if (opts.requireLowercase) parts.push("at least one lowercase letter");
+  if (opts.requireUppercase) parts.push("at least one uppercase letter");
+  if (opts.requireSymbols) parts.push("at least one symbol");
+  if (opts.charset) parts.push(`only characters from '${opts.charset}'`);
+  if (opts.pattern) parts.push(`matching pattern '${opts.pattern}'`);
+  return parts.length > 0 ? `String must contain ${parts.join(", ")}.` : "Invalid string format.";
+}
+
+export { randomStringSchema };
+//# sourceMappingURL=zod.js.map
+//# sourceMappingURL=zod.js.map

package/dist/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/validate.ts","../src/zod.ts"],"names":[],"mappings":"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","file":"zod.js","sourcesContent":["/**\n * validate.ts\n * Validate that a string conforms to a given RandomStringOptions config.\n */\n\nimport type { ValidateOptions, ValidationResult } from './types.js';\n\nconst DIGIT_RE = /[0-9]/;\nconst LOWER_RE = /[a-z]/;\nconst UPPER_RE = /[A-Z]/;\nconst SYMBOL_RE = /[!@#$%^&*()_+\\[\\]{}<>?]/;\n\n/**\n * Checks whether `str` satisfies the given validation rules.\n *\n * @example\n * const result = validateRandomString('abc123', {\n *   minLength: 6,\n *   requireNumeric: true,\n *   requireLowercase: true,\n * });\n * result.valid; // true\n *\n * @example\n * const result = validateRandomString('abc', { requireNumeric: true });\n * result.valid;  // false\n * result.errors; // ['Must contain at least one numeric digit.']\n */\nexport function validateRandomString(\n  str: string,\n  options: ValidateOptions = {}\n): ValidationResult {\n  const errors: string[] = [];\n  const {\n    minLength,\n    maxLength,\n    length,\n    requireNumeric,\n    requireLowercase,\n    requireUppercase,\n    requireSymbols,\n    charset,\n    pattern,\n  } = options;\n\n  if (length !== undefined && str.length !== length) {\n    errors.push(`Length must be exactly ${length}, got ${str.length}.`);\n  }\n\n  if (minLength !== undefined && str.length < minLength) {\n    errors.push(`Length must be at least ${minLength}, got ${str.length}.`);\n  }\n\n  if (maxLength !== undefined && str.length > maxLength) {\n    errors.push(`Length must be at most ${maxLength}, got ${str.length}.`);\n  }\n\n  if (requireNumeric && !DIGIT_RE.test(str)) {\n    errors.push('Must contain at least one numeric digit.');\n  }\n\n  if (requireLowercase && !LOWER_RE.test(str)) {\n    errors.push('Must contain at least one lowercase letter.');\n  }\n\n  if (requireUppercase && !UPPER_RE.test(str)) {\n    errors.push('Must contain at least one uppercase letter.');\n  }\n\n  if (requireSymbols && !SYMBOL_RE.test(str)) {\n    errors.push('Must contain at least one symbol.');\n  }\n\n  if (charset !== undefined) {\n    const charsetSet = new Set(charset);\n    const invalidChars = [...new Set(str)].filter(ch => !charsetSet.has(ch));\n    if (invalidChars.length > 0) {\n      errors.push(\n        `Contains characters not in the allowed charset: ${invalidChars.map(c => JSON.stringify(c)).join(', ')}.`\n      );\n    }\n  }\n\n  if (pattern !== undefined) {\n    const patternErrors = validatePattern(str, pattern);\n    errors.push(...patternErrors);\n  }\n\n  return { valid: errors.length === 0, errors };\n}\n\nfunction validatePattern(str: string, pattern: string): string[] {\n  const errors: string[] = [];\n  const expandedPattern: Array<{ type: 'literal' | 'placeholder'; value: string }> = [];\n\n  let i = 0;\n  while (i < pattern.length) {\n    const ch = pattern[i] as string;\n    if (ch === '\\\\' && i + 1 < pattern.length) {\n      expandedPattern.push({ type: 'literal', value: pattern[i + 1] as string });\n      i += 2;\n    } else if (['#', 'A', 'a', '*', '?'].includes(ch)) {\n      expandedPattern.push({ type: 'placeholder', value: ch });\n      i++;\n    } else {\n      expandedPattern.push({ type: 'literal', value: ch });\n      i++;\n    }\n  }\n\n  if (str.length !== expandedPattern.length) {\n    errors.push(\n      `Pattern expects length ${expandedPattern.length}, got ${str.length}.`\n    );\n    return errors;\n  }\n\n  for (let pos = 0; pos < expandedPattern.length; pos++) {\n    const token = expandedPattern[pos]!;\n    const ch = str[pos] as string;\n\n    if (token.type === 'literal') {\n      if (ch !== token.value) {\n        errors.push(\n          `Position ${pos}: expected literal '${token.value}', got '${ch}'.`\n        );\n      }\n    } else {\n      switch (token.value) {\n        case '#':\n          if (!DIGIT_RE.test(ch)) {\n            errors.push(`Position ${pos}: '#' expects a digit, got '${ch}'.`);\n          }\n          break;\n        case 'A':\n          if (!/[A-Z]/.test(ch)) {\n            errors.push(`Position ${pos}: 'A' expects an uppercase letter, got '${ch}'.`);\n          }\n          break;\n        case 'a':\n          if (!LOWER_RE.test(ch)) {\n            errors.push(`Position ${pos}: 'a' expects a lowercase letter, got '${ch}'.`);\n          }\n          break;\n        case '?':\n          if (!/[a-zA-Z0-9]/.test(ch)) {\n            errors.push(`Position ${pos}: '?' expects an alphanumeric character, got '${ch}'.`);\n          }\n          break;\n        case '*':\n          // Any character is valid\n          break;\n      }\n    }\n  }\n\n  return errors;\n}\n","/**\n * zod.ts\n * Zod schema factory for @ppabari/strio.\n *\n * Creates a `z.string()` schema that validates a string against strio\n * options. The Zod peer dependency is optional — import from the\n * subpath `@ppabari/strio/zod` only when Zod is available.\n *\n * @example\n * import { z } from 'zod';\n * import { randomStringSchema } from '@ppabari/strio/zod';\n *\n * const tokenSchema = randomStringSchema({\n *   length: 32,\n *   charset: 'base62',\n * });\n *\n * tokenSchema.parse('k3Xp9mQr2LzYw7NvTq8sHfGbJ5cD4eAK'); // ✓\n * tokenSchema.parse('short'); // throws ZodError\n *\n * // In a form schema\n * const UserSchema = z.object({\n *   id: randomStringSchema({ length: 12, charset: 'base58' }),\n *   apiKey: randomStringSchema({ length: 32 }),\n * });\n */\n\nimport type { ValidateOptions } from './types.js';\nimport { validateRandomString } from './validate.js';\n\n/**\n * Options for building a Zod schema. A superset of ValidateOptions\n * with an extra `description` for the schema's `.describe()` call.\n */\nexport interface RandomStringSchemaOptions extends ValidateOptions {\n  /** Optional human-readable description added to the Zod schema. */\n  description?: string;\n}\n\n/**\n * A minimal type shim for the parts of Zod we need.\n * Avoids importing Zod at the type level so the module loads even when\n * Zod is not installed — errors only at runtime if you try to call this.\n */\ninterface ZodStringLike {\n  refine(\n    check: (val: string) => boolean,\n    params: { message: string }\n  ): ZodStringLike;\n  describe(text: string): ZodStringLike;\n}\n\ninterface ZodLike {\n  string(): ZodStringLike;\n}\n\n/**\n * Create a Zod string schema that validates against strio's ValidateOptions.\n *\n * @param options - Validation rules (length, charset, required character types, etc.)\n * @param zod - The `z` object from zod. Pass explicitly to avoid a hard dependency.\n *\n * @example\n * import { z } from 'zod';\n * import { randomStringSchema } from '@ppabari/strio/zod';\n *\n * const schema = randomStringSchema({ length: 16, requireUppercase: true }, z);\n */\nexport function randomStringSchema(\n  options: RandomStringSchemaOptions = {},\n  zod?: ZodLike\n): ZodStringLike {\n  // Attempt to auto-import Zod if not provided — works in Node/bundler envs\n  // Falls back gracefully with a helpful error if unavailable\n  let z: ZodLike;\n\n  if (zod) {\n    z = zod;\n  } else {\n    try {\n      // Use indirect eval to avoid TypeScript's require type check.\n      // This is intentional: zod is an optional peer dependency.\n      const req = (typeof globalThis !== 'undefined' &&\n        (globalThis as Record<string, unknown>)['require']) as\n        | ((id: string) => ZodLike)\n        | undefined;\n      z = req ? req('zod') : (() => { throw new Error('no require'); })();\n    } catch {\n      throw new Error(\n        '@ppabari/strio: Zod is not installed. Run `npm install zod` or pass the `z` ' +\n        'object explicitly: `randomStringSchema(options, z)`.'\n      );\n    }\n  }\n\n  const { description, ...validateOpts } = options;\n\n  let schema = z.string().refine(\n    (val: string) => {\n      const result = validateRandomString(val, validateOpts);\n      return result.valid;\n    },\n    {\n      message: buildMessage(validateOpts),\n    }\n  );\n\n  if (description) {\n    schema = schema.describe(description);\n  }\n\n  return schema;\n}\n\nfunction buildMessage(opts: ValidateOptions): string {\n  const parts: string[] = [];\n\n  if (opts.length !== undefined) parts.push(`exactly ${opts.length} characters`);\n  if (opts.minLength !== undefined) parts.push(`at least ${opts.minLength} characters`);\n  if (opts.maxLength !== undefined) parts.push(`at most ${opts.maxLength} characters`);\n  if (opts.requireNumeric) parts.push('at least one digit');\n  if (opts.requireLowercase) parts.push('at least one lowercase letter');\n  if (opts.requireUppercase) parts.push('at least one uppercase letter');\n  if (opts.requireSymbols) parts.push('at least one symbol');\n  if (opts.charset) parts.push(`only characters from '${opts.charset}'`);\n  if (opts.pattern) parts.push(`matching pattern '${opts.pattern}'`);\n\n  return parts.length > 0\n    ? `String must contain ${parts.join(', ')}.`\n    : 'Invalid string format.';\n}\n"]}