@solana/options 2.0.0-experimental.21e994f

package/dist/index.native.js

@@ -0,0 +1,99 @@
+import { fixBytes, mergeBytes, combineCodec, assertFixedSizeCodec } from '@solana/codecs-core';
+import { getU8Encoder, getU8Decoder } from '@solana/codecs-numbers';
+
+// src/option.ts
+var some = (value) => ({ __option: "Some", value });
+var none = () => ({ __option: "None" });
+var isOption = (input) => !!(input && typeof input === "object" && "__option" in input && (input.__option === "Some" && "value" in input || input.__option === "None"));
+var isSome = (option) => option.__option === "Some";
+var isNone = (option) => option.__option === "None";
+
+// src/unwrap-option.ts
+function unwrapOption(option, fallback) {
+  if (isSome(option))
+    return option.value;
+  return fallback ? fallback() : null;
+}
+var wrapNullable = (nullable) => nullable !== null ? some(nullable) : none();
+
+// src/option-codec.ts
+function sumCodecSizes(sizes) {
+  return sizes.reduce((all, size) => all === null || size === null ? null : all + size, 0);
+}
+function optionCodecHelper(item, prefix, fixed, description) {
+  let descriptionSuffix = `; ${prefix.description}`;
+  let fixedSize = item.fixedSize === 0 ? prefix.fixedSize : null;
+  if (fixed) {
+    assertFixedSizeCodec(item, "Fixed options can only be used with fixed-size codecs.");
+    assertFixedSizeCodec(prefix, "Fixed options can only be used with fixed-size prefix.");
+    descriptionSuffix += "; fixed";
+    fixedSize = prefix.fixedSize + item.fixedSize;
+  }
+  return {
+    description: description ?? `option(${item.description + descriptionSuffix})`,
+    fixedSize,
+    maxSize: sumCodecSizes([prefix.maxSize, item.maxSize])
+  };
+}
+function getOptionEncoder(item, options = {}) {
+  const prefix = options.prefix ?? getU8Encoder();
+  const fixed = options.fixed ?? false;
+  return {
+    ...optionCodecHelper(item, prefix, fixed, options.description),
+    encode: (optionOrNullable) => {
+      const option = isOption(optionOrNullable) ? optionOrNullable : wrapNullable(optionOrNullable);
+      const prefixByte = prefix.encode(Number(isSome(option)));
+      let itemBytes = isSome(option) ? item.encode(option.value) : new Uint8Array();
+      itemBytes = fixed ? fixBytes(itemBytes, item.fixedSize) : itemBytes;
+      return mergeBytes([prefixByte, itemBytes]);
+    }
+  };
+}
+function getOptionDecoder(item, options = {}) {
+  const prefix = options.prefix ?? getU8Decoder();
+  const fixed = options.fixed ?? false;
+  return {
+    ...optionCodecHelper(item, prefix, fixed, options.description),
+    decode: (bytes, offset = 0) => {
+      if (bytes.length - offset <= 0) {
+        return [none(), offset];
+      }
+      const fixedOffset = offset + (prefix.fixedSize ?? 0) + (item.fixedSize ?? 0);
+      const [isSome2, prefixOffset] = prefix.decode(bytes, offset);
+      offset = prefixOffset;
+      if (isSome2 === 0) {
+        return [none(), fixed ? fixedOffset : offset];
+      }
+      const [value, newOffset] = item.decode(bytes, offset);
+      offset = newOffset;
+      return [some(value), fixed ? fixedOffset : offset];
+    }
+  };
+}
+function getOptionCodec(item, options = {}) {
+  return combineCodec(getOptionEncoder(item, options), getOptionDecoder(item, options));
+}
+
+// src/unwrap-option-recursively.ts
+function unwrapOptionRecursively(input, fallback) {
+  if (!input || ArrayBuffer.isView(input)) {
+    return input;
+  }
+  const next = (x) => fallback ? unwrapOptionRecursively(x, fallback) : unwrapOptionRecursively(x);
+  if (isOption(input)) {
+    if (isSome(input))
+      return next(input.value);
+    return fallback ? fallback() : null;
+  }
+  if (Array.isArray(input)) {
+    return input.map(next);
+  }
+  if (typeof input === "object") {
+    return Object.fromEntries(Object.entries(input).map(([k, v]) => [k, next(v)]));
+  }
+  return input;
+}
+
+export { getOptionCodec, getOptionDecoder, getOptionEncoder, isNone, isOption, isSome, none, some, unwrapOption, unwrapOptionRecursively, wrapNullable };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.native.js.map

