@khanacademy/perseus-core 1.4.2 → 1.5.0

package/dist/error/errors.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @typedef {Object} Errors utility for referencing the Perseus error taxonomy.
+ */
+export declare const Errors: Readonly<{
+    /**
+     * @property {ErrorKind} Unknown The kind of error is not known.
+     */
+    Unknown: "Unknown";
+    /**
+     * @property {ErrorKind} Internal The error is internal to the executing code.
+     */
+    Internal: "Internal";
+    /**
+     * @property {ErrorKind} InvalidInput There was a problem with the provided
+     * input, such as the wrong format or a null value.
+     */
+    InvalidInput: "InvalidInput";
+    /**
+     * @property {ErrorKind} NotAllowed There was a problem due to the state of
+     * the system not matching the requested operation or input. For example,
+     * trying to create a username that is valid, but is already taken by
+     * another user. Use {@link InvalidInput} instead when the input isn't
+     * valid regardless of the state of the system. Use {@link NotFound} when
+     * the failure is due to not being able to find a resource.
+     */
+    NotAllowed: "NotAllowed";
+    /**
+     * @property {ErrorKind} TransientService There was a problem when making a
+     * request to a service.
+     */
+    TransientService: "TransientService";
+    /**
+     * @property {ErrorKind} Service There was a non-transient problem when
+     * making a request to service.
+     */
+    Service: "Service";
+}>;
+/**
+ * @type {ErrorKind} The kind of error being reported
+ */
+export type ErrorKind = (typeof Errors)[keyof typeof Errors];

package/dist/error/perseus-error.d.ts

@@ -0,0 +1,11 @@
+import type { ErrorKind } from "./errors";
+import type { Metadata } from "@khanacademy/wonder-stuff-core";
+type Options = {
+    metadata?: Metadata | null | undefined;
+};
+export declare class PerseusError extends Error {
+    kind: ErrorKind;
+    metadata: Metadata | null | undefined;
+    constructor(message: string, kind: ErrorKind, options?: Options);
+}
+export {};

package/dist/es/index.js

