@stackframe/stack-shared 2.8.40 → 2.8.43

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @stackframe/stack-shared
 
+## 2.8.43
+
+## 2.8.42
+
+### Patch Changes
+
+- Various changes
+
+## 2.8.41
+
+### Patch Changes
+
+- Various changes
+
 ## 2.8.40
 
 ### Patch Changes

package/dist/apps/apps-config.d.mts

@@ -0,0 +1,109 @@
+declare const ALL_APPS: {
+    readonly authentication: {
+        readonly type: "app";
+        readonly displayName: "Authentication";
+        readonly subtitle: "User sign-in and account management";
+        readonly tags: ["auth", "security"];
+        readonly stage: "stable";
+    };
+    readonly teams: {
+        readonly type: "app";
+        readonly displayName: "Teams";
+        readonly subtitle: "Team collaboration and management";
+        readonly tags: ["collaboration", "organization"];
+        readonly stage: "stable";
+    };
+    readonly rbac: {
+        readonly type: "app";
+        readonly displayName: "RBAC";
+        readonly subtitle: "Role-based access control and permissions";
+        readonly tags: ["security", "permissions"];
+        readonly stage: "stable";
+    };
+    readonly "api-keys": {
+        readonly type: "app";
+        readonly displayName: "API Keys";
+        readonly subtitle: "API key generation and management";
+        readonly tags: ["api", "security"];
+        readonly stage: "stable";
+    };
+    readonly payments: {
+        readonly type: "app";
+        readonly displayName: "Payments";
+        readonly subtitle: "Payment processing and subscription management";
+        readonly tags: ["billing", "monetization"];
+        readonly stage: "stable";
+    };
+    readonly emails: {
+        readonly type: "app";
+        readonly displayName: "Emails";
+        readonly subtitle: "Email template configuration and management";
+        readonly tags: ["communication", "templates"];
+        readonly stage: "stable";
+    };
+    readonly "email-api": {
+        readonly type: "app";
+        readonly displayName: "Email API";
+        readonly subtitle: "Programmatic email sending and delivery";
+        readonly tags: ["api", "communication"];
+        readonly stage: "alpha";
+    };
+    readonly "data-vault": {
+        readonly type: "app";
+        readonly displayName: "Data Vault";
+        readonly subtitle: "Secure storage for sensitive user data";
+        readonly tags: ["security", "storage"];
+        readonly stage: "stable";
+    };
+    readonly workflows: {
+        readonly type: "app";
+        readonly displayName: "Workflows";
+        readonly subtitle: "Automated business process orchestration";
+        readonly tags: ["automation", "processes"];
+        readonly stage: "beta";
+    };
+    readonly webhooks: {
+        readonly type: "app";
+        readonly displayName: "Webhooks";
+        readonly subtitle: "Real-time event notifications and integrations";
+        readonly tags: ["integration", "events"];
+        readonly stage: "stable";
+    };
+    readonly "tv-mode": {
+        readonly type: "app";
+        readonly displayName: "TV mode";
+        readonly subtitle: "Dashboard display for large screens";
+        readonly tags: ["display", "monitoring"];
+        readonly stage: "alpha";
+    };
+    readonly "launch-checklist": {
+        readonly type: "app";
+        readonly displayName: "Launch Checklist";
+        readonly subtitle: "Pre-launch verification and readiness checks";
+        readonly tags: ["deployment", "verification"];
+        readonly stage: "alpha";
+    };
+    readonly catalyst: {
+        readonly type: "app";
+        readonly displayName: "Catalyst";
+        readonly subtitle: "Project scaffolding and rapid development";
+        readonly tags: ["development", "tooling"];
+        readonly stage: "alpha";
+    };
+    readonly neon: {
+        readonly type: "integration";
+        readonly displayName: "Neon";
+        readonly subtitle: "Serverless Postgres database integration";
+        readonly tags: ["database", "integration"];
+        readonly stage: "alpha";
+    };
+    readonly convex: {
+        readonly type: "integration";
+        readonly displayName: "Convex";
+        readonly subtitle: "Real-time backend platform integration";
+        readonly tags: ["database", "integration", "realtime"];
+        readonly stage: "alpha";
+    };
+};
+
+export { ALL_APPS };

package/dist/apps/apps-config.d.ts

