@dbx-tools/shared-core 0.3.43 → 0.4.0

package/lib/src/brand.js

@@ -0,0 +1,123 @@
+/**
+ * Browser-safe brand contract, defaults, and LLM serialization helpers.
+ *
+ * Asset values are intentionally strings: they may be relative file paths,
+ * package exports, data URLs, or network URLs depending on the consumer.
+ *
+ * @module
+ */
+import { z } from "zod";
+const nonBlankString = z.string().trim().min(1);
+const color = z.string().regex(/^#(?:[\da-f]{3}|[\da-f]{6}|[\da-f]{8})$/i, "Expected a hex color.");
+export const DEFAULT_BRAND_ASSETS = {
+    icon: {
+        light: "@dbx-tools/ui-branding/assets/icon-light.svg",
+        dark: "@dbx-tools/ui-branding/assets/icon-dark.svg",
+    },
+    logo: {
+        light: "@dbx-tools/ui-branding/assets/logo-light.svg",
+        dark: "@dbx-tools/ui-branding/assets/logo-dark.svg",
+    },
+    favicon: "@dbx-tools/ui-branding/assets/icon-light.svg",
+};
+export const BrandAssetSetSchema = z
+    .object({
+    light: nonBlankString.describe("Asset for light surfaces."),
+    dark: nonBlankString.optional().describe("Asset for dark surfaces; light is the fallback."),
+})
+    .strict()
+    .describe("Theme-aware references to one visual asset.");
+export const BrandColorsSchema = z
+    .object({
+    primary: color.default("#FF3621").describe("Primary action and identity color."),
+    primaryHover: color.default("#D92D18").describe("Primary hover or pressed color."),
+    accent: color.default("#2EB88A").describe("Secondary accent color."),
+    foreground: color.default("#0B2026").describe("Default text and mark color."),
+    background: color.default("#FFFFFF").describe("Default page background."),
+    surface: color.default("#F6F7F8").describe("Secondary surface background."),
+    muted: color.default("#5F6B70").describe("Muted text color."),
+    border: color.default("#DCE2E5").describe("Default border color."),
+})
+    .strict()
+    .prefault({});
+export const BrandVoiceSchema = z
+    .object({
+    audience: z
+        .array(nonBlankString)
+        .default(["Databricks developers", "application engineers", "AI agents"]),
+    tone: z.array(nonBlankString).default(["direct", "practical", "technical", "approachable"]),
+    principles: z
+        .array(nonBlankString)
+        .default([
+        "Lead with the useful outcome.",
+        "Prefer concrete examples and accurate technical language.",
+        "Keep product claims specific and defensible.",
+    ]),
+    avoid: z
+        .array(nonBlankString)
+        .default(["unsupported superlatives", "vague AI claims", "unnecessary jargon"]),
+})
+    .strict()
+    .prefault({});
+export const BrandContextSchema = z
+    .object({
+    schemaVersion: z.literal("1").default("1"),
+    name: nonBlankString.default("dbx tools").describe("Canonical display name."),
+    shortName: nonBlankString.default("dbx").describe("Compact name for constrained UI."),
+    tagline: nonBlankString
+        .default("Practical tools for Databricks builders.")
+        .describe("Short product line suitable for a header or metadata."),
+    description: nonBlankString
+        .default("Companion packages for Databricks developers building apps, agents, data workflows, and reusable UI.")
+        .describe("Plain-language product description."),
+    assets: z
+        .object({
+        icon: BrandAssetSetSchema.default(DEFAULT_BRAND_ASSETS.icon),
+        logo: BrandAssetSetSchema.default(DEFAULT_BRAND_ASSETS.logo),
+        favicon: nonBlankString.default(DEFAULT_BRAND_ASSETS.favicon),
+    })
+        .strict()
+        .default(DEFAULT_BRAND_ASSETS),
+    colors: BrandColorsSchema,
+    typography: z
+        .object({
+        sans: nonBlankString.default("Inter, ui-sans-serif, system-ui, sans-serif"),
+        mono: nonBlankString.default("ui-monospace, SFMono-Regular, Menlo, monospace"),
+    })
+        .strict()
+        .prefault({}),
+    voice: BrandVoiceSchema,
+    links: z
+        .object({
+        website: z.string().url().optional(),
+        repository: z.string().url().optional(),
+        documentation: z.string().url().optional(),
+    })
+        .strict()
+        .default({}),
+    extensions: z
+        .record(nonBlankString, z.unknown())
+        .default({})
+        .describe("Namespaced consumer-specific values that do not belong in the portable core."),
+})
+    .strict()
+    .describe("Portable identity, visual, and voice context for UI, libraries, and LLMs.");
+/** Validate input and fill every dbx tools default. */
+export function parseBrandContext(input = {}) {
+    return BrandContextSchema.parse(input);
+}
+export const defaultBrandContext = parseBrandContext();
+/** JSON Schema representation suitable for structured-output and tool definitions. */
+export function brandContextJsonSchema() {
+    return z.toJSONSchema(BrandContextSchema);
+}
+/** Stable prompt block for an LLM that needs to write or design in this brand. */
+export function brandContextPrompt(context = defaultBrandContext) {
+    return [
+        `Use the following ${context.name} brand context for names, visual choices, and writing voice.`,
+        "Treat explicit task instructions as higher priority than this context.",
+        "",
+        JSON.stringify(context, null, 2),
+    ].join("\n");
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJhbmQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYnJhbmQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7R0FPRztBQUNILE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIsTUFBTSxjQUFjLEdBQUcsQ0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLElBQUksRUFBRSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQztBQUNoRCxNQUFNLEtBQUssR0FBRyxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsS0FBSyxDQUFDLDBDQUEwQyxFQUFFLHVCQUF1QixDQUFDLENBQUM7QUFFcEcsTUFBTSxDQUFDLE1BQU0sb0JBQW9CLEdBQUc7SUFDbEMsSUFBSSxFQUFFO1FBQ0osS0FBSyxFQUFFLDhDQUE4QztRQUNyRCxJQUFJLEVBQUUsNkNBQTZDO0tBQ3BEO0lBQ0QsSUFBSSxFQUFFO1FBQ0osS0FBSyxFQUFFLDhDQUE4QztRQUNyRCxJQUFJLEVBQUUsNkNBQTZDO0tBQ3BEO0lBQ0QsT0FBTyxFQUFFLDhDQUE4QztDQUMvQyxDQUFDO0FBRVgsTUFBTSxDQUFDLE1BQU0sbUJBQW1CLEdBQUcsQ0FBQztLQUNqQyxNQUFNLENBQUM7SUFDTixLQUFLLEVBQUUsY0FBYyxDQUFDLFFBQVEsQ0FBQywyQkFBMkIsQ0FBQztJQUMzRCxJQUFJLEVBQUUsY0FBYyxDQUFDLFFBQVEsRUFBRSxDQUFDLFFBQVEsQ0FBQyxpREFBaUQsQ0FBQztDQUM1RixDQUFDO0tBQ0QsTUFBTSxFQUFFO0tBQ1IsUUFBUSxDQUFDLDZDQUE2QyxDQUFDLENBQUM7QUFFM0QsTUFBTSxDQUFDLE1BQU0saUJBQWlCLEdBQUcsQ0FBQztLQUMvQixNQUFNLENBQUM7SUFDTixPQUFPLEVBQUUsS0FBSyxDQUFDLE9BQU8sQ0FBQyxTQUFTLENBQUMsQ0FBQyxRQUFRLENBQUMsb0NBQW9DLENBQUM7SUFDaEYsWUFBWSxFQUFFLEtBQUssQ0FB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QWtCLENBQTRCLENBQUM7QUFDdkUsQ0FBQztBQUVELGtGQUFrRjtBQUNsRixNQUFNLFVBQVUsa0JBQWtCLENBQUMsVUFBd0IsbUJBQW1CO0lBQzVFLE9BQU87UUFDTCxxQkFBcUIsT0FBTyxDQUFDLElBQUksOERBQThEO1FBQy9GLHdFQUF3RTtRQUN4RSxFQUFFO1FBQ0YsSUFBSSxDQUFDLFNBQVMsQ0FBQyxPQUFPLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQztLQUNqQyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztBQUNmLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEJyb3dzZXItc2FmZSBicmFuZCBjb250cmFjdCwgZGVmYXVsdHMsIGFuZCBMTE0gc2VyaWFsaXphdGlvbiBoZWxwZXJzLlxuICpcbiAqIEFzc2V0IHZhbHVlcyBhcmUgaW50ZW50aW9uYWxseSBzdHJpbmdzOiB0aGV5IG1heSBiZSByZWxhdGl2ZSBmaWxlIHBhdGhzLFxuICogcGFja2FnZSBleHBvcnRzLCBkYXRhIFVSTHMsIG9yIG5ldHdvcmsgVVJMcyBkZXBlbmRpbmcgb24gdGhlIGNvbnN1bWVyLlxuICpcbiAqIEBtb2R1bGVcbiAqL1xuaW1wb3J0IHsgeiB9IGZyb20gXCJ6b2RcIjtcblxuY29uc3Qgbm9uQmxhbmtTdHJpbmcgPSB6LnN0cmluZygpLnRyaW0oKS5taW4oMSk7XG5jb25zdCBjb2xvciA9IHouc3RyaW5nKCkucmVnZXgoL14jKD86W1xcZGEtZl17M318W1xcZGEtZl17Nn18W1xcZGEtZl17OH0pJC9pLCBcIkV4cGVjdGVkIGEgaGV4IGNvbG9yLlwiKTtcblxuZXhwb3J0IGNvbnN0IERFRkFVTFRfQlJBTkRfQVNTRVRTID0ge1xuICBpY29uOiB7XG4gICAgbGlnaHQ6IFwiQGRieC10b29scy91aS1icmFuZGluZy9hc3NldHMvaWNvbi1saWdodC5zdmdcIixcbiAgICBkYXJrOiBcIkBkYngtdG9vbHMvdWktYnJhbmRpbmcvYXNzZXRzL2ljb24tZGFyay5zdmdcIixcbiAgfSxcbiAgbG9nbzoge1xuICAgIGxpZ2h0OiBcIkBkYngtdG9vbHMvdWktYnJhbmRpbmcvYXNzZXRzL2xvZ28tbGlnaHQuc3ZnXCIsXG4gICAgZGFyazogXCJAZGJ4LXRvb2xzL3VpLWJyYW5kaW5nL2Fzc2V0cy9sb2dvLWRhcmsuc3ZnXCIsXG4gIH0sXG4gIGZhdmljb246IFwiQGRieC10b29scy91aS1icmFuZGluZy9hc3NldHMvaWNvbi1saWdodC5zdmdcIixcbn0gYXMgY29uc3Q7XG5cbmV4cG9ydCBjb25zdCBCcmFuZEFzc2V0U2V0U2NoZW1hID0gelxuICAub2JqZWN0KHtcbiAgICBsaWdodDogbm9uQmxhbmtTdHJpbmcuZGVzY3JpYmUoXCJBc3NldCBmb3IgbGlnaHQgc3VyZmFjZXMuXCIpLFxuICAgIGRhcms6IG5vbkJsYW5rU3RyaW5nLm9wdGlvbmFsKCkuZGVzY3JpYmUoXCJBc3NldCBmb3IgZGFyayBzdXJmYWNlczsgbGlnaHQgaXMgdGhlIGZhbGxiYWNrLlwiKSxcbiAgfSlcbiAgLnN0cmljdCgpXG4gIC5kZXNjcmliZShcIlRoZW1lLWF3YXJlIHJlZmVyZW5jZXMgdG8gb25lIHZpc3VhbCBhc3NldC5cIik7XG5cbmV4cG9ydCBjb25zdCBCcmFuZENvbG9yc1NjaGVtYSA9IHpcbiAgLm9iamVjdCh7XG4gICAgcHJpbWFyeTogY29sb3IuZGVmYXVsdChcIiNGRjM2MjFcIikuZGVzY3JpYmUoXCJQcmltYXJ5IGFjdGlvbiBhbmQgaWRlbnRpdHkgY29sb3IuXCIpLFxuICAgIHByaW1hcnlIb3ZlcjogY29sb3IuZGVmYXVsdChcIiNEOTJEMThcIikuZGVzY3JpYmUoXCJQcmltYXJ5IGhvdmVyIG9yIHByZXNzZWQgY29sb3IuXCIpLFxuICAgIGFjY2VudDogY29sb3IuZGVmYXVsdChcIiMyRUI4OEFcIikuZGVzY3JpYmUoXCJTZWNvbmRhcnkgYWNjZW50IGNvbG9yLlwiKSxcbiAgICBmb3JlZ3JvdW5kOiBjb2xvci5kZWZhdWx0KFwiIzBCMjAyNlwiKS5kZXNjcmliZShcIkRlZmF1bHQgdGV4dCBhbmQgbWFyayBjb2xvci5cIiksXG4gICAgYmFja2dyb3VuZDogY29sb3IuZGVmYXVsdChcIiNGRkZGRkZcIikuZGVzY3JpYmUoXCJEZWZhdWx0IHBhZ2UgYmFja2dyb3VuZC5cIiksXG4gICAgc3VyZmFjZTogY29sb3IuZGVmYXVsdChcIiNGNkY3RjhcIikuZGVzY3JpYmUoXCJTZWNvbmRhcnkgc3VyZmFjZSBiYWNrZ3JvdW5kLlwiKSxcbiAgICBtdXRlZDogY29sb3IuZGVmYXVsdChcIiM1RjZCNzBcIikuZGVzY3JpYmUoXCJNdXRlZCB0ZXh0IGNvbG9yLlwiKSxcbiAgICBib3JkZXI6IGNvbG9yLmRlZmF1bHQoXCIjRENFMkU1XCIpLmRlc2NyaWJlKFwiRGVmYXVsdCBib3JkZXIgY29sb3IuXCIpLFxuICB9KVxuICAuc3RyaWN0KClcbiAgLnByZWZhdWx0KHt9KTtcblxuZXhwb3J0IGNvbnN0IEJyYW5kVm9pY2VTY2hlbWEgPSB6XG4gIC5vYmplY3Qoe1xuICAgIGF1ZGllbmNlOiB6XG4gICAgICAuYXJyYXkobm9uQmxhbmtTdHJpbmcpXG4gICAgICAuZGVmYXVsdChbXCJEYXRhYnJpY2tzIGRldmVsb3BlcnNcIiwgXCJhcHBsaWNhdGlvbiBlbmdpbmVlcnNcIiwgXCJBSSBhZ2VudHNcIl0pLFxuICAgIHRvbmU6IHouYXJyYXkobm9uQmxhbmtTdHJpbmcpLmRlZmF1bHQoW1wiZGlyZWN0XCIsIFwicHJhY3RpY2FsXCIsIFwidGVjaG5pY2FsXCIsIFwiYXBwcm9hY2hhYmxlXCJdKSxcbiAgICBwcmluY2lwbGVzOiB6XG4gICAgICAuYXJyYXkobm9uQmxhbmtTdHJpbmcpXG4gICAgICAuZGVmYXVsdChbXG4gICAgICAgIFwiTGVhZCB3aXRoIHRoZSB1c2VmdWwgb3V0Y29tZS5cIixcbiAgICAgICAgXCJQcmVmZXIgY29uY3JldGUgZXhhbXBsZXMgYW5kIGFjY3VyYXRlIHRlY2huaWNhbCBsYW5ndWFnZS5cIixcbiAgICAgICAgXCJLZWVwIHByb2R1Y3QgY2xhaW1zIHNwZWNpZmljIGFuZCBkZWZlbnNpYmxlLlwiLFxuICAgICAgXSksXG4gICAgYXZvaWQ6IHpcbiAgICAgIC5hcnJheShub25CbGFua1N0cmluZylcbiAgICAgIC5kZWZhdWx0KFtcInVuc3VwcG9ydGVkIHN1cGVybGF0aXZlc1wiLCBcInZhZ3VlIEFJIGNsYWltc1wiLCBcInVubmVjZXNzYXJ5IGphcmdvblwiXSksXG4gIH0pXG4gIC5zdHJpY3QoKVxuICAucHJlZmF1bHQoe30pO1xuXG5leHBvcnQgY29uc3QgQnJhbmRDb250ZXh0U2NoZW1hID0gelxuICAub2JqZWN0KHtcbiAgICBzY2hlbWFWZXJzaW9uOiB6LmxpdGVyYWwoXCIxXCIpLmRlZmF1bHQoXCIxXCIpLFxuICAgIG5hbWU6IG5vbkJsYW5rU3RyaW5nLmRlZmF1bHQoXCJkYnggdG9vbHNcIikuZGVzY3JpYmUoXCJDYW5vbmljYWwgZGlzcGxheSBuYW1lLlwiKSxcbiAgICBzaG9ydE5hbWU6IG5vbkJsYW5rU3RyaW5nLmRlZmF1bHQoXCJkYnhcIikuZGVzY3JpYmUoXCJDb21wYWN0IG5hbWUgZm9yIGNvbnN0cmFpbmVkIFVJLlwiKSxcbiAgICB0YWdsaW5lOiBub25CbGFua1N0cmluZ1xuICAgICAgLmRlZmF1bHQoXCJQcmFjdGljYWwgdG9vbHMgZm9yIERhdGFicmlja3MgYnVpbGRlcnMuXCIpXG4gICAgICAuZGVzY3JpYmUoXCJTaG9ydCBwcm9kdWN0IGxpbmUgc3VpdGFibGUgZm9yIGEgaGVhZGVyIG9yIG1ldGFkYXRhLlwiKSxcbiAgICBkZXNjcmlwdGlvbjogbm9uQmxhbmtTdHJpbmdcbiAgICAgIC5kZWZhdWx0KFxuICAgICAgICBcIkNvbXBhbmlvbiBwYWNrYWdlcyBmb3IgRGF0YWJyaWNrcyBkZXZlbG9wZXJzIGJ1aWxkaW5nIGFwcHMsIGFnZW50cywgZGF0YSB3b3JrZmxvd3MsIGFuZCByZXVzYWJsZSBVSS5cIixcbiAgICAgIClcbiAgICAgIC5kZXNjcmliZShcIlBsYWluLWxhbmd1YWdlIHByb2R1Y3QgZGVzY3JpcHRpb24uXCIpLFxuICAgIGFzc2V0czogelxuICAgICAgLm9iamVjdCh7XG4gICAgICAgIGljb246IEJyYW5kQXNzZXRTZXRTY2hlbWEuZGVmYXVsdChERUZBVUxUX0JSQU5EX0FTU0VUUy5pY29uKSxcbiAgICAgICAgbG9nbzogQnJhbmRBc3NldFNldFNjaGVtYS5kZWZhdWx0KERFRkFVTFRfQlJBTkRfQVNTRVRTLmxvZ28pLFxuICAgICAgICBmYXZpY29uOiBub25CbGFua1N0cmluZy5kZWZhdWx0KERFRkFVTFRfQlJBTkRfQVNTRVRTLmZhdmljb24pLFxuICAgICAgfSlcbiAgICAgIC5zdHJpY3QoKVxuICAgICAgLmRlZmF1bHQoREVGQVVMVF9CUkFORF9BU1NFVFMpLFxuICAgIGNvbG9yczogQnJhbmRDb2xvcnNTY2hlbWEsXG4gICAgdHlwb2dyYXBoeTogelxuICAgICAgLm9iamVjdCh7XG4gICAgICAgIHNhbnM6IG5vbkJsYW5rU3RyaW5nLmRlZmF1bHQoXCJJbnRlciwgdWktc2Fucy1zZXJpZiwgc3lzdGVtLXVpLCBzYW5zLXNlcmlmXCIpLFxuICAgICAgICBtb25vOiBub25CbGFua1N0cmluZy5kZWZhdWx0KFwidWktbW9ub3NwYWNlLCBTRk1vbm8tUmVndWxhciwgTWVubG8sIG1vbm9zcGFjZVwiKSxcbiAgICAgIH0pXG4gICAgICAuc3RyaWN0KClcbiAgICAgIC5wcmVmYXVsdCh7fSksXG4gICAgdm9pY2U6IEJyYW5kVm9pY2VTY2hlbWEsXG4gICAgbGlua3M6IHpcbiAgICAgIC5vYmplY3Qoe1xuICAgICAgICB3ZWJzaXRlOiB6LnN0cmluZygpLnVybCgpLm9wdGlvbmFsKCksXG4gICAgICAgIHJlcG9zaXRvcnk6IHouc3RyaW5nKCkudXJsKCkub3B0aW9uYWwoKSxcbiAgICAgICAgZG9jdW1lbnRhdGlvbjogei5zdHJpbmcoKS51cmwoKS5vcHRpb25hbCgpLFxuICAgICAgfSlcbiAgICAgIC5zdHJpY3QoKVxuICAgICAgLmRlZmF1bHQoe30pLFxuICAgIGV4dGVuc2lvbnM6IHpcbiAgICAgIC5yZWNvcmQobm9uQmxhbmtTdHJpbmcsIHoudW5rbm93bigpKVxuICAgICAgLmRlZmF1bHQoe30pXG4gICAgICAuZGVzY3JpYmUoXCJOYW1lc3BhY2VkIGNvbnN1bWVyLXNwZWNpZmljIHZhbHVlcyB0aGF0IGRvIG5vdCBiZWxvbmcgaW4gdGhlIHBvcnRhYmxlIGNvcmUuXCIpLFxuICB9KVxuICAuc3RyaWN0KClcbiAgLmRlc2NyaWJlKFwiUG9ydGFibGUgaWRlbnRpdHksIHZpc3VhbCwgYW5kIHZvaWNlIGNvbnRleHQgZm9yIFVJLCBsaWJyYXJpZXMsIGFuZCBMTE1zLlwiKTtcblxuZXhwb3J0IHR5cGUgQnJhbmRDb250ZXh0ID0gei5vdXRwdXQ8dHlwZW9mIEJyYW5kQ29udGV4dFNjaGVtYT47XG5leHBvcnQgdHlwZSBCcmFuZENvbnRleHRJbnB1dCA9IHouaW5wdXQ8dHlwZW9mIEJyYW5kQ29udGV4dFNjaGVtYT47XG5leHBvcnQgdHlwZSBCcmFuZEFzc2V0U2V0ID0gei5vdXRwdXQ8dHlwZW9mIEJyYW5kQXNzZXRTZXRTY2hlbWE+O1xuXG4vKiogVmFsaWRhdGUgaW5wdXQgYW5kIGZpbGwgZXZlcnkgZGJ4IHRvb2xzIGRlZmF1bHQuICovXG5leHBvcnQgZnVuY3Rpb24gcGFyc2VCcmFuZENvbnRleHQoaW5wdXQ6IHVua25vd24gPSB7fSk6IEJyYW5kQ29udGV4dCB7XG4gIHJldHVybiBCcmFuZENvbnRleHRTY2hlbWEucGFyc2UoaW5wdXQpO1xufVxuXG5leHBvcnQgY29uc3QgZGVmYXVsdEJyYW5kQ29udGV4dDogQnJhbmRDb250ZXh0ID0gcGFyc2VCcmFuZENvbnRleHQoKTtcblxuLyoqIEpTT04gU2NoZW1hIHJlcHJlc2VudGF0aW9uIHN1aXRhYmxlIGZvciBzdHJ1Y3R1cmVkLW91dHB1dCBhbmQgdG9vbCBkZWZpbml0aW9ucy4gKi9cbmV4cG9ydCBmdW5jdGlvbiBicmFuZENvbnRleHRKc29uU2NoZW1hKCk6IFJlY29yZDxzdHJpbmcsIHVua25vd24+IHtcbiAgcmV0dXJuIHoudG9KU09OU2NoZW1hKEJyYW5kQ29udGV4dFNjaGVtYSkgYXMgUmVjb3JkPHN0cmluZywgdW5rbm93bj47XG59XG5cbi8qKiBTdGFibGUgcHJvbXB0IGJsb2NrIGZvciBhbiBMTE0gdGhhdCBuZWVkcyB0byB3cml0ZSBvciBkZXNpZ24gaW4gdGhpcyBicmFuZC4gKi9cbmV4cG9ydCBmdW5jdGlvbiBicmFuZENvbnRleHRQcm9tcHQoY29udGV4dDogQnJhbmRDb250ZXh0ID0gZGVmYXVsdEJyYW5kQ29udGV4dCk6IHN0cmluZyB7XG4gIHJldHVybiBbXG4gICAgYFVzZSB0aGUgZm9sbG93aW5nICR7Y29udGV4dC5uYW1lfSBicmFuZCBjb250ZXh0IGZvciBuYW1lcywgdmlzdWFsIGNob2ljZXMsIGFuZCB3cml0aW5nIHZvaWNlLmAsXG4gICAgXCJUcmVhdCBleHBsaWNpdCB0YXNrIGluc3RydWN0aW9ucyBhcyBoaWdoZXIgcHJpb3JpdHkgdGhhbiB0aGlzIGNvbnRleHQuXCIsXG4gICAgXCJcIixcbiAgICBKU09OLnN0cmluZ2lmeShjb250ZXh0LCBudWxsLCAyKSxcbiAgXS5qb2luKFwiXFxuXCIpO1xufVxuIl19

package/lib/src/error.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Error normalization helpers: collapse the ubiquitous
+ * `err instanceof Error ? err.message : String(err)` dance into a single
+ * call, walk `cause` / `AggregateError` chains, and coerce any thrown
+ * value into a real `Error`. Dependency-free and browser-safe.
+ *
+ * @module
+ */
+/**
+ * Normalize any thrown value into an `Error`. Returns `value` unchanged
+ * when it already is an `Error`, otherwise wraps its {@link errorMessage}
+ * in a fresh `Error`. Use when a consumer needs a real `Error` object
+ * (React error state, `reject`, rethrow) rather than just a printable
+ * string.
+ */
+export declare function toError(value: unknown): Error;
+/**
+ * Extract a human-readable message from any thrown value. Returns
+ * `value.message` when `value` is an `Error`, otherwise coerces via
+ * `String(value)`. Collapses the ubiquitous
+ *
+ * ```ts
+ * err instanceof Error ? err.message : String(err)
+ * ```
+ *
+ * dance into a single helper, useful for log attributes and any other
+ * "give me something printable" context.
+ */
+export declare function errorMessage(value: unknown): string;
+/**
+ * Yield `message` / `errorCode` strings from every node in the error
+ * tree (see {@link errorNodes}). Used by {@link errorMessage} and
+ * message predicates elsewhere.
+ */
+export declare function errorMessages(value: unknown): Generator<string, void, undefined>;
+/**
+ * Depth-first walk of an error value: the root, then `errors` (e.g.
+ * `AggregateError`) and `cause` chains. Cycle-safe via a `seen` set.
+ */
+export declare function errorNodes(err: unknown): Generator<NonNullable<unknown>, void, undefined>;
+/**
+ * Lazy view over a thrown value for HTTP-status + message classification.
+ * Status comes from the last positive `statusCode` / `code` on the error tree;
+ * messages/tokens come from every `message` / `errorCode` field (including
+ * `cause` and `AggregateError.errors`). Build with {@link errorContext}.
+ */
+export type ErrorContext = ErrorContextImpl;
+declare class ErrorContextImpl {
+    private readonly err;
+    private _statusCode;
+    private _messages;
+    private _messageTokens;
+    constructor(err: NonNullable<unknown>);
+    /** Last positive `statusCode` / `code` found on the error tree, else `undefined` (0 ignored). */
+    get statusCode(): number | undefined;
+    /** Every `message` / `errorCode` string in the error tree. */
+    get messages(): string[];
+    /** Lowercased tokens from {@link messages}. */
+    get messageTokens(): string[];
+    /** True for any 4xx status or message tokens `not exist` / `not found`. */
+    get notAccessible(): boolean;
+    /**
+     * Match HTTP status. Pass a full code (`404`) or a class (`4` for any 4xx).
+     * Extra filters are OR'd. `false` when no status is on the error tree.
+     */
+    hasStatusCode(statusCodeFilter: number, ...statusCodeFilters: number[]): boolean;
+    /**
+     * True when every token from the filter phrase(s) appears in
+     * {@link messageTokens}. Each argument is tokenized on non-alphanumeric
+     * boundaries (e.g. `hasMessage("not", "found")` or `hasMessage("not found")`).
+     */
+    hasMessage(messageFilter: string, ...messageFilters: string[]): boolean;
+}
+/** Build an {@link ErrorContext} for status + message checks. `null` / `undefined` become `{}`. */
+export declare function errorContext(err: unknown): ErrorContext;
+export {};

package/lib/src/error.js

@@ -0,0 +1,168 @@
+/**
+ * Error normalization helpers: collapse the ubiquitous
+ * `err instanceof Error ? err.message : String(err)` dance into a single
+ * call, walk `cause` / `AggregateError` chains, and coerce any thrown
+ * value into a real `Error`. Dependency-free and browser-safe.
+ *
+ * @module
+ */
+import { tokenizeWithOptions } from "./string.js";
+/**
+ * Normalize any thrown value into an `Error`. Returns `value` unchanged
+ * when it already is an `Error`, otherwise wraps its {@link errorMessage}
+ * in a fresh `Error`. Use when a consumer needs a real `Error` object
+ * (React error state, `reject`, rethrow) rather than just a printable
+ * string.
+ */
+export function toError(value) {
+    return value instanceof Error ? value : new Error(errorMessage(value));
+}
+/**
+ * Extract a human-readable message from any thrown value. Returns
+ * `value.message` when `value` is an `Error`, otherwise coerces via
+ * `String(value)`. Collapses the ubiquitous
+ *
+ * ```ts
+ * err instanceof Error ? err.message : String(err)
+ * ```
+ *
+ * dance into a single helper, useful for log attributes and any other
+ * "give me something printable" context.
+ */
+export function errorMessage(value) {
+    const message = errorMessages(value).next().value;
+    return message ?? String(value);
+}
+/**
+ * Yield `message` / `errorCode` strings from every node in the error
+ * tree (see {@link errorNodes}). Used by {@link errorMessage} and
+ * message predicates elsewhere.
+ */
+export function* errorMessages(value) {
+    for (const node of errorNodes(value)) {
+        if (typeof node === "object") {
+            for (const key of ["message", "errorCode"]) {
+                if (key in node) {
+                    const value = node[key];
+                    if (typeof value === "string" && value) {
+                        yield value;
+                    }
+                }
+            }
+        }
+        else if (typeof node === "string" && node) {
+            yield node;
+        }
+    }
+}
+/**
+ * Depth-first walk of an error value: the root, then `errors` (e.g.
+ * `AggregateError`) and `cause` chains. Cycle-safe via a `seen` set.
+ */
+export function* errorNodes(err) {
+    const seen = new Set();
+    function* visit(node) {
+        if (node === undefined || node === null)
+            return;
+        if (Array.isArray(node)) {
+            for (const child of node) {
+                yield* visit(child);
+            }
+            return;
+        }
+        if (seen.has(node))
+            return;
+        seen.add(node);
+        yield node;
+        if (typeof node === "object") {
+            for (const key of ["errors", "cause"]) {
+                if (key in node) {
+                    const value = node[key];
+                    yield* visit(value);
+                }
+            }
+        }
+    }
+    yield* visit(err);
+}
+class ErrorContextImpl {
+    err;
+    _statusCode;
+    _messages;
+    _messageTokens;
+    constructor(err) {
+        this.err = err;
+    }
+    /** Last positive `statusCode` / `code` found on the error tree, else `undefined` (0 ignored). */
+    get statusCode() {
+        if (this._statusCode === undefined) {
+            outer: for (const node of errorNodes(this.err)) {
+                if (typeof node !== "object" || node === null)
+                    continue;
+                for (const key of ["statusCode", "code"]) {
+                    if (!(key in node))
+                        continue;
+                    const value = node[key];
+                    if (typeof value === "number" && value > 99 && value < 600) {
+                        this._statusCode = value;
+                        break outer;
+                    }
+                }
+            }
+            if (this._statusCode === undefined) {
+                this._statusCode = -1;
+            }
+        }
+        return this._statusCode == -1 ? undefined : this._statusCode;
+    }
+    /** Every `message` / `errorCode` string in the error tree. */
+    get messages() {
+        if (this._messages === undefined) {
+            this._messages = [...errorMessages(this.err)];
+        }
+        return this._messages;
+    }
+    /** Lowercased tokens from {@link messages}. */
+    get messageTokens() {
+        if (this._messageTokens === undefined) {
+            this._messageTokens = [...tokenizeWithOptions({ lowerCase: true }, ...this.messages)];
+        }
+        return this._messageTokens;
+    }
+    /** True for any 4xx status or message tokens `not exist` / `not found`. */
+    get notAccessible() {
+        if (this.hasStatusCode(4))
+            return true;
+        return this.hasMessage("not", "exist") || this.hasMessage("not", "found");
+    }
+    /**
+     * Match HTTP status. Pass a full code (`404`) or a class (`4` for any 4xx).
+     * Extra filters are OR'd. `false` when no status is on the error tree.
+     */
+    hasStatusCode(statusCodeFilter, ...statusCodeFilters) {
+        const code = this.statusCode;
+        if (code) {
+            for (const filter of [statusCodeFilter, ...statusCodeFilters]) {
+                const match = (filter < 100 ? Math.trunc(code / 100) : code) === filter;
+                if (match)
+                    return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * True when every token from the filter phrase(s) appears in
+     * {@link messageTokens}. Each argument is tokenized on non-alphanumeric
+     * boundaries (e.g. `hasMessage("not", "found")` or `hasMessage("not found")`).
+     */
+    hasMessage(messageFilter, ...messageFilters) {
+        return [messageFilter, ...messageFilters]
+            .flatMap((filter) => Array.from(tokenizeWithOptions({ lowerCase: true }, filter)))
+            .every((filterToken) => this.messageTokens.includes(filterToken));
+    }
+}
+/** Build an {@link ErrorContext} for status + message checks. `null` / `undefined` become `{}`. */
+export function errorContext(err) {
+    return new ErrorContextImpl(err ?? {});
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZXJyb3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7R0FPRztBQUVILE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxNQUFNLFVBQVUsQ0FBQztBQUUvQzs7Ozs7O0dBTUc7QUFDSCxNQUFNLFVBQVUsT0FBTyxDQUFDLEtBQWM7SUFDcEMsT0FBTyxLQUFLLFlBQVksS0FBSyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLElBQUksS0FBSyxDQUFDLFlBQVksQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO0FBQ3pFLENBQUM7QUFFRDs7Ozs7Ozs7Ozs7R0FXRztBQUNILE1BQU0sVUFBVSxZQUFZLENBQUMsS0FBYztJQUN6QyxNQUFNLE9BQU8sR0FBRyxhQUFhLENBQUMsS0FBSyxDQUFDLENBQUMsSUFBSSxFQUFFLENBQUMsS0FBSyxDQUFDO0lBQ2xELE9BQU8sT0FBTyxJQUFJLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQztBQUNsQyxDQUFDO0FBRUQ7Ozs7R0FJRztBQUNILE1BQU0sU0FBUyxDQUFDLENBQUMsYUFBYSxDQUFDLEtBQWM7SUFDM0MsS0FBSyxNQUFNLElBQUksSUFBSSxVQUFVLENBQUMsS0FBSyxDQUFDLEVBQUUsQ0FBQztRQUNyQyxJQUFJLE9BQU8sSUFBSSxLQUFLLFFBQVEsRUFBRSxDQUFDO1lBQzdCLEtBQUssTUFBTSxHQUFHLElBQUksQ0FBQyxTQUFTLEVBQUUsV0FBVyxDQUFDLEVBQUUsQ0FBQztnQkFDM0MsSUFBSSxHQUFHLElBQUksSUFBSSxFQUFFLENBQUM7b0JBQ2hCLE1BQU0sS0FBSyxHQUFJLElBQWdDLENBQUMsR0FBRyxDQUFDLENBQUM7b0JBQ3JELElBQUksT0FBTyxLQUFLLEtBQUssUUFBUSxJQUFJLEtBQUssRUFBRSxDQUFDO3dCQUN2QyxNQUFNLEtBQUssQ0FBQztvQkFDZCxDQUFDO2dCQUNILENBQUM7WUFDSCxD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LENBQUMsSUFBSSxHQUFHLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsS0FBSyxNQUFNLENBQUM7Z0JBQ3hFLElBQUksS0FBSztvQkFBRSxPQUFPLElBQUksQ0FBQztZQUN6QixDQUFDO1FBQ0gsQ0FBQztRQUNELE9BQU8sS0FBSyxDQUFDO0lBQ2YsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxVQUFVLENBQUMsYUFBcUIsRUFBRSxHQUFHLGNBQXdCO1FBQzNELE9BQU8sQ0FBQyxhQUFhLEVBQUUsR0FBRyxjQUFjLENBQUM7YUFDdEMsT0FBTyxDQUFDLENBQUMsTUFBTSxFQUFFLEVBQUUsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLG1CQUFtQixDQUFDLEVBQUUsU0FBUyxFQUFFLElBQUksRUFBRSxFQUFFLE1BQU0sQ0FBQyxDQUFDLENBQUM7YUFDakYsS0FBSyxDQUFDLENBQUMsV0FBVyxFQUFFLEVBQUUsQ0FBQyxJQUFJLENBQUMsYUFBYSxDQUFDLFFBQVEsQ0FBQyxXQUFXLENBQUMsQ0FBQyxDQUFDO0lBQ3RFLENBQUM7Q0FDRjtBQUVELG1HQUFtRztBQUNuRyxNQUFNLFVBQVUsWUFBWSxDQUFDLEdBQVk7SUFDdkMsT0FBTyxJQUFJLGdCQUFnQixDQUFDLEdBQUcsSUFBSSxFQUFFLENBQUMsQ0FBQztBQUN6QyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBFcnJvciBub3JtYWxpemF0aW9uIGhlbHBlcnM6IGNvbGxhcHNlIHRoZSB1YmlxdWl0b3VzXG4gKiBgZXJyIGluc3RhbmNlb2YgRXJyb3IgPyBlcnIubWVzc2FnZSA6IFN0cmluZyhlcnIpYCBkYW5jZSBpbnRvIGEgc2luZ2xlXG4gKiBjYWxsLCB3YWxrIGBjYXVzZWAgLyBgQWdncmVnYXRlRXJyb3JgIGNoYWlucywgYW5kIGNvZXJjZSBhbnkgdGhyb3duXG4gKiB2YWx1ZSBpbnRvIGEgcmVhbCBgRXJyb3JgLiBEZXBlbmRlbmN5LWZyZWUgYW5kIGJyb3dzZXItc2FmZS5cbiAqXG4gKiBAbW9kdWxlXG4gKi9cblxuaW1wb3J0IHsgdG9rZW5pemVXaXRoT3B0aW9ucyB9IGZyb20gXCIuL3N0cmluZ1wiO1xuXG4vKipcbiAqIE5vcm1hbGl6ZSBhbnkgdGhyb3duIHZhbHVlIGludG8gYW4gYEVycm9yYC4gUmV0dXJucyBgdmFsdWVgIHVuY2hhbmdlZFxuICogd2hlbiBpdCBhbHJlYWR5IGlzIGFuIGBFcnJvcmAsIG90aGVyd2lzZSB3cmFwcyBpdHMge0BsaW5rIGVycm9yTWVzc2FnZX1cbiAqIGluIGEgZnJlc2ggYEVycm9yYC4gVXNlIHdoZW4gYSBjb25zdW1lciBuZWVkcyBhIHJlYWwgYEVycm9yYCBvYmplY3RcbiAqIChSZWFjdCBlcnJvciBzdGF0ZSwgYHJlamVjdGAsIHJldGhyb3cpIHJhdGhlciB0aGFuIGp1c3QgYSBwcmludGFibGVcbiAqIHN0cmluZy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHRvRXJyb3IodmFsdWU6IHVua25vd24pOiBFcnJvciB7XG4gIHJldHVybiB2YWx1ZSBpbnN0YW5jZW9mIEVycm9yID8gdmFsdWUgOiBuZXcgRXJyb3IoZXJyb3JNZXNzYWdlKHZhbHVlKSk7XG59XG5cbi8qKlxuICogRXh0cmFjdCBhIGh1bWFuLXJlYWRhYmxlIG1lc3NhZ2UgZnJvbSBhbnkgdGhyb3duIHZhbHVlLiBSZXR1cm5zXG4gKiBgdmFsdWUubWVzc2FnZWAgd2hlbiBgdmFsdWVgIGlzIGFuIGBFcnJvcmAsIG90aGVyd2lzZSBjb2VyY2VzIHZpYVxuICogYFN0cmluZyh2YWx1ZSlgLiBDb2xsYXBzZXMgdGhlIHViaXF1aXRvdXNcbiAqXG4gKiBgYGB0c1xuICogZXJyIGluc3RhbmNlb2YgRXJyb3IgPyBlcnIubWVzc2FnZSA6IFN0cmluZyhlcnIpXG4gKiBgYGBcbiAqXG4gKiBkYW5jZSBpbnRvIGEgc2luZ2xlIGhlbHBlciwgdXNlZnVsIGZvciBsb2cgYXR0cmlidXRlcyBhbmQgYW55IG90aGVyXG4gKiBcImdpdmUgbWUgc29tZXRoaW5nIHByaW50YWJsZVwiIGNvbnRleHQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBlcnJvck1lc3NhZ2UodmFsdWU6IHVua25vd24pOiBzdHJpbmcge1xuICBjb25zdCBtZXNzYWdlID0gZXJyb3JNZXNzYWdlcyh2YWx1ZSkubmV4dCgpLnZhbHVlO1xuICByZXR1cm4gbWVzc2FnZSA/PyBTdHJpbmcodmFsdWUpO1xufVxuXG4vKipcbiAqIFlpZWxkIGBtZXNzYWdlYCAvIGBlcnJvckNvZGVgIHN0cmluZ3MgZnJvbSBldmVyeSBub2RlIGluIHRoZSBlcnJvclxuICogdHJlZSAoc2VlIHtAbGluayBlcnJvck5vZGVzfSkuIFVzZWQgYnkge0BsaW5rIGVycm9yTWVzc2FnZX0gYW5kXG4gKiBtZXNzYWdlIHByZWRpY2F0ZXMgZWxzZXdoZXJlLlxuICovXG5leHBvcnQgZnVuY3Rpb24qIGVycm9yTWVzc2FnZXModmFsdWU6IHVua25vd24pOiBHZW5lcmF0b3I8c3RyaW5nLCB2b2lkLCB1bmRlZmluZWQ+IHtcbiAgZm9yIChjb25zdCBub2RlIG9mIGVycm9yTm9kZXModmFsdWUpKSB7XG4gICAgaWYgKHR5cGVvZiBub2RlID09PSBcIm9iamVjdFwiKSB7XG4gICAgICBmb3IgKGNvbnN0IGtleSBvZiBbXCJtZXNzYWdlXCIsIFwiZXJyb3JDb2RlXCJdKSB7XG4gICAgICAgIGlmIChrZXkgaW4gbm9kZSkge1xuICAgICAgICAgIGNvbnN0IHZhbHVlID0gKG5vZGUgYXMgUmVjb3JkPHN0cmluZywgdW5rbm93bj4pW2tleV07XG4gICAgICAgICAgaWYgKHR5cGVvZiB2YWx1ZSA9PT0gXCJzdHJpbmdcIiAmJiB2YWx1ZSkge1xuICAgICAgICAgICAgeWllbGQgdmFsdWU7XG4gICAgICAgICAgfVxuICAgICAgICB9XG4gICAgICB9XG4gICAgfSBlbHNlIGlmICh0eXBlb2Ygbm9kZSA9PT0gXCJzdHJpbmdcIiAmJiBub2RlKSB7XG4gICAgICB5aWVsZCBub2RlO1xuICAgIH1cbiAgfVxufVxuXG4vKipcbiAqIERlcHRoLWZpcnN0IHdhbGsgb2YgYW4gZXJyb3IgdmFsdWU6IHRoZSByb290LCB0aGVuIGBlcnJvcnNgIChlLmcuXG4gKiBgQWdncmVnYXRlRXJyb3JgKSBhbmQgYGNhdXNlYCBjaGFpbnMuIEN5Y2xlLXNhZmUgdmlhIGEgYHNlZW5gIHNldC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uKiBlcnJvck5vZGVzKGVycjogdW5rbm93bik6IEdlbmVyYXRvcjxOb25OdWxsYWJsZTx1bmtub3duPiwgdm9pZCwgdW5kZWZpbmVkPiB7XG4gIGNvbnN0IHNlZW4gPSBuZXcgU2V0PHVua25vd24+KCk7XG5cbiAgZnVuY3Rpb24qIHZpc2l0KG5vZGU6IHVua25vd24pOiBHZW5lcmF0b3I8Tm9uTnVsbGFibGU8dW5rbm93bj4sIHZvaWQsIHVuZGVmaW5lZD4ge1xuICAgIGlmIChub2RlID09PSB1bmRlZmluZWQgfHwgbm9kZSA9PT0gbnVsbCkgcmV0dXJuO1xuICAgIGlmIChBcnJheS5pc0FycmF5KG5vZGUpKSB7XG4gICAgICBmb3IgKGNvbnN0IGNoaWxkIG9mIG5vZGUpIHtcbiAgICAgICAgeWllbGQqIHZpc2l0KGNoaWxkKTtcbiAgICAgIH1cbiAgICAgIHJldHVybjtcbiAgICB9XG4gICAgaWYgKHNlZW4uaGFzKG5vZGUpKSByZXR1cm47XG4gICAgc2Vlbi5hZGQobm9kZSk7XG4gICAgeWllbGQgbm9kZTtcbiAgICBpZiAodHlwZW9mIG5vZGUgPT09IFwib2JqZWN0XCIpIHtcbiAgICAgIGZvciAoY29uc3Qga2V5IG9mIFtcImVycm9yc1wiLCBcImNhdXNlXCJdKSB7XG4gICAgICAgIGlmIChrZXkgaW4gbm9kZSkge1xuICAgICAgICAgIGNvbnN0IHZhbHVlID0gKG5vZGUgYXMgUmVjb3JkPHN0cmluZywgdW5rbm93bj4pW2tleV07XG4gICAgICAgICAgeWllbGQqIHZpc2l0KHZhbHVlKTtcbiAgICAgICAgfVxuICAgICAgfVxuICAgIH1cbiAgfVxuICB5aWVsZCogdmlzaXQoZXJyKTtcbn1cblxuLyoqXG4gKiBMYXp5IHZpZXcgb3ZlciBhIHRocm93biB2YWx1ZSBmb3IgSFRUUC1zdGF0dXMgKyBtZXNzYWdlIGNsYXNzaWZpY2F0aW9uLlxuICogU3RhdHVzIGNvbWVzIGZyb20gdGhlIGxhc3QgcG9zaXRpdmUgYHN0YXR1c0NvZGVgIC8gYGNvZGVgIG9uIHRoZSBlcnJvciB0cmVlO1xuICogbWVzc2FnZXMvdG9rZW5zIGNvbWUgZnJvbSBldmVyeSBgbWVzc2FnZWAgLyBgZXJyb3JDb2RlYCBmaWVsZCAoaW5jbHVkaW5nXG4gKiBgY2F1c2VgIGFuZCBgQWdncmVnYXRlRXJyb3IuZXJyb3JzYCkuIEJ1aWxkIHdpdGgge0BsaW5rIGVycm9yQ29udGV4dH0uXG4gKi9cbmV4cG9ydCB0eXBlIEVycm9yQ29udGV4dCA9IEVycm9yQ29udGV4dEltcGw7XG5cbmNsYXNzIEVycm9yQ29udGV4dEltcGwge1xuICBwcml2YXRlIF9zdGF0dXNDb2RlOiBudW1iZXIgfCB1bmRlZmluZWQ7XG4gIHByaXZhdGUgX21lc3NhZ2VzOiBzdHJpbmdbXSB8IHVuZGVmaW5lZDtcbiAgcHJpdmF0ZSBfbWVzc2FnZVRva2Vuczogc3RyaW5nW10gfCB1bmRlZmluZWQ7XG5cbiAgY29uc3RydWN0b3IocHJpdmF0ZSByZWFkb25seSBlcnI6IE5vbk51bGxhYmxlPHVua25vd24+KSB7fVxuXG4gIC8qKiBMYXN0IHBvc2l0aXZlIGBzdGF0dXNDb2RlYCAvIGBjb2RlYCBmb3VuZCBvbiB0aGUgZXJyb3IgdHJlZSwgZWxzZSBgdW5kZWZpbmVkYCAoMCBpZ25vcmVkKS4gKi9cbiAgZ2V0IHN0YXR1c0NvZGUoKTogbnVtYmVyIHwgdW5kZWZpbmVkIHtcbiAgICBpZiAodGhpcy5fc3RhdHVzQ29kZSA9PT0gdW5kZWZpbmVkKSB7XG4gICAgICBvdXRlcjogZm9yIChjb25zdCBub2RlIG9mIGVycm9yTm9kZXModGhpcy5lcnIpKSB7XG4gICAgICAgIGlmICh0eXBlb2Ygbm9kZSAhPT0gXCJvYmplY3RcIiB8fCBub2RlID09PSBudWxsKSBjb250aW51ZTtcbiAgICAgICAgZm9yIChjb25zdCBrZXkgb2YgW1wic3RhdHVzQ29kZVwiLCBcImNvZGVcIl0gYXMgY29uc3QpIHtcbiAgICAgICAgICBpZiAoIShrZXkgaW4gbm9kZSkpIGNvbnRpbnVlO1xuICAgICAgICAgIGNvbnN0IHZhbHVlID0gKG5vZGUgYXMgUmVjb3JkPHN0cmluZywgdW5rbm93bj4pW2tleV07XG4gICAgICAgICAgaWYgKHR5cGVvZiB2YWx1ZSA9PT0gXCJudW1iZXJcIiAmJiB2YWx1ZSA+IDk5ICYmIHZhbHVlIDwgNjAwKSB7XG4gICAgICAgICAgICB0aGlzLl9zdGF0dXNDb2RlID0gdmFsdWU7XG4gICAgICAgICAgICBicmVhayBvdXRlcjtcbiAgICAgICAgICB9XG4gICAgICAgIH1cbiAgICAgIH1cbiAgICAgIGlmICh0aGlzLl9zdGF0dXNDb2RlID09PSB1bmRlZmluZWQpIHtcbiAgICAgICAgdGhpcy5fc3RhdHVzQ29kZSA9IC0xO1xuICAgICAgfVxuICAgIH1cbiAgICByZXR1cm4gdGhpcy5fc3RhdHVzQ29kZSA9PSAtMSA/IHVuZGVmaW5lZCA6IHRoaXMuX3N0YXR1c0NvZGU7XG4gIH1cblxuICAvKiogRXZlcnkgYG1lc3NhZ2VgIC8gYGVycm9yQ29kZWAgc3RyaW5nIGluIHRoZSBlcnJvciB0cmVlLiAqL1xuICBnZXQgbWVzc2FnZXMoKTogc3RyaW5nW10ge1xuICAgIGlmICh0aGlzLl9tZXNzYWdlcyA9PT0gdW5kZWZpbmVkKSB7XG4gICAgICB0aGlzLl9tZXNzYWdlcyA9IFsuLi5lcnJvck1lc3NhZ2VzKHRoaXMuZXJyKV07XG4gICAgfVxuICAgIHJldHVybiB0aGlzLl9tZXNzYWdlcztcbiAgfVxuXG4gIC8qKiBMb3dlcmNhc2VkIHRva2VucyBmcm9tIHtAbGluayBtZXNzYWdlc30uICovXG4gIGdldCBtZXNzYWdlVG9rZW5zKCk6IHN0cmluZ1tdIHtcbiAgICBpZiAodGhpcy5fbWVzc2FnZVRva2VucyA9PT0gdW5kZWZpbmVkKSB7XG4gICAgICB0aGlzLl9tZXNzYWdlVG9rZW5zID0gWy4uLnRva2VuaXplV2l0aE9wdGlvbnMoeyBsb3dlckNhc2U6IHRydWUgfSwgLi4udGhpcy5tZXNzYWdlcyldO1xuICAgIH1cbiAgICByZXR1cm4gdGhpcy5fbWVzc2FnZVRva2VucztcbiAgfVxuXG4gIC8qKiBUcnVlIGZvciBhbnkgNHh4IHN0YXR1cyBvciBtZXNzYWdlIHRva2VucyBgbm90IGV4aXN0YCAvIGBub3QgZm91bmRgLiAqL1xuICBnZXQgbm90QWNjZXNzaWJsZSgpOiBib29sZWFuIHtcbiAgICBpZiAodGhpcy5oYXNTdGF0dXNDb2RlKDQpKSByZXR1cm4gdHJ1ZTtcbiAgICByZXR1cm4gdGhpcy5oYXNNZXNzYWdlKFwibm90XCIsIFwiZXhpc3RcIikgfHwgdGhpcy5oYXNNZXNzYWdlKFwibm90XCIsIFwiZm91bmRcIik7XG4gIH1cblxuICAvKipcbiAgICogTWF0Y2ggSFRUUCBzdGF0dXMuIFBhc3MgYSBmdWxsIGNvZGUgKGA0MDRgKSBvciBhIGNsYXNzIChgNGAgZm9yIGFueSA0eHgpLlxuICAgKiBFeHRyYSBmaWx0ZXJzIGFyZSBPUidkLiBgZmFsc2VgIHdoZW4gbm8gc3RhdHVzIGlzIG9uIHRoZSBlcnJvciB0cmVlLlxuICAgKi9cbiAgaGFzU3RhdHVzQ29kZShzdGF0dXNDb2RlRmlsdGVyOiBudW1iZXIsIC4uLnN0YXR1c0NvZGVGaWx0ZXJzOiBudW1iZXJbXSk6IGJvb2xlYW4ge1xuICAgIGNvbnN0IGNvZGUgPSB0aGlzLnN0YXR1c0NvZGU7XG4gICAgaWYgKGNvZGUpIHtcbiAgICAgIGZvciAoY29uc3QgZmlsdGVyIG9mIFtzdGF0dXNDb2RlRmlsdGVyLCAuLi5zdGF0dXNDb2RlRmlsdGVyc10pIHtcbiAgICAgICAgY29uc3QgbWF0Y2ggPSAoZmlsdGVyIDwgMTAwID8gTWF0aC50cnVuYyhjb2RlIC8gMTAwKSA6IGNvZGUpID09PSBmaWx0ZXI7XG4gICAgICAgIGlmIChtYXRjaCkgcmV0dXJuIHRydWU7XG4gICAgICB9XG4gICAgfVxuICAgIHJldHVybiBmYWxzZTtcbiAgfVxuXG4gIC8qKlxuICAgKiBUcnVlIHdoZW4gZXZlcnkgdG9rZW4gZnJvbSB0aGUgZmlsdGVyIHBocmFzZShzKSBhcHBlYXJzIGluXG4gICAqIHtAbGluayBtZXNzYWdlVG9rZW5zfS4gRWFjaCBhcmd1bWVudCBpcyB0b2tlbml6ZWQgb24gbm9uLWFscGhhbnVtZXJpY1xuICAgKiBib3VuZGFyaWVzIChlLmcuIGBoYXNNZXNzYWdlKFwibm90XCIsIFwiZm91bmRcIilgIG9yIGBoYXNNZXNzYWdlKFwibm90IGZvdW5kXCIpYCkuXG4gICAqL1xuICBoYXNNZXNzYWdlKG1lc3NhZ2VGaWx0ZXI6IHN0cmluZywgLi4ubWVzc2FnZUZpbHRlcnM6IHN0cmluZ1tdKTogYm9vbGVhbiB7XG4gICAgcmV0dXJuIFttZXNzYWdlRmlsdGVyLCAuLi5tZXNzYWdlRmlsdGVyc11cbiAgICAgIC5mbGF0TWFwKChmaWx0ZXIpID0+IEFycmF5LmZyb20odG9rZW5pemVXaXRoT3B0aW9ucyh7IGxvd2VyQ2FzZTogdHJ1ZSB9LCBmaWx0ZXIpKSlcbiAgICAgIC5ldmVyeSgoZmlsdGVyVG9rZW4pID0+IHRoaXMubWVzc2FnZVRva2Vucy5pbmNsdWRlcyhmaWx0ZXJUb2tlbikpO1xuICB9XG59XG5cbi8qKiBCdWlsZCBhbiB7QGxpbmsgRXJyb3JDb250ZXh0fSBmb3Igc3RhdHVzICsgbWVzc2FnZSBjaGVja3MuIGBudWxsYCAvIGB1bmRlZmluZWRgIGJlY29tZSBge31gLiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGVycm9yQ29udGV4dChlcnI6IHVua25vd24pOiBFcnJvckNvbnRleHQge1xuICByZXR1cm4gbmV3IEVycm9yQ29udGV4dEltcGwoZXJyID8/IHt9KTtcbn1cbiJdfQ==

package/lib/src/function.d.ts

@@ -0,0 +1,38 @@
+export interface MemoizeOptions {
+    /**
+     * Time-to-live in milliseconds. The cached value expires `ttlMs` after
+     * it was stored, so the next call past that recomputes; a rejection is
+     * also evicted so a later call retries rather than replaying the error.
+     * Omitted or `<= 0` means a successful value is cached forever (the default).
+     * Errors are never cached - see {@link memoize}.
+     *
+     * Use for periodically-refreshed data (published IP ranges, feature
+     * flags, anything fetched once and reused across requests).
+     */
+    ttlMs?: number;
+}
+/**
+ * Run a zero-argument factory once; later calls return the same result.
+ * The memoized function mirrors the factory's sync / async nature: a
+ * sync factory yields a sync getter (`() => T`), an async / thenable
+ * factory yields a promise-returning getter (`() => Promise<T>`) whose
+ * concurrent callers share the one in-flight promise until it settles.
+ *
+ * Errors are never cached: a sync factory that throws propagates the
+ * throw, and an async factory that rejects evicts the cached promise, so
+ * in both cases the next call retries. Pass `{ ttlMs }` to also expire
+ * and recompute a successful value after a window; without a TTL a
+ * success is cached forever.
+ *
+ * For an async factory the TTL window starts when the promise
+ * *resolves*, not when it was created - a slow in-flight request never
+ * counts as already-expired, and concurrent callers keep sharing the one
+ * pending promise until it settles.
+ *
+ * @example
+ * const ranges = functionModule.memoize(fetchIpRanges, { ttlMs: 24 * 60 * 60 * 1000 });
+ * await ranges(); // fetches
+ * await ranges(); // cached until 24h later
+ */
+export declare function memoize<T>(factory: () => PromiseLike<T>, options?: MemoizeOptions): () => Promise<T>;
+export declare function memoize<T>(factory: () => T, options?: MemoizeOptions): () => T;

package/lib/src/function.js

@@ -0,0 +1,44 @@
+export function memoize(factory, options) {
+    const ttlMs = options?.ttlMs ?? 0;
+    let cache;
+    return () => {
+        if (cache === undefined || (ttlMs > 0 && Date.now() >= cache.expiresAt)) {
+            const result = factory();
+            if (isThenable(result)) {
+                const pending = Promise.resolve(result);
+                // `Infinity` keeps the entry unexpired while in flight (so a slow
+                // request isn't refetched and concurrent callers share it); the
+                // TTL window is stamped from resolution below.
+                const entry = { value: pending, expiresAt: Infinity };
+                cache = entry;
+                void pending.then(() => {
+                    entry.expiresAt = Date.now() + ttlMs;
+                }, 
+                // Never cache a rejection: evict so a later call retries.
+                () => {
+                    if (cache === entry)
+                        cache = undefined;
+                });
+            }
+            else {
+                cache = { value: result, expiresAt: Date.now() + ttlMs };
+            }
+        }
+        return cache.value;
+    };
+}
+/** Duck-type any value with a callable `.then` as a thenable. */
+function isThenable(value) {
+    if (value !== null) {
+        if (value instanceof Promise) {
+            return true;
+        }
+        else if (typeof value === "object" &&
+            "then" in value &&
+            typeof value.then === "function") {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZnVuY3Rpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZnVuY3Rpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBMkNBLE1BQU0sVUFBVSxPQUFPLENBQ3JCLE9BQWlDLEVBQ2pDLE9BQXdCO0lBRXhCLE1BQU0sS0FBSyxHQUFHLE9BQU8sRUFBRSxLQUFLLElBQUksQ0FBQyxDQUFDO0lBQ2xDLElBQUksS0FBK0QsQ0FBQztJQUNwRSxPQUFPLEdBQUcsRUFBRTtRQUNWLElBQUksS0FBSyxLQUFLLFNBQVMsSUFBSSxDQUFDLEtBQUssR0FBRyxDQUFDLElBQUksSUFBSSxDQUFDLEdBQUcsRUFBRSxJQUFJLEtBQUssQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDO1lBQ3hFLE1BQU0sTUFBTSxHQUFHLE9BQU8sRUFBRSxDQUFDO1lBQ3pCLElBQUksVUFBVSxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7Z0JBQ3ZCLE1BQU0sT0FBTyxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUM7Z0JBQ3hDLGtFQUFrRTtnQkFDbEUsZ0VBQWdFO2dCQUNoRSwrQ0FBK0M7Z0JBQy9DLE1BQU0sS0FBSyxHQUFHLEVBQUUsS0FBSyxFQUFFLE9BQU8sRUFBRSxTQUFTLEVBQUUsUUFBUSxFQUFFLENBQUM7Z0JBQ3RELEtBQUssR0FBRyxLQUFLLENBQUM7Z0JBQ2QsS0FBSyxPQUFPLENBQUMsSUFBSSxDQUNmLEdBQUcsRUFBRTtvQkFDSCxLQUFLLENBQUMsU0FBUyxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsR0FBRyxLQUFLLENBQUM7Z0JBQ3ZDLENBQUM7Z0JBQ0QsMERBQTBEO2dCQUMxRCxHQUFHLEVBQUU7b0JBQ0gsSUFBSSxLQUFLLEtBQUssS0FBSzt3QkFBRSxLQUFLLEdBQUcsU0FBUyxDQUFDO2dCQUN6QyxDQUFDLENBQ0YsQ0FBQztZQUNKLENBQUM7aUJBQU0sQ0FBQztnQkFDTixLQUFLLEdBQUcsRUFBRSxLQUFLLEVBQUUsTUFBTSxFQUFFLFNBQVMsRUFBRSxJQUFJLENBQUMsR0FBRyxFQUFFLEdBQUcsS0FBSyxFQUFFLENBQUM7WUFDM0QsQ0FBQztRQUNILENBQUM7UUFDRCxPQUFPLEtBQUssQ0FBQyxLQUFLLENBQUM7SUFDckIsQ0FBQyxDQUFDO0FBQ0osQ0FBQztBQUVELGlFQUFpRTtBQUNqRSxTQUFTLFVBQVUsQ0FBSSxLQUF5QjtJQUM5QyxJQUFJLEtBQUssS0FBSyxJQUFJLEVBQUUsQ0FBQztRQUNuQixJQUFJLEtBQUssWUFBWSxPQUFPLEVBQUUsQ0FBQztZQUM3QixPQUFPLElBQUksQ0FBQztRQUNkLENBQUM7YUFBTSxJQUNMLE9BQU8sS0FBSyxLQUFLLFFBQVE7WUFDekIsTUFBTSxJQUFJLEtBQUs7WUFDZixPQUFRLEtBQXdCLENBQUMsSUFBSSxLQUFLLFVBQVUsRUFDcEQsQ0FBQztZQUNELE9BQU8sSUFBSSxDQUFDO1FBQ2QsQ0FBQztJQUNILENBQUM7SUFDRCxPQUFPLEtBQUssQ0FBQztBQUNmLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgaW50ZXJmYWNlIE1lbW9pemVPcHRpb25zIHtcbiAgLyoqXG4gICAqIFRpbWUtdG8tbGl2ZSBpbiBtaWxsaXNlY29uZHMuIFRoZSBjYWNoZWQgdmFsdWUgZXhwaXJlcyBgdHRsTXNgIGFmdGVyXG4gICAqIGl0IHdhcyBzdG9yZWQsIHNvIHRoZSBuZXh0IGNhbGwgcGFzdCB0aGF0IHJlY29tcHV0ZXM7IGEgcmVqZWN0aW9uIGlzXG4gICAqIGFsc28gZXZpY3RlZCBzbyBhIGxhdGVyIGNhbGwgcmV0cmllcyByYXRoZXIgdGhhbiByZXBsYXlpbmcgdGhlIGVycm9yLlxuICAgKiBPbWl0dGVkIG9yIGA8PSAwYCBtZWFucyBhIHN1Y2Nlc3NmdWwgdmFsdWUgaXMgY2FjaGVkIGZvcmV2ZXIgKHRoZSBkZWZhdWx0KS5cbiAgICogRXJyb3JzIGFyZSBuZXZlciBjYWNoZWQgLSBzZWUge0BsaW5rIG1lbW9pemV9LlxuICAgKlxuICAgKiBVc2UgZm9yIHBlcmlvZGljYWxseS1yZWZyZXNoZWQgZGF0YSAocHVibGlzaGVkIElQIHJhbmdlcywgZmVhdHVyZVxuICAgKiBmbGFncywgYW55dGhpbmcgZmV0Y2hlZCBvbmNlIGFuZCByZXVzZWQgYWNyb3NzIHJlcXVlc3RzKS5cbiAgICovXG4gIHR0bE1zPzogbnVtYmVyO1xufVxuXG4vKipcbiAqIFJ1biBhIHplcm8tYXJndW1lbnQgZmFjdG9yeSBvbmNlOyBsYXRlciBjYWxscyByZXR1cm4gdGhlIHNhbWUgcmVzdWx0LlxuICogVGhlIG1lbW9pemVkIGZ1bmN0aW9uIG1pcnJvcnMgdGhlIGZhY3RvcnkncyBzeW5jIC8gYXN5bmMgbmF0dXJlOiBhXG4gKiBzeW5jIGZhY3RvcnkgeWllbGRzIGEgc3luYyBnZXR0ZXIgKGAoKSA9PiBUYCksIGFuIGFzeW5jIC8gdGhlbmFibGVcbiAqIGZhY3RvcnkgeWllbGRzIGEgcHJvbWlzZS1yZXR1cm5pbmcgZ2V0dGVyIChgKCkgPT4gUHJvbWlzZTxUPmApIHdob3NlXG4gKiBjb25jdXJyZW50IGNhbGxlcnMgc2hhcmUgdGhlIG9uZSBpbi1mbGlnaHQgcHJvbWlzZSB1bnRpbCBpdCBzZXR0bGVzLlxuICpcbiAqIEVycm9ycyBhcmUgbmV2ZXIgY2FjaGVkOiBhIHN5bmMgZmFjdG9yeSB0aGF0IHRocm93cyBwcm9wYWdhdGVzIHRoZVxuICogdGhyb3csIGFuZCBhbiBhc3luYyBmYWN0b3J5IHRoYXQgcmVqZWN0cyBldmljdHMgdGhlIGNhY2hlZCBwcm9taXNlLCBzb1xuICogaW4gYm90aCBjYXNlcyB0aGUgbmV4dCBjYWxsIHJldHJpZXMuIFBhc3MgYHsgdHRsTXMgfWAgdG8gYWxzbyBleHBpcmVcbiAqIGFuZCByZWNvbXB1dGUgYSBzdWNjZXNzZnVsIHZhbHVlIGFmdGVyIGEgd2luZG93OyB3aXRob3V0IGEgVFRMIGFcbiAqIHN1Y2Nlc3MgaXMgY2FjaGVkIGZvcmV2ZXIuXG4gKlxuICogRm9yIGFuIGFzeW5jIGZhY3RvcnkgdGhlIFRUTCB3aW5kb3cgc3RhcnRzIHdoZW4gdGhlIHByb21pc2VcbiAqICpyZXNvbHZlcyosIG5vdCB3aGVuIGl0IHdhcyBjcmVhdGVkIC0gYSBzbG93IGluLWZsaWdodCByZXF1ZXN0IG5ldmVyXG4gKiBjb3VudHMgYXMgYWxyZWFkeS1leHBpcmVkLCBhbmQgY29uY3VycmVudCBjYWxsZXJzIGtlZXAgc2hhcmluZyB0aGUgb25lXG4gKiBwZW5kaW5nIHByb21pc2UgdW50aWwgaXQgc2V0dGxlcy5cbiAqXG4gKiBAZXhhbXBsZVxuICogY29uc3QgcmFuZ2VzID0gZnVuY3Rpb25Nb2R1bGUubWVtb2l6ZShmZXRjaElwUmFuZ2VzLCB7IHR0bE1zOiAyNCAqIDYwICogNjAgKiAxMDAwIH0pO1xuICogYXdhaXQgcmFuZ2VzKCk7IC8vIGZldGNoZXNcbiAqIGF3YWl0IHJhbmdlcygpOyAvLyBjYWNoZWQgdW50aWwgMjRoIGxhdGVyXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBtZW1vaXplPFQ+KFxuICBmYWN0b3J5OiAoKSA9PiBQcm9taXNlTGlrZTxUPixcbiAgb3B0aW9ucz86IE1lbW9pemVPcHRpb25zLFxuKTogKCkgPT4gUHJvbWlzZTxUPjtcbmV4cG9ydCBmdW5jdGlvbiBtZW1vaXplPFQ+KGZhY3Rvcnk6ICgpID0+IFQsIG9wdGlvbnM/OiBNZW1vaXplT3B0aW9ucyk6ICgpID0+IFQ7XG5cbmV4cG9ydCBmdW5jdGlvbiBtZW1vaXplPFQ+KFxuICBmYWN0b3J5OiAoKSA9PiBUIHwgUHJvbWlzZUxpa2U8VD4sXG4gIG9wdGlvbnM/OiBNZW1vaXplT3B0aW9ucyxcbik6ICgpID0+IFQgfCBQcm9taXNlPFQ+IHtcbiAgY29uc3QgdHRsTXMgPSBvcHRpb25zPy50dGxNcyA/PyAwO1xuICBsZXQgY2FjaGU6IHsgdmFsdWU6IFQgfCBQcm9taXNlPFQ+OyBleHBpcmVzQXQ6IG51bWJlciB9IHwgdW5kZWZpbmVkO1xuICByZXR1cm4gKCkgPT4ge1xuICAgIGlmIChjYWNoZSA9PT0gdW5kZWZpbmVkIHx8ICh0dGxNcyA+IDAgJiYgRGF0ZS5ub3coKSA+PSBjYWNoZS5leHBpcmVzQXQpKSB7XG4gICAgICBjb25zdCByZXN1bHQgPSBmYWN0b3J5KCk7XG4gICAgICBpZiAoaXNUaGVuYWJsZShyZXN1bHQpKSB7XG4gICAgICAgIGNvbnN0IHBlbmRpbmcgPSBQcm9taXNlLnJlc29sdmUocmVzdWx0KTtcbiAgICAgICAgLy8gYEluZmluaXR5YCBrZWVwcyB0aGUgZW50cnkgdW5leHBpcmVkIHdoaWxlIGluIGZsaWdodCAoc28gYSBzbG93XG4gICAgICAgIC8vIHJlcXVlc3QgaXNuJ3QgcmVmZXRjaGVkIGFuZCBjb25jdXJyZW50IGNhbGxlcnMgc2hhcmUgaXQpOyB0aGVcbiAgICAgICAgLy8gVFRMIHdpbmRvdyBpcyBzdGFtcGVkIGZyb20gcmVzb2x1dGlvbiBiZWxvdy5cbiAgICAgICAgY29uc3QgZW50cnkgPSB7IHZhbHVlOiBwZW5kaW5nLCBleHBpcmVzQXQ6IEluZmluaXR5IH07XG4gICAgICAgIGNhY2hlID0gZW50cnk7XG4gICAgICAgIHZvaWQgcGVuZGluZy50aGVuKFxuICAgICAgICAgICgpID0+IHtcbiAgICAgICAgICAgIGVudHJ5LmV4cGlyZXNBdCA9IERhdGUubm93KCkgKyB0dGxNcztcbiAgICAgICAgICB9LFxuICAgICAgICAgIC8vIE5ldmVyIGNhY2hlIGEgcmVqZWN0aW9uOiBldmljdCBzbyBhIGxhdGVyIGNhbGwgcmV0cmllcy5cbiAgICAgICAgICAoKSA9PiB7XG4gICAgICAgICAgICBpZiAoY2FjaGUgPT09IGVudHJ5KSBjYWNoZSA9IHVuZGVmaW5lZDtcbiAgICAgICAgICB9LFxuICAgICAgICApO1xuICAgICAgfSBlbHNlIHtcbiAgICAgICAgY2FjaGUgPSB7IHZhbHVlOiByZXN1bHQsIGV4cGlyZXNBdDogRGF0ZS5ub3coKSArIHR0bE1zIH07XG4gICAgICB9XG4gICAgfVxuICAgIHJldHVybiBjYWNoZS52YWx1ZTtcbiAgfTtcbn1cblxuLyoqIER1Y2stdHlwZSBhbnkgdmFsdWUgd2l0aCBhIGNhbGxhYmxlIGAudGhlbmAgYXMgYSB0aGVuYWJsZS4gKi9cbmZ1bmN0aW9uIGlzVGhlbmFibGU8VD4odmFsdWU6IFQgfCBQcm9taXNlTGlrZTxUPik6IHZhbHVlIGlzIFByb21pc2VMaWtlPFQ+IHtcbiAgaWYgKHZhbHVlICE9PSBudWxsKSB7XG4gICAgaWYgKHZhbHVlIGluc3RhbmNlb2YgUHJvbWlzZSkge1xuICAgICAgcmV0dXJuIHRydWU7XG4gICAgfSBlbHNlIGlmIChcbiAgICAgIHR5cGVvZiB2YWx1ZSA9PT0gXCJvYmplY3RcIiAmJlxuICAgICAgXCJ0aGVuXCIgaW4gdmFsdWUgJiZcbiAgICAgIHR5cGVvZiAodmFsdWUgYXMgUHJvbWlzZUxpa2U8VD4pLnRoZW4gPT09IFwiZnVuY3Rpb25cIlxuICAgICkge1xuICAgICAgcmV0dXJuIHRydWU7XG4gICAgfVxuICB9XG4gIHJldHVybiBmYWxzZTtcbn1cbiJdfQ==

package/lib/src/hash.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Short, deterministic non-cryptographic hashing and id minting.
+ *
+ * {@link fnvHash} / {@link fnvHashWithOptions} produce a stable FNV-1a
+ * digest over arbitrary structured input; {@link toBase32} encodes a
+ * 32-bit integer compactly; {@link id} mints v4 UUIDs (or short hex
+ * slices). All browser-safe - built on `globalThis.crypto`, no
+ * `node:crypto` import. **Never** use these for tokens, signatures, or
+ * anything an attacker shouldn't be able to forge.
+ *
+ * @module
+ */
+/**
+ * Mint a v4 UUID, or a short hex slice of one when `length` is set.
+ *
+ * - `id()` returns a full RFC 4122 v4 UUID. Pick this when global
+ *   uniqueness matters: long-running batches, ids that cross a storage /
+ *   process boundary, anything that may collide across machines.
+ * - `id(length)` returns the first `length` hex chars of a fresh UUID
+ *   with dashes stripped (e.g. `id(8) -> "a3f1c92b"`). Pick this when the
+ *   id has to be short / typeable and the scope is bounded - cache keys
+ *   local to a request, slug suffixes. `length <= 0` throws.
+ *
+ * Prefers `crypto.randomUUID()`, which covers Node (>= 19) and a browser on
+ * a secure origin. Browsers gate `randomUUID` behind a secure context, so a
+ * page served over plain http (a LAN dev host) has `crypto` but not that
+ * method; this package is browser-safe and its callers mint ids on the
+ * render path, so it degrades instead of throwing: `getRandomValues` when
+ * present, else `Math.random`. Every branch returns a well-formed v4 UUID -
+ * only the entropy source differs.
+ *
+ * @example
+ * id();   // "123e4567-e89b-12d3-a456-426614174000"
+ * id(8);  // "a3f1c92b"
+ */
+export declare function id(length?: number): string;
+/**
+ * Short, deterministic FNV-1a hash over one or more values. Wraps
+ * {@link fnvHashWithOptions} with all defaults: 6-char Crockford-style
+ * base-32 output (digits + lowercase, minus `i`/`l`/`o`/`u`).
+ * Browser-safe (no `node:crypto`).
+ *
+ * Accepts any mix of primitives, arrays, plain objects, `Map`s, and
+ * `Set`s; nested structures are walked deterministically so the hash is
+ * order-stable for objects / maps / sets and order-sensitive for arrays.
+ * Cycles are detected and folded into a `circular:` marker.
+ *
+ * Use for cache keys, slug suffixes, log correlation ids, and other
+ * "give me something short and stable" needs - **never** for tokens or
+ * signatures. FNV-1a is a non-cryptographic hash.
+ *
+ * @example
+ * fnvHash("databricks-claude-sonnet-4-6"); // "k3p9q7"
+ * fnvHash([1, 2, 3]) !== fnvHash([3, 2, 1]);
+ */
+export declare function fnvHash(...values: unknown[]): string;
+/**
+ * Configurable counterpart to {@link fnvHash}.
+ *
+ * Options:
+ *   - `length` (default `6`): number of base-32 chars to return. Capped
+ *     at 7 - the underlying digest is 32 bits, which base-32-encodes to
+ *     at most 7 chars. Output is left-padded with the alphabet's zero
+ *     character so short digests still hit the requested width.
+ *   - `alphabet` (default Crockford-style
+ *     `"0123456789abcdefghjkmnpqrstvwxyz"`): 32 distinct characters used
+ *     to encode the digest. Throws when not exactly 32 unique chars.
+ *   - `digest` (default `0x811c9dc5`, the FNV-1a offset basis): the seed
+ *     the running digest starts from. Useful for namespacing so
+ *     otherwise-identical inputs hashed under different namespaces never
+ *     collide, and for chaining hashes across pipeline stages.
+ *
+ * The hash is **not** stable across changes to the alphabet or `length` -
+ * those tune the output, not the digest input.
+ *
+ * @example
+ * fnvHashWithOptions({ length: 4 }, "user@example.com");        // 4 chars
+ * fnvHashWithOptions({ digest: nsHash }, key) !== fnvHash(key); // namespaced
+ */
+export declare function fnvHashWithOptions(options?: {
+    length?: number;
+    alphabet?: string;
+    digest?: number;
+}, ...values: unknown[]): string;
+/**
+ * Encode a 32-bit unsigned integer as base-32 using the default
+ * Crockford-style alphabet (or `alphabet` when provided). The encoding
+ * has **no** zero-padding by default - `toBase32(0)` returns the
+ * alphabet's zero character, otherwise the result is the minimal number
+ * of digits that fits the value. Pad / truncate at the call site when you
+ * need a fixed width.
+ *
+ * `disableAlphabetValidation` skips the unique-32-char check for hot
+ * paths that have already validated the alphabet. The function still
+ * requires `alphabet.length === 32` either way.
+ *
+ * @example
+ * toBase32(0);        // "0"
+ * toBase32(31);       // "z"
+ * toBase32(0xdeadbe); // "6vmtw"
+ */
+export declare function toBase32(value: number, alphabet?: string, disableAlphabetValidation?: boolean): string;