@@ -42,8 +42,60 @@ const addLibraryVersionToPerseusDebug = (libraryName, libraryVersion) => {
 
 // This file is processed by a Rollup plugin (replace) to inject the production
 const libName = "@khanacademy/perseus-core";
-const libVersion = "1.4.2";
+const libVersion = "1.5.0";
 addLibraryVersionToPerseusDebug(libName, libVersion);
 
-export { addLibraryVersionToPerseusDebug, libVersion };
+/**
+ * @typedef {Object} Errors utility for referencing the Perseus error taxonomy.
+ */
+const Errors = Object.freeze({
+  /**
+   * @property {ErrorKind} Unknown The kind of error is not known.
+   */
+  Unknown: "Unknown",
+  /**
+   * @property {ErrorKind} Internal The error is internal to the executing code.
+   */
+  Internal: "Internal",
+  /**
+   * @property {ErrorKind} InvalidInput There was a problem with the provided
+   * input, such as the wrong format or a null value.
+   */
+  InvalidInput: "InvalidInput",
+  /**
+   * @property {ErrorKind} NotAllowed There was a problem due to the state of
+   * the system not matching the requested operation or input. For example,
+   * trying to create a username that is valid, but is already taken by
+   * another user. Use {@link InvalidInput} instead when the input isn't
+   * valid regardless of the state of the system. Use {@link NotFound} when
+   * the failure is due to not being able to find a resource.
+   */
+  NotAllowed: "NotAllowed",
+  /**
+   * @property {ErrorKind} TransientService There was a problem when making a
+   * request to a service.
+   */
+  TransientService: "TransientService",
+  /**
+   * @property {ErrorKind} Service There was a non-transient problem when
+   * making a request to service.
+   */
+  Service: "Service"
+});
+
+/**
+ * @type {ErrorKind} The kind of error being reported
+ */
+
+class PerseusError extends Error {
+  constructor(message, kind, options) {
+    super(message);
+    this.kind = void 0;
+    this.metadata = void 0;
+    this.kind = kind;
+    this.metadata = options == null ? void 0 : options.metadata;
+  }
+}
+
+export { Errors, PerseusError, addLibraryVersionToPerseusDebug, libVersion };
 //# sourceMappingURL=index.js.map

package/dist/es/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/utils/add-library-version-to-perseus-debug.ts","../../src/version.ts"],"sourcesContent":["/**\n * Adds the given perseus library version information to the __perseus_debug__\n * object and ensures that the object is attached to `globalThis` (`window` in\n * browser environments).\n *\n * This allows each library to provide runtime version information to assist in\n * debugging in production environments.\n */\nexport const addLibraryVersionToPerseusDebug = (\n    libraryName: string,\n    libraryVersion: string,\n) => {\n    // If the library version is the default value, then we don't want to\n    // prefix it with a \"v\" to indicate that it is a version number.\n    let prefix = \"v\";\n    if (libraryVersion === \"__lib_version__\") {\n        prefix = \"\";\n    }\n    const formattedVersion = `${prefix}${libraryVersion}`;\n\n    if (typeof globalThis !== \"undefined\") {\n        globalThis.__perseus_debug__ = globalThis.__perseus_debug__ ?? {};\n\n        const existingVersionEntry = globalThis.__perseus_debug__[libraryName];\n        if (existingVersionEntry) {\n            // If we already have an entry and it doesn't match the registered\n            // version, we morph the entry into an array and log a warning.\n            if (existingVersionEntry !== formattedVersion) {\n                // Existing entry might be an array already (oops, at least 2\n                // versions of the library already loaded!).\n                const allVersions = Array.isArray(existingVersionEntry)\n                    ? existingVersionEntry\n                    : [existingVersionEntry];\n                allVersions.push(formattedVersion);\n\n                globalThis.__perseus_debug__[libraryName] = allVersions;\n\n                // eslint-disable-next-line no-console\n                console.warn(\n                    `Multiple versions of ${libraryName} loaded on this page: ${allVersions\n                        .sort()\n                        .join(\", \")}`,\n                );\n            }\n        } else {\n            globalThis.__perseus_debug__[libraryName] = formattedVersion;\n        }\n    } else {\n        // eslint-disable-next-line no-console\n        console.warn(`globalThis not found found (${formattedVersion})`);\n    }\n};\n","// This file is processed by a Rollup plugin (replace) to inject the production\n// version number during the release build.\n// In dev, you'll never see the version number.\n\nimport {addLibraryVersionToPerseusDebug} from \"./utils/add-library-version-to-perseus-debug\";\n\nconst libName = \"@khanacademy/perseus-core\";\nexport const libVersion = \"__lib_version__\";\n\naddLibraryVersionToPerseusDebug(libName, libVersion);\n"],"names":["addLibraryVersionToPerseusDebug","libraryName","libraryVersion","prefix","formattedVersion","globalThis","_globalThis$__perseus","__perseus_debug__","existingVersionEntry","allVersions","Array","isArray","push","console","warn","sort","join","libName","libVersion"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;MACaA,+BAA+B,GAAGA,CAC3CC,WAAmB,EACnBC,cAAsB,KACrB;AACD;AACA;EACA,IAAIC,MAAM,GAAG,GAAG,CAAA;EAChB,IAAID,cAAc,KAAK,iBAAiB,EAAE;AACtCC,IAAAA,MAAM,GAAG,EAAE,CAAA;AACf,GAAA;AACA,EAAA,MAAMC,gBAAgB,GAAI,CAAA,EAAED,MAAO,CAAA,EAAED,cAAe,CAAC,CAAA,CAAA;AAErD,EAAA,IAAI,OAAOG,UAAU,KAAK,WAAW,EAAE;AAAA,IAAA,IAAAC,qBAAA,CAAA;AACnCD,IAAAA,UAAU,CAACE,iBAAiB,GAAAD,CAAAA,qBAAA,GAAGD,UAAU,CAACE,iBAAiB,KAAAD,IAAAA,GAAAA,qBAAA,GAAI,EAAE,CAAA;AAEjE,IAAA,MAAME,oBAAoB,GAAGH,UAAU,CAACE,iBAAiB,CAACN,WAAW,CAAC,CAAA;AACtE,IAAA,IAAIO,oBAAoB,EAAE;AACtB;AACA;MACA,IAAIA,oBAAoB,KAAKJ,gBAAgB,EAAE;AAC3C;AACA;AACA,QAAA,MAAMK,WAAW,GAAGC,KAAK,CAACC,OAAO,CAACH,oBAAoB,CAAC,GACjDA,oBAAoB,GACpB,CAACA,oBAAoB,CAAC,CAAA;AAC5BC,QAAAA,WAAW,CAACG,IAAI,CAACR,gBAAgB,CAAC,CAAA;AAElCC,QAAAA,UAAU,CAACE,iBAAiB,CAACN,WAAW,CAAC,GAAGQ,WAAW,CAAA;;AAEvD;AACAI,QAAAA,OAAO,CAACC,IAAI,CACP,CAAuBb,qBAAAA,EAAAA,WAAY,yBAAwBQ,WAAW,CAClEM,IAAI,EAAE,CACNC,IAAI,CAAC,IAAI,CAAE,EACpB,CAAC,CAAA;AACL,OAAA;AACJ,KAAC,MAAM;AACHX,MAAAA,UAAU,CAACE,iBAAiB,CAACN,WAAW,CAAC,GAAGG,gBAAgB,CAAA;AAChE,KAAA;AACJ,GAAC,MAAM;AACH;AACAS,IAAAA,OAAO,CAACC,IAAI,CAAE,CAA8BV,4BAAAA,EAAAA,gBAAiB,GAAE,CAAC,CAAA;AACpE,GAAA;AACJ;;ACnDA;AAMA,MAAMa,OAAO,GAAG,2BAA2B,CAAA;AACpC,MAAMC,UAAU,GAAG,QAAiB;AAE3ClB,+BAA+B,CAACiB,OAAO,EAAEC,UAAU,CAAC;;;;"}
+{"version":3,"file":"index.js","sources":["../../src/utils/add-library-version-to-perseus-debug.ts","../../src/version.ts","../../src/error/errors.ts","../../src/error/perseus-error.ts"],"sourcesContent":["/**\n * Adds the given perseus library version information to the __perseus_debug__\n * object and ensures that the object is attached to `globalThis` (`window` in\n * browser environments).\n *\n * This allows each library to provide runtime version information to assist in\n * debugging in production environments.\n */\nexport const addLibraryVersionToPerseusDebug = (\n    libraryName: string,\n    libraryVersion: string,\n) => {\n    // If the library version is the default value, then we don't want to\n    // prefix it with a \"v\" to indicate that it is a version number.\n    let prefix = \"v\";\n    if (libraryVersion === \"__lib_version__\") {\n        prefix = \"\";\n    }\n    const formattedVersion = `${prefix}${libraryVersion}`;\n\n    if (typeof globalThis !== \"undefined\") {\n        globalThis.__perseus_debug__ = globalThis.__perseus_debug__ ?? {};\n\n        const existingVersionEntry = globalThis.__perseus_debug__[libraryName];\n        if (existingVersionEntry) {\n            // If we already have an entry and it doesn't match the registered\n            // version, we morph the entry into an array and log a warning.\n            if (existingVersionEntry !== formattedVersion) {\n                // Existing entry might be an array already (oops, at least 2\n                // versions of the library already loaded!).\n                const allVersions = Array.isArray(existingVersionEntry)\n                    ? existingVersionEntry\n                    : [existingVersionEntry];\n                allVersions.push(formattedVersion);\n\n                globalThis.__perseus_debug__[libraryName] = allVersions;\n\n                // eslint-disable-next-line no-console\n                console.warn(\n                    `Multiple versions of ${libraryName} loaded on this page: ${allVersions\n                        .sort()\n                        .join(\", \")}`,\n                );\n            }\n        } else {\n            globalThis.__perseus_debug__[libraryName] = formattedVersion;\n        }\n    } else {\n        // eslint-disable-next-line no-console\n        console.warn(`globalThis not found found (${formattedVersion})`);\n    }\n};\n","// This file is processed by a Rollup plugin (replace) to inject the production\n// version number during the release build.\n// In dev, you'll never see the version number.\n\nimport {addLibraryVersionToPerseusDebug} from \"./utils/add-library-version-to-perseus-debug\";\n\nconst libName = \"@khanacademy/perseus-core\";\nexport const libVersion = \"__lib_version__\";\n\naddLibraryVersionToPerseusDebug(libName, libVersion);\n","/**\n * @typedef {Object} Errors utility for referencing the Perseus error taxonomy.\n */\nexport const Errors = Object.freeze({\n    /**\n     * @property {ErrorKind} Unknown The kind of error is not known.\n     */\n    Unknown: \"Unknown\",\n    /**\n     * @property {ErrorKind} Internal The error is internal to the executing code.\n     */\n    Internal: \"Internal\",\n    /**\n     * @property {ErrorKind} InvalidInput There was a problem with the provided\n     * input, such as the wrong format or a null value.\n     */\n    InvalidInput: \"InvalidInput\",\n    /**\n     * @property {ErrorKind} NotAllowed There was a problem due to the state of\n     * the system not matching the requested operation or input. For example,\n     * trying to create a username that is valid, but is already taken by\n     * another user. Use {@link InvalidInput} instead when the input isn't\n     * valid regardless of the state of the system. Use {@link NotFound} when\n     * the failure is due to not being able to find a resource.\n     */\n    NotAllowed: \"NotAllowed\",\n    /**\n     * @property {ErrorKind} TransientService There was a problem when making a\n     * request to a service.\n     */\n    TransientService: \"TransientService\",\n    /**\n     * @property {ErrorKind} Service There was a non-transient problem when\n     * making a request to service.\n     */\n    Service: \"Service\",\n});\n\n/**\n * @type {ErrorKind} The kind of error being reported\n */\nexport type ErrorKind = (typeof Errors)[keyof typeof Errors];\n","import type {ErrorKind} from \"./errors\";\nimport type {Metadata} from \"@khanacademy/wonder-stuff-core\";\n\ntype Options = {\n    metadata?: Metadata | null | undefined;\n};\n\nexport class PerseusError extends Error {\n    kind: ErrorKind;\n    metadata: Metadata | null | undefined;\n\n    constructor(message: string, kind: ErrorKind, options?: Options) {\n        super(message);\n        this.kind = kind;\n        this.metadata = options?.metadata;\n    }\n}\n"],"names":["addLibraryVersionToPerseusDebug","libraryName","libraryVersion","prefix","formattedVersion","globalThis","_globalThis$__perseus","__perseus_debug__","existingVersionEntry","allVersions","Array","isArray","push","console","warn","sort","join","libName","libVersion","Errors","Object","freeze","Unknown","Internal","InvalidInput","NotAllowed","TransientService","Service","PerseusError","Error","constructor","message","kind","options","metadata"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;MACaA,+BAA+B,GAAGA,CAC3CC,WAAmB,EACnBC,cAAsB,KACrB;AACD;AACA;EACA,IAAIC,MAAM,GAAG,GAAG,CAAA;EAChB,IAAID,cAAc,KAAK,iBAAiB,EAAE;AACtCC,IAAAA,MAAM,GAAG,EAAE,CAAA;AACf,GAAA;AACA,EAAA,MAAMC,gBAAgB,GAAI,CAAA,EAAED,MAAO,CAAA,EAAED,cAAe,CAAC,CAAA,CAAA;AAErD,EAAA,IAAI,OAAOG,UAAU,KAAK,WAAW,EAAE;AAAA,IAAA,IAAAC,qBAAA,CAAA;AACnCD,IAAAA,UAAU,CAACE,iBAAiB,GAAAD,CAAAA,qBAAA,GAAGD,UAAU,CAACE,iBAAiB,KAAAD,IAAAA,GAAAA,qBAAA,GAAI,EAAE,CAAA;AAEjE,IAAA,MAAME,oBAAoB,GAAGH,UAAU,CAACE,iBAAiB,CAACN,WAAW,CAAC,CAAA;AACtE,IAAA,IAAIO,oBAAoB,EAAE;AACtB;AACA;MACA,IAAIA,oBAAoB,KAAKJ,gBAAgB,EAAE;AAC3C;AACA;AACA,QAAA,MAAMK,WAAW,GAAGC,KAAK,CAACC,OAAO,CAACH,oBAAoB,CAAC,GACjDA,oBAAoB,GACpB,CAACA,oBAAoB,CAAC,CAAA;AAC5BC,QAAAA,WAAW,CAACG,IAAI,CAACR,gBAAgB,CAAC,CAAA;AAElCC,QAAAA,UAAU,CAACE,iBAAiB,CAACN,WAAW,CAAC,GAAGQ,WAAW,CAAA;;AAEvD;AACAI,QAAAA,OAAO,CAACC,IAAI,CACP,CAAuBb,qBAAAA,EAAAA,WAAY,yBAAwBQ,WAAW,CAClEM,IAAI,EAAE,CACNC,IAAI,CAAC,IAAI,CAAE,EACpB,CAAC,CAAA;AACL,OAAA;AACJ,KAAC,MAAM;AACHX,MAAAA,UAAU,CAACE,iBAAiB,CAACN,WAAW,CAAC,GAAGG,gBAAgB,CAAA;AAChE,KAAA;AACJ,GAAC,MAAM;AACH;AACAS,IAAAA,OAAO,CAACC,IAAI,CAAE,CAA8BV,4BAAAA,EAAAA,gBAAiB,GAAE,CAAC,CAAA;AACpE,GAAA;AACJ;;ACnDA;AAMA,MAAMa,OAAO,GAAG,2BAA2B,CAAA;AACpC,MAAMC,UAAU,GAAG,QAAiB;AAE3ClB,+BAA+B,CAACiB,OAAO,EAAEC,UAAU,CAAC;;ACTpD;AACA;AACA;MACaC,MAAM,GAAGC,MAAM,CAACC,MAAM,CAAC;AAChC;AACJ;AACA;AACIC,EAAAA,OAAO,EAAE,SAAS;AAClB;AACJ;AACA;AACIC,EAAAA,QAAQ,EAAE,UAAU;AACpB;AACJ;AACA;AACA;AACIC,EAAAA,YAAY,EAAE,cAAc;AAC5B;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACIC,EAAAA,UAAU,EAAE,YAAY;AACxB;AACJ;AACA;AACA;AACIC,EAAAA,gBAAgB,EAAE,kBAAkB;AACpC;AACJ;AACA;AACA;AACIC,EAAAA,OAAO,EAAE,SAAA;AACb,CAAC,EAAC;;AAEF;AACA;AACA;;ACjCO,MAAMC,YAAY,SAASC,KAAK,CAAC;AAIpCC,EAAAA,WAAWA,CAACC,OAAe,EAAEC,IAAe,EAAEC,OAAiB,EAAE;IAC7D,KAAK,CAACF,OAAO,CAAC,CAAA;AAAC,IAAA,IAAA,CAJnBC,IAAI,GAAA,KAAA,CAAA,CAAA;AAAA,IAAA,IAAA,CACJE,QAAQ,GAAA,KAAA,CAAA,CAAA;IAIJ,IAAI,CAACF,IAAI,GAAGA,IAAI,CAAA;AAChB,IAAA,IAAI,CAACE,QAAQ,GAAGD,OAAO,IAAPA,IAAAA,GAAAA,KAAAA,CAAAA,GAAAA,OAAO,CAAEC,QAAQ,CAAA;AACrC,GAAA;AACJ;;;;"}

package/dist/index.d.ts

@@ -1,4 +1,7 @@
 export type { PerseusAnalyticsEvent, AnalyticsEventHandlerFn } from "./analytics";
 export type { KEScore, KeypadContextRendererInterface, RendererInterface, } from "./types";
+export type { ErrorKind } from "./error/errors";
 export { addLibraryVersionToPerseusDebug } from "./utils/add-library-version-to-perseus-debug";
 export { libVersion } from "./version";
+export { Errors } from "./error/errors";
+export { PerseusError } from "./error/perseus-error";

package/dist/index.js

@@ -45,9 +45,63 @@ const addLibraryVersionToPerseusDebug = (libraryName, libraryVersion) => {
 
 // This file is processed by a Rollup plugin (replace) to inject the production
 const libName = "@khanacademy/perseus-core";
-const libVersion = "1.4.2";
+const libVersion = "1.5.0";
 addLibraryVersionToPerseusDebug(libName, libVersion);
 
+/**
+ * @typedef {Object} Errors utility for referencing the Perseus error taxonomy.
+ */
+const Errors = Object.freeze({
+  /**
+   * @property {ErrorKind} Unknown The kind of error is not known.
+   */
+  Unknown: "Unknown",
+  /**
+   * @property {ErrorKind} Internal The error is internal to the executing code.
+   */
+  Internal: "Internal",
+  /**
+   * @property {ErrorKind} InvalidInput There was a problem with the provided
+   * input, such as the wrong format or a null value.
+   */
+  InvalidInput: "InvalidInput",
+  /**
+   * @property {ErrorKind} NotAllowed There was a problem due to the state of
+   * the system not matching the requested operation or input. For example,
+   * trying to create a username that is valid, but is already taken by
+   * another user. Use {@link InvalidInput} instead when the input isn't
+   * valid regardless of the state of the system. Use {@link NotFound} when
+   * the failure is due to not being able to find a resource.
+   */
+  NotAllowed: "NotAllowed",
+  /**
+   * @property {ErrorKind} TransientService There was a problem when making a
+   * request to a service.
+   */
+  TransientService: "TransientService",
+  /**
+   * @property {ErrorKind} Service There was a non-transient problem when
+   * making a request to service.
+   */
+  Service: "Service"
+});
+
+/**
+ * @type {ErrorKind} The kind of error being reported
+ */
+
+class PerseusError extends Error {
+  kind;
+  metadata;
+  constructor(message, kind, options) {
+    super(message);
+    this.kind = kind;
+    this.metadata = options?.metadata;
+  }
+}
+
+exports.Errors = Errors;
+exports.PerseusError = PerseusError;
 exports.addLibraryVersionToPerseusDebug = addLibraryVersionToPerseusDebug;
 exports.libVersion = libVersion;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/utils/add-library-version-to-perseus-debug.ts","../src/version.ts"],"sourcesContent":["/**\n * Adds the given perseus library version information to the __perseus_debug__\n * object and ensures that the object is attached to `globalThis` (`window` in\n * browser environments).\n *\n * This allows each library to provide runtime version information to assist in\n * debugging in production environments.\n */\nexport const addLibraryVersionToPerseusDebug = (\n    libraryName: string,\n    libraryVersion: string,\n) => {\n    // If the library version is the default value, then we don't want to\n    // prefix it with a \"v\" to indicate that it is a version number.\n    let prefix = \"v\";\n    if (libraryVersion === \"__lib_version__\") {\n        prefix = \"\";\n    }\n    const formattedVersion = `${prefix}${libraryVersion}`;\n\n    if (typeof globalThis !== \"undefined\") {\n        globalThis.__perseus_debug__ = globalThis.__perseus_debug__ ?? {};\n\n        const existingVersionEntry = globalThis.__perseus_debug__[libraryName];\n        if (existingVersionEntry) {\n            // If we already have an entry and it doesn't match the registered\n            // version, we morph the entry into an array and log a warning.\n            if (existingVersionEntry !== formattedVersion) {\n                // Existing entry might be an array already (oops, at least 2\n                // versions of the library already loaded!).\n                const allVersions = Array.isArray(existingVersionEntry)\n                    ? existingVersionEntry\n                    : [existingVersionEntry];\n                allVersions.push(formattedVersion);\n\n                globalThis.__perseus_debug__[libraryName] = allVersions;\n\n                // eslint-disable-next-line no-console\n                console.warn(\n                    `Multiple versions of ${libraryName} loaded on this page: ${allVersions\n                        .sort()\n                        .join(\", \")}`,\n                );\n            }\n        } else {\n            globalThis.__perseus_debug__[libraryName] = formattedVersion;\n        }\n    } else {\n        // eslint-disable-next-line no-console\n        console.warn(`globalThis not found found (${formattedVersion})`);\n    }\n};\n","// This file is processed by a Rollup plugin (replace) to inject the production\n// version number during the release build.\n// In dev, you'll never see the version number.\n\nimport {addLibraryVersionToPerseusDebug} from \"./utils/add-library-version-to-perseus-debug\";\n\nconst libName = \"@khanacademy/perseus-core\";\nexport const libVersion = \"__lib_version__\";\n\naddLibraryVersionToPerseusDebug(libName, libVersion);\n"],"names":["addLibraryVersionToPerseusDebug","libraryName","libraryVersion","prefix","formattedVersion","globalThis","__perseus_debug__","existingVersionEntry","allVersions","Array","isArray","push","console","warn","sort","join","libName","libVersion"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;MACaA,+BAA+B,GAAGA,CAC3CC,WAAmB,EACnBC,cAAsB,KACrB;AACD;AACA;EACA,IAAIC,MAAM,GAAG,GAAG,CAAA;EAChB,IAAID,cAAc,KAAK,iBAAiB,EAAE;AACtCC,IAAAA,MAAM,GAAG,EAAE,CAAA;AACf,GAAA;AACA,EAAA,MAAMC,gBAAgB,GAAI,CAAA,EAAED,MAAO,CAAA,EAAED,cAAe,CAAC,CAAA,CAAA;AAErD,EAAA,IAAI,OAAOG,UAAU,KAAK,WAAW,EAAE;IACnCA,UAAU,CAACC,iBAAiB,GAAGD,UAAU,CAACC,iBAAiB,IAAI,EAAE,CAAA;AAEjE,IAAA,MAAMC,oBAAoB,GAAGF,UAAU,CAACC,iBAAiB,CAACL,WAAW,CAAC,CAAA;AACtE,IAAA,IAAIM,oBAAoB,EAAE;AACtB;AACA;MACA,IAAIA,oBAAoB,KAAKH,gBAAgB,EAAE;AAC3C;AACA;AACA,QAAA,MAAMI,WAAW,GAAGC,KAAK,CAACC,OAAO,CAACH,oBAAoB,CAAC,GACjDA,oBAAoB,GACpB,CAACA,oBAAoB,CAAC,CAAA;AAC5BC,QAAAA,WAAW,CAACG,IAAI,CAACP,gBAAgB,CAAC,CAAA;AAElCC,QAAAA,UAAU,CAACC,iBAAiB,CAACL,WAAW,CAAC,GAAGO,WAAW,CAAA;;AAEvD;AACAI,QAAAA,OAAO,CAACC,IAAI,CACP,CAAuBZ,qBAAAA,EAAAA,WAAY,yBAAwBO,WAAW,CAClEM,IAAI,EAAE,CACNC,IAAI,CAAC,IAAI,CAAE,EACpB,CAAC,CAAA;AACL,OAAA;AACJ,KAAC,MAAM;AACHV,MAAAA,UAAU,CAACC,iBAAiB,CAACL,WAAW,CAAC,GAAGG,gBAAgB,CAAA;AAChE,KAAA;AACJ,GAAC,MAAM;AACH;AACAQ,IAAAA,OAAO,CAACC,IAAI,CAAE,CAA8BT,4BAAAA,EAAAA,gBAAiB,GAAE,CAAC,CAAA;AACpE,GAAA;AACJ;;ACnDA;AAMA,MAAMY,OAAO,GAAG,2BAA2B,CAAA;AACpC,MAAMC,UAAU,GAAG,QAAiB;AAE3CjB,+BAA+B,CAACgB,OAAO,EAAEC,UAAU,CAAC;;;;;"}
+{"version":3,"file":"index.js","sources":["../src/utils/add-library-version-to-perseus-debug.ts","../src/version.ts","../src/error/errors.ts","../src/error/perseus-error.ts"],"sourcesContent":["/**\n * Adds the given perseus library version information to the __perseus_debug__\n * object and ensures that the object is attached to `globalThis` (`window` in\n * browser environments).\n *\n * This allows each library to provide runtime version information to assist in\n * debugging in production environments.\n */\nexport const addLibraryVersionToPerseusDebug = (\n    libraryName: string,\n    libraryVersion: string,\n) => {\n    // If the library version is the default value, then we don't want to\n    // prefix it with a \"v\" to indicate that it is a version number.\n    let prefix = \"v\";\n    if (libraryVersion === \"__lib_version__\") {\n        prefix = \"\";\n    }\n    const formattedVersion = `${prefix}${libraryVersion}`;\n\n    if (typeof globalThis !== \"undefined\") {\n        globalThis.__perseus_debug__ = globalThis.__perseus_debug__ ?? {};\n\n        const existingVersionEntry = globalThis.__perseus_debug__[libraryName];\n        if (existingVersionEntry) {\n            // If we already have an entry and it doesn't match the registered\n            // version, we morph the entry into an array and log a warning.\n            if (existingVersionEntry !== formattedVersion) {\n                // Existing entry might be an array already (oops, at least 2\n                // versions of the library already loaded!).\n                const allVersions = Array.isArray(existingVersionEntry)\n                    ? existingVersionEntry\n                    : [existingVersionEntry];\n                allVersions.push(formattedVersion);\n\n                globalThis.__perseus_debug__[libraryName] = allVersions;\n\n                // eslint-disable-next-line no-console\n                console.warn(\n                    `Multiple versions of ${libraryName} loaded on this page: ${allVersions\n                        .sort()\n                        .join(\", \")}`,\n                );\n            }\n        } else {\n            globalThis.__perseus_debug__[libraryName] = formattedVersion;\n        }\n    } else {\n        // eslint-disable-next-line no-console\n        console.warn(`globalThis not found found (${formattedVersion})`);\n    }\n};\n","// This file is processed by a Rollup plugin (replace) to inject the production\n// version number during the release build.\n// In dev, you'll never see the version number.\n\nimport {addLibraryVersionToPerseusDebug} from \"./utils/add-library-version-to-perseus-debug\";\n\nconst libName = \"@khanacademy/perseus-core\";\nexport const libVersion = \"__lib_version__\";\n\naddLibraryVersionToPerseusDebug(libName, libVersion);\n","/**\n * @typedef {Object} Errors utility for referencing the Perseus error taxonomy.\n */\nexport const Errors = Object.freeze({\n    /**\n     * @property {ErrorKind} Unknown The kind of error is not known.\n     */\n    Unknown: \"Unknown\",\n    /**\n     * @property {ErrorKind} Internal The error is internal to the executing code.\n     */\n    Internal: \"Internal\",\n    /**\n     * @property {ErrorKind} InvalidInput There was a problem with the provided\n     * input, such as the wrong format or a null value.\n     */\n    InvalidInput: \"InvalidInput\",\n    /**\n     * @property {ErrorKind} NotAllowed There was a problem due to the state of\n     * the system not matching the requested operation or input. For example,\n     * trying to create a username that is valid, but is already taken by\n     * another user. Use {@link InvalidInput} instead when the input isn't\n     * valid regardless of the state of the system. Use {@link NotFound} when\n     * the failure is due to not being able to find a resource.\n     */\n    NotAllowed: \"NotAllowed\",\n    /**\n     * @property {ErrorKind} TransientService There was a problem when making a\n     * request to a service.\n     */\n    TransientService: \"TransientService\",\n    /**\n     * @property {ErrorKind} Service There was a non-transient problem when\n     * making a request to service.\n     */\n    Service: \"Service\",\n});\n\n/**\n * @type {ErrorKind} The kind of error being reported\n */\nexport type ErrorKind = (typeof Errors)[keyof typeof Errors];\n","import type {ErrorKind} from \"./errors\";\nimport type {Metadata} from \"@khanacademy/wonder-stuff-core\";\n\ntype Options = {\n    metadata?: Metadata | null | undefined;\n};\n\nexport class PerseusError extends Error {\n    kind: ErrorKind;\n    metadata: Metadata | null | undefined;\n\n    constructor(message: string, kind: ErrorKind, options?: Options) {\n        super(message);\n        this.kind = kind;\n        this.metadata = options?.metadata;\n    }\n}\n"],"names":["addLibraryVersionToPerseusDebug","libraryName","libraryVersion","prefix","formattedVersion","globalThis","__perseus_debug__","existingVersionEntry","allVersions","Array","isArray","push","console","warn","sort","join","libName","libVersion","Errors","Object","freeze","Unknown","Internal","InvalidInput","NotAllowed","TransientService","Service","PerseusError","Error","kind","metadata","constructor","message","options"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;MACaA,+BAA+B,GAAGA,CAC3CC,WAAmB,EACnBC,cAAsB,KACrB;AACD;AACA;EACA,IAAIC,MAAM,GAAG,GAAG,CAAA;EAChB,IAAID,cAAc,KAAK,iBAAiB,EAAE;AACtCC,IAAAA,MAAM,GAAG,EAAE,CAAA;AACf,GAAA;AACA,EAAA,MAAMC,gBAAgB,GAAI,CAAA,EAAED,MAAO,CAAA,EAAED,cAAe,CAAC,CAAA,CAAA;AAErD,EAAA,IAAI,OAAOG,UAAU,KAAK,WAAW,EAAE;IACnCA,UAAU,CAACC,iBAAiB,GAAGD,UAAU,CAACC,iBAAiB,IAAI,EAAE,CAAA;AAEjE,IAAA,MAAMC,oBAAoB,GAAGF,UAAU,CAACC,iBAAiB,CAACL,WAAW,CAAC,CAAA;AACtE,IAAA,IAAIM,oBAAoB,EAAE;AACtB;AACA;MACA,IAAIA,oBAAoB,KAAKH,gBAAgB,EAAE;AAC3C;AACA;AACA,QAAA,MAAMI,WAAW,GAAGC,KAAK,CAACC,OAAO,CAACH,oBAAoB,CAAC,GACjDA,oBAAoB,GACpB,CAACA,oBAAoB,CAAC,CAAA;AAC5BC,QAAAA,WAAW,CAACG,IAAI,CAACP,gBAAgB,CAAC,CAAA;AAElCC,QAAAA,UAAU,CAACC,iBAAiB,CAACL,WAAW,CAAC,GAAGO,WAAW,CAAA;;AAEvD;AACAI,QAAAA,OAAO,CAACC,IAAI,CACP,CAAuBZ,qBAAAA,EAAAA,WAAY,yBAAwBO,WAAW,CAClEM,IAAI,EAAE,CACNC,IAAI,CAAC,IAAI,CAAE,EACpB,CAAC,CAAA;AACL,OAAA;AACJ,KAAC,MAAM;AACHV,MAAAA,UAAU,CAACC,iBAAiB,CAACL,WAAW,CAAC,GAAGG,gBAAgB,CAAA;AAChE,KAAA;AACJ,GAAC,MAAM;AACH;AACAQ,IAAAA,OAAO,CAACC,IAAI,CAAE,CAA8BT,4BAAAA,EAAAA,gBAAiB,GAAE,CAAC,CAAA;AACpE,GAAA;AACJ;;ACnDA;AAMA,MAAMY,OAAO,GAAG,2BAA2B,CAAA;AACpC,MAAMC,UAAU,GAAG,QAAiB;AAE3CjB,+BAA+B,CAACgB,OAAO,EAAEC,UAAU,CAAC;;ACTpD;AACA;AACA;MACaC,MAAM,GAAGC,MAAM,CAACC,MAAM,CAAC;AAChC;AACJ;AACA;AACIC,EAAAA,OAAO,EAAE,SAAS;AAClB;AACJ;AACA;AACIC,EAAAA,QAAQ,EAAE,UAAU;AACpB;AACJ;AACA;AACA;AACIC,EAAAA,YAAY,EAAE,cAAc;AAC5B;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACIC,EAAAA,UAAU,EAAE,YAAY;AACxB;AACJ;AACA;AACA;AACIC,EAAAA,gBAAgB,EAAE,kBAAkB;AACpC;AACJ;AACA;AACA;AACIC,EAAAA,OAAO,EAAE,SAAA;AACb,CAAC,EAAC;;AAEF;AACA;AACA;;ACjCO,MAAMC,YAAY,SAASC,KAAK,CAAC;EACpCC,IAAI,CAAA;EACJC,QAAQ,CAAA;AAERC,EAAAA,WAAWA,CAACC,OAAe,EAAEH,IAAe,EAAEI,OAAiB,EAAE;IAC7D,KAAK,CAACD,OAAO,CAAC,CAAA;IACd,IAAI,CAACH,IAAI,GAAGA,IAAI,CAAA;AAChB,IAAA,IAAI,CAACC,QAAQ,GAAGG,OAAO,EAAEH,QAAQ,CAAA;AACrC,GAAA;AACJ;;;;;;;"}

package/package.json

@@ -3,7 +3,7 @@
     "description": "Shared Perseus infrastructure",
     "author": "Khan Academy",
     "license": "MIT",
-    "version": "1.4.2",
+    "version": "1.5.0",
     "publishConfig": {
         "access": "public"
     },