@@ -0,0 +1,109 @@
+declare const ALL_APPS: {
+    readonly authentication: {
+        readonly type: "app";
+        readonly displayName: "Authentication";
+        readonly subtitle: "User sign-in and account management";
+        readonly tags: ["auth", "security"];
+        readonly stage: "stable";
+    };
+    readonly teams: {
+        readonly type: "app";
+        readonly displayName: "Teams";
+        readonly subtitle: "Team collaboration and management";
+        readonly tags: ["collaboration", "organization"];
+        readonly stage: "stable";
+    };
+    readonly rbac: {
+        readonly type: "app";
+        readonly displayName: "RBAC";
+        readonly subtitle: "Role-based access control and permissions";
+        readonly tags: ["security", "permissions"];
+        readonly stage: "stable";
+    };
+    readonly "api-keys": {
+        readonly type: "app";
+        readonly displayName: "API Keys";
+        readonly subtitle: "API key generation and management";
+        readonly tags: ["api", "security"];
+        readonly stage: "stable";
+    };
+    readonly payments: {
+        readonly type: "app";
+        readonly displayName: "Payments";
+        readonly subtitle: "Payment processing and subscription management";
+        readonly tags: ["billing", "monetization"];
+        readonly stage: "stable";
+    };
+    readonly emails: {
+        readonly type: "app";
+        readonly displayName: "Emails";
+        readonly subtitle: "Email template configuration and management";
+        readonly tags: ["communication", "templates"];
+        readonly stage: "stable";
+    };
+    readonly "email-api": {
+        readonly type: "app";
+        readonly displayName: "Email API";
+        readonly subtitle: "Programmatic email sending and delivery";
+        readonly tags: ["api", "communication"];
+        readonly stage: "alpha";
+    };
+    readonly "data-vault": {
+        readonly type: "app";
+        readonly displayName: "Data Vault";
+        readonly subtitle: "Secure storage for sensitive user data";
+        readonly tags: ["security", "storage"];
+        readonly stage: "stable";
+    };
+    readonly workflows: {
+        readonly type: "app";
+        readonly displayName: "Workflows";
+        readonly subtitle: "Automated business process orchestration";
+        readonly tags: ["automation", "processes"];
+        readonly stage: "beta";
+    };
+    readonly webhooks: {
+        readonly type: "app";
+        readonly displayName: "Webhooks";
+        readonly subtitle: "Real-time event notifications and integrations";
+        readonly tags: ["integration", "events"];
+        readonly stage: "stable";
+    };
+    readonly "tv-mode": {
+        readonly type: "app";
+        readonly displayName: "TV mode";
+        readonly subtitle: "Dashboard display for large screens";
+        readonly tags: ["display", "monitoring"];
+        readonly stage: "alpha";
+    };
+    readonly "launch-checklist": {
+        readonly type: "app";
+        readonly displayName: "Launch Checklist";
+        readonly subtitle: "Pre-launch verification and readiness checks";
+        readonly tags: ["deployment", "verification"];
+        readonly stage: "alpha";
+    };
+    readonly catalyst: {
+        readonly type: "app";
+        readonly displayName: "Catalyst";
+        readonly subtitle: "Project scaffolding and rapid development";
+        readonly tags: ["development", "tooling"];
+        readonly stage: "alpha";
+    };
+    readonly neon: {
+        readonly type: "integration";
+        readonly displayName: "Neon";
+        readonly subtitle: "Serverless Postgres database integration";
+        readonly tags: ["database", "integration"];
+        readonly stage: "alpha";
+    };
+    readonly convex: {
+        readonly type: "integration";
+        readonly displayName: "Convex";
+        readonly subtitle: "Real-time backend platform integration";
+        readonly tags: ["database", "integration", "realtime"];
+        readonly stage: "alpha";
+    };
+};
+
+export { ALL_APPS };

package/dist/apps/apps-config.js

@@ -0,0 +1,137 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/apps/apps-config.ts
+var apps_config_exports = {};
+__export(apps_config_exports, {
+  ALL_APPS: () => ALL_APPS
+});
+module.exports = __toCommonJS(apps_config_exports);
+var ALL_APPS = {
+  "authentication": {
+    type: "app",
+    displayName: "Authentication",
+    subtitle: "User sign-in and account management",
+    tags: ["auth", "security"],
+    stage: "stable"
+  },
+  "teams": {
+    type: "app",
+    displayName: "Teams",
+    subtitle: "Team collaboration and management",
+    tags: ["collaboration", "organization"],
+    stage: "stable"
+  },
+  "rbac": {
+    type: "app",
+    displayName: "RBAC",
+    subtitle: "Role-based access control and permissions",
+    tags: ["security", "permissions"],
+    stage: "stable"
+  },
+  "api-keys": {
+    type: "app",
+    displayName: "API Keys",
+    subtitle: "API key generation and management",
+    tags: ["api", "security"],
+    stage: "stable"
+  },
+  "payments": {
+    type: "app",
+    displayName: "Payments",
+    subtitle: "Payment processing and subscription management",
+    tags: ["billing", "monetization"],
+    stage: "stable"
+  },
+  "emails": {
+    type: "app",
+    displayName: "Emails",
+    subtitle: "Email template configuration and management",
+    tags: ["communication", "templates"],
+    stage: "stable"
+  },
+  "email-api": {
+    type: "app",
+    displayName: "Email API",
+    subtitle: "Programmatic email sending and delivery",
+    tags: ["api", "communication"],
+    stage: "alpha"
+  },
+  "data-vault": {
+    type: "app",
+    displayName: "Data Vault",
+    subtitle: "Secure storage for sensitive user data",
+    tags: ["security", "storage"],
+    stage: "stable"
+  },
+  "workflows": {
+    type: "app",
+    displayName: "Workflows",
+    subtitle: "Automated business process orchestration",
+    tags: ["automation", "processes"],
+    stage: "beta"
+  },
+  "webhooks": {
+    type: "app",
+    displayName: "Webhooks",
+    subtitle: "Real-time event notifications and integrations",
+    tags: ["integration", "events"],
+    stage: "stable"
+  },
+  "tv-mode": {
+    type: "app",
+    displayName: "TV mode",
+    subtitle: "Dashboard display for large screens",
+    tags: ["display", "monitoring"],
+    stage: "alpha"
+  },
+  "launch-checklist": {
+    type: "app",
+    displayName: "Launch Checklist",
+    subtitle: "Pre-launch verification and readiness checks",
+    tags: ["deployment", "verification"],
+    stage: "alpha"
+  },
+  "catalyst": {
+    type: "app",
+    displayName: "Catalyst",
+    subtitle: "Project scaffolding and rapid development",
+    tags: ["development", "tooling"],
+    stage: "alpha"
+  },
+  "neon": {
+    type: "integration",
+    displayName: "Neon",
+    subtitle: "Serverless Postgres database integration",
+    tags: ["database", "integration"],
+    stage: "alpha"
+  },
+  "convex": {
+    type: "integration",
+    displayName: "Convex",
+    subtitle: "Real-time backend platform integration",
+    tags: ["database", "integration", "realtime"],
+    stage: "alpha"
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ALL_APPS
+});
+//# sourceMappingURL=apps-config.js.map