package/dist/index.native.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/option.ts","../src/option-codec.ts","../src/unwrap-option.ts","../src/unwrap-option-recursively.ts"],"names":["isSome"],"mappings":"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","sourcesContent":["/**\n * An implementation of the Rust Option type in JavaScript.\n * It can be one of the following:\n * - <code>{@link Some}<T></code>: Meaning there is a value of type T.\n * - <code>{@link None}</code>: Meaning there is no value.\n */\nexport type Option<T> = Some<T> | None;\n\n/**\n * Defines a looser type that can be used when serializing an {@link Option}.\n * This allows us to pass null or the Option value directly whilst still\n * supporting the Option type for use-cases that need more type safety.\n */\nexport type OptionOrNullable<T> = Option<T> | T | null;\n\n/**\n * Represents an option of type `T` that has a value.\n *\n * @see {@link Option}\n */\nexport type Some<T> = Readonly<{ __option: 'Some'; value: T }>;\n\n/**\n * Represents an option of type `T` that has no value.\n *\n * @see {@link Option}\n */\nexport type None = Readonly<{ __option: 'None' }>;\n\n/**\n * Creates a new {@link Option} of type `T` that has a value.\n *\n * @see {@link Option}\n */\nexport const some = <T>(value: T): Option<T> => ({ __option: 'Some', value });\n\n/**\n * Creates a new {@link Option} of type `T` that has no value.\n *\n * @see {@link Option}\n */\nexport const none = <T>(): Option<T> => ({ __option: 'None' });\n\n/**\n * Whether the given data is an {@link Option}.\n */\nexport const isOption = <T = unknown>(input: unknown): input is Option<T> =>\n    !!(\n        input &&\n        typeof input === 'object' &&\n        '__option' in input &&\n        ((input.__option === 'Some' && 'value' in input) || input.__option === 'None')\n    );\n\n/**\n * Whether the given {@link Option} is a {@link Some}.\n */\nexport const isSome = <T>(option: Option<T>): option is Some<T> => option.__option === 'Some';\n\n/**\n * Whether the given {@link Option} is a {@link None}.\n */\nexport const isNone = <T>(option: Option<T>): option is None => option.__option === 'None';\n","import {\n    assertFixedSizeCodec,\n    BaseCodecOptions,\n    Codec,\n    CodecData,\n    combineCodec,\n    Decoder,\n    Encoder,\n    fixBytes,\n    mergeBytes,\n} from '@solana/codecs-core';\nimport { getU8Decoder, getU8Encoder, NumberCodec, NumberDecoder, NumberEncoder } from '@solana/codecs-numbers';\n\nimport { isOption, isSome, none, Option, OptionOrNullable, some } from './option';\nimport { wrapNullable } from './unwrap-option';\n\n/** Defines the options for option codecs. */\nexport type OptionCodecOptions<TPrefix extends NumberCodec | NumberEncoder | NumberDecoder> = BaseCodecOptions & {\n    /**\n     * The codec to use for the boolean prefix.\n     * @defaultValue u8 prefix.\n     */\n    prefix?: TPrefix;\n\n    /**\n     * Whether the item codec should be of fixed size.\n     *\n     * When this is true, a `None` value will skip the bytes that would\n     * have been used for the item. Note that this will only work if the\n     * item codec is of fixed size.\n     * @defaultValue `false`\n     */\n    fixed?: boolean;\n};\n\nfunction sumCodecSizes(sizes: (number | null)[]): number | null {\n    return sizes.reduce((all, size) => (all === null || size === null ? null : all + size), 0 as number | null);\n}\n\nfunction optionCodecHelper(item: CodecData, prefix: CodecData, fixed: boolean, description?: string): CodecData {\n    let descriptionSuffix = `; ${prefix.description}`;\n    let fixedSize = item.fixedSize === 0 ? prefix.fixedSize : null;\n    if (fixed) {\n        assertFixedSizeCodec(item, 'Fixed options can only be used with fixed-size codecs.');\n        assertFixedSizeCodec(prefix, 'Fixed options can only be used with fixed-size prefix.');\n        descriptionSuffix += '; fixed';\n        fixedSize = prefix.fixedSize + item.fixedSize;\n    }\n\n    return {\n        description: description ?? `option(${item.description + descriptionSuffix})`,\n        fixedSize,\n        maxSize: sumCodecSizes([prefix.maxSize, item.maxSize]),\n    };\n}\n\n/**\n * Creates a encoder for an optional value using `null` as the `None` value.\n *\n * @param item - The encoder to use for the value that may be present.\n * @param options - A set of options for the encoder.\n */\nexport function getOptionEncoder<T>(\n    item: Encoder<T>,\n    options: OptionCodecOptions<NumberEncoder> = {}\n): Encoder<OptionOrNullable<T>> {\n    const prefix = options.prefix ?? getU8Encoder();\n    const fixed = options.fixed ?? false;\n    return {\n        ...optionCodecHelper(item, prefix, fixed, options.description),\n        encode: (optionOrNullable: OptionOrNullable<T>) => {\n            const option = isOption<T>(optionOrNullable) ? optionOrNullable : wrapNullable(optionOrNullable);\n            const prefixByte = prefix.encode(Number(isSome(option)));\n            let itemBytes = isSome(option) ? item.encode(option.value) : new Uint8Array();\n            itemBytes = fixed ? fixBytes(itemBytes, item.fixedSize as number) : itemBytes;\n            return mergeBytes([prefixByte, itemBytes]);\n        },\n    };\n}\n\n/**\n * Creates a decoder for an optional value using `null` as the `None` value.\n *\n * @param item - The decoder to use for the value that may be present.\n * @param options - A set of options for the decoder.\n */\nexport function getOptionDecoder<T>(\n    item: Decoder<T>,\n    options: OptionCodecOptions<NumberDecoder> = {}\n): Decoder<Option<T>> {\n    const prefix = options.prefix ?? getU8Decoder();\n    const fixed = options.fixed ?? false;\n    return {\n        ...optionCodecHelper(item, prefix, fixed, options.description),\n        decode: (bytes: Uint8Array, offset = 0) => {\n            if (bytes.length - offset <= 0) {\n                return [none(), offset];\n            }\n            const fixedOffset = offset + (prefix.fixedSize ?? 0) + (item.fixedSize ?? 0);\n            const [isSome, prefixOffset] = prefix.decode(bytes, offset);\n            offset = prefixOffset;\n            if (isSome === 0) {\n                return [none(), fixed ? fixedOffset : offset];\n            }\n            const [value, newOffset] = item.decode(bytes, offset);\n            offset = newOffset;\n            return [some(value), fixed ? fixedOffset : offset];\n        },\n    };\n}\n\n/**\n * Creates a codec for an optional value using `null` as the `None` value.\n *\n * @param item - The codec to use for the value that may be present.\n * @param options - A set of options for the codec.\n */\nexport function getOptionCodec<T, U extends T = T>(\n    item: Codec<T, U>,\n    options: OptionCodecOptions<NumberCodec> = {}\n): Codec<OptionOrNullable<T>, Option<U>> {\n    return combineCodec(getOptionEncoder<T>(item, options), getOptionDecoder<U>(item, options));\n}\n","import { isSome, none, Option, some } from './option';\n\n/**\n * Unwraps the value of an {@link Option} of type `T`\n * or returns a fallback value that defaults to `null`.\n */\nexport function unwrapOption<T>(option: Option<T>): T | null;\nexport function unwrapOption<T, U>(option: Option<T>, fallback: () => U): T | U;\nexport function unwrapOption<T, U = null>(option: Option<T>, fallback?: () => U): T | U {\n    if (isSome(option)) return option.value;\n    return fallback ? fallback() : (null as U);\n}\n\n/**\n * Wraps a nullable value into an {@link Option}.\n */\nexport const wrapNullable = <T>(nullable: T | null): Option<T> => (nullable !== null ? some(nullable) : none<T>());\n","import { isOption, isSome, None, Some } from './option';\n\n/**\n * Lists all types that should not be recursively unwrapped.\n *\n * @see {@link UnwrappedOption}\n */\ntype UnUnwrappables =\n    | string\n    | number\n    | boolean\n    | symbol\n    | bigint\n    | undefined\n    | null\n    | Uint8Array\n    | Int8Array\n    | Uint16Array\n    | Int16Array\n    | Uint32Array\n    | Int32Array\n    | Date;\n\n/**\n * A type that defines the recursive unwrapping of a type `T`\n * such that all nested {@link Option} types are unwrapped.\n *\n * For each nested {@link Option} type, if the option is a {@link Some},\n * it returns the type of its value, otherwise, it returns the provided\n * fallback type `U` which defaults to `null`.\n */\nexport type UnwrappedOption<T, U = null> = T extends Some<infer TValue>\n    ? UnwrappedOption<TValue, U>\n    : T extends None\n    ? U\n    : T extends UnUnwrappables\n    ? T\n    : T extends object\n    ? { [key in keyof T]: UnwrappedOption<T[key], U> }\n    : T extends Array<infer TItem>\n    ? Array<UnwrappedOption<TItem, U>>\n    : T;\n\n/**\n * Recursively go through a type `T` such that all\n * nested {@link Option} types are unwrapped.\n *\n * For each nested {@link Option} type, if the option is a {@link Some},\n * it returns its value, otherwise, it returns the provided fallback value\n * which defaults to `null`.\n */\nexport function unwrapOptionRecursively<T>(input: T): UnwrappedOption<T>;\nexport function unwrapOptionRecursively<T, U>(input: T, fallback: () => U): UnwrappedOption<T, U>;\nexport function unwrapOptionRecursively<T, U = null>(input: T, fallback?: () => U): UnwrappedOption<T, U> {\n    // Types to bypass.\n    if (!input || ArrayBuffer.isView(input)) {\n        return input as UnwrappedOption<T, U>;\n    }\n\n    const next = <X>(x: X) =>\n        (fallback ? unwrapOptionRecursively(x, fallback) : unwrapOptionRecursively(x)) as UnwrappedOption<X, U>;\n\n    // Handle Option.\n    if (isOption(input)) {\n        if (isSome(input)) return next(input.value) as UnwrappedOption<T, U>;\n        return (fallback ? fallback() : null) as UnwrappedOption<T, U>;\n    }\n\n    // Walk.\n    if (Array.isArray(input)) {\n        return input.map(next) as UnwrappedOption<T, U>;\n    }\n    if (typeof input === 'object') {\n        return Object.fromEntries(Object.entries(input).map(([k, v]) => [k, next(v)])) as UnwrappedOption<T, U>;\n    }\n    return input as UnwrappedOption<T, U>;\n}\n"]}

package/dist/index.node.cjs

@@ -0,0 +1,111 @@
+'use strict';
+
+var codecsCore = require('@solana/codecs-core');
+var codecsNumbers = require('@solana/codecs-numbers');
+
+// src/option.ts
+var some = (value) => ({ __option: "Some", value });
+var none = () => ({ __option: "None" });
+var isOption = (input) => !!(input && typeof input === "object" && "__option" in input && (input.__option === "Some" && "value" in input || input.__option === "None"));
+var isSome = (option) => option.__option === "Some";
+var isNone = (option) => option.__option === "None";
+
+// src/unwrap-option.ts
+function unwrapOption(option, fallback) {
+  if (isSome(option))
+    return option.value;
+  return fallback ? fallback() : null;
+}
+var wrapNullable = (nullable) => nullable !== null ? some(nullable) : none();
+
+// src/option-codec.ts
+function sumCodecSizes(sizes) {
+  return sizes.reduce((all, size) => all === null || size === null ? null : all + size, 0);
+}
+function optionCodecHelper(item, prefix, fixed, description) {
+  let descriptionSuffix = `; ${prefix.description}`;
+  let fixedSize = item.fixedSize === 0 ? prefix.fixedSize : null;
+  if (fixed) {
+    codecsCore.assertFixedSizeCodec(item, "Fixed options can only be used with fixed-size codecs.");
+    codecsCore.assertFixedSizeCodec(prefix, "Fixed options can only be used with fixed-size prefix.");
+    descriptionSuffix += "; fixed";
+    fixedSize = prefix.fixedSize + item.fixedSize;
+  }
+  return {
+    description: description ?? `option(${item.description + descriptionSuffix})`,
+    fixedSize,
+    maxSize: sumCodecSizes([prefix.maxSize, item.maxSize])
+  };
+}
+function getOptionEncoder(item, options = {}) {
+  const prefix = options.prefix ?? codecsNumbers.getU8Encoder();
+  const fixed = options.fixed ?? false;
+  return {
+    ...optionCodecHelper(item, prefix, fixed, options.description),
+    encode: (optionOrNullable) => {
+      const option = isOption(optionOrNullable) ? optionOrNullable : wrapNullable(optionOrNullable);
+      const prefixByte = prefix.encode(Number(isSome(option)));
+      let itemBytes = isSome(option) ? item.encode(option.value) : new Uint8Array();
+      itemBytes = fixed ? codecsCore.fixBytes(itemBytes, item.fixedSize) : itemBytes;
+      return codecsCore.mergeBytes([prefixByte, itemBytes]);
+    }
+  };
+}
+function getOptionDecoder(item, options = {}) {
+  const prefix = options.prefix ?? codecsNumbers.getU8Decoder();
+  const fixed = options.fixed ?? false;
+  return {
+    ...optionCodecHelper(item, prefix, fixed, options.description),
+    decode: (bytes, offset = 0) => {
+      if (bytes.length - offset <= 0) {
+        return [none(), offset];
+      }
+      const fixedOffset = offset + (prefix.fixedSize ?? 0) + (item.fixedSize ?? 0);
+      const [isSome2, prefixOffset] = prefix.decode(bytes, offset);
+      offset = prefixOffset;
+      if (isSome2 === 0) {
+        return [none(), fixed ? fixedOffset : offset];
+      }
+      const [value, newOffset] = item.decode(bytes, offset);
+      offset = newOffset;
+      return [some(value), fixed ? fixedOffset : offset];
+    }
+  };
+}
+function getOptionCodec(item, options = {}) {
+  return codecsCore.combineCodec(getOptionEncoder(item, options), getOptionDecoder(item, options));
+}
+
+// src/unwrap-option-recursively.ts
+function unwrapOptionRecursively(input, fallback) {
+  if (!input || ArrayBuffer.isView(input)) {
+    return input;
+  }
+  const next = (x) => fallback ? unwrapOptionRecursively(x, fallback) : unwrapOptionRecursively(x);
+  if (isOption(input)) {
+    if (isSome(input))
+      return next(input.value);
+    return fallback ? fallback() : null;
+  }
+  if (Array.isArray(input)) {
+    return input.map(next);
+  }
+  if (typeof input === "object") {
+    return Object.fromEntries(Object.entries(input).map(([k, v]) => [k, next(v)]));
+  }
+  return input;
+}
+
+exports.getOptionCodec = getOptionCodec;
+exports.getOptionDecoder = getOptionDecoder;
+exports.getOptionEncoder = getOptionEncoder;
+exports.isNone = isNone;
+exports.isOption = isOption;
+exports.isSome = isSome;
+exports.none = none;
+exports.some = some;
+exports.unwrapOption = unwrapOption;
+exports.unwrapOptionRecursively = unwrapOptionRecursively;
+exports.wrapNullable = wrapNullable;
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.node.cjs.map

package/dist/index.node.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/option.ts","../src/option-codec.ts","../src/unwrap-option.ts","../src/unwrap-option-recursively.ts"],"names":["isSome"],"mappings":"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","sourcesContent":["/**\n * An implementation of the Rust Option type in JavaScript.\n * It can be one of the following:\n * - <code>{@link Some}<T></code>: Meaning there is a value of type T.\n * - <code>{@link None}</code>: Meaning there is no value.\n */\nexport type Option<T> = Some<T> | None;\n\n/**\n * Defines a looser type that can be used when serializing an {@link Option}.\n * This allows us to pass null or the Option value directly whilst still\n * supporting the Option type for use-cases that need more type safety.\n */\nexport type OptionOrNullable<T> = Option<T> | T | null;\n\n/**\n * Represents an option of type `T` that has a value.\n *\n * @see {@link Option}\n */\nexport type Some<T> = Readonly<{ __option: 'Some'; value: T }>;\n\n/**\n * Represents an option of type `T` that has no value.\n *\n * @see {@link Option}\n */\nexport type None = Readonly<{ __option: 'None' }>;\n\n/**\n * Creates a new {@link Option} of type `T` that has a value.\n *\n * @see {@link Option}\n */\nexport const some = <T>(value: T): Option<T> => ({ __option: 'Some', value });\n\n/**\n * Creates a new {@link Option} of type `T` that has no value.\n *\n * @see {@link Option}\n */\nexport const none = <T>(): Option<T> => ({ __option: 'None' });\n\n/**\n * Whether the given data is an {@link Option}.\n */\nexport const isOption = <T = unknown>(input: unknown): input is Option<T> =>\n    !!(\n        input &&\n        typeof input === 'object' &&\n        '__option' in input &&\n        ((input.__option === 'Some' && 'value' in input) || input.__option === 'None')\n    );\n\n/**\n * Whether the given {@link Option} is a {@link Some}.\n */\nexport const isSome = <T>(option: Option<T>): option is Some<T> => option.__option === 'Some';\n\n/**\n * Whether the given {@link Option} is a {@link None}.\n */\nexport const isNone = <T>(option: Option<T>): option is None => option.__option === 'None';\n","import {\n    assertFixedSizeCodec,\n    BaseCodecOptions,\n    Codec,\n    CodecData,\n    combineCodec,\n    Decoder,\n    Encoder,\n    fixBytes,\n    mergeBytes,\n} from '@solana/codecs-core';\nimport { getU8Decoder, getU8Encoder, NumberCodec, NumberDecoder, NumberEncoder } from '@solana/codecs-numbers';\n\nimport { isOption, isSome, none, Option, OptionOrNullable, some } from './option';\nimport { wrapNullable } from './unwrap-option';\n\n/** Defines the options for option codecs. */\nexport type OptionCodecOptions<TPrefix extends NumberCodec | NumberEncoder | NumberDecoder> = BaseCodecOptions & {\n    /**\n     * The codec to use for the boolean prefix.\n     * @defaultValue u8 prefix.\n     */\n    prefix?: TPrefix;\n\n    /**\n     * Whether the item codec should be of fixed size.\n     *\n     * When this is true, a `None` value will skip the bytes that would\n     * have been used for the item. Note that this will only work if the\n     * item codec is of fixed size.\n     * @defaultValue `false`\n     */\n    fixed?: boolean;\n};\n\nfunction sumCodecSizes(sizes: (number | null)[]): number | null {\n    return sizes.reduce((all, size) => (all === null || size === null ? null : all + size), 0 as number | null);\n}\n\nfunction optionCodecHelper(item: CodecData, prefix: CodecData, fixed: boolean, description?: string): CodecData {\n    let descriptionSuffix = `; ${prefix.description}`;\n    let fixedSize = item.fixedSize === 0 ? prefix.fixedSize : null;\n    if (fixed) {\n        assertFixedSizeCodec(item, 'Fixed options can only be used with fixed-size codecs.');\n        assertFixedSizeCodec(prefix, 'Fixed options can only be used with fixed-size prefix.');\n        descriptionSuffix += '; fixed';\n        fixedSize = prefix.fixedSize + item.fixedSize;\n    }\n\n    return {\n        description: description ?? `option(${item.description + descriptionSuffix})`,\n        fixedSize,\n        maxSize: sumCodecSizes([prefix.maxSize, item.maxSize]),\n    };\n}\n\n/**\n * Creates a encoder for an optional value using `null` as the `None` value.\n *\n * @param item - The encoder to use for the value that may be present.\n * @param options - A set of options for the encoder.\n */\nexport function getOptionEncoder<T>(\n    item: Encoder<T>,\n    options: OptionCodecOptions<NumberEncoder> = {}\n): Encoder<OptionOrNullable<T>> {\n    const prefix = options.prefix ?? getU8Encoder();\n    const fixed = options.fixed ?? false;\n    return {\n        ...optionCodecHelper(item, prefix, fixed, options.description),\n        encode: (optionOrNullable: OptionOrNullable<T>) => {\n            const option = isOption<T>(optionOrNullable) ? optionOrNullable : wrapNullable(optionOrNullable);\n            const prefixByte = prefix.encode(Number(isSome(option)));\n            let itemBytes = isSome(option) ? item.encode(option.value) : new Uint8Array();\n            itemBytes = fixed ? fixBytes(itemBytes, item.fixedSize as number) : itemBytes;\n            return mergeBytes([prefixByte, itemBytes]);\n        },\n    };\n}\n\n/**\n * Creates a decoder for an optional value using `null` as the `None` value.\n *\n * @param item - The decoder to use for the value that may be present.\n * @param options - A set of options for the decoder.\n */\nexport function getOptionDecoder<T>(\n    item: Decoder<T>,\n    options: OptionCodecOptions<NumberDecoder> = {}\n): Decoder<Option<T>> {\n    const prefix = options.prefix ?? getU8Decoder();\n    const fixed = options.fixed ?? false;\n    return {\n        ...optionCodecHelper(item, prefix, fixed, options.description),\n        decode: (bytes: Uint8Array, offset = 0) => {\n            if (bytes.length - offset <= 0) {\n                return [none(), offset];\n            }\n            const fixedOffset = offset + (prefix.fixedSize ?? 0) + (item.fixedSize ?? 0);\n            const [isSome, prefixOffset] = prefix.decode(bytes, offset);\n            offset = prefixOffset;\n            if (isSome === 0) {\n                return [none(), fixed ? fixedOffset : offset];\n            }\n            const [value, newOffset] = item.decode(bytes, offset);\n            offset = newOffset;\n            return [some(value), fixed ? fixedOffset : offset];\n        },\n    };\n}\n\n/**\n * Creates a codec for an optional value using `null` as the `None` value.\n *\n * @param item - The codec to use for the value that may be present.\n * @param options - A set of options for the codec.\n */\nexport function getOptionCodec<T, U extends T = T>(\n    item: Codec<T, U>,\n    options: OptionCodecOptions<NumberCodec> = {}\n): Codec<OptionOrNullable<T>, Option<U>> {\n    return combineCodec(getOptionEncoder<T>(item, options), getOptionDecoder<U>(item, options));\n}\n","import { isSome, none, Option, some } from './option';\n\n/**\n * Unwraps the value of an {@link Option} of type `T`\n * or returns a fallback value that defaults to `null`.\n */\nexport function unwrapOption<T>(option: Option<T>): T | null;\nexport function unwrapOption<T, U>(option: Option<T>, fallback: () => U): T | U;\nexport function unwrapOption<T, U = null>(option: Option<T>, fallback?: () => U): T | U {\n    if (isSome(option)) return option.value;\n    return fallback ? fallback() : (null as U);\n}\n\n/**\n * Wraps a nullable value into an {@link Option}.\n */\nexport const wrapNullable = <T>(nullable: T | null): Option<T> => (nullable !== null ? some(nullable) : none<T>());\n","import { isOption, isSome, None, Some } from './option';\n\n/**\n * Lists all types that should not be recursively unwrapped.\n *\n * @see {@link UnwrappedOption}\n */\ntype UnUnwrappables =\n    | string\n    | number\n    | boolean\n    | symbol\n    | bigint\n    | undefined\n    | null\n    | Uint8Array\n    | Int8Array\n    | Uint16Array\n    | Int16Array\n    | Uint32Array\n    | Int32Array\n    | Date;\n\n/**\n * A type that defines the recursive unwrapping of a type `T`\n * such that all nested {@link Option} types are unwrapped.\n *\n * For each nested {@link Option} type, if the option is a {@link Some},\n * it returns the type of its value, otherwise, it returns the provided\n * fallback type `U` which defaults to `null`.\n */\nexport type UnwrappedOption<T, U = null> = T extends Some<infer TValue>\n    ? UnwrappedOption<TValue, U>\n    : T extends None\n    ? U\n    : T extends UnUnwrappables\n    ? T\n    : T extends object\n    ? { [key in keyof T]: UnwrappedOption<T[key], U> }\n    : T extends Array<infer TItem>\n    ? Array<UnwrappedOption<TItem, U>>\n    : T;\n\n/**\n * Recursively go through a type `T` such that all\n * nested {@link Option} types are unwrapped.\n *\n * For each nested {@link Option} type, if the option is a {@link Some},\n * it returns its value, otherwise, it returns the provided fallback value\n * which defaults to `null`.\n */\nexport function unwrapOptionRecursively<T>(input: T): UnwrappedOption<T>;\nexport function unwrapOptionRecursively<T, U>(input: T, fallback: () => U): UnwrappedOption<T, U>;\nexport function unwrapOptionRecursively<T, U = null>(input: T, fallback?: () => U): UnwrappedOption<T, U> {\n    // Types to bypass.\n    if (!input || ArrayBuffer.isView(input)) {\n        return input as UnwrappedOption<T, U>;\n    }\n\n    const next = <X>(x: X) =>\n        (fallback ? unwrapOptionRecursively(x, fallback) : unwrapOptionRecursively(x)) as UnwrappedOption<X, U>;\n\n    // Handle Option.\n    if (isOption(input)) {\n        if (isSome(input)) return next(input.value) as UnwrappedOption<T, U>;\n        return (fallback ? fallback() : null) as UnwrappedOption<T, U>;\n    }\n\n    // Walk.\n    if (Array.isArray(input)) {\n        return input.map(next) as UnwrappedOption<T, U>;\n    }\n    if (typeof input === 'object') {\n        return Object.fromEntries(Object.entries(input).map(([k, v]) => [k, next(v)])) as UnwrappedOption<T, U>;\n    }\n    return input as UnwrappedOption<T, U>;\n}\n"]}

package/dist/index.node.js

@@ -0,0 +1,99 @@
+import { fixBytes, mergeBytes, combineCodec, assertFixedSizeCodec } from '@solana/codecs-core';
+import { getU8Encoder, getU8Decoder } from '@solana/codecs-numbers';
+
+// src/option.ts
+var some = (value) => ({ __option: "Some", value });
+var none = () => ({ __option: "None" });
+var isOption = (input) => !!(input && typeof input === "object" && "__option" in input && (input.__option === "Some" && "value" in input || input.__option === "None"));
+var isSome = (option) => option.__option === "Some";
+var isNone = (option) => option.__option === "None";
+
+// src/unwrap-option.ts
+function unwrapOption(option, fallback) {
+  if (isSome(option))
+    return option.value;
+  return fallback ? fallback() : null;
+}
+var wrapNullable = (nullable) => nullable !== null ? some(nullable) : none();
+
+// src/option-codec.ts
+function sumCodecSizes(sizes) {
+  return sizes.reduce((all, size) => all === null || size === null ? null : all + size, 0);
+}
+function optionCodecHelper(item, prefix, fixed, description) {
+  let descriptionSuffix = `; ${prefix.description}`;
+  let fixedSize = item.fixedSize === 0 ? prefix.fixedSize : null;
+  if (fixed) {
+    assertFixedSizeCodec(item, "Fixed options can only be used with fixed-size codecs.");
+    assertFixedSizeCodec(prefix, "Fixed options can only be used with fixed-size prefix.");
+    descriptionSuffix += "; fixed";
+    fixedSize = prefix.fixedSize + item.fixedSize;
+  }
+  return {
+    description: description ?? `option(${item.description + descriptionSuffix})`,
+    fixedSize,
+    maxSize: sumCodecSizes([prefix.maxSize, item.maxSize])
+  };
+}
+function getOptionEncoder(item, options = {}) {
+  const prefix = options.prefix ?? getU8Encoder();
+  const fixed = options.fixed ?? false;
+  return {
+    ...optionCodecHelper(item, prefix, fixed, options.description),
+    encode: (optionOrNullable) => {
+      const option = isOption(optionOrNullable) ? optionOrNullable : wrapNullable(optionOrNullable);
+      const prefixByte = prefix.encode(Number(isSome(option)));
+      let itemBytes = isSome(option) ? item.encode(option.value) : new Uint8Array();
+      itemBytes = fixed ? fixBytes(itemBytes, item.fixedSize) : itemBytes;
+      return mergeBytes([prefixByte, itemBytes]);
+    }
+  };
+}
+function getOptionDecoder(item, options = {}) {
+  const prefix = options.prefix ?? getU8Decoder();
+  const fixed = options.fixed ?? false;
+  return {
+    ...optionCodecHelper(item, prefix, fixed, options.description),
+    decode: (bytes, offset = 0) => {
+      if (bytes.length - offset <= 0) {
+        return [none(), offset];
+      }
+      const fixedOffset = offset + (prefix.fixedSize ?? 0) + (item.fixedSize ?? 0);
+      const [isSome2, prefixOffset] = prefix.decode(bytes, offset);
+      offset = prefixOffset;
+      if (isSome2 === 0) {
+        return [none(), fixed ? fixedOffset : offset];
+      }
+      const [value, newOffset] = item.decode(bytes, offset);
+      offset = newOffset;
+      return [some(value), fixed ? fixedOffset : offset];
+    }
+  };
+}
+function getOptionCodec(item, options = {}) {
+  return combineCodec(getOptionEncoder(item, options), getOptionDecoder(item, options));
+}
+
+// src/unwrap-option-recursively.ts
+function unwrapOptionRecursively(input, fallback) {
+  if (!input || ArrayBuffer.isView(input)) {
+    return input;
+  }
+  const next = (x) => fallback ? unwrapOptionRecursively(x, fallback) : unwrapOptionRecursively(x);
+  if (isOption(input)) {
+    if (isSome(input))
+      return next(input.value);
+    return fallback ? fallback() : null;
+  }
+  if (Array.isArray(input)) {
+    return input.map(next);
+  }
+  if (typeof input === "object") {
+    return Object.fromEntries(Object.entries(input).map(([k, v]) => [k, next(v)]));
+  }
+  return input;
+}
+
+export { getOptionCodec, getOptionDecoder, getOptionEncoder, isNone, isOption, isSome, none, some, unwrapOption, unwrapOptionRecursively, wrapNullable };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.node.js.map

package/dist/index.node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/option.ts","../src/option-codec.ts","../src/unwrap-option.ts","../src/unwrap-option-recursively.ts"],"names":["isSome"],"mappings":";AAkCO,IAAM,OAAO,CAAI,WAAyB,EAAE,UAAU,QAAQ,MAAM;AAOpE,IAAM,OAAO,OAAqB,EAAE,UAAU,OAAO;AAKrD,IAAM,WAAW,CAAc,UAClC,CAAC,EACG,SACA,OAAO,UAAU,YACjB,cAAc,UACZ,MAAM,aAAa,UAAU,WAAW,SAAU,MAAM,aAAa;AAMxE,IAAM,SAAS,CAAI,WAAyC,OAAO,aAAa;AAKhF,IAAM,SAAS,CAAI,WAAsC,OAAO,aAAa;;;AC9DpF;AAAA,EACI;AAAA,EAIA;AAAA,EAGA;AAAA,EACA;AAAA,OACG;AACP,SAAS,cAAc,oBAA+D;;;ACH/E,SAAS,aAA0B,QAAmB,UAA2B;AACpF,MAAI,OAAO,MAAM;AAAG,WAAO,OAAO;AAClC,SAAO,WAAW,SAAS,IAAK;AACpC;AAKO,IAAM,eAAe,CAAI,aAAmC,aAAa,OAAO,KAAK,QAAQ,IAAI,KAAQ;;;ADmBhH,SAAS,cAAc,OAAyC;AAC5D,SAAO,MAAM,OAAO,CAAC,KAAK,SAAU,QAAQ,QAAQ,SAAS,OAAO,OAAO,MAAM,MAAO,CAAkB;AAC9G;AAEA,SAAS,kBAAkB,MAAiB,QAAmB,OAAgB,aAAiC;AAC5G,MAAI,oBAAoB,KAAK,OAAO,WAAW;AAC/C,MAAI,YAAY,KAAK,cAAc,IAAI,OAAO,YAAY;AAC1D,MAAI,OAAO;AACP,yBAAqB,MAAM,wDAAwD;AACnF,yBAAqB,QAAQ,wDAAwD;AACrF,yBAAqB;AACrB,gBAAY,OAAO,YAAY,KAAK;AAAA,EACxC;AAEA,SAAO;AAAA,IACH,aAAa,eAAe,UAAU,KAAK,cAAc,iBAAiB;AAAA,IAC1E;AAAA,IACA,SAAS,cAAc,CAAC,OAAO,SAAS,KAAK,OAAO,CAAC;AAAA,EACzD;AACJ;AAQO,SAAS,iBACZ,MACA,UAA6C,CAAC,GAClB;AAC5B,QAAM,SAAS,QAAQ,UAAU,aAAa;AAC9C,QAAM,QAAQ,QAAQ,SAAS;AAC/B,SAAO;AAAA,IACH,GAAG,kBAAkB,MAAM,QAAQ,OAAO,QAAQ,WAAW;AAAA,IAC7D,QAAQ,CAAC,qBAA0C;AAC/C,YAAM,SAAS,SAAY,gBAAgB,IAAI,mBAAmB,aAAa,gBAAgB;AAC/F,YAAM,aAAa,OAAO,OAAO,OAAO,OAAO,MAAM,CAAC,CAAC;AACvD,UAAI,YAAY,OAAO,MAAM,IAAI,KAAK,OAAO,OAAO,KAAK,IAAI,IAAI,WAAW;AAC5E,kBAAY,QAAQ,SAAS,WAAW,KAAK,SAAmB,IAAI;AACpE,aAAO,WAAW,CAAC,YAAY,SAAS,CAAC;AAAA,IAC7C;AAAA,EACJ;AACJ;AAQO,SAAS,iBACZ,MACA,UAA6C,CAAC,GAC5B;AAClB,QAAM,SAAS,QAAQ,UAAU,aAAa;AAC9C,QAAM,QAAQ,QAAQ,SAAS;AAC/B,SAAO;AAAA,IACH,GAAG,kBAAkB,MAAM,QAAQ,OAAO,QAAQ,WAAW;AAAA,IAC7D,QAAQ,CAAC,OAAmB,SAAS,MAAM;AACvC,UAAI,MAAM,SAAS,UAAU,GAAG;AAC5B,eAAO,CAAC,KAAK,GAAG,MAAM;AAAA,MAC1B;AACA,YAAM,cAAc,UAAU,OAAO,aAAa,MAAM,KAAK,aAAa;AAC1E,YAAM,CAACA,SAAQ,YAAY,IAAI,OAAO,OAAO,OAAO,MAAM;AAC1D,eAAS;AACT,UAAIA,YAAW,GAAG;AACd,eAAO,CAAC,KAAK,GAAG,QAAQ,cAAc,MAAM;AAAA,MAChD;AACA,YAAM,CAAC,OAAO,SAAS,IAAI,KAAK,OAAO,OAAO,MAAM;AACpD,eAAS;AACT,aAAO,CAAC,KAAK,KAAK,GAAG,QAAQ,cAAc,MAAM;AAAA,IACrD;AAAA,EACJ;AACJ;AAQO,SAAS,eACZ,MACA,UAA2C,CAAC,GACP;AACrC,SAAO,aAAa,iBAAoB,MAAM,OAAO,GAAG,iBAAoB,MAAM,OAAO,CAAC;AAC9F;;;AErEO,SAAS,wBAAqC,OAAU,UAA2C;AAEtG,MAAI,CAAC,SAAS,YAAY,OAAO,KAAK,GAAG;AACrC,WAAO;AAAA,EACX;AAEA,QAAM,OAAO,CAAI,MACZ,WAAW,wBAAwB,GAAG,QAAQ,IAAI,wBAAwB,CAAC;AAGhF,MAAI,SAAS,KAAK,GAAG;AACjB,QAAI,OAAO,KAAK;AAAG,aAAO,KAAK,MAAM,KAAK;AAC1C,WAAQ,WAAW,SAAS,IAAI;AAAA,EACpC;AAGA,MAAI,MAAM,QAAQ,KAAK,GAAG;AACtB,WAAO,MAAM,IAAI,IAAI;AAAA,EACzB;AACA,MAAI,OAAO,UAAU,UAAU;AAC3B,WAAO,OAAO,YAAY,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AAAA,EACjF;AACA,SAAO;AACX","sourcesContent":["/**\n * An implementation of the Rust Option type in JavaScript.\n * It can be one of the following:\n * - <code>{@link Some}<T></code>: Meaning there is a value of type T.\n * - <code>{@link None}</code>: Meaning there is no value.\n */\nexport type Option<T> = Some<T> | None;\n\n/**\n * Defines a looser type that can be used when serializing an {@link Option}.\n * This allows us to pass null or the Option value directly whilst still\n * supporting the Option type for use-cases that need more type safety.\n */\nexport type OptionOrNullable<T> = Option<T> | T | null;\n\n/**\n * Represents an option of type `T` that has a value.\n *\n * @see {@link Option}\n */\nexport type Some<T> = Readonly<{ __option: 'Some'; value: T }>;\n\n/**\n * Represents an option of type `T` that has no value.\n *\n * @see {@link Option}\n */\nexport type None = Readonly<{ __option: 'None' }>;\n\n/**\n * Creates a new {@link Option} of type `T` that has a value.\n *\n * @see {@link Option}\n */\nexport const some = <T>(value: T): Option<T> => ({ __option: 'Some', value });\n\n/**\n * Creates a new {@link Option} of type `T` that has no value.\n *\n * @see {@link Option}\n */\nexport const none = <T>(): Option<T> => ({ __option: 'None' });\n\n/**\n * Whether the given data is an {@link Option}.\n */\nexport const isOption = <T = unknown>(input: unknown): input is Option<T> =>\n    !!(\n        input &&\n        typeof input === 'object' &&\n        '__option' in input &&\n        ((input.__option === 'Some' && 'value' in input) || input.__option === 'None')\n    );\n\n/**\n * Whether the given {@link Option} is a {@link Some}.\n */\nexport const isSome = <T>(option: Option<T>): option is Some<T> => option.__option === 'Some';\n\n/**\n * Whether the given {@link Option} is a {@link None}.\n */\nexport const isNone = <T>(option: Option<T>): option is None => option.__option === 'None';\n","import {\n    assertFixedSizeCodec,\n    BaseCodecOptions,\n    Codec,\n    CodecData,\n    combineCodec,\n    Decoder,\n    Encoder,\n    fixBytes,\n    mergeBytes,\n} from '@solana/codecs-core';\nimport { getU8Decoder, getU8Encoder, NumberCodec, NumberDecoder, NumberEncoder } from '@solana/codecs-numbers';\n\nimport { isOption, isSome, none, Option, OptionOrNullable, some } from './option';\nimport { wrapNullable } from './unwrap-option';\n\n/** Defines the options for option codecs. */\nexport type OptionCodecOptions<TPrefix extends NumberCodec | NumberEncoder | NumberDecoder> = BaseCodecOptions & {\n    /**\n     * The codec to use for the boolean prefix.\n     * @defaultValue u8 prefix.\n     */\n    prefix?: TPrefix;\n\n    /**\n     * Whether the item codec should be of fixed size.\n     *\n     * When this is true, a `None` value will skip the bytes that would\n     * have been used for the item. Note that this will only work if the\n     * item codec is of fixed size.\n     * @defaultValue `false`\n     */\n    fixed?: boolean;\n};\n\nfunction sumCodecSizes(sizes: (number | null)[]): number | null {\n    return sizes.reduce((all, size) => (all === null || size === null ? null : all + size), 0 as number | null);\n}\n\nfunction optionCodecHelper(item: CodecData, prefix: CodecData, fixed: boolean, description?: string): CodecData {\n    let descriptionSuffix = `; ${prefix.description}`;\n    let fixedSize = item.fixedSize === 0 ? prefix.fixedSize : null;\n    if (fixed) {\n        assertFixedSizeCodec(item, 'Fixed options can only be used with fixed-size codecs.');\n        assertFixedSizeCodec(prefix, 'Fixed options can only be used with fixed-size prefix.');\n        descriptionSuffix += '; fixed';\n        fixedSize = prefix.fixedSize + item.fixedSize;\n    }\n\n    return {\n        description: description ?? `option(${item.description + descriptionSuffix})`,\n        fixedSize,\n        maxSize: sumCodecSizes([prefix.maxSize, item.maxSize]),\n    };\n}\n\n/**\n * Creates a encoder for an optional value using `null` as the `None` value.\n *\n * @param item - The encoder to use for the value that may be present.\n * @param options - A set of options for the encoder.\n */\nexport function getOptionEncoder<T>(\n    item: Encoder<T>,\n    options: OptionCodecOptions<NumberEncoder> = {}\n): Encoder<OptionOrNullable<T>> {\n    const prefix = options.prefix ?? getU8Encoder();\n    const fixed = options.fixed ?? false;\n    return {\n        ...optionCodecHelper(item, prefix, fixed, options.description),\n        encode: (optionOrNullable: OptionOrNullable<T>) => {\n            const option = isOption<T>(optionOrNullable) ? optionOrNullable : wrapNullable(optionOrNullable);\n            const prefixByte = prefix.encode(Number(isSome(option)));\n            let itemBytes = isSome(option) ? item.encode(option.value) : new Uint8Array();\n            itemBytes = fixed ? fixBytes(itemBytes, item.fixedSize as number) : itemBytes;\n            return mergeBytes([prefixByte, itemBytes]);\n        },\n    };\n}\n\n/**\n * Creates a decoder for an optional value using `null` as the `None` value.\n *\n * @param item - The decoder to use for the value that may be present.\n * @param options - A set of options for the decoder.\n */\nexport function getOptionDecoder<T>(\n    item: Decoder<T>,\n    options: OptionCodecOptions<NumberDecoder> = {}\n): Decoder<Option<T>> {\n    const prefix = options.prefix ?? getU8Decoder();\n    const fixed = options.fixed ?? false;\n    return {\n        ...optionCodecHelper(item, prefix, fixed, options.description),\n        decode: (bytes: Uint8Array, offset = 0) => {\n            if (bytes.length - offset <= 0) {\n                return [none(), offset];\n            }\n            const fixedOffset = offset + (prefix.fixedSize ?? 0) + (item.fixedSize ?? 0);\n            const [isSome, prefixOffset] = prefix.decode(bytes, offset);\n            offset = prefixOffset;\n            if (isSome === 0) {\n                return [none(), fixed ? fixedOffset : offset];\n            }\n            const [value, newOffset] = item.decode(bytes, offset);\n            offset = newOffset;\n            return [some(value), fixed ? fixedOffset : offset];\n        },\n    };\n}\n\n/**\n * Creates a codec for an optional value using `null` as the `None` value.\n *\n * @param item - The codec to use for the value that may be present.\n * @param options - A set of options for the codec.\n */\nexport function getOptionCodec<T, U extends T = T>(\n    item: Codec<T, U>,\n    options: OptionCodecOptions<NumberCodec> = {}\n): Codec<OptionOrNullable<T>, Option<U>> {\n    return combineCodec(getOptionEncoder<T>(item, options), getOptionDecoder<U>(item, options));\n}\n","import { isSome, none, Option, some } from './option';\n\n/**\n * Unwraps the value of an {@link Option} of type `T`\n * or returns a fallback value that defaults to `null`.\n */\nexport function unwrapOption<T>(option: Option<T>): T | null;\nexport function unwrapOption<T, U>(option: Option<T>, fallback: () => U): T | U;\nexport function unwrapOption<T, U = null>(option: Option<T>, fallback?: () => U): T | U {\n    if (isSome(option)) return option.value;\n    return fallback ? fallback() : (null as U);\n}\n\n/**\n * Wraps a nullable value into an {@link Option}.\n */\nexport const wrapNullable = <T>(nullable: T | null): Option<T> => (nullable !== null ? some(nullable) : none<T>());\n","import { isOption, isSome, None, Some } from './option';\n\n/**\n * Lists all types that should not be recursively unwrapped.\n *\n * @see {@link UnwrappedOption}\n */\ntype UnUnwrappables =\n    | string\n    | number\n    | boolean\n    | symbol\n    | bigint\n    | undefined\n    | null\n    | Uint8Array\n    | Int8Array\n    | Uint16Array\n    | Int16Array\n    | Uint32Array\n    | Int32Array\n    | Date;\n\n/**\n * A type that defines the recursive unwrapping of a type `T`\n * such that all nested {@link Option} types are unwrapped.\n *\n * For each nested {@link Option} type, if the option is a {@link Some},\n * it returns the type of its value, otherwise, it returns the provided\n * fallback type `U` which defaults to `null`.\n */\nexport type UnwrappedOption<T, U = null> = T extends Some<infer TValue>\n    ? UnwrappedOption<TValue, U>\n    : T extends None\n    ? U\n    : T extends UnUnwrappables\n    ? T\n    : T extends object\n    ? { [key in keyof T]: UnwrappedOption<T[key], U> }\n    : T extends Array<infer TItem>\n    ? Array<UnwrappedOption<TItem, U>>\n    : T;\n\n/**\n * Recursively go through a type `T` such that all\n * nested {@link Option} types are unwrapped.\n *\n * For each nested {@link Option} type, if the option is a {@link Some},\n * it returns its value, otherwise, it returns the provided fallback value\n * which defaults to `null`.\n */\nexport function unwrapOptionRecursively<T>(input: T): UnwrappedOption<T>;\nexport function unwrapOptionRecursively<T, U>(input: T, fallback: () => U): UnwrappedOption<T, U>;\nexport function unwrapOptionRecursively<T, U = null>(input: T, fallback?: () => U): UnwrappedOption<T, U> {\n    // Types to bypass.\n    if (!input || ArrayBuffer.isView(input)) {\n        return input as UnwrappedOption<T, U>;\n    }\n\n    const next = <X>(x: X) =>\n        (fallback ? unwrapOptionRecursively(x, fallback) : unwrapOptionRecursively(x)) as UnwrappedOption<X, U>;\n\n    // Handle Option.\n    if (isOption(input)) {\n        if (isSome(input)) return next(input.value) as UnwrappedOption<T, U>;\n        return (fallback ? fallback() : null) as UnwrappedOption<T, U>;\n    }\n\n    // Walk.\n    if (Array.isArray(input)) {\n        return input.map(next) as UnwrappedOption<T, U>;\n    }\n    if (typeof input === 'object') {\n        return Object.fromEntries(Object.entries(input).map(([k, v]) => [k, next(v)])) as UnwrappedOption<T, U>;\n    }\n    return input as UnwrappedOption<T, U>;\n}\n"]}

package/dist/index.production.min.js

@@ -0,0 +1,21 @@
+this.globalThis = this.globalThis || {};
+this.globalThis.solanaWeb3 = (function (exports) {
+	'use strict';
+
+	var p=e=>({__option:"Some",value:e}),s=()=>({__option:"None"}),u=e=>!!(e&&typeof e=="object"&&"__option"in e&&(e.__option==="Some"&&"value"in e||e.__option==="None")),f=e=>e.__option==="Some",L=e=>e.__option==="None";function m(e,n,t=0){if(n.length-t<=0)throw new Error(`Codec [${e}] cannot decode empty byte arrays.`)}function l(e,n,t,r=0){let o=t.length-r;if(o<n)throw new Error(`Codec [${e}] expected ${n} bytes, got ${o}.`)}function g(e,n){if(e.fixedSize===null)throw new Error(n??"Expected a fixed-size codec, got a variable-size one.")}var z=e=>{let n=e.filter(i=>i.length);if(n.length===0)return e.length?e[0]:new Uint8Array;if(n.length===1)return n[0];let t=n.reduce((i,a)=>i+a.length,0),r=new Uint8Array(t),o=0;return n.forEach(i=>{r.set(i,o),o+=i.length;}),r},E=(e,n)=>{if(e.length>=n)return e;let t=new Uint8Array(n).fill(0);return t.set(e),t},U=(e,n)=>E(e.length<=n?e:e.slice(0,n),n);function x(e,n,t){if(e.fixedSize!==n.fixedSize)throw new Error(`Encoder and decoder must have the same fixed size, got [${e.fixedSize}] and [${n.fixedSize}].`);if(e.maxSize!==n.maxSize)throw new Error(`Encoder and decoder must have the same max size, got [${e.maxSize}] and [${n.maxSize}].`);if(t===void 0&&e.description!==n.description)throw new Error(`Encoder and decoder must have the same description, got [${e.description}] and [${n.description}]. Pass a custom description as a third argument if you want to override the description and bypass this error.`);return {decode:n.decode,description:t??e.description,encode:e.encode,fixedSize:e.fixedSize,maxSize:e.maxSize}}function B(e,n,t,r){if(r<n||r>t)throw new Error(`Codec [${e}] expected number to be in the range [${n}, ${t}], got ${r}.`)}function T(e){let n,t=e.name;return e.size>1&&(n=!("endian"in e.options)||e.options.endian===0,t+=n?"(le)":"(be)"),{description:e.options.description??t,fixedSize:e.size,littleEndian:n,maxSize:e.size}}function b(e){let n=T(e);return {description:n.description,encode(t){e.range&&B(e.name,e.range[0],e.range[1],t);let r=new ArrayBuffer(e.size);return e.set(new DataView(r),t,n.littleEndian),new Uint8Array(r)},fixedSize:n.fixedSize,maxSize:n.maxSize}}function N(e){let n=T(e);return {decode(t,r=0){m(n.description,t,r),l(n.description,e.size,t,r);let o=new DataView(D(t,r,e.size));return [e.get(o,n.littleEndian),r+e.size]},description:n.description,fixedSize:n.fixedSize,maxSize:n.maxSize}}function D(e,n,t){let r=e.byteOffset+(n??0),o=t??e.byteLength;return e.buffer.slice(r,r+o)}var S=(e={})=>b({name:"u8",options:e,range:[0,+"0xff"],set:(n,t)=>n.setUint8(0,t),size:1}),O=(e={})=>N({get:n=>n.getUint8(0),name:"u8",options:e,size:1});function q(e,n){return f(e)?e.value:n?n():null}var v=e=>e!==null?p(e):s();function A(e){return e.reduce((n,t)=>n===null||t===null?null:n+t,0)}function w(e,n,t,r){let o=`; ${n.description}`,i=e.fixedSize===0?n.fixedSize:null;return t&&(g(e,"Fixed options can only be used with fixed-size codecs."),g(n,"Fixed options can only be used with fixed-size prefix."),o+="; fixed",i=n.fixedSize+e.fixedSize),{description:r??`option(${e.description+o})`,fixedSize:i,maxSize:A([n.maxSize,e.maxSize])}}function _(e,n={}){let t=n.prefix??S(),r=n.fixed??!1;return {...w(e,t,r,n.description),encode:o=>{let i=u(o)?o:v(o),a=t.encode(Number(f(i))),c=f(i)?e.encode(i.value):new Uint8Array;return c=r?U(c,e.fixedSize):c,z([a,c])}}}function F(e,n={}){let t=n.prefix??O(),r=n.fixed??!1;return {...w(e,t,r,n.description),decode:(o,i=0)=>{if(o.length-i<=0)return [s(),i];let a=i+(t.fixedSize??0)+(e.fixedSize??0),[c,C]=t.decode(o,i);if(i=C,c===0)return [s(),r?a:i];let[y,I]=e.decode(o,i);return i=I,[p(y),r?a:i]}}}function se(e,n={}){return x(_(e,n),F(e,n))}function h(e,n){if(!e||ArrayBuffer.isView(e))return e;let t=r=>n?h(r,n):h(r);return u(e)?f(e)?t(e.value):n?n():null:Array.isArray(e)?e.map(t):typeof e=="object"?Object.fromEntries(Object.entries(e).map(([r,o])=>[r,t(o)])):e}
+
+	exports.getOptionCodec = se;
+	exports.getOptionDecoder = F;
+	exports.getOptionEncoder = _;
+	exports.isNone = L;
+	exports.isOption = u;
+	exports.isSome = f;
+	exports.none = s;
+	exports.some = p;
+	exports.unwrapOption = q;
+	exports.unwrapOptionRecursively = h;
+	exports.wrapNullable = v;
+
+	return exports;
+
+})({});

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export * from './option';
+export * from './option-codec';
+export * from './unwrap-option';
+export * from './unwrap-option-recursively';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/option-codec.d.ts

@@ -0,0 +1,42 @@
+import { BaseCodecOptions, Codec, Decoder, Encoder } from '@solana/codecs-core';
+import { NumberCodec, NumberDecoder, NumberEncoder } from '@solana/codecs-numbers';
+import { Option, OptionOrNullable } from './option';
+/** Defines the options for option codecs. */
+export type OptionCodecOptions<TPrefix extends NumberCodec | NumberEncoder | NumberDecoder> = BaseCodecOptions & {
+    /**
+     * The codec to use for the boolean prefix.
+     * @defaultValue u8 prefix.
+     */
+    prefix?: TPrefix;
+    /**
+     * Whether the item codec should be of fixed size.
+     *
+     * When this is true, a `None` value will skip the bytes that would
+     * have been used for the item. Note that this will only work if the
+     * item codec is of fixed size.
+     * @defaultValue `false`
+     */
+    fixed?: boolean;
+};
+/**
+ * Creates a encoder for an optional value using `null` as the `None` value.
+ *
+ * @param item - The encoder to use for the value that may be present.
+ * @param options - A set of options for the encoder.
+ */
+export declare function getOptionEncoder<T>(item: Encoder<T>, options?: OptionCodecOptions<NumberEncoder>): Encoder<OptionOrNullable<T>>;
+/**
+ * Creates a decoder for an optional value using `null` as the `None` value.
+ *
+ * @param item - The decoder to use for the value that may be present.
+ * @param options - A set of options for the decoder.
+ */
+export declare function getOptionDecoder<T>(item: Decoder<T>, options?: OptionCodecOptions<NumberDecoder>): Decoder<Option<T>>;
+/**
+ * Creates a codec for an optional value using `null` as the `None` value.
+ *
+ * @param item - The codec to use for the value that may be present.
+ * @param options - A set of options for the codec.
+ */
+export declare function getOptionCodec<T, U extends T = T>(item: Codec<T, U>, options?: OptionCodecOptions<NumberCodec>): Codec<OptionOrNullable<T>, Option<U>>;
+//# sourceMappingURL=option-codec.d.ts.map

package/dist/types/option.d.ts

@@ -0,0 +1,60 @@
+/**
+ * An implementation of the Rust Option type in JavaScript.
+ * It can be one of the following:
+ * - <code>{@link Some}<T></code>: Meaning there is a value of type T.
+ * - <code>{@link None}</code>: Meaning there is no value.
+ */
+export type Option<T> = Some<T> | None;
+/**
+ * Defines a looser type that can be used when serializing an {@link Option}.
+ * This allows us to pass null or the Option value directly whilst still
+ * supporting the Option type for use-cases that need more type safety.
+ */
+export type OptionOrNullable<T> = Option<T> | T | null;
+/**
+ * Represents an option of type `T` that has a value.
+ *
+ * @see {@link Option}
+ */
+export type Some<T> = Readonly<{
+    __option: 'Some';
+    value: T;
+}>;
+/**
+ * Represents an option of type `T` that has no value.
+ *
+ * @see {@link Option}
+ */
+export type None = Readonly<{
+    __option: 'None';
+}>;
+/**
+ * Creates a new {@link Option} of type `T` that has a value.
+ *
+ * @see {@link Option}
+ */
+export declare const some: <T>(value: T) => Option<T>;
+/**
+ * Creates a new {@link Option} of type `T` that has no value.
+ *
+ * @see {@link Option}
+ */
+export declare const none: <T>() => Option<T>;
+/**
+ * Whether the given data is an {@link Option}.
+ */
+export declare const isOption: <T = unknown>(input: unknown) => input is Option<T>;
+/**
+ * Whether the given {@link Option} is a {@link Some}.
+ */
+export declare const isSome: <T>(option: Option<T>) => option is Readonly<{
+    __option: 'Some';
+    value: T;
+}>;
+/**
+ * Whether the given {@link Option} is a {@link None}.
+ */
+export declare const isNone: <T>(option: Option<T>) => option is Readonly<{
+    __option: 'None';
+}>;
+//# sourceMappingURL=option.d.ts.map

package/dist/types/unwrap-option-recursively.d.ts

@@ -0,0 +1,30 @@
+import { None, Some } from './option';
+/**
+ * Lists all types that should not be recursively unwrapped.
+ *
+ * @see {@link UnwrappedOption}
+ */
+type UnUnwrappables = string | number | boolean | symbol | bigint | undefined | null | Uint8Array | Int8Array | Uint16Array | Int16Array | Uint32Array | Int32Array | Date;
+/**
+ * A type that defines the recursive unwrapping of a type `T`
+ * such that all nested {@link Option} types are unwrapped.
+ *
+ * For each nested {@link Option} type, if the option is a {@link Some},
+ * it returns the type of its value, otherwise, it returns the provided
+ * fallback type `U` which defaults to `null`.
+ */
+export type UnwrappedOption<T, U = null> = T extends Some<infer TValue> ? UnwrappedOption<TValue, U> : T extends None ? U : T extends UnUnwrappables ? T : T extends object ? {
+    [key in keyof T]: UnwrappedOption<T[key], U>;
+} : T extends Array<infer TItem> ? Array<UnwrappedOption<TItem, U>> : T;
+/**
+ * Recursively go through a type `T` such that all
+ * nested {@link Option} types are unwrapped.
+ *
+ * For each nested {@link Option} type, if the option is a {@link Some},
+ * it returns its value, otherwise, it returns the provided fallback value
+ * which defaults to `null`.
+ */
+export declare function unwrapOptionRecursively<T>(input: T): UnwrappedOption<T>;
+export declare function unwrapOptionRecursively<T, U>(input: T, fallback: () => U): UnwrappedOption<T, U>;
+export {};
+//# sourceMappingURL=unwrap-option-recursively.d.ts.map

package/dist/types/unwrap-option.d.ts

@@ -0,0 +1,12 @@
+import { Option } from './option';
+/**
+ * Unwraps the value of an {@link Option} of type `T`
+ * or returns a fallback value that defaults to `null`.
+ */
+export declare function unwrapOption<T>(option: Option<T>): T | null;
+export declare function unwrapOption<T, U>(option: Option<T>, fallback: () => U): T | U;
+/**
+ * Wraps a nullable value into an {@link Option}.
+ */
+export declare const wrapNullable: <T>(nullable: T | null) => Option<T>;
+//# sourceMappingURL=unwrap-option.d.ts.map