package/dist/apps/apps-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/apps/apps-config.ts"],"sourcesContent":["type App = {\n  type: \"app\" | \"integration\",\n  displayName: string,\n  subtitle: string,\n  tags: string[],\n  stage: \"alpha\" | \"beta\" | \"stable\",\n};\n\nexport const ALL_APPS = {\n  \"authentication\": {\n    type: \"app\",\n    displayName: \"Authentication\",\n    subtitle: \"User sign-in and account management\",\n    tags: [\"auth\", \"security\"],\n    stage: \"stable\",\n  },\n  \"teams\": {\n    type: \"app\",\n    displayName: \"Teams\",\n    subtitle: \"Team collaboration and management\",\n    tags: [\"collaboration\", \"organization\"],\n    stage: \"stable\",\n  },\n  \"rbac\": {\n    type: \"app\",\n    displayName: \"RBAC\",\n    subtitle: \"Role-based access control and permissions\",\n    tags: [\"security\", \"permissions\"],\n    stage: \"stable\",\n  },\n  \"api-keys\": {\n    type: \"app\",\n    displayName: \"API Keys\",\n    subtitle: \"API key generation and management\",\n    tags: [\"api\", \"security\"],\n    stage: \"stable\",\n  },\n  \"payments\": {\n    type: \"app\",\n    displayName: \"Payments\",\n    subtitle: \"Payment processing and subscription management\",\n    tags: [\"billing\", \"monetization\"],\n    stage: \"stable\",\n  },\n  \"emails\": {\n    type: \"app\",\n    displayName: \"Emails\",\n    subtitle: \"Email template configuration and management\",\n    tags: [\"communication\", \"templates\"],\n    stage: \"stable\",\n  },\n  \"email-api\": {\n    type: \"app\",\n    displayName: \"Email API\",\n    subtitle: \"Programmatic email sending and delivery\",\n    tags: [\"api\", \"communication\"],\n    stage: \"alpha\",\n  },\n  \"data-vault\": {\n    type: \"app\",\n    displayName: \"Data Vault\",\n    subtitle: \"Secure storage for sensitive user data\",\n    tags: [\"security\", \"storage\"],\n    stage: \"stable\",\n  },\n  \"workflows\": {\n    type: \"app\",\n    displayName: \"Workflows\",\n    subtitle: \"Automated business process orchestration\",\n    tags: [\"automation\", \"processes\"],\n    stage: \"beta\",\n  },\n  \"webhooks\": {\n    type: \"app\",\n    displayName: \"Webhooks\",\n    subtitle: \"Real-time event notifications and integrations\",\n    tags: [\"integration\", \"events\"],\n    stage: \"stable\",\n  },\n  \"tv-mode\": {\n    type: \"app\",\n    displayName: \"TV mode\",\n    subtitle: \"Dashboard display for large screens\",\n    tags: [\"display\", \"monitoring\"],\n    stage: \"alpha\",\n  },\n  \"launch-checklist\": {\n    type: \"app\",\n    displayName: \"Launch Checklist\",\n    subtitle: \"Pre-launch verification and readiness checks\",\n    tags: [\"deployment\", \"verification\"],\n    stage: \"alpha\",\n  },\n  \"catalyst\": {\n    type: \"app\",\n    displayName: \"Catalyst\",\n    subtitle: \"Project scaffolding and rapid development\",\n    tags: [\"development\", \"tooling\"],\n    stage: \"alpha\",\n  },\n  \"neon\": {\n    type: \"integration\",\n    displayName: \"Neon\",\n    subtitle: \"Serverless Postgres database integration\",\n    tags: [\"database\", \"integration\"],\n    stage: \"alpha\",\n  },\n  \"convex\": {\n    type: \"integration\",\n    displayName: \"Convex\",\n    subtitle: \"Real-time backend platform integration\",\n    tags: [\"database\", \"integration\", \"realtime\"],\n    stage: \"alpha\",\n  },\n} as const satisfies Record<string, App>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQO,IAAM,WAAW;AAAA,EACtB,kBAAkB;AAAA,IAChB,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM,CAAC,QAAQ,UAAU;AAAA,IACzB,OAAO;AAAA,EACT;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM,CAAC,iBAAiB,cAAc;AAAA,IACtC,OAAO;AAAA,EACT;AAAA,EACA,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM,CAAC,YAAY,aAAa;AAAA,IAChC,OAAO;AAAA,EACT;AAAA,EACA,YAAY;AAAA,IACV,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM,CAAC,OAAO,UAAU;AAAA,IACxB,OAAO;AAAA,EACT;AAAA,EACA,YAAY;AAAA,IACV,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM,CAAC,WAAW,cAAc;AAAA,IAChC,OAAO;AAAA,EACT;AAAA,EACA,UAAU;AAAA,IACR,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM,CAAC,iBAAiB,WAAW;AAAA,IACnC,OAAO;AAAA,EACT;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM,CAAC,OAAO,eAAe;AAAA,IAC7B,OAAO;AAAA,EACT;AAAA,EACA,cAAc;AAAA,IACZ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM,CAAC,YAAY,SAAS;AAAA,IAC5B,OAAO;AAAA,EACT;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM,CAAC,cAAc,WAAW;AAAA,IAChC,OAAO;AAAA,EACT;AAAA,EACA,YAAY;AAAA,IACV,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM,CAAC,eAAe,QAAQ;AAAA,IAC9B,OAAO;AAAA,EACT;AAAA,EACA,WAAW;AAAA,IACT,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM,CAAC,WAAW,YAAY;AAAA,IAC9B,OAAO;AAAA,EACT;AAAA,EACA,oBAAoB;AAAA,IAClB,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM,CAAC,cAAc,cAAc;AAAA,IACnC,OAAO;AAAA,EACT;AAAA,EACA,YAAY;AAAA,IACV,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM,CAAC,eAAe,SAAS;AAAA,IAC/B,OAAO;AAAA,EACT;AAAA,EACA,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM,CAAC,YAAY,aAAa;AAAA,IAChC,OAAO;AAAA,EACT;AAAA,EACA,UAAU;AAAA,IACR,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM,CAAC,YAAY,eAAe,UAAU;AAAA,IAC5C,OAAO;AAAA,EACT;AACF;","names":[]}

package/dist/config/format.js

@@ -61,7 +61,9 @@ function getInvalidConfigValueReason(value, options = {}) {
         break;
       } else if (Array.isArray(value)) {
         for (const [index, v] of value.entries()) {
-          const reason = getInvalidConfigValueReason(v, { valueName: `${valueName}[${index}]` });
+          const elementValueName = `${valueName}[${index}]`;
+          if (v === null) return `${elementValueName} is null; tuple elements cannot be null`;
+          const reason = getInvalidConfigValueReason(v, { valueName: elementValueName });
           if (reason) return reason;
         }
       } else {

package/dist/config/format.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/config/format.ts"],"sourcesContent":["// see https://github.com/stack-auth/info/blob/main/eng-handbook/random-thoughts/config-json-format.md\n\nimport { StackAssertionError, throwErr } from \"../utils/errors\";\nimport { deleteKey, filterUndefined, get, hasAndNotUndefined, set } from \"../utils/objects\";\nimport { OptionalKeys, RequiredKeys } from \"../utils/types\";\n\n\nexport type ConfigValue = string | number | boolean | null | ConfigValue[] | Config;\nexport type Config = {\n  [keyOrDotNotation: string]: ConfigValue | undefined,  // must support undefined for optional values\n};\n\nexport type NormalizedConfigValue = string | number | boolean | NormalizedConfig | NormalizedConfigValue[];\nexport type NormalizedConfig = {\n  [key: string]: NormalizedConfigValue | undefined,  // must support undefined for optional values\n};\n\nexport type _NormalizesTo<N> = N extends object ? (\n  & Config\n  & { [K in OptionalKeys<N>]?: _NormalizesTo<N[K]> | null }\n  & { [K in RequiredKeys<N>]: undefined extends N[K] ? _NormalizesTo<N[K]> | null : _NormalizesTo<N[K]> }\n  & { [K in `${string}.${string}`]: ConfigValue }\n) : N;\nexport type NormalizesTo<N extends NormalizedConfig> = _NormalizesTo<N>;\n\n/**\n * Note that a config can both be valid and not normalizable.\n */\nexport function isValidConfig(c: unknown): c is Config {\n  return getInvalidConfigReason(c) === undefined;\n}\n\nexport function getInvalidConfigReason(c: unknown, options: { configName?: string } = {}): string | undefined {\n  const configName = options.configName ?? 'config';\n  if (c === null || typeof c !== 'object') return `${configName} must be a non-null object`;\n  for (const [key, value] of Object.entries(c)) {\n    if (value === undefined) continue;\n    if (typeof key !== 'string') return `${configName} must have only string keys (found: ${typeof key})`;\n    if (!key.match(/^[a-zA-Z0-9_:$][a-zA-Z_:$0-9\\-]*(?:\\.[a-zA-Z0-9_:$][a-zA-Z_:$0-9\\-]*)*$/)) return `All keys of ${configName} must consist of only alphanumeric characters, dots, underscores, colons, dollar signs, or hyphens and start with a character other than a hyphen (found: ${key})`;\n\n    const entryName = `${configName}.${key}`;\n    const reason = getInvalidConfigValueReason(value, { valueName: entryName });\n    if (reason) return reason;\n  }\n  return undefined;\n}\n\nfunction getInvalidConfigValueReason(value: unknown, options: { valueName?: string } = {}): string | undefined {\n  const valueName = options.valueName ?? 'value';\n  switch (typeof value) {\n    case 'string':\n    case 'number':\n    case 'boolean': {\n      break;\n    }\n    case 'object': {\n      if (value === null) {\n        break;\n      } else if (Array.isArray(value)) {\n        for (const [index, v] of value.entries()) {\n          const reason = getInvalidConfigValueReason(v, { valueName: `${valueName}[${index}]` });\n          if (reason) return reason;\n        }\n      } else {\n        const reason = getInvalidConfigReason(value, { configName: valueName });\n        if (reason) return reason;\n      }\n      break;\n    }\n    default: {\n      return `${valueName} has an invalid value type ${typeof value} (value: ${value})`;\n    }\n  }\n  return undefined;\n}\n\nexport function assertValidConfig(c: unknown) {\n  const reason = getInvalidConfigReason(c);\n  if (reason) throw new StackAssertionError(`Invalid config: ${reason}`, { c });\n}\n\nexport function override(c1: Config, ...configs: Config[]) {\n  if (configs.length === 0) return c1;\n  if (configs.length > 1) return override(override(c1, configs[0]), ...configs.slice(1));\n  const c2 = configs[0];\n\n  assertValidConfig(c1);\n  assertValidConfig(c2);\n\n  let result = c1;\n  for (const key of Object.keys(filterUndefined(c2))) {\n    result = Object.fromEntries(\n      Object.entries(result).filter(([k]) => k !== key && !k.startsWith(key + '.'))\n    );\n  }\n\n  return {\n    ...result,\n    ...filterUndefined(c2),\n  };\n}\n\nundefined?.test(\"override(...)\", ({ expect }) => {\n  expect(\n    override(\n      {\n        a: 1,\n        b: 2,\n        \"c.d\": 3,\n        \"c.e.f\": 4,\n        \"c.g\": 5,\n        h: [6, { i: 7 }, 8],\n        k: 123,\n        l: undefined,\n      },\n      {\n        a: 9,\n        \"c.d\": 10,\n        \"c.e\": null,\n        \"h.0\": 11,\n        \"h.1\": {\n          j: 12,\n        },\n        k: undefined,\n      },\n    )\n  ).toEqual({\n    a: 9,\n    b: 2,\n    \"c.d\": 10,\n    \"c.e\": null,\n    \"c.g\": 5,\n    h: [6, { i: 7 }, 8],\n    \"h.0\": 11,\n    \"h.1\": {\n      j: 12,\n    },\n    k: 123,\n    l: undefined,\n  });\n});\n\ntype NormalizeOptions = {\n  /**\n   * What to do if a dot notation is used on a value that is not an object.\n   *\n   * - \"throw\" (default): Throw an error.\n   * - \"ignore\": Ignore the dot notation field.\n   */\n  onDotIntoNonObject?: \"throw\" | \"ignore\",\n  /**\n   * What to do if a dot notation is used on a value that is null.\n   *\n   * - \"like-non-object\"  (default): Treat it like a non-object. See `onDotIntoNonObject`.\n   * - \"throw\": Throw an error.\n   * - \"ignore\": Ignore the dot notation field.\n   * - \"empty-object\": Set the value to an empty object.\n   */\n  onDotIntoNull?: \"like-non-object\" | \"throw\" | \"ignore\" | \"empty-object\",\n}\n\nexport class NormalizationError extends Error {\n  constructor(...args: ConstructorParameters<typeof Error>) {\n    super(...args);\n  }\n}\nNormalizationError.prototype.name = \"NormalizationError\";\n\nexport function isNormalized(c: Config): c is NormalizedConfig {\n  assertValidConfig(c);\n  for (const [key, value] of Object.entries(c)) {\n    if (value === undefined) continue;\n    if (key.includes('.')) return false;\n    if (value === null) return false;\n  }\n  return true;\n}\n\nexport function assertNormalized(c: Config): asserts c is NormalizedConfig {\n  assertValidConfig(c);\n  if (!isNormalized(c)) throw new StackAssertionError(`Config is not normalized: ${JSON.stringify(c)}`);\n}\n\nexport function normalize(c: Config, options: NormalizeOptions = {}): NormalizedConfig {\n  assertValidConfig(c);\n  const onDotIntoNonObject = options.onDotIntoNonObject ?? \"throw\";\n  const onDotIntoNull = options.onDotIntoNull ?? \"like-non-object\";\n\n  const countDots = (s: string) => s.match(/\\./g)?.length ?? 0;\n  const result: NormalizedConfig = {};\n  const keysByDepth = Object.keys(c).sort((a, b) => countDots(a) - countDots(b));\n\n  outer: for (const key of keysByDepth) {\n    const keySegmentsWithoutLast = key.split('.');\n    const last = keySegmentsWithoutLast.pop() ?? throwErr('split returns empty array?');\n    const value = get(c, key);\n    if (value === undefined) continue;\n\n    let current: NormalizedConfig = result;\n    for (const keySegment of keySegmentsWithoutLast) {\n      if (!hasAndNotUndefined(current, keySegment)) {\n        switch (onDotIntoNull === \"like-non-object\" ? onDotIntoNonObject : onDotIntoNull) {\n          case \"throw\": {\n            throw new NormalizationError(`Tried to use dot notation to access ${JSON.stringify(key)}, but ${JSON.stringify(keySegment)} doesn't exist on the object (or is null).`);\n          }\n          case \"ignore\": {\n            continue outer;\n          }\n          case \"empty-object\": {\n            set(current, keySegment, {});\n            break;\n          }\n        }\n      }\n      const value = get(current, keySegment);\n      if (typeof value !== 'object') {\n        switch (onDotIntoNonObject) {\n          case \"throw\": {\n            throw new NormalizationError(`Tried to use dot notation to access ${JSON.stringify(key)}, but ${JSON.stringify(keySegment)} is not an object.`);\n          }\n          case \"ignore\": {\n            continue outer;\n          }\n        }\n      }\n      current = value as NormalizedConfig;\n    }\n    setNormalizedValue(current, last, value, options);\n  }\n  return result;\n}\n\nfunction normalizeValue(value: ConfigValue, options: NormalizeOptions): NormalizedConfigValue {\n  if (value === null) throw new NormalizationError(\"Tried to normalize a null value\");\n  if (Array.isArray(value)) return value.map(v => normalizeValue(v, options));\n  if (typeof value === 'object') return normalize(value, options);\n  return value;\n}\n\nfunction setNormalizedValue(result: NormalizedConfig, key: string, value: ConfigValue, options: NormalizeOptions) {\n  if (value === null) {\n    if (hasAndNotUndefined(result, key)) {\n      deleteKey(result, key);\n    }\n  } else {\n    set(result, key, normalizeValue(value, options));\n  }\n}\n\nundefined?.test(\"normalize(...)\", ({ expect }) => {\n  expect(normalize({\n    a: 9,\n    b: 2,\n    c: {},\n    \"c.d\": 10,\n    \"c.e\": null,\n    \"c.g\": 5,\n    h: [6, { i: 7 }, 8],\n    \"h.0\": 11,\n    \"h.1\": {\n      j: 12,\n    },\n    k: { l: {} },\n    \"k.l.m\": 13,\n    n: undefined,\n  }, { onDotIntoNonObject: \"ignore\" })).toEqual({\n    a: 9,\n    b: 2,\n    c: {\n      d: 10,\n      g: 5,\n    },\n    h: [11, { j: 12 }, 8],\n    k: { l: { m: 13 } },\n  });\n\n  // dotting into null\n  expect(() => normalize({\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"throw\" })).toThrow(`Tried to use dot notation to access \"b.c\", but \"b\" doesn't exist on the object (or is null)`);\n  expect(() => normalize({\n    b: null,\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"throw\" })).toThrow(`Tried to use dot notation to access \"b.c\", but \"b\" doesn't exist on the object (or is null)`);\n  expect(normalize({\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"ignore\" })).toEqual({});\n\n  // dotting into non-object\n  expect(() => normalize({\n    b: 1,\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"throw\" })).toThrow(`Tried to use dot notation to access \"b.c\", but \"b\" is not an object`);\n  expect(normalize({\n    b: 1,\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"ignore\" })).toEqual({ b: 1 });\n});\n"],"mappings":"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","names":["value"]}
+{"version":3,"sources":["../../src/config/format.ts"],"sourcesContent":["// see https://github.com/stack-auth/info/blob/main/eng-handbook/random-thoughts/config-json-format.md\n\nimport { StackAssertionError, throwErr } from \"../utils/errors\";\nimport { deleteKey, filterUndefined, get, hasAndNotUndefined, set } from \"../utils/objects\";\nimport { OptionalKeys, RequiredKeys } from \"../utils/types\";\n\n\nexport type ConfigValue = string | number | boolean | null | ConfigValue[] | Config;\nexport type Config = {\n  [keyOrDotNotation: string]: ConfigValue | undefined,  // must support undefined for optional values\n};\n\nexport type NormalizedConfigValue = string | number | boolean | NormalizedConfig | NormalizedConfigValue[];\nexport type NormalizedConfig = {\n  [key: string]: NormalizedConfigValue | undefined,  // must support undefined for optional values\n};\n\nexport type _NormalizesTo<N> = N extends object ? (\n  & Config\n  & { [K in OptionalKeys<N>]?: _NormalizesTo<N[K]> | null }\n  & { [K in RequiredKeys<N>]: undefined extends N[K] ? _NormalizesTo<N[K]> | null : _NormalizesTo<N[K]> }\n  & { [K in `${string}.${string}`]: ConfigValue }\n) : N;\nexport type NormalizesTo<N extends NormalizedConfig> = _NormalizesTo<N>;\n\n/**\n * Note that a config can both be valid and not normalizable.\n */\nexport function isValidConfig(c: unknown): c is Config {\n  return getInvalidConfigReason(c) === undefined;\n}\n\nexport function getInvalidConfigReason(c: unknown, options: { configName?: string } = {}): string | undefined {\n  const configName = options.configName ?? 'config';\n  if (c === null || typeof c !== 'object') return `${configName} must be a non-null object`;\n  for (const [key, value] of Object.entries(c)) {\n    if (value === undefined) continue;\n    if (typeof key !== 'string') return `${configName} must have only string keys (found: ${typeof key})`;\n    if (!key.match(/^[a-zA-Z0-9_:$][a-zA-Z_:$0-9\\-]*(?:\\.[a-zA-Z0-9_:$][a-zA-Z_:$0-9\\-]*)*$/)) return `All keys of ${configName} must consist of only alphanumeric characters, dots, underscores, colons, dollar signs, or hyphens and start with a character other than a hyphen (found: ${key})`;\n\n    const entryName = `${configName}.${key}`;\n    const reason = getInvalidConfigValueReason(value, { valueName: entryName });\n    if (reason) return reason;\n  }\n  return undefined;\n}\n\nfunction getInvalidConfigValueReason(value: unknown, options: { valueName?: string } = {}): string | undefined {\n  const valueName = options.valueName ?? 'value';\n  switch (typeof value) {\n    case 'string':\n    case 'number':\n    case 'boolean': {\n      break;\n    }\n    case 'object': {\n      if (value === null) {\n        break;\n      } else if (Array.isArray(value)) {\n        for (const [index, v] of value.entries()) {\n          const elementValueName = `${valueName}[${index}]`;\n          if (v === null) return `${elementValueName} is null; tuple elements cannot be null`;\n          const reason = getInvalidConfigValueReason(v, { valueName: elementValueName });\n          if (reason) return reason;\n        }\n      } else {\n        const reason = getInvalidConfigReason(value, { configName: valueName });\n        if (reason) return reason;\n      }\n      break;\n    }\n    default: {\n      return `${valueName} has an invalid value type ${typeof value} (value: ${value})`;\n    }\n  }\n  return undefined;\n}\n\nexport function assertValidConfig(c: unknown) {\n  const reason = getInvalidConfigReason(c);\n  if (reason) throw new StackAssertionError(`Invalid config: ${reason}`, { c });\n}\n\nexport function override(c1: Config, ...configs: Config[]) {\n  if (configs.length === 0) return c1;\n  if (configs.length > 1) return override(override(c1, configs[0]), ...configs.slice(1));\n  const c2 = configs[0];\n\n  assertValidConfig(c1);\n  assertValidConfig(c2);\n\n  let result = c1;\n  for (const key of Object.keys(filterUndefined(c2))) {\n    result = Object.fromEntries(\n      Object.entries(result).filter(([k]) => k !== key && !k.startsWith(key + '.'))\n    );\n  }\n\n  return {\n    ...result,\n    ...filterUndefined(c2),\n  };\n}\n\nundefined?.test(\"override(...)\", ({ expect }) => {\n  expect(\n    override(\n      {\n        a: 1,\n        b: 2,\n        \"c.d\": 3,\n        \"c.e.f\": 4,\n        \"c.g\": 5,\n        h: [6, { i: 7 }, 8],\n        k: 123,\n        l: undefined,\n      },\n      {\n        a: 9,\n        \"c.d\": 10,\n        \"c.e\": null,\n        \"h.0\": 11,\n        \"h.1\": {\n          j: 12,\n        },\n        k: undefined,\n      },\n    )\n  ).toEqual({\n    a: 9,\n    b: 2,\n    \"c.d\": 10,\n    \"c.e\": null,\n    \"c.g\": 5,\n    h: [6, { i: 7 }, 8],\n    \"h.0\": 11,\n    \"h.1\": {\n      j: 12,\n    },\n    k: 123,\n    l: undefined,\n  });\n});\n\ntype NormalizeOptions = {\n  /**\n   * What to do if a dot notation is used on a value that is not an object.\n   *\n   * - \"throw\" (default): Throw an error.\n   * - \"ignore\": Ignore the dot notation field.\n   */\n  onDotIntoNonObject?: \"throw\" | \"ignore\",\n  /**\n   * What to do if a dot notation is used on a value that is null.\n   *\n   * - \"like-non-object\"  (default): Treat it like a non-object. See `onDotIntoNonObject`.\n   * - \"throw\": Throw an error.\n   * - \"ignore\": Ignore the dot notation field.\n   * - \"empty-object\": Set the value to an empty object.\n   */\n  onDotIntoNull?: \"like-non-object\" | \"throw\" | \"ignore\" | \"empty-object\",\n}\n\nexport class NormalizationError extends Error {\n  constructor(...args: ConstructorParameters<typeof Error>) {\n    super(...args);\n  }\n}\nNormalizationError.prototype.name = \"NormalizationError\";\n\nexport function isNormalized(c: Config): c is NormalizedConfig {\n  assertValidConfig(c);\n  for (const [key, value] of Object.entries(c)) {\n    if (value === undefined) continue;\n    if (key.includes('.')) return false;\n    if (value === null) return false;\n  }\n  return true;\n}\n\nexport function assertNormalized(c: Config): asserts c is NormalizedConfig {\n  assertValidConfig(c);\n  if (!isNormalized(c)) throw new StackAssertionError(`Config is not normalized: ${JSON.stringify(c)}`);\n}\n\nexport function normalize(c: Config, options: NormalizeOptions = {}): NormalizedConfig {\n  assertValidConfig(c);\n  const onDotIntoNonObject = options.onDotIntoNonObject ?? \"throw\";\n  const onDotIntoNull = options.onDotIntoNull ?? \"like-non-object\";\n\n  const countDots = (s: string) => s.match(/\\./g)?.length ?? 0;\n  const result: NormalizedConfig = {};\n  const keysByDepth = Object.keys(c).sort((a, b) => countDots(a) - countDots(b));\n\n  outer: for (const key of keysByDepth) {\n    const keySegmentsWithoutLast = key.split('.');\n    const last = keySegmentsWithoutLast.pop() ?? throwErr('split returns empty array?');\n    const value = get(c, key);\n    if (value === undefined) continue;\n\n    let current: NormalizedConfig = result;\n    for (const keySegment of keySegmentsWithoutLast) {\n      if (!hasAndNotUndefined(current, keySegment)) {\n        switch (onDotIntoNull === \"like-non-object\" ? onDotIntoNonObject : onDotIntoNull) {\n          case \"throw\": {\n            throw new NormalizationError(`Tried to use dot notation to access ${JSON.stringify(key)}, but ${JSON.stringify(keySegment)} doesn't exist on the object (or is null).`);\n          }\n          case \"ignore\": {\n            continue outer;\n          }\n          case \"empty-object\": {\n            set(current, keySegment, {});\n            break;\n          }\n        }\n      }\n      const value = get(current, keySegment);\n      if (typeof value !== 'object') {\n        switch (onDotIntoNonObject) {\n          case \"throw\": {\n            throw new NormalizationError(`Tried to use dot notation to access ${JSON.stringify(key)}, but ${JSON.stringify(keySegment)} is not an object.`);\n          }\n          case \"ignore\": {\n            continue outer;\n          }\n        }\n      }\n      current = value as NormalizedConfig;\n    }\n    setNormalizedValue(current, last, value, options);\n  }\n  return result;\n}\n\nfunction normalizeValue(value: ConfigValue, options: NormalizeOptions): NormalizedConfigValue {\n  if (value === null) throw new NormalizationError(\"Tried to normalize a null value\");\n  if (Array.isArray(value)) return value.map(v => normalizeValue(v, options));\n  if (typeof value === 'object') return normalize(value, options);\n  return value;\n}\n\nfunction setNormalizedValue(result: NormalizedConfig, key: string, value: ConfigValue, options: NormalizeOptions) {\n  if (value === null) {\n    if (hasAndNotUndefined(result, key)) {\n      deleteKey(result, key);\n    }\n  } else {\n    set(result, key, normalizeValue(value, options));\n  }\n}\n\nundefined?.test(\"normalize(...)\", ({ expect }) => {\n  expect(normalize({\n    a: 9,\n    b: 2,\n    c: {},\n    \"c.d\": 10,\n    \"c.e\": null,\n    \"c.g\": 5,\n    h: [6, { i: 7 }, 8],\n    \"h.0\": 11,\n    \"h.1\": {\n      j: 12,\n    },\n    k: { l: {} },\n    \"k.l.m\": 13,\n    n: undefined,\n  }, { onDotIntoNonObject: \"ignore\" })).toEqual({\n    a: 9,\n    b: 2,\n    c: {\n      d: 10,\n      g: 5,\n    },\n    h: [11, { j: 12 }, 8],\n    k: { l: { m: 13 } },\n  });\n\n  // dotting into null\n  expect(() => normalize({\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"throw\" })).toThrow(`Tried to use dot notation to access \"b.c\", but \"b\" doesn't exist on the object (or is null)`);\n  expect(() => normalize({\n    b: null,\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"throw\" })).toThrow(`Tried to use dot notation to access \"b.c\", but \"b\" doesn't exist on the object (or is null)`);\n  expect(normalize({\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"ignore\" })).toEqual({});\n\n  // dotting into non-object\n  expect(() => normalize({\n    b: 1,\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"throw\" })).toThrow(`Tried to use dot notation to access \"b.c\", but \"b\" is not an object`);\n  expect(normalize({\n    b: 1,\n    \"b.c\": 2,\n  }, { onDotIntoNonObject: \"ignore\" })).toEqual({ b: 1 });\n});\n"],"mappings":"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","names":["value"]}

package/dist/config/schema-fuzzer.test.d.mts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/config/schema-fuzzer.test.d.ts

@@ -0,0 +1,2 @@
+
+export